@carbonenginejs/runtime 0.1.0-alpha.3 → 0.1.0-alpha.4

package/dist/resource/formats/hlsl/core/textureArrayFamilies.js

@@ -0,0 +1,285 @@
+/**
+ * Recognises the resource families that merge into one array texture.
+ *
+ * A family is a set of textures a shader samples for the same purpose, which
+ * can therefore live as layers of a single array texture and cost one binding
+ * instead of one each. Both backends must agree exactly on which registers take
+ * part, and that decision is about the resources rather than the shading
+ * language, so it lives here.
+ *
+ * ## Why more than one family
+ *
+ * The detail maps came first and were, for a while, the only family in the
+ * shipped corpus. EVE Frontier's pbr/shipquadmaterial then arrived needing 21
+ * texture units against WebGL2's guaranteed 16, with no detail maps at all: it
+ * carries four roughness maps, an atlas trio and a dirt pair instead, each read
+ * for a single channel. Merging those three families takes it to 15.
+ *
+ * So the rule is a table rather than a special case. Adding a family is a row
+ * here; nothing downstream needs to learn its name.
+ *
+ * ## What recognition proves, and what it does not
+ *
+ * It proves the RESOURCES can be merged. It does not prove every USE can be
+ * redirected at an array layer, and it cannot see sampler state at all, because
+ * the texture and sampler pairing lives in the DXBC operands rather than in
+ * reflection. Each backend pairs this with its own walk over the shader and
+ * fails closed on anything it cannot redirect.
+ */
+
+/**
+ * ## Lowering is ordered, and it stops as soon as the program fits
+ *
+ * A row here does not mean "always merge". The families are tried in table
+ * order and only as many as the unit budget requires; a stage that already fits
+ * merges nothing and keeps its own samplers. That is cheaper at runtime - every
+ * aggregate that is never built is one that never has to be composed - and it
+ * is what makes the merge invisible to a consumer, because a permutation that
+ * drops below the budget simply stops merging.
+ *
+ * ## Two kinds of merge, and the difference is what the data IS
+ *
+ * - `array` - the same kind of data in several images, told apart by layer.
+ *   The detail maps are this: three images sampled at the same coordinate but
+ *   at different scales, which is why each carries its own `LodUvScale`
+ *   annotation. They cannot share a texel.
+ *
+ * - `pack` - different kinds of SCALAR data at one coordinate, each read for a
+ *   single channel. Its output name ends `PackMap` where an array's ends
+ *   `ArrayMap`, so the name never claims a shape the texture does not have -
+ *   and so a pack can never take the name of a map the shader already has, the
+ *   way a `NoiseMap` pack would have shadowed the asteroid shader's own. Four of those are one RGBA texture, read once. An array
+ *   would also cost one unit, but it would cost four fetches to read four
+ *   scalars and a `sampler2DArray` for data that was never layered.
+ *
+ * Measured on Frontier's `pbr/shipquadmaterial`, thirteen samplers each
+ * contribute exactly one scalar - the four roughness maps, the dirt pair, the
+ * atlas trio, grunge, gradient and curvature. The storage is not
+ * single-channel; the CONSUMPTION is, so the packing happens on our side.
+ * `/docs/research/frontier-shader-budget.md`.
+ *
+ * ## PMDG is a packing family because it always was one texture
+ *
+ * `PaintMaskMap`, `MaterialMap`, `DirtMap` and `GlowMap` were one texture until
+ * CCP separated them - the acronym is that texture's channel order. Merging
+ * them is not an invention, it is undoing the split, and the form it undoes to
+ * is the original: one RGBA texture, one fetch, four scalars.
+ *
+ * A row for them was written as an array, removed on a standing "never on EVE"
+ * ruling, restored when that ruling was shown to collapse into the ordering,
+ * and is now a packing row because the array shape was wrong (operator,
+ * 2026-09-18).
+ *
+ * The ruling collapsed because a per-target list can only change the outcome
+ * where the ordering already reached this row - that is, where the stage did
+ * NOT fit without it. Withholding it there produces a program over the unit
+ * limit rather than a saving. EVE does reach it: `quadheatdetailv5` and its
+ * three prefix forms are 17 emitted samplers on `.sm_depth` at build 3503375,
+ * the only EVE containers over 16. CCP met the same wall - that shader is in
+ * the dx11 tree and absent from gles2, skipped because it could not be lowered.
+ *
+ * So there is no per-game family list. There is one ordered list and a budget.
+ *
+ * Numbers for both games: `/docs/contracts/quad-family-texture-budget.md`.
+ * What happens when the sources disagree on shape or format:
+ * `/docs/contracts/texture-array-realization.md`.
+ */
+
+/** Carbon's resource type code for a 2D texture. */
+const CARBON_TEXTURE_2D = 2;
+
+/**
+ * The families, in layer order.
+ *
+ * The parameter list is the order the layers take, and it is the only thing
+ * that decides a layer index: reflection may list them in any order, and a
+ * register that happened to come second is layer 1 only if its name says so.
+ *
+ * The minimum is how few members still merit a merge. Two is the floor
+ * everywhere, because one map in a one-layer array saves nothing.
+ */
+const TEXTURE_ARRAY_FAMILIES = Object.freeze([Object.freeze({
+  kind: "array",
+  family: "detail-map-array",
+  outputName: "DetailArrayMap",
+  parameters: Object.freeze(["Detail1Map", "Detail2Map", "Detail3Map"]),
+  minimum: 2
+}), Object.freeze({
+  kind: "array",
+  family: "roughness-map-array",
+  outputName: "RoughnessArrayMap",
+  parameters: Object.freeze(["Roughness1Map", "Roughness2Map", "Roughness3Map", "Roughness4Map"]),
+  minimum: 2
+}), Object.freeze({
+  kind: "array",
+  family: "atlas-map-array",
+  outputName: "AtlasArrayMap",
+  parameters: Object.freeze(["AtlasAOMap", "AtlasPaintMap", "AtlasCurvatureMap"]),
+  minimum: 2
+}), Object.freeze({
+  kind: "array",
+  family: "dirt-map-array",
+  outputName: "DirtArrayMap",
+  parameters: Object.freeze(["DirtMap1", "DirtMap2"]),
+  minimum: 2
+}),
+// Frontier's pbr material tree, which the quad sweep missed entirely and
+// which is where the structure and asteroid shaders were failing to link.
+//
+// Grouped by WHAT THE MAP IS, not by "any four scalars that happen to sit
+// together" (operator, 2026-09-18). A family is one kind of map, numbered;
+// that is what every row above already is, and a pack of unrelated scalars
+// would be a different idea wearing the same mechanism.
+//
+// Each read is a single channel, measured from the emitted GLSL rather than
+// assumed - `.x` for every member of all three.
+Object.freeze({
+  kind: "pack",
+  family: "ambient-occlusion-channel-pack",
+  outputName: "AmbientOcclusionPackMap",
+  parameters: Object.freeze(["AmbientOcclusion1Map", "AmbientOcclusion2Map"]),
+  minimum: 2
+}), Object.freeze({
+  kind: "pack",
+  family: "curvature-channel-pack",
+  outputName: "CurvaturePackMap",
+  parameters: Object.freeze(["Curvature1Map", "Curvature2Map"]),
+  minimum: 2
+}),
+// The numbered series only. `NoiseMap` is a separate map that happens to be
+// scalar too, and folding it in here would be grouping by storage rather
+// than by what the map is. It is one more unit if one is ever needed.
+Object.freeze({
+  kind: "pack",
+  family: "noise-channel-pack",
+  outputName: "NoisePackMap",
+  parameters: Object.freeze(["Noise1Map", "Noise2Map", "Noise3Map"]),
+  minimum: 2
+}),
+// Last, so it is reached only by a stage that nothing above it could bring
+// under the budget. On EVE that is `quadheatdetailv5` alone.
+Object.freeze({
+  kind: "pack",
+  family: "pmdg-channel-pack",
+  outputName: "PmdgPackMap",
+  // Channel order follows the REGISTERS - t4, t8, t9, t10 on both games,
+  // in that order - rather than the acronym, because the recogniser
+  // requires ascending registers in parameter order. Which scalar lands
+  // in which channel does not matter as long as the emitter and whatever
+  // builds the texture read it from here, and they both do.
+  parameters: Object.freeze(["GlowMap", "DirtMap", "MaterialMap", "PaintMaskMap"]),
+  minimum: 2
+})]);
+
+/**
+ * Recognises one declared family in a stage's reflected resources.
+ *
+ * Requires the members to be contiguous from the first name with no gap, in one
+ * register space, at strictly ascending registers, and each an ordinary
+ * single-element 2D texture declared linear. Anything else returns null: a
+ * partial or unusual family is not merged, because guessing produces a shader
+ * that links and samples the wrong thing.
+ *
+ * isSRGB must be present and false rather than merely not true. Carbon's reader
+ * always sets it, so an absent flag means the caller is passing something other
+ * than resource reflection, and the layers of one array texture cannot disagree
+ * about whether sampling decodes sRGB.
+ *
+ * @param {object} definition One row of TEXTURE_ARRAY_FAMILIES.
+ * @param {Array<object>} resources Reflected resources.
+ * @param {object} [options] Recognition options.
+ * @param {number} [options.registerSpace] Default register space.
+ * @returns {object|null} Frozen plan, or null when the family is absent or unusable.
+ */
+function recogniseTextureArrayFamily(definition, resources, options = {}) {
+  const registerSpace = options.registerSpace ?? 0;
+  const byParameter = new Map();
+  for (const resource of resources ?? []) {
+    const value = resource?.toJSON?.() ?? resource;
+    const name = value?.name ?? value?.parameter;
+    if (typeof name !== "string" || !definition.parameters.includes(name)) continue;
+
+    // A duplicate name means the reflection is not what this recogniser
+    // assumes, so it declines rather than picking one.
+    if (byParameter.has(name)) return null;
+    byParameter.set(name, {
+      registerIndex: value.registerIndex,
+      value
+    });
+  }
+  if (byParameter.size < definition.minimum) return null;
+
+  // Contiguous from the first name: 1 and 2 merge, 1 and 3 do not.
+  const parameters = definition.parameters.slice(0, byParameter.size);
+  if (parameters.some(parameter => !byParameter.has(parameter))) return null;
+  const layers = [];
+  for (const [layer, parameter] of parameters.entries()) {
+    const {
+      registerIndex,
+      value
+    } = byParameter.get(parameter);
+    if (!Number.isInteger(registerIndex) || registerIndex < 0 || value.type !== CARBON_TEXTURE_2D || (value.arrayElements ?? 1) !== 1 || value.isSRGB !== false) {
+      return null;
+    }
+    const space = value.registerSpace ?? registerSpace;
+
+    // One array texture occupies one binding, so the layers cannot come
+    // from different register spaces.
+    if (layer > 0 && space !== layers[layer - 1].registerSpace) return null;
+    if (layer > 0 && registerIndex <= layers[layer - 1].registerIndex) return null;
+    layers.push({
+      parameter,
+      layer,
+      registerIndex,
+      registerSpace: space
+    });
+  }
+  return Object.freeze({
+    kind: definition.kind ?? "array",
+    family: definition.family,
+    outputName: definition.outputName,
+    registerSpace,
+    layerCount: layers.length,
+    layers: layers.map(entry => entry),
+    registers: layers.map(entry => entry.registerIndex)
+  });
+}
+
+/**
+ * Recognises every declared family in one stage's reflected resources.
+ *
+ * @param {Array<object>} resources Reflected resources.
+ * @param {object} [options] Recognition options.
+ * @returns {Array<object>} Plans, in table order; empty when none are present.
+ */
+function recogniseTextureArrayFamilies(resources, options = {}) {
+  const plans = [];
+  for (const definition of TEXTURE_ARRAY_FAMILIES) {
+    const plan = recogniseTextureArrayFamily(definition, resources, options);
+    if (plan) plans.push(plan);
+  }
+  return plans;
+}
+
+/**
+ * Builds the transform record the container's shared transform section stores.
+ *
+ * @param {object} plan Recognised family plan.
+ * @param {string} layoutKey Enclosing pass key.
+ * @returns {object} Transform record.
+ */
+function textureArrayTransformFor(plan, layoutKey) {
+  return {
+    id: layoutKey + ":" + plan.family + ":sampled-resource:" + plan.registerSpace + ":" + plan.registers[0],
+    family: plan.family,
+    layoutKey,
+    inputs: plan.layers.map(entry => ({
+      registerSpace: entry.registerSpace,
+      registerIndex: entry.registerIndex,
+      parameter: entry.parameter
+    }))
+  };
+}
+
+export { TEXTURE_ARRAY_FAMILIES, recogniseTextureArrayFamilies, recogniseTextureArrayFamily, textureArrayTransformFor };
+//# sourceMappingURL=textureArrayFamilies.js.map

package/dist/resource/formats/hlsl/core/textureArrayFamilies.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"textureArrayFamilies.js","sources":["../../../../../../src/resource/formats/hlsl/core/textureArrayFamilies.js"],"sourcesContent":["/**\n * Recognises the resource families that merge into one array texture.\n *\n * A family is a set of textures a shader samples for the same purpose, which\n * can therefore live as layers of a single array texture and cost one binding\n * instead of one each. Both backends must agree exactly on which registers take\n * part, and that decision is about the resources rather than the shading\n * language, so it lives here.\n *\n * ## Why more than one family\n *\n * The detail maps came first and were, for a while, the only family in the\n * shipped corpus. EVE Frontier's pbr/shipquadmaterial then arrived needing 21\n * texture units against WebGL2's guaranteed 16, with no detail maps at all: it\n * carries four roughness maps, an atlas trio and a dirt pair instead, each read\n * for a single channel. Merging those three families takes it to 15.\n *\n * So the rule is a table rather than a special case. Adding a family is a row\n * here; nothing downstream needs to learn its name.\n *\n * ## What recognition proves, and what it does not\n *\n * It proves the RESOURCES can be merged. It does not prove every USE can be\n * redirected at an array layer, and it cannot see sampler state at all, because\n * the texture and sampler pairing lives in the DXBC operands rather than in\n * reflection. Each backend pairs this with its own walk over the shader and\n * fails closed on anything it cannot redirect.\n */\n\n/**\n * ## Lowering is ordered, and it stops as soon as the program fits\n *\n * A row here does not mean \"always merge\". The families are tried in table\n * order and only as many as the unit budget requires; a stage that already fits\n * merges nothing and keeps its own samplers. That is cheaper at runtime - every\n * aggregate that is never built is one that never has to be composed - and it\n * is what makes the merge invisible to a consumer, because a permutation that\n * drops below the budget simply stops merging.\n *\n * ## Two kinds of merge, and the difference is what the data IS\n *\n * - `array` - the same kind of data in several images, told apart by layer.\n *   The detail maps are this: three images sampled at the same coordinate but\n *   at different scales, which is why each carries its own `LodUvScale`\n *   annotation. They cannot share a texel.\n *\n * - `pack` - different kinds of SCALAR data at one coordinate, each read for a\n *   single channel. Its output name ends `PackMap` where an array's ends\n *   `ArrayMap`, so the name never claims a shape the texture does not have -\n *   and so a pack can never take the name of a map the shader already has, the\n *   way a `NoiseMap` pack would have shadowed the asteroid shader's own. Four of those are one RGBA texture, read once. An array\n *   would also cost one unit, but it would cost four fetches to read four\n *   scalars and a `sampler2DArray` for data that was never layered.\n *\n * Measured on Frontier's `pbr/shipquadmaterial`, thirteen samplers each\n * contribute exactly one scalar - the four roughness maps, the dirt pair, the\n * atlas trio, grunge, gradient and curvature. The storage is not\n * single-channel; the CONSUMPTION is, so the packing happens on our side.\n * `/docs/research/frontier-shader-budget.md`.\n *\n * ## PMDG is a packing family because it always was one texture\n *\n * `PaintMaskMap`, `MaterialMap`, `DirtMap` and `GlowMap` were one texture until\n * CCP separated them - the acronym is that texture's channel order. Merging\n * them is not an invention, it is undoing the split, and the form it undoes to\n * is the original: one RGBA texture, one fetch, four scalars.\n *\n * A row for them was written as an array, removed on a standing \"never on EVE\"\n * ruling, restored when that ruling was shown to collapse into the ordering,\n * and is now a packing row because the array shape was wrong (operator,\n * 2026-09-18).\n *\n * The ruling collapsed because a per-target list can only change the outcome\n * where the ordering already reached this row - that is, where the stage did\n * NOT fit without it. Withholding it there produces a program over the unit\n * limit rather than a saving. EVE does reach it: `quadheatdetailv5` and its\n * three prefix forms are 17 emitted samplers on `.sm_depth` at build 3503375,\n * the only EVE containers over 16. CCP met the same wall - that shader is in\n * the dx11 tree and absent from gles2, skipped because it could not be lowered.\n *\n * So there is no per-game family list. There is one ordered list and a budget.\n *\n * Numbers for both games: `/docs/contracts/quad-family-texture-budget.md`.\n * What happens when the sources disagree on shape or format:\n * `/docs/contracts/texture-array-realization.md`.\n */\n\n/** Carbon's resource type code for a 2D texture. */\nconst CARBON_TEXTURE_2D = 2;\n\n/**\n * The families, in layer order.\n *\n * The parameter list is the order the layers take, and it is the only thing\n * that decides a layer index: reflection may list them in any order, and a\n * register that happened to come second is layer 1 only if its name says so.\n *\n * The minimum is how few members still merit a merge. Two is the floor\n * everywhere, because one map in a one-layer array saves nothing.\n */\nexport const TEXTURE_ARRAY_FAMILIES = Object.freeze([\n    Object.freeze({\n        kind: \"array\",\n        family: \"detail-map-array\",\n        outputName: \"DetailArrayMap\",\n        parameters: Object.freeze([ \"Detail1Map\", \"Detail2Map\", \"Detail3Map\" ]),\n        minimum: 2\n    }),\n    Object.freeze({\n        kind: \"array\",\n        family: \"roughness-map-array\",\n        outputName: \"RoughnessArrayMap\",\n        parameters: Object.freeze([ \"Roughness1Map\", \"Roughness2Map\", \"Roughness3Map\", \"Roughness4Map\" ]),\n        minimum: 2\n    }),\n    Object.freeze({\n        kind: \"array\",\n        family: \"atlas-map-array\",\n        outputName: \"AtlasArrayMap\",\n        parameters: Object.freeze([ \"AtlasAOMap\", \"AtlasPaintMap\", \"AtlasCurvatureMap\" ]),\n        minimum: 2\n    }),\n    Object.freeze({\n        kind: \"array\",\n        family: \"dirt-map-array\",\n        outputName: \"DirtArrayMap\",\n        parameters: Object.freeze([ \"DirtMap1\", \"DirtMap2\" ]),\n        minimum: 2\n    }),\n    // Frontier's pbr material tree, which the quad sweep missed entirely and\n    // which is where the structure and asteroid shaders were failing to link.\n    //\n    // Grouped by WHAT THE MAP IS, not by \"any four scalars that happen to sit\n    // together\" (operator, 2026-09-18). A family is one kind of map, numbered;\n    // that is what every row above already is, and a pack of unrelated scalars\n    // would be a different idea wearing the same mechanism.\n    //\n    // Each read is a single channel, measured from the emitted GLSL rather than\n    // assumed - `.x` for every member of all three.\n    Object.freeze({\n        kind: \"pack\",\n        family: \"ambient-occlusion-channel-pack\",\n        outputName: \"AmbientOcclusionPackMap\",\n        parameters: Object.freeze([ \"AmbientOcclusion1Map\", \"AmbientOcclusion2Map\" ]),\n        minimum: 2\n    }),\n    Object.freeze({\n        kind: \"pack\",\n        family: \"curvature-channel-pack\",\n        outputName: \"CurvaturePackMap\",\n        parameters: Object.freeze([ \"Curvature1Map\", \"Curvature2Map\" ]),\n        minimum: 2\n    }),\n    // The numbered series only. `NoiseMap` is a separate map that happens to be\n    // scalar too, and folding it in here would be grouping by storage rather\n    // than by what the map is. It is one more unit if one is ever needed.\n    Object.freeze({\n        kind: \"pack\",\n        family: \"noise-channel-pack\",\n        outputName: \"NoisePackMap\",\n        parameters: Object.freeze([ \"Noise1Map\", \"Noise2Map\", \"Noise3Map\" ]),\n        minimum: 2\n    }),\n    // Last, so it is reached only by a stage that nothing above it could bring\n    // under the budget. On EVE that is `quadheatdetailv5` alone.\n    Object.freeze({\n        kind: \"pack\",\n        family: \"pmdg-channel-pack\",\n        outputName: \"PmdgPackMap\",\n        // Channel order follows the REGISTERS - t4, t8, t9, t10 on both games,\n        // in that order - rather than the acronym, because the recogniser\n        // requires ascending registers in parameter order. Which scalar lands\n        // in which channel does not matter as long as the emitter and whatever\n        // builds the texture read it from here, and they both do.\n        parameters: Object.freeze([ \"GlowMap\", \"DirtMap\", \"MaterialMap\", \"PaintMaskMap\" ]),\n        minimum: 2\n    })\n]);\n\n/**\n * Recognises one declared family in a stage's reflected resources.\n *\n * Requires the members to be contiguous from the first name with no gap, in one\n * register space, at strictly ascending registers, and each an ordinary\n * single-element 2D texture declared linear. Anything else returns null: a\n * partial or unusual family is not merged, because guessing produces a shader\n * that links and samples the wrong thing.\n *\n * isSRGB must be present and false rather than merely not true. Carbon's reader\n * always sets it, so an absent flag means the caller is passing something other\n * than resource reflection, and the layers of one array texture cannot disagree\n * about whether sampling decodes sRGB.\n *\n * @param {object} definition One row of TEXTURE_ARRAY_FAMILIES.\n * @param {Array<object>} resources Reflected resources.\n * @param {object} [options] Recognition options.\n * @param {number} [options.registerSpace] Default register space.\n * @returns {object|null} Frozen plan, or null when the family is absent or unusable.\n */\nexport function recogniseTextureArrayFamily(definition, resources, options = {})\n{\n    const registerSpace = options.registerSpace ?? 0;\n    const byParameter = new Map();\n\n    for (const resource of resources ?? [])\n    {\n        const value = resource?.toJSON?.() ?? resource;\n        const name = value?.name ?? value?.parameter;\n\n        if (typeof name !== \"string\" || !definition.parameters.includes(name)) continue;\n\n        // A duplicate name means the reflection is not what this recogniser\n        // assumes, so it declines rather than picking one.\n        if (byParameter.has(name)) return null;\n        byParameter.set(name, { registerIndex: value.registerIndex, value });\n    }\n\n    if (byParameter.size < definition.minimum) return null;\n\n    // Contiguous from the first name: 1 and 2 merge, 1 and 3 do not.\n    const parameters = definition.parameters.slice(0, byParameter.size);\n\n    if (parameters.some((parameter) => !byParameter.has(parameter))) return null;\n\n    const layers = [];\n\n    for (const [ layer, parameter ] of parameters.entries())\n    {\n        const { registerIndex, value } = byParameter.get(parameter);\n\n        if (!Number.isInteger(registerIndex) || registerIndex < 0\n            || value.type !== CARBON_TEXTURE_2D\n            || (value.arrayElements ?? 1) !== 1\n            || value.isSRGB !== false)\n        {\n            return null;\n        }\n\n        const space = value.registerSpace ?? registerSpace;\n\n        // One array texture occupies one binding, so the layers cannot come\n        // from different register spaces.\n        if (layer > 0 && space !== layers[layer - 1].registerSpace) return null;\n        if (layer > 0 && registerIndex <= layers[layer - 1].registerIndex) return null;\n\n        layers.push({ parameter, layer, registerIndex, registerSpace: space });\n    }\n\n    return Object.freeze({\n        kind: definition.kind ?? \"array\",\n        family: definition.family,\n        outputName: definition.outputName,\n        registerSpace,\n        layerCount: layers.length,\n        layers: layers.map((entry) => entry),\n        registers: layers.map((entry) => entry.registerIndex)\n    });\n}\n\n/**\n * Recognises every declared family in one stage's reflected resources.\n *\n * @param {Array<object>} resources Reflected resources.\n * @param {object} [options] Recognition options.\n * @returns {Array<object>} Plans, in table order; empty when none are present.\n */\nexport function recogniseTextureArrayFamilies(resources, options = {})\n{\n    const plans = [];\n\n    for (const definition of TEXTURE_ARRAY_FAMILIES)\n    {\n        const plan = recogniseTextureArrayFamily(definition, resources, options);\n\n        if (plan) plans.push(plan);\n    }\n\n    return plans;\n}\n\n/**\n * Builds the transform record the container's shared transform section stores.\n *\n * @param {object} plan Recognised family plan.\n * @param {string} layoutKey Enclosing pass key.\n * @returns {object} Transform record.\n */\nexport function textureArrayTransformFor(plan, layoutKey)\n{\n    return {\n        id: layoutKey + \":\" + plan.family + \":sampled-resource:\" + plan.registerSpace + \":\" + plan.registers[0],\n        family: plan.family,\n        layoutKey,\n        inputs: plan.layers.map((entry) => ({\n            registerSpace: entry.registerSpace,\n            registerIndex: entry.registerIndex,\n            parameter: entry.parameter\n        }))\n    };\n}\n\nexport default recogniseTextureArrayFamilies;\n"],"names":["CARBON_TEXTURE_2D","TEXTURE_ARRAY_FAMILIES","Object","freeze","kind","family","outputName","parameters","minimum","recogniseTextureArrayFamily","definition","resources","options","registerSpace","byParameter","Map","resource","value","toJSON","name","parameter","includes","has","set","registerIndex","size","slice","some","layers","layer","entries","get","Number","isInteger","type","arrayElements","isSRGB","space","push","layerCount","length","map","entry","registers","recogniseTextureArrayFamilies","plans","plan","textureArrayTransformFor","layoutKey","id","inputs"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA;AACA,MAAMA,iBAAiB,GAAG,CAAC;;AAE3B;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,MAAMC,sBAAsB,GAAGC,MAAM,CAACC,MAAM,CAAC,CAChDD,MAAM,CAACC,MAAM,CAAC;AACVC,EAAAA,IAAI,EAAE,OAAO;AACbC,EAAAA,MAAM,EAAE,kBAAkB;AAC1BC,EAAAA,UAAU,EAAE,gBAAgB;AAC5BC,EAAAA,UAAU,EAAEL,MAAM,CAACC,MAAM,CAAC,CAAE,YAAY,EAAE,YAAY,EAAE,YAAY,CAAE,CAAC;AACvEK,EAAAA,OAAO,EAAE;AACb,CAAC,CAAC,EACFN,MAAM,CAACC,MAAM,CAAC;AACVC,EAAAA,IAAI,EAAE,OAAO;AACbC,EAAAA,MAAM,EAAE,qBAAqB;AAC7BC,EAAAA,UAAU,EAAE,mBAAmB;AAC/BC,EAAAA,UAAU,EAAEL,MAAM,CAACC,MAAM,CAAC,CAAE,eAAe,EAAE,eAAe,EAAE,eAAe,EAAE,eAAe,CAAE,CAAC;AACjGK,EAAAA,OAAO,EAAE;AACb,CAAC,CAAC,EACFN,MAAM,CAACC,MAAM,CAAC;AACVC,EAAAA,IAAI,EAAE,OAAO;AACbC,EAAAA,MAAM,EAAE,iBAAiB;AACzBC,EAAAA,UAAU,EAAE,eAAe;AAC3BC,EAAAA,UAAU,EAAEL,MAAM,CAACC,MAAM,CAAC,CAAE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"}

package/dist/resource/formats/pickle/CjsPickleFormat.js

@@ -1,5 +1,7 @@
 import { CjsFormat } from '../../format/CjsFormat.js';
-import { PICKLE_PROTOCOL_0_LIMITS, CjsPickleProtocol0Reader } from './core/CjsPickleProtocol0Reader.js';
+import { CjsPickleProtocol0Reader } from './core/CjsPickleProtocol0Reader.js';
+import { CjsPickleProtocol4Reader } from './core/CjsPickleProtocol4Reader.js';
+import { PICKLE_LIMITS, normalizeBytes } from './core/pickleCommon.js';
 
 const OUTPUT_JSON = "json";
 const OUTPUT_PAYLOAD = "payload";
@@ -8,19 +10,36 @@ const OUTPUTS = new Set([OUTPUT_JSON, OUTPUT_PAYLOAD, OUTPUT_RAW]);
 const OPTION_NAMES = new Set(["emit", "limits"]);
 const DEFAULT_VALUES = {
   emit: OUTPUT_JSON,
-  limits: PICKLE_PROTOCOL_0_LIMITS
+  limits: PICKLE_LIMITS
 };
+const PROTO = 0x80;
 
 /**
- * Data-only Python pickle format facade that currently decodes protocol 0 into
- * JSON-compatible values or identity-preserving payload graphs while rejecting
- * callable and object-construction opcodes.
+ * Choose the reader for one input.
+ *
+ * Protocol 0 is printable text and has no header. Every binary protocol opens
+ * with `PROTO`, which is the only opcode the text protocol cannot begin with,
+ * so the first byte separates them without guessing - and the binary reader
+ * then reads the declared version out of that same opcode.
+ *
+ * @param {ArrayBuffer|ArrayBufferView} input Pickle bytes.
+ * @returns {Function} Reader class for the input.
+ */
+function readerFor(input) {
+  const bytes = normalizeBytes(input);
+  return bytes.length && bytes[0] === PROTO ? CjsPickleProtocol4Reader : CjsPickleProtocol0Reader;
+}
+
+/**
+ * Data-only Python pickle format facade that decodes the inert subset of
+ * protocols 0 through 4 into JSON-compatible values or identity-preserving
+ * payload graphs while rejecting callable and object-construction opcodes.
  */
 class CjsPickleFormat extends CjsFormat {
   #values = DEFAULT_VALUES;
 
   /**
-   * Create a reusable protocol-0 pickle format profile.
+   * Create a reusable pickle format profile.
    *
    * @param {object} [options] Emit mode and bounded decoder limits.
    */
@@ -119,7 +138,7 @@ class CjsPickleFormat extends CjsFormat {
   }
 
   /**
-   * Decode a JSON-compatible graph through the protocol-0 implementation.
+   * Decode a JSON-compatible graph through the implementation for its protocol.
    *
    * @param {ArrayBuffer|ArrayBufferView} input Pickle bytes.
    * @param {object} [options] Format options.
@@ -127,7 +146,7 @@ class CjsPickleFormat extends CjsFormat {
    */
   static readJSON(input, options = {}) {
     const values = this.normalizeValues(DEFAULT_VALUES, options);
-    return new CjsPickleProtocol0Reader(input, values).ReadJSON();
+    return new (readerFor(input))(input, values).ReadJSON();
   }
 
   /**
@@ -139,7 +158,7 @@ class CjsPickleFormat extends CjsFormat {
    */
   static readPayload(input, options = {}) {
     const values = this.normalizeValues(DEFAULT_VALUES, options);
-    return new CjsPickleProtocol0Reader(input, values).Read();
+    return new (readerFor(input))(input, values).Read();
   }
 
   /**
@@ -163,16 +182,17 @@ class CjsPickleFormat extends CjsFormat {
     return CjsPickleProtocol0Reader.ToJSON(value);
   }
 
-  /** Validate protocol-0 structure and return format metadata. */
+  /** Validate pickle structure and return format metadata. */
   static inspect(input, options = {}) {
     const {
       source: _source,
       ...readOptions
     } = options;
     const value = this.readPayload(input, readOptions);
-    const byteLength = input instanceof ArrayBuffer ? input.byteLength : ArrayBuffer.isView(input) ? input.byteLength : 0;
+    const bytes = normalizeBytes(input);
+    const byteLength = bytes.byteLength;
     return {
-      protocol: 0,
+      protocol: bytes.length && bytes[0] === PROTO ? bytes[1] : 0,
       byteLength,
       rootType: value === null ? "null" : Array.isArray(value) ? "array" : typeof value
     };
@@ -201,7 +221,7 @@ class CjsPickleFormat extends CjsFormat {
     if (!OUTPUTS.has(emit)) {
       throw new TypeError(`CjsPickleFormat unknown emit value ${JSON.stringify(emit)}.`);
     }
-    const baseLimits = base.limits || PICKLE_PROTOCOL_0_LIMITS;
+    const baseLimits = base.limits || PICKLE_LIMITS;
     const optionLimits = options.limits ?? {};
     if (!optionLimits || typeof optionLimits !== "object" || Array.isArray(optionLimits)) {
       throw new TypeError("CjsPickleFormat limits must be an object.");
@@ -219,7 +239,7 @@ class CjsPickleFormat extends CjsFormat {
     PAYLOAD: OUTPUT_PAYLOAD,
     RAW: OUTPUT_RAW
   });
-  static supportedProtocols = Object.freeze([0]);
+  static supportedProtocols = Object.freeze([0, 1, 2, 3, 4]);
   static id = "pickle";
   static extensions = Object.freeze([".pickle"]);
   static mediaTypes = Object.freeze(["data"]);

package/dist/resource/formats/pickle/CjsPickleFormat.js.map

@@ -1 +1 @@
-{"version":3,"file":"CjsPickleFormat.js","sources":["../../../../../src/resource/formats/pickle/CjsPickleFormat.js"],"sourcesContent":["import { CjsFormat } from \"../../format/CjsFormat.js\";\nimport {\n  CjsPickleProtocol0Reader,\n  PICKLE_PROTOCOL_0_LIMITS\n} from \"./core/CjsPickleProtocol0Reader.js\";\n\nconst OUTPUT_JSON = \"json\";\nconst OUTPUT_PAYLOAD = \"payload\";\nconst OUTPUT_RAW = \"raw\";\nconst OUTPUTS = new Set([ OUTPUT_JSON, OUTPUT_PAYLOAD, OUTPUT_RAW ]);\nconst OPTION_NAMES = new Set([ \"emit\", \"limits\" ]);\nconst DEFAULT_VALUES = {\n  emit: OUTPUT_JSON,\n  limits: PICKLE_PROTOCOL_0_LIMITS\n};\n\n/**\n * Data-only Python pickle format facade that currently decodes protocol 0 into\n * JSON-compatible values or identity-preserving payload graphs while rejecting\n * callable and object-construction opcodes.\n */\nexport class CjsPickleFormat extends CjsFormat\n{\n  #values = DEFAULT_VALUES;\n\n  /**\n   * Create a reusable protocol-0 pickle format profile.\n   *\n   * @param {object} [options] Emit mode and bounded decoder limits.\n   */\n  constructor(options = {})\n  {\n    super();\n    this.SetValues(options);\n  }\n\n  /**\n   * Apply supported format options to this profile.\n   *\n   * @param {object} [options] Emit mode and partial decoder limits.\n   * @returns {CjsPickleFormat} This format profile.\n   */\n  SetValues(options = {})\n  {\n    this.#values = this.constructor.normalizeValues(this.#values, options);\n    return this;\n  }\n\n  /**\n   * Return normalized format values with optional per-call overrides.\n   *\n   * @param {object} [options] Per-call format options.\n   * @returns {object} Detached effective values.\n   */\n  GetValues(options = {})\n  {\n    return this.constructor.normalizeValues(this.#values, options);\n  }\n\n  /**\n   * Decode according to the effective emit mode.\n   *\n   * @param {ArrayBuffer|ArrayBufferView} input Pickle bytes.\n   * @param {object} [options] Per-call format options.\n   * @returns {*} Decoded value graph.\n   */\n  Read(input, options = {})\n  {\n    return CjsPickleFormat.read(input, this.GetValues(options));\n  }\n\n  /**\n   * Decode a JSON-compatible graph, rejecting cyclic memo references.\n   *\n   * @param {ArrayBuffer|ArrayBufferView} input Pickle bytes.\n   * @param {object} [options] Per-call format options.\n   * @returns {*} JSON-compatible decoded graph.\n   */\n  ReadJSON(input, options = {})\n  {\n    return CjsPickleFormat.readJSON(input, this.GetValues(options));\n  }\n\n  /**\n   * Decode the inert payload while preserving memo object identity.\n   *\n   * @param {ArrayBuffer|ArrayBufferView} input Pickle bytes.\n   * @param {object} [options] Per-call format options.\n   * @returns {*} Decoded payload graph.\n   */\n  ReadPayload(input, options = {})\n  {\n    return CjsPickleFormat.readPayload(input, this.GetValues(options));\n  }\n\n  /**\n   * Decode the exact inert graph while preserving memo aliases and cycles.\n   *\n   * @param {ArrayBuffer|ArrayBufferView} input Pickle bytes.\n   * @param {object} [options] Per-call format options.\n   * @returns {*} Decoded raw graph.\n   */\n  ReadRaw(input, options = {})\n  {\n    return CjsPickleFormat.readRaw(input, this.GetValues(options));\n  }\n\n  /**\n   * Verify that a decoded graph is JSON-compatible without changing its shape.\n   *\n   * @param {*} value Candidate decoded graph.\n   * @returns {*} The supplied value.\n   */\n  ToJSON(value)\n  {\n    return CjsPickleFormat.toJSON(value);\n  }\n\n  /**\n   * Decode according to the requested emit mode.\n   *\n   * @param {ArrayBuffer|ArrayBufferView} input Pickle bytes.\n   * @param {object} [options] Format options.\n   * @returns {*} Decoded value graph.\n   */\n  static read(input, options = {})\n  {\n    const values = this.normalizeValues(DEFAULT_VALUES, options);\n    if (values.emit === OUTPUT_RAW) return this.readRaw(input, values);\n    if (values.emit === OUTPUT_PAYLOAD) return this.readPayload(input, values);\n    return this.readJSON(input, values);\n  }\n\n  /**\n   * Decode a JSON-compatible graph through the protocol-0 implementation.\n   *\n   * @param {ArrayBuffer|ArrayBufferView} input Pickle bytes.\n   * @param {object} [options] Format options.\n   * @returns {*} JSON-compatible decoded graph.\n   */\n  static readJSON(input, options = {})\n  {\n    const values = this.normalizeValues(DEFAULT_VALUES, options);\n    return new CjsPickleProtocol0Reader(input, values).ReadJSON();\n  }\n\n  /**\n   * Decode an inert payload while preserving pickle memo identity.\n   *\n   * @param {ArrayBuffer|ArrayBufferView} input Pickle bytes.\n   * @param {object} [options] Format options.\n   * @returns {*} Decoded payload graph.\n   */\n  static readPayload(input, options = {})\n  {\n    const values = this.normalizeValues(DEFAULT_VALUES, options);\n    return new CjsPickleProtocol0Reader(input, values).Read();\n  }\n\n  /**\n   * Decode the exact inert graph while preserving memo aliases and cycles.\n   *\n   * @param {ArrayBuffer|ArrayBufferView} input Pickle bytes.\n   * @param {object} [options] Format options.\n   * @returns {*} Decoded raw graph.\n   */\n  static readRaw(input, options = {})\n  {\n    return this.readPayload(input, options);\n  }\n\n  /**\n   * Verify that a decoded graph is JSON-compatible without changing its shape.\n   *\n   * @param {*} value Candidate decoded graph.\n   * @returns {*} The supplied value.\n   */\n  static toJSON(value)\n  {\n    return CjsPickleProtocol0Reader.ToJSON(value);\n  }\n\n  /** Validate protocol-0 structure and return format metadata. */\n  static inspect(input, options = {})\n  {\n    const { source: _source, ...readOptions } = options;\n    const value = this.readPayload(input, readOptions);\n    const byteLength = input instanceof ArrayBuffer\n      ? input.byteLength\n      : ArrayBuffer.isView(input) ? input.byteLength : 0;\n    return {\n      protocol: 0,\n      byteLength,\n      rootType: value === null ? \"null\" : Array.isArray(value) ? \"array\" : typeof value\n    };\n  }\n\n  /** Return synchronous advisory support from a bounded protocol-0 decode. */\n\n  /**\n   * Normalize a format profile and partial override into detached effective\n   * values.\n   *\n   * @param {object} base Existing normalized values.\n   * @param {object} [options] Partial emit and limit overrides.\n   * @returns {object} Detached normalized values.\n   */\n  static normalizeValues(base, options = {})\n  {\n    if (!options || typeof options !== \"object\" || Array.isArray(options))\n    {\n      throw new TypeError(\"CjsPickleFormat options must be an object.\");\n    }\n    for (const name of Object.keys(options))\n    {\n      if (!OPTION_NAMES.has(name))\n      {\n        throw new TypeError(`CjsPickleFormat unknown option ${JSON.stringify(name)}.`);\n      }\n    }\n\n    const emit = options.emit ?? base.emit;\n    if (!OUTPUTS.has(emit))\n    {\n      throw new TypeError(`CjsPickleFormat unknown emit value ${JSON.stringify(emit)}.`);\n    }\n\n    const baseLimits = base.limits || PICKLE_PROTOCOL_0_LIMITS;\n    const optionLimits = options.limits ?? {};\n    if (!optionLimits || typeof optionLimits !== \"object\" || Array.isArray(optionLimits))\n    {\n      throw new TypeError(\"CjsPickleFormat limits must be an object.\");\n    }\n\n    return {\n      emit,\n      limits: {\n        ...baseLimits,\n        ...optionLimits\n      }\n    };\n  }\n\n  static Output = Object.freeze({\n    JSON: OUTPUT_JSON,\n    PAYLOAD: OUTPUT_PAYLOAD,\n    RAW: OUTPUT_RAW\n  });\n  static supportedProtocols = Object.freeze([ 0 ]);\n  static id = \"pickle\";\n  static extensions = Object.freeze([ \".pickle\" ]);\n  static mediaTypes = Object.freeze([ \"data\" ]);\n  static outputs = CjsFormat.defineOutputs({\n      json: { default: true, decoded: true },\n      payload: { decoded: true },\n      raw: { role: \"debug\", decoded: true }\n  });\n}\n\nexport default CjsPickleFormat;\n"],"names":["OUTPUT_JSON","OUTPUT_PAYLOAD","OUTPUT_RAW","OUTPUTS","Set","OPTION_NAMES","DEFAULT_VALUES","emit","limits","PICKLE_PROTOCOL_0_LIMITS","CjsPickleFormat","CjsFormat","constructor","options","SetValues","normalizeValues","GetValues","Read","input","read","ReadJSON","readJSON","ReadPayload","readPayload","ReadRaw","readRaw","ToJSON","value","toJSON","values","CjsPickleProtocol0Reader","inspect","source","_source","readOptions","byteLength","ArrayBuffer","isView","protocol","rootType","Array","isArray","base","TypeError","name","Object","keys","has","JSON","stringify","baseLimits","optionLimits","Output","freeze","PAYLOAD","RAW","supportedProtocols","id","extensions","mediaTypes","outputs","defineOutputs","json","default","decoded","payload","raw","role"],"mappings":"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"}
+{"version":3,"file":"CjsPickleFormat.js","sources":["../../../../../src/resource/formats/pickle/CjsPickleFormat.js"],"sourcesContent":["import { CjsFormat } from \"../../format/CjsFormat.js\";\nimport { CjsPickleProtocol0Reader } from \"./core/CjsPickleProtocol0Reader.js\";\nimport { CjsPickleProtocol4Reader } from \"./core/CjsPickleProtocol4Reader.js\";\nimport { PICKLE_LIMITS, normalizeBytes } from \"./core/pickleCommon.js\";\n\nconst OUTPUT_JSON = \"json\";\nconst OUTPUT_PAYLOAD = \"payload\";\nconst OUTPUT_RAW = \"raw\";\nconst OUTPUTS = new Set([ OUTPUT_JSON, OUTPUT_PAYLOAD, OUTPUT_RAW ]);\nconst OPTION_NAMES = new Set([ \"emit\", \"limits\" ]);\nconst DEFAULT_VALUES = {\n  emit: OUTPUT_JSON,\n  limits: PICKLE_LIMITS\n};\n\nconst PROTO = 0x80;\n\n/**\n * Choose the reader for one input.\n *\n * Protocol 0 is printable text and has no header. Every binary protocol opens\n * with `PROTO`, which is the only opcode the text protocol cannot begin with,\n * so the first byte separates them without guessing - and the binary reader\n * then reads the declared version out of that same opcode.\n *\n * @param {ArrayBuffer|ArrayBufferView} input Pickle bytes.\n * @returns {Function} Reader class for the input.\n */\nfunction readerFor(input)\n{\n  const bytes = normalizeBytes(input);\n  return bytes.length && bytes[0] === PROTO\n    ? CjsPickleProtocol4Reader\n    : CjsPickleProtocol0Reader;\n}\n\n/**\n * Data-only Python pickle format facade that decodes the inert subset of\n * protocols 0 through 4 into JSON-compatible values or identity-preserving\n * payload graphs while rejecting callable and object-construction opcodes.\n */\nexport class CjsPickleFormat extends CjsFormat\n{\n  #values = DEFAULT_VALUES;\n\n  /**\n   * Create a reusable pickle format profile.\n   *\n   * @param {object} [options] Emit mode and bounded decoder limits.\n   */\n  constructor(options = {})\n  {\n    super();\n    this.SetValues(options);\n  }\n\n  /**\n   * Apply supported format options to this profile.\n   *\n   * @param {object} [options] Emit mode and partial decoder limits.\n   * @returns {CjsPickleFormat} This format profile.\n   */\n  SetValues(options = {})\n  {\n    this.#values = this.constructor.normalizeValues(this.#values, options);\n    return this;\n  }\n\n  /**\n   * Return normalized format values with optional per-call overrides.\n   *\n   * @param {object} [options] Per-call format options.\n   * @returns {object} Detached effective values.\n   */\n  GetValues(options = {})\n  {\n    return this.constructor.normalizeValues(this.#values, options);\n  }\n\n  /**\n   * Decode according to the effective emit mode.\n   *\n   * @param {ArrayBuffer|ArrayBufferView} input Pickle bytes.\n   * @param {object} [options] Per-call format options.\n   * @returns {*} Decoded value graph.\n   */\n  Read(input, options = {})\n  {\n    return CjsPickleFormat.read(input, this.GetValues(options));\n  }\n\n  /**\n   * Decode a JSON-compatible graph, rejecting cyclic memo references.\n   *\n   * @param {ArrayBuffer|ArrayBufferView} input Pickle bytes.\n   * @param {object} [options] Per-call format options.\n   * @returns {*} JSON-compatible decoded graph.\n   */\n  ReadJSON(input, options = {})\n  {\n    return CjsPickleFormat.readJSON(input, this.GetValues(options));\n  }\n\n  /**\n   * Decode the inert payload while preserving memo object identity.\n   *\n   * @param {ArrayBuffer|ArrayBufferView} input Pickle bytes.\n   * @param {object} [options] Per-call format options.\n   * @returns {*} Decoded payload graph.\n   */\n  ReadPayload(input, options = {})\n  {\n    return CjsPickleFormat.readPayload(input, this.GetValues(options));\n  }\n\n  /**\n   * Decode the exact inert graph while preserving memo aliases and cycles.\n   *\n   * @param {ArrayBuffer|ArrayBufferView} input Pickle bytes.\n   * @param {object} [options] Per-call format options.\n   * @returns {*} Decoded raw graph.\n   */\n  ReadRaw(input, options = {})\n  {\n    return CjsPickleFormat.readRaw(input, this.GetValues(options));\n  }\n\n  /**\n   * Verify that a decoded graph is JSON-compatible without changing its shape.\n   *\n   * @param {*} value Candidate decoded graph.\n   * @returns {*} The supplied value.\n   */\n  ToJSON(value)\n  {\n    return CjsPickleFormat.toJSON(value);\n  }\n\n  /**\n   * Decode according to the requested emit mode.\n   *\n   * @param {ArrayBuffer|ArrayBufferView} input Pickle bytes.\n   * @param {object} [options] Format options.\n   * @returns {*} Decoded value graph.\n   */\n  static read(input, options = {})\n  {\n    const values = this.normalizeValues(DEFAULT_VALUES, options);\n    if (values.emit === OUTPUT_RAW) return this.readRaw(input, values);\n    if (values.emit === OUTPUT_PAYLOAD) return this.readPayload(input, values);\n    return this.readJSON(input, values);\n  }\n\n  /**\n   * Decode a JSON-compatible graph through the implementation for its protocol.\n   *\n   * @param {ArrayBuffer|ArrayBufferView} input Pickle bytes.\n   * @param {object} [options] Format options.\n   * @returns {*} JSON-compatible decoded graph.\n   */\n  static readJSON(input, options = {})\n  {\n    const values = this.normalizeValues(DEFAULT_VALUES, options);\n    return new (readerFor(input))(input, values).ReadJSON();\n  }\n\n  /**\n   * Decode an inert payload while preserving pickle memo identity.\n   *\n   * @param {ArrayBuffer|ArrayBufferView} input Pickle bytes.\n   * @param {object} [options] Format options.\n   * @returns {*} Decoded payload graph.\n   */\n  static readPayload(input, options = {})\n  {\n    const values = this.normalizeValues(DEFAULT_VALUES, options);\n    return new (readerFor(input))(input, values).Read();\n  }\n\n  /**\n   * Decode the exact inert graph while preserving memo aliases and cycles.\n   *\n   * @param {ArrayBuffer|ArrayBufferView} input Pickle bytes.\n   * @param {object} [options] Format options.\n   * @returns {*} Decoded raw graph.\n   */\n  static readRaw(input, options = {})\n  {\n    return this.readPayload(input, options);\n  }\n\n  /**\n   * Verify that a decoded graph is JSON-compatible without changing its shape.\n   *\n   * @param {*} value Candidate decoded graph.\n   * @returns {*} The supplied value.\n   */\n  static toJSON(value)\n  {\n    return CjsPickleProtocol0Reader.ToJSON(value);\n  }\n\n  /** Validate pickle structure and return format metadata. */\n  static inspect(input, options = {})\n  {\n    const { source: _source, ...readOptions } = options;\n    const value = this.readPayload(input, readOptions);\n    const bytes = normalizeBytes(input);\n    const byteLength = bytes.byteLength;\n    return {\n      protocol: bytes.length && bytes[0] === PROTO ? bytes[1] : 0,\n      byteLength,\n      rootType: value === null ? \"null\" : Array.isArray(value) ? \"array\" : typeof value\n    };\n  }\n\n  /** Return synchronous advisory support from a bounded protocol-0 decode. */\n\n  /**\n   * Normalize a format profile and partial override into detached effective\n   * values.\n   *\n   * @param {object} base Existing normalized values.\n   * @param {object} [options] Partial emit and limit overrides.\n   * @returns {object} Detached normalized values.\n   */\n  static normalizeValues(base, options = {})\n  {\n    if (!options || typeof options !== \"object\" || Array.isArray(options))\n    {\n      throw new TypeError(\"CjsPickleFormat options must be an object.\");\n    }\n    for (const name of Object.keys(options))\n    {\n      if (!OPTION_NAMES.has(name))\n      {\n        throw new TypeError(`CjsPickleFormat unknown option ${JSON.stringify(name)}.`);\n      }\n    }\n\n    const emit = options.emit ?? base.emit;\n    if (!OUTPUTS.has(emit))\n    {\n      throw new TypeError(`CjsPickleFormat unknown emit value ${JSON.stringify(emit)}.`);\n    }\n\n    const baseLimits = base.limits || PICKLE_LIMITS;\n    const optionLimits = options.limits ?? {};\n    if (!optionLimits || typeof optionLimits !== \"object\" || Array.isArray(optionLimits))\n    {\n      throw new TypeError(\"CjsPickleFormat limits must be an object.\");\n    }\n\n    return {\n      emit,\n      limits: {\n        ...baseLimits,\n        ...optionLimits\n      }\n    };\n  }\n\n  static Output = Object.freeze({\n    JSON: OUTPUT_JSON,\n    PAYLOAD: OUTPUT_PAYLOAD,\n    RAW: OUTPUT_RAW\n  });\n  static supportedProtocols = Object.freeze([ 0, 1, 2, 3, 4 ]);\n  static id = \"pickle\";\n  static extensions = Object.freeze([ \".pickle\" ]);\n  static mediaTypes = Object.freeze([ \"data\" ]);\n  static outputs = CjsFormat.defineOutputs({\n      json: { default: true, decoded: true },\n      payload: { decoded: true },\n      raw: { role: \"debug\", decoded: true }\n  });\n}\n\nexport default CjsPickleFormat;\n"],"names":["OUTPUT_JSON","OUTPUT_PAYLOAD","OUTPUT_RAW","OUTPUTS","Set","OPTION_NAMES","DEFAULT_VALUES","emit","limits","PICKLE_LIMITS","PROTO","readerFor","input","bytes","normalizeBytes","length","CjsPickleProtocol4Reader","CjsPickleProtocol0Reader","CjsPickleFormat","CjsFormat","constructor","options","SetValues","normalizeValues","GetValues","Read","read","ReadJSON","readJSON","ReadPayload","readPayload","ReadRaw","readRaw","ToJSON","value","toJSON","values","inspect","source","_source","readOptions","byteLength","protocol","rootType","Array","isArray","base","TypeError","name","Object","keys","has","JSON","stringify","baseLimits","optionLimits","Output","freeze","PAYLOAD","RAW","supportedProtocols","id","extensions","mediaTypes","outputs","defineOutputs","json","default","decoded","payload","raw","role"],"mappings":"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"}