@carbonenginejs/runtime-resource 0.1.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"CjsRedReader.js","sources":["../../../../../src/formats/red/core/CjsRedReader.js"],"sourcesContent":["import { resolveHydrationAdapter } from \"@carbonenginejs/core-types/hydration\";\n\nimport { parseRed, isTypedTable, decodeTypedTable, isStrippedKey } from \"./redGraph.js\";\n\n/**\n * Reads a Red (YAML) object graph.\n *\n * The graph is type-discriminated (`type:` per node) and self-referential\n * (YAML anchors/aliases share object identities). This reader walks it into\n * one of three shapes, sharing repeated nodes and always stripping\n * authoring-tool keys (double-underscore prefixed).\n */\nexport class CjsRedReader\n{\n    constructor(input, options = {})\n    {\n        this.options = { ...options };\n        this.root = parseRed(input, options);\n        this.adapter = resolveHydrationAdapter(options);\n        this.hydrationOptions = {\n            ...options,\n            markDirty: false,\n            skipUpdate: true,\n            skipEvents: true\n        };\n        this.mode = \"payload\";\n        this.ResetReadState();\n    }\n\n    ResetReadState()\n    {\n        this.refs = new Map();          // source object -> hydrated target\n        this.ids = new Map();           // source object -> reference id\n        this.nextId = this.options.firstId || 1;\n        this.runtimeInstances = [];\n        this.reports = [];\n    }\n\n    Inspect()\n    {\n        const typeCounts = {};\n        const seen = new Set();\n        let nodeCount = 0;\n\n        const visit = (node) =>\n        {\n            if (Array.isArray(node)) { node.forEach(visit); return; }\n            if (isTypedTable(node)) return;\n            if (!node || typeof node !== \"object\") return;\n            if (seen.has(node)) return;\n            seen.add(node);\n\n            if (typeof node.type === \"string\")\n            {\n                nodeCount++;\n                typeCounts[node.type] = (typeCounts[node.type] || 0) + 1;\n            }\n\n            for (const key of Object.keys(node))\n            {\n                if (isStrippedKey(key)) continue;\n                visit(node[key]);\n            }\n        };\n\n        visit(this.root);\n\n        return {\n            format: { id: \"red\" },\n            root: { type: this.RootType() },\n            nodeCount,\n            typeCounts\n        };\n    }\n\n    RootType()\n    {\n        return this.root && typeof this.root === \"object\" && typeof this.root.type === \"string\"\n            ? this.root.type\n            : null;\n    }\n\n    Read()\n    {\n        return this.ReadPayload();\n    }\n\n    ReadPayload()\n    {\n        this.mode = \"payload\";\n        this.ResetReadState();\n        const object = this.Hydrate(this.root);\n        return { comments: this.reports, object };\n    }\n\n    ReadRuntime()\n    {\n        this.mode = \"runtime\";\n        this.ResetReadState();\n        const root = this.Hydrate(this.root);\n\n        // Phase 3: whole graph built and references resolved - finalize once\n        // per instance, children before parents (completion order).\n        for (const record of this.runtimeInstances)\n        {\n            this.adapter.finalize(record.instance, { kind: record.type });\n        }\n\n        return { root, format: { id: \"red\" }, reports: this.reports };\n    }\n\n    ReadRaw()\n    {\n        this.mode = \"raw\";\n        this.ResetReadState();\n        return this.Hydrate(this.root);\n    }\n\n    Hydrate(node)\n    {\n        if (Array.isArray(node)) return node.map(item => this.Hydrate(item));\n        if (isTypedTable(node)) return decodeTypedTable(node).map(row => this.Hydrate(row));\n\n        if (node && typeof node === \"object\")\n        {\n            if (this.refs.has(node)) return this.MakeReference(node);\n\n            const type = typeof node.type === \"string\" ? node.type : null;\n            const target = this.CreateTarget(type);\n            this.refs.set(node, target);\n\n            const values = {};\n            for (const key of Object.keys(node))\n            {\n                if (isStrippedKey(key)) continue;\n                if (key === \"type\" && this.mode !== \"raw\") continue;\n                values[key] = this.Hydrate(node[key]);\n            }\n\n            this.AssignValues(target, values, type);\n            return target;\n        }\n\n        return node;\n    }\n\n    CreateTarget(type)\n    {\n        if (this.mode === \"runtime\")\n        {\n            const built = this.adapter.construct(type, { kind: type, options: this.options });\n            if (built !== undefined) return built;\n\n            const ClassConstructor = this.ResolveClass(type);\n            if (ClassConstructor) return new ClassConstructor();\n\n            return { _sourceClassName: type || null };\n        }\n\n        if (this.mode === \"raw\") return {};\n\n        const typeField = this.GetPayloadField(\"payloadTypeField\", \"_type\");\n        return typeField && type ? { [typeField]: type } : {};\n    }\n\n    AssignValues(target, values, type)\n    {\n        if (this.mode === \"runtime\")\n        {\n            // Untyped maps are value objects inside a typed Red graph. They do\n            // not participate in the runtime class lifecycle.\n            if (!type)\n            {\n                Object.assign(target, values);\n                return;\n            }\n            this.adapter.applyValues(target, values, { kind: type, options: this.hydrationOptions });\n            this.runtimeInstances.push({ instance: target, type });\n            return;\n        }\n\n        Object.assign(target, values);\n    }\n\n    MakeReference(node)\n    {\n        const target = this.refs.get(node);\n        if (this.mode !== \"payload\") return target;\n\n        const idField = this.GetPayloadField(\"payloadIdField\", \"_id\");\n        const referenceField = this.GetPayloadField(\"payloadReferenceField\", \"_reference\");\n        const id = this.IdFor(node);\n\n        if (idField && target && typeof target === \"object\" && !Object.prototype.hasOwnProperty.call(target, idField))\n        {\n            target[idField] = id;\n        }\n\n        return referenceField ? { [referenceField]: id } : target;\n    }\n\n    IdFor(node)\n    {\n        let id = this.ids.get(node);\n        if (id === undefined)\n        {\n            id = this.nextId++;\n            this.ids.set(node, id);\n        }\n        return id;\n    }\n\n    GetPayloadField(name, fallback)\n    {\n        const value = this.options[name];\n        return value === false ? null : (value || fallback);\n    }\n\n    ResolveClass(type)\n    {\n        if (!type) return null;\n\n        const classes = this.options.classes || {};\n        const Schema = this.options.registry || null;\n        return classes[type] || (Schema ? Schema.GetConstructor(type) : null);\n    }\n}\n"],"names":["CjsRedReader","constructor","input","options","root","parseRed","adapter","resolveHydrationAdapter","hydrationOptions","markDirty","skipUpdate","skipEvents","mode","ResetReadState","refs","Map","ids","nextId","firstId","runtimeInstances","reports","Inspect","typeCounts","seen","Set","nodeCount","visit","node","Array","isArray","forEach","isTypedTable","has","add","type","key","Object","keys","isStrippedKey","format","id","RootType","Read","ReadPayload","object","Hydrate","comments","ReadRuntime","record","finalize","instance","kind","ReadRaw","map","item","decodeTypedTable","row","MakeReference","target","CreateTarget","set","values","AssignValues","built","construct","undefined","ClassConstructor","ResolveClass","_sourceClassName","typeField","GetPayloadField","assign","applyValues","push","get","idField","referenceField","IdFor","prototype","hasOwnProperty","call","name","fallback","value","classes","Schema","registry","GetConstructor"],"mappings":"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"}

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

@@ -0,0 +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

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

@@ -0,0 +1 @@
+{"version":3,"file":"blackDefinitions.js","sources":[],"sourcesContent":[],"names":[],"mappings":";"}

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

@@ -0,0 +1,136 @@
+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",
+  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,
+    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, "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

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

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

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

@@ -0,0 +1,68 @@
+import { CjsYamlFormat } from '../../yaml/CjsYamlFormat.js';
+
+/**
+ * Keys added by authoring tools are prefixed with a double underscore and are
+ * not part of the Red data. They can carry environment-specific information, so
+ * they are stripped on every read and never emitted.
+ * @param {string} key
+ * @returns {boolean}
+ */
+function isStrippedKey(key) {
+  return typeof key === "string" && key.length > 1 && key[0] === "_" && key[1] === "_";
+}
+
+/**
+ * Parses Red input into a plain object graph.
+ *
+ * Accepts an already-parsed object (returned as-is) or a YAML string. YAML
+ * anchors/aliases resolve to shared object identities, which the reader uses
+ * to rebuild the Red reference graph.
+ *
+ * @param {unknown} input parsed Red object or YAML string
+ * @param {object} [options] `options.parse(text)` overrides the built-in parser
+ * @param {string} [readerName]
+ * @returns {object} parsed Red object graph
+ */
+function parseRed(input, options = {}, readerName = "CjsRedFormat") {
+  if (input && typeof input === "object") return input;
+  if (typeof input === "string") {
+    if (typeof options.parse === "function") return options.parse(input);
+    return CjsYamlFormat.readRaw(input, {
+      tagPolicy: "reject"
+    });
+  }
+  throw new TypeError(`${readerName}: input must be a parsed Red object or a YAML string.`);
+}
+
+/**
+ * A "typed table" is Red's compact columnar encoding: a `structure` array of
+ * `[name, typeCode, byteOffset]` columns plus an `items` array where each row
+ * is one record aligned to those columns. Curve `keys`, effect `options`, and
+ * `samplerOverrides` all use this shape.
+ * @param {*} node
+ * @returns {boolean}
+ */
+function isTypedTable(node) {
+  return Boolean(node && typeof node === "object" && !Array.isArray(node) && Array.isArray(node.structure) && Array.isArray(node.items));
+}
+
+/**
+ * Decodes a typed table into an array of row objects keyed by column name.
+ * @param {object} node typed table (`{ structure, items }`)
+ * @returns {Array<object>}
+ */
+function decodeTypedTable(node) {
+  const columns = node.structure.map(column => Array.isArray(column) ? column[0] : column && column.name);
+  return node.items.map(row => {
+    const record = {};
+    const cells = Array.isArray(row) ? row : [row];
+    for (let i = 0; i < columns.length; i++) {
+      if (columns[i] === undefined || columns[i] === null) continue;
+      record[columns[i]] = cells[i];
+    }
+    return record;
+  });
+}
+
+export { decodeTypedTable, isStrippedKey, isTypedTable, parseRed };
+//# sourceMappingURL=redGraph.js.map

package/dist/formats/red/core/redGraph.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redGraph.js","sources":["../../../../../src/formats/red/core/redGraph.js"],"sourcesContent":["import CjsYamlFormat from \"../../yaml/index.js\";\n\n/**\n * Keys added by authoring tools are prefixed with a double underscore and are\n * not part of the Red data. They can carry environment-specific information, so\n * they are stripped on every read and never emitted.\n * @param {string} key\n * @returns {boolean}\n */\nexport function isStrippedKey(key)\n{\n    return typeof key === \"string\" && key.length > 1 && key[0] === \"_\" && key[1] === \"_\";\n}\n\n/**\n * Parses Red input into a plain object graph.\n *\n * Accepts an already-parsed object (returned as-is) or a YAML string. YAML\n * anchors/aliases resolve to shared object identities, which the reader uses\n * to rebuild the Red reference graph.\n *\n * @param {unknown} input parsed Red object or YAML string\n * @param {object} [options] `options.parse(text)` overrides the built-in parser\n * @param {string} [readerName]\n * @returns {object} parsed Red object graph\n */\nexport function parseRed(input, options = {}, readerName = \"CjsRedFormat\")\n{\n    if (input && typeof input === \"object\") return input;\n\n    if (typeof input === \"string\")\n    {\n        if (typeof options.parse === \"function\") return options.parse(input);\n        return CjsYamlFormat.readRaw(input, { tagPolicy: \"reject\" });\n    }\n\n    throw new TypeError(`${readerName}: input must be a parsed Red object or a YAML string.`);\n}\n\n/**\n * A \"typed table\" is Red's compact columnar encoding: a `structure` array of\n * `[name, typeCode, byteOffset]` columns plus an `items` array where each row\n * is one record aligned to those columns. Curve `keys`, effect `options`, and\n * `samplerOverrides` all use this shape.\n * @param {*} node\n * @returns {boolean}\n */\nexport function isTypedTable(node)\n{\n    return Boolean(\n        node &&\n        typeof node === \"object\" &&\n        !Array.isArray(node) &&\n        Array.isArray(node.structure) &&\n        Array.isArray(node.items)\n    );\n}\n\n/**\n * Decodes a typed table into an array of row objects keyed by column name.\n * @param {object} node typed table (`{ structure, items }`)\n * @returns {Array<object>}\n */\nexport function decodeTypedTable(node)\n{\n    const columns = node.structure.map(column => (Array.isArray(column) ? column[0] : column && column.name));\n\n    return node.items.map(row =>\n    {\n        const record = {};\n        const cells = Array.isArray(row) ? row : [ row ];\n        for (let i = 0; i < columns.length; i++)\n        {\n            if (columns[i] === undefined || columns[i] === null) continue;\n            record[columns[i]] = cells[i];\n        }\n        return record;\n    });\n}\n\n/**\n * Red `structure` type codes (informational). The YAML export already carries\n * decoded JS values, so decoding keys on column names, not these codes.\n */\nexport const RED_TYPE_CODES = Object.freeze({\n    4: \"float32\",\n    5: \"string\",\n    8: \"uint8\",\n    9: \"uint16\",\n    10: \"uint32\"\n});\n"],"names":["isStrippedKey","key","length","parseRed","input","options","readerName","parse","CjsYamlFormat","readRaw","tagPolicy","TypeError","isTypedTable","node","Boolean","Array","isArray","structure","items","decodeTypedTable","columns","map","column","name","row","record","cells","i","undefined"],"mappings":";;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASA,aAAaA,CAACC,GAAG,EACjC;EACI,OAAO,OAAOA,GAAG,KAAK,QAAQ,IAAIA,GAAG,CAACC,MAAM,GAAG,CAAC,IAAID,GAAG,CAAC,CAAC,CAAC,KAAK,GAAG,IAAIA,GAAG,CAAC,CAAC,CAAC,KAAK,GAAG;AACxF;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASE,QAAQA,CAACC,KAAK,EAAEC,OAAO,GAAG,EAAE,EAAEC,UAAU,GAAG,cAAc,EACzE;EACI,IAAIF,KAAK,IAAI,OAAOA,KAAK,KAAK,QAAQ,EAAE,OAAOA,KAAK;AAEpD,EAAA,IAAI,OAAOA,KAAK,KAAK,QAAQ,EAC7B;AACI,IAAA,IAAI,OAAOC,OAAO,CAACE,KAAK,KAAK,UAAU,EAAE,OAAOF,OAAO,CAACE,KAAK,CAACH,KAAK,CAAC;AACpE,IAAA,OAAOI,aAAa,CAACC,OAAO,CAACL,KAAK,EAAE;AAAEM,MAAAA,SAAS,EAAE;AAAS,KAAC,CAAC;AAChE,EAAA;AAEA,EAAA,MAAM,IAAIC,SAAS,CAAC,CAAA,EAAGL,UAAU,uDAAuD,CAAC;AAC7F;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASM,YAAYA,CAACC,IAAI,EACjC;AACI,EAAA,OAAOC,OAAO,CACVD,IAAI,IACJ,OAAOA,IAAI,KAAK,QAAQ,IACxB,CAACE,KAAK,CAACC,OAAO,CAACH,IAAI,CAAC,IACpBE,KAAK,CAACC,OAAO,CAACH,IAAI,CAACI,SAAS,CAAC,IAC7BF,KAAK,CAACC,OAAO,CAACH,IAAI,CAACK,KAAK,CAC5B,CAAC;AACL;;AAEA;AACA;AACA;AACA;AACA;AACO,SAASC,gBAAgBA,CAACN,IAAI,EACrC;EACI,MAAMO,OAAO,GAAGP,IAAI,CAACI,SAAS,CAACI,GAAG,CAACC,MAAM,IAAKP,KAAK,CAACC,OAAO,CAACM,MAAM,CAAC,GAAGA,MAAM,CAAC,CAAC,CAAC,GAAGA,MAAM,IAAIA,MAAM,CAACC,IAAK,CAAC;AAEzG,EAAA,OAAOV,IAAI,CAACK,KAAK,CAACG,GAAG,CAACG,GAAG,IACzB;IACI,MAAMC,MAAM,GAAG,EAAE;AACjB,IAAA,MAAMC,KAAK,GAAGX,KAAK,CAACC,OAAO,CAACQ,GAAG,CAAC,GAAGA,GAAG,GAAG,CAAEA,GAAG,CAAE;AAChD,IAAA,KAAK,IAAIG,CAAC,GAAG,CAAC,EAAEA,CAAC,GAAGP,OAAO,CAAClB,MAAM,EAAEyB,CAAC,EAAE,EACvC;AACI,MAAA,IAAIP,OAAO,CAACO,CAAC,CAAC,KAAKC,SAAS,IAAIR,OAAO,CAACO,CAAC,CAAC,KAAK,IAAI,EAAE;MACrDF,MAAM,CAACL,OAAO,CAACO,CAAC,CAAC,CAAC,GAAGD,KAAK,CAACC,CAAC,CAAC;AACjC,IAAA;AACA,IAAA,OAAOF,MAAM;AACjB,EAAA,CAAC,CAAC;AACN;;;;"}

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

@@ -0,0 +1,4 @@
+const CLASS_KEYS = Object.freeze(["Root", "Document", "Mapping", "Sequence", "Scalar", "Reference"]);
+
+export { CLASS_KEYS };
+//# sourceMappingURL=schema.js.map

package/dist/formats/red/core/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sources":["../../../../../src/formats/red/core/schema.js"],"sourcesContent":["export const CLASS_KEYS = Object.freeze([\n    \"Root\",\n    \"Document\",\n    \"Mapping\",\n    \"Sequence\",\n    \"Scalar\",\n    \"Reference\"\n]);\n"],"names":["CLASS_KEYS","Object","freeze"],"mappings":"AAAO,MAAMA,UAAU,GAAGC,MAAM,CAACC,MAAM,CAAC,CACpC,MAAM,EACN,UAAU,EACV,SAAS,EACT,UAAU,EACV,QAAQ,EACR,WAAW,CACd;;;;"}

package/dist/formats/red/index.js

@@ -0,0 +1,2 @@
+export { CjsRedFormat, CjsRedFormat as default } from './CjsRedFormat.js';
+//# sourceMappingURL=index.js.map

package/dist/formats/red/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":""}

package/dist/formats/stl/CjsStlFormat.js

@@ -0,0 +1,304 @@
+import { DEFAULT_VALUES, normalizeValues, validateClassKey, validateClass, readWithValues, writeWithValues, inspectWithValues, toJsonValue, importNodeModule, OUTPUT_JSON, OUTPUT_STL_JSON, OUTPUT_SHARED, OUTPUT_GR2, OUTPUT_CMF, CLASS_KEYS } from './core/helpers.js';
+import { isStl, isBinaryStl } from './core/stl.js';
+
+/**
+ * Exposed CarbonEngineJS-facing STL format class.
+ *
+ * Keep this file small and reviewable: STL parsing, writing, printability
+ * inspection, option normalization, and JSON hydration live under src/core.
+ */
+
+const FORMAT_NAME = "CjsStlFormat";
+
+/**
+ * CarbonEngineJS-facing STL format surface.
+ *
+ * The Cjs prefix marks this as a JavaScript format/construction boundary.
+ * STL is a triangle-only import/export format; the JSON contract is the shared
+ * CarbonEngineJS mesh schema.
+ */
+class CjsStlFormat {
+  #emit = DEFAULT_VALUES.emit;
+  #source = DEFAULT_VALUES.source;
+  #binary = DEFAULT_VALUES.binary;
+  #solidName = DEFAULT_VALUES.solidName;
+  #scale = DEFAULT_VALUES.scale;
+  #recalculateNormals = DEFAULT_VALUES.recalculateNormals;
+  #weldVertices = DEFAULT_VALUES.weldVertices;
+  #weldTolerance = DEFAULT_VALUES.weldTolerance;
+  #skipDegenerate = DEFAULT_VALUES.skipDegenerate;
+  #requireWatertight = DEFAULT_VALUES.requireWatertight;
+  #classes = DEFAULT_VALUES.classes;
+
+  /**
+   * Create a reusable format profile.
+   *
+   * @param {object} [options] Default format values.
+   */
+  constructor(options = {}) {
+    this.SetValues(options);
+  }
+
+  /**
+   * Set format values for this reusable profile.
+   *
+   * @param {object} [options] Values to merge into the profile.
+   * @returns {CjsStlFormat} This format profile.
+   */
+  SetValues(options = {}) {
+    const values = normalizeValues(this.GetValues(), options, FORMAT_NAME);
+    this.#emit = values.emit;
+    this.#source = values.source;
+    this.#binary = values.binary;
+    this.#solidName = values.solidName;
+    this.#scale = values.scale;
+    this.#recalculateNormals = values.recalculateNormals;
+    this.#weldVertices = values.weldVertices;
+    this.#weldTolerance = values.weldTolerance;
+    this.#skipDegenerate = values.skipDegenerate;
+    this.#requireWatertight = values.requireWatertight;
+    this.#classes = values.classes;
+    return this;
+  }
+
+  /**
+   * Get this profile's current values, optionally with per-call overrides.
+   *
+   * @param {object} [options] Optional values to merge into a copy.
+   * @returns {object} A copy of the effective values.
+   */
+  GetValues(options = {}) {
+    return normalizeValues({
+      emit: this.#emit,
+      source: this.#source,
+      binary: this.#binary,
+      solidName: this.#solidName,
+      scale: this.#scale,
+      recalculateNormals: this.#recalculateNormals,
+      weldVertices: this.#weldVertices,
+      weldTolerance: this.#weldTolerance,
+      skipDegenerate: this.#skipDegenerate,
+      requireWatertight: this.#requireWatertight,
+      classes: this.#classes
+    }, options, FORMAT_NAME);
+  }
+
+  /**
+   * Set multiple node-class constructors for this profile.
+   *
+   * @param {object} [classes] Map of node class keys to constructors.
+   * @returns {CjsStlFormat} This format profile.
+   */
+  SetClasses(classes = {}) {
+    return this.SetValues({
+      classes
+    });
+  }
+
+  /**
+   * Set one node-class constructor for this profile.
+   *
+   * @param {string} type Node class key.
+   * @param {Function|null|undefined} Class Constructor to use, or nullish to delete.
+   * @returns {CjsStlFormat} This format profile.
+   */
+  SetClass(type, Class) {
+    if (Class === null || Class === undefined) {
+      validateClassKey(type, FORMAT_NAME);
+      const classes = {
+        ...this.#classes
+      };
+      delete classes[type];
+      this.#classes = classes;
+      return this;
+    }
+    validateClass(type, Class, FORMAT_NAME);
+    return this.SetValues({
+      classes: {
+        [type]: Class
+      }
+    });
+  }
+
+  /**
+   * Get a configured node-class constructor.
+   *
+   * @param {string} type Node class key.
+   * @returns {Function|undefined} The registered constructor, if any.
+   */
+  GetClass(type) {
+    validateClassKey(type, FORMAT_NAME);
+    return this.#classes[type];
+  }
+
+  /**
+   * Whether this format profile has a constructor registered for a node class key.
+   *
+   * @param {string} type Node class key.
+   * @returns {boolean} True when a constructor is registered.
+   */
+  HasClass(type) {
+    return !!this.GetClass(type);
+  }
+
+  /**
+   * Read STL text/bytes with this profile's values.
+   *
+   * @param {string|Uint8Array|ArrayBuffer|DataView} input STL text or bytes.
+   * @param {object} [options] Per-call value overrides.
+   * @returns {object} The shared CarbonEngineJS JSON mesh schema.
+   */
+  Read(input, options = {}) {
+    return readWithValues(this, input, this.GetValues(options));
+  }
+
+  /**
+   * Write shared JSON geometry as STL with this profile's values.
+   *
+   * @param {object} input Shared JSON root or mesh.
+   * @param {object} [options] Per-call value overrides.
+   * @returns {string|Uint8Array} ASCII STL text or binary STL bytes.
+   */
+  Write(input, options = {}) {
+    return writeWithValues(input, this.GetValues(options));
+  }
+
+  /**
+   * Inspect STL text/bytes or shared JSON geometry for printability blockers.
+   *
+   * @param {any} input STL text/bytes or shared JSON root/mesh.
+   * @param {object} [options] Per-call value overrides.
+   * @returns {object} Plain printability report.
+   */
+  Inspect(input, options = {}) {
+    return inspectWithValues(input, this.GetValues(options));
+  }
+
+  /**
+   * Convert format output to JSON-compatible data.
+   *
+   * @param {any} value Format output to convert.
+   * @returns {any} Plain JSON-compatible data.
+   */
+  ToJSON(value) {
+    return toJsonValue(value);
+  }
+
+  /**
+   * Static one-shot read. Static methods use camelCase by convention.
+   *
+   * @param {string|Uint8Array|ArrayBuffer|DataView} input STL text or bytes.
+   * @param {object} [options] Format values.
+   * @returns {object} The shared CarbonEngineJS JSON mesh schema.
+   */
+  static read(input, options = {}) {
+    return readWithValues(CjsStlFormat, input, normalizeValues(DEFAULT_VALUES, options, FORMAT_NAME));
+  }
+
+  /**
+   * Static one-shot write.
+   *
+   * @param {object} input Shared JSON root or mesh.
+   * @param {object} [options] Format values.
+   * @returns {string|Uint8Array} ASCII STL text or binary STL bytes.
+   */
+  static write(input, options = {}) {
+    return writeWithValues(input, normalizeValues(DEFAULT_VALUES, options, FORMAT_NAME));
+  }
+
+  /**
+   * Static one-shot inspection.
+   *
+   * @param {any} input STL text/bytes or shared JSON root/mesh.
+   * @param {object} [options] Format values.
+   * @returns {object} Plain printability report.
+   */
+  static inspect(input, options = {}) {
+    return inspectWithValues(input, normalizeValues(DEFAULT_VALUES, options, FORMAT_NAME));
+  }
+
+  /**
+   * Static JSON-compatible conversion.
+   *
+   * @param {any} value Format output to convert.
+   * @returns {any} Plain JSON-compatible data.
+   */
+  static toJSON(value) {
+    return toJsonValue(value);
+  }
+
+  /**
+   * Node-only convenience: reads an STL file from disk.
+   *
+   * @param {string} path Path to an STL file.
+   * @param {object} [options] Format values.
+   * @returns {Promise<object>} The shared CarbonEngineJS JSON mesh schema.
+   */
+  static async readFile(path, options = {}) {
+    if (typeof path !== "string" || !path) {
+      throw new TypeError(`${FORMAT_NAME}: readFile path must be a non-empty string`);
+    }
+    const {
+      readFile
+    } = await importNodeModule("node:fs/promises");
+    const input = await readFile(path);
+    return CjsStlFormat.read(input, {
+      source: path,
+      ...options
+    });
+  }
+
+  /**
+   * Node-only convenience: writes an STL file to disk.
+   *
+   * @param {string} path Path to write.
+   * @param {object} input Shared JSON root or mesh.
+   * @param {object} [options] Format values.
+   * @returns {Promise<string>} The written path.
+   */
+  static async writeFile(path, input, options = {}) {
+    if (typeof path !== "string" || !path) {
+      throw new TypeError(`${FORMAT_NAME}: writeFile path must be a non-empty string`);
+    }
+    const {
+      writeFile
+    } = await importNodeModule("node:fs/promises");
+    const output = CjsStlFormat.write(input, options);
+    await writeFile(path, output);
+    return path;
+  }
+
+  /**
+   * Cheap sniff for STL-like input.
+   *
+   * @param {string|Uint8Array|ArrayBuffer|DataView} input Candidate STL input.
+   * @returns {boolean} True when input looks like STL.
+   */
+  static isStl(input) {
+    return isStl(input);
+  }
+
+  /**
+   * Check whether byte-like input has an exact binary STL layout.
+   *
+   * @param {string|Uint8Array|ArrayBuffer|DataView} input Candidate STL input.
+   * @returns {boolean} True when input is binary STL bytes.
+   */
+  static isBinaryStl(input) {
+    return isBinaryStl(input);
+  }
+  static OUTPUT_JSON = OUTPUT_JSON;
+  static OUTPUT_STL_JSON = OUTPUT_STL_JSON;
+  static OUTPUT_SHARED = OUTPUT_SHARED;
+  static OUTPUT_GR2 = OUTPUT_GR2;
+  static OUTPUT_CMF = OUTPUT_CMF;
+  static CLASS_KEYS = CLASS_KEYS;
+  static type = Object.freeze(["geometry"]);
+  static mediaTypes = Object.freeze(["geometry"]);
+  static inputTypes = Object.freeze(["stl"]);
+  static outputTypes = Object.freeze([OUTPUT_SHARED, OUTPUT_GR2, OUTPUT_CMF]);
+  static debugOutputTypes = Object.freeze([OUTPUT_JSON, OUTPUT_STL_JSON]);
+}
+
+export { CjsStlFormat, CjsStlFormat as default };
+//# sourceMappingURL=CjsStlFormat.js.map

package/dist/formats/stl/CjsStlFormat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CjsStlFormat.js","sources":["../../../../src/formats/stl/CjsStlFormat.js"],"sourcesContent":["/**\n * Exposed CarbonEngineJS-facing STL format class.\n *\n * Keep this file small and reviewable: STL parsing, writing, printability\n * inspection, option normalization, and JSON hydration live under src/core.\n */\n\nimport {\n    CLASS_KEYS,\n    DEFAULT_VALUES,\n    OUTPUT_CMF,\n    OUTPUT_GR2,\n    OUTPUT_JSON,\n    OUTPUT_SHARED,\n    OUTPUT_STL_JSON,\n    importNodeModule,\n    inspectWithValues,\n    isBinaryStl,\n    isStl,\n    normalizeValues,\n    readWithValues,\n    toJsonValue,\n    validateClass,\n    validateClassKey,\n    writeWithValues\n} from \"./core/helpers.js\";\n\nconst FORMAT_NAME = \"CjsStlFormat\";\n\n/**\n * CarbonEngineJS-facing STL format surface.\n *\n * The Cjs prefix marks this as a JavaScript format/construction boundary.\n * STL is a triangle-only import/export format; the JSON contract is the shared\n * CarbonEngineJS mesh schema.\n */\nexport class CjsStlFormat\n{\n\n    #emit = DEFAULT_VALUES.emit;\n    #source = DEFAULT_VALUES.source;\n    #binary = DEFAULT_VALUES.binary;\n    #solidName = DEFAULT_VALUES.solidName;\n    #scale = DEFAULT_VALUES.scale;\n    #recalculateNormals = DEFAULT_VALUES.recalculateNormals;\n    #weldVertices = DEFAULT_VALUES.weldVertices;\n    #weldTolerance = DEFAULT_VALUES.weldTolerance;\n    #skipDegenerate = DEFAULT_VALUES.skipDegenerate;\n    #requireWatertight = DEFAULT_VALUES.requireWatertight;\n    #classes = DEFAULT_VALUES.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 {CjsStlFormat} This format profile.\n     */\n    SetValues(options = {})\n    {\n        const values = normalizeValues(this.GetValues(), options, FORMAT_NAME);\n\n        this.#emit = values.emit;\n        this.#source = values.source;\n        this.#binary = values.binary;\n        this.#solidName = values.solidName;\n        this.#scale = values.scale;\n        this.#recalculateNormals = values.recalculateNormals;\n        this.#weldVertices = values.weldVertices;\n        this.#weldTolerance = values.weldTolerance;\n        this.#skipDegenerate = values.skipDegenerate;\n        this.#requireWatertight = values.requireWatertight;\n        this.#classes = values.classes;\n\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            source: this.#source,\n            binary: this.#binary,\n            solidName: this.#solidName,\n            scale: this.#scale,\n            recalculateNormals: this.#recalculateNormals,\n            weldVertices: this.#weldVertices,\n            weldTolerance: this.#weldTolerance,\n            skipDegenerate: this.#skipDegenerate,\n            requireWatertight: this.#requireWatertight,\n            classes: this.#classes\n        }, options, FORMAT_NAME);\n    }\n\n    /**\n     * Set multiple node-class constructors for this profile.\n     *\n     * @param {object} [classes] Map of node class keys to constructors.\n     * @returns {CjsStlFormat} 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 Node class key.\n     * @param {Function|null|undefined} Class Constructor to use, or nullish to delete.\n     * @returns {CjsStlFormat} This format profile.\n     */\n    SetClass(type, Class)\n    {\n        if (Class === null || Class === undefined)\n        {\n            validateClassKey(type, FORMAT_NAME);\n            const classes = { ...this.#classes };\n            delete classes[type];\n            this.#classes = classes;\n            return this;\n        }\n\n        validateClass(type, Class, FORMAT_NAME);\n        return this.SetValues({ classes: { [type]: Class } });\n    }\n\n    /**\n     * Get a configured node-class constructor.\n     *\n     * @param {string} type Node class key.\n     * @returns {Function|undefined} The registered constructor, if any.\n     */\n    GetClass(type)\n    {\n        validateClassKey(type, FORMAT_NAME);\n        return this.#classes[type];\n    }\n\n    /**\n     * Whether this format profile has a constructor registered for a node class 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 STL text/bytes with this profile's values.\n     *\n     * @param {string|Uint8Array|ArrayBuffer|DataView} input STL text or bytes.\n     * @param {object} [options] Per-call value overrides.\n     * @returns {object} The shared CarbonEngineJS JSON mesh schema.\n     */\n    Read(input, options = {})\n    {\n        return readWithValues(this, input, this.GetValues(options));\n    }\n\n    /**\n     * Write shared JSON geometry as STL with this profile's values.\n     *\n     * @param {object} input Shared JSON root or mesh.\n     * @param {object} [options] Per-call value overrides.\n     * @returns {string|Uint8Array} ASCII STL text or binary STL bytes.\n     */\n    Write(input, options = {})\n    {\n        return writeWithValues(input, this.GetValues(options));\n    }\n\n    /**\n     * Inspect STL text/bytes or shared JSON geometry for printability blockers.\n     *\n     * @param {any} input STL text/bytes or shared JSON root/mesh.\n     * @param {object} [options] Per-call value overrides.\n     * @returns {object} Plain printability report.\n     */\n    Inspect(input, options = {})\n    {\n        return inspectWithValues(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 {string|Uint8Array|ArrayBuffer|DataView} input STL text or bytes.\n     * @param {object} [options] Format values.\n     * @returns {object} The shared CarbonEngineJS JSON mesh schema.\n     */\n    static read(input, options = {})\n    {\n        return readWithValues(CjsStlFormat, input, normalizeValues(DEFAULT_VALUES, options, FORMAT_NAME));\n    }\n\n    /**\n     * Static one-shot write.\n     *\n     * @param {object} input Shared JSON root or mesh.\n     * @param {object} [options] Format values.\n     * @returns {string|Uint8Array} ASCII STL text or binary STL bytes.\n     */\n    static write(input, options = {})\n    {\n        return writeWithValues(input, normalizeValues(DEFAULT_VALUES, options, FORMAT_NAME));\n    }\n\n    /**\n     * Static one-shot inspection.\n     *\n     * @param {any} input STL text/bytes or shared JSON root/mesh.\n     * @param {object} [options] Format values.\n     * @returns {object} Plain printability report.\n     */\n    static inspect(input, options = {})\n    {\n        return inspectWithValues(input, normalizeValues(DEFAULT_VALUES, options, FORMAT_NAME));\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     * Node-only convenience: reads an STL file from disk.\n     *\n     * @param {string} path Path to an STL file.\n     * @param {object} [options] Format values.\n     * @returns {Promise<object>} The shared CarbonEngineJS JSON mesh schema.\n     */\n    static async readFile(path, options = {})\n    {\n        if (typeof path !== \"string\" || !path)\n        {\n            throw new TypeError(`${FORMAT_NAME}: readFile path must be a non-empty string`);\n        }\n\n        const { readFile } = await importNodeModule(\"node:fs/promises\");\n        const input = await readFile(path);\n        return CjsStlFormat.read(input, { source: path, ...options });\n    }\n\n    /**\n     * Node-only convenience: writes an STL file to disk.\n     *\n     * @param {string} path Path to write.\n     * @param {object} input Shared JSON root or mesh.\n     * @param {object} [options] Format values.\n     * @returns {Promise<string>} The written path.\n     */\n    static async writeFile(path, input, options = {})\n    {\n        if (typeof path !== \"string\" || !path)\n        {\n            throw new TypeError(`${FORMAT_NAME}: writeFile path must be a non-empty string`);\n        }\n\n        const { writeFile } = await importNodeModule(\"node:fs/promises\");\n        const output = CjsStlFormat.write(input, options);\n        await writeFile(path, output);\n        return path;\n    }\n\n    /**\n     * Cheap sniff for STL-like input.\n     *\n     * @param {string|Uint8Array|ArrayBuffer|DataView} input Candidate STL input.\n     * @returns {boolean} True when input looks like STL.\n     */\n    static isStl(input)\n    {\n        return isStl(input);\n    }\n\n    /**\n     * Check whether byte-like input has an exact binary STL layout.\n     *\n     * @param {string|Uint8Array|ArrayBuffer|DataView} input Candidate STL input.\n     * @returns {boolean} True when input is binary STL bytes.\n     */\n    static isBinaryStl(input)\n    {\n        return isBinaryStl(input);\n    }\n\n    static OUTPUT_JSON = OUTPUT_JSON;\n    static OUTPUT_STL_JSON = OUTPUT_STL_JSON;\n    static OUTPUT_SHARED = OUTPUT_SHARED;\n    static OUTPUT_GR2 = OUTPUT_GR2;\n    static OUTPUT_CMF = OUTPUT_CMF;\n    static CLASS_KEYS = CLASS_KEYS;\n    static type = Object.freeze([ \"geometry\" ]);\n    static mediaTypes = Object.freeze([ \"geometry\" ]);\n    static inputTypes = Object.freeze([ \"stl\" ]);\n    static outputTypes = Object.freeze([ OUTPUT_SHARED, OUTPUT_GR2, OUTPUT_CMF ]);\n    static debugOutputTypes = Object.freeze([ OUTPUT_JSON, OUTPUT_STL_JSON ]);\n\n}\n\nexport default CjsStlFormat;\n"],"names":["FORMAT_NAME","CjsStlFormat","DEFAULT_VALUES","emit","source","binary","solidName","scale","recalculateNormals","weldVertices","weldTolerance","skipDegenerate","requireWatertight","classes","constructor","options","SetValues","values","normalizeValues","GetValues","SetClasses","SetClass","type","Class","undefined","validateClassKey","validateClass","GetClass","HasClass","Read","input","readWithValues","Write","writeWithValues","Inspect","inspectWithValues","ToJSON","value","toJsonValue","read","write","inspect","toJSON","readFile","path","TypeError","importNodeModule","writeFile","output","isStl","isBinaryStl","OUTPUT_JSON","OUTPUT_STL_JSON","OUTPUT_SHARED","OUTPUT_GR2","OUTPUT_CMF","CLASS_KEYS","Object","freeze","mediaTypes","inputTypes","outputTypes","debugOutputTypes"],"mappings":"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"}