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

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

@@ -1 +1 @@
-{"version":3,"file":"CjsStlFormat.js","sources":["../../../../../src/resource/formats/stl/CjsStlFormat.js"],"sourcesContent":["import { CjsFormat } from \"../../format/CjsFormat.js\";\r\n/**\r\n * Exposed CarbonEngineJS-facing STL format class.\r\n *\r\n * Keep this file small and reviewable: STL parsing, writing, printability\r\n * inspection, option normalization, and JSON hydration live under src/core.\r\n */\r\n\r\nimport {\r\n    CLASS_KEYS,\r\n    DEFAULT_VALUES,\r\n    OUTPUT_CMF,\r\n    OUTPUT_GR2,\r\n    OUTPUT_JSON,\r\n    OUTPUT_SHARED,\r\n    OUTPUT_STL_JSON,\r\n    inspectWithValues,\r\n    isBinaryStl,\r\n    isStl,\r\n    normalizeValues,\r\n    readWithValues,\r\n    toJsonValue,\r\n    validateClass,\r\n    validateClassKey,\r\n    writeWithValues\r\n} from \"./core/helpers.js\";\r\n\r\nconst FORMAT_NAME = \"CjsStlFormat\";\r\n\r\n/**\r\n * Shared mesh accepted by the STL writer. STL exports only `vertex.position`\r\n * and triangular `indices[].faces`; all other shared channels are ignored.\r\n *\r\n * @typedef {object} CjsStlSharedMesh\r\n * @property {string} [name] Diagnostic mesh name; `solidName` controls the STL header.\r\n * @property {{position: ArrayLike<number>, normal?: ArrayLike<number>}} vertex Shared vertex channels.\r\n * @property {Array<{name?: string, faces: ArrayLike<number>}>} indices Triangle index groups.\r\n */\r\n\r\n/**\r\n * Shared geometry root accepted by the STL writer.\r\n *\r\n * @typedef {object} CjsStlSharedRoot\r\n * @property {Array<CjsStlSharedMesh>} meshes Meshes flattened into one STL solid.\r\n * @property {string} [grannyFileSource] Optional source label used by inspection.\r\n */\r\n\r\n/**\r\n * Reusable STL read, write, and inspection options.\r\n *\r\n * @typedef {object} CjsStlFormatOptions\r\n * @property {\"shared\"|\"stlJson\"|\"json\"|\"gr2\"|\"cmf\"} [emit=\"stlJson\"] Read output contract.\r\n * @property {string} [source=\"memory\"] Source label stored in read/inspection output.\r\n * @property {boolean} [binary=true] Whether writes return binary bytes instead of ASCII text.\r\n * @property {string} [solidName=\"carbonenginejs\"] Sanitized ASCII solid name and binary header label.\r\n * @property {number} [scale=1] Positive finite multiplier applied to exported positions.\r\n * @property {boolean} [recalculateNormals=true] Derive facet normals from winding instead of vertex normals.\r\n * @property {boolean} [weldVertices=false] Weld equal positions while reading STL.\r\n * @property {number} [weldTolerance=1e-5] Non-negative read/inspection position tolerance.\r\n * @property {boolean} [skipDegenerate=true] Omit degenerate shared triangles during writes.\r\n * @property {boolean} [requireWatertight=false] Reject writes with printability topology issues.\r\n * @property {Record<string, Function>} [classes] Caller constructors used for read hydration.\r\n */\r\n\r\n/**\r\n * CarbonEngineJS-facing STL format surface.\r\n *\r\n * The Cjs prefix marks this as a JavaScript format/construction boundary.\r\n * STL is a triangle-only import/export format; the JSON contract is the shared\r\n * CarbonEngineJS mesh schema.\r\n */\r\nexport class CjsStlFormat extends CjsFormat\r\n{\r\n\r\n    #emit = DEFAULT_VALUES.emit;\r\n    #source = DEFAULT_VALUES.source;\r\n    #binary = DEFAULT_VALUES.binary;\r\n    #solidName = DEFAULT_VALUES.solidName;\r\n    #scale = DEFAULT_VALUES.scale;\r\n    #recalculateNormals = DEFAULT_VALUES.recalculateNormals;\r\n    #weldVertices = DEFAULT_VALUES.weldVertices;\r\n    #weldTolerance = DEFAULT_VALUES.weldTolerance;\r\n    #skipDegenerate = DEFAULT_VALUES.skipDegenerate;\r\n    #requireWatertight = DEFAULT_VALUES.requireWatertight;\r\n    #classes = DEFAULT_VALUES.classes;\r\n\r\n    /**\r\n     * Create a reusable format profile.\r\n     *\r\n     * The instance stores only normalized options; each `Read`, `Write`, or\r\n     * `Inspect` call may provide non-mutating overrides.\r\n     *\r\n     * @param {CjsStlFormatOptions} [options={}] Default format values.\r\n     * @throws {TypeError} If an option, output mode, numeric value, or class map is invalid.\r\n     */\r\n    constructor(options = {})\r\n    {\r\n        super();\r\n        this.SetValues(options);\r\n    }\r\n\r\n    /**\r\n     * Set format values for this reusable profile.\r\n     *\r\n     * @param {CjsStlFormatOptions} [options={}] Values to merge into the profile.\r\n     * @returns {CjsStlFormat} This format profile.\r\n     * @throws {TypeError} If an option, output mode, numeric value, or class map is invalid.\r\n     */\r\n    SetValues(options = {})\r\n    {\r\n        const values = normalizeValues(this.GetValues(), options, FORMAT_NAME);\r\n\r\n        this.#emit = values.emit;\r\n        this.#source = values.source;\r\n        this.#binary = values.binary;\r\n        this.#solidName = values.solidName;\r\n        this.#scale = values.scale;\r\n        this.#recalculateNormals = values.recalculateNormals;\r\n        this.#weldVertices = values.weldVertices;\r\n        this.#weldTolerance = values.weldTolerance;\r\n        this.#skipDegenerate = values.skipDegenerate;\r\n        this.#requireWatertight = values.requireWatertight;\r\n        this.#classes = values.classes;\r\n\r\n        return this;\r\n    }\r\n\r\n    /**\r\n     * Get this profile's current values, optionally with per-call overrides.\r\n     *\r\n     * @param {CjsStlFormatOptions} [options={}] Optional values to merge into a copy.\r\n     * @returns {CjsStlFormatOptions} A validated copy of the effective values.\r\n     * @throws {TypeError} If an override is invalid.\r\n     */\r\n    GetValues(options = {})\r\n    {\r\n        return normalizeValues({\r\n            emit: this.#emit,\r\n            source: this.#source,\r\n            binary: this.#binary,\r\n            solidName: this.#solidName,\r\n            scale: this.#scale,\r\n            recalculateNormals: this.#recalculateNormals,\r\n            weldVertices: this.#weldVertices,\r\n            weldTolerance: this.#weldTolerance,\r\n            skipDegenerate: this.#skipDegenerate,\r\n            requireWatertight: this.#requireWatertight,\r\n            classes: this.#classes\r\n        }, options, FORMAT_NAME);\r\n    }\r\n\r\n    /**\r\n     * Set multiple node-class constructors for this profile.\r\n     *\r\n     * @param {object} [classes] Map of node class keys to constructors.\r\n     * @returns {CjsStlFormat} This format profile.\r\n     */\r\n    SetClasses(classes = {})\r\n    {\r\n        return this.SetValues({ classes });\r\n    }\r\n\r\n    /**\r\n     * Set one node-class constructor for this profile.\r\n     *\r\n     * @param {string} type Node class key.\r\n     * @param {Function|null|undefined} Class Constructor to use, or nullish to delete.\r\n     * @returns {CjsStlFormat} This format profile.\r\n     */\r\n    SetClass(type, Class)\r\n    {\r\n        if (Class === null || Class === undefined)\r\n        {\r\n            validateClassKey(type, FORMAT_NAME);\r\n            const classes = { ...this.#classes };\r\n            delete classes[type];\r\n            this.#classes = classes;\r\n            return this;\r\n        }\r\n\r\n        validateClass(type, Class, FORMAT_NAME);\r\n        return this.SetValues({ classes: { [type]: Class } });\r\n    }\r\n\r\n    /**\r\n     * Get a configured node-class constructor.\r\n     *\r\n     * @param {string} type Node class key.\r\n     * @returns {Function|undefined} The registered constructor, if any.\r\n     */\r\n    GetClass(type)\r\n    {\r\n        validateClassKey(type, FORMAT_NAME);\r\n        return this.#classes[type];\r\n    }\r\n\r\n    /**\r\n     * Whether this format profile has a constructor registered for a node class key.\r\n     *\r\n     * @param {string} type Node class key.\r\n     * @returns {boolean} True when a constructor is registered.\r\n     */\r\n    HasClass(type)\r\n    {\r\n        return !!this.GetClass(type);\r\n    }\r\n\r\n    /**\r\n     * Read STL text/bytes with this profile's values.\r\n     *\r\n     * @param {string|Uint8Array|ArrayBuffer|DataView} input STL text or bytes.\r\n     * @param {object} [options] Per-call value overrides.\r\n     * @returns {object} The shared CarbonEngineJS JSON mesh schema.\r\n     */\r\n    Read(input, options = {})\r\n    {\r\n        return readWithValues(this, input, this.GetValues(options));\r\n    }\r\n\r\n    /**\r\n     * Write shared JSON geometry as STL with this profile's values.\r\n     *\r\n     * Multiple meshes and index groups are flattened in encounter order because\r\n     * STL has no portable material or scene hierarchy. Degenerate triangles are\r\n     * skipped by default. Binary output validates that every coordinate is\r\n     * representable as float32 rather than silently writing infinities.\r\n     *\r\n     * @param {CjsStlSharedRoot|CjsStlSharedMesh} input Shared JSON root or mesh.\r\n     * @param {CjsStlFormatOptions} [options={}] Per-call writer overrides.\r\n     * @returns {string|Uint8Array} ASCII STL text or binary STL bytes.\r\n     * @throws {TypeError|RangeError|Error} If geometry, indices, coordinates, topology, or options are invalid.\r\n     */\r\n    Write(input, options = {})\r\n    {\r\n        return writeWithValues(input, this.GetValues(options));\r\n    }\r\n\r\n    /**\r\n     * Inspect STL text/bytes or shared JSON geometry for printability blockers.\r\n     *\r\n     * @param {any} input STL text/bytes or shared JSON root/mesh.\r\n     * @param {object} [options] Per-call value overrides.\r\n     * @returns {object} Plain printability report.\r\n     */\r\n    Inspect(input, options = {})\r\n    {\r\n        return inspectWithValues(input, this.GetValues(options));\r\n    }\r\n\r\n    /**\r\n     * Convert format output to JSON-compatible data.\r\n     *\r\n     * @param {any} value Format output to convert.\r\n     * @returns {any} Plain JSON-compatible data.\r\n     */\r\n    ToJSON(value)\r\n    {\r\n        return toJsonValue(value);\r\n    }\r\n\r\n    /**\r\n     * Static one-shot read. Static methods use camelCase by convention.\r\n     *\r\n     * @param {string|Uint8Array|ArrayBuffer|DataView} input STL text or bytes.\r\n     * @param {object} [options] Format values.\r\n     * @returns {object} The shared CarbonEngineJS JSON mesh schema.\r\n     */\r\n    static read(input, options = {})\r\n    {\r\n        return readWithValues(CjsStlFormat, input, normalizeValues(DEFAULT_VALUES, options, FORMAT_NAME));\r\n    }\r\n\r\n    /**\r\n     * Static one-shot write.\r\n     *\r\n     * The call is one-shot and does not mutate `input`. Multiple meshes and\r\n     * index groups are flattened into a single STL solid in encounter order.\r\n     *\r\n     * @param {CjsStlSharedRoot|CjsStlSharedMesh} input Shared JSON root or mesh.\r\n     * @param {CjsStlFormatOptions} [options={}] Writer values.\r\n     * @returns {string|Uint8Array} ASCII STL text or binary STL bytes.\r\n     * @throws {TypeError|RangeError|Error} If geometry, indices, coordinates, topology, or options are invalid.\r\n     */\r\n    static write(input, options = {})\r\n    {\r\n        return writeWithValues(input, normalizeValues(DEFAULT_VALUES, options, FORMAT_NAME));\r\n    }\r\n\r\n    /**\r\n     * Static one-shot inspection.\r\n     *\r\n     * @param {any} input STL text/bytes or shared JSON root/mesh.\r\n     * @param {object} [options] Format values.\r\n     * @returns {object} Plain printability report.\r\n     */\r\n    static inspect(input, options = {})\r\n    {\r\n        return inspectWithValues(input, normalizeValues(DEFAULT_VALUES, options, FORMAT_NAME));\r\n    }\r\n\r\n    /**\r\n     * Static JSON-compatible conversion.\r\n     *\r\n     * @param {any} value Format output to convert.\r\n     * @returns {any} Plain JSON-compatible data.\r\n     */\r\n    static toJSON(value)\r\n    {\r\n        return toJsonValue(value);\r\n    }\r\n\r\n    /**\r\n     * Cheap sniff for STL-like input.\r\n     *\r\n     * @param {string|Uint8Array|ArrayBuffer|DataView} input Candidate STL input.\r\n     * @returns {boolean} True when input looks like STL.\r\n     */\r\n    static isStl(input)\r\n    {\r\n        return isStl(input);\r\n    }\r\n\r\n    /**\r\n     * Check whether byte-like input has an exact binary STL layout.\r\n     *\r\n     * @param {string|Uint8Array|ArrayBuffer|DataView} input Candidate STL input.\r\n     * @returns {boolean} True when input is binary STL bytes.\r\n     */\r\n    static isBinaryStl(input)\r\n    {\r\n        return isBinaryStl(input);\r\n    }\r\n\r\n    /**\r\n     * Emit targets for this format (canonical frozen enum).\r\n     */\r\n    static Output = Object.freeze({\r\n        JSON: OUTPUT_JSON,\r\n        STL_JSON: OUTPUT_STL_JSON,\r\n        SHARED: OUTPUT_SHARED,\r\n        GR2: OUTPUT_GR2,\r\n        CMF: OUTPUT_CMF\r\n    });\r\n    static CLASS_KEYS = CLASS_KEYS;\r\n    static id = \"stl\";\r\n    static mediaTypes = Object.freeze([ \"geometry\" ]);\r\n    static outputs = CjsFormat.defineOutputs({\r\n        shared: { decoded: true },\r\n        gr2: { decoded: true },\r\n        cmf: { decoded: true },\r\n        json: { role: \"debug\", decoded: true },\r\n        stlJson: { role: \"debug\", default: true, decoded: true }\r\n    });\r\n    static extensions = Object.freeze([ \".stl\" ]);\r\n\r\n}\r\n\r\nexport default CjsStlFormat;\r\n"],"names":["FORMAT_NAME","CjsStlFormat","CjsFormat","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","id","mediaTypes","outputs","defineOutputs","shared","decoded","gr2","cmf","json","role","stlJson","default","extensions"],"mappings":"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"}
+{"version":3,"file":"CjsStlFormat.js","sources":["../../../../../src/resource/formats/stl/CjsStlFormat.js"],"sourcesContent":["import { CjsFormat } from \"../../format/CjsFormat.js\";\n/**\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 extends CjsFormat\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        super();\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 id = \"stl\";\n    static mediaTypes = Object.freeze([ \"geometry\" ]);\n    // STL takes the shared geometry root directly rather than going through\n    // CMF, because it carries triangles and nothing else worth preserving.\n    // Lossless for what STL can represent; everything else was never in scope.\n    static inputs = CjsFormat.defineInputs({\n        shared: { default: true, payloadType: \"geometry\", options: [ \"binary\", \"solidName\", \"scale\", \"recalculateNormals\", \"weldVertices\" ] }\n    });\n\n    static outputs = CjsFormat.defineOutputs({\n        shared: { decoded: true },\n        gr2: { decoded: true },\n        cmf: { decoded: true },\n        json: { role: \"debug\", decoded: true },\n        stlJson: { role: \"debug\", default: true, decoded: true }\n    });\n    static extensions = Object.freeze([ \".stl\" ]);\n\n}\n\nexport default CjsStlFormat;\n"],"names":["FORMAT_NAME","CjsStlFormat","CjsFormat","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","id","mediaTypes","inputs","defineInputs","shared","default","payloadType","outputs","defineOutputs","decoded","gr2","cmf","json","role","stlJson","extensions"],"mappings":"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"}

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

@@ -5,8 +5,8 @@ import { hydrateCmf } from '../../cmf/core/utils/hydration.js';
 import { parseStl, trianglesToJson, jsonToTriangles, inspectTriangles, writeBinaryStl, writeAsciiStl, trianglesFromInput } from './stl.js';
 export { isBinaryStl, isStl, toText } from './stl.js';
 
-/**
- * Internal pipeline glue for CjsStlFormat.
+/**
+ * Internal pipeline glue for CjsStlFormat.
  */
 
 const CLASS_KEYS = Object.freeze(Array.from(new Set([...GR2_CLASS_KEYS, ...CMF_CLASS_KEYS])));
@@ -49,11 +49,11 @@ function validateNumber(name, value, readerName, {
   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.
+/**
+ * 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)) {
@@ -61,12 +61,12 @@ function validateClassKey(key, readerName = "CjsStlFormat") {
   }
 }
 
-/**
- * Validate a single `classes` entry.
- *
- * @param {string} key Node key.
- * @param {Function} Class Candidate constructor.
- * @param {string} [readerName] Format name used in thrown errors.
+/**
+ * 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);
@@ -96,13 +96,13 @@ function sanitizeName(value) {
   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.
+/**
+ * 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") {
@@ -156,13 +156,13 @@ 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.
+/**
+ * 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);
@@ -178,16 +178,16 @@ function readWithValues(format, input, values) {
   });
 }
 
-/**
- * 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.
+/**
+ * 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);
@@ -206,39 +206,17 @@ function writeWithValues(input, values) {
   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.
+/**
+ * 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;
-}
-
-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 };
+export { CLASS_KEYS, DEFAULT_VALUES, GR2_CLASS_KEYS, OUTPUT_CMF, OUTPUT_GR2, OUTPUT_JSON, OUTPUT_SHARED, OUTPUT_STL_JSON, inspectWithValues, normalizeValues, readWithValues, validateClass, validateClassKey, writeWithValues };
 //# sourceMappingURL=helpers.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"helpers.js","sources":["../../../../../../src/resource/formats/stl/core/helpers.js"],"sourcesContent":["/**\r\n * Internal pipeline glue for CjsStlFormat.\r\n */\r\n\r\nimport { hydrateJson } from \"./json.js\";\nimport { buildCmfFromShared, CMF_CLASS_KEYS } from \"./targets.js\";\nimport { GR2_CLASS_KEYS } from \"../../cmf/core/constants.js\";\nimport { hydrateCmf } from \"../../cmf/core/utils/hydration.js\";\nimport {\r\n    inspectTriangles,\r\n    isBinaryStl,\r\n    isStl,\r\n    jsonToTriangles,\r\n    parseStl,\r\n    toText,\r\n    trianglesFromInput,\r\n    trianglesToJson,\r\n    writeAsciiStl,\r\n    writeBinaryStl\r\n} from \"./stl.js\";\r\n\r\nexport { GR2_CLASS_KEYS };\n\r\nexport const CLASS_KEYS = Object.freeze(Array.from(new Set([\r\n    ...GR2_CLASS_KEYS,\r\n    ...CMF_CLASS_KEYS\r\n])));\r\n\r\nexport { isBinaryStl, isStl, toText };\r\n\r\nexport const OUTPUT_JSON = \"json\";\r\nexport const OUTPUT_STL_JSON = \"stlJson\";\r\nexport const OUTPUT_SHARED = \"shared\";\r\nexport const OUTPUT_GR2 = \"gr2\";\r\nexport const OUTPUT_CMF = \"cmf\";\r\n\r\nexport const DEFAULT_VALUES = Object.freeze({\r\n    emit: OUTPUT_STL_JSON,\r\n    source: \"memory\",\r\n    binary: true,\r\n    solidName: \"carbonenginejs\",\r\n    scale: 1,\r\n    recalculateNormals: true,\r\n    weldVertices: false,\r\n    weldTolerance: 1e-5,\r\n    skipDegenerate: true,\r\n    requireWatertight: false,\r\n    classes: Object.freeze({})\r\n});\r\n\r\nconst OPTION_KEYS = new Set([\r\n    \"emit\",\r\n    \"source\",\r\n    \"binary\",\r\n    \"solidName\",\r\n    \"scale\",\r\n    \"recalculateNormals\",\r\n    \"weldVertices\",\r\n    \"weldTolerance\",\r\n    \"skipDegenerate\",\r\n    \"requireWatertight\",\r\n    \"classes\"\r\n]);\r\n\r\nfunction validateBoolean(name, value, readerName)\r\n{\r\n    if (typeof value === \"boolean\") return value;\r\n    throw new TypeError(`${readerName}: ${name} must be true or false`);\r\n}\r\n\r\nfunction validateNumber(name, value, readerName, { minExclusive = null, minInclusive = null } = {})\r\n{\r\n    if (typeof value !== \"number\" || !Number.isFinite(value))\r\n    {\r\n        throw new TypeError(`${readerName}: ${name} must be a finite number`);\r\n    }\r\n    if (minExclusive !== null && value <= minExclusive)\r\n    {\r\n        throw new TypeError(`${readerName}: ${name} must be greater than ${minExclusive}`);\r\n    }\r\n    if (minInclusive !== null && value < minInclusive)\r\n    {\r\n        throw new TypeError(`${readerName}: ${name} must be at least ${minInclusive}`);\r\n    }\r\n    return value;\r\n}\r\n\r\n/**\r\n * Validate a `classes` node key against {@link CLASS_KEYS}.\r\n *\r\n * @param {string} key Candidate node key.\r\n * @param {string} [readerName] Format name used in thrown errors.\r\n */\r\nexport function validateClassKey(key, readerName = \"CjsStlFormat\")\r\n{\r\n    if (!CLASS_KEYS.includes(key))\r\n    {\r\n        throw new Error(`${readerName}: unknown class key ${JSON.stringify(key)}; expected one of ${CLASS_KEYS.join(\", \")}`);\r\n    }\r\n}\r\n\r\n/**\r\n * Validate a single `classes` entry.\r\n *\r\n * @param {string} key Node key.\r\n * @param {Function} Class Candidate constructor.\r\n * @param {string} [readerName] Format name used in thrown errors.\r\n */\r\nexport function validateClass(key, Class, readerName = \"CjsStlFormat\")\r\n{\r\n    validateClassKey(key, readerName);\r\n    if (typeof Class !== \"function\")\r\n    {\r\n        throw new TypeError(`${readerName}: class ${JSON.stringify(key)} must be a constructor`);\r\n    }\r\n}\r\n\r\nfunction mergeClasses(base, classes, readerName)\r\n{\r\n    if (!classes || typeof classes !== \"object\")\r\n    {\r\n        throw new TypeError(`${readerName}: classes option must be an object`);\r\n    }\r\n\r\n    const next = { ...base };\r\n    for (const [ key, Class ] of Object.entries(classes))\r\n    {\r\n        if (Class === null || Class === undefined)\r\n        {\r\n            delete next[key];\r\n            continue;\r\n        }\r\n        validateClass(key, Class, readerName);\r\n        next[key] = Class;\r\n    }\r\n    return next;\r\n}\r\n\r\nfunction sanitizeName(value)\r\n{\r\n    if (typeof value !== \"string\" || !value.trim()) return DEFAULT_VALUES.solidName;\r\n    return value.trim();\r\n}\r\n\r\n/**\r\n * Merge format values over a base set and validate them.\r\n *\r\n * @param {object} base Current values.\r\n * @param {object} [options] Values to merge in.\r\n * @param {string} [readerName] Format name used in error messages.\r\n * @returns {object} A validated copy of the merged values.\r\n */\r\nexport function normalizeValues(base, options = {}, readerName = \"CjsStlFormat\")\r\n{\r\n    if (!options || typeof options !== \"object\")\r\n    {\r\n        throw new TypeError(`${readerName}: options must be an object`);\r\n    }\r\n    for (const key of Object.keys(options))\r\n    {\r\n        if (!OPTION_KEYS.has(key))\r\n        {\r\n            throw new TypeError(`${readerName}: unknown option ${JSON.stringify(key)}`);\r\n        }\r\n    }\r\n\r\n    const values = { ...base, ...options };\r\n    const emit = normalizeEmit(values.emit, readerName);\r\n    const classes = Object.prototype.hasOwnProperty.call(options, \"classes\")\r\n        ? mergeClasses(base.classes || {}, options.classes, readerName)\r\n        : { ...(base.classes || {}) };\r\n    if ((emit === OUTPUT_GR2 || emit === OUTPUT_CMF) && !hasClasses(classes))\r\n    {\r\n        throw new TypeError(`${readerName}: emit \"${emit}\" requires explicit classes`);\r\n    }\r\n    if (typeof values.source !== \"string\" || !values.source)\r\n    {\r\n        values.source = DEFAULT_VALUES.source;\r\n    }\r\n\r\n    return {\r\n        emit,\r\n        source: values.source,\r\n        binary: validateBoolean(\"binary\", values.binary, readerName),\r\n        solidName: sanitizeName(values.solidName),\r\n        scale: validateNumber(\"scale\", values.scale, readerName, { minExclusive: 0 }),\r\n        recalculateNormals: validateBoolean(\"recalculateNormals\", values.recalculateNormals, readerName),\r\n        weldVertices: validateBoolean(\"weldVertices\", values.weldVertices, readerName),\r\n        weldTolerance: validateNumber(\"weldTolerance\", values.weldTolerance, readerName, { minInclusive: 0 }),\r\n        skipDegenerate: validateBoolean(\"skipDegenerate\", values.skipDegenerate, readerName),\r\n        requireWatertight: validateBoolean(\"requireWatertight\", values.requireWatertight, readerName),\r\n        classes\r\n    };\r\n}\r\n\r\nfunction normalizeEmit(emit, readerName)\r\n{\r\n    if (emit === undefined || emit === null || emit === OUTPUT_JSON || emit === OUTPUT_STL_JSON || emit === OUTPUT_SHARED)\r\n    {\r\n        return OUTPUT_STL_JSON;\r\n    }\r\n    if (emit === OUTPUT_GR2 || emit === OUTPUT_CMF) return emit;\r\n    throw new TypeError(`${readerName}: emit must be \"${OUTPUT_SHARED}\", \"${OUTPUT_STL_JSON}\", \"${OUTPUT_GR2}\", or \"${OUTPUT_CMF}\", got ${JSON.stringify(emit)}`);\r\n}\r\n\r\nfunction hasClasses(classes)\r\n{\r\n    return !!classes && Object.values(classes).some((Class) => typeof Class === \"function\");\r\n}\r\n\r\n/**\r\n * Read STL text/bytes and return the shared JSON schema.\r\n *\r\n * @param {object|Function} format Format instance or constructor.\r\n * @param {string|Uint8Array|ArrayBuffer|DataView} input STL text or bytes.\r\n * @param {object} values Normalized format values.\r\n * @returns {object} Shared JSON graph.\r\n */\r\nexport function readWithValues(format, input, values)\r\n{\r\n    void format;\r\n    const parsed = parseStl(input);\r\n    const json = trianglesToJson(parsed.triangles, values, parsed);\r\n    if (values.emit === OUTPUT_CMF)\n    {\n        return hydrateCmf(\n            buildCmfFromShared(json),\n            values.classes,\n            { source: values.source },\n            \"CjsStlFormat CMF\"\n        );\n    }\n    return hydrateJson(json, { classes: values.classes, source: values.source });\r\n}\r\n\r\n/**\r\n * Write the shared JSON geometry schema to STL.\r\n * The input is read-only. Meshes and index groups are flattened by\r\n * {@link jsonToTriangles}; optional topology enforcement runs against that\r\n * exact scaled triangle stream before encoding begins.\r\n *\r\n * @param {object} input Shared JSON root or mesh.\r\n * @param {object} values Normalized format values.\r\n * @returns {string|Uint8Array} ASCII STL text or binary STL bytes.\r\n * @throws {TypeError|RangeError|Error} If geometry, numeric values, indices, topology, or binary range are invalid.\r\n */\r\nexport function writeWithValues(input, values)\r\n{\r\n    const triangles = jsonToTriangles(input, values);\r\n    if (!triangles.length)\r\n    {\r\n        throw new Error(\"CjsStlFormat: write input did not produce any triangles\");\r\n    }\r\n\r\n    if (values.requireWatertight)\r\n    {\r\n        const report = inspectTriangles(triangles, values, { format: \"json\", source: input.grannyFileSource || values.source });\r\n        if (!report.printable)\r\n        {\r\n            throw new Error(`CjsStlFormat: requireWatertight failed (${report.issues.map(issue => issue.key).join(\", \")})`);\r\n        }\r\n    }\r\n\r\n    return values.binary\r\n        ? writeBinaryStl(triangles, values.solidName)\r\n        : writeAsciiStl(triangles, values.solidName);\r\n}\r\n\r\n/**\r\n * Inspect STL or shared JSON geometry without class hydration.\r\n *\r\n * @param {any} input STL text/bytes or shared JSON.\r\n * @param {object} values Normalized format values.\r\n * @returns {object} Plain printability report.\r\n */\r\nexport function inspectWithValues(input, values)\r\n{\r\n    const source = trianglesFromInput(input, values);\r\n    return inspectTriangles(source.triangles, values, source);\r\n}\r\n\r\n/**\r\n * Convert format output to plain JSON-compatible data.\r\n *\r\n * @param {any} value Format output.\r\n * @returns {any} JSON-compatible value.\r\n */\r\nexport function toJsonValue(value)\r\n{\r\n    if (value === null || value === undefined) return value;\r\n    if (typeof value !== \"object\") return value;\r\n\r\n    if (typeof value.toJSON === \"function\")\r\n    {\r\n        const next = value.toJSON();\r\n        if (next !== value) return toJsonValue(next);\r\n    }\r\n\r\n    if (Array.isArray(value)) return value.map(toJsonValue);\r\n    if (ArrayBuffer.isView(value) && !(value instanceof DataView)) return Array.from(value);\r\n\r\n    const out = {};\r\n    for (const key of Object.keys(value))\r\n    {\r\n        out[key] = toJsonValue(value[key]);\r\n    }\r\n    return out;\r\n}\r\n\r\n"],"names":["CLASS_KEYS","Object","freeze","Array","from","Set","GR2_CLASS_KEYS","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":";;;;;;;AAAA;AACA;AACA;;AAqBO,MAAMA,UAAU,GAAGC,MAAM,CAACC,MAAM,CAACC,KAAK,CAACC,IAAI,CAAC,IAAIC,GAAG,CAAC,CACvD,GAAGC,cAAc,EACjB,GAAGC,cAAc,CACpB,CAAC,CAAC;AAII,MAAMC,WAAW,GAAG;AACpB,MAAMC,eAAe,GAAG;AACxB,MAAMC,aAAa,GAAG;AACtB,MAAMC,UAAU,GAAG;AACnB,MAAMC,UAAU,GAAG;MAEbC,cAAc,GAAGZ,MAAM,CAACC,MAAM,CAAC;AACxCY,EAAAA,IAAI,EAAEL,eAAe;AACrBM,EAAAA,MAAM,EAAE,QAAQ;AAChBC,EAAAA,MAAM,EAAE,IAAI;AACZC,EAAAA,SAAS,EAAE,gBAAgB;AAC3BC,EAAAA,KAAK,EAAE,CAAC;AACRC,EAAAA,kBAAkB,EAAE,IAAI;AACxBC,EAAAA,YAAY,EAAE,KAAK;AACnBC,EAAAA,aAAa,EAAE,IAAI;AACnBC,EAAAA,cAAc,EAAE,IAAI;AACpBC,EAAAA,iBAAiB,EAAE,KAAK;AACxBC,EAAAA,OAAO,EAAEvB,MAAM,CAACC,MAAM,CAAC,EAAE;AAC7B,CAAC;AAED,MAAMuB,WAAW,GAAG,IAAIpB,GAAG,CAAC,CACxB,MAAM,EACN,QAAQ,EACR,QAAQ,EACR,WAAW,EACX,OAAO,EACP,oBAAoB,EACpB,cAAc,EACd,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,SAAS,CACZ,CAAC;AAEF,SAASqB,eAAeA,CAACC,IAAI,EAAEC,KAAK,EAAEC,UAAU,EAChD;AACI,EAAA,IAAI,OAAOD,KAAK,KAAK,SAAS,EAAE,OAAOA,KAAK;EAC5C,MAAM,IAAIE,SAAS,CAAC,CAAA,EAAGD,UAAU,CAAA,EAAA,EAAKF,IAAI,wBAAwB,CAAC;AACvE;AAEA,SAASI,cAAcA,CAACJ,IAAI,EAAEC,KAAK,EAAEC,UAAU,EAAE;AAAEG,EAAAA,YAAY,GAAG,IAAI;AAAEC,EAAAA,YAAY,GAAG;AAAK,CAAC,GAAG,EAAE,EAClG;AACI,EAAA,IAAI,OAAOL,KAAK,KAAK,QAAQ,IAAI,CAACM,MAAM,CAACC,QAAQ,CAACP,KAAK,CAAC,EACxD;IACI,MAAM,IAAIE,SAAS,CAAC,CAAA,EAAGD,UAAU,CAAA,EAAA,EAAKF,IAAI,0BAA0B,CAAC;AACzE,EAAA;AACA,EAAA,IAAIK,YAAY,KAAK,IAAI,IAAIJ,KAAK,IAAII,YAAY,EAClD;IACI,MAAM,IAAIF,SAAS,CAAC,CAAA,EAAGD,UAAU,KAAKF,IAAI,CAAA,sBAAA,EAAyBK,YAAY,CAAA,CAAE,CAAC;AACtF,EAAA;AACA,EAAA,IAAIC,YAAY,KAAK,IAAI,IAAIL,KAAK,GAAGK,YAAY,EACjD;IACI,MAAM,IAAIH,SAAS,CAAC,CAAA,EAAGD,UAAU,KAAKF,IAAI,CAAA,kBAAA,EAAqBM,YAAY,CAAA,CAAE,CAAC;AAClF,EAAA;AACA,EAAA,OAAOL,KAAK;AAChB;;AAEA;AACA;AACA;AACA;AACA;AACA;AACO,SAASQ,gBAAgBA,CAACC,GAAG,EAAER,UAAU,GAAG,cAAc,EACjE;AACI,EAAA,IAAI,CAAC7B,UAAU,CAACsC,QAAQ,CAACD,GAAG,CAAC,EAC7B;IACI,MAAM,IAAIE,KAAK,CAAC,CAAA,EAAGV,UAAU,CAAA,oBAAA,EAAuBW,IAAI,CAACC,SAAS,CAACJ,GAAG,CAAC,CAAA,kBAAA,EAAqBrC,UAAU,CAAC0C,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;AACxH,EAAA;AACJ;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASC,aAAaA,CAACN,GAAG,EAAEO,KAAK,EAAEf,UAAU,GAAG,cAAc,EACrE;AACIO,EAAAA,gBAAgB,CAACC,GAAG,EAAER,UAAU,CAAC;AACjC,EAAA,IAAI,OAAOe,KAAK,KAAK,UAAU,EAC/B;AACI,IAAA,MAAM,IAAId,SAAS,CAAC,CAAA,EAAGD,UAAU,CAAA,QAAA,EAAWW,IAAI,CAACC,SAAS,CAACJ,GAAG,CAAC,wBAAwB,CAAC;AAC5F,EAAA;AACJ;AAEA,SAASQ,YAAYA,CAACC,IAAI,EAAEtB,OAAO,EAAEK,UAAU,EAC/C;AACI,EAAA,IAAI,CAACL,OAAO,IAAI,OAAOA,OAAO,KAAK,QAAQ,EAC3C;AACI,IAAA,MAAM,IAAIM,SAAS,CAAC,CAAA,EAAGD,UAAU,oCAAoC,CAAC;AAC1E,EAAA;AAEA,EAAA,MAAMkB,IAAI,GAAG;IAAE,GAAGD;GAAM;AACxB,EAAA,KAAK,MAAM,CAAET,GAAG,EAAEO,KAAK,CAAE,IAAI3C,MAAM,CAAC+C,OAAO,CAACxB,OAAO,CAAC,EACpD;AACI,IAAA,IAAIoB,KAAK,KAAK,IAAI,IAAIA,KAAK,KAAKK,SAAS,EACzC;MACI,OAAOF,IAAI,CAACV,GAAG,CAAC;AAChB,MAAA;AACJ,IAAA;AACAM,IAAAA,aAAa,CAACN,GAAG,EAAEO,KAAK,EAAEf,UAAU,CAAC;AACrCkB,IAAAA,IAAI,CAACV,GAAG,CAAC,GAAGO,KAAK;AACrB,EAAA;AACA,EAAA,OAAOG,IAAI;AACf;AAEA,SAASG,YAAYA,CAACtB,KAAK,EAC3B;AACI,EAAA,IAAI,OAAOA,KAAK,KAAK,QAAQ,IAAI,CAACA,KAAK,CAACuB,IAAI,EAAE,EAAE,OAAOtC,cAAc,CAACI,SAAS;AAC/E,EAAA,OAAOW,KAAK,CAACuB,IAAI,EAAE;AACvB;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASC,eAAeA,CAACN,IAAI,EAAEO,OAAO,GAAG,EAAE,EAAExB,UAAU,GAAG,cAAc,EAC/E;AACI,EAAA,IAAI,CAACwB,OAAO,IAAI,OAAOA,OAAO,KAAK,QAAQ,EAC3C;AACI,IAAA,MAAM,IAAIvB,SAAS,CAAC,CAAA,EAAGD,UAAU,6BAA6B,CAAC;AACnE,EAAA;EACA,KAAK,MAAMQ,GAAG,IAAIpC,MAAM,CAACqD,IAAI,CAACD,OAAO,CAAC,EACtC;AACI,IAAA,IAAI,CAAC5B,WAAW,CAAC8B,GAAG,CAAClB,GAAG,CAAC,EACzB;AACI,MAAA,MAAM,IAAIP,SAAS,CAAC,CAAA,EAAGD,UAAU,CAAA,iBAAA,EAAoBW,IAAI,CAACC,SAAS,CAACJ,GAAG,CAAC,EAAE,CAAC;AAC/E,IAAA;AACJ,EAAA;AAEA,EAAA,MAAMmB,MAAM,GAAG;AAAE,IAAA,GAAGV,IAAI;IAAE,GAAGO;GAAS;EACtC,MAAMvC,IAAI,GAAG2C,aAAa,CAACD,MAAM,CAAC1C,IAAI,EAAEe,UAAU,CAAC;AACnD,EAAA,MAAML,OAAO,GAAGvB,MAAM,CAACyD,SAAS,CAACC,cAAc,CAACC,IAAI,CAACP,OAAO,EAAE,SAAS,CAAC,GAClER,YAAY,CAACC,IAAI,CAACtB,OAAO,IAAI,EAAE,EAAE6B,OAAO,CAAC7B,OAAO,EAAEK,UAAU,CAAC,GAC7D;AAAE,IAAA,IAAIiB,IAAI,CAACtB,OAAO,IAAI,EAAE;GAAG;AACjC,EAAA,IAAI,CAACV,IAAI,KAAKH,UAAU,IAAIG,IAAI,KAAKF,UAAU,KAAK,CAACiD,UAAU,CAACrC,OAAO,CAAC,EACxE;IACI,MAAM,IAAIM,SAAS,CAAC,CAAA,EAAGD,UAAU,CAAA,QAAA,EAAWf,IAAI,6BAA6B,CAAC;AAClF,EAAA;EACA,IAAI,OAAO0C,MAAM,CAACzC,MAAM,KAAK,QAAQ,IAAI,CAACyC,MAAM,CAACzC,MAAM,EACvD;AACIyC,IAAAA,MAAM,CAACzC,MAAM,GAAGF,cAAc,CAACE,MAAM;AACzC,EAAA;EAEA,OAAO;IACHD,IAAI;IACJC,MAAM,EAAEyC,MAAM,CAACzC,MAAM;IACrBC,MAAM,EAAEU,eAAe,CAAC,QAAQ,EAAE8B,MAAM,CAACxC,MAAM,EAAEa,UAAU,CAAC;AAC5DZ,IAAAA,SAAS,EAAEiC,YAAY,CAACM,MAAM,CAACvC,SAAS,CAAC;IACzCC,KAAK,EAAEa,cAAc,CAAC,OAAO,EAAEyB,MAAM,CAACtC,KAAK,EAAEW,UAAU,EAAE;AAAEG,MAAAA,YAAY,EAAE;AAAE,KAAC,CAAC;IAC7Eb,kBAAkB,EAAEO,eAAe,CAAC,oBAAoB,EAAE8B,MAAM,CAACrC,kBAAkB,EAAEU,UAAU,CAAC;IAChGT,YAAY,EAAEM,eAAe,CAAC,cAAc,EAAE8B,MAAM,CAACpC,YAAY,EAAES,UAAU,CAAC;IAC9ER,aAAa,EAAEU,cAAc,CAAC,eAAe,EAAEyB,MAAM,CAACnC,aAAa,EAAEQ,UAAU,EAAE;AAAEI,MAAAA,YAAY,EAAE;AAAE,KAAC,CAAC;IACrGX,cAAc,EAAEI,eAAe,CAAC,gBAAgB,EAAE8B,MAAM,CAAClC,cAAc,EAAEO,UAAU,CAAC;IACpFN,iBAAiB,EAAEG,eAAe,CAAC,mBAAmB,EAAE8B,MAAM,CAACjC,iBAAiB,EAAEM,UAAU,CAAC;AAC7FL,IAAAA;GACH;AACL;AAEA,SAASiC,aAAaA,CAAC3C,IAAI,EAAEe,UAAU,EACvC;AACI,EAAA,IAAIf,IAAI,KAAKmC,SAAS,IAAInC,IAAI,KAAK,IAAI,IAAIA,IAAI,KAAKN,WAAW,IAAIM,IAAI,KAAKL,eAAe,IAAIK,IAAI,KAAKJ,aAAa,EACrH;AACI,IAAA,OAAOD,eAAe;AAC1B,EAAA;EACA,IAAIK,IAAI,KAAKH,UAAU,IAAIG,IAAI,KAAKF,UAAU,EAAE,OAAOE,IAAI;EAC3D,MAAM,IAAIgB,SAAS,CAAC,CAAA,EAAGD,UAAU,CAAA,gBAAA,EAAmBnB,aAAa,OAAOD,eAAe,CAAA,IAAA,EAAOE,UAAU,CAAA,OAAA,EAAUC,UAAU,UAAU4B,IAAI,CAACC,SAAS,CAAC3B,IAAI,CAAC,CAAA,CAAE,CAAC;AACjK;AAEA,SAAS+C,UAAUA,CAACrC,OAAO,EAC3B;AACI,EAAA,OAAO,CAAC,CAACA,OAAO,IAAIvB,MAAM,CAACuD,MAAM,CAAChC,OAAO,CAAC,CAACsC,IAAI,CAAElB,KAAK,IAAK,OAAOA,KAAK,KAAK,UAAU,CAAC;AAC3F;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASmB,cAAcA,CAACC,MAAM,EAAEC,KAAK,EAAET,MAAM,EACpD;AAEI,EAAA,MAAMU,MAAM,GAAGC,QAAQ,CAACF,KAAK,CAAC;EAC9B,MAAMG,IAAI,GAAGC,eAAe,CAACH,MAAM,CAACI,SAAS,EAAEd,MAAM,EAAEU,MAAM,CAAC;AAC9D,EAAA,IAAIV,MAAM,CAAC1C,IAAI,KAAKF,UAAU,EAC9B;IACI,OAAO2D,UAAU,CACbC,kBAAkB,CAACJ,IAAI,CAAC,EACxBZ,MAAM,CAAChC,OAAO,EACd;MAAET,MAAM,EAAEyC,MAAM,CAACzC;KAAQ,EACzB,kBACJ,CAAC;AACL,EAAA;EACA,OAAO0D,WAAW,CAACL,IAAI,EAAE;IAAE5C,OAAO,EAAEgC,MAAM,CAAChC,OAAO;IAAET,MAAM,EAAEyC,MAAM,CAACzC;AAAO,GAAC,CAAC;AAChF;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAAS2D,eAAeA,CAACT,KAAK,EAAET,MAAM,EAC7C;AACI,EAAA,MAAMc,SAAS,GAAGK,eAAe,CAACV,KAAK,EAAET,MAAM,CAAC;AAChD,EAAA,IAAI,CAACc,SAAS,CAACM,MAAM,EACrB;AACI,IAAA,MAAM,IAAIrC,KAAK,CAAC,yDAAyD,CAAC;AAC9E,EAAA;EAEA,IAAIiB,MAAM,CAACjC,iBAAiB,EAC5B;AACI,IAAA,MAAMsD,MAAM,GAAGC,gBAAgB,CAACR,SAAS,EAAEd,MAAM,EAAE;AAAEQ,MAAAA,MAAM,EAAE,MAAM;AAAEjD,MAAAA,MAAM,EAAEkD,KAAK,CAACc,gBAAgB,IAAIvB,MAAM,CAACzC;AAAO,KAAC,CAAC;AACvH,IAAA,IAAI,CAAC8D,MAAM,CAACG,SAAS,EACrB;MACI,MAAM,IAAIzC,KAAK,CAAC,CAAA,wCAAA,EAA2CsC,MAAM,CAACI,MAAM,CAACC,GAAG,CAACC,KAAK,IAAIA,KAAK,CAAC9C,GAAG,CAAC,CAACK,IAAI,CAAC,IAAI,CAAC,CAAA,CAAA,CAAG,CAAC;AACnH,IAAA;AACJ,EAAA;EAEA,OAAOc,MAAM,CAACxC,MAAM,GACdoE,cAAc,CAACd,SAAS,EAAEd,MAAM,CAACvC,SAAS,CAAC,GAC3CoE,aAAa,CAACf,SAAS,EAAEd,MAAM,CAACvC,SAAS,CAAC;AACpD;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASqE,iBAAiBA,CAACrB,KAAK,EAAET,MAAM,EAC/C;AACI,EAAA,MAAMzC,MAAM,GAAGwE,kBAAkB,CAACtB,KAAK,EAAET,MAAM,CAAC;EAChD,OAAOsB,gBAAgB,CAAC/D,MAAM,CAACuD,SAAS,EAAEd,MAAM,EAAEzC,MAAM,CAAC;AAC7D;;AAEA;AACA;AACA;AACA;AACA;AACA;AACO,SAASyE,WAAWA,CAAC5D,KAAK,EACjC;EACI,IAAIA,KAAK,KAAK,IAAI,IAAIA,KAAK,KAAKqB,SAAS,EAAE,OAAOrB,KAAK;AACvD,EAAA,IAAI,OAAOA,KAAK,KAAK,QAAQ,EAAE,OAAOA,KAAK;AAE3C,EAAA,IAAI,OAAOA,KAAK,CAAC6D,MAAM,KAAK,UAAU,EACtC;AACI,IAAA,MAAM1C,IAAI,GAAGnB,KAAK,CAAC6D,MAAM,EAAE;IAC3B,IAAI1C,IAAI,KAAKnB,KAAK,EAAE,OAAO4D,WAAW,CAACzC,IAAI,CAAC;AAChD,EAAA;AAEA,EAAA,IAAI5C,KAAK,CAACuF,OAAO,CAAC9D,KAAK,CAAC,EAAE,OAAOA,KAAK,CAACsD,GAAG,CAACM,WAAW,CAAC;AACvD,EAAA,IAAIG,WAAW,CAACC,MAAM,CAAChE,KAAK,CAAC,IAAI,EAAEA,KAAK,YAAYiE,QAAQ,CAAC,EAAE,OAAO1F,KAAK,CAACC,IAAI,CAACwB,KAAK,CAAC;EAEvF,MAAMkE,GAAG,GAAG,EAAE;EACd,KAAK,MAAMzD,GAAG,IAAIpC,MAAM,CAACqD,IAAI,CAAC1B,KAAK,CAAC,EACpC;IACIkE,GAAG,CAACzD,GAAG,CAAC,GAAGmD,WAAW,CAAC5D,KAAK,CAACS,GAAG,CAAC,CAAC;AACtC,EAAA;AACA,EAAA,OAAOyD,GAAG;AACd;;;;"}
+{"version":3,"file":"helpers.js","sources":["../../../../../../src/resource/formats/stl/core/helpers.js"],"sourcesContent":["/**\n * Internal pipeline glue for CjsStlFormat.\n */\n\nimport { toJsonWithArrayValues as toJsonValue } from \"../../../format/jsonPolicies.js\";\nimport { hydrateJson } from \"./json.js\";\nimport { buildCmfFromShared, CMF_CLASS_KEYS } from \"./targets.js\";\nimport { GR2_CLASS_KEYS } from \"../../cmf/core/constants.js\";\nimport { hydrateCmf } from \"../../cmf/core/utils/hydration.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 { GR2_CLASS_KEYS };\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)\n    {\n        return hydrateCmf(\n            buildCmfFromShared(json),\n            values.classes,\n            { source: values.source },\n            \"CjsStlFormat CMF\"\n        );\n    }\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 */\n/** The shared JSON policy for this reader, under the name its callers use. */\nexport { toJsonValue };\n\n"],"names":["CLASS_KEYS","Object","freeze","Array","from","Set","GR2_CLASS_KEYS","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"],"mappings":"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"}

package/dist/resource/formats/tga/CjsTgaFormat.js

@@ -1,7 +1,9 @@
 import { asUint8Array } from '#utils/bytes';
 import { CjsFormat } from '../../format/CjsFormat.js';
-import { DEFAULT_VALUES, normalizeValues, readWithValues, inspectWithValues, toJsonValue, probeSupportWithValues, isTGA, OUTPUT_JSON, OUTPUT_RAW, OUTPUT_RGBA, OUTPUT_IMAGE } from './core/helpers.js';
+import { DEFAULT_VALUES, normalizeValues, readWithValues, inspectWithValues, probeSupportWithValues, OUTPUT_JSON, OUTPUT_RAW, OUTPUT_RGBA, OUTPUT_IMAGE } from './core/helpers.js';
 import { encodeTga } from './core/writer.js';
+import { toJsonWithByteSummary } from '../../format/jsonPolicies.js';
+import { isTGA } from '../../format/imageSignatures.js';
 
 const FORMAT_NAME = "CjsTgaFormat";
 
@@ -111,7 +113,7 @@ class CjsTgaFormat extends CjsFormat {
    * @returns {any} JSON-compatible value.
    */
   ToJSON(value) {
-    return toJsonValue(value);
+    return toJsonWithByteSummary(value);
   }
 
   /**
@@ -174,7 +176,7 @@ class CjsTgaFormat extends CjsFormat {
    * @returns {any} JSON-compatible value.
    */
   static toJSON(value) {
-    return toJsonValue(value);
+    return toJsonWithByteSummary(value);
   }
 
   /**

package/dist/resource/formats/tga/CjsTgaFormat.js.map

@@ -1 +1 @@
-{"version":3,"file":"CjsTgaFormat.js","sources":["../../../../../src/resource/formats/tga/CjsTgaFormat.js"],"sourcesContent":["import { asUint8Array } from \"#utils/bytes\";\nimport { CjsFormat } from \"../../format/CjsFormat.js\";\nimport {\n    DEFAULT_VALUES,\n    OUTPUT_IMAGE,\n    OUTPUT_JSON,\n    OUTPUT_RAW,\n    OUTPUT_RGBA,\n    inspectWithValues,\n    probeSupportWithValues,\n    isTGA,\n    normalizeValues,\n    readWithValues,\n    toJsonValue\n} from \"./core/helpers.js\";\nimport { encodeTga } from \"./core/writer.js\";\n\nconst FORMAT_NAME = \"CjsTgaFormat\";\n\n/**\n * TGA format profile that inspects header metadata and reads TGA bytes into\n * raw, debug JSON, or decoded RGBA image payloads.\n */\nexport class CjsTgaFormat extends CjsFormat\n{\n    #values = DEFAULT_VALUES;\n\n    /**\n     * One-shot TGA write from a normalized RGBA payload.\n     *\n     * @param {object} payload As emitted for `rgba`.\n     * @param {object} [options] `compress` for run-length encoding.\n     * @returns {Uint8Array} TGA bytes.\n     */\n    static write(payload, options = {})\n    {\n        return encodeTga(payload, options);\n    }\n\n    /**\n     * Write a normalized RGBA payload as TGA bytes.\n     *\n     * @param {object} payload As emitted for `rgba`.\n     * @param {object} [options] `compress` for run-length encoding.\n     * @returns {Uint8Array} TGA bytes.\n     */\n    Write(payload, options = {})\n    {\n        return encodeTga(payload, options);\n    }\n\n    /**\n     * Create a reusable TGA format profile.\n     *\n     * @param {object} [options] Default read/inspect options.\n     */\n    constructor(options = {})\n    {\n        super();\n        this.SetValues(options);\n    }\n\n    /**\n     * Merge options into this profile.\n     *\n     * @param {object} [options] Values to merge.\n     * @returns {CjsTgaFormat} This format profile.\n     */\n    SetValues(options = {})\n    {\n        this.#values = normalizeValues(this.#values, { inputType: \"tga\", ...options }, FORMAT_NAME);\n        return this;\n    }\n\n    /**\n     * Get normalized profile values with optional per-call overrides.\n     *\n     * @param {object} [options] Per-call values.\n     * @returns {object} Normalized read values.\n     */\n    GetValues(options = {})\n    {\n        return normalizeValues(this.#values, { inputType: \"tga\", ...options }, FORMAT_NAME);\n    }\n\n    /**\n     * Read TGA bytes with this profile.\n     *\n     * @param {Uint8Array|ArrayBuffer|DataView} input TGA bytes.\n     * @param {object} [options] Per-call values.\n     * @returns {object} GPU-free raw/debug/RGBA payload for the selected emit target.\n     */\n    Read(input, options = {})\n    {\n        return readWithValues(input, this.GetValues(options), \"tga\");\n    }\n\n    /**\n     * Read TGA bytes asynchronously with this profile.\n     *\n     * @param {Uint8Array|ArrayBuffer|DataView} input TGA bytes.\n     * @param {object} [options] Per-call values.\n     * @returns {Promise<object>} GPU-free raw/debug/RGBA payload for the selected emit target.\n     */\n    async ReadAsync(input, options = {})\n    {\n        return this.Read(input, options);\n    }\n\n    /**\n     * Inspect TGA bytes without decoding full image data.\n     *\n     * @param {Uint8Array|ArrayBuffer|DataView} input TGA bytes.\n     * @param {object} [options] Per-call values.\n     * @returns {object} TGA header metadata.\n     */\n    Inspect(input, options = {})\n    {\n        return inspectWithValues(input, this.GetValues(options), \"tga\");\n    }\n\n    /**\n     * Convert format output into JSON-compatible debug data.\n     *\n     * @param {any} value Format output.\n     * @returns {any} JSON-compatible value.\n     */\n    ToJSON(value)\n    {\n        return toJsonValue(value);\n    }\n\n    /**\n     * One-shot TGA read.\n     *\n     * @param {Uint8Array|ArrayBuffer|DataView} input TGA bytes.\n     * @param {object} [options] Read options.\n     * @returns {object} GPU-free raw/debug/RGBA payload for the selected emit target.\n     */\n    static read(input, options = {})\n    {\n        return readWithValues(input, normalizeValues(DEFAULT_VALUES, { inputType: \"tga\", ...options }, FORMAT_NAME), \"tga\");\n    }\n\n    /**\n     * One-shot asynchronous TGA read.\n     *\n     * @param {Uint8Array|ArrayBuffer|DataView} input TGA bytes.\n     * @param {object} [options] Read options.\n     * @returns {Promise<object>} GPU-free raw/debug/RGBA payload for the selected emit target.\n     */\n    static async readAsync(input, options = {})\n    {\n        return CjsTgaFormat.read(input, options);\n    }\n\n    /**\n     * One-shot TGA inspection.\n     *\n     * @param {Uint8Array|ArrayBuffer|DataView} input TGA bytes.\n     * @param {object} [options] Inspect options.\n     * @returns {object} TGA header metadata.\n     */\n    static inspect(input, options = {})\n    {\n        return inspectWithValues(input, normalizeValues(DEFAULT_VALUES, { inputType: \"tga\", ...options }, FORMAT_NAME), \"tga\");\n    }\n\n    /**\n     * One-shot TGA support probe.\n     *\n     * @param {Uint8Array|ArrayBuffer|DataView} input TGA bytes.\n     * @param {object} [options] Probe options.\n     * @returns {object} Support/probe report.\n     */\n    static probeSupport(input, options = {})\n    {\n        return probeSupportWithValues(input, normalizeValues(DEFAULT_VALUES, { inputType: \"tga\", ...options }, FORMAT_NAME), \"tga\");\n    }\n\n    /**\n     * Convert format output into JSON-compatible debug data.\n     *\n     * @param {any} value Format output.\n     * @returns {any} JSON-compatible value.\n     */\n    static toJSON(value)\n    {\n        return toJsonValue(value);\n    }\n\n    /**\n     * Test whether bytes look like a TGA file.\n     *\n     * @param {Uint8Array|ArrayBuffer|DataView} input Candidate TGA bytes.\n     * @returns {boolean} True when the TGA header looks valid.\n     */\n    static isTGA(input)\n    {\n        try\n        {\n            return isTGA(asUint8Array(input, \"Image input\"));\n        }\n        catch\n        {\n            return false;\n        }\n    }\n\n    /**\n     * Emit targets for this format (canonical frozen enum).\n     */\n    static Output = Object.freeze({\n        IMAGE: OUTPUT_IMAGE,\n        RGBA: OUTPUT_RGBA,\n        RAW: OUTPUT_RAW,\n        JSON: OUTPUT_JSON\n    });\n\n    static OUTPUT_TGA_JSON = \"tgaJson\";\n\n    static id = \"tga\";\n\n    static mediaTypes = Object.freeze([ \"image\" ]);\n\n    static inputs = CjsFormat.defineInputs({\n        rgba: { default: true, options: [ \"compress\" ] }\n    });\n\n    static outputs = CjsFormat.defineOutputs({\n\n        image: { decoded: true, probes: [ \"image\", \"rgba\" ] },\n\n        rgba: { decoded: true },\n\n        tgaJson: { role: \"debug\", probes: [ \"tgaJson\", \"raw\" ] },\n\n        raw: { role: \"debug\", default: true, passthrough: true }\n\n    });\n\n    static extensions = Object.freeze([ \".tga\" ]);\n}\n\nexport default CjsTgaFormat;\n"],"names":["FORMAT_NAME","CjsTgaFormat","CjsFormat","DEFAULT_VALUES","write","payload","options","encodeTga","Write","constructor","SetValues","normalizeValues","inputType","GetValues","Read","input","readWithValues","ReadAsync","Inspect","inspectWithValues","ToJSON","value","toJsonValue","read","readAsync","inspect","probeSupport","probeSupportWithValues","toJSON","isTGA","asUint8Array","Output","Object","freeze","IMAGE","OUTPUT_IMAGE","RGBA","OUTPUT_RGBA","RAW","OUTPUT_RAW","JSON","OUTPUT_JSON","OUTPUT_TGA_JSON","id","mediaTypes","inputs","defineInputs","rgba","default","outputs","defineOutputs","image","decoded","probes","tgaJson","role","raw","passthrough","extensions"],"mappings":"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"}
+{"version":3,"file":"CjsTgaFormat.js","sources":["../../../../../src/resource/formats/tga/CjsTgaFormat.js"],"sourcesContent":["import { asUint8Array } from \"#utils/bytes\";\nimport { CjsFormat } from \"../../format/CjsFormat.js\";\nimport {\n    DEFAULT_VALUES,\n    OUTPUT_IMAGE,\n    OUTPUT_JSON,\n    OUTPUT_RAW,\n    OUTPUT_RGBA,\n    inspectWithValues,\n    probeSupportWithValues,\n    isTGA,\n    normalizeValues,\n    readWithValues,\n    toJsonValue\n} from \"./core/helpers.js\";\nimport { encodeTga } from \"./core/writer.js\";\n\nconst FORMAT_NAME = \"CjsTgaFormat\";\n\n/**\n * TGA format profile that inspects header metadata and reads TGA bytes into\n * raw, debug JSON, or decoded RGBA image payloads.\n */\nexport class CjsTgaFormat extends CjsFormat\n{\n    #values = DEFAULT_VALUES;\n\n    /**\n     * One-shot TGA write from a normalized RGBA payload.\n     *\n     * @param {object} payload As emitted for `rgba`.\n     * @param {object} [options] `compress` for run-length encoding.\n     * @returns {Uint8Array} TGA bytes.\n     */\n    static write(payload, options = {})\n    {\n        return encodeTga(payload, options);\n    }\n\n    /**\n     * Write a normalized RGBA payload as TGA bytes.\n     *\n     * @param {object} payload As emitted for `rgba`.\n     * @param {object} [options] `compress` for run-length encoding.\n     * @returns {Uint8Array} TGA bytes.\n     */\n    Write(payload, options = {})\n    {\n        return encodeTga(payload, options);\n    }\n\n    /**\n     * Create a reusable TGA format profile.\n     *\n     * @param {object} [options] Default read/inspect options.\n     */\n    constructor(options = {})\n    {\n        super();\n        this.SetValues(options);\n    }\n\n    /**\n     * Merge options into this profile.\n     *\n     * @param {object} [options] Values to merge.\n     * @returns {CjsTgaFormat} This format profile.\n     */\n    SetValues(options = {})\n    {\n        this.#values = normalizeValues(this.#values, { inputType: \"tga\", ...options }, FORMAT_NAME);\n        return this;\n    }\n\n    /**\n     * Get normalized profile values with optional per-call overrides.\n     *\n     * @param {object} [options] Per-call values.\n     * @returns {object} Normalized read values.\n     */\n    GetValues(options = {})\n    {\n        return normalizeValues(this.#values, { inputType: \"tga\", ...options }, FORMAT_NAME);\n    }\n\n    /**\n     * Read TGA bytes with this profile.\n     *\n     * @param {Uint8Array|ArrayBuffer|DataView} input TGA bytes.\n     * @param {object} [options] Per-call values.\n     * @returns {object} GPU-free raw/debug/RGBA payload for the selected emit target.\n     */\n    Read(input, options = {})\n    {\n        return readWithValues(input, this.GetValues(options), \"tga\");\n    }\n\n    /**\n     * Read TGA bytes asynchronously with this profile.\n     *\n     * @param {Uint8Array|ArrayBuffer|DataView} input TGA bytes.\n     * @param {object} [options] Per-call values.\n     * @returns {Promise<object>} GPU-free raw/debug/RGBA payload for the selected emit target.\n     */\n    async ReadAsync(input, options = {})\n    {\n        return this.Read(input, options);\n    }\n\n    /**\n     * Inspect TGA bytes without decoding full image data.\n     *\n     * @param {Uint8Array|ArrayBuffer|DataView} input TGA bytes.\n     * @param {object} [options] Per-call values.\n     * @returns {object} TGA header metadata.\n     */\n    Inspect(input, options = {})\n    {\n        return inspectWithValues(input, this.GetValues(options), \"tga\");\n    }\n\n    /**\n     * Convert format output into JSON-compatible debug data.\n     *\n     * @param {any} value Format output.\n     * @returns {any} JSON-compatible value.\n     */\n    ToJSON(value)\n    {\n        return toJsonValue(value);\n    }\n\n    /**\n     * One-shot TGA read.\n     *\n     * @param {Uint8Array|ArrayBuffer|DataView} input TGA bytes.\n     * @param {object} [options] Read options.\n     * @returns {object} GPU-free raw/debug/RGBA payload for the selected emit target.\n     */\n    static read(input, options = {})\n    {\n        return readWithValues(input, normalizeValues(DEFAULT_VALUES, { inputType: \"tga\", ...options }, FORMAT_NAME), \"tga\");\n    }\n\n    /**\n     * One-shot asynchronous TGA read.\n     *\n     * @param {Uint8Array|ArrayBuffer|DataView} input TGA bytes.\n     * @param {object} [options] Read options.\n     * @returns {Promise<object>} GPU-free raw/debug/RGBA payload for the selected emit target.\n     */\n    static async readAsync(input, options = {})\n    {\n        return CjsTgaFormat.read(input, options);\n    }\n\n    /**\n     * One-shot TGA inspection.\n     *\n     * @param {Uint8Array|ArrayBuffer|DataView} input TGA bytes.\n     * @param {object} [options] Inspect options.\n     * @returns {object} TGA header metadata.\n     */\n    static inspect(input, options = {})\n    {\n        return inspectWithValues(input, normalizeValues(DEFAULT_VALUES, { inputType: \"tga\", ...options }, FORMAT_NAME), \"tga\");\n    }\n\n    /**\n     * One-shot TGA support probe.\n     *\n     * @param {Uint8Array|ArrayBuffer|DataView} input TGA bytes.\n     * @param {object} [options] Probe options.\n     * @returns {object} Support/probe report.\n     */\n    static probeSupport(input, options = {})\n    {\n        return probeSupportWithValues(input, normalizeValues(DEFAULT_VALUES, { inputType: \"tga\", ...options }, FORMAT_NAME), \"tga\");\n    }\n\n    /**\n     * Convert format output into JSON-compatible debug data.\n     *\n     * @param {any} value Format output.\n     * @returns {any} JSON-compatible value.\n     */\n    static toJSON(value)\n    {\n        return toJsonValue(value);\n    }\n\n    /**\n     * Test whether bytes look like a TGA file.\n     *\n     * @param {Uint8Array|ArrayBuffer|DataView} input Candidate TGA bytes.\n     * @returns {boolean} True when the TGA header looks valid.\n     */\n    static isTGA(input)\n    {\n        try\n        {\n            return isTGA(asUint8Array(input, \"Image input\"));\n        }\n        catch\n        {\n            return false;\n        }\n    }\n\n    /**\n     * Emit targets for this format (canonical frozen enum).\n     */\n    static Output = Object.freeze({\n        IMAGE: OUTPUT_IMAGE,\n        RGBA: OUTPUT_RGBA,\n        RAW: OUTPUT_RAW,\n        JSON: OUTPUT_JSON\n    });\n\n    static OUTPUT_TGA_JSON = \"tgaJson\";\n\n    static id = \"tga\";\n\n    static mediaTypes = Object.freeze([ \"image\" ]);\n\n    static inputs = CjsFormat.defineInputs({\n        rgba: { default: true, options: [ \"compress\" ] }\n    });\n\n    static outputs = CjsFormat.defineOutputs({\n\n        image: { decoded: true, probes: [ \"image\", \"rgba\" ] },\n\n        rgba: { decoded: true },\n\n        tgaJson: { role: \"debug\", probes: [ \"tgaJson\", \"raw\" ] },\n\n        raw: { role: \"debug\", default: true, passthrough: true }\n\n    });\n\n    static extensions = Object.freeze([ \".tga\" ]);\n}\n\nexport default CjsTgaFormat;\n"],"names":["FORMAT_NAME","CjsTgaFormat","CjsFormat","DEFAULT_VALUES","write","payload","options","encodeTga","Write","constructor","SetValues","normalizeValues","inputType","GetValues","Read","input","readWithValues","ReadAsync","Inspect","inspectWithValues","ToJSON","value","toJsonValue","read","readAsync","inspect","probeSupport","probeSupportWithValues","toJSON","isTGA","asUint8Array","Output","Object","freeze","IMAGE","OUTPUT_IMAGE","RGBA","OUTPUT_RGBA","RAW","OUTPUT_RAW","JSON","OUTPUT_JSON","OUTPUT_TGA_JSON","id","mediaTypes","inputs","defineInputs","rgba","default","outputs","defineOutputs","image","decoded","probes","tgaJson","role","raw","passthrough","extensions"],"mappings":"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"}