@ketvietlab/ketjs-view 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ketviet
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,18 @@
+# KetJS View
+
+The browser-safe view layer used by KetJS: signals, surgical DOM updates, SSR, hydration, JSX
+runtime support, and persistent islands. It has no runtime dependencies.
+
+> KetJS View 0.x is preview software. APIs may change before 1.0.
+
+```bash
+npm install @ketvietlab/ketjs-view
+```
+
+```ts
+import { html, signal, createIslandManager } from '@ketvietlab/ketjs-view'
+```
+
+JSX projects can use `@ketvietlab/ketjs-view/jsx-runtime` through TypeScript's automatic JSX runtime.
+
+Documentation and source: [github.com/ketvietlab/ketjs](https://github.com/ketvietlab/ketjs)

package/dist/host.d.ts

@@ -0,0 +1,45 @@
+export type HostNode = {
+    id: number;
+    tag?: string;
+    attrs?: Record<string, string>;
+    children?: HostNode[];
+    text?: string;
+    /** Trusted markup in the counting host; real DOM hosts materialise actual nodes. */
+    rawHtml?: string;
+    parent: HostNode | null;
+};
+export type Host = {
+    ops: Record<string, number> | null;
+    createElement(tag: string): HostNode;
+    createText(value: unknown): HostNode;
+    setText(node: HostNode, value: unknown): void;
+    setAttribute(node: HostNode, name: string, value: unknown): void;
+    insert(parent: HostNode, node: HostNode, before?: HostNode | null): void;
+    /** Parse compiler-trusted markup and insert every resulting node. */
+    insertMarkup(parent: HostNode, html: string, before?: HostNode | null): HostNode[];
+    move(parent: HostNode, node: HostNode, before?: HostNode | null): void;
+    remove(node: HostNode): void;
+    /** Attach a listener; returns the detach function. */
+    listen(node: HostNode, event: string, handler: (e: unknown) => void): () => void;
+};
+export declare const escapeHtml: (s: unknown) => string;
+export type CountingHost = Host & {
+    ops: Record<string, number>;
+    fire(node: HostNode, event: string, payload?: unknown): void;
+    reset(): void;
+    text(node: HostNode): string;
+    html(node: HostNode): string;
+    root(): HostNode;
+};
+export declare function countingHost(): CountingHost;
+type DomLike = {
+    createElement(tag: string): unknown;
+    createTextNode(data: string): unknown;
+    /** Test hosts may supply their small parser instead of implementing <template>. */
+    parseHTML?(html: string): {
+        childNodes: Iterable<unknown>;
+    };
+};
+export declare function domHost(doc?: DomLike): Host;
+export {};
+//# sourceMappingURL=host.d.ts.map

package/dist/host.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host.d.ts","sourceRoot":"","sources":["../../../../packages/ketjs-view/src/host.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,QAAQ,GAAG;IACrB,EAAE,EAAE,MAAM,CAAA;IACV,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC9B,QAAQ,CAAC,EAAE,QAAQ,EAAE,CAAA;IACrB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,oFAAoF;IACpF,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,QAAQ,GAAG,IAAI,CAAA;CACxB,CAAA;AAED,MAAM,MAAM,IAAI,GAAG;IACjB,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAA;IAClC,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ,CAAA;IACpC,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,QAAQ,CAAA;IACpC,OAAO,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAAA;IAC7C,YAAY,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAAA;IAChE,MAAM,CAAC,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,QAAQ,GAAG,IAAI,GAAG,IAAI,CAAA;IACxE,qEAAqE;IACrE,YAAY,CAAC,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,QAAQ,GAAG,IAAI,GAAG,QAAQ,EAAE,CAAA;IAClF,IAAI,CAAC,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,QAAQ,GAAG,IAAI,GAAG,IAAI,CAAA;IACtE,MAAM,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI,CAAA;IAC5B,sDAAsD;IACtD,MAAM,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK,IAAI,GAAG,MAAM,IAAI,CAAA;CACjF,CAAA;AAYD,eAAO,MAAM,UAAU,MAAO,OAAO,KAAG,MAKvC,CAAA;AAED,MAAM,MAAM,YAAY,GAAG,IAAI,GAAG;IAChC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC3B,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI,CAAA;IAC5D,KAAK,IAAI,IAAI,CAAA;IACb,IAAI,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAAA;IAC5B,IAAI,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAAA;IAC5B,IAAI,IAAI,QAAQ,CAAA;CACjB,CAAA;AAED,wBAAgB,YAAY,IAAI,YAAY,CAuG3C;AAID,KAAK,OAAO,GAAG;IACb,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;IACnC,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAA;IACrC,mFAAmF;IACnF,SAAS,CAAC,CAAC,IAAI,EAAE,MAAM,GAAG;QAAE,UAAU,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAA;KAAE,CAAA;CAC5D,CAAA;AAED,wBAAgB,OAAO,CAAC,GAAG,GAAE,OAAoE,GAAG,IAAI,CAuDvG"}

package/dist/host.js

@@ -0,0 +1,177 @@
+// Rendering targets an abstract host, so one renderer drives a real DOM in the
+// browser, a string builder on the server, and a counting mock in tests.
+// The counting mock is how "surgical update" stops being a claim and becomes a number.
+const ESCAPES = {
+    '&': '&',
+    '<': '&lt;',
+    '>': '&gt;',
+    '"': '&quot;',
+    "'": '&#39;',
+};
+const NEEDS_ESCAPE = /[&<>"']/;
+const ESCAPE_ALL = /[&<>"']/g;
+export const escapeHtml = (s) => {
+    const str = String(s);
+    // Most interpolated values contain nothing to escape, and testing is far cheaper
+    // than replacing. The lookup table is hoisted; it used to be rebuilt per character.
+    return NEEDS_ESCAPE.test(str) ? str.replace(ESCAPE_ALL, (c) => ESCAPES[c]) : str;
+};
+export function countingHost() {
+    let id = 0;
+    const ops = {
+        createElement: 0,
+        createText: 0,
+        setText: 0,
+        setAttribute: 0,
+        insert: 0,
+        remove: 0,
+        move: 0,
+        listen: 0,
+    };
+    const listeners = new Map();
+    const detach = (node) => {
+        if (!node.parent)
+            return;
+        const sibs = node.parent.children;
+        const i = sibs.indexOf(node);
+        if (i >= 0)
+            sibs.splice(i, 1);
+        node.parent = null;
+    };
+    const place = (parent, node, before) => {
+        detach(node);
+        const sibs = (parent.children ??= []);
+        const idx = before ? sibs.indexOf(before) : -1;
+        if (idx >= 0)
+            sibs.splice(idx, 0, node);
+        else
+            sibs.push(node);
+        node.parent = parent;
+    };
+    const host = {
+        ops,
+        reset() {
+            for (const k of Object.keys(ops))
+                ops[k] = 0;
+        },
+        root() {
+            return { id: -1, tag: '#root', attrs: {}, children: [], parent: null };
+        },
+        createElement(tag) {
+            ops.createElement++;
+            return { id: id++, tag, attrs: {}, children: [], parent: null };
+        },
+        createText(value) {
+            ops.createText++;
+            return { id: id++, text: String(value), parent: null };
+        },
+        setText(node, value) {
+            ops.setText++;
+            node.text = String(value);
+        },
+        setAttribute(node, name, value) {
+            ops.setAttribute++;
+            const attrs = (node.attrs ??= {});
+            if (value == null || value === false)
+                delete attrs[name];
+            else
+                attrs[name] = String(value);
+        },
+        listen(node, event, handler) {
+            ops.listen++;
+            const byEvent = listeners.get(node) ?? new Map();
+            listeners.set(node, byEvent);
+            const set = byEvent.get(event) ?? new Set();
+            byEvent.set(event, set);
+            set.add(handler);
+            return () => {
+                set.delete(handler);
+            };
+        },
+        fire(node, event, payload) {
+            for (const fn of listeners.get(node)?.get(event) ?? [])
+                fn(payload ?? { type: event });
+        },
+        insert(parent, node, before = null) {
+            ops.insert++;
+            place(parent, node, before);
+        },
+        insertMarkup(parent, html, before = null) {
+            const node = { id: id++, rawHtml: html, parent: null };
+            ops.createElement++;
+            ops.insert++;
+            place(parent, node, before);
+            return [node];
+        },
+        move(parent, node, before = null) {
+            ops.move++;
+            place(parent, node, before);
+        },
+        remove(node) {
+            ops.remove++;
+            detach(node);
+        },
+        text(node) {
+            if (node.rawHtml != null)
+                return '';
+            return node.text != null ? node.text : (node.children ?? []).map((c) => host.text(c)).join('');
+        },
+        html(node) {
+            if (node.rawHtml != null)
+                return node.rawHtml;
+            if (node.text != null)
+                return escapeHtml(node.text);
+            const attrs = Object.entries(node.attrs ?? {})
+                .map(([k, v]) => ` ${k}="${escapeHtml(v)}"`)
+                .join('');
+            return `<${node.tag}${attrs}>${(node.children ?? []).map((c) => host.html(c)).join('')}</${node.tag}>`;
+        },
+    };
+    return host;
+}
+export function domHost(doc = globalThis.document) {
+    const el = (n) => n;
+    return {
+        ops: null,
+        createElement: (tag) => doc.createElement(tag),
+        createText: (value) => doc.createTextNode(String(value)),
+        setText: (node, value) => {
+            el(node).data = String(value);
+        },
+        setAttribute: (node, name, value) => {
+            if (value == null || value === false)
+                el(node).removeAttribute(name);
+            else
+                el(node).setAttribute(name, String(value));
+        },
+        insert: (parent, node, before = null) => {
+            el(parent).insertBefore(node, before);
+        },
+        insertMarkup: (parent, html, before = null) => {
+            let fragment;
+            if (doc.parseHTML)
+                fragment = doc.parseHTML(html);
+            else {
+                const template = doc.createElement('template');
+                template.innerHTML = html;
+                fragment = template.content;
+            }
+            const nodes = [...fragment.childNodes];
+            for (const node of nodes)
+                el(parent).insertBefore(node, before);
+            return nodes;
+        },
+        move: (parent, node, before = null) => {
+            el(parent).insertBefore(node, before);
+        },
+        remove: (node) => {
+            el(node).remove();
+        },
+        listen: (node, event, handler) => {
+            const target = node;
+            target.addEventListener(event, handler);
+            return () => target.removeEventListener(event, handler);
+        },
+    };
+}
+//# sourceMappingURL=host.js.map

package/dist/host.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"host.js","sourceRoot":"","sources":["../../../../../packages/ketjs-view/src/host.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,yEAAyE;AACzE,uFAAuF;AA4BvF,MAAM,OAAO,GAA2B;IACtC,GAAG,EAAE,OAAO;IACZ,GAAG,EAAE,MAAM;IACX,GAAG,EAAE,MAAM;IACX,GAAG,EAAE,QAAQ;IACb,GAAG,EAAE,OAAO;CACb,CAAA;AACD,MAAM,YAAY,GAAG,SAAS,CAAA;AAC9B,MAAM,UAAU,GAAG,UAAU,CAAA;AAE7B,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,CAAU,EAAU,EAAE;IAC/C,MAAM,GAAG,GAAG,MAAM,CAAC,CAAC,CAAC,CAAA;IACrB,iFAAiF;IACjF,oFAAoF;IACpF,OAAO,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,CAAW,CAAC,CAAC,CAAC,CAAC,GAAG,CAAA;AAC5F,CAAC,CAAA;AAWD,MAAM,UAAU,YAAY;IAC1B,IAAI,EAAE,GAAG,CAAC,CAAA;IACV,MAAM,GAAG,GAAG;QACV,aAAa,EAAE,CAAC;QAChB,UAAU,EAAE,CAAC;QACb,OAAO,EAAE,CAAC;QACV,YAAY,EAAE,CAAC;QACf,MAAM,EAAE,CAAC;QACT,MAAM,EAAE,CAAC;QACT,IAAI,EAAE,CAAC;QACP,MAAM,EAAE,CAAC;KACV,CAAA;IACD,MAAM,SAAS,GAAG,IAAI,GAAG,EAAoD,CAAA;IAE7E,MAAM,MAAM,GAAG,CAAC,IAAc,EAAQ,EAAE;QACtC,IAAI,CAAC,IAAI,CAAC,MAAM;YAAE,OAAM;QACxB,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,QAAsB,CAAA;QAC/C,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;QAC5B,IAAI,CAAC,IAAI,CAAC;YAAE,IAAI,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;QAC7B,IAAI,CAAC,MAAM,GAAG,IAAI,CAAA;IACpB,CAAC,CAAA;IACD,MAAM,KAAK,GAAG,CAAC,MAAgB,EAAE,IAAc,EAAE,MAAmC,EAAQ,EAAE;QAC5F,MAAM,CAAC,IAAI,CAAC,CAAA;QACZ,MAAM,IAAI,GAAG,CAAC,MAAM,CAAC,QAAQ,KAAK,EAAE,CAAC,CAAA;QACrC,MAAM,GAAG,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;QAC9C,IAAI,GAAG,IAAI,CAAC;YAAE,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,EAAE,IAAI,CAAC,CAAA;;YAClC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACpB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;IACtB,CAAC,CAAA;IAED,MAAM,IAAI,GAAiB;QACzB,GAAG;QACH,KAAK;YACH,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC;gBAAE,GAAG,CAAC,CAAqB,CAAC,GAAG,CAAC,CAAA;QAClE,CAAC;QACD,IAAI;YACF,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAA;QACxE,CAAC;QACD,aAAa,CAAC,GAAG;YACf,GAAG,CAAC,aAAa,EAAE,CAAA;YACnB,OAAO,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAA;QACjE,CAAC;QACD,UAAU,CAAC,KAAK;YACd,GAAG,CAAC,UAAU,EAAE,CAAA;YAChB,OAAO,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAA;QACxD,CAAC;QACD,OAAO,CAAC,IAAI,EAAE,KAAK;YACjB,GAAG,CAAC,OAAO,EAAE,CAAA;YACb,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAA;QAC3B,CAAC;QACD,YAAY,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK;YAC5B,GAAG,CAAC,YAAY,EAAE,CAAA;YAClB,MAAM,KAAK,GAAG,CAAC,IAAI,CAAC,KAAK,KAAK,EAAE,CAAC,CAAA;YACjC,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,KAAK,KAAK;gBAAE,OAAO,KAAK,CAAC,IAAI,CAAC,CAAA;;gBACnD,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAA;QAClC,CAAC;QACD,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO;YACzB,GAAG,CAAC,MAAM,EAAE,CAAA;YACZ,MAAM,OAAO,GAAG,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,EAAqC,CAAA;YACnF,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;YAC5B,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,IAAI,GAAG,EAAwB,CAAA;YACjE,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,CAAA;YACvB,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;YAChB,OAAO,GAAG,EAAE;gBACV,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;YACrB,CAAC,CAAA;QACH,CAAC;QACD,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO;YACvB,KAAK,MAAM,EAAE,IAAI,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE;gBAAE,EAAE,CAAC,OAAO,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAA;QACxF,CAAC;QACD,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;YAChC,GAAG,CAAC,MAAM,EAAE,CAAA;YACZ,KAAK,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,CAAA;QAC7B,CAAC;QACD,YAAY,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;YACtC,MAAM,IAAI,GAAa,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAA;YAChE,GAAG,CAAC,aAAa,EAAE,CAAA;YACnB,GAAG,CAAC,MAAM,EAAE,CAAA;YACZ,KAAK,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,CAAA;YAC3B,OAAO,CAAC,IAAI,CAAC,CAAA;QACf,CAAC;QACD,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;YAC9B,GAAG,CAAC,IAAI,EAAE,CAAA;YACV,KAAK,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,CAAA;QAC7B,CAAC;QACD,MAAM,CAAC,IAAI;YACT,GAAG,CAAC,MAAM,EAAE,CAAA;YACZ,MAAM,CAAC,IAAI,CAAC,CAAA;QACd,CAAC;QACD,IAAI,CAAC,IAAI;YACP,IAAI,IAAI,CAAC,OAAO,IAAI,IAAI;gBAAE,OAAO,EAAE,CAAA;YACnC,OAAO,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;QAChG,CAAC;QACD,IAAI,CAAC,IAAI;YACP,IAAI,IAAI,CAAC,OAAO,IAAI,IAAI;gBAAE,OAAO,IAAI,CAAC,OAAO,CAAA;YAC7C,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI;gBAAE,OAAO,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;YACnD,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;iBAC3C,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC;iBAC3C,IAAI,CAAC,EAAE,CAAC,CAAA;YACX,OAAO,IAAI,IAAI,CAAC,GAAG,GAAG,KAAK,IAAI,CAAC,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,IAAI,CAAC,GAAG,GAAG,CAAA;QACxG,CAAC;KACF,CAAA;IACD,OAAO,IAAI,CAAA;AACb,CAAC;AAWD,MAAM,UAAU,OAAO,CAAC,GAAG,GAAa,UAAqC,CAAC,QAAmB;IAU/F,MAAM,EAAE,GAAG,CAAC,CAAW,EAAE,EAAE,CAAC,CAAkB,CAAA;IAC9C,OAAO;QACL,GAAG,EAAE,IAAI;QACT,aAAa,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,aAAa,CAAC,GAAG,CAAwB;QACrE,UAAU,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,CAAC,cAAc,CAAC,MAAM,CAAC,KAAK,CAAC,CAAwB;QAC/E,OAAO,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;YACvB,EAAE,CAAC,IAAI,CAAC,CAAC,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAA;QAC/B,CAAC;QACD,YAAY,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE;YAClC,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,KAAK,KAAK;gBAAE,EAAE,CAAC,IAAI,CAAC,CAAC,eAAe,CAAC,IAAI,CAAC,CAAA;;gBAC/D,EAAE,CAAC,IAAI,CAAC,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAA;QACjD,CAAC;QACD,MAAM,EAAE,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,EAAE,EAAE;YACtC,EAAE,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;QACvC,CAAC;QACD,YAAY,EAAE,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,EAAE,EAAE;YAC5C,IAAI,QAA2C,CAAA;YAC/C,IAAI,GAAG,CAAC,SAAS;gBAAE,QAAQ,GAAG,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,CAAA;iBAC5C,CAAC;gBACJ,MAAM,QAAQ,GAAG,GAAG,CAAC,aAAa,CAAC,UAAU,CAG5C,CAAA;gBACD,QAAQ,CAAC,SAAS,GAAG,IAAI,CAAA;gBACzB,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAA;YAC7B,CAAC;YACD,MAAM,KAAK,GAAG,CAAC,GAAG,QAAQ,CAAC,UAAU,CAAe,CAAA;YACpD,KAAK,MAAM,IAAI,IAAI,KAAK;gBAAE,EAAE,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;YAC/D,OAAO,KAAK,CAAA;QACd,CAAC;QACD,IAAI,EAAE,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,EAAE,EAAE;YACpC,EAAE,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;QACvC,CAAC;QACD,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;YACf,EAAE,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,CAAA;QACnB,CAAC;QACD,MAAM,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;YAC/B,MAAM,MAAM,GAAG,IAGd,CAAA;YACD,MAAM,CAAC,gBAAgB,CAAC,KAAK,EAAE,OAAO,CAAC,CAAA;YACvC,OAAO,GAAG,EAAE,CAAC,MAAM,CAAC,mBAAmB,CAAC,KAAK,EAAE,OAAO,CAAC,CAAA;QACzD,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+export { signal, computed, effect, batch } from './signal.ts';
+export type { Signal, Computed } from './signal.ts';
+export { html, each, when, createRoot, hydrateRoot } from './render.ts';
+export type { TemplateResult, Renderable, Root } from './render.ts';
+export { mount, mountHydrated } from './mount.ts';
+export type { Mounted } from './mount.ts';
+export { countingHost, domHost, escapeHtml } from './host.ts';
+export type { Host, HostNode } from './host.ts';
+export { renderToString, HydrationMismatch, HOLE_MARKER, trustedMarkup, isMarkup } from './ssr.ts';
+export type { Markup } from './ssr.ts';
+export { renderIsland, hydrateIslands, createIslandManager, ISLAND_TAG } from './island.ts';
+export type { IslandView, IslandController, IslandFactory, IslandDefinition, IslandRegistry, IslandProps, HydratedIsland, IslandElement, IslandManager, } from './island.ts';
+export type { JSXChild, JSXComponent, IntrinsicProps } from './jsx-runtime.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../packages/ketjs-view/src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,aAAa,CAAA;AAC7D,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AACnD,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AACvE,YAAY,EAAE,cAAc,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,aAAa,CAAA;AACnE,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AACjD,YAAY,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AACzC,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AAC7D,YAAY,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAA;AAC/C,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,WAAW,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AAClG,YAAY,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AACtC,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,mBAAmB,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAC3F,YAAY,EACV,UAAU,EACV,gBAAgB,EAChB,aAAa,EACb,gBAAgB,EAChB,cAAc,EACd,WAAW,EACX,cAAc,EACd,aAAa,EACb,aAAa,GACd,MAAM,aAAa,CAAA;AACpB,YAAY,EAAE,QAAQ,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA"}

package/dist/index.js

@@ -0,0 +1,7 @@
+export { signal, computed, effect, batch } from './signal.js';
+export { html, each, when, createRoot, hydrateRoot } from './render.js';
+export { mount, mountHydrated } from './mount.js';
+export { countingHost, domHost, escapeHtml } from './host.js';
+export { renderToString, HydrationMismatch, HOLE_MARKER, trustedMarkup, isMarkup } from './ssr.js';
+export { renderIsland, hydrateIslands, createIslandManager, ISLAND_TAG } from './island.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../packages/ketjs-view/src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,aAAa,CAAA;AAE7D,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAEvE,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAEjD,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AAE7D,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,WAAW,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AAElG,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,mBAAmB,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA"}

package/dist/island.d.ts

@@ -0,0 +1,74 @@
+import type { Host, HostNode } from './host.ts';
+import type { TemplateResult } from './render.ts';
+export declare const ISLAND_TAG = "ket-island";
+export declare class IslandError extends Error {
+    code: string;
+    hint: string | null;
+    constructor(d: {
+        code: string;
+        message: string;
+        hint?: string;
+    });
+}
+export type IslandProps = Record<string, unknown>;
+/** One mounted island instance. Signals and other local state live in this closure. */
+export type IslandView = () => TemplateResult;
+/** Optional lifecycle around a mounted island. A plain IslandView remains valid. */
+export type IslandController = {
+    view: IslandView;
+    update?(props: Readonly<IslandProps>): void;
+    dispose?(): void;
+};
+/** Create one isolated instance from serializable server props. */
+export type IslandFactory = (props: IslandProps) => IslandView | IslandController;
+export type IslandDefinition = {
+    view: IslandFactory;
+    /** The only surrounding scope keys that may cross into the island. */
+    props?: Record<string, string>;
+    /** Props that identify one persistent instance. Empty means one global instance. */
+    key?: readonly string[];
+    /** Browser module, relative to the declaring module's assets directory. */
+    client?: string;
+    /** Named browser export; defaults to `default`. */
+    export?: string;
+};
+export type IslandRegistry = Record<string, IslandFactory>;
+/**
+ * Render an island to markup, carrying its props alongside so the client can
+ * revive it with exactly the same input the server used. A different input would
+ * mean a different tree, and hydration would rightly refuse it.
+ */
+export declare function renderIsland(name: string, factory: IslandFactory, props: IslandProps, options?: {
+    key?: readonly string[];
+}): string;
+export type IslandElement = HostNode & {
+    getAttribute(name: string): string | null;
+    setAttribute?(name: string, value: string): void;
+    querySelectorAll(sel: string): Iterable<IslandElement>;
+    childNodes?: Iterable<IslandElement>;
+    parentNode?: IslandElement | null;
+};
+export type HydratedIsland = {
+    name: string;
+    key: string;
+    props: Readonly<IslandProps>;
+    element: IslandElement;
+    dispose(): void;
+};
+export type IslandManager = {
+    hydrate(root: IslandElement): HydratedIsland[];
+    reconcile(slot: IslandElement, nextContent: IslandElement): HydratedIsland[];
+    dispose(root: IslandElement): void;
+};
+export declare function createIslandManager(host: Host, registry: IslandRegistry, options?: {
+    strict?: boolean;
+}): IslandManager;
+/**
+ * Find every island in a server-rendered page and bring it to life. Only the
+ * islands are hydrated — the rest of the page stays inert markup, which is the
+ * whole point of rendering a theme to a string in the first place.
+ */
+export declare function hydrateIslands(host: Host, root: IslandElement, registry: IslandRegistry, options?: {
+    strict?: boolean;
+}): HydratedIsland[];
+//# sourceMappingURL=island.d.ts.map

package/dist/island.d.ts.map

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