@carbonenginejs/runtime-resource 0.1.0

package/dist/formats/gltf/CjsGltfFormat.js

@@ -0,0 +1,284 @@
+import { DEFAULT_VALUES, normalizeValues, validateClassKey, validateClass, readWithValues, inspectWithValues, toJsonValue, importNodeModule, OUTPUT_JSON, OUTPUT_GLTF_JSON, OUTPUT_SHARED, OUTPUT_GR2, OUTPUT_CMF, CLASS_KEYS } from './core/helpers.js';
+import { isGlb, toBytes } from './core/parser.js';
+
+/**
+ * Exposed CarbonEngineJS-facing glTF/GLB format class.
+ *
+ * Keep this file small and reviewable: glTF parsing, accessor decoding,
+ * mesh conversion, skin conversion, animation conversion, and geometry helper
+ * glue live under src/core.
+ */
+
+const FORMAT_NAME = "CjsGltfFormat";
+
+/**
+ * CarbonEngineJS-facing glTF/GLB format surface.
+ *
+ * The Cjs prefix marks this as a JavaScript format/construction boundary.
+ * glTF is the import source; the public read contract is the shared
+ * CarbonEngineJS JSON mesh, skeleton, and animation schema.
+ */
+class CjsGltfFormat {
+  #emit = DEFAULT_VALUES.emit;
+  #source = DEFAULT_VALUES.source;
+  #buffers = DEFAULT_VALUES.buffers;
+  #packTangents = DEFAULT_VALUES.packTangents;
+  #uvHandedness = DEFAULT_VALUES.uvHandedness;
+  #rebuildMissingNormals = DEFAULT_VALUES.rebuildMissingNormals;
+  #rebuildMissingTangents = DEFAULT_VALUES.rebuildMissingTangents;
+  #rebuildMissingBiNormals = DEFAULT_VALUES.rebuildMissingBiNormals;
+  #classes = DEFAULT_VALUES.classes;
+
+  /**
+   * Create a reusable format profile.
+   *
+   * @param {object} [options] Default format values.
+   */
+  constructor(options = {}) {
+    this.SetValues(options);
+  }
+
+  /**
+   * Set format values for this reusable profile.
+   *
+   * @param {object} [options] Values to merge into the profile.
+   * @returns {CjsGltfFormat} This format profile.
+   */
+  SetValues(options = {}) {
+    const values = normalizeValues(this.GetValues(), options, FORMAT_NAME);
+    this.#emit = values.emit;
+    this.#source = values.source;
+    this.#buffers = values.buffers;
+    this.#packTangents = values.packTangents;
+    this.#uvHandedness = values.uvHandedness;
+    this.#rebuildMissingNormals = values.rebuildMissingNormals;
+    this.#rebuildMissingTangents = values.rebuildMissingTangents;
+    this.#rebuildMissingBiNormals = values.rebuildMissingBiNormals;
+    this.#classes = values.classes;
+    return this;
+  }
+
+  /**
+   * Get this profile's current values, optionally with per-call overrides.
+   *
+   * @param {object} [options] Optional values to merge into a copy.
+   * @returns {object} A copy of the effective values.
+   */
+  GetValues(options = {}) {
+    return normalizeValues({
+      emit: this.#emit,
+      source: this.#source,
+      buffers: this.#buffers,
+      packTangents: this.#packTangents,
+      uvHandedness: this.#uvHandedness,
+      rebuildMissingNormals: this.#rebuildMissingNormals,
+      rebuildMissingTangents: this.#rebuildMissingTangents,
+      rebuildMissingBiNormals: this.#rebuildMissingBiNormals,
+      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 {CjsGltfFormat} 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 {CjsGltfFormat} 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 key.
+   *
+   * @param {string} type Node class key.
+   * @returns {boolean} True when a constructor is registered.
+   */
+  HasClass(type) {
+    return !!this.GetClass(type);
+  }
+
+  /**
+   * Read glTF/GLB data with this profile's values.
+   *
+   * @param {object|string|Uint8Array|ArrayBuffer|DataView} input glTF object, JSON text/bytes, or GLB bytes.
+   * @param {object} [options] Per-call value overrides.
+   * @returns {object} The shared CarbonEngineJS JSON geometry schema.
+   */
+  Read(input, options = {}) {
+    return readWithValues(this, input, this.GetValues(options));
+  }
+
+  /**
+   * Inspect glTF/GLB data without hydrating classes.
+   *
+   * @param {object|string|Uint8Array|ArrayBuffer|DataView} input glTF object, JSON text/bytes, or GLB bytes.
+   * @param {object} [options] Per-call value overrides.
+   * @returns {object} Plain summary data.
+   */
+  Inspect(input, options = {}) {
+    return inspectWithValues(input, this.GetValues(options));
+  }
+
+  /**
+   * Convert format output to JSON-compatible data.
+   *
+   * @param {any} value Format output to convert.
+   * @returns {any} Plain JSON-compatible data.
+   */
+  ToJSON(value) {
+    return toJsonValue(value);
+  }
+
+  /**
+   * Static one-shot read. Static methods use camelCase by convention.
+   *
+   * @param {object|string|Uint8Array|ArrayBuffer|DataView} input glTF object, JSON text/bytes, or GLB bytes.
+   * @param {object} [options] Format values.
+   * @returns {object} The shared CarbonEngineJS JSON geometry schema.
+   */
+  static read(input, options = {}) {
+    return readWithValues(CjsGltfFormat, input, normalizeValues(DEFAULT_VALUES, options, FORMAT_NAME));
+  }
+
+  /**
+   * Static one-shot inspection.
+   *
+   * @param {object|string|Uint8Array|ArrayBuffer|DataView} input glTF object, JSON text/bytes, or GLB bytes.
+   * @param {object} [options] Format values.
+   * @returns {object} Plain summary data.
+   */
+  static inspect(input, options = {}) {
+    return inspectWithValues(input, normalizeValues(DEFAULT_VALUES, options, FORMAT_NAME));
+  }
+
+  /**
+   * Static JSON-compatible conversion.
+   *
+   * @param {any} value Format output to convert.
+   * @returns {any} Plain JSON-compatible data.
+   */
+  static toJSON(value) {
+    return toJsonValue(value);
+  }
+
+  /**
+   * Node-only convenience: reads a glTF or GLB file from disk.
+   *
+   * External `.bin` buffers referenced by relative URI are loaded beside the
+   * `.gltf` file. GLB binary chunks are handled directly.
+   *
+   * @param {string} path Path to a `.gltf` or `.glb` file.
+   * @param {object} [options] Format values.
+   * @returns {Promise<object>} The shared CarbonEngineJS JSON geometry schema.
+   */
+  static async readFile(path, options = {}) {
+    if (typeof path !== "string" || !path) {
+      throw new TypeError(`${FORMAT_NAME}: readFile path must be a non-empty string`);
+    }
+    const fs = await importNodeModule("node:fs/promises"),
+      pathModule = await importNodeModule("node:path"),
+      input = await fs.readFile(path);
+    if (isGlb(input)) {
+      return CjsGltfFormat.read(input, {
+        source: path,
+        ...options
+      });
+    }
+    const text = new TextDecoder().decode(input),
+      gltf = JSON.parse(text),
+      buffers = {};
+    for (const buffer of gltf.buffers || []) {
+      if (!buffer.uri || buffer.uri.startsWith("data:")) continue;
+      const uri = decodeURIComponent(buffer.uri);
+      buffers[buffer.uri] = await fs.readFile(pathModule.resolve(pathModule.dirname(path), uri));
+    }
+    return CjsGltfFormat.read(gltf, {
+      source: path,
+      buffers,
+      ...options
+    });
+  }
+
+  /**
+   * Cheap payload sniff for GLB bytes.
+   *
+   * @param {Uint8Array|ArrayBuffer|DataView} input Candidate bytes.
+   * @returns {boolean} True when the payload starts with GLB magic.
+   */
+  static isGlb(input) {
+    return isGlb(input);
+  }
+
+  /**
+   * Cheap object/text/bytes sniff for glTF-like assets.
+   *
+   * @param {object|string|Uint8Array|ArrayBuffer|DataView} input Candidate glTF data.
+   * @returns {boolean} True when the input looks like glTF 2.x or GLB.
+   */
+  static isGltf(input) {
+    try {
+      if (isGlb(input)) return true;
+      if (input && typeof input === "object" && !ArrayBuffer.isView(input) && !(input instanceof ArrayBuffer)) {
+        return !!(input.asset && String(input.asset.version || "").startsWith("2"));
+      }
+      const text = typeof input === "string" ? input : new TextDecoder().decode(toBytes(input));
+      const json = JSON.parse(text);
+      return !!(json.asset && String(json.asset.version || "").startsWith("2"));
+    } catch {
+      return false;
+    }
+  }
+  static OUTPUT_JSON = OUTPUT_JSON;
+  static OUTPUT_GLTF_JSON = OUTPUT_GLTF_JSON;
+  static OUTPUT_SHARED = OUTPUT_SHARED;
+  static OUTPUT_GR2 = OUTPUT_GR2;
+  static OUTPUT_CMF = OUTPUT_CMF;
+  static CLASS_KEYS = CLASS_KEYS;
+  static type = Object.freeze(["geometry"]);
+  static mediaTypes = Object.freeze(["geometry"]);
+  static inputTypes = Object.freeze(["gltf", "glb"]);
+  static outputTypes = Object.freeze([OUTPUT_SHARED, OUTPUT_GR2, OUTPUT_CMF]);
+  static debugOutputTypes = Object.freeze([OUTPUT_JSON, OUTPUT_GLTF_JSON]);
+}
+
+export { CjsGltfFormat, CjsGltfFormat as default };
+//# sourceMappingURL=CjsGltfFormat.js.map

package/dist/formats/gltf/CjsGltfFormat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CjsGltfFormat.js","sources":["../../../../src/formats/gltf/CjsGltfFormat.js"],"sourcesContent":["/**\n * Exposed CarbonEngineJS-facing glTF/GLB format class.\n *\n * Keep this file small and reviewable: glTF parsing, accessor decoding,\n * mesh conversion, skin conversion, animation conversion, and geometry helper\n * glue live under src/core.\n */\n\nimport {\n    CLASS_KEYS,\n    DEFAULT_VALUES,\n    OUTPUT_CMF,\n    OUTPUT_GLTF_JSON,\n    OUTPUT_GR2,\n    OUTPUT_JSON,\n    OUTPUT_SHARED,\n    importNodeModule,\n    inspectWithValues,\n    isGlb,\n    normalizeValues,\n    readWithValues,\n    toBytes,\n    toJsonValue,\n    validateClass,\n    validateClassKey\n} from \"./core/helpers.js\";\n\nconst FORMAT_NAME = \"CjsGltfFormat\";\n\n/**\n * CarbonEngineJS-facing glTF/GLB format surface.\n *\n * The Cjs prefix marks this as a JavaScript format/construction boundary.\n * glTF is the import source; the public read contract is the shared\n * CarbonEngineJS JSON mesh, skeleton, and animation schema.\n */\nexport class CjsGltfFormat\n{\n\n    #emit = DEFAULT_VALUES.emit;\n    #source = DEFAULT_VALUES.source;\n    #buffers = DEFAULT_VALUES.buffers;\n    #packTangents = DEFAULT_VALUES.packTangents;\n    #uvHandedness = DEFAULT_VALUES.uvHandedness;\n    #rebuildMissingNormals = DEFAULT_VALUES.rebuildMissingNormals;\n    #rebuildMissingTangents = DEFAULT_VALUES.rebuildMissingTangents;\n    #rebuildMissingBiNormals = DEFAULT_VALUES.rebuildMissingBiNormals;\n    #classes = DEFAULT_VALUES.classes;\n\n    /**\n     * Create a reusable format profile.\n     *\n     * @param {object} [options] Default format values.\n     */\n    constructor(options = {})\n    {\n        this.SetValues(options);\n    }\n\n    /**\n     * Set format values for this reusable profile.\n     *\n     * @param {object} [options] Values to merge into the profile.\n     * @returns {CjsGltfFormat} This format profile.\n     */\n    SetValues(options = {})\n    {\n        const values = normalizeValues(this.GetValues(), options, FORMAT_NAME);\n\n        this.#emit = values.emit;\n        this.#source = values.source;\n        this.#buffers = values.buffers;\n        this.#packTangents = values.packTangents;\n        this.#uvHandedness = values.uvHandedness;\n        this.#rebuildMissingNormals = values.rebuildMissingNormals;\n        this.#rebuildMissingTangents = values.rebuildMissingTangents;\n        this.#rebuildMissingBiNormals = values.rebuildMissingBiNormals;\n        this.#classes = values.classes;\n\n        return this;\n    }\n\n    /**\n     * Get this profile's current values, optionally with per-call overrides.\n     *\n     * @param {object} [options] Optional values to merge into a copy.\n     * @returns {object} A copy of the effective values.\n     */\n    GetValues(options = {})\n    {\n        return normalizeValues({\n            emit: this.#emit,\n            source: this.#source,\n            buffers: this.#buffers,\n            packTangents: this.#packTangents,\n            uvHandedness: this.#uvHandedness,\n            rebuildMissingNormals: this.#rebuildMissingNormals,\n            rebuildMissingTangents: this.#rebuildMissingTangents,\n            rebuildMissingBiNormals: this.#rebuildMissingBiNormals,\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 {CjsGltfFormat} 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 {CjsGltfFormat} 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 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 glTF/GLB data with this profile's values.\n     *\n     * @param {object|string|Uint8Array|ArrayBuffer|DataView} input glTF object, JSON text/bytes, or GLB bytes.\n     * @param {object} [options] Per-call value overrides.\n     * @returns {object} The shared CarbonEngineJS JSON geometry schema.\n     */\n    Read(input, options = {})\n    {\n        return readWithValues(this, input, this.GetValues(options));\n    }\n\n    /**\n     * Inspect glTF/GLB data without hydrating classes.\n     *\n     * @param {object|string|Uint8Array|ArrayBuffer|DataView} input glTF object, JSON text/bytes, or GLB bytes.\n     * @param {object} [options] Per-call value overrides.\n     * @returns {object} Plain summary data.\n     */\n    Inspect(input, options = {})\n    {\n        return inspectWithValues(input, this.GetValues(options));\n    }\n\n    /**\n     * 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 {object|string|Uint8Array|ArrayBuffer|DataView} input glTF object, JSON text/bytes, or GLB bytes.\n     * @param {object} [options] Format values.\n     * @returns {object} The shared CarbonEngineJS JSON geometry schema.\n     */\n    static read(input, options = {})\n    {\n        return readWithValues(CjsGltfFormat, input, normalizeValues(DEFAULT_VALUES, options, FORMAT_NAME));\n    }\n\n    /**\n     * Static one-shot inspection.\n     *\n     * @param {object|string|Uint8Array|ArrayBuffer|DataView} input glTF object, JSON text/bytes, or GLB bytes.\n     * @param {object} [options] Format values.\n     * @returns {object} Plain summary data.\n     */\n    static inspect(input, options = {})\n    {\n        return inspectWithValues(input, normalizeValues(DEFAULT_VALUES, options, FORMAT_NAME));\n    }\n\n    /**\n     * Static JSON-compatible conversion.\n     *\n     * @param {any} value Format output to convert.\n     * @returns {any} Plain JSON-compatible data.\n     */\n    static toJSON(value)\n    {\n        return toJsonValue(value);\n    }\n\n    /**\n     * Node-only convenience: reads a glTF or GLB file from disk.\n     *\n     * External `.bin` buffers referenced by relative URI are loaded beside the\n     * `.gltf` file. GLB binary chunks are handled directly.\n     *\n     * @param {string} path Path to a `.gltf` or `.glb` file.\n     * @param {object} [options] Format values.\n     * @returns {Promise<object>} The shared CarbonEngineJS JSON geometry schema.\n     */\n    static async readFile(path, options = {})\n    {\n        if (typeof path !== \"string\" || !path)\n        {\n            throw new TypeError(`${FORMAT_NAME}: readFile path must be a non-empty string`);\n        }\n\n        const\n            fs = await importNodeModule(\"node:fs/promises\"),\n            pathModule = await importNodeModule(\"node:path\"),\n            input = await fs.readFile(path);\n\n        if (isGlb(input))\n        {\n            return CjsGltfFormat.read(input, { source: path, ...options });\n        }\n\n        const\n            text = new TextDecoder().decode(input),\n            gltf = JSON.parse(text),\n            buffers = {};\n\n        for (const buffer of gltf.buffers || [])\n        {\n            if (!buffer.uri || buffer.uri.startsWith(\"data:\")) continue;\n            const uri = decodeURIComponent(buffer.uri);\n            buffers[buffer.uri] = await fs.readFile(pathModule.resolve(pathModule.dirname(path), uri));\n        }\n\n        return CjsGltfFormat.read(gltf, { source: path, buffers, ...options });\n    }\n\n    /**\n     * Cheap payload sniff for GLB bytes.\n     *\n     * @param {Uint8Array|ArrayBuffer|DataView} input Candidate bytes.\n     * @returns {boolean} True when the payload starts with GLB magic.\n     */\n    static isGlb(input)\n    {\n        return isGlb(input);\n    }\n\n    /**\n     * Cheap object/text/bytes sniff for glTF-like assets.\n     *\n     * @param {object|string|Uint8Array|ArrayBuffer|DataView} input Candidate glTF data.\n     * @returns {boolean} True when the input looks like glTF 2.x or GLB.\n     */\n    static isGltf(input)\n    {\n        try\n        {\n            if (isGlb(input)) return true;\n            if (input && typeof input === \"object\" && !ArrayBuffer.isView(input) && !(input instanceof ArrayBuffer))\n            {\n                return !!(input.asset && String(input.asset.version || \"\").startsWith(\"2\"));\n            }\n            const text = typeof input === \"string\" ? input : new TextDecoder().decode(toBytes(input));\n            const json = JSON.parse(text);\n            return !!(json.asset && String(json.asset.version || \"\").startsWith(\"2\"));\n        }\n        catch\n        {\n            return false;\n        }\n    }\n\n    static OUTPUT_JSON = OUTPUT_JSON;\n    static OUTPUT_GLTF_JSON = OUTPUT_GLTF_JSON;\n    static OUTPUT_SHARED = OUTPUT_SHARED;\n    static OUTPUT_GR2 = OUTPUT_GR2;\n    static OUTPUT_CMF = OUTPUT_CMF;\n    static CLASS_KEYS = CLASS_KEYS;\n    static type = Object.freeze([ \"geometry\" ]);\n    static mediaTypes = Object.freeze([ \"geometry\" ]);\n    static inputTypes = Object.freeze([ \"gltf\", \"glb\" ]);\n    static outputTypes = Object.freeze([ OUTPUT_SHARED, OUTPUT_GR2, OUTPUT_CMF ]);\n    static debugOutputTypes = Object.freeze([ OUTPUT_JSON, OUTPUT_GLTF_JSON ]);\n\n}\n\nexport default CjsGltfFormat;\n"],"names":["FORMAT_NAME","CjsGltfFormat","DEFAULT_VALUES","emit","source","buffers","packTangents","uvHandedness","rebuildMissingNormals","rebuildMissingTangents","rebuildMissingBiNormals","classes","constructor","options","SetValues","values","normalizeValues","GetValues","SetClasses","SetClass","type","Class","undefined","validateClassKey","validateClass","GetClass","HasClass","Read","input","readWithValues","Inspect","inspectWithValues","ToJSON","value","toJsonValue","read","inspect","toJSON","readFile","path","TypeError","fs","importNodeModule","pathModule","isGlb","text","TextDecoder","decode","gltf","JSON","parse","buffer","uri","startsWith","decodeURIComponent","resolve","dirname","isGltf","ArrayBuffer","isView","asset","String","version","toBytes","json","OUTPUT_JSON","OUTPUT_GLTF_JSON","OUTPUT_SHARED","OUTPUT_GR2","OUTPUT_CMF","CLASS_KEYS","Object","freeze","mediaTypes","inputTypes","outputTypes","debugOutputTypes"],"mappings":"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"}

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

@@ -0,0 +1,292 @@
+import { CLASS_KEYS as CLASS_KEYS$1, hydrateJson } from './json.js';
+import { CMF_CLASS_KEYS, hydrateCmf, buildCmfFromShared } from './targets.js';
+import { parseInput, parseGltfToJson, inspectGltf } from './parser.js';
+export { isGlb, toBytes } from './parser.js';
+import { generateNormals, generateTangents, generateBiNormals } from '@carbonenginejs/core-math/mesh';
+import { packTangentFrames } from '@carbonenginejs/core-math/tangent';
+import { normalize, cross } from '@carbonenginejs/core-math/vec3';
+
+/**
+ * Internal read-pipeline glue for CjsGltfFormat.
+ */
+
+const CLASS_KEYS = Object.freeze(Array.from(new Set([...CLASS_KEYS$1, ...CMF_CLASS_KEYS])));
+const OUTPUT_JSON = "json";
+const OUTPUT_GLTF_JSON = "gltfJson";
+const OUTPUT_SHARED = "shared";
+const OUTPUT_GR2 = "gr2";
+const OUTPUT_CMF = "cmf";
+const DEFAULT_VALUES = Object.freeze({
+  emit: OUTPUT_GLTF_JSON,
+  source: "memory",
+  buffers: null,
+  packTangents: false,
+  uvHandedness: "right",
+  rebuildMissingNormals: false,
+  rebuildMissingTangents: false,
+  rebuildMissingBiNormals: false,
+  classes: Object.freeze({})
+});
+const OPTION_KEYS = new Set(["emit", "source", "buffers", "packTangents", "uvHandedness", "rebuildMissingNormals", "rebuildMissingTangents", "rebuildMissingBiNormals", "classes"]);
+function validateClassKey(key, readerName = "CjsGltfFormat") {
+  if (!CLASS_KEYS.includes(key)) {
+    throw new Error(`${readerName}: unknown class key ${JSON.stringify(key)}; expected one of ${CLASS_KEYS.join(", ")}`);
+  }
+}
+function validateClass(key, Class, readerName = "CjsGltfFormat") {
+  validateClassKey(key, readerName);
+  if (typeof Class !== "function") {
+    throw new TypeError(`${readerName}: class ${JSON.stringify(key)} must be a constructor`);
+  }
+}
+function mergeClasses(base, classes, readerName) {
+  if (!classes || typeof classes !== "object") {
+    throw new TypeError(`${readerName}: classes option must be an object`);
+  }
+  const next = {
+    ...base
+  };
+  for (const [key, Class] of Object.entries(classes)) {
+    if (Class === null || Class === undefined) {
+      delete next[key];
+      continue;
+    }
+    validateClass(key, Class, readerName);
+    next[key] = Class;
+  }
+  return next;
+}
+function validateRule(name, value, readerName) {
+  if (typeof value === "boolean" || typeof value === "function") return value;
+  throw new TypeError(`${readerName}: ${name} must be true, false, or a function`);
+}
+function normalizeUvHandedness(value, readerName) {
+  if (value === undefined || value === null) return DEFAULT_VALUES.uvHandedness;
+  if (value === "right" || value === 1 || value === "positive") return "right";
+  if (value === "left" || value === -1 || value === "negative") return "left";
+  throw new TypeError(`${readerName}: uvHandedness must be "right" or "left"`);
+}
+function normalizeValues(base, options = {}, readerName = "CjsGltfFormat") {
+  if (!options || typeof options !== "object") {
+    throw new TypeError(`${readerName}: options must be an object`);
+  }
+  for (const key of Object.keys(options)) {
+    if (!OPTION_KEYS.has(key)) {
+      throw new TypeError(`${readerName}: unknown option ${JSON.stringify(key)}`);
+    }
+  }
+  const values = {
+    ...base,
+    ...options
+  };
+  const emit = normalizeEmit(values.emit, readerName);
+  const classes = Object.prototype.hasOwnProperty.call(options, "classes") ? mergeClasses(base.classes || {}, options.classes, readerName) : {
+    ...(base.classes || {})
+  };
+  if ((emit === OUTPUT_GR2 || emit === OUTPUT_CMF) && !hasClasses(classes)) {
+    throw new TypeError(`${readerName}: emit "${emit}" requires explicit classes`);
+  }
+  if (typeof values.source !== "string" || !values.source) {
+    values.source = DEFAULT_VALUES.source;
+  }
+  return {
+    emit,
+    source: values.source,
+    buffers: values.buffers || null,
+    packTangents: validateRule("packTangents", values.packTangents, readerName),
+    uvHandedness: normalizeUvHandedness(values.uvHandedness, readerName),
+    rebuildMissingNormals: validateRule("rebuildMissingNormals", values.rebuildMissingNormals, readerName),
+    rebuildMissingTangents: validateRule("rebuildMissingTangents", values.rebuildMissingTangents, readerName),
+    rebuildMissingBiNormals: validateRule("rebuildMissingBiNormals", values.rebuildMissingBiNormals, readerName),
+    classes
+  };
+}
+function normalizeEmit(emit, readerName) {
+  if (emit === undefined || emit === null || emit === OUTPUT_JSON || emit === OUTPUT_GLTF_JSON || emit === OUTPUT_SHARED) {
+    return OUTPUT_GLTF_JSON;
+  }
+  if (emit === OUTPUT_GR2 || emit === OUTPUT_CMF) return emit;
+  throw new TypeError(`${readerName}: emit must be "${OUTPUT_SHARED}", "${OUTPUT_GLTF_JSON}", "${OUTPUT_GR2}", or "${OUTPUT_CMF}", got ${JSON.stringify(emit)}`);
+}
+function hasClasses(classes) {
+  return !!classes && Object.values(classes).some(Class => typeof Class === "function");
+}
+function hasVertexChannel(mesh, channel) {
+  const value = mesh && mesh.vertex && mesh.vertex[channel];
+  return !!value && value.length > 0;
+}
+function requireVertexChannel(mesh, meshIndex, channel, feature) {
+  const value = mesh && mesh.vertex && mesh.vertex[channel];
+  if (!value || value.length === 0) {
+    const name = mesh && mesh.name ? JSON.stringify(mesh.name) : `#${meshIndex}`;
+    throw new Error(`CjsGltfFormat: ${feature} requires mesh.vertex.${channel} for mesh ${name}`);
+  }
+  return value;
+}
+function triangleFaces(mesh, meshIndex, feature) {
+  const faces = [];
+  for (const group of mesh.indices || []) {
+    if (group && group.faces) faces.push(...group.faces);
+  }
+  if (faces.length === 0) {
+    const name = mesh && mesh.name ? JSON.stringify(mesh.name) : `#${meshIndex}`;
+    throw new Error(`CjsGltfFormat: ${feature} requires triangle indices for mesh ${name}`);
+  }
+  return faces;
+}
+function shouldApplyMeshRule(format, rule, context) {
+  if (typeof rule === "function") {
+    const result = rule({
+      format,
+      reader: format,
+      ...context
+    });
+    if (typeof result !== "boolean") {
+      throw new TypeError(`CjsGltfFormat: ${context.feature} rule must return true or false`);
+    }
+    return result;
+  }
+  return rule;
+}
+function vertexCount(mesh) {
+  return mesh.vertex.position.length / 3;
+}
+function tangentXyz(mesh) {
+  const tangent = requireVertexChannel(mesh, 0, "tangent", "tangent conversion"),
+    count = vertexCount(mesh),
+    width = tangent.length / count;
+  if (width === 3) return tangent.slice();
+  if (width !== 4) throw new Error("CjsGltfFormat: tangent channel must have 3 or 4 components per vertex");
+  const out = new Array(count * 3);
+  for (let i = 0, o = 0; i < tangent.length; i += 4, o += 3) {
+    out[o] = tangent[i];
+    out[o + 1] = tangent[i + 1];
+    out[o + 2] = tangent[i + 2];
+  }
+  return out;
+}
+function generatedBiNormalsForMesh(mesh, values) {
+  const normals = requireVertexChannel(mesh, 0, "normal", "binormal generation"),
+    tangent = requireVertexChannel(mesh, 0, "tangent", "binormal generation"),
+    count = vertexCount(mesh),
+    width = tangent.length / count;
+  if (width === 3) {
+    return generateBiNormals(normals, tangent, {
+      uvHandedness: values.uvHandedness
+    });
+  }
+  if (width !== 4) throw new Error("CjsGltfFormat: tangent channel must have 3 or 4 components per vertex");
+  const out = new Array(count * 3);
+  for (let i = 0, o = 0; i < tangent.length; i += 4, o += 3) {
+    const b = normalize([0, 0, 0], cross([0, 0, 0], [normals[o], normals[o + 1], normals[o + 2]], [tangent[i], tangent[i + 1], tangent[i + 2]]));
+    const sign = tangent[i + 3] < 0 ? -1 : 1;
+    out[o] = b[0] * sign;
+    out[o + 1] = b[1] * sign;
+    out[o + 2] = b[2] * sign;
+  }
+  return out;
+}
+function rebuildMissingMeshData(format, json, values) {
+  for (let meshIndex = 0; meshIndex < json.meshes.length; meshIndex++) {
+    const mesh = json.meshes[meshIndex],
+      common = {
+        options: values,
+        raw: null,
+        json,
+        mesh,
+        meshIndex
+      },
+      shouldPackTangents = shouldApplyMeshRule(format, values.packTangents, {
+        ...common,
+        feature: "packTangents",
+        channel: "tangent"
+      });
+    if (!hasVertexChannel(mesh, "normal") && (shouldApplyMeshRule(format, values.rebuildMissingNormals, {
+      ...common,
+      feature: "rebuildMissingNormals",
+      channel: "normal"
+    }) || shouldPackTangents)) {
+      mesh.vertex.normal = generateNormals(requireVertexChannel(mesh, meshIndex, "position", "rebuildMissingNormals"), triangleFaces(mesh, meshIndex, "rebuildMissingNormals"));
+    }
+    if (!hasVertexChannel(mesh, "tangent") && (shouldApplyMeshRule(format, values.rebuildMissingTangents, {
+      ...common,
+      feature: "rebuildMissingTangents",
+      channel: "tangent"
+    }) || shouldPackTangents)) {
+      mesh.vertex.tangent = generateTangents(requireVertexChannel(mesh, meshIndex, "position", "rebuildMissingTangents"), requireVertexChannel(mesh, meshIndex, "normal", "rebuildMissingTangents"), requireVertexChannel(mesh, meshIndex, "texcoord0", "rebuildMissingTangents"), triangleFaces(mesh, meshIndex, "rebuildMissingTangents"));
+    }
+    if (!hasVertexChannel(mesh, "binormal") && (shouldApplyMeshRule(format, values.rebuildMissingBiNormals, {
+      ...common,
+      feature: "rebuildMissingBiNormals",
+      channel: "binormal"
+    }) || shouldPackTangents)) {
+      mesh.vertex.binormal = generatedBiNormalsForMesh(mesh, values);
+    }
+    if (shouldPackTangents) {
+      mesh.vertex.tangent = packTangentFrames(requireVertexChannel(mesh, meshIndex, "normal", "packTangents"), tangentXyz(mesh), requireVertexChannel(mesh, meshIndex, "binormal", "packTangents"));
+      mesh.vertex.normal = [];
+      mesh.vertex.binormal = [];
+    }
+  }
+}
+function readWithValues(format, input, values) {
+  const parsed = parseInput(input);
+  const json = parseGltfToJson(parsed.gltf, {
+    binaryChunk: parsed.binaryChunk,
+    source: values.source,
+    buffers: values.buffers
+  });
+  rebuildMissingMeshData(format, json, values);
+  if (values.emit === OUTPUT_CMF) return hydrateCmf(buildCmfFromShared(json), values.classes, {
+    source: values.source
+  });
+  return hydrateJson(json, {
+    classes: values.classes,
+    source: values.source
+  });
+}
+function inspectWithValues(input, values) {
+  const parsed = parseInput(input);
+  return inspectGltf(parsed.gltf, {
+    format: parsed.format,
+    source: values.source
+  });
+}
+function toJsonValue(value) {
+  if (value === null || value === undefined) return value;
+  if (typeof value !== "object") return value;
+  if (typeof value.toJSON === "function") {
+    const next = value.toJSON();
+    if (next !== value) return toJsonValue(next);
+  }
+  if (Array.isArray(value)) return value.map(toJsonValue);
+  if (ArrayBuffer.isView(value) && !(value instanceof DataView)) return Array.from(value);
+  const out = {};
+  for (const key of Object.keys(value)) {
+    out[key] = toJsonValue(value[key]);
+  }
+  return out;
+}
+
+/**
+ * Imports a Node built-in module without exposing the specifier to any
+ * bundler's static import graph.
+ *
+ * `await import("node:fs/promises")` written as a literal is resolved
+ * eagerly by webpack/Rollup/esbuild alike when they walk the module
+ * graph, breaking browser builds even though this path only ever runs
+ * under Node (readFile is a Node-only convenience). Building the
+ * specifier inside a `Function` body hides it from every bundler's
+ * static analysis - it only exists at runtime, in the Node process that
+ * actually calls readFile.
+ *
+ * @param {string} specifier Node built-in module specifier, e.g. "node:fs/promises".
+ * @returns {Promise<any>} The imported module namespace.
+ */
+function importNodeModule(specifier) {
+  // eslint-disable-next-line no-new-func
+  return new Function("s", "return import(s)")(specifier);
+}
+
+export { CLASS_KEYS, DEFAULT_VALUES, OUTPUT_CMF, OUTPUT_GLTF_JSON, OUTPUT_GR2, OUTPUT_JSON, OUTPUT_SHARED, importNodeModule, inspectWithValues, normalizeValues, readWithValues, toJsonValue, validateClass, validateClassKey };
+//# sourceMappingURL=helpers.js.map