lastriko 0.1.0

package/dist/engine/executor.js

@@ -0,0 +1,84 @@
+import { UIContext } from '../components/context';
+import { renderPage } from './renderer';
+export function runAppForScope(scope, title, callback, theme) {
+    scope.counters.clear();
+    scope.handles.clear();
+    const ui = new UIContext(scope);
+    callback(ui);
+    const html = renderPage(scope.listHandles());
+    const render = { html, title, theme };
+    scope.send({ type: 'RENDER', payload: render });
+    return render;
+}
+export function handleClientEvent(scope, payload) {
+    const handle = scope.getHandle(payload.id);
+    if (!handle) {
+        return;
+    }
+    if (payload.event === 'change') {
+        scope.setValue(payload.id, payload.value);
+        if (handle.type === 'table') {
+            return;
+        }
+        scope.pushFragment(handle);
+        return;
+    }
+    if (payload.event !== 'click') {
+        return;
+    }
+    if (handle.type === 'button') {
+        const buttonHandle = handle;
+        const callbackHandle = {
+            setLoading(loading) {
+                buttonHandle.setLoading(loading);
+            },
+        };
+        Promise.resolve(buttonHandle.props.onClick(callbackHandle)).catch((error) => {
+            scope.send({
+                type: 'TOAST',
+                payload: {
+                    type: 'error',
+                    message: error instanceof Error ? error.message : String(error),
+                },
+            });
+        });
+        return;
+    }
+    if (handle.type === 'table' && typeof payload.value === 'string') {
+        const tableHandle = handle;
+        const row = tableHandle.props.rows.find((entry) => entry.id === payload.value);
+        if (!row) {
+            return;
+        }
+        const clickHandler = tableHandle.props.getOnRowClick?.();
+        if (!clickHandler) {
+            return;
+        }
+        Promise.resolve(clickHandler(row.data)).catch((error) => {
+            scope.send({
+                type: 'TOAST',
+                payload: {
+                    type: 'error',
+                    message: error instanceof Error ? error.message : String(error),
+                },
+            });
+        });
+    }
+}
+export function executeApp(appDef, scope, theme) {
+    try {
+        const render = runAppForScope(scope, appDef.title, appDef.callback, theme);
+        return { ok: true, html: render.html };
+    }
+    catch (error) {
+        return {
+            ok: false,
+            error: error instanceof Error ? error : new Error(String(error)),
+        };
+    }
+}
+export function resetScopeForRerender(scope) {
+    scope.handles.clear();
+    scope.counters.clear();
+}
+//# sourceMappingURL=executor.js.map

package/dist/engine/executor.js.map

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

package/dist/engine/executor.test.d.ts

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

package/dist/engine/executor.test.js

@@ -0,0 +1,79 @@
+import { describe, expect, it, vi } from 'vitest';
+import { UIContext } from '../components/context';
+import { createConnectionScope } from '../components/registry';
+import { executeApp, handleClientEvent } from './executor';
+describe('executeApp', () => {
+    it('returns ok with html when callback succeeds', () => {
+        const scope = createConnectionScope('exec-ok');
+        const result = executeApp({ title: 't', callback: (ui) => {
+                ui.text('hi');
+            } }, scope, 'light');
+        expect(result.ok).toBe(true);
+        if (result.ok)
+            expect(result.html).toContain('hi');
+    });
+    it('returns ok: false when callback throws', () => {
+        const scope = createConnectionScope('exec-err');
+        const result = executeApp({ title: 't', callback: () => { throw new Error('fail'); } }, scope, 'light');
+        expect(result.ok).toBe(false);
+        if (!result.ok)
+            expect(result.error.message).toBe('fail');
+    });
+});
+describe('handleClientEvent', () => {
+    it('does not push FRAGMENT for table change events (row selection)', () => {
+        const scope = createConnectionScope('exec-table');
+        const ui = new UIContext(scope);
+        ui.table([{ name: 'a' }], { columns: ['name'] });
+        const table = scope.getHandle('table-1');
+        expect(table).toBeDefined();
+        scope.outbox.length = 0;
+        handleClientEvent(scope, {
+            id: table.id,
+            event: 'change',
+            value: 'some-row-id',
+        });
+        expect(scope.outbox.filter((m) => m.type === 'FRAGMENT')).toHaveLength(0);
+    });
+    it('invokes button onClick and reflects setLoading in FRAGMENT payloads', async () => {
+        const scope = createConnectionScope('exec-btn');
+        const ui = new UIContext(scope);
+        ui.button('Run', async (btn) => {
+            btn.setLoading(true);
+            await Promise.resolve();
+            btn.setLoading(false);
+        });
+        const button = scope.getHandle('button-1');
+        expect(button).toBeDefined();
+        scope.outbox.length = 0;
+        handleClientEvent(scope, {
+            id: button.id,
+            event: 'click',
+        });
+        await vi.waitFor(() => {
+            const fragments = scope.outbox.filter((m) => m.type === 'FRAGMENT' && m.payload.id === button.id);
+            expect(fragments.length).toBeGreaterThanOrEqual(2);
+        });
+        const fragments = scope.outbox.filter((m) => m.type === 'FRAGMENT' && m.payload.id === button.id);
+        expect(fragments.some((f) => f.payload.html.includes('aria-busy="true"'))).toBe(true);
+        expect(fragments.at(-1)?.payload.html).not.toContain('aria-busy="true"');
+    });
+    it('dispatches table row click handler with row data', async () => {
+        const scope = createConnectionScope('exec-row');
+        const ui = new UIContext(scope);
+        const table = ui.table([{ id: 'r1', name: 'row' }], { columns: ['id', 'name'] });
+        const rowId = table.props.rows[0].id;
+        const onClick = vi.fn();
+        table.onRowClick(onClick);
+        scope.outbox.length = 0;
+        handleClientEvent(scope, {
+            id: table.id,
+            event: 'click',
+            value: rowId,
+        });
+        await vi.waitFor(() => {
+            expect(onClick).toHaveBeenCalledWith({ id: 'r1', name: 'row' });
+        });
+    });
+});
+//# sourceMappingURL=executor.test.js.map

package/dist/engine/executor.test.js.map

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

package/dist/engine/index.d.ts

@@ -0,0 +1,6 @@
+export { createServer } from './server';
+export { createWebSocketHub } from './websocket';
+export { renderComponent, renderPage, escapeHtml } from './renderer';
+export { createWatcher, startWatcher } from './watcher';
+export { createLifecycleController } from './lifecycle';
+export { createConnectionScope } from '../components/registry';

package/dist/engine/index.js

@@ -0,0 +1,7 @@
+export { createServer } from './server';
+export { createWebSocketHub } from './websocket';
+export { renderComponent, renderPage, escapeHtml } from './renderer';
+export { createWatcher, startWatcher } from './watcher';
+export { createLifecycleController } from './lifecycle';
+export { createConnectionScope } from '../components/registry';
+//# sourceMappingURL=index.js.map

package/dist/engine/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/engine/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACrE,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACxD,OAAO,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/engine/lifecycle.d.ts

@@ -0,0 +1,16 @@
+export type LifecycleStage = 'BOOTSTRAP' | 'SERVER_START' | 'WAITING' | 'CONNECTION' | 'RUNTIME' | 'DISCONNECT' | 'STOPPING' | 'SHUTDOWN';
+export declare class LifecycleController {
+    private stage;
+    private readonly listeners;
+    current(): LifecycleStage;
+    transition(next: LifecycleStage): void;
+    toServerStart(): void;
+    toWaiting(): void;
+    toConnection(): void;
+    toRuntime(): void;
+    toDisconnect(): void;
+    toStopping(): void;
+    toShutdown(): void;
+    subscribe(listener: (next: LifecycleStage) => void): () => void;
+}
+export declare function createLifecycleController(): LifecycleController;

package/dist/engine/lifecycle.js

@@ -0,0 +1,44 @@
+export class LifecycleController {
+    stage = 'BOOTSTRAP';
+    listeners = new Set();
+    current() {
+        return this.stage;
+    }
+    transition(next) {
+        this.stage = next;
+        for (const listener of this.listeners) {
+            listener(next);
+        }
+    }
+    toServerStart() {
+        this.transition('SERVER_START');
+    }
+    toWaiting() {
+        this.transition('WAITING');
+    }
+    toConnection() {
+        this.transition('CONNECTION');
+    }
+    toRuntime() {
+        this.transition('RUNTIME');
+    }
+    toDisconnect() {
+        this.transition('DISCONNECT');
+    }
+    toStopping() {
+        this.transition('STOPPING');
+    }
+    toShutdown() {
+        this.transition('SHUTDOWN');
+    }
+    subscribe(listener) {
+        this.listeners.add(listener);
+        return () => {
+            this.listeners.delete(listener);
+        };
+    }
+}
+export function createLifecycleController() {
+    return new LifecycleController();
+}
+//# sourceMappingURL=lifecycle.js.map

package/dist/engine/lifecycle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.js","sourceRoot":"","sources":["../../src/engine/lifecycle.ts"],"names":[],"mappings":"AAUA,MAAM,OAAO,mBAAmB;IACtB,KAAK,GAAmB,WAAW,CAAC;IAC3B,SAAS,GAAG,IAAI,GAAG,EAAkC,CAAC;IAEvE,OAAO;QACL,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED,UAAU,CAAC,IAAoB;QAC7B,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAClB,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACtC,QAAQ,CAAC,IAAI,CAAC,CAAC;QACjB,CAAC;IACH,CAAC;IAED,aAAa;QACX,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC;IAClC,CAAC;IAED,SAAS;QACP,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;IAC7B,CAAC;IAED,YAAY;QACV,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;IAChC,CAAC;IAED,SAAS;QACP,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;IAC7B,CAAC;IAED,YAAY;QACV,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;IAChC,CAAC;IAED,UAAU;QACR,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;IAC9B,CAAC;IAED,UAAU;QACR,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;IAC9B,CAAC;IAED,SAAS,CAAC,QAAwC;QAChD,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC7B,OAAO,GAAG,EAAE;YACV,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAClC,CAAC,CAAC;IACJ,CAAC;CACF;AAED,MAAM,UAAU,yBAAyB;IACvC,OAAO,IAAI,mBAAmB,EAAE,CAAC;AACnC,CAAC"}

package/dist/engine/lifecycle.test.d.ts

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

package/dist/engine/lifecycle.test.js

@@ -0,0 +1,15 @@
+import { describe, expect, it } from 'vitest';
+import { createLifecycleController } from './lifecycle';
+describe('lifecycle state', () => {
+    it('transitions to shutdown in order', () => {
+        const lifecycle = createLifecycleController();
+        lifecycle.toServerStart();
+        lifecycle.toWaiting();
+        lifecycle.toConnection();
+        lifecycle.toRuntime();
+        lifecycle.toStopping();
+        lifecycle.toShutdown();
+        expect(lifecycle.current()).toBe('SHUTDOWN');
+    });
+});
+//# sourceMappingURL=lifecycle.test.js.map

package/dist/engine/lifecycle.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.test.js","sourceRoot":"","sources":["../../src/engine/lifecycle.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAC;AAExD,QAAQ,CAAC,iBAAiB,EAAE,GAAG,EAAE;IAC/B,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;QAC1C,MAAM,SAAS,GAAG,yBAAyB,EAAE,CAAC;QAC9C,SAAS,CAAC,aAAa,EAAE,CAAC;QAC1B,SAAS,CAAC,SAAS,EAAE,CAAC;QACtB,SAAS,CAAC,YAAY,EAAE,CAAC;QACzB,SAAS,CAAC,SAAS,EAAE,CAAC;QACtB,SAAS,CAAC,UAAU,EAAE,CAAC;QACvB,SAAS,CAAC,UAAU,EAAE,CAAC;QACvB,MAAM,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/engine/messages.d.ts

@@ -0,0 +1,95 @@
+export type ThemeMode = 'light' | 'dark';
+export interface RenderPayload {
+    html: string;
+    title: string;
+    theme: ThemeMode;
+}
+export interface RenderMessage {
+    type: 'RENDER';
+    payload: RenderPayload;
+}
+export interface FragmentMessage {
+    type: 'FRAGMENT';
+    payload: {
+        id: string;
+        html: string;
+    };
+}
+export interface ToastMessage {
+    type: 'TOAST';
+    payload: {
+        message: string;
+        type: 'info' | 'success' | 'warning' | 'error';
+        duration?: number;
+    };
+}
+export interface ThemeMessage {
+    type: 'THEME';
+    payload: {
+        mode: ThemeMode;
+    };
+}
+export interface StreamChunkMessage {
+    type: 'STREAM_CHUNK';
+    payload: {
+        id: string;
+        chunk: string;
+        done: boolean;
+        format: 'plain' | 'markdown';
+    };
+}
+export interface StreamErrorMessage {
+    type: 'STREAM_ERROR';
+    payload: {
+        id: string;
+        error: string;
+    };
+}
+export interface ErrorMessage {
+    type: 'ERROR';
+    payload: {
+        message: string;
+        stack?: string;
+    };
+}
+export type ServerMessage = RenderMessage | FragmentMessage | ToastMessage | ThemeMessage | StreamChunkMessage | StreamErrorMessage | ErrorMessage;
+export type ServerToClientMessage = ServerMessage;
+export interface ReadyMessage {
+    type: 'READY';
+    payload: {
+        viewport: {
+            width: number;
+            height: number;
+        };
+        theme: ThemeMode | null;
+    };
+}
+export interface ClientEventPayload {
+    id: string;
+    event: 'click' | 'change' | 'blur' | 'focus';
+    value?: unknown;
+}
+export interface EventMessage {
+    type: 'EVENT';
+    payload: ClientEventPayload;
+}
+export interface ThemeChangeMessage {
+    type: 'THEME_CHANGE';
+    payload: {
+        mode: ThemeMode;
+    };
+}
+export interface ResizeMessage {
+    type: 'RESIZE';
+    payload: {
+        width: number;
+        height: number;
+    };
+}
+export type ClientMessage = ReadyMessage | EventMessage | ThemeChangeMessage | ResizeMessage;
+export type ClientToServerMessage = ClientMessage;
+export interface Transport {
+    send: (message: ServerMessage) => void;
+}
+export declare function parseClientMessage(raw: unknown): ClientMessage | null;
+export declare function serializeServerMessage(message: ServerMessage): string;

package/dist/engine/messages.js

@@ -0,0 +1,21 @@
+export function parseClientMessage(raw) {
+    if (typeof raw !== 'string')
+        return null;
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+    if (!parsed || typeof parsed !== 'object')
+        return null;
+    const type = parsed.type;
+    if (type !== 'READY' && type !== 'EVENT' && type !== 'THEME_CHANGE' && type !== 'RESIZE')
+        return null;
+    return parsed;
+}
+export function serializeServerMessage(message) {
+    return JSON.stringify(message);
+}
+//# sourceMappingURL=messages.js.map

package/dist/engine/messages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.js","sourceRoot":"","sources":["../../src/engine/messages.ts"],"names":[],"mappings":"AAqHA,MAAM,UAAU,kBAAkB,CAAC,GAAY;IAC7C,IAAI,OAAO,GAAG,KAAK,QAAQ;QACzB,OAAO,IAAI,CAAC;IAEd,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ;QACvC,OAAO,IAAI,CAAC;IAEd,MAAM,IAAI,GAAI,MAA6B,CAAC,IAAI,CAAC;IACjD,IAAI,IAAI,KAAK,OAAO,IAAI,IAAI,KAAK,OAAO,IAAI,IAAI,KAAK,cAAc,IAAI,IAAI,KAAK,QAAQ;QACtF,OAAO,IAAI,CAAC;IAEd,OAAO,MAAuB,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,OAAsB;IAC3D,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;AACjC,CAAC"}

package/dist/engine/renderer.components.test.d.ts

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