npm - @carbonenginejs/runtime-resource - Versions diffs - 0.1.0 → 0.7.0 - Mend

@carbonenginejs/runtime-resource 0.1.0 → 0.7.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (186) hide show

package/dist/format/CjsResourceProbe.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"CjsResourceProbe.js","sources":["../../../src/format/CjsResourceProbe.js"],"sourcesContent":["import { CjsModel } from \"@carbonenginejs/core-types/model\";\nimport { io, type } from \"@carbonenginejs/core-types/schema\";\n\n/*\n Standard probe report for resource formats and a reusable base for format-specific probes.\n \n Instances can be built by:\n * - returning plain object JSON payloads from format packages, then converted with CjsResourceProbe.from(...)\n * - returning CjsResourceProbe instances directly\n \n A format can report multiple usable variants in one payload, such as a\n * native compressed texture and a decoded RGBA fallback, without deciding\n * which engine-gpu or media backend should use.\n /\n@type.define({ className: \"CjsResourceProbe\", family: \"resource\" })\nexport class CjsResourceProbe extends CjsModel\n{\n @io.persist\n @type.string\n format = \"\";\n\n @io.persist\n @type.string\n source = \"\";\n\n @io.persist\n @type.string\n supported = \"none\";\n\n @io.persist\n @type.float64\n confidence = 0;\n\n @io.persist\n @type.string\n preferred = \"\";\n\n @io.persist\n @type.string\n reason = \"\";\n\n @io.persist\n @type.unknown\n metadata = null;\n\n @io.persist\n @type.unknown\n variant = {};\n\n @io.persist\n @type.list(\"unknown\")\n variants = [];\n\n @io.persist\n @type.list(\"string\")\n warnings = [];\n\n @io.persist\n @type.list(\"string\")\n errors = [];\n\n constructor(values = null) {\n super();\n this.SetValues(values \|\| {}, {\n markDirty: false,\n skipUpdate: true,\n skipEvents: true\n });\n }\n\n /\n Initialize probe fields from a plain object payload.\n \n @param {object\|null} values\n * @returns {CjsResourceProbe}\n /\n Initialize(values = null) {\n this.SetValues(values \|\| {}, { skipEvents: true });\n return this;\n }\n\n /\n Lightweight probe entrypoint.\n * Format packages should override this or provide their own probe implementation.\n \n @param {} src\n Raw source path or source payload passed by caller.\n * @param {object\|null} options\n * Optional metadata/control overrides.\n * @returns {CjsResourceProbe}\n /\n static isSupported(src, options = null) {\n return new CjsResourceProbe({\n format: \"\",\n source: typeof src === \"string\" ? src : \"buffer\",\n supported: \"none\",\n confidence: 0,\n preferred: \"\",\n reason: \"No probe provided.\",\n metadata: null,\n variant: {},\n variants: [],\n warnings: [],\n errors: [\"CjsResourceProbe has no built-in format detection.\"],\n ...options\n });\n }\n\n /\n Detailed probe with report-style metadata. Aliases isSupported() in this minimal base.\n \n @param {} src\n @param {object\|null} options\n * @returns {CjsResourceProbe}\n /\n static inspect(src, options = null) {\n return CjsResourceProbe.isSupported(src, options);\n }\n\n /\n Build a probe report representing explicit failure.\n \n @param {string} format\n * @param {string} reason\n * @param {object\|null} options\n * @returns {CjsResourceProbe}\n /\n static createUnsupported(format, reason, options = null) {\n return new CjsResourceProbe({\n format,\n supported: \"none\",\n confidence: 0,\n preferred: \"\",\n reason: reason \|\| \"Unsupported format.\",\n variant: {},\n variants: [],\n warnings: [],\n errors: [reason],\n ...(options \|\| {})\n });\n }\n\n /\n Build a probe report representing one or more variants.\n \n @param {string} format\n * @param {Array<Object>} variants\n * @param {object\|null} options\n * @returns {CjsResourceProbe}\n /\n static createSupported(format, variants, options = null) {\n const normalizedVariants = Array.isArray(variants) ? variants : [];\n const anySupported = normalizedVariants.some((entry) => entry && entry.supported === true);\n const normalized = normalizedVariants.map((entry) => CjsResourceProbe.normalizeVariant(entry));\n const preferred = options && options.preferred ? options.preferred : CjsResourceProbe.selectPreferred(normalized);\n\n return new CjsResourceProbe({\n format,\n source: options?.source \|\| \"\",\n supported: anySupported ? \"full\" : normalizedVariants.length > 0 ? \"partial\" : \"none\",\n confidence: normalized.length > 0 && anySupported ? 1 : (normalized.length > 0 ? 0.5 : 0),\n preferred,\n reason: options?.reason \|\| (anySupported ? \"Supported variant found.\" : \"No variant supported.\"),\n metadata: options?.metadata \|\| null,\n variant: normalized[0] \|\| {},\n variants: normalized,\n warnings: Array.isArray(options?.warnings) ? options.warnings : [],\n errors: Array.isArray(options?.errors) ? options.errors : [],\n ...(options \|\| {})\n });\n }\n\n /\n Normalize incoming report payloads into a standard CjsResourceProbe instance.\n \n @param {CjsResourceProbe\|object\|null} input\n * @returns {CjsResourceProbe}\n /\n static from(input) {\n if (input instanceof CjsResourceProbe) return input;\n if (!input) return CjsResourceProbe.createUnsupported(\"\", \"No probe input.\");\n if (typeof input === \"object\" && typeof input.toJSON === \"function\") {\n return new CjsResourceProbe(CjsResourceProbe.normalizeReport(input.toJSON()));\n }\n if (typeof input === \"object\") return new CjsResourceProbe(CjsResourceProbe.normalizeReport(input));\n return CjsResourceProbe.createUnsupported(\"\", \"Invalid probe payload.\");\n }\n\n /\n Normalize a plain probe report while preserving format-specific metadata.\n \n @param {object} input\n * @returns {object}\n /\n static normalizeReport(input) {\n const variants = Array.isArray(input.variants)\n ? input.variants.map((entry) => CjsResourceProbe.normalizeVariant(entry))\n : [];\n return {\n ...input,\n variant: input.variant ? CjsResourceProbe.normalizeVariant(input.variant) : variants[0] \|\| {},\n variants\n };\n }\n\n /\n Normalize variant objects so runtimes can evaluate capability uniformly.\n \n @param {object\|any} input\n * @returns {{kind: string, payloadType: string, codec: string, format: string, supported: boolean, reason: string, meta: }}\n /\n static normalizeVariant(input) {\n if (!input \|\| typeof input !== \"object\") {\n return {\n kind: \"raw\",\n payloadType: \"raw\",\n codec: \"\",\n format: \"\",\n supported: false,\n reason: \"Invalid variant payload.\",\n meta: null\n };\n }\n\n const kind = input.kind \|\| input.payloadType \|\| \"raw\";\n return {\n ...input,\n kind,\n payloadType: input.payloadType \|\| kind,\n codec: input.codec \|\| \"\",\n format: input.format \|\| \"\",\n supported: !!input.supported,\n reason: input.reason \|\| \"\",\n meta: input.meta \|\| null\n };\n }\n\n /*\n Select best preferred variant from normalized variant list.\n \n @param {Array<Object>} variants\n * @returns {string}\n /\n static selectPreferred(variants) {\n if (!Array.isArray(variants) \|\| variants.length < 1) return \"\";\n const priority = [ \"compressed\", \"texture\", \"rgba\", \"pcm\", \"raw\", \"container\", \"video\", \"audio\" ];\n const preferred = priority\n .map((kind) => variants.find((variant) => variant.kind === kind && variant.supported))\n .find(Boolean) \|\| variants.find((variant) => variant.supported);\n return preferred ? preferred.codec \|\| preferred.payloadType \|\| preferred.kind \|\| \"\" : \"\";\n }\n\n /\n Returns true if any supported variant is available.\n \n @returns {boolean}\n /\n isSupported() {\n return this.supported === \"full\" \|\| this.supported === \"partial\";\n }\n\n /\n Returns true if raw fallback variant is supported.\n \n @returns {boolean}\n /\n canUseRaw() {\n return this.variants.some((entry) => entry && [ \"raw\", \"rgba\" ].includes(entry.kind) && entry.supported);\n }\n\n /\n Returns true if compressed variant is supported.\n \n @returns {boolean}\n /\n canUseCompressed() {\n return this.variants.some((entry) => entry && entry.kind === \"compressed\" && entry.supported);\n }\n\n /\n Return true when a supported variant of the requested kind exists.\n \n @param {string} kind\n * @returns {boolean}\n */\n canUse(kind) {\n return this.variants.some((entry) => entry && entry.kind === kind && entry.supported);\n }\n}\n"],"names":["_CjsResourceProbe","CjsResourceProbe","CjsModel","e","_init_format","_init_extra_format","_init_source","_init_extra_source","_init_supported","_init_extra_supported","_init_confidence","_init_extra_confidence","_init_preferred","_init_extra_preferred","_init_reason","_init_extra_reason","_init_metadata","_init_extra_metadata","_init_variant","_init_extra_variant","_init_variants","_init_extra_variants","_init_warnings","_init_extra_warnings","_init_errors","_init_extra_errors","c","_initClass","_applyDecs","type","define","className","family","io","persist","string","float64","unknown","list","format","source","supported","confidence","preferred","reason","metadata","variant","variants","warnings","errors","constructor","values","SetValues","markDirty","skipUpdate","skipEvents","Initialize","isSupported","src","options","inspect","createUnsupported","createSupported","normalizedVariants","Array","isArray","anySupported","some","entry","normalized","map","normalizeVariant","selectPreferred","length","from","input","toJSON","normalizeReport","kind","payloadType","codec","meta","priority","find","Boolean","canUseRaw","includes","canUseCompressed","canUse"],"mappings":"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"}
1	+ {"version":3,"file":"CjsResourceProbe.js","sources":["../../../src/format/CjsResourceProbe.js"],"sourcesContent":["import { CjsModel } from \"@carbonenginejs/core-types/model\";\nimport { io, type } from \"@carbonenginejs/core-types/schema\";\n\n/*\n Standard probe report for resource formats and a reusable base for format-specific probes.\n \n Instances can be built by:\n * - returning plain object JSON payloads from format packages, then converted with CjsResourceProbe.from(...)\n * - returning CjsResourceProbe instances directly\n \n A format can report multiple usable variants in one payload, such as a\n * native compressed texture and a decoded RGBA fallback, without deciding\n * which engine-gpu or media backend should use.\n /\n@type.define({ className: \"CjsResourceProbe\", family: \"resource\" })\nexport class CjsResourceProbe extends CjsModel\n{\n @io.persist\n @type.string\n format = \"\";\n\n @io.persist\n @type.string\n source = \"\";\n\n @io.persist\n @type.string\n supported = \"none\";\n\n /\n True when the report's variant flags are CONTENT-verified (a bounded\n * resolveType() check ran), false when they are declaration-derived\n * (inspect/isSupported). Declared/resolved/mismatch evidence rides in\n * `metadata` per the kb §5 content-verified type resolution contract.\n /\n @io.persist\n @type.boolean\n verified = false;\n\n @io.persist\n @type.float64\n confidence = 0;\n\n @io.persist\n @type.string\n preferred = \"\";\n\n @io.persist\n @type.string\n reason = \"\";\n\n @io.persist\n @type.unknown\n metadata = null;\n\n @io.persist\n @type.unknown\n variant = {};\n\n @io.persist\n @type.list(\"unknown\")\n variants = [];\n\n @io.persist\n @type.list(\"string\")\n warnings = [];\n\n @io.persist\n @type.list(\"string\")\n errors = [];\n\n constructor(values = null) {\n super();\n this.SetValues(values \|\| {}, {\n markDirty: false,\n skipUpdate: true,\n skipEvents: true\n });\n }\n\n /\n Initialize probe fields from a plain object payload.\n \n @param {object\|null} values\n * @returns {CjsResourceProbe}\n /\n Initialize(values = null) {\n this.SetValues(values \|\| {}, { skipEvents: true });\n return this;\n }\n\n /\n Lightweight probe entrypoint.\n * Format packages should override this or provide their own probe implementation.\n \n @param {} src\n Raw source path or source payload passed by caller.\n * @param {object\|null} options\n * Optional metadata/control overrides.\n * @returns {CjsResourceProbe}\n /\n static isSupported(src, options = null) {\n return new CjsResourceProbe({\n format: \"\",\n source: typeof src === \"string\" ? src : \"buffer\",\n supported: \"none\",\n confidence: 0,\n preferred: \"\",\n reason: \"No probe provided.\",\n metadata: null,\n variant: {},\n variants: [],\n warnings: [],\n errors: [\"CjsResourceProbe has no built-in format detection.\"],\n ...options\n });\n }\n\n /\n Detailed probe with report-style metadata. Aliases isSupported() in this minimal base.\n \n @param {} src\n @param {object\|null} options\n * @returns {CjsResourceProbe}\n /\n static inspect(src, options = null) {\n return CjsResourceProbe.isSupported(src, options);\n }\n\n /\n Build a probe report representing explicit failure.\n \n @param {string} format\n * @param {string} reason\n * @param {object\|null} options\n * @returns {CjsResourceProbe}\n /\n static createUnsupported(format, reason, options = null) {\n return new CjsResourceProbe({\n format,\n supported: \"none\",\n confidence: 0,\n preferred: \"\",\n reason: reason \|\| \"Unsupported format.\",\n variant: {},\n variants: [],\n warnings: [],\n errors: [reason],\n ...(options \|\| {})\n });\n }\n\n /\n Build a probe report representing one or more variants.\n \n @param {string} format\n * @param {Array<Object>} variants\n * @param {object\|null} options\n * @returns {CjsResourceProbe}\n /\n static createSupported(format, variants, options = null) {\n const normalizedVariants = Array.isArray(variants) ? variants : [];\n const anySupported = normalizedVariants.some((entry) => entry && entry.supported === true);\n const normalized = normalizedVariants.map((entry) => CjsResourceProbe.normalizeVariant(entry));\n const preferred = options && options.preferred ? options.preferred : CjsResourceProbe.selectPreferred(normalized);\n\n return new CjsResourceProbe({\n format,\n source: options?.source \|\| \"\",\n supported: anySupported ? \"full\" : normalizedVariants.length > 0 ? \"partial\" : \"none\",\n confidence: normalized.length > 0 && anySupported ? 1 : (normalized.length > 0 ? 0.5 : 0),\n preferred,\n reason: options?.reason \|\| (anySupported ? \"Supported variant found.\" : \"No variant supported.\"),\n metadata: options?.metadata \|\| null,\n variant: normalized[0] \|\| {},\n variants: normalized,\n warnings: Array.isArray(options?.warnings) ? options.warnings : [],\n errors: Array.isArray(options?.errors) ? options.errors : [],\n ...(options \|\| {})\n });\n }\n\n /\n Normalize incoming report payloads into a standard CjsResourceProbe instance.\n \n @param {CjsResourceProbe\|object\|null} input\n * @returns {CjsResourceProbe}\n /\n static from(input) {\n if (input instanceof CjsResourceProbe) return input;\n if (!input) return CjsResourceProbe.createUnsupported(\"\", \"No probe input.\");\n if (typeof input === \"object\" && typeof input.toJSON === \"function\") {\n return new CjsResourceProbe(CjsResourceProbe.normalizeReport(input.toJSON()));\n }\n if (typeof input === \"object\") return new CjsResourceProbe(CjsResourceProbe.normalizeReport(input));\n return CjsResourceProbe.createUnsupported(\"\", \"Invalid probe payload.\");\n }\n\n /\n Normalize a plain probe report while preserving format-specific metadata.\n \n @param {object} input\n * @returns {object}\n /\n static normalizeReport(input) {\n const variants = Array.isArray(input.variants)\n ? input.variants.map((entry) => CjsResourceProbe.normalizeVariant(entry))\n : [];\n return {\n ...input,\n variant: input.variant ? CjsResourceProbe.normalizeVariant(input.variant) : variants[0] \|\| {},\n variants\n };\n }\n\n /\n Normalize variant objects so runtimes can evaluate capability uniformly.\n \n @param {object\|any} input\n * @returns {{kind: string, payloadType: string, codec: string, format: string, supported: boolean, reason: string, meta: }}\n /\n static normalizeVariant(input) {\n if (!input \|\| typeof input !== \"object\") {\n return {\n kind: \"raw\",\n payloadType: \"raw\",\n codec: \"\",\n format: \"\",\n supported: false,\n reason: \"Invalid variant payload.\",\n meta: null\n };\n }\n\n const kind = input.kind \|\| input.payloadType \|\| \"raw\";\n return {\n ...input,\n kind,\n payloadType: input.payloadType \|\| kind,\n codec: input.codec \|\| \"\",\n format: input.format \|\| \"\",\n supported: !!input.supported,\n reason: input.reason \|\| \"\",\n meta: input.meta \|\| null\n };\n }\n\n /*\n Select best preferred variant from normalized variant list.\n \n @param {Array<Object>} variants\n * @returns {string}\n /\n static selectPreferred(variants) {\n if (!Array.isArray(variants) \|\| variants.length < 1) return \"\";\n const priority = [ \"compressed\", \"texture\", \"rgba\", \"pcm\", \"raw\", \"container\", \"video\", \"audio\" ];\n const preferred = priority\n .map((kind) => variants.find((variant) => variant.kind === kind && variant.supported))\n .find(Boolean) \|\| variants.find((variant) => variant.supported);\n return preferred ? preferred.codec \|\| preferred.payloadType \|\| preferred.kind \|\| \"\" : \"\";\n }\n\n /\n Returns true if any supported variant is available.\n \n @returns {boolean}\n /\n isSupported() {\n return this.supported === \"full\" \|\| this.supported === \"partial\";\n }\n\n /\n Returns true if raw fallback variant is supported.\n \n @returns {boolean}\n /\n canUseRaw() {\n return this.variants.some((entry) => entry && [ \"raw\", \"rgba\" ].includes(entry.kind) && entry.supported);\n }\n\n /\n Returns true if compressed variant is supported.\n \n @returns {boolean}\n /\n canUseCompressed() {\n return this.variants.some((entry) => entry && entry.kind === \"compressed\" && entry.supported);\n }\n\n /\n Return true when a supported variant of the requested kind exists.\n \n @param {string} kind\n * @returns {boolean}\n */\n canUse(kind) {\n return this.variants.some((entry) => entry && entry.kind === kind && entry.supported);\n }\n}\n"],"names":["_CjsResourceProbe","CjsResourceProbe","CjsModel","e","_init_format","_init_extra_format","_init_source","_init_extra_source","_init_supported","_init_extra_supported","_init_verified","_init_extra_verified","_init_confidence","_init_extra_confidence","_init_preferred","_init_extra_preferred","_init_reason","_init_extra_reason","_init_metadata","_init_extra_metadata","_init_variant","_init_extra_variant","_init_variants","_init_extra_variants","_init_warnings","_init_extra_warnings","_init_errors","_init_extra_errors","c","_initClass","_applyDecs","type","define","className","family","io","persist","string","boolean","float64","unknown","list","format","source","supported","verified","confidence","preferred","reason","metadata","variant","variants","warnings","errors","constructor","values","SetValues","markDirty","skipUpdate","skipEvents","Initialize","isSupported","src","options","inspect","createUnsupported","createSupported","normalizedVariants","Array","isArray","anySupported","some","entry","normalized","map","normalizeVariant","selectPreferred","length","from","input","toJSON","normalizeReport","kind","payloadType","codec","meta","priority","find","Boolean","canUseRaw","includes","canUseCompressed","canUse"],"mappings":"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"}

package/dist/formats/black/CjsBlackFormat.js CHANGED Viewed

@@ -1,5 +1,5 @@
 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 { DEFAULT_VALUES, normalizeValues, validateClassKey, validateClass, toJsonValue, OUTPUT_DOCUMENT, OUTPUT_RAW, OUTPUT_RUNTIME, OUTPUT_PAYLOAD, OUTPUT_JSON } 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';
@@ -242,11 +242,17 @@ class CjsBlackFormat {
   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;
+  /**
+   * Emit targets for this format (canonical frozen enum).
+   */
+  static Output = Object.freeze({
+    JSON: OUTPUT_JSON,
+    RAW: OUTPUT_RAW,
+    DOCUMENT: OUTPUT_DOCUMENT,
+    PAYLOAD: OUTPUT_PAYLOAD,
+    RUNTIME: OUTPUT_RUNTIME
+  });
   static CLASS_KEYS = CLASS_KEYS;
   static id = CJS_BLACK_FORMAT_ID;
   static extensions = Object.freeze([CJS_BLACK_EXTENSION]);

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

	@@ -1 +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 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":"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"}
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 /\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 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","Object","freeze","JSON","OUTPUT_JSON","RAW","DOCUMENT","PAYLOAD","OUTPUT_PAYLOAD","RUNTIME","id","CJS_BLACK_FORMAT_ID","extensions","CJS_BLACK_EXTENSION","fourCC","CJS_BLACK_FOURCC","version","CJS_BLACK_VERSION","mediaTypes","inputTypes","outputTypes","debugOutputTypes","_emit","_schema","_classes","readerOptions"],"mappings":"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"}

package/dist/formats/black/core/CjsBlackReader.js CHANGED Viewed

@@ -1,32 +1,36 @@
-import { resolveHydrationAdapter, CjsCarbonDocument, normalizeCarbonTypeDescriptor, CARBON_TYPE, normalizeCarbonValue, CjsSchema } from '@carbonenginejs/core-types';
+import { CjsCarbonDocument } from '@carbonenginejs/core-types/document';
+import { CjsSchema } from '@carbonenginejs/core-types/schema';
+import { CjsBlueReader } from '../../../format/CjsBlueReader.js';
 import { CJS_BLACK_FOURCC, CJS_BLACK_VERSION, CJS_BLACK_FORMAT_ID } from './blackConstants.js';
 import { CjsBlackBinaryReader } from './CjsBlackBinaryReader.js';
 import { CjsBlackPropertyReaders } from './CjsBlackPropertyReaders.js';
 import { CjsBlackSchemaRegistry } from './CjsBlackSchemaRegistry.js';
-class CjsBlackReader {
+/**
+ * Reads a `.black` stream into a payload/document/runtime graph.
+ *
+ * This transport owns the binary buffer, string tables, numeric references,
+ * and binary read cursor. `ResetReadState()` clears only per-read graph state;
+ * each read entrypoint separately restores the cursor to `dataOffset`.
+ */
+class CjsBlackReader extends CjsBlueReader {
   constructor(input, options = {}) {
-    this.options = {
-      ...options
-    };
+    super(options, {
+      schemaRegistry: CjsBlackSchemaRegistry,
+      defaultRegistry: CjsSchema,
+      includeShapeContext: true,
+      includeSourceShape: true,
+      includeEmptyPayloadType: true,
+      requirePayloadReferenceTarget: true
+    });
     this.reader = CjsBlackBinaryReader.from(input, this);
-    this.schemaShapes = CjsBlackSchemaRegistry.createShapeMap(options.schema);
     this.references = new Map();
     this.nodes = [];
-    this.reports = [];
     this.nextNodeId = 1;
     this.info = null;
     this.readMode = "payload";
     this.payloadDepth = 0;
     this.payloadRootFields = null;
-    this.hydrationAdapter = resolveHydrationAdapter(options);
-    this.hydrationOptions = {
-      ...options,
-      markDirty: false,
-      skipUpdate: true,
-      skipEvents: true
-    };
-    this.runtimeInstances = [];
   }
   Inspect() {
     if (this.info) return this.info;
@@ -94,17 +98,7 @@ class CjsBlackReader {
       throw new TypeError("Black root object is null");
     }
     this.reader.ExpectEnd("Black object graph did not read to end");
-    // Phase 3: the whole graph is constructed and valued (references
-    // resolved), so run the adapter's post-graph init once per instance.
-    // Instances are collected in completion order, so children finalize
-    // before their parents.
-    for (const record of this.runtimeInstances) {
-      this.hydrationAdapter.finalize(record.instance, {
-        kind: record.kind,
-        shape: record.shape
-      });
-    }
+    this.FinalizeRuntimeInstances();
     return {
       root,
       format: info.format,
@@ -115,6 +109,7 @@ class CjsBlackReader {
     const info = this.Inspect();
     this.ResetReadState();
     this.readMode = "payload";
+    this.ValidatePayloadConfiguration();
     this.reader.offset = info.dataOffset;
     const object = this.ReadObject(this.reader);
     if (object === null) {
@@ -244,16 +239,7 @@ class CjsBlackReader {
       previousBlackName = blackName;
     }
     objectReader.ExpectEnd(`${kind} did not read to end`);
-    this.hydrationAdapter.applyValues(target, values, {
-      kind,
-      shape,
-      options: this.hydrationOptions
-    });
-    this.runtimeInstances.push({
-      instance: target,
-      kind,
-      shape
-    });
+    this.ApplyRuntimeValues(target, values, kind, shape);
     return target;
   }
   ReadPayloadObject(reader) {
@@ -297,50 +283,9 @@ class CjsBlackReader {
     objectReader.ExpectEnd(`${kind} did not read to end`);
     return target;
   }
-  CreateRuntimeTarget(kind, shape) {
-    const built = this.hydrationAdapter.construct(kind, {
-      kind,
-      shape,
-      options: this.options
-    });
-    if (built !== undefined) return built;
-    const ClassConstructor = this.ResolveClass(kind);
-    if (ClassConstructor) {
-      return new ClassConstructor();
-    }
-    return {
-      _sourceClassName: kind,
-      _sourceShape: shape || null
-    };
-  }
-  CreatePayloadTarget(kind) {
-    const typeField = this.GetPayloadTypeField();
-    return typeField ? {
-      [typeField]: kind
-    } : {};
-  }
   CreateSkippedPayloadTarget() {
     return {};
   }
-  CreatePayloadReference(targetObject, blackReference) {
-    const idField = this.GetPayloadIdField();
-    const referenceField = this.GetPayloadReferenceField();
-    if (idField && !Object.hasOwn(targetObject, idField)) {
-      targetObject[idField] = blackReference;
-    }
-    return referenceField ? {
-      [referenceField]: blackReference
-    } : targetObject;
-  }
-  GetPayloadTypeField() {
-    return this.options.payloadTypeField === false ? null : this.options.payloadTypeField || "_type";
-  }
-  GetPayloadIdField() {
-    return this.options.payloadIdField === false ? null : this.options.payloadIdField || "_id";
-  }
-  GetPayloadReferenceField() {
-    return this.options.payloadReferenceField === false ? null : this.options.payloadReferenceField || "_reference";
-  }
   GetPayloadRootFields() {
     if (this.payloadRootFields !== null) return this.payloadRootFields;
     const fields = this.options.payloadRootFields ?? this.options.rootFields ?? null;
@@ -456,56 +401,6 @@ class CjsBlackReader {
       key: target.key
     };
   }
-  AssignRuntimeFieldValue(targetObject, target, value) {
-    if (target.unknown) {
-      targetObject[target.blackName] = value;
-      return;
-    }
-    if (target.indexed) {
-      let current = targetObject[target.field.name];
-      if (!current || typeof current !== "object") {
-        current = Number.isInteger(target.index) ? [] : {};
-        targetObject[target.field.name] = current;
-      }
-      current[target.key] = this.NormalizeRuntimeFieldValue(value, target.field);
-      return;
-    }
-    targetObject[target.field.name] = this.NormalizeRuntimeFieldValue(value, target.field);
-  }
-  AssignPayloadFieldValue(targetObject, target, value) {
-    if (target.unknown) {
-      targetObject[target.blackName] = value;
-      return;
-    }
-    if (target.indexed) {
-      let current = targetObject[target.field.name];
-      if (!current || typeof current !== "object") {
-        current = Number.isInteger(target.index) ? [] : {};
-        targetObject[target.field.name] = current;
-      }
-      current[target.key] = value;
-      return;
-    }
-    targetObject[target.field.name] = value;
-  }
-  NormalizeRuntimeFieldValue(value, field) {
-    if (!field) return value;
-    // In runtime mode, object-graph fields already hold constructed class
-    // instances (or arrays/dicts of them) produced by ReadObject. Passing
-    // those back through normalizeCarbonValue would deep-clone and flatten
-    // them into plain objects, dropping the constructed classes. Preserve
-    // them - matching CjsDocumentHydrator.hydrateFieldValue - and only
-    // normalize scalar/math leaf values.
-    const descriptor = normalizeCarbonTypeDescriptor(field);
-    const kind = descriptor.kind;
-    if (kind === CARBON_TYPE.ARRAY && Array.isArray(value)) return value;
-    if ((kind === CARBON_TYPE.OBJECT_REF || kind === CARBON_TYPE.STRUCT || kind === CARBON_TYPE.RAW_STRUCT || kind === CARBON_TYPE.UNKNOWN) && value && typeof value === "object") {
-      return value;
-    }
-    if (CjsBlackReader.isShapeIncompatibleMathArray(value, descriptor)) return value;
-    return normalizeCarbonValue(value, field);
-  }
   ResolveFieldTarget(kind, shape, blackName) {
     if (!shape) {
       throw new TypeError(`No source shape registered for Black type ${kind}`);
@@ -519,6 +414,7 @@ class CjsBlackReader {
     if (field) {
       return {
         blackName,
+        wireName: blackName,
         field,
         member: blackName,
         indexed: false,
@@ -534,6 +430,7 @@ class CjsBlackReader {
         const key = CjsBlackReader.normalizeIndexedKey(indexed.indexToken, indexedField);
         return {
           blackName,
+          wireName: blackName,
           field: indexedField,
           member: blackName,
           indexed: true,
@@ -638,6 +535,7 @@ class CjsBlackReader {
     const indexed = Boolean(hasIndex);
     return {
       blackName,
+      wireName: blackName,
       field,
       member: blackField.member || blackName,
       indexed,
@@ -649,6 +547,7 @@ class CjsBlackReader {
   ResolveUnknownFieldTarget(_kind, _shape, blackName) {
     return {
       blackName,
+      wireName: blackName,
       field: {
         name: "__blackUnknown",
         cppName: null,
@@ -675,34 +574,18 @@ class CjsBlackReader {
     if (this.options.captureUnknownWhenNoBlackFields && (!shape?.black || !shape.black.fields || !shape.black.fields.length)) return true;
     return false;
   }
-  ResolveSourceShape(kind) {
-    const registry = this.options.registry || null;
-    if (registry?.GetSourceShape) return registry.GetSourceShape(kind);
-    const sourceShapes = this.options.sourceShapes || null;
-    if (sourceShapes?.GetSourceShape) return sourceShapes.GetSourceShape(kind);
-    if (sourceShapes) {
-      const shape = sourceShapes instanceof Map ? sourceShapes.get(kind) : sourceShapes[kind];
-      if (shape) return CjsBlackSchemaRegistry.normalizeShape(shape);
-    }
-    return this.schemaShapes.get(kind) || null;
-  }
   ResolveClass(kind) {
     const classes = this.options.classes || {};
     const Schema = this.options.registry || CjsSchema;
     return classes[kind] || Schema.GetConstructor(kind);
   }
   ResetReadState() {
+    super.ResetBlueReadState();
     this.references = new Map();
     this.nodes = [];
-    this.reports = [];
     this.nextNodeId = this.options.firstId || 1;
     this.payloadDepth = 0;
     this.payloadRootFields = null;
-    this.runtimeInstances = [];
-  }
-  TransformPath(value) {
-    const handler = this.options.pathHandler;
-    return typeof handler === "function" ? handler(value) : value;
   }
   static readStringTable(reader) {
     const stringsReader = reader.ReadBinaryReader(reader.ReadU32());
@@ -747,10 +630,6 @@ class CjsBlackReader {
   static toJsFieldName(value) {
     return String(value || "").replace(/^m_/, "");
   }
-  static isShapeIncompatibleMathArray(value, descriptor) {
-    const expectedLength = descriptor?.length;
-    return Array.isArray(value) && Number.isInteger(expectedLength) && value.length !== expectedLength;
-  }
 }
 const CJS_BLACK_INDEX_TOKEN_NAMES = Object.freeze({
   SIMPLEPRIMARY: "SimplePrimary"