@aura3d/engine 3.0.0 → 4.0.0

package/dist/rendering/shaders/deform/forwardFeature.js

@@ -0,0 +1,300 @@
+/**
+ * PRD-06 T2.2 — the forward `prd06.deform` C-02 `ShaderFeature`
+ * (PRD-06 §269, §1145, §1222).
+ *
+ * `select` produces the deform program key per item:
+ *   `skin4` | `skin8`            — joint-palette skinning (4/8 influences)
+ *   `morph<B>[n][t]`             — §8.2 bucket {4,8,16,32}, `n`/`t` when the
+ *                                  packed set carries normal/tangent deltas
+ *   `|k<K>`                      — `A3D_MORPH_MAX_ACTIVE` (C-27 tier cap)
+ * Combined with `|` (e.g. `skin8|morph16n|k32`); a rigid item returns
+ * `undefined` so it keeps the base program.
+ *
+ * `defines` emits `A3D_SKINNING`, `A3D_MORPH` (bucket), `A3D_MORPH_NORMALS`,
+ * `A3D_MORPH_TANGENTS`, `A3D_HAS_TANGENT` and `A3D_MORPH_MAX_ACTIVE` parsed
+ * back out of the key. A `true` stamp (the pre-select MaterialFeatures record)
+ * contributes the chunks/hook with no defines — a compile-clean passthrough
+ * until the per-item select consumer lands (qr-request Q-01-4).
+ *
+ * `bindUniforms` binds the shared bone-texture palette (`bindBoneTexture`,
+ * same cache entry as the forward/draw-time bind so depth and velocity see
+ * this frame's upload) plus the morph array texture and the packed top-K
+ * active list when the item carries morphs.
+ *
+ * Draw-time consumption note: nothing in the forward path calls
+ * `select`/`bindUniforms` per item yet (Q-01-4). The lane-side consumer is
+ * `applyGpuMorphUniforms` in `forward/Deform.ts`, which delegates to
+ * `bindPrd06MorphTextureUniforms` when the bound program declares
+ * `u_morphTexture` — its K comes from the program's own reflected
+ * `u_morphActiveIndex4` array bound, which equals the `A3D_MORPH_MAX_ACTIVE`
+ * it was compiled with.
+ */
+import { registerShaderFeature } from "../../contracts/program.js";
+import { TextureBinding } from "../../TextureBinding.js";
+import { bindBoneTexture } from "../../SkinningUniforms.js";
+import { morphTargetBucket } from "../../resources/MorphTargetTexture.js";
+/** §970: morph bits join the key only under the GPU-morph sub-flag. */
+const GPU_MORPH_FLAG = "A3D_QR_ANIMATION_GPU_MORPH";
+/**
+ * C-27 active-morph caps (§285/§699): 8 Low / 16 Medium / 32 High / 64 Ultra.
+ * `AuraQualityTierSettings` carries no tier name, so `maxLightsPerPixel`
+ * (4/8/16/32, unique per stock tier) discriminates; custom overrides keep the
+ * nearest lower cap. Q-11-2 allows PRD-06 constants keyed by tier until the
+ * C-27 contract lands.
+ */
+export function morphMaxActiveForTier(tier) {
+    const d = tier.maxLightsPerPixel;
+    return d >= 32 ? 64 : d >= 16 ? 32 : d >= 8 ? 16 : 8;
+}
+/**
+ * The morph segment of the select key (`morph<B>[n][t]|k<K>`), or null when
+ * the item carries no morph data or the GPU-morph flag is off (CPU morph then
+ * stays responsible — T2.3).
+ */
+function selectMorphSegment(item, tier, flags) {
+    const targets = item.morphTargets;
+    if (!targets || targets.length === 0)
+        return null;
+    if (!flags.on(GPU_MORPH_FLAG))
+        return null;
+    const bucket = morphTargetBucket(Math.min(targets.length, 32));
+    if (!bucket)
+        return null;
+    const hasNormals = targets.some((t) => (t.normals?.length ?? 0) > 0);
+    const hasTangents = targets.some((t) => (t.tangents?.length ?? 0) > 0);
+    return `morph${bucket}${hasNormals ? "n" : ""}${hasTangents ? "t" : ""}|k${morphMaxActiveForTier(tier)}`;
+}
+/** The `prd06.deform` feature key for an item, or undefined when rigid. */
+export function selectPrd06DeformValue(item, pass, tier, flags) {
+    if (pass !== "forward")
+        return undefined;
+    const parts = [];
+    const skinning = item.skinning;
+    if (skinning)
+        parts.push(skinning.extraInfluences ? "skin8" : "skin4");
+    const morph = selectMorphSegment(item, tier, flags);
+    if (morph)
+        parts.push(morph);
+    return parts.length > 0 ? parts.join("|") : undefined;
+}
+/** Parse a select-produced key back into its parts. Unknown segments are ignored. */
+export function parsePrd06DeformKey(value) {
+    let influences = null;
+    let morphBucket = null;
+    let morphNormals = false;
+    let morphTangents = false;
+    let morphMaxActive = null;
+    for (const segment of value.split("|")) {
+        if (segment === "skin4" || segment === "skin8") {
+            influences = segment === "skin8" ? 8 : 4;
+            continue;
+        }
+        const morph = /^morph(4|8|16|32)(n?)(t?)$/.exec(segment);
+        if (morph) {
+            morphBucket = Number(morph[1]);
+            morphNormals = morph[2] === "n";
+            morphTangents = morph[3] === "t";
+            continue;
+        }
+        const k = /^k(\d+)$/.exec(segment);
+        if (k)
+            morphMaxActive = Number(k[1]);
+    }
+    return { influences, morphBucket, morphNormals, morphTangents, morphMaxActive };
+}
+/** `defines` for a select-produced key; `true` (pre-select stamp) contributes no defines. */
+export function prd06DeformDefines(value) {
+    if (typeof value !== "string")
+        return {};
+    const key = parsePrd06DeformKey(value);
+    const defines = {};
+    if (key.influences)
+        defines.A3D_SKINNING = key.influences;
+    if (key.morphBucket) {
+        defines.A3D_MORPH = key.morphBucket;
+        defines.A3D_MORPH_MAX_ACTIVE = key.morphMaxActive ?? 32;
+        if (key.morphNormals)
+            defines.A3D_MORPH_NORMALS = true;
+        if (key.morphTangents) {
+            defines.A3D_MORPH_TANGENTS = true;
+            defines.A3D_HAS_TANGENT = true;
+        }
+    }
+    return defines;
+}
+/**
+ * Conservative bind-time texture limits. `MorphTextureLimits` normally derives
+ * from tier device caps; at uniform-bind time only the compiled program is
+ * visible, so the WebGL2 baseline-safe `{4096, 32}` applies (the builder
+ * falls back to CPU when exceeded — `applyGpuMorphUniforms` then reports the
+ * CPU path). 32 layers is the §8.2 bucket ceiling.
+ */
+export const PRD06_MORPH_TEXTURE_LIMITS = { maxTextureSize: 4096, maxArrayLayers: 32 };
+// `var` + lazy init: the lane barrel → Deform → forwardFeature import cycle
+// (forwardFeature → SkinningUniforms → ForwardPass → Deform → lanes/prd06)
+// can call `createPrd06DeformFeature` before this module body finishes —
+// `let`/`const` bindings would sit in TDZ, and an `= null` initializer would
+// clobber the value registration already assigned. Uninitialized `var` hoists
+// safely in both cases.
+var morphTextureBuilder;
+var morphTextureCache;
+var liveMorphTextures;
+/** WeakMap: geometry → last-built result. Rebuilds only when the targets array identity changes. */
+function morphTextureFor(item) {
+    const targets = item.morphTargets;
+    if (!targets || targets.length === 0 || !morphTextureBuilder)
+        return undefined;
+    morphTextureCache ??= new WeakMap();
+    const cached = morphTextureCache.get(item.geometry);
+    if (cached && cached.targets === targets)
+        return cached.result;
+    if (cached !== undefined && "texture" in cached.result) {
+        cached.result.texture.dispose();
+        liveMorphTextures?.delete(cached.result.texture);
+    }
+    const result = morphTextureBuilder(item.geometry, targets, PRD06_MORPH_TEXTURE_LIMITS);
+    morphTextureCache.set(item.geometry, { targets, result });
+    if ("texture" in result) {
+        liveMorphTextures ??= new Set();
+        liveMorphTextures.add(result.texture);
+    }
+    return result;
+}
+/**
+ * §16 S3 — public acquire seam: build-or-return the §8.2 morph array texture
+ * for an item, exactly the call the feature's `bindUniforms` makes per frame.
+ * Exported so teardown paths and the lifecycle spec's acquisition step use
+ * the same cache the feature binds from (no second morph-texture source).
+ */
+export function ensureMorphTargetTexture(item) {
+    return morphTextureFor(item);
+}
+/**
+ * §16 S3 — actor teardown frees its morph array texture: the cached
+ * `Texture` is disposed (dropping it from the WebGL2 live-texture count) and
+ * the geometry's cache entry cleared so a later load rebuilds fresh. Mirrors
+ * `releasePalette`'s seam — `GLTFSceneAnimationRuntime.dispose` and the
+ * `prd06.animation` actor-extension dispose call it per renderable geometry.
+ */
+export function releaseMorphTargetTexture(geometry) {
+    const cached = morphTextureCache?.get(geometry);
+    if (cached === undefined)
+        return;
+    if ("texture" in cached.result) {
+        cached.result.texture.dispose();
+        liveMorphTextures?.delete(cached.result.texture);
+    }
+    morphTextureCache?.delete(geometry);
+}
+/** §16 S3 counter — live (non-disposed) morph array textures + bytes. */
+export function morphTextureDiagnostics() {
+    let bytes = 0;
+    let textures = 0;
+    for (const texture of liveMorphTextures ?? []) {
+        if (texture.disposed)
+            continue;
+        textures += 1;
+        bytes += texture.byteLength;
+    }
+    return { textures, bytes };
+}
+/**
+ * §8.2 top-K packing: non-zero weights sorted by |w| desc, first `maxActive`,
+ * padded to a multiple of 4 with index 0 / weight 0. Returns the packed index
+ * and weight arrays (`maxActive` floats each — K/4 vec4 slots on the wire).
+ */
+export function packActiveMorphs(weights, targetCount, maxActive, previousWeights) {
+    const order = [];
+    for (let i = 0; i < targetCount; i += 1) {
+        if (Math.abs(weights[i] ?? 0) > 0)
+            order.push(i);
+    }
+    order.sort((a, b) => Math.abs(weights[b] ?? 0) - Math.abs(weights[a] ?? 0));
+    const count = Math.min(order.length, maxActive);
+    const padded = Math.ceil(Math.max(count, 4) / 4) * 4;
+    const size = Math.min(padded, Math.ceil(maxActive / 4) * 4);
+    const indices = new Float32Array(size);
+    const current = new Float32Array(size);
+    const previous = previousWeights ? new Float32Array(size) : null;
+    for (let k = 0; k < count; k += 1) {
+        const target = order[k];
+        indices[k] = target;
+        current[k] = weights[target] ?? 0;
+        if (previous && previousWeights)
+            previous[k] = previousWeights[target] ?? 0;
+    }
+    return { indices, current, previous, count };
+}
+/**
+ * Bind the §8.2 morph uniforms onto `uniforms`. Returns false when the item
+ * has no morphs, no builder is registered, or the texture build fell back to
+ * CPU (caller then takes the CPU path). `maxActive` is the compiled
+ * `A3D_MORPH_MAX_ACTIVE` — the program's own `u_morphActiveIndex4` array bound.
+ */
+export function bindPrd06MorphTextureUniforms(item, shader, uniforms) {
+    if (!shader.reflection.uniforms.has("u_morphTexture"))
+        return false;
+    if (!item.morphTargets || !item.morphWeights)
+        return false;
+    const result = morphTextureFor(item);
+    if (!result || "fallback" in result)
+        return false;
+    const arrayBound = shader.reflection.uniformDetails.get("u_morphActiveIndex4")?.arraySize;
+    const maxActive = arrayBound !== null && arrayBound !== undefined && arrayBound > 0 ? arrayBound * 4 : 32;
+    const packed = packActiveMorphs(item.morphWeights, result.targetCount, maxActive, item.previousMorphWeights);
+    uniforms.set("u_morphTexture", new TextureBinding({ name: "u_morphTexture", texture: result.texture }));
+    uniforms.set("u_morphStride", result.stride);
+    uniforms.set("u_morphTexWidth", result.texture.width);
+    uniforms.set("u_morphActiveCount", packed.count);
+    uniforms.set("u_morphActiveIndex4", packed.indices);
+    uniforms.set("u_morphActiveWeight4", packed.current);
+    if (packed.previous)
+        uniforms.set("u_morphPrevWeight4", packed.previous);
+    return true;
+}
+/* ------------------------------------------------------------------ feature */
+export function createPrd06DeformFeature(cache, buildMorphTexture) {
+    morphTextureBuilder = buildMorphTexture;
+    return {
+        id: "prd06.deform",
+        owner: "prd06",
+        flag: "A3D_QR_ANIMATION",
+        // hookSplice pairs chunks[i] with hooks[i] (one chunk per hook index):
+        // skinning_common lands at `vertex:pars` (dragging morph_texture behind it
+        // via `requires`), a3d_prd06_deform lands at `vertex:deform` — helpers
+        // declared before the function that calls them.
+        chunks: ["a3d_prd06_skinning_common", "a3d_prd06_deform"],
+        hooks: ["vertex:pars", "vertex:deform"],
+        select(input) {
+            return selectPrd06DeformValue(input.item, input.pass, input.tier, input.flags);
+        },
+        defines(value) {
+            return prd06DeformDefines(value);
+        },
+        bindUniforms(value, item, set) {
+            if (item.skinning)
+                bindBoneTexture(set, cache, item);
+            const key = typeof value === "string" ? parsePrd06DeformKey(value) : null;
+            if (!key || key.morphBucket === null)
+                return;
+            const result = morphTextureFor(item);
+            if (!result || "fallback" in result || !item.morphWeights)
+                return;
+            const maxActive = key.morphMaxActive ?? 32;
+            const packed = packActiveMorphs(item.morphWeights, result.targetCount, maxActive, item.previousMorphWeights);
+            set("u_morphTexture", new TextureBinding({ name: "u_morphTexture", texture: result.texture }));
+            set("u_morphStride", result.stride);
+            set("u_morphTexWidth", result.texture.width);
+            set("u_morphActiveCount", packed.count);
+            set("u_morphActiveIndex4", packed.indices);
+            set("u_morphActiveWeight4", packed.current);
+            if (packed.previous)
+                set("u_morphPrevWeight4", packed.previous);
+        }
+    };
+}
+/** Registers the forward feature; returns the C-02 registry disposer. Idempotent per call site. */
+export function registerPrd06DeformFeature(cache, buildMorphTexture) {
+    return registerShaderFeature(createPrd06DeformFeature(cache, buildMorphTexture));
+}
+//# sourceMappingURL=forwardFeature.js.map

package/dist/rendering/shaders/deform/forwardFeature.js.map

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

package/dist/rendering/shaders/deform/morph.glsl.d.ts

@@ -0,0 +1,14 @@
+/**
+ * C-18 chunk `a3d_prd06_morph_texture` (PRD-06 §8.2) — `sampler2DArray` morph
+ * deltas packed by `resources/MorphTargetTexture.ts` (texel j = vertexId*stride
+ * + attr, z = target). Only the top-K active targets upload per frame; the
+ * packed index/weight vectors cost `A3D_MORPH_MAX_ACTIVE/4` vec4 slots each.
+ *
+ * Uniform types follow §8.2 semantics with float-friendly declarations: the
+ * generic `MultiDraw` uniform upload only has `uniformNf*v` paths (no integer
+ * uploads — qr-request noted alongside Q-01-3), so the §8.2 `int`/`ivec4`
+ * scalars arrive as `float`/`vec4` and cast at read time. Values are integral,
+ * so float32 round-trip through `int()` is exact.
+ */
+export declare const A3D_PRD06_MORPH_TEXTURE_GLSL = "\n#ifdef A3D_MORPH\nuniform highp sampler2DArray u_morphTexture;   // layer = target, texel = vertexId * stride + attr\nuniform float u_morphStride;                   // 1 (pos) | 2 (pos,normal) | 3 (pos,normal,tangent) \u2014 \u00A78.2 int, bound as float\nuniform float u_morphTexWidth;                 // \u00A78.2 int, bound as float\nuniform float u_morphActiveCount;              // <= A3D_MORPH_MAX_ACTIVE (8 Low, 16 Med, 32 High, 64 Ultra); multiple of 4 \u2014 \u00A78.2 int, bound as float\n// Packed 4 per vec4: a scalar uniform array costs one vec4 slot PER ELEMENT under GLSL ES 3.00 packing,\n// so three 64-element scalar arrays would cost 192 of the 256 guaranteed vertex vectors. Packed: 48 at Ultra.\n// \u00A78.2 declares ivec4 u_morphActiveIndex4; bound as vec4 + int() until integer uniform uploads exist.\nuniform vec4 u_morphActiveIndex4[A3D_MORPH_MAX_ACTIVE / 4];\nuniform vec4 u_morphActiveWeight4[A3D_MORPH_MAX_ACTIVE / 4];\n#ifdef A3D_VELOCITY\nuniform vec4 u_morphPrevWeight4[A3D_MORPH_MAX_ACTIVE / 4]; // same index list, previous-frame weights (0 if newly active)\n#endif\nint a3dMorphTargetIndex(int k) {\n  return int(u_morphActiveIndex4[k >> 2][k & 3] + 0.5);\n}\nvec4 a3dMorphFetch(int target, int attr) {\n  int t = gl_VertexID * int(u_morphStride) + attr; int y = t / int(u_morphTexWidth);\n  return texelFetch(u_morphTexture, ivec3(t - y * int(u_morphTexWidth), y, target), 0);\n}\nvoid a3dApplyMorph(inout vec3 p, inout vec3 n, inout vec4 tg) {\n  for (int k = 0; k < A3D_MORPH_MAX_ACTIVE; ++k) {\n    if (k >= int(u_morphActiveCount)) break;\n    int tgt = a3dMorphTargetIndex(k); float w = u_morphActiveWeight4[k >> 2][k & 3];\n    p += a3dMorphFetch(tgt, 0).xyz * w;\n    if (u_morphStride > 1.5) n += a3dMorphFetch(tgt, 1).xyz * w;\n    if (u_morphStride > 2.5) tg.xyz += a3dMorphFetch(tgt, 2).xyz * w;\n  }\n}\n#endif\n";
+//# sourceMappingURL=morph.glsl.d.ts.map

package/dist/rendering/shaders/deform/morph.glsl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"morph.glsl.d.ts","sourceRoot":"","sources":["../../../../../../packages/rendering/src/shaders/deform/morph.glsl.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,4BAA4B,20DA+BxC,CAAC"}

package/dist/rendering/shaders/deform/morph.glsl.js

@@ -0,0 +1,45 @@
+/**
+ * C-18 chunk `a3d_prd06_morph_texture` (PRD-06 §8.2) — `sampler2DArray` morph
+ * deltas packed by `resources/MorphTargetTexture.ts` (texel j = vertexId*stride
+ * + attr, z = target). Only the top-K active targets upload per frame; the
+ * packed index/weight vectors cost `A3D_MORPH_MAX_ACTIVE/4` vec4 slots each.
+ *
+ * Uniform types follow §8.2 semantics with float-friendly declarations: the
+ * generic `MultiDraw` uniform upload only has `uniformNf*v` paths (no integer
+ * uploads — qr-request noted alongside Q-01-3), so the §8.2 `int`/`ivec4`
+ * scalars arrive as `float`/`vec4` and cast at read time. Values are integral,
+ * so float32 round-trip through `int()` is exact.
+ */
+export const A3D_PRD06_MORPH_TEXTURE_GLSL = /* glsl */ `
+#ifdef A3D_MORPH
+uniform highp sampler2DArray u_morphTexture;   // layer = target, texel = vertexId * stride + attr
+uniform float u_morphStride;                   // 1 (pos) | 2 (pos,normal) | 3 (pos,normal,tangent) — §8.2 int, bound as float
+uniform float u_morphTexWidth;                 // §8.2 int, bound as float
+uniform float u_morphActiveCount;              // <= A3D_MORPH_MAX_ACTIVE (8 Low, 16 Med, 32 High, 64 Ultra); multiple of 4 — §8.2 int, bound as float
+// Packed 4 per vec4: a scalar uniform array costs one vec4 slot PER ELEMENT under GLSL ES 3.00 packing,
+// so three 64-element scalar arrays would cost 192 of the 256 guaranteed vertex vectors. Packed: 48 at Ultra.
+// §8.2 declares ivec4 u_morphActiveIndex4; bound as vec4 + int() until integer uniform uploads exist.
+uniform vec4 u_morphActiveIndex4[A3D_MORPH_MAX_ACTIVE / 4];
+uniform vec4 u_morphActiveWeight4[A3D_MORPH_MAX_ACTIVE / 4];
+#ifdef A3D_VELOCITY
+uniform vec4 u_morphPrevWeight4[A3D_MORPH_MAX_ACTIVE / 4]; // same index list, previous-frame weights (0 if newly active)
+#endif
+int a3dMorphTargetIndex(int k) {
+  return int(u_morphActiveIndex4[k >> 2][k & 3] + 0.5);
+}
+vec4 a3dMorphFetch(int target, int attr) {
+  int t = gl_VertexID * int(u_morphStride) + attr; int y = t / int(u_morphTexWidth);
+  return texelFetch(u_morphTexture, ivec3(t - y * int(u_morphTexWidth), y, target), 0);
+}
+void a3dApplyMorph(inout vec3 p, inout vec3 n, inout vec4 tg) {
+  for (int k = 0; k < A3D_MORPH_MAX_ACTIVE; ++k) {
+    if (k >= int(u_morphActiveCount)) break;
+    int tgt = a3dMorphTargetIndex(k); float w = u_morphActiveWeight4[k >> 2][k & 3];
+    p += a3dMorphFetch(tgt, 0).xyz * w;
+    if (u_morphStride > 1.5) n += a3dMorphFetch(tgt, 1).xyz * w;
+    if (u_morphStride > 2.5) tg.xyz += a3dMorphFetch(tgt, 2).xyz * w;
+  }
+}
+#endif
+`;
+//# sourceMappingURL=morph.glsl.js.map

package/dist/rendering/shaders/deform/morph.glsl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"morph.glsl.js","sourceRoot":"","sources":["../../../../../../packages/rendering/src/shaders/deform/morph.glsl.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG,UAAU,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+BtD,CAAC"}

package/dist/rendering/shaders/deform/morph.wgsl.d.ts

@@ -0,0 +1,21 @@
+/**
+ * PRD-06 T2.7 — WGSL twin of `a3d_prd06_morph_texture`
+ * (`shaders/deform/morph.glsl.ts`). The packed deltas stay a
+ * `texture_2d_array<f32>` (layer = target, texel = vertexIndex * stride +
+ * attr, exactly as `resources/MorphTargetTexture.ts` packs them); the scalar
+ * §8.2 ints and the packed index/weight arrays fold into one uniform struct.
+ *
+ * WGSL realities vs the GLSL source:
+ *   - `gl_VertexID` is an entry-point builtin — helpers take `vertexIndex`
+ *     as a parameter; the generated `@vertex` fn forwards
+ *     `@builtin(vertex_index)`.
+ *   - `A3D_MORPH_MAX_ACTIVE` becomes a `const` the program generator rewrites
+ *     per tier (8/16/32/64); the twin validates at the Ultra ceiling 64.
+ *   - The float-declared §8.2 uniforms keep their float read + `u32(x + 0.5)`
+ *     cast — the MultiDraw integer-upload gap (Q-01-3) applies to WGSL
+ *     uniform layout equally, and float32 round-trips small ints exactly.
+ *   - `inout` parameters become `ptr<function, …>`.
+ *   - `stride` is a WGSL reserved word → the struct field is `morphStride`.
+ */
+export declare const A3D_PRD06_MORPH_TEXTURE_WGSL = "\n// A3D_MORPH_MAX_ACTIVE \u2014 emitted per tier by the program generator\n// (8 Low, 16 Med, 32 High, 64 Ultra); the twin validates at the Ultra bound.\nconst A3D_MORPH_MAX_ACTIVE: u32 = 64u;\nconst A3D_MORPH_VEC4_SLOTS: u32 = A3D_MORPH_MAX_ACTIVE / 4u;\n\nstruct A3dPrd06MorphUniform {\n  // x = stride (1|2|3 attrs), y = texture width, z = active count, w unused.\n  dims: vec4<f32>,\n  activeIndex4: array<vec4<f32>, A3D_MORPH_VEC4_SLOTS>,\n  activeWeight4: array<vec4<f32>, A3D_MORPH_VEC4_SLOTS>,\n  // \u00A78.5 \u2014 previous-frame weights over the same index list (0 when newly\n  // active). Velocity programs read it; others never bind it.\n  prevWeight4: array<vec4<f32>, A3D_MORPH_VEC4_SLOTS>,\n};\n@group(3) @binding(12) var<uniform> a3dMorph: A3dPrd06MorphUniform;\n@group(3) @binding(13) var a3dMorphTexture: texture_2d_array<f32>;\n\nfn a3dMorphTargetIndex(k: u32) -> u32 {\n  return u32(a3dMorph.activeIndex4[k >> 2u][k & 3u] + 0.5);\n}\nfn a3dMorphFetch(vertexIndex: u32, targetLayer: u32, attr: u32) -> vec4<f32> {\n  let stride_ = u32(a3dMorph.dims.x + 0.5);\n  let texWidth = u32(a3dMorph.dims.y + 0.5);\n  let t = vertexIndex * stride_ + attr;\n  let y = t / texWidth;\n  return textureLoad(a3dMorphTexture, vec2<i32>(i32(t - y * texWidth), i32(y)), i32(targetLayer), 0);\n}\nfn a3dMorphActiveWeight(k: u32) -> f32 {\n  return a3dMorph.activeWeight4[k >> 2u][k & 3u];\n}\nfn a3dMorphPrevWeight(k: u32) -> f32 {\n  return a3dMorph.prevWeight4[k >> 2u][k & 3u];\n}\nfn a3dMorphActiveCount() -> u32 {\n  return u32(a3dMorph.dims.z + 0.5);\n}\nfn a3dApplyMorph(vertexIndex: u32, p: ptr<function, vec3<f32>>, n: ptr<function, vec3<f32>>, tg: ptr<function, vec4<f32>>) {\n  for (var k: u32 = 0u; k < A3D_MORPH_MAX_ACTIVE; k = k + 1u) {\n    if (k >= a3dMorphActiveCount()) { break; }\n    let tgt = a3dMorphTargetIndex(k);\n    let w = a3dMorphActiveWeight(k);\n    *p = *p + a3dMorphFetch(vertexIndex, tgt, 0u).xyz * w;\n    if (a3dMorph.dims.x > 1.5) {\n      *n = *n + a3dMorphFetch(vertexIndex, tgt, 1u).xyz * w;\n    }\n    if (a3dMorph.dims.x > 2.5) {\n      let d = a3dMorphFetch(vertexIndex, tgt, 2u).xyz * w;\n      *tg = vec4<f32>((*tg).xyz + d, (*tg).w);\n    }\n  }\n}\n";
+//# sourceMappingURL=morph.wgsl.d.ts.map

package/dist/rendering/shaders/deform/morph.wgsl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"morph.wgsl.d.ts","sourceRoot":"","sources":["../../../../../../packages/rendering/src/shaders/deform/morph.wgsl.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,eAAO,MAAM,4BAA4B,6pEAoDxC,CAAC"}

package/dist/rendering/shaders/deform/morph.wgsl.js

@@ -0,0 +1,73 @@
+/**
+ * PRD-06 T2.7 — WGSL twin of `a3d_prd06_morph_texture`
+ * (`shaders/deform/morph.glsl.ts`). The packed deltas stay a
+ * `texture_2d_array<f32>` (layer = target, texel = vertexIndex * stride +
+ * attr, exactly as `resources/MorphTargetTexture.ts` packs them); the scalar
+ * §8.2 ints and the packed index/weight arrays fold into one uniform struct.
+ *
+ * WGSL realities vs the GLSL source:
+ *   - `gl_VertexID` is an entry-point builtin — helpers take `vertexIndex`
+ *     as a parameter; the generated `@vertex` fn forwards
+ *     `@builtin(vertex_index)`.
+ *   - `A3D_MORPH_MAX_ACTIVE` becomes a `const` the program generator rewrites
+ *     per tier (8/16/32/64); the twin validates at the Ultra ceiling 64.
+ *   - The float-declared §8.2 uniforms keep their float read + `u32(x + 0.5)`
+ *     cast — the MultiDraw integer-upload gap (Q-01-3) applies to WGSL
+ *     uniform layout equally, and float32 round-trips small ints exactly.
+ *   - `inout` parameters become `ptr<function, …>`.
+ *   - `stride` is a WGSL reserved word → the struct field is `morphStride`.
+ */
+export const A3D_PRD06_MORPH_TEXTURE_WGSL = /* wgsl */ `
+// A3D_MORPH_MAX_ACTIVE — emitted per tier by the program generator
+// (8 Low, 16 Med, 32 High, 64 Ultra); the twin validates at the Ultra bound.
+const A3D_MORPH_MAX_ACTIVE: u32 = 64u;
+const A3D_MORPH_VEC4_SLOTS: u32 = A3D_MORPH_MAX_ACTIVE / 4u;
+
+struct A3dPrd06MorphUniform {
+  // x = stride (1|2|3 attrs), y = texture width, z = active count, w unused.
+  dims: vec4<f32>,
+  activeIndex4: array<vec4<f32>, A3D_MORPH_VEC4_SLOTS>,
+  activeWeight4: array<vec4<f32>, A3D_MORPH_VEC4_SLOTS>,
+  // §8.5 — previous-frame weights over the same index list (0 when newly
+  // active). Velocity programs read it; others never bind it.
+  prevWeight4: array<vec4<f32>, A3D_MORPH_VEC4_SLOTS>,
+};
+@group(3) @binding(12) var<uniform> a3dMorph: A3dPrd06MorphUniform;
+@group(3) @binding(13) var a3dMorphTexture: texture_2d_array<f32>;
+
+fn a3dMorphTargetIndex(k: u32) -> u32 {
+  return u32(a3dMorph.activeIndex4[k >> 2u][k & 3u] + 0.5);
+}
+fn a3dMorphFetch(vertexIndex: u32, targetLayer: u32, attr: u32) -> vec4<f32> {
+  let stride_ = u32(a3dMorph.dims.x + 0.5);
+  let texWidth = u32(a3dMorph.dims.y + 0.5);
+  let t = vertexIndex * stride_ + attr;
+  let y = t / texWidth;
+  return textureLoad(a3dMorphTexture, vec2<i32>(i32(t - y * texWidth), i32(y)), i32(targetLayer), 0);
+}
+fn a3dMorphActiveWeight(k: u32) -> f32 {
+  return a3dMorph.activeWeight4[k >> 2u][k & 3u];
+}
+fn a3dMorphPrevWeight(k: u32) -> f32 {
+  return a3dMorph.prevWeight4[k >> 2u][k & 3u];
+}
+fn a3dMorphActiveCount() -> u32 {
+  return u32(a3dMorph.dims.z + 0.5);
+}
+fn a3dApplyMorph(vertexIndex: u32, p: ptr<function, vec3<f32>>, n: ptr<function, vec3<f32>>, tg: ptr<function, vec4<f32>>) {
+  for (var k: u32 = 0u; k < A3D_MORPH_MAX_ACTIVE; k = k + 1u) {
+    if (k >= a3dMorphActiveCount()) { break; }
+    let tgt = a3dMorphTargetIndex(k);
+    let w = a3dMorphActiveWeight(k);
+    *p = *p + a3dMorphFetch(vertexIndex, tgt, 0u).xyz * w;
+    if (a3dMorph.dims.x > 1.5) {
+      *n = *n + a3dMorphFetch(vertexIndex, tgt, 1u).xyz * w;
+    }
+    if (a3dMorph.dims.x > 2.5) {
+      let d = a3dMorphFetch(vertexIndex, tgt, 2u).xyz * w;
+      *tg = vec4<f32>((*tg).xyz + d, (*tg).w);
+    }
+  }
+}
+`;
+//# sourceMappingURL=morph.wgsl.js.map

package/dist/rendering/shaders/deform/morph.wgsl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"morph.wgsl.js","sourceRoot":"","sources":["../../../../../../packages/rendering/src/shaders/deform/morph.wgsl.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,MAAM,CAAC,MAAM,4BAA4B,GAAG,UAAU,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoDtD,CAAC"}

package/dist/rendering/shaders/deform/skinning.glsl.d.ts

@@ -0,0 +1,8 @@
+/**
+ * C-18 chunk `a3d_prd06_skinning_common` (PRD-06 §8.1) — bone-texture skinning.
+ * Replaces the legacy `u_jointPaletteMode`/`u_jointMatrices[96]` dual mode; the
+ * palette lives in an RGBA32F texture, four texels per mat4, persistent per
+ * skin via `SkinningPaletteTextureCache`. Registered from `lanes/prd06.ts`.
+ */
+export declare const A3D_PRD06_SKINNING_COMMON_GLSL = "\n#ifdef A3D_SKINNING\nuniform highp sampler2D u_boneTexture;        // RGBA32F, 4 texels per mat4, persistent per skin\nuniform float u_boneTextureWidth;             // multiple of 4 \u2014 \u00A78.1 int, bound as float (no integer uniform uploads yet)\n#ifdef A3D_VELOCITY\nuniform highp sampler2D u_prevBoneTexture;\n#endif\n// Existing attribute names/locations kept (ShaderLibrary.ts skinned-unlit + 8-influence fork).\nlayout(location = 5) in vec4 a_joints;        // float today; uvec4 once WebGL2Device supports vertexAttribIPointer\nlayout(location = 6) in vec4 a_weights;\n#if A3D_SKINNING == 8\nlayout(location = 8) in vec4 a_joints1;       // existing JOINTS_1 location\nlayout(location = 9) in vec4 a_weights1;      // existing WEIGHTS_1 location\n#endif\nmat4 a3dBone(highp sampler2D tex, float jf) {\n  int i = int(jf + 0.5) * 4; int w = int(u_boneTextureWidth + 0.5); int y = i / w; int x = i - y * w;\n  return mat4(texelFetch(tex, ivec2(x, y), 0), texelFetch(tex, ivec2(x + 1, y), 0),\n              texelFetch(tex, ivec2(x + 2, y), 0), texelFetch(tex, ivec2(x + 3, y), 0));\n}\nmat4 a3dSkin(highp sampler2D tex) {\n  mat4 m = a3dBone(tex, a_joints.x) * a_weights.x + a3dBone(tex, a_joints.y) * a_weights.y\n         + a3dBone(tex, a_joints.z) * a_weights.z + a3dBone(tex, a_joints.w) * a_weights.w;\n#if A3D_SKINNING == 8\n  m += a3dBone(tex, a_joints1.x) * a_weights1.x + a3dBone(tex, a_joints1.y) * a_weights1.y\n     + a3dBone(tex, a_joints1.z) * a_weights1.z + a3dBone(tex, a_joints1.w) * a_weights1.w;\n#endif\n  return m;\n}\n#endif\n";
+//# sourceMappingURL=skinning.glsl.d.ts.map

package/dist/rendering/shaders/deform/skinning.glsl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skinning.glsl.d.ts","sourceRoot":"","sources":["../../../../../../packages/rendering/src/shaders/deform/skinning.glsl.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,eAAO,MAAM,8BAA8B,4hDA6B1C,CAAC"}

package/dist/rendering/shaders/deform/skinning.glsl.js

@@ -0,0 +1,37 @@
+/**
+ * C-18 chunk `a3d_prd06_skinning_common` (PRD-06 §8.1) — bone-texture skinning.
+ * Replaces the legacy `u_jointPaletteMode`/`u_jointMatrices[96]` dual mode; the
+ * palette lives in an RGBA32F texture, four texels per mat4, persistent per
+ * skin via `SkinningPaletteTextureCache`. Registered from `lanes/prd06.ts`.
+ */
+export const A3D_PRD06_SKINNING_COMMON_GLSL = /* glsl */ `
+#ifdef A3D_SKINNING
+uniform highp sampler2D u_boneTexture;        // RGBA32F, 4 texels per mat4, persistent per skin
+uniform float u_boneTextureWidth;             // multiple of 4 — §8.1 int, bound as float (no integer uniform uploads yet)
+#ifdef A3D_VELOCITY
+uniform highp sampler2D u_prevBoneTexture;
+#endif
+// Existing attribute names/locations kept (ShaderLibrary.ts skinned-unlit + 8-influence fork).
+layout(location = 5) in vec4 a_joints;        // float today; uvec4 once WebGL2Device supports vertexAttribIPointer
+layout(location = 6) in vec4 a_weights;
+#if A3D_SKINNING == 8
+layout(location = 8) in vec4 a_joints1;       // existing JOINTS_1 location
+layout(location = 9) in vec4 a_weights1;      // existing WEIGHTS_1 location
+#endif
+mat4 a3dBone(highp sampler2D tex, float jf) {
+  int i = int(jf + 0.5) * 4; int w = int(u_boneTextureWidth + 0.5); int y = i / w; int x = i - y * w;
+  return mat4(texelFetch(tex, ivec2(x, y), 0), texelFetch(tex, ivec2(x + 1, y), 0),
+              texelFetch(tex, ivec2(x + 2, y), 0), texelFetch(tex, ivec2(x + 3, y), 0));
+}
+mat4 a3dSkin(highp sampler2D tex) {
+  mat4 m = a3dBone(tex, a_joints.x) * a_weights.x + a3dBone(tex, a_joints.y) * a_weights.y
+         + a3dBone(tex, a_joints.z) * a_weights.z + a3dBone(tex, a_joints.w) * a_weights.w;
+#if A3D_SKINNING == 8
+  m += a3dBone(tex, a_joints1.x) * a_weights1.x + a3dBone(tex, a_joints1.y) * a_weights1.y
+     + a3dBone(tex, a_joints1.z) * a_weights1.z + a3dBone(tex, a_joints1.w) * a_weights1.w;
+#endif
+  return m;
+}
+#endif
+`;
+//# sourceMappingURL=skinning.glsl.js.map

package/dist/rendering/shaders/deform/skinning.glsl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skinning.glsl.js","sourceRoot":"","sources":["../../../../../../packages/rendering/src/shaders/deform/skinning.glsl.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,8BAA8B,GAAG,UAAU,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6BxD,CAAC"}

package/dist/rendering/shaders/deform/skinning.wgsl.d.ts

@@ -0,0 +1,26 @@
+/**
+ * PRD-06 T2.7 — WGSL twin of `a3d_prd06_skinning_common`
+ * (`shaders/deform/skinning.glsl.ts`). Same palette semantics, WGSL idiom:
+ *
+ *   - `u_boneTexture` (RGBA32F sampler, 4 texels per mat4) →
+ *     `a3dBones: var<storage> array<mat4x4<f32>>` — a storage buffer sized to
+ *     the rig (`jointCount * 64` bytes), matching §8.1's "bones sized to the
+ *     rig" shape instead of a texel-width lookup. `u_boneTextureWidth`
+ *     disappears with the addressing math.
+ *   - `u_prevBoneTexture` → `a3dPrevBones` — declared unconditionally; WebGPU
+ *     only requires bindings a program statically reads, so non-velocity
+ *     programs never bind it.
+ *   - GLSL `in` attributes (`a_joints`, `a_weights`, `a_joints1`, `a_weights1`)
+ *     become function parameters — WGSL vertex inputs live in the generated
+ *     entry-point struct, not in chunks. Joints arrive as `vec4<u32>`; the
+ *     generated program converts the float vertex attributes at the call site.
+ *   - `A3D_SKINNING == 8` (preprocessor fork) becomes two functions,
+ *     `a3dSkin4`/`a3dSkin8` (+ `Prev` twins); the generator emits the call its
+ *     features select.
+ *
+ * Group/binding numbers are placeholders for the WebGPU generator (Q-11-1
+ * owns device-side binding) — group 3 matches the lane-11 per-draw-resource
+ * convention.
+ */
+export declare const A3D_PRD06_SKINNING_COMMON_WGSL = "\n// \u00A78.1 \u2014 storage-buffer bones sized to the rig (jointCount mat4s).\n@group(3) @binding(10) var<storage, read> a3dBones: array<mat4x4<f32>>;\n// \u00A78.5 \u2014 previous-frame palette for velocity programs. Declared\n// unconditionally: WebGPU only requires bindings the entry point\n// transitively reads, so forward programs never bind it.\n@group(3) @binding(11) var<storage, read> a3dPrevBones: array<mat4x4<f32>>;\n\nfn a3dBone(j: u32) -> mat4x4<f32> {\n  return a3dBones[j];\n}\nfn a3dBonePrev(j: u32) -> mat4x4<f32> {\n  return a3dPrevBones[j];\n}\nfn a3dSkin4(joints: vec4<u32>, weights: vec4<f32>) -> mat4x4<f32> {\n  return a3dBone(joints.x) * weights.x + a3dBone(joints.y) * weights.y\n       + a3dBone(joints.z) * weights.z + a3dBone(joints.w) * weights.w;\n}\nfn a3dSkin8(joints: vec4<u32>, weights: vec4<f32>, joints1: vec4<u32>, weights1: vec4<f32>) -> mat4x4<f32> {\n  return a3dSkin4(joints, weights)\n       + a3dBone(joints1.x) * weights1.x + a3dBone(joints1.y) * weights1.y\n       + a3dBone(joints1.z) * weights1.z + a3dBone(joints1.w) * weights1.w;\n}\nfn a3dSkinPrev4(joints: vec4<u32>, weights: vec4<f32>) -> mat4x4<f32> {\n  return a3dBonePrev(joints.x) * weights.x + a3dBonePrev(joints.y) * weights.y\n       + a3dBonePrev(joints.z) * weights.z + a3dBonePrev(joints.w) * weights.w;\n}\nfn a3dSkinPrev8(joints: vec4<u32>, weights: vec4<f32>, joints1: vec4<u32>, weights1: vec4<f32>) -> mat4x4<f32> {\n  return a3dSkinPrev4(joints, weights)\n       + a3dBonePrev(joints1.x) * weights1.x + a3dBonePrev(joints1.y) * weights1.y\n       + a3dBonePrev(joints1.z) * weights1.z + a3dBonePrev(joints1.w) * weights1.w;\n}\n";
+//# sourceMappingURL=skinning.wgsl.d.ts.map

package/dist/rendering/shaders/deform/skinning.wgsl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skinning.wgsl.d.ts","sourceRoot":"","sources":["../../../../../../packages/rendering/src/shaders/deform/skinning.wgsl.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,eAAO,MAAM,8BAA8B,wnDAgC1C,CAAC"}