@react-x11/components 0.12.0 → 0.13.0

package/dist/html/css/parse.js

@@ -123,6 +123,13 @@ base = null) {
                             breakpoints.add(c.min);
                         if (c.max !== undefined)
                             breakpoints.add(c.max + MAX_EDGE);
+                        if (c.minHeight !== undefined || c.maxHeight !== undefined) {
+                            sheet.readsHeight = true;
+                        }
+                        if (c.minAspect !== undefined || c.maxAspect !== undefined) {
+                            sheet.readsHeight = true;
+                            sheet.readsWidth = true;
+                        }
                     }
                     // A nested `@media` intersects with the one above it; pushing a
                     // level rather than merging keeps "all of these blocks hold" exact
@@ -226,6 +233,13 @@ base = null) {
                         breakpoints.add(c.min);
                     if (c.max !== undefined)
                         breakpoints.add(c.max + MAX_EDGE);
+                    if (c.minHeight !== undefined || c.maxHeight !== undefined) {
+                        sheet.readsHeight = true;
+                    }
+                    if (c.minAspect !== undefined || c.maxAspect !== undefined) {
+                        sheet.readsHeight = true;
+                        sheet.readsWidth = true;
+                    }
                 }
                 styleRule(selectors, item.block, media ? [...media, conditions] : [conditions], layer, path, depth + 1);
             }
@@ -1252,18 +1266,32 @@ function readAtRule(text, at) {
  *  at: a sixty-fourth of a pixel past it, where the widths a display scale
  *  divides a device width into (`640.5` at 2x) fall on the right side. */
 const MAX_EDGE = 1 / 64;
+/**
+ * The media features that are the viewport's width and its height here.
+ * `device-width` and `device-height` are the Web-exposed screen area's
+ * (Media Queries 4, appendix A), which a user agent may answer with the
+ * viewport's (CSSOM View 2.3), and a document drawn into an element has no
+ * screen of its own to answer with. Deprecated, and still what a page from
+ * before `width` asks with: DuckDuckGo Lite's phone sheet is
+ * `(max-device-width: 700px)`, and a query that went unread held, so a
+ * desktop window got the phone's 12px dropdowns.
+ */
+const VIEWPORT_SIDES = {
+    width: new Set(['width', 'device-width']),
+    height: new Set(['height', 'device-height']),
+};
 /**
  * A width range in Media Queries 4's syntax — `(width >= 48rem)`, `(60rem >
  * width)`, `(40rem <= width < 60rem)` — as the widths it holds between, or
  * null for a term that is not one. A strict bound is a sixty-fourth of a
  * pixel inside the value, where a viewport's width never lands.
  */
-function widthRange(term) {
+function widthRange(term, feature = 'width') {
     const inner = /^\(\s*(.*?)\s*\)$/.exec(term)?.[1];
     if (!inner || !/[<>=]/.test(inner))
         return null;
     const parts = inner.split(/\s*(<=|>=|<|>|=)\s*/);
-    const isWidth = (part) => part.toLowerCase() === 'width';
+    const isWidth = (part) => VIEWPORT_SIDES[feature].has(part.toLowerCase());
     const out = {};
     // `width OP value`, with the operator read from the width's side
     const bound = (op, value) => {
@@ -1660,8 +1688,15 @@ export function parseMediaQuery(prelude) {
         const condition = {};
         let pass = true;
         let sawWidth = false;
+        let sawHeight = false;
+        let sawResolution = false;
+        let sawAspect = false;
         const negated = /^\s*not\b/i.test(group);
-        for (const part of group.split(/\s+and\s+/i)) {
+        // `and` needs white space after it, where a `(` would make it a
+        // function, and none after the `)` it follows: DuckDuckGo writes
+        // `(max-device-width: 701px)and (orientation: landscape)`, which read
+        // as one term that was no feature, and held
+        for (const part of group.split(/(?:\s+|(?<=\)))and\s+/i)) {
             const term = part
                 .trim()
                 .replace(/^not\s+/i, '')
@@ -1681,19 +1716,53 @@ export function parseMediaQuery(prelude) {
                 sawWidth = true;
                 continue;
             }
+            const heights = widthRange(term, 'height');
+            if (heights) {
+                if (heights.min !== undefined) {
+                    condition.minHeight = Math.max(condition.minHeight ?? 0, heights.min);
+                }
+                if (heights.max !== undefined) {
+                    condition.maxHeight = Math.min(condition.maxHeight ?? Infinity, heights.max);
+                }
+                sawHeight = true;
+                continue;
+            }
             const feature = mediaFeature(term);
             if (feature) {
                 const key = feature[1].toLowerCase();
                 const len = parseLength(feature[2], ZERO_UNITS);
                 const px = typeof len === 'number' ? len : null;
-                if (key === 'min-width' && px !== null) {
+                if ((key === 'min-width' || key === 'min-device-width') &&
+                    px !== null) {
                     condition.min = Math.max(condition.min ?? 0, px);
                     sawWidth = true;
                 }
-                else if (key === 'max-width' && px !== null) {
+                else if ((key === 'max-width' || key === 'max-device-width') &&
+                    px !== null) {
                     condition.max = Math.min(condition.max ?? Infinity, px);
                     sawWidth = true;
                 }
+                else if (px === null &&
+                    /^(?:min-|max-)?(?:device-)?(?:width|height)$/.test(key)) {
+                    // a size that is no length is a query that does not parse, which
+                    // Media Queries 4 (3.2) makes `not all`: `(min-width:0\0)`, the
+                    // hack that kept a block for Internet Explorer 9 and 10, held
+                    // here as a query that asked nothing, and its rules applied
+                    pass = false;
+                }
+                else if ((key === 'min-height' || key === 'min-device-height') &&
+                    px !== null) {
+                    // the viewport's height, answered live as its width is: a
+                    // design that sets its heading's size by the window's height
+                    // took the tallest step's at every height
+                    condition.minHeight = Math.max(condition.minHeight ?? 0, px);
+                    sawHeight = true;
+                }
+                else if ((key === 'max-height' || key === 'max-device-height') &&
+                    px !== null) {
+                    condition.maxHeight = Math.min(condition.maxHeight ?? Infinity, px);
+                    sawHeight = true;
+                }
                 else if (key === 'prefers-color-scheme') {
                     // Answered live, from the palette in force: a document dropped
                     // into a dark application takes its dark branch, and follows the
@@ -1716,7 +1785,67 @@ export function parseMediaQuery(prelude) {
                     pass = false;
                 }
                 else if (key === 'orientation') {
-                    pass = feature[2].trim().toLowerCase() === 'landscape';
+                    // the viewport's, as its aspect ratio: portrait where its height
+                    // is at least its width (Media Queries 4, 4.5)
+                    const orientation = feature[2].trim().toLowerCase();
+                    if (orientation === 'portrait') {
+                        condition.maxAspect = Math.min(condition.maxAspect ?? Infinity, 1);
+                        sawAspect = true;
+                    }
+                    else if (orientation === 'landscape') {
+                        condition.minAspect = Math.max(condition.minAspect ?? 0, 1 + ASPECT_EDGE);
+                        sawAspect = true;
+                    }
+                    else
+                        pass = false;
+                }
+                else if (ASPECT_FEATURES.test(key)) {
+                    const ratio = ratioOf(feature[2]);
+                    if (ratio === null)
+                        pass = false;
+                    else {
+                        if (!key.startsWith('max-')) {
+                            condition.minAspect = Math.max(condition.minAspect ?? 0, ratio);
+                        }
+                        if (!key.startsWith('min-')) {
+                            condition.maxAspect = Math.min(condition.maxAspect ?? Infinity, ratio);
+                        }
+                        sawAspect = true;
+                    }
+                }
+                else if (RESOLUTION_FEATURES.has(key)) {
+                    const dppx = resolutionOf(feature[2], key.startsWith('-webkit-'));
+                    if (dppx === null)
+                        pass = false;
+                    else {
+                        if (!key.includes('max-')) {
+                            condition.minResolution = Math.max(condition.minResolution ?? 0, dppx);
+                        }
+                        if (!key.includes('min-')) {
+                            condition.maxResolution = Math.min(condition.maxResolution ?? Infinity, dppx);
+                        }
+                        sawResolution = true;
+                    }
+                }
+                else if (desktopFeature(key, feature[2]) !== true) {
+                    // any other feature as a desktop screen with a mouse answers
+                    // it, and one nothing knows is false (Media Queries 4, 3.2):
+                    // Firefox's and Opera's resolution features, which a design lists
+                    // beside WebKit's, held here, and a page at one dot to the pixel
+                    // took the rules it keeps for two
+                    pass = false;
+                }
+                continue;
+            }
+            const flag = /^\(\s*(-?[a-z][a-z0-9-]*)\s*\)$/i.exec(term);
+            if (flag) {
+                // a feature in the boolean context, `(hover)`: true where its value
+                // is anything but zero or none
+                const key = flag[1].toLowerCase();
+                if (!BOOLEAN_TRUE.has(key) &&
+                    !RESOLUTION_FEATURES.has(key) &&
+                    desktopFeature(key, null) !== true) {
+                    pass = false;
                 }
                 continue;
             }
@@ -1734,11 +1863,20 @@ export function parseMediaQuery(prelude) {
             // `not` over a scheme is the other scheme. `not` over a width range
             // is not expressible as one range; the honest reduction is to decide
             // it statically rather than invert it wrongly.
-            if (!sawWidth && pass && condition.scheme) {
+            if (!sawWidth &&
+                !sawHeight &&
+                !sawResolution &&
+                !sawAspect &&
+                pass &&
+                condition.scheme) {
                 out.push({ scheme: condition.scheme === 'dark' ? 'light' : 'dark' });
                 continue;
             }
-            out.push({ staticPass: !sawWidth && pass ? false : !pass });
+            out.push({
+                staticPass: !sawWidth && !sawHeight && !sawResolution && !sawAspect && pass
+                    ? false
+                    : !pass,
+            });
             continue;
         }
         if (!pass) {
@@ -1746,6 +1884,9 @@ export function parseMediaQuery(prelude) {
             continue;
         }
         if (!sawWidth &&
+            !sawHeight &&
+            !sawResolution &&
+            !sawAspect &&
             condition.scheme === undefined &&
             condition.min === undefined &&
             condition.max === undefined) {
@@ -1847,6 +1988,122 @@ export function supportsCondition(prelude) {
  * first `)` found no feature there — the term was passed over as though it
  * said nothing, and every narrow-screen rule held at every width.
  */
+/** `aspect-ratio` and the device's, bare or `min-`/`max-`. */
+const ASPECT_FEATURES = /^(?:min-|max-)?(?:device-)?aspect-ratio$/;
+/** How far past square a landscape viewport is: any width over the height. */
+const ASPECT_EDGE = 1e-9;
+/** A ratio, `16/9` or `16 / 9` or `1.5`, as a number; null for anything
+ *  else, or a ratio of nothing. */
+function ratioOf(value) {
+    const m = /^\s*(\d*\.?\d+)\s*(?:\/\s*(\d*\.?\d+)\s*)?$/.exec(value);
+    if (!m)
+        return null;
+    const ratio = Number(m[1]) / (m[2] === undefined ? 1 : Number(m[2]));
+    return Number.isFinite(ratio) && ratio > 0 ? ratio : null;
+}
+/** The resolution features, the standard's and WebKit's, which Chrome
+ *  answers; `min--moz-device-pixel-ratio` and `-o-min-device-pixel-ratio`
+ *  are no feature of its, and none of this. */
+const RESOLUTION_FEATURES = new Set([
+    'resolution',
+    'min-resolution',
+    'max-resolution',
+    '-webkit-device-pixel-ratio',
+    '-webkit-min-device-pixel-ratio',
+    '-webkit-max-device-pixel-ratio',
+]);
+/** A resolution in dots per CSS pixel: `2dppx`, `2x`, `192dpi`, `75.6dpcm`,
+ *  or WebKit's device pixel ratio, a number. Null for anything else. */
+function resolutionOf(value, ratio) {
+    const m = /^\s*(\d*\.?\d+(?:e[+-]?\d+)?)\s*(dppx|x|dpi|dpcm)?\s*$/i.exec(value);
+    if (!m)
+        return null;
+    const n = Number(m[1]);
+    const unit = (m[2] ?? '').toLowerCase();
+    if (ratio)
+        return unit ? null : n;
+    if (unit === 'dppx' || unit === 'x')
+        return n;
+    if (unit === 'dpi')
+        return n / 96;
+    if (unit === 'dpcm')
+        return (n * 2.54) / 96;
+    return null;
+}
+/** The features true in the boolean context whatever the viewport: a
+ *  size, a scheme, an orientation, there is always one. */
+const BOOLEAN_TRUE = new Set([
+    'width',
+    'height',
+    'device-width',
+    'device-height',
+    'aspect-ratio',
+    'orientation',
+    'prefers-color-scheme',
+]);
+/**
+ * A media feature as a desktop screen driven by a mouse answers it — the
+ * device `<Html>` draws on — for the features that do not depend on the
+ * viewport: true, false, or null for a feature nothing knows, which is
+ * false (Media Queries 4, 3.2). `value` is null in the boolean context.
+ * The colour is eight bits a component on no palette and no grid; scripts
+ * never run here, so `scripting` is `none`.
+ */
+function desktopFeature(key, value) {
+    const v = value?.trim().toLowerCase() ?? null;
+    const numeric = (feature, has) => {
+        const bare = key.replace(/^(min|max)-/, '');
+        if (bare !== feature)
+            return null;
+        if (v === null)
+            return key === feature ? has !== 0 : null;
+        const n = Number(v);
+        if (!Number.isFinite(n))
+            return false;
+        if (key.startsWith('min-'))
+            return has >= n;
+        if (key.startsWith('max-'))
+            return has <= n;
+        return has === n;
+    };
+    const keyword = (answers, bool) => v === null ? bool : (answers[v] ?? false);
+    switch (key) {
+        case 'hover':
+        case 'any-hover':
+            return keyword({ hover: true, none: false }, true);
+        case 'pointer':
+        case 'any-pointer':
+            return keyword({ fine: true, coarse: false, none: false }, true);
+        case 'update':
+            return keyword({ fast: true, slow: false, none: false }, true);
+        case 'overflow-block':
+        case 'overflow-inline':
+            return keyword({ scroll: true }, true);
+        case 'scan':
+            return false;
+        case 'color-gamut':
+            return keyword({ srgb: true }, true);
+        case 'dynamic-range':
+        case 'video-dynamic-range':
+            return keyword({ standard: true }, true);
+        case 'prefers-contrast':
+        case 'prefers-reduced-transparency':
+        case 'prefers-reduced-data':
+            return keyword({ 'no-preference': true }, false);
+        case 'forced-colors':
+            return keyword({ none: true }, false);
+        case 'scripting':
+            return keyword({ none: true }, false);
+        case 'display-mode':
+            return keyword({ browser: true }, true);
+        case '-webkit-transform-3d':
+            return v === null || v === '1';
+    }
+    return (numeric('color', 8) ??
+        numeric('monochrome', 0) ??
+        numeric('color-index', 0) ??
+        numeric('grid', 0));
+}
 function mediaFeature(term) {
     const m = /^\(\s*([a-z-]+)\s*:([\s\S]*)\)$/i.exec(term);
     if (!m)
@@ -1867,7 +2124,12 @@ function mediaFeature(term) {
 const ZERO_UNITS = { em: 16, rem: 16, vw: 0, vh: 0, scale: 1 };
 /** Whether a rule's `@media` blocks all hold at this viewport width, under
  *  this colour scheme. */
-export function mediaMatches(media, width, scheme = 'light') {
+export function mediaMatches(media, width, scheme = 'light', 
+/** The viewport's height in CSS pixels; a test of it holds at no height
+ *  where none is given. */
+height = NaN, 
+/** The display's scale, device pixels to the CSS pixel. */
+resolution = 1) {
     if (!media)
         return true;
     for (const block of media) {
@@ -1880,6 +2142,12 @@ export function mediaMatches(media, width, scheme = 'light') {
             }
             if ((c.min === undefined || width >= c.min) &&
                 (c.max === undefined || width <= c.max) &&
+                (c.minHeight === undefined || height >= c.minHeight) &&
+                (c.maxHeight === undefined || height <= c.maxHeight) &&
+                (c.minResolution === undefined || resolution >= c.minResolution) &&
+                (c.minAspect === undefined || width >= c.minAspect * height) &&
+                (c.maxAspect === undefined || width <= c.maxAspect * height) &&
+                (c.maxResolution === undefined || resolution <= c.maxResolution) &&
                 (c.scheme === undefined || c.scheme === scheme)) {
                 any = true;
             }