@carbonenginejs/runtime-resource 0.12.2 → 0.14.0

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

@@ -1,4 +1,5 @@
 import { CjsYamlFormat } from '../../yaml/CjsYamlFormat.js';
+import { isYamlSourceInput, toYamlSourceText } from '../../yaml/core/helpers.js';
 
 /**
  * Keys added by authoring tools are prefixed with a double underscore and are
@@ -14,24 +15,26 @@ function isStrippedKey(key) {
 /**
  * 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.
+ * Accepts an already-parsed object (returned as-is), a YAML string, or strict
+ * UTF-8 bytes. 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 {unknown} input Parsed Red object, YAML string, or UTF-8 bytes.
  * @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);
+  if (isYamlSourceInput(input)) {
+    if (typeof options.parse === "function") {
+      return options.parse(toYamlSourceText(input, readerName));
+    }
     return CjsYamlFormat.readRaw(input, {
       tagPolicy: "reject"
     });
   }
-  throw new TypeError(`${readerName}: input must be a parsed Red object or a YAML string.`);
+  if (input && typeof input === "object") return input;
+  throw new TypeError(`${readerName}: input must be a parsed Red object, YAML string, or byte buffer.`);
 }
 
 /**

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

@@ -1 +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;;;;"}
+{"version":3,"file":"redGraph.js","sources":["../../../../../src/formats/red/core/redGraph.js"],"sourcesContent":["import CjsYamlFormat from \"../../yaml/index.js\";\nimport {\n    isYamlSourceInput,\n    toYamlSourceText\n} from \"../../yaml/core/helpers.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), a YAML string, or strict\n * UTF-8 bytes. YAML anchors/aliases resolve to shared object identities, which\n * the reader uses to rebuild the Red reference graph.\n *\n * @param {unknown} input Parsed Red object, YAML string, or UTF-8 bytes.\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 (isYamlSourceInput(input))\n    {\n        if (typeof options.parse === \"function\")\n        {\n            return options.parse(toYamlSourceText(input, readerName));\n        }\n        return CjsYamlFormat.readRaw(input, { tagPolicy: \"reject\" });\n    }\n\n    if (input && typeof input === \"object\") return input;\n\n    throw new TypeError(`${readerName}: input must be a parsed Red object, YAML string, or byte buffer.`);\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","isYamlSourceInput","parse","toYamlSourceText","CjsYamlFormat","readRaw","tagPolicy","TypeError","isTypedTable","node","Boolean","Array","isArray","structure","items","decodeTypedTable","columns","map","column","name","row","record","cells","i","undefined"],"mappings":";;;AAMA;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;AACI,EAAA,IAAIC,iBAAiB,CAACH,KAAK,CAAC,EAC5B;AACI,IAAA,IAAI,OAAOC,OAAO,CAACG,KAAK,KAAK,UAAU,EACvC;MACI,OAAOH,OAAO,CAACG,KAAK,CAACC,gBAAgB,CAACL,KAAK,EAAEE,UAAU,CAAC,CAAC;AAC7D,IAAA;AACA,IAAA,OAAOI,aAAa,CAACC,OAAO,CAACP,KAAK,EAAE;AAAEQ,MAAAA,SAAS,EAAE;AAAS,KAAC,CAAC;AAChE,EAAA;EAEA,IAAIR,KAAK,IAAI,OAAOA,KAAK,KAAK,QAAQ,EAAE,OAAOA,KAAK;AAEpD,EAAA,MAAM,IAAIS,SAAS,CAAC,CAAA,EAAGP,UAAU,mEAAmE,CAAC;AACzG;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASQ,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,CAACpB,MAAM,EAAE2B,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/stl/CjsStlFormat.js

@@ -1,4 +1,4 @@
-import { DEFAULT_VALUES, normalizeValues, validateClassKey, validateClass, readWithValues, writeWithValues, inspectWithValues, toJsonValue, importNodeModule, 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, toJsonValue, OUTPUT_CMF, OUTPUT_GR2, OUTPUT_SHARED, OUTPUT_STL_JSON, OUTPUT_JSON, CLASS_KEYS } from './core/helpers.js';
 import { isStl, isBinaryStl } from './core/stl.js';
 
 /**
@@ -278,51 +278,6 @@ class CjsStlFormat {
     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.
-   *
-   * The file is encoded entirely in memory before the Node-only filesystem
-   * write starts. Browser bundles do not include the filesystem module.
-   *
-   * @param {string} path Path to write.
-   * @param {CjsStlSharedRoot|CjsStlSharedMesh} input Shared JSON root or mesh.
-   * @param {CjsStlFormatOptions} [options={}] Writer values.
-   * @returns {Promise<string>} The written path.
-   * @throws {TypeError|RangeError|Error} If the path, geometry, topology, or options are invalid, or writing fails.
-   */
-  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.
    *

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

@@ -1 +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 * Shared mesh accepted by the STL writer. STL exports only `vertex.position`\n * and triangular `indices[].faces`; all other shared channels are ignored.\n *\n * @typedef {object} CjsStlSharedMesh\n * @property {string} [name] Diagnostic mesh name; `solidName` controls the STL header.\n * @property {{position: ArrayLike<number>, normal?: ArrayLike<number>}} vertex Shared vertex channels.\n * @property {Array<{name?: string, faces: ArrayLike<number>}>} indices Triangle index groups.\n */\n\n/**\n * Shared geometry root accepted by the STL writer.\n *\n * @typedef {object} CjsStlSharedRoot\n * @property {Array<CjsStlSharedMesh>} meshes Meshes flattened into one STL solid.\n * @property {string} [grannyFileSource] Optional source label used by inspection.\n */\n\n/**\n * Reusable STL read, write, and inspection options.\n *\n * @typedef {object} CjsStlFormatOptions\n * @property {\"shared\"|\"stlJson\"|\"json\"|\"gr2\"|\"cmf\"} [emit=\"stlJson\"] Read output contract.\n * @property {string} [source=\"memory\"] Source label stored in read/inspection output.\n * @property {boolean} [binary=true] Whether writes return binary bytes instead of ASCII text.\n * @property {string} [solidName=\"carbonenginejs\"] Sanitized ASCII solid name and binary header label.\n * @property {number} [scale=1] Positive finite multiplier applied to exported positions.\n * @property {boolean} [recalculateNormals=true] Derive facet normals from winding instead of vertex normals.\n * @property {boolean} [weldVertices=false] Weld equal positions while reading STL.\n * @property {number} [weldTolerance=1e-5] Non-negative read/inspection position tolerance.\n * @property {boolean} [skipDegenerate=true] Omit degenerate shared triangles during writes.\n * @property {boolean} [requireWatertight=false] Reject writes with printability topology issues.\n * @property {Record<string, Function>} [classes] Caller constructors used for read hydration.\n */\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     * The instance stores only normalized options; each `Read`, `Write`, or\n     * `Inspect` call may provide non-mutating overrides.\n     *\n     * @param {CjsStlFormatOptions} [options={}] Default format values.\n     * @throws {TypeError} If an option, output mode, numeric value, or class map is invalid.\n     */\n    constructor(options = {})\n    {\n        this.SetValues(options);\n    }\n\n    /**\n     * Set format values for this reusable profile.\n     *\n     * @param {CjsStlFormatOptions} [options={}] Values to merge into the profile.\n     * @returns {CjsStlFormat} This format profile.\n     * @throws {TypeError} If an option, output mode, numeric value, or class map is invalid.\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 {CjsStlFormatOptions} [options={}] Optional values to merge into a copy.\n     * @returns {CjsStlFormatOptions} A validated copy of the effective values.\n     * @throws {TypeError} If an override is invalid.\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     * Multiple meshes and index groups are flattened in encounter order because\n     * STL has no portable material or scene hierarchy. Degenerate triangles are\n     * skipped by default. Binary output validates that every coordinate is\n     * representable as float32 rather than silently writing infinities.\n     *\n     * @param {CjsStlSharedRoot|CjsStlSharedMesh} input Shared JSON root or mesh.\n     * @param {CjsStlFormatOptions} [options={}] Per-call writer overrides.\n     * @returns {string|Uint8Array} ASCII STL text or binary STL bytes.\n     * @throws {TypeError|RangeError|Error} If geometry, indices, coordinates, topology, or options are invalid.\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     * The call is one-shot and does not mutate `input`. Multiple meshes and\n     * index groups are flattened into a single STL solid in encounter order.\n     *\n     * @param {CjsStlSharedRoot|CjsStlSharedMesh} input Shared JSON root or mesh.\n     * @param {CjsStlFormatOptions} [options={}] Writer values.\n     * @returns {string|Uint8Array} ASCII STL text or binary STL bytes.\n     * @throws {TypeError|RangeError|Error} If geometry, indices, coordinates, topology, or options are invalid.\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     * The file is encoded entirely in memory before the Node-only filesystem\n     * write starts. Browser bundles do not include the filesystem module.\n     *\n     * @param {string} path Path to write.\n     * @param {CjsStlSharedRoot|CjsStlSharedMesh} input Shared JSON root or mesh.\n     * @param {CjsStlFormatOptions} [options={}] Writer values.\n     * @returns {Promise<string>} The written path.\n     * @throws {TypeError|RangeError|Error} If the path, geometry, topology, or options are invalid, or writing fails.\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    /**\n     * Emit targets for this format (canonical frozen enum).\n     */\n    static Output = Object.freeze({\n        JSON: OUTPUT_JSON,\n        STL_JSON: OUTPUT_STL_JSON,\n        SHARED: OUTPUT_SHARED,\n        GR2: OUTPUT_GR2,\n        CMF: OUTPUT_CMF\n    });\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","Object","freeze","JSON","OUTPUT_JSON","STL_JSON","OUTPUT_STL_JSON","SHARED","OUTPUT_SHARED","GR2","OUTPUT_GR2","CMF","OUTPUT_CMF","CLASS_KEYS","mediaTypes","inputTypes","outputTypes","debugOutputTypes"],"mappings":"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"}
+{"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    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 * Shared mesh accepted by the STL writer. STL exports only `vertex.position`\n * and triangular `indices[].faces`; all other shared channels are ignored.\n *\n * @typedef {object} CjsStlSharedMesh\n * @property {string} [name] Diagnostic mesh name; `solidName` controls the STL header.\n * @property {{position: ArrayLike<number>, normal?: ArrayLike<number>}} vertex Shared vertex channels.\n * @property {Array<{name?: string, faces: ArrayLike<number>}>} indices Triangle index groups.\n */\n\n/**\n * Shared geometry root accepted by the STL writer.\n *\n * @typedef {object} CjsStlSharedRoot\n * @property {Array<CjsStlSharedMesh>} meshes Meshes flattened into one STL solid.\n * @property {string} [grannyFileSource] Optional source label used by inspection.\n */\n\n/**\n * Reusable STL read, write, and inspection options.\n *\n * @typedef {object} CjsStlFormatOptions\n * @property {\"shared\"|\"stlJson\"|\"json\"|\"gr2\"|\"cmf\"} [emit=\"stlJson\"] Read output contract.\n * @property {string} [source=\"memory\"] Source label stored in read/inspection output.\n * @property {boolean} [binary=true] Whether writes return binary bytes instead of ASCII text.\n * @property {string} [solidName=\"carbonenginejs\"] Sanitized ASCII solid name and binary header label.\n * @property {number} [scale=1] Positive finite multiplier applied to exported positions.\n * @property {boolean} [recalculateNormals=true] Derive facet normals from winding instead of vertex normals.\n * @property {boolean} [weldVertices=false] Weld equal positions while reading STL.\n * @property {number} [weldTolerance=1e-5] Non-negative read/inspection position tolerance.\n * @property {boolean} [skipDegenerate=true] Omit degenerate shared triangles during writes.\n * @property {boolean} [requireWatertight=false] Reject writes with printability topology issues.\n * @property {Record<string, Function>} [classes] Caller constructors used for read hydration.\n */\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     * The instance stores only normalized options; each `Read`, `Write`, or\n     * `Inspect` call may provide non-mutating overrides.\n     *\n     * @param {CjsStlFormatOptions} [options={}] Default format values.\n     * @throws {TypeError} If an option, output mode, numeric value, or class map is invalid.\n     */\n    constructor(options = {})\n    {\n        this.SetValues(options);\n    }\n\n    /**\n     * Set format values for this reusable profile.\n     *\n     * @param {CjsStlFormatOptions} [options={}] Values to merge into the profile.\n     * @returns {CjsStlFormat} This format profile.\n     * @throws {TypeError} If an option, output mode, numeric value, or class map is invalid.\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 {CjsStlFormatOptions} [options={}] Optional values to merge into a copy.\n     * @returns {CjsStlFormatOptions} A validated copy of the effective values.\n     * @throws {TypeError} If an override is invalid.\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     * Multiple meshes and index groups are flattened in encounter order because\n     * STL has no portable material or scene hierarchy. Degenerate triangles are\n     * skipped by default. Binary output validates that every coordinate is\n     * representable as float32 rather than silently writing infinities.\n     *\n     * @param {CjsStlSharedRoot|CjsStlSharedMesh} input Shared JSON root or mesh.\n     * @param {CjsStlFormatOptions} [options={}] Per-call writer overrides.\n     * @returns {string|Uint8Array} ASCII STL text or binary STL bytes.\n     * @throws {TypeError|RangeError|Error} If geometry, indices, coordinates, topology, or options are invalid.\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     * The call is one-shot and does not mutate `input`. Multiple meshes and\n     * index groups are flattened into a single STL solid in encounter order.\n     *\n     * @param {CjsStlSharedRoot|CjsStlSharedMesh} input Shared JSON root or mesh.\n     * @param {CjsStlFormatOptions} [options={}] Writer values.\n     * @returns {string|Uint8Array} ASCII STL text or binary STL bytes.\n     * @throws {TypeError|RangeError|Error} If geometry, indices, coordinates, topology, or options are invalid.\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     * 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    /**\n     * Emit targets for this format (canonical frozen enum).\n     */\n    static Output = Object.freeze({\n        JSON: OUTPUT_JSON,\n        STL_JSON: OUTPUT_STL_JSON,\n        SHARED: OUTPUT_SHARED,\n        GR2: OUTPUT_GR2,\n        CMF: OUTPUT_CMF\n    });\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","isStl","isBinaryStl","Output","Object","freeze","JSON","OUTPUT_JSON","STL_JSON","OUTPUT_STL_JSON","SHARED","OUTPUT_SHARED","GR2","OUTPUT_GR2","CMF","OUTPUT_CMF","CLASS_KEYS","mediaTypes","inputTypes","outputTypes","debugOutputTypes"],"mappings":";;;AAAA;AACA;AACA;AACA;AACA;AACA;;AAqBA,MAAMA,WAAW,GAAG,cAAc;;AAElC;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,MAAMC,YAAY,CACzB;AAEI,EAAA,KAAK,GAAGC,cAAc,CAACC,IAAI;AAC3B,EAAA,OAAO,GAAGD,cAAc,CAACE,MAAM;AAC/B,EAAA,OAAO,GAAGF,cAAc,CAACG,MAAM;AAC/B,EAAA,UAAU,GAAGH,cAAc,CAACI,SAAS;AACrC,EAAA,MAAM,GAAGJ,cAAc,CAACK,KAAK;AAC7B,EAAA,mBAAmB,GAAGL,cAAc,CAACM,kBAAkB;AACvD,EAAA,aAAa,GAAGN,cAAc,CAACO,YAAY;AAC3C,EAAA,cAAc,GAAGP,cAAc,CAACQ,aAAa;AAC7C,EAAA,eAAe,GAAGR,cAAc,CAACS,cAAc;AAC/C,EAAA,kBAAkB,GAAGT,cAAc,CAACU,iBAAiB;AACrD,EAAA,QAAQ,GAAGV,cAAc,CAACW,OAAO;;AAEjC;AACJ;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACIC,EAAAA,WAAWA,CAACC,OAAO,GAAG,EAAE,EACxB;AACI,IAAA,IAAI,CAACC,SAAS,CAACD,OAAO,CAAC;AAC3B,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;AACA;AACIC,EAAAA,SAASA,CAACD,OAAO,GAAG,EAAE,EACtB;AACI,IAAA,MAAME,MAAM,GAAGC,eAAe,CAAC,IAAI,CAACC,SAAS,EAAE,EAAEJ,OAAO,EAAEf,WAAW,CAAC;AAEtE,IAAA,IAAI,CAAC,KAAK,GAAGiB,MAAM,CAACd,IAAI;AACxB,IAAA,IAAI,CAAC,OAAO,GAAGc,MAAM,CAACb,MAAM;AAC5B,IAAA,IAAI,CAAC,OAAO,GAAGa,MAAM,CAACZ,MAAM;AAC5B,IAAA,IAAI,CAAC,UAAU,GAAGY,MAAM,CAACX,SAAS;AAClC,IAAA,IAAI,CAAC,MAAM,GAAGW,MAAM,CAACV,KAAK;AAC1B,IAAA,IAAI,CAAC,mBAAmB,GAAGU,MAAM,CAACT,kBAAkB;AACpD,IAAA,IAAI,CAAC,aAAa,GAAGS,MAAM,CAACR,YAAY;AACxC,IAAA,IAAI,CAAC,cAAc,GAAGQ,MAAM,CAACP,aAAa;AAC1C,IAAA,IAAI,CAAC,eAAe,GAAGO,MAAM,CAACN,cAAc;AAC5C,IAAA,IAAI,CAAC,kBAAkB,GAAGM,MAAM,CAACL,iBAAiB;AAClD,IAAA,IAAI,CAAC,QAAQ,GAAGK,MAAM,CAACJ,OAAO;AAE9B,IAAA,OAAO,IAAI;AACf,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;AACA;AACIM,EAAAA,SAASA,CAACJ,OAAO,GAAG,EAAE,EACtB;AACI,IAAA,OAAOG,eAAe,CAAC;AACnBf,MAAAA,IAAI,EAAE,IAAI,CAAC,KAAK;AAChBC,MAAAA,MAAM,EAAE,IAAI,CAAC,OAAO;AACpBC,MAAAA,MAAM,EAAE,IAAI,CAAC,OAAO;AACpBC,MAAAA,SAAS,EAAE,IAAI,CAAC,UAAU;AAC1BC,MAAAA,KAAK,EAAE,IAAI,CAAC,MAAM;AAClBC,MAAAA,kBAAkB,EAAE,IAAI,CAAC,mBAAmB;AAC5CC,MAAAA,YAAY,EAAE,IAAI,CAAC,aAAa;AAChCC,MAAAA,aAAa,EAAE,IAAI,CAAC,cAAc;AAClCC,MAAAA,cAAc,EAAE,IAAI,CAAC,eAAe;AACpCC,MAAAA,iBAAiB,EAAE,IAAI,CAAC,kBAAkB;MAC1CC,OAAO,EAAE,IAAI,CAAC;AAClB,KAAC,EAAEE,OAAO,EAAEf,WAAW,CAAC;AAC5B,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;AACIoB,EAAAA,UAAUA,CAACP,OAAO,GAAG,EAAE,EACvB;IACI,OAAO,IAAI,CAACG,SAAS,CAAC;AAAEH,MAAAA;AAAQ,KAAC,CAAC;AACtC,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;AACA;AACIQ,EAAAA,QAAQA,CAACC,IAAI,EAAEC,KAAK,EACpB;AACI,IAAA,IAAIA,KAAK,KAAK,IAAI,IAAIA,KAAK,KAAKC,SAAS,EACzC;AACIC,MAAAA,gBAAgB,CAACH,IAAI,EAAEtB,WAAW,CAAC;AACnC,MAAA,MAAMa,OAAO,GAAG;QAAE,GAAG,IAAI,CAAC;OAAU;MACpC,OAAOA,OAAO,CAACS,IAAI,CAAC;AACpB,MAAA,IAAI,CAAC,QAAQ,GAAGT,OAAO;AACvB,MAAA,OAAO,IAAI;AACf,IAAA;AAEAa,IAAAA,aAAa,CAACJ,IAAI,EAAEC,KAAK,EAAEvB,WAAW,CAAC;IACvC,OAAO,IAAI,CAACgB,SAAS,CAAC;AAAEH,MAAAA,OAAO,EAAE;AAAE,QAAA,CAACS,IAAI,GAAGC;AAAM;AAAE,KAAC,CAAC;AACzD,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;EACII,QAAQA,CAACL,IAAI,EACb;AACIG,IAAAA,gBAAgB,CAACH,IAAI,EAAEtB,WAAW,CAAC;AACnC,IAAA,OAAO,IAAI,CAAC,QAAQ,CAACsB,IAAI,CAAC;AAC9B,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;EACIM,QAAQA,CAACN,IAAI,EACb;AACI,IAAA,OAAO,CAAC,CAAC,IAAI,CAACK,QAAQ,CAACL,IAAI,CAAC;AAChC,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;AACA;AACIO,EAAAA,IAAIA,CAACC,KAAK,EAAEf,OAAO,GAAG,EAAE,EACxB;AACI,IAAA,OAAOgB,cAAc,CAAC,IAAI,EAAED,KAAK,EAAE,IAAI,CAACX,SAAS,CAACJ,OAAO,CAAC,CAAC;AAC/D,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACIiB,EAAAA,KAAKA,CAACF,KAAK,EAAEf,OAAO,GAAG,EAAE,EACzB;IACI,OAAOkB,eAAe,CAACH,KAAK,EAAE,IAAI,CAACX,SAAS,CAACJ,OAAO,CAAC,CAAC;AAC1D,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;AACA;AACImB,EAAAA,OAAOA,CAACJ,KAAK,EAAEf,OAAO,GAAG,EAAE,EAC3B;IACI,OAAOoB,iBAAiB,CAACL,KAAK,EAAE,IAAI,CAACX,SAAS,CAACJ,OAAO,CAAC,CAAC;AAC5D,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;EACIqB,MAAMA,CAACC,KAAK,EACZ;IACI,OAAOC,WAAW,CAACD,KAAK,CAAC;AAC7B,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;AACA;EACI,OAAOE,IAAIA,CAACT,KAAK,EAAEf,OAAO,GAAG,EAAE,EAC/B;AACI,IAAA,OAAOgB,cAAc,CAAC9B,YAAY,EAAE6B,KAAK,EAAEZ,eAAe,CAAChB,cAAc,EAAEa,OAAO,EAAEf,WAAW,CAAC,CAAC;AACrG,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;EACI,OAAOwC,KAAKA,CAACV,KAAK,EAAEf,OAAO,GAAG,EAAE,EAChC;AACI,IAAA,OAAOkB,eAAe,CAACH,KAAK,EAAEZ,eAAe,CAAChB,cAAc,EAAEa,OAAO,EAAEf,WAAW,CAAC,CAAC;AACxF,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;AACA;EACI,OAAOyC,OAAOA,CAACX,KAAK,EAAEf,OAAO,GAAG,EAAE,EAClC;AACI,IAAA,OAAOoB,iBAAiB,CAACL,KAAK,EAAEZ,eAAe,CAAChB,cAAc,EAAEa,OAAO,EAAEf,WAAW,CAAC,CAAC;AAC1F,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;EACI,OAAO0C,MAAMA,CAACL,KAAK,EACnB;IACI,OAAOC,WAAW,CAACD,KAAK,CAAC;AAC7B,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;EACI,OAAOM,KAAKA,CAACb,KAAK,EAClB;IACI,OAAOa,KAAK,CAACb,KAAK,CAAC;AACvB,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;EACI,OAAOc,WAAWA,CAACd,KAAK,EACxB;IACI,OAAOc,WAAW,CAACd,KAAK,CAAC;AAC7B,EAAA;;AAEA;AACJ;AACA;AACI,EAAA,OAAOe,MAAM,GAAGC,MAAM,CAACC,MAAM,CAAC;AAC1BC,IAAAA,IAAI,EAAEC,WAAW;AACjBC,IAAAA,QAAQ,EAAEC,eAAe;AACzBC,IAAAA,MAAM,EAAEC,aAAa;AACrBC,IAAAA,GAAG,EAAEC,UAAU;AACfC,IAAAA,GAAG,EAAEC;AACT,GAAC,CAAC;EACF,OAAOC,UAAU,GAAGA,UAAU;EAC9B,OAAOpC,IAAI,GAAGwB,MAAM,CAACC,MAAM,CAAC,CAAE,UAAU,CAAE,CAAC;EAC3C,OAAOY,UAAU,GAAGb,MAAM,CAACC,MAAM,CAAC,CAAE,UAAU,CAAE,CAAC;EACjD,OAAOa,UAAU,GAAGd,MAAM,CAACC,MAAM,CAAC,CAAE,KAAK,CAAE,CAAC;AAC5C,EAAA,OAAOc,WAAW,GAAGf,MAAM,CAACC,MAAM,CAAC,CAAEM,aAAa,EAAEE,UAAU,EAAEE,UAAU,CAAE,CAAC;EAC7E,OAAOK,gBAAgB,GAAGhB,MAAM,CAACC,MAAM,CAAC,CAAEE,WAAW,EAAEE,eAAe,CAAE,CAAC;AAE7E;;;;"}

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

@@ -237,25 +237,5 @@ function toJsonValue(value) {
   return out;
 }
 
-/**
- * Imports a Node built-in module without exposing the specifier to any
- * bundler's static import graph.
- *
- * `await import("node:fs/promises")` written as a literal is resolved
- * eagerly by webpack/Rollup/esbuild alike when they walk the module
- * graph, breaking browser builds even though this path only ever runs
- * under Node (readFile/writeFile are Node-only conveniences). Building
- * the specifier inside a `Function` body hides it from every bundler's
- * static analysis - it only exists at runtime, in the Node process that
- * actually calls readFile/writeFile.
- *
- * @param {string} specifier Node built-in module specifier, e.g. "node:fs/promises".
- * @returns {Promise<any>} The imported module namespace.
- */
-function importNodeModule(specifier) {
-  // eslint-disable-next-line no-new-func
-  return new Function("s", "return import(s)")(specifier);
-}
-
-export { CLASS_KEYS, DEFAULT_VALUES, GR2_CLASS_KEYS, OUTPUT_CMF, OUTPUT_GR2, OUTPUT_JSON, OUTPUT_SHARED, OUTPUT_STL_JSON, importNodeModule, inspectWithValues, normalizeValues, readWithValues, toJsonValue, validateClass, validateClassKey, writeWithValues };
+export { CLASS_KEYS, DEFAULT_VALUES, GR2_CLASS_KEYS, OUTPUT_CMF, OUTPUT_GR2, OUTPUT_JSON, OUTPUT_SHARED, OUTPUT_STL_JSON, inspectWithValues, normalizeValues, readWithValues, toJsonValue, validateClass, validateClassKey, writeWithValues };
 //# sourceMappingURL=helpers.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"helpers.js","sources":["../../../../../src/formats/stl/core/helpers.js"],"sourcesContent":["/**\n * Internal pipeline glue for CjsStlFormat.\n */\n\nimport { hydrateJson } from \"./json.js\";\nimport { buildCmfFromShared, CMF_CLASS_KEYS, hydrateCmf } from \"./targets.js\";\nimport {\n    inspectTriangles,\n    isBinaryStl,\n    isStl,\n    jsonToTriangles,\n    parseStl,\n    toText,\n    trianglesFromInput,\n    trianglesToJson,\n    writeAsciiStl,\n    writeBinaryStl\n} from \"./stl.js\";\n\nexport const GR2_CLASS_KEYS = Object.freeze([\n    \"Root\",\n    \"Mesh\",\n    \"BoneBinding\",\n    \"IndexGroup\",\n    \"MorphTarget\",\n    \"Model\",\n    \"Skeleton\",\n    \"Bone\",\n    \"Animation\",\n    \"TrackGroup\",\n    \"TransformTrack\",\n    \"Curve\"\n]);\n\nexport const CLASS_KEYS = Object.freeze(Array.from(new Set([\n    ...GR2_CLASS_KEYS,\n    ...CMF_CLASS_KEYS\n])));\n\nexport { isBinaryStl, isStl, toText };\n\nexport const OUTPUT_JSON = \"json\";\nexport const OUTPUT_STL_JSON = \"stlJson\";\nexport const OUTPUT_SHARED = \"shared\";\nexport const OUTPUT_GR2 = \"gr2\";\nexport const OUTPUT_CMF = \"cmf\";\n\nexport const DEFAULT_VALUES = Object.freeze({\n    emit: OUTPUT_STL_JSON,\n    source: \"memory\",\n    binary: true,\n    solidName: \"carbonenginejs\",\n    scale: 1,\n    recalculateNormals: true,\n    weldVertices: false,\n    weldTolerance: 1e-5,\n    skipDegenerate: true,\n    requireWatertight: false,\n    classes: Object.freeze({})\n});\n\nconst OPTION_KEYS = new Set([\n    \"emit\",\n    \"source\",\n    \"binary\",\n    \"solidName\",\n    \"scale\",\n    \"recalculateNormals\",\n    \"weldVertices\",\n    \"weldTolerance\",\n    \"skipDegenerate\",\n    \"requireWatertight\",\n    \"classes\"\n]);\n\nfunction validateBoolean(name, value, readerName)\n{\n    if (typeof value === \"boolean\") return value;\n    throw new TypeError(`${readerName}: ${name} must be true or false`);\n}\n\nfunction validateNumber(name, value, readerName, { minExclusive = null, minInclusive = null } = {})\n{\n    if (typeof value !== \"number\" || !Number.isFinite(value))\n    {\n        throw new TypeError(`${readerName}: ${name} must be a finite number`);\n    }\n    if (minExclusive !== null && value <= minExclusive)\n    {\n        throw new TypeError(`${readerName}: ${name} must be greater than ${minExclusive}`);\n    }\n    if (minInclusive !== null && value < minInclusive)\n    {\n        throw new TypeError(`${readerName}: ${name} must be at least ${minInclusive}`);\n    }\n    return value;\n}\n\n/**\n * Validate a `classes` node key against {@link CLASS_KEYS}.\n *\n * @param {string} key Candidate node key.\n * @param {string} [readerName] Format name used in thrown errors.\n */\nexport function validateClassKey(key, readerName = \"CjsStlFormat\")\n{\n    if (!CLASS_KEYS.includes(key))\n    {\n        throw new Error(`${readerName}: unknown class key ${JSON.stringify(key)}; expected one of ${CLASS_KEYS.join(\", \")}`);\n    }\n}\n\n/**\n * Validate a single `classes` entry.\n *\n * @param {string} key Node key.\n * @param {Function} Class Candidate constructor.\n * @param {string} [readerName] Format name used in thrown errors.\n */\nexport function validateClass(key, Class, readerName = \"CjsStlFormat\")\n{\n    validateClassKey(key, readerName);\n    if (typeof Class !== \"function\")\n    {\n        throw new TypeError(`${readerName}: class ${JSON.stringify(key)} must be a constructor`);\n    }\n}\n\nfunction mergeClasses(base, classes, 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 = { ...base };\n    for (const [ key, Class ] of Object.entries(classes))\n    {\n        if (Class === null || Class === undefined)\n        {\n            delete next[key];\n            continue;\n        }\n        validateClass(key, Class, readerName);\n        next[key] = Class;\n    }\n    return next;\n}\n\nfunction sanitizeName(value)\n{\n    if (typeof value !== \"string\" || !value.trim()) return DEFAULT_VALUES.solidName;\n    return value.trim();\n}\n\n/**\n * Merge format values over a base set and validate them.\n *\n * @param {object} base Current values.\n * @param {object} [options] Values to merge in.\n * @param {string} [readerName] Format name used in error messages.\n * @returns {object} A validated copy of the merged values.\n */\nexport function normalizeValues(base, options = {}, readerName = \"CjsStlFormat\")\n{\n    if (!options || typeof options !== \"object\")\n    {\n        throw new TypeError(`${readerName}: options must be an object`);\n    }\n    for (const key of Object.keys(options))\n    {\n        if (!OPTION_KEYS.has(key))\n        {\n            throw new TypeError(`${readerName}: unknown option ${JSON.stringify(key)}`);\n        }\n    }\n\n    const values = { ...base, ...options };\n    const emit = normalizeEmit(values.emit, readerName);\n    const classes = Object.prototype.hasOwnProperty.call(options, \"classes\")\n        ? mergeClasses(base.classes || {}, options.classes, readerName)\n        : { ...(base.classes || {}) };\n    if ((emit === OUTPUT_GR2 || emit === OUTPUT_CMF) && !hasClasses(classes))\n    {\n        throw new TypeError(`${readerName}: emit \"${emit}\" requires explicit classes`);\n    }\n    if (typeof values.source !== \"string\" || !values.source)\n    {\n        values.source = DEFAULT_VALUES.source;\n    }\n\n    return {\n        emit,\n        source: values.source,\n        binary: validateBoolean(\"binary\", values.binary, readerName),\n        solidName: sanitizeName(values.solidName),\n        scale: validateNumber(\"scale\", values.scale, readerName, { minExclusive: 0 }),\n        recalculateNormals: validateBoolean(\"recalculateNormals\", values.recalculateNormals, readerName),\n        weldVertices: validateBoolean(\"weldVertices\", values.weldVertices, readerName),\n        weldTolerance: validateNumber(\"weldTolerance\", values.weldTolerance, readerName, { minInclusive: 0 }),\n        skipDegenerate: validateBoolean(\"skipDegenerate\", values.skipDegenerate, readerName),\n        requireWatertight: validateBoolean(\"requireWatertight\", values.requireWatertight, readerName),\n        classes\n    };\n}\n\nfunction normalizeEmit(emit, readerName)\n{\n    if (emit === undefined || emit === null || emit === OUTPUT_JSON || emit === OUTPUT_STL_JSON || emit === OUTPUT_SHARED)\n    {\n        return OUTPUT_STL_JSON;\n    }\n    if (emit === OUTPUT_GR2 || emit === OUTPUT_CMF) return emit;\n    throw new TypeError(`${readerName}: emit must be \"${OUTPUT_SHARED}\", \"${OUTPUT_STL_JSON}\", \"${OUTPUT_GR2}\", or \"${OUTPUT_CMF}\", got ${JSON.stringify(emit)}`);\n}\n\nfunction hasClasses(classes)\n{\n    return !!classes && Object.values(classes).some((Class) => typeof Class === \"function\");\n}\n\n/**\n * Read STL text/bytes and return the shared JSON schema.\n *\n * @param {object|Function} format Format instance or constructor.\n * @param {string|Uint8Array|ArrayBuffer|DataView} input STL text or bytes.\n * @param {object} values Normalized format values.\n * @returns {object} Shared JSON graph.\n */\nexport function readWithValues(format, input, values)\n{\n    void format;\n    const parsed = parseStl(input);\n    const json = trianglesToJson(parsed.triangles, values, parsed);\n    if (values.emit === OUTPUT_CMF) return hydrateCmf(buildCmfFromShared(json), values.classes, { source: values.source });\n    return hydrateJson(json, { classes: values.classes, source: values.source });\n}\n\n/**\n * Write the shared JSON geometry schema to STL.\n * The input is read-only. Meshes and index groups are flattened by\n * {@link jsonToTriangles}; optional topology enforcement runs against that\n * exact scaled triangle stream before encoding begins.\n *\n * @param {object} input Shared JSON root or mesh.\n * @param {object} values Normalized format values.\n * @returns {string|Uint8Array} ASCII STL text or binary STL bytes.\n * @throws {TypeError|RangeError|Error} If geometry, numeric values, indices, topology, or binary range are invalid.\n */\nexport function writeWithValues(input, values)\n{\n    const triangles = jsonToTriangles(input, values);\n    if (!triangles.length)\n    {\n        throw new Error(\"CjsStlFormat: write input did not produce any triangles\");\n    }\n\n    if (values.requireWatertight)\n    {\n        const report = inspectTriangles(triangles, values, { format: \"json\", source: input.grannyFileSource || values.source });\n        if (!report.printable)\n        {\n            throw new Error(`CjsStlFormat: requireWatertight failed (${report.issues.map(issue => issue.key).join(\", \")})`);\n        }\n    }\n\n    return values.binary\n        ? writeBinaryStl(triangles, values.solidName)\n        : writeAsciiStl(triangles, values.solidName);\n}\n\n/**\n * Inspect STL or shared JSON geometry without class hydration.\n *\n * @param {any} input STL text/bytes or shared JSON.\n * @param {object} values Normalized format values.\n * @returns {object} Plain printability report.\n */\nexport function inspectWithValues(input, values)\n{\n    const source = trianglesFromInput(input, values);\n    return inspectTriangles(source.triangles, values, source);\n}\n\n/**\n * Convert format output to plain JSON-compatible data.\n *\n * @param {any} value Format output.\n * @returns {any} JSON-compatible value.\n */\nexport function toJsonValue(value)\n{\n    if (value === null || value === undefined) return value;\n    if (typeof value !== \"object\") return value;\n\n    if (typeof value.toJSON === \"function\")\n    {\n        const next = value.toJSON();\n        if (next !== value) return toJsonValue(next);\n    }\n\n    if (Array.isArray(value)) return value.map(toJsonValue);\n    if (ArrayBuffer.isView(value) && !(value instanceof DataView)) return Array.from(value);\n\n    const out = {};\n    for (const key of Object.keys(value))\n    {\n        out[key] = toJsonValue(value[key]);\n    }\n    return out;\n}\n\n/**\n * Imports a Node built-in module without exposing the specifier to any\n * bundler's static import graph.\n *\n * `await import(\"node:fs/promises\")` written as a literal is resolved\n * eagerly by webpack/Rollup/esbuild alike when they walk the module\n * graph, breaking browser builds even though this path only ever runs\n * under Node (readFile/writeFile are Node-only conveniences). Building\n * the specifier inside a `Function` body hides it from every bundler's\n * static analysis - it only exists at runtime, in the Node process that\n * actually calls readFile/writeFile.\n *\n * @param {string} specifier Node built-in module specifier, e.g. \"node:fs/promises\".\n * @returns {Promise<any>} The imported module namespace.\n */\nexport function importNodeModule(specifier)\n{\n    // eslint-disable-next-line no-new-func\n    return new Function(\"s\", \"return import(s)\")(specifier);\n}\n"],"names":["GR2_CLASS_KEYS","Object","freeze","CLASS_KEYS","Array","from","Set","CMF_CLASS_KEYS","OUTPUT_JSON","OUTPUT_STL_JSON","OUTPUT_SHARED","OUTPUT_GR2","OUTPUT_CMF","DEFAULT_VALUES","emit","source","binary","solidName","scale","recalculateNormals","weldVertices","weldTolerance","skipDegenerate","requireWatertight","classes","OPTION_KEYS","validateBoolean","name","value","readerName","TypeError","validateNumber","minExclusive","minInclusive","Number","isFinite","validateClassKey","key","includes","Error","JSON","stringify","join","validateClass","Class","mergeClasses","base","next","entries","undefined","sanitizeName","trim","normalizeValues","options","keys","has","values","normalizeEmit","prototype","hasOwnProperty","call","hasClasses","some","readWithValues","format","input","parsed","parseStl","json","trianglesToJson","triangles","hydrateCmf","buildCmfFromShared","hydrateJson","writeWithValues","jsonToTriangles","length","report","inspectTriangles","grannyFileSource","printable","issues","map","issue","writeBinaryStl","writeAsciiStl","inspectWithValues","trianglesFromInput","toJsonValue","toJSON","isArray","ArrayBuffer","isView","DataView","out","importNodeModule","specifier","Function"],"mappings":"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"}
+{"version":3,"file":"helpers.js","sources":["../../../../../src/formats/stl/core/helpers.js"],"sourcesContent":["/**\n * Internal pipeline glue for CjsStlFormat.\n */\n\nimport { hydrateJson } from \"./json.js\";\nimport { buildCmfFromShared, CMF_CLASS_KEYS, hydrateCmf } from \"./targets.js\";\nimport {\n    inspectTriangles,\n    isBinaryStl,\n    isStl,\n    jsonToTriangles,\n    parseStl,\n    toText,\n    trianglesFromInput,\n    trianglesToJson,\n    writeAsciiStl,\n    writeBinaryStl\n} from \"./stl.js\";\n\nexport const GR2_CLASS_KEYS = Object.freeze([\n    \"Root\",\n    \"Mesh\",\n    \"BoneBinding\",\n    \"IndexGroup\",\n    \"MorphTarget\",\n    \"Model\",\n    \"Skeleton\",\n    \"Bone\",\n    \"Animation\",\n    \"TrackGroup\",\n    \"TransformTrack\",\n    \"Curve\"\n]);\n\nexport const CLASS_KEYS = Object.freeze(Array.from(new Set([\n    ...GR2_CLASS_KEYS,\n    ...CMF_CLASS_KEYS\n])));\n\nexport { isBinaryStl, isStl, toText };\n\nexport const OUTPUT_JSON = \"json\";\nexport const OUTPUT_STL_JSON = \"stlJson\";\nexport const OUTPUT_SHARED = \"shared\";\nexport const OUTPUT_GR2 = \"gr2\";\nexport const OUTPUT_CMF = \"cmf\";\n\nexport const DEFAULT_VALUES = Object.freeze({\n    emit: OUTPUT_STL_JSON,\n    source: \"memory\",\n    binary: true,\n    solidName: \"carbonenginejs\",\n    scale: 1,\n    recalculateNormals: true,\n    weldVertices: false,\n    weldTolerance: 1e-5,\n    skipDegenerate: true,\n    requireWatertight: false,\n    classes: Object.freeze({})\n});\n\nconst OPTION_KEYS = new Set([\n    \"emit\",\n    \"source\",\n    \"binary\",\n    \"solidName\",\n    \"scale\",\n    \"recalculateNormals\",\n    \"weldVertices\",\n    \"weldTolerance\",\n    \"skipDegenerate\",\n    \"requireWatertight\",\n    \"classes\"\n]);\n\nfunction validateBoolean(name, value, readerName)\n{\n    if (typeof value === \"boolean\") return value;\n    throw new TypeError(`${readerName}: ${name} must be true or false`);\n}\n\nfunction validateNumber(name, value, readerName, { minExclusive = null, minInclusive = null } = {})\n{\n    if (typeof value !== \"number\" || !Number.isFinite(value))\n    {\n        throw new TypeError(`${readerName}: ${name} must be a finite number`);\n    }\n    if (minExclusive !== null && value <= minExclusive)\n    {\n        throw new TypeError(`${readerName}: ${name} must be greater than ${minExclusive}`);\n    }\n    if (minInclusive !== null && value < minInclusive)\n    {\n        throw new TypeError(`${readerName}: ${name} must be at least ${minInclusive}`);\n    }\n    return value;\n}\n\n/**\n * Validate a `classes` node key against {@link CLASS_KEYS}.\n *\n * @param {string} key Candidate node key.\n * @param {string} [readerName] Format name used in thrown errors.\n */\nexport function validateClassKey(key, readerName = \"CjsStlFormat\")\n{\n    if (!CLASS_KEYS.includes(key))\n    {\n        throw new Error(`${readerName}: unknown class key ${JSON.stringify(key)}; expected one of ${CLASS_KEYS.join(\", \")}`);\n    }\n}\n\n/**\n * Validate a single `classes` entry.\n *\n * @param {string} key Node key.\n * @param {Function} Class Candidate constructor.\n * @param {string} [readerName] Format name used in thrown errors.\n */\nexport function validateClass(key, Class, readerName = \"CjsStlFormat\")\n{\n    validateClassKey(key, readerName);\n    if (typeof Class !== \"function\")\n    {\n        throw new TypeError(`${readerName}: class ${JSON.stringify(key)} must be a constructor`);\n    }\n}\n\nfunction mergeClasses(base, classes, 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 = { ...base };\n    for (const [ key, Class ] of Object.entries(classes))\n    {\n        if (Class === null || Class === undefined)\n        {\n            delete next[key];\n            continue;\n        }\n        validateClass(key, Class, readerName);\n        next[key] = Class;\n    }\n    return next;\n}\n\nfunction sanitizeName(value)\n{\n    if (typeof value !== \"string\" || !value.trim()) return DEFAULT_VALUES.solidName;\n    return value.trim();\n}\n\n/**\n * Merge format values over a base set and validate them.\n *\n * @param {object} base Current values.\n * @param {object} [options] Values to merge in.\n * @param {string} [readerName] Format name used in error messages.\n * @returns {object} A validated copy of the merged values.\n */\nexport function normalizeValues(base, options = {}, readerName = \"CjsStlFormat\")\n{\n    if (!options || typeof options !== \"object\")\n    {\n        throw new TypeError(`${readerName}: options must be an object`);\n    }\n    for (const key of Object.keys(options))\n    {\n        if (!OPTION_KEYS.has(key))\n        {\n            throw new TypeError(`${readerName}: unknown option ${JSON.stringify(key)}`);\n        }\n    }\n\n    const values = { ...base, ...options };\n    const emit = normalizeEmit(values.emit, readerName);\n    const classes = Object.prototype.hasOwnProperty.call(options, \"classes\")\n        ? mergeClasses(base.classes || {}, options.classes, readerName)\n        : { ...(base.classes || {}) };\n    if ((emit === OUTPUT_GR2 || emit === OUTPUT_CMF) && !hasClasses(classes))\n    {\n        throw new TypeError(`${readerName}: emit \"${emit}\" requires explicit classes`);\n    }\n    if (typeof values.source !== \"string\" || !values.source)\n    {\n        values.source = DEFAULT_VALUES.source;\n    }\n\n    return {\n        emit,\n        source: values.source,\n        binary: validateBoolean(\"binary\", values.binary, readerName),\n        solidName: sanitizeName(values.solidName),\n        scale: validateNumber(\"scale\", values.scale, readerName, { minExclusive: 0 }),\n        recalculateNormals: validateBoolean(\"recalculateNormals\", values.recalculateNormals, readerName),\n        weldVertices: validateBoolean(\"weldVertices\", values.weldVertices, readerName),\n        weldTolerance: validateNumber(\"weldTolerance\", values.weldTolerance, readerName, { minInclusive: 0 }),\n        skipDegenerate: validateBoolean(\"skipDegenerate\", values.skipDegenerate, readerName),\n        requireWatertight: validateBoolean(\"requireWatertight\", values.requireWatertight, readerName),\n        classes\n    };\n}\n\nfunction normalizeEmit(emit, readerName)\n{\n    if (emit === undefined || emit === null || emit === OUTPUT_JSON || emit === OUTPUT_STL_JSON || emit === OUTPUT_SHARED)\n    {\n        return OUTPUT_STL_JSON;\n    }\n    if (emit === OUTPUT_GR2 || emit === OUTPUT_CMF) return emit;\n    throw new TypeError(`${readerName}: emit must be \"${OUTPUT_SHARED}\", \"${OUTPUT_STL_JSON}\", \"${OUTPUT_GR2}\", or \"${OUTPUT_CMF}\", got ${JSON.stringify(emit)}`);\n}\n\nfunction hasClasses(classes)\n{\n    return !!classes && Object.values(classes).some((Class) => typeof Class === \"function\");\n}\n\n/**\n * Read STL text/bytes and return the shared JSON schema.\n *\n * @param {object|Function} format Format instance or constructor.\n * @param {string|Uint8Array|ArrayBuffer|DataView} input STL text or bytes.\n * @param {object} values Normalized format values.\n * @returns {object} Shared JSON graph.\n */\nexport function readWithValues(format, input, values)\n{\n    void format;\n    const parsed = parseStl(input);\n    const json = trianglesToJson(parsed.triangles, values, parsed);\n    if (values.emit === OUTPUT_CMF) return hydrateCmf(buildCmfFromShared(json), values.classes, { source: values.source });\n    return hydrateJson(json, { classes: values.classes, source: values.source });\n}\n\n/**\n * Write the shared JSON geometry schema to STL.\n * The input is read-only. Meshes and index groups are flattened by\n * {@link jsonToTriangles}; optional topology enforcement runs against that\n * exact scaled triangle stream before encoding begins.\n *\n * @param {object} input Shared JSON root or mesh.\n * @param {object} values Normalized format values.\n * @returns {string|Uint8Array} ASCII STL text or binary STL bytes.\n * @throws {TypeError|RangeError|Error} If geometry, numeric values, indices, topology, or binary range are invalid.\n */\nexport function writeWithValues(input, values)\n{\n    const triangles = jsonToTriangles(input, values);\n    if (!triangles.length)\n    {\n        throw new Error(\"CjsStlFormat: write input did not produce any triangles\");\n    }\n\n    if (values.requireWatertight)\n    {\n        const report = inspectTriangles(triangles, values, { format: \"json\", source: input.grannyFileSource || values.source });\n        if (!report.printable)\n        {\n            throw new Error(`CjsStlFormat: requireWatertight failed (${report.issues.map(issue => issue.key).join(\", \")})`);\n        }\n    }\n\n    return values.binary\n        ? writeBinaryStl(triangles, values.solidName)\n        : writeAsciiStl(triangles, values.solidName);\n}\n\n/**\n * Inspect STL or shared JSON geometry without class hydration.\n *\n * @param {any} input STL text/bytes or shared JSON.\n * @param {object} values Normalized format values.\n * @returns {object} Plain printability report.\n */\nexport function inspectWithValues(input, values)\n{\n    const source = trianglesFromInput(input, values);\n    return inspectTriangles(source.triangles, values, source);\n}\n\n/**\n * Convert format output to plain JSON-compatible data.\n *\n * @param {any} value Format output.\n * @returns {any} JSON-compatible value.\n */\nexport function toJsonValue(value)\n{\n    if (value === null || value === undefined) return value;\n    if (typeof value !== \"object\") return value;\n\n    if (typeof value.toJSON === \"function\")\n    {\n        const next = value.toJSON();\n        if (next !== value) return toJsonValue(next);\n    }\n\n    if (Array.isArray(value)) return value.map(toJsonValue);\n    if (ArrayBuffer.isView(value) && !(value instanceof DataView)) return Array.from(value);\n\n    const out = {};\n    for (const key of Object.keys(value))\n    {\n        out[key] = toJsonValue(value[key]);\n    }\n    return out;\n}\n\n"],"names":["GR2_CLASS_KEYS","Object","freeze","CLASS_KEYS","Array","from","Set","CMF_CLASS_KEYS","OUTPUT_JSON","OUTPUT_STL_JSON","OUTPUT_SHARED","OUTPUT_GR2","OUTPUT_CMF","DEFAULT_VALUES","emit","source","binary","solidName","scale","recalculateNormals","weldVertices","weldTolerance","skipDegenerate","requireWatertight","classes","OPTION_KEYS","validateBoolean","name","value","readerName","TypeError","validateNumber","minExclusive","minInclusive","Number","isFinite","validateClassKey","key","includes","Error","JSON","stringify","join","validateClass","Class","mergeClasses","base","next","entries","undefined","sanitizeName","trim","normalizeValues","options","keys","has","values","normalizeEmit","prototype","hasOwnProperty","call","hasClasses","some","readWithValues","format","input","parsed","parseStl","json","trianglesToJson","triangles","hydrateCmf","buildCmfFromShared","hydrateJson","writeWithValues","jsonToTriangles","length","report","inspectTriangles","grannyFileSource","printable","issues","map","issue","writeBinaryStl","writeAsciiStl","inspectWithValues","trianglesFromInput","toJsonValue","toJSON","isArray","ArrayBuffer","isView","DataView","out"],"mappings":"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"}

package/dist/formats/webgl/CjsWebglFormat.js

@@ -1,30 +1,30 @@
-import { DEFAULT_VALUES, normalizeValues, readWithValues, inspectWithValues, buildPackage, emitGlslWithOptions, toJsonValue, isCewg, OUTPUT_JSON, OUTPUT_RAW } from './core/helpers.js';
+import { DEFAULT_VALUES, normalizeValues, emitGlslWithOptions, toJsonValue, isWebglEffectContainer, OUTPUT_JSON } from './core/helpers.js';
 import { buildEffectPackage } from './core/effectPackage.js';
+import { readGlslEffectContainer } from './core/readGlslEffectContainer.js';
+import { inspectGlslEffectContainer } from './core/inspectGlslEffectContainer.js';
 
 /**
  * Exposed CarbonEngineJS-facing WebGL format class.
  *
- * Keep this file small and reviewable: CEWG container parsing lives under
- * src/core/cewg (internal parsing machinery, not part of this package's
- * public surface); the DXBC-to-GLSL ES 3.00 emitter lives under
- * src/core/glsl; input/option normalization and the shared read/build/emit
- * paths live in src/core/helpers.js.
+ * Keep this file small and reviewable: container decoding lives in
+ * core/readGlslEffectContainer.js, summarising in
+ * core/inspectGlslEffectContainer.js, the DXBC-to-GLSL ES 3.00 emitter under
+ * core/glsl, and option normalization in core/helpers.js.
  */
 
 const FORMAT_NAME = "CjsWebglFormat";
 
 /**
- * CarbonEngineJS-facing format surface for `.cewg` WebGL shader packages, and
+ * CarbonEngineJS-facing format surface for `.carbonwebgl` WebGL shader packages, and
  * a DXBC -> GLSL ES 3.00 emitter for the WebGL2 vertex/pixel/map-style-compute
  * stages ccpwgl targets.
  *
- * The Cjs prefix marks this as a JavaScript format/construction boundary.
- * CEWG is a CarbonEngineJS-invented container format (flat four-byte-tagged
- * chunks: `INFO`/`META`/`GLSL`/...), not a Microsoft or CCP one. `Read`
- * parses a package to plain JSON by default (`emit: "raw"` exposes the live
- * `CewgPackage` instance instead); `Inspect` is a cheap chunk/shader-count
- * summary; `Build` assembles package bytes from chunk payloads; `EmitGlsl`
- * translates one DXBC vertex/pixel/map-style-compute stage to GLSL ES 3.00.
+ * The Cjs prefix marks this as a JavaScript format/construction boundary. A
+ * WebGL effect is a stock Carbon effect container whose stored programs are
+ * GLSL ES 3.00 - the same file shape Carbon ships for its own backends, and the
+ * same one WebGPU emits with WGSL. `Read` decodes one into stage and shader
+ * records; `Inspect` is a cheap structural summary; `BuildEffect` translates a
+ * compiled Tr2 effect into one; `EmitGlsl` translates a single DXBC stage.
  */
 class CjsWebglFormat {
   #emit = DEFAULT_VALUES.emit;
@@ -66,35 +66,25 @@ class CjsWebglFormat {
   }
 
   /**
-   * Read a CEWG package with this profile's values.
+   * Decode an effect container into stage and shader records.
    *
-   * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input CEWG package bytes.
+   * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input Container bytes.
    * @param {object} [options] Per-call value overrides.
-   * @returns {object} Plain JSON data, or the raw CewgPackage instance when emit is "raw".
+   * @returns {object} Stage graph in the completeness rules' vocabulary.
    */
   Read(input, options = {}) {
-    return readWithValues(input, this.GetValues(options));
+    return readGlslEffectContainer(input, this.GetValues(options));
   }
 
   /**
-   * Inspect a CEWG package without building the full JSON shape.
+   * Summarise an effect container without decoding every body's records.
    *
-   * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input CEWG package bytes.
+   * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input Container bytes.
    * @param {object} [options] Per-call value overrides.
    * @returns {object} Plain summary data.
    */
   Inspect(input, options = {}) {
-    return inspectWithValues(input, this.GetValues(options));
-  }
-
-  /**
-   * Assembles a CEWG package from ordered chunk payloads.
-   *
-   * @param {Array<[string, string|object|Uint8Array|ArrayBuffer|ArrayBufferView]>} chunks Ordered package chunks.
-   * @returns {Uint8Array} Package bytes.
-   */
-  Build(chunks) {
-    return buildPackage(chunks);
+    return inspectGlslEffectContainer(input, this.GetValues(options));
   }
 
   /**
@@ -109,7 +99,7 @@ class CjsWebglFormat {
   }
 
   /**
-   * Builds a complete CEWG package from compiled Tr2 effect bytes.
+   * Builds a complete effect container from compiled Tr2 effect bytes.
    *
    * @param {Uint8Array|ArrayBuffer|ArrayBufferView} input Compiled effect bytes.
    * @param {object} [options] Selection, provenance, and emitter policy.
@@ -133,42 +123,32 @@ class CjsWebglFormat {
    * Static payload sniff. Static methods use camelCase by convention.
    *
    * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input Candidate bytes.
-   * @returns {boolean} True when the payload starts with the CEWG magic.
+   * @returns {boolean} True when the payload has the container shape.
    */
-  static isCewg(input) {
-    return isCewg(input);
+  static isWebglEffectContainer(input) {
+    return isWebglEffectContainer(input);
   }
 
   /**
-   * Static one-shot read.
+   * Static one-shot container decode.
    *
-   * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input CEWG package bytes.
+   * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input Container bytes.
    * @param {object} [options] Format values.
-   * @returns {object} Plain JSON data, or the raw CewgPackage instance when emit is "raw".
+   * @returns {object} Stage graph in the completeness rules' vocabulary.
    */
   static read(input, options = {}) {
-    return readWithValues(input, normalizeValues(DEFAULT_VALUES, options, FORMAT_NAME));
+    return readGlslEffectContainer(input, normalizeValues(DEFAULT_VALUES, options, FORMAT_NAME));
   }
 
   /**
    * Static one-shot inspection.
    *
-   * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input CEWG package bytes.
+   * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input Container bytes.
    * @param {object} [options] Format values.
    * @returns {object} Plain summary data.
    */
   static inspect(input, options = {}) {
-    return inspectWithValues(input, normalizeValues(DEFAULT_VALUES, options, FORMAT_NAME));
-  }
-
-  /**
-   * Static one-shot package build.
-   *
-   * @param {Array<[string, string|object|Uint8Array|ArrayBuffer|ArrayBufferView]>} chunks Ordered package chunks.
-   * @returns {Uint8Array} Package bytes.
-   */
-  static build(chunks) {
-    return buildPackage(chunks);
+    return inspectGlslEffectContainer(input, normalizeValues(DEFAULT_VALUES, options, FORMAT_NAME));
   }
 
   /**
@@ -188,7 +168,7 @@ class CjsWebglFormat {
   }
 
   /**
-   * Static whole-effect CEWG builder.
+   * Static whole-effect container builder.
    *
    * @param {Uint8Array|ArrayBuffer|ArrayBufferView} input Compiled effect bytes.
    * @param {object} [options] Selection, provenance, and emitter policy.
@@ -208,12 +188,10 @@ class CjsWebglFormat {
     return toJsonValue(value);
   }
   static OUTPUT_JSON = OUTPUT_JSON;
-  static OUTPUT_RAW = OUTPUT_RAW;
   static type = Object.freeze(["shader"]);
   static mediaTypes = Object.freeze(["shader"]);
-  static inputTypes = Object.freeze(["cewg"]);
+  static inputTypes = Object.freeze(["carbonwebgl"]);
   static outputTypes = Object.freeze([OUTPUT_JSON]);
-  static debugOutputTypes = Object.freeze([OUTPUT_RAW]);
   static packageVersion = "0.2.0";
 }
 

package/dist/formats/webgl/CjsWebglFormat.js.map

@@ -1 +1 @@
-{"version":3,"file":"CjsWebglFormat.js","sources":["../../../../src/formats/webgl/CjsWebglFormat.js"],"sourcesContent":["/**\n * Exposed CarbonEngineJS-facing WebGL format class.\n *\n * Keep this file small and reviewable: CEWG container parsing lives under\n * src/core/cewg (internal parsing machinery, not part of this package's\n * public surface); the DXBC-to-GLSL ES 3.00 emitter lives under\n * src/core/glsl; input/option normalization and the shared read/build/emit\n * paths live in src/core/helpers.js.\n */\n\nimport {\n    DEFAULT_VALUES,\n    OUTPUT_JSON,\n    OUTPUT_RAW,\n    buildPackage,\n    emitGlslWithOptions,\n    inspectWithValues,\n    isCewg,\n    normalizeValues,\n    readWithValues,\n    toJsonValue\n} from \"./core/helpers.js\";\nimport { buildEffectPackage } from \"./core/effectPackage.js\";\n\nconst FORMAT_NAME = \"CjsWebglFormat\";\n\n/**\n * CarbonEngineJS-facing format surface for `.cewg` WebGL shader packages, and\n * a DXBC -> GLSL ES 3.00 emitter for the WebGL2 vertex/pixel/map-style-compute\n * stages ccpwgl targets.\n *\n * The Cjs prefix marks this as a JavaScript format/construction boundary.\n * CEWG is a CarbonEngineJS-invented container format (flat four-byte-tagged\n * chunks: `INFO`/`META`/`GLSL`/...), not a Microsoft or CCP one. `Read`\n * parses a package to plain JSON by default (`emit: \"raw\"` exposes the live\n * `CewgPackage` instance instead); `Inspect` is a cheap chunk/shader-count\n * summary; `Build` assembles package bytes from chunk payloads; `EmitGlsl`\n * translates one DXBC vertex/pixel/map-style-compute stage to GLSL ES 3.00.\n */\nexport class CjsWebglFormat\n{\n\n    #emit = DEFAULT_VALUES.emit;\n    #source = DEFAULT_VALUES.source;\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 {CjsWebglFormat} 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\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        }, options, FORMAT_NAME);\n    }\n\n    /**\n     * Read a CEWG package with this profile's values.\n     *\n     * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input CEWG package bytes.\n     * @param {object} [options] Per-call value overrides.\n     * @returns {object} Plain JSON data, or the raw CewgPackage instance when emit is \"raw\".\n     */\n    Read(input, options = {})\n    {\n        return readWithValues(input, this.GetValues(options));\n    }\n\n    /**\n     * Inspect a CEWG package without building the full JSON shape.\n     *\n     * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input CEWG package bytes.\n     * @param {object} [options] Per-call value overrides.\n     * @returns {object} Plain summary data.\n     */\n    Inspect(input, options = {})\n    {\n        return inspectWithValues(input, this.GetValues(options));\n    }\n\n    /**\n     * Assembles a CEWG package from ordered chunk payloads.\n     *\n     * @param {Array<[string, string|object|Uint8Array|ArrayBuffer|ArrayBufferView]>} chunks Ordered package chunks.\n     * @returns {Uint8Array} Package bytes.\n     */\n    Build(chunks)\n    {\n        return buildPackage(chunks);\n    }\n\n    /**\n     * Translates one DXBC vertex/pixel/map-style-compute stage into GLSL ES 3.00.\n     *\n     * @param {ArrayBuffer|ArrayBufferView|Uint8Array} dxbcBytes DXBC container bytes.\n     * @param {object} [options] Combined ccpwgl-profile/emit options. See {@link CjsWebglFormat.emitGlsl}.\n     * @returns {object} GLSL text plus the IO contract the packaging layer records.\n     */\n    EmitGlsl(dxbcBytes, options = {})\n    {\n        return emitGlslWithOptions(dxbcBytes, options);\n    }\n\n    /**\n     * Builds a complete CEWG package from compiled Tr2 effect bytes.\n     *\n     * @param {Uint8Array|ArrayBuffer|ArrayBufferView} input Compiled effect bytes.\n     * @param {object} [options] Selection, provenance, and emitter policy.\n     * @returns {object} Package bytes plus inspection and qualification records.\n     */\n    BuildEffect(input, options = {})\n    {\n        return buildEffectPackage(input, options);\n    }\n\n    /**\n     * Instance JSON-compatible conversion.\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 payload sniff. Static methods use camelCase by convention.\n     *\n     * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input Candidate bytes.\n     * @returns {boolean} True when the payload starts with the CEWG magic.\n     */\n    static isCewg(input)\n    {\n        return isCewg(input);\n    }\n\n    /**\n     * Static one-shot read.\n     *\n     * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input CEWG package bytes.\n     * @param {object} [options] Format values.\n     * @returns {object} Plain JSON data, or the raw CewgPackage instance when emit is \"raw\".\n     */\n    static read(input, options = {})\n    {\n        return readWithValues(input, normalizeValues(DEFAULT_VALUES, options, FORMAT_NAME));\n    }\n\n    /**\n     * Static one-shot inspection.\n     *\n     * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input CEWG package bytes.\n     * @param {object} [options] Format values.\n     * @returns {object} Plain summary data.\n     */\n    static inspect(input, options = {})\n    {\n        return inspectWithValues(input, normalizeValues(DEFAULT_VALUES, options, FORMAT_NAME));\n    }\n\n    /**\n     * Static one-shot package build.\n     *\n     * @param {Array<[string, string|object|Uint8Array|ArrayBuffer|ArrayBufferView]>} chunks Ordered package chunks.\n     * @returns {Uint8Array} Package bytes.\n     */\n    static build(chunks)\n    {\n        return buildPackage(chunks);\n    }\n\n    /**\n     * Static one-shot DXBC-to-GLSL emission.\n     *\n     * @param {ArrayBuffer|ArrayBufferView|Uint8Array} dxbcBytes DXBC container bytes.\n     * @param {object} [options] Combined ccpwgl-profile/emit options: `constantBufferStyle`\n     *   (`\"array\"` (default) uniform `vec4[]` for ccpwgl's uniform4fv path, or `\"std140\"`),\n     *   `pixelConstantBufferRemap` (default `{ 0: 7 }`, pixel-stage cb slot renames),\n     *   `samplerName(register, stageName)` (naming function), `vertexStructuredCapacity`\n     *   (default 69, bone-array element capacity), `dataTextureWidth` (default 2048),\n     *   `pairVaryings` (per-call varying zero-fill list), `source` (per-call error-detail name).\n     * @returns {object} GLSL text plus the IO contract the packaging layer records.\n     */\n    static emitGlsl(dxbcBytes, options = {})\n    {\n        return emitGlslWithOptions(dxbcBytes, options);\n    }\n\n    /**\n     * Static whole-effect CEWG builder.\n     *\n     * @param {Uint8Array|ArrayBuffer|ArrayBufferView} input Compiled effect bytes.\n     * @param {object} [options] Selection, provenance, and emitter policy.\n     * @returns {object} Package bytes plus inspection and qualification records.\n     */\n    static buildEffect(input, options = {})\n    {\n        return buildEffectPackage(input, options);\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    static OUTPUT_JSON = OUTPUT_JSON;\n    static OUTPUT_RAW = OUTPUT_RAW;\n    static type = Object.freeze([ \"shader\" ]);\n    static mediaTypes = Object.freeze([ \"shader\" ]);\n    static inputTypes = Object.freeze([ \"cewg\" ]);\n    static outputTypes = Object.freeze([ OUTPUT_JSON ]);\n    static debugOutputTypes = Object.freeze([ OUTPUT_RAW ]);\n    static packageVersion = \"0.2.0\";\n\n}\n\nexport default CjsWebglFormat;\n"],"names":["FORMAT_NAME","CjsWebglFormat","DEFAULT_VALUES","emit","source","constructor","options","SetValues","values","normalizeValues","GetValues","Read","input","readWithValues","Inspect","inspectWithValues","Build","chunks","buildPackage","EmitGlsl","dxbcBytes","emitGlslWithOptions","BuildEffect","buildEffectPackage","ToJSON","value","toJsonValue","isCewg","read","inspect","build","emitGlsl","buildEffect","toJSON","OUTPUT_JSON","OUTPUT_RAW","type","Object","freeze","mediaTypes","inputTypes","outputTypes","debugOutputTypes","packageVersion"],"mappings":"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"}
+{"version":3,"file":"CjsWebglFormat.js","sources":["../../../../src/formats/webgl/CjsWebglFormat.js"],"sourcesContent":["/**\n * Exposed CarbonEngineJS-facing WebGL format class.\n *\n * Keep this file small and reviewable: container decoding lives in\n * core/readGlslEffectContainer.js, summarising in\n * core/inspectGlslEffectContainer.js, the DXBC-to-GLSL ES 3.00 emitter under\n * core/glsl, and option normalization in core/helpers.js.\n */\n\nimport {\n    DEFAULT_VALUES,\n    OUTPUT_JSON,\n    emitGlslWithOptions,\n    isWebglEffectContainer,\n    normalizeValues,\n    toJsonValue\n} from \"./core/helpers.js\";\nimport { buildEffectPackage } from \"./core/effectPackage.js\";\nimport { readGlslEffectContainer } from \"./core/readGlslEffectContainer.js\";\nimport { inspectGlslEffectContainer } from \"./core/inspectGlslEffectContainer.js\";\n\nconst FORMAT_NAME = \"CjsWebglFormat\";\n\n/**\n * CarbonEngineJS-facing format surface for `.carbonwebgl` WebGL shader packages, and\n * a DXBC -> GLSL ES 3.00 emitter for the WebGL2 vertex/pixel/map-style-compute\n * stages ccpwgl targets.\n *\n * The Cjs prefix marks this as a JavaScript format/construction boundary. A\n * WebGL effect is a stock Carbon effect container whose stored programs are\n * GLSL ES 3.00 - the same file shape Carbon ships for its own backends, and the\n * same one WebGPU emits with WGSL. `Read` decodes one into stage and shader\n * records; `Inspect` is a cheap structural summary; `BuildEffect` translates a\n * compiled Tr2 effect into one; `EmitGlsl` translates a single DXBC stage.\n */\nexport class CjsWebglFormat\n{\n\n    #emit = DEFAULT_VALUES.emit;\n    #source = DEFAULT_VALUES.source;\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 {CjsWebglFormat} 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\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        }, options, FORMAT_NAME);\n    }\n\n    /**\n     * Decode an effect container into stage and shader records.\n     *\n     * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input Container bytes.\n     * @param {object} [options] Per-call value overrides.\n     * @returns {object} Stage graph in the completeness rules' vocabulary.\n     */\n    Read(input, options = {})\n    {\n        return readGlslEffectContainer(input, this.GetValues(options));\n    }\n\n    /**\n     * Summarise an effect container without decoding every body's records.\n     *\n     * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input Container bytes.\n     * @param {object} [options] Per-call value overrides.\n     * @returns {object} Plain summary data.\n     */\n    Inspect(input, options = {})\n    {\n        return inspectGlslEffectContainer(input, this.GetValues(options));\n    }\n\n    /**\n     * Translates one DXBC vertex/pixel/map-style-compute stage into GLSL ES 3.00.\n     *\n     * @param {ArrayBuffer|ArrayBufferView|Uint8Array} dxbcBytes DXBC container bytes.\n     * @param {object} [options] Combined ccpwgl-profile/emit options. See {@link CjsWebglFormat.emitGlsl}.\n     * @returns {object} GLSL text plus the IO contract the packaging layer records.\n     */\n    EmitGlsl(dxbcBytes, options = {})\n    {\n        return emitGlslWithOptions(dxbcBytes, options);\n    }\n\n    /**\n     * Builds a complete effect container from compiled Tr2 effect bytes.\n     *\n     * @param {Uint8Array|ArrayBuffer|ArrayBufferView} input Compiled effect bytes.\n     * @param {object} [options] Selection, provenance, and emitter policy.\n     * @returns {object} Package bytes plus inspection and qualification records.\n     */\n    BuildEffect(input, options = {})\n    {\n        return buildEffectPackage(input, options);\n    }\n\n    /**\n     * Instance JSON-compatible conversion.\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 payload sniff. Static methods use camelCase by convention.\n     *\n     * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input Candidate bytes.\n     * @returns {boolean} True when the payload has the container shape.\n     */\n    static isWebglEffectContainer(input)\n    {\n        return isWebglEffectContainer(input);\n    }\n\n    /**\n     * Static one-shot container decode.\n     *\n     * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input Container bytes.\n     * @param {object} [options] Format values.\n     * @returns {object} Stage graph in the completeness rules' vocabulary.\n     */\n    static read(input, options = {})\n    {\n        return readGlslEffectContainer(input, normalizeValues(DEFAULT_VALUES, options, FORMAT_NAME));\n    }\n\n    /**\n     * Static one-shot inspection.\n     *\n     * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input Container bytes.\n     * @param {object} [options] Format values.\n     * @returns {object} Plain summary data.\n     */\n    static inspect(input, options = {})\n    {\n        return inspectGlslEffectContainer(input, normalizeValues(DEFAULT_VALUES, options, FORMAT_NAME));\n    }\n\n    /**\n     * Static one-shot DXBC-to-GLSL emission.\n     *\n     * @param {ArrayBuffer|ArrayBufferView|Uint8Array} dxbcBytes DXBC container bytes.\n     * @param {object} [options] Combined ccpwgl-profile/emit options: `constantBufferStyle`\n     *   (`\"array\"` (default) uniform `vec4[]` for ccpwgl's uniform4fv path, or `\"std140\"`),\n     *   `pixelConstantBufferRemap` (default `{ 0: 7 }`, pixel-stage cb slot renames),\n     *   `samplerName(register, stageName)` (naming function), `vertexStructuredCapacity`\n     *   (default 69, bone-array element capacity), `dataTextureWidth` (default 2048),\n     *   `pairVaryings` (per-call varying zero-fill list), `source` (per-call error-detail name).\n     * @returns {object} GLSL text plus the IO contract the packaging layer records.\n     */\n    static emitGlsl(dxbcBytes, options = {})\n    {\n        return emitGlslWithOptions(dxbcBytes, options);\n    }\n\n    /**\n     * Static whole-effect container builder.\n     *\n     * @param {Uint8Array|ArrayBuffer|ArrayBufferView} input Compiled effect bytes.\n     * @param {object} [options] Selection, provenance, and emitter policy.\n     * @returns {object} Package bytes plus inspection and qualification records.\n     */\n    static buildEffect(input, options = {})\n    {\n        return buildEffectPackage(input, options);\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    static OUTPUT_JSON = OUTPUT_JSON;\n    static type = Object.freeze([ \"shader\" ]);\n    static mediaTypes = Object.freeze([ \"shader\" ]);\n    static inputTypes = Object.freeze([ \"carbonwebgl\" ]);\n    static outputTypes = Object.freeze([ OUTPUT_JSON ]);\n    static packageVersion = \"0.2.0\";\n\n}\n\nexport default CjsWebglFormat;\n"],"names":["FORMAT_NAME","CjsWebglFormat","DEFAULT_VALUES","emit","source","constructor","options","SetValues","values","normalizeValues","GetValues","Read","input","readGlslEffectContainer","Inspect","inspectGlslEffectContainer","EmitGlsl","dxbcBytes","emitGlslWithOptions","BuildEffect","buildEffectPackage","ToJSON","value","toJsonValue","isWebglEffectContainer","read","inspect","emitGlsl","buildEffect","toJSON","OUTPUT_JSON","type","Object","freeze","mediaTypes","inputTypes","outputTypes","packageVersion"],"mappings":"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"}