@carbonenginejs/runtime-resource 0.8.0 → 0.9.0

package/dist/formats/red/core/CjsRedReader.js

@@ -1,194 +1,194 @@
-import { CjsBlueReader } from '../../../format/CjsBlueReader.js';
-import { parseRed, isTypedTable, decodeTypedTable, isStrippedKey } from './redGraph.js';
-
-/**
- * Reads a Red (YAML) object graph.
- *
- * The graph is type-discriminated (`type:` per node) and self-referential
- * (YAML anchors/aliases share object identities). This reader walks it into
- * one of three shapes, sharing repeated nodes and always stripping
- * authoring-tool keys (double-underscore prefixed).
- */
-class CjsRedReader extends CjsBlueReader {
-  constructor(input, options = {}) {
-    super(options, {
-      includePayloadValuesField: true,
-      validatePayloadReservedFields: true
-    });
-    this.root = parseRed(input, options);
-    this.mode = "payload";
-    this.ResetReadState();
-  }
-  ResetReadState() {
-    super.ResetBlueReadState();
-    this.refs = new Map(); // source object -> hydrated target
-    this.ids = new Map(); // source object -> reference id
-    this.payloadReferenceCounts = new WeakMap();
-    this.nextId = this.options.firstId ?? 1;
-  }
-  Inspect() {
-    const typeCounts = {};
-    const seen = new Set();
-    let nodeCount = 0;
-    const visit = node => {
-      if (!node || typeof node !== "object") return;
-      if (seen.has(node)) return;
-      seen.add(node);
-      if (Array.isArray(node)) {
-        node.forEach(visit);
-        return;
-      }
-      if (isTypedTable(node)) return;
-      if (typeof node.type === "string") {
-        nodeCount++;
-        typeCounts[node.type] = (typeCounts[node.type] || 0) + 1;
-      }
-      for (const key of Object.keys(node)) {
-        if (isStrippedKey(key)) continue;
-        visit(node[key]);
-      }
-    };
-    visit(this.root);
-    return {
-      format: {
-        id: "red"
-      },
-      root: {
-        type: this.RootType()
-      },
-      nodeCount,
-      typeCounts
-    };
-  }
-  RootType() {
-    return this.root && typeof this.root === "object" && typeof this.root.type === "string" ? this.root.type : null;
-  }
-  Read() {
-    return this.ReadPayload();
-  }
-  ReadPayload() {
-    this.mode = "payload";
-    this.ResetReadState();
-    this.ValidatePayloadConfiguration();
-    this.CountPayloadReferences(this.root);
-    const object = this.Hydrate(this.root);
-    return {
-      comments: this.reports,
-      object
-    };
-  }
-  ReadRuntime() {
-    this.mode = "runtime";
-    this.ResetReadState();
-    const root = this.Hydrate(this.root);
-    this.FinalizeRuntimeInstances();
-    return {
-      root,
-      format: {
-        id: "red"
-      },
-      reports: this.reports
-    };
-  }
-  ReadRaw() {
-    this.mode = "raw";
-    this.ResetReadState();
-    return this.Hydrate(this.root);
-  }
-  Hydrate(node) {
-    if (node && typeof node === "object") {
-      if (this.refs.has(node)) return this.MakeReference(node);
-      if (Array.isArray(node)) return this.HydrateSequence(node, node);
-      if (isTypedTable(node)) return this.HydrateSequence(node, decodeTypedTable(node));
-      const type = typeof node.type === "string" ? node.type : null;
-      const target = this.CreateTarget(type);
-      this.refs.set(node, target);
-      const values = {};
-      for (const key of Object.keys(node)) {
-        if (isStrippedKey(key)) continue;
-        if (key === "type" && this.mode !== "raw") continue;
-        values[key] = this.Hydrate(node[key]);
-      }
-      this.AssignValues(target, values, type);
-      return target;
-    }
-    return node;
-  }
-  HydrateSequence(source, items) {
-    const values = [];
-    const shouldWrap = this.mode === "payload" && this.IsRepeatedPayloadNode(source) && Boolean(this.GetPayloadIdField());
-    const target = shouldWrap ? {
-      [this.GetPayloadValuesField()]: values
-    } : values;
-    this.refs.set(source, target);
-    for (const item of items) values.push(this.Hydrate(item));
-    return target;
-  }
-  CountPayloadReferences(root) {
-    const traversed = new WeakSet();
-    const visit = node => {
-      if (!node || typeof node !== "object") return;
-      this.payloadReferenceCounts.set(node, (this.payloadReferenceCounts.get(node) || 0) + 1);
-      if (traversed.has(node)) return;
-      traversed.add(node);
-      if (Array.isArray(node)) {
-        for (const item of node) visit(item);
-        return;
-      }
-      if (isTypedTable(node)) {
-        for (const row of decodeTypedTable(node)) visit(row);
-        return;
-      }
-      for (const key of Object.keys(node)) {
-        if (isStrippedKey(key) || key === "type") continue;
-        visit(node[key]);
-      }
-    };
-    visit(root);
-  }
-  IsRepeatedPayloadNode(node) {
-    return (this.payloadReferenceCounts.get(node) || 0) > 1;
-  }
-  CreateTarget(type) {
-    if (this.mode === "runtime") {
-      if (!type) return {};
-      return this.CreateRuntimeTarget(type);
-    }
-    if (this.mode === "raw") return {};
-    return this.CreatePayloadTarget(type);
-  }
-  AssignValues(target, values, type) {
-    if (this.mode === "runtime") {
-      // Untyped maps are plain value objects inside a typed Red graph and
-      // do not participate in the runtime class lifecycle.
-      if (!type) {
-        Object.assign(target, values);
-        return;
-      }
-      this.ApplyRuntimeValues(target, values, type);
-      return;
-    }
-    if (this.mode === "payload") {
-      this.AssignPayloadValues(target, values);
-      return;
-    }
-    Object.assign(target, values);
-  }
-  MakeReference(node) {
-    const target = this.refs.get(node);
-    if (this.mode !== "payload") return target;
-    const id = this.IdFor(node);
-    return this.CreatePayloadReference(target, id);
-  }
-  IdFor(node) {
-    let id = this.ids.get(node);
-    if (id === undefined) {
-      id = this.nextId++;
-      this.ids.set(node, id);
-    }
-    return id;
-  }
-}
-
-export { CjsRedReader };
-//# sourceMappingURL=CjsRedReader.js.map
+import { CjsBlueReader } from '../../../format/CjsBlueReader.js';
+import { parseRed, isTypedTable, decodeTypedTable, isStrippedKey } from './redGraph.js';
+
+/**
+ * Reads a Red (YAML) object graph.
+ *
+ * The graph is type-discriminated (`type:` per node) and self-referential
+ * (YAML anchors/aliases share object identities). This reader walks it into
+ * one of three shapes, sharing repeated nodes and always stripping
+ * authoring-tool keys (double-underscore prefixed).
+ */
+class CjsRedReader extends CjsBlueReader {
+  constructor(input, options = {}) {
+    super(options, {
+      includePayloadValuesField: true,
+      validatePayloadReservedFields: true
+    });
+    this.root = parseRed(input, options);
+    this.mode = "payload";
+    this.ResetReadState();
+  }
+  ResetReadState() {
+    super.ResetBlueReadState();
+    this.refs = new Map(); // source object -> hydrated target
+    this.ids = new Map(); // source object -> reference id
+    this.payloadReferenceCounts = new WeakMap();
+    this.nextId = this.options.firstId ?? 1;
+  }
+  Inspect() {
+    const typeCounts = {};
+    const seen = new Set();
+    let nodeCount = 0;
+    const visit = node => {
+      if (!node || typeof node !== "object") return;
+      if (seen.has(node)) return;
+      seen.add(node);
+      if (Array.isArray(node)) {
+        node.forEach(visit);
+        return;
+      }
+      if (isTypedTable(node)) return;
+      if (typeof node.type === "string") {
+        nodeCount++;
+        typeCounts[node.type] = (typeCounts[node.type] || 0) + 1;
+      }
+      for (const key of Object.keys(node)) {
+        if (isStrippedKey(key)) continue;
+        visit(node[key]);
+      }
+    };
+    visit(this.root);
+    return {
+      format: {
+        id: "red"
+      },
+      root: {
+        type: this.RootType()
+      },
+      nodeCount,
+      typeCounts
+    };
+  }
+  RootType() {
+    return this.root && typeof this.root === "object" && typeof this.root.type === "string" ? this.root.type : null;
+  }
+  Read() {
+    return this.ReadPayload();
+  }
+  ReadPayload() {
+    this.mode = "payload";
+    this.ResetReadState();
+    this.ValidatePayloadConfiguration();
+    this.CountPayloadReferences(this.root);
+    const object = this.Hydrate(this.root);
+    return {
+      comments: this.reports,
+      object
+    };
+  }
+  ReadRuntime() {
+    this.mode = "runtime";
+    this.ResetReadState();
+    const root = this.Hydrate(this.root);
+    this.FinalizeRuntimeInstances();
+    return {
+      root,
+      format: {
+        id: "red"
+      },
+      reports: this.reports
+    };
+  }
+  ReadRaw() {
+    this.mode = "raw";
+    this.ResetReadState();
+    return this.Hydrate(this.root);
+  }
+  Hydrate(node) {
+    if (node && typeof node === "object") {
+      if (this.refs.has(node)) return this.MakeReference(node);
+      if (Array.isArray(node)) return this.HydrateSequence(node, node);
+      if (isTypedTable(node)) return this.HydrateSequence(node, decodeTypedTable(node));
+      const type = typeof node.type === "string" ? node.type : null;
+      const target = this.CreateTarget(type);
+      this.refs.set(node, target);
+      const values = {};
+      for (const key of Object.keys(node)) {
+        if (isStrippedKey(key)) continue;
+        if (key === "type" && this.mode !== "raw") continue;
+        values[key] = this.Hydrate(node[key]);
+      }
+      this.AssignValues(target, values, type);
+      return target;
+    }
+    return node;
+  }
+  HydrateSequence(source, items) {
+    const values = [];
+    const shouldWrap = this.mode === "payload" && this.IsRepeatedPayloadNode(source) && Boolean(this.GetPayloadIdField());
+    const target = shouldWrap ? {
+      [this.GetPayloadValuesField()]: values
+    } : values;
+    this.refs.set(source, target);
+    for (const item of items) values.push(this.Hydrate(item));
+    return target;
+  }
+  CountPayloadReferences(root) {
+    const traversed = new WeakSet();
+    const visit = node => {
+      if (!node || typeof node !== "object") return;
+      this.payloadReferenceCounts.set(node, (this.payloadReferenceCounts.get(node) || 0) + 1);
+      if (traversed.has(node)) return;
+      traversed.add(node);
+      if (Array.isArray(node)) {
+        for (const item of node) visit(item);
+        return;
+      }
+      if (isTypedTable(node)) {
+        for (const row of decodeTypedTable(node)) visit(row);
+        return;
+      }
+      for (const key of Object.keys(node)) {
+        if (isStrippedKey(key) || key === "type") continue;
+        visit(node[key]);
+      }
+    };
+    visit(root);
+  }
+  IsRepeatedPayloadNode(node) {
+    return (this.payloadReferenceCounts.get(node) || 0) > 1;
+  }
+  CreateTarget(type) {
+    if (this.mode === "runtime") {
+      if (!type) return {};
+      return this.CreateRuntimeTarget(type);
+    }
+    if (this.mode === "raw") return {};
+    return this.CreatePayloadTarget(type);
+  }
+  AssignValues(target, values, type) {
+    if (this.mode === "runtime") {
+      // Untyped maps are plain value objects inside a typed Red graph and
+      // do not participate in the runtime class lifecycle.
+      if (!type) {
+        Object.assign(target, values);
+        return;
+      }
+      this.ApplyRuntimeValues(target, values, type);
+      return;
+    }
+    if (this.mode === "payload") {
+      this.AssignPayloadValues(target, values);
+      return;
+    }
+    Object.assign(target, values);
+  }
+  MakeReference(node) {
+    const target = this.refs.get(node);
+    if (this.mode !== "payload") return target;
+    const id = this.IdFor(node);
+    return this.CreatePayloadReference(target, id);
+  }
+  IdFor(node) {
+    let id = this.ids.get(node);
+    if (id === undefined) {
+      id = this.nextId++;
+      this.ids.set(node, id);
+    }
+    return id;
+  }
+}
+
+export { CjsRedReader };
+//# sourceMappingURL=CjsRedReader.js.map

package/dist/formats/red/core/blackDefinitions.js

@@ -1,3 +1,3 @@
-export { classes, classes as default, enums, generatedAt, schema, version } from '../../black/core/blackDefinitions.js';
-export { default as definitions } from '../../black/core/black-schema-v1-2026-07-11.json.js';
-//# sourceMappingURL=blackDefinitions.js.map
+export { classes, classes as default, enums, generatedAt, schema, version } from '../../black/core/blackDefinitions.js';
+export { default as definitions } from '../../black/core/black-schema-v1-2026-07-11.json.js';
+//# sourceMappingURL=blackDefinitions.js.map

package/dist/formats/red/core/helpers.js

@@ -1,139 +1,139 @@
-const OUTPUT_JSON = "json";
-const OUTPUT_PAYLOAD = "payload";
-const OUTPUT_RUNTIME = "runtime";
-const OUTPUT_RAW = "raw";
-const DEFAULT_VALUES = Object.freeze({
-  emit: OUTPUT_JSON,
-  schema: null,
-  registry: null,
-  firstId: 1,
-  parse: null,
-  adapter: null,
-  adapters: null,
-  payloadTypeField: "_type",
-  payloadIdField: "_id",
-  payloadReferenceField: "_reference",
-  payloadValuesField: "_values",
-  classes: Object.freeze({})
-});
-const OPTION_KEYS = new Set(Object.keys(DEFAULT_VALUES));
-function hasOwn(value, key) {
-  return Object.prototype.hasOwnProperty.call(value, key);
-}
-function normalizeEmit(emit, readerName) {
-  if (emit === undefined || emit === OUTPUT_JSON) return OUTPUT_JSON;
-  if (emit === OUTPUT_PAYLOAD) return OUTPUT_PAYLOAD;
-  if (emit === OUTPUT_RUNTIME) return OUTPUT_RUNTIME;
-  if (emit === OUTPUT_RAW) return OUTPUT_RAW;
-  throw new Error(`${readerName} unknown emit value "${emit}"`);
-}
-function assertKnownOptions(options, readerName) {
-  for (const key of Object.keys(options)) {
-    if (!OPTION_KEYS.has(key)) {
-      throw new TypeError(`${readerName} unknown option "${key}"`);
-    }
-  }
-}
-function classMap(values) {
-  return values && values.classes ? values.classes : {};
-}
-function cloneValues(values) {
-  return {
-    emit: values.emit,
-    schema: values.schema ?? null,
-    registry: values.registry ?? null,
-    firstId: values.firstId ?? 1,
-    parse: values.parse ?? null,
-    adapter: values.adapter ?? null,
-    adapters: values.adapters ?? null,
-    payloadTypeField: values.payloadTypeField,
-    payloadIdField: values.payloadIdField,
-    payloadReferenceField: values.payloadReferenceField,
-    payloadValuesField: values.payloadValuesField,
-    classes: {
-      ...classMap(values)
-    }
-  };
-}
-function validateClassKey(classKeys, key, readerName) {
-  if (typeof key !== "string" || !key) {
-    throw new Error(`${readerName} class type must be a non-empty string`);
-  }
-}
-function validateClass(classKeys, type, Class, readerName) {
-  validateClassKey(classKeys, type, readerName);
-  if (typeof Class !== "function") {
-    throw new TypeError(`${readerName} class "${type}" must be a constructor`);
-  }
-}
-function mergeClasses(values, classes, classKeys, readerName) {
-  if (!classes || typeof classes !== "object") {
-    throw new TypeError(`${readerName} classes option must be an object`);
-  }
-  const next = {
-    ...values.classes
-  };
-  for (const [type, Class] of Object.entries(classes)) {
-    validateClass(classKeys, type, Class, readerName);
-    next[type] = Class;
-  }
-  values.classes = next;
-}
-function normalizeValues(base, options, classKeys, readerName) {
-  if (!options || typeof options !== "object") {
-    throw new TypeError(`${readerName} options must be an object`);
-  }
-  assertKnownOptions(options, readerName);
-  const values = cloneValues(base);
-  if (hasOwn(options, "emit")) values.emit = normalizeEmit(options.emit, readerName);
-  if (hasOwn(options, "schema")) values.schema = options.schema ?? null;
-  if (hasOwn(options, "registry")) values.registry = options.registry ?? null;
-  if (hasOwn(options, "firstId")) values.firstId = options.firstId ?? 1;
-  if (hasOwn(options, "parse")) {
-    if (options.parse !== null && options.parse !== undefined && typeof options.parse !== "function") {
-      throw new TypeError(`${readerName} parse option must be a function`);
-    }
-    values.parse = options.parse ?? null;
-  }
-  if (hasOwn(options, "adapter")) values.adapter = options.adapter ?? null;
-  if (hasOwn(options, "adapters")) values.adapters = options.adapters ?? null;
-  if (hasOwn(options, "payloadTypeField")) values.payloadTypeField = options.payloadTypeField;
-  if (hasOwn(options, "payloadIdField")) values.payloadIdField = options.payloadIdField;
-  if (hasOwn(options, "payloadReferenceField")) values.payloadReferenceField = options.payloadReferenceField;
-  if (hasOwn(options, "payloadValuesField")) values.payloadValuesField = options.payloadValuesField;
-  if (hasOwn(options, "classes")) mergeClasses(values, options.classes, classKeys, readerName);
-  return values;
-}
-function copyReaderOptions(values) {
-  const {
-    emit: _emit,
-    schema: _schema,
-    classes: _classes,
-    ...readerOptions
-  } = values;
-  return readerOptions;
-}
-function toJsonValue(value, seen = new WeakSet()) {
-  if (value === null || typeof value !== "object") return value;
-  if (ArrayBuffer.isView(value)) return Array.from(value, item => toJsonValue(item, seen));
-  if (Array.isArray(value)) return value.map(item => toJsonValue(item, seen));
-  if (seen.has(value)) {
-    throw new TypeError("Reader.toJSON cannot convert circular data");
-  }
-  if (typeof value.toJSON === "function") {
-    seen.add(value);
-    const json = toJsonValue(value.toJSON(), seen);
-    seen.delete(value);
-    return json;
-  }
-  seen.add(value);
-  const out = {};
-  for (const key of Object.keys(value)) {
-    out[key] = toJsonValue(value[key], seen);
-  }
-  seen.delete(value);
-  return out;
-}
-
-export { DEFAULT_VALUES, OUTPUT_JSON, OUTPUT_PAYLOAD, OUTPUT_RAW, OUTPUT_RUNTIME, copyReaderOptions, normalizeValues, toJsonValue, validateClass, validateClassKey };
-//# sourceMappingURL=helpers.js.map
+const OUTPUT_JSON = "json";
+const OUTPUT_PAYLOAD = "payload";
+const OUTPUT_RUNTIME = "runtime";
+const OUTPUT_RAW = "raw";
+const DEFAULT_VALUES = Object.freeze({
+  emit: OUTPUT_JSON,
+  schema: null,
+  registry: null,
+  firstId: 1,
+  parse: null,
+  adapter: null,
+  adapters: null,
+  payloadTypeField: "_type",
+  payloadIdField: "_id",
+  payloadReferenceField: "_reference",
+  payloadValuesField: "_values",
+  classes: Object.freeze({})
+});
+const OPTION_KEYS = new Set(Object.keys(DEFAULT_VALUES));
+function hasOwn(value, key) {
+  return Object.prototype.hasOwnProperty.call(value, key);
+}
+function normalizeEmit(emit, readerName) {
+  if (emit === undefined || emit === OUTPUT_JSON) return OUTPUT_JSON;
+  if (emit === OUTPUT_PAYLOAD) return OUTPUT_PAYLOAD;
+  if (emit === OUTPUT_RUNTIME) return OUTPUT_RUNTIME;
+  if (emit === OUTPUT_RAW) return OUTPUT_RAW;
+  throw new Error(`${readerName} unknown emit value "${emit}"`);
+}
+function assertKnownOptions(options, readerName) {
+  for (const key of Object.keys(options)) {
+    if (!OPTION_KEYS.has(key)) {
+      throw new TypeError(`${readerName} unknown option "${key}"`);
+    }
+  }
+}
+function classMap(values) {
+  return values && values.classes ? values.classes : {};
+}
+function cloneValues(values) {
+  return {
+    emit: values.emit,
+    schema: values.schema ?? null,
+    registry: values.registry ?? null,
+    firstId: values.firstId ?? 1,
+    parse: values.parse ?? null,
+    adapter: values.adapter ?? null,
+    adapters: values.adapters ?? null,
+    payloadTypeField: values.payloadTypeField,
+    payloadIdField: values.payloadIdField,
+    payloadReferenceField: values.payloadReferenceField,
+    payloadValuesField: values.payloadValuesField,
+    classes: {
+      ...classMap(values)
+    }
+  };
+}
+function validateClassKey(classKeys, key, readerName) {
+  if (typeof key !== "string" || !key) {
+    throw new Error(`${readerName} class type must be a non-empty string`);
+  }
+}
+function validateClass(classKeys, type, Class, readerName) {
+  validateClassKey(classKeys, type, readerName);
+  if (typeof Class !== "function") {
+    throw new TypeError(`${readerName} class "${type}" must be a constructor`);
+  }
+}
+function mergeClasses(values, classes, classKeys, readerName) {
+  if (!classes || typeof classes !== "object") {
+    throw new TypeError(`${readerName} classes option must be an object`);
+  }
+  const next = {
+    ...values.classes
+  };
+  for (const [type, Class] of Object.entries(classes)) {
+    validateClass(classKeys, type, Class, readerName);
+    next[type] = Class;
+  }
+  values.classes = next;
+}
+function normalizeValues(base, options, classKeys, readerName) {
+  if (!options || typeof options !== "object") {
+    throw new TypeError(`${readerName} options must be an object`);
+  }
+  assertKnownOptions(options, readerName);
+  const values = cloneValues(base);
+  if (hasOwn(options, "emit")) values.emit = normalizeEmit(options.emit, readerName);
+  if (hasOwn(options, "schema")) values.schema = options.schema ?? null;
+  if (hasOwn(options, "registry")) values.registry = options.registry ?? null;
+  if (hasOwn(options, "firstId")) values.firstId = options.firstId ?? 1;
+  if (hasOwn(options, "parse")) {
+    if (options.parse !== null && options.parse !== undefined && typeof options.parse !== "function") {
+      throw new TypeError(`${readerName} parse option must be a function`);
+    }
+    values.parse = options.parse ?? null;
+  }
+  if (hasOwn(options, "adapter")) values.adapter = options.adapter ?? null;
+  if (hasOwn(options, "adapters")) values.adapters = options.adapters ?? null;
+  if (hasOwn(options, "payloadTypeField")) values.payloadTypeField = options.payloadTypeField;
+  if (hasOwn(options, "payloadIdField")) values.payloadIdField = options.payloadIdField;
+  if (hasOwn(options, "payloadReferenceField")) values.payloadReferenceField = options.payloadReferenceField;
+  if (hasOwn(options, "payloadValuesField")) values.payloadValuesField = options.payloadValuesField;
+  if (hasOwn(options, "classes")) mergeClasses(values, options.classes, classKeys, readerName);
+  return values;
+}
+function copyReaderOptions(values) {
+  const {
+    emit: _emit,
+    schema: _schema,
+    classes: _classes,
+    ...readerOptions
+  } = values;
+  return readerOptions;
+}
+function toJsonValue(value, seen = new WeakSet()) {
+  if (value === null || typeof value !== "object") return value;
+  if (ArrayBuffer.isView(value)) return Array.from(value, item => toJsonValue(item, seen));
+  if (Array.isArray(value)) return value.map(item => toJsonValue(item, seen));
+  if (seen.has(value)) {
+    throw new TypeError("Reader.toJSON cannot convert circular data");
+  }
+  if (typeof value.toJSON === "function") {
+    seen.add(value);
+    const json = toJsonValue(value.toJSON(), seen);
+    seen.delete(value);
+    return json;
+  }
+  seen.add(value);
+  const out = {};
+  for (const key of Object.keys(value)) {
+    out[key] = toJsonValue(value[key], seen);
+  }
+  seen.delete(value);
+  return out;
+}
+
+export { DEFAULT_VALUES, OUTPUT_JSON, OUTPUT_PAYLOAD, OUTPUT_RAW, OUTPUT_RUNTIME, copyReaderOptions, normalizeValues, toJsonValue, validateClass, validateClassKey };
+//# sourceMappingURL=helpers.js.map