@_linked/cli 1.28.1 → 1.29.0

package/lib/esm/plugins/pin-compiled-class-names.js

@@ -0,0 +1,59 @@
+/** Cheap pre-filter: a self-named class expression bound to a variable. */
+const SELF_NAMED_CLASS = /\b(?:let|var|const)\s+([\w$]+)\s*=\s*(?:[\w$]+\s*=\s*)*class\s+\1\b/;
+const JS_ID = /\.[cm]?js$/;
+/**
+ * Returns `code` with the runtime name of every top-level tsc-style decorated
+ * class expression pinned, or `null` when there is nothing to pin (or the
+ * module does not parse as JavaScript).
+ */
+export function pinDecoratedClassNames(code, parse) {
+    var _a;
+    if (!code.includes('__decorate(') || !SELF_NAMED_CLASS.test(code))
+        return null;
+    let ast;
+    try {
+        ast = parse(code);
+    }
+    catch (_b) {
+        return null;
+    }
+    const pins = [];
+    for (let node of ast.body) {
+        if (node.type === 'ExportNamedDeclaration' && node.declaration)
+            node = node.declaration;
+        if (node.type !== 'VariableDeclaration')
+            continue;
+        for (const decl of node.declarations) {
+            if (decl.id.type !== 'Identifier')
+                continue;
+            // `let Foo = Foo_1 = class Foo` — tsc's form when the class refers to itself.
+            let init = decl.init;
+            while (init && init.type === 'AssignmentExpression')
+                init = init.right;
+            if ((init === null || init === void 0 ? void 0 : init.type) === 'ClassExpression' && ((_a = init.id) === null || _a === void 0 ? void 0 : _a.name) === decl.id.name) {
+                pins.push({ at: node.end, name: decl.id.name });
+            }
+        }
+    }
+    if (pins.length === 0)
+        return null;
+    let out = code;
+    for (const { at, name } of pins.reverse()) {
+        const pin = ` Object.defineProperty(${name}, "name", {value: ${JSON.stringify(name)}, configurable: true});`;
+        out = out.slice(0, at) + pin + out.slice(at);
+    }
+    return out;
+}
+export function pinCompiledClassNames() {
+    return {
+        name: 'linked:pin-compiled-class-names',
+        enforce: 'pre',
+        transform(code, id) {
+            if (!JS_ID.test(id.split('?', 1)[0]))
+                return null;
+            const pinned = pinDecoratedClassNames(code, (c) => this.parse(c));
+            return pinned === null ? null : { code: pinned, map: null };
+        },
+    };
+}
+//# sourceMappingURL=pin-compiled-class-names.js.map

package/lib/esm/plugins/pin-compiled-class-names.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pin-compiled-class-names.js","sourceRoot":"","sources":["../../../src/plugins/pin-compiled-class-names.ts"],"names":[],"mappings":"AAoCA,2EAA2E;AAC3E,MAAM,gBAAgB,GACpB,qEAAqE,CAAC;AACxE,MAAM,KAAK,GAAG,YAAY,CAAC;AAE3B;;;;GAIG;AACH,MAAM,UAAU,sBAAsB,CACpC,IAAY,EACZ,KAAe;;IAEf,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC;QAC/D,OAAO,IAAI,CAAC;IACd,IAAI,GAAQ,CAAC;IACb,IAAI,CAAC;QACH,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC;IACpB,CAAC;IAAC,WAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,IAAI,GAAiC,EAAE,CAAC;IAC9C,KAAK,IAAI,IAAI,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC;QAC1B,IAAI,IAAI,CAAC,IAAI,KAAK,wBAAwB,IAAI,IAAI,CAAC,WAAW;YAC5D,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC;QAC1B,IAAI,IAAI,CAAC,IAAI,KAAK,qBAAqB;YAAE,SAAS;QAClD,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACrC,IAAI,IAAI,CAAC,EAAE,CAAC,IAAI,KAAK,YAAY;gBAAE,SAAS;YAC5C,8EAA8E;YAC9E,IAAI,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;YACrB,OAAO,IAAI,IAAI,IAAI,CAAC,IAAI,KAAK,sBAAsB;gBAAE,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC;YACvE,IAAI,CAAA,IAAI,aAAJ,IAAI,uBAAJ,IAAI,CAAE,IAAI,MAAK,iBAAiB,IAAI,CAAA,MAAA,IAAI,CAAC,EAAE,0CAAE,IAAI,MAAK,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC;gBACvE,IAAI,CAAC,IAAI,CAAC,EAAC,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,CAAC,IAAI,EAAC,CAAC,CAAC;YAChD,CAAC;QACH,CAAC;IACH,CAAC;IACD,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACnC,IAAI,GAAG,GAAG,IAAI,CAAC;IACf,KAAK,MAAM,EAAC,EAAE,EAAE,IAAI,EAAC,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC;QACxC,MAAM,GAAG,GAAG,0BAA0B,IAAI,qBAAqB,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,yBAAyB,CAAC;QAC7G,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAC/C,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,qBAAqB;IACnC,OAAO;QACL,IAAI,EAAE,iCAAiC;QACvC,OAAO,EAAE,KAAK;QACd,SAAS,CAAC,IAAI,EAAE,EAAE;YAChB,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;gBAAE,OAAO,IAAI,CAAC;YAClD,MAAM,MAAM,GAAG,sBAAsB,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;YAClE,OAAO,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAC,CAAC;QAC5D,CAAC;KACF,CAAC;AACJ,CAAC","sourcesContent":["// Keeps the runtime name of tsc-compiled decorated classes stable through Vite.\n//\n// A shape's IRI is built from its class name when `@linkedShape` is given no\n// explicit `name`, so anything that renames a shape class changes the shape's\n// identity. For a decorated class tsc emits\n//\n//   let Foo = class Foo { ... };\n//   Foo = __decorate([linkedShape], Foo);\n//\n// and esbuild, whenever it re-prints such a module, renames the inner binding\n// to avoid the shadowing: `let Foo = class Foo2`. The class is then called\n// `Foo2` at runtime — before any decorator sees it — and registers under the\n// wrong IRI. Vite re-prints a module with esbuild, without `keepNames`, in its\n// `vite:define` pass (client build: any module mentioning `process.env`,\n// `import.meta.env`, `import.meta.hot` or an app `define` key) and in the dev\n// client whenever a module mentions `process.env.NODE_ENV`. Neither pass can be\n// given `keepNames`, and `esbuild.keepNames` in the Vite config does not reach\n// them: it only reaches the minifier, which then keeps the already-wrong name.\n//\n// TypeScript source is not affected — esbuild lowers its decorators to an\n// anonymous `let Foo = class {`, which takes its name from the binding. Only\n// published lib JavaScript carries the self-named class expression.\n//\n// So before any of that runs, this plugin pins each such class's name with a\n// string literal placed right after its declaration — before the property and\n// class decorators run — which no later renaming can touch:\n//\n//   let Foo = class Foo { ... }; Object.defineProperty(Foo, \"name\", {value: \"Foo\", configurable: true});\n//\n// The insertion is on the declaration's own last line and moves no code, so\n// existing source maps stay valid (`map: null`).\nimport type {Plugin} from 'vite';\n\n/** An ESTree parser — the plugin context's `this.parse` (Rollup's parser). */\nexport type ParseAst = (code: string) => any;\n\n/** Cheap pre-filter: a self-named class expression bound to a variable. */\nconst SELF_NAMED_CLASS =\n  /\\b(?:let|var|const)\\s+([\\w$]+)\\s*=\\s*(?:[\\w$]+\\s*=\\s*)*class\\s+\\1\\b/;\nconst JS_ID = /\\.[cm]?js$/;\n\n/**\n * Returns `code` with the runtime name of every top-level tsc-style decorated\n * class expression pinned, or `null` when there is nothing to pin (or the\n * module does not parse as JavaScript).\n */\nexport function pinDecoratedClassNames(\n  code: string,\n  parse: ParseAst,\n): string | null {\n  if (!code.includes('__decorate(') || !SELF_NAMED_CLASS.test(code))\n    return null;\n  let ast: any;\n  try {\n    ast = parse(code);\n  } catch {\n    return null;\n  }\n  const pins: {at: number; name: string}[] = [];\n  for (let node of ast.body) {\n    if (node.type === 'ExportNamedDeclaration' && node.declaration)\n      node = node.declaration;\n    if (node.type !== 'VariableDeclaration') continue;\n    for (const decl of node.declarations) {\n      if (decl.id.type !== 'Identifier') continue;\n      // `let Foo = Foo_1 = class Foo` — tsc's form when the class refers to itself.\n      let init = decl.init;\n      while (init && init.type === 'AssignmentExpression') init = init.right;\n      if (init?.type === 'ClassExpression' && init.id?.name === decl.id.name) {\n        pins.push({at: node.end, name: decl.id.name});\n      }\n    }\n  }\n  if (pins.length === 0) return null;\n  let out = code;\n  for (const {at, name} of pins.reverse()) {\n    const pin = ` Object.defineProperty(${name}, \"name\", {value: ${JSON.stringify(name)}, configurable: true});`;\n    out = out.slice(0, at) + pin + out.slice(at);\n  }\n  return out;\n}\n\nexport function pinCompiledClassNames(): Plugin {\n  return {\n    name: 'linked:pin-compiled-class-names',\n    enforce: 'pre',\n    transform(code, id) {\n      if (!JS_ID.test(id.split('?', 1)[0])) return null;\n      const pinned = pinDecoratedClassNames(code, (c) => this.parse(c));\n      return pinned === null ? null : {code: pinned, map: null};\n    },\n  };\n}\n"]}

package/lib/esm/utils/shapeNames.d.ts

@@ -7,10 +7,13 @@ export interface ExposedShape {
  * renamed their class.
  *
  * A shape's IRI is built from its class name unless `@linkedShape({name})`
- * gives one. `keepNames` in Vite's own TypeScript transform protects source
- * files, but published `lib/` JavaScript never goes through that transform —
- * only through the define pass above. So a compiled shape is exposed exactly
- * when it has no explicit name and its module contains a trigger. This is how
+ * gives one. Source files are safe: esbuild lowers their decorators to an
+ * anonymous `let Foo = class {`, which takes its name from the binding. Only
+ * published `lib/` JavaScript carries the self-named class expression, so a
+ * compiled shape is exposed exactly when it has no explicit name and its module
+ * contains a trigger. `createViteConfig` pins these names
+ * (`plugins/pin-compiled-class-names.ts`), but other bundlers and hand-written
+ * Vite configs do not, so the explicit name is still the fix. This is how
  * `@_linked/server`'s `LinkedServer` and `LincdAPI` came to register as
  * `LinkedServer2` / `LincdAPI2`.
  */

package/lib/esm/utils/shapeNames.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shapeNames.d.ts","sourceRoot":"","sources":["../../../src/utils/shapeNames.ts"],"names":[],"mappings":"AAkBA,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,oBAAoB,GAC/B,QAAQ,MAAM,EACd,aAAS,KACR,YAAY,EASd,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,eAAe,GAC1B,aAAa,MAAM,KAClB,OAAO,CAAC,IAAI,GAAG,MAAM,CA2BvB,CAAC"}
+{"version":3,"file":"shapeNames.d.ts","sourceRoot":"","sources":["../../../src/utils/shapeNames.ts"],"names":[],"mappings":"AAkBA,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,oBAAoB,GAC/B,QAAQ,MAAM,EACd,aAAS,KACR,YAAY,EASd,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,eAAe,GAC1B,aAAa,MAAM,KAClB,OAAO,CAAC,IAAI,GAAG,MAAM,CA2BvB,CAAC"}

package/lib/esm/utils/shapeNames.js

@@ -27,10 +27,13 @@ const DECORATED = /\b([A-Za-z_$][\w$]*) = __decorate\(\[([\s\S]*?)\], \1\)/g;
  * renamed their class.
  *
  * A shape's IRI is built from its class name unless `@linkedShape({name})`
- * gives one. `keepNames` in Vite's own TypeScript transform protects source
- * files, but published `lib/` JavaScript never goes through that transform —
- * only through the define pass above. So a compiled shape is exposed exactly
- * when it has no explicit name and its module contains a trigger. This is how
+ * gives one. Source files are safe: esbuild lowers their decorators to an
+ * anonymous `let Foo = class {`, which takes its name from the binding. Only
+ * published `lib/` JavaScript carries the self-named class expression, so a
+ * compiled shape is exposed exactly when it has no explicit name and its module
+ * contains a trigger. `createViteConfig` pins these names
+ * (`plugins/pin-compiled-class-names.ts`), but other bundlers and hand-written
+ * Vite configs do not, so the explicit name is still the fix. This is how
  * `@_linked/server`'s `LinkedServer` and `LincdAPI` came to register as
  * `LinkedServer2` / `LincdAPI2`.
  */

package/lib/esm/utils/shapeNames.js.map

@@ -1 +1 @@
-{"version":3,"file":"shapeNames.js","sourceRoot":"","sources":["../../../src/utils/shapeNames.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB;;;;;;;;;GASG;AACH,MAAM,cAAc,GAAG,wCAAwC,CAAC;AAEhE,kEAAkE;AAClE,MAAM,SAAS,GAAG,0DAA0D,CAAC;AAO7E;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAClC,MAAc,EACd,IAAI,GAAG,EAAE,EACO,EAAE;IAClB,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC;QAAE,OAAO,EAAE,CAAC;IAC5C,MAAM,KAAK,GAAmB,EAAE,CAAC;IACjC,KAAK,MAAM,CAAC,EAAE,SAAS,EAAE,UAAU,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QACnE,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,UAAU,CAAC;YAAE,SAAS;QAClD,IAAI,wCAAwC,CAAC,IAAI,CAAC,UAAU,CAAC;YAAE,SAAS;QACxE,KAAK,CAAC,IAAI,CAAC,EAAC,IAAI,EAAE,SAAS,EAAC,CAAC,CAAC;IAChC,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAC7B,WAAmB,EACK,EAAE;IAC1B,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;IACpD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC;QAAE,OAAO,IAAI,CAAC;IACxC,MAAM,OAAO,GAAmB,EAAE,CAAC;IACnC,MAAM,IAAI,GAAG,CAAC,GAAW,EAAE,EAAE;QAC3B,KAAK,MAAM,KAAK,IAAI,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE,EAAC,aAAa,EAAE,IAAI,EAAC,CAAC,EAAE,CAAC;YAC/D,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YACxC,IAAI,KAAK,CAAC,WAAW,EAAE;gBAAE,IAAI,CAAC,IAAI,CAAC,CAAC;iBAC/B,IAAI,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;gBACpC,OAAO,CAAC,IAAI,CACV,GAAG,oBAAoB,CACrB,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,EAC7B,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,CAC5B,CACF,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC,CAAC;IACF,IAAI,CAAC,MAAM,CAAC,CAAC;IACb,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACtC,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,SAAS,KAAK,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC3E,OAAO,CACL,GAAG,OAAO,CAAC,MAAM,yDAAyD;QAC1E,8EAA8E;QAC9E,oBAAoB,MAAM,gCAAgC;QAC1D,sCAAsC,CACvC,CAAC;AACJ,CAAC,CAAA,CAAC","sourcesContent":["import fs from 'fs';\nimport path from 'path';\n\n/**\n * Text that makes Vite run an extra `esbuild.transform` over a compiled module.\n *\n * Vite's `vite:define` plugin transforms any module containing a `define` key\n * (`process.env` and `import.meta.env` / `import.meta.hot` are its own keys in\n * a client build), and in dev it rewrites `process.env.NODE_ENV` in client\n * modules the same way. That pass does not set `keepNames`, and esbuild\n * renames the inner binding of the class expression tsc emits for a decorated\n * class: `let Foo = class Foo` becomes `class Foo2`.\n */\nconst RENAME_TRIGGER = /process\\.env|import\\.meta\\.(?:env|hot)/;\n\n/** `Foo = __decorate([ …decorators… ], Foo)`, as tsc emits it. */\nconst DECORATED = /\\b([A-Za-z_$][\\w$]*) = __decorate\\(\\[([\\s\\S]*?)\\], \\1\\)/g;\n\nexport interface ExposedShape {\n  file: string;\n  className: string;\n}\n\n/**\n * Shapes in one compiled module whose identity would change if a bundler\n * renamed their class.\n *\n * A shape's IRI is built from its class name unless `@linkedShape({name})`\n * gives one. `keepNames` in Vite's own TypeScript transform protects source\n * files, but published `lib/` JavaScript never goes through that transform —\n * only through the define pass above. So a compiled shape is exposed exactly\n * when it has no explicit name and its module contains a trigger. This is how\n * `@_linked/server`'s `LinkedServer` and `LincdAPI` came to register as\n * `LinkedServer2` / `LincdAPI2`.\n */\nexport const findRenameableShapes = (\n  source: string,\n  file = '',\n): ExposedShape[] => {\n  if (!RENAME_TRIGGER.test(source)) return [];\n  const found: ExposedShape[] = [];\n  for (const [, className, decorators] of source.matchAll(DECORATED)) {\n    if (!/\\blinkedShape\\b/.test(decorators)) continue;\n    if (/\\blinkedShape\\(\\s*\\{[\\s\\S]*?\\bname\\s*:/.test(decorators)) continue;\n    found.push({file, className});\n  }\n  return found;\n};\n\n/**\n * Build step: warn about every exposed shape in a package's compiled ESM.\n *\n * A warning, not a failure: it is only a hazard when a consumer's bundler\n * actually rewrites the module, and naming the shape is a change to the\n * package's source that its owner has to make.\n */\nexport const checkShapeNames = async (\n  packagePath: string,\n): Promise<true | string> => {\n  const libDir = path.join(packagePath, 'lib', 'esm');\n  if (!fs.existsSync(libDir)) return true;\n  const exposed: ExposedShape[] = [];\n  const walk = (dir: string) => {\n    for (const entry of fs.readdirSync(dir, {withFileTypes: true})) {\n      const full = path.join(dir, entry.name);\n      if (entry.isDirectory()) walk(full);\n      else if (entry.name.endsWith('.js')) {\n        exposed.push(\n          ...findRenameableShapes(\n            fs.readFileSync(full, 'utf8'),\n            path.relative(libDir, full),\n          ),\n        );\n      }\n    }\n  };\n  walk(libDir);\n  if (exposed.length === 0) return true;\n  const listed = exposed.map((s) => `${s.className} (${s.file})`).join(', ');\n  return (\n    `${exposed.length} shape(s) take their identity from a class name that a ` +\n    `consumer's bundler may rename, because the module also reads process.env or ` +\n    `import.meta.env: ${listed}. Give each an explicit name: ` +\n    `@linkedShape({name: '<ClassName>'}).`\n  );\n};\n"]}
+{"version":3,"file":"shapeNames.js","sourceRoot":"","sources":["../../../src/utils/shapeNames.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB;;;;;;;;;GASG;AACH,MAAM,cAAc,GAAG,wCAAwC,CAAC;AAEhE,kEAAkE;AAClE,MAAM,SAAS,GAAG,0DAA0D,CAAC;AAO7E;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAClC,MAAc,EACd,IAAI,GAAG,EAAE,EACO,EAAE;IAClB,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC;QAAE,OAAO,EAAE,CAAC;IAC5C,MAAM,KAAK,GAAmB,EAAE,CAAC;IACjC,KAAK,MAAM,CAAC,EAAE,SAAS,EAAE,UAAU,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QACnE,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,UAAU,CAAC;YAAE,SAAS;QAClD,IAAI,wCAAwC,CAAC,IAAI,CAAC,UAAU,CAAC;YAAE,SAAS;QACxE,KAAK,CAAC,IAAI,CAAC,EAAC,IAAI,EAAE,SAAS,EAAC,CAAC,CAAC;IAChC,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAC7B,WAAmB,EACK,EAAE;IAC1B,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;IACpD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC;QAAE,OAAO,IAAI,CAAC;IACxC,MAAM,OAAO,GAAmB,EAAE,CAAC;IACnC,MAAM,IAAI,GAAG,CAAC,GAAW,EAAE,EAAE;QAC3B,KAAK,MAAM,KAAK,IAAI,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE,EAAC,aAAa,EAAE,IAAI,EAAC,CAAC,EAAE,CAAC;YAC/D,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YACxC,IAAI,KAAK,CAAC,WAAW,EAAE;gBAAE,IAAI,CAAC,IAAI,CAAC,CAAC;iBAC/B,IAAI,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;gBACpC,OAAO,CAAC,IAAI,CACV,GAAG,oBAAoB,CACrB,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,EAC7B,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,CAC5B,CACF,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC,CAAC;IACF,IAAI,CAAC,MAAM,CAAC,CAAC;IACb,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACtC,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,SAAS,KAAK,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC3E,OAAO,CACL,GAAG,OAAO,CAAC,MAAM,yDAAyD;QAC1E,8EAA8E;QAC9E,oBAAoB,MAAM,gCAAgC;QAC1D,sCAAsC,CACvC,CAAC;AACJ,CAAC,CAAA,CAAC","sourcesContent":["import fs from 'fs';\nimport path from 'path';\n\n/**\n * Text that makes Vite run an extra `esbuild.transform` over a compiled module.\n *\n * Vite's `vite:define` plugin transforms any module containing a `define` key\n * (`process.env` and `import.meta.env` / `import.meta.hot` are its own keys in\n * a client build), and in dev it rewrites `process.env.NODE_ENV` in client\n * modules the same way. That pass does not set `keepNames`, and esbuild\n * renames the inner binding of the class expression tsc emits for a decorated\n * class: `let Foo = class Foo` becomes `class Foo2`.\n */\nconst RENAME_TRIGGER = /process\\.env|import\\.meta\\.(?:env|hot)/;\n\n/** `Foo = __decorate([ …decorators… ], Foo)`, as tsc emits it. */\nconst DECORATED = /\\b([A-Za-z_$][\\w$]*) = __decorate\\(\\[([\\s\\S]*?)\\], \\1\\)/g;\n\nexport interface ExposedShape {\n  file: string;\n  className: string;\n}\n\n/**\n * Shapes in one compiled module whose identity would change if a bundler\n * renamed their class.\n *\n * A shape's IRI is built from its class name unless `@linkedShape({name})`\n * gives one. Source files are safe: esbuild lowers their decorators to an\n * anonymous `let Foo = class {`, which takes its name from the binding. Only\n * published `lib/` JavaScript carries the self-named class expression, so a\n * compiled shape is exposed exactly when it has no explicit name and its module\n * contains a trigger. `createViteConfig` pins these names\n * (`plugins/pin-compiled-class-names.ts`), but other bundlers and hand-written\n * Vite configs do not, so the explicit name is still the fix. This is how\n * `@_linked/server`'s `LinkedServer` and `LincdAPI` came to register as\n * `LinkedServer2` / `LincdAPI2`.\n */\nexport const findRenameableShapes = (\n  source: string,\n  file = '',\n): ExposedShape[] => {\n  if (!RENAME_TRIGGER.test(source)) return [];\n  const found: ExposedShape[] = [];\n  for (const [, className, decorators] of source.matchAll(DECORATED)) {\n    if (!/\\blinkedShape\\b/.test(decorators)) continue;\n    if (/\\blinkedShape\\(\\s*\\{[\\s\\S]*?\\bname\\s*:/.test(decorators)) continue;\n    found.push({file, className});\n  }\n  return found;\n};\n\n/**\n * Build step: warn about every exposed shape in a package's compiled ESM.\n *\n * A warning, not a failure: it is only a hazard when a consumer's bundler\n * actually rewrites the module, and naming the shape is a change to the\n * package's source that its owner has to make.\n */\nexport const checkShapeNames = async (\n  packagePath: string,\n): Promise<true | string> => {\n  const libDir = path.join(packagePath, 'lib', 'esm');\n  if (!fs.existsSync(libDir)) return true;\n  const exposed: ExposedShape[] = [];\n  const walk = (dir: string) => {\n    for (const entry of fs.readdirSync(dir, {withFileTypes: true})) {\n      const full = path.join(dir, entry.name);\n      if (entry.isDirectory()) walk(full);\n      else if (entry.name.endsWith('.js')) {\n        exposed.push(\n          ...findRenameableShapes(\n            fs.readFileSync(full, 'utf8'),\n            path.relative(libDir, full),\n          ),\n        );\n      }\n    }\n  };\n  walk(libDir);\n  if (exposed.length === 0) return true;\n  const listed = exposed.map((s) => `${s.className} (${s.file})`).join(', ');\n  return (\n    `${exposed.length} shape(s) take their identity from a class name that a ` +\n    `consumer's bundler may rename, because the module also reads process.env or ` +\n    `import.meta.env: ${listed}. Give each an explicit name: ` +\n    `@linkedShape({name: '<ClassName>'}).`\n  );\n};\n"]}

package/lib/esm/vite-config.d.ts

@@ -126,6 +126,22 @@ export declare function discoverLinkedSourceDependencies(cwd?: string): Promise<
  * dependencies for.
  */
 export declare function discoverWorkspaces(extraGlobs?: string[], cwd?: string): Promise<WorkspaceEntry[]>;
+/**
+ * Packages whose entry `linked start` hands to `vite.ssrLoadModule` by name
+ * (`@_linked/server/shapes/LinkedServer`, see `commands/start.ts`).
+ *
+ * Vite transforms an explicitly requested entry, and every file it reaches by
+ * RELATIVE import, whether or not the package is external. The same package's
+ * bare-specifier imports from anywhere else (the app's `src`, the storage
+ * config) are externalized to Node. Left external, the package is split across
+ * two loaders, and which copy a file ends up in depends on import order: a file
+ * the module runner has already evaluated is reused, one it has not is loaded
+ * by Node, and Node then loads that file's relative imports itself. Measured in
+ * CN: `package.js` and `ontologies/lincd-server.js` evaluated once by each
+ * loader, and `LocalFileStore.js` too once the package's `backend` was loaded.
+ * Bundling the package makes Vite the only loader for it.
+ */
+export declare const SSR_ENTRY_PACKAGES: string[];
 /**
  * `ssr.noExternal` for the dev SSR runner. With source workspaces, only those
  * package names are bundled by Vite; everything else in node_modules (including
@@ -134,6 +150,7 @@ export declare function discoverWorkspaces(extraGlobs?: string[], cwd?: string):
  * Installed packages that depend on a workspace (`dependents`, from
  * `workspaceDependents`) are bundled too, so they share the Vite-loaded workspace.
  * Standalone (no workspaces): the context-holding framework packages are bundled.
+ * In both modes, `SSR_ENTRY_PACKAGES` are bundled.
  */
 export declare function ssrNoExternal(workspaces: {
     name: string;

package/lib/esm/vite-config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"vite-config.d.ts","sourceRoot":"","sources":["../../src/vite-config.ts"],"names":[],"mappings":"AAWA,OAAO,EAAC,YAAY,EAAC,MAAM,MAAM,CAAC;AAMlC,OAAO,KAAK,EAAC,MAAM,EAAa,MAAM,MAAM,CAAC;AAuB7C;;;;;;;;;;;;;;;GAeG;AACH;;;;;;;;;;GAUG;AACH,eAAO,MAAM,gBAAgB,GAAI,IAAI,MAAM,KAAG,MAAM,GAAG,SAyDtD,CAAC;AAEF,wBAAgB,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAQnD;AAED,MAAM,WAAW,uBAAuB;IACtC,qCAAqC;IACrC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,6DAA6D;IAC7D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,yBAAyB;IACzB,OAAO,CAAC,EAAE,UAAU,GAAG,kBAAkB,CAAC;IAC1C,iEAAiE;IACjE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0BAA0B;IAC1B,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,iEAAiE;IACjE,cAAc,CAAC,EAAE,OAAO,EAAE,CAAC;IAC3B;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC;;;;;;;;;;;;OAYG;IACH,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED,UAAU,cAAc;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAwCD;;;;;;;;;;;;;GAaG;AACH,wBAAsB,mBAAmB,CACvC,UAAU,EAAE;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAC,EAAE,EAC7C,GAAG,GAAE,MAAsB,GAC1B,OAAO,CAAC,MAAM,EAAE,CAAC,CAsEnB;AAoBD;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAsB,gCAAgC,CACpD,GAAG,GAAE,MAAsB,GAC1B,OAAO,CAAC,cAAc,EAAE,CAAC,CAmC3B;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,kBAAkB,CACtC,UAAU,GAAE,MAAM,EAAO,EACzB,GAAG,GAAE,MAAsB,GAC1B,OAAO,CAAC,cAAc,EAAE,CAAC,CAyD3B;AAwCD;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAC3B,UAAU,EAAE;IAAC,IAAI,EAAE,MAAM,CAAA;CAAC,EAAE,EAC5B,UAAU,GAAE,MAAM,EAAO,GACxB,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAGrB;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAC1B,IAAI,GAAE,IAAI,CAAC,uBAAuB,EAAE,QAAQ,GAAG,MAAM,CAAM,GAC1D,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAaxB;AAED,wBAAgB,gBAAgB,CAAC,IAAI,GAAE,uBAA4B,GAAG,UAAU,CAAC,OAAO,YAAY,CAAC,CA8WpG"}
+{"version":3,"file":"vite-config.d.ts","sourceRoot":"","sources":["../../src/vite-config.ts"],"names":[],"mappings":"AAWA,OAAO,EAAC,YAAY,EAAC,MAAM,MAAM,CAAC;AAOlC,OAAO,KAAK,EAAC,MAAM,EAAa,MAAM,MAAM,CAAC;AAuB7C;;;;;;;;;;;;;;;GAeG;AACH;;;;;;;;;;GAUG;AACH,eAAO,MAAM,gBAAgB,GAAI,IAAI,MAAM,KAAG,MAAM,GAAG,SAyDtD,CAAC;AAEF,wBAAgB,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAQnD;AAED,MAAM,WAAW,uBAAuB;IACtC,qCAAqC;IACrC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,6DAA6D;IAC7D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,yBAAyB;IACzB,OAAO,CAAC,EAAE,UAAU,GAAG,kBAAkB,CAAC;IAC1C,iEAAiE;IACjE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0BAA0B;IAC1B,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,iEAAiE;IACjE,cAAc,CAAC,EAAE,OAAO,EAAE,CAAC;IAC3B;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC;;;;;;;;;;;;OAYG;IACH,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED,UAAU,cAAc;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAwCD;;;;;;;;;;;;;GAaG;AACH,wBAAsB,mBAAmB,CACvC,UAAU,EAAE;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAC,EAAE,EAC7C,GAAG,GAAE,MAAsB,GAC1B,OAAO,CAAC,MAAM,EAAE,CAAC,CAsEnB;AAoBD;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAsB,gCAAgC,CACpD,GAAG,GAAE,MAAsB,GAC1B,OAAO,CAAC,cAAc,EAAE,CAAC,CAmC3B;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,kBAAkB,CACtC,UAAU,GAAE,MAAM,EAAO,EACzB,GAAG,GAAE,MAAsB,GAC1B,OAAO,CAAC,cAAc,EAAE,CAAC,CAyD3B;AAwCD;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,kBAAkB,UAAsB,CAAC;AAEtD;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAC3B,UAAU,EAAE;IAAC,IAAI,EAAE,MAAM,CAAA;CAAC,EAAE,EAC5B,UAAU,GAAE,MAAM,EAAO,GACxB,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAKrB;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAC1B,IAAI,GAAE,IAAI,CAAC,uBAAuB,EAAE,QAAQ,GAAG,MAAM,CAAM,GAC1D,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAaxB;AAED,wBAAgB,gBAAgB,CAAC,IAAI,GAAE,uBAA4B,GAAG,UAAU,CAAC,OAAO,YAAY,CAAC,CAuXpG"}

package/lib/esm/vite-config.js

@@ -24,6 +24,7 @@ import fsExtra from 'fs-extra';
 import path from 'node:path';
 import { generateScopedName } from './utils.js';
 import { parseWorkspacePatterns, isWorkspacePathNegated } from './workspace-globs.js';
+import { pinCompiledClassNames } from './plugins/pin-compiled-class-names.js';
 /**
  * Framework packages that MUST be single-instance per runtime — they hold
  * module-level state (`@_linked/core`'s shape registry, `LinkedStorage`, the query
@@ -468,6 +469,22 @@ function resolveWorkspaceSpecifier(specifier, workspaces) {
         return null;
     });
 }
+/**
+ * Packages whose entry `linked start` hands to `vite.ssrLoadModule` by name
+ * (`@_linked/server/shapes/LinkedServer`, see `commands/start.ts`).
+ *
+ * Vite transforms an explicitly requested entry, and every file it reaches by
+ * RELATIVE import, whether or not the package is external. The same package's
+ * bare-specifier imports from anywhere else (the app's `src`, the storage
+ * config) are externalized to Node. Left external, the package is split across
+ * two loaders, and which copy a file ends up in depends on import order: a file
+ * the module runner has already evaluated is reused, one it has not is loaded
+ * by Node, and Node then loads that file's relative imports itself. Measured in
+ * CN: `package.js` and `ontologies/lincd-server.js` evaluated once by each
+ * loader, and `LocalFileStore.js` too once the package's `backend` was loaded.
+ * Bundling the package makes Vite the only loader for it.
+ */
+export const SSR_ENTRY_PACKAGES = ['@_linked/server'];
 /**
  * `ssr.noExternal` for the dev SSR runner. With source workspaces, only those
  * package names are bundled by Vite; everything else in node_modules (including
@@ -476,11 +493,13 @@ function resolveWorkspaceSpecifier(specifier, workspaces) {
  * Installed packages that depend on a workspace (`dependents`, from
  * `workspaceDependents`) are bundled too, so they share the Vite-loaded workspace.
  * Standalone (no workspaces): the context-holding framework packages are bundled.
+ * In both modes, `SSR_ENTRY_PACKAGES` are bundled.
  */
 export function ssrNoExternal(workspaces, dependents = []) {
-    if (workspaces.length === 0)
-        return [/^@_linked\/server-utils$/, /^@_linked\/react$/];
-    return [...new Set([...workspaces.map((w) => w.name), ...dependents])];
+    if (workspaces.length === 0) {
+        return [/^@_linked\/server-utils$/, /^@_linked\/react$/, ...SSR_ENTRY_PACKAGES];
+    }
+    return [...new Set([...workspaces.map((w) => w.name), ...dependents, ...SSR_ENTRY_PACKAGES])];
 }
 /**
  * The `process.env.*` values inlined into the browser bundle — and only there.
@@ -615,6 +634,9 @@ export function createViteConfig(opts = {}) {
                         },
                     }
                     : null,
+                // Published lib JS: keep decorated shape classes named `Foo`, not the
+                // `Foo2` Vite's esbuild re-prints would give them — see the plugin.
+                pinCompiledClassNames(),
                 react({
                     babel: {
                         parserOpts: {
@@ -660,6 +682,10 @@ export function createViteConfig(opts = {}) {
                 // `.../BackendAPIStore`, and every Server.call on that shape 501'd.
                 // The same mangling made registration report `Shape undefined does not
                 // extend base class`.
+                //
+                // Vite honours this in the minifier only: its per-file TypeScript
+                // transform and its define pass both run esbuild with keepNames off.
+                // `pinCompiledClassNames` above covers what those passes rename.
                 keepNames: true,
             } }, (isStandalone
             ? {
@@ -719,8 +745,9 @@ export function createViteConfig(opts = {}) {
                 // DIFFERENT module instances → two `AppContext` objects → `useAppContext()` sees
                 // no provider (null) → "Cannot destructure 'isNativeApp'" and a blank "SSR timed
                 // out". Bundling makes them one instance in Vite's SSR module graph (matching how
-                // workspace mode bundles everything). Native-dep packages (`server`/`fuseki`) stay
-                // external so their prebuilt binaries load via Node.
+                // workspace mode bundles everything). `fuseki` stays external; `server` is bundled
+                // because `start` loads its entry through Vite (`SSR_ENTRY_PACKAGES`). Their native
+                // dependencies (e.g. `sharp`) are separate packages and stay external either way.
                 //
                 // WORKSPACE: bundle ONLY the discovered source workspaces (they resolve to `src/`
                 // for HMR). Published framework packages installed under node_modules (lib-only)
@@ -730,7 +757,8 @@ export function createViteConfig(opts = {}) {
                 // as `@_linked/fuseki/shapes/FusekiStore` through native `import()`, which pulled
                 // a SECOND Node-loaded core and split the shape registry. Installed packages
                 // that depend on a workspace (e.g. published fuseki when core itself is a
-                // workspace) are bundled too, so they import the Vite-loaded workspace.
+                // workspace) are bundled too, so they import the Vite-loaded workspace. The one
+                // published exception is `SSR_ENTRY_PACKAGES`, which Vite loads regardless.
                 //
                 // NOT DEV (a release build of the backend): nothing is force-bundled. The
                 // compiled backend is loaded by Node next to the installed