@aura3d/engine 2.0.4 → 3.0.1

package/dist/rendering/webgpu/WebGPUPostProcess.js.map

@@ -1 +1 @@
-{"version":3,"file":"WebGPUPostProcess.js","sourceRoot":"","sources":["../../../../../packages/rendering/src/webgpu/WebGPUPostProcess.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,6BAA6B,EAAE,MAAM,+BAA+B,CAAC"}
+{"version":3,"file":"WebGPUPostProcess.js","sourceRoot":"","sources":["../../../../../packages/rendering/src/webgpu/WebGPUPostProcess.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,6BAA6B,EAAE,MAAM,+BAA+B,CAAC;AAE9E,OAAO,EACL,yBAAyB,EACzB,gCAAgC,EAChC,2BAA2B,EAC3B,2BAA2B,EAC3B,4BAA4B,EAC5B,kBAAkB,EAClB,2BAA2B,EAC3B,wBAAwB,EACxB,kBAAkB,EAClB,oBAAoB,EACpB,qBAAqB,EACrB,0BAA0B,EAC1B,uBAAuB,EACxB,MAAM,qBAAqB,CAAC"}

package/dist/rendering/webgpu/WebGPUPostShaders.d.ts

@@ -0,0 +1,77 @@
+/**
+ * muse3jsparity-PRD J2 — native WebGPU post-process WGSL sources.
+ *
+ * Fullscreen-triangle passes that run on the real WebGPU device
+ * (WebGPUDevice.executeWebGPUBloom / executeWebGPUColorGrade /
+ * executeWebGPUFxaa). Backend-agnostic image work: bright-extract with a
+ * soft-knee threshold, a separable-Gaussian mip pyramid, energy-weighted
+ * composite, exposure/contrast/saturation color grade, and an FXAA
+ * luma-edge pass. Native TAA is owned by WebGPUTemporal.ts, with explicit
+ * GPU velocity and ping-pong history targets; it performs no CPU readback.
+ */
+export declare const WEBGPU_POST_VERTEX_WGSL = "struct PostVertexOutput {\n  @builtin(position) position: vec4<f32>,\n  @location(0) uv: vec2<f32>,\n};\n\n@vertex\nfn vs_post(@builtin(vertex_index) index: u32) -> PostVertexOutput {\n  var output: PostVertexOutput;\n  let corners = array<vec2<f32>, 3>(\n    vec2<f32>(-1.0, -1.0),\n    vec2<f32>(3.0, -1.0),\n    vec2<f32>(-1.0, 3.0)\n  );\n  let corner = corners[index];\n  output.position = vec4<f32>(corner, 0.0, 1.0);\n  output.uv = vec2<f32>((corner.x + 1.0) * 0.5, 1.0 - (corner.y + 1.0) * 0.5);\n  return output;\n}\n";
+export declare function webgpuBrightExtractFragment(): string;
+export declare function webgpuBlurFragment(): string;
+export interface WebGPUCompositeParams {
+    /** Per-mip weights, index 0 = finest. Energy-preserving when they sum to 1. */
+    readonly weights: readonly number[];
+    /** Global gain (bloom strength). */
+    readonly strength: number;
+}
+export declare const WEBGPU_BLOOM_MAX_MIPS = 5;
+export declare function webgpuBloomCompositeFragment(params: WebGPUCompositeParams): string;
+/** Default per-mip weights: 0.5^i falloff normalized to sum 1 (energy-preserving). */
+export declare function defaultWebGPUBloomWeights(mipCount: number): number[];
+export type WebGPUBloomQuality = "performance" | "balanced" | "cinematic";
+export interface WebGPUBloomOptions {
+    readonly threshold?: number;
+    readonly knee?: number;
+    readonly strength?: number;
+    readonly quality?: WebGPUBloomQuality;
+    readonly mipCount?: number;
+}
+export interface NormalizedWebGPUBloom {
+    readonly threshold: number;
+    readonly knee: number;
+    readonly strength: number;
+    readonly quality: WebGPUBloomQuality;
+    readonly mipCount: number;
+    readonly halfFloat: boolean;
+}
+export declare const WEBGPU_BLOOM_QUALITY_TABLE: Readonly<Record<WebGPUBloomQuality, {
+    readonly mipCount: number;
+    readonly halfFloat: boolean;
+}>>;
+export declare function normalizeWebGPUBloomQuality(quality: WebGPUBloomQuality | undefined): {
+    readonly quality: WebGPUBloomQuality;
+    readonly mipCount: number;
+    readonly halfFloat: boolean;
+};
+export declare function normalizeWebGPUBloomOptions(options?: WebGPUBloomOptions): NormalizedWebGPUBloom;
+export interface WebGPUBloomDiagnostics {
+    readonly mipCount: number;
+    readonly halfFloat: boolean;
+    readonly targetBytes: number;
+    readonly compositeGain: number;
+    readonly passes: number;
+    readonly executionMode: "webgpu-native-post";
+}
+export interface WebGPUColorGradeOptions {
+    readonly exposure?: number;
+    readonly contrast?: number;
+    readonly saturation?: number;
+}
+export interface NormalizedWebGPUColorGrade {
+    readonly exposure: number;
+    readonly contrast: number;
+    readonly saturation: number;
+}
+export declare function normalizeWebGPUColorGradeOptions(options?: WebGPUColorGradeOptions): NormalizedWebGPUColorGrade;
+export interface WebGPUFxaaOptions {
+    readonly enabled?: boolean;
+}
+/** CPU mirror of the WGSL soft-knee gate (unit oracle, never the shader output). */
+export declare function webgpuSoftKneeWeight(luma: number, threshold: number, knee: number): number;
+export declare function webgpuColorGradeFragment(): string;
+export declare function webgpuFxaaFragment(): string;
+//# sourceMappingURL=WebGPUPostShaders.d.ts.map

package/dist/rendering/webgpu/WebGPUPostShaders.d.ts.map

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

package/dist/rendering/webgpu/WebGPUPostShaders.js

@@ -0,0 +1,261 @@
+/**
+ * muse3jsparity-PRD J2 — native WebGPU post-process WGSL sources.
+ *
+ * Fullscreen-triangle passes that run on the real WebGPU device
+ * (WebGPUDevice.executeWebGPUBloom / executeWebGPUColorGrade /
+ * executeWebGPUFxaa). Backend-agnostic image work: bright-extract with a
+ * soft-knee threshold, a separable-Gaussian mip pyramid, energy-weighted
+ * composite, exposure/contrast/saturation color grade, and an FXAA
+ * luma-edge pass. Native TAA is owned by WebGPUTemporal.ts, with explicit
+ * GPU velocity and ping-pong history targets; it performs no CPU readback.
+ */
+export const WEBGPU_POST_VERTEX_WGSL = `struct PostVertexOutput {
+  @builtin(position) position: vec4<f32>,
+  @location(0) uv: vec2<f32>,
+};
+
+@vertex
+fn vs_post(@builtin(vertex_index) index: u32) -> PostVertexOutput {
+  var output: PostVertexOutput;
+  let corners = array<vec2<f32>, 3>(
+    vec2<f32>(-1.0, -1.0),
+    vec2<f32>(3.0, -1.0),
+    vec2<f32>(-1.0, 3.0)
+  );
+  let corner = corners[index];
+  output.position = vec4<f32>(corner, 0.0, 1.0);
+  output.uv = vec2<f32>((corner.x + 1.0) * 0.5, 1.0 - (corner.y + 1.0) * 0.5);
+  return output;
+}
+`;
+export function webgpuBrightExtractFragment() {
+    return `struct BloomUniforms {
+  threshold: f32,
+  knee: f32,
+  strength: f32,
+  _pad: f32,
+};
+
+@group(0) @binding(0) var<uniform> u_bloom: BloomUniforms;
+@group(0) @binding(1) var u_sampler: sampler;
+@group(0) @binding(2) var u_source: texture_2d<f32>;
+
+@fragment
+fn fs_bright(@location(0) uv: vec2<f32>) -> @location(0) vec4<f32> {
+  let color = textureSample(u_source, u_sampler, uv);
+  let luma = dot(color.rgb, vec3<f32>(0.2126, 0.7152, 0.0722));
+  // Soft-knee gate: smoothstep over [threshold - knee, threshold + knee].
+  // knee = 0 collapses to a hard step (matches the native WebGL2 path).
+  // NOTE: threshold/knee MUST be read from u_bloom (not baked): an
+  // unreferenced uniform is stripped, which invalidates bind-group entry 0.
+  let lo = u_bloom.threshold - u_bloom.knee;
+  let hi = u_bloom.threshold + u_bloom.knee;
+  let weight = smoothstep(lo, hi, luma);
+  return vec4<f32>(color.rgb * weight, 1.0);
+}
+`;
+}
+export function webgpuBlurFragment() {
+    return `struct BlurUniforms {
+  direction: vec2<f32>,
+  texel: vec2<f32>,
+};
+
+@group(0) @binding(0) var<uniform> u_blur: BlurUniforms;
+@group(0) @binding(1) var u_sampler: sampler;
+@group(0) @binding(2) var u_source: texture_2d<f32>;
+
+@fragment
+fn fs_blur(@location(0) uv: vec2<f32>) -> @location(0) vec4<f32> {
+  // 9-tap separable Gaussian (sigma ~1.35): weights sum to exactly 1.0 so
+  // the pyramid preserves energy before the composite gain stage.
+  // NOTE: direction/texel MUST be read from u_blur (not baked): an
+  // unreferenced uniform is stripped, which invalidates bind-group entry 0.
+  let step = u_blur.direction * u_blur.texel;
+  var acc = textureSample(u_source, u_sampler, uv) * 0.2270270270;
+  acc = acc + textureSample(u_source, u_sampler, uv + step * 1.3846153846) * 0.3162162162;
+  acc = acc + textureSample(u_source, u_sampler, uv - step * 1.3846153846) * 0.3162162162;
+  acc = acc + textureSample(u_source, u_sampler, uv + step * 3.2307692308) * 0.0702702703;
+  acc = acc + textureSample(u_source, u_sampler, uv - step * 3.2307692308) * 0.0702702703;
+  return vec4<f32>(acc.rgb, 1.0);
+}
+`;
+}
+export const WEBGPU_BLOOM_MAX_MIPS = 5;
+export function webgpuBloomCompositeFragment(params) {
+    const lines = params.weights
+        .map((weight, index) => `  bloom = bloom + textureSample(u_mip${index}, u_sampler, uv).rgb * ${weight.toFixed(5)};`)
+        .join("\n");
+    const bindings = params.weights
+        .map((_, index) => `@group(0) @binding(${index + 3}) var u_mip${index}: texture_2d<f32>;`)
+        .join("\n");
+    return `struct CompositeUniforms {
+  strength: f32,
+  _pad0: f32,
+  _pad1: f32,
+  _pad2: f32,
+};
+
+@group(0) @binding(0) var<uniform> u_composite: CompositeUniforms;
+@group(0) @binding(1) var u_sampler: sampler;
+@group(0) @binding(2) var u_scene: texture_2d<f32>;
+${bindings}
+
+@fragment
+fn fs_composite(@location(0) uv: vec2<f32>) -> @location(0) vec4<f32> {
+  let scene = textureSample(u_scene, u_sampler, uv);
+  var bloom = vec3<f32>(0.0, 0.0, 0.0);
+${lines}
+  return vec4<f32>(scene.rgb + bloom * u_composite.strength, scene.a);
+}
+`;
+}
+/** Default per-mip weights: 0.5^i falloff normalized to sum 1 (energy-preserving). */
+export function defaultWebGPUBloomWeights(mipCount) {
+    const raw = Array.from({ length: mipCount }, (_, index) => Math.pow(0.5, index));
+    const total = raw.reduce((sum, value) => sum + value, 0);
+    return raw.map((value) => value / total);
+}
+export const WEBGPU_BLOOM_QUALITY_TABLE = {
+    // performance keeps the single-target legacy shape; balanced/cinematic run
+    // the full pyramid with half-float mip targets (mirrors the WebGL2 tiers).
+    performance: { mipCount: 1, halfFloat: false },
+    balanced: { mipCount: 3, halfFloat: true },
+    cinematic: { mipCount: 5, halfFloat: true }
+};
+export function normalizeWebGPUBloomQuality(quality) {
+    const resolved = quality ?? "balanced";
+    const table = WEBGPU_BLOOM_QUALITY_TABLE[resolved];
+    if (!table)
+        throw new RangeError(`Unknown WebGPU bloom quality "${String(quality)}" (expected performance|balanced|cinematic).`);
+    return { quality: resolved, mipCount: table.mipCount, halfFloat: table.halfFloat };
+}
+export function normalizeWebGPUBloomOptions(options = {}) {
+    const { quality, mipCount, halfFloat } = normalizeWebGPUBloomQuality(options.quality);
+    const threshold = options.threshold ?? 0.85;
+    const knee = options.knee ?? 0.15;
+    const strength = options.strength ?? 0.6;
+    if (!Number.isFinite(threshold) || threshold < 0)
+        throw new RangeError("WebGPU bloom threshold must be a finite number >= 0.");
+    if (!Number.isFinite(knee) || knee < 0)
+        throw new RangeError("WebGPU bloom knee must be a finite number >= 0.");
+    if (!Number.isFinite(strength) || strength < 0)
+        throw new RangeError("WebGPU bloom strength must be a finite number >= 0.");
+    if (options.mipCount !== undefined) {
+        if (!Number.isInteger(options.mipCount) || options.mipCount < 1 || options.mipCount > WEBGPU_BLOOM_MAX_MIPS) {
+            throw new RangeError(`WebGPU bloom mipCount must be an integer in [1, ${WEBGPU_BLOOM_MAX_MIPS}].`);
+        }
+        return { threshold, knee, strength, quality, mipCount: options.mipCount, halfFloat };
+    }
+    return { threshold, knee, strength, quality, mipCount, halfFloat };
+}
+export function normalizeWebGPUColorGradeOptions(options = {}) {
+    const exposure = options.exposure ?? 0;
+    const contrast = options.contrast ?? 1;
+    const saturation = options.saturation ?? 1;
+    if (!Number.isFinite(exposure))
+        throw new RangeError("WebGPU color-grade exposure must be finite.");
+    if (!Number.isFinite(contrast) || contrast < 0)
+        throw new RangeError("WebGPU color-grade contrast must be finite and >= 0.");
+    if (!Number.isFinite(saturation) || saturation < 0)
+        throw new RangeError("WebGPU color-grade saturation must be finite and >= 0.");
+    return { exposure, contrast, saturation };
+}
+/** CPU mirror of the WGSL soft-knee gate (unit oracle, never the shader output). */
+export function webgpuSoftKneeWeight(luma, threshold, knee) {
+    if (knee <= 0)
+        return luma >= threshold ? 1 : 0;
+    const lo = threshold - knee;
+    const hi = threshold + knee;
+    if (luma <= lo)
+        return 0;
+    if (luma >= hi)
+        return 1;
+    const t = (luma - lo) / (hi - lo);
+    return t * t * (3 - 2 * t);
+}
+export function webgpuColorGradeFragment() {
+    return `struct GradeUniforms {
+  exposure: f32,
+  contrast: f32,
+  saturation: f32,
+  _pad: f32,
+};
+
+@group(0) @binding(0) var<uniform> u_grade: GradeUniforms;
+@group(0) @binding(1) var u_sampler: sampler;
+@group(0) @binding(2) var u_source: texture_2d<f32>;
+
+@fragment
+fn fs_grade(@location(0) uv: vec2<f32>) -> @location(0) vec4<f32> {
+  var color = textureSample(u_source, u_sampler, uv).rgb;
+  // Exposure first (stops simulate the root colorGrade node), then
+  // saturation around luma, then contrast around middle gray.
+  // NOTE: all three MUST be read from u_grade (not baked): an unreferenced
+  // uniform is stripped, which invalidates bind-group entry 0.
+  color = color * exp2(u_grade.exposure);
+  let luma = dot(color, vec3<f32>(0.2126, 0.7152, 0.0722));
+  color = mix(vec3<f32>(luma), color, u_grade.saturation);
+  color = (color - vec3<f32>(0.5)) * u_grade.contrast + vec3<f32>(0.5);
+  return vec4<f32>(color, 1.0);
+}
+`;
+}
+export function webgpuFxaaFragment() {
+    return `struct FxaaUniforms {
+  texel: vec2<f32>,
+  _pad0: f32,
+  _pad1: f32,
+};
+
+@group(0) @binding(0) var<uniform> u_fxaa: FxaaUniforms;
+@group(0) @binding(1) var u_sampler: sampler;
+@group(0) @binding(2) var u_source: texture_2d<f32>;
+
+fn fxaaLuma(uv: vec2<f32>) -> f32 {
+  let color = textureSample(u_source, u_sampler, uv).rgb;
+  return dot(color, vec3<f32>(0.299, 0.587, 0.114));
+}
+
+@fragment
+fn fs_fxaa(@location(0) uv: vec2<f32>) -> @location(0) vec4<f32> {
+  // Compact FXAA 3.11 console core: luma neighborhood, edge direction from
+  // the diagonal/axis contrast, one perpendicular blend tap pair.
+  // NOTE: texel MUST be read from u_fxaa (not baked): an unreferenced
+  // uniform is stripped, which invalidates bind-group entry 0.
+  let texel = u_fxaa.texel;
+  // All taps up front: textureSample needs uniform control flow, so no
+  // sampling may happen after the flat-neighborhood early-out below —
+  // including the early-out's own return value.
+  let center = textureSample(u_source, u_sampler, uv).rgb;
+  let lumaM = fxaaLuma(uv);
+  let lumaN = fxaaLuma(uv + vec2<f32>(0.0, -texel.y));
+  let lumaS = fxaaLuma(uv + vec2<f32>(0.0, texel.y));
+  let lumaW = fxaaLuma(uv + vec2<f32>(-texel.x, 0.0));
+  let lumaE = fxaaLuma(uv + vec2<f32>(texel.x, 0.0));
+  let rangeMin = min(lumaM, min(min(lumaN, lumaS), min(lumaW, lumaE)));
+  let rangeMax = max(lumaM, max(max(lumaN, lumaS), max(lumaW, lumaE)));
+  let range = rangeMax - rangeMin;
+  // Flat neighborhoods pass through untouched (no blur where nothing edges).
+  if (range < max(0.0312, rangeMax * 0.125)) {
+    return vec4<f32>(center, 1.0);
+  }
+  // Canonical FXAA 3.11 console edge terms (first-order axis contrast):
+  // edgeHorz measures the N-S gradient, so a dominant edgeHorz means the
+  // edge spans horizontally and the blend taps go vertical, and vice versa.
+  // (Second-order-only terms vanish on ideal steps and pick no direction.)
+  let edgeHorz = abs((-2.0 * lumaM) + lumaN + lumaS);
+  let edgeVert = abs((-2.0 * lumaM) + lumaW + lumaE);
+  let horzSpan = edgeHorz >= edgeVert;
+  // WGSL has no ternary operator: select(falseValue, trueValue, condition).
+  // textureSampleLevel (explicit LOD) is used for the blend taps because they
+  // sit after the early-out branch: implicit-derivative sampling is illegal
+  // in non-uniform control flow.
+  let blend = select(vec2<f32>(texel.x * 0.5, 0.0), vec2<f32>(0.0, texel.y * 0.5), horzSpan);
+  let tapA = textureSampleLevel(u_source, u_sampler, uv - blend, 0.0).rgb;
+  let tapB = textureSampleLevel(u_source, u_sampler, uv + blend, 0.0).rgb;
+  return vec4<f32>((tapA + tapB) * 0.5, 1.0);
+}
+`;
+}
+//# sourceMappingURL=WebGPUPostShaders.js.map

package/dist/rendering/webgpu/WebGPUPostShaders.js.map

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

package/dist/rendering/webgpu/WebGPUTemporal.d.ts

@@ -0,0 +1,17 @@
+import type { RenderTarget } from "../RenderDevice.js";
+export { temporalAccumulationWeight } from "../TemporalMath.js";
+/** GPU-only temporal contract. All targets use the native top-left UV convention. */
+export interface WebGPUTemporalInputs {
+    readonly velocity: RenderTarget;
+    readonly history: RenderTarget;
+    readonly historyOutput: RenderTarget;
+    readonly historyValid: boolean;
+    readonly historyFrames?: number;
+    readonly blend?: number;
+    readonly depthThreshold?: number;
+}
+export declare function normalizeWebGPUTemporalOptions(options: Pick<WebGPUTemporalInputs, "blend" | "depthThreshold" | "historyFrames">): readonly [number, number];
+export declare const WEBGPU_TAA_FRAGMENT = "\nstruct TemporalUniforms { texel: vec2<f32>, blend: f32, valid: f32, depthThreshold: f32, _pad0: f32, _pad1: f32, _pad2: f32 };\n@group(0) @binding(0) var<uniform> temporal: TemporalUniforms;\n@group(0) @binding(1) var linearSampler: sampler;\n@group(0) @binding(2) var source: texture_2d<f32>;\n@group(0) @binding(3) var velocity: texture_2d<f32>;\n@group(0) @binding(4) var history: texture_2d<f32>;\n@fragment fn fs_taa(@location(0) uv: vec2<f32>) -> @location(0) vec4<f32> {\n  let current = textureSampleLevel(source, linearSampler, uv, 0.0);\n  let dimensions = vec2<i32>(textureDimensions(velocity));\n  let coord = clamp(vec2<i32>(uv * vec2<f32>(dimensions)), vec2<i32>(0), dimensions - vec2<i32>(1));\n  let motion = textureLoad(velocity, coord, 0);\n  let previousUV = uv - motion.rg;\n  let previous = textureSampleLevel(history, linearSampler, previousUV, 0.0);\n  var lo = current.rgb;\n  var hi = current.rgb;\n  for (var y = -1; y <= 1; y = y + 1) {\n    for (var x = -1; x <= 1; x = x + 1) {\n      let neighbor = textureSampleLevel(source, linearSampler, uv + vec2<f32>(f32(x), f32(y)) * temporal.texel, 0.0).rgb;\n      lo = min(lo, neighbor); hi = max(hi, neighbor);\n    }\n  }\n  let inBounds = all(previousUV >= vec2<f32>(0.0)) && all(previousUV <= vec2<f32>(1.0));\n  // Filtered history alpha mixes categorical foreground/background depths.\n  // Validate the actual contributing surfaces instead of a nonexistent\n  // interpolated surface; filtered RGB remains neighborhood-clipped below.\n  let previousBase = vec2<i32>(floor(previousUV * vec2<f32>(dimensions) - vec2<f32>(0.5)));\n  var depthError = 1.0;\n  for (var y = 0; y < 2; y = y + 1) {\n    for (var x = 0; x < 2; x = x + 1) {\n      let tap = clamp(previousBase + vec2<i32>(x, y), vec2<i32>(0), dimensions - vec2<i32>(1));\n      depthError = min(depthError, abs(textureLoad(history, tap, 0).a - motion.a));\n    }\n  }\n  let depthMatches = depthError <= temporal.depthThreshold;\n  let accept = temporal.valid > 0.5 && inBounds && depthMatches;\n  let weight = select(0.0, temporal.blend * 0.90, accept);\n  return vec4<f32>(mix(current.rgb, clamp(previous.rgb, lo, hi), weight), motion.b);\n}";
+/** Separate output restores scene alpha: history alpha contains depth. */
+export declare const WEBGPU_TAA_OUTPUT_FRAGMENT = "\nstruct OutputUniforms { texel: vec2<f32>, _pad: vec2<f32> };\n@group(0) @binding(0) var<uniform> output: OutputUniforms;\n@group(0) @binding(1) var linearSampler: sampler;\n@group(0) @binding(2) var resolved: texture_2d<f32>;\n@group(0) @binding(3) var source: texture_2d<f32>;\n@fragment fn fs_taa_output(@location(0) uv: vec2<f32>) -> @location(0) vec4<f32> {\n  let p = clamp(uv, output.texel * 0.5, vec2<f32>(1.0) - output.texel * 0.5);\n  let current = textureSample(source, linearSampler, p);\n  let accumulated = textureSample(resolved, linearSampler, p);\n  return vec4<f32>(accumulated.rgb, current.a);\n}";
+//# sourceMappingURL=WebGPUTemporal.d.ts.map

package/dist/rendering/webgpu/WebGPUTemporal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WebGPUTemporal.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/webgpu/WebGPUTemporal.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEpD,OAAO,EAAE,0BAA0B,EAAE,MAAM,iBAAiB,CAAC;AAE7D,qFAAqF;AACrF,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC;IAChC,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;IAC/B,QAAQ,CAAC,aAAa,EAAE,YAAY,CAAC;IACrC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;CAClC;AAED,wBAAgB,8BAA8B,CAAC,OAAO,EAAE,IAAI,CAAC,oBAAoB,EAAE,OAAO,GAAG,gBAAgB,GAAG,eAAe,CAAC,GAAG,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAM3J;AAED,eAAO,MAAM,mBAAmB,4oEAsC9B,CAAC;AAEH,0EAA0E;AAC1E,eAAO,MAAM,0BAA0B,6mBAWrC,CAAC"}

package/dist/rendering/webgpu/WebGPUTemporal.js

@@ -0,0 +1,64 @@
+import { temporalAccumulationWeight } from "../TemporalMath.js";
+export { temporalAccumulationWeight } from "../TemporalMath.js";
+export function normalizeWebGPUTemporalOptions(options) {
+    const blend = options.blend ?? 0.9;
+    const depthThreshold = options.depthThreshold ?? 0.01;
+    if (!Number.isFinite(blend) || blend < 0 || blend >= 1)
+        throw new RangeError("TAA blend must be finite in [0, 1)");
+    if (!Number.isFinite(depthThreshold) || depthThreshold <= 0 || depthThreshold > 1)
+        throw new RangeError("TAA depthThreshold must be finite in (0, 1]");
+    return [temporalAccumulationWeight(blend, options.historyFrames), depthThreshold];
+}
+export const WEBGPU_TAA_FRAGMENT = `
+struct TemporalUniforms { texel: vec2<f32>, blend: f32, valid: f32, depthThreshold: f32, _pad0: f32, _pad1: f32, _pad2: f32 };
+@group(0) @binding(0) var<uniform> temporal: TemporalUniforms;
+@group(0) @binding(1) var linearSampler: sampler;
+@group(0) @binding(2) var source: texture_2d<f32>;
+@group(0) @binding(3) var velocity: texture_2d<f32>;
+@group(0) @binding(4) var history: texture_2d<f32>;
+@fragment fn fs_taa(@location(0) uv: vec2<f32>) -> @location(0) vec4<f32> {
+  let current = textureSampleLevel(source, linearSampler, uv, 0.0);
+  let dimensions = vec2<i32>(textureDimensions(velocity));
+  let coord = clamp(vec2<i32>(uv * vec2<f32>(dimensions)), vec2<i32>(0), dimensions - vec2<i32>(1));
+  let motion = textureLoad(velocity, coord, 0);
+  let previousUV = uv - motion.rg;
+  let previous = textureSampleLevel(history, linearSampler, previousUV, 0.0);
+  var lo = current.rgb;
+  var hi = current.rgb;
+  for (var y = -1; y <= 1; y = y + 1) {
+    for (var x = -1; x <= 1; x = x + 1) {
+      let neighbor = textureSampleLevel(source, linearSampler, uv + vec2<f32>(f32(x), f32(y)) * temporal.texel, 0.0).rgb;
+      lo = min(lo, neighbor); hi = max(hi, neighbor);
+    }
+  }
+  let inBounds = all(previousUV >= vec2<f32>(0.0)) && all(previousUV <= vec2<f32>(1.0));
+  // Filtered history alpha mixes categorical foreground/background depths.
+  // Validate the actual contributing surfaces instead of a nonexistent
+  // interpolated surface; filtered RGB remains neighborhood-clipped below.
+  let previousBase = vec2<i32>(floor(previousUV * vec2<f32>(dimensions) - vec2<f32>(0.5)));
+  var depthError = 1.0;
+  for (var y = 0; y < 2; y = y + 1) {
+    for (var x = 0; x < 2; x = x + 1) {
+      let tap = clamp(previousBase + vec2<i32>(x, y), vec2<i32>(0), dimensions - vec2<i32>(1));
+      depthError = min(depthError, abs(textureLoad(history, tap, 0).a - motion.a));
+    }
+  }
+  let depthMatches = depthError <= temporal.depthThreshold;
+  let accept = temporal.valid > 0.5 && inBounds && depthMatches;
+  let weight = select(0.0, temporal.blend * 0.90, accept);
+  return vec4<f32>(mix(current.rgb, clamp(previous.rgb, lo, hi), weight), motion.b);
+}`;
+/** Separate output restores scene alpha: history alpha contains depth. */
+export const WEBGPU_TAA_OUTPUT_FRAGMENT = `
+struct OutputUniforms { texel: vec2<f32>, _pad: vec2<f32> };
+@group(0) @binding(0) var<uniform> output: OutputUniforms;
+@group(0) @binding(1) var linearSampler: sampler;
+@group(0) @binding(2) var resolved: texture_2d<f32>;
+@group(0) @binding(3) var source: texture_2d<f32>;
+@fragment fn fs_taa_output(@location(0) uv: vec2<f32>) -> @location(0) vec4<f32> {
+  let p = clamp(uv, output.texel * 0.5, vec2<f32>(1.0) - output.texel * 0.5);
+  let current = textureSample(source, linearSampler, p);
+  let accumulated = textureSample(resolved, linearSampler, p);
+  return vec4<f32>(accumulated.rgb, current.a);
+}`;
+//# sourceMappingURL=WebGPUTemporal.js.map

package/dist/rendering/webgpu/WebGPUTemporal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WebGPUTemporal.js","sourceRoot":"","sources":["../../../../../packages/rendering/src/webgpu/WebGPUTemporal.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,0BAA0B,EAAE,MAAM,iBAAiB,CAAC;AAC7D,OAAO,EAAE,0BAA0B,EAAE,MAAM,iBAAiB,CAAC;AAa7D,MAAM,UAAU,8BAA8B,CAAC,OAAiF;IAC9H,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,GAAG,CAAC;IACnC,MAAM,cAAc,GAAG,OAAO,CAAC,cAAc,IAAI,IAAI,CAAC;IACtD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,IAAI,KAAK,IAAI,CAAC;QAAE,MAAM,IAAI,UAAU,CAAC,oCAAoC,CAAC,CAAC;IACnH,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,cAAc,CAAC,IAAI,cAAc,IAAI,CAAC,IAAI,cAAc,GAAG,CAAC;QAAE,MAAM,IAAI,UAAU,CAAC,6CAA6C,CAAC,CAAC;IACvJ,OAAO,CAAC,0BAA0B,CAAC,KAAK,EAAE,OAAO,CAAC,aAAa,CAAC,EAAE,cAAc,CAAC,CAAC;AACpF,CAAC;AAED,MAAM,CAAC,MAAM,mBAAmB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAsCjC,CAAC;AAEH,0EAA0E;AAC1E,MAAM,CAAC,MAAM,0BAA0B,GAAG;;;;;;;;;;;EAWxC,CAAC"}

package/dist/rendering/webgpu.d.ts

@@ -22,4 +22,10 @@
  */
 export { WebGPUDevice } from "./WebGPUDevice.js";
 export type { WebGPUAdapterLike, WebGPUBufferDescriptorLike, WebGPUBufferLike, WebGPUDeviceLike, WebGPUDeviceOptions, WebGPULike, WebGPUQueueLike, WebGPUSamplerDescriptorLike } from "./WebGPUDevice.js";
+export { normalizeWebGPUTemporalOptions, WEBGPU_TAA_FRAGMENT, WEBGPU_TAA_OUTPUT_FRAGMENT } from "./webgpu/WebGPUTemporal.js";
+export type { WebGPUTemporalInputs } from "./webgpu/WebGPUTemporal.js";
+export { defaultWebGPUBloomWeights, normalizeWebGPUColorGradeOptions, normalizeWebGPUBloomOptions, normalizeWebGPUBloomQuality, webgpuBloomCompositeFragment, webgpuBlurFragment, webgpuBrightExtractFragment, webgpuColorGradeFragment, webgpuFxaaFragment, webgpuSoftKneeWeight, WEBGPU_BLOOM_MAX_MIPS, WEBGPU_BLOOM_QUALITY_TABLE, WEBGPU_POST_VERTEX_WGSL, } from "./webgpu/WebGPUPostShaders.js";
+export type { NormalizedWebGPUColorGrade, NormalizedWebGPUBloom, WebGPUBloomDiagnostics, WebGPUBloomOptions, WebGPUBloomQuality, WebGPUColorGradeOptions, WebGPUCompositeParams, WebGPUFxaaOptions, } from "./webgpu/WebGPUPostShaders.js";
+export { WebGPUPipelineCache } from "./webgpu/WebGPUPipelineCache.js";
+export { Texture } from "./Texture.js";
 //# sourceMappingURL=webgpu.d.ts.map

package/dist/rendering/webgpu.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"webgpu.d.ts","sourceRoot":"","sources":["../../../../packages/rendering/src/webgpu.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,YAAY,EACV,iBAAiB,EACjB,0BAA0B,EAC1B,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,EACnB,UAAU,EACV,eAAe,EACf,2BAA2B,EAC5B,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"webgpu.d.ts","sourceRoot":"","sources":["../../../../packages/rendering/src/webgpu.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,YAAY,EACV,iBAAiB,EACjB,0BAA0B,EAC1B,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,EACnB,UAAU,EACV,eAAe,EACf,2BAA2B,EAC5B,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,8BAA8B,EAAE,mBAAmB,EAAE,0BAA0B,EAAE,MAAM,yBAAyB,CAAC;AAC1H,YAAY,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAEpE,OAAO,EACL,yBAAyB,EACzB,gCAAgC,EAChC,2BAA2B,EAC3B,2BAA2B,EAC3B,4BAA4B,EAC5B,kBAAkB,EAClB,2BAA2B,EAC3B,wBAAwB,EACxB,kBAAkB,EAClB,oBAAoB,EACpB,qBAAqB,EACrB,0BAA0B,EAC1B,uBAAuB,GACxB,MAAM,4BAA4B,CAAC;AACpC,YAAY,EACV,0BAA0B,EAC1B,qBAAqB,EACrB,sBAAsB,EACtB,kBAAkB,EAClB,kBAAkB,EAClB,uBAAuB,EACvB,qBAAqB,EACrB,iBAAiB,GAClB,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC"}

package/dist/rendering/webgpu.js

@@ -21,4 +21,8 @@
  * `MIGRATION-1.6.md`.
  */
 export { WebGPUDevice } from "./WebGPUDevice.js";
+export { normalizeWebGPUTemporalOptions, WEBGPU_TAA_FRAGMENT, WEBGPU_TAA_OUTPUT_FRAGMENT } from "./webgpu/WebGPUTemporal.js";
+export { defaultWebGPUBloomWeights, normalizeWebGPUColorGradeOptions, normalizeWebGPUBloomOptions, normalizeWebGPUBloomQuality, webgpuBloomCompositeFragment, webgpuBlurFragment, webgpuBrightExtractFragment, webgpuColorGradeFragment, webgpuFxaaFragment, webgpuSoftKneeWeight, WEBGPU_BLOOM_MAX_MIPS, WEBGPU_BLOOM_QUALITY_TABLE, WEBGPU_POST_VERTEX_WGSL, } from "./webgpu/WebGPUPostShaders.js";
+export { WebGPUPipelineCache } from "./webgpu/WebGPUPipelineCache.js";
+export { Texture } from "./Texture.js";
 //# sourceMappingURL=webgpu.js.map

package/dist/rendering/webgpu.js.map

@@ -1 +1 @@
-{"version":3,"file":"webgpu.js","sourceRoot":"","sources":["../../../../packages/rendering/src/webgpu.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"webgpu.js","sourceRoot":"","sources":["../../../../packages/rendering/src/webgpu.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAY9C,OAAO,EAAE,8BAA8B,EAAE,mBAAmB,EAAE,0BAA0B,EAAE,MAAM,yBAAyB,CAAC;AAG1H,OAAO,EACL,yBAAyB,EACzB,gCAAgC,EAChC,2BAA2B,EAC3B,2BAA2B,EAC3B,4BAA4B,EAC5B,kBAAkB,EAClB,2BAA2B,EAC3B,wBAAwB,EACxB,kBAAkB,EAClB,oBAAoB,EACpB,qBAAqB,EACrB,0BAA0B,EAC1B,uBAAuB,GACxB,MAAM,4BAA4B,CAAC;AAYpC,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC"}

package/dist/scene/Scene.d.ts

@@ -20,7 +20,14 @@ export declare class Scene {
     createGroup(options?: Object3DOptions): Group;
     createMesh(options?: MeshOptions): Mesh;
     createSkinnedMesh(options?: MeshOptions): SkinnedMesh;
-    createInstancedMesh(options?: MeshOptions): InstancedMesh;
+    /**
+     * D1 auto-parent option (muse3jsparity-PRD): `{ attach: true }` parents the
+     * new mesh under the scene root (or `attach.parent`); default behavior
+     * (registered only, unparented) is unchanged for compat.
+     */
+    createInstancedMesh(options?: MeshOptions, attach?: boolean | {
+        readonly parent?: SceneNode;
+    }): InstancedMesh;
     createPerspectiveCamera(options?: ConstructorParameters<typeof PerspectiveCamera>[0]): PerspectiveCamera;
     createOrthographicCamera(options?: ConstructorParameters<typeof OrthographicCamera>[0]): OrthographicCamera;
     createLight(kind: "directional", name?: string): DirectionalLight;

package/dist/scene/Scene.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Scene.d.ts","sourceRoot":"","sources":["../../../../packages/scene/src/Scene.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Scene.d.ts","sourceRoot":"","sources":["../../../../packages/scene/src/Scene.ts"],"names":[],"mappings":"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"}

package/dist/scene/Scene.js

@@ -31,8 +31,18 @@ export class Scene {
     createSkinnedMesh(options = {}) {
         return this.register(new SkinnedMesh(options));
     }
-    createInstancedMesh(options = {}) {
-        return this.register(new InstancedMesh(options));
+    /**
+     * D1 auto-parent option (muse3jsparity-PRD): `{ attach: true }` parents the
+     * new mesh under the scene root (or `attach.parent`); default behavior
+     * (registered only, unparented) is unchanged for compat.
+     */
+    createInstancedMesh(options = {}, attach = false) {
+        const mesh = this.register(new InstancedMesh(options));
+        if (attach) {
+            const parent = typeof attach === "object" && attach.parent ? attach.parent : this.root;
+            parent.addChild(mesh);
+        }
+        return mesh;
     }
     createPerspectiveCamera(options = {}) {
         return this.register(new PerspectiveCamera(options));

package/dist/scene/Scene.js.map

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

package/dist/scripting/VisualGraphContext.d.ts

@@ -85,6 +85,32 @@ export interface VisualCameraState {
     readonly position?: VisualVector3;
     readonly targetIds?: readonly string[];
 }
+export interface VisualGameScoreState {
+    readonly id: string;
+    readonly score: number;
+}
+export interface VisualObjectiveState {
+    readonly id: string;
+    readonly status: "active" | "complete" | "failed";
+    readonly progress?: number;
+}
+export interface VisualStateMachineState {
+    readonly id: string;
+    readonly state: string;
+}
+export interface VisualTimerState {
+    readonly id: string;
+    readonly elapsed: number;
+    readonly duration: number;
+    readonly running: boolean;
+}
+export type VisualAiPlanner = "behavior-tree" | "goap" | "htn" | "utility" | "decision-tree" | "perception" | "weapon";
+export interface VisualAiSnapshot {
+    readonly id: string;
+    readonly planner: VisualAiPlanner;
+    readonly status: string;
+    readonly output?: unknown;
+}
 export interface VisualGraphExecutionContext {
     readonly frame?: number;
     readonly time?: number;
@@ -99,6 +125,11 @@ export interface VisualGraphExecutionContext {
     readonly overlaps?: VisualStateCollection<VisualOverlapResult>;
     readonly combatEvents?: readonly VisualCombatEvent[];
     readonly camera?: VisualCameraState;
+    readonly gameScores?: VisualStateCollection<VisualGameScoreState>;
+    readonly objectives?: VisualStateCollection<VisualObjectiveState>;
+    readonly stateMachines?: VisualStateCollection<VisualStateMachineState>;
+    readonly timers?: VisualStateCollection<VisualTimerState>;
+    readonly aiSnapshots?: VisualStateCollection<VisualAiSnapshot>;
     readonly evidence?: Readonly<Record<string, unknown>>;
 }
 export interface VisualGraphValidationOptions {