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

package/dist/data-uri.d.ts

@@ -0,0 +1,6 @@
+export declare class Base64DecodeError extends Error {
+    constructor(cause: unknown);
+}
+export declare function dataUriBase64Payload(uri: string): string | undefined;
+export declare function decodeBase64(b64: string): Uint8Array;
+//# sourceMappingURL=data-uri.d.ts.map

package/dist/data-uri.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-uri.d.ts","sourceRoot":"","sources":["../src/data-uri.ts"],"names":[],"mappings":"AAEA,qBAAa,iBAAkB,SAAQ,KAAK;gBAC9B,KAAK,EAAE,OAAO;CAM3B;AAED,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAGpE;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,CAYpD"}

package/dist/errors.d.ts

@@ -0,0 +1,201 @@
+export { createMaterialError, err, type GltfMaterialUvSetMissingDetail, type MaterialError, ok, type Result, } from '@forgeax/engine-types';
+import type { VertexAttributePackDetail } from '@forgeax/engine-types';
+export declare const GLTF_MESHOPT_MODES: readonly ["ATTRIBUTES", "TRIANGLES", "INDICES"];
+export type GltfMeshoptMode = (typeof GLTF_MESHOPT_MODES)[number];
+export declare const GLTF_MESHOPT_FILTERS: readonly ["NONE", "OCTAHEDRAL", "QUATERNION", "EXPONENTIAL"];
+export type GltfMeshoptFilter = (typeof GLTF_MESHOPT_FILTERS)[number];
+/** `gltf-malformed-header` payload: GLB magic / chunk header surface. */
+export interface GltfMalformedHeaderDetail {
+    readonly filePath: string;
+    readonly byteOffset: number;
+    readonly magic?: number;
+}
+/** `gltf-version-unsupported` payload: surfaced asset.version literal. */
+export interface GltfVersionUnsupportedDetail {
+    readonly filePath: string;
+    readonly actualVersion: string;
+}
+/** `gltf-buffer-out-of-bounds` payload: accessor + bufferView coordinates. */
+export interface GltfBufferOutOfBoundsDetail {
+    readonly accessor: number;
+    readonly byteOffset: number;
+    readonly byteLength: number;
+    readonly bufferIndex: number;
+}
+/** `gltf-extension-unsupported` payload: extension name + which array it appeared in. */
+export interface GltfExtensionUnsupportedDetail {
+    readonly extension: string;
+    readonly source: 'extensionsRequired' | 'extensionsUsed';
+}
+/** `gltf-accessor-type-mismatch` payload: 4-member closed reason discriminator. */
+export interface GltfAccessorTypeMismatchDetail {
+    readonly accessorIndex: number;
+    readonly reason: 'sparse' | 'morph' | 'interleaved' | 'unknownComponentType';
+}
+/** `gltf-texture-load-failed` payload: URI that failed to load. */
+export interface GltfTextureLoadFailedDetail {
+    readonly uri: string;
+}
+/** `gltf-meta-missing` payload: source path + expected sidecar path. */
+export interface GltfMetaMissingDetail {
+    readonly filePath: string;
+    readonly expectedMetaPath: string;
+}
+/** `gltf-image-mime-unsupported` payload: rejected MIME type. */
+export interface GltfImageMimeUnsupportedDetail {
+    readonly mimeType: string;
+}
+/** `gltf-skin-joint-count-exceeded` payload: skin joint count exceeds MAX_JOINTS. */
+export interface GltfSkinJointCountExceededDetail {
+    readonly skinIndex: number;
+    readonly jointCount: number;
+    readonly maxJoints: number;
+}
+/** `gltf-animation-cubicspline-unsupported` payload: CUBICSPLINE sampler. */
+export interface GltfAnimationCubicsplineUnsupportedDetail {
+    readonly animationIndex: number;
+    readonly samplerIndex: number;
+}
+/** `gltf-morph-unsupported` payload: channel targeting morph weights. */
+export interface GltfMorphUnsupportedDetail {
+    readonly animationIndex: number;
+    readonly channelIndex: number;
+    readonly nodeIndex: number;
+}
+/** `gltf-skin-joint-name-missing` payload: joint node has no name. */
+export interface GltfSkinJointNameMissingDetail {
+    readonly reason: 'name-missing' | 'hierarchy-cycle';
+    readonly skinIndex: number;
+    readonly jointPathIndex: number;
+    readonly nodeIndex: number;
+}
+/** `gltf-image-extract-failed` payload: image bytes extraction failure. */
+export interface GltfImageExtractFailedDetail {
+    readonly imageIndex: number;
+    readonly source: 'bufferView' | 'data-uri' | 'external-uri';
+    readonly reason: string;
+}
+/** `gltf-instancing-count-mismatch` payload: TRS accessor count disagreement. */
+export interface GltfInstancingCountMismatchDetail {
+    readonly nodeIndex: number;
+    readonly accessor: 'TRANSLATION' | 'ROTATION' | 'SCALE';
+    readonly expectedCount: number;
+    readonly actualCount: number;
+}
+/** `gltf-skin-attr-asymmetric` payload: JOINTS_0/WEIGHTS_0 paired-presence fail. */
+export interface GltfSkinAttrAsymmetricDetail {
+    readonly meshIndex: number;
+    readonly primitiveIndex: number;
+    readonly hasJoints: boolean;
+    readonly hasWeights: boolean;
+}
+export interface GltfAnimationTargetInvalidDetail {
+    readonly reason: 'name-missing' | 'path-invalid' | 'path-duplicate' | 'path-not-found' | 'hierarchy-cycle' | 'id-collision';
+    readonly animationIndex: number;
+    readonly channelIndex: number;
+    readonly nodeIndex: number;
+}
+export interface GltfMeshoptDecoderRequiredDetail {
+    readonly bufferView: number;
+    readonly actual: 'required' | 'compressed-only';
+    readonly hasCoreFallback: boolean;
+}
+export interface GltfMeshoptDecodeFailedDetail {
+    readonly bufferView: number;
+    readonly actual: string;
+    readonly mode: GltfMeshoptMode;
+    readonly filter: GltfMeshoptFilter;
+}
+export interface GltfMorphInvalidDetail {
+    readonly meshIndex: number;
+    readonly primitiveIndex: number;
+    readonly reason: 'target-count-exceeded' | 'attribute-count-exceeded' | 'attribute-length-mismatch' | 'weights-length-mismatch' | 'sparse-or-unsupported-accessor';
+    readonly targetCount: number;
+    readonly attributeCount: number;
+    readonly vertexCount: number;
+}
+export interface GltfColorAccessorUnsupportedDetail {
+    readonly semantic: 'COLOR_0';
+    readonly accessorIndex: number;
+    readonly reason: 'component' | 'type' | 'normalized' | 'sparse' | 'morph';
+    readonly expectedType?: string;
+    readonly expectedComponent?: string;
+    readonly expectedNormalized?: boolean;
+}
+export interface GltfColorAccessorMalformedDetail {
+    readonly semantic: 'COLOR_0';
+    readonly accessorIndex: number;
+    readonly reason: 'count' | 'bounds' | 'finite' | 'range' | 'reference';
+    readonly expectedCount?: string;
+    readonly expectedRange?: string;
+}
+/** Bridge-side mesh merge failure after the parser has produced a GltfMeshIr. */
+export type GltfMeshBridgeInvalidDetail = {
+    readonly reason: 'empty-input';
+    readonly primitiveCount: 0;
+} | {
+    readonly reason: 'morph-count-mismatch';
+    readonly meshIndex: number;
+    readonly primitiveIndex: number;
+    readonly expectedTargetCount: number;
+    readonly actualTargetCount: number;
+} | {
+    readonly reason: 'color-cardinality';
+    readonly semantic: 'COLOR_0';
+    readonly meshIndex: number;
+    readonly primitiveIndex: number;
+    readonly vertexCount: number;
+    readonly expectedLength: number;
+    readonly actualLength: number;
+} | {
+    readonly reason: 'layout-invalid';
+    readonly meshIndex: number;
+    readonly cause: VertexAttributePackDetail;
+};
+/** Discriminated detail family unifying all 19 GltfError variants. */
+export type GltfErrorDetail = DetailFor[GltfErrorCode];
+export type GltfErrorCode = keyof DetailFor;
+export type GltfError = {
+    readonly [C in GltfErrorCode]: {
+        readonly code: C;
+        readonly expected: string;
+        readonly hint: string;
+        readonly detail: DetailFor[C];
+    };
+}[GltfErrorCode];
+export declare const GLTF_ERROR_HINTS: Readonly<Record<GltfErrorCode, string>>;
+interface DetailFor {
+    readonly 'gltf-malformed-header': GltfMalformedHeaderDetail;
+    readonly 'gltf-version-unsupported': GltfVersionUnsupportedDetail;
+    readonly 'gltf-buffer-out-of-bounds': GltfBufferOutOfBoundsDetail;
+    readonly 'gltf-extension-unsupported': GltfExtensionUnsupportedDetail;
+    readonly 'gltf-accessor-type-mismatch': GltfAccessorTypeMismatchDetail;
+    readonly 'gltf-texture-load-failed': GltfTextureLoadFailedDetail;
+    readonly 'gltf-meta-missing': GltfMetaMissingDetail;
+    readonly 'gltf-instancing-count-mismatch': GltfInstancingCountMismatchDetail;
+    readonly 'gltf-image-mime-unsupported': GltfImageMimeUnsupportedDetail;
+    readonly 'gltf-skin-joint-count-exceeded': GltfSkinJointCountExceededDetail;
+    readonly 'gltf-animation-cubicspline-unsupported': GltfAnimationCubicsplineUnsupportedDetail;
+    readonly 'gltf-morph-unsupported': GltfMorphUnsupportedDetail;
+    readonly 'gltf-skin-joint-name-missing': GltfSkinJointNameMissingDetail;
+    readonly 'gltf-image-extract-failed': GltfImageExtractFailedDetail;
+    readonly 'gltf-skin-attr-asymmetric': GltfSkinAttrAsymmetricDetail;
+    readonly 'gltf-animation-target-invalid': GltfAnimationTargetInvalidDetail;
+    readonly 'gltf-meshopt-decoder-required': GltfMeshoptDecoderRequiredDetail;
+    readonly 'gltf-meshopt-decode-failed': GltfMeshoptDecodeFailedDetail;
+    readonly 'gltf-morph-invalid': GltfMorphInvalidDetail;
+    readonly 'gltf-color-accessor-unsupported': GltfColorAccessorUnsupportedDetail;
+    readonly 'gltf-color-accessor-malformed': GltfColorAccessorMalformedDetail;
+    readonly 'gltf-mesh-bridge-invalid': GltfMeshBridgeInvalidDetail;
+}
+/**
+ * Build a fully-typed GltfError. The discriminated-union return type lets
+ * call sites narrow with `switch (e.code)` on the result.
+ *
+ * Charter proposition 4 explicit-failure: `expected` + `hint` fields are
+ * sourced from the SSOT tables - no producer can omit them.
+ */
+export declare function gltfErr<C extends GltfErrorCode>(code: C, detail: DetailFor[C]): Extract<GltfError, {
+    readonly code: C;
+}>;
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

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

package/dist/extract-image-bytes.d.ts

@@ -0,0 +1,42 @@
+import type { ImportContext } from '@forgeax/engine-types';
+/** Source of an image: matches `GltfImageExtractFailedDetail.source`. */
+export type ImageSourceKind = 'bufferView' | 'data-uri' | 'external-uri';
+/** One extracted image: bytes + the source kind that produced them. */
+export interface ExtractedImage {
+    readonly bytes: Uint8Array;
+    readonly mimeType: 'image/png' | 'image/jpeg';
+    readonly source: ImageSourceKind;
+}
+/**
+ * Failure shape — the importer wraps this in a `gltf-image-extract-failed`
+ * GltfError. `source` may be undefined when the image row is malformed
+ * (no uri / no bufferView), so the importer can name 'bufferView' (most
+ * common) by default.
+ */
+export interface ExtractFailure {
+    readonly imageIndex: number;
+    readonly source: ImageSourceKind;
+    readonly reason: string;
+}
+/**
+ * Extract raw image bytes for every `images[]` row in the parsed glTF doc.
+ *
+ * @param sourceBytes the original .glb / .gltf file bytes (the GLB BIN
+ *   chunk is reconstructed from these for buffer-0 lookups).
+ * @param sourcePath  the meta.source path; used only for diagnostics
+ *   (parseGlbChunks errors carry it through).
+ * @param ctx         the ImportContext — reused for `readSibling` (external
+ *   buffer .bin / external image .png/.jpg). data: URIs do not call ctx.
+ *
+ * Returns a Map<imageIndex, ExtractedImage> with one entry per resolved
+ * image. Rows that fail to extract are returned in `failures[]` so the
+ * caller can emit one `gltf-image-extract-failed` per failure (single
+ * failure does not abort the whole importer — the runner's GUID iron-law
+ * check then surfaces missing image GUIDs as a structured outage instead
+ * of the silent white-box render).
+ */
+export declare function extractImageBytes(sourceBytes: Uint8Array, sourcePath: string, ctx: ImportContext): Promise<{
+    readonly extracted: ReadonlyMap<number, ExtractedImage>;
+    readonly failures: readonly ExtractFailure[];
+}>;
+//# sourceMappingURL=extract-image-bytes.d.ts.map

package/dist/extract-image-bytes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract-image-bytes.d.ts","sourceRoot":"","sources":["../src/extract-image-bytes.ts"],"names":[],"mappings":"AAuBA,OAAO,KAAK,EAAE,aAAa,EAAkC,MAAM,uBAAuB,CAAC;AAI3F,yEAAyE;AACzE,MAAM,MAAM,eAAe,GAAG,YAAY,GAAG,UAAU,GAAG,cAAc,CAAC;AAEzE,uEAAuE;AACvE,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,WAAW,GAAG,YAAY,CAAC;IAC9C,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;CAClC;AAED;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AA0DD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,iBAAiB,CACrC,WAAW,EAAE,UAAU,EACvB,UAAU,EAAE,MAAM,EAClB,GAAG,EAAE,aAAa,GACjB,OAAO,CAAC;IACT,QAAQ,CAAC,SAAS,EAAE,WAAW,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IACxD,QAAQ,CAAC,QAAQ,EAAE,SAAS,cAAc,EAAE,CAAC;CAC9C,CAAC,CAqND"}

package/dist/gltf-importer.d.ts

@@ -0,0 +1,21 @@
+import type { AssetRef, Importer } from '@forgeax/engine-types';
+import type { GltfBufferViewDecodeCapability } from './meshopt-decode.js';
+import type { GltfDoc, GltfMaterialIr } from './parse-gltf.js';
+/** Collect texture and sampler GUID refs for one material (AC-11 cross-edge). */
+export declare function materialRefsForPack(mat: GltfMaterialIr, doc: GltfDoc, textureGuidByIndex: ReadonlyMap<number, string>, samplerGuidByIndex?: ReadonlyMap<number, string>): readonly AssetRef[];
+/**
+ * The gltf {@link Importer}. Register it into an `ImporterRegistry` so the
+ * import runner dispatches `meta.importer === 'gltf'` sidecars here.
+ *
+ * @example
+ * ```ts
+ * import { ImporterRegistry } from '@forgeax/engine-import';
+ * import { gltfImporter } from '@forgeax/engine-gltf';
+ * const importers = new ImporterRegistry();
+ * importers.register(gltfImporter);
+ * ```
+ */
+export declare function createGltfImporter(meshopt?: GltfBufferViewDecodeCapability): Importer;
+/** Importer for hosts that provide an optional build-only Meshopt decoder. */
+export declare const gltfImporter: Importer;
+//# sourceMappingURL=gltf-importer.d.ts.map

package/dist/gltf-importer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gltf-importer.d.ts","sourceRoot":"","sources":["../src/gltf-importer.ts"],"names":[],"mappings":"AAoCA,OAAO,KAAK,EAEV,QAAQ,EAIR,QAAQ,EAMT,MAAM,uBAAuB,CAAC;AAiB/B,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,qBAAqB,CAAC;AAC1E,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAqB,MAAM,iBAAiB,CAAC;AAwTlF,iFAAiF;AACjF,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,cAAc,EACnB,GAAG,EAAE,OAAO,EACZ,kBAAkB,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,EAC/C,kBAAkB,GAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAa,GAC1D,SAAS,QAAQ,EAAE,CA+BrB;AA2hBD;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,CAAC,EAAE,8BAA8B,GAAG,QAAQ,CAMrF;AAED,8EAA8E;AAC9E,eAAO,MAAM,YAAY,EAAE,QAA+B,CAAC"}

package/dist/image-color-space.d.ts

@@ -0,0 +1,35 @@
+export type ImageColorSpaceSrgbOrLinear = 'srgb' | 'linear';
+type TextureBinding = number | {
+    readonly texture: number;
+};
+/** Slim view of a parsed material the classifier reads (subset of MaterialIr). */
+export interface MaterialColorSpaceInput {
+    readonly baseColorTexture?: TextureBinding;
+    readonly metallicRoughnessTexture?: TextureBinding;
+    readonly normalTexture?: TextureBinding;
+    readonly emissiveTexture?: TextureBinding;
+    readonly occlusionTexture?: TextureBinding;
+}
+/** Slim view of a parsed `textures[]` row. */
+export interface TextureColorSpaceInput {
+    readonly source: number;
+}
+/**
+ * Inputs for {@link deriveTextureColorSpace}: just the parts of the parsed
+ * doc that the classifier reads. Decoupled from `GltfDoc` so the helper is
+ * trivially testable without building a full doc.
+ */
+export interface DeriveTextureColorSpaceInput {
+    readonly imageCount: number;
+    readonly textures: readonly TextureColorSpaceInput[] | undefined;
+    readonly materials: readonly MaterialColorSpaceInput[];
+}
+/**
+ * Walk the materials, follow each texture-slot binding back to the image
+ * it references, and produce `Map<imageIndex, 'srgb' | 'linear'>`. Slots
+ * disagreeing on the same image resolve to sRGB (see module header for
+ * the rationale). Orphan images default to linear.
+ */
+export declare function deriveTextureColorSpace(input: DeriveTextureColorSpaceInput): Map<number, ImageColorSpaceSrgbOrLinear>;
+export {};
+//# sourceMappingURL=image-color-space.d.ts.map

package/dist/image-color-space.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-color-space.d.ts","sourceRoot":"","sources":["../src/image-color-space.ts"],"names":[],"mappings":"AA2BA,MAAM,MAAM,2BAA2B,GAAG,MAAM,GAAG,QAAQ,CAAC;AAE5D,KAAK,cAAc,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAE5D,kFAAkF;AAClF,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,cAAc,CAAC;IAC3C,QAAQ,CAAC,wBAAwB,CAAC,EAAE,cAAc,CAAC;IACnD,QAAQ,CAAC,aAAa,CAAC,EAAE,cAAc,CAAC;IACxC,QAAQ,CAAC,eAAe,CAAC,EAAE,cAAc,CAAC;IAC1C,QAAQ,CAAC,gBAAgB,CAAC,EAAE,cAAc,CAAC;CAC5C;AAED,8CAA8C;AAC9C,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED;;;;GAIG;AACH,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,SAAS,sBAAsB,EAAE,GAAG,SAAS,CAAC;IACjE,QAAQ,CAAC,SAAS,EAAE,SAAS,uBAAuB,EAAE,CAAC;CACxD;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,4BAA4B,GAClC,GAAG,CAAC,MAAM,EAAE,2BAA2B,CAAC,CAuC1C"}

package/dist/importer-entry.d.ts

@@ -0,0 +1,10 @@
+import type { GltfBufferViewDecodeCapability } from './meshopt-decode.js';
+/** Browser/build consumer capability for EXT_meshopt_compression. */
+export declare const meshoptDecoder: GltfBufferViewDecodeCapability;
+/**
+ * Build-only glTF importer entry. The player-facing package remains free of
+ * the Meshopt WASM dependency; hosts opt into this entry when importing files.
+ */
+export declare const gltfImporter: import("@forgeax/engine-types").Importer;
+export { createGltfImporter } from './gltf-importer.js';
+//# sourceMappingURL=importer-entry.d.ts.map

package/dist/importer-entry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"importer-entry.d.ts","sourceRoot":"","sources":["../src/importer-entry.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,qBAAqB,CAAC;AAI1E,qEAAqE;AACrE,eAAO,MAAM,cAAc,EAAE,8BAM5B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,YAAY,0CAEvB,CAAC;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC"}