@graview/guest 0.1.9 → 0.1.12

package/dist/host/manifest.js

@@ -0,0 +1,103 @@
+import { plainNode, readAcross } from "./session.js";
+/** An act of a manifest, said in full. */
+export function manifestActs(manifest) {
+    return (manifest.acts ?? []).map((one) => (typeof one === "string" ? { act: one } : one));
+}
+/**
+ * WHAT IS WRONG WITH A MANIFEST, in sentences: a kind, an edge or an act the
+ * app does not declare, a name that is not a name. Empty when it is sound.
+ * A host refuses to mount a view whose manifest says anything here.
+ */
+export function checkManifest(manifest, store) {
+    const findings = [];
+    const kinds = new Set(store.schema.kinds);
+    const edges = new Set(store.schema.edgeKinds);
+    const acts = new Set(store.allMutations().map((mutation) => mutation.name));
+    if (typeof manifest.name !== "string" || !/^[a-z0-9][a-z0-9-]{0,62}$/.test(manifest.name))
+        findings.push(`The view's name "${String(manifest.name)}" is not lower-case letters, digits and hyphens.`);
+    if (manifest.title !== undefined && (typeof manifest.title !== "string" || manifest.title.trim() === "" || manifest.title.length > 80))
+        findings.push("The view's title is empty or longer than 80 characters.");
+    if (manifest.attach !== "home" && !kinds.has(manifest.attach))
+        findings.push(`The view attaches to "${manifest.attach}", which is no kind of this app.`);
+    if (manifest.cardinality !== "one" && manifest.cardinality !== "many")
+        findings.push(`The view's cardinality is "${String(manifest.cardinality)}", not one or many.`);
+    if (manifest.attach === "home" && manifest.cardinality !== "many")
+        findings.push("A view of the home draws many records: its cardinality is many.");
+    for (const kind of manifest.reads?.kinds ?? [])
+        if (!kinds.has(kind))
+            findings.push(`The view reads "${kind}", which is no kind of this app.`);
+    for (const edge of manifest.reads?.edges ?? [])
+        if (!edges.has(edge))
+            findings.push(`The view reads the edge "${edge}", which no kind of this app declares.`);
+    const named = new Set();
+    for (const one of manifestActs(manifest)) {
+        if (!acts.has(one.act))
+            findings.push(`The view asks for the act "${one.act}", which this app does not declare.`);
+        const as = one.as ?? one.act;
+        if (named.has(as))
+            findings.push(`Two of the view's acts are called "${as}".`);
+        named.add(as);
+    }
+    return findings;
+}
+/**
+ * WHAT A WORKER VIEW IS HANDED: the viewer's sight, limited to its manifest.
+ * For a kind, the record (`one`) or the members (`many`; every member the
+ * viewer sees when the face names none); for the home, nothing of its own.
+ * Then every record of the kinds it reads, and the edges of the kinds it
+ * reads among all of those — every one read through `seenBy(principal)`.
+ */
+export function workerViewProps(store, principal, given) {
+    const { manifest } = given;
+    const input = given.input ?? {};
+    const seen = store.seenBy(principal);
+    const graph = seen.graph;
+    const attached = manifest.attach === "home" ? undefined : manifest.attach;
+    const node = attached && manifest.cardinality === "one" && input.node ? graph.getNode(input.node.id) : undefined;
+    const own = node && node.kind === attached ? [node] : [];
+    const members = attached && manifest.cardinality === "many"
+        ? input.nodes
+            ? input.nodes.flatMap((member) => {
+                const found = graph.getNode(member.id);
+                return found && found.kind === attached ? [found] : [];
+            })
+            : graph.nodesOfKind(attached)
+        : [];
+    /* What it reads across kinds (session.ts's `readAcross`, the frame guest's rule too): a view of many never reads more of its own kind than the face handed it. */
+    const ownIds = new Set([...own, ...members].map((one) => one.id));
+    const read = readAcross(graph, ownIds, { kinds: (manifest.reads?.kinds ?? []).filter((kind) => kind !== attached || manifest.cardinality === "one"), edges: manifest.reads?.edges ?? [] });
+    const listed = new Map();
+    for (const one of [...members, ...read.nodes])
+        if (!own.some((mine) => mine.id === one.id))
+            listed.set(one.id, one);
+    const shown = new Set([...own.map((one) => one.id), ...listed.keys()]);
+    const edges = [...read.edges];
+    const declared = new Set(manifestActs(manifest).map((one) => one.act));
+    const acts = store
+        .permittedMutations(principal)
+        .filter((mutation) => declared.has(mutation.name))
+        .map((mutation) => ({
+        name: mutation.name,
+        title: mutation.title ?? mutation.name,
+        ...(mutation.description !== undefined ? { description: mutation.description } : {}),
+        ...(mutation.subject ? { subject: { kinds: mutation.subject.kinds, arg: mutation.subject.arg } } : {}),
+    }));
+    const visible = (ids) => ids?.filter((id) => shown.has(id));
+    return {
+        view: manifest.name,
+        ...(own[0] ? { node: plainNode(store, own[0]) } : {}),
+        nodes: [...listed.values()].map((one) => plainNode(store, one)),
+        edges,
+        ...(manifest.title !== undefined ? { label: manifest.title } : input.label !== undefined ? { label: input.label } : {}),
+        cardinality: manifest.cardinality,
+        ...(input.fidelity !== undefined ? { fidelity: input.fidelity } : {}),
+        ...(input.mode !== undefined ? { mode: input.mode } : {}),
+        ...(input.selected !== undefined ? { selected: input.selected } : {}),
+        ...(input.implicated ? { implicated: visible(input.implicated) } : {}),
+        ...(input.flagged ? { flagged: visible(input.flagged) } : {}),
+        acts,
+        ...(given.theme ? { theme: given.theme } : {}),
+        ...(given.places ? { places: given.places.map(({ as, title, kind }) => ({ as, title, kind })) } : {}),
+    };
+}
+//# sourceMappingURL=manifest.js.map

package/dist/host/manifest.js.map

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

package/dist/host/open-draw.d.ts

@@ -0,0 +1,44 @@
+import type { GuestDomEvent } from "../protocol.js";
+import { type CssRefusal } from "./css.js";
+import type { OpenNamespace, OpenRefusal } from "./open-judge.js";
+import { type OpenRenderer } from "./open-render.js";
+/** The host's own rules for the region: what a view's stylesheet cannot reach, because it cannot write `:host`. */
+export declare const REGION_CSS = "\n:host { display: block; position: relative; contain: layout paint style; isolation: isolate; overflow: clip; min-width: 0; }\n[data-graview-view-root] { color: var(--graview-ink, CanvasText); font-family: var(--graview-font-body, system-ui, sans-serif); line-height: 1.45; }\n[data-graview-view-root] [data-graview-link] { cursor: pointer; }\n";
+export interface OpenDrawingOptions {
+    /** The host page's origin, for a `blob:` image of its own. */
+    readonly origin: string;
+    readonly maxNodes?: number;
+    readonly onOverBudget?: () => void;
+    /** Tell the view what the viewer did. */
+    readonly send: (message: GuestDomEvent) => void;
+    readonly decorate?: (element: Element, name: string, namespace: OpenNamespace) => void;
+    readonly onFieldSet?: (field: Element) => void;
+    readonly onAttribute?: (element: Element, name: string) => void;
+    /**
+     * The viewer did something on what the view drew, before the view is
+     * told: the host's own handling (a press bound to an act, a link), in the
+     * event's own handler. What it returns goes with what the view is told
+     * (`pressed`); `false` keeps the view from being told.
+     */
+    readonly before?: (event: Event, element: Element, root: Element) => Partial<GuestDomEvent> | false | void;
+}
+export type ViewRefusal = OpenRefusal | {
+    readonly reason: "css";
+    readonly name: "stylesheet";
+    readonly css: CssRefusal;
+};
+export interface OpenDrawing {
+    /** Draw one batch of the view's mutation records; false if `spent` stopped it partway (OpenRenderer.apply). */
+    apply(records: unknown, spent?: () => boolean): boolean;
+    /** Draw the view's one stylesheet, as the open kit allows it. */
+    style(css: string): void;
+    readonly renderer: OpenRenderer;
+    /** What was refused of the drawing and the stylesheet (the last 200 of each). */
+    readonly refused: readonly ViewRefusal[];
+    /** The stylesheet as drawn. */
+    readonly css: string;
+    dispose(): void;
+}
+/** Draw into `shadow`: the host's region rules, the view's stylesheet, and the view's drawing under one root. */
+export declare function createOpenDrawing(shadow: ShadowRoot, options: OpenDrawingOptions): OpenDrawing;
+//# sourceMappingURL=open-draw.d.ts.map

package/dist/host/open-draw.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"open-draw.d.ts","sourceRoot":"","sources":["../../src/host/open-draw.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAsB,KAAK,UAAU,EAAE,MAAM,UAAU,CAAC;AAC/D,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAClE,OAAO,EAAsB,KAAK,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAUzE,mHAAmH;AACnH,eAAO,MAAM,UAAU,8VAItB,CAAC;AAMF,MAAM,WAAW,kBAAkB;IACjC,8DAA8D;IAC9D,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;IACnC,yCAAyC;IACzC,QAAQ,CAAC,IAAI,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,IAAI,CAAC;IAChD,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,aAAa,KAAK,IAAI,CAAC;IACvF,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IAC/C,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAChE;;;;;OAKG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC,aAAa,CAAC,GAAG,KAAK,GAAG,IAAI,CAAC;CAC5G;AAED,MAAM,MAAM,WAAW,GAAG,WAAW,GAAG;IAAE,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,UAAU,CAAA;CAAE,CAAC;AAE1H,MAAM,WAAW,WAAW;IAC1B,+GAA+G;IAC/G,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,MAAM,OAAO,GAAG,OAAO,CAAC;IACxD,iEAAiE;IACjE,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC;IAChC,iFAAiF;IACjF,QAAQ,CAAC,OAAO,EAAE,SAAS,WAAW,EAAE,CAAC;IACzC,+BAA+B;IAC/B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,iHAAiH;AACjH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,kBAAkB,GAAG,WAAW,CAiF9F"}

package/dist/host/open-draw.js

@@ -0,0 +1,108 @@
+import { sanitizeStylesheet } from "./css.js";
+import { createOpenRenderer } from "./open-render.js";
+/*
+ * A WORKER VIEW'S REGION, DRAWN (FR-90): the open kit's renderer and
+ * stylesheet in a shadow root the host owns, and the viewer's clicks,
+ * typing and choices on what was drawn told to the view. This module is
+ * what `mountWorkerView` fetches when it first draws an open-kit view, so a
+ * page that draws none loads none of the sanitiser.
+ */
+/** The host's own rules for the region: what a view's stylesheet cannot reach, because it cannot write `:host`. */
+export const REGION_CSS = `
+:host { display: block; position: relative; contain: layout paint style; isolation: isolate; overflow: clip; min-width: 0; }
+[data-graview-view-root] { color: var(--graview-ink, CanvasText); font-family: var(--graview-font-body, system-ui, sans-serif); line-height: 1.45; }
+[data-graview-view-root] [data-graview-link] { cursor: pointer; }
+`;
+/** The keys a view hears: enough to move and choose, never what the viewer types into the app elsewhere. */
+const KEYS = new Set(["Enter", " ", "Escape", "ArrowUp", "ArrowDown", "ArrowLeft", "ArrowRight", "Home", "End"]);
+const EVENTS = ["click", "input", "change", "keydown"];
+/** Draw into `shadow`: the host's region rules, the view's stylesheet, and the view's drawing under one root. */
+export function createOpenDrawing(shadow, options) {
+    const document = shadow.ownerDocument;
+    const base = document.createElement("style");
+    base.setAttribute("data-graview-region", "");
+    base.textContent = REGION_CSS;
+    const sheet = document.createElement("style");
+    sheet.setAttribute("data-graview-view-style", "");
+    const into = document.createElement("div");
+    into.setAttribute("data-graview-view-root", "");
+    shadow.append(base, sheet, into);
+    const renderer = createOpenRenderer(into, {
+        origin: options.origin,
+        ...(options.maxNodes !== undefined ? { maxNodes: options.maxNodes } : {}),
+        ...(options.onOverBudget ? { onOverBudget: options.onOverBudget } : {}),
+        decorate: (element, name, namespace) => {
+            /* A button presses, and never submits; a field is never filled from what the browser remembers of the viewer. */
+            if (namespace === "html" && name === "button")
+                element.setAttribute("type", "button");
+            if (namespace === "html" && (name === "input" || name === "textarea" || name === "select"))
+                element.setAttribute("autocomplete", "off");
+            options.decorate?.(element, name, namespace);
+        },
+        ...(options.onFieldSet ? { onFieldSet: options.onFieldSet } : {}),
+        ...(options.onAttribute ? { onAttribute: options.onAttribute } : {}),
+    });
+    const cssRefused = [];
+    let css = "";
+    /** The nearest element the view drew, at or above where it happened. */
+    const drawnAt = (event) => {
+        for (let at = event.composedPath()[0]; at && at !== into && at !== shadow; at = at.parentNode) {
+            if (at.nodeType === 1 && renderer.idOf(at) !== undefined)
+                return at;
+        }
+        return undefined;
+    };
+    const hear = (event) => {
+        const element = drawnAt(event);
+        if (!element)
+            return;
+        if (event.type === "keydown" && !KEYS.has(event.key))
+            return;
+        const said = options.before?.(event, element, into);
+        if (said === false)
+            return;
+        const field = element;
+        const isField = element.namespaceURI === "http://www.w3.org/1999/xhtml" && ["input", "select", "textarea"].includes(element.localName);
+        options.send({
+            type: "dom-event",
+            target: renderer.idOf(element),
+            event: event.type,
+            ...(isField ? { value: String(field.value ?? "") } : {}),
+            ...(isField && (field.type === "checkbox" || field.type === "radio") ? { checked: field.checked } : {}),
+            ...(event.type === "keydown" ? { key: event.key } : {}),
+            ...(said ?? {}),
+        });
+    };
+    for (const type of EVENTS)
+        shadow.addEventListener(type, hear);
+    /* `toggle` does not bubble: heard on the way down. */
+    shadow.addEventListener("toggle", hear, true);
+    return {
+        apply: (records, spent) => renderer.apply(records, spent),
+        style(given) {
+            const judged = sanitizeStylesheet(given);
+            for (const one of judged.refused) {
+                cssRefused.push({ reason: "css", name: "stylesheet", css: one });
+                if (cssRefused.length > 200)
+                    cssRefused.shift();
+            }
+            css = judged.css;
+            sheet.textContent = css;
+        },
+        renderer,
+        get refused() {
+            return [...renderer.refused, ...cssRefused];
+        },
+        get css() {
+            return css;
+        },
+        dispose() {
+            for (const type of EVENTS)
+                shadow.removeEventListener(type, hear);
+            shadow.removeEventListener("toggle", hear, true);
+            renderer.dispose();
+            shadow.replaceChildren();
+        },
+    };
+}
+//# sourceMappingURL=open-draw.js.map

package/dist/host/open-draw.js.map

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

package/dist/host/open-judge.d.ts

@@ -0,0 +1,53 @@
+import { type CssRefusal } from "./css.js";
+export type OpenNamespace = "html" | "svg";
+/** Why part of what a view drew was not drawn. */
+export type OpenRefusalReason = 
+/** An element outside the open kit, or in a place it may not stand (HTML inside SVG). */
+"element"
+/** An attribute its element does not take (`src` outside `img`, `href`, `srcset`, `on*`, `formaction`, …). */
+ | "attribute"
+/** A value of the wrong kind: not a number, not on the list, a role the app's chrome speaks with. */
+ | "value"
+/** An address: an image not `data:` or the host's own `blob:`, a reference not `#id`. */
+ | "url"
+/** CSS refused, in a `style` attribute, a presentation attribute or the stylesheet: `css` says what. */
+ | "css"
+/** A child its element may not hold. */
+ | "child"
+/** A record the format does not know, or one about a node that is not drawn. */
+ | "record"
+/** More nodes than the view is allowed. */
+ | "budget";
+export interface OpenRefusal {
+    readonly reason: OpenRefusalReason;
+    readonly element?: string;
+    readonly name?: string;
+    readonly css?: CssRefusal;
+}
+/** An element as the host draws it, or a refusal. */
+export declare function judgeElement(name: string, parent: OpenNamespace): {
+    readonly namespace: OpenNamespace;
+    readonly name: string;
+    readonly as?: string;
+} | {
+    readonly refused: OpenRefusal;
+};
+/** Whether an element holds nothing (`img`, `input`, `br`). */
+export declare function isEmptyElement(namespace: OpenNamespace, name: string): boolean;
+export interface JudgeContext {
+    /** The host page's origin, for a `blob:` image of its own. "null" in an opaque origin. */
+    readonly origin: string;
+}
+/**
+ * An attribute as the host draws it: its canonical name and value, `null`
+ * to draw it removed, or a refusal. A value the view sets to `null` (Remote
+ * DOM's removal) is always a removal.
+ */
+export declare function judgeAttribute(namespace: OpenNamespace, element: string, name: string, value: string | null, context: JudgeContext): {
+    readonly name: string;
+    readonly value: string | null;
+    readonly dropped?: readonly OpenRefusal[];
+} | {
+    readonly refused: OpenRefusal;
+};
+//# sourceMappingURL=open-judge.d.ts.map

package/dist/host/open-judge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"open-judge.d.ts","sourceRoot":"","sources":["../../src/host/open-judge.ts"],"names":[],"mappings":"AAaA,OAAO,EAAuC,KAAK,UAAU,EAAE,MAAM,UAAU,CAAC;AAQhF,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,KAAK,CAAC;AAE3C,kDAAkD;AAClD,MAAM,MAAM,iBAAiB;AAC3B,yFAAyF;AACvF,SAAS;AACX,8GAA8G;GAC5G,WAAW;AACb,qGAAqG;GACnG,OAAO;AACT,yFAAyF;GACvF,KAAK;AACP,wGAAwG;GACtG,KAAK;AACP,wCAAwC;GACtC,OAAO;AACT,gFAAgF;GAC9E,QAAQ;AACV,2CAA2C;GACzC,QAAQ,CAAC;AAEb,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;IACnC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,GAAG,CAAC,EAAE,UAAU,CAAC;CAC3B;AAED,qDAAqD;AACrD,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,GAAG;IAAE,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAA;CAAE,CAUxL;AAED,+DAA+D;AAC/D,wBAAgB,cAAc,CAAC,SAAS,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAE9E;AAQD,MAAM,WAAW,YAAY;IAC3B,0FAA0F;IAC1F,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,SAAS,EAAE,aAAa,EACxB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,GAAG,IAAI,EACpB,OAAO,EAAE,YAAY,GACpB;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,WAAW,EAAE,CAAA;CAAE,GAAG;IAAE,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAA;CAAE,CAYzI"}

package/dist/host/open-judge.js

@@ -0,0 +1,95 @@
+import { HTML_DRAWN_AS, HTML_ELEMENTS, OPEN_MAX_ATTRIBUTE, OPEN_MAX_GEOMETRY, OPEN_MAX_IMAGE, REFUSED_ROLES, SVG_ELEMENTS, UNNAMED_ELEMENTS, openAttribute, svgElementName, } from "../open-kit.js";
+import { sanitizeDeclarations, sanitizeValue } from "./css.js";
+/** An element as the host draws it, or a refusal. */
+export function judgeElement(name, parent) {
+    if (parent === "svg") {
+        const canonical = svgElementName(name);
+        return canonical ? { namespace: "svg", name: canonical } : { refused: { reason: "element", element: name } };
+    }
+    const lower = name.toLowerCase();
+    if (lower === "svg")
+        return { namespace: "svg", name: "svg" };
+    if (!Object.prototype.hasOwnProperty.call(HTML_ELEMENTS, lower))
+        return { refused: { reason: "element", element: name } };
+    /* A landmark's or a notice's element is drawn as one with no role of its own (HTML_DRAWN_AS), and says what it was asked to be (`data-graview-as`). */
+    return Object.prototype.hasOwnProperty.call(HTML_DRAWN_AS, lower) ? { namespace: "html", name: HTML_DRAWN_AS[lower], as: lower } : { namespace: "html", name: lower };
+}
+/** Whether an element holds nothing (`img`, `input`, `br`). */
+export function isEmptyElement(namespace, name) {
+    return (namespace === "html" ? HTML_ELEMENTS[name] : SVG_ELEMENTS[name])?.empty === true;
+}
+const NUMBER = /^[+-]?(\d+\.?\d*|\.\d+)([eE][+-]?\d+)?$/;
+/* SVG geometry and transforms: numbers, path letters, commas, brackets and the transform words; never `url`. */
+const GEOMETRY = /^[0-9A-Za-z\s.,+\-%()]*$/;
+const FRAGMENT = /^#[A-Za-z_][A-Za-z0-9_.:-]*$/;
+const DATA_IMAGE = /^data:image\/(png|gif|jpeg|webp|avif|bmp|svg\+xml)(;[A-Za-z0-9=._+-]+)*,/i;
+/**
+ * An attribute as the host draws it: its canonical name and value, `null`
+ * to draw it removed, or a refusal. A value the view sets to `null` (Remote
+ * DOM's removal) is always a removal.
+ */
+export function judgeAttribute(namespace, element, name, value, context) {
+    const found = openAttribute(namespace, element, name);
+    if (!found)
+        return { refused: { reason: "attribute", element, name } };
+    /* A named section is a region landmark: a section is never named, so it stays a section. */
+    if (namespace === "html" && UNNAMED_ELEMENTS[element]?.includes(found.name))
+        return { refused: { reason: "attribute", element, name } };
+    if (value === null)
+        return { name: found.name, value: null };
+    const judged = judgeValue(found.name, found.kind, value, context);
+    if ("refused" in judged)
+        return { refused: { ...judged.refused, element } };
+    /* What the app's chrome and notices speak with stays the app's (ADR 0007: a view never uses the app's bar or notices). */
+    if (found.name === "role" && judged.value.split(/\s+/).some((role) => REFUSED_ROLES.includes(role.toLowerCase())))
+        return { refused: { reason: "value", element, name } };
+    if (found.name === "aria-live" && !["polite", "off"].includes(judged.value.toLowerCase()))
+        return { refused: { reason: "value", element, name } };
+    return { name: found.name, value: judged.value, ...(judged.dropped ? { dropped: judged.dropped.map((css) => ({ reason: css.reason === "url" ? "url" : "css", element, name: found.name, css })) } : {}) };
+}
+function judgeValue(name, kind, value, context) {
+    const refused = (reason, css) => ({ refused: { reason, name, ...(css ? { css } : {}) } });
+    if (kind === "geometry") {
+        if (value.length > OPEN_MAX_GEOMETRY || !GEOMETRY.test(value) || /url/i.test(value))
+            return refused("value");
+        return { value };
+    }
+    if (kind === "image") {
+        if (value.length > OPEN_MAX_IMAGE)
+            return refused("url");
+        if (DATA_IMAGE.test(value))
+            return { value };
+        /* A blob: of the host's own page: it is in the page's memory already, and loading it asks nobody. */
+        if (value.startsWith(`blob:${context.origin}/`) && /^blob:[^\s"'<>]+$/.test(value))
+            return { value };
+        return refused("url");
+    }
+    if (value.length > OPEN_MAX_ATTRIBUTE)
+        return refused("value");
+    if (typeof kind === "object") {
+        const one = kind.oneOf.find((option) => option.toLowerCase() === value.toLowerCase());
+        return one === undefined ? refused("value") : { value: one };
+    }
+    switch (kind) {
+        case "text":
+            return { value };
+        case "number":
+            return NUMBER.test(value.trim()) && Number.isFinite(Number(value)) ? { value: value.trim() } : refused("value");
+        case "boolean":
+            return { value: "" };
+        case "fragment":
+            return FRAGMENT.test(value) ? { value } : refused("url");
+        case "style": {
+            const judged = sanitizeDeclarations(value, OPEN_MAX_ATTRIBUTE);
+            if (judged.refused.length > 0 && judged.css === "")
+                return refused(judged.refused[0].reason === "url" ? "url" : "css", judged.refused[0]);
+            /* What was kept is drawn; what was not is written down beside it. */
+            return { value: judged.css, ...(judged.refused.length > 0 ? { dropped: judged.refused } : {}) };
+        }
+        case "css": {
+            const judged = sanitizeValue(name, value);
+            return "refused" in judged ? refused(judged.refused.reason === "url" ? "url" : "css", judged.refused) : { value: judged.value };
+        }
+    }
+}
+//# sourceMappingURL=open-judge.js.map

package/dist/host/open-judge.js.map

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

package/dist/host/open-render.d.ts

@@ -0,0 +1,32 @@
+import { type JudgeContext, type OpenNamespace, type OpenRefusal } from "./open-judge.js";
+export interface OpenRendererOptions extends JudgeContext {
+    /** The most nodes a view may have drawn at once. 5 000 by default. */
+    readonly maxNodes?: number;
+    /** The view went past `maxNodes`. Called once. */
+    readonly onOverBudget?: () => void;
+    /** An element was made, with its first attributes: the host's chance to set what is its own on it (a button's type, a link's role). */
+    readonly decorate?: (element: Element, name: string, namespace: OpenNamespace) => void;
+    /** An attribute the view gave was drawn, or taken away. */
+    readonly onAttribute?: (element: Element, name: string) => void;
+    /** The view set what a field holds (its `value`, `checked`, `selected`, or a textarea's text): it is no longer what the person typed. */
+    readonly onFieldSet?: (field: Element) => void;
+}
+export interface OpenRenderer {
+    /**
+     * Draw one batch. `spent`, asked between records, says the host's time
+     * for drawing this view has run out: the rest of the batch is not drawn,
+     * and `apply` says false.
+     */
+    apply(records: unknown, spent?: () => boolean): boolean;
+    /** What was refused, oldest first (the last 200). */
+    readonly refused: readonly OpenRefusal[];
+    /** How many nodes are drawn. */
+    readonly size: number;
+    /** The view's id for a node the host drew, for an event to name. */
+    idOf(node: Node): string | undefined;
+    /** The element the host drew for a view's id. */
+    elementOf(id: string): Element | undefined;
+    dispose(): void;
+}
+export declare function createOpenRenderer(into: Node, options: OpenRendererOptions): OpenRenderer;
+//# sourceMappingURL=open-render.d.ts.map

package/dist/host/open-render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"open-render.d.ts","sourceRoot":"","sources":["../../src/host/open-render.ts"],"names":[],"mappings":"AACA,OAAO,EAAgD,KAAK,YAAY,EAAE,KAAK,aAAa,EAAE,KAAK,WAAW,EAAE,MAAM,iBAAiB,CAAC;AA0BxI,MAAM,WAAW,mBAAoB,SAAQ,YAAY;IACvD,sEAAsE;IACtE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,kDAAkD;IAClD,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;IACnC,uIAAuI;IACvI,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,aAAa,KAAK,IAAI,CAAC;IACvF,2DAA2D;IAC3D,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAChE,yIAAyI;IACzI,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CAChD;AAED,MAAM,WAAW,YAAY;IAC3B;;;;OAIG;IACH,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,MAAM,OAAO,GAAG,OAAO,CAAC;IACxD,qDAAqD;IACrD,QAAQ,CAAC,OAAO,EAAE,SAAS,WAAW,EAAE,CAAC;IACzC,gCAAgC;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,oEAAoE;IACpE,IAAI,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,GAAG,SAAS,CAAC;IACrC,iDAAiD;IACjD,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;IAC3C,OAAO,IAAI,IAAI,CAAC;CACjB;AAkBD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,mBAAmB,GAAG,YAAY,CAwMzF"}