@forgeax/engine-pack 0.1.23 → 0.1.24

package/dist/{parameterized-pack-node.mjs → pack-authoring-node.mjs}

@@ -7366,10 +7366,10 @@ function validateParameterDefinitions(parameters, propertyPath = "$.parameters")
   }
   return ok(Object.freeze(normalized));
 }
-function projectParameterizedPackMeta(definition, sourcePath) {
+function projectScriptablePackMeta(definition, sourcePath) {
   return {
     schemaVersion: "2.0.0",
-    kind: "parameterized-pack-source",
+    kind: "scriptable-pack-source",
     packageId: PackageId.format(definition.packageId),
     source: sourcePath,
     ..."parameters" in definition ? {
@@ -7606,7 +7606,7 @@ function parsePackJsonAsset(value, sourceKey) {
   };
   return ok(withArtifacts);
 }
-function parseParameterizedPackJson(value) {
+function parsePackSourceJson(value) {
   if (!isRecord(value))
     return jsonError("$", "a v3 pack.json object", value, "document is not an object");
   if (value.schemaVersion !== "3.0.0")
@@ -7686,7 +7686,7 @@ function parseParameterizedPackJson(value) {
   });
 }
 function projectDirectPackJson(value) {
-  const parsed = "format" in value ? ok(value) : parseParameterizedPackJson(value);
+  const parsed = "format" in value ? ok(value) : parsePackSourceJson(value);
   if (!parsed.ok) return parsed;
   if (parsed.value.format !== "direct") {
     return failure(
@@ -7732,9 +7732,9 @@ async function resolvePackParameterInheritance(subject, readParent) {
     if (current.format === "direct") {
       return failure(
         authoringError(
-          "pack-parent-not-parameterized",
-          "a parameterized Pack source as the parent",
-          "direct packs cannot be instance parents; point the instance at a parameterized source",
+          "pack-parent-has-no-parameters",
+          "a ScriptablePack source with parameters as the parent",
+          "direct packs cannot be instance parents; point the instance at a ScriptablePack source with parameters",
           { packageId: currentId }
         )
       );
@@ -7745,7 +7745,7 @@ async function resolvePackParameterInheritance(subject, readParent) {
       if (descriptors2.value.length === 0) {
         return failure(
           authoringError(
-            "pack-parent-not-parameterized",
+            "pack-parent-has-no-parameters",
             "the parent source to declare a non-empty parameter list",
             "use clone for an independent zero-parameter Pack instead of creating an empty instance",
             { packageId: currentId }
@@ -7771,7 +7771,7 @@ async function resolvePackParameterInheritance(subject, readParent) {
         authoringError(
           "pack-parent-not-found",
           "the parent packageId to resolve in the source index",
-          "inspect the parent locator or recreate the instance from a live parameterized Pack",
+          "inspect the parent locator or recreate the instance from a live ScriptablePack with parameters",
           { packageId: currentId, parent: PackageId.format(current.parent) }
         )
       );
@@ -7812,7 +7812,7 @@ async function resolvePackParameterInheritance(subject, readParent) {
   }
   return visit(subject, []);
 }
-var PARAMETERIZED_PACK_OPERATION_IDS = [
+var PACK_AUTHORING_OPERATION_IDS = [
   "asset.list",
   "asset.inspect",
   "asset.resolve",
@@ -7824,7 +7824,7 @@ var PARAMETERIZED_PACK_OPERATION_IDS = [
   "asset-source.rebuild",
   "asset-source.cold-cook"
 ];
-function createParameterizedPackAuthoringGateway(port) {
+function createPackAuthoringGateway(port) {
   const requests = /* @__PURE__ */ new Map();
   return {
     execute(operation) {
@@ -7890,14 +7890,12 @@ function createParameterizedPackAuthoringGateway(port) {
     }
   };
 }
-PARAMETERIZED_PACK_OPERATION_IDS.map(
-  (id) => ({
-    id,
-    domain: id.startsWith("asset-source.") ? "session" : "asset",
-    readOnly: id.startsWith("asset."),
-    requiresRevision: !id.startsWith("asset.") && id !== "asset-source.create"
-  })
-);
+PACK_AUTHORING_OPERATION_IDS.map((id) => ({
+  id,
+  domain: id.startsWith("asset-source.") ? "session" : "asset",
+  readOnly: id.startsWith("asset."),
+  requiresRevision: !id.startsWith("asset.") && id !== "asset-source.create"
+}));
 function isRecord2(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
@@ -8358,7 +8356,7 @@ var pack_schema_default = {
     },
     parent: {
       $ref: "#/$defs/guid36",
-      description: "Parent parameterized Pack packageId for one v3 instance."
+      description: "Parent ScriptablePack packageId for one v3 instance; the source may declare Pack parameters."
     },
     values: {
       type: "object",
@@ -8713,7 +8711,7 @@ function hydrateFailure(value) {
   return value;
 }
 var WorkerScriptablePackExecutor = class {
-  supportsParameterizedContext = true;
+  supportsPackParameters = true;
   worker;
   compileRoot;
   nextBuildId = 0;
@@ -8814,7 +8812,7 @@ function scriptablePackWorkerUrl() {
   const bundledWorker = new URL("./scriptable-pack-worker.mjs", import.meta.url);
   return existsSync(fileURLToPath(bundledWorker)) ? bundledWorker : new URL("../dist/scriptable-pack-worker.mjs", import.meta.url);
 }
-function parameterizedLoadFailure(sourcePath, reason, phase, diagnostic, timeoutMs) {
+function scriptablePackLoadFailure(sourcePath, reason, phase, diagnostic, timeoutMs) {
   return {
     code: "pack-parameter-invalid",
     expected: "a trusted Pack v2 authoring module with a valid default export",
@@ -8828,14 +8826,14 @@ function parameterizedLoadFailure(sourcePath, reason, phase, diagnostic, timeout
     }
   };
 }
-async function loadParameterizedScriptablePack(sourcePath, options = {}) {
+async function loadScriptablePack(sourcePath, options = {}) {
   const timeoutMs = options.timeoutMs ?? 15e3;
   const buildTimeoutMs = options.buildTimeoutMs ?? 5e3;
   const executor = options.executor ?? new WorkerScriptablePackExecutor();
   let disposeReason;
   let timeout;
   try {
-    const timeoutSignal = /* @__PURE__ */ Symbol("parameterized-pack-module-timeout");
+    const timeoutSignal = /* @__PURE__ */ Symbol("scriptable-pack-module-timeout");
     const loaded = await Promise.race([
       executor.load(sourcePath),
       new Promise((resolve4) => {
@@ -8845,7 +8843,7 @@ async function loadParameterizedScriptablePack(sourcePath, options = {}) {
     if (loaded === timeoutSignal) {
       disposeReason = "timeout";
       return err(
-        parameterizedLoadFailure(
+        scriptablePackLoadFailure(
           sourcePath,
           "timeout",
           "module-load",
@@ -8872,7 +8870,7 @@ async function loadParameterizedScriptablePack(sourcePath, options = {}) {
         let buildTimedOut = false;
         let buildTimeout;
         const timeoutResult = err(
-          parameterizedLoadFailure(
+          scriptablePackLoadFailure(
             sourcePath,
             "timeout",
             "build",
@@ -8881,7 +8879,7 @@ async function loadParameterizedScriptablePack(sourcePath, options = {}) {
           )
         );
         try {
-          const invocation = "supportsParameterizedContext" in executor && executor.supportsParameterizedContext === true ? build(context.readByGuid, {
+          const invocation = "supportsPackParameters" in executor && executor.supportsPackParameters === true ? build(context.readByGuid, {
             packageId: [...context.packageId],
             ..."values" in context && context.values !== void 0 ? { values: context.values } : {}
           }) : definition.build(context);
@@ -8911,7 +8909,7 @@ async function loadParameterizedScriptablePack(sourcePath, options = {}) {
   } catch (error) {
     disposeReason = "failure";
     return err(
-      parameterizedLoadFailure(
+      scriptablePackLoadFailure(
         sourcePath,
         "module-load",
         "module-load",
@@ -9061,7 +9059,7 @@ async function scanValidated(roots, opts = {}, capture) {
     if (!loaded.ok) return loaded;
     const { raw, parsed } = loaded.value;
     if (record(parsed) && parsed.schemaVersion === "3.0.0") {
-      const authoring = parseParameterizedPackJson(parsed);
+      const authoring = parsePackSourceJson(parsed);
       if (!authoring.ok) {
         return packErr(
           makePackError("pack-malformed-pack", {
@@ -9305,7 +9303,7 @@ async function scanValidated(roots, opts = {}, capture) {
       ...opts.scriptablePack ?? {},
       ...capture === void 0 ? { metadataOnly: true } : {}
     };
-    const loaded = await loadParameterizedScriptablePack(sourcePath, loaderOptions);
+    const loaded = await loadScriptablePack(sourcePath, loaderOptions);
     if (!loaded.ok) {
       const diagnostic = loaded.error.detail.diagnostic;
       return packErr(
@@ -9334,12 +9332,12 @@ async function scanValidated(roots, opts = {}, capture) {
     const packageCollision = registerPackage(
       PackageId.format(loaded.value.packageId),
       sourcePath,
-      "parameterized"
+      "scriptable"
     );
     if (packageCollision !== void 0) return packErr(packageCollision);
-    const meta = projectParameterizedPackMeta(loaded.value, sourcePath);
+    const meta = projectScriptablePackMeta(loaded.value, sourcePath);
     capture?.declarations.set(sourcePath, {
-      format: "pack.ts-parameterized",
+      format: "pack.ts",
       sourcePath,
       sourceRevision: `sha256:${createHash("sha256").update(source).digest("hex")}`,
       value: meta,
@@ -9368,15 +9366,15 @@ async function scanValidated(roots, opts = {}, capture) {
       );
     }
     const kind = packageKind.get(parentId);
-    if (kind !== "parameterized" && kind !== "instance") {
+    if (kind !== "scriptable" && kind !== "instance") {
       return packErr(
         makePackError("pack-malformed-pack", {
           path: instance.path,
-          reason: "pack-parent-not-parameterized",
+          reason: "pack-parent-has-no-parameters",
           ajvErrors: [
             {
               instancePath: "/parent",
-              message: `parent ${instance.parent} is not a parameterized Pack`
+              message: `parent ${instance.parent} is not a ScriptablePack source with parameters`
             }
           ]
         })
@@ -9446,7 +9444,7 @@ async function scanInventory(roots, opts = {}) {
     const declaration = declarations.get(sourcePath);
     if (declaration?.format !== "pack.json") continue;
     if (declaration.value.schemaVersion === "3.0.0") {
-      const parsed = parseParameterizedPackJson(declaration.value);
+      const parsed = parsePackSourceJson(declaration.value);
       if (!parsed.ok) {
         return packErr(
           makePackError("pack-malformed-pack", {
@@ -9491,7 +9489,7 @@ async function scanInventory(roots, opts = {}) {
   return ok3({ paths: scanned.value, inventory, declarations });
 }
 
-// src/parameterized-pack-node.ts
+// src/pack-authoring-node.ts
 function isRecord3(value) {
   return value !== null && typeof value === "object" && !Array.isArray(value);
 }
@@ -9623,7 +9621,7 @@ function scanFailure(operation, cause) {
   const value = cause !== null && typeof cause === "object" ? cause : {};
   const detail = value.detail !== null && typeof value.detail === "object" ? value.detail : {};
   const reason = isRecord3(detail) && typeof detail.reason === "string" ? detail.reason : void 0;
-  const code = reason === "pack-parent-not-found" || reason === "pack-parent-cycle" || reason === "pack-parent-not-parameterized" ? reason : value.code === "pack-guid-collision" ? "pack-guid-collision" : "pack-parameter-invalid";
+  const code = reason === "pack-parent-not-found" || reason === "pack-parent-cycle" || reason === "pack-parent-has-no-parameters" ? reason : value.code === "pack-guid-collision" ? "pack-guid-collision" : "pack-parameter-invalid";
   return makeError(
     code,
     typeof value.expected === "string" ? value.expected : "a valid Pack Source Index",
@@ -9795,7 +9793,7 @@ async function createSnapshot(options, operation) {
   const directAssets = [];
   for (const [sourcePath, declaration] of scanned.value.declarations) {
     const relativePath = relative(resolve(options.gameRoot), sourcePath).split(sep).join("/");
-    if (declaration.format === "pack.ts-parameterized") {
+    if (declaration.format === "pack.ts") {
       subjects.set(packageKey(declaration.definition.packageId), {
         format: "source",
         packageId: declaration.definition.packageId,
@@ -9806,7 +9804,7 @@ async function createSnapshot(options, operation) {
       continue;
     }
     if (declaration.format !== "pack.json" || declaration.value.schemaVersion !== "3.0.0") continue;
-    const parsed = parseParameterizedPackJson(declaration.value);
+    const parsed = parsePackSourceJson(declaration.value);
     if (!parsed.ok) return err(parsed.error);
     if (parsed.value.format === "direct") {
       const projected = projectDirectPackJson(parsed.value);
@@ -10519,7 +10517,7 @@ function revisionConflict(operation, path, actual) {
 function directJson(packageId2, assets) {
   return { schemaVersion: "3.0.0", packageId: PackageId.format(packageId2), assets };
 }
-function parameterizedScaffold(packageId2, parameters) {
+function packSourceScaffold(packageId2, parameters) {
   const parameterSource = parameters === void 0 ? "" : "\n  parameters: " + JSON.stringify(
     parameters.map((parameter) => jsonValue(parameter)),
     null,
@@ -10607,13 +10605,13 @@ async function executeRaw(options, operation) {
           makeError(
             "pack-parameter-invalid",
             "direct create to contain assets only",
-            "use pack.ts for a parameterized source or create-instance for parent+values",
+            "use pack.ts for a ScriptablePack source or create-instance for parent+values",
             { requestId: operation.requestId }
           )
         );
       }
       const assets = operation.initialAssets ?? {};
-      const parsed = parseParameterizedPackJson(directJson(identity.value, assets));
+      const parsed = parsePackSourceJson(directJson(identity.value, assets));
       if (!parsed.ok) return err(parsed.error);
       if (parsed.value.format !== "direct") {
         return err(
@@ -10669,7 +10667,7 @@ async function executeRaw(options, operation) {
         }
         parameters = validated.value.parameters;
       }
-      source = parameterizedScaffold(identity.value, parameters);
+      source = packSourceScaffold(identity.value, parameters);
       const serialized = parameters === void 0 ? void 0 : serializedParameters({
         schemaVersion: "2.0.0",
         packageId: identity.value,
@@ -10765,7 +10763,7 @@ async function executeRaw(options, operation) {
           )
         );
       }
-      const parsed = parseParameterizedPackJson(parsedValue);
+      const parsed = parsePackSourceJson(parsedValue);
       if (!parsed.ok) return err(parsed.error);
       source = `${JSON.stringify(
         parsed.value.format === "direct" ? directJson(identity.value, parsed.value.assets) : {
@@ -10825,7 +10823,7 @@ async function executeRaw(options, operation) {
         makeError(
           "pack-parent-not-found",
           "a parent packageId for the new instance",
-          "pass parentPackageId or parent and point it at a parameterized source",
+          "pass parentPackageId or parent and point it at a ScriptablePack source with parameters",
           { requestId: operation.requestId }
         )
       );
@@ -10848,7 +10846,7 @@ async function executeRaw(options, operation) {
         makeError(
           "pack-parent-not-found",
           "the parent packageId to exist in the current Source Index",
-          "inspect the Source Index and choose a parameterized parent",
+          "inspect the Source Index and choose a ScriptablePack parent with parameters",
           { requestId: operation.requestId, parent: parentText }
         )
       );
@@ -10856,8 +10854,8 @@ async function executeRaw(options, operation) {
     if (parent.format === "source" && !("parameters" in parent.definition)) {
       return err(
         makeError(
-          "pack-parent-not-parameterized",
-          "a non-empty parameterized Pack source as the parent",
+          "pack-parent-has-no-parameters",
+          "a ScriptablePack source with a non-empty parameter list as the parent",
           "use asset-source.clone for a zero-parameter Pack",
           { requestId: operation.requestId, parent: parentText }
         )
@@ -10866,8 +10864,8 @@ async function executeRaw(options, operation) {
     if (parent.format === "direct") {
       return err(
         makeError(
-          "pack-parent-not-parameterized",
-          "a parameterized Pack source or instance as the parent",
+          "pack-parent-has-no-parameters",
+          "a ScriptablePack source or instance with parameters as the parent",
           "direct Packs cannot be instance parents",
           { requestId: operation.requestId, parent: parentText }
         )
@@ -10970,7 +10968,7 @@ async function executeRaw(options, operation) {
         )
       );
     }
-    const parsed = parseParameterizedPackJson(json);
+    const parsed = parsePackSourceJson(json);
     if (!parsed.ok) return err(parsed.error);
     if (parsed.value.format !== "instance") {
       return err(
@@ -11073,21 +11071,19 @@ async function executeRaw(options, operation) {
   return err(
     makeError(
       "pack-parameter-invalid",
-      "a supported parameterized Pack operation",
-      "use one of PARAMETERIZED_PACK_OPERATION_IDS",
+      "a supported Pack authoring operation",
+      "use one of PACK_AUTHORING_OPERATION_IDS",
       { requestId: operation.requestId, operation: operation.operation }
     )
   );
 }
-function createFileSystemParameterizedPackAuthoringPort(options) {
+function createFileSystemPackAuthoringPort(options) {
   return { execute: (operation) => executeRaw(options, operation) };
 }
-function createFileSystemParameterizedPackAuthoringGateway(options) {
-  return createParameterizedPackAuthoringGateway(
-    createFileSystemParameterizedPackAuthoringPort(options)
-  );
+function createFileSystemPackAuthoringGateway(options) {
+  return createPackAuthoringGateway(createFileSystemPackAuthoringPort(options));
 }
 
-export { createFileSystemParameterizedPackAuthoringGateway, createFileSystemParameterizedPackAuthoringPort };
-//# sourceMappingURL=parameterized-pack-node.mjs.map
-//# sourceMappingURL=parameterized-pack-node.mjs.map
+export { createFileSystemPackAuthoringGateway, createFileSystemPackAuthoringPort };
+//# sourceMappingURL=pack-authoring-node.mjs.map
+//# sourceMappingURL=pack-authoring-node.mjs.map