aperture-10

Merge remote-tracking branch 'origin/main' into aperture

Signed-off-by: Christian Stewart <christian@aperture.us>

aperture-9

Merge remote-tracking branch 'origin/main' into aperture

aperture-8

.github: update node and deno versions

Signed-off-by: Christian Stewart <christian@aperture.us>

v0.19.12

• The "preserve" JSX mode now preserves JSX text verbatim (#3605)

  The JSX specification deliberately doesn't specify how JSX text is supposed to be interpreted and there is no canonical way to interpret JSX text. Two most popular interpretations are Babel and TypeScript. Yes they are different (esbuild deliberately follows TypeScript by the way).

  Previously esbuild normalized text to the TypeScript interpretation when the "preserve" JSX mode is active. However, "preserve" should arguably reproduce the original JSX text verbatim so that whatever JSX transform runs after esbuild is free to interpret it however it wants. So with this release, esbuild will now pass JSX text through unmodified:

  // Original code
  let el =
    <a href={'/'} title='&apos;&quot;'> some text
      {foo}
        more text </a>
  
  // Old output (with --loader=jsx --jsx=preserve)
  let el = <a href="/" title={`'"`}>
    {" some text"}
    {foo}
    {"more text "}
  </a>;
  
  // New output (with --loader=jsx --jsx=preserve)
  let el = <a href={"/"} title='&apos;&quot;'> some text
      {foo}
        more text </a>;

• Allow JSX elements as JSX attribute values

  JSX has an obscure feature where you can use JSX elements in attribute position without surrounding them with {...}. It looks like this:

  let el = <div data-ab=<><a/><b/></>/>;

  I think I originally didn't implement it even though it's part of the JSX specification because it previously didn't work in TypeScript (and potentially also in Babel?). However, support for it was silently added in TypeScript 4.8 without me noticing and Babel has also since fixed their bugs regarding this feature. So I'm adding it to esbuild too now that I know it's widely supported.

  Keep in mind that there is some ongoing discussion about removing this feature from JSX. I agree that the syntax seems out of place (it does away with the elegance of "JSX is basically just XML with {...} escapes" for something arguably harder to read, which doesn't seem like a good trade-off), but it's in the specification and TypeScript and Babel both implement it so I'm going to have esbuild implement it too. However, I reserve the right to remove it from esbuild if it's ever removed from the specification in the future. So use it with caution.

• Fix a bug with TypeScript type parsing (#3574)

  This release fixes a bug with esbuild's TypeScript parser where a conditional type containing a union type that ends with an infer type that ends with a constraint could fail to parse. This was caused by the "don't parse a conditional type" flag not getting passed through the union type parser. Here's an example of valid TypeScript code that previously failed to parse correctly:

  type InferUnion<T> = T extends { a: infer U extends number } | infer U extends number ? U : never

aperture-7

• Allow resolving package.json within packages

  Enables the following type of import:

  const pkg = require('@mantine/core/package.json');

  This is used to access the contents of package.json which is usually not
  exported by any of the exports within the package.json.

• Defer log constructor now accepts log level

  The NewDeferLog constructor defaults to LogLevelInfo regardless of the log level
  specified in the bundler options. We should instead inherit the log level from
  the parent logger so that we don't drop debug messages.

  Add a new logLevel parameter to NewDeferLog. Updated all locations where
  NewDeferLog is called to either pass the parent logger level or to pass the old
  default value of LogLevelInfo if there is no parent logger.

• Fork to aperturerobotics/esbuild

  Main changes:

  • Support go1.20 and Node.JS 21 primarily
  • Allow resolving package.json within any package
  • Add renovate ci
  • Other tweaks & fixes

v0.19.11

• Fix TypeScript-specific class transform edge case (#3559)

  The previous release introduced an optimization that avoided transforming super() in the class constructor for TypeScript code compiled with useDefineForClassFields set to false if all class instance fields have no initializers. The rationale was that in this case, all class instance fields are omitted in the output so no changes to the constructor are needed. However, if all of this is the case and there are #private instance fields with initializers, those private instance field initializers were still being moved into the constructor. This was problematic because they were being inserted before the call to super() (since super() is now no longer transformed in that case). This release introduces an additional optimization that avoids moving the private instance field initializers into the constructor in this edge case, which generates smaller code, matches the TypeScript compiler's output more closely, and avoids this bug:

  // Original code
  class Foo extends Bar {
    #private = 1;
    public: any;
    constructor() {
      super();
    }
  }
  
  // Old output (with esbuild v0.19.9)
  class Foo extends Bar {
    constructor() {
      super();
      this.#private = 1;
    }
    #private;
  }
  
  // Old output (with esbuild v0.19.10)
  class Foo extends Bar {
    constructor() {
      this.#private = 1;
      super();
    }
    #private;
  }
  
  // New output
  class Foo extends Bar {
    #private = 1;
    constructor() {
      super();
    }
  }

• Minifier: allow reording a primitive past a side-effect (#3568)

  The minifier previously allowed reordering a side-effect past a primitive, but didn't handle the case of reordering a primitive past a side-effect. This additional case is now handled:

  // Original code
  function f() {
    let x = false;
    let y = x;
    const boolean = y;
    let frag = $.template(`<p contenteditable="${boolean}">hello world</p>`);
    return frag;
  }
  
  // Old output (with --minify)
  function f(){const e=!1;return $.template(`<p contenteditable="${e}">hello world</p>`)}
  
  // New output (with --minify)
  function f(){return $.template('<p contenteditable="false">hello world</p>')}

• Minifier: consider properties named using known Symbol instances to be side-effect free (#3561)

  Many things in JavaScript can have side effects including property accesses and ToString operations, so using a symbol such as Symbol.iterator as a computed property name is not obviously side-effect free. This release adds a special case for known Symbol instances so that they are considered side-effect free when used as property names. For example, this class declaration will now be considered side-effect free:

  class Foo {
    *[Symbol.iterator]() {
    }
  }

• Provide the stop() API in node to exit esbuild's child process (#3558)

  You can now call stop() in esbuild's node API to exit esbuild's child process to reclaim the resources used. It only makes sense to do this for a long-lived node process when you know you will no longer be making any more esbuild API calls. It is not necessary to call this to allow node to exit, and it's advantageous to not call this in between calls to esbuild's API as sharing a single long-lived esbuild child process is more efficient than re-creating a new esbuild child process for every API call. This API call used to exist but was removed in version 0.9.0. This release adds it back due to a user request.