@aura3d/rendering 3.0.1 → 4.0.0

package/dist/program/ProgramFeatures.js

@@ -0,0 +1,95 @@
+/**
+ * `ProgramFeatures` helpers (PRD-01 §6.4) — canonical feature records.
+ *
+ * `computeProgramKey` only sorts keys: `{ maps: {} }` and a record missing
+ * `maps` produce different keys for the same draw. `normalizeProgramFeatures`
+ * fills every field of the frozen C-02 record with canonical defaults and
+ * strips `undefined` leaves, so records built anywhere (materials, depth
+ * passes, warmup) key identically.
+ */
+export const DEFAULT_SHADOW_RECEIVE = {
+    cascades: 0,
+    pcfTaps: 1,
+    localShadows: 0,
+    contact: false
+};
+export const DEFAULT_LIGHTS = {
+    dir: 0,
+    point: 0,
+    spot: 0,
+    rect: 0,
+    clustered: false,
+    hemisphere: false
+};
+export const DEFAULT_PROGRAM_FEATURES = {
+    pass: "forward",
+    target: "glsl300es",
+    lighting: "unlit",
+    maps: {},
+    extensions: [],
+    alphaMode: "opaque",
+    doubleSided: false,
+    vertexColors: false,
+    flatShading: false,
+    lights: DEFAULT_LIGHTS,
+    shadows: DEFAULT_SHADOW_RECEIVE,
+    environment: "none",
+    fog: "none",
+    diffuseModel: "lambert",
+    specularAntialiasing: false,
+    backgroundCoverage: false,
+    features: {}
+};
+function dropUndefined(value) {
+    const out = {};
+    for (const [k, v] of Object.entries(value)) {
+        if (v !== undefined)
+            out[k] = v;
+    }
+    return out;
+}
+/** Fill every ProgramFeatures field with canonical defaults; strips undefined leaves. */
+export function normalizeProgramFeatures(features) {
+    const f = features ?? {};
+    const lights = dropUndefined({ ...DEFAULT_LIGHTS, ...(f.lights ?? {}) });
+    const shadows = dropUndefined({ ...DEFAULT_SHADOW_RECEIVE, ...(f.shadows ?? {}) });
+    return {
+        pass: f.pass ?? "forward",
+        target: f.target ?? "glsl300es",
+        lighting: f.lighting ?? "unlit",
+        maps: dropUndefined({ ...(f.maps ?? {}) }),
+        extensions: f.extensions ?? [],
+        alphaMode: f.alphaMode ?? "opaque",
+        doubleSided: f.doubleSided ?? false,
+        vertexColors: f.vertexColors ?? false,
+        flatShading: f.flatShading ?? false,
+        skinning: f.skinning,
+        morph: f.morph,
+        instancing: f.instancing,
+        drawId: f.drawId,
+        lights,
+        shadows,
+        environment: f.environment ?? "none",
+        fog: f.fog ?? "none",
+        diffuseModel: f.diffuseModel ?? "lambert",
+        specularAntialiasing: f.specularAntialiasing ?? false,
+        backgroundCoverage: f.backgroundCoverage ?? false,
+        features: { ...(f.features ?? {}) }
+    };
+}
+/** The light-count keys that bound the unrolled `fragment:lights` loop. */
+export function totalLightCount(lights) {
+    return lights.dir + lights.point + lights.spot + lights.rect;
+}
+/** Texture map feature bits → define names, in frozen map order. */
+export const MAP_DEFINES = [
+    ["baseColor", "USE_BASE_COLOR_MAP"],
+    ["normal", "USE_NORMAL_MAP"],
+    ["metallicRoughness", "USE_METALLIC_ROUGHNESS_MAP"],
+    ["occlusion", "USE_OCCLUSION_MAP"],
+    ["emissive", "USE_EMISSIVE_MAP"]
+];
+export function mapUvSet(slot) {
+    return slot?.uvSet ?? 0;
+}
+//# sourceMappingURL=ProgramFeatures.js.map

package/dist/program/ProgramFeatures.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProgramFeatures.js","sourceRoot":"","sources":["../../../../../packages/rendering/src/program/ProgramFeatures.ts"],"names":[],"mappings":"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"}

package/dist/program/ProgramGenerator.d.ts

@@ -0,0 +1,60 @@
+/**
+ * `program/ProgramGenerator.ts` (PRD-01 §6.4, §8.1, §8.5, §8.7) — C-02 real impl.
+ *
+ * Assembles GLSL ES 3.00 vertex+fragment sources from a normalized
+ * `ProgramFeatures` record:
+ *   `#version 300 es`, precision, `#define` block, lane-01 chunks
+ *   (common/colorspace/brdf/normal/instancing/alpha/lights_legacy/
+ *   indirect_default/fog_default/depth) with registered C-02 chunks spliced
+ *   at the hook points in `(feature.order, feature.id)` order.
+ *
+ * Splice convention (pars/call split, T0-05): a ShaderFeature's `chunks[i]`
+ * lands at `hooks[min(i, hooks.length - 1)]`.
+ *   - Declaration hooks (`vertex:pars`, `vertex:deform`, `fragment:pars`) emit
+ *     the chunk at global scope before `main`.
+ *   - Body hooks emit the chunk (a *call* chunk: statements only) inside
+ *     `main`; its `requires` closure is emitted at global scope.
+ *   - `requires` are resolved requires-first (depth-first post-order), each
+ *     chunk at most once per stage. `brdf`/`common` name the built-in lane-01
+ *     chunks. A missing or cyclic `requires` throws (`SHADER_CHUNK_MISSING` /
+ *     `SHADER_CHUNK_CYCLE`), which the cache reports as C-36
+ *     `program-compile-failed`. Missing chunks are never skipped silently.
+ *   - `fragment:indirect` contributions are appended after the default
+ *     indirect body (ambient + env); every other body hook that a feature
+ *     claims replaces that hook's default. One exception (E3 stage-2b):
+ *     under A3D_QR_COMPILER ∧ A3D_QR_LIGHTING the `prd02.ibl` contribution
+ *     REPLACES the default indirect body instead of appending to it.
+ * The `vertex:deform` call is canonical: the generator emits
+ * `a3dDeform(pos, nrm, tan)` when a registered feature claims the hook and
+ * the C-18 passthrough otherwise (CONTRACTS §8.5).
+ *
+ * C-03 lobes (lit forward programs): `chunks.pars` is emitted at global scope,
+ * `chunks.fragment` is a call chunk at `fragment:material` (after
+ * `PhysicalMaterial material` exists), and `chunks.ibl` is a call chunk
+ * appended to `fragment:indirect`. A record's extension matches a lobe by
+ * `lobe.id` or `lobe.glTFExtension`. Each active lobe defines
+ * `A3D_LOBE_<ID>` (plus `A3D_LOBE_<ID>_<BIT>` for truthy bits) so chunk
+ * guards follow the record.
+ *
+ * Unknown extensions (`features.extensions` with no matching C-03 lobe in
+ * `materialLobes`) record `extension-lobe-pending` (`ownerPrd: 4`) into
+ * `programDegradationLog` and through the optional sink.
+ */
+import type { QrFlags } from "../contracts/core.js";
+import type { ProgramFeatures, GeneratedProgram } from "../contracts/program.js";
+export declare const GENERATED_PROGRAM_MARKER = "a3d-generated-program";
+export interface ProgramDegradation {
+    readonly code: "extension-lobe-pending" | "program-compile-failed";
+    readonly message: string;
+    readonly ownerPrd?: number;
+}
+/** Process-local log of generator-recorded degradations (drained by diagnostics/tests). */
+export declare const programDegradationLog: ProgramDegradation[];
+export interface GenerateProgramOptions {
+    readonly flags?: QrFlags;
+    readonly onDegradation?: (degradation: ProgramDegradation) => void;
+}
+export declare function registerProgramWgslEmitter(emitter: (features: ProgramFeatures) => GeneratedProgram): void;
+/** Real C-02 program generation (PRD-01 §6.4). Flags may be omitted: feature bits then resolve no contributors. */
+export declare function generateProgramImpl(features: ProgramFeatures, options?: GenerateProgramOptions): GeneratedProgram;
+//# sourceMappingURL=ProgramGenerator.d.ts.map

package/dist/program/ProgramGenerator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProgramGenerator.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/program/ProgramGenerator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,KAAK,EAAkC,eAAe,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAiB9G,eAAO,MAAM,wBAAwB,0BAA0B,CAAC;AAEhE,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,wBAAwB,GAAG,wBAAwB,CAAC;IACnE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,2FAA2F;AAC3F,eAAO,MAAM,qBAAqB,EAAE,kBAAkB,EAAO,CAAC;AAE9D,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC,WAAW,EAAE,kBAAkB,KAAK,IAAI,CAAC;CACpE;AAID,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,eAAe,KAAK,gBAAgB,GAAG,IAAI,CAEzG;AAmoBD,mHAAmH;AACnH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,eAAe,EAAE,OAAO,GAAE,sBAA2B,GAAG,gBAAgB,CAqCrH"}