@flighthq/effects-canvas 0.3.0-next.906.07cea63 → 0.3.0

package/dist/canvasBevelEffect.d.ts

@@ -0,0 +1,7 @@
+import type { BevelEffect, CanvasRenderEffectRunner, CanvasRenderState, CanvasRenderTarget, CanvasRenderTargetPool } from '@flighthq/types/contract';
+export declare function applyBevelEffectToCanvas(source: Readonly<CanvasRenderTarget>, dest: Readonly<CanvasRenderTarget>, effect: Readonly<BevelEffect>): void;
+export declare function applyBevelEffectToCanvas(source: Readonly<CanvasRenderTarget>, dest: Readonly<CanvasRenderTarget>, pool: CanvasRenderTargetPool, effect: Readonly<BevelEffect>): void;
+export declare function clipCanvasBevelBand(band: Readonly<CanvasRenderTarget>, source: Readonly<CanvasRenderTarget>, bevelType: BevelEffect['bevelType']): void;
+export declare const defaultCanvasBevelEffectRunner: CanvasRenderEffectRunner;
+export declare function registerCanvasBevelEffect(state: CanvasRenderState): void;
+//# sourceMappingURL=canvasBevelEffect.d.ts.map

package/dist/canvasBevelEffect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"canvasBevelEffect.d.ts","sourceRoot":"","sources":["../src/canvasBevelEffect.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EACX,wBAAwB,EACxB,iBAAiB,EACjB,kBAAkB,EAClB,sBAAsB,EACvB,MAAM,0BAA0B,CAAC;AA0BlC,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,QAAQ,CAAC,kBAAkB,CAAC,EACpC,IAAI,EAAE,QAAQ,CAAC,kBAAkB,CAAC,EAClC,MAAM,EAAE,QAAQ,CAAC,WAAW,CAAC,GAC5B,IAAI,CAAC;AACR,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,QAAQ,CAAC,kBAAkB,CAAC,EACpC,IAAI,EAAE,QAAQ,CAAC,kBAAkB,CAAC,EAClC,IAAI,EAAE,sBAAsB,EAC5B,MAAM,EAAE,QAAQ,CAAC,WAAW,CAAC,GAC5B,IAAI,CAAC;AAeR,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,QAAQ,CAAC,kBAAkB,CAAC,EAClC,MAAM,EAAE,QAAQ,CAAC,kBAAkB,CAAC,EACpC,SAAS,EAAE,WAAW,CAAC,WAAW,CAAC,GAClC,IAAI,CAON;AAED,eAAO,MAAM,8BAA8B,EAAE,wBAE5C,CAAC;AAEF,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,iBAAiB,GAAG,IAAI,CAExE"}

package/dist/canvasBevelEffect.js

@@ -0,0 +1,76 @@
+import { drawCanvasEffectPass } from './canvasEffectCompositing';
+import { acquireCanvasRenderTarget, createCanvasRenderTargetPool, releaseCanvasRenderTarget, } from './canvasRenderEffectPipeline';
+import { registerCanvasRenderEffect } from './canvasRenderEffectRegistry';
+import { clearCanvasTarget, compositeCanvasImage, drawCanvasTintedAlphaMask } from './canvasSourceModeCompositing';
+export function applyBevelEffectToCanvas(source, dest, poolOrEffect, maybeEffect) {
+    const effect = maybeEffect ?? poolOrEffect;
+    const pool = maybeEffect === undefined ? createCanvasRenderTargetPool() : poolOrEffect;
+    applyBevelEffectToCanvasWithPool(source, dest, pool, effect);
+}
+// Clips the assembled band to the region `bevelType` keeps: inside the shape for 'inner', outside it for
+// 'outer', everywhere for 'full'. Exported because the gradient bevel applies the identical rule to a
+// ramp-tinted band, and one clip is easier to keep honest than two.
+export function clipCanvasBevelBand(band, source, bevelType) {
+    if (bevelType === 'outer') {
+        compositeCanvasImage(band, source, 0, 0, 'destination-out');
+        return;
+    }
+    // 'inner' is the default, matching the GL pass; 'full' deliberately clips nothing.
+    if (bevelType !== 'full')
+        compositeCanvasImage(band, source, 0, 0, 'destination-in');
+}
+export const defaultCanvasBevelEffectRunner = (ctx, effect) => {
+    applyBevelEffectToCanvas(ctx.source, ctx.dest, ctx.pool, effect);
+};
+export function registerCanvasBevelEffect(state) {
+    registerCanvasRenderEffect(state, 'BevelEffect', defaultCanvasBevelEffectRunner);
+}
+function applyBevelEffectToCanvasWithPool(source, dest, pool, effect) {
+    const blurred = acquireCanvasRenderTarget(pool, source.width, source.height);
+    const lit = acquireCanvasRenderTarget(pool, source.width, source.height);
+    const shade = acquireCanvasRenderTarget(pool, source.width, source.height);
+    const side = acquireCanvasRenderTarget(pool, source.width, source.height);
+    const tinted = acquireCanvasRenderTarget(pool, source.width, source.height);
+    const band = acquireCanvasRenderTarget(pool, source.width, source.height);
+    const strength = Math.min(1, effect.strength ?? 1);
+    const blur = Math.max(0, ((effect.blurX ?? 4) + (effect.blurY ?? 4)) / 2);
+    const angle = ((effect.angle ?? 45) * Math.PI) / 180;
+    const distance = effect.distance ?? 4;
+    const offsetX = Math.cos(angle) * distance;
+    const offsetY = Math.sin(angle) * distance;
+    drawCanvasEffectPass(blurred, source, blur > 0 ? `blur(${blur}px)` : 'none');
+    // The two offset copies. `lit` is shifted TOWARD the light and `shade` away from it, so the region one
+    // covers and the other does not is the edge band facing that direction.
+    clearCanvasTarget(lit);
+    compositeCanvasImage(lit, blurred, -offsetX, -offsetY);
+    clearCanvasTarget(shade);
+    compositeCanvasImage(shade, blurred, offsetX, offsetY);
+    clearCanvasTarget(band);
+    // Highlight side: lit with shade knocked out of it. The knockout must precede the tint — tinting first
+    // would fill the whole offset silhouette and the "band" would cover the shape rather than its edge.
+    // Both sides are built into `side` and tinted into `tinted`, so neither offset copy is ever written
+    // over while the other side still needs to read it.
+    clearCanvasTarget(side);
+    compositeCanvasImage(side, lit);
+    compositeCanvasImage(side, shade, 0, 0, 'destination-out');
+    drawCanvasTintedAlphaMask(tinted, side, effect.highlightColor ?? 0xffffff, effect.highlightAlpha ?? 1, strength);
+    compositeCanvasImage(band, tinted);
+    // Shadow side: the same difference the other way round.
+    clearCanvasTarget(side);
+    compositeCanvasImage(side, shade);
+    compositeCanvasImage(side, lit, 0, 0, 'destination-out');
+    drawCanvasTintedAlphaMask(tinted, side, effect.shadowColor ?? 0x000000, effect.shadowAlpha ?? 1, strength);
+    compositeCanvasImage(band, tinted);
+    clipCanvasBevelBand(band, source, effect.bevelType);
+    clearCanvasTarget(dest);
+    if ((effect.sourceMode ?? 'draw') !== 'hide')
+        compositeCanvasImage(dest, source);
+    compositeCanvasImage(dest, band);
+    releaseCanvasRenderTarget(pool, band);
+    releaseCanvasRenderTarget(pool, tinted);
+    releaseCanvasRenderTarget(pool, side);
+    releaseCanvasRenderTarget(pool, shade);
+    releaseCanvasRenderTarget(pool, lit);
+    releaseCanvasRenderTarget(pool, blurred);
+}
+//# sourceMappingURL=canvasBevelEffect.js.map

package/dist/canvasBevelEffect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"canvasBevelEffect.js","sourceRoot":"","sources":["../src/canvasBevelEffect.ts"],"names":[],"mappings":"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"}

package/dist/canvasBlendEffect.d.ts

@@ -0,0 +1,9 @@
+import type { AdvancedBlendMode, BlendEffect, CanvasRenderEffectRunner, CanvasRenderState, CanvasRenderTarget } from '@flighthq/types/contract';
+export declare function applyBlendEffectToCanvas(state: CanvasRenderState, source: Readonly<CanvasRenderTarget>, dest: Readonly<CanvasRenderTarget>, effect: Readonly<BlendEffect>): void;
+export declare const defaultCanvasBlendEffectRunner: CanvasRenderEffectRunner;
+export declare function getCanvasBlendEffectBackdrop(state: CanvasRenderState, backdropKey: string | null): CanvasRenderTarget | null;
+export declare function getCanvasBlendEffectCompositeOperation(mode: AdvancedBlendMode): GlobalCompositeOperation;
+export declare function registerCanvasBlendEffect(state: CanvasRenderState): void;
+export declare function registerCanvasBlendEffectBackdrop(state: CanvasRenderState, backdropKey: string, target: CanvasRenderTarget): void;
+export declare function unregisterCanvasBlendEffectBackdrop(state: CanvasRenderState, backdropKey: string): boolean;
+//# sourceMappingURL=canvasBlendEffect.d.ts.map

package/dist/canvasBlendEffect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"canvasBlendEffect.d.ts","sourceRoot":"","sources":["../src/canvasBlendEffect.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,iBAAiB,EACjB,WAAW,EACX,wBAAwB,EACxB,iBAAiB,EACjB,kBAAkB,EACnB,MAAM,0BAA0B,CAAC;AAmBlC,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,iBAAiB,EACxB,MAAM,EAAE,QAAQ,CAAC,kBAAkB,CAAC,EACpC,IAAI,EAAE,QAAQ,CAAC,kBAAkB,CAAC,EAClC,MAAM,EAAE,QAAQ,CAAC,WAAW,CAAC,GAC5B,IAAI,CAuBN;AAED,eAAO,MAAM,8BAA8B,EAAE,wBAE5C,CAAC;AAKF,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,iBAAiB,EACxB,WAAW,EAAE,MAAM,GAAG,IAAI,GACzB,kBAAkB,GAAG,IAAI,CAG3B;AAMD,wBAAgB,sCAAsC,CAAC,IAAI,EAAE,iBAAiB,GAAG,wBAAwB,CAExG;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,iBAAiB,GAAG,IAAI,CAExE;AAKD,wBAAgB,iCAAiC,CAC/C,KAAK,EAAE,iBAAiB,EACxB,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,kBAAkB,GACzB,IAAI,CAGN;AAID,wBAAgB,mCAAmC,CAAC,KAAK,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAE1G"}

package/dist/canvasBlendEffect.js

@@ -0,0 +1,89 @@
+import { getCanvasRenderStateRuntime } from '@flighthq/scene2d-canvas/contract';
+import { drawCanvasEffectPass } from './canvasEffectCompositing';
+import { registerCanvasRenderEffect } from './canvasRenderEffectRegistry';
+// Advanced-blend composite pass: draw a registered backdrop, then draw the incoming layer over it with
+// the Canvas 2D compositing operation named by the effect's `mode`. This is the Canvas realization of the
+// `BlendEffect` recipe — the escape hatch for the AdvancedBlendMode set the fixed-function BlendMode enum
+// cannot express.
+//
+// Canvas 2D is the one backend where this is native rather than emulated. Its blend
+// globalCompositeOperation values implement the same W3C formula the GL pass spells out in GLSL —
+// cs' = (1 - ab) * cs + ab * B(cb, cs), then Porter-Duff source-over — so there is no shader, no
+// offscreen bounce beyond the one the pipeline already provides, and no per-pixel readback. `opacity`
+// maps to globalAlpha, which scales the source alpha ahead of compositing exactly as the GL pass's
+// `layer.a * u_opacity` does.
+//
+// An unregistered or absent `backdropKey` composites the layer over an implicit transparent backdrop,
+// which reduces to a source-over passthrough rather than erroring — matching the GL contract.
+export function applyBlendEffectToCanvas(state, source, dest, effect) {
+    const backdrop = getCanvasBlendEffectBackdrop(state, effect.backdropKey ?? null);
+    if (backdrop === null) {
+        drawCanvasEffectPass(dest, source, 'none');
+        return;
+    }
+    const operation = getCanvasBlendEffectCompositeOperation(effect.mode);
+    const ctx = dest.context;
+    ctx.save();
+    ctx.setTransform(1, 0, 0, 1, 0, 0);
+    ctx.globalAlpha = 1;
+    ctx.globalCompositeOperation = 'source-over';
+    ctx.filter = 'none';
+    ctx.clearRect(0, 0, dest.width, dest.height);
+    // The backdrop goes down first and unblended: it is the destination the mode reads, so it has to be
+    // present in `dest` before the layer is drawn. Drawing the layer first and the backdrop second would
+    // blend in the opposite direction, which is a different image for every non-commutative mode.
+    ctx.drawImage(backdrop.canvas, 0, 0);
+    ctx.globalAlpha = effect.opacity ?? 1;
+    ctx.globalCompositeOperation = operation;
+    ctx.drawImage(source.canvas, 0, 0);
+    ctx.restore();
+}
+export const defaultCanvasBlendEffectRunner = (ctx, effect) => {
+    applyBlendEffectToCanvas(ctx.state, ctx.source, ctx.dest, effect);
+};
+// Returns the backdrop registered under `backdropKey` for this state, or null when the key is null or
+// nothing is registered. Doubles as the introspection query behind the passthrough fallback: a caller
+// that wants to know whether a blend will actually blend asks here rather than inferring it from pixels.
+export function getCanvasBlendEffectBackdrop(state, backdropKey) {
+    if (backdropKey === null)
+        return null;
+    return getCanvasRenderStateRuntime(state).canvasBlendEffectBackdrops?.get(backdropKey) ?? null;
+}
+// Maps an AdvancedBlendMode to the Canvas 2D globalCompositeOperation that realizes it. Every one of the
+// eleven modes has a native operation, including the four non-separable HSL ones, which is why this
+// backend needs no blend math of its own. An unrecognized mode — a vendor-prefixed kind Canvas has never
+// heard of — falls back to 'source-over', the same Normal passthrough the GL pass gives an unknown mode.
+export function getCanvasBlendEffectCompositeOperation(mode) {
+    return BLEND_MODE_OPERATION[mode] ?? 'source-over';
+}
+export function registerCanvasBlendEffect(state) {
+    registerCanvasRenderEffect(state, 'BlendEffect', defaultCanvasBlendEffectRunner);
+}
+// Registers a backdrop target under `backdropKey` for this state, so a BlendEffect naming that key blends
+// its layer over the target. Last write wins. The registry holds the target only and never owns or frees
+// it — the caller keeps ownership of the canvas, as with the GL texture registry.
+export function registerCanvasBlendEffectBackdrop(state, backdropKey, target) {
+    const runtime = getCanvasRenderStateRuntime(state);
+    (runtime.canvasBlendEffectBackdrops ??= new Map()).set(backdropKey, target);
+}
+// Removes the backdrop registered under `backdropKey`, returning true when one was present. The target
+// itself is the caller's to dispose; this only drops the registry reference.
+export function unregisterCanvasBlendEffectBackdrop(state, backdropKey) {
+    return getCanvasRenderStateRuntime(state).canvasBlendEffectBackdrops?.delete(backdropKey) ?? false;
+}
+// AdvancedBlendMode → Canvas 2D globalCompositeOperation. Alphabetical by mode, matching the value order
+// in the AdvancedBlendMode namespace.
+const BLEND_MODE_OPERATION = {
+    Color: 'color',
+    ColorBurn: 'color-burn',
+    ColorDodge: 'color-dodge',
+    Difference: 'difference',
+    Exclusion: 'exclusion',
+    HardLight: 'hard-light',
+    Hue: 'hue',
+    Luminosity: 'luminosity',
+    Overlay: 'overlay',
+    Saturation: 'saturation',
+    SoftLight: 'soft-light',
+};
+//# sourceMappingURL=canvasBlendEffect.js.map

package/dist/canvasBlendEffect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"canvasBlendEffect.js","sourceRoot":"","sources":["../src/canvasBlendEffect.ts"],"names":[],"mappings":"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"}

package/dist/canvasBloomEffect.d.ts

@@ -1,4 +1,5 @@
-import type { BloomEffect, CanvasRenderEffectRunner, CanvasRenderTarget, CanvasRenderTargetPool } from '@flighthq/types/contract';
+import type { BloomEffect, CanvasRenderEffectRunner, CanvasRenderState, CanvasRenderTarget, CanvasRenderTargetPool } from '@flighthq/types/contract';
 export declare function applyBloomEffectToCanvas(source: Readonly<CanvasRenderTarget>, dest: Readonly<CanvasRenderTarget>, pool: CanvasRenderTargetPool, effect: Readonly<BloomEffect>): void;
 export declare const defaultCanvasBloomEffectRunner: CanvasRenderEffectRunner;
+export declare function registerCanvasBloomEffect(state: CanvasRenderState): void;
 //# sourceMappingURL=canvasBloomEffect.d.ts.map

package/dist/canvasBloomEffect.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"canvasBloomEffect.d.ts","sourceRoot":"","sources":["../src/canvasBloomEffect.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,WAAW,EACX,wBAAwB,EACxB,kBAAkB,EAClB,sBAAsB,EACvB,MAAM,0BAA0B,CAAC;AASlC,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,QAAQ,CAAC,kBAAkB,CAAC,EACpC,IAAI,EAAE,QAAQ,CAAC,kBAAkB,CAAC,EAClC,IAAI,EAAE,sBAAsB,EAC5B,MAAM,EAAE,QAAQ,CAAC,WAAW,CAAC,GAC5B,IAAI,CAkCN;AAED,eAAO,MAAM,8BAA8B,EAAE,wBAE5C,CAAC"}
+{"version":3,"file":"canvasBloomEffect.d.ts","sourceRoot":"","sources":["../src/canvasBloomEffect.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,WAAW,EACX,wBAAwB,EACxB,iBAAiB,EACjB,kBAAkB,EAClB,sBAAsB,EACvB,MAAM,0BAA0B,CAAC;AAUlC,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,QAAQ,CAAC,kBAAkB,CAAC,EACpC,IAAI,EAAE,QAAQ,CAAC,kBAAkB,CAAC,EAClC,IAAI,EAAE,sBAAsB,EAC5B,MAAM,EAAE,QAAQ,CAAC,WAAW,CAAC,GAC5B,IAAI,CAkCN;AAED,eAAO,MAAM,8BAA8B,EAAE,wBAE5C,CAAC;AAEF,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,iBAAiB,GAAG,IAAI,CAExE"}

package/dist/canvasBloomEffect.js

@@ -1,6 +1,7 @@
 import { computeBloomBlurRadius } from '@flighthq/effects/contract';
 import { drawCanvasEffectPass } from './canvasEffectCompositing';
 import { acquireCanvasRenderTarget, releaseCanvasRenderTarget } from './canvasRenderEffectPipeline';
+import { registerCanvasRenderEffect } from './canvasRenderEffectRegistry';
 // Bloom (REAL): bright-pass → blur the bright branch → additively composite back. Multi-pass: it
 // acquires a scratch canvas from the pool, isolates bright pixels by pushing contrast hard so dim
 // pixels crush to black, blurs that branch, then draws it over the scene with the 'lighter'
@@ -40,4 +41,7 @@ export function applyBloomEffectToCanvas(source, dest, pool, effect) {
 export const defaultCanvasBloomEffectRunner = (ctx, effect) => {
     applyBloomEffectToCanvas(ctx.source, ctx.dest, ctx.pool, effect);
 };
+export function registerCanvasBloomEffect(state) {
+    registerCanvasRenderEffect(state, 'BloomEffect', defaultCanvasBloomEffectRunner);
+}
 //# sourceMappingURL=canvasBloomEffect.js.map

package/dist/canvasBloomEffect.js.map

@@ -1 +1 @@
-{"version":3,"file":"canvasBloomEffect.js","sourceRoot":"","sources":["../src/canvasBloomEffect.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AAQpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAE,yBAAyB,EAAE,yBAAyB,EAAE,MAAM,8BAA8B,CAAC;AAEpG,iGAAiG;AACjG,kGAAkG;AAClG,4FAA4F;AAC5F,2FAA2F;AAC3F,MAAM,UAAU,wBAAwB,CACtC,MAAoC,EACpC,IAAkC,EAClC,IAA4B,EAC5B,MAA6B;IAE7B,MAAM,SAAS,GAAG,MAAM,CAAC,SAAS,IAAI,GAAG,CAAC;IAC1C,MAAM,SAAS,GAAG,MAAM,CAAC,SAAS,IAAI,CAAC,CAAC;IACxC,MAAM,MAAM,GAAG,sBAAsB,CAAC,MAAM,CAAC,CAAC;IAE9C,iGAAiG;IACjG,oGAAoG;IACpG,6CAA6C;IAC7C,MAAM,QAAQ,GAAG,CAAC,GAAG,SAAS,GAAG,CAAC,CAAC;IACnC,MAAM,eAAe,GAAG,CAAC,GAAG,SAAS,CAAC;IACtC,MAAM,MAAM,GAAG,yBAAyB,CAAC,IAAI,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;IAC5E,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,QAAQ,gBAAgB,eAAe,GAAG,CAAC,CAAC;IAE7F,mGAAmG;IACnG,MAAM,OAAO,GAAG,yBAAyB,CAAC,IAAI,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;IAC7E,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;QACf,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,MAAM,KAAK,CAAC,CAAC;IAC7D,CAAC;SAAM,CAAC;QACN,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAChD,CAAC;IAED,wGAAwG;IACxG,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3C,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC;IACzB,GAAG,CAAC,IAAI,EAAE,CAAC;IACX,GAAG,CAAC,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IACnC,GAAG,CAAC,wBAAwB,GAAG,SAAS,CAAC;IACzC,GAAG,CAAC,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC;IACtD,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC;IACpB,GAAG,CAAC,SAAS,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IACpC,GAAG,CAAC,OAAO,EAAE,CAAC;IAEd,yBAAyB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACxC,yBAAyB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AAC3C,CAAC;AAED,MAAM,CAAC,MAAM,8BAA8B,GAA6B,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE;IACtF,wBAAwB,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,MAAqB,CAAC,CAAC;AAClF,CAAC,CAAC"}
+{"version":3,"file":"canvasBloomEffect.js","sourceRoot":"","sources":["../src/canvasBloomEffect.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AASpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAE,yBAAyB,EAAE,yBAAyB,EAAE,MAAM,8BAA8B,CAAC;AACpG,OAAO,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAC;AAE1E,iGAAiG;AACjG,kGAAkG;AAClG,4FAA4F;AAC5F,2FAA2F;AAC3F,MAAM,UAAU,wBAAwB,CACtC,MAAoC,EACpC,IAAkC,EAClC,IAA4B,EAC5B,MAA6B;IAE7B,MAAM,SAAS,GAAG,MAAM,CAAC,SAAS,IAAI,GAAG,CAAC;IAC1C,MAAM,SAAS,GAAG,MAAM,CAAC,SAAS,IAAI,CAAC,CAAC;IACxC,MAAM,MAAM,GAAG,sBAAsB,CAAC,MAAM,CAAC,CAAC;IAE9C,iGAAiG;IACjG,oGAAoG;IACpG,6CAA6C;IAC7C,MAAM,QAAQ,GAAG,CAAC,GAAG,SAAS,GAAG,CAAC,CAAC;IACnC,MAAM,eAAe,GAAG,CAAC,GAAG,SAAS,CAAC;IACtC,MAAM,MAAM,GAAG,yBAAyB,CAAC,IAAI,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;IAC5E,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,QAAQ,gBAAgB,eAAe,GAAG,CAAC,CAAC;IAE7F,mGAAmG;IACnG,MAAM,OAAO,GAAG,yBAAyB,CAAC,IAAI,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;IAC7E,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;QACf,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,MAAM,KAAK,CAAC,CAAC;IAC7D,CAAC;SAAM,CAAC;QACN,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAChD,CAAC;IAED,wGAAwG;IACxG,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3C,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC;IACzB,GAAG,CAAC,IAAI,EAAE,CAAC;IACX,GAAG,CAAC,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IACnC,GAAG,CAAC,wBAAwB,GAAG,SAAS,CAAC;IACzC,GAAG,CAAC,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC;IACtD,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC;IACpB,GAAG,CAAC,SAAS,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IACpC,GAAG,CAAC,OAAO,EAAE,CAAC;IAEd,yBAAyB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACxC,yBAAyB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AAC3C,CAAC;AAED,MAAM,CAAC,MAAM,8BAA8B,GAA6B,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE;IACtF,wBAAwB,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,MAAqB,CAAC,CAAC;AAClF,CAAC,CAAC;AAEF,MAAM,UAAU,yBAAyB,CAAC,KAAwB;IAChE,0BAA0B,CAAC,KAAK,EAAE,aAAa,EAAE,8BAA8B,CAAC,CAAC;AACnF,CAAC"}

package/dist/canvasBlurEffect.d.ts

@@ -1,4 +1,5 @@
-import type { BlurEffect, CanvasRenderEffectRunner, CanvasRenderTarget } from '@flighthq/types/contract';
+import type { BlurEffect, CanvasRenderEffectRunner, CanvasRenderState, CanvasRenderTarget } from '@flighthq/types/contract';
 export declare function applyBlurEffectToCanvas(source: Readonly<CanvasRenderTarget>, dest: Readonly<CanvasRenderTarget>, effect: Readonly<BlurEffect>): void;
 export declare const defaultCanvasBlurEffectRunner: CanvasRenderEffectRunner;
+export declare function registerCanvasBlurEffect(state: CanvasRenderState): void;
 //# sourceMappingURL=canvasBlurEffect.d.ts.map

package/dist/canvasBlurEffect.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"canvasBlurEffect.d.ts","sourceRoot":"","sources":["../src/canvasBlurEffect.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,wBAAwB,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAOzG,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,QAAQ,CAAC,kBAAkB,CAAC,EACpC,IAAI,EAAE,QAAQ,CAAC,kBAAkB,CAAC,EAClC,MAAM,EAAE,QAAQ,CAAC,UAAU,CAAC,GAC3B,IAAI,CAKN;AAED,eAAO,MAAM,6BAA6B,EAAE,wBAE3C,CAAC"}
+{"version":3,"file":"canvasBlurEffect.d.ts","sourceRoot":"","sources":["../src/canvasBlurEffect.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EACV,wBAAwB,EACxB,iBAAiB,EACjB,kBAAkB,EACnB,MAAM,0BAA0B,CAAC;AAQlC,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,QAAQ,CAAC,kBAAkB,CAAC,EACpC,IAAI,EAAE,QAAQ,CAAC,kBAAkB,CAAC,EAClC,MAAM,EAAE,QAAQ,CAAC,UAAU,CAAC,GAC3B,IAAI,CAKN;AAED,eAAO,MAAM,6BAA6B,EAAE,wBAE3C,CAAC;AAEF,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,iBAAiB,GAAG,IAAI,CAEvE"}

package/dist/canvasBlurEffect.js

@@ -1,4 +1,5 @@
 import { drawCanvasEffectPass } from './canvasEffectCompositing';
+import { registerCanvasRenderEffect } from './canvasRenderEffectRegistry';
 // Plain Gaussian blur via the Canvas 2D `blur()` CSS filter — the same primitive the canvas bloom
 // branch uses. Canvas `blur()` is isotropic (a single radius), so the per-axis `blurX`/`blurY` sigmas
 // are averaged into one radius; a non-positive radius passes the image through unchanged.
@@ -11,4 +12,7 @@ export function applyBlurEffectToCanvas(source, dest, effect) {
 export const defaultCanvasBlurEffectRunner = (ctx, effect) => {
     applyBlurEffectToCanvas(ctx.source, ctx.dest, effect);
 };
+export function registerCanvasBlurEffect(state) {
+    registerCanvasRenderEffect(state, 'BlurEffect', defaultCanvasBlurEffectRunner);
+}
 //# sourceMappingURL=canvasBlurEffect.js.map

package/dist/canvasBlurEffect.js.map

@@ -1 +1 @@
-{"version":3,"file":"canvasBlurEffect.js","sourceRoot":"","sources":["../src/canvasBlurEffect.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAEjE,kGAAkG;AAClG,sGAAsG;AACtG,0FAA0F;AAC1F,MAAM,UAAU,uBAAuB,CACrC,MAAoC,EACpC,IAAkC,EAClC,MAA4B;IAE5B,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,CAAC,CAAC;IAChC,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,CAAC,CAAC;IAChC,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;IAChD,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,MAAM,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;AAChF,CAAC;AAED,MAAM,CAAC,MAAM,6BAA6B,GAA6B,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE;IACrF,uBAAuB,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,IAAI,EAAE,MAAoB,CAAC,CAAC;AACtE,CAAC,CAAC"}
+{"version":3,"file":"canvasBlurEffect.js","sourceRoot":"","sources":["../src/canvasBlurEffect.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAC;AAE1E,kGAAkG;AAClG,sGAAsG;AACtG,0FAA0F;AAC1F,MAAM,UAAU,uBAAuB,CACrC,MAAoC,EACpC,IAAkC,EAClC,MAA4B;IAE5B,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,CAAC,CAAC;IAChC,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,CAAC,CAAC;IAChC,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;IAChD,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,MAAM,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;AAChF,CAAC;AAED,MAAM,CAAC,MAAM,6BAA6B,GAA6B,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE;IACrF,uBAAuB,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,IAAI,EAAE,MAAoB,CAAC,CAAC;AACtE,CAAC,CAAC;AAEF,MAAM,UAAU,wBAAwB,CAAC,KAAwB;IAC/D,0BAA0B,CAAC,KAAK,EAAE,YAAY,EAAE,6BAA6B,CAAC,CAAC;AACjF,CAAC"}

package/dist/canvasColorMatrixPass.d.ts

@@ -1,3 +1,4 @@
 import type { CanvasRenderTarget } from '@flighthq/types/contract';
 export declare function applyColorMatrixPassToCanvas(source: Readonly<CanvasRenderTarget>, dest: Readonly<CanvasRenderTarget>, matrix: ReadonlyArray<number>): void;
+export declare function applyColorMatrixToImageDataBytes(data: Uint8ClampedArray, pixelCount: number, matrix: ReadonlyArray<number>): void;
 //# sourceMappingURL=canvasColorMatrixPass.d.ts.map

package/dist/canvasColorMatrixPass.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"canvasColorMatrixPass.d.ts","sourceRoot":"","sources":["../src/canvasColorMatrixPass.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AASnE,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,QAAQ,CAAC,kBAAkB,CAAC,EACpC,IAAI,EAAE,QAAQ,CAAC,kBAAkB,CAAC,EAClC,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,GAC5B,IAAI,CAmCN"}
+{"version":3,"file":"canvasColorMatrixPass.d.ts","sourceRoot":"","sources":["../src/canvasColorMatrixPass.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAQnE,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,QAAQ,CAAC,kBAAkB,CAAC,EACpC,IAAI,EAAE,QAAQ,CAAC,kBAAkB,CAAC,EAClC,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,GAC5B,IAAI,CAIN;AAMD,wBAAgB,gCAAgC,CAC9C,IAAI,EAAE,iBAAiB,EACvB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,GAC5B,IAAI,CAiCN"}

package/dist/canvasColorMatrixPass.js

@@ -2,9 +2,17 @@ import { drawCanvasImageDataPass } from './canvasEffectCompositing';
 // Generic pointwise color-matrix pass — the single fold-in realization for the whole matrix-tier
 // Adjustment family on Canvas 2D. A run of consecutive matrix-tier adjustments fuses to ONE 4×5 matrix
 // (in the adjustments colorMatrixMath convention: linear RGBA coefficients + normalized-linear bias
-// column) and runs through this one per-pixel pass instead of one pass per op. ImageData channels are
-// byte-domain, so only the normalized bias column is scaled by 255 before the clamped store.
+// column) and runs through this one per-pixel pass instead of one pass per op.
 export function applyColorMatrixPassToCanvas(source, dest, matrix) {
+    drawCanvasImageDataPass(dest, source, (data, pixelCount) => {
+        applyColorMatrixToImageDataBytes(data, pixelCount, matrix);
+    });
+}
+// The pure per-pixel kernel of the color-matrix pass, exported separately so the matrix math can be
+// exercised against a plain byte array with no canvas context and no module substitution. ImageData
+// channels are byte-domain, so only the normalized-linear bias column is scaled by 255 before the
+// clamped store.
+export function applyColorMatrixToImageDataBytes(data, pixelCount, matrix) {
     const m0 = matrix[0] ?? 0;
     const m1 = matrix[1] ?? 0;
     const m2 = matrix[2] ?? 0;
@@ -25,19 +33,17 @@ export function applyColorMatrixPassToCanvas(source, dest, matrix) {
     const m17 = matrix[17] ?? 0;
     const m18 = matrix[18] ?? 0;
     const m19 = matrix[19] ?? 0;
-    drawCanvasImageDataPass(dest, source, (data, pixelCount) => {
-        for (let i = 0; i < pixelCount; i++) {
-            const p = i * 4;
-            const r = data[p];
-            const g = data[p + 1];
-            const b = data[p + 2];
-            const a = data[p + 3];
-            // Uint8ClampedArray clamps stores to 0–255, so an explicit clamp is unnecessary.
-            data[p] = m0 * r + m1 * g + m2 * b + m3 * a + m4 * 255;
-            data[p + 1] = m5 * r + m6 * g + m7 * b + m8 * a + m9 * 255;
-            data[p + 2] = m10 * r + m11 * g + m12 * b + m13 * a + m14 * 255;
-            data[p + 3] = m15 * r + m16 * g + m17 * b + m18 * a + m19 * 255;
-        }
-    });
+    for (let i = 0; i < pixelCount; i++) {
+        const p = i * 4;
+        const r = data[p];
+        const g = data[p + 1];
+        const b = data[p + 2];
+        const a = data[p + 3];
+        // Uint8ClampedArray clamps stores to 0–255, so an explicit clamp is unnecessary.
+        data[p] = m0 * r + m1 * g + m2 * b + m3 * a + m4 * 255;
+        data[p + 1] = m5 * r + m6 * g + m7 * b + m8 * a + m9 * 255;
+        data[p + 2] = m10 * r + m11 * g + m12 * b + m13 * a + m14 * 255;
+        data[p + 3] = m15 * r + m16 * g + m17 * b + m18 * a + m19 * 255;
+    }
 }
 //# sourceMappingURL=canvasColorMatrixPass.js.map

package/dist/canvasColorMatrixPass.js.map

@@ -1 +1 @@
-{"version":3,"file":"canvasColorMatrixPass.js","sourceRoot":"","sources":["../src/canvasColorMatrixPass.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"canvasColorMatrixPass.js","sourceRoot":"","sources":["../src/canvasColorMatrixPass.ts"],"names":[],"mappings":"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"}

package/dist/canvasCompositeEffect.d.ts

@@ -0,0 +1,6 @@
+import type { CanvasRenderEffectRunner, CanvasRenderState, CanvasRenderTarget, CompositeEffect, CompositeOperator } from '@flighthq/types/contract';
+export declare function applyCompositeEffectToCanvas(state: CanvasRenderState, source: Readonly<CanvasRenderTarget>, dest: Readonly<CanvasRenderTarget>, effect: Readonly<CompositeEffect>): void;
+export declare const defaultCanvasCompositeEffectRunner: CanvasRenderEffectRunner;
+export declare function getCanvasCompositeEffectOperation(operator: CompositeOperator): GlobalCompositeOperation;
+export declare function registerCanvasCompositeEffect(state: CanvasRenderState): void;
+//# sourceMappingURL=canvasCompositeEffect.d.ts.map

package/dist/canvasCompositeEffect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"canvasCompositeEffect.d.ts","sourceRoot":"","sources":["../src/canvasCompositeEffect.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,wBAAwB,EACxB,iBAAiB,EACjB,kBAAkB,EAClB,eAAe,EACf,iBAAiB,EAClB,MAAM,0BAA0B,CAAC;AAsBlC,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,iBAAiB,EACxB,MAAM,EAAE,QAAQ,CAAC,kBAAkB,CAAC,EACpC,IAAI,EAAE,QAAQ,CAAC,kBAAkB,CAAC,EAClC,MAAM,EAAE,QAAQ,CAAC,eAAe,CAAC,GAChC,IAAI,CAqBN;AAED,eAAO,MAAM,kCAAkC,EAAE,wBAEhD,CAAC;AASF,wBAAgB,iCAAiC,CAAC,QAAQ,EAAE,iBAAiB,GAAG,wBAAwB,CAEvG;AAED,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,iBAAiB,GAAG,IAAI,CAE5E"}

package/dist/canvasCompositeEffect.js

@@ -0,0 +1,71 @@
+import { CompositeOperator as CompositeOperatorValues } from '@flighthq/types/contract';
+import { getCanvasBlendEffectBackdrop } from './canvasBlendEffect';
+import { registerCanvasRenderEffect } from './canvasRenderEffectRegistry';
+// Porter-Duff composite pass: lay down a registered backdrop, then draw the incoming layer over it under
+// the Canvas 2D operation named by the effect's `operator`. This is the Canvas realization of the
+// CompositeEffect — the coverage-combining sibling of the color-mixing BlendEffect.
+//
+// Canvas 2D owns this vocabulary outright: `globalCompositeOperation` IS the Porter-Duff set, and the
+// CompositeOperator names were taken from it, so ten of the eleven operators are a direct rename and the
+// GL pass's `Fa*layer + Fb*backdrop` factor maths has no counterpart here. `Clear` is the exception —
+// Canvas has no 'clear' operation — and it is realized by clearing the target and drawing neither input,
+// which is what both coverage factors being zero means.
+//
+// The backdrop registry is shared with BlendEffect, matching GL, where both effects read
+// getGlBlendEffectBackdrop. A null or unregistered key composites against an implicit TRANSPARENT
+// backdrop rather than erroring, and that is load-bearing rather than a fallback: it is what makes the
+// operator still meaningful with nothing registered. SourceOver reduces to a passthrough, while the
+// masking operators (SourceIn, DestinationIn, DestinationAtop) reduce to a clear, because compositing
+// against zero coverage is exactly what they are defined to do.
+export function applyCompositeEffectToCanvas(state, source, dest, effect) {
+    const ctx = dest.context;
+    ctx.save();
+    ctx.setTransform(1, 0, 0, 1, 0, 0);
+    ctx.globalAlpha = 1;
+    ctx.globalCompositeOperation = 'source-over';
+    ctx.filter = 'none';
+    ctx.clearRect(0, 0, dest.width, dest.height);
+    // Clear discards both inputs by definition, so it must not draw the backdrop either — the cleared
+    // target IS the result. Returning before the backdrop draw is the whole implementation.
+    if (effect.operator !== CompositeOperatorValues.Clear) {
+        const backdrop = getCanvasBlendEffectBackdrop(state, effect.backdropKey ?? null);
+        // The backdrop is the DESTINATION every operator is defined against, so it has to be in the target
+        // before the layer lands. Its absence is a transparent destination, not a skipped composite.
+        if (backdrop !== null)
+            ctx.drawImage(backdrop.canvas, 0, 0);
+        ctx.globalCompositeOperation = getCanvasCompositeEffectOperation(effect.operator);
+        ctx.drawImage(source.canvas, 0, 0);
+    }
+    ctx.restore();
+}
+export const defaultCanvasCompositeEffectRunner = (ctx, effect) => {
+    applyCompositeEffectToCanvas(ctx.state, ctx.source, ctx.dest, effect);
+};
+// Maps a CompositeOperator to the Canvas 2D globalCompositeOperation that realizes it. An unrecognized
+// operator — a vendor-prefixed one Canvas has never heard of — falls back to 'source-over', matching the
+// GL pass, which maps an unknown operator to the SourceOver branch.
+//
+// `Clear` is deliberately absent from the table: Canvas has no 'clear' operation, and the caller above
+// handles it by clearing rather than by drawing. Asking for it here returns the SourceOver fallback,
+// which is why that branch must never reach this function.
+export function getCanvasCompositeEffectOperation(operator) {
+    return COMPOSITE_OPERATOR_OPERATION[operator] ?? 'source-over';
+}
+export function registerCanvasCompositeEffect(state) {
+    registerCanvasRenderEffect(state, 'CompositeEffect', defaultCanvasCompositeEffectRunner);
+}
+// CompositeOperator → Canvas 2D globalCompositeOperation. Ten of the eleven operators are a direct
+// rename of the same Porter-Duff term; `Clear` has no Canvas operation and is handled by the caller.
+const COMPOSITE_OPERATOR_OPERATION = {
+    [CompositeOperatorValues.Copy]: 'copy',
+    [CompositeOperatorValues.DestinationAtop]: 'destination-atop',
+    [CompositeOperatorValues.DestinationIn]: 'destination-in',
+    [CompositeOperatorValues.DestinationOut]: 'destination-out',
+    [CompositeOperatorValues.DestinationOver]: 'destination-over',
+    [CompositeOperatorValues.SourceAtop]: 'source-atop',
+    [CompositeOperatorValues.SourceIn]: 'source-in',
+    [CompositeOperatorValues.SourceOut]: 'source-out',
+    [CompositeOperatorValues.SourceOver]: 'source-over',
+    [CompositeOperatorValues.Xor]: 'xor',
+};
+//# sourceMappingURL=canvasCompositeEffect.js.map

package/dist/canvasCompositeEffect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"canvasCompositeEffect.js","sourceRoot":"","sources":["../src/canvasCompositeEffect.ts"],"names":[],"mappings":"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"}

package/dist/canvasDropShadowEffect.d.ts

@@ -1,5 +1,6 @@
-import type { CanvasRenderEffectRunner, CanvasRenderTarget, CanvasRenderTargetPool, DropShadowEffect } from '@flighthq/types/contract';
+import type { CanvasRenderEffectRunner, CanvasRenderState, CanvasRenderTarget, CanvasRenderTargetPool, DropShadowEffect } from '@flighthq/types/contract';
 export declare function applyDropShadowEffectToCanvas(source: Readonly<CanvasRenderTarget>, dest: Readonly<CanvasRenderTarget>, effect: Readonly<DropShadowEffect>): void;
 export declare function applyDropShadowEffectToCanvas(source: Readonly<CanvasRenderTarget>, dest: Readonly<CanvasRenderTarget>, pool: CanvasRenderTargetPool, effect: Readonly<DropShadowEffect>): void;
 export declare const defaultCanvasDropShadowEffectRunner: CanvasRenderEffectRunner;
+export declare function registerCanvasDropShadowEffect(state: CanvasRenderState): void;
 //# sourceMappingURL=canvasDropShadowEffect.d.ts.map

package/dist/canvasDropShadowEffect.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"canvasDropShadowEffect.d.ts","sourceRoot":"","sources":["../src/canvasDropShadowEffect.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,wBAAwB,EACxB,kBAAkB,EAClB,sBAAsB,EACtB,gBAAgB,EACjB,MAAM,0BAA0B,CAAC;AAmBlC,wBAAgB,6BAA6B,CAC3C,MAAM,EAAE,QAAQ,CAAC,kBAAkB,CAAC,EACpC,IAAI,EAAE,QAAQ,CAAC,kBAAkB,CAAC,EAClC,MAAM,EAAE,QAAQ,CAAC,gBAAgB,CAAC,GACjC,IAAI,CAAC;AACR,wBAAgB,6BAA6B,CAC3C,MAAM,EAAE,QAAQ,CAAC,kBAAkB,CAAC,EACpC,IAAI,EAAE,QAAQ,CAAC,kBAAkB,CAAC,EAClC,IAAI,EAAE,sBAAsB,EAC5B,MAAM,EAAE,QAAQ,CAAC,gBAAgB,CAAC,GACjC,IAAI,CAAC;AAkBR,eAAO,MAAM,mCAAmC,EAAE,wBAEjD,CAAC"}
+{"version":3,"file":"canvasDropShadowEffect.d.ts","sourceRoot":"","sources":["../src/canvasDropShadowEffect.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,wBAAwB,EACxB,iBAAiB,EACjB,kBAAkB,EAClB,sBAAsB,EACtB,gBAAgB,EACjB,MAAM,0BAA0B,CAAC;AAoBlC,wBAAgB,6BAA6B,CAC3C,MAAM,EAAE,QAAQ,CAAC,kBAAkB,CAAC,EACpC,IAAI,EAAE,QAAQ,CAAC,kBAAkB,CAAC,EAClC,MAAM,EAAE,QAAQ,CAAC,gBAAgB,CAAC,GACjC,IAAI,CAAC;AACR,wBAAgB,6BAA6B,CAC3C,MAAM,EAAE,QAAQ,CAAC,kBAAkB,CAAC,EACpC,IAAI,EAAE,QAAQ,CAAC,kBAAkB,CAAC,EAClC,IAAI,EAAE,sBAAsB,EAC5B,MAAM,EAAE,QAAQ,CAAC,gBAAgB,CAAC,GACjC,IAAI,CAAC;AAkBR,eAAO,MAAM,mCAAmC,EAAE,wBAEjD,CAAC;AAEF,wBAAgB,8BAA8B,CAAC,KAAK,EAAE,iBAAiB,GAAG,IAAI,CAE7E"}

package/dist/canvasDropShadowEffect.js

@@ -1,6 +1,7 @@
 import { drawCanvasEffectPass } from './canvasEffectCompositing';
 import { computeDropShadowEffectCss } from './canvasEffectDropShadowCss';
 import { acquireCanvasRenderTarget, createCanvasRenderTargetPool, releaseCanvasRenderTarget, } from './canvasRenderEffectPipeline';
+import { registerCanvasRenderEffect } from './canvasRenderEffectRegistry';
 import { clearCanvasTarget, compositeCanvasImage, compositeCanvasSourceMode, drawCanvasTintedAlphaMask, } from './canvasSourceModeCompositing';
 export function applyDropShadowEffectToCanvas(source, dest, poolOrEffect, maybeEffect) {
     const effect = maybeEffect ?? poolOrEffect;
@@ -15,6 +16,9 @@ export function applyDropShadowEffectToCanvas(source, dest, poolOrEffect, maybeE
 export const defaultCanvasDropShadowEffectRunner = (ctx, effect) => {
     applyDropShadowEffectToCanvas(ctx.source, ctx.dest, ctx.pool, effect);
 };
+export function registerCanvasDropShadowEffect(state) {
+    registerCanvasRenderEffect(state, 'DropShadowEffect', defaultCanvasDropShadowEffectRunner);
+}
 function applyDropShadowEffectToCanvasWithPool(source, dest, pool, effect) {
     const mask = acquireCanvasRenderTarget(pool, source.width, source.height);
     const blurred = acquireCanvasRenderTarget(pool, source.width, source.height);

package/dist/canvasDropShadowEffect.js.map

@@ -1 +1 @@
-{"version":3,"file":"canvasDropShadowEffect.js","sourceRoot":"","sources":["../src/canvasDropShadowEffect.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"canvasDropShadowEffect.js","sourceRoot":"","sources":["../src/canvasDropShadowEffect.ts"],"names":[],"mappings":"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"}

package/dist/canvasFilmGrainEffect.d.ts

@@ -1,4 +1,5 @@
-import type { CanvasRenderEffectRunner, CanvasRenderTarget, CanvasRenderTargetPool, FilmGrainEffect } from '@flighthq/types/contract';
+import type { CanvasRenderEffectRunner, CanvasRenderState, CanvasRenderTarget, CanvasRenderTargetPool, FilmGrainEffect } from '@flighthq/types/contract';
 export declare function applyFilmGrainEffectToCanvas(source: Readonly<CanvasRenderTarget>, dest: Readonly<CanvasRenderTarget>, pool: CanvasRenderTargetPool, effect: Readonly<FilmGrainEffect>): void;
 export declare const defaultCanvasFilmGrainEffectRunner: CanvasRenderEffectRunner;
+export declare function registerCanvasFilmGrainEffect(state: CanvasRenderState): void;
 //# sourceMappingURL=canvasFilmGrainEffect.d.ts.map

package/dist/canvasFilmGrainEffect.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"canvasFilmGrainEffect.d.ts","sourceRoot":"","sources":["../src/canvasFilmGrainEffect.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,wBAAwB,EACxB,kBAAkB,EAClB,sBAAsB,EACtB,eAAe,EAChB,MAAM,0BAA0B,CAAC;AAQlC,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,QAAQ,CAAC,kBAAkB,CAAC,EACpC,IAAI,EAAE,QAAQ,CAAC,kBAAkB,CAAC,EAClC,IAAI,EAAE,sBAAsB,EAC5B,MAAM,EAAE,QAAQ,CAAC,eAAe,CAAC,GAChC,IAAI,CA4CN;AAED,eAAO,MAAM,kCAAkC,EAAE,wBAEhD,CAAC"}
+{"version":3,"file":"canvasFilmGrainEffect.d.ts","sourceRoot":"","sources":["../src/canvasFilmGrainEffect.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,wBAAwB,EACxB,iBAAiB,EACjB,kBAAkB,EAClB,sBAAsB,EACtB,eAAe,EAChB,MAAM,0BAA0B,CAAC;AASlC,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,QAAQ,CAAC,kBAAkB,CAAC,EACpC,IAAI,EAAE,QAAQ,CAAC,kBAAkB,CAAC,EAClC,IAAI,EAAE,sBAAsB,EAC5B,MAAM,EAAE,QAAQ,CAAC,eAAe,CAAC,GAChC,IAAI,CA4CN;AAED,eAAO,MAAM,kCAAkC,EAAE,wBAEhD,CAAC;AAEF,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,iBAAiB,GAAG,IAAI,CAE5E"}

package/dist/canvasFilmGrainEffect.js

@@ -1,5 +1,6 @@
 import { drawCanvasEffectPass } from './canvasEffectCompositing';
 import { acquireCanvasRenderTarget, releaseCanvasRenderTarget } from './canvasRenderEffectPipeline';
+import { registerCanvasRenderEffect } from './canvasRenderEffectRegistry';
 // Film grain (REAL): draw the scene, then overlay a tiled noise pattern at `intensity` via the
 // 'overlay' composite op. The noise is generated once into a small scratch canvas (cell size from
 // `size`, jittered by `seed`) and tiled across the frame as a repeating fill pattern.
@@ -47,4 +48,7 @@ export function applyFilmGrainEffectToCanvas(source, dest, pool, effect) {
 export const defaultCanvasFilmGrainEffectRunner = (ctx, effect) => {
     applyFilmGrainEffectToCanvas(ctx.source, ctx.dest, ctx.pool, effect);
 };
+export function registerCanvasFilmGrainEffect(state) {
+    registerCanvasRenderEffect(state, 'FilmGrainEffect', defaultCanvasFilmGrainEffectRunner);
+}
 //# sourceMappingURL=canvasFilmGrainEffect.js.map

package/dist/canvasFilmGrainEffect.js.map

@@ -1 +1 @@
-{"version":3,"file":"canvasFilmGrainEffect.js","sourceRoot":"","sources":["../src/canvasFilmGrainEffect.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"canvasFilmGrainEffect.js","sourceRoot":"","sources":["../src/canvasFilmGrainEffect.ts"],"names":[],"mappings":"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"}

package/dist/canvasGradientBevelEffect.d.ts

@@ -0,0 +1,6 @@
+import type { CanvasRenderEffectRunner, CanvasRenderState, CanvasRenderTarget, CanvasRenderTargetPool, GradientBevelEffect } from '@flighthq/types/contract';
+export declare function applyGradientBevelEffectToCanvas(source: Readonly<CanvasRenderTarget>, dest: Readonly<CanvasRenderTarget>, effect: Readonly<GradientBevelEffect>): void;
+export declare function applyGradientBevelEffectToCanvas(source: Readonly<CanvasRenderTarget>, dest: Readonly<CanvasRenderTarget>, pool: CanvasRenderTargetPool, effect: Readonly<GradientBevelEffect>): void;
+export declare const defaultCanvasGradientBevelEffectRunner: CanvasRenderEffectRunner;
+export declare function registerCanvasGradientBevelEffect(state: CanvasRenderState): void;
+//# sourceMappingURL=canvasGradientBevelEffect.d.ts.map

package/dist/canvasGradientBevelEffect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"canvasGradientBevelEffect.d.ts","sourceRoot":"","sources":["../src/canvasGradientBevelEffect.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,wBAAwB,EACxB,iBAAiB,EACjB,kBAAkB,EAClB,sBAAsB,EACtB,mBAAmB,EACpB,MAAM,0BAA0B,CAAC;AAwBlC,wBAAgB,gCAAgC,CAC9C,MAAM,EAAE,QAAQ,CAAC,kBAAkB,CAAC,EACpC,IAAI,EAAE,QAAQ,CAAC,kBAAkB,CAAC,EAClC,MAAM,EAAE,QAAQ,CAAC,mBAAmB,CAAC,GACpC,IAAI,CAAC;AACR,wBAAgB,gCAAgC,CAC9C,MAAM,EAAE,QAAQ,CAAC,kBAAkB,CAAC,EACpC,IAAI,EAAE,QAAQ,CAAC,kBAAkB,CAAC,EAClC,IAAI,EAAE,sBAAsB,EAC5B,MAAM,EAAE,QAAQ,CAAC,mBAAmB,CAAC,GACpC,IAAI,CAAC;AAYR,eAAO,MAAM,sCAAsC,EAAE,wBAEpD,CAAC;AAEF,wBAAgB,iCAAiC,CAAC,KAAK,EAAE,iBAAiB,GAAG,IAAI,CAEhF"}