@flyingrobots/bijou-tui 7.1.0 → 8.0.0-rc.1

package/dist/pipeline/middleware/surface-shaders.d.ts

@@ -1,37 +1,4 @@
-import { type Surface } from '@flyingrobots/bijou';
-import type { RenderMiddleware } from '../pipeline.js';
-export interface SurfaceShaderContext {
-    readonly frame: number;
-    readonly dt: number;
-    readonly width: number;
-    readonly height: number;
-}
-export type SurfaceShader = (surface: Surface, context: SurfaceShaderContext) => void;
-export interface ScanlinesShaderOptions {
-    /** Brightness multiplier applied to dimmed rows. */
-    readonly dimFactor?: number;
-    /** Whether the first row stays bright and the second row dims. */
-    readonly startBright?: boolean;
-}
-export interface FlickerShaderOptions {
-    /** Minimum frame-wide brightness multiplier. */
-    readonly minFactor?: number;
-    /** Maximum frame-wide brightness multiplier. */
-    readonly maxFactor?: number;
-}
-export interface NoiseShaderOptions {
-    /** Maximum per-cell brightness variance around 1.0. */
-    readonly intensity?: number;
-}
-export interface VignetteShaderOptions {
-    /** Brightness multiplier applied at the outermost edge. */
-    readonly edgeFactor?: number;
-    /** Curve shaping factor for the edge falloff. */
-    readonly exponent?: number;
-}
-export declare function surfaceShaderFilter(...shaders: readonly SurfaceShader[]): RenderMiddleware;
-export declare function scanlines(options?: ScanlinesShaderOptions): SurfaceShader;
-export declare function flicker(options?: FlickerShaderOptions): SurfaceShader;
-export declare function noise(options?: NoiseShaderOptions): SurfaceShader;
-export declare function vignette(options?: VignetteShaderOptions): SurfaceShader;
+export type { SurfaceShaderContext, SurfaceShader, ScanlinesShaderOptions, FlickerShaderOptions, NoiseShaderOptions, VignetteShaderOptions, } from './surface-shaders.part01.js';
+export { surfaceShaderFilter, scanlines, flicker, noise, } from './surface-shaders.part01.js';
+export { vignette } from './surface-shaders.part02.js';
 //# sourceMappingURL=surface-shaders.d.ts.map

package/dist/pipeline/middleware/surface-shaders.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"surface-shaders.d.ts","sourceRoot":"","sources":["../../../src/pipeline/middleware/surface-shaders.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuC,KAAK,OAAO,EAAE,MAAM,qBAAqB,CAAC;AASxF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAEvD,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,MAAM,aAAa,GAAG,CAC1B,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,oBAAoB,KAC1B,IAAI,CAAC;AAEV,MAAM,WAAW,sBAAsB;IACrC,oDAAoD;IACpD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,kEAAkE;IAClE,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;CAChC;AAED,MAAM,WAAW,oBAAoB;IACnC,gDAAgD;IAChD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,gDAAgD;IAChD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,kBAAkB;IACjC,uDAAuD;IACvD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,qBAAqB;IACpC,2DAA2D;IAC3D,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,iDAAiD;IACjD,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,wBAAgB,mBAAmB,CACjC,GAAG,OAAO,EAAE,SAAS,aAAa,EAAE,GACnC,gBAAgB,CAsBlB;AAED,wBAAgB,SAAS,CACvB,OAAO,GAAE,sBAA2B,GACnC,aAAa,CAUf;AAED,wBAAgB,OAAO,CACrB,OAAO,GAAE,oBAAyB,GACjC,aAAa,CASf;AAED,wBAAgB,KAAK,CACnB,OAAO,GAAE,kBAAuB,GAC/B,aAAa,CASf;AAED,wBAAgB,QAAQ,CACtB,OAAO,GAAE,qBAA0B,GAClC,aAAa,CAef"}
+{"version":3,"file":"surface-shaders.d.ts","sourceRoot":"","sources":["../../../src/pipeline/middleware/surface-shaders.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,oBAAoB,EACpB,aAAa,EACb,sBAAsB,EACtB,oBAAoB,EACpB,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,mBAAmB,EACnB,SAAS,EACT,OAAO,EACP,KAAK,GACN,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC"}

package/dist/pipeline/middleware/surface-shaders.js

@@ -1,164 +1,3 @@
-import { isPackedSurface } from '@flyingrobots/bijou';
-import { CELL_STRIDE, FLAG_BG_SET, FLAG_FG_SET, OFF_ALPHA, OFF_BG_R, OFF_FG_R, } from '@flyingrobots/bijou/perf';
-export function surfaceShaderFilter(...shaders) {
-    let frame = 0;
-    return (state, next) => {
-        if (shaders.length === 0) {
-            next();
-            return;
-        }
-        frame += 1;
-        const context = {
-            frame,
-            dt: state.dt,
-            width: state.targetSurface.width,
-            height: state.targetSurface.height,
-        };
-        for (const shader of shaders) {
-            shader(state.targetSurface, context);
-        }
-        next();
-    };
-}
-export function scanlines(options = {}) {
-    const dimFactor = clampFactor(options.dimFactor ?? 0.78);
-    const startBright = options.startBright ?? true;
-    return (surface, context) => {
-        shadeSurface(surface, context, (_x, y) => {
-            const dimmedRow = startBright ? (y % 2 === 1) : (y % 2 === 0);
-            return dimmedRow ? dimFactor : 1;
-        });
-    };
-}
-export function flicker(options = {}) {
-    const minFactor = clampFactor(options.minFactor ?? 0.94);
-    const maxFactor = clampFactor(options.maxFactor ?? 1.04);
-    return (surface, context) => {
-        const t = normalizedNoise(0, 0, context.frame);
-        const factor = lerp(minFactor, maxFactor, t);
-        shadeSurface(surface, context, () => factor);
-    };
-}
-export function noise(options = {}) {
-    const intensity = Math.max(0, Math.min(options.intensity ?? 0.12, 1));
-    return (surface, context) => {
-        shadeSurface(surface, context, (x, y) => {
-            const centered = (normalizedNoise(x, y, context.frame) - 0.5) * 2;
-            return clampFactor(1 + centered * intensity);
-        });
-    };
-}
-export function vignette(options = {}) {
-    const edgeFactor = clampFactor(options.edgeFactor ?? 0.72);
-    const exponent = Math.max(0.1, options.exponent ?? 1.6);
-    return (surface, context) => {
-        const cx = (context.width - 1) / 2;
-        const cy = (context.height - 1) / 2;
-        const maxDistance = Math.max(1, Math.hypot(cx, cy));
-        shadeSurface(surface, context, (x, y) => {
-            const distance = Math.hypot(x - cx, y - cy) / maxDistance;
-            const edgeBias = Math.pow(Math.min(1, distance), exponent);
-            return lerp(1, edgeFactor, edgeBias);
-        });
-    };
-}
-function shadeSurface(surface, context, factorForCell) {
-    if (surface.width === 0 || surface.height === 0)
-        return;
-    if (isPackedSurface(surface)) {
-        shadePackedSurface(surface, context, factorForCell);
-        return;
-    }
-    shadeCellSurface(surface, context, factorForCell);
-}
-function shadePackedSurface(surface, context, factorForCell) {
-    const buf = surface.buffer;
-    const width = surface.width;
-    const height = surface.height;
-    for (let y = 0; y < height; y++) {
-        for (let x = 0; x < width; x++) {
-            const factor = factorForCell(x, y, context);
-            if (factor === 1)
-                continue;
-            const index = y * width + x;
-            const off = index * CELL_STRIDE;
-            const alpha = buf[off + OFF_ALPHA];
-            const cell = surface.cells[index];
-            if (alpha & FLAG_FG_SET) {
-                const nextFg = shadePackedRgb(buf, off + OFF_FG_R, factor);
-                cell.fg = rgbToHex(nextFg[0], nextFg[1], nextFg[2]);
-            }
-            if (alpha & FLAG_BG_SET) {
-                const nextBg = shadePackedRgb(buf, off + OFF_BG_R, factor);
-                cell.bg = rgbToHex(nextBg[0], nextBg[1], nextBg[2]);
-            }
-        }
-    }
-    surface.markAllDirty();
-}
-function shadePackedRgb(buf, start, factor) {
-    const r = shadeChannel(buf[start], factor);
-    const g = shadeChannel(buf[start + 1], factor);
-    const b = shadeChannel(buf[start + 2], factor);
-    buf[start] = r;
-    buf[start + 1] = g;
-    buf[start + 2] = b;
-    return [r, g, b];
-}
-function shadeCellSurface(surface, context, factorForCell) {
-    for (let y = 0; y < surface.height; y++) {
-        for (let x = 0; x < surface.width; x++) {
-            const factor = factorForCell(x, y, context);
-            if (factor === 1)
-                continue;
-            const cell = surface.get(x, y);
-            const fgHex = typeof cell.fg === 'string' ? cell.fg : cell.fg?.hex;
-            const bgHex = typeof cell.bg === 'string' ? cell.bg : cell.bg?.hex;
-            const nextFg = fgHex ? shadeHex(fgHex, factor) : undefined;
-            const nextBg = bgHex ? shadeHex(bgHex, factor) : undefined;
-            if (nextFg !== cell.fg || nextBg !== cell.bg) {
-                surface.set(x, y, { ...cell, fg: nextFg, bg: nextBg });
-            }
-        }
-    }
-}
-function shadeHex(hex, factor) {
-    if (hex.length !== 7 || hex[0] !== '#')
-        return hex;
-    const digits = hex.slice(1);
-    if (!/^[0-9A-Fa-f]{6}$/.test(digits))
-        return hex;
-    const r = parseInt(digits.slice(0, 2), 16);
-    const g = parseInt(digits.slice(2, 4), 16);
-    const b = parseInt(digits.slice(4, 6), 16);
-    if (isNaN(r) || isNaN(g) || isNaN(b))
-        return hex;
-    return rgbToHex(shadeChannel(r, factor), shadeChannel(g, factor), shadeChannel(b, factor));
-}
-function shadeChannel(value, factor) {
-    return Math.max(0, Math.min(255, Math.round(value * factor)));
-}
-function rgbToHex(r, g, b) {
-    return `#${toHex(r)}${toHex(g)}${toHex(b)}`;
-}
-function toHex(value) {
-    return value.toString(16).padStart(2, '0');
-}
-function clampFactor(value) {
-    if (!Number.isFinite(value))
-        return 1;
-    return Math.max(0, Math.min(value, 2));
-}
-function lerp(start, end, t) {
-    return start + (end - start) * t;
-}
-function normalizedNoise(x, y, frame) {
-    let value = Math.imul(x + 1, 374761393);
-    value = (value + Math.imul(y + 1, 668265263)) >>> 0;
-    value = (value + Math.imul(frame + 1, 982451653)) >>> 0;
-    value ^= value >>> 13;
-    value = Math.imul(value, 1274126177) >>> 0;
-    value ^= value >>> 16;
-    return value / 0xffffffff;
-}
+export { surfaceShaderFilter, scanlines, flicker, noise, } from './surface-shaders.part01.js';
+export { vignette } from './surface-shaders.part02.js';
 //# sourceMappingURL=surface-shaders.js.map

package/dist/pipeline/middleware/surface-shaders.js.map

@@ -1 +1 @@
-{"version":3,"file":"surface-shaders.js","sourceRoot":"","sources":["../../../src/pipeline/middleware/surface-shaders.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAoC,MAAM,qBAAqB,CAAC;AACxF,OAAO,EACL,WAAW,EACX,WAAW,EACX,WAAW,EACX,SAAS,EACT,QAAQ,EACR,QAAQ,GACT,MAAM,0BAA0B,CAAC;AAyClC,MAAM,UAAU,mBAAmB,CACjC,GAAG,OAAiC;IAEpC,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,OAAO,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;QACrB,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,IAAI,EAAE,CAAC;YACP,OAAO;QACT,CAAC;QAED,KAAK,IAAI,CAAC,CAAC;QACX,MAAM,OAAO,GAAyB;YACpC,KAAK;YACL,EAAE,EAAE,KAAK,CAAC,EAAE;YACZ,KAAK,EAAE,KAAK,CAAC,aAAa,CAAC,KAAK;YAChC,MAAM,EAAE,KAAK,CAAC,aAAa,CAAC,MAAM;SACnC,CAAC;QAEF,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,MAAM,CAAC,KAAK,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;QACvC,CAAC;QAED,IAAI,EAAE,CAAC;IACT,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,SAAS,CACvB,UAAkC,EAAE;IAEpC,MAAM,SAAS,GAAG,WAAW,CAAC,OAAO,CAAC,SAAS,IAAI,IAAI,CAAC,CAAC;IACzD,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,IAAI,CAAC;IAEhD,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE;QAC1B,YAAY,CAAC,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE;YACvC,MAAM,SAAS,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;YAC9D,OAAO,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;QACnC,CAAC,CAAC,CAAC;IACL,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,OAAO,CACrB,UAAgC,EAAE;IAElC,MAAM,SAAS,GAAG,WAAW,CAAC,OAAO,CAAC,SAAS,IAAI,IAAI,CAAC,CAAC;IACzD,MAAM,SAAS,GAAG,WAAW,CAAC,OAAO,CAAC,SAAS,IAAI,IAAI,CAAC,CAAC;IAEzD,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE;QAC1B,MAAM,CAAC,GAAG,eAAe,CAAC,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;QAC/C,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC;QAC7C,YAAY,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,CAAC;IAC/C,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,KAAK,CACnB,UAA8B,EAAE;IAEhC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,SAAS,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IAEtE,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE;QAC1B,YAAY,CAAC,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;YACtC,MAAM,QAAQ,GAAG,CAAC,eAAe,CAAC,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;YAClE,OAAO,WAAW,CAAC,CAAC,GAAG,QAAQ,GAAG,SAAS,CAAC,CAAC;QAC/C,CAAC,CAAC,CAAC;IACL,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,QAAQ,CACtB,UAAiC,EAAE;IAEnC,MAAM,UAAU,GAAG,WAAW,CAAC,OAAO,CAAC,UAAU,IAAI,IAAI,CAAC,CAAC;IAC3D,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,QAAQ,IAAI,GAAG,CAAC,CAAC;IAExD,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE;QAC1B,MAAM,EAAE,GAAG,CAAC,OAAO,CAAC,KAAK,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;QACnC,MAAM,EAAE,GAAG,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;QACpC,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;QAEpD,YAAY,CAAC,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;YACtC,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,WAAW,CAAC;YAC1D,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,CAAC,EAAE,QAAQ,CAAC,CAAC;YAC3D,OAAO,IAAI,CAAC,CAAC,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC;QACvC,CAAC,CAAC,CAAC;IACL,CAAC,CAAC;AACJ,CAAC;AAQD,SAAS,YAAY,CACnB,OAAgB,EAChB,OAA6B,EAC7B,aAAiC;IAEjC,IAAI,OAAO,CAAC,KAAK,KAAK,CAAC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO;IAExD,IAAI,eAAe,CAAC,OAAO,CAAC,EAAE,CAAC;QAC7B,kBAAkB,CAAC,OAAO,EAAE,OAAO,EAAE,aAAa,CAAC,CAAC;QACpD,OAAO;IACT,CAAC;IAED,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,aAAa,CAAC,CAAC;AACpD,CAAC;AAED,SAAS,kBAAkB,CACzB,OAAsB,EACtB,OAA6B,EAC7B,aAAiC;IAEjC,MAAM,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC;IAC3B,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;IAC5B,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAE9B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAChC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC;YAC/B,MAAM,MAAM,GAAG,aAAa,CAAC,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC;YAC5C,IAAI,MAAM,KAAK,CAAC;gBAAE,SAAS;YAE3B,MAAM,KAAK,GAAG,CAAC,GAAG,KAAK,GAAG,CAAC,CAAC;YAC5B,MAAM,GAAG,GAAG,KAAK,GAAG,WAAW,CAAC;YAChC,MAAM,KAAK,GAAG,GAAG,CAAC,GAAG,GAAG,SAAS,CAAE,CAAC;YACpC,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,KAAK,CAAE,CAAC;YAEnC,IAAI,KAAK,GAAG,WAAW,EAAE,CAAC;gBACxB,MAAM,MAAM,GAAG,cAAc,CAAC,GAAG,EAAE,GAAG,GAAG,QAAQ,EAAE,MAAM,CAAC,CAAC;gBAC3D,IAAI,CAAC,EAAE,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;YACtD,CAAC;YAED,IAAI,KAAK,GAAG,WAAW,EAAE,CAAC;gBACxB,MAAM,MAAM,GAAG,cAAc,CAAC,GAAG,EAAE,GAAG,GAAG,QAAQ,EAAE,MAAM,CAAC,CAAC;gBAC3D,IAAI,CAAC,EAAE,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;YACtD,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,CAAC,YAAY,EAAE,CAAC;AACzB,CAAC;AAED,SAAS,cAAc,CACrB,GAAe,EACf,KAAa,EACb,MAAc;IAEd,MAAM,CAAC,GAAG,YAAY,CAAC,GAAG,CAAC,KAAK,CAAE,EAAE,MAAM,CAAC,CAAC;IAC5C,MAAM,CAAC,GAAG,YAAY,CAAC,GAAG,CAAC,KAAK,GAAG,CAAC,CAAE,EAAE,MAAM,CAAC,CAAC;IAChD,MAAM,CAAC,GAAG,YAAY,CAAC,GAAG,CAAC,KAAK,GAAG,CAAC,CAAE,EAAE,MAAM,CAAC,CAAC;IAChD,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACf,GAAG,CAAC,KAAK,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;IACnB,GAAG,CAAC,KAAK,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;IACnB,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAU,CAAC;AAC5B,CAAC;AAED,SAAS,gBAAgB,CACvB,OAAgB,EAChB,OAA6B,EAC7B,aAAiC;IAEjC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACxC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC;YACvC,MAAM,MAAM,GAAG,aAAa,CAAC,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC;YAC5C,IAAI,MAAM,KAAK,CAAC;gBAAE,SAAS;YAE3B,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YAC/B,MAAM,KAAK,GAAG,OAAO,IAAI,CAAC,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,GAAG,CAAC;YACnE,MAAM,KAAK,GAAG,OAAO,IAAI,CAAC,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,GAAG,CAAC;YACnE,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;YAC3D,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;YAE3D,IAAI,MAAM,KAAK,IAAI,CAAC,EAAE,IAAI,MAAM,KAAK,IAAI,CAAC,EAAE,EAAE,CAAC;gBAC7C,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,GAAG,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;YACzD,CAAC;QACH,CAAC;IACH,CAAC;AACH,CAAC;AAED,SAAS,QAAQ,CAAC,GAAW,EAAE,MAAc;IAC3C,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,KAAK,GAAG;QAAE,OAAO,GAAG,CAAC;IAEnD,MAAM,MAAM,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC5B,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,MAAM,CAAC;QAAE,OAAO,GAAG,CAAC;IAEjD,MAAM,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAC3C,MAAM,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAC3C,MAAM,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAC3C,IAAI,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC;QAAE,OAAO,GAAG,CAAC;IAEjD,OAAO,QAAQ,CACb,YAAY,CAAC,CAAC,EAAE,MAAM,CAAC,EACvB,YAAY,CAAC,CAAC,EAAE,MAAM,CAAC,EACvB,YAAY,CAAC,CAAC,EAAE,MAAM,CAAC,CACxB,CAAC;AACJ,CAAC;AAED,SAAS,YAAY,CAAC,KAAa,EAAE,MAAc;IACjD,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;AAChE,CAAC;AAED,SAAS,QAAQ,CAAC,CAAS,EAAE,CAAS,EAAE,CAAS;IAC/C,OAAO,IAAI,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;AAC9C,CAAC;AAED,SAAS,KAAK,CAAC,KAAa;IAC1B,OAAO,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;AAC7C,CAAC;AAED,SAAS,WAAW,CAAC,KAAa;IAChC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IACtC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;AACzC,CAAC;AAED,SAAS,IAAI,CAAC,KAAa,EAAE,GAAW,EAAE,CAAS;IACjD,OAAO,KAAK,GAAG,CAAC,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;AACnC,CAAC;AAED,SAAS,eAAe,CAAC,CAAS,EAAE,CAAS,EAAE,KAAa;IAC1D,IAAI,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,EAAE,SAAS,CAAC,CAAC;IACxC,KAAK,GAAG,CAAC,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,EAAE,SAAS,CAAC,CAAC,KAAK,CAAC,CAAC;IACpD,KAAK,GAAG,CAAC,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,EAAE,SAAS,CAAC,CAAC,KAAK,CAAC,CAAC;IACxD,KAAK,IAAI,KAAK,KAAK,EAAE,CAAC;IACtB,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,UAAU,CAAC,KAAK,CAAC,CAAC;IAC3C,KAAK,IAAI,KAAK,KAAK,EAAE,CAAC;IACtB,OAAO,KAAK,GAAG,UAAU,CAAC;AAC5B,CAAC"}
+{"version":3,"file":"surface-shaders.js","sourceRoot":"","sources":["../../../src/pipeline/middleware/surface-shaders.ts"],"names":[],"mappings":"AAQA,OAAO,EACL,mBAAmB,EACnB,SAAS,EACT,OAAO,EACP,KAAK,GACN,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC"}

package/dist/pipeline/middleware/surface-shaders.part01.d.ts

@@ -0,0 +1,36 @@
+import { type Surface } from '@flyingrobots/bijou';
+import type { RenderMiddleware } from '../pipeline.js';
+export interface SurfaceShaderContext {
+    readonly frame: number;
+    readonly dt: number;
+    readonly width: number;
+    readonly height: number;
+}
+export type SurfaceShader = (surface: Surface, context: SurfaceShaderContext) => void;
+export interface ScanlinesShaderOptions {
+    /** Brightness multiplier applied to dimmed rows. */
+    readonly dimFactor?: number;
+    /** Whether the first row stays bright and the second row dims. */
+    readonly startBright?: boolean;
+}
+export interface FlickerShaderOptions {
+    /** Minimum frame-wide brightness multiplier. */
+    readonly minFactor?: number;
+    /** Maximum frame-wide brightness multiplier. */
+    readonly maxFactor?: number;
+}
+export interface NoiseShaderOptions {
+    /** Maximum per-cell brightness variance around 1.0. */
+    readonly intensity?: number;
+}
+export interface VignetteShaderOptions {
+    /** Brightness multiplier applied at the outermost edge. */
+    readonly edgeFactor?: number;
+    /** Curve shaping factor for the edge falloff. */
+    readonly exponent?: number;
+}
+export declare function surfaceShaderFilter(...shaders: readonly SurfaceShader[]): RenderMiddleware;
+export declare function scanlines(options?: ScanlinesShaderOptions): SurfaceShader;
+export declare function flicker(options?: FlickerShaderOptions): SurfaceShader;
+export declare function noise(options?: NoiseShaderOptions): SurfaceShader;
+//# sourceMappingURL=surface-shaders.part01.d.ts.map

package/dist/pipeline/middleware/surface-shaders.part01.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"surface-shaders.part01.d.ts","sourceRoot":"","sources":["../../../src/pipeline/middleware/surface-shaders.part01.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAQvD,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AACD,MAAM,MAAM,aAAa,GAAG,CAC1B,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,oBAAoB,KAC1B,IAAI,CAAC;AACV,MAAM,WAAW,sBAAsB;IACrC,oDAAoD;IACpD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,kEAAkE;IAClE,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;CAChC;AACD,MAAM,WAAW,oBAAoB;IACnC,gDAAgD;IAChD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,gDAAgD;IAChD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AACD,MAAM,WAAW,kBAAkB;IACjC,uDAAuD;IACvD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AACD,MAAM,WAAW,qBAAqB;IACpC,2DAA2D;IAC3D,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,iDAAiD;IACjD,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AACD,wBAAgB,mBAAmB,CACjC,GAAG,OAAO,EAAE,SAAS,aAAa,EAAE,GACnC,gBAAgB,CAsBlB;AACD,wBAAgB,SAAS,CAAC,OAAO,GAAE,sBAA2B,GAAG,aAAa,CAU7E;AACD,wBAAgB,OAAO,CAAC,OAAO,GAAE,oBAAyB,GAAG,aAAa,CASzE;AACD,wBAAgB,KAAK,CAAC,OAAO,GAAE,kBAAuB,GAAG,aAAa,CASrE"}

package/dist/pipeline/middleware/surface-shaders.part01.js

@@ -0,0 +1,51 @@
+import { shadeSurface } from './surface-shaders.part02.js';
+import { clampFactor, lerp, normalizedNoise, } from './surface-shaders.part03.js';
+export function surfaceShaderFilter(...shaders) {
+    let frame = 0;
+    return (state, next) => {
+        if (shaders.length === 0) {
+            next();
+            return;
+        }
+        frame += 1;
+        const context = {
+            frame,
+            dt: state.dt,
+            width: state.targetSurface.width,
+            height: state.targetSurface.height,
+        };
+        for (const shader of shaders) {
+            shader(state.targetSurface, context);
+        }
+        next();
+    };
+}
+export function scanlines(options = {}) {
+    const dimFactor = clampFactor(options.dimFactor ?? 0.78);
+    const startBright = options.startBright ?? true;
+    return (surface, context) => {
+        shadeSurface(surface, context, (_x, y) => {
+            const dimmedRow = startBright ? y % 2 === 1 : y % 2 === 0;
+            return dimmedRow ? dimFactor : 1;
+        });
+    };
+}
+export function flicker(options = {}) {
+    const minFactor = clampFactor(options.minFactor ?? 0.94);
+    const maxFactor = clampFactor(options.maxFactor ?? 1.04);
+    return (surface, context) => {
+        const t = normalizedNoise(0, 0, context.frame);
+        const factor = lerp(minFactor, maxFactor, t);
+        shadeSurface(surface, context, () => factor);
+    };
+}
+export function noise(options = {}) {
+    const intensity = Math.max(0, Math.min(options.intensity ?? 0.12, 1));
+    return (surface, context) => {
+        shadeSurface(surface, context, (x, y) => {
+            const centered = (normalizedNoise(x, y, context.frame) - 0.5) * 2;
+            return clampFactor(1 + centered * intensity);
+        });
+    };
+}
+//# sourceMappingURL=surface-shaders.part01.js.map

package/dist/pipeline/middleware/surface-shaders.part01.js.map

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

package/dist/pipeline/middleware/surface-shaders.part02.d.ts

@@ -0,0 +1,8 @@
+import { type PackedSurface, type Surface } from '@flyingrobots/bijou';
+import { type SurfaceShader, type SurfaceShaderContext, type VignetteShaderOptions } from './surface-shaders.part01.js';
+export declare function vignette(options?: VignetteShaderOptions): SurfaceShader;
+export type BrightnessFactorFn = (x: number, y: number, context: SurfaceShaderContext) => number;
+export declare function shadeSurface(surface: Surface, context: SurfaceShaderContext, factorForCell: BrightnessFactorFn): void;
+export declare function shadePackedSurface(surface: PackedSurface, context: SurfaceShaderContext, factorForCell: BrightnessFactorFn): void;
+export declare function shadePackedRgb(buf: Uint8Array, start: number, factor: number): readonly [number, number, number];
+//# sourceMappingURL=surface-shaders.part02.d.ts.map

package/dist/pipeline/middleware/surface-shaders.part02.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"surface-shaders.part02.d.ts","sourceRoot":"","sources":["../../../src/pipeline/middleware/surface-shaders.part02.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,aAAa,EAClB,KAAK,OAAO,EACb,MAAM,qBAAqB,CAAC;AAS7B,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAC3B,MAAM,6BAA6B,CAAC;AASrC,wBAAgB,QAAQ,CAAC,OAAO,GAAE,qBAA0B,GAAG,aAAa,CAe3E;AACD,MAAM,MAAM,kBAAkB,GAAG,CAC/B,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,OAAO,EAAE,oBAAoB,KAC1B,MAAM,CAAC;AACZ,wBAAgB,YAAY,CAC1B,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,oBAAoB,EAC7B,aAAa,EAAE,kBAAkB,GAChC,IAAI,CASN;AACD,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,aAAa,EACtB,OAAO,EAAE,oBAAoB,EAC7B,aAAa,EAAE,kBAAkB,GAChC,IAAI,CA6BN;AACD,wBAAgB,cAAc,CAC5B,GAAG,EAAE,UAAU,EACf,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,GACb,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAQnC"}

package/dist/pipeline/middleware/surface-shaders.part02.js

@@ -0,0 +1,63 @@
+import { isPackedSurface, } from '@flyingrobots/bijou';
+import { CELL_STRIDE, FLAG_BG_SET, FLAG_FG_SET, OFF_ALPHA, OFF_BG_R, OFF_FG_R, } from '@flyingrobots/bijou/perf';
+import { clampFactor, lerp, rgbToHex, shadeCellSurface, shadeChannel, } from './surface-shaders.part03.js';
+export function vignette(options = {}) {
+    const edgeFactor = clampFactor(options.edgeFactor ?? 0.72);
+    const exponent = Math.max(0.1, options.exponent ?? 1.6);
+    return (surface, context) => {
+        const cx = (context.width - 1) / 2;
+        const cy = (context.height - 1) / 2;
+        const maxDistance = Math.max(1, Math.hypot(cx, cy));
+        shadeSurface(surface, context, (x, y) => {
+            const distance = Math.hypot(x - cx, y - cy) / maxDistance;
+            const edgeBias = Math.pow(Math.min(1, distance), exponent);
+            return lerp(1, edgeFactor, edgeBias);
+        });
+    };
+}
+export function shadeSurface(surface, context, factorForCell) {
+    if (surface.width === 0 || surface.height === 0)
+        return;
+    if (isPackedSurface(surface)) {
+        shadePackedSurface(surface, context, factorForCell);
+        return;
+    }
+    shadeCellSurface(surface, context, factorForCell);
+}
+export function shadePackedSurface(surface, context, factorForCell) {
+    const buf = surface.buffer;
+    const width = surface.width;
+    const height = surface.height;
+    for (let y = 0; y < height; y++) {
+        for (let x = 0; x < width; x++) {
+            const factor = factorForCell(x, y, context);
+            if (factor === 1)
+                continue;
+            const index = y * width + x;
+            const off = index * CELL_STRIDE;
+            const a = buf[off + OFF_ALPHA];
+            const cell = surface.cells[index];
+            if (a == null || !cell)
+                continue;
+            if (a & FLAG_FG_SET) {
+                const [r, g, b] = shadePackedRgb(buf, off + OFF_FG_R, factor);
+                cell.fg = rgbToHex(r, g, b);
+            }
+            if (a & FLAG_BG_SET) {
+                const [r, g, b] = shadePackedRgb(buf, off + OFF_BG_R, factor);
+                cell.bg = rgbToHex(r, g, b);
+            }
+        }
+    }
+    surface.markAllDirty();
+}
+export function shadePackedRgb(buf, start, factor) {
+    const r = shadeChannel(buf[start] ?? 0, factor);
+    const g = shadeChannel(buf[start + 1] ?? 0, factor);
+    const b = shadeChannel(buf[start + 2] ?? 0, factor);
+    buf[start] = r;
+    buf[start + 1] = g;
+    buf[start + 2] = b;
+    return [r, g, b];
+}
+//# sourceMappingURL=surface-shaders.part02.js.map

package/dist/pipeline/middleware/surface-shaders.part02.js.map

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

package/dist/pipeline/middleware/surface-shaders.part03.d.ts

@@ -0,0 +1,12 @@
+import { type Surface } from '@flyingrobots/bijou';
+import { type SurfaceShaderContext } from './surface-shaders.part01.js';
+import { type BrightnessFactorFn } from './surface-shaders.part02.js';
+export declare function shadeCellSurface(surface: Surface, context: SurfaceShaderContext, factorForCell: BrightnessFactorFn): void;
+export declare function shadeHex(hex: string, factor: number): string;
+export declare function shadeChannel(value: number, factor: number): number;
+export declare function rgbToHex(r: number, g: number, b: number): string;
+export declare function toHex(value: number): string;
+export declare function clampFactor(value: number): number;
+export declare function lerp(start: number, end: number, t: number): number;
+export declare function normalizedNoise(x: number, y: number, frame: number): number;
+//# sourceMappingURL=surface-shaders.part03.d.ts.map

package/dist/pipeline/middleware/surface-shaders.part03.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"surface-shaders.part03.d.ts","sourceRoot":"","sources":["../../../src/pipeline/middleware/surface-shaders.part03.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,KAAK,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACxE,OAAO,EAAE,KAAK,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAEtE,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,oBAAoB,EAC7B,aAAa,EAAE,kBAAkB,GAChC,IAAI,CAiBN;AACD,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAgB5D;AACD,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAElE;AACD,wBAAgB,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAEhE;AACD,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE3C;AACD,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGjD;AACD,wBAAgB,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAElE;AACD,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAQ3E"}

package/dist/pipeline/middleware/surface-shaders.part03.js

@@ -0,0 +1,57 @@
+export function shadeCellSurface(surface, context, factorForCell) {
+    for (let y = 0; y < surface.height; y++) {
+        for (let x = 0; x < surface.width; x++) {
+            const factor = factorForCell(x, y, context);
+            if (factor === 1)
+                continue;
+            const cell = surface.get(x, y);
+            const fgHex = typeof cell.fg === 'string' ? cell.fg : cell.fg?.hex;
+            const bgHex = typeof cell.bg === 'string' ? cell.bg : cell.bg?.hex;
+            const nextFg = fgHex ? shadeHex(fgHex, factor) : undefined;
+            const nextBg = bgHex ? shadeHex(bgHex, factor) : undefined;
+            if (nextFg !== cell.fg || nextBg !== cell.bg) {
+                surface.set(x, y, { ...cell, fg: nextFg, bg: nextBg });
+            }
+        }
+    }
+}
+export function shadeHex(hex, factor) {
+    if (hex.length !== 7 || !hex.startsWith('#'))
+        return hex;
+    const digits = hex.slice(1);
+    if (!/^[0-9A-Fa-f]{6}$/.test(digits))
+        return hex;
+    const r = parseInt(digits.slice(0, 2), 16);
+    const g = parseInt(digits.slice(2, 4), 16);
+    const b = parseInt(digits.slice(4, 6), 16);
+    if (isNaN(r) || isNaN(g) || isNaN(b))
+        return hex;
+    return rgbToHex(shadeChannel(r, factor), shadeChannel(g, factor), shadeChannel(b, factor));
+}
+export function shadeChannel(value, factor) {
+    return Math.max(0, Math.min(255, Math.round(value * factor)));
+}
+export function rgbToHex(r, g, b) {
+    return `#${toHex(r)}${toHex(g)}${toHex(b)}`;
+}
+export function toHex(value) {
+    return value.toString(16).padStart(2, '0');
+}
+export function clampFactor(value) {
+    if (!Number.isFinite(value))
+        return 1;
+    return Math.max(0, Math.min(value, 2));
+}
+export function lerp(start, end, t) {
+    return start + (end - start) * t;
+}
+export function normalizedNoise(x, y, frame) {
+    let value = Math.imul(x + 1, 374761393);
+    value = (value + Math.imul(y + 1, 668265263)) >>> 0;
+    value = (value + Math.imul(frame + 1, 982451653)) >>> 0;
+    value ^= value >>> 13;
+    value = Math.imul(value, 1274126177) >>> 0;
+    value ^= value >>> 16;
+    return value / 0xffffffff;
+}
+//# sourceMappingURL=surface-shaders.part03.js.map

package/dist/pipeline/middleware/surface-shaders.part03.js.map

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

package/dist/pipeline/pipeline.d.ts

@@ -1,51 +1,16 @@
 import type { Surface, BijouContext, LayoutNode } from '@flyingrobots/bijou';
-/**
- * The state passed through the rendering pipeline.
- */
 export interface RenderState {
-    /** The model being rendered. */
-    model: any;
-    /** The Bijou context (ports, theme, mode). */
+    model: unknown;
     ctx: BijouContext;
-    /** Time delta in seconds since the last frame. */
     dt: number;
-    /**
-     * The surface currently visible on the terminal.
-     * This should NOT be modified by pipeline stages.
-     */
     readonly currentSurface: Surface;
-    /**
-     * The target surface being painted.
-     * Middleware in the `Paint` and `PostProcess` stages modify this surface.
-     */
     targetSurface: Surface;
-    /**
-     * Pooled byte buffer owned by the runtime for direct UTF-8 emission
-     * from the Diff stage. The buffer is sized to the current viewport and
-     * reused across frames. Absent only in non-interactive modes or custom
-     * pipelines that do not drive the default Diff middleware.
-     */
+    /** Pooled byte buffer owned by the runtime for direct UTF-8 emission. */
     outBuf?: Uint8Array;
-    /**
-     * Layout geometry calculated during the `Layout` stage.
-     * Keyed by component ID.
-     */
-    layoutMap: Map<string, any>;
-    /**
-     * Custom data bag for middleware to pass state between stages.
-     */
-    data: Record<string, any>;
+    layoutMap: Map<string, unknown>;
+    data: Record<string, unknown>;
 }
-/**
- * A middleware function in the rendering pipeline.
- *
- * @param state - The current render state.
- * @param next - Function to yield control to the next middleware.
- */
 export type RenderMiddleware = (state: RenderState, next: () => void) => void | Promise<void>;
-/**
- * A stage in the rendering pipeline.
- */
 export type RenderStage = 'Layout' | 'Paint' | 'PostProcess' | 'Diff' | 'Output';
 /** Per-stage timing sample captured during a single pipeline execution. */
 export interface RenderStageTiming {
@@ -64,20 +29,8 @@ export interface RenderStageObserver {
 export declare const RENDER_STAGE_TIMINGS_KEY = "__pipelineStageTimings";
 /** Key used to pass the resolved layout root between middleware stages. */
 export declare const RENDER_LAYOUT_ROOT_KEY = "__bijou:layoutRoot";
-/**
- * Read the resolved layout root from a render-state data bag.
- * Built-in layout middleware writes this value in `Layout`.
- */
 export declare function getRenderLayoutRoot(state: Pick<RenderState, 'data'>): LayoutNode | undefined;
-/**
- * Read per-stage timings captured during the current pipeline execution.
- *
- * The returned array is replaced on each `pipeline.execute(state)` call.
- */
 export declare function getRenderStageTimings(state: Pick<RenderState, 'data'>): readonly RenderStageTiming[];
-/**
- * The rendering pipeline registry.
- */
 export interface RenderPipeline {
     /** Register middleware for a specific stage. */
     use(stage: RenderStage, middleware: RenderMiddleware): void;
@@ -88,8 +41,10 @@ export interface RenderPipeline {
 }
 /** Options for creating a programmable render pipeline. */
 export interface CreatePipelineOptions {
-    /** Optional timing source override, primarily for deterministic tests. */
+    /** Timing source override for deterministic tests. */
     now?: () => number;
+    /** Diagnostic hook invoked when stage plan cache rebuilds. */
+    onPlanRebuild?: () => void;
 }
 /**
  * Create a new programmable rendering pipeline.

package/dist/pipeline/pipeline.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../../src/pipeline/pipeline.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAE7E;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,gCAAgC;IAChC,KAAK,EAAE,GAAG,CAAC;IACX,8CAA8C;IAC9C,GAAG,EAAE,YAAY,CAAC;IAClB,kDAAkD;IAClD,EAAE,EAAE,MAAM,CAAC;IACX;;;OAGG;IACH,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC;;;OAGG;IACH,aAAa,EAAE,OAAO,CAAC;IACvB;;;;;OAKG;IACH,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB;;;OAGG;IACH,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC5B;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC3B;AAED;;;;;GAKG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,IAAI,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE9F;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,OAAO,GAAG,aAAa,GAAG,MAAM,GAAG,QAAQ,CAAC;AAEjF,2EAA2E;AAC3E,MAAM,WAAW,iBAAiB;IAChC,4BAA4B;IAC5B,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IAC5B,0DAA0D;IAC1D,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,2DAA2D;AAC3D,MAAM,MAAM,0BAA0B,GAAG,CACvC,KAAK,EAAE,WAAW,EAClB,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,WAAW,KACf,IAAI,CAAC;AAEV,+CAA+C;AAC/C,MAAM,WAAW,mBAAmB;IAClC,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,uEAAuE;AACvE,eAAO,MAAM,wBAAwB,2BAA2B,CAAC;AAEjE,2EAA2E;AAC3E,eAAO,MAAM,sBAAsB,uBAAuB,CAAC;AAE3D;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,GAAG,UAAU,GAAG,SAAS,CAE5F;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,GAAG,SAAS,iBAAiB,EAAE,CAGpG;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,gDAAgD;IAChD,GAAG,CAAC,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAC5D,wEAAwE;IACxE,eAAe,CAAC,OAAO,EAAE,0BAA0B,GAAG,mBAAmB,CAAC;IAC1E,qDAAqD;IACrD,OAAO,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,CAAC;CACnC;AAED,2DAA2D;AAC3D,MAAM,WAAW,qBAAqB;IACpC,0EAA0E;IAC1E,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AASD;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,GAAE,qBAA0B,GAAG,cAAc,CA+IlF"}
+{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../../src/pipeline/pipeline.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAE7E,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,OAAO,CAAC;IACf,GAAG,EAAE,YAAY,CAAC;IAClB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,aAAa,EAAE,OAAO,CAAC;IACvB,yEAAyE;IACzE,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAED,MAAM,MAAM,gBAAgB,GAAG,CAAC,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,IAAI,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE9F,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,OAAO,GAAG,aAAa,GAAG,MAAM,GAAG,QAAQ,CAAC;AAEjF,2EAA2E;AAC3E,MAAM,WAAW,iBAAiB;IAChC,4BAA4B;IAC5B,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IAC5B,0DAA0D;IAC1D,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,2DAA2D;AAC3D,MAAM,MAAM,0BAA0B,GAAG,CACvC,KAAK,EAAE,WAAW,EAClB,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,WAAW,KACf,IAAI,CAAC;AAEV,+CAA+C;AAC/C,MAAM,WAAW,mBAAmB;IAClC,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,uEAAuE;AACvE,eAAO,MAAM,wBAAwB,2BAA2B,CAAC;AAEjE,2EAA2E;AAC3E,eAAO,MAAM,sBAAsB,uBAAuB,CAAC;AAE3D,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,GAAG,UAAU,GAAG,SAAS,CAG5F;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,GAAG,SAAS,iBAAiB,EAAE,CAGpG;AAED,MAAM,WAAW,cAAc;IAC7B,gDAAgD;IAChD,GAAG,CAAC,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAC5D,wEAAwE;IACxE,eAAe,CAAC,OAAO,EAAE,0BAA0B,GAAG,mBAAmB,CAAC;IAC1E,qDAAqD;IACrD,OAAO,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,CAAC;CACnC;AAED,2DAA2D;AAC3D,MAAM,WAAW,qBAAqB;IACpC,sDAAsD;IACtD,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,8DAA8D;IAC9D,aAAa,CAAC,EAAE,MAAM,IAAI,CAAC;CAC5B;AA8BD;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,GAAE,qBAA0B,GAAG,cAAc,CA0IlF"}