@forgeax/engine-pack 0.1.23 → 0.1.24

package/src/scriptable-pack-node.ts

@@ -13,12 +13,12 @@ import {
   producerRelativeDdcKey,
 } from './evidence/source-inventory.js';
 import {
-  type AnyParameterizedPackDefinition,
+  type AnyScriptablePackDefinition,
   type PackAuthoringError,
   type PackBuildContextWithoutParameters,
   type PackBuildResult,
   validatePackDefinition,
-} from './parameterized-pack.js';
+} from './pack-authoring.js';
 import type { AssetReader, ScriptablePackSourceClosureEntry } from './scriptable-pack.js';
 
 const IMPORT_META_RESOLVE_FLAG = '--experimental-import-meta-resolve';
@@ -39,13 +39,13 @@ export interface ScriptablePackModuleExecutor {
   dispose?(reason: 'complete' | 'timeout' | 'failure'): void | Promise<void>;
 }
 
-interface SerializedParameterizedBuildContext {
+interface SerializedScriptablePackBuildContext {
   readonly packageId: readonly number[];
   readonly values?: Readonly<Record<string, unknown>>;
 }
 
 interface WorkerBackedScriptablePackExecutor {
-  readonly supportsParameterizedContext: true;
+  readonly supportsPackParameters: true;
 }
 
 export interface ScriptablePackModuleExecutorPool {
@@ -212,7 +212,7 @@ function hydrateFailure(value: unknown): unknown {
 class WorkerScriptablePackExecutor
   implements ScriptablePackModuleExecutor, WorkerBackedScriptablePackExecutor
 {
-  readonly supportsParameterizedContext = true as const;
+  readonly supportsPackParameters = true as const;
   private worker: Worker | undefined;
   private compileRoot: string | undefined;
   private nextBuildId = 0;
@@ -256,7 +256,7 @@ class WorkerScriptablePackExecutor
                     ...(value.definition as Record<string, unknown>),
                     build: (
                       readByGuid: AssetReader['readByGuid'],
-                      context?: SerializedParameterizedBuildContext,
+                      context?: SerializedScriptablePackBuildContext,
                     ) => this.runBuild({ readByGuid }, context),
                   },
           });
@@ -293,7 +293,7 @@ class WorkerScriptablePackExecutor
 
   private runBuild(
     reader: AssetReader,
-    context?: SerializedParameterizedBuildContext,
+    context?: SerializedScriptablePackBuildContext,
   ): Promise<unknown> {
     const worker = this.worker;
     if (worker === undefined) return Promise.reject(new Error('ScriptablePack worker is closed'));
@@ -347,7 +347,7 @@ function scriptablePackWorkerUrl(): URL {
 class ReusableWorkerScriptablePackExecutor
   implements ScriptablePackModuleExecutor, WorkerBackedScriptablePackExecutor
 {
-  readonly supportsParameterizedContext = true as const;
+  readonly supportsPackParameters = true as const;
   private readonly worker: Worker;
   private readonly compileRootReady = mkdtemp(resolve(tmpdir(), 'forgeax-scriptable-pack-pool-'));
   private compileRoot: string | undefined;
@@ -484,7 +484,7 @@ class ReusableWorkerScriptablePackExecutor
 
   private runBuild(
     reader: AssetReader,
-    context?: SerializedParameterizedBuildContext,
+    context?: SerializedScriptablePackBuildContext,
   ): Promise<unknown> {
     if (this.released || this.disposal !== undefined) {
       return Promise.reject(new Error('ScriptablePack executor is not leased'));
@@ -519,7 +519,7 @@ class ReusableWorkerScriptablePackExecutor
                 ...(value.definition as Record<string, unknown>),
                 build: (
                   readByGuid: AssetReader['readByGuid'],
-                  context?: SerializedParameterizedBuildContext,
+                  context?: SerializedScriptablePackBuildContext,
                 ) => this.runBuild({ readByGuid }, context),
               },
       });
@@ -642,14 +642,14 @@ export function createScriptablePackModuleExecutorPool(
   return new DefaultScriptablePackModuleExecutorPool(options);
 }
 
-export interface LoadParameterizedScriptablePackOptions {
+export interface LoadScriptablePackOptions {
   readonly timeoutMs?: number;
   readonly buildTimeoutMs?: number;
   readonly executor?: ScriptablePackModuleExecutor;
   readonly metadataOnly?: boolean;
 }
 
-function parameterizedLoadFailure(
+function scriptablePackLoadFailure(
   sourcePath: string,
   reason: 'module-load' | 'timeout',
   phase: 'module-load' | 'build',
@@ -670,18 +670,18 @@ function parameterizedLoadFailure(
   };
 }
 
-/** Load the parameterized Pack source contract in an isolated module executor. */
-export async function loadParameterizedScriptablePack(
+/** Load a ScriptablePack source contract in an isolated module executor. */
+export async function loadScriptablePack(
   sourcePath: string,
-  options: LoadParameterizedScriptablePackOptions = {},
-): Promise<Result<Readonly<AnyParameterizedPackDefinition>, PackAuthoringError>> {
+  options: LoadScriptablePackOptions = {},
+): Promise<Result<Readonly<AnyScriptablePackDefinition>, PackAuthoringError>> {
   const timeoutMs = options.timeoutMs ?? 15_000;
   const buildTimeoutMs = options.buildTimeoutMs ?? 5_000;
   const executor = options.executor ?? new WorkerScriptablePackExecutor();
   let disposeReason: 'complete' | 'timeout' | 'failure' | undefined;
   let timeout: ReturnType<typeof setTimeout> | undefined;
   try {
-    const timeoutSignal = Symbol('parameterized-pack-module-timeout');
+    const timeoutSignal = Symbol('scriptable-pack-module-timeout');
     const loaded = await Promise.race([
       executor.load(sourcePath),
       new Promise<typeof timeoutSignal>((resolve) => {
@@ -691,7 +691,7 @@ export async function loadParameterizedScriptablePack(
     if (loaded === timeoutSignal) {
       disposeReason = 'timeout';
       return err(
-        parameterizedLoadFailure(
+        scriptablePackLoadFailure(
           sourcePath,
           'timeout',
           'module-load',
@@ -716,7 +716,7 @@ export async function loadParameterizedScriptablePack(
     const definition = validated.value;
     const build = definition.build as unknown as (
       first: unknown,
-      context?: SerializedParameterizedBuildContext,
+      context?: SerializedScriptablePackBuildContext,
     ) => PackBuildResult;
     return ok({
       ...definition,
@@ -726,7 +726,7 @@ export async function loadParameterizedScriptablePack(
         let buildTimedOut = false;
         let buildTimeout: ReturnType<typeof setTimeout> | undefined;
         const timeoutResult = err(
-          parameterizedLoadFailure(
+          scriptablePackLoadFailure(
             sourcePath,
             'timeout',
             'build',
@@ -736,9 +736,9 @@ export async function loadParameterizedScriptablePack(
         );
         try {
           const invocation =
-            'supportsParameterizedContext' in executor &&
-            (executor as Partial<WorkerBackedScriptablePackExecutor>)
-              .supportsParameterizedContext === true
+            'supportsPackParameters' in executor &&
+            (executor as Partial<WorkerBackedScriptablePackExecutor>).supportsPackParameters ===
+              true
               ? build(context.readByGuid, {
                   packageId: [...context.packageId],
                   ...('values' in context && context.values !== undefined
@@ -768,11 +768,11 @@ export async function loadParameterizedScriptablePack(
           if (buildTimeout !== undefined) clearTimeout(buildTimeout);
         }
       },
-    } as AnyParameterizedPackDefinition);
+    } as AnyScriptablePackDefinition);
   } catch (error) {
     disposeReason = 'failure';
     return err(
-      parameterizedLoadFailure(
+      scriptablePackLoadFailure(
         sourcePath,
         'module-load',
         'module-load',

package/src/scriptable-pack.ts

@@ -2,10 +2,11 @@ import type { Asset, AssetGuid, Result } from '@forgeax/engine-types';
 
 /**
  * Build-time Pack vocabulary shared by the source loader and output
- * producers. Authoring definitions themselves live in parameterized-pack.ts.
+ * producers. ScriptablePack and Pack authoring definitions live in the shared
+ * Pack authoring implementation; this facade is the browser-safe source entry.
  */
 export * from './guid.js';
-export * from './parameterized-pack.js';
+export * from './pack-authoring.js';
 
 /** Closed ordinary kind vocabulary shared by Pack discovery and producers. */
 export type ScriptablePackAssetKind = Asset['kind'];

package/dist/__tests__/parameterized-pack-authoring-gateway.unit.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=parameterized-pack-authoring-gateway.unit.test.d.ts.map

package/dist/__tests__/parameterized-pack-authoring-gateway.unit.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"parameterized-pack-authoring-gateway.unit.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/parameterized-pack-authoring-gateway.unit.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/parameterized-pack-scanner.unit.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=parameterized-pack-scanner.unit.test.d.ts.map

package/dist/__tests__/parameterized-pack-scanner.unit.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"parameterized-pack-scanner.unit.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/parameterized-pack-scanner.unit.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/parameterized-pack.unit.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=parameterized-pack.unit.test.d.ts.map

package/dist/__tests__/parameterized-pack.unit.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"parameterized-pack.unit.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/parameterized-pack.unit.test.ts"],"names":[],"mappings":""}

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

@@ -1 +0,0 @@
-{"version":3,"file":"parameterized-pack-node.d.ts","sourceRoot":"","sources":["../src/parameterized-pack-node.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAgC,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAGlF,OAAO,EAIL,KAAK,kBAAkB,EAIvB,KAAK,4BAA4B,EAEjC,KAAK,gCAAgC,EAOtC,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,KAAK,aAAa,EAAiB,MAAM,cAAc,CAAC;AAEjE,MAAM,WAAW,kCAAkC;IACjD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;CACnC;AAED,MAAM,WAAW,2CAA2C;IAC1D,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,gFAAgF;IAChF,QAAQ,CAAC,YAAY,CAAC,EAAE,MACpB,SAAS,kCAAkC,EAAE,GAC7C,OAAO,CAAC,SAAS,kCAAkC,EAAE,CAAC,CAAC;IAC3D,kFAAkF;IAClF,QAAQ,CAAC,OAAO,CAAC,EAAE,CACjB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,SAAS,GAAG,WAAW,KAC1B,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,kBAAkB,CAAC,CAAC,CAAC;IAClD,2EAA2E;IAC3E,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC,CAAC;CACpE;AAg3DD,wBAAgB,8CAA8C,CAC5D,OAAO,EAAE,2CAA2C,GACnD,4BAA4B,CAAC,gCAAgC,CAAC,CAEhE;AAED,wBAAgB,iDAAiD,CAC/D,OAAO,EAAE,2CAA2C,GACnD,4BAA4B,CAAC,gCAAgC,CAAC,CAIhE"}