@volter/editor-react 0.5.201 → 0.5.203

package/contributions/component-contracts.service.ts

@@ -1,11 +1,11 @@
 /**
  * The component-contract analyzer, registered for the browser (a `workspace.service`
  * contribution): what the kit's Content index reads when it indexes a project from storage,
- * with no session server to ask (`@volter/editor-sdk/source-analysis`). The session's server
+ * with no session server to ask (`@volter/sdk/source-analysis`). The session's server
  * registers the same analyzer through this package's `volter.serving` module.
  */
 
-import { registerComponentContractAnalyzer } from '@volter/editor-sdk/source-analysis';
+import { registerComponentContractAnalyzer } from '@volter/sdk/source-analysis';
 import { analyzeR3fComponentContracts, builtinR3fContractsForSource } from '../src/source/oid-transform';
 
 export const point = 'workspace.service';

package/dist-node/serving.mjs

@@ -3510,6 +3510,7 @@ function r3fAuthoringDiagnostics(code, file, opts) {
 
 // serving/ui-oid-plugin.ts
 import { createHash } from "node:crypto";
+import { createRequire } from "node:module";
 import {
   existsSync as existsSync3,
   mkdirSync,
@@ -3520,11 +3521,11 @@ import {
 import { basename, dirname as dirname2, isAbsolute, join as join2, relative, resolve as resolve2, sep } from "node:path";
 import { Worker } from "node:worker_threads";
 
-// ../editor-project/src/manifest/locate.ts
+// ../project/src/manifest/locate.ts
 import { existsSync as existsSync2 } from "node:fs";
 import { join } from "node:path";
 
-// ../editor-project/src/manifest/filename.ts
+// ../project/src/manifest/filename.ts
 var MANIFEST_FILENAME = "volter.project.json";
 var REMOVED_MANIFEST_FILENAME = "volter.game.json";
 function removedManifestFilenameMessage(where) {
@@ -3532,7 +3533,7 @@ function removedManifestFilenameMessage(where) {
 Fix: rename it \u2014 \`git mv ${REMOVED_MANIFEST_FILENAME} ${MANIFEST_FILENAME}\`. The contents are unchanged; only the filename moved.`;
 }
 
-// ../editor-project/src/manifest/locate.ts
+// ../project/src/manifest/locate.ts
 function assertNoRemovedManifestFilename(dir) {
   if (existsSync2(join(dir, MANIFEST_FILENAME))) return;
   if (!existsSync2(join(dir, REMOVED_MANIFEST_FILENAME))) return;
@@ -3543,10 +3544,10 @@ function resolveManifestPath(dir) {
   return join(dir, MANIFEST_FILENAME);
 }
 
-// ../editor-sdk/src/session/project-serving.ts
+// ../sdk/src/session/project-serving.ts
 var SOURCE_WRITE_ROUTES_PLUGIN = "volter-ui-oid";
 
-// ../editor-sdk/src/css-numeric-style.ts
+// ../sdk/src/css-numeric-style.ts
 var UNITLESS_NUMBER_PROPS = /* @__PURE__ */ new Set([
   "opacity",
   "zIndex",
@@ -5048,7 +5049,22 @@ function fileDiagnosticJoin(fileEntries, fileDiagnostics) {
 
 // serving/ui-oid-plugin.ts
 var NODE_MODULES_RE = /\/node_modules\//;
-var TOOLING_SRC_RE = /\/packages\/(engine\/src|create-volter-project|volter-cli|editor-sdk)\//;
+var TOOLING_SRC_RE = /\/packages\/(engine\/src|create-volter-project|volter-cli)\//;
+var SDK_ROOT = (() => {
+  try {
+    const entry = realpathSync(createRequire(import.meta.url).resolve("@volter/sdk"));
+    return `${dirname2(dirname2(entry)).replace(/\\/g, "/")}/`;
+  } catch (error) {
+    console.warn(
+      `[volter] @volter/sdk does not resolve from ${import.meta.url} (${error instanceof Error ? error.message : String(error)}); the SDK's source folder is not excluded from UI source stamping.`
+    );
+    return null;
+  }
+})();
+var foldCase = (file) => process.platform === "win32" ? file.toLowerCase() : file;
+function isToolingSource(clean) {
+  return TOOLING_SRC_RE.test(clean) || SDK_ROOT !== null && foldCase(clean).startsWith(foldCase(SDK_ROOT));
+}
 var EDITOR_SRC_RE = /\/packages\/editor\/src\//;
 var EDITABLE_COMPONENTS_RE = /\/ui-editor\/editable-components\/.*\.tsx$/;
 var VENDOR_RE = /\/vendor\//;
@@ -5094,7 +5110,7 @@ function isEditableCssFile(id) {
   if (!clean.endsWith(".css")) return false;
   if (NODE_MODULES_RE.test(clean)) return false;
   if (VENDOR_RE.test(clean)) return false;
-  if (TOOLING_SRC_RE.test(clean)) return false;
+  if (isToolingSource(clean)) return false;
   if (EDITOR_SRC_RE.test(clean)) return false;
   return true;
 }
@@ -5353,7 +5369,7 @@ function defaultProjectScopeInclude(id) {
   if (!clean.endsWith(".tsx")) return false;
   if (NODE_MODULES_RE.test(clean)) return false;
   if (VENDOR_RE.test(clean) && !VENDORED_GAME_SRC_RE.test(clean)) return false;
-  if (TOOLING_SRC_RE.test(clean)) return false;
+  if (isToolingSource(clean)) return false;
   if (EDITOR_SRC_RE.test(clean) && !EDITABLE_COMPONENTS_RE.test(clean)) return false;
   if (nearestManifestExcludesIngestReact(dirname2(clean))) return false;
   return true;

package/package.json

@@ -2,7 +2,7 @@
   "name": "@volter/editor-react",
   "author": "Volter AI, Inc.",
   "license": "AGPL-3.0-only",
-  "version": "0.5.201",
+  "version": "0.5.203",
   "publishConfig": {
     "access": "public"
   },
@@ -38,8 +38,8 @@
     "serving": "./dist-node/serving.mjs"
   },
   "dependencies": {
-    "@volter/editor-sdk": "0.5.201",
-    "@volter/editor-project": "0.5.201",
+    "@volter/sdk": "0.5.203",
+    "@volter/project": "0.5.203",
     "typescript": "5.9.3"
   },
   "peerDependencies": {

package/serving/component-prop-worker.ts

@@ -19,7 +19,7 @@
  */
 import { parentPort } from 'node:worker_threads';
 import { ComponentPropResolver } from '../src/source/component-prop-types';
-import type { ComponentPropSpec } from '@volter/editor-sdk/source-authoring';
+import type { ComponentPropSpec } from '@volter/sdk/source-authoring';
 
 interface PropRequest {
   key: string;

package/serving/index.ts

@@ -1,11 +1,11 @@
 /**
  * `@volter/editor-react`'s server half (`package.json#volter.serving`, the project-serving door in
- * `@volter/editor-sdk/session/project-serving`): the JSX identity stamp and the `/__ui-source/*`
+ * `@volter/sdk/session/project-serving`): the JSX identity stamp and the `/__ui-source/*`
  * authoring routes over a project's React and React Three Fiber source, and the source answers
  * the kit's region decision, validation and Content index ask of a JSX lane.
  */
 
-import type { ProjectServingModule } from '@volter/editor-sdk/session/project-serving';
+import type { ProjectServingModule } from '@volter/sdk/session/project-serving';
 import { analyzeR3fComponentContracts, builtinR3fContractsForSource, sourceDialectEvidence } from '../src/source/oid-transform';
 import { r3fAuthoringDiagnostics } from '../src/source/r3f-project-contracts';
 import { uiOidPlugin } from './ui-oid-plugin';

package/serving/ui-oid-plugin.ts

@@ -21,7 +21,7 @@
  * `defaultProjectScopeInclude` widens to PROJECT scope, not repo-global: any `.tsx`
  * file outside `node_modules`, EXCEPT the Volter tooling/engine source trees this repo
  * itself is built from (`packages/engine/src`, `packages/create-volter-project`,
- * `packages/volter-cli`, `packages/editor-sdk`, and `packages/editor/src` generally —
+ * `packages/volter-cli`, `packages/sdk`, and `packages/editor/src` generally —
  * carving OUT `ui-editor/editable-components` so the existing UI-edit-mode surface
  * keeps working unchanged). This does NOT depend on which project happens to be
  * open — `fs.allow` already bounds what Vite can even reach, and this predicate
@@ -71,6 +71,7 @@
  */
 
 import { createHash } from 'node:crypto';
+import { createRequire } from 'node:module';
 import {
   existsSync,
   mkdirSync,
@@ -81,12 +82,12 @@ import {
 import { basename, dirname, isAbsolute, join, relative, resolve, sep } from 'node:path';
 import { Worker } from 'node:worker_threads';
 import type { Plugin, ViteDevServer } from 'vite';
-import { resolveManifestPath } from '@volter/editor-project/manifest/locate';
+import { resolveManifestPath } from '@volter/project/manifest/locate';
 import {
   type ProjectServingServices,
   SOURCE_WRITE_ROUTES_PLUGIN,
-} from '@volter/editor-sdk/session/project-serving';
-import { cssTextForStyleValue } from '@volter/editor-sdk/css-numeric-style';
+} from '@volter/sdk/session/project-serving';
+import { cssTextForStyleValue } from '@volter/sdk/css-numeric-style';
 import {
   type ComponentPropSpec,
   lineColToOffset,
@@ -146,7 +147,30 @@ import {
 export { applyStyleWriteRequest, oidAttributeForSurface };
 
 const NODE_MODULES_RE = /\/node_modules\//;
-const TOOLING_SRC_RE = /\/packages\/(engine\/src|create-volter-project|volter-cli|editor-sdk)\//;
+const TOOLING_SRC_RE = /\/packages\/(engine\/src|create-volter-project|volter-cli)\//;
+/** The SDK's own folder, where a workspace keeps its source: tooling, never a game's UI. Named by
+ *  where `@volter/sdk` resolves from here (its entry module is `src/index.ts`), with forward
+ *  slashes; `null` when it does not resolve. A project's own `packages/sdk` is not this folder. */
+const SDK_ROOT = ((): string | null => {
+  try {
+    const entry = realpathSync(createRequire(import.meta.url).resolve('@volter/sdk'));
+    return `${dirname(dirname(entry)).replace(/\\/g, '/')}/`;
+  } catch (error) {
+    // Said once, when this module loads: without the folder, the SDK's own source in a workspace is
+    // not told apart from a game's and would be stamped as editable UI.
+    console.warn(
+      `[volter] @volter/sdk does not resolve from ${import.meta.url} (${error instanceof Error ? error.message : String(error)}); ` +
+        "the SDK's source folder is not excluded from UI source stamping.",
+    );
+    return null;
+  }
+})();
+/** Windows names one file with either case of its drive letter and folders. */
+const foldCase = (file: string): string => (process.platform === 'win32' ? file.toLowerCase() : file);
+/** `clean` is a file with forward slashes. */
+function isToolingSource(clean: string): boolean {
+  return TOOLING_SRC_RE.test(clean) || (SDK_ROOT !== null && foldCase(clean).startsWith(foldCase(SDK_ROOT)));
+}
 const EDITOR_SRC_RE = /\/packages\/editor\/src\//;
 const EDITABLE_COMPONENTS_RE = /\/ui-editor\/editable-components\/.*\.tsx$/;
 /** Track N, D-N4 item 2 — see the module doc comment's "Vendored-tree exclusion". */
@@ -176,7 +200,7 @@ const VENDORED_GAME_SRC_RE = /\/vendor\/games\/[^/]+\//;
  *  Defensive against
  *  any shape (never trusts the manifest is even an object) — this is a
  *  best-effort identity probe for a WRITE-BACK BAN, not manifest validation
- *  (the real Zod schema/loader is `@volter/editor-project/manifest/load`, not reachable
+ *  (the real Zod schema/loader is `@volter/project/manifest/load`, not reachable
  *  from this vite-config-time, dependency-light file by design). */
 function manifestDeclaresIngestReactWorld(parsed: unknown): boolean {
   if (!parsed || typeof parsed !== 'object') return false;
@@ -246,7 +270,7 @@ export function isEditableCssFile(id: string): boolean {
   if (!clean.endsWith('.css')) return false;
   if (NODE_MODULES_RE.test(clean)) return false;
   if (VENDOR_RE.test(clean)) return false;
-  if (TOOLING_SRC_RE.test(clean)) return false;
+  if (isToolingSource(clean)) return false;
   if (EDITOR_SRC_RE.test(clean)) return false;
   return true;
 }
@@ -693,7 +717,7 @@ export function __oidIndexEnrichStateForTest(): { queued: boolean; hasEnriched:
  * stops matching its lock.
  */
 /** The kit's server capabilities this plugin was constructed with
- *  (`@volter/editor-sdk/session/project-serving`). */
+ *  (`@volter/sdk/session/project-serving`). */
 let servingServices: ProjectServingServices | null = null;
 
 function serving(): ProjectServingServices {
@@ -738,7 +762,7 @@ export function defaultProjectScopeInclude(id: string): boolean {
   // inspector; refusing it here is what used to make a vendored game
   // permanently unauthorable.
   if (VENDOR_RE.test(clean) && !VENDORED_GAME_SRC_RE.test(clean)) return false;
-  if (TOOLING_SRC_RE.test(clean)) return false;
+  if (isToolingSource(clean)) return false;
   if (EDITOR_SRC_RE.test(clean) && !EDITABLE_COMPONENTS_RE.test(clean)) return false;
   if (nearestManifestExcludesIngestReact(dirname(clean))) return false;
   return true;
@@ -1566,7 +1590,7 @@ export function uiOidPlugin(
       // W1 — R3F-dialect files get ` userData-oid` (fiber pierces it into
       // `object.userData.oid`); react-dom files keep ` data-oid` unchanged.
       // WHICH REGION owns this exact file decides: a declaration the project
-      // made (an `include` glob or a `mounts` entry in `volter.adapter.ts`), the
+      // made (an `include` glob or a `mounts` entry in `editor/volter.adapter.ts`), the
       // manifest root whose `entry` it is, or reach from one through the live
       // import graph. Nothing is inferred from the file's own bytes; a file
       // nothing places gets the documented `data-oid` default, said out loud.

package/src/source/component-prop-types.ts

@@ -42,7 +42,7 @@
 import { statSync } from 'node:fs';
 import { dirname, resolve } from 'node:path';
 import ts from 'typescript';
-import type { ComponentPropSpec } from '@volter/editor-sdk/source-authoring';
+import type { ComponentPropSpec } from '@volter/sdk/source-authoring';
 
 export type { ComponentPropSpec };
 

package/src/source/oid-transform.ts

@@ -23,8 +23,8 @@ import { particleBindingsByElement, type R3fParticleBinding } from './r3f-partic
 import { physicsBindingsByElement, type R3fPhysicsBinding } from './r3f-physics-binding';
 import { parseAuthoringTsx, refIdentifier } from './ts-ast';
 
-import type { DeclaredRootSurface, OidEntry, R3fComponentContract, R3fTransformProp, SourceDialectEvidence } from '@volter/editor-sdk/source-authoring';
-export type { ComponentPropSpec, DeclaredRootSurface, OidEntry, R3fAuthoringDiagnostic, R3fComponentContract, R3fTransformProp, SourceDialectEvidence } from '@volter/editor-sdk/source-authoring';
+import type { DeclaredRootSurface, OidEntry, R3fComponentContract, R3fTransformProp, SourceDialectEvidence } from '@volter/sdk/source-authoring';
+export type { ComponentPropSpec, DeclaredRootSurface, OidEntry, R3fAuthoringDiagnostic, R3fComponentContract, R3fTransformProp, SourceDialectEvidence } from '@volter/sdk/source-authoring';
 
 export type {
   R3fEnvironmentBinding,
@@ -1075,7 +1075,7 @@ export function sourceProvesR3f(evidence: SourceDialectEvidence): boolean {
  *    for a file it could not place, silently, and being wrong that way is
  *    indistinguishable from being right. Zero inference (ARCHITECTURE-CORE
  *    §The editor protocol) makes the fix a declaration — an `include` glob or
- *    a `mounts` entry in `volter.adapter.ts` — not a better heuristic.
+ *    a `mounts` entry in `editor/volter.adapter.ts` — not a better heuristic.
  *
  * Nothing about a file's own bytes outranks the region — not even a file that
  * renders THREE host elements while its region says `dom`. That disagreement is

package/src/source/r3f-environment-binding.ts

@@ -10,8 +10,8 @@
 import ts from 'typescript';
 import { jsxAttribute, numericLiteral } from './ts-ast';
 
-import type { R3fEnvironmentBinding, R3fEnvironmentNumberBinding, R3fEnvironmentStringBinding } from '@volter/editor-sdk/source-authoring';
-export type { R3fEnvironmentBinding, R3fEnvironmentNumberBinding, R3fEnvironmentStringBinding } from '@volter/editor-sdk/source-authoring';
+import type { R3fEnvironmentBinding, R3fEnvironmentNumberBinding, R3fEnvironmentStringBinding } from '@volter/sdk/source-authoring';
+export type { R3fEnvironmentBinding, R3fEnvironmentNumberBinding, R3fEnvironmentStringBinding } from '@volter/sdk/source-authoring';
 
 function attributeString(attribute: ts.JsxAttribute | undefined): string | undefined {
   const initializer = attribute?.initializer;

package/src/source/r3f-joint-binding.ts

@@ -12,8 +12,8 @@
 import ts from 'typescript';
 import { enclosingScope, numericLiteral, refIdentifier } from './ts-ast';
 
-import type { R3fJointBinding, R3fJointHook, R3fJointLiteral, R3fJointLiteralRange } from '@volter/editor-sdk/source-authoring';
-export type { R3fJointBinding, R3fJointHook, R3fJointLiteral, R3fJointLiteralRange } from '@volter/editor-sdk/source-authoring';
+import type { R3fJointBinding, R3fJointHook, R3fJointLiteral, R3fJointLiteralRange } from '@volter/sdk/source-authoring';
+export type { R3fJointBinding, R3fJointHook, R3fJointLiteral, R3fJointLiteralRange } from '@volter/sdk/source-authoring';
 
 const JOINT_HOOKS = new Set<R3fJointHook>([
   'useFixedJoint',

package/src/source/r3f-lod-binding.ts

@@ -3,8 +3,8 @@
 import ts from 'typescript';
 import { jsxAttribute, numericLiteral } from './ts-ast';
 
-import type { R3fLodBinding, R3fLodNumberBinding } from '@volter/editor-sdk/source-authoring';
-export type { R3fLodBinding, R3fLodNumberBinding } from '@volter/editor-sdk/source-authoring';
+import type { R3fLodBinding, R3fLodNumberBinding } from '@volter/sdk/source-authoring';
+export type { R3fLodBinding, R3fLodNumberBinding } from '@volter/sdk/source-authoring';
 
 function detailedNames(sf: ts.SourceFile): Set<string> {
   const names = new Set<string>();

package/src/source/r3f-particle-binding.ts

@@ -3,8 +3,8 @@
 import ts from 'typescript';
 import { enclosingScope, numericLiteral } from './ts-ast';
 
-import type { QuarksEmitterShape, R3fParticleBinding, R3fParticleNumberBinding } from '@volter/editor-sdk/source-authoring';
-export type { QuarksEmitterShape, R3fParticleBinding, R3fParticleNumberBinding } from '@volter/editor-sdk/source-authoring';
+import type { QuarksEmitterShape, R3fParticleBinding, R3fParticleNumberBinding } from '@volter/sdk/source-authoring';
+export type { QuarksEmitterShape, R3fParticleBinding, R3fParticleNumberBinding } from '@volter/sdk/source-authoring';
 
 const SHAPES: Record<string, QuarksEmitterShape> = {
   PointEmitter: 'point',

package/src/source/r3f-physics-binding.ts

@@ -63,8 +63,8 @@
 import ts from 'typescript';
 import { enclosingScope, refIdentifier } from './ts-ast';
 
-import type { PhysicsChannel, R3fPhysicsBinding } from '@volter/editor-sdk/source-authoring';
-export type { PhysicsChannel, R3fPhysicsBinding } from '@volter/editor-sdk/source-authoring';
+import type { PhysicsChannel, R3fPhysicsBinding } from '@volter/sdk/source-authoring';
+export type { PhysicsChannel, R3fPhysicsBinding } from '@volter/sdk/source-authoring';
 
 /** What an element carrying a binding looks like to a writer. Structural rather
  *  than the whole `OidEntry`, so this stays the browser-safe half. */
@@ -81,7 +81,7 @@ export interface PhysicsBoundElement {
 /**
  * Is this element's `channel` PLACED BY A SIMULATED BODY — the fact that makes
  * an edit here a `physics-binding` write rather than an ordinary `source-prop`
- * one, in `WriteAnchorKind`'s vocabulary (`@volter/editor-project/adapter`'s `authoring.ts`).
+ * one, in `WriteAnchorKind`'s vocabulary (`@volter/project/adapter`'s `authoring.ts`).
  *
  * Two shapes, and both are the same question ("does a body read this value?")
  * asked of the two places a body can be attached, which is why they answer from

package/src/source/reparent-guard.ts

@@ -44,8 +44,8 @@ import {
   writePropChange,
 } from './writer';
 
-import type { ReparentChannel, ReparentRebase } from '@volter/editor-sdk/source-authoring';
-export type { ReparentChannel, ReparentRebase } from '@volter/editor-sdk/source-authoring';
+import type { ReparentChannel, ReparentRebase } from '@volter/sdk/source-authoring';
+export type { ReparentChannel, ReparentRebase } from '@volter/sdk/source-authoring';
 
 const CHANNELS: readonly ReparentChannel[] = ['position', 'rotation', 'scale'];
 const NUMBER_RE = /^-?\d+(\.\d+)?$/;

package/src/source/source-edit-request.ts

@@ -19,4 +19,4 @@
  * it is read by both.
  */
 
-export type { PreparedSourceEdit, SourceEditRequest, StructReparentContext } from '@volter/editor-sdk/source-authoring';
+export type { PreparedSourceEdit, SourceEditRequest, StructReparentContext } from '@volter/sdk/source-authoring';

package/src/source/writer.ts

@@ -9,8 +9,8 @@
 
 import { UTILITY_CLASSES_UNPROVEN, type UtilityClassSupport } from './utility-class-support';
 
-import type { DuplicateRewrite } from '@volter/editor-sdk/source-authoring';
-export type { DuplicateRewrite } from '@volter/editor-sdk/source-authoring';
+import type { DuplicateRewrite } from '@volter/sdk/source-authoring';
+export type { DuplicateRewrite } from '@volter/sdk/source-authoring';
 
 export interface StyleProperty {
   name: string;