@fusion.dev/helix-map 0.0.0-dev

package/dist/snapshot/snapshot.d.ts

@@ -0,0 +1,75 @@
+import { type MapView } from './camera.js';
+/** The token a snapshot layer's color is the land moved toward. */
+export type SnapshotToward = 'foreground' | 'info' | 'primary' | 'success';
+/**
+ * One layer of a snapshot: which of the tiles' layers it draws, which of its
+ * features, and in what. **The same as `mapLibreStyle`'s layer of the same
+ * `id`**, its color the land moved toward a token by the same amount and its
+ * width the same at every zoom, which the snapshot's spec holds it to, so the
+ * picture a page paints first is the map the renderer then draws.
+ */
+export interface SnapshotLayer {
+    /** Only features of these classes. */
+    classes?: readonly string[];
+    /** How far the land is moved toward `toward`, from 0 to 1. */
+    amount: number;
+    /** The feature classes left out. */
+    except?: readonly string[];
+    id: string;
+    kind: 'fill' | 'line';
+    /** The zoom it starts at, as the style's layer does. */
+    minzoom?: number;
+    /** Whether a feature in a tunnel is left out, as the style leaves it. */
+    overground?: boolean;
+    /**
+     * The smallest a shape is drawn, as the area of the box around it on the
+     * screen, in square pixels. A city's buildings are most of the weight of a
+     * street map and the least of what a first paint needs, and the renderer
+     * draws the small ones over it a moment later.
+     */
+    smallest?: number;
+    /** The tiles' layer it reads, in the OpenMapTiles schema. */
+    source: string;
+    toward: SnapshotToward;
+    /** A line's width at two zooms, in pixels, widened between them as the style widens it. */
+    width?: readonly [readonly [number, number], readonly [number, number]];
+}
+/**
+ * What a snapshot draws, bottom to top: the ground, the water, the buildings
+ * and the roads. The labels, the landmarks and the signs are left to the
+ * renderer, which places them where they do not collide; a picture that drew
+ * them would draw them where the renderer then would not.
+ */
+export declare const SNAPSHOT_LAYERS: readonly SnapshotLayer[];
+/** A width between two zooms as MapLibre interpolates it: exponentially, by 1.5 a zoom. */
+export declare const widthAt: ([[z0, w0], [z1, w1]]: readonly [readonly [number, number], readonly [number, number]], zoom: number) => number;
+/** What a snapshot is drawn from. */
+export interface SnapshotOptions {
+    /** The fetch the tiles are asked for with, where a server has its own, such as one that caches. */
+    fetch?: typeof fetch | undefined;
+    /** A TileJSON URL for vector tiles in the OpenMapTiles schema: the one given to `mapLibreStyle`. OpenFreeMap's by default. */
+    tiles?: string | undefined;
+}
+/**
+ * **A map drawn on the server, for the page's first paint**: an SVG of the
+ * view a renderer is about to draw, from the same vector tiles and in the
+ * same colors, so the map is there before the renderer has loaded. Put it in
+ * the frame after the element the renderer draws in, since the renderer
+ * paints its land before its tiles arrive; `connectMap` fades it out once
+ * the renderer has drawn them. The frame's markers stand on it meanwhile.
+ *
+ * **Seen through the renderer's camera**, tilted and turned as the view
+ * says, so the streets it draws lie under the streets the renderer draws.
+ * It is drawn as a flat map, which is what a globe is at the zooms a page
+ * opens a street map at: a view zoomed out past about 6 is a globe in the
+ * renderer, and the picture would not match it.
+ *
+ * **Colored by the page's tokens**, each color written as the land moved
+ * toward a token in OKLab, so it is drawn in whichever theme the page is in,
+ * light or dark, and changes with it.
+ *
+ * Resolves to an empty string where the tiles cannot be read, which a page
+ * renders as nothing.
+ */
+export declare const mapSnapshot: (view: MapView, options?: SnapshotOptions) => Promise<string>;
+//# sourceMappingURL=snapshot.d.ts.map

package/dist/snapshot/snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.d.ts","sourceRoot":"","sources":["../../src/snapshot/snapshot.ts"],"names":[],"mappings":"AAEA,OAAO,EAAY,KAAK,OAAO,EAAoB,MAAM,aAAa,CAAA;AAEtE,mEAAmE;AACnE,MAAM,MAAM,cAAc,GAAG,YAAY,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,CAAA;AAE1E;;;;;;GAMG;AACH,MAAM,WAAW,aAAa;IAC5B,sCAAsC;IACtC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IAC3B,8DAA8D;IAC9D,MAAM,EAAE,MAAM,CAAA;IACd,oCAAoC;IACpC,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IAC1B,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,GAAG,MAAM,CAAA;IACrB,wDAAwD;IACxD,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,yEAAyE;IACzE,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,6DAA6D;IAC7D,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,cAAc,CAAA;IACtB,2FAA2F;IAC3F,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;CACxE;AAED;;;;;GAKG;AACH,eAAO,MAAM,eAAe,EAAE,SAAS,aAAa,EA+FnD,CAAA;AAmBD,2FAA2F;AAC3F,eAAO,MAAM,OAAO,yBACI,SAAS,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,QAC/E,MAAM,KACX,MASF,CAAA;AAoDD,qCAAqC;AACrC,MAAM,WAAW,eAAe;IAC9B,mGAAmG;IACnG,KAAK,CAAC,EAAE,OAAO,KAAK,GAAG,SAAS,CAAA;IAChC,8HAA8H;IAC9H,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAC3B;AAWD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,WAAW,SAChB,OAAO,YACJ,eAAe,KACvB,OAAO,CAAC,MAAM,CAoKhB,CAAA"}

package/dist/snapshot/snapshot.js

@@ -0,0 +1,290 @@
+import { VectorTile } from '@mapbox/vector-tile';
+import Pbf from 'pbf';
+import { cameraOf } from './camera.js';
+export const SNAPSHOT_LAYERS = [
+    {
+        amount: 0.096,
+        classes: ['wood', 'grass', 'wetland'],
+        id: 'landcover',
+        kind: 'fill',
+        source: 'landcover',
+        toward: 'success',
+    },
+    {
+        amount: 0.16,
+        except: ['historic'],
+        id: 'park',
+        kind: 'fill',
+        source: 'park',
+        toward: 'success',
+    },
+    { amount: 0.3, id: 'water', kind: 'fill', overground: true, source: 'water', toward: 'info' },
+    {
+        amount: 0.3,
+        id: 'waterway',
+        kind: 'line',
+        overground: true,
+        source: 'waterway',
+        toward: 'info',
+        width: [
+            [8, 0.5],
+            [18, 6],
+        ],
+    },
+    {
+        amount: 0.07,
+        id: 'building',
+        kind: 'fill',
+        minzoom: 13,
+        smallest: 400,
+        source: 'building',
+        toward: 'foreground',
+    },
+    {
+        amount: 0.1,
+        classes: ['minor', 'service'],
+        id: 'road-minor',
+        kind: 'line',
+        minzoom: 12,
+        overground: true,
+        source: 'transportation',
+        toward: 'foreground',
+        width: [
+            [12, 0.5],
+            [18, 10],
+        ],
+    },
+    {
+        amount: 0.16,
+        classes: ['secondary', 'tertiary'],
+        id: 'road-secondary',
+        kind: 'line',
+        minzoom: 10,
+        overground: true,
+        source: 'transportation',
+        toward: 'foreground',
+        width: [
+            [10, 0.5],
+            [18, 14],
+        ],
+    },
+    {
+        amount: 0.4,
+        classes: ['primary', 'trunk'],
+        id: 'road-major',
+        kind: 'line',
+        minzoom: 8,
+        overground: true,
+        source: 'transportation',
+        toward: 'primary',
+        width: [
+            [8, 0.5],
+            [18, 16],
+        ],
+    },
+    {
+        amount: 0.6,
+        classes: ['motorway'],
+        id: 'road-motorway',
+        kind: 'line',
+        minzoom: 5,
+        overground: true,
+        source: 'transportation',
+        toward: 'primary',
+        width: [
+            [5, 0.5],
+            [18, 18],
+        ],
+    },
+];
+const TOKENS = {
+    foreground: '--helix-color-foreground',
+    info: '--helix-color-info',
+    primary: '--helix-color-primary',
+    success: '--helix-color-success',
+    surface: '--helix-color-surface',
+};
+const colorOf = (layer) => `color-mix(in oklab, var(${TOKENS.surface}), var(${TOKENS[layer.toward]}) ${+(layer.amount * 100).toFixed(2)}%)`;
+export const widthAt = ([[z0, w0], [z1, w1]], zoom) => {
+    if (zoom <= z0) {
+        return w0;
+    }
+    if (zoom >= z1) {
+        return w1;
+    }
+    const t = (1.5 ** (zoom - z0) - 1) / (1.5 ** (z1 - z0) - 1);
+    return w0 + t * (w1 - w0);
+};
+const TOLERANCE = 0.8;
+const SHORTEST = 12;
+const simplified = (points) => {
+    if (points.length < 3) {
+        return points;
+    }
+    const kept = new Uint8Array(points.length);
+    kept[0] = 1;
+    kept[points.length - 1] = 1;
+    const stack = [[0, points.length - 1]];
+    while (stack.length > 0) {
+        const [from, to] = stack.pop();
+        const [ax, ay] = points[from];
+        const [bx, by] = points[to];
+        const length = Math.hypot(bx - ax, by - ay);
+        let farthest = -1;
+        let at = -1;
+        for (let index = from + 1; index < to; index++) {
+            const [px, py] = points[index];
+            const away = length === 0
+                ? Math.hypot(px - ax, py - ay)
+                : Math.abs((bx - ax) * (ay - py) - (ax - px) * (by - ay)) / length;
+            if (away > farthest) {
+                farthest = away;
+                at = index;
+            }
+        }
+        if (farthest > TOLERANCE) {
+            kept[at] = 1;
+            stack.push([from, at], [at, to]);
+        }
+    }
+    return points.filter((_, index) => kept[index] === 1);
+};
+const OPENFREEMAP = 'https://tiles.openfreemap.org/planet';
+const MOST_TILES = 40;
+const MARGIN = 16;
+export const mapSnapshot = async (view, options = {}) => {
+    const get = options.fetch ?? fetch;
+    const tiles = await get(options.tiles ?? OPENFREEMAP)
+        .then((response) => (response.ok ? response.json() : undefined))
+        .catch(() => undefined);
+    const template = tiles?.tiles?.[0];
+    if (!template) {
+        return '';
+    }
+    const deepest = tiles.maxzoom ?? 14;
+    const camera = cameraOf(view);
+    const corners = [
+        [0, 0],
+        [view.width, 0],
+        [0, view.height],
+        [view.width, view.height],
+    ];
+    const ground = corners.map((corner) => camera.toWorld(corner));
+    let depth = Math.max(0, Math.min(deepest, Math.floor(view.zoom)));
+    const covering = (at) => {
+        const span = camera.size / 2 ** at;
+        const xs = ground.map(([x]) => Math.floor(x / span));
+        const ys = ground.map(([, y]) => Math.floor(y / span));
+        const count = 2 ** at;
+        const wanted = [];
+        for (let x = Math.min(...xs); x <= Math.max(...xs); x++) {
+            for (let y = Math.max(0, Math.min(...ys)); y <= Math.min(count - 1, Math.max(...ys)); y++) {
+                wanted.push([((x % count) + count) % count, y]);
+            }
+        }
+        return wanted;
+    };
+    let wanted = covering(depth);
+    while (wanted.length > MOST_TILES && depth > 0) {
+        depth -= 1;
+        wanted = covering(depth);
+    }
+    const span = camera.size / 2 ** depth;
+    const drawn = new Map(SNAPSHOT_LAYERS.map((layer) => [layer.id, []]));
+    const shown = SNAPSHOT_LAYERS.filter((layer) => view.zoom >= (layer.minzoom ?? 0));
+    const pathOf = (rings, [tx, ty], extent, closed, smallest) => {
+        let path = '';
+        for (const ring of rings) {
+            const points = [];
+            for (const point of ring) {
+                const on = camera.toScreen([(tx + point.x / extent) * span, (ty + point.y / extent) * span]);
+                if (on) {
+                    points.push(on);
+                }
+            }
+            if (points.length < 2) {
+                continue;
+            }
+            const xs = points.map(([x]) => x);
+            const ys = points.map(([, y]) => y);
+            if (Math.max(...xs) < -MARGIN ||
+                Math.min(...xs) > view.width + MARGIN ||
+                Math.max(...ys) < -MARGIN ||
+                Math.min(...ys) > view.height + MARGIN ||
+                (Math.max(...xs) - Math.min(...xs)) * (Math.max(...ys) - Math.min(...ys)) < smallest ||
+                (!closed &&
+                    Math.hypot(Math.max(...xs) - Math.min(...xs), Math.max(...ys) - Math.min(...ys)) <
+                        SHORTEST)) {
+                continue;
+            }
+            let [lastX, lastY] = [0, 0];
+            simplified(points).forEach(([x, y], index) => {
+                const [px, py] = [Math.round(x), Math.round(y)];
+                if (index === 0) {
+                    path += `M${px} ${py}`;
+                }
+                else if (px !== lastX || py !== lastY) {
+                    path += `l${px - lastX} ${py - lastY}`;
+                }
+                ;
+                [lastX, lastY] = [px, py];
+            });
+            if (closed) {
+                path += 'z';
+            }
+        }
+        return path;
+    };
+    await Promise.all(wanted.map(async (at) => {
+        const url = template
+            .replace('{z}', String(depth))
+            .replace('{x}', String(at[0]))
+            .replace('{y}', String(at[1]));
+        const bytes = await get(url)
+            .then((response) => (response.ok ? response.arrayBuffer() : undefined))
+            .catch(() => undefined);
+        if (!bytes) {
+            return;
+        }
+        const tile = new VectorTile(new Pbf(new Uint8Array(bytes)));
+        for (const layer of shown) {
+            const source = tile.layers[layer.source];
+            if (!source) {
+                continue;
+            }
+            for (let index = 0; index < source.length; index++) {
+                const feature = source.feature(index);
+                const kind = String(feature.properties.class ?? '');
+                if (feature.type !== (layer.kind === 'fill' ? 3 : 2) ||
+                    (layer.classes && !layer.classes.includes(kind)) ||
+                    layer.except?.includes(kind) ||
+                    (layer.overground && feature.properties.brunnel === 'tunnel')) {
+                    continue;
+                }
+                const path = pathOf(feature.loadGeometry(), at, source.extent, layer.kind === 'fill', layer.smallest ?? 0);
+                if (path) {
+                    drawn.get(layer.id)?.push(path);
+                }
+            }
+        }
+    }));
+    const body = shown
+        .map((layer) => {
+        const paths = drawn.get(layer.id) ?? [];
+        if (paths.length === 0) {
+            return '';
+        }
+        const color = colorOf(layer);
+        return layer.kind === 'fill'
+            ? `<path fill-rule="evenodd" style="fill:${color}" d="${paths.join('')}"/>`
+            : `<path style="fill:none;stroke:${color};stroke-width:${+widthAt(layer.width ?? [
+                [0, 1],
+                [1, 1],
+            ], view.zoom).toFixed(2)}px;stroke-linecap:round;stroke-linejoin:round" d="${paths.join('')}"/>`;
+    })
+        .join('');
+    return (`<div aria-hidden="true" data-helix-map-snapshot style="inset:0;overflow:hidden;pointer-events:none;position:absolute">` +
+        `<svg height="${view.height}" viewBox="0 0 ${view.width} ${view.height}" width="${view.width}" xmlns="http://www.w3.org/2000/svg" style="background:var(${TOKENS.surface});left:50%;position:absolute;top:50%;translate:-50% -50%">` +
+        `${body}</svg></div>`);
+};
+//# sourceMappingURL=snapshot.js.map

package/dist/snapshot/snapshot.js.map

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

package/dist/style/index.d.ts

@@ -0,0 +1,5 @@
+export type { MapColors } from './map-colors.js';
+export { colorsNow, colorsReady, fontReady, mapColorsFrom, mapFontFrom, PATIENCE, settledColor, } from './map-colors.js';
+export type { MapImage, MapLibreStyle, MapStyleOptions } from './map-style.js';
+export { mapLibreStyle } from './map-style.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/style/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/style/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAChD,OAAO,EACL,SAAS,EACT,WAAW,EACX,SAAS,EACT,aAAa,EACb,WAAW,EACX,QAAQ,EACR,YAAY,GACb,MAAM,iBAAiB,CAAA;AACxB,YAAY,EAAE,QAAQ,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAC9E,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA"}

package/dist/style/index.js

@@ -0,0 +1,3 @@
+export { colorsNow, colorsReady, fontReady, mapColorsFrom, mapFontFrom, PATIENCE, settledColor, } from './map-colors.js';
+export { mapLibreStyle } from './map-style.js';
+//# sourceMappingURL=index.js.map

package/dist/style/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/style/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,SAAS,EACT,WAAW,EACX,SAAS,EACT,aAAa,EACb,WAAW,EACX,QAAQ,EACR,YAAY,GACb,MAAM,iBAAiB,CAAA;AAExB,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA"}

package/dist/style/map-colors.d.ts

@@ -0,0 +1,69 @@
+/**
+ * The colors a themed map is drawn from, each a `#hex`, `rgb()` or `rgba()`.
+ *
+ * **A handful, and the rest is mixed from them.** Buildings, borders, labels
+ * and the smaller roads are the land moved toward the ink by different
+ * amounts, so a light theme draws dark lines on a light ground and a dark
+ * theme light lines on a dark one, with no second palette to keep in step.
+ * The roads a reader navigates by take the brand, which is where a map shows
+ * whose it is.
+ */
+export interface MapColors {
+    /** The ink, which roads, borders and labels are mixed toward: `foreground`. */
+    foreground: string;
+    /** The water's hue, mixed quietly into the land: `info`. */
+    info: string;
+    /** The brand, which the motorways and the major roads are drawn toward: `primary`. */
+    primary: string;
+    /** The parks' and woods' hue, mixed more quietly still: `success`. */
+    success: string;
+    /** The land, which everything else is drawn on: `surface`. */
+    surface: string;
+}
+/**
+ * An element's own `color`, settled the same way: what a route or an area
+ * is drawn in, which its tone decides in the page's stylesheet and which the
+ * renderer can only take as sRGB.
+ */
+export declare const settledColor: (element: Element, property?: 'border-top-color' | 'color' | 'outline-color') => string;
+/**
+ * The page's own colors, read where the map is, as a map style can take them.
+ *
+ * **Resolved by the browser and then by a canvas**, because a token is not a
+ * color yet: it is `light-dark()` over a ramp, or a `color-mix()`, which only
+ * the browser can settle for the element's color scheme, and what it settles
+ * to may be `oklch()`, which a map style cannot parse. Painting it onto one
+ * pixel and reading the pixel back gives the sRGB a style can. Read inside
+ * `element`, so a frame in a dark region of a light page is themed as dark.
+ */
+export declare const mapColorsFrom: (element: Element) => MapColors;
+/**
+ * The page's colors where they can be read, or `null` while they cannot.
+ *
+ * **Not yet rather than never.** A stylesheet being swapped, which
+ * development does on every edit and a page can do on its own, takes the
+ * tokens away for a moment, and a restyle that landed in that moment threw
+ * out of an animation frame with nobody to catch it. Ask again a frame later,
+ * or call `mapColorsFrom`, whose error says what is missing.
+ */
+export declare const colorsNow: (element: Element) => MapColors | null;
+/**
+ * The theme's typeface where the map is, as the one family name a map's
+ * labels are drawn in: the first of `--helix-font-sans`, unquoted.
+ */
+export declare const mapFontFrom: (element: Element) => string;
+/**
+ * Resolves once the typeface's weights a map draws are loaded: regular,
+ * medium, bold and italic. MapLibre draws each letter once and keeps it, so
+ * one drawn before the face arrived stays in the fallback face.
+ */
+export declare const fontReady: (font: string) => Promise<void>;
+/** How many frames to wait for the tokens before saying they are missing: a few seconds. */
+export declare const PATIENCE = 180;
+/**
+ * The page's colors once they can be read: at once where they already can,
+ * after a frame or two where the page is still settling, and the reason they
+ * cannot be where a few seconds pass without them.
+ */
+export declare const colorsReady: (element: Element) => Promise<MapColors>;
+//# sourceMappingURL=map-colors.d.ts.map

package/dist/style/map-colors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"map-colors.d.ts","sourceRoot":"","sources":["../../src/style/map-colors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,MAAM,WAAW,SAAS;IACxB,+EAA+E;IAC/E,UAAU,EAAE,MAAM,CAAA;IAClB,4DAA4D;IAC5D,IAAI,EAAE,MAAM,CAAA;IACZ,sFAAsF;IACtF,OAAO,EAAE,MAAM,CAAA;IACf,sEAAsE;IACtE,OAAO,EAAE,MAAM,CAAA;IACf,8DAA8D;IAC9D,OAAO,EAAE,MAAM,CAAA;CAChB;AAuCD;;;;GAIG;AACH,eAAO,MAAM,YAAY,YACd,OAAO,aACN,kBAAkB,GAAG,OAAO,GAAG,eAAe,KACvD,MAAsE,CAAA;AAEzE;;;;;;;;;GASG;AACH,eAAO,MAAM,aAAa,YAAa,OAAO,KAAG,SAqBhD,CAAA;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,SAAS,YAAa,OAAO,KAAG,SAAS,GAAG,IAMxD,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,WAAW,YAAa,OAAO,KAAG,MAa9C,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,SAAS,SAAgB,MAAM,KAAG,OAAO,CAAC,IAAI,CAS1D,CAAA;AAED,4FAA4F;AAC5F,eAAO,MAAM,QAAQ,MAAM,CAAA;AAE3B;;;;GAIG;AACH,eAAO,MAAM,WAAW,YAAmB,OAAO,KAAG,OAAO,CAAC,SAAS,CASrE,CAAA"}

package/dist/style/map-colors.js

@@ -0,0 +1,82 @@
+const TOKENS = {
+    foreground: '--helix-color-foreground',
+    info: '--helix-color-info',
+    primary: '--helix-color-primary',
+    success: '--helix-color-success',
+    surface: '--helix-color-surface',
+};
+let pixel;
+const toSrgb = (resolved) => {
+    if (pixel === undefined) {
+        const canvas = document.createElement('canvas');
+        canvas.width = 1;
+        canvas.height = 1;
+        pixel = canvas.getContext('2d', { willReadFrequently: true });
+    }
+    const context = pixel;
+    if (!context) {
+        return resolved;
+    }
+    context.clearRect(0, 0, 1, 1);
+    context.fillStyle = resolved;
+    context.fillRect(0, 0, 1, 1);
+    const [red = 0, green = 0, blue = 0, alpha = 255] = context.getImageData(0, 0, 1, 1).data;
+    return alpha === 255
+        ? `rgb(${red}, ${green}, ${blue})`
+        : `rgba(${red}, ${green}, ${blue}, ${alpha / 255})`;
+};
+export const settledColor = (element, property = 'color') => toSrgb(getComputedStyle(element).getPropertyValue(property));
+export const mapColorsFrom = (element) => {
+    const probe = document.createElement('span');
+    probe.style.display = 'none';
+    element.append(probe);
+    const read = (token) => {
+        if (getComputedStyle(probe).getPropertyValue(token).trim() === '') {
+            probe.remove();
+            throw new Error(`mapColorsFrom: \`${token}\` is not defined where the map is. Load @fusion.dev/helix-styles, whose token layer defines it.`);
+        }
+        probe.style.color = `var(${token})`;
+        return toSrgb(getComputedStyle(probe).color);
+    };
+    const colors = Object.fromEntries(Object.entries(TOKENS).map(([name, token]) => [name, read(token)]));
+    probe.remove();
+    return colors;
+};
+export const colorsNow = (element) => {
+    try {
+        return mapColorsFrom(element);
+    }
+    catch {
+        return null;
+    }
+};
+export const mapFontFrom = (element) => {
+    const probe = document.createElement('span');
+    probe.style.display = 'none';
+    probe.style.fontFamily = 'var(--helix-font-sans)';
+    element.append(probe);
+    const stack = getComputedStyle(probe).fontFamily;
+    probe.remove();
+    return (stack
+        .split(',')[0]
+        ?.trim()
+        .replace(/^["']|["']$/g, '') || 'sans-serif');
+};
+export const fontReady = async (font) => {
+    if (typeof document === 'undefined' || !document.fonts) {
+        return;
+    }
+    await Promise.all(['400', '500', '700', 'italic 400'].map((face) => document.fonts.load(`${face} 24px "${font}"`).catch(() => [])));
+};
+export const PATIENCE = 180;
+export const colorsReady = async (element) => {
+    for (let waited = 0; waited < PATIENCE; waited++) {
+        const colors = colorsNow(element);
+        if (colors) {
+            return colors;
+        }
+        await new Promise((next) => requestAnimationFrame(next));
+    }
+    return mapColorsFrom(element);
+};
+//# sourceMappingURL=map-colors.js.map

package/dist/style/map-colors.js.map

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