@volter/editor-react 0.5.66

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@volter/editor-react",
+  "author": "Volter AI, Inc.",
+  "license": "AGPL-3.0-only",
+  "version": "0.5.66",
+  "publishConfig": {
+    "access": "public"
+  },
+  "description": "React source authoring for Volter Editor: JSX identity, source writes, component contracts and declared props.",
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/volter-ai/editor.git",
+    "directory": "packages/editor-react"
+  },
+  "files": [
+    "src",
+    "contributions",
+    "serving",
+    "dist-node",
+    "LICENSE",
+    "NOTICE"
+  ],
+  "exports": {
+    "./source/*": "./src/source/*.ts",
+    "./contributions/*": "./contributions/*",
+    "./package.json": "./package.json"
+  },
+  "scripts": {
+    "build": "node scripts/build-serving.mjs",
+    "prepack": "npm run build",
+    "typecheck": "tsc -p tsconfig.json"
+  },
+  "vgai": {
+    "contributions": [
+      "./contributions/component-contracts.service.ts"
+    ],
+    "serving": "./dist-node/serving.mjs"
+  },
+  "dependencies": {
+    "@volter/editor-sdk": "0.5.66",
+    "@volter/editor-project": "0.5.66",
+    "typescript": "5.9.3"
+  },
+  "peerDependencies": {
+    "vite": "^6.4.3"
+  },
+  "devDependencies": {
+    "esbuild": "0.25.12"
+  }
+}

package/serving/component-prop-worker.ts

@@ -0,0 +1,72 @@
+/**
+ * TypeScript declared-prop analysis, isolated from the Vite HTTP thread.
+ *
+ * `ComponentPropResolver` builds a full ts.Program on its first query. That is
+ * deliberately real TypeScript semantic analysis, but it is CPU-bound and
+ * takes seconds on a cold project. Running it from `setImmediate` does not
+ * make it asynchronous: it still freezes the one Node event loop serving the
+ * editor. This worker keeps one incremental resolver per project and returns
+ * only the ecosystem-native prop descriptions the OID index already carries.
+ *
+ * The `.ts` extensions below are LOAD-BEARING, not a style slip. `new
+ * Worker(new URL('./server/component-prop-worker.ts', …))` hands this file to
+ * Node directly: tsx's resolver hooks do not reach a worker thread, so the
+ * module is executed by Node's own type stripping, whose ESM resolver demands
+ * an explicit extension. Dropping them resolves under tsc and then dies at
+ * runtime with ERR_MODULE_NOT_FOUND the first time the editor asks for
+ * declared props. `tsconfig.server.json` sets `allowImportingTsExtensions`
+ * for exactly this reason.
+ */
+import { parentPort } from 'node:worker_threads';
+import { ComponentPropResolver } from '../src/source/component-prop-types';
+import type { ComponentPropSpec } from '@volter/editor-sdk/source-authoring';
+
+interface PropRequest {
+  key: string;
+  file: string;
+  tag: string;
+  /** `file` DEFINES `tag` (a prefab about to be dropped, not yet imported
+   *  anywhere) — answer from the definition instead of a callsite. */
+  definition?: boolean;
+}
+
+interface ResolveMessage {
+  id: number;
+  projectRoot: string;
+  requests: PropRequest[];
+}
+
+const resolvers = new Map<string, ComponentPropResolver>();
+
+function resolverFor(projectRoot: string): ComponentPropResolver {
+  const existing = resolvers.get(projectRoot);
+  if (existing) return existing;
+  const resolver = new ComponentPropResolver(projectRoot);
+  resolvers.set(projectRoot, resolver);
+  return resolver;
+}
+
+if (parentPort === null) {
+  throw new Error(
+    'component-prop-worker is a worker-thread entry point: it must be spawned with `new Worker(...)` and never imported on the main thread.',
+  );
+}
+const port = parentPort;
+
+port.on('message', (message: ResolveMessage) => {
+  try {
+    const resolver = resolverFor(message.projectRoot);
+    const props: Record<string, ComponentPropSpec[]> = {};
+    for (const request of message.requests) {
+      props[request.key] = request.definition
+        ? resolver.propsFor(request.file, request.tag)
+        : resolver.propsForTag(request.file, request.tag);
+    }
+    port.postMessage({ id: message.id, props });
+  } catch (error) {
+    port.postMessage({
+      id: message.id,
+      error: error instanceof Error ? error.message : String(error),
+    });
+  }
+});

package/serving/index.ts

@@ -0,0 +1,21 @@
+/**
+ * `@volter/editor-react`'s server half (`package.json#vgai.serving`, the project-serving door in
+ * `@volter/editor-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 { analyzeR3fComponentContracts, builtinR3fContractsForSource, sourceDialectEvidence } from '../src/source/oid-transform';
+import { r3fAuthoringDiagnostics } from '../src/source/r3f-project-contracts';
+import { uiOidPlugin } from './ui-oid-plugin';
+
+export const servingPlugins: ProjectServingModule['servingPlugins'] = (services) => [uiOidPlugin(services)];
+
+export { sourceDialectEvidence };
+
+export const sourceDiagnostics: ProjectServingModule['sourceDiagnostics'] = (code, file, options) =>
+  r3fAuthoringDiagnostics(code, file, options);
+
+export const componentContracts: ProjectServingModule['componentContracts'] = (source, path) =>
+  analyzeR3fComponentContracts(source, path, builtinR3fContractsForSource(source, path));