@sectile/terminal 0.2.0 → 0.3.0

package/dist/multi-thumb-slider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"multi-thumb-slider.d.ts","sourceRoot":"","sources":["../src/multi-thumb-slider.ts"],"names":[],"mappings":"AAAA,OAAO,EAA0B,KAAK,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAErF,OAAO,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAyB,KAAK,iBAAiB,EAAE,KAAK,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAEzG,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAA4F,KAAK,qBAAqB,EAAE,KAAK,wBAAwB,EAAE,KAAK,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AACnO,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAG3D,MAAM,WAAW,uBAAuB,CAAC,EAAE,SAAS,QAAQ,GAAG,QAAQ,CAAE,SAAQ,iBAAiB;IAChG,QAAQ,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,CAAC;IAC/B,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3C,QAAQ,CAAC,uBAAuB,CAAC,EAAE,EAAE,GAAG,IAAI,CAAC;IAC7C,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,QAAQ,CAAC,EAAE,wBAAwB,CAAC;IAC7C,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,KAAK,IAAI,CAAC;IAC7D,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;CAChC;AAED,MAAM,MAAM,mCAAmC,CAAC,EAAE,SAAS,QAAQ,GAAG,QAAQ,IAAI,WAAW,CAAC,uBAAuB,CAAC,EAAE,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC;AAC7I,MAAM,MAAM,6BAA6B,CAAC,EAAE,SAAS,QAAQ,GAAG,QAAQ,IAAI,WAAW,CAAC,uBAAuB,CAAC,EAAE,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC;AACjI,MAAM,WAAW,gCAAgC,CAAC,EAAE,SAAS,QAAQ,GAAG,QAAQ;IAAI,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IAAC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,EAAE,GAAG,IAAI,CAAA;CAAE;AAC/J,MAAM,WAAW,0BAA0B,CAAC,EAAE,SAAS,QAAQ,GAAG,QAAQ;IACxE,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,WAAW,IAAI,gBAAgB,CAAC,qBAAqB,CAAC,EAAE,CAAC,CAAC,CAAC;IAC3D,SAAS,IAAI,SAAS,MAAM,EAAE,CAAC;IAC/B,oBAAoB,CAAC,MAAM,EAAE,gCAAgC,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,gBAAgB,CAAC,qBAAqB,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACxH,WAAW,CAAC,KAAK,EAAE,qBAAqB,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC;IACvD,mBAAmB,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC;CAC5D;AAED,wBAAgB,sBAAsB,CAAC,EAAE,SAAS,QAAQ,EAAE,OAAO,EAAE,uBAAuB,CAAC,EAAE,CAAC,GAAG,gBAAgB,CAAC,0BAA0B,CAAC,EAAE,CAAC,CAAC,CAElJ;AAED,wBAAgB,yBAAyB,CAAC,EAAE,SAAS,QAAQ,EAAE,OAAO,EAAE,uBAAuB,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,gBAAgB,CAAC,0BAA0B,CAAC,EAAE,CAAC,CAAC,CAAC,CAE7J"}

package/dist/multi-thumb-slider.js

@@ -0,0 +1,67 @@
+import { createFacadeConnection } from './internal/facade.js';
+import { unwrap } from '@sectile/core/result';
+import { tryCreateBoundedRange } from '@sectile/core/range';
+import { tryCreateSequence } from '@sectile/core/sequence';
+import { applyMultiThumbSliderEvent, tryCreateMultiThumbSliderState } from '@sectile/core/multi-thumb-slider';
+import { createSemanticController } from './internal/semantic-controller.js';
+export function createMultiThumbSlider(options) {
+    return unwrap(tryCreateMultiThumbSlider(options));
+}
+export function tryCreateMultiThumbSlider(options) {
+    return createFacadeConnection(options, (options) => tryCreateMultiThumbSliderConnection(options));
+}
+function tryCreateMultiThumbSliderConnection(options) {
+    const thumbs = tryCreateSequence(options.thumbs);
+    if (!thumbs.ok)
+        return thumbs;
+    const range = tryCreateBoundedRange(options);
+    if (!range.ok)
+        return range;
+    const controlled = options.values !== undefined;
+    const runtime = createSemanticController({
+        initial: tryCreateMultiThumbSliderState(thumbs.value, range.value, options.values ?? options.defaultValues ?? options.thumbs.map(() => 0), options.defaultHighlightedValue ?? options.thumbs[0] ?? null, options.policies),
+        reducer: (state, event) => applyMultiThumbSliderEvent(thumbs.value, range.value, state, event, options.policies),
+        reconcile: (previous, proposed) => tryCreateMultiThumbSliderState(thumbs.value, range.value, controlled ? previous.ticks : proposed.ticks, proposed.cursor.current, options.policies),
+        notify: (previous, proposed) => { if (previous.ticks.some((tick, index) => tick !== proposed.ticks[index]))
+            options.onValuesChange?.(proposed.ticks); },
+        toEffect: (command) => command,
+        interaction: options,
+        interactionIntent: multiThumbIntent,
+    });
+    if (!runtime.ok)
+        return runtime;
+    return { ok: true, value: new TerminalMultiThumbSlider(options, thumbs.value, range.value, runtime.value) };
+}
+class TerminalMultiThumbSlider {
+    range;
+    #options;
+    #thumbs;
+    #runtime;
+    constructor(options, thumbs, range, runtime) { this.#options = options; this.#thumbs = thumbs; this.range = range; this.#runtime = runtime; }
+    getSnapshot() { return this.#runtime.getSnapshot(); }
+    getValues() { return Object.freeze(this.getSnapshot().state.ticks.map((tick) => this.range.valueAt(tick))); }
+    syncControlledValues(values) {
+        if (this.#options.values === undefined)
+            return { ok: false, error: { class: 'construction', code: 'not-controlled', message: 'Only a controlled multi-thumb slider can be synchronized.' } };
+        return this.#runtime.replace(tryCreateMultiThumbSliderState(this.#thumbs, this.range, values.values, values.highlightedValue ?? this.getSnapshot().state.cursor.current, this.#options.policies));
+    }
+    handleEvent(event) { const result = this.#runtime.handle(event); if (result.ok)
+        this.#options.onUpdate?.(); return result.ok; }
+    handleKeyboardInput(input) { const event = toMultiThumbSliderEvent(input); return event === null ? false : this.handleEvent(event); }
+}
+function multiThumbIntent(event) { if (typeof event === 'object')
+    return event.type === 'focus' ? 'navigate' : 'mutate'; return event === 'next-thumb' || event === 'previous-thumb' ? 'navigate' : 'mutate'; }
+function toMultiThumbSliderEvent(input) {
+    if (input.key === 'right' || input.key === 'up')
+        return 'increment';
+    if (input.key === 'left' || input.key === 'down')
+        return 'decrement';
+    if (input.key === 'home')
+        return 'home';
+    if (input.key === 'end')
+        return 'end';
+    if (input.key === 'tab')
+        return input.shiftKey ? 'previous-thumb' : 'next-thumb';
+    return null;
+}
+//# sourceMappingURL=multi-thumb-slider.js.map

package/dist/multi-thumb-slider.js.map

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

package/dist/navigation-menu.d.ts

@@ -0,0 +1,8 @@
+import { type FacadeConnection } from './internal/facade.js';
+import type { Result, StableID } from '@sectile/core';
+import { type MenuControl, type MenuControlOptions } from './internal/menu-control.js';
+export type NavigationMenuOptions<ID extends StableID = StableID> = Omit<MenuControlOptions<ID>, 'kind' | 'open' | 'defaultOpen'>;
+export type NavigationMenuConnection<ID extends StableID = StableID> = MenuControl<ID>;
+export declare function createNavigationMenu<ID extends StableID>(options: NavigationMenuOptions<ID>): FacadeConnection<NavigationMenuConnection<ID>>;
+export declare function tryCreateNavigationMenu<ID extends StableID>(options: NavigationMenuOptions<ID>): Result<FacadeConnection<NavigationMenuConnection<ID>>>;
+//# sourceMappingURL=navigation-menu.d.ts.map

package/dist/navigation-menu.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"navigation-menu.d.ts","sourceRoot":"","sources":["../src/navigation-menu.ts"],"names":[],"mappings":"AAAA,OAAO,EAA0B,KAAK,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAErF,OAAO,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAqB,KAAK,WAAW,EAAE,KAAK,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAE1G,MAAM,MAAM,qBAAqB,CAAC,EAAE,SAAS,QAAQ,GAAG,QAAQ,IAAI,IAAI,CAAC,kBAAkB,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,aAAa,CAAC,CAAC;AAClI,MAAM,MAAM,wBAAwB,CAAC,EAAE,SAAS,QAAQ,GAAG,QAAQ,IAAI,WAAW,CAAC,EAAE,CAAC,CAAC;AAEvF,wBAAgB,oBAAoB,CAAC,EAAE,SAAS,QAAQ,EAAE,OAAO,EAAE,qBAAqB,CAAC,EAAE,CAAC,GAAG,gBAAgB,CAAC,wBAAwB,CAAC,EAAE,CAAC,CAAC,CAE5I;AAED,wBAAgB,uBAAuB,CAAC,EAAE,SAAS,QAAQ,EAAE,OAAO,EAAE,qBAAqB,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,gBAAgB,CAAC,wBAAwB,CAAC,EAAE,CAAC,CAAC,CAAC,CAEvJ"}

package/dist/navigation-menu.js

@@ -0,0 +1,10 @@
+import { createFacadeConnection } from './internal/facade.js';
+import { unwrap } from '@sectile/core/result';
+import { createMenuControl } from './internal/menu-control.js';
+export function createNavigationMenu(options) {
+    return unwrap(tryCreateNavigationMenu(options));
+}
+export function tryCreateNavigationMenu(options) {
+    return createFacadeConnection(options, (resolved) => createMenuControl({ ...resolved, kind: 'navigation-menu' }));
+}
+//# sourceMappingURL=navigation-menu.js.map

package/dist/navigation-menu.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"navigation-menu.js","sourceRoot":"","sources":["../src/navigation-menu.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAyB,MAAM,sBAAsB,CAAC;AACrF,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAE9C,OAAO,EAAE,iBAAiB,EAA6C,MAAM,4BAA4B,CAAC;AAK1G,MAAM,UAAU,oBAAoB,CAAsB,OAAkC;IAC1F,OAAO,MAAM,CAAC,uBAAuB,CAAC,OAAO,CAAC,CAAC,CAAC;AAClD,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAsB,OAAkC;IAC7F,OAAO,sBAAsB,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,GAAG,QAAQ,EAAE,IAAI,EAAE,iBAAiB,EAAE,CAAC,CAAC,CAAC;AACpH,CAAC"}

package/dist/node.d.ts

@@ -0,0 +1,43 @@
+import type { ReadStream } from 'node:tty';
+import type { Result } from '@sectile/core';
+import type { TerminalAppearance, TerminalCapabilities } from './appearance.js';
+import type { TerminalKeyboardInput } from './keyboard.js';
+import type { TerminalFrame } from './screen.js';
+export interface NodeKeypress {
+    readonly name?: string;
+    readonly ctrl?: boolean;
+    readonly meta?: boolean;
+    readonly shift?: boolean;
+}
+export interface TTYKeyboard {
+    close(): void;
+}
+export type TTYKeyboardInputHandler = (input: TerminalKeyboardInput) => void;
+export interface NodeTerminalOutput {
+    readonly isTTY?: boolean;
+    readonly columns?: number;
+    readonly rows?: number;
+    write(chunk: string): unknown;
+    getColorDepth?(): number;
+}
+export interface NodeTerminalEnvironment {
+    readonly TERM?: string;
+    readonly COLORTERM?: string;
+    readonly NO_COLOR?: string;
+    readonly FORCE_COLOR?: string;
+}
+export interface TerminalScreenWriterOptions {
+    readonly appearance?: TerminalAppearance;
+    readonly alternateScreen?: boolean;
+    readonly clearOnStart?: boolean;
+}
+export interface TerminalScreenWriter {
+    readonly appearance: TerminalAppearance;
+    render(frame: TerminalFrame | readonly string[]): void;
+    close(): void;
+}
+export declare function toTerminalKeyboardInput(value: string | undefined, keypress: NodeKeypress): TerminalKeyboardInput | null;
+export declare function createTTYKeyboard(input: ReadStream, listener: TTYKeyboardInputHandler): Result<TTYKeyboard>;
+export declare function detectTerminalCapabilities(output: NodeTerminalOutput, environment?: NodeTerminalEnvironment): TerminalCapabilities;
+export declare function createTerminalScreenWriter(output: NodeTerminalOutput, options?: TerminalScreenWriterOptions): TerminalScreenWriter;
+//# sourceMappingURL=node.d.ts.map

package/dist/node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../src/node.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAC3C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,KAAK,EACV,kBAAkB,EAClB,oBAAoB,EAErB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAC3D,OAAO,KAAK,EAAE,aAAa,EAAuB,MAAM,aAAa,CAAC;AAGtE,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,IAAI,IAAI,CAAC;CACf;AAED,MAAM,MAAM,uBAAuB,GAAG,CAAC,KAAK,EAAE,qBAAqB,KAAK,IAAI,CAAC;AAE7E,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;IAC9B,aAAa,CAAC,IAAI,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,UAAU,CAAC,EAAE,kBAAkB,CAAC;IACzC,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,CAAC;IACnC,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;CACjC;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,UAAU,EAAE,kBAAkB,CAAC;IACxC,MAAM,CAAC,KAAK,EAAE,aAAa,GAAG,SAAS,MAAM,EAAE,GAAG,IAAI,CAAC;IACvD,KAAK,IAAI,IAAI,CAAC;CACf;AAED,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,QAAQ,EAAE,YAAY,GACrB,qBAAqB,GAAG,IAAI,CAwB9B;AAED,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,UAAU,EACjB,QAAQ,EAAE,uBAAuB,GAChC,MAAM,CAAC,WAAW,CAAC,CAoCrB;AAED,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,kBAAkB,EAC1B,WAAW,GAAE,uBAAqC,GACjD,oBAAoB,CAYtB;AAED,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,kBAAkB,EAC1B,OAAO,GAAE,2BAAgC,GACxC,oBAAoB,CA+CtB"}

package/dist/node.js

@@ -0,0 +1,196 @@
+import { emitKeypressEvents } from 'node:readline';
+import { createTerminalAppearance } from './appearance.js';
+import { serializeTerminalFrame } from './screen.js';
+export function toTerminalKeyboardInput(value, keypress) {
+    const name = normalizeKeyName(keypress.name);
+    const altKey = keypress.meta === true;
+    const portableEdgeKey = keypress.ctrl === true && name === 'a'
+        ? 'home'
+        : keypress.ctrl === true && name === 'e'
+            ? 'end'
+            : null;
+    const key = portableEdgeKey
+        ?? (altKey && name === 'b'
+            ? 'left'
+            : altKey && name === 'f'
+                ? 'right'
+                : name ?? printableKey(value));
+    if (key === null)
+        return null;
+    const text = printableText(value, keypress);
+    return Object.freeze({
+        key,
+        ...(text === null ? {} : { text }),
+        ...(altKey ? { altKey: true } : {}),
+        ...(keypress.ctrl === true && portableEdgeKey === null ? { ctrlKey: true } : {}),
+        ...(keypress.shift === true ? { shiftKey: true } : {}),
+    });
+}
+export function createTTYKeyboard(input, listener) {
+    if (!input.isTTY || input.setRawMode === undefined) {
+        return {
+            ok: false,
+            error: {
+                class: 'construction',
+                code: 'interactive-tty-required',
+                message: 'Terminal keyboard input requires an interactive TTY.',
+            },
+        };
+    }
+    const wasRaw = input.isRaw;
+    let closed = false;
+    const handleKeypress = (value, keypress) => {
+        const normalized = toTerminalKeyboardInput(value, keypress);
+        if (normalized !== null)
+            listener(normalized);
+    };
+    emitKeypressEvents(input);
+    input.setRawMode(true);
+    input.resume();
+    input.on('keypress', handleKeypress);
+    return {
+        ok: true,
+        value: Object.freeze({
+            close() {
+                if (closed)
+                    return;
+                closed = true;
+                input.off('keypress', handleKeypress);
+                input.setRawMode(wasRaw);
+                input.pause();
+            },
+        }),
+    };
+}
+export function detectTerminalCapabilities(output, environment = process.env) {
+    const forced = parseForcedColor(environment.FORCE_COLOR);
+    const colorLevel = forced
+        ?? (environment.NO_COLOR !== undefined
+            ? 0
+            : output.isTTY === true
+                ? colorLevelFromDepth(output.getColorDepth?.() ?? inferredColorDepth(environment))
+                : 0);
+    return Object.freeze({
+        colorLevel,
+        unicode: output.isTTY === true && environment.TERM !== 'dumb',
+    });
+}
+export function createTerminalScreenWriter(output, options = {}) {
+    const appearance = options.appearance ?? createTerminalAppearance({
+        capabilities: detectTerminalCapabilities(output),
+    });
+    const alternateScreen = options.alternateScreen === true;
+    const clearOnStart = options.clearOnStart !== false;
+    let previous = Object.freeze([]);
+    let closed = false;
+    let started = false;
+    const start = () => {
+        if (started)
+            return;
+        started = true;
+        if (alternateScreen)
+            output.write('\u001b[?1049h');
+        output.write('\u001b[?25l');
+        if (clearOnStart)
+            output.write('\u001b[2J\u001b[H');
+    };
+    return Object.freeze({
+        appearance,
+        render(frame) {
+            if (closed)
+                return;
+            start();
+            const structured = isTerminalFrame(frame);
+            const next = structured ? serializeTerminalFrame(frame, appearance) : frame;
+            const maximumRows = Math.max(previous.length, next.length);
+            let payload = '\u001b[?25l';
+            for (let row = 0; row < maximumRows; row += 1) {
+                const line = next[row] ?? '';
+                if (line === (previous[row] ?? ''))
+                    continue;
+                payload += moveCursor(row, 0);
+                payload += line;
+                payload += '\u001b[K';
+            }
+            payload += cursorSequence(structured ? frame.cursor : null);
+            if (payload !== '\u001b[?25l')
+                output.write(payload);
+            previous = next;
+        },
+        close() {
+            if (closed)
+                return;
+            closed = true;
+            if (started) {
+                output.write(`${appearance.reset}\u001b[?25h${alternateScreen ? '\u001b[?1049l' : ''}`);
+            }
+            previous = Object.freeze([]);
+        },
+    });
+}
+function cursorSequence(cursor) {
+    if (cursor === null || !cursor.visible)
+        return '\u001b[?25l';
+    const shape = cursor.shape === 'bar'
+        ? (cursor.blink ? 5 : 6)
+        : cursor.shape === 'underline'
+            ? (cursor.blink ? 3 : 4)
+            : (cursor.blink ? 1 : 2);
+    return `${moveCursor(cursor.row, cursor.column)}\u001b[${shape} q\u001b[?25h`;
+}
+function moveCursor(row, column) {
+    return `\u001b[${row + 1};${column + 1}H`;
+}
+function parseForcedColor(value) {
+    if (value === undefined)
+        return null;
+    if (value === '' || value === 'true')
+        return 1;
+    if (value === 'false' || value === '0')
+        return 0;
+    const parsed = Number(value);
+    if (!Number.isFinite(parsed))
+        return 1;
+    return Math.max(0, Math.min(3, Math.floor(parsed)));
+}
+function inferredColorDepth(environment) {
+    if (environment.COLORTERM === 'truecolor' || environment.COLORTERM === '24bit')
+        return 24;
+    if (environment.TERM?.includes('256color') === true)
+        return 8;
+    return 4;
+}
+function colorLevelFromDepth(depth) {
+    if (depth >= 24)
+        return 3;
+    if (depth >= 8)
+        return 2;
+    if (depth >= 4)
+        return 1;
+    return 0;
+}
+function isTerminalFrame(value) {
+    return !Array.isArray(value);
+}
+function normalizeKeyName(name) {
+    if (name === undefined)
+        return null;
+    if (name === 'return')
+        return 'enter';
+    if (name === 'pageup')
+        return 'page-up';
+    if (name === 'pagedown')
+        return 'page-down';
+    return name;
+}
+function printableKey(value) {
+    return value !== undefined && value.length > 0 ? value : null;
+}
+function printableText(value, keypress) {
+    if (value === undefined || value.length === 0)
+        return null;
+    if (keypress.ctrl === true || keypress.meta === true)
+        return null;
+    return Array.from(value).every((character) => character >= ' ') ? value : null;
+}
+//# sourceMappingURL=node.js.map

package/dist/node.js.map

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

package/dist/number-field.d.ts

@@ -0,0 +1,47 @@
+import { type FacadeConnection } from './internal/facade.js';
+import type { Result } from '@sectile/core';
+import type { RevisionSnapshot } from '@sectile/core/revision';
+import type { TextEditingState } from '@sectile/core/text';
+import { type NumberFieldEvent, type NumberFieldPolicies, type NumberFieldState } from '@sectile/core/number-field';
+import type { TerminalKeyboardInput } from './keyboard.js';
+export interface NumberFieldValueChangeDetails {
+    readonly value: string | null;
+    readonly expression: string;
+}
+export interface NumberFieldInputStateChangeDetails {
+    readonly value: TextEditingState;
+    readonly previousValue: TextEditingState;
+}
+export interface NumberFieldOptions {
+    readonly policies?: NumberFieldPolicies;
+    readonly value?: string | null;
+    readonly defaultValue?: string | null;
+    readonly inputState?: TextEditingState;
+    readonly defaultInputState?: TextEditingState;
+    readonly disabled?: boolean;
+    readonly readOnly?: boolean;
+    readonly required?: boolean;
+    readonly onValueChange?: (details: NumberFieldValueChangeDetails) => void;
+    readonly onInputStateChange?: (details: NumberFieldInputStateChangeDetails) => void;
+    readonly onUpdate?: () => void;
+}
+export type NumberFieldValueChangeHandler = NonNullable<NumberFieldOptions['onValueChange']>;
+export type NumberFieldInputStateChangeHandler = NonNullable<NumberFieldOptions['onInputStateChange']>;
+export type NumberFieldUpdateHandler = NonNullable<NumberFieldOptions['onUpdate']>;
+export interface NumberFieldControlledValues {
+    readonly value?: string | null;
+    readonly inputState?: TextEditingState;
+}
+export interface NumberFieldConnection {
+    getSnapshot(): RevisionSnapshot<NumberFieldState>;
+    getText(): string;
+    getValue(): string | null;
+    getCaret(): number;
+    syncControlledValues(values: NumberFieldControlledValues): Result<RevisionSnapshot<NumberFieldState>>;
+    handleEvent(event: NumberFieldEvent): boolean;
+    handleKeyboardInput(input: TerminalKeyboardInput): boolean;
+    handleTextInput(text: string): boolean;
+}
+export declare function createNumberField(options?: NumberFieldOptions): FacadeConnection<NumberFieldConnection>;
+export declare function tryCreateNumberField(options?: NumberFieldOptions): Result<FacadeConnection<NumberFieldConnection>>;
+//# sourceMappingURL=number-field.d.ts.map

package/dist/number-field.d.ts.map

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

package/dist/number-field.js

@@ -0,0 +1,157 @@
+import { createFacadeConnection } from './internal/facade.js';
+import { unwrap } from '@sectile/core/result';
+import { applyNumberFieldEvent, tryCreateNumberFieldState, } from '@sectile/core/number-field';
+import { createSemanticController } from './internal/semantic-controller.js';
+import { toTerminalTextInput } from './internal/text-input.js';
+import { toTextEvent } from './text.js';
+export function createNumberField(options = {}) {
+    return unwrap(tryCreateNumberField(options));
+}
+export function tryCreateNumberField(options = {}) {
+    return createFacadeConnection(options, (options) => tryCreateNumberFieldConnection(options));
+}
+function tryCreateNumberFieldConnection(options = {}) {
+    const valueControlled = options.value !== undefined;
+    const inputControlled = options.inputState !== undefined;
+    const required = options.required ?? options.policies?.required;
+    const policies = Object.freeze({
+        ...options.policies,
+        ...(required === undefined ? {} : { required }),
+    });
+    const runtime = createSemanticController({
+        initial: tryCreateNumberFieldState(options.value !== undefined ? options.value : options.defaultValue ?? null, options.inputState !== undefined ? options.inputState : options.defaultInputState),
+        reducer: (state, event) => applyNumberFieldEvent(state, event, policies),
+        reconcile: (previous, proposed) => tryCreateNumberFieldState(valueControlled ? previous.value : proposed.value, inputControlled ? previous.inputState : proposed.inputState),
+        notify: (previous, proposed) => {
+            if (!sameInputState(previous.inputState, proposed.inputState)) {
+                options.onInputStateChange?.(Object.freeze({
+                    value: proposed.inputState,
+                    previousValue: previous.inputState,
+                }));
+            }
+        },
+        toEffect: (command) => command,
+        interaction: options,
+    });
+    return runtime.ok
+        ? { ok: true, value: new TerminalNumberField(options, runtime.value, valueControlled, inputControlled) }
+        : runtime;
+}
+class TerminalNumberField {
+    #options;
+    #runtime;
+    #valueControlled;
+    #inputControlled;
+    constructor(options, runtime, valueControlled, inputControlled) {
+        this.#options = options;
+        this.#runtime = runtime;
+        this.#valueControlled = valueControlled;
+        this.#inputControlled = inputControlled;
+    }
+    getSnapshot() {
+        return this.#runtime.getSnapshot();
+    }
+    getText() {
+        return this.getSnapshot().state.inputState.snapshot.text;
+    }
+    getValue() {
+        return this.getSnapshot().state.value;
+    }
+    getCaret() {
+        return this.getSnapshot().state.inputState.snapshot.selection.focusCodeUnitOffset;
+    }
+    syncControlledValues(values) {
+        if (this.#valueControlled !== (values.value !== undefined)
+            || this.#inputControlled !== (values.inputState !== undefined)) {
+            return { ok: false, error: { class: 'construction', code: 'controlled-shape-mismatch', message: 'Controlled number field values must preserve their construction-time shape.' } };
+        }
+        const state = this.getSnapshot().state;
+        const result = this.#runtime.replace(tryCreateNumberFieldState(this.#valueControlled ? values.value : state.value, this.#inputControlled ? values.inputState : state.inputState));
+        if (result.ok)
+            this.#options.onUpdate?.();
+        return result;
+    }
+    handleEvent(event) {
+        const result = this.#runtime.handle(event);
+        if (result.ok) {
+            for (const command of result.commands) {
+                if (command.type === 'value-committed') {
+                    this.#options.onValueChange?.(Object.freeze({ value: command.value, expression: command.expression }));
+                }
+            }
+            this.#options.onUpdate?.();
+        }
+        return result.ok;
+    }
+    handleKeyboardInput(input) {
+        if (input.ctrlKey === true || input.altKey === true)
+            return false;
+        if (input.key === 'enter')
+            return this.handleEvent('commit');
+        if (input.key === 'escape')
+            return this.handleEvent('cancel');
+        const state = this.getSnapshot().state.inputState;
+        if (input.key === 'left' || input.key === 'right' || input.key === 'home' || input.key === 'end') {
+            return this.#moveSelection(input, state);
+        }
+        const semanticInput = toTerminalTextInput(state, input);
+        if (semanticInput === null)
+            return false;
+        const event = toTextEvent(semanticInput);
+        return event !== null && this.handleEvent({ type: 'text', event });
+    }
+    handleTextInput(text) {
+        if (typeof text !== 'string' || text.length === 0)
+            return false;
+        return this.handleKeyboardInput({ key: text, text });
+    }
+    #moveSelection(input, state) {
+        const snapshot = state.snapshot;
+        const selection = snapshot.selection;
+        let focus;
+        if (input.key === 'home')
+            focus = 0;
+        else if (input.key === 'end')
+            focus = snapshot.text.length;
+        else if (selection.startCodeUnitOffset !== selection.endCodeUnitOffset && input.shiftKey !== true) {
+            focus = input.key === 'left' ? selection.startCodeUnitOffset : selection.endCodeUnitOffset;
+        }
+        else {
+            focus = input.key === 'left'
+                ? previousGraphemeOffset(snapshot.text, selection.focusCodeUnitOffset)
+                : nextGraphemeOffset(snapshot.text, selection.focusCodeUnitOffset);
+        }
+        const nextSelection = Object.freeze({
+            anchorCodeUnitOffset: input.shiftKey === true ? selection.anchorCodeUnitOffset : focus,
+            focusCodeUnitOffset: focus,
+        });
+        const event = Object.freeze({
+            type: 'replace',
+            startCodeUnitOffset: focus,
+            endCodeUnitOffset: focus,
+            text: '',
+            selection: nextSelection,
+        });
+        return this.handleEvent({ type: 'text', event });
+    }
+}
+function previousGraphemeOffset(text, offset) {
+    let previous = 0;
+    for (const segment of new Intl.Segmenter(undefined, { granularity: 'grapheme' }).segment(text)) {
+        if (segment.index >= offset)
+            break;
+        previous = segment.index;
+    }
+    return previous;
+}
+function nextGraphemeOffset(text, offset) {
+    for (const segment of new Intl.Segmenter(undefined, { granularity: 'grapheme' }).segment(text)) {
+        if (segment.index > offset)
+            return segment.index;
+    }
+    return text.length;
+}
+function sameInputState(left, right) {
+    return JSON.stringify(left) === JSON.stringify(right);
+}
+//# sourceMappingURL=number-field.js.map

package/dist/number-field.js.map

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

package/dist/pagination.d.ts

@@ -0,0 +1,38 @@
+import { type FacadeConnection } from './internal/facade.js';
+import type { Result } from '@sectile/core';
+import { type PaginationEvent, type PaginationItem, type PaginationItemRange, type PaginationModelOptions, type PaginationState } from '@sectile/core/pagination';
+import type { RevisionSnapshot } from '@sectile/core/revision';
+import type { TerminalKeyboardInput } from './keyboard.js';
+export interface PaginationOptions extends Omit<PaginationModelOptions, 'itemsPerPage'> {
+    readonly page?: number;
+    readonly defaultPage?: number;
+    readonly itemsPerPage?: number;
+    readonly defaultItemsPerPage?: number;
+    readonly disabled?: boolean;
+    readonly readOnly?: boolean;
+    readonly onPageChange?: (page: number) => void;
+    readonly onItemsPerPageChange?: (itemsPerPage: number) => void;
+    readonly onUpdate?: () => void;
+}
+export type PaginationPageChangeHandler = NonNullable<PaginationOptions['onPageChange']>;
+export type PaginationItemsPerPageChangeHandler = NonNullable<PaginationOptions['onItemsPerPageChange']>;
+export type PaginationUpdateHandler = NonNullable<PaginationOptions['onUpdate']>;
+export type PaginationControlledValues = {
+    readonly page: number;
+    readonly itemsPerPage: number;
+} | {
+    readonly page?: never;
+    readonly itemsPerPage?: never;
+};
+export interface PaginationConnection {
+    getSnapshot(): RevisionSnapshot<PaginationState>;
+    getItems(): readonly PaginationItem[];
+    getItemRange(): PaginationItemRange;
+    getPageCount(): number;
+    syncControlledValues(values: PaginationControlledValues): Result<RevisionSnapshot<PaginationState>>;
+    handleEvent(event: PaginationEvent): boolean;
+    handleKeyboardInput(input: TerminalKeyboardInput): boolean;
+}
+export declare function createPagination(options: PaginationOptions): FacadeConnection<PaginationConnection>;
+export declare function tryCreatePagination(options: PaginationOptions): Result<FacadeConnection<PaginationConnection>>;
+//# sourceMappingURL=pagination.d.ts.map

package/dist/pagination.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.d.ts","sourceRoot":"","sources":["../src/pagination.ts"],"names":[],"mappings":"AAAA,OAAO,EAA0B,KAAK,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAErF,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAQL,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,mBAAmB,EAExB,KAAK,sBAAsB,EAC3B,KAAK,eAAe,EACrB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAG3D,MAAM,WAAW,iBAAkB,SAAQ,IAAI,CAAC,sBAAsB,EAAE,cAAc,CAAC;IACrF,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IACtC,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/C,QAAQ,CAAC,oBAAoB,CAAC,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/D,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;CAChC;AAED,MAAM,MAAM,2BAA2B,GAAG,WAAW,CAAC,iBAAiB,CAAC,cAAc,CAAC,CAAC,CAAC;AACzF,MAAM,MAAM,mCAAmC,GAAG,WAAW,CAAC,iBAAiB,CAAC,sBAAsB,CAAC,CAAC,CAAC;AACzG,MAAM,MAAM,uBAAuB,GAAG,WAAW,CAAC,iBAAiB,CAAC,UAAU,CAAC,CAAC,CAAC;AAEjF,MAAM,MAAM,0BAA0B,GAClC;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;CAAE,GACxD;IAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,KAAK,CAAA;CAAE,CAAC;AAE7D,MAAM,WAAW,oBAAoB;IACnC,WAAW,IAAI,gBAAgB,CAAC,eAAe,CAAC,CAAC;IACjD,QAAQ,IAAI,SAAS,cAAc,EAAE,CAAC;IACtC,YAAY,IAAI,mBAAmB,CAAC;IACpC,YAAY,IAAI,MAAM,CAAC;IACvB,oBAAoB,CAAC,MAAM,EAAE,0BAA0B,GAAG,MAAM,CAAC,gBAAgB,CAAC,eAAe,CAAC,CAAC,CAAC;IACpG,WAAW,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC;IAC7C,mBAAmB,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC;CAC5D;AAED,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,iBAAiB,GACzB,gBAAgB,CAAC,oBAAoB,CAAC,CAExC;AAED,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,iBAAiB,GACzB,MAAM,CAAC,gBAAgB,CAAC,oBAAoB,CAAC,CAAC,CAEhD"}