@pibbl/core 0.0.1

package/dist/filters/displacement-gpu.js

@@ -0,0 +1,243 @@
+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;
+uniform vec2 blurStep, strength, logicalOrigin, logicalSize, mapOrigin, tileSize;
+uniform float rotation;
+in vec2 uv;
+out vec4 outputColor;
+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);
+}
+float decode(float channel) {
+  float byteValue = channel * 255.;
+  return (byteValue - 128.) / (byteValue < 128. ? 128. : 127.);
+}
+void main() {
+  vec2 local = logicalOrigin + uv * logicalSize - mapOrigin;
+  float c = cos(rotation), s = sin(rotation);
+  vec2 mapUV = vec2(c * local.x + s * local.y, -s * local.x + c * local.y) / tileSize;
+  vec4 field = texture(map, mapUV);
+  vec2 displacement = vec2(decode(field.r), decode(field.g)) * field.a * strength;
+  vec2 at = uv + displacement;
+  vec2 spread = blurStep * field.b * field.a;
+  if (max(spread.x, spread.y) <= 0.) {
+    outputColor = sourceSample(at);
+  } else {
+    // Mip-filtered samples remove wide-kernel aliasing. Offsets plus the
+    // selected mip footprint stay inside the declared blur support radius.
+    float radiusPixels = spread.x * float(textureSize(scene, 0).x);
+    float level = max(0., log2(max(1., radiusPixels * .5)));
+    vec4 color = vec4(0);
+    for (int y = -2; y <= 2; y++) for (int x = -2; x <= 2; x++) {
+      float wx = x == 0 ? 6. : (abs(x) == 1 ? 4. : 1.);
+      float wy = y == 0 ? 6. : (abs(y) == 1 ? 4. : 1.);
+      vec2 sampleUV = at + vec2(float(x), float(y)) * spread * .25;
+      vec4 sampleColor = any(lessThan(sampleUV, vec2(0))) || any(greaterThan(sampleUV, vec2(1)))
+        ? vec4(0) : textureLod(scene, sampleUV, level);
+      color += sampleColor * wx * wy;
+    }
+    outputColor = color / 256.;
+  }
+}
+`;
+class DisplacementGpu {
+  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();
+  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 displacement processor.");
+    if (this.isContextLost) throw new Error("Displacement 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("Displacement requires OffscreenCanvas WebGL2 support.");
+    if (gl.isContextLost()) throw new Error("Displacement 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 displacement program.");
+      gl.attachShader(program, vertex);
+      gl.attachShader(program, fragment);
+      gl.linkProgram(program);
+      if (!gl.getProgramParameter(program, gl.LINK_STATUS)) throw new Error(`Displacement 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 displacement 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 displacement textures.");
+    }
+    const resources = { program, vao, buffer, source };
+    gl.pixelStorei(gl.UNPACK_COLORSPACE_CONVERSION_WEBGL, gl.NONE);
+    this.resources = resources;
+    return resources;
+  }
+  apply(source, map, strengthPixels, placement = map.placement, coordinates) {
+    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) > maximum) throw new RangeError("Displacement 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);
+    if ((coordinates?.blurRadius ?? 0) > 0) {
+      gl.generateMipmap(gl.TEXTURE_2D);
+      gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_MIN_FILTER, gl.LINEAR_MIPMAP_LINEAR);
+    }
+    let cached = this.maps.get(map.resource);
+    if (!cached) {
+      const texture = gl.createTexture();
+      if (!texture) throw new Error("Could not allocate displacement map texture.");
+      cached = { texture, revision: -1 };
+      this.maps.set(map.resource, cached);
+    }
+    this.upload(gl, 1, cached.texture, map.source, false, placement.mode !== "stretch", cached.revision !== map.revision);
+    const density = coordinates?.density ?? 1;
+    const region = coordinates?.region ?? { x: 0, y: 0, width: source.width / density, height: source.height / density };
+    const uniform = (name) => gl.getUniformLocation(program, name);
+    gl.uniform1i(uniform("scene"), 0);
+    gl.uniform1i(uniform("map"), 1);
+    gl.uniform2f(uniform("blurStep"), (coordinates?.blurRadius ?? 0) * density / source.width, (coordinates?.blurRadius ?? 0) * density / source.height);
+    gl.uniform2f(uniform("strength"), strengthPixels / source.width, strengthPixels / source.height);
+    gl.uniform2f(uniform("logicalOrigin"), coordinates?.originX ?? 0, coordinates?.originY ?? 0);
+    gl.uniform2f(uniform("logicalSize"), source.width / density, source.height / density);
+    gl.uniform2f(uniform("mapOrigin"), region.x + (placement.offsetX ?? 0), region.y + (placement.offsetY ?? 0));
+    gl.uniform2f(uniform("tileSize"), placement.mode === "stretch" ? region.width : placement.tileWidth ?? map.width, placement.mode === "stretch" ? region.height : placement.tileHeight ?? map.height);
+    gl.uniform1f(uniform("rotation"), (placement.rotation ?? 0) * Math.PI / 180);
+    gl.drawArrays(gl.TRIANGLE_STRIP, 0, 4);
+    if (this.isContextLost) throw new Error("Displacement WebGL2 context was lost.");
+    const error = gl.getError();
+    if (error !== gl.NO_ERROR) throw new Error(`Displacement GPU processing failed (${error}).`);
+    cached.revision = map.revision;
+    return this.canvas.transferToImageBitmap();
+  }
+  acquireResourcesWithContext() {
+    const resources = this.acquireResources();
+    const gl = this.gl;
+    if (!gl || gl.isContextLost()) throw new Error("Displacement 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 (!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;
+  }
+}
+function compile(gl, kind, source) {
+  const shader = gl.createShader(kind);
+  if (!shader) throw new Error("Could not allocate displacement 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(`Displacement shader compile failed: ${error}`);
+  }
+  return shader;
+}
+export {
+  DisplacementGpu
+};
+//# sourceMappingURL=displacement-gpu.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/filters/displacement-gpu.ts"],
+  "sourcesContent": ["import type { BorrowedTextureRaster, TexturePlacement } from '../lib/textures/texture-protocol.js';\n\nexport interface DisplacementCoordinates {\n  readonly blurRadius?: number;\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 DisplacementGpuCallbacks {\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`;\nconst fragmentSource = `#version 300 es\nprecision highp float;\nuniform sampler2D scene, map;\nuniform vec2 blurStep, strength, logicalOrigin, logicalSize, mapOrigin, tileSize;\nuniform float rotation;\nin vec2 uv;\nout vec4 outputColor;\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));\n  vec2 f = fract(pixel);\n  return mix(mix(sourcePixel(base), sourcePixel(base + ivec2(1, 0)), f.x),\n             mix(sourcePixel(base + ivec2(0, 1)), sourcePixel(base + ivec2(1, 1)), f.x), f.y);\n}\nfloat decode(float channel) {\n  float byteValue = channel * 255.;\n  return (byteValue - 128.) / (byteValue < 128. ? 128. : 127.);\n}\nvoid main() {\n  vec2 local = logicalOrigin + uv * logicalSize - mapOrigin;\n  float c = cos(rotation), s = sin(rotation);\n  vec2 mapUV = vec2(c * local.x + s * local.y, -s * local.x + c * local.y) / tileSize;\n  vec4 field = texture(map, mapUV);\n  vec2 displacement = vec2(decode(field.r), decode(field.g)) * field.a * strength;\n  vec2 at = uv + displacement;\n  vec2 spread = blurStep * field.b * field.a;\n  if (max(spread.x, spread.y) <= 0.) {\n    outputColor = sourceSample(at);\n  } else {\n    // Mip-filtered samples remove wide-kernel aliasing. Offsets plus the\n    // selected mip footprint stay inside the declared blur support radius.\n    float radiusPixels = spread.x * float(textureSize(scene, 0).x);\n    float level = max(0., log2(max(1., radiusPixels * .5)));\n    vec4 color = vec4(0);\n    for (int y = -2; y <= 2; y++) for (int x = -2; x <= 2; x++) {\n      float wx = x == 0 ? 6. : (abs(x) == 1 ? 4. : 1.);\n      float wy = y == 0 ? 6. : (abs(y) == 1 ? 4. : 1.);\n      vec2 sampleUV = at + vec2(float(x), float(y)) * spread * .25;\n      vec4 sampleColor = any(lessThan(sampleUV, vec2(0))) || any(greaterThan(sampleUV, vec2(1)))\n        ? vec4(0) : textureLod(scene, sampleUV, level);\n      color += sampleColor * wx * wy;\n    }\n    outputColor = color / 256.;\n  }\n}\n`;\n\n/** Optional synchronous image processor; scene pixels are never read back. */\nexport class DisplacementGpu {\n  private readonly canvas = new OffscreenCanvas(1, 1);\n  private gl: WebGL2RenderingContext | undefined;\n  private resources: DisplacementResources | undefined;\n  private readonly maps = new Map<object, { texture: WebGLTexture; revision: number }>();\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<DisplacementGpuCallbacks> = {}) {\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(): DisplacementResources {\n    if (this.disposed) throw new Error('Cannot use a disposed displacement processor.');\n    if (this.isContextLost) throw new Error('Displacement 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('Displacement requires OffscreenCanvas WebGL2 support.');\n    if (gl.isContextLost()) throw new Error('Displacement 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 displacement program.');\n      gl.attachShader(program, vertex); gl.attachShader(program, fragment); gl.linkProgram(program);\n      if (!gl.getProgramParameter(program, gl.LINK_STATUS)) throw new Error(`Displacement 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 displacement 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 displacement textures.');\n    }\n    const resources: DisplacementResources = { 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, strengthPixels: number, placement: Readonly<TexturePlacement> = map.placement, coordinates?: DisplacementCoordinates): 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) > maximum) throw new RangeError('Displacement 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);\n    gl.useProgram(program); gl.bindVertexArray(vao);\n    this.upload(gl, 0, sourceTexture, source, true, false);\n    if ((coordinates?.blurRadius ?? 0) > 0) {\n      gl.generateMipmap(gl.TEXTURE_2D);\n      gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_MIN_FILTER, gl.LINEAR_MIPMAP_LINEAR);\n    }\n    let cached = this.maps.get(map.resource);\n    if (!cached) {\n      const texture = gl.createTexture();\n      if (!texture) throw new Error('Could not allocate displacement map texture.');\n      cached = { texture, revision: -1 };\n      this.maps.set(map.resource, cached);\n    }\n    this.upload(gl, 1, cached.texture, map.source, false, placement.mode !== 'stretch', cached.revision !== map.revision);\n    const density = coordinates?.density ?? 1;\n    const region = coordinates?.region ?? { x: 0, y: 0, width: source.width / density, height: source.height / density };\n    const uniform = (name: string) => gl.getUniformLocation(program, name);\n    gl.uniform1i(uniform('scene'), 0); gl.uniform1i(uniform('map'), 1);\n    gl.uniform2f(uniform('blurStep'), (coordinates?.blurRadius ?? 0) * density / source.width, (coordinates?.blurRadius ?? 0) * density / source.height);\n    gl.uniform2f(uniform('strength'), strengthPixels / source.width, strengthPixels / source.height);\n    gl.uniform2f(uniform('logicalOrigin'), coordinates?.originX ?? 0, coordinates?.originY ?? 0);\n    gl.uniform2f(uniform('logicalSize'), source.width / density, source.height / density);\n    gl.uniform2f(uniform('mapOrigin'), region.x + (placement.offsetX ?? 0), region.y + (placement.offsetY ?? 0));\n    gl.uniform2f(uniform('tileSize'), placement.mode === 'stretch' ? region.width : placement.tileWidth ?? map.width, placement.mode === 'stretch' ? region.height : placement.tileHeight ?? map.height);\n    gl.uniform1f(uniform('rotation'), (placement.rotation ?? 0) * Math.PI / 180);\n    gl.drawArrays(gl.TRIANGLE_STRIP, 0, 4);\n    if (this.isContextLost) throw new Error('Displacement WebGL2 context was lost.');\n    const error = gl.getError();\n    if (error !== gl.NO_ERROR) throw new Error(`Displacement GPU processing failed (${error}).`);\n    cached.revision = map.revision;\n    return this.canvas.transferToImageBitmap();\n  }\n  private acquireResourcesWithContext(): DisplacementResources & { gl: WebGL2RenderingContext } {\n    const resources = this.acquireResources();\n    const gl = this.gl;\n    if (!gl || gl.isContextLost()) throw new Error('Displacement WebGL2 context was lost.');\n    return { ...resources, gl };\n  }\n  private upload(gl: WebGL2RenderingContext, unit: number, texture: WebGLTexture, canvas: OffscreenCanvas, 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 (!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  }\n}\ninterface DisplacementResources {\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 displacement 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(`Displacement shader compile failed: ${error}`);\n  }\n  return shader;\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/filters/displacement-math.d.ts

@@ -0,0 +1,5 @@
+import type { PixelBounds } from '../lib/filter/filter-region.js';
+/** Decodes Pibbl's exact signed eight-bit displacement encoding. */
+export declare function decodeDisplacementChannel(value: number): number;
+/** Expands a sampled scene window by maximum displacement and bilinear support. */
+export declare function expandDisplacementInput(output: Readonly<PixelBounds>, strength: number, density: number): PixelBounds;

package/dist/filters/displacement-math.js

@@ -0,0 +1,22 @@
+function decodeDisplacementChannel(value) {
+  if (!Number.isFinite(value)) throw new RangeError("Displacement channel must be finite.");
+  const channel = Math.min(255, Math.max(0, value));
+  return channel < 128 ? (channel - 128) / 128 : (channel - 128) / 127;
+}
+function expandDisplacementInput(output, strength, density) {
+  if (!Number.isFinite(strength) || strength < 0 || !Number.isFinite(density) || density <= 0) {
+    throw new RangeError("Displacement strength and density must be finite and nonnegative.");
+  }
+  const extent = Math.ceil(strength * density) + 1;
+  return {
+    x: output.x - extent,
+    y: output.y - extent,
+    width: output.width + 2 * extent,
+    height: output.height + 2 * extent
+  };
+}
+export {
+  decodeDisplacementChannel,
+  expandDisplacementInput
+};
+//# sourceMappingURL=displacement-math.js.map

package/dist/filters/displacement-math.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/filters/displacement-math.ts"],
+  "sourcesContent": ["import type { PixelBounds } from '../lib/filter/filter-region.js';\n\n/** Decodes Pibbl's exact signed eight-bit displacement encoding. */\nexport function decodeDisplacementChannel(value: number): number {\n  if (!Number.isFinite(value)) throw new RangeError('Displacement channel must be finite.');\n  const channel = Math.min(255, Math.max(0, value));\n  return channel < 128 ? (channel - 128) / 128 : (channel - 128) / 127;\n}\n\n/** Expands a sampled scene window by maximum displacement and bilinear support. */\nexport function expandDisplacementInput(\n  output: Readonly<PixelBounds>,\n  strength: number,\n  density: number,\n): PixelBounds {\n  if (!Number.isFinite(strength) || strength < 0 || !Number.isFinite(density) || density <= 0) {\n    throw new RangeError('Displacement strength and density must be finite and nonnegative.');\n  }\n  const extent = Math.ceil(strength * density) + 1;\n  return {\n    x: output.x - extent,\n    y: output.y - extent,\n    width: output.width + 2 * extent,\n    height: output.height + 2 * extent,\n  };\n}\n"],
+  "mappings": "AAGO,SAAS,0BAA0B,OAAuB;AAC/D,MAAI,CAAC,OAAO,SAAS,KAAK,EAAG,OAAM,IAAI,WAAW,sCAAsC;AACxF,QAAM,UAAU,KAAK,IAAI,KAAK,KAAK,IAAI,GAAG,KAAK,CAAC;AAChD,SAAO,UAAU,OAAO,UAAU,OAAO,OAAO,UAAU,OAAO;AACnE;AAGO,SAAS,wBACd,QACA,UACA,SACa;AACb,MAAI,CAAC,OAAO,SAAS,QAAQ,KAAK,WAAW,KAAK,CAAC,OAAO,SAAS,OAAO,KAAK,WAAW,GAAG;AAC3F,UAAM,IAAI,WAAW,mEAAmE;AAAA,EAC1F;AACA,QAAM,SAAS,KAAK,KAAK,WAAW,OAAO,IAAI;AAC/C,SAAO;AAAA,IACL,GAAG,OAAO,IAAI;AAAA,IACd,GAAG,OAAO,IAAI;AAAA,IACd,OAAO,OAAO,QAAQ,IAAI;AAAA,IAC1B,QAAQ,OAAO,SAAS,IAAI;AAAA,EAC9B;AACF;",
+  "names": []
+}

package/dist/filters/displacement.d.ts

@@ -0,0 +1,13 @@
+import { type PibblDisplacementFilterOptions, type PibblFilter } from '../lib/style/filter-types.js';
+/**
+ * Creates a displacement filter descriptor for a primitive's style.filter list. Filtering changes
+ * pixels without changing layout or hit geometry.
+ *
+ * @param options - Displacement texture, channel selection, and displacement scale. See
+ * {@link PibblDisplacementFilterOptions} .
+ * @returns A displacement filter descriptor for style.filter. See {@link PibblFilter}.
+ *
+ * @see {@link PibblDisplacementFilterOptions}
+ * @see {@link PibblFilter}
+ */
+export declare function displacement(options: PibblDisplacementFilterOptions): PibblFilter;

package/dist/filters/displacement.js

@@ -0,0 +1,65 @@
+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 { processDisplacement } from "./render-displacement-boundary.js";
+import { filterBoundaryExecutor } from "./filter-executor.js";
+import { expandDisplacementInput } from "./displacement-math.js";
+const definitions = /* @__PURE__ */ new WeakMap();
+const displacementExecutor = {
+  prepare(value, property, context) {
+    const options = definitions.get(value);
+    if (!options) throw new Error("A displacement filter value was created by an incompatible Pibbl runtime.");
+    const strengthValue = isSignal(options.strength) ? options.strength.get() : options.strength;
+    if (typeof strengthValue !== "number" || !Number.isFinite(strengthValue) || strengthValue < 0) {
+      throw diagnostic(`${property}.strength`, strengthValue, "must be a finite nonnegative number", context);
+    }
+    const blurRadius = isSignal(options.blurRadius) ? options.blurRadius.get() : options.blurRadius ?? 0;
+    if (typeof blurRadius !== "number" || !Number.isFinite(blurRadius) || blurRadius < 0) {
+      throw diagnostic(`${property}.blurRadius`, blurRadius, "must be a finite nonnegative number", context);
+    }
+    const identity = strengthValue === 0 && blurRadius === 0;
+    const { x, y, width, height } = options.region;
+    if (![x, y, width, height].every(Number.isFinite) || width <= 0 || height <= 0) {
+      throw diagnostic(`${property}.region`, options.region, "must have finite coordinates and positive finite dimensions", context);
+    }
+    const map = isSignal(options.map) ? options.map.get() : options.map;
+    try {
+      validateTexturePaint(map);
+      if (!identity) borrowTextureRaster(map, () => void 0);
+    } catch (error) {
+      throw diagnostic(`${property}.map`, map, error instanceof Error ? error.message : String(error), context);
+    }
+    const region = Object.freeze({ x, y, width, height });
+    return Object.freeze({
+      executor: filterBoundaryExecutor,
+      textureWarp: blurRadius === 0 ? Object.freeze({ map, strength: strengthValue, region }) : void 0,
+      reverseInfluence: (output, density) => expandDisplacementInput(output, strengthValue + blurRadius, density),
+      process: identity ? void 0 : (source, windows) => {
+        try {
+          return processDisplacement(source, windows, map, strengthValue, region, blurRadius);
+        } catch (error) {
+          const failure = diagnostic(property, { strength: strengthValue, region }, `displacement processing failed: ${error instanceof Error ? error.message : String(error)}`, context);
+          Object.defineProperty(failure, "cause", { value: error });
+          throw failure;
+        }
+      }
+    });
+  },
+  render: filterBoundaryExecutor.render
+};
+function displacement(options) {
+  const definition = Object.freeze({ map: options.map, strength: options.strength, blurRadius: options.blurRadius, region: Object.freeze({ ...options.region }) });
+  const value = Object.freeze({ [PIBBL_FILTER_EXECUTOR]: displacementExecutor });
+  definitions.set(value, definition);
+  return value;
+}
+function diagnostic(property, value, reason, context) {
+  return layoutDiagnostic({ component: context.component, property, value, algorithm: context.algorithm, constraints: context.constraints, reason });
+}
+export {
+  displacement
+};
+//# sourceMappingURL=displacement.js.map

package/dist/filters/displacement.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/filters/displacement.ts"],
+  "sourcesContent": ["import { isSignal } from '../lib/signals/graph.js';\nimport { layoutDiagnostic } from '../lib/style/diagnostics.js';\nimport {\n  PIBBL_FILTER_EXECUTOR,\n  type PibblDisplacementFilterOptions,\n  type PibblFilter,\n  type PibblFilterExecutor,\n  type PreparedPibblFilter,\n} from '../lib/style/filter-types.js';\nimport type { StyleResolutionContext } from '../lib/types.js';\nimport { borrowTextureRaster, validateTexturePaint } from '../lib/textures/texture-protocol.js';\nimport { processDisplacement } from './render-displacement-boundary.js';\nimport { filterBoundaryExecutor, type CustomPreparedFilter } from './filter-executor.js';\nimport { expandDisplacementInput } from './displacement-math.js';\n\nconst definitions = new WeakMap<PibblFilter, Readonly<PibblDisplacementFilterOptions>>();\nconst displacementExecutor: PibblFilterExecutor = {\n  prepare(value, property, context): PreparedPibblFilter {\n    const options = definitions.get(value);\n    if (!options) throw new Error('A displacement filter value was created by an incompatible Pibbl runtime.');\n    const strengthValue = isSignal(options.strength) ? options.strength.get() : options.strength;\n    if (typeof strengthValue !== 'number' || !Number.isFinite(strengthValue) || strengthValue < 0) {\n      throw diagnostic(`${property}.strength`, strengthValue, 'must be a finite nonnegative number', context);\n    }\n    const blurRadius = isSignal(options.blurRadius) ? options.blurRadius.get() : options.blurRadius ?? 0;\n    if (typeof blurRadius !== 'number' || !Number.isFinite(blurRadius) || blurRadius < 0) {\n      throw diagnostic(`${property}.blurRadius`, blurRadius, 'must be a finite nonnegative number', context);\n    }\n    const identity = strengthValue === 0 && blurRadius === 0;\n    const { x, y, width, height } = options.region;\n    if (![x, y, width, height].every(Number.isFinite) || width <= 0 || height <= 0) {\n      throw diagnostic(`${property}.region`, options.region, 'must have finite coordinates and positive finite dimensions', context);\n    }\n    const map = isSignal(options.map) ? options.map.get() : options.map;\n    try {\n      validateTexturePaint(map);\n      // Receiver preparation owns revision dependencies, before subtree execution\n      // changes signal tracking to descendant consumers.\n      if (!identity) borrowTextureRaster(map, () => undefined);\n    }\n    catch (error) {\n      throw diagnostic(`${property}.map`, map, error instanceof Error ? error.message : String(error), context);\n    }\n    const region = Object.freeze({ x, y, width, height });\n    return Object.freeze({\n      executor: filterBoundaryExecutor,\n      textureWarp: blurRadius === 0 ? Object.freeze({ map, strength: strengthValue, region }) : undefined,\n      reverseInfluence: (output, density) => expandDisplacementInput(output, strengthValue + blurRadius, density),\n      process: identity ? undefined : (source, windows) => {\n        try { return processDisplacement(source, windows, map, strengthValue, region, blurRadius); }\n        catch (error) {\n          const failure = diagnostic(property, { strength: strengthValue, region }, `displacement processing failed: ${error instanceof Error ? error.message : String(error)}`, context);\n          Object.defineProperty(failure, 'cause', { value: error });\n          throw failure;\n        }\n      },\n    } satisfies CustomPreparedFilter);\n  },\n  render: filterBoundaryExecutor.render,\n};\n\n/**\n * Creates a displacement filter descriptor for a primitive's style.filter list. Filtering changes\n * pixels without changing layout or hit geometry.\n *\n * @param options - Displacement texture, channel selection, and displacement scale. See\n * {@link PibblDisplacementFilterOptions} .\n * @returns A displacement filter descriptor for style.filter. See {@link PibblFilter}.\n *\n * @see {@link PibblDisplacementFilterOptions}\n * @see {@link PibblFilter}\n */\nexport function displacement(options: PibblDisplacementFilterOptions): PibblFilter {\n  const definition = Object.freeze({ map: options.map, strength: options.strength, blurRadius: options.blurRadius, region: Object.freeze({ ...options.region }) });\n  const value = Object.freeze({ [PIBBL_FILTER_EXECUTOR]: displacementExecutor });\n  definitions.set(value, definition);\n  return value;\n}\n\nfunction diagnostic(property: string, value: unknown, reason: string, context: Readonly<StyleResolutionContext>): Error {\n  return layoutDiagnostic({ component: context.component, property, value, algorithm: context.algorithm, constraints: context.constraints, reason });\n}\n"],
+  "mappings": "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",
+  "names": []
+}

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

@@ -0,0 +1,21 @@
+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';
+/** 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;
+    /** Private fusion capability; no concrete GPU implementation enters this module. */
+    readonly textureWarp?: Readonly<{
+        map: TexturePaint;
+        strength: number;
+        region: Readonly<{
+            x: number;
+            y: number;
+            width: number;
+            height: number;
+        }>;
+    }>;
+    readonly fuseWithPrevious?: (previous: CustomPreparedFilter) => CustomPreparedFilter | undefined;
+    readonly process?: (source: OffscreenCanvas, windows: FilterWindows) => ImageBitmap;
+}
+export declare const filterBoundaryExecutor: PibblFilterBoundaryExecutor;

package/dist/filters/filter-executor.js

@@ -0,0 +1,120 @@
+import { GLOBAL_STATE } from "../lib/global-state.js";
+import { getOptionalService } from "../lib/optional-services.js";
+import { enterPrimitivePresentation } from "../lib/primitive-presentation.js";
+import { renderFilterBoundary } from "../lib/filter/render-filter-boundary.js";
+import { compileNativeFilters } from "./native-operations.js";
+import { assertNativeCanvasFilter } from "./native-canvas-filter.js";
+const SCRATCH = /* @__PURE__ */ Symbol("pibbl.filter-pass-scratch");
+class PassScratch {
+  constructor(instance) {
+    this.instance = instance;
+  }
+  instance;
+  surfaces = [];
+  used = false;
+  committed = false;
+  beginRender() {
+    this.used = false;
+  }
+  endRender(success) {
+    if (success && this.used) {
+      this.committed = true;
+      return;
+    }
+    if (success || !this.committed) this.dispose();
+  }
+  target(index, 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.");
+    context.reset();
+    return context;
+  }
+  dispose() {
+    for (const canvas of this.surfaces) {
+      canvas.width = 0;
+      canvas.height = 0;
+    }
+    this.surfaces.length = 0;
+    this.instance.optionalServices.delete(SCRATCH);
+  }
+}
+const filterBoundaryExecutor = {
+  render(input) {
+    const operations = [];
+    for (const operation of input.filters) {
+      if (!("css" in operation) && !operation.process) continue;
+      const previous = operations.at(-1);
+      const fused = previous && !("css" in previous) && !("css" in operation) ? operation.fuseWithPrevious?.(previous) : void 0;
+      if (fused) operations[operations.length - 1] = fused;
+      else operations.push(operation);
+    }
+    if (!operations.length) {
+      const release = enterPrimitivePresentation(input.presentation);
+      try {
+        input.renderSubtree();
+      } finally {
+        release();
+      }
+      return;
+    }
+    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 context = target();
+            context.drawImage(bitmap, 0, 0);
+            current = context.canvas;
+          } finally {
+            bitmap.close();
+          }
+        }
+        applyNative();
+        result.drawImage(current, windows.sourceToOutputX, windows.sourceToOutputY);
+      }
+    }, input.renderSubtree);
+  }
+};
+export {
+  filterBoundaryExecutor
+};
+//# sourceMappingURL=filter-executor.js.map

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

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

package/dist/filters/native-canvas-filter.d.ts

@@ -0,0 +1,4 @@
+import type { RenderingContext2D } from '../lib/types.js';
+export declare function assertNativeCanvasFilter(context: RenderingContext2D, cssText: string, component: string, diagnoseRejection?: () => void): void;
+export declare function resetNativeCanvasFilter(context: RenderingContext2D, component: string): void;
+export declare function resetNativeCanvasFilterIfSupported(context: RenderingContext2D): void;