@carbonenginejs/runtime-resource 0.18.0 → 0.19.0

package/dist/format/carbonEffect/carbonEffectResourceTransform.js.map

@@ -1 +1 @@
-{"version":3,"file":"carbonEffectResourceTransform.js","sources":["../../../../src/format/carbonEffect/carbonEffectResourceTransform.js"],"sourcesContent":["import { CjsFormatWriteError, CjsFormatReadError } from \"../CjsFormatError.js\";\n\n/**\n * The resource-transform section, shared by every backend's per-pass block.\n *\n * A resource transform is a recipe for building one backend resource out of\n * several Carbon ones. It is deliberately backend-neutral: `detail-map-array`\n * merges `Detail1Map`, `Detail2Map` and `Detail3Map` into one array texture, and\n * that decision is about the *resources*, not about WGSL or GLSL. Both backends\n * want the identical merge, for different reasons - WebGPU to reduce binding\n * churn, WebGL 2 because the family otherwise needs 17 texture units against a\n * limit of 16.\n *\n * So the section lives here rather than in either backend's block codec, and the\n * two codecs compose it. A transform written by one backend decodes identically\n * under the other.\n */\n\n/**\n * Resource-transform families. The discriminator exists so `kind`,\n * `representation`, `missingLayer` and the output name stay derivable without\n * pinning the format to one recognizer: a second family costs an enum value\n * rather than a format version bump.\n */\nexport const CARBON_BACKEND_TRANSFORM_FAMILY = Object.freeze([\n    \"detail-map-array\",\n    \"local-light-profile-neutral\"\n]);\n\n/** Constants a `detail-map-array` transform restores rather than storing. */\nexport const DETAIL_MAP_ARRAY_DEFAULTS = Object.freeze({\n    version: 1,\n    kind: \"texture-2d-array\",\n    stage: \"fragment\",\n    representation: \"native-or-rgba8\",\n    missingLayer: \"reject\",\n    viewDimension: \"2d-array\",\n    outputName: \"DetailArrayMap\"\n});\n\n/**\n * Constants a `local-light-profile-neutral` transform restores rather than\n * storing.\n *\n * Unlike `detail-map-array` this transform has no output resource: its whole\n * content is that an input resource was replaced by a constant. It exists so a\n * described Carbon resource that the backend deliberately dropped is still\n * accounted for - a resource that simply disappears is indistinguishable from\n * one that was lost, and the integrity rules reject that on purpose.\n *\n * `LightProfileArray` is multiplied into a light's attenuation, so the constant\n * is one, not zero. That is the same value the shader's own no-profile path\n * produces, which is why dropping it is neutral rather than dark.\n */\nexport const LOCAL_LIGHT_PROFILE_NEUTRAL_DEFAULTS = Object.freeze({\n    version: 1,\n    kind: \"constant\",\n    stage: \"fragment\",\n    representation: \"constant-one\",\n    missingLayer: \"ignore\",\n    viewDimension: null,\n    outputName: null\n});\n\n/**\n * Per-family constant sets, keyed by family name.\n *\n * The reader restores these rather than storing them, so a family that omitted\n * its entry here would silently inherit another family's constants.\n */\nconst TRANSFORM_DEFAULTS_BY_FAMILY = Object.freeze({\n    \"detail-map-array\": DETAIL_MAP_ARRAY_DEFAULTS,\n    \"local-light-profile-neutral\": LOCAL_LIGHT_PROFILE_NEUTRAL_DEFAULTS\n});\n\n/**\n * Writes a length-prefixed UTF-8 string.\n *\n * @param {object} writer Target byte writer.\n * @param {string} value Text value.\n */\nexport function writeInlineString(writer, value)\n{\n    const bytes = new TextEncoder().encode(String(value ?? \"\"));\n    if (bytes.length > 0xffff)\n    {\n        throw new CjsFormatWriteError(\"Backend block string exceeds 65535 bytes\", {\n            byteLength: bytes.length\n        });\n    }\n    writer.u16(bytes.length);\n    writer.bytes(bytes);\n}\n\n/**\n * Reads a length-prefixed UTF-8 string.\n *\n * @param {object} reader Source byte reader.\n * @returns {string} Decoded text.\n */\nexport function readInlineString(reader)\n{\n    const length = reader.readUint16();\n    return new TextDecoder(\"utf-8\", { fatal: false }).decode(reader.readRaw(length));\n}\n\n/**\n * Writes the count-prefixed resource-transform section.\n *\n * @param {object} writer Target byte writer.\n * @param {object[]} transforms Resource transforms.\n */\nexport function writeTransformSection(writer, transforms)\n{\n    writer.u8(transforms.length);\n\n    for (const transform of transforms)\n    {\n        const family = CARBON_BACKEND_TRANSFORM_FAMILY.indexOf(transform.family ?? \"detail-map-array\");\n        if (family < 0)\n        {\n            throw new CjsFormatWriteError(`Unknown transform family \"${transform.family}\"`, {\n                family: transform.family\n            });\n        }\n        writer.u8(family);\n        // `id` stays on the wire: a caller may supply it, and it propagates into\n        // the engine binding as `transformId`. Deriving it would foreclose the\n        // caller-supplied plan path to save four bytes.\n        writeInlineString(writer, transform.id);\n        writer.u8(transform.inputs.length);\n        for (const input of transform.inputs)\n        {\n            // Array position is the layer. Safe because `parameter` stays on the\n            // wire, so layer identity remains cross-checkable rather than\n            // asserted by position.\n            writer.u8(input.registerSpace);\n            writer.u8(input.registerIndex);\n            writeInlineString(writer, input.parameter);\n        }\n    }\n}\n\n/**\n * Reads the count-prefixed resource-transform section, restoring derived fields.\n *\n * @param {object} reader Source byte reader.\n * @param {string|null} layoutKey Enclosing pass key, restored onto records.\n * @returns {object[]} Resource transforms.\n */\nexport function readTransformSection(reader, layoutKey)\n{\n    const transforms = [];\n    const transformCount = reader.readUint8();\n\n    for (let index = 0; index < transformCount; index += 1)\n    {\n        const family = CARBON_BACKEND_TRANSFORM_FAMILY[reader.readUint8()];\n        const defaults = TRANSFORM_DEFAULTS_BY_FAMILY[family];\n        if (!defaults)\n        {\n            throw new CjsFormatReadError(`Transform family \"${family}\" has no restored constants`, {\n                family\n            });\n        }\n        const id = readInlineString(reader);\n        const inputs = [];\n        const inputCount = reader.readUint8();\n        for (let layer = 0; layer < inputCount; layer += 1)\n        {\n            const registerSpace = reader.readUint8();\n            const registerIndex = reader.readUint8();\n            const parameter = readInlineString(reader);\n            const identity = `sampled-resource:${registerSpace}:${registerIndex}`;\n            inputs.push({\n                parameter,\n                layer,\n                // Kept alongside the identity they compose: a consumer checking\n                // the transform against a binding set compares registers, and\n                // re-parsing them back out of the identity string is a second\n                // place for the format of that string to matter.\n                registerSpace,\n                registerIndex,\n                identity,\n                scopeIdentity: `${identity}@${defaults.stage}`\n            });\n        }\n\n        transforms.push({\n            id,\n            family,\n            version: defaults.version,\n            kind: defaults.kind,\n            stage: defaults.stage,\n            representation: defaults.representation,\n            missingLayer: defaults.missingLayer,\n            layoutKey,\n            inputs,\n            output: {\n                name: defaults.outputName,\n                viewDimension: defaults.viewDimension,\n                layerCount: inputs.length,\n                identity: inputs[0]?.identity ?? null,\n                scopeIdentity: inputs[0]?.scopeIdentity ?? null\n            }\n        });\n    }\n\n    return transforms;\n}\n"],"names":["CARBON_BACKEND_TRANSFORM_FAMILY","Object","freeze","DETAIL_MAP_ARRAY_DEFAULTS","version","kind","stage","representation","missingLayer","viewDimension","outputName","LOCAL_LIGHT_PROFILE_NEUTRAL_DEFAULTS","TRANSFORM_DEFAULTS_BY_FAMILY","writeInlineString","writer","value","bytes","TextEncoder","encode","String","length","CjsFormatWriteError","byteLength","u16","readInlineString","reader","readUint16","TextDecoder","fatal","decode","readRaw","writeTransformSection","transforms","u8","transform","family","indexOf","id","inputs","input","registerSpace","registerIndex","parameter","readTransformSection","layoutKey","transformCount","readUint8","index","defaults","CjsFormatReadError","inputCount","layer","identity","push","scopeIdentity","output","name","layerCount"],"mappings":"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"}
+{"version":3,"file":"carbonEffectResourceTransform.js","sources":["../../../../src/format/carbonEffect/carbonEffectResourceTransform.js"],"sourcesContent":["import { CjsFormatWriteError, CjsFormatReadError } from \"../CjsFormatError.js\";\r\nimport { DETAIL_MAP_ARRAY_NAME } from \"../../formats/hlsl/core/detailMapFamily.js\";\r\n\r\n/**\r\n * The resource-transform section, shared by every backend's per-pass block.\r\n *\r\n * A resource transform is a recipe for building one backend resource out of\r\n * several Carbon ones. It is deliberately backend-neutral: `detail-map-array`\r\n * merges `Detail1Map`, `Detail2Map` and `Detail3Map` into one array texture, and\r\n * that decision is about the *resources*, not about WGSL or GLSL. Both backends\r\n * want the identical merge, for different reasons - WebGPU to reduce binding\r\n * churn, WebGL 2 because the family otherwise needs 17 texture units against a\r\n * limit of 16.\r\n *\r\n * So the section lives here rather than in either backend's block codec, and the\r\n * two codecs compose it. A transform written by one backend decodes identically\r\n * under the other.\r\n */\r\n\r\n/**\r\n * Resource-transform families. The discriminator exists so `kind`,\r\n * `representation`, `missingLayer` and the output name stay derivable without\r\n * pinning the format to one recognizer: a second family costs an enum value\r\n * rather than a format version bump.\r\n */\r\nexport const CARBON_BACKEND_TRANSFORM_FAMILY = Object.freeze([\r\n    \"detail-map-array\",\r\n    \"local-light-profile-neutral\"\r\n]);\r\n\r\n/** Constants a `detail-map-array` transform restores rather than storing. */\r\nexport const DETAIL_MAP_ARRAY_DEFAULTS = Object.freeze({\r\n    version: 1,\r\n    kind: \"texture-2d-array\",\r\n    stage: \"fragment\",\r\n    representation: \"native-or-rgba8\",\r\n    missingLayer: \"reject\",\r\n    viewDimension: \"2d-array\",\r\n    // The merged array's name is owned by the detail-map family, not restated\r\n    // here. It has been renamed once already (DetailMapArray -> DetailArrayMap),\r\n    // and a second literal is a second place for the next rename to miss.\r\n    outputName: DETAIL_MAP_ARRAY_NAME\r\n});\r\n\r\n/**\r\n * Constants a `local-light-profile-neutral` transform restores rather than\r\n * storing.\r\n *\r\n * Unlike `detail-map-array` this transform has no output resource: its whole\r\n * content is that an input resource was replaced by a constant. It exists so a\r\n * described Carbon resource that the backend deliberately dropped is still\r\n * accounted for - a resource that simply disappears is indistinguishable from\r\n * one that was lost, and the integrity rules reject that on purpose.\r\n *\r\n * `LightProfileArray` is multiplied into a light's attenuation, so the constant\r\n * is one, not zero. That is the same value the shader's own no-profile path\r\n * produces, which is why dropping it is neutral rather than dark.\r\n */\r\nexport const LOCAL_LIGHT_PROFILE_NEUTRAL_DEFAULTS = Object.freeze({\r\n    version: 1,\r\n    kind: \"constant\",\r\n    stage: \"fragment\",\r\n    representation: \"constant-one\",\r\n    missingLayer: \"ignore\",\r\n    viewDimension: null,\r\n    outputName: null\r\n});\r\n\r\n/**\r\n * Per-family constant sets, keyed by family name.\r\n *\r\n * The reader restores these rather than storing them, so a family that omitted\r\n * its entry here would silently inherit another family's constants.\r\n */\r\nconst TRANSFORM_DEFAULTS_BY_FAMILY = Object.freeze({\r\n    \"detail-map-array\": DETAIL_MAP_ARRAY_DEFAULTS,\r\n    \"local-light-profile-neutral\": LOCAL_LIGHT_PROFILE_NEUTRAL_DEFAULTS\r\n});\r\n\r\n/**\r\n * Refuses a transform whose restored fields disagree with its family.\r\n *\r\n * Every field below is dropped on write and rebuilt from the family constants\r\n * on read, so a document that disagrees does not fail - it round-trips into a\r\n * *different* document, which is the failure shape that produced both the\r\n * `selectedOptions` and the register-pair bugs. A caller may supply its own\r\n * transform plan, so agreement is checked here rather than assumed from the\r\n * one producer that happens to emit constants.\r\n *\r\n * An absent field is not a disagreement: omitting it is the normal way to say\r\n * \"restore the family value\".\r\n *\r\n * @param {object} transform Resource transform.\r\n * @param {string} family Resolved family name.\r\n * @param {object} defaults Family constants the reader restores.\r\n */\r\nfunction assertRestoredFieldsAgree(transform, family, defaults)\r\n{\r\n    const restored = [\r\n        [ \"version\", transform.version, defaults.version ],\r\n        [ \"kind\", transform.kind, defaults.kind ],\r\n        [ \"stage\", transform.stage, defaults.stage ],\r\n        [ \"representation\", transform.representation, defaults.representation ],\r\n        [ \"missingLayer\", transform.missingLayer, defaults.missingLayer ],\r\n        [ \"output.name\", transform.output?.name, defaults.outputName ],\r\n        [ \"output.viewDimension\", transform.output?.viewDimension, defaults.viewDimension ]\r\n    ];\r\n\r\n    for (const [ field, actual, expected ] of restored)\r\n    {\r\n        if (actual === undefined || actual === null) continue;\r\n        if (actual === expected) continue;\r\n\r\n        throw new CjsFormatWriteError(\r\n            `Resource transform \"${transform.id}\" sets ${field} to ${JSON.stringify(actual)}, but the`\r\n            + ` \"${family}\" family restores ${JSON.stringify(expected)} on read. The value is not`\r\n            + ` stored, so writing this would silently change the document.`,\r\n            { transform: transform.id, family, field, actual, expected }\r\n        );\r\n    }\r\n\r\n    // Layer count is positional on the wire: the reader counts the inputs it\r\n    // read. A document claiming a different count is claiming something the\r\n    // bytes cannot carry.\r\n    const layerCount = transform.output?.layerCount;\r\n\r\n    if (layerCount !== undefined && layerCount !== null && layerCount !== transform.inputs.length)\r\n    {\r\n        throw new CjsFormatWriteError(\r\n            `Resource transform \"${transform.id}\" declares ${layerCount} output layers but carries`\r\n            + ` ${transform.inputs.length} inputs; the reader derives the count from the inputs.`,\r\n            { transform: transform.id, family, declared: layerCount, inputs: transform.inputs.length }\r\n        );\r\n    }\r\n}\r\n\r\n/**\r\n * Writes a length-prefixed UTF-8 string.\r\n *\r\n * @param {object} writer Target byte writer.\r\n * @param {string} value Text value.\r\n */\r\nexport function writeInlineString(writer, value)\r\n{\r\n    const bytes = new TextEncoder().encode(String(value ?? \"\"));\r\n    if (bytes.length > 0xffff)\r\n    {\r\n        throw new CjsFormatWriteError(\"Backend block string exceeds 65535 bytes\", {\r\n            byteLength: bytes.length\r\n        });\r\n    }\r\n    writer.u16(bytes.length);\r\n    writer.bytes(bytes);\r\n}\r\n\r\n/**\r\n * Reads a length-prefixed UTF-8 string.\r\n *\r\n * @param {object} reader Source byte reader.\r\n * @returns {string} Decoded text.\r\n */\r\nexport function readInlineString(reader)\r\n{\r\n    const length = reader.readUint16();\r\n    return new TextDecoder(\"utf-8\", { fatal: false }).decode(reader.readRaw(length));\r\n}\r\n\r\n/**\r\n * Writes the count-prefixed resource-transform section.\r\n *\r\n * @param {object} writer Target byte writer.\r\n * @param {object[]} transforms Resource transforms.\r\n */\r\nexport function writeTransformSection(writer, transforms)\r\n{\r\n    writer.u8(transforms.length);\r\n\r\n    for (const transform of transforms)\r\n    {\r\n        const familyName = transform.family ?? \"detail-map-array\";\r\n        const family = CARBON_BACKEND_TRANSFORM_FAMILY.indexOf(familyName);\r\n        if (family < 0)\r\n        {\r\n            throw new CjsFormatWriteError(`Unknown transform family \"${transform.family}\"`, {\r\n                family: transform.family\r\n            });\r\n        }\r\n        assertRestoredFieldsAgree(transform, familyName, TRANSFORM_DEFAULTS_BY_FAMILY[familyName]);\r\n        writer.u8(family);\r\n        // `id` stays on the wire: a caller may supply it, and it propagates into\r\n        // the engine binding as `transformId`. Deriving it would foreclose the\r\n        // caller-supplied plan path to save four bytes.\r\n        writeInlineString(writer, transform.id);\r\n        writer.u8(transform.inputs.length);\r\n        for (const input of transform.inputs)\r\n        {\r\n            // Array position is the layer. Safe because `parameter` stays on the\r\n            // wire, so layer identity remains cross-checkable rather than\r\n            // asserted by position.\r\n            //\r\n            // Checked rather than trusted: the reader rebuilds each input's\r\n            // identity from this pair, so a producer that omits it does not fail\r\n            // here -- it writes two zero bytes and every layer reads back as\r\n            // register 0. That is a wrong package that loads, which is worse\r\n            // than one that throws.\r\n            if (!Number.isInteger(input.registerSpace) || !Number.isInteger(input.registerIndex))\r\n            {\r\n                throw new TypeError(\r\n                    `Resource transform input ${input.parameter} needs integer registerSpace and`\r\n                    + ` registerIndex; the reader rebuilds its identity from them`\r\n                );\r\n            }\r\n            writer.u8(input.registerSpace);\r\n            writer.u8(input.registerIndex);\r\n            writeInlineString(writer, input.parameter);\r\n        }\r\n    }\r\n}\r\n\r\n/**\r\n * Reads the count-prefixed resource-transform section, restoring derived fields.\r\n *\r\n * @param {object} reader Source byte reader.\r\n * @param {string|null} layoutKey Enclosing pass key, restored onto records.\r\n * @returns {object[]} Resource transforms.\r\n */\r\nexport function readTransformSection(reader, layoutKey)\r\n{\r\n    const transforms = [];\r\n    const transformCount = reader.readUint8();\r\n\r\n    for (let index = 0; index < transformCount; index += 1)\r\n    {\r\n        const family = CARBON_BACKEND_TRANSFORM_FAMILY[reader.readUint8()];\r\n        const defaults = TRANSFORM_DEFAULTS_BY_FAMILY[family];\r\n        if (!defaults)\r\n        {\r\n            throw new CjsFormatReadError(`Transform family \"${family}\" has no restored constants`, {\r\n                family\r\n            });\r\n        }\r\n        const id = readInlineString(reader);\r\n        const inputs = [];\r\n        const inputCount = reader.readUint8();\r\n        for (let layer = 0; layer < inputCount; layer += 1)\r\n        {\r\n            const registerSpace = reader.readUint8();\r\n            const registerIndex = reader.readUint8();\r\n            const parameter = readInlineString(reader);\r\n            const identity = `sampled-resource:${registerSpace}:${registerIndex}`;\r\n            inputs.push({\r\n                parameter,\r\n                layer,\r\n                // Kept alongside the identity they compose: a consumer checking\r\n                // the transform against a binding set compares registers, and\r\n                // re-parsing them back out of the identity string is a second\r\n                // place for the format of that string to matter.\r\n                registerSpace,\r\n                registerIndex,\r\n                identity,\r\n                scopeIdentity: `${identity}@${defaults.stage}`\r\n            });\r\n        }\r\n\r\n        transforms.push({\r\n            id,\r\n            family,\r\n            version: defaults.version,\r\n            kind: defaults.kind,\r\n            stage: defaults.stage,\r\n            representation: defaults.representation,\r\n            missingLayer: defaults.missingLayer,\r\n            layoutKey,\r\n            inputs,\r\n            output: {\r\n                name: defaults.outputName,\r\n                viewDimension: defaults.viewDimension,\r\n                layerCount: inputs.length,\r\n                identity: inputs[0]?.identity ?? null,\r\n                scopeIdentity: inputs[0]?.scopeIdentity ?? null\r\n            }\r\n        });\r\n    }\r\n\r\n    return transforms;\r\n}\r\n"],"names":["CARBON_BACKEND_TRANSFORM_FAMILY","Object","freeze","DETAIL_MAP_ARRAY_DEFAULTS","version","kind","stage","representation","missingLayer","viewDimension","outputName","DETAIL_MAP_ARRAY_NAME","LOCAL_LIGHT_PROFILE_NEUTRAL_DEFAULTS","TRANSFORM_DEFAULTS_BY_FAMILY","assertRestoredFieldsAgree","transform","family","defaults","restored","output","name","field","actual","expected","undefined","CjsFormatWriteError","id","JSON","stringify","layerCount","inputs","length","declared","writeInlineString","writer","value","bytes","TextEncoder","encode","String","byteLength","u16","readInlineString","reader","readUint16","TextDecoder","fatal","decode","readRaw","writeTransformSection","transforms","u8","familyName","indexOf","input","Number","isInteger","registerSpace","registerIndex","TypeError","parameter","readTransformSection","layoutKey","transformCount","readUint8","index","CjsFormatReadError","inputCount","layer","identity","push","scopeIdentity"],"mappings":"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"}

package/dist/format/index.js

@@ -3,7 +3,7 @@ export { CjsFormatReadError, CjsFormatWriteError } from './CjsFormatError.js';
 export { CjsByteReader } from './CjsByteReader.js';
 export { CjsByteWriter } from './CjsByteWriter.js';
 export { CJS_STRING_TABLE_NULL_REFERENCE, CjsStringTable, compareTableBlobs } from './CjsStringTable.js';
-export { CARBON_ANNOTATION_TYPE, CARBON_EFFECT_COUNT_CAPS, CARBON_EFFECT_DATA_VERSION, CARBON_EFFECT_MIN_DATA_VERSION, CARBON_SHADER_CONSTANTS_MAX, collectArena, compareAnnotationNames, internArena, passthroughArena, readEffectDescription, writeEffectDescription } from './carbonEffect/carbonEffectRecords.js';
+export { CARBON_ANNOTATION_TYPE, CARBON_EFFECT_COUNT_CAPS, CARBON_EFFECT_DATA_VERSION, CARBON_EFFECT_MIN_DATA_VERSION, CARBON_EFFECT_WRITE_VERSIONS, CARBON_SHADER_CONSTANTS_MAX, collectArena, compareAnnotationNames, internArena, passthroughArena, readEffectDescription, resolveWriteVersion, writeEffectDescription } from './carbonEffect/carbonEffectRecords.js';
 export { CARBON_BACKEND_RESOURCE_KIND, CARBON_BACKEND_VISIBILITY, readBackendBlock, writeBackendBlock } from './carbonEffect/carbonEffectBackendBlock.js';
 export { CARBON_EFFECT_RECORD_BYTES, CARBON_EFFECT_SOURCE_HASH_BYTES, CjsCarbonEffectBodyReader, CjsCarbonEffectReader, looksLikeCarbonEffectContainer } from './carbonEffect/CjsCarbonEffectReader.js';
 export { CjsCarbonEffectWriter, writeCarbonEffectFile } from './carbonEffect/CjsCarbonEffectWriter.js';

package/dist/formats/dds/core/helpers.js

@@ -37,6 +37,7 @@ const DXGI_PIXEL_FORMATS = Object.freeze({
   6: "rgb32float",
   10: "rgba16float",
   16: "rg32float",
+  34: "rg16float",
   41: "r32float",
   54: "r16float",
   28: "rgba8unorm",
@@ -460,7 +461,7 @@ function readDdsTexture(bytes, metadata) {
   };
 }
 function canDecodeDdsToRgba(metadata) {
-  return ["rgba32float", "rgb32float", "rgba16float", "rg32float", "r32float", "r16float", "rgba8unorm", "rgba8unorm-srgb", "bgra8unorm", "bgra8unorm-srgb", "bgrx8unorm", "bgrx8unorm-srgb", "rgbx8unorm", "bgr8unorm", "l8unorm", "l8a8unorm", "a8unorm", "rg8unorm", "r8unorm", "bc1-rgba-unorm", "bc1-rgba-unorm-srgb", "bc2-rgba-unorm", "bc2-rgba-unorm-srgb", "bc3-rgba-unorm", "bc3-rgba-unorm-srgb", "bc4-r-unorm", "bc4-r-snorm", "bc5-rg-unorm", "bc5-rg-snorm", "bc6h-rgb-ufloat", "bc6h-rgb-float", "bc7-rgba-unorm", "bc7-rgba-unorm-srgb"].includes(metadata.pixelFormat);
+  return ["rgba32float", "rgb32float", "rgba16float", "rg32float", "rg16float", "r32float", "r16float", "rgba8unorm", "rgba8unorm-srgb", "bgra8unorm", "bgra8unorm-srgb", "bgrx8unorm", "bgrx8unorm-srgb", "rgbx8unorm", "bgr8unorm", "l8unorm", "l8a8unorm", "a8unorm", "rg8unorm", "r8unorm", "bc1-rgba-unorm", "bc1-rgba-unorm-srgb", "bc2-rgba-unorm", "bc2-rgba-unorm-srgb", "bc3-rgba-unorm", "bc3-rgba-unorm-srgb", "bc4-r-unorm", "bc4-r-snorm", "bc5-rg-unorm", "bc5-rg-snorm", "bc6h-rgb-ufloat", "bc6h-rgb-float", "bc7-rgba-unorm", "bc7-rgba-unorm-srgb"].includes(metadata.pixelFormat);
 }
 function readDdsToRgba(bytes, metadata) {
   if (!canDecodeDdsToRgba(metadata)) {
@@ -563,6 +564,7 @@ function getDdsLevelLayout(pixelFormat, width, height, depth) {
     "rgb32float": 12,
     "rgba16float": 8,
     "rg32float": 8,
+    "rg16float": 4,
     "r32float": 4,
     "r16float": 2,
     "rgba8unorm": 4,
@@ -648,6 +650,7 @@ function decodeFloatUncompressed(source, metadata) {
     "rgb32float": 12,
     "rgba16float": 8,
     "rg32float": 8,
+    "rg16float": 4,
     "r32float": 4,
     "r16float": 2
   }[metadata.pixelFormat];
@@ -675,6 +678,11 @@ function decodeFloatUncompressed(source, metadata) {
       green = view.getFloat32(sourceOffset + 4, true);
       blue = 0;
       alpha = 1;
+    } else if (metadata.pixelFormat === "rg16float") {
+      red = halfToFloat(view.getUint16(sourceOffset, true));
+      green = halfToFloat(view.getUint16(sourceOffset + 2, true));
+      blue = 0;
+      alpha = 1;
     } else {
       red = metadata.pixelFormat === "r16float" ? halfToFloat(view.getUint16(sourceOffset, true)) : view.getFloat32(sourceOffset, true);
       green = red;
@@ -689,7 +697,7 @@ function decodeFloatUncompressed(source, metadata) {
   return rgba;
 }
 function isFloatPixelFormat(pixelFormat) {
-  return typeof pixelFormat === "string" && (pixelFormat.startsWith("bc6h-") || ["rgba32float", "rgb32float", "rgba16float", "rg32float", "r32float", "r16float"].includes(pixelFormat));
+  return typeof pixelFormat === "string" && (pixelFormat.startsWith("bc6h-") || ["rgba32float", "rgb32float", "rgba16float", "rg32float", "rg16float", "r32float", "r16float"].includes(pixelFormat));
 }
 function halfToFloat(value) {
   const sign = value & 0x8000 ? -1 : 1;
@@ -832,13 +840,34 @@ function decodeBc1Colors(c0, c1, forceFourColor = false) {
 function decode565(value) {
   return [Math.round((value >>> 11 & 0x1f) * 255 / 31), Math.round((value >>> 5 & 0x3f) * 255 / 63), Math.round((value & 0x1f) * 255 / 31), 255];
 }
+
+/**
+ * The floating-point `D3DFORMAT` enumerators, which a legacy DDS stores as a
+ * NUMBER in the four-character-code field rather than as four characters.
+ *
+ * That is the whole trap. `DDPF_FOURCC` is set and the field reads `114`, which
+ * as text is `"r\0\0\0"` and matches nothing, so a reader that only compares
+ * character codes reports an unrecognized format for a file whose format is
+ * perfectly ordinary. Every one of these six is a plain uncompressed surface.
+ *
+ * Two were mapped when BC6H support landed and the other four were not, so
+ * `A16B16G16R16F` and `A32B32G32R32F` loaded while their one- and two-channel
+ * siblings did not. Found 2026-08-16 on
+ * `res:/dx9/model/ship/amarr/battleship/ab3/effects/ab3_traffic.dds`, a 256x9
+ * `R32F` gradient.
+ */
+const LEGACY_D3DFMT_PIXEL_FORMATS = {
+  111: "r16float",
+  112: "rg16float",
+  113: "rgba16float",
+  114: "r32float",
+  115: "rg32float",
+  116: "rgba32float"
+};
 function getDdsPixelFormat(format) {
   if (format.dxgiFormat) return DXGI_PIXEL_FORMATS[format.dxgiFormat] || "";
   if (format.pfFlags & DDS_FOURCC && format.fourCc) {
-    return FOURCC_PIXEL_FORMATS[format.fourCc] || {
-      113: "rgba16float",
-      116: "rgba32float"
-    }[format.fourCcCode] || "";
+    return FOURCC_PIXEL_FORMATS[format.fourCc] || LEGACY_D3DFMT_PIXEL_FORMATS[format.fourCcCode] || "";
   }
   if (format.pfFlags & DDS_RGB) {
     if (format.rgbBitCount === 32 && format.rBitMask === 0x000000ff && format.gBitMask === 0x0000ff00 && format.bBitMask === 0x00ff0000 && format.aBitMask === 0xff000000) return "rgba8unorm";