@textui/core 0.1.0

package/dist/runtime/instance.d.ts

@@ -0,0 +1,106 @@
+import type { BindingPath, ComponentNode } from '../types/graph.js';
+import type { ComponentDefinition } from '../types/component-registry.js';
+import type { Disposable } from '../types/disposable.js';
+import type { FunctionComponent, HostComponent } from '../types/render.js';
+import type { LayoutBox } from '../render/layout.js';
+import type { Rect, Size } from '../types/geometry.js';
+import type { Runtime } from './runtime.js';
+import { type ResolveContext } from './bindings.js';
+export type HookSlot = {
+    kind: string;
+    value: unknown;
+    deps?: unknown[];
+    cleanup?: (() => void) | void;
+};
+export type InstanceKind = 'function' | 'host' | 'template' | 'missing';
+/**
+ * One mounted node.
+ *
+ * The tree is retained between frames, which is the whole reason hooks can
+ * hold state and the renderer can diff rather than redraw: an instance whose
+ * node and props are unchanged is not re-rendered at all.
+ */
+export interface Instance {
+    id: string;
+    component: string;
+    kind: InstanceKind;
+    key: string | number | undefined;
+    node: ComponentNode;
+    props: Record<string, unknown>;
+    fn?: FunctionComponent;
+    host?: HostComponent;
+    definition?: ComponentDefinition;
+    parent: Instance | null;
+    children: Instance[];
+    hooks: HookSlot[];
+    hookIndex: number;
+    /** Store paths this instance's props read. Re-render when one changes. */
+    reads: Set<string>;
+    subscriptions: Disposable[];
+    dataContext?: BindingPath;
+    /** Context values provided by this instance, by context id. */
+    contexts?: Map<string, unknown>;
+    dirty: boolean;
+    /**
+     * A descendant is dirty. Without this the render pass stops at the first
+     * clean ancestor and never reaches the component that actually changed -
+     * which is exactly what happens when a text field deep inside a mounted
+     * surface updates its own state.
+     */
+    childDirty: boolean;
+    mounted: boolean;
+    /** Set when this subtree threw; a boundary renders its fallback instead. */
+    error?: unknown;
+    /** Why the last render ran. Diagnostics only. */
+    renderReason?: string;
+    /** Filled by the layout pass for host instances. */
+    box?: LayoutBox;
+    /** Last content rect observed by `useMeasure`, if this instance asked. */
+    measured?: Rect;
+    /** Content extent when it overflows that rect, for `useScrollExtent`. */
+    scrollExtent?: Size;
+    /** The child nodes produced by the last render, for a children-only pass. */
+    lastChildren: {
+        node: ComponentNode;
+        dataContext?: BindingPath;
+    }[];
+    /** Effects queued during this render, flushed after the frame commits. */
+    pendingEffects: (() => void)[];
+    runtime: Runtime;
+}
+export declare function createInstance(runtime: Runtime, node: ComponentNode, parent: Instance | null): Instance;
+/** Flatten render output into nodes. Strings and numbers become text nodes. */
+export declare function normalizeChildren(output: unknown): ComponentNode[];
+/**
+ * Expand `{ template, path }` into one node per item, each with its own data
+ * context - which is what lets one templated node render a hundred rows.
+ */
+export declare function expandTemplate(runtime: Runtime, spec: {
+    template: ComponentNode;
+    path: BindingPath;
+}, dataContext: BindingPath | undefined): {
+    nodes: ComponentNode[];
+    contexts: BindingPath[];
+    read: string;
+};
+export declare function resolveContextFor(instance: Instance): ResolveContext;
+/** Look up a context value by walking the parent chain. */
+export declare function readContext(instance: Instance, contextId: string): unknown;
+export declare function emptyBox(): LayoutBox;
+/** Depth-first walk, parents before children. */
+export declare function walkInstances(root: Instance, visit: (i: Instance) => void): void;
+export declare function unmountInstance(instance: Instance): void;
+/** Re-resolve props and note which store paths this instance now depends on. */
+export declare function updateProps(instance: Instance, node: ComponentNode): void;
+export declare function findFunction(runtime: Runtime, node: ComponentNode): {
+    kind: InstanceKind;
+    fn?: FunctionComponent;
+    host?: HostComponent;
+    definition?: ComponentDefinition;
+};
+/**
+ * Mark an instance for re-render, and tell its ancestors a descendant changed
+ * so the render pass will walk down to it.
+ */
+export declare function markDirty(instance: Instance, reason: string): void;
+//# sourceMappingURL=instance.d.ts.map

package/dist/runtime/instance.d.ts.map

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

package/dist/runtime/instance.js

@@ -0,0 +1,181 @@
+import { isComponentNode } from '../types/graph.js';
+import { ZERO_EDGES } from '../types/geometry.js';
+import { isTemplateChildren, resolveProps } from './bindings.js';
+import { nodeFunction } from '../jsx/factory.js';
+import { joinPath } from '../util/paths.js';
+let nextId = 1;
+export function createInstance(runtime, node, parent) {
+    return {
+        id: node.id ?? `n${nextId++}`,
+        component: node.component,
+        kind: 'missing',
+        key: node.key,
+        node,
+        props: {},
+        parent,
+        children: [],
+        hooks: [],
+        hookIndex: 0,
+        reads: new Set(),
+        subscriptions: [],
+        dataContext: parent?.dataContext,
+        lastChildren: [],
+        dirty: true,
+        childDirty: false,
+        mounted: false,
+        pendingEffects: [],
+        runtime,
+    };
+}
+/** Flatten render output into nodes. Strings and numbers become text nodes. */
+export function normalizeChildren(output) {
+    const out = [];
+    const walk = (value) => {
+        if (value === null || value === undefined || value === false || value === true)
+            return;
+        if (Array.isArray(value)) {
+            for (const item of value)
+                walk(item);
+            return;
+        }
+        if (typeof value === 'string' || typeof value === 'number') {
+            const content = String(value);
+            if (content !== '')
+                out.push({ component: 'text', content });
+            return;
+        }
+        if (isComponentNode(value)) {
+            out.push(value);
+            return;
+        }
+        // Anything else is a programmer error worth seeing rather than swallowing.
+        out.push({ component: 'text', content: String(value) });
+    };
+    walk(output);
+    return out;
+}
+/**
+ * Expand `{ template, path }` into one node per item, each with its own data
+ * context - which is what lets one templated node render a hundred rows.
+ */
+export function expandTemplate(runtime, spec, dataContext) {
+    const base = spec.path.startsWith('$/')
+        ? spec.path
+        : joinPath(dataContext ?? '$/', spec.path);
+    const items = runtime.store.get(base);
+    const list = Array.isArray(items) ? items : [];
+    const nodes = [];
+    const contexts = [];
+    for (let i = 0; i < list.length; i++) {
+        const item = list[i];
+        const key = item && typeof item === 'object' && 'id' in item ? String(item.id) : String(i);
+        nodes.push({ ...spec.template, key });
+        contexts.push(joinPath(base, String(i)));
+    }
+    return { nodes, contexts, read: base };
+}
+export function resolveContextFor(instance) {
+    return {
+        store: instance.runtime.store,
+        dataContext: instance.dataContext,
+        execute: (id, args) => instance.runtime.execute(id, args),
+        emit: (path, payload) => instance.runtime.emit(path, payload),
+        reads: new Set(),
+    };
+}
+/** Look up a context value by walking the parent chain. */
+export function readContext(instance, contextId) {
+    let cursor = instance;
+    while (cursor) {
+        const value = cursor.contexts?.get(contextId);
+        if (value !== undefined)
+            return value;
+        cursor = cursor.parent;
+    }
+    return undefined;
+}
+export function emptyBox() {
+    return {
+        style: {},
+        borderEdges: ZERO_EDGES,
+        children: [],
+        rect: { x: 0, y: 0, width: 0, height: 0 },
+        content: { x: 0, y: 0, width: 0, height: 0 },
+    };
+}
+/** Depth-first walk, parents before children. */
+export function walkInstances(root, visit) {
+    visit(root);
+    for (const child of root.children)
+        walkInstances(child, visit);
+}
+export function unmountInstance(instance) {
+    for (const child of instance.children)
+        unmountInstance(child);
+    instance.children = [];
+    for (const hook of instance.hooks) {
+        if (typeof hook.cleanup === 'function') {
+            try {
+                hook.cleanup();
+            }
+            catch (err) {
+                instance.runtime.onError(err, `cleanup in <${instance.component}>`);
+            }
+        }
+    }
+    instance.hooks = [];
+    for (const sub of instance.subscriptions)
+        sub.dispose();
+    instance.subscriptions = [];
+    instance.mounted = false;
+}
+/** Re-resolve props and note which store paths this instance now depends on. */
+export function updateProps(instance, node) {
+    const ctx = resolveContextFor(instance);
+    const nextContext = node.dataContext;
+    if (typeof nextContext === 'string') {
+        instance.dataContext = nextContext;
+        ctx.dataContext = instance.dataContext;
+    }
+    instance.node = node;
+    instance.props = resolveProps(ctx, node);
+    // Children that are a templated list read their source path too.
+    const children = instance.props.children;
+    if (isTemplateChildren(children)) {
+        const expanded = expandTemplate(instance.runtime, children, instance.dataContext);
+        ctx.reads.add(expanded.read);
+    }
+    instance.reads = ctx.reads;
+}
+export function findFunction(runtime, node) {
+    const inline = nodeFunction(node);
+    if (inline)
+        return { kind: 'function', fn: inline };
+    const def = runtime.components.get(node.component);
+    if (!def)
+        return { kind: 'missing' };
+    switch (def.renderer.kind) {
+        case 'function':
+            return { kind: 'function', fn: def.renderer.render, definition: def };
+        case 'host':
+            return { kind: 'host', host: def.renderer.host, definition: def };
+        case 'template':
+            return { kind: 'template', definition: def };
+        case 'lazy':
+            // Not resolved yet; the registry resolves it and asks for another frame.
+            return { kind: 'missing', definition: def };
+    }
+}
+/**
+ * Mark an instance for re-render, and tell its ancestors a descendant changed
+ * so the render pass will walk down to it.
+ */
+export function markDirty(instance, reason) {
+    instance.dirty = true;
+    instance.renderReason = reason;
+    let cursor = instance.parent;
+    while (cursor && !cursor.childDirty) {
+        cursor.childDirty = true;
+        cursor = cursor.parent;
+    }
+}

package/dist/runtime/paint.d.ts

@@ -0,0 +1,27 @@
+import type { Rect } from '../types/geometry.js';
+import type { ResolvedTheme } from '../types/theme.js';
+import type { TerminalCapabilities } from '../types/capabilities.js';
+import type { RenderContext } from '../types/render.js';
+import type { LayoutBox } from '../render/layout.js';
+import type { Instance } from './instance.js';
+import type { Buffer } from '../render/buffer.js';
+import { type PackedColor } from '../render/color.js';
+import { type InteractionState } from './style.js';
+export declare function createRenderContext(theme: ResolvedTheme, capabilities: TerminalCapabilities, state?: InteractionState): RenderContext;
+export interface PaintEnv {
+    theme: ResolvedTheme;
+    capabilities: TerminalCapabilities;
+    /** Interaction state for an instance, resolved by the runtime. */
+    stateOf(instance: Instance): InteractionState;
+}
+/** Colour and attributes handed down to a box's children. */
+interface Inherited {
+    fg: PackedColor;
+    bg: PackedColor;
+    attrs: number;
+}
+/** Boxes contributed by an instance. Function components contribute none. */
+export declare function buildBoxes(instance: Instance, env: PaintEnv, inherited?: Inherited): LayoutBox[];
+export declare function paintTree(buffer: Buffer, instance: Instance, env: PaintEnv, clip: Rect): void;
+export {};
+//# sourceMappingURL=paint.d.ts.map

package/dist/runtime/paint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paint.d.ts","sourceRoot":"","sources":["../../src/runtime/paint.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAEjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAGrE,OAAO,KAAK,EAA2B,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACjF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAErD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAiC,KAAK,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAMrF,OAAO,EAES,KAAK,gBAAgB,EACpC,MAAM,YAAY,CAAC;AAwHpB,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,aAAa,EACpB,YAAY,EAAE,oBAAoB,EAClC,KAAK,GAAE,gBAAiC,GACvC,aAAa,CAiBf;AAID,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,aAAa,CAAC;IACrB,YAAY,EAAE,oBAAoB,CAAC;IACnC,kEAAkE;IAClE,OAAO,CAAC,QAAQ,EAAE,QAAQ,GAAG,gBAAgB,CAAC;CAC/C;AAeD,6DAA6D;AAC7D,UAAU,SAAS;IACjB,EAAE,EAAE,WAAW,CAAC;IAChB,EAAE,EAAE,WAAW,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AA4DD,6EAA6E;AAC7E,wBAAgB,UAAU,CACxB,QAAQ,EAAE,QAAQ,EAClB,GAAG,EAAE,QAAQ,EACb,SAAS,GAAE,SAA0B,GACpC,SAAS,EAAE,CAwDb;AA4DD,wBAAgB,SAAS,CACvB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,QAAQ,EAClB,GAAG,EAAE,QAAQ,EACb,IAAI,EAAE,IAAI,GACT,IAAI,CA4FN"}