@carbonenginejs/runtime-resource 0.1.0 → 0.7.0

package/dist/format/CjsBlueReader.js

@@ -0,0 +1,269 @@
+import { resolveHydrationAdapter } from '@carbonenginejs/core-types/hydration';
+import { normalizeCarbonTypeDescriptor, CARBON_TYPE, normalizeCarbonValue } from '@carbonenginejs/core-types/types';
+import { CjsReader } from './CjsReader.js';
+
+/**
+ * Shared output and hydration backend for Blue persistence readers.
+ *
+ * Transports retain framing, source buffers, reference-token parsing, member
+ * decoding, skip/recovery behavior, and format-specific metadata. This backend
+ * owns common payload/runtime targets, reference emission, hydration adapter
+ * phases, reports, and finalization. It also provides reusable class/shape,
+ * descriptor assignment, and normalization helpers for transports that resolve
+ * persisted fields through a schema. Red does not opt into that descriptor
+ * path yet and retains its lenient named-field behavior.
+ */
+class CjsBlueReader extends CjsReader {
+  constructor(options = {}, config = {}) {
+    super({
+      ...options
+    });
+    this.schemaRegistry = config.schemaRegistry || null;
+    this.schemaShapes = this.schemaRegistry ? this.schemaRegistry.createShapeMap(options.schema) : new Map();
+    this.defaultRegistry = config.defaultRegistry || null;
+    this.includeShapeContext = Boolean(config.includeShapeContext);
+    this.includeSourceShape = Boolean(config.includeSourceShape);
+    this.includeEmptyPayloadType = Boolean(config.includeEmptyPayloadType);
+    this.requirePayloadReferenceTarget = Boolean(config.requirePayloadReferenceTarget);
+    this.includePayloadValuesField = Boolean(config.includePayloadValuesField);
+    this.validatePayloadReservedFields = Boolean(config.validatePayloadReservedFields);
+    this.payloadReservedFields = null;
+    this.adapter = resolveHydrationAdapter(options);
+    this.hydrationOptions = {
+      ...options,
+      markDirty: false,
+      skipUpdate: true,
+      skipEvents: true
+    };
+    this.ResetBlueReadState();
+  }
+  ResetBlueReadState() {
+    this.reports = [];
+    this.runtimeInstances = [];
+  }
+  FinalizeRuntimeInstances() {
+    for (const record of this.runtimeInstances) {
+      this.adapter.finalize(record.instance, this.CreateRuntimeContext(record.kind, record.shape, false));
+    }
+  }
+  CreateRuntimeTarget(kind, shape = null) {
+    const built = this.adapter.construct(kind, this.CreateRuntimeContext(kind, shape, true, this.options));
+    if (built !== undefined) return built;
+    const ClassConstructor = this.ResolveClass(kind);
+    if (ClassConstructor) return new ClassConstructor();
+    return this.CreateRuntimeFallback(kind, shape);
+  }
+  CreateRuntimeFallback(kind, shape = null) {
+    const target = {
+      _sourceClassName: this.includeSourceShape ? kind : kind || null
+    };
+    if (this.includeSourceShape) target._sourceShape = shape || null;
+    return target;
+  }
+  ApplyRuntimeValues(target, values, kind, shape = null) {
+    this.adapter.applyValues(target, values, this.CreateRuntimeContext(kind, shape, true, this.hydrationOptions));
+    this.runtimeInstances.push({
+      instance: target,
+      kind,
+      shape
+    });
+  }
+  CreateRuntimeContext(kind, shape, includeOptions, options = null) {
+    const context = {
+      kind
+    };
+    if (this.includeShapeContext) context.shape = shape;
+    if (includeOptions) context.options = options;
+    return context;
+  }
+  CreatePayloadTarget(kind) {
+    const typeField = this.GetPayloadTypeField();
+    return typeField && (kind || this.includeEmptyPayloadType) ? {
+      [typeField]: kind
+    } : {};
+  }
+  CreatePayloadReference(targetObject, referenceId) {
+    const idField = this.GetPayloadIdField();
+    const referenceField = this.GetPayloadReferenceField();
+    if (idField && this.requirePayloadReferenceTarget) {
+      this.AssignPayloadReferenceId(targetObject, idField, referenceId);
+    } else if (idField && targetObject && typeof targetObject === "object") {
+      this.AssignPayloadReferenceId(targetObject, idField, referenceId);
+    }
+    return referenceField ? {
+      [referenceField]: referenceId
+    } : targetObject;
+  }
+  GetPayloadTypeField() {
+    return this.GetPayloadField("payloadTypeField", "_type");
+  }
+  GetPayloadIdField() {
+    return this.GetPayloadField("payloadIdField", "_id");
+  }
+  GetPayloadReferenceField() {
+    return this.GetPayloadField("payloadReferenceField", "_reference");
+  }
+  GetPayloadValuesField() {
+    return this.GetPayloadField("payloadValuesField", "_values");
+  }
+  GetPayloadField(name, fallback) {
+    const value = this.options[name];
+    if (!this.validatePayloadReservedFields) {
+      return value === false ? null : value || fallback;
+    }
+    if (value === false) return null;
+    if (value === undefined) return fallback;
+    if (typeof value === "string" && value) return value;
+    throw this.PayloadError("PAYLOAD_MARKER_CONFIGURATION", `${name} must be a non-empty string or false`);
+  }
+  ValidatePayloadConfiguration() {
+    if (!this.validatePayloadReservedFields) {
+      this.payloadReservedFields = null;
+      return;
+    }
+    const fields = [["type", this.GetPayloadTypeField()], ["id", this.GetPayloadIdField()], ["reference", this.GetPayloadReferenceField()]];
+    const idField = this.GetPayloadIdField();
+    const referenceField = this.GetPayloadReferenceField();
+    const valuesField = this.includePayloadValuesField && idField ? this.GetPayloadValuesField() : null;
+    if (valuesField) fields.push(["values", valuesField]);
+    if (referenceField && !idField) {
+      throw this.PayloadError("PAYLOAD_MARKER_CONFIGURATION", "payloadReferenceField requires payloadIdField");
+    }
+    if (idField && this.includePayloadValuesField && !valuesField) {
+      throw this.PayloadError("PAYLOAD_MARKER_CONFIGURATION", "payloadIdField requires payloadValuesField for sequence identity");
+    }
+    const reserved = new Map();
+    for (const [role, field] of fields) {
+      if (!field) continue;
+      if (reserved.has(field)) {
+        throw this.PayloadError("PAYLOAD_MARKER_CONFIGURATION", `payload ${role} field "${field}" duplicates the ${reserved.get(field)} field`);
+      }
+      reserved.set(field, role);
+    }
+    this.payloadReservedFields = reserved;
+  }
+  AssertPayloadFieldAvailable(field) {
+    if (!this.validatePayloadReservedFields) return;
+    if (!this.payloadReservedFields) this.ValidatePayloadConfiguration();
+    const role = this.payloadReservedFields.get(field);
+    if (!role) return;
+    throw this.PayloadError("PAYLOAD_RESERVED_FIELD_COLLISION", `payload field "${field}" is reserved for the ${role} marker`);
+  }
+  AssignPayloadValues(targetObject, values) {
+    for (const [field, value] of Object.entries(values)) {
+      this.AssertPayloadFieldAvailable(field);
+      this.DefinePayloadProperty(targetObject, field, value);
+    }
+  }
+  AssignPayloadReferenceId(targetObject, idField, referenceId) {
+    if (!Object.hasOwn(targetObject, idField)) {
+      this.DefinePayloadProperty(targetObject, idField, referenceId);
+      return;
+    }
+    if (!this.validatePayloadReservedFields) return;
+    if (targetObject[idField] === referenceId) return;
+    throw this.PayloadError("PAYLOAD_RESERVED_FIELD_COLLISION", `payload ID field "${idField}" conflicts with reference ${referenceId}`);
+  }
+  PayloadError(code, message) {
+    const error = new TypeError(`${code}: ${message}`);
+    error.code = code;
+    return error;
+  }
+  DefinePayloadProperty(targetObject, field, value) {
+    Object.defineProperty(targetObject, field, {
+      value,
+      enumerable: true,
+      configurable: true,
+      writable: true
+    });
+  }
+  AssignRuntimeFieldValue(targetObject, target, value) {
+    if (target.unknown) {
+      targetObject[target.wireName] = 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) {
+    this.AssertPayloadFieldAvailable(target.unknown ? target.wireName : target.field.name);
+    if (target.unknown) {
+      if (this.validatePayloadReservedFields) {
+        this.DefinePayloadProperty(targetObject, target.wireName, value);
+      } else {
+        targetObject[target.wireName] = value;
+      }
+      return;
+    }
+    if (target.indexed) {
+      let current = this.validatePayloadReservedFields ? Object.hasOwn(targetObject, target.field.name) ? targetObject[target.field.name] : null : targetObject[target.field.name];
+      if (!current || typeof current !== "object") {
+        current = Number.isInteger(target.index) ? [] : {};
+        if (this.validatePayloadReservedFields) {
+          this.DefinePayloadProperty(targetObject, target.field.name, current);
+        } else {
+          targetObject[target.field.name] = current;
+        }
+      }
+      current[target.key] = value;
+      return;
+    }
+    if (this.validatePayloadReservedFields) {
+      this.DefinePayloadProperty(targetObject, target.field.name, value);
+    } else {
+      targetObject[target.field.name] = value;
+    }
+  }
+  NormalizeRuntimeFieldValue(value, field) {
+    if (!field) return value;
+
+    // Object-graph fields already contain constructed instances. Preserve
+    // those identities and normalize only 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 (CjsBlueReader.isShapeIncompatibleMathArray(value, descriptor)) return value;
+    return normalizeCarbonValue(value, field);
+  }
+  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 this.schemaRegistry?.normalizeShape ? this.schemaRegistry.normalizeShape(shape) : shape;
+      }
+    }
+    return this.schemaShapes.get(kind) || null;
+  }
+  ResolveClass(kind) {
+    if (!kind) return null;
+    const classes = this.options.classes || {};
+    const Registry = this.options.registry || this.defaultRegistry;
+    return classes[kind] || (Registry ? Registry.GetConstructor(kind) : null);
+  }
+  TransformPath(value) {
+    const handler = this.options.pathHandler;
+    return typeof handler === "function" ? handler(value) : value;
+  }
+  static isShapeIncompatibleMathArray(value, descriptor) {
+    const expectedLength = descriptor?.length;
+    return Array.isArray(value) && Number.isInteger(expectedLength) && value.length !== expectedLength;
+  }
+}
+
+export { CjsBlueReader };
+//# sourceMappingURL=CjsBlueReader.js.map

package/dist/format/CjsBlueReader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CjsBlueReader.js","sources":["../../../src/format/CjsBlueReader.js"],"sourcesContent":["import { resolveHydrationAdapter } from \"@carbonenginejs/core-types/hydration\";\nimport {\n    CARBON_TYPE,\n    normalizeCarbonTypeDescriptor,\n    normalizeCarbonValue\n} from \"@carbonenginejs/core-types/types\";\n\nimport { CjsReader } from \"./CjsReader.js\";\n\n/**\n * Shared output and hydration backend for Blue persistence readers.\n *\n * Transports retain framing, source buffers, reference-token parsing, member\n * decoding, skip/recovery behavior, and format-specific metadata. This backend\n * owns common payload/runtime targets, reference emission, hydration adapter\n * phases, reports, and finalization. It also provides reusable class/shape,\n * descriptor assignment, and normalization helpers for transports that resolve\n * persisted fields through a schema. Red does not opt into that descriptor\n * path yet and retains its lenient named-field behavior.\n */\nexport class CjsBlueReader extends CjsReader\n{\n    constructor(options = {}, config = {})\n    {\n        super({ ...options });\n\n        this.schemaRegistry = config.schemaRegistry || null;\n        this.schemaShapes = this.schemaRegistry\n            ? this.schemaRegistry.createShapeMap(options.schema)\n            : new Map();\n        this.defaultRegistry = config.defaultRegistry || null;\n        this.includeShapeContext = Boolean(config.includeShapeContext);\n        this.includeSourceShape = Boolean(config.includeSourceShape);\n        this.includeEmptyPayloadType = Boolean(config.includeEmptyPayloadType);\n        this.requirePayloadReferenceTarget = Boolean(config.requirePayloadReferenceTarget);\n        this.includePayloadValuesField = Boolean(config.includePayloadValuesField);\n        this.validatePayloadReservedFields = Boolean(config.validatePayloadReservedFields);\n        this.payloadReservedFields = null;\n        this.adapter = resolveHydrationAdapter(options);\n        this.hydrationOptions = {\n            ...options,\n            markDirty: false,\n            skipUpdate: true,\n            skipEvents: true\n        };\n        this.ResetBlueReadState();\n    }\n\n    ResetBlueReadState()\n    {\n        this.reports = [];\n        this.runtimeInstances = [];\n    }\n\n    FinalizeRuntimeInstances()\n    {\n        for (const record of this.runtimeInstances)\n        {\n            this.adapter.finalize(\n                record.instance,\n                this.CreateRuntimeContext(record.kind, record.shape, false)\n            );\n        }\n    }\n\n    CreateRuntimeTarget(kind, shape = null)\n    {\n        const built = this.adapter.construct(\n            kind,\n            this.CreateRuntimeContext(kind, shape, true, this.options)\n        );\n        if (built !== undefined) return built;\n\n        const ClassConstructor = this.ResolveClass(kind);\n        if (ClassConstructor) return new ClassConstructor();\n\n        return this.CreateRuntimeFallback(kind, shape);\n    }\n\n    CreateRuntimeFallback(kind, shape = null)\n    {\n        const target = { _sourceClassName: this.includeSourceShape ? kind : (kind || null) };\n        if (this.includeSourceShape) target._sourceShape = shape || null;\n        return target;\n    }\n\n    ApplyRuntimeValues(target, values, kind, shape = null)\n    {\n        this.adapter.applyValues(\n            target,\n            values,\n            this.CreateRuntimeContext(kind, shape, true, this.hydrationOptions)\n        );\n        this.runtimeInstances.push({ instance: target, kind, shape });\n    }\n\n    CreateRuntimeContext(kind, shape, includeOptions, options = null)\n    {\n        const context = { kind };\n        if (this.includeShapeContext) context.shape = shape;\n        if (includeOptions) context.options = options;\n        return context;\n    }\n\n    CreatePayloadTarget(kind)\n    {\n        const typeField = this.GetPayloadTypeField();\n        return typeField && (kind || this.includeEmptyPayloadType) ? { [typeField]: kind } : {};\n    }\n\n    CreatePayloadReference(targetObject, referenceId)\n    {\n        const idField = this.GetPayloadIdField();\n        const referenceField = this.GetPayloadReferenceField();\n\n        if (idField && this.requirePayloadReferenceTarget)\n        {\n            this.AssignPayloadReferenceId(targetObject, idField, referenceId);\n        }\n        else if (idField && targetObject && typeof targetObject === \"object\")\n        {\n            this.AssignPayloadReferenceId(targetObject, idField, referenceId);\n        }\n\n        return referenceField ? { [referenceField]: referenceId } : targetObject;\n    }\n\n    GetPayloadTypeField()\n    {\n        return this.GetPayloadField(\"payloadTypeField\", \"_type\");\n    }\n\n    GetPayloadIdField()\n    {\n        return this.GetPayloadField(\"payloadIdField\", \"_id\");\n    }\n\n    GetPayloadReferenceField()\n    {\n        return this.GetPayloadField(\"payloadReferenceField\", \"_reference\");\n    }\n\n    GetPayloadValuesField()\n    {\n        return this.GetPayloadField(\"payloadValuesField\", \"_values\");\n    }\n\n    GetPayloadField(name, fallback)\n    {\n        const value = this.options[name];\n        if (!this.validatePayloadReservedFields)\n        {\n            return value === false ? null : (value || fallback);\n        }\n        if (value === false) return null;\n        if (value === undefined) return fallback;\n        if (typeof value === \"string\" && value) return value;\n        throw this.PayloadError(\n            \"PAYLOAD_MARKER_CONFIGURATION\",\n            `${name} must be a non-empty string or false`\n        );\n    }\n\n    ValidatePayloadConfiguration()\n    {\n        if (!this.validatePayloadReservedFields)\n        {\n            this.payloadReservedFields = null;\n            return;\n        }\n\n        const fields = [\n            [ \"type\", this.GetPayloadTypeField() ],\n            [ \"id\", this.GetPayloadIdField() ],\n            [ \"reference\", this.GetPayloadReferenceField() ]\n        ];\n        const idField = this.GetPayloadIdField();\n        const referenceField = this.GetPayloadReferenceField();\n        const valuesField = this.includePayloadValuesField && idField\n            ? this.GetPayloadValuesField()\n            : null;\n        if (valuesField) fields.push([ \"values\", valuesField ]);\n        if (referenceField && !idField)\n        {\n            throw this.PayloadError(\n                \"PAYLOAD_MARKER_CONFIGURATION\",\n                \"payloadReferenceField requires payloadIdField\"\n            );\n        }\n        if (idField && this.includePayloadValuesField && !valuesField)\n        {\n            throw this.PayloadError(\n                \"PAYLOAD_MARKER_CONFIGURATION\",\n                \"payloadIdField requires payloadValuesField for sequence identity\"\n            );\n        }\n\n        const reserved = new Map();\n        for (const [ role, field ] of fields)\n        {\n            if (!field) continue;\n            if (reserved.has(field))\n            {\n                throw this.PayloadError(\n                    \"PAYLOAD_MARKER_CONFIGURATION\",\n                    `payload ${role} field \"${field}\" duplicates the ${reserved.get(field)} field`\n                );\n            }\n            reserved.set(field, role);\n        }\n        this.payloadReservedFields = reserved;\n    }\n\n    AssertPayloadFieldAvailable(field)\n    {\n        if (!this.validatePayloadReservedFields) return;\n        if (!this.payloadReservedFields) this.ValidatePayloadConfiguration();\n        const role = this.payloadReservedFields.get(field);\n        if (!role) return;\n        throw this.PayloadError(\n            \"PAYLOAD_RESERVED_FIELD_COLLISION\",\n            `payload field \"${field}\" is reserved for the ${role} marker`\n        );\n    }\n\n    AssignPayloadValues(targetObject, values)\n    {\n        for (const [ field, value ] of Object.entries(values))\n        {\n            this.AssertPayloadFieldAvailable(field);\n            this.DefinePayloadProperty(targetObject, field, value);\n        }\n    }\n\n    AssignPayloadReferenceId(targetObject, idField, referenceId)\n    {\n        if (!Object.hasOwn(targetObject, idField))\n        {\n            this.DefinePayloadProperty(targetObject, idField, referenceId);\n            return;\n        }\n        if (!this.validatePayloadReservedFields) return;\n        if (targetObject[idField] === referenceId) return;\n        throw this.PayloadError(\n            \"PAYLOAD_RESERVED_FIELD_COLLISION\",\n            `payload ID field \"${idField}\" conflicts with reference ${referenceId}`\n        );\n    }\n\n    PayloadError(code, message)\n    {\n        const error = new TypeError(`${code}: ${message}`);\n        error.code = code;\n        return error;\n    }\n\n    DefinePayloadProperty(targetObject, field, value)\n    {\n        Object.defineProperty(targetObject, field, {\n            value,\n            enumerable: true,\n            configurable: true,\n            writable: true\n        });\n    }\n\n    AssignRuntimeFieldValue(targetObject, target, value)\n    {\n        if (target.unknown)\n        {\n            targetObject[target.wireName] = value;\n            return;\n        }\n\n        if (target.indexed)\n        {\n            let current = targetObject[target.field.name];\n            if (!current || typeof current !== \"object\")\n            {\n                current = Number.isInteger(target.index) ? [] : {};\n                targetObject[target.field.name] = current;\n            }\n\n            current[target.key] = this.NormalizeRuntimeFieldValue(value, target.field);\n            return;\n        }\n\n        targetObject[target.field.name] = this.NormalizeRuntimeFieldValue(value, target.field);\n    }\n\n    AssignPayloadFieldValue(targetObject, target, value)\n    {\n        this.AssertPayloadFieldAvailable(target.unknown ? target.wireName : target.field.name);\n        if (target.unknown)\n        {\n            if (this.validatePayloadReservedFields)\n            {\n                this.DefinePayloadProperty(targetObject, target.wireName, value);\n            }\n            else\n            {\n                targetObject[target.wireName] = value;\n            }\n            return;\n        }\n\n        if (target.indexed)\n        {\n            let current = this.validatePayloadReservedFields\n                ? (Object.hasOwn(targetObject, target.field.name) ? targetObject[target.field.name] : null)\n                : targetObject[target.field.name];\n            if (!current || typeof current !== \"object\")\n            {\n                current = Number.isInteger(target.index) ? [] : {};\n                if (this.validatePayloadReservedFields)\n                {\n                    this.DefinePayloadProperty(targetObject, target.field.name, current);\n                }\n                else\n                {\n                    targetObject[target.field.name] = current;\n                }\n            }\n\n            current[target.key] = value;\n            return;\n        }\n\n        if (this.validatePayloadReservedFields)\n        {\n            this.DefinePayloadProperty(targetObject, target.field.name, value);\n        }\n        else\n        {\n            targetObject[target.field.name] = value;\n        }\n    }\n\n    NormalizeRuntimeFieldValue(value, field)\n    {\n        if (!field) return value;\n\n        // Object-graph fields already contain constructed instances. Preserve\n        // those identities and normalize only scalar/math leaf values.\n        const descriptor = normalizeCarbonTypeDescriptor(field);\n        const kind = descriptor.kind;\n\n        if (kind === CARBON_TYPE.ARRAY && Array.isArray(value)) return value;\n        if ((kind === CARBON_TYPE.OBJECT_REF\n            || kind === CARBON_TYPE.STRUCT\n            || kind === CARBON_TYPE.RAW_STRUCT\n            || kind === CARBON_TYPE.UNKNOWN)\n            && value && typeof value === \"object\")\n        {\n            return value;\n        }\n        if (CjsBlueReader.isShapeIncompatibleMathArray(value, descriptor)) return value;\n\n        return normalizeCarbonValue(value, field);\n    }\n\n    ResolveSourceShape(kind)\n    {\n        const registry = this.options.registry || null;\n        if (registry?.GetSourceShape) return registry.GetSourceShape(kind);\n\n        const sourceShapes = this.options.sourceShapes || null;\n        if (sourceShapes?.GetSourceShape) return sourceShapes.GetSourceShape(kind);\n        if (sourceShapes)\n        {\n            const shape = sourceShapes instanceof Map ? sourceShapes.get(kind) : sourceShapes[kind];\n            if (shape)\n            {\n                return this.schemaRegistry?.normalizeShape\n                    ? this.schemaRegistry.normalizeShape(shape)\n                    : shape;\n            }\n        }\n\n        return this.schemaShapes.get(kind) || null;\n    }\n\n    ResolveClass(kind)\n    {\n        if (!kind) return null;\n\n        const classes = this.options.classes || {};\n        const Registry = this.options.registry || this.defaultRegistry;\n        return classes[kind] || (Registry ? Registry.GetConstructor(kind) : null);\n    }\n\n    TransformPath(value)\n    {\n        const handler = this.options.pathHandler;\n        return typeof handler === \"function\" ? handler(value) : value;\n    }\n\n    static isShapeIncompatibleMathArray(value, descriptor)\n    {\n        const expectedLength = descriptor?.length;\n        return Array.isArray(value)\n            && Number.isInteger(expectedLength)\n            && value.length !== expectedLength;\n    }\n}\n\nexport default CjsBlueReader;\n"],"names":["CjsBlueReader","CjsReader","constructor","options","config","schemaRegistry","schemaShapes","createShapeMap","schema","Map","defaultRegistry","includeShapeContext","Boolean","includeSourceShape","includeEmptyPayloadType","requirePayloadReferenceTarget","includePayloadValuesField","validatePayloadReservedFields","payloadReservedFields","adapter","resolveHydrationAdapter","hydrationOptions","markDirty","skipUpdate","skipEvents","ResetBlueReadState","reports","runtimeInstances","FinalizeRuntimeInstances","record","finalize","instance","CreateRuntimeContext","kind","shape","CreateRuntimeTarget","built","construct","undefined","ClassConstructor","ResolveClass","CreateRuntimeFallback","target","_sourceClassName","_sourceShape","ApplyRuntimeValues","values","applyValues","push","includeOptions","context","CreatePayloadTarget","typeField","GetPayloadTypeField","CreatePayloadReference","targetObject","referenceId","idField","GetPayloadIdField","referenceField","GetPayloadReferenceField","AssignPayloadReferenceId","GetPayloadField","GetPayloadValuesField","name","fallback","value","PayloadError","ValidatePayloadConfiguration","fields","valuesField","reserved","role","field","has","get","set","AssertPayloadFieldAvailable","AssignPayloadValues","Object","entries","DefinePayloadProperty","hasOwn","code","message","error","TypeError","defineProperty","enumerable","configurable","writable","AssignRuntimeFieldValue","unknown","wireName","indexed","current","Number","isInteger","index","key","NormalizeRuntimeFieldValue","AssignPayloadFieldValue","descriptor","normalizeCarbonTypeDescriptor","CARBON_TYPE","ARRAY","Array","isArray","OBJECT_REF","STRUCT","RAW_STRUCT","UNKNOWN","isShapeIncompatibleMathArray","normalizeCarbonValue","ResolveSourceShape","registry","GetSourceShape","sourceShapes","normalizeShape","classes","Registry","GetConstructor","TransformPath","handler","pathHandler","expectedLength","length"],"mappings":"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"}

package/dist/format/CjsFormat.js

@@ -1,3 +1,4 @@
+import { MediaType, PayloadType } from '@carbonenginejs/runtime-const/media';
 import { CjsResourceProbe as _CjsResourceProbe } from './CjsResourceProbe.js';
 
 class CjsFormat {
@@ -55,6 +56,30 @@ class CjsFormat {
   static inspect(input, options = null) {
     return this.isSupported(input, options);
   }
+
+  /**
+   * Content-verified type/route resolution (kb §5, optional per format).
+   *
+   * Where inspect()/isSupported() report what the container CLAIMS,
+   * resolveType() performs one bounded asynchronous content check (magic, a
+   * first frame/block, a setup header) and reports what the reader has
+   * evidence it can actually decode. Overrides return a CjsResourceProbe
+   * with `verified: true` and declared/resolved/mismatch evidence in
+   * `metadata`; `preferred` names the resolved decode route. A caller-forced
+   * emit always wins over a resolution, and this base implementation - the
+   * zero-extra-work path for formats without an override - delegates to
+   * isSupported() with `verified` false so an unverified result never
+   * changes a route.
+   *
+   * @param {*} input Bytes (or path where the format supports it).
+   * @param {object|null} options Format options.
+   * @returns {Promise<CjsResourceProbe>} Probe report; content-verified only when overridden.
+   */
+  static async resolveType(input, options = null) {
+    const report = _CjsResourceProbe.from(this.isSupported(input, options));
+    report.verified = false;
+    return report;
+  }
   constructor(options = null) {
     this.options = {
       ...(options || {})
@@ -104,50 +129,39 @@ class CjsFormat {
   }
 
   /**
-   * Canonical package-family group names.
+   * Canonical package-family group names - the shared vocabulary object from
+   * runtime-const (kb: runtime-const owns cross-package media vocabulary).
+   * Same object identity as `@carbonenginejs/runtime-const/media` MediaType,
+   * so tokens can never drift between packages.
    */
-  static Type = Object.freeze({
-    AUDIO: "audio",
-    DATA: "data",
-    GEOMETRY: "geometry",
-    IMAGE: "image",
-    SCHEMA: "schema",
-    SHADER: "shader",
-    TEXTURE: "texture",
-    VIDEO: "video"
-  });
+  static Type = MediaType;
 
   /**
-   * Canonical media-type groups used by format registration.
+   * Canonical media-type groups used by format registration - the shared
+   * runtime-const MediaType object (see Type above).
    */
-  static MediaType = Object.freeze({
-    AUDIO: "audio",
-    DATA: "data",
-    GEOMETRY: "geometry",
-    IMAGE: "image",
-    SHADER: "shader",
-    SCHEMA: "schema",
-    TEXTURE: "texture",
-    VIDEO: "video"
-  });
+  static MediaType = MediaType;
 
   /**
-   * Canonical output-type tokens used by format emit contracts.
+   * Canonical output-type tokens used by format emit contracts. Shared
+   * payload ROLES come from runtime-const PayloadType; the remaining tokens
+   * (cmf/gr2/json/pcm/rgba/shared/objJson) are format-emit names owned by
+   * their formats and enumerated here for discoverability only.
    */
   static OutputType = Object.freeze({
-    AUDIO: "audio",
+    AUDIO: PayloadType.AUDIO,
     CMF: "cmf",
     GR2: "gr2",
-    IMAGE: "image",
+    IMAGE: PayloadType.IMAGE,
     JSON: "json",
     PCM: "pcm",
-    RAW: "raw",
+    RAW: PayloadType.RAW,
     RGBA: "rgba",
-    SCHEMA: "schema",
-    SHADER: "shader",
+    SCHEMA: PayloadType.SCHEMA,
+    SHADER: PayloadType.SHADER,
     SHARED: "shared",
-    TEXTURE: "texture",
-    VIDEO: "video",
+    TEXTURE: PayloadType.TEXTURE,
+    VIDEO: PayloadType.VIDEO,
     OBJ_JSON: "objJson"
   });
   static type = Object.freeze([]);

package/dist/format/CjsFormat.js.map

@@ -1 +1 @@
-{"version":3,"file":"CjsFormat.js","sources":["../../../src/format/CjsFormat.js"],"sourcesContent":["import { CjsResourceProbe } from \"./CjsResourceProbe.js\";\n\nexport class CjsFormat\n{\n  options = {};\n\n  /**\n   * Convenience factory for simple format helpers.\n   * Keep this lightweight so format classes can stay pure-reader implementations.\n   *\n   * @param {*} input\n   * @param {object} options\n   * @returns {Promise<*>|*}\n   */\n  static read(input, options = null) {\n    const reader = new this(options || {});\n    return reader.Read(input, options || {});\n  }\n\n  /**\n   * Async convenience factory for format readers.\n   *\n   * @param {*} input\n   * @param {object} options\n   * @returns {Promise<*>}\n   */\n  static async readAsync(input, options = null) {\n    const reader = new this(options || {});\n    return reader.ReadAsync(input, options || {});\n  }\n\n  /**\n   * Canonical support probe entrypoint.\n   * Returns a probe report including compressed/raw capability variants when implemented.\n   *\n   * @param {*} input\n   * @param {object} options\n   * @returns {CjsResourceProbe}\n   */\n  static isSupported(input, options = null) {\n    const source = typeof input === \"string\" ? \"path\" : \"buffer\";\n    const formatName = this.name\n      ? this.name.replace(/^Cjs/u, \"\").replace(/Format$/u, \"\").toLowerCase()\n      : \"format\";\n    return CjsResourceProbe.createUnsupported(formatName, \"No probe implementation.\", { source, ...options });\n  }\n\n  /**\n   * Alias for canonical naming.\n   *\n   * @param {*} input\n   * @param {object} options\n   * @returns {CjsResourceProbe}\n   */\n  static inspect(input, options = null) {\n    return this.isSupported(input, options);\n  }\n\n  constructor(options = null) {\n    this.options = { ...(options || {}) };\n  }\n\n  SetValues(values = null) {\n    if (!values || typeof values !== \"object\") {\n      return this;\n    }\n    if (Object.prototype.hasOwnProperty.call(values, \"options\")) {\n      this.options = { ...(values.options || {}) };\n    } else {\n      this.options = { ...this.options, ...values };\n    }\n    return this;\n  }\n\n  GetValues() {\n    return { options: { ...this.options } };\n  }\n\n  Initialize(values = null) {\n    return this.SetValues(values || {});\n  }\n\n  /**\n   * Primary instance read entrypoint for synchronous readers.\n   * Implementations may override with async handling in readAsync only if needed.\n   */\n  Read(input, options = null) {\n    throw new Error(`${this.constructor.name}.Read must be implemented by a format package.`);\n  }\n\n  /**\n   * Primary async read entrypoint for asynchronous readers.\n   * Defaults to sync Read for compatibility.\n   */\n  async ReadAsync(input, options = null) {\n    return this.Read(input, options);\n  }\n\n  /**\n   * Canonical package-family group names.\n   */\n  static Type = Object.freeze({\n    AUDIO: \"audio\",\n    DATA: \"data\",\n    GEOMETRY: \"geometry\",\n    IMAGE: \"image\",\n    SCHEMA: \"schema\",\n    SHADER: \"shader\",\n    TEXTURE: \"texture\",\n    VIDEO: \"video\"\n  });\n\n  /**\n   * Canonical media-type groups used by format registration.\n   */\n  static MediaType = Object.freeze({\n    AUDIO: \"audio\",\n    DATA: \"data\",\n    GEOMETRY: \"geometry\",\n    IMAGE: \"image\",\n    SHADER: \"shader\",\n    SCHEMA: \"schema\",\n    TEXTURE: \"texture\",\n    VIDEO: \"video\"\n  });\n\n  /**\n   * Canonical output-type tokens used by format emit contracts.\n   */\n  static OutputType = Object.freeze({\n    AUDIO: \"audio\",\n    CMF: \"cmf\",\n    GR2: \"gr2\",\n    IMAGE: \"image\",\n    JSON: \"json\",\n    PCM: \"pcm\",\n    RAW: \"raw\",\n    RGBA: \"rgba\",\n    SCHEMA: \"schema\",\n    SHADER: \"shader\",\n    SHARED: \"shared\",\n    TEXTURE: \"texture\",\n    VIDEO: \"video\",\n    OBJ_JSON: \"objJson\"\n  });\n\n  static type = Object.freeze([]);\n  static mediaTypes = Object.freeze([]);\n  static inputTypes = Object.freeze([]);\n  static outputTypes = Object.freeze([]);\n  static debugOutputTypes = Object.freeze([\"json\", \"raw\"]);\n}\n\n/**\n * Shared utility for asserting required format metadata exists.\n */\nexport function ValidateFormatContract(Constructor) {\n  if (!Constructor) {\n    throw new TypeError(\"ValidateFormatContract requires a format class.\");\n  }\n  const hasOutput = Array.isArray(Constructor.outputTypes) && Constructor.outputTypes.length > 0;\n  const hasInput = Array.isArray(Constructor.inputTypes) && Constructor.inputTypes.length > 0;\n  const hasMedia = Array.isArray(Constructor.mediaTypes) && Constructor.mediaTypes.length > 0;\n  const hasType = Array.isArray(Constructor.type) && Constructor.type.length > 0;\n  const hasDebug = Array.isArray(Constructor.debugOutputTypes) && Constructor.debugOutputTypes.length > 0;\n  if (!hasType || !hasMedia || !hasInput || !hasOutput || !hasDebug) {\n    throw new TypeError(`Format contract missing metadata: type:${hasType} mediaTypes:${hasMedia} inputTypes:${hasInput} outputTypes:${hasOutput} debugOutputTypes:${hasDebug}`);\n  }\n}\n"],"names":["CjsFormat","options","read","input","reader","Read","readAsync","ReadAsync","isSupported","source","formatName","name","replace","toLowerCase","CjsResourceProbe","createUnsupported","inspect","constructor","SetValues","values","Object","prototype","hasOwnProperty","call","GetValues","Initialize","Error","Type","freeze","AUDIO","DATA","GEOMETRY","IMAGE","SCHEMA","SHADER","TEXTURE","VIDEO","MediaType","OutputType","CMF","GR2","JSON","PCM","RAW","RGBA","SHARED","OBJ_JSON","type","mediaTypes","inputTypes","outputTypes","debugOutputTypes","ValidateFormatContract","Constructor","TypeError","hasOutput","Array","isArray","length","hasInput","hasMedia","hasType","hasDebug"],"mappings":"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"}
+{"version":3,"file":"CjsFormat.js","sources":["../../../src/format/CjsFormat.js"],"sourcesContent":["import { MediaType, PayloadType } from \"@carbonenginejs/runtime-const/media\";\nimport { CjsResourceProbe } from \"./CjsResourceProbe.js\";\n\nexport class CjsFormat\n{\n  options = {};\n\n  /**\n   * Convenience factory for simple format helpers.\n   * Keep this lightweight so format classes can stay pure-reader implementations.\n   *\n   * @param {*} input\n   * @param {object} options\n   * @returns {Promise<*>|*}\n   */\n  static read(input, options = null) {\n    const reader = new this(options || {});\n    return reader.Read(input, options || {});\n  }\n\n  /**\n   * Async convenience factory for format readers.\n   *\n   * @param {*} input\n   * @param {object} options\n   * @returns {Promise<*>}\n   */\n  static async readAsync(input, options = null) {\n    const reader = new this(options || {});\n    return reader.ReadAsync(input, options || {});\n  }\n\n  /**\n   * Canonical support probe entrypoint.\n   * Returns a probe report including compressed/raw capability variants when implemented.\n   *\n   * @param {*} input\n   * @param {object} options\n   * @returns {CjsResourceProbe}\n   */\n  static isSupported(input, options = null) {\n    const source = typeof input === \"string\" ? \"path\" : \"buffer\";\n    const formatName = this.name\n      ? this.name.replace(/^Cjs/u, \"\").replace(/Format$/u, \"\").toLowerCase()\n      : \"format\";\n    return CjsResourceProbe.createUnsupported(formatName, \"No probe implementation.\", { source, ...options });\n  }\n\n  /**\n   * Alias for canonical naming.\n   *\n   * @param {*} input\n   * @param {object} options\n   * @returns {CjsResourceProbe}\n   */\n  static inspect(input, options = null) {\n    return this.isSupported(input, options);\n  }\n\n  /**\n   * Content-verified type/route resolution (kb §5, optional per format).\n   *\n   * Where inspect()/isSupported() report what the container CLAIMS,\n   * resolveType() performs one bounded asynchronous content check (magic, a\n   * first frame/block, a setup header) and reports what the reader has\n   * evidence it can actually decode. Overrides return a CjsResourceProbe\n   * with `verified: true` and declared/resolved/mismatch evidence in\n   * `metadata`; `preferred` names the resolved decode route. A caller-forced\n   * emit always wins over a resolution, and this base implementation - the\n   * zero-extra-work path for formats without an override - delegates to\n   * isSupported() with `verified` false so an unverified result never\n   * changes a route.\n   *\n   * @param {*} input Bytes (or path where the format supports it).\n   * @param {object|null} options Format options.\n   * @returns {Promise<CjsResourceProbe>} Probe report; content-verified only when overridden.\n   */\n  static async resolveType(input, options = null) {\n    const report = CjsResourceProbe.from(this.isSupported(input, options));\n    report.verified = false;\n    return report;\n  }\n\n  constructor(options = null) {\n    this.options = { ...(options || {}) };\n  }\n\n  SetValues(values = null) {\n    if (!values || typeof values !== \"object\") {\n      return this;\n    }\n    if (Object.prototype.hasOwnProperty.call(values, \"options\")) {\n      this.options = { ...(values.options || {}) };\n    } else {\n      this.options = { ...this.options, ...values };\n    }\n    return this;\n  }\n\n  GetValues() {\n    return { options: { ...this.options } };\n  }\n\n  Initialize(values = null) {\n    return this.SetValues(values || {});\n  }\n\n  /**\n   * Primary instance read entrypoint for synchronous readers.\n   * Implementations may override with async handling in readAsync only if needed.\n   */\n  Read(input, options = null) {\n    throw new Error(`${this.constructor.name}.Read must be implemented by a format package.`);\n  }\n\n  /**\n   * Primary async read entrypoint for asynchronous readers.\n   * Defaults to sync Read for compatibility.\n   */\n  async ReadAsync(input, options = null) {\n    return this.Read(input, options);\n  }\n\n  /**\n   * Canonical package-family group names - the shared vocabulary object from\n   * runtime-const (kb: runtime-const owns cross-package media vocabulary).\n   * Same object identity as `@carbonenginejs/runtime-const/media` MediaType,\n   * so tokens can never drift between packages.\n   */\n  static Type = MediaType;\n\n  /**\n   * Canonical media-type groups used by format registration - the shared\n   * runtime-const MediaType object (see Type above).\n   */\n  static MediaType = MediaType;\n\n  /**\n   * Canonical output-type tokens used by format emit contracts. Shared\n   * payload ROLES come from runtime-const PayloadType; the remaining tokens\n   * (cmf/gr2/json/pcm/rgba/shared/objJson) are format-emit names owned by\n   * their formats and enumerated here for discoverability only.\n   */\n  static OutputType = Object.freeze({\n    AUDIO: PayloadType.AUDIO,\n    CMF: \"cmf\",\n    GR2: \"gr2\",\n    IMAGE: PayloadType.IMAGE,\n    JSON: \"json\",\n    PCM: \"pcm\",\n    RAW: PayloadType.RAW,\n    RGBA: \"rgba\",\n    SCHEMA: PayloadType.SCHEMA,\n    SHADER: PayloadType.SHADER,\n    SHARED: \"shared\",\n    TEXTURE: PayloadType.TEXTURE,\n    VIDEO: PayloadType.VIDEO,\n    OBJ_JSON: \"objJson\"\n  });\n\n  static type = Object.freeze([]);\n  static mediaTypes = Object.freeze([]);\n  static inputTypes = Object.freeze([]);\n  static outputTypes = Object.freeze([]);\n  static debugOutputTypes = Object.freeze([\"json\", \"raw\"]);\n}\n\n/**\n * Shared utility for asserting required format metadata exists.\n */\nexport function ValidateFormatContract(Constructor) {\n  if (!Constructor) {\n    throw new TypeError(\"ValidateFormatContract requires a format class.\");\n  }\n  const hasOutput = Array.isArray(Constructor.outputTypes) && Constructor.outputTypes.length > 0;\n  const hasInput = Array.isArray(Constructor.inputTypes) && Constructor.inputTypes.length > 0;\n  const hasMedia = Array.isArray(Constructor.mediaTypes) && Constructor.mediaTypes.length > 0;\n  const hasType = Array.isArray(Constructor.type) && Constructor.type.length > 0;\n  const hasDebug = Array.isArray(Constructor.debugOutputTypes) && Constructor.debugOutputTypes.length > 0;\n  if (!hasType || !hasMedia || !hasInput || !hasOutput || !hasDebug) {\n    throw new TypeError(`Format contract missing metadata: type:${hasType} mediaTypes:${hasMedia} inputTypes:${hasInput} outputTypes:${hasOutput} debugOutputTypes:${hasDebug}`);\n  }\n}\n"],"names":["CjsFormat","options","read","input","reader","Read","readAsync","ReadAsync","isSupported","source","formatName","name","replace","toLowerCase","CjsResourceProbe","createUnsupported","inspect","resolveType","report","from","verified","constructor","SetValues","values","Object","prototype","hasOwnProperty","call","GetValues","Initialize","Error","Type","MediaType","OutputType","freeze","AUDIO","PayloadType","CMF","GR2","IMAGE","JSON","PCM","RAW","RGBA","SCHEMA","SHADER","SHARED","TEXTURE","VIDEO","OBJ_JSON","type","mediaTypes","inputTypes","outputTypes","debugOutputTypes","ValidateFormatContract","Constructor","TypeError","hasOutput","Array","isArray","length","hasInput","hasMedia","hasType","hasDebug"],"mappings":"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"}

package/dist/format/CjsReader.js

@@ -0,0 +1,18 @@
+/**
+ * Internal base for construction-bound readers.
+ *
+ * A reader instance is created for one source and normally used and dropped.
+ * JavaScript garbage collection reclaims its parser and graph state, so readers
+ * do not require `dispose()` or `clear()` for correctness. This differs from
+ * native Blue readers such as `BlackReader`, whose cleanup releases manually
+ * allocated buffers and refcounted maps. Subclasses retain ownership of their
+ * source-specific state and reset behavior.
+ */
+class CjsReader {
+  constructor(options = {}) {
+    this.options = options;
+  }
+}
+
+export { CjsReader };
+//# sourceMappingURL=CjsReader.js.map

package/dist/format/CjsReader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CjsReader.js","sources":["../../../src/format/CjsReader.js"],"sourcesContent":["/**\n * Internal base for construction-bound readers.\n *\n * A reader instance is created for one source and normally used and dropped.\n * JavaScript garbage collection reclaims its parser and graph state, so readers\n * do not require `dispose()` or `clear()` for correctness. This differs from\n * native Blue readers such as `BlackReader`, whose cleanup releases manually\n * allocated buffers and refcounted maps. Subclasses retain ownership of their\n * source-specific state and reset behavior.\n */\nexport class CjsReader\n{\n    constructor(options = {})\n    {\n        this.options = options;\n    }\n}\n\nexport default CjsReader;\n"],"names":["CjsReader","constructor","options"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,MAAMA,SAAS,CACtB;AACIC,EAAAA,WAAWA,CAACC,OAAO,GAAG,EAAE,EACxB;IACI,IAAI,CAACA,OAAO,GAAGA,OAAO;AAC1B,EAAA;AACJ;;;;"}

package/dist/format/CjsResourceProbe.js

@@ -2,7 +2,7 @@ import { applyDecs2311 as _applyDecs2311 } from '../_virtual/_rollupPluginBabelH
 import { CjsModel } from '@carbonenginejs/core-types/model';
 import { io, type } from '@carbonenginejs/core-types/schema';
 
-let _initClass, _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;
+let _initClass, _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;
 
 /**
  * Standard probe report for resource formats and a reusable base for format-specific probes.
@@ -19,17 +19,25 @@ let _CjsResourceProbe;
 class CjsResourceProbe extends CjsModel {
   static {
     ({
-      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],
+      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: [_CjsResourceProbe, _initClass]
     } = _applyDecs2311(this, [type.define({
       className: "CjsResourceProbe",
       family: "resource"
-    })], [[[io, io.persist, type, type.string], 16, "format"], [[io, io.persist, type, type.string], 16, "source"], [[io, io.persist, type, type.string], 16, "supported"], [[io, io.persist, type, type.float64], 16, "confidence"], [[io, io.persist, type, type.string], 16, "preferred"], [[io, io.persist, type, type.string], 16, "reason"], [[io, io.persist, type, type.unknown], 16, "metadata"], [[io, io.persist, type, type.unknown], 16, "variant"], [[io, io.persist, void 0, type.list("unknown")], 16, "variants"], [[io, io.persist, void 0, type.list("string")], 16, "warnings"], [[io, io.persist, void 0, type.list("string")], 16, "errors"]], 0, void 0, CjsModel));
+    })], [[[io, io.persist, type, type.string], 16, "format"], [[io, io.persist, type, type.string], 16, "source"], [[io, io.persist, type, type.string], 16, "supported"], [[io, io.persist, type, type.boolean], 16, "verified"], [[io, io.persist, type, type.float64], 16, "confidence"], [[io, io.persist, type, type.string], 16, "preferred"], [[io, io.persist, type, type.string], 16, "reason"], [[io, io.persist, type, type.unknown], 16, "metadata"], [[io, io.persist, type, type.unknown], 16, "variant"], [[io, io.persist, void 0, type.list("unknown")], 16, "variants"], [[io, io.persist, void 0, type.list("string")], 16, "warnings"], [[io, io.persist, void 0, type.list("string")], 16, "errors"]], 0, void 0, CjsModel));
   }
   format = _init_format(this, "");
   source = (_init_extra_format(this), _init_source(this, ""));
   supported = (_init_extra_source(this), _init_supported(this, "none"));
-  confidence = (_init_extra_supported(this), _init_confidence(this, 0));
+
+  /**
+   * True when the report's variant flags are CONTENT-verified (a bounded
+   * resolveType() check ran), false when they are declaration-derived
+   * (inspect/isSupported). Declared/resolved/mismatch evidence rides in
+   * `metadata` per the kb §5 content-verified type resolution contract.
+   */
+  verified = (_init_extra_supported(this), _init_verified(this, false));
+  confidence = (_init_extra_verified(this), _init_confidence(this, 0));
   preferred = (_init_extra_confidence(this), _init_preferred(this, ""));
   reason = (_init_extra_preferred(this), _init_reason(this, ""));
   metadata = (_init_extra_reason(this), _init_metadata(this, null));