@sigx/terminal-zero 0.5.0

package/dist/shared/index.js

@@ -0,0 +1,2 @@
+import { A as e, B as t, C as n, D as r, E as i, F as a, G as o, H as s, I as c, J as l, K as u, L as d, M as f, N as p, O as m, P as h, R as g, S as _, T as v, U as y, V as b, W as x, _ as S, a as C, b as w, c as T, d as E, f as D, g as O, h as k, i as A, j, k as M, l as N, m as P, n as F, o as I, p as L, q as R, r as z, s as B, t as V, u as H, v as U, w as W, x as G, y as K, z as q } from "../shared-h5p-EcZV.js";
+export { V as GLYPHS, F as PRESS_MS, z as READY_DELAY_MS, A as SPINNERS, b as TICK_MS, C as charWidth, M as createViewStack, e as cursorToRowCol, j as deleteAt, f as deleteBefore, I as dispatchKey, B as displayWidth, T as focus, N as focusNext, H as focusPrev, E as focusState, m as generateQR, D as getColorDepth, L as getOutputTarget, P as getTerminalSize, s as getTick, x as gradient, k as hexToSGR, o as hueShift, p as insertAt, h as layoutText, u as mixHex, a as moveLeft, c as moveLineEnd, d as moveLineStart, g as moveRight, q as moveVertical, O as onKey, R as parseHex, S as printStatic, U as registerFocusable, K as renderTerminal, w as resolveBg, G as resolveFg, l as rgbToHex, t as rowColToCursor, _ as setScreenBackground, n as setScreenForeground, y as subscribeTicker, W as syncTerminalSize, v as truncateToWidth, i as unregisterFocusable, r as writeStatic };

package/dist/shared/qr.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Generate a QR code string for terminal display.
+ * Uses Unicode half-block characters (▀▄█ ) to render 2 rows per line.
+ *
+ * @param text - The text/URL to encode
+ * @param opts - Options: quiet zone width, colors
+ * @returns Multi-line string ready for console.log()
+ */
+export declare function generateQR(text: string, opts?: {
+    quiet?: number;
+    invert?: boolean;
+}): string;

package/dist/shared/textBuffer.d.ts

@@ -0,0 +1,59 @@
+export interface TextBufferState {
+    text: string;
+    /** Code-point index, 0..codePointLength(text). */
+    cursor: number;
+}
+export interface TextRow {
+    text: string;
+    /** Code-point offset of the row's first character in the full text. */
+    start: number;
+    /** Exclusive end offset; excludes the `\n` on hard rows. */
+    end: number;
+    /** True when the row ends at an explicit newline (or end of text). */
+    hard: boolean;
+}
+export interface TextLayout {
+    rows: TextRow[];
+    width: number;
+}
+/**
+ * Soft-wrap `text` at `width` display cells. Explicit `\n` always breaks a
+ * row (hard). Overlong rows break at the last space when one exists in the
+ * row, otherwise hard-break mid-word. Empty text yields one empty row.
+ */
+export declare function layoutText(text: string, width: number): TextLayout;
+/**
+ * Map a cursor (code-point index) to its visual row and column (cells).
+ * A cursor sitting exactly on a soft-wrap boundary maps to the start of the
+ * NEXT row — except at the very end of the text, where it stays on the last.
+ */
+export declare function cursorToRowCol(layout: TextLayout, cursor: number): {
+    row: number;
+    col: number;
+};
+/**
+ * Map a visual (row, goalCol) back to a cursor index. A goal column landing
+ * inside a wide glyph snaps to the glyph start; beyond the row end clamps to
+ * the row end.
+ */
+export declare function rowColToCursor(layout: TextLayout, row: number, goalCol: number): number;
+export declare function insertAt(state: TextBufferState, chunk: string): TextBufferState;
+/** Backspace: delete the code point before the cursor. */
+export declare function deleteBefore(state: TextBufferState): TextBufferState;
+/** Forward delete: delete the code point under the cursor. */
+export declare function deleteAt(state: TextBufferState): TextBufferState;
+export declare function moveLeft(state: TextBufferState): TextBufferState;
+export declare function moveRight(state: TextBufferState): TextBufferState;
+/**
+ * Move the cursor a visual row up (-1) or down (+1), keeping a sticky goal
+ * column: pass the previous call's `goalCol` back in while the user keeps
+ * moving vertically (any horizontal move/edit resets it — caller's job).
+ */
+export declare function moveVertical(state: TextBufferState, width: number, dir: -1 | 1, goalCol?: number): {
+    state: TextBufferState;
+    goalCol: number;
+};
+/** Jump to the start of the cursor's visual row. */
+export declare function moveLineStart(state: TextBufferState, width: number): TextBufferState;
+/** Jump to the end of the cursor's visual row. */
+export declare function moveLineEnd(state: TextBufferState, width: number): TextBufferState;

package/dist/shared/ticker.d.ts

@@ -0,0 +1,9 @@
+/** Global animation granularity, ms. Components derive slower rates from it. */
+export declare const TICK_MS = 80;
+/** Reactive frame counter — read it in a render function to re-render per tick. */
+export declare function getTick(): number;
+/**
+ * Refcounted subscription: the first subscriber starts the interval, the last
+ * unsubscribe stops it. Returns an idempotent unsubscribe function.
+ */
+export declare function subscribeTicker(): () => void;

package/dist/shared/viewStack.d.ts

@@ -0,0 +1,12 @@
+export interface ViewStack<T> {
+    push(view: T): void;
+    /** Pop the current view. Returns false (and stays) at the root. */
+    pop(): boolean;
+    /** Swap the current view without growing the stack. */
+    replace(view: T): void;
+    /** The top of the stack. Reactive. */
+    current(): T;
+    /** Stack size (root = 1). Reactive. */
+    depth(): number;
+}
+export declare function createViewStack<T>(root: T): ViewStack<T>;