@carbonenginejs/runtime-resource 0.1.0 → 0.8.0

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

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

@@ -1,257 +1,261 @@
-import { hydrateJson } from './json.js';
-import { CMF_CLASS_KEYS, hydrateCmf, buildCmfFromShared } from './targets.js';
-import { parseStl, trianglesToJson, jsonToTriangles, inspectTriangles, writeBinaryStl, writeAsciiStl, trianglesFromInput } from './stl.js';
-export { isBinaryStl, isStl, toText } from './stl.js';
-
-/**
- * Internal pipeline glue for CjsStlFormat.
- */
-
-const GR2_CLASS_KEYS = Object.freeze(["Root", "Mesh", "BoneBinding", "IndexGroup", "MorphTarget", "Model", "Skeleton", "Bone", "Animation", "TrackGroup", "TransformTrack", "Curve"]);
-const CLASS_KEYS = Object.freeze(Array.from(new Set([...GR2_CLASS_KEYS, ...CMF_CLASS_KEYS])));
-const OUTPUT_JSON = "json";
-const OUTPUT_STL_JSON = "stlJson";
-const OUTPUT_SHARED = "shared";
-const OUTPUT_GR2 = "gr2";
-const OUTPUT_CMF = "cmf";
-const DEFAULT_VALUES = Object.freeze({
-  emit: OUTPUT_STL_JSON,
-  source: "memory",
-  binary: true,
-  solidName: "carbonenginejs",
-  scale: 1,
-  recalculateNormals: true,
-  weldVertices: false,
-  weldTolerance: 1e-5,
-  skipDegenerate: true,
-  requireWatertight: false,
-  classes: Object.freeze({})
-});
-const OPTION_KEYS = new Set(["emit", "source", "binary", "solidName", "scale", "recalculateNormals", "weldVertices", "weldTolerance", "skipDegenerate", "requireWatertight", "classes"]);
-function validateBoolean(name, value, readerName) {
-  if (typeof value === "boolean") return value;
-  throw new TypeError(`${readerName}: ${name} must be true or false`);
-}
-function validateNumber(name, value, readerName, {
-  minExclusive = null,
-  minInclusive = null
-} = {}) {
-  if (typeof value !== "number" || !Number.isFinite(value)) {
-    throw new TypeError(`${readerName}: ${name} must be a finite number`);
-  }
-  if (minExclusive !== null && value <= minExclusive) {
-    throw new TypeError(`${readerName}: ${name} must be greater than ${minExclusive}`);
-  }
-  if (minInclusive !== null && value < minInclusive) {
-    throw new TypeError(`${readerName}: ${name} must be at least ${minInclusive}`);
-  }
-  return value;
-}
-
-/**
- * Validate a `classes` node key against {@link CLASS_KEYS}.
- *
- * @param {string} key Candidate node key.
- * @param {string} [readerName] Format name used in thrown errors.
- */
-function validateClassKey(key, readerName = "CjsStlFormat") {
-  if (!CLASS_KEYS.includes(key)) {
-    throw new Error(`${readerName}: unknown class key ${JSON.stringify(key)}; expected one of ${CLASS_KEYS.join(", ")}`);
-  }
-}
-
-/**
- * Validate a single `classes` entry.
- *
- * @param {string} key Node key.
- * @param {Function} Class Candidate constructor.
- * @param {string} [readerName] Format name used in thrown errors.
- */
-function validateClass(key, Class, readerName = "CjsStlFormat") {
-  validateClassKey(key, readerName);
-  if (typeof Class !== "function") {
-    throw new TypeError(`${readerName}: class ${JSON.stringify(key)} must be a constructor`);
-  }
-}
-function mergeClasses(base, classes, readerName) {
-  if (!classes || typeof classes !== "object") {
-    throw new TypeError(`${readerName}: classes option must be an object`);
-  }
-  const next = {
-    ...base
-  };
-  for (const [key, Class] of Object.entries(classes)) {
-    if (Class === null || Class === undefined) {
-      delete next[key];
-      continue;
-    }
-    validateClass(key, Class, readerName);
-    next[key] = Class;
-  }
-  return next;
-}
-function sanitizeName(value) {
-  if (typeof value !== "string" || !value.trim()) return DEFAULT_VALUES.solidName;
-  return value.trim();
-}
-
-/**
- * Merge format values over a base set and validate them.
- *
- * @param {object} base Current values.
- * @param {object} [options] Values to merge in.
- * @param {string} [readerName] Format name used in error messages.
- * @returns {object} A validated copy of the merged values.
- */
-function normalizeValues(base, options = {}, readerName = "CjsStlFormat") {
-  if (!options || typeof options !== "object") {
-    throw new TypeError(`${readerName}: options must be an object`);
-  }
-  for (const key of Object.keys(options)) {
-    if (!OPTION_KEYS.has(key)) {
-      throw new TypeError(`${readerName}: unknown option ${JSON.stringify(key)}`);
-    }
-  }
-  const values = {
-    ...base,
-    ...options
-  };
-  const emit = normalizeEmit(values.emit, readerName);
-  const classes = Object.prototype.hasOwnProperty.call(options, "classes") ? mergeClasses(base.classes || {}, options.classes, readerName) : {
-    ...(base.classes || {})
-  };
-  if ((emit === OUTPUT_GR2 || emit === OUTPUT_CMF) && !hasClasses(classes)) {
-    throw new TypeError(`${readerName}: emit "${emit}" requires explicit classes`);
-  }
-  if (typeof values.source !== "string" || !values.source) {
-    values.source = DEFAULT_VALUES.source;
-  }
-  return {
-    emit,
-    source: values.source,
-    binary: validateBoolean("binary", values.binary, readerName),
-    solidName: sanitizeName(values.solidName),
-    scale: validateNumber("scale", values.scale, readerName, {
-      minExclusive: 0
-    }),
-    recalculateNormals: validateBoolean("recalculateNormals", values.recalculateNormals, readerName),
-    weldVertices: validateBoolean("weldVertices", values.weldVertices, readerName),
-    weldTolerance: validateNumber("weldTolerance", values.weldTolerance, readerName, {
-      minInclusive: 0
-    }),
-    skipDegenerate: validateBoolean("skipDegenerate", values.skipDegenerate, readerName),
-    requireWatertight: validateBoolean("requireWatertight", values.requireWatertight, readerName),
-    classes
-  };
-}
-function normalizeEmit(emit, readerName) {
-  if (emit === undefined || emit === null || emit === OUTPUT_JSON || emit === OUTPUT_STL_JSON || emit === OUTPUT_SHARED) {
-    return OUTPUT_STL_JSON;
-  }
-  if (emit === OUTPUT_GR2 || emit === OUTPUT_CMF) return emit;
-  throw new TypeError(`${readerName}: emit must be "${OUTPUT_SHARED}", "${OUTPUT_STL_JSON}", "${OUTPUT_GR2}", or "${OUTPUT_CMF}", got ${JSON.stringify(emit)}`);
-}
-function hasClasses(classes) {
-  return !!classes && Object.values(classes).some(Class => typeof Class === "function");
-}
-
-/**
- * Read STL text/bytes and return the shared JSON schema.
- *
- * @param {object|Function} format Format instance or constructor.
- * @param {string|Uint8Array|ArrayBuffer|DataView} input STL text or bytes.
- * @param {object} values Normalized format values.
- * @returns {object} Shared JSON graph.
- */
-function readWithValues(format, input, values) {
-  const parsed = parseStl(input);
-  const json = trianglesToJson(parsed.triangles, values, parsed);
-  if (values.emit === OUTPUT_CMF) return hydrateCmf(buildCmfFromShared(json), values.classes, {
-    source: values.source
-  });
-  return hydrateJson(json, {
-    classes: values.classes,
-    source: values.source
-  });
-}
-
-/**
- * Write the shared JSON geometry schema to STL.
- *
- * @param {object} input Shared JSON root or mesh.
- * @param {object} values Normalized format values.
- * @returns {string|Uint8Array} ASCII STL text or binary STL bytes.
- */
-function writeWithValues(input, values) {
-  const triangles = jsonToTriangles(input, values);
-  if (!triangles.length) {
-    throw new Error("CjsStlFormat: write input did not produce any triangles");
-  }
-  if (values.requireWatertight) {
-    const report = inspectTriangles(triangles, values, {
-      format: "json",
-      source: input.grannyFileSource || values.source
-    });
-    if (!report.printable) {
-      throw new Error(`CjsStlFormat: requireWatertight failed (${report.issues.map(issue => issue.key).join(", ")})`);
-    }
-  }
-  return values.binary ? writeBinaryStl(triangles, values.solidName) : writeAsciiStl(triangles, values.solidName);
-}
-
-/**
- * Inspect STL or shared JSON geometry without class hydration.
- *
- * @param {any} input STL text/bytes or shared JSON.
- * @param {object} values Normalized format values.
- * @returns {object} Plain printability report.
- */
-function inspectWithValues(input, values) {
-  const source = trianglesFromInput(input, values);
-  return inspectTriangles(source.triangles, values, source);
-}
-
-/**
- * Convert format output to plain JSON-compatible data.
- *
- * @param {any} value Format output.
- * @returns {any} JSON-compatible value.
- */
-function toJsonValue(value) {
-  if (value === null || value === undefined) return value;
-  if (typeof value !== "object") return value;
-  if (typeof value.toJSON === "function") {
-    const next = value.toJSON();
-    if (next !== value) return toJsonValue(next);
-  }
-  if (Array.isArray(value)) return value.map(toJsonValue);
-  if (ArrayBuffer.isView(value) && !(value instanceof DataView)) return Array.from(value);
-  const out = {};
-  for (const key of Object.keys(value)) {
-    out[key] = toJsonValue(value[key]);
-  }
-  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 };
-//# sourceMappingURL=helpers.js.map
+import { hydrateJson } from './json.js';
+import { CMF_CLASS_KEYS, hydrateCmf, buildCmfFromShared } from './targets.js';
+import { parseStl, trianglesToJson, jsonToTriangles, inspectTriangles, writeBinaryStl, writeAsciiStl, trianglesFromInput } from './stl.js';
+export { isBinaryStl, isStl, toText } from './stl.js';
+
+/**
+ * Internal pipeline glue for CjsStlFormat.
+ */
+
+const GR2_CLASS_KEYS = Object.freeze(["Root", "Mesh", "BoneBinding", "IndexGroup", "MorphTarget", "Model", "Skeleton", "Bone", "Animation", "TrackGroup", "TransformTrack", "Curve"]);
+const CLASS_KEYS = Object.freeze(Array.from(new Set([...GR2_CLASS_KEYS, ...CMF_CLASS_KEYS])));
+const OUTPUT_JSON = "json";
+const OUTPUT_STL_JSON = "stlJson";
+const OUTPUT_SHARED = "shared";
+const OUTPUT_GR2 = "gr2";
+const OUTPUT_CMF = "cmf";
+const DEFAULT_VALUES = Object.freeze({
+  emit: OUTPUT_STL_JSON,
+  source: "memory",
+  binary: true,
+  solidName: "carbonenginejs",
+  scale: 1,
+  recalculateNormals: true,
+  weldVertices: false,
+  weldTolerance: 1e-5,
+  skipDegenerate: true,
+  requireWatertight: false,
+  classes: Object.freeze({})
+});
+const OPTION_KEYS = new Set(["emit", "source", "binary", "solidName", "scale", "recalculateNormals", "weldVertices", "weldTolerance", "skipDegenerate", "requireWatertight", "classes"]);
+function validateBoolean(name, value, readerName) {
+  if (typeof value === "boolean") return value;
+  throw new TypeError(`${readerName}: ${name} must be true or false`);
+}
+function validateNumber(name, value, readerName, {
+  minExclusive = null,
+  minInclusive = null
+} = {}) {
+  if (typeof value !== "number" || !Number.isFinite(value)) {
+    throw new TypeError(`${readerName}: ${name} must be a finite number`);
+  }
+  if (minExclusive !== null && value <= minExclusive) {
+    throw new TypeError(`${readerName}: ${name} must be greater than ${minExclusive}`);
+  }
+  if (minInclusive !== null && value < minInclusive) {
+    throw new TypeError(`${readerName}: ${name} must be at least ${minInclusive}`);
+  }
+  return value;
+}
+
+/**
+ * Validate a `classes` node key against {@link CLASS_KEYS}.
+ *
+ * @param {string} key Candidate node key.
+ * @param {string} [readerName] Format name used in thrown errors.
+ */
+function validateClassKey(key, readerName = "CjsStlFormat") {
+  if (!CLASS_KEYS.includes(key)) {
+    throw new Error(`${readerName}: unknown class key ${JSON.stringify(key)}; expected one of ${CLASS_KEYS.join(", ")}`);
+  }
+}
+
+/**
+ * Validate a single `classes` entry.
+ *
+ * @param {string} key Node key.
+ * @param {Function} Class Candidate constructor.
+ * @param {string} [readerName] Format name used in thrown errors.
+ */
+function validateClass(key, Class, readerName = "CjsStlFormat") {
+  validateClassKey(key, readerName);
+  if (typeof Class !== "function") {
+    throw new TypeError(`${readerName}: class ${JSON.stringify(key)} must be a constructor`);
+  }
+}
+function mergeClasses(base, classes, readerName) {
+  if (!classes || typeof classes !== "object") {
+    throw new TypeError(`${readerName}: classes option must be an object`);
+  }
+  const next = {
+    ...base
+  };
+  for (const [key, Class] of Object.entries(classes)) {
+    if (Class === null || Class === undefined) {
+      delete next[key];
+      continue;
+    }
+    validateClass(key, Class, readerName);
+    next[key] = Class;
+  }
+  return next;
+}
+function sanitizeName(value) {
+  if (typeof value !== "string" || !value.trim()) return DEFAULT_VALUES.solidName;
+  return value.trim();
+}
+
+/**
+ * Merge format values over a base set and validate them.
+ *
+ * @param {object} base Current values.
+ * @param {object} [options] Values to merge in.
+ * @param {string} [readerName] Format name used in error messages.
+ * @returns {object} A validated copy of the merged values.
+ */
+function normalizeValues(base, options = {}, readerName = "CjsStlFormat") {
+  if (!options || typeof options !== "object") {
+    throw new TypeError(`${readerName}: options must be an object`);
+  }
+  for (const key of Object.keys(options)) {
+    if (!OPTION_KEYS.has(key)) {
+      throw new TypeError(`${readerName}: unknown option ${JSON.stringify(key)}`);
+    }
+  }
+  const values = {
+    ...base,
+    ...options
+  };
+  const emit = normalizeEmit(values.emit, readerName);
+  const classes = Object.prototype.hasOwnProperty.call(options, "classes") ? mergeClasses(base.classes || {}, options.classes, readerName) : {
+    ...(base.classes || {})
+  };
+  if ((emit === OUTPUT_GR2 || emit === OUTPUT_CMF) && !hasClasses(classes)) {
+    throw new TypeError(`${readerName}: emit "${emit}" requires explicit classes`);
+  }
+  if (typeof values.source !== "string" || !values.source) {
+    values.source = DEFAULT_VALUES.source;
+  }
+  return {
+    emit,
+    source: values.source,
+    binary: validateBoolean("binary", values.binary, readerName),
+    solidName: sanitizeName(values.solidName),
+    scale: validateNumber("scale", values.scale, readerName, {
+      minExclusive: 0
+    }),
+    recalculateNormals: validateBoolean("recalculateNormals", values.recalculateNormals, readerName),
+    weldVertices: validateBoolean("weldVertices", values.weldVertices, readerName),
+    weldTolerance: validateNumber("weldTolerance", values.weldTolerance, readerName, {
+      minInclusive: 0
+    }),
+    skipDegenerate: validateBoolean("skipDegenerate", values.skipDegenerate, readerName),
+    requireWatertight: validateBoolean("requireWatertight", values.requireWatertight, readerName),
+    classes
+  };
+}
+function normalizeEmit(emit, readerName) {
+  if (emit === undefined || emit === null || emit === OUTPUT_JSON || emit === OUTPUT_STL_JSON || emit === OUTPUT_SHARED) {
+    return OUTPUT_STL_JSON;
+  }
+  if (emit === OUTPUT_GR2 || emit === OUTPUT_CMF) return emit;
+  throw new TypeError(`${readerName}: emit must be "${OUTPUT_SHARED}", "${OUTPUT_STL_JSON}", "${OUTPUT_GR2}", or "${OUTPUT_CMF}", got ${JSON.stringify(emit)}`);
+}
+function hasClasses(classes) {
+  return !!classes && Object.values(classes).some(Class => typeof Class === "function");
+}
+
+/**
+ * Read STL text/bytes and return the shared JSON schema.
+ *
+ * @param {object|Function} format Format instance or constructor.
+ * @param {string|Uint8Array|ArrayBuffer|DataView} input STL text or bytes.
+ * @param {object} values Normalized format values.
+ * @returns {object} Shared JSON graph.
+ */
+function readWithValues(format, input, values) {
+  const parsed = parseStl(input);
+  const json = trianglesToJson(parsed.triangles, values, parsed);
+  if (values.emit === OUTPUT_CMF) return hydrateCmf(buildCmfFromShared(json), values.classes, {
+    source: values.source
+  });
+  return hydrateJson(json, {
+    classes: values.classes,
+    source: values.source
+  });
+}
+
+/**
+ * Write the shared JSON geometry schema to STL.
+ * The input is read-only. Meshes and index groups are flattened by
+ * {@link jsonToTriangles}; optional topology enforcement runs against that
+ * exact scaled triangle stream before encoding begins.
+ *
+ * @param {object} input Shared JSON root or mesh.
+ * @param {object} values Normalized format values.
+ * @returns {string|Uint8Array} ASCII STL text or binary STL bytes.
+ * @throws {TypeError|RangeError|Error} If geometry, numeric values, indices, topology, or binary range are invalid.
+ */
+function writeWithValues(input, values) {
+  const triangles = jsonToTriangles(input, values);
+  if (!triangles.length) {
+    throw new Error("CjsStlFormat: write input did not produce any triangles");
+  }
+  if (values.requireWatertight) {
+    const report = inspectTriangles(triangles, values, {
+      format: "json",
+      source: input.grannyFileSource || values.source
+    });
+    if (!report.printable) {
+      throw new Error(`CjsStlFormat: requireWatertight failed (${report.issues.map(issue => issue.key).join(", ")})`);
+    }
+  }
+  return values.binary ? writeBinaryStl(triangles, values.solidName) : writeAsciiStl(triangles, values.solidName);
+}
+
+/**
+ * Inspect STL or shared JSON geometry without class hydration.
+ *
+ * @param {any} input STL text/bytes or shared JSON.
+ * @param {object} values Normalized format values.
+ * @returns {object} Plain printability report.
+ */
+function inspectWithValues(input, values) {
+  const source = trianglesFromInput(input, values);
+  return inspectTriangles(source.triangles, values, source);
+}
+
+/**
+ * Convert format output to plain JSON-compatible data.
+ *
+ * @param {any} value Format output.
+ * @returns {any} JSON-compatible value.
+ */
+function toJsonValue(value) {
+  if (value === null || value === undefined) return value;
+  if (typeof value !== "object") return value;
+  if (typeof value.toJSON === "function") {
+    const next = value.toJSON();
+    if (next !== value) return toJsonValue(next);
+  }
+  if (Array.isArray(value)) return value.map(toJsonValue);
+  if (ArrayBuffer.isView(value) && !(value instanceof DataView)) return Array.from(value);
+  const out = {};
+  for (const key of Object.keys(value)) {
+    out[key] = toJsonValue(value[key]);
+  }
+  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 };
+//# sourceMappingURL=helpers.js.map