@carbonenginejs/runtime 0.1.0-alpha.4 → 0.1.0-alpha.5

package/dist/resource/formats/static/CjsStaticFormat.js.map

@@ -1 +1 @@
-{"version":3,"file":"CjsStaticFormat.js","sources":["../../../../../src/resource/formats/static/CjsStaticFormat.js"],"sourcesContent":["import { CjsFormat } from \"../../format/CjsFormat.js\";\n\nconst SQLITE_SIGNATURE = \"SQLite format 3\\0\";\nconst PICKLE_PREFIX_BYTES = 4;\n\n/** Container families found behind the single `.static` extension. */\nexport const CJS_STATIC_FAMILIES = Object.freeze({\n  SQLITE: \"sqlite\",\n  PICKLE: \"pickle\",\n  UNKNOWN: \"unknown\"\n});\n\n/**\n * Identifies which container a client `.static` file actually holds.\n *\n * The extension names a role, not a format. Three unrelated containers ship\n * under it, and each fails in its own way when guessed at:\n *\n * - **SQLite 3** — a `cache(key, value, time)` plus `indexes(key, value)`\n *   database whose values are JSON documents. `CjsSqliteFormat` reads it.\n * - **Embedded schema** — a four-byte little-endian SCHEMA LENGTH followed by\n *   that schema as a protocol-0 pickle, and then a payload. The prefix is not a\n *   wrapper to skip: slice `[4, 4 + length)` for the schema and give the rest\n *   to `CjsSchemaBoundFormat`. All 25 of these name one global,\n *   `collections.OrderedDict`, which the pickle reader rebuilds as plain data.\n * - **Schema-bound** — a binary record container whose `.schema` companion is\n *   YAML describing its own layout: attribute sizes and types, optional flags,\n *   lists with a fixed item size, vectors with a precision, and a key footer of\n *   key-to-offset pairs. Nothing needs deriving, because the build ships the\n *   layout. Six datasets are stored this way - the map skeleton of regions,\n *   constellations and systems. `CjsSchemaBoundFormat` reads it, given that\n *   companion, and reads the embedded-schema family above from the same code.\n *\n * Detection is signature-based and never executes or trusts file names.\n *\n * **This class identifies and does not decode.** It reports the family, the\n * payload offset and what is still missing; the caller takes that answer to the\n * format that owns the family. It carried a `read()` that dispatched to\n * `CjsPickleFormat` and `CjsSqliteFormat` until 2026-08-15, which made an\n * identification format the routing table for two others and put the decision\n * about what to decode in the wrong place. Nothing outside its own tests ever\n * called it.\n */\nexport class CjsStaticFormat extends CjsFormat\n{\n\n  /**\n   * Report which family a container holds, on the declaration seam.\n   *\n   * `.static` declares nothing: the extension names a role and every family\n   * wears it. The signature is therefore the only claim there is, which is why\n   * this format reads it here rather than trusting a name.\n   *\n   * @param {ArrayBuffer|ArrayBufferView} input Container bytes.\n   * @param {object} [options] Probe options.\n   * @returns {CjsResourceProbe} Declaration-derived probe.\n   */\n  static probeSupport(input, options = null)\n  {\n    const detected = this.describe(input);\n    return {\n      format: this.id,\n      source: options?.source || \"buffer\",\n      recognized: detected.family !== CJS_STATIC_FAMILIES.UNKNOWN,\n      supported: false,\n      reason: detected.reason ?? `Recognized a ${detected.family} container.`,\n      metadata: detected\n    };\n  }\n\n  /**\n   * Alias for canonical naming.\n   *\n   * @param {ArrayBuffer|ArrayBufferView} input Container bytes.\n   * @param {object} [options] Probe options.\n   * @returns {CjsResourceProbe} Declaration-derived probe.\n   */\n  static inspect(input, options = null)\n  {\n    void options;\n    return this.describe(input);\n  }\n\n  /**\n   * Describe one container without decoding it or building a probe.\n   *\n   * @param {ArrayBuffer|ArrayBufferView} input Container bytes.\n   * @returns {object} Family, payload offset, and whether this package decodes it.\n   */\n  static describe(input)\n  {\n    const bytes = Normalize(input);\n\n    if (MatchesSqlite(bytes))\n    {\n      return {\n        family: CJS_STATIC_FAMILIES.SQLITE,\n        byteLength: bytes.byteLength,\n        payloadOffset: 0,\n        prefix: null,\n        // Decodable outright since CjsSqliteFormat landed. This reported\n        // `requires: \"sqlite\"` while a caller had to supply an engine, and was\n        // the example behind the argument that a capability can depend on the\n        // caller's environment - an argument that now needs a different one.\n        decodable: true,\n        requires: null,\n        reason: \"Recognized a SQLite container.\"\n      };\n    }\n\n    if (MatchesPickle(bytes))\n    {\n      const view = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);\n\n      return {\n        family: CJS_STATIC_FAMILIES.PICKLE,\n        byteLength: bytes.byteLength,\n        payloadOffset: PICKLE_PREFIX_BYTES,\n        prefix: view.getUint32(0, true),\n        decodable: true,\n        requires: null,\n        reason: null\n      };\n    }\n\n    return {\n      family: CJS_STATIC_FAMILIES.UNKNOWN,\n      byteLength: bytes.byteLength,\n      payloadOffset: 0,\n      prefix: null,\n      decodable: false,\n      requires: \"schema\",\n      // `decodable` is this format's own answer, and it stays false: these bytes\n      // carry nothing to identify, so the family is an inference from the absence\n      // of the other two signatures rather than a reading. `requires` names what\n      // closes that gap - with the companion, CjsSchemaBoundFormat decodes it.\n      reason: \"No signature. A schema-bound container needs its .schema companion, \"\n        + \"which is YAML describing the layout. CjsSchemaBoundFormat reads it from there.\"\n    };\n  }\n\n  /**\n   * Return the decodable payload for a container, without its wrapper.\n   *\n   * @param {ArrayBuffer|ArrayBufferView} input Container bytes.\n   * @returns {Uint8Array} Payload bytes.\n   */\n  static payload(input)\n  {\n    const bytes = Normalize(input);\n    const detected = this.describe(bytes);\n\n    return bytes.subarray(detected.payloadOffset);\n  }\n\n\n  static id = \"static\";\n  static extensions = Object.freeze([ \".static\" ]);\n  static mediaTypes = Object.freeze([ \"data\" ]);\n  static outputs = Object.freeze({});\n\n  /**\n   * The extension is the only input this format claims.\n   *\n   * Naming the three families here would be a lie in the other direction: a\n   * caller cannot hand this format \"a pickle\" or \"a sqlite\" and expect it to\n   * route, because the whole point of the class is that `.static` declares\n   * nothing and the signature has to be read. The family belongs in\n   * `describe()`, which measures it, not in a static that asserts it.\n   */\n\n}\n\nfunction MatchesSqlite(bytes)\n{\n  if (bytes.byteLength < SQLITE_SIGNATURE.length) return false;\n\n  for (let index = 0; index < SQLITE_SIGNATURE.length; index++)\n  {\n    if (bytes[index] !== SQLITE_SIGNATURE.charCodeAt(index)) return false;\n  }\n\n  return true;\n}\n\nfunction MatchesPickle(bytes)\n{\n  // A protocol-0 pickle opens a container then names it: \"(dp1\\n\" or \"(lp1\\n\".\n  if (bytes.byteLength < PICKLE_PREFIX_BYTES + 3) return false;\n  if (bytes[PICKLE_PREFIX_BYTES] !== 0x28) return false;\n\n  const kind = bytes[PICKLE_PREFIX_BYTES + 1];\n\n  return kind === 0x64 || kind === 0x6c;\n}\n\nfunction Normalize(input)\n{\n  if (input instanceof ArrayBuffer) return new Uint8Array(input);\n\n  if (ArrayBuffer.isView(input))\n  {\n    return new Uint8Array(input.buffer, input.byteOffset, input.byteLength);\n  }\n\n  const error = new TypeError(\"A .static container must be an ArrayBuffer or a view over one.\");\n\n  error.code = \"CJS_STATIC_FORMAT_INPUT_INVALID\";\n  throw error;\n}\n"],"names":["SQLITE_SIGNATURE","PICKLE_PREFIX_BYTES","CJS_STATIC_FAMILIES","Object","freeze","SQLITE","PICKLE","UNKNOWN","CjsStaticFormat","CjsFormat","probeSupport","input","options","detected","describe","format","id","source","recognized","family","supported","reason","metadata","inspect","bytes","Normalize","MatchesSqlite","byteLength","payloadOffset","prefix","decodable","requires","MatchesPickle","view","DataView","buffer","byteOffset","getUint32","payload","subarray","extensions","mediaTypes","outputs","length","index","charCodeAt","kind","ArrayBuffer","Uint8Array","isView","error","TypeError","code"],"mappings":"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"}
+{"version":3,"file":"CjsStaticFormat.js","sources":["../../../../../src/resource/formats/static/CjsStaticFormat.js"],"sourcesContent":["import { CjsFormat } from \"../../format/CjsFormat.js\";\n\nconst SQLITE_SIGNATURE = \"SQLite format 3\\0\";\nconst PICKLE_PREFIX_BYTES = 4;\n\n/** Container families found behind the single `.static` extension. */\nexport const CJS_STATIC_FAMILIES = Object.freeze({\n  SQLITE: \"sqlite\",\n  PICKLE: \"pickle\",\n  UNKNOWN: \"unknown\"\n});\n\n/**\n * Identifies which container a client `.static` file actually holds.\n *\n * The extension names a role, not a format. Three unrelated containers ship\n * under it, and each fails in its own way when guessed at:\n *\n * - **SQLite 3** — a `cache(key, value, time)` plus `indexes(key, value)`\n *   database whose values are JSON documents. `CjsSqliteFormat` reads it.\n * - **Embedded schema** — a four-byte little-endian SCHEMA LENGTH followed by\n *   that schema as a protocol-0 pickle, and then a payload. The prefix is not a\n *   wrapper to skip: slice `[4, 4 + length)` for the schema and give the rest\n *   to `CjsSchemaBoundFormat`. All 25 of these name one global,\n *   `collections.OrderedDict`, which the pickle reader rebuilds as plain data.\n * - **Schema-bound** — a binary record container whose `.schema` companion is\n *   YAML describing its own layout: attribute sizes and types, optional flags,\n *   lists with a fixed item size, vectors with a precision, and a key footer of\n *   key-to-offset pairs. Nothing needs deriving, because the build ships the\n *   layout. Six datasets are stored this way - the map skeleton of regions,\n *   constellations and systems. `CjsSchemaBoundFormat` reads it, given that\n *   companion, and reads the embedded-schema family above from the same code.\n *\n * Detection is signature-based and never executes or trusts file names.\n *\n * **This class identifies and does not decode.** It reports the family, the\n * payload offset and what is still missing; the caller takes that answer to the\n * format that owns the family. It carried a `read()` that dispatched to\n * `CjsPickleFormat` and `CjsSqliteFormat` until 2026-08-15, which made an\n * identification format the routing table for two others and put the decision\n * about what to decode in the wrong place. Nothing outside its own tests ever\n * called it.\n */\nexport class CjsStaticFormat extends CjsFormat\n{\n\n  /**\n   * Report which family a container holds, on the declaration seam.\n   *\n   * `.static` declares nothing: the extension names a role and every family\n   * wears it. The signature is therefore the only claim there is, which is why\n   * this format reads it here rather than trusting a name.\n   *\n   * @param {ArrayBuffer|ArrayBufferView} input Container bytes.\n   * @param {object} [options] Probe options.\n   * @returns {CjsResourceProbe} Declaration-derived probe.\n   */\n  static probeSupport(input, options = null)\n  {\n    const detected = this.describe(input);\n    return {\n      format: this.id,\n      source: options?.source || \"buffer\",\n      recognized: detected.family !== CJS_STATIC_FAMILIES.UNKNOWN,\n      supported: false,\n      reason: detected.reason ?? `Recognized a ${detected.family} container.`,\n      metadata: detected\n    };\n  }\n\n  /**\n   * Alias for canonical naming.\n   *\n   * @param {ArrayBuffer|ArrayBufferView} input Container bytes.\n   * @param {object} [options] Probe options.\n   * @returns {CjsResourceProbe} Declaration-derived probe.\n   */\n  static inspect(input, options = null)\n  {\n    void options;\n    return this.describe(input);\n  }\n\n  /**\n   * Describe one container without decoding it or building a probe.\n   *\n   * @param {ArrayBuffer|ArrayBufferView} input Container bytes.\n   * @returns {object} Family, payload offset, and whether this package decodes it.\n   */\n  static describe(input)\n  {\n    const bytes = Normalize(input);\n\n    if (MatchesSqlite(bytes))\n    {\n      return {\n        family: CJS_STATIC_FAMILIES.SQLITE,\n        byteLength: bytes.byteLength,\n        payloadOffset: 0,\n        prefix: null,\n        // Decodable outright since CjsSqliteFormat landed. This reported\n        // `requires: \"sqlite\"` while a caller had to supply an engine, and was\n        // the example behind the argument that a capability can depend on the\n        // caller's environment - an argument that now needs a different one.\n        decodable: true,\n        requires: null,\n        reason: \"Recognized a SQLite container.\"\n      };\n    }\n\n    if (MatchesPickle(bytes))\n    {\n      const view = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);\n\n      return {\n        family: CJS_STATIC_FAMILIES.PICKLE,\n        byteLength: bytes.byteLength,\n        payloadOffset: PICKLE_PREFIX_BYTES,\n        prefix: view.getUint32(0, true),\n        decodable: true,\n        requires: null,\n        reason: null\n      };\n    }\n\n    return {\n      family: CJS_STATIC_FAMILIES.UNKNOWN,\n      byteLength: bytes.byteLength,\n      payloadOffset: 0,\n      prefix: null,\n      decodable: false,\n      requires: \"schema\",\n      // `decodable` is this format's own answer, and it stays false: these bytes\n      // carry nothing to identify, so the family is an inference from the absence\n      // of the other two signatures rather than a reading. `requires` names what\n      // closes that gap - with the companion, CjsSchemaBoundFormat decodes it.\n      reason: \"No signature. A schema-bound container needs its .schema companion, \"\n        + \"which is YAML describing the layout. CjsSchemaBoundFormat reads it from there.\"\n    };\n  }\n\n  /**\n   * Return the decodable payload for a container, without its wrapper.\n   *\n   * @param {ArrayBuffer|ArrayBufferView} input Container bytes.\n   * @returns {Uint8Array} Payload bytes.\n   */\n  static payload(input)\n  {\n    const bytes = Normalize(input);\n    const detected = this.describe(bytes);\n\n    return bytes.subarray(detected.payloadOffset);\n  }\n\n\n  static id = \"CjsStaticFormat\";\n  static extensions = [ \".static\" ];\n  static mediaTypes = [ \"data\" ];\n  static outputs = {};\n\n  /**\n   * The extension is the only input this format claims.\n   *\n   * Naming the three families here would be a lie in the other direction: a\n   * caller cannot hand this format \"a pickle\" or \"a sqlite\" and expect it to\n   * route, because the whole point of the class is that `.static` declares\n   * nothing and the signature has to be read. The family belongs in\n   * `describe()`, which measures it, not in a static that asserts it.\n   */\n\n}\n\nfunction MatchesSqlite(bytes)\n{\n  if (bytes.byteLength < SQLITE_SIGNATURE.length) return false;\n\n  for (let index = 0; index < SQLITE_SIGNATURE.length; index++)\n  {\n    if (bytes[index] !== SQLITE_SIGNATURE.charCodeAt(index)) return false;\n  }\n\n  return true;\n}\n\nfunction MatchesPickle(bytes)\n{\n  // A protocol-0 pickle opens a container then names it: \"(dp1\\n\" or \"(lp1\\n\".\n  if (bytes.byteLength < PICKLE_PREFIX_BYTES + 3) return false;\n  if (bytes[PICKLE_PREFIX_BYTES] !== 0x28) return false;\n\n  const kind = bytes[PICKLE_PREFIX_BYTES + 1];\n\n  return kind === 0x64 || kind === 0x6c;\n}\n\nfunction Normalize(input)\n{\n  if (input instanceof ArrayBuffer) return new Uint8Array(input);\n\n  if (ArrayBuffer.isView(input))\n  {\n    return new Uint8Array(input.buffer, input.byteOffset, input.byteLength);\n  }\n\n  const error = new TypeError(\"A .static container must be an ArrayBuffer or a view over one.\");\n\n  error.code = \"CJS_STATIC_FORMAT_INPUT_INVALID\";\n  throw error;\n}\n"],"names":["SQLITE_SIGNATURE","PICKLE_PREFIX_BYTES","CJS_STATIC_FAMILIES","Object","freeze","SQLITE","PICKLE","UNKNOWN","CjsStaticFormat","CjsFormat","probeSupport","input","options","detected","describe","format","id","source","recognized","family","supported","reason","metadata","inspect","bytes","Normalize","MatchesSqlite","byteLength","payloadOffset","prefix","decodable","requires","MatchesPickle","view","DataView","buffer","byteOffset","getUint32","payload","subarray","extensions","mediaTypes","outputs","length","index","charCodeAt","kind","ArrayBuffer","Uint8Array","isView","error","TypeError","code"],"mappings":"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"}

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

@@ -1,5 +1,6 @@
 import { CjsFormat } from '../../format/CjsFormat.js';
-import { DEFAULT_VALUES, normalizeValues, validateClassKey, validateClass, readWithValues, writeWithValues, inspectWithValues, OUTPUT_CMF, OUTPUT_GR2, OUTPUT_SHARED, OUTPUT_STL_JSON, OUTPUT_JSON, CLASS_KEYS } from './core/helpers.js';
+import { CjsGeometryFormat } from '../../format/CjsGeometryFormat.js';
+import { DEFAULT_VALUES, normalizeValues, readWithValues, writeWithValues, inspectWithValues, CLASS_KEYS } from './core/helpers.js';
 import { toJsonWithArrayValues } from '../../format/jsonPolicies.js';
 import { isStl, isBinaryStl } from './core/stl.js';
 
@@ -47,18 +48,18 @@ const FORMAT_NAME = "CjsStlFormat";
  * STL is a triangle-only import/export format; the JSON contract is the shared
  * CarbonEngineJS mesh schema.
  */
-class CjsStlFormat extends CjsFormat {
-  #emit = DEFAULT_VALUES.emit;
-  #source = DEFAULT_VALUES.source;
-  #binary = DEFAULT_VALUES.binary;
-  #solidName = DEFAULT_VALUES.solidName;
-  #scale = DEFAULT_VALUES.scale;
-  #recalculateNormals = DEFAULT_VALUES.recalculateNormals;
-  #weldVertices = DEFAULT_VALUES.weldVertices;
-  #weldTolerance = DEFAULT_VALUES.weldTolerance;
-  #skipDegenerate = DEFAULT_VALUES.skipDegenerate;
-  #requireWatertight = DEFAULT_VALUES.requireWatertight;
-  #classes = DEFAULT_VALUES.classes;
+class CjsStlFormat extends CjsGeometryFormat {
+  _emit = DEFAULT_VALUES.emit;
+  _source = DEFAULT_VALUES.source;
+  _binary = DEFAULT_VALUES.binary;
+  _solidName = DEFAULT_VALUES.solidName;
+  _scale = DEFAULT_VALUES.scale;
+  _recalculateNormals = DEFAULT_VALUES.recalculateNormals;
+  _weldVertices = DEFAULT_VALUES.weldVertices;
+  _weldTolerance = DEFAULT_VALUES.weldTolerance;
+  _skipDegenerate = DEFAULT_VALUES.skipDegenerate;
+  _requireWatertight = DEFAULT_VALUES.requireWatertight;
+  _classes = DEFAULT_VALUES.classes;
 
   /**
    * Create a reusable format profile.
@@ -83,17 +84,17 @@ class CjsStlFormat extends CjsFormat {
    */
   SetValues(options = {}) {
     const values = normalizeValues(this.GetValues(), options, FORMAT_NAME);
-    this.#emit = values.emit;
-    this.#source = values.source;
-    this.#binary = values.binary;
-    this.#solidName = values.solidName;
-    this.#scale = values.scale;
-    this.#recalculateNormals = values.recalculateNormals;
-    this.#weldVertices = values.weldVertices;
-    this.#weldTolerance = values.weldTolerance;
-    this.#skipDegenerate = values.skipDegenerate;
-    this.#requireWatertight = values.requireWatertight;
-    this.#classes = values.classes;
+    this._emit = values.emit;
+    this._source = values.source;
+    this._binary = values.binary;
+    this._solidName = values.solidName;
+    this._scale = values.scale;
+    this._recalculateNormals = values.recalculateNormals;
+    this._weldVertices = values.weldVertices;
+    this._weldTolerance = values.weldTolerance;
+    this._skipDegenerate = values.skipDegenerate;
+    this._requireWatertight = values.requireWatertight;
+    this._classes = values.classes;
     return this;
   }
 
@@ -106,78 +107,20 @@ class CjsStlFormat extends CjsFormat {
    */
   GetValues(options = {}) {
     return normalizeValues({
-      emit: this.#emit,
-      source: this.#source,
-      binary: this.#binary,
-      solidName: this.#solidName,
-      scale: this.#scale,
-      recalculateNormals: this.#recalculateNormals,
-      weldVertices: this.#weldVertices,
-      weldTolerance: this.#weldTolerance,
-      skipDegenerate: this.#skipDegenerate,
-      requireWatertight: this.#requireWatertight,
-      classes: this.#classes
+      emit: this._emit,
+      source: this._source,
+      binary: this._binary,
+      solidName: this._solidName,
+      scale: this._scale,
+      recalculateNormals: this._recalculateNormals,
+      weldVertices: this._weldVertices,
+      weldTolerance: this._weldTolerance,
+      skipDegenerate: this._skipDegenerate,
+      requireWatertight: this._requireWatertight,
+      classes: this._classes
     }, options, FORMAT_NAME);
   }
 
-  /**
-   * Set multiple node-class constructors for this profile.
-   *
-   * @param {object} [classes] Map of node class keys to constructors.
-   * @returns {CjsStlFormat} This format profile.
-   */
-  SetClasses(classes = {}) {
-    return this.SetValues({
-      classes
-    });
-  }
-
-  /**
-   * Set one node-class constructor for this profile.
-   *
-   * @param {string} type Node class key.
-   * @param {Function|null|undefined} Class Constructor to use, or nullish to delete.
-   * @returns {CjsStlFormat} This format profile.
-   */
-  SetClass(type, Class) {
-    if (Class === null || Class === undefined) {
-      validateClassKey(type, FORMAT_NAME);
-      const classes = {
-        ...this.#classes
-      };
-      delete classes[type];
-      this.#classes = classes;
-      return this;
-    }
-    validateClass(type, Class, FORMAT_NAME);
-    return this.SetValues({
-      classes: {
-        [type]: Class
-      }
-    });
-  }
-
-  /**
-   * Get a configured node-class constructor.
-   *
-   * @param {string} type Node class key.
-   * @returns {Function|undefined} The registered constructor, if any.
-   */
-  GetClass(type) {
-    validateClassKey(type, FORMAT_NAME);
-    return this.#classes[type];
-  }
-
-  /**
-   * Whether this format profile has a constructor registered for a node class key.
-   *
-   * @param {string} type Node class key.
-   * @returns {boolean} True when a constructor is registered.
-   */
-  HasClass(type) {
-    return !!this.GetClass(type);
-  }
-
   /**
    * Read STL text/bytes with this profile's values.
    *
@@ -297,16 +240,8 @@ class CjsStlFormat extends CjsFormat {
   /**
    * Emit targets for this format (canonical frozen enum).
    */
-  static Output = Object.freeze({
-    JSON: OUTPUT_JSON,
-    STL_JSON: OUTPUT_STL_JSON,
-    SHARED: OUTPUT_SHARED,
-    GR2: OUTPUT_GR2,
-    CMF: OUTPUT_CMF
-  });
-  static CLASS_KEYS = CLASS_KEYS;
-  static id = "stl";
-  static mediaTypes = Object.freeze(["geometry"]);
+  static classKeys = CLASS_KEYS;
+  static id = "CjsStlFormat";
   // STL takes the shared geometry root directly rather than going through
   // CMF, because it carries triangles and nothing else worth preserving.
   // Lossless for what STL can represent; everything else was never in scope.
@@ -337,7 +272,7 @@ class CjsStlFormat extends CjsFormat {
       decoded: true
     }
   });
-  static extensions = Object.freeze([".stl"]);
+  static extensions = [".stl"];
 }
 
 export { CjsStlFormat, CjsStlFormat as default };

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\";\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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"}
+{"version":3,"file":"CjsStlFormat.js","sources":["../../../../../src/resource/formats/stl/CjsStlFormat.js"],"sourcesContent":["import { CjsFormat } from \"../../format/CjsFormat.js\";\nimport { CjsGeometryFormat } from \"../../format/CjsGeometryFormat.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    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 CjsGeometryFormat\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     * 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 classKeys = CLASS_KEYS;\n    static id = \"CjsStlFormat\";\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 = [ \".stl\" ];\n\n}\n\nexport default CjsStlFormat;\n"],"names":["FORMAT_NAME","CjsStlFormat","CjsGeometryFormat","_emit","DEFAULT_VALUES","emit","_source","source","_binary","binary","_solidName","solidName","_scale","scale","_recalculateNormals","recalculateNormals","_weldVertices","weldVertices","_weldTolerance","weldTolerance","_skipDegenerate","skipDegenerate","_requireWatertight","requireWatertight","_classes","classes","constructor","options","SetValues","values","normalizeValues","GetValues","Read","input","readWithValues","Write","writeWithValues","Inspect","inspectWithValues","ToJSON","value","toJsonValue","read","write","inspect","toJSON","isStl","isBinaryStl","classKeys","CLASS_KEYS","id","inputs","CjsFormat","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

@@ -1,6 +1,7 @@
+import { CjsGeometryFormat } from '../../../format/CjsGeometryFormat.js';
 import { hydrateJson } from './json.js';
-import { buildCmfFromShared } from './targets.js';
 import { GR2_CLASS_KEYS, CMF_CLASS_KEYS } from '../../cmf/core/constants.js';
+import { buildCmfFromFlatShared } from '../../cmf/core/flatShared.js';
 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';
@@ -49,18 +50,6 @@ 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.
- */
-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.
  *
@@ -69,10 +58,7 @@ function validateClassKey(key, readerName = "CjsStlFormat") {
  * @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`);
-  }
+  CjsGeometryFormat.validateClass(key, Class, CLASS_KEYS, readerName);
 }
 function mergeClasses(base, classes, readerName) {
   if (!classes || typeof classes !== "object") {
@@ -168,7 +154,7 @@ 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, {
+    return hydrateCmf(buildCmfFromFlatShared(json), values.classes, {
       source: values.source
     }, "CjsStlFormat CMF");
   }
@@ -218,5 +204,5 @@ function inspectWithValues(input, values) {
   return inspectTriangles(source.triangles, values, source);
 }
 
-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 };
+export { CLASS_KEYS, DEFAULT_VALUES, GR2_CLASS_KEYS, OUTPUT_CMF, OUTPUT_GR2, OUTPUT_JSON, OUTPUT_SHARED, OUTPUT_STL_JSON, inspectWithValues, normalizeValues, readWithValues, validateClass, 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":["/**\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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"}
+{"version":3,"file":"helpers.js","sources":["../../../../../../src/resource/formats/stl/core/helpers.js"],"sourcesContent":["/**\n * Internal pipeline glue for CjsStlFormat.\n */\n\nimport { CjsGeometryFormat } from \"../../../format/CjsGeometryFormat.js\";\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    CjsGeometryFormat.validateClassKey(key, CLASS_KEYS, readerName);\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    CjsGeometryFormat.validateClass(key, Class, CLASS_KEYS, readerName);\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","validateClass","key","Class","CjsGeometryFormat","mergeClasses","base","next","entries","undefined","sanitizeName","trim","normalizeValues","options","keys","has","JSON","stringify","values","normalizeEmit","prototype","hasOwnProperty","call","hasClasses","some","readWithValues","format","input","parsed","parseStl","json","trianglesToJson","triangles","hydrateCmf","buildCmfFromShared","hydrateJson","writeWithValues","jsonToTriangles","length","Error","report","inspectTriangles","grannyFileSource","printable","issues","map","issue","join","writeBinaryStl","writeAsciiStl","inspectWithValues","trianglesFromInput"],"mappings":"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"}

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

@@ -1,6 +1,7 @@
 import { asUint8Array } from '#utils/bytes';
 import { CjsFormat } from '../../format/CjsFormat.js';
-import { DEFAULT_VALUES, normalizeValues, readWithValues, inspectWithValues, probeSupportWithValues, OUTPUT_JSON, OUTPUT_RAW, OUTPUT_RGBA, OUTPUT_IMAGE } from './core/helpers.js';
+import { CjsImageFormat } from '../../format/CjsImageFormat.js';
+import { DEFAULT_VALUES, normalizeValues, readWithValues, inspectWithValues, probeSupportWithValues } from './core/helpers.js';
 import { encodeTga } from './core/writer.js';
 import { toJsonWithByteSummary } from '../../format/jsonPolicies.js';
 import { isTGA } from '../../format/imageSignatures.js';
@@ -11,8 +12,8 @@ const FORMAT_NAME = "CjsTgaFormat";
  * TGA format profile that inspects header metadata and reads TGA bytes into
  * raw, debug JSON, or decoded RGBA image payloads.
  */
-class CjsTgaFormat extends CjsFormat {
-  #values = DEFAULT_VALUES;
+class CjsTgaFormat extends CjsImageFormat {
+  _values = DEFAULT_VALUES;
 
   /**
    * One-shot TGA write from a normalized RGBA payload.
@@ -53,7 +54,7 @@ class CjsTgaFormat extends CjsFormat {
    * @returns {CjsTgaFormat} This format profile.
    */
   SetValues(options = {}) {
-    this.#values = normalizeValues(this.#values, {
+    this._values = normalizeValues(this._values, {
       inputType: "tga",
       ...options
     }, FORMAT_NAME);
@@ -67,7 +68,7 @@ class CjsTgaFormat extends CjsFormat {
    * @returns {object} Normalized read values.
    */
   GetValues(options = {}) {
-    return normalizeValues(this.#values, {
+    return normalizeValues(this._values, {
       inputType: "tga",
       ...options
     }, FORMAT_NAME);
@@ -196,15 +197,9 @@ class CjsTgaFormat extends CjsFormat {
   /**
    * Emit targets for this format (canonical frozen enum).
    */
-  static Output = Object.freeze({
-    IMAGE: OUTPUT_IMAGE,
-    RGBA: OUTPUT_RGBA,
-    RAW: OUTPUT_RAW,
-    JSON: OUTPUT_JSON
-  });
-  static OUTPUT_TGA_JSON = "tgaJson";
-  static id = "tga";
-  static mediaTypes = Object.freeze(["image"]);
+
+  static id = "CjsTgaFormat";
+  static mediaTypes = ["image"];
   static inputs = CjsFormat.defineInputs({
     rgba: {
       default: true,
@@ -229,7 +224,23 @@ class CjsTgaFormat extends CjsFormat {
       passthrough: true
     }
   });
-  static extensions = Object.freeze([".tga"]);
+
+  /**
+   * Fill a HostBitmap through this format's RGBA8 output, for Carbon's ImageIO
+   * registry (`CjsTgaFormat.carbon`). See CjsImageFormat.readImageFromRgbaPayload.
+   *
+   * @param {Uint8Array|ArrayBuffer} input Image bytes.
+   * @param {object} _loadParameters Load parameters; a single-mip image skips nothing.
+   * @param {object} bitmap Destination HostBitmap.
+   * @param {object|null} [metadata] Optional Metadata out.
+   * @returns {object} ImageIOResult.
+   */
+  static readImageNative(input, _loadParameters, bitmap, metadata = null) {
+    return this.readImageFromRgbaPayload(this.read(input, {
+      emit: "rgba"
+    }), bitmap, metadata);
+  }
+  static extensions = [".tga"];
 }
 
 export { CjsTgaFormat };

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 { CjsImageFormat } from \"../../format/CjsImageFormat.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 CjsImageFormat\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\n\n    static id = \"CjsTgaFormat\";\n\n    static mediaTypes = [ \"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    /**\n     * Fill a HostBitmap through this format's RGBA8 output, for Carbon's ImageIO\n     * registry (`CjsTgaFormat.carbon`). See CjsImageFormat.readImageFromRgbaPayload.\n     *\n     * @param {Uint8Array|ArrayBuffer} input Image bytes.\n     * @param {object} _loadParameters Load parameters; a single-mip image skips nothing.\n     * @param {object} bitmap Destination HostBitmap.\n     * @param {object|null} [metadata] Optional Metadata out.\n     * @returns {object} ImageIOResult.\n     */\n    static readImageNative(input, _loadParameters, bitmap, metadata = null)\n    {\n        return this.readImageFromRgbaPayload(this.read(input, { emit: \"rgba\" }), bitmap, metadata);\n    }\n\n    static extensions = [ \".tga\" ];\n}\n\nexport default CjsTgaFormat;\n"],"names":["FORMAT_NAME","CjsTgaFormat","CjsImageFormat","_values","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","id","mediaTypes","inputs","CjsFormat","defineInputs","rgba","default","outputs","defineOutputs","image","decoded","probes","tgaJson","role","raw","passthrough","readImageNative","_loadParameters","bitmap","metadata","readImageFromRgbaPayload","emit","extensions"],"mappings":"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"}