@carbonenginejs/runtime-resource 0.13.0 → 0.15.0

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

@@ -1,246 +1,246 @@
-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 {
-  /** Creates a CjsRedReader over caller-provided RED bytes and reader options. */
-  constructor(input, options = {}) {
-    super(options, {
-      includePayloadValuesField: true,
-      validatePayloadReservedFields: true
-    });
-    this.root = parseRed(input, options);
-    this.mode = "payload";
-    this.ResetReadState();
-  }
-
-  /** Clears read state before reusing the current RED object-graph reader. */
-  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;
-  }
-
-  /**
-   * Returns structural metadata without materializing the decoded payload for
-   * the RED object-graph reader.
-   */
-  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
-    };
-  }
-
-  /**
-   * Returns the runtime type name declared by the root RED node for the RED
-   * object-graph reader.
-   */
-  RootType() {
-    return this.root && typeof this.root === "object" && typeof this.root.type === "string" ? this.root.type : null;
-  }
-
-  /**
-   * Reads the primary public payload representation from the supplied input
-   * for the RED object-graph reader.
-   */
-  Read() {
-    return this.ReadPayload();
-  }
-
-  /** Reads payload from the current RED object-graph reader. */
-  ReadPayload() {
-    this.mode = "payload";
-    this.ResetReadState();
-    this.ValidatePayloadConfiguration();
-    this.CountPayloadReferences(this.root);
-    const object = this.Hydrate(this.root);
-    return {
-      comments: this.reports,
-      object
-    };
-  }
-
-  /** Reads runtime from the current RED object-graph reader. */
-  ReadRuntime() {
-    this.mode = "runtime";
-    this.ResetReadState();
-    const root = this.Hydrate(this.root);
-    this.FinalizeRuntimeInstances();
-    return {
-      root,
-      format: {
-        id: "red"
-      },
-      reports: this.reports
-    };
-  }
-
-  /** Reads raw from the current RED object-graph reader. */
-  ReadRaw() {
-    this.mode = "raw";
-    this.ResetReadState();
-    return this.Hydrate(this.root);
-  }
-
-  /** Hydrates the supplied payload into the current RED object-graph reader. */
-  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;
-  }
-
-  /** Hydrates sequence into the current RED object-graph reader. */
-  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;
-  }
-
-  /**
-   * Counts payload references reachable through the current RED object-graph
-   * reader.
-   */
-  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);
-  }
-
-  /**
-   * Reports whether the current RED object-graph reader satisfies repeated
-   * payload node.
-   */
-  IsRepeatedPayloadNode(node) {
-    return (this.payloadReferenceCounts.get(node) || 0) > 1;
-  }
-
-  /** Creates target for the current RED object-graph reader. */
-  CreateTarget(type) {
-    if (this.mode === "runtime") {
-      if (!type) return {};
-      return this.CreateRuntimeTarget(type);
-    }
-    if (this.mode === "raw") return {};
-    return this.CreatePayloadTarget(type);
-  }
-
-  /**
-   * Assigns values while preserving the current RED object-graph reader
-   * contract.
-   */
-  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);
-  }
-
-  /** Creates reference for the current RED object-graph reader. */
-  MakeReference(node) {
-    const target = this.refs.get(node);
-    if (this.mode !== "payload") return target;
-    const id = this.IdFor(node);
-    return this.CreatePayloadReference(target, id);
-  }
-
-  /**
-   * Allocates or returns the stable reference identifier for a payload object
-   * for the RED object-graph reader.
-   */
-  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 {
+  /** Creates a CjsRedReader over caller-provided RED bytes and reader options. */
+  constructor(input, options = {}) {
+    super(options, {
+      includePayloadValuesField: true,
+      validatePayloadReservedFields: true
+    });
+    this.root = parseRed(input, options);
+    this.mode = "payload";
+    this.ResetReadState();
+  }
+
+  /** Clears read state before reusing the current RED object-graph reader. */
+  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;
+  }
+
+  /**
+   * Returns structural metadata without materializing the decoded payload for
+   * the RED object-graph reader.
+   */
+  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
+    };
+  }
+
+  /**
+   * Returns the runtime type name declared by the root RED node for the RED
+   * object-graph reader.
+   */
+  RootType() {
+    return this.root && typeof this.root === "object" && typeof this.root.type === "string" ? this.root.type : null;
+  }
+
+  /**
+   * Reads the primary public payload representation from the supplied input
+   * for the RED object-graph reader.
+   */
+  Read() {
+    return this.ReadPayload();
+  }
+
+  /** Reads payload from the current RED object-graph reader. */
+  ReadPayload() {
+    this.mode = "payload";
+    this.ResetReadState();
+    this.ValidatePayloadConfiguration();
+    this.CountPayloadReferences(this.root);
+    const object = this.Hydrate(this.root);
+    return {
+      comments: this.reports,
+      object
+    };
+  }
+
+  /** Reads runtime from the current RED object-graph reader. */
+  ReadRuntime() {
+    this.mode = "runtime";
+    this.ResetReadState();
+    const root = this.Hydrate(this.root);
+    this.FinalizeRuntimeInstances();
+    return {
+      root,
+      format: {
+        id: "red"
+      },
+      reports: this.reports
+    };
+  }
+
+  /** Reads raw from the current RED object-graph reader. */
+  ReadRaw() {
+    this.mode = "raw";
+    this.ResetReadState();
+    return this.Hydrate(this.root);
+  }
+
+  /** Hydrates the supplied payload into the current RED object-graph reader. */
+  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;
+  }
+
+  /** Hydrates sequence into the current RED object-graph reader. */
+  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;
+  }
+
+  /**
+   * Counts payload references reachable through the current RED object-graph
+   * reader.
+   */
+  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);
+  }
+
+  /**
+   * Reports whether the current RED object-graph reader satisfies repeated
+   * payload node.
+   */
+  IsRepeatedPayloadNode(node) {
+    return (this.payloadReferenceCounts.get(node) || 0) > 1;
+  }
+
+  /** Creates target for the current RED object-graph reader. */
+  CreateTarget(type) {
+    if (this.mode === "runtime") {
+      if (!type) return {};
+      return this.CreateRuntimeTarget(type);
+    }
+    if (this.mode === "raw") return {};
+    return this.CreatePayloadTarget(type);
+  }
+
+  /**
+   * Assigns values while preserving the current RED object-graph reader
+   * contract.
+   */
+  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);
+  }
+
+  /** Creates reference for the current RED object-graph reader. */
+  MakeReference(node) {
+    const target = this.refs.get(node);
+    if (this.mode !== "payload") return target;
+    const id = this.IdFor(node);
+    return this.CreatePayloadReference(target, id);
+  }
+
+  /**
+   * Allocates or returns the stable reference identifier for a payload object
+   * for the RED object-graph reader.
+   */
+  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-23.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-23.json.js';
+//# sourceMappingURL=blackDefinitions.js.map