@mnmal-ai/surface-core 0.0.0 → 0.14.5

package/dist/overlay.d.ts

@@ -0,0 +1,27 @@
+/**
+ * One panel at a time, by construction. The open panel is one value, a tagged union, so
+ * opening any panel closes whichever was open and two can never stack. The component keeps
+ * per-panel views of it (`panelOf`) and per-panel setters (`setPanel`) with React's own
+ * contract: a value or an updater, `null` to close.
+ */
+/** The open panel: which one, and its state. `null` when none is. */
+export type Overlay<P> = {
+    [K in keyof P]: {
+        kind: K;
+        panel: P[K];
+    };
+}[keyof P] | null;
+/** A panel's state when it is the one open, else `null`. */
+export declare function panelOf<P, K extends keyof P>(o: Overlay<P>, kind: K): P[K] | null;
+/**
+ * The overlay after one panel's setter ran. The updater sees this panel's state, or `null`
+ * when another panel (or none) is open, exactly as a per-panel `useState` would have shown it.
+ *
+ * - A value opens this panel and replaces whatever was open.
+ * - `null` closes this panel only if it is the one open. Closing a panel that is not open
+ *   must not close the one that is.
+ * - An updater returning what it was given changes nothing. That is how a slow read landing
+ *   for a panel that has since closed, or been replaced, is dropped.
+ */
+export declare function setPanel<P, K extends keyof P>(o: Overlay<P>, kind: K, next: P[K] | null | ((current: P[K] | null) => P[K] | null)): Overlay<P>;
+//# sourceMappingURL=overlay.d.ts.map

package/dist/overlay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"overlay.d.ts","sourceRoot":"","sources":["../src/overlay.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,qEAAqE;AACrE,MAAM,MAAM,OAAO,CAAC,CAAC,IAAI;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG;QAAE,IAAI,EAAE,CAAC,CAAC;QAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,CAAA;KAAE;CAAE,CAAC,MAAM,CAAC,CAAC,GAAG,IAAI,CAAC;AAEtF,4DAA4D;AAC5D,wBAAgB,OAAO,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAEjF;AAED;;;;;;;;;GASG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,CAAC,EAC3C,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,EACb,IAAI,EAAE,CAAC,EACP,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAC1D,OAAO,CAAC,CAAC,CAAC,CAOZ"}

package/dist/palette.d.ts

@@ -0,0 +1,38 @@
+import type { CommandSpec } from './module.js';
+type AnyCommand = CommandSpec<unknown>;
+/** The palette's filter text: the draft after a leading '/', until the name ends. */
+export declare function paletteQuery(draft: string): string | null;
+export interface PaletteRow {
+    readonly cmd: AnyCommand;
+    /** True when the name starts with the query; false when it only contains it. */
+    readonly prefix: boolean;
+}
+/** Prefix matches first, then substring-only, each group alphabetical. Case-insensitive. */
+export declare function paletteRows(commands: readonly AnyCommand[], query: string): PaletteRow[];
+export declare function paletteMatches(commands: readonly AnyCommand[], query: string): AnyCommand[];
+/**
+ * The command Enter runs, or null when the line should be sent as typed. A substring-only row
+ * runs only after the user moved onto it: Enter on a typo must never run a different command.
+ */
+export declare function enterRuns(rows: readonly PaletteRow[], selected: number, moved: boolean): AnyCommand | null;
+export declare function moveSelection(selected: number, delta: number, count: number): number;
+export declare function clampSelection(selected: number, count: number): number;
+export declare function completeDraft(c: AnyCommand): string;
+export declare function commandUsage(c: AnyCommand): string;
+export declare function parseCommandLine(line: string): {
+    name: string;
+    args: string[];
+} | null;
+/** Width of the palette's name column. */
+export declare const MENU_NAME_WIDTH = 22;
+/**
+ * The slice of a menu `height` rows tall, centred on the selection so moving keeps it in view, and
+ * the position to show beside ↑↓ when some rows are out of view (empty when every row fits).
+ */
+export declare function menuWindow(count: number, selected: number, height: number): {
+    start: number;
+    end: number;
+    position: string;
+};
+export {};
+//# sourceMappingURL=palette.d.ts.map

package/dist/palette.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"palette.d.ts","sourceRoot":"","sources":["../src/palette.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,KAAK,UAAU,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;AAEvC,qFAAqF;AACrF,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAEzD;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,GAAG,EAAE,UAAU,CAAC;IACzB,gFAAgF;IAChF,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC1B;AAED,4FAA4F;AAC5F,wBAAgB,WAAW,CAAC,QAAQ,EAAE,SAAS,UAAU,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,UAAU,EAAE,CAaxF;AAED,wBAAgB,cAAc,CAAC,QAAQ,EAAE,SAAS,UAAU,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,UAAU,EAAE,CAE3F;AAED;;;GAGG;AACH,wBAAgB,SAAS,CACvB,IAAI,EAAE,SAAS,UAAU,EAAE,EAC3B,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,OAAO,GACb,UAAU,GAAG,IAAI,CAInB;AAED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAGpF;AAED,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAEtE;AAED,wBAAgB,aAAa,CAAC,CAAC,EAAE,UAAU,GAAG,MAAM,CAEnD;AAED,wBAAgB,YAAY,CAAC,CAAC,EAAE,UAAU,GAAG,MAAM,CAGlD;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,GAAG,IAAI,CAQtF;AAED,0CAA0C;AAC1C,eAAO,MAAM,eAAe,KAAK,CAAC;AAElC;;;GAGG;AACH,wBAAgB,UAAU,CACxB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,GACb;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAKlD"}

package/dist/pure.d.ts

@@ -0,0 +1,16 @@
+export { applyInput } from './apply-input.js';
+export { applySuggestion, mergeCompletions } from './complete.js';
+export { assertComposes, CompositionError, composeModules, RESERVED_GLOBAL_KEYS, type Registry } from './compose.js';
+export { atEnd, type Draft, type EditKeys, EMPTY_DRAFT, editKey, insertChunk, maskDraft, pasteToLine, wordLeft, wordRight } from './editor.js';
+export { CTRL_C_WINDOW_MS, ctrlC } from './exit-chord.js';
+export { EMPTY_HISTORY, HISTORY_MAX, type HistoryState, mayWalk, remember, settle, walk } from './history.js';
+export { normaliseKeySpec } from './key-spec.js';
+export { type KeyState, keySpecOf, type Route, resolveKey } from './keys.js';
+export { type ArgSpec, type Armed, type Chip, type CommandSpec, type Completer, type ConfirmBinding, defineModule, type GlobalBinding, type Key, type KeySpec, type ModuleCtx, type ModuleSpec, type PanelDef, type PresenceSpec, type RailItem, type Renderer, type Reply, type Size, type SubmitOptions, type Suggestion, type TuiEvents, type TuiModule, type TurnContext, type TurnHandler, type TurnPhase, type TurnUpdate } from './module.js';
+export { type Overlay, panelOf, setPanel } from './overlay.js';
+export { clampSelection, commandUsage, completeDraft, enterRuns, MENU_NAME_WIDTH, menuWindow, moveSelection, type PaletteRow, paletteMatches, paletteQuery, paletteRows, parseCommandLine } from './palette.js';
+export { type InputRoute, routeInput } from './route-input.js';
+export { sanitise } from './sanitise.js';
+export { anchorPadding, CLEAR_PANE, DEFAULT_GROUND, groundSequence, type LiveMeasure, liveShrink, type PrepareTerminalOptions, prepareSequence, prepareTerminal, RESET_GROUND, reflowSequence, type TerminalOut, type TerminalProcess } from './terminal.js';
+export { type AnswerEntry, type AppEntry, type AskEntry, addGap, answerEntry, arriveTurn, commitEntry, type Entry, emptyTranscript, type Flight, type GapEntry, heldAsks, markedFlights, type NoteEntry, sendTurn, type Transcript } from './transcript.js';
+//# sourceMappingURL=pure.d.ts.map

package/dist/pure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pure.d.ts","sourceRoot":"","sources":["../src/pure.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAClE,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,oBAAoB,EACpB,KAAK,QAAQ,EACd,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,KAAK,EACL,KAAK,KAAK,EACV,KAAK,QAAQ,EACb,WAAW,EACX,OAAO,EACP,WAAW,EACX,SAAS,EACT,WAAW,EACX,QAAQ,EACR,SAAS,EACV,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,gBAAgB,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,EACL,aAAa,EACb,WAAW,EACX,KAAK,YAAY,EACjB,OAAO,EACP,QAAQ,EACR,MAAM,EACN,IAAI,EACL,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,KAAK,QAAQ,EAAE,SAAS,EAAE,KAAK,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAC7E,OAAO,EACL,KAAK,OAAO,EACZ,KAAK,KAAK,EACV,KAAK,IAAI,EACT,KAAK,WAAW,EAChB,KAAK,SAAS,EACd,KAAK,cAAc,EACnB,YAAY,EACZ,KAAK,aAAa,EAClB,KAAK,GAAG,EACR,KAAK,OAAO,EACZ,KAAK,SAAS,EACd,KAAK,UAAU,EACf,KAAK,QAAQ,EACb,KAAK,YAAY,EACjB,KAAK,QAAQ,EACb,KAAK,QAAQ,EACb,KAAK,KAAK,EACV,KAAK,IAAI,EACT,KAAK,aAAa,EAClB,KAAK,UAAU,EACf,KAAK,SAAS,EACd,KAAK,SAAS,EACd,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,SAAS,EACd,KAAK,UAAU,EAChB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,KAAK,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAC/D,OAAO,EACL,cAAc,EACd,YAAY,EACZ,aAAa,EACb,SAAS,EACT,eAAe,EACf,UAAU,EACV,aAAa,EACb,KAAK,UAAU,EACf,cAAc,EACd,YAAY,EACZ,WAAW,EACX,gBAAgB,EACjB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,KAAK,UAAU,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC/D,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EACL,aAAa,EACb,UAAU,EACV,cAAc,EACd,cAAc,EACd,KAAK,WAAW,EAChB,UAAU,EACV,KAAK,sBAAsB,EAC3B,eAAe,EACf,eAAe,EACf,YAAY,EACZ,cAAc,EACd,KAAK,WAAW,EAChB,KAAK,eAAe,EACrB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,QAAQ,EACb,KAAK,QAAQ,EACb,MAAM,EACN,WAAW,EACX,UAAU,EACV,WAAW,EACX,KAAK,KAAK,EACV,eAAe,EACf,KAAK,MAAM,EACX,KAAK,QAAQ,EACb,QAAQ,EACR,aAAa,EACb,KAAK,SAAS,EACd,QAAQ,EACR,KAAK,UAAU,EAChB,MAAM,iBAAiB,CAAC"}

package/dist/pure.js

@@ -0,0 +1,3 @@
+import { $ as wordRight, A as moveSelection, B as remember, D as completeDraft, E as commandUsage, F as keySpecOf, G as EMPTY_DRAFT, H as walk, I as resolveKey, K as atEnd, L as EMPTY_HISTORY, M as paletteQuery, N as paletteRows, O as enterRuns, P as parseCommandLine, Q as wordLeft, R as HISTORY_MAX, S as routeInput, T as clampSelection, U as CTRL_C_WINDOW_MS, V as settle, W as ctrlC, X as maskDraft, Y as insertChunk, Z as pasteToLine, _ as liveShrink, a as answerEntry, at as normaliseKeySpec, b as reflowSequence, c as emptyTranscript, d as sendTurn, et as applyInput, f as CLEAR_PANE, g as groundSequence, h as anchorPadding, i as addGap, it as composeModules, j as paletteMatches, k as menuWindow, l as heldAsks, m as RESET_GROUND, n as setPanel, nt as RESERVED_GLOBAL_KEYS, o as arriveTurn, ot as applySuggestion, p as DEFAULT_GROUND, q as editKey, r as defineModule, rt as assertComposes, s as commitEntry, st as mergeCompletions, t as panelOf, tt as CompositionError, u as markedFlights, v as prepareSequence, w as MENU_NAME_WIDTH, x as sanitise, y as prepareTerminal, z as mayWalk } from "./overlay-DIAFXlMT.js";
+
+export { CLEAR_PANE, CTRL_C_WINDOW_MS, CompositionError, DEFAULT_GROUND, EMPTY_DRAFT, EMPTY_HISTORY, HISTORY_MAX, MENU_NAME_WIDTH, RESERVED_GLOBAL_KEYS, RESET_GROUND, addGap, anchorPadding, answerEntry, applyInput, applySuggestion, arriveTurn, assertComposes, atEnd, clampSelection, commandUsage, commitEntry, completeDraft, composeModules, ctrlC, defineModule, editKey, emptyTranscript, enterRuns, groundSequence, heldAsks, insertChunk, keySpecOf, liveShrink, markedFlights, maskDraft, mayWalk, menuWindow, mergeCompletions, moveSelection, normaliseKeySpec, paletteMatches, paletteQuery, paletteRows, panelOf, parseCommandLine, pasteToLine, prepareSequence, prepareTerminal, reflowSequence, remember, resolveKey, routeInput, sanitise, sendTurn, setPanel, settle, walk, wordLeft, wordRight };

package/dist/route-input.d.ts

@@ -0,0 +1,28 @@
+import type { Registry } from './compose.js';
+import type { CommandSpec, TurnHandler } from './module.js';
+export type InputRoute = {
+    readonly kind: 'command';
+    readonly module: string;
+    readonly spec: CommandSpec<unknown>;
+    readonly args: string[];
+} | {
+    readonly kind: 'unknown-command';
+    readonly name: string;
+} | {
+    readonly kind: 'unavailable-command';
+    readonly name: string;
+    readonly reason: string;
+} | {
+    readonly kind: 'turn';
+    readonly module: string;
+    readonly handler: TurnHandler<unknown>;
+} | {
+    readonly kind: 'no-handler';
+};
+/**
+ * A command's `unavailable` reason, or null. A throwing thunk, or an empty reason, is unavailable
+ * with the reason `unavailable`; an undefined one (a loose JS consumer) is available.
+ */
+export declare function unavailableReason(spec: CommandSpec<unknown>): string | null;
+export declare function routeInput(line: string, registry: Registry, defaultTurn?: string): InputRoute;
+//# sourceMappingURL=route-input.d.ts.map

package/dist/route-input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-input.d.ts","sourceRoot":"","sources":["../src/route-input.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAG5D,MAAM,MAAM,UAAU,GAClB;IACE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC;CACzB,GACD;IAAE,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC3D;IAAE,QAAQ,CAAC,IAAI,EAAE,qBAAqB,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACxF;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC,OAAO,CAAC,CAAA;CAAE,GAC1F;IAAE,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAA;CAAE,CAAC;AAWpC;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,WAAW,CAAC,OAAO,CAAC,GAAG,MAAM,GAAG,IAAI,CAS3E;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,UAAU,CAqB7F"}

package/dist/sanitise.d.ts

@@ -0,0 +1,3 @@
+/** Strips ESC sequences and C0/C1 control characters; keeps `\n`, and a tab becomes a space. */
+export declare function sanitise(text: string): string;
+//# sourceMappingURL=sanitise.d.ts.map

package/dist/sanitise.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sanitise.d.ts","sourceRoot":"","sources":["../src/sanitise.ts"],"names":[],"mappings":"AAWA,gGAAgG;AAChG,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAO7C"}

package/dist/terminal.d.ts

@@ -0,0 +1,70 @@
+import { DEFAULT_GROUND } from '@mnmal-ai/surface-theme';
+export { DEFAULT_GROUND };
+/**
+ * OSC 11 sets the terminal's default background, so every cell written without one — prose and
+ * the empty space around it — sits on it; Ink could only colour what it draws. `none` (or an
+ * empty value) leaves the terminal's background alone. Only `#rrggbb` is accepted: anything else
+ * inside an OSC is an escape-injection seam into the operator's terminal, so it is dropped.
+ */
+export declare function groundSequence(ground: string | undefined): string | null;
+/** OSC 111: restore the terminal's configured background. */
+export declare const RESET_GROUND = "\u001B]111\u0007";
+/** Erase the visible pane (2J) and its scrollback (3J), cursor home. */
+export declare const CLEAR_PANE = "\u001B[2J\u001B[3J\u001B[H";
+/**
+ * Blank lines that put the cursor on the last row before the first frame, so the input is
+ * bottom-anchored: Ink draws its live region where the cursor is, and printed turns then push the
+ * pane up rather than the input down.
+ */
+export declare function anchorPadding(rows: number | undefined): string;
+/**
+ * What a re-lay writes before the transcript is printed again: the pane and its scrollback wiped,
+ * then the input anchored to the last row. A resize cannot be patched, only redone — what `Static`
+ * printed was laid out at the old width — and a closed panel left the conversation scrolled up,
+ * which a terminal cannot scroll back down. The cost: scrollback from before the session goes too.
+ */
+export declare function reflowSequence(rows: number | undefined): string;
+/** The live region as last measured: its height, the entries printed above it, the layout epoch. */
+export interface LiveMeasure {
+    readonly height: number;
+    readonly committed: number;
+    readonly epoch: number;
+}
+/**
+ * Rows the live region just gave up with nothing printed above it — rows that would otherwise open
+ * up below the input. Ink redraws its live region from where it began, so when it shrinks the input
+ * rises; printing that many blank rows above it scrolls the pane back. Zero when something was
+ * printed in the same step (the print scrolled the pane already) or after a re-lay (which anchors
+ * on its own).
+ */
+export declare function liveShrink(prev: LiveMeasure | null, now: LiveMeasure): number;
+export interface PrepareTerminalOptions {
+    /** `#rrggbb`, or `none` to leave the background alone. Default {@link DEFAULT_GROUND}. */
+    readonly ground?: string | undefined;
+    /** Wipe the pane and its scrollback first. Default true. */
+    readonly clear?: boolean;
+    /** Bottom-anchor the input. Default true. */
+    readonly anchor?: boolean;
+}
+export interface TerminalOut {
+    readonly isTTY?: boolean;
+    readonly rows?: number;
+    write(chunk: string): unknown;
+}
+/** The bytes {@link prepareTerminal} writes, in order. */
+export declare function prepareSequence(rows: number | undefined, opts?: PrepareTerminalOptions): string;
+/** The process hooks {@link prepareTerminal} needs; injectable for tests. */
+export interface TerminalProcess {
+    once(event: 'exit', listener: () => void): unknown;
+    once(event: 'SIGHUP' | 'SIGTERM' | 'SIGINT', listener: () => void): unknown;
+    exit(code: number): never;
+}
+/**
+ * Ground, clear and anchor the terminal before `render`. Returns a restore function that puts the
+ * terminal's background back. It is also registered on `exit`, and SIGHUP / SIGTERM / SIGINT exit
+ * through it, since their default action kills the process with no `exit` event (under Ink's raw
+ * mode ctrl+c is input, so SIGINT only arrives from outside: `kill -INT`, a supervisor, tmux).
+ * A terminal left black is worse than any rendering bug. A no-op off a TTY.
+ */
+export declare function prepareTerminal(out: TerminalOut, opts?: PrepareTerminalOptions, proc?: TerminalProcess): () => void;
+//# sourceMappingURL=terminal.d.ts.map

package/dist/terminal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal.d.ts","sourceRoot":"","sources":["../src/terminal.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAEzD,OAAO,EAAE,cAAc,EAAE,CAAC;AAE1B;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAKxE;AAED,6DAA6D;AAC7D,eAAO,MAAM,YAAY,qBAAiB,CAAC;AAE3C,wEAAwE;AACxE,eAAO,MAAM,UAAU,+BAAyB,CAAC;AAEjD;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAG9D;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAE/D;AAED,oGAAoG;AACpG,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,EAAE,GAAG,EAAE,WAAW,GAAG,MAAM,CAG7E;AAED,MAAM,WAAW,sBAAsB;IACrC,0FAA0F;IAC1F,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,4DAA4D;IAC5D,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,6CAA6C;IAC7C,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;CAC/B;AAED,0DAA0D;AAC1D,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,IAAI,GAAE,sBAA2B,GAChC,MAAM,CAMR;AAED,6EAA6E;AAC7E,MAAM,WAAW,eAAe;IAC9B,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC;IACnD,IAAI,CAAC,KAAK,EAAE,QAAQ,GAAG,SAAS,GAAG,QAAQ,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC;IAC5E,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,CAAC;CAC3B;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,GAAG,EAAE,WAAW,EAChB,IAAI,GAAE,sBAA2B,EACjC,IAAI,GAAE,eAAyB,GAC9B,MAAM,IAAI,CAeZ"}

package/dist/transcript.d.ts

@@ -0,0 +1,63 @@
+import type { Tone } from '@mnmal-ai/surface-theme';
+export interface AskEntry {
+    readonly key: string;
+    readonly kind: 'ask';
+    readonly question: string;
+    readonly mark: number | null;
+    readonly emphasis?: string;
+}
+export interface AnswerEntry<R> {
+    readonly key: string;
+    readonly kind: 'answer';
+    readonly question: string;
+    readonly reply: R;
+    readonly mark: number | null;
+    /** The far side started this line (a greeting, an offer); it answers no question. */
+    readonly unprompted?: boolean;
+    /** When an unprompted line landed, epoch ms. */
+    readonly at?: number;
+}
+/** The surface speaking, not the conversation: a command's reply. */
+export interface NoteEntry {
+    readonly key: string;
+    readonly kind: 'note';
+    readonly text: string;
+    readonly tone?: Tone;
+}
+/** Blank rows printed so the input returns to the bottom after the live region shrinks. */
+export interface GapEntry {
+    readonly key: string;
+    readonly kind: 'gap';
+    readonly lines: number;
+    readonly epoch: number;
+}
+export type AppEntry = {
+    readonly key: string;
+    readonly kind: string;
+};
+export type Entry<R, X extends AppEntry = never> = AskEntry | AnswerEntry<R> | NoteEntry | GapEntry | X;
+export interface Flight {
+    readonly id: number;
+    readonly question: string;
+    /** Null while the ask is held; set when a later answer overtook it and it was printed. */
+    readonly mark: number | null;
+    readonly emphasis?: string;
+}
+export interface Transcript<R, X extends AppEntry = never> {
+    /** Append-only: exactly what Static requires. */
+    readonly committed: readonly Entry<R, X>[];
+    /** Unanswered turns, in send order. */
+    readonly flights: readonly Flight[];
+    /** Marks number up for the whole session and never reset. */
+    readonly nextMark: number;
+}
+export declare function emptyTranscript<R, X extends AppEntry = never>(): Transcript<R, X>;
+export declare function sendTurn<R, X extends AppEntry>(t: Transcript<R, X>, id: number, question: string, emphasis?: string): Transcript<R, X>;
+export declare function arriveTurn<R, X extends AppEntry>(t: Transcript<R, X>, id: number, reply: R): Transcript<R, X>;
+export declare function heldAsks<R, X extends AppEntry>(t: Transcript<R, X>): readonly Flight[];
+export declare function markedFlights<R, X extends AppEntry>(t: Transcript<R, X>): readonly Flight[];
+export declare function commitEntry<R, X extends AppEntry>(t: Transcript<R, X>, entry: Entry<R, NoInfer<X>>): Transcript<R, X>;
+/** The last answer printed, or the one carrying mark `n`. */
+export declare function answerEntry<R, X extends AppEntry>(t: Transcript<R, X>, mark: number | null): AnswerEntry<R> | null;
+export declare function addGap<R, X extends AppEntry>(t: Transcript<R, X>, lines: number, epoch: number): Transcript<R, X>;
+//# sourceMappingURL=transcript.d.ts.map

package/dist/transcript.d.ts.map

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

package/package.json

@@ -1,7 +1,57 @@
 {
   "name": "@mnmal-ai/surface-core",
-  "version": "0.0.0",
-  "description": "Reserved by MNMAL. Not yet released.",
+  "version": "0.14.5",
+  "description": "Pluggable terminal UI base on Ink 7 + React 19: module registry, createApp, the turn engine and the shell.",
   "license": "Apache-2.0",
-  "files": ["README.md"]
-}
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mnmal-ai/surface.git",
+    "directory": "packages/surface-core"
+  },
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./pure": {
+      "types": "./dist/pure.d.ts",
+      "import": "./dist/pure.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@mnmal-ai/surface-kit": "0.14.5",
+    "@mnmal-ai/surface-theme": "0.14.5"
+  },
+  "peerDependencies": {
+    "ink": "^7.1.1",
+    "react": "^19.3.0"
+  },
+  "devDependencies": {
+    "@mnmal-ai/substrate-config": "1.0.0-alpha.0",
+    "@types/node": "^26.6.4",
+    "@types/react": "^19.2.0",
+    "ink": "^7.1.1",
+    "ink-testing-library": "^4.0.0",
+    "react": "^19.3.0",
+    "tsdown": "^0.23.0",
+    "typescript": "^7.0.2",
+    "vitest": "^5.0.3"
+  },
+  "engines": {
+    "node": ">=26.2.0"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/",
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsdown && tsc -p tsconfig.dts.json",
+    "test": "vitest run",
+    "check-types": "tsc -p tsconfig.json --noEmit",
+    "lint": "biome check ."
+  }
+}