@pibbl/core 0.0.1

package/dist/filters/reflected-light.js

@@ -0,0 +1,93 @@
+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 { processReflection, isReflectionImage } from "./render-reflection-boundary.js";
+import { concreteColor } from "./native-color.js";
+const definitions = /* @__PURE__ */ new WeakMap();
+const executor = {
+  prepare(value, property, context) {
+    const options = definitions.get(value);
+    if (!options) throw new Error("A reflected-light filter value was created by an incompatible Pibbl runtime.");
+    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, min, max) => {
+      const input = options[key];
+      const value2 = input === void 0 ? fallback : isSignal(input) ? input.get() : input;
+      if (typeof value2 !== "number" || !Number.isFinite(value2) || value2 < min || value2 > max || key === "softness" && value2 === 0) throw fail(key, value2, `must be finite and within ${min}..${max}${key === "softness" ? " (strictly positive)" : ""}`);
+      return value2;
+    };
+    const opacity = numeric("opacity", 0.15, 0, 1), threshold = numeric("threshold", 0.1, -1, 1), softness = numeric("softness", 0.25, 0, 2);
+    const direction = options.direction ?? [-0.6, -0.8];
+    if (!Array.isArray(direction) || direction.length !== 2 || !direction.every((value2) => typeof value2 === "number" && Number.isFinite(value2))) {
+      throw fail("direction", direction, "must contain two finite components with nonzero length");
+    }
+    const length = Math.hypot(direction[0], direction[1]);
+    if (length === 0) throw fail("direction", direction, "must contain two finite components with nonzero length");
+    const candidateRegion = options.region;
+    if (!candidateRegion || typeof candidateRegion !== "object") {
+      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))) {
+      throw fail("region", candidateRegion, "must have finite coordinates and positive dimensions");
+    }
+    const numericRegion = { x, y, width, height };
+    if (numericRegion.width <= 0 || numericRegion.height <= 0) {
+      throw fail("region", candidateRegion, "must have finite coordinates and positive dimensions");
+    }
+    const region = Object.freeze(numericRegion);
+    const map = isSignal(options.map) ? options.map.get() : options.map;
+    try {
+      validateTexturePaint(map);
+      if (opacity !== 0) borrowTextureRaster(map, () => void 0);
+    } catch (error) {
+      throw fail("map", map, error instanceof Error ? error.message : String(error));
+    }
+    const source = options.source === void 0 ? "#ffffff" : isSignal(options.source) ? options.source.get() : options.source;
+    if (typeof source === "string") {
+      concreteColor(source, `${property}.source`, context);
+      if (typeof CSS === "undefined" || !CSS.supports("color", source)) throw fail("source", source, "must be a supported concrete CSS color");
+    } else if (isReflectionImage(source)) {
+      const ready = "naturalWidth" in source ? source.complete && source.naturalWidth > 0 && source.naturalHeight > 0 : source.width > 0 && source.height > 0;
+      if (!ready) throw fail("source", source, "image must already be decoded and have positive dimensions");
+    } else {
+      try {
+        validateTexturePaint(source);
+        if (opacity !== 0) borrowTextureRaster(source, () => void 0);
+      } catch (error) {
+        throw fail("source", source, error instanceof Error ? error.message : String(error));
+      }
+    }
+    const settings = { opacity, threshold, softness, direction: [direction[0] / length, direction[1] / length] };
+    const process = (warp) => (input, windows) => {
+      try {
+        return processReflection(input, windows, map, source, settings, region, warp);
+      } 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;
+      }
+    };
+    return Object.freeze({
+      executor: filterBoundaryExecutor,
+      reverseInfluence: (output) => ({ ...output }),
+      process: opacity === 0 ? void 0 : process(),
+      fuseWithPrevious: (previous) => previous.textureWarp ? Object.freeze({ executor: filterBoundaryExecutor, reverseInfluence: previous.reverseInfluence, process: process(previous.textureWarp) }) : void 0
+    });
+  },
+  render: filterBoundaryExecutor.render
+};
+function reflectedLight(options) {
+  const rawOptions = options;
+  const region = rawOptions.region && typeof rawOptions.region === "object" ? Object.freeze({ ...rawOptions.region }) : rawOptions.region;
+  const direction = rawOptions.direction === void 0 ? void 0 : Array.isArray(rawOptions.direction) ? Object.freeze([...rawOptions.direction]) : rawOptions.direction;
+  const definition = Object.freeze({ ...options, region, direction });
+  const value = Object.freeze({ [PIBBL_FILTER_EXECUTOR]: executor });
+  definitions.set(value, definition);
+  return value;
+}
+export {
+  reflectedLight
+};
+//# sourceMappingURL=reflected-light.js.map

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

@@ -0,0 +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": "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",
+  "names": ["value"]
+}

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

@@ -0,0 +1,58 @@
+import type { BorrowedTextureRaster } from '../lib/textures/texture-protocol.js';
+export interface ReflectionCoordinates {
+    readonly originX: number;
+    readonly originY: number;
+    readonly density: number;
+    readonly region: Readonly<{
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    }>;
+}
+export interface ReflectionGpuCallbacks {
+    readonly onContextLost?: () => void;
+    readonly onContextRestored?: () => void;
+}
+export interface ReflectionSettings {
+    readonly opacity: number;
+    readonly threshold: number;
+    readonly softness: number;
+    readonly direction: readonly [number, number];
+}
+export type ReflectionLight = {
+    readonly color: string;
+} | {
+    readonly image: HTMLImageElement | ImageBitmap;
+} | {
+    readonly raster: BorrowedTextureRaster;
+};
+export interface ReflectionWarp {
+    readonly map: BorrowedTextureRaster;
+    readonly strength: number;
+    readonly region: ReflectionCoordinates['region'];
+}
+/** Optional synchronous image processor; scene pixels are never read back. */
+export declare class ReflectionGpu {
+    private readonly callbacks;
+    private readonly canvas;
+    private gl;
+    private resources;
+    private readonly maps;
+    private readonly directKey;
+    private colorCanvas;
+    private directRevision;
+    private disposed;
+    private lost;
+    private readonly onContextLost;
+    private readonly onContextRestored;
+    constructor(callbacks?: Readonly<ReflectionGpuCallbacks>);
+    get isContextLost(): boolean;
+    private acquireResources;
+    apply(source: OffscreenCanvas, map: BorrowedTextureRaster, light: ReflectionLight, settings: ReflectionSettings, coordinates: ReflectionCoordinates, warp?: ReflectionWarp): ImageBitmap;
+    private acquireResourcesWithContext;
+    private upload;
+    retainMaps(resources: ReadonlySet<object>): void;
+    private releaseResources;
+    dispose(): void;
+}

package/dist/filters/reflection-gpu.js

@@ -0,0 +1,266 @@
+const vertexSource = `#version 300 es
+in vec2 p;
+out vec2 uv;
+void main() { uv = vec2((p.x + 1.) * .5, 1. - (p.y + 1.) * .5); gl_Position = vec4(p, 0, 1); }
+`;
+const fragmentSource = `#version 300 es
+precision highp float;
+uniform sampler2D scene, map, lightMap, warpMap;
+uniform vec2 logicalOrigin, logicalSize, mapOrigin, tileSize, lightOrigin, lightSize, warpOrigin, warpSize, warpStrength, direction;
+uniform float rotation, lightRotation, warpRotation, opacity, threshold, softness;
+in vec2 uv;
+out vec4 outputColor;
+float decode(float c) { float b=c*255.; return (b-128.)/(b<128.?128.:127.); }
+vec2 coordinates(vec2 origin, vec2 size, float angle) {
+  vec2 p=logicalOrigin+uv*logicalSize-origin;
+  float c=cos(angle),s=sin(angle);
+  return vec2(c*p.x+s*p.y,-s*p.x+c*p.y)/size;
+}
+vec4 sourcePixel(ivec2 p) {
+  ivec2 size=textureSize(scene,0);
+  if(any(lessThan(p,ivec2(0)))||any(greaterThanEqual(p,size))) return vec4(0);
+  return texelFetch(scene,p,0);
+}
+vec4 sourceSample(vec2 p) {
+  vec2 pixel=p*vec2(textureSize(scene,0))-.5;
+  ivec2 base=ivec2(floor(pixel)); vec2 f=fract(pixel);
+  return mix(mix(sourcePixel(base),sourcePixel(base+ivec2(1,0)),f.x),mix(sourcePixel(base+ivec2(0,1)),sourcePixel(base+ivec2(1,1)),f.x),f.y);
+}
+void main() {
+  vec4 warp=texture(warpMap,coordinates(warpOrigin,warpSize,warpRotation));
+  vec4 base=sourceSample(uv+vec2(decode(warp.r),decode(warp.g))*warp.a*warpStrength);
+  vec4 field=texture(map,coordinates(mapOrigin,tileSize,rotation));
+  vec2 slope=vec2(decode(field.r),decode(field.g));
+  float coverage=smoothstep(threshold,threshold+softness,dot(slope,direction))*field.a*opacity;
+  vec4 light=texture(lightMap,coordinates(lightOrigin,lightSize,lightRotation)+slope*.035);
+  float amount=coverage*light.a;
+  outputColor=vec4(base.rgb*(1.-amount)+base.a*light.rgb*amount,base.a);
+}
+`;
+class ReflectionGpu {
+  constructor(callbacks = {}) {
+    this.callbacks = callbacks;
+    this.canvas.addEventListener("webglcontextlost", this.onContextLost);
+    this.canvas.addEventListener("webglcontextrestored", this.onContextRestored);
+  }
+  callbacks;
+  canvas = new OffscreenCanvas(1, 1);
+  gl;
+  resources;
+  maps = /* @__PURE__ */ new Map();
+  directKey = {};
+  colorCanvas;
+  directRevision = 0;
+  disposed = false;
+  lost = false;
+  onContextLost = (event) => {
+    event.preventDefault();
+    if (this.disposed || this.lost) return;
+    this.lost = true;
+    this.releaseResources(false);
+    this.callbacks.onContextLost?.();
+  };
+  onContextRestored = () => {
+    if (this.disposed || !this.lost) return;
+    this.lost = false;
+    this.callbacks.onContextRestored?.();
+  };
+  get isContextLost() {
+    return this.lost || this.gl?.isContextLost() === true;
+  }
+  acquireResources() {
+    if (this.disposed) throw new Error("Cannot use a disposed reflection processor.");
+    if (this.isContextLost) throw new Error("Reflection WebGL2 context was lost.");
+    if (this.resources) return this.resources;
+    const gl = this.canvas.getContext("webgl2", { premultipliedAlpha: true, preserveDrawingBuffer: false });
+    if (!gl) throw new Error("Reflection requires OffscreenCanvas WebGL2 support.");
+    if (gl.isContextLost()) throw new Error("Reflection WebGL2 context was lost.");
+    this.gl = gl;
+    const vertex = compile(gl, gl.VERTEX_SHADER, vertexSource);
+    let fragment;
+    let program = null;
+    try {
+      fragment = compile(gl, gl.FRAGMENT_SHADER, fragmentSource);
+      program = gl.createProgram();
+      if (!program) throw new Error("Could not allocate reflection program.");
+      gl.attachShader(program, vertex);
+      gl.attachShader(program, fragment);
+      gl.linkProgram(program);
+      if (!gl.getProgramParameter(program, gl.LINK_STATUS)) throw new Error(`Reflection shader link failed: ${gl.getProgramInfoLog(program)}`);
+    } catch (error) {
+      if (program) gl.deleteProgram(program);
+      throw error;
+    } finally {
+      gl.deleteShader(vertex);
+      if (fragment) gl.deleteShader(fragment);
+    }
+    const vao = gl.createVertexArray(), buffer = gl.createBuffer();
+    if (!vao || !buffer) {
+      if (vao) gl.deleteVertexArray(vao);
+      if (buffer) gl.deleteBuffer(buffer);
+      gl.deleteProgram(program);
+      throw new Error("Could not allocate reflection geometry.");
+    }
+    gl.bindVertexArray(vao);
+    gl.bindBuffer(gl.ARRAY_BUFFER, buffer);
+    gl.bufferData(gl.ARRAY_BUFFER, new Float32Array([-1, -1, 1, -1, -1, 1, 1, 1]), gl.STATIC_DRAW);
+    const location = gl.getAttribLocation(program, "p");
+    gl.enableVertexAttribArray(location);
+    gl.vertexAttribPointer(location, 2, gl.FLOAT, false, 0, 0);
+    const source = gl.createTexture();
+    if (!source) {
+      if (source) gl.deleteTexture(source);
+      gl.deleteBuffer(buffer);
+      gl.deleteVertexArray(vao);
+      gl.deleteProgram(program);
+      throw new Error("Could not allocate reflection textures.");
+    }
+    const resources = { program, vao, buffer, source };
+    gl.pixelStorei(gl.UNPACK_COLORSPACE_CONVERSION_WEBGL, gl.NONE);
+    this.resources = resources;
+    return resources;
+  }
+  apply(source, map, light, settings, coordinates, warp) {
+    const { gl, program, vao, source: sourceTexture } = this.acquireResourcesWithContext();
+    const maximum = gl.getParameter(gl.MAX_TEXTURE_SIZE);
+    if (Math.max(source.width, source.height, map.width, map.height, warp?.map.width ?? 0, warp?.map.height ?? 0) > maximum) throw new RangeError("Reflection target exceeds WebGL2 maximum texture size.");
+    if (this.canvas.width !== source.width) this.canvas.width = source.width;
+    if (this.canvas.height !== source.height) this.canvas.height = source.height;
+    gl.viewport(0, 0, source.width, source.height);
+    gl.useProgram(program);
+    gl.bindVertexArray(vao);
+    this.upload(gl, 0, sourceTexture, source, true, false);
+    const uploaded = /* @__PURE__ */ new Map();
+    const bind = (unit, raster) => {
+      if (Math.max(raster.width, raster.height) > maximum) throw new RangeError("Reflection light exceeds WebGL2 maximum texture size.");
+      let cached = this.maps.get(raster.resource);
+      if (!cached) {
+        const texture = gl.createTexture();
+        if (!texture) throw new Error("Could not allocate reflection input texture.");
+        cached = { texture, revision: -1 };
+        this.maps.set(raster.resource, cached);
+      }
+      this.upload(gl, unit, cached.texture, raster.source, false, raster.placement.mode !== "stretch", cached.revision !== raster.revision && uploaded.get(raster.resource) !== raster.revision);
+      uploaded.set(raster.resource, raster.revision);
+    };
+    bind(1, map);
+    bind(3, warp?.map ?? map);
+    let lightPlacement = { mode: "stretch" };
+    let lightWidth = 1, lightHeight = 1;
+    if ("raster" in light) {
+      bind(2, light.raster);
+      lightPlacement = light.raster.placement;
+      lightWidth = light.raster.width;
+      lightHeight = light.raster.height;
+    } else {
+      let image;
+      if ("color" in light) {
+        const canvas = this.colorCanvas ??= new OffscreenCanvas(1, 1);
+        const ctx = canvas.getContext("2d");
+        if (!ctx) throw new Error("Reflection colors require Canvas 2D.");
+        ctx.clearRect(0, 0, 1, 1);
+        ctx.fillStyle = light.color;
+        ctx.fillRect(0, 0, 1, 1);
+        image = canvas;
+      } else {
+        image = light.image;
+        lightWidth = "naturalWidth" in light.image ? light.image.naturalWidth : light.image.width;
+        lightHeight = "naturalHeight" in light.image ? light.image.naturalHeight : light.image.height;
+      }
+      bind(2, { source: image, width: lightWidth, height: lightHeight, resource: this.directKey, revision: ++this.directRevision, placement: lightPlacement });
+    }
+    const uniform = (name) => gl.getUniformLocation(program, name);
+    const placement = (origin, size, angle, value, region, width, height) => {
+      gl.uniform2f(uniform(origin), region.x + (value.offsetX ?? 0), region.y + (value.offsetY ?? 0));
+      gl.uniform2f(uniform(size), value.mode === "stretch" ? region.width : value.tileWidth ?? width, value.mode === "stretch" ? region.height : value.tileHeight ?? height);
+      gl.uniform1f(uniform(angle), (value.rotation ?? 0) * Math.PI / 180);
+    };
+    gl.uniform1i(uniform("scene"), 0);
+    gl.uniform1i(uniform("map"), 1);
+    gl.uniform1i(uniform("lightMap"), 2);
+    gl.uniform1i(uniform("warpMap"), 3);
+    gl.uniform2f(uniform("logicalOrigin"), coordinates.originX, coordinates.originY);
+    gl.uniform2f(uniform("logicalSize"), source.width / coordinates.density, source.height / coordinates.density);
+    placement("mapOrigin", "tileSize", "rotation", map.placement, coordinates.region, map.width, map.height);
+    placement("lightOrigin", "lightSize", "lightRotation", lightPlacement, coordinates.region, lightWidth, lightHeight);
+    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("opacity"), settings.opacity);
+    gl.uniform1f(uniform("threshold"), settings.threshold);
+    gl.uniform1f(uniform("softness"), settings.softness);
+    gl.drawArrays(gl.TRIANGLE_STRIP, 0, 4);
+    if (this.isContextLost) throw new Error("Reflection WebGL2 context was lost.");
+    const error = gl.getError();
+    if (error !== gl.NO_ERROR) throw new Error(`Reflection GPU processing failed (${error}).`);
+    for (const [resource, revision] of uploaded) this.maps.get(resource).revision = revision;
+    return this.canvas.transferToImageBitmap();
+  }
+  acquireResourcesWithContext() {
+    const resources = this.acquireResources();
+    const gl = this.gl;
+    if (!gl || gl.isContextLost()) throw new Error("Reflection WebGL2 context was lost.");
+    return { ...resources, gl };
+  }
+  upload(gl, unit, texture, canvas, premultiply, repeat, upload = true) {
+    gl.activeTexture(gl.TEXTURE0 + unit);
+    gl.bindTexture(gl.TEXTURE_2D, texture);
+    gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_MIN_FILTER, gl.LINEAR);
+    gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_MAG_FILTER, gl.LINEAR);
+    gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_WRAP_S, repeat ? gl.REPEAT : gl.CLAMP_TO_EDGE);
+    gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_WRAP_T, repeat ? gl.REPEAT : gl.CLAMP_TO_EDGE);
+    gl.pixelStorei(gl.UNPACK_PREMULTIPLY_ALPHA_WEBGL, premultiply);
+    if (upload) gl.texImage2D(gl.TEXTURE_2D, 0, gl.RGBA, gl.RGBA, gl.UNSIGNED_BYTE, canvas);
+  }
+  retainMaps(resources) {
+    const gl = this.gl;
+    for (const [resource, cached] of this.maps) {
+      if (resource !== this.directKey && !resources.has(resource)) {
+        if (gl && !gl.isContextLost()) gl.deleteTexture(cached.texture);
+        this.maps.delete(resource);
+      }
+    }
+  }
+  releaseResources(deleteResources) {
+    const gl = this.gl;
+    const resources = this.resources;
+    this.resources = void 0;
+    if (gl && !gl.isContextLost() && deleteResources) {
+      gl.deleteTexture(resources?.source ?? null);
+      for (const cached of this.maps.values()) gl.deleteTexture(cached.texture);
+      if (resources) {
+        gl.deleteBuffer(resources.buffer);
+        gl.deleteVertexArray(resources.vao);
+        gl.deleteProgram(resources.program);
+      }
+    }
+    this.maps.clear();
+  }
+  dispose() {
+    if (this.disposed) return;
+    this.disposed = true;
+    this.canvas.removeEventListener("webglcontextlost", this.onContextLost);
+    this.canvas.removeEventListener("webglcontextrestored", this.onContextRestored);
+    this.releaseResources(true);
+    this.canvas.width = 0;
+    this.canvas.height = 0;
+    if (this.colorCanvas) this.colorCanvas.width = this.colorCanvas.height = 0;
+    this.colorCanvas = void 0;
+  }
+}
+function compile(gl, kind, source) {
+  const shader = gl.createShader(kind);
+  if (!shader) throw new Error("Could not allocate reflection shader.");
+  gl.shaderSource(shader, source);
+  gl.compileShader(shader);
+  if (!gl.getShaderParameter(shader, gl.COMPILE_STATUS)) {
+    const error = gl.getShaderInfoLog(shader);
+    gl.deleteShader(shader);
+    throw new Error(`Reflection shader compile failed: ${error}`);
+  }
+  return shader;
+}
+export {
+  ReflectionGpu
+};
+//# sourceMappingURL=reflection-gpu.js.map

package/dist/filters/reflection-gpu.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/filters/reflection-gpu.ts"],
+  "sourcesContent": ["import type { BorrowedTextureRaster, TexturePlacement } from '../lib/textures/texture-protocol.js';\n\nexport interface ReflectionCoordinates {\n  readonly originX: number;\n  readonly originY: number;\n  readonly density: number;\n  readonly region: Readonly<{ x: number; y: number; width: number; height: number }>;\n}\nexport interface ReflectionGpuCallbacks {\n  readonly onContextLost?: () => void;\n  readonly onContextRestored?: () => void;\n}\nconst vertexSource = `#version 300 es\nin vec2 p;\nout vec2 uv;\nvoid main() { uv = vec2((p.x + 1.) * .5, 1. - (p.y + 1.) * .5); gl_Position = vec4(p, 0, 1); }\n`;\nexport interface ReflectionSettings {\n  readonly opacity: number; readonly threshold: number; readonly softness: number;\n  readonly direction: readonly [number, number];\n}\nexport type ReflectionLight = { readonly color: string } | { readonly image: HTMLImageElement | ImageBitmap } | { readonly raster: BorrowedTextureRaster };\nexport interface ReflectionWarp { readonly map: BorrowedTextureRaster; readonly strength: number; readonly region: ReflectionCoordinates['region']; }\nconst fragmentSource = `#version 300 es\nprecision highp float;\nuniform sampler2D scene, map, lightMap, warpMap;\nuniform vec2 logicalOrigin, logicalSize, mapOrigin, tileSize, lightOrigin, lightSize, warpOrigin, warpSize, warpStrength, direction;\nuniform float rotation, lightRotation, warpRotation, opacity, threshold, softness;\nin vec2 uv;\nout vec4 outputColor;\nfloat decode(float c) { float b=c*255.; return (b-128.)/(b<128.?128.:127.); }\nvec2 coordinates(vec2 origin, vec2 size, float angle) {\n  vec2 p=logicalOrigin+uv*logicalSize-origin;\n  float c=cos(angle),s=sin(angle);\n  return vec2(c*p.x+s*p.y,-s*p.x+c*p.y)/size;\n}\nvec4 sourcePixel(ivec2 p) {\n  ivec2 size=textureSize(scene,0);\n  if(any(lessThan(p,ivec2(0)))||any(greaterThanEqual(p,size))) return vec4(0);\n  return texelFetch(scene,p,0);\n}\nvec4 sourceSample(vec2 p) {\n  vec2 pixel=p*vec2(textureSize(scene,0))-.5;\n  ivec2 base=ivec2(floor(pixel)); vec2 f=fract(pixel);\n  return mix(mix(sourcePixel(base),sourcePixel(base+ivec2(1,0)),f.x),mix(sourcePixel(base+ivec2(0,1)),sourcePixel(base+ivec2(1,1)),f.x),f.y);\n}\nvoid main() {\n  vec4 warp=texture(warpMap,coordinates(warpOrigin,warpSize,warpRotation));\n  vec4 base=sourceSample(uv+vec2(decode(warp.r),decode(warp.g))*warp.a*warpStrength);\n  vec4 field=texture(map,coordinates(mapOrigin,tileSize,rotation));\n  vec2 slope=vec2(decode(field.r),decode(field.g));\n  float coverage=smoothstep(threshold,threshold+softness,dot(slope,direction))*field.a*opacity;\n  vec4 light=texture(lightMap,coordinates(lightOrigin,lightSize,lightRotation)+slope*.035);\n  float amount=coverage*light.a;\n  outputColor=vec4(base.rgb*(1.-amount)+base.a*light.rgb*amount,base.a);\n}\n`;\n\n/** Optional synchronous image processor; scene pixels are never read back. */\nexport class ReflectionGpu {\n  private readonly canvas = new OffscreenCanvas(1, 1);\n  private gl: WebGL2RenderingContext | undefined;\n  private resources: ReflectionResources | undefined;\n  private readonly maps = new Map<object, { texture: WebGLTexture; revision: number }>();\n  private readonly directKey = {};\n  private colorCanvas: OffscreenCanvas | undefined;\n  private directRevision = 0;\n  private disposed = false;\n  private lost = false;\n  private readonly onContextLost = (event: Event): void => {\n    event.preventDefault();\n    if (this.disposed || this.lost) return;\n    this.lost = true;\n    this.releaseResources(false);\n    this.callbacks.onContextLost?.();\n  };\n  private readonly onContextRestored = (): void => {\n    if (this.disposed || !this.lost) return;\n    this.lost = false;\n    this.callbacks.onContextRestored?.();\n  };\n\n  constructor(private readonly callbacks: Readonly<ReflectionGpuCallbacks> = {}) {\n    this.canvas.addEventListener('webglcontextlost', this.onContextLost);\n    this.canvas.addEventListener('webglcontextrestored', this.onContextRestored);\n  }\n\n  get isContextLost(): boolean {\n    return this.lost || this.gl?.isContextLost() === true;\n  }\n\n  private acquireResources(): ReflectionResources {\n    if (this.disposed) throw new Error('Cannot use a disposed reflection processor.');\n    if (this.isContextLost) throw new Error('Reflection WebGL2 context was lost.');\n    if (this.resources) return this.resources;\n    const gl = this.canvas.getContext('webgl2', { premultipliedAlpha: true, preserveDrawingBuffer: false });\n    if (!gl) throw new Error('Reflection requires OffscreenCanvas WebGL2 support.');\n    if (gl.isContextLost()) throw new Error('Reflection WebGL2 context was lost.');\n    this.gl = gl;\n    const vertex = compile(gl, gl.VERTEX_SHADER, vertexSource);\n    let fragment: WebGLShader | undefined;\n    let program: WebGLProgram | null = null;\n    try {\n      fragment = compile(gl, gl.FRAGMENT_SHADER, fragmentSource);\n      program = gl.createProgram();\n      if (!program) throw new Error('Could not allocate reflection program.');\n      gl.attachShader(program, vertex); gl.attachShader(program, fragment); gl.linkProgram(program);\n      if (!gl.getProgramParameter(program, gl.LINK_STATUS)) throw new Error(`Reflection shader link failed: ${gl.getProgramInfoLog(program)}`);\n    } catch (error) { if (program) gl.deleteProgram(program); throw error; }\n    finally { gl.deleteShader(vertex); if (fragment) gl.deleteShader(fragment); }\n    const vao = gl.createVertexArray(), buffer = gl.createBuffer();\n    if (!vao || !buffer) { if (vao) gl.deleteVertexArray(vao); if (buffer) gl.deleteBuffer(buffer); gl.deleteProgram(program); throw new Error('Could not allocate reflection geometry.'); }\n    gl.bindVertexArray(vao); gl.bindBuffer(gl.ARRAY_BUFFER, buffer);\n    gl.bufferData(gl.ARRAY_BUFFER, new Float32Array([-1, -1, 1, -1, -1, 1, 1, 1]), gl.STATIC_DRAW);\n    const location = gl.getAttribLocation(program, 'p');\n    gl.enableVertexAttribArray(location); gl.vertexAttribPointer(location, 2, gl.FLOAT, false, 0, 0);\n    const source = gl.createTexture();\n    if (!source) {\n      if (source) gl.deleteTexture(source);\n      gl.deleteBuffer(buffer); gl.deleteVertexArray(vao); gl.deleteProgram(program);\n      throw new Error('Could not allocate reflection textures.');\n    }\n    const resources: ReflectionResources = { program, vao, buffer, source };\n    gl.pixelStorei(gl.UNPACK_COLORSPACE_CONVERSION_WEBGL, gl.NONE);\n    this.resources = resources;\n    return resources;\n  }\n\n  apply(source: OffscreenCanvas, map: BorrowedTextureRaster, light: ReflectionLight, settings: ReflectionSettings, coordinates: ReflectionCoordinates, warp?: ReflectionWarp): ImageBitmap {\n    const { gl, program, vao, source: sourceTexture } = this.acquireResourcesWithContext();\n    const maximum = gl.getParameter(gl.MAX_TEXTURE_SIZE) as number;\n    if (Math.max(source.width, source.height, map.width, map.height, warp?.map.width ?? 0, warp?.map.height ?? 0) > maximum) throw new RangeError('Reflection target exceeds WebGL2 maximum texture size.');\n    if (this.canvas.width !== source.width) this.canvas.width = source.width;\n    if (this.canvas.height !== source.height) this.canvas.height = source.height;\n    gl.viewport(0, 0, source.width, source.height); gl.useProgram(program); gl.bindVertexArray(vao);\n    this.upload(gl, 0, sourceTexture, source, true, false);\n    const uploaded = new Map<object, number>();\n    const bind = (unit: number, raster: {source: TexImageSource; width:number; height:number; resource:object; revision:number; placement:Readonly<TexturePlacement>}) => {\n      if (Math.max(raster.width,raster.height)>maximum) throw new RangeError('Reflection light exceeds WebGL2 maximum texture size.');\n      let cached=this.maps.get(raster.resource);\n      if (!cached) {\n        const texture=gl.createTexture(); if(!texture) throw new Error('Could not allocate reflection input texture.');\n        cached={texture,revision:-1}; this.maps.set(raster.resource,cached);\n      }\n      this.upload(gl,unit,cached.texture,raster.source,false,raster.placement.mode!=='stretch',cached.revision!==raster.revision && uploaded.get(raster.resource)!==raster.revision);\n      uploaded.set(raster.resource,raster.revision);\n    };\n    bind(1,map); bind(3,warp?.map ?? map);\n    let lightPlacement: Readonly<TexturePlacement> = {mode:'stretch'};\n    let lightWidth=1,lightHeight=1;\n    if ('raster' in light) { bind(2,light.raster); lightPlacement=light.raster.placement; lightWidth=light.raster.width; lightHeight=light.raster.height; }\n    else {\n      let image: TexImageSource;\n      if ('color' in light) {\n        const canvas=this.colorCanvas ??= new OffscreenCanvas(1,1);\n        const ctx=canvas.getContext('2d'); if(!ctx) throw new Error('Reflection colors require Canvas 2D.');\n        ctx.clearRect(0,0,1,1); ctx.fillStyle=light.color; ctx.fillRect(0,0,1,1); image=canvas;\n      } else { image=light.image; lightWidth='naturalWidth' in light.image?light.image.naturalWidth:light.image.width; lightHeight='naturalHeight' in light.image?light.image.naturalHeight:light.image.height; }\n      bind(2,{source:image,width:lightWidth,height:lightHeight,resource:this.directKey,revision:++this.directRevision,placement:lightPlacement});\n    }\n    const uniform=(name:string)=>gl.getUniformLocation(program,name);\n    const placement=(origin:string,size:string,angle:string,value:Readonly<TexturePlacement>,region:ReflectionCoordinates['region'],width:number,height:number)=>{\n      gl.uniform2f(uniform(origin),region.x+(value.offsetX??0),region.y+(value.offsetY??0));\n      gl.uniform2f(uniform(size),value.mode==='stretch'?region.width:value.tileWidth??width,value.mode==='stretch'?region.height:value.tileHeight??height);\n      gl.uniform1f(uniform(angle),(value.rotation??0)*Math.PI/180);\n    };\n    gl.uniform1i(uniform('scene'),0); gl.uniform1i(uniform('map'),1); gl.uniform1i(uniform('lightMap'),2); gl.uniform1i(uniform('warpMap'),3);\n    gl.uniform2f(uniform('logicalOrigin'),coordinates.originX,coordinates.originY);\n    gl.uniform2f(uniform('logicalSize'),source.width/coordinates.density,source.height/coordinates.density);\n    placement('mapOrigin','tileSize','rotation',map.placement,coordinates.region,map.width,map.height);\n    placement('lightOrigin','lightSize','lightRotation',lightPlacement,coordinates.region,lightWidth,lightHeight);\n    placement('warpOrigin','warpSize','warpRotation',warp?.map.placement??map.placement,warp?.region??coordinates.region,warp?.map.width??map.width,warp?.map.height??map.height);\n    gl.uniform2f(uniform('warpStrength'),(warp?.strength??0)*coordinates.density/source.width,(warp?.strength??0)*coordinates.density/source.height);\n    gl.uniform2f(uniform('direction'),settings.direction[0],settings.direction[1]);\n    gl.uniform1f(uniform('opacity'),settings.opacity); gl.uniform1f(uniform('threshold'),settings.threshold); gl.uniform1f(uniform('softness'),settings.softness);\n    gl.drawArrays(gl.TRIANGLE_STRIP,0,4);\n    if(this.isContextLost) throw new Error('Reflection WebGL2 context was lost.');\n    const error=gl.getError(); if(error!==gl.NO_ERROR) throw new Error(`Reflection GPU processing failed (${error}).`);\n    for(const [resource,revision] of uploaded) this.maps.get(resource)!.revision=revision;\n    return this.canvas.transferToImageBitmap();\n  }\n  private acquireResourcesWithContext(): ReflectionResources & { gl: WebGL2RenderingContext } {\n    const resources = this.acquireResources();\n    const gl = this.gl;\n    if (!gl || gl.isContextLost()) throw new Error('Reflection WebGL2 context was lost.');\n    return { ...resources, gl };\n  }\n  private upload(gl: WebGL2RenderingContext, unit: number, texture: WebGLTexture, canvas: TexImageSource, premultiply: boolean, repeat: boolean, upload = true): void {\n    gl.activeTexture(gl.TEXTURE0 + unit); gl.bindTexture(gl.TEXTURE_2D, texture);\n    gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_MIN_FILTER, gl.LINEAR);\n    gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_MAG_FILTER, gl.LINEAR);\n    gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_WRAP_S, repeat ? gl.REPEAT : gl.CLAMP_TO_EDGE);\n    gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_WRAP_T, repeat ? gl.REPEAT : gl.CLAMP_TO_EDGE);\n    gl.pixelStorei(gl.UNPACK_PREMULTIPLY_ALPHA_WEBGL, premultiply);\n    if (upload) gl.texImage2D(gl.TEXTURE_2D, 0, gl.RGBA, gl.RGBA, gl.UNSIGNED_BYTE, canvas);\n  }\n  retainMaps(resources: ReadonlySet<object>): void {\n    const gl = this.gl;\n    for (const [resource, cached] of this.maps) {\n      if (resource !== this.directKey && !resources.has(resource)) { if (gl && !gl.isContextLost()) gl.deleteTexture(cached.texture); this.maps.delete(resource); }\n    }\n  }\n  private releaseResources(deleteResources: boolean): void {\n    const gl = this.gl;\n    const resources = this.resources;\n    this.resources = undefined;\n    if (gl && !gl.isContextLost() && deleteResources) {\n      gl.deleteTexture(resources?.source ?? null);\n      for (const cached of this.maps.values()) gl.deleteTexture(cached.texture);\n      if (resources) { gl.deleteBuffer(resources.buffer); gl.deleteVertexArray(resources.vao); gl.deleteProgram(resources.program); }\n    }\n    this.maps.clear();\n  }\n  dispose(): void {\n    if (this.disposed) return;\n    this.disposed = true;\n    this.canvas.removeEventListener('webglcontextlost', this.onContextLost);\n    this.canvas.removeEventListener('webglcontextrestored', this.onContextRestored);\n    this.releaseResources(true);\n    this.canvas.width = 0; this.canvas.height = 0;\n    if(this.colorCanvas) this.colorCanvas.width=this.colorCanvas.height=0;\n    this.colorCanvas=undefined;\n  }\n}\ninterface ReflectionResources {\n  readonly program: WebGLProgram;\n  readonly vao: WebGLVertexArrayObject;\n  readonly buffer: WebGLBuffer;\n  readonly source: WebGLTexture;\n}\nfunction compile(gl: WebGL2RenderingContext, kind: number, source: string): WebGLShader {\n  const shader = gl.createShader(kind);\n  if (!shader) throw new Error('Could not allocate reflection shader.');\n  gl.shaderSource(shader, source); gl.compileShader(shader);\n  if (!gl.getShaderParameter(shader, gl.COMPILE_STATUS)) {\n    const error = gl.getShaderInfoLog(shader); gl.deleteShader(shader);\n    throw new Error(`Reflection shader compile failed: ${error}`);\n  }\n  return shader;\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/filters/render-displacement-boundary.d.ts

@@ -0,0 +1,12 @@
+import { type TexturePaint } from '../lib/textures/texture-protocol.js';
+import type { PibblInstance } from '../lib/types.js';
+import type { FilterWindows } from '../lib/filter/filter-region.js';
+import { DisplacementGpu } from './displacement-gpu.js';
+/** @internal Test-only read-only access; it never creates a GPU service. */
+export declare function peekDisplacementGpu(instance: PibblInstance): DisplacementGpu | undefined;
+export declare function processDisplacement(source: OffscreenCanvas, windows: FilterWindows, paint: TexturePaint, strength: number, region: Readonly<{
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}>, blurRadius?: number): ImageBitmap;

package/dist/filters/render-displacement-boundary.js

@@ -0,0 +1,116 @@
+import { borrowTextureRaster } from "../lib/textures/texture-protocol.js";
+import { GLOBAL_STATE, getPibblInstance } from "../lib/global-state.js";
+import { getOptionalService } from "../lib/optional-services.js";
+import { update } from "../lib/update.js";
+import { DisplacementGpu } from "./displacement-gpu.js";
+const GPU_BORROWER = /* @__PURE__ */ Symbol("pibbl.displacement-borrower");
+const rootServices = /* @__PURE__ */ new WeakMap();
+class RootGpuService {
+  constructor(root) {
+    this.root = root;
+    this.gpu = new DisplacementGpu({
+      onContextRestored: () => {
+        if (this.disposed || this.recoveryRequested || this.root.mainTeardowns.closed) return;
+        this.recoveryRequested = true;
+        for (const borrower of this.borrowers) update(borrower.instance.canvas, void 0, true);
+      }
+    });
+  }
+  root;
+  gpu;
+  borrowers = /* @__PURE__ */ new Set();
+  disposed = false;
+  recoveryRequested = false;
+  beginRender() {
+    this.recoveryRequested = false;
+  }
+  pruneMaps() {
+    const resources = /* @__PURE__ */ new Set();
+    for (const borrower of this.borrowers) for (const resource of borrower.resources) resources.add(resource);
+    this.gpu.retainMaps(resources);
+  }
+  dispose() {
+    this.disposed = true;
+    this.gpu.dispose();
+  }
+}
+class GpuBorrower {
+  constructor(instance) {
+    this.instance = instance;
+    let root = instance;
+    while (root.parent) root = getPibblInstance(root.parent);
+    this.root = root;
+    let shared = rootServices.get(root);
+    if (!shared) {
+      shared = new RootGpuService(root);
+      rootServices.set(root, shared);
+    }
+    this.shared = shared;
+    shared.borrowers.add(this);
+  }
+  instance;
+  used = false;
+  resources = /* @__PURE__ */ new Set();
+  candidates = /* @__PURE__ */ new Set();
+  committed = false;
+  disposed = false;
+  shared;
+  root;
+  beginRender() {
+    this.shared.beginRender();
+    this.used = false;
+    this.candidates.clear();
+  }
+  useMap(resource) {
+    this.candidates.add(resource);
+  }
+  endRender(success) {
+    if (success && this.used) {
+      this.committed = true;
+      this.resources = new Set(this.candidates);
+      this.shared.pruneMaps();
+      return;
+    }
+    if (success || !this.committed) {
+      this.dispose();
+      return;
+    }
+    if (!this.shared.gpu.isContextLost) this.shared.pruneMaps();
+  }
+  dispose() {
+    if (this.disposed) return;
+    this.disposed = true;
+    this.instance.optionalServices.delete(GPU_BORROWER);
+    this.shared.borrowers.delete(this);
+    if (this.shared.borrowers.size === 0) {
+      rootServices.delete(this.root);
+      this.shared.dispose();
+    } else this.shared.pruneMaps();
+  }
+}
+function peekDisplacementGpu(instance) {
+  let root = instance;
+  while (root.parent) root = getPibblInstance(root.parent);
+  return rootServices.get(root)?.gpu;
+}
+function processDisplacement(source, windows, paint, strength, region, blurRadius = 0) {
+  const instance = GLOBAL_STATE.currentPibblInstance;
+  if (!instance) throw new Error("Displacement requires an active Pibbl instance.");
+  const borrower = getOptionalService(instance, GPU_BORROWER, () => new GpuBorrower(instance));
+  borrower.used = true;
+  return borrowTextureRaster(paint, (map) => {
+    borrower.useMap(map.resource);
+    return borrower.shared.gpu.apply(source, map, strength * windows.density, map.placement, {
+      originX: windows.source.backingX / windows.density,
+      originY: windows.source.backingY / windows.density,
+      density: windows.density,
+      region,
+      blurRadius
+    });
+  });
+}
+export {
+  peekDisplacementGpu,
+  processDisplacement
+};
+//# sourceMappingURL=render-displacement-boundary.js.map

package/dist/filters/render-displacement-boundary.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/filters/render-displacement-boundary.ts"],
+  "sourcesContent": ["import { borrowTextureRaster, type TexturePaint } from '../lib/textures/texture-protocol.js';\nimport { GLOBAL_STATE, getPibblInstance } from '../lib/global-state.js';\nimport { getOptionalService } from '../lib/optional-services.js';\nimport { update } from '../lib/update.js';\nimport type { PibblInstance } from '../lib/types.js';\nimport type { FilterWindows } from '../lib/filter/filter-region.js';\nimport { DisplacementGpu } from './displacement-gpu.js';\n\nconst GPU_BORROWER = Symbol('pibbl.displacement-borrower');\nconst rootServices = new WeakMap<PibblInstance, RootGpuService>();\n\nclass RootGpuService {\n  readonly gpu: DisplacementGpu;\n  readonly borrowers = new Set<GpuBorrower>();\n  private disposed = false;\n  private recoveryRequested = false;\n  constructor(private readonly root: PibblInstance) {\n    this.gpu = new DisplacementGpu({\n      onContextRestored: () => {\n        if (this.disposed || this.recoveryRequested || this.root.mainTeardowns.closed) return;\n        this.recoveryRequested = true;\n        for (const borrower of this.borrowers) update(borrower.instance.canvas, undefined, true);\n      },\n    });\n  }\n  beginRender(): void { this.recoveryRequested = false; }\n  pruneMaps(): void {\n    const resources = new Set<object>();\n    for (const borrower of this.borrowers) for (const resource of borrower.resources) resources.add(resource);\n    this.gpu.retainMaps(resources);\n  }\n  dispose(): void {\n    this.disposed = true;\n    this.gpu.dispose();\n  }\n}\n\nclass GpuBorrower {\n  used = false;\n  resources = new Set<object>();\n  private candidates = new Set<object>();\n  private committed = false;\n  private disposed = false;\n  readonly shared: RootGpuService;\n  private readonly root: PibblInstance;\n  constructor(readonly instance: PibblInstance) {\n    let root = instance;\n    while (root.parent) root = getPibblInstance(root.parent);\n    this.root = root;\n    let shared = rootServices.get(root);\n    if (!shared) { shared = new RootGpuService(root); rootServices.set(root, shared); }\n    this.shared = shared;\n    shared.borrowers.add(this);\n  }\n  beginRender(): void { this.shared.beginRender(); this.used = false; this.candidates.clear(); }\n  useMap(resource: object): void { this.candidates.add(resource); }\n  endRender(success: boolean): void {\n    if (success && this.used) {\n      this.committed = true;\n      this.resources = new Set(this.candidates);\n      this.shared.pruneMaps();\n      return;\n    }\n    if (success || !this.committed) {\n      this.dispose();\n      return;\n    }\n    if (!this.shared.gpu.isContextLost) this.shared.pruneMaps();\n  }\n  dispose(): void {\n    if (this.disposed) return;\n    this.disposed = true;\n    this.instance.optionalServices.delete(GPU_BORROWER);\n    this.shared.borrowers.delete(this);\n    if (this.shared.borrowers.size === 0) {\n      rootServices.delete(this.root);\n      this.shared.dispose();\n    } else this.shared.pruneMaps();\n  }\n}\n\n/** @internal Test-only read-only access; it never creates a GPU service. */\nexport function peekDisplacementGpu(instance: PibblInstance): DisplacementGpu | undefined {\n  let root = instance;\n  while (root.parent) root = getPibblInstance(root.parent);\n  return rootServices.get(root)?.gpu;\n}\n\nexport function processDisplacement(source: OffscreenCanvas, windows: FilterWindows, paint: TexturePaint, strength: number, region: Readonly<{ x: number; y: number; width: number; height: number }>, blurRadius = 0): ImageBitmap {\n  const instance = GLOBAL_STATE.currentPibblInstance;\n  if (!instance) throw new Error('Displacement requires an active Pibbl instance.');\n  const borrower = getOptionalService(instance, GPU_BORROWER, () => new GpuBorrower(instance));\n  borrower.used = true;\n  return borrowTextureRaster(paint, map => {\n    borrower.useMap(map.resource);\n    return borrower.shared.gpu.apply(source, map, strength * windows.density, map.placement, {\n      originX: windows.source.backingX / windows.density,\n      originY: windows.source.backingY / windows.density,\n      density: windows.density, region, blurRadius,\n    });\n  });\n}\n"],
+  "mappings": "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",
+  "names": []
+}