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

package/dist/material/artifact-writer.d.ts

@@ -0,0 +1,14 @@
+export interface MaterialArtifactWriteInput {
+    readonly key: string;
+    readonly bytes: Uint8Array;
+    readonly mediaType?: string;
+}
+export interface MaterialArtifactWriteResult {
+    readonly key: string;
+    readonly bytes: Uint8Array;
+    readonly mediaType: string;
+    readonly digest: string;
+}
+/** Pack owns the immutable cooked material artifact tuple. */
+export declare function writeMaterialArtifact(input: MaterialArtifactWriteInput): MaterialArtifactWriteResult;
+//# sourceMappingURL=artifact-writer.d.ts.map

package/dist/material/artifact-writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact-writer.d.ts","sourceRoot":"","sources":["../../src/material/artifact-writer.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,8DAA8D;AAC9D,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,0BAA0B,GAChC,2BAA2B,CAO7B"}

package/dist/material-cook.d.ts

@@ -0,0 +1,2 @@
+export { type CookedMaterialRecord, collectMaterialCookRefs, createMaterialArtifactDigest, createMaterialCookIdentity, type MaterialCookArtifact, type MaterialCookReceipt, type MaterialCookRecordError, type MaterialCookRefs, type MaterialCookWasmProvenance, projectCookedMaterialRecord, serializeCookedMaterialRecord, serializeMaterialCookReceipt, validateCookedMaterialRecord, } from './evidence/material-cook.js';
+//# sourceMappingURL=material-cook.d.ts.map

package/dist/material-cook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"material-cook.d.ts","sourceRoot":"","sources":["../src/material-cook.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,oBAAoB,EACzB,uBAAuB,EACvB,4BAA4B,EAC5B,0BAA0B,EAC1B,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACxB,KAAK,uBAAuB,EAC5B,KAAK,gBAAgB,EACrB,KAAK,0BAA0B,EAC/B,2BAA2B,EAC3B,6BAA6B,EAC7B,4BAA4B,EAC5B,4BAA4B,GAC7B,MAAM,6BAA6B,CAAC"}

package/dist/material-cook.mjs

@@ -0,0 +1,248 @@
+import { MATERIAL_TEXTURE_SLOTS, ok, err } from '@forgeax/engine-types';
+import { sha256 } from '@noble/hashes/sha2.js';
+import { bytesToHex } from '@noble/hashes/utils.js';
+
+// src/evidence/material-cook.ts
+function unique(values) {
+  return [...new Set(values)].sort();
+}
+function guidText(value) {
+  return typeof value === "string" ? value : Array.from(value, (byte) => byte.toString(16).padStart(2, "0")).join("");
+}
+function cookGuidText(value) {
+  return typeof value === "number" ? void 0 : guidText(value);
+}
+function textureValues(values, textureFields) {
+  return Object.entries(values ?? {}).flatMap(([name, value]) => {
+    if (value === null) return [];
+    if (typeof value === "string") {
+      return textureFields.has(name) ? [{ texture: value }] : [];
+    }
+    return value !== null && typeof value === "object" && !Array.isArray(value) && "texture" in value ? [value] : [];
+  });
+}
+function collectMaterialCookRefs(material) {
+  const textureFields = material.parameters === void 0 ? new Set(MATERIAL_TEXTURE_SLOTS) : new Set(
+    material.parameters.filter((parameter) => parameter.type === "texture").map((parameter) => parameter.name)
+  );
+  const textures = textureValues(material.values, textureFields);
+  return {
+    parent: material.parent ? [guidText(material.parent)] : [],
+    textures: unique(
+      textures.flatMap((value) => {
+        const guid = cookGuidText(value.texture);
+        return guid === void 0 ? [] : [guid];
+      })
+    ),
+    samplers: unique(
+      textures.flatMap((value) => {
+        if (value.sampler === void 0) return [];
+        const guid = cookGuidText(value.sampler);
+        return guid === void 0 ? [] : [guid];
+      })
+    ),
+    modules: unique((material.passes ?? []).map((pass) => pass.program.module))
+  };
+}
+function createMaterialArtifactDigest(bytes) {
+  return `sha256:${bytesToHex(sha256(bytes))}`;
+}
+function jsonValue(value) {
+  if (value instanceof Uint8Array) return [...value];
+  if (Array.isArray(value)) return value.map(jsonValue);
+  if (value !== null && typeof value === "object") {
+    return Object.fromEntries(
+      Object.entries(value).filter(([, entry]) => entry !== void 0).sort(([a], [b]) => a.localeCompare(b)).map(([key, entry]) => [key, jsonValue(entry)])
+    );
+  }
+  return value;
+}
+function createMaterialCookIdentity(input) {
+  const cookIdentity = createMaterialArtifactDigest(
+    new TextEncoder().encode(
+      JSON.stringify(
+        jsonValue({
+          materialContractDigest: input.materialContractDigest,
+          sourceRevision: input.sourceRevision,
+          sourceClosureDigest: input.sourceClosureDigest,
+          layoutIdentity: input.layoutIdentity,
+          programIdentity: input.programIdentity,
+          pipelineIdentity: input.pipelineIdentity,
+          compilerFingerprint: input.compilerFingerprint,
+          wasm: input.wasm,
+          artifactDigest: input.artifactDigest
+        })
+      )
+    )
+  );
+  return { ...input, cookIdentity };
+}
+function serializeCookedMaterialRecord(record) {
+  return JSON.stringify(jsonValue(record));
+}
+function serializeMaterialCookReceipt(receipt) {
+  return JSON.stringify(jsonValue({ ...receipt, sourceClosure: unique(receipt.sourceClosure) }));
+}
+function invalid(field, actual) {
+  return err({
+    code: "material-cook-record-invalid",
+    expected: "a complete material-cook/3 record with layered identity and provenance",
+    hint: "re-cook the material and publish its record, artifact, references, and receipt together",
+    detail: {
+      field,
+      ...actual === void 0 ? {} : { actual },
+      action: "inspect the named field and recook the material generation"
+    }
+  });
+}
+var IDENTITY_FIELDS = [
+  "materialContractDigest",
+  "sourceRevision",
+  "sourceClosureDigest",
+  "layoutIdentity",
+  "programIdentity",
+  "pipelineIdentity",
+  "materialPublicationIdentity",
+  "cookIdentity",
+  "compilerFingerprint",
+  "artifactDigest"
+];
+function isGeneration(value) {
+  return typeof value === "number" && Number.isSafeInteger(value) && value >= 1;
+}
+function validateIdentity(value) {
+  if (value === null || typeof value !== "object") return invalid("receipt.identity", value);
+  const candidate = value;
+  for (const field of IDENTITY_FIELDS) {
+    if (typeof candidate[field] !== "string" || candidate[field].length === 0) {
+      return invalid(`receipt.identity.${field}`, candidate[field]);
+    }
+  }
+  if (candidate.wasm === null || typeof candidate.wasm !== "object") {
+    return invalid("receipt.identity.wasm", candidate.wasm);
+  }
+  const wasm = candidate.wasm;
+  for (const field of ["sourceContentKey", "artifactSha256", "glueSha256"]) {
+    if (typeof wasm[field] !== "string" || wasm[field].length === 0) {
+      return invalid(`receipt.identity.wasm.${field}`, wasm[field]);
+    }
+  }
+  for (const field of ["valueGeneration", "dependencyGeneration", "cookGeneration"]) {
+    if (!isGeneration(candidate[field]))
+      return invalid(`receipt.identity.${field}`, candidate[field]);
+  }
+  return ok({
+    ...candidate,
+    wasm
+  });
+}
+function validateMaterialCookReceipt(value, expected = {}) {
+  if (value === null || typeof value !== "object") return invalid("receipt");
+  const candidate = value;
+  if (candidate.schemaVersion !== "material-cook/3")
+    return invalid("receipt.schemaVersion", candidate.schemaVersion);
+  const identityResult = validateIdentity(candidate.identity);
+  if (!identityResult.ok) return identityResult;
+  const identity = identityResult.value;
+  if (candidate.derivedInterface === null || typeof candidate.derivedInterface !== "object") {
+    return invalid("receipt.derivedInterface", candidate.derivedInterface);
+  }
+  const derivedInterface = candidate.derivedInterface;
+  if (derivedInterface.layoutIdentity !== identity.layoutIdentity) {
+    return invalid("receipt.derivedInterface.layoutIdentity", derivedInterface.layoutIdentity);
+  }
+  for (const field of ["sourceClosure", "profile", "compilerVersion"]) {
+    const fieldValue = candidate[field];
+    if (field === "sourceClosure" && !Array.isArray(fieldValue) || field !== "sourceClosure" && typeof fieldValue !== "string") {
+      return invalid(`receipt.${field}`, fieldValue);
+    }
+  }
+  const sourceClosure = candidate.sourceClosure;
+  if (Array.isArray(sourceClosure) && sourceClosure.some((path) => typeof path !== "string")) {
+    return invalid("receipt.sourceClosure", sourceClosure);
+  }
+  if (expected.layoutIdentity !== void 0 && identity.layoutIdentity !== expected.layoutIdentity) {
+    return invalid("receipt.identity.layoutIdentity", identity.layoutIdentity);
+  }
+  if (expected.artifactDigest !== void 0 && identity.artifactDigest !== expected.artifactDigest) {
+    return invalid("receipt.identity.artifactDigest", identity.artifactDigest);
+  }
+  if (expected.inputDigest !== void 0 && identity.cookIdentity !== expected.inputDigest) {
+    return invalid("receipt.identity.cookIdentity", identity.cookIdentity);
+  }
+  return ok({
+    schemaVersion: "material-cook/3",
+    sourceClosure: candidate.sourceClosure,
+    profile: candidate.profile,
+    compilerVersion: candidate.compilerVersion,
+    identity,
+    derivedInterface: { layoutIdentity: derivedInterface.layoutIdentity }
+  });
+}
+function validateCookedMaterialRecord(value) {
+  if (value === null || typeof value !== "object") return invalid("record");
+  const candidate = value;
+  if (candidate.schemaVersion !== "material-cook/3")
+    return invalid("schemaVersion", candidate.schemaVersion);
+  if (typeof candidate.guid !== "string" || !candidate.guid) return invalid("guid");
+  if (candidate.materialGuid !== void 0 && typeof candidate.materialGuid !== "string")
+    return invalid("materialGuid");
+  if (candidate.publicationGeneration !== void 0 && !isGeneration(candidate.publicationGeneration))
+    return invalid("publicationGeneration", candidate.publicationGeneration);
+  if (candidate.specializationKey !== void 0 && typeof candidate.specializationKey !== "string")
+    return invalid("specializationKey");
+  if (candidate.artifactDigest !== void 0 && typeof candidate.artifactDigest !== "string")
+    return invalid("artifactDigest");
+  if (candidate.sourceClosure !== void 0 && (!Array.isArray(candidate.sourceClosure) || candidate.sourceClosure.some((path) => typeof path !== "string")))
+    return invalid("sourceClosure");
+  if (candidate.parameterContract !== void 0) {
+    if (candidate.parameterContract === null || typeof candidate.parameterContract !== "object")
+      return invalid("parameterContract");
+    const parameterContract = candidate.parameterContract;
+    if (!Array.isArray(parameterContract.parameters))
+      return invalid("parameterContract.parameters");
+    if (parameterContract.values === null || typeof parameterContract.values !== "object" || Array.isArray(parameterContract.values))
+      return invalid("parameterContract.values");
+  }
+  if (candidate.resolved === null || typeof candidate.resolved !== "object")
+    return invalid("resolved");
+  if (candidate.refs === null || typeof candidate.refs !== "object") return invalid("refs");
+  if (candidate.artifact === null || typeof candidate.artifact !== "object")
+    return invalid("artifact");
+  if (candidate.receipt === null || typeof candidate.receipt !== "object")
+    return invalid("receipt");
+  const artifact = candidate.artifact;
+  if (typeof artifact.digest !== "string" || !Array.isArray(artifact.bytes) && !ArrayBuffer.isView(artifact.bytes)) {
+    return invalid("artifact");
+  }
+  const receiptResult = validateMaterialCookReceipt(candidate.receipt, {
+    artifactDigest: artifact.digest
+  });
+  if (!receiptResult.ok) return receiptResult;
+  if (candidate.artifactDigest !== void 0 && candidate.artifactDigest !== artifact.digest)
+    return invalid("artifactDigest", candidate.artifactDigest);
+  if (candidate.publicationGeneration !== void 0 && receiptResult.value.identity.cookGeneration !== candidate.publicationGeneration)
+    return invalid("receipt.identity.cookGeneration", receiptResult.value.identity.cookGeneration);
+  const normalized = {
+    ...candidate,
+    artifact: {
+      ...artifact,
+      bytes: ArrayBuffer.isView(artifact.bytes) ? Uint8Array.from(artifact.bytes) : Uint8Array.from(artifact.bytes)
+    },
+    receipt: receiptResult.value
+  };
+  return ok(normalized);
+}
+function projectCookedMaterialRecord(record) {
+  return {
+    resolved: record.resolved,
+    refs: record.refs,
+    artifact: record.artifact,
+    receipt: record.receipt,
+    schemaVersion: record.schemaVersion
+  };
+}
+
+export { collectMaterialCookRefs, createMaterialArtifactDigest, createMaterialCookIdentity, projectCookedMaterialRecord, serializeCookedMaterialRecord, serializeMaterialCookReceipt, validateCookedMaterialRecord };
+//# sourceMappingURL=material-cook.mjs.map
+//# sourceMappingURL=material-cook.mjs.map

package/dist/material-cook.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/evidence/material-cook.ts"],"names":[],"mappings":"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","file":"material-cook.mjs","sourcesContent":["import type {\n  MaterialAsset,\n  MaterialParameter,\n  MaterialPass,\n  MaterialTextureReference,\n  MaterialTextureValue,\n  MaterialValue,\n  Result,\n} from '@forgeax/engine-types';\nimport { err, MATERIAL_TEXTURE_SLOTS, ok } from '@forgeax/engine-types';\nimport { sha256 } from '@noble/hashes/sha2.js';\nimport { bytesToHex } from '@noble/hashes/utils.js';\n\nexport interface MaterialCookRefs {\n  readonly parent: readonly string[];\n  readonly textures: readonly string[];\n  readonly samplers: readonly string[];\n  readonly modules: readonly string[];\n}\n\nexport interface MaterialCookArtifact {\n  readonly mediaType: string;\n  readonly path: string;\n  readonly digest: string;\n  readonly bytes: Uint8Array;\n}\n\nexport interface MaterialCookWasmProvenance {\n  readonly sourceContentKey: string;\n  readonly artifactSha256: string;\n  readonly glueSha256: string;\n}\n\nexport interface MaterialCookIdentity {\n  readonly materialContractDigest: string;\n  readonly sourceRevision: string;\n  readonly sourceClosureDigest: string;\n  readonly layoutIdentity: string;\n  readonly programIdentity: string;\n  readonly pipelineIdentity: string;\n  readonly materialPublicationIdentity: string;\n  readonly cookIdentity: string;\n  readonly compilerFingerprint: string;\n  readonly wasm: MaterialCookWasmProvenance;\n  readonly artifactDigest: string;\n  readonly valueGeneration: number;\n  readonly dependencyGeneration: number;\n  readonly cookGeneration: number;\n}\n\nexport type MaterialCookIdentityInput = Omit<MaterialCookIdentity, 'cookIdentity'>;\n\nexport interface MaterialCookReceipt {\n  readonly schemaVersion: 'material-cook/3';\n  readonly sourceClosure: readonly string[];\n  readonly profile: string;\n  readonly compilerVersion: string;\n  readonly identity: MaterialCookIdentity;\n  readonly derivedInterface: { readonly layoutIdentity: string };\n}\n\nexport interface MaterialParameterContract {\n  readonly parameters: readonly MaterialParameter[];\n  readonly values: Readonly<Record<string, MaterialValue | null>>;\n}\n\nexport interface CookedMaterialRecord {\n  readonly schemaVersion: 'material-cook/3';\n  readonly guid: string;\n  readonly authored?: MaterialAsset;\n  readonly materialGuid?: string;\n  readonly publicationGeneration?: number;\n  readonly specializationKey?: string;\n  readonly artifactDigest?: string;\n  readonly sourceClosure?: readonly string[];\n  readonly parameterContract?: MaterialParameterContract;\n  readonly resolved: {\n    readonly passes: readonly MaterialPass[];\n    readonly parameters: readonly MaterialParameter[];\n    readonly values: Readonly<Record<string, MaterialValue | null>>;\n  };\n  readonly refs: MaterialCookRefs;\n  readonly artifact: MaterialCookArtifact;\n  readonly receipt: MaterialCookReceipt;\n}\n\nexport interface MaterialCookRecordError {\n  readonly code: 'material-cook-record-invalid';\n  readonly expected: string;\n  readonly hint: string;\n  readonly detail: {\n    readonly field: string;\n    readonly actual?: unknown;\n    readonly action: string;\n  };\n}\n\nexport interface MaterialCookIdentityExpectation {\n  readonly layoutIdentity?: string;\n  readonly artifactDigest?: string;\n  readonly inputDigest?: string;\n}\n\nfunction unique(values: readonly string[]): readonly string[] {\n  return [...new Set(values)].sort();\n}\n\nfunction guidText(value: string | Uint8Array): string {\n  return typeof value === 'string'\n    ? value\n    : Array.from(value, (byte) => byte.toString(16).padStart(2, '0')).join('');\n}\n\nfunction cookGuidText(value: MaterialTextureReference): string | undefined {\n  return typeof value === 'number' ? undefined : guidText(value);\n}\n\nfunction textureValues(\n  values: Readonly<Record<string, MaterialValue | null>> | undefined,\n  textureFields: ReadonlySet<string>,\n): readonly MaterialTextureValue[] {\n  return Object.entries(values ?? {}).flatMap(([name, value]) => {\n    if (value === null) return [];\n    if (typeof value === 'string') {\n      return textureFields.has(name) ? [{ texture: value }] : [];\n    }\n    return value !== null &&\n      typeof value === 'object' &&\n      !Array.isArray(value) &&\n      'texture' in value\n      ? [value as MaterialTextureValue]\n      : [];\n  });\n}\n\nexport function collectMaterialCookRefs(material: Partial<MaterialAsset>): MaterialCookRefs {\n  const textureFields =\n    material.parameters === undefined\n      ? new Set<string>(MATERIAL_TEXTURE_SLOTS)\n      : new Set(\n          material.parameters\n            .filter((parameter) => parameter.type === 'texture')\n            .map((parameter) => parameter.name),\n        );\n  const textures = textureValues(material.values, textureFields);\n  return {\n    parent: material.parent ? [guidText(material.parent)] : [],\n    textures: unique(\n      textures.flatMap((value) => {\n        const guid = cookGuidText(value.texture);\n        return guid === undefined ? [] : [guid];\n      }),\n    ),\n    samplers: unique(\n      textures.flatMap((value) => {\n        if (value.sampler === undefined) return [];\n        const guid = cookGuidText(value.sampler);\n        return guid === undefined ? [] : [guid];\n      }),\n    ),\n    modules: unique((material.passes ?? []).map((pass) => pass.program.module)),\n  };\n}\n\nexport function createMaterialArtifactDigest(bytes: Uint8Array): string {\n  return `sha256:${bytesToHex(sha256(bytes))}`;\n}\n\nfunction jsonValue(value: unknown): unknown {\n  if (value instanceof Uint8Array) return [...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)\n        .filter(([, entry]) => entry !== undefined)\n        .sort(([a], [b]) => a.localeCompare(b))\n        .map(([key, entry]) => [key, jsonValue(entry)]),\n    );\n  }\n  return value;\n}\n\nexport function createMaterialCookIdentity(input: MaterialCookIdentityInput): MaterialCookIdentity {\n  const cookIdentity = createMaterialArtifactDigest(\n    new TextEncoder().encode(\n      JSON.stringify(\n        jsonValue({\n          materialContractDigest: input.materialContractDigest,\n          sourceRevision: input.sourceRevision,\n          sourceClosureDigest: input.sourceClosureDigest,\n          layoutIdentity: input.layoutIdentity,\n          programIdentity: input.programIdentity,\n          pipelineIdentity: input.pipelineIdentity,\n          compilerFingerprint: input.compilerFingerprint,\n          wasm: input.wasm,\n          artifactDigest: input.artifactDigest,\n        }),\n      ),\n    ),\n  );\n  return { ...input, cookIdentity };\n}\n\nexport function serializeCookedMaterialRecord(record: CookedMaterialRecord): string {\n  return JSON.stringify(jsonValue(record));\n}\n\nexport function serializeMaterialCookReceipt(receipt: MaterialCookReceipt): string {\n  return JSON.stringify(jsonValue({ ...receipt, sourceClosure: unique(receipt.sourceClosure) }));\n}\n\nfunction invalid(field: string, actual?: unknown): Result<never, MaterialCookRecordError> {\n  return err({\n    code: 'material-cook-record-invalid',\n    expected: 'a complete material-cook/3 record with layered identity and provenance',\n    hint: 're-cook the material and publish its record, artifact, references, and receipt together',\n    detail: {\n      field,\n      ...(actual === undefined ? {} : { actual }),\n      action: 'inspect the named field and recook the material generation',\n    },\n  });\n}\n\nconst IDENTITY_FIELDS = [\n  'materialContractDigest',\n  'sourceRevision',\n  'sourceClosureDigest',\n  'layoutIdentity',\n  'programIdentity',\n  'pipelineIdentity',\n  'materialPublicationIdentity',\n  'cookIdentity',\n  'compilerFingerprint',\n  'artifactDigest',\n] as const;\n\nfunction isGeneration(value: unknown): value is number {\n  return typeof value === 'number' && Number.isSafeInteger(value) && value >= 1;\n}\n\nfunction validateIdentity(value: unknown): Result<MaterialCookIdentity, MaterialCookRecordError> {\n  if (value === null || typeof value !== 'object') return invalid('receipt.identity', value);\n  const candidate = value as Record<string, unknown>;\n  for (const field of IDENTITY_FIELDS) {\n    if (typeof candidate[field] !== 'string' || candidate[field].length === 0) {\n      return invalid(`receipt.identity.${field}`, candidate[field]);\n    }\n  }\n  if (candidate.wasm === null || typeof candidate.wasm !== 'object') {\n    return invalid('receipt.identity.wasm', candidate.wasm);\n  }\n  const wasm = candidate.wasm as Record<string, unknown>;\n  for (const field of ['sourceContentKey', 'artifactSha256', 'glueSha256']) {\n    if (typeof wasm[field] !== 'string' || wasm[field].length === 0) {\n      return invalid(`receipt.identity.wasm.${field}`, wasm[field]);\n    }\n  }\n  for (const field of ['valueGeneration', 'dependencyGeneration', 'cookGeneration']) {\n    if (!isGeneration(candidate[field]))\n      return invalid(`receipt.identity.${field}`, candidate[field]);\n  }\n  return ok({\n    ...candidate,\n    wasm: wasm as unknown as MaterialCookWasmProvenance,\n  } as MaterialCookIdentity);\n}\n\nexport function validateMaterialCookReceipt(\n  value: unknown,\n  expected: MaterialCookIdentityExpectation = {},\n): Result<MaterialCookReceipt, MaterialCookRecordError> {\n  if (value === null || typeof value !== 'object') return invalid('receipt');\n  const candidate = value as Record<string, unknown>;\n  if (candidate.schemaVersion !== 'material-cook/3')\n    return invalid('receipt.schemaVersion', candidate.schemaVersion);\n  const identityResult = validateIdentity(candidate.identity);\n  if (!identityResult.ok) return identityResult;\n  const identity = identityResult.value;\n  if (candidate.derivedInterface === null || typeof candidate.derivedInterface !== 'object') {\n    return invalid('receipt.derivedInterface', candidate.derivedInterface);\n  }\n  const derivedInterface = candidate.derivedInterface as Record<string, unknown>;\n  if (derivedInterface.layoutIdentity !== identity.layoutIdentity) {\n    return invalid('receipt.derivedInterface.layoutIdentity', derivedInterface.layoutIdentity);\n  }\n  for (const field of ['sourceClosure', 'profile', 'compilerVersion']) {\n    const fieldValue = candidate[field];\n    if (\n      (field === 'sourceClosure' && !Array.isArray(fieldValue)) ||\n      (field !== 'sourceClosure' && typeof fieldValue !== 'string')\n    ) {\n      return invalid(`receipt.${field}`, fieldValue);\n    }\n  }\n  const sourceClosure = candidate.sourceClosure;\n  if (Array.isArray(sourceClosure) && sourceClosure.some((path) => typeof path !== 'string')) {\n    return invalid('receipt.sourceClosure', sourceClosure);\n  }\n  if (\n    expected.layoutIdentity !== undefined &&\n    identity.layoutIdentity !== expected.layoutIdentity\n  ) {\n    return invalid('receipt.identity.layoutIdentity', identity.layoutIdentity);\n  }\n  if (\n    expected.artifactDigest !== undefined &&\n    identity.artifactDigest !== expected.artifactDigest\n  ) {\n    return invalid('receipt.identity.artifactDigest', identity.artifactDigest);\n  }\n  if (expected.inputDigest !== undefined && identity.cookIdentity !== expected.inputDigest) {\n    return invalid('receipt.identity.cookIdentity', identity.cookIdentity);\n  }\n  return ok({\n    schemaVersion: 'material-cook/3',\n    sourceClosure: candidate.sourceClosure as string[],\n    profile: candidate.profile as string,\n    compilerVersion: candidate.compilerVersion as string,\n    identity,\n    derivedInterface: { layoutIdentity: derivedInterface.layoutIdentity as string },\n  });\n}\n\nexport function validateCookedMaterialRecord(\n  value: unknown,\n): Result<CookedMaterialRecord, MaterialCookRecordError> {\n  if (value === null || typeof value !== 'object') return invalid('record');\n  const candidate = value as Record<string, unknown>;\n  if (candidate.schemaVersion !== 'material-cook/3')\n    return invalid('schemaVersion', candidate.schemaVersion);\n  if (typeof candidate.guid !== 'string' || !candidate.guid) return invalid('guid');\n  if (candidate.materialGuid !== undefined && typeof candidate.materialGuid !== 'string')\n    return invalid('materialGuid');\n  if (\n    candidate.publicationGeneration !== undefined &&\n    !isGeneration(candidate.publicationGeneration)\n  )\n    return invalid('publicationGeneration', candidate.publicationGeneration);\n  if (candidate.specializationKey !== undefined && typeof candidate.specializationKey !== 'string')\n    return invalid('specializationKey');\n  if (candidate.artifactDigest !== undefined && typeof candidate.artifactDigest !== 'string')\n    return invalid('artifactDigest');\n  if (\n    candidate.sourceClosure !== undefined &&\n    (!Array.isArray(candidate.sourceClosure) ||\n      candidate.sourceClosure.some((path) => typeof path !== 'string'))\n  )\n    return invalid('sourceClosure');\n  if (candidate.parameterContract !== undefined) {\n    if (candidate.parameterContract === null || typeof candidate.parameterContract !== 'object')\n      return invalid('parameterContract');\n    const parameterContract = candidate.parameterContract as Record<string, unknown>;\n    if (!Array.isArray(parameterContract.parameters))\n      return invalid('parameterContract.parameters');\n    if (\n      parameterContract.values === null ||\n      typeof parameterContract.values !== 'object' ||\n      Array.isArray(parameterContract.values)\n    )\n      return invalid('parameterContract.values');\n  }\n  if (candidate.resolved === null || typeof candidate.resolved !== 'object')\n    return invalid('resolved');\n  if (candidate.refs === null || typeof candidate.refs !== 'object') return invalid('refs');\n  if (candidate.artifact === null || typeof candidate.artifact !== 'object')\n    return invalid('artifact');\n  if (candidate.receipt === null || typeof candidate.receipt !== 'object')\n    return invalid('receipt');\n  const artifact = candidate.artifact as Record<string, unknown>;\n  if (\n    typeof artifact.digest !== 'string' ||\n    (!Array.isArray(artifact.bytes) && !ArrayBuffer.isView(artifact.bytes))\n  ) {\n    return invalid('artifact');\n  }\n  const receiptResult = validateMaterialCookReceipt(candidate.receipt, {\n    artifactDigest: artifact.digest as string,\n  });\n  if (!receiptResult.ok) return receiptResult;\n  if (candidate.artifactDigest !== undefined && candidate.artifactDigest !== artifact.digest)\n    return invalid('artifactDigest', candidate.artifactDigest);\n  if (\n    candidate.publicationGeneration !== undefined &&\n    receiptResult.value.identity.cookGeneration !== candidate.publicationGeneration\n  )\n    return invalid('receipt.identity.cookGeneration', receiptResult.value.identity.cookGeneration);\n  const normalized = {\n    ...candidate,\n    artifact: {\n      ...artifact,\n      bytes: ArrayBuffer.isView(artifact.bytes)\n        ? Uint8Array.from(artifact.bytes as Uint8Array)\n        : Uint8Array.from(artifact.bytes as number[]),\n    },\n    receipt: receiptResult.value,\n  } as CookedMaterialRecord;\n  return ok(normalized);\n}\n\nexport function projectCookedMaterialRecord(\n  record: CookedMaterialRecord,\n): Omit<CookedMaterialRecord, 'guid' | 'authored'> {\n  return {\n    resolved: record.resolved,\n    refs: record.refs,\n    artifact: record.artifact,\n    receipt: record.receipt,\n    schemaVersion: record.schemaVersion,\n  };\n}\n"]}

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

@@ -0,0 +1,36 @@
+/** Canonical mesh binary wire facts shared by build-time and runtime owners. */
+export declare const MESH_BIN_VERSION: 4;
+export declare const MESH_BIN_PROJECTION_VERSION: 1;
+export declare const MESH_BIN_HEADER_V4_BYTES = 80;
+export declare const MESH_BIN_DIGEST_BYTES = 32;
+export interface MeshBinHeaderV4 {
+    readonly version: 4;
+    readonly projectionVersion: 1;
+    readonly mask: number;
+    readonly digest: string;
+    readonly stride: number;
+    readonly vertexCount: number;
+    readonly vertexBytes: number;
+    readonly indexCount: number;
+    readonly indexWidth: 0 | 2 | 4;
+    readonly indexBytes: number;
+    readonly jsonBytes: number;
+}
+export interface MeshBinContractError {
+    readonly code: 'mesh-bin-header-truncated' | 'mesh-bin-version-unsupported' | 'mesh-bin-header-invalid';
+    readonly subject: 'mesh-bin';
+    readonly sourceKey: string;
+    readonly expected: string;
+    readonly actual: string;
+    readonly recovery: string;
+}
+export type MeshBinHeaderResult = {
+    readonly ok: true;
+    readonly value: MeshBinHeaderV4;
+} | {
+    readonly ok: false;
+    readonly error: MeshBinContractError;
+};
+export declare function writeMeshBinHeader(header: MeshBinHeaderV4, out: Uint8Array): void;
+export declare function decodeMeshBinHeader(bytes: Uint8Array, sourceKey?: string): MeshBinHeaderResult;
+//# sourceMappingURL=mesh-bin-contract.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mesh-bin-contract.d.ts","sourceRoot":"","sources":["../src/mesh-bin-contract.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAEhF,eAAO,MAAM,gBAAgB,EAAG,CAAU,CAAC;AAC3C,eAAO,MAAM,2BAA2B,EAAG,CAAU,CAAC;AACtD,eAAO,MAAM,wBAAwB,KAAK,CAAC;AAC3C,eAAO,MAAM,qBAAqB,KAAK,CAAC;AAExC,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;IACpB,QAAQ,CAAC,iBAAiB,EAAE,CAAC,CAAC;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC/B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,IAAI,EACT,2BAA2B,GAC3B,8BAA8B,GAC9B,yBAAyB,CAAC;IAC9B,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;AAED,MAAM,MAAM,mBAAmB,GAC3B;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAA;CAAE,GACtD;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,oBAAoB,CAAA;CAAE,CAAC;AA+BjE,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,eAAe,EAAE,GAAG,EAAE,UAAU,GAAG,IAAI,CAgBjF;AAED,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,UAAU,EACjB,SAAS,SAA0B,GAClC,mBAAmB,CA8DrB"}

package/dist/mesh-bin-contract.mjs

@@ -0,0 +1,96 @@
+// src/mesh-bin-contract.ts
+var MESH_BIN_VERSION = 4;
+var MESH_BIN_PROJECTION_VERSION = 1;
+var MESH_BIN_HEADER_V4_BYTES = 80;
+var MESH_BIN_DIGEST_BYTES = 32;
+function failure(code, sourceKey, expected, actual) {
+  return {
+    ok: false,
+    error: {
+      code,
+      subject: "mesh-bin",
+      sourceKey,
+      expected,
+      actual,
+      recovery: "re-cook the source with its Meta sidecar through the build-time importer"
+    }
+  };
+}
+function digestBytes(digest) {
+  const bytes = new Uint8Array(MESH_BIN_DIGEST_BYTES);
+  bytes.set(new TextEncoder().encode(digest).subarray(0, MESH_BIN_DIGEST_BYTES));
+  return bytes;
+}
+function readDigest(bytes) {
+  return new TextDecoder().decode(bytes).replace(/\0+$/u, "");
+}
+function writeMeshBinHeader(header, out) {
+  if (out.byteLength < MESH_BIN_HEADER_V4_BYTES) {
+    throw new RangeError("mesh-bin v4 header output is truncated");
+  }
+  const view = new DataView(out.buffer, out.byteOffset, out.byteLength);
+  view.setUint32(0, header.version, true);
+  view.setUint32(4, header.projectionVersion, true);
+  view.setUint32(8, header.mask, true);
+  view.setUint32(12, header.stride, true);
+  view.setUint32(16, header.vertexCount, true);
+  view.setUint32(20, header.vertexBytes, true);
+  view.setUint32(24, header.indexCount, true);
+  view.setUint32(28, header.indexWidth, true);
+  view.setUint32(32, header.indexBytes, true);
+  view.setUint32(36, header.jsonBytes, true);
+  out.set(digestBytes(header.digest), 48);
+}
+function decodeMeshBinHeader(bytes, sourceKey = "<unknown mesh source>") {
+  if (bytes.byteLength < MESH_BIN_HEADER_V4_BYTES) {
+    return failure(
+      "mesh-bin-header-truncated",
+      sourceKey,
+      `mesh-bin v4 header (${MESH_BIN_HEADER_V4_BYTES} bytes)`,
+      `${bytes.byteLength} bytes`
+    );
+  }
+  const view = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
+  const version = view.getUint32(0, true);
+  if (version !== MESH_BIN_VERSION) {
+    return failure("mesh-bin-version-unsupported", sourceKey, "mesh-bin v4", `version ${version}`);
+  }
+  const projectionVersion = view.getUint32(4, true);
+  const mask = view.getUint32(8, true);
+  const stride = view.getUint32(12, true);
+  const vertexCount = view.getUint32(16, true);
+  const vertexBytes = view.getUint32(20, true);
+  const indexCount = view.getUint32(24, true);
+  const indexWidth = view.getUint32(28, true);
+  const indexBytes = view.getUint32(32, true);
+  const jsonBytes = view.getUint32(36, true);
+  const digest = readDigest(bytes.subarray(48, 48 + MESH_BIN_DIGEST_BYTES));
+  if (projectionVersion !== MESH_BIN_PROJECTION_VERSION || mask === 0 || stride === 0 || !Number.isSafeInteger(vertexCount) || !Number.isSafeInteger(vertexBytes) || !Number.isSafeInteger(indexCount) || !Number.isSafeInteger(indexBytes) || !Number.isSafeInteger(jsonBytes) || indexCount === 0 && indexWidth !== 0 || indexCount > 0 && indexWidth !== 2 && indexWidth !== 4 || indexBytes !== indexCount * indexWidth || vertexBytes !== vertexCount * stride || digest.length === 0) {
+    return failure(
+      "mesh-bin-header-invalid",
+      sourceKey,
+      "safe v4 projection, stride, cardinality, and payload byte lengths",
+      `projection=${projectionVersion}; mask=${mask}; stride=${stride}; vertexBytes=${vertexBytes}; indexBytes=${indexBytes}; digest=${digest}`
+    );
+  }
+  return {
+    ok: true,
+    value: {
+      version: 4,
+      projectionVersion: 1,
+      mask,
+      digest,
+      stride,
+      vertexCount,
+      vertexBytes,
+      indexCount,
+      indexWidth,
+      indexBytes,
+      jsonBytes
+    }
+  };
+}
+
+export { MESH_BIN_DIGEST_BYTES, MESH_BIN_HEADER_V4_BYTES, MESH_BIN_PROJECTION_VERSION, MESH_BIN_VERSION, decodeMeshBinHeader, writeMeshBinHeader };
+//# sourceMappingURL=mesh-bin-contract.mjs.map
+//# sourceMappingURL=mesh-bin-contract.mjs.map

package/dist/mesh-bin-contract.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/mesh-bin-contract.ts"],"names":[],"mappings":";AAEO,IAAM,gBAAA,GAAmB;AACzB,IAAM,2BAAA,GAA8B;AACpC,IAAM,wBAAA,GAA2B;AACjC,IAAM,qBAAA,GAAwB;AAgCrC,SAAS,OAAA,CACP,IAAA,EACA,SAAA,EACA,QAAA,EACA,MAAA,EACqB;AACrB,EAAA,OAAO;AAAA,IACL,EAAA,EAAI,KAAA;AAAA,IACJ,KAAA,EAAO;AAAA,MACL,IAAA;AAAA,MACA,OAAA,EAAS,UAAA;AAAA,MACT,SAAA;AAAA,MACA,QAAA;AAAA,MACA,MAAA;AAAA,MACA,QAAA,EAAU;AAAA;AACZ,GACF;AACF;AAEA,SAAS,YAAY,MAAA,EAA4B;AAC/C,EAAA,MAAM,KAAA,GAAQ,IAAI,UAAA,CAAW,qBAAqB,CAAA;AAClD,EAAA,KAAA,CAAM,GAAA,CAAI,IAAI,WAAA,EAAY,CAAE,MAAA,CAAO,MAAM,CAAA,CAAE,QAAA,CAAS,CAAA,EAAG,qBAAqB,CAAC,CAAA;AAC7E,EAAA,OAAO,KAAA;AACT;AAEA,SAAS,WAAW,KAAA,EAA2B;AAC7C,EAAA,OAAO,IAAI,aAAY,CAAE,MAAA,CAAO,KAAK,CAAA,CAAE,OAAA,CAAQ,SAAS,EAAE,CAAA;AAC5D;AAEO,SAAS,kBAAA,CAAmB,QAAyB,GAAA,EAAuB;AACjF,EAAA,IAAI,GAAA,CAAI,aAAa,wBAAA,EAA0B;AAC7C,IAAA,MAAM,IAAI,WAAW,wCAAwC,CAAA;AAAA,EAC/D;AACA,EAAA,MAAM,IAAA,GAAO,IAAI,QAAA,CAAS,GAAA,CAAI,QAAQ,GAAA,CAAI,UAAA,EAAY,IAAI,UAAU,CAAA;AACpE,EAAA,IAAA,CAAK,SAAA,CAAU,CAAA,EAAG,MAAA,CAAO,OAAA,EAAS,IAAI,CAAA;AACtC,EAAA,IAAA,CAAK,SAAA,CAAU,CAAA,EAAG,MAAA,CAAO,iBAAA,EAAmB,IAAI,CAAA;AAChD,EAAA,IAAA,CAAK,SAAA,CAAU,CAAA,EAAG,MAAA,CAAO,IAAA,EAAM,IAAI,CAAA;AACnC,EAAA,IAAA,CAAK,SAAA,CAAU,EAAA,EAAI,MAAA,CAAO,MAAA,EAAQ,IAAI,CAAA;AACtC,EAAA,IAAA,CAAK,SAAA,CAAU,EAAA,EAAI,MAAA,CAAO,WAAA,EAAa,IAAI,CAAA;AAC3C,EAAA,IAAA,CAAK,SAAA,CAAU,EAAA,EAAI,MAAA,CAAO,WAAA,EAAa,IAAI,CAAA;AAC3C,EAAA,IAAA,CAAK,SAAA,CAAU,EAAA,EAAI,MAAA,CAAO,UAAA,EAAY,IAAI,CAAA;AAC1C,EAAA,IAAA,CAAK,SAAA,CAAU,EAAA,EAAI,MAAA,CAAO,UAAA,EAAY,IAAI,CAAA;AAC1C,EAAA,IAAA,CAAK,SAAA,CAAU,EAAA,EAAI,MAAA,CAAO,UAAA,EAAY,IAAI,CAAA;AAC1C,EAAA,IAAA,CAAK,SAAA,CAAU,EAAA,EAAI,MAAA,CAAO,SAAA,EAAW,IAAI,CAAA;AACzC,EAAA,GAAA,CAAI,GAAA,CAAI,WAAA,CAAY,MAAA,CAAO,MAAM,GAAG,EAAE,CAAA;AACxC;AAEO,SAAS,mBAAA,CACd,KAAA,EACA,SAAA,GAAY,uBAAA,EACS;AACrB,EAAA,IAAI,KAAA,CAAM,aAAa,wBAAA,EAA0B;AAC/C,IAAA,OAAO,OAAA;AAAA,MACL,2BAAA;AAAA,MACA,SAAA;AAAA,MACA,uBAAuB,wBAAwB,CAAA,OAAA,CAAA;AAAA,MAC/C,CAAA,EAAG,MAAM,UAAU,CAAA,MAAA;AAAA,KACrB;AAAA,EACF;AACA,EAAA,MAAM,IAAA,GAAO,IAAI,QAAA,CAAS,KAAA,CAAM,QAAQ,KAAA,CAAM,UAAA,EAAY,MAAM,UAAU,CAAA;AAC1E,EAAA,MAAM,OAAA,GAAU,IAAA,CAAK,SAAA,CAAU,CAAA,EAAG,IAAI,CAAA;AACtC,EAAA,IAAI,YAAY,gBAAA,EAAkB;AAChC,IAAA,OAAO,QAAQ,8BAAA,EAAgC,SAAA,EAAW,aAAA,EAAe,CAAA,QAAA,EAAW,OAAO,CAAA,CAAE,CAAA;AAAA,EAC/F;AACA,EAAA,MAAM,iBAAA,GAAoB,IAAA,CAAK,SAAA,CAAU,CAAA,EAAG,IAAI,CAAA;AAChD,EAAA,MAAM,IAAA,GAAO,IAAA,CAAK,SAAA,CAAU,CAAA,EAAG,IAAI,CAAA;AACnC,EAAA,MAAM,MAAA,GAAS,IAAA,CAAK,SAAA,CAAU,EAAA,EAAI,IAAI,CAAA;AACtC,EAAA,MAAM,WAAA,GAAc,IAAA,CAAK,SAAA,CAAU,EAAA,EAAI,IAAI,CAAA;AAC3C,EAAA,MAAM,WAAA,GAAc,IAAA,CAAK,SAAA,CAAU,EAAA,EAAI,IAAI,CAAA;AAC3C,EAAA,MAAM,UAAA,GAAa,IAAA,CAAK,SAAA,CAAU,EAAA,EAAI,IAAI,CAAA;AAC1C,EAAA,MAAM,UAAA,GAAa,IAAA,CAAK,SAAA,CAAU,EAAA,EAAI,IAAI,CAAA;AAC1C,EAAA,MAAM,UAAA,GAAa,IAAA,CAAK,SAAA,CAAU,EAAA,EAAI,IAAI,CAAA;AAC1C,EAAA,MAAM,SAAA,GAAY,IAAA,CAAK,SAAA,CAAU,EAAA,EAAI,IAAI,CAAA;AACzC,EAAA,MAAM,SAAS,UAAA,CAAW,KAAA,CAAM,SAAS,EAAA,EAAI,EAAA,GAAK,qBAAqB,CAAC,CAAA;AACxE,EAAA,IACE,iBAAA,KAAsB,+BACtB,IAAA,KAAS,CAAA,IACT,WAAW,CAAA,IACX,CAAC,MAAA,CAAO,aAAA,CAAc,WAAW,CAAA,IACjC,CAAC,MAAA,CAAO,aAAA,CAAc,WAAW,CAAA,IACjC,CAAC,OAAO,aAAA,CAAc,UAAU,CAAA,IAChC,CAAC,MAAA,CAAO,aAAA,CAAc,UAAU,CAAA,IAChC,CAAC,OAAO,aAAA,CAAc,SAAS,KAC9B,UAAA,KAAe,CAAA,IAAK,UAAA,KAAe,CAAA,IACnC,UAAA,GAAa,CAAA,IAAK,eAAe,CAAA,IAAK,UAAA,KAAe,CAAA,IACtD,UAAA,KAAe,UAAA,GAAa,UAAA,IAC5B,gBAAgB,WAAA,GAAc,MAAA,IAC9B,MAAA,CAAO,MAAA,KAAW,CAAA,EAClB;AACA,IAAA,OAAO,OAAA;AAAA,MACL,yBAAA;AAAA,MACA,SAAA;AAAA,MACA,mEAAA;AAAA,MACA,CAAA,WAAA,EAAc,iBAAiB,CAAA,OAAA,EAAU,IAAI,CAAA,SAAA,EAAY,MAAM,CAAA,cAAA,EAAiB,WAAW,CAAA,aAAA,EAAgB,UAAU,CAAA,SAAA,EAAY,MAAM,CAAA;AAAA,KACzI;AAAA,EACF;AACA,EAAA,OAAO;AAAA,IACL,EAAA,EAAI,IAAA;AAAA,IACJ,KAAA,EAAO;AAAA,MACL,OAAA,EAAS,CAAA;AAAA,MACT,iBAAA,EAAmB,CAAA;AAAA,MACnB,IAAA;AAAA,MACA,MAAA;AAAA,MACA,MAAA;AAAA,MACA,WAAA;AAAA,MACA,WAAA;AAAA,MACA,UAAA;AAAA,MACA,UAAA;AAAA,MACA,UAAA;AAAA,MACA;AAAA;AACF,GACF;AACF","file":"mesh-bin-contract.mjs","sourcesContent":["/** Canonical mesh binary wire facts shared by build-time and runtime owners. */\n\nexport const MESH_BIN_VERSION = 4 as const;\nexport const MESH_BIN_PROJECTION_VERSION = 1 as const;\nexport const MESH_BIN_HEADER_V4_BYTES = 80;\nexport const MESH_BIN_DIGEST_BYTES = 32;\n\nexport interface MeshBinHeaderV4 {\n  readonly version: 4;\n  readonly projectionVersion: 1;\n  readonly mask: number;\n  readonly digest: string;\n  readonly stride: number;\n  readonly vertexCount: number;\n  readonly vertexBytes: number;\n  readonly indexCount: number;\n  readonly indexWidth: 0 | 2 | 4;\n  readonly indexBytes: number;\n  readonly jsonBytes: number;\n}\n\nexport interface MeshBinContractError {\n  readonly code:\n    | 'mesh-bin-header-truncated'\n    | 'mesh-bin-version-unsupported'\n    | 'mesh-bin-header-invalid';\n  readonly subject: 'mesh-bin';\n  readonly sourceKey: string;\n  readonly expected: string;\n  readonly actual: string;\n  readonly recovery: string;\n}\n\nexport type MeshBinHeaderResult =\n  | { readonly ok: true; readonly value: MeshBinHeaderV4 }\n  | { readonly ok: false; readonly error: MeshBinContractError };\n\nfunction failure(\n  code: MeshBinContractError['code'],\n  sourceKey: string,\n  expected: string,\n  actual: string,\n): MeshBinHeaderResult {\n  return {\n    ok: false,\n    error: {\n      code,\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}\n\nfunction digestBytes(digest: string): Uint8Array {\n  const bytes = new Uint8Array(MESH_BIN_DIGEST_BYTES);\n  bytes.set(new TextEncoder().encode(digest).subarray(0, MESH_BIN_DIGEST_BYTES));\n  return bytes;\n}\n\nfunction readDigest(bytes: Uint8Array): string {\n  return new TextDecoder().decode(bytes).replace(/\\0+$/u, '');\n}\n\nexport function writeMeshBinHeader(header: MeshBinHeaderV4, out: Uint8Array): void {\n  if (out.byteLength < MESH_BIN_HEADER_V4_BYTES) {\n    throw new RangeError('mesh-bin v4 header output is truncated');\n  }\n  const view = new DataView(out.buffer, out.byteOffset, out.byteLength);\n  view.setUint32(0, header.version, true);\n  view.setUint32(4, header.projectionVersion, true);\n  view.setUint32(8, header.mask, true);\n  view.setUint32(12, header.stride, true);\n  view.setUint32(16, header.vertexCount, true);\n  view.setUint32(20, header.vertexBytes, true);\n  view.setUint32(24, header.indexCount, true);\n  view.setUint32(28, header.indexWidth, true);\n  view.setUint32(32, header.indexBytes, true);\n  view.setUint32(36, header.jsonBytes, true);\n  out.set(digestBytes(header.digest), 48);\n}\n\nexport function decodeMeshBinHeader(\n  bytes: Uint8Array,\n  sourceKey = '<unknown mesh source>',\n): MeshBinHeaderResult {\n  if (bytes.byteLength < MESH_BIN_HEADER_V4_BYTES) {\n    return failure(\n      'mesh-bin-header-truncated',\n      sourceKey,\n      `mesh-bin v4 header (${MESH_BIN_HEADER_V4_BYTES} bytes)`,\n      `${bytes.byteLength} bytes`,\n    );\n  }\n  const view = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);\n  const version = view.getUint32(0, true);\n  if (version !== MESH_BIN_VERSION) {\n    return failure('mesh-bin-version-unsupported', sourceKey, 'mesh-bin v4', `version ${version}`);\n  }\n  const projectionVersion = view.getUint32(4, true);\n  const mask = view.getUint32(8, true);\n  const stride = view.getUint32(12, true);\n  const vertexCount = view.getUint32(16, true);\n  const vertexBytes = view.getUint32(20, true);\n  const indexCount = view.getUint32(24, true);\n  const indexWidth = view.getUint32(28, true);\n  const indexBytes = view.getUint32(32, true);\n  const jsonBytes = view.getUint32(36, true);\n  const digest = readDigest(bytes.subarray(48, 48 + MESH_BIN_DIGEST_BYTES));\n  if (\n    projectionVersion !== MESH_BIN_PROJECTION_VERSION ||\n    mask === 0 ||\n    stride === 0 ||\n    !Number.isSafeInteger(vertexCount) ||\n    !Number.isSafeInteger(vertexBytes) ||\n    !Number.isSafeInteger(indexCount) ||\n    !Number.isSafeInteger(indexBytes) ||\n    !Number.isSafeInteger(jsonBytes) ||\n    (indexCount === 0 && indexWidth !== 0) ||\n    (indexCount > 0 && indexWidth !== 2 && indexWidth !== 4) ||\n    indexBytes !== indexCount * indexWidth ||\n    vertexBytes !== vertexCount * stride ||\n    digest.length === 0\n  ) {\n    return failure(\n      'mesh-bin-header-invalid',\n      sourceKey,\n      'safe v4 projection, stride, cardinality, and payload byte lengths',\n      `projection=${projectionVersion}; mask=${mask}; stride=${stride}; vertexBytes=${vertexBytes}; indexBytes=${indexBytes}; digest=${digest}`,\n    );\n  }\n  return {\n    ok: true,\n    value: {\n      version: 4,\n      projectionVersion: 1,\n      mask,\n      digest,\n      stride,\n      vertexCount,\n      vertexBytes,\n      indexCount,\n      indexWidth: indexWidth as 0 | 2 | 4,\n      indexBytes,\n      jsonBytes,\n    },\n  };\n}\n"]}

package/dist/name.mjs

@@ -0,0 +1,22 @@
+// src/deriveAssetName.ts
+function baseName(p) {
+  const trimmed = p.replace(/[/\\]+$/, "");
+  const idx = Math.max(trimmed.lastIndexOf("/"), trimmed.lastIndexOf("\\"));
+  return idx === -1 ? trimmed : trimmed.slice(idx + 1);
+}
+function deriveAssetName(packagePath, assetCount, storedName) {
+  if (packagePath === null) {
+    return storedName ?? "";
+  }
+  if (assetCount === 1) {
+    return baseName(packagePath);
+  }
+  if (storedName !== void 0) {
+    return storedName;
+  }
+  return baseName(packagePath);
+}
+
+export { deriveAssetName };
+//# sourceMappingURL=name.mjs.map
+//# sourceMappingURL=name.mjs.map

package/dist/name.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/deriveAssetName.ts"],"names":[],"mappings":";AAOA,SAAS,SAAS,CAAA,EAAmB;AACnC,EAAA,MAAM,OAAA,GAAU,CAAA,CAAE,OAAA,CAAQ,SAAA,EAAW,EAAE,CAAA;AACvC,EAAA,MAAM,GAAA,GAAM,IAAA,CAAK,GAAA,CAAI,OAAA,CAAQ,WAAA,CAAY,GAAG,CAAA,EAAG,OAAA,CAAQ,WAAA,CAAY,IAAI,CAAC,CAAA;AACxE,EAAA,OAAO,QAAQ,EAAA,GAAK,OAAA,GAAU,OAAA,CAAQ,KAAA,CAAM,MAAM,CAAC,CAAA;AACrD;AAeO,SAAS,eAAA,CACd,WAAA,EACA,UAAA,EACA,UAAA,EACQ;AACR,EAAA,IAAI,gBAAgB,IAAA,EAAM;AACxB,IAAA,OAAO,UAAA,IAAc,EAAA;AAAA,EACvB;AACA,EAAA,IAAI,eAAe,CAAA,EAAG;AACpB,IAAA,OAAO,SAAS,WAAW,CAAA;AAAA,EAC7B;AACA,EAAA,IAAI,eAAe,MAAA,EAAW;AAC5B,IAAA,OAAO,UAAA;AAAA,EACT;AACA,EAAA,OAAO,SAAS,WAAW,CAAA;AAC7B","file":"name.mjs","sourcesContent":["/**\n * Last path segment of a `/`- or `\\`-separated path, trailing separators\n * stripped. Inlined rather than imported from `node:path` so this module stays\n * browser-safe: the dev-server pack path (`vite-plugin-pack` `/__pack/`) runs\n * `buildCatalog` -> `deriveAssetName` in client code where `node:path` is\n * externalized and `path.basename` throws.\n */\nfunction baseName(p: string): string {\n  const trimmed = p.replace(/[/\\\\]+$/, '');\n  const idx = Math.max(trimmed.lastIndexOf('/'), trimmed.lastIndexOf('\\\\'));\n  return idx === -1 ? trimmed : trimmed.slice(idx + 1);\n}\n\n/**\n * Derive an asset's display name from package metadata.\n *\n * Pure function -- zero IO, zero side effects, browser-safe. Build-time\n * (build-catalog) and runtime (resolveName) share this single source of truth\n * for the XOR name-resolution rules (plan-strategy D-6).\n *\n * Branches:\n *   1. single-asset package (assetCount === 1)      -> baseName(packagePath)\n *   2. multi-asset package + storedName              -> storedName\n *   3. multi-asset package + no storedName (AC-15.1) -> baseName(packagePath)\n *   4. null packagePath + no storedName  (AC-15.2)   -> ''\n */\nexport function deriveAssetName(\n  packagePath: string | null,\n  assetCount: number,\n  storedName?: string,\n): string {\n  if (packagePath === null) {\n    return storedName ?? '';\n  }\n  if (assetCount === 1) {\n    return baseName(packagePath);\n  }\n  if (storedName !== undefined) {\n    return storedName;\n  }\n  return baseName(packagePath);\n}\n"]}

package/dist/native-cooker-registry.d.ts

@@ -0,0 +1,47 @@
+import type { AssetCodec, AssetStageError, CookProduct, Result } from '@forgeax/engine-types';
+export interface NativeCookArtifact {
+    readonly mediaType: string;
+    readonly assetCodec?: AssetCodec;
+    readonly bytes: Uint8Array;
+}
+export interface NativeCookDraft<P = unknown> {
+    readonly guid: string;
+    readonly payload: P;
+    readonly refs: readonly string[];
+    readonly artifacts: Readonly<Record<string, NativeCookArtifact>>;
+    readonly inputFingerprint: string;
+}
+export interface NativeCooker<P = unknown, I = unknown> {
+    readonly key: string;
+    readonly discover?: (input: unknown) => I | Promise<I>;
+    cook(input: I): NativeCookDraft<P> | Promise<NativeCookDraft<P>>;
+}
+export interface NativeCookTransactionSnapshot<P = unknown> {
+    readonly draft: NativeCookDraft<P>;
+    readonly generation: number;
+}
+export interface NativeCookTransactionOptions<P = unknown, I = unknown> {
+    readonly key: string;
+    readonly input: I;
+    readonly previous?: NativeCookTransactionSnapshot<P>;
+    readonly validate?: (draft: NativeCookDraft<P>) => string | undefined;
+    readonly publish?: (draft: NativeCookDraft<P>, generation: number) => void | Promise<void>;
+}
+export interface NativeCookTransactionResult<P = unknown> extends NativeCookTransactionSnapshot<P> {
+    readonly status: 'committed' | 'recovered';
+    readonly lastKnownGood: NativeCookDraft<P>;
+    readonly candidateGeneration: number;
+    readonly lastKnownGoodGeneration: number;
+    readonly recoveryHint?: string;
+}
+/** Injectable build-time table for native authored Pack producers. */
+export declare class NativeCookerRegistry {
+    private readonly cookers;
+    register(cooker: NativeCooker): void;
+    get(key: string): NativeCooker | undefined;
+    registeredCookers(): readonly string[];
+    runDraft<P = unknown, I = unknown>(key: string, input: I): Promise<Result<NativeCookDraft<P>, AssetStageError>>;
+    run<P = unknown, I = unknown>(key: string, input: I): Promise<Result<CookProduct<P>, AssetStageError>>;
+    runTransaction<P = unknown, I = unknown>(options: NativeCookTransactionOptions<P, I>): Promise<Result<NativeCookTransactionResult<P>, AssetStageError>>;
+}
+//# sourceMappingURL=native-cooker-registry.d.ts.map

package/dist/native-cooker-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-cooker-registry.d.ts","sourceRoot":"","sources":["../src/native-cooker-registry.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAEV,UAAU,EACV,eAAe,EACf,WAAW,EACX,MAAM,EACP,MAAM,uBAAuB,CAAC;AAG/B,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,CAAC,EAAE,UAAU,CAAC;IACjC,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;CAC5B;AAED,MAAM,WAAW,eAAe,CAAC,CAAC,GAAG,OAAO;IAC1C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC,CAAC;IACjE,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;CACnC;AAED,MAAM,WAAW,YAAY,CAAC,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,OAAO;IACpD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACvD,IAAI,CAAC,KAAK,EAAE,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC;CAClE;AAED,MAAM,WAAW,6BAA6B,CAAC,CAAC,GAAG,OAAO;IACxD,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC,CAAC,CAAC,CAAC;IACnC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,4BAA4B,CAAC,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,OAAO;IACpE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC;IAClB,QAAQ,CAAC,QAAQ,CAAC,EAAE,6BAA6B,CAAC,CAAC,CAAC,CAAC;IACrD,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,eAAe,CAAC,CAAC,CAAC,KAAK,MAAM,GAAG,SAAS,CAAC;IACtE,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,eAAe,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5F;AAED,MAAM,WAAW,2BAA2B,CAAC,CAAC,GAAG,OAAO,CAAE,SAAQ,6BAA6B,CAAC,CAAC,CAAC;IAChG,QAAQ,CAAC,MAAM,EAAE,WAAW,GAAG,WAAW,CAAC;IAC3C,QAAQ,CAAC,aAAa,EAAE,eAAe,CAAC,CAAC,CAAC,CAAC;IAC3C,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,uBAAuB,EAAE,MAAM,CAAC;IACzC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAChC;AA2DD,sEAAsE;AACtE,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAmC;IAE3D,QAAQ,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI;IAUpC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAI1C,iBAAiB,IAAI,SAAS,MAAM,EAAE;IAIhC,QAAQ,CAAC,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,OAAO,EACrC,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,CAAC,GACP,OAAO,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,eAAe,CAAC,CAAC;IAkCjD,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,OAAO,EAChC,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,CAAC,GACP,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,eAAe,CAAC,CAAC;IAgC7C,cAAc,CAAC,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,OAAO,EAC3C,OAAO,EAAE,4BAA4B,CAAC,CAAC,EAAE,CAAC,CAAC,GAC1C,OAAO,CAAC,MAAM,CAAC,2BAA2B,CAAC,CAAC,CAAC,EAAE,eAAe,CAAC,CAAC;CA8BpE"}

package/dist/native-cooker.d.ts

@@ -0,0 +1,3 @@
+/** Node/build-time native cooker registry. The browser-safe pack root excludes this seam. */
+export * from './native-cooker-registry.js';
+//# sourceMappingURL=native-cooker.d.ts.map

package/dist/native-cooker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-cooker.d.ts","sourceRoot":"","sources":["../src/native-cooker.ts"],"names":[],"mappings":"AAAA,6FAA6F;AAC7F,cAAc,6BAA6B,CAAC"}