@forgeax/engine-pack 0.1.3 → 0.1.6

package/dist/scriptable-pack-node.d.ts

@@ -1,6 +1,6 @@
 import type { Result } from '@forgeax/engine-types';
 import { type ProducerSemanticIdentityInput } from './evidence/source-inventory.js';
-import { type ScriptablePackAssetKind, type ScriptablePackAuthoringPort, type ScriptablePackDefinition, type ScriptablePackError } from './scriptable-pack.js';
+import { type ScriptablePackAssetKind, type ScriptablePackAuthoringPort, type ScriptablePackDefinition, type ScriptablePackError, type ScriptablePackSourceClosureEntry } from './scriptable-pack.js';
 export interface ScriptablePackModuleExecutor {
     load(sourcePath: string): Promise<unknown>;
     dispose?(reason: 'complete' | 'timeout' | 'failure'): void | Promise<void>;
@@ -23,13 +23,6 @@ export declare function readOptionalBuildCache<T>(cache: OptionalBuildCache<T>):
     readonly value: T;
     readonly fromCache: boolean;
 }>;
-/** Serializable source-closure evidence shared by scanner and producer paths. */
-export interface ScriptablePackSourceClosureEntry {
-    readonly path: string;
-    readonly digest: string;
-}
-/** Inventory a ScriptablePack module without importing or executing it. */
-export declare function inventoryScriptablePackSource(sourcePath: string): Promise<readonly ScriptablePackSourceClosureEntry[]>;
 export interface LoadScriptablePackOptions {
     /** Maximum time allowed for module initialization in the isolated worker. */
     readonly timeoutMs?: number;
@@ -39,6 +32,8 @@ export interface LoadScriptablePackOptions {
     /** Release the isolated loader after identity projection when build will not be called. */
     readonly metadataOnly?: boolean;
 }
+/** Capture one immutable ScriptablePack module closure for inventory and production. */
+export declare function inventoryScriptablePackSource(sourcePath: string, initialSourceText?: string): Promise<readonly ScriptablePackSourceClosureEntry[]>;
 export declare function createScriptablePackModuleExecutorPool(options?: ScriptablePackModuleExecutorPoolOptions): ScriptablePackModuleExecutorPool;
 export declare function loadScriptablePack(sourcePath: string, options?: LoadScriptablePackOptions): Promise<Result<Readonly<ScriptablePackDefinition>, ScriptablePackError>>;
 interface CanonicalOutput {

package/dist/scriptable-pack-node.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scriptable-pack-node.d.ts","sourceRoot":"","sources":["../src/scriptable-pack-node.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"scriptable-pack-node.d.ts","sourceRoot":"","sources":["../src/scriptable-pack-node.ts"],"names":[],"mappings":"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"}

package/dist/scriptable-pack-node.mjs

@@ -116,6 +116,22 @@ var SCRIPTABLE_PACK_ASSET_KINDS = [
 function isScriptablePackAssetKind(value) {
   return SCRIPTABLE_PACK_ASSET_KINDS.includes(value);
 }
+function sceneComponentFieldType(value) {
+  if (typeof value === "string") return value;
+  if (isRecord(value) && typeof value.type === "string") return value.type;
+  return void 0;
+}
+function projectScriptablePackSceneComponents(components) {
+  return (components ?? []).map((component) => ({
+    name: component.name,
+    fields: Object.fromEntries(
+      Object.entries(component.fields).map(([fieldName, field]) => [
+        fieldName,
+        sceneComponentFieldType(field)
+      ])
+    )
+  }));
+}
 var SCRIPTABLE_PACK_REQUEST_ID_SCHEMA = {
   type: "string",
   minLength: 1,
@@ -341,11 +357,20 @@ function freezeDefinition(definition) {
       guid.slice()
     ])
   );
+  const sceneComponents = definition.sceneComponents === void 0 ? void 0 : Object.freeze(
+    projectScriptablePackSceneComponents(definition.sceneComponents).map(
+      (component) => Object.freeze({
+        ...component,
+        fields: Object.freeze({ ...component.fields })
+      })
+    )
+  );
   return Object.freeze({
     ...definition,
     packageId: definition.packageId.slice(),
     assets: Object.freeze(assets),
-    externalAssets: Object.freeze(externalAssets)
+    externalAssets: Object.freeze(externalAssets),
+    ...sceneComponents === void 0 ? {} : { sceneComponents }
   });
 }
 function validateScriptablePackDefinition(value, sourcePath) {
@@ -376,6 +401,63 @@ function validateScriptablePackDefinition(value, sourcePath) {
       sourcePath
     );
   }
+  if (value.sceneComponents !== void 0) {
+    if (!Array.isArray(value.sceneComponents)) {
+      return invalid(
+        "$.sceneComponents",
+        "an array of component tokens or neutral schema rows when present",
+        value.sceneComponents,
+        sourcePath
+      );
+    }
+    const componentNames = /* @__PURE__ */ new Set();
+    for (const [componentIndex, component] of value.sceneComponents.entries()) {
+      if (!isRecord(component)) {
+        return invalid(
+          `$.sceneComponents[${componentIndex}]`,
+          "a component token or neutral schema row",
+          component,
+          sourcePath
+        );
+      }
+      if (typeof component.name !== "string" || component.name.trim().length === 0) {
+        return invalid(
+          `$.sceneComponents[${componentIndex}].name`,
+          "a non-empty component name",
+          component.name,
+          sourcePath
+        );
+      }
+      if (componentNames.has(component.name)) {
+        return invalid(
+          `$.sceneComponents[${componentIndex}].name`,
+          "component names to be unique within one ScriptablePack",
+          component.name,
+          sourcePath
+        );
+      }
+      componentNames.add(component.name);
+      if (!isRecord(component.fields)) {
+        return invalid(
+          `$.sceneComponents[${componentIndex}].fields`,
+          "a field-name to schema-type object",
+          component.fields,
+          sourcePath
+        );
+      }
+      for (const [fieldName, field] of Object.entries(component.fields)) {
+        const type = sceneComponentFieldType(field);
+        if (fieldName.trim().length === 0 || type === void 0 || type.trim().length === 0) {
+          return invalid(
+            `$.sceneComponents[${componentIndex}].fields`,
+            "field names with non-empty string schema types",
+            field,
+            sourcePath
+          );
+        }
+      }
+    }
+  }
   if (typeof value.build !== "function") {
     return invalid("$.build", "a build(assetReader) function", value.build, sourcePath);
   }
@@ -527,7 +609,7 @@ async function readOptionalBuildCache(cache) {
   }
   return { value: await cache.coldCook(), fromCache: false };
 }
-async function resolveRelativeSourceImport(sourcePath, specifier) {
+async function resolveRelativeImport(sourcePath, specifier) {
   if (!specifier.startsWith(".")) return void 0;
   const raw = resolve(dirname(sourcePath), specifier);
   const candidates = extname(raw).length > 0 ? [raw] : [
@@ -548,19 +630,20 @@ async function resolveRelativeSourceImport(sourcePath, specifier) {
   }
   return void 0;
 }
-async function inventoryScriptablePackSource(sourcePath) {
-  const pending = [await realpath(sourcePath)];
+async function inventoryScriptablePackSource(sourcePath, initialSourceText) {
+  const root = await realpath(sourcePath);
+  const pending = [root];
   const seen = /* @__PURE__ */ new Set();
   const entries = [];
   while (pending.length > 0) {
     const path = pending.pop();
     if (path === void 0 || seen.has(path)) continue;
     seen.add(path);
-    const bytes = await readFile(path);
+    const bytes = path === root && initialSourceText !== void 0 ? new TextEncoder().encode(initialSourceText) : await readFile(path);
     entries.push({ path, digest: `sha256:${createHash("sha256").update(bytes).digest("hex")}` });
-    const imports = ts.preProcessFile(new TextDecoder().decode(bytes), true, true).importedFiles;
-    for (const imported of imports) {
-      const resolved = await resolveRelativeSourceImport(path, imported.fileName);
+    const source = new TextDecoder().decode(bytes);
+    for (const imported of ts.preProcessFile(source, true, true).importedFiles) {
+      const resolved = await resolveRelativeImport(path, imported.fileName);
       if (resolved !== void 0) pending.push(await realpath(resolved));
     }
   }
@@ -634,6 +717,7 @@ var WorkerScriptablePackExecutor = class {
         if (message === null || typeof message !== "object") return;
         const value = message;
         if (value.kind === "loaded") {
+          worker.unref();
           worker.off("message", onMessage);
           resolveLoad({
             default: value.definition === void 0 ? void 0 : {
@@ -1207,7 +1291,7 @@ export default {
   ${manifest.name === void 0 ? "" : `name: ${JSON.stringify(manifest.name)},
   `}assets,
   externalAssets,
-  build: () => ok(Object.fromEntries(Object.entries(assets).map(([sourceKey, asset]) => [sourceKey, createOutput(asset.kind)])) as never),
+  build: () => ok(Object.fromEntries(Object.entries(assets).map(([sourceKey, asset]) => [sourceKey, createOutput(asset.kind)])) as Record<string, Asset>),
 } satisfies ScriptablePackDefinition;
 `;
 }