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

package/dist/global/schema/hydration.js

@@ -1,3 +1,5 @@
+import { CjsSchema } from './CjsSchema.js';
+
 /**
  * Hydration adapter seam - the population contract for readers that build
  * runtime objects incrementally (black/red). The ordering guarantee:
@@ -24,8 +26,16 @@
  * SetValues is called directly rather than through CjsSchema.setValues so a
  * reader works with only the schema layer loaded; the two are the same path
  * for every class that has the method.
+ *
+ * A REGISTERED class without SetValues - one that no longer extends CjsModel -
+ * is still a resolved class, so it populates through CjsSchema.setValues, which
+ * answers without the model layer. Only an unregistered carrier (the reader's
+ * `{ _sourceClassName }` fallback) takes raw assignment. Without this middle
+ * arm, taking a class off the base would silently drop it to Object.assign:
+ * no coercion, no writability gate, no settle.
  */
 
+
 /**
  * Resolves a normalized adapter from hydration options. The returned object
  * always exposes construct/applyValues/finalize with the documented defaults.
@@ -47,6 +57,10 @@ function resolveHydrationAdapter(options = {}) {
         instance.SetValues(values, ctx?.options);
         return instance;
       }
+      if (instance && CjsSchema.getClassName(instance.constructor)) {
+        CjsSchema.setValues(instance, values, ctx?.options);
+        return instance;
+      }
       return Object.assign(instance, values);
     },
     finalize(instance, ctx) {

package/dist/global/schema/hydration.js.map

@@ -1 +1 @@
-{"version":3,"file":"hydration.js","sources":["../../../../src/global/schema/hydration.js"],"sourcesContent":["/**\n * Hydration adapter seam - the population contract for readers that build\n * runtime objects incrementally (black/red). The ordering guarantee:\n *\n *   1. construct   - build every instance (register refs before values, so\n *                    cycles/back-references resolve)\n *   2. applyValues - apply each node's field values\n *   3. finalize    - run once per instance AFTER the whole graph is built,\n *                    so references are already resolved\n *\n * DEFAULTS (operator ruling, 2026-09-05; resource-population.md owns the\n * decision): a resolved class is populated through its own validated setter -\n * \"if someone is using Object.assign, they probably should be using\n * SetValues\" - and a class-owned Initialize runs once post-graph, which is\n * the incremental-reader counterpart of the reader+IInitialize handshake\n * Blue performs and CjsModel.from performs for whole-bag JSON. Plain\n * fallback carriers (unresolved kinds) keep raw assignment: that IS their\n * contract, not a bypass.\n *\n * The single escape hatch is `options.adapter`, per-hook optional. The\n * per-kind adapters map and the hydrationAdapter alias are gone - they had\n * zero consumers. Callers wanting raw assignment pass their own adapter.\n *\n * SetValues is called directly rather than through CjsSchema.setValues so a\n * reader works with only the schema layer loaded; the two are the same path\n * for every class that has the method.\n */\n\n/**\n * Resolves a normalized adapter from hydration options. The returned object\n * always exposes construct/applyValues/finalize with the documented defaults.\n *\n * @param {Object} [options]\n * @param {Object} [options.adapter] Per-hook overrides: construct/applyValues/finalize.\n * @returns {{ construct: Function, applyValues: Function, finalize: Function }}\n */\nexport function resolveHydrationAdapter(options = {})\n{\n    const custom = options.adapter || null;\n\n    return {\n        construct(kind, ctx)\n        {\n            if (custom && typeof custom.construct === \"function\") return custom.construct(kind, ctx);\n            return undefined;\n        },\n        applyValues(instance, values, ctx)\n        {\n            if (custom && typeof custom.applyValues === \"function\") return custom.applyValues(instance, values, ctx);\n            if (instance && typeof instance.SetValues === \"function\")\n            {\n                instance.SetValues(values, ctx?.options);\n                return instance;\n            }\n            return Object.assign(instance, values);\n        },\n        finalize(instance, ctx)\n        {\n            if (custom && typeof custom.finalize === \"function\")\n            {\n                custom.finalize(instance, ctx);\n                return;\n            }\n            if (instance && typeof instance.Initialize === \"function\") instance.Initialize();\n        }\n    };\n}\n"],"names":["resolveHydrationAdapter","options","custom","adapter","construct","kind","ctx","undefined","applyValues","instance","values","SetValues","Object","assign","finalize","Initialize"],"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;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASA,uBAAuBA,CAACC,OAAO,GAAG,EAAE,EACpD;AACI,EAAA,MAAMC,MAAM,GAAGD,OAAO,CAACE,OAAO,IAAI,IAAI;EAEtC,OAAO;AACHC,IAAAA,SAASA,CAACC,IAAI,EAAEC,GAAG,EACnB;AACI,MAAA,IAAIJ,MAAM,IAAI,OAAOA,MAAM,CAACE,SAAS,KAAK,UAAU,EAAE,OAAOF,MAAM,CAACE,SAAS,CAACC,IAAI,EAAEC,GAAG,CAAC;AACxF,MAAA,OAAOC,SAAS;IACpB,CAAC;AACDC,IAAAA,WAAWA,CAACC,QAAQ,EAAEC,MAAM,EAAEJ,GAAG,EACjC;AACI,MAAA,IAAIJ,MAAM,IAAI,OAAOA,MAAM,CAACM,WAAW,KAAK,UAAU,EAAE,OAAON,MAAM,CAACM,WAAW,CAACC,QAAQ,EAAEC,MAAM,EAAEJ,GAAG,CAAC;MACxG,IAAIG,QAAQ,IAAI,OAAOA,QAAQ,CAACE,SAAS,KAAK,UAAU,EACxD;QACIF,QAAQ,CAACE,SAAS,CAACD,MAAM,EAAEJ,GAAG,EAAEL,OAAO,CAAC;AACxC,QAAA,OAAOQ,QAAQ;AACnB,MAAA;AACA,MAAA,OAAOG,MAAM,CAACC,MAAM,CAACJ,QAAQ,EAAEC,MAAM,CAAC;IAC1C,CAAC;AACDI,IAAAA,QAAQA,CAACL,QAAQ,EAAEH,GAAG,EACtB;MACI,IAAIJ,MAAM,IAAI,OAAOA,MAAM,CAACY,QAAQ,KAAK,UAAU,EACnD;AACIZ,QAAAA,MAAM,CAACY,QAAQ,CAACL,QAAQ,EAAEH,GAAG,CAAC;AAC9B,QAAA;AACJ,MAAA;AACA,MAAA,IAAIG,QAAQ,IAAI,OAAOA,QAAQ,CAACM,UAAU,KAAK,UAAU,EAAEN,QAAQ,CAACM,UAAU,EAAE;AACpF,IAAA;GACH;AACL;;;;"}
+{"version":3,"file":"hydration.js","sources":["../../../../src/global/schema/hydration.js"],"sourcesContent":["/**\n * Hydration adapter seam - the population contract for readers that build\n * runtime objects incrementally (black/red). The ordering guarantee:\n *\n *   1. construct   - build every instance (register refs before values, so\n *                    cycles/back-references resolve)\n *   2. applyValues - apply each node's field values\n *   3. finalize    - run once per instance AFTER the whole graph is built,\n *                    so references are already resolved\n *\n * DEFAULTS (operator ruling, 2026-09-05; resource-population.md owns the\n * decision): a resolved class is populated through its own validated setter -\n * \"if someone is using Object.assign, they probably should be using\n * SetValues\" - and a class-owned Initialize runs once post-graph, which is\n * the incremental-reader counterpart of the reader+IInitialize handshake\n * Blue performs and CjsModel.from performs for whole-bag JSON. Plain\n * fallback carriers (unresolved kinds) keep raw assignment: that IS their\n * contract, not a bypass.\n *\n * The single escape hatch is `options.adapter`, per-hook optional. The\n * per-kind adapters map and the hydrationAdapter alias are gone - they had\n * zero consumers. Callers wanting raw assignment pass their own adapter.\n *\n * SetValues is called directly rather than through CjsSchema.setValues so a\n * reader works with only the schema layer loaded; the two are the same path\n * for every class that has the method.\n *\n * A REGISTERED class without SetValues - one that no longer extends CjsModel -\n * is still a resolved class, so it populates through CjsSchema.setValues, which\n * answers without the model layer. Only an unregistered carrier (the reader's\n * `{ _sourceClassName }` fallback) takes raw assignment. Without this middle\n * arm, taking a class off the base would silently drop it to Object.assign:\n * no coercion, no writability gate, no settle.\n */\n\nimport { CjsSchema } from \"./CjsSchema.js\";\n\n/**\n * Resolves a normalized adapter from hydration options. The returned object\n * always exposes construct/applyValues/finalize with the documented defaults.\n *\n * @param {Object} [options]\n * @param {Object} [options.adapter] Per-hook overrides: construct/applyValues/finalize.\n * @returns {{ construct: Function, applyValues: Function, finalize: Function }}\n */\nexport function resolveHydrationAdapter(options = {})\n{\n    const custom = options.adapter || null;\n\n    return {\n        construct(kind, ctx)\n        {\n            if (custom && typeof custom.construct === \"function\") return custom.construct(kind, ctx);\n            return undefined;\n        },\n        applyValues(instance, values, ctx)\n        {\n            if (custom && typeof custom.applyValues === \"function\") return custom.applyValues(instance, values, ctx);\n            if (instance && typeof instance.SetValues === \"function\")\n            {\n                instance.SetValues(values, ctx?.options);\n                return instance;\n            }\n            if (instance && CjsSchema.getClassName(instance.constructor))\n            {\n                CjsSchema.setValues(instance, values, ctx?.options);\n                return instance;\n            }\n            return Object.assign(instance, values);\n        },\n        finalize(instance, ctx)\n        {\n            if (custom && typeof custom.finalize === \"function\")\n            {\n                custom.finalize(instance, ctx);\n                return;\n            }\n            if (instance && typeof instance.Initialize === \"function\") instance.Initialize();\n        }\n    };\n}\n"],"names":["resolveHydrationAdapter","options","custom","adapter","construct","kind","ctx","undefined","applyValues","instance","values","SetValues","CjsSchema","getClassName","constructor","setValues","Object","assign","finalize","Initialize"],"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;AACA;AACA;AACA;AACA;AACA;AACA;;;AAIA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASA,uBAAuBA,CAACC,OAAO,GAAG,EAAE,EACpD;AACI,EAAA,MAAMC,MAAM,GAAGD,OAAO,CAACE,OAAO,IAAI,IAAI;EAEtC,OAAO;AACHC,IAAAA,SAASA,CAACC,IAAI,EAAEC,GAAG,EACnB;AACI,MAAA,IAAIJ,MAAM,IAAI,OAAOA,MAAM,CAACE,SAAS,KAAK,UAAU,EAAE,OAAOF,MAAM,CAACE,SAAS,CAACC,IAAI,EAAEC,GAAG,CAAC;AACxF,MAAA,OAAOC,SAAS;IACpB,CAAC;AACDC,IAAAA,WAAWA,CAACC,QAAQ,EAAEC,MAAM,EAAEJ,GAAG,EACjC;AACI,MAAA,IAAIJ,MAAM,IAAI,OAAOA,MAAM,CAACM,WAAW,KAAK,UAAU,EAAE,OAAON,MAAM,CAACM,WAAW,CAACC,QAAQ,EAAEC,MAAM,EAAEJ,GAAG,CAAC;MACxG,IAAIG,QAAQ,IAAI,OAAOA,QAAQ,CAACE,SAAS,KAAK,UAAU,EACxD;QACIF,QAAQ,CAACE,SAAS,CAACD,MAAM,EAAEJ,GAAG,EAAEL,OAAO,CAAC;AACxC,QAAA,OAAOQ,QAAQ;AACnB,MAAA;MACA,IAAIA,QAAQ,IAAIG,SAAS,CAACC,YAAY,CAACJ,QAAQ,CAACK,WAAW,CAAC,EAC5D;QACIF,SAAS,CAACG,SAAS,CAACN,QAAQ,EAAEC,MAAM,EAAEJ,GAAG,EAAEL,OAAO,CAAC;AACnD,QAAA,OAAOQ,QAAQ;AACnB,MAAA;AACA,MAAA,OAAOO,MAAM,CAACC,MAAM,CAACR,QAAQ,EAAEC,MAAM,CAAC;IAC1C,CAAC;AACDQ,IAAAA,QAAQA,CAACT,QAAQ,EAAEH,GAAG,EACtB;MACI,IAAIJ,MAAM,IAAI,OAAOA,MAAM,CAACgB,QAAQ,KAAK,UAAU,EACnD;AACIhB,QAAAA,MAAM,CAACgB,QAAQ,CAACT,QAAQ,EAAEH,GAAG,CAAC;AAC9B,QAAA;AACJ,MAAA;AACA,MAAA,IAAIG,QAAQ,IAAI,OAAOA,QAAQ,CAACU,UAAU,KAAK,UAAU,EAAEV,QAAQ,CAACU,UAAU,EAAE;AACpF,IAAA;GACH;AACL;;;;"}

package/dist/global/utils/bytes.js

@@ -1,4 +1,8 @@
 /** Returns a zero-copy Uint8Array view over supported byte input. */
+// One reused conversion view. `hash.js` keeps its own for the same reason:
+// these run per record, and allocating a 4-byte ArrayBuffer each time is
+// pure garbage for a value that is read immediately and never retained.
+const scratch = new DataView(new ArrayBuffer(4));
 function asUint8Array(value, label = "value") {
   if (value instanceof Uint8Array) {
     return value;
@@ -102,10 +106,24 @@ function readU32LE(bytes, offset) {
  * @returns {number} Float value represented by the same bits.
  */
 function float32FromBits(value) {
-  const view = new DataView(new ArrayBuffer(4));
-  view.setUint32(0, value >>> 0, true);
-  return view.getFloat32(0, true);
+  scratch.setUint32(0, value >>> 0, true);
+  return scratch.getFloat32(0, true);
 }
 
-export { asUint8Array, copyBytes, float32FromBits, hasBytePrefix, readFourCc, readU16BE, readU16LE, readU24BE, readU24LE, readU32BE, readU32LE, toArrayBuffer };
+/**
+ * The bit pattern of a 32-bit float.
+ *
+ * The inverse of `float32FromBits`, and the reason both live here: a caller that
+ * round-trips a float through its bits needs the two halves to agree about byte
+ * order, and two modules each owning one half is how they stop agreeing.
+ *
+ * @param {number} value Float value.
+ * @returns {number} Unsigned 32-bit pattern encoding that float.
+ */
+function float32ToBits(value) {
+  scratch.setFloat32(0, value, true);
+  return scratch.getUint32(0, true);
+}
+
+export { asUint8Array, copyBytes, float32FromBits, float32ToBits, hasBytePrefix, readFourCc, readU16BE, readU16LE, readU24BE, readU24LE, readU32BE, readU32LE, toArrayBuffer };
 //# sourceMappingURL=bytes.js.map

package/dist/global/utils/bytes.js.map

@@ -1 +1 @@
-{"version":3,"file":"bytes.js","sources":["../../../../src/global/utils/bytes.js"],"sourcesContent":["/** Returns a zero-copy Uint8Array view over supported byte input. */\r\nexport function asUint8Array(value, label = \"value\")\r\n{\r\n    if (value instanceof Uint8Array)\r\n    {\r\n        return value;\r\n    }\r\n\r\n    if (value instanceof ArrayBuffer)\r\n    {\r\n        return new Uint8Array(value);\r\n    }\r\n\r\n    if (ArrayBuffer.isView(value))\r\n    {\r\n        return new Uint8Array(value.buffer, value.byteOffset, value.byteLength);\r\n    }\r\n\r\n    throw new TypeError(`${label} must be a Uint8Array, ArrayBuffer, or ArrayBuffer view.`);\r\n}\r\n\r\n/** Returns an owned copy of supported byte input. */\r\nexport function copyBytes(value, label = \"value\")\r\n{\r\n    return asUint8Array(value, label).slice();\r\n}\r\n\r\n/** Copies exactly the visible byte range into a standalone ArrayBuffer. */\r\nexport function toArrayBuffer(value, label = \"value\")\r\n{\r\n    const bytes = asUint8Array(value, label);\r\n\r\n    return bytes.buffer.slice(bytes.byteOffset, bytes.byteOffset + bytes.byteLength);\r\n}\r\n\r\n/** Tests whether byte input starts with the complete supplied prefix. */\r\nexport function hasBytePrefix(value, prefix)\r\n{\r\n    const bytes = asUint8Array(value, \"value\");\r\n    const expected = asUint8Array(prefix, \"prefix\");\r\n\r\n    if (bytes.byteLength < expected.byteLength)\r\n    {\r\n        return false;\r\n    }\r\n\r\n    for (let index = 0; index < expected.byteLength; index++)\r\n    {\r\n        if (bytes[index] !== expected[index])\r\n        {\r\n            return false;\r\n        }\r\n    }\r\n\r\n    return true;\r\n}\r\n\n/**\n * Reads a fixed-length ASCII tag, as container formats use for chunk names.\n *\n * Missing bytes read as zero rather than throwing, because a truncated tag is\n * a failed match at the call site, not an error in the read.\n *\n * @param {Uint8Array} bytes Source bytes.\n * @param {number} offset Byte offset to read from.\n * @param {number} [length=4] Tag length in bytes.\n * @returns {string} The decoded tag.\n */\nexport function readFourCc(bytes, offset, length = 4)\n{\n    let value = \"\";\n    for (let i = 0; i < length; i++) value += String.fromCharCode(bytes[offset + i] || 0);\n    return value;\n}\n\n// Container formats read fixed-width big- and little-endian integers\n// constantly, and every reader had grown its own copy. Missing bytes read as\n// zero, matching what the shifting forms already did: `>>> 0` turns the NaN a\n// truncated multiply produces back into a number, so only the two flac copies\n// that omitted it ever returned NaN, and flac bounds-checks before every read.\n\n/** Reads an unsigned big-endian 16-bit integer. */\nexport function readU16BE(bytes, offset)\n{\n    return ((bytes[offset] || 0) << 8) | (bytes[offset + 1] || 0);\n}\n\n/** Reads an unsigned little-endian 16-bit integer. */\nexport function readU16LE(bytes, offset)\n{\n    return (bytes[offset] || 0) | ((bytes[offset + 1] || 0) << 8);\n}\n\n/** Reads an unsigned big-endian 24-bit integer. */\nexport function readU24BE(bytes, offset)\n{\n    return ((bytes[offset] || 0) * 0x10000) + ((bytes[offset + 1] || 0) << 8) + (bytes[offset + 2] || 0);\n}\n\n/** Reads an unsigned little-endian 24-bit integer. */\nexport function readU24LE(bytes, offset)\n{\n    return (bytes[offset] || 0) + ((bytes[offset + 1] || 0) << 8) + ((bytes[offset + 2] || 0) * 0x10000);\n}\n\n/** Reads an unsigned big-endian 32-bit integer. */\nexport function readU32BE(bytes, offset)\n{\n    return (((bytes[offset] || 0) * 0x1000000)\n        + ((bytes[offset + 1] || 0) << 16)\n        + ((bytes[offset + 2] || 0) << 8)\n        + (bytes[offset + 3] || 0)) >>> 0;\n}\n\n/** Reads an unsigned little-endian 32-bit integer. */\nexport function readU32LE(bytes, offset)\n{\n    return ((bytes[offset] || 0)\n        + ((bytes[offset + 1] || 0) << 8)\n        + ((bytes[offset + 2] || 0) << 16)\n        + ((bytes[offset + 3] || 0) * 0x1000000)) >>> 0;\n}\n\n/**\n * Reinterprets the bits of an unsigned 32-bit integer as a float32.\n *\n * Carbon stores float-valued render states and annotation payloads as raw\n * uint32 bit patterns, so a consumer that needs the number rather than the\n * pattern must reinterpret rather than convert.\n *\n * @param {number} value Unsigned 32-bit integer containing float bits.\n * @returns {number} Float value represented by the same bits.\n */\nexport function float32FromBits(value)\n{\n    const view = new DataView(new ArrayBuffer(4));\n    view.setUint32(0, value >>> 0, true);\n    return view.getFloat32(0, true);\n}\n"],"names":["asUint8Array","value","label","Uint8Array","ArrayBuffer","isView","buffer","byteOffset","byteLength","TypeError","copyBytes","slice","toArrayBuffer","bytes","hasBytePrefix","prefix","expected","index","readFourCc","offset","length","i","String","fromCharCode","readU16BE","readU16LE","readU24BE","readU24LE","readU32BE","readU32LE","float32FromBits","view","DataView","setUint32","getFloat32"],"mappings":"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"}
+{"version":3,"file":"bytes.js","sources":["../../../../src/global/utils/bytes.js"],"sourcesContent":["/** Returns a zero-copy Uint8Array view over supported byte input. */\n// One reused conversion view. `hash.js` keeps its own for the same reason:\n// these run per record, and allocating a 4-byte ArrayBuffer each time is\n// pure garbage for a value that is read immediately and never retained.\nconst scratch = new DataView(new ArrayBuffer(4));\n\nexport function asUint8Array(value, label = \"value\")\n{\n    if (value instanceof Uint8Array)\n    {\n        return value;\n    }\n\n    if (value instanceof ArrayBuffer)\n    {\n        return new Uint8Array(value);\n    }\n\n    if (ArrayBuffer.isView(value))\n    {\n        return new Uint8Array(value.buffer, value.byteOffset, value.byteLength);\n    }\n\n    throw new TypeError(`${label} must be a Uint8Array, ArrayBuffer, or ArrayBuffer view.`);\n}\n\n/** Returns an owned copy of supported byte input. */\nexport function copyBytes(value, label = \"value\")\n{\n    return asUint8Array(value, label).slice();\n}\n\n/** Copies exactly the visible byte range into a standalone ArrayBuffer. */\nexport function toArrayBuffer(value, label = \"value\")\n{\n    const bytes = asUint8Array(value, label);\n\n    return bytes.buffer.slice(bytes.byteOffset, bytes.byteOffset + bytes.byteLength);\n}\n\n/** Tests whether byte input starts with the complete supplied prefix. */\nexport function hasBytePrefix(value, prefix)\n{\n    const bytes = asUint8Array(value, \"value\");\n    const expected = asUint8Array(prefix, \"prefix\");\n\n    if (bytes.byteLength < expected.byteLength)\n    {\n        return false;\n    }\n\n    for (let index = 0; index < expected.byteLength; index++)\n    {\n        if (bytes[index] !== expected[index])\n        {\n            return false;\n        }\n    }\n\n    return true;\n}\n\n/**\n * Reads a fixed-length ASCII tag, as container formats use for chunk names.\n *\n * Missing bytes read as zero rather than throwing, because a truncated tag is\n * a failed match at the call site, not an error in the read.\n *\n * @param {Uint8Array} bytes Source bytes.\n * @param {number} offset Byte offset to read from.\n * @param {number} [length=4] Tag length in bytes.\n * @returns {string} The decoded tag.\n */\nexport function readFourCc(bytes, offset, length = 4)\n{\n    let value = \"\";\n    for (let i = 0; i < length; i++) value += String.fromCharCode(bytes[offset + i] || 0);\n    return value;\n}\n\n// Container formats read fixed-width big- and little-endian integers\n// constantly, and every reader had grown its own copy. Missing bytes read as\n// zero, matching what the shifting forms already did: `>>> 0` turns the NaN a\n// truncated multiply produces back into a number, so only the two flac copies\n// that omitted it ever returned NaN, and flac bounds-checks before every read.\n\n/** Reads an unsigned big-endian 16-bit integer. */\nexport function readU16BE(bytes, offset)\n{\n    return ((bytes[offset] || 0) << 8) | (bytes[offset + 1] || 0);\n}\n\n/** Reads an unsigned little-endian 16-bit integer. */\nexport function readU16LE(bytes, offset)\n{\n    return (bytes[offset] || 0) | ((bytes[offset + 1] || 0) << 8);\n}\n\n/** Reads an unsigned big-endian 24-bit integer. */\nexport function readU24BE(bytes, offset)\n{\n    return ((bytes[offset] || 0) * 0x10000) + ((bytes[offset + 1] || 0) << 8) + (bytes[offset + 2] || 0);\n}\n\n/** Reads an unsigned little-endian 24-bit integer. */\nexport function readU24LE(bytes, offset)\n{\n    return (bytes[offset] || 0) + ((bytes[offset + 1] || 0) << 8) + ((bytes[offset + 2] || 0) * 0x10000);\n}\n\n/** Reads an unsigned big-endian 32-bit integer. */\nexport function readU32BE(bytes, offset)\n{\n    return (((bytes[offset] || 0) * 0x1000000)\n        + ((bytes[offset + 1] || 0) << 16)\n        + ((bytes[offset + 2] || 0) << 8)\n        + (bytes[offset + 3] || 0)) >>> 0;\n}\n\n/** Reads an unsigned little-endian 32-bit integer. */\nexport function readU32LE(bytes, offset)\n{\n    return ((bytes[offset] || 0)\n        + ((bytes[offset + 1] || 0) << 8)\n        + ((bytes[offset + 2] || 0) << 16)\n        + ((bytes[offset + 3] || 0) * 0x1000000)) >>> 0;\n}\n\n/**\n * Reinterprets the bits of an unsigned 32-bit integer as a float32.\n *\n * Carbon stores float-valued render states and annotation payloads as raw\n * uint32 bit patterns, so a consumer that needs the number rather than the\n * pattern must reinterpret rather than convert.\n *\n * @param {number} value Unsigned 32-bit integer containing float bits.\n * @returns {number} Float value represented by the same bits.\n */\nexport function float32FromBits(value)\n{\n    scratch.setUint32(0, value >>> 0, true);\n    return scratch.getFloat32(0, true);\n}\n\n/**\n * The bit pattern of a 32-bit float.\n *\n * The inverse of `float32FromBits`, and the reason both live here: a caller that\n * round-trips a float through its bits needs the two halves to agree about byte\n * order, and two modules each owning one half is how they stop agreeing.\n *\n * @param {number} value Float value.\n * @returns {number} Unsigned 32-bit pattern encoding that float.\n */\nexport function float32ToBits(value)\n{\n    scratch.setFloat32(0, value, true);\n    return scratch.getUint32(0, true);\n}\n"],"names":["scratch","DataView","ArrayBuffer","asUint8Array","value","label","Uint8Array","isView","buffer","byteOffset","byteLength","TypeError","copyBytes","slice","toArrayBuffer","bytes","hasBytePrefix","prefix","expected","index","readFourCc","offset","length","i","String","fromCharCode","readU16BE","readU16LE","readU24BE","readU24LE","readU32BE","readU32LE","float32FromBits","setUint32","getFloat32","float32ToBits","setFloat32","getUint32"],"mappings":"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"}

package/dist/global/utils/checksum.js

@@ -0,0 +1,80 @@
+// The two integrity checksums this runtime computes, in one module named for
+// what they are. Sibling of `hash.js`, and the split between them is the job,
+// not the width: FNV hashes address and identify, these two verify that bytes
+// survived a round trip.
+//
+// ONE IMPLEMENTATION EACH, BECAUSE THERE WAS ONE ALGORITHM EACH. Standard
+// CRC-32 was written three times — `cmf/core/binary.js`, `gr2/core/container.js`
+// and `png/core/writer.js` — with the same reflected polynomial, the same
+// initial value and the same final xor, differing only in whether the table was
+// precomputed and how many range arguments the signature took. Adler-32 was
+// written twice, in `png/core/writer.js` and `fbx/core/helpers.js`.
+//
+// WHAT DOES NOT BELONG HERE, and the distinction `hash.js` already draws:
+// a checksum whose POLYNOMIAL or direction is part of a format's wire contract
+// stays with that format. `wem/core/bitStream.js` computes the Ogg page
+// checksum — forward CRC-32 over polynomial 0x04c11db7, zero initial value, no
+// final xor. It shares a name with the function below and nothing else, and its
+// own comment says so.
+//
+// Nor does the independent copy in `test/.../gr2/writer.test.mjs` belong here.
+// A test that verifies a checksum by importing the implementation it is testing
+// proves only that the function equals itself; that copy is a deliberate oracle
+// and is meant to stay separate.
+
+/** Reflected CRC-32 polynomial, as used by zlib, PNG, GZIP and Carbon's containers. */
+const CRC32_POLYNOMIAL = 0xedb88320;
+
+/** Largest prime below 65536 — Adler-32's modulus. */
+const ADLER32_MODULUS = 65521;
+const CRC32_TABLE = (() => {
+  const table = new Uint32Array(256);
+  for (let index = 0; index < 256; index++) {
+    let value = index;
+    for (let bit = 0; bit < 8; bit++) {
+      value = value & 1 ? CRC32_POLYNOMIAL ^ value >>> 1 : value >>> 1;
+    }
+    table[index] = value >>> 0;
+  }
+  return table;
+})();
+
+/**
+ * Standard CRC-32 over a byte range.
+ *
+ * Reflected polynomial, initial value all ones, final one's complement — the
+ * variant PNG chunks, zlib streams, CMF containers and GR2 sections all use.
+ *
+ * @param {Uint8Array} bytes Source bytes.
+ * @param {number} [start] First byte offset, inclusive.
+ * @param {number} [end] Last byte offset, exclusive.
+ * @returns {number} Unsigned 32-bit checksum.
+ */
+function crc32(bytes, start = 0, end = bytes.length) {
+  let crc = 0xffffffff;
+  for (let index = start; index < end; index++) {
+    crc = crc >>> 8 ^ CRC32_TABLE[(crc ^ bytes[index]) & 0xff];
+  }
+  return (crc ^ 0xffffffff) >>> 0;
+}
+
+/**
+ * Adler-32 over a byte range, as zlib streams carry it.
+ *
+ * @param {Uint8Array} bytes Source bytes.
+ * @param {number} [start] First byte offset, inclusive.
+ * @param {number} [end] Last byte offset, exclusive.
+ * @returns {number} Unsigned 32-bit checksum.
+ */
+function adler32(bytes, start = 0, end = bytes.length) {
+  let a = 1,
+    b = 0;
+  for (let index = start; index < end; index++) {
+    a = (a + bytes[index]) % ADLER32_MODULUS;
+    b = (b + a) % ADLER32_MODULUS;
+  }
+  return (b << 16 >>> 0 | a) >>> 0;
+}
+
+export { adler32, crc32 };
+//# sourceMappingURL=checksum.js.map

package/dist/global/utils/checksum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"checksum.js","sources":["../../../../src/global/utils/checksum.js"],"sourcesContent":["// The two integrity checksums this runtime computes, in one module named for\n// what they are. Sibling of `hash.js`, and the split between them is the job,\n// not the width: FNV hashes address and identify, these two verify that bytes\n// survived a round trip.\n//\n// ONE IMPLEMENTATION EACH, BECAUSE THERE WAS ONE ALGORITHM EACH. Standard\n// CRC-32 was written three times — `cmf/core/binary.js`, `gr2/core/container.js`\n// and `png/core/writer.js` — with the same reflected polynomial, the same\n// initial value and the same final xor, differing only in whether the table was\n// precomputed and how many range arguments the signature took. Adler-32 was\n// written twice, in `png/core/writer.js` and `fbx/core/helpers.js`.\n//\n// WHAT DOES NOT BELONG HERE, and the distinction `hash.js` already draws:\n// a checksum whose POLYNOMIAL or direction is part of a format's wire contract\n// stays with that format. `wem/core/bitStream.js` computes the Ogg page\n// checksum — forward CRC-32 over polynomial 0x04c11db7, zero initial value, no\n// final xor. It shares a name with the function below and nothing else, and its\n// own comment says so.\n//\n// Nor does the independent copy in `test/.../gr2/writer.test.mjs` belong here.\n// A test that verifies a checksum by importing the implementation it is testing\n// proves only that the function equals itself; that copy is a deliberate oracle\n// and is meant to stay separate.\n\n/** Reflected CRC-32 polynomial, as used by zlib, PNG, GZIP and Carbon's containers. */\nconst CRC32_POLYNOMIAL = 0xedb88320;\n\n/** Largest prime below 65536 — Adler-32's modulus. */\nconst ADLER32_MODULUS = 65521;\n\nconst CRC32_TABLE = (() =>\n{\n    const table = new Uint32Array(256);\n    for (let index = 0; index < 256; index++)\n    {\n        let value = index;\n        for (let bit = 0; bit < 8; bit++)\n        {\n            value = (value & 1) ? (CRC32_POLYNOMIAL ^ (value >>> 1)) : (value >>> 1);\n        }\n        table[index] = value >>> 0;\n    }\n    return table;\n})();\n\n/**\n * Standard CRC-32 over a byte range.\n *\n * Reflected polynomial, initial value all ones, final one's complement — the\n * variant PNG chunks, zlib streams, CMF containers and GR2 sections all use.\n *\n * @param {Uint8Array} bytes Source bytes.\n * @param {number} [start] First byte offset, inclusive.\n * @param {number} [end] Last byte offset, exclusive.\n * @returns {number} Unsigned 32-bit checksum.\n */\nexport function crc32(bytes, start = 0, end = bytes.length)\n{\n    let crc = 0xffffffff;\n    for (let index = start; index < end; index++)\n    {\n        crc = (crc >>> 8) ^ CRC32_TABLE[(crc ^ bytes[index]) & 0xff];\n    }\n    return (crc ^ 0xffffffff) >>> 0;\n}\n\n/**\n * Adler-32 over a byte range, as zlib streams carry it.\n *\n * @param {Uint8Array} bytes Source bytes.\n * @param {number} [start] First byte offset, inclusive.\n * @param {number} [end] Last byte offset, exclusive.\n * @returns {number} Unsigned 32-bit checksum.\n */\nexport function adler32(bytes, start = 0, end = bytes.length)\n{\n    let\n        a = 1,\n        b = 0;\n\n    for (let index = start; index < end; index++)\n    {\n        a = (a + bytes[index]) % ADLER32_MODULUS;\n        b = (b + a) % ADLER32_MODULUS;\n    }\n\n    return (((b << 16) >>> 0) | a) >>> 0;\n}\n"],"names":["CRC32_POLYNOMIAL","ADLER32_MODULUS","CRC32_TABLE","table","Uint32Array","index","value","bit","crc32","bytes","start","end","length","crc","adler32","a","b"],"mappings":"AAAA;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,gBAAgB,GAAG,UAAU;;AAEnC;AACA,MAAMC,eAAe,GAAG,KAAK;AAE7B,MAAMC,WAAW,GAAG,CAAC,MACrB;AACI,EAAA,MAAMC,KAAK,GAAG,IAAIC,WAAW,CAAC,GAAG,CAAC;EAClC,KAAK,IAAIC,KAAK,GAAG,CAAC,EAAEA,KAAK,GAAG,GAAG,EAAEA,KAAK,EAAE,EACxC;IACI,IAAIC,KAAK,GAAGD,KAAK;IACjB,KAAK,IAAIE,GAAG,GAAG,CAAC,EAAEA,GAAG,GAAG,CAAC,EAAEA,GAAG,EAAE,EAChC;AACID,MAAAA,KAAK,GAAIA,KAAK,GAAG,CAAC,GAAKN,gBAAgB,GAAIM,KAAK,KAAK,CAAE,GAAKA,KAAK,KAAK,CAAE;AAC5E,IAAA;AACAH,IAAAA,KAAK,CAACE,KAAK,CAAC,GAAGC,KAAK,KAAK,CAAC;AAC9B,EAAA;AACA,EAAA,OAAOH,KAAK;AAChB,CAAC,GAAG;;AAEJ;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASK,KAAKA,CAACC,KAAK,EAAEC,KAAK,GAAG,CAAC,EAAEC,GAAG,GAAGF,KAAK,CAACG,MAAM,EAC1D;EACI,IAAIC,GAAG,GAAG,UAAU;EACpB,KAAK,IAAIR,KAAK,GAAGK,KAAK,EAAEL,KAAK,GAAGM,GAAG,EAAEN,KAAK,EAAE,EAC5C;AACIQ,IAAAA,GAAG,GAAIA,GAAG,KAAK,CAAC,GAAIX,WAAW,CAAC,CAACW,GAAG,GAAGJ,KAAK,CAACJ,KAAK,CAAC,IAAI,IAAI,CAAC;AAChE,EAAA;AACA,EAAA,OAAO,CAACQ,GAAG,GAAG,UAAU,MAAM,CAAC;AACnC;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASC,OAAOA,CAACL,KAAK,EAAEC,KAAK,GAAG,CAAC,EAAEC,GAAG,GAAGF,KAAK,CAACG,MAAM,EAC5D;EACI,IACIG,CAAC,GAAG,CAAC;AACLC,IAAAA,CAAC,GAAG,CAAC;EAET,KAAK,IAAIX,KAAK,GAAGK,KAAK,EAAEL,KAAK,GAAGM,GAAG,EAAEN,KAAK,EAAE,EAC5C;IACIU,CAAC,GAAG,CAACA,CAAC,GAAGN,KAAK,CAACJ,KAAK,CAAC,IAAIJ,eAAe;AACxCe,IAAAA,CAAC,GAAG,CAACA,CAAC,GAAGD,CAAC,IAAId,eAAe;AACjC,EAAA;EAEA,OAAO,CAAGe,CAAC,IAAI,EAAE,KAAM,CAAC,GAAID,CAAC,MAAM,CAAC;AACxC;;;;"}

package/dist/global/utils/errors/CjsCancellationError.js

@@ -0,0 +1,36 @@
+import { CjsError } from './CjsError.js';
+
+const DEFAULT_CANCELLATION_MESSAGE = "The operation was cancelled.";
+const CJS_OPERATION_CANCELLED = "CJS_OPERATION_CANCELLED";
+
+/** Represents one cancelled operation using Web-compatible abort identity. */
+class CjsCancellationError extends CjsError {
+  /**
+   * Creates a cancellation error with stable code `CJS_OPERATION_CANCELLED`.
+   *
+   * @param {string} [message]
+   * @param {{cause?: *, details?: object|null}} [options]
+   */
+  constructor(message = DEFAULT_CANCELLATION_MESSAGE, options = {}) {
+    super(CJS_OPERATION_CANCELLED, message, options);
+    this.name = "AbortError";
+  }
+
+  /**
+   * Checks for this cancellation type, its stable code, or a platform
+   * `AbortError` name.
+   */
+  static is(error) {
+    if (CjsError.hasCode(error, CJS_OPERATION_CANCELLED)) {
+      return true;
+    }
+    try {
+      return error?.name === "AbortError";
+    } catch {
+      return false;
+    }
+  }
+}
+
+export { CJS_OPERATION_CANCELLED, CjsCancellationError };
+//# sourceMappingURL=CjsCancellationError.js.map

package/dist/global/utils/errors/CjsCancellationError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CjsCancellationError.js","sources":["../../../../../src/global/utils/errors/CjsCancellationError.js"],"sourcesContent":["import { CjsError } from \"./CjsError.js\";\r\n\r\n\r\nconst DEFAULT_CANCELLATION_MESSAGE = \"The operation was cancelled.\";\r\n\r\nexport const CJS_OPERATION_CANCELLED = \"CJS_OPERATION_CANCELLED\";\r\n\r\n\r\n\r\n/** Represents one cancelled operation using Web-compatible abort identity. */\r\nexport class CjsCancellationError extends CjsError\r\n{\r\n\r\n    /**\r\n     * Creates a cancellation error with stable code `CJS_OPERATION_CANCELLED`.\r\n     *\r\n     * @param {string} [message]\r\n     * @param {{cause?: *, details?: object|null}} [options]\r\n     */\r\n    constructor(message = DEFAULT_CANCELLATION_MESSAGE, options = {})\r\n    {\r\n        super(CJS_OPERATION_CANCELLED, message, options);\r\n        this.name = \"AbortError\";\r\n    }\r\n\r\n    /**\r\n     * Checks for this cancellation type, its stable code, or a platform\r\n     * `AbortError` name.\r\n     */\r\n    static is(error)\r\n    {\r\n        if (CjsError.hasCode(error, CJS_OPERATION_CANCELLED))\r\n        {\r\n            return true;\r\n        }\r\n\r\n        try\r\n        {\r\n            return error?.name === \"AbortError\";\r\n        }\r\n        catch\r\n        {\r\n            return false;\r\n        }\r\n    }\r\n\r\n}\r\n"],"names":["DEFAULT_CANCELLATION_MESSAGE","CJS_OPERATION_CANCELLED","CjsCancellationError","CjsError","constructor","message","options","name","is","error","hasCode"],"mappings":";;AAGA,MAAMA,4BAA4B,GAAG,8BAA8B;AAE5D,MAAMC,uBAAuB,GAAG;;AAIvC;AACO,MAAMC,oBAAoB,SAASC,QAAQ,CAClD;AAEI;AACJ;AACA;AACA;AACA;AACA;EACIC,WAAWA,CAACC,OAAO,GAAGL,4BAA4B,EAAEM,OAAO,GAAG,EAAE,EAChE;AACI,IAAA,KAAK,CAACL,uBAAuB,EAAEI,OAAO,EAAEC,OAAO,CAAC;IAChD,IAAI,CAACC,IAAI,GAAG,YAAY;AAC5B,EAAA;;AAEA;AACJ;AACA;AACA;EACI,OAAOC,EAAEA,CAACC,KAAK,EACf;IACI,IAAIN,QAAQ,CAACO,OAAO,CAACD,KAAK,EAAER,uBAAuB,CAAC,EACpD;AACI,MAAA,OAAO,IAAI;AACf,IAAA;IAEA,IACA;AACI,MAAA,OAAOQ,KAAK,EAAEF,IAAI,KAAK,YAAY;AACvC,IAAA,CAAC,CACD,MACA;AACI,MAAA,OAAO,KAAK;AAChB,IAAA;AACJ,EAAA;AAEJ;;;;"}

package/dist/global/utils/errors/CjsError.js

@@ -1,25 +1,23 @@
 import { isPlainObject } from '../is.js';
 
-const ERROR_CODE_PATTERN = /^CJS_[A-Z][A-Z0-9]*(?:_[A-Z][A-Z0-9]*)*$/u,
-  DEFAULT_CANCELLATION_MESSAGE = "The operation was cancelled.";
-const CJS_OPERATION_CANCELLED = "CJS_OPERATION_CANCELLED";
+const ERROR_CODE_PATTERN = /^CJS_[A-Z][A-Z0-9]*(?:_[A-Z][A-Z0-9]*)*$/u;
 
-/**
- * Represents one structured operational failure with a stable CarbonEngineJS code.
- *
- * Programmer-contract violations should continue to use native error classes
- * such as `TypeError`, `RangeError`, and `SyntaxError`.
+/**
+ * Represents one structured operational failure with a stable CarbonEngineJS code.
+ *
+ * Programmer-contract violations should continue to use native error classes
+ * such as `TypeError`, `RangeError`, and `SyntaxError`.
  */
 class CjsError extends Error {
-  /**
-   * Creates an operational error.
-   *
-   * Details are detached and deeply frozen JSON-safe data. Cause identity is
-   * preserved through the native `Error` cause property when supplied.
-   *
-   * @param {string} code Stable uppercase `CJS_*` machine-readable code.
-   * @param {string} message Human-readable failure description.
-   * @param {{cause?: *, details?: object|null}} [options]
+  /**
+   * Creates an operational error.
+   *
+   * Details are detached and deeply frozen JSON-safe data. Cause identity is
+   * preserved through the native `Error` cause property when supplied.
+   *
+   * @param {string} code Stable uppercase `CJS_*` machine-readable code.
+   * @param {string} message Human-readable failure description.
+   * @param {{cause?: *, details?: object|null}} [options]
    */
   constructor(code, message, options = {}) {
     const normalizedCode = CjsError.#NormalizeCode(code),
@@ -46,11 +44,11 @@ class CjsError extends Error {
     });
   }
 
-  /**
-   * Checks a structured or legacy error for an exact stable code.
-   *
-   * Invalid candidate codes and inaccessible error properties return false
-   * so this helper remains safe inside failure handling.
+  /**
+   * Checks a structured or legacy error for an exact stable code.
+   *
+   * Invalid candidate codes and inaccessible error properties return false
+   * so this helper remains safe inside failure handling.
    */
   static hasCode(error, code) {
     if (!CjsError.#IsCode(code) || error === null || error === undefined) {
@@ -169,34 +167,5 @@ class CjsError extends Error {
   }
 }
 
-/** Represents one cancelled operation using Web-compatible abort identity. */
-class CjsCancellationError extends CjsError {
-  /**
-   * Creates a cancellation error with stable code `CJS_OPERATION_CANCELLED`.
-   *
-   * @param {string} [message]
-   * @param {{cause?: *, details?: object|null}} [options]
-   */
-  constructor(message = DEFAULT_CANCELLATION_MESSAGE, options = {}) {
-    super(CJS_OPERATION_CANCELLED, message, options);
-    this.name = "AbortError";
-  }
-
-  /**
-   * Checks for this cancellation type, its stable code, or a platform
-   * `AbortError` name.
-   */
-  static is(error) {
-    if (CjsError.hasCode(error, CJS_OPERATION_CANCELLED)) {
-      return true;
-    }
-    try {
-      return error?.name === "AbortError";
-    } catch {
-      return false;
-    }
-  }
-}
-
-export { CJS_OPERATION_CANCELLED, CjsCancellationError, CjsError };
+export { CjsError };
 //# sourceMappingURL=CjsError.js.map

package/dist/global/utils/errors/CjsError.js.map

@@ -1 +1 @@
-{"version":3,"file":"CjsError.js","sources":["../../../../../src/global/utils/errors/CjsError.js"],"sourcesContent":["import { isPlainObject } from \"../is.js\";\n\nconst\n    ERROR_CODE_PATTERN = /^CJS_[A-Z][A-Z0-9]*(?:_[A-Z][A-Z0-9]*)*$/u,\n    DEFAULT_CANCELLATION_MESSAGE = \"The operation was cancelled.\";\n\nexport const CJS_OPERATION_CANCELLED = \"CJS_OPERATION_CANCELLED\";\n\n/**\n * Represents one structured operational failure with a stable CarbonEngineJS code.\n *\n * Programmer-contract violations should continue to use native error classes\n * such as `TypeError`, `RangeError`, and `SyntaxError`.\n */\nexport class CjsError extends Error\n{\n\n    /**\n     * Creates an operational error.\n     *\n     * Details are detached and deeply frozen JSON-safe data. Cause identity is\n     * preserved through the native `Error` cause property when supplied.\n     *\n     * @param {string} code Stable uppercase `CJS_*` machine-readable code.\n     * @param {string} message Human-readable failure description.\n     * @param {{cause?: *, details?: object|null}} [options]\n     */\n    constructor(code, message, options = {})\n    {\n        const\n            normalizedCode = CjsError.#NormalizeCode(code),\n            normalizedMessage = CjsError.#NormalizeMessage(message),\n            normalizedOptions = CjsError.#NormalizeOptions(options),\n            errorOptions = Object.hasOwn(normalizedOptions, \"cause\")\n                ? { cause: normalizedOptions.cause }\n                : undefined;\n\n        super(normalizedMessage, errorOptions);\n\n        this.name = new.target.name;\n\n        Object.defineProperties(this, {\n            code: {\n                value: normalizedCode,\n                enumerable: true,\n                configurable: false,\n                writable: false\n            },\n            details: {\n                value: CjsError.#NormalizeDetails(normalizedOptions.details),\n                enumerable: true,\n                configurable: false,\n                writable: false\n            }\n        });\n    }\n\n    /**\n     * Checks a structured or legacy error for an exact stable code.\n     *\n     * Invalid candidate codes and inaccessible error properties return false\n     * so this helper remains safe inside failure handling.\n     */\n    static hasCode(error, code)\n    {\n        if (!CjsError.#IsCode(code) || error === null || error === undefined)\n        {\n            return false;\n        }\n\n        try\n        {\n            return error.code === code;\n        }\n        catch\n        {\n            return false;\n        }\n    }\n\n    /** Reports whether a value is one valid stable error code. */\n    static #IsCode(value)\n    {\n        return typeof value === \"string\" && ERROR_CODE_PATTERN.test(value);\n    }\n\n    /** Validates and returns one stable error code. */\n    static #NormalizeCode(value)\n    {\n        if (!CjsError.#IsCode(value))\n        {\n            throw new TypeError(\"code must be an uppercase CJS_* identifier.\");\n        }\n\n        return value;\n    }\n\n    /** Validates and returns one non-empty error message. */\n    static #NormalizeMessage(value)\n    {\n        if (typeof value !== \"string\" || value.trim() === \"\")\n        {\n            throw new TypeError(\"message must be a non-empty string.\");\n        }\n\n        return value;\n    }\n\n    /** Validates and returns one plain constructor-options record. */\n    static #NormalizeOptions(value)\n    {\n        if (!isPlainObject(value))\n        {\n            throw new TypeError(\"options must be a plain object.\");\n        }\n\n        return value;\n    }\n\n    /** Converts optional details into detached deeply frozen data. */\n    static #NormalizeDetails(value)\n    {\n        if (value === undefined || value === null)\n        {\n            return null;\n        }\n\n        if (!isPlainObject(value))\n        {\n            throw new TypeError(\"details must be a JSON-safe plain object or null.\");\n        }\n\n        return CjsError.#CloneDetailsValue(value, \"details\", new Set());\n    }\n\n    /** Clones one JSON-safe details value while detecting active cycles. */\n    static #CloneDetailsValue(value, path, active)\n    {\n        if (value === null || typeof value === \"string\" || typeof value === \"boolean\")\n        {\n            return value;\n        }\n\n        if (typeof value === \"number\")\n        {\n            if (!Number.isFinite(value))\n            {\n                throw new TypeError(`${path} must contain only finite numbers.`);\n            }\n\n            return value;\n        }\n\n        if (!Array.isArray(value) && !isPlainObject(value))\n        {\n            throw new TypeError(`${path} must contain only JSON-safe values.`);\n        }\n\n        if (active.has(value))\n        {\n            throw new TypeError(`${path} must not contain a circular reference.`);\n        }\n\n        active.add(value);\n\n        const clone = Array.isArray(value)\n            ? CjsError.#CloneDetailsArray(value, path, active)\n            : CjsError.#CloneDetailsRecord(value, path, active);\n\n        active.delete(value);\n        return clone;\n    }\n\n    /** Clones one dense JSON-safe details array. */\n    static #CloneDetailsArray(value, path, active)\n    {\n        const clone = [];\n\n        for (const key of Reflect.ownKeys(value))\n        {\n            if (key === \"length\")\n            {\n                continue;\n            }\n\n            if (typeof key !== \"string\"\n                || !/^(?:0|[1-9]\\d*)$/u.test(key)\n                || Number(key) >= value.length)\n            {\n                throw new TypeError(`${path} arrays must contain only indexed values.`);\n            }\n        }\n\n        for (let i = 0; i < value.length; i++)\n        {\n            const descriptor = Object.getOwnPropertyDescriptor(value, String(i));\n\n            if (!descriptor?.enumerable || !Object.hasOwn(descriptor, \"value\"))\n            {\n                throw new TypeError(`${path} arrays must contain dense data properties.`);\n            }\n\n            clone.push(CjsError.#CloneDetailsValue(\n                descriptor.value,\n                `${path}[${i}]`,\n                active\n            ));\n        }\n\n        return clone;\n    }\n\n    /** Clones one plain JSON-safe details record. */\n    static #CloneDetailsRecord(value, path, active)\n    {\n        const clone = {};\n\n        for (const key of Reflect.ownKeys(value))\n        {\n            if (typeof key !== \"string\")\n            {\n                throw new TypeError(`${path} must not contain symbol keys.`);\n            }\n\n            const descriptor = Object.getOwnPropertyDescriptor(value, key);\n\n            if (!descriptor?.enumerable || !Object.hasOwn(descriptor, \"value\"))\n            {\n                throw new TypeError(`${path} must contain only enumerable data properties.`);\n            }\n\n            Object.defineProperty(clone, key, {\n                value: CjsError.#CloneDetailsValue(\n                    descriptor.value,\n                    `${path}[${JSON.stringify(key)}]`,\n                    active\n                ),\n                enumerable: true,\n                configurable: false,\n                writable: false\n            });\n        }\n\n        return clone;\n    }\n\n}\n\n/** Represents one cancelled operation using Web-compatible abort identity. */\nexport class CjsCancellationError extends CjsError\n{\n\n    /**\n     * Creates a cancellation error with stable code `CJS_OPERATION_CANCELLED`.\n     *\n     * @param {string} [message]\n     * @param {{cause?: *, details?: object|null}} [options]\n     */\n    constructor(message = DEFAULT_CANCELLATION_MESSAGE, options = {})\n    {\n        super(CJS_OPERATION_CANCELLED, message, options);\n        this.name = \"AbortError\";\n    }\n\n    /**\n     * Checks for this cancellation type, its stable code, or a platform\n     * `AbortError` name.\n     */\n    static is(error)\n    {\n        if (CjsError.hasCode(error, CJS_OPERATION_CANCELLED))\n        {\n            return true;\n        }\n\n        try\n        {\n            return error?.name === \"AbortError\";\n        }\n        catch\n        {\n            return false;\n        }\n    }\n\n}\n"],"names":["ERROR_CODE_PATTERN","DEFAULT_CANCELLATION_MESSAGE","CJS_OPERATION_CANCELLED","CjsError","Error","constructor","code","message","options","normalizedCode","normalizedMessage","normalizedOptions","errorOptions","Object","hasOwn","cause","undefined","name","new","target","defineProperties","value","enumerable","configurable","writable","details","hasCode","error","#IsCode","test","#NormalizeCode","TypeError","#NormalizeMessage","trim","#NormalizeOptions","isPlainObject","#NormalizeDetails","Set","#CloneDetailsValue","path","active","Number","isFinite","Array","isArray","has","add","clone","delete","#CloneDetailsArray","key","Reflect","ownKeys","length","i","descriptor","getOwnPropertyDescriptor","String","push","#CloneDetailsRecord","defineProperty","JSON","stringify","CjsCancellationError","is"],"mappings":"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"}
+{"version":3,"file":"CjsError.js","sources":["../../../../../src/global/utils/errors/CjsError.js"],"sourcesContent":["import { isPlainObject } from \"../is.js\";\r\n\r\nconst\r\n    ERROR_CODE_PATTERN = /^CJS_[A-Z][A-Z0-9]*(?:_[A-Z][A-Z0-9]*)*$/u;\r\n\r\n/**\r\n * Represents one structured operational failure with a stable CarbonEngineJS code.\r\n *\r\n * Programmer-contract violations should continue to use native error classes\r\n * such as `TypeError`, `RangeError`, and `SyntaxError`.\r\n */\r\nexport class CjsError extends Error\r\n{\r\n\r\n    /**\r\n     * Creates an operational error.\r\n     *\r\n     * Details are detached and deeply frozen JSON-safe data. Cause identity is\r\n     * preserved through the native `Error` cause property when supplied.\r\n     *\r\n     * @param {string} code Stable uppercase `CJS_*` machine-readable code.\r\n     * @param {string} message Human-readable failure description.\r\n     * @param {{cause?: *, details?: object|null}} [options]\r\n     */\r\n    constructor(code, message, options = {})\r\n    {\r\n        const\r\n            normalizedCode = CjsError.#NormalizeCode(code),\r\n            normalizedMessage = CjsError.#NormalizeMessage(message),\r\n            normalizedOptions = CjsError.#NormalizeOptions(options),\r\n            errorOptions = Object.hasOwn(normalizedOptions, \"cause\")\r\n                ? { cause: normalizedOptions.cause }\r\n                : undefined;\r\n\r\n        super(normalizedMessage, errorOptions);\r\n\r\n        this.name = new.target.name;\r\n\r\n        Object.defineProperties(this, {\r\n            code: {\r\n                value: normalizedCode,\r\n                enumerable: true,\r\n                configurable: false,\r\n                writable: false\r\n            },\r\n            details: {\r\n                value: CjsError.#NormalizeDetails(normalizedOptions.details),\r\n                enumerable: true,\r\n                configurable: false,\r\n                writable: false\r\n            }\r\n        });\r\n    }\r\n\r\n    /**\r\n     * Checks a structured or legacy error for an exact stable code.\r\n     *\r\n     * Invalid candidate codes and inaccessible error properties return false\r\n     * so this helper remains safe inside failure handling.\r\n     */\r\n    static hasCode(error, code)\r\n    {\r\n        if (!CjsError.#IsCode(code) || error === null || error === undefined)\r\n        {\r\n            return false;\r\n        }\r\n\r\n        try\r\n        {\r\n            return error.code === code;\r\n        }\r\n        catch\r\n        {\r\n            return false;\r\n        }\r\n    }\r\n\r\n    /** Reports whether a value is one valid stable error code. */\r\n    static #IsCode(value)\r\n    {\r\n        return typeof value === \"string\" && ERROR_CODE_PATTERN.test(value);\r\n    }\r\n\r\n    /** Validates and returns one stable error code. */\r\n    static #NormalizeCode(value)\r\n    {\r\n        if (!CjsError.#IsCode(value))\r\n        {\r\n            throw new TypeError(\"code must be an uppercase CJS_* identifier.\");\r\n        }\r\n\r\n        return value;\r\n    }\r\n\r\n    /** Validates and returns one non-empty error message. */\r\n    static #NormalizeMessage(value)\r\n    {\r\n        if (typeof value !== \"string\" || value.trim() === \"\")\r\n        {\r\n            throw new TypeError(\"message must be a non-empty string.\");\r\n        }\r\n\r\n        return value;\r\n    }\r\n\r\n    /** Validates and returns one plain constructor-options record. */\r\n    static #NormalizeOptions(value)\r\n    {\r\n        if (!isPlainObject(value))\r\n        {\r\n            throw new TypeError(\"options must be a plain object.\");\r\n        }\r\n\r\n        return value;\r\n    }\r\n\r\n    /** Converts optional details into detached deeply frozen data. */\r\n    static #NormalizeDetails(value)\r\n    {\r\n        if (value === undefined || value === null)\r\n        {\r\n            return null;\r\n        }\r\n\r\n        if (!isPlainObject(value))\r\n        {\r\n            throw new TypeError(\"details must be a JSON-safe plain object or null.\");\r\n        }\r\n\r\n        return CjsError.#CloneDetailsValue(value, \"details\", new Set());\r\n    }\r\n\r\n    /** Clones one JSON-safe details value while detecting active cycles. */\r\n    static #CloneDetailsValue(value, path, active)\r\n    {\r\n        if (value === null || typeof value === \"string\" || typeof value === \"boolean\")\r\n        {\r\n            return value;\r\n        }\r\n\r\n        if (typeof value === \"number\")\r\n        {\r\n            if (!Number.isFinite(value))\r\n            {\r\n                throw new TypeError(`${path} must contain only finite numbers.`);\r\n            }\r\n\r\n            return value;\r\n        }\r\n\r\n        if (!Array.isArray(value) && !isPlainObject(value))\r\n        {\r\n            throw new TypeError(`${path} must contain only JSON-safe values.`);\r\n        }\r\n\r\n        if (active.has(value))\r\n        {\r\n            throw new TypeError(`${path} must not contain a circular reference.`);\r\n        }\r\n\r\n        active.add(value);\r\n\r\n        const clone = Array.isArray(value)\r\n            ? CjsError.#CloneDetailsArray(value, path, active)\r\n            : CjsError.#CloneDetailsRecord(value, path, active);\r\n\r\n        active.delete(value);\r\n        return clone;\r\n    }\r\n\r\n    /** Clones one dense JSON-safe details array. */\r\n    static #CloneDetailsArray(value, path, active)\r\n    {\r\n        const clone = [];\r\n\r\n        for (const key of Reflect.ownKeys(value))\r\n        {\r\n            if (key === \"length\")\r\n            {\r\n                continue;\r\n            }\r\n\r\n            if (typeof key !== \"string\"\r\n                || !/^(?:0|[1-9]\\d*)$/u.test(key)\r\n                || Number(key) >= value.length)\r\n            {\r\n                throw new TypeError(`${path} arrays must contain only indexed values.`);\r\n            }\r\n        }\r\n\r\n        for (let i = 0; i < value.length; i++)\r\n        {\r\n            const descriptor = Object.getOwnPropertyDescriptor(value, String(i));\r\n\r\n            if (!descriptor?.enumerable || !Object.hasOwn(descriptor, \"value\"))\r\n            {\r\n                throw new TypeError(`${path} arrays must contain dense data properties.`);\r\n            }\r\n\r\n            clone.push(CjsError.#CloneDetailsValue(\r\n                descriptor.value,\r\n                `${path}[${i}]`,\r\n                active\r\n            ));\r\n        }\r\n\r\n        return clone;\r\n    }\r\n\r\n    /** Clones one plain JSON-safe details record. */\r\n    static #CloneDetailsRecord(value, path, active)\r\n    {\r\n        const clone = {};\r\n\r\n        for (const key of Reflect.ownKeys(value))\r\n        {\r\n            if (typeof key !== \"string\")\r\n            {\r\n                throw new TypeError(`${path} must not contain symbol keys.`);\r\n            }\r\n\r\n            const descriptor = Object.getOwnPropertyDescriptor(value, key);\r\n\r\n            if (!descriptor?.enumerable || !Object.hasOwn(descriptor, \"value\"))\r\n            {\r\n                throw new TypeError(`${path} must contain only enumerable data properties.`);\r\n            }\r\n\r\n            Object.defineProperty(clone, key, {\r\n                value: CjsError.#CloneDetailsValue(\r\n                    descriptor.value,\r\n                    `${path}[${JSON.stringify(key)}]`,\r\n                    active\r\n                ),\r\n                enumerable: true,\r\n                configurable: false,\r\n                writable: false\r\n            });\r\n        }\r\n\r\n        return clone;\r\n    }\r\n\n}\n"],"names":["ERROR_CODE_PATTERN","CjsError","Error","constructor","code","message","options","normalizedCode","normalizedMessage","normalizedOptions","errorOptions","Object","hasOwn","cause","undefined","name","new","target","defineProperties","value","enumerable","configurable","writable","details","hasCode","error","#IsCode","test","#NormalizeCode","TypeError","#NormalizeMessage","trim","#NormalizeOptions","isPlainObject","#NormalizeDetails","Set","#CloneDetailsValue","path","active","Number","isFinite","Array","isArray","has","add","clone","delete","#CloneDetailsArray","key","Reflect","ownKeys","length","i","descriptor","getOwnPropertyDescriptor","String","push","#CloneDetailsRecord","defineProperty","JSON","stringify"],"mappings":"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"}

package/dist/global/utils/errors/abort.js

@@ -1,4 +1,4 @@
-import { CjsCancellationError } from './CjsError.js';
+import { CjsCancellationError } from './CjsCancellationError.js';
 
 /**
  * Throws when an abort signal has already been aborted.

package/dist/global/utils/errors/abort.js.map

@@ -1 +1 @@
-{"version":3,"file":"abort.js","sources":["../../../../../src/global/utils/errors/abort.js"],"sourcesContent":["import { CjsCancellationError } from \"./CjsError.js\";\n\n/**\n * Throws when an abort signal has already been aborted.\n *\n * The caller's abort reason is always preserved. A native\n * `AbortSignal.throwIfAborted` is delegated to when present, and an explicitly\n * supplied `Error` reason is rethrown by identity, so a caller that aborted\n * with its own error sees that error and not a substitute. A missing or\n * non-`Error` reason becomes one `CjsCancellationError`, which carries the raw\n * reason as its cause. Every error this throws answers to\n * `name === \"AbortError\"`.\n *\n * @param {AbortSignal|{aborted?: boolean, reason?: *}|null} [signal] Signal to test.\n * @param {string} [message] Fallback message used when no reason is carried.\n * @returns {void}\n */\nexport function throwIfAborted(signal, message)\n{\n    if (!signal?.aborted)\n    {\n        return;\n    }\n\n    // The reason is inspected before the native method is consulted. A real\n    // AbortSignal always carries one, and its platform default is a DOMException\n    // that is itself an Error, so this branch reproduces the native throw\n    // exactly. Delegating first would rethrow a non-Error reason raw and lose\n    // the wrapping below.\n    if (signal.reason instanceof Error)\n    {\n        throw signal.reason;\n    }\n\n    if (signal.reason === undefined && typeof signal.throwIfAborted === \"function\")\n    {\n        signal.throwIfAborted();\n    }\n\n    throw new CjsCancellationError(\n        message ?? \"The operation was cancelled.\",\n        signal.reason === undefined ? undefined : { cause: signal.reason }\n    );\n}\n"],"names":["throwIfAborted","signal","message","aborted","reason","Error","undefined","CjsCancellationError","cause"],"mappings":";;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASA,cAAcA,CAACC,MAAM,EAAEC,OAAO,EAC9C;AACI,EAAA,IAAI,CAACD,MAAM,EAAEE,OAAO,EACpB;AACI,IAAA;AACJ,EAAA;;AAEA;AACA;AACA;AACA;AACA;AACA,EAAA,IAAIF,MAAM,CAACG,MAAM,YAAYC,KAAK,EAClC;IACI,MAAMJ,MAAM,CAACG,MAAM;AACvB,EAAA;AAEA,EAAA,IAAIH,MAAM,CAACG,MAAM,KAAKE,SAAS,IAAI,OAAOL,MAAM,CAACD,cAAc,KAAK,UAAU,EAC9E;IACIC,MAAM,CAACD,cAAc,EAAE;AAC3B,EAAA;AAEA,EAAA,MAAM,IAAIO,oBAAoB,CAC1BL,OAAO,IAAI,8BAA8B,EACzCD,MAAM,CAACG,MAAM,KAAKE,SAAS,GAAGA,SAAS,GAAG;IAAEE,KAAK,EAAEP,MAAM,CAACG;AAAO,GACrE,CAAC;AACL;;;;"}
+{"version":3,"file":"abort.js","sources":["../../../../../src/global/utils/errors/abort.js"],"sourcesContent":["import { CjsCancellationError } from \"./CjsCancellationError.js\";\n\n/**\n * Throws when an abort signal has already been aborted.\n *\n * The caller's abort reason is always preserved. A native\n * `AbortSignal.throwIfAborted` is delegated to when present, and an explicitly\n * supplied `Error` reason is rethrown by identity, so a caller that aborted\n * with its own error sees that error and not a substitute. A missing or\n * non-`Error` reason becomes one `CjsCancellationError`, which carries the raw\n * reason as its cause. Every error this throws answers to\n * `name === \"AbortError\"`.\n *\n * @param {AbortSignal|{aborted?: boolean, reason?: *}|null} [signal] Signal to test.\n * @param {string} [message] Fallback message used when no reason is carried.\n * @returns {void}\n */\nexport function throwIfAborted(signal, message)\n{\n    if (!signal?.aborted)\n    {\n        return;\n    }\n\n    // The reason is inspected before the native method is consulted. A real\n    // AbortSignal always carries one, and its platform default is a DOMException\n    // that is itself an Error, so this branch reproduces the native throw\n    // exactly. Delegating first would rethrow a non-Error reason raw and lose\n    // the wrapping below.\n    if (signal.reason instanceof Error)\n    {\n        throw signal.reason;\n    }\n\n    if (signal.reason === undefined && typeof signal.throwIfAborted === \"function\")\n    {\n        signal.throwIfAborted();\n    }\n\n    throw new CjsCancellationError(\n        message ?? \"The operation was cancelled.\",\n        signal.reason === undefined ? undefined : { cause: signal.reason }\n    );\n}\n"],"names":["throwIfAborted","signal","message","aborted","reason","Error","undefined","CjsCancellationError","cause"],"mappings":";;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASA,cAAcA,CAACC,MAAM,EAAEC,OAAO,EAC9C;AACI,EAAA,IAAI,CAACD,MAAM,EAAEE,OAAO,EACpB;AACI,IAAA;AACJ,EAAA;;AAEA;AACA;AACA;AACA;AACA;AACA,EAAA,IAAIF,MAAM,CAACG,MAAM,YAAYC,KAAK,EAClC;IACI,MAAMJ,MAAM,CAACG,MAAM;AACvB,EAAA;AAEA,EAAA,IAAIH,MAAM,CAACG,MAAM,KAAKE,SAAS,IAAI,OAAOL,MAAM,CAACD,cAAc,KAAK,UAAU,EAC9E;IACIC,MAAM,CAACD,cAAc,EAAE;AAC3B,EAAA;AAEA,EAAA,MAAM,IAAIO,oBAAoB,CAC1BL,OAAO,IAAI,8BAA8B,EACzCD,MAAM,CAACG,MAAM,KAAKE,SAAS,GAAGA,SAAS,GAAG;IAAEE,KAAK,EAAEP,MAAM,CAACG;AAAO,GACrE,CAAC;AACL;;;;"}

package/dist/global/utils/errors/index.js

@@ -1,3 +1,4 @@
 export { throwIfAborted } from './abort.js';
-export { CJS_OPERATION_CANCELLED, CjsCancellationError, CjsError } from './CjsError.js';
+export { CjsError } from './CjsError.js';
+export { CJS_OPERATION_CANCELLED, CjsCancellationError } from './CjsCancellationError.js';
 //# sourceMappingURL=index.js.map

package/dist/global/utils/errors/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/global/utils/index.js

@@ -1,15 +1,17 @@
 export { copyArrayLike, fillArrayLike, toArray } from '../math/utils.js';
-export { asUint8Array, copyBytes, float32FromBits, hasBytePrefix, readFourCc, readU16BE, readU16LE, readU24BE, readU24LE, readU32BE, readU32LE, toArrayBuffer } from './bytes.js';
+export { asUint8Array, copyBytes, float32FromBits, float32ToBits, hasBytePrefix, readFourCc, readU16BE, readU16LE, readU24BE, readU24LE, readU32BE, readU32LE, toArrayBuffer } from './bytes.js';
 export { decompressBytes, decompressGzip, decompressGzipIfNeeded, isGzip } from './compression.js';
 export { EffectCarriesBackendBlock, EffectPlatformFromPath, GetEffectPathDefaults, NormalizeResourcePath, ResolveEffectPath, SetEffectPathDefaults, ShaderModelSuffix, ShaderModelSuffixes, TranslatedEffectPlatforms } from './effectPath.js';
 export { throwIfAborted } from './errors/abort.js';
-export { CJS_OPERATION_CANCELLED, CjsCancellationError, CjsError } from './errors/CjsError.js';
+export { CjsError } from './errors/CjsError.js';
+export { CJS_OPERATION_CANCELLED, CjsCancellationError } from './errors/CjsCancellationError.js';
 export { getTypeUpper, isArray, isArrayLike, isAsyncFunction, isBoolean, isCanvas, isDNA, isDate, isDateEqual, isDescriptor, isEqual, isError, isFunction, isInt16, isInt32, isInt8, isIterable, isMap, isMatrix3, isMatrix4, isNoU, isNull, isNullish, isNumber, isObject, isObjectLike, isObjectObject, isPlain, isPlainObject, isPrimary, isPrimaryEqual, isPromise, isPromiseLike, isSet, isString, isSubclassOf, isSymbol, isTag, isTr2OrTri, isTyped, isTypedArray, isUint16, isUint32, isUint8, isUndefined, isVector, isVector2, isVector3, isVector4, isVectorEqual, toTw2 } from './is.js';
 export { decodeJson, encodeJson } from './json.js';
 export { compareCodeUnits, indexBy, sortStrings } from './lookup.js';
 export { clonePlain, hasOwnThen } from './object.js';
 export { getResourceExtension, normalizePath, normalizeResourceExtension, normalizeResourcePath } from './path.js';
 export { isResFileAddressFor, parseResFileAddress, resFileAddress } from './resFile.js';
+export { adler32, crc32 } from './checksum.js';
 export { FNV1_INITIAL, fnv164, hashFnv1Floats, hashFnv1Identity, hashFnv1String } from './hash.js';
 export { decodeUtf8, encodeUtf8 } from './text.js';
 export { assertFiniteNumber, assertNonEmptyString, assertNonNegativeInteger, assertNonNegativeNumber, assertPlainObject, assertPositiveInteger, assertSupportedVersion, coerceFiniteNumber, coerceNonNegativeInteger, coercePositiveInteger, finiteNumberOr } from './validation.js';

package/dist/global/utils/index.js.map

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