@carbonenginejs/runtime-resource 0.1.0 → 0.8.0

package/dist/formats/black/CjsBlackFormat.js

@@ -1,272 +1,278 @@
-import { CLASS_KEYS } from './core/schema.js';
-import { DEFAULT_VALUES, normalizeValues, validateClassKey, validateClass, toJsonValue, OUTPUT_DOCUMENT, OUTPUT_RAW, OUTPUT_RUNTIME, OUTPUT_JSON, OUTPUT_PAYLOAD } from './core/helpers.js';
-import { CJS_BLACK_FORMAT_ID, CJS_BLACK_EXTENSION, CJS_BLACK_FOURCC, CJS_BLACK_VERSION } from './core/blackConstants.js';
-import { CjsBlackReader } from './core/CjsBlackReader.js';
-
-const FORMAT_NAME = "CjsBlackFormat";
-
-/**
- * CarbonEngineJS-facing Black format profile.
- *
- * This package reads public-facing `.black` payload data using CarbonEngineJS
- * canonical schemas or source-shape registries.
- */
-class CjsBlackFormat {
-  #emit = DEFAULT_VALUES.emit;
-  #schema = DEFAULT_VALUES.schema;
-  #readerOptions = {};
-  #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 {CjsBlackFormat} This format profile.
-   */
-  SetValues(options = {}) {
-    const values = normalizeValues(this.GetValues(), options, CLASS_KEYS, FORMAT_NAME);
-    this.#emit = values.emit;
-    this.#schema = values.schema;
-    this.#classes = values.classes;
-    this.#readerOptions = CjsBlackFormat.copyReaderOptions(values);
-    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,
-      schema: this.#schema,
-      ...this.#readerOptions,
-      classes: this.#classes
-    }, options, CLASS_KEYS, FORMAT_NAME);
-  }
-
-  /**
-   * Set multiple runtime class constructors for this profile.
-   *
-   * @param {object} [classes] Map of Black class names to constructors.
-   * @returns {CjsBlackFormat} This format profile.
-   */
-  SetClasses(classes = {}) {
-    return this.SetValues({
-      classes
-    });
-  }
-
-  /**
-   * Set one node-class constructor for this profile.
-   *
-   * @param {string} type Black class name.
-   * @param {Function|null|undefined} Class Constructor to use, or nullish to delete.
-   * @returns {CjsBlackFormat} This format profile.
-   */
-  SetClass(type, Class) {
-    validateClassKey(CLASS_KEYS, type, FORMAT_NAME);
-    if (Class === null || Class === undefined) {
-      delete this.#classes[type];
-      return this;
-    }
-    validateClass(CLASS_KEYS, type, Class, FORMAT_NAME);
-    this.#classes = {
-      ...this.#classes,
-      [type]: Class
-    };
-    return this;
-  }
-
-  /**
-   * Get a configured runtime class constructor.
-   *
-   * @param {string} type Black class name.
-   * @returns {Function|undefined} The registered constructor, if any.
-   */
-  GetClass(type) {
-    validateClassKey(CLASS_KEYS, 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 Black data with this profile's values.
-   *
-   * @param {unknown} input Black format input.
-   * @param {object} [options] Per-call value overrides.
-   * @returns {object} Public payload output by default.
-   */
-  Read(input, options = {}) {
-    return CjsBlackFormat.read(input, this.GetValues(options));
-  }
-
-  /**
-   * Read Black data as a neutral document graph for diagnostics.
-   *
-   * @param {unknown} input Black format input.
-   * @param {object} [options] Per-call value overrides.
-   * @returns {object} CarbonEngineJS document graph.
-   */
-  ReadDocument(input, options = {}) {
-    return CjsBlackFormat.readDocument(input, this.GetValues(options));
-  }
-
-  /**
-   * Read Black data as runtime objects or plain source-shaped objects.
-   *
-   * @param {unknown} input Black format input.
-   * @param {object} [options] Per-call value overrides.
-   * @returns {object} Runtime read result.
-   */
-  ReadRuntime(input, options = {}) {
-    return CjsBlackFormat.readRuntime(input, this.GetValues(options));
-  }
-
-  /**
-   * Read Black data as compact public payload JSON.
-   *
-   * @param {unknown} input Black format input.
-   * @param {object} [options] Per-call value overrides.
-   * @returns {object} Public payload output.
-   */
-  ReadPayload(input, options = {}) {
-    return CjsBlackFormat.readPayload(input, this.GetValues(options));
-  }
-
-  /**
-   * Inspect Black data with this profile's values.
-   *
-   * @param {unknown} input Black format input.
-   * @param {object} [options] Per-call value overrides.
-   * @returns {object} Plain summary data.
-   */
-  Inspect(input, options = {}) {
-    return CjsBlackFormat.inspect(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 {unknown} input Black format input.
-   * @param {object} [options] Format values.
-   * @returns {object} Format output.
-   */
-  static read(input, options = {}) {
-    const values = normalizeValues(DEFAULT_VALUES, options, CLASS_KEYS, FORMAT_NAME);
-    if (values.emit === OUTPUT_DOCUMENT || values.emit === OUTPUT_RAW) return CjsBlackFormat.readDocument(input, values);
-    if (values.emit === OUTPUT_RUNTIME) return CjsBlackFormat.readRuntime(input, values);
-    return CjsBlackFormat.readPayload(input, values);
-  }
-
-  /**
-   * Static one-shot document read.
-   *
-   * @param {unknown} input Black format input.
-   * @param {object} [options] Format values.
-   * @returns {object} CarbonEngineJS document graph.
-   */
-  static readDocument(input, options = {}) {
-    return new CjsBlackReader(input, normalizeValues(DEFAULT_VALUES, options, CLASS_KEYS, FORMAT_NAME)).ReadDocument();
-  }
-
-  /**
-   * Static one-shot runtime read.
-   *
-   * @param {unknown} input Black format input.
-   * @param {object} [options] Format values.
-   * @returns {object} Runtime read result.
-   */
-  static readRuntime(input, options = {}) {
-    return new CjsBlackReader(input, normalizeValues(DEFAULT_VALUES, options, CLASS_KEYS, FORMAT_NAME)).ReadRuntime();
-  }
-
-  /**
-   * Static one-shot public payload read.
-   *
-   * @param {unknown} input Black format input.
-   * @param {object} [options] Format values.
-   * @returns {object} Public payload output.
-   */
-  static readPayload(input, options = {}) {
-    return new CjsBlackReader(input, normalizeValues(DEFAULT_VALUES, options, CLASS_KEYS, FORMAT_NAME)).ReadPayload();
-  }
-
-  /**
-   * Static one-shot inspection.
-   *
-   * @param {unknown} input Black format input.
-   * @param {object} [options] Format values.
-   * @returns {object} Plain summary data.
-   */
-  static inspect(input, options = {}) {
-    return new CjsBlackReader(input, normalizeValues(DEFAULT_VALUES, options, CLASS_KEYS, FORMAT_NAME)).Inspect();
-  }
-
-  /**
-   * Static JSON-compatible conversion.
-   *
-   * @param {any} value Format output to convert.
-   * @returns {any} Plain JSON-compatible data.
-   */
-  static toJSON(value) {
-    return toJsonValue(value);
-  }
-  static OUTPUT_JSON = OUTPUT_JSON;
-  static OUTPUT_RAW = OUTPUT_RAW;
-  static OUTPUT_DOCUMENT = OUTPUT_DOCUMENT;
-  static OUTPUT_PAYLOAD = OUTPUT_PAYLOAD;
-  static OUTPUT_RUNTIME = OUTPUT_RUNTIME;
-  static CLASS_KEYS = CLASS_KEYS;
-  static id = CJS_BLACK_FORMAT_ID;
-  static extensions = Object.freeze([CJS_BLACK_EXTENSION]);
-  static fourCC = CJS_BLACK_FOURCC;
-  static version = CJS_BLACK_VERSION;
-  static type = Object.freeze(["data"]);
-  static mediaTypes = Object.freeze(["data"]);
-  static inputTypes = Object.freeze(["black"]);
-  static outputTypes = Object.freeze([OUTPUT_JSON, OUTPUT_DOCUMENT, OUTPUT_PAYLOAD, OUTPUT_RUNTIME]);
-  static debugOutputTypes = Object.freeze([OUTPUT_RAW]);
-  static copyReaderOptions(values) {
-    const {
-      emit: _emit,
-      schema: _schema,
-      classes: _classes,
-      ...readerOptions
-    } = values;
-    return readerOptions;
-  }
-}
-
-export { CjsBlackFormat, CjsBlackFormat as default };
-//# sourceMappingURL=CjsBlackFormat.js.map
+import { CLASS_KEYS } from './core/schema.js';
+import { DEFAULT_VALUES, normalizeValues, validateClassKey, validateClass, toJsonValue, OUTPUT_DOCUMENT, OUTPUT_RAW, OUTPUT_RUNTIME, OUTPUT_PAYLOAD, OUTPUT_JSON } from './core/helpers.js';
+import { CJS_BLACK_FORMAT_ID, CJS_BLACK_EXTENSION, CJS_BLACK_FOURCC, CJS_BLACK_VERSION } from './core/blackConstants.js';
+import { CjsBlackReader } from './core/CjsBlackReader.js';
+
+const FORMAT_NAME = "CjsBlackFormat";
+
+/**
+ * CarbonEngineJS-facing Black format profile.
+ *
+ * This package reads public-facing `.black` payload data using CarbonEngineJS
+ * canonical schemas or source-shape registries.
+ */
+class CjsBlackFormat {
+  #emit = DEFAULT_VALUES.emit;
+  #schema = DEFAULT_VALUES.schema;
+  #readerOptions = {};
+  #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 {CjsBlackFormat} This format profile.
+   */
+  SetValues(options = {}) {
+    const values = normalizeValues(this.GetValues(), options, CLASS_KEYS, FORMAT_NAME);
+    this.#emit = values.emit;
+    this.#schema = values.schema;
+    this.#classes = values.classes;
+    this.#readerOptions = CjsBlackFormat.copyReaderOptions(values);
+    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,
+      schema: this.#schema,
+      ...this.#readerOptions,
+      classes: this.#classes
+    }, options, CLASS_KEYS, FORMAT_NAME);
+  }
+
+  /**
+   * Set multiple runtime class constructors for this profile.
+   *
+   * @param {object} [classes] Map of Black class names to constructors.
+   * @returns {CjsBlackFormat} This format profile.
+   */
+  SetClasses(classes = {}) {
+    return this.SetValues({
+      classes
+    });
+  }
+
+  /**
+   * Set one node-class constructor for this profile.
+   *
+   * @param {string} type Black class name.
+   * @param {Function|null|undefined} Class Constructor to use, or nullish to delete.
+   * @returns {CjsBlackFormat} This format profile.
+   */
+  SetClass(type, Class) {
+    validateClassKey(CLASS_KEYS, type, FORMAT_NAME);
+    if (Class === null || Class === undefined) {
+      delete this.#classes[type];
+      return this;
+    }
+    validateClass(CLASS_KEYS, type, Class, FORMAT_NAME);
+    this.#classes = {
+      ...this.#classes,
+      [type]: Class
+    };
+    return this;
+  }
+
+  /**
+   * Get a configured runtime class constructor.
+   *
+   * @param {string} type Black class name.
+   * @returns {Function|undefined} The registered constructor, if any.
+   */
+  GetClass(type) {
+    validateClassKey(CLASS_KEYS, 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 Black data with this profile's values.
+   *
+   * @param {unknown} input Black format input.
+   * @param {object} [options] Per-call value overrides.
+   * @returns {object} Public payload output by default.
+   */
+  Read(input, options = {}) {
+    return CjsBlackFormat.read(input, this.GetValues(options));
+  }
+
+  /**
+   * Read Black data as a neutral document graph for diagnostics.
+   *
+   * @param {unknown} input Black format input.
+   * @param {object} [options] Per-call value overrides.
+   * @returns {object} CarbonEngineJS document graph.
+   */
+  ReadDocument(input, options = {}) {
+    return CjsBlackFormat.readDocument(input, this.GetValues(options));
+  }
+
+  /**
+   * Read Black data as runtime objects or plain source-shaped objects.
+   *
+   * @param {unknown} input Black format input.
+   * @param {object} [options] Per-call value overrides.
+   * @returns {object} Runtime read result.
+   */
+  ReadRuntime(input, options = {}) {
+    return CjsBlackFormat.readRuntime(input, this.GetValues(options));
+  }
+
+  /**
+   * Read Black data as compact public payload JSON.
+   *
+   * @param {unknown} input Black format input.
+   * @param {object} [options] Per-call value overrides.
+   * @returns {object} Public payload output.
+   */
+  ReadPayload(input, options = {}) {
+    return CjsBlackFormat.readPayload(input, this.GetValues(options));
+  }
+
+  /**
+   * Inspect Black data with this profile's values.
+   *
+   * @param {unknown} input Black format input.
+   * @param {object} [options] Per-call value overrides.
+   * @returns {object} Plain summary data.
+   */
+  Inspect(input, options = {}) {
+    return CjsBlackFormat.inspect(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 {unknown} input Black format input.
+   * @param {object} [options] Format values.
+   * @returns {object} Format output.
+   */
+  static read(input, options = {}) {
+    const values = normalizeValues(DEFAULT_VALUES, options, CLASS_KEYS, FORMAT_NAME);
+    if (values.emit === OUTPUT_DOCUMENT || values.emit === OUTPUT_RAW) return CjsBlackFormat.readDocument(input, values);
+    if (values.emit === OUTPUT_RUNTIME) return CjsBlackFormat.readRuntime(input, values);
+    return CjsBlackFormat.readPayload(input, values);
+  }
+
+  /**
+   * Static one-shot document read.
+   *
+   * @param {unknown} input Black format input.
+   * @param {object} [options] Format values.
+   * @returns {object} CarbonEngineJS document graph.
+   */
+  static readDocument(input, options = {}) {
+    return new CjsBlackReader(input, normalizeValues(DEFAULT_VALUES, options, CLASS_KEYS, FORMAT_NAME)).ReadDocument();
+  }
+
+  /**
+   * Static one-shot runtime read.
+   *
+   * @param {unknown} input Black format input.
+   * @param {object} [options] Format values.
+   * @returns {object} Runtime read result.
+   */
+  static readRuntime(input, options = {}) {
+    return new CjsBlackReader(input, normalizeValues(DEFAULT_VALUES, options, CLASS_KEYS, FORMAT_NAME)).ReadRuntime();
+  }
+
+  /**
+   * Static one-shot public payload read.
+   *
+   * @param {unknown} input Black format input.
+   * @param {object} [options] Format values.
+   * @returns {object} Public payload output.
+   */
+  static readPayload(input, options = {}) {
+    return new CjsBlackReader(input, normalizeValues(DEFAULT_VALUES, options, CLASS_KEYS, FORMAT_NAME)).ReadPayload();
+  }
+
+  /**
+   * Static one-shot inspection.
+   *
+   * @param {unknown} input Black format input.
+   * @param {object} [options] Format values.
+   * @returns {object} Plain summary data.
+   */
+  static inspect(input, options = {}) {
+    return new CjsBlackReader(input, normalizeValues(DEFAULT_VALUES, options, CLASS_KEYS, FORMAT_NAME)).Inspect();
+  }
+
+  /**
+   * Static JSON-compatible conversion.
+   *
+   * @param {any} value Format output to convert.
+   * @returns {any} Plain JSON-compatible data.
+   */
+  static toJSON(value) {
+    return toJsonValue(value);
+  }
+
+  /**
+   * Emit targets for this format (canonical frozen enum).
+   */
+  static Output = Object.freeze({
+    JSON: OUTPUT_JSON,
+    RAW: OUTPUT_RAW,
+    DOCUMENT: OUTPUT_DOCUMENT,
+    PAYLOAD: OUTPUT_PAYLOAD,
+    RUNTIME: OUTPUT_RUNTIME
+  });
+  static CLASS_KEYS = CLASS_KEYS;
+  static id = CJS_BLACK_FORMAT_ID;
+  static extensions = Object.freeze([CJS_BLACK_EXTENSION]);
+  static fourCC = CJS_BLACK_FOURCC;
+  static version = CJS_BLACK_VERSION;
+  static type = Object.freeze(["data"]);
+  static mediaTypes = Object.freeze(["data"]);
+  static inputTypes = Object.freeze(["black"]);
+  static outputTypes = Object.freeze([OUTPUT_JSON, OUTPUT_DOCUMENT, OUTPUT_PAYLOAD, OUTPUT_RUNTIME]);
+  static debugOutputTypes = Object.freeze([OUTPUT_RAW]);
+  static copyReaderOptions(values) {
+    const {
+      emit: _emit,
+      schema: _schema,
+      classes: _classes,
+      ...readerOptions
+    } = values;
+    return readerOptions;
+  }
+}
+
+export { CjsBlackFormat, CjsBlackFormat as default };
+//# sourceMappingURL=CjsBlackFormat.js.map

package/dist/formats/black/CjsBlackFormat.js.map

@@ -1 +1 @@
-{"version":3,"file":"CjsBlackFormat.js","sources":["../../../../src/formats/black/CjsBlackFormat.js"],"sourcesContent":["import { CLASS_KEYS } from \"./core/schema.js\";\nimport {\n    DEFAULT_VALUES,\n    OUTPUT_DOCUMENT,\n    OUTPUT_JSON,\n    OUTPUT_PAYLOAD,\n    OUTPUT_RAW,\n    OUTPUT_RUNTIME,\n    normalizeValues,\n    toJsonValue,\n    validateClass,\n    validateClassKey\n} from \"./core/helpers.js\";\nimport {\n    CJS_BLACK_EXTENSION,\n    CJS_BLACK_FORMAT_ID,\n    CJS_BLACK_FOURCC,\n    CJS_BLACK_VERSION\n} from \"./core/blackConstants.js\";\nimport { CjsBlackReader } from \"./core/CjsBlackReader.js\";\n\nconst FORMAT_NAME = \"CjsBlackFormat\";\n\n/**\n * CarbonEngineJS-facing Black format profile.\n *\n * This package reads public-facing `.black` payload data using CarbonEngineJS\n * canonical schemas or source-shape registries.\n */\nexport class CjsBlackFormat\n{\n\n    #emit = DEFAULT_VALUES.emit;\n    #schema = DEFAULT_VALUES.schema;\n    #readerOptions = {};\n    #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 {CjsBlackFormat} This format profile.\n     */\n    SetValues(options = {})\n    {\n        const values = normalizeValues(this.GetValues(), options, CLASS_KEYS, FORMAT_NAME);\n        this.#emit = values.emit;\n        this.#schema = values.schema;\n        this.#classes = values.classes;\n        this.#readerOptions = CjsBlackFormat.copyReaderOptions(values);\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            schema: this.#schema,\n            ...this.#readerOptions,\n            classes: this.#classes\n        }, options, CLASS_KEYS, FORMAT_NAME);\n    }\n\n    /**\n     * Set multiple runtime class constructors for this profile.\n     *\n     * @param {object} [classes] Map of Black class names to constructors.\n     * @returns {CjsBlackFormat} 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 Black class name.\n     * @param {Function|null|undefined} Class Constructor to use, or nullish to delete.\n     * @returns {CjsBlackFormat} This format profile.\n     */\n    SetClass(type, Class)\n    {\n        validateClassKey(CLASS_KEYS, type, FORMAT_NAME);\n        if (Class === null || Class === undefined)\n        {\n            delete this.#classes[type];\n            return this;\n        }\n\n        validateClass(CLASS_KEYS, type, Class, FORMAT_NAME);\n        this.#classes = { ...this.#classes, [type]: Class };\n        return this;\n    }\n\n    /**\n     * Get a configured runtime class constructor.\n     *\n     * @param {string} type Black class name.\n     * @returns {Function|undefined} The registered constructor, if any.\n     */\n    GetClass(type)\n    {\n        validateClassKey(CLASS_KEYS, 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 Black data with this profile's values.\n     *\n     * @param {unknown} input Black format input.\n     * @param {object} [options] Per-call value overrides.\n     * @returns {object} Public payload output by default.\n     */\n    Read(input, options = {})\n    {\n        return CjsBlackFormat.read(input, this.GetValues(options));\n    }\n\n    /**\n     * Read Black data as a neutral document graph for diagnostics.\n     *\n     * @param {unknown} input Black format input.\n     * @param {object} [options] Per-call value overrides.\n     * @returns {object} CarbonEngineJS document graph.\n     */\n    ReadDocument(input, options = {})\n    {\n        return CjsBlackFormat.readDocument(input, this.GetValues(options));\n    }\n\n    /**\n     * Read Black data as runtime objects or plain source-shaped objects.\n     *\n     * @param {unknown} input Black format input.\n     * @param {object} [options] Per-call value overrides.\n     * @returns {object} Runtime read result.\n     */\n    ReadRuntime(input, options = {})\n    {\n        return CjsBlackFormat.readRuntime(input, this.GetValues(options));\n    }\n\n    /**\n     * Read Black data as compact public payload JSON.\n     *\n     * @param {unknown} input Black format input.\n     * @param {object} [options] Per-call value overrides.\n     * @returns {object} Public payload output.\n     */\n    ReadPayload(input, options = {})\n    {\n        return CjsBlackFormat.readPayload(input, this.GetValues(options));\n    }\n\n    /**\n     * Inspect Black data with this profile's values.\n     *\n     * @param {unknown} input Black format input.\n     * @param {object} [options] Per-call value overrides.\n     * @returns {object} Plain summary data.\n     */\n    Inspect(input, options = {})\n    {\n        return CjsBlackFormat.inspect(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 {unknown} input Black format input.\n     * @param {object} [options] Format values.\n     * @returns {object} Format output.\n     */\n    static read(input, options = {})\n    {\n        const values = normalizeValues(DEFAULT_VALUES, options, CLASS_KEYS, FORMAT_NAME);\n        if (values.emit === OUTPUT_DOCUMENT || values.emit === OUTPUT_RAW) return CjsBlackFormat.readDocument(input, values);\n        if (values.emit === OUTPUT_RUNTIME) return CjsBlackFormat.readRuntime(input, values);\n        return CjsBlackFormat.readPayload(input, values);\n    }\n\n    /**\n     * Static one-shot document read.\n     *\n     * @param {unknown} input Black format input.\n     * @param {object} [options] Format values.\n     * @returns {object} CarbonEngineJS document graph.\n     */\n    static readDocument(input, options = {})\n    {\n        return new CjsBlackReader(input, normalizeValues(DEFAULT_VALUES, options, CLASS_KEYS, FORMAT_NAME)).ReadDocument();\n    }\n\n    /**\n     * Static one-shot runtime read.\n     *\n     * @param {unknown} input Black format input.\n     * @param {object} [options] Format values.\n     * @returns {object} Runtime read result.\n     */\n    static readRuntime(input, options = {})\n    {\n        return new CjsBlackReader(input, normalizeValues(DEFAULT_VALUES, options, CLASS_KEYS, FORMAT_NAME)).ReadRuntime();\n    }\n\n    /**\n     * Static one-shot public payload read.\n     *\n     * @param {unknown} input Black format input.\n     * @param {object} [options] Format values.\n     * @returns {object} Public payload output.\n     */\n    static readPayload(input, options = {})\n    {\n        return new CjsBlackReader(input, normalizeValues(DEFAULT_VALUES, options, CLASS_KEYS, FORMAT_NAME)).ReadPayload();\n    }\n\n    /**\n     * Static one-shot inspection.\n     *\n     * @param {unknown} input Black format input.\n     * @param {object} [options] Format values.\n     * @returns {object} Plain summary data.\n     */\n    static inspect(input, options = {})\n    {\n        return new CjsBlackReader(input, normalizeValues(DEFAULT_VALUES, options, CLASS_KEYS, FORMAT_NAME)).Inspect();\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    static OUTPUT_JSON = OUTPUT_JSON;\n    static OUTPUT_RAW = OUTPUT_RAW;\n    static OUTPUT_DOCUMENT = OUTPUT_DOCUMENT;\n    static OUTPUT_PAYLOAD = OUTPUT_PAYLOAD;\n    static OUTPUT_RUNTIME = OUTPUT_RUNTIME;\n    static CLASS_KEYS = CLASS_KEYS;\n    static id = CJS_BLACK_FORMAT_ID;\n    static extensions = Object.freeze([CJS_BLACK_EXTENSION]);\n    static fourCC = CJS_BLACK_FOURCC;\n    static version = CJS_BLACK_VERSION;\n    static type = Object.freeze([ \"data\" ]);\n    static mediaTypes = Object.freeze([ \"data\" ]);\n    static inputTypes = Object.freeze([ \"black\" ]);\n    static outputTypes = Object.freeze([ OUTPUT_JSON, OUTPUT_DOCUMENT, OUTPUT_PAYLOAD, OUTPUT_RUNTIME ]);\n    static debugOutputTypes = Object.freeze([ OUTPUT_RAW ]);\n\n    static copyReaderOptions(values)\n    {\n        const {\n            emit: _emit,\n            schema: _schema,\n            classes: _classes,\n            ...readerOptions\n        } = values;\n        return readerOptions;\n    }\n\n}\n\nexport default CjsBlackFormat;\n"],"names":["FORMAT_NAME","CjsBlackFormat","DEFAULT_VALUES","emit","schema","constructor","options","SetValues","values","normalizeValues","GetValues","CLASS_KEYS","classes","copyReaderOptions","SetClasses","SetClass","type","Class","validateClassKey","undefined","validateClass","GetClass","HasClass","Read","input","read","ReadDocument","readDocument","ReadRuntime","readRuntime","ReadPayload","readPayload","Inspect","inspect","ToJSON","value","toJsonValue","OUTPUT_DOCUMENT","OUTPUT_RAW","OUTPUT_RUNTIME","CjsBlackReader","toJSON","OUTPUT_JSON","OUTPUT_PAYLOAD","id","CJS_BLACK_FORMAT_ID","extensions","Object","freeze","CJS_BLACK_EXTENSION","fourCC","CJS_BLACK_FOURCC","version","CJS_BLACK_VERSION","mediaTypes","inputTypes","outputTypes","debugOutputTypes","_emit","_schema","_classes","readerOptions"],"mappings":"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"}
+{"version":3,"file":"CjsBlackFormat.js","sources":["../../../../src/formats/black/CjsBlackFormat.js"],"sourcesContent":["import { CLASS_KEYS } from \"./core/schema.js\";\nimport {\n    DEFAULT_VALUES,\n    OUTPUT_DOCUMENT,\n    OUTPUT_JSON,\n    OUTPUT_PAYLOAD,\n    OUTPUT_RAW,\n    OUTPUT_RUNTIME,\n    normalizeValues,\n    toJsonValue,\n    validateClass,\n    validateClassKey\n} from \"./core/helpers.js\";\nimport {\n    CJS_BLACK_EXTENSION,\n    CJS_BLACK_FORMAT_ID,\n    CJS_BLACK_FOURCC,\n    CJS_BLACK_VERSION\n} from \"./core/blackConstants.js\";\nimport { CjsBlackReader } from \"./core/CjsBlackReader.js\";\n\nconst FORMAT_NAME = \"CjsBlackFormat\";\n\n/**\n * CarbonEngineJS-facing Black format profile.\n *\n * This package reads public-facing `.black` payload data using CarbonEngineJS\n * canonical schemas or source-shape registries.\n */\nexport class CjsBlackFormat\n{\n\n    #emit = DEFAULT_VALUES.emit;\n    #schema = DEFAULT_VALUES.schema;\n    #readerOptions = {};\n    #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 {CjsBlackFormat} This format profile.\n     */\n    SetValues(options = {})\n    {\n        const values = normalizeValues(this.GetValues(), options, CLASS_KEYS, FORMAT_NAME);\n        this.#emit = values.emit;\n        this.#schema = values.schema;\n        this.#classes = values.classes;\n        this.#readerOptions = CjsBlackFormat.copyReaderOptions(values);\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            schema: this.#schema,\n            ...this.#readerOptions,\n            classes: this.#classes\n        }, options, CLASS_KEYS, FORMAT_NAME);\n    }\n\n    /**\n     * Set multiple runtime class constructors for this profile.\n     *\n     * @param {object} [classes] Map of Black class names to constructors.\n     * @returns {CjsBlackFormat} 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 Black class name.\n     * @param {Function|null|undefined} Class Constructor to use, or nullish to delete.\n     * @returns {CjsBlackFormat} This format profile.\n     */\n    SetClass(type, Class)\n    {\n        validateClassKey(CLASS_KEYS, type, FORMAT_NAME);\n        if (Class === null || Class === undefined)\n        {\n            delete this.#classes[type];\n            return this;\n        }\n\n        validateClass(CLASS_KEYS, type, Class, FORMAT_NAME);\n        this.#classes = { ...this.#classes, [type]: Class };\n        return this;\n    }\n\n    /**\n     * Get a configured runtime class constructor.\n     *\n     * @param {string} type Black class name.\n     * @returns {Function|undefined} The registered constructor, if any.\n     */\n    GetClass(type)\n    {\n        validateClassKey(CLASS_KEYS, 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 Black data with this profile's values.\n     *\n     * @param {unknown} input Black format input.\n     * @param {object} [options] Per-call value overrides.\n     * @returns {object} Public payload output by default.\n     */\n    Read(input, options = {})\n    {\n        return CjsBlackFormat.read(input, this.GetValues(options));\n    }\n\n    /**\n     * Read Black data as a neutral document graph for diagnostics.\n     *\n     * @param {unknown} input Black format input.\n     * @param {object} [options] Per-call value overrides.\n     * @returns {object} CarbonEngineJS document graph.\n     */\n    ReadDocument(input, options = {})\n    {\n        return CjsBlackFormat.readDocument(input, this.GetValues(options));\n    }\n\n    /**\n     * Read Black data as runtime objects or plain source-shaped objects.\n     *\n     * @param {unknown} input Black format input.\n     * @param {object} [options] Per-call value overrides.\n     * @returns {object} Runtime read result.\n     */\n    ReadRuntime(input, options = {})\n    {\n        return CjsBlackFormat.readRuntime(input, this.GetValues(options));\n    }\n\n    /**\n     * Read Black data as compact public payload JSON.\n     *\n     * @param {unknown} input Black format input.\n     * @param {object} [options] Per-call value overrides.\n     * @returns {object} Public payload output.\n     */\n    ReadPayload(input, options = {})\n    {\n        return CjsBlackFormat.readPayload(input, this.GetValues(options));\n    }\n\n    /**\n     * Inspect Black data with this profile's values.\n     *\n     * @param {unknown} input Black format input.\n     * @param {object} [options] Per-call value overrides.\n     * @returns {object} Plain summary data.\n     */\n    Inspect(input, options = {})\n    {\n        return CjsBlackFormat.inspect(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 {unknown} input Black format input.\n     * @param {object} [options] Format values.\n     * @returns {object} Format output.\n     */\n    static read(input, options = {})\n    {\n        const values = normalizeValues(DEFAULT_VALUES, options, CLASS_KEYS, FORMAT_NAME);\n        if (values.emit === OUTPUT_DOCUMENT || values.emit === OUTPUT_RAW) return CjsBlackFormat.readDocument(input, values);\n        if (values.emit === OUTPUT_RUNTIME) return CjsBlackFormat.readRuntime(input, values);\n        return CjsBlackFormat.readPayload(input, values);\n    }\n\n    /**\n     * Static one-shot document read.\n     *\n     * @param {unknown} input Black format input.\n     * @param {object} [options] Format values.\n     * @returns {object} CarbonEngineJS document graph.\n     */\n    static readDocument(input, options = {})\n    {\n        return new CjsBlackReader(input, normalizeValues(DEFAULT_VALUES, options, CLASS_KEYS, FORMAT_NAME)).ReadDocument();\n    }\n\n    /**\n     * Static one-shot runtime read.\n     *\n     * @param {unknown} input Black format input.\n     * @param {object} [options] Format values.\n     * @returns {object} Runtime read result.\n     */\n    static readRuntime(input, options = {})\n    {\n        return new CjsBlackReader(input, normalizeValues(DEFAULT_VALUES, options, CLASS_KEYS, FORMAT_NAME)).ReadRuntime();\n    }\n\n    /**\n     * Static one-shot public payload read.\n     *\n     * @param {unknown} input Black format input.\n     * @param {object} [options] Format values.\n     * @returns {object} Public payload output.\n     */\n    static readPayload(input, options = {})\n    {\n        return new CjsBlackReader(input, normalizeValues(DEFAULT_VALUES, options, CLASS_KEYS, FORMAT_NAME)).ReadPayload();\n    }\n\n    /**\n     * Static one-shot inspection.\n     *\n     * @param {unknown} input Black format input.\n     * @param {object} [options] Format values.\n     * @returns {object} Plain summary data.\n     */\n    static inspect(input, options = {})\n    {\n        return new CjsBlackReader(input, normalizeValues(DEFAULT_VALUES, options, CLASS_KEYS, FORMAT_NAME)).Inspect();\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     * Emit targets for this format (canonical frozen enum).\n     */\n    static Output = Object.freeze({\n        JSON: OUTPUT_JSON,\n        RAW: OUTPUT_RAW,\n        DOCUMENT: OUTPUT_DOCUMENT,\n        PAYLOAD: OUTPUT_PAYLOAD,\n        RUNTIME: OUTPUT_RUNTIME\n    });\n    static CLASS_KEYS = CLASS_KEYS;\n    static id = CJS_BLACK_FORMAT_ID;\n    static extensions = Object.freeze([CJS_BLACK_EXTENSION]);\n    static fourCC = CJS_BLACK_FOURCC;\n    static version = CJS_BLACK_VERSION;\n    static type = Object.freeze([ \"data\" ]);\n    static mediaTypes = Object.freeze([ \"data\" ]);\n    static inputTypes = Object.freeze([ \"black\" ]);\n    static outputTypes = Object.freeze([ OUTPUT_JSON, OUTPUT_DOCUMENT, OUTPUT_PAYLOAD, OUTPUT_RUNTIME ]);\n    static debugOutputTypes = Object.freeze([ OUTPUT_RAW ]);\n\n    static copyReaderOptions(values)\n    {\n        const {\n            emit: _emit,\n            schema: _schema,\n            classes: _classes,\n            ...readerOptions\n        } = values;\n        return readerOptions;\n    }\n\n}\n\nexport default CjsBlackFormat;\n"],"names":["FORMAT_NAME","CjsBlackFormat","DEFAULT_VALUES","emit","schema","constructor","options","SetValues","values","normalizeValues","GetValues","CLASS_KEYS","classes","copyReaderOptions","SetClasses","SetClass","type","Class","validateClassKey","undefined","validateClass","GetClass","HasClass","Read","input","read","ReadDocument","readDocument","ReadRuntime","readRuntime","ReadPayload","readPayload","Inspect","inspect","ToJSON","value","toJsonValue","OUTPUT_DOCUMENT","OUTPUT_RAW","OUTPUT_RUNTIME","CjsBlackReader","toJSON","Output","Object","freeze","JSON","OUTPUT_JSON","RAW","DOCUMENT","PAYLOAD","OUTPUT_PAYLOAD","RUNTIME","id","CJS_BLACK_FORMAT_ID","extensions","CJS_BLACK_EXTENSION","fourCC","CJS_BLACK_FOURCC","version","CJS_BLACK_VERSION","mediaTypes","inputTypes","outputTypes","debugOutputTypes","_emit","_schema","_classes","readerOptions"],"mappings":";;;;;AAqBA,MAAMA,WAAW,GAAG,gBAAgB;;AAEpC;AACA;AACA;AACA;AACA;AACA;AACO,MAAMC,cAAc,CAC3B;AAEI,EAAA,KAAK,GAAGC,cAAc,CAACC,IAAI;AAC3B,EAAA,OAAO,GAAGD,cAAc,CAACE,MAAM;EAC/B,cAAc,GAAG,EAAE;EACnB,QAAQ,GAAG,EAAE;;AAEb;AACJ;AACA;AACA;AACA;AACIC,EAAAA,WAAWA,CAACC,OAAO,GAAG,EAAE,EACxB;AACI,IAAA,IAAI,CAACC,SAAS,CAACD,OAAO,CAAC;AAC3B,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;AACIC,EAAAA,SAASA,CAACD,OAAO,GAAG,EAAE,EACtB;AACI,IAAA,MAAME,MAAM,GAAGC,eAAe,CAAC,IAAI,CAACC,SAAS,EAAE,EAAEJ,OAAO,EAAEK,UAAU,EAAEX,WAAW,CAAC;AAClF,IAAA,IAAI,CAAC,KAAK,GAAGQ,MAAM,CAACL,IAAI;AACxB,IAAA,IAAI,CAAC,OAAO,GAAGK,MAAM,CAACJ,MAAM;AAC5B,IAAA,IAAI,CAAC,QAAQ,GAAGI,MAAM,CAACI,OAAO;IAC9B,IAAI,CAAC,cAAc,GAAGX,cAAc,CAACY,iBAAiB,CAACL,MAAM,CAAC;AAC9D,IAAA,OAAO,IAAI;AACf,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;AACIE,EAAAA,SAASA,CAACJ,OAAO,GAAG,EAAE,EACtB;AACI,IAAA,OAAOG,eAAe,CAAC;AACnBN,MAAAA,IAAI,EAAE,IAAI,CAAC,KAAK;AAChBC,MAAAA,MAAM,EAAE,IAAI,CAAC,OAAO;MACpB,GAAG,IAAI,CAAC,cAAc;MACtBQ,OAAO,EAAE,IAAI,CAAC;AAClB,KAAC,EAAEN,OAAO,EAAEK,UAAU,EAAEX,WAAW,CAAC;AACxC,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;AACIc,EAAAA,UAAUA,CAACF,OAAO,GAAG,EAAE,EACvB;IACI,OAAO,IAAI,CAACL,SAAS,CAAC;AAAEK,MAAAA;AAAQ,KAAC,CAAC;AACtC,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;AACA;AACIG,EAAAA,QAAQA,CAACC,IAAI,EAAEC,KAAK,EACpB;AACIC,IAAAA,gBAAgB,CAACP,UAAU,EAAEK,IAAI,EAAEhB,WAAW,CAAC;AAC/C,IAAA,IAAIiB,KAAK,KAAK,IAAI,IAAIA,KAAK,KAAKE,SAAS,EACzC;AACI,MAAA,OAAO,IAAI,CAAC,QAAQ,CAACH,IAAI,CAAC;AAC1B,MAAA,OAAO,IAAI;AACf,IAAA;IAEAI,aAAa,CAACT,UAAU,EAAEK,IAAI,EAAEC,KAAK,EAAEjB,WAAW,CAAC;IACnD,IAAI,CAAC,QAAQ,GAAG;MAAE,GAAG,IAAI,CAAC,QAAQ;AAAE,MAAA,CAACgB,IAAI,GAAGC;KAAO;AACnD,IAAA,OAAO,IAAI;AACf,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;EACII,QAAQA,CAACL,IAAI,EACb;AACIE,IAAAA,gBAAgB,CAACP,UAAU,EAAEK,IAAI,EAAEhB,WAAW,CAAC;AAC/C,IAAA,OAAO,IAAI,CAAC,QAAQ,CAACgB,IAAI,CAAC;AAC9B,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;EACIM,QAAQA,CAACN,IAAI,EACb;AACI,IAAA,OAAO,CAAC,CAAC,IAAI,CAACK,QAAQ,CAACL,IAAI,CAAC;AAChC,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;AACA;AACIO,EAAAA,IAAIA,CAACC,KAAK,EAAElB,OAAO,GAAG,EAAE,EACxB;AACI,IAAA,OAAOL,cAAc,CAACwB,IAAI,CAACD,KAAK,EAAE,IAAI,CAACd,SAAS,CAACJ,OAAO,CAAC,CAAC;AAC9D,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;AACA;AACIoB,EAAAA,YAAYA,CAACF,KAAK,EAAElB,OAAO,GAAG,EAAE,EAChC;AACI,IAAA,OAAOL,cAAc,CAAC0B,YAAY,CAACH,KAAK,EAAE,IAAI,CAACd,SAAS,CAACJ,OAAO,CAAC,CAAC;AACtE,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;AACA;AACIsB,EAAAA,WAAWA,CAACJ,KAAK,EAAElB,OAAO,GAAG,EAAE,EAC/B;AACI,IAAA,OAAOL,cAAc,CAAC4B,WAAW,CAACL,KAAK,EAAE,IAAI,CAACd,SAAS,CAACJ,OAAO,CAAC,CAAC;AACrE,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;AACA;AACIwB,EAAAA,WAAWA,CAACN,KAAK,EAAElB,OAAO,GAAG,EAAE,EAC/B;AACI,IAAA,OAAOL,cAAc,CAAC8B,WAAW,CAACP,KAAK,EAAE,IAAI,CAACd,SAAS,CAACJ,OAAO,CAAC,CAAC;AACrE,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;AACA;AACI0B,EAAAA,OAAOA,CAACR,KAAK,EAAElB,OAAO,GAAG,EAAE,EAC3B;AACI,IAAA,OAAOL,cAAc,CAACgC,OAAO,CAACT,KAAK,EAAE,IAAI,CAACd,SAAS,CAACJ,OAAO,CAAC,CAAC;AACjE,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;EACI4B,MAAMA,CAACC,KAAK,EACZ;IACI,OAAOC,WAAW,CAACD,KAAK,CAAC;AAC7B,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;AACA;EACI,OAAOV,IAAIA,CAACD,KAAK,EAAElB,OAAO,GAAG,EAAE,EAC/B;IACI,MAAME,MAAM,GAAGC,eAAe,CAACP,cAAc,EAAEI,OAAO,EAAEK,UAAU,EAAEX,WAAW,CAAC;IAChF,IAAIQ,MAAM,CAACL,IAAI,KAAKkC,eAAe,IAAI7B,MAAM,CAACL,IAAI,KAAKmC,UAAU,EAAE,OAAOrC,cAAc,CAAC0B,YAAY,CAACH,KAAK,EAAEhB,MAAM,CAAC;AACpH,IAAA,IAAIA,MAAM,CAACL,IAAI,KAAKoC,cAAc,EAAE,OAAOtC,cAAc,CAAC4B,WAAW,CAACL,KAAK,EAAEhB,MAAM,CAAC;AACpF,IAAA,OAAOP,cAAc,CAAC8B,WAAW,CAACP,KAAK,EAAEhB,MAAM,CAAC;AACpD,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;AACA;EACI,OAAOmB,YAAYA,CAACH,KAAK,EAAElB,OAAO,GAAG,EAAE,EACvC;AACI,IAAA,OAAO,IAAIkC,cAAc,CAAChB,KAAK,EAAEf,eAAe,CAACP,cAAc,EAAEI,OAAO,EAAEK,UAAU,EAAEX,WAAW,CAAC,CAAC,CAAC0B,YAAY,EAAE;AACtH,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;AACA;EACI,OAAOG,WAAWA,CAACL,KAAK,EAAElB,OAAO,GAAG,EAAE,EACtC;AACI,IAAA,OAAO,IAAIkC,cAAc,CAAChB,KAAK,EAAEf,eAAe,CAACP,cAAc,EAAEI,OAAO,EAAEK,UAAU,EAAEX,WAAW,CAAC,CAAC,CAAC4B,WAAW,EAAE;AACrH,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;AACA;EACI,OAAOG,WAAWA,CAACP,KAAK,EAAElB,OAAO,GAAG,EAAE,EACtC;AACI,IAAA,OAAO,IAAIkC,cAAc,CAAChB,KAAK,EAAEf,eAAe,CAACP,cAAc,EAAEI,OAAO,EAAEK,UAAU,EAAEX,WAAW,CAAC,CAAC,CAAC8B,WAAW,EAAE;AACrH,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;AACA;EACI,OAAOG,OAAOA,CAACT,KAAK,EAAElB,OAAO,GAAG,EAAE,EAClC;AACI,IAAA,OAAO,IAAIkC,cAAc,CAAChB,KAAK,EAAEf,eAAe,CAACP,cAAc,EAAEI,OAAO,EAAEK,UAAU,EAAEX,WAAW,CAAC,CAAC,CAACgC,OAAO,EAAE;AACjH,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;EACI,OAAOS,MAAMA,CAACN,KAAK,EACnB;IACI,OAAOC,WAAW,CAACD,KAAK,CAAC;AAC7B,EAAA;;AAEA;AACJ;AACA;AACI,EAAA,OAAOO,MAAM,GAAGC,MAAM,CAACC,MAAM,CAAC;AAC1BC,IAAAA,IAAI,EAAEC,WAAW;AACjBC,IAAAA,GAAG,EAAET,UAAU;AACfU,IAAAA,QAAQ,EAAEX,eAAe;AACzBY,IAAAA,OAAO,EAAEC,cAAc;AACvBC,IAAAA,OAAO,EAAEZ;AACb,GAAC,CAAC;EACF,OAAO5B,UAAU,GAAGA,UAAU;EAC9B,OAAOyC,EAAE,GAAGC,mBAAmB;EAC/B,OAAOC,UAAU,GAAGX,MAAM,CAACC,MAAM,CAAC,CAACW,mBAAmB,CAAC,CAAC;EACxD,OAAOC,MAAM,GAAGC,gBAAgB;EAChC,OAAOC,OAAO,GAAGC,iBAAiB;EAClC,OAAO3C,IAAI,GAAG2B,MAAM,CAACC,MAAM,CAAC,CAAE,MAAM,CAAE,CAAC;EACvC,OAAOgB,UAAU,GAAGjB,MAAM,CAACC,MAAM,CAAC,CAAE,MAAM,CAAE,CAAC;EAC7C,OAAOiB,UAAU,GAAGlB,MAAM,CAACC,MAAM,CAAC,CAAE,OAAO,CAAE,CAAC;AAC9C,EAAA,OAAOkB,WAAW,GAAGnB,MAAM,CAACC,MAAM,CAAC,CAAEE,WAAW,EAAET,eAAe,EAAEa,cAAc,EAAEX,cAAc,CAAE,CAAC;EACpG,OAAOwB,gBAAgB,GAAGpB,MAAM,CAACC,MAAM,CAAC,CAAEN,UAAU,CAAE,CAAC;EAEvD,OAAOzB,iBAAiBA,CAACL,MAAM,EAC/B;IACI,MAAM;AACFL,MAAAA,IAAI,EAAE6D,KAAK;AACX5D,MAAAA,MAAM,EAAE6D,OAAO;AACfrD,MAAAA,OAAO,EAAEsD,QAAQ;MACjB,GAAGC;AACP,KAAC,GAAG3D,MAAM;AACV,IAAA,OAAO2D,aAAa;AACxB,EAAA;AAEJ;;;;"}