@carbonenginejs/runtime 0.1.0-alpha.0 → 0.1.0-alpha.2

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

@@ -1,3 +1,5 @@
+import { toJsonAcyclic } from '../../../format/jsonPolicies.js';
+
 const OUTPUT_JSON = "json";
 const OUTPUT_PAYLOAD = "payload";
 const OUTPUT_RUNTIME = "runtime";
@@ -58,9 +60,9 @@ function validateClassKey(classKeys, key, readerName) {
   }
 }
 
-/**
- * Validates a resolved runtime class constructor for the RED object-graph
- * reader.
+/**
+ * Validates a resolved runtime class constructor for the RED object-graph
+ * reader.
  */
 function validateClass(classKeys, type, Class, readerName) {
   validateClassKey(classKeys, type, readerName);
@@ -82,9 +84,9 @@ function mergeClasses(values, classes, classKeys, readerName) {
   values.classes = next;
 }
 
-/**
- * Normalizes reader options against their supported defaults for the RED
- * object-graph reader.
+/**
+ * Normalizes reader options against their supported defaults for the RED
+ * object-graph reader.
  */
 function normalizeValues(base, options, classKeys, readerName) {
   if (!options || typeof options !== "object") {
@@ -122,30 +124,18 @@ function copyReaderOptions(values) {
   return readerOptions;
 }
 
-/**
- * Converts a parsed payload into a JSON-safe value for the RED object-graph
- * reader.
+/**
+ * Converts a parsed payload into a JSON-safe value for the RED object-graph
+ * reader.
  */
-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;
+/**
+ * Convert to JSON, refusing a cycle, naming this reader in the error.
+ *
+ * @param {*} value Any decoded value.
+ * @returns {*} A JSON-safe value.
+ */
+function toJsonValue(value) {
+  return toJsonAcyclic(value, "Reader");
 }
 
 export { DEFAULT_VALUES, OUTPUT_JSON, OUTPUT_PAYLOAD, OUTPUT_RAW, OUTPUT_RUNTIME, copyReaderOptions, normalizeValues, toJsonValue, validateClass, validateClassKey };

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

@@ -1 +1 @@
-{"version":3,"file":"helpers.js","sources":["../../../../../../src/resource/formats/red/core/helpers.js"],"sourcesContent":["export const OUTPUT_JSON = \"json\";\r\nexport const OUTPUT_PAYLOAD = \"payload\";\r\nexport const OUTPUT_RUNTIME = \"runtime\";\r\nexport const OUTPUT_RAW = \"raw\";\r\n\r\nexport const DEFAULT_VALUES = Object.freeze({\r\n    emit: OUTPUT_JSON,\r\n    schema: null,\r\n    registry: null,\r\n    firstId: 1,\r\n    parse: null,\r\n    adapter: null,\r    payloadTypeField: \"_type\",\r\n    payloadIdField: \"_id\",\r\n    payloadReferenceField: \"_reference\",\r\n    payloadValuesField: \"_values\",\r\n    classes: Object.freeze({})\r\n});\r\n\r\nconst OPTION_KEYS = new Set(Object.keys(DEFAULT_VALUES));\r\n\n\r\nfunction normalizeEmit(emit, readerName)\r\n{\r\n    if (emit === undefined || emit === OUTPUT_JSON) return OUTPUT_JSON;\r\n    if (emit === OUTPUT_PAYLOAD) return OUTPUT_PAYLOAD;\r\n    if (emit === OUTPUT_RUNTIME) return OUTPUT_RUNTIME;\r\n    if (emit === OUTPUT_RAW) return OUTPUT_RAW;\r\n    throw new Error(`${readerName} unknown emit value \"${emit}\"`);\r\n}\r\n\r\nfunction assertKnownOptions(options, readerName)\r\n{\r\n    for (const key of Object.keys(options))\r\n    {\r\n        if (!OPTION_KEYS.has(key))\r\n        {\r\n            throw new TypeError(`${readerName} unknown option \"${key}\"`);\r\n        }\r\n    }\r\n}\r\n\r\nfunction classMap(values)\r\n{\r\n    return values && values.classes ? values.classes : {};\r\n}\r\n\r\nfunction cloneValues(values)\r\n{\r\n    return {\r\n        emit: values.emit,\r\n        schema: values.schema ?? null,\r\n        registry: values.registry ?? null,\r\n        firstId: values.firstId ?? 1,\r\n        parse: values.parse ?? null,\r\n        adapter: values.adapter ?? null,\r        payloadTypeField: values.payloadTypeField,\r\n        payloadIdField: values.payloadIdField,\r\n        payloadReferenceField: values.payloadReferenceField,\r\n        payloadValuesField: values.payloadValuesField,\r\n        classes: { ...classMap(values) }\r\n    };\r\n}\r\n\r\n/** Validates a requested runtime class key for the RED object-graph reader. */\r\nexport function validateClassKey(classKeys, key, readerName)\r\n{\r\n    if (typeof key !== \"string\" || !key)\r\n    {\r\n        throw new Error(`${readerName} class type must be a non-empty string`);\r\n    }\r\n}\r\n\r\n/**\r\n * Validates a resolved runtime class constructor for the RED object-graph\r\n * reader.\r\n */\r\nexport function validateClass(classKeys, type, Class, readerName)\r\n{\r\n    validateClassKey(classKeys, type, readerName);\r\n    if (typeof Class !== \"function\")\r\n    {\r\n        throw new TypeError(`${readerName} class \"${type}\" must be a constructor`);\r\n    }\r\n}\r\n\r\nfunction mergeClasses(values, classes, classKeys, readerName)\r\n{\r\n    if (!classes || typeof classes !== \"object\")\r\n    {\r\n        throw new TypeError(`${readerName} classes option must be an object`);\r\n    }\r\n\r\n    const next = { ...values.classes };\r\n    for (const [ type, Class ] of Object.entries(classes))\r\n    {\r\n        validateClass(classKeys, type, Class, readerName);\r\n        next[type] = Class;\r\n    }\r\n    values.classes = next;\r\n}\r\n\r\n/**\r\n * Normalizes reader options against their supported defaults for the RED\r\n * object-graph reader.\r\n */\r\nexport function normalizeValues(base, options, classKeys, readerName)\r\n{\r\n    if (!options || typeof options !== \"object\")\r\n    {\r\n        throw new TypeError(`${readerName} options must be an object`);\r\n    }\r\n\r\n    assertKnownOptions(options, readerName);\r\n\r\n    const values = cloneValues(base);\r\n    if (Object.hasOwn(options, \"emit\")) values.emit = normalizeEmit(options.emit, readerName);\r\n    if (Object.hasOwn(options, \"schema\")) values.schema = options.schema ?? null;\r\n    if (Object.hasOwn(options, \"registry\")) values.registry = options.registry ?? null;\r\n    if (Object.hasOwn(options, \"firstId\")) values.firstId = options.firstId ?? 1;\r\n    if (Object.hasOwn(options, \"parse\"))\r\n    {\r\n        if (options.parse !== null && options.parse !== undefined && typeof options.parse !== \"function\")\r\n        {\r\n            throw new TypeError(`${readerName} parse option must be a function`);\r\n        }\r\n        values.parse = options.parse ?? null;\r\n    }\r\n    if (Object.hasOwn(options, \"adapter\")) values.adapter = options.adapter ?? null;\r    if (Object.hasOwn(options, \"payloadTypeField\")) values.payloadTypeField = options.payloadTypeField;\r\n    if (Object.hasOwn(options, \"payloadIdField\")) values.payloadIdField = options.payloadIdField;\r\n    if (Object.hasOwn(options, \"payloadReferenceField\")) values.payloadReferenceField = options.payloadReferenceField;\r\n    if (Object.hasOwn(options, \"payloadValuesField\")) values.payloadValuesField = options.payloadValuesField;\r\n    if (Object.hasOwn(options, \"classes\")) mergeClasses(values, options.classes, classKeys, readerName);\r\n    return values;\r\n}\r\n\r\n/** Copies reader options accepted by the current RED object-graph reader. */\r\nexport function copyReaderOptions(values)\r\n{\r\n    const { emit: _emit, schema: _schema, classes: _classes, ...readerOptions } = values;\r\n    return readerOptions;\r\n}\r\n\r\n/**\r\n * Converts a parsed payload into a JSON-safe value for the RED object-graph\r\n * reader.\r\n */\r\nexport function toJsonValue(value, seen = new WeakSet())\r\n{\r\n    if (value === null || typeof value !== \"object\") return value;\r\n    if (ArrayBuffer.isView(value)) return Array.from(value, item => toJsonValue(item, seen));\r\n    if (Array.isArray(value)) return value.map(item => toJsonValue(item, seen));\r\n\r\n    if (seen.has(value))\r\n    {\r\n        throw new TypeError(\"Reader.toJSON cannot convert circular data\");\r\n    }\r\n\r\n    if (typeof value.toJSON === \"function\")\r\n    {\r\n        seen.add(value);\r\n        const json = toJsonValue(value.toJSON(), seen);\r\n        seen.delete(value);\r\n        return json;\r\n    }\r\n\r\n    seen.add(value);\r\n    const out = {};\r\n    for (const key of Object.keys(value))\r\n    {\r\n        out[key] = toJsonValue(value[key], seen);\r\n    }\r\n    seen.delete(value);\r\n    return out;\r\n}\r\n"],"names":["OUTPUT_JSON","OUTPUT_PAYLOAD","OUTPUT_RUNTIME","OUTPUT_RAW","DEFAULT_VALUES","Object","freeze","emit","schema","registry","firstId","parse","adapter","payloadTypeField","payloadIdField","payloadReferenceField","payloadValuesField","classes","OPTION_KEYS","Set","keys","normalizeEmit","readerName","undefined","Error","assertKnownOptions","options","key","has","TypeError","classMap","values","cloneValues","validateClassKey","classKeys","validateClass","type","Class","mergeClasses","next","entries","normalizeValues","base","hasOwn","copyReaderOptions","_emit","_schema","_classes","readerOptions","toJsonValue","value","seen","WeakSet","ArrayBuffer","isView","Array","from","item","isArray","map","toJSON","add","json","delete","out"],"mappings":"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"}
+{"version":3,"file":"helpers.js","sources":["../../../../../../src/resource/formats/red/core/helpers.js"],"sourcesContent":["import { toJsonAcyclic } from \"../../../format/jsonPolicies.js\";\n\nexport 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    payloadTypeField: \"_type\",\n    payloadIdField: \"_id\",\n    payloadReferenceField: \"_reference\",\n    payloadValuesField: \"_values\",\n    classes: Object.freeze({})\n});\n\nconst OPTION_KEYS = new Set(Object.keys(DEFAULT_VALUES));\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        payloadTypeField: values.payloadTypeField,\n        payloadIdField: values.payloadIdField,\n        payloadReferenceField: values.payloadReferenceField,\n        payloadValuesField: values.payloadValuesField,\n        classes: { ...classMap(values) }\n    };\n}\n\n/** Validates a requested runtime class key for the RED object-graph reader. */\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\n/**\n * Validates a resolved runtime class constructor for the RED object-graph\n * reader.\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\n/**\n * Normalizes reader options against their supported defaults for the RED\n * object-graph reader.\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 (Object.hasOwn(options, \"emit\")) values.emit = normalizeEmit(options.emit, readerName);\n    if (Object.hasOwn(options, \"schema\")) values.schema = options.schema ?? null;\n    if (Object.hasOwn(options, \"registry\")) values.registry = options.registry ?? null;\n    if (Object.hasOwn(options, \"firstId\")) values.firstId = options.firstId ?? 1;\n    if (Object.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 (Object.hasOwn(options, \"adapter\")) values.adapter = options.adapter ?? null;\n    if (Object.hasOwn(options, \"payloadTypeField\")) values.payloadTypeField = options.payloadTypeField;\n    if (Object.hasOwn(options, \"payloadIdField\")) values.payloadIdField = options.payloadIdField;\n    if (Object.hasOwn(options, \"payloadReferenceField\")) values.payloadReferenceField = options.payloadReferenceField;\n    if (Object.hasOwn(options, \"payloadValuesField\")) values.payloadValuesField = options.payloadValuesField;\n    if (Object.hasOwn(options, \"classes\")) mergeClasses(values, options.classes, classKeys, readerName);\n    return values;\n}\n\n/** Copies reader options accepted by the current RED object-graph reader. */\nexport function copyReaderOptions(values)\n{\n    const { emit: _emit, schema: _schema, classes: _classes, ...readerOptions } = values;\n    return readerOptions;\n}\n\n/**\n * Converts a parsed payload into a JSON-safe value for the RED object-graph\n * reader.\n */\n/**\n * Convert to JSON, refusing a cycle, naming this reader in the error.\n *\n * @param {*} value Any decoded value.\n * @returns {*} A JSON-safe value.\n */\nexport function toJsonValue(value)\n{\n    return toJsonAcyclic(value, \"Reader\");\n}\n"],"names":["OUTPUT_JSON","OUTPUT_PAYLOAD","OUTPUT_RUNTIME","OUTPUT_RAW","DEFAULT_VALUES","Object","freeze","emit","schema","registry","firstId","parse","adapter","payloadTypeField","payloadIdField","payloadReferenceField","payloadValuesField","classes","OPTION_KEYS","Set","keys","normalizeEmit","readerName","undefined","Error","assertKnownOptions","options","key","has","TypeError","classMap","values","cloneValues","validateClassKey","classKeys","validateClass","type","Class","mergeClasses","next","entries","normalizeValues","base","hasOwn","copyReaderOptions","_emit","_schema","_classes","readerOptions","toJsonValue","value","toJsonAcyclic"],"mappings":"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"}

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

@@ -1,50 +1,51 @@
 import { CjsFormat } from '../../format/CjsFormat.js';
-import { DEFAULT_VALUES, normalizeValues, validateClassKey, validateClass, readWithValues, writeWithValues, inspectWithValues, toJsonValue, OUTPUT_CMF, OUTPUT_GR2, OUTPUT_SHARED, OUTPUT_STL_JSON, OUTPUT_JSON, CLASS_KEYS } from './core/helpers.js';
+import { DEFAULT_VALUES, normalizeValues, validateClassKey, validateClass, readWithValues, writeWithValues, inspectWithValues, OUTPUT_CMF, OUTPUT_GR2, OUTPUT_SHARED, OUTPUT_STL_JSON, OUTPUT_JSON, CLASS_KEYS } from './core/helpers.js';
+import { toJsonWithArrayValues } from '../../format/jsonPolicies.js';
 import { isStl, isBinaryStl } from './core/stl.js';
 
 const FORMAT_NAME = "CjsStlFormat";
 
-/**
- * Shared mesh accepted by the STL writer. STL exports only `vertex.position`
- * and triangular `indices[].faces`; all other shared channels are ignored.
- *
- * @typedef {object} CjsStlSharedMesh
- * @property {string} [name] Diagnostic mesh name; `solidName` controls the STL header.
- * @property {{position: ArrayLike<number>, normal?: ArrayLike<number>}} vertex Shared vertex channels.
- * @property {Array<{name?: string, faces: ArrayLike<number>}>} indices Triangle index groups.
+/**
+ * Shared mesh accepted by the STL writer. STL exports only `vertex.position`
+ * and triangular `indices[].faces`; all other shared channels are ignored.
+ *
+ * @typedef {object} CjsStlSharedMesh
+ * @property {string} [name] Diagnostic mesh name; `solidName` controls the STL header.
+ * @property {{position: ArrayLike<number>, normal?: ArrayLike<number>}} vertex Shared vertex channels.
+ * @property {Array<{name?: string, faces: ArrayLike<number>}>} indices Triangle index groups.
  */
 
-/**
- * Shared geometry root accepted by the STL writer.
- *
- * @typedef {object} CjsStlSharedRoot
- * @property {Array<CjsStlSharedMesh>} meshes Meshes flattened into one STL solid.
- * @property {string} [grannyFileSource] Optional source label used by inspection.
+/**
+ * Shared geometry root accepted by the STL writer.
+ *
+ * @typedef {object} CjsStlSharedRoot
+ * @property {Array<CjsStlSharedMesh>} meshes Meshes flattened into one STL solid.
+ * @property {string} [grannyFileSource] Optional source label used by inspection.
  */
 
-/**
- * Reusable STL read, write, and inspection options.
- *
- * @typedef {object} CjsStlFormatOptions
- * @property {"shared"|"stlJson"|"json"|"gr2"|"cmf"} [emit="stlJson"] Read output contract.
- * @property {string} [source="memory"] Source label stored in read/inspection output.
- * @property {boolean} [binary=true] Whether writes return binary bytes instead of ASCII text.
- * @property {string} [solidName="carbonenginejs"] Sanitized ASCII solid name and binary header label.
- * @property {number} [scale=1] Positive finite multiplier applied to exported positions.
- * @property {boolean} [recalculateNormals=true] Derive facet normals from winding instead of vertex normals.
- * @property {boolean} [weldVertices=false] Weld equal positions while reading STL.
- * @property {number} [weldTolerance=1e-5] Non-negative read/inspection position tolerance.
- * @property {boolean} [skipDegenerate=true] Omit degenerate shared triangles during writes.
- * @property {boolean} [requireWatertight=false] Reject writes with printability topology issues.
- * @property {Record<string, Function>} [classes] Caller constructors used for read hydration.
+/**
+ * Reusable STL read, write, and inspection options.
+ *
+ * @typedef {object} CjsStlFormatOptions
+ * @property {"shared"|"stlJson"|"json"|"gr2"|"cmf"} [emit="stlJson"] Read output contract.
+ * @property {string} [source="memory"] Source label stored in read/inspection output.
+ * @property {boolean} [binary=true] Whether writes return binary bytes instead of ASCII text.
+ * @property {string} [solidName="carbonenginejs"] Sanitized ASCII solid name and binary header label.
+ * @property {number} [scale=1] Positive finite multiplier applied to exported positions.
+ * @property {boolean} [recalculateNormals=true] Derive facet normals from winding instead of vertex normals.
+ * @property {boolean} [weldVertices=false] Weld equal positions while reading STL.
+ * @property {number} [weldTolerance=1e-5] Non-negative read/inspection position tolerance.
+ * @property {boolean} [skipDegenerate=true] Omit degenerate shared triangles during writes.
+ * @property {boolean} [requireWatertight=false] Reject writes with printability topology issues.
+ * @property {Record<string, Function>} [classes] Caller constructors used for read hydration.
  */
 
-/**
- * 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.
+/**
+ * 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 extends CjsFormat {
   #emit = DEFAULT_VALUES.emit;
@@ -59,26 +60,26 @@ class CjsStlFormat extends CjsFormat {
   #requireWatertight = DEFAULT_VALUES.requireWatertight;
   #classes = DEFAULT_VALUES.classes;
 
-  /**
-   * Create a reusable format profile.
-   *
-   * The instance stores only normalized options; each `Read`, `Write`, or
-   * `Inspect` call may provide non-mutating overrides.
-   *
-   * @param {CjsStlFormatOptions} [options={}] Default format values.
-   * @throws {TypeError} If an option, output mode, numeric value, or class map is invalid.
+  /**
+   * Create a reusable format profile.
+   *
+   * The instance stores only normalized options; each `Read`, `Write`, or
+   * `Inspect` call may provide non-mutating overrides.
+   *
+   * @param {CjsStlFormatOptions} [options={}] Default format values.
+   * @throws {TypeError} If an option, output mode, numeric value, or class map is invalid.
    */
   constructor(options = {}) {
     super();
     this.SetValues(options);
   }
 
-  /**
-   * Set format values for this reusable profile.
-   *
-   * @param {CjsStlFormatOptions} [options={}] Values to merge into the profile.
-   * @returns {CjsStlFormat} This format profile.
-   * @throws {TypeError} If an option, output mode, numeric value, or class map is invalid.
+  /**
+   * Set format values for this reusable profile.
+   *
+   * @param {CjsStlFormatOptions} [options={}] Values to merge into the profile.
+   * @returns {CjsStlFormat} This format profile.
+   * @throws {TypeError} If an option, output mode, numeric value, or class map is invalid.
    */
   SetValues(options = {}) {
     const values = normalizeValues(this.GetValues(), options, FORMAT_NAME);
@@ -96,12 +97,12 @@ class CjsStlFormat extends CjsFormat {
     return this;
   }
 
-  /**
-   * Get this profile's current values, optionally with per-call overrides.
-   *
-   * @param {CjsStlFormatOptions} [options={}] Optional values to merge into a copy.
-   * @returns {CjsStlFormatOptions} A validated copy of the effective values.
-   * @throws {TypeError} If an override is invalid.
+  /**
+   * Get this profile's current values, optionally with per-call overrides.
+   *
+   * @param {CjsStlFormatOptions} [options={}] Optional values to merge into a copy.
+   * @returns {CjsStlFormatOptions} A validated copy of the effective values.
+   * @throws {TypeError} If an override is invalid.
    */
   GetValues(options = {}) {
     return normalizeValues({
@@ -119,11 +120,11 @@ class CjsStlFormat extends CjsFormat {
     }, 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.
+  /**
+   * 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({
@@ -131,12 +132,12 @@ class CjsStlFormat extends CjsFormat {
     });
   }
 
-  /**
-   * 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.
+  /**
+   * 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) {
@@ -156,145 +157,145 @@ class CjsStlFormat extends CjsFormat {
     });
   }
 
-  /**
-   * Get a configured node-class constructor.
-   *
-   * @param {string} type Node class key.
-   * @returns {Function|undefined} The registered constructor, if any.
+  /**
+   * 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.
+  /**
+   * 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 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.
-   *
-   * Multiple meshes and index groups are flattened in encounter order because
-   * STL has no portable material or scene hierarchy. Degenerate triangles are
-   * skipped by default. Binary output validates that every coordinate is
-   * representable as float32 rather than silently writing infinities.
-   *
-   * @param {CjsStlSharedRoot|CjsStlSharedMesh} input Shared JSON root or mesh.
-   * @param {CjsStlFormatOptions} [options={}] Per-call writer overrides.
-   * @returns {string|Uint8Array} ASCII STL text or binary STL bytes.
-   * @throws {TypeError|RangeError|Error} If geometry, indices, coordinates, topology, or options are invalid.
+  /**
+   * Write shared JSON geometry as STL with this profile's values.
+   *
+   * Multiple meshes and index groups are flattened in encounter order because
+   * STL has no portable material or scene hierarchy. Degenerate triangles are
+   * skipped by default. Binary output validates that every coordinate is
+   * representable as float32 rather than silently writing infinities.
+   *
+   * @param {CjsStlSharedRoot|CjsStlSharedMesh} input Shared JSON root or mesh.
+   * @param {CjsStlFormatOptions} [options={}] Per-call writer overrides.
+   * @returns {string|Uint8Array} ASCII STL text or binary STL bytes.
+   * @throws {TypeError|RangeError|Error} If geometry, indices, coordinates, topology, or options are invalid.
    */
   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 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.
+  /**
+   * 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);
+    return toJsonWithArrayValues(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 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.
-   *
-   * The call is one-shot and does not mutate `input`. Multiple meshes and
-   * index groups are flattened into a single STL solid in encounter order.
-   *
-   * @param {CjsStlSharedRoot|CjsStlSharedMesh} input Shared JSON root or mesh.
-   * @param {CjsStlFormatOptions} [options={}] Writer values.
-   * @returns {string|Uint8Array} ASCII STL text or binary STL bytes.
-   * @throws {TypeError|RangeError|Error} If geometry, indices, coordinates, topology, or options are invalid.
+  /**
+   * Static one-shot write.
+   *
+   * The call is one-shot and does not mutate `input`. Multiple meshes and
+   * index groups are flattened into a single STL solid in encounter order.
+   *
+   * @param {CjsStlSharedRoot|CjsStlSharedMesh} input Shared JSON root or mesh.
+   * @param {CjsStlFormatOptions} [options={}] Writer values.
+   * @returns {string|Uint8Array} ASCII STL text or binary STL bytes.
+   * @throws {TypeError|RangeError|Error} If geometry, indices, coordinates, topology, or options are invalid.
    */
   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 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 JSON-compatible conversion.
+   *
+   * @param {any} value Format output to convert.
+   * @returns {any} Plain JSON-compatible data.
    */
   static toJSON(value) {
-    return toJsonValue(value);
+    return toJsonWithArrayValues(value);
   }
 
-  /**
-   * Cheap sniff for STL-like input.
-   *
-   * @param {string|Uint8Array|ArrayBuffer|DataView} input Candidate STL input.
-   * @returns {boolean} True when input looks like STL.
+  /**
+   * 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.
+  /**
+   * 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);
   }
 
-  /**
-   * Emit targets for this format (canonical frozen enum).
+  /**
+   * Emit targets for this format (canonical frozen enum).
    */
   static Output = Object.freeze({
     JSON: OUTPUT_JSON,
@@ -306,6 +307,16 @@ class CjsStlFormat extends CjsFormat {
   static CLASS_KEYS = CLASS_KEYS;
   static id = "stl";
   static mediaTypes = Object.freeze(["geometry"]);
+  // STL takes the shared geometry root directly rather than going through
+  // CMF, because it carries triangles and nothing else worth preserving.
+  // Lossless for what STL can represent; everything else was never in scope.
+  static inputs = CjsFormat.defineInputs({
+    shared: {
+      default: true,
+      payloadType: "geometry",
+      options: ["binary", "solidName", "scale", "recalculateNormals", "weldVertices"]
+    }
+  });
   static outputs = CjsFormat.defineOutputs({
     shared: {
       decoded: true