@volter/editor-core 0.5.57

package/LICENSE-APACHE

@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright 2026 Volter AI, Inc.
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/NOTICE

@@ -0,0 +1,18 @@
+Copyright 2026 Volter AI, Inc.
+
+Editor source, server modules and build plugins were imported from the AGPL-3.0-only
+@vgai/editor package. LICENSE contains that license.
+
+src/performance-profiler.ts was imported from the Apache-2.0
+@vgai/game-runtime package and retains that license. LICENSE-APACHE
+contains its text. This timing collector does not execute gameplay.
+The built plugins also include the Apache-2.0 editor-sdk contribution naming
+constants; their source remains owned by editor-sdk.
+
+Original source revisions and file hashes are recorded in the repository's
+provenance/editor-host.json and provenance/editor-session.json, provenance/editor-server.json and
+provenance/editor-workbench.json. Bundled dependency license texts are preserved in BUNDLED_NOTICES.
+Native assets and the workbench distribution require separate review.
+
+server/support/ modules transferred from @vgai/sdk are Apache-2.0.
+Their source paths and hashes are recorded in provenance/editor-server.json.

package/README.md

@@ -0,0 +1,24 @@
+# Volter Editor core
+
+Shared document host, panels, Three viewport infrastructure and Code-OSS bridge.
+Products compose this host with contributions through `frame/product`; document
+owners register their openers. The modeling host does not install a game-world
+mount or built-in scene evaluator.
+
+The source was transferred from the revision recorded in
+`../../provenance/editor-host.json`. Three-aware core is deliberate for this
+release; this is not a renderer-neutral viewport extraction. Runtime world
+mounting, game input and game fixtures are outside this package.
+
+Build plugins ship as JavaScript under `dist/build` so Node can load them from
+an installed archive. Source remains available for review and public types.
+Run `npm run build:plugins` before building a product from a fresh checkout;
+`npm pack` runs this step automatically.
+
+This package is private staging. Session route composition, installed-editor
+startup, live modeling verification and final notices remain outstanding.
+
+The `server/*` exports preserve the existing workbench proxy, registry writer,
+worktree identity, opener and shutdown mechanisms. They do not yet compose a
+complete editor server. Build them with `npm run build:session`; packing builds
+them automatically. Tests exercise HTTP routing/isolation and bounded cleanup.

package/dist/build/chunk-JS4D4XZ3.js

@@ -0,0 +1,175 @@
+// vite-plugin-shared-react.ts
+import { existsSync, readFileSync } from "node:fs";
+import { createRequire } from "node:module";
+import path from "node:path";
+
+// ../editor-sdk/src/session/tool-contribution-convention.ts
+var CONTRIBUTIONS_DIR = "src/contributions";
+var TOOLS_DIR = "src/tools";
+var EDITOR_LANE_DIRS = [CONTRIBUTIONS_DIR, TOOLS_DIR];
+
+// vite-plugin-shared-react.ts
+var SHARED_REACT_ENTRIES = {
+  react: "vgai-shared-react",
+  "react-dom": "vgai-shared-react-dom",
+  "react-dom/client": "vgai-shared-react-dom-client",
+  "react/jsx-runtime": "vgai-shared-jsx-runtime",
+  "react/jsx-dev-runtime": "vgai-shared-jsx-dev-runtime",
+  "@fortawesome/react-fontawesome": "vgai-shared-fontawesome"
+};
+var SHARED_REACT_SPECIFIERS = Object.keys(SHARED_REACT_ENTRIES);
+var SHARED_REACT_MANIFEST_FILE = "vgai-shared-react.json";
+var VIRTUAL_PREFIX = "\0vgai-shared-react:";
+function sharedReactEntryModule(specifier, exportNames) {
+  const named = exportNames.filter((name) => VALID_IDENTIFIER.test(name)).map((name) => `export const ${name} = __m.${name};`);
+  return [
+    `import * as __ns from ${JSON.stringify(specifier)};`,
+    // Bracketed on purpose: `__ns.default` makes rollup warn that the ES-module
+    // shape (the jsx-dev-runtime shim) has no `default` export, which is the
+    // case this line exists to handle.
+    "const __m = __ns['default'] ?? __ns;",
+    "export default __m;",
+    ...named,
+    ""
+  ].join("\n");
+}
+var VALID_IDENTIFIER = /^[A-Za-z_$][A-Za-z0-9_$]*$/;
+function installedExportNames(fromDir, specifier) {
+  const require_ = createRequire(path.join(fromDir, "package.json"));
+  const loaded = require_(specifier);
+  return Object.keys(loaded).filter((name) => name !== "default");
+}
+function sharedReactBuildPlugin(fromDir) {
+  const referenceIds = /* @__PURE__ */ new Map();
+  return {
+    name: "vgai-shared-react-build",
+    apply: "build",
+    buildStart() {
+      referenceIds.clear();
+      for (const specifier of SHARED_REACT_SPECIFIERS) {
+        referenceIds.set(
+          specifier,
+          this.emitFile({
+            type: "chunk",
+            id: `${VIRTUAL_PREFIX}${specifier}`,
+            name: SHARED_REACT_ENTRIES[specifier],
+            // Vite's app build sets `preserveEntrySignatures: false`, which
+            // mangles an entry's export names away. Per-chunk `strict` is what
+            // keeps `useState` spelled `useState` in the emitted file — the
+            // whole point of publishing it.
+            preserveSignature: "strict"
+          })
+        );
+      }
+    },
+    resolveId(id) {
+      return id.startsWith(VIRTUAL_PREFIX) ? id : void 0;
+    },
+    load(id) {
+      if (!id.startsWith(VIRTUAL_PREFIX)) return void 0;
+      const specifier = id.slice(VIRTUAL_PREFIX.length);
+      return sharedReactEntryModule(specifier, installedExportNames(fromDir, specifier));
+    },
+    generateBundle() {
+      const files = {};
+      for (const [specifier, referenceId] of referenceIds) {
+        files[specifier] = this.getFileName(referenceId);
+      }
+      this.emitFile({
+        type: "asset",
+        fileName: SHARED_REACT_MANIFEST_FILE,
+        source: `${JSON.stringify({ files }, null, 2)}
+`
+      });
+    }
+  };
+}
+function readSharedReactManifest(distPath) {
+  const manifestPath = path.join(distPath, SHARED_REACT_MANIFEST_FILE);
+  if (!existsSync(manifestPath)) return null;
+  let manifest;
+  try {
+    manifest = JSON.parse(readFileSync(manifestPath, "utf8"));
+  } catch {
+    return null;
+  }
+  if (SHARED_REACT_SPECIFIERS.some((specifier) => !manifest.files?.[specifier])) return null;
+  return manifest;
+}
+function sharedReactUrls(manifest, base = "/") {
+  const prefix = base.endsWith("/") ? base : `${base}/`;
+  return Object.fromEntries(
+    SHARED_REACT_SPECIFIERS.map((specifier) => [
+      specifier,
+      `${prefix}${manifest.files[specifier]}`
+    ])
+  );
+}
+var EDITOR_TREE_QUERY = "vgai-editor-react";
+var PACKAGE_CONTRIBUTION_PATH = /[\\/]node_modules[\\/]@vgai[\\/][^\\/]+[\\/]contributions[\\/]/;
+function markEditorTree(id) {
+  return id.includes(`?${EDITOR_TREE_QUERY}`) || id.includes(`&${EDITOR_TREE_QUERY}`) ? id : `${id}${id.includes("?") ? "&" : "?"}${EDITOR_TREE_QUERY}`;
+}
+function stripQuery(id) {
+  const cut = id.indexOf("?");
+  return cut === -1 ? id : id.slice(0, cut);
+}
+function isUnder(file, directory) {
+  return file === directory || file.startsWith(`${directory}${path.sep}`);
+}
+function sharedReactPlugin({
+  urls,
+  editorPackageRoot,
+  projectRoots
+}) {
+  const editorSrc = path.join(editorPackageRoot, "src");
+  const layoutSdkSrc = path.resolve(editorPackageRoot, "../editor-sdk/src");
+  const inEditorTree = (importer) => {
+    if (!importer) return false;
+    if (importer.includes(EDITOR_TREE_QUERY)) return true;
+    const file = stripQuery(importer);
+    if (isUnder(file, editorSrc) || isUnder(file, layoutSdkSrc)) return true;
+    if (PACKAGE_CONTRIBUTION_PATH.test(file)) return true;
+    for (const root of projectRoots()) {
+      if (file === path.join(root, "vgai.adapter.ts")) return true;
+      if (EDITOR_LANE_DIRS.some((dir) => isUnder(file, path.join(root, dir)))) return true;
+    }
+    return false;
+  };
+  const isOwnSource = (file) => {
+    if (!path.isAbsolute(file)) return false;
+    if (isUnder(file, editorSrc) || isUnder(file, layoutSdkSrc)) return true;
+    if (file.includes(`${path.sep}node_modules${path.sep}`)) return false;
+    for (const root of projectRoots()) {
+      if (isUnder(file, root)) return true;
+    }
+    return false;
+  };
+  return {
+    name: "vgai-shared-react",
+    enforce: "pre",
+    async resolveId(source, importer, options) {
+      if (options?.scan) return void 0;
+      if (!inEditorTree(importer)) return void 0;
+      const url = urls[source];
+      if (url) return url;
+      const resolved = await this.resolve(source, importer, { ...options, skipSelf: true });
+      if (!resolved || resolved.external) return resolved ?? void 0;
+      return isOwnSource(stripQuery(resolved.id)) ? { ...resolved, id: markEditorTree(resolved.id) } : resolved;
+    }
+  };
+}
+
+export {
+  SHARED_REACT_ENTRIES,
+  SHARED_REACT_SPECIFIERS,
+  SHARED_REACT_MANIFEST_FILE,
+  sharedReactEntryModule,
+  installedExportNames,
+  sharedReactBuildPlugin,
+  readSharedReactManifest,
+  sharedReactUrls,
+  EDITOR_TREE_QUERY,
+  sharedReactPlugin
+};
+//# sourceMappingURL=chunk-JS4D4XZ3.js.map

package/dist/build/chunk-JS4D4XZ3.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../vite-plugin-shared-react.ts", "../../../editor-sdk/src/session/tool-contribution-convention.ts"],
+  "sourcesContent": ["/**\n * ONE React for the editor's own tree \u2014 the shell's.\n *\n * ## The defect this closes\n *\n * Under the PACKAGED runtime (`server/packaged.ts`: a `@vgai/editor` npm\n * package with no monorepo checkout) the page runs two module graphs at once:\n *\n *  - the editor shell, a PREBUILT production bundle (`dist/assets/index-*.js`)\n *    with its own React inlined; and\n *  - the opened PROJECT's source, served fresh by a second, project-rooted\n *    Vite instance, whose bare `react` resolves \u2014 correctly, for its root \u2014 to\n *    the PROJECT's own `node_modules`.\n *\n * Anything the project contributes that renders INSIDE the editor's React tree\n * therefore called hooks from a different React than the one reconciling it.\n * Measured on a fresh scaffold against the published 0.5.17 packaged editor:\n * all four dev-tools inspector facets (`src/tools/game-*.inspector.tsx`)\n * REGISTERED (`editor.inspect()` listed them) and then threw\n * `Invalid hook call \u2026 more than one copy of React in the same app` instead of\n * drawing \u2014 and so did every other project contribution that renders (the\n * humanoid/bird/castle builder inspectors, the World Labs asset inspector, the\n * data-tables document). None of it was visible from a checkout: `dev.ts`\n * serves the editor's OWN source and the project's source through ONE Vite\n * with `resolve.dedupe: ['react', \u2026]`, so in-repo there has only ever been one\n * React and every in-repo check passed.\n *\n * ## The mechanism: URL identity\n *\n * The editor build emits one extra ENTRY chunk per specifier in\n * {@link SHARED_REACT_ENTRIES} \u2014 the SHELL's own React, `react-dom`,\n * `react-dom/client`, `react/jsx-runtime`, `react/jsx-dev-runtime`, and the one\n * third-party package that CALLS React hooks inside the editor's tree. Because\n * they are entries of the SAME build, rollup hoists the actual module into a\n * chunk both they and the shell import: they are not a copy of React, they are\n * a doorway onto the shell's instance.\n *\n * At serve time {@link sharedReactPlugin} resolves those specifiers, for\n * every module in the EDITOR TREE (see below), to the built chunk's URL\n * (`/assets/vgai-shared-react-<hash>.js`) \u2014 the SAME absolute URL the shell's\n * own bundle imports, so the browser's module map hands both sides the one\n * instance.\n *\n * ### Why the entry bodies are GENERATED, not written\n *\n * The obvious spelling \u2014 a one-line `export * from 'react'` \u2014 silently emits a\n * chunk with NO named exports (measured: the built chunk exported only the\n * default and the raw namespace). React ships CommonJS, and rollup makes\n * `import { useState } from 'react'` work by rewriting the IMPORTER's member\n * access, not by synthesizing static named exports a star can forward. So each\n * entry body is generated at build time from the installed package's own\n * runtime key list (`Object.keys(require('react'))`), and every export is that\n * package's own function read off its own module object. That is a DOORWAY,\n * not a shim: there is no second implementation, nothing is faked, and the\n * list cannot drift from the installed React because it is read from it. The\n * chunks are emitted with `preserveSignature: 'strict'` because Vite's app\n * build otherwise sets `preserveEntrySignatures: false` and mangles an entry's\n * export names away.\n *\n * ## Where the seam is drawn (measured, not assumed)\n *\n * {@link sharedReactPlugin}'s own doc comment carries the full rule and the\n * live failure that set it: the redirect covers the EDITOR TREE \u2014 the\n * contribution lane, the widget kit, and whatever project source they reach \u2014\n * and deliberately stops at the GAME, which mounts into its own isolated\n * `createRoot` tree with the project's own development React and a matching\n * development reconciler. Redirecting the game too was tried first and broke\n * Play mode outright.\n *\n * {@link sharedReactPlugin} is registered ONLY by `server/packaged.ts`.\n * `dev.ts` is untouched \u2014 it has one React already.\n */\nimport { existsSync, readFileSync } from 'node:fs';\nimport { createRequire } from 'node:module';\nimport path from 'node:path';\nimport { EDITOR_LANE_DIRS } from '@volter/editor-sdk/session/tool-contribution-convention';\nimport type { Plugin } from 'vite';\n\n/**\n * The published specifiers, and the rollup chunk NAME each appears under.\n *\n * The membership rule is one sentence: **a module belongs here when it CALLS\n * React hooks while rendering inside the editor's tree.** React itself is the\n * obvious case; a third-party component is the non-obvious one, and it fails\n * exactly as loudly \u2014 its `useState`/`useId` read a different dispatcher than\n * the tree reconciling it, which is \"Invalid hook call\" again with the\n * project's name nowhere in the stack.\n *\n * `@fortawesome/react-fontawesome` is here because it is the ONLY such module\n * `@volter/editor-sdk/widgets` reaches (measured: the kit's whole transitive bare-import\n * closure is `react`, `react-dom`, `@fortawesome/free-solid-svg-icons` \u2014 pure\n * path DATA, no React \u2014 and this). `SectionHeader` renders its\n * `DisclosureIcon` unconditionally, so before this entry existed every project\n * tool that used the kit's own section header crashed on the packaged path\n * while the tool's own hooks were being redirected correctly.\n *\n * `react-dom/server` is deliberately absent: nothing renders to a string in an\n * editor page, and an entry for it would drag React's server build into every\n * shell bundle.\n *\n * KNOWN REMAINING HOLE, same class: any OTHER bare dependency a contribution\n * renders calls its own prebundled React, and adding it here is not always the\n * answer. `@pixi/react` is the worked case and the reason this paragraph\n * exists \u2014 a doorway for it hands the editor's tree the SHELL's `@pixi/react`\n * and therefore the shell's `pixi.js`, while the contribution's own\n * `Texture`/`Assets` stay the project's: one renderer looking at another\n * renderer's textures, the same renderer-instance split that broke Play mode\n * when the game was redirected. The `sprite` capability's Sprite Lab took the\n * other exit instead \u2014 it drives plain `pixi.js` imperatively\n * (`sprite-lab/stage.ts`), because `pixi.js` calls no React hooks and so\n * crosses nothing. Reach for that shape first; a new line in this map is for a\n * dependency whose whole job IS rendering in the editor's tree.\n */\nexport const SHARED_REACT_ENTRIES = {\n  react: 'vgai-shared-react',\n  'react-dom': 'vgai-shared-react-dom',\n  'react-dom/client': 'vgai-shared-react-dom-client',\n  'react/jsx-runtime': 'vgai-shared-jsx-runtime',\n  'react/jsx-dev-runtime': 'vgai-shared-jsx-dev-runtime',\n  '@fortawesome/react-fontawesome': 'vgai-shared-fontawesome',\n\n} as const satisfies Record<string, string>;\n\nexport type SharedReactSpecifier = keyof typeof SHARED_REACT_ENTRIES;\n\n/** The specifiers this plugin owns \u2014 the same list `packaged.ts` keeps out of\n *  dependency prebundling, exported so the two can never drift apart. */\nexport const SHARED_REACT_SPECIFIERS = Object.keys(SHARED_REACT_ENTRIES) as SharedReactSpecifier[];\n\n/**\n * The emitted map, written beside the built shell. NOT `.vite/manifest.json`:\n * this file is read out of an INSTALLED tarball, and a dot-directory is one\n * more thing that has to survive `npm pack`.\n */\nexport const SHARED_REACT_MANIFEST_FILE = 'vgai-shared-react.json';\n\nexport interface SharedReactManifest {\n  /** Bare specifier \u2192 outDir-relative built chunk file (`assets/\u2026js`). */\n  files: Record<string, string>;\n}\n\nconst VIRTUAL_PREFIX = '\\0vgai-shared-react:';\n\n/**\n * The body of one entry: every export the installed package actually has, read\n * off that package's own module object.\n *\n * `__ns.default ?? __ns` covers both shapes this has to handle \u2014 a CommonJS\n * package (rollup's interop puts `module.exports` on `default`) and a real ES\n * module (the root Vite config aliases `react/jsx-dev-runtime` to\n * `src/jsx-dev-runtime-prod-shim.ts` for builds, because production React\n * stubs `jsxDEV` to `undefined`).\n */\nexport function sharedReactEntryModule(specifier: string, exportNames: readonly string[]): string {\n  const named = exportNames\n    .filter((name) => VALID_IDENTIFIER.test(name))\n    .map((name) => `export const ${name} = __m.${name};`);\n  return [\n    `import * as __ns from ${JSON.stringify(specifier)};`,\n    // Bracketed on purpose: `__ns.default` makes rollup warn that the ES-module\n    // shape (the jsx-dev-runtime shim) has no `default` export, which is the\n    // case this line exists to handle.\n    \"const __m = __ns['default'] ?? __ns;\",\n    'export default __m;',\n    ...named,\n    '',\n  ].join('\\n');\n}\n\nconst VALID_IDENTIFIER = /^[A-Za-z_$][A-Za-z0-9_$]*$/;\n\n/** The runtime export names of an installed package, resolved from `fromDir`. */\nexport function installedExportNames(fromDir: string, specifier: string): string[] {\n  const require_ = createRequire(path.join(fromDir, 'package.json'));\n  // biome-ignore lint/suspicious/noExplicitAny: reading an arbitrary package's runtime shape.\n  const loaded = require_(specifier) as Record<string, any>;\n  return Object.keys(loaded).filter((name) => name !== 'default');\n}\n\n/**\n * BUILD side: emit the five entry chunks and the manifest naming them.\n *\n * `fromDir` is the directory whose `node_modules` the React being published\n * comes from \u2014 the repo root for this build, which is the same React the shell\n * itself bundles.\n */\nexport function sharedReactBuildPlugin(fromDir: string): Plugin {\n  const referenceIds = new Map<SharedReactSpecifier, string>();\n  return {\n    name: 'vgai-shared-react-build',\n    apply: 'build',\n    buildStart() {\n      referenceIds.clear();\n      for (const specifier of SHARED_REACT_SPECIFIERS) {\n        referenceIds.set(\n          specifier,\n          this.emitFile({\n            type: 'chunk',\n            id: `${VIRTUAL_PREFIX}${specifier}`,\n            name: SHARED_REACT_ENTRIES[specifier],\n            // Vite's app build sets `preserveEntrySignatures: false`, which\n            // mangles an entry's export names away. Per-chunk `strict` is what\n            // keeps `useState` spelled `useState` in the emitted file \u2014 the\n            // whole point of publishing it.\n            preserveSignature: 'strict',\n          }),\n        );\n      }\n    },\n    resolveId(id) {\n      return id.startsWith(VIRTUAL_PREFIX) ? id : undefined;\n    },\n    load(id) {\n      if (!id.startsWith(VIRTUAL_PREFIX)) return undefined;\n      const specifier = id.slice(VIRTUAL_PREFIX.length);\n      return sharedReactEntryModule(specifier, installedExportNames(fromDir, specifier));\n    },\n    generateBundle() {\n      const files: Record<string, string> = {};\n      for (const [specifier, referenceId] of referenceIds) {\n        files[specifier] = this.getFileName(referenceId);\n      }\n      this.emitFile({\n        type: 'asset',\n        fileName: SHARED_REACT_MANIFEST_FILE,\n        source: `${JSON.stringify({ files } satisfies SharedReactManifest, null, 2)}\\n`,\n      });\n    },\n  };\n}\n\n/** The manifest a built `dist/` carries, or `null` when it predates this build\n *  step (an old tarball, or a checkout whose `dist/` was never rebuilt). */\nexport function readSharedReactManifest(distPath: string): SharedReactManifest | null {\n  const manifestPath = path.join(distPath, SHARED_REACT_MANIFEST_FILE);\n  if (!existsSync(manifestPath)) return null;\n  let manifest: SharedReactManifest;\n  try {\n    manifest = JSON.parse(readFileSync(manifestPath, 'utf8')) as SharedReactManifest;\n  } catch {\n    return null;\n  }\n  if (SHARED_REACT_SPECIFIERS.some((specifier) => !manifest.files?.[specifier])) return null;\n  return manifest;\n}\n\n/**\n * Specifier \u2192 URL, from a manifest. `base` is the built shell's own base (`/`\n * for the packaged build), so these URLs are byte-identical to the ones the\n * shell's bundle imports. That identity IS the fix: a differently-spelled URL\n * for the same file is a second React.\n */\nexport function sharedReactUrls(manifest: SharedReactManifest, base = '/'): Record<string, string> {\n  const prefix = base.endsWith('/') ? base : `${base}/`;\n  return Object.fromEntries(\n    SHARED_REACT_SPECIFIERS.map((specifier) => [\n      specifier,\n      `${prefix}${manifest.files[specifier]}`,\n    ]),\n  );\n}\n\n/**\n * The query that marks a module as part of the EDITOR TREE \u2014 the same\n * \"the query IS the scope\" device `vite-plugin-mount-isolation.ts` uses.\n * Queries survive `cleanUrl`, so every other plugin's `.tsx` scope test still\n * matches a marked module.\n */\nexport const EDITOR_TREE_QUERY = 'vgai-editor-react';\n\n/** A file inside a `@vgai/*` package's `contributions/` directory under any\n *  `node_modules` (a real install; in a checkout the package is a symlink\n *  whose realpath is its workspace directory, already `isOwnSource`). */\nconst PACKAGE_CONTRIBUTION_PATH = /[\\\\/]node_modules[\\\\/]@vgai[\\\\/][^\\\\/]+[\\\\/]contributions[\\\\/]/;\n\nfunction markEditorTree(id: string): string {\n  return id.includes(`?${EDITOR_TREE_QUERY}`) || id.includes(`&${EDITOR_TREE_QUERY}`)\n    ? id\n    : `${id}${id.includes('?') ? '&' : '?'}${EDITOR_TREE_QUERY}`;\n}\n\nfunction stripQuery(id: string): string {\n  const cut = id.indexOf('?');\n  return cut === -1 ? id : id.slice(0, cut);\n}\n\nfunction isUnder(file: string, directory: string): boolean {\n  return file === directory || file.startsWith(`${directory}${path.sep}`);\n}\n\nexport interface SharedReactScope {\n  /** Specifier \u2192 built chunk URL (see {@link sharedReactUrls}). */\n  urls: Record<string, string>;\n  /** The installed `@vgai/editor` package root \u2014 its `src/` is `@editor/*`. */\n  editorPackageRoot: string;\n  /** Every open project root, live (the same getter the sibling plugins take). */\n  projectRoots: () => Set<string>;\n}\n\n/**\n * SERVE side: point the EDITOR TREE's React specifiers at the shell's built\n * chunk URLs.\n *\n * ## Scope, and why it is not the whole graph\n *\n * The first version of this redirected React for every module this Vite\n * instance served. It fixed the contributions and BROKE Play mode, loudly and\n * measurably: `@react-three/fiber`'s prebundled `react-reconciler` is a\n * DEVELOPMENT build (Vite prebundles a dev server's deps with\n * `NODE_ENV=development`), and a dev reconciler against the shell's PRODUCTION\n * React reads internals that production React does not have \u2014 `TypeError:\n * Cannot read properties of undefined (reading 'push')` inside\n * `updateContainer`, \"The current testing environment is not configured to\n * support act(...)\", and finally `r3f-adapter: onCreated did not fire within\n * 10s`. The DEV/PROD boundary is real: the shell ships a production React and\n * the project's own graph is a development graph.\n *\n * So the seam is drawn where the RENDERING is: a module that renders inside\n * the editor's own React tree uses the editor's React; the game \u2014 mounted by\n * `createRoot` into its own isolated tree, with its own dev React and its own\n * dev reconciler, internally consistent \u2014 keeps the project's. That is the\n * same line `vite-plugin-module-doorways.ts` already draws for the mount\n * call, and it is why Play mode works today.\n *\n * ## How the scope is decided\n *\n * An importer is in the editor tree when it is:\n *  - a project's `src/contributions/**` or `src/tools/**` module (the editor\n *    lanes shared with the contribution loader),\n *  - a file under the installed editor package's own `src/` (what `@editor/*`\n *    aliases to \u2014 the widget kit contributions build their panels from), or\n *  - anything already MARKED, which is how the scope propagates.\n *\n * Propagation is what makes this cover the real graph rather than one folder:\n * `src/tools/data-tables.document.tsx` renders React components that live in\n * `src/lib/data-tables/`, and a contribution may reach any project module. So\n * when an editor-tree module imports another PROJECT-OWNED source file, the\n * resolved id is marked and its own imports inherit the scope. Bare\n * dependencies are deliberately NOT marked: they are prebundled, and a\n * prebundled chunk's React is decided at prebundle time, not here.\n * `@volter/editor-sdk/widgets` is the one dependency that must therefore be kept\n * OUT of `optimizeDeps` (`packaged.ts` excludes it) \u2014 it renders in the editor's tree\n * and has to be source-served for this scope to reach it.\n *\n * `enforce: 'pre'` so this runs ahead of Vite's own resolver and its alias\n * plugin. The returned React id is a root-relative URL, not a filesystem path:\n * Vite's import analysis leaves an id it cannot map into the project root as\n * the literal import URL, and the packaged server's `express.static(dist)`\n * answers it \u2014 so the browser fetches the same `/assets/\u2026` file the shell\n * already loaded.\n */\nexport function sharedReactPlugin({\n  urls,\n  editorPackageRoot,\n  projectRoots,\n}: SharedReactScope): Plugin {\n  const editorSrc = path.join(editorPackageRoot, 'src');\n  const layoutSdkSrc = path.resolve(editorPackageRoot, '../editor-sdk/src');\n  const inEditorTree = (importer: string | undefined): boolean => {\n    if (!importer) return false;\n    if (importer.includes(EDITOR_TREE_QUERY)) return true;\n    const file = stripQuery(importer);\n    if (isUnder(file, editorSrc) || isUnder(file, layoutSdkSrc)) return true;\n    // A skew PACKAGE's contribution (`node_modules/@vgai/<pkg>/contributions/`)\n    // renders in the editor's tree exactly as a project's own contribution\n    // does, so it takes the shell's React and SDK. Only the contributions\n    // directory: the same package's `src/` is also game runtime (a mesh\n    // component in a world), and a game keeps its own React.\n    if (PACKAGE_CONTRIBUTION_PATH.test(file)) return true;\n    for (const root of projectRoots()) {\n      if (file === path.join(root, 'vgai.adapter.ts')) return true;\n      if (EDITOR_LANE_DIRS.some((dir) => isUnder(file, path.join(root, dir)))) return true;\n    }\n    return false;\n  };\n  /** Project-owned source the scope propagates into \u2014 never a bare dep. */\n  const isOwnSource = (file: string): boolean => {\n    if (!path.isAbsolute(file)) return false;\n    if (isUnder(file, editorSrc) || isUnder(file, layoutSdkSrc)) return true;\n    if (file.includes(`${path.sep}node_modules${path.sep}`)) return false;\n    for (const root of projectRoots()) {\n      if (isUnder(file, root)) return true;\n    }\n    return false;\n  };\n\n  return {\n    name: 'vgai-shared-react',\n    enforce: 'pre',\n    async resolveId(source, importer, options) {\n      // Never during dependency SCANNING. The scanner records whatever an id\n      // resolves to as a file to prebundle, so handing it the shell's URL made\n      // the boot-time optimizer die on `ENOENT: open\n      // '/assets/vgai-shared-jsx-runtime-*.js'` \u2014 measured, on the first run\n      // after this scope existed. The redirect belongs to serving, where the\n      // browser is the thing fetching the URL.\n      // `scan` is Vite's own flag on the resolve options, not part of rollup's\n      // published type \u2014 hence the cast rather than a widened signature.\n      //\n      // The scan is not the only server-side pass that follows this redirect:\n      // import analysis PRE-TRANSFORMS every static import it rewrites, and a\n      // warmup for `/assets/vgai-shared-*.js` resolves against the project root\n      // and fails the same way (measured: 64 formatted `Pre-transform error`\n      // lines from one `*.inspector.tsx` request). Vite has no per-request\n      // opt-out there, so `packaged.ts` turns `server.preTransformRequests` off\n      // for its instance \u2014 see the comment on that option for why satisfying\n      // the warmup instead would pull the whole prebuilt SPA into the project's\n      // dev module graph.\n      if ((options as { scan?: boolean } | undefined)?.scan) return undefined;\n      if (!inEditorTree(importer)) return undefined;\n      const url = urls[source];\n      if (url) return url;\n      const resolved = await this.resolve(source, importer, { ...options, skipSelf: true });\n      if (!resolved || resolved.external) return resolved ?? undefined;\n      return isOwnSource(stripQuery(resolved.id))\n        ? { ...resolved, id: markEditorTree(resolved.id) }\n        : resolved;\n    },\n  };\n}\n", "/**\n * The tool-contribution FILENAME CONVENTION \u2014 the one definition for every\n * program that asks \"is this file a contribution module?\": the dev server's\n * scanner and `src/`-watcher classifier (`server/server-utils.ts`,\n * `server/project-tools.ts`), and the page-side readers that must reach the\n * same verdict about the same files. Lives in `src/` and names no DOM so the\n * server TypeScript program can import it \u2014 the same split\n * `game-globals-prelude.ts` documents for the globals prelude.\n */\n\n/**\n * The two editor-side folders of a project (ARCHITECTURE-CORE \u00A7The project\n * model): `src/contributions/` \u2014 what the project adds to the editor\n * (documents, inspectors, utilities, analytics, kinds, finders) \u2014 and\n * `src/tools/` \u2014 the tools a person or an agent invokes (`*.tool.ts`).\n * Neither is bundled at Play; both reload the editor, never the game.\n */\nexport const CONTRIBUTIONS_DIR = 'src/contributions';\nexport const TOOLS_DIR = 'src/tools';\nexport const EDITOR_LANE_DIRS = [CONTRIBUTIONS_DIR, TOOLS_DIR] as const;\n\n/** Whether a project-relative (or absolute, `/`-normalized) path sits in the editor's lane. */\nexport function isEditorLanePath(path: string): boolean {\n  const normalized = path.replaceAll('\\\\', '/');\n  return EDITOR_LANE_DIRS.some(\n    (dir) => normalized.startsWith(`${dir}/`) || normalized.includes(`/${dir}/`),\n  );\n}\n\nexport const TOOL_CONTRIBUTION_SUFFIXES = [\n  '.document',\n  '.inspector',\n  '.asset-inspector',\n  '.result',\n  '.utility',\n  '.analytics',\n  // A STATUS-BAR item (`workspace-status-registry.ts`): compact, passive,\n  // registered under `tool:<id>` like a utility tab.\n  '.status',\n  // A configuration KIND contribution (ARCHITECTURE-CORE \u00A7The project model);\n  // read by the hosts that load the manifest, never mounted as UI.\n  '.kind',\n  // A FINDER contribution \u2014 registered into the finder registry by the host\n  // that resolves the document table (the browser), never mounted as UI.\n  '.finder',\n  // The LOOK points (`@volter/editor-sdk/looks`): a workspace layout, a keymap\n  // and a style bundle are DATA \u2014 registered by the host, mounted by no UI\n  // point. What makes \"the Blender\" a build is a package contributing these.\n  '.layout',\n  '.keymap',\n  '.style',\n  // A COMMAND table (`@volter/editor-sdk/commands`): session verbs a package\n  // answers, registered with the host's relay; data, no UI.\n  '.command',\n  // The CHROME points (`@volter/editor-sdk/chrome`): palette actions and\n  // application-menu items; data the host renders in its own chrome.\n  '.action',\n  '.menu',\n  // A HEADER item: a component in the project header's transport cluster.\n  '.header',\n  // A SERVICE (`@volter/editor-sdk/services`): code a package runs while its\n  // contributions are loaded \u2014 started after a pass, stopped before the next.\n  '.service',\n] as const;\n\nconst TOOL_CONTRIBUTION_EXTENSIONS = ['.tsx', '.jsx', '.ts'] as const;\n\nexport type ChromeContributionKind = 'action' | 'menu' | 'header';\n\n/** Which chrome point a contribution file names, or null. */\nexport function chromeContributionKind(fileName: string): ChromeContributionKind | null {\n  for (const kind of ['action', 'menu', 'header'] as const)\n    if (TOOL_CONTRIBUTION_EXTENSIONS.some((extension) => fileName.endsWith(`.${kind}${extension}`)))\n      return kind;\n  return null;\n}\n\nexport function isServiceContribution(fileName: string): boolean {\n  return TOOL_CONTRIBUTION_EXTENSIONS.some((extension) =>\n    fileName.endsWith(`.service${extension}`),\n  );\n}\n\nexport function isCommandContribution(fileName: string): boolean {\n  return TOOL_CONTRIBUTION_EXTENSIONS.some((extension) =>\n    fileName.endsWith(`.command${extension}`),\n  );\n}\n\nexport type LookContributionKind = 'layout' | 'keymap' | 'style';\n\n/** Which look point a contribution file names, or null for a module of\n *  another kind. */\nexport function lookContributionKind(fileName: string): LookContributionKind | null {\n  for (const kind of ['layout', 'keymap', 'style'] as const)\n    if (TOOL_CONTRIBUTION_EXTENSIONS.some((extension) => fileName.endsWith(`.${kind}${extension}`)))\n      return kind;\n  return null;\n}\n\n/** A kind contribution: scanned with the rest, mounted by no UI point. */\n/** A finder contribution: registered by the document-table host, mounted by no UI point. */\nexport function isFinderContribution(fileName: string): boolean {\n  return TOOL_CONTRIBUTION_EXTENSIONS.some((extension) => fileName.endsWith(`.finder${extension}`));\n}\n\nexport function isConfigurationKindContribution(fileName: string): boolean {\n  return TOOL_CONTRIBUTION_EXTENSIONS.some((extension) => fileName.endsWith(`.kind${extension}`));\n}\n\n/** Whether one file name is a contribution module by the convention above. */\nexport function isToolContributionModule(fileName: string): boolean {\n  return TOOL_CONTRIBUTION_EXTENSIONS.some((extension) =>\n    TOOL_CONTRIBUTION_SUFFIXES.some((suffix) => fileName.endsWith(`${suffix}${extension}`)),\n  );\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/build/vite-plugin-product-contributions.js

@@ -0,0 +1,100 @@
+// vite-plugin-product-contributions.ts
+import { readFileSync } from "node:fs";
+import { createRequire } from "node:module";
+import { dirname, isAbsolute, join } from "node:path";
+import { pathToFileURL } from "node:url";
+var PRODUCT_CONTRIBUTIONS_PREFIX = "vgai:contributions/";
+function productContributionsModuleSource(packageName, declared) {
+  const rows = declared.map((entry) => {
+    const relative = entry.replace(/^\.\//, "");
+    const specifier = `${packageName}/${relative}`;
+    const importable = specifier.replace(/\.(tsx|ts|jsx|js)$/, "");
+    return `  { entryPath: ${JSON.stringify(specifier)}, load: () => import(${JSON.stringify(importable)}) },`;
+  });
+  return [
+    `// ${packageName}'s package.json#vgai.contributions, read at build time by`,
+    "// packages/editor/vite-plugin-product-contributions.ts.",
+    "export default [",
+    ...rows,
+    "];",
+    ""
+  ].join("\n");
+}
+function readDeclaredContributions(manifestPath, packageName) {
+  let manifest;
+  try {
+    manifest = JSON.parse(readFileSync(manifestPath, "utf8"));
+  } catch (error) {
+    throw new Error(
+      `${manifestPath} is not readable (${error instanceof Error ? error.message : String(error)}), so ${packageName}'s contributions cannot be composed into this product.`
+    );
+  }
+  const declared = manifest.vgai?.contributions;
+  if (declared === void 0)
+    throw new Error(
+      `${packageName} declares no package.json#vgai.contributions, so there is nothing for a product to mount from it. A package that contributes declares its modules there; a package that only exports code is imported by name instead.`
+    );
+  if (!Array.isArray(declared) || declared.some((entry) => typeof entry !== "string"))
+    throw new Error(
+      `${packageName}'s package.json#vgai.contributions must be an array of ./-relative modules.`
+    );
+  return declared;
+}
+function locateManifest(packageName, importer) {
+  const from = importer && isAbsolute(importer) ? importer : join(process.cwd(), "index.js");
+  const require2 = createRequire(pathToFileURL(from));
+  try {
+    return require2.resolve(`${packageName}/package.json`);
+  } catch {
+    const resolvedFrom = createRequire(pathToFileURL(from));
+    const found = resolvedFrom.resolve(packageName);
+    let dir = dirname(found);
+    for (; ; ) {
+      const candidate = join(dir, "package.json");
+      try {
+        if (JSON.parse(readFileSync(candidate, "utf8")).name === packageName) return candidate;
+      } catch {
+      }
+      const parent = dirname(dir);
+      if (parent === dir)
+        throw new Error(
+          `${packageName} is not installed where ${from} can resolve it, so this product cannot mount its contributions. Declare it as a dependency of the product package.`
+        );
+      dir = parent;
+    }
+  }
+}
+function productContributionsPlugin() {
+  const manifests = /* @__PURE__ */ new Map();
+  return {
+    name: "vgai-product-contributions",
+    resolveId(id, importer) {
+      if (!id.startsWith(PRODUCT_CONTRIBUTIONS_PREFIX)) return null;
+      const packageName = id.slice(PRODUCT_CONTRIBUTIONS_PREFIX.length);
+      if (packageName === "")
+        throw new Error(
+          `"${id}" names no package \u2014 the form is \`${PRODUCT_CONTRIBUTIONS_PREFIX}<package>\`.`
+        );
+      const virtual = `\0${id}`;
+      manifests.set(virtual, locateManifest(packageName, importer));
+      return virtual;
+    },
+    load(id) {
+      const manifestPath = manifests.get(id);
+      if (manifestPath === void 0) return null;
+      const packageName = id.slice(`\0${PRODUCT_CONTRIBUTIONS_PREFIX}`.length);
+      this.addWatchFile(manifestPath);
+      return productContributionsModuleSource(
+        packageName,
+        readDeclaredContributions(manifestPath, packageName)
+      );
+    }
+  };
+}
+export {
+  PRODUCT_CONTRIBUTIONS_PREFIX,
+  productContributionsModuleSource,
+  productContributionsPlugin,
+  readDeclaredContributions
+};
+//# sourceMappingURL=vite-plugin-product-contributions.js.map

package/dist/build/vite-plugin-product-contributions.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../vite-plugin-product-contributions.ts"],
+  "sourcesContent": ["/**\n * `vgai:contributions/<package>` \u2014 a package's DECLARED contributions, read at\n * build/serve time and served as a module of static `import()`s.\n *\n * A PRODUCT is code (ARCHITECTURE-CORE \u00A7The target shape, rule 8: \"Compositions\n * are code; the frame's and the loader's manifests are declarations and stay\").\n * `packages/game-editor/src/index.ts` and `packages/model-editor/src/index.ts`\n * name the packages they mount, in TypeScript, and each name is spelled as an\n * import of this virtual module:\n *\n *   import blender from 'vgai:contributions/@vgai/blender';\n *\n * whose body this plugin synthesizes from that package's own\n * `package.json#vgai.contributions`:\n *\n *   export default [\n *     { entryPath: '@vgai/blender/contributions/blender.command.ts',\n *       load: () => import('@vgai/blender/contributions/blender.command') },\n *     \u2026\n *   ];\n *\n * The declaration is the ONE source. Nothing is committed that a script\n * generates, and a package that grows a contribution grows every product that\n * names it with no second edit anywhere \u2014 which is the defect the generated\n * table (`builds.generated.ts`, 529 committed lines derived from `builds/*.json`)\n * existed to remove and then re-introduced from the other side: the table was\n * committed, so it went stale, and a pre-commit check had to exist to notice.\n *\n * WHY A PLUGIN AND NOT `import.meta.glob`. A glob is a path pattern over THIS\n * package's tree; what a product mounts is another package's own list, and a\n * package's contributions live behind its export map, not at a path a consumer\n * may guess. So the plugin reads the manifest the loader already reads\n * (`server/project-tools.ts`'s `packageContributionModules` reads the same key\n * for a PROJECT's declared packages) and emits the same `{ entryPath, load }`\n * shape `tool-loader.ts` consumes. `vite-plugin-module-doorways.ts` is the\n * precedent for the mechanism: `resolveId` maps a private id, `load` answers\n * with a literal module body of static statements, and every specifier in it\n * goes through the serving instance's own resolver.\n *\n * THE `entryPath` IS THE PACKAGE SPECIFIER, with its extension, because that is\n * what the SESSION reports for the same module (`project-tools.ts` records a\n * package's contribution by the manifest's own `./contributions/x.ts` spelling)\n * and `tool-loader.ts` dedupes a package the product bundles against one the\n * open project declares BY THAT STRING. The `load` import drops the extension\n * for the same reason the old generator did: `@vgai/x/contributions/*` is an\n * export-map wildcard, and the bundler resolves the extension.\n *\n * WHERE THE MANIFEST IS FOUND. From the IMPORTER \u2014 the product module doing the\n * importing \u2014 through Node resolution of `<name>/package.json`, so the product\n * reads the package its own install resolves. `resolveId` is the only hook with\n * an importer, so it resolves the manifest and remembers it for `load`.\n */\n\nimport { readFileSync } from 'node:fs';\nimport { createRequire } from 'node:module';\nimport { dirname, isAbsolute, join } from 'node:path';\nimport { pathToFileURL } from 'node:url';\nimport type { Plugin } from 'vite';\n\n/** The specifier prefix a product writes. Part of the kit's public surface: a\n *  product package's source contains this string and nothing else about how a\n *  contribution is found. */\nexport const PRODUCT_CONTRIBUTIONS_PREFIX = 'vgai:contributions/';\n\n/** One contribution a product bundles: the package specifier `tool-loader.ts`\n *  records as the module's `file`, and the lazy import the bundler follows. */\nexport interface BundledContribution {\n  readonly entryPath: string;\n  readonly load: () => Promise<unknown>;\n}\n\n/** The module text served for one package's declared contributions. Exported so\n *  the closure meter can read the same list this serves without re-deriving the\n *  rule (`scripts/validate-editor-closure.mjs`). */\nexport function productContributionsModuleSource(\n  packageName: string,\n  declared: readonly string[],\n): string {\n  const rows = declared.map((entry) => {\n    const relative = entry.replace(/^\\.\\//, '');\n    const specifier = `${packageName}/${relative}`;\n    const importable = specifier.replace(/\\.(tsx|ts|jsx|js)$/, '');\n    return (\n      `  { entryPath: ${JSON.stringify(specifier)}, ` +\n      `load: () => import(${JSON.stringify(importable)}) },`\n    );\n  });\n  return [\n    `// ${packageName}'s package.json#vgai.contributions, read at build time by`,\n    '// packages/editor/vite-plugin-product-contributions.ts.',\n    'export default [',\n    ...rows,\n    '];',\n    '',\n  ].join('\\n');\n}\n\n/** A package's declared contribution modules, or a throw naming the package. */\nexport function readDeclaredContributions(manifestPath: string, packageName: string): string[] {\n  let manifest: { vgai?: { contributions?: unknown } };\n  try {\n    manifest = JSON.parse(readFileSync(manifestPath, 'utf8')) as typeof manifest;\n  } catch (error) {\n    throw new Error(\n      `${manifestPath} is not readable (${error instanceof Error ? error.message : String(error)}), ` +\n        `so ${packageName}'s contributions cannot be composed into this product.`,\n    );\n  }\n  const declared = manifest.vgai?.contributions;\n  if (declared === undefined)\n    throw new Error(\n      `${packageName} declares no package.json#vgai.contributions, so there is nothing for a ` +\n        'product to mount from it. A package that contributes declares its modules there; a ' +\n        'package that only exports code is imported by name instead.',\n    );\n  if (!Array.isArray(declared) || declared.some((entry) => typeof entry !== 'string'))\n    throw new Error(\n      `${packageName}'s package.json#vgai.contributions must be an array of ./-relative modules.`,\n    );\n  return declared as string[];\n}\n\n/**\n * Resolve `<name>/package.json` from the importing module's own directory.\n *\n * `createRequire` walks `node_modules` upward exactly as the runtime does, so a\n * product resolves the package version its own install carries \u2014 and in this\n * workspace that is the checkout's symlink, which is the same file the estate\n * scan reads.\n */\nfunction locateManifest(packageName: string, importer: string | undefined): string {\n  const from = importer && isAbsolute(importer) ? importer : join(process.cwd(), 'index.js');\n  const require = createRequire(pathToFileURL(from));\n  try {\n    return require.resolve(`${packageName}/package.json`);\n  } catch {\n    // An export map without a `./package.json` entry: fall back to the package\n    // directory Node resolves for the bare name's own files.\n    const resolvedFrom = createRequire(pathToFileURL(from));\n    const found = resolvedFrom.resolve(packageName);\n    let dir = dirname(found);\n    for (;;) {\n      const candidate = join(dir, 'package.json');\n      try {\n        if (JSON.parse(readFileSync(candidate, 'utf8')).name === packageName) return candidate;\n      } catch {\n        /* keep walking */\n      }\n      const parent = dirname(dir);\n      if (parent === dir)\n        throw new Error(\n          `${packageName} is not installed where ${from} can resolve it, so this product cannot ` +\n            'mount its contributions. Declare it as a dependency of the product package.',\n        );\n      dir = parent;\n    }\n  }\n}\n\n/**\n * The ONE plugin serving every `vgai:contributions/<package>` a product names.\n *\n * Registered on the repo-root `vite.config.ts` \u2014 which is both the product\n * BUILD's config and the dev session's `configFile`\n * (`packages/editor/server/dev.ts`), so one registration answers both hosts.\n * The PACKAGED host's project-rooted instance never sees a product module (the\n * product is a built chunk there), so it registers nothing.\n */\nexport function productContributionsPlugin(): Plugin {\n  const manifests = new Map<string, string>();\n  return {\n    name: 'vgai-product-contributions',\n    resolveId(id, importer) {\n      if (!id.startsWith(PRODUCT_CONTRIBUTIONS_PREFIX)) return null;\n      const packageName = id.slice(PRODUCT_CONTRIBUTIONS_PREFIX.length);\n      if (packageName === '')\n        throw new Error(\n          `\"${id}\" names no package \u2014 the form is \\`${PRODUCT_CONTRIBUTIONS_PREFIX}<package>\\`.`,\n        );\n      const virtual = `\\0${id}`;\n      manifests.set(virtual, locateManifest(packageName, importer));\n      return virtual;\n    },\n    load(id) {\n      const manifestPath = manifests.get(id);\n      if (manifestPath === undefined) return null;\n      const packageName = id.slice(`\\0${PRODUCT_CONTRIBUTIONS_PREFIX}`.length);\n      // Watched, so a package that grows a contribution refreshes the product\n      // in a live session instead of waiting for a restart.\n      this.addWatchFile(manifestPath);\n      return productContributionsModuleSource(\n        packageName,\n        readDeclaredContributions(manifestPath, packageName),\n      );\n    },\n  };\n}\n"],
+  "mappings": "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",
+  "names": ["require"]
+}