@carbonenginejs/runtime-resource 0.1.0

package/dist/format/payloadContract.js

@@ -0,0 +1,173 @@
+/**
+ * Canonical semantic payload vocabulary shared by runtime-resource adapters
+ * and pure format readers.
+ *
+ * Format packages may return plain objects matching these shapes without
+ * importing runtime-resource. These validators are runtime-side guardrails;
+ * they are not file decoders or GPU capability checks.
+ */
+
+const ResourcePayloadType = Object.freeze({
+  RGBA: "rgba",
+  TEXTURE: "texture",
+  AUDIO: "audio",
+  PCM: "pcm",
+  VIDEO: "video"
+});
+const ResourcePayloadValues = Object.freeze({
+  imageOrigins: Object.freeze(["top-left"]),
+  colorSpaces: Object.freeze(["srgb", "linear", "unknown"]),
+  alphaModes: Object.freeze(["straight", "premultiplied", "opaque", "unknown"]),
+  textureDimensions: Object.freeze(["2d", "cube", "3d", "array"])
+});
+function validateRgbaPayload(payload, options = null) {
+  const value = assertObject(payload, "RGBA payload");
+  assertPayloadType(value, ResourcePayloadType.RGBA, "RGBA payload");
+  assertDimensions(value, "RGBA payload");
+  assertString(value.pixelFormat, "RGBA payload.pixelFormat");
+  const layout = {
+    rgba8unorm: {
+      bytesPerPixel: 4,
+      arrayType: Uint8Array
+    },
+    rgba32float: {
+      bytesPerPixel: 16,
+      arrayType: Float32Array
+    }
+  }[value.pixelFormat];
+  if (!layout) {
+    throw new TypeError("RGBA payload.pixelFormat must be \"rgba8unorm\" or \"rgba32float\".");
+  }
+  if (!(value.data instanceof layout.arrayType)) {
+    throw new TypeError(`RGBA payload.data must be a ${layout.arrayType.name}.`);
+  }
+  assertPositiveOrZeroInteger(value.strideBytes, "RGBA payload.strideBytes");
+  if (value.strideBytes < value.width * layout.bytesPerPixel) {
+    throw new RangeError("RGBA payload.strideBytes is smaller than one RGBA row.");
+  }
+  if (value.data.byteLength < value.strideBytes * value.height) {
+    throw new RangeError("RGBA payload.data is shorter than the declared image rows.");
+  }
+  if (value.strideBytes % value.data.BYTES_PER_ELEMENT !== 0) {
+    throw new RangeError("RGBA payload.strideBytes must align to its typed-array elements.");
+  }
+  assertEnum(value.origin, ResourcePayloadValues.imageOrigins, "RGBA payload.origin");
+  assertEnum(value.colorSpace, ResourcePayloadValues.colorSpaces, "RGBA payload.colorSpace");
+  assertEnum(value.alphaMode, ResourcePayloadValues.alphaModes, "RGBA payload.alphaMode");
+  if (options?.allowMetadata === false && value.metadata !== undefined) {
+    throw new TypeError("RGBA payload.metadata is not allowed for this validation mode.");
+  }
+  return value;
+}
+function validateTexturePayload(payload) {
+  const value = assertObject(payload, "Texture payload");
+  assertPayloadType(value, ResourcePayloadType.TEXTURE, "Texture payload");
+  assertDimensions(value, "Texture payload");
+  assertEnum(value.dimension, ResourcePayloadValues.textureDimensions, "Texture payload.dimension");
+  assertString(value.pixelFormat, "Texture payload.pixelFormat");
+  if (typeof value.isCompressed !== "boolean") {
+    throw new TypeError("Texture payload.isCompressed must be boolean.");
+  }
+  assertPositiveInteger(value.mipCount, "Texture payload.mipCount");
+  assertPositiveInteger(value.arraySize, "Texture payload.arraySize");
+  assertBytes(value.data, "Texture payload.data");
+  if (!Array.isArray(value.subresources) || value.subresources.length === 0) {
+    throw new TypeError("Texture payload.subresources must be a non-empty array.");
+  }
+  for (const [index, subresource] of value.subresources.entries()) {
+    validateTextureSubresource(subresource, index, value.data.byteLength);
+  }
+  return value;
+}
+function validateAudioPayload(payload) {
+  const value = assertObject(payload, "Audio payload");
+  if (![ResourcePayloadType.AUDIO, ResourcePayloadType.PCM].includes(value.payloadType)) {
+    throw new TypeError("Audio payload.payloadType must be \"audio\" or \"pcm\".");
+  }
+  assertPositiveInteger(value.sampleRate, "Audio payload.sampleRate");
+  assertPositiveInteger(value.channels, "Audio payload.channels");
+  assertPositiveOrZeroInteger(value.frameCount, "Audio payload.frameCount");
+  assertString(value.sampleFormat, "Audio payload.sampleFormat");
+  assertBytesOrTypedArray(value.data, "Audio payload.data");
+  assertPositiveOrZeroNumber(value.durationSeconds, "Audio payload.durationSeconds");
+  return value;
+}
+function validateVideoPayload(payload) {
+  const value = assertObject(payload, "Video payload");
+  assertPayloadType(value, ResourcePayloadType.VIDEO, "Video payload");
+  assertString(value.sourceFormat, "Video payload.sourceFormat");
+  assertPositiveInteger(value.durationTimescale, "Video payload.durationTimescale");
+  assertPositiveOrZeroInteger(value.duration, "Video payload.duration");
+  if (!Array.isArray(value.tracks)) {
+    throw new TypeError("Video payload.tracks must be an array.");
+  }
+  return value;
+}
+function validateTextureSubresource(value, index, dataByteLength) {
+  const prefix = `Texture payload.subresources[${index}]`;
+  assertObject(value, prefix);
+  assertPositiveOrZeroInteger(value.mip, `${prefix}.mip`);
+  assertPositiveOrZeroInteger(value.layer, `${prefix}.layer`);
+  assertPositiveOrZeroInteger(value.offset, `${prefix}.offset`);
+  assertPositiveInteger(value.byteLength, `${prefix}.byteLength`);
+  assertPositiveOrZeroInteger(value.width, `${prefix}.width`);
+  assertPositiveOrZeroInteger(value.height, `${prefix}.height`);
+  assertPositiveOrZeroInteger(value.rowPitch, `${prefix}.rowPitch`);
+  assertPositiveOrZeroInteger(value.slicePitch, `${prefix}.slicePitch`);
+  if (value.offset + value.byteLength > dataByteLength) {
+    throw new RangeError(`${prefix} exceeds Texture payload.data.`);
+  }
+}
+function assertObject(value, label) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) {
+    throw new TypeError(`${label} must be an object.`);
+  }
+  return value;
+}
+function assertPayloadType(value, expected, label) {
+  if (value.payloadType !== expected) {
+    throw new TypeError(`${label}.payloadType must be \"${expected}\".`);
+  }
+}
+function assertDimensions(value, label) {
+  assertPositiveInteger(value.width, `${label}.width`);
+  assertPositiveInteger(value.height, `${label}.height`);
+}
+function assertBytes(value, label) {
+  if (!(value instanceof Uint8Array)) {
+    throw new TypeError(`${label} must be a Uint8Array.`);
+  }
+}
+function assertBytesOrTypedArray(value, label) {
+  if (!ArrayBuffer.isView(value) || value instanceof DataView) {
+    throw new TypeError(`${label} must be a typed array.`);
+  }
+}
+function assertString(value, label) {
+  if (typeof value !== "string" || value.length === 0) {
+    throw new TypeError(`${label} must be a non-empty string.`);
+  }
+}
+function assertEnum(value, allowed, label) {
+  if (!allowed.includes(value)) {
+    throw new TypeError(`${label} must be one of: ${allowed.join(", ")}.`);
+  }
+}
+function assertPositiveInteger(value, label) {
+  if (!Number.isSafeInteger(value) || value <= 0) {
+    throw new TypeError(`${label} must be a positive safe integer.`);
+  }
+}
+function assertPositiveOrZeroInteger(value, label) {
+  if (!Number.isSafeInteger(value) || value < 0) {
+    throw new TypeError(`${label} must be a non-negative safe integer.`);
+  }
+}
+function assertPositiveOrZeroNumber(value, label) {
+  if (typeof value !== "number" || !Number.isFinite(value) || value < 0) {
+    throw new TypeError(`${label} must be a non-negative finite number.`);
+  }
+}
+
+export { ResourcePayloadType, ResourcePayloadValues, validateAudioPayload, validateRgbaPayload, validateTexturePayload, validateVideoPayload };
+//# sourceMappingURL=payloadContract.js.map

package/dist/format/payloadContract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"payloadContract.js","sources":["../../../src/format/payloadContract.js"],"sourcesContent":["/**\n * Canonical semantic payload vocabulary shared by runtime-resource adapters\n * and pure format readers.\n *\n * Format packages may return plain objects matching these shapes without\n * importing runtime-resource. These validators are runtime-side guardrails;\n * they are not file decoders or GPU capability checks.\n */\n\nexport const ResourcePayloadType = Object.freeze({\n    RGBA: \"rgba\",\n    TEXTURE: \"texture\",\n    AUDIO: \"audio\",\n    PCM: \"pcm\",\n    VIDEO: \"video\"\n});\n\nexport const ResourcePayloadValues = Object.freeze({\n    imageOrigins: Object.freeze([ \"top-left\" ]),\n    colorSpaces: Object.freeze([ \"srgb\", \"linear\", \"unknown\" ]),\n    alphaModes: Object.freeze([ \"straight\", \"premultiplied\", \"opaque\", \"unknown\" ]),\n    textureDimensions: Object.freeze([ \"2d\", \"cube\", \"3d\", \"array\" ])\n});\n\nexport function validateRgbaPayload(payload, options = null)\n{\n    const value = assertObject(payload, \"RGBA payload\");\n    assertPayloadType(value, ResourcePayloadType.RGBA, \"RGBA payload\");\n    assertDimensions(value, \"RGBA payload\");\n    assertString(value.pixelFormat, \"RGBA payload.pixelFormat\");\n    const layout = {\n        rgba8unorm: { bytesPerPixel: 4, arrayType: Uint8Array },\n        rgba32float: { bytesPerPixel: 16, arrayType: Float32Array }\n    }[value.pixelFormat];\n    if (!layout)\n    {\n        throw new TypeError(\"RGBA payload.pixelFormat must be \\\"rgba8unorm\\\" or \\\"rgba32float\\\".\");\n    }\n    if (!(value.data instanceof layout.arrayType))\n    {\n        throw new TypeError(`RGBA payload.data must be a ${layout.arrayType.name}.`);\n    }\n    assertPositiveOrZeroInteger(value.strideBytes, \"RGBA payload.strideBytes\");\n    if (value.strideBytes < value.width * layout.bytesPerPixel)\n    {\n        throw new RangeError(\"RGBA payload.strideBytes is smaller than one RGBA row.\");\n    }\n    if (value.data.byteLength < value.strideBytes * value.height)\n    {\n        throw new RangeError(\"RGBA payload.data is shorter than the declared image rows.\");\n    }\n    if (value.strideBytes % value.data.BYTES_PER_ELEMENT !== 0)\n    {\n        throw new RangeError(\"RGBA payload.strideBytes must align to its typed-array elements.\");\n    }\n    assertEnum(value.origin, ResourcePayloadValues.imageOrigins, \"RGBA payload.origin\");\n    assertEnum(value.colorSpace, ResourcePayloadValues.colorSpaces, \"RGBA payload.colorSpace\");\n    assertEnum(value.alphaMode, ResourcePayloadValues.alphaModes, \"RGBA payload.alphaMode\");\n    if (options?.allowMetadata === false && value.metadata !== undefined)\n    {\n        throw new TypeError(\"RGBA payload.metadata is not allowed for this validation mode.\");\n    }\n    return value;\n}\n\nexport function validateTexturePayload(payload)\n{\n    const value = assertObject(payload, \"Texture payload\");\n    assertPayloadType(value, ResourcePayloadType.TEXTURE, \"Texture payload\");\n    assertDimensions(value, \"Texture payload\");\n    assertEnum(value.dimension, ResourcePayloadValues.textureDimensions, \"Texture payload.dimension\");\n    assertString(value.pixelFormat, \"Texture payload.pixelFormat\");\n    if (typeof value.isCompressed !== \"boolean\")\n    {\n        throw new TypeError(\"Texture payload.isCompressed must be boolean.\");\n    }\n    assertPositiveInteger(value.mipCount, \"Texture payload.mipCount\");\n    assertPositiveInteger(value.arraySize, \"Texture payload.arraySize\");\n    assertBytes(value.data, \"Texture payload.data\");\n    if (!Array.isArray(value.subresources) || value.subresources.length === 0)\n    {\n        throw new TypeError(\"Texture payload.subresources must be a non-empty array.\");\n    }\n    for (const [ index, subresource ] of value.subresources.entries())\n    {\n        validateTextureSubresource(subresource, index, value.data.byteLength);\n    }\n    return value;\n}\n\nexport function validateAudioPayload(payload)\n{\n    const value = assertObject(payload, \"Audio payload\");\n    if (![ ResourcePayloadType.AUDIO, ResourcePayloadType.PCM ].includes(value.payloadType))\n    {\n        throw new TypeError(\"Audio payload.payloadType must be \\\"audio\\\" or \\\"pcm\\\".\");\n    }\n    assertPositiveInteger(value.sampleRate, \"Audio payload.sampleRate\");\n    assertPositiveInteger(value.channels, \"Audio payload.channels\");\n    assertPositiveOrZeroInteger(value.frameCount, \"Audio payload.frameCount\");\n    assertString(value.sampleFormat, \"Audio payload.sampleFormat\");\n    assertBytesOrTypedArray(value.data, \"Audio payload.data\");\n    assertPositiveOrZeroNumber(value.durationSeconds, \"Audio payload.durationSeconds\");\n    return value;\n}\n\nexport function validateVideoPayload(payload)\n{\n    const value = assertObject(payload, \"Video payload\");\n    assertPayloadType(value, ResourcePayloadType.VIDEO, \"Video payload\");\n    assertString(value.sourceFormat, \"Video payload.sourceFormat\");\n    assertPositiveInteger(value.durationTimescale, \"Video payload.durationTimescale\");\n    assertPositiveOrZeroInteger(value.duration, \"Video payload.duration\");\n    if (!Array.isArray(value.tracks))\n    {\n        throw new TypeError(\"Video payload.tracks must be an array.\");\n    }\n    return value;\n}\n\nfunction validateTextureSubresource(value, index, dataByteLength)\n{\n    const prefix = `Texture payload.subresources[${index}]`;\n    assertObject(value, prefix);\n    assertPositiveOrZeroInteger(value.mip, `${prefix}.mip`);\n    assertPositiveOrZeroInteger(value.layer, `${prefix}.layer`);\n    assertPositiveOrZeroInteger(value.offset, `${prefix}.offset`);\n    assertPositiveInteger(value.byteLength, `${prefix}.byteLength`);\n    assertPositiveOrZeroInteger(value.width, `${prefix}.width`);\n    assertPositiveOrZeroInteger(value.height, `${prefix}.height`);\n    assertPositiveOrZeroInteger(value.rowPitch, `${prefix}.rowPitch`);\n    assertPositiveOrZeroInteger(value.slicePitch, `${prefix}.slicePitch`);\n    if (value.offset + value.byteLength > dataByteLength)\n    {\n        throw new RangeError(`${prefix} exceeds Texture payload.data.`);\n    }\n}\n\nfunction assertObject(value, label)\n{\n    if (!value || typeof value !== \"object\" || Array.isArray(value))\n    {\n        throw new TypeError(`${label} must be an object.`);\n    }\n    return value;\n}\n\nfunction assertPayloadType(value, expected, label)\n{\n    if (value.payloadType !== expected)\n    {\n        throw new TypeError(`${label}.payloadType must be \\\"${expected}\\\".`);\n    }\n}\n\nfunction assertDimensions(value, label)\n{\n    assertPositiveInteger(value.width, `${label}.width`);\n    assertPositiveInteger(value.height, `${label}.height`);\n}\n\nfunction assertBytes(value, label)\n{\n    if (!(value instanceof Uint8Array))\n    {\n        throw new TypeError(`${label} must be a Uint8Array.`);\n    }\n}\n\nfunction assertBytesOrTypedArray(value, label)\n{\n    if (!ArrayBuffer.isView(value) || value instanceof DataView)\n    {\n        throw new TypeError(`${label} must be a typed array.`);\n    }\n}\n\nfunction assertString(value, label)\n{\n    if (typeof value !== \"string\" || value.length === 0)\n    {\n        throw new TypeError(`${label} must be a non-empty string.`);\n    }\n}\n\nfunction assertEnum(value, allowed, label)\n{\n    if (!allowed.includes(value))\n    {\n        throw new TypeError(`${label} must be one of: ${allowed.join(\", \")}.`);\n    }\n}\n\nfunction assertPositiveInteger(value, label)\n{\n    if (!Number.isSafeInteger(value) || value <= 0)\n    {\n        throw new TypeError(`${label} must be a positive safe integer.`);\n    }\n}\n\nfunction assertPositiveOrZeroInteger(value, label)\n{\n    if (!Number.isSafeInteger(value) || value < 0)\n    {\n        throw new TypeError(`${label} must be a non-negative safe integer.`);\n    }\n}\n\nfunction assertPositiveOrZeroNumber(value, label)\n{\n    if (typeof value !== \"number\" || !Number.isFinite(value) || value < 0)\n    {\n        throw new TypeError(`${label} must be a non-negative finite number.`);\n    }\n}\n"],"names":["ResourcePayloadType","Object","freeze","RGBA","TEXTURE","AUDIO","PCM","VIDEO","ResourcePayloadValues","imageOrigins","colorSpaces","alphaModes","textureDimensions","validateRgbaPayload","payload","options","value","assertObject","assertPayloadType","assertDimensions","assertString","pixelFormat","layout","rgba8unorm","bytesPerPixel","arrayType","Uint8Array","rgba32float","Float32Array","TypeError","data","name","assertPositiveOrZeroInteger","strideBytes","width","RangeError","byteLength","height","BYTES_PER_ELEMENT","assertEnum","origin","colorSpace","alphaMode","allowMetadata","metadata","undefined","validateTexturePayload","dimension","isCompressed","assertPositiveInteger","mipCount","arraySize","assertBytes","Array","isArray","subresources","length","index","subresource","entries","validateTextureSubresource","validateAudioPayload","includes","payloadType","sampleRate","channels","frameCount","sampleFormat","assertBytesOrTypedArray","assertPositiveOrZeroNumber","durationSeconds","validateVideoPayload","sourceFormat","durationTimescale","duration","tracks","dataByteLength","prefix","mip","layer","offset","rowPitch","slicePitch","label","expected","ArrayBuffer","isView","DataView","allowed","join","Number","isSafeInteger","isFinite"],"mappings":"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"}

package/dist/formats/black/CjsBlackFormat.js

@@ -0,0 +1,272 @@
+import { CLASS_KEYS } from './core/schema.js';
+import { DEFAULT_VALUES, normalizeValues, validateClassKey, validateClass, toJsonValue, OUTPUT_DOCUMENT, OUTPUT_RAW, OUTPUT_RUNTIME, OUTPUT_JSON, OUTPUT_PAYLOAD } from './core/helpers.js';
+import { CJS_BLACK_FORMAT_ID, CJS_BLACK_EXTENSION, CJS_BLACK_FOURCC, CJS_BLACK_VERSION } from './core/blackConstants.js';
+import { CjsBlackReader } from './core/CjsBlackReader.js';
+
+const FORMAT_NAME = "CjsBlackFormat";
+
+/**
+ * CarbonEngineJS-facing Black format profile.
+ *
+ * This package reads public-facing `.black` payload data using CarbonEngineJS
+ * canonical schemas or source-shape registries.
+ */
+class CjsBlackFormat {
+  #emit = DEFAULT_VALUES.emit;
+  #schema = DEFAULT_VALUES.schema;
+  #readerOptions = {};
+  #classes = {};
+
+  /**
+   * Create a reusable format profile.
+   *
+   * @param {object} [options] Default format values.
+   */
+  constructor(options = {}) {
+    this.SetValues(options);
+  }
+
+  /**
+   * Set format values for this reusable profile.
+   *
+   * @param {object} [options] Values to merge into the profile.
+   * @returns {CjsBlackFormat} This format profile.
+   */
+  SetValues(options = {}) {
+    const values = normalizeValues(this.GetValues(), options, CLASS_KEYS, FORMAT_NAME);
+    this.#emit = values.emit;
+    this.#schema = values.schema;
+    this.#classes = values.classes;
+    this.#readerOptions = CjsBlackFormat.copyReaderOptions(values);
+    return this;
+  }
+
+  /**
+   * Get this profile's current values, optionally with per-call overrides.
+   *
+   * @param {object} [options] Optional values to merge into a copy.
+   * @returns {object} A copy of the effective values.
+   */
+  GetValues(options = {}) {
+    return normalizeValues({
+      emit: this.#emit,
+      schema: this.#schema,
+      ...this.#readerOptions,
+      classes: this.#classes
+    }, options, CLASS_KEYS, FORMAT_NAME);
+  }
+
+  /**
+   * Set multiple runtime class constructors for this profile.
+   *
+   * @param {object} [classes] Map of Black class names to constructors.
+   * @returns {CjsBlackFormat} This format profile.
+   */
+  SetClasses(classes = {}) {
+    return this.SetValues({
+      classes
+    });
+  }
+
+  /**
+   * Set one node-class constructor for this profile.
+   *
+   * @param {string} type Black class name.
+   * @param {Function|null|undefined} Class Constructor to use, or nullish to delete.
+   * @returns {CjsBlackFormat} This format profile.
+   */
+  SetClass(type, Class) {
+    validateClassKey(CLASS_KEYS, type, FORMAT_NAME);
+    if (Class === null || Class === undefined) {
+      delete this.#classes[type];
+      return this;
+    }
+    validateClass(CLASS_KEYS, type, Class, FORMAT_NAME);
+    this.#classes = {
+      ...this.#classes,
+      [type]: Class
+    };
+    return this;
+  }
+
+  /**
+   * Get a configured runtime class constructor.
+   *
+   * @param {string} type Black class name.
+   * @returns {Function|undefined} The registered constructor, if any.
+   */
+  GetClass(type) {
+    validateClassKey(CLASS_KEYS, type, FORMAT_NAME);
+    return this.#classes[type];
+  }
+
+  /**
+   * Whether this format profile has a constructor registered for a node key.
+   *
+   * @param {string} type Node class key.
+   * @returns {boolean} True when a constructor is registered.
+   */
+  HasClass(type) {
+    return !!this.GetClass(type);
+  }
+
+  /**
+   * Read Black data with this profile's values.
+   *
+   * @param {unknown} input Black format input.
+   * @param {object} [options] Per-call value overrides.
+   * @returns {object} Public payload output by default.
+   */
+  Read(input, options = {}) {
+    return CjsBlackFormat.read(input, this.GetValues(options));
+  }
+
+  /**
+   * Read Black data as a neutral document graph for diagnostics.
+   *
+   * @param {unknown} input Black format input.
+   * @param {object} [options] Per-call value overrides.
+   * @returns {object} CarbonEngineJS document graph.
+   */
+  ReadDocument(input, options = {}) {
+    return CjsBlackFormat.readDocument(input, this.GetValues(options));
+  }
+
+  /**
+   * Read Black data as runtime objects or plain source-shaped objects.
+   *
+   * @param {unknown} input Black format input.
+   * @param {object} [options] Per-call value overrides.
+   * @returns {object} Runtime read result.
+   */
+  ReadRuntime(input, options = {}) {
+    return CjsBlackFormat.readRuntime(input, this.GetValues(options));
+  }
+
+  /**
+   * Read Black data as compact public payload JSON.
+   *
+   * @param {unknown} input Black format input.
+   * @param {object} [options] Per-call value overrides.
+   * @returns {object} Public payload output.
+   */
+  ReadPayload(input, options = {}) {
+    return CjsBlackFormat.readPayload(input, this.GetValues(options));
+  }
+
+  /**
+   * Inspect Black data with this profile's values.
+   *
+   * @param {unknown} input Black format input.
+   * @param {object} [options] Per-call value overrides.
+   * @returns {object} Plain summary data.
+   */
+  Inspect(input, options = {}) {
+    return CjsBlackFormat.inspect(input, this.GetValues(options));
+  }
+
+  /**
+   * Convert format output to JSON-compatible data.
+   *
+   * @param {any} value Format output to convert.
+   * @returns {any} Plain JSON-compatible data.
+   */
+  ToJSON(value) {
+    return toJsonValue(value);
+  }
+
+  /**
+   * Static one-shot read. Static methods use camelCase by convention.
+   *
+   * @param {unknown} input Black format input.
+   * @param {object} [options] Format values.
+   * @returns {object} Format output.
+   */
+  static read(input, options = {}) {
+    const values = normalizeValues(DEFAULT_VALUES, options, CLASS_KEYS, FORMAT_NAME);
+    if (values.emit === OUTPUT_DOCUMENT || values.emit === OUTPUT_RAW) return CjsBlackFormat.readDocument(input, values);
+    if (values.emit === OUTPUT_RUNTIME) return CjsBlackFormat.readRuntime(input, values);
+    return CjsBlackFormat.readPayload(input, values);
+  }
+
+  /**
+   * Static one-shot document read.
+   *
+   * @param {unknown} input Black format input.
+   * @param {object} [options] Format values.
+   * @returns {object} CarbonEngineJS document graph.
+   */
+  static readDocument(input, options = {}) {
+    return new CjsBlackReader(input, normalizeValues(DEFAULT_VALUES, options, CLASS_KEYS, FORMAT_NAME)).ReadDocument();
+  }
+
+  /**
+   * Static one-shot runtime read.
+   *
+   * @param {unknown} input Black format input.
+   * @param {object} [options] Format values.
+   * @returns {object} Runtime read result.
+   */
+  static readRuntime(input, options = {}) {
+    return new CjsBlackReader(input, normalizeValues(DEFAULT_VALUES, options, CLASS_KEYS, FORMAT_NAME)).ReadRuntime();
+  }
+
+  /**
+   * Static one-shot public payload read.
+   *
+   * @param {unknown} input Black format input.
+   * @param {object} [options] Format values.
+   * @returns {object} Public payload output.
+   */
+  static readPayload(input, options = {}) {
+    return new CjsBlackReader(input, normalizeValues(DEFAULT_VALUES, options, CLASS_KEYS, FORMAT_NAME)).ReadPayload();
+  }
+
+  /**
+   * Static one-shot inspection.
+   *
+   * @param {unknown} input Black format input.
+   * @param {object} [options] Format values.
+   * @returns {object} Plain summary data.
+   */
+  static inspect(input, options = {}) {
+    return new CjsBlackReader(input, normalizeValues(DEFAULT_VALUES, options, CLASS_KEYS, FORMAT_NAME)).Inspect();
+  }
+
+  /**
+   * Static JSON-compatible conversion.
+   *
+   * @param {any} value Format output to convert.
+   * @returns {any} Plain JSON-compatible data.
+   */
+  static toJSON(value) {
+    return toJsonValue(value);
+  }
+  static OUTPUT_JSON = OUTPUT_JSON;
+  static OUTPUT_RAW = OUTPUT_RAW;
+  static OUTPUT_DOCUMENT = OUTPUT_DOCUMENT;
+  static OUTPUT_PAYLOAD = OUTPUT_PAYLOAD;
+  static OUTPUT_RUNTIME = OUTPUT_RUNTIME;
+  static CLASS_KEYS = CLASS_KEYS;
+  static id = CJS_BLACK_FORMAT_ID;
+  static extensions = Object.freeze([CJS_BLACK_EXTENSION]);
+  static fourCC = CJS_BLACK_FOURCC;
+  static version = CJS_BLACK_VERSION;
+  static type = Object.freeze(["data"]);
+  static mediaTypes = Object.freeze(["data"]);
+  static inputTypes = Object.freeze(["black"]);
+  static outputTypes = Object.freeze([OUTPUT_JSON, OUTPUT_DOCUMENT, OUTPUT_PAYLOAD, OUTPUT_RUNTIME]);
+  static debugOutputTypes = Object.freeze([OUTPUT_RAW]);
+  static copyReaderOptions(values) {
+    const {
+      emit: _emit,
+      schema: _schema,
+      classes: _classes,
+      ...readerOptions
+    } = values;
+    return readerOptions;
+  }
+}
+
+export { CjsBlackFormat, CjsBlackFormat as default };
+//# sourceMappingURL=CjsBlackFormat.js.map

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

@@ -0,0 +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     * 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    static OUTPUT_JSON = OUTPUT_JSON;\n    static OUTPUT_RAW = OUTPUT_RAW;\n    static OUTPUT_DOCUMENT = OUTPUT_DOCUMENT;\n    static OUTPUT_PAYLOAD = OUTPUT_PAYLOAD;\n    static OUTPUT_RUNTIME = OUTPUT_RUNTIME;\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    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","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","OUTPUT_PAYLOAD","id","CJS_BLACK_FORMAT_ID","extensions","Object","freeze","CJS_BLACK_EXTENSION","fourCC","CJS_BLACK_FOURCC","version","CJS_BLACK_VERSION","mediaTypes","inputTypes","outputTypes","debugOutputTypes","_emit","_schema","_classes","readerOptions"],"mappings":";;;;;AAqBA,MAAMA,WAAW,GAAG,gBAAgB;;AAEpC;AACA;AACA;AACA;AACA;AACA;AACO,MAAMC,cAAc,CAC3B;AAEI,EAAA,KAAK,GAAGC,cAAc,CAACC,IAAI;AAC3B,EAAA,OAAO,GAAGD,cAAc,CAACE,MAAM;EAC/B,cAAc,GAAG,EAAE;EACnB,QAAQ,GAAG,EAAE;;AAEb;AACJ;AACA;AACA;AACA;AACIC,EAAAA,WAAWA,CAACC,OAAO,GAAG,EAAE,EACxB;AACI,IAAA,IAAI,CAACC,SAAS,CAACD,OAAO,CAAC;AAC3B,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;AACIC,EAAAA,SAASA,CAACD,OAAO,GAAG,EAAE,EACtB;AACI,IAAA,MAAME,MAAM,GAAGC,eAAe,CAAC,IAAI,CAACC,SAAS,EAAE,EAAEJ,OAAO,EAAEK,UAAU,EAAEX,WAAW,CAAC;AAClF,IAAA,IAAI,CAAC,KAAK,GAAGQ,MAAM,CAACL,IAAI;AACxB,IAAA,IAAI,CAAC,OAAO,GAAGK,MAAM,CAACJ,MAAM;AAC5B,IAAA,IAAI,CAAC,QAAQ,GAAGI,MAAM,CAACI,OAAO;IAC9B,IAAI,CAAC,cAAc,GAAGX,cAAc,CAACY,iBAAiB,CAACL,MAAM,CAAC;AAC9D,IAAA,OAAO,IAAI;AACf,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;AACIE,EAAAA,SAASA,CAACJ,OAAO,GAAG,EAAE,EACtB;AACI,IAAA,OAAOG,eAAe,CAAC;AACnBN,MAAAA,IAAI,EAAE,IAAI,CAAC,KAAK;AAChBC,MAAAA,MAAM,EAAE,IAAI,CAAC,OAAO;MACpB,GAAG,IAAI,CAAC,cAAc;MACtBQ,OAAO,EAAE,IAAI,CAAC;AAClB,KAAC,EAAEN,OAAO,EAAEK,UAAU,EAAEX,WAAW,CAAC;AACxC,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;AACIc,EAAAA,UAAUA,CAACF,OAAO,GAAG,EAAE,EACvB;IACI,OAAO,IAAI,CAACL,SAAS,CAAC;AAAEK,MAAAA;AAAQ,KAAC,CAAC;AACtC,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;AACA;AACIG,EAAAA,QAAQA,CAACC,IAAI,EAAEC,KAAK,EACpB;AACIC,IAAAA,gBAAgB,CAACP,UAAU,EAAEK,IAAI,EAAEhB,WAAW,CAAC;AAC/C,IAAA,IAAIiB,KAAK,KAAK,IAAI,IAAIA,KAAK,KAAKE,SAAS,EACzC;AACI,MAAA,OAAO,IAAI,CAAC,QAAQ,CAACH,IAAI,CAAC;AAC1B,MAAA,OAAO,IAAI;AACf,IAAA;IAEAI,aAAa,CAACT,UAAU,EAAEK,IAAI,EAAEC,KAAK,EAAEjB,WAAW,CAAC;IACnD,IAAI,CAAC,QAAQ,GAAG;MAAE,GAAG,IAAI,CAAC,QAAQ;AAAE,MAAA,CAACgB,IAAI,GAAGC;KAAO;AACnD,IAAA,OAAO,IAAI;AACf,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;EACII,QAAQA,CAACL,IAAI,EACb;AACIE,IAAAA,gBAAgB,CAACP,UAAU,EAAEK,IAAI,EAAEhB,WAAW,CAAC;AAC/C,IAAA,OAAO,IAAI,CAAC,QAAQ,CAACgB,IAAI,CAAC;AAC9B,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;EACIM,QAAQA,CAACN,IAAI,EACb;AACI,IAAA,OAAO,CAAC,CAAC,IAAI,CAACK,QAAQ,CAACL,IAAI,CAAC;AAChC,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;AACA;AACIO,EAAAA,IAAIA,CAACC,KAAK,EAAElB,OAAO,GAAG,EAAE,EACxB;AACI,IAAA,OAAOL,cAAc,CAACwB,IAAI,CAACD,KAAK,EAAE,IAAI,CAACd,SAAS,CAACJ,OAAO,CAAC,CAAC;AAC9D,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;AACA;AACIoB,EAAAA,YAAYA,CAACF,KAAK,EAAElB,OAAO,GAAG,EAAE,EAChC;AACI,IAAA,OAAOL,cAAc,CAAC0B,YAAY,CAACH,KAAK,EAAE,IAAI,CAACd,SAAS,CAACJ,OAAO,CAAC,CAAC;AACtE,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;AACA;AACIsB,EAAAA,WAAWA,CAACJ,KAAK,EAAElB,OAAO,GAAG,EAAE,EAC/B;AACI,IAAA,OAAOL,cAAc,CAAC4B,WAAW,CAACL,KAAK,EAAE,IAAI,CAACd,SAAS,CAACJ,OAAO,CAAC,CAAC;AACrE,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;AACA;AACIwB,EAAAA,WAAWA,CAACN,KAAK,EAAElB,OAAO,GAAG,EAAE,EAC/B;AACI,IAAA,OAAOL,cAAc,CAAC8B,WAAW,CAACP,KAAK,EAAE,IAAI,CAACd,SAAS,CAACJ,OAAO,CAAC,CAAC;AACrE,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;AACA;AACI0B,EAAAA,OAAOA,CAACR,KAAK,EAAElB,OAAO,GAAG,EAAE,EAC3B;AACI,IAAA,OAAOL,cAAc,CAACgC,OAAO,CAACT,KAAK,EAAE,IAAI,CAACd,SAAS,CAACJ,OAAO,CAAC,CAAC;AACjE,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;EACI4B,MAAMA,CAACC,KAAK,EACZ;IACI,OAAOC,WAAW,CAACD,KAAK,CAAC;AAC7B,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;AACA;EACI,OAAOV,IAAIA,CAACD,KAAK,EAAElB,OAAO,GAAG,EAAE,EAC/B;IACI,MAAME,MAAM,GAAGC,eAAe,CAACP,cAAc,EAAEI,OAAO,EAAEK,UAAU,EAAEX,WAAW,CAAC;IAChF,IAAIQ,MAAM,CAACL,IAAI,KAAKkC,eAAe,IAAI7B,MAAM,CAACL,IAAI,KAAKmC,UAAU,EAAE,OAAOrC,cAAc,CAAC0B,YAAY,CAACH,KAAK,EAAEhB,MAAM,CAAC;AACpH,IAAA,IAAIA,MAAM,CAACL,IAAI,KAAKoC,cAAc,EAAE,OAAOtC,cAAc,CAAC4B,WAAW,CAACL,KAAK,EAAEhB,MAAM,CAAC;AACpF,IAAA,OAAOP,cAAc,CAAC8B,WAAW,CAACP,KAAK,EAAEhB,MAAM,CAAC;AACpD,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;AACA;EACI,OAAOmB,YAAYA,CAACH,KAAK,EAAElB,OAAO,GAAG,EAAE,EACvC;AACI,IAAA,OAAO,IAAIkC,cAAc,CAAChB,KAAK,EAAEf,eAAe,CAACP,cAAc,EAAEI,OAAO,EAAEK,UAAU,EAAEX,WAAW,CAAC,CAAC,CAAC0B,YAAY,EAAE;AACtH,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;AACA;EACI,OAAOG,WAAWA,CAACL,KAAK,EAAElB,OAAO,GAAG,EAAE,EACtC;AACI,IAAA,OAAO,IAAIkC,cAAc,CAAChB,KAAK,EAAEf,eAAe,CAACP,cAAc,EAAEI,OAAO,EAAEK,UAAU,EAAEX,WAAW,CAAC,CAAC,CAAC4B,WAAW,EAAE;AACrH,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;AACA;EACI,OAAOG,WAAWA,CAACP,KAAK,EAAElB,OAAO,GAAG,EAAE,EACtC;AACI,IAAA,OAAO,IAAIkC,cAAc,CAAChB,KAAK,EAAEf,eAAe,CAACP,cAAc,EAAEI,OAAO,EAAEK,UAAU,EAAEX,WAAW,CAAC,CAAC,CAAC8B,WAAW,EAAE;AACrH,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;AACA;EACI,OAAOG,OAAOA,CAACT,KAAK,EAAElB,OAAO,GAAG,EAAE,EAClC;AACI,IAAA,OAAO,IAAIkC,cAAc,CAAChB,KAAK,EAAEf,eAAe,CAACP,cAAc,EAAEI,OAAO,EAAEK,UAAU,EAAEX,WAAW,CAAC,CAAC,CAACgC,OAAO,EAAE;AACjH,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;EACI,OAAOS,MAAMA,CAACN,KAAK,EACnB;IACI,OAAOC,WAAW,CAACD,KAAK,CAAC;AAC7B,EAAA;EAEA,OAAOO,WAAW,GAAGA,WAAW;EAChC,OAAOJ,UAAU,GAAGA,UAAU;EAC9B,OAAOD,eAAe,GAAGA,eAAe;EACxC,OAAOM,cAAc,GAAGA,cAAc;EACtC,OAAOJ,cAAc,GAAGA,cAAc;EACtC,OAAO5B,UAAU,GAAGA,UAAU;EAC9B,OAAOiC,EAAE,GAAGC,mBAAmB;EAC/B,OAAOC,UAAU,GAAGC,MAAM,CAACC,MAAM,CAAC,CAACC,mBAAmB,CAAC,CAAC;EACxD,OAAOC,MAAM,GAAGC,gBAAgB;EAChC,OAAOC,OAAO,GAAGC,iBAAiB;EAClC,OAAOrC,IAAI,GAAG+B,MAAM,CAACC,MAAM,CAAC,CAAE,MAAM,CAAE,CAAC;EACvC,OAAOM,UAAU,GAAGP,MAAM,CAACC,MAAM,CAAC,CAAE,MAAM,CAAE,CAAC;EAC7C,OAAOO,UAAU,GAAGR,MAAM,CAACC,MAAM,CAAC,CAAE,OAAO,CAAE,CAAC;AAC9C,EAAA,OAAOQ,WAAW,GAAGT,MAAM,CAACC,MAAM,CAAC,CAAEN,WAAW,EAAEL,eAAe,EAAEM,cAAc,EAAEJ,cAAc,CAAE,CAAC;EACpG,OAAOkB,gBAAgB,GAAGV,MAAM,CAACC,MAAM,CAAC,CAAEV,UAAU,CAAE,CAAC;EAEvD,OAAOzB,iBAAiBA,CAACL,MAAM,EAC/B;IACI,MAAM;AACFL,MAAAA,IAAI,EAAEuD,KAAK;AACXtD,MAAAA,MAAM,EAAEuD,OAAO;AACf/C,MAAAA,OAAO,EAAEgD,QAAQ;MACjB,GAAGC;AACP,KAAC,GAAGrD,MAAM;AACV,IAAA,OAAOqD,aAAa;AACxB,EAAA;AAEJ;;;;"}

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

@@ -0,0 +1,153 @@
+class CjsBlackBinaryReader {
+  constructor(dataView, context = null) {
+    if (!(dataView instanceof DataView)) {
+      throw new TypeError("CjsBlackBinaryReader expected a DataView");
+    }
+    this.data = dataView;
+    this.context = context;
+    this.offset = 0;
+  }
+  get remaining() {
+    return this.data.byteLength - this.offset;
+  }
+  AtEnd() {
+    return this.remaining === 0;
+  }
+  ExpectEnd(message = "Black reader did not reach end") {
+    if (!this.AtEnd()) {
+      throw new RangeError(`${message}: ${this.remaining} bytes remain`);
+    }
+  }
+  ExpectU32(expected, message) {
+    const actual = this.ReadU32();
+    if (actual !== expected) {
+      throw new RangeError(`${message}: expected ${expected}, got ${actual}`);
+    }
+    return actual;
+  }
+  ReadBinaryReader(byteLength) {
+    return new CjsBlackBinaryReader(this.ReadDataView(byteLength), this.context);
+  }
+  ReadBytes(byteLength) {
+    const view = this.ReadDataView(byteLength);
+    return new Uint8Array(view.buffer, view.byteOffset, view.byteLength);
+  }
+  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);
+  }
+  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);
+  }
+  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;
+  }
+  ReadF32() {
+    const value = this.data.getFloat32(this.offset, true);
+    this.offset += 4;
+    return value;
+  }
+  ReadF64() {
+    const value = this.data.getFloat64(this.offset, true);
+    this.offset += 8;
+    return value;
+  }
+  ReadI8() {
+    const value = this.data.getInt8(this.offset);
+    this.offset += 1;
+    return value;
+  }
+  ReadI16() {
+    const value = this.data.getInt16(this.offset, true);
+    this.offset += 2;
+    return value;
+  }
+  ReadI32() {
+    const value = this.data.getInt32(this.offset, true);
+    this.offset += 4;
+    return value;
+  }
+  ReadI64() {
+    return this.data.getBigInt64(this.ConsumeOffset(8), true);
+  }
+  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];
+  }
+  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];
+  }
+  ReadU8() {
+    const value = this.data.getUint8(this.offset);
+    this.offset += 1;
+    return value;
+  }
+  ReadU16() {
+    const value = this.data.getUint16(this.offset, true);
+    this.offset += 2;
+    return value;
+  }
+  ReadU32() {
+    const value = this.data.getUint32(this.offset, true);
+    this.offset += 4;
+    return value;
+  }
+  ReadU64() {
+    return this.data.getBigUint64(this.ConsumeOffset(8), true);
+  }
+  Skip(byteLength) {
+    this.ReadDataView(byteLength);
+  }
+  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;
+  }
+  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