@carbonenginejs/runtime-resource 0.12.1 → 0.13.0

package/dist/formats/wav/index.js

@@ -1,2 +1,2 @@
-export { CjsWavFormat, CjsWavFormat as default } from './CjsWavFormat.js';
-//# sourceMappingURL=index.js.map
+export { CjsWavFormat, CjsWavFormat as default } from './CjsWavFormat.js';
+//# sourceMappingURL=index.js.map

package/dist/formats/webgl/CjsWebglFormat.js

@@ -1,221 +1,199 @@
-import { DEFAULT_VALUES, normalizeValues, readWithValues, inspectWithValues, buildPackage, emitGlslWithOptions, toJsonValue, isCewg, OUTPUT_JSON, OUTPUT_RAW } from './core/helpers.js';
-import { buildEffectPackage } from './core/effectPackage.js';
-
-/**
- * Exposed CarbonEngineJS-facing WebGL format class.
- *
- * Keep this file small and reviewable: CEWG container parsing lives under
- * src/core/cewg (internal parsing machinery, not part of this package's
- * public surface); the DXBC-to-GLSL ES 3.00 emitter lives under
- * src/core/glsl; input/option normalization and the shared read/build/emit
- * paths live in src/core/helpers.js.
- */
-
-const FORMAT_NAME = "CjsWebglFormat";
-
-/**
- * CarbonEngineJS-facing format surface for `.cewg` WebGL shader packages, and
- * a DXBC -> GLSL ES 3.00 emitter for the WebGL2 vertex/pixel/map-style-compute
- * stages ccpwgl targets.
- *
- * The Cjs prefix marks this as a JavaScript format/construction boundary.
- * CEWG is a CarbonEngineJS-invented container format (flat four-byte-tagged
- * chunks: `INFO`/`META`/`GLSL`/...), not a Microsoft or CCP one. `Read`
- * parses a package to plain JSON by default (`emit: "raw"` exposes the live
- * `CewgPackage` instance instead); `Inspect` is a cheap chunk/shader-count
- * summary; `Build` assembles package bytes from chunk payloads; `EmitGlsl`
- * translates one DXBC vertex/pixel/map-style-compute stage to GLSL ES 3.00.
- */
-class CjsWebglFormat {
-  #emit = DEFAULT_VALUES.emit;
-  #source = DEFAULT_VALUES.source;
-
-  /**
-   * 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 {CjsWebglFormat} This format profile.
-   */
-  SetValues(options = {}) {
-    const values = normalizeValues(this.GetValues(), options, FORMAT_NAME);
-    this.#emit = values.emit;
-    this.#source = values.source;
-    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
-    }, options, FORMAT_NAME);
-  }
-
-  /**
-   * Read a CEWG package with this profile's values.
-   *
-   * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input CEWG package bytes.
-   * @param {object} [options] Per-call value overrides.
-   * @returns {object} Plain JSON data, or the raw CewgPackage instance when emit is "raw".
-   */
-  Read(input, options = {}) {
-    return readWithValues(input, this.GetValues(options));
-  }
-
-  /**
-   * Inspect a CEWG package without building the full JSON shape.
-   *
-   * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input CEWG package bytes.
-   * @param {object} [options] Per-call value overrides.
-   * @returns {object} Plain summary data.
-   */
-  Inspect(input, options = {}) {
-    return inspectWithValues(input, this.GetValues(options));
-  }
-
-  /**
-   * Assembles a CEWG package from ordered chunk payloads.
-   *
-   * @param {Array<[string, string|object|Uint8Array|ArrayBuffer|ArrayBufferView]>} chunks Ordered package chunks.
-   * @returns {Uint8Array} Package bytes.
-   */
-  Build(chunks) {
-    return buildPackage(chunks);
-  }
-
-  /**
-   * Translates one DXBC vertex/pixel/map-style-compute stage into GLSL ES 3.00.
-   *
-   * @param {ArrayBuffer|ArrayBufferView|Uint8Array} dxbcBytes DXBC container bytes.
-   * @param {object} [options] Combined ccpwgl-profile/emit options. See {@link CjsWebglFormat.emitGlsl}.
-   * @returns {object} GLSL text plus the IO contract the packaging layer records.
-   */
-  EmitGlsl(dxbcBytes, options = {}) {
-    return emitGlslWithOptions(dxbcBytes, options);
-  }
-
-  /**
-   * Builds a complete CEWG package from compiled Tr2 effect bytes.
-   *
-   * @param {Uint8Array|ArrayBuffer|ArrayBufferView} input Compiled effect bytes.
-   * @param {object} [options] Selection, provenance, and emitter policy.
-   * @returns {object} Package bytes plus inspection and qualification records.
-   */
-  BuildEffect(input, options = {}) {
-    return buildEffectPackage(input, options);
-  }
-
-  /**
-   * Instance JSON-compatible conversion.
-   *
-   * @param {any} value Format output to convert.
-   * @returns {any} Plain JSON-compatible data.
-   */
-  ToJSON(value) {
-    return toJsonValue(value);
-  }
-
-  /**
-   * Static payload sniff. Static methods use camelCase by convention.
-   *
-   * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input Candidate bytes.
-   * @returns {boolean} True when the payload starts with the CEWG magic.
-   */
-  static isCewg(input) {
-    return isCewg(input);
-  }
-
-  /**
-   * Static one-shot read.
-   *
-   * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input CEWG package bytes.
-   * @param {object} [options] Format values.
-   * @returns {object} Plain JSON data, or the raw CewgPackage instance when emit is "raw".
-   */
-  static read(input, options = {}) {
-    return readWithValues(input, normalizeValues(DEFAULT_VALUES, options, FORMAT_NAME));
-  }
-
-  /**
-   * Static one-shot inspection.
-   *
-   * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input CEWG package 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 one-shot package build.
-   *
-   * @param {Array<[string, string|object|Uint8Array|ArrayBuffer|ArrayBufferView]>} chunks Ordered package chunks.
-   * @returns {Uint8Array} Package bytes.
-   */
-  static build(chunks) {
-    return buildPackage(chunks);
-  }
-
-  /**
-   * Static one-shot DXBC-to-GLSL emission.
-   *
-   * @param {ArrayBuffer|ArrayBufferView|Uint8Array} dxbcBytes DXBC container bytes.
-   * @param {object} [options] Combined ccpwgl-profile/emit options: `constantBufferStyle`
-   *   (`"array"` (default) uniform `vec4[]` for ccpwgl's uniform4fv path, or `"std140"`),
-   *   `pixelConstantBufferRemap` (default `{ 0: 7 }`, pixel-stage cb slot renames),
-   *   `samplerName(register, stageName)` (naming function), `vertexStructuredCapacity`
-   *   (default 69, bone-array element capacity), `dataTextureWidth` (default 2048),
-   *   `pairVaryings` (per-call varying zero-fill list), `source` (per-call error-detail name).
-   * @returns {object} GLSL text plus the IO contract the packaging layer records.
-   */
-  static emitGlsl(dxbcBytes, options = {}) {
-    return emitGlslWithOptions(dxbcBytes, options);
-  }
-
-  /**
-   * Static whole-effect CEWG builder.
-   *
-   * @param {Uint8Array|ArrayBuffer|ArrayBufferView} input Compiled effect bytes.
-   * @param {object} [options] Selection, provenance, and emitter policy.
-   * @returns {object} Package bytes plus inspection and qualification records.
-   */
-  static buildEffect(input, options = {}) {
-    return buildEffectPackage(input, options);
-  }
-
-  /**
-   * 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 type = Object.freeze(["shader"]);
-  static mediaTypes = Object.freeze(["shader"]);
-  static inputTypes = Object.freeze(["cewg"]);
-  static outputTypes = Object.freeze([OUTPUT_JSON]);
-  static debugOutputTypes = Object.freeze([OUTPUT_RAW]);
-  static packageVersion = "0.2.0";
-}
-
-export { CjsWebglFormat, CjsWebglFormat as default };
-//# sourceMappingURL=CjsWebglFormat.js.map
+import { DEFAULT_VALUES, normalizeValues, emitGlslWithOptions, toJsonValue, isWebglEffectContainer, OUTPUT_JSON } from './core/helpers.js';
+import { buildEffectPackage } from './core/effectPackage.js';
+import { readGlslEffectContainer } from './core/readGlslEffectContainer.js';
+import { inspectGlslEffectContainer } from './core/inspectGlslEffectContainer.js';
+
+/**
+ * Exposed CarbonEngineJS-facing WebGL format class.
+ *
+ * Keep this file small and reviewable: container decoding lives in
+ * core/readGlslEffectContainer.js, summarising in
+ * core/inspectGlslEffectContainer.js, the DXBC-to-GLSL ES 3.00 emitter under
+ * core/glsl, and option normalization in core/helpers.js.
+ */
+
+const FORMAT_NAME = "CjsWebglFormat";
+
+/**
+ * CarbonEngineJS-facing format surface for `.carbonwebgl` WebGL shader packages, and
+ * a DXBC -> GLSL ES 3.00 emitter for the WebGL2 vertex/pixel/map-style-compute
+ * stages ccpwgl targets.
+ *
+ * The Cjs prefix marks this as a JavaScript format/construction boundary. A
+ * WebGL effect is a stock Carbon effect container whose stored programs are
+ * GLSL ES 3.00 - the same file shape Carbon ships for its own backends, and the
+ * same one WebGPU emits with WGSL. `Read` decodes one into stage and shader
+ * records; `Inspect` is a cheap structural summary; `BuildEffect` translates a
+ * compiled Tr2 effect into one; `EmitGlsl` translates a single DXBC stage.
+ */
+class CjsWebglFormat {
+  #emit = DEFAULT_VALUES.emit;
+  #source = DEFAULT_VALUES.source;
+
+  /**
+   * 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 {CjsWebglFormat} This format profile.
+   */
+  SetValues(options = {}) {
+    const values = normalizeValues(this.GetValues(), options, FORMAT_NAME);
+    this.#emit = values.emit;
+    this.#source = values.source;
+    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
+    }, options, FORMAT_NAME);
+  }
+
+  /**
+   * Decode an effect container into stage and shader records.
+   *
+   * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input Container bytes.
+   * @param {object} [options] Per-call value overrides.
+   * @returns {object} Stage graph in the completeness rules' vocabulary.
+   */
+  Read(input, options = {}) {
+    return readGlslEffectContainer(input, this.GetValues(options));
+  }
+
+  /**
+   * Summarise an effect container without decoding every body's records.
+   *
+   * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input Container bytes.
+   * @param {object} [options] Per-call value overrides.
+   * @returns {object} Plain summary data.
+   */
+  Inspect(input, options = {}) {
+    return inspectGlslEffectContainer(input, this.GetValues(options));
+  }
+
+  /**
+   * Translates one DXBC vertex/pixel/map-style-compute stage into GLSL ES 3.00.
+   *
+   * @param {ArrayBuffer|ArrayBufferView|Uint8Array} dxbcBytes DXBC container bytes.
+   * @param {object} [options] Combined ccpwgl-profile/emit options. See {@link CjsWebglFormat.emitGlsl}.
+   * @returns {object} GLSL text plus the IO contract the packaging layer records.
+   */
+  EmitGlsl(dxbcBytes, options = {}) {
+    return emitGlslWithOptions(dxbcBytes, options);
+  }
+
+  /**
+   * Builds a complete effect container from compiled Tr2 effect bytes.
+   *
+   * @param {Uint8Array|ArrayBuffer|ArrayBufferView} input Compiled effect bytes.
+   * @param {object} [options] Selection, provenance, and emitter policy.
+   * @returns {object} Package bytes plus inspection and qualification records.
+   */
+  BuildEffect(input, options = {}) {
+    return buildEffectPackage(input, options);
+  }
+
+  /**
+   * Instance JSON-compatible conversion.
+   *
+   * @param {any} value Format output to convert.
+   * @returns {any} Plain JSON-compatible data.
+   */
+  ToJSON(value) {
+    return toJsonValue(value);
+  }
+
+  /**
+   * Static payload sniff. Static methods use camelCase by convention.
+   *
+   * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input Candidate bytes.
+   * @returns {boolean} True when the payload has the container shape.
+   */
+  static isWebglEffectContainer(input) {
+    return isWebglEffectContainer(input);
+  }
+
+  /**
+   * Static one-shot container decode.
+   *
+   * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input Container bytes.
+   * @param {object} [options] Format values.
+   * @returns {object} Stage graph in the completeness rules' vocabulary.
+   */
+  static read(input, options = {}) {
+    return readGlslEffectContainer(input, normalizeValues(DEFAULT_VALUES, options, FORMAT_NAME));
+  }
+
+  /**
+   * Static one-shot inspection.
+   *
+   * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input Container bytes.
+   * @param {object} [options] Format values.
+   * @returns {object} Plain summary data.
+   */
+  static inspect(input, options = {}) {
+    return inspectGlslEffectContainer(input, normalizeValues(DEFAULT_VALUES, options, FORMAT_NAME));
+  }
+
+  /**
+   * Static one-shot DXBC-to-GLSL emission.
+   *
+   * @param {ArrayBuffer|ArrayBufferView|Uint8Array} dxbcBytes DXBC container bytes.
+   * @param {object} [options] Combined ccpwgl-profile/emit options: `constantBufferStyle`
+   *   (`"array"` (default) uniform `vec4[]` for ccpwgl's uniform4fv path, or `"std140"`),
+   *   `pixelConstantBufferRemap` (default `{ 0: 7 }`, pixel-stage cb slot renames),
+   *   `samplerName(register, stageName)` (naming function), `vertexStructuredCapacity`
+   *   (default 69, bone-array element capacity), `dataTextureWidth` (default 2048),
+   *   `pairVaryings` (per-call varying zero-fill list), `source` (per-call error-detail name).
+   * @returns {object} GLSL text plus the IO contract the packaging layer records.
+   */
+  static emitGlsl(dxbcBytes, options = {}) {
+    return emitGlslWithOptions(dxbcBytes, options);
+  }
+
+  /**
+   * Static whole-effect container builder.
+   *
+   * @param {Uint8Array|ArrayBuffer|ArrayBufferView} input Compiled effect bytes.
+   * @param {object} [options] Selection, provenance, and emitter policy.
+   * @returns {object} Package bytes plus inspection and qualification records.
+   */
+  static buildEffect(input, options = {}) {
+    return buildEffectPackage(input, options);
+  }
+
+  /**
+   * 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 type = Object.freeze(["shader"]);
+  static mediaTypes = Object.freeze(["shader"]);
+  static inputTypes = Object.freeze(["carbonwebgl"]);
+  static outputTypes = Object.freeze([OUTPUT_JSON]);
+  static packageVersion = "0.2.0";
+}
+
+export { CjsWebglFormat, CjsWebglFormat as default };
+//# sourceMappingURL=CjsWebglFormat.js.map

package/dist/formats/webgl/CjsWebglFormat.js.map

@@ -1 +1 @@
-{"version":3,"file":"CjsWebglFormat.js","sources":["../../../../src/formats/webgl/CjsWebglFormat.js"],"sourcesContent":["/**\n * Exposed CarbonEngineJS-facing WebGL format class.\n *\n * Keep this file small and reviewable: CEWG container parsing lives under\n * src/core/cewg (internal parsing machinery, not part of this package's\n * public surface); the DXBC-to-GLSL ES 3.00 emitter lives under\n * src/core/glsl; input/option normalization and the shared read/build/emit\n * paths live in src/core/helpers.js.\n */\n\nimport {\n    DEFAULT_VALUES,\n    OUTPUT_JSON,\n    OUTPUT_RAW,\n    buildPackage,\n    emitGlslWithOptions,\n    inspectWithValues,\n    isCewg,\n    normalizeValues,\n    readWithValues,\n    toJsonValue\n} from \"./core/helpers.js\";\nimport { buildEffectPackage } from \"./core/effectPackage.js\";\n\nconst FORMAT_NAME = \"CjsWebglFormat\";\n\n/**\n * CarbonEngineJS-facing format surface for `.cewg` WebGL shader packages, and\n * a DXBC -> GLSL ES 3.00 emitter for the WebGL2 vertex/pixel/map-style-compute\n * stages ccpwgl targets.\n *\n * The Cjs prefix marks this as a JavaScript format/construction boundary.\n * CEWG is a CarbonEngineJS-invented container format (flat four-byte-tagged\n * chunks: `INFO`/`META`/`GLSL`/...), not a Microsoft or CCP one. `Read`\n * parses a package to plain JSON by default (`emit: \"raw\"` exposes the live\n * `CewgPackage` instance instead); `Inspect` is a cheap chunk/shader-count\n * summary; `Build` assembles package bytes from chunk payloads; `EmitGlsl`\n * translates one DXBC vertex/pixel/map-style-compute stage to GLSL ES 3.00.\n */\nexport class CjsWebglFormat\n{\n\n    #emit = DEFAULT_VALUES.emit;\n    #source = DEFAULT_VALUES.source;\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 {CjsWebglFormat} 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\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        }, options, FORMAT_NAME);\n    }\n\n    /**\n     * Read a CEWG package with this profile's values.\n     *\n     * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input CEWG package bytes.\n     * @param {object} [options] Per-call value overrides.\n     * @returns {object} Plain JSON data, or the raw CewgPackage instance when emit is \"raw\".\n     */\n    Read(input, options = {})\n    {\n        return readWithValues(input, this.GetValues(options));\n    }\n\n    /**\n     * Inspect a CEWG package without building the full JSON shape.\n     *\n     * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input CEWG package 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     * Assembles a CEWG package from ordered chunk payloads.\n     *\n     * @param {Array<[string, string|object|Uint8Array|ArrayBuffer|ArrayBufferView]>} chunks Ordered package chunks.\n     * @returns {Uint8Array} Package bytes.\n     */\n    Build(chunks)\n    {\n        return buildPackage(chunks);\n    }\n\n    /**\n     * Translates one DXBC vertex/pixel/map-style-compute stage into GLSL ES 3.00.\n     *\n     * @param {ArrayBuffer|ArrayBufferView|Uint8Array} dxbcBytes DXBC container bytes.\n     * @param {object} [options] Combined ccpwgl-profile/emit options. See {@link CjsWebglFormat.emitGlsl}.\n     * @returns {object} GLSL text plus the IO contract the packaging layer records.\n     */\n    EmitGlsl(dxbcBytes, options = {})\n    {\n        return emitGlslWithOptions(dxbcBytes, options);\n    }\n\n    /**\n     * Builds a complete CEWG package from compiled Tr2 effect bytes.\n     *\n     * @param {Uint8Array|ArrayBuffer|ArrayBufferView} input Compiled effect bytes.\n     * @param {object} [options] Selection, provenance, and emitter policy.\n     * @returns {object} Package bytes plus inspection and qualification records.\n     */\n    BuildEffect(input, options = {})\n    {\n        return buildEffectPackage(input, options);\n    }\n\n    /**\n     * Instance JSON-compatible conversion.\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 payload sniff. Static methods use camelCase by convention.\n     *\n     * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input Candidate bytes.\n     * @returns {boolean} True when the payload starts with the CEWG magic.\n     */\n    static isCewg(input)\n    {\n        return isCewg(input);\n    }\n\n    /**\n     * Static one-shot read.\n     *\n     * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input CEWG package bytes.\n     * @param {object} [options] Format values.\n     * @returns {object} Plain JSON data, or the raw CewgPackage instance when emit is \"raw\".\n     */\n    static read(input, options = {})\n    {\n        return readWithValues(input, normalizeValues(DEFAULT_VALUES, options, FORMAT_NAME));\n    }\n\n    /**\n     * Static one-shot inspection.\n     *\n     * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input CEWG package 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 one-shot package build.\n     *\n     * @param {Array<[string, string|object|Uint8Array|ArrayBuffer|ArrayBufferView]>} chunks Ordered package chunks.\n     * @returns {Uint8Array} Package bytes.\n     */\n    static build(chunks)\n    {\n        return buildPackage(chunks);\n    }\n\n    /**\n     * Static one-shot DXBC-to-GLSL emission.\n     *\n     * @param {ArrayBuffer|ArrayBufferView|Uint8Array} dxbcBytes DXBC container bytes.\n     * @param {object} [options] Combined ccpwgl-profile/emit options: `constantBufferStyle`\n     *   (`\"array\"` (default) uniform `vec4[]` for ccpwgl's uniform4fv path, or `\"std140\"`),\n     *   `pixelConstantBufferRemap` (default `{ 0: 7 }`, pixel-stage cb slot renames),\n     *   `samplerName(register, stageName)` (naming function), `vertexStructuredCapacity`\n     *   (default 69, bone-array element capacity), `dataTextureWidth` (default 2048),\n     *   `pairVaryings` (per-call varying zero-fill list), `source` (per-call error-detail name).\n     * @returns {object} GLSL text plus the IO contract the packaging layer records.\n     */\n    static emitGlsl(dxbcBytes, options = {})\n    {\n        return emitGlslWithOptions(dxbcBytes, options);\n    }\n\n    /**\n     * Static whole-effect CEWG builder.\n     *\n     * @param {Uint8Array|ArrayBuffer|ArrayBufferView} input Compiled effect bytes.\n     * @param {object} [options] Selection, provenance, and emitter policy.\n     * @returns {object} Package bytes plus inspection and qualification records.\n     */\n    static buildEffect(input, options = {})\n    {\n        return buildEffectPackage(input, options);\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 type = Object.freeze([ \"shader\" ]);\n    static mediaTypes = Object.freeze([ \"shader\" ]);\n    static inputTypes = Object.freeze([ \"cewg\" ]);\n    static outputTypes = Object.freeze([ OUTPUT_JSON ]);\n    static debugOutputTypes = Object.freeze([ OUTPUT_RAW ]);\n    static packageVersion = \"0.2.0\";\n\n}\n\nexport default CjsWebglFormat;\n"],"names":["FORMAT_NAME","CjsWebglFormat","DEFAULT_VALUES","emit","source","constructor","options","SetValues","values","normalizeValues","GetValues","Read","input","readWithValues","Inspect","inspectWithValues","Build","chunks","buildPackage","EmitGlsl","dxbcBytes","emitGlslWithOptions","BuildEffect","buildEffectPackage","ToJSON","value","toJsonValue","isCewg","read","inspect","build","emitGlsl","buildEffect","toJSON","OUTPUT_JSON","OUTPUT_RAW","type","Object","freeze","mediaTypes","inputTypes","outputTypes","debugOutputTypes","packageVersion"],"mappings":"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"}
+{"version":3,"file":"CjsWebglFormat.js","sources":["../../../../src/formats/webgl/CjsWebglFormat.js"],"sourcesContent":["/**\n * Exposed CarbonEngineJS-facing WebGL format class.\n *\n * Keep this file small and reviewable: container decoding lives in\n * core/readGlslEffectContainer.js, summarising in\n * core/inspectGlslEffectContainer.js, the DXBC-to-GLSL ES 3.00 emitter under\n * core/glsl, and option normalization in core/helpers.js.\n */\n\nimport {\n    DEFAULT_VALUES,\n    OUTPUT_JSON,\n    emitGlslWithOptions,\n    isWebglEffectContainer,\n    normalizeValues,\n    toJsonValue\n} from \"./core/helpers.js\";\nimport { buildEffectPackage } from \"./core/effectPackage.js\";\nimport { readGlslEffectContainer } from \"./core/readGlslEffectContainer.js\";\nimport { inspectGlslEffectContainer } from \"./core/inspectGlslEffectContainer.js\";\n\nconst FORMAT_NAME = \"CjsWebglFormat\";\n\n/**\n * CarbonEngineJS-facing format surface for `.carbonwebgl` WebGL shader packages, and\n * a DXBC -> GLSL ES 3.00 emitter for the WebGL2 vertex/pixel/map-style-compute\n * stages ccpwgl targets.\n *\n * The Cjs prefix marks this as a JavaScript format/construction boundary. A\n * WebGL effect is a stock Carbon effect container whose stored programs are\n * GLSL ES 3.00 - the same file shape Carbon ships for its own backends, and the\n * same one WebGPU emits with WGSL. `Read` decodes one into stage and shader\n * records; `Inspect` is a cheap structural summary; `BuildEffect` translates a\n * compiled Tr2 effect into one; `EmitGlsl` translates a single DXBC stage.\n */\nexport class CjsWebglFormat\n{\n\n    #emit = DEFAULT_VALUES.emit;\n    #source = DEFAULT_VALUES.source;\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 {CjsWebglFormat} 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\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        }, options, FORMAT_NAME);\n    }\n\n    /**\n     * Decode an effect container into stage and shader records.\n     *\n     * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input Container bytes.\n     * @param {object} [options] Per-call value overrides.\n     * @returns {object} Stage graph in the completeness rules' vocabulary.\n     */\n    Read(input, options = {})\n    {\n        return readGlslEffectContainer(input, this.GetValues(options));\n    }\n\n    /**\n     * Summarise an effect container without decoding every body's records.\n     *\n     * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input Container bytes.\n     * @param {object} [options] Per-call value overrides.\n     * @returns {object} Plain summary data.\n     */\n    Inspect(input, options = {})\n    {\n        return inspectGlslEffectContainer(input, this.GetValues(options));\n    }\n\n    /**\n     * Translates one DXBC vertex/pixel/map-style-compute stage into GLSL ES 3.00.\n     *\n     * @param {ArrayBuffer|ArrayBufferView|Uint8Array} dxbcBytes DXBC container bytes.\n     * @param {object} [options] Combined ccpwgl-profile/emit options. See {@link CjsWebglFormat.emitGlsl}.\n     * @returns {object} GLSL text plus the IO contract the packaging layer records.\n     */\n    EmitGlsl(dxbcBytes, options = {})\n    {\n        return emitGlslWithOptions(dxbcBytes, options);\n    }\n\n    /**\n     * Builds a complete effect container from compiled Tr2 effect bytes.\n     *\n     * @param {Uint8Array|ArrayBuffer|ArrayBufferView} input Compiled effect bytes.\n     * @param {object} [options] Selection, provenance, and emitter policy.\n     * @returns {object} Package bytes plus inspection and qualification records.\n     */\n    BuildEffect(input, options = {})\n    {\n        return buildEffectPackage(input, options);\n    }\n\n    /**\n     * Instance JSON-compatible conversion.\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 payload sniff. Static methods use camelCase by convention.\n     *\n     * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input Candidate bytes.\n     * @returns {boolean} True when the payload has the container shape.\n     */\n    static isWebglEffectContainer(input)\n    {\n        return isWebglEffectContainer(input);\n    }\n\n    /**\n     * Static one-shot container decode.\n     *\n     * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input Container bytes.\n     * @param {object} [options] Format values.\n     * @returns {object} Stage graph in the completeness rules' vocabulary.\n     */\n    static read(input, options = {})\n    {\n        return readGlslEffectContainer(input, normalizeValues(DEFAULT_VALUES, options, FORMAT_NAME));\n    }\n\n    /**\n     * Static one-shot inspection.\n     *\n     * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input Container bytes.\n     * @param {object} [options] Format values.\n     * @returns {object} Plain summary data.\n     */\n    static inspect(input, options = {})\n    {\n        return inspectGlslEffectContainer(input, normalizeValues(DEFAULT_VALUES, options, FORMAT_NAME));\n    }\n\n    /**\n     * Static one-shot DXBC-to-GLSL emission.\n     *\n     * @param {ArrayBuffer|ArrayBufferView|Uint8Array} dxbcBytes DXBC container bytes.\n     * @param {object} [options] Combined ccpwgl-profile/emit options: `constantBufferStyle`\n     *   (`\"array\"` (default) uniform `vec4[]` for ccpwgl's uniform4fv path, or `\"std140\"`),\n     *   `pixelConstantBufferRemap` (default `{ 0: 7 }`, pixel-stage cb slot renames),\n     *   `samplerName(register, stageName)` (naming function), `vertexStructuredCapacity`\n     *   (default 69, bone-array element capacity), `dataTextureWidth` (default 2048),\n     *   `pairVaryings` (per-call varying zero-fill list), `source` (per-call error-detail name).\n     * @returns {object} GLSL text plus the IO contract the packaging layer records.\n     */\n    static emitGlsl(dxbcBytes, options = {})\n    {\n        return emitGlslWithOptions(dxbcBytes, options);\n    }\n\n    /**\n     * Static whole-effect container builder.\n     *\n     * @param {Uint8Array|ArrayBuffer|ArrayBufferView} input Compiled effect bytes.\n     * @param {object} [options] Selection, provenance, and emitter policy.\n     * @returns {object} Package bytes plus inspection and qualification records.\n     */\n    static buildEffect(input, options = {})\n    {\n        return buildEffectPackage(input, options);\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 type = Object.freeze([ \"shader\" ]);\n    static mediaTypes = Object.freeze([ \"shader\" ]);\n    static inputTypes = Object.freeze([ \"carbonwebgl\" ]);\n    static outputTypes = Object.freeze([ OUTPUT_JSON ]);\n    static packageVersion = \"0.2.0\";\n\n}\n\nexport default CjsWebglFormat;\n"],"names":["FORMAT_NAME","CjsWebglFormat","DEFAULT_VALUES","emit","source","constructor","options","SetValues","values","normalizeValues","GetValues","Read","input","readGlslEffectContainer","Inspect","inspectGlslEffectContainer","EmitGlsl","dxbcBytes","emitGlslWithOptions","BuildEffect","buildEffectPackage","ToJSON","value","toJsonValue","isWebglEffectContainer","read","inspect","emitGlsl","buildEffect","toJSON","OUTPUT_JSON","type","Object","freeze","mediaTypes","inputTypes","outputTypes","packageVersion"],"mappings":";;;;;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAcA,MAAMA,WAAW,GAAG,gBAAgB;;AAEpC;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,MAAMC,cAAc,CAC3B;AAEI,EAAA,KAAK,GAAGC,cAAc,CAACC,IAAI;AAC3B,EAAA,OAAO,GAAGD,cAAc,CAACE,MAAM;;AAE/B;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,EAAEN,WAAW,CAAC;AAEtE,IAAA,IAAI,CAAC,KAAK,GAAGQ,MAAM,CAACL,IAAI;AACxB,IAAA,IAAI,CAAC,OAAO,GAAGK,MAAM,CAACJ,MAAM;AAE5B,IAAA,OAAO,IAAI;AACf,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;AACIM,EAAAA,SAASA,CAACJ,OAAO,GAAG,EAAE,EACtB;AACI,IAAA,OAAOG,eAAe,CAAC;AACnBN,MAAAA,IAAI,EAAE,IAAI,CAAC,KAAK;MAChBC,MAAM,EAAE,IAAI,CAAC;AACjB,KAAC,EAAEE,OAAO,EAAEN,WAAW,CAAC;AAC5B,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;AACA;AACIW,EAAAA,IAAIA,CAACC,KAAK,EAAEN,OAAO,GAAG,EAAE,EACxB;IACI,OAAOO,uBAAuB,CAACD,KAAK,EAAE,IAAI,CAACF,SAAS,CAACJ,OAAO,CAAC,CAAC;AAClE,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;AACA;AACIQ,EAAAA,OAAOA,CAACF,KAAK,EAAEN,OAAO,GAAG,EAAE,EAC3B;IACI,OAAOS,0BAA0B,CAACH,KAAK,EAAE,IAAI,CAACF,SAAS,CAACJ,OAAO,CAAC,CAAC;AACrE,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;AACA;AACIU,EAAAA,QAAQA,CAACC,SAAS,EAAEX,OAAO,GAAG,EAAE,EAChC;AACI,IAAA,OAAOY,mBAAmB,CAACD,SAAS,EAAEX,OAAO,CAAC;AAClD,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;AACA;AACIa,EAAAA,WAAWA,CAACP,KAAK,EAAEN,OAAO,GAAG,EAAE,EAC/B;AACI,IAAA,OAAOc,kBAAkB,CAACR,KAAK,EAAEN,OAAO,CAAC;AAC7C,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;EACIe,MAAMA,CAACC,KAAK,EACZ;IACI,OAAOC,WAAW,CAACD,KAAK,CAAC;AAC7B,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;EACI,OAAOE,sBAAsBA,CAACZ,KAAK,EACnC;IACI,OAAOY,sBAAsB,CAACZ,KAAK,CAAC;AACxC,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;AACA;EACI,OAAOa,IAAIA,CAACb,KAAK,EAAEN,OAAO,GAAG,EAAE,EAC/B;AACI,IAAA,OAAOO,uBAAuB,CAACD,KAAK,EAAEH,eAAe,CAACP,cAAc,EAAEI,OAAO,EAAEN,WAAW,CAAC,CAAC;AAChG,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;AACA;EACI,OAAO0B,OAAOA,CAACd,KAAK,EAAEN,OAAO,GAAG,EAAE,EAClC;AACI,IAAA,OAAOS,0BAA0B,CAACH,KAAK,EAAEH,eAAe,CAACP,cAAc,EAAEI,OAAO,EAAEN,WAAW,CAAC,CAAC;AACnG,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;EACI,OAAO2B,QAAQA,CAACV,SAAS,EAAEX,OAAO,GAAG,EAAE,EACvC;AACI,IAAA,OAAOY,mBAAmB,CAACD,SAAS,EAAEX,OAAO,CAAC;AAClD,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;AACA;EACI,OAAOsB,WAAWA,CAAChB,KAAK,EAAEN,OAAO,GAAG,EAAE,EACtC;AACI,IAAA,OAAOc,kBAAkB,CAACR,KAAK,EAAEN,OAAO,CAAC;AAC7C,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;EACI,OAAOuB,MAAMA,CAACP,KAAK,EACnB;IACI,OAAOC,WAAW,CAACD,KAAK,CAAC;AAC7B,EAAA;EAEA,OAAOQ,WAAW,GAAGA,WAAW;EAChC,OAAOC,IAAI,GAAGC,MAAM,CAACC,MAAM,CAAC,CAAE,QAAQ,CAAE,CAAC;EACzC,OAAOC,UAAU,GAAGF,MAAM,CAACC,MAAM,CAAC,CAAE,QAAQ,CAAE,CAAC;EAC/C,OAAOE,UAAU,GAAGH,MAAM,CAACC,MAAM,CAAC,CAAE,aAAa,CAAE,CAAC;EACpD,OAAOG,WAAW,GAAGJ,MAAM,CAACC,MAAM,CAAC,CAAEH,WAAW,CAAE,CAAC;EACnD,OAAOO,cAAc,GAAG,OAAO;AAEnC;;;;"}

package/dist/formats/webgl/core/buildGlslEffectContainer.js

@@ -0,0 +1,70 @@
+import { buildCarbonEffectContainer } from '../../../format/carbonEffect/buildCarbonEffectContainer.js';
+import { writeGlslBackendBlock } from './glslBackendBlock.js';
+
+/**
+ * The WebGL 2 backend adapter for the shared Carbon container builder.
+ *
+ * The record layout, the permutation walk and the description mapping are shared
+ * with WebGPU and live in `format/carbonEffect/buildCarbonEffectContainer.js`.
+ * What remains here is the two backend-varying decisions: a program is GLSL ES
+ * 3.00 text, and a pass's trailing block is the GLSL lowering data.
+ *
+ * There is no entry-point assertion to make. GLSL's entry point is `main` by
+ * language rule rather than by our emitter's choice, so unlike WGSL there is
+ * nothing a future lowerer could change.
+ */
+
+/**
+ * Encodes one GLSL stage program.
+ *
+ * @param {object} shader Translated shader record.
+ * @returns {Uint8Array} Program bytes.
+ */
+function encodeProgram(shader) {
+  return new TextEncoder().encode(shader.code);
+}
+
+/**
+ * Builds the per-pass backend block for one pass of one translated body.
+ *
+ * A pass whose stages added no lowering data emits no block at all rather than
+ * an empty one, so the description ends where Carbon's would and the optional
+ * block stays genuinely optional.
+ *
+ * @param {object} unit Pass translation unit.
+ * @param {string} passKey Enclosing pass key.
+ * @returns {Uint8Array|null} Block bytes, or null when the pass has none.
+ */
+function encodeBackendBlock(unit, passKey) {
+  const stages = unit.block;
+  const transforms = (unit.resourceTransforms ?? []).filter(transform => transform.layoutKey === passKey);
+  if (!stages && !transforms.length) return null;
+  return writeGlslBackendBlock({
+    stages: stages ?? {},
+    transforms
+  });
+}
+
+/** The WebGL encoders, as the shared builder's backend argument. */
+const GLSL_CONTAINER_BACKEND = Object.freeze({
+  encodeProgram,
+  encodeBackendBlock
+});
+
+/**
+ * Builds the complete WebGL 2 effect container.
+ *
+ * @param {object} effectRes Loaded version-15 `Tr2EffectRes`.
+ * @param {object} permutationGraph Validated `PGRF` document.
+ * @param {object} backendBodySet Translated GLSL bodies.
+ * @param {object} [options] Container options.
+ * @param {number[]|Uint8Array} [options.compilerVersion] Four version bytes.
+ * @param {string} [options.sourceHash] 32 ASCII hash characters.
+ * @returns {{bytes:Uint8Array, permutationCount:number, bodyCount:number}} Container and its body accounting.
+ */
+function buildGlslEffectContainer(effectRes, permutationGraph, backendBodySet, options = {}) {
+  return buildCarbonEffectContainer(effectRes, permutationGraph, backendBodySet, GLSL_CONTAINER_BACKEND, options);
+}
+
+export { GLSL_CONTAINER_BACKEND, buildGlslEffectContainer };
+//# sourceMappingURL=buildGlslEffectContainer.js.map

package/dist/formats/webgl/core/buildGlslEffectContainer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildGlslEffectContainer.js","sources":["../../../../../src/formats/webgl/core/buildGlslEffectContainer.js"],"sourcesContent":["import {\n    buildCarbonEffectContainer\n} from \"../../../format/carbonEffect/buildCarbonEffectContainer.js\";\nimport { writeGlslBackendBlock } from \"./glslBackendBlock.js\";\n\n/**\n * The WebGL 2 backend adapter for the shared Carbon container builder.\n *\n * The record layout, the permutation walk and the description mapping are shared\n * with WebGPU and live in `format/carbonEffect/buildCarbonEffectContainer.js`.\n * What remains here is the two backend-varying decisions: a program is GLSL ES\n * 3.00 text, and a pass's trailing block is the GLSL lowering data.\n *\n * There is no entry-point assertion to make. GLSL's entry point is `main` by\n * language rule rather than by our emitter's choice, so unlike WGSL there is\n * nothing a future lowerer could change.\n */\n\n/**\n * Encodes one GLSL stage program.\n *\n * @param {object} shader Translated shader record.\n * @returns {Uint8Array} Program bytes.\n */\nfunction encodeProgram(shader)\n{\n    return new TextEncoder().encode(shader.code);\n}\n\n/**\n * Builds the per-pass backend block for one pass of one translated body.\n *\n * A pass whose stages added no lowering data emits no block at all rather than\n * an empty one, so the description ends where Carbon's would and the optional\n * block stays genuinely optional.\n *\n * @param {object} unit Pass translation unit.\n * @param {string} passKey Enclosing pass key.\n * @returns {Uint8Array|null} Block bytes, or null when the pass has none.\n */\nfunction encodeBackendBlock(unit, passKey)\n{\n    const stages = unit.block;\n    const transforms = (unit.resourceTransforms ?? [])\n        .filter((transform) => transform.layoutKey === passKey);\n\n    if (!stages && !transforms.length) return null;\n\n    return writeGlslBackendBlock({ stages: stages ?? {}, transforms });\n}\n\n/** The WebGL encoders, as the shared builder's backend argument. */\nexport const GLSL_CONTAINER_BACKEND = Object.freeze({ encodeProgram, encodeBackendBlock });\n\n/**\n * Builds the complete WebGL 2 effect container.\n *\n * @param {object} effectRes Loaded version-15 `Tr2EffectRes`.\n * @param {object} permutationGraph Validated `PGRF` document.\n * @param {object} backendBodySet Translated GLSL bodies.\n * @param {object} [options] Container options.\n * @param {number[]|Uint8Array} [options.compilerVersion] Four version bytes.\n * @param {string} [options.sourceHash] 32 ASCII hash characters.\n * @returns {{bytes:Uint8Array, permutationCount:number, bodyCount:number}} Container and its body accounting.\n */\nexport function buildGlslEffectContainer(\n    effectRes,\n    permutationGraph,\n    backendBodySet,\n    options = {}\n)\n{\n    return buildCarbonEffectContainer(\n        effectRes,\n        permutationGraph,\n        backendBodySet,\n        GLSL_CONTAINER_BACKEND,\n        options\n    );\n}\n\nexport default buildGlslEffectContainer;\n"],"names":["encodeProgram","shader","TextEncoder","encode","code","encodeBackendBlock","unit","passKey","stages","block","transforms","resourceTransforms","filter","transform","layoutKey","length","writeGlslBackendBlock","GLSL_CONTAINER_BACKEND","Object","freeze","buildGlslEffectContainer","effectRes","permutationGraph","backendBodySet","options","buildCarbonEffectContainer"],"mappings":";;;AAKA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA,SAASA,aAAaA,CAACC,MAAM,EAC7B;EACI,OAAO,IAAIC,WAAW,EAAE,CAACC,MAAM,CAACF,MAAM,CAACG,IAAI,CAAC;AAChD;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,SAASC,kBAAkBA,CAACC,IAAI,EAAEC,OAAO,EACzC;AACI,EAAA,MAAMC,MAAM,GAAGF,IAAI,CAACG,KAAK;AACzB,EAAA,MAAMC,UAAU,GAAG,CAACJ,IAAI,CAACK,kBAAkB,IAAI,EAAE,EAC5CC,MAAM,CAAEC,SAAS,IAAKA,SAAS,CAACC,SAAS,KAAKP,OAAO,CAAC;EAE3D,IAAI,CAACC,MAAM,IAAI,CAACE,UAAU,CAACK,MAAM,EAAE,OAAO,IAAI;AAE9C,EAAA,OAAOC,qBAAqB,CAAC;AAAER,IAAAA,MAAM,EAAEA,MAAM,IAAI,EAAE;AAAEE,IAAAA;AAAW,GAAC,CAAC;AACtE;;AAEA;MACaO,sBAAsB,GAAGC,MAAM,CAACC,MAAM,CAAC;EAAEnB,aAAa;AAAEK,EAAAA;AAAmB,CAAC;;AAEzF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASe,wBAAwBA,CACpCC,SAAS,EACTC,gBAAgB,EAChBC,cAAc,EACdC,OAAO,GAAG,EAAE,EAEhB;EACI,OAAOC,0BAA0B,CAC7BJ,SAAS,EACTC,gBAAgB,EAChBC,cAAc,EACdN,sBAAsB,EACtBO,OACJ,CAAC;AACL;;;;"}