@carbonenginejs/runtime-resource 0.12.2 → 0.13.0

package/dist/formats/black/CjsBlackFormat.js.map

@@ -1 +1 @@
-{"version":3,"file":"CjsBlackFormat.js","sources":["../../../../src/formats/black/CjsBlackFormat.js"],"sourcesContent":["import { CLASS_KEYS } from \"./core/schema.js\";\nimport {\n    DEFAULT_VALUES,\n    OUTPUT_DOCUMENT,\n    OUTPUT_JSON,\n    OUTPUT_PAYLOAD,\n    OUTPUT_RAW,\n    OUTPUT_RUNTIME,\n    normalizeValues,\n    toJsonValue,\n    validateClass,\n    validateClassKey\n} from \"./core/helpers.js\";\nimport {\n    CJS_BLACK_EXTENSION,\n    CJS_BLACK_FORMAT_ID,\n    CJS_BLACK_FOURCC,\n    CJS_BLACK_VERSION\n} from \"./core/blackConstants.js\";\nimport { CjsBlackReader } from \"./core/CjsBlackReader.js\";\n\nconst FORMAT_NAME = \"CjsBlackFormat\";\n\n/**\n * CarbonEngineJS-facing Black format profile.\n *\n * This package reads public-facing `.black` payload data using CarbonEngineJS\n * canonical schemas or source-shape registries.\n */\nexport class CjsBlackFormat\n{\n\n    #emit = DEFAULT_VALUES.emit;\n    #schema = DEFAULT_VALUES.schema;\n    #readerOptions = {};\n    #classes = {};\n\n    /**\n     * Plain payload outputs can be decoded in a browser worker. Document and\n     * runtime outputs retain class identity and therefore stay on the caller\n     * thread.\n     */\n    static worker = Object.freeze({\n        module: import.meta.url,\n        exportName: \"CjsBlackFormat\",\n        outputTypes: Object.freeze([ OUTPUT_JSON, OUTPUT_PAYLOAD ]),\n        defaultOutput: OUTPUT_JSON\n    });\n\n    /**\n     * Create a reusable format profile.\n     *\n     * @param {object} [options] Default format values.\n     */\n    constructor(options = {})\n    {\n        this.SetValues(options);\n    }\n\n    /**\n     * Set format values for this reusable profile.\n     *\n     * @param {object} [options] Values to merge into the profile.\n     * @returns {CjsBlackFormat} This format profile.\n     */\n    SetValues(options = {})\n    {\n        const values = normalizeValues(this.GetValues(), options, CLASS_KEYS, FORMAT_NAME);\n        this.#emit = values.emit;\n        this.#schema = values.schema;\n        this.#classes = values.classes;\n        this.#readerOptions = CjsBlackFormat.copyReaderOptions(values);\n        return this;\n    }\n\n    /**\n     * Get this profile's current values, optionally with per-call overrides.\n     *\n     * @param {object} [options] Optional values to merge into a copy.\n     * @returns {object} A copy of the effective values.\n     */\n    GetValues(options = {})\n    {\n        return normalizeValues({\n            emit: this.#emit,\n            schema: this.#schema,\n            ...this.#readerOptions,\n            classes: this.#classes\n        }, options, CLASS_KEYS, FORMAT_NAME);\n    }\n\n    /**\n     * Set multiple runtime class constructors for this profile.\n     *\n     * @param {object} [classes] Map of Black class names to constructors.\n     * @returns {CjsBlackFormat} This format profile.\n     */\n    SetClasses(classes = {})\n    {\n        return this.SetValues({ classes });\n    }\n\n    /**\n     * Set one node-class constructor for this profile.\n     *\n     * @param {string} type Black class name.\n     * @param {Function|null|undefined} Class Constructor to use, or nullish to delete.\n     * @returns {CjsBlackFormat} This format profile.\n     */\n    SetClass(type, Class)\n    {\n        validateClassKey(CLASS_KEYS, type, FORMAT_NAME);\n        if (Class === null || Class === undefined)\n        {\n            delete this.#classes[type];\n            return this;\n        }\n\n        validateClass(CLASS_KEYS, type, Class, FORMAT_NAME);\n        this.#classes = { ...this.#classes, [type]: Class };\n        return this;\n    }\n\n    /**\n     * Get a configured runtime class constructor.\n     *\n     * @param {string} type Black class name.\n     * @returns {Function|undefined} The registered constructor, if any.\n     */\n    GetClass(type)\n    {\n        validateClassKey(CLASS_KEYS, type, FORMAT_NAME);\n        return this.#classes[type];\n    }\n\n    /**\n     * Whether this format profile has a constructor registered for a node key.\n     *\n     * @param {string} type Node class key.\n     * @returns {boolean} True when a constructor is registered.\n     */\n    HasClass(type)\n    {\n        return !!this.GetClass(type);\n    }\n\n    /**\n     * Read Black data with this profile's values.\n     *\n     * @param {unknown} input Black format input.\n     * @param {object} [options] Per-call value overrides.\n     * @returns {object} Public payload output by default.\n     */\n    Read(input, options = {})\n    {\n        return CjsBlackFormat.read(input, this.GetValues(options));\n    }\n\n    /**\n     * Read Black data as a neutral document graph for diagnostics.\n     *\n     * @param {unknown} input Black format input.\n     * @param {object} [options] Per-call value overrides.\n     * @returns {object} CarbonEngineJS document graph.\n     */\n    ReadDocument(input, options = {})\n    {\n        return CjsBlackFormat.readDocument(input, this.GetValues(options));\n    }\n\n    /**\n     * Read Black data as runtime objects or plain source-shaped objects.\n     *\n     * @param {unknown} input Black format input.\n     * @param {object} [options] Per-call value overrides.\n     * @returns {object} Runtime read result.\n     */\n    ReadRuntime(input, options = {})\n    {\n        return CjsBlackFormat.readRuntime(input, this.GetValues(options));\n    }\n\n    /**\n     * Read Black data as compact public payload JSON.\n     *\n     * @param {unknown} input Black format input.\n     * @param {object} [options] Per-call value overrides.\n     * @returns {object} Public payload output.\n     */\n    ReadPayload(input, options = {})\n    {\n        return CjsBlackFormat.readPayload(input, this.GetValues(options));\n    }\n\n    /**\n     * Inspect Black data with this profile's values.\n     *\n     * @param {unknown} input Black format input.\n     * @param {object} [options] Per-call value overrides.\n     * @returns {object} Plain summary data.\n     */\n    Inspect(input, options = {})\n    {\n        return CjsBlackFormat.inspect(input, this.GetValues(options));\n    }\n\n    /**\n     * Convert format output to JSON-compatible data.\n     *\n     * @param {any} value Format output to convert.\n     * @returns {any} Plain JSON-compatible data.\n     */\n    ToJSON(value)\n    {\n        return toJsonValue(value);\n    }\n\n    /**\n     * Static one-shot read. Static methods use camelCase by convention.\n     *\n     * @param {unknown} input Black format input.\n     * @param {object} [options] Format values.\n     * @returns {object} Format output.\n     */\n    static read(input, options = {})\n    {\n        const values = normalizeValues(DEFAULT_VALUES, options, CLASS_KEYS, FORMAT_NAME);\n        if (values.emit === OUTPUT_DOCUMENT || values.emit === OUTPUT_RAW) return CjsBlackFormat.readDocument(input, values);\n        if (values.emit === OUTPUT_RUNTIME) return CjsBlackFormat.readRuntime(input, values);\n        return CjsBlackFormat.readPayload(input, values);\n    }\n\n    /**\n     * Static one-shot document read.\n     *\n     * @param {unknown} input Black format input.\n     * @param {object} [options] Format values.\n     * @returns {object} CarbonEngineJS document graph.\n     */\n    static readDocument(input, options = {})\n    {\n        return new CjsBlackReader(input, normalizeValues(DEFAULT_VALUES, options, CLASS_KEYS, FORMAT_NAME)).ReadDocument();\n    }\n\n    /**\n     * Static one-shot runtime read.\n     *\n     * @param {unknown} input Black format input.\n     * @param {object} [options] Format values.\n     * @returns {object} Runtime read result.\n     */\n    static readRuntime(input, options = {})\n    {\n        return new CjsBlackReader(input, normalizeValues(DEFAULT_VALUES, options, CLASS_KEYS, FORMAT_NAME)).ReadRuntime();\n    }\n\n    /**\n     * Static one-shot public payload read.\n     *\n     * @param {unknown} input Black format input.\n     * @param {object} [options] Format values.\n     * @returns {object} Public payload output.\n     */\n    static readPayload(input, options = {})\n    {\n        return new CjsBlackReader(input, normalizeValues(DEFAULT_VALUES, options, CLASS_KEYS, FORMAT_NAME)).ReadPayload();\n    }\n\n    /**\n     * Static one-shot inspection.\n     *\n     * @param {unknown} input Black format input.\n     * @param {object} [options] Format values.\n     * @returns {object} Plain summary data.\n     */\n    static inspect(input, options = {})\n    {\n        return new CjsBlackReader(input, normalizeValues(DEFAULT_VALUES, options, CLASS_KEYS, FORMAT_NAME)).Inspect();\n    }\n\n    /**\n     * Static JSON-compatible conversion.\n     *\n     * @param {any} value Format output to convert.\n     * @returns {any} Plain JSON-compatible data.\n     */\n    static toJSON(value)\n    {\n        return toJsonValue(value);\n    }\n\n    /**\n     * Emit targets for this format (canonical frozen enum).\n     */\n    static Output = Object.freeze({\n        JSON: OUTPUT_JSON,\n        RAW: OUTPUT_RAW,\n        DOCUMENT: OUTPUT_DOCUMENT,\n        PAYLOAD: OUTPUT_PAYLOAD,\n        RUNTIME: OUTPUT_RUNTIME\n    });\n    static CLASS_KEYS = CLASS_KEYS;\n    static id = CJS_BLACK_FORMAT_ID;\n    static extensions = Object.freeze([CJS_BLACK_EXTENSION]);\n    static fourCC = CJS_BLACK_FOURCC;\n    static version = CJS_BLACK_VERSION;\n    static type = Object.freeze([ \"data\" ]);\n    static mediaTypes = Object.freeze([ \"data\" ]);\n    static inputTypes = Object.freeze([ \"black\" ]);\n    static outputTypes = Object.freeze([ OUTPUT_JSON, OUTPUT_DOCUMENT, OUTPUT_PAYLOAD, OUTPUT_RUNTIME ]);\n    static debugOutputTypes = Object.freeze([ OUTPUT_RAW ]);\n\n    /** Provides the one-shot Black copy reader options helper entry point. */\n    static copyReaderOptions(values)\n    {\n        const {\n            emit: _emit,\n            schema: _schema,\n            classes: _classes,\n            ...readerOptions\n        } = values;\n        return readerOptions;\n    }\n\n}\n\nexport default CjsBlackFormat;\n"],"names":["FORMAT_NAME","CjsBlackFormat","DEFAULT_VALUES","emit","schema","worker","Object","freeze","module","import","meta","url","exportName","outputTypes","OUTPUT_JSON","OUTPUT_PAYLOAD","defaultOutput","constructor","options","SetValues","values","normalizeValues","GetValues","CLASS_KEYS","classes","copyReaderOptions","SetClasses","SetClass","type","Class","validateClassKey","undefined","validateClass","GetClass","HasClass","Read","input","read","ReadDocument","readDocument","ReadRuntime","readRuntime","ReadPayload","readPayload","Inspect","inspect","ToJSON","value","toJsonValue","OUTPUT_DOCUMENT","OUTPUT_RAW","OUTPUT_RUNTIME","CjsBlackReader","toJSON","Output","JSON","RAW","DOCUMENT","PAYLOAD","RUNTIME","id","CJS_BLACK_FORMAT_ID","extensions","CJS_BLACK_EXTENSION","fourCC","CJS_BLACK_FOURCC","version","CJS_BLACK_VERSION","mediaTypes","inputTypes","debugOutputTypes","_emit","_schema","_classes","readerOptions"],"mappings":"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"}
+{"version":3,"file":"CjsBlackFormat.js","sources":["../../../../src/formats/black/CjsBlackFormat.js"],"sourcesContent":["import { CLASS_KEYS } from \"./core/schema.js\";\nimport {\n    DEFAULT_VALUES,\n    OUTPUT_DOCUMENT,\n    OUTPUT_JSON,\n    OUTPUT_PAYLOAD,\n    OUTPUT_RAW,\n    OUTPUT_RUNTIME,\n    normalizeValues,\n    toJsonValue,\n    validateClass,\n    validateClassKey\n} from \"./core/helpers.js\";\nimport {\n    CJS_BLACK_EXTENSION,\n    CJS_BLACK_FORMAT_ID,\n    CJS_BLACK_FOURCC,\n    CJS_BLACK_VERSION\n} from \"./core/blackConstants.js\";\nimport { CjsBlackReader } from \"./core/CjsBlackReader.js\";\n\nconst FORMAT_NAME = \"CjsBlackFormat\";\n\n/**\n * CarbonEngineJS-facing Black format profile.\n *\n * This package reads public-facing `.black` payload data using CarbonEngineJS\n * canonical schemas or source-shape registries.\n */\nexport class CjsBlackFormat\n{\n\n    #emit = DEFAULT_VALUES.emit;\n    #schema = DEFAULT_VALUES.schema;\n    #readerOptions = {};\n    #classes = {};\n\n    /**\n     * Plain payload outputs can be decoded in a browser worker. Document and\n     * runtime outputs retain class identity and therefore stay on the caller\n     * thread.\n     */\n    static worker = Object.freeze({\n        module: import.meta.url,\n        exportName: \"CjsBlackFormat\",\n        outputTypes: Object.freeze([ OUTPUT_JSON, OUTPUT_PAYLOAD ]),\n        defaultOutput: OUTPUT_JSON\n    });\n\n    /**\n     * Create a reusable format profile.\n     *\n     * @param {object} [options] Default format values.\n     */\n    constructor(options = {})\n    {\n        this.SetValues(options);\n    }\n\n    /**\n     * Set format values for this reusable profile.\n     *\n     * @param {object} [options] Values to merge into the profile.\n     * @returns {CjsBlackFormat} This format profile.\n     */\n    SetValues(options = {})\n    {\n        const values = normalizeValues(this.GetValues(), options, CLASS_KEYS, FORMAT_NAME);\n        this.#emit = values.emit;\n        this.#schema = values.schema;\n        this.#classes = values.classes;\n        this.#readerOptions = CjsBlackFormat.copyReaderOptions(values);\n        return this;\n    }\n\n    /**\n     * Get this profile's current values, optionally with per-call overrides.\n     *\n     * @param {object} [options] Optional values to merge into a copy.\n     * @returns {object} A copy of the effective values.\n     */\n    GetValues(options = {})\n    {\n        return normalizeValues({\n            emit: this.#emit,\n            schema: this.#schema,\n            ...this.#readerOptions,\n            classes: this.#classes\n        }, options, CLASS_KEYS, FORMAT_NAME);\n    }\n\n    /**\n     * Set multiple runtime class constructors for this profile.\n     *\n     * @param {object} [classes] Map of Black class names to constructors.\n     * @returns {CjsBlackFormat} This format profile.\n     */\n    SetClasses(classes = {})\n    {\n        return this.SetValues({ classes });\n    }\n\n    /**\n     * Set one node-class constructor for this profile.\n     *\n     * @param {string} type Black class name.\n     * @param {Function|null|undefined} Class Constructor to use, or nullish to delete.\n     * @returns {CjsBlackFormat} This format profile.\n     */\n    SetClass(type, Class)\n    {\n        validateClassKey(CLASS_KEYS, type, FORMAT_NAME);\n        if (Class === null || Class === undefined)\n        {\n            delete this.#classes[type];\n            return this;\n        }\n\n        validateClass(CLASS_KEYS, type, Class, FORMAT_NAME);\n        this.#classes = { ...this.#classes, [type]: Class };\n        return this;\n    }\n\n    /**\n     * Get a configured runtime class constructor.\n     *\n     * @param {string} type Black class name.\n     * @returns {Function|undefined} The registered constructor, if any.\n     */\n    GetClass(type)\n    {\n        validateClassKey(CLASS_KEYS, type, FORMAT_NAME);\n        return this.#classes[type];\n    }\n\n    /**\n     * Whether this format profile has a constructor registered for a node key.\n     *\n     * @param {string} type Node class key.\n     * @returns {boolean} True when a constructor is registered.\n     */\n    HasClass(type)\n    {\n        return !!this.GetClass(type);\n    }\n\n    /**\n     * Read Black data with this profile's values.\n     *\n     * @param {unknown} input Black format input.\n     * @param {object} [options] Per-call value overrides.\n     * @returns {object} Public payload output by default.\n     */\n    Read(input, options = {})\n    {\n        return CjsBlackFormat.read(input, this.GetValues(options));\n    }\n\n    /**\n     * Read Black data as a neutral document graph for diagnostics.\n     *\n     * @param {unknown} input Black format input.\n     * @param {object} [options] Per-call value overrides.\n     * @returns {object} CarbonEngineJS document graph.\n     */\n    ReadDocument(input, options = {})\n    {\n        return CjsBlackFormat.readDocument(input, this.GetValues(options));\n    }\n\n    /**\n     * Read Black data as runtime objects or plain source-shaped objects.\n     *\n     * @param {unknown} input Black format input.\n     * @param {object} [options] Per-call value overrides.\n     * @returns {object} Runtime read result.\n     */\n    ReadRuntime(input, options = {})\n    {\n        return CjsBlackFormat.readRuntime(input, this.GetValues(options));\n    }\n\n    /**\n     * Read Black data as compact public payload JSON.\n     *\n     * @param {unknown} input Black format input.\n     * @param {object} [options] Per-call value overrides.\n     * @returns {object} Public payload output.\n     */\n    ReadPayload(input, options = {})\n    {\n        return CjsBlackFormat.readPayload(input, this.GetValues(options));\n    }\n\n    /**\n     * Inspect Black data with this profile's values.\n     *\n     * @param {unknown} input Black format input.\n     * @param {object} [options] Per-call value overrides.\n     * @returns {object} Plain summary data.\n     */\n    Inspect(input, options = {})\n    {\n        return CjsBlackFormat.inspect(input, this.GetValues(options));\n    }\n\n    /**\n     * Convert format output to JSON-compatible data.\n     *\n     * @param {any} value Format output to convert.\n     * @returns {any} Plain JSON-compatible data.\n     */\n    ToJSON(value)\n    {\n        return toJsonValue(value);\n    }\n\n    /**\n     * Static one-shot read. Static methods use camelCase by convention.\n     *\n     * @param {unknown} input Black format input.\n     * @param {object} [options] Format values.\n     * @returns {object} Format output.\n     */\n    static read(input, options = {})\n    {\n        const values = normalizeValues(DEFAULT_VALUES, options, CLASS_KEYS, FORMAT_NAME);\n        if (values.emit === OUTPUT_DOCUMENT || values.emit === OUTPUT_RAW) return CjsBlackFormat.readDocument(input, values);\n        if (values.emit === OUTPUT_RUNTIME) return CjsBlackFormat.readRuntime(input, values);\n        return CjsBlackFormat.readPayload(input, values);\n    }\n\n    /**\n     * Static one-shot document read.\n     *\n     * @param {unknown} input Black format input.\n     * @param {object} [options] Format values.\n     * @returns {object} CarbonEngineJS document graph.\n     */\n    static readDocument(input, options = {})\n    {\n        return new CjsBlackReader(input, normalizeValues(DEFAULT_VALUES, options, CLASS_KEYS, FORMAT_NAME)).ReadDocument();\n    }\n\n    /**\n     * Static one-shot runtime read.\n     *\n     * @param {unknown} input Black format input.\n     * @param {object} [options] Format values.\n     * @returns {object} Runtime read result.\n     */\n    static readRuntime(input, options = {})\n    {\n        return new CjsBlackReader(input, normalizeValues(DEFAULT_VALUES, options, CLASS_KEYS, FORMAT_NAME)).ReadRuntime();\n    }\n\n    /**\n     * Static one-shot public payload read.\n     *\n     * @param {unknown} input Black format input.\n     * @param {object} [options] Format values.\n     * @returns {object} Public payload output.\n     */\n    static readPayload(input, options = {})\n    {\n        return new CjsBlackReader(input, normalizeValues(DEFAULT_VALUES, options, CLASS_KEYS, FORMAT_NAME)).ReadPayload();\n    }\n\n    /**\n     * Static one-shot inspection.\n     *\n     * @param {unknown} input Black format input.\n     * @param {object} [options] Format values.\n     * @returns {object} Plain summary data.\n     */\n    static inspect(input, options = {})\n    {\n        return new CjsBlackReader(input, normalizeValues(DEFAULT_VALUES, options, CLASS_KEYS, FORMAT_NAME)).Inspect();\n    }\n\n    /**\n     * Static JSON-compatible conversion.\n     *\n     * @param {any} value Format output to convert.\n     * @returns {any} Plain JSON-compatible data.\n     */\n    static toJSON(value)\n    {\n        return toJsonValue(value);\n    }\n\n    /**\n     * Performs the bounded Black content discriminator used by ordered object\n     * routes. Magic selects the Black reader; version and body failures remain\n     * that reader's errors and are never reinterpreted as Red/YAML.\n     *\n     * @param {ArrayBuffer|ArrayBufferView} input Candidate source bytes.\n     * @returns {boolean} True when the little-endian Black magic is present.\n     */\n    static isSupported(input)\n    {\n        const view = getBlackProbeView(input);\n        return Boolean(\n            view\n            && view.byteLength >= 4\n            && view.getUint32(0, true) === CJS_BLACK_FOURCC\n        );\n    }\n\n    /**\n     * Emit targets for this format (canonical frozen enum).\n     */\n    static Output = Object.freeze({\n        JSON: OUTPUT_JSON,\n        RAW: OUTPUT_RAW,\n        DOCUMENT: OUTPUT_DOCUMENT,\n        PAYLOAD: OUTPUT_PAYLOAD,\n        RUNTIME: OUTPUT_RUNTIME\n    });\n    static CLASS_KEYS = CLASS_KEYS;\n    static id = CJS_BLACK_FORMAT_ID;\n    static extensions = Object.freeze([CJS_BLACK_EXTENSION]);\n    static fourCC = CJS_BLACK_FOURCC;\n    static version = CJS_BLACK_VERSION;\n    static type = Object.freeze([ \"data\" ]);\n    static mediaTypes = Object.freeze([ \"data\" ]);\n    static inputTypes = Object.freeze([ \"black\" ]);\n    static outputTypes = Object.freeze([ OUTPUT_JSON, OUTPUT_DOCUMENT, OUTPUT_PAYLOAD, OUTPUT_RUNTIME ]);\n    static debugOutputTypes = Object.freeze([ OUTPUT_RAW ]);\n\n    /** Provides the one-shot Black copy reader options helper entry point. */\n    static copyReaderOptions(values)\n    {\n        const {\n            emit: _emit,\n            schema: _schema,\n            classes: _classes,\n            ...readerOptions\n        } = values;\n        return readerOptions;\n    }\n\n}\n\nfunction getBlackProbeView(input)\n{\n    if (input instanceof ArrayBuffer) return new DataView(input);\n    if (!ArrayBuffer.isView(input)) return null;\n    return new DataView(input.buffer, input.byteOffset, input.byteLength);\n}\n\nexport default CjsBlackFormat;\n"],"names":["FORMAT_NAME","CjsBlackFormat","DEFAULT_VALUES","emit","schema","worker","Object","freeze","module","import","meta","url","exportName","outputTypes","OUTPUT_JSON","OUTPUT_PAYLOAD","defaultOutput","constructor","options","SetValues","values","normalizeValues","GetValues","CLASS_KEYS","classes","copyReaderOptions","SetClasses","SetClass","type","Class","validateClassKey","undefined","validateClass","GetClass","HasClass","Read","input","read","ReadDocument","readDocument","ReadRuntime","readRuntime","ReadPayload","readPayload","Inspect","inspect","ToJSON","value","toJsonValue","OUTPUT_DOCUMENT","OUTPUT_RAW","OUTPUT_RUNTIME","CjsBlackReader","toJSON","isSupported","view","getBlackProbeView","Boolean","byteLength","getUint32","CJS_BLACK_FOURCC","Output","JSON","RAW","DOCUMENT","PAYLOAD","RUNTIME","id","CJS_BLACK_FORMAT_ID","extensions","CJS_BLACK_EXTENSION","fourCC","version","CJS_BLACK_VERSION","mediaTypes","inputTypes","debugOutputTypes","_emit","_schema","_classes","readerOptions","ArrayBuffer","DataView","isView","buffer","byteOffset"],"mappings":"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"}

package/dist/formats/black/core/CjsBlackBinaryReader.js

@@ -1,260 +1,260 @@
-/**
- * Bounds-aware `DataView` cursor that provides the primitive reads and
- * end-of-stream checks the Black transport decodes with.
- */
-class CjsBlackBinaryReader {
-  /**
-   * Creates a CjsBlackBinaryReader over caller-provided Black bytes and reader
-   * options.
-   */
-  constructor(dataView, context = null) {
-    if (!(dataView instanceof DataView)) {
-      throw new TypeError("CjsBlackBinaryReader expected a DataView");
-    }
-    this.data = dataView;
-    this.context = context;
-    this.offset = 0;
-  }
-
-  /**
-   * Returns the number of unread Black bytes for the Black object-graph
-   * reader.
-   */
-  get remaining() {
-    return this.data.byteLength - this.offset;
-  }
-
-  /**
-   * Reports whether the Black cursor consumed every byte for the Black
-   * object-graph reader.
-   */
-  AtEnd() {
-    return this.remaining === 0;
-  }
-
-  /**
-   * Validates end against Black object-graph reader constraints and throws on
-   * failure.
-   */
-  ExpectEnd(message = "Black reader did not reach end") {
-    if (!this.AtEnd()) {
-      throw new RangeError(`${message}: ${this.remaining} bytes remain`);
-    }
-  }
-
-  /**
-   * Validates U32 against Black object-graph reader constraints and throws on
-   * failure.
-   */
-  ExpectU32(expected, message) {
-    const actual = this.ReadU32();
-    if (actual !== expected) {
-      throw new RangeError(`${message}: expected ${expected}, got ${actual}`);
-    }
-    return actual;
-  }
-
-  /** Reads binary reader from the current Black object-graph reader. */
-  ReadBinaryReader(byteLength) {
-    return new CjsBlackBinaryReader(this.ReadDataView(byteLength), this.context);
-  }
-
-  /** Reads bytes from the current Black object-graph reader. */
-  ReadBytes(byteLength) {
-    const view = this.ReadDataView(byteLength);
-    return new Uint8Array(view.buffer, view.byteOffset, view.byteLength);
-  }
-
-  /** Reads C string from the current Black object-graph reader. */
-  ReadCString() {
-    const startOffset = this.offset;
-    while (this.ReadU8() !== 0) {
-      // Scan to null terminator.
-    }
-    const byteOffset = this.data.byteOffset + startOffset;
-    const byteLength = this.offset - startOffset - 1;
-    const bytes = new Uint8Array(this.data.buffer, byteOffset, byteLength);
-    return CjsBlackBinaryReader.utf8Decoder.decode(bytes);
-  }
-
-  /** Reads CW string from the current Black object-graph reader. */
-  ReadCWString() {
-    const startOffset = this.offset;
-    while (this.ReadU16() !== 0) {
-      // Scan to UTF-16 null terminator.
-    }
-    const byteOffset = this.data.byteOffset + startOffset;
-    const byteLength = this.offset - startOffset - 2;
-    const bytes = new Uint8Array(this.data.buffer, byteOffset, byteLength);
-    return CjsBlackBinaryReader.utf16Decoder.decode(bytes);
-  }
-
-  /** Reads data view from the current Black object-graph reader. */
-  ReadDataView(byteLength) {
-    if (!Number.isInteger(byteLength) || byteLength < 0) {
-      throw new RangeError(`Invalid Black byte length: ${String(byteLength)}`);
-    }
-    if (this.remaining < byteLength) {
-      throw new RangeError(`Black reader needs ${byteLength} bytes but only ${this.remaining} remain`);
-    }
-    const result = new DataView(this.data.buffer, this.data.byteOffset + this.offset, byteLength);
-    this.offset += byteLength;
-    return result;
-  }
-
-  /**
-   * Reads a 32-bit float from the Black cursor for the Black object-graph
-   * reader.
-   */
-  ReadF32() {
-    const value = this.data.getFloat32(this.offset, true);
-    this.offset += 4;
-    return value;
-  }
-
-  /**
-   * Reads a 64-bit float from the Black cursor for the Black object-graph
-   * reader.
-   */
-  ReadF64() {
-    const value = this.data.getFloat64(this.offset, true);
-    this.offset += 8;
-    return value;
-  }
-
-  /**
-   * Reads a signed 8-bit integer from the Black cursor for the Black
-   * object-graph reader.
-   */
-  ReadI8() {
-    const value = this.data.getInt8(this.offset);
-    this.offset += 1;
-    return value;
-  }
-
-  /**
-   * Reads a signed 16-bit integer from the Black cursor for the Black
-   * object-graph reader.
-   */
-  ReadI16() {
-    const value = this.data.getInt16(this.offset, true);
-    this.offset += 2;
-    return value;
-  }
-
-  /**
-   * Reads a signed 32-bit integer from the Black cursor for the Black
-   * object-graph reader.
-   */
-  ReadI32() {
-    const value = this.data.getInt32(this.offset, true);
-    this.offset += 4;
-    return value;
-  }
-
-  /**
-   * Reads a signed 64-bit integer from the Black cursor for the Black
-   * object-graph reader.
-   */
-  ReadI64() {
-    return this.data.getBigInt64(this.ConsumeOffset(8), true);
-  }
-
-  /**
-   * Resolves a narrow-string table index from the Black cursor for the Black
-   * object-graph reader.
-   */
-  ReadStringRef() {
-    const index = this.ReadU16();
-    const strings = this.context?.info?.strings || [];
-    if (index >= strings.length) {
-      throw new RangeError(`Invalid Black string index: ${index}`);
-    }
-    return strings[index];
-  }
-
-  /** Reads wide string ref from the current Black object-graph reader. */
-  ReadWideStringRef() {
-    const index = this.ReadU16();
-    const strings = this.context?.info?.wideStrings || [];
-    if (index >= strings.length) {
-      throw new RangeError(`Invalid Black wide string index: ${index}`);
-    }
-    return strings[index];
-  }
-
-  /**
-   * Reads an unsigned 8-bit integer from the Black cursor for the Black
-   * object-graph reader.
-   */
-  ReadU8() {
-    const value = this.data.getUint8(this.offset);
-    this.offset += 1;
-    return value;
-  }
-
-  /**
-   * Reads an unsigned 16-bit integer from the Black cursor for the Black
-   * object-graph reader.
-   */
-  ReadU16() {
-    const value = this.data.getUint16(this.offset, true);
-    this.offset += 2;
-    return value;
-  }
-
-  /**
-   * Reads an unsigned 32-bit integer from the Black cursor for the Black
-   * object-graph reader.
-   */
-  ReadU32() {
-    const value = this.data.getUint32(this.offset, true);
-    this.offset += 4;
-    return value;
-  }
-
-  /**
-   * Reads an unsigned 64-bit integer from the Black cursor for the Black
-   * object-graph reader.
-   */
-  ReadU64() {
-    return this.data.getBigUint64(this.ConsumeOffset(8), true);
-  }
-
-  /**
-   * Advances the Black cursor by a validated byte count for the Black
-   * object-graph reader.
-   */
-  Skip(byteLength) {
-    this.ReadDataView(byteLength);
-  }
-
-  /** Consumes offset from the current Black object-graph reader. */
-  ConsumeOffset(byteLength) {
-    if (this.remaining < byteLength) {
-      throw new RangeError(`Black reader needs ${byteLength} bytes but only ${this.remaining} remain`);
-    }
-    const offset = this.offset;
-    this.offset += byteLength;
-    return offset;
-  }
-
-  /**
-   * Creates a bounded Black reader over supported binary input for the Black
-   * object-graph reader.
-   */
-  static from(input, context = null) {
-    if (input instanceof CjsBlackBinaryReader) return input;
-    if (input instanceof DataView) return new CjsBlackBinaryReader(input, context);
-    if (input instanceof ArrayBuffer) return new CjsBlackBinaryReader(new DataView(input), context);
-    if (ArrayBuffer.isView(input)) {
-      return new CjsBlackBinaryReader(new DataView(input.buffer, input.byteOffset, input.byteLength), context);
-    }
-    throw new TypeError("Black input must be an ArrayBuffer, DataView, or typed array");
-  }
-  static utf8Decoder = new TextDecoder("utf-8");
-  static utf16Decoder = new TextDecoder("utf-16le");
-}
-
-export { CjsBlackBinaryReader };
-//# sourceMappingURL=CjsBlackBinaryReader.js.map
+/**
+ * Bounds-aware `DataView` cursor that provides the primitive reads and
+ * end-of-stream checks the Black transport decodes with.
+ */
+class CjsBlackBinaryReader {
+  /**
+   * Creates a CjsBlackBinaryReader over caller-provided Black bytes and reader
+   * options.
+   */
+  constructor(dataView, context = null) {
+    if (!(dataView instanceof DataView)) {
+      throw new TypeError("CjsBlackBinaryReader expected a DataView");
+    }
+    this.data = dataView;
+    this.context = context;
+    this.offset = 0;
+  }
+
+  /**
+   * Returns the number of unread Black bytes for the Black object-graph
+   * reader.
+   */
+  get remaining() {
+    return this.data.byteLength - this.offset;
+  }
+
+  /**
+   * Reports whether the Black cursor consumed every byte for the Black
+   * object-graph reader.
+   */
+  AtEnd() {
+    return this.remaining === 0;
+  }
+
+  /**
+   * Validates end against Black object-graph reader constraints and throws on
+   * failure.
+   */
+  ExpectEnd(message = "Black reader did not reach end") {
+    if (!this.AtEnd()) {
+      throw new RangeError(`${message}: ${this.remaining} bytes remain`);
+    }
+  }
+
+  /**
+   * Validates U32 against Black object-graph reader constraints and throws on
+   * failure.
+   */
+  ExpectU32(expected, message) {
+    const actual = this.ReadU32();
+    if (actual !== expected) {
+      throw new RangeError(`${message}: expected ${expected}, got ${actual}`);
+    }
+    return actual;
+  }
+
+  /** Reads binary reader from the current Black object-graph reader. */
+  ReadBinaryReader(byteLength) {
+    return new CjsBlackBinaryReader(this.ReadDataView(byteLength), this.context);
+  }
+
+  /** Reads bytes from the current Black object-graph reader. */
+  ReadBytes(byteLength) {
+    const view = this.ReadDataView(byteLength);
+    return new Uint8Array(view.buffer, view.byteOffset, view.byteLength);
+  }
+
+  /** Reads C string from the current Black object-graph reader. */
+  ReadCString() {
+    const startOffset = this.offset;
+    while (this.ReadU8() !== 0) {
+      // Scan to null terminator.
+    }
+    const byteOffset = this.data.byteOffset + startOffset;
+    const byteLength = this.offset - startOffset - 1;
+    const bytes = new Uint8Array(this.data.buffer, byteOffset, byteLength);
+    return CjsBlackBinaryReader.utf8Decoder.decode(bytes);
+  }
+
+  /** Reads CW string from the current Black object-graph reader. */
+  ReadCWString() {
+    const startOffset = this.offset;
+    while (this.ReadU16() !== 0) {
+      // Scan to UTF-16 null terminator.
+    }
+    const byteOffset = this.data.byteOffset + startOffset;
+    const byteLength = this.offset - startOffset - 2;
+    const bytes = new Uint8Array(this.data.buffer, byteOffset, byteLength);
+    return CjsBlackBinaryReader.utf16Decoder.decode(bytes);
+  }
+
+  /** Reads data view from the current Black object-graph reader. */
+  ReadDataView(byteLength) {
+    if (!Number.isInteger(byteLength) || byteLength < 0) {
+      throw new RangeError(`Invalid Black byte length: ${String(byteLength)}`);
+    }
+    if (this.remaining < byteLength) {
+      throw new RangeError(`Black reader needs ${byteLength} bytes but only ${this.remaining} remain`);
+    }
+    const result = new DataView(this.data.buffer, this.data.byteOffset + this.offset, byteLength);
+    this.offset += byteLength;
+    return result;
+  }
+
+  /**
+   * Reads a 32-bit float from the Black cursor for the Black object-graph
+   * reader.
+   */
+  ReadF32() {
+    const value = this.data.getFloat32(this.offset, true);
+    this.offset += 4;
+    return value;
+  }
+
+  /**
+   * Reads a 64-bit float from the Black cursor for the Black object-graph
+   * reader.
+   */
+  ReadF64() {
+    const value = this.data.getFloat64(this.offset, true);
+    this.offset += 8;
+    return value;
+  }
+
+  /**
+   * Reads a signed 8-bit integer from the Black cursor for the Black
+   * object-graph reader.
+   */
+  ReadI8() {
+    const value = this.data.getInt8(this.offset);
+    this.offset += 1;
+    return value;
+  }
+
+  /**
+   * Reads a signed 16-bit integer from the Black cursor for the Black
+   * object-graph reader.
+   */
+  ReadI16() {
+    const value = this.data.getInt16(this.offset, true);
+    this.offset += 2;
+    return value;
+  }
+
+  /**
+   * Reads a signed 32-bit integer from the Black cursor for the Black
+   * object-graph reader.
+   */
+  ReadI32() {
+    const value = this.data.getInt32(this.offset, true);
+    this.offset += 4;
+    return value;
+  }
+
+  /**
+   * Reads a signed 64-bit integer from the Black cursor for the Black
+   * object-graph reader.
+   */
+  ReadI64() {
+    return this.data.getBigInt64(this.ConsumeOffset(8), true);
+  }
+
+  /**
+   * Resolves a narrow-string table index from the Black cursor for the Black
+   * object-graph reader.
+   */
+  ReadStringRef() {
+    const index = this.ReadU16();
+    const strings = this.context?.info?.strings || [];
+    if (index >= strings.length) {
+      throw new RangeError(`Invalid Black string index: ${index}`);
+    }
+    return strings[index];
+  }
+
+  /** Reads wide string ref from the current Black object-graph reader. */
+  ReadWideStringRef() {
+    const index = this.ReadU16();
+    const strings = this.context?.info?.wideStrings || [];
+    if (index >= strings.length) {
+      throw new RangeError(`Invalid Black wide string index: ${index}`);
+    }
+    return strings[index];
+  }
+
+  /**
+   * Reads an unsigned 8-bit integer from the Black cursor for the Black
+   * object-graph reader.
+   */
+  ReadU8() {
+    const value = this.data.getUint8(this.offset);
+    this.offset += 1;
+    return value;
+  }
+
+  /**
+   * Reads an unsigned 16-bit integer from the Black cursor for the Black
+   * object-graph reader.
+   */
+  ReadU16() {
+    const value = this.data.getUint16(this.offset, true);
+    this.offset += 2;
+    return value;
+  }
+
+  /**
+   * Reads an unsigned 32-bit integer from the Black cursor for the Black
+   * object-graph reader.
+   */
+  ReadU32() {
+    const value = this.data.getUint32(this.offset, true);
+    this.offset += 4;
+    return value;
+  }
+
+  /**
+   * Reads an unsigned 64-bit integer from the Black cursor for the Black
+   * object-graph reader.
+   */
+  ReadU64() {
+    return this.data.getBigUint64(this.ConsumeOffset(8), true);
+  }
+
+  /**
+   * Advances the Black cursor by a validated byte count for the Black
+   * object-graph reader.
+   */
+  Skip(byteLength) {
+    this.ReadDataView(byteLength);
+  }
+
+  /** Consumes offset from the current Black object-graph reader. */
+  ConsumeOffset(byteLength) {
+    if (this.remaining < byteLength) {
+      throw new RangeError(`Black reader needs ${byteLength} bytes but only ${this.remaining} remain`);
+    }
+    const offset = this.offset;
+    this.offset += byteLength;
+    return offset;
+  }
+
+  /**
+   * Creates a bounded Black reader over supported binary input for the Black
+   * object-graph reader.
+   */
+  static from(input, context = null) {
+    if (input instanceof CjsBlackBinaryReader) return input;
+    if (input instanceof DataView) return new CjsBlackBinaryReader(input, context);
+    if (input instanceof ArrayBuffer) return new CjsBlackBinaryReader(new DataView(input), context);
+    if (ArrayBuffer.isView(input)) {
+      return new CjsBlackBinaryReader(new DataView(input.buffer, input.byteOffset, input.byteLength), context);
+    }
+    throw new TypeError("Black input must be an ArrayBuffer, DataView, or typed array");
+  }
+  static utf8Decoder = new TextDecoder("utf-8");
+  static utf16Decoder = new TextDecoder("utf-16le");
+}
+
+export { CjsBlackBinaryReader };
+//# sourceMappingURL=CjsBlackBinaryReader.js.map