@zakmandhro/bunti 0.1.5 → 0.2.0

package/dist/dsl/hooks.js

@@ -0,0 +1,148 @@
+/**
+ * Bunti DSL state hooks: useState, useAsync, usePersistentState.
+ *
+ * Implementations close over the ScreenState only, so they are shared
+ * unchanged by every context created for that screen.
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { recordKeylessHook } from '../diagnostics';
+export function createHooks(state) {
+    const hooks = {
+        useAsync(keyOrFetcher, fetcherOrOptions, maybeOptions) {
+            let key;
+            let fetcher;
+            let options;
+            if (typeof keyOrFetcher === 'string') {
+                key = keyOrFetcher;
+                fetcher = fetcherOrOptions;
+                options = maybeOptions;
+            }
+            else {
+                if (state.hookCounter === undefined) {
+                    state.hookCounter = 0;
+                }
+                const index = state.hookCounter++;
+                recordKeylessHook(state, index, 'useAsync');
+                key = `_async_hook_${index}`;
+                fetcher = keyOrFetcher;
+                options = fetcherOrOptions;
+            }
+            const interval = options?.interval ?? 0;
+            const dataKey = `${key}_data`;
+            const loadingKey = `${key}_loading`;
+            const errorKey = `${key}_error`;
+            const lastFetchKey = `${key}_lastFetch`;
+            const fetchingKey = `${key}_fetching`;
+            if (!state.componentState.has(loadingKey)) {
+                state.componentState.set(loadingKey, true);
+            }
+            const lastFetch = state.componentState.get(lastFetchKey);
+            const isFetching = state.componentState.get(fetchingKey);
+            const now = Date.now();
+            const shouldFetch = !isFetching &&
+                (lastFetch === undefined ||
+                    (interval > 0 && now - lastFetch >= interval));
+            if (shouldFetch) {
+                state.componentState.set(fetchingKey, true);
+                state.componentState.set(lastFetchKey, now);
+                fetcher()
+                    .then((result) => {
+                    state.componentState.set(dataKey, result);
+                    state.componentState.set(loadingKey, false);
+                    state.componentState.set(errorKey, undefined);
+                    state.requestTick?.();
+                })
+                    .catch((err) => {
+                    state.componentState.set(errorKey, err);
+                    state.componentState.set(loadingKey, false);
+                    state.requestTick?.();
+                })
+                    .finally(() => {
+                    state.componentState.set(fetchingKey, false);
+                });
+            }
+            return {
+                data: state.componentState.get(dataKey),
+                loading: state.componentState.get(loadingKey),
+                error: state.componentState.get(errorKey),
+            };
+        },
+        useState(keyOrInitial, maybeInitial) {
+            let key;
+            let initial;
+            if (maybeInitial === undefined) {
+                if (state.hookCounter === undefined) {
+                    state.hookCounter = 0;
+                }
+                const index = state.hookCounter++;
+                recordKeylessHook(state, index, 'useState');
+                key = `_state_hook_${index}`;
+                initial = keyOrInitial;
+            }
+            else {
+                key = keyOrInitial;
+                initial = maybeInitial;
+            }
+            if (!state.componentState.has(key)) {
+                state.componentState.set(key, initial);
+            }
+            return [
+                state.componentState.get(key),
+                (val) => {
+                    state.componentState.set(key, val);
+                    state.requestTick?.();
+                },
+            ];
+        },
+        usePersistentState(key, initial) {
+            if (!state.componentState.has(key)) {
+                const storeDir = join(process.cwd(), '.tmp');
+                const storeFile = join(storeDir, 'bunti_store.json');
+                let fileVal;
+                try {
+                    if (existsSync(storeFile)) {
+                        const data = readFileSync(storeFile, 'utf-8');
+                        const parsed = JSON.parse(data);
+                        fileVal = parsed[key];
+                    }
+                }
+                catch {
+                    // Ignore
+                }
+                const finalVal = fileVal !== undefined ? fileVal : initial;
+                state.componentState.set(key, finalVal);
+            }
+            return [
+                state.componentState.get(key),
+                (val) => {
+                    state.componentState.set(key, val);
+                    const storeDir = join(process.cwd(), '.tmp');
+                    const storeFile = join(storeDir, 'bunti_store.json');
+                    try {
+                        if (!existsSync(storeDir)) {
+                            mkdirSync(storeDir, { recursive: true });
+                        }
+                        let currentStore = {};
+                        if (existsSync(storeFile)) {
+                            try {
+                                currentStore = JSON.parse(readFileSync(storeFile, 'utf-8'));
+                            }
+                            catch {
+                                currentStore = {};
+                            }
+                        }
+                        currentStore[key] = val;
+                        writeFileSync(storeFile, JSON.stringify(currentStore, null, 2), 'utf-8');
+                    }
+                    catch {
+                        // Ignore
+                    }
+                    state.requestTick?.();
+                },
+            ];
+        },
+    };
+    return hooks;
+}
+//# sourceMappingURL=hooks.js.map

package/dist/dsl/hooks.js.map

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

package/dist/dsl/interaction.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Bunti DSL interaction: hitboxes, hover/press/click queries, and focus
+ * management.
+ *
+ * Click semantics: a 'click' KeyEvent is emitted once, on SGR mouse RELEASE,
+ * carrying the press-origin coordinates (state.clickX/clickY). isClicked is
+ * therefore true exactly one frame per click — components fire actions once
+ * per click instead of every frame the button is held.
+ */
+import type { Rect, RectInput } from '../geometry';
+import type { ScreenState } from '../state';
+import type { BuntiContext } from './types';
+type Interaction = Pick<BuntiContext, 'focusable' | 'isFocused' | 'focus' | 'focusNext' | 'hitbox' | 'isHovered' | 'isPressed' | 'isClicked' | 'isHoverEnter' | 'isHoverLeave'>;
+export declare function createInteraction(state: ScreenState, resolveRect: (bounds: RectInput) => Rect): Interaction;
+export {};
+//# sourceMappingURL=interaction.d.ts.map

package/dist/dsl/interaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interaction.d.ts","sourceRoot":"","sources":["../../src/dsl/interaction.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,KAAK,EAAU,WAAW,EAAE,MAAM,UAAU,CAAC;AACpD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE5C,KAAK,WAAW,GAAG,IAAI,CACrB,YAAY,EACV,WAAW,GACX,WAAW,GACX,OAAO,GACP,WAAW,GACX,QAAQ,GACR,WAAW,GACX,WAAW,GACX,WAAW,GACX,cAAc,GACd,cAAc,CACjB,CAAC;AA6BF,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,WAAW,EAClB,WAAW,EAAE,CAAC,MAAM,EAAE,SAAS,KAAK,IAAI,GACvC,WAAW,CAkFb"}

package/dist/dsl/interaction.js

@@ -0,0 +1,101 @@
+/**
+ * Bunti DSL interaction: hitboxes, hover/press/click queries, and focus
+ * management.
+ *
+ * Click semantics: a 'click' KeyEvent is emitted once, on SGR mouse RELEASE,
+ * carrying the press-origin coordinates (state.clickX/clickY). isClicked is
+ * therefore true exactly one frame per click — components fire actions once
+ * per click instead of every frame the button is held.
+ */
+function contains(box, x, y) {
+    return (x >= box.x && x < box.x + box.width && y >= box.y && y < box.y + box.height);
+}
+/**
+ * True when this frame carries a click. `state.keys` covers events drained
+ * by the render loop; the `state.lastKey === 'click'` check keeps manually
+ * driven states (tests, custom loops) working.
+ */
+function frameHasClick(state) {
+    if (state.lastKey === 'click')
+        return true;
+    return (state.keys?.some((e) => e.key === 'click' && e.kind !== 'release') ?? false);
+}
+/** Click test point: press-origin when available, mouse position otherwise. */
+function clickX(state) {
+    return state.clickX ?? state.mouseX;
+}
+function clickY(state) {
+    return state.clickY ?? state.mouseY;
+}
+export function createInteraction(state, resolveRect) {
+    const interaction = {
+        focusable(id) {
+            if (!state.focusableIds.includes(id)) {
+                state.focusableIds.push(id);
+            }
+            if (!state.focusedId)
+                state.focusedId = id;
+            return state.focusedId === id;
+        },
+        isFocused(id) {
+            return state.focusedId === id;
+        },
+        focus(id) {
+            state.focusedId = id;
+        },
+        focusNext() {
+            if (state.focusableIds.length === 0)
+                return;
+            const idx = state.focusableIds.indexOf(state.focusedId || '');
+            const nextIdx = (idx + 1) % state.focusableIds.length;
+            state.focusedId = state.focusableIds[nextIdx];
+        },
+        hitbox(id, bounds) {
+            const rect = resolveRect(bounds);
+            const box = { id, ...rect };
+            state.hitboxes.set(id, box);
+            const hovered = contains(box, state.mouseX, state.mouseY);
+            // Hover-change tracking against the last evaluation of this id.
+            const prevHovered = state.hoverStates.get(id) ?? false;
+            if (hovered !== prevHovered) {
+                if (hovered) {
+                    state.hoverEntered.add(id);
+                    state.hoverLeft.delete(id);
+                }
+                else {
+                    state.hoverLeft.add(id);
+                    state.hoverEntered.delete(id);
+                }
+                state.hoverStates.set(id, hovered);
+            }
+            const pressed = hovered && state.isMouseDown && state.mouseButton === 0;
+            const clicked = frameHasClick(state) && contains(box, clickX(state), clickY(state));
+            return { box, hovered, pressed, clicked };
+        },
+        isHovered(id) {
+            const box = state.hitboxes.get(id);
+            if (!box)
+                return false;
+            return contains(box, state.mouseX, state.mouseY);
+        },
+        isPressed(id) {
+            return (interaction.isHovered(id) &&
+                state.isMouseDown &&
+                state.mouseButton === 0);
+        },
+        isClicked(id) {
+            const box = state.hitboxes.get(id);
+            if (!box)
+                return false;
+            return (frameHasClick(state) && contains(box, clickX(state), clickY(state)));
+        },
+        isHoverEnter(id) {
+            return state.hoverEntered.has(id);
+        },
+        isHoverLeave(id) {
+            return state.hoverLeft.has(id);
+        },
+    };
+    return interaction;
+}
+//# sourceMappingURL=interaction.js.map

package/dist/dsl/interaction.js.map

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

package/dist/dsl/layers.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Bunti DSL layer machinery: transparent buffers, layer screen states,
+ * painted-bounds tracking, and back-buffer compositing.
+ */
+import type { Rect } from '../geometry';
+import type { Cell, ScreenState } from '../state';
+export declare function createLayerScreenState(state: ScreenState): ScreenState;
+/**
+ * Tight min/max bounds of a layer buffer's painted cells, or null when the
+ * layer painted nothing. Used at composite time to place drop shadows.
+ */
+export declare function layerContentBounds(buffer: Cell[], width: number): Rect | null;
+export declare function compositeLayer(state: ScreenState, buffer: Cell[]): void;
+//# sourceMappingURL=layers.d.ts.map

package/dist/dsl/layers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layers.d.ts","sourceRoot":"","sources":["../../src/dsl/layers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAkBlD,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,WAAW,GAAG,WAAW,CAOtE;AAWD;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAoB7E;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,QAqBhE"}

package/dist/dsl/layers.js

@@ -0,0 +1,87 @@
+/**
+ * Bunti DSL layer machinery: transparent buffers, layer screen states,
+ * painted-bounds tracking, and back-buffer compositing.
+ */
+function createTransparentBuffer(size) {
+    return Array.from({ length: size }, () => ({
+        char: ' ',
+        fg: undefined,
+        bg: undefined,
+        fgCode: undefined,
+        bgCode: undefined,
+        bold: false,
+        italic: false,
+        underline: false,
+        dim: false,
+        strike: false,
+        skip: true,
+    }));
+}
+export function createLayerScreenState(state) {
+    const size = state.width * state.height;
+    return {
+        ...state,
+        frontBuffer: createTransparentBuffer(size),
+        backBuffer: createTransparentBuffer(size),
+    };
+}
+/**
+ * Whether a layer-buffer cell holds painted content. Transparent cells are
+ * skip cells with the pristine ' ' char; painted wide-glyph tails are skip
+ * cells too but carry the '' char, so they count as content.
+ */
+function isPainted(cell) {
+    return !cell.skip || cell.char === '';
+}
+/**
+ * Tight min/max bounds of a layer buffer's painted cells, or null when the
+ * layer painted nothing. Used at composite time to place drop shadows.
+ */
+export function layerContentBounds(buffer, width) {
+    let minX = Infinity;
+    let minY = Infinity;
+    let maxX = -1;
+    let maxY = -1;
+    const height = Math.floor(buffer.length / width);
+    for (let y = 0; y < height; y++) {
+        const rowOffset = y * width;
+        for (let x = 0; x < width; x++) {
+            if (!isPainted(buffer[rowOffset + x]))
+                continue;
+            if (x < minX)
+                minX = x;
+            if (x > maxX)
+                maxX = x;
+            if (y < minY)
+                minY = y;
+            if (y > maxY)
+                maxY = y;
+        }
+    }
+    if (maxX < 0)
+        return null;
+    return { x: minX, y: minY, width: maxX - minX + 1, height: maxY - minY + 1 };
+}
+export function compositeLayer(state, buffer) {
+    for (let i = 0; i < buffer.length; i++) {
+        const source = buffer[i];
+        // Transparent cells never composite; painted wide-glyph tails
+        // (skip + '' char) must, or stale chars peek through under the glyph.
+        if (!isPainted(source))
+            continue;
+        const target = state.backBuffer[i];
+        target.char = source.char;
+        target.fg = source.fg;
+        target.bg = source.bg;
+        target.bold = source.bold;
+        target.italic = source.italic;
+        target.underline = source.underline;
+        target.dim = source.dim;
+        target.strike = source.strike;
+        target.fgCode = source.fgCode;
+        target.bgCode = source.bgCode;
+        target.skip = source.skip;
+        target.raw = source.raw;
+    }
+}
+//# sourceMappingURL=layers.js.map

package/dist/dsl/layers.js.map

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

package/dist/dsl/motion.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Bunti DSL motion helpers: animate, fade, typewriter, flicker, transition,
+ * stagger, restartAnimation, and per-frame timing (dt / frame).
+ */
+import type { ScreenState } from '../state';
+import type { BuntiContext } from './types';
+type Motion = Pick<BuntiContext, 'animate' | 'fade' | 'typewriter' | 'flicker' | 'transition' | 'stagger' | 'restartAnimation' | 'dt' | 'frame'>;
+export declare function createMotion(state: ScreenState, useState: BuntiContext['useState']): Motion;
+export {};
+//# sourceMappingURL=motion.d.ts.map

package/dist/dsl/motion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"motion.d.ts","sourceRoot":"","sources":["../../src/dsl/motion.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,KAAK,EAAE,YAAY,EAAqB,MAAM,SAAS,CAAC;AA2B/D,KAAK,MAAM,GAAG,IAAI,CAChB,YAAY,EACV,SAAS,GACT,MAAM,GACN,YAAY,GACZ,SAAS,GACT,YAAY,GACZ,SAAS,GACT,kBAAkB,GAClB,IAAI,GACJ,OAAO,CACV,CAAC;AAEF,wBAAgB,YAAY,CAC1B,KAAK,EAAE,WAAW,EAClB,QAAQ,EAAE,YAAY,CAAC,UAAU,CAAC,GACjC,MAAM,CAoKR"}

package/dist/dsl/motion.js

@@ -0,0 +1,150 @@
+/**
+ * Bunti DSL motion helpers: animate, fade, typewriter, flicker, transition,
+ * stagger, restartAnimation, and per-frame timing (dt / frame).
+ */
+import { fade } from '../colors';
+import { clamp01 } from '../easing';
+function graphemes(text) {
+    const segmenter = new Intl.Segmenter('en', { granularity: 'grapheme' });
+    return Array.from(segmenter.segment(text), ({ segment }) => segment);
+}
+/** Deterministic 0-1 hash (FNV-1a) for time-bucketed flicker. */
+function hash01(seed) {
+    let h = 2166136261;
+    for (let i = 0; i < seed.length; i++) {
+        h ^= seed.charCodeAt(i);
+        h = Math.imul(h, 16777619);
+    }
+    return ((h >>> 0) % 100000) / 100000;
+}
+const identity = (t) => t;
+/** Namespaced componentState key for transition edge tracking. */
+const transitionKey = (id) => `_motion:transition:${id}`;
+export function createMotion(state, useState) {
+    return {
+        // loop() owns timing: it stamps state.dt / state.frameCount each tick.
+        // Outside a loop (tests, one-shot renders) both default to 0.
+        dt: state.dt ?? 0,
+        frame: state.frameCount ?? 0,
+        animate(duration, options = {}) {
+            const now = Date.now();
+            const start = options.id
+                ? useState(`${options.id}_start`, now)[0]
+                : state.startTime;
+            const elapsed = now - start - (options.delay || 0);
+            const ease = options.easing ?? identity;
+            if (elapsed < 0 || duration <= 0)
+                return ease(0);
+            if (options.loop === 'yoyo') {
+                // 0 -> 1 -> 0 over two durations; easing applies to each leg.
+                const phase = (elapsed % (duration * 2)) / duration;
+                return ease(phase <= 1 ? phase : 2 - phase);
+            }
+            if (options.loop)
+                return ease((elapsed % duration) / duration);
+            return ease(Math.min(1, elapsed / duration));
+        },
+        fade,
+        /**
+         * Visibility-driven enter/exit progress for immediate-mode UIs.
+         * Tracks visible-flag edges in componentState; `mounted` stays true
+         * through the exit animation so callers keep rendering while a panel
+         * animates out. Mid-animation flips retarget from the current progress
+         * (no jumps).
+         */
+        transition(id, visible, options = {}) {
+            const now = Date.now();
+            const duration = Math.max(0, options.duration ?? 300);
+            const exitDuration = Math.max(0, options.exitDuration ?? duration);
+            const ease = options.easing ?? identity;
+            const key = transitionKey(id);
+            let rec = state.componentState.get(key);
+            if (rec === undefined) {
+                // First sight: visible components animate in from 0; hidden ones
+                // start fully exited (mounted false immediately).
+                rec = { visible, flippedAt: visible ? now : now - exitDuration - 1 };
+                state.componentState.set(key, rec);
+            }
+            const rawAt = (r) => {
+                if (r.visible) {
+                    return duration <= 0 ? 1 : clamp01((now - r.flippedAt) / duration);
+                }
+                return exitDuration <= 0
+                    ? 0
+                    : 1 - clamp01((now - r.flippedAt) / exitDuration);
+            };
+            if (rec.visible !== visible) {
+                // Retarget from the current raw progress so mid-animation flips
+                // continue smoothly instead of restarting the full leg.
+                const current = rawAt(rec);
+                rec.visible = visible;
+                rec.flippedAt = visible
+                    ? now - current * duration
+                    : now - (1 - current) * exitDuration;
+            }
+            const raw = rawAt(rec);
+            return {
+                progress: ease(raw),
+                mounted: visible || raw > 0,
+            };
+        },
+        /**
+         * Cascading entrance progress: item `index` starts `index * delay` ms
+         * into the timeline and runs for `duration` ms. The timeline is the
+         * screen's elapsed time, or an animate()-style `id` clock when given
+         * (restartAnimation(id) then replays the cascade).
+         */
+        stagger(index, options) {
+            const now = Date.now();
+            const start = options.id
+                ? useState(`${options.id}_start`, now)[0]
+                : state.startTime;
+            const elapsed = now - start - index * options.delay;
+            const ease = options.easing ?? identity;
+            if (options.duration <= 0)
+                return ease(elapsed >= 0 ? 1 : 0);
+            return ease(clamp01(elapsed / options.duration));
+        },
+        /** Resets an animate()/typewriter()/stagger() id clock to "now". */
+        restartAnimation(id) {
+            state.componentState.set(`${id}_start`, Date.now());
+            state.requestTick?.();
+        },
+        typewriter(text, options = {}) {
+            const now = Date.now();
+            const start = options.id
+                ? useState(`${options.id}_start`, now)[0]
+                : state.startTime;
+            const delay = options.delay ?? 0;
+            const elapsed = Math.max(0, now - start - delay);
+            const cps = options.cps ?? 24;
+            const chars = graphemes(text);
+            const rawIndex = Math.floor((elapsed / 1000) * cps);
+            const index = options.loop && chars.length > 0
+                ? rawIndex % (chars.length + 1)
+                : Math.min(chars.length, rawIndex);
+            const blinkRate = options.blinkRate ?? 450;
+            const showCursor = options.blink === false ||
+                Math.floor(elapsed / blinkRate) % 2 === 0 ||
+                index < chars.length;
+            return {
+                text: chars.slice(0, index).join(''),
+                cursor: showCursor ? (options.cursor ?? '█') : ' ',
+                done: index >= chars.length,
+                index,
+                progress: chars.length === 0 ? 1 : index / chars.length,
+            };
+        },
+        /**
+         * Time-based flicker: deterministic per interval bucket (hash of the
+         * bucket + id), so the flicker rate is fps-independent while keeping
+         * the same visual character as the old per-frame Math.random.
+         */
+        flicker(intensity = 0.5, options = {}) {
+            const interval = Math.max(1, options.interval ?? 50);
+            const bucket = Math.floor((Date.now() - state.startTime) / interval);
+            return hash01(`${options.id ?? ''}:${bucket}`) > 1 - intensity;
+        },
+    };
+}
+//# sourceMappingURL=motion.js.map

package/dist/dsl/motion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"motion.js","sourceRoot":"","sources":["../../src/dsl/motion.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,SAAS,SAAS,CAAC,IAAY;IAC7B,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,EAAE,WAAW,EAAE,UAAU,EAAE,CAAC,CAAC;IACxE,OAAO,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC;AACvE,CAAC;AAED,iEAAiE;AACjE,SAAS,MAAM,CAAC,IAAY;IAC1B,IAAI,CAAC,GAAG,UAAU,CAAC;IACnB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QACxB,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;IAC7B,CAAC;IACD,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,MAAM,CAAC,GAAG,MAAM,CAAC;AACvC,CAAC;AAED,MAAM,QAAQ,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC;AAElC,kEAAkE;AAClE,MAAM,aAAa,GAAG,CAAC,EAAU,EAAE,EAAE,CAAC,sBAAsB,EAAE,EAAE,CAAC;AAoBjE,MAAM,UAAU,YAAY,CAC1B,KAAkB,EAClB,QAAkC;IAElC,OAAO;QACL,uEAAuE;QACvE,8DAA8D;QAC9D,EAAE,EAAE,KAAK,CAAC,EAAE,IAAI,CAAC;QACjB,KAAK,EAAE,KAAK,CAAC,UAAU,IAAI,CAAC;QAE5B,OAAO,CACL,QAAgB,EAChB,UAKI,EAAE;YAEN,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YACvB,MAAM,KAAK,GAAG,OAAO,CAAC,EAAE;gBACtB,CAAC,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;gBACzC,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC;YACpB,MAAM,OAAO,GAAG,GAAG,GAAG,KAAK,GAAG,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC;YACnD,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,IAAI,QAAQ,CAAC;YACxC,IAAI,OAAO,GAAG,CAAC,IAAI,QAAQ,IAAI,CAAC;gBAAE,OAAO,IAAI,CAAC,CAAC,CAAC,CAAC;YACjD,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;gBAC5B,8DAA8D;gBAC9D,MAAM,KAAK,GAAG,CAAC,OAAO,GAAG,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC;gBACpD,OAAO,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC;YAC9C,CAAC;YACD,IAAI,OAAO,CAAC,IAAI;gBAAE,OAAO,IAAI,CAAC,CAAC,OAAO,GAAG,QAAQ,CAAC,GAAG,QAAQ,CAAC,CAAC;YAC/D,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC,CAAC,CAAC;QAC/C,CAAC;QAED,IAAI;QAEJ;;;;;;WAMG;QACH,UAAU,CACR,EAAU,EACV,OAAgB,EAChB,UAII,EAAE;YAEN,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YACvB,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,QAAQ,IAAI,GAAG,CAAC,CAAC;YACtD,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,YAAY,IAAI,QAAQ,CAAC,CAAC;YACnE,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,IAAI,QAAQ,CAAC;YAExC,MAAM,GAAG,GAAG,aAAa,CAAC,EAAE,CAAC,CAAC;YAC9B,IAAI,GAAG,GAAG,KAAK,CAAC,cAAc,CAAC,GAAG,CAAC,GAAG,CAAiC,CAAC;YACxE,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;gBACtB,iEAAiE;gBACjE,kDAAkD;gBAClD,GAAG,GAAG,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,YAAY,GAAG,CAAC,EAAE,CAAC;gBACrE,KAAK,CAAC,cAAc,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;YACrC,CAAC;YAED,MAAM,KAAK,GAAG,CAAC,CAAmB,EAAU,EAAE;gBAC5C,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;oBACd,OAAO,QAAQ,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,SAAS,CAAC,GAAG,QAAQ,CAAC,CAAC;gBACrE,CAAC;gBACD,OAAO,YAAY,IAAI,CAAC;oBACtB,CAAC,CAAC,CAAC;oBACH,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,SAAS,CAAC,GAAG,YAAY,CAAC,CAAC;YACtD,CAAC,CAAC;YAEF,IAAI,GAAG,CAAC,OAAO,KAAK,OAAO,EAAE,CAAC;gBAC5B,gEAAgE;gBAChE,wDAAwD;gBACxD,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;gBAC3B,GAAG,CAAC,OAAO,GAAG,OAAO,CAAC;gBACtB,GAAG,CAAC,SAAS,GAAG,OAAO;oBACrB,CAAC,CAAC,GAAG,GAAG,OAAO,GAAG,QAAQ;oBAC1B,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,OAAO,CAAC,GAAG,YAAY,CAAC;YACzC,CAAC;YAED,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;YACvB,OAAO;gBACL,QAAQ,EAAE,IAAI,CAAC,GAAG,CAAC;gBACnB,OAAO,EAAE,OAAO,IAAI,GAAG,GAAG,CAAC;aAC5B,CAAC;QACJ,CAAC;QAED;;;;;WAKG;QACH,OAAO,CACL,KAAa,EACb,OAKC;YAED,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YACvB,MAAM,KAAK,GAAG,OAAO,CAAC,EAAE;gBACtB,CAAC,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;gBACzC,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC;YACpB,MAAM,OAAO,GAAG,GAAG,GAAG,KAAK,GAAG,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;YACpD,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,IAAI,QAAQ,CAAC;YACxC,IAAI,OAAO,CAAC,QAAQ,IAAI,CAAC;gBAAE,OAAO,IAAI,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAC7D,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;QACnD,CAAC;QAED,oEAAoE;QACpE,gBAAgB,CAAC,EAAU;YACzB,KAAK,CAAC,cAAc,CAAC,GAAG,CAAC,GAAG,EAAE,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;YACnD,KAAsC,CAAC,WAAW,EAAE,EAAE,CAAC;QAC1D,CAAC;QAED,UAAU,CAAC,IAAY,EAAE,UAA6B,EAAE;YACtD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YACvB,MAAM,KAAK,GAAG,OAAO,CAAC,EAAE;gBACtB,CAAC,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;gBACzC,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC;YACpB,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,CAAC,CAAC;YACjC,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,GAAG,KAAK,GAAG,KAAK,CAAC,CAAC;YACjD,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,EAAE,CAAC;YAC9B,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;YAC9B,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,GAAG,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC;YACpD,MAAM,KAAK,GACT,OAAO,CAAC,IAAI,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;gBAC9B,CAAC,CAAC,QAAQ,GAAG,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;gBAC/B,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;YACvC,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,GAAG,CAAC;YAC3C,MAAM,UAAU,GACd,OAAO,CAAC,KAAK,KAAK,KAAK;gBACvB,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC;gBACzC,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC;YAEvB,OAAO;gBACL,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;gBACpC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG;gBAClD,IAAI,EAAE,KAAK,IAAI,KAAK,CAAC,MAAM;gBAC3B,KAAK;gBACL,QAAQ,EAAE,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,KAAK,CAAC,MAAM;aACxD,CAAC;QACJ,CAAC;QAED;;;;WAIG;QACH,OAAO,CACL,YAAoB,GAAG,EACvB,UAA8C,EAAE;YAEhD,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC;YACrD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,SAAS,CAAC,GAAG,QAAQ,CAAC,CAAC;YACrE,OAAO,MAAM,CAAC,GAAG,OAAO,CAAC,EAAE,IAAI,EAAE,IAAI,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC;QACjE,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/dsl/render.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Bunti DSL primary entry point: render.
+ */
+import { type ScreenOptions } from '../state';
+import type { BuntiContext } from './types';
+/**
+ * Starts a Bunti app: runs `callback` every frame (immediate mode —
+ * redraw the whole screen from state each call) and flushes only the
+ * changed cells to the terminal. The returned promise resolves when the
+ * loop stops (ctx.requestStop() or Ctrl+C). Pass `once: true` to render
+ * a single frame and return. Keyboard input needs a real TTY on stdin:
+ * piped input is ignored.
+ * @example
+ * await render((ctx) => {
+ *   ctx.box({ width: 30, border: 'rounded' }, (s) => s.text('hi'));
+ *   if (ctx.lastKey === 'q') ctx.requestStop();
+ * }, { keyboard: true, mouse: true, alternateBuffer: true, hideCursor: true });
+ */
+export declare function render(callback: ((b: BuntiContext) => void) | string, options?: ScreenOptions & {
+    once?: boolean;
+}): Promise<void>;
+//# sourceMappingURL=render.d.ts.map

package/dist/dsl/render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../src/dsl/render.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,EAIL,KAAK,aAAa,EACnB,MAAM,UAAU,CAAC;AAElB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE5C;;;;;;;;;;;;GAYG;AACH,wBAAsB,MAAM,CAC1B,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,YAAY,KAAK,IAAI,CAAC,GAAG,MAAM,EAC9C,OAAO,GAAE,aAAa,GAAG;IAAE,IAAI,CAAC,EAAE,OAAO,CAAA;CAAO,iBAkDjD"}