@ng-native/fabric 0.14.0 → 0.15.0

package/dist/css.d.ts

@@ -667,6 +667,8 @@ export declare const styleStats: {
     nodesResolved: number;
     /** Rules filed by key selector: each sheet's once, however many sheets come after it. */
     rulesFiled: number;
+    /** Nodes asked whether a rule `:has()` was asked for could be for them: see `isFor`. */
+    subjectTests: number;
 };
 export declare function resetStyleStats(): void;
 /**
@@ -721,6 +723,11 @@ export interface PlaceReader {
  * from (`.a:first-child + .b`), is that element's own: the rules it matches say.
  */
 export declare function placeReadElsewhere(sheet: StyleSheet): readonly PlaceReader[];
+/**
+ * The props a sheet's rules ask of an element before another in a child list, `[data-on] ~ .x`:
+ * those whose change can restyle the elements after it. An id is asked as `nativeID`.
+ */
+export declare function namedBeside(sheet: StyleSheet): ReadonlySet<string>;
 /** One rule in a cascade: the sheet it came from, which `:host` needs, and its weight here. */
 interface RuleEntry {
     readonly rule: StyleRule;
@@ -789,6 +796,16 @@ export interface Subjects {
      * matched again itself. Unset where the rules are only for elements under it.
      */
     own?: boolean;
+    /**
+     * In what a class reaches: a rule names it in `:has()`, `.field:has(.on)`, which the boxes
+     * above the element that has it are then asked again.
+     */
+    beneath?: boolean;
+    /**
+     * In what a class reaches: a rule names it in `:has(> )` alone, `.field:has(> .on)`, which only
+     * the box right above the element that has it is then asked again.
+     */
+    parentHas?: boolean;
 }
 /**
  * A box a rule asks `:has()` of that is not the node it styles, `.card:has(.x) .title`, by the
@@ -801,6 +818,8 @@ export interface HasAbove {
 }
 /** Each box a sheet's rules ask `:has()` of above the node they style. */
 export declare function hasAbove(sheet: StyleSheet): readonly HasAbove[];
+/** What all of `each` are for, as one. */
+export declare function joinSubjects(each: readonly Subjects[]): Subjects;
 /** Whether an inline style sets a property children inherit. Allocates nothing: it runs per set. */
 export declare function setsInherited(style: unknown): boolean;
 /**
@@ -928,8 +947,11 @@ export declare class StyleResolver {
      */
     private readonly deepSheets;
     private readonly deepIndexes;
-    /** Read the classes a sheet names, once, as soon as any node is given it. */
-    noteSheet(sheet: StyleSheet | null | undefined): void;
+    /**
+     * Read the classes a sheet names, once, as soon as any node is given it. One `scoped` to a
+     * component or a host asks of its elements for good, global or not.
+     */
+    noteSheet(sheet: StyleSheet | null | undefined, scoped?: boolean): void;
     /** The props a selector of some sheet asks about: an id, and each attribute by its name. */
     private readonly named;
     /**
@@ -937,6 +959,18 @@ export declare class StyleResolver {
      * sheet that was ever loaded names it. A sheet loaded later has every element matched again.
      */
     reads(prop: string): boolean;
+    /**
+     * By prop, how many sheets in play ask it of an element before another: see `namedBeside`. A
+     * global sheet taken away, or replaced, asks no more.
+     */
+    private readonly besideNamed;
+    private readonly besideNoted;
+    /** The sheets a component or a host was given: see `noteSheet`. */
+    private readonly scoped;
+    private noteBeside;
+    private forgetBeside;
+    /** Whether a prop changing can change what the elements after its element match. */
+    readsBeside(prop: string): boolean;
     private noteReach;
     /** Whether a class's reach names any element under the one that has it. */
     reachesUnder(subjects: Subjects): boolean;
@@ -947,6 +981,8 @@ export declare class StyleResolver {
      * of them and nothing is styled again.
      */
     reachOf(classes: Iterable<string>): true | Subjects | null;
+    /** How far a class reaches by its name, and by each test of the class attribute it answers. */
+    private reachesOf;
     /** Whether one of the rules `subjects` stands for could be for a node. */
     isFor(subjects: Subjects, node: StyleTarget): boolean;
     /**
@@ -972,6 +1008,9 @@ export declare class StyleResolver {
      * change it was marked on the element, its parent's `scope` is the one it was styled under,
      * and no sheet that could match it has come since. It is being styled again all the same, for
      * a change of its own that alters nothing under it, or for what it inherits.
+     *
+     * A change beneath it is not one: what it answers `:has()` is asked again, and the elements a
+     * rule asking that of it is for are marked on their own (`markUnderHas`), not all under it.
      */
     private matchesStand;
     /**
@@ -1179,9 +1218,12 @@ export declare class StyleResolver {
  * the compiler writes for the same value in a rule. `token` is the value as a token, which is an
  * alias when it is a `var()`; null for any other.
  *
- * ponytail: the whole value has to be the `var()`. One inside a longer value, `calc()` included,
- * is what the compiler parses at build time and nothing here does; write the sum in a custom
- * property, `[style.--gap]`, and read that in the stylesheet.
+ * A colour made of tokens, `color-mix(in srgb, var(--brand), white 20%)`, is worked out from the
+ * tokens where it is used, as a fallback of the same shape is.
+ *
+ * ponytail: any other value has to be the whole `var()`. One inside a longer value, `calc()`
+ * included, is what the compiler parses at build time and nothing here does; write the sum in a
+ * custom property, `[style.--gap]`, and read that in the stylesheet.
  */
 export declare function boundDeclaration(prop: string, token: TokenValue | undefined, on?: string): DeferredDeclaration | null;
 /** Whether `text` is a `line-height` below zero, which a browser drops: `-1.5`, `-1em`, `-2px`. */

package/dist/css.js

@@ -208,12 +208,15 @@ export const styleStats = {
     nodesResolved: 0,
     /** Rules filed by key selector: each sheet's once, however many sheets come after it. */
     rulesFiled: 0,
+    /** Nodes asked whether a rule `:has()` was asked for could be for them: see `isFor`. */
+    subjectTests: 0,
 };
 export function resetStyleStats() {
     styleStats.compoundTests = 0;
     styleStats.ruleTests = 0;
     styleStats.nodesResolved = 0;
     styleStats.rulesFiled = 0;
+    styleStats.subjectTests = 0;
 }
 /** A prop's value as an attribute test compares it: in lower case, under the i flag. */
 const attributeText = (actual, test) => test.insensitive ? String(actual).toLowerCase() : String(actual);
@@ -640,6 +643,36 @@ export function placeReadElsewhere(sheet) {
     }
     return known;
 }
+const NAMED_BESIDE = new WeakMap();
+/**
+ * The props a sheet's rules ask of an element before another in a child list, `[data-on] ~ .x`:
+ * those whose change can restyle the elements after it. An id is asked as `nativeID`.
+ */
+export function namedBeside(sheet) {
+    let named = NAMED_BESIDE.get(sheet);
+    if (named === undefined) {
+        named = new Set();
+        for (const rule of sheet.rules) {
+            rule.combinators.forEach((joined, at) => {
+                if (joined === 'next-sibling' || joined === 'later-sibling') {
+                    propsNamed(rule.compounds[at], named);
+                }
+            });
+        }
+        NAMED_BESIDE.set(sheet, named);
+    }
+    return named;
+}
+/** Add each prop a compound, or one nested in it at any depth, asks about: an attribute or an id. */
+function propsNamed(compound, into) {
+    if (compound.id !== undefined)
+        into.add('nativeID');
+    for (const test of compound.attributes ?? [])
+        into.add(test.name);
+    const within = (compound.has ?? []).flatMap((test) => test.any);
+    for (const inner of [...nestedCompounds(compound), ...within])
+        propsNamed(inner, into);
+}
 /** Whether a compound, or one nested in it at any depth, asks about a place in a child list. */
 function readsPlace(compound) {
     if (compound.nth?.length)
@@ -1187,6 +1220,13 @@ function importantNames(result, twin) {
 }
 /** What `em` falls back to when nothing in scope has set a font size. The web's default. */
 const DEFAULT_FONT_SIZE = 16;
+/**
+ * The rules a node matched, to style it from again: for a change above it, and not for one of
+ * its own or beneath it, which can change what it matches.
+ */
+function rulesKept(cached, node) {
+    return node.ownDirty || node.hasDirty ? undefined : cached.rules;
+}
 /** Shared empty result. Never handed out anywhere that mutates it. */
 const EMPTY = {};
 /** Stands in for the parent of a root node, so the comparison needs no null case. */
@@ -1287,14 +1327,19 @@ function classReach(sheet) {
     for (const rule of sheet.rules) {
         const every = new Set();
         collectClasses(rule, every, reads, named);
-        const { own, inside } = classPlaces(rule);
+        const { own, inside, beneath, parentHas } = classPlaces(rule);
         for (const name of every) {
-            if (!own.has(name) && !inside.has(name))
+            const placed = own.has(name) || inside.has(name) || beneath.has(name) || parentHas.has(name);
+            if (!placed)
                 classes.set(name, true);
             if (own.has(name))
                 noteOwn(classes, name);
             if (inside.has(name))
                 noteInside(classes, name, rule);
+            if (beneath.has(name))
+                noteBeneath(classes, name, 'beneath');
+            if (parentHas.has(name))
+                noteBeneath(classes, name, 'parentHas');
         }
     }
     reaches.set(sheet, (found = { classes, reads, named }));
@@ -1310,6 +1355,16 @@ function noteOwn(found, name) {
     else
         found.set(name, { ...noSubjects(), own: true });
 }
+/** Note a rule as one that names a class in `:has()`, or in `:has(> )` alone. */
+function noteBeneath(found, name, how) {
+    const subjects = found.get(name);
+    if (subjects === true)
+        return;
+    if (subjects)
+        subjects[how] = true;
+    else
+        found.set(name, { ...noSubjects(), [how]: true });
+}
 /** Note a rule as one that names a class as what its element is inside. */
 function noteInside(found, name, rule) {
     let subjects = found.get(name);
@@ -1333,8 +1388,6 @@ const noSubjects = () => ({
     inside: new Set(),
     any: false,
 });
-/** The reach of classes that rules are for the element of, and for nothing under it. */
-const OWN_ALONE = { ...noSubjects(), own: true };
 /** Add to `into` what `from` is for. */
 function addSubjects(into, from) {
     for (const name of from.classes)
@@ -1346,6 +1399,17 @@ function addSubjects(into, from) {
     into.any ||= from.any;
     if (from.own)
         into.own = true;
+    if (from.beneath)
+        into.beneath = true;
+    if (from.parentHas)
+        into.parentHas = true;
+}
+/** What all of `each` are for, as one. */
+export function joinSubjects(each) {
+    const all = noSubjects();
+    for (const one of each)
+        addSubjects(all, one);
+    return all;
 }
 /**
  * Where a rule names each class it names, for the classes it names in no other place than these:
@@ -1354,21 +1418,29 @@ function addSubjects(into, from) {
  *   it, which are asked of that element;
  * - `inside`, as what that element is inside: the classes of a compound before the last, with
  *   nothing but `>` and a space between there and the element, and those of what `:is(.box *)`
- *   and `:is(.box > *)` put over it.
+ *   and `:is(.box > *)` put over it;
+ * - `beneath`, inside `:has()`, wherever in the rule that is: what it asks of is under the box
+ *   that answers it;
+ * - `parentHas`, of what `:has(> )` asks of the box's children themselves, and nowhere else in
+ *   `:has()`: the element is right under that box.
  *
- * A class named anywhere else in the rule is in neither, whatever else names it: beside the
- * element, inside `:has()` or `:host-context()`, or in `:not()` of a box the element is in.
+ * A class named anywhere else in the rule is in none, whatever else names it: beside the element,
+ * inside `:host-context()`, or in `:not()` of a box the element is in. A test of the class
+ * attribute is placed as a class is, by `classTestKey`.
  */
 function classPlaces(rule) {
     const own = new Set();
     const inside = new Set();
+    const beneath = new Set();
+    const parentHas = new Set();
     const elsewhere = new Set();
+    const below = { beneath, parentHas, elsewhere };
     const last = rule.compounds.length - 1;
     let under = true;
     for (let index = last; index >= 0; index--) {
         const compound = rule.compounds[index];
         if (index === last) {
-            placeClasses(compound, own, inside, elsewhere);
+            placeClasses(compound, own, inside, below);
             continue;
         }
         const joined = rule.combinators[index];
@@ -1376,36 +1448,75 @@ function classPlaces(rule) {
         // A box the element is under, by its classes and by those it is asked to have or not to,
         // `.box:not(.busy) .row`: each is asked of that box, as its own are.
         const over = under ? inside : elsewhere;
-        placeClasses(compound, over, over, elsewhere);
+        placeClasses(compound, over, over, below);
     }
     for (const name of elsewhere) {
         own.delete(name);
         inside.delete(name);
+        beneath.delete(name);
+        parentHas.delete(name);
     }
-    return { own, inside };
+    return { own, inside, beneath, parentHas };
 }
 /**
  * The classes of a compound asked of the element a rule is for, into `at`, and of the compounds
  * it puts over that element, into `inside`. What any other part of it names goes `elsewhere`:
  * a part read here by name is one this knows the reach of, and one added later is not.
  */
-function placeClasses(compound, at, inside, elsewhere) {
-    const { classes, is, not, ancestors, parents, type: _t, id: _i, root: _r, pseudo: _p, ...rest } = compound;
-    for (const name of classes)
+function placeClasses(compound, at, inside, below) {
+    const { classes, is, not, ancestors, parents, attributes, has, type: _t, id: _i, root: _r, pseudo: _p, ...rest } = compound;
+    for (const name of namesOf(classes, attributes))
         at.add(name);
     for (const alternatives of is ?? []) {
         for (const option of alternatives)
-            placeClasses(option, at, inside, elsewhere);
+            placeClasses(option, at, inside, below);
     }
     for (const excluded of not ?? [])
-        placeClasses(excluded, at, inside, elsewhere);
+        placeClasses(excluded, at, inside, below);
     // What is over the element is over it whichever of these said so, and what is over that is too.
     for (const above of [...(ancestors ?? []), ...(parents ?? [])]) {
-        placeClasses(above, inside, inside, elsewhere);
+        placeClasses(above, inside, inside, below);
     }
-    // `attributes` among them: a test of the `class` attribute is answered through `classTests`.
-    collectClasses(rest, elsewhere, []);
+    placeHas(has, below);
+    collectClasses(rest, below.elsewhere, []);
 }
+/**
+ * The classes `:has()` asks of what is under the box that answers it, into `beneath`, wherever
+ * in the rule it is written, or into `parentHas` for what `:has(> )` asks of the box's children.
+ * One it can ask of what is above the box goes `elsewhere`: `:is()` in `:has()` is not relative,
+ * so the `.night` of `:has(:is(.night .cell))` can be any element over the cell.
+ */
+function placeHas(tests, below) {
+    for (const test of tests ?? []) {
+        const into = test.child ? below.parentHas : below.beneath;
+        for (const compound of test.any)
+            placeBeneath(compound, into, below);
+    }
+}
+/** `placeHas` for one compound of a `:has()` argument, whose own classes go `into`. */
+function placeBeneath(compound, into, below) {
+    const { classes, attributes, is, not, has, type: _t, id: _i, root: _r, pseudo: _p, ...rest } = compound;
+    for (const name of namesOf(classes, attributes))
+        into.add(name);
+    for (const alternatives of is ?? []) {
+        for (const option of alternatives)
+            placeBeneath(option, into, below);
+    }
+    for (const excluded of not ?? [])
+        placeBeneath(excluded, into, below);
+    placeHas(has, below);
+    collectClasses(rest, below.elsewhere, []);
+}
+/** A compound's classes, and its tests of the class attribute, which are asked as its classes are. */
+function namesOf(classes, attributes) {
+    const tests = attributes?.filter((test) => test.name === 'class');
+    return tests?.length ? [...classes, ...tests.map(classTestKey)] : classes;
+}
+/**
+ * A test of the class attribute, `[class^="p-"]`, by a name no class can have: it has a reach
+ * as a class does, for what any class it answers can restyle.
+ */
+const classTestKey = (test) => `\0${test.operator ?? ''}${test.insensitive ? 'i' : ''}\0${test.value ?? ''}`;
 /** What a rule declares, which names no element. */
 const DECLARED = new Set(['declarations', 'important', 'tokens']);
 /**
@@ -1425,8 +1536,10 @@ function collectClasses(value, into, reads, named) {
     if (Array.isArray(part.attributes)) {
         for (const test of part.attributes) {
             named?.add(test.name);
-            if (test.name === 'class')
-                reads.push(test);
+            if (test.name !== 'class')
+                continue;
+            reads.push(test);
+            into.add(classTestKey(test));
         }
     }
     for (const [key, inner] of Object.entries(value)) {
@@ -1725,8 +1838,11 @@ export class StyleResolver {
         const at = replacing ? this.addedSheets.indexOf(replacing) : -1;
         if (at === -1)
             this.addedSheets.push(sheet);
-        else
+        else {
             this.addedSheets[at] = sheet;
+            this.forgetBeside(replacing);
+        }
+        this.noteBeside(sheet);
         // One added at the end is filed after what is there. One in another's place files them all again.
         if (at !== -1)
             this.filed = null;
@@ -1753,7 +1869,7 @@ export class StyleResolver {
     /** How far each class named by the sheets met so far reaches: see `classReach`. */
     reach = new Map();
     /** The tests of the `class` attribute itself in those sheets, which any class may answer. */
-    classTests = [];
+    classTests = new Map();
     noted = new WeakSet();
     /**
      * The sheets with a rule written with `::ng-deep`, which is for what is under the component
@@ -1761,9 +1877,17 @@ export class StyleResolver {
      */
     deepSheets = new Set();
     deepIndexes = new WeakMap();
-    /** Read the classes a sheet names, once, as soon as any node is given it. */
-    noteSheet(sheet) {
-        if (!sheet || this.noted.has(sheet))
+    /**
+     * Read the classes a sheet names, once, as soon as any node is given it. One `scoped` to a
+     * component or a host asks of its elements for good, global or not.
+     */
+    noteSheet(sheet, scoped = false) {
+        if (!sheet)
+            return;
+        if (scoped)
+            this.scoped.add(sheet);
+        this.noteBeside(sheet);
+        if (this.noted.has(sheet))
             return;
         this.noted.add(sheet);
         if (sheet.rules.some((rule) => rule.deep))
@@ -1771,7 +1895,8 @@ export class StyleResolver {
         const { classes, reads, named } = classReach(sheet);
         for (const [name, how] of classes)
             this.noteReach(name, how);
-        this.classTests.push(...reads);
+        for (const test of reads)
+            this.classTests.set(classTestKey(test), test);
         for (const name of named)
             this.named.add(name);
     }
@@ -1784,6 +1909,37 @@ export class StyleResolver {
     reads(prop) {
         return this.named.has(prop);
     }
+    /**
+     * By prop, how many sheets in play ask it of an element before another: see `namedBeside`. A
+     * global sheet taken away, or replaced, asks no more.
+     */
+    besideNamed = new Map();
+    besideNoted = new WeakSet();
+    /** The sheets a component or a host was given: see `noteSheet`. */
+    scoped = new WeakSet();
+    noteBeside(sheet) {
+        if (this.besideNoted.has(sheet))
+            return;
+        this.besideNoted.add(sheet);
+        for (const name of namedBeside(sheet)) {
+            this.besideNamed.set(name, (this.besideNamed.get(name) ?? 0) + 1);
+        }
+    }
+    forgetBeside(sheet) {
+        if (this.scoped.has(sheet) || !this.besideNoted.delete(sheet))
+            return;
+        for (const name of namedBeside(sheet)) {
+            const left = this.besideNamed.get(name) - 1;
+            if (left)
+                this.besideNamed.set(name, left);
+            else
+                this.besideNamed.delete(name);
+        }
+    }
+    /** Whether a prop changing can change what the elements after its element match. */
+    readsBeside(prop) {
+        return this.besideNamed.has(prop);
+    }
     noteReach(name, how) {
         const had = this.reach.get(name);
         if (had === true)
@@ -1807,28 +1963,29 @@ export class StyleResolver {
      * of them and nothing is styled again.
      */
     reachOf(classes) {
-        let under = null;
-        let own = false;
+        let found = null;
         for (const name of classes) {
-            const how = this.reach.get(name);
-            if (how === true || this.classTests.some((test) => answers(test, name)))
-                return true;
-            if (!how)
-                continue;
-            own ||= how.own === true;
-            // Made only for a class that reaches under: most are a rule's own, and this is asked for
-            // every element as it is given its classes.
-            if (this.reachesUnder(how))
-                addSubjects((under ??= noSubjects()), how);
+            for (const how of this.reachesOf(name)) {
+                if (how === true)
+                    return true;
+                addSubjects((found ??= noSubjects()), how);
+            }
+        }
+        return found;
+    }
+    /** How far a class reaches by its name, and by each test of the class attribute it answers. */
+    *reachesOf(name) {
+        const how = this.reach.get(name);
+        if (how)
+            yield how;
+        for (const [key, test] of this.classTests) {
+            if (answers(test, name))
+                yield this.reach.get(key) ?? true;
         }
-        if (!under)
-            return own ? OWN_ALONE : null;
-        if (own)
-            under.own = true;
-        return under;
     }
     /** Whether one of the rules `subjects` stands for could be for a node. */
     isFor(subjects, node) {
+        styleStats.subjectTests++;
         return writtenFor(subjects, node);
     }
     /**
@@ -1860,6 +2017,7 @@ export class StyleResolver {
         if (at === -1)
             return false;
         this.addedSheets.splice(at, 1);
+        this.forgetBeside(sheet);
         this.filed = null;
         this.additions.length = 0;
         this.generation = ++generations;
@@ -1919,8 +2077,7 @@ export class StyleResolver {
             return this.unstyled(node, epoch, parent, parentInherited, scope, parentScope);
         }
         styleStats.nodesResolved++;
-        // Its own rules are found again for a change of its own, and not for one above it.
-        const rules = stands && !node.ownDirty ? cached.rules : undefined;
+        const rules = stands ? rulesKept(cached, node) : undefined;
         const matched = found ?? rules ?? this.matchedBy(node);
         const parentTokens = parent ? parent.tokens : this.tokensOnRoot;
         this.heir(node, parent, matched);
@@ -1938,11 +2095,13 @@ export class StyleResolver {
      * change it was marked on the element, its parent's `scope` is the one it was styled under,
      * and no sheet that could match it has come since. It is being styled again all the same, for
      * a change of its own that alters nothing under it, or for what it inherits.
+     *
+     * A change beneath it is not one: what it answers `:has()` is asked again, and the elements a
+     * rule asking that of it is for are marked on their own (`markUnderHas`), not all under it.
      */
     matchesStand(cached, node, parentScope) {
         return (cached !== null &&
             !node.styleDirty &&
-            !node.hasDirty &&
             !node.stateDirty &&
             cached.scope !== SHARED_SCOPE &&
             parentScope !== SHARED_SCOPE &&
@@ -3298,14 +3457,17 @@ function boundKind(prop) {
  * the compiler writes for the same value in a rule. `token` is the value as a token, which is an
  * alias when it is a `var()`; null for any other.
  *
- * ponytail: the whole value has to be the `var()`. One inside a longer value, `calc()` included,
- * is what the compiler parses at build time and nothing here does; write the sum in a custom
- * property, `[style.--gap]`, and read that in the stylesheet.
+ * A colour made of tokens, `color-mix(in srgb, var(--brand), white 20%)`, is worked out from the
+ * tokens where it is used, as a fallback of the same shape is.
+ *
+ * ponytail: any other value has to be the whole `var()`. One inside a longer value, `calc()`
+ * included, is what the compiler parses at build time and nothing here does; write the sum in a
+ * custom property, `[style.--gap]`, and read that in the stylesheet.
  */
 export function boundDeclaration(prop, token, on) {
-    if (!token?.alias)
-        return null;
     const kind = boundKind(prop);
+    if (!token?.alias)
+        return derivedColour(prop, token, kind, on);
     const [reference, ...alternatives] = aliasesOf(token);
     for (; token?.alias; token = token.fallback)
         ;
@@ -3362,6 +3524,12 @@ export function boundRelativeLength(prop, text, on) {
         compute: { unit: 'em', factor: Number(unitless[1]), multiple: true },
     };
 }
+/** A bound colour made of tokens, worked out where it is used; null for any other value. */
+function derivedColour(prop, token, kind, on) {
+    if (!token || kind !== 'color' || !isDerived(token))
+        return null;
+    return { props: [prop], ...(on === undefined ? {} : { on }), kind, fallbackToken: token };
+}
 /** The names a `var()` tries in turn: its own, then each `var()` nested as its fallback. */
 function aliasesOf(token) {
     const names = [];