@graview/guest 0.1.9 → 0.1.10

package/dist/worker/view-global.js

@@ -0,0 +1,264 @@
+/*
+ * THE `graview` GLOBAL, WHEREVER A VIEW RUNS (FR-90, FR-95).
+ *
+ * What a view is handed — `props`, `onProps`, `render`, `style`, `on`,
+ * `act`, `navigate`, `html` — made over Remote DOM's polyfilled document
+ * and a way out the runtime gives it: the port to the host, in a worker
+ * (worker/view.ts), or the transcript of a headless run, in an isolate a
+ * host chose (headless/runtime.ts). Either way the view is the same script
+ * and is handed the same global, so what it draws headless is what it
+ * draws in the page.
+ *
+ * `render` keeps what is already drawn where it can — same element, same
+ * key (`data-key` or `id`) — and changes only what moved, so a field the
+ * viewer is typing in keeps its text and its focus across a push.
+ */
+import { RemoteRootElement, remoteId } from "@remote-dom/core/elements";
+import { HTML_ELEMENTS, UNNAMED_ELEMENTS, openAttribute, svgElementName } from "../open-kit.js";
+import { createListenerLedger } from "./listeners.js";
+/** The element a view's drawing hangs from; the host's region stands for it. */
+export const VIEW_ROOT = "graview-view-root";
+const escape = (value) => value.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&#39;");
+const markup = (html) => Object.freeze({ html, toString: () => html });
+const isHtml = (value) => typeof value === "object" && value !== null && typeof value.html === "string" && Object.isFrozen(value);
+const piece = (value) => {
+    if (value === null || value === undefined || value === false)
+        return "";
+    if (Array.isArray(value))
+        return value.map(piece).join("");
+    if (isHtml(value))
+        return value.html;
+    return escape(String(value));
+};
+/**
+ * Make the global over Remote DOM's polyfilled document, which must be in
+ * place already. Once per runtime: the root element is defined here.
+ */
+export function createViewRuntime(io) {
+    if (!customElements.get(VIEW_ROOT))
+        customElements.define(VIEW_ROOT, RemoteRootElement);
+    /* Kept as the runtime found them: a view's own code cannot swap what the runtime builds with. */
+    const DomEvent = Event;
+    const ledger = createListenerLedger();
+    const propsListeners = new Set();
+    const delegated = new Set();
+    let current;
+    let refusedLast = [];
+    const root = document.createElement(VIEW_ROOT);
+    const byId = (id) => {
+        const walk = (node) => {
+            for (const child of Array.from(node.childNodes)) {
+                if (child.nodeType !== 1)
+                    continue;
+                if (remoteId(child) === id)
+                    return child;
+                const found = walk(child);
+                if (found)
+                    return found;
+            }
+            return undefined;
+        };
+        return walk(root);
+    };
+    const heard = (message) => {
+        const target = byId(message.target);
+        if (!target)
+            return;
+        const event = new DomEvent(message.event, { bubbles: true });
+        for (const key of ["value", "checked", "key", "pressed"])
+            if (message[key] !== undefined)
+                Object.defineProperty(event, key, { value: message[key], enumerable: true });
+        target.dispatchEvent(event);
+        for (const one of delegated) {
+            if (one.type !== message.event)
+                continue;
+            let matching;
+            try {
+                matching = new Set(Array.from(root.querySelectorAll(one.selector)));
+            }
+            catch {
+                continue;
+            }
+            for (let at = target; at && at !== root; at = at.parentNode) {
+                if (!matching.has(at))
+                    continue;
+                one.listener(Object.freeze({ type: message.event, target, element: at, ...(message.value !== undefined ? { value: message.value } : {}), ...(message.checked !== undefined ? { checked: message.checked } : {}), ...(message.key !== undefined ? { key: message.key } : {}), ...(message.pressed !== undefined ? { pressed: message.pressed } : {}) }));
+                break;
+            }
+        }
+    };
+    const hear = (message) => {
+        if (message.type === "dom-event" && typeof message.target === "string")
+            return heard(message);
+        if (message.type !== "props")
+            return;
+        /*
+         * A PUSH, TIMED. The view's listeners run now; what they drew goes in
+         * the next microtask; then the runtime says it has drawn this push,
+         * and how long the view's own work took (FR-94). The view cannot say
+         * it for itself: the way out is the runtime's.
+         */
+        current = message.props;
+        const began = io.now();
+        for (const listener of propsListeners) {
+            try {
+                listener(message.props);
+            }
+            catch (error) {
+                io.threw(error);
+            }
+        }
+        const ms = io.now() - began;
+        const push = message.push;
+        if (typeof push === "number")
+            io.microtask(() => io.microtask(() => io.send({ type: "pushed", push, ms })));
+    };
+    /* A microtask's mutations go as one message: a render is one message, not one per node. */
+    let pending;
+    root.connect({
+        mutate(records) {
+            if (!pending) {
+                pending = [];
+                io.microtask(() => {
+                    const batch = pending ?? [];
+                    pending = undefined;
+                    io.send({ type: "render", records: ledger.encode(batch) });
+                });
+            }
+            pending.push(...records);
+        },
+        call: () => undefined,
+    });
+    const keyOf = (node) => (node.nodeType === 1 ? (node.getAttribute("data-key") ?? node.getAttribute("id")) : null);
+    const same = (a, b) => a.nodeType === b.nodeType && (a.nodeType !== 1 || (a.localName === b.localName && a.namespaceURI === b.namespaceURI && keyOf(a) === keyOf(b)));
+    /** Make `live` hold what `next` holds, keeping every node that can stay. */
+    function morph(live, next) {
+        const wanted = Array.from(next.childNodes);
+        let index = 0;
+        for (const want of wanted) {
+            const have = live.childNodes[index] ?? null;
+            if (have && same(have, want)) {
+                update(have, want);
+                index += 1;
+                continue;
+            }
+            const key = keyOf(want);
+            if (key !== null) {
+                const later = Array.from(live.childNodes)
+                    .slice(index + 1)
+                    .find((candidate) => same(candidate, want));
+                if (later) {
+                    live.insertBefore(later, have);
+                    update(later, want);
+                    index += 1;
+                    continue;
+                }
+            }
+            live.insertBefore(want, have);
+            index += 1;
+        }
+        while (live.childNodes.length > index)
+            live.removeChild(live.lastChild);
+    }
+    function update(have, want) {
+        if (have.nodeType !== 1) {
+            if (have.data !== want.data)
+                have.data = want.data;
+            return;
+        }
+        const from = have;
+        const to = want;
+        for (const name of from.getAttributeNames())
+            if (!to.hasAttribute(name))
+                from.removeAttribute(name);
+        for (const name of to.getAttributeNames()) {
+            const value = to.getAttribute(name);
+            if (from.getAttribute(name) !== value)
+                from.setAttribute(name, value);
+        }
+        morph(from, to);
+    }
+    /** What the host will not draw, by the open kit's tables: said at once, for the author. */
+    function precheck(node, svg, said) {
+        for (const child of Array.from(node.childNodes)) {
+            if (child.nodeType !== 1)
+                continue;
+            const element = child;
+            const name = element.localName;
+            const inSvg = svg || name.toLowerCase() === "svg";
+            const canonical = inSvg ? svgElementName(name) : Object.prototype.hasOwnProperty.call(HTML_ELEMENTS, name.toLowerCase()) ? name.toLowerCase() : undefined;
+            if (!canonical) {
+                said.add(`<${name}>`);
+                continue;
+            }
+            for (const attribute of element.getAttributeNames()) {
+                if (!openAttribute(inSvg ? "svg" : "html", canonical, attribute) || (!inSvg && UNNAMED_ELEMENTS[canonical]?.includes(attribute.toLowerCase())))
+                    said.add(`${canonical} ${attribute}`);
+            }
+            precheck(element, inSvg, said);
+        }
+    }
+    function render(content) {
+        const next = document.createElement("div");
+        const parts = Array.isArray(content) ? content : [content];
+        for (const part of parts) {
+            if (part === null || part === undefined)
+                continue;
+            if (typeof part === "string" || isHtml(part)) {
+                const holder = document.createElement("div");
+                holder.innerHTML = typeof part === "string" ? part : part.html;
+                next.append(...Array.from(holder.childNodes));
+            }
+            else
+                next.append(part);
+        }
+        const said = new Set();
+        precheck(next, false, said);
+        refusedLast = [...said];
+        if (refusedLast.length > 0)
+            io.warn(`The host will not draw: ${refusedLast.join(", ")}`);
+        morph(root, next);
+    }
+    let styled;
+    const view = Object.freeze({
+        get props() {
+            return current;
+        },
+        onProps(listener) {
+            propsListeners.add(listener);
+            if (current)
+                listener(current);
+            return () => void propsListeners.delete(listener);
+        },
+        render,
+        style(css) {
+            if (typeof css !== "string" || css === styled)
+                return;
+            styled = css;
+            io.send({ type: "style", css });
+        },
+        on(type, selector, listener) {
+            const one = { type, selector, listener };
+            delegated.add(one);
+            return () => void delegated.delete(one);
+        },
+        act: (name, args = {}) => io.act(name, args),
+        navigate(to) {
+            if (typeof to === "string")
+                io.navigate(to);
+            else if (to && typeof to.place === "string")
+                io.send({ type: "navigate", place: to.place });
+        },
+        html(strings, ...values) {
+            return markup(strings.reduce((out, text, index) => out + text + (index < values.length ? piece(values[index]) : ""), ""));
+        },
+        get refused() {
+            return refusedLast;
+        },
+        get hardening() {
+            return io.hardening();
+        },
+    });
+    return { view, hear };
+}
+//# sourceMappingURL=view-global.js.map

package/dist/worker/view-global.js.map

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

package/dist/worker/view.d.ts

@@ -0,0 +1,14 @@
+import "@remote-dom/core/polyfill";
+import { type Hardening } from "./harden.js";
+declare const view: import("./view-global.js").GraviewView;
+/**
+ * WHAT HARDENING TOOK (FR-70), with `graview` kept. As for the kit's guest:
+ * a name that will not go stops the runtime before the view runs, and in a
+ * test of the runtime outside a worker nothing is hardened.
+ */
+export declare const hardening: Hardening;
+export { view as graview };
+export { VIEW_ROOT } from "./view-global.js";
+export type { Drawable, GraviewView, Html, ViewEvent } from "./view-global.js";
+export type { GuestAnswer, GuestPressed, GuestProps, GuestTheme } from "../protocol.js";
+//# sourceMappingURL=view.d.ts.map

package/dist/worker/view.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"view.d.ts","sourceRoot":"","sources":["../../src/worker/view.ts"],"names":[],"mappings":"AA0BA,OAAO,2BAA2B,CAAC;AAGnC,OAAO,EAAU,KAAK,SAAS,EAAE,MAAM,aAAa,CAAC;AA4BrD,QAAA,MAAM,IAAI,wCAAe,CAAC;AAI1B;;;;GAIG;AACH,eAAO,MAAM,SAAS,EAAE,SAA0F,CAAC;AAInH,OAAO,EAAE,IAAI,IAAI,OAAO,EAAE,CAAC;AAC3B,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,YAAY,EAAE,QAAQ,EAAE,WAAW,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC/E,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/worker/view.js

@@ -0,0 +1,64 @@
+/*
+ * A WORKER VIEW'S RUNTIME (FR-90): `@graview/guest/worker/view`.
+ *
+ * The open kit's half in the worker. Like the kit's guest entry
+ * (worker/index.ts) it keeps how to hear the host, boots Remote DOM's
+ * polyfill and hardens the worker before a line of the view runs; unlike
+ * it, it defines no components. A view draws plain HTML and SVG, and gives
+ * one stylesheet, and the host draws what the open kit allows of them
+ * (open-kit.ts, host/open-render.ts, host/css.ts).
+ *
+ * What a view is handed is one global, `graview`, kept through hardening
+ * and frozen with the rest (view-global.ts says what it holds):
+ *
+ *   graview.props            what the host last pushed: the viewer's sight
+ *   graview.onProps(fn)      called with every push (and at once, if there is one)
+ *   graview.render(markup)   draw: a string of HTML, `graview.html`…`` or nodes
+ *   graview.style(css)       the view's one stylesheet
+ *   graview.on(type, selector, fn)   hear the viewer: click, input, change, keydown, toggle
+ *   graview.act(name, args)  ask for an act; resolves with the host's answer
+ *   graview.navigate(to)     go to a record (its id) or a place ({ place: slug })
+ *   graview.html``           markup, with every value put in it escaped
+ *
+ * The same global, over a transcript rather than a port, is what a
+ * headless run hands a view (headless/runtime.ts, FR-95).
+ */
+import { natives } from "./natives.js";
+import "@remote-dom/core/polyfill";
+import { openGuest } from "../channel.js";
+import { harden } from "./harden.js";
+import { createViewRuntime } from "./view-global.js";
+let hardened = { removed: [], stuck: [], sealed: false, worker: false };
+const opened = openGuest({
+    listen(hear) {
+        natives.listen(hear);
+        return () => natives.unlisten(hear);
+    },
+    /* A dedicated worker hears only its owner: whoever posts to it is the host that started it. */
+    fromHost: () => true,
+    ready: (message) => natives.post(message),
+}, { onMessage: (message) => runtime.hear(message) });
+const runtime = createViewRuntime({
+    send: (request) => opened.send(request),
+    act: (name, args) => opened.guest.act(name, args),
+    navigate: (to) => opened.guest.navigate(to),
+    microtask: natives.microtask,
+    now: natives.now,
+    threw: (error) => console.error(error),
+    warn: (text) => console.warn(text),
+    hardening: () => hardened,
+});
+const view = runtime.view;
+Object.defineProperty(globalThis, "graview", { value: view, enumerable: true, configurable: true, writable: false });
+/**
+ * WHAT HARDENING TOOK (FR-70), with `graview` kept. As for the kit's guest:
+ * a name that will not go stops the runtime before the view runs, and in a
+ * test of the runtime outside a worker nothing is hardened.
+ */
+export const hardening = "WorkerGlobalScope" in globalThis ? harden(globalThis, ["graview"]) : hardened;
+hardened = hardening;
+if (hardening.stuck.length > 0)
+    throw new Error(`The view's worker could not be hardened: ${hardening.stuck.join(", ")} would not go.`);
+export { view as graview };
+export { VIEW_ROOT } from "./view-global.js";
+//# sourceMappingURL=view.js.map

package/dist/worker/view.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"view.js","sourceRoot":"","sources":["../../src/worker/view.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,2BAA2B,CAAC;AACnC,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE1C,OAAO,EAAE,MAAM,EAAkB,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAErD,IAAI,QAAQ,GAAc,EAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;AAEnF,MAAM,MAAM,GAAG,SAAS,CACtB;IACE,MAAM,CAAC,IAAI;QACT,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACrB,OAAO,GAAG,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IACtC,CAAC;IACD,+FAA+F;IAC/F,QAAQ,EAAE,GAAG,EAAE,CAAC,IAAI;IACpB,KAAK,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC;CAC1C,EACD,EAAE,SAAS,EAAE,CAAC,OAAoB,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAC/D,CAAC;AAEF,MAAM,OAAO,GAAG,iBAAiB,CAAC;IAChC,IAAI,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC;IACvC,GAAG,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC;IACjD,QAAQ,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;IAC3C,SAAS,EAAE,OAAO,CAAC,SAAS;IAC5B,GAAG,EAAE,OAAO,CAAC,GAAG;IAChB,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC;IACtC,IAAI,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC;IAClC,SAAS,EAAE,GAAG,EAAE,CAAC,QAAQ;CAC1B,CAAC,CAAC;AACH,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;AAE1B,MAAM,CAAC,cAAc,CAAC,UAAU,EAAE,SAAS,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC;AAErH;;;;GAIG;AACH,MAAM,CAAC,MAAM,SAAS,GAAc,mBAAmB,IAAI,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;AACnH,QAAQ,GAAG,SAAS,CAAC;AACrB,IAAI,SAAS,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC;IAAE,MAAM,IAAI,KAAK,CAAC,4CAA4C,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;AAExI,OAAO,EAAE,IAAI,IAAI,OAAO,EAAE,CAAC;AAC3B,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@graview/guest",
-  "version": "0.1.9",
+  "version": "0.1.10",
   "type": "module",
   "description": "Guest views: somebody else's React or plain script in a sandboxed frame, or a hardened classic worker drawing a component kit, shown only what the viewer may see, able only to ask for acts the viewer's seat then applies.",
   "keywords": [
@@ -33,20 +33,45 @@
       "types": "./dist/host/worker.d.ts",
       "default": "./dist/host/worker.js"
     },
+    "./host/views": {
+      "types": "./dist/host/views.d.ts",
+      "default": "./dist/host/views.js"
+    },
+    "./headless": {
+      "types": "./dist/headless/index.d.ts",
+      "default": "./dist/headless/index.js"
+    },
+    "./headless/node": {
+      "types": "./dist/headless/node.d.ts",
+      "default": "./dist/headless/node.js"
+    },
     "./worker": {
       "types": "./dist/worker/index.d.ts",
       "default": "./dist/worker/index.js"
     },
+    "./worker/view": {
+      "types": "./dist/worker/view.d.ts",
+      "default": "./dist/worker/view.js"
+    },
     "./build": {
       "types": "./dist/build.d.ts",
       "default": "./dist/build.js"
-    }
+    },
+    "./cli": {
+      "types": "./dist/cli.d.ts",
+      "default": "./dist/cli.js"
+    },
+    "./client": {
+      "types": "./dist/client.d.ts",
+      "default": "./dist/client.js"
+    },
+    "./client.js": "./client.js"
   },
   "dependencies": {
     "@remote-dom/core": "1.12.0",
     "@remote-dom/polyfill": "1.6.0",
-    "@graview/core": "0.1.9",
-    "@graview/react": "0.1.9"
+    "@graview/core": "0.1.10",
+    "@graview/react": "0.1.10"
   },
   "peerDependencies": {
     "react": ">=18",
@@ -62,6 +87,7 @@
   },
   "files": [
     "dist",
+    "client.js",
     "README.md"
   ],
   "sideEffects": [