@zakmandhro/bunti 0.1.5 → 0.2.0

package/dist/dsl.d.ts

@@ -1,159 +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
  */
-import pc from 'picocolors';
-import { bg, darken, fg, type Gradient, lighten, rgb } from './colors';
-import { type PlacedRectInput, type PlacedRectOptions, type Rect, type RectInput, type SplitOptions } from './geometry';
-import { type ListOptions, type SideColors, type StyleOptions, type TableOptions } from './layout';
-import { type Cell, type Hitbox, type RGB, type ScreenOptions, type ScreenState } from './state';
-export declare const KEYS: {
-    UP: string;
-    DOWN: string;
-    RIGHT: string;
-    LEFT: string;
-    ENTER: string;
-    ESCAPE: string;
-    TAB: string;
-    BACKSPACE: string;
-    SPACE: string;
-};
-export interface DSLBoxOptions extends StyleOptions {
-    bgColor?: string | number | RGB | Gradient;
-    color?: string | number | RGB | 'blank';
-    x?: number;
-    y?: number;
-    zIndex?: number;
-    anchor?: 'top' | 'bottom';
-    size?: 'auto' | number;
-    title?: string;
-    titleStyle?: (s: string) => string;
-    id?: string;
-    borderColor?: string | number | RGB | ((s: string) => string) | SideColors;
-    detach?: boolean;
-}
-export interface TypewriterOptions {
-    id?: string;
-    cps?: number;
-    delay?: number;
-    loop?: boolean;
-    cursor?: string;
-    blink?: boolean;
-    blinkRate?: number;
-}
-export interface TypewriterState {
-    text: string;
-    cursor: string;
-    done: boolean;
-    index: number;
-    progress: number;
-}
-export interface LayerOptions {
-    zIndex?: number;
-}
-/**
- * The interface for the contextual builder provided to closures.
- */
-export interface BuntiContext {
-    color: typeof pc & {
-        darken: typeof darken;
-        lighten: typeof lighten;
-        rgb: typeof rgb;
-        fg: typeof fg;
-        bg: typeof bg;
-    };
-    state: ScreenState;
-    width: number;
-    height: number;
-    area: Rect;
-    isRoot: boolean;
-    offsetX: number;
-    offsetY: number;
-    readonly cursorX: number;
-    readonly cursorY: number;
-    mouseX: number;
-    mouseY: number;
-    mouseButton: number;
-    isMouseDown: boolean;
-    lastKey?: string;
-    focusedId?: string;
-    elapsedTime: number;
-    text(str: string | number): BuntiContext;
-    icon(name: string): string;
-    blit(x: number, y: number, content: string, style?: Partial<Cell>): BuntiContext;
-    rect(x: number, y: number, w: number, h: number, style: Partial<Cell>): BuntiContext;
-    viewport(content: string, width: number, height: number, scrollY?: number): string;
-    span(options: {
-        color?: string | number | RGB | ((s: string) => string);
-    }, callback: (sub: BuntiContext) => void): string;
-    box(options: DSLBoxOptions, callback: (sub: BuntiContext) => void): string;
-    layer(zIndexOrOptions: number | LayerOptions, callback: (sub: BuntiContext) => void): BuntiContext;
-    layer(callback: (sub: BuntiContext) => void): BuntiContext;
-    joinHorizontal(...blocks: string[]): string;
-    joinVertical(...blocks: string[]): string;
-    wallpaper(input: string | number | RGB | RGB[] | Gradient | {
-        color: any;
-    }): void;
-    gradient(options: {
-        colors: (string | number | RGB)[];
-        direction?: 'vertical' | 'horizontal';
-        steps?: number;
-    }): Gradient;
-    rgb(r: number, g: number, b: number): RGB;
-    useState<T>(initial: T): [T, (val: T) => void];
-    useState<T>(key: string, initial: T): [T, (val: T) => void];
-    usePersistentState<T>(key: string, initial: T): [T, (val: T) => void];
-    focusable(id: string): boolean;
-    isFocused(id: string): boolean;
-    focus(id: string): void;
-    focusNext(): void;
-    hitbox(id: string, bounds: RectInput): {
-        box: Hitbox;
-        hovered: boolean;
-        pressed: boolean;
-        clicked: boolean;
-    };
-    resolveRect(bounds: RectInput): Rect;
-    resolveLocalRect(bounds: PlacedRectInput, options?: PlacedRectOptions): Rect;
-    split(options: SplitOptions): Rect[];
-    isHovered(id: string): boolean;
-    isPressed(id: string): boolean;
-    isClicked(id: string): boolean;
-    list(id: string, items: string[], options?: ListOptions): BuntiContext;
-    table(rows: string[][], options?: TableOptions): BuntiContext;
-    animate(duration: number, options?: {
-        loop?: boolean;
-        delay?: number;
-        id?: string;
-    }): number;
-    fade(from: string | number | RGB, to: string | number | RGB, progress: number): RGB;
-    typewriter(text: string, options?: TypewriterOptions): TypewriterState;
-    flicker(intensity?: number): boolean;
-    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;
-    };
-    requestStop(): void;
-    flushFlow(): void;
-}
-/**
- * Top-level Screen Context
- */
-export declare function createScreenContext(state: ScreenState): BuntiContext;
-/**
- * Primary Entry Point
- */
-export declare function render(callback: ((b: BuntiContext) => void) | string, options?: ScreenOptions & {
-    once?: boolean;
-}): Promise<void>;
+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

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