@forgeax/engine-import 0.0.0-dev.8d955ade1c79

package/dist/mesh-bin.d.ts

@@ -0,0 +1,19 @@
+import { type MeshBinContractError } from '@forgeax/engine-pack/mesh-bin-contract';
+import { type MeshAsset, type Result } from '@forgeax/engine-types';
+type MeshPayloadIn = {
+    readonly [Key in keyof MeshAsset]?: MeshAsset[Key] | undefined;
+} & {
+    readonly vertexCount?: number;
+};
+export type MeshBinEncodeError = MeshBinContractError | {
+    readonly code: 'mesh-bin-payload-invalid';
+    readonly subject: 'mesh-bin';
+    readonly sourceKey: string;
+    readonly expected: string;
+    readonly actual: string;
+    readonly recovery: string;
+};
+/** Encode one canonical v4 mesh binary. No legacy version is accepted or emitted. */
+export declare function packMeshBinV4(payload: MeshPayloadIn, sourceKey: string, refs?: readonly string[]): Result<Uint8Array, MeshBinEncodeError>;
+export {};
+//# sourceMappingURL=mesh-bin.d.ts.map

package/dist/mesh-bin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mesh-bin.d.ts","sourceRoot":"","sources":["../src/mesh-bin.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,oBAAoB,EAG1B,MAAM,wCAAwC,CAAC;AAChD,OAAO,EAEL,KAAK,SAAS,EAEd,KAAK,MAAM,EAEZ,MAAM,uBAAuB,CAAC;AAE/B,KAAK,aAAa,GAAG;IAAE,QAAQ,EAAE,GAAG,IAAI,MAAM,SAAS,CAAC,CAAC,EAAE,SAAS,CAAC,GAAG,CAAC,GAAG,SAAS;CAAE,GAAG;IACxF,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAC1B,oBAAoB,GACpB;IACE,QAAQ,CAAC,IAAI,EAAE,0BAA0B,CAAC;IAC1C,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B,CAAC;AAiEN,qFAAqF;AACrF,wBAAgB,aAAa,CAC3B,OAAO,EAAE,aAAa,EACtB,SAAS,EAAE,MAAM,EACjB,IAAI,GAAE,SAAS,MAAM,EAAO,GAC3B,MAAM,CAAC,UAAU,EAAE,kBAAkB,CAAC,CAiIxC"}

package/dist/mesh-bin.mjs

@@ -0,0 +1,182 @@
+import { deriveVertexLayoutProjection } from '@forgeax/engine-geometry';
+import { AssetGuid } from '@forgeax/engine-pack/guid';
+import { MESH_BIN_HEADER_V4_BYTES, writeMeshBinHeader } from '@forgeax/engine-pack/mesh-bin-contract';
+import { err, ok } from '@forgeax/engine-types';
+
+// src/mesh-bin.ts
+function failure(sourceKey, expected, actual) {
+  return {
+    code: "mesh-bin-payload-invalid",
+    subject: "mesh-bin",
+    sourceKey,
+    expected,
+    actual,
+    recovery: "re-cook the source with its Meta sidecar through the build-time importer"
+  };
+}
+function asAttributeMap(value) {
+  return value ?? {};
+}
+function jsonValue(value) {
+  if (value instanceof Float32Array || value instanceof Uint16Array) return Array.from(value);
+  if (Array.isArray(value)) return value.map(jsonValue);
+  if (value !== null && typeof value === "object") {
+    return Object.fromEntries(
+      Object.entries(value).map(([key, nested]) => [key, jsonValue(nested)])
+    );
+  }
+  return value;
+}
+function refsMeta(payload, refs) {
+  const materialSlots = (payload.materialSlots ?? [{ slotName: "Default" }]).map(
+    (slot, slotIndex) => {
+      const defaultMaterial = slot.defaultMaterial;
+      let defaultMaterialRef;
+      if (defaultMaterial !== void 0) {
+        const guid = AssetGuid.format(defaultMaterial);
+        defaultMaterialRef = refs.findIndex((candidate) => candidate.toLowerCase() === guid);
+        if (defaultMaterialRef < 0) {
+          throw new Error(
+            `material slot ${slotIndex} default material ${guid} is absent from refs`
+          );
+        }
+      }
+      return {
+        slotName: slot.slotName,
+        ...slot.sourceKey === void 0 ? {} : { sourceKey: slot.sourceKey },
+        ...defaultMaterialRef === void 0 ? {} : { defaultMaterialRef }
+      };
+    }
+  );
+  return {
+    submeshes: payload.submeshes === void 0 || payload.submeshes.length === 0 ? [{ indexOffset: 0, indexCount: payload.indices?.length ?? 0, materialSlot: 0 }] : payload.submeshes,
+    materialSlots,
+    ...payload.aabb === void 0 ? {} : { aabb: jsonValue(payload.aabb) },
+    ...payload.morphTargets === void 0 ? {} : { morphTargets: jsonValue(payload.morphTargets) },
+    ...payload.morphWeights === void 0 ? {} : { morphWeights: jsonValue(payload.morphWeights) }
+  };
+}
+function packMeshBinV4(payload, sourceKey, refs = []) {
+  try {
+    const vertices = payload.vertices;
+    const indices = payload.indices;
+    if (!(vertices instanceof Float32Array)) {
+      return err(
+        failure(sourceKey, "Float32Array interleaved vertices", "vertices is not Float32Array")
+      );
+    }
+    if (indices !== void 0 && !(indices instanceof Uint16Array || indices instanceof Uint32Array)) {
+      return err(
+        failure(sourceKey, "Uint16Array or Uint32Array indices", "indices has an unsupported type")
+      );
+    }
+    const attributes = asAttributeMap(payload.attributes);
+    const projection = deriveVertexLayoutProjection(attributes);
+    if (projection.attributes.length === 0 || projection.arrayStride === 0) {
+      return err(
+        failure(
+          sourceKey,
+          "a non-empty canonical geometry projection",
+          "projection has no attributes"
+        )
+      );
+    }
+    const vertexCount = payload.vertexCount ?? vertices.byteLength / projection.arrayStride;
+    if (!Number.isSafeInteger(vertexCount) || vertexCount < 0) {
+      return err(
+        failure(sourceKey, "a non-negative safe vertex cardinality", `vertexCount=${vertexCount}`)
+      );
+    }
+    if (vertices.byteLength !== vertexCount * projection.arrayStride) {
+      return err(
+        failure(
+          sourceKey,
+          `vertices.byteLength=${vertexCount * projection.arrayStride}`,
+          `vertices.byteLength=${vertices.byteLength}; stride=${projection.arrayStride}`
+        )
+      );
+    }
+    for (const attribute of projection.attributes) {
+      const value = attributes[attribute.key];
+      const components = attribute.byteLength / (attribute.format === "uint16x4" ? 2 : 4);
+      if (value === void 0 || !(value instanceof Float32Array) && !(value instanceof Uint16Array) || value.length !== vertexCount * components) {
+        return err(
+          failure(
+            sourceKey,
+            `${attribute.key} cardinality=${vertexCount * components}`,
+            `${attribute.key} cardinality=${value?.byteLength ?? "missing"}`
+          )
+        );
+      }
+    }
+    const interleaved = new Uint8Array(vertexCount * projection.arrayStride);
+    const interleavedView = new DataView(interleaved.buffer);
+    for (const attribute of projection.attributes) {
+      const value = attributes[attribute.key];
+      if (value === void 0) continue;
+      const components = attribute.byteLength / (attribute.format === "uint16x4" ? 2 : 4);
+      for (let vertex = 0; vertex < vertexCount; vertex++) {
+        for (let component = 0; component < components; component++) {
+          const sourceIndex = vertex * components + component;
+          const targetOffset = vertex * projection.arrayStride + attribute.offset + component * (attribute.format === "uint16x4" ? 2 : 4);
+          if (attribute.format === "uint16x4") {
+            interleavedView.setUint16(targetOffset, value[sourceIndex] ?? 0, true);
+          } else {
+            interleavedView.setFloat32(
+              targetOffset,
+              value[sourceIndex] ?? 0,
+              true
+            );
+          }
+        }
+      }
+    }
+    const indexCount = indices?.length ?? 0;
+    const indexWidth = indices === void 0 || indexCount === 0 ? 0 : indices.BYTES_PER_ELEMENT;
+    const indexBytes = indexCount * indexWidth;
+    if (!Number.isSafeInteger(indexBytes) || indexBytes > 4294967295) {
+      return err(failure(sourceKey, "safe index payload byte length", `indexBytes=${indexBytes}`));
+    }
+    const meta = new TextEncoder().encode(JSON.stringify(refsMeta(payload, refs)));
+    const header = {
+      version: 4,
+      projectionVersion: projection.schemaVersion,
+      mask: projection.mask,
+      digest: projection.digest,
+      stride: projection.arrayStride,
+      vertexCount,
+      vertexBytes: interleaved.byteLength,
+      indexCount,
+      indexWidth,
+      indexBytes,
+      jsonBytes: meta.byteLength
+    };
+    const total = MESH_BIN_HEADER_V4_BYTES + interleaved.byteLength + indexBytes + meta.byteLength;
+    if (!Number.isSafeInteger(total) || total > 4294967295) {
+      return err(failure(sourceKey, "safe mesh binary byte length", `total=${total}`));
+    }
+    const out = new Uint8Array(total);
+    writeMeshBinHeader(header, out);
+    let offset = MESH_BIN_HEADER_V4_BYTES;
+    out.set(interleaved, offset);
+    offset += interleaved.byteLength;
+    if (indices !== void 0 && indexBytes > 0) {
+      out.set(new Uint8Array(indices.buffer, indices.byteOffset, indices.byteLength), offset);
+      offset += indexBytes;
+    }
+    out.set(meta, offset);
+    return ok(out);
+  } catch (error) {
+    return err(
+      failure(
+        sourceKey,
+        "valid canonical mesh payload",
+        error instanceof Error ? error.message : String(error)
+      )
+    );
+  }
+}
+
+export { packMeshBinV4 };
+//# sourceMappingURL=mesh-bin.mjs.map
+//# sourceMappingURL=mesh-bin.mjs.map

package/dist/mesh-bin.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/mesh-bin.ts"],"names":[],"mappings":"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","file":"mesh-bin.mjs","sourcesContent":["import { deriveVertexLayoutProjection } from '@forgeax/engine-geometry';\nimport { AssetGuid } from '@forgeax/engine-pack/guid';\nimport {\n  MESH_BIN_HEADER_V4_BYTES,\n  type MeshBinContractError,\n  type MeshBinHeaderV4,\n  writeMeshBinHeader,\n} from '@forgeax/engine-pack/mesh-bin-contract';\nimport {\n  err,\n  type MeshAsset,\n  ok,\n  type Result,\n  type VertexAttributeMap,\n} from '@forgeax/engine-types';\n\ntype MeshPayloadIn = { readonly [Key in keyof MeshAsset]?: MeshAsset[Key] | undefined } & {\n  readonly vertexCount?: number;\n};\n\nexport type MeshBinEncodeError =\n  | MeshBinContractError\n  | {\n      readonly code: 'mesh-bin-payload-invalid';\n      readonly subject: 'mesh-bin';\n      readonly sourceKey: string;\n      readonly expected: string;\n      readonly actual: string;\n      readonly recovery: string;\n    };\n\nfunction failure(sourceKey: string, expected: string, actual: string): MeshBinEncodeError {\n  return {\n    code: 'mesh-bin-payload-invalid',\n    subject: 'mesh-bin',\n    sourceKey,\n    expected,\n    actual,\n    recovery: 're-cook the source with its Meta sidecar through the build-time importer',\n  };\n}\n\nfunction asAttributeMap(value: unknown): VertexAttributeMap {\n  return (value ?? {}) as VertexAttributeMap;\n}\n\nfunction jsonValue(value: unknown): unknown {\n  if (value instanceof Float32Array || value instanceof Uint16Array) return Array.from(value);\n  if (Array.isArray(value)) return value.map(jsonValue);\n  if (value !== null && typeof value === 'object') {\n    return Object.fromEntries(\n      Object.entries(value).map(([key, nested]) => [key, jsonValue(nested)]),\n    );\n  }\n  return value;\n}\n\nfunction refsMeta(payload: MeshPayloadIn, refs: readonly string[]): Record<string, unknown> {\n  const materialSlots = (payload.materialSlots ?? [{ slotName: 'Default' }]).map(\n    (slot, slotIndex) => {\n      const defaultMaterial = slot.defaultMaterial;\n      let defaultMaterialRef: number | undefined;\n      if (defaultMaterial !== undefined) {\n        const guid = AssetGuid.format(defaultMaterial);\n        defaultMaterialRef = refs.findIndex((candidate) => candidate.toLowerCase() === guid);\n        if (defaultMaterialRef < 0) {\n          throw new Error(\n            `material slot ${slotIndex} default material ${guid} is absent from refs`,\n          );\n        }\n      }\n      return {\n        slotName: slot.slotName,\n        ...(slot.sourceKey === undefined ? {} : { sourceKey: slot.sourceKey }),\n        ...(defaultMaterialRef === undefined ? {} : { defaultMaterialRef }),\n      };\n    },\n  );\n  return {\n    submeshes:\n      payload.submeshes === undefined || payload.submeshes.length === 0\n        ? [{ indexOffset: 0, indexCount: payload.indices?.length ?? 0, materialSlot: 0 }]\n        : payload.submeshes,\n    materialSlots,\n    ...(payload.aabb === undefined ? {} : { aabb: jsonValue(payload.aabb) }),\n    ...(payload.morphTargets === undefined\n      ? {}\n      : { morphTargets: jsonValue(payload.morphTargets) }),\n    ...(payload.morphWeights === undefined\n      ? {}\n      : { morphWeights: jsonValue(payload.morphWeights) }),\n  };\n}\n\n/** Encode one canonical v4 mesh binary. No legacy version is accepted or emitted. */\nexport function packMeshBinV4(\n  payload: MeshPayloadIn,\n  sourceKey: string,\n  refs: readonly string[] = [],\n): Result<Uint8Array, MeshBinEncodeError> {\n  try {\n    const vertices = payload.vertices;\n    const indices = payload.indices;\n    if (!(vertices instanceof Float32Array)) {\n      return err(\n        failure(sourceKey, 'Float32Array interleaved vertices', 'vertices is not Float32Array'),\n      );\n    }\n    if (\n      indices !== undefined &&\n      !(indices instanceof Uint16Array || indices instanceof Uint32Array)\n    ) {\n      return err(\n        failure(sourceKey, 'Uint16Array or Uint32Array indices', 'indices has an unsupported type'),\n      );\n    }\n    const attributes = asAttributeMap(payload.attributes);\n    const projection = deriveVertexLayoutProjection(attributes);\n    if (projection.attributes.length === 0 || projection.arrayStride === 0) {\n      return err(\n        failure(\n          sourceKey,\n          'a non-empty canonical geometry projection',\n          'projection has no attributes',\n        ),\n      );\n    }\n    const vertexCount = payload.vertexCount ?? vertices.byteLength / projection.arrayStride;\n    if (!Number.isSafeInteger(vertexCount) || vertexCount < 0) {\n      return err(\n        failure(sourceKey, 'a non-negative safe vertex cardinality', `vertexCount=${vertexCount}`),\n      );\n    }\n    if (vertices.byteLength !== vertexCount * projection.arrayStride) {\n      return err(\n        failure(\n          sourceKey,\n          `vertices.byteLength=${vertexCount * projection.arrayStride}`,\n          `vertices.byteLength=${vertices.byteLength}; stride=${projection.arrayStride}`,\n        ),\n      );\n    }\n    for (const attribute of projection.attributes) {\n      const value = attributes[attribute.key];\n      const components = attribute.byteLength / (attribute.format === 'uint16x4' ? 2 : 4);\n      if (\n        value === undefined ||\n        (!(value instanceof Float32Array) && !(value instanceof Uint16Array)) ||\n        value.length !== vertexCount * components\n      ) {\n        return err(\n          failure(\n            sourceKey,\n            `${attribute.key} cardinality=${vertexCount * components}`,\n            `${attribute.key} cardinality=${value?.byteLength ?? 'missing'}`,\n          ),\n        );\n      }\n    }\n    const interleaved = new Uint8Array(vertexCount * projection.arrayStride);\n    const interleavedView = new DataView(interleaved.buffer);\n    for (const attribute of projection.attributes) {\n      const value = attributes[attribute.key];\n      if (value === undefined) continue;\n      const components = attribute.byteLength / (attribute.format === 'uint16x4' ? 2 : 4);\n      for (let vertex = 0; vertex < vertexCount; vertex++) {\n        for (let component = 0; component < components; component++) {\n          const sourceIndex = vertex * components + component;\n          const targetOffset =\n            vertex * projection.arrayStride +\n            attribute.offset +\n            component * (attribute.format === 'uint16x4' ? 2 : 4);\n          if (attribute.format === 'uint16x4') {\n            interleavedView.setUint16(targetOffset, (value as Uint16Array)[sourceIndex] ?? 0, true);\n          } else {\n            interleavedView.setFloat32(\n              targetOffset,\n              (value as Float32Array)[sourceIndex] ?? 0,\n              true,\n            );\n          }\n        }\n      }\n    }\n    const indexCount = indices?.length ?? 0;\n    const indexWidth = indices === undefined || indexCount === 0 ? 0 : indices.BYTES_PER_ELEMENT;\n    const indexBytes = indexCount * indexWidth;\n    if (!Number.isSafeInteger(indexBytes) || indexBytes > 0xffffffff) {\n      return err(failure(sourceKey, 'safe index payload byte length', `indexBytes=${indexBytes}`));\n    }\n    const meta = new TextEncoder().encode(JSON.stringify(refsMeta(payload, refs)));\n    const header: MeshBinHeaderV4 = {\n      version: 4,\n      projectionVersion: projection.schemaVersion,\n      mask: projection.mask,\n      digest: projection.digest,\n      stride: projection.arrayStride,\n      vertexCount,\n      vertexBytes: interleaved.byteLength,\n      indexCount,\n      indexWidth: indexWidth as 0 | 2 | 4,\n      indexBytes,\n      jsonBytes: meta.byteLength,\n    };\n    const total = MESH_BIN_HEADER_V4_BYTES + interleaved.byteLength + indexBytes + meta.byteLength;\n    if (!Number.isSafeInteger(total) || total > 0xffffffff) {\n      return err(failure(sourceKey, 'safe mesh binary byte length', `total=${total}`));\n    }\n    const out = new Uint8Array(total);\n    writeMeshBinHeader(header, out);\n    let offset = MESH_BIN_HEADER_V4_BYTES;\n    out.set(interleaved, offset);\n    offset += interleaved.byteLength;\n    if (indices !== undefined && indexBytes > 0) {\n      out.set(new Uint8Array(indices.buffer, indices.byteOffset, indices.byteLength), offset);\n      offset += indexBytes;\n    }\n    out.set(meta, offset);\n    return ok(out);\n  } catch (error) {\n    return err(\n      failure(\n        sourceKey,\n        'valid canonical mesh payload',\n        error instanceof Error ? error.message : String(error),\n      ),\n    );\n  }\n}\n"]}

package/dist/pack-projection.d.ts

@@ -0,0 +1,5 @@
+import type { ImportProduct } from '@forgeax/engine-types';
+import { type DdcPack } from './import-runner.js';
+/** Project one validated import product into the canonical Pack v2 payload. */
+export declare function projectImportProductForBuild(product: Pick<ImportProduct<unknown>, 'assets'>): DdcPack;
+//# sourceMappingURL=pack-projection.d.ts.map

package/dist/pack-projection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pack-projection.d.ts","sourceRoot":"","sources":["../src/pack-projection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAE3D,OAAO,EAAE,KAAK,OAAO,EAAoB,MAAM,oBAAoB,CAAC;AAEpE,+EAA+E;AAC/E,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,GAC9C,OAAO,CAaT"}

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

@@ -0,0 +1,72 @@
+import { type AuthoredPackInput, finalizePackageTransportSource, type PackageFinalizePolicy } from '@forgeax/engine-pack/build';
+import { type NativeCooker } from '@forgeax/engine-pack/native-cooker';
+import type { ScanSourceDeclaration } from '@forgeax/engine-pack/scanner';
+import { type ScriptablePackDefinition, type ScriptablePackSourceClosureEntry } from '@forgeax/engine-pack/source';
+import type { AssetGuid as AssetGuidType, AssetPublicationEnvelope, AssetPublicationOutput, ResourceRevision, Result } from '@forgeax/engine-types';
+import type { DdcPack, ImportRunnerFs } from './import-runner.js';
+import type { ImporterRegistry } from './importer-registry.js';
+import type { ScriptablePackDomainError, ScriptablePackStagedOutput } from './scriptable-pack.js';
+import { type ScriptableSourcePackageProduct, type ScriptableSourcePackageResult } from './scriptable-source-package.js';
+type FinalizedPackageTransport = Awaited<ReturnType<typeof finalizePackageTransportSource>>;
+export interface ScriptablePackInput {
+    readonly sourcePath: string;
+    readonly displaySourcePath: string;
+    readonly definition: Readonly<ScriptablePackDefinition>;
+    readonly sourceClosure: readonly ScriptablePackSourceClosureEntry[];
+    readonly publicationGeneration: number;
+    readonly policy: ScriptablePackTransportPolicy;
+}
+export interface ScriptablePackPublicationFacts {
+    readonly outputs: readonly AssetPublicationOutput[];
+    readonly refs: ReadonlyMap<string, readonly string[]>;
+}
+export interface PreparedScriptablePack {
+    readonly product: ScriptableSourcePackageProduct;
+    readonly finalized: FinalizedPackageTransport;
+    readonly facts: ScriptablePackPublicationFacts;
+    readonly revision: ResourceRevision;
+    readonly publication: AssetPublicationEnvelope;
+}
+export interface ScriptablePackTransportPaths {
+    readonly packagePath: string;
+    readonly artifactPath: (path: string) => string;
+    readonly receiptPath: (guid: string) => string;
+}
+export interface ScriptablePackTransportSink {
+    writePackage(path: string, body: string): void | Promise<void>;
+    writeArtifact(path: string, bytes: Uint8Array, mimeType: string): void | Promise<void>;
+    writeReceipt(path: string, body: string): void | Promise<void>;
+}
+export type ScriptablePackTransportPolicy = PackageFinalizePolicy | ((product: ScriptableSourcePackageProduct) => PackageFinalizePolicy);
+type ScriptablePackHostError = ScriptableSourcePackageResult extends Result<unknown, infer E> ? E : never;
+export interface CookedAuthoredPack {
+    readonly logicalPackage: DdcPack;
+    readonly refsByGuid: ReadonlyMap<string, readonly string[]>;
+}
+export interface AuthoredPackTransport {
+    readonly pack: AuthoredPackInput;
+    readonly firstGuid?: string;
+    readonly cooked?: CookedAuthoredPack;
+    readonly finalized?: FinalizedPackageTransport;
+}
+/** Build-time capabilities required to expose ordinary Meta products to a ScriptablePack. */
+export interface ScriptablePackExternalImportOptions {
+    readonly importerRegistry: ImporterRegistry;
+    readonly fsForImport: ImportRunnerFs;
+    /** Package path aliases from forgeax.assets.paths; defaults to the current project config. */
+    readonly assetPaths?: Readonly<Record<string, string>>;
+}
+export declare function canonicalScriptableSourcePath(sourcePath: string): string;
+export declare function scriptablePackInputs(sourcePaths: readonly string[], declarations: ReadonlyMap<string, ScanSourceDeclaration>, cwd: string, generationFor: (displaySourcePath: string) => number, policyFor: (displaySourcePath: string) => ScriptablePackTransportPolicy): ScriptablePackInput[];
+/** Materialize one accepted ScriptablePack without duplicating dev/build loops. */
+export declare function materializePreparedScriptablePack(prepared: PreparedScriptablePack, paths: ScriptablePackTransportPaths, sink: ScriptablePackTransportSink): Promise<ReadonlyMap<string, string>>;
+export declare function readCookedAuthoredPack(authoredPack: AuthoredPackInput, cookers?: readonly NativeCooker[], sourcePath?: string): Promise<CookedAuthoredPack | undefined>;
+export declare function declaredPackExternalOutputs(declarations: ReadonlyMap<string, ScanSourceDeclaration>, cookers?: readonly NativeCooker[], requiredGuids?: readonly AssetGuidType[], externalImport?: ScriptablePackExternalImportOptions): Promise<readonly ScriptablePackStagedOutput[]>;
+/** Normalize one authored Pack and, when needed, run its registered cooker once. */
+export declare function prepareAuthoredPackTransport(authoredPack: AuthoredPackInput, cookers: readonly NativeCooker[] | undefined, policyFor: (guid: string) => PackageFinalizePolicy, sourcePath?: string): Promise<AuthoredPackTransport>;
+/** Project one produced ScriptablePack into the publication tuple shared by dev and build. */
+export declare function projectScriptablePackPublication(product: ScriptableSourcePackageProduct): Result<ScriptablePackPublicationFacts, ScriptablePackDomainError>;
+/** Produce selected ScriptablePacks through one inventory and one staged owner boundary. */
+export declare function produceScriptablePackProducts(sources: readonly ScriptablePackInput[], declaredExternalOutputs?: readonly ScriptablePackStagedOutput[]): Promise<Result<ReadonlyMap<string, PreparedScriptablePack>, ScriptablePackHostError>>;
+export {};
+//# sourceMappingURL=scriptable-pack-host.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scriptable-pack-host.d.ts","sourceRoot":"","sources":["../src/scriptable-pack-host.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,KAAK,iBAAiB,EACtB,8BAA8B,EAE9B,KAAK,qBAAqB,EAG3B,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EAAE,KAAK,YAAY,EAAwB,MAAM,oCAAoC,CAAC;AAC7F,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAC1E,OAAO,EAEL,KAAK,wBAAwB,EAC7B,KAAK,gCAAgC,EACtC,MAAM,6BAA6B,CAAC;AAErC,OAAO,KAAK,EAEV,SAAS,IAAI,aAAa,EAC1B,wBAAwB,EACxB,sBAAsB,EACtB,gBAAgB,EAChB,MAAM,EACP,MAAM,uBAAuB,CAAC;AAE/B,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAiB,MAAM,oBAAoB,CAAC;AACjF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE/D,OAAO,KAAK,EAAE,yBAAyB,EAAE,0BAA0B,EAAE,MAAM,sBAAsB,CAAC;AAMlG,OAAO,EAEL,KAAK,8BAA8B,EACnC,KAAK,6BAA6B,EACnC,MAAM,gCAAgC,CAAC;AAGxC,KAAK,yBAAyB,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,8BAA8B,CAAC,CAAC,CAAC;AAE5F,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,wBAAwB,CAAC,CAAC;IACxD,QAAQ,CAAC,aAAa,EAAE,SAAS,gCAAgC,EAAE,CAAC;IACpE,QAAQ,CAAC,qBAAqB,EAAE,MAAM,CAAC;IACvC,QAAQ,CAAC,MAAM,EAAE,6BAA6B,CAAC;CAChD;AAED,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,OAAO,EAAE,SAAS,sBAAsB,EAAE,CAAC;IACpD,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAAC;CACvD;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,OAAO,EAAE,8BAA8B,CAAC;IACjD,QAAQ,CAAC,SAAS,EAAE,yBAAyB,CAAC;IAC9C,QAAQ,CAAC,KAAK,EAAE,8BAA8B,CAAC;IAC/C,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;IACpC,QAAQ,CAAC,WAAW,EAAE,wBAAwB,CAAC;CAChD;AAED,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,YAAY,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IAChD,QAAQ,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;CAChD;AAED,MAAM,WAAW,2BAA2B;IAC1C,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/D,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvF,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAChE;AAED,MAAM,MAAM,6BAA6B,GACrC,qBAAqB,GACrB,CAAC,CAAC,OAAO,EAAE,8BAA8B,KAAK,qBAAqB,CAAC,CAAC;AAEzE,KAAK,uBAAuB,GAC1B,6BAA6B,SAAS,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;AAE7E,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,UAAU,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAAC;CAC7D;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;IACjC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,kBAAkB,CAAC;IACrC,QAAQ,CAAC,SAAS,CAAC,EAAE,yBAAyB,CAAC;CAChD;AAED,6FAA6F;AAC7F,MAAM,WAAW,mCAAmC;IAClD,QAAQ,CAAC,gBAAgB,EAAE,gBAAgB,CAAC;IAC5C,QAAQ,CAAC,WAAW,EAAE,cAAc,CAAC;IACrC,8FAA8F;IAC9F,QAAQ,CAAC,UAAU,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACxD;AAED,wBAAgB,6BAA6B,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAKxE;AAED,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,SAAS,MAAM,EAAE,EAC9B,YAAY,EAAE,WAAW,CAAC,MAAM,EAAE,qBAAqB,CAAC,EACxD,GAAG,EAAE,MAAM,EACX,aAAa,EAAE,CAAC,iBAAiB,EAAE,MAAM,KAAK,MAAM,EACpD,SAAS,EAAE,CAAC,iBAAiB,EAAE,MAAM,KAAK,6BAA6B,GACtE,mBAAmB,EAAE,CAgBvB;AAED,mFAAmF;AACnF,wBAAsB,iCAAiC,CACrD,QAAQ,EAAE,sBAAsB,EAChC,KAAK,EAAE,4BAA4B,EACnC,IAAI,EAAE,2BAA2B,GAChC,OAAO,CAAC,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CA0BtC;AAED,wBAAsB,sBAAsB,CAC1C,YAAY,EAAE,iBAAiB,EAC/B,OAAO,GAAE,SAAS,YAAY,EAAO,EACrC,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,kBAAkB,GAAG,SAAS,CAAC,CAsDzC;AAED,wBAAsB,2BAA2B,CAC/C,YAAY,EAAE,WAAW,CAAC,MAAM,EAAE,qBAAqB,CAAC,EACxD,OAAO,GAAE,SAAS,YAAY,EAAO,EACrC,aAAa,GAAE,SAAS,aAAa,EAAO,EAC5C,cAAc,CAAC,EAAE,mCAAmC,GACnD,OAAO,CAAC,SAAS,0BAA0B,EAAE,CAAC,CA0FhD;AAED,oFAAoF;AACpF,wBAAsB,4BAA4B,CAChD,YAAY,EAAE,iBAAiB,EAC/B,OAAO,EAAE,SAAS,YAAY,EAAE,GAAG,SAAS,EAC5C,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,qBAAqB,EAClD,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,qBAAqB,CAAC,CAchC;AAED,8FAA8F;AAC9F,wBAAgB,gCAAgC,CAC9C,OAAO,EAAE,8BAA8B,GACtC,MAAM,CAAC,8BAA8B,EAAE,yBAAyB,CAAC,CA+BnE;AAgBD,4FAA4F;AAC5F,wBAAsB,6BAA6B,CACjD,OAAO,EAAE,SAAS,mBAAmB,EAAE,EACvC,uBAAuB,GAAE,SAAS,0BAA0B,EAAO,GAClE,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC,MAAM,EAAE,sBAAsB,CAAC,EAAE,uBAAuB,CAAC,CAAC,CAyIvF"}

package/dist/scriptable-pack-output-producers.d.ts

@@ -0,0 +1,7 @@
+import type { ScriptablePackSceneComponent } from '@forgeax/engine-pack/source';
+import { type AssetOutputProducer, AssetOutputProducerRegistry } from './scriptable-pack.js';
+export declare const materialAssetOutputProducer: AssetOutputProducer;
+export declare const meshAssetOutputProducer: AssetOutputProducer;
+export declare function createSceneAssetOutputProducer(sceneComponents?: readonly ScriptablePackSceneComponent[]): AssetOutputProducer;
+export declare function createStandardAssetOutputProducerRegistry(sceneComponents?: readonly ScriptablePackSceneComponent[]): AssetOutputProducerRegistry;
+//# sourceMappingURL=scriptable-pack-output-producers.d.ts.map

package/dist/scriptable-pack-output-producers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scriptable-pack-output-producers.d.ts","sourceRoot":"","sources":["../src/scriptable-pack-output-producers.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,6BAA6B,CAAC;AA4BhF,OAAO,EAEL,KAAK,mBAAmB,EACxB,2BAA2B,EAE5B,MAAM,sBAAsB,CAAC;AA4X9B,eAAO,MAAM,2BAA2B,qBAIvC,CAAC;AACF,eAAO,MAAM,uBAAuB,qBAA2D,CAAC;AAEhG,wBAAgB,8BAA8B,CAC5C,eAAe,GAAE,SAAS,4BAA4B,EAAO,GAC5D,mBAAmB,CAKrB;AAED,wBAAgB,yCAAyC,CACvD,eAAe,GAAE,SAAS,4BAA4B,EAAO,GAC5D,2BAA2B,CAuB7B"}

package/dist/scriptable-pack-staged-snapshot.d.ts

@@ -0,0 +1,21 @@
+import type { ScriptablePackError } from '@forgeax/engine-pack/source';
+import type { AssetGuid as AssetGuidType, ImportError, Result } from '@forgeax/engine-types';
+import { AssetError } from '@forgeax/engine-types';
+import type { ScriptablePackAssetSnapshotSource, ScriptablePackDomainError, ScriptablePackStagedOutput } from './scriptable-pack.js';
+export type ScriptablePackSnapshotError = AssetError | ImportError | ScriptablePackError | ScriptablePackDomainError;
+export interface ScriptablePackStagedOwner {
+    readonly id: string;
+    readonly guids: readonly AssetGuidType[];
+    build(source: ScriptablePackAssetSnapshotSource): Promise<Result<readonly ScriptablePackStagedOutput[], ScriptablePackSnapshotError>>;
+}
+export interface ScriptablePackStagedSnapshotOptions {
+    readonly generation: number;
+    readonly owners: readonly ScriptablePackStagedOwner[];
+    readonly declaredExternalOutputs?: readonly ScriptablePackStagedOutput[];
+}
+/**
+ * One-build authority for current-generation ScriptablePack content reads.
+ * Local owners are built lazily, memoized, and never resolved through an old Catalog/DDC generation.
+ */
+export declare function createScriptablePackStagedAssetSnapshotSource(options: ScriptablePackStagedSnapshotOptions): ScriptablePackAssetSnapshotSource;
+//# sourceMappingURL=scriptable-pack-staged-snapshot.d.ts.map

package/dist/scriptable-pack-staged-snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scriptable-pack-staged-snapshot.d.ts","sourceRoot":"","sources":["../src/scriptable-pack-staged-snapshot.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AACvE,OAAO,KAAK,EAAS,SAAS,IAAI,aAAa,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AACpG,OAAO,EAAE,UAAU,EAAW,MAAM,uBAAuB,CAAC;AAC5D,OAAO,KAAK,EAEV,iCAAiC,EACjC,yBAAyB,EACzB,0BAA0B,EAC3B,MAAM,sBAAsB,CAAC;AAE9B,MAAM,MAAM,2BAA2B,GACnC,UAAU,GACV,WAAW,GACX,mBAAmB,GACnB,yBAAyB,CAAC;AAE9B,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,SAAS,aAAa,EAAE,CAAC;IACzC,KAAK,CACH,MAAM,EAAE,iCAAiC,GACxC,OAAO,CAAC,MAAM,CAAC,SAAS,0BAA0B,EAAE,EAAE,2BAA2B,CAAC,CAAC,CAAC;CACxF;AAED,MAAM,WAAW,mCAAmC;IAClD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,SAAS,yBAAyB,EAAE,CAAC;IACtD,QAAQ,CAAC,uBAAuB,CAAC,EAAE,SAAS,0BAA0B,EAAE,CAAC;CAC1E;AA8CD;;;GAGG;AACH,wBAAgB,6CAA6C,CAC3D,OAAO,EAAE,mCAAmC,GAC3C,iCAAiC,CA0FnC"}

package/dist/scriptable-pack.d.ts

@@ -0,0 +1,141 @@
+import { type ScriptablePackAssetKind } from '@forgeax/engine-pack';
+import { type ScriptablePackDefinition, type ScriptablePackError, type ScriptablePackReadError, type ScriptablePackSourceClosureEntry } from '@forgeax/engine-pack/source';
+import type { AnimationGraph, Asset, AssetGuid as AssetGuidType, AssetPublicationEnvelope, FontAsset, MaterialAsset, MeshAsset, Result, TilesetAsset } from '@forgeax/engine-types';
+export type { ScriptablePackSourceClosureEntry } from '@forgeax/engine-pack/source';
+import { AssetError, ImportError } from '@forgeax/engine-types';
+import { type ImportAssetProduct, type TerminalImportProduct } from './import-product.js';
+export interface ScriptablePackAssetSnapshot {
+    readonly asset: Asset;
+    readonly generation: number;
+    readonly digest: string;
+}
+export interface ScriptablePackStagedOutput {
+    readonly guid: AssetGuidType;
+    /** Producer-owned stable output identity from the ScriptablePack definition. */
+    readonly sourceKey?: string;
+    readonly asset: Asset;
+    readonly digest?: string;
+}
+export interface ScriptablePackAssetSnapshotSource {
+    readByGuid(guid: AssetGuidType): Promise<Result<ScriptablePackAssetSnapshot, ScriptablePackReadError>>;
+}
+export interface AssetOutputInput {
+    readonly guid: string;
+    readonly sourceKey: string;
+    readonly asset: Asset;
+}
+type MaterialPackPayload = Omit<MaterialAsset, 'parent' | 'values'> & {
+    readonly parent?: number;
+    readonly values?: Readonly<Record<string, unknown>>;
+};
+type ScenePackPayload = {
+    readonly kind: 'scene';
+    readonly [key: string]: unknown;
+};
+type FontPackPayload = Omit<FontAsset, 'atlas' | 'sampler'> & {
+    readonly atlasGuid: string;
+    readonly samplerGuid: string;
+};
+type TilesetPackPayload = Omit<TilesetAsset, 'atlases'> & {
+    readonly atlases: readonly number[];
+};
+type AnimationGraphPackPayload = Omit<AnimationGraph, 'nodes'> & {
+    readonly nodes: readonly (Exclude<AnimationGraph['nodes'][number], {
+        readonly type: 'clip';
+    }> | (Omit<Extract<AnimationGraph['nodes'][number], {
+        readonly type: 'clip';
+    }>, 'clip'> & {
+        readonly clip: number;
+    }))[];
+};
+/** Serialized Pack projection; durable runtime Assets never carry ref indices. */
+export type AssetOutputPayloadByKind = {
+    readonly mesh: MeshAsset;
+    readonly material: MaterialPackPayload;
+    readonly scene: ScenePackPayload;
+    readonly texture: Extract<Asset, {
+        readonly kind: 'texture';
+    }>;
+    readonly equirect: Extract<Asset, {
+        readonly kind: 'equirect';
+    }>;
+    readonly sampler: Extract<Asset, {
+        readonly kind: 'sampler';
+    }>;
+    readonly font: FontPackPayload;
+    readonly 'render-pipeline': Extract<Asset, {
+        readonly kind: 'render-pipeline';
+    }>;
+    readonly tileset: TilesetPackPayload;
+    readonly video: Extract<Asset, {
+        readonly kind: 'video';
+    }>;
+    readonly skeleton: Extract<Asset, {
+        readonly kind: 'skeleton';
+    }>;
+    readonly skin: Extract<Asset, {
+        readonly kind: 'skin';
+    }>;
+    readonly 'animation-clip': Extract<Asset, {
+        readonly kind: 'animation-clip';
+    }>;
+    readonly 'animation-graph': AnimationGraphPackPayload;
+    readonly audio: Extract<Asset, {
+        readonly kind: 'audio';
+    }>;
+    readonly 'particle-effect': Extract<Asset, {
+        readonly kind: 'particle-effect';
+    }>;
+};
+export type AssetOutputPayload = AssetOutputPayloadByKind[ScriptablePackAssetKind];
+export type AssetOutputProduct = ImportAssetProduct<AssetOutputPayload>;
+export interface AssetOutputProducer {
+    readonly kind: string;
+    readonly version: string;
+    produce(input: AssetOutputInput): Result<AssetOutputProduct, ImportError> | Promise<Result<AssetOutputProduct, ImportError>>;
+}
+export declare class AssetOutputProducerRegistry {
+    private readonly producers;
+    register(producer: AssetOutputProducer): void;
+    get(kind: string): AssetOutputProducer | undefined;
+    versions(): Readonly<Record<string, string>>;
+}
+export type ScriptablePackExternalUsage = 'reference' | 'content' | 'both';
+export interface ScriptablePackExternalEvidence {
+    readonly guid: string;
+    readonly usage: ScriptablePackExternalUsage;
+    readonly generation?: number;
+    readonly digest?: string;
+}
+export interface ScriptablePackBuildProduct {
+    readonly product: TerminalImportProduct<unknown>;
+    /** Raw private outputs for the current staged build generation, never a runtime publication path. */
+    readonly stagedOutputs: readonly ScriptablePackStagedOutput[];
+    readonly externalEvidence: readonly ScriptablePackExternalEvidence[];
+    readonly inputFingerprint: string;
+    /** Engine publication fields projected after ordinary producers run. */
+    readonly publication?: AssetPublicationEnvelope;
+}
+/** Domain-owned structured failure transported without flattening its recovery fields. */
+export interface ScriptablePackDomainError {
+    readonly code: string;
+    readonly expected: string;
+    readonly hint: string;
+    readonly detail?: unknown;
+}
+export type ScriptablePackBuildBridgeResult = Result<ScriptablePackBuildProduct, ScriptablePackError | AssetError | ImportError | ScriptablePackDomainError>;
+export interface BuildScriptablePackOptions {
+    readonly definition: ScriptablePackDefinition;
+    readonly sourcePath: string;
+    readonly assetSource?: ScriptablePackAssetSnapshotSource;
+    readonly outputs: AssetOutputProducerRegistry;
+    readonly sourceClosure: readonly ScriptablePackSourceClosureEntry[];
+    readonly authoringContractVersion: string;
+}
+/**
+ * Build one external ScriptablePack through the producer-owned Pack bridge.
+ * Success preserves payloads, GUID refs, and local artifacts; failure retains
+ * `code`, `expected`, `hint`, and `detail` for recovery by the caller.
+ */
+export declare function buildScriptablePack(options: BuildScriptablePackOptions): Promise<ScriptablePackBuildBridgeResult>;
+//# sourceMappingURL=scriptable-pack.d.ts.map

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

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

package/dist/scriptable-source-package.d.ts

@@ -0,0 +1,14 @@
+import { type ScriptablePackError } from '@forgeax/engine-pack/source';
+import type { AssetError, ImportError, ImportProduct, Result } from '@forgeax/engine-types';
+import { type BuildScriptablePackOptions, type ScriptablePackDomainError, type ScriptablePackExternalEvidence, type ScriptablePackStagedOutput } from './scriptable-pack.js';
+export interface ScriptableSourcePackageProduct {
+    readonly anchorGuid: string;
+    readonly declaredGuids: readonly string[];
+    readonly product: ImportProduct<unknown>;
+    readonly inputFingerprint: string;
+    readonly externalEvidence: readonly ScriptablePackExternalEvidence[];
+    readonly stagedOutputs: readonly ScriptablePackStagedOutput[];
+}
+export type ScriptableSourcePackageResult = Result<ScriptableSourcePackageProduct, ScriptablePackError | AssetError | ImportError | ScriptablePackDomainError>;
+export declare function produceScriptableSourcePackage(options: BuildScriptablePackOptions): Promise<ScriptableSourcePackageResult>;
+//# sourceMappingURL=scriptable-source-package.d.ts.map

package/dist/scriptable-source-package.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scriptable-source-package.d.ts","sourceRoot":"","sources":["../src/scriptable-source-package.ts"],"names":[],"mappings":"AACA,OAAO,EAA6B,KAAK,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAClG,OAAO,KAAK,EACV,UAAU,EACV,WAAW,EAEX,aAAa,EACb,MAAM,EACP,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,KAAK,0BAA0B,EAE/B,KAAK,yBAAyB,EAC9B,KAAK,8BAA8B,EACnC,KAAK,0BAA0B,EAChC,MAAM,sBAAsB,CAAC;AAI9B,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1C,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;IACzC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,gBAAgB,EAAE,SAAS,8BAA8B,EAAE,CAAC;IACrE,QAAQ,CAAC,aAAa,EAAE,SAAS,0BAA0B,EAAE,CAAC;CAC/D;AAED,MAAM,MAAM,6BAA6B,GAAG,MAAM,CAChD,8BAA8B,EAC9B,mBAAmB,GAAG,UAAU,GAAG,WAAW,GAAG,yBAAyB,CAC3E,CAAC;AAyBF,wBAAsB,8BAA8B,CAClD,OAAO,EAAE,0BAA0B,GAClC,OAAO,CAAC,6BAA6B,CAAC,CA4BxC"}

package/dist/source-package-errors.d.ts

@@ -0,0 +1,52 @@
+declare const SOURCE_PACKAGE_ERROR_POLICY: {
+    readonly 'source-package-meta-invalid': {
+        readonly expected: "a valid source Meta declaration with complete GUID topology";
+        readonly hint: "repair the Meta declaration, then rebuild or cold-cook the source package";
+    };
+    readonly 'source-package-importer-missing': {
+        readonly expected: "a registered importer for the source Meta importer key";
+        readonly hint: "register the named importer, then rebuild or cold-cook the source package";
+    };
+    readonly 'source-package-conversion-failed': {
+        readonly expected: "the configured importer to convert the source successfully";
+        readonly hint: "repair the source or importer, then rebuild or cold-cook the source package";
+    };
+    readonly 'source-package-ddc-failed': {
+        readonly expected: "a readable persistent DDC entry with matching integrity evidence";
+        readonly hint: "discard the invalid derived entry, then rebuild or cold-cook the source package";
+    };
+    readonly 'source-package-publication-invalid': {
+        readonly expected: "a complete Pack body, refs, artifacts, and route integrity";
+        readonly hint: "repair the missing product bytes, then rebuild or cold-cook the source package";
+    };
+    readonly 'source-package-guid-closure-mismatch': {
+        readonly expected: "exactly one produced asset for every declared GUID";
+        readonly hint: "repair the Meta topology or importer output, then rebuild the whole source package";
+    };
+};
+export type SourcePackageErrorCode = keyof typeof SOURCE_PACKAGE_ERROR_POLICY;
+export type SourcePackageErrorStage = 'meta' | 'importer' | 'conversion' | 'closure' | 'ddc' | 'route-integrity';
+export interface SourcePackageErrorContext {
+    readonly sourceMeta: string;
+    readonly anchorGuid: string;
+    readonly affectedGuids: readonly string[];
+    readonly producer: string;
+    readonly importer: string;
+}
+export interface SourcePackageErrorDetail extends SourcePackageErrorContext {
+    readonly stage: SourcePackageErrorStage;
+    readonly reason?: string;
+    readonly missing?: readonly string[];
+    readonly unexpected?: readonly string[];
+    readonly registeredImporters?: readonly string[];
+}
+export interface SourcePackageError {
+    readonly code: SourcePackageErrorCode;
+    readonly expected: string;
+    readonly hint: string;
+    readonly detail: SourcePackageErrorDetail;
+}
+export declare function sourcePackageError(code: SourcePackageErrorCode, context: SourcePackageErrorContext, detail: Omit<SourcePackageErrorDetail, keyof SourcePackageErrorContext>): SourcePackageError;
+export declare function normalizeSourcePackageError(error: unknown, context: SourcePackageErrorContext): SourcePackageError;
+export {};
+//# sourceMappingURL=source-package-errors.d.ts.map

package/dist/source-package-errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-package-errors.d.ts","sourceRoot":"","sources":["../src/source-package-errors.ts"],"names":[],"mappings":"AAEA,QAAA,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;CAyBvB,CAAC;AAEX,MAAM,MAAM,sBAAsB,GAAG,MAAM,OAAO,2BAA2B,CAAC;AAE9E,MAAM,MAAM,uBAAuB,GAC/B,MAAM,GACN,UAAU,GACV,YAAY,GACZ,SAAS,GACT,KAAK,GACL,iBAAiB,CAAC;AAEtB,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,wBAAyB,SAAQ,yBAAyB;IACzE,QAAQ,CAAC,KAAK,EAAE,uBAAuB,CAAC;IACxC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAClD;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,sBAAsB,CAAC;IACtC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,wBAAwB,CAAC;CAC3C;AAED,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,sBAAsB,EAC5B,OAAO,EAAE,yBAAyB,EAClC,MAAM,EAAE,IAAI,CAAC,wBAAwB,EAAE,MAAM,yBAAyB,CAAC,GACtE,kBAAkB,CAQpB;AA8CD,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,yBAAyB,GACjC,kBAAkB,CAuBpB"}