@textui/core 0.1.0

package/dist/types/store.d.ts

@@ -0,0 +1,124 @@
+import type { Disposable } from './disposable.js';
+import type { BindingPath, EventPath } from './graph.js';
+/**
+ * Scopes are lifetimes, not folders. The first segment of an absolute path
+ * names one, and `clearScope` is what makes sign-out or screen-teardown a
+ * single call rather than a cascade of resets.
+ */
+export type ScopeName = 'local' | 'screen' | 'session' | 'app' | 'global' | 'summary' | 'active' | 'ui' | 'layout' | 'modus' | `plugins.${string}` | (string & {});
+export type SubscribeOptions = {
+    /** Fire for changes at or below the path, not only exact hits. */
+    subtree?: boolean;
+    /** Deliver the current value immediately on subscribe. */
+    immediate?: boolean;
+};
+export interface ChangeRecord {
+    path: BindingPath;
+    value: unknown;
+    previous: unknown;
+}
+export type ComputedDefinition<T = unknown> = {
+    from: BindingPath[];
+    select: (values: Record<string, unknown>) => T;
+}
+/** A tiny expression over the `from` paths, for computed defined as data. */
+ | {
+    from: BindingPath[];
+    select: string;
+};
+/**
+ * A namespace and the code that fills it. Lazy by default: nothing loads until
+ * something reads or subscribes below `namespace`.
+ */
+export interface DataProviderDefinition {
+    namespace: string;
+    load?: 'lazy' | 'eager';
+    /** Unload this many ms after the last subscriber leaves. */
+    unloadAfter?: number;
+    provider: {
+        load(store: ReactiveStore): Promise<void> | void;
+        unload?(store: ReactiveStore): Promise<void> | void;
+        loadOne?(id: string): Promise<unknown>;
+    };
+}
+/** Optional shape checking. Dynamic paths stay legal either way. */
+export interface PathSchema {
+    path: BindingPath;
+    /** Return null when valid, a message when not. */
+    validate(value: unknown): string | null;
+    /** Seeded when the path is first read and still empty. */
+    initial?: unknown;
+}
+/** Persist selected paths or subtrees across runs. */
+export interface PersistenceAdapter {
+    id: string;
+    /** Paths and subtrees this adapter owns. Subtree if it ends in `/`. */
+    paths: string[];
+    read(): Promise<Record<string, unknown>> | Record<string, unknown>;
+    write(entries: Record<string, unknown>): Promise<void> | void;
+    /** Coalesce writes by this many ms. */
+    debounceMs?: number;
+}
+/** Collection helpers operate on a path holding an array. */
+export interface CollectionOps<T = unknown> {
+    all(): T[];
+    at(index: number): T | undefined;
+    find(pred: (item: T, i: number) => boolean): T | undefined;
+    append(...items: T[]): void;
+    prepend(...items: T[]): void;
+    insertAt(index: number, ...items: T[]): void;
+    removeAt(index: number): void;
+    remove(pred: (item: T, i: number) => boolean): number;
+    update(pred: (item: T, i: number) => boolean, patch: Partial<T> | ((item: T) => T)): number;
+    replace(items: T[]): void;
+    filter(pred: (item: T, i: number) => boolean): T[];
+    clear(): void;
+    /** Keep at most `n` items, dropping from the front. For log tails. */
+    cap(n: number): void;
+    readonly length: number;
+}
+export interface ReactiveStore extends Disposable {
+    get<T = unknown>(path: BindingPath): T | undefined;
+    /** `get` with a fallback, so callers stop writing `?? default` everywhere. */
+    read<T>(path: BindingPath, fallback: T): T;
+    set(path: BindingPath, value: unknown): void;
+    /** Functional update - receives the current value. */
+    update<T = unknown>(path: BindingPath, fn: (current: T | undefined) => T): void;
+    /** Shallow-merge into an object at `path`. */
+    patch(path: BindingPath, partial: Record<string, unknown>): void;
+    /** Many writes, one notification pass. */
+    patchMany(entries: Record<BindingPath, unknown>): void;
+    delete(path: BindingPath): void;
+    has(path: BindingPath): boolean;
+    /** Coalesce every write inside `fn` into a single notification pass. */
+    batch<T>(fn: () => T): T;
+    subscribe(path: BindingPath, fn: (value: unknown, change: ChangeRecord) => void, options?: SubscribeOptions): Disposable;
+    clearScope(scope: ScopeName | string): void;
+    subscriberCount(scope: ScopeName | string): number;
+    computed<T = unknown>(path: BindingPath, def: ComputedDefinition<T>): Disposable;
+    collection<T = unknown>(path: BindingPath): CollectionOps<T>;
+    registerDataProvider(def: DataProviderDefinition): Disposable;
+    listDataProviders(): DataProviderDefinition[];
+    registerSchema(schema: PathSchema): Disposable;
+    registerPersistence(adapter: PersistenceAdapter): Disposable;
+    /** Load every registered persistence adapter. Call once at boot. */
+    hydrate(): Promise<void>;
+    /** Everything below `scope`, as a plain object. For snapshots and tests. */
+    snapshot(scope?: ScopeName | string): Record<string, unknown>;
+    restore(snapshot: Record<string, unknown>): void;
+}
+/**
+ * Transient events. Same path convention as the store, deliberately not the
+ * same mechanism - an event has no value to read back, which is the whole
+ * difference between `$/dialog/open` and `@/dialog/confirm`.
+ */
+export interface EventBus extends Disposable {
+    emit(path: EventPath, payload?: unknown): void;
+    on(path: EventPath, fn: (payload: unknown, path: EventPath) => void, options?: {
+        subtree?: boolean;
+        once?: boolean;
+    }): Disposable;
+    /** Resolve on the next emit at this path. */
+    next(path: EventPath, timeoutMs?: number): Promise<unknown>;
+}
+//# sourceMappingURL=store.d.ts.map

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

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

package/dist/types/store.js

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

package/dist/types/stream.d.ts

@@ -0,0 +1,18 @@
+import type { Disposable } from './disposable.js';
+/**
+ * The smallest useful stream. A LogViewer should not care whether its lines
+ * come from a Node stream, an async iterable, a child process or a store path,
+ * so every source is adapted to this.
+ */
+export interface Stream<T> {
+    subscribe(observer: StreamObserver<T>): Disposable;
+    /** Best-effort stop at the source. */
+    cancel?(): void;
+}
+export interface StreamObserver<T> {
+    next(value: T): void;
+    error?(err: unknown): void;
+    complete?(): void;
+}
+export type StreamSource<T> = Stream<T> | AsyncIterable<T> | Iterable<T> | (() => AsyncIterable<T>);
+//# sourceMappingURL=stream.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"stream.d.ts","sourceRoot":"","sources":["../../src/types/stream.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD;;;;GAIG;AACH,MAAM,WAAW,MAAM,CAAC,CAAC;IACvB,SAAS,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC;IACnD,sCAAsC;IACtC,MAAM,CAAC,IAAI,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,cAAc,CAAC,CAAC;IAC/B,IAAI,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC;IACrB,KAAK,CAAC,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAAC;IAC3B,QAAQ,CAAC,IAAI,IAAI,CAAC;CACnB;AAED,MAAM,MAAM,YAAY,CAAC,CAAC,IACtB,MAAM,CAAC,CAAC,CAAC,GACT,aAAa,CAAC,CAAC,CAAC,GAChB,QAAQ,CAAC,CAAC,CAAC,GACX,CAAC,MAAM,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC"}

package/dist/types/stream.js

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

package/dist/types/style.d.ts

@@ -0,0 +1,166 @@
+import type { Color } from './cells.js';
+import type { EdgeSpec } from './geometry.js';
+/**
+ * Semantic theme tokens. A component names a role, never a colour - which is
+ * what lets one catalog render the same under a light theme, a dark theme and
+ * a 16-colour ssh session.
+ */
+export type ColorToken = 'canvas' | 'surface' | 'surfaceAlt' | 'overlay' | 'border' | 'borderStrong' | 'borderSubtle' | 'text' | 'muted' | 'subtle' | 'inverted' | 'accent' | 'primary' | 'secondary' | 'success' | 'warning' | 'danger' | 'info' | 'onDefault' | 'onMuted' | 'onAccent' | 'onPrimary' | 'onSecondary' | 'onSuccess' | 'onWarning' | 'onDanger' | 'onInfo' | 'hover' | 'active' | 'selected' | 'focus' | 'disabled' | 'scrim' | 'cursor' | 'shadow';
+/** Anywhere a colour is accepted, a semantic token is accepted too. */
+export type StyleColor = ColorToken | Color;
+export type Dimension = number | `${number}%` | 'auto';
+export type BorderStyle = 'none' | 'single' | 'double' | 'round' | 'bold' | 'dashed' | 'ascii' | 'thick' | 'half';
+/** The twelve glyphs a box needs. Themes may ship their own set. */
+export interface BorderChars {
+    topLeft: string;
+    top: string;
+    topRight: string;
+    right: string;
+    bottomRight: string;
+    bottom: string;
+    bottomLeft: string;
+    left: string;
+    /** junctions, for tables and split panels */
+    cross: string;
+    teeTop: string;
+    teeBottom: string;
+    teeLeft: string;
+    teeRight: string;
+}
+export type BorderSides = {
+    top?: boolean;
+    right?: boolean;
+    bottom?: boolean;
+    left?: boolean;
+};
+/** A colour per edge. Unnamed edges fall back to the border's `color`. */
+export type BorderColors = {
+    top?: StyleColor;
+    right?: StyleColor;
+    bottom?: StyleColor;
+    left?: StyleColor;
+};
+export type BorderSpec = BorderStyle | {
+    style?: BorderStyle;
+    color?: StyleColor;
+    /**
+     * Per-edge colour, over `color`. A corner belongs to the edge that runs
+     * through it - the top rule owns both top corners - because a cell holds
+     * one colour and a terminal has no mitre to split it along.
+     */
+    colors?: BorderColors;
+    sides?: BorderSides;
+    chars?: Partial<BorderChars>;
+    /**
+     * Draw the frame dim. The frame only: a dim attribute on the box itself
+     * would take the content with it, and a quiet border around ordinary
+     * text is the whole reason to ask.
+     */
+    dim?: boolean;
+};
+export type Align = 'start' | 'center' | 'end' | 'stretch' | 'baseline';
+export type Justify = 'start' | 'center' | 'end' | 'between' | 'around' | 'evenly';
+export type Overflow = 'visible' | 'hidden' | 'scroll' | 'ellipsis';
+export type Position = 'relative' | 'absolute';
+export type FlexWrap = 'nowrap' | 'wrap';
+/**
+ * How a run of text meets the edge of its box.
+ *
+ * `none`, `word` and `char` describe *wrapping*: the text keeps every
+ * character and takes as many rows as it needs. The `truncate-*` forms are the
+ * opposite bargain - one row, and whatever does not fit is replaced by an
+ * ellipsis at the named end. `truncate` is `truncate-end`, which is the one
+ * everybody means.
+ *
+ * A truncating text is one row tall by definition, so an embedded newline
+ * would have nowhere to go; those become spaces rather than being dropped,
+ * because a joined sentence still reads and a silently halved one does not.
+ */
+export type TextWrap = 'none' | 'word' | 'char' | 'truncate' | 'truncate-start' | 'truncate-middle' | 'truncate-end';
+export interface Style {
+    /**
+     * Wash whatever is already painted here toward this colour, instead of
+     * drawing over it. A modal scrim in a terminal: the screen behind recedes
+     * but stays legible, rather than being replaced by a rectangle of nothing.
+     * `true` uses the theme's `scrim` token; a number sets the strength.
+     */
+    scrim?: boolean | StyleColor;
+    scrimStrength?: number;
+    display?: 'flex' | 'none';
+    direction?: 'row' | 'column';
+    /** Space between children on both axes. `columnGap`/`rowGap` override it. */
+    gap?: number;
+    /**
+     * Space between columns - horizontal, whichever way the container runs. It
+     * is the gap *between* children on a row, and the gap between wrapped lines
+     * on a column.
+     */
+    columnGap?: number;
+    /** Space between rows - vertical. The mirror of `columnGap`. */
+    rowGap?: number;
+    /**
+     * Whether children that do not fit start a new line. `nowrap` is the
+     * default and the cheaper path: one line, children shrink or get clipped.
+     */
+    flexWrap?: FlexWrap;
+    padding?: EdgeSpec;
+    margin?: EdgeSpec;
+    width?: Dimension;
+    height?: Dimension;
+    minWidth?: number;
+    maxWidth?: number;
+    minHeight?: number;
+    maxHeight?: number;
+    /** Grow factor along the parent's main axis. 0 = size to content. */
+    flex?: number;
+    /** Shrink factor. Defaults to 1 when flex is unset. */
+    shrink?: number;
+    /** Base size along the main axis before grow/shrink. */
+    basis?: Dimension;
+    align?: Align;
+    alignSelf?: Align;
+    justify?: Justify;
+    position?: Position;
+    top?: number;
+    right?: number;
+    bottom?: number;
+    left?: number;
+    /** Painting and hit-testing order within a layer. */
+    zIndex?: number;
+    /** What happens to content past the edge, on both axes. */
+    overflow?: Overflow;
+    /** Overrides `overflow` sideways. A row that scrolls but does not grow. */
+    overflowX?: Overflow;
+    /** Overrides `overflow` downwards. The usual scroll container. */
+    overflowY?: Overflow;
+    fg?: StyleColor;
+    bg?: StyleColor;
+    bold?: boolean;
+    dim?: boolean;
+    italic?: boolean;
+    underline?: boolean;
+    inverse?: boolean;
+    strike?: boolean;
+    blink?: boolean;
+    border?: BorderSpec;
+    wrap?: TextWrap;
+    textAlign?: 'left' | 'center' | 'right';
+    /** Character painted into empty cells of this box. */
+    fill?: string;
+}
+/** Styles selected by interaction state. Merged over the base in this order. */
+export interface StatefulStyle {
+    base?: Style;
+    focus?: Style;
+    hover?: Style;
+    active?: Style;
+    selected?: Style;
+    disabled?: Style;
+}
+export type StyleInput = Style | StatefulStyle | (Style | StatefulStyle | undefined | false)[];
+/** Global semantic variants, available to every component that opts in. */
+export type SemanticVariant = 'default' | 'primary' | 'secondary' | 'accent' | 'success' | 'warning' | 'danger' | 'info' | 'muted';
+/** Presentational variants a component may support. */
+export type SurfaceVariant = 'solid' | 'outline' | 'ghost' | 'link';
+export type Density = 'compact' | 'normal' | 'airy';
+//# sourceMappingURL=style.d.ts.map

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

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

package/dist/types/style.js

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

package/dist/types/surface.d.ts

@@ -0,0 +1,97 @@
+import type { Disposable } from './disposable.js';
+import type { BindingPath, ComponentNode } from './graph.js';
+import type { WhenClause } from './when.js';
+import type { StyleColor } from './style.js';
+/**
+ * Where something is mounted.
+ *
+ * A surface is the application's word, not the library's. The names below are
+ * the ones the shipped shells happen to use, and they are listed so an editor
+ * can complete them - `(string & {})` keeps the type open, so `lateral1`,
+ * `inspector` or `panel:bottom` are all equally valid and need no change here.
+ *
+ * The runtime never checks a surface name against a list. A name it has not
+ * seen gets default state the first time it is used, and a shell renders
+ * whichever surfaces it decides to render.
+ */
+export type SurfaceName = 'header' | 'rail' | 'sidebar' | 'aside' | 'main' | 'panel' | 'status' | 'overlay' | 'notify' | (string & {});
+export interface MountDisplay {
+    title?: string;
+    subtitle?: string;
+    icon?: string;
+    color?: StyleColor;
+    badge?: string | number;
+    /** Commands offered in this mount's header. */
+    actions?: string[];
+}
+export interface MountPolicy {
+    /** Survives a session snapshot. */
+    persistent?: boolean;
+    /** Removed on the next navigation. Previews want this. */
+    transient?: boolean;
+    closable?: boolean;
+    /** The user may move it to another surface. */
+    movable?: boolean;
+}
+/** An inline node, or a binding whose value is a node. */
+export type MountTarget = ComponentNode | {
+    path: BindingPath;
+};
+export interface Mount {
+    key: string;
+    surface: SurfaceName;
+    target: MountTarget;
+    display?: MountDisplay;
+    policy?: MountPolicy;
+    when?: WhenClause;
+    /** Relative paths inside this mount resolve against here. */
+    dataContext?: BindingPath;
+    order?: number;
+}
+/** How a surface arranges the several mounts it holds. */
+export type LayoutName = 'single' | 'tabs' | 'stack' | 'split' | 'rail' | 'bar' | 'inline' | 'floating' | 'toast';
+export interface SurfaceState {
+    /**
+     * Open, like `SurfaceName` and like `LayoutDefinition.name`. An application
+     * that registers a layout has to be able to put a surface into it, and the
+     * runtime never assumed a closed set anyway - `SurfaceArea` looks the name
+     * up in the registry and renders a diagnostic when nothing answers to it.
+     */
+    layout: LayoutName | (string & {});
+    activeKey: string | null;
+    visible: boolean;
+    /** Cells along the surface's cross axis. Unset lets the shell decide. */
+    size?: number;
+    collapsed?: boolean;
+}
+export interface SurfaceRegistry {
+    open(mount: Mount): Disposable;
+    close(surface: SurfaceName, key: string): void;
+    closeAll(surface: SurfaceName): void;
+    get(surface: SurfaceName, key: string): Mount | undefined;
+    mounts(surface: SurfaceName): Mount[];
+    activate(surface: SurfaceName, key: string): void;
+    state(surface: SurfaceName): SurfaceState;
+    setState(surface: SurfaceName, patch: Partial<SurfaceState>): void;
+    /** Resolve a resource's viewer and mount it. */
+    openResource(uri: string, options?: {
+        surface?: SurfaceName;
+        viewerId?: string;
+        mode?: 'view' | 'edit';
+    }): Promise<Disposable | null>;
+}
+/** A layout is a component that receives a surface's mounts and renders them. */
+export interface LayoutDefinition {
+    name: LayoutName | (string & {});
+    /** Component name receiving `{ surface, mounts, state }`. */
+    component: string;
+    title?: string;
+    /** Surfaces this layout is offered for. Unset = all. */
+    surfaces?: SurfaceName[];
+}
+export interface LayoutRegistry {
+    register(def: LayoutDefinition): Disposable;
+    get(name: string): LayoutDefinition | undefined;
+    list(surface?: SurfaceName): LayoutDefinition[];
+}
+//# sourceMappingURL=surface.d.ts.map

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

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

package/dist/types/surface.js

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

package/dist/types/syntax.d.ts

@@ -0,0 +1,68 @@
+import type { Disposable } from './disposable.js';
+/**
+ * Syntax highlighting.
+ *
+ * A highlighter names *scopes*, never colours. The theme owns the palette, so
+ * one JSON highlighter looks right on a dark console, a paper report and a
+ * sixteen-colour terminal without knowing that any of them exist - and a
+ * colourless terminal simply resolves every scope to the default foreground.
+ *
+ * The scope list is closed on purpose. An open vocabulary means a theme can
+ * only guess what a highlighter will emit, and the guess is what produces the
+ * uncoloured token nobody can explain.
+ */
+export type SyntaxScope = 'plain' | 'keyword' | 'string' | 'number' | 'boolean' | 'null' | 'comment' | 'punctuation'
+/** An object key, a column name, a field label - the left of a pair. */
+ | 'key' | 'operator' | 'type' | 'function' | 'tag' | 'attribute' | 'regexp' | 'escape'
+/** Syntactically wrong. Worth seeing rather than hiding. */
+ | 'invalid';
+export declare const SYNTAX_SCOPES: readonly SyntaxScope[];
+/** A run of text with one scope. Never spans a newline. */
+export interface SyntaxToken {
+    text: string;
+    scope: SyntaxScope;
+}
+/** A scored region of the source, before it is split into lines. */
+export interface SyntaxSpan {
+    start: number;
+    end: number;
+    scope: SyntaxScope;
+}
+export interface HighlighterDefinition {
+    id: string;
+    title?: string;
+    /** Resource kinds this claims: `file.data.json`, `log.stream`. */
+    kinds?: string[];
+    /** Filename globs, for when nothing has classified the resource yet. */
+    extensions?: string[];
+    /** Higher wins when several match. */
+    priority?: number;
+    /**
+     * Tokenise a whole document into one array per line.
+     *
+     * The result must have exactly as many entries as `text.split('\n')`, and
+     * the tokens on each line must join back to that line. The registry checks
+     * both and falls back to plain text rather than paint a file that no longer
+     * lines up with its own gutter.
+     */
+    tokenize(text: string): SyntaxToken[][];
+}
+export interface SyntaxQuery {
+    /** Resource kind, when the resource has been classified. */
+    kind?: string;
+    /** URI or filename, matched against `extensions`. */
+    uri?: string;
+    /** An explicit highlighter id, which wins over everything. */
+    language?: string;
+}
+export interface SyntaxRegistry {
+    register(def: HighlighterDefinition): Disposable;
+    unregister(id: string): void;
+    get(id: string): HighlighterDefinition | undefined;
+    list(): HighlighterDefinition[];
+    /** The best highlighter for this resource, or undefined. */
+    find(query: SyntaxQuery): HighlighterDefinition | undefined;
+    /** Tokenise, falling back to one plain token per line. */
+    tokenize(text: string, query?: SyntaxQuery): SyntaxToken[][];
+}
+//# sourceMappingURL=syntax.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"syntax.d.ts","sourceRoot":"","sources":["../../src/types/syntax.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,WAAW,GACnB,OAAO,GACP,SAAS,GACT,QAAQ,GACR,QAAQ,GACR,SAAS,GACT,MAAM,GACN,SAAS,GACT,aAAa;AACf,wEAAwE;GACtE,KAAK,GACL,UAAU,GACV,MAAM,GACN,UAAU,GACV,KAAK,GACL,WAAW,GACX,QAAQ,GACR,QAAQ;AACV,4DAA4D;GAC1D,SAAS,CAAC;AAEd,eAAO,MAAM,aAAa,EAAE,SAAS,WAAW,EAI/C,CAAC;AAEF,2DAA2D;AAC3D,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,WAAW,CAAC;CACpB;AAED,oEAAoE;AACpE,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,WAAW,CAAC;CACpB;AAED,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kEAAkE;IAClE,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,wEAAwE;IACxE,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,sCAAsC;IACtC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;;;;OAOG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,EAAE,EAAE,CAAC;CACzC;AAED,MAAM,WAAW,WAAW;IAC1B,4DAA4D;IAC5D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qDAAqD;IACrD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,GAAG,EAAE,qBAAqB,GAAG,UAAU,CAAC;IACjD,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,qBAAqB,GAAG,SAAS,CAAC;IACnD,IAAI,IAAI,qBAAqB,EAAE,CAAC;IAChC,4DAA4D;IAC5D,IAAI,CAAC,KAAK,EAAE,WAAW,GAAG,qBAAqB,GAAG,SAAS,CAAC;IAC5D,0DAA0D;IAC1D,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,WAAW,GAAG,WAAW,EAAE,EAAE,CAAC;CAC9D"}

package/dist/types/syntax.js

@@ -0,0 +1,5 @@
+export const SYNTAX_SCOPES = [
+    'plain', 'keyword', 'string', 'number', 'boolean', 'null', 'comment',
+    'punctuation', 'key', 'operator', 'type', 'function', 'tag', 'attribute',
+    'regexp', 'escape', 'invalid',
+];

package/dist/types/terminal.d.ts

@@ -0,0 +1,52 @@
+import type { Disposable } from './disposable.js';
+import type { Size } from './geometry.js';
+import type { TerminalCapabilities, CapabilityOverrides } from './capabilities.js';
+import type { InputEvent } from './input.js';
+/**
+ * Which capabilities the session wants turned on. The adapter records what it
+ * actually acquired, and `release` undoes exactly that and nothing else -
+ * which is the whole difference between a managed session and an embedded one.
+ */
+export interface TerminalSessionOptions {
+    /** TextUI owns setup and teardown of the terminal. */
+    managed?: boolean;
+    altScreen?: boolean;
+    mouse?: boolean;
+    wheel?: boolean;
+    focusEvents?: boolean;
+    paste?: boolean;
+    hideCursor?: boolean;
+    /** Kitty keyboard disambiguation, when available. */
+    enhancedKeys?: boolean;
+    title?: string;
+}
+/** What the adapter actually turned on, so release is exact. */
+export interface AcquiredState {
+    altScreen: boolean;
+    mouse: boolean;
+    wheel: boolean;
+    focusEvents: boolean;
+    paste: boolean;
+    cursorHidden: boolean;
+    enhancedKeys: boolean;
+    rawMode: boolean;
+    titleSet: boolean;
+}
+export interface TerminalAdapter extends Disposable {
+    readonly id: string;
+    size(): Size;
+    capabilities(): TerminalCapabilities;
+    /** Explicit overrides win over detection. */
+    setCapabilityOverrides(overrides: CapabilityOverrides): void;
+    acquire(options: TerminalSessionOptions): Promise<AcquiredState> | AcquiredState;
+    release(): Promise<void> | void;
+    readonly acquired: AcquiredState | null;
+    write(data: string): void;
+    flush(): Promise<void> | void;
+    onInput(fn: (event: InputEvent) => void): Disposable;
+    onResize(fn: (size: Size) => void): Disposable;
+    /** OSC 52, when the terminal allows it. */
+    writeClipboard?(text: string): void;
+    setTitle?(title: string): void;
+}
+//# sourceMappingURL=terminal.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"terminal.d.ts","sourceRoot":"","sources":["../../src/types/terminal.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,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACnF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C;;;;GAIG;AACH,MAAM,WAAW,sBAAsB;IACrC,sDAAsD;IACtD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,qDAAqD;IACrD,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,gEAAgE;AAChE,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;IACf,WAAW,EAAE,OAAO,CAAC;IACrB,KAAK,EAAE,OAAO,CAAC;IACf,YAAY,EAAE,OAAO,CAAC;IACtB,YAAY,EAAE,OAAO,CAAC;IACtB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,eAAgB,SAAQ,UAAU;IACjD,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,IAAI,IAAI,IAAI,CAAC;IACb,YAAY,IAAI,oBAAoB,CAAC;IACrC,6CAA6C;IAC7C,sBAAsB,CAAC,SAAS,EAAE,mBAAmB,GAAG,IAAI,CAAC;IAE7D,OAAO,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,aAAa,CAAC,GAAG,aAAa,CAAC;IACjF,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,aAAa,GAAG,IAAI,CAAC;IAExC,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAE9B,OAAO,CAAC,EAAE,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,GAAG,UAAU,CAAC;IACrD,QAAQ,CAAC,EAAE,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI,GAAG,UAAU,CAAC;IAE/C,2CAA2C;IAC3C,cAAc,CAAC,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,QAAQ,CAAC,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC"}

package/dist/types/terminal.js

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