@textui/core 0.1.0

package/dist/core/when.js

@@ -0,0 +1,224 @@
+const OPERATORS = ['&&', '||', '==', '!=', '>=', '<=', '=~', '!', '>', '<', '(', ')'];
+function tokenize(input) {
+    const out = [];
+    let i = 0;
+    while (i < input.length) {
+        const c = input[i];
+        if (/\s/.test(c)) {
+            i++;
+            continue;
+        }
+        if (c === '$' && input[i + 1] === '/') {
+            let j = i + 2;
+            while (j < input.length && /[A-Za-z0-9_\-./*]/.test(input[j]))
+                j++;
+            out.push({ t: 'path', v: input.slice(i, j) });
+            i = j;
+            continue;
+        }
+        if (c === "'" || c === '"') {
+            let j = i + 1;
+            let v = '';
+            while (j < input.length && input[j] !== c) {
+                if (input[j] === '\\')
+                    j++;
+                v += input[j];
+                j++;
+            }
+            out.push({ t: 'string', v });
+            i = j + 1;
+            continue;
+        }
+        if (/[0-9]/.test(c)) {
+            let j = i;
+            while (j < input.length && /[0-9.]/.test(input[j]))
+                j++;
+            out.push({ t: 'number', v: Number(input.slice(i, j)) });
+            i = j;
+            continue;
+        }
+        const op = OPERATORS.find((o) => input.startsWith(o, i));
+        if (op) {
+            out.push({ t: 'op', v: op });
+            i += op.length;
+            continue;
+        }
+        if (/[A-Za-z_]/.test(c)) {
+            let j = i;
+            while (j < input.length && /[A-Za-z0-9_.:-]/.test(input[j]))
+                j++;
+            out.push({ t: 'ident', v: input.slice(i, j) });
+            i = j;
+            continue;
+        }
+        throw new SyntaxError(`unexpected character "${c}" in when clause: ${input}`);
+    }
+    return out;
+}
+function truthy(v) {
+    if (v === undefined || v === null)
+        return false;
+    if (typeof v === 'boolean')
+        return v;
+    if (typeof v === 'number')
+        return v !== 0;
+    if (typeof v === 'string')
+        return v !== '' && v !== 'false';
+    if (Array.isArray(v))
+        return v.length > 0;
+    return true;
+}
+class Parser {
+    tokens;
+    resolve;
+    pos = 0;
+    constructor(tokens, resolve) {
+        this.tokens = tokens;
+        this.resolve = resolve;
+    }
+    parse() {
+        const v = this.or();
+        if (this.pos < this.tokens.length) {
+            throw new SyntaxError('trailing tokens in when clause');
+        }
+        return v;
+    }
+    peek() {
+        return this.tokens[this.pos];
+    }
+    eat(op) {
+        const t = this.peek();
+        if (t && t.t === 'op' && t.v === op) {
+            this.pos++;
+            return true;
+        }
+        return false;
+    }
+    or() {
+        let left = this.and();
+        while (this.eat('||')) {
+            const right = this.and();
+            left = truthy(left) || truthy(right);
+        }
+        return left;
+    }
+    and() {
+        let left = this.comparison();
+        while (this.eat('&&')) {
+            const right = this.comparison();
+            left = truthy(left) && truthy(right);
+        }
+        return left;
+    }
+    comparison() {
+        const left = this.unary();
+        for (const op of ['==', '!=', '>=', '<=', '>', '<', '=~']) {
+            if (this.eat(op)) {
+                const right = this.unary();
+                switch (op) {
+                    case '==': return looseEquals(left, right);
+                    case '!=': return !looseEquals(left, right);
+                    case '>': return Number(left) > Number(right);
+                    case '>=': return Number(left) >= Number(right);
+                    case '<': return Number(left) < Number(right);
+                    case '<=': return Number(left) <= Number(right);
+                    case '=~': return new RegExp(String(right)).test(String(left ?? ''));
+                }
+            }
+        }
+        return left;
+    }
+    unary() {
+        if (this.eat('!'))
+            return !truthy(this.unary());
+        return this.primary();
+    }
+    primary() {
+        if (this.eat('(')) {
+            const v = this.or();
+            if (!this.eat(')'))
+                throw new SyntaxError('missing ")" in when clause');
+            return v;
+        }
+        const t = this.peek();
+        if (!t)
+            throw new SyntaxError('unexpected end of when clause');
+        this.pos++;
+        switch (t.t) {
+            case 'string': return t.v;
+            case 'number': return t.v;
+            case 'path': return this.resolve(t.v, true);
+            case 'ident':
+                if (t.v === 'true')
+                    return true;
+                if (t.v === 'false')
+                    return false;
+                if (t.v === 'null')
+                    return null;
+                return this.resolve(t.v, false);
+            default:
+                throw new SyntaxError(`unexpected "${t.v}" in when clause`);
+        }
+    }
+}
+function looseEquals(a, b) {
+    if (a === b)
+        return true;
+    if (a == null || b == null)
+        return false;
+    if (typeof a === 'number' || typeof b === 'number')
+        return Number(a) === Number(b);
+    return String(a) === String(b);
+}
+export class When {
+    store;
+    context = new Map();
+    cache = new Map();
+    constructor(store) {
+        this.store = store;
+    }
+    evaluate(clause, extra) {
+        if (!clause || clause.trim() === '')
+            return true;
+        try {
+            let tokens = this.cache.get(clause);
+            if (!tokens) {
+                tokens = tokenize(clause);
+                this.cache.set(clause, tokens);
+            }
+            const resolve = (name, isPath) => {
+                if (isPath)
+                    return this.store.get(name);
+                if (extra && name in extra)
+                    return extra[name];
+                return this.context.get(name);
+            };
+            return truthy(new Parser(tokens, resolve).parse());
+        }
+        catch (err) {
+            // A malformed clause is a programmer error, and hiding chrome silently
+            // is worse than showing it - fail loud, render visible.
+            console.error(`[textui/when] bad clause "${clause}"`, err);
+            return true;
+        }
+    }
+    dependencies(clause) {
+        try {
+            return tokenize(clause)
+                .filter((t) => t.t === 'path')
+                .map((t) => t.v);
+        }
+        catch {
+            return [];
+        }
+    }
+    setContext(key, value) {
+        this.context.set(key, value);
+    }
+    getContext(key) {
+        return this.context.get(key);
+    }
+}
+export function createWhen(store) {
+    return new When(store);
+}

package/dist/index.d.ts

@@ -0,0 +1,49 @@
+export * from './types/index.js';
+export { h, Fragment, defineComponent, componentNameOf, toSerializable, nodeFunction } from './jsx/factory.js';
+export type { BoxProps, TextProps, CanvasProps, SpacerProps, BaseProps } from './jsx/intrinsics.js';
+export { createStore, Store } from './core/store.js';
+export { createEvents, Events } from './core/events.js';
+export { createWhen, When } from './core/when.js';
+export { createComponents, Components } from './core/components.js';
+export { createServices, Services } from './core/services.js';
+export { createCommands, Commands } from './core/commands.js';
+export { createKeybindings, Keybindings, strokeOf, splitStroke, normalizeStroke } from './core/keybindings.js';
+export { createFocus, Focus, GLOBAL_SCOPE } from './core/focus.js';
+export { createLayers, Layers } from './core/layers.js';
+export { createAnimation, Animation } from './core/animation.js';
+export { createI18n, I18nRegistry } from './core/i18n.js';
+export { CLIPBOARD_PATH, readClipboard, writeClipboard } from './core/clipboard.js';
+export { serviceKey } from './types/services.js';
+export { Buffer, createBuffer } from './render/buffer.js';
+export { diffFrame } from './render/diff.js';
+export type { Frame, Run } from './render/diff.js';
+export * from './render/color.js';
+export { layout, measureBox, resolveEdges } from './render/layout.js';
+export type { LayoutBox } from './render/layout.js';
+export { renderOnce, renderToString, createStaticRuntime } from './render/static.js';
+export type { StaticRenderOptions, StaticRenderResult } from './render/static.js';
+export type { Runtime } from './runtime/runtime.js';
+export type { Instance } from './runtime/instance.js';
+export { renderTree, collectEffects, disposeTree } from './runtime/reconcile.js';
+export { buildBoxes, paintTree, createRenderContext } from './runtime/paint.js';
+export type { PaintEnv } from './runtime/paint.js';
+export * from './runtime/style.js';
+export * from './runtime/hooks.js';
+export { Screen, SCREEN_COMPONENTS } from './ui/screen.js';
+export type { ScreenProps } from './ui/screen.js';
+export { App, createApp, WRITER_KEY } from './app/app.js';
+export type { FrameWriter } from './app/app.js';
+export { createSurfaces, createLayouts, createShells, SURFACE_NAMES } from './core/surfaces.js';
+export { createNavigation, Navigation } from './core/navigation.js';
+export { createResources, Resources } from './core/resources.js';
+export { createSyntax, Syntax, nameOf, plainTokens, tokensFromSpans, spanHighlighter, } from './core/syntax.js';
+export { createManifests, Manifests } from './core/manifest.js';
+export * from './themes/index.js';
+export { PRIMITIVES, Box, Text, Canvas, Spacer } from './ui/primitives.js';
+export * from './adapters/index.js';
+export * from './util/text.js';
+export * from './util/markdown.js';
+export * from './util/paths.js';
+export * from './util/stream.js';
+export { createBag, toDisposable, disposeAll, NOOP_DISPOSABLE } from './util/disposable.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,54 @@
+// Contracts
+export * from './types/index.js';
+// JSX
+export { h, Fragment, defineComponent, componentNameOf, toSerializable, nodeFunction } from './jsx/factory.js';
+// Core
+export { createStore, Store } from './core/store.js';
+export { createEvents, Events } from './core/events.js';
+export { createWhen, When } from './core/when.js';
+export { createComponents, Components } from './core/components.js';
+export { createServices, Services } from './core/services.js';
+export { createCommands, Commands } from './core/commands.js';
+export { createKeybindings, Keybindings, strokeOf, splitStroke, normalizeStroke } from './core/keybindings.js';
+export { createFocus, Focus, GLOBAL_SCOPE } from './core/focus.js';
+export { createLayers, Layers } from './core/layers.js';
+export { createAnimation, Animation } from './core/animation.js';
+export { createI18n, I18nRegistry } from './core/i18n.js';
+export { CLIPBOARD_PATH, readClipboard, writeClipboard } from './core/clipboard.js';
+export { serviceKey } from './types/services.js';
+// Render
+export { Buffer, createBuffer } from './render/buffer.js';
+export { diffFrame } from './render/diff.js';
+export * from './render/color.js';
+export { layout, measureBox, resolveEdges } from './render/layout.js';
+export { renderOnce, renderToString, createStaticRuntime } from './render/static.js';
+export { renderTree, collectEffects, disposeTree } from './runtime/reconcile.js';
+export { buildBoxes, paintTree, createRenderContext } from './runtime/paint.js';
+export * from './runtime/style.js';
+export * from './runtime/hooks.js';
+export { Screen, SCREEN_COMPONENTS } from './ui/screen.js';
+// The application
+export { App, createApp, WRITER_KEY } from './app/app.js';
+// Registries
+export { createSurfaces, createLayouts, createShells, SURFACE_NAMES } from './core/surfaces.js';
+export { createNavigation, Navigation } from './core/navigation.js';
+export { createResources, Resources } from './core/resources.js';
+export { createSyntax, Syntax, nameOf, plainTokens, tokensFromSpans, spanHighlighter, } from './core/syntax.js';
+export { createManifests, Manifests } from './core/manifest.js';
+// Themes
+export * from './themes/index.js';
+// The host primitives.
+//
+// Not the catalog - that is `@textui/widgets`. These four are what the layout
+// engine and the painter actually reason about, so they belong to the runtime
+// that reasons about them. `Box`, `Text` and `Canvas` are the Capitalized
+// spellings, and they are the strings themselves.
+export { PRIMITIVES, Box, Text, Canvas, Spacer } from './ui/primitives.js';
+// Adapters
+export * from './adapters/index.js';
+// Utilities
+export * from './util/text.js';
+export * from './util/markdown.js';
+export * from './util/paths.js';
+export * from './util/stream.js';
+export { createBag, toDisposable, disposeAll, NOOP_DISPOSABLE } from './util/disposable.js';

package/dist/jsx/factory.d.ts

@@ -0,0 +1,27 @@
+import type { ComponentNode } from '../types/graph.js';
+import type { FunctionComponent, RenderOutput } from '../types/render.js';
+/** The registry name for a function component, assigning one if needed. */
+export declare function componentNameOf(fn: FunctionComponent): string;
+/** Name a component explicitly. Do this for anything the registry exposes. */
+export declare function defineComponent<P>(name: string, fn: (props: P) => RenderOutput): (props: P) => RenderOutput;
+export declare function isNamed(fn: unknown): boolean;
+export declare const Fragment: (props: {
+    children?: unknown;
+}) => RenderOutput;
+export type ElementType = string | FunctionComponent;
+/**
+ * Build a node. `key` is lifted out of props because it is reconciliation
+ * identity, not data the component receives.
+ */
+export declare function h(type: ElementType, props?: (Record<string, unknown> & {
+    key?: string | number;
+}) | null, ...children: unknown[]): ComponentNode;
+/** The function behind a node built from a function component, if any. */
+export declare function nodeFunction(node: ComponentNode): FunctionComponent | undefined;
+/**
+ * Strip everything unserializable so a node can be persisted or sent. Closures
+ * (`$meta.fn`, `{ handler }` actions, function props) are dropped, which is
+ * exactly the set of things that only mean something in this process.
+ */
+export declare function toSerializable(node: ComponentNode): ComponentNode;
+//# sourceMappingURL=factory.d.ts.map

package/dist/jsx/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../src/jsx/factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAa,MAAM,mBAAmB,CAAC;AAClE,OAAO,KAAK,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AA2B1E,2EAA2E;AAC3E,wBAAgB,eAAe,CAAC,EAAE,EAAE,iBAAiB,GAAG,MAAM,CAW7D;AAED,8EAA8E;AAC9E,wBAAgB,eAAe,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,YAAY,GAAG,CAAC,KAAK,EAAE,CAAC,KAAK,YAAY,CAI3G;AAED,wBAAgB,OAAO,CAAC,EAAE,EAAE,OAAO,GAAG,OAAO,CAE5C;AAED,eAAO,MAAM,QAAQ;eAAgC,OAAO;MAVoC,YAY9F,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,iBAAiB,CAAC;AAErD;;;GAGG;AACH,wBAAgB,CAAC,CACf,IAAI,EAAE,WAAW,EACjB,KAAK,CAAC,EAAE,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;IAAE,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE,CAAC,GAAG,IAAI,EACpE,GAAG,QAAQ,EAAE,OAAO,EAAE,GACrB,aAAa,CAcf;AAED,0EAA0E;AAC1E,wBAAgB,YAAY,CAAC,IAAI,EAAE,aAAa,GAAG,iBAAiB,GAAG,SAAS,CAG/E;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,aAAa,GAAG,aAAa,CAWjE"}

package/dist/jsx/factory.js

@@ -0,0 +1,102 @@
+/**
+ * JSX compiles to component nodes.
+ *
+ * `<Row gap={1}/>` and `{ component: 'Row', gap: 1 }` are the same value, so a
+ * screen written in TypeScript, loaded from JSON or generated by something
+ * else all reach the runtime as one shape. That is the whole trick, and it is
+ * why every prop should stay serializable: a closure in a node is legal but
+ * marks the node as in-process only.
+ *
+ * The naming rule mirrors HTML's: **lowercase is a host primitive**
+ * (`box`, `text`, `canvas`, `spacer`), **Capitalized is a registered
+ * component** resolved through the registry at mount time.
+ */
+const NAME = Symbol.for('textui.componentName');
+let anonymousCounter = 0;
+/** The registry name for a function component, assigning one if needed. */
+export function componentNameOf(fn) {
+    const f = fn;
+    const existing = f[NAME];
+    if (existing)
+        return existing;
+    const inferred = f.displayName || f.name;
+    const name = inferred && inferred !== 'anonymous'
+        ? inferred
+        : `Anonymous${++anonymousCounter}`;
+    f[NAME] = name;
+    return name;
+}
+/** Name a component explicitly. Do this for anything the registry exposes. */
+export function defineComponent(name, fn) {
+    fn[NAME] = name;
+    fn.displayName = name;
+    return fn;
+}
+export function isNamed(fn) {
+    return typeof fn === 'function' && fn[NAME] !== undefined;
+}
+export const Fragment = defineComponent('Fragment', (props) => {
+    return (props.children ?? null);
+});
+/**
+ * Build a node. `key` is lifted out of props because it is reconciliation
+ * identity, not data the component receives.
+ */
+export function h(type, props, ...children) {
+    const { key, ...rest } = props ?? {};
+    const node = typeof type === 'string'
+        ? { component: type, ...rest }
+        : { component: componentNameOf(type), ...rest, $meta: { fn: type } };
+    if (children.length > 0) {
+        node.children = (children.length === 1 ? children[0] : children);
+    }
+    if (key !== undefined)
+        node.key = key;
+    return node;
+}
+/** The function behind a node built from a function component, if any. */
+export function nodeFunction(node) {
+    const fn = node.$meta?.fn;
+    return typeof fn === 'function' ? fn : undefined;
+}
+/**
+ * Strip everything unserializable so a node can be persisted or sent. Closures
+ * (`$meta.fn`, `{ handler }` actions, function props) are dropped, which is
+ * exactly the set of things that only mean something in this process.
+ */
+export function toSerializable(node) {
+    const out = { component: node.component };
+    if (node.id !== undefined)
+        out.id = node.id;
+    if (node.key !== undefined)
+        out.key = node.key;
+    for (const [k, v] of Object.entries(node)) {
+        if (k === 'component' || k === 'id' || k === 'key' || k === '$meta')
+            continue;
+        const clean = cleanValue(v);
+        if (clean !== undefined)
+            out[k] = clean;
+    }
+    return out;
+}
+function cleanValue(v) {
+    if (typeof v === 'function')
+        return undefined;
+    if (v === null || typeof v !== 'object')
+        return v;
+    if (Array.isArray(v)) {
+        const arr = v.map(cleanValue).filter((x) => x !== undefined);
+        return arr;
+    }
+    if ('component' in v)
+        return toSerializable(v);
+    if ('handler' in v)
+        return undefined;
+    const out = {};
+    for (const [k, val] of Object.entries(v)) {
+        const clean = cleanValue(val);
+        if (clean !== undefined)
+            out[k] = clean;
+    }
+    return out;
+}

package/dist/jsx/intrinsics.d.ts

@@ -0,0 +1,96 @@
+import type { Style, StyleInput } from '../types/style.js';
+import type { SemanticRole } from '../types/component-registry.js';
+import type { KeyEvent, MouseEvent } from '../types/input.js';
+import type { PaintSurface, RenderContext } from '../types/render.js';
+import type { Action } from '../types/graph.js';
+/**
+ * Props every node accepts.
+ *
+ * Style arrives three ways on purpose: the full `style` object for anything
+ * stateful, a merged list for composition, and the individual style keys
+ * inline as convenience props - `<box gap={1} border="single">` rather than
+ * `<box style={{ gap: 1, border: 'single' }}>` for the common case.
+ */
+export interface BaseProps extends Style {
+    id?: string;
+    key?: string | number;
+    style?: StyleInput;
+    /** Semantic metadata. Drives the test harness, and future a11y work. */
+    role?: SemanticRole;
+    label?: string;
+    description?: string;
+    disabled?: boolean;
+    selected?: boolean;
+    /** Participates in tab order. Implied by an interactive role. */
+    focusable?: boolean;
+    /** The focus scope this node belongs to. */
+    focusScope?: string;
+    autoFocus?: boolean;
+    /**
+     * `onKey` runs whether or not this node is focused.
+     *
+     * For a node that wraps something else and wants the keys that thing
+     * declines - a dropdown panel taking left and right while the menu inside it
+     * keeps up and down. Without this a handler only runs while focused, which
+     * is what focus means.
+     */
+    global?: boolean;
+    onKey?(event: KeyEvent): boolean | void;
+    onFocus?(): void;
+    onBlur?(): void;
+    onMouse?(event: MouseEvent): boolean | void;
+    onClick?: Action | ((event: MouseEvent) => void);
+    onHover?(hovering: boolean): void;
+    /** OSC 8 link target, where the terminal supports hyperlinks. */
+    link?: string;
+    /** Below this width the node renders `compact`; below that, `minimal`. */
+    breakpoints?: {
+        compact?: number;
+        minimal?: number;
+    };
+}
+export interface BoxProps extends BaseProps {
+    children?: unknown;
+    /** Header text drawn into the top border. Needs a border to land on. */
+    title?: string;
+    titleAlign?: 'left' | 'center' | 'right';
+    /**
+     * A second label on the top border, hard against the right.
+     *
+     * For the short thing that belongs beside a heading rather than under it - a
+     * count, a shortcut, a state. It takes its space first and `title` gets what
+     * is left, so the two never collide and the title is the one that truncates.
+     */
+    rightTitle?: string;
+    /** Footer text drawn into the bottom border. */
+    footer?: string;
+    footerAlign?: 'left' | 'center' | 'right';
+    /** Scroll offset in cells, when overflow is 'scroll'. */
+    scrollTop?: number;
+    scrollLeft?: number;
+}
+export interface TextProps extends BaseProps {
+    children?: unknown;
+    /** The string to draw. `children` is accepted as a shorthand. */
+    content?: string;
+    /** Where to cut when the text does not fit. */
+    truncate?: 'end' | 'start' | 'middle' | false;
+    ellipsis?: string;
+}
+export interface CanvasProps extends BaseProps {
+    /**
+     * Paint directly. The escape hatch charts and gauges use; everything else
+     * should compose `box` and `text` so the layout engine can reason about it.
+     */
+    draw(surface: PaintSurface, ctx: RenderContext): void;
+    /** Intrinsic size when the style does not fix one. */
+    intrinsic?: {
+        width?: number;
+        height?: number;
+    };
+}
+export interface SpacerProps extends BaseProps {
+    /** Cells to take. Unset means "take whatever is left", the same as `flex: 1`. */
+    size?: number;
+}
+//# sourceMappingURL=intrinsics.d.ts.map

package/dist/jsx/intrinsics.d.ts.map

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

package/dist/jsx/intrinsics.js

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

package/dist/jsx/jsx-dev-runtime.d.ts

@@ -0,0 +1,13 @@
+import type { ComponentNode } from '../types/graph.js';
+import type { FunctionComponent } from '../types/render.js';
+import { Fragment, type JSX } from './jsx-runtime.js';
+export { Fragment };
+export type { JSX };
+export declare function jsxDEV(type: string | FunctionComponent, props: Record<string, unknown> & {
+    children?: unknown;
+}, key: string | number | undefined, _isStatic: boolean, source?: {
+    fileName: string;
+    lineNumber: number;
+    columnNumber: number;
+}): ComponentNode;
+//# sourceMappingURL=jsx-dev-runtime.d.ts.map

package/dist/jsx/jsx-dev-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsx-dev-runtime.d.ts","sourceRoot":"","sources":["../../src/jsx/jsx-dev-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EAAO,QAAQ,EAAE,KAAK,GAAG,EAAE,MAAM,kBAAkB,CAAC;AAE3D,OAAO,EAAE,QAAQ,EAAE,CAAC;AACpB,YAAY,EAAE,GAAG,EAAE,CAAC;AAEpB,wBAAgB,MAAM,CACpB,IAAI,EAAE,MAAM,GAAG,iBAAiB,EAChC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;IAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAE,EACvD,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,EAChC,SAAS,EAAE,OAAO,EAClB,MAAM,CAAC,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,GACtE,aAAa,CASf"}

package/dist/jsx/jsx-dev-runtime.js

@@ -0,0 +1,12 @@
+import { jsx, Fragment } from './jsx-runtime.js';
+export { Fragment };
+export function jsxDEV(type, props, key, _isStatic, source) {
+    const node = jsx(type, props, key);
+    if (source) {
+        node.$meta = {
+            ...node.$meta,
+            source: { file: source.fileName, line: source.lineNumber, column: source.columnNumber },
+        };
+    }
+    return node;
+}

package/dist/jsx/jsx-runtime.d.ts

@@ -0,0 +1,42 @@
+import type { ComponentNode } from '../types/graph.js';
+import type { FunctionComponent } from '../types/render.js';
+import type { RenderOutput } from '../types/render.js';
+import { Fragment } from './factory.js';
+import type { BoxProps, CanvasProps, SpacerProps, TextProps } from './intrinsics.js';
+export { Fragment };
+export type { BoxProps, TextProps, CanvasProps, SpacerProps };
+type Props = Record<string, unknown> & {
+    children?: unknown;
+};
+export declare function jsx(type: string | FunctionComponent, props: Props, key?: string | number): ComponentNode;
+export declare function jsxs(type: string | FunctionComponent, props: Props, key?: string | number): ComponentNode;
+export declare namespace JSX {
+    type Element = ComponentNode;
+    /**
+     * What may appear as a JSX tag.
+     *
+     * A component returns `RenderOutput` - a node, a list, a string, or nothing -
+     * rather than exactly one element. Without this, TypeScript insists every
+     * component return a single node, and `return null` stops compiling.
+     */
+    type ElementType = string | ((props: never) => RenderOutput);
+    interface ElementChildrenAttribute {
+        children: unknown;
+    }
+    /**
+     * Lowercase names are host primitives - the only three shapes the layout
+     * engine reasons about, plus a spacer. Everything Capitalized is a component
+     * you import, which is what gives it prop types.
+     */
+    interface IntrinsicElements {
+        box: BoxProps;
+        text: TextProps;
+        canvas: CanvasProps;
+        spacer: SpacerProps;
+    }
+    interface IntrinsicAttributes {
+        key?: string | number;
+        id?: string;
+    }
+}
+//# sourceMappingURL=jsx-runtime.d.ts.map

package/dist/jsx/jsx-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsx-runtime.d.ts","sourceRoot":"","sources":["../../src/jsx/jsx-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAmB,QAAQ,EAAE,MAAM,cAAc,CAAC;AACzD,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAErF,OAAO,EAAE,QAAQ,EAAE,CAAC;AACpB,YAAY,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,WAAW,EAAE,CAAC;AAE9D,KAAK,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;IAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AAe9D,wBAAgB,GAAG,CACjB,IAAI,EAAE,MAAM,GAAG,iBAAiB,EAChC,KAAK,EAAE,KAAK,EACZ,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,GACpB,aAAa,CAEf;AAED,wBAAgB,IAAI,CAClB,IAAI,EAAE,MAAM,GAAG,iBAAiB,EAChC,KAAK,EAAE,KAAK,EACZ,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,GACpB,aAAa,CAEf;AAKD,MAAM,CAAC,OAAO,WAAW,GAAG,CAAC;IAC3B,KAAK,OAAO,GAAG,aAAa,CAAC;IAE7B;;;;;;OAMG;IACH,KAAK,WAAW,GAAG,MAAM,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,KAAK,YAAY,CAAC,CAAC;IAE7D,UAAU,wBAAwB;QAChC,QAAQ,EAAE,OAAO,CAAC;KACnB;IAED;;;;OAIG;IACH,UAAU,iBAAiB;QACzB,GAAG,EAAE,QAAQ,CAAC;QACd,IAAI,EAAE,SAAS,CAAC;QAChB,MAAM,EAAE,WAAW,CAAC;QACpB,MAAM,EAAE,WAAW,CAAC;KACrB;IAED,UAAU,mBAAmB;QAC3B,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;QACtB,EAAE,CAAC,EAAE,MAAM,CAAC;KACb;CACF"}