@graview/guest 0.1.9 → 0.1.12

package/dist/headless/tree.js

@@ -0,0 +1,128 @@
+/*
+ * A TREE WITH NO DOM (FR-95).
+ *
+ * What the open kit's renderer (host/open-render.ts) draws into, when there
+ * is no page: the handful of DOM calls it makes — createElementNS,
+ * createTextNode, createComment, setAttribute, removeAttribute,
+ * insertBefore, appendChild, removeChild — over plain objects, and what a
+ * describer reads back: each element's name, namespace, attributes and
+ * children, and a field's live value. Nothing here runs anything, loads
+ * anything, or lays anything out.
+ */
+export const HTML_NAMESPACE = "http://www.w3.org/1999/xhtml";
+export class TreeNode {
+    ownerDocument;
+    parentNode = null;
+    childNodes = [];
+    constructor(ownerDocument) {
+        this.ownerDocument = ownerDocument;
+    }
+    get firstChild() {
+        return this.childNodes[0] ?? null;
+    }
+    get parentElement() {
+        return this.parentNode instanceof TreeElement ? this.parentNode : null;
+    }
+    get textContent() {
+        return this.childNodes.map((child) => child.textContent).join("");
+    }
+    insertBefore(child, before) {
+        if (child.parentNode)
+            child.parentNode.removeChild(child);
+        const at = before ? this.childNodes.indexOf(before) : -1;
+        if (at < 0)
+            this.childNodes.push(child);
+        else
+            this.childNodes.splice(at, 0, child);
+        child.parentNode = this;
+        return child;
+    }
+    appendChild(child) {
+        return this.insertBefore(child, null);
+    }
+    removeChild(child) {
+        const at = this.childNodes.indexOf(child);
+        if (at >= 0)
+            this.childNodes.splice(at, 1);
+        child.parentNode = null;
+        return child;
+    }
+}
+export class TreeText extends TreeNode {
+    data;
+    nodeType = 3;
+    constructor(owner, data) {
+        super(owner);
+        this.data = data;
+    }
+    get textContent() {
+        return this.data;
+    }
+}
+export class TreeComment extends TreeNode {
+    nodeType = 8;
+    get textContent() {
+        return "";
+    }
+}
+export class TreeElement extends TreeNode {
+    namespaceURI;
+    localName;
+    nodeType = 1;
+    attributes = new Map();
+    /* A field's live state, as a page keeps it beside its attributes. */
+    value = "";
+    checked = false;
+    selected = false;
+    constructor(owner, namespaceURI, localName) {
+        super(owner);
+        this.namespaceURI = namespaceURI;
+        this.localName = localName;
+    }
+    setAttribute(name, value) {
+        this.attributes.set(name, String(value));
+    }
+    removeAttribute(name) {
+        this.attributes.delete(name);
+    }
+    getAttribute(name) {
+        return this.attributes.get(name) ?? null;
+    }
+    hasAttribute(name) {
+        return this.attributes.has(name);
+    }
+    /** The nearest element by local name, this one or above: all the renderer asks of `closest`. */
+    closest(name) {
+        for (let at = this; at; at = at.parentElement)
+            if (at.localName === name)
+                return at;
+        return null;
+    }
+}
+export class TreeDocument extends TreeNode {
+    nodeType = 9;
+    constructor() {
+        super(null);
+    }
+    createElementNS(namespace, name) {
+        return new TreeElement(this, namespace, name);
+    }
+    createElement(name) {
+        return new TreeElement(this, HTML_NAMESPACE, name);
+    }
+    createTextNode(data) {
+        return new TreeText(this, data);
+    }
+    createComment(_data) {
+        return new TreeComment(this);
+    }
+}
+/** A document of its own, and the element a view's drawing is drawn under. */
+export function createTree() {
+    const document = new TreeDocument();
+    const root = document.createElement("div");
+    root.setAttribute("data-graview-view-root", "");
+    document.appendChild(root);
+    return { document, root };
+}
+//# sourceMappingURL=tree.js.map

package/dist/headless/tree.js.map

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

package/dist/host/css.d.ts

@@ -0,0 +1,118 @@
+export type Token = {
+    readonly type: "whitespace";
+} | {
+    readonly type: "ident";
+    readonly value: string;
+} | {
+    readonly type: "function";
+    readonly value: string;
+} | {
+    readonly type: "at-keyword";
+    readonly value: string;
+} | {
+    readonly type: "hash";
+    readonly value: string;
+    readonly id: boolean;
+} | {
+    readonly type: "string";
+    readonly value: string;
+} | {
+    readonly type: "bad-string";
+} | {
+    readonly type: "url";
+    readonly value: string;
+} | {
+    readonly type: "bad-url";
+} | {
+    readonly type: "delim";
+    readonly value: string;
+} | {
+    readonly type: "number";
+    readonly repr: string;
+} | {
+    readonly type: "percentage";
+    readonly repr: string;
+} | {
+    readonly type: "dimension";
+    readonly repr: string;
+    readonly unit: string;
+} | {
+    readonly type: "CDO";
+} | {
+    readonly type: "CDC";
+} | {
+    readonly type: ":" | ";" | "," | "[" | "]" | "(" | ")" | "{" | "}";
+};
+/** CSS Syntax §4: the tokens of a stylesheet, a declaration list or a value. Comments are consumed and dropped. */
+export declare function tokenize(input: string): Token[];
+export type ComponentValue = Token | {
+    readonly type: "func";
+    readonly name: string;
+    readonly value: ComponentValue[];
+} | {
+    readonly type: "block";
+    readonly open: "{" | "[" | "(";
+    readonly value: ComponentValue[];
+};
+export type Rule = {
+    readonly type: "at-rule";
+    readonly name: string;
+    readonly prelude: ComponentValue[];
+    readonly block?: ComponentValue[];
+} | {
+    readonly type: "qualified";
+    readonly prelude: ComponentValue[];
+    readonly block: ComponentValue[];
+};
+export interface Declaration {
+    readonly type: "declaration";
+    readonly name: string;
+    readonly value: ComponentValue[];
+    readonly important: boolean;
+}
+/** CSSOM's "serialize an identifier". */
+export declare function serializeIdent(value: string): string;
+/** A string, quoted, with nothing in it that could end the quote, the line or a `<style>`. */
+export declare function serializeString(value: string): string;
+/** Component values as text, with whitespace runs made one space and a comment wherever two tokens would run together. */
+export declare function serializeValues(values: readonly ComponentValue[]): string;
+/** Why part of a view's CSS was not kept. */
+export type CssRefusalReason = 
+/** An at-rule outside `CSS_AT_RULES` (`@import`, `@font-face`, `@namespace`, …). */
+"at-rule"
+/** A property outside `CSS_PROPERTIES`. */
+ | "property"
+/** A `url()` that is not `url(#id)` on a paint. */
+ | "url"
+/** A function outside `CSS_FUNCTIONS` (`image-set()`, `attr()`, `expression()`, …). */
+ | "function"
+/** A value a property held to keywords may not take (`position: fixed`). */
+ | "value"
+/** A selector that reaches past the view's own tree (`:host`, `::slotted`). */
+ | "selector"
+/** Something the parser could not read: a bad string or url, a rule with no block, nesting past its depth. */
+ | "unreadable"
+/** More CSS than a view may give. */
+ | "size";
+export interface CssRefusal {
+    readonly reason: CssRefusalReason;
+    /** The at-rule, property, function or selector refused. */
+    readonly name?: string;
+}
+export interface SanitizedCss {
+    /** What may be drawn, written afresh from what was judged. */
+    readonly css: string;
+    /** What was not kept, in the order it was met. */
+    readonly refused: readonly CssRefusal[];
+}
+/** A VIEW'S STYLESHEET, judged: what may be drawn of it, and what was refused. */
+export declare function sanitizeStylesheet(css: string, maxLength?: number): SanitizedCss;
+/** A `style` attribute, judged: declarations only. */
+export declare function sanitizeDeclarations(css: string, maxLength?: number): SanitizedCss;
+/** One value for one property (an SVG presentation attribute), judged. */
+export declare function sanitizeValue(property: string, value: string): {
+    readonly value: string;
+} | {
+    readonly refused: CssRefusal;
+};
+//# sourceMappingURL=css.d.ts.map

package/dist/host/css.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"css.d.ts","sourceRoot":"","sources":["../../src/host/css.ts"],"names":[],"mappings":"AAyCA,MAAM,MAAM,KAAK,GACb;IAAE,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAA;CAAE,GAC/B;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAClD;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACrD;IAAE,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACvD;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAA;CAAE,GACvE;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACnD;IAAE,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAA;CAAE,GAC/B;IAAE,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAChD;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;CAAE,GAC5B;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAClD;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAClD;IAAE,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACtD;IAAE,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC5E;IAAE,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAA;CAAE,GACxB;IAAE,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAA;CAAE,GACxB;IAAE,QAAQ,CAAC,IAAI,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAA;CAAE,CAAC;AA6B3E,mHAAmH;AACnH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,EAAE,CAuP/C;AAID,MAAM,MAAM,cAAc,GACtB,KAAK,GACL;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,cAAc,EAAE,CAAA;CAAE,GAClF;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,cAAc,EAAE,CAAA;CAAE,CAAC;AA4CjG,MAAM,MAAM,IAAI,GACZ;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,cAAc,EAAE,CAAC;IAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,cAAc,EAAE,CAAA;CAAE,GAC1H;IAAE,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,cAAc,EAAE,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,cAAc,EAAE,CAAA;CAAE,CAAC;AAEzG,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,cAAc,EAAE,CAAC;IACjC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;CAC7B;AAoID,yCAAyC;AACzC,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAWpD;AAcD,8FAA8F;AAC9F,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAUrD;AA+FD,0HAA0H;AAC1H,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,cAAc,EAAE,GAAG,MAAM,CAUzE;AAID,6CAA6C;AAC7C,MAAM,MAAM,gBAAgB;AAC1B,oFAAoF;AAClF,SAAS;AACX,2CAA2C;GACzC,UAAU;AACZ,mDAAmD;GACjD,KAAK;AACP,uFAAuF;GACrF,UAAU;AACZ,4EAA4E;GAC1E,OAAO;AACT,+EAA+E;GAC7E,UAAU;AACZ,8GAA8G;GAC5G,YAAY;AACd,qCAAqC;GACnC,MAAM,CAAC;AAEX,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAClC,2DAA2D;IAC3D,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAgQD,MAAM,WAAW,YAAY;IAC3B,8DAA8D;IAC9D,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,kDAAkD;IAClD,QAAQ,CAAC,OAAO,EAAE,SAAS,UAAU,EAAE,CAAC;CACzC;AAED,kFAAkF;AAClF,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,SAAsB,GAAG,YAAY,CAQ7F;AAED,sDAAsD;AACtD,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,SAAsB,GAAG,YAAY,CAc/F;AAED,0EAA0E;AAC1E,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG;IAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAA;CAAE,CAK5H"}