@plasius/gpu-model-renderer 0.1.5 → 0.2.0

package/README.md

@@ -1,35 +1,130 @@
 # @plasius/gpu-model-renderer
 
-Canonical model to renderer-ready buffers, bounds, materials, skinning, and animation bridge.
+Prepare verified canonical GPU models as renderer-ready geometry, material slots,
+texture resources, joint palettes, skin influences, animation tracks and bounds.
+The package follows site ADR 0094. It does not parse file formats, fetch URLs,
+decode images, evaluate animation, or upload GPU resources.
 
-This repository is the dedicated package boundary defined by ADR 0094.
+## Usage
 
-## Bootstrap status
+```ts
+import { prepareGpuModelRendererInput } from "@plasius/gpu-model-renderer";
 
-This initial repository contains the approved schema baseline, legal and governance files, and a package smoke-test surface. Functional model conversion work is tracked in the repository's [TASK] issues and must flow through the canonical GPU model boundary.
+// document is factory output from the same @plasius/gpu-model-core instance.
+// The source adapter/runtime owns loading, hashing and resource verification.
+const prepared = await prepareGpuModelRendererInput(document, {
+  conversionEnabled: remotelyEvaluatedConversionFlag,
+  signal: abortController.signal,
+  timeoutMs: 30_000,
+  maxDecodedBytes: 64 * 1024 * 1024,
+});
 
-## Rollout
+// Load the renderer only when needed. Image decoding is owned by the host.
+const { createCanonicalWavefrontMeshInputs } = await import("@plasius/gpu-renderer");
+const meshes = createCanonicalWavefrontMeshInputs({
+  document: prepared.document,
+  geometry: prepared.geometry,
+  textures: decodedTextureSamplesByCanonicalTextureId,
+});
+```
+
+The renderer is a consumer dependency, not a runtime dependency of this bridge.
+The example maps **mesh-local geometry**. Before rendering a scene, the host must
+apply `nodes`/`roots` transforms and instancing, and handle skins, morph targets
+and animation. `bounds` retains the validated **world-space** canonical bounds.
+The current Wavefront canonical adapter supports triangle primitives and a
+subset of canonical materials. It rejects unsupported topology/workflows;
+callers must preserve that failure or select another renderer. Passing geometry
+alone does not bake a scene or implement animation.
+
+`primitives` retains every attribute semantic and a zero-based `materialSlot`
+(`null` for the default material). `accessors` contains tightly packed,
+little-endian-decoded buffers, including animation and morph accessors.
+Non-normalized unsigned integers use `Uint32Array`; other components use
+`Float32Array`, including normalized integer attributes. Indices never pass
+through floating-point conversion. Missing normals remain absent so the
+renderer owns its existing normal fallback.
+
+`skins` contains ordered joint IDs, packed inverse bind matrices, joint indices
+and weights. `animations` contains channels, interpolation and decoded sampler
+inputs/outputs. The full immutable `document` retains clip names, source
+metadata, material extensions, texture binding transforms, colour spaces,
+samplers, analytic source references, and diagnostics. Texture entries pair
+canonical metadata with verified encoded image resources. Image decoders must
+apply their own output limits; the bridge makes no image/network requests.
+
+## Validation and failure handling
+
+Only privately verified `GpuModelDocument` factory output is accepted. Plain
+objects and structured clones fail closed; verify clones through
+`createAndVerifyGpuModelDocument` in the receiving core instance. Keep core
+versions/module instances consistent across adapters and bridge consumers.
+The deprecated `packageBootstrap` identity export remains compatible.
 
-- Feature flag: gpu.model.conversion.enabled
-- Capability: none for this package-only layer
-- Rollback: disable the feature flag and keep the published package version pinned to the last validated release
+Optional `diagnostics` uses the core `GpuModelDiagnosticInput` contract. Core
+owns strict/tolerant/forensic evaluation and bounded repair/loss/evidence
+ledgers. Strict is the default. Tolerant reports describe repairs already
+performed by a source adapter; the bridge performs no repairs. Rejected reports
+or canonical error diagnostics prevent preparation in every mode. Forensic raw
+evidence is returned only in its explicit report and is never logged here.
 
-## Development
+`GpuModelRendererError.code` distinguishes `feature-disabled`,
+`unverified-document`, `invalid-options`, `budget-exceeded`, `aborted`,
+`diagnostics-rejected`, and `resource-read-failed`. Core may also throw its
+bounded diagnostics error for malformed reports. Errors contain no payloads,
+source URLs or identifiers. No partial output is returned.
 
-Requires Node.js 24 and npm.
+The default/fixed ceiling is 64 MiB for encoded buffer copies plus decoded
+accessors and skin buffers, preflighted before allocation. The timeout defaults
+to 30 seconds and can only be tightened. Resource acquisition is sequential,
+with no retries or shared mutable cache. Cancellation/deadline failures discard
+partial output. CPU loops check the deadline; run large models in a host worker
+so cancellation and main-thread responsiveness remain under host control.
+Output containers are frozen; typed arrays are intentionally consumer-owned
+and mutable for GPU upload. Accessor views within one result may share a buffer.
+Mutations never affect the canonical document or a subsequent preparation.
+
+## Rollout and rollback
+
+- Parent Feature: [site #1153](https://github.com/Plasius-LTD/plasius-ltd-site/issues/1153).
+- Feature flag: `gpu.model.conversion.enabled`.
+- Source-of-truth evaluator: the host's remote feature-flag service; pass its
+  decision as `conversionEnabled` on every preparation. Omission/false rejects.
+- Capability: none for this data-only package layer.
+- Rollback: disable the remote flag, cancel outstanding preparation via its
+  signal, and retain the previous consumer loader and validated package pin.
+  No local environment value is used as the normal control plane.
+
+## Development and release
+
+Requires the Node.js 24 version pinned in `.nvmrc` and npm.
 
 ```bash
 npm ci
 npm run typecheck
 npm test
+npm run test:coverage
 npm run lint
 npm run build
+npm run pack:check
 npm pack --dry-run
 ```
 
-## License
+Tests cover canonical geometry/accessor fidelity, scene/rig/animation retention,
+rollout and error paths, and the published runtime -> bridge -> published
+renderer material-atlas/mesh-acceleration boundary. The runtime test adapter is
+a deterministic canonical fixture, **not** a glTF parser. These tests do not
+prove the full format conformance matrix in site Story #1160: the current
+published GLB canonical importer supports a narrower texture-free static
+profile. Actual format-adapter support must be verified separately.
+
+Dependencies added for this API: runtime core `0.4.6` (canonical validation and
+diagnostics); test-only runtime `0.2.4` and renderer `0.2.51` (published consumer
+contract checks). No local package references or format SDKs are introduced.
+See [ADR 0006](docs/adrs/adr-0006-canonical-renderer-preparation.md) and the
+[design and NFR evidence](docs/design/canonical-renderer-preparation.md).
 
-Apache-2.0. See LICENSE, SECURITY.md, and the files under legal/.
+Apache-2.0. See LICENSE, SECURITY.md, and legal/.
 
 <!-- BEGIN PLASIUS RELEASE INTEGRITY -->
 ## Release integrity

package/dist/index.cjs

@@ -20,10 +20,204 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
+  GPU_MODEL_RENDERER_FEATURE_FLAG: () => GPU_MODEL_RENDERER_FEATURE_FLAG,
+  GPU_MODEL_RENDERER_MAX_DECODED_BYTES: () => GPU_MODEL_RENDERER_MAX_DECODED_BYTES,
+  GpuModelRendererError: () => GpuModelRendererError,
   packageBootstrap: () => packageBootstrap,
-  packageName: () => packageName
+  packageName: () => packageName,
+  prepareGpuModelRendererInput: () => prepareGpuModelRendererInput
 });
 module.exports = __toCommonJS(index_exports);
+
+// src/renderer-input.ts
+var import_gpu_model_core = require("@plasius/gpu-model-core");
+var GPU_MODEL_RENDERER_MAX_DECODED_BYTES = 64 * 1024 * 1024;
+var GPU_MODEL_RENDERER_FEATURE_FLAG = "gpu.model.conversion.enabled";
+var GpuModelRendererError = class extends Error {
+  constructor(code) {
+    super(`GPU model renderer preparation failed: ${code}`);
+    this.code = code;
+    this.name = "GpuModelRendererError";
+  }
+  code;
+};
+var COMPONENT_BYTES = { i8: 1, u8: 1, i16: 2, u16: 2, u32: 4, f32: 4 };
+var COMPONENTS = { scalar: 1, vec2: 2, vec3: 3, vec4: 4, mat2: 4, mat3: 9, mat4: 16 };
+var readBlob = Blob.prototype.arrayBuffer;
+function decode(accessor, view, check) {
+  const size = COMPONENT_BYTES[accessor.componentType];
+  const width = COMPONENTS[accessor.elementType];
+  const stride = accessor.byteStride ?? size * width;
+  const output = ["u8", "u16", "u32"].includes(accessor.componentType) && !accessor.normalized ? new Uint32Array(accessor.count * width) : new Float32Array(accessor.count * width);
+  for (let index = 0; index < output.length; index += 1) {
+    if (index % 4096 === 0) check();
+    const offset = accessor.byteOffset + Math.floor(index / width) * stride + index % width * size;
+    let value;
+    switch (accessor.componentType) {
+      case "i8":
+        value = view.getInt8(offset);
+        break;
+      case "u8":
+        value = view.getUint8(offset);
+        break;
+      case "i16":
+        value = view.getInt16(offset, true);
+        break;
+      case "u16":
+        value = view.getUint16(offset, true);
+        break;
+      case "u32":
+        value = view.getUint32(offset, true);
+        break;
+      case "f32":
+        value = view.getFloat32(offset, true);
+        break;
+    }
+    if (accessor.normalized) {
+      const divisor = { i8: 127, u8: 255, i16: 32767, u16: 65535, u32: 4294967295, f32: 1 }[accessor.componentType];
+      value = Math.max(-1, value / divisor);
+    }
+    output[index] = value;
+  }
+  return output;
+}
+async function prepareGpuModelRendererInput(value, options) {
+  if (options?.conversionEnabled !== true) throw new GpuModelRendererError("feature-disabled");
+  if (!(0, import_gpu_model_core.isGpuModelDocument)(value)) throw new GpuModelRendererError("unverified-document");
+  const document = value;
+  const maxBytes = options.maxDecodedBytes ?? GPU_MODEL_RENDERER_MAX_DECODED_BYTES;
+  const timeoutMs = options.timeoutMs ?? 3e4;
+  if (!Number.isSafeInteger(maxBytes) || maxBytes < 1 || maxBytes > GPU_MODEL_RENDERER_MAX_DECODED_BYTES || !Number.isSafeInteger(timeoutMs) || timeoutMs < 1 || timeoutMs > 3e4) {
+    throw new GpuModelRendererError("invalid-options");
+  }
+  const diagnosticReport = options.diagnostics === void 0 ? void 0 : (0, import_gpu_model_core.evaluateGpuModelDiagnostics)(options.diagnostics);
+  if (diagnosticReport?.accepted === false || document.diagnostics.some(({ severity }) => severity === "error")) {
+    throw new GpuModelRendererError("diagnostics-rejected");
+  }
+  let allocation = 0;
+  for (const accessor of document.accessors) allocation += accessor.count * COMPONENTS[accessor.elementType] * 4;
+  for (const skin of document.skins) {
+    allocation += skin.inverseBindMatrices.length * 16 * 4;
+    for (const weights of skin.weightSets) allocation += weights.joints.length * weights.influencesPerVertex * 8;
+  }
+  for (const resource of document.resources) if (resource.kind === "buffer") allocation += resource.byteLength;
+  if (allocation > maxBytes) throw new GpuModelRendererError("budget-exceeded");
+  const deadline = performance.now() + timeoutMs;
+  const check = () => {
+    if (options.signal?.aborted || performance.now() >= deadline) throw new GpuModelRendererError("aborted");
+  };
+  check();
+  const accessors = /* @__PURE__ */ Object.create(null);
+  const accessorsByResource = /* @__PURE__ */ new Map();
+  for (const accessor of document.accessors) {
+    const entries = accessorsByResource.get(accessor.resourceId) ?? [];
+    entries.push(accessor);
+    accessorsByResource.set(accessor.resourceId, entries);
+  }
+  for (const resource of document.resources) {
+    const entries = accessorsByResource.get(resource.id);
+    if (!entries) continue;
+    let timer;
+    let abort;
+    try {
+      const buffer = await new Promise((resolve, reject) => {
+        abort = () => reject(new GpuModelRendererError("aborted"));
+        options.signal?.addEventListener("abort", abort, { once: true });
+        timer = setTimeout(abort, Math.max(1, deadline - performance.now()));
+        readBlob.call(resource.payload).then(resolve, () => reject(new GpuModelRendererError("resource-read-failed")));
+      });
+      check();
+      const view = new DataView(buffer);
+      for (const accessor of entries) {
+        check();
+        accessors[accessor.id] = decode(accessor, view, check);
+      }
+    } finally {
+      clearTimeout(timer);
+      if (abort) options.signal?.removeEventListener("abort", abort);
+    }
+  }
+  const primitives = [];
+  const geometry = [];
+  const materialSlots = new Map(document.materials.map((material, index) => [material.id, index]));
+  for (const mesh of document.meshes) for (const primitive of mesh.primitives) {
+    check();
+    const attributes = /* @__PURE__ */ Object.create(null);
+    for (const attribute of primitive.attributes) attributes[attribute.semantic] = accessors[attribute.accessorId];
+    primitives.push(Object.freeze({
+      meshId: mesh.id,
+      primitiveId: primitive.id,
+      topology: primitive.topology,
+      materialSlot: primitive.materialId === void 0 ? null : materialSlots.get(primitive.materialId),
+      attributes: Object.freeze(attributes)
+    }));
+    geometry.push(Object.freeze({
+      primitiveId: primitive.id,
+      positions: attributes.POSITION,
+      ...primitive.indicesAccessorId === void 0 ? {} : { indices: accessors[primitive.indicesAccessorId] },
+      ...attributes.NORMAL === void 0 ? {} : { normals: attributes.NORMAL },
+      ...attributes.TEXCOORD_0 === void 0 ? {} : { texcoords: attributes.TEXCOORD_0 }
+    }));
+  }
+  const pack = (rows, output) => {
+    let offset = 0;
+    for (const row of rows) {
+      check();
+      output.set(row, offset);
+      offset += row.length;
+    }
+    return output;
+  };
+  const skins = document.skins.map((skin) => {
+    check();
+    return Object.freeze({
+      id: skin.id,
+      skeletonId: skin.skeletonId,
+      jointIds: skin.jointIds,
+      inverseBindMatrices: pack(skin.inverseBindMatrices, new Float32Array(skin.inverseBindMatrices.length * 16)),
+      weightSets: Object.freeze(skin.weightSets.map((weights) => Object.freeze({
+        primitiveId: weights.primitiveId,
+        influencesPerVertex: weights.influencesPerVertex,
+        joints: pack(weights.joints, new Uint32Array(weights.joints.length * weights.influencesPerVertex)),
+        weights: pack(weights.weights, new Float32Array(weights.weights.length * weights.influencesPerVertex))
+      })))
+    });
+  });
+  const animations = document.animations.map((animation) => Object.freeze({
+    id: animation.id,
+    durationSeconds: animation.durationSeconds,
+    channels: animation.channels,
+    samplers: Object.freeze(animation.samplers.map((sampler) => Object.freeze({
+      id: sampler.id,
+      interpolation: sampler.interpolation,
+      input: accessors[sampler.inputAccessorId],
+      output: accessors[sampler.outputAccessorId]
+    })))
+  }));
+  const resources = new Map(document.resources.map((resource) => [resource.id, resource]));
+  check();
+  return Object.freeze({
+    document,
+    bounds: document.bounds,
+    roots: document.roots,
+    nodes: document.nodes,
+    materials: document.materials,
+    skeletons: document.skeletons,
+    joints: document.joints,
+    blendShapes: document.blendShapes,
+    analyticGeometry: document.analyticGeometry,
+    diagnostics: document.diagnostics,
+    ...diagnosticReport === void 0 ? {} : { diagnosticReport },
+    accessors: Object.freeze(accessors),
+    primitives: Object.freeze(primitives),
+    geometry: Object.freeze(geometry),
+    skins: Object.freeze(skins),
+    animations: Object.freeze(animations),
+    textures: Object.freeze(document.textures.map((texture) => Object.freeze({ texture, resource: resources.get(texture.imageResourceId) })))
+  });
+}
+
+// src/index.ts
 var packageName = "@plasius/gpu-model-renderer";
 var packageBootstrap = Object.freeze({
   packageName,
@@ -32,7 +226,11 @@ var packageBootstrap = Object.freeze({
 });
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  GPU_MODEL_RENDERER_FEATURE_FLAG,
+  GPU_MODEL_RENDERER_MAX_DECODED_BYTES,
+  GpuModelRendererError,
   packageBootstrap,
-  packageName
+  packageName,
+  prepareGpuModelRendererInput
 });
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["/** Package identity and rollout metadata for the initial repository baseline. */\nexport const packageName = \"@plasius/gpu-model-renderer\" as const;\n\nexport const packageBootstrap = Object.freeze({\n  packageName,\n  featureFlag: \"gpu.model.conversion.enabled\",\n  status: \"bootstrap\",\n} as const);\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AACO,IAAM,cAAc;AAEpB,IAAM,mBAAmB,OAAO,OAAO;AAAA,EAC5C;AAAA,EACA,aAAa;AAAA,EACb,QAAQ;AACV,CAAU;","names":[]}
+{"version":3,"sources":["../src/index.ts","../src/renderer-input.ts"],"sourcesContent":["/** Package identity and rollout metadata for the initial repository baseline. */\nexport const packageName = \"@plasius/gpu-model-renderer\" as const;\n\n/** @deprecated Retained for compatibility with the bootstrap package identity. */\nexport const packageBootstrap = Object.freeze({\n  packageName,\n  featureFlag: \"gpu.model.conversion.enabled\",\n  status: \"bootstrap\",\n} as const);\n\nexport * from \"./renderer-input.js\";\n","import {\n  evaluateGpuModelDiagnostics, isGpuModelDocument,\n  type GpuModelAccessor, type GpuModelDiagnosticInput, type GpuModelDiagnosticReport,\n  type GpuModelDocument, type GpuModelResource, type GpuModelTexture,\n} from \"@plasius/gpu-model-core\";\n\n/** Fixed allocation ceiling; callers may tighten it, never raise it. */\nexport const GPU_MODEL_RENDERER_MAX_DECODED_BYTES = 64 * 1024 * 1024;\n/** Remotely evaluated parent Feature flag. No environment override is read here. */\nexport const GPU_MODEL_RENDERER_FEATURE_FLAG = \"gpu.model.conversion.enabled\";\n\n/** Stable, payload-free failure categories for callers and worker boundaries. */\nexport type GpuModelRendererErrorCode = \"feature-disabled\" | \"unverified-document\" | \"invalid-options\" | \"budget-exceeded\" | \"aborted\" | \"diagnostics-rejected\" | \"resource-read-failed\";\n/** Bounded errors deliberately omit source paths, URIs and payload content. */\nexport class GpuModelRendererError extends Error {\n  public constructor(public readonly code: GpuModelRendererErrorCode) {\n    super(`GPU model renderer preparation failed: ${code}`);\n    this.name = \"GpuModelRendererError\";\n  }\n}\n\n/** Consumer-owned buffers; changing them never changes the canonical document. */\nexport type GpuModelRendererBuffer = Float32Array | Uint32Array;\n/** Decode policy. Gate decisions must come from the host's remote flag evaluator. */\nexport interface GpuModelRendererOptions {\n  readonly conversionEnabled: boolean;\n  readonly signal?: AbortSignal;\n  readonly timeoutMs?: number;\n  readonly maxDecodedBytes?: number;\n  readonly diagnostics?: GpuModelDiagnosticInput;\n}\n/** Geometry in mesh-local coordinates, directly usable by the canonical renderer adapter. */\nexport interface GpuModelRendererGeometry {\n  readonly primitiveId: string;\n  readonly positions: Float32Array;\n  readonly indices?: Uint32Array;\n  readonly normals?: Float32Array;\n  readonly texcoords?: Float32Array;\n}\n/** All attributes are retained, including UV sets, colours, joints and custom semantics. */\nexport interface GpuModelRendererPrimitive {\n  readonly meshId: string;\n  readonly primitiveId: string;\n  readonly topology: GpuModelDocument[\"meshes\"][number][\"primitives\"][number][\"topology\"];\n  /** Zero-based canonical material index; null denotes the renderer's default material. */\n  readonly materialSlot: number | null;\n  readonly attributes: Readonly<Record<string, GpuModelRendererBuffer>>;\n}\n/** Ordered joint palette and packed vertex influences; no animation is evaluated or baked. */\nexport interface GpuModelRendererSkin {\n  readonly id: string;\n  readonly skeletonId: string;\n  readonly jointIds: readonly string[];\n  readonly inverseBindMatrices: Float32Array;\n  readonly weightSets: readonly {\n    readonly primitiveId: string;\n    readonly influencesPerVertex: number;\n    readonly joints: Uint32Array;\n    readonly weights: Float32Array;\n  }[];\n}\n/** Canonical clip semantics with decoded, tightly packed sampler buffers. */\nexport interface GpuModelRendererAnimation {\n  readonly id: string;\n  readonly durationSeconds: number;\n  readonly channels: GpuModelDocument[\"animations\"][number][\"channels\"];\n  readonly samplers: readonly {\n    readonly id: string;\n    readonly interpolation: GpuModelDocument[\"animations\"][number][\"samplers\"][number][\"interpolation\"];\n    readonly input: GpuModelRendererBuffer;\n    readonly output: GpuModelRendererBuffer;\n  }[];\n}\n/** Verified images remain encoded; the caller chooses its decoder/upload strategy. */\nexport interface GpuModelRendererTexture {\n  readonly texture: GpuModelTexture;\n  readonly resource: GpuModelResource;\n}\n/** Scene-aware preparation result. Geometry alone is not a baked world-space scene. */\nexport interface GpuModelRendererInput {\n  readonly document: GpuModelDocument;\n  readonly bounds: GpuModelDocument[\"bounds\"];\n  readonly roots: GpuModelDocument[\"roots\"];\n  readonly nodes: GpuModelDocument[\"nodes\"];\n  readonly materials: GpuModelDocument[\"materials\"];\n  readonly skeletons: GpuModelDocument[\"skeletons\"];\n  readonly joints: GpuModelDocument[\"joints\"];\n  readonly blendShapes: GpuModelDocument[\"blendShapes\"];\n  readonly analyticGeometry: GpuModelDocument[\"analyticGeometry\"];\n  readonly diagnostics: GpuModelDocument[\"diagnostics\"];\n  readonly diagnosticReport?: GpuModelDiagnosticReport;\n  readonly accessors: Readonly<Record<string, GpuModelRendererBuffer>>;\n  readonly geometry: readonly GpuModelRendererGeometry[];\n  readonly primitives: readonly GpuModelRendererPrimitive[];\n  readonly textures: readonly GpuModelRendererTexture[];\n  readonly skins: readonly GpuModelRendererSkin[];\n  readonly animations: readonly GpuModelRendererAnimation[];\n}\n\nconst COMPONENT_BYTES = { i8: 1, u8: 1, i16: 2, u16: 2, u32: 4, f32: 4 } as const;\nconst COMPONENTS = { scalar: 1, vec2: 2, vec3: 3, vec4: 4, mat2: 4, mat3: 9, mat4: 16 } as const;\n\nconst readBlob = Blob.prototype.arrayBuffer;\n\nfunction decode(accessor: GpuModelAccessor, view: DataView, check: () => void): GpuModelRendererBuffer {\n  const size = COMPONENT_BYTES[accessor.componentType];\n  const width = COMPONENTS[accessor.elementType];\n  const stride = accessor.byteStride ?? size * width;\n  const output = [\"u8\", \"u16\", \"u32\"].includes(accessor.componentType) && !accessor.normalized\n    ? new Uint32Array(accessor.count * width)\n    : new Float32Array(accessor.count * width);\n  for (let index = 0; index < output.length; index += 1) {\n    if (index % 4096 === 0) check();\n    const offset = accessor.byteOffset + Math.floor(index / width) * stride + (index % width) * size;\n    let value: number;\n    switch (accessor.componentType) {\n      case \"i8\": value = view.getInt8(offset); break;\n      case \"u8\": value = view.getUint8(offset); break;\n      case \"i16\": value = view.getInt16(offset, true); break;\n      case \"u16\": value = view.getUint16(offset, true); break;\n      case \"u32\": value = view.getUint32(offset, true); break;\n      case \"f32\": value = view.getFloat32(offset, true); break;\n    }\n    if (accessor.normalized) {\n      const divisor = { i8: 127, u8: 255, i16: 32767, u16: 65535, u32: 4294967295, f32: 1 }[accessor.componentType];\n      value = Math.max(-1, value / divisor);\n    }\n    output[index] = value;\n  }\n  return output;\n}\n\n/**\n * Prepares privately verified core output without parsing source formats, fetching\n * resources or importing a renderer. Structured clones must be reverified by core.\n * Run on a host worker for large inputs. Operations are sequential, bounded and\n * have no retries. The host owns scene transforms and animation evaluation.\n */\nexport async function prepareGpuModelRendererInput(\n  value: unknown,\n  options?: GpuModelRendererOptions,\n): Promise<GpuModelRendererInput> {\n  if (options?.conversionEnabled !== true) throw new GpuModelRendererError(\"feature-disabled\");\n  if (!isGpuModelDocument(value)) throw new GpuModelRendererError(\"unverified-document\");\n  const document = value;\n  const maxBytes = options.maxDecodedBytes ?? GPU_MODEL_RENDERER_MAX_DECODED_BYTES;\n  const timeoutMs = options.timeoutMs ?? 30_000;\n  if (!Number.isSafeInteger(maxBytes) || maxBytes < 1 || maxBytes > GPU_MODEL_RENDERER_MAX_DECODED_BYTES\n    || !Number.isSafeInteger(timeoutMs) || timeoutMs < 1 || timeoutMs > 30_000) {\n    throw new GpuModelRendererError(\"invalid-options\");\n  }\n  const diagnosticReport = options.diagnostics === undefined ? undefined : evaluateGpuModelDiagnostics(options.diagnostics);\n  if (diagnosticReport?.accepted === false || document.diagnostics.some(({ severity }) => severity === \"error\")) {\n    throw new GpuModelRendererError(\"diagnostics-rejected\");\n  }\n  let allocation = 0;\n  for (const accessor of document.accessors) allocation += accessor.count * COMPONENTS[accessor.elementType] * 4;\n  for (const skin of document.skins) {\n    allocation += skin.inverseBindMatrices.length * 16 * 4;\n    for (const weights of skin.weightSets) allocation += weights.joints.length * weights.influencesPerVertex * 8;\n  }\n  // Include copies of encoded buffers in the peak budget; image bytes are not decoded here.\n  for (const resource of document.resources) if (resource.kind === \"buffer\") allocation += resource.byteLength;\n  if (allocation > maxBytes) throw new GpuModelRendererError(\"budget-exceeded\");\n  const deadline = performance.now() + timeoutMs;\n  const check = () => {\n    if (options.signal?.aborted || performance.now() >= deadline) throw new GpuModelRendererError(\"aborted\");\n  };\n  check();\n  const accessors: Record<string, GpuModelRendererBuffer> = Object.create(null);\n  // One bounded read at a time. Abort/deadline rejects even if a host read stalls.\n  const accessorsByResource = new Map<string, GpuModelAccessor[]>();\n  for (const accessor of document.accessors) {\n    const entries = accessorsByResource.get(accessor.resourceId) ?? [];\n    entries.push(accessor);\n    accessorsByResource.set(accessor.resourceId, entries);\n  }\n  for (const resource of document.resources) {\n    const entries = accessorsByResource.get(resource.id);\n    if (!entries) continue;\n    let timer: ReturnType<typeof setTimeout> | undefined;\n    let abort: (() => void) | undefined;\n    try {\n      const buffer = await new Promise<ArrayBuffer>((resolve, reject) => {\n        abort = () => reject(new GpuModelRendererError(\"aborted\"));\n        options.signal?.addEventListener(\"abort\", abort, { once: true });\n        timer = setTimeout(abort, Math.max(1, deadline - performance.now()));\n        readBlob.call(resource.payload).then(resolve, () => reject(new GpuModelRendererError(\"resource-read-failed\")));\n      });\n      check();\n      const view = new DataView(buffer);\n      for (const accessor of entries) {\n        check();\n        accessors[accessor.id] = decode(accessor, view, check);\n      }\n    } finally {\n      clearTimeout(timer);\n      if (abort) options.signal?.removeEventListener(\"abort\", abort);\n    }\n  }\n  const primitives: GpuModelRendererPrimitive[] = [];\n  const geometry: GpuModelRendererGeometry[] = [];\n  const materialSlots = new Map(document.materials.map((material, index) => [material.id, index]));\n  for (const mesh of document.meshes) for (const primitive of mesh.primitives) {\n    check();\n    const attributes: Record<string, GpuModelRendererBuffer> = Object.create(null);\n    for (const attribute of primitive.attributes) attributes[attribute.semantic] = accessors[attribute.accessorId]!;\n    primitives.push(Object.freeze({ meshId: mesh.id, primitiveId: primitive.id, topology: primitive.topology,\n      materialSlot: primitive.materialId === undefined ? null : materialSlots.get(primitive.materialId)!, attributes: Object.freeze(attributes) }));\n    geometry.push(Object.freeze({ primitiveId: primitive.id, positions: attributes.POSITION! as Float32Array,\n      ...(primitive.indicesAccessorId === undefined ? {} : { indices: accessors[primitive.indicesAccessorId]! as Uint32Array }),\n      ...(attributes.NORMAL === undefined ? {} : { normals: attributes.NORMAL as Float32Array }),\n      ...(attributes.TEXCOORD_0 === undefined ? {} : { texcoords: attributes.TEXCOORD_0 as Float32Array }) }));\n  }\n  const pack = <T extends Float32Array | Uint32Array>(rows: readonly (readonly number[])[], output: T): T => {\n    let offset = 0;\n    for (const row of rows) { check(); output.set(row, offset); offset += row.length; }\n    return output;\n  };\n  const skins = document.skins.map(skin => {\n    check();\n    return Object.freeze({ id: skin.id, skeletonId: skin.skeletonId, jointIds: skin.jointIds,\n      inverseBindMatrices: pack(skin.inverseBindMatrices, new Float32Array(skin.inverseBindMatrices.length * 16)),\n      weightSets: Object.freeze(skin.weightSets.map(weights => Object.freeze({ primitiveId: weights.primitiveId,\n        influencesPerVertex: weights.influencesPerVertex, joints: pack(weights.joints, new Uint32Array(weights.joints.length * weights.influencesPerVertex)), weights: pack(weights.weights, new Float32Array(weights.weights.length * weights.influencesPerVertex)) }))) });\n  });\n  const animations = document.animations.map(animation => Object.freeze({ id: animation.id, durationSeconds: animation.durationSeconds,\n    channels: animation.channels, samplers: Object.freeze(animation.samplers.map(sampler => Object.freeze({ id: sampler.id,\n      interpolation: sampler.interpolation, input: accessors[sampler.inputAccessorId]!, output: accessors[sampler.outputAccessorId]! }))) }));\n  const resources = new Map(document.resources.map(resource => [resource.id, resource]));\n  check();\n  return Object.freeze({ document, bounds: document.bounds, roots: document.roots, nodes: document.nodes, materials: document.materials,\n    skeletons: document.skeletons, joints: document.joints, blendShapes: document.blendShapes, analyticGeometry: document.analyticGeometry,\n    diagnostics: document.diagnostics, ...(diagnosticReport === undefined ? {} : { diagnosticReport }), accessors: Object.freeze(accessors),\n    primitives: Object.freeze(primitives), geometry: Object.freeze(geometry), skins: Object.freeze(skins), animations: Object.freeze(animations),\n    textures: Object.freeze(document.textures.map(texture => Object.freeze({ texture, resource: resources.get(texture.imageResourceId)! }))) });\n}\n"],"mappings":"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","names":[]}

package/dist/index.d.cts

@@ -1,9 +1,108 @@
+import { GpuModelDocument, GpuModelDiagnosticReport, GpuModelTexture, GpuModelResource, GpuModelDiagnosticInput } from '@plasius/gpu-model-core';
+
+/** Fixed allocation ceiling; callers may tighten it, never raise it. */
+declare const GPU_MODEL_RENDERER_MAX_DECODED_BYTES: number;
+/** Remotely evaluated parent Feature flag. No environment override is read here. */
+declare const GPU_MODEL_RENDERER_FEATURE_FLAG = "gpu.model.conversion.enabled";
+/** Stable, payload-free failure categories for callers and worker boundaries. */
+type GpuModelRendererErrorCode = "feature-disabled" | "unverified-document" | "invalid-options" | "budget-exceeded" | "aborted" | "diagnostics-rejected" | "resource-read-failed";
+/** Bounded errors deliberately omit source paths, URIs and payload content. */
+declare class GpuModelRendererError extends Error {
+    readonly code: GpuModelRendererErrorCode;
+    constructor(code: GpuModelRendererErrorCode);
+}
+/** Consumer-owned buffers; changing them never changes the canonical document. */
+type GpuModelRendererBuffer = Float32Array | Uint32Array;
+/** Decode policy. Gate decisions must come from the host's remote flag evaluator. */
+interface GpuModelRendererOptions {
+    readonly conversionEnabled: boolean;
+    readonly signal?: AbortSignal;
+    readonly timeoutMs?: number;
+    readonly maxDecodedBytes?: number;
+    readonly diagnostics?: GpuModelDiagnosticInput;
+}
+/** Geometry in mesh-local coordinates, directly usable by the canonical renderer adapter. */
+interface GpuModelRendererGeometry {
+    readonly primitiveId: string;
+    readonly positions: Float32Array;
+    readonly indices?: Uint32Array;
+    readonly normals?: Float32Array;
+    readonly texcoords?: Float32Array;
+}
+/** All attributes are retained, including UV sets, colours, joints and custom semantics. */
+interface GpuModelRendererPrimitive {
+    readonly meshId: string;
+    readonly primitiveId: string;
+    readonly topology: GpuModelDocument["meshes"][number]["primitives"][number]["topology"];
+    /** Zero-based canonical material index; null denotes the renderer's default material. */
+    readonly materialSlot: number | null;
+    readonly attributes: Readonly<Record<string, GpuModelRendererBuffer>>;
+}
+/** Ordered joint palette and packed vertex influences; no animation is evaluated or baked. */
+interface GpuModelRendererSkin {
+    readonly id: string;
+    readonly skeletonId: string;
+    readonly jointIds: readonly string[];
+    readonly inverseBindMatrices: Float32Array;
+    readonly weightSets: readonly {
+        readonly primitiveId: string;
+        readonly influencesPerVertex: number;
+        readonly joints: Uint32Array;
+        readonly weights: Float32Array;
+    }[];
+}
+/** Canonical clip semantics with decoded, tightly packed sampler buffers. */
+interface GpuModelRendererAnimation {
+    readonly id: string;
+    readonly durationSeconds: number;
+    readonly channels: GpuModelDocument["animations"][number]["channels"];
+    readonly samplers: readonly {
+        readonly id: string;
+        readonly interpolation: GpuModelDocument["animations"][number]["samplers"][number]["interpolation"];
+        readonly input: GpuModelRendererBuffer;
+        readonly output: GpuModelRendererBuffer;
+    }[];
+}
+/** Verified images remain encoded; the caller chooses its decoder/upload strategy. */
+interface GpuModelRendererTexture {
+    readonly texture: GpuModelTexture;
+    readonly resource: GpuModelResource;
+}
+/** Scene-aware preparation result. Geometry alone is not a baked world-space scene. */
+interface GpuModelRendererInput {
+    readonly document: GpuModelDocument;
+    readonly bounds: GpuModelDocument["bounds"];
+    readonly roots: GpuModelDocument["roots"];
+    readonly nodes: GpuModelDocument["nodes"];
+    readonly materials: GpuModelDocument["materials"];
+    readonly skeletons: GpuModelDocument["skeletons"];
+    readonly joints: GpuModelDocument["joints"];
+    readonly blendShapes: GpuModelDocument["blendShapes"];
+    readonly analyticGeometry: GpuModelDocument["analyticGeometry"];
+    readonly diagnostics: GpuModelDocument["diagnostics"];
+    readonly diagnosticReport?: GpuModelDiagnosticReport;
+    readonly accessors: Readonly<Record<string, GpuModelRendererBuffer>>;
+    readonly geometry: readonly GpuModelRendererGeometry[];
+    readonly primitives: readonly GpuModelRendererPrimitive[];
+    readonly textures: readonly GpuModelRendererTexture[];
+    readonly skins: readonly GpuModelRendererSkin[];
+    readonly animations: readonly GpuModelRendererAnimation[];
+}
+/**
+ * Prepares privately verified core output without parsing source formats, fetching
+ * resources or importing a renderer. Structured clones must be reverified by core.
+ * Run on a host worker for large inputs. Operations are sequential, bounded and
+ * have no retries. The host owns scene transforms and animation evaluation.
+ */
+declare function prepareGpuModelRendererInput(value: unknown, options?: GpuModelRendererOptions): Promise<GpuModelRendererInput>;
+
 /** Package identity and rollout metadata for the initial repository baseline. */
 declare const packageName: "@plasius/gpu-model-renderer";
+/** @deprecated Retained for compatibility with the bootstrap package identity. */
 declare const packageBootstrap: Readonly<{
     readonly packageName: "@plasius/gpu-model-renderer";
     readonly featureFlag: "gpu.model.conversion.enabled";
     readonly status: "bootstrap";
 }>;
 
-export { packageBootstrap, packageName };
+export { GPU_MODEL_RENDERER_FEATURE_FLAG, GPU_MODEL_RENDERER_MAX_DECODED_BYTES, type GpuModelRendererAnimation, type GpuModelRendererBuffer, GpuModelRendererError, type GpuModelRendererErrorCode, type GpuModelRendererGeometry, type GpuModelRendererInput, type GpuModelRendererOptions, type GpuModelRendererPrimitive, type GpuModelRendererSkin, type GpuModelRendererTexture, packageBootstrap, packageName, prepareGpuModelRendererInput };

package/dist/index.d.ts

@@ -1,9 +1,108 @@
+import { GpuModelDocument, GpuModelDiagnosticReport, GpuModelTexture, GpuModelResource, GpuModelDiagnosticInput } from '@plasius/gpu-model-core';
+
+/** Fixed allocation ceiling; callers may tighten it, never raise it. */
+declare const GPU_MODEL_RENDERER_MAX_DECODED_BYTES: number;
+/** Remotely evaluated parent Feature flag. No environment override is read here. */
+declare const GPU_MODEL_RENDERER_FEATURE_FLAG = "gpu.model.conversion.enabled";
+/** Stable, payload-free failure categories for callers and worker boundaries. */
+type GpuModelRendererErrorCode = "feature-disabled" | "unverified-document" | "invalid-options" | "budget-exceeded" | "aborted" | "diagnostics-rejected" | "resource-read-failed";
+/** Bounded errors deliberately omit source paths, URIs and payload content. */
+declare class GpuModelRendererError extends Error {
+    readonly code: GpuModelRendererErrorCode;
+    constructor(code: GpuModelRendererErrorCode);
+}
+/** Consumer-owned buffers; changing them never changes the canonical document. */
+type GpuModelRendererBuffer = Float32Array | Uint32Array;
+/** Decode policy. Gate decisions must come from the host's remote flag evaluator. */
+interface GpuModelRendererOptions {
+    readonly conversionEnabled: boolean;
+    readonly signal?: AbortSignal;
+    readonly timeoutMs?: number;
+    readonly maxDecodedBytes?: number;
+    readonly diagnostics?: GpuModelDiagnosticInput;
+}
+/** Geometry in mesh-local coordinates, directly usable by the canonical renderer adapter. */
+interface GpuModelRendererGeometry {
+    readonly primitiveId: string;
+    readonly positions: Float32Array;
+    readonly indices?: Uint32Array;
+    readonly normals?: Float32Array;
+    readonly texcoords?: Float32Array;
+}
+/** All attributes are retained, including UV sets, colours, joints and custom semantics. */
+interface GpuModelRendererPrimitive {
+    readonly meshId: string;
+    readonly primitiveId: string;
+    readonly topology: GpuModelDocument["meshes"][number]["primitives"][number]["topology"];
+    /** Zero-based canonical material index; null denotes the renderer's default material. */
+    readonly materialSlot: number | null;
+    readonly attributes: Readonly<Record<string, GpuModelRendererBuffer>>;
+}
+/** Ordered joint palette and packed vertex influences; no animation is evaluated or baked. */
+interface GpuModelRendererSkin {
+    readonly id: string;
+    readonly skeletonId: string;
+    readonly jointIds: readonly string[];
+    readonly inverseBindMatrices: Float32Array;
+    readonly weightSets: readonly {
+        readonly primitiveId: string;
+        readonly influencesPerVertex: number;
+        readonly joints: Uint32Array;
+        readonly weights: Float32Array;
+    }[];
+}
+/** Canonical clip semantics with decoded, tightly packed sampler buffers. */
+interface GpuModelRendererAnimation {
+    readonly id: string;
+    readonly durationSeconds: number;
+    readonly channels: GpuModelDocument["animations"][number]["channels"];
+    readonly samplers: readonly {
+        readonly id: string;
+        readonly interpolation: GpuModelDocument["animations"][number]["samplers"][number]["interpolation"];
+        readonly input: GpuModelRendererBuffer;
+        readonly output: GpuModelRendererBuffer;
+    }[];
+}
+/** Verified images remain encoded; the caller chooses its decoder/upload strategy. */
+interface GpuModelRendererTexture {
+    readonly texture: GpuModelTexture;
+    readonly resource: GpuModelResource;
+}
+/** Scene-aware preparation result. Geometry alone is not a baked world-space scene. */
+interface GpuModelRendererInput {
+    readonly document: GpuModelDocument;
+    readonly bounds: GpuModelDocument["bounds"];
+    readonly roots: GpuModelDocument["roots"];
+    readonly nodes: GpuModelDocument["nodes"];
+    readonly materials: GpuModelDocument["materials"];
+    readonly skeletons: GpuModelDocument["skeletons"];
+    readonly joints: GpuModelDocument["joints"];
+    readonly blendShapes: GpuModelDocument["blendShapes"];
+    readonly analyticGeometry: GpuModelDocument["analyticGeometry"];
+    readonly diagnostics: GpuModelDocument["diagnostics"];
+    readonly diagnosticReport?: GpuModelDiagnosticReport;
+    readonly accessors: Readonly<Record<string, GpuModelRendererBuffer>>;
+    readonly geometry: readonly GpuModelRendererGeometry[];
+    readonly primitives: readonly GpuModelRendererPrimitive[];
+    readonly textures: readonly GpuModelRendererTexture[];
+    readonly skins: readonly GpuModelRendererSkin[];
+    readonly animations: readonly GpuModelRendererAnimation[];
+}
+/**
+ * Prepares privately verified core output without parsing source formats, fetching
+ * resources or importing a renderer. Structured clones must be reverified by core.
+ * Run on a host worker for large inputs. Operations are sequential, bounded and
+ * have no retries. The host owns scene transforms and animation evaluation.
+ */
+declare function prepareGpuModelRendererInput(value: unknown, options?: GpuModelRendererOptions): Promise<GpuModelRendererInput>;
+
 /** Package identity and rollout metadata for the initial repository baseline. */
 declare const packageName: "@plasius/gpu-model-renderer";
+/** @deprecated Retained for compatibility with the bootstrap package identity. */
 declare const packageBootstrap: Readonly<{
     readonly packageName: "@plasius/gpu-model-renderer";
     readonly featureFlag: "gpu.model.conversion.enabled";
     readonly status: "bootstrap";
 }>;
 
-export { packageBootstrap, packageName };
+export { GPU_MODEL_RENDERER_FEATURE_FLAG, GPU_MODEL_RENDERER_MAX_DECODED_BYTES, type GpuModelRendererAnimation, type GpuModelRendererBuffer, GpuModelRendererError, type GpuModelRendererErrorCode, type GpuModelRendererGeometry, type GpuModelRendererInput, type GpuModelRendererOptions, type GpuModelRendererPrimitive, type GpuModelRendererSkin, type GpuModelRendererTexture, packageBootstrap, packageName, prepareGpuModelRendererInput };

package/dist/index.js

@@ -1,3 +1,194 @@
+// src/renderer-input.ts
+import {
+  evaluateGpuModelDiagnostics,
+  isGpuModelDocument
+} from "@plasius/gpu-model-core";
+var GPU_MODEL_RENDERER_MAX_DECODED_BYTES = 64 * 1024 * 1024;
+var GPU_MODEL_RENDERER_FEATURE_FLAG = "gpu.model.conversion.enabled";
+var GpuModelRendererError = class extends Error {
+  constructor(code) {
+    super(`GPU model renderer preparation failed: ${code}`);
+    this.code = code;
+    this.name = "GpuModelRendererError";
+  }
+  code;
+};
+var COMPONENT_BYTES = { i8: 1, u8: 1, i16: 2, u16: 2, u32: 4, f32: 4 };
+var COMPONENTS = { scalar: 1, vec2: 2, vec3: 3, vec4: 4, mat2: 4, mat3: 9, mat4: 16 };
+var readBlob = Blob.prototype.arrayBuffer;
+function decode(accessor, view, check) {
+  const size = COMPONENT_BYTES[accessor.componentType];
+  const width = COMPONENTS[accessor.elementType];
+  const stride = accessor.byteStride ?? size * width;
+  const output = ["u8", "u16", "u32"].includes(accessor.componentType) && !accessor.normalized ? new Uint32Array(accessor.count * width) : new Float32Array(accessor.count * width);
+  for (let index = 0; index < output.length; index += 1) {
+    if (index % 4096 === 0) check();
+    const offset = accessor.byteOffset + Math.floor(index / width) * stride + index % width * size;
+    let value;
+    switch (accessor.componentType) {
+      case "i8":
+        value = view.getInt8(offset);
+        break;
+      case "u8":
+        value = view.getUint8(offset);
+        break;
+      case "i16":
+        value = view.getInt16(offset, true);
+        break;
+      case "u16":
+        value = view.getUint16(offset, true);
+        break;
+      case "u32":
+        value = view.getUint32(offset, true);
+        break;
+      case "f32":
+        value = view.getFloat32(offset, true);
+        break;
+    }
+    if (accessor.normalized) {
+      const divisor = { i8: 127, u8: 255, i16: 32767, u16: 65535, u32: 4294967295, f32: 1 }[accessor.componentType];
+      value = Math.max(-1, value / divisor);
+    }
+    output[index] = value;
+  }
+  return output;
+}
+async function prepareGpuModelRendererInput(value, options) {
+  if (options?.conversionEnabled !== true) throw new GpuModelRendererError("feature-disabled");
+  if (!isGpuModelDocument(value)) throw new GpuModelRendererError("unverified-document");
+  const document = value;
+  const maxBytes = options.maxDecodedBytes ?? GPU_MODEL_RENDERER_MAX_DECODED_BYTES;
+  const timeoutMs = options.timeoutMs ?? 3e4;
+  if (!Number.isSafeInteger(maxBytes) || maxBytes < 1 || maxBytes > GPU_MODEL_RENDERER_MAX_DECODED_BYTES || !Number.isSafeInteger(timeoutMs) || timeoutMs < 1 || timeoutMs > 3e4) {
+    throw new GpuModelRendererError("invalid-options");
+  }
+  const diagnosticReport = options.diagnostics === void 0 ? void 0 : evaluateGpuModelDiagnostics(options.diagnostics);
+  if (diagnosticReport?.accepted === false || document.diagnostics.some(({ severity }) => severity === "error")) {
+    throw new GpuModelRendererError("diagnostics-rejected");
+  }
+  let allocation = 0;
+  for (const accessor of document.accessors) allocation += accessor.count * COMPONENTS[accessor.elementType] * 4;
+  for (const skin of document.skins) {
+    allocation += skin.inverseBindMatrices.length * 16 * 4;
+    for (const weights of skin.weightSets) allocation += weights.joints.length * weights.influencesPerVertex * 8;
+  }
+  for (const resource of document.resources) if (resource.kind === "buffer") allocation += resource.byteLength;
+  if (allocation > maxBytes) throw new GpuModelRendererError("budget-exceeded");
+  const deadline = performance.now() + timeoutMs;
+  const check = () => {
+    if (options.signal?.aborted || performance.now() >= deadline) throw new GpuModelRendererError("aborted");
+  };
+  check();
+  const accessors = /* @__PURE__ */ Object.create(null);
+  const accessorsByResource = /* @__PURE__ */ new Map();
+  for (const accessor of document.accessors) {
+    const entries = accessorsByResource.get(accessor.resourceId) ?? [];
+    entries.push(accessor);
+    accessorsByResource.set(accessor.resourceId, entries);
+  }
+  for (const resource of document.resources) {
+    const entries = accessorsByResource.get(resource.id);
+    if (!entries) continue;
+    let timer;
+    let abort;
+    try {
+      const buffer = await new Promise((resolve, reject) => {
+        abort = () => reject(new GpuModelRendererError("aborted"));
+        options.signal?.addEventListener("abort", abort, { once: true });
+        timer = setTimeout(abort, Math.max(1, deadline - performance.now()));
+        readBlob.call(resource.payload).then(resolve, () => reject(new GpuModelRendererError("resource-read-failed")));
+      });
+      check();
+      const view = new DataView(buffer);
+      for (const accessor of entries) {
+        check();
+        accessors[accessor.id] = decode(accessor, view, check);
+      }
+    } finally {
+      clearTimeout(timer);
+      if (abort) options.signal?.removeEventListener("abort", abort);
+    }
+  }
+  const primitives = [];
+  const geometry = [];
+  const materialSlots = new Map(document.materials.map((material, index) => [material.id, index]));
+  for (const mesh of document.meshes) for (const primitive of mesh.primitives) {
+    check();
+    const attributes = /* @__PURE__ */ Object.create(null);
+    for (const attribute of primitive.attributes) attributes[attribute.semantic] = accessors[attribute.accessorId];
+    primitives.push(Object.freeze({
+      meshId: mesh.id,
+      primitiveId: primitive.id,
+      topology: primitive.topology,
+      materialSlot: primitive.materialId === void 0 ? null : materialSlots.get(primitive.materialId),
+      attributes: Object.freeze(attributes)
+    }));
+    geometry.push(Object.freeze({
+      primitiveId: primitive.id,
+      positions: attributes.POSITION,
+      ...primitive.indicesAccessorId === void 0 ? {} : { indices: accessors[primitive.indicesAccessorId] },
+      ...attributes.NORMAL === void 0 ? {} : { normals: attributes.NORMAL },
+      ...attributes.TEXCOORD_0 === void 0 ? {} : { texcoords: attributes.TEXCOORD_0 }
+    }));
+  }
+  const pack = (rows, output) => {
+    let offset = 0;
+    for (const row of rows) {
+      check();
+      output.set(row, offset);
+      offset += row.length;
+    }
+    return output;
+  };
+  const skins = document.skins.map((skin) => {
+    check();
+    return Object.freeze({
+      id: skin.id,
+      skeletonId: skin.skeletonId,
+      jointIds: skin.jointIds,
+      inverseBindMatrices: pack(skin.inverseBindMatrices, new Float32Array(skin.inverseBindMatrices.length * 16)),
+      weightSets: Object.freeze(skin.weightSets.map((weights) => Object.freeze({
+        primitiveId: weights.primitiveId,
+        influencesPerVertex: weights.influencesPerVertex,
+        joints: pack(weights.joints, new Uint32Array(weights.joints.length * weights.influencesPerVertex)),
+        weights: pack(weights.weights, new Float32Array(weights.weights.length * weights.influencesPerVertex))
+      })))
+    });
+  });
+  const animations = document.animations.map((animation) => Object.freeze({
+    id: animation.id,
+    durationSeconds: animation.durationSeconds,
+    channels: animation.channels,
+    samplers: Object.freeze(animation.samplers.map((sampler) => Object.freeze({
+      id: sampler.id,
+      interpolation: sampler.interpolation,
+      input: accessors[sampler.inputAccessorId],
+      output: accessors[sampler.outputAccessorId]
+    })))
+  }));
+  const resources = new Map(document.resources.map((resource) => [resource.id, resource]));
+  check();
+  return Object.freeze({
+    document,
+    bounds: document.bounds,
+    roots: document.roots,
+    nodes: document.nodes,
+    materials: document.materials,
+    skeletons: document.skeletons,
+    joints: document.joints,
+    blendShapes: document.blendShapes,
+    analyticGeometry: document.analyticGeometry,
+    diagnostics: document.diagnostics,
+    ...diagnosticReport === void 0 ? {} : { diagnosticReport },
+    accessors: Object.freeze(accessors),
+    primitives: Object.freeze(primitives),
+    geometry: Object.freeze(geometry),
+    skins: Object.freeze(skins),
+    animations: Object.freeze(animations),
+    textures: Object.freeze(document.textures.map((texture) => Object.freeze({ texture, resource: resources.get(texture.imageResourceId) })))
+  });
+}
+
 // src/index.ts
 var packageName = "@plasius/gpu-model-renderer";
 var packageBootstrap = Object.freeze({
@@ -6,7 +197,11 @@ var packageBootstrap = Object.freeze({
   status: "bootstrap"
 });
 export {
+  GPU_MODEL_RENDERER_FEATURE_FLAG,
+  GPU_MODEL_RENDERER_MAX_DECODED_BYTES,
+  GpuModelRendererError,
   packageBootstrap,
-  packageName
+  packageName,
+  prepareGpuModelRendererInput
 };
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["/** Package identity and rollout metadata for the initial repository baseline. */\nexport const packageName = \"@plasius/gpu-model-renderer\" as const;\n\nexport const packageBootstrap = Object.freeze({\n  packageName,\n  featureFlag: \"gpu.model.conversion.enabled\",\n  status: \"bootstrap\",\n} as const);\n"],"mappings":";AACO,IAAM,cAAc;AAEpB,IAAM,mBAAmB,OAAO,OAAO;AAAA,EAC5C;AAAA,EACA,aAAa;AAAA,EACb,QAAQ;AACV,CAAU;","names":[]}
+{"version":3,"sources":["../src/renderer-input.ts","../src/index.ts"],"sourcesContent":["import {\n  evaluateGpuModelDiagnostics, isGpuModelDocument,\n  type GpuModelAccessor, type GpuModelDiagnosticInput, type GpuModelDiagnosticReport,\n  type GpuModelDocument, type GpuModelResource, type GpuModelTexture,\n} from \"@plasius/gpu-model-core\";\n\n/** Fixed allocation ceiling; callers may tighten it, never raise it. */\nexport const GPU_MODEL_RENDERER_MAX_DECODED_BYTES = 64 * 1024 * 1024;\n/** Remotely evaluated parent Feature flag. No environment override is read here. */\nexport const GPU_MODEL_RENDERER_FEATURE_FLAG = \"gpu.model.conversion.enabled\";\n\n/** Stable, payload-free failure categories for callers and worker boundaries. */\nexport type GpuModelRendererErrorCode = \"feature-disabled\" | \"unverified-document\" | \"invalid-options\" | \"budget-exceeded\" | \"aborted\" | \"diagnostics-rejected\" | \"resource-read-failed\";\n/** Bounded errors deliberately omit source paths, URIs and payload content. */\nexport class GpuModelRendererError extends Error {\n  public constructor(public readonly code: GpuModelRendererErrorCode) {\n    super(`GPU model renderer preparation failed: ${code}`);\n    this.name = \"GpuModelRendererError\";\n  }\n}\n\n/** Consumer-owned buffers; changing them never changes the canonical document. */\nexport type GpuModelRendererBuffer = Float32Array | Uint32Array;\n/** Decode policy. Gate decisions must come from the host's remote flag evaluator. */\nexport interface GpuModelRendererOptions {\n  readonly conversionEnabled: boolean;\n  readonly signal?: AbortSignal;\n  readonly timeoutMs?: number;\n  readonly maxDecodedBytes?: number;\n  readonly diagnostics?: GpuModelDiagnosticInput;\n}\n/** Geometry in mesh-local coordinates, directly usable by the canonical renderer adapter. */\nexport interface GpuModelRendererGeometry {\n  readonly primitiveId: string;\n  readonly positions: Float32Array;\n  readonly indices?: Uint32Array;\n  readonly normals?: Float32Array;\n  readonly texcoords?: Float32Array;\n}\n/** All attributes are retained, including UV sets, colours, joints and custom semantics. */\nexport interface GpuModelRendererPrimitive {\n  readonly meshId: string;\n  readonly primitiveId: string;\n  readonly topology: GpuModelDocument[\"meshes\"][number][\"primitives\"][number][\"topology\"];\n  /** Zero-based canonical material index; null denotes the renderer's default material. */\n  readonly materialSlot: number | null;\n  readonly attributes: Readonly<Record<string, GpuModelRendererBuffer>>;\n}\n/** Ordered joint palette and packed vertex influences; no animation is evaluated or baked. */\nexport interface GpuModelRendererSkin {\n  readonly id: string;\n  readonly skeletonId: string;\n  readonly jointIds: readonly string[];\n  readonly inverseBindMatrices: Float32Array;\n  readonly weightSets: readonly {\n    readonly primitiveId: string;\n    readonly influencesPerVertex: number;\n    readonly joints: Uint32Array;\n    readonly weights: Float32Array;\n  }[];\n}\n/** Canonical clip semantics with decoded, tightly packed sampler buffers. */\nexport interface GpuModelRendererAnimation {\n  readonly id: string;\n  readonly durationSeconds: number;\n  readonly channels: GpuModelDocument[\"animations\"][number][\"channels\"];\n  readonly samplers: readonly {\n    readonly id: string;\n    readonly interpolation: GpuModelDocument[\"animations\"][number][\"samplers\"][number][\"interpolation\"];\n    readonly input: GpuModelRendererBuffer;\n    readonly output: GpuModelRendererBuffer;\n  }[];\n}\n/** Verified images remain encoded; the caller chooses its decoder/upload strategy. */\nexport interface GpuModelRendererTexture {\n  readonly texture: GpuModelTexture;\n  readonly resource: GpuModelResource;\n}\n/** Scene-aware preparation result. Geometry alone is not a baked world-space scene. */\nexport interface GpuModelRendererInput {\n  readonly document: GpuModelDocument;\n  readonly bounds: GpuModelDocument[\"bounds\"];\n  readonly roots: GpuModelDocument[\"roots\"];\n  readonly nodes: GpuModelDocument[\"nodes\"];\n  readonly materials: GpuModelDocument[\"materials\"];\n  readonly skeletons: GpuModelDocument[\"skeletons\"];\n  readonly joints: GpuModelDocument[\"joints\"];\n  readonly blendShapes: GpuModelDocument[\"blendShapes\"];\n  readonly analyticGeometry: GpuModelDocument[\"analyticGeometry\"];\n  readonly diagnostics: GpuModelDocument[\"diagnostics\"];\n  readonly diagnosticReport?: GpuModelDiagnosticReport;\n  readonly accessors: Readonly<Record<string, GpuModelRendererBuffer>>;\n  readonly geometry: readonly GpuModelRendererGeometry[];\n  readonly primitives: readonly GpuModelRendererPrimitive[];\n  readonly textures: readonly GpuModelRendererTexture[];\n  readonly skins: readonly GpuModelRendererSkin[];\n  readonly animations: readonly GpuModelRendererAnimation[];\n}\n\nconst COMPONENT_BYTES = { i8: 1, u8: 1, i16: 2, u16: 2, u32: 4, f32: 4 } as const;\nconst COMPONENTS = { scalar: 1, vec2: 2, vec3: 3, vec4: 4, mat2: 4, mat3: 9, mat4: 16 } as const;\n\nconst readBlob = Blob.prototype.arrayBuffer;\n\nfunction decode(accessor: GpuModelAccessor, view: DataView, check: () => void): GpuModelRendererBuffer {\n  const size = COMPONENT_BYTES[accessor.componentType];\n  const width = COMPONENTS[accessor.elementType];\n  const stride = accessor.byteStride ?? size * width;\n  const output = [\"u8\", \"u16\", \"u32\"].includes(accessor.componentType) && !accessor.normalized\n    ? new Uint32Array(accessor.count * width)\n    : new Float32Array(accessor.count * width);\n  for (let index = 0; index < output.length; index += 1) {\n    if (index % 4096 === 0) check();\n    const offset = accessor.byteOffset + Math.floor(index / width) * stride + (index % width) * size;\n    let value: number;\n    switch (accessor.componentType) {\n      case \"i8\": value = view.getInt8(offset); break;\n      case \"u8\": value = view.getUint8(offset); break;\n      case \"i16\": value = view.getInt16(offset, true); break;\n      case \"u16\": value = view.getUint16(offset, true); break;\n      case \"u32\": value = view.getUint32(offset, true); break;\n      case \"f32\": value = view.getFloat32(offset, true); break;\n    }\n    if (accessor.normalized) {\n      const divisor = { i8: 127, u8: 255, i16: 32767, u16: 65535, u32: 4294967295, f32: 1 }[accessor.componentType];\n      value = Math.max(-1, value / divisor);\n    }\n    output[index] = value;\n  }\n  return output;\n}\n\n/**\n * Prepares privately verified core output without parsing source formats, fetching\n * resources or importing a renderer. Structured clones must be reverified by core.\n * Run on a host worker for large inputs. Operations are sequential, bounded and\n * have no retries. The host owns scene transforms and animation evaluation.\n */\nexport async function prepareGpuModelRendererInput(\n  value: unknown,\n  options?: GpuModelRendererOptions,\n): Promise<GpuModelRendererInput> {\n  if (options?.conversionEnabled !== true) throw new GpuModelRendererError(\"feature-disabled\");\n  if (!isGpuModelDocument(value)) throw new GpuModelRendererError(\"unverified-document\");\n  const document = value;\n  const maxBytes = options.maxDecodedBytes ?? GPU_MODEL_RENDERER_MAX_DECODED_BYTES;\n  const timeoutMs = options.timeoutMs ?? 30_000;\n  if (!Number.isSafeInteger(maxBytes) || maxBytes < 1 || maxBytes > GPU_MODEL_RENDERER_MAX_DECODED_BYTES\n    || !Number.isSafeInteger(timeoutMs) || timeoutMs < 1 || timeoutMs > 30_000) {\n    throw new GpuModelRendererError(\"invalid-options\");\n  }\n  const diagnosticReport = options.diagnostics === undefined ? undefined : evaluateGpuModelDiagnostics(options.diagnostics);\n  if (diagnosticReport?.accepted === false || document.diagnostics.some(({ severity }) => severity === \"error\")) {\n    throw new GpuModelRendererError(\"diagnostics-rejected\");\n  }\n  let allocation = 0;\n  for (const accessor of document.accessors) allocation += accessor.count * COMPONENTS[accessor.elementType] * 4;\n  for (const skin of document.skins) {\n    allocation += skin.inverseBindMatrices.length * 16 * 4;\n    for (const weights of skin.weightSets) allocation += weights.joints.length * weights.influencesPerVertex * 8;\n  }\n  // Include copies of encoded buffers in the peak budget; image bytes are not decoded here.\n  for (const resource of document.resources) if (resource.kind === \"buffer\") allocation += resource.byteLength;\n  if (allocation > maxBytes) throw new GpuModelRendererError(\"budget-exceeded\");\n  const deadline = performance.now() + timeoutMs;\n  const check = () => {\n    if (options.signal?.aborted || performance.now() >= deadline) throw new GpuModelRendererError(\"aborted\");\n  };\n  check();\n  const accessors: Record<string, GpuModelRendererBuffer> = Object.create(null);\n  // One bounded read at a time. Abort/deadline rejects even if a host read stalls.\n  const accessorsByResource = new Map<string, GpuModelAccessor[]>();\n  for (const accessor of document.accessors) {\n    const entries = accessorsByResource.get(accessor.resourceId) ?? [];\n    entries.push(accessor);\n    accessorsByResource.set(accessor.resourceId, entries);\n  }\n  for (const resource of document.resources) {\n    const entries = accessorsByResource.get(resource.id);\n    if (!entries) continue;\n    let timer: ReturnType<typeof setTimeout> | undefined;\n    let abort: (() => void) | undefined;\n    try {\n      const buffer = await new Promise<ArrayBuffer>((resolve, reject) => {\n        abort = () => reject(new GpuModelRendererError(\"aborted\"));\n        options.signal?.addEventListener(\"abort\", abort, { once: true });\n        timer = setTimeout(abort, Math.max(1, deadline - performance.now()));\n        readBlob.call(resource.payload).then(resolve, () => reject(new GpuModelRendererError(\"resource-read-failed\")));\n      });\n      check();\n      const view = new DataView(buffer);\n      for (const accessor of entries) {\n        check();\n        accessors[accessor.id] = decode(accessor, view, check);\n      }\n    } finally {\n      clearTimeout(timer);\n      if (abort) options.signal?.removeEventListener(\"abort\", abort);\n    }\n  }\n  const primitives: GpuModelRendererPrimitive[] = [];\n  const geometry: GpuModelRendererGeometry[] = [];\n  const materialSlots = new Map(document.materials.map((material, index) => [material.id, index]));\n  for (const mesh of document.meshes) for (const primitive of mesh.primitives) {\n    check();\n    const attributes: Record<string, GpuModelRendererBuffer> = Object.create(null);\n    for (const attribute of primitive.attributes) attributes[attribute.semantic] = accessors[attribute.accessorId]!;\n    primitives.push(Object.freeze({ meshId: mesh.id, primitiveId: primitive.id, topology: primitive.topology,\n      materialSlot: primitive.materialId === undefined ? null : materialSlots.get(primitive.materialId)!, attributes: Object.freeze(attributes) }));\n    geometry.push(Object.freeze({ primitiveId: primitive.id, positions: attributes.POSITION! as Float32Array,\n      ...(primitive.indicesAccessorId === undefined ? {} : { indices: accessors[primitive.indicesAccessorId]! as Uint32Array }),\n      ...(attributes.NORMAL === undefined ? {} : { normals: attributes.NORMAL as Float32Array }),\n      ...(attributes.TEXCOORD_0 === undefined ? {} : { texcoords: attributes.TEXCOORD_0 as Float32Array }) }));\n  }\n  const pack = <T extends Float32Array | Uint32Array>(rows: readonly (readonly number[])[], output: T): T => {\n    let offset = 0;\n    for (const row of rows) { check(); output.set(row, offset); offset += row.length; }\n    return output;\n  };\n  const skins = document.skins.map(skin => {\n    check();\n    return Object.freeze({ id: skin.id, skeletonId: skin.skeletonId, jointIds: skin.jointIds,\n      inverseBindMatrices: pack(skin.inverseBindMatrices, new Float32Array(skin.inverseBindMatrices.length * 16)),\n      weightSets: Object.freeze(skin.weightSets.map(weights => Object.freeze({ primitiveId: weights.primitiveId,\n        influencesPerVertex: weights.influencesPerVertex, joints: pack(weights.joints, new Uint32Array(weights.joints.length * weights.influencesPerVertex)), weights: pack(weights.weights, new Float32Array(weights.weights.length * weights.influencesPerVertex)) }))) });\n  });\n  const animations = document.animations.map(animation => Object.freeze({ id: animation.id, durationSeconds: animation.durationSeconds,\n    channels: animation.channels, samplers: Object.freeze(animation.samplers.map(sampler => Object.freeze({ id: sampler.id,\n      interpolation: sampler.interpolation, input: accessors[sampler.inputAccessorId]!, output: accessors[sampler.outputAccessorId]! }))) }));\n  const resources = new Map(document.resources.map(resource => [resource.id, resource]));\n  check();\n  return Object.freeze({ document, bounds: document.bounds, roots: document.roots, nodes: document.nodes, materials: document.materials,\n    skeletons: document.skeletons, joints: document.joints, blendShapes: document.blendShapes, analyticGeometry: document.analyticGeometry,\n    diagnostics: document.diagnostics, ...(diagnosticReport === undefined ? {} : { diagnosticReport }), accessors: Object.freeze(accessors),\n    primitives: Object.freeze(primitives), geometry: Object.freeze(geometry), skins: Object.freeze(skins), animations: Object.freeze(animations),\n    textures: Object.freeze(document.textures.map(texture => Object.freeze({ texture, resource: resources.get(texture.imageResourceId)! }))) });\n}\n","/** Package identity and rollout metadata for the initial repository baseline. */\nexport const packageName = \"@plasius/gpu-model-renderer\" as const;\n\n/** @deprecated Retained for compatibility with the bootstrap package identity. */\nexport const packageBootstrap = Object.freeze({\n  packageName,\n  featureFlag: \"gpu.model.conversion.enabled\",\n  status: \"bootstrap\",\n} as const);\n\nexport * from \"./renderer-input.js\";\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@plasius/gpu-model-renderer",
-  "version": "0.1.5",
+  "version": "0.2.0",
   "description": "Canonical GPU model to renderer-ready buffers and animation inputs bridge.",
   "type": "module",
   "sideEffects": false,
@@ -69,6 +69,8 @@
   "homepage": "https://github.com/Plasius-LTD/gpu-model-renderer#readme",
   "devDependencies": {
     "@eslint/js": "^10.0.1",
+    "@plasius/gpu-model-runtime": "0.2.4",
+    "@plasius/gpu-renderer": "0.2.51",
     "@types/node": "^26.0.1",
     "@typescript-eslint/eslint-plugin": "^8.59.3",
     "@typescript-eslint/parser": "^8.59.3",
@@ -102,5 +104,8 @@
   },
   "engines": {
     "node": ">=24"
+  },
+  "dependencies": {
+    "@plasius/gpu-model-core": "0.4.6"
   }
 }