@pibbl/core 0.0.1

package/dist/lib/textures/texture.js

@@ -0,0 +1,385 @@
+import { GLOBAL_STATE } from "../global-state.js";
+import {
+  requireHookContext,
+  useHookSlot,
+  withHooksForbidden
+} from "../hooks/hook-slot.js";
+import { registerAdvanceParticipant } from "../scheduler/realm-scheduler.js";
+import { signal } from "../signals/graph.js";
+import {
+  registerTexturePaint
+} from "./texture-protocol.js";
+const recipes = /* @__PURE__ */ new WeakMap();
+function defineTexture(definition) {
+  const stable = Object.freeze({ ...definition });
+  return (config) => {
+    const recipe = Object.freeze({});
+    recipes.set(recipe, {
+      definition: stable,
+      config: structuredClone(config)
+    });
+    return recipe;
+  };
+}
+function placement(value = {}) {
+  if (value.mode !== void 0 && value.mode !== "repeat" && value.mode !== "stretch")
+    throw new TypeError("Unknown texture placement mode.");
+  for (const key of [
+    "tileWidth",
+    "tileHeight",
+    "offsetX",
+    "offsetY",
+    "rotation"
+  ]) {
+    const n = value[key];
+    if (n !== void 0 && (!Number.isFinite(n) || (key === "tileWidth" || key === "tileHeight") && n <= 0))
+      throw new RangeError(`Invalid texture placement ${key}.`);
+  }
+  return Object.freeze({ ...value });
+}
+function dimensions(options) {
+  const width = options.resolution?.width ?? 256, height = options.resolution?.height ?? 160;
+  if (![width, height].every((n) => Number.isInteger(n) && n >= 8 && n <= 1024) || width * height > 262144)
+    throw new RangeError(
+      "Texture resolution must be 8..1024 cells per axis, at most 262144 cells."
+    );
+  return [width, height];
+}
+class Resource {
+  constructor(owner, recipe, options) {
+    this.owner = owner;
+    const [width, height] = dimensions(options);
+    this.optionsKey = JSON.stringify(options);
+    this.palette = options.palette && Object.freeze([...options.palette]);
+    this.canvas = new OffscreenCanvas(width, height);
+    this.definition = recipe.definition;
+    const self = this;
+    this.context = Object.freeze({
+      canvas: this.canvas,
+      get palette() {
+        return self.palette;
+      },
+      invalidate() {
+        if (!self.disposed) {
+          self.dirty = true;
+          if (!self.initializing) self.schedule();
+        }
+      },
+      requestFrame() {
+        if (!self.disposed) {
+          self.continuing = true;
+          self.schedule();
+        }
+      }
+    });
+    const registerPaint = (value, placement2) => registerTexturePaint(value, {
+      resolvePaint: (ctx, bounds) => this.resolvePaint(ctx, bounds, placement2),
+      validate: () => this.assertOwner(),
+      borrow: (callback) => callback(this.borrow(placement2))
+    });
+    this.handle = Object.freeze({
+      send: (message) => {
+        if (this.disposed) return;
+        if (GLOBAL_STATE.currentPibblInstance)
+          throw new Error("Texture.send cannot run during Pibbl evaluation.");
+        if (!this.definition.receive)
+          throw new Error("This texture does not accept messages.");
+        if (this.messages.length >= 8192)
+          throw new RangeError("Texture message queue is full.");
+        this.messages.push(structuredClone(message));
+        this.schedule();
+      },
+      paint: (value) => {
+        const paint = Object.freeze({});
+        registerPaint(paint, placement(value));
+        return paint;
+      }
+    });
+    registerPaint(this.handle, placement(this.definition.defaultPlacement));
+    try {
+      this.state = this.call(
+        () => this.definition.create(this.context, recipe.config)
+      );
+      this.hasState = true;
+      this.publishInitial();
+      this.initializing = false;
+    } catch (error) {
+      try {
+        this.dispose();
+      } catch {
+      }
+      throw error;
+    }
+  }
+  owner;
+  revision = signal(0);
+  canvas;
+  committed;
+  spare;
+  provisional;
+  context;
+  handle;
+  state;
+  definition;
+  disposed = false;
+  hasState = false;
+  dirty = true;
+  sequence = 0;
+  publicationCanvasesCreated = 0;
+  messages = [];
+  unregister;
+  continuing = false;
+  lastTime;
+  initializing = true;
+  retryScheduled = false;
+  palette;
+  optionsKey;
+  call(fn) {
+    return withHooksForbidden(
+      "Texture implementations cannot call Pibbl hooks.",
+      fn
+    );
+  }
+  update(recipe, options) {
+    if (this.disposed) return;
+    if (recipe.definition !== this.definition)
+      throw new Error(
+        "Changing a texture definition requires a new keyed owner."
+      );
+    const [width, height] = dimensions(options);
+    const nextKey = JSON.stringify(options);
+    if (nextKey !== this.optionsKey) {
+      this.palette = options.palette && Object.freeze([...options.palette]);
+      this.optionsKey = nextKey;
+      if (width !== this.canvas.width || height !== this.canvas.height) {
+        try {
+          this.disposeState();
+          this.canvas.width = width;
+          this.canvas.height = height;
+          this.messages.length = 0;
+          this.lastTime = void 0;
+          this.state = this.call(
+            () => this.definition.create(this.context, recipe.config)
+          );
+          this.hasState = true;
+        } catch (error) {
+          try {
+            this.dispose();
+          } catch {
+          }
+          throw error;
+        }
+      }
+      this.context.invalidate();
+    }
+    this.call(
+      () => this.definition.update?.(this.state, recipe.config, this.context)
+    );
+  }
+  unschedule() {
+    this.unregister?.();
+    this.unregister = void 0;
+  }
+  schedule() {
+    if (this.unregister || this.disposed) return;
+    const participant = (frame, batch) => {
+      const retryAtEntry = this.retryScheduled;
+      this.unschedule();
+      const wasContinuing = this.continuing;
+      this.continuing = false;
+      try {
+        const messages = this.messages;
+        this.messages = [];
+        for (const message of messages)
+          this.call(
+            () => this.definition.receive?.(this.state, message, this.context)
+          );
+        if (wasContinuing)
+          this.call(
+            () => this.definition.advance?.(
+              this.state,
+              {
+                delta: this.lastTime === void 0 ? 0 : Math.max(0, frame.logicalTime - this.lastTime),
+                time: frame.logicalTime
+              },
+              this.context
+            )
+          );
+        this.lastTime = this.continuing ? frame.logicalTime : void 0;
+        if (this.dirty) {
+          const candidate = this.rasterizeCandidate();
+          let previous;
+          batch.stage(this.revision, ++this.sequence, participant);
+          batch.registerLifecycle(participant, {
+            apply: () => {
+              if (this.disposed) {
+                candidate.width = candidate.height = 0;
+              } else {
+                previous = this.committed;
+                this.committed = candidate;
+                this.spare = previous;
+                this.retryScheduled = false;
+              }
+            },
+            rollback: () => {
+              if (!this.disposed) {
+                this.committed = previous;
+                this.spare = candidate;
+              }
+            },
+            abort: () => {
+              this.spare = candidate;
+              if (!this.disposed) {
+                this.dirty = true;
+                this.schedule();
+              }
+            }
+          });
+        }
+        if (!this.continuing && this.messages.length === 0) {
+          this.unschedule();
+        }
+      } catch (error) {
+        this.unschedule();
+        this.continuing = false;
+        if (this.retryScheduled && !retryAtEntry) this.schedule();
+        throw error;
+      }
+    };
+    this.unregister = registerAdvanceParticipant(participant);
+  }
+  rasterizeCandidate() {
+    const ctx = this.canvas.getContext("2d");
+    if (!ctx) throw new Error("Textures require OffscreenCanvas 2D.");
+    ctx.save();
+    try {
+      ctx.resetTransform();
+      ctx.clearRect(0, 0, this.canvas.width, this.canvas.height);
+      this.call(() => this.definition.rasterize(this.state, this.context));
+      this.dirty = false;
+    } finally {
+      ctx.restore();
+    }
+    const spare = this.spare;
+    this.spare = void 0;
+    const reusable = spare?.width === this.canvas.width && spare.height === this.canvas.height ? spare : void 0;
+    if (spare && spare !== reusable) spare.width = spare.height = 0;
+    let candidate;
+    try {
+      candidate = reusable ?? this.createPublicationCanvas();
+      const candidateContext = candidate.getContext("2d");
+      if (!candidateContext) throw new Error("Textures require OffscreenCanvas 2D.");
+      candidateContext.clearRect(0, 0, candidate.width, candidate.height);
+      candidateContext.drawImage(this.canvas, 0, 0);
+      return candidate;
+    } catch (error) {
+      if (candidate) candidate.width = candidate.height = 0;
+      this.dirty = true;
+      if (!this.retryScheduled) {
+        this.retryScheduled = true;
+        this.schedule();
+      }
+      throw error;
+    }
+  }
+  createPublicationCanvas() {
+    this.publicationCanvasesCreated++;
+    return new OffscreenCanvas(this.canvas.width, this.canvas.height);
+  }
+  /** @internal Structural ownership evidence for texture publication tests. */
+  publicationSnapshot() {
+    return Object.freeze({ publicationCanvasesCreated: this.publicationCanvasesCreated, hasOwner: this.owner !== void 0 });
+  }
+  publishInitial() {
+    const candidate = this.rasterizeCandidate();
+    const transaction = GLOBAL_STATE.renderTransaction;
+    if (!transaction) {
+      this.committed = candidate;
+      return;
+    }
+    this.provisional = { canvas: candidate, transaction };
+    transaction.onFinish((success) => {
+      if (this.provisional?.transaction !== transaction) return;
+      const provisional = this.provisional;
+      this.provisional = void 0;
+      if (success && !this.disposed) this.committed = provisional.canvas;
+      else provisional.canvas.width = provisional.canvas.height = 0;
+    });
+  }
+  assertOwner() {
+    if (this.disposed) throw new Error("Cannot paint with a disposed texture.");
+    let root = GLOBAL_STATE.currentPibblInstance;
+    while (root?.parent) root = GLOBAL_STATE.pibblInstances.get(root.parent);
+    let owner = this.owner;
+    while (owner?.parent) owner = GLOBAL_STATE.pibblInstances.get(owner.parent);
+    if (root !== owner) throw new Error("Textures may only be shared within their owning Pibbl tree.");
+  }
+  borrow(placement2) {
+    this.assertOwner();
+    const revision = this.revision.get();
+    const provisional = this.provisional;
+    const source = provisional !== void 0 && provisional.transaction === GLOBAL_STATE.renderTransaction ? provisional.canvas : this.committed;
+    if (!source) throw new Error("Texture pixels are not committed for this render transaction.");
+    return Object.freeze({ source, width: source.width, height: source.height, revision, resource: this, placement: placement2 });
+  }
+  resolvePaint(ctx, bounds, p) {
+    const borrowed = this.borrow(p);
+    const pattern = ctx.createPattern(borrowed.source, "repeat");
+    if (!pattern) throw new Error("Could not create texture paint.");
+    const stretch = p.mode === "stretch";
+    const width = stretch ? bounds.width : p.tileWidth ?? borrowed.width;
+    const height = stretch ? bounds.height : p.tileHeight ?? borrowed.height;
+    pattern.setTransform(new DOMMatrix().translate(bounds.x + (p.offsetX ?? 0), bounds.y + (p.offsetY ?? 0)).rotate(p.rotation ?? 0).scale(Math.max(1e-6, width) / borrowed.width, Math.max(1e-6, height) / borrowed.height));
+    return pattern;
+  }
+  dispose() {
+    if (this.disposed) return;
+    this.disposed = true;
+    this.unschedule();
+    this.messages.length = 0;
+    try {
+      this.disposeState();
+    } finally {
+      this.canvas.width = this.canvas.height = 0;
+      this.committed && (this.committed.width = this.committed.height = 0);
+      this.spare && (this.spare.width = this.spare.height = 0);
+      this.provisional && (this.provisional.canvas.width = this.provisional.canvas.height = 0);
+      this.state = void 0;
+      this.hasState = false;
+      this.committed = void 0;
+      this.spare = void 0;
+      this.provisional = void 0;
+      this.owner = void 0;
+    }
+  }
+  disposeState() {
+    if (!this.hasState) return;
+    this.hasState = false;
+    const state = this.state;
+    this.state = void 0;
+    this.call(() => this.definition.dispose?.(state, this.context));
+  }
+}
+function useTexture(input, options = {}) {
+  const recipe = recipes.get(input);
+  if (!recipe)
+    throw new TypeError("useTexture requires a defineTexture recipe.");
+  const { pibblInstance } = requireHookContext();
+  let created = false;
+  const resource = useHookSlot("texture", (teardowns) => {
+    created = true;
+    const value = new Resource(pibblInstance, recipe, options);
+    teardowns.add(() => value.dispose());
+    return value;
+  }).value;
+  if (!created)
+    GLOBAL_STATE.renderTransaction.onFinish((success) => {
+      if (success) resource.update(recipe, options);
+    });
+  return resource.handle;
+}
+export {
+  defineTexture,
+  useTexture
+};
+//# sourceMappingURL=texture.js.map

package/dist/lib/textures/texture.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/lib/textures/texture.ts"],
+  "sourcesContent": ["import { GLOBAL_STATE } from \"../global-state.js\";\nimport {\n  requireHookContext,\n  useHookSlot,\n  withHooksForbidden,\n} from \"../hooks/hook-slot.js\";\nimport { registerAdvanceParticipant } from \"../scheduler/realm-scheduler.js\";\nimport { signal } from \"../signals/graph.js\";\nimport type { PibblInstance, RenderingContext2D } from \"../types.js\";\nimport {\n  registerTexturePaint,\n  type BorrowedTextureRaster,\n  type TexturePaint,\n  type TexturePlacement,\n} from \"./texture-protocol.js\";\n\nexport type { TexturePaint, TexturePlacement } from \"./texture-protocol.js\";\n\ndeclare const recipeBrand: unique symbol;\n/**\n * A mount-owned texture handle that provides paint and accepts recipe messages.\n *\n * @see {@link TexturePaint}\n * @see {@link TexturePlacement}\n * @see {@link useTexture}\n */\nexport interface Texture<Message = never> extends TexturePaint {\n  /**\n   * Delivers a typed message to the mounted recipe instance. See {@link Texture}.\n   * @param message - Message delivered to the texture definition's receive callback.\n   */\n  send(message: Message): void;\n  /**\n   * Returns a paint view with the requested placement while retaining the same texture ownership.\n   * See {@link TexturePaint}.\n   * @param placement - Destination bounds and texture placement policy. See\n   * {@link TexturePlacement} .\n   * @returns A paint descriptor referencing this mounted texture. See {@link TexturePaint}.\n   */\n  paint(placement: TexturePlacement): TexturePaint;\n}\n/**\n * Resolution and runtime configuration for a mounted texture recipe.\n *\n * @see {@link useTexture}\n */\nexport interface TextureOptions {\n  /** Dimensions of the simulation or raster grid. See {@link TextureOptions}. */\n  readonly resolution?: {\n    /**\n     * Horizontal extent in the units of the containing geometry or surface. See\n     * {@link TextureOptions}.\n     */\n    readonly width: number;\n    /**\n     * Vertical extent in the units of the containing geometry or surface. See\n     * {@link TextureOptions}.\n     */\n    readonly height: number;\n  };\n  /** Ordered colors used to present texture intensity. See {@link TextureOptions}. */\n  readonly palette?: readonly string[];\n}\n/**\n * Surface and invalidation facilities supplied to texture lifecycle callbacks.\n *\n * @see {@link TextureDefinition}\n */\nexport interface TextureContext {\n  /** Canvas surface associated with this resource or mount. See {@link TextureContext}. */\n  readonly canvas: OffscreenCanvas;\n  /** Ordered colors used to present texture intensity. See {@link TextureContext}. */\n  readonly palette: readonly string[] | undefined;\n  /** Marks the source pixels dirty and requests a Pibbl update. */\n  invalidate(): void;\n  /** Requests another Pibbl frame; implementations stop by not requesting again. */\n  requestFrame(): void;\n}\n/**\n * Shared logical time and elapsed milliseconds supplied while advancing a texture.\n *\n * @see {@link TextureDefinition}\n */\nexport interface TextureFrame {\n  /** Elapsed time since the preceding texture frame, in milliseconds. See {@link TextureFrame}. */\n  readonly delta: number;\n  /** Current shared logical time, in milliseconds. See {@link TextureFrame}. */\n  readonly time: number;\n}\n/**\n * Lifecycle callbacks for creating, updating, painting, and disposing texture resources.\n *\n * @see {@link TexturePlacement}\n * @see {@link TextureContext}\n * @see {@link TextureFrame}\n * @see {@link defineTexture}\n */\nexport interface TextureDefinition<Config, State, Message = never> {\n  /**\n   * Texture placement used when no paint-specific override is supplied. See\n   * {@link TexturePlacement}.\n   */\n  readonly defaultPlacement?: TexturePlacement;\n  /**\n   * Allocates state for a mounted texture recipe. See {@link TextureDefinition}.\n   * @param context - Texture-owned drawing surface and scheduling services. See\n   * {@link TextureContext} .\n   * @param config - Initial recipe configuration.\n   * @returns State retained for this mounted texture lifetime.\n   */\n  create(context: TextureContext, config: Readonly<Config>): State;\n  /**\n   * Updates existing state when the recipe configuration changes. See {@link TextureDefinition}.\n   * @param state - State returned by create.\n   * @param config - Latest recipe configuration.\n   * @param context - Texture-owned drawing surface and scheduling services. See\n   * {@link TextureContext} .\n   */\n  update?(state: State, config: Readonly<Config>, context: TextureContext): void;\n  /**\n   * Handles a typed application message for this recipe instance. See {@link TextureDefinition}.\n   * @param state - State returned by create.\n   * @param message - Message sent through the mounted texture handle.\n   * @param context - Texture-owned drawing surface and scheduling services. See\n   * {@link TextureContext} .\n   */\n  receive?(state: State, message: Message, context: TextureContext): void;\n  /**\n   * Advances simulation using the shared Pibbl frame timing. See {@link TextureDefinition}.\n   * @param state - State returned by create.\n   * @param frame - Shared animation time and delta. See {@link TextureFrame}.\n   * @param context - Texture-owned drawing surface and scheduling services. See\n   * {@link TextureContext} .\n   */\n  advance?(state: State, frame: TextureFrame, context: TextureContext): void;\n  /**\n   * Draws current texture pixels into the owned offscreen surface. See {@link TextureDefinition}.\n   * @param state - State returned by create.\n   * @param context - Texture-owned drawing surface and scheduling services. See\n   * {@link TextureContext} .\n   */\n  rasterize(state: State, context: TextureContext): void;\n  /**\n   * Releases state and resources when the mounted texture is disposed. See\n   * {@link TextureDefinition}.\n   * @param state - State returned by create.\n   * @param context - Texture-owned drawing surface and scheduling services. See\n   * {@link TextureContext} .\n   */\n  dispose?(state: State, context: TextureContext): void;\n}\n/**\n * A reusable texture definition together with the options used to instantiate it.\n *\n * @see {@link defineTexture}\n * @see {@link useTexture}\n */\nexport interface TextureRecipe<Message = never> {\n  readonly [recipeBrand]: (message: Message) => Message;\n}\ntype Definition = TextureDefinition<any, any, any>;\ninterface Recipe {\n  definition: Definition;\n  config: any;\n}\nconst recipes = new WeakMap<object, Recipe>();\n\n/**\n * Defines a pure recipe factory; resource allocation starts at useTexture.\n *\n * @param definition - State creation, update, simulation, rasterization, and disposal callbacks.\n * See {@link TextureDefinition} .\n * @returns A configuration-to-recipe factory; resources are allocated when a recipe is mounted.\n * See {@link TextureRecipe} .\n *\n * @see {@link TextureDefinition}\n * @see {@link TextureRecipe}\n */\nexport function defineTexture<Config, State, Message = never>(\n  definition: TextureDefinition<Config, State, Message>,\n): (config: Config) => TextureRecipe<Message> {\n  const stable = Object.freeze({ ...definition });\n  return (config) => {\n    const recipe = Object.freeze({}) as TextureRecipe<Message>;\n    recipes.set(recipe, {\n      definition: stable,\n      config: structuredClone(config),\n    });\n    return recipe;\n  };\n}\nfunction placement(value: TexturePlacement = {}): Readonly<TexturePlacement> {\n  if (\n    value.mode !== undefined &&\n    value.mode !== \"repeat\" &&\n    value.mode !== \"stretch\"\n  )\n    throw new TypeError(\"Unknown texture placement mode.\");\n  for (const key of [\n    \"tileWidth\",\n    \"tileHeight\",\n    \"offsetX\",\n    \"offsetY\",\n    \"rotation\",\n  ] as const) {\n    const n = value[key];\n    if (\n      n !== undefined &&\n      (!Number.isFinite(n) ||\n        ((key === \"tileWidth\" || key === \"tileHeight\") && n <= 0))\n    )\n      throw new RangeError(`Invalid texture placement ${key}.`);\n  }\n  return Object.freeze({ ...value });\n}\nfunction dimensions(options: TextureOptions): [number, number] {\n  const width = options.resolution?.width ?? 256,\n    height = options.resolution?.height ?? 160;\n  if (\n    ![width, height].every((n) => Number.isInteger(n) && n >= 8 && n <= 1024) ||\n    width * height > 262144\n  )\n    throw new RangeError(\n      \"Texture resolution must be 8..1024 cells per axis, at most 262144 cells.\",\n    );\n  return [width, height];\n}\nclass Resource {\n  readonly revision = signal(0);\n  readonly canvas: OffscreenCanvas;\n  private committed: OffscreenCanvas | undefined;\n  private spare: OffscreenCanvas | undefined;\n  private provisional: { canvas: OffscreenCanvas; transaction: NonNullable<typeof GLOBAL_STATE.renderTransaction> } | undefined;\n  readonly context: TextureContext;\n  readonly handle: Texture<any>;\n  state: any;\n  definition: Definition;\n  disposed = false;\n  private hasState = false;\n  dirty = true;\n  private sequence = 0;\n  private publicationCanvasesCreated = 0;\n  private messages: unknown[] = [];\n  private unregister?: () => void;\n  private continuing = false;\n  private lastTime?: number;\n  private initializing = true;\n  private retryScheduled = false;\n  private palette?: readonly string[];\n  private optionsKey: string;\n  constructor(\n    private owner: PibblInstance | undefined,\n    recipe: Recipe,\n    options: TextureOptions,\n  ) {\n    const [width, height] = dimensions(options);\n    this.optionsKey = JSON.stringify(options);\n    this.palette = options.palette && Object.freeze([...options.palette]);\n    this.canvas = new OffscreenCanvas(width, height);\n    this.definition = recipe.definition;\n    const self = this;\n    this.context = Object.freeze({\n      canvas: this.canvas,\n      get palette() {\n        return self.palette;\n      },\n      invalidate() {\n        if (!self.disposed) {\n          self.dirty = true;\n          if (!self.initializing) self.schedule();\n        }\n      },\n      requestFrame() {\n        if (!self.disposed) {\n          self.continuing = true;\n          self.schedule();\n        }\n      },\n    });\n    const registerPaint = (value: TexturePaint, placement: Readonly<TexturePlacement>) =>\n      registerTexturePaint(value, {\n        resolvePaint: (ctx, bounds) => this.resolvePaint(ctx, bounds, placement),\n        validate: () => this.assertOwner(),\n        borrow: callback => callback(this.borrow(placement)),\n      });\n    this.handle = Object.freeze({\n      send: (message: unknown) => {\n        if (this.disposed) return;\n        if (GLOBAL_STATE.currentPibblInstance)\n          throw new Error(\"Texture.send cannot run during Pibbl evaluation.\");\n        if (!this.definition.receive)\n          throw new Error(\"This texture does not accept messages.\");\n        if (this.messages.length >= 8192)\n          throw new RangeError(\"Texture message queue is full.\");\n        this.messages.push(structuredClone(message));\n        this.schedule();\n      },\n      paint: (value: TexturePlacement) => {\n        const paint = Object.freeze({}) as TexturePaint;\n        registerPaint(paint, placement(value));\n        return paint;\n      },\n    }) as Texture<any>;\n    registerPaint(this.handle, placement(this.definition.defaultPlacement));\n    try {\n      this.state = this.call(() =>\n        this.definition.create(this.context, recipe.config),\n      );\n      this.hasState = true;\n      this.publishInitial();\n      this.initializing = false;\n    } catch (error) {\n      try {\n        this.dispose();\n      } catch {\n        // The initialization failure remains the actionable error.\n      }\n      throw error;\n    }\n  }\n  private call<T>(fn: () => T): T {\n    return withHooksForbidden(\n      \"Texture implementations cannot call Pibbl hooks.\",\n      fn,\n    );\n  }\n  update(recipe: Recipe, options: TextureOptions) {\n    if (this.disposed) return;\n    if (recipe.definition !== this.definition)\n      throw new Error(\n        \"Changing a texture definition requires a new keyed owner.\",\n      );\n    const [width, height] = dimensions(options);\n    const nextKey = JSON.stringify(options);\n    if (nextKey !== this.optionsKey) {\n      this.palette = options.palette && Object.freeze([...options.palette]);\n      this.optionsKey = nextKey;\n      if (width !== this.canvas.width || height !== this.canvas.height) {\n        try {\n          this.disposeState();\n          this.canvas.width = width;\n          this.canvas.height = height;\n          this.messages.length = 0;\n          this.lastTime = undefined;\n          this.state = this.call(() =>\n            this.definition.create(this.context, recipe.config),\n          );\n          this.hasState = true;\n        } catch (error) {\n          try { this.dispose(); } catch { /* Preserve the recreate failure. */ }\n          throw error;\n        }\n      }\n      this.context.invalidate();\n    }\n    this.call(() =>\n      this.definition.update?.(this.state, recipe.config, this.context),\n    );\n  }\n  private unschedule() {\n    this.unregister?.();\n    this.unregister = undefined;\n  }\n  private schedule() {\n    if (this.unregister || this.disposed) return;\n    const participant = (frame: { logicalTime: number }, batch: any) => {\n      const retryAtEntry = this.retryScheduled;\n      this.unschedule();\n      const wasContinuing = this.continuing;\n      this.continuing = false;\n      try {\n        const messages = this.messages;\n        this.messages = [];\n        for (const message of messages)\n          this.call(() =>\n            this.definition.receive?.(this.state, message, this.context),\n          );\n        if (wasContinuing)\n          this.call(() =>\n            this.definition.advance?.(\n              this.state,\n              {\n                delta:\n                  this.lastTime === undefined\n                    ? 0\n                    : Math.max(0, frame.logicalTime - this.lastTime),\n                time: frame.logicalTime,\n              },\n              this.context,\n            ),\n          );\n        this.lastTime = this.continuing ? frame.logicalTime : undefined;\n        if (this.dirty) {\n          const candidate = this.rasterizeCandidate();\n          let previous: OffscreenCanvas | undefined;\n          batch.stage(this.revision, ++this.sequence, participant);\n          batch.registerLifecycle(participant, {\n            apply: () => {\n              if (this.disposed) {\n                candidate.width = candidate.height = 0;\n              } else {\n                previous = this.committed;\n                this.committed = candidate;\n                this.spare = previous;\n                this.retryScheduled = false;\n              }\n            },\n            rollback: () => {\n              if (!this.disposed) {\n                this.committed = previous;\n                this.spare = candidate;\n              }\n            },\n            abort: () => {\n              this.spare = candidate;\n              if (!this.disposed) {\n                this.dirty = true;\n                this.schedule();\n              }\n            },\n          });\n        }\n        if (!this.continuing && this.messages.length === 0) {\n          this.unschedule();\n        }\n      } catch (error) {\n        this.unschedule();\n        this.continuing = false;\n        if (this.retryScheduled && !retryAtEntry) this.schedule();\n        throw error;\n      }\n    };\n    this.unregister = registerAdvanceParticipant(participant);\n  }\n  private rasterizeCandidate(): OffscreenCanvas {\n    const ctx = this.canvas.getContext(\"2d\");\n    if (!ctx) throw new Error(\"Textures require OffscreenCanvas 2D.\");\n    ctx.save();\n    try {\n      ctx.resetTransform();\n      ctx.clearRect(0, 0, this.canvas.width, this.canvas.height);\n      this.call(() => this.definition.rasterize(this.state, this.context));\n      this.dirty = false;\n    } finally {\n      ctx.restore();\n    }\n    const spare = this.spare;\n    this.spare = undefined;\n    const reusable = spare?.width === this.canvas.width && spare.height === this.canvas.height ?\n      spare : undefined;\n    if (spare && spare !== reusable) spare.width = spare.height = 0;\n    let candidate: OffscreenCanvas | undefined;\n    try {\n      candidate = reusable ?? this.createPublicationCanvas();\n      const candidateContext = candidate.getContext(\"2d\");\n      if (!candidateContext) throw new Error(\"Textures require OffscreenCanvas 2D.\");\n      // Publication canvases are reused; transparent source pixels must erase old paint.\n      candidateContext.clearRect(0, 0, candidate.width, candidate.height);\n      candidateContext.drawImage(this.canvas, 0, 0);\n      return candidate;\n    } catch (error) {\n      if (candidate) candidate.width = candidate.height = 0;\n      this.dirty = true;\n      if (!this.retryScheduled) {\n        this.retryScheduled = true;\n        this.schedule();\n      }\n      throw error;\n    }\n  }\n  private createPublicationCanvas(): OffscreenCanvas {\n    this.publicationCanvasesCreated++;\n    return new OffscreenCanvas(this.canvas.width, this.canvas.height);\n  }\n  /** @internal Structural ownership evidence for texture publication tests. */\n  publicationSnapshot(): Readonly<{ publicationCanvasesCreated: number; hasOwner: boolean }> {\n    return Object.freeze({ publicationCanvasesCreated: this.publicationCanvasesCreated, hasOwner: this.owner !== undefined });\n  }\n  private publishInitial(): void {\n    const candidate = this.rasterizeCandidate();\n    const transaction = GLOBAL_STATE.renderTransaction;\n    if (!transaction) {\n      this.committed = candidate;\n      return;\n    }\n    this.provisional = { canvas: candidate, transaction };\n    transaction.onFinish(success => {\n      if (this.provisional?.transaction !== transaction) return;\n      const provisional = this.provisional;\n      this.provisional = undefined;\n      if (success && !this.disposed) this.committed = provisional.canvas;\n      else provisional.canvas.width = provisional.canvas.height = 0;\n    });\n  }\n  private assertOwner(): void {\n    if (this.disposed) throw new Error(\"Cannot paint with a disposed texture.\");\n    let root = GLOBAL_STATE.currentPibblInstance;\n    while (root?.parent) root = GLOBAL_STATE.pibblInstances.get(root.parent);\n    let owner = this.owner;\n    while (owner?.parent) owner = GLOBAL_STATE.pibblInstances.get(owner.parent);\n    if (root !== owner) throw new Error(\"Textures may only be shared within their owning Pibbl tree.\");\n  }\n  private borrow(placement: Readonly<TexturePlacement>): BorrowedTextureRaster {\n    this.assertOwner();\n    const revision = this.revision.get();\n    const provisional = this.provisional;\n    const source =\n      provisional !== undefined && provisional.transaction === GLOBAL_STATE.renderTransaction ?\n        provisional.canvas : this.committed;\n    if (!source) throw new Error(\"Texture pixels are not committed for this render transaction.\");\n    return Object.freeze({ source, width: source.width, height: source.height, revision, resource: this, placement });\n  }\n  private resolvePaint(ctx: RenderingContext2D, bounds: { x: number; y: number; width: number; height: number }, p: Readonly<TexturePlacement>): string | CanvasGradient | CanvasPattern {\n    const borrowed = this.borrow(p);\n    const pattern = ctx.createPattern(borrowed.source, \"repeat\");\n    if (!pattern) throw new Error(\"Could not create texture paint.\");\n    const stretch = p.mode === \"stretch\";\n    const width = stretch ? bounds.width : (p.tileWidth ?? borrowed.width);\n    const height = stretch ? bounds.height : (p.tileHeight ?? borrowed.height);\n    pattern.setTransform(new DOMMatrix().translate(bounds.x + (p.offsetX ?? 0), bounds.y + (p.offsetY ?? 0)).rotate(p.rotation ?? 0).scale(Math.max(0.000001, width) / borrowed.width, Math.max(0.000001, height) / borrowed.height));\n    return pattern;\n  }\n  dispose() {\n    if (this.disposed) return;\n    this.disposed = true;\n    this.unschedule();\n    this.messages.length = 0;\n    try {\n      this.disposeState();\n    } finally {\n      this.canvas.width = this.canvas.height = 0;\n      this.committed && (this.committed.width = this.committed.height = 0);\n      this.spare && (this.spare.width = this.spare.height = 0);\n      this.provisional && (this.provisional.canvas.width = this.provisional.canvas.height = 0);\n      this.state = undefined;\n      this.hasState = false;\n      this.committed = undefined;\n      this.spare = undefined;\n      this.provisional = undefined;\n      this.owner = undefined;\n    }\n  }\n  private disposeState() {\n    if (!this.hasState) return;\n    this.hasState = false;\n    const state = this.state;\n    this.state = undefined;\n    this.call(() => this.definition.dispose?.(state, this.context));\n  }\n}\n\n/**\n * Owns one persistent texture resource for the current mounted hook slot.\n *\n * @param input - Texture recipe to mount or update. See {@link TextureRecipe}.\n * @param options - Resolution and lifecycle options for the mounted texture. See\n * {@link TextureOptions} .\n * @returns A mount-owned texture handle for sending messages and creating paint placements. See\n * {@link Texture} .\n *\n * @see {@link TextureRecipe}\n * @see {@link TextureOptions}\n * @see {@link Texture}\n */\nexport function useTexture<Message>(\n  input: TextureRecipe<Message>,\n  options: TextureOptions = {},\n): Texture<Message> {\n  const recipe = recipes.get(input);\n  if (!recipe)\n    throw new TypeError(\"useTexture requires a defineTexture recipe.\");\n  const { pibblInstance } = requireHookContext();\n  let created = false;\n  const resource = useHookSlot(\"texture\", (teardowns) => {\n    created = true;\n    const value = new Resource(pibblInstance, recipe, options);\n    teardowns.add(() => value.dispose());\n    return value;\n  }).value;\n  if (!created)\n    GLOBAL_STATE.renderTransaction!.onFinish((success) => {\n      if (success) resource.update(recipe, options);\n    });\n  return resource.handle;\n}\n"],
+  "mappings": "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",
+  "names": ["placement"]
+}

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

@@ -0,0 +1,47 @@
+import { type PibblTransitionEffect } from './fade.js';
+import { type TransitionRegion } from './capture.js';
+/**
+ * Color and motion controls for a bifrost visibility transition.
+ *
+ * @see {@link bifrost}
+ */
+export interface PibblBifrostOptions {
+    /** Logical region over which the effect is evaluated. See {@link TransitionRegion}. */
+    readonly region: TransitionRegion;
+    /** Entry location or direction used by the transition. See {@link PibblBifrostOptions}. */
+    readonly entry?: Readonly<{
+        /**
+         * Horizontal coordinate or displacement in the containing coordinate system. See
+         * {@link PibblBifrostOptions}.
+         */
+        x: number;
+        /**
+         * Vertical coordinate or displacement in the containing coordinate system. See
+         * {@link PibblBifrostOptions}.
+         */
+        y: number;
+    }>;
+    /** Brightness control for the transition effect. See {@link PibblBifrostOptions}. */
+    readonly brightness?: number;
+    /** Hue control for the transition's emitted color. See {@link PibblBifrostOptions}. */
+    readonly hue?: number;
+    /** Amount of stretching applied by the transition. See {@link PibblBifrostOptions}. */
+    readonly stretch?: number;
+    /** Intensity of the electrical halo around the core. See {@link PibblBifrostOptions}. */
+    readonly glow?: number;
+    /**
+     * Seed used for deterministic sampling or simulation initialization. See
+     * {@link PibblBifrostOptions}.
+     */
+    readonly seed?: number;
+}
+/**
+ * A prismatic beam stretches a white-hot captured subject toward its entry point.
+ *
+ * @param options - Bifrost appearance and animation settings. See {@link PibblBifrostOptions}.
+ * @returns A bifrost transition effect. See {@link PibblTransitionEffect}.
+ *
+ * @see {@link PibblBifrostOptions}
+ * @see {@link PibblTransitionEffect}
+ */
+export declare function bifrost(options: PibblBifrostOptions): PibblTransitionEffect;

package/dist/lib/transitions/bifrost.js

@@ -0,0 +1,91 @@
+import { bifrostKernel } from "./wasm/bifrost-kernel.js";
+import { opacity } from "../../filters/native.js";
+import { defineTransitionEffect } from "./fade.js";
+import { captureTransition, clamp, finite, regionSnapshot } from "./capture.js";
+function bifrost(options) {
+  const r = regionSnapshot(options.region), ax = r.x + r.width / 2, ay = r.y + r.height;
+  const ex = finite(options.entry?.x ?? ax, "entry.x"), ey = finite(options.entry?.y ?? r.y - r.height * 2, "entry.y");
+  const brightness = finite(options.brightness ?? 1, "brightness", 0), hue = finite(options.hue ?? 0, "hue");
+  const stretchAmount = finite(options.stretch ?? 7, "stretch", 0), aura = finite(options.glow ?? 1, "glow", 0);
+  const samplePatches = bifrostKernel(finite(options.seed ?? 0, "seed"));
+  const distance = Math.hypot(ex - ax, ey - ay), ux = distance ? (ex - ax) / distance : 0, uy = distance ? (ey - ay) / distance : -1;
+  return defineTransitionEffect((q, phase, frame) => {
+    if (q === 1) return [];
+    if (q === 0) return [opacity({ amount: 0 })];
+    return [captureTransition(({ context: c, windows, drawSource, drawTint }) => {
+      const power = Math.pow(Math.sin(Math.PI * q), 0.65) * brightness * Math.pow(clamp((1 - q) / 0.32), 2);
+      const color = (h, a, light = 80) => `hsla(${h + hue},100%,${light}%,${clamp(a)})`;
+      const glow = (x, y, rx, ry, a) => {
+        c.save();
+        c.translate(x, y);
+        c.scale(rx, ry);
+        const gradient = c.createRadialGradient(0, 0, 0, 0, 0, 1);
+        gradient.addColorStop(0, `rgba(255,255,255,${clamp(a)})`);
+        gradient.addColorStop(0.25, color(230, a * 0.5));
+        gradient.addColorStop(1, color(230, 0));
+        c.fillStyle = gradient;
+        c.fillRect(-1, -1, 2, 2);
+        c.restore();
+      };
+      c.save();
+      c.globalCompositeOperation = "lighter";
+      const dx = ax - ex, dy = ay - ey;
+      const angle = Math.atan2(dy, dx), seconds = frame.elapsed / 1e3;
+      const flow = phase === "enter" ? 1 : -1;
+      c.translate(ex, ey);
+      c.rotate(angle);
+      c.beginPath();
+      c.rect(-Math.max(1, distance), -r.width * 2, Math.max(1, distance) * 2, r.width * 4);
+      c.clip();
+      c.rotate(-angle);
+      c.translate(-ex, -ey);
+      const patches = samplePatches(seconds, flow, power, r.width, distance, ex, ey, dx, dy);
+      for (let i = 0; i < 56; i++) {
+        const offset = i * 6;
+        const length = patches[offset + 2], width = patches[offset + 3], h = patches[offset + 4], alpha = patches[offset + 5];
+        c.save();
+        c.translate(patches[offset], patches[offset + 1]);
+        c.rotate(angle);
+        c.scale(length, width);
+        const patch = c.createRadialGradient(0, 0, 0, 0, 0, 1);
+        patch.addColorStop(0, color(h, alpha, 78));
+        patch.addColorStop(0.25, color(h + 12, alpha * 0.8, 72));
+        patch.addColorStop(0.6, color(h - 8, alpha * 0.3, 68));
+        patch.addColorStop(1, color(h, 0, 68));
+        c.fillStyle = patch;
+        c.fillRect(-1, -1, 2, 2);
+        c.restore();
+      }
+      c.restore();
+      const softness = 1 - clamp(q / 0.56), stretch = stretchAmount * softness * softness;
+      const travel = r.height * 0.7 * Math.pow(1 - clamp(q / 0.5), 2);
+      c.save();
+      c.translate(ax + ux * travel, ay + uy * travel);
+      c.transform(1 + stretch * ux * ux, stretch * ux * uy, stretch * ux * uy, 1 + stretch * uy * uy, 0, 0);
+      c.translate(-ax, -ay);
+      c.globalAlpha = clamp(q / 0.075);
+      if (softness > 0) {
+        c.save();
+        c.globalAlpha *= clamp(brightness * 0.7);
+        c.filter = `blur(${(22 + softness * 20) * aura * windows.density}px)`;
+        drawTint("#e1e9ff");
+        c.restore();
+        c.filter = `blur(${(4 + softness * 10) * windows.density}px)`;
+        drawTint("#fff");
+      } else {
+        drawSource();
+        c.globalAlpha *= clamp(clamp((1 - q) / 0.28) * brightness * 1.5);
+        drawTint("#fff");
+      }
+      c.restore();
+      c.globalCompositeOperation = "lighter";
+      const impact = Math.exp(-Math.pow((q - 0.56) / 0.085, 2));
+      glow(ax, r.y + r.height / 2, r.width, r.height * 0.8, impact * brightness * aura);
+      glow(ax, ay, r.width * 0.9, 24, power * aura);
+    })];
+  });
+}
+export {
+  bifrost
+};
+//# sourceMappingURL=bifrost.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/lib/transitions/bifrost.ts"],
+  "sourcesContent": ["import { bifrostKernel } from './wasm/bifrost-kernel.js';\nimport { opacity } from '../../filters/native.js';\nimport { defineTransitionEffect, type PibblTransitionEffect } from './fade.js';\nimport { captureTransition, clamp, finite, regionSnapshot, type TransitionRegion } from './capture.js';\n\n/**\n * Color and motion controls for a bifrost visibility transition.\n *\n * @see {@link bifrost}\n */\nexport interface PibblBifrostOptions {\n  /** Logical region over which the effect is evaluated. See {@link TransitionRegion}. */\n  readonly region: TransitionRegion;\n  /** Entry location or direction used by the transition. See {@link PibblBifrostOptions}. */\n  readonly entry?: Readonly<{\n    /**\n     * Horizontal coordinate or displacement in the containing coordinate system. See\n     * {@link PibblBifrostOptions}.\n     */\n    x: number;\n    /**\n     * Vertical coordinate or displacement in the containing coordinate system. See\n     * {@link PibblBifrostOptions}.\n     */\n    y: number;\n  }>;\n  /** Brightness control for the transition effect. See {@link PibblBifrostOptions}. */\n  readonly brightness?: number;\n  /** Hue control for the transition's emitted color. See {@link PibblBifrostOptions}. */\n  readonly hue?: number;\n  /** Amount of stretching applied by the transition. See {@link PibblBifrostOptions}. */\n  readonly stretch?: number;\n  /** Intensity of the electrical halo around the core. See {@link PibblBifrostOptions}. */\n  readonly glow?: number;\n  /**\n   * Seed used for deterministic sampling or simulation initialization. See\n   * {@link PibblBifrostOptions}.\n   */\n  readonly seed?: number;\n}\n/**\n * A prismatic beam stretches a white-hot captured subject toward its entry point.\n *\n * @param options - Bifrost appearance and animation settings. See {@link PibblBifrostOptions}.\n * @returns A bifrost transition effect. See {@link PibblTransitionEffect}.\n *\n * @see {@link PibblBifrostOptions}\n * @see {@link PibblTransitionEffect}\n */\nexport function bifrost(options: PibblBifrostOptions): PibblTransitionEffect {\n  const r = regionSnapshot(options.region), ax = r.x + r.width / 2, ay = r.y + r.height;\n  const ex = finite(options.entry?.x ?? ax, 'entry.x'), ey = finite(options.entry?.y ?? r.y - r.height * 2, 'entry.y');\n  const brightness = finite(options.brightness ?? 1, 'brightness', 0), hue = finite(options.hue ?? 0, 'hue');\n  const stretchAmount = finite(options.stretch ?? 7, 'stretch', 0), aura = finite(options.glow ?? 1, 'glow', 0);\n  const samplePatches = bifrostKernel(finite(options.seed ?? 0, 'seed'));\n  const distance = Math.hypot(ex - ax, ey - ay), ux = distance ? (ex - ax) / distance : 0, uy = distance ? (ey - ay) / distance : -1;\n  return defineTransitionEffect((q, phase, frame) => {\n    if (q === 1) return [];\n    if (q === 0) return [opacity({ amount: 0 })];\n    return [captureTransition(({ context: c, windows, drawSource, drawTint }) => {\n      const power = Math.pow(Math.sin(Math.PI * q), .65) * brightness * Math.pow(clamp((1 - q) / .32), 2);\n      const color = (h: number, a: number, light = 80) => `hsla(${h + hue},100%,${light}%,${clamp(a)})`;\n      const glow = (x: number, y: number, rx: number, ry: number, a: number) => {\n        c.save(); c.translate(x, y); c.scale(rx, ry);\n        const gradient = c.createRadialGradient(0, 0, 0, 0, 0, 1); gradient.addColorStop(0, `rgba(255,255,255,${clamp(a)})`); gradient.addColorStop(.25, color(230, a * .5)); gradient.addColorStop(1, color(230, 0));\n        c.fillStyle = gradient; c.fillRect(-1, -1, 2, 2); c.restore();\n      };\n      // Seeded, feathered clouds stretched along the transit axis. Unequal\n      // lengths, widths, hues and velocities avoid a fixed rainbow comb.\n      c.save(); c.globalCompositeOperation = 'lighter';\n      const dx = ax - ex, dy = ay - ey;\n      const angle = Math.atan2(dy, dx), seconds = frame.elapsed / 1000;\n      const flow = phase === 'enter' ? 1 : -1;\n      // End the beam at the impact plane, as the original ribbons did.\n      c.translate(ex, ey); c.rotate(angle);\n      c.beginPath(); c.rect(-Math.max(1, distance), -r.width * 2, Math.max(1, distance) * 2, r.width * 4); c.clip();\n      c.rotate(-angle); c.translate(-ex, -ey);\n      const patches = samplePatches(seconds, flow, power, r.width, distance, ex, ey, dx, dy);\n      for (let i = 0; i < 56; i++) {\n        const offset = i * 6;\n        const length = patches[offset + 2]!, width = patches[offset + 3]!, h = patches[offset + 4]!, alpha = patches[offset + 5]!;\n        c.save(); c.translate(patches[offset]!, patches[offset + 1]!);\n        c.rotate(angle); c.scale(length, width);\n        const patch = c.createRadialGradient(0, 0, 0, 0, 0, 1);\n        patch.addColorStop(0, color(h, alpha, 78));\n        patch.addColorStop(.25, color(h + 12, alpha * .8, 72));\n        patch.addColorStop(.6, color(h - 8, alpha * .3, 68));\n        patch.addColorStop(1, color(h, 0, 68));\n        c.fillStyle = patch; c.fillRect(-1, -1, 2, 2); c.restore();\n      }\n      c.restore();\n      const softness = 1 - clamp(q / .56), stretch = stretchAmount * softness * softness;\n      const travel = r.height * .7 * Math.pow(1 - clamp(q / .5), 2);\n      c.save(); c.translate(ax + ux * travel, ay + uy * travel);\n      c.transform(1 + stretch * ux * ux, stretch * ux * uy, stretch * ux * uy, 1 + stretch * uy * uy, 0, 0); c.translate(-ax, -ay);\n      c.globalAlpha = clamp(q / .075);\n      if (softness > 0) {\n        c.save(); c.globalAlpha *= clamp(brightness * .7); c.filter = `blur(${(22 + softness * 20) * aura * windows.density}px)`; drawTint('#e1e9ff'); c.restore();\n        c.filter = `blur(${(4 + softness * 10) * windows.density}px)`; drawTint('#fff');\n      } else {\n        drawSource(); c.globalAlpha *= clamp(clamp((1 - q) / .28) * brightness * 1.5); drawTint('#fff');\n      }\n      c.restore(); c.globalCompositeOperation = 'lighter';\n      const impact = Math.exp(-Math.pow((q - .56) / .085, 2));\n      glow(ax, r.y + r.height / 2, r.width, r.height * .8, impact * brightness * aura);\n      glow(ax, ay, r.width * .9, 24, power * aura);\n    })];\n  });\n}\n"],
+  "mappings": "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",
+  "names": []
+}

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

@@ -0,0 +1,14 @@
+import type { PibblVisibilityTransition } from "../hooks/use-visibility-transition.js";
+import type { PibblFilter } from '../style/filter-types.js';
+declare const bindingBrand: unique symbol;
+/**
+ * An opaque connection between one transition controller and its painted subject.
+ *
+ * @see {@link PibblVisibilityTransition}
+ */
+export interface PibblTransitionBinding {
+    readonly [bindingBrand]: true;
+}
+export declare function createTransitionBinding(resolve: () => readonly PibblFilter[]): PibblTransitionBinding;
+export declare function resolveTransitionBinding(binding: PibblTransitionBinding): readonly PibblFilter[];
+export {};