@aura3d/engine 4.6.2 → 4.7.1

package/dist/rendering/renderer/OutlineTargets.d.ts

@@ -0,0 +1,99 @@
+import type { RenderDevice, RenderTarget } from "../RenderDevice.js";
+import type { RenderItem } from "../ForwardPass.js";
+import type { Texture } from "../Texture.js";
+/** Shader marker of the ink program. */
+export declare const OUTLINE_TARGET_SHADER_MARKER = "@aura3d-shader:gu47_outline_targets";
+export declare const OUTLINE_TARGET_MASK_LABEL = "a3d.gu47.outlineTargetMask";
+/** Widest ring the ink shader samples (the compiler clamps `width` to 1..6 px). */
+export declare const OUTLINE_TARGET_MAX_RADIUS = 6;
+/** Window-space depth slack for the visibility test (the mask and the forward pass rasterize the same geometry). */
+export declare const OUTLINE_TARGET_DEPTH_BIAS = 0.0002;
+/** Mask depth at or above this is "no target" (the mask clears to 1.0). */
+export declare const OUTLINE_TARGET_EMPTY_DEPTH = 0.99999;
+/** The ring offsets the shader and the CPU mirror sample, per radius step: 4 axis and 4 diagonal neighbours. */
+export declare const OUTLINE_TARGET_DIRECTIONS: readonly (readonly [number, number])[];
+/** The renderer's outline options with the GU47 field (`RendererPostProcessOptions.outline`). */
+export interface OutlineTargetOptions {
+    /** Node names whose silhouettes get ink; when present the full-frame luma outline does not run. */
+    readonly targets?: readonly string[];
+    readonly color?: readonly [number, number, number, number];
+    readonly width?: number;
+    readonly opacity?: number;
+}
+/**
+ * The outline's target list, or `null` when the outline is absent or has no `targets` field (today's full-frame
+ * outline). An empty list is a targeted outline with nothing to ink.
+ */
+export declare function outlineTargetsOf(outline: unknown): readonly string[] | null;
+/**
+ * Whether a render item belongs to one of the target nodes. The engine labels scene items
+ * `primitive-<i>:<resource>:<node name>` and model meshes `actor-<i>:mesh-<j>:<model id>:<mesh>...` (the model id is
+ * the node's runtime id, else its asset id). Root render sources (TypedGLBActors through `attachRootRenderSource`) label
+ * items `<actor id>:<node>...`, where the actor id is the target or `<target>-<n>` (for example `ninja-hero-0:Body`);
+ * those match `<target>:` and `<target>-<digits>:` prefixes. Any other item matches only by its exact label.
+ */
+export declare function outlineTargetLabelMatches(label: string | undefined, targets: ReadonlySet<string>): boolean;
+/** The items the mask pass draws: only those whose label names a target. */
+export declare function selectOutlineTargetItems(items: Iterable<RenderItem>, targets: readonly string[]): RenderItem[];
+/**
+ * CPU mirror of the ink shader. `covered` is the visible-target mask (row-major, non-zero = a visible target pixel);
+ * returns 1 where the shader writes ink: pixels outside the mask with a covered pixel at one of the
+ * {@link OUTLINE_TARGET_DIRECTIONS} offsets times 1..`radius`. Out-of-frame samples are not covered.
+ */
+export declare function outlineTargetInkMask(covered: ArrayLike<number>, width: number, height: number, radius: number): Uint8Array;
+/**
+ * CPU mirror of the shader's visibility test: a pixel is a covered target pixel when the mask depth is below
+ * {@link OUTLINE_TARGET_EMPTY_DEPTH} and (with scene depth) not behind the scene surface by more than the bias.
+ */
+export declare function outlineTargetCoverage(maskDepth: ArrayLike<number>, sceneDepth?: ArrayLike<number> | null): Uint8Array;
+/** @internal Ink program sources (GLSL validation in unit tests). */
+export declare const OUTLINE_TARGET_SHADER_SOURCES: {
+    readonly vertex: "#version 300 es\n// @aura3d-shader:gu47_outline_targets\nin vec2 a_position;\nout vec2 v_uv;\nvoid main() { v_uv = a_position * 0.5 + 0.5; gl_Position = vec4(a_position, 0.0, 1.0); }\n";
+    readonly fragment: string;
+};
+export interface OutlineTargetPassInput {
+    /** This frame's render items (the renderer's `postFrameContext.items`). */
+    readonly items: readonly RenderItem[];
+    readonly targets: readonly string[];
+    /** The matrix the forward pass rasterized with. */
+    readonly viewProjectionMatrix: Float32Array | readonly number[];
+    readonly width: number;
+    readonly height: number;
+    /** RGBA 0..255 (the compiler's outline colour). Default the compiler default #ff9822. */
+    readonly color?: readonly [number, number, number, number];
+    /** Ring width in px, 1..6. Default 3. */
+    readonly radius?: number;
+    /** 0..1. Default 0.9. */
+    readonly opacity?: number;
+    /** Resolved scene depth of the forward target; enables the visible-silhouette test. */
+    readonly sceneDepth?: Texture | null;
+    /** Where the ink blends; `null` = the canvas. */
+    readonly output: RenderTarget | null;
+}
+/** What the last targeted outline did (diagnostics and tests). */
+export interface OutlineTargetRecord {
+    readonly targets: readonly string[];
+    /** Labels of the items the mask pass drew, in draw order. */
+    readonly maskItems: readonly string[];
+    /** True when the ink draw ran (there was at least one target item). */
+    readonly inked: boolean;
+    readonly occlusion: "scene-depth" | "none";
+    readonly radius: number;
+}
+/** The last targeted outline this process ran, or `null`. */
+export declare function lastOutlineTargetRecord(): OutlineTargetRecord | null;
+/** Test hook. */
+export declare function resetOutlineTargetRecord(): void;
+/** The mask target, the ink program and the fullscreen triangle, kept per device across frames. */
+export declare class OutlineTargetPass {
+    private readonly device;
+    private mask;
+    private program;
+    private triangle;
+    constructor(device: RenderDevice);
+    execute(input: OutlineTargetPassInput): OutlineTargetRecord;
+    dispose(): void;
+}
+/** The per-device pass (one mask target and program per device). */
+export declare function outlineTargetPassFor(device: RenderDevice): OutlineTargetPass;
+//# sourceMappingURL=OutlineTargets.d.ts.map

package/dist/rendering/renderer/OutlineTargets.d.ts.map

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

package/dist/rendering/renderer/OutlineTargets.js

@@ -0,0 +1,286 @@
+// GU47 E-E (WP-5): `effects.outline({ targets })` — only the named nodes' silhouettes get ink.
+//
+// Design (no ForwardPass edit): after the post chain has written the final image, a cheap mask pass draws ONLY the
+// target items through the PRD-02 camera depth program (`DepthPass` with the caster-variant resolver, so skinned,
+// instanced and `castShadow` custom-vertex targets keep their real silhouette) into a private depth texture: the target
+// mask (1.0 = no target). A fullscreen ink draw then blends the outline colour onto the output on the pixels just
+// outside the mask (a ring `width` px wide). With the scene depth bound, a target pixel hidden behind other geometry
+// does not count as covered, so only the visible silhouette is inked; without it the ring is drawn x-ray style.
+// Scenes whose outline has no `targets` never reach this file: their full-frame luma outline is unchanged.
+import { TextureBinding } from "../TextureBinding.js";
+import { Sampler } from "../Sampler.js";
+import { VertexFormat } from "../VertexFormat.js";
+import { DepthPass } from "../DepthPass.js";
+import { createLeanCoreShaderLibrary } from "../ShaderLibraryCore.js";
+import { prd02DepthFeatures, registerPrd02DepthShader, resolvePrd02ShadowCasterVariant } from "../shadows/Prd02DepthShaderLibrary.js";
+import { QUALITY_TIERS } from "../contracts/quality.js";
+import { rendererQrFlags } from "./FrameGraph.js";
+/** Shader marker of the ink program. */
+export const OUTLINE_TARGET_SHADER_MARKER = "@aura3d-shader:gu47_outline_targets";
+export const OUTLINE_TARGET_MASK_LABEL = "a3d.gu47.outlineTargetMask";
+/** Widest ring the ink shader samples (the compiler clamps `width` to 1..6 px). */
+export const OUTLINE_TARGET_MAX_RADIUS = 6;
+/** Window-space depth slack for the visibility test (the mask and the forward pass rasterize the same geometry). */
+export const OUTLINE_TARGET_DEPTH_BIAS = 2e-4;
+/** Mask depth at or above this is "no target" (the mask clears to 1.0). */
+export const OUTLINE_TARGET_EMPTY_DEPTH = 0.99999;
+/** The ring offsets the shader and the CPU mirror sample, per radius step: 4 axis and 4 diagonal neighbours. */
+export const OUTLINE_TARGET_DIRECTIONS = [
+    [1, 0], [-1, 0], [0, 1], [0, -1], [1, 1], [-1, 1], [1, -1], [-1, -1]
+];
+/**
+ * The outline's target list, or `null` when the outline is absent or has no `targets` field (today's full-frame
+ * outline). An empty list is a targeted outline with nothing to ink.
+ */
+export function outlineTargetsOf(outline) {
+    if (outline === null || typeof outline !== "object")
+        return null;
+    const targets = outline.targets;
+    if (!Array.isArray(targets))
+        return null;
+    return targets.filter((name) => typeof name === "string" && name.length > 0);
+}
+/**
+ * Whether a render item belongs to one of the target nodes. The engine labels scene items
+ * `primitive-<i>:<resource>:<node name>` and model meshes `actor-<i>:mesh-<j>:<model id>:<mesh>...` (the model id is
+ * the node's runtime id, else its asset id). Root render sources (TypedGLBActors through `attachRootRenderSource`) label
+ * items `<actor id>:<node>...`, where the actor id is the target or `<target>-<n>` (for example `ninja-hero-0:Body`);
+ * those match `<target>:` and `<target>-<digits>:` prefixes. Any other item matches only by its exact label.
+ */
+export function outlineTargetLabelMatches(label, targets) {
+    if (!label || targets.size === 0)
+        return false;
+    if (targets.has(label))
+        return true;
+    const actor = /^actor-\d+:mesh-\d+:(.*)$/.exec(label);
+    if (actor) {
+        const rest = actor[1];
+        for (const target of targets)
+            if (rest === target || rest.startsWith(`${target}:`))
+                return true;
+        return false;
+    }
+    if (/^primitive-\d+:/.test(label)) {
+        for (const target of targets)
+            if (label.endsWith(`:${target}`))
+                return true;
+        return false;
+    }
+    for (const target of targets) {
+        if (label.startsWith(`${target}:`))
+            return true;
+        if (label.startsWith(`${target}-`) && /^\d+:/.test(label.slice(target.length + 1)))
+            return true;
+    }
+    return false;
+}
+/** The items the mask pass draws: only those whose label names a target. */
+export function selectOutlineTargetItems(items, targets) {
+    const set = new Set(targets);
+    const out = [];
+    if (set.size === 0)
+        return out;
+    for (const item of items)
+        if (outlineTargetLabelMatches(item.label, set))
+            out.push(item);
+    return out;
+}
+/**
+ * CPU mirror of the ink shader. `covered` is the visible-target mask (row-major, non-zero = a visible target pixel);
+ * returns 1 where the shader writes ink: pixels outside the mask with a covered pixel at one of the
+ * {@link OUTLINE_TARGET_DIRECTIONS} offsets times 1..`radius`. Out-of-frame samples are not covered.
+ */
+export function outlineTargetInkMask(covered, width, height, radius) {
+    const r = Math.max(1, Math.min(OUTLINE_TARGET_MAX_RADIUS, Math.round(radius)));
+    const ink = new Uint8Array(width * height);
+    const at = (x, y) => x >= 0 && y >= 0 && x < width && y < height && (covered[y * width + x] ?? 0) !== 0;
+    for (let y = 0; y < height; y += 1) {
+        for (let x = 0; x < width; x += 1) {
+            if (at(x, y))
+                continue;
+            search: for (let step = 1; step <= r; step += 1) {
+                for (const [dx, dy] of OUTLINE_TARGET_DIRECTIONS) {
+                    if (at(x + dx * step, y + dy * step)) {
+                        ink[y * width + x] = 1;
+                        break search;
+                    }
+                }
+            }
+        }
+    }
+    return ink;
+}
+/**
+ * CPU mirror of the shader's visibility test: a pixel is a covered target pixel when the mask depth is below
+ * {@link OUTLINE_TARGET_EMPTY_DEPTH} and (with scene depth) not behind the scene surface by more than the bias.
+ */
+export function outlineTargetCoverage(maskDepth, sceneDepth) {
+    const out = new Uint8Array(maskDepth.length);
+    for (let i = 0; i < maskDepth.length; i += 1) {
+        const d = maskDepth[i] ?? 1;
+        if (d >= OUTLINE_TARGET_EMPTY_DEPTH)
+            continue;
+        if (sceneDepth && d > (sceneDepth[i] ?? 1) + OUTLINE_TARGET_DEPTH_BIAS)
+            continue;
+        out[i] = 1;
+    }
+    return out;
+}
+const FULLSCREEN_VERT = /* glsl */ `#version 300 es
+// ${OUTLINE_TARGET_SHADER_MARKER}
+in vec2 a_position;
+out vec2 v_uv;
+void main() { v_uv = a_position * 0.5 + 0.5; gl_Position = vec4(a_position, 0.0, 1.0); }
+`;
+const DIRECTIONS_GLSL = OUTLINE_TARGET_DIRECTIONS.map(([x, y]) => `vec2(${x.toFixed(1)}, ${y.toFixed(1)})`).join(", ");
+const INK_FRAGMENT = /* glsl */ `#version 300 es
+// ${OUTLINE_TARGET_SHADER_MARKER}
+precision highp float;
+in vec2 v_uv;
+uniform sampler2D u_outlineMask;
+uniform sampler2D u_outlineScene;
+uniform vec4 u_outlineColor;
+uniform vec4 u_outlineParams;
+uniform vec2 u_outlineTexel;
+layout(location = 0) out vec4 o_color;
+const vec2 OUTLINE_DIRS[8] = vec2[8](${DIRECTIONS_GLSL});
+bool coveredAt(vec2 uv) {
+  if (uv.x < 0.0 || uv.y < 0.0 || uv.x > 1.0 || uv.y > 1.0) return false;
+  float d = texture(u_outlineMask, uv).r;
+  if (d >= ${OUTLINE_TARGET_EMPTY_DEPTH.toFixed(5)}) return false;
+  return u_outlineParams.z < 0.5 || d <= texture(u_outlineScene, uv).r + u_outlineParams.y;
+}
+void main() {
+  if (coveredAt(v_uv)) discard;
+  for (int step = 1; step <= ${OUTLINE_TARGET_MAX_RADIUS}; step++) {
+    if (float(step) > u_outlineParams.x) break;
+    for (int k = 0; k < 8; k++) {
+      if (coveredAt(v_uv + OUTLINE_DIRS[k] * float(step) * u_outlineTexel)) {
+        o_color = u_outlineColor;
+        return;
+      }
+    }
+  }
+  discard;
+}
+`;
+/** @internal Ink program sources (GLSL validation in unit tests). */
+export const OUTLINE_TARGET_SHADER_SOURCES = { vertex: FULLSCREEN_VERT, fragment: INK_FRAGMENT };
+let lastRecord = null;
+/** The last targeted outline this process ran, or `null`. */
+export function lastOutlineTargetRecord() {
+    return lastRecord;
+}
+/** Test hook. */
+export function resetOutlineTargetRecord() {
+    lastRecord = null;
+}
+const depthLibraries = new WeakMap();
+function depthLibraryFor(device) {
+    let library = depthLibraries.get(device);
+    if (!library) {
+        library = createLeanCoreShaderLibrary();
+        registerPrd02DepthShader(library);
+        depthLibraries.set(device, library);
+    }
+    return library;
+}
+const NEAREST = () => new Sampler({ minFilter: "nearest", magFilter: "nearest", addressU: "clamp-to-edge", addressV: "clamp-to-edge" });
+/** The mask target, the ink program and the fullscreen triangle, kept per device across frames. */
+export class OutlineTargetPass {
+    device;
+    mask = null;
+    program = null;
+    triangle = null;
+    constructor(device) {
+        this.device = device;
+    }
+    execute(input) {
+        const device = this.device;
+        const radius = Math.max(1, Math.min(OUTLINE_TARGET_MAX_RADIUS, Math.round(input.radius ?? 3)));
+        const targetItems = selectOutlineTargetItems(input.items, input.targets);
+        const sceneDepth = input.sceneDepth ?? null;
+        const record = {
+            targets: [...input.targets],
+            maskItems: targetItems.map((item) => item.label ?? "item"),
+            inked: targetItems.length > 0,
+            occlusion: sceneDepth ? "scene-depth" : "none",
+            radius
+        };
+        lastRecord = record;
+        if (targetItems.length === 0)
+            return record;
+        const previous = device.getRenderTarget?.() ?? null;
+        const width = Math.max(1, Math.floor(input.width));
+        const height = Math.max(1, Math.floor(input.height));
+        if (!this.mask || this.mask.disposed || this.mask.width !== width || this.mask.height !== height) {
+            this.mask?.dispose();
+            this.mask = device.createRenderTarget({ width, height, format: "rgba8", depth: "texture", label: OUTLINE_TARGET_MASK_LABEL });
+        }
+        const context = { device, width, height };
+        try {
+            device.setRenderTarget(this.mask);
+            device.clear([0, 0, 0, 0]);
+            const features = prd02DepthFeatures();
+            const flags = rendererQrFlags();
+            new DepthPass({
+                casters: targetItems,
+                viewProjectionMatrix: input.viewProjectionMatrix,
+                shaderLibrary: depthLibraryFor(device),
+                variantResolver: (item) => resolvePrd02ShadowCasterVariant(item, flags, QUALITY_TIERS.high, features),
+                depthVariantFeatures: features
+            }).execute(context);
+            const maskDepth = this.mask.depthTexture;
+            if (!maskDepth)
+                return { ...record, inked: false };
+            this.program ??= device.createShaderProgram({
+                label: "a3d_gu47_outline_targets",
+                marker: OUTLINE_TARGET_SHADER_MARKER,
+                vertex: FULLSCREEN_VERT,
+                fragment: INK_FRAGMENT
+            });
+            this.triangle ??= device.createBuffer("vertex", 24, new Float32Array([-1, -1, 3, -1, -1, 3]));
+            const color = input.color ?? [255, 152, 34, 255];
+            const opacity = Math.max(0, Math.min(1, input.opacity ?? 0.9)) * ((color[3] ?? 255) / 255);
+            device.setRenderTarget(input.output);
+            device.draw({
+                label: "gu47-outline-targets-ink",
+                topology: "triangles",
+                vertexBuffer: this.triangle,
+                vertexFormat: new VertexFormat([{ semantic: "position", components: 2, offset: 0 }], 8),
+                vertexCount: 3,
+                renderState: { depthTest: false, depthWrite: false, cullMode: "none", blend: true, depthCompare: "always" },
+                shader: this.program,
+                uniforms: new Map([
+                    ["u_outlineMask", new TextureBinding({ name: "u_outlineMask", texture: maskDepth, sampler: NEAREST() })],
+                    ["u_outlineScene", new TextureBinding({ name: "u_outlineScene", texture: sceneDepth ?? maskDepth, sampler: NEAREST() })],
+                    ["u_outlineColor", [color[0] / 255, color[1] / 255, color[2] / 255, opacity]],
+                    ["u_outlineParams", [radius, OUTLINE_TARGET_DEPTH_BIAS, sceneDepth ? 1 : 0, 0]],
+                    ["u_outlineTexel", [1 / width, 1 / height]]
+                ])
+            });
+            return record;
+        }
+        finally {
+            device.setRenderTarget(previous);
+        }
+    }
+    dispose() {
+        this.mask?.dispose();
+        this.mask = null;
+        this.triangle?.dispose();
+        this.triangle = null;
+        this.program = null;
+    }
+}
+const passes = new WeakMap();
+/** The per-device pass (one mask target and program per device). */
+export function outlineTargetPassFor(device) {
+    let pass = passes.get(device);
+    if (!pass) {
+        pass = new OutlineTargetPass(device);
+        passes.set(device, pass);
+    }
+    return pass;
+}
+//# sourceMappingURL=OutlineTargets.js.map

package/dist/rendering/renderer/OutlineTargets.js.map

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

package/dist/rendering/renderer/PostprocessExecution.d.ts

@@ -69,6 +69,11 @@ export declare class RendererPostprocessPipeline {
      */
     private tryExecutePostGraphV2;
     executePostprocess(postprocess: RendererPostProcessOptions, ownedTargets: RenderTarget[], outputTarget?: RenderTarget): void;
+    /**
+     * GU47 E-E: the targeted outline pass (`OutlineTargets.ts`): a mask of only the target items, then a ring of the
+     * outline colour `width` px wide around the mask's visible silhouette, blended onto the final output.
+     */
+    private executeOutlineTargets;
     private executePostprocessChain;
     private executeFusedLdrPostprocess;
     executePostprocessAsync(postprocess: RendererPostProcessOptions, ownedTargets: RenderTarget[], outputTarget?: RenderTarget): Promise<void>;

package/dist/rendering/renderer/PostprocessExecution.d.ts.map

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

package/dist/rendering/renderer/PostprocessExecution.js

@@ -7,7 +7,9 @@ import { isIterable } from "./RenderShared.js";
 import { rendererQrFlags } from "./FrameGraph.js";
 import { qrCoreOutputOn } from "./qrSubFlags.js";
 import { Scene } from "../../scene/index.js";
+import { registeredPostPasses } from "../contracts/post.js";
 import { webgl2DeviceHost } from "../webgl2/Counters.js";
+import { outlineTargetPassFor, outlineTargetsOf } from "./OutlineTargets.js";
 import { executePostGraphWebGL2 } from "../webgl2/LegacyPost.js";
 import { recordPostSkipped } from "./postSkipped.js";
 import { guardPostprocessPlan } from "../quality/PostprocessGuard.js";
@@ -178,8 +180,16 @@ function withRendererDepth(options, depth) {
 function isHdrRenderTarget(target) {
     return target.colorTexture.format === "rgba16f" || target.colorTexture.format === "rgba32f";
 }
+/** GU47 E-E: the chain's options without the outline (a targeted outline runs after the chain instead). */
+function withoutOutline(postprocess) {
+    const { outline: _outline, ...rest } = postprocess;
+    return rest;
+}
 export function postprocessRequiresDepthTexture(postprocess) {
-    return Boolean((postprocess.volumetricLight && !postprocess.volumetricLight.depth) ||
+    return Boolean(
+    // GU47 E-E: a targeted outline tests its mask against scene depth so hidden target pixels get no ink.
+    outlineTargetsOf(postprocess.outline) !== null ||
+        (postprocess.volumetricLight && !postprocess.volumetricLight.depth) ||
         (postprocess.depthOfField && !postprocess.depthOfField.depth) ||
         (postprocess.contactShadow && !postprocess.contactShadow.depth) ||
         (postprocess.ssao && !postprocess.ssao.depth) ||
@@ -187,7 +197,7 @@ export function postprocessRequiresDepthTexture(postprocess) {
         // PRD-03 §6.9: on the v2 route the legacy fields are not populated — the
         // depth-needing stages (S1 depth-prep feeding S2 GTAO / S4 god rays /
         // Phase-4 DOF+motion blur+SSR) live on the pipeline bag instead.
-        (postprocess.v2 === true && v2PipelineNeedsDepth(postprocess.pipeline)));
+        (postprocess.v2 === true && (v2PipelineNeedsDepth(postprocess.pipeline) || v2CustomPassesNeedDepth(postprocess.pipeline))));
 }
 function v2PipelineNeedsDepth(pipeline) {
     if (pipeline === null || typeof pipeline !== "object")
@@ -197,6 +207,19 @@ function v2PipelineNeedsDepth(pipeline) {
     // camera velocity — the depth attachment is required on the forward target.
     return Boolean(bag.ao ?? bag.godRays ?? bag.dof ?? bag.motionBlur ?? bag.ssr ?? bag.taa) || bag.antiAliasing === "taa";
 }
+/**
+ * GU47 phase 2: a C-13 custom pass that declares a `depth` input (`effects.toon({ inkSource: "depth" })`,
+ * `effects.shaderPass({ inputs: ["color", "depth"] })`) reads the scene depth: the HDR anchors bind the S1 linear depth,
+ * the after-tonemap tail linearises `sceneDepth`. Both come from the forward target's depth texture, which only the
+ * effects above used to request, so in a scene whose only depth reader was the custom pass the HDR driver skipped every
+ * stage (`WEBGL_LDR_POSTPROCESS_DEPTH_REQUIRED`) and the tail bound no depth. Same pass set as the v2 driver reads
+ * (`mergedCustomPasses`: the pipeline bag, then the page registry `app.post.addPostPass` fills).
+ */
+function v2CustomPassesNeedDepth(pipeline) {
+    const bag = pipeline !== null && typeof pipeline === "object" ? pipeline.customPasses : undefined;
+    const wantsDepth = (pass) => pass.inputs.includes("depth");
+    return Boolean(bag?.some(wantsDepth)) || registeredPostPasses().some(wantsDepth);
+}
 export function defaultPostprocessTargetFormat(device, postprocess) {
     if (postprocess.toneMapping === false)
         return "rgba8";
@@ -330,13 +353,52 @@ export class RendererPostprocessPipeline {
     }
     executePostprocess(postprocess, ownedTargets, outputTarget) {
         const pooled = qrTiersOn() ? [] : null;
+        // GU47 E-E: an outline with `targets` inks only those nodes' silhouettes, so the chain runs without the
+        // full-frame luma outline and the target ink blends onto the chain's output afterwards. No `targets`: unchanged.
+        const outlineTargets = outlineTargetsOf(postprocess.outline);
         try {
-            this.executePostprocessChain(postprocess, ownedTargets, outputTarget, pooled);
+            this.executePostprocessChain(outlineTargets ? withoutOutline(postprocess) : postprocess, ownedTargets, outputTarget, pooled);
+            if (outlineTargets)
+                this.executeOutlineTargets(postprocess, outlineTargets, ownedTargets[0], outputTarget);
         }
         finally {
             this.releaseChainTargets(pooled);
         }
     }
+    /**
+     * GU47 E-E: the targeted outline pass (`OutlineTargets.ts`): a mask of only the target items, then a ring of the
+     * outline colour `width` px wide around the mask's visible silhouette, blended onto the final output.
+     */
+    executeOutlineTargets(postprocess, targets, forwardTarget, outputTarget) {
+        const device = this.host.device;
+        if (device.kind === "webgpu") {
+            recordPostSkipped("OUTLINE_TARGETS_WEBGL2_ONLY");
+            return;
+        }
+        const frame = postprocess.postFrameContext;
+        const viewProjection = postprocess.cameraFrame?.viewProjectionMatrix;
+        if (!frame || !viewProjection) {
+            recordPostSkipped("OUTLINE_TARGETS_FRAME_CONTEXT_MISSING");
+            return;
+        }
+        const sceneDepth = frame.sceneDepth.available ? frame.sceneDepth.texture : null;
+        // The forward target may be multisampled; its depth texture holds resolved depth only after the blit.
+        if (sceneDepth && forwardTarget)
+            webgl2DeviceHost(device)?.resolveMultisampleTarget(forwardTarget);
+        const outline = (typeof postprocess.outline === "object" ? postprocess.outline : {});
+        outlineTargetPassFor(device).execute({
+            items: frame.items,
+            targets,
+            viewProjectionMatrix: viewProjection,
+            width: this.host.width,
+            height: this.host.height,
+            ...(outline.color ? { color: outline.color } : {}),
+            ...(outline.width !== undefined ? { radius: outline.width } : {}),
+            ...(outline.opacity !== undefined ? { opacity: outline.opacity } : {}),
+            sceneDepth,
+            output: outputTarget ?? null
+        });
+    }
     executePostprocessChain(postprocess, ownedTargets, outputTarget, pooled) {
         const forwardTarget = ownedTargets[0];
         let current = forwardTarget;
@@ -469,8 +531,12 @@ export class RendererPostprocessPipeline {
     }
     async executePostprocessAsync(postprocess, ownedTargets, outputTarget) {
         const pooled = qrTiersOn() ? [] : null;
+        // GU47 E-E: same targeted-outline split as `executePostprocess`.
+        const outlineTargets = outlineTargetsOf(postprocess.outline);
         try {
-            await this.executePostprocessChainAsync(postprocess, ownedTargets, outputTarget, pooled);
+            await this.executePostprocessChainAsync(outlineTargets ? withoutOutline(postprocess) : postprocess, ownedTargets, outputTarget, pooled);
+            if (outlineTargets && !this.host.device.disposed)
+                this.executeOutlineTargets(postprocess, outlineTargets, ownedTargets[0], outputTarget);
         }
         finally {
             this.releaseChainTargets(pooled);