@pibbl/core 0.0.1

package/dist/lib/transitions/binding.js

@@ -0,0 +1,35 @@
+import { GLOBAL_STATE } from "../global-state.js";
+import { requireHookContext } from "../hooks/hook-slot.js";
+const bindings = /* @__PURE__ */ new WeakMap();
+function createTransitionBinding(resolve) {
+  const binding = Object.freeze({});
+  const { componentRefs, pibblInstance } = requireHookContext();
+  bindings.set(binding, { resolve, owner: componentRefs, root: pibblInstance.eventRoot });
+  return binding;
+}
+function resolveTransitionBinding(binding) {
+  const record = bindings.get(binding);
+  if (!record) throw new TypeError("style.transition requires a binding from useVisibilityTransition in the same Pibbl runtime.");
+  const receiver = GLOBAL_STATE.componentRefs;
+  if (GLOBAL_STATE.currentPibblInstance?.eventRoot !== record.root) throw new Error("A transition binding must stay within its owning Pibbl root.");
+  if (record.owner.teardowns.closed) throw new Error("Cannot use a disposed transition binding.");
+  if (!receiver) throw new Error("Transition bindings require a mounted receiver.");
+  const instance = GLOBAL_STATE.currentPibblInstance;
+  if (record.receiver && record.receiver !== receiver && record.receiverInstance === instance && record.receiver.renderGeneration !== instance.renderGeneration) {
+    record.receiver = void 0;
+  }
+  if (record.receiver && record.receiver !== receiver) throw new Error("A transition binding supports one mounted receiver. Wrap shared content in a Group.");
+  if (!record.receiver) {
+    record.receiver = receiver;
+    record.receiverInstance = instance;
+    receiver.teardowns.add(() => {
+      if (record.receiver === receiver) record.receiver = void 0;
+    });
+  }
+  return record.resolve();
+}
+export {
+  createTransitionBinding,
+  resolveTransitionBinding
+};
+//# sourceMappingURL=binding.js.map

package/dist/lib/transitions/binding.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/lib/transitions/binding.ts"],
+  "sourcesContent": ["import type { PibblVisibilityTransition } from '../hooks/use-visibility-transition.js';\nimport { GLOBAL_STATE } from '../global-state.js';\nimport { requireHookContext } from '../hooks/hook-slot.js';\nimport type { PibblComponentRefs, PibblEventRoot, PibblInstance } from '../types.js';\nimport type { PibblFilter } from '../style/filter-types.js';\n\ndeclare const bindingBrand: unique symbol;\n/**\n * An opaque connection between one transition controller and its painted subject.\n *\n * @see {@link PibblVisibilityTransition}\n */\nexport interface PibblTransitionBinding { readonly [bindingBrand]: true }\ninterface BindingRecord {\n  readonly resolve: () => readonly PibblFilter[];\n  readonly root: PibblEventRoot;\n  readonly owner: PibblComponentRefs<any>;\n  receiver?: PibblComponentRefs<any>;\n  receiverInstance?: PibblInstance;\n}\nconst bindings = new WeakMap<PibblTransitionBinding, BindingRecord>();\nexport function createTransitionBinding(resolve: () => readonly PibblFilter[]): PibblTransitionBinding {\n  const binding = Object.freeze({}) as PibblTransitionBinding;\n  const { componentRefs, pibblInstance } = requireHookContext();\n  bindings.set(binding, { resolve, owner: componentRefs, root: pibblInstance.eventRoot });\n  return binding;\n}\nexport function resolveTransitionBinding(binding: PibblTransitionBinding): readonly PibblFilter[] {\n  const record = bindings.get(binding);\n  if (!record) throw new TypeError('style.transition requires a binding from useVisibilityTransition in the same Pibbl runtime.');\n  const receiver = GLOBAL_STATE.componentRefs;\n  if (GLOBAL_STATE.currentPibblInstance?.eventRoot !== record.root) throw new Error('A transition binding must stay within its owning Pibbl root.');\n  if (record.owner.teardowns.closed) throw new Error('Cannot use a disposed transition binding.');\n  if (!receiver) throw new Error('Transition bindings require a mounted receiver.');\n  const instance = GLOBAL_STATE.currentPibblInstance!;\n  // Keyed replacements are visited before the old receiver is torn down. Only\n  // retire an unseen receiver in this same render instance; cached Layers own\n  // independent generations and must not silently lose their binding.\n  if (record.receiver && record.receiver !== receiver && record.receiverInstance === instance && record.receiver.renderGeneration !== instance.renderGeneration) {\n    record.receiver = undefined;\n  }\n  if (record.receiver && record.receiver !== receiver) throw new Error('A transition binding supports one mounted receiver. Wrap shared content in a Group.');\n  if (!record.receiver) {\n    record.receiver = receiver;\n    record.receiverInstance = instance;\n    receiver.teardowns.add(() => { if (record.receiver === receiver) record.receiver = undefined; });\n  }\n  return record.resolve();\n}\n"],
+  "mappings": "AACA,SAAS,oBAAoB;AAC7B,SAAS,0BAA0B;AAkBnC,MAAM,WAAW,oBAAI,QAA+C;AAC7D,SAAS,wBAAwB,SAA+D;AACrG,QAAM,UAAU,OAAO,OAAO,CAAC,CAAC;AAChC,QAAM,EAAE,eAAe,cAAc,IAAI,mBAAmB;AAC5D,WAAS,IAAI,SAAS,EAAE,SAAS,OAAO,eAAe,MAAM,cAAc,UAAU,CAAC;AACtF,SAAO;AACT;AACO,SAAS,yBAAyB,SAAyD;AAChG,QAAM,SAAS,SAAS,IAAI,OAAO;AACnC,MAAI,CAAC,OAAQ,OAAM,IAAI,UAAU,6FAA6F;AAC9H,QAAM,WAAW,aAAa;AAC9B,MAAI,aAAa,sBAAsB,cAAc,OAAO,KAAM,OAAM,IAAI,MAAM,8DAA8D;AAChJ,MAAI,OAAO,MAAM,UAAU,OAAQ,OAAM,IAAI,MAAM,2CAA2C;AAC9F,MAAI,CAAC,SAAU,OAAM,IAAI,MAAM,iDAAiD;AAChF,QAAM,WAAW,aAAa;AAI9B,MAAI,OAAO,YAAY,OAAO,aAAa,YAAY,OAAO,qBAAqB,YAAY,OAAO,SAAS,qBAAqB,SAAS,kBAAkB;AAC7J,WAAO,WAAW;AAAA,EACpB;AACA,MAAI,OAAO,YAAY,OAAO,aAAa,SAAU,OAAM,IAAI,MAAM,qFAAqF;AAC1J,MAAI,CAAC,OAAO,UAAU;AACpB,WAAO,WAAW;AAClB,WAAO,mBAAmB;AAC1B,aAAS,UAAU,IAAI,MAAM;AAAE,UAAI,OAAO,aAAa,SAAU,QAAO,WAAW;AAAA,IAAW,CAAC;AAAA,EACjG;AACA,SAAO,OAAO,QAAQ;AACxB;",
+  "names": []
+}

package/dist/lib/transitions/capture.d.ts

@@ -0,0 +1,21 @@
+import { type PibblFilter } from '../style/filter-types.js';
+import type { FilterWindows } from '../filter/filter-region.js';
+export interface CaptureFrame {
+    readonly context: OffscreenCanvasRenderingContext2D;
+    readonly windows: FilterWindows;
+    readonly source: OffscreenCanvas;
+    /** Draw in local coordinates, including any caller-applied transform. */
+    drawSource(): void;
+    drawTint(color: string): void;
+}
+export declare function captureTransition(draw: (frame: CaptureFrame) => void): PibblFilter;
+export interface TransitionRegion {
+    readonly x: number;
+    readonly y: number;
+    readonly width: number;
+    readonly height: number;
+}
+export declare function regionSnapshot(value: TransitionRegion): Readonly<TransitionRegion>;
+export declare function finite(value: number, name: string, minimum?: number): number;
+export declare const clamp: (value: number) => number;
+export declare const seededNoise: (seed: number) => (n: number) => number;

package/dist/lib/transitions/capture.js

@@ -0,0 +1,91 @@
+import { filterBoundaryExecutor } from "../../filters/filter-executor.js";
+import { GLOBAL_STATE } from "../global-state.js";
+import { getOptionalService } from "../optional-services.js";
+import { PIBBL_FILTER_EXECUTOR } from "../style/filter-types.js";
+const SCRATCH = /* @__PURE__ */ Symbol("pibbl.transition.capture");
+class TransitionSurfaces {
+  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();
+  }
+  context(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("Transitions require Canvas 2D.");
+    context.reset();
+    return context;
+  }
+  dispose() {
+    for (const surface of this.surfaces) {
+      surface.width = 0;
+      surface.height = 0;
+    }
+    this.surfaces = [];
+    this.instance.optionalServices.delete(SCRATCH);
+  }
+}
+function captureTransition(draw) {
+  const executor = {
+    render: filterBoundaryExecutor.render,
+    prepare() {
+      return { executor: filterBoundaryExecutor, reverseInfluence: (output) => ({ ...output }), process(source, windows) {
+        const instance = GLOBAL_STATE.currentPibblInstance;
+        if (!instance) throw new Error("Transition rendering requires an active Pibbl instance.");
+        const scratch = getOptionalService(instance, SCRATCH, () => new TransitionSurfaces(instance));
+        scratch.used = true;
+        const context = scratch.context(0, source.width, source.height);
+        context.setTransform(windows.source.renderTransform);
+        const bounds = windows.source.logicalBounds;
+        const drawImage = (image) => context.drawImage(image, bounds.x, bounds.y, bounds.width, bounds.height);
+        draw({ context, windows, source, drawSource: () => drawImage(source), drawTint(color) {
+          const tint = scratch.context(1, source.width, source.height);
+          tint.drawImage(source, 0, 0);
+          tint.globalCompositeOperation = "source-in";
+          tint.fillStyle = color;
+          tint.fillRect(0, 0, source.width, source.height);
+          drawImage(tint.canvas);
+        } });
+        return context.canvas.transferToImageBitmap();
+      } };
+    }
+  };
+  return Object.freeze({ [PIBBL_FILTER_EXECUTOR]: executor });
+}
+function regionSnapshot(value) {
+  const region = Object.freeze({ ...value });
+  for (const key of ["x", "y", "width", "height"]) finite(region[key], `region.${key}`);
+  if (region.width <= 0 || region.height <= 0) throw new RangeError("Transition region must have positive width and height.");
+  return region;
+}
+function finite(value, name, minimum = -Infinity) {
+  if (!Number.isFinite(value) || value < minimum) throw new RangeError(`${name} must be finite and at least ${minimum}.`);
+  return value;
+}
+const clamp = (value) => Math.max(0, Math.min(1, value));
+const seededNoise = (seed) => (n) => {
+  const v = Math.sin(n * 127.1 + seed * 31.7) * 43758.5453;
+  return v - Math.floor(v);
+};
+export {
+  captureTransition,
+  clamp,
+  finite,
+  regionSnapshot,
+  seededNoise
+};
+//# sourceMappingURL=capture.js.map

package/dist/lib/transitions/capture.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/lib/transitions/capture.ts"],
+  "sourcesContent": ["import { filterBoundaryExecutor, type CustomPreparedFilter } from '../../filters/filter-executor.js';\nimport { GLOBAL_STATE } from '../global-state.js';\nimport { getOptionalService } from '../optional-services.js';\nimport { PIBBL_FILTER_EXECUTOR, type PibblFilter, type PibblFilterExecutor } from '../style/filter-types.js';\nimport type { PibblInstance } from '../types.js';\nimport type { FilterWindows } from '../filter/filter-region.js';\n\nconst SCRATCH = Symbol('pibbl.transition.capture');\nclass TransitionSurfaces {\n  private 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  context(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('Transitions require Canvas 2D.');\n    context.reset(); return context;\n  }\n  dispose(): void {\n    for (const surface of this.surfaces) { surface.width = 0; surface.height = 0; }\n    this.surfaces = []; this.instance.optionalServices.delete(SCRATCH);\n  }\n}\nexport interface CaptureFrame {\n  readonly context: OffscreenCanvasRenderingContext2D;\n  readonly windows: FilterWindows;\n  readonly source: OffscreenCanvas;\n  /** Draw in local coordinates, including any caller-applied transform. */\n  drawSource(): void;\n  drawTint(color: string): void;\n}\nexport function captureTransition(draw: (frame: CaptureFrame) => void): PibblFilter {\n  const executor: PibblFilterExecutor = {\n    render: filterBoundaryExecutor.render,\n    prepare(): CustomPreparedFilter {\n      return { executor: filterBoundaryExecutor, reverseInfluence: output => ({ ...output }), process(source, windows) {\n        const instance = GLOBAL_STATE.currentPibblInstance;\n        if (!instance) throw new Error('Transition rendering requires an active Pibbl instance.');\n        const scratch = getOptionalService(instance, SCRATCH, () => new TransitionSurfaces(instance)); scratch.used = true;\n        const context = scratch.context(0, source.width, source.height);\n        context.setTransform(windows.source.renderTransform);\n        const bounds = windows.source.logicalBounds;\n        const drawImage = (image: OffscreenCanvas) => context.drawImage(image, bounds.x, bounds.y, bounds.width, bounds.height);\n        draw({ context, windows, source, drawSource: () => drawImage(source), drawTint(color) {\n          const tint = scratch.context(1, source.width, source.height);\n          tint.drawImage(source, 0, 0); tint.globalCompositeOperation = 'source-in';\n          tint.fillStyle = color; tint.fillRect(0, 0, source.width, source.height); drawImage(tint.canvas);\n        } });\n        return context.canvas.transferToImageBitmap();\n      } };\n    },\n  };\n  return Object.freeze({ [PIBBL_FILTER_EXECUTOR]: executor });\n}\nexport interface TransitionRegion { readonly x: number; readonly y: number; readonly width: number; readonly height: number }\nexport function regionSnapshot(value: TransitionRegion): Readonly<TransitionRegion> {\n  const region = Object.freeze({ ...value });\n  for (const key of ['x', 'y', 'width', 'height'] as const) finite(region[key], `region.${key}`);\n  if (region.width <= 0 || region.height <= 0) throw new RangeError('Transition region must have positive width and height.');\n  return region;\n}\nexport function finite(value: number, name: string, minimum = -Infinity): number {\n  if (!Number.isFinite(value) || value < minimum) throw new RangeError(`${name} must be finite and at least ${minimum}.`);\n  return value;\n}\nexport const clamp = (value: number) => Math.max(0, Math.min(1, value));\nexport const seededNoise = (seed: number) => (n: number) => { const v = Math.sin(n * 127.1 + seed * 31.7) * 43758.5453; return v - Math.floor(v); };\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/lib/transitions/common.d.ts

@@ -0,0 +1,130 @@
+import { type PibblTransitionEffect } from './fade.js';
+import { type TransitionRegion } from './capture.js';
+/**
+ * Direction and displacement controls for a sliding visibility transition.
+ *
+ * @see {@link slide}
+ */
+export interface PibblSlideOptions {
+    /**
+     * Horizontal coordinate or displacement in the containing coordinate system. See
+     * {@link PibblSlideOptions}.
+     */
+    readonly x?: number;
+    /**
+     * Vertical coordinate or displacement in the containing coordinate system. See
+     * {@link PibblSlideOptions}.
+     */
+    readonly y?: number;
+}
+/**
+ * Scale controls for a zooming visibility transition.
+ *
+ * @see {@link zoom}
+ */
+export interface PibblZoomOptions {
+    /** Origin of the transform or geometric query. See {@link PibblZoomOptions}. */
+    readonly origin: Readonly<{
+        /**
+         * Horizontal coordinate or displacement in the containing coordinate system. See
+         * {@link PibblZoomOptions}.
+         */
+        x: number;
+        /**
+         * Vertical coordinate or displacement in the containing coordinate system. See
+         * {@link PibblZoomOptions}.
+         */
+        y: number;
+    }>;
+    /** Starting endpoint or value. See {@link PibblZoomOptions}. */
+    readonly from?: number;
+}
+/**
+ * Direction and clipping controls for a wiping visibility transition.
+ *
+ * @see {@link wipe}
+ */
+export interface PibblWipeOptions {
+    /** Logical region over which the effect is evaluated. See {@link TransitionRegion}. */
+    readonly region: TransitionRegion;
+    /** Direction in which this operation proceeds. See {@link PibblWipeOptions}. */
+    readonly direction?: 'left' | 'right' | 'top' | 'bottom';
+}
+/**
+ * Blur controls for a visibility reveal transition.
+ *
+ * @see {@link blurReveal}
+ */
+export interface PibblBlurRevealOptions {
+    /**
+     * Radius in the coordinate system of this geometry or effect. See {@link PibblBlurRevealOptions}.
+     */
+    readonly radius?: number;
+}
+/**
+ * Noise and threshold controls for a dissolving visibility transition.
+ *
+ * @see {@link dissolve}
+ */
+export interface PibblDissolveOptions {
+    /** Logical region over which the effect is evaluated. See {@link TransitionRegion}. */
+    readonly region: TransitionRegion;
+    /** Size of the dissolve noise cells. See {@link PibblDissolveOptions}. */
+    readonly cellSize?: number;
+    /**
+     * Seed used for deterministic sampling or simulation initialization. See
+     * {@link PibblDissolveOptions}.
+     */
+    readonly seed?: number;
+}
+/**
+ * Translate from an offset while fading; exit follows the same path backward.
+ *
+ * @param options - Slide direction and displacement settings; defaults apply when omitted. See
+ * {@link PibblSlideOptions} .
+ * @returns A slide transition effect. See {@link PibblTransitionEffect}.
+ *
+ * @see {@link PibblSlideOptions}
+ * @see {@link PibblTransitionEffect}
+ */
+export declare function slide(options?: PibblSlideOptions): PibblTransitionEffect;
+/**
+ * Scale around an explicit local origin while fading.
+ *
+ * @param options - Zoom scale and origin settings. See {@link PibblZoomOptions}.
+ * @returns A zoom transition effect. See {@link PibblTransitionEffect}.
+ *
+ * @see {@link PibblZoomOptions}
+ * @see {@link PibblTransitionEffect}
+ */
+export declare function zoom(options: PibblZoomOptions): PibblTransitionEffect;
+/**
+ * Reveal from one side of an explicit local region.
+ *
+ * @param options - Wipe direction and shape settings. See {@link PibblWipeOptions}.
+ * @returns A wipe transition effect. See {@link PibblTransitionEffect}.
+ *
+ * @see {@link PibblWipeOptions}
+ * @see {@link PibblTransitionEffect}
+ */
+export declare function wipe(options: PibblWipeOptions): PibblTransitionEffect;
+/**
+ * Resolve from a soft transparent image into crisp content using native filters.
+ *
+ * @param options - Blur settings; defaults apply when omitted. See {@link PibblBlurRevealOptions}.
+ * @returns A blur-reveal transition effect. See {@link PibblTransitionEffect}.
+ *
+ * @see {@link PibblBlurRevealOptions}
+ * @see {@link PibblTransitionEffect}
+ */
+export declare function blurReveal(options?: PibblBlurRevealOptions): PibblTransitionEffect;
+/**
+ * A deterministic scattered reveal. Cell size is a minimum; the grid is capped at 128×128.
+ *
+ * @param options - Dissolve sampling and appearance settings. See {@link PibblDissolveOptions}.
+ * @returns A dissolve transition effect. See {@link PibblTransitionEffect}.
+ *
+ * @see {@link PibblDissolveOptions}
+ * @see {@link PibblTransitionEffect}
+ */
+export declare function dissolve(options: PibblDissolveOptions): PibblTransitionEffect;

package/dist/lib/transitions/common.js

@@ -0,0 +1,57 @@
+import { blur, opacity } from "../../filters/native.js";
+import { defineTransitionEffect } from "./fade.js";
+import { captureTransition, finite, regionSnapshot, seededNoise } from "./capture.js";
+const captured = (draw) => defineTransitionEffect((q) => q === 1 ? [] : q === 0 ? [opacity({ amount: 0 })] : [captureTransition((frame) => draw(frame, q))]);
+function slide(options = {}) {
+  const x = finite(options.x ?? 0, "x"), y = finite(options.y ?? 24, "y");
+  return captured(({ context, drawSource }, q) => {
+    context.translate(x * (1 - q), y * (1 - q));
+    context.globalAlpha = q;
+    drawSource();
+  });
+}
+function zoom(options) {
+  const x = finite(options.origin.x, "origin.x"), y = finite(options.origin.y, "origin.y"), from = finite(options.from ?? 0.8, "from", 0);
+  return captured(({ context: c, drawSource }, q) => {
+    const scale = from + (1 - from) * q;
+    c.translate(x, y);
+    c.scale(scale, scale);
+    c.translate(-x, -y);
+    c.globalAlpha = q;
+    drawSource();
+  });
+}
+function wipe(options) {
+  const r = regionSnapshot(options.region), direction = options.direction ?? "left";
+  if (!["left", "right", "top", "bottom"].includes(direction)) throw new TypeError("Unknown wipe direction.");
+  return captured(({ context: c, drawSource }, q) => {
+    const vertical = direction === "top" || direction === "bottom";
+    const width = vertical ? r.width : r.width * q, height = vertical ? r.height * q : r.height;
+    c.beginPath();
+    c.rect(r.x + (direction === "right" ? r.width - width : 0), r.y + (direction === "bottom" ? r.height - height : 0), width, height);
+    c.clip();
+    drawSource();
+  });
+}
+function blurReveal(options = {}) {
+  const radius = finite(options.radius ?? 16, "radius", 0);
+  return defineTransitionEffect((q) => q === 1 ? [] : [blur({ radius: radius * (1 - q) }), opacity({ amount: q })]);
+}
+function dissolve(options) {
+  const r = regionSnapshot(options.region), size = finite(options.cellSize ?? 5, "cellSize", 1), noise = seededNoise(finite(options.seed ?? 0, "seed"));
+  const columns = Math.min(128, Math.ceil(r.width / size)), rows = Math.min(128, Math.ceil(r.height / size));
+  return captured(({ context: c, drawSource }, q) => {
+    c.beginPath();
+    for (let row = 0; row < rows; row++) for (let col = 0; col < columns; col++) if (noise(row * columns + col) < q) c.rect(r.x + col * r.width / columns, r.y + row * r.height / rows, r.width / columns, r.height / rows);
+    c.clip();
+    drawSource();
+  });
+}
+export {
+  blurReveal,
+  dissolve,
+  slide,
+  wipe,
+  zoom
+};
+//# sourceMappingURL=common.js.map

package/dist/lib/transitions/common.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/lib/transitions/common.ts"],
+  "sourcesContent": ["import { blur, opacity } from '../../filters/native.js';\nimport { defineTransitionEffect, type PibblTransitionEffect } from './fade.js';\nimport { captureTransition, finite, regionSnapshot, seededNoise, type CaptureFrame, type TransitionRegion } from './capture.js';\n\n/**\n * Direction and displacement controls for a sliding visibility transition.\n *\n * @see {@link slide}\n */\nexport interface PibblSlideOptions {\n  /**\n   * Horizontal coordinate or displacement in the containing coordinate system. See\n   * {@link PibblSlideOptions}.\n   */\n  readonly x?: number;\n  /**\n   * Vertical coordinate or displacement in the containing coordinate system. See\n   * {@link PibblSlideOptions}.\n   */\n  readonly y?: number;\n}\n/**\n * Scale controls for a zooming visibility transition.\n *\n * @see {@link zoom}\n */\nexport interface PibblZoomOptions {\n  /** Origin of the transform or geometric query. See {@link PibblZoomOptions}. */\n  readonly origin: Readonly<{\n    /**\n     * Horizontal coordinate or displacement in the containing coordinate system. See\n     * {@link PibblZoomOptions}.\n     */\n    x: number;\n    /**\n     * Vertical coordinate or displacement in the containing coordinate system. See\n     * {@link PibblZoomOptions}.\n     */\n    y: number;\n  }>;\n  /** Starting endpoint or value. See {@link PibblZoomOptions}. */\n  readonly from?: number;\n}\n/**\n * Direction and clipping controls for a wiping visibility transition.\n *\n * @see {@link wipe}\n */\nexport interface PibblWipeOptions {\n  /** Logical region over which the effect is evaluated. See {@link TransitionRegion}. */\n  readonly region: TransitionRegion;\n  /** Direction in which this operation proceeds. See {@link PibblWipeOptions}. */\n  readonly direction?: 'left' | 'right' | 'top' | 'bottom';\n}\n/**\n * Blur controls for a visibility reveal transition.\n *\n * @see {@link blurReveal}\n */\nexport interface PibblBlurRevealOptions {\n  /**\n   * Radius in the coordinate system of this geometry or effect. See {@link PibblBlurRevealOptions}.\n   */\n  readonly radius?: number;\n}\n/**\n * Noise and threshold controls for a dissolving visibility transition.\n *\n * @see {@link dissolve}\n */\nexport interface PibblDissolveOptions {\n  /** Logical region over which the effect is evaluated. See {@link TransitionRegion}. */\n  readonly region: TransitionRegion;\n  /** Size of the dissolve noise cells. See {@link PibblDissolveOptions}. */\n  readonly cellSize?: number;\n  /**\n   * Seed used for deterministic sampling or simulation initialization. See\n   * {@link PibblDissolveOptions}.\n   */\n  readonly seed?: number;\n}\nconst captured = (draw: (frame: CaptureFrame, progress: number) => void) => defineTransitionEffect(q => q === 1 ? [] : q === 0 ? [opacity({ amount: 0 })] : [captureTransition(frame => draw(frame, q))]);\n/**\n * Translate from an offset while fading; exit follows the same path backward.\n *\n * @param options - Slide direction and displacement settings; defaults apply when omitted. See\n * {@link PibblSlideOptions} .\n * @returns A slide transition effect. See {@link PibblTransitionEffect}.\n *\n * @see {@link PibblSlideOptions}\n * @see {@link PibblTransitionEffect}\n */\nexport function slide(options: PibblSlideOptions = {}): PibblTransitionEffect {\n  const x = finite(options.x ?? 0, 'x'), y = finite(options.y ?? 24, 'y');\n  return captured(({ context, drawSource }, q) => { context.translate(x * (1 - q), y * (1 - q)); context.globalAlpha = q; drawSource(); });\n}\n/**\n * Scale around an explicit local origin while fading.\n *\n * @param options - Zoom scale and origin settings. See {@link PibblZoomOptions}.\n * @returns A zoom transition effect. See {@link PibblTransitionEffect}.\n *\n * @see {@link PibblZoomOptions}\n * @see {@link PibblTransitionEffect}\n */\nexport function zoom(options: PibblZoomOptions): PibblTransitionEffect {\n  const x = finite(options.origin.x, 'origin.x'), y = finite(options.origin.y, 'origin.y'), from = finite(options.from ?? .8, 'from', 0);\n  return captured(({ context: c, drawSource }, q) => { const scale = from + (1 - from) * q; c.translate(x, y); c.scale(scale, scale); c.translate(-x, -y); c.globalAlpha = q; drawSource(); });\n}\n/**\n * Reveal from one side of an explicit local region.\n *\n * @param options - Wipe direction and shape settings. See {@link PibblWipeOptions}.\n * @returns A wipe transition effect. See {@link PibblTransitionEffect}.\n *\n * @see {@link PibblWipeOptions}\n * @see {@link PibblTransitionEffect}\n */\nexport function wipe(options: PibblWipeOptions): PibblTransitionEffect {\n  const r = regionSnapshot(options.region), direction = options.direction ?? 'left';\n  if (!['left', 'right', 'top', 'bottom'].includes(direction)) throw new TypeError('Unknown wipe direction.');\n  return captured(({ context: c, drawSource }, q) => {\n    const vertical = direction === 'top' || direction === 'bottom';\n    const width = vertical ? r.width : r.width * q, height = vertical ? r.height * q : r.height;\n    c.beginPath(); c.rect(r.x + (direction === 'right' ? r.width - width : 0), r.y + (direction === 'bottom' ? r.height - height : 0), width, height); c.clip(); drawSource();\n  });\n}\n/**\n * Resolve from a soft transparent image into crisp content using native filters.\n *\n * @param options - Blur settings; defaults apply when omitted. See {@link PibblBlurRevealOptions}.\n * @returns A blur-reveal transition effect. See {@link PibblTransitionEffect}.\n *\n * @see {@link PibblBlurRevealOptions}\n * @see {@link PibblTransitionEffect}\n */\nexport function blurReveal(options: PibblBlurRevealOptions = {}): PibblTransitionEffect {\n  const radius = finite(options.radius ?? 16, 'radius', 0);\n  return defineTransitionEffect(q => q === 1 ? [] : [blur({ radius: radius * (1 - q) }), opacity({ amount: q })]);\n}\n/**\n * A deterministic scattered reveal. Cell size is a minimum; the grid is capped at 128\u00D7128.\n *\n * @param options - Dissolve sampling and appearance settings. See {@link PibblDissolveOptions}.\n * @returns A dissolve transition effect. See {@link PibblTransitionEffect}.\n *\n * @see {@link PibblDissolveOptions}\n * @see {@link PibblTransitionEffect}\n */\nexport function dissolve(options: PibblDissolveOptions): PibblTransitionEffect {\n  const r = regionSnapshot(options.region), size = finite(options.cellSize ?? 5, 'cellSize', 1), noise = seededNoise(finite(options.seed ?? 0, 'seed'));\n  const columns = Math.min(128, Math.ceil(r.width / size)), rows = Math.min(128, Math.ceil(r.height / size));\n  return captured(({ context: c, drawSource }, q) => {\n    c.beginPath();\n    for (let row = 0; row < rows; row++) for (let col = 0; col < columns; col++) if (noise(row * columns + col) < q) c.rect(r.x + col * r.width / columns, r.y + row * r.height / rows, r.width / columns, r.height / rows);\n    c.clip(); drawSource();\n  });\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/lib/transitions/define-transition.d.ts

@@ -0,0 +1,64 @@
+import { type TransitionRegion } from './capture.js';
+import { type PibblTransitionEffect } from './fade.js';
+/**
+ * Progress, geometry, and drawing context supplied to a custom transition renderer.
+ *
+ * @see {@link PibblTransitionDefinition}
+ */
+export interface PibblTransitionRenderFrame {
+    /** Borrowed for this synchronous callback only. Coordinates are receiver-local. */
+    readonly context: OffscreenCanvasRenderingContext2D;
+    /** Captured source pixels available during this synchronous rendering callback. See {@link PibblTransitionRenderFrame}. */
+    readonly source: OffscreenCanvas;
+    /** Bounds of the source pixels supplied to the transition. See {@link TransitionRegion}. */
+    readonly sourceBounds: Readonly<TransitionRegion>;
+    /**
+     * Normalized progress through the current animation or transition. See
+     * {@link PibblTransitionRenderFrame}.
+     */
+    readonly progress: number;
+    /** Selects `"enter"`, `"exit"` for phase. See {@link PibblTransitionRenderFrame}. */
+    readonly phase: 'enter' | 'exit';
+    /** Forward milliseconds since this run began, unaffected by reversals. */
+    readonly elapsed: number;
+    /**
+     * Material progress at an earlier time in this run (useful for particle births).
+     * @param elapsed - Elapsed transition time in milliseconds.
+     * @returns Transition progress at the requested time.
+     */
+    readonly progressAt: (elapsed: number) => number;
+    /**
+     * Draws the captured source into the transition's current rendering context. See
+     * {@link PibblTransitionRenderFrame}.
+     */
+    readonly drawSource: () => void;
+}
+/**
+ * Synchronous transition rendering callback and optional post-transition linger duration.
+ *
+ * @see {@link PibblTransitionRenderFrame}
+ * @see {@link defineTransition}
+ */
+export interface PibblTransitionDefinition {
+    /**
+     * Renders the current data or resources using the supplied context. See
+     * {@link PibblTransitionRenderFrame}.
+     * @param frame - Captured source, presentation context, progress, and timing services. See
+     * {@link PibblTransitionRenderFrame} .
+     */
+    readonly render: (frame: Readonly<PibblTransitionRenderFrame>) => void;
+    /** Additional milliseconds after material reaches its target. Default zero. */
+    readonly linger?: number;
+}
+/**
+ * Inert custom definition. The callback may call synchronous JS or WASM kernels.
+ *
+ * @param definition - Renderer and metadata defining the effect. See
+ * {@link PibblTransitionDefinition} .
+ * @returns A transition effect usable by the visibility transition hook. See
+ * {@link PibblTransitionEffect} .
+ *
+ * @see {@link PibblTransitionDefinition}
+ * @see {@link PibblTransitionEffect}
+ */
+export declare function defineTransition(definition: PibblTransitionDefinition): PibblTransitionEffect;

package/dist/lib/transitions/define-transition.js

@@ -0,0 +1,31 @@
+import { opacity } from "../../filters/native.js";
+import { withSignalWriteForbidden } from "../signals/graph.js";
+import { captureTransition, finite } from "./capture.js";
+import { defineTransitionEffect } from "./fade.js";
+function defineTransition(definition) {
+  const render = definition.render, linger = finite(definition.linger ?? 0, "linger", 0);
+  if (typeof render !== "function") throw new TypeError("defineTransition requires a synchronous render callback.");
+  return defineTransitionEffect((progress, phase, frame) => {
+    if (!frame.active || !linger) {
+      if (progress === 1) return [];
+      if (progress === 0) return [opacity({ amount: 0 })];
+    }
+    return [captureTransition(({ context, source, windows, drawSource }) => {
+      const result = withSignalWriteForbidden("Transition render callbacks cannot write to signals.", () => render(Object.freeze({
+        context,
+        source,
+        sourceBounds: Object.freeze({ ...windows.source.logicalBounds }),
+        progress,
+        phase,
+        elapsed: frame.elapsed,
+        progressAt: frame.progressAt,
+        drawSource
+      })));
+      if (result && typeof result.then === "function") throw new TypeError("Transition render callbacks must be synchronous.");
+    })];
+  }, linger);
+}
+export {
+  defineTransition
+};
+//# sourceMappingURL=define-transition.js.map

package/dist/lib/transitions/define-transition.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/lib/transitions/define-transition.ts"],
+  "sourcesContent": ["import { opacity } from '../../filters/native.js';\nimport { withSignalWriteForbidden } from '../signals/graph.js';\nimport { captureTransition, finite, type TransitionRegion } from './capture.js';\nimport { defineTransitionEffect, type PibblTransitionEffect } from './fade.js';\n\n/**\n * Progress, geometry, and drawing context supplied to a custom transition renderer.\n *\n * @see {@link PibblTransitionDefinition}\n */\nexport interface PibblTransitionRenderFrame {\n  /** Borrowed for this synchronous callback only. Coordinates are receiver-local. */\n  readonly context: OffscreenCanvasRenderingContext2D;\n  /** Captured source pixels available during this synchronous rendering callback. See {@link PibblTransitionRenderFrame}. */\n  readonly source: OffscreenCanvas;\n  /** Bounds of the source pixels supplied to the transition. See {@link TransitionRegion}. */\n  readonly sourceBounds: Readonly<TransitionRegion>;\n  /**\n   * Normalized progress through the current animation or transition. See\n   * {@link PibblTransitionRenderFrame}.\n   */\n  readonly progress: number;\n  /** Selects `\"enter\"`, `\"exit\"` for phase. See {@link PibblTransitionRenderFrame}. */\n  readonly phase: 'enter' | 'exit';\n  /** Forward milliseconds since this run began, unaffected by reversals. */\n  readonly elapsed: number;\n  /**\n   * Material progress at an earlier time in this run (useful for particle births).\n   * @param elapsed - Elapsed transition time in milliseconds.\n   * @returns Transition progress at the requested time.\n   */\n  readonly progressAt: (elapsed: number) => number;\n  /**\n   * Draws the captured source into the transition's current rendering context. See\n   * {@link PibblTransitionRenderFrame}.\n   */\n  readonly drawSource: () => void;\n}\n/**\n * Synchronous transition rendering callback and optional post-transition linger duration.\n *\n * @see {@link PibblTransitionRenderFrame}\n * @see {@link defineTransition}\n */\nexport interface PibblTransitionDefinition {\n  /**\n   * Renders the current data or resources using the supplied context. See\n   * {@link PibblTransitionRenderFrame}.\n   * @param frame - Captured source, presentation context, progress, and timing services. See\n   * {@link PibblTransitionRenderFrame} .\n   */\n  readonly render: (frame: Readonly<PibblTransitionRenderFrame>) => void;\n  /** Additional milliseconds after material reaches its target. Default zero. */\n  readonly linger?: number;\n}\n/**\n * Inert custom definition. The callback may call synchronous JS or WASM kernels.\n *\n * @param definition - Renderer and metadata defining the effect. See\n * {@link PibblTransitionDefinition} .\n * @returns A transition effect usable by the visibility transition hook. See\n * {@link PibblTransitionEffect} .\n *\n * @see {@link PibblTransitionDefinition}\n * @see {@link PibblTransitionEffect}\n */\nexport function defineTransition(definition: PibblTransitionDefinition): PibblTransitionEffect {\n  const render = definition.render, linger = finite(definition.linger ?? 0, 'linger', 0);\n  if (typeof render !== 'function') throw new TypeError('defineTransition requires a synchronous render callback.');\n  return defineTransitionEffect((progress, phase, frame) => {\n    if (!frame.active || !linger) {\n      if (progress === 1) return [];\n      if (progress === 0) return [opacity({ amount: 0 })];\n    }\n    return [captureTransition(({ context, source, windows, drawSource }) => {\n      const result: unknown = withSignalWriteForbidden('Transition render callbacks cannot write to signals.', () => render(Object.freeze({ context, source,\n        sourceBounds: Object.freeze({ ...windows.source.logicalBounds }), progress, phase,\n        elapsed: frame.elapsed, progressAt: frame.progressAt, drawSource,\n      })));\n      if (result && typeof (result as { then?: unknown }).then === 'function') throw new TypeError('Transition render callbacks must be synchronous.');\n    })];\n  }, linger);\n}\n"],
+  "mappings": "AAAA,SAAS,eAAe;AACxB,SAAS,gCAAgC;AACzC,SAAS,mBAAmB,cAAqC;AACjE,SAAS,8BAA0D;AA+D5D,SAAS,iBAAiB,YAA8D;AAC7F,QAAM,SAAS,WAAW,QAAQ,SAAS,OAAO,WAAW,UAAU,GAAG,UAAU,CAAC;AACrF,MAAI,OAAO,WAAW,WAAY,OAAM,IAAI,UAAU,0DAA0D;AAChH,SAAO,uBAAuB,CAAC,UAAU,OAAO,UAAU;AACxD,QAAI,CAAC,MAAM,UAAU,CAAC,QAAQ;AAC5B,UAAI,aAAa,EAAG,QAAO,CAAC;AAC5B,UAAI,aAAa,EAAG,QAAO,CAAC,QAAQ,EAAE,QAAQ,EAAE,CAAC,CAAC;AAAA,IACpD;AACA,WAAO,CAAC,kBAAkB,CAAC,EAAE,SAAS,QAAQ,SAAS,WAAW,MAAM;AACtE,YAAM,SAAkB,yBAAyB,wDAAwD,MAAM,OAAO,OAAO,OAAO;AAAA,QAAE;AAAA,QAAS;AAAA,QAC7I,cAAc,OAAO,OAAO,EAAE,GAAG,QAAQ,OAAO,cAAc,CAAC;AAAA,QAAG;AAAA,QAAU;AAAA,QAC5E,SAAS,MAAM;AAAA,QAAS,YAAY,MAAM;AAAA,QAAY;AAAA,MACxD,CAAC,CAAC,CAAC;AACH,UAAI,UAAU,OAAQ,OAA8B,SAAS,WAAY,OAAM,IAAI,UAAU,kDAAkD;AAAA,IACjJ,CAAC,CAAC;AAAA,EACJ,GAAG,MAAM;AACX;",
+  "names": []
+}

package/dist/lib/transitions/embers-physics.d.ts

@@ -0,0 +1,114 @@
+import type { PibblEmbersOptions } from "./embers.js";
+import type { lazyTransitionKernel } from "./wasm/kernel.js";
+/**
+ * Collision information produced by an ember's physical interaction.
+ *
+ * @see {@link PibblEmbersPhysicsOptions}
+ */
+export interface PibblEmberCollision {
+    /** Fraction of the swept segment at impact, from zero to one. */
+    readonly fraction: number;
+    /** Outward surface normal in the receiving primitive's local coordinates. */
+    readonly normal: readonly [number, number];
+}
+/**
+ * Collision and physical motion options for transition embers.
+ *
+ * @see {@link PibblEmberCollision}
+ * @see {@link PibblEmbersOptions}
+ */
+export interface PibblEmbersPhysicsOptions {
+    /** Local units/second². Default [0, -60]. */
+    readonly gravity?: readonly [number, number];
+    /** Target air velocity in local units/second. Default [0, -45]. */
+    readonly wind?: readonly [number, number];
+    /** Velocity damping per second. Default 4. */
+    readonly drag?: number;
+    /** Bounce coefficient, zero to one. Default 0.5. */
+    readonly restitution?: number;
+    /** Packed committed solids in receiver-local coordinates (e.g. physicsObstacles2D).
+     * Revision must change whenever data changes. Up to 8192 packed numbers.
+     * Sweeps run as one WASM batch; mutually exclusive with collide.
+     */
+    readonly obstacles?: Readonly<{
+        /**
+         * Reads the current committed values required by this integration. See
+         * {@link PibblEmbersPhysicsOptions}.
+         * @returns The current obstacle revision and packed geometry arrays.
+         */
+        read(): Readonly<{
+            /**
+             * Revision used to detect changes to the underlying state or geometry. See
+             * {@link PibblEmbersPhysicsOptions}.
+             */
+            revision: number;
+            /** Packed box obstacle data consumed by the simulation. See {@link PibblEmbersPhysicsOptions}. */
+            boxes: Float64Array;
+            /**
+             * Packed ellipse obstacle data consumed by the simulation. See
+             * {@link PibblEmbersPhysicsOptions}.
+             */
+            ellipses: Float64Array;
+            /**
+             * Packed polygon obstacle data consumed by the simulation. See
+             * {@link PibblEmbersPhysicsOptions}.
+             */
+            polygons: Float64Array;
+        }>;
+    }>;
+    /**
+     * Synchronous point sweep, called in Advance. Return the closest hit, if any.
+     * @param from - Previous particle position.
+     * @param to - Proposed particle position.
+     * @returns Collision information, or undefined when motion is unobstructed. See
+     * {@link PibblEmberCollision} .
+     */
+    readonly collide?: (from: readonly [number, number], to: readonly [number, number]) => PibblEmberCollision | undefined;
+}
+export declare function resolveEmbersPhysics(options: PibblEmbersPhysicsOptions): Readonly<{
+    obstacles: Readonly<{
+        /**
+         * Reads the current committed values required by this integration. See
+         * {@link PibblEmbersPhysicsOptions}.
+         * @returns The current obstacle revision and packed geometry arrays.
+         */
+        read(): Readonly<{
+            /**
+             * Revision used to detect changes to the underlying state or geometry. See
+             * {@link PibblEmbersPhysicsOptions}.
+             */
+            revision: number;
+            /** Packed box obstacle data consumed by the simulation. See {@link PibblEmbersPhysicsOptions}. */
+            boxes: Float64Array;
+            /**
+             * Packed ellipse obstacle data consumed by the simulation. See
+             * {@link PibblEmbersPhysicsOptions}.
+             */
+            ellipses: Float64Array;
+            /**
+             * Packed polygon obstacle data consumed by the simulation. See
+             * {@link PibblEmbersPhysicsOptions}.
+             */
+            polygons: Float64Array;
+        }>;
+    }> | undefined;
+    gravity: readonly [number, number];
+    wind: readonly [number, number];
+    drag: number;
+    restitution: number;
+    collide: ((from: readonly [number, number], to: readonly [number, number]) => PibblEmberCollision | undefined) | undefined;
+}>;
+type Kernel = ReturnType<ReturnType<typeof lazyTransitionKernel>>;
+export declare function emberSimulation(kernel: Kernel, options: ReturnType<typeof resolveEmbersPhysics>, region: Readonly<{
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}>, linger: number, burnWidth: number): {
+    reset(): void;
+    readonly disposed: boolean;
+    dispose(): void;
+    advance(elapsed: number, progressAt: (time: number) => number): void;
+    present(): void;
+};
+export {};