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

package/dist/resource/format/imageSignatures.js

@@ -0,0 +1,202 @@
+import { readU32LE, readU16LE } from '#utils/bytes';
+
+// Image container identification, once.
+//
+// WHY THIS EXISTS. Each of the four raster formats that share an inspection
+// surface — png, jpeg, tga, dds — carried a copy of ALL FOUR magic-number
+// sniffers and ALL FOUR header inspectors, so each of the eight functions
+// existed four times. That is not a shared module anyone forgot to write; it is
+// the same code pasted into four neighbours, and it had already started to drift
+// in exactly the way that predicts.
+//
+// WHAT THE FOREIGN COPIES ACTUALLY DID, measured rather than assumed. Every
+// format's `inspectBytes` dispatched across all four sniffers, so the foreign
+// code genuinely ran. But every caller passes its own format id as
+// `expectedType`, and a detected foreign format throws immediately. So of
+// everything a foreign inspector computed — width, height, mip count, fourCC,
+// colour type — the ONLY value that ever escaped was the format NAME, used in
+// the mismatch message. Identification is all that was ever needed; the other
+// three inspectors were decoding headers so their results could be discarded.
+//
+// THE DRIFT THIS REMOVES, and it changes behaviour, deliberately. Two sniffers
+// had grown stricter or wider in their OWNING format only:
+//
+//   - `isDDS` also checks that the header-size field reads 124. The three
+//     foreign copies check the magic alone.
+//   - `isTGA` accepts 15 bits per pixel. The three foreign copies accept only
+//     8, 16, 24 and 32, so a 15-bpp TGA was detected by the tga reader and
+//     invisible to the other three.
+//
+// The owning copy is the maintained one, so this module keeps both, and the
+// consequence is that all four readers now identify a 15-bpp TGA and a
+// malformed-header DDS the same way. That is the point of having one
+// implementation, but it IS a change and is recorded here rather than absorbed
+// silently.
+//
+// An inspector is NOT here. Each format keeps its own, because that one is real
+// work on a container the format owns.
+
+
+/** Media type per identified container. */
+const IMAGE_MIME_TYPES = Object.freeze({
+  png: "image/png",
+  jpeg: "image/jpeg",
+  jpg: "image/jpeg",
+  tga: "image/x-tga",
+  dds: "image/vnd-ms.dds"
+});
+
+/** Byte length of the DDS header that follows the four-byte magic. */
+const DDS_HEADER_SIZE = 124;
+
+/**
+ * True when `bytes` opens with the eight-byte PNG signature.
+ *
+ * The length floor is 24, not 8: the signature alone is not a PNG, and every
+ * caller goes straight on to read the IHDR that must follow it.
+ *
+ * @param {Uint8Array} bytes Candidate bytes.
+ * @returns {boolean} Whether the signature matches.
+ */
+function isPNG(bytes) {
+  return bytes.byteLength >= 24 && bytes[0] === 0x89 && bytes[1] === 0x50 && bytes[2] === 0x4e && bytes[3] === 0x47 && bytes[4] === 0x0d && bytes[5] === 0x0a && bytes[6] === 0x1a && bytes[7] === 0x0a;
+}
+
+/**
+ * True when `bytes` opens with the JPEG start-of-image marker.
+ *
+ * @param {Uint8Array} bytes Candidate bytes.
+ * @returns {boolean} Whether the marker matches.
+ */
+function isJPEG(bytes) {
+  return bytes.byteLength >= 4 && bytes[0] === 0xff && bytes[1] === 0xd8;
+}
+
+/**
+ * True when `bytes` opens with the DDS magic AND a well-formed header size.
+ *
+ * The size check is what separates this from a bare magic test: `DDS ` followed
+ * by anything is not a DDS file, and accepting it sends a caller into a header
+ * parse that cannot succeed.
+ *
+ * @param {Uint8Array} bytes Candidate bytes.
+ * @returns {boolean} Whether the container is DDS.
+ */
+function isDDS(bytes) {
+  return bytes.byteLength >= DDS_HEADER_SIZE + 4 && bytes[0] === 0x44 && bytes[1] === 0x44 && bytes[2] === 0x53 && bytes[3] === 0x20 && readU32LE(bytes, 4) === DDS_HEADER_SIZE;
+}
+
+/**
+ * True when `bytes` plausibly opens a TGA.
+ *
+ * TGA has no magic number, so this is a heuristic over the 18-byte header:
+ * a known image type, non-zero extent, and a supported pixel depth. It is
+ * therefore the LAST thing to test, after every format that can prove itself.
+ *
+ * @param {Uint8Array} bytes Candidate bytes.
+ * @returns {boolean} Whether the header is a plausible TGA.
+ */
+function isTGA(bytes) {
+  if (bytes.byteLength < 18) return false;
+  const imageType = bytes[2],
+    width = readU16LE(bytes, 12),
+    height = readU16LE(bytes, 14),
+    bpp = bytes[16];
+  return width > 0 && height > 0 && [1, 2, 3, 9, 10, 11].includes(imageType) && [8, 15, 16, 24, 32].includes(bpp);
+}
+
+/**
+ * Name the raster container `bytes` holds.
+ *
+ * Order matters and is not alphabetical: the formats that can PROVE themselves
+ * from a signature go first, and TGA — which can only be guessed at — goes last.
+ *
+ * @param {Uint8Array} bytes Candidate bytes.
+ * @returns {string} `"png"`, `"jpeg"`, `"dds"`, `"tga"`, or `""` when unknown.
+ */
+function identifyImageBytes(bytes) {
+  if (isPNG(bytes)) return "png";
+  if (isJPEG(bytes)) return "jpeg";
+  if (isDDS(bytes)) return "dds";
+  if (isTGA(bytes)) return "tga";
+  return "";
+}
+
+/**
+ * The minimal inspection record for a container this reader does not own.
+ *
+ * A reader asked to inspect a foreign container needs only to be able to say
+ * which one it is; its caller rejects the mismatch before anything reads the
+ * extent. Returning zeroes rather than a decoded foreign header is what makes
+ * the other three inspectors deletable.
+ *
+ * @param {string} sourceFormat Identified container name, or `""`.
+ * @returns {{sourceFormat: string, width: number, height: number}} The record.
+ */
+function foreignImageRecord(sourceFormat) {
+  return {
+    sourceFormat,
+    width: 0,
+    height: 0
+  };
+}
+
+/**
+ * Media type for an identified container.
+ *
+ * @param {string} sourceFormat Identified container name.
+ * @returns {string} Media type, or the generic binary type when unknown.
+ */
+function imageMimeType(sourceFormat) {
+  return IMAGE_MIME_TYPES[sourceFormat] || "application/octet-stream";
+}
+
+/**
+ * Channel count for a PNG colour type.
+ *
+ * Lives here rather than in the PNG reader because the shared inspection record
+ * reports it, and three neighbours held a copy for that reason alone.
+ *
+ * @param {number} colorType PNG IHDR colour type.
+ * @returns {number} Channels per pixel, or 0 when the colour type is invalid.
+ */
+function pngChannels(colorType) {
+  if (colorType === 0) return 1;
+  if (colorType === 2) return 3;
+  if (colorType === 3) return 1;
+  if (colorType === 4) return 2;
+  if (colorType === 6) return 4;
+  return 0;
+}
+
+/**
+ * The `raw` support variant every image reader offers.
+ *
+ * Handing back the undecoded bytes always works, so this entry is unconditional
+ * and identical across the family.
+ *
+ * @param {object} metadata Inspection record carrying `sourceFormat`.
+ * @returns {object} The raw variant descriptor.
+ */
+function rawVariant(metadata) {
+  return {
+    kind: "raw",
+    payloadType: "raw",
+    codec: metadata.sourceFormat,
+    mimeType: imageMimeType(metadata.sourceFormat),
+    supported: true
+  };
+}
+
+/**
+ * Capitalize a format id for an error message, defaulting to `"Image"`.
+ *
+ * @param {string} value Format id.
+ * @returns {string} Capitalized name.
+ */
+function capitalizeFormatId(value) {
+  return value ? value[0].toUpperCase() + value.slice(1) : "Image";
+}
+
+export { capitalizeFormatId, foreignImageRecord, identifyImageBytes, imageMimeType, isDDS, isJPEG, isPNG, isTGA, pngChannels, rawVariant };
+//# sourceMappingURL=imageSignatures.js.map

package/dist/resource/format/imageSignatures.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"imageSignatures.js","sources":["../../../../src/resource/format/imageSignatures.js"],"sourcesContent":["// Image container identification, once.\n//\n// WHY THIS EXISTS. Each of the four raster formats that share an inspection\n// surface — png, jpeg, tga, dds — carried a copy of ALL FOUR magic-number\n// sniffers and ALL FOUR header inspectors, so each of the eight functions\n// existed four times. That is not a shared module anyone forgot to write; it is\n// the same code pasted into four neighbours, and it had already started to drift\n// in exactly the way that predicts.\n//\n// WHAT THE FOREIGN COPIES ACTUALLY DID, measured rather than assumed. Every\n// format's `inspectBytes` dispatched across all four sniffers, so the foreign\n// code genuinely ran. But every caller passes its own format id as\n// `expectedType`, and a detected foreign format throws immediately. So of\n// everything a foreign inspector computed — width, height, mip count, fourCC,\n// colour type — the ONLY value that ever escaped was the format NAME, used in\n// the mismatch message. Identification is all that was ever needed; the other\n// three inspectors were decoding headers so their results could be discarded.\n//\n// THE DRIFT THIS REMOVES, and it changes behaviour, deliberately. Two sniffers\n// had grown stricter or wider in their OWNING format only:\n//\n//   - `isDDS` also checks that the header-size field reads 124. The three\n//     foreign copies check the magic alone.\n//   - `isTGA` accepts 15 bits per pixel. The three foreign copies accept only\n//     8, 16, 24 and 32, so a 15-bpp TGA was detected by the tga reader and\n//     invisible to the other three.\n//\n// The owning copy is the maintained one, so this module keeps both, and the\n// consequence is that all four readers now identify a 15-bpp TGA and a\n// malformed-header DDS the same way. That is the point of having one\n// implementation, but it IS a change and is recorded here rather than absorbed\n// silently.\n//\n// An inspector is NOT here. Each format keeps its own, because that one is real\n// work on a container the format owns.\n\nimport { readU16LE, readU32LE } from \"#utils/bytes\";\n\n/** Media type per identified container. */\nconst IMAGE_MIME_TYPES = Object.freeze({\n    png: \"image/png\",\n    jpeg: \"image/jpeg\",\n    jpg: \"image/jpeg\",\n    tga: \"image/x-tga\",\n    dds: \"image/vnd-ms.dds\"\n});\n\n/** Byte length of the DDS header that follows the four-byte magic. */\nconst DDS_HEADER_SIZE = 124;\n\n/**\n * True when `bytes` opens with the eight-byte PNG signature.\n *\n * The length floor is 24, not 8: the signature alone is not a PNG, and every\n * caller goes straight on to read the IHDR that must follow it.\n *\n * @param {Uint8Array} bytes Candidate bytes.\n * @returns {boolean} Whether the signature matches.\n */\nexport function isPNG(bytes)\n{\n    return bytes.byteLength >= 24 &&\n        bytes[0] === 0x89 && bytes[1] === 0x50 && bytes[2] === 0x4e && bytes[3] === 0x47 &&\n        bytes[4] === 0x0d && bytes[5] === 0x0a && bytes[6] === 0x1a && bytes[7] === 0x0a;\n}\n\n/**\n * True when `bytes` opens with the JPEG start-of-image marker.\n *\n * @param {Uint8Array} bytes Candidate bytes.\n * @returns {boolean} Whether the marker matches.\n */\nexport function isJPEG(bytes)\n{\n    return bytes.byteLength >= 4 && bytes[0] === 0xff && bytes[1] === 0xd8;\n}\n\n/**\n * True when `bytes` opens with the DDS magic AND a well-formed header size.\n *\n * The size check is what separates this from a bare magic test: `DDS ` followed\n * by anything is not a DDS file, and accepting it sends a caller into a header\n * parse that cannot succeed.\n *\n * @param {Uint8Array} bytes Candidate bytes.\n * @returns {boolean} Whether the container is DDS.\n */\nexport function isDDS(bytes)\n{\n    return bytes.byteLength >= DDS_HEADER_SIZE + 4 &&\n        bytes[0] === 0x44 && bytes[1] === 0x44 && bytes[2] === 0x53 && bytes[3] === 0x20 &&\n        readU32LE(bytes, 4) === DDS_HEADER_SIZE;\n}\n\n/**\n * True when `bytes` plausibly opens a TGA.\n *\n * TGA has no magic number, so this is a heuristic over the 18-byte header:\n * a known image type, non-zero extent, and a supported pixel depth. It is\n * therefore the LAST thing to test, after every format that can prove itself.\n *\n * @param {Uint8Array} bytes Candidate bytes.\n * @returns {boolean} Whether the header is a plausible TGA.\n */\nexport function isTGA(bytes)\n{\n    if (bytes.byteLength < 18) return false;\n\n    const\n        imageType = bytes[2],\n        width = readU16LE(bytes, 12),\n        height = readU16LE(bytes, 14),\n        bpp = bytes[16];\n\n    return width > 0 && height > 0 &&\n        [ 1, 2, 3, 9, 10, 11 ].includes(imageType) &&\n        [ 8, 15, 16, 24, 32 ].includes(bpp);\n}\n\n/**\n * Name the raster container `bytes` holds.\n *\n * Order matters and is not alphabetical: the formats that can PROVE themselves\n * from a signature go first, and TGA — which can only be guessed at — goes last.\n *\n * @param {Uint8Array} bytes Candidate bytes.\n * @returns {string} `\"png\"`, `\"jpeg\"`, `\"dds\"`, `\"tga\"`, or `\"\"` when unknown.\n */\nexport function identifyImageBytes(bytes)\n{\n    if (isPNG(bytes)) return \"png\";\n    if (isJPEG(bytes)) return \"jpeg\";\n    if (isDDS(bytes)) return \"dds\";\n    if (isTGA(bytes)) return \"tga\";\n    return \"\";\n}\n\n/**\n * The minimal inspection record for a container this reader does not own.\n *\n * A reader asked to inspect a foreign container needs only to be able to say\n * which one it is; its caller rejects the mismatch before anything reads the\n * extent. Returning zeroes rather than a decoded foreign header is what makes\n * the other three inspectors deletable.\n *\n * @param {string} sourceFormat Identified container name, or `\"\"`.\n * @returns {{sourceFormat: string, width: number, height: number}} The record.\n */\nexport function foreignImageRecord(sourceFormat)\n{\n    return { sourceFormat, width: 0, height: 0 };\n}\n\n/**\n * Media type for an identified container.\n *\n * @param {string} sourceFormat Identified container name.\n * @returns {string} Media type, or the generic binary type when unknown.\n */\nexport function imageMimeType(sourceFormat)\n{\n    return IMAGE_MIME_TYPES[sourceFormat] || \"application/octet-stream\";\n}\n\n/**\n * Channel count for a PNG colour type.\n *\n * Lives here rather than in the PNG reader because the shared inspection record\n * reports it, and three neighbours held a copy for that reason alone.\n *\n * @param {number} colorType PNG IHDR colour type.\n * @returns {number} Channels per pixel, or 0 when the colour type is invalid.\n */\nexport function pngChannels(colorType)\n{\n    if (colorType === 0) return 1;\n    if (colorType === 2) return 3;\n    if (colorType === 3) return 1;\n    if (colorType === 4) return 2;\n    if (colorType === 6) return 4;\n    return 0;\n}\n\n/**\n * The `raw` support variant every image reader offers.\n *\n * Handing back the undecoded bytes always works, so this entry is unconditional\n * and identical across the family.\n *\n * @param {object} metadata Inspection record carrying `sourceFormat`.\n * @returns {object} The raw variant descriptor.\n */\nexport function rawVariant(metadata)\n{\n    return {\n        kind: \"raw\",\n        payloadType: \"raw\",\n        codec: metadata.sourceFormat,\n        mimeType: imageMimeType(metadata.sourceFormat),\n        supported: true\n    };\n}\n\n/**\n * Capitalize a format id for an error message, defaulting to `\"Image\"`.\n *\n * @param {string} value Format id.\n * @returns {string} Capitalized name.\n */\nexport function capitalizeFormatId(value)\n{\n    return value ? value[0].toUpperCase() + value.slice(1) : \"Image\";\n}\n"],"names":["IMAGE_MIME_TYPES","Object","freeze","png","jpeg","jpg","tga","dds","DDS_HEADER_SIZE","isPNG","bytes","byteLength","isJPEG","isDDS","readU32LE","isTGA","imageType","width","readU16LE","height","bpp","includes","identifyImageBytes","foreignImageRecord","sourceFormat","imageMimeType","pngChannels","colorType","rawVariant","metadata","kind","payloadType","codec","mimeType","supported","capitalizeFormatId","value","toUpperCase","slice"],"mappings":"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"}

package/dist/resource/format/index.js

@@ -1,6 +1,7 @@
 export { CjsReader } from './CjsReader.js';
-export { CjsFormatReadError, CjsFormatWriteError } from './CjsFormatError.js';
+export { CjsFormatRangeError, CjsFormatReadError, CjsFormatWriteError } from './CjsFormatError.js';
 export { CjsByteReader } from './CjsByteReader.js';
+export { CjsBitReader, readBitAt, readBitsAt } from './CjsBitReader.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_EFFECT_WRITE_VERSIONS, CARBON_SHADER_CONSTANTS_MAX, collectArena, compareAnnotationNames, internArena, passthroughArena, readEffectDescription, resolveWriteVersion, writeEffectDescription } from './carbonEffect/carbonEffectRecords.js';

package/dist/resource/format/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;"}
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;"}

package/dist/resource/format/jsonPolicies.js

@@ -0,0 +1,180 @@
+// How a format's decoded record becomes JSON. Four policies, not one function.
+//
+// Twenty-seven formats each declared a local `toJsonValue`, and the obvious
+// reading — twenty-seven copies of one helper — is wrong. They fall into four
+// groups that give CONTRADICTORY output for the same input, and the contradiction
+// is deliberate in every case. Collapsing them into one function with flags would
+// have picked one group's answer and silently changed the other three.
+//
+// THE AXIS THEY DISAGREE ON IS BINARY DATA:
+//
+//   - A media or container reader is describing a file. Its `Uint8Array` is the
+//     pixel or sample payload, often megabytes, and expanding it into a JSON
+//     array produces an unreadable document nobody wanted. It reports the LENGTH.
+//   - A geometry reader's typed arrays ARE the answer — vertices, indices, UVs.
+//     Summarising them to a byte count throws away the document.
+//
+// Both are right for their own reader, which is why this file has two of them.
+//
+// The remaining two are the first policy's shape plus a capability its callers
+// genuinely need: shader reflection carries `Map`, `Set` and `bigint`, and the
+// Blue object graphs can contain cycles that must be refused rather than
+// recursed into forever.
+//
+// TWO FORMATS DELIBERATELY KEEP THEIR OWN. `formats/fbx` renders a typed array as
+// `{ type, length }` — naming the constructor, because an FBX array property's
+// declared element type is a fact about the file worth reporting — and
+// `formats/cmf` sits between two policies here. Neither has a second caller, so
+// neither is a policy.
+//
+// No Carbon donor: Carbon persists through Blue, not JSON, so there is nothing
+// here to port and nothing here claims to be a port.
+
+/**
+ * Convert a decoded record to JSON, reporting binary payloads by length.
+ *
+ * For readers whose `Uint8Array` is the file's bulk data rather than its
+ * description: audio, video, images, and the Wwise containers. A byte array
+ * becomes `{ byteLength }`.
+ *
+ * Note the check is `instanceof Uint8Array`, not `ArrayBuffer.isView` — so a
+ * `Float32Array` falls through to the object branch and serialises by index.
+ * That is the inherited behaviour of all fifteen callers, preserved rather than
+ * quietly improved, because these records are compared in tests.
+ *
+ * @param {*} value Any decoded value.
+ * @returns {*} A JSON-safe value.
+ */
+function toJsonWithByteSummary(value) {
+  if (value instanceof Uint8Array) return {
+    byteLength: value.byteLength
+  };
+  if (Array.isArray(value)) return value.map(toJsonWithByteSummary);
+  if (value && typeof value === "object") {
+    const output = {};
+    for (const [key, entry] of Object.entries(value)) output[key] = toJsonWithByteSummary(entry);
+    return output;
+  }
+  return value;
+}
+
+/**
+ * Convert a decoded record to JSON, expanding typed arrays into values.
+ *
+ * For the geometry interchange readers, where the typed arrays are the document.
+ * `DataView` is excluded because it is a window onto bytes rather than a
+ * sequence of values.
+ *
+ * @param {*} value Any decoded value.
+ * @returns {*} A JSON-safe value.
+ */
+function toJsonWithArrayValues(value) {
+  if (value === null || value === undefined) return value;
+  if (typeof value !== "object") return value;
+  if (typeof value.toJSON === "function") {
+    const next = value.toJSON();
+    if (next !== value) return toJsonWithArrayValues(next);
+  }
+  if (Array.isArray(value)) return value.map(toJsonWithArrayValues);
+  if (ArrayBuffer.isView(value) && !(value instanceof DataView)) return Array.from(value);
+  const out = {};
+  for (const key of Object.keys(value)) {
+    out[key] = toJsonWithArrayValues(value[key]);
+  }
+  return out;
+}
+
+/**
+ * Convert a decoded record to JSON, handling collections and big integers.
+ *
+ * For the shader readers, whose reflection graphs hold `Map` and `Set` and whose
+ * register and hash values exceed the safe integer range. A `bigint` becomes a
+ * STRING, deliberately: JSON has no integer wide enough, and a number would lose
+ * digits without saying so.
+ *
+ * Anything it cannot represent — a function, a symbol — becomes `null` rather
+ * than being passed through, so the output is always serialisable.
+ *
+ * @param {*} value Any decoded value.
+ * @returns {*} A JSON-safe value.
+ */
+function toJsonWithCollections(value) {
+  if (value === null || value === undefined) return value ?? null;
+  if (typeof value === "number" || typeof value === "string" || typeof value === "boolean") return value;
+  if (typeof value === "bigint") return value.toString();
+  if (ArrayBuffer.isView(value)) return Array.from(value);
+  if (Array.isArray(value)) return value.map(toJsonWithCollections);
+  if (value instanceof Map) {
+    const out = {};
+    for (const [key, entry] of value) out[key] = toJsonWithCollections(entry);
+    return out;
+  }
+  if (value instanceof Set) return Array.from(value, toJsonWithCollections);
+  if (typeof value === "object") {
+    if (typeof value.toJSON === "function") return toJsonWithCollections(value.toJSON());
+    const out = {};
+    for (const key of Object.keys(value)) out[key] = toJsonWithCollections(value[key]);
+    return out;
+  }
+  return null;
+}
+
+/**
+ * Convert a decoded record to JSON, refusing a cycle.
+ *
+ * For the Blue graph transports, whose documents legitimately contain object
+ * references and can therefore contain a loop. A cycle THROWS rather than being
+ * pruned, because a silently truncated graph is indistinguishable from a graph
+ * that was genuinely that shape.
+ *
+ * The guard is released on the way back out, so a node reachable twice by
+ * different paths is not mistaken for a cycle.
+ *
+ * @param {*} value Any decoded value.
+ * @param {string} [label] Name used in the cycle error, identifying the reader.
+ * @param {WeakSet} [seen] Ancestors on the current path; supplied by recursion.
+ * @returns {*} A JSON-safe value.
+ * @throws {TypeError} The value contains a cycle.
+ */
+function toJsonAcyclic(value, label = "Reader", seen = new WeakSet()) {
+  if (value === null || typeof value !== "object") return value;
+
+  // A typed array cannot hold a reference, so it cannot take part in a cycle
+  // and needs no guard. It is tested before the guard for that reason only.
+  if (ArrayBuffer.isView(value)) return Array.from(value, item => toJsonAcyclic(item, label, seen));
+
+  // THE CYCLE CHECK MUST PRECEDE THE ARRAY BRANCH. It did not in the three
+  // readers this policy replaced (black, red and gr2 were identical here): the
+  // array branch returned before `seen` was ever consulted, so a cycle reached
+  // through an array — `list.push(list)` — recursed until the stack overflowed
+  // and raised `RangeError: Maximum call stack size exceeded` instead of the
+  // intended `TypeError`. Fixed here rather than reproduced: this policy is
+  // CarbonEngineJS's own (Carbon persists through Blue, not JSON), so there is
+  // no donor behaviour to stay faithful to, and nothing can depend on the shape
+  // of a stack overflow.
+  if (seen.has(value)) {
+    throw new TypeError(`${label}.toJSON cannot convert circular data`);
+  }
+  if (Array.isArray(value)) {
+    seen.add(value);
+    const out = value.map(item => toJsonAcyclic(item, label, seen));
+    seen.delete(value);
+    return out;
+  }
+  if (typeof value.toJSON === "function") {
+    seen.add(value);
+    const json = toJsonAcyclic(value.toJSON(), label, seen);
+    seen.delete(value);
+    return json;
+  }
+  seen.add(value);
+  const out = {};
+  for (const key of Object.keys(value)) {
+    out[key] = toJsonAcyclic(value[key], label, seen);
+  }
+  seen.delete(value);
+  return out;
+}
+
+export { toJsonAcyclic, toJsonWithArrayValues, toJsonWithByteSummary, toJsonWithCollections };
+//# sourceMappingURL=jsonPolicies.js.map

package/dist/resource/format/jsonPolicies.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonPolicies.js","sources":["../../../../src/resource/format/jsonPolicies.js"],"sourcesContent":["// How a format's decoded record becomes JSON. Four policies, not one function.\n//\n// Twenty-seven formats each declared a local `toJsonValue`, and the obvious\n// reading — twenty-seven copies of one helper — is wrong. They fall into four\n// groups that give CONTRADICTORY output for the same input, and the contradiction\n// is deliberate in every case. Collapsing them into one function with flags would\n// have picked one group's answer and silently changed the other three.\n//\n// THE AXIS THEY DISAGREE ON IS BINARY DATA:\n//\n//   - A media or container reader is describing a file. Its `Uint8Array` is the\n//     pixel or sample payload, often megabytes, and expanding it into a JSON\n//     array produces an unreadable document nobody wanted. It reports the LENGTH.\n//   - A geometry reader's typed arrays ARE the answer — vertices, indices, UVs.\n//     Summarising them to a byte count throws away the document.\n//\n// Both are right for their own reader, which is why this file has two of them.\n//\n// The remaining two are the first policy's shape plus a capability its callers\n// genuinely need: shader reflection carries `Map`, `Set` and `bigint`, and the\n// Blue object graphs can contain cycles that must be refused rather than\n// recursed into forever.\n//\n// TWO FORMATS DELIBERATELY KEEP THEIR OWN. `formats/fbx` renders a typed array as\n// `{ type, length }` — naming the constructor, because an FBX array property's\n// declared element type is a fact about the file worth reporting — and\n// `formats/cmf` sits between two policies here. Neither has a second caller, so\n// neither is a policy.\n//\n// No Carbon donor: Carbon persists through Blue, not JSON, so there is nothing\n// here to port and nothing here claims to be a port.\n\n/**\n * Convert a decoded record to JSON, reporting binary payloads by length.\n *\n * For readers whose `Uint8Array` is the file's bulk data rather than its\n * description: audio, video, images, and the Wwise containers. A byte array\n * becomes `{ byteLength }`.\n *\n * Note the check is `instanceof Uint8Array`, not `ArrayBuffer.isView` — so a\n * `Float32Array` falls through to the object branch and serialises by index.\n * That is the inherited behaviour of all fifteen callers, preserved rather than\n * quietly improved, because these records are compared in tests.\n *\n * @param {*} value Any decoded value.\n * @returns {*} A JSON-safe value.\n */\nexport function toJsonWithByteSummary(value)\n{\n    if (value instanceof Uint8Array) return { byteLength: value.byteLength };\n    if (Array.isArray(value)) return value.map(toJsonWithByteSummary);\n    if (value && typeof value === \"object\")\n    {\n        const output = {};\n        for (const [ key, entry ] of Object.entries(value)) output[key] = toJsonWithByteSummary(entry);\n        return output;\n    }\n    return value;\n}\n\n/**\n * Convert a decoded record to JSON, expanding typed arrays into values.\n *\n * For the geometry interchange readers, where the typed arrays are the document.\n * `DataView` is excluded because it is a window onto bytes rather than a\n * sequence of values.\n *\n * @param {*} value Any decoded value.\n * @returns {*} A JSON-safe value.\n */\nexport function toJsonWithArrayValues(value)\n{\n    if (value === null || value === undefined) return value;\n    if (typeof value !== \"object\") return value;\n\n    if (typeof value.toJSON === \"function\")\n    {\n        const next = value.toJSON();\n        if (next !== value) return toJsonWithArrayValues(next);\n    }\n\n    if (Array.isArray(value)) return value.map(toJsonWithArrayValues);\n    if (ArrayBuffer.isView(value) && !(value instanceof DataView)) return Array.from(value);\n\n    const out = {};\n    for (const key of Object.keys(value))\n    {\n        out[key] = toJsonWithArrayValues(value[key]);\n    }\n    return out;\n}\n\n/**\n * Convert a decoded record to JSON, handling collections and big integers.\n *\n * For the shader readers, whose reflection graphs hold `Map` and `Set` and whose\n * register and hash values exceed the safe integer range. A `bigint` becomes a\n * STRING, deliberately: JSON has no integer wide enough, and a number would lose\n * digits without saying so.\n *\n * Anything it cannot represent — a function, a symbol — becomes `null` rather\n * than being passed through, so the output is always serialisable.\n *\n * @param {*} value Any decoded value.\n * @returns {*} A JSON-safe value.\n */\nexport function toJsonWithCollections(value)\n{\n    if (value === null || value === undefined) return value ?? null;\n    if (typeof value === \"number\" || typeof value === \"string\" || typeof value === \"boolean\") return value;\n    if (typeof value === \"bigint\") return value.toString();\n    if (ArrayBuffer.isView(value)) return Array.from(value);\n    if (Array.isArray(value)) return value.map(toJsonWithCollections);\n    if (value instanceof Map)\n    {\n        const out = {};\n        for (const [ key, entry ] of value) out[key] = toJsonWithCollections(entry);\n        return out;\n    }\n    if (value instanceof Set) return Array.from(value, toJsonWithCollections);\n    if (typeof value === \"object\")\n    {\n        if (typeof value.toJSON === \"function\") return toJsonWithCollections(value.toJSON());\n        const out = {};\n        for (const key of Object.keys(value)) out[key] = toJsonWithCollections(value[key]);\n        return out;\n    }\n    return null;\n}\n\n/**\n * Convert a decoded record to JSON, refusing a cycle.\n *\n * For the Blue graph transports, whose documents legitimately contain object\n * references and can therefore contain a loop. A cycle THROWS rather than being\n * pruned, because a silently truncated graph is indistinguishable from a graph\n * that was genuinely that shape.\n *\n * The guard is released on the way back out, so a node reachable twice by\n * different paths is not mistaken for a cycle.\n *\n * @param {*} value Any decoded value.\n * @param {string} [label] Name used in the cycle error, identifying the reader.\n * @param {WeakSet} [seen] Ancestors on the current path; supplied by recursion.\n * @returns {*} A JSON-safe value.\n * @throws {TypeError} The value contains a cycle.\n */\nexport function toJsonAcyclic(value, label = \"Reader\", seen = new WeakSet())\n{\n    if (value === null || typeof value !== \"object\") return value;\n\n    // A typed array cannot hold a reference, so it cannot take part in a cycle\n    // and needs no guard. It is tested before the guard for that reason only.\n    if (ArrayBuffer.isView(value)) return Array.from(value, item => toJsonAcyclic(item, label, seen));\n\n    // THE CYCLE CHECK MUST PRECEDE THE ARRAY BRANCH. It did not in the three\n    // readers this policy replaced (black, red and gr2 were identical here): the\n    // array branch returned before `seen` was ever consulted, so a cycle reached\n    // through an array — `list.push(list)` — recursed until the stack overflowed\n    // and raised `RangeError: Maximum call stack size exceeded` instead of the\n    // intended `TypeError`. Fixed here rather than reproduced: this policy is\n    // CarbonEngineJS's own (Carbon persists through Blue, not JSON), so there is\n    // no donor behaviour to stay faithful to, and nothing can depend on the shape\n    // of a stack overflow.\n    if (seen.has(value))\n    {\n        throw new TypeError(`${label}.toJSON cannot convert circular data`);\n    }\n\n    if (Array.isArray(value))\n    {\n        seen.add(value);\n        const out = value.map(item => toJsonAcyclic(item, label, seen));\n        seen.delete(value);\n        return out;\n    }\n\n    if (typeof value.toJSON === \"function\")\n    {\n        seen.add(value);\n        const json = toJsonAcyclic(value.toJSON(), label, seen);\n        seen.delete(value);\n        return json;\n    }\n\n    seen.add(value);\n    const out = {};\n    for (const key of Object.keys(value))\n    {\n        out[key] = toJsonAcyclic(value[key], label, seen);\n    }\n    seen.delete(value);\n    return out;\n}\n"],"names":["toJsonWithByteSummary","value","Uint8Array","byteLength","Array","isArray","map","output","key","entry","Object","entries","toJsonWithArrayValues","undefined","toJSON","next","ArrayBuffer","isView","DataView","from","out","keys","toJsonWithCollections","toString","Map","Set","toJsonAcyclic","label","seen","WeakSet","item","has","TypeError","add","delete","json"],"mappings":"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"}

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

@@ -1,3 +1,4 @@
+import { toJsonAcyclic } from '../../../format/jsonPolicies.js';
 import { classes } from './blackDefinitions.js';
 
 const OUTPUT_JSON = "json";
@@ -95,9 +96,9 @@ function validateClassKey(classKeys, key, readerName) {
   }
 }
 
-/**
- * Validates a resolved runtime class constructor for the Black object-graph
- * reader.
+/**
+ * Validates a resolved runtime class constructor for the Black object-graph
+ * reader.
  */
 function validateClass(classKeys, type, Class, readerName) {
   validateClassKey(classKeys, type, readerName);
@@ -119,9 +120,9 @@ function mergeClasses(values, classes, classKeys, readerName) {
   values.classes = next;
 }
 
-/**
- * Normalizes reader options against their supported defaults for the Black
- * object-graph reader.
+/**
+ * Normalizes reader options against their supported defaults for the Black
+ * object-graph reader.
  */
 function normalizeValues(base, options, classKeys, readerName) {
   if (!options || typeof options !== "object") {
@@ -163,30 +164,18 @@ function normalizeValues(base, options, classKeys, readerName) {
   return values;
 }
 
-/**
- * Converts a parsed payload into a JSON-safe value for the Black object-graph
- * reader.
+/**
+ * Converts a parsed payload into a JSON-safe value for the Black object-graph
+ * reader.
  */
-function toJsonValue(value, seen = new WeakSet()) {
-  if (value === null || typeof value !== "object") return value;
-  if (ArrayBuffer.isView(value)) return Array.from(value, item => toJsonValue(item, seen));
-  if (Array.isArray(value)) return value.map(item => toJsonValue(item, seen));
-  if (seen.has(value)) {
-    throw new TypeError("Reader.toJSON cannot convert circular data");
-  }
-  if (typeof value.toJSON === "function") {
-    seen.add(value);
-    const json = toJsonValue(value.toJSON(), seen);
-    seen.delete(value);
-    return json;
-  }
-  seen.add(value);
-  const out = {};
-  for (const key of Object.keys(value)) {
-    out[key] = toJsonValue(value[key], seen);
-  }
-  seen.delete(value);
-  return out;
+/**
+ * Convert to JSON, refusing a cycle, naming this reader in the error.
+ *
+ * @param {*} value Any decoded value.
+ * @returns {*} A JSON-safe value.
+ */
+function toJsonValue(value) {
+  return toJsonAcyclic(value, "Reader");
 }
 
 export { DEFAULT_VALUES, OUTPUT_DOCUMENT, OUTPUT_JSON, OUTPUT_PAYLOAD, OUTPUT_RAW, OUTPUT_RUNTIME, normalizeValues, toJsonValue, validateClass, validateClassKey };

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

@@ -1 +1 @@
-{"version":3,"file":"helpers.js","sources":["../../../../../../src/resource/formats/black/core/helpers.js"],"sourcesContent":["import blackDefinitions from \"./blackSchema.js\";\r\n\r\nexport const OUTPUT_JSON = \"json\";\r\nexport const OUTPUT_RAW = \"raw\";\r\nexport const OUTPUT_DOCUMENT = \"document\";\r\nexport const OUTPUT_PAYLOAD = \"payload\";\r\nexport const OUTPUT_RUNTIME = \"runtime\";\r\n\r\nexport const DEFAULT_VALUES = Object.freeze({\r\n    emit: OUTPUT_JSON,\r\n    schema: blackDefinitions,\r\n    registry: null,\r\n    sourceShapes: null,\r\n    rootName: \"default\",\r\n    firstId: 1,\r\n    metadata: null,\r\n    includeMetadata: false,\r\n    includeClassMetadata: false,\r\n    includeFieldTrace: false,\r\n    includeRefIndex: false,\r\n    trace: false,\r\n    debug: false,\r\n    decodeBinaryBlocks: false,\r\n    captureUnknownBlackFields: false,\r\n    captureUnknownResourceFields: false,\r\n    captureUnknownWhenNoBlackFields: false,\r\n    allowUnknownStringFallback: false,\r\n    rootFields: null,\r\n    payloadRootFields: null,\r\n    payloadTypeField: \"_type\",\r\n    payloadIdField: \"_id\",\r\n    payloadReferenceField: \"_reference\",\r\n    pathHandler: null,\r\n    adapter: null,\r    classes: Object.freeze({})\r\n});\r\n\r\nconst OPTION_KEYS = new Set(Object.keys(DEFAULT_VALUES));\r\n\n\r\nfunction normalizeEmit(emit, readerName)\r\n{\r\n    if (emit === undefined || emit === OUTPUT_JSON) return OUTPUT_JSON;\r\n    if (emit === OUTPUT_RAW) return OUTPUT_RAW;\r\n    if (emit === OUTPUT_DOCUMENT) return OUTPUT_DOCUMENT;\r\n    if (emit === OUTPUT_PAYLOAD) return OUTPUT_PAYLOAD;\r\n    if (emit === OUTPUT_RUNTIME) return OUTPUT_RUNTIME;\r\n    throw new Error(`${readerName} unknown emit value \"${emit}\"`);\r\n}\r\n\r\nfunction assertKnownOptions(options, readerName)\r\n{\r\n    for (const key of Object.keys(options))\r\n    {\r\n        if (!OPTION_KEYS.has(key))\r\n        {\r\n            throw new TypeError(`${readerName} unknown option \"${key}\"`);\r\n        }\r\n    }\r\n}\r\n\r\nfunction classMap(values)\r\n{\r\n    return values && values.classes ? values.classes : {};\r\n}\r\n\r\nfunction cloneValues(values)\r\n{\r\n    return {\r\n        emit: values.emit,\r\n        schema: values.schema ?? null,\r\n        registry: values.registry ?? null,\r\n        sourceShapes: values.sourceShapes ?? null,\r\n        rootName: values.rootName ?? \"default\",\r\n        firstId: values.firstId ?? 1,\r\n        metadata: values.metadata ?? null,\r\n        includeMetadata: Boolean(values.includeMetadata),\r\n        includeClassMetadata: Boolean(values.includeClassMetadata),\r\n        includeFieldTrace: Boolean(values.includeFieldTrace),\r\n        includeRefIndex: Boolean(values.includeRefIndex),\r\n        trace: Boolean(values.trace),\r\n        debug: Boolean(values.debug),\r\n        decodeBinaryBlocks: Boolean(values.decodeBinaryBlocks),\r\n        captureUnknownBlackFields: Boolean(values.captureUnknownBlackFields),\r\n        captureUnknownResourceFields: Boolean(values.captureUnknownResourceFields),\r\n        captureUnknownWhenNoBlackFields: Boolean(values.captureUnknownWhenNoBlackFields),\r\n        allowUnknownStringFallback: Boolean(values.allowUnknownStringFallback),\r\n        rootFields: cloneListOrValue(values.rootFields),\r\n        payloadRootFields: cloneListOrValue(values.payloadRootFields),\r\n        payloadTypeField: values.payloadTypeField,\r\n        payloadIdField: values.payloadIdField,\r\n        payloadReferenceField: values.payloadReferenceField,\r\n        pathHandler: values.pathHandler ?? null,\r\n        adapter: values.adapter ?? null,\r        classes: { ...classMap(values) }\r\n    };\r\n}\r\n\r\nfunction cloneListOrValue(value)\r\n{\r\n    return Array.isArray(value) ? value.slice() : value ?? null;\r\n}\r\n\r\n/** Validates a requested runtime class key for the Black object-graph reader. */\r\nexport function validateClassKey(classKeys, key, readerName)\r\n{\r\n    if (typeof key !== \"string\" || !key)\r\n    {\r\n        throw new Error(`${readerName} class type must be a non-empty string`);\r\n    }\r\n}\r\n\r\n/**\r\n * Validates a resolved runtime class constructor for the Black object-graph\r\n * reader.\r\n */\r\nexport function validateClass(classKeys, type, Class, readerName)\r\n{\r\n    validateClassKey(classKeys, type, readerName);\r\n    if (typeof Class !== \"function\")\r\n    {\r\n        throw new TypeError(`${readerName} class \"${type}\" must be a constructor`);\r\n    }\r\n}\r\n\r\nfunction mergeClasses(values, classes, classKeys, readerName)\r\n{\r\n    if (!classes || typeof classes !== \"object\")\r\n    {\r\n        throw new TypeError(`${readerName} classes option must be an object`);\r\n    }\r\n\r\n    const next = { ...values.classes };\r\n    for (const [ type, Class ] of Object.entries(classes))\r\n    {\r\n        validateClass(classKeys, type, Class, readerName);\r\n        next[type] = Class;\r\n    }\r\n    values.classes = next;\r\n}\r\n\r\n/**\r\n * Normalizes reader options against their supported defaults for the Black\r\n * object-graph reader.\r\n */\r\nexport function normalizeValues(base, options, classKeys, readerName)\r\n{\r\n    if (!options || typeof options !== \"object\")\r\n    {\r\n        throw new TypeError(`${readerName} options must be an object`);\r\n    }\r\n\r\n    assertKnownOptions(options, readerName);\r\n\r\n    const values = cloneValues(base);\r\n    if (Object.hasOwn(options, \"emit\")) values.emit = normalizeEmit(options.emit, readerName);\r\n    if (Object.hasOwn(options, \"schema\")) values.schema = options.schema ?? null;\r\n    if (Object.hasOwn(options, \"registry\")) values.registry = options.registry ?? null;\r\n    if (Object.hasOwn(options, \"sourceShapes\")) values.sourceShapes = options.sourceShapes ?? null;\r\n    if (Object.hasOwn(options, \"rootName\")) values.rootName = options.rootName ?? \"default\";\r\n    if (Object.hasOwn(options, \"firstId\")) values.firstId = options.firstId ?? 1;\r\n    if (Object.hasOwn(options, \"metadata\")) values.metadata = options.metadata ?? null;\r\n    if (Object.hasOwn(options, \"includeMetadata\")) values.includeMetadata = Boolean(options.includeMetadata);\r\n    if (Object.hasOwn(options, \"includeClassMetadata\")) values.includeClassMetadata = Boolean(options.includeClassMetadata);\r\n    if (Object.hasOwn(options, \"includeFieldTrace\")) values.includeFieldTrace = Boolean(options.includeFieldTrace);\r\n    if (Object.hasOwn(options, \"includeRefIndex\")) values.includeRefIndex = Boolean(options.includeRefIndex);\r\n    if (Object.hasOwn(options, \"trace\")) values.trace = Boolean(options.trace);\r\n    if (Object.hasOwn(options, \"debug\")) values.debug = Boolean(options.debug);\r\n    if (Object.hasOwn(options, \"decodeBinaryBlocks\")) values.decodeBinaryBlocks = Boolean(options.decodeBinaryBlocks);\r\n    if (Object.hasOwn(options, \"captureUnknownBlackFields\")) values.captureUnknownBlackFields = Boolean(options.captureUnknownBlackFields);\r\n    if (Object.hasOwn(options, \"captureUnknownResourceFields\")) values.captureUnknownResourceFields = Boolean(options.captureUnknownResourceFields);\r\n    if (Object.hasOwn(options, \"captureUnknownWhenNoBlackFields\")) values.captureUnknownWhenNoBlackFields = Boolean(options.captureUnknownWhenNoBlackFields);\r\n    if (Object.hasOwn(options, \"allowUnknownStringFallback\")) values.allowUnknownStringFallback = Boolean(options.allowUnknownStringFallback);\r\n    if (Object.hasOwn(options, \"rootFields\")) values.rootFields = cloneListOrValue(options.rootFields);\r\n    if (Object.hasOwn(options, \"payloadRootFields\")) values.payloadRootFields = cloneListOrValue(options.payloadRootFields);\r\n    if (Object.hasOwn(options, \"payloadTypeField\")) values.payloadTypeField = options.payloadTypeField;\r\n    if (Object.hasOwn(options, \"payloadIdField\")) values.payloadIdField = options.payloadIdField;\r\n    if (Object.hasOwn(options, \"payloadReferenceField\")) values.payloadReferenceField = options.payloadReferenceField;\r\n    if (Object.hasOwn(options, \"adapter\")) values.adapter = options.adapter ?? null;\r    if (Object.hasOwn(options, \"pathHandler\"))\r\n    {\r\n        if (options.pathHandler !== null && options.pathHandler !== undefined && typeof options.pathHandler !== \"function\")\r\n        {\r\n            throw new TypeError(`${readerName} pathHandler option must be a function`);\r\n        }\r\n        values.pathHandler = options.pathHandler ?? null;\r\n    }\r\n    if (Object.hasOwn(options, \"classes\")) mergeClasses(values, options.classes, classKeys, readerName);\r\n    return values;\r\n}\r\n\r\n/**\r\n * Throws a format error for a reader operation that is intentionally unavailable\r\n * for the Black object-graph reader.\r\n */\r\nexport function notImplemented(readerName, methodName)\r\n{\r\n    return new Error(`${readerName}.${methodName} is not implemented yet`);\r\n}\r\n\r\n/**\r\n * Converts a parsed payload into a JSON-safe value for the Black object-graph\r\n * reader.\r\n */\r\nexport function toJsonValue(value, seen = new WeakSet())\r\n{\r\n    if (value === null || typeof value !== \"object\") return value;\r\n    if (ArrayBuffer.isView(value)) return Array.from(value, item => toJsonValue(item, seen));\r\n    if (Array.isArray(value)) return value.map(item => toJsonValue(item, seen));\r\n\r\n    if (seen.has(value))\r\n    {\r\n        throw new TypeError(\"Reader.toJSON cannot convert circular data\");\r\n    }\r\n\r\n    if (typeof value.toJSON === \"function\")\r\n    {\r\n        seen.add(value);\r\n        const json = toJsonValue(value.toJSON(), seen);\r\n        seen.delete(value);\r\n        return json;\r\n    }\r\n\r\n    seen.add(value);\r\n    const out = {};\r\n    for (const key of Object.keys(value))\r\n    {\r\n        out[key] = toJsonValue(value[key], seen);\r\n    }\r\n    seen.delete(value);\r\n    return out;\r\n}\r\n"],"names":["OUTPUT_JSON","OUTPUT_RAW","OUTPUT_DOCUMENT","OUTPUT_PAYLOAD","OUTPUT_RUNTIME","DEFAULT_VALUES","Object","freeze","emit","schema","blackDefinitions","registry","sourceShapes","rootName","firstId","metadata","includeMetadata","includeClassMetadata","includeFieldTrace","includeRefIndex","trace","debug","decodeBinaryBlocks","captureUnknownBlackFields","captureUnknownResourceFields","captureUnknownWhenNoBlackFields","allowUnknownStringFallback","rootFields","payloadRootFields","payloadTypeField","payloadIdField","payloadReferenceField","pathHandler","adapter","classes","OPTION_KEYS","Set","keys","normalizeEmit","readerName","undefined","Error","assertKnownOptions","options","key","has","TypeError","classMap","values","cloneValues","Boolean","cloneListOrValue","value","Array","isArray","slice","validateClassKey","classKeys","validateClass","type","Class","mergeClasses","next","entries","normalizeValues","base","hasOwn","toJsonValue","seen","WeakSet","ArrayBuffer","isView","from","item","map","toJSON","add","json","delete","out"],"mappings":"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"}
+{"version":3,"file":"helpers.js","sources":["../../../../../../src/resource/formats/black/core/helpers.js"],"sourcesContent":["import { toJsonAcyclic } from \"../../../format/jsonPolicies.js\";\nimport blackDefinitions from \"./blackSchema.js\";\n\nexport const OUTPUT_JSON = \"json\";\nexport const OUTPUT_RAW = \"raw\";\nexport const OUTPUT_DOCUMENT = \"document\";\nexport const OUTPUT_PAYLOAD = \"payload\";\nexport const OUTPUT_RUNTIME = \"runtime\";\n\nexport const DEFAULT_VALUES = Object.freeze({\n    emit: OUTPUT_JSON,\n    schema: blackDefinitions,\n    registry: null,\n    sourceShapes: null,\n    rootName: \"default\",\n    firstId: 1,\n    metadata: null,\n    includeMetadata: false,\n    includeClassMetadata: false,\n    includeFieldTrace: false,\n    includeRefIndex: false,\n    trace: false,\n    debug: false,\n    decodeBinaryBlocks: false,\n    captureUnknownBlackFields: false,\n    captureUnknownResourceFields: false,\n    captureUnknownWhenNoBlackFields: false,\n    allowUnknownStringFallback: false,\n    rootFields: null,\n    payloadRootFields: null,\n    payloadTypeField: \"_type\",\n    payloadIdField: \"_id\",\n    payloadReferenceField: \"_reference\",\n    pathHandler: null,\n    adapter: null,\n    classes: Object.freeze({})\n});\n\nconst OPTION_KEYS = new Set(Object.keys(DEFAULT_VALUES));\n\n\nfunction normalizeEmit(emit, readerName)\n{\n    if (emit === undefined || emit === OUTPUT_JSON) return OUTPUT_JSON;\n    if (emit === OUTPUT_RAW) return OUTPUT_RAW;\n    if (emit === OUTPUT_DOCUMENT) return OUTPUT_DOCUMENT;\n    if (emit === OUTPUT_PAYLOAD) return OUTPUT_PAYLOAD;\n    if (emit === OUTPUT_RUNTIME) return OUTPUT_RUNTIME;\n    throw new Error(`${readerName} unknown emit value \"${emit}\"`);\n}\n\nfunction assertKnownOptions(options, readerName)\n{\n    for (const key of Object.keys(options))\n    {\n        if (!OPTION_KEYS.has(key))\n        {\n            throw new TypeError(`${readerName} unknown option \"${key}\"`);\n        }\n    }\n}\n\nfunction classMap(values)\n{\n    return values && values.classes ? values.classes : {};\n}\n\nfunction cloneValues(values)\n{\n    return {\n        emit: values.emit,\n        schema: values.schema ?? null,\n        registry: values.registry ?? null,\n        sourceShapes: values.sourceShapes ?? null,\n        rootName: values.rootName ?? \"default\",\n        firstId: values.firstId ?? 1,\n        metadata: values.metadata ?? null,\n        includeMetadata: Boolean(values.includeMetadata),\n        includeClassMetadata: Boolean(values.includeClassMetadata),\n        includeFieldTrace: Boolean(values.includeFieldTrace),\n        includeRefIndex: Boolean(values.includeRefIndex),\n        trace: Boolean(values.trace),\n        debug: Boolean(values.debug),\n        decodeBinaryBlocks: Boolean(values.decodeBinaryBlocks),\n        captureUnknownBlackFields: Boolean(values.captureUnknownBlackFields),\n        captureUnknownResourceFields: Boolean(values.captureUnknownResourceFields),\n        captureUnknownWhenNoBlackFields: Boolean(values.captureUnknownWhenNoBlackFields),\n        allowUnknownStringFallback: Boolean(values.allowUnknownStringFallback),\n        rootFields: cloneListOrValue(values.rootFields),\n        payloadRootFields: cloneListOrValue(values.payloadRootFields),\n        payloadTypeField: values.payloadTypeField,\n        payloadIdField: values.payloadIdField,\n        payloadReferenceField: values.payloadReferenceField,\n        pathHandler: values.pathHandler ?? null,\n        adapter: values.adapter ?? null,\n        classes: { ...classMap(values) }\n    };\n}\n\nfunction cloneListOrValue(value)\n{\n    return Array.isArray(value) ? value.slice() : value ?? null;\n}\n\n/** Validates a requested runtime class key for the Black object-graph reader. */\nexport function validateClassKey(classKeys, key, readerName)\n{\n    if (typeof key !== \"string\" || !key)\n    {\n        throw new Error(`${readerName} class type must be a non-empty string`);\n    }\n}\n\n/**\n * Validates a resolved runtime class constructor for the Black object-graph\n * reader.\n */\nexport function validateClass(classKeys, type, Class, readerName)\n{\n    validateClassKey(classKeys, type, readerName);\n    if (typeof Class !== \"function\")\n    {\n        throw new TypeError(`${readerName} class \"${type}\" must be a constructor`);\n    }\n}\n\nfunction mergeClasses(values, classes, classKeys, readerName)\n{\n    if (!classes || typeof classes !== \"object\")\n    {\n        throw new TypeError(`${readerName} classes option must be an object`);\n    }\n\n    const next = { ...values.classes };\n    for (const [ type, Class ] of Object.entries(classes))\n    {\n        validateClass(classKeys, type, Class, readerName);\n        next[type] = Class;\n    }\n    values.classes = next;\n}\n\n/**\n * Normalizes reader options against their supported defaults for the Black\n * object-graph reader.\n */\nexport function normalizeValues(base, options, classKeys, readerName)\n{\n    if (!options || typeof options !== \"object\")\n    {\n        throw new TypeError(`${readerName} options must be an object`);\n    }\n\n    assertKnownOptions(options, readerName);\n\n    const values = cloneValues(base);\n    if (Object.hasOwn(options, \"emit\")) values.emit = normalizeEmit(options.emit, readerName);\n    if (Object.hasOwn(options, \"schema\")) values.schema = options.schema ?? null;\n    if (Object.hasOwn(options, \"registry\")) values.registry = options.registry ?? null;\n    if (Object.hasOwn(options, \"sourceShapes\")) values.sourceShapes = options.sourceShapes ?? null;\n    if (Object.hasOwn(options, \"rootName\")) values.rootName = options.rootName ?? \"default\";\n    if (Object.hasOwn(options, \"firstId\")) values.firstId = options.firstId ?? 1;\n    if (Object.hasOwn(options, \"metadata\")) values.metadata = options.metadata ?? null;\n    if (Object.hasOwn(options, \"includeMetadata\")) values.includeMetadata = Boolean(options.includeMetadata);\n    if (Object.hasOwn(options, \"includeClassMetadata\")) values.includeClassMetadata = Boolean(options.includeClassMetadata);\n    if (Object.hasOwn(options, \"includeFieldTrace\")) values.includeFieldTrace = Boolean(options.includeFieldTrace);\n    if (Object.hasOwn(options, \"includeRefIndex\")) values.includeRefIndex = Boolean(options.includeRefIndex);\n    if (Object.hasOwn(options, \"trace\")) values.trace = Boolean(options.trace);\n    if (Object.hasOwn(options, \"debug\")) values.debug = Boolean(options.debug);\n    if (Object.hasOwn(options, \"decodeBinaryBlocks\")) values.decodeBinaryBlocks = Boolean(options.decodeBinaryBlocks);\n    if (Object.hasOwn(options, \"captureUnknownBlackFields\")) values.captureUnknownBlackFields = Boolean(options.captureUnknownBlackFields);\n    if (Object.hasOwn(options, \"captureUnknownResourceFields\")) values.captureUnknownResourceFields = Boolean(options.captureUnknownResourceFields);\n    if (Object.hasOwn(options, \"captureUnknownWhenNoBlackFields\")) values.captureUnknownWhenNoBlackFields = Boolean(options.captureUnknownWhenNoBlackFields);\n    if (Object.hasOwn(options, \"allowUnknownStringFallback\")) values.allowUnknownStringFallback = Boolean(options.allowUnknownStringFallback);\n    if (Object.hasOwn(options, \"rootFields\")) values.rootFields = cloneListOrValue(options.rootFields);\n    if (Object.hasOwn(options, \"payloadRootFields\")) values.payloadRootFields = cloneListOrValue(options.payloadRootFields);\n    if (Object.hasOwn(options, \"payloadTypeField\")) values.payloadTypeField = options.payloadTypeField;\n    if (Object.hasOwn(options, \"payloadIdField\")) values.payloadIdField = options.payloadIdField;\n    if (Object.hasOwn(options, \"payloadReferenceField\")) values.payloadReferenceField = options.payloadReferenceField;\n    if (Object.hasOwn(options, \"adapter\")) values.adapter = options.adapter ?? null;\n    if (Object.hasOwn(options, \"pathHandler\"))\n    {\n        if (options.pathHandler !== null && options.pathHandler !== undefined && typeof options.pathHandler !== \"function\")\n        {\n            throw new TypeError(`${readerName} pathHandler option must be a function`);\n        }\n        values.pathHandler = options.pathHandler ?? null;\n    }\n    if (Object.hasOwn(options, \"classes\")) mergeClasses(values, options.classes, classKeys, readerName);\n    return values;\n}\n\n/**\n * Throws a format error for a reader operation that is intentionally unavailable\n * for the Black object-graph reader.\n */\nexport function notImplemented(readerName, methodName)\n{\n    return new Error(`${readerName}.${methodName} is not implemented yet`);\n}\n\n/**\n * Converts a parsed payload into a JSON-safe value for the Black object-graph\n * reader.\n */\n/**\n * Convert to JSON, refusing a cycle, naming this reader in the error.\n *\n * @param {*} value Any decoded value.\n * @returns {*} A JSON-safe value.\n */\nexport function toJsonValue(value)\n{\n    return toJsonAcyclic(value, \"Reader\");\n}\n"],"names":["OUTPUT_JSON","OUTPUT_RAW","OUTPUT_DOCUMENT","OUTPUT_PAYLOAD","OUTPUT_RUNTIME","DEFAULT_VALUES","Object","freeze","emit","schema","blackDefinitions","registry","sourceShapes","rootName","firstId","metadata","includeMetadata","includeClassMetadata","includeFieldTrace","includeRefIndex","trace","debug","decodeBinaryBlocks","captureUnknownBlackFields","captureUnknownResourceFields","captureUnknownWhenNoBlackFields","allowUnknownStringFallback","rootFields","payloadRootFields","payloadTypeField","payloadIdField","payloadReferenceField","pathHandler","adapter","classes","OPTION_KEYS","Set","keys","normalizeEmit","readerName","undefined","Error","assertKnownOptions","options","key","has","TypeError","classMap","values","cloneValues","Boolean","cloneListOrValue","value","Array","isArray","slice","validateClassKey","classKeys","validateClass","type","Class","mergeClasses","next","entries","normalizeValues","base","hasOwn","toJsonValue","toJsonAcyclic"],"mappings":"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"}