@carbonenginejs/runtime 0.1.0-alpha.0 → 0.1.0-alpha.1

package/dist/resource/formats/dxbc/core/helpers.js.map

@@ -1 +1 @@
-{"version":3,"file":"helpers.js","sources":["../../../../../../src/resource/formats/dxbc/core/helpers.js"],"sourcesContent":["import { asUint8Array } from \"#utils/bytes\";\n\n/**\n * Internal read-pipeline glue for CjsDxbcFormat.\n *\n * Keeps the public class file small: input normalization, option\n * normalization, the shared read path used by both the instance and the\n * static one-shots, and JSON conversion live here.\n */\n\nimport { DxbcContainer } from \"./container.js\";\nimport { DxbcSignatureChunk } from \"./signature.js\";\nimport { DxbcShaderProgram } from \"./program.js\";\nimport { DxbcInstructionDecoder } from \"./decoder.js\";\nimport { DxbcReadError } from \"./errors.js\";\n\nexport const OUTPUT_JSON = \"json\";\nexport const OUTPUT_RAW = \"raw\";\n\nexport const DEFAULT_VALUES = Object.freeze({\n    emit: OUTPUT_JSON,\n    source: \"memory\",\n    decodeInstructions: true\n});\n\nconst VALID_EMITS = new Set([ OUTPUT_JSON, OUTPUT_RAW ]);\n\nconst INPUT_SIGNATURE_TAGS = [ \"ISGN\", \"ISG1\" ];\nconst OUTPUT_SIGNATURE_TAGS = [ \"OSGN\", \"OSG1\", \"OSG5\" ];\nconst PATCH_SIGNATURE_TAGS = [ \"PCSG\", \"PSG1\" ];\n\n/**\n * Merge format values over a base set and validate them.\n *\n * @param {object} base Current values.\n * @param {object} [options] Values to merge in.\n * @param {string} [readerName] Reader name used in error messages.\n * @returns {object} A validated copy of the merged values.\n */\nexport function normalizeValues(base, options = {}, readerName = \"CjsDxbcFormat\")\n{\n    const values = { ...base, ...options };\n\n    if (!VALID_EMITS.has(values.emit))\n    {\n        throw new TypeError(`${readerName}: emit must be \"${OUTPUT_JSON}\" or \"${OUTPUT_RAW}\", got ${JSON.stringify(values.emit)}`);\n    }\n    if (typeof values.source !== \"string\" || !values.source)\n    {\n        values.source = DEFAULT_VALUES.source;\n    }\n    values.decodeInstructions = !!values.decodeInstructions;\n\n    return {\n        emit: values.emit,\n        source: values.source,\n        decodeInstructions: values.decodeInstructions\n    };\n}\n\n/**\n * Normalize caller input into a Uint8Array of DXBC bytes.\n *\n * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input Candidate payload.\n * @returns {Uint8Array} The payload bytes.\n */\r/**\n * Read a signature chunk group from a container if present.\n *\n * @param {DxbcContainer} container Parsed container.\n * @param {string[]} tags Chunk fourCC candidates in priority order.\n * @param {string} source Source name for errors.\n * @returns {?DxbcSignatureChunk} Parsed signature or null.\n */\nfunction readSignature(container, tags, source)\n{\n    for (const tag of tags)\n    {\n        const chunk = container.getChunk(tag);\n        if (chunk) return new DxbcSignatureChunk().Read(chunk, { source });\n    }\n    return null;\n}\n\n/**\n * The shared read path used by the instance Read and the static read.\n *\n * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input DXBC payload.\n * @param {object} values Normalized format values.\n * @returns {object} Raw read result (class instances).\n */\nexport function readRaw(input, values)\n{\n    const bytes = asUint8Array(input, \"CjsDxbcFormat input\");\n    const source = values.source;\n    const container = new DxbcContainer().Read(bytes, { source });\n    const shex = container.getChunk(\"SHEX\") || container.getChunk(\"SHDR\");\n\n    const result = {\n        source,\n        container,\n        program: null,\n        decoder: null,\n        inputSignature: readSignature(container, INPUT_SIGNATURE_TAGS, source),\n        outputSignature: readSignature(container, OUTPUT_SIGNATURE_TAGS, source),\n        patchSignature: readSignature(container, PATCH_SIGNATURE_TAGS, source)\n    };\n\n    if (shex)\n    {\n        result.program = new DxbcShaderProgram().Read(shex, { source });\n        if (values.decodeInstructions)\n        {\n            result.decoder = new DxbcInstructionDecoder().Decode(result.program, { source });\n        }\n    }\n\n    return result;\n}\n\n/**\n * Convert a raw read result to plain JSON-compatible data.\n *\n * @param {object} raw Raw read result from readRaw.\n * @returns {object} Plain data.\n */\nexport function rawToJson(raw)\n{\n    return toJsonValue({\n        source: raw.source,\n        container: raw.container.toJSON(),\n        program: raw.program\n            ? {\n                fourCC: raw.program.fourCC,\n                programType: raw.program.programType,\n                programTypeName: raw.program.programTypeName,\n                majorVersion: raw.program.majorVersion,\n                minorVersion: raw.program.minorVersion,\n                lengthDwords: raw.program.lengthDwords\n            }\n            : null,\n        inputSignature: raw.inputSignature ? raw.inputSignature.elements : null,\n        outputSignature: raw.outputSignature ? raw.outputSignature.elements : null,\n        patchSignature: raw.patchSignature ? raw.patchSignature.elements : null,\n        instructions: raw.decoder ? raw.decoder.instructions : null\n    });\n}\n\n/**\n * Shared read entry honouring the emit mode.\n *\n * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input DXBC payload.\n * @param {object} values Normalized format values.\n * @returns {object} Raw result or plain JSON data per values.emit.\n */\nexport function readWithValues(input, values)\n{\n    const raw = readRaw(input, values);\n    return values.emit === OUTPUT_RAW ? raw : rawToJson(raw);\n}\n\n/**\n * Cheap inspection: container/program facts without instruction decode.\n *\n * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input DXBC payload.\n * @param {object} values Normalized format values.\n * @returns {object} Plain summary data.\n */\nexport function inspectWithValues(input, values)\n{\n    const raw = readRaw(input, { ...values, decodeInstructions: false });\n    return toJsonValue({\n        source: raw.source,\n        isDxbc: true,\n        version: raw.container.version,\n        totalSize: raw.container.totalSize,\n        chunks: raw.container.chunks.map(({ fourCC, offset, size }) => ({ fourCC, offset, size })),\n        programTypeName: raw.program ? raw.program.programTypeName : null,\n        shaderModel: raw.program ? `${raw.program.majorVersion}.${raw.program.minorVersion}` : null,\n        inputElementCount: raw.inputSignature ? raw.inputSignature.elements.length : 0,\n        outputElementCount: raw.outputSignature ? raw.outputSignature.elements.length : 0\n    });\n}\n\n/**\n * Deep-convert a value to plain JSON-compatible data. Typed arrays become\n * plain number arrays; Maps/Sets become objects/arrays; class instances\n * with toJSON are honoured.\n *\n * @param {any} value Value to convert.\n * @returns {any} Plain data.\n */\nexport function toJsonValue(value)\n{\n    if (value === null || value === undefined) return value ?? null;\n    if (typeof value === \"number\" || typeof value === \"string\" || typeof value === \"boolean\") return value;\n    if (typeof value === \"bigint\") return value.toString();\n    if (ArrayBuffer.isView(value)) return Array.from(value);\n    if (Array.isArray(value)) return value.map(toJsonValue);\n    if (value instanceof Map)\n    {\n        const out = {};\n        for (const [ key, entry ] of value) out[key] = toJsonValue(entry);\n        return out;\n    }\n    if (value instanceof Set) return Array.from(value, toJsonValue);\n    if (typeof value === \"object\")\n    {\n        if (typeof value.toJSON === \"function\") return toJsonValue(value.toJSON());\n        const out = {};\n        for (const key of Object.keys(value)) out[key] = toJsonValue(value[key]);\n        return out;\n    }\n    return null;\n}\n\nexport { DxbcReadError };\n\n"],"names":["OUTPUT_JSON","OUTPUT_RAW","DEFAULT_VALUES","Object","freeze","emit","source","decodeInstructions","VALID_EMITS","Set","INPUT_SIGNATURE_TAGS","OUTPUT_SIGNATURE_TAGS","PATCH_SIGNATURE_TAGS","normalizeValues","base","options","readerName","values","has","TypeError","JSON","stringify","readSignature","container","tags","tag","chunk","getChunk","DxbcSignatureChunk","Read","readRaw","input","bytes","asUint8Array","DxbcContainer","shex","result","program","decoder","inputSignature","outputSignature","patchSignature","DxbcShaderProgram","DxbcInstructionDecoder","Decode","rawToJson","raw","toJsonValue","toJSON","fourCC","programType","programTypeName","majorVersion","minorVersion","lengthDwords","elements","instructions","readWithValues","inspectWithValues","isDxbc","version","totalSize","chunks","map","offset","size","shaderModel","inputElementCount","length","outputElementCount","value","undefined","toString","ArrayBuffer","isView","Array","from","isArray","Map","out","key","entry","keys"],"mappings":";;;;;;AAgBO,MAAMA,WAAW,GAAG;AACpB,MAAMC,UAAU,GAAG;MAEbC,cAAc,GAAGC,MAAM,CAACC,MAAM,CAAC;AACxCC,EAAAA,IAAI,EAAEL,WAAW;AACjBM,EAAAA,MAAM,EAAE,QAAQ;AAChBC,EAAAA,kBAAkB,EAAE;AACxB,CAAC;AAED,MAAMC,WAAW,GAAG,IAAIC,GAAG,CAAC,CAAET,WAAW,EAAEC,UAAU,CAAE,CAAC;AAExD,MAAMS,oBAAoB,GAAG,CAAE,MAAM,EAAE,MAAM,CAAE;AAC/C,MAAMC,qBAAqB,GAAG,CAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAE;AACxD,MAAMC,oBAAoB,GAAG,CAAE,MAAM,EAAE,MAAM,CAAE;;AAE/C;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASC,eAAeA,CAACC,IAAI,EAAEC,OAAO,GAAG,EAAE,EAAEC,UAAU,GAAG,eAAe,EAChF;AACI,EAAA,MAAMC,MAAM,GAAG;AAAE,IAAA,GAAGH,IAAI;IAAE,GAAGC;GAAS;EAEtC,IAAI,CAACP,WAAW,CAACU,GAAG,CAACD,MAAM,CAACZ,IAAI,CAAC,EACjC;AACI,IAAA,MAAM,IAAIc,SAAS,CAAC,GAAGH,UAAU,CAAA,gBAAA,EAAmBhB,WAAW,CAAA,MAAA,EAASC,UAAU,UAAUmB,IAAI,CAACC,SAAS,CAACJ,MAAM,CAACZ,IAAI,CAAC,EAAE,CAAC;AAC9H,EAAA;EACA,IAAI,OAAOY,MAAM,CAACX,MAAM,KAAK,QAAQ,IAAI,CAACW,MAAM,CAACX,MAAM,EACvD;AACIW,IAAAA,MAAM,CAACX,MAAM,GAAGJ,cAAc,CAACI,MAAM;AACzC,EAAA;AACAW,EAAAA,MAAM,CAACV,kBAAkB,GAAG,CAAC,CAACU,MAAM,CAACV,kBAAkB;EAEvD,OAAO;IACHF,IAAI,EAAEY,MAAM,CAACZ,IAAI;IACjBC,MAAM,EAAEW,MAAM,CAACX,MAAM;IACrBC,kBAAkB,EAAEU,MAAM,CAACV;GAC9B;AACL;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,SAASe,aAAaA,CAACC,SAAS,EAAEC,IAAI,EAAElB,MAAM,EAC9C;AACI,EAAA,KAAK,MAAMmB,GAAG,IAAID,IAAI,EACtB;AACI,IAAA,MAAME,KAAK,GAAGH,SAAS,CAACI,QAAQ,CAACF,GAAG,CAAC;IACrC,IAAIC,KAAK,EAAE,OAAO,IAAIE,kBAAkB,EAAE,CAACC,IAAI,CAACH,KAAK,EAAE;AAAEpB,MAAAA;AAAO,KAAC,CAAC;AACtE,EAAA;AACA,EAAA,OAAO,IAAI;AACf;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASwB,OAAOA,CAACC,KAAK,EAAEd,MAAM,EACrC;AACI,EAAA,MAAMe,KAAK,GAAGC,YAAY,CAACF,KAAK,EAAE,qBAAqB,CAAC;AACxD,EAAA,MAAMzB,MAAM,GAAGW,MAAM,CAACX,MAAM;EAC5B,MAAMiB,SAAS,GAAG,IAAIW,aAAa,EAAE,CAACL,IAAI,CAACG,KAAK,EAAE;AAAE1B,IAAAA;AAAO,GAAC,CAAC;AAC7D,EAAA,MAAM6B,IAAI,GAAGZ,SAAS,CAACI,QAAQ,CAAC,MAAM,CAAC,IAAIJ,SAAS,CAACI,QAAQ,CAAC,MAAM,CAAC;AAErE,EAAA,MAAMS,MAAM,GAAG;IACX9B,MAAM;IACNiB,SAAS;AACTc,IAAAA,OAAO,EAAE,IAAI;AACbC,IAAAA,OAAO,EAAE,IAAI;IACbC,cAAc,EAAEjB,aAAa,CAACC,SAAS,EAAEb,oBAAoB,EAAEJ,MAAM,CAAC;IACtEkC,eAAe,EAAElB,aAAa,CAACC,SAAS,EAAEZ,qBAAqB,EAAEL,MAAM,CAAC;AACxEmC,IAAAA,cAAc,EAAEnB,aAAa,CAACC,SAAS,EAAEX,oBAAoB,EAAEN,MAAM;GACxE;AAED,EAAA,IAAI6B,IAAI,EACR;IACIC,MAAM,CAACC,OAAO,GAAG,IAAIK,iBAAiB,EAAE,CAACb,IAAI,CAACM,IAAI,EAAE;AAAE7B,MAAAA;AAAO,KAAC,CAAC;IAC/D,IAAIW,MAAM,CAACV,kBAAkB,EAC7B;AACI6B,MAAAA,MAAM,CAACE,OAAO,GAAG,IAAIK,sBAAsB,EAAE,CAACC,MAAM,CAACR,MAAM,CAACC,OAAO,EAAE;AAAE/B,QAAAA;AAAO,OAAC,CAAC;AACpF,IAAA;AACJ,EAAA;AAEA,EAAA,OAAO8B,MAAM;AACjB;;AAEA;AACA;AACA;AACA;AACA;AACA;AACO,SAASS,SAASA,CAACC,GAAG,EAC7B;AACI,EAAA,OAAOC,WAAW,CAAC;IACfzC,MAAM,EAAEwC,GAAG,CAACxC,MAAM;AAClBiB,IAAAA,SAAS,EAAEuB,GAAG,CAACvB,SAAS,CAACyB,MAAM,EAAE;AACjCX,IAAAA,OAAO,EAAES,GAAG,CAACT,OAAO,GACd;AACEY,MAAAA,MAAM,EAAEH,GAAG,CAACT,OAAO,CAACY,MAAM;AAC1BC,MAAAA,WAAW,EAAEJ,GAAG,CAACT,OAAO,CAACa,WAAW;AACpCC,MAAAA,eAAe,EAAEL,GAAG,CAACT,OAAO,CAACc,eAAe;AAC5CC,MAAAA,YAAY,EAAEN,GAAG,CAACT,OAAO,CAACe,YAAY;AACtCC,MAAAA,YAAY,EAAEP,GAAG,CAACT,OAAO,CAACgB,YAAY;AACtCC,MAAAA,YAAY,EAAER,GAAG,CAACT,OAAO,CAACiB;AAC9B,KAAC,GACC,IAAI;IACVf,cAAc,EAAEO,GAAG,CAACP,cAAc,GAAGO,GAAG,CAACP,cAAc,CAACgB,QAAQ,GAAG,IAAI;IACvEf,eAAe,EAAEM,GAAG,CAACN,eAAe,GAAGM,GAAG,CAACN,eAAe,CAACe,QAAQ,GAAG,IAAI;IAC1Ed,cAAc,EAAEK,GAAG,CAACL,cAAc,GAAGK,GAAG,CAACL,cAAc,CAACc,QAAQ,GAAG,IAAI;IACvEC,YAAY,EAAEV,GAAG,CAACR,OAAO,GAAGQ,GAAG,CAACR,OAAO,CAACkB,YAAY,GAAG;AAC3D,GAAC,CAAC;AACN;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASC,cAAcA,CAAC1B,KAAK,EAAEd,MAAM,EAC5C;AACI,EAAA,MAAM6B,GAAG,GAAGhB,OAAO,CAACC,KAAK,EAAEd,MAAM,CAAC;EAClC,OAAOA,MAAM,CAACZ,IAAI,KAAKJ,UAAU,GAAG6C,GAAG,GAAGD,SAAS,CAACC,GAAG,CAAC;AAC5D;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASY,iBAAiBA,CAAC3B,KAAK,EAAEd,MAAM,EAC/C;AACI,EAAA,MAAM6B,GAAG,GAAGhB,OAAO,CAACC,KAAK,EAAE;AAAE,IAAA,GAAGd,MAAM;AAAEV,IAAAA,kBAAkB,EAAE;AAAM,GAAC,CAAC;AACpE,EAAA,OAAOwC,WAAW,CAAC;IACfzC,MAAM,EAAEwC,GAAG,CAACxC,MAAM;AAClBqD,IAAAA,MAAM,EAAE,IAAI;AACZC,IAAAA,OAAO,EAAEd,GAAG,CAACvB,SAAS,CAACqC,OAAO;AAC9BC,IAAAA,SAAS,EAAEf,GAAG,CAACvB,SAAS,CAACsC,SAAS;IAClCC,MAAM,EAAEhB,GAAG,CAACvB,SAAS,CAACuC,MAAM,CAACC,GAAG,CAAC,CAAC;MAAEd,MAAM;MAAEe,MAAM;AAAEC,MAAAA;AAAK,KAAC,MAAM;MAAEhB,MAAM;MAAEe,MAAM;AAAEC,MAAAA;AAAK,KAAC,CAAC,CAAC;IAC1Fd,eAAe,EAAEL,GAAG,CAACT,OAAO,GAAGS,GAAG,CAACT,OAAO,CAACc,eAAe,GAAG,IAAI;AACjEe,IAAAA,WAAW,EAAEpB,GAAG,CAACT,OAAO,GAAG,CAAA,EAAGS,GAAG,CAACT,OAAO,CAACe,YAAY,CAAA,CAAA,EAAIN,GAAG,CAACT,OAAO,CAACgB,YAAY,CAAA,CAAE,GAAG,IAAI;AAC3Fc,IAAAA,iBAAiB,EAAErB,GAAG,CAACP,cAAc,GAAGO,GAAG,CAACP,cAAc,CAACgB,QAAQ,CAACa,MAAM,GAAG,CAAC;AAC9EC,IAAAA,kBAAkB,EAAEvB,GAAG,CAACN,eAAe,GAAGM,GAAG,CAACN,eAAe,CAACe,QAAQ,CAACa,MAAM,GAAG;AACpF,GAAC,CAAC;AACN;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASrB,WAAWA,CAACuB,KAAK,EACjC;EACI,IAAIA,KAAK,KAAK,IAAI,IAAIA,KAAK,KAAKC,SAAS,EAAE,OAAOD,KAAK,IAAI,IAAI;AAC/D,EAAA,IAAI,OAAOA,KAAK,KAAK,QAAQ,IAAI,OAAOA,KAAK,KAAK,QAAQ,IAAI,OAAOA,KAAK,KAAK,SAAS,EAAE,OAAOA,KAAK;EACtG,IAAI,OAAOA,KAAK,KAAK,QAAQ,EAAE,OAAOA,KAAK,CAACE,QAAQ,EAAE;AACtD,EAAA,IAAIC,WAAW,CAACC,MAAM,CAACJ,KAAK,CAAC,EAAE,OAAOK,KAAK,CAACC,IAAI,CAACN,KAAK,CAAC;AACvD,EAAA,IAAIK,KAAK,CAACE,OAAO,CAACP,KAAK,CAAC,EAAE,OAAOA,KAAK,CAACP,GAAG,CAAChB,WAAW,CAAC;EACvD,IAAIuB,KAAK,YAAYQ,GAAG,EACxB;IACI,MAAMC,GAAG,GAAG,EAAE;AACd,IAAA,KAAK,MAAM,CAAEC,GAAG,EAAEC,KAAK,CAAE,IAAIX,KAAK,EAAES,GAAG,CAACC,GAAG,CAAC,GAAGjC,WAAW,CAACkC,KAAK,CAAC;AACjE,IAAA,OAAOF,GAAG;AACd,EAAA;AACA,EAAA,IAAIT,KAAK,YAAY7D,GAAG,EAAE,OAAOkE,KAAK,CAACC,IAAI,CAACN,KAAK,EAAEvB,WAAW,CAAC;AAC/D,EAAA,IAAI,OAAOuB,KAAK,KAAK,QAAQ,EAC7B;AACI,IAAA,IAAI,OAAOA,KAAK,CAACtB,MAAM,KAAK,UAAU,EAAE,OAAOD,WAAW,CAACuB,KAAK,CAACtB,MAAM,EAAE,CAAC;IAC1E,MAAM+B,GAAG,GAAG,EAAE;IACd,KAAK,MAAMC,GAAG,IAAI7E,MAAM,CAAC+E,IAAI,CAACZ,KAAK,CAAC,EAAES,GAAG,CAACC,GAAG,CAAC,GAAGjC,WAAW,CAACuB,KAAK,CAACU,GAAG,CAAC,CAAC;AACxE,IAAA,OAAOD,GAAG;AACd,EAAA;AACA,EAAA,OAAO,IAAI;AACf;;;;"}
+{"version":3,"file":"helpers.js","sources":["../../../../../../src/resource/formats/dxbc/core/helpers.js"],"sourcesContent":["import { toJsonWithCollections as toJsonValue } from \"../../../format/jsonPolicies.js\";\nimport { asUint8Array } from \"#utils/bytes\";\n\n/**\n * Internal read-pipeline glue for CjsDxbcFormat.\n *\n * Keeps the public class file small: input normalization, option\n * normalization, the shared read path used by both the instance and the\n * static one-shots, and JSON conversion live here.\n */\n\nimport { DxbcContainer } from \"./container.js\";\nimport { DxbcSignatureChunk } from \"./signature.js\";\nimport { DxbcShaderProgram } from \"./program.js\";\nimport { DxbcInstructionDecoder } from \"./decoder.js\";\nimport { DxbcReadError } from \"./errors.js\";\n\nexport const OUTPUT_JSON = \"json\";\nexport const OUTPUT_RAW = \"raw\";\n\nexport const DEFAULT_VALUES = Object.freeze({\n    emit: OUTPUT_JSON,\n    source: \"memory\",\n    decodeInstructions: true\n});\n\nconst VALID_EMITS = new Set([ OUTPUT_JSON, OUTPUT_RAW ]);\n\nconst INPUT_SIGNATURE_TAGS = [ \"ISGN\", \"ISG1\" ];\nconst OUTPUT_SIGNATURE_TAGS = [ \"OSGN\", \"OSG1\", \"OSG5\" ];\nconst PATCH_SIGNATURE_TAGS = [ \"PCSG\", \"PSG1\" ];\n\n/**\n * Merge format values over a base set and validate them.\n *\n * @param {object} base Current values.\n * @param {object} [options] Values to merge in.\n * @param {string} [readerName] Reader name used in error messages.\n * @returns {object} A validated copy of the merged values.\n */\nexport function normalizeValues(base, options = {}, readerName = \"CjsDxbcFormat\")\n{\n    const values = { ...base, ...options };\n\n    if (!VALID_EMITS.has(values.emit))\n    {\n        throw new TypeError(`${readerName}: emit must be \"${OUTPUT_JSON}\" or \"${OUTPUT_RAW}\", got ${JSON.stringify(values.emit)}`);\n    }\n    if (typeof values.source !== \"string\" || !values.source)\n    {\n        values.source = DEFAULT_VALUES.source;\n    }\n    values.decodeInstructions = !!values.decodeInstructions;\n\n    return {\n        emit: values.emit,\n        source: values.source,\n        decodeInstructions: values.decodeInstructions\n    };\n}\n\n/**\n * Normalize caller input into a Uint8Array of DXBC bytes.\n *\n * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input Candidate payload.\n * @returns {Uint8Array} The payload bytes.\n */\n/**\n * Read a signature chunk group from a container if present.\n *\n * @param {DxbcContainer} container Parsed container.\n * @param {string[]} tags Chunk fourCC candidates in priority order.\n * @param {string} source Source name for errors.\n * @returns {?DxbcSignatureChunk} Parsed signature or null.\n */\nfunction readSignature(container, tags, source)\n{\n    for (const tag of tags)\n    {\n        const chunk = container.getChunk(tag);\n        if (chunk) return new DxbcSignatureChunk().Read(chunk, { source });\n    }\n    return null;\n}\n\n/**\n * The shared read path used by the instance Read and the static read.\n *\n * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input DXBC payload.\n * @param {object} values Normalized format values.\n * @returns {object} Raw read result (class instances).\n */\nexport function readRaw(input, values)\n{\n    const bytes = asUint8Array(input, \"CjsDxbcFormat input\");\n    const source = values.source;\n    const container = new DxbcContainer().Read(bytes, { source });\n    const shex = container.getChunk(\"SHEX\") || container.getChunk(\"SHDR\");\n\n    const result = {\n        source,\n        container,\n        program: null,\n        decoder: null,\n        inputSignature: readSignature(container, INPUT_SIGNATURE_TAGS, source),\n        outputSignature: readSignature(container, OUTPUT_SIGNATURE_TAGS, source),\n        patchSignature: readSignature(container, PATCH_SIGNATURE_TAGS, source)\n    };\n\n    if (shex)\n    {\n        result.program = new DxbcShaderProgram().Read(shex, { source });\n        if (values.decodeInstructions)\n        {\n            result.decoder = new DxbcInstructionDecoder().Decode(result.program, { source });\n        }\n    }\n\n    return result;\n}\n\n/**\n * Convert a raw read result to plain JSON-compatible data.\n *\n * @param {object} raw Raw read result from readRaw.\n * @returns {object} Plain data.\n */\nexport function rawToJson(raw)\n{\n    return toJsonValue({\n        source: raw.source,\n        container: raw.container.toJSON(),\n        program: raw.program\n            ? {\n                fourCC: raw.program.fourCC,\n                programType: raw.program.programType,\n                programTypeName: raw.program.programTypeName,\n                majorVersion: raw.program.majorVersion,\n                minorVersion: raw.program.minorVersion,\n                lengthDwords: raw.program.lengthDwords\n            }\n            : null,\n        inputSignature: raw.inputSignature ? raw.inputSignature.elements : null,\n        outputSignature: raw.outputSignature ? raw.outputSignature.elements : null,\n        patchSignature: raw.patchSignature ? raw.patchSignature.elements : null,\n        instructions: raw.decoder ? raw.decoder.instructions : null\n    });\n}\n\n/**\n * Shared read entry honouring the emit mode.\n *\n * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input DXBC payload.\n * @param {object} values Normalized format values.\n * @returns {object} Raw result or plain JSON data per values.emit.\n */\nexport function readWithValues(input, values)\n{\n    const raw = readRaw(input, values);\n    return values.emit === OUTPUT_RAW ? raw : rawToJson(raw);\n}\n\n/**\n * Cheap inspection: container/program facts without instruction decode.\n *\n * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input DXBC payload.\n * @param {object} values Normalized format values.\n * @returns {object} Plain summary data.\n */\nexport function inspectWithValues(input, values)\n{\n    const raw = readRaw(input, { ...values, decodeInstructions: false });\n    return toJsonValue({\n        source: raw.source,\n        isDxbc: true,\n        version: raw.container.version,\n        totalSize: raw.container.totalSize,\n        chunks: raw.container.chunks.map(({ fourCC, offset, size }) => ({ fourCC, offset, size })),\n        programTypeName: raw.program ? raw.program.programTypeName : null,\n        shaderModel: raw.program ? `${raw.program.majorVersion}.${raw.program.minorVersion}` : null,\n        inputElementCount: raw.inputSignature ? raw.inputSignature.elements.length : 0,\n        outputElementCount: raw.outputSignature ? raw.outputSignature.elements.length : 0\n    });\n}\n\n/**\n * Deep-convert a value to plain JSON-compatible data. Typed arrays become\n * plain number arrays; Maps/Sets become objects/arrays; class instances\n * with toJSON are honoured.\n *\n * @param {any} value Value to convert.\n * @returns {any} Plain data.\n */\n/** The shared JSON policy for this reader, under the name its callers use. */\nexport { toJsonValue };\n\nexport { DxbcReadError };\n\n"],"names":["OUTPUT_JSON","OUTPUT_RAW","DEFAULT_VALUES","Object","freeze","emit","source","decodeInstructions","VALID_EMITS","Set","INPUT_SIGNATURE_TAGS","OUTPUT_SIGNATURE_TAGS","PATCH_SIGNATURE_TAGS","normalizeValues","base","options","readerName","values","has","TypeError","JSON","stringify","readSignature","container","tags","tag","chunk","getChunk","DxbcSignatureChunk","Read","readRaw","input","bytes","asUint8Array","DxbcContainer","shex","result","program","decoder","inputSignature","outputSignature","patchSignature","DxbcShaderProgram","DxbcInstructionDecoder","Decode","rawToJson","raw","toJsonValue","toJSON","fourCC","programType","programTypeName","majorVersion","minorVersion","lengthDwords","elements","instructions","readWithValues","inspectWithValues","isDxbc","version","totalSize","chunks","map","offset","size","shaderModel","inputElementCount","length","outputElementCount"],"mappings":"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"}

package/dist/resource/formats/fbx/CjsFbxFormat.js

@@ -270,6 +270,17 @@ class CjsFbxFormat extends CjsFormat {
   static CLASS_KEYS = CLASS_KEYS;
   static id = "fbx";
   static mediaTypes = Object.freeze(["geometry"]);
+  // FBX is written THROUGH CMF: `write` takes a native CMF graph and
+  // `writeShared` converts shared or GR2-shaped geometry into one first.
+  static inputs = CjsFormat.defineInputs({
+    cmf: {
+      default: true,
+      payloadType: "geometry"
+    },
+    shared: {
+      payloadType: "geometry"
+    }
+  });
   static outputs = CjsFormat.defineOutputs({
     gr2: {
       decoded: true

package/dist/resource/formats/fbx/CjsFbxFormat.js.map

@@ -1 +1 @@
-{"version":3,"file":"CjsFbxFormat.js","sources":["../../../../../src/resource/formats/fbx/CjsFbxFormat.js"],"sourcesContent":["import { asUint8Array } from \"#utils/bytes\";\nimport { CjsFormat } from \"../../format/CjsFormat.js\";\nimport {\n    CLASS_KEYS,\n    DEFAULT_VALUES,\n    OUTPUT_CMF,\n    OUTPUT_FBX_JSON,\n    OUTPUT_GR2,\n    OUTPUT_JSON,\n    OUTPUT_RAW,\n    inspectWithValues,\n    isFBX,\n    probeSupportWithValues,\n    normalizeValues,\n    readWithValues,\n    toJsonValue,\n    validateClass,\n    validateClassKey\n} from \"./core/helpers.js\";\nimport { writeFbx, writeSharedFbx } from \"./core/writer.js\";\n\nconst FORMAT_NAME = \"CjsFbxFormat\";\n\n/**\n * CarbonEngineJS-facing FBX format surface.\n *\n * FBX is recognized, inspected, imported into CMF/GR2 compatibility graphs,\n * and exported from native CMF in pure JavaScript. Geometry, skeletons, skin,\n * morph targets, and their animations are in scope; cameras and lights are not.\n */\nexport class CjsFbxFormat extends CjsFormat\n{\n    #values = DEFAULT_VALUES;\n\n    /**\n     * Create a reusable FBX format profile.\n     *\n     * @param {object} [options] Default read/inspect options.\n     */\n    constructor(options = {})\n    {\n        super();\n        this.SetValues(options);\n    }\n\n    /**\n     * Merge options into this profile.\n     *\n     * @param {object} [options] Values to merge.\n     * @returns {CjsFbxFormat} This format profile.\n     */\n    SetValues(options = {})\n    {\n        this.#values = normalizeValues(this.#values, { inputType: \"fbx\", ...options }, FORMAT_NAME);\n        return this;\n    }\n\n    /**\n     * Get normalized profile values with optional per-call overrides.\n     *\n     * @param {object} [options] Per-call values.\n     * @returns {object} Normalized read values.\n     */\n    GetValues(options = {})\n    {\n        return normalizeValues(this.#values, { inputType: \"fbx\", ...options }, FORMAT_NAME);\n    }\n\n    /**\n     * Set multiple output node constructors for this profile.\n     *\n     * These constructors are used only for explicit runtime output targets such\n     * as `emit: \"gr2\"` and `emit: \"cmf\"` paths. Debug `fbxJson` output\n     * remains plain data.\n     *\n     * @param {object} [classes] Map of output node class keys to constructors.\n     * @returns {CjsFbxFormat} This format profile.\n     */\n    SetClasses(classes = {})\n    {\n        return this.SetValues({ classes });\n    }\n\n    /**\n     * Set one output node constructor for this profile.\n     *\n     * @param {string} type Output node class key.\n     * @param {Function|null|undefined} Class Constructor to use, or nullish to delete.\n     * @returns {CjsFbxFormat} This format profile.\n     */\n    SetClass(type, Class)\n    {\n        validateClassKey(type, FORMAT_NAME);\n\n        if (Class === null || Class === undefined)\n        {\n            const classes = { ...this.#values.classes };\n            delete classes[type];\n            this.#values = { ...this.#values, classes };\n            return this;\n        }\n\n        validateClass(type, Class, FORMAT_NAME);\n        return this.SetValues({ classes: { [type]: Class } });\n    }\n\n    /**\n     * Get a configured output node constructor.\n     *\n     * @param {string} type Output node class key.\n     * @returns {Function|undefined} The registered constructor, if any.\n     */\n    GetClass(type)\n    {\n        validateClassKey(type, FORMAT_NAME);\n        return this.#values.classes[type];\n    }\n\n    /**\n     * Whether this profile has a constructor registered for an output node key.\n     *\n     * @param {string} type Output node class key.\n     * @returns {boolean} True when a constructor is registered.\n     */\n    HasClass(type)\n    {\n        return !!this.GetClass(type);\n    }\n\n    /**\n     * Read FBX bytes with this profile.\n     *\n     * @param {Uint8Array|ArrayBuffer|DataView} input FBX bytes.\n     * @param {object} [options] Per-call values.\n     * @returns {object} Raw or debug payload for the selected emit target.\n     */\n    Read(input, options = {})\n    {\n        return readWithValues(input, this.GetValues(options));\n    }\n\n    /** Write a native CMF graph as deterministic binary FBX 7400 bytes. */\n    Write(input, options = {})\n    {\n        return writeFbx(input, options);\n    }\n\n    /** Convert shared or GR2-shaped geometry through CMF and write FBX. */\n    WriteShared(input, options = {})\n    {\n        return writeSharedFbx(input, options);\n    }\n\n    /**\n     * Read FBX bytes asynchronously with this profile.\n     *\n     * @param {Uint8Array|ArrayBuffer|DataView} input FBX bytes.\n     * @param {object} [options] Per-call values.\n     * @returns {Promise<object>} Raw or debug payload for the selected emit target.\n     */\n    async ReadAsync(input, options = {})\n    {\n        return this.Read(input, options);\n    }\n\n    /**\n     * Inspect FBX bytes without converting geometry.\n     *\n     * @param {Uint8Array|ArrayBuffer|DataView} input FBX bytes.\n     * @param {object} [options] Per-call values.\n     * @returns {object} Lightweight FBX metadata.\n     */\n    Inspect(input, options = {})\n    {\n        return inspectWithValues(input, this.GetValues(options));\n    }\n\n    /**\n     * Convert format output into JSON-compatible debug data.\n     *\n     * @param {any} value Format output.\n     * @returns {any} JSON-compatible value.\n     */\n    ToJSON(value)\n    {\n        return toJsonValue(value);\n    }\n\n    /**\n     * One-shot FBX read.\n     *\n     * @param {Uint8Array|ArrayBuffer|DataView} input FBX bytes.\n     * @param {object} [options] Read options.\n     * @returns {object} Raw or debug payload for the selected emit target.\n     */\n    static read(input, options = {})\n    {\n        return readWithValues(input, normalizeValues(DEFAULT_VALUES, { inputType: \"fbx\", ...options }, FORMAT_NAME));\n    }\n\n    /** Write a native CMF graph as deterministic binary FBX 7400 bytes. */\n    static write(input, options = {})\n    {\n        return writeFbx(input, options);\n    }\n\n    /** Convert shared or GR2-shaped geometry through CMF and write FBX. */\n    static writeShared(input, options = {})\n    {\n        return writeSharedFbx(input, options);\n    }\n\n    /**\n     * One-shot asynchronous FBX read.\n     *\n     * @param {Uint8Array|ArrayBuffer|DataView} input FBX bytes.\n     * @param {object} [options] Read options.\n     * @returns {Promise<object>} Raw or debug payload for the selected emit target.\n     */\n    static async readAsync(input, options = {})\n    {\n        return CjsFbxFormat.read(input, options);\n    }\n\n    /**\n     * One-shot FBX inspection.\n     *\n     * @param {Uint8Array|ArrayBuffer|DataView} input FBX bytes.\n     * @param {object} [options] Inspect options.\n     * @returns {object} Lightweight FBX metadata.\n     */\n    static inspect(input, options = {})\n    {\n        return inspectWithValues(input, normalizeValues(DEFAULT_VALUES, { inputType: \"fbx\", ...options }, FORMAT_NAME));\n    }\n\n    /**\n     * One-shot FBX support probe.\n     *\n     * @param {Uint8Array|ArrayBuffer|DataView} input FBX bytes.\n     * @param {object} [options] Probe options.\n     * @returns {object} Support/probe report.\n     */\n    static probeSupport(input, options = {})\n    {\n        return probeSupportWithValues(input, normalizeValues(DEFAULT_VALUES, { inputType: \"fbx\", ...options }, FORMAT_NAME));\n    }\n\n    /**\n     * Convert format output into JSON-compatible debug data.\n     *\n     * @param {any} value Format output.\n     * @returns {any} JSON-compatible value.\n     */\n    static toJSON(value)\n    {\n        return toJsonValue(value);\n    }\n\n    /**\n     * Test whether bytes look like an FBX file.\n     *\n     * @param {Uint8Array|ArrayBuffer|DataView} input Candidate FBX bytes.\n     * @returns {boolean} True when the input appears to be FBX.\n     */\n    static isFBX(input)\n    {\n        try\n        {\n            return isFBX(asUint8Array(input, \"Fbx input\"));\n        }\n        catch\n        {\n            return false;\n        }\n    }\n\n    /**\n     * Emit targets for this format (canonical frozen enum).\n     */\n    static Output = Object.freeze({\n        CMF: OUTPUT_CMF,\n        GR2: OUTPUT_GR2,\n        RAW: OUTPUT_RAW,\n        JSON: OUTPUT_JSON,\n        FBX_JSON: OUTPUT_FBX_JSON\n    });\n    static CLASS_KEYS = CLASS_KEYS;\n    static id = \"fbx\";\n    static mediaTypes = Object.freeze([ \"geometry\" ]);\n    static outputs = CjsFormat.defineOutputs({\n        gr2: { decoded: true },\n        cmf: { decoded: true },\n        fbxJson: { role: \"debug\", decoded: true, probes: [ \"fbxJson\", \"document\" ] },\n        raw: { role: \"debug\", default: true, passthrough: true, probes: [ \"raw\", \"document\" ] }\n    });\n    static extensions = Object.freeze([ \".fbx\" ]);\n}\n\nexport default CjsFbxFormat;\n"],"names":["FORMAT_NAME","CjsFbxFormat","CjsFormat","DEFAULT_VALUES","constructor","options","SetValues","normalizeValues","inputType","GetValues","SetClasses","classes","SetClass","type","Class","validateClassKey","undefined","validateClass","GetClass","HasClass","Read","input","readWithValues","Write","writeFbx","WriteShared","writeSharedFbx","ReadAsync","Inspect","inspectWithValues","ToJSON","value","toJsonValue","read","write","writeShared","readAsync","inspect","probeSupport","probeSupportWithValues","toJSON","isFBX","asUint8Array","Output","Object","freeze","CMF","OUTPUT_CMF","GR2","OUTPUT_GR2","RAW","OUTPUT_RAW","JSON","OUTPUT_JSON","FBX_JSON","OUTPUT_FBX_JSON","CLASS_KEYS","id","mediaTypes","outputs","defineOutputs","gr2","decoded","cmf","fbxJson","role","probes","raw","default","passthrough","extensions"],"mappings":"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"}
+{"version":3,"file":"CjsFbxFormat.js","sources":["../../../../../src/resource/formats/fbx/CjsFbxFormat.js"],"sourcesContent":["import { asUint8Array } from \"#utils/bytes\";\nimport { CjsFormat } from \"../../format/CjsFormat.js\";\nimport {\n    CLASS_KEYS,\n    DEFAULT_VALUES,\n    OUTPUT_CMF,\n    OUTPUT_FBX_JSON,\n    OUTPUT_GR2,\n    OUTPUT_JSON,\n    OUTPUT_RAW,\n    inspectWithValues,\n    isFBX,\n    probeSupportWithValues,\n    normalizeValues,\n    readWithValues,\n    toJsonValue,\n    validateClass,\n    validateClassKey\n} from \"./core/helpers.js\";\nimport { writeFbx, writeSharedFbx } from \"./core/writer.js\";\n\nconst FORMAT_NAME = \"CjsFbxFormat\";\n\n/**\n * CarbonEngineJS-facing FBX format surface.\n *\n * FBX is recognized, inspected, imported into CMF/GR2 compatibility graphs,\n * and exported from native CMF in pure JavaScript. Geometry, skeletons, skin,\n * morph targets, and their animations are in scope; cameras and lights are not.\n */\nexport class CjsFbxFormat extends CjsFormat\n{\n    #values = DEFAULT_VALUES;\n\n    /**\n     * Create a reusable FBX format profile.\n     *\n     * @param {object} [options] Default read/inspect options.\n     */\n    constructor(options = {})\n    {\n        super();\n        this.SetValues(options);\n    }\n\n    /**\n     * Merge options into this profile.\n     *\n     * @param {object} [options] Values to merge.\n     * @returns {CjsFbxFormat} This format profile.\n     */\n    SetValues(options = {})\n    {\n        this.#values = normalizeValues(this.#values, { inputType: \"fbx\", ...options }, FORMAT_NAME);\n        return this;\n    }\n\n    /**\n     * Get normalized profile values with optional per-call overrides.\n     *\n     * @param {object} [options] Per-call values.\n     * @returns {object} Normalized read values.\n     */\n    GetValues(options = {})\n    {\n        return normalizeValues(this.#values, { inputType: \"fbx\", ...options }, FORMAT_NAME);\n    }\n\n    /**\n     * Set multiple output node constructors for this profile.\n     *\n     * These constructors are used only for explicit runtime output targets such\n     * as `emit: \"gr2\"` and `emit: \"cmf\"` paths. Debug `fbxJson` output\n     * remains plain data.\n     *\n     * @param {object} [classes] Map of output node class keys to constructors.\n     * @returns {CjsFbxFormat} This format profile.\n     */\n    SetClasses(classes = {})\n    {\n        return this.SetValues({ classes });\n    }\n\n    /**\n     * Set one output node constructor for this profile.\n     *\n     * @param {string} type Output node class key.\n     * @param {Function|null|undefined} Class Constructor to use, or nullish to delete.\n     * @returns {CjsFbxFormat} This format profile.\n     */\n    SetClass(type, Class)\n    {\n        validateClassKey(type, FORMAT_NAME);\n\n        if (Class === null || Class === undefined)\n        {\n            const classes = { ...this.#values.classes };\n            delete classes[type];\n            this.#values = { ...this.#values, classes };\n            return this;\n        }\n\n        validateClass(type, Class, FORMAT_NAME);\n        return this.SetValues({ classes: { [type]: Class } });\n    }\n\n    /**\n     * Get a configured output node constructor.\n     *\n     * @param {string} type Output node class key.\n     * @returns {Function|undefined} The registered constructor, if any.\n     */\n    GetClass(type)\n    {\n        validateClassKey(type, FORMAT_NAME);\n        return this.#values.classes[type];\n    }\n\n    /**\n     * Whether this profile has a constructor registered for an output node key.\n     *\n     * @param {string} type Output node class key.\n     * @returns {boolean} True when a constructor is registered.\n     */\n    HasClass(type)\n    {\n        return !!this.GetClass(type);\n    }\n\n    /**\n     * Read FBX bytes with this profile.\n     *\n     * @param {Uint8Array|ArrayBuffer|DataView} input FBX bytes.\n     * @param {object} [options] Per-call values.\n     * @returns {object} Raw or debug payload for the selected emit target.\n     */\n    Read(input, options = {})\n    {\n        return readWithValues(input, this.GetValues(options));\n    }\n\n    /** Write a native CMF graph as deterministic binary FBX 7400 bytes. */\n    Write(input, options = {})\n    {\n        return writeFbx(input, options);\n    }\n\n    /** Convert shared or GR2-shaped geometry through CMF and write FBX. */\n    WriteShared(input, options = {})\n    {\n        return writeSharedFbx(input, options);\n    }\n\n    /**\n     * Read FBX bytes asynchronously with this profile.\n     *\n     * @param {Uint8Array|ArrayBuffer|DataView} input FBX bytes.\n     * @param {object} [options] Per-call values.\n     * @returns {Promise<object>} Raw or debug payload for the selected emit target.\n     */\n    async ReadAsync(input, options = {})\n    {\n        return this.Read(input, options);\n    }\n\n    /**\n     * Inspect FBX bytes without converting geometry.\n     *\n     * @param {Uint8Array|ArrayBuffer|DataView} input FBX bytes.\n     * @param {object} [options] Per-call values.\n     * @returns {object} Lightweight FBX metadata.\n     */\n    Inspect(input, options = {})\n    {\n        return inspectWithValues(input, this.GetValues(options));\n    }\n\n    /**\n     * Convert format output into JSON-compatible debug data.\n     *\n     * @param {any} value Format output.\n     * @returns {any} JSON-compatible value.\n     */\n    ToJSON(value)\n    {\n        return toJsonValue(value);\n    }\n\n    /**\n     * One-shot FBX read.\n     *\n     * @param {Uint8Array|ArrayBuffer|DataView} input FBX bytes.\n     * @param {object} [options] Read options.\n     * @returns {object} Raw or debug payload for the selected emit target.\n     */\n    static read(input, options = {})\n    {\n        return readWithValues(input, normalizeValues(DEFAULT_VALUES, { inputType: \"fbx\", ...options }, FORMAT_NAME));\n    }\n\n    /** Write a native CMF graph as deterministic binary FBX 7400 bytes. */\n    static write(input, options = {})\n    {\n        return writeFbx(input, options);\n    }\n\n    /** Convert shared or GR2-shaped geometry through CMF and write FBX. */\n    static writeShared(input, options = {})\n    {\n        return writeSharedFbx(input, options);\n    }\n\n    /**\n     * One-shot asynchronous FBX read.\n     *\n     * @param {Uint8Array|ArrayBuffer|DataView} input FBX bytes.\n     * @param {object} [options] Read options.\n     * @returns {Promise<object>} Raw or debug payload for the selected emit target.\n     */\n    static async readAsync(input, options = {})\n    {\n        return CjsFbxFormat.read(input, options);\n    }\n\n    /**\n     * One-shot FBX inspection.\n     *\n     * @param {Uint8Array|ArrayBuffer|DataView} input FBX bytes.\n     * @param {object} [options] Inspect options.\n     * @returns {object} Lightweight FBX metadata.\n     */\n    static inspect(input, options = {})\n    {\n        return inspectWithValues(input, normalizeValues(DEFAULT_VALUES, { inputType: \"fbx\", ...options }, FORMAT_NAME));\n    }\n\n    /**\n     * One-shot FBX support probe.\n     *\n     * @param {Uint8Array|ArrayBuffer|DataView} input FBX bytes.\n     * @param {object} [options] Probe options.\n     * @returns {object} Support/probe report.\n     */\n    static probeSupport(input, options = {})\n    {\n        return probeSupportWithValues(input, normalizeValues(DEFAULT_VALUES, { inputType: \"fbx\", ...options }, FORMAT_NAME));\n    }\n\n    /**\n     * Convert format output into JSON-compatible debug data.\n     *\n     * @param {any} value Format output.\n     * @returns {any} JSON-compatible value.\n     */\n    static toJSON(value)\n    {\n        return toJsonValue(value);\n    }\n\n    /**\n     * Test whether bytes look like an FBX file.\n     *\n     * @param {Uint8Array|ArrayBuffer|DataView} input Candidate FBX bytes.\n     * @returns {boolean} True when the input appears to be FBX.\n     */\n    static isFBX(input)\n    {\n        try\n        {\n            return isFBX(asUint8Array(input, \"Fbx input\"));\n        }\n        catch\n        {\n            return false;\n        }\n    }\n\n    /**\n     * Emit targets for this format (canonical frozen enum).\n     */\n    static Output = Object.freeze({\n        CMF: OUTPUT_CMF,\n        GR2: OUTPUT_GR2,\n        RAW: OUTPUT_RAW,\n        JSON: OUTPUT_JSON,\n        FBX_JSON: OUTPUT_FBX_JSON\n    });\n    static CLASS_KEYS = CLASS_KEYS;\n    static id = \"fbx\";\n    static mediaTypes = Object.freeze([ \"geometry\" ]);\n    // FBX is written THROUGH CMF: `write` takes a native CMF graph and\n    // `writeShared` converts shared or GR2-shaped geometry into one first.\n    static inputs = CjsFormat.defineInputs({\n        cmf: { default: true, payloadType: \"geometry\" },\n        shared: { payloadType: \"geometry\" }\n    });\n\n    static outputs = CjsFormat.defineOutputs({\n        gr2: { decoded: true },\n        cmf: { decoded: true },\n        fbxJson: { role: \"debug\", decoded: true, probes: [ \"fbxJson\", \"document\" ] },\n        raw: { role: \"debug\", default: true, passthrough: true, probes: [ \"raw\", \"document\" ] }\n    });\n    static extensions = Object.freeze([ \".fbx\" ]);\n}\n\nexport default CjsFbxFormat;\n"],"names":["FORMAT_NAME","CjsFbxFormat","CjsFormat","DEFAULT_VALUES","constructor","options","SetValues","normalizeValues","inputType","GetValues","SetClasses","classes","SetClass","type","Class","validateClassKey","undefined","validateClass","GetClass","HasClass","Read","input","readWithValues","Write","writeFbx","WriteShared","writeSharedFbx","ReadAsync","Inspect","inspectWithValues","ToJSON","value","toJsonValue","read","write","writeShared","readAsync","inspect","probeSupport","probeSupportWithValues","toJSON","isFBX","asUint8Array","Output","Object","freeze","CMF","OUTPUT_CMF","GR2","OUTPUT_GR2","RAW","OUTPUT_RAW","JSON","OUTPUT_JSON","FBX_JSON","OUTPUT_FBX_JSON","CLASS_KEYS","id","mediaTypes","inputs","defineInputs","cmf","default","payloadType","shared","outputs","defineOutputs","gr2","decoded","fbxJson","role","probes","raw","passthrough","extensions"],"mappings":"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"}

package/dist/resource/formats/fbx/core/helpers.js

@@ -1,3 +1,4 @@
+import { adler32 } from '#utils/checksum';
 import { asUint8Array } from '#utils/bytes';
 import { generateNormals, generateTangents, generateBiNormals } from '#math/mesh';
 import { GR2_CLASS_KEYS, CMF_CLASS_KEYS } from '../../cmf/core/constants.js';
@@ -41,7 +42,6 @@ const DEFLATE_LENGTH_BASE = Object.freeze([3, 4, 5, 6, 7, 8, 9, 10, 11, 13, 15,
 const DEFLATE_LENGTH_EXTRA = Object.freeze([0, 0, 0, 0, 0, 0, 0, 0, 1, 1, 1, 1, 2, 2, 2, 2, 3, 3, 3, 3, 4, 4, 4, 4, 5, 5, 5, 5, 0]);
 const DEFLATE_DISTANCE_BASE = Object.freeze([1, 2, 3, 4, 5, 7, 9, 13, 17, 25, 33, 49, 65, 97, 129, 193, 257, 385, 513, 769, 1025, 1537, 2049, 3073, 4097, 6145, 8193, 12289, 16385, 24577]);
 const DEFLATE_DISTANCE_EXTRA = Object.freeze([0, 0, 0, 0, 1, 1, 2, 2, 3, 3, 4, 4, 5, 5, 6, 6, 7, 7, 8, 8, 9, 9, 10, 10, 11, 11, 12, 12, 13, 13]);
-const ADLER32_MOD = 65521;
 const TRIANGULATION_EPSILON = 1e-10;
 const IDENTITY_MATRIX4 = Object.freeze([1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1]);
 const DEFAULT_ROTATION_ORDER = "XYZ";
@@ -903,6 +903,23 @@ function readUncompressedArray(bytes, offset, type, length, byteLength) {
   }
   return value;
 }
+
+// THE ONE HAND-ROLLED INFLATE IN THIS PACKAGE, AND WHY IT STAYS. Everywhere else
+// that meets a deflate stream uses the shared `decompressBytes` over the
+// platform's `DecompressionStream` — `formats/vta` and `formats/png` both do.
+// FBX cannot: `DecompressionStream` is asynchronous by specification and there is
+// no synchronous platform inflate, while a compressed FBX array is decoded INLINE
+// during a synchronous recursive node walk (`readBinaryArrayProperty` at :1037,
+// which calls this at :1063). Making this await would make the whole node walk
+// async and take `CjsFbxFormat.read` — the synchronous entry point — with it.
+//
+// So this is a platform constraint, not an oversight, and not a preference for
+// hand-rolled code. If a SECOND synchronous inflate is ever needed, this moves to
+// a shared home rather than being copied; one caller is not yet a shared module.
+//
+// Carbon offers no donor either way: `mesh` vendors ufbx
+// (`mesh/vendor/github.com/ufbx`), so Carbon's FBX decompression lives inside
+// third-party C rather than in code there is anything to port.
 function inflateZlib(source, expectedLength) {
   if (source.byteLength < 6) {
     throw new Error("fbx: compressed array zlib stream is truncated");
@@ -1061,17 +1078,6 @@ function copyInflatedBytes(state, distance, length) {
     writeInflatedByte(state, state.output[state.offset - distance]);
   }
 }
-function adler32(bytes) {
-  let a = 1,
-    b = 0;
-  for (const byte of bytes) {
-    a += byte;
-    b += a;
-    a %= ADLER32_MOD;
-    b %= ADLER32_MOD;
-  }
-  return (b << 16 >>> 0 | a) >>> 0;
-}
 
 /**
  * Bit reader over a zlib/deflate stream used to inflate compressed FBX