@textui/core 0.1.0

package/dist/types/layer.d.ts

@@ -0,0 +1,54 @@
+import type { Disposable } from './disposable.js';
+import type { ComponentNode } from './graph.js';
+import type { Rect } from './geometry.js';
+/** Painting and input order. A layer is a plane, not a component. */
+export type LayerName = 'base' | 'floating' | 'modal' | 'notification' | 'debug';
+export type AnchorSide = 'top' | 'right' | 'bottom' | 'left';
+export type AnchorAlign = 'start' | 'center' | 'end';
+/** Position a layer entry relative to a focusable, a rect, or the screen. */
+export type LayerPosition = {
+    kind: 'center';
+} | {
+    kind: 'screen';
+    rect: Partial<Rect>;
+} | {
+    kind: 'anchor';
+    targetId: string;
+    side: AnchorSide;
+    align?: AnchorAlign;
+    offset?: number;
+} | {
+    kind: 'point';
+    x: number;
+    y: number;
+} | {
+    kind: 'cursor';
+};
+export interface LayerEntry {
+    id: string;
+    layer: LayerName;
+    node: ComponentNode;
+    position?: LayerPosition;
+    /** Dim everything beneath. Modals want this. */
+    scrim?: boolean;
+    /** Trap focus inside and restore it on close. */
+    trapFocus?: boolean;
+    /** Escape closes it. */
+    dismissOnEscape?: boolean;
+    /** A click outside closes it. */
+    dismissOnOutsideClick?: boolean;
+    /** Auto-remove after this many ms. Toasts want this. */
+    timeoutMs?: number;
+    onClose?(reason: 'escape' | 'outside' | 'timeout' | 'api'): void;
+    order?: number;
+}
+export interface LayerManager {
+    open(entry: LayerEntry): Disposable;
+    close(id: string, reason?: 'escape' | 'outside' | 'timeout' | 'api'): void;
+    closeLayer(layer: LayerName): void;
+    entries(layer?: LayerName): LayerEntry[];
+    /** The innermost entry that traps focus, if any. */
+    topmostTrap(): LayerEntry | null;
+    update(id: string, patch: Partial<LayerEntry>): void;
+}
+//# sourceMappingURL=layer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"layer.d.ts","sourceRoot":"","sources":["../../src/types/layer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAE1C,qEAAqE;AACrE,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,UAAU,GAAG,OAAO,GAAG,cAAc,GAAG,OAAO,CAAC;AAEjF,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC;AAC7D,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,QAAQ,GAAG,KAAK,CAAC;AAErD,6EAA6E;AAC7E,MAAM,MAAM,aAAa,GACrB;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,GAClB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE,GACvC;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,UAAU,CAAC;IAAC,KAAK,CAAC,EAAE,WAAW,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAC5F;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,GACvC;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,CAAC;AAEvB,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,SAAS,CAAC;IACjB,IAAI,EAAE,aAAa,CAAC;IACpB,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB,gDAAgD;IAChD,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,iDAAiD;IACjD,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,wBAAwB;IACxB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,iCAAiC;IACjC,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,wDAAwD;IACxD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,CAAC,MAAM,EAAE,QAAQ,GAAG,SAAS,GAAG,SAAS,GAAG,KAAK,GAAG,IAAI,CAAC;IACjE,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,KAAK,EAAE,UAAU,GAAG,UAAU,CAAC;IACpC,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,QAAQ,GAAG,SAAS,GAAG,SAAS,GAAG,KAAK,GAAG,IAAI,CAAC;IAC3E,UAAU,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,CAAC;IACnC,OAAO,CAAC,KAAK,CAAC,EAAE,SAAS,GAAG,UAAU,EAAE,CAAC;IACzC,oDAAoD;IACpD,WAAW,IAAI,UAAU,GAAG,IAAI,CAAC;IACjC,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC;CACtD"}

package/dist/types/layer.js

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

package/dist/types/manifest.d.ts

@@ -0,0 +1,114 @@
+import type { Disposable } from './disposable.js';
+import type { ComponentDefinition } from './component-registry.js';
+import type { CommandDefinition } from './command.js';
+import type { KeybindingDefinition } from './keybinding.js';
+import type { ThemeDefinition } from './theme.js';
+import type { ShellDefinition } from './shell.js';
+import type { LayoutDefinition, Mount } from './surface.js';
+import type { ScreenDefinition } from './navigation.js';
+import type { ResourceActionDefinition, ResourceEditorDefinition, ResourceKind, ResourceProvider, ResourceViewerDefinition } from './resource.js';
+import type { ComputedDefinition, DataProviderDefinition } from './store.js';
+import type { BindingPath } from './graph.js';
+import type { CapabilityName } from './capabilities.js';
+/**
+ * One source contributing to the typed registries. Deliberately not a generic
+ * plugin bag: every category is its own list with its own type, so a bad
+ * contribution fails where it is written.
+ */
+export interface ManifestSource {
+    id: string;
+    version?: string;
+    displayName?: string;
+    /** One line, for a list of sources that has room to say what each one is. */
+    description?: string;
+}
+export interface Contributes {
+    components?: ComponentDefinition[];
+    commands?: CommandDefinition[];
+    keybindings?: KeybindingDefinition[];
+    themes?: ThemeDefinition[];
+    shells?: ShellDefinition[];
+    layouts?: LayoutDefinition[];
+    screens?: ScreenDefinition[];
+    views?: Mount[];
+    resourceKinds?: ResourceKind[];
+    resourceProviders?: ResourceProvider[];
+    resourceViewers?: ResourceViewerDefinition[];
+    resourceEditors?: ResourceEditorDefinition[];
+    resourceActions?: ResourceActionDefinition[];
+    dataProviders?: DataProviderDefinition[];
+    computed?: {
+        path: BindingPath;
+        def: ComputedDefinition;
+    }[];
+}
+export interface Manifest {
+    source: ManifestSource;
+    /** Other manifest ids that must load first. */
+    requires?: string[];
+    engine?: {
+        textui: string;
+    };
+    /** Refuse to load without these terminal capabilities. */
+    requiresCapabilities?: CapabilityName[];
+    contributes?: Contributes;
+}
+export interface ManifestAPI {
+    load(manifest: Manifest): Promise<Disposable>;
+    unload(sourceId: string): void;
+    sources(): ManifestSource[];
+    loaded(sourceId: string): boolean;
+}
+/**
+ * Registry manifest metadata - what the CLI reads to copy a component's source
+ * into a user's project and to tell later what changed upstream.
+ */
+export interface RegistryComponentManifest {
+    name: string;
+    description?: string;
+    category?: string;
+    version: string;
+    /** Files copied into the project, relative to the registry root. */
+    files: {
+        path: string;
+        target?: string;
+        type?: 'component' | 'style' | 'test' | 'example';
+    }[];
+    /** Other registry components this one needs. */
+    dependencies?: string[];
+    /** npm packages this one needs. */
+    npmDependencies?: Record<string, string>;
+    requiredCapabilities?: CapabilityName[];
+    optionalCapabilities?: CapabilityName[];
+    variants?: string[];
+    /** Store paths this component binds to by convention. */
+    storeBindings?: string[];
+    related?: string[];
+    examples?: {
+        name: string;
+        file: string;
+    }[];
+    /** Templates that include this component. */
+    templates?: string[];
+    /** Content hash of the copied files, so the CLI can detect local edits. */
+    hash?: string;
+}
+export interface RegistryManifest {
+    name: string;
+    version: string;
+    description?: string;
+    homepage?: string;
+    components: RegistryComponentManifest[];
+    themes?: {
+        name: string;
+        file: string;
+        appearance: 'light' | 'dark';
+    }[];
+    templates?: {
+        name: string;
+        description?: string;
+        files: string[];
+        components: string[];
+    }[];
+}
+//# sourceMappingURL=manifest.d.ts.map

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

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

package/dist/types/manifest.js

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

package/dist/types/markdown.d.ts

@@ -0,0 +1,58 @@
+import type { StyleColor } from './style.js';
+/**
+ * Markdown, as rows a terminal can scroll.
+ *
+ * Two shapes and one invariant: **every row is exactly one row tall.** That is
+ * what makes "how far can this scroll" a length rather than an estimate - one
+ * source line becomes three rows when it wraps and none when it is a fence
+ * marker, so counting source lines is counting the wrong unit and the tail of
+ * a long document becomes unreachable.
+ *
+ * A fence is the exception that proves it: it is several rows, so it becomes
+ * several rows here, each tagged with the fence it belongs to so a painter can
+ * put the visible ones back into one box.
+ */
+/** A run of text with one style. Inline emphasis is why rows are not strings. */
+export interface MarkdownRun {
+    text: string;
+    bold?: boolean;
+    italic?: boolean;
+    code?: boolean;
+    /** An OSC 8 target, where the terminal has hyperlinks. */
+    link?: string;
+}
+export type MarkdownRow = {
+    kind: 'rule';
+} | {
+    kind: 'heading';
+    runs: MarkdownRun[];
+    level: number;
+} | {
+    kind: 'text';
+    runs: MarkdownRun[];
+    prefix?: string;
+    prefixFg?: StyleColor;
+    fg?: StyleColor;
+} | {
+    kind: 'fence';
+    fence: number;
+    part: 'open' | 'code' | 'close';
+    text?: string;
+    language?: string;
+};
+export interface MarkdownLayoutOptions {
+    /** Cells to wrap to. Zero means "not measured yet" - nothing is wrapped. */
+    width: number;
+    /** The bullet glyph. Passed in, because glyphs come from the theme. */
+    bullet?: string;
+    /** The rule down the left of a block quote. Also a theme glyph. */
+    quoteBar?: string;
+    /**
+     * Whether a fence gets an opening and closing rule row.
+     *
+     * A borderless theme draws neither, and a layout that reserved two rows for
+     * rules nobody draws stops two rows short of the end of the document.
+     */
+    ruled?: boolean;
+}
+//# sourceMappingURL=markdown.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.d.ts","sourceRoot":"","sources":["../../src/types/markdown.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C;;;;;;;;;;;;GAYG;AAEH,iFAAiF;AACjF,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,0DAA0D;IAC1D,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,MAAM,WAAW,GACnB;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,WAAW,EAAE,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACvD;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,WAAW,EAAE,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,UAAU,CAAC;IAAC,EAAE,CAAC,EAAE,UAAU,CAAA;CAAE,GAC9F;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAExG,MAAM,WAAW,qBAAqB;IACpC,4EAA4E;IAC5E,KAAK,EAAE,MAAM,CAAC;IACd,uEAAuE;IACvE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mEAAmE;IACnE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;;OAKG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB"}

package/dist/types/markdown.js

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

package/dist/types/navigation.d.ts

@@ -0,0 +1,40 @@
+import type { Disposable } from './disposable.js';
+import type { ComponentNode } from './graph.js';
+import type { MountDisplay, SurfaceName } from './surface.js';
+/**
+ * Screens and a stack, not a router. An application that wants URLs maps them
+ * onto screens itself.
+ */
+export interface ScreenDefinition {
+    id: string;
+    /** Component name, or the node itself. */
+    component: string | ComponentNode;
+    display?: MountDisplay;
+    /**
+     * Where it mounts. `main` unless a screen wants to live somewhere else - a
+     * surface is the application's word, so this is open like the rest of them.
+     */
+    surface?: SurfaceName;
+    /** Screens keep their store scope when navigated away from. */
+    keepAlive?: boolean;
+}
+export interface ScreenEntry {
+    id: string;
+    params?: Record<string, unknown>;
+    /** Focus id to restore when this entry becomes current again. */
+    restoreFocus?: string | null;
+}
+export interface Navigator {
+    register(screen: ScreenDefinition): Disposable;
+    screens(): ScreenDefinition[];
+    get(id: string): ScreenDefinition | undefined;
+    push(id: string, params?: Record<string, unknown>): void;
+    replace(id: string, params?: Record<string, unknown>): void;
+    pop(): boolean;
+    popTo(id: string): boolean;
+    reset(id: string, params?: Record<string, unknown>): void;
+    current(): ScreenEntry | null;
+    stack(): ScreenEntry[];
+    canGoBack(): boolean;
+}
+//# sourceMappingURL=navigation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"navigation.d.ts","sourceRoot":"","sources":["../../src/types/navigation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE9D;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,0CAA0C;IAC1C,SAAS,EAAE,MAAM,GAAG,aAAa,CAAC;IAClC,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB;;;OAGG;IACH,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,+DAA+D;IAC/D,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,iEAAiE;IACjE,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,MAAM,EAAE,gBAAgB,GAAG,UAAU,CAAC;IAC/C,OAAO,IAAI,gBAAgB,EAAE,CAAC;IAC9B,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS,CAAC;IAC9C,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACzD,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC5D,GAAG,IAAI,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;IAC3B,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC1D,OAAO,IAAI,WAAW,GAAG,IAAI,CAAC;IAC9B,KAAK,IAAI,WAAW,EAAE,CAAC;IACvB,SAAS,IAAI,OAAO,CAAC;CACtB"}

package/dist/types/navigation.js

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

package/dist/types/render.d.ts

@@ -0,0 +1,72 @@
+import type { Rect, Size } from './geometry.js';
+import type { Cell, Color } from './cells.js';
+import type { Attrs } from './cells.js';
+import type { Style } from './style.js';
+import type { ResolvedTheme } from './theme.js';
+import type { TerminalCapabilities } from './capabilities.js';
+import type { ComponentNode } from './graph.js';
+/** What a host component paints onto. Clipped to the node's own rect. */
+export interface PaintSurface {
+    readonly rect: Rect;
+    /** Write a grapheme at a content-relative cell. Out of bounds is a no-op. */
+    put(x: number, y: number, char: string, style?: CellStyle): void;
+    /** Write a string, advancing by grapheme width. Returns cells consumed. */
+    text(x: number, y: number, text: string, style?: CellStyle): number;
+    fill(rect: Rect | undefined, char: string, style?: CellStyle): void;
+    /** Direct cell write, for painters that already resolved everything. */
+    cell(x: number, y: number, cell: Cell): void;
+    /** A sub-surface, clipped and offset. */
+    clip(rect: Rect): PaintSurface;
+}
+export interface CellStyle {
+    fg?: Color;
+    bg?: Color;
+    attrs?: Attrs;
+    link?: string;
+}
+/** Everything a host needs that is not its props. */
+export interface RenderContext {
+    theme: ResolvedTheme;
+    capabilities: TerminalCapabilities;
+    /** Interaction state, already resolved for this instance. */
+    focused: boolean;
+    hovered: boolean;
+    active: boolean;
+    selected: boolean;
+    disabled: boolean;
+    /** Resolve a style token or literal to a concrete colour. */
+    color(c: unknown, fallback?: Color): Color;
+    /** Glyph for a role, downgraded to ascii when the terminal demands it. */
+    glyph(name: string): string;
+    /** Measure a string in terminal cells, honouring wide and zero-width. */
+    measureText(text: string): number;
+}
+export interface MeasureConstraints {
+    /** Infinity means "as much as you want". */
+    maxWidth: number;
+    maxHeight: number;
+    minWidth: number;
+    minHeight: number;
+}
+/**
+ * A host component is a primitive that participates in layout and paint
+ * directly. There are deliberately few of them - Box, Text and Canvas - and
+ * the entire catalog is function components composing those, so the layout
+ * engine only ever reasons about three shapes.
+ */
+export interface HostComponent<P = Record<string, unknown>> {
+    name: string;
+    /** Style contributed by props, merged under the node's own `style` prop. */
+    style?(props: P, ctx: RenderContext): Style | undefined;
+    /** Intrinsic size when the style does not fix one. */
+    measure?(props: P, ctx: RenderContext, constraints: MeasureConstraints): Size;
+    /** Paint the content box. Border and background are painted by the runtime. */
+    paint?(surface: PaintSurface, props: P, ctx: RenderContext): void;
+    /** True when this host lays out children (Box). */
+    container?: boolean;
+    /** Never receives children; a children prop is a programmer error. */
+    leaf?: boolean;
+}
+export type FunctionComponent<P = any> = (props: P) => RenderOutput;
+export type RenderOutput = ComponentNode | ComponentNode[] | string | number | null | undefined | false | RenderOutput[];
+//# sourceMappingURL=render.d.ts.map

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

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

package/dist/types/render.js

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

package/dist/types/resource.d.ts

@@ -0,0 +1,170 @@
+import type { Disposable } from './disposable.js';
+import type { ComponentNode } from './graph.js';
+import type { WhenClause } from './when.js';
+import type { CommandHandler } from './command.js';
+import type { SemanticVariant } from './style.js';
+/**
+ * A resource is anything addressable that a viewer, an editor or an action can
+ * be registered for - a file, a record, a log stream, a service, a chart
+ * source. The filesystem is one provider among several, not the model.
+ */
+export type ResourceURI = string;
+export interface ResourceKind {
+    /** Stable id: 'file.markdown', 'service', 'log.stream'. */
+    id: string;
+    title: string;
+    icon?: string;
+    /**
+     * What colour the icon is, as a role rather than a colour.
+     *
+     * Named the way every other tone in the library is, so a kind picks
+     * "informational" and the theme decides what that looks like - a kind
+     * carrying `#d19a66` would be a kind that looks wrong in half the themes.
+     */
+    tone?: SemanticVariant;
+    /** MIME types this kind claims. */
+    mimeTypes?: string[];
+    /** Filename globs this kind claims. */
+    extensions?: string[];
+    /** Kinds this one specialises. `file.markdown` extends `file.text`. */
+    extends?: string;
+    /** Higher wins when several kinds match. */
+    priority?: number;
+    /** Last word on ambiguous matches. */
+    detect?(uri: ResourceURI, meta: ResourceMetadata): boolean;
+}
+export interface ResourceMetadata {
+    name: string;
+    size?: number;
+    modified?: number;
+    created?: number;
+    mimeType?: string;
+    readonly?: boolean;
+    /** Provider-specific extras. */
+    [key: string]: unknown;
+}
+/**
+ * What a *resource* can have done to it - not what its provider implements.
+ *
+ * Per resource on purpose: a read-only mount, a file the user has no
+ * permission on, and something inherently immutable all come back the same
+ * shape, and a caller deciding whether to offer Delete should never have to
+ * know which of the three it is looking at.
+ *
+ * This is what to ask before calling; the registry method still throws if the
+ * answer changed in between. `stream` is the odd one - declarative only, no
+ * registry method reads it. It stays for a log provider to claim, and comes
+ * out if none does.
+ */
+export type ResourceCapability = 'read' | 'write' | 'delete' | 'rename' | 'list' | 'watch' | 'stream';
+export interface Resource {
+    uri: ResourceURI;
+    kind: string;
+    metadata: ResourceMetadata;
+    capabilities: ResourceCapability[];
+}
+/** Where resources come from. One per URI scheme. */
+export interface ResourceProvider {
+    scheme: string;
+    stat(uri: ResourceURI): Promise<Resource | null>;
+    list?(uri: ResourceURI): Promise<Resource[]>;
+    read?(uri: ResourceURI): Promise<string | Uint8Array>;
+    write?(uri: ResourceURI, content: string | Uint8Array): Promise<void>;
+    delete?(uri: ResourceURI): Promise<void>;
+    rename?(from: ResourceURI, to: ResourceURI): Promise<void>;
+    watch?(uri: ResourceURI, fn: (event: 'change' | 'create' | 'delete') => void): Disposable;
+}
+/** A component that can display one kind of resource. */
+export interface ResourceViewerDefinition {
+    id: string;
+    title: string;
+    kinds: string[];
+    /** Component name; receives `{ resource, content }`. */
+    component: string;
+    icon?: string;
+    /** As on a kind. A renderer that declares one speaks for what it opens. */
+    tone?: SemanticVariant;
+    priority?: number;
+    when?: WhenClause;
+    /** Accept anything no specific viewer claims. */
+    fallback?: boolean;
+}
+export interface ResourceEditorDefinition extends ResourceViewerDefinition {
+    /** Editors must be able to hand back new content. */
+    saves: true;
+}
+export interface ResourceActionDefinition {
+    id: string;
+    title: string;
+    kinds: string[];
+    icon?: string;
+    when?: WhenClause;
+    /** Where the action offers itself: 'context', 'toolbar', 'palette'. */
+    slots?: string[];
+    priority?: number;
+    run: CommandHandler;
+}
+export interface ResourceRegistry {
+    registerKind(kind: ResourceKind): Disposable;
+    registerProvider(provider: ResourceProvider): Disposable;
+    registerViewer(def: ResourceViewerDefinition): Disposable;
+    registerEditor(def: ResourceEditorDefinition): Disposable;
+    registerAction(def: ResourceActionDefinition): Disposable;
+    kinds(): ResourceKind[];
+    /** Classify a resource: extension, then mime, then `detect`, then parent. */
+    detectKind(uri: ResourceURI, meta?: ResourceMetadata): string;
+    /** True when `kind` is `ancestor` or specialises it. */
+    kindMatches(kind: string, ancestor: string): boolean;
+    stat(uri: ResourceURI): Promise<Resource | null>;
+    list(uri: ResourceURI): Promise<Resource[]>;
+    read(uri: ResourceURI): Promise<string | Uint8Array>;
+    write(uri: ResourceURI, content: string | Uint8Array): Promise<void>;
+    /** Throws when the provider cannot. Ask `Resource.capabilities` first. */
+    delete(uri: ResourceURI): Promise<void>;
+    /** Within one scheme. Across two it throws - that is a copy and a delete. */
+    rename(from: ResourceURI, to: ResourceURI): Promise<void>;
+    /** A provider that cannot watch gives back a disposable that does nothing. */
+    watch(uri: ResourceURI, fn: (event: 'change' | 'create' | 'delete') => void): Disposable;
+    viewersFor(kind: string): ResourceViewerDefinition[];
+    editorsFor(kind: string): ResourceEditorDefinition[];
+    /** Every renderer for this kind - editors, viewers and openers - best first. */
+    renderersFor(kind: string): ResourceRendererDefinition[];
+    /**
+     * The icon and tone for a resource: the renderer that opens it, then the
+     * kind and whatever it extends. Empty when nobody has said.
+     */
+    appearanceOf(resource: {
+        kind: string;
+    }): {
+        icon?: string;
+        tone?: SemanticVariant;
+    };
+    actionsFor(kind: string, slot?: string): ResourceActionDefinition[];
+    /** The node that displays this resource, viewer chosen by the registry. */
+    nodeFor(resource: Resource, options?: {
+        viewerId?: string;
+        mode?: 'view' | 'edit';
+    }): ComponentNode | null;
+}
+/**
+ * One way of showing a resource.
+ *
+ * A viewer, an editor and a component that declared `opens` are three ways of
+ * registering the same thing: a component that can put this kind on screen.
+ * A panel wants the list, not the three lists - which one saves is a property
+ * of the renderer, not a different registry.
+ */
+export interface ResourceRendererDefinition {
+    id: string;
+    title: string;
+    kinds: string[];
+    component: string;
+    icon?: string;
+    /** As on a kind. A renderer that declares one speaks for what it opens. */
+    tone?: SemanticVariant;
+    priority?: number;
+    when?: WhenClause;
+    /** True when this renderer can write the resource back. */
+    saves?: boolean;
+}
+//# sourceMappingURL=resource.d.ts.map

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

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

package/dist/types/resource.js

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

package/dist/types/services.d.ts

@@ -0,0 +1,24 @@
+import type { Disposable } from './disposable.js';
+/**
+ * A service key is a typed token. This is a lookup table with types, not a
+ * dependency-injection container - there is no lifecycle, no scoping and no
+ * auto-wiring, on purpose.
+ */
+export interface ServiceKey<T> {
+    readonly id: string;
+    /** Never present at runtime; carries the type. */
+    readonly __type?: T;
+}
+export declare function serviceKey<T>(id: string): ServiceKey<T>;
+export interface ServiceContainer {
+    provide<T>(key: ServiceKey<T>, value: T): Disposable;
+    /** Created on first use. */
+    provideLazy<T>(key: ServiceKey<T>, factory: () => T): Disposable;
+    get<T>(key: ServiceKey<T>): T | undefined;
+    /** Throws with the key id when missing - a clear programmer error. */
+    require<T>(key: ServiceKey<T>): T;
+    has<T>(key: ServiceKey<T>): boolean;
+    /** A child container that falls back to this one. */
+    child(): ServiceContainer;
+}
+//# sourceMappingURL=services.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"services.d.ts","sourceRoot":"","sources":["../../src/types/services.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD;;;;GAIG;AACH,MAAM,WAAW,UAAU,CAAC,CAAC;IAC3B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,kDAAkD;IAClD,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;CACrB;AAED,wBAAgB,UAAU,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,GAAG,UAAU,CAAC,CAAC,CAAC,CAEvD;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,CAAC,CAAC,EAAE,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,UAAU,CAAC;IACrD,4BAA4B;IAC5B,WAAW,CAAC,CAAC,EAAE,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,GAAG,UAAU,CAAC;IACjE,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC;IAC1C,sEAAsE;IACtE,OAAO,CAAC,CAAC,EAAE,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IAClC,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC;IACpC,qDAAqD;IACrD,KAAK,IAAI,gBAAgB,CAAC;CAC3B"}

package/dist/types/services.js

@@ -0,0 +1,3 @@
+export function serviceKey(id) {
+    return { id };
+}

package/dist/types/shell.d.ts

@@ -0,0 +1,32 @@
+import type { Disposable } from './disposable.js';
+import type { SurfaceName } from './surface.js';
+/**
+ * The shell is the frame around the surfaces. Where it puts them is the whole
+ * of what a shell decides - which is why the same application renders as a
+ * dense bordered console, an airy borderless report or a full workbench by
+ * changing one registration.
+ */
+export interface ShellDefinition {
+    id: string;
+    title: string;
+    description?: string;
+    /** Component name; receives `{ surfaces, renderSurface }`. */
+    component: string;
+    /** Surfaces this shell renders. Others stay unmounted. */
+    surfaces?: SurfaceName[];
+    /** Default theme id this shell was designed against. */
+    theme?: string;
+    /** Below this width or height the shell is not offered. */
+    minSize?: {
+        width?: number;
+        height?: number;
+    };
+}
+export interface ShellRegistry {
+    register(def: ShellDefinition): Disposable;
+    get(id: string): ShellDefinition | undefined;
+    list(): ShellDefinition[];
+    /** Shells that fit the current terminal, best first. */
+    suitable(width: number, height: number): ShellDefinition[];
+}
+//# sourceMappingURL=shell.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"shell.d.ts","sourceRoot":"","sources":["../../src/types/shell.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,8DAA8D;IAC9D,SAAS,EAAE,MAAM,CAAC;IAClB,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAC;IACzB,wDAAwD;IACxD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2DAA2D;IAC3D,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC/C;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,GAAG,EAAE,eAAe,GAAG,UAAU,CAAC;IAC3C,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAAC;IAC7C,IAAI,IAAI,eAAe,EAAE,CAAC;IAC1B,wDAAwD;IACxD,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,eAAe,EAAE,CAAC;CAC5D"}

package/dist/types/shell.js

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