@zakmandhro/bunti 0.1.4 → 0.2.0

package/dist/dsl/render.js

@@ -0,0 +1,69 @@
+/**
+ * Bunti DSL primary entry point: render.
+ */
+import { init } from '../icons';
+import { flush, loop } from '../render';
+import { ANSI, clearBackBuffer, createScreenState, } from '../state';
+import { createScreenContext } from './context';
+/**
+ * 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 async function render(callback, options = {}) {
+    if (typeof Bun === 'undefined') {
+        throw new Error('Bunti is Bun-native and uses Bun runtime APIs. ' +
+            'Run with Bun >=1.0: https://bun.sh — Node.js is not supported.');
+    }
+    // createScreenState runs env detection once per render() (state.terminal).
+    const state = createScreenState(options);
+    // Icon tier: an explicit ScreenOptions.nerdFont always wins; otherwise the
+    // detected profile decides ('yes'/'assumed-yes' -> Nerd Font glyphs).
+    if (options.nerdFont !== undefined) {
+        await init({ nerdFont: options.nerdFont });
+    }
+    else {
+        await init({ profile: state.terminal });
+    }
+    const tick = () => {
+        clearBackBuffer(state);
+        const b = createScreenContext(state);
+        if (typeof callback === 'string') {
+            b.blit(0, 0, callback);
+        }
+        else {
+            callback(b);
+        }
+        if (state.isStopped)
+            return;
+        b.flushFlow();
+        if (state.isStopped)
+            return;
+        flush(state);
+    };
+    if (options.once) {
+        tick();
+        // Let the terminal settle for a frame, then resolve. No interval or
+        // stdin listener was started in once mode, so nothing keeps the event
+        // loop alive and the host process (never killed by the library) can
+        // continue or exit naturally.
+        await new Promise((resolve) => {
+            setTimeout(resolve, 50);
+        });
+        // flush() hides the cursor per-frame when requested; a once-shot must
+        // not leave the user's cursor invisible.
+        if (options.hideCursor)
+            process.stdout.write(ANSI.showCursor);
+        return;
+    }
+    await loop(state, (_s) => tick());
+}
+//# sourceMappingURL=render.js.map

package/dist/dsl/render.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.js","sourceRoot":"","sources":["../../src/dsl/render.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAChC,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EACL,IAAI,EACJ,eAAe,EACf,iBAAiB,GAElB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAGhD;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,MAAM,CAC1B,QAA8C,EAC9C,UAA8C,EAAE;IAEhD,IAAI,OAAO,GAAG,KAAK,WAAW,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CACb,iDAAiD;YAC/C,gEAAgE,CACnE,CAAC;IACJ,CAAC;IAED,2EAA2E;IAC3E,MAAM,KAAK,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAC;IAEzC,2EAA2E;IAC3E,sEAAsE;IACtE,IAAI,OAAO,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;QACnC,MAAM,IAAI,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC7C,CAAC;SAAM,CAAC;QACN,MAAM,IAAI,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC1C,CAAC;IAED,MAAM,IAAI,GAAG,GAAG,EAAE;QAChB,eAAe,CAAC,KAAK,CAAC,CAAC;QACvB,MAAM,CAAC,GAAG,mBAAmB,CAAC,KAAK,CAAC,CAAC;QACrC,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;YACjC,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,QAAQ,CAAC,CAAC;QACzB,CAAC;aAAM,CAAC;YACN,QAAQ,CAAC,CAAC,CAAC,CAAC;QACd,CAAC;QACD,IAAI,KAAK,CAAC,SAAS;YAAE,OAAO;QAC5B,CAAC,CAAC,SAAS,EAAE,CAAC;QACd,IAAI,KAAK,CAAC,SAAS;YAAE,OAAO;QAC5B,KAAK,CAAC,KAAK,CAAC,CAAC;IACf,CAAC,CAAC;IAEF,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QACjB,IAAI,EAAE,CAAC;QACP,oEAAoE;QACpE,sEAAsE;QACtE,oEAAoE;QACpE,8BAA8B;QAC9B,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;YAClC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QAC1B,CAAC,CAAC,CAAC;QACH,sEAAsE;QACtE,yCAAyC;QACzC,IAAI,OAAO,CAAC,UAAU;YAAE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC9D,OAAO;IACT,CAAC;IAED,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC;AACpC,CAAC"}

package/dist/dsl/types.d.ts

@@ -0,0 +1,510 @@
+/**
+ * Bunti DSL shared types and constants.
+ */
+import type { bg, darken, fg, Gradient, lighten, rgb } from '../colors';
+import type { TerminalProfile } from '../detect';
+import type { PlacedRectInput, PlacedRectOptions, Rect, RectInput, SplitOptions } from '../geometry';
+import type { KeyEvent } from '../input';
+import type { ListOptions, SideColors, StyleOptions, TableOptions } from '../layout';
+import type { Cell, Hitbox, RGB, ScreenState } from '../state';
+import type { Theme, ThemeColor, ThemeInput } from '../theme';
+import type { BuntiColor } from '../vendor/colors';
+/**
+ * Normalized key-name constants for `ctx.lastKey` / `ctx.keyPressed()`.
+ * Printable keys are their literal character ('a', 'A', ' '); mouse events
+ * arrive as the 'click' / 'wheel_up' / 'wheel_down' pseudo-keys.
+ * @example if (ctx.keyPressed(KEYS.ENTER)) submit();
+ */
+export declare const KEYS: {
+    UP: string;
+    DOWN: string;
+    RIGHT: string;
+    LEFT: string;
+    ENTER: string;
+    ESCAPE: string;
+    TAB: string;
+    BACKSPACE: string;
+    SPACE: string;
+    HOME: string;
+    END: string;
+    DELETE: string;
+    PAGE_UP: string;
+    PAGE_DOWN: string;
+    INSERT: string;
+    /** Left-button click (emitted once, on release; requires `mouse: true`). */
+    CLICK: string;
+    /** Mouse wheel scrolled up (requires `mouse: true`). */
+    WHEEL_UP: string;
+    /** Mouse wheel scrolled down (requires `mouse: true`). */
+    WHEEL_DOWN: string;
+};
+/**
+ * Options for `ctx.box()`. Extends StyleOptions (width/height/padding/
+ * border/align/wrap) with placement, layering, and color controls.
+ */
+export interface DSLBoxOptions extends StyleOptions {
+    /** Background fill: palette name, hex, ANSI-256 code, RGB, Gradient, or theme token. */
+    bgColor?: string | number | RGB | Gradient | ThemeColor;
+    /**
+     * Default text color inside the box. 'blank' auto-picks black or white
+     * for WCAG contrast against `bgColor`.
+     */
+    color?: string | number | RGB | ThemeColor | 'blank';
+    /** Column offset (cells) inside the parent area. Unplaced boxes center. */
+    x?: number;
+    /** Row offset (cells) inside the parent area. Unplaced boxes center. */
+    y?: number;
+    /**
+     * Promotes the box onto its own composited layer at this z-index —
+     * shorthand for wrapping it in `ctx.layer(zIndex, ...)`.
+     */
+    zIndex?: number;
+    /** Pins the box to the top or bottom edge at full parent width. */
+    anchor?: 'top' | 'bottom';
+    /** Reserved size hint ('auto' sizes to content). */
+    size?: 'auto' | number;
+    /** Title rendered into the top border. */
+    title?: string;
+    /** Styler applied to the rendered title (e.g. a ThemeColor or color.bold). */
+    titleStyle?: (s: string) => string;
+    /** Stable identifier (useful with hitboxes/focus). */
+    id?: string;
+    /**
+     * Border color: single color value, a styler function, or per-side
+     * colors ({ top, bottom, left, right }).
+     */
+    borderColor?: string | number | RGB | ThemeColor | ((s: string) => string) | SideColors;
+    /** If true, the string is returned but NOT appended to the flow. */
+    detach?: boolean;
+}
+/** Options for `ctx.typewriter()`. */
+export interface TypewriterOptions {
+    /** Keys the animation clock (restartable via `ctx.restartAnimation(id)`). */
+    id?: string;
+    /** Typing speed in characters per second (default 24). */
+    cps?: number;
+    /** Milliseconds to wait before typing starts. */
+    delay?: number;
+    /** Restart from the beginning after the full text is typed. */
+    loop?: boolean;
+    /** Cursor glyph (default '█'). */
+    cursor?: string;
+    /** Set false to disable cursor blinking after typing completes. */
+    blink?: boolean;
+    /** Cursor blink period in milliseconds (default 450). */
+    blinkRate?: number;
+}
+/** Frame snapshot returned by `ctx.typewriter()`. */
+export interface TypewriterState {
+    /** The portion of the text typed so far. */
+    text: string;
+    /** The cursor glyph for this frame (' ' during blink-off phases). */
+    cursor: string;
+    /** True once the full text has been typed. */
+    done: boolean;
+    /** Number of graphemes typed so far. */
+    index: number;
+    /** Typing progress 0..1. */
+    progress: number;
+}
+/** Options for `ctx.layer()`. */
+export interface LayerOptions {
+    /** Composite order: higher z-index layers paint on top (default 0). */
+    zIndex?: number;
+    /**
+     * Paints a drop shadow under the layer's painted content bounds
+     * (offset +2 columns, +1 row) at composite time. The shadow darkens
+     * whatever sits below it, including lower layers.
+     */
+    shadow?: boolean;
+    /**
+     * Dims everything below this layer by 0..1 (backdrop luminance scale
+     * toward black) before the layer composites. Applied in z-order, so
+     * lower layers are dimmed too.
+     */
+    backdrop?: number;
+}
+/**
+ * The contextual builder passed to every render closure. One frame = one
+ * callback invocation: read input, derive state, draw.
+ *
+ * Coordinate model: `x`/`y` are cell offsets local to the current context
+ * area (the whole screen at the root; the padded interior inside a box).
+ * At the root, `box()` paints straight into the screen buffer and centers
+ * when not given `x`/`y`; inside a box, drawing calls append to that box's
+ * text flow. Use `layer()`/`zIndex` for anything that must overlap.
+ */
+export interface BuntiContext {
+    /**
+     * ANSI color helpers: picocolors-style stylers (`color.bold`,
+     * `color.cyan`, ...) plus Bunti's RGB helpers (`color.fg(value, text)`,
+     * `color.bg`, `color.rgb`, `color.darken`, `color.lighten`).
+     */
+    color: BuntiColor & {
+        darken: typeof darken;
+        lighten: typeof lighten;
+        rgb: typeof rgb;
+        fg: typeof fg;
+        bg: typeof bg;
+    };
+    /** The underlying screen state (buffers, options, input). Advanced use. */
+    state: ScreenState;
+    /** Width of the current context area in cells. */
+    width: number;
+    /** Height of the current context area in cells (rows). */
+    height: number;
+    /** The current context area as an absolute Rect. */
+    area: Rect;
+    /** True on the top-level screen context (false inside box/layer closures). */
+    isRoot: boolean;
+    /** Absolute column of this context's origin (for `blit`/`rect` math). */
+    offsetX: number;
+    /** Absolute row of this context's origin (for `blit`/`rect` math). */
+    offsetY: number;
+    /** Column the text flow ends at on its last line (local). */
+    readonly cursorX: number;
+    /** Row the text flow ends at (local) — where the next text/box lands. */
+    readonly cursorY: number;
+    /** Mouse column (0-based screen cells; requires `mouse: true`). */
+    mouseX: number;
+    /** Mouse row (0-based screen cells; requires `mouse: true`). */
+    mouseY: number;
+    /** Raw SGR button code of the most recent mouse event. */
+    mouseButton: number;
+    /** True while the left mouse button is held down. */
+    isMouseDown: boolean;
+    /**
+     * First unmodified key name of this frame, or undefined when no key
+     * arrived. Printable keys are the literal character ('a', ' '); special
+     * keys are normalized lowercase names ('up', 'enter', 'escape', 'f1');
+     * mouse events arrive as 'click' / 'wheel_up' / 'wheel_down'. Requires
+     * `keyboard: true` in the render options.
+     * @example if (ctx.lastKey === 'q') ctx.requestStop();
+     */
+    lastKey?: string;
+    /**
+     * All KeyEvents of this frame (multiple keys per frame arrive whole),
+     * including ctrl/alt combos and synthetic 'release' events that
+     * `lastKey` never carries. Requires `keyboard: true`.
+     * @example for (const e of ctx.keys) if (e.key === 'enter') submit();
+     */
+    keys: KeyEvent[];
+    /** Id of the currently focused focusable, if any. */
+    focusedId?: string;
+    /**
+     * Milliseconds elapsed since render() started. Drives time-based
+     * animation (fps-independent).
+     * @example const pulse = Math.sin(ctx.elapsedTime / 300);
+     */
+    elapsedTime: number;
+    /**
+     * The env-detected terminal profile (app, version, multiplexer, truecolor,
+     * sync output, Nerd Font policy). Detected once per render().
+     */
+    readonly terminal: TerminalProfile;
+    /**
+     * The active semantic theme for this subtree. Tokens are callable fg
+     * stylers that also carry `.rgb`/`.hex`, so they work as both text
+     * wrappers and color values.
+     * @example ctx.box({ bgColor: ctx.theme.surface }, (s) => s.text(ctx.theme.primary('hi')));
+     */
+    readonly theme: Theme;
+    /**
+     * Swaps the active theme live and requests a rerender. Sparse inputs are
+     * completed via createTheme() derivation.
+     * @example ctx.setTheme(dracula); // from '@zakmandhro/bunti/themes'
+     */
+    setTheme(theme: Theme | ThemeInput): void;
+    /**
+     * Runs the callback with an overridden theme for that subtree only.
+     * Partial inputs overlay the current theme; the previous theme is
+     * restored afterwards.
+     * @example ctx.themed({ primary: '#ff5f87' }, (sub) => sidebar(sub));
+     */
+    themed(theme: Theme | ThemeInput, callback: (sub: BuntiContext) => void): BuntiContext;
+    /**
+     * True if `name` was pressed (or auto-repeated) this frame. Requires
+     * `keyboard: true`.
+     * @example if (ctx.keyPressed('escape')) closeModal();
+     */
+    keyPressed(name: string): boolean;
+    /**
+     * True from a key's first press until its repeat stream expires
+     * (~150ms hold window) — smooth held-key movement on legacy terminals.
+     * @example if (ctx.isKeyHeld('right')) player.x += speed * ctx.dt;
+     */
+    isKeyHeld(name: string): boolean;
+    /**
+     * Appends text to the current flow at the cursor. Supports '\n' and
+     * pre-styled ANSI strings; returns the context for chaining.
+     * @example ctx.text(ctx.color.bold('Status: ')).text('ready\n');
+     */
+    text(str: string | number): BuntiContext;
+    /**
+     * Resolves an icon name to its glyph (Nerd Font, or ASCII fallback on
+     * plain terminals). Pure string return for template-literal safety.
+     * Curated names work out of the box; `import '@zakmandhro/bunti/icons-full'`
+     * unlocks all ~10.7k Nerd Font names.
+     * @example ctx.text(`${ctx.icon('rocket')} Launch`);
+     */
+    icon(name: string): string;
+    /**
+     * Paints a (possibly multi-line, ANSI-styled) string directly into the
+     * screen buffer at absolute cell coordinates — exact-position text,
+     * sprites, labels, and ASCII art.
+     * @example ctx.blit(2, 1, 'FPS 60', { fg: 'gold' });
+     */
+    blit(x: number, y: number, content: string, style?: Partial<Cell>): BuntiContext;
+    /**
+     * Fills a w×h cell rectangle at absolute coordinates with a style —
+     * bars, panels, charts, and backgrounds. Pure-background fills keep the
+     * characters already painted underneath.
+     * @example ctx.rect(0, 0, ctx.width, 3, { bg: ctx.theme.surface });
+     */
+    rect(x: number, y: number, w: number, h: number, style: Partial<Cell>): BuntiContext;
+    /**
+     * Crops a multi-line string to a width×height window starting at
+     * `scrollY` — the primitive for scrollable content.
+     */
+    viewport(content: string, width: number, height: number, scrollY?: number): string;
+    /**
+     * Runs the callback, wraps everything it appended in one color, and
+     * pushes the styled result to the flow. Returns the styled string.
+     */
+    span(options: {
+        color?: string | number | RGB | ((s: string) => string);
+    }, callback: (sub: BuntiContext) => void): string;
+    /**
+     * Draws a styled box and renders the callback inside its padded
+     * interior (a fresh sub-context). At the root, boxes paint directly to
+     * the screen and center unless given x/y; nested boxes join the parent
+     * flow. Returns the rendered string.
+     * @example ctx.box({ width: 40, border: 'rounded', title: 'Log' }, (s) => s.text('...'));
+     */
+    box(options: DSLBoxOptions, callback: (sub: BuntiContext) => void): string;
+    /**
+     * Renders the callback into a transparent buffer composited above the
+     * base content by z-index — THE primitive for modals, HUDs, popovers,
+     * and anything that must overlap other content.
+     * @example ctx.layer(10, (overlay) => overlay.box({ width: 30, height: 5 }, drawModal));
+     */
+    layer(zIndexOrOptions: number | LayerOptions, callback: (sub: BuntiContext) => void): BuntiContext;
+    layer(callback: (sub: BuntiContext) => void): BuntiContext;
+    /** Joins rendered blocks side-by-side, padding each to its own width. */
+    joinHorizontal(...blocks: string[]): string;
+    /** Stacks rendered blocks vertically (skips empty strings). */
+    joinVertical(...blocks: string[]): string;
+    /**
+     * Fills the whole screen background with a color or gradient.
+     * @example ctx.wallpaper(ctx.gradient({ colors: ['midnight', 'plasma'] }));
+     */
+    wallpaper(input: string | number | RGB | ThemeColor | RGB[] | Gradient | {
+        color: any;
+    }): void;
+    /**
+     * Builds a multi-stop Gradient value for `wallpaper`/`bgColor`.
+     * @example ctx.gradient({ colors: ['#0000ff', '#ff0000'], direction: 'horizontal' });
+     */
+    gradient(options: {
+        colors: (string | number | RGB | ThemeColor)[];
+        direction?: 'vertical' | 'horizontal';
+        steps?: number;
+    }): Gradient;
+    /** Builds an RGB color value for truecolor rendering. */
+    rgb(r: number, g: number, b: number): RGB;
+    /**
+     * Frame-persistent state. The keyed form is position-independent; the
+     * keyless form is positional (React-style) and must not be called
+     * conditionally. Setting a value requests a rerender.
+     * @example const [count, setCount] = ctx.useState('count', 0);
+     */
+    useState<T>(initial: T): [T, (val: T) => void];
+    useState<T>(key: string, initial: T): [T, (val: T) => void];
+    /**
+     * Like useState, but the value also persists across app restarts
+     * (stored in .tmp/bunti_store.json).
+     */
+    usePersistentState<T>(key: string, initial: T): [T, (val: T) => void];
+    /**
+     * Registers `id` in the Tab-focus cycle and returns true while it is
+     * focused. The first registered focusable receives initial focus.
+     */
+    focusable(id: string): boolean;
+    /** True while `id` holds focus. */
+    isFocused(id: string): boolean;
+    /** Moves focus to `id`. */
+    focus(id: string): void;
+    /** Advances focus to the next registered focusable (what Tab does). */
+    focusNext(): void;
+    /**
+     * Registers a clickable region and returns its interaction snapshot for
+     * this frame. Requires `mouse: true`.
+     * @example const { hovered, clicked } = ctx.hitbox('save', { x: 2, y: 5, width: 10, height: 1 });
+     */
+    hitbox(id: string, bounds: RectInput): {
+        box: Hitbox;
+        hovered: boolean;
+        pressed: boolean;
+        clicked: boolean;
+    };
+    /**
+     * Resolves a partial rect (percent/fr sizes allowed) against the current
+     * context area into absolute cells. `y` defaults to the flow cursor.
+     */
+    resolveRect(bounds: RectInput): Rect;
+    /**
+     * Places a rect within the current area with alignment defaults
+     * (centered unless overridden) — the same placement `box()` uses.
+     */
+    resolveLocalRect(bounds: PlacedRectInput, options?: PlacedRectOptions): Rect;
+    /**
+     * Splits the current area into tracks from fixed sizes, percentages,
+     * and 'fr' fill units — the layout workhorse for dashboards.
+     * @example const [sidebar, main] = ctx.split({ direction: 'horizontal', constraints: [24, '1fr'] });
+     */
+    split(options: SplitOptions): Rect[];
+    /**
+     * True while the mouse is inside the hitbox registered for `id`.
+     * @example const border = ctx.isHovered('card') ? theme.focus : theme.border;
+     */
+    isHovered(id: string): boolean;
+    /** Mouse currently down inside the hitbox. */
+    isPressed(id: string): boolean;
+    /**
+     * True exactly one frame per click (SGR release at the press origin) —
+     * fire actions here, not on isPressed.
+     * @example if (ctx.isClicked('save')) save();
+     */
+    isClicked(id: string): boolean;
+    /** Hover turned on for this hitbox this frame. */
+    isHoverEnter(id: string): boolean;
+    /** Hover turned off for this hitbox this frame. */
+    isHoverLeave(id: string): boolean;
+    /**
+     * Renders a selectable list with built-in up/down keyboard navigation,
+     * mouse hover/click selection, and theme-token highlighting. Selection
+     * state lives in `useState(`${id}_index`)`.
+     * @example ctx.list('menu', ['Start', 'Options', 'Quit'], { maxVisible: 5 });
+     */
+    list(id: string, items: string[], options?: ListOptions): BuntiContext;
+    /**
+     * Renders rows of cells as an aligned table with shared borders.
+     * @example ctx.table([['NAME', 'STATUS'], ['api', 'ready']], { width: '100%' });
+     */
+    table(rows: string[][], options?: TableOptions): BuntiContext;
+    /**
+     * 0→1 progress over `duration` ms. loop: true wraps, 'yoyo' bounces
+     * 0→1→0. Pass `id` for a restartable clock (restartAnimation).
+     * @example const t = ctx.animate(800, { loop: 'yoyo', easing: easeInOutCubic });
+     */
+    animate(duration: number, options?: {
+        loop?: boolean | 'yoyo';
+        delay?: number;
+        id?: string;
+        easing?: (t: number) => number;
+    }): number;
+    /** Interpolates between two colors at `progress` 0..1, returning RGB. */
+    fade(from: string | number | RGB, to: string | number | RGB, progress: number): RGB;
+    /** Types `text` out over time with a blinking block cursor. */
+    typewriter(text: string, options?: TypewriterOptions): TypewriterState;
+    /** Deterministic time-bucketed flicker (fps-independent). */
+    flicker(intensity?: number, options?: {
+        id?: string;
+        interval?: number;
+    }): boolean;
+    /**
+     * Fetches async data without blocking the render loop: kicks off the
+     * fetcher (re-running every `interval` ms when set) and returns the
+     * latest { data, loading, error } snapshot each frame. Prefer the keyed
+     * form; the keyless form is positional.
+     * @example const { data, loading } = ctx.useAsync('stats', fetchStats, { interval: 5000 });
+     */
+    useAsync<T>(fetcher: () => Promise<T>, options?: {
+        interval?: number;
+    }): {
+        data: T | undefined;
+        loading: boolean;
+        error: Error | undefined;
+    };
+    useAsync<T>(key: string, fetcher: () => Promise<T>, options?: {
+        interval?: number;
+    }): {
+        data: T | undefined;
+        loading: boolean;
+        error: Error | undefined;
+    };
+    /**
+     * Stops the render loop and restores the terminal (the promise returned
+     * by render() then resolves). Also triggered by Ctrl+C.
+     * @example if (ctx.lastKey === 'q') ctx.requestStop();
+     */
+    requestStop(): void;
+    /** Flushes the pending flow to the buffer (called by render(); rare). */
+    flushFlow(): void;
+    /** Milliseconds since the previous frame, clamped to 100 (0 outside loop()). */
+    readonly dt: number;
+    /** Frame counter, incremented once per render tick (0 outside loop()). */
+    readonly frame: number;
+    /**
+     * Enter/exit progress keyed on a visibility flag. progress runs 0→1
+     * (eased) when `visible` turns on and 1→0 when it turns off; `mounted`
+     * stays true through the exit so callers keep rendering while animating
+     * out. THE primitive for modal/panel entrances and exits.
+     * @example const { progress, mounted } = ctx.transition('panel', open, { duration: 200 });
+     */
+    transition(id: string, visible: boolean, options?: {
+        duration?: number;
+        easing?: (t: number) => number;
+        exitDuration?: number;
+    }): {
+        progress: number;
+        mounted: boolean;
+    };
+    /**
+     * Cascading entrance progress: item `index` starts index*delay ms into
+     * the timeline and animates for `duration` ms. Pass `id` to drive it from
+     * an animate()-style clock (restartable via restartAnimation).
+     * @example rows.forEach((row, i) => draw(row, ctx.stagger(i, { delay: 60, duration: 240 })));
+     */
+    stagger(index: number, options: {
+        delay: number;
+        duration: number;
+        easing?: (t: number) => number;
+        id?: string;
+    }): number;
+    /** Resets an animate()/typewriter()/stagger() id clock to "now". */
+    restartAnimation(id: string): void;
+}
+/**
+ * The DSL state container allowing stable references with dynamic capture targets.
+ */
+export interface DSLState {
+    /** Text-flow fragments accumulated for the active capture target. */
+    activeContents: string[];
+    /** Saved capture targets for nested box/span closures. */
+    stack: string[][];
+    /** Layers queued this frame, composited by flushFlow. */
+    layers: RenderLayer[];
+    /** Monotonic tiebreaker so equal z-indexes keep declaration order. */
+    layerOrder: number;
+    /** Stack of subtree theme overrides pushed by ctx.themed(). */
+    themeStack: Theme[];
+    /** Direct-rendered box areas this frame (root only; dev diagnostics). */
+    boxRects?: Rect[];
+}
+/** One queued overlay buffer awaiting composite (see ctx.layer()). */
+export interface RenderLayer {
+    /** Composite order: higher paints later (on top). */
+    zIndex: number;
+    /** Declaration-order tiebreaker for equal z-indexes. */
+    order: number;
+    /** The layer's transparent cell buffer. */
+    buffer: Cell[];
+    /** Composite-time drop shadow under the painted bounds. */
+    shadow?: boolean;
+    /** Composite-time whole-screen dim (0..1) below this layer. */
+    backdrop?: number;
+    /** Tight bounds of the layer's painted cells (null when empty). */
+    bounds: Rect | null;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/dsl/types.js

@@ -0,0 +1,33 @@
+/**
+ * Bunti DSL shared types and constants.
+ */
+/**
+ * Normalized key-name constants for `ctx.lastKey` / `ctx.keyPressed()`.
+ * Printable keys are their literal character ('a', 'A', ' '); mouse events
+ * arrive as the 'click' / 'wheel_up' / 'wheel_down' pseudo-keys.
+ * @example if (ctx.keyPressed(KEYS.ENTER)) submit();
+ */
+export const KEYS = {
+    UP: 'up',
+    DOWN: 'down',
+    RIGHT: 'right',
+    LEFT: 'left',
+    ENTER: 'enter',
+    ESCAPE: 'escape',
+    TAB: 'tab',
+    BACKSPACE: 'backspace',
+    SPACE: ' ',
+    HOME: 'home',
+    END: 'end',
+    DELETE: 'delete',
+    PAGE_UP: 'pageup',
+    PAGE_DOWN: 'pagedown',
+    INSERT: 'insert',
+    /** Left-button click (emitted once, on release; requires `mouse: true`). */
+    CLICK: 'click',
+    /** Mouse wheel scrolled up (requires `mouse: true`). */
+    WHEEL_UP: 'wheel_up',
+    /** Mouse wheel scrolled down (requires `mouse: true`). */
+    WHEEL_DOWN: 'wheel_down',
+};
+//# sourceMappingURL=types.js.map

package/dist/dsl/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/dsl/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAsBH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,IAAI,GAAG;IAClB,EAAE,EAAE,IAAI;IACR,IAAI,EAAE,MAAM;IACZ,KAAK,EAAE,OAAO;IACd,IAAI,EAAE,MAAM;IACZ,KAAK,EAAE,OAAO;IACd,MAAM,EAAE,QAAQ;IAChB,GAAG,EAAE,KAAK;IACV,SAAS,EAAE,WAAW;IACtB,KAAK,EAAE,GAAG;IACV,IAAI,EAAE,MAAM;IACZ,GAAG,EAAE,KAAK;IACV,MAAM,EAAE,QAAQ;IAChB,OAAO,EAAE,QAAQ;IACjB,SAAS,EAAE,UAAU;IACrB,MAAM,EAAE,QAAQ;IAChB,4EAA4E;IAC5E,KAAK,EAAE,OAAO;IACd,wDAAwD;IACxD,QAAQ,EAAE,UAAU;IACpB,0DAA0D;IAC1D,UAAU,EAAE,YAAY;CACzB,CAAC"}

package/dist/dsl.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Bunti High-Level Contextual DSL
+ * Scoped closure API with contextual capabilities via trait-based composition.
+ *
+ * Implementation lives in src/dsl/ — this barrel preserves the public surface:
+ * - context: createDSLContext + box rendering + createScreenContext
+ * - render: the render() entry point
+ * - hooks: useState / useAsync / usePersistentState
+ * - interaction: hitbox / hover / press / click + focus management
+ * - layers: transparent buffers + compositing
+ * - motion: animate / typewriter / flicker / fade
+ * - types: shared interfaces + KEYS
+ */
+export { createScreenContext } from './dsl/context';
+export { render } from './dsl/render';
+export type { BuntiContext, DSLBoxOptions, LayerOptions, TypewriterOptions, TypewriterState, } from './dsl/types';
+export { KEYS } from './dsl/types';
+//# sourceMappingURL=dsl.d.ts.map

package/dist/dsl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dsl.d.ts","sourceRoot":"","sources":["../src/dsl.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,YAAY,EACV,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,iBAAiB,EACjB,eAAe,GAChB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC"}