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

package/dist/resource/formats/cmf/CjsCmfFormat.js

@@ -5,13 +5,13 @@ import { writeCmf, writeCmfAsync } from './core/writer.js';
 import { DEFAULT_VALUES, normalizeValues, validateClassKey, validateClass, readWithValues, loadNativeWithValues, loadSharedWithValues, readWithValuesAsync, readRawInput, readRawInputAsync, inspectRawCmfResult, toJsonValue } from './core/helpers.js';
 import { OUTPUT_SHARED, OUTPUT_RAW, OUTPUT_NATIVE, OUTPUT_GR2, OUTPUT_CMF_JSON, OUTPUT_CMF, OUTPUT_JSON, CLASS_KEYS } from './core/constants.js';
 
-/**
- * CarbonEngineJS-facing CMF reader.
- *
- * The Cjs prefix marks this as a JavaScript format/construction boundary. It
- * can load CMF files, load CMF-native JSON, construct CMF-native data from
- * shared geometry, emit shared geometry when requested, or hydrate
- * caller-supplied CarbonEngineJS-style classes.
+/**
+ * CarbonEngineJS-facing CMF reader.
+ *
+ * The Cjs prefix marks this as a JavaScript format/construction boundary. It
+ * can load CMF files, load CMF-native JSON, construct CMF-native data from
+ * shared geometry, emit shared geometry when requested, or hydrate
+ * caller-supplied CarbonEngineJS-style classes.
  */
 class CjsCmfFormat extends CjsFormat {
   #emit = DEFAULT_VALUES.emit;
@@ -19,21 +19,21 @@ class CjsCmfFormat extends CjsFormat {
   #decodeBuffers = DEFAULT_VALUES.decodeBuffers;
   #classes = {};
 
-  /**
-   * Create a reusable format profile.
-   *
-   * @param {object} [options] Default format/build values.
+  /**
+   * Create a reusable format profile.
+   *
+   * @param {object} [options] Default format/build values.
    */
   constructor(options = {}) {
     super();
     this.SetValues(options);
   }
 
-  /**
-   * Set format values for this reusable profile.
-   *
-   * @param {object} [options] Values to merge into the profile.
-   * @returns {CjsCmfFormat} This format profile.
+  /**
+   * Set format values for this reusable profile.
+   *
+   * @param {object} [options] Values to merge into the profile.
+   * @returns {CjsCmfFormat} This format profile.
    */
   SetValues(options = {}) {
     const values = normalizeValues(this.GetValues(), options);
@@ -44,11 +44,11 @@ class CjsCmfFormat extends CjsFormat {
     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.
+  /**
+   * 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({
@@ -59,11 +59,11 @@ class CjsCmfFormat extends CjsFormat {
     }, options);
   }
 
-  /**
-   * Set multiple CMF JSON node constructors for this profile.
-   *
-   * @param {object} [classes] Map of node class keys to constructors.
-   * @returns {CjsCmfFormat} This format profile.
+  /**
+   * Set multiple CMF JSON node constructors for this profile.
+   *
+   * @param {object} [classes] Map of node class keys to constructors.
+   * @returns {CjsCmfFormat} This format profile.
    */
   SetClasses(classes = {}) {
     return this.SetValues({
@@ -71,12 +71,12 @@ class CjsCmfFormat extends CjsFormat {
     });
   }
 
-  /**
-   * Set a CMF JSON node constructor for this profile.
-   *
-   * @param {string} type Node class key.
-   * @param {Function|null|undefined} Class Constructor to use, or nullish to delete.
-   * @returns {CjsCmfFormat} This format profile.
+  /**
+   * Set a CMF JSON node constructor for this profile.
+   *
+   * @param {string} type Node class key.
+   * @param {Function|null|undefined} Class Constructor to use, or nullish to delete.
+   * @returns {CjsCmfFormat} This format profile.
    */
   SetClass(type, Class) {
     validateClassKey(type);
@@ -92,68 +92,68 @@ class CjsCmfFormat extends CjsFormat {
     return this;
   }
 
-  /**
-   * Get a configured CMF JSON node constructor.
-   *
-   * @param {string} type Node class key.
-   * @returns {Function|undefined}
+  /**
+   * Get a configured CMF JSON node constructor.
+   *
+   * @param {string} type Node class key.
+   * @returns {Function|undefined}
    */
   GetClass(type) {
     validateClassKey(type);
     return this.#classes[type];
   }
 
-  /**
-   * Whether this reader has a constructor for a CMF JSON node key.
-   *
-   * @param {string} type Node class key.
-   * @returns {boolean}
+  /**
+   * Whether this reader has a constructor for a CMF JSON node key.
+   *
+   * @param {string} type Node class key.
+   * @returns {boolean}
    */
   HasClass(type) {
     return !!this.GetClass(type);
   }
 
-  /**
-   * Parse a .cmf buffer and return CMF-native JSON by default, shared
-   * geometry when `emit` is "shared", or raw parsed data when `emit` is
-   * "raw".
-   *
-   * @param {Uint8Array|Buffer|ArrayBuffer|object} input Raw .cmf bytes or an existing raw read result.
-   * @param {object} [options] Per-call values.
-   * @returns {object}
+  /**
+   * Parse a .cmf buffer and return CMF-native JSON by default, shared
+   * geometry when `emit` is "shared", or raw parsed data when `emit` is
+   * "raw".
+   *
+   * @param {Uint8Array|Buffer|ArrayBuffer|object} input Raw .cmf bytes or an existing raw read result.
+   * @param {object} [options] Per-call values.
+   * @returns {object}
    */
   Read(input, options = {}) {
     return readWithValues(this, input, this.GetValues(options));
   }
 
-  /**
-   * Load CMF-native JSON. Shared geometry uses LoadShared.
-   *
-   * @param {object} input CMF-native JSON root.
-   * @param {object} [options] Per-call values.
-   * @returns {object}
+  /**
+   * Load CMF-native JSON. Shared geometry uses LoadShared.
+   *
+   * @param {object} input CMF-native JSON root.
+   * @param {object} [options] Per-call values.
+   * @returns {object}
    */
   Load(input, options = {}) {
     return loadNativeWithValues(input, this.GetValues(options));
   }
 
-  /**
-   * Build CMF-native JSON from shared CarbonEngineJS geometry.
-   *
-   * @param {object} input Shared geometry root or mesh.
-   * @param {object} [options] Per-call values.
-   * @returns {object}
+  /**
+   * Build CMF-native JSON from shared CarbonEngineJS geometry.
+   *
+   * @param {object} input Shared geometry root or mesh.
+   * @param {object} [options] Per-call values.
+   * @returns {object}
    */
   LoadShared(input, options = {}) {
     return loadSharedWithValues(input, this.GetValues(options));
   }
 
-  /**
-   * Parse a .cmf buffer and emit the shared deinterleaved mesh graph.
-   *
-   * @param {Uint8Array|Buffer|ArrayBuffer|object} input Raw .cmf bytes or an existing raw read result.
-   * @param {object} [options] Per-call values.
-   * @returns {object}
+  /**
+   * Parse a .cmf buffer and emit the shared deinterleaved mesh graph.
+   *
+   * @param {Uint8Array|Buffer|ArrayBuffer|object} input Raw .cmf bytes or an existing raw read result.
+   * @param {object} [options] Per-call values.
+   * @returns {object}
    */
   ReadShared(input, options = {}) {
     return this.Read(input, {
@@ -162,23 +162,23 @@ class CjsCmfFormat extends CjsFormat {
     });
   }
 
-  /**
-   * Parse a .cmf buffer with async meshoptimizer initialization support.
-   *
-   * @param {Uint8Array|Buffer|ArrayBuffer|object} input Raw .cmf bytes or an existing raw read result.
-   * @param {object} [options] Per-call values.
-   * @returns {Promise<object>}
+  /**
+   * Parse a .cmf buffer with async meshoptimizer initialization support.
+   *
+   * @param {Uint8Array|Buffer|ArrayBuffer|object} input Raw .cmf bytes or an existing raw read result.
+   * @param {object} [options] Per-call values.
+   * @returns {Promise<object>}
    */
   async ReadAsync(input, options = {}) {
     return readWithValuesAsync(this, input, this.GetValues(options));
   }
 
-  /**
-   * Parse a .cmf buffer asynchronously and emit the shared deinterleaved mesh graph.
-   *
-   * @param {Uint8Array|Buffer|ArrayBuffer|object} input Raw .cmf bytes or an existing raw read result.
-   * @param {object} [options] Per-call values.
-   * @returns {Promise<object>}
+  /**
+   * Parse a .cmf buffer asynchronously and emit the shared deinterleaved mesh graph.
+   *
+   * @param {Uint8Array|Buffer|ArrayBuffer|object} input Raw .cmf bytes or an existing raw read result.
+   * @param {object} [options] Per-call values.
+   * @returns {Promise<object>}
    */
   async ReadSharedAsync(input, options = {}) {
     return this.ReadAsync(input, {
@@ -187,143 +187,143 @@ class CjsCmfFormat extends CjsFormat {
     });
   }
 
-  /**
-   * Parse a .cmf buffer into the raw parsed CMF graph.
-   *
-   * @param {Uint8Array|Buffer|ArrayBuffer|object} input Raw .cmf bytes or an existing raw read result.
-   * @param {object} [options] Per-call values.
-   * @returns {object}
+  /**
+   * Parse a .cmf buffer into the raw parsed CMF graph.
+   *
+   * @param {Uint8Array|Buffer|ArrayBuffer|object} input Raw .cmf bytes or an existing raw read result.
+   * @param {object} [options] Per-call values.
+   * @returns {object}
    */
   ReadRaw(input, options = {}) {
     return readRawInput(input, this.GetValues(options));
   }
 
-  /**
-   * Parse a .cmf buffer into the raw parsed CMF graph with async
-   * meshoptimizer initialization support.
-   *
-   * @param {Uint8Array|Buffer|ArrayBuffer|object} input Raw .cmf bytes or an existing raw read result.
-   * @param {object} [options] Per-call values.
-   * @returns {Promise<object>}
+  /**
+   * Parse a .cmf buffer into the raw parsed CMF graph with async
+   * meshoptimizer initialization support.
+   *
+   * @param {Uint8Array|Buffer|ArrayBuffer|object} input Raw .cmf bytes or an existing raw read result.
+   * @param {object} [options] Per-call values.
+   * @returns {Promise<object>}
    */
   async ReadRawAsync(input, options = {}) {
     return readRawInputAsync(input, this.GetValues(options));
   }
 
-  /**
-   * Return a stable, lightweight summary for a CMF buffer or raw result.
-   *
-   * @param {Uint8Array|Buffer|ArrayBuffer|object} input Raw .cmf bytes or an existing raw read result.
-   * @param {object} [options] Per-call values.
-   * @returns {object}
+  /**
+   * Return a stable, lightweight summary for a CMF buffer or raw result.
+   *
+   * @param {Uint8Array|Buffer|ArrayBuffer|object} input Raw .cmf bytes or an existing raw read result.
+   * @param {object} [options] Per-call values.
+   * @returns {object}
    */
   Inspect(input, options = {}) {
     return inspectRawCmfResult(input, this.GetValues(options));
   }
 
-  /**
-   * Convert format output to plain JSON-compatible data.
-   *
-   * @param {object} value Format output to convert.
-   * @returns {any} Plain JSON-compatible data.
+  /**
+   * Convert format output to plain JSON-compatible data.
+   *
+   * @param {object} value Format output to convert.
+   * @returns {any} Plain JSON-compatible data.
    */
   ToJSON(value) {
     return toJsonValue(value);
   }
 
-  /**
-   * Serialize a CMF-native graph to binary .cmf bytes without compression.
-   *
-   * Use WriteAsync for meshoptimizer-compressed GPU sections. The graph
-   * shape matches Read output: meshes/skeletons/animations plus optional
-   * metadata and a `buffers` list supplying uncompressed bytes per
-   * BufferView index.
-   *
-   * @param {object} graph CMF-native graph.
-   * @param {object} [options] Writer options (`compress`).
-   * @returns {Uint8Array} Complete .cmf file bytes.
+  /**
+   * Serialize a CMF-native graph to binary .cmf bytes without compression.
+   *
+   * Use WriteAsync for meshoptimizer-compressed GPU sections. The graph
+   * shape matches Read output: meshes/skeletons/animations plus optional
+   * metadata and a `buffers` list supplying uncompressed bytes per
+   * BufferView index.
+   *
+   * @param {object} graph CMF-native graph.
+   * @param {object} [options] Writer options (`compress`).
+   * @returns {Uint8Array} Complete .cmf file bytes.
    */
   Write(graph, options = {}) {
     return writeCmf(graph, options);
   }
 
-  /**
-   * Serialize a CMF-native graph to binary .cmf bytes with meshoptimizer
-   * compression enabled by default.
-   *
-   * @param {object} graph CMF-native graph.
-   * @param {object} [options] Writer options (`compress`, default true).
-   * @returns {Promise<Uint8Array>} Complete .cmf file bytes.
+  /**
+   * Serialize a CMF-native graph to binary .cmf bytes with meshoptimizer
+   * compression enabled by default.
+   *
+   * @param {object} graph CMF-native graph.
+   * @param {object} [options] Writer options (`compress`, default true).
+   * @returns {Promise<Uint8Array>} Complete .cmf file bytes.
    */
   async WriteAsync(graph, options = {}) {
     return writeCmfAsync(graph, options);
   }
 
-  /**
-   * Serialize shared CarbonEngineJS geometry (e.g. from the GR2/OBJ/glTF
-   * readers) straight to binary .cmf bytes without compression.
-   *
-   * Channels are interleaved into GPU buffers per the generated
-   * declaration. Skeletons/animations must already be CMF-native shaped.
-   *
-   * @param {object} input Shared geometry root or mesh.
-   * @param {object} [options] Writer options (`compress`).
-   * @returns {Uint8Array} Complete .cmf file bytes.
+  /**
+   * Serialize shared CarbonEngineJS geometry (e.g. from the GR2/OBJ/glTF
+   * readers) straight to binary .cmf bytes without compression.
+   *
+   * Channels are interleaved into GPU buffers per the generated
+   * declaration. Skeletons/animations must already be CMF-native shaped.
+   *
+   * @param {object} input Shared geometry root or mesh.
+   * @param {object} [options] Writer options (`compress`).
+   * @returns {Uint8Array} Complete .cmf file bytes.
    */
   WriteShared(input, options = {}) {
     return CjsCmfFormat.writeShared(input, options);
   }
 
-  /**
-   * Serialize shared CarbonEngineJS geometry to compressed .cmf bytes.
-   *
-   * @param {object} input Shared geometry root or mesh.
-   * @param {object} [options] Writer options (`compress`, default true).
-   * @returns {Promise<Uint8Array>} Complete .cmf file bytes.
+  /**
+   * Serialize shared CarbonEngineJS geometry to compressed .cmf bytes.
+   *
+   * @param {object} input Shared geometry root or mesh.
+   * @param {object} [options] Writer options (`compress`, default true).
+   * @returns {Promise<Uint8Array>} Complete .cmf file bytes.
    */
   async WriteSharedAsync(input, options = {}) {
     return CjsCmfFormat.writeSharedAsync(input, options);
   }
 
-  /**
-   * Static one-shot read. Static methods use camelCase by convention.
-   *
-   * @param {Uint8Array|Buffer|ArrayBuffer|object} input Raw .cmf bytes or an existing raw read result.
-   * @param {object} [options] Reader values.
-   * @returns {object}
+  /**
+   * Static one-shot read. Static methods use camelCase by convention.
+   *
+   * @param {Uint8Array|Buffer|ArrayBuffer|object} input Raw .cmf bytes or an existing raw read result.
+   * @param {object} [options] Reader values.
+   * @returns {object}
    */
   static read(input, options = {}) {
     return readWithValues(CjsCmfFormat, input, normalizeValues(DEFAULT_VALUES, options));
   }
 
-  /**
-   * Static one-shot CMF-native JSON load.
-   *
-   * @param {object} input CMF-native JSON root.
-   * @param {object} [options] Reader values.
-   * @returns {object}
+  /**
+   * Static one-shot CMF-native JSON load.
+   *
+   * @param {object} input CMF-native JSON root.
+   * @param {object} [options] Reader values.
+   * @returns {object}
    */
   static load(input, options = {}) {
     return loadNativeWithValues(input, normalizeValues(DEFAULT_VALUES, options));
   }
 
-  /**
-   * Static one-shot shared geometry to CMF-native JSON construction.
-   *
-   * @param {object} input Shared geometry root or mesh.
-   * @param {object} [options] Reader values.
-   * @returns {object}
+  /**
+   * Static one-shot shared geometry to CMF-native JSON construction.
+   *
+   * @param {object} input Shared geometry root or mesh.
+   * @param {object} [options] Reader values.
+   * @returns {object}
    */
   static loadShared(input, options = {}) {
     return loadSharedWithValues(input, normalizeValues(DEFAULT_VALUES, options));
   }
 
-  /**
-   * Static one-shot read to shared geometry.
-   *
-   * @param {Uint8Array|Buffer|ArrayBuffer|object} input Raw .cmf bytes or an existing raw read result.
-   * @param {object} [options] Reader values.
-   * @returns {object}
+  /**
+   * Static one-shot read to shared geometry.
+   *
+   * @param {Uint8Array|Buffer|ArrayBuffer|object} input Raw .cmf bytes or an existing raw read result.
+   * @param {object} [options] Reader values.
+   * @returns {object}
    */
   static readShared(input, options = {}) {
     return CjsCmfFormat.read(input, {
@@ -332,23 +332,23 @@ class CjsCmfFormat extends CjsFormat {
     });
   }
 
-  /**
-   * Static one-shot async read.
-   *
-   * @param {Uint8Array|Buffer|ArrayBuffer|object} input Raw .cmf bytes or an existing raw read result.
-   * @param {object} [options] Reader values.
-   * @returns {Promise<object>}
+  /**
+   * Static one-shot async read.
+   *
+   * @param {Uint8Array|Buffer|ArrayBuffer|object} input Raw .cmf bytes or an existing raw read result.
+   * @param {object} [options] Reader values.
+   * @returns {Promise<object>}
    */
   static async readAsync(input, options = {}) {
     return readWithValuesAsync(CjsCmfFormat, input, normalizeValues(DEFAULT_VALUES, options));
   }
 
-  /**
-   * Static one-shot async read to shared geometry.
-   *
-   * @param {Uint8Array|Buffer|ArrayBuffer|object} input Raw .cmf bytes or an existing raw read result.
-   * @param {object} [options] Reader values.
-   * @returns {Promise<object>}
+  /**
+   * Static one-shot async read to shared geometry.
+   *
+   * @param {Uint8Array|Buffer|ArrayBuffer|object} input Raw .cmf bytes or an existing raw read result.
+   * @param {object} [options] Reader values.
+   * @returns {Promise<object>}
    */
   static async readSharedAsync(input, options = {}) {
     return CjsCmfFormat.readAsync(input, {
@@ -357,81 +357,81 @@ class CjsCmfFormat extends CjsFormat {
     });
   }
 
-  /**
-   * Static one-shot raw read.
-   *
-   * @param {Uint8Array|Buffer|ArrayBuffer|object} input Raw .cmf bytes or an existing raw read result.
-   * @param {object} [options] Reader values.
-   * @returns {object}
+  /**
+   * Static one-shot raw read.
+   *
+   * @param {Uint8Array|Buffer|ArrayBuffer|object} input Raw .cmf bytes or an existing raw read result.
+   * @param {object} [options] Reader values.
+   * @returns {object}
    */
   static readRaw(input, options = {}) {
     return readRawInput(input, normalizeValues(DEFAULT_VALUES, options));
   }
 
-  /**
-   * Static one-shot async raw read.
-   *
-   * @param {Uint8Array|Buffer|ArrayBuffer|object} input Raw .cmf bytes or an existing raw read result.
-   * @param {object} [options] Reader values.
-   * @returns {Promise<object>}
+  /**
+   * Static one-shot async raw read.
+   *
+   * @param {Uint8Array|Buffer|ArrayBuffer|object} input Raw .cmf bytes or an existing raw read result.
+   * @param {object} [options] Reader values.
+   * @returns {Promise<object>}
    */
   static async readRawAsync(input, options = {}) {
     return readRawInputAsync(input, normalizeValues(DEFAULT_VALUES, options));
   }
 
-  /**
-   * Static one-shot inspection.
-   *
-   * @param {Uint8Array|Buffer|ArrayBuffer|object} input Raw .cmf bytes or an existing raw read result.
-   * @param {object} [options] Reader values.
-   * @returns {object}
+  /**
+   * Static one-shot inspection.
+   *
+   * @param {Uint8Array|Buffer|ArrayBuffer|object} input Raw .cmf bytes or an existing raw read result.
+   * @param {object} [options] Reader values.
+   * @returns {object}
    */
   static inspect(input, options = {}) {
     return inspectRawCmfResult(input, normalizeValues(DEFAULT_VALUES, options));
   }
 
-  /**
-   * Static JSON-compatible conversion.
-   *
-   * @param {object} value Format output to convert.
-   * @returns {any} Plain JSON-compatible data.
+  /**
+   * Static JSON-compatible conversion.
+   *
+   * @param {object} value Format output to convert.
+   * @returns {any} Plain JSON-compatible data.
    */
   static toJSON(value) {
     return toJsonValue(value);
   }
 
-  /**
-   * Static one-shot binary write without compression.
-   *
-   * @param {object} graph CMF-native graph.
-   * @param {object} [options] Writer options (`compress`).
-   * @returns {Uint8Array} Complete .cmf file bytes.
+  /**
+   * Static one-shot binary write without compression.
+   *
+   * @param {object} graph CMF-native graph.
+   * @param {object} [options] Writer options (`compress`).
+   * @returns {Uint8Array} Complete .cmf file bytes.
    */
   static write(graph, options = {}) {
     return writeCmf(graph, options);
   }
 
-  /**
-   * Static one-shot binary write with meshoptimizer compression enabled by
-   * default.
-   *
-   * @param {object} graph CMF-native graph.
-   * @param {object} [options] Writer options (`compress`, default true).
-   * @returns {Promise<Uint8Array>} Complete .cmf file bytes.
+  /**
+   * Static one-shot binary write with meshoptimizer compression enabled by
+   * default.
+   *
+   * @param {object} graph CMF-native graph.
+   * @param {object} [options] Writer options (`compress`, default true).
+   * @returns {Promise<Uint8Array>} Complete .cmf file bytes.
    */
   static async writeAsync(graph, options = {}) {
     return writeCmfAsync(graph, options);
   }
 
-  /**
-   * Static one-shot shared-geometry write without compression.
-   *
-   * Equivalent to `loadShared` + buffer packing + `write`; this is the
-   * GR2/OBJ/glTF → CMF conversion entry point.
-   *
-   * @param {object} input Shared geometry root or mesh.
-   * @param {object} [options] Writer options (`compress`).
-   * @returns {Uint8Array} Complete .cmf file bytes.
+  /**
+   * Static one-shot shared-geometry write without compression.
+   *
+   * Equivalent to `loadShared` + buffer packing + `write`; this is the
+   * GR2/OBJ/glTF → CMF conversion entry point.
+   *
+   * @param {object} input Shared geometry root or mesh.
+   * @param {object} [options] Writer options (`compress`).
+   * @returns {Uint8Array} Complete .cmf file bytes.
    */
   static writeShared(input, options = {}) {
     const packed = packGraphBuffers(buildCmfFromShared(input, options));
@@ -441,13 +441,13 @@ class CjsCmfFormat extends CjsFormat {
     }, options);
   }
 
-  /**
-   * Static one-shot shared-geometry write with meshoptimizer compression
-   * enabled by default.
-   *
-   * @param {object} input Shared geometry root or mesh.
-   * @param {object} [options] Writer options (`compress`, default true).
-   * @returns {Promise<Uint8Array>} Complete .cmf file bytes.
+  /**
+   * Static one-shot shared-geometry write with meshoptimizer compression
+   * enabled by default.
+   *
+   * @param {object} input Shared geometry root or mesh.
+   * @param {object} [options] Writer options (`compress`, default true).
+   * @returns {Promise<Uint8Array>} Complete .cmf file bytes.
    */
   static async writeSharedAsync(input, options = {}) {
     const packed = packGraphBuffers(buildCmfFromShared(input, options));
@@ -457,8 +457,8 @@ class CjsCmfFormat extends CjsFormat {
     }, options);
   }
 
-  /**
-   * Emit targets for this format (canonical frozen enum).
+  /**
+   * Emit targets for this format (canonical frozen enum).
    */
   static Output = Object.freeze({
     JSON: OUTPUT_JSON,
@@ -472,6 +472,20 @@ class CjsCmfFormat extends CjsFormat {
   static CLASS_KEYS = CLASS_KEYS;
   static id = "cmf";
   static mediaTypes = Object.freeze(["geometry"]);
+  // The writer's own graph is the default: `write` takes a CMF-native graph,
+  // while `writeShared` converts a shared geometry root through it first.
+  // Both are lossless - CMF is the container this package writes for keeps.
+  static inputs = CjsFormat.defineInputs({
+    cmf: {
+      default: true,
+      payloadType: "geometry",
+      options: ["compress"]
+    },
+    shared: {
+      payloadType: "geometry",
+      options: ["compress"]
+    }
+  });
   static outputs = CjsFormat.defineOutputs({
     cmf: {
       default: true,