@react-x11/components 0.1.0 → 0.2.1

package/dist/html/css/values.js

@@ -0,0 +1,330 @@
+// CSS values: the length model, and the small parsers every property needs.
+//
+// The one decision worth stating is **when a unit resolves**. `em`, `rem`,
+// `pt`, `pc`, `in`, `cm`, `mm`, `ex`, `ch`, `vw` and `vh` all resolve at
+// *computed-style* time — they depend on the element's own font, the root
+// font or the viewport, and all three are known before layout runs. `%` and
+// `auto` do not: they need the containing block, which is layout's to know.
+//
+// That split is what makes a resize cheap. Restyling is the expensive half of
+// the pipeline (selector matching, inheritance, shorthand expansion) and a
+// resize does not need it: nothing in a computed style depends on the width
+// except the percentages, and those were deliberately left unresolved so
+// layout can resolve them against a new containing block on its own.
+//
+// Colours are the other half of that decision, from the other side: they are
+// kept as **strings**, never parsed. ntk's context takes a CSS colour for
+// `fillStyle` and parses it behind its own cache, so parsing here would be
+// work done twice — and the only questions this renderer actually asks about
+// a colour are "is it `transparent`" and "is it `currentColor`", both of
+// which are string comparisons.
+export const AUTO = 'auto';
+export function isPct(len) {
+    return typeof len === 'object';
+}
+/**
+ * A length against a base. `auto` and a percentage of an indefinite base
+ * (`NaN`, which is what an unresolved containing block is) both answer
+ * `fallback` — the caller's "then I decide", which for a width is
+ * shrink-to-fit and for a margin is zero.
+ */
+export function resolve(len, base, fallback = 0) {
+    if (typeof len === 'number')
+        return len;
+    if (len === AUTO)
+        return fallback;
+    return Number.isFinite(base) ? (len.pct / 100) * base : fallback;
+}
+/** Resolve, but keep "indefinite" distinguishable from zero — what a height
+ *  needs, since `height: 50%` of an auto-height parent is not `0`, it is
+ *  "there is no height here". */
+export function resolveOrNull(len, base) {
+    if (typeof len === 'number')
+        return len;
+    if (len === AUTO)
+        return null;
+    return Number.isFinite(base) ? (len.pct / 100) * base : null;
+}
+const LENGTH_RE = /^([+-]?(?:\d+\.?\d*|\.\d+))(px|em|rem|pt|pc|in|cm|mm|ex|ch|vw|vh|vmin|vmax|q|%)?$/;
+/**
+ * Parse a length. Returns `null` for anything that is not one, which is how
+ * every caller tells "the author wrote something else" from "the author wrote
+ * zero" — a distinction `0` cannot carry and which decides whether a
+ * declaration is applied at all.
+ *
+ * A bare number is a length only when `bareIsPx` says so: it is right for a
+ * `width="600"` presentation attribute and wrong for `line-height: 1.5`.
+ */
+export function parseLength(value, ctx, bareIsPx = false) {
+    const v = value.trim().toLowerCase();
+    if (v === 'auto')
+        return AUTO;
+    if (v === '0')
+        return 0;
+    const m = LENGTH_RE.exec(v);
+    if (!m)
+        return null;
+    const n = Number(m[1]);
+    const unit = m[2];
+    if (!unit)
+        return bareIsPx ? n : null;
+    if (unit === '%')
+        return { pct: n };
+    return n * unitScale(unit, ctx);
+}
+function unitScale(unit, ctx) {
+    switch (unit) {
+        case 'px':
+            return 1;
+        case 'em':
+            return ctx.em;
+        case 'rem':
+            return ctx.rem;
+        case 'pt':
+            return 96 / 72;
+        case 'pc':
+            return 16;
+        case 'in':
+            return 96;
+        case 'cm':
+            return 96 / 2.54;
+        case 'mm':
+            return 96 / 25.4;
+        case 'q':
+            return 96 / 101.6;
+        // Approximations rather than font queries: both are within a few percent
+        // for every text face, and asking the font manager here would make the
+        // cascade depend on font loading.
+        case 'ex':
+            return ctx.em * 0.5;
+        case 'ch':
+            return ctx.em * 0.5;
+        case 'vw':
+            return ctx.vw / 100;
+        case 'vh':
+            return ctx.vh / 100;
+        case 'vmin':
+            return Math.min(ctx.vw, ctx.vh) / 100;
+        case 'vmax':
+            return Math.max(ctx.vw, ctx.vh) / 100;
+        default:
+            return 1;
+    }
+}
+/** A plain number — `flex-grow`, `opacity`, `z-index`, `line-height`. */
+export function parseNumber(value) {
+    const n = Number(value.trim());
+    return Number.isFinite(n) ? n : null;
+}
+/** `opacity: 50%` is as legal as `opacity: .5`. */
+export function parseAlpha(value) {
+    const v = value.trim();
+    if (v.endsWith('%')) {
+        const n = Number(v.slice(0, -1));
+        return Number.isFinite(n) ? Math.max(0, Math.min(1, n / 100)) : null;
+    }
+    const n = Number(v);
+    return Number.isFinite(n) ? Math.max(0, Math.min(1, n)) : null;
+}
+/**
+ * Split a value on top-level whitespace, keeping `rgb(1, 2, 3)` and
+ * `url(a b.png)` whole. Every shorthand starts here.
+ */
+export function splitValue(value) {
+    const out = [];
+    let depth = 0;
+    let quote = '';
+    let start = 0;
+    for (let i = 0; i < value.length; i += 1) {
+        const c = value[i];
+        if (quote) {
+            if (c === quote && value[i - 1] !== '\\')
+                quote = '';
+            continue;
+        }
+        if (c === '"' || c === "'") {
+            quote = c;
+        }
+        else if (c === '(') {
+            depth += 1;
+        }
+        else if (c === ')') {
+            depth = Math.max(0, depth - 1);
+        }
+        else if (depth === 0 &&
+            (c === ' ' || c === '\t' || c === '\n' || c === '\r')) {
+            if (i > start)
+                out.push(value.slice(start, i));
+            start = i + 1;
+        }
+    }
+    if (value.length > start)
+        out.push(value.slice(start));
+    return out;
+}
+/** Split on top-level commas — `font-family`, `background`'s layer list. */
+export function splitCommas(value) {
+    const out = [];
+    let depth = 0;
+    let quote = '';
+    let start = 0;
+    for (let i = 0; i < value.length; i += 1) {
+        const c = value[i];
+        if (quote) {
+            if (c === quote && value[i - 1] !== '\\')
+                quote = '';
+            continue;
+        }
+        if (c === '"' || c === "'")
+            quote = c;
+        else if (c === '(')
+            depth += 1;
+        else if (c === ')')
+            depth = Math.max(0, depth - 1);
+        else if (c === ',' && depth === 0) {
+            out.push(value.slice(start, i).trim());
+            start = i + 1;
+        }
+    }
+    out.push(value.slice(start).trim());
+    return out;
+}
+/** The four sides a `margin`/`padding`/`border-width` shorthand expands to,
+ *  in CSS's top-right-bottom-left order. */
+export function fourSides(parts) {
+    const [a, b = a, c = a, d = b] = parts;
+    return [a, b, c, d];
+}
+/** `url(x)`, `url("x")`, or a bare token. `null` for `none`. */
+export function parseUrl(value) {
+    const v = value.trim();
+    if (!v || v.toLowerCase() === 'none')
+        return null;
+    const m = /^url\(\s*(.*?)\s*\)$/i.exec(v);
+    const inner = m ? m[1] : v;
+    return unquote(inner) || null;
+}
+export function unquote(value) {
+    const v = value.trim();
+    if (v.length >= 2 &&
+        (v[0] === '"' || v[0] === "'") &&
+        v[v.length - 1] === v[0]) {
+        return v.slice(1, -1);
+    }
+    return v;
+}
+/** A colour as it is about to be used: `currentColor` resolved against the
+ *  element's own ink, everything else passed through. */
+export function inkColor(color, current) {
+    return color === 'currentColor' ? current : color;
+}
+/** Whether a colour paints anything at all. Two string tests rather than a
+ *  parse, for the reason at the top of the file. */
+export function isTransparent(color) {
+    if (!color)
+        return true;
+    const c = color.trim().toLowerCase();
+    if (c === 'transparent' || c === 'none')
+        return true;
+    // `rgba(…, 0)` / `hsla(…, 0)` — the zero-alpha forms, which pages really
+    // do write for a "no background" that inherits nothing.
+    return /^(?:rgba|hsla)\([^)]*[,/]\s*0*(?:\.0+)?\s*\)$/.test(c);
+}
+/**
+ * A colour token. `null` means the value was not a colour, which is what a
+ * shorthand parser branches on.
+ *
+ * `currentColor` survives as the literal token rather than being substituted:
+ * it means "this element's `color`" at *use* time, and substituting at parse
+ * time freezes whatever the colour happened to be mid-cascade — a rule
+ * writing `border-bottom: 1px solid` and then `color: red` would keep the
+ * inherited ink on its border. `inkColor` is the other half.
+ */
+export function parseColor(value) {
+    const v = value.trim();
+    if (!v)
+        return null;
+    const lower = v.toLowerCase();
+    if (lower === 'currentcolor')
+        return 'currentColor';
+    if (lower === 'transparent')
+        return 'transparent';
+    if (lower === 'inherit' || lower === 'initial' || lower === 'unset')
+        return null;
+    if (v.startsWith('#'))
+        return /^#[0-9a-f]{3,8}$/i.test(v) ? v : null;
+    if (/^(?:rgb|rgba|hsl|hsla|color|lab|lch|oklab|oklch)\(/i.test(v))
+        return v;
+    return NAMED_COLORS.has(lower) ? lower : null;
+}
+/**
+ * The CSS named colours. The list is here rather than reached through ntk's
+ * `parse-color` because the only question asked of it is "is this token a
+ * colour or is it the next keyword in a shorthand" — `border: 1px solid red`
+ * has to tell `solid` from `red` before anything is parsed, and a parser that
+ * answers by throwing is not a predicate.
+ */
+const NAMED_COLORS = new Set(('aliceblue antiquewhite aqua aquamarine azure beige bisque black blanchedalmond blue ' +
+    'blueviolet brown burlywood cadetblue chartreuse chocolate coral cornflowerblue cornsilk ' +
+    'crimson cyan darkblue darkcyan darkgoldenrod darkgray darkgreen darkgrey darkkhaki ' +
+    'darkmagenta darkolivegreen darkorange darkorchid darkred darksalmon darkseagreen ' +
+    'darkslateblue darkslategray darkslategrey darkturquoise darkviolet deeppink deepskyblue ' +
+    'dimgray dimgrey dodgerblue firebrick floralwhite forestgreen fuchsia gainsboro ghostwhite ' +
+    'gold goldenrod gray green greenyellow grey honeydew hotpink indianred indigo ivory khaki ' +
+    'lavender lavenderblush lawngreen lemonchiffon lightblue lightcoral lightcyan ' +
+    'lightgoldenrodyellow lightgray lightgreen lightgrey lightpink lightsalmon lightseagreen ' +
+    'lightskyblue lightslategray lightslategrey lightsteelblue lightyellow lime limegreen linen ' +
+    'magenta maroon mediumaquamarine mediumblue mediumorchid mediumpurple mediumseagreen ' +
+    'mediumslateblue mediumspringgreen mediumturquoise mediumvioletred midnightblue mintcream ' +
+    'mistyrose moccasin navajowhite navy oldlace olive olivedrab orange orangered orchid ' +
+    'palegoldenrod palegreen paleturquoise palevioletred papayawhip peachpuff peru pink plum ' +
+    'powderblue purple rebeccapurple red rosybrown royalblue saddlebrown salmon sandybrown ' +
+    'seagreen seashell sienna silver skyblue slateblue slategray slategrey snow springgreen ' +
+    'steelblue tan teal thistle tomato turquoise violet wheat white whitesmoke yellow ' +
+    'yellowgreen').split(' '));
+/** `font-weight`, as the number ntk's font matcher wants. */
+export function parseWeight(value, inherited) {
+    const v = value.trim().toLowerCase();
+    switch (v) {
+        case 'normal':
+            return 400;
+        case 'bold':
+            return 700;
+        // Relative weights are relative to the *parent's* computed weight, which
+        // is why this takes it rather than reading a constant.
+        case 'bolder':
+            return inherited >= 600 ? 900 : inherited >= 400 ? 700 : 400;
+        case 'lighter':
+            return inherited >= 700 ? 400 : inherited >= 500 ? 300 : 100;
+        default: {
+            const n = Number(v);
+            return Number.isFinite(n) ? Math.max(1, Math.min(1000, n)) : inherited;
+        }
+    }
+}
+/** Absolute and relative `font-size` keywords, against the CSS scale. */
+export function keywordFontSize(value, parentSize, rootSize) {
+    switch (value.trim().toLowerCase()) {
+        case 'xx-small':
+            return rootSize * 0.5625;
+        case 'x-small':
+            return rootSize * 0.625;
+        case 'small':
+            return rootSize * 0.8125;
+        case 'medium':
+            return rootSize;
+        case 'large':
+            return rootSize * 1.125;
+        case 'x-large':
+            return rootSize * 1.5;
+        case 'xx-large':
+            return rootSize * 2;
+        case 'smaller':
+            return parentSize / 1.2;
+        case 'larger':
+            return parentSize * 1.2;
+        default:
+            return null;
+    }
+}
+//# sourceMappingURL=values.js.map

package/dist/html/css/values.js.map

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

package/dist/html/dom.d.ts

@@ -0,0 +1,112 @@
+import { Element, Text } from 'domhandler';
+import type { AnyNode, ChildNode, Document, ParentNode } from 'domhandler';
+export type { AnyNode, ChildNode, Document, ParentNode } from 'domhandler';
+export { Element, Text, Comment } from 'domhandler';
+/** Never rendered, whatever the stylesheet says. `<script>` and `<style>`
+ *  are consumed by the seams instead; the rest have no visual box in the
+ *  subset this renders. */
+export declare const NON_RENDERED: Set<string>;
+/** An element's tag name, lowercased — htmlparser2 already lowercases in
+ *  HTML mode, so this is the assertion rather than the work. */
+export declare function tagOf(node: AnyNode): string;
+export declare function isElement(node: AnyNode | null | undefined): node is Element;
+export declare function isText(node: AnyNode | null | undefined): node is Text;
+/** Children of a node, or an empty array for a leaf. Cheaper than domutils'
+ *  guard chain on the hot path, and it is the only traversal shape the
+ *  styler and the box builder need. */
+export declare function childrenOf(node: AnyNode): ChildNode[];
+/** Attribute read, case-insensitively, or `undefined`. */
+export declare function attr(el: Element, name: string): string | undefined;
+/** The text under a node, uncollapsed — what `<style>` hands the CSS parser
+ *  and what a `<script>` seam is given. */
+export declare function rawTextOf(node: AnyNode): string;
+/**
+ * Walk elements in document order. The styler, the resource sweep and the
+ * script sweep are all one pass over this.
+ *
+ * An explicit stack, and it has to be: the parser builds a tree of any depth
+ * without recursing (htmlparser2 is a state machine), so the first thing to
+ * die on a degenerately nested document would otherwise be this walk — and a
+ * `yield*` chain is the worst recursion there is, costing a resume per level
+ * per element (a walk of 1,000 nested divs measured 16ms as a generator and
+ * rounds to zero as a loop).
+ */
+export declare function elementsIn(root: AnyNode): Generator<Element>;
+/** What the document told the host about itself while parsing. */
+export interface DocumentFacts {
+    /** `<style>` text and `<link rel=stylesheet>` hrefs, in document order —
+     *  order is the cascade's tie-breaker, so it is data, not a detail. */
+    sheets: SheetRef[];
+    /** Every `<script>`, for the seam. Never parsed and never evaluated. */
+    scripts: Element[];
+    /** Elements with a resource to fetch — `<img>`, and `<link>` above. */
+    resources: Element[];
+    /** `<title>`, when the document had one. */
+    title: string | null;
+}
+export type SheetRef = {
+    kind: 'inline';
+    text: string;
+    element: Element;
+} | {
+    kind: 'link';
+    href: string;
+    element: Element;
+};
+/**
+ * A document being parsed. Feed it source; read `document` at any time.
+ *
+ * `write` is append-only by design: handed a `source` that starts with what
+ * was already written, it writes the delta and the existing nodes keep their
+ * identity — which is what lets the box tree, the computed styles and the
+ * laid-out lines above it survive a streaming append. A `source` that is not
+ * an extension resets the parser, because a mid-document edit can change the
+ * tree arbitrarily and pretending otherwise is how a streaming renderer
+ * shows a document nobody wrote.
+ */
+export declare class HtmlSource {
+    /** The tree, live: it grows as chunks are written. */
+    document: Document;
+    /** Bumped whenever the tree changed — the styler's cache key. */
+    revision: number;
+    /** True once `end()` has been called and the tree is final. */
+    complete: boolean;
+    private _parser;
+    private _handler;
+    private _written;
+    private _facts;
+    constructor();
+    /** Set the whole source. Appends when it can; re-parses when it cannot. */
+    setSource(source: string, complete: boolean): boolean;
+    /** Start over — a source that is not an extension of what was written. */
+    reset(): void;
+    /** The DOM changed under us — an app mutated it, or a stylesheet arrived
+     *  and was spliced in. Anything cached on the old revision is stale. */
+    touch(): void;
+    /**
+     * What the document says about its own resources, scripts and stylesheets.
+     * One pass, memoized against `revision`, because all three consumers ask
+     * on the same tick and a document of any size is not worth walking thrice.
+     */
+    facts(): DocumentFacts;
+    /** Release the parser. The tree stays readable — an app may still hold it. */
+    destroy(): void;
+}
+/** Append `child` to `parent`, unlinking it from wherever it was. */
+export declare function appendChild(parent: ParentNode, child: ChildNode): void;
+/** Unlink a node from its parent. Safe on a node that has none. */
+export declare function removeNode(node: ChildNode): void;
+/** Replace `node` with `next`, in place. */
+export declare function replaceNode(node: ChildNode, next: ChildNode): void;
+/** Build an element, for an app writing into the document. */
+export declare function createElement(name: string, attribs?: Record<string, string>, children?: ChildNode[]): Element;
+/** Build a text node. */
+export declare function createText(data: string): Text;
+/** Parse a fragment into nodes an app can splice in — `innerHTML`, without
+ *  the element to hang it off. Not streaming: a fragment is small by
+ *  definition, and an app calling this already has the whole string. */
+export declare function parseFragment(html: string): ChildNode[];
+/** Whether a tag's content is raw text — the box builder skips these, and
+ *  `<textarea>`'s value comes from it rather than from a child box. */
+export declare function isRawText(tag: string): boolean;
+//# sourceMappingURL=dom.d.ts.map

package/dist/html/dom.d.ts.map

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