@pibbl/core 0.0.2 → 0.0.3-alpha.109.1

package/dist/filters/emboss.js

@@ -0,0 +1,104 @@
+import { isSignal } from "../lib/signals/graph.js";
+import { layoutDiagnostic } from "../lib/style/diagnostics.js";
+import {
+  PIBBL_FILTER_EXECUTOR
+} from "../lib/style/filter-types.js";
+import {
+  borrowTextureRaster,
+  validateTexturePaint
+} from "../lib/textures/texture-protocol.js";
+import {
+  filterBoundaryExecutor
+} from "./filter-executor.js";
+import { processEmboss } from "./render-emboss-boundary.js";
+const definitions = /* @__PURE__ */ new WeakMap();
+const executor = {
+  prepare(value, property, context) {
+    const definition = definitions.get(value);
+    if (!definition)
+      throw new Error(
+        "An emboss filter was created by an incompatible Pibbl runtime."
+      );
+    const { options } = definition;
+    const fail = (key, value2, reason) => layoutDiagnostic({
+      component: context.component,
+      property: `${property}.${key}`,
+      value: value2,
+      algorithm: context.algorithm,
+      constraints: context.constraints,
+      reason
+    });
+    const numeric = (key, fallback, maximum) => {
+      const input = options[key];
+      const value2 = input === void 0 ? fallback : isSignal(input) ? input.get() : input;
+      if (typeof value2 !== "number" || !Number.isFinite(value2) || value2 < 0 || value2 > maximum)
+        throw fail(key, value2, `must be finite within 0..${maximum}`);
+      return value2;
+    };
+    const depth = numeric("depth", 3, 32), strength = numeric("strength", 1, 1);
+    const direction = options.direction ?? [-0.6, -0.8];
+    if (!Array.isArray(direction) || direction.length !== 2 || !direction.every(
+      (value2) => typeof value2 === "number" && Number.isFinite(value2)
+    ) || Math.hypot(...direction) === 0)
+      throw fail(
+        "direction",
+        direction,
+        "must contain two finite components with nonzero length"
+      );
+    const length = Math.hypot(...direction);
+    const candidate = options.region;
+    if (!candidate || typeof candidate !== "object")
+      throw fail(
+        "region",
+        candidate,
+        "must contain finite coordinates and positive dimensions"
+      );
+    const { x, y, width, height } = candidate;
+    if (!(typeof x === "number" && Number.isFinite(x) && typeof y === "number" && Number.isFinite(y) && typeof width === "number" && Number.isFinite(width) && typeof height === "number" && Number.isFinite(height)) || width <= 0 || height <= 0)
+      throw fail(
+        "region",
+        candidate,
+        "must contain finite coordinates and positive dimensions"
+      );
+    const region = { x, y, width, height };
+    const map = isSignal(definition.map) ? definition.map.get() : definition.map;
+    try {
+      validateTexturePaint(map);
+      if (strength !== 0 && depth !== 0)
+        borrowTextureRaster(map, () => void 0);
+    } catch (error) {
+      throw fail(
+        "map",
+        map,
+        error instanceof Error ? error.message : String(error)
+      );
+    }
+    const settings = {
+      opacity: strength,
+      depth,
+      threshold: 0,
+      softness: 1,
+      direction: [direction[0] / length, direction[1] / length]
+    };
+    return Object.freeze({
+      executor: filterBoundaryExecutor,
+      reverseInfluence: (output) => ({ ...output }),
+      process: strength === 0 || depth === 0 ? void 0 : (source, windows) => processEmboss(source, windows, map, settings, region)
+    });
+  },
+  render: filterBoundaryExecutor.render
+};
+function emboss(map, options) {
+  const frozen = Object.freeze({
+    ...options,
+    region: Object.freeze({ ...options.region }),
+    direction: options.direction && Object.freeze([...options.direction])
+  });
+  const value = Object.freeze({ [PIBBL_FILTER_EXECUTOR]: executor });
+  definitions.set(value, { map, options: frozen });
+  return value;
+}
+export {
+  emboss
+};
+//# sourceMappingURL=emboss.js.map

package/dist/filters/emboss.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/filters/emboss.ts"],
+  "sourcesContent": ["import { isSignal } from \"../lib/signals/graph.js\";\nimport type { SignalValue } from \"../lib/signals/types.js\";\nimport { layoutDiagnostic } from \"../lib/style/diagnostics.js\";\nimport {\n  PIBBL_FILTER_EXECUTOR,\n  type PibblFilter,\n  type PibblFilterExecutor,\n} from \"../lib/style/filter-types.js\";\nimport {\n  borrowTextureRaster,\n  validateTexturePaint,\n  type TexturePaint,\n} from \"../lib/textures/texture-protocol.js\";\nimport {\n  filterBoundaryExecutor,\n  type CustomPreparedFilter,\n} from \"./filter-executor.js\";\nimport { processEmboss } from \"./render-emboss-boundary.js\";\n\n/** Directional lighting of grayscale texture height. See {@link emboss}. */\nexport interface PibblEmbossFilterOptions {\n  /** Local texture placement region with finite coordinates and positive dimensions. See {@link TexturePaint}. */\n  readonly region: Readonly<{\n    /** Horizontal origin in local logical coordinates. See {@link PibblEmbossFilterOptions}. */\n    x: number;\n    /** Vertical origin in local logical coordinates. See {@link PibblEmbossFilterOptions}. */\n    y: number;\n    /** Positive logical region width. See {@link PibblEmbossFilterOptions}. */\n    width: number;\n    /** Positive logical region height. See {@link PibblEmbossFilterOptions}. */\n    height: number;\n  }>;\n  /** Height range in logical pixels, finite 0\u201332; default 3. See {@link emboss}. */\n  readonly depth?: SignalValue<number>;\n  /** Lighting strength, finite 0\u20131; default 1. Zero bypasses processing. See {@link emboss}. */\n  readonly strength?: SignalValue<number>;\n  /** Nonzero finite direction toward the light in local coordinates; default [-0.6, -0.8]. See {@link emboss}. */\n  readonly direction?: readonly [number, number];\n}\nconst definitions = new WeakMap<\n  PibblFilter,\n  {\n    map: SignalValue<TexturePaint>;\n    options: Readonly<PibblEmbossFilterOptions>;\n  }\n>();\nconst executor: PibblFilterExecutor = {\n  prepare(value, property, context) {\n    const definition = definitions.get(value);\n    if (!definition)\n      throw new Error(\n        \"An emboss filter was created by an incompatible Pibbl runtime.\",\n      );\n    const { options } = definition;\n    const fail = (key: string, value: unknown, reason: string) =>\n      layoutDiagnostic({\n        component: context.component,\n        property: `${property}.${key}`,\n        value,\n        algorithm: context.algorithm,\n        constraints: context.constraints,\n        reason,\n      });\n    const numeric = (\n      key: \"depth\" | \"strength\",\n      fallback: number,\n      maximum: number,\n    ) => {\n      const input = options[key];\n      const value =\n        input === undefined ? fallback : isSignal(input) ? input.get() : input;\n      if (\n        typeof value !== \"number\" ||\n        !Number.isFinite(value) ||\n        value < 0 ||\n        value > maximum\n      )\n        throw fail(key, value, `must be finite within 0..${maximum}`);\n      return value;\n    };\n    const depth = numeric(\"depth\", 3, 32),\n      strength = numeric(\"strength\", 1, 1);\n    const direction: unknown = options.direction ?? [-0.6, -0.8];\n    if (\n      !Array.isArray(direction) ||\n      direction.length !== 2 ||\n      !direction.every(\n        (value) => typeof value === \"number\" && Number.isFinite(value),\n      ) ||\n      Math.hypot(...direction) === 0\n    )\n      throw fail(\n        \"direction\",\n        direction,\n        \"must contain two finite components with nonzero length\",\n      );\n    const length = Math.hypot(...direction);\n    const candidate: unknown = options.region;\n    if (!candidate || typeof candidate !== \"object\")\n      throw fail(\n        \"region\",\n        candidate,\n        \"must contain finite coordinates and positive dimensions\",\n      );\n    const { x, y, width, height } = candidate as {\n      x: number;\n      y: number;\n      width: number;\n      height: number;\n    };\n    if (\n      !(\n        typeof x === \"number\" &&\n        Number.isFinite(x) &&\n        typeof y === \"number\" &&\n        Number.isFinite(y) &&\n        typeof width === \"number\" &&\n        Number.isFinite(width) &&\n        typeof height === \"number\" &&\n        Number.isFinite(height)\n      ) ||\n      width <= 0 ||\n      height <= 0\n    )\n      throw fail(\n        \"region\",\n        candidate,\n        \"must contain finite coordinates and positive dimensions\",\n      );\n    const region = { x, y, width, height };\n    const map = isSignal(definition.map)\n      ? definition.map.get()\n      : definition.map;\n    try {\n      validateTexturePaint(map);\n      if (strength !== 0 && depth !== 0)\n        borrowTextureRaster(map, () => undefined);\n    } catch (error) {\n      throw fail(\n        \"map\",\n        map,\n        error instanceof Error ? error.message : String(error),\n      );\n    }\n    const settings = {\n      opacity: strength,\n      depth,\n      threshold: 0,\n      softness: 1,\n      direction: [direction[0] / length, direction[1] / length] as const,\n    };\n    return Object.freeze({\n      executor: filterBoundaryExecutor,\n      reverseInfluence: (output) => ({ ...output }),\n      process:\n        strength === 0 || depth === 0\n          ? undefined\n          : (source, windows) =>\n              processEmboss(source, windows, map, settings, region),\n    } satisfies CustomPreparedFilter);\n  },\n  render: filterBoundaryExecutor.render,\n};\n/**\n * Lights captured pixels using normals derived from a grayscale texture height map.\n * Flat heights are neutral; opposing slopes brighten and darken without changing alpha or geometry.\n * @param map - Mounted height texture, luminance times alpha; white is high. See {@link TexturePaint}.\n * @param options - Local placement, height depth, strength, and light direction. See {@link PibblEmbossFilterOptions}.\n * @returns A filter descriptor for style.filter. See {@link PibblFilter}.\n * @see {@link PibblEmbossFilterOptions}\n */\nexport function emboss(\n  map: SignalValue<TexturePaint>,\n  options: PibblEmbossFilterOptions,\n): PibblFilter {\n  const frozen = Object.freeze({\n    ...options,\n    region: Object.freeze({ ...options.region }),\n    direction:\n      options.direction &&\n      (Object.freeze([...options.direction]) as readonly [number, number]),\n  });\n  const value = Object.freeze({ [PIBBL_FILTER_EXECUTOR]: executor });\n  definitions.set(value, { map, options: frozen });\n  return value;\n}\n"],
+  "mappings": "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",
+  "names": ["value"]
+}

package/dist/filters/filter-executor.d.ts

@@ -1,6 +1,12 @@
-import type { TexturePaint } from '../lib/textures/texture-protocol.js';
-import type { FilterWindows, PixelBounds } from '../lib/filter/filter-region.js';
-import type { PibblFilterBoundaryExecutor, PreparedPibblFilter } from '../lib/style/filter-types.js';
+import type { TexturePaint } from "../lib/textures/texture-protocol.js";
+import type { Canvas } from "../lib/types.js";
+import type { FilterWindows, PixelBounds } from "../lib/filter/filter-region.js";
+import type { PibblFilterBoundaryExecutor, PreparedPibblFilter } from "../lib/style/filter-types.js";
+/** Backing-pixel projection of the already-painted current render target. */
+export interface FilterBackdrop {
+    readonly canvas: Canvas;
+    readonly transform: DOMMatrix;
+}
 /** An operation-owned pass. The shared executor knows nothing about its inputs. */
 export interface CustomPreparedFilter extends PreparedPibblFilter {
     readonly reverseInfluence: (output: Readonly<PixelBounds>, density: number) => PixelBounds;
@@ -16,6 +22,7 @@ export interface CustomPreparedFilter extends PreparedPibblFilter {
         }>;
     }>;
     readonly fuseWithPrevious?: (previous: CustomPreparedFilter) => CustomPreparedFilter | undefined;
-    readonly process?: (source: OffscreenCanvas, windows: FilterWindows) => ImageBitmap;
+    readonly needsBackdrop?: boolean;
+    readonly process?: (source: OffscreenCanvas, windows: FilterWindows, backdrop?: FilterBackdrop) => ImageBitmap;
 }
 export declare const filterBoundaryExecutor: PibblFilterBoundaryExecutor;

package/dist/filters/filter-executor.js

@@ -1,8 +1,11 @@
 import { GLOBAL_STATE } from "../lib/global-state.js";
 import { getOptionalService } from "../lib/optional-services.js";
+import { getCurrentPaintTransform } from "../lib/render-target.js";
 import { enterPrimitivePresentation } from "../lib/primitive-presentation.js";
 import { renderFilterBoundary } from "../lib/filter/render-filter-boundary.js";
-import { compileNativeFilters } from "./native-operations.js";
+import {
+  compileNativeFilters
+} from "./native-operations.js";
 import { assertNativeCanvasFilter } from "./native-canvas-filter.js";
 const SCRATCH = /* @__PURE__ */ Symbol("pibbl.filter-pass-scratch");
 class PassScratch {
@@ -24,11 +27,17 @@ class PassScratch {
     if (success || !this.committed) this.dispose();
   }
   target(index, width, height) {
-    const canvas = this.surfaces[index] ??= new OffscreenCanvas(width, height);
+    const canvas = this.surfaces[index] ??= new OffscreenCanvas(
+      width,
+      height
+    );
     if (canvas.width !== width) canvas.width = width;
     if (canvas.height !== height) canvas.height = height;
     const context = canvas.getContext("2d");
-    if (!context) throw new Error("Filter passes require an OffscreenCanvas 2D scratch target.");
+    if (!context)
+      throw new Error(
+        "Filter passes require an OffscreenCanvas 2D scratch target."
+      );
     context.reset();
     return context;
   }
@@ -60,58 +69,104 @@ const filterBoundaryExecutor = {
       }
       return;
     }
-    if (operations.every((operation) => "css" in operation)) {
-      renderFilterBoundary({ component: input.component, filters: operations, presentation: input.presentation }, input.renderSubtree);
+    if (operations.every(
+      (operation) => "css" in operation
+    )) {
+      renderFilterBoundary(
+        {
+          component: input.component,
+          filters: operations,
+          presentation: input.presentation
+        },
+        input.renderSubtree
+      );
       return;
     }
-    const bounds = operations.map((operation) => "css" in operation ? operation : {
-      executor: filterBoundaryExecutor,
-      css: () => "none",
-      reverseInfluence: operation.reverseInfluence
-    });
-    renderFilterBoundary({
-      component: input.component,
-      filters: bounds,
-      presentation: input.presentation,
-      process(source, result, windows) {
-        const instance = GLOBAL_STATE.currentPibblInstance;
-        if (!instance) throw new Error("Filter processing requires an active Pibbl instance.");
-        const scratch = getOptionalService(instance, SCRATCH, () => new PassScratch(instance));
-        scratch.used = true;
-        let current = source, pass = 0;
-        let native = [];
-        const target = () => scratch.target(pass++ % 2, source.width, source.height);
-        const applyNative = () => {
-          if (!native.length) return;
-          const context = target();
-          assertNativeCanvasFilter(context, compileNativeFilters(native, windows.density), input.component, () => {
-            for (const operation of native) if (operation.onRejected) {
-              assertNativeCanvasFilter(context, operation.css(windows.density), input.component, operation.onRejected);
-            }
-          });
-          context.drawImage(current, 0, 0);
-          current = context.canvas;
-          native = [];
-        };
-        for (const operation of operations) {
-          if ("css" in operation) {
-            native.push(operation);
-            continue;
-          }
-          applyNative();
-          const bitmap = operation.process(current, windows);
-          try {
+    const parent = operations.some(
+      (operation) => "needsBackdrop" in operation && operation.needsBackdrop
+    ) ? GLOBAL_STATE.renderContext : void 0;
+    const parentTarget = parent ? GLOBAL_STATE.renderTarget : void 0;
+    const paint = parent ? getCurrentPaintTransform() : void 0;
+    const boundaryPaint = paint && input.presentation?.transform ? paint.multiply(input.presentation.transform) : paint;
+    const bounds = operations.map(
+      (operation) => "css" in operation ? operation : {
+        executor: filterBoundaryExecutor,
+        css: () => "none",
+        reverseInfluence: operation.reverseInfluence
+      }
+    );
+    renderFilterBoundary(
+      {
+        component: input.component,
+        filters: bounds,
+        presentation: input.presentation,
+        process(source, result, windows) {
+          const instance = GLOBAL_STATE.currentPibblInstance;
+          if (!instance)
+            throw new Error(
+              "Filter processing requires an active Pibbl instance."
+            );
+          const scratch = getOptionalService(
+            instance,
+            SCRATCH,
+            () => new PassScratch(instance)
+          );
+          scratch.used = true;
+          let current = source, pass = 0;
+          let native = [];
+          const target = () => scratch.target(pass++ % 2, source.width, source.height);
+          const applyNative = () => {
+            if (!native.length) return;
             const context = target();
-            context.drawImage(bitmap, 0, 0);
+            assertNativeCanvasFilter(
+              context,
+              compileNativeFilters(native, windows.density),
+              input.component,
+              () => {
+                for (const operation of native)
+                  if (operation.onRejected) {
+                    assertNativeCanvasFilter(
+                      context,
+                      operation.css(windows.density),
+                      input.component,
+                      operation.onRejected
+                    );
+                  }
+              }
+            );
+            context.drawImage(current, 0, 0);
             current = context.canvas;
-          } finally {
-            bitmap.close();
+            native = [];
+          };
+          for (const operation of operations) {
+            if ("css" in operation) {
+              native.push(operation);
+              continue;
+            }
+            applyNative();
+            const backdrop = parent && parentTarget && boundaryPaint ? {
+              canvas: parent.canvas,
+              transform: windows.source.renderTransform.multiply(boundaryPaint.inverse()).multiply(parentTarget.inverseRenderTransform)
+            } : void 0;
+            const bitmap = operation.process(current, windows, backdrop);
+            try {
+              const context = target();
+              context.drawImage(bitmap, 0, 0);
+              current = context.canvas;
+            } finally {
+              bitmap.close();
+            }
           }
+          applyNative();
+          result.drawImage(
+            current,
+            windows.sourceToOutputX,
+            windows.sourceToOutputY
+          );
         }
-        applyNative();
-        result.drawImage(current, windows.sourceToOutputX, windows.sourceToOutputY);
-      }
-    }, input.renderSubtree);
+      },
+      input.renderSubtree
+    );
   }
 };
 export {

package/dist/filters/filter-executor.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/filters/filter-executor.ts"],
-  "sourcesContent": ["import type { TexturePaint } from '../lib/textures/texture-protocol.js';\nimport { GLOBAL_STATE } from '../lib/global-state.js';\nimport { getOptionalService } from '../lib/optional-services.js';\nimport { enterPrimitivePresentation } from '../lib/primitive-presentation.js';\nimport { renderFilterBoundary } from '../lib/filter/render-filter-boundary.js';\nimport type { FilterWindows, PixelBounds } from '../lib/filter/filter-region.js';\nimport type { PibblFilterBoundaryExecutor, PreparedPibblFilter } from '../lib/style/filter-types.js';\nimport type { PibblInstance } from '../lib/types.js';\nimport { compileNativeFilters, type NativePreparedFilter } from './native-operations.js';\nimport { assertNativeCanvasFilter } from './native-canvas-filter.js';\n\n/** An operation-owned pass. The shared executor knows nothing about its inputs. */\nexport interface CustomPreparedFilter extends PreparedPibblFilter {\n  readonly reverseInfluence: (output: Readonly<PixelBounds>, density: number) => PixelBounds;\n  /** Private fusion capability; no concrete GPU implementation enters this module. */\n  readonly textureWarp?: Readonly<{ map: TexturePaint; strength: number; region: Readonly<{x:number;y:number;width:number;height:number}> }>;\n  readonly fuseWithPrevious?: (previous: CustomPreparedFilter) => CustomPreparedFilter | undefined;\n  readonly process?: (source: OffscreenCanvas, windows: FilterWindows) => ImageBitmap;\n}\ntype Operation = NativePreparedFilter | CustomPreparedFilter;\nconst SCRATCH = Symbol('pibbl.filter-pass-scratch');\nclass PassScratch {\n  private readonly surfaces: OffscreenCanvas[] = [];\n  used = false;\n  private committed = false;\n  constructor(private readonly instance: PibblInstance) {}\n  beginRender(): void { this.used = false; }\n  endRender(success: boolean): void {\n    if (success && this.used) { this.committed = true; return; }\n    if (success || !this.committed) this.dispose();\n  }\n  target(index: number, width: number, height: number): OffscreenCanvasRenderingContext2D {\n    const canvas = this.surfaces[index] ??= new OffscreenCanvas(width, height);\n    if (canvas.width !== width) canvas.width = width;\n    if (canvas.height !== height) canvas.height = height;\n    const context = canvas.getContext('2d');\n    if (!context) throw new Error('Filter passes require an OffscreenCanvas 2D scratch target.');\n    context.reset();\n    return context;\n  }\n  dispose(): void {\n    for (const canvas of this.surfaces) { canvas.width = 0; canvas.height = 0; }\n    this.surfaces.length = 0;\n    this.instance.optionalServices.delete(SCRATCH);\n  }\n}\n\nexport const filterBoundaryExecutor: PibblFilterBoundaryExecutor = {\n  render(input) {\n    const operations: Operation[] = [];\n    for (const operation of input.filters as readonly Operation[]) {\n      if (!('css' in operation) && !operation.process) continue;\n      const previous = operations.at(-1);\n      const fused = previous && !('css' in previous) && !('css' in operation)\n        ? operation.fuseWithPrevious?.(previous) : undefined;\n      if (fused) operations[operations.length - 1] = fused;\n      else operations.push(operation);\n    }\n    if (!operations.length) {\n      const release = enterPrimitivePresentation(input.presentation);\n      try { input.renderSubtree(); } finally { release(); }\n      return;\n    }\n    if (operations.every((operation): operation is NativePreparedFilter => 'css' in operation)) {\n      renderFilterBoundary({ component: input.component, filters: operations, presentation: input.presentation }, input.renderSubtree);\n      return;\n    }\n    const bounds = operations.map(operation => 'css' in operation ? operation : {\n      executor: filterBoundaryExecutor, css: () => 'none', reverseInfluence: operation.reverseInfluence,\n    });\n    renderFilterBoundary({\n      component: input.component, filters: bounds, presentation: input.presentation,\n      process(source, result, windows) {\n        const instance = GLOBAL_STATE.currentPibblInstance;\n        if (!instance) throw new Error('Filter processing requires an active Pibbl instance.');\n        const scratch = getOptionalService(instance, SCRATCH, () => new PassScratch(instance));\n        scratch.used = true;\n        let current = source, pass = 0;\n        let native: NativePreparedFilter[] = [];\n        const target = () => scratch.target(pass++ % 2, source.width, source.height);\n        const applyNative = () => {\n          if (!native.length) return;\n          const context = target();\n          assertNativeCanvasFilter(context, compileNativeFilters(native, windows.density), input.component, () => {\n            for (const operation of native) if (operation.onRejected) {\n              assertNativeCanvasFilter(context, operation.css(windows.density), input.component, operation.onRejected);\n            }\n          });\n          context.drawImage(current, 0, 0);\n          current = context.canvas;\n          native = [];\n        };\n        for (const operation of operations) {\n          if ('css' in operation) { native.push(operation); continue; }\n          applyNative();\n          const bitmap = operation.process!(current, windows);\n          try {\n            const context = target(); context.drawImage(bitmap, 0, 0); current = context.canvas;\n          } finally { bitmap.close(); }\n        }\n        applyNative();\n        result.drawImage(current, windows.sourceToOutputX, windows.sourceToOutputY);\n      },\n    }, input.renderSubtree);\n  },\n};\n"],
-  "mappings": "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",
+  "sourcesContent": ["import type { TexturePaint } from \"../lib/textures/texture-protocol.js\";\nimport { GLOBAL_STATE } from \"../lib/global-state.js\";\nimport { getOptionalService } from \"../lib/optional-services.js\";\nimport { getCurrentPaintTransform } from \"../lib/render-target.js\";\nimport type { Canvas } from \"../lib/types.js\";\nimport { enterPrimitivePresentation } from \"../lib/primitive-presentation.js\";\nimport { renderFilterBoundary } from \"../lib/filter/render-filter-boundary.js\";\nimport type {\n  FilterWindows,\n  PixelBounds,\n} from \"../lib/filter/filter-region.js\";\nimport type {\n  PibblFilterBoundaryExecutor,\n  PreparedPibblFilter,\n} from \"../lib/style/filter-types.js\";\nimport type { PibblInstance } from \"../lib/types.js\";\nimport {\n  compileNativeFilters,\n  type NativePreparedFilter,\n} from \"./native-operations.js\";\nimport { assertNativeCanvasFilter } from \"./native-canvas-filter.js\";\n\n/** Backing-pixel projection of the already-painted current render target. */\nexport interface FilterBackdrop {\n  readonly canvas: Canvas;\n  readonly transform: DOMMatrix;\n}\n\n/** An operation-owned pass. The shared executor knows nothing about its inputs. */\nexport interface CustomPreparedFilter extends PreparedPibblFilter {\n  readonly reverseInfluence: (\n    output: Readonly<PixelBounds>,\n    density: number,\n  ) => PixelBounds;\n  /** Private fusion capability; no concrete GPU implementation enters this module. */\n  readonly textureWarp?: Readonly<{\n    map: TexturePaint;\n    strength: number;\n    region: Readonly<{ x: number; y: number; width: number; height: number }>;\n  }>;\n  readonly fuseWithPrevious?: (\n    previous: CustomPreparedFilter,\n  ) => CustomPreparedFilter | undefined;\n  readonly needsBackdrop?: boolean;\n  readonly process?: (\n    source: OffscreenCanvas,\n    windows: FilterWindows,\n    backdrop?: FilterBackdrop,\n  ) => ImageBitmap;\n}\ntype Operation = NativePreparedFilter | CustomPreparedFilter;\nconst SCRATCH = Symbol(\"pibbl.filter-pass-scratch\");\nclass PassScratch {\n  private readonly surfaces: OffscreenCanvas[] = [];\n  used = false;\n  private committed = false;\n  constructor(private readonly instance: PibblInstance) {}\n  beginRender(): void {\n    this.used = false;\n  }\n  endRender(success: boolean): void {\n    if (success && this.used) {\n      this.committed = true;\n      return;\n    }\n    if (success || !this.committed) this.dispose();\n  }\n  target(\n    index: number,\n    width: number,\n    height: number,\n  ): OffscreenCanvasRenderingContext2D {\n    const canvas = (this.surfaces[index] ??= new OffscreenCanvas(\n      width,\n      height,\n    ));\n    if (canvas.width !== width) canvas.width = width;\n    if (canvas.height !== height) canvas.height = height;\n    const context = canvas.getContext(\"2d\");\n    if (!context)\n      throw new Error(\n        \"Filter passes require an OffscreenCanvas 2D scratch target.\",\n      );\n    context.reset();\n    return context;\n  }\n  dispose(): void {\n    for (const canvas of this.surfaces) {\n      canvas.width = 0;\n      canvas.height = 0;\n    }\n    this.surfaces.length = 0;\n    this.instance.optionalServices.delete(SCRATCH);\n  }\n}\n\nexport const filterBoundaryExecutor: PibblFilterBoundaryExecutor = {\n  render(input) {\n    const operations: Operation[] = [];\n    for (const operation of input.filters as readonly Operation[]) {\n      if (!(\"css\" in operation) && !operation.process) continue;\n      const previous = operations.at(-1);\n      const fused =\n        previous && !(\"css\" in previous) && !(\"css\" in operation)\n          ? operation.fuseWithPrevious?.(previous)\n          : undefined;\n      if (fused) operations[operations.length - 1] = fused;\n      else operations.push(operation);\n    }\n    if (!operations.length) {\n      const release = enterPrimitivePresentation(input.presentation);\n      try {\n        input.renderSubtree();\n      } finally {\n        release();\n      }\n      return;\n    }\n    if (\n      operations.every(\n        (operation): operation is NativePreparedFilter => \"css\" in operation,\n      )\n    ) {\n      renderFilterBoundary(\n        {\n          component: input.component,\n          filters: operations,\n          presentation: input.presentation,\n        },\n        input.renderSubtree,\n      );\n      return;\n    }\n    // Snapshot the parent projection before capture switches the current render target.\n    const parent = operations.some(\n      (operation) => \"needsBackdrop\" in operation && operation.needsBackdrop,\n    )\n      ? GLOBAL_STATE.renderContext\n      : undefined;\n    const parentTarget = parent ? GLOBAL_STATE.renderTarget : undefined;\n    const paint = parent ? getCurrentPaintTransform() : undefined;\n    const boundaryPaint =\n      paint && input.presentation?.transform\n        ? paint.multiply(input.presentation.transform)\n        : paint;\n    const bounds = operations.map((operation) =>\n      \"css\" in operation\n        ? operation\n        : {\n            executor: filterBoundaryExecutor,\n            css: () => \"none\",\n            reverseInfluence: operation.reverseInfluence,\n          },\n    );\n    renderFilterBoundary(\n      {\n        component: input.component,\n        filters: bounds,\n        presentation: input.presentation,\n        process(source, result, windows) {\n          const instance = GLOBAL_STATE.currentPibblInstance;\n          if (!instance)\n            throw new Error(\n              \"Filter processing requires an active Pibbl instance.\",\n            );\n          const scratch = getOptionalService(\n            instance,\n            SCRATCH,\n            () => new PassScratch(instance),\n          );\n          scratch.used = true;\n          let current = source,\n            pass = 0;\n          let native: NativePreparedFilter[] = [];\n          const target = () =>\n            scratch.target(pass++ % 2, source.width, source.height);\n          const applyNative = () => {\n            if (!native.length) return;\n            const context = target();\n            assertNativeCanvasFilter(\n              context,\n              compileNativeFilters(native, windows.density),\n              input.component,\n              () => {\n                for (const operation of native)\n                  if (operation.onRejected) {\n                    assertNativeCanvasFilter(\n                      context,\n                      operation.css(windows.density),\n                      input.component,\n                      operation.onRejected,\n                    );\n                  }\n              },\n            );\n            context.drawImage(current, 0, 0);\n            current = context.canvas;\n            native = [];\n          };\n          for (const operation of operations) {\n            if (\"css\" in operation) {\n              native.push(operation);\n              continue;\n            }\n            applyNative();\n            const backdrop =\n              parent && parentTarget && boundaryPaint\n                ? {\n                    canvas: parent.canvas,\n                    transform: windows.source.renderTransform\n                      .multiply(boundaryPaint.inverse())\n                      .multiply(parentTarget.inverseRenderTransform),\n                  }\n                : undefined;\n            const bitmap = operation.process!(current, windows, backdrop);\n            try {\n              const context = target();\n              context.drawImage(bitmap, 0, 0);\n              current = context.canvas;\n            } finally {\n              bitmap.close();\n            }\n          }\n          applyNative();\n          result.drawImage(\n            current,\n            windows.sourceToOutputX,\n            windows.sourceToOutputY,\n          );\n        },\n      },\n      input.renderSubtree,\n    );\n  },\n};\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/filters/reflected-light.js

@@ -29,7 +29,7 @@ const executor = {
       throw fail("region", candidateRegion, "must have finite coordinates and positive dimensions");
     }
     const { x, y, width, height } = candidateRegion;
-    if (![x, y, width, height].every((value2) => typeof value2 === "number" && Number.isFinite(value2))) {
+    if (!(typeof x === "number" && Number.isFinite(x) && typeof y === "number" && Number.isFinite(y) && typeof width === "number" && Number.isFinite(width) && typeof height === "number" && Number.isFinite(height))) {
       throw fail("region", candidateRegion, "must have finite coordinates and positive dimensions");
     }
     const numericRegion = { x, y, width, height };

package/dist/filters/reflected-light.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/filters/reflected-light.ts"],
-  "sourcesContent": ["import { isSignal } from '../lib/signals/graph.js';\nimport { layoutDiagnostic } from '../lib/style/diagnostics.js';\nimport { PIBBL_FILTER_EXECUTOR, type PibblFilter, type PibblFilterExecutor, type PibblReflectedLightFilterOptions } from '../lib/style/filter-types.js';\nimport { borrowTextureRaster, validateTexturePaint } from '../lib/textures/texture-protocol.js';\nimport { filterBoundaryExecutor, type CustomPreparedFilter } from './filter-executor.js';\nimport { processReflection, isReflectionImage } from './render-reflection-boundary.js';\nimport { concreteColor } from './native-color.js';\n\nconst definitions = new WeakMap<PibblFilter, Readonly<PibblReflectedLightFilterOptions>>();\nconst executor: PibblFilterExecutor = {\n  prepare(value, property, context) {\n    const options=definitions.get(value);\n    if(!options) throw new Error('A reflected-light filter value was created by an incompatible Pibbl runtime.');\n    const fail=(key:string,value:unknown,reason:string)=>layoutDiagnostic({component:context.component,property:`${property}.${key}`,value,algorithm:context.algorithm,constraints:context.constraints,reason});\n    const numeric=(key:'opacity'|'threshold'|'softness',fallback:number,min:number,max:number)=>{\n      const input=options[key]; const value=input===undefined?fallback:isSignal(input)?input.get():input;\n      if(typeof value!=='number'||!Number.isFinite(value)||value<min||value>max||(key==='softness'&&value===0)) throw fail(key,value,`must be finite and within ${min}..${max}${key==='softness'?' (strictly positive)':''}`);\n      return value;\n    };\n    const opacity=numeric('opacity',0.15,0,1), threshold=numeric('threshold',0.1,-1,1), softness=numeric('softness',0.25,0,2);\n    const direction: unknown = options.direction ?? [-0.6, -0.8];\n    if (!Array.isArray(direction) || direction.length !== 2 || !direction.every(value => typeof value === 'number' && Number.isFinite(value))) {\n      throw fail('direction', direction, 'must contain two finite components with nonzero length');\n    }\n    const length = Math.hypot(direction[0], direction[1]);\n    if (length === 0) throw fail('direction', direction, 'must contain two finite components with nonzero length');\n    const candidateRegion: unknown = options.region;\n    if (!candidateRegion || typeof candidateRegion !== 'object') {\n      throw fail('region', candidateRegion, 'must have finite coordinates and positive dimensions');\n    }\n    const { x, y, width, height } = candidateRegion as { x?: unknown; y?: unknown; width?: unknown; height?: unknown };\n    if (![x, y, width, height].every(value => typeof value === 'number' && Number.isFinite(value))) {\n      throw fail('region', candidateRegion, 'must have finite coordinates and positive dimensions');\n    }\n    const numericRegion = { x: x as number, y: y as number, width: width as number, height: height as number };\n    if (numericRegion.width <= 0 || numericRegion.height <= 0) {\n      throw fail('region', candidateRegion, 'must have finite coordinates and positive dimensions');\n    }\n    const region = Object.freeze(numericRegion);\n    const map=isSignal(options.map)?options.map.get():options.map;\n    try { validateTexturePaint(map); if(opacity!==0) borrowTextureRaster(map,()=>undefined); }\n    catch(error) { throw fail('map',map,error instanceof Error?error.message:String(error)); }\n    const source=options.source===undefined?'#ffffff':isSignal(options.source)?options.source.get():options.source;\n    if(typeof source==='string') {\n      concreteColor(source,`${property}.source`,context);\n      if(typeof CSS==='undefined'||!CSS.supports('color',source)) throw fail('source',source,'must be a supported concrete CSS color');\n    } else if(isReflectionImage(source)) {\n      const ready='naturalWidth' in source?source.complete&&source.naturalWidth>0&&source.naturalHeight>0:source.width>0&&source.height>0;\n      if(!ready) throw fail('source',source,'image must already be decoded and have positive dimensions');\n    } else {\n      try { validateTexturePaint(source); if(opacity!==0) borrowTextureRaster(source,()=>undefined); }\n      catch(error) { throw fail('source',source,error instanceof Error?error.message:String(error)); }\n    }\n    const settings={opacity,threshold,softness,direction:[direction[0]/length,direction[1]/length] as const};\n    const process=(warp?:CustomPreparedFilter['textureWarp']):NonNullable<CustomPreparedFilter['process']>=>(input,windows)=>{\n      try { return processReflection(input,windows,map,source,settings,region,warp); }\n      catch(error) { const failure=fail('source',source,`reflected-light processing failed: ${error instanceof Error?error.message:String(error)}`); Object.defineProperty(failure,'cause',{value:error});throw failure; }\n    };\n    return Object.freeze({\n      executor:filterBoundaryExecutor,\n      reverseInfluence:output=>({...output}),\n      process:opacity===0?undefined:process(),\n      fuseWithPrevious:previous=>previous.textureWarp?Object.freeze({executor:filterBoundaryExecutor,reverseInfluence:previous.reverseInfluence,process:process(previous.textureWarp)}):undefined,\n    } satisfies CustomPreparedFilter);\n  },\n  render:filterBoundaryExecutor.render,\n};\n\n/**\n * Adds slope-selective surface light without changing scene alpha or geometry.\n *\n * @param options - Lighting texture and reflected-light appearance settings. See\n * {@link PibblReflectedLightFilterOptions} .\n * @returns A reflected-light filter descriptor for style.filter. See {@link PibblFilter}.\n *\n * @see {@link PibblReflectedLightFilterOptions}\n * @see {@link PibblFilter}\n */\nexport function reflectedLight(options: PibblReflectedLightFilterOptions): PibblFilter {\n  const rawOptions = options as unknown as { readonly region: unknown; readonly direction?: unknown };\n  const region = rawOptions.region && typeof rawOptions.region === 'object'\n    ? Object.freeze({ ...(rawOptions.region as object) })\n    : rawOptions.region;\n  const direction = rawOptions.direction === undefined\n    ? undefined\n    : Array.isArray(rawOptions.direction)\n      ? Object.freeze([...rawOptions.direction])\n      : rawOptions.direction;\n  const definition = Object.freeze({ ...options, region, direction }) as Readonly<PibblReflectedLightFilterOptions>;\n  const value = Object.freeze({ [PIBBL_FILTER_EXECUTOR]: executor });\n  definitions.set(value, definition);\n  return value;\n}\n"],
-  "mappings": "AAAA,SAAS,gBAAgB;AACzB,SAAS,wBAAwB;AACjC,SAAS,6BAAgH;AACzH,SAAS,qBAAqB,4BAA4B;AAC1D,SAAS,8BAAyD;AAClE,SAAS,mBAAmB,yBAAyB;AACrD,SAAS,qBAAqB;AAE9B,MAAM,cAAc,oBAAI,QAAiE;AACzF,MAAM,WAAgC;AAAA,EACpC,QAAQ,OAAO,UAAU,SAAS;AAChC,UAAM,UAAQ,YAAY,IAAI,KAAK;AACnC,QAAG,CAAC,QAAS,OAAM,IAAI,MAAM,8EAA8E;AAC3G,UAAM,OAAK,CAAC,KAAWA,QAAc,WAAgB,iBAAiB,EAAC,WAAU,QAAQ,WAAU,UAAS,GAAG,QAAQ,IAAI,GAAG,IAAG,OAAAA,QAAM,WAAU,QAAQ,WAAU,aAAY,QAAQ,aAAY,OAAM,CAAC;AAC1M,UAAM,UAAQ,CAAC,KAAqC,UAAgB,KAAW,QAAa;AAC1F,YAAM,QAAM,QAAQ,GAAG;AAAG,YAAMA,SAAM,UAAQ,SAAU,WAAS,SAAS,KAAK,IAAE,MAAM,IAAI,IAAE;AAC7F,UAAG,OAAOA,WAAQ,YAAU,CAAC,OAAO,SAASA,MAAK,KAAGA,SAAM,OAAKA,SAAM,OAAM,QAAM,cAAYA,WAAQ,EAAI,OAAM,KAAK,KAAIA,QAAM,6BAA6B,GAAG,KAAK,GAAG,GAAG,QAAM,aAAW,yBAAuB,EAAE,EAAE;AACtN,aAAOA;AAAA,IACT;AACA,UAAM,UAAQ,QAAQ,WAAU,MAAK,GAAE,CAAC,GAAG,YAAU,QAAQ,aAAY,KAAI,IAAG,CAAC,GAAG,WAAS,QAAQ,YAAW,MAAK,GAAE,CAAC;AACxH,UAAM,YAAqB,QAAQ,aAAa,CAAC,MAAM,IAAI;AAC3D,QAAI,CAAC,MAAM,QAAQ,SAAS,KAAK,UAAU,WAAW,KAAK,CAAC,UAAU,MAAM,CAAAA,WAAS,OAAOA,WAAU,YAAY,OAAO,SAASA,MAAK,CAAC,GAAG;AACzI,YAAM,KAAK,aAAa,WAAW,wDAAwD;AAAA,IAC7F;AACA,UAAM,SAAS,KAAK,MAAM,UAAU,CAAC,GAAG,UAAU,CAAC,CAAC;AACpD,QAAI,WAAW,EAAG,OAAM,KAAK,aAAa,WAAW,wDAAwD;AAC7G,UAAM,kBAA2B,QAAQ;AACzC,QAAI,CAAC,mBAAmB,OAAO,oBAAoB,UAAU;AAC3D,YAAM,KAAK,UAAU,iBAAiB,sDAAsD;AAAA,IAC9F;AACA,UAAM,EAAE,GAAG,GAAG,OAAO,OAAO,IAAI;AAChC,QAAI,CAAC,CAAC,GAAG,GAAG,OAAO,MAAM,EAAE,MAAM,CAAAA,WAAS,OAAOA,WAAU,YAAY,OAAO,SAASA,MAAK,CAAC,GAAG;AAC9F,YAAM,KAAK,UAAU,iBAAiB,sDAAsD;AAAA,IAC9F;AACA,UAAM,gBAAgB,EAAE,GAAgB,GAAgB,OAAwB,OAAyB;AACzG,QAAI,cAAc,SAAS,KAAK,cAAc,UAAU,GAAG;AACzD,YAAM,KAAK,UAAU,iBAAiB,sDAAsD;AAAA,IAC9F;AACA,UAAM,SAAS,OAAO,OAAO,aAAa;AAC1C,UAAM,MAAI,SAAS,QAAQ,GAAG,IAAE,QAAQ,IAAI,IAAI,IAAE,QAAQ;AAC1D,QAAI;AAAE,2BAAqB,GAAG;AAAG,UAAG,YAAU,EAAG,qBAAoB,KAAI,MAAI,MAAS;AAAA,IAAG,SACnF,OAAO;AAAE,YAAM,KAAK,OAAM,KAAI,iBAAiB,QAAM,MAAM,UAAQ,OAAO,KAAK,CAAC;AAAA,IAAG;AACzF,UAAM,SAAO,QAAQ,WAAS,SAAU,YAAU,SAAS,QAAQ,MAAM,IAAE,QAAQ,OAAO,IAAI,IAAE,QAAQ;AACxG,QAAG,OAAO,WAAS,UAAU;AAC3B,oBAAc,QAAO,GAAG,QAAQ,WAAU,OAAO;AACjD,UAAG,OAAO,QAAM,eAAa,CAAC,IAAI,SAAS,SAAQ,MAAM,EAAG,OAAM,KAAK,UAAS,QAAO,wCAAwC;AAAA,IACjI,WAAU,kBAAkB,MAAM,GAAG;AACnC,YAAM,QAAM,kBAAkB,SAAO,OAAO,YAAU,OAAO,eAAa,KAAG,OAAO,gBAAc,IAAE,OAAO,QAAM,KAAG,OAAO,SAAO;AAClI,UAAG,CAAC,MAAO,OAAM,KAAK,UAAS,QAAO,4DAA4D;AAAA,IACpG,OAAO;AACL,UAAI;AAAE,6BAAqB,MAAM;AAAG,YAAG,YAAU,EAAG,qBAAoB,QAAO,MAAI,MAAS;AAAA,MAAG,SACzF,OAAO;AAAE,cAAM,KAAK,UAAS,QAAO,iBAAiB,QAAM,MAAM,UAAQ,OAAO,KAAK,CAAC;AAAA,MAAG;AAAA,IACjG;AACA,UAAM,WAAS,EAAC,SAAQ,WAAU,UAAS,WAAU,CAAC,UAAU,CAAC,IAAE,QAAO,UAAU,CAAC,IAAE,MAAM,EAAU;AACvG,UAAM,UAAQ,CAAC,SAAyF,CAAC,OAAM,YAAU;AACvH,UAAI;AAAE,eAAO,kBAAkB,OAAM,SAAQ,KAAI,QAAO,UAAS,QAAO,IAAI;AAAA,MAAG,SACzE,OAAO;AAAE,cAAM,UAAQ,KAAK,UAAS,QAAO,sCAAsC,iBAAiB,QAAM,MAAM,UAAQ,OAAO,KAAK,CAAC,EAAE;AAAG,eAAO,eAAe,SAAQ,SAAQ,EAAC,OAAM,MAAK,CAAC;AAAE,cAAM;AAAA,MAAS;AAAA,IACrN;AACA,WAAO,OAAO,OAAO;AAAA,MACnB,UAAS;AAAA,MACT,kBAAiB,aAAS,EAAC,GAAG,OAAM;AAAA,MACpC,SAAQ,YAAU,IAAE,SAAU,QAAQ;AAAA,MACtC,kBAAiB,cAAU,SAAS,cAAY,OAAO,OAAO,EAAC,UAAS,wBAAuB,kBAAiB,SAAS,kBAAiB,SAAQ,QAAQ,SAAS,WAAW,EAAC,CAAC,IAAE;AAAA,IACpL,CAAgC;AAAA,EAClC;AAAA,EACA,QAAO,uBAAuB;AAChC;AAYO,SAAS,eAAe,SAAwD;AACrF,QAAM,aAAa;AACnB,QAAM,SAAS,WAAW,UAAU,OAAO,WAAW,WAAW,WAC7D,OAAO,OAAO,EAAE,GAAI,WAAW,OAAkB,CAAC,IAClD,WAAW;AACf,QAAM,YAAY,WAAW,cAAc,SACvC,SACA,MAAM,QAAQ,WAAW,SAAS,IAChC,OAAO,OAAO,CAAC,GAAG,WAAW,SAAS,CAAC,IACvC,WAAW;AACjB,QAAM,aAAa,OAAO,OAAO,EAAE,GAAG,SAAS,QAAQ,UAAU,CAAC;AAClE,QAAM,QAAQ,OAAO,OAAO,EAAE,CAAC,qBAAqB,GAAG,SAAS,CAAC;AACjE,cAAY,IAAI,OAAO,UAAU;AACjC,SAAO;AACT;",
+  "sourcesContent": ["import { isSignal } from '../lib/signals/graph.js';\nimport { layoutDiagnostic } from '../lib/style/diagnostics.js';\nimport { PIBBL_FILTER_EXECUTOR, type PibblFilter, type PibblFilterExecutor, type PibblReflectedLightFilterOptions } from '../lib/style/filter-types.js';\nimport { borrowTextureRaster, validateTexturePaint } from '../lib/textures/texture-protocol.js';\nimport { filterBoundaryExecutor, type CustomPreparedFilter } from './filter-executor.js';\nimport { processReflection, isReflectionImage } from './render-reflection-boundary.js';\nimport { concreteColor } from './native-color.js';\n\nconst definitions = new WeakMap<PibblFilter, Readonly<PibblReflectedLightFilterOptions>>();\nconst executor: PibblFilterExecutor = {\n  prepare(value, property, context) {\n    const options=definitions.get(value);\n    if(!options) throw new Error('A reflected-light filter value was created by an incompatible Pibbl runtime.');\n    const fail=(key:string,value:unknown,reason:string)=>layoutDiagnostic({component:context.component,property:`${property}.${key}`,value,algorithm:context.algorithm,constraints:context.constraints,reason});\n    const numeric=(key:'opacity'|'threshold'|'softness',fallback:number,min:number,max:number)=>{\n      const input=options[key]; const value=input===undefined?fallback:isSignal(input)?input.get():input;\n      if(typeof value!=='number'||!Number.isFinite(value)||value<min||value>max||(key==='softness'&&value===0)) throw fail(key,value,`must be finite and within ${min}..${max}${key==='softness'?' (strictly positive)':''}`);\n      return value;\n    };\n    const opacity=numeric('opacity',0.15,0,1), threshold=numeric('threshold',0.1,-1,1), softness=numeric('softness',0.25,0,2);\n    const direction: unknown = options.direction ?? [-0.6, -0.8];\n    if (!Array.isArray(direction) || direction.length !== 2 || !direction.every(value => typeof value === 'number' && Number.isFinite(value))) {\n      throw fail('direction', direction, 'must contain two finite components with nonzero length');\n    }\n    const length = Math.hypot(direction[0], direction[1]);\n    if (length === 0) throw fail('direction', direction, 'must contain two finite components with nonzero length');\n    const candidateRegion: unknown = options.region;\n    if (!candidateRegion || typeof candidateRegion !== 'object') {\n      throw fail('region', candidateRegion, 'must have finite coordinates and positive dimensions');\n    }\n    const { x, y, width, height } = candidateRegion as { x?: unknown; y?: unknown; width?: unknown; height?: unknown };\n    if (!(\n      typeof x === 'number' &&\n      Number.isFinite(x) &&\n      typeof y === 'number' &&\n      Number.isFinite(y) &&\n      typeof width === 'number' &&\n      Number.isFinite(width) &&\n      typeof height === 'number' &&\n      Number.isFinite(height)\n    )) {\n      throw fail('region', candidateRegion, 'must have finite coordinates and positive dimensions');\n    }\n    const numericRegion = { x: x as number, y: y as number, width: width as number, height: height as number };\n    if (numericRegion.width <= 0 || numericRegion.height <= 0) {\n      throw fail('region', candidateRegion, 'must have finite coordinates and positive dimensions');\n    }\n    const region = Object.freeze(numericRegion);\n    const map=isSignal(options.map)?options.map.get():options.map;\n    try { validateTexturePaint(map); if(opacity!==0) borrowTextureRaster(map,()=>undefined); }\n    catch(error) { throw fail('map',map,error instanceof Error?error.message:String(error)); }\n    const source=options.source===undefined?'#ffffff':isSignal(options.source)?options.source.get():options.source;\n    if(typeof source==='string') {\n      concreteColor(source,`${property}.source`,context);\n      if(typeof CSS==='undefined'||!CSS.supports('color',source)) throw fail('source',source,'must be a supported concrete CSS color');\n    } else if(isReflectionImage(source)) {\n      const ready='naturalWidth' in source?source.complete&&source.naturalWidth>0&&source.naturalHeight>0:source.width>0&&source.height>0;\n      if(!ready) throw fail('source',source,'image must already be decoded and have positive dimensions');\n    } else {\n      try { validateTexturePaint(source); if(opacity!==0) borrowTextureRaster(source,()=>undefined); }\n      catch(error) { throw fail('source',source,error instanceof Error?error.message:String(error)); }\n    }\n    const settings={opacity,threshold,softness,direction:[direction[0]/length,direction[1]/length] as const};\n    const process=(warp?:CustomPreparedFilter['textureWarp']):NonNullable<CustomPreparedFilter['process']>=>(input,windows)=>{\n      try { return processReflection(input,windows,map,source,settings,region,warp); }\n      catch(error) { const failure=fail('source',source,`reflected-light processing failed: ${error instanceof Error?error.message:String(error)}`); Object.defineProperty(failure,'cause',{value:error});throw failure; }\n    };\n    return Object.freeze({\n      executor:filterBoundaryExecutor,\n      reverseInfluence:output=>({...output}),\n      process:opacity===0?undefined:process(),\n      fuseWithPrevious:previous=>previous.textureWarp?Object.freeze({executor:filterBoundaryExecutor,reverseInfluence:previous.reverseInfluence,process:process(previous.textureWarp)}):undefined,\n    } satisfies CustomPreparedFilter);\n  },\n  render:filterBoundaryExecutor.render,\n};\n\n/**\n * Adds slope-selective surface light without changing scene alpha or geometry.\n *\n * @param options - Lighting texture and reflected-light appearance settings. See\n * {@link PibblReflectedLightFilterOptions} .\n * @returns A reflected-light filter descriptor for style.filter. See {@link PibblFilter}.\n *\n * @see {@link PibblReflectedLightFilterOptions}\n * @see {@link PibblFilter}\n */\nexport function reflectedLight(options: PibblReflectedLightFilterOptions): PibblFilter {\n  const rawOptions = options as unknown as { readonly region: unknown; readonly direction?: unknown };\n  const region = rawOptions.region && typeof rawOptions.region === 'object'\n    ? Object.freeze({ ...(rawOptions.region as object) })\n    : rawOptions.region;\n  const direction = rawOptions.direction === undefined\n    ? undefined\n    : Array.isArray(rawOptions.direction)\n      ? Object.freeze([...rawOptions.direction])\n      : rawOptions.direction;\n  const definition = Object.freeze({ ...options, region, direction }) as Readonly<PibblReflectedLightFilterOptions>;\n  const value = Object.freeze({ [PIBBL_FILTER_EXECUTOR]: executor });\n  definitions.set(value, definition);\n  return value;\n}\n"],
+  "mappings": "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",
   "names": ["value"]
 }

package/dist/filters/reflection-gpu.d.ts

@@ -19,6 +19,7 @@ export interface ReflectionSettings {
     readonly threshold: number;
     readonly softness: number;
     readonly direction: readonly [number, number];
+    readonly depth?: number;
 }
 export type ReflectionLight = {
     readonly color: string;
@@ -35,6 +36,7 @@ export interface ReflectionWarp {
 /** Optional synchronous image processor; scene pixels are never read back. */
 export declare class ReflectionGpu {
     private readonly callbacks;
+    private readonly fragment;
     private readonly canvas;
     private gl;
     private resources;
@@ -46,7 +48,7 @@ export declare class ReflectionGpu {
     private lost;
     private readonly onContextLost;
     private readonly onContextRestored;
-    constructor(callbacks?: Readonly<ReflectionGpuCallbacks>);
+    constructor(callbacks?: Readonly<ReflectionGpuCallbacks>, fragment?: string);
     get isContextLost(): boolean;
     private acquireResources;
     apply(source: OffscreenCanvas, map: BorrowedTextureRaster, light: ReflectionLight, settings: ReflectionSettings, coordinates: ReflectionCoordinates, warp?: ReflectionWarp): ImageBitmap;

package/dist/filters/reflection-gpu.js

@@ -38,12 +38,14 @@ void main() {
 }
 `;
 class ReflectionGpu {
-  constructor(callbacks = {}) {
+  constructor(callbacks = {}, fragment = fragmentSource) {
     this.callbacks = callbacks;
+    this.fragment = fragment;
     this.canvas.addEventListener("webglcontextlost", this.onContextLost);
     this.canvas.addEventListener("webglcontextrestored", this.onContextRestored);
   }
   callbacks;
+  fragment;
   canvas = new OffscreenCanvas(1, 1);
   gl;
   resources;
@@ -80,7 +82,7 @@ class ReflectionGpu {
     let fragment;
     let program = null;
     try {
-      fragment = compile(gl, gl.FRAGMENT_SHADER, fragmentSource);
+      fragment = compile(gl, gl.FRAGMENT_SHADER, this.fragment);
       program = gl.createProgram();
       if (!program) throw new Error("Could not allocate reflection program.");
       gl.attachShader(program, vertex);
@@ -186,6 +188,7 @@ class ReflectionGpu {
     placement("warpOrigin", "warpSize", "warpRotation", warp?.map.placement ?? map.placement, warp?.region ?? coordinates.region, warp?.map.width ?? map.width, warp?.map.height ?? map.height);
     gl.uniform2f(uniform("warpStrength"), (warp?.strength ?? 0) * coordinates.density / source.width, (warp?.strength ?? 0) * coordinates.density / source.height);
     gl.uniform2f(uniform("direction"), settings.direction[0], settings.direction[1]);
+    gl.uniform1f(uniform("depth"), settings.depth ?? 0);
     gl.uniform1f(uniform("opacity"), settings.opacity);
     gl.uniform1f(uniform("threshold"), settings.threshold);
     gl.uniform1f(uniform("softness"), settings.softness);