@carbonenginejs/runtime-resource 0.13.0 → 0.15.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,199 +1,199 @@
-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
+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/core/buildGlslEffectContainer.js

@@ -1,70 +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
+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