lastriko 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,7 @@
+# Changelog
+
+All notable changes to the **`lastriko`** npm package are documented here. The monorepo roadmap and design history live in the repository root [MANIFEST.md](https://github.com/aixpose/lastriko/blob/main/MANIFEST.md).
+
+## 0.1.0 — 2026-04-08
+
+Initial published MVP (Phase 2 scope): `app()`, WebSocket + HTML fragments, MVP component set, `lastriko/style.css`, Node.js 22+.

package/README.md

@@ -0,0 +1,58 @@
+# lastriko
+
+Server-driven UI for AI demos and rapid prototypes: your TypeScript `app()` builds handles, the engine renders HTML fragments, and the browser swaps `outerHTML` over a WebSocket.
+
+## Install
+
+```bash
+npm install lastriko
+```
+
+Requires **Node.js 22+**. [Bun](https://bun.sh) is also supported.
+
+## Quick start
+
+```typescript
+import { app } from 'lastriko';
+
+await app('Hello', (ui) => {
+  const name = ui.textInput('Name');
+  const out = ui.text('Hi!');
+  ui.button('Greet', () => {
+    out.update(`Hello, ${name.value || 'stranger'}!`);
+  });
+});
+```
+
+Run with `tsx` or `bun`; open the URL printed in the console (default port **3500**).
+
+## Exports
+
+- **JS API** — `import { app, defineConfig } from 'lastriko'`
+- **Styles** — `import 'lastriko/style.css'` (or load `/style.css` from the dev server)
+
+## Docs
+
+- [Project manifest & roadmap](https://github.com/aixpose/lastriko/blob/main/MANIFEST.md)
+- [API reference](https://github.com/aixpose/lastriko/blob/main/docs/API-REFERENCE.md)
+- [Phase 2 (MVP) scope](https://github.com/aixpose/lastriko/blob/main/docs/phases/PHASE-2.md)
+
+## Examples in this repo
+
+- `examples/component-gallery` — all MVP components on one page
+- `examples/experiment-monitor`, `examples/image-viewer` — larger demos
+
+## Publishing (maintainers)
+
+From the monorepo root, after tests pass:
+
+```bash
+npm run build -w lastriko
+npm publish -w lastriko --access public
+```
+
+`prepack` runs `build` automatically on `npm publish`.
+
+## License
+
+MIT — see [LICENSE](https://github.com/aixpose/lastriko/blob/main/LICENSE) in the repository root.

package/dist/__tests__/integration/ws-flow.integration.test.d.ts

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

package/dist/__tests__/integration/ws-flow.integration.test.js

@@ -0,0 +1,249 @@
+import { describe, expect, it } from 'vitest';
+import { createWebSocketHub } from '../../engine/websocket';
+function createSocket() {
+    const sent = [];
+    return {
+        socket: {
+            send(data) {
+                sent.push(data);
+            },
+        },
+        sent,
+    };
+}
+function byType(sent, type) {
+    return sent
+        .map((item) => JSON.parse(item))
+        .filter((msg) => msg.type === type);
+}
+describe('websocket integration flow', () => {
+    it('ready emits RENDER and button click emits FRAGMENT', () => {
+        const { socket, sent } = createSocket();
+        const runtime = createWebSocketHub({
+            title: 'Phase2',
+            callback: (ui) => {
+                const text = ui.text('before');
+                ui.button('go', () => {
+                    text.update('after');
+                });
+            },
+        });
+        runtime.addConnection(socket);
+        runtime.handleRawMessage(socket, JSON.stringify({
+            type: 'READY',
+            payload: { viewport: { width: 100, height: 100 }, theme: 'dark' },
+        }));
+        const render = byType(sent, 'RENDER')[0];
+        expect(render).toBeDefined();
+        expect(render?.payload.html).toContain('before');
+        const buttonId = render?.payload.html.match(/data-lk-id="(button-[^"]+)"/)?.[1];
+        expect(buttonId).toBeDefined();
+        runtime.handleRawMessage(socket, JSON.stringify({
+            type: 'EVENT',
+            payload: { id: buttonId, event: 'click' },
+        }));
+        const fragment = byType(sent, 'FRAGMENT').at(-1);
+        expect(fragment?.payload.html).toContain('after');
+    });
+    it('change EVENT updates input value and pushes FRAGMENT', () => {
+        const { socket, sent } = createSocket();
+        const runtime = createWebSocketHub({
+            title: 'Inputs',
+            callback: (ui) => {
+                ui.textInput('Prompt', { default: 'a' });
+            },
+        });
+        runtime.addConnection(socket);
+        runtime.handleRawMessage(socket, JSON.stringify({
+            type: 'READY',
+            payload: { viewport: { width: 100, height: 100 }, theme: null },
+        }));
+        const render = byType(sent, 'RENDER')[0];
+        const inputId = render.payload.html.match(/data-lk-id="(textInput-[^"]+)"/)?.[1];
+        expect(inputId).toBeDefined();
+        runtime.handleRawMessage(socket, JSON.stringify({
+            type: 'EVENT',
+            payload: { id: inputId, event: 'change', value: 'updated' },
+        }));
+        const fragment = byType(sent, 'FRAGMENT').at(-1);
+        expect(fragment?.payload.id).toBe(inputId);
+        expect(fragment?.payload.html).toContain('updated');
+    });
+    it('streamText append emits STREAM_CHUNK messages in order', () => {
+        const { socket, sent } = createSocket();
+        const runtime = createWebSocketHub({
+            title: 'Streaming',
+            callback: (ui) => {
+                const stream = ui.streamText({ format: 'plain' });
+                ui.button('go', () => {
+                    stream.append('a');
+                    stream.append('b');
+                    stream.done();
+                });
+            },
+        });
+        runtime.addConnection(socket);
+        runtime.handleRawMessage(socket, JSON.stringify({
+            type: 'READY',
+            payload: { viewport: { width: 100, height: 100 }, theme: null },
+        }));
+        const render = byType(sent, 'RENDER')[0];
+        const buttonId = render.payload.html.match(/data-lk-id="(button-[^"]+)"/)?.[1];
+        runtime.handleRawMessage(socket, JSON.stringify({
+            type: 'EVENT',
+            payload: { id: buttonId, event: 'click' },
+        }));
+        const chunks = byType(sent, 'STREAM_CHUNK');
+        expect(chunks).toHaveLength(3);
+        expect(chunks[0]?.payload.chunk).toBe('a');
+        expect(chunks[1]?.payload.chunk).toBe('b');
+        expect(chunks[2]?.payload.done).toBe(true);
+    });
+    it('table row click EVENT dispatches onRowClick handler', () => {
+        const { socket, sent } = createSocket();
+        const clicks = [];
+        const runtime = createWebSocketHub({
+            title: 'Table',
+            callback: (ui) => {
+                const table = ui.table([{ name: 'row-1' }], { columns: ['name'] });
+                table.onRowClick((row) => {
+                    clicks.push(String(row.name));
+                });
+            },
+        });
+        runtime.addConnection(socket);
+        runtime.handleRawMessage(socket, JSON.stringify({
+            type: 'READY',
+            payload: { viewport: { width: 120, height: 80 }, theme: null },
+        }));
+        const render = byType(sent, 'RENDER')[0];
+        const tableId = render.payload.html.match(/data-lk-id="(table-[^"]+)"/)?.[1];
+        const rowId = render.payload.html.match(/data-lk-table-row-id="([^"]+)"/)?.[1];
+        expect(tableId).toBeDefined();
+        expect(rowId).toBeDefined();
+        runtime.handleRawMessage(socket, JSON.stringify({
+            type: 'EVENT',
+            payload: { id: tableId, event: 'click', value: rowId },
+        }));
+        expect(clicks).toEqual(['row-1']);
+    });
+    it('tracks READY viewport/theme and handles THEME_CHANGE', () => {
+        const { socket, sent } = createSocket();
+        const runtime = createWebSocketHub({
+            title: 'Scope',
+            callback: (ui) => {
+                ui.text(`viewport-${ui.viewport.width}x${ui.viewport.height}-${ui.theme}`);
+            },
+        });
+        const scope = runtime.addConnection(socket);
+        runtime.handleRawMessage(socket, JSON.stringify({
+            type: 'READY',
+            payload: { viewport: { width: 10, height: 20 }, theme: 'dark' },
+        }));
+        expect(scope.viewport).toEqual({ width: 10, height: 20 });
+        expect(scope.theme).toBe('dark');
+        runtime.handleRawMessage(socket, JSON.stringify({
+            type: 'THEME_CHANGE',
+            payload: { mode: 'light' },
+        }));
+        const themeMsg = byType(sent, 'THEME').at(-1);
+        expect(themeMsg?.payload.mode).toBe('light');
+    });
+    it('numberInput and toggle change EVENT update values and emit FRAGMENT', () => {
+        const { socket, sent } = createSocket();
+        const runtime = createWebSocketHub({
+            title: 'More inputs',
+            callback: (ui) => {
+                ui.numberInput('N', { default: 1 });
+                ui.toggle('T', { default: false });
+            },
+        });
+        runtime.addConnection(socket);
+        runtime.handleRawMessage(socket, JSON.stringify({
+            type: 'READY',
+            payload: { viewport: { width: 100, height: 100 }, theme: null },
+        }));
+        const render = byType(sent, 'RENDER')[0];
+        const numId = render.payload.html.match(/data-lk-id="(numberInput-[^"]+)"/)?.[1];
+        const toggleId = render.payload.html.match(/data-lk-id="(toggle-[^"]+)"/)?.[1];
+        expect(numId).toBeDefined();
+        expect(toggleId).toBeDefined();
+        runtime.handleRawMessage(socket, JSON.stringify({
+            type: 'EVENT',
+            payload: { id: numId, event: 'change', value: 42 },
+        }));
+        const fragNum = byType(sent, 'FRAGMENT').at(-1);
+        expect(fragNum?.payload.id).toBe(numId);
+        expect(fragNum?.payload.html).toContain('value="42"');
+        runtime.handleRawMessage(socket, JSON.stringify({
+            type: 'EVENT',
+            payload: { id: toggleId, event: 'change', value: true },
+        }));
+        const fragToggle = byType(sent, 'FRAGMENT').at(-1);
+        expect(fragToggle?.payload.id).toBe(toggleId);
+        expect(fragToggle?.payload.html).toContain('checked');
+    });
+    it('cross-region: sidebar button updates header metric via shared scope', () => {
+        const { socket, sent } = createSocket();
+        const runtime = createWebSocketHub({
+            title: 'Shell',
+            callback: (ui) => {
+                let metric;
+                ui.shell({
+                    header: (h) => {
+                        metric = h.metric('Count', '0');
+                    },
+                    main: () => { },
+                    sidebar: (s) => {
+                        s.button('inc', () => {
+                            metric?.update('1');
+                        });
+                    },
+                });
+            },
+        });
+        runtime.addConnection(socket);
+        runtime.handleRawMessage(socket, JSON.stringify({
+            type: 'READY',
+            payload: { viewport: { width: 200, height: 200 }, theme: null },
+        }));
+        const render = byType(sent, 'RENDER')[0];
+        const buttonId = render.payload.html.match(/data-lk-id="(button-[^"]+)"/)?.[1];
+        expect(buttonId).toBeDefined();
+        expect(render.payload.html).toContain('lk-metric-value');
+        runtime.handleRawMessage(socket, JSON.stringify({
+            type: 'EVENT',
+            payload: { id: buttonId, event: 'click' },
+        }));
+        const lastMetricFrag = [...byType(sent, 'FRAGMENT')]
+            .filter((f) => f.payload.html.includes('lk-metric'))
+            .at(-1);
+        expect(lastMetricFrag?.payload.html).toContain('1');
+    });
+    it('keeps scopes isolated across connections', () => {
+        const a = createSocket();
+        const b = createSocket();
+        const runtime = createWebSocketHub({
+            title: 'Isolation',
+            callback: (ui) => {
+                ui.text(`scope-${ui.scope.id}`);
+            },
+        });
+        const scopeA = runtime.addConnection(a.socket);
+        const scopeB = runtime.addConnection(b.socket);
+        runtime.handleRawMessage(a.socket, JSON.stringify({
+            type: 'READY',
+            payload: { viewport: { width: 10, height: 10 }, theme: null },
+        }));
+        runtime.handleRawMessage(b.socket, JSON.stringify({
+            type: 'READY',
+            payload: { viewport: { width: 20, height: 20 }, theme: null },
+        }));
+        const aRender = byType(a.sent, 'RENDER')[0];
+        const bRender = byType(b.sent, 'RENDER')[0];
+        expect(aRender.payload.html).toContain(`scope-${scopeA.id}`);
+        expect(bRender.payload.html).toContain(`scope-${scopeB.id}`);
+        expect(scopeA.id).not.toBe(scopeB.id);
+    });
+});
+//# sourceMappingURL=ws-flow.integration.test.js.map

package/dist/__tests__/integration/ws-flow.integration.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ws-flow.integration.test.js","sourceRoot":"","sources":["../../../src/__tests__/integration/ws-flow.integration.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAE5D,SAAS,YAAY;IACnB,MAAM,IAAI,GAAa,EAAE,CAAC;IAC1B,OAAO;QACL,MAAM,EAAE;YACN,IAAI,CAAC,IAAY;gBACf,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAClB,CAAC;SACF;QACD,IAAI;KACL,CAAC;AACJ,CAAC;AAED,SAAS,MAAM,CAA8B,IAAc,EAAE,IAAY;IACvE,OAAO,IAAI;SACR,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;SAC/B,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,KAAK,IAAI,CAAQ,CAAC;AAC/C,CAAC;AAED,QAAQ,CAAC,4BAA4B,EAAE,GAAG,EAAE;IAC1C,EAAE,CAAC,oDAAoD,EAAE,GAAG,EAAE;QAC5D,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,YAAY,EAAE,CAAC;QACxC,MAAM,OAAO,GAAG,kBAAkB,CAAC;YACjC,KAAK,EAAE,QAAQ;YACf,QAAQ,EAAE,CAAC,EAAE,EAAE,EAAE;gBACf,MAAM,IAAI,GAAG,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;gBAC/B,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,EAAE;oBACnB,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;gBACvB,CAAC,CAAC,CAAC;YACL,CAAC;SACF,CAAC,CAAC;QAEH,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;QAC9B,OAAO,CAAC,gBAAgB,CACtB,MAAM,EACN,IAAI,CAAC,SAAS,CAAC;YACb,IAAI,EAAE,OAAO;YACb,OAAO,EAAE,EAAE,QAAQ,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE;SAClE,CAAC,CACH,CAAC;QAEF,MAAM,MAAM,GAAG,MAAM,CAAgD,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;QACxF,MAAM,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;QAC7B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QAEjD,MAAM,QAAQ,GAAG,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,6BAA6B,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QAChF,MAAM,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC;QAC/B,OAAO,CAAC,gBAAgB,CACtB,MAAM,EACN,IAAI,CAAC,SAAS,CAAC;YACb,IAAI,EAAE,OAAO;YACb,OAAO,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE;SAC1C,CAAC,CACH,CAAC;QAEF,MAAM,QAAQ,GAAG,MAAM,CAAkD,IAAI,EAAE,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QAClG,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IACpD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sDAAsD,EAAE,GAAG,EAAE;QAC9D,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,YAAY,EAAE,CAAC;QACxC,MAAM,OAAO,GAAG,kBAAkB,CAAC;YACjC,KAAK,EAAE,QAAQ;YACf,QAAQ,EAAE,CAAC,EAAE,EAAE,EAAE;gBACf,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC;YAC3C,CAAC;SACF,CAAC,CAAC;QAEH,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;QAC9B,OAAO,CAAC,gBAAgB,CACtB,MAAM,EACN,IAAI,CAAC,SAAS,CAAC;YACb,IAAI,EAAE,OAAO;YACb,OAAO,EAAE,EAAE,QAAQ,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE;SAChE,CAAC,CACH,CAAC;QAEF,MAAM,MAAM,GAAG,MAAM,CAAgC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;QACxE,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,gCAAgC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QACjF,MAAM,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC;QAE9B,OAAO,CAAC,gBAAgB,CACtB,MAAM,EACN,IAAI,CAAC,SAAS,CAAC;YACb,IAAI,EAAE,OAAO;YACb,OAAO,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE;SAC5D,CAAC,CACH,CAAC;QAEF,MAAM,QAAQ,GAAG,MAAM,CAA4C,IAAI,EAAE,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QAC5F,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC3C,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;IACtD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wDAAwD,EAAE,GAAG,EAAE;QAChE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,YAAY,EAAE,CAAC;QACxC,MAAM,OAAO,GAAG,kBAAkB,CAAC;YACjC,KAAK,EAAE,WAAW;YAClB,QAAQ,EAAE,CAAC,EAAE,EAAE,EAAE;gBACf,MAAM,MAAM,GAAG,EAAE,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;gBAClD,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,EAAE;oBACnB,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;oBACnB,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;oBACnB,MAAM,CAAC,IAAI,EAAE,CAAC;gBAChB,CAAC,CAAC,CAAC;YACL,CAAC;SACF,CAAC,CAAC;QAEH,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;QAC9B,OAAO,CAAC,gBAAgB,CACtB,MAAM,EACN,IAAI,CAAC,SAAS,CAAC;YACb,IAAI,EAAE,OAAO;YACb,OAAO,EAAE,EAAE,QAAQ,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE;SAChE,CAAC,CACH,CAAC;QACF,MAAM,MAAM,GAAG,MAAM,CAAgC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;QACxE,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,6BAA6B,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QAE/E,OAAO,CAAC,gBAAgB,CACtB,MAAM,EACN,IAAI,CAAC,SAAS,CAAC;YACb,IAAI,EAAE,OAAO;YACb,OAAO,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE;SAC1C,CAAC,CACH,CAAC;QAEF,MAAM,MAAM,GAAG,MAAM,CAAgD,IAAI,EAAE,cAAc,CAAC,CAAC;QAC3F,MAAM,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAC/B,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC3C,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC3C,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qDAAqD,EAAE,GAAG,EAAE;QAC7D,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,YAAY,EAAE,CAAC;QACxC,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,MAAM,OAAO,GAAG,kBAAkB,CAAC;YACjC,KAAK,EAAE,OAAO;YACd,QAAQ,EAAE,CAAC,EAAE,EAAE,EAAE;gBACf,MAAM,KAAK,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,EAAE,OAAO,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;gBACnE,KAAK,CAAC,UAAU,CAAC,CAAC,GAAG,EAAE,EAAE;oBACvB,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;gBAChC,CAAC,CAAC,CAAC;YACL,CAAC;SACF,CAAC,CAAC;QAEH,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;QAC9B,OAAO,CAAC,gBAAgB,CACtB,MAAM,EACN,IAAI,CAAC,SAAS,CAAC;YACb,IAAI,EAAE,OAAO;YACb,OAAO,EAAE,EAAE,QAAQ,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE;SAC/D,CAAC,CACH,CAAC;QAEF,MAAM,MAAM,GAAG,MAAM,CAAgC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;QACxE,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,4BAA4B,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QAC7E,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,gCAAgC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QAC/E,MAAM,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC;QAC9B,MAAM,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;QAE5B,OAAO,CAAC,gBAAgB,CACtB,MAAM,EACN,IAAI,CAAC,SAAS,CAAC;YACb,IAAI,EAAE,OAAO;YACb,OAAO,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE;SACvD,CAAC,CACH,CAAC;QAEF,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sDAAsD,EAAE,GAAG,EAAE;QAC9D,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,YAAY,EAAE,CAAC;QACxC,MAAM,OAAO,GAAG,kBAAkB,CAAC;YACjC,KAAK,EAAE,OAAO;YACd,QAAQ,EAAE,CAAC,EAAE,EAAE,EAAE;gBACf,EAAE,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC,QAAQ,CAAC,KAAK,IAAI,EAAE,CAAC,QAAQ,CAAC,MAAM,IAAI,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC;YAC7E,CAAC;SACF,CAAC,CAAC;QAEH,MAAM,KAAK,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;QAC5C,OAAO,CAAC,gBAAgB,CACtB,MAAM,EACN,IAAI,CAAC,SAAS,CAAC;YACb,IAAI,EAAE,OAAO;YACb,OAAO,EAAE,EAAE,QAAQ,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE;SAChE,CAAC,CACH,CAAC;QACF,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC;QAC1D,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAEjC,OAAO,CAAC,gBAAgB,CACtB,MAAM,EACN,IAAI,CAAC,SAAS,CAAC;YACb,IAAI,EAAE,cAAc;YACpB,OAAO,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE;SAC3B,CAAC,CACH,CAAC;QAEF,MAAM,QAAQ,GAAG,MAAM,CAAgC,IAAI,EAAE,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QAC7E,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qEAAqE,EAAE,GAAG,EAAE;QAC7E,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,YAAY,EAAE,CAAC;QACxC,MAAM,OAAO,GAAG,kBAAkB,CAAC;YACjC,KAAK,EAAE,aAAa;YACpB,QAAQ,EAAE,CAAC,EAAE,EAAE,EAAE;gBACf,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC;gBACpC,EAAE,CAAC,MAAM,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;YACrC,CAAC;SACF,CAAC,CAAC;QAEH,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;QAC9B,OAAO,CAAC,gBAAgB,CACtB,MAAM,EACN,IAAI,CAAC,SAAS,CAAC;YACb,IAAI,EAAE,OAAO;YACb,OAAO,EAAE,EAAE,QAAQ,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE;SAChE,CAAC,CACH,CAAC;QAEF,MAAM,MAAM,GAAG,MAAM,CAAgC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;QACxE,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,kCAAkC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QACjF,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,6BAA6B,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QAC/E,MAAM,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;QAC5B,MAAM,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC;QAE/B,OAAO,CAAC,gBAAgB,CACtB,MAAM,EACN,IAAI,CAAC,SAAS,CAAC;YACb,IAAI,EAAE,OAAO;YACb,OAAO,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,EAAE;SACnD,CAAC,CACH,CAAC;QACF,MAAM,OAAO,GAAG,MAAM,CAA4C,IAAI,EAAE,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QAC3F,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACxC,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;QAEtD,OAAO,CAAC,gBAAgB,CACtB,MAAM,EACN,IAAI,CAAC,SAAS,CAAC;YACb,IAAI,EAAE,OAAO;YACb,OAAO,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE;SACxD,CAAC,CACH,CAAC;QACF,MAAM,UAAU,GAAG,MAAM,CAA4C,IAAI,EAAE,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QAC9F,MAAM,CAAC,UAAU,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC9C,MAAM,CAAC,UAAU,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;IACxD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qEAAqE,EAAE,GAAG,EAAE;QAC7E,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,YAAY,EAAE,CAAC;QACxC,MAAM,OAAO,GAAG,kBAAkB,CAAC;YACjC,KAAK,EAAE,OAAO;YACd,QAAQ,EAAE,CAAC,EAAE,EAAE,EAAE;gBACf,IAAI,MAAgD,CAAC;gBACrD,EAAE,CAAC,KAAK,CAAC;oBACP,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE;wBACZ,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;oBAClC,CAAC;oBACD,IAAI,EAAE,GAAG,EAAE,GAAE,CAAC;oBACd,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE;wBACb,CAAC,CAAC,MAAM,CAAC,KAAK,EAAE,GAAG,EAAE;4BACnB,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;wBACtB,CAAC,CAAC,CAAC;oBACL,CAAC;iBACF,CAAC,CAAC;YACL,CAAC;SACF,CAAC,CAAC;QAEH,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;QAC9B,OAAO,CAAC,gBAAgB,CACtB,MAAM,EACN,IAAI,CAAC,SAAS,CAAC;YACb,IAAI,EAAE,OAAO;YACb,OAAO,EAAE,EAAE,QAAQ,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE;SAChE,CAAC,CACH,CAAC;QAEF,MAAM,MAAM,GAAG,MAAM,CAAgC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;QACxE,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,6BAA6B,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QAC/E,MAAM,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC;QAC/B,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,iBAAiB,CAAC,CAAC;QAEzD,OAAO,CAAC,gBAAgB,CACtB,MAAM,EACN,IAAI,CAAC,SAAS,CAAC;YACb,IAAI,EAAE,OAAO;YACb,OAAO,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE;SAC1C,CAAC,CACH,CAAC;QAEF,MAAM,cAAc,GAAG,CAAC,GAAG,MAAM,CAAgC,IAAI,EAAE,UAAU,CAAC,CAAC;aAChF,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;aACnD,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QACV,MAAM,CAAC,cAAc,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IACtD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0CAA0C,EAAE,GAAG,EAAE;QAClD,MAAM,CAAC,GAAG,YAAY,EAAE,CAAC;QACzB,MAAM,CAAC,GAAG,YAAY,EAAE,CAAC;QACzB,MAAM,OAAO,GAAG,kBAAkB,CAAC;YACjC,KAAK,EAAE,WAAW;YAClB,QAAQ,EAAE,CAAC,EAAE,EAAE,EAAE;gBACf,EAAE,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;YAClC,CAAC;SACF,CAAC,CAAC;QAEH,MAAM,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;QAC/C,MAAM,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;QAC/C,OAAO,CAAC,gBAAgB,CACtB,CAAC,CAAC,MAAM,EACR,IAAI,CAAC,SAAS,CAAC;YACb,IAAI,EAAE,OAAO;YACb,OAAO,EAAE,EAAE,QAAQ,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE;SAC9D,CAAC,CACH,CAAC;QACF,OAAO,CAAC,gBAAgB,CACtB,CAAC,CAAC,MAAM,EACR,IAAI,CAAC,SAAS,CAAC;YACb,IAAI,EAAE,OAAO;YACb,OAAO,EAAE,EAAE,QAAQ,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE;SAC9D,CAAC,CACH,CAAC;QAEF,MAAM,OAAO,GAAG,MAAM,CAAgC,CAAC,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;QAC3E,MAAM,OAAO,GAAG,MAAM,CAAgC,CAAC,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;QAC3E,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,SAAS,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC;QAC7D,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,SAAS,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC;QAC7D,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/__tests__/integration/ws-flow.test.d.ts

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

package/dist/__tests__/integration/ws-flow.test.js

@@ -0,0 +1,70 @@
+import { describe, expect, it } from 'vitest';
+import { createWebSocketHub } from '../../engine/websocket';
+function createSocket() {
+    const sent = [];
+    return {
+        socket: {
+            send(data) {
+                sent.push(data);
+            },
+        },
+        sent,
+    };
+}
+describe('websocket integration flow', () => {
+    it('rEADY emits RENDER and click EVENT emits FRAGMENT', async () => {
+        const { socket, sent } = createSocket();
+        const runtime = createWebSocketHub({
+            title: 'Phase1',
+            callback: (ui) => {
+                const text = ui.text('before');
+                ui.button('go', () => {
+                    text.update('after');
+                });
+            },
+        });
+        runtime.addConnection(socket);
+        runtime.handleRawMessage(socket, JSON.stringify({
+            type: 'READY',
+            payload: { viewport: { width: 100, height: 100 }, theme: null },
+        }));
+        const renderRaw = sent.find((item) => JSON.parse(item).type === 'RENDER');
+        expect(renderRaw).toBeDefined();
+        const render = JSON.parse(renderRaw ?? '{}');
+        expect(render.payload.html).toContain('before');
+        const buttonId = render.payload.html.match(/data-lk-id="(button-[^"]+)"/)?.[1];
+        runtime.handleRawMessage(socket, JSON.stringify({
+            type: 'EVENT',
+            payload: { id: buttonId, event: 'click' },
+        }));
+        const fragmentRaw = sent.find((item) => JSON.parse(item).type === 'FRAGMENT');
+        expect(fragmentRaw).toBeDefined();
+        const fragment = JSON.parse(fragmentRaw ?? '{}');
+        expect(fragment.payload.html).toContain('after');
+    });
+    it('two connections render independently', () => {
+        const a = createSocket();
+        const b = createSocket();
+        const runtime = createWebSocketHub({
+            title: 'Scope',
+            callback: (ui) => {
+                ui.text(`scope-${ui.scope.id}`);
+            },
+        });
+        const scopeA = runtime.addConnection(a.socket);
+        const scopeB = runtime.addConnection(b.socket);
+        runtime.handleRawMessage(a.socket, JSON.stringify({
+            type: 'READY',
+            payload: { viewport: { width: 10, height: 10 }, theme: null },
+        }));
+        runtime.handleRawMessage(b.socket, JSON.stringify({
+            type: 'READY',
+            payload: { viewport: { width: 10, height: 10 }, theme: null },
+        }));
+        const aRender = JSON.parse(a.sent.find((item) => JSON.parse(item).type === 'RENDER') ?? '{}');
+        const bRender = JSON.parse(b.sent.find((item) => JSON.parse(item).type === 'RENDER') ?? '{}');
+        expect(aRender.payload.html).toContain(`scope-${scopeA.id}`);
+        expect(bRender.payload.html).toContain(`scope-${scopeB.id}`);
+    });
+});
+//# sourceMappingURL=ws-flow.test.js.map

package/dist/__tests__/integration/ws-flow.test.js.map

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

package/dist/client/events.d.ts

@@ -0,0 +1,6 @@
+import type { ClientToServerMessage } from '../engine/messages';
+export interface EventChannel {
+    send: (message: ClientToServerMessage) => void;
+}
+export declare function bindEventDelegation(root: Document, channel: EventChannel): void;
+export declare function bindThemeToggle(root: Document, channel: EventChannel): void;

package/dist/client/events.js

@@ -0,0 +1,114 @@
+function coerceValue(target) {
+    if (!(target instanceof HTMLElement))
+        return undefined;
+    if (target instanceof HTMLInputElement) {
+        if (target.type === 'checkbox')
+            return target.checked;
+        if (target.type === 'number' || target.type === 'range')
+            return Number(target.value);
+        return target.value;
+    }
+    if (target instanceof HTMLSelectElement || target instanceof HTMLTextAreaElement) {
+        return target.value;
+    }
+    return undefined;
+}
+function resolveComponentId(target) {
+    if (!(target instanceof Element))
+        return null;
+    const holder = target.closest('[data-lk-id]');
+    return holder?.dataset.lkId ?? null;
+}
+export function bindEventDelegation(root, channel) {
+    root.addEventListener('click', (event) => {
+        if (!(event.target instanceof Element))
+            return;
+        const clickable = event.target.closest('[data-lk-event="click"]');
+        if (!clickable)
+            return;
+        const id = resolveComponentId(clickable);
+        if (!id)
+            return;
+        channel.send({ type: 'EVENT', payload: { id, event: 'click' } });
+    });
+    root.addEventListener('click', (event) => {
+        if (!(event.target instanceof Element))
+            return;
+        const tableRow = event.target.closest('[data-lk-table-row-id]');
+        if (!tableRow)
+            return;
+        const table = tableRow.closest('[data-lk-id][data-lk-kind="table"]');
+        const id = table?.dataset.lkId;
+        const rowId = tableRow.dataset.lkTableRowId;
+        if (!id || !rowId)
+            return;
+        channel.send({ type: 'EVENT', payload: { id, event: 'click', value: rowId } });
+    });
+    root.addEventListener('change', (event) => {
+        if (!(event.target instanceof Element))
+            return;
+        const changeable = event.target.closest('[data-lk-event="change"]');
+        if (!changeable)
+            return;
+        const id = resolveComponentId(changeable);
+        if (!id)
+            return;
+        channel.send({
+            type: 'EVENT',
+            payload: { id, event: 'change', value: coerceValue(event.target) },
+        });
+    });
+    root.addEventListener('change', async (event) => {
+        if (!(event.target instanceof HTMLInputElement))
+            return;
+        if (event.target.type !== 'file')
+            return;
+        const holder = event.target.closest('[data-lk-id][data-lk-kind="fileUpload"]');
+        const id = holder?.dataset.lkId;
+        if (!id)
+            return;
+        const files = event.target.files ? Array.from(event.target.files) : [];
+        if (files.length === 0) {
+            channel.send({ type: 'EVENT', payload: { id, event: 'change', value: null } });
+            return;
+        }
+        const formData = new FormData();
+        for (const file of files) {
+            formData.append('file', file, file.name);
+        }
+        try {
+            const connectionId = String(window.localStorage.getItem('lk-connection-id') ?? '');
+            const search = connectionId ? `?connectionId=${encodeURIComponent(connectionId)}` : '';
+            const response = await fetch(`/upload${search}`, { method: 'POST', body: formData });
+            if (!response.ok) {
+                return;
+            }
+            const payload = await response.json();
+            const uploaded = Array.isArray(payload)
+                ? payload
+                : payload.file;
+            channel.send({
+                type: 'EVENT',
+                payload: {
+                    id,
+                    event: 'change',
+                    value: uploaded ?? null,
+                },
+            });
+        }
+        catch {
+            // best effort
+        }
+    });
+}
+export function bindThemeToggle(root, channel) {
+    const toggle = root.getElementById('lk-theme-toggle');
+    if (!toggle)
+        return;
+    toggle.addEventListener('click', () => {
+        const current = root.documentElement.getAttribute('data-theme') === 'dark' ? 'dark' : 'light';
+        const mode = current === 'dark' ? 'light' : 'dark';
+        channel.send({ type: 'THEME_CHANGE', payload: { mode } });
+    });
+}
+//# sourceMappingURL=events.js.map

package/dist/client/events.js.map

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

package/dist/client/index.d.ts

@@ -0,0 +1,2 @@
+import { createWSManager } from './ws';
+export { createWSManager };

package/dist/client/index.js

@@ -0,0 +1,5 @@
+import { createWSManager } from './ws';
+const manager = createWSManager();
+manager.connect();
+export { createWSManager };
+//# sourceMappingURL=index.js.map

package/dist/client/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,MAAM,CAAC;AAEvC,MAAM,OAAO,GAAG,eAAe,EAAE,CAAC;AAClC,OAAO,CAAC,OAAO,EAAE,CAAC;AAElB,OAAO,EAAE,eAAe,EAAE,CAAC"}

package/dist/client/swap.d.ts

@@ -0,0 +1,4 @@
+import type { RenderMessage } from '../engine/messages';
+export declare function applyRender(payload: RenderMessage['payload']): void;
+export declare function applyFragmentSwap(id: string, html: string): void;
+export declare function applyStreamChunk(id: string, chunk: string, done: boolean, format: 'plain' | 'markdown'): void;

package/dist/client/swap.js

@@ -0,0 +1,47 @@
+export function applyRender(payload) {
+    const root = document.getElementById('lk-root');
+    if (!root) {
+        return;
+    }
+    root.innerHTML = payload.html;
+    document.title = payload.title;
+    document.documentElement.setAttribute('data-theme', payload.theme);
+}
+export function applyFragmentSwap(id, html) {
+    const target = document.querySelector(`[data-lk-id="${id}"]`);
+    if (!target) {
+        return;
+    }
+    target.outerHTML = html;
+}
+function markdownToHtml(input) {
+    const escaped = input
+        .replaceAll('&', '&')
+        .replaceAll('<', '&lt;')
+        .replaceAll('>', '&gt;');
+    return escaped.replaceAll('\n', '<br />');
+}
+export function applyStreamChunk(id, chunk, done, format) {
+    const container = document.querySelector(`[data-lk-id="${id}"]`);
+    if (!container) {
+        return;
+    }
+    const body = container.querySelector('[data-lk-stream-body]');
+    if (!body) {
+        return;
+    }
+    const current = body.dataset.lkText ?? '';
+    const next = `${current}${chunk}`;
+    body.dataset.lkText = next;
+    if (format === 'markdown') {
+        body.innerHTML = markdownToHtml(next);
+    }
+    else {
+        body.textContent = next;
+    }
+    const cursor = container.querySelector('[data-lk-stream-cursor]');
+    if (cursor) {
+        cursor.style.display = done ? 'none' : '';
+    }
+}
+//# sourceMappingURL=swap.js.map

package/dist/client/swap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"swap.js","sourceRoot":"","sources":["../../src/client/swap.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,WAAW,CAAC,OAAiC;IAC3D,MAAM,IAAI,GAAG,QAAQ,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC;IAChD,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO;IACT,CAAC;IACD,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAC9B,QAAQ,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;IAC/B,QAAQ,CAAC,eAAe,CAAC,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;AACrE,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,EAAU,EAAE,IAAY;IACxD,MAAM,MAAM,GAAG,QAAQ,CAAC,aAAa,CAAc,gBAAgB,EAAE,IAAI,CAAC,CAAC;IAC3E,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO;IACT,CAAC;IACD,MAAM,CAAC,SAAS,GAAG,IAAI,CAAC;AAC1B,CAAC;AAED,SAAS,cAAc,CAAC,KAAa;IACnC,MAAM,OAAO,GAAG,KAAK;SAClB,UAAU,CAAC,GAAG,EAAE,OAAO,CAAC;SACxB,UAAU,CAAC,GAAG,EAAE,MAAM,CAAC;SACvB,UAAU,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IAC3B,OAAO,OAAO,CAAC,UAAU,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,EAAU,EACV,KAAa,EACb,IAAa,EACb,MAA4B;IAE5B,MAAM,SAAS,GAAG,QAAQ,CAAC,aAAa,CAAc,gBAAgB,EAAE,IAAI,CAAC,CAAC;IAC9E,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,OAAO;IACT,CAAC;IACD,MAAM,IAAI,GAAG,SAAS,CAAC,aAAa,CAAc,uBAAuB,CAAC,CAAC;IAC3E,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO;IACT,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,IAAI,EAAE,CAAC;IAC1C,MAAM,IAAI,GAAG,GAAG,OAAO,GAAG,KAAK,EAAE,CAAC;IAClC,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAC3B,IAAI,MAAM,KAAK,UAAU,EAAE,CAAC;QAC1B,IAAI,CAAC,SAAS,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;IACxC,CAAC;SAAM,CAAC;QACN,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;IAC1B,CAAC;IAED,MAAM,MAAM,GAAG,SAAS,CAAC,aAAa,CAAc,yBAAyB,CAAC,CAAC;IAC/E,IAAI,MAAM,EAAE,CAAC;QACX,MAAM,CAAC,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;IAC5C,CAAC;AACH,CAAC"}

package/dist/client/ws.d.ts

@@ -0,0 +1,11 @@
+export interface WSManagerOptions {
+    wsFactory?: (url: string) => WebSocket;
+    url?: string;
+    maxRetries?: number;
+    initialDelayMs?: number;
+}
+export interface WSManager {
+    connect(): void;
+    disconnect(): void;
+}
+export declare function createWSManager(opts?: WSManagerOptions): WSManager;