@carbonenginejs/runtime-resource 0.12.2 → 0.14.0

package/dist/formats/hlsl/CjsHlslFormat.js.map

@@ -1 +1 @@
-{"version":3,"file":"CjsHlslFormat.js","sources":["../../../../src/formats/hlsl/CjsHlslFormat.js"],"sourcesContent":["/**\n * Exposed CarbonEngineJS-facing Tr2 effect container format class.\n *\n * Keep this file small and reviewable: the Tr2 effect graph parser lives\n * under src/core/tr2 (internal parsing machinery, not part of this\n * package's public surface); input/option normalization, the shared read\n * path, and the JSON emitters live under src/core.\n */\n\nimport { HlslEffectRes } from \"./core/tr2/resources/HlslEffectRes.js\";\nimport {\n    CLASS_KEYS,\n    DEFAULT_VALUES,\n    OUTPUT_JSON,\n    OUTPUT_METADATA,\n    OUTPUT_RAW,\n    inspectWithValues,\n    normalizeValues,\n    readWithValues,\n    toBytes,\n    toJsonValue,\n    validateClass,\n    validateClassKey\n} from \"./core/helpers.js\";\n\nconst FORMAT_NAME = \"CjsHlslFormat\";\n\n/**\n * CarbonEngineJS-facing reader for CCP's Tr2 compiled effect container\n * format (`.sm_hi` / `.sm_lo` / `.sm_depth` bodies).\n *\n * The Cjs prefix marks this as a JavaScript format/construction boundary.\n * This format profile has no dependency on any DXBC/shader-bytecode decoder: shader\n * bodies stay as opaque bytes in the emitted graph. The public contract is\n * plain JSON data (`emit: \"json\"`, the default) — the documented effect\n * graph shape described in `docs/reference/json-graph.md`. `emit: \"raw\"`\n * exposes the internal\n * HlslEffectRes graph directly; treat it as unstable, not schema-guaranteed\n * internals, useful mainly for resolving multiple permutations by hand.\n *\n * The `classes` option lets a caller register constructors for specific\n * node kinds in the emitted JSON graph (see `CjsHlslFormat.CLASS_KEYS`);\n * class registration does not depend on importing internal graph classes.\n */\nexport class CjsHlslFormat\n{\n\n    #emit = DEFAULT_VALUES.emit;\n    #source = DEFAULT_VALUES.source;\n    #permutation = DEFAULT_VALUES.permutation;\n    #classes = DEFAULT_VALUES.classes;\n\n    /**\n     * Create a reusable format profile.\n     *\n     * @param {object} [options] Default format values.\n     */\n    constructor(options = {})\n    {\n        this.SetValues(options);\n    }\n\n    /**\n     * Set format values for this reusable profile.\n     *\n     * @param {object} [options] Values to merge into the profile.\n     * @returns {CjsHlslFormat} This format profile.\n     */\n    SetValues(options = {})\n    {\n        const values = normalizeValues(this.GetValues(), options, FORMAT_NAME);\n\n        this.#emit = values.emit;\n        this.#source = values.source;\n        this.#permutation = values.permutation;\n        this.#classes = values.classes;\n\n        return this;\n    }\n\n    /**\n     * Get this profile's current values, optionally with per-call overrides.\n     *\n     * @param {object} [options] Optional values to merge into a copy.\n     * @returns {object} A copy of the effective values.\n     */\n    GetValues(options = {})\n    {\n        return normalizeValues({\n            emit: this.#emit,\n            source: this.#source,\n            permutation: this.#permutation,\n            classes: this.#classes\n        }, options, FORMAT_NAME);\n    }\n\n    /**\n     * Set multiple node-class constructors for this profile.\n     *\n     * @param {object} [classes] Map of node class keys to constructors. See {@link CjsHlslFormat.CLASS_KEYS}.\n     * @returns {CjsHlslFormat} This format profile.\n     */\n    SetClasses(classes = {})\n    {\n        return this.SetValues({ classes });\n    }\n\n    /**\n     * Set one node-class constructor for this profile.\n     *\n     * @param {string} type Node class key.\n     * @param {Function|null|undefined} Class Constructor to use, or nullish to delete.\n     * @returns {CjsHlslFormat} This format profile.\n     */\n    SetClass(type, Class)\n    {\n        if (Class === null || Class === undefined)\n        {\n            validateClassKey(type, FORMAT_NAME);\n            const classes = { ...this.#classes };\n            delete classes[type];\n            this.#classes = 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 node-class constructor.\n     *\n     * @param {string} type 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.#classes[type];\n    }\n\n    /**\n     * Whether this reader has a constructor registered for a node class key.\n     *\n     * @param {string} type 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 a Tr2 effect payload with this profile's values.\n     *\n     * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input Tr2 effect container bytes.\n     * @param {object} [options] Per-call value overrides.\n     * @returns {HlslEffectRes|object} The raw HlslEffectRes instance, compact metadata, or the documented JSON graph.\n     */\n    Read(input, options = {})\n    {\n        return readWithValues(input, this.GetValues(options));\n    }\n\n    /**\n     * Inspect a Tr2 effect payload: header facts plus the default (or\n     * selected) permutation's technique names and stage counts.\n     *\n     * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input Tr2 effect container bytes.\n     * @param {object} [options] Per-call value overrides.\n     * @returns {object} Plain summary data.\n     */\n    Inspect(input, options = {})\n    {\n        return inspectWithValues(input, this.GetValues(options));\n    }\n\n    /**\n     * Convert format output to JSON-compatible data.\n     *\n     * @param {any} value Format output to convert.\n     * @returns {any} Plain JSON-compatible data.\n     */\n    ToJSON(value)\n    {\n        return toJsonValue(value);\n    }\n\n    /**\n     * Static payload sniff. Static methods use camelCase by convention.\n     *\n     * The Tr2 effect container has no magic number, so this attempts a\n     * cheap header-only load (version, string table, permutation axes and\n     * body offsets — no shader bodies) and reports whether it succeeded.\n     *\n     * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input Candidate bytes.\n     * @returns {boolean} True when the payload's header decodes as a supported Tr2 effect.\n     */\n    static isSupported(input)\n    {\n        try\n        {\n            const bytes = toBytes(input);\n            return new HlslEffectRes().DoLoad(bytes, { source: \"isSupported\" });\n        }\n        catch\n        {\n            return false;\n        }\n    }\n\n    /**\n     * Static one-shot read.\n     *\n     * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input Tr2 effect container bytes.\n     * @param {object} [options] Format values.\n     * @returns {HlslEffectRes|object} The raw HlslEffectRes instance, compact metadata, or the documented JSON graph.\n     */\n    static read(input, options = {})\n    {\n        return readWithValues(input, normalizeValues(DEFAULT_VALUES, options, FORMAT_NAME));\n    }\n\n    /**\n     * Static one-shot inspection.\n     *\n     * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input Tr2 effect container bytes.\n     * @param {object} [options] Format values.\n     * @returns {object} Plain summary data.\n     */\n    static inspect(input, options = {})\n    {\n        return inspectWithValues(input, normalizeValues(DEFAULT_VALUES, options, FORMAT_NAME));\n    }\n\n    /**\n     * Static JSON-compatible conversion.\n     *\n     * @param {any} value Format output to convert.\n     * @returns {any} Plain JSON-compatible data.\n     */\n    static toJSON(value)\n    {\n        return toJsonValue(value);\n    }\n\n    /**\n     * Node-only convenience: reads a compiled Tr2 effect file from disk.\n     *\n     * @param {string} path Path to a compiled Carbon effect file (`.sm_hi` etc.).\n     * @param {object} [options] Format values.\n     * @returns {Promise<HlslEffectRes|object>} The raw HlslEffectRes instance, compact metadata, or the documented JSON graph.\n     */\n    static async readFile(path, options = {})\n    {\n        if (typeof path !== \"string\" || !path)\n        {\n            throw new TypeError(`${FORMAT_NAME}: readFile path must be a non-empty string`);\n        }\n\n        const { readFile } = await import(\"node:fs/promises\");\n        const input = await readFile(path);\n\n        return readWithValues(input, normalizeValues(DEFAULT_VALUES, { source: path, ...options }, FORMAT_NAME));\n    }\n\n    static OUTPUT_JSON = OUTPUT_JSON;\n    static OUTPUT_METADATA = OUTPUT_METADATA;\n    static OUTPUT_RAW = OUTPUT_RAW;\n    static CLASS_KEYS = CLASS_KEYS;\n    static type = Object.freeze([ \"shader\" ]);\n    static mediaTypes = Object.freeze([ \"shader\" ]);\n    static inputTypes = Object.freeze([ \"sm_hi\", \"sm_lo\", \"sm_depth\" ]);\n    static outputTypes = Object.freeze([ OUTPUT_JSON, OUTPUT_METADATA ]);\n    static debugOutputTypes = Object.freeze([ OUTPUT_RAW ]);\n\n}\n\nexport default CjsHlslFormat;\n"],"names":["FORMAT_NAME","CjsHlslFormat","DEFAULT_VALUES","emit","source","permutation","classes","constructor","options","SetValues","values","normalizeValues","GetValues","SetClasses","SetClass","type","Class","undefined","validateClassKey","validateClass","GetClass","HasClass","Read","input","readWithValues","Inspect","inspectWithValues","ToJSON","value","toJsonValue","isSupported","bytes","toBytes","HlslEffectRes","DoLoad","read","inspect","toJSON","readFile","path","TypeError","OUTPUT_JSON","OUTPUT_METADATA","OUTPUT_RAW","CLASS_KEYS","Object","freeze","mediaTypes","inputTypes","outputTypes","debugOutputTypes"],"mappings":";;;;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAkBA,MAAMA,WAAW,GAAG,eAAe;;AAEnC;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,MAAMC,aAAa,CAC1B;AAEI,EAAA,KAAK,GAAGC,cAAc,CAACC,IAAI;AAC3B,EAAA,OAAO,GAAGD,cAAc,CAACE,MAAM;AAC/B,EAAA,YAAY,GAAGF,cAAc,CAACG,WAAW;AACzC,EAAA,QAAQ,GAAGH,cAAc,CAACI,OAAO;;AAEjC;AACJ;AACA;AACA;AACA;AACIC,EAAAA,WAAWA,CAACC,OAAO,GAAG,EAAE,EACxB;AACI,IAAA,IAAI,CAACC,SAAS,CAACD,OAAO,CAAC;AAC3B,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;AACIC,EAAAA,SAASA,CAACD,OAAO,GAAG,EAAE,EACtB;AACI,IAAA,MAAME,MAAM,GAAGC,eAAe,CAAC,IAAI,CAACC,SAAS,EAAE,EAAEJ,OAAO,EAAER,WAAW,CAAC;AAEtE,IAAA,IAAI,CAAC,KAAK,GAAGU,MAAM,CAACP,IAAI;AACxB,IAAA,IAAI,CAAC,OAAO,GAAGO,MAAM,CAACN,MAAM;AAC5B,IAAA,IAAI,CAAC,YAAY,GAAGM,MAAM,CAACL,WAAW;AACtC,IAAA,IAAI,CAAC,QAAQ,GAAGK,MAAM,CAACJ,OAAO;AAE9B,IAAA,OAAO,IAAI;AACf,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;AACIM,EAAAA,SAASA,CAACJ,OAAO,GAAG,EAAE,EACtB;AACI,IAAA,OAAOG,eAAe,CAAC;AACnBR,MAAAA,IAAI,EAAE,IAAI,CAAC,KAAK;AAChBC,MAAAA,MAAM,EAAE,IAAI,CAAC,OAAO;AACpBC,MAAAA,WAAW,EAAE,IAAI,CAAC,YAAY;MAC9BC,OAAO,EAAE,IAAI,CAAC;AAClB,KAAC,EAAEE,OAAO,EAAER,WAAW,CAAC;AAC5B,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;AACIa,EAAAA,UAAUA,CAACP,OAAO,GAAG,EAAE,EACvB;IACI,OAAO,IAAI,CAACG,SAAS,CAAC;AAAEH,MAAAA;AAAQ,KAAC,CAAC;AACtC,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;AACA;AACIQ,EAAAA,QAAQA,CAACC,IAAI,EAAEC,KAAK,EACpB;AACI,IAAA,IAAIA,KAAK,KAAK,IAAI,IAAIA,KAAK,KAAKC,SAAS,EACzC;AACIC,MAAAA,gBAAgB,CAACH,IAAI,EAAEf,WAAW,CAAC;AACnC,MAAA,MAAMM,OAAO,GAAG;QAAE,GAAG,IAAI,CAAC;OAAU;MACpC,OAAOA,OAAO,CAACS,IAAI,CAAC;AACpB,MAAA,IAAI,CAAC,QAAQ,GAAGT,OAAO;AACvB,MAAA,OAAO,IAAI;AACf,IAAA;AAEAa,IAAAA,aAAa,CAACJ,IAAI,EAAEC,KAAK,EAAEhB,WAAW,CAAC;IACvC,OAAO,IAAI,CAACS,SAAS,CAAC;AAAEH,MAAAA,OAAO,EAAE;AAAE,QAAA,CAACS,IAAI,GAAGC;AAAM;AAAE,KAAC,CAAC;AACzD,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;EACII,QAAQA,CAACL,IAAI,EACb;AACIG,IAAAA,gBAAgB,CAACH,IAAI,EAAEf,WAAW,CAAC;AACnC,IAAA,OAAO,IAAI,CAAC,QAAQ,CAACe,IAAI,CAAC;AAC9B,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;EACIM,QAAQA,CAACN,IAAI,EACb;AACI,IAAA,OAAO,CAAC,CAAC,IAAI,CAACK,QAAQ,CAACL,IAAI,CAAC;AAChC,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;AACA;AACIO,EAAAA,IAAIA,CAACC,KAAK,EAAEf,OAAO,GAAG,EAAE,EACxB;IACI,OAAOgB,cAAc,CAACD,KAAK,EAAE,IAAI,CAACX,SAAS,CAACJ,OAAO,CAAC,CAAC;AACzD,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;AACA;AACA;AACIiB,EAAAA,OAAOA,CAACF,KAAK,EAAEf,OAAO,GAAG,EAAE,EAC3B;IACI,OAAOkB,iBAAiB,CAACH,KAAK,EAAE,IAAI,CAACX,SAAS,CAACJ,OAAO,CAAC,CAAC;AAC5D,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;EACImB,MAAMA,CAACC,KAAK,EACZ;IACI,OAAOC,WAAW,CAACD,KAAK,CAAC;AAC7B,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;EACI,OAAOE,WAAWA,CAACP,KAAK,EACxB;IACI,IACA;AACI,MAAA,MAAMQ,KAAK,GAAGC,OAAO,CAACT,KAAK,CAAC;MAC5B,OAAO,IAAIU,aAAa,EAAE,CAACC,MAAM,CAACH,KAAK,EAAE;AAAE3B,QAAAA,MAAM,EAAE;AAAc,OAAC,CAAC;AACvE,IAAA,CAAC,CACD,MACA;AACI,MAAA,OAAO,KAAK;AAChB,IAAA;AACJ,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;AACA;EACI,OAAO+B,IAAIA,CAACZ,KAAK,EAAEf,OAAO,GAAG,EAAE,EAC/B;AACI,IAAA,OAAOgB,cAAc,CAACD,KAAK,EAAEZ,eAAe,CAACT,cAAc,EAAEM,OAAO,EAAER,WAAW,CAAC,CAAC;AACvF,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;AACA;EACI,OAAOoC,OAAOA,CAACb,KAAK,EAAEf,OAAO,GAAG,EAAE,EAClC;AACI,IAAA,OAAOkB,iBAAiB,CAACH,KAAK,EAAEZ,eAAe,CAACT,cAAc,EAAEM,OAAO,EAAER,WAAW,CAAC,CAAC;AAC1F,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;EACI,OAAOqC,MAAMA,CAACT,KAAK,EACnB;IACI,OAAOC,WAAW,CAACD,KAAK,CAAC;AAC7B,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;AACA;EACI,aAAaU,QAAQA,CAACC,IAAI,EAAE/B,OAAO,GAAG,EAAE,EACxC;AACI,IAAA,IAAI,OAAO+B,IAAI,KAAK,QAAQ,IAAI,CAACA,IAAI,EACrC;AACI,MAAA,MAAM,IAAIC,SAAS,CAAC,CAAA,EAAGxC,WAAW,4CAA4C,CAAC;AACnF,IAAA;IAEA,MAAM;AAAEsC,MAAAA;AAAS,KAAC,GAAG,MAAM,OAAO,kBAAkB,CAAC;AACrD,IAAA,MAAMf,KAAK,GAAG,MAAMe,QAAQ,CAACC,IAAI,CAAC;AAElC,IAAA,OAAOf,cAAc,CAACD,KAAK,EAAEZ,eAAe,CAACT,cAAc,EAAE;AAAEE,MAAAA,MAAM,EAAEmC,IAAI;MAAE,GAAG/B;KAAS,EAAER,WAAW,CAAC,CAAC;AAC5G,EAAA;EAEA,OAAOyC,WAAW,GAAGA,WAAW;EAChC,OAAOC,eAAe,GAAGA,eAAe;EACxC,OAAOC,UAAU,GAAGA,UAAU;EAC9B,OAAOC,UAAU,GAAGA,UAAU;EAC9B,OAAO7B,IAAI,GAAG8B,MAAM,CAACC,MAAM,CAAC,CAAE,QAAQ,CAAE,CAAC;EACzC,OAAOC,UAAU,GAAGF,MAAM,CAACC,MAAM,CAAC,CAAE,QAAQ,CAAE,CAAC;AAC/C,EAAA,OAAOE,UAAU,GAAGH,MAAM,CAACC,MAAM,CAAC,CAAE,OAAO,EAAE,OAAO,EAAE,UAAU,CAAE,CAAC;EACnE,OAAOG,WAAW,GAAGJ,MAAM,CAACC,MAAM,CAAC,CAAEL,WAAW,EAAEC,eAAe,CAAE,CAAC;EACpE,OAAOQ,gBAAgB,GAAGL,MAAM,CAACC,MAAM,CAAC,CAAEH,UAAU,CAAE,CAAC;AAE3D;;;;"}
+{"version":3,"file":"CjsHlslFormat.js","sources":["../../../../src/formats/hlsl/CjsHlslFormat.js"],"sourcesContent":["/**\n * Exposed CarbonEngineJS-facing Tr2 effect container format class.\n *\n * Keep this file small and reviewable: the Tr2 effect graph parser lives\n * under src/core/tr2 (internal parsing machinery, not part of this\n * package's public surface); input/option normalization, the shared read\n * path, and the JSON emitters live under src/core.\n */\n\nimport { HlslEffectRes } from \"./core/tr2/resources/HlslEffectRes.js\";\nimport {\n    CLASS_KEYS,\n    DEFAULT_VALUES,\n    OUTPUT_JSON,\n    OUTPUT_METADATA,\n    OUTPUT_RAW,\n    inspectWithValues,\n    normalizeValues,\n    readWithValues,\n    toBytes,\n    toJsonValue,\n    validateClass,\n    validateClassKey\n} from \"./core/helpers.js\";\n\nconst FORMAT_NAME = \"CjsHlslFormat\";\n\n/**\n * CarbonEngineJS-facing reader for CCP's Tr2 compiled effect container\n * format (`.sm_hi` / `.sm_lo` / `.sm_depth` bodies).\n *\n * The Cjs prefix marks this as a JavaScript format/construction boundary.\n * This format profile has no dependency on any DXBC/shader-bytecode decoder: shader\n * bodies stay as opaque bytes in the emitted graph. The public contract is\n * plain JSON data (`emit: \"json\"`, the default) — the documented effect\n * graph shape described in `docs/reference/json-graph.md`. `emit: \"raw\"`\n * exposes the internal\n * HlslEffectRes graph directly; treat it as unstable, not schema-guaranteed\n * internals, useful mainly for resolving multiple permutations by hand.\n *\n * The `classes` option lets a caller register constructors for specific\n * node kinds in the emitted JSON graph (see `CjsHlslFormat.CLASS_KEYS`);\n * class registration does not depend on importing internal graph classes.\n */\nexport class CjsHlslFormat\n{\n\n    #emit = DEFAULT_VALUES.emit;\n    #source = DEFAULT_VALUES.source;\n    #permutation = DEFAULT_VALUES.permutation;\n    #classes = DEFAULT_VALUES.classes;\n\n    /**\n     * Create a reusable format profile.\n     *\n     * @param {object} [options] Default format values.\n     */\n    constructor(options = {})\n    {\n        this.SetValues(options);\n    }\n\n    /**\n     * Set format values for this reusable profile.\n     *\n     * @param {object} [options] Values to merge into the profile.\n     * @returns {CjsHlslFormat} This format profile.\n     */\n    SetValues(options = {})\n    {\n        const values = normalizeValues(this.GetValues(), options, FORMAT_NAME);\n\n        this.#emit = values.emit;\n        this.#source = values.source;\n        this.#permutation = values.permutation;\n        this.#classes = values.classes;\n\n        return this;\n    }\n\n    /**\n     * Get this profile's current values, optionally with per-call overrides.\n     *\n     * @param {object} [options] Optional values to merge into a copy.\n     * @returns {object} A copy of the effective values.\n     */\n    GetValues(options = {})\n    {\n        return normalizeValues({\n            emit: this.#emit,\n            source: this.#source,\n            permutation: this.#permutation,\n            classes: this.#classes\n        }, options, FORMAT_NAME);\n    }\n\n    /**\n     * Set multiple node-class constructors for this profile.\n     *\n     * @param {object} [classes] Map of node class keys to constructors. See {@link CjsHlslFormat.CLASS_KEYS}.\n     * @returns {CjsHlslFormat} This format profile.\n     */\n    SetClasses(classes = {})\n    {\n        return this.SetValues({ classes });\n    }\n\n    /**\n     * Set one node-class constructor for this profile.\n     *\n     * @param {string} type Node class key.\n     * @param {Function|null|undefined} Class Constructor to use, or nullish to delete.\n     * @returns {CjsHlslFormat} This format profile.\n     */\n    SetClass(type, Class)\n    {\n        if (Class === null || Class === undefined)\n        {\n            validateClassKey(type, FORMAT_NAME);\n            const classes = { ...this.#classes };\n            delete classes[type];\n            this.#classes = 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 node-class constructor.\n     *\n     * @param {string} type 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.#classes[type];\n    }\n\n    /**\n     * Whether this reader has a constructor registered for a node class key.\n     *\n     * @param {string} type 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 a Tr2 effect payload with this profile's values.\n     *\n     * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input Tr2 effect container bytes.\n     * @param {object} [options] Per-call value overrides.\n     * @returns {HlslEffectRes|object} The raw HlslEffectRes instance, compact metadata, or the documented JSON graph.\n     */\n    Read(input, options = {})\n    {\n        return readWithValues(input, this.GetValues(options));\n    }\n\n    /**\n     * Inspect a Tr2 effect payload: header facts plus the default (or\n     * selected) permutation's technique names and stage counts.\n     *\n     * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input Tr2 effect container bytes.\n     * @param {object} [options] Per-call value overrides.\n     * @returns {object} Plain summary data.\n     */\n    Inspect(input, options = {})\n    {\n        return inspectWithValues(input, this.GetValues(options));\n    }\n\n    /**\n     * Convert format output to JSON-compatible data.\n     *\n     * @param {any} value Format output to convert.\n     * @returns {any} Plain JSON-compatible data.\n     */\n    ToJSON(value)\n    {\n        return toJsonValue(value);\n    }\n\n    /**\n     * Static payload sniff. Static methods use camelCase by convention.\n     *\n     * The Tr2 effect container has no magic number, so this attempts a\n     * cheap header-only load (version, string table, permutation axes and\n     * body offsets — no shader bodies) and reports whether it succeeded.\n     *\n     * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input Candidate bytes.\n     * @returns {boolean} True when the payload's header decodes as a supported Tr2 effect.\n     */\n    static isSupported(input)\n    {\n        try\n        {\n            const bytes = toBytes(input);\n            return new HlslEffectRes().DoLoad(bytes, { source: \"isSupported\" });\n        }\n        catch\n        {\n            return false;\n        }\n    }\n\n    /**\n     * Static one-shot read.\n     *\n     * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input Tr2 effect container bytes.\n     * @param {object} [options] Format values.\n     * @returns {HlslEffectRes|object} The raw HlslEffectRes instance, compact metadata, or the documented JSON graph.\n     */\n    static read(input, options = {})\n    {\n        return readWithValues(input, normalizeValues(DEFAULT_VALUES, options, FORMAT_NAME));\n    }\n\n    /**\n     * Static one-shot inspection.\n     *\n     * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input Tr2 effect container bytes.\n     * @param {object} [options] Format values.\n     * @returns {object} Plain summary data.\n     */\n    static inspect(input, options = {})\n    {\n        return inspectWithValues(input, normalizeValues(DEFAULT_VALUES, options, FORMAT_NAME));\n    }\n\n    /**\n     * Static JSON-compatible conversion.\n     *\n     * @param {any} value Format output to convert.\n     * @returns {any} Plain JSON-compatible data.\n     */\n    static toJSON(value)\n    {\n        return toJsonValue(value);\n    }\n\n    static OUTPUT_JSON = OUTPUT_JSON;\n    static OUTPUT_METADATA = OUTPUT_METADATA;\n    static OUTPUT_RAW = OUTPUT_RAW;\n    static CLASS_KEYS = CLASS_KEYS;\n    static type = Object.freeze([ \"shader\" ]);\n    static mediaTypes = Object.freeze([ \"shader\" ]);\n    static inputTypes = Object.freeze([ \"sm_hi\", \"sm_lo\", \"sm_depth\" ]);\n    static outputTypes = Object.freeze([ OUTPUT_JSON, OUTPUT_METADATA ]);\n    static debugOutputTypes = Object.freeze([ OUTPUT_RAW ]);\n\n}\n\nexport default CjsHlslFormat;\n"],"names":["FORMAT_NAME","CjsHlslFormat","DEFAULT_VALUES","emit","source","permutation","classes","constructor","options","SetValues","values","normalizeValues","GetValues","SetClasses","SetClass","type","Class","undefined","validateClassKey","validateClass","GetClass","HasClass","Read","input","readWithValues","Inspect","inspectWithValues","ToJSON","value","toJsonValue","isSupported","bytes","toBytes","HlslEffectRes","DoLoad","read","inspect","toJSON","OUTPUT_JSON","OUTPUT_METADATA","OUTPUT_RAW","CLASS_KEYS","Object","freeze","mediaTypes","inputTypes","outputTypes","debugOutputTypes"],"mappings":"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"}

package/dist/formats/hlsl/core/carbonDescriptionToRuntime.js

@@ -1,11 +1,13 @@
 import { CjsFormatReadError } from '../../../format/CjsFormatError.js';
 import { HlslEffectConstant } from './tr2/shader/HlslEffectConstant.js';
+import { HlslEffectLibrary } from './tr2/shader/HlslEffectLibrary.js';
 import { HlslEffectParameterAnnotation } from './tr2/shader/HlslEffectParameterAnnotation.js';
 import { HlslEffectResource } from './tr2/shader/HlslEffectResource.js';
 import { HlslEffectStageInput } from './tr2/shader/HlslEffectStageInput.js';
 import { HlslEffectStateManager } from './HlslEffectStateManager.js';
 import { HlslEffectTechnique } from './tr2/shader/HlslEffectTechnique.js';
 import { HlslPass } from './tr2/shader/HlslPass.js';
+import { HlslShaderBytecode } from './HlslShaderBytecode.js';
 import { HlslRenderContextEnum, HlslUsageCodeNames } from './tr2/HlslRenderContextEnum.js';
 import { HlslRenderStateSetup } from './HlslRenderStateSetup.js';
 import { HlslResourceSetDescription } from './HlslResourceSetDescription.js';
@@ -343,9 +345,8 @@ const REGISTER_RULES = Object.freeze({
  * Pipeline input rules.
  *
  * `usageName` is derived from the `usage` byte rather than carried: it is a
- * display name looked up from a table (`HlslEffectDescription.js:592`), exactly
- * as Carbon derives it through `GetStringForUsageCode` (`EffectData.h:86`).
- * Nothing goes on the wire for it.
+ * display name looked up from a table, exactly as Carbon derives it through
+ * `GetStringForUsageCode` (`EffectData.h:86`). Nothing goes on the wire for it.
  */
 const PIPELINE_INPUT_RULES = Object.freeze({
   usage: (target, value) => {
@@ -382,8 +383,8 @@ const ANNOTATION_RULES = Object.freeze({
   },
   // A non-string annotation value is four raw bytes: Carbon writes it through a
   // float union and reads it through a different one, so the bytes are the only
-  // faithful form. The three typed views are derived from them exactly as the
-  // source reader derives them (`HlslEffectDescription.js:480-483`).
+  // faithful form. The three typed views are derived from those bytes, one per
+  // union member Carbon reads back through.
   rawValue: (target, value, record) => {
     if (record.type === ANNOTATION_TYPE_STRING) return;
     const bits = rawUint32(value);
@@ -409,7 +410,7 @@ function mapTextureRecord(record) {
  *
  * A UAV record is one byte shorter than a texture record: it carries no
  * `isSRGB`. Carbon's reader hardcodes it false (`Tr2EffectDescription.cpp:450`),
- * and so does ours (`HlslEffectDescription.js:434`), so the runtime object's
+ * so the runtime object's
  * constructor default is restored explicitly rather than left to chance —
  * `metadata.toJSON()` emits the key for a UAV even though the wire never carries
  * it, because both kinds share `HlslEffectResource`.
@@ -429,9 +430,11 @@ function mapUavRecord(record) {
  * Two conversions beyond the flat-to-nested reshape:
  *
  * - Carbon nulls a sampler's name when it is not dynamic
- *   (`Tr2EffectDescription.cpp:430-433`, mirrored at
- *   `HlslEffectDescription.js:414-417`), so the wire's empty string must become
- *   `null` again. Like `isSRGB`, this is *accidentally correct* if left alone —
+ *   (`Tr2EffectDescription.cpp:430-433`), so the wire's empty string must become
+ *   `null` again. A pre-v13 record carries no `isDynamic` at all; the class
+ *   default (dynamic) then keeps the name, matching the legacy reader, which
+ *   never assigned the flag for those versions. Like `isSRGB`, the nulling is
+ *   *accidentally correct* if left alone —
  *   `""` and `null` are both falsy, so `metadataName` and the heap-view lookup
  *   behave identically — and only a structural diff catches it.
  * - `comparison` and `isDynamic` are `u8` on the wire and boolean at runtime.
@@ -450,9 +453,8 @@ function mapSamplerRecord(record) {
 /**
  * Maps one static sampler record onto its runtime signature entry.
  *
- * The runtime shape keeps the `*Raw` companions non-enumerable, matching
- * `readStaticSampler`, so a `cloneJson` of the descriptor sees the value form
- * only.
+ * The runtime shape keeps the `*Raw` companions non-enumerable, so a
+ * `cloneJson` of the descriptor sees the value form only.
  *
  * @param {object} record Wire static sampler record.
  * @returns {object} Runtime static sampler entry.
@@ -520,7 +522,7 @@ function mapAnnotationRecord(record) {
  *
  * Reproduced rather than stored: it is a function of the register type, the
  * stage type and the caller's per-frame start registers, none of which the
- * container needs to carry (`HlslEffectDescription.js:750-765`).
+ * container needs to carry.
  *
  * @param {object} register Runtime register declaration.
  * @param {number} stageType Stage enum value.
@@ -552,12 +554,13 @@ function applyStageData(input, data, stageType, context) {
   input.constants = (data.constants ?? []).map(mapConstantRecord);
 
   // The declared size is the unclamped one; the runtime clamps it to
-  // SHADER_CONSTANTS_MAX and slices the payload to match
-  // (`HlslEffectDescription.js:381-385`). `packMaterial` allocates an
+  // SHADER_CONSTANTS_MAX and slices the payload to match, as Carbon does
+  // (`Tr2EffectDescription.h:160`). `packMaterial` allocates an
   // ArrayBuffer of exactly this size, so restoring the unclamped value would
   // write past the layout the shader expects — on any effect above 4096 bytes
   // of constants, which is precisely the size a small fixture never reaches.
   const declaredSize = data.defaultValues?.size ?? 0;
+  input.sourceConstantValueSize = declaredSize;
   input.sourceConstantValues = Uint8Array.from(data.defaultValues?.bytes ?? new Uint8Array(0));
   input.m_constantValueSize = Math.min(declaredSize, HlslEffectStageInput.SHADER_CONSTANTS_MAX);
   input.constantValues = input.sourceConstantValues.slice(0, input.m_constantValueSize);
@@ -574,11 +577,10 @@ function applyStageData(input, data, stageType, context) {
 /**
  * Grows the constant block to cover a sampler heap-index constant.
  *
- * Reproduces `HlslEffectDescription.js:773-791`, which the source reader applies
- * to every constant once samplers are known: a `UINT`/dimension-1 constant whose
- * name matches a sampler is a heap index, and the declared constant-value size
- * can be smaller than the offset it sits at. The reader extends the block rather
- * than reading out of bounds.
+ * Applied to every constant once samplers are known, as Carbon's reader does:
+ * a `UINT`/dimension-1 constant whose name matches a sampler is a heap index,
+ * and the declared constant-value size can be smaller than the offset it sits
+ * at. The block is extended rather than read out of bounds.
  *
  * **This is derived, not stored, and missing it is not cosmetic.** `packMaterial`
  * allocates `new ArrayBuffer(constantValueSize)`, so an unpatched size
@@ -673,12 +675,77 @@ function buildPass(record, context) {
   return pass;
 }
 
+/** Names an export slot per Carbon's raytracing export type codes. */
+const LIBRARY_EXPORT_NAME_FIELDS = Object.freeze(["rayGenName", "missName", "closestHitName", "anyHitName", "intersectionName"]);
+
+/** Library record rules; the nested pieces are handled by `buildLibrary`. */
+const LIBRARY_RULES = Object.freeze({
+  payloadSize: (target, value) => {
+    target.payloadSize = value;
+  },
+  hitGroupName: (target, value) => {
+    target.hitGroupName = text(value);
+  },
+  // Consumed by buildLibrary: the blob becomes the registered bytecode.
+  shaderData: consumed,
+  // Consumed by buildLibrary: exports carry per-type name routing.
+  exports: consumed,
+  globalInputs: consumed,
+  localInputs: consumed
+});
+
+/**
+ * Rebuilds one runtime shader library from a wire library record.
+ *
+ * The two stage-data blocks reuse `applyStageData`, so a library's constants,
+ * defaults, resources, samplers and UAVs go through exactly the rules a pass
+ * stage goes through. The library bytecode is registered the way the runtime
+ * registers it: a compute-typed `HlslShaderBytecode` under the state manager's
+ * library registry, whose handles are a separate monotonic counter — adding
+ * libraries does not shift any shader or program handle.
+ *
+ * @param {object} record Wire library record.
+ * @param {object} context Adapter context.
+ * @returns {HlslEffectLibrary} Runtime library.
+ */
+function buildLibrary(record, context) {
+  const library = mapClosed(record, LIBRARY_RULES, new HlslEffectLibrary(), "library");
+  const shaderType = HlslRenderContextEnum.COMPUTE_SHADER;
+  library.cjsShaderBytecode = new HlslShaderBytecode({
+    stageType: shaderType,
+    stageName: "library",
+    bytes: record.shaderData?.bytes ?? new Uint8Array(0),
+    shaderSize: record.shaderData?.size ?? 0,
+    stringTableOffset: record.shaderData?.offset ?? null
+  });
+  library.libraryHandle = context.effectStateManager.RegisterShaderLibrary(library.cjsShaderBytecode);
+  for (const entry of record.exports ?? []) {
+    const name = text(entry.name);
+    library.exports.push({
+      type: entry.type,
+      name
+    });
+    const field = LIBRARY_EXPORT_NAME_FIELDS[entry.type];
+    if (field) library[field] = name;
+  }
+  applyStageData(library.globalInput, record.globalInputs ?? {}, shaderType, context);
+  library.globalResourceSetDesc = new HlslResourceSetDescription([shaderType], [library.globalInput.signature]);
+  for (const [registerIndex, sampler] of library.globalInput.samplers.entries()) {
+    library.globalResourceSetDesc.SetSampler(shaderType, registerIndex, sampler.sampler);
+  }
+  applyStageData(library.localInput, record.localInputs ?? {}, shaderType, context);
+  return library;
+}
+
 /**
  * Applies the `IsHeapView` annotations to the rebuilt resource-set descriptions.
  *
- * Derived exactly as the source reader derives it
- * (`HlslEffectDescription.js:799-851`), over the annotations the container
- * carries.
+ * Derived rather than carried, over the annotations the container holds,
+ * exactly as Carbon derives it after reading
+ * (`Tr2EffectDescription.cpp:474-530`): a parameter whose top-level
+ * annotations contain a true BOOL `IsHeapView` marks its register as a heap
+ * view in the owning resource-set description, for library global inputs as
+ * well as pass stages.
  *
  * @param {object} effectDescription Rebuilt effect description.
  */
@@ -689,6 +756,18 @@ function applyHeapViewAnnotations(effectDescription) {
     return annotations.some(annotation => annotation.name === "IsHeapView" && annotation.type === HlslEffectParameterAnnotation.Type.BOOL && annotation.boolValue);
   };
   for (const technique of effectDescription.techniques) {
+    for (const library of technique.libraries ?? []) {
+      const shaderType = HlslRenderContextEnum.COMPUTE_SHADER;
+      for (const [registerIndex, resource] of library.globalInput.resources.entries()) {
+        if (isHeapView(resource.name)) library.globalResourceSetDesc?.SetSrvHeapView(shaderType, registerIndex);
+      }
+      for (const [registerIndex, resource] of library.globalInput.uavs.entries()) {
+        if (isHeapView(resource.name)) library.globalResourceSetDesc?.SetUavHeapView(shaderType, registerIndex);
+      }
+      for (const [registerIndex, sampler] of library.globalInput.samplers.entries()) {
+        if (isHeapView(sampler.name)) library.globalResourceSetDesc?.SetSamplerHeapView(shaderType, registerIndex);
+      }
+    }
     for (const pass of technique.passes) {
       for (let stageType = 0; stageType < pass.stageInputs.length; stageType += 1) {
         const stage = pass.stageInputs[stageType];
@@ -741,37 +820,27 @@ function runtimeDescriptionFromCarbon(description, options = {}) {
   for (const record of description.techniques) {
     const technique = new HlslEffectTechnique();
     technique.name = text(record.name);
-    // Raytracing libraries are carried on the wire and are deliberately NOT
-    // rebuilt here. `libraries` stays empty.
-    //
-    // This began as a throw, on the reasoning that a silent drop hides a
-    // whole missing section and that no shipped effect declared one. The
-    // first half still stands; the second half was wrong, and the way it was
-    // wrong is the useful part. The dx11 corpus has no libraries at all —
-    // 1611 files, zero — so the refusal never fired. **Every dx12 body of
-    // `unpacked_quadv5.sm_hi` carries one**: technique `RtShadow`, a
-    // `ClosestHit` export, DXR raytracing shadows that dx11 has no analogue
-    // for. All 288 distinct bodies. So the refusal blocked every dx12
-    // package for a section nothing downstream reads.
-    //
-    // Dropping them is safe for a *specific, checked* reason rather than a
-    // hopeful one: `buildEffectAnalysis` reaches libraries through no path.
-    // `buildPasses` walks `technique.passes`; `buildStages` walks
-    // `pass.stageInputs`; neither touches `technique.libraries`. The source
-    // reader's heap-view pass does visit libraries, but only to populate
-    // `library.globalResourceSetDesc`, which the manifest never reads.
-    //
-    // That claim is measured, not argued: the corpus analysis diff compares
-    // source-derived against container-derived analysis over dx12 as well as
-    // dx11, so every one of those library-bearing bodies is proof that the
-    // drop is invisible to this view. If the analysis ever grows a library
-    // section, that test goes red rather than this comment going stale.
     technique.passes = (record.passes ?? []).map(pass => buildPass(pass, context));
     for (const pass of technique.passes) technique.shaderTypeMask |= pass.shaderTypeMask;
+    // Raytracing libraries were once deliberately dropped here, when this
+    // adapter served only `buildEffectAnalysis` — which reaches libraries
+    // through no path, a claim the dx12 corpus diff measured (every body
+    // of `unpacked_quadv5.sm_hi` carries an `RtShadow` library, and the
+    // diff stayed green). Since the runtime read path converged on this
+    // adapter, that scope no longer holds: `metadata.js` and `json.js`
+    // emit `technique.libraries`, and the effect-resource contract
+    // requires every library's exports, inputs and payload preserved.
+    technique.libraries = (record.libraries ?? []).map(library => buildLibrary(library, context));
     effectDescription.techniques.push(technique);
   }
   for (const group of description.annotations ?? []) {
-    effectDescription.annotations.set(text(group.name), (group.annotations ?? []).map(mapAnnotationRecord));
+    const name = text(group.name);
+    if (effectDescription.annotations.has(name)) {
+      throw new CjsFormatReadError(`Duplicate effect parameter annotation group ${name}`, {
+        name
+      });
+    }
+    effectDescription.annotations.set(name, (group.annotations ?? []).map(mapAnnotationRecord));
   }
   applyHeapViewAnnotations(effectDescription);
   return effectDescription;