lastriko 0.1.0

package/dist/engine/theme-path.js

@@ -0,0 +1,32 @@
+import { existsSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import process from 'node:process';
+import { fileURLToPath } from 'node:url';
+/**
+ * Resolve `lastriko.css` for `GET /style.css`.
+ *
+ * Resolution order:
+ * 1. `LASTRIKO_THEME_CSS` — absolute or cwd-relative path (must exist).
+ * 2. `packages/core/src/theme/lastriko.css` under `process.cwd()` (monorepo dev from repo root).
+ * 3. `../theme/lastriko.css` next to this module (`src/engine` or `dist/engine` after build).
+ *
+ * Returns `null` if no readable file is found (caller should respond with 500, not throw).
+ */
+export function resolveThemeCssPath(cwd) {
+    const fromEnv = process.env.LASTRIKO_THEME_CSS?.trim();
+    if (fromEnv) {
+        const abs = fromEnv.startsWith('/')
+            ? fromEnv
+            : join(cwd, fromEnv);
+        return existsSync(abs) ? abs : null;
+    }
+    const monorepoDev = join(cwd, 'packages/core/src/theme/lastriko.css');
+    if (existsSync(monorepoDev))
+        return monorepoDev;
+    const here = dirname(fileURLToPath(import.meta.url));
+    const nextToEngine = join(here, '../theme/lastriko.css');
+    if (existsSync(nextToEngine))
+        return nextToEngine;
+    return null;
+}
+//# sourceMappingURL=theme-path.js.map

package/dist/engine/theme-path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme-path.js","sourceRoot":"","sources":["../../src/engine/theme-path.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,OAAO,MAAM,cAAc,CAAC;AACnC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC;;;;;;;;;GASG;AACH,MAAM,UAAU,mBAAmB,CAAC,GAAW;IAC7C,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,kBAAkB,EAAE,IAAI,EAAE,CAAC;IACvD,IAAI,OAAO,EAAE,CAAC;QACZ,MAAM,GAAG,GAAG,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC;YACjC,CAAC,CAAC,OAAO;YACT,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QACvB,OAAO,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;IACtC,CAAC;IAED,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,EAAE,sCAAsC,CAAC,CAAC;IACtE,IAAI,UAAU,CAAC,WAAW,CAAC;QACzB,OAAO,WAAW,CAAC;IAErB,MAAM,IAAI,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACrD,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,EAAE,uBAAuB,CAAC,CAAC;IACzD,IAAI,UAAU,CAAC,YAAY,CAAC;QAC1B,OAAO,YAAY,CAAC;IAEtB,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/engine/theme-path.test.d.ts

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

package/dist/engine/theme-path.test.js

@@ -0,0 +1,52 @@
+import { mkdirSync, mkdtempSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { tmpdir } from 'node:os';
+import { afterEach, describe, expect, it } from 'vitest';
+import { resolveThemeCssPath } from './theme-path';
+describe('resolveThemeCssPath', () => {
+    const prevEnv = process.env.LASTRIKO_THEME_CSS;
+    afterEach(() => {
+        if (prevEnv === undefined)
+            delete process.env.LASTRIKO_THEME_CSS;
+        else
+            process.env.LASTRIKO_THEME_CSS = prevEnv;
+    });
+    it('returns monorepo dev path when cwd is repo root and packages/core tree exists', () => {
+        const cwd = join(__dirname, '../../../../');
+        const p = resolveThemeCssPath(cwd);
+        expect(p).not.toBeNull();
+        expect(p).toContain('packages/core/src/theme/lastriko.css');
+        expect(readFileSync(p, 'utf8')).toContain(':root');
+    });
+    it('uses LASTRIKO_THEME_CSS when set to an existing absolute path', () => {
+        const dir = mkdtempSync(join(tmpdir(), 'lk-theme-'));
+        const custom = join(dir, 'custom.css');
+        writeFileSync(custom, 'body{}');
+        process.env.LASTRIKO_THEME_CSS = custom;
+        expect(resolveThemeCssPath('/')).toBe(custom);
+        rmSync(dir, { recursive: true, force: true });
+    });
+    it('returns null when LASTRIKO_THEME_CSS points to a missing file', () => {
+        process.env.LASTRIKO_THEME_CSS = join(tmpdir(), 'nonexistent-lastriko-theme.css');
+        expect(resolveThemeCssPath(process.cwd())).toBeNull();
+    });
+    it('resolves next to engine module when monorepo layout is absent', () => {
+        const isolated = mkdtempSync(join(tmpdir(), 'lk-cwd-'));
+        const p = resolveThemeCssPath(isolated);
+        expect(p).not.toBeNull();
+        expect(readFileSync(p, 'utf8')).toContain(':root');
+        rmSync(isolated, { recursive: true, force: true });
+    });
+    it('prefers LASTRIKO_THEME_CSS over monorepo path when both exist', () => {
+        const dir = mkdtempSync(join(tmpdir(), 'lk-pref-'));
+        const fakeRoot = join(dir, 'repo');
+        mkdirSync(join(fakeRoot, 'packages/core/src/theme'), { recursive: true });
+        writeFileSync(join(fakeRoot, 'packages/core/src/theme/lastriko.css'), '/* mono */');
+        const custom = join(dir, 'winner.css');
+        writeFileSync(custom, '/* winner */');
+        process.env.LASTRIKO_THEME_CSS = custom;
+        expect(resolveThemeCssPath(fakeRoot)).toBe(custom);
+        rmSync(dir, { recursive: true, force: true });
+    });
+});
+//# sourceMappingURL=theme-path.test.js.map

package/dist/engine/theme-path.test.js.map

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

package/dist/engine/watcher.d.ts

@@ -0,0 +1,8 @@
+export interface Watcher {
+    stop: () => Promise<void> | void;
+}
+export declare function createWatcher(onReload: () => void, debounceMs?: number): {
+    scheduleReload: () => void;
+    stop: () => void;
+};
+export declare function startWatcher(_scriptPath: string, onReload: () => void, debounceMs?: number): Promise<Watcher>;

package/dist/engine/watcher.js

@@ -0,0 +1,27 @@
+export function createWatcher(onReload, debounceMs = 50) {
+    let timer;
+    return {
+        scheduleReload() {
+            if (timer) {
+                clearTimeout(timer);
+            }
+            timer = setTimeout(() => {
+                timer = undefined;
+                onReload();
+            }, debounceMs);
+        },
+        stop() {
+            if (timer) {
+                clearTimeout(timer);
+                timer = undefined;
+            }
+        },
+    };
+}
+export async function startWatcher(_scriptPath, onReload, debounceMs = 50) {
+    const watcher = createWatcher(onReload, debounceMs);
+    return {
+        stop: watcher.stop,
+    };
+}
+//# sourceMappingURL=watcher.js.map

package/dist/engine/watcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"watcher.js","sourceRoot":"","sources":["../../src/engine/watcher.ts"],"names":[],"mappings":"AAIA,MAAM,UAAU,aAAa,CAAC,QAAoB,EAAE,UAAU,GAAG,EAAE;IAIjE,IAAI,KAAgD,CAAC;IAErD,OAAO;QACL,cAAc;YACZ,IAAI,KAAK,EAAE,CAAC;gBACV,YAAY,CAAC,KAAK,CAAC,CAAC;YACtB,CAAC;YACD,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;gBACtB,KAAK,GAAG,SAAS,CAAC;gBAClB,QAAQ,EAAE,CAAC;YACb,CAAC,EAAE,UAAU,CAAC,CAAC;QACjB,CAAC;QACD,IAAI;YACF,IAAI,KAAK,EAAE,CAAC;gBACV,YAAY,CAAC,KAAK,CAAC,CAAC;gBACpB,KAAK,GAAG,SAAS,CAAC;YACpB,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,WAAmB,EACnB,QAAoB,EACpB,UAAU,GAAG,EAAE;IAEf,MAAM,OAAO,GAAG,aAAa,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IACpD,OAAO;QACL,IAAI,EAAE,OAAO,CAAC,IAAI;KACnB,CAAC;AACJ,CAAC"}

package/dist/engine/websocket.d.ts

@@ -0,0 +1,24 @@
+import type { AppDefinition } from './executor';
+import type { ConnectionScope } from '../components/types';
+export interface WebSocketLike {
+    send(data: string): void;
+}
+export interface SocketConnection {
+    socket: WebSocketLike;
+    scope: ConnectionScope;
+}
+export declare class WebSocketHub {
+    private readonly appDef;
+    private readonly connections;
+    private currentTheme;
+    constructor(appDef: AppDefinition);
+    addConnection(socket: WebSocketLike): ConnectionScope;
+    removeConnection(socket: WebSocketLike): void;
+    handleRawMessage(socket: WebSocketLike, raw: unknown): void;
+    handleHotReload(): void;
+    private handleMessage;
+    private handleReady;
+    private handleEvent;
+    private send;
+}
+export declare function createWebSocketHub(appDef: AppDefinition): WebSocketHub;

package/dist/engine/websocket.hub.test.d.ts

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

package/dist/engine/websocket.hub.test.js

@@ -0,0 +1,75 @@
+import { describe, expect, it } from 'vitest';
+import { createWebSocketHub } from './websocket';
+function captureSocket() {
+    const sent = [];
+    return {
+        socket: {
+            send(data) {
+                sent.push(data);
+            },
+        },
+        sent,
+    };
+}
+function parseSent(sent) {
+    return sent.map((s) => JSON.parse(s));
+}
+describe('webSocketHub', () => {
+    it('applies RESIZE to connection viewport', () => {
+        const { socket, sent } = captureSocket();
+        const hub = createWebSocketHub({
+            title: 't',
+            callback: () => { },
+        });
+        const scope = hub.addConnection(socket);
+        hub.handleRawMessage(socket, JSON.stringify({ type: 'RESIZE', payload: { width: 400, height: 300 } }));
+        expect(scope.viewport).toEqual({ width: 400, height: 300 });
+        expect(sent.length).toBeGreaterThan(0);
+    });
+    it('broadcasts hot reload and re-runs app', () => {
+        let runs = 0;
+        const { socket, sent } = captureSocket();
+        const hub = createWebSocketHub({
+            title: 'hot',
+            callback: () => {
+                runs++;
+            },
+        });
+        hub.addConnection(socket);
+        hub.handleRawMessage(socket, JSON.stringify({
+            type: 'READY',
+            payload: { viewport: { width: 1, height: 1 }, theme: 'light' },
+        }));
+        expect(runs).toBe(1);
+        const before = sent.length;
+        hub.handleHotReload();
+        expect(runs).toBe(2);
+        expect(sent.length).toBeGreaterThan(before);
+    });
+    it('sends ERROR when app callback throws on READY', () => {
+        const { socket, sent } = captureSocket();
+        const hub = createWebSocketHub({
+            title: 'bad',
+            callback: () => {
+                throw new Error('boom');
+            },
+        });
+        hub.addConnection(socket);
+        hub.handleRawMessage(socket, JSON.stringify({
+            type: 'READY',
+            payload: { viewport: { width: 1, height: 1 }, theme: null },
+        }));
+        const msgs = parseSent(sent);
+        expect(msgs.some((m) => m.type === 'ERROR')).toBe(true);
+    });
+    it('ignores messages from unknown sockets', () => {
+        const { socket, sent } = captureSocket();
+        const hub = createWebSocketHub({ title: 'x', callback: () => { } });
+        hub.handleRawMessage(socket, JSON.stringify({
+            type: 'READY',
+            payload: { viewport: { width: 1, height: 1 }, theme: null },
+        }));
+        expect(sent).toHaveLength(0);
+    });
+});
+//# sourceMappingURL=websocket.hub.test.js.map

package/dist/engine/websocket.hub.test.js.map

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

package/dist/engine/websocket.js

@@ -0,0 +1,119 @@
+import { executeApp, handleClientEvent } from './executor';
+import { parseClientMessage, serializeServerMessage } from './messages';
+import { createConnectionScope } from '../components/registry';
+export class WebSocketHub {
+    appDef;
+    connections = new Map();
+    currentTheme = 'light';
+    constructor(appDef) {
+        this.appDef = appDef;
+    }
+    addConnection(socket) {
+        const scope = createConnectionScope(undefined, {
+            send: (message) => this.send(socket, message),
+        });
+        this.send(socket, {
+            type: 'TOAST',
+            payload: {
+                type: 'info',
+                message: `__connection_id__:${scope.id}`,
+                duration: 50,
+            },
+        });
+        this.connections.set(socket, { socket, scope });
+        return scope;
+    }
+    removeConnection(socket) {
+        const entry = this.connections.get(socket);
+        if (!entry) {
+            return;
+        }
+        entry.scope.destroy();
+        this.connections.delete(socket);
+    }
+    handleRawMessage(socket, raw) {
+        const parsed = parseClientMessage(raw);
+        if (!parsed) {
+            return;
+        }
+        this.handleMessage(socket, parsed);
+    }
+    handleHotReload() {
+        for (const { socket, scope } of this.connections.values()) {
+            this.send(socket, {
+                type: 'TOAST',
+                payload: { message: 'Reloading...', type: 'info', duration: 1200 },
+            });
+            scope.clearTransientState();
+            const result = executeApp(this.appDef, scope, this.currentTheme);
+            if (!result.ok) {
+                this.send(socket, {
+                    type: 'ERROR',
+                    payload: { message: result.error.message, stack: result.error.stack },
+                });
+            }
+        }
+    }
+    handleMessage(socket, message) {
+        const entry = this.connections.get(socket);
+        if (!entry) {
+            return;
+        }
+        switch (message.type) {
+            case 'READY':
+                this.handleReady(entry, message);
+                break;
+            case 'EVENT':
+                this.handleEvent(entry, message);
+                break;
+            case 'THEME_CHANGE':
+                this.currentTheme = message.payload.mode;
+                entry.scope.theme = this.currentTheme;
+                this.send(socket, { type: 'THEME', payload: { mode: this.currentTheme } });
+                break;
+            case 'RESIZE':
+                entry.scope.viewport = {
+                    width: message.payload.width,
+                    height: message.payload.height,
+                };
+                break;
+        }
+    }
+    handleReady(entry, message) {
+        this.currentTheme = message.payload.theme ?? this.currentTheme;
+        entry.scope.theme = this.currentTheme;
+        entry.scope.viewport = {
+            width: message.payload.viewport.width,
+            height: message.payload.viewport.height,
+        };
+        const result = executeApp(this.appDef, entry.scope, this.currentTheme);
+        if (!result.ok) {
+            this.send(entry.socket, {
+                type: 'ERROR',
+                payload: { message: result.error.message, stack: result.error.stack },
+            });
+        }
+    }
+    handleEvent(entry, message) {
+        const { scope } = entry;
+        try {
+            handleClientEvent(scope, message.payload);
+        }
+        catch (error) {
+            this.send(entry.socket, {
+                type: 'TOAST',
+                payload: {
+                    type: 'error',
+                    message: error instanceof Error ? error.message : String(error),
+                },
+            });
+        }
+    }
+    send(socket, message) {
+        socket.send(serializeServerMessage(message));
+    }
+}
+export function createWebSocketHub(appDef) {
+    return new WebSocketHub(appDef);
+}
+//# sourceMappingURL=websocket.js.map

package/dist/engine/websocket.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,21 @@
+import type { LastrikoPlugin } from './plugins/types';
+import { type RuntimeConfig, type RunningServer } from './engine/server';
+import type { AppCallback } from './components/types';
+export interface AppConfig extends RuntimeConfig {
+    plugins?: LastrikoPlugin[];
+    toolbar?: boolean;
+}
+export interface AppOptions {
+    plugins?: LastrikoPlugin[];
+    server?: RuntimeConfig;
+}
+export interface RunningApp {
+    stop: () => Promise<void>;
+    server: RunningServer;
+}
+export declare function defineConfig(config: AppConfig): AppConfig;
+export declare function app(title: string, callback: AppCallback, opts?: AppOptions): Promise<RunningApp>;
+export type { ConnectionScope as Connection, ComponentHandle, ButtonHandle, ButtonCallbackHandle, InputHandle, TextHandle, TextInputHandle, NumberInputHandle, SliderHandle, ToggleHandle, SelectHandle, FileUploadHandle, UploadedFile, SelectOption, ButtonOpts, TextInputOpts, NumberInputOpts, SliderOpts, ToggleOpts, SelectOpts, FileUploadOpts, TableHandle, TableRow, TableRowHandle as RowHandle, MetricHandle, MetricOpts, ProgressHandle, ProgressOpts, StreamHandle, StreamTextOpts, ChatHandle, ChatUIOptions, PromptEditorHandle, PromptEditorOpts, ShellRegions, ShellOpts, GridOpts, TabsOpts, TabDef, ToastOpts, AlertOpts, LoadingOpts, UIContext, AppCallback, } from './components/types';
+export type { LastrikoPlugin } from './plugins/types';
+export { createWebSocketHub } from './engine/websocket';
+export { createWatcher, startWatcher } from './engine/watcher';

package/dist/index.js

@@ -0,0 +1,26 @@
+import process from 'node:process';
+import { createServer } from './engine/server';
+export function defineConfig(config) {
+    return config;
+}
+export async function app(title, callback, opts = {}) {
+    const plugins = opts.plugins;
+    const server = await createServer({
+        title,
+        plugins,
+        app: callback,
+        ...(opts.server ?? {}),
+    });
+    if (process.env.NODE_ENV !== 'test') {
+        console.info(`[lastriko] Ready at http://${server.host}:${server.port}`);
+    }
+    return {
+        server,
+        stop: async () => {
+            await server.stop();
+        },
+    };
+}
+export { createWebSocketHub } from './engine/websocket';
+export { createWatcher, startWatcher } from './engine/watcher';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,cAAc,CAAC;AAEnC,OAAO,EAAE,YAAY,EAA0C,MAAM,iBAAiB,CAAC;AAkBvF,MAAM,UAAU,YAAY,CAAC,MAAiB;IAC5C,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,GAAG,CAAC,KAAa,EAAE,QAAqB,EAAE,OAAmB,EAAE;IACnF,MAAM,OAAO,GAAG,IAAI,CAAC,OAA6E,CAAC;IACnG,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC;QAChC,KAAK;QACL,OAAO;QACP,GAAG,EAAE,QAAQ;QACb,GAAG,CAAC,IAAI,CAAC,MAAM,IAAI,EAAE,CAAC;KACvB,CAAC,CAAC;IACH,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,MAAM,EAAE,CAAC;QACpC,OAAO,CAAC,IAAI,CAAC,8BAA8B,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;IAC3E,CAAC;IAED,OAAO;QACL,MAAM;QACN,IAAI,EAAE,KAAK,IAAI,EAAE;YACf,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;QACtB,CAAC;KACF,CAAC;AACJ,CAAC;AAiDD,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/plugins/registry.d.ts

@@ -0,0 +1,11 @@
+import type { LastrikoPlugin, PluginContext } from './types';
+export declare class PluginRegistry {
+    private readonly plugins;
+    private readonly ordered;
+    constructor(initial?: LastrikoPlugin[]);
+    register(plugin: LastrikoPlugin): void;
+    setupAll(context?: PluginContext): Promise<void>;
+    teardownAll(): Promise<void>;
+    getPlugin(name: string): Pick<LastrikoPlugin, 'name' | 'version'> | undefined;
+}
+export declare function createPluginRegistry(initial?: LastrikoPlugin[]): PluginRegistry;

package/dist/plugins/registry.js

@@ -0,0 +1,61 @@
+import { atom } from 'nanostores';
+export class PluginRegistry {
+    plugins = new Map();
+    ordered = [];
+    constructor(initial = []) {
+        for (const plugin of initial) {
+            this.register(plugin);
+        }
+    }
+    register(plugin) {
+        if (this.plugins.has(plugin.name)) {
+            throw new Error(`Duplicate plugin name: ${plugin.name}`);
+        }
+        this.plugins.set(plugin.name, plugin);
+        this.ordered.push(plugin);
+    }
+    async setupAll(context) {
+        const ctx = context ?? createDefaultPluginContext(this);
+        for (const plugin of this.ordered) {
+            await plugin.setup(ctx);
+        }
+    }
+    async teardownAll() {
+        for (const plugin of [...this.ordered].reverse()) {
+            await plugin.teardown?.();
+        }
+    }
+    getPlugin(name) {
+        const plugin = this.plugins.get(name);
+        if (!plugin) {
+            return undefined;
+        }
+        return {
+            name: plugin.name,
+            version: plugin.version,
+        };
+    }
+}
+export function createPluginRegistry(initial = []) {
+    return new PluginRegistry(initial);
+}
+function createDefaultPluginContext(registry) {
+    return {
+        registerComponent: () => { },
+        registerRoute: () => { },
+        registerMiddleware: () => { },
+        getStore: (_key, initialValue) => atom(initialValue),
+        onConnection: (_handler) => { },
+        onDisconnect: (_handler) => { },
+        onEvent: (_handler) => { },
+        config: {},
+        logger: {
+            info: () => { },
+            warn: () => { },
+            error: () => { },
+            debug: () => { },
+        },
+        getPlugin: (name) => registry.getPlugin(name),
+    };
+}
+//# sourceMappingURL=registry.js.map

package/dist/plugins/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/plugins/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAqB,MAAM,YAAY,CAAC;AAIrD,MAAM,OAAO,cAAc;IACR,OAAO,GAAG,IAAI,GAAG,EAA0B,CAAC;IAC5C,OAAO,GAAqB,EAAE,CAAC;IAEhD,YAAY,UAA4B,EAAE;QACxC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QACxB,CAAC;IACH,CAAC;IAED,QAAQ,CAAC,MAAsB;QAC7B,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;YAClC,MAAM,IAAI,KAAK,CAAC,0BAA0B,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;QAC3D,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACtC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC5B,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,OAAuB;QACpC,MAAM,GAAG,GAAG,OAAO,IAAI,0BAA0B,CAAC,IAAI,CAAC,CAAC;QACxD,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YAClC,MAAM,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;IAED,KAAK,CAAC,WAAW;QACf,KAAK,MAAM,MAAM,IAAI,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC;YACjD,MAAM,MAAM,CAAC,QAAQ,EAAE,EAAE,CAAC;QAC5B,CAAC;IACH,CAAC;IAED,SAAS,CAAC,IAAY;QACpB,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACtC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,OAAO;YACL,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,OAAO,EAAE,MAAM,CAAC,OAAO;SACxB,CAAC;IACJ,CAAC;CACF;AAED,MAAM,UAAU,oBAAoB,CAAC,UAA4B,EAAE;IACjE,OAAO,IAAI,cAAc,CAAC,OAAO,CAAC,CAAC;AACrC,CAAC;AAED,SAAS,0BAA0B,CAAC,QAAwB;IAC1D,OAAO;QACL,iBAAiB,EAAE,GAAG,EAAE,GAAE,CAAC;QAC3B,aAAa,EAAE,GAAG,EAAE,GAAE,CAAC;QACvB,kBAAkB,EAAE,GAAG,EAAE,GAAE,CAAC;QAC5B,QAAQ,EAAE,CAAI,IAAY,EAAE,YAAe,EAAmB,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC;QACnF,YAAY,EAAE,CAAC,QAA0C,EAAE,EAAE,GAAE,CAAC;QAChE,YAAY,EAAE,CAAC,QAA0C,EAAE,EAAE,GAAE,CAAC;QAChE,OAAO,EAAE,CAAC,QAA0I,EAAE,EAAE,GAAE,CAAC;QAC3J,MAAM,EAAE,EAAE;QACV,MAAM,EAAE;YACN,IAAI,EAAE,GAAG,EAAE,GAAE,CAAC;YACd,IAAI,EAAE,GAAG,EAAE,GAAE,CAAC;YACd,KAAK,EAAE,GAAG,EAAE,GAAE,CAAC;YACf,KAAK,EAAE,GAAG,EAAE,GAAE,CAAC;SAChB;QACD,SAAS,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC;KAC9C,CAAC;AACJ,CAAC"}

package/dist/plugins/registry.test.d.ts

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

package/dist/plugins/registry.test.js

@@ -0,0 +1,44 @@
+import { describe, expect, test } from 'vitest';
+import { createPluginRegistry } from './registry';
+function createPlugin(name) {
+    return {
+        name,
+        version: '1.0.0',
+        setup: async () => { },
+        teardown: async () => { },
+    };
+}
+describe('plugin registry', () => {
+    test('setup and teardown execute in expected order', async () => {
+        const order = [];
+        const a = {
+            name: 'a',
+            version: '1.0.0',
+            setup: async () => {
+                order.push('setup-a');
+            },
+            teardown: async () => {
+                order.push('teardown-a');
+            },
+        };
+        const b = {
+            name: 'b',
+            version: '1.0.0',
+            setup: async () => {
+                order.push('setup-b');
+            },
+            teardown: async () => {
+                order.push('teardown-b');
+            },
+        };
+        const registry = createPluginRegistry([a, b]);
+        await registry.setupAll();
+        await registry.teardownAll();
+        expect(order).toEqual(['setup-a', 'setup-b', 'teardown-b', 'teardown-a']);
+        expect(registry.getPlugin('a')).toEqual({ name: 'a', version: '1.0.0' });
+    });
+    test('duplicate plugin names are rejected', () => {
+        expect(() => createPluginRegistry([createPlugin('x'), createPlugin('x')])).toThrow(/Duplicate plugin name/);
+    });
+});
+//# sourceMappingURL=registry.test.js.map

package/dist/plugins/registry.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.test.js","sourceRoot":"","sources":["../../src/plugins/registry.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAChD,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAGlD,SAAS,YAAY,CAAC,IAAY;IAChC,OAAO;QACL,IAAI;QACJ,OAAO,EAAE,OAAO;QAChB,KAAK,EAAE,KAAK,IAAI,EAAE,GAAE,CAAC;QACrB,QAAQ,EAAE,KAAK,IAAI,EAAE,GAAE,CAAC;KACzB,CAAC;AACJ,CAAC;AAED,QAAQ,CAAC,iBAAiB,EAAE,GAAG,EAAE;IAC/B,IAAI,CAAC,8CAA8C,EAAE,KAAK,IAAI,EAAE;QAC9D,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,MAAM,CAAC,GAAmB;YACxB,IAAI,EAAE,GAAG;YACT,OAAO,EAAE,OAAO;YAChB,KAAK,EAAE,KAAK,IAAI,EAAE;gBAChB,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YACxB,CAAC;YACD,QAAQ,EAAE,KAAK,IAAI,EAAE;gBACnB,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;YAC3B,CAAC;SACF,CAAC;QACF,MAAM,CAAC,GAAmB;YACxB,IAAI,EAAE,GAAG;YACT,OAAO,EAAE,OAAO;YAChB,KAAK,EAAE,KAAK,IAAI,EAAE;gBAChB,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YACxB,CAAC;YACD,QAAQ,EAAE,KAAK,IAAI,EAAE;gBACnB,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;YAC3B,CAAC;SACF,CAAC;QAEF,MAAM,QAAQ,GAAG,oBAAoB,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QAC9C,MAAM,QAAQ,CAAC,QAAQ,EAAE,CAAC;QAC1B,MAAM,QAAQ,CAAC,WAAW,EAAE,CAAC;QAE7B,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,SAAS,EAAE,SAAS,EAAE,YAAY,EAAE,YAAY,CAAC,CAAC,CAAC;QAC1E,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;IAC3E,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,qCAAqC,EAAE,GAAG,EAAE;QAC/C,MAAM,CAAC,GAAG,EAAE,CAAC,oBAAoB,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,EAAE,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAChF,uBAAuB,CACxB,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/plugins/types.d.ts

@@ -0,0 +1,30 @@
+import type { WritableAtom } from 'nanostores';
+import type { ComponentHandle, ConnectionScope } from '../components/types';
+import type { ClientEventPayload } from '../engine/messages';
+export interface PluginLogger {
+    info(msg: string, data?: Record<string, unknown>): void;
+    warn(msg: string, data?: Record<string, unknown>): void;
+    error(msg: string, data?: Record<string, unknown>): void;
+    debug(msg: string, data?: Record<string, unknown>): void;
+}
+export interface RouteHandler {
+    (request: Request): Response | Promise<Response>;
+}
+export interface PluginContext {
+    registerComponent<T extends ComponentHandle<Record<string, unknown>, unknown>>(_name: string, _definition: unknown): void;
+    registerRoute(method: 'GET' | 'POST' | 'PUT' | 'DELETE', path: string, handler: RouteHandler): void;
+    registerMiddleware(_fn: (request: Request) => Response | Promise<Response> | void): void;
+    getStore<T>(key: string, initialValue: T): WritableAtom<T>;
+    onConnection(handler: (scope: ConnectionScope) => void): void;
+    onDisconnect(handler: (scope: ConnectionScope) => void): void;
+    onEvent(handler: (scope: ConnectionScope, event: ClientEventPayload) => boolean | void): void;
+    config: Record<string, unknown>;
+    logger: PluginLogger;
+    getPlugin(name: string): Pick<LastrikoPlugin, 'name' | 'version'> | undefined;
+}
+export interface LastrikoPlugin {
+    name: string;
+    version: string;
+    setup(ctx: PluginContext): void | Promise<void>;
+    teardown?(): void | Promise<void>;
+}

package/dist/plugins/types.js

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

package/dist/plugins/types.js.map

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