@ttsc/factory 0.22.0 → 0.23.0

package/README.md

@@ -123,6 +123,8 @@ new TsPrinter().print(node);
 
 Companion helpers: `addSyntheticTrailingComment`, `get`/`setSyntheticLeadingComments`, `get`/`setSyntheticTrailingComments`.
 
+Synthetic comments are side-band data: they do not add properties to the node, so comments can be attached to frozen nodes. Compatible copies loaded in the same JavaScript realm share the versioned weak stores, including a CommonJS `require()` and an ES module `import()` of one installation or multiple installed copies. If a hardened realm prevents adding the registry to its global object before the first copy loads, each module falls back to private weak stores: comments and frozen nodes still work within that copy, but copies cannot exchange comments. A copy from an older release that predates this registry likewise cannot see comments written by a newer copy (or expose its private comments to one); upgrade every copy that exchanges nodes.
+
 ## Coverage
 
 The factory and printer cover the constructs most used for code generation: identifiers, literals, the common expressions, types (keyword / reference / union / intersection / array / tuple / type-literal / function / operator / ...), statements, classes & interfaces, enums, functions & arrow functions, and import / export declarations. Coverage is easy to extend — add the node under `src/ast/`, a builder under `src/factory/`, and a `case` to the printer.

package/lib/comments.d.ts

@@ -4,10 +4,11 @@
  *
  * The legacy TypeScript compiler stores synthesized comments on a side-band
  * `node.emitNode` slot rather than on the node itself; this module reproduces
- * that behaviour with a {@link WeakMap} so the {@link import("./ast").Node}
- * interfaces stay free of printer-only metadata. {@link TsPrinter} consults
- * these stores while emitting and renders the comments verbatim — a leading
- * comment is printed before the node, a trailing comment after it.
+ * that behaviour with realm-shared {@link WeakMap}s so the
+ * {@link import("./ast").Node} interfaces stay free of printer-only metadata and
+ * frozen nodes remain valid targets. {@link TsPrinter} consults these stores
+ * while emitting and renders the comments verbatim — a leading comment is
+ * printed before the node, a trailing comment after it.
  *
  * ```typescript
  * import factory, {

package/lib/comments.js

@@ -1,8 +1,46 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.setSyntheticTrailingComments = exports.setSyntheticLeadingComments = exports.getSyntheticTrailingComments = exports.getSyntheticLeadingComments = exports.addSyntheticTrailingComment = exports.addSyntheticLeadingComment = void 0;
-const leadingStore = new WeakMap();
-const trailingStore = new WeakMap();
+/**
+ * One versioned registry per JavaScript realm.
+ *
+ * A package can be loaded through both its CommonJS and ESM entry points, and
+ * package managers may install multiple physical copies. Module-local WeakMaps
+ * make those copies silently lose each other's comments even though factory
+ * nodes are otherwise structural. A well-known, versioned key gives every
+ * compatible copy the same side-band stores without writing metadata to the
+ * node, so `Object.freeze(node)` keeps working as it did before.
+ *
+ * The version belongs to the stored value shape. A future incompatible shape
+ * must use another key rather than reinterpret an older registry.
+ */
+const SYNTHETIC_COMMENT_STORES = Symbol.for("@ttsc/factory.syntheticComments.v1");
+const createCommentStores = () => ({
+    leading: new WeakMap(),
+    trailing: new WeakMap(),
+});
+const localCommentStores = createCommentStores();
+const commentStores = () => {
+    const existing = Reflect.get(globalThis, SYNTHETIC_COMMENT_STORES);
+    if (existing !== undefined)
+        return existing;
+    try {
+        Object.defineProperty(globalThis, SYNTHETIC_COMMENT_STORES, {
+            configurable: false,
+            enumerable: false,
+            value: localCommentStores,
+            writable: false,
+        });
+        return localCommentStores;
+    }
+    catch {
+        // Hardened realms can prohibit new global properties. Preserve the
+        // historical single-module behaviour there instead of making package load
+        // fail; cross-copy sharing necessarily requires a realm-owned rendezvous.
+        return localCommentStores;
+    }
+};
+const { leading: leadingStore, trailing: trailingStore } = commentStores();
 const append = (store, node, comment) => {
     const list = store.get(node);
     if (list !== undefined)

package/lib/comments.js.map

@@ -1 +1 @@
-{"version":3,"file":"comments.js","sourceRoot":"","sources":["../src/comments.ts"],"names":[],"mappings":";;;AA2DA,MAAM,YAAY,GAAG,IAAI,OAAO,EAAgC,CAAC;AACjE,MAAM,aAAa,GAAG,IAAI,OAAO,EAAgC,CAAC;AAElE,MAAM,MAAM,GAAG,CACb,KAA4C,EAC5C,IAAY,EACZ,OAA2B,EACrB,EAAE;IACR,MAAM,IAAI,GAAqC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC/D,IAAI,IAAI,KAAK,SAAS;QAAE,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;;QACtC,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;AAClC,CAAC,CAAC;AAEF;;;;;;;;;;;;GAYG;AACI,MAAM,0BAA0B,GAAG,CACxC,IAAO,EACP,IAAgC,EAChC,IAAY,EACZ,kBAA4B,EACzB,EAAE;IACL,MAAM,CAAC,YAAY,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,kBAAkB,EAAE,CAAC,CAAC;IAC/D,OAAO,IAAI,CAAC;AACd,CAAC,CAAC;AARW,QAAA,0BAA0B,GAA1B,0BAA0B,CAQrC;AAEF;;;;;;;;;;;;GAYG;AACI,MAAM,2BAA2B,GAAG,CACzC,IAAO,EACP,IAAgC,EAChC,IAAY,EACZ,kBAA4B,EACzB,EAAE;IACL,MAAM,CAAC,aAAa,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,kBAAkB,EAAE,CAAC,CAAC;IAChE,OAAO,IAAI,CAAC;AACd,CAAC,CAAC;AARW,QAAA,2BAA2B,GAA3B,2BAA2B,CAQtC;AAEF,wEAAwE;AACjE,MAAM,2BAA2B,GAAG,CACzC,IAAU,EACwB,EAAE,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAFjD,QAAA,2BAA2B,GAA3B,2BAA2B,CAEsB;AAE9D,yEAAyE;AAClE,MAAM,4BAA4B,GAAG,CAC1C,IAAU,EACwB,EAAE,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAFlD,QAAA,4BAA4B,GAA5B,4BAA4B,CAEsB;AAE/D;;;;;GAKG;AACI,MAAM,2BAA2B,GAAG,CACzC,IAAO,EACP,QAAmD,EAChD,EAAE;IACL,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QACjD,YAAY,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC;;QACtC,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC/B,OAAO,IAAI,CAAC;AACd,CAAC,CAAC;AARW,QAAA,2BAA2B,GAA3B,2BAA2B,CAQtC;AAEF;;;;;GAKG;AACI,MAAM,4BAA4B,GAAG,CAC1C,IAAO,EACP,QAAmD,EAChD,EAAE;IACL,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QACjD,aAAa,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC;;QACvC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAChC,OAAO,IAAI,CAAC;AACd,CAAC,CAAC;AARW,QAAA,4BAA4B,GAA5B,4BAA4B,CAQvC"}
+{"version":3,"file":"comments.js","sourceRoot":"","sources":["../src/comments.ts"],"names":[],"mappings":"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"}

package/lib/comments.mjs

@@ -1,5 +1,43 @@
-const leadingStore = new WeakMap();
-const trailingStore = new WeakMap();
+/**
+ * One versioned registry per JavaScript realm.
+ *
+ * A package can be loaded through both its CommonJS and ESM entry points, and
+ * package managers may install multiple physical copies. Module-local WeakMaps
+ * make those copies silently lose each other's comments even though factory
+ * nodes are otherwise structural. A well-known, versioned key gives every
+ * compatible copy the same side-band stores without writing metadata to the
+ * node, so `Object.freeze(node)` keeps working as it did before.
+ *
+ * The version belongs to the stored value shape. A future incompatible shape
+ * must use another key rather than reinterpret an older registry.
+ */
+const SYNTHETIC_COMMENT_STORES = Symbol.for("@ttsc/factory.syntheticComments.v1");
+const createCommentStores = () => ({
+    leading: new WeakMap(),
+    trailing: new WeakMap(),
+});
+const localCommentStores = createCommentStores();
+const commentStores = () => {
+    const existing = Reflect.get(globalThis, SYNTHETIC_COMMENT_STORES);
+    if (existing !== undefined)
+        return existing;
+    try {
+        Object.defineProperty(globalThis, SYNTHETIC_COMMENT_STORES, {
+            configurable: false,
+            enumerable: false,
+            value: localCommentStores,
+            writable: false,
+        });
+        return localCommentStores;
+    }
+    catch {
+        // Hardened realms can prohibit new global properties. Preserve the
+        // historical single-module behaviour there instead of making package load
+        // fail; cross-copy sharing necessarily requires a realm-owned rendezvous.
+        return localCommentStores;
+    }
+};
+const { leading: leadingStore, trailing: trailingStore } = commentStores();
 const append = (store, node, comment) => {
     const list = store.get(node);
     if (list !== undefined)

package/lib/comments.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"comments.mjs","sources":["../src/comments.ts"],"sourcesContent":[null],"names":[],"mappings":"AA2DA,MAAM,YAAY,GAAG,IAAI,OAAO,EAAgC;AAChE,MAAM,aAAa,GAAG,IAAI,OAAO,EAAgC;AAEjE,MAAM,MAAM,GAAG,CACb,KAA4C,EAC5C,IAAY,EACZ,OAA2B,KACnB;IACR,MAAM,IAAI,GAAqC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC;IAC9D,IAAI,IAAI,KAAK,SAAS;AAAE,QAAA,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC;;QACrC,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,CAAC;AACjC,CAAC;AAED;;;;;;;;;;;;AAYG;AACI,MAAM,0BAA0B,GAAG,CACxC,IAAO,EACP,IAAgC,EAChC,IAAY,EACZ,kBAA4B,KACvB;AACL,IAAA,MAAM,CAAC,YAAY,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,kBAAkB,EAAE,CAAC;AAC9D,IAAA,OAAO,IAAI;AACb;AAEA;;;;;;;;;;;;AAYG;AACI,MAAM,2BAA2B,GAAG,CACzC,IAAO,EACP,IAAgC,EAChC,IAAY,EACZ,kBAA4B,KACvB;AACL,IAAA,MAAM,CAAC,aAAa,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,kBAAkB,EAAE,CAAC;AAC/D,IAAA,OAAO,IAAI;AACb;AAEA;AACO,MAAM,2BAA2B,GAAG,CACzC,IAAU,KAC2B,YAAY,CAAC,GAAG,CAAC,IAAI;AAE5D;AACO,MAAM,4BAA4B,GAAG,CAC1C,IAAU,KAC2B,aAAa,CAAC,GAAG,CAAC,IAAI;AAE7D;;;;;AAKG;MACU,2BAA2B,GAAG,CACzC,IAAO,EACP,QAAmD,KAC9C;IACL,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QACjD,YAAY,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,KAAK,EAAE,CAAC;;AACrC,QAAA,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC;AAC9B,IAAA,OAAO,IAAI;AACb;AAEA;;;;;AAKG;MACU,4BAA4B,GAAG,CAC1C,IAAO,EACP,QAAmD,KAC9C;IACL,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QACjD,aAAa,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,KAAK,EAAE,CAAC;;AACtC,QAAA,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC;AAC/B,IAAA,OAAO,IAAI;AACb;;;;"}
+{"version":3,"file":"comments.mjs","sources":["../src/comments.ts"],"sourcesContent":[null],"names":[],"mappings":"AAiEA;;;;;;;;;;;;AAYG;AACH,MAAM,wBAAwB,GAAG,MAAM,CAAC,GAAG,CACzC,oCAAoC,CACrC;AAED,MAAM,mBAAmB,GAAG,OAA+B;IACzD,OAAO,EAAE,IAAI,OAAO,EAAgC;IACpD,QAAQ,EAAE,IAAI,OAAO,EAAgC;AACtD,CAAA,CAAC;AAEF,MAAM,kBAAkB,GAAG,mBAAmB,EAAE;AAEhD,MAAM,aAAa,GAAG,MAA6B;IACjD,MAAM,QAAQ,GAAY,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE,wBAAwB,CAAC;IAC3E,IAAI,QAAQ,KAAK,SAAS;AAAE,QAAA,OAAO,QAAkC;AACrE,IAAA,IAAI;AACF,QAAA,MAAM,CAAC,cAAc,CAAC,UAAU,EAAE,wBAAwB,EAAE;AAC1D,YAAA,YAAY,EAAE,KAAK;AACnB,YAAA,UAAU,EAAE,KAAK;AACjB,YAAA,KAAK,EAAE,kBAAkB;AACzB,YAAA,QAAQ,EAAE,KAAK;AAChB,SAAA,CAAC;AACF,QAAA,OAAO,kBAAkB;IAC3B;AAAE,IAAA,MAAM;;;;AAIN,QAAA,OAAO,kBAAkB;IAC3B;AACF,CAAC;AAED,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,aAAa,EAAE,GAAG,aAAa,EAAE;AAE1E,MAAM,MAAM,GAAG,CACb,KAA4C,EAC5C,IAAY,EACZ,OAA2B,KACnB;IACR,MAAM,IAAI,GAAqC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC;IAC9D,IAAI,IAAI,KAAK,SAAS;AAAE,QAAA,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC;;QACrC,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,CAAC;AACjC,CAAC;AAED;;;;;;;;;;;;AAYG;AACI,MAAM,0BAA0B,GAAG,CACxC,IAAO,EACP,IAAgC,EAChC,IAAY,EACZ,kBAA4B,KACvB;AACL,IAAA,MAAM,CAAC,YAAY,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,kBAAkB,EAAE,CAAC;AAC9D,IAAA,OAAO,IAAI;AACb;AAEA;;;;;;;;;;;;AAYG;AACI,MAAM,2BAA2B,GAAG,CACzC,IAAO,EACP,IAAgC,EAChC,IAAY,EACZ,kBAA4B,KACvB;AACL,IAAA,MAAM,CAAC,aAAa,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,kBAAkB,EAAE,CAAC;AAC/D,IAAA,OAAO,IAAI;AACb;AAEA;AACO,MAAM,2BAA2B,GAAG,CACzC,IAAU,KAC2B,YAAY,CAAC,GAAG,CAAC,IAAI;AAE5D;AACO,MAAM,4BAA4B,GAAG,CAC1C,IAAU,KAC2B,aAAa,CAAC,GAAG,CAAC,IAAI;AAE7D;;;;;AAKG;MACU,2BAA2B,GAAG,CACzC,IAAO,EACP,QAAmD,KAC9C;IACL,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QACjD,YAAY,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,KAAK,EAAE,CAAC;;AACrC,QAAA,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC;AAC9B,IAAA,OAAO,IAAI;AACb;AAEA;;;;;AAKG;MACU,4BAA4B,GAAG,CAC1C,IAAO,EACP,QAAmD,KAC9C;IACL,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QACjD,aAAa,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,KAAK,EAAE,CAAC;;AACtC,QAAA,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC;AAC/B,IAAA,OAAO,IAAI;AACb;;;;"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ttsc/factory",
-  "version": "0.22.0",
+  "version": "0.23.0",
   "description": "Self-contained legacy-style TypeScript AST factory and printer for source code generation, surviving the TypeScript-Go (tsgo) migration. Zero dependencies, no `typescript` import.",
   "main": "lib/index.js",
   "exports": {

package/src/comments.ts

@@ -4,10 +4,11 @@
  *
  * The legacy TypeScript compiler stores synthesized comments on a side-band
  * `node.emitNode` slot rather than on the node itself; this module reproduces
- * that behaviour with a {@link WeakMap} so the {@link import("./ast").Node}
- * interfaces stay free of printer-only metadata. {@link TsPrinter} consults
- * these stores while emitting and renders the comments verbatim — a leading
- * comment is printed before the node, a trailing comment after it.
+ * that behaviour with realm-shared {@link WeakMap}s so the
+ * {@link import("./ast").Node} interfaces stay free of printer-only metadata and
+ * frozen nodes remain valid targets. {@link TsPrinter} consults these stores
+ * while emitting and renders the comments verbatim — a leading comment is
+ * printed before the node, a trailing comment after it.
  *
  * ```typescript
  * import factory, {
@@ -57,8 +58,55 @@ export interface SynthesizedComment {
   hasLeadingNewLine?: boolean;
 }
 
-const leadingStore = new WeakMap<object, SynthesizedComment[]>();
-const trailingStore = new WeakMap<object, SynthesizedComment[]>();
+interface SyntheticCommentStores {
+  leading: WeakMap<object, SynthesizedComment[]>;
+  trailing: WeakMap<object, SynthesizedComment[]>;
+}
+
+/**
+ * One versioned registry per JavaScript realm.
+ *
+ * A package can be loaded through both its CommonJS and ESM entry points, and
+ * package managers may install multiple physical copies. Module-local WeakMaps
+ * make those copies silently lose each other's comments even though factory
+ * nodes are otherwise structural. A well-known, versioned key gives every
+ * compatible copy the same side-band stores without writing metadata to the
+ * node, so `Object.freeze(node)` keeps working as it did before.
+ *
+ * The version belongs to the stored value shape. A future incompatible shape
+ * must use another key rather than reinterpret an older registry.
+ */
+const SYNTHETIC_COMMENT_STORES = Symbol.for(
+  "@ttsc/factory.syntheticComments.v1",
+);
+
+const createCommentStores = (): SyntheticCommentStores => ({
+  leading: new WeakMap<object, SynthesizedComment[]>(),
+  trailing: new WeakMap<object, SynthesizedComment[]>(),
+});
+
+const localCommentStores = createCommentStores();
+
+const commentStores = (): SyntheticCommentStores => {
+  const existing: unknown = Reflect.get(globalThis, SYNTHETIC_COMMENT_STORES);
+  if (existing !== undefined) return existing as SyntheticCommentStores;
+  try {
+    Object.defineProperty(globalThis, SYNTHETIC_COMMENT_STORES, {
+      configurable: false,
+      enumerable: false,
+      value: localCommentStores,
+      writable: false,
+    });
+    return localCommentStores;
+  } catch {
+    // Hardened realms can prohibit new global properties. Preserve the
+    // historical single-module behaviour there instead of making package load
+    // fail; cross-copy sharing necessarily requires a realm-owned rendezvous.
+    return localCommentStores;
+  }
+};
+
+const { leading: leadingStore, trailing: trailingStore } = commentStores();
 
 const append = (
   store: WeakMap<object, SynthesizedComment[]>,