lastriko 0.1.0

package/dist/components/context.test.js

@@ -0,0 +1,69 @@
+import { describe, expect, it } from 'vitest';
+import { UIContext } from './context';
+import { createConnectionScope } from './registry';
+describe('uiContext', () => {
+    it('creates stable ids per component type', () => {
+        const scope = createConnectionScope('c1');
+        const ui = new UIContext(scope);
+        const text1 = ui.text('hello');
+        const text2 = ui.text('world');
+        const button = ui.button('Run', () => { });
+        const input = ui.textInput('Name');
+        expect(text1.id).toBe('text-1');
+        expect(text2.id).toBe('text-2');
+        expect(button.id).toBe('button-1');
+        expect(input.id).toBe('textInput-1');
+    });
+    it('input change updates value atom and emits FRAGMENT', () => {
+        const scope = createConnectionScope('c2');
+        const ui = new UIContext(scope);
+        const slider = ui.slider('Temperature', { min: 0, max: 2, default: 0.7 });
+        slider.update({ value: 1.2 });
+        expect(slider.value).toBe(1.2);
+        expect(scope.outbox).toHaveLength(1);
+        expect(scope.outbox[0]?.type).toBe('FRAGMENT');
+    });
+    it('table handles support prepend, row.update, remove', () => {
+        const scope = createConnectionScope('c3');
+        const ui = new UIContext(scope);
+        const table = ui.table([], { columns: ['name', 'status'] });
+        const row = table.prepend({ name: 'exp-1', status: 'queued' });
+        expect(table.rowCount).toBe(1);
+        row.update({ status: 'done' });
+        expect(table.props.rows[0]?.data.status).toBe('done');
+        row.remove();
+        expect(table.rowCount).toBe(0);
+    });
+    it('streamText emits STREAM_CHUNK sequence and done marker', () => {
+        const scope = createConnectionScope('c4');
+        const ui = new UIContext(scope);
+        const stream = ui.streamText({ format: 'plain' });
+        stream.append('Hello');
+        stream.append(' world');
+        stream.done();
+        const chunks = scope.outbox.filter((message) => message.type === 'STREAM_CHUNK');
+        expect(chunks).toHaveLength(3);
+        expect((chunks[0]?.payload).chunk).toBe('Hello');
+        expect((chunks[1]?.payload).chunk).toBe(' world');
+        expect((chunks[2]?.payload).done).toBe(true);
+    });
+    it('chatUI stores and clears connection-scoped message history', () => {
+        const scope = createConnectionScope('c5');
+        const ui = new UIContext(scope);
+        const chat = ui.chatUI();
+        chat.addMessage('user', 'hi');
+        chat.addMessage('assistant', 'hello');
+        expect(chat.value).toHaveLength(2);
+        expect(chat.lastMessage?.content).toBe('hello');
+        chat.clear();
+        expect(chat.value).toHaveLength(0);
+    });
+    it('promptEditor interpolate replaces template variables', () => {
+        const scope = createConnectionScope('c6');
+        const ui = new UIContext(scope);
+        const prompt = ui.promptEditor({ default: 'Write a {{tone}} note about {{topic}}.' });
+        const finalText = prompt.interpolate({ tone: 'formal', topic: 'safety' });
+        expect(finalText).toBe('Write a formal note about safety.');
+    });
+});
+//# sourceMappingURL=context.test.js.map

package/dist/components/context.test.js.map

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

package/dist/components/id.d.ts

@@ -0,0 +1,3 @@
+import type { ComponentType, ConnectionScope } from './types';
+export declare function createComponentId(scope: ConnectionScope, type: ComponentType): string;
+export declare function resetComponentCounters(scope: ConnectionScope): void;

package/dist/components/id.js

@@ -0,0 +1,9 @@
+export function createComponentId(scope, type) {
+    const next = (scope.counters.get(type) ?? 0) + 1;
+    scope.counters.set(type, next);
+    return `${type}-${next}`;
+}
+export function resetComponentCounters(scope) {
+    scope.counters.clear();
+}
+//# sourceMappingURL=id.js.map

package/dist/components/id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"id.js","sourceRoot":"","sources":["../../src/components/id.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,iBAAiB,CAAC,KAAsB,EAAE,IAAmB;IAC3E,MAAM,IAAI,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;IACjD,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC/B,OAAO,GAAG,IAAI,IAAI,IAAI,EAAE,CAAC;AAC3B,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,KAAsB;IAC3D,KAAK,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;AACzB,CAAC"}

package/dist/components/registry.d.ts

@@ -0,0 +1,2 @@
+import type { ConnectionScope } from './types';
+export declare function createConnectionScope(id?: string, transport?: ConnectionScope['connection']): ConnectionScope;

package/dist/components/registry.js

@@ -0,0 +1,97 @@
+import { atom } from 'nanostores';
+import { randomUUID } from 'node:crypto';
+import { existsSync, rmSync } from 'node:fs';
+import { renderComponent } from '../engine/renderer';
+export function createConnectionScope(id, transport = { send: () => { } }) {
+    const scopeId = id && id.trim() ? id : randomUUID();
+    const atoms = new Map();
+    const handles = new Map();
+    const counters = new Map();
+    const roots = [];
+    const cleanupFns = [];
+    const outbox = [];
+    return {
+        id: scopeId,
+        connection: transport,
+        atoms,
+        handles,
+        counters,
+        roots,
+        outbox,
+        viewport: { width: 0, height: 0 },
+        theme: 'light',
+        uploadDir: null,
+        lastRender: null,
+        getAtom(key, initialValue) {
+            if (!atoms.has(key)) {
+                atoms.set(key, atom(initialValue));
+            }
+            return atoms.get(key);
+        },
+        registerHandle(handle) {
+            handles.set(handle.id, handle);
+        },
+        getHandle(id) {
+            return handles.get(id);
+        },
+        listHandles() {
+            return [...handles.values()];
+        },
+        pushNode(node) {
+            roots.push(node);
+        },
+        listRoots() {
+            return [...roots];
+        },
+        setValue(id, value) {
+            const valueAtom = this.getAtom(`${id}/value`, value);
+            valueAtom.set(value);
+            const handle = handles.get(id);
+            if (handle && 'props' in handle && typeof handle.props === 'object' && handle.props !== null) {
+                handle.props.value = value;
+            }
+        },
+        send(message) {
+            outbox.push(message);
+            transport.send(message);
+        },
+        pushFragment(handle) {
+            this.send({
+                type: 'FRAGMENT',
+                payload: { id: handle.id, html: renderComponent(handle) },
+            });
+        },
+        onCleanup(fn) {
+            cleanupFns.push(fn);
+        },
+        clearTransientState() {
+            atoms.clear();
+            handles.clear();
+            counters.clear();
+            roots.length = 0;
+            outbox.length = 0;
+            this.lastRender = null;
+        },
+        destroy() {
+            for (const fn of cleanupFns) {
+                try {
+                    fn();
+                }
+                catch {
+                    // best effort
+                }
+            }
+            if (this.uploadDir && existsSync(this.uploadDir)) {
+                try {
+                    rmSync(this.uploadDir, { recursive: true, force: true });
+                }
+                catch {
+                    // best effort
+                }
+            }
+            cleanupFns.length = 0;
+            this.clearTransientState();
+        },
+    };
+}
+//# sourceMappingURL=registry.js.map

package/dist/components/registry.js.map

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

package/dist/components/types.d.ts

@@ -0,0 +1,390 @@
+import type { WritableAtom } from 'nanostores';
+import type { ServerToClientMessage, ThemeMode } from '../engine/messages';
+export type ComponentType = 'text' | 'button' | 'textInput' | 'numberInput' | 'slider' | 'toggle' | 'select' | 'fileUpload' | 'markdown' | 'image' | 'imageGrid' | 'code' | 'json' | 'table' | 'metric' | 'progress' | 'shell' | 'grid' | 'tabs' | 'card' | 'divider' | 'spacer' | 'alert' | 'loading' | 'streamText' | 'chatUI' | 'promptEditor';
+export type TableRow = Record<string, unknown>;
+export interface ComponentHandle<TProps, TValue = void> {
+    readonly id: string;
+    readonly type: ComponentType;
+    props: TProps;
+    readonly value: TValue;
+    update(data: Partial<TProps & {
+        value: TValue;
+    }>): void;
+}
+export interface InputHandle<TValue, TProps = Record<string, unknown>> extends ComponentHandle<TProps, TValue> {
+    readonly value: TValue;
+}
+export interface ButtonCallbackHandle {
+    setLoading(loading: boolean): void;
+}
+export interface ButtonOpts {
+    variant?: 'primary' | 'secondary' | 'danger' | 'ghost';
+    disabled?: boolean;
+}
+export interface TextInputOpts {
+    placeholder?: string;
+    default?: string;
+    multiline?: boolean;
+    rows?: number;
+    maxLength?: number;
+    disabled?: boolean;
+    helperText?: string;
+    type?: 'text' | 'email' | 'url' | 'password';
+}
+export interface NumberInputOpts {
+    min?: number;
+    max?: number;
+    step?: number;
+    default?: number;
+    disabled?: boolean;
+    helperText?: string;
+}
+export interface SliderOpts {
+    min: number;
+    max: number;
+    step?: number;
+    default?: number;
+    disabled?: boolean;
+    helperText?: string;
+    showValue?: boolean;
+}
+export interface ToggleOpts {
+    default?: boolean;
+    disabled?: boolean;
+    helperText?: string;
+    onLabel?: string;
+    offLabel?: string;
+}
+export type SelectOption = string | {
+    label: string;
+    value: string;
+    disabled?: boolean;
+};
+export interface SelectOpts {
+    default?: string;
+    disabled?: boolean;
+    helperText?: string;
+    placeholder?: string;
+}
+export interface FileUploadOpts {
+    accept?: string;
+    multiple?: boolean;
+    maxSize?: number;
+    disabled?: boolean;
+    helperText?: string;
+    dragDrop?: boolean;
+}
+export interface UploadedFile {
+    name: string;
+    path: string;
+    size: number;
+    type: string;
+    lastModified: number;
+}
+export interface TextProps {
+    content: string;
+}
+export interface ButtonProps extends ButtonOpts {
+    label: string;
+    loading: boolean;
+    onClick: (btn: ButtonCallbackHandle) => void | Promise<void>;
+}
+export interface TextInputProps extends TextInputOpts {
+    label: string;
+    value: string;
+}
+export interface NumberInputProps extends NumberInputOpts {
+    label: string;
+    value: number;
+}
+export interface SliderProps extends SliderOpts {
+    label: string;
+    value: number;
+}
+export interface ToggleProps extends ToggleOpts {
+    label: string;
+    value: boolean;
+}
+export interface SelectProps extends SelectOpts {
+    label: string;
+    options: Array<{
+        label: string;
+        value: string;
+        disabled?: boolean;
+    }>;
+    value: string;
+}
+export interface FileUploadProps extends FileUploadOpts {
+    label: string;
+    value: UploadedFile | UploadedFile[] | null;
+}
+export interface MarkdownProps {
+    content: string;
+}
+export interface ImageProps {
+    src: string | null | undefined;
+    alt: string;
+    caption?: string;
+    width?: string | number;
+    height?: string | number;
+}
+export interface ImageGridProps {
+    items: Array<{
+        src: string;
+        alt: string;
+        caption?: string;
+    }>;
+    cols?: number | 'auto';
+    gap?: number;
+    minWidth?: number;
+}
+export interface CodeProps {
+    content: string;
+    lang?: string;
+}
+export interface JsonProps {
+    label?: string;
+    data: unknown;
+}
+export interface TableProps {
+    columns: string[];
+    rows: Array<{
+        id: string;
+        data: TableRow;
+    }>;
+    striped?: boolean;
+    maxHeight?: number;
+    emptyMessage?: string;
+    onRowClick?: (row: TableRow) => void;
+    getOnRowClick?: () => ((row: TableRow) => void) | null;
+}
+export interface MetricOpts {
+    delta?: number;
+    deltaLabel?: string;
+    unit?: string;
+    prefix?: string;
+}
+export interface MetricProps extends MetricOpts {
+    label: string;
+    value: string;
+}
+export interface ProgressOpts {
+    label?: string;
+    showPercentage?: boolean;
+    color?: 'accent' | 'success' | 'error' | 'warning';
+}
+export interface ProgressProps extends ProgressOpts {
+    value: number | null;
+}
+export interface ShellOpts {
+    sidebarPosition?: 'left' | 'right';
+    sidebarWidth?: string;
+}
+export interface GridOpts {
+    cols?: number | string[];
+    rows?: number | string[];
+    gap?: number;
+    minWidth?: number;
+}
+export interface TabsOpts {
+    defaultTab?: string;
+}
+export interface ToastOpts {
+    type?: 'info' | 'success' | 'warning' | 'error';
+    duration?: number;
+}
+export interface AlertOpts {
+    type?: 'info' | 'success' | 'warning' | 'error';
+    title?: string;
+}
+export interface LoadingOpts {
+    message?: string;
+    mode?: 'fullpage' | 'inline';
+    size?: 'sm' | 'md' | 'lg';
+}
+export interface StreamTextOpts {
+    format?: 'plain' | 'markdown';
+    cursor?: boolean;
+    label?: string;
+    maxHeight?: number;
+}
+export interface StreamTextProps extends StreamTextOpts {
+    text: string;
+    isStreaming: boolean;
+}
+export interface ChatMessage {
+    role: 'user' | 'assistant' | 'system';
+    content: string;
+    timestamp: number;
+}
+export interface ChatUIOptions {
+    placeholder?: string;
+    maxHeight?: number;
+}
+export interface ChatUIProps extends ChatUIOptions {
+    messages: ChatMessage[];
+}
+export interface PromptEditorOpts extends TextInputOpts {
+    label?: string;
+    variables?: string[];
+    showCharCount?: boolean;
+}
+export interface PromptEditorProps extends PromptEditorOpts {
+    value: string;
+}
+export interface TextHandle extends Omit<ComponentHandle<TextProps, string>, 'update'> {
+    readonly type: 'text';
+    update(content: string): void;
+}
+export interface ButtonHandle extends ComponentHandle<ButtonProps, boolean> {
+    readonly type: 'button';
+    setLoading(loading: boolean): void;
+}
+export type TextInputHandle = InputHandle<string, TextInputProps>;
+export type NumberInputHandle = InputHandle<number, NumberInputProps>;
+export type SliderHandle = InputHandle<number, SliderProps>;
+export type ToggleHandle = InputHandle<boolean, ToggleProps>;
+export type SelectHandle = InputHandle<string, SelectProps>;
+export type FileUploadHandle = InputHandle<UploadedFile | UploadedFile[] | null, FileUploadProps>;
+export interface TableRowHandle {
+    id: string;
+    update(data: Partial<TableRow>): void;
+    remove(): void;
+}
+export interface TableHandle extends ComponentHandle<TableProps> {
+    readonly type: 'table';
+    append(row: TableRow): TableRowHandle;
+    prepend(row: TableRow): TableRowHandle;
+    remove(rowId: string): void;
+    readonly rowCount: number;
+    onRowClick(handler: (row: TableRow) => void): void;
+}
+export interface MetricHandle extends Omit<ComponentHandle<MetricProps, string>, 'update'> {
+    readonly type: 'metric';
+    update(value: string, opts?: MetricOpts): void;
+}
+export interface ProgressHandle extends Omit<ComponentHandle<ProgressProps, number | null>, 'update'> {
+    readonly type: 'progress';
+    update(value: number | null, opts?: ProgressOpts): void;
+}
+export interface StreamHandle extends Omit<ComponentHandle<StreamTextProps, string>, 'update'> {
+    readonly type: 'streamText';
+    readonly text: string;
+    readonly isStreaming: boolean;
+    append(chunk: string): void;
+    done(): void;
+    clear(): void;
+    update(data: Partial<StreamTextProps>): void;
+}
+export interface ChatHandle extends Omit<ComponentHandle<ChatUIProps, ChatMessage[]>, 'update'> {
+    readonly type: 'chatUI';
+    readonly lastMessage: ChatMessage | null;
+    update(data: Partial<ChatUIProps>): void;
+    addMessage(role: 'user' | 'assistant', content: string): void;
+    clear(): void;
+}
+export interface PromptEditorHandle extends InputHandle<string, PromptEditorProps> {
+    readonly type: 'promptEditor';
+    interpolate(vars: Record<string, string>): string;
+}
+export type AnyComponentHandle = TextHandle | ButtonHandle | TextInputHandle | NumberInputHandle | SliderHandle | ToggleHandle | SelectHandle | FileUploadHandle | TableHandle | MetricHandle | ProgressHandle | StreamHandle | ChatHandle | PromptEditorHandle | ComponentHandle<MarkdownProps> | ComponentHandle<ImageProps> | ComponentHandle<ImageGridProps> | ComponentHandle<CodeProps> | ComponentHandle<JsonProps> | ComponentHandle<Record<string, unknown>, unknown>;
+export interface RenderNode {
+    id: string;
+}
+export interface ServerConnection {
+    send: (message: ServerToClientMessage) => void;
+    close?: () => void;
+    isOpen?: () => boolean;
+}
+export interface LastRenderState {
+    html: string;
+    title: string;
+    theme: ThemeMode;
+}
+export interface ConnectionScope {
+    readonly id: string;
+    readonly connection: ServerConnection;
+    readonly atoms: Map<string, WritableAtom<unknown>>;
+    readonly handles: Map<string, AnyComponentHandle>;
+    readonly counters: Map<ComponentType, number>;
+    readonly roots: RenderNode[];
+    readonly outbox: ServerToClientMessage[];
+    viewport: {
+        width: number;
+        height: number;
+    };
+    theme: ThemeMode;
+    uploadDir: string | null;
+    lastRender: LastRenderState | null;
+    getAtom<T>(key: string, initialValue: T): WritableAtom<T>;
+    registerHandle(handle: AnyComponentHandle): void;
+    getHandle(id: string): AnyComponentHandle | undefined;
+    listHandles(): AnyComponentHandle[];
+    pushNode(node: RenderNode): void;
+    listRoots(): RenderNode[];
+    setValue(id: string, value: unknown): void;
+    send(message: ServerToClientMessage): void;
+    pushFragment(handle: AnyComponentHandle): void;
+    onCleanup(fn: () => void): void;
+    clearTransientState(): void;
+    destroy(): void;
+}
+export interface UIContext {
+    readonly scope: ConnectionScope;
+    readonly viewport: {
+        width: number;
+        height: number;
+    };
+    readonly theme: ThemeMode;
+    setTheme(mode: ThemeMode): void;
+    text(content: string): TextHandle;
+    markdown(content: string): void;
+    image(src: string | null | undefined, opts?: Partial<ImageProps>): void;
+    imageGrid(sources: Array<string | {
+        src: string;
+        alt?: string;
+        caption?: string;
+    }>, opts?: Partial<ImageGridProps>): void;
+    code(content: string, opts?: Partial<CodeProps>): void;
+    json(data: unknown, opts?: {
+        label?: string;
+    }): void;
+    table(data: TableRow[], opts?: Partial<TableProps>): TableHandle;
+    metric(label: string, value: string, opts?: MetricOpts): MetricHandle;
+    progress(value: number | null, opts?: ProgressOpts): ProgressHandle;
+    button(label: string, onClick: (btn: ButtonCallbackHandle) => void | Promise<void>, opts?: ButtonOpts): ButtonHandle;
+    textInput(label: string, opts?: TextInputOpts): TextInputHandle;
+    numberInput(label: string, opts?: NumberInputOpts): NumberInputHandle;
+    slider(label: string, opts: SliderOpts): SliderHandle;
+    toggle(label: string, opts?: ToggleOpts): ToggleHandle;
+    select(label: string, options: SelectOption[], opts?: SelectOpts): SelectHandle;
+    fileUpload(label: string, opts?: FileUploadOpts): FileUploadHandle;
+    shell(regions: ShellRegions, opts?: ShellOpts): void;
+    grid(areas: Array<(ctx: UIContext) => void>, opts?: GridOpts): void;
+    tabs(tabs: TabDef[], opts?: TabsOpts): ComponentHandle<Record<string, unknown>, string>;
+    card(titleOrContent: string | ((ctx: UIContext) => void), contentOrNothing?: (ctx: UIContext) => void): void;
+    divider(opts?: {
+        label?: string;
+    }): void;
+    spacer(size?: number | 'sm' | 'md' | 'lg'): void;
+    toast(message: string, opts?: ToastOpts): void;
+    alert(message: string, opts?: AlertOpts): void;
+    loading(messageOrOpts?: string | LoadingOpts, opts?: Omit<LoadingOpts, 'message'>): void;
+    streamText(opts?: StreamTextOpts): StreamHandle;
+    chatUI(opts?: ChatUIOptions): ChatHandle;
+    promptEditor(opts?: PromptEditorOpts): PromptEditorHandle;
+    onDisconnect(fn: () => void): void;
+}
+export interface ShellRegions {
+    header?: (ctx: UIContext) => void;
+    sidebar?: (ctx: UIContext) => void;
+    main: (ctx: UIContext) => void;
+    footer?: (ctx: UIContext) => void;
+}
+export interface TabDef {
+    label: string;
+    content: (ctx: UIContext) => void;
+    disabled?: boolean;
+}
+export type AppCallback = (ui: UIContext) => void | Promise<void>;
+export type Connection = ServerConnection;

package/dist/components/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/components/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/components/types.ts"],"names":[],"mappings":""}

package/dist/engine/executor.d.ts

@@ -0,0 +1,20 @@
+import type { AppCallback, ConnectionScope } from '../components/types';
+import type { ClientEventPayload, ThemeMode } from './messages';
+export interface AppDefinition {
+    title: string;
+    callback: AppCallback;
+}
+export declare function runAppForScope(scope: ConnectionScope, title: string, callback: AppCallback, theme: ThemeMode): {
+    html: string;
+    title: string;
+    theme: ThemeMode;
+};
+export declare function handleClientEvent(scope: ConnectionScope, payload: ClientEventPayload): void;
+export declare function executeApp(appDef: AppDefinition, scope: ConnectionScope, theme: ThemeMode): {
+    ok: true;
+    html: string;
+} | {
+    ok: false;
+    error: Error;
+};
+export declare function resetScopeForRerender(scope: ConnectionScope): void;