@react-x11/components 0.3.0 → 0.5.0

package/dist/maps/style.js

@@ -0,0 +1,147 @@
+import { GeomType } from './mvt.js';
+// --- zoom ramps ------------------------------------------------------------
+function isStops(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        Array.isArray(value.stops));
+}
+/** A {@link Zoomed} at one zoom. Numbers interpolate, everything else
+ *  steps. */
+export function resolveZoomed(value, zoom) {
+    if (!isStops(value))
+        return value;
+    const stops = value.stops;
+    if (stops.length === 0)
+        throw new Error('a zoom ramp needs a stop');
+    if (zoom <= stops[0][0])
+        return stops[0][1];
+    const last = stops[stops.length - 1];
+    if (zoom >= last[0])
+        return last[1];
+    let i = 1;
+    while (i < stops.length && stops[i][0] <= zoom)
+        i++;
+    const [z0, v0] = stops[i - 1];
+    const [z1, v1] = stops[i];
+    if (typeof v0 !== 'number' || typeof v1 !== 'number')
+        return v0;
+    const t = z1 === z0 ? 0 : (zoom - z0) / (z1 - z0);
+    return (v0 + (v1 - v0) * t);
+}
+const ALWAYS = () => true;
+/**
+ * Compile a filter to a closure, once.
+ *
+ * The point of compiling rather than interpreting: the operator dispatch,
+ * the `in`-set construction and the geometry-type mapping all happen here,
+ * per layer, instead of twelve thousand times per tile. A `['in', 'kind',
+ * …]` with forty values becomes a `Set` lookup rather than a scan.
+ */
+export function compileFilter(filter) {
+    if (!filter)
+        return ALWAYS;
+    const op = filter[0];
+    switch (op) {
+        case 'all': {
+            const parts = filter.slice(1).map(compileFilter);
+            if (parts.length === 0)
+                return ALWAYS;
+            if (parts.length === 1)
+                return parts[0];
+            return (f) => {
+                for (const part of parts)
+                    if (!part(f))
+                        return false;
+                return true;
+            };
+        }
+        case 'any': {
+            const parts = filter.slice(1).map(compileFilter);
+            if (parts.length === 0)
+                return ALWAYS;
+            return (f) => {
+                for (const part of parts)
+                    if (part(f))
+                        return true;
+                return false;
+            };
+        }
+        case 'none': {
+            const parts = filter.slice(1).map(compileFilter);
+            return (f) => {
+                for (const part of parts)
+                    if (part(f))
+                        return false;
+                return true;
+            };
+        }
+        case 'has': {
+            const key = filter[1];
+            return (f) => f.get(key) !== undefined;
+        }
+        case '!has': {
+            const key = filter[1];
+            return (f) => f.get(key) === undefined;
+        }
+        case '==': {
+            const [, key, want] = filter;
+            return (f) => f.get(key) === want;
+        }
+        case '!=': {
+            const [, key, want] = filter;
+            return (f) => f.get(key) !== want;
+        }
+        case '<':
+        case '<=':
+        case '>':
+        case '>=': {
+            const [, key, want] = filter;
+            return (f) => {
+                const value = f.get(key);
+                // A missing tag compares false rather than as zero: `['>' , 'pop',
+                // 0]` must not select every feature that has no population.
+                if (typeof value !== 'number')
+                    return false;
+                return op === '<'
+                    ? value < want
+                    : op === '<='
+                        ? value <= want
+                        : op === '>'
+                            ? value > want
+                            : value >= want;
+            };
+        }
+        case 'in': {
+            const key = filter[1];
+            const set = new Set(filter.slice(2));
+            return (f) => {
+                const value = f.get(key);
+                return value !== undefined && set.has(value);
+            };
+        }
+        case '!in': {
+            const key = filter[1];
+            const set = new Set(filter.slice(2));
+            return (f) => {
+                const value = f.get(key);
+                return value === undefined || !set.has(value);
+            };
+        }
+        case 'geometry': {
+            const want = filter[1] === 'point'
+                ? GeomType.Point
+                : filter[1] === 'line'
+                    ? GeomType.LineString
+                    : GeomType.Polygon;
+            return (f) => f.type === want;
+        }
+        default: {
+            // An unknown operator draws nothing rather than everything: a typo in
+            // a filter that quietly selected the whole layer would look like the
+            // style working.
+            const unknown = op;
+            throw new Error(`unknown map filter operator ${String(unknown)}`);
+        }
+    }
+}
+//# sourceMappingURL=style.js.map

package/dist/maps/style.js.map

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

package/dist/maps/styles.d.ts

@@ -0,0 +1,82 @@
+import type { MapStyle } from './style.js';
+/** One palette. Every colour a {@link shortbreadStyle} layer uses comes
+ *  from here, so a third palette is a literal rather than a fork. */
+export interface MapPalette {
+    land: string;
+    ocean: string;
+    water: string;
+    green: string;
+    built: string;
+    site: string;
+    building: string;
+    buildingEdge: string;
+    motorway: string;
+    motorwayCasing: string;
+    trunk: string;
+    primary: string;
+    secondary: string;
+    minor: string;
+    minorCasing: string;
+    path: string;
+    rail: string;
+    boundary: string;
+    pier: string;
+    text: string;
+    textMinor: string;
+    halo: string;
+}
+/** OSM Carto's hues, near enough that a user's eye reads the map as the one
+ *  they already know. */
+export declare const LIGHT_PALETTE: MapPalette;
+/** The dark counterpart. Desaturated rather than inverted: an inverted map
+ *  puts white water under dark land, which reads as a negative. */
+export declare const DARK_PALETTE: MapPalette;
+export interface ShortbreadStyleOptions {
+    /** `false` (the default) for the light palette. */
+    dark?: boolean;
+    /** Swap individual colours without forking the layer list. */
+    palette?: Partial<MapPalette>;
+    /**
+     * Which name tag labels read.
+     *
+     * Shortbread carries `name` (the local name) plus `name_<lang>` for the
+     * languages a feature has one in. `'name'` is the honest default —
+     * Tokyo's streets are labelled in Japanese on a Japanese map — and an
+     * application that knows its user's locale passes `name_en`, `name_de`
+     * and so on. A missing translation falls back to `name`.
+     */
+    nameField?: string;
+    /** Leave the label layers out — for a map an application labels itself,
+     *  or a background under a heavy data overlay. */
+    labels?: boolean;
+    /** Leave building footprints out. They are the densest polygon layer at
+     *  high zoom and the first thing to drop on a slow machine. */
+    buildings?: boolean;
+}
+/**
+ * The default style for Shortbread tiles.
+ *
+ * Twenty-six layers, in paint order. The order is the cartography: sea,
+ * then landuse, then water, then sites and buildings, then road *casings*
+ * as one pass and road *fills* as another — which is what makes a junction
+ * look like a junction rather than two roads crossing — then rail,
+ * boundaries, and labels last.
+ */
+export declare function shortbreadStyle(options?: ShortbreadStyleOptions): MapStyle;
+export interface OpenMapTilesStyleOptions extends ShortbreadStyleOptions {
+}
+/**
+ * The same cartography over the **OpenMapTiles** schema.
+ *
+ * OpenMapTiles is the other open schema, and between them the two cover
+ * nearly every provider worth pointing this at: Shortbread is what
+ * OpenStreetMap's own server and VersaTiles cut, OpenMapTiles is what
+ * MapTiler, Stadia, Geoapify, OpenFreeMap and most self-hosted planets cut.
+ *
+ * Deliberately the same palette, the same layer ids where they mean the
+ * same thing, and the same casing-then-fill ordering, so switching a source
+ * between the two schemas changes which style you pass and nothing else
+ * about how the map looks.
+ */
+export declare function openMapTilesStyle(options?: OpenMapTilesStyleOptions): MapStyle;
+//# sourceMappingURL=styles.d.ts.map

package/dist/maps/styles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"styles.d.ts","sourceRoot":"","sources":["../../src/maps/styles.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EAAE,QAAQ,EAAyB,MAAM,YAAY,CAAC;AAgElE;qEACqE;AACrE,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;CACd;AAED;yBACyB;AACzB,eAAO,MAAM,aAAa,EAAE,UAuB3B,CAAC;AAEF;mEACmE;AACnE,eAAO,MAAM,YAAY,EAAE,UAuB1B,CAAC;AAOF,MAAM,WAAW,sBAAsB;IACrC,mDAAmD;IACnD,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,8DAA8D;IAC9D,OAAO,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;IAC9B;;;;;;;;OAQG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;sDACkD;IAClD,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;mEAC+D;IAC/D,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAC7B,OAAO,GAAE,sBAA2B,GACnC,QAAQ,CAsZV;AAiDD,MAAM,WAAW,wBAAyB,SAAQ,sBAAsB;CAAG;AAE3E;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,GAAE,wBAA6B,GACrC,QAAQ,CA0WV"}