@react-x11/components 0.9.0 → 0.11.0

package/dist/html/css/calc.js

@@ -0,0 +1,344 @@
+// `calc()`, `min()`, `max()` and `clamp()` (CSS Values 4 10), read down to
+// what a length here can hold: device pixels, or a percentage of what
+// layout knows with pixels added (`Pct.px`) — every `calc()` that adds and
+// scales, which is what documents write: `calc(100% - 2em)`. A comparison
+// with a percentage in it, `min(100%, 600px)`, is a different sum at every
+// width, and is kept as one (`Pct.of`) for layout to resolve; sums and
+// scales distribute into it, so `calc(min(100%, 600px) - 2rem)` is
+// `min(100% - 2rem, 600px - 2rem)`.
+/**
+ * A math function's value as a length, or null where it is none — a
+ * number, a type that does not add up, a division by zero. `dimension`
+ * reads one `10px` or `2em` as this package's lengths do.
+ */
+export function parseMath(value, dimension) {
+    const term = parseTerm(value, dimension);
+    if (!term || !isLength(term))
+        return null;
+    return toLen(term);
+}
+/** A math function's value as a number (`calc(1 + 0.5)`), or null. */
+export function parseMathNumber(value) {
+    const term = parseTerm(value, () => null);
+    if (!term || term.kind !== 'linear' || term.length)
+        return null;
+    return censor(term.px);
+}
+function parseTerm(value, dimension) {
+    const tokens = tokenize(value);
+    if (!tokens)
+        return null;
+    const parser = new Parser(tokens, dimension);
+    const term = parser.value();
+    return term && parser.pos === tokens.length ? term : null;
+}
+function isLength(term) {
+    return term.kind === 'linear' ? term.length : true;
+}
+function toLen(term) {
+    if (term.kind === 'compare') {
+        const args = [];
+        for (const arg of term.args) {
+            const len = toLen(arg);
+            if (len === null)
+                return null;
+            args.push(len);
+        }
+        return { pct: 0, of: { max: term.max, args } };
+    }
+    if (!term.hasPct)
+        return censor(term.px);
+    return { pct: censor(term.pct), px: censor(term.px) };
+}
+const NUMBER = /^[+-]?(?:\d*\.\d+|\d+)(?:e[+-]?\d+)?/;
+const CONSTANT = /^(?:-?infinity|nan|pi|e)(?![a-z0-9_(-])/;
+const CONSTANTS = {
+    infinity: Infinity,
+    '-infinity': -Infinity,
+    nan: NaN,
+    pi: Math.PI,
+    e: Math.E,
+};
+/**
+ * What a calculation that is no finite number comes to (CSS Values 4,
+ * 10.9): NaN is 0, and an infinity the largest length there is — which,
+ * as in a browser, is still a length: a radius of it is a pill.
+ */
+function censor(n) {
+    if (Number.isNaN(n))
+        return 0;
+    if (n === Infinity)
+        return LARGEST;
+    if (n === -Infinity)
+        return -LARGEST;
+    return n;
+}
+/** The largest length a browser holds, 2^25 pixels less a little: what a
+ *  calculation's infinity comes to, and what any length is kept within
+ *  (`parseLength`, `resolve`). */
+export const LARGEST = 33554428;
+function tokenize(text) {
+    const out = [];
+    let i = 0;
+    while (i < text.length) {
+        const c = text[i];
+        if (c === ' ' || c === '\t' || c === '\n' || c === '\r' || c === '\f') {
+            while (i < text.length && /[ \t\n\r\f]/.test(text[i]))
+                i += 1;
+            if (out.length && out[out.length - 1].t !== 'space') {
+                out.push({ t: 'space' });
+            }
+            continue;
+        }
+        if (c === '(') {
+            out.push({ t: 'open', fn: '' });
+            i += 1;
+            continue;
+        }
+        if (c === ')' || c === ',') {
+            if (out.length && out[out.length - 1].t === 'space')
+                out.pop();
+            out.push(c === ')' ? { t: 'close' } : { t: 'comma' });
+            i += 1;
+            continue;
+        }
+        if (c === '*' || c === '/') {
+            out.push({ t: 'op', value: c });
+            i += 1;
+            continue;
+        }
+        // a sign belongs to the number after it, as the tokenizer reads it:
+        // `1px -2px` is two values, and `1px - 2px` a difference
+        const m = NUMBER.exec(text.slice(i));
+        if (m) {
+            i += m[0].length;
+            const unit = /^(?:%|[a-z]+)/.exec(text.slice(i))?.[0] ?? '';
+            i += unit.length;
+            out.push({ t: 'num', value: Number(m[0]), unit });
+            continue;
+        }
+        const name = /^-?[a-z][a-z0-9-]*\(/.exec(text.slice(i))?.[0];
+        if (name) {
+            out.push({ t: 'open', fn: name.slice(0, -1) });
+            i += name.length;
+            continue;
+        }
+        // the numbers CSS Values 4 names (10.7.1): Tailwind 4 writes a pill's
+        // radius as `calc(infinity * 1px)`
+        const constant = CONSTANT.exec(text.slice(i))?.[0];
+        if (constant) {
+            out.push({ t: 'num', value: CONSTANTS[constant], unit: '' });
+            i += constant.length;
+            continue;
+        }
+        if (c === '+' || c === '-') {
+            out.push({ t: 'op', value: c });
+            i += 1;
+            continue;
+        }
+        return null;
+    }
+    return out;
+}
+class Parser {
+    tokens;
+    dimension;
+    pos = 0;
+    constructor(tokens, dimension) {
+        this.tokens = tokens;
+        this.dimension = dimension;
+    }
+    peek() {
+        return this.tokens[this.pos];
+    }
+    skipSpace() {
+        if (this.peek()?.t === 'space')
+            this.pos += 1;
+    }
+    /** A whole math function, `calc(…)` and the rest. */
+    value() {
+        this.skipSpace();
+        const open = this.peek();
+        if (open?.t !== 'open' || !open.fn)
+            return null;
+        const term = this.fn();
+        this.skipSpace();
+        return term;
+    }
+    fn() {
+        const open = this.tokens[this.pos];
+        this.pos += 1;
+        const fn = open.fn.replace(/^-webkit-/, '');
+        const args = [];
+        for (;;) {
+            const sum = this.sum();
+            if (!sum)
+                return null;
+            args.push(sum);
+            const next = this.peek();
+            if (next?.t === 'comma') {
+                this.pos += 1;
+                continue;
+            }
+            if (next?.t !== 'close')
+                return null;
+            this.pos += 1;
+            break;
+        }
+        switch (fn) {
+            case '':
+            case 'calc':
+                return args.length === 1 ? args[0] : null;
+            case 'min':
+            case 'max':
+                return compare(args, fn === 'max');
+            case 'clamp': {
+                if (args.length !== 3)
+                    return null;
+                const upper = compare([args[1], args[2]], false);
+                return upper && compare([args[0], upper], true);
+            }
+            default:
+                return null;
+        }
+    }
+    sum() {
+        this.skipSpace();
+        let left = this.product();
+        if (!left)
+            return null;
+        for (;;) {
+            const at = this.pos;
+            // `+` and `-` need white space on both sides
+            if (this.peek()?.t !== 'space')
+                break;
+            this.pos += 1;
+            const op = this.peek();
+            if (op?.t !== 'op' || (op.value !== '+' && op.value !== '-')) {
+                this.pos = at;
+                break;
+            }
+            this.pos += 1;
+            if (this.peek()?.t !== 'space')
+                return null;
+            this.pos += 1;
+            const right = this.product();
+            if (!right)
+                return null;
+            left = add(left, right, op.value === '+' ? 1 : -1);
+            if (!left)
+                return null;
+        }
+        this.skipSpace();
+        return left;
+    }
+    product() {
+        let left = this.unit();
+        if (!left)
+            return null;
+        for (;;) {
+            const at = this.pos;
+            this.skipSpace();
+            const op = this.peek();
+            if (op?.t !== 'op' || (op.value !== '*' && op.value !== '/')) {
+                this.pos = at;
+                return left;
+            }
+            this.pos += 1;
+            this.skipSpace();
+            const right = this.unit();
+            if (!right)
+                return null;
+            if (op.value === '*') {
+                // one side a number, which scales the other
+                if (isNumber(left))
+                    left = scale(right, left.px);
+                else if (isNumber(right))
+                    left = scale(left, right.px);
+                else
+                    return null;
+            }
+            else {
+                if (!isNumber(right) || right.px === 0)
+                    return null;
+                left = scale(left, 1 / right.px);
+            }
+        }
+    }
+    unit() {
+        const token = this.peek();
+        if (!token)
+            return null;
+        if (token.t === 'open')
+            return this.fn();
+        if (token.t !== 'num')
+            return null;
+        this.pos += 1;
+        if (token.unit === '')
+            return linear(false, token.value, 0, false);
+        if (token.unit === '%')
+            return linear(true, 0, token.value, true);
+        const px = this.dimension(`${token.value}${token.unit}`);
+        return px === null ? null : linear(true, px, 0, false);
+    }
+}
+function linear(length, px, pct, hasPct) {
+    return { kind: 'linear', length, px, pct, hasPct };
+}
+function isNumber(term) {
+    return term.kind === 'linear' && !term.length;
+}
+/** `a + b`, or `a - b` for a sign of -1, distributed into a comparison. */
+function add(a, b, sign) {
+    if (isLength(a) !== isLength(b))
+        return null;
+    if (a.kind === 'compare') {
+        const args = [];
+        for (const arg of a.args) {
+            const sum = add(arg, b, sign);
+            if (!sum)
+                return null;
+            args.push(sum);
+        }
+        return { kind: 'compare', max: a.max, args };
+    }
+    if (b.kind === 'compare') {
+        // `a - min(x, y)` is `max(a - x, a - y)`
+        const args = [];
+        for (const arg of b.args) {
+            const sum = add(a, arg, sign);
+            if (!sum)
+                return null;
+            args.push(sum);
+        }
+        return { kind: 'compare', max: sign === 1 ? b.max : !b.max, args };
+    }
+    return linear(a.length, a.px + sign * b.px, a.pct + sign * b.pct, a.hasPct || b.hasPct);
+}
+/** `term * k`, distributed into a comparison, which a negative `k` turns
+ *  over. */
+function scale(term, k) {
+    if (term.kind === 'compare') {
+        return {
+            kind: 'compare',
+            max: k < 0 ? !term.max : term.max,
+            args: term.args.map((arg) => scale(arg, k)),
+        };
+    }
+    // nought stays nought, so that an infinity scaling a length is not also
+    // a NaN of the percentage it has none of
+    return linear(term.length, term.px === 0 ? 0 : term.px * k, term.pct === 0 ? 0 : term.pct * k, term.hasPct);
+}
+/** `min()` or `max()` of terms of one type: a number where no percentage
+ *  is among them, and a comparison for layout where one is. */
+function compare(args, max) {
+    const length = isLength(args[0]);
+    if (args.some((a) => isLength(a) !== length))
+        return null;
+    if (args.every((a) => a.kind === 'linear' && !a.hasPct)) {
+        const values = args.map((a) => a.px);
+        return linear(length, max ? Math.max(...values) : Math.min(...values), 0, false);
+    }
+    return { kind: 'compare', max, args };
+}
+//# sourceMappingURL=calc.js.map

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

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

package/dist/html/css/cascade.d.ts

@@ -1,19 +1,93 @@
 import type { Element } from 'domhandler';
 import type { Stylesheet } from './parse.js';
 import type { ComputedStyle, RootLook } from './style.js';
+import type { FontFamilies } from '../fonts.js';
+import { CounterStyles } from './counter-styles.js';
+/** A style handed to every element with the same sharing key, and the key
+ *  that element's children share under (`Cascade.sharedStyleFor`). */
+export interface SharedStyle {
+    style: ComputedStyle;
+    key: number;
+}
+/**
+ * The compounds of a selector that test `:hover`, each without it (and
+ * without an `:active` beside it), and whether one is followed by a sibling
+ * combinator, which reaches the element's later siblings. `nested` where a
+ * `:hover` sits inside a functional pseudo-class — `:not(:hover)`,
+ * `:is(:hover)` — and reaches elements no compound names.
+ *
+ * A `:hover` in a compound's `:has()` is the one exception, since what it
+ * reaches is known: the compound, without its `:has()`, is an ancestor of
+ * the element the pointer is over — or an earlier sibling of it or of an
+ * ancestor, where the argument starts at a sibling (Selectors 4, 4.5). So
+ * it is given as an anchor (`has`) rather than making the rule `nested`.
+ *
+ * `:active` is not the pointer's here: nothing sets it (`setPointer` is
+ * handed none), so a selector that tests only it never changes as the
+ * pointer moves — Wikipedia's buttons' `:focus:not(:active)` among them.
+ * A press that sets it would have to be counted here too.
+ */
+export declare function pointerCompounds(selector: string): {
+    compounds: string[];
+    siblings: boolean;
+    nested: boolean;
+    has: {
+        anchor: string;
+        siblings: boolean;
+    }[];
+};
+/** What `Cascade.firstLetterRules` found for an element. */
+export interface FirstLetterRules {
+    readonly el: Element;
+    readonly candidates: readonly unknown[];
+}
 /** What the pointer is over, for `:hover`. A chain rather than one element,
  *  because `li:hover a` has to light up while the pointer is on the `li`. */
 export interface PointerState {
     hovered: ReadonlySet<Element>;
     active: ReadonlySet<Element>;
 }
+/**
+ * The face a style's font-relative units are measured in: its family list,
+ * size, weight and slant, the four that pick one. A family's faces can be
+ * different fonts altogether — a page's `@font-face` rules may set its
+ * bold in another file — so an `ex` in bold text is the bold face's.
+ */
+export interface MetricFace {
+    family: string;
+    size: number;
+    weight: number;
+    style: ComputedStyle['fontStyle'];
+}
+/** What a face measures, where the fonts can say. */
+export type FaceMetric = (face: MetricFace) => number | null;
 /**
  * A cascade over a fixed set of stylesheets. Rebuilt when the sheets change;
  * re-run when the DOM, the viewport band or the pointer state does.
  */
 export declare class Cascade {
     private _index;
+    /** The rules for pseudo-elements, kept apart: they never style the
+     *  element itself, and a document with none of them asks nothing. */
+    private _pseudo;
     private _adapter;
+    /** The compounds of the selectors that test the pointer, each without
+     *  its `:hover` or `:active` (`pointerCompounds`), and their matchers,
+     *  compiled when a pointer move first asks (`hoverTouches`). */
+    private _hoverCompounds;
+    private _hoverMatchers;
+    /** Whether a pointer move can be restyled where it happened
+     *  (`HtmlViewNode._hoverInPlace`): false where a selector tests the
+     *  pointer inside a functional pseudo-class, which reaches elements no
+     *  compound names. */
+    hoverLocal: boolean;
+    /** Whether a compound that tests the pointer is followed by a sibling
+     *  combinator, so an element's later siblings restyle with it. */
+    hoverSiblings: boolean;
+    /** The compounds whose `:has()` tests the pointer, each without it, and
+     *  whether its argument starts at a sibling (`hoverAnchors`). */
+    private _hoverAnchors;
+    private _anchorMatchers;
     private _pointer;
     readonly initial: ComputedStyle;
     readonly look: RootLook;
@@ -27,20 +101,180 @@ export declare class Cascade {
     /** Every width at which some `@media` rule changes its mind, in CSS
      *  pixels — the unit the author wrote them in. */
     readonly breakpoints: number[];
-    constructor(sheets: Stylesheet[], look: RootLook, viewportWidth: number, viewportHeight: number, scale?: number);
+    /** The counter styles the sheets define, over the predefined ones. */
+    readonly counterStyles: CounterStyles;
+    /** A face's x-height, for `ex`, where the fonts can say. */
+    private _xHeightOf;
+    private _xHeights;
+    /** The advance of a face's "0", for `ch`, likewise. */
+    private _zeroWidthOf;
+    private _zeroWidths;
+    /** A face's own line height, for `lh` where `line-height` is `normal`,
+     *  likewise. */
+    private _normalLineOf;
+    private _normalLines;
+    /** Whether any declaration sets a custom property or reads one: without
+     *  one, no element's style asks about them. */
+    private _vars;
+    /** Whether any declaration is in a unit of the viewport's width — `vw`,
+     *  `vmin`, `vmax` — or of its height, `vh` and the same two: a style
+     *  holds such a length as a number, so it is computed again when that
+     *  side of the viewport moves (`HtmlViewNode._update`). */
+    readsViewportWidth: boolean;
+    readsViewportHeight: boolean;
+    /** The families the document loads itself (`fonts.ts`), or null for a
+     *  document with no `@font-face`. */
+    private _families;
+    private _mapFamilies;
+    /** Whether any declaration has a length in `lh` or `rlh`: only then is
+     *  the line height settled ahead of the declarations that read it. */
+    private _lh;
+    constructor(sheets: Stylesheet[], look: RootLook, viewportWidth: number, viewportHeight: number, scale?: number, xHeight?: FaceMetric | null, zeroWidth?: FaceMetric | null, normalLine?: FaceMetric | null, families?: FontFamilies | null);
+    /** Whether declarations read the viewport's width or height (`vw`,
+     *  `vh`, `vmin`, `vmax`), noted on the cascade. */
+    private _noteViewportUnits;
     /** Whether a pointer move can change what this cascade produces. */
     get hoverSensitive(): boolean;
     setPointer(pointer: PointerState): void;
+    /**
+     * Whether the pointer entering or leaving `el` can change a style: one of
+     * the compounds a selector tests the pointer in matches it, the pointer
+     * aside. A move between two paragraphs of a page whose only such rule is
+     * `a:hover` touches nothing, and restyles nothing.
+     */
+    hoverTouches(el: Element): boolean;
+    /**
+     * The elements whose `:has()` may have changed its answer as `el` was
+     * hovered or left: the ancestors of it a compound whose `:has()` tests
+     * the pointer names, and their earlier siblings and its own where the
+     * argument starts at a sibling — a superset, which is restyled and found
+     * the same where it did not. Into `into`.
+     */
+    hoverAnchors(el: Element, into: Element[]): void;
+    private _noteHover;
+    /** A selector compiled as a rule's is, or null where css-select refuses
+     *  it, as a rule it refuses drops out of the cascade. */
+    private _compile;
     /** Which media band a device-pixel width falls in. Two widths in the same
      *  band produce identical styles, which is what lets a resize skip
      *  restyling. */
     mediaBand(width: number): number;
+    /** Computed styles by sharing key, for one build (`sharedStyleFor`): one
+     *  map for the elements shared without matching, one for the elements
+     *  shared by what they matched. */
+    private _shared;
+    private _sharedByMatch;
+    private _nextShareKey;
+    /** Custom property sets by what made them, for one build (`_customFor`). */
+    private _customs;
+    private _ids;
+    private _nextId;
+    /** A box tree is about to be built: the styles shared in the last build
+     *  were computed against a pointer and a viewport that may have moved. */
+    beginSharing(): void;
+    /**
+     * An element's custom properties: its parent's, or its own over them —
+     * shared by every element whose parent has the same ones and whose own
+     * come from the same declarations. Tailwind 4 sets thirty-five of them on
+     * every element (`*, ::before, ::after { --tw-shadow: 0 0 #0000; … }`),
+     * and a set per element was a fifth of building the boxes; it also kept
+     * each element's `var()`s from being replaced once for its siblings,
+     * which `substituteIn` remembers by the set they were read against.
+     */
+    private _customFor;
+    /** Whether a candidate sets a custom property. */
+    private _hasCustom;
+    /** A number for an object, to key a string by. */
+    private _idOf;
+    /**
+     * `styleFor`, shared between the elements that must compute the same
+     * style, with the key this element's children share under.
+     *
+     * A style is a function of the parent's style, the rules that match, the
+     * presentational attributes, the inline style and whether the parent is a
+     * flex container. Outside the rules `UNSHAREABLE` names, what matches
+     * depends only on the element's tag and attributes and its ancestors', and
+     * the hints read nothing else either. So the key is the parent's key, the
+     * flex flag, the tag and every attribute — plus the pointer state where a
+     * rule asks for it — and an element whose key has been computed in this
+     * build takes that style object, matching nothing. A long document is a
+     * few kinds of element many times over: the benchmark's 600 KB report is
+     * 9,039 elements and 110 keys, and computing every style again was a third
+     * of an edit.
+     *
+     * An element a rule `UNSHAREABLE` could reach is matched, since where it
+     * sits decides what matches — and then shared by what matched: the same
+     * parent, attributes and rules make the same style. That is what keeps a
+     * striped table from being a style per row, and it keeps the key its
+     * children share under, which an element-per-key would have taken from the
+     * whole subtree.
+     *
+     * The style is handed out shared, so nothing may write to it — nothing
+     * does after the cascade, and `rootStyle` does not go through here.
+     */
+    sharedStyleFor(el: Element, parentStyle: ComputedStyle, parentKey: number, inFlexContainer: boolean): SharedStyle;
+    /** Whether no rule `UNSHAREABLE` names could reach this element: the same
+     *  buckets `_candidates` looks in. */
+    private _shareable;
     /**
-     * The computed style for one element, given its parent's. Called once per
-     * element per style pass, in document order — the box builder drives it,
-     * so there is no second traversal and no map of styles to allocate.
+     * The computed style for one element, given its parent's. The box builder
+     * asks for every element in document order, through `sharedStyleFor`, so
+     * a style is computed only for the elements with none to share.
      */
     styleFor(el: Element, parentStyle: ComputedStyle, inFlexContainer: boolean): ComputedStyle;
+    /**
+     * The style of an element's `::before` or `::after`, or null when it has
+     * none: no rule reaches it, or the rules that do leave `content` at
+     * `normal` or `none`, which make no box (CSS 2.1 12.2). It inherits from
+     * the element's own style, as a pseudo-element does, and a flex
+     * container's are flex items. Not shared: few elements have one, and where
+     * a rule gives every element one — a clearfix — the style is the cost of
+     * the box it makes.
+     */
+    pseudoStyleFor(el: Element, which: 'before' | 'after', elementStyle: ComputedStyle): ComputedStyle | null;
+    /**
+     * The rules for an element's `::first-letter`, or null when none reaches
+     * it. They are matched against the element here, and its style computed
+     * later by `firstLetterStyle`, because the pseudo-element inherits from
+     * the box its letter turns out to be in — a `<span>` the block opens with,
+     * a `::before` — which the builder has not reached yet.
+     */
+    firstLetterRules(el: Element): FirstLetterRules | null;
+    /** Whether any rule styles a `::first-line`: a document with none asks
+     *  nothing more of its blocks. */
+    get hasFirstLine(): boolean;
+    /**
+     * A list item's `::marker` style, inheriting from its own, or null when no
+     * rule reaches it (CSS Lists 3, 3.1): the colour and the font a bullet or
+     * a number is set in, and a `content` it is set as instead.
+     */
+    markerStyle(el: Element, style: ComputedStyle): ComputedStyle | null;
+    /**
+     * An element's `::first-line` style, inheriting from its own, or null
+     * when no rule reaches it (CSS 2.1 5.12.1).
+     */
+    firstLineStyle(el: Element, style: ComputedStyle): ComputedStyle | null;
+    /**
+     * The style of a `::first-letter` inside a box of `parentStyle`. It is an
+     * inline box, or a float where it floats, whatever the rules say of its
+     * `display` or its `position` (CSS 2.1 5.12.2).
+     */
+    firstLetterStyle(rules: FirstLetterRules, parentStyle: ComputedStyle): ComputedStyle;
+    /** The x-height of a style's font: the font's own, asked once per face,
+     *  or half an em. */
+    private _exOf;
+    /** The advance of a style's font's "0": the font's own, asked once per
+     *  face, or half an em. */
+    private _chOf;
+    /** A style's computed line height as a length, for `lh`: `normal` as
+     *  its font's own, asked once per face, or 1.2em. */
+    private _lineHeightOf;
+    /** `styleFor`, from the rules and hints already gathered for `el`. */
+    private _computeStyle;
+    /** One declaration, its `var()`s replaced first. One that names a
+     *  custom property with no value, and has no fallback, is invalid at
+     *  computed-value time, and the property is as though `unset`. */
+    private _apply;
     /**
      * The root's style — nothing above it to inherit from.
      *
@@ -49,9 +283,31 @@ export declare class Cascade {
      * a `<body>` would have had: the UA sheet's margin and font, and any
      * author `body { … }` rule. Without it a fragment renders hard against the
      * left edge while the same markup inside `<html><body>` does not, which
-     * reads as a bug in the renderer rather than as a missing element.
+     * reads as a bug in the renderer rather than as a missing element. With
+     * no `<html>` either, the body inherits from an `<html>` that author
+     * `html { … }` rules have styled, as the one a browser implies would be.
+     *
+     * A document with a `<body>` and no `<html>` — the usual shape of a page
+     * that starts `<!DOCTYPE html><title>` — has the root box standing in for
+     * that implied `<html>` instead, so an `html { font-size }` still reaches
+     * the body. Taken as the initial style, the rule matched nothing and the
+     * whole page came out at the theme's size.
+     *
+     * `html` is the implied `<html>`'s own style where the root box stands in
+     * for the body inside it, and null otherwise: what an `html { … }` or a
+     * `:root { … }` rule gives it that is not inherited has no box to be
+     * drawn on, and its background is the canvas's (`paintDocument`).
      */
-    rootStyle(hasBody: boolean): ComputedStyle;
+    rootStyle(hasBody: boolean, hasHtml?: boolean): {
+        style: ComputedStyle;
+        html: ComputedStyle | null;
+    };
+    /** The rules of `index` that match `el`, pushed onto `out` as candidates,
+     *  and their ids onto `matched` in the order they were tried. */
+    private _matchInto;
+    /** Every rule and hint that applies to `el`, in cascade order — and, into
+     *  `matched` when it is passed, the ids of the rules, in the order they
+     *  were tried. */
     private _candidates;
 }
 //# sourceMappingURL=cascade.d.ts.map