@textui/core 0.1.0

package/dist/types/component-registry.d.ts

@@ -0,0 +1,77 @@
+import type { Disposable } from './disposable.js';
+import type { ComponentNode, ErrorFallback } from './graph.js';
+import type { WhenClause } from './when.js';
+import type { CapabilityName } from './capabilities.js';
+import type { FunctionComponent, HostComponent } from './render.js';
+import type { Style } from './style.js';
+export type ComponentCategory = 'layout' | 'display' | 'control' | 'form' | 'data' | 'navigation' | 'overlay' | 'feedback' | 'chart' | 'chrome' | 'resource' | 'template';
+/** Late binding: a name, a category, and something that renders. */
+export type ComponentRenderer = {
+    kind: 'function';
+    render: FunctionComponent;
+} | {
+    kind: 'host';
+    host: HostComponent;
+}
+/** A component defined as data - the graph all the way down. */
+ | {
+    kind: 'template';
+    template: ComponentNode;
+}
+/** Loaded on first mount. The catalog costs a name until something uses it. */
+ | {
+    kind: 'lazy';
+    load: () => Promise<{
+        default: FunctionComponent;
+    } | FunctionComponent>;
+};
+export type PropsSchema = Record<string, string | readonly string[]>;
+/**
+ * Declares that this component can render a resource kind. `findOpeners`
+ * drives "Open with...", double-click in an explorer, and the resource picker.
+ */
+export interface ComponentOpensSpec {
+    resourceKinds?: string[];
+    selector?: WhenClause;
+    title?: string;
+    icon?: string;
+    priority?: number;
+    /** 'view' is read-only, 'edit' can write back. */
+    mode?: 'view' | 'edit';
+}
+export interface ComponentDefinition {
+    component: string;
+    renderer: ComponentRenderer;
+    category?: ComponentCategory;
+    description?: string;
+    propsSchema?: PropsSchema;
+    /** Variants this component understands, for the theme and the CLI. */
+    variants?: string[];
+    /** Rendered instead when this subtree throws. */
+    fallback?: ErrorFallback;
+    /** Degrades or refuses to mount without these. */
+    requires?: CapabilityName[];
+    /** Uses these when present, works without them. */
+    enhancedBy?: CapabilityName[];
+    opens?: ComponentOpensSpec;
+    /** Default style, merged under the theme's entry for this component. */
+    defaultStyle?: Style;
+    /** Semantic role, for the testing harness and future a11y integrations. */
+    role?: SemanticRole;
+}
+export type SemanticRole = 'button' | 'textbox' | 'checkbox' | 'radio' | 'slider' | 'switch' | 'dialog' | 'alertdialog' | 'menu' | 'menuitem' | 'list' | 'listitem' | 'tree' | 'treeitem' | 'table' | 'row' | 'cell' | 'columnheader' | 'tab' | 'tablist' | 'tabpanel' | 'link' | 'heading' | 'label' | 'progressbar' | 'status' | 'alert' | 'region' | 'group' | 'separator' | 'toolbar' | 'searchbox' | 'combobox' | 'option' | 'presentation' | 'log' | 'timer' | 'marquee' | 'tooltip' | 'banner' | 'main' | 'navigation' | 'document' | 'complementary' | 'contentinfo' | 'form' | 'grid' | 'gridcell' | 'meter';
+export interface ComponentRegistry {
+    register(def: ComponentDefinition): Disposable;
+    registerMany(defs: ComponentDefinition[]): Disposable;
+    unregister(component: string): void;
+    get(component: string): ComponentDefinition | undefined;
+    has(component: string): boolean;
+    list(category?: ComponentCategory): ComponentDefinition[];
+    /** Resolve a lazy renderer. Idempotent, cached. */
+    resolve(component: string): Promise<ComponentDefinition>;
+    /** Names registered but not yet resolved. */
+    pending(): string[];
+    /** Components whose `opens` accepts this kind, best first. */
+    findOpeners(resourceKind: string): ComponentDefinition[];
+}
+//# sourceMappingURL=component-registry.d.ts.map

package/dist/types/component-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"component-registry.d.ts","sourceRoot":"","sources":["../../src/types/component-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC/D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,KAAK,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACpE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAExC,MAAM,MAAM,iBAAiB,GACzB,QAAQ,GAAG,SAAS,GAAG,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,YAAY,GACjE,SAAS,GAAG,UAAU,GAAG,OAAO,GAAG,QAAQ,GAAG,UAAU,GAAG,UAAU,CAAC;AAE1E,oEAAoE;AACpE,MAAM,MAAM,iBAAiB,GACzB;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,MAAM,EAAE,iBAAiB,CAAA;CAAE,GAC/C;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,aAAa,CAAA;CAAE;AACvC,gEAAgE;GAC9D;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,EAAE,aAAa,CAAA;CAAE;AAC/C,+EAA+E;GAC7E;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,OAAO,CAAC;QAAE,OAAO,EAAE,iBAAiB,CAAA;KAAE,GAAG,iBAAiB,CAAC,CAAA;CAAE,CAAC;AAE9F,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAAC,CAAC;AAErE;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,QAAQ,CAAC,EAAE,UAAU,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kDAAkD;IAClD,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,QAAQ,CAAC,EAAE,iBAAiB,CAAC;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,sEAAsE;IACtE,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,iDAAiD;IACjD,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB,kDAAkD;IAClD,QAAQ,CAAC,EAAE,cAAc,EAAE,CAAC;IAC5B,mDAAmD;IACnD,UAAU,CAAC,EAAE,cAAc,EAAE,CAAC;IAC9B,KAAK,CAAC,EAAE,kBAAkB,CAAC;IAC3B,wEAAwE;IACxE,YAAY,CAAC,EAAE,KAAK,CAAC;IACrB,2EAA2E;IAC3E,IAAI,CAAC,EAAE,YAAY,CAAC;CACrB;AAED,MAAM,MAAM,YAAY,GACpB,QAAQ,GAAG,SAAS,GAAG,UAAU,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,GACjE,QAAQ,GAAG,aAAa,GAAG,MAAM,GAAG,UAAU,GAAG,MAAM,GAAG,UAAU,GACpE,MAAM,GAAG,UAAU,GAAG,OAAO,GAAG,KAAK,GAAG,MAAM,GAAG,cAAc,GAC/D,KAAK,GAAG,SAAS,GAAG,UAAU,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,GAC7D,aAAa,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,GAAG,WAAW,GACrE,SAAS,GAAG,WAAW,GAAG,UAAU,GAAG,QAAQ,GAAG,cAAc,GAChE,KAAK,GAAG,OAAO,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,MAAM,GAAG,YAAY,GAC1E,UAAU,GACV,eAAe,GAAG,aAAa,GAAG,MAAM,GAAG,MAAM,GAAG,UAAU,GAAG,OAAO,CAAC;AAE7E,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,GAAG,EAAE,mBAAmB,GAAG,UAAU,CAAC;IAC/C,YAAY,CAAC,IAAI,EAAE,mBAAmB,EAAE,GAAG,UAAU,CAAC;IACtD,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,mBAAmB,GAAG,SAAS,CAAC;IACxD,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;IAChC,IAAI,CAAC,QAAQ,CAAC,EAAE,iBAAiB,GAAG,mBAAmB,EAAE,CAAC;IAC1D,mDAAmD;IACnD,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;IACzD,6CAA6C;IAC7C,OAAO,IAAI,MAAM,EAAE,CAAC;IACpB,8DAA8D;IAC9D,WAAW,CAAC,YAAY,EAAE,MAAM,GAAG,mBAAmB,EAAE,CAAC;CAC1D"}

package/dist/types/component-registry.js

@@ -0,0 +1 @@
+export {};

package/dist/types/disposable.d.ts

@@ -0,0 +1,8 @@
+export interface Disposable {
+    dispose(): void;
+}
+/** A disposable that owns other disposables. Dispose once, dispose all. */
+export interface DisposableBag extends Disposable {
+    add<T extends Disposable>(d: T): T;
+}
+//# sourceMappingURL=disposable.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"disposable.d.ts","sourceRoot":"","sources":["../../src/types/disposable.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,UAAU;IACzB,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,2EAA2E;AAC3E,MAAM,WAAW,aAAc,SAAQ,UAAU;IAC/C,GAAG,CAAC,CAAC,SAAS,UAAU,EAAE,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;CACpC"}

package/dist/types/disposable.js

@@ -0,0 +1 @@
+export {};

package/dist/types/focus.d.ts

@@ -0,0 +1,72 @@
+import type { Disposable } from './disposable.js';
+import type { Rect } from './geometry.js';
+import type { KeyEvent } from './input.js';
+export type FocusDirection = 'next' | 'previous' | 'up' | 'down' | 'left' | 'right';
+/**
+ * A focus scope is a container that focus can be trapped inside or restored
+ * to. Modals trap; a sidebar does not. Scopes nest, and the innermost active
+ * scope answers navigation first.
+ */
+export interface FocusScopeOptions {
+    id: string;
+    /** Tab cannot leave this scope while it is active. Modals want this. */
+    trap?: boolean;
+    /** Restore focus to whatever was focused before, on deactivate. */
+    restore?: boolean;
+    /** Focus this scope's first focusable as soon as it activates. */
+    autoFocus?: boolean;
+    /** Higher wins when two scopes are active. */
+    priority?: number;
+}
+export interface FocusableOptions {
+    id: string;
+    /** Explicit order within the scope. Unset = document order. */
+    order?: number;
+    disabled?: boolean;
+    /** Skipped by tab, still reachable by directional navigation and click. */
+    skipTab?: boolean;
+    /**
+     * Reads keys whether or not it is focused.
+     *
+     * For handlers that are not about one control - a screen's shortcuts, a
+     * layer that must see escape. A focusable without this only reads keys while
+     * it holds focus, which is what focus means.
+     */
+    global?: boolean;
+    /** Current bounds, for directional navigation and mouse hit-testing. */
+    rect?: Rect;
+    scopeId?: string;
+    onFocus?(): void;
+    onBlur?(): void;
+    /** Return true to consume. Runs before the scope's and the app's handlers. */
+    onKey?(event: KeyEvent): boolean | void;
+}
+export interface FocusManager {
+    registerScope(options: FocusScopeOptions): Disposable;
+    activateScope(id: string): void;
+    deactivateScope(id: string): void;
+    activeScope(): string | null;
+    register(options: FocusableOptions): Disposable;
+    update(id: string, patch: Partial<FocusableOptions>): void;
+    /** True when a focusable with this id is registered. */
+    has(id: string): boolean;
+    /** Which scope a focusable belongs to. */
+    scopeOf(id: string): string;
+    focus(id: string): boolean;
+    blur(): void;
+    focused(): string | null;
+    /** Move focus; returns the id that took it. */
+    move(direction: FocusDirection): string | null;
+    /** The focused id and every ancestor scope, innermost first. */
+    chain(): string[];
+    /** Ids in tab order within a scope (or the active scope). */
+    order(scopeId?: string): string[];
+    /** Hit-test a cell; used for click-to-focus. */
+    at(x: number, y: number): string | null;
+    /**
+     * Feed a key to the focused node, then outward through its scopes, then to
+     * global handlers. Returns true when something consumed it.
+     */
+    dispatch(event: KeyEvent): boolean;
+}
+//# sourceMappingURL=focus.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"focus.d.ts","sourceRoot":"","sources":["../../src/types/focus.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,UAAU,GAAG,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAEpF;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,wEAAwE;IACxE,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,mEAAmE;IACnE,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,kEAAkE;IAClE,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,8CAA8C;IAC9C,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,+DAA+D;IAC/D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,2EAA2E;IAC3E,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,wEAAwE;IACxE,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,IAAI,IAAI,CAAC;IACjB,MAAM,CAAC,IAAI,IAAI,CAAC;IAChB,8EAA8E;IAC9E,KAAK,CAAC,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,GAAG,IAAI,CAAC;CACzC;AAED,MAAM,WAAW,YAAY;IAC3B,aAAa,CAAC,OAAO,EAAE,iBAAiB,GAAG,UAAU,CAAC;IACtD,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,WAAW,IAAI,MAAM,GAAG,IAAI,CAAC;IAE7B,QAAQ,CAAC,OAAO,EAAE,gBAAgB,GAAG,UAAU,CAAC;IAChD,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,IAAI,CAAC;IAE3D,wDAAwD;IACxD,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;IACzB,0CAA0C;IAC1C,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;IAC5B,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;IAC3B,IAAI,IAAI,IAAI,CAAC;IACb,OAAO,IAAI,MAAM,GAAG,IAAI,CAAC;IACzB,+CAA+C;IAC/C,IAAI,CAAC,SAAS,EAAE,cAAc,GAAG,MAAM,GAAG,IAAI,CAAC;IAC/C,gEAAgE;IAChE,KAAK,IAAI,MAAM,EAAE,CAAC;IAClB,6DAA6D;IAC7D,KAAK,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAClC,gDAAgD;IAChD,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IACxC;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC;CACpC"}

package/dist/types/focus.js

@@ -0,0 +1 @@
+export {};

package/dist/types/geometry.d.ts

@@ -0,0 +1,28 @@
+/** Terminal geometry is integral cells. Never fractional. */
+export interface Point {
+    x: number;
+    y: number;
+}
+export interface Size {
+    width: number;
+    height: number;
+}
+export interface Rect {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+/** padding / margin / border widths, in cells. */
+export interface Edges {
+    top: number;
+    right: number;
+    bottom: number;
+    left: number;
+}
+export type EdgeSpec = number | [vertical: number, horizontal: number] | [top: number, horizontal: number, bottom: number] | [top: number, right: number, bottom: number, left: number] | Partial<Edges>;
+export declare const ZERO_EDGES: Edges;
+export declare function rectContains(r: Rect, x: number, y: number): boolean;
+export declare function rectIntersect(a: Rect, b: Rect): Rect;
+export declare function rectEquals(a: Rect, b: Rect): boolean;
+//# sourceMappingURL=geometry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"geometry.d.ts","sourceRoot":"","sources":["../../src/types/geometry.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAC7D,MAAM,WAAW,KAAK;IACpB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED,MAAM,WAAW,IAAI;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,IAAI;IACnB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,kDAAkD;AAClD,MAAM,WAAW,KAAK;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,MAAM,QAAQ,GAChB,MAAM,GACN,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC,GACtC,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GACjD,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,GAC1D,OAAO,CAAC,KAAK,CAAC,CAAC;AAEnB,eAAO,MAAM,UAAU,EAAE,KAAgD,CAAC;AAE1E,wBAAgB,YAAY,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAEnE;AAED,wBAAgB,aAAa,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,GAAG,IAAI,CAMpD;AAED,wBAAgB,UAAU,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,GAAG,OAAO,CAEpD"}

package/dist/types/geometry.js

@@ -0,0 +1,14 @@
+export const ZERO_EDGES = { top: 0, right: 0, bottom: 0, left: 0 };
+export function rectContains(r, x, y) {
+    return x >= r.x && x < r.x + r.width && y >= r.y && y < r.y + r.height;
+}
+export function rectIntersect(a, b) {
+    const x = Math.max(a.x, b.x);
+    const y = Math.max(a.y, b.y);
+    const right = Math.min(a.x + a.width, b.x + b.width);
+    const bottom = Math.min(a.y + a.height, b.y + b.height);
+    return { x, y, width: Math.max(0, right - x), height: Math.max(0, bottom - y) };
+}
+export function rectEquals(a, b) {
+    return a.x === b.x && a.y === b.y && a.width === b.width && a.height === b.height;
+}

package/dist/types/graph.d.ts

@@ -0,0 +1,129 @@
+/**
+ * The component graph.
+ *
+ * A screen IS its root ComponentNode. JSX compiles to exactly this shape -
+ * `<Row gap={1}/>` and `{ component: 'Row', gap: 1 }` are the same value - so
+ * a screen can be written in TypeScript, loaded from JSON, generated, edited
+ * or sent over a wire without changing the runtime that mounts it.
+ *
+ * Three keys are reserved on every node: `id`, `component`, `$meta`.
+ * Everything else is props, and props are the component's business.
+ */
+export type NodeId = string;
+/**
+ * JSON-Pointer-shaped store path.
+ *
+ * `$/seg/seg` - absolute; the first segment is a scope.
+ * `/seg/seg`  - relative to the surrounding data context.
+ * `..`        - forbidden. Escape to the root with `$/` instead, so a node's
+ *               meaning never depends on where it was pasted.
+ * `*`         - wildcard segment, subscriptions only (writes throw).
+ * `#/seg`     - the value AT this path is itself a path; one extra hop.
+ * `{{ /seg }}` inside a path substitutes another path's value first.
+ */
+export type BindingPath = `$/${string}` | `/${string}`;
+/**
+ * Transient event path. Same shape, different lifetime: events are delivered
+ * and forgotten, never stored. `@/dialog/confirm`, `@/agent/restart`.
+ */
+export type EventPath = `@/${string}`;
+export type DataBinding = {
+    path: BindingPath;
+};
+export type FunctionCall = {
+    call: string;
+    args?: Record<string, PropValue>;
+    /** Refuse to route this to a remote dispatcher. */
+    callableFrom?: 'clientOnly';
+};
+export type DynamicValue = string | number | boolean | string[] | DataBinding | FunctionCall;
+export type DynamicString = string | DataBinding | FunctionCall;
+export type DynamicNumber = number | DataBinding | FunctionCall;
+export type DynamicBoolean = boolean | DataBinding | FunctionCall;
+export type DynamicStringList = string[] | DataBinding | FunctionCall;
+/** Inline children, or one instance of `template` per item at `path`. */
+export type ChildList = ComponentNode[] | {
+    template: ComponentNode;
+    path: BindingPath;
+};
+/**
+ * Discriminated by key presence:
+ *   'emit' in action         -> publish on an event path
+ *   'functionCall' in action -> run a registered command
+ *   'handler' in action      -> a closure. Never serializable; only legal for
+ *                               nodes built in-process (JSX), and stripped
+ *                               when a graph is exported.
+ */
+export type Action = {
+    emit: {
+        path: EventPath;
+        payload?: PropValue;
+    };
+} | {
+    functionCall: FunctionCall;
+} | {
+    handler: (...args: any[]) => void;
+};
+export type PropValue = string | number | boolean | null | undefined | DataBinding | FunctionCall | Action | ComponentNode | ComponentNode[] | {
+    template: ComponentNode;
+    path: BindingPath;
+} | {
+    [k: string]: PropValue;
+} | PropValue[] | ((...args: any[]) => unknown);
+/** What a component threw, and which component threw it. */
+export interface RenderError {
+    /** The thrown value, whatever it was. */
+    error: unknown;
+    /** `error.message`, or the value stringified. */
+    message: string;
+    /** The component that threw. */
+    component: string;
+}
+/**
+ * What to render when a component throws.
+ *
+ * A node keeps the graph data, and is handed the failure as the `error` and
+ * `errorMessage` props - so a registered `ErrorPanel` can show what happened
+ * without the registry holding a function. A function is for the local case,
+ * where the fallback wants the failure itself rather than two props.
+ */
+export type ErrorFallback = ComponentNode | ((failure: RenderError) => ComponentNode);
+/** Internal only - stripped before a node is serialized back to a sender. */
+export type NodeMeta = {
+    origin?: {
+        format: string;
+        version?: string;
+        sourceNodeId?: NodeId;
+    };
+    /** Rendered instead when this node's subtree throws. */
+    fallback?: ErrorFallback;
+    /** Set by the JSX factory for a function component, so the registry can
+     *  resolve the same function without a name collision. */
+    fn?: unknown;
+    /** Source location, when the JSX transform provides one. */
+    source?: {
+        file: string;
+        line: number;
+        column: number;
+    };
+};
+export type ComponentNode = {
+    id?: NodeId;
+    component: string;
+    $meta?: NodeMeta;
+    /** Reconciliation identity among siblings. */
+    key?: string | number;
+    children?: PropValue | unknown;
+    [prop: string]: unknown;
+};
+/** A screen IS its root node. No separate {root, nodes} map. */
+export type ScreenState = ComponentNode;
+export declare function isComponentNode(v: unknown): v is ComponentNode;
+export declare function isDataBinding(v: unknown): v is DataBinding;
+export declare function isFunctionCall(v: unknown): v is FunctionCall;
+export declare function isAction(v: unknown): v is Action;
+export declare function isTemplatedChildren(v: unknown): v is {
+    template: ComponentNode;
+    path: BindingPath;
+};
+//# sourceMappingURL=graph.d.ts.map

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

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

package/dist/types/graph.js

@@ -0,0 +1,31 @@
+export function isComponentNode(v) {
+    return (typeof v === 'object' && v !== null &&
+        'component' in v && typeof v.component === 'string');
+}
+export function isDataBinding(v) {
+    // Exactly one key, because that is what the type says: `{ path }`. Testing
+    // only that `path` is present made a binding out of anything that happens to
+    // carry one - `{ kind: 'unix', path: '/tmp/room' }` is a socket address, and
+    // it was resolved against the store and thrown as a PathError instead. The
+    // shape is far too common to claim loosely: a route, a file entry, a config
+    // section. The old guard listed `component` and `template` as exceptions,
+    // which was this same problem met twice and patched twice.
+    return (typeof v === 'object' && v !== null &&
+        typeof v.path === 'string' &&
+        Object.keys(v).length === 1);
+}
+export function isFunctionCall(v) {
+    return (typeof v === 'object' && v !== null &&
+        'call' in v && typeof v.call === 'string' &&
+        !('component' in v));
+}
+export function isAction(v) {
+    return (typeof v === 'object' && v !== null &&
+        ('emit' in v || 'functionCall' in v || 'handler' in v) &&
+        !('component' in v));
+}
+export function isTemplatedChildren(v) {
+    return (typeof v === 'object' && v !== null &&
+        'template' in v && 'path' in v &&
+        isComponentNode(v.template));
+}

package/dist/types/i18n.d.ts

@@ -0,0 +1,23 @@
+import type { Disposable } from './disposable.js';
+export type LocaleId = string;
+export interface TranslationBundle {
+    locale: LocaleId;
+    /** Flat or nested; nested keys are addressed with dots. */
+    messages: Record<string, unknown>;
+}
+export interface I18n {
+    locale: LocaleId;
+    setLocale(locale: LocaleId): void;
+    register(bundle: TranslationBundle): Disposable;
+    locales(): LocaleId[];
+    /** Missing keys fall back to the fallback locale, then to the key itself. */
+    t(key: string, values?: Record<string, unknown>): string;
+    /** Intl-backed; TextUI does not reimplement formatting. */
+    number(value: number, options?: Intl.NumberFormatOptions): string;
+    date(value: Date | number, options?: Intl.DateTimeFormatOptions): string;
+    relative(value: number, unit: Intl.RelativeTimeFormatUnit): string;
+    list(items: string[], options?: Intl.ListFormatOptions): string;
+    plural(count: number, forms: Record<string, string>): string;
+    onChange(fn: (locale: LocaleId) => void): Disposable;
+}
+//# sourceMappingURL=i18n.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"i18n.d.ts","sourceRoot":"","sources":["../../src/types/i18n.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC;AAE9B,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,QAAQ,CAAC;IACjB,2DAA2D;IAC3D,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,IAAI;IACnB,MAAM,EAAE,QAAQ,CAAC;IACjB,SAAS,CAAC,MAAM,EAAE,QAAQ,GAAG,IAAI,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,iBAAiB,GAAG,UAAU,CAAC;IAChD,OAAO,IAAI,QAAQ,EAAE,CAAC;IACtB,6EAA6E;IAC7E,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC;IACzD,2DAA2D;IAC3D,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,mBAAmB,GAAG,MAAM,CAAC;IAClE,IAAI,CAAC,KAAK,EAAE,IAAI,GAAG,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,qBAAqB,GAAG,MAAM,CAAC;IACzE,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,sBAAsB,GAAG,MAAM,CAAC;IACnE,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,iBAAiB,GAAG,MAAM,CAAC;IAChE,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAAC;IAC7D,QAAQ,CAAC,EAAE,EAAE,CAAC,MAAM,EAAE,QAAQ,KAAK,IAAI,GAAG,UAAU,CAAC;CACtD"}

package/dist/types/i18n.js

@@ -0,0 +1 @@
+export {};

package/dist/types/index.d.ts

@@ -0,0 +1,32 @@
+export * from './disposable.js';
+export * from './geometry.js';
+export * from './capabilities.js';
+export * from './cells.js';
+export * from './style.js';
+export * from './theme.js';
+export * from './graph.js';
+export * from './store.js';
+export * from './input.js';
+export * from './focus.js';
+export * from './when.js';
+export * from './command.js';
+export * from './keybinding.js';
+export * from './render.js';
+export * from './component-registry.js';
+export * from './resource.js';
+export * from './surface.js';
+export * from './shell.js';
+export * from './navigation.js';
+export * from './layer.js';
+export * from './async.js';
+export * from './stream.js';
+export * from './animation.js';
+export * from './i18n.js';
+export * from './terminal.js';
+export * from './services.js';
+export * from './manifest.js';
+export * from './app.js';
+export * from './syntax.js';
+export * from './adapter.js';
+export * from './markdown.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAClC,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,yBAAyB,CAAC;AACxC,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC"}

package/dist/types/index.js

@@ -0,0 +1,31 @@
+export * from './disposable.js';
+export * from './geometry.js';
+export * from './capabilities.js';
+export * from './cells.js';
+export * from './style.js';
+export * from './theme.js';
+export * from './graph.js';
+export * from './store.js';
+export * from './input.js';
+export * from './focus.js';
+export * from './when.js';
+export * from './command.js';
+export * from './keybinding.js';
+export * from './render.js';
+export * from './component-registry.js';
+export * from './resource.js';
+export * from './surface.js';
+export * from './shell.js';
+export * from './navigation.js';
+export * from './layer.js';
+export * from './async.js';
+export * from './stream.js';
+export * from './animation.js';
+export * from './i18n.js';
+export * from './terminal.js';
+export * from './services.js';
+export * from './manifest.js';
+export * from './app.js';
+export * from './syntax.js';
+export * from './adapter.js';
+export * from './markdown.js';

package/dist/types/input.d.ts

@@ -0,0 +1,65 @@
+import type { Disposable } from './disposable.js';
+export interface KeyModifiers {
+    ctrl: boolean;
+    alt: boolean;
+    shift: boolean;
+    meta: boolean;
+}
+/**
+ * Canonical key name. Printable keys carry the character itself; everything
+ * else uses these names, so a keybinding string is stable across terminals.
+ */
+export type KeyName = 'up' | 'down' | 'left' | 'right' | 'enter' | 'escape' | 'tab' | 'backspace' | 'delete' | 'space' | 'home' | 'end' | 'pageup' | 'pagedown' | 'insert' | 'f1' | 'f2' | 'f3' | 'f4' | 'f5' | 'f6' | 'f7' | 'f8' | 'f9' | 'f10' | 'f11' | 'f12' | (string & {});
+export interface KeyEvent {
+    type: 'key';
+    /** Canonical name, or the printable character. */
+    name: KeyName;
+    /** The character produced, when printable. */
+    char?: string;
+    ctrl: boolean;
+    alt: boolean;
+    shift: boolean;
+    meta: boolean;
+    /** Raw bytes, for adapters and diagnostics. */
+    raw: string;
+    /** Set by a handler to stop propagation up the focus chain. */
+    handled: boolean;
+    /** Kitty protocol only - press/repeat/release. */
+    kind?: 'press' | 'repeat' | 'release';
+}
+export type MouseButton = 'left' | 'middle' | 'right' | 'none';
+export type MouseAction = 'down' | 'up' | 'move' | 'drag' | 'wheel';
+export interface MouseEvent {
+    type: 'mouse';
+    action: MouseAction;
+    button: MouseButton;
+    /** Terminal cell coordinates, 0-based. */
+    x: number;
+    y: number;
+    /** Negative up, positive down. */
+    wheel?: number;
+    ctrl: boolean;
+    alt: boolean;
+    shift: boolean;
+    handled: boolean;
+}
+export interface PasteEvent {
+    type: 'paste';
+    text: string;
+    handled: boolean;
+}
+/** Terminal-level focus (the window), not component focus. */
+export interface TerminalFocusEvent {
+    type: 'terminal-focus';
+    focused: boolean;
+}
+export interface ResizeEvent {
+    type: 'resize';
+    width: number;
+    height: number;
+}
+export type InputEvent = KeyEvent | MouseEvent | PasteEvent | TerminalFocusEvent | ResizeEvent;
+export interface InputSource extends Disposable {
+    on(fn: (event: InputEvent) => void): Disposable;
+}
+//# sourceMappingURL=input.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"input.d.ts","sourceRoot":"","sources":["../../src/types/input.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,OAAO,CAAC;IACd,GAAG,EAAE,OAAO,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;IACf,IAAI,EAAE,OAAO,CAAC;CACf;AAED;;;GAGG;AACH,MAAM,MAAM,OAAO,GACf,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAChC,OAAO,GAAG,QAAQ,GAAG,KAAK,GAAG,WAAW,GAAG,QAAQ,GAAG,OAAO,GAC7D,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,UAAU,GAAG,QAAQ,GACjD,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GACvC,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAC1C,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAElB,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,KAAK,CAAC;IACZ,kDAAkD;IAClD,IAAI,EAAE,OAAO,CAAC;IACd,8CAA8C;IAC9C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,OAAO,CAAC;IACd,GAAG,EAAE,OAAO,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;IACf,IAAI,EAAE,OAAO,CAAC;IACd,+CAA+C;IAC/C,GAAG,EAAE,MAAM,CAAC;IACZ,+DAA+D;IAC/D,OAAO,EAAE,OAAO,CAAC;IACjB,kDAAkD;IAClD,IAAI,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,SAAS,CAAC;CACvC;AAED,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,CAAC;AAC/D,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAEpE,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE,WAAW,CAAC;IACpB,MAAM,EAAE,WAAW,CAAC;IACpB,0CAA0C;IAC1C,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,kCAAkC;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,OAAO,CAAC;IACd,GAAG,EAAE,OAAO,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,8DAA8D;AAC9D,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,gBAAgB,CAAC;IACvB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,QAAQ,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,UAAU,GAClB,QAAQ,GAAG,UAAU,GAAG,UAAU,GAAG,kBAAkB,GAAG,WAAW,CAAC;AAE1E,MAAM,WAAW,WAAY,SAAQ,UAAU;IAC7C,EAAE,CAAC,EAAE,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,GAAG,UAAU,CAAC;CACjD"}

package/dist/types/input.js

@@ -0,0 +1 @@
+export {};

package/dist/types/keybinding.d.ts

@@ -0,0 +1,49 @@
+import type { Disposable } from './disposable.js';
+import type { WhenClause } from './when.js';
+import type { KeyEvent } from './input.js';
+/**
+ * A chord string: `ctrl+p`, `ctrl+k ctrl+s` (a sequence), `shift+tab`, `g g`.
+ * Names match `KeyName`; modifiers are ctrl/alt/shift/meta in that order.
+ */
+export type Chord = string;
+export interface KeybindingDefinition {
+    keys: Chord;
+    commandId: string;
+    args?: Record<string, unknown>;
+    /**
+     * What *this key* does, when the command's own title does not say it.
+     *
+     * A binding that carries arguments runs one invocation of a command, not the
+     * command: `ctrl+b` is "Toggle Sidebar" and the command is "Toggle Surface".
+     * Without this the shortcut sheet files the key under the general title and
+     * says something that is not true of the key.
+     */
+    title?: string;
+    when?: WhenClause;
+    /** Only fires while this focus scope (or one inside it) is active. */
+    scopeId?: string;
+    /** Higher wins on conflict. Defaults to registration order. */
+    priority?: number;
+}
+export interface KeybindingRegistry {
+    register(def: KeybindingDefinition): Disposable;
+    unregister(keys: Chord, commandId?: string): void;
+    list(): KeybindingDefinition[];
+    /**
+     * Chords bound to a command, for rendering hints next to menu rows.
+     *
+     * Argument-bearing bindings are left out: they run one invocation and not
+     * the command, so offering one as *the* key for the command's menu row
+     * names a key that does something else. Match on `args` through `list()`
+     * when the specific invocation is what is wanted.
+     */
+    forCommand(commandId: string): Chord[];
+    /**
+     * Feed a key in. Returns 'handled', 'pending' (a prefix of a longer chord),
+     * or 'unhandled'.
+     */
+    handle(event: KeyEvent): 'handled' | 'pending' | 'unhandled';
+    /** Abandon a partially typed chord. */
+    reset(): void;
+}
+//# sourceMappingURL=keybinding.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"keybinding.d.ts","sourceRoot":"","sources":["../../src/types/keybinding.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C;;;GAGG;AACH,MAAM,MAAM,KAAK,GAAG,MAAM,CAAC;AAE3B,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,KAAK,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B;;;;;;;OAOG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,sEAAsE;IACtE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,GAAG,EAAE,oBAAoB,GAAG,UAAU,CAAC;IAChD,UAAU,CAAC,IAAI,EAAE,KAAK,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAClD,IAAI,IAAI,oBAAoB,EAAE,CAAC;IAC/B;;;;;;;OAOG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,KAAK,EAAE,CAAC;IACvC;;;OAGG;IACH,MAAM,CAAC,KAAK,EAAE,QAAQ,GAAG,SAAS,GAAG,SAAS,GAAG,WAAW,CAAC;IAC7D,uCAAuC;IACvC,KAAK,IAAI,IAAI,CAAC;CACf"}

package/dist/types/keybinding.js

@@ -0,0 +1 @@
+export {};