@react-x11/components 0.4.0 → 0.5.0

package/dist/maps/sources.d.ts

@@ -0,0 +1,256 @@
+import type { VectorTile } from './mvt.js';
+import type { TileId } from './proj.js';
+/** Which tile a source is being asked for. */
+export interface TileRequest extends TileId {
+    /** The source's own id, for an application serving several from one
+     *  loader. */
+    sourceId: string;
+    /**
+     * Aborted when the tile leaves the view before it arrives.
+     *
+     * **This is a real `AbortSignal`** on every runtime that has one, which
+     * is what makes `fetch(url, { signal })` work — `fetch` rejects anything
+     * that is not an instance of it (`TypeError: Expected signal … to be an
+     * instance of AbortSignal`), so a look-alike would fail every load.
+     * `undefined` on a runtime with no `AbortController`.
+     *
+     * It is *typed* structurally because `src/` compiles with no DOM lib and
+     * cannot name the class, which is why an application in TypeScript casts:
+     * `fetch(url, { signal: signal as AbortSignal })`.
+     */
+    signal: {
+        readonly aborted: boolean;
+        addEventListener?: unknown;
+    } | undefined;
+}
+/** Raw tile bytes, or pixels, or nothing. */
+export type TileData = 
+/** Mapbox Vector Tile bytes. Gzip is unwrapped for you, so either the
+ *  compressed or the decompressed body is fine. */
+{
+    kind: 'vector';
+    data: Uint8Array;
+}
+/**
+ * Decoded pixels: straight (non-premultiplied) RGBA, rows top to bottom
+ * — the canvas contract, and what ntk's own `decodeImage` produces.
+ *
+ * Bytes rather than a PNG or a JPEG on purpose. Decoding an image format
+ * needs a codec, and this package will not grow one or assume which of
+ * them a provider serves; the application already has ntk's, through
+ * `react-x11/ntk`, and the docs page has the four-line adapter.
+ */
+ | {
+    kind: 'raster';
+    width: number;
+    height: number;
+    data: Uint8Array;
+}
+/** There is no tile here. An ordinary state — an ocean tile in a
+ *  land-only pyramid, a 404 — and never an error. */
+ | null;
+/** A tile source. */
+export interface MapSource {
+    /** Distinguishes this source's cache entries from another's. Defaults to
+     *  the source's position in the `sources` array. */
+    id?: string;
+    /** Fetch, or answer from a cache, or decline. May be async. */
+    load(request: TileRequest): TileData | Promise<TileData>;
+    /** The shallowest and deepest levels this source has data for. Outside
+     *  the range the nearest level is used and scaled — "overzoom" above,
+     *  which is how a z14 pyramid serves a z18 view. Defaults to 0 and 14. */
+    minZoom?: number;
+    maxZoom?: number;
+    /** Edge length of one tile in logical pixels: 512 for most vector
+     *  pyramids, 256 for the older raster convention. */
+    tileSize?: number;
+    /**
+     * The attribution this source's licence requires, drawn in the corner of
+     * the map.
+     *
+     * Not optional in practice for open data, which is why it is a field of
+     * the source rather than a prop of the map: whoever chose the tiles is
+     * who knows what has to be said about them.
+     */
+    attribution?: string;
+}
+/** A source's pyramid, with the defaults filled in. */
+export declare function pyramidOf(source: MapSource): {
+    minZoom: number;
+    maxZoom: number;
+    tileSize: number;
+};
+/** Substitute `{z}`, `{x}`, `{y}` — and `{s}` from `subdomains`, which the
+ *  older raster services still shard on. */
+export declare function tileUrl(template: string, tile: TileId, subdomains?: readonly string[]): string;
+/** What every OpenStreetMap-derived map has to say. */
+export declare const OSM_ATTRIBUTION = "\u00A9 OpenStreetMap contributors";
+/** Where the OSM Foundation serves Shortbread vector tiles. */
+export declare const OSM_VECTOR_URL = "https://vector.openstreetmap.org/shortbread_v1/{z}/{x}/{y}.mvt";
+/** …and the classic raster layer. */
+export declare const OSM_RASTER_URL = "https://tile.openstreetmap.org/{z}/{x}/{y}.png";
+/** What a ready-made adapter still needs from the application. */
+export interface OsmSourceOptions {
+    /**
+     * Fetch one URL. **Required**, and required on purpose — see the note at
+     * the top of this file. The whole of it is usually:
+     *
+     * ```ts
+     * fetch: async (url, signal) => {
+     *   const response = await fetch(url, {
+     *     signal,
+     *     headers: { 'user-agent': 'my-app/1.0 (me@example.com)' },
+     *   });
+     *   if (response.status === 404) return null;
+     *   if (!response.ok) throw new Error(`HTTP ${response.status}`);
+     *   return new Uint8Array(await response.arrayBuffer());
+     * }
+     * ```
+     *
+     * `null` means "no tile here", which is an ordinary answer.
+     */
+    fetch: (url: string, signal: TileRequest['signal'], tile: TileId) => Promise<Uint8Array | null> | Uint8Array | null;
+    /** Serve from somewhere else — a mirror, a proxy, a local tile server. */
+    url?: string;
+    id?: string;
+    attribution?: string;
+    maxZoom?: number;
+}
+/**
+ * OpenStreetMap's own vector tiles, in the Shortbread schema.
+ *
+ * Pairs with {@link shortbreadStyle}, which is written against the same
+ * schema. z14 is the deepest level cut; a view past it overzooms, which is
+ * what every client does with this pyramid.
+ *
+ * **Read the OSM tile usage policy before shipping.** It asks for a
+ * user-agent identifying the application, and it is not a CDN for an
+ * application with real traffic — which is exactly why `fetch` is the
+ * caller's.
+ */
+export declare function osmVectorSource(options: OsmSourceOptions): MapSource;
+/**
+ * OpenStreetMap's raster tiles — the standard style, as `openstreetmap.org`
+ * draws it.
+ *
+ * `decode` is the second thing the application supplies, because a PNG
+ * needs a codec and this package will not grow one. ntk already has one,
+ * and it is already installed:
+ *
+ * ```ts
+ * import ntk from 'react-x11/ntk';
+ * const decode = (bytes) => {
+ *   const image = (ntk as { decodeImage(b: Uint8Array): {
+ *     width: number; height: number; data: Uint8Array } }).decodeImage(bytes);
+ *   return { width: image.width, height: image.height, data: image.data };
+ * };
+ * ```
+ */
+export declare function osmRasterSource(options: OsmSourceOptions & {
+    decode: (bytes: Uint8Array) => {
+        width: number;
+        height: number;
+        data: Uint8Array;
+    };
+    subdomains?: readonly string[];
+}): MapSource;
+/** Decode vector tile bytes. Exported so an application holding a `.mvt`
+ *  of its own can hand the map a parsed tile through a source. */
+export declare function parseVectorTile(bytes: Uint8Array): VectorTile;
+/**
+ * What Google's Map Tiles API hands back for a session request.
+ *
+ * Written out structurally rather than imported: this package has no Google
+ * dependency and is not about to grow one.
+ */
+export interface GoogleSession {
+    /** The token every tile request carries. */
+    session: string;
+    /** Usually 256. */
+    tileWidth?: number;
+    tileHeight?: number;
+    /** `'png'` or `'jpeg'`. */
+    imageFormat?: string;
+    /** Seconds since the epoch, as a string, per the API. */
+    expiry?: string;
+}
+export interface GoogleTileSourceOptions {
+    /**
+     * Fetch one tile URL. The application's, exactly as every other source
+     * here — see the note at the top of this file.
+     */
+    fetch: (url: string, signal: TileRequest['signal'], tile: TileId) => Promise<Uint8Array | null> | Uint8Array | null;
+    /**
+     * Create a session, by POSTing `body` as JSON to
+     * `https://tile.googleapis.com/v1/createSession?key=…`, and hand back
+     * what it answered.
+     *
+     * A separate callback from `fetch` because it is a POST with a JSON body
+     * and a key in the query, which the tile-fetching shape cannot express —
+     * and because it is where the API key lives, which is the application's
+     * secret and not something to hand a component.
+     *
+     * Called lazily on the first tile and again when the session expires;
+     * Google's are good for two weeks.
+     */
+    createSession: (body: Record<string, unknown>) => Promise<GoogleSession>;
+    /**
+     * Decode the PNG or JPEG. Google's 2D tiles are **raster** — there is no
+     * public vector endpoint and no published schema — so a codec is needed
+     * exactly as it is for `osmRasterSource`.
+     */
+    decode: (bytes: Uint8Array) => {
+        width: number;
+        height: number;
+        data: Uint8Array;
+    };
+    /** `'roadmap'` (the default), `'satellite'` or `'terrain'`. Satellite is
+     *  the one thing OpenStreetMap has no answer for at all. */
+    mapType?: 'roadmap' | 'satellite' | 'terrain';
+    /** `'layerRoadmap'` over satellite or terrain, `'layerStreetview'`. */
+    layerTypes?: readonly string[];
+    /** IETF language tag and CLDR region — Google's cartography is localized
+     *  server-side, which is the other thing you cannot do with a style. */
+    language?: string;
+    region?: string;
+    /** `'scaleFactor1x'`, `'scaleFactor2x'`, `'scaleFactor4x'`. */
+    scale?: string;
+    highDpi?: boolean;
+    id?: string;
+    maxZoom?: number;
+    /**
+     * What is drawn in the corner. **Do not remove it.** Google's Map Tiles
+     * API policies require the Google Maps logo, or the text "Google Maps"
+     * where space is limited, together with the data providers — and require
+     * that it is not obscured by anyone else's attribution. This component
+     * draws attribution as text, so the text form is what it can satisfy;
+     * a logo is an overlay of your own (`<Map>` takes `children`).
+     */
+    attribution?: string;
+}
+/**
+ * Google's Map Tiles API, as a `MapSource`.
+ *
+ * **Raster, and that is not a limitation of this adapter.** Google publishes
+ * no vector tile endpoint and no schema, so there is nothing for a
+ * `mapStyle` to name: what arrives is Google's own cartography, already
+ * drawn. `mapType` and `language` are the styling controls, and they are
+ * applied server-side when the session is created.
+ *
+ * Three things about it that differ from every other source here, and each
+ * is the API's rather than this package's:
+ *
+ * - **A session token comes first.** One POST, reused for every tile,
+ *   good for two weeks, and it is what carries the display options — so
+ *   changing `mapType` means a new session, which this handles by making a
+ *   new source.
+ * - **A key is required**, and it is yours: it goes in `createSession` and
+ *   in the tile URL, both of which are the application's callbacks.
+ * - **The terms restrict caching.** `<Map>` keeps parsed tiles and rendered
+ *   surfaces in memory for the session, which is what any renderer does;
+ *   writing tiles to disk is a different thing and the policies forbid it.
+ *   Read them before shipping — they also govern showing Google's tiles
+ *   beside another map's.
+ */
+export declare function googleTileSource(options: GoogleTileSourceOptions): MapSource;
+//# sourceMappingURL=sources.d.ts.map

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

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

package/dist/maps/sources.js

@@ -0,0 +1,210 @@
+// Where tiles come from — and, deliberately, not how they are fetched.
+//
+// **Nothing in this package makes a network request.** That is the same
+// call `src/html/` makes about `onResource` and `src/desktop-calendar/`
+// makes about credentials, and it is the rule rather than an omission: a
+// component that quietly fetched would turn "render this map" into "make
+// these requests to this company", with the map's own default deciding
+// whose servers an application talks to, what its user agent says, and
+// whose usage policy it is now bound by. A tile source is a function the
+// application supplies, and the adapters below are the *arguments* to it —
+// URL templates and a decoder — not a fetch.
+//
+// {@link osmVectorSource} and {@link osmRasterSource} exist because the two
+// keyless, open, canonical OpenStreetMap endpoints are what make
+// `<Map source={…} />` a line that works with no signup; both still take
+// the application's own `load`, and both carry the attribution the licence
+// requires.
+import { gunzipIfNeeded } from './gzip.js';
+import { parseTile } from './mvt.js';
+import { DEFAULT_TILE_SIZE } from './proj.js';
+/** A source's pyramid, with the defaults filled in. */
+export function pyramidOf(source) {
+    return {
+        minZoom: source.minZoom ?? 0,
+        maxZoom: source.maxZoom ?? 14,
+        tileSize: source.tileSize ?? DEFAULT_TILE_SIZE,
+    };
+}
+/** Substitute `{z}`, `{x}`, `{y}` — and `{s}` from `subdomains`, which the
+ *  older raster services still shard on. */
+export function tileUrl(template, tile, subdomains) {
+    let url = template
+        .replace('{z}', String(tile.z))
+        .replace('{x}', String(tile.x))
+        .replace('{y}', String(tile.y));
+    if (subdomains && subdomains.length > 0) {
+        // Deterministic in the tile, so the same tile always goes to the same
+        // host and a browser-style connection cache is not defeated.
+        const index = (tile.x + tile.y) % subdomains.length;
+        url = url.replace('{s}', subdomains[index]);
+    }
+    return url;
+}
+/** What every OpenStreetMap-derived map has to say. */
+export const OSM_ATTRIBUTION = '© OpenStreetMap contributors';
+/** Where the OSM Foundation serves Shortbread vector tiles. */
+export const OSM_VECTOR_URL = 'https://vector.openstreetmap.org/shortbread_v1/{z}/{x}/{y}.mvt';
+/** …and the classic raster layer. */
+export const OSM_RASTER_URL = 'https://tile.openstreetmap.org/{z}/{x}/{y}.png';
+/**
+ * OpenStreetMap's own vector tiles, in the Shortbread schema.
+ *
+ * Pairs with {@link shortbreadStyle}, which is written against the same
+ * schema. z14 is the deepest level cut; a view past it overzooms, which is
+ * what every client does with this pyramid.
+ *
+ * **Read the OSM tile usage policy before shipping.** It asks for a
+ * user-agent identifying the application, and it is not a CDN for an
+ * application with real traffic — which is exactly why `fetch` is the
+ * caller's.
+ */
+export function osmVectorSource(options) {
+    const url = options.url ?? OSM_VECTOR_URL;
+    return {
+        id: options.id ?? 'osm-vector',
+        minZoom: 0,
+        maxZoom: options.maxZoom ?? 14,
+        tileSize: 512,
+        attribution: options.attribution ?? OSM_ATTRIBUTION,
+        async load(request) {
+            const bytes = await options.fetch(tileUrl(url, request), request.signal, request);
+            if (!bytes || bytes.length === 0)
+                return null;
+            return { kind: 'vector', data: gunzipIfNeeded(bytes) };
+        },
+    };
+}
+/**
+ * OpenStreetMap's raster tiles — the standard style, as `openstreetmap.org`
+ * draws it.
+ *
+ * `decode` is the second thing the application supplies, because a PNG
+ * needs a codec and this package will not grow one. ntk already has one,
+ * and it is already installed:
+ *
+ * ```ts
+ * import ntk from 'react-x11/ntk';
+ * const decode = (bytes) => {
+ *   const image = (ntk as { decodeImage(b: Uint8Array): {
+ *     width: number; height: number; data: Uint8Array } }).decodeImage(bytes);
+ *   return { width: image.width, height: image.height, data: image.data };
+ * };
+ * ```
+ */
+export function osmRasterSource(options) {
+    const url = options.url ?? OSM_RASTER_URL;
+    return {
+        id: options.id ?? 'osm-raster',
+        minZoom: 0,
+        maxZoom: options.maxZoom ?? 19,
+        tileSize: 256,
+        attribution: options.attribution ?? OSM_ATTRIBUTION,
+        async load(request) {
+            const bytes = await options.fetch(tileUrl(url, request, options.subdomains), request.signal, request);
+            if (!bytes || bytes.length === 0)
+                return null;
+            const image = options.decode(bytes);
+            return {
+                kind: 'raster',
+                width: image.width,
+                height: image.height,
+                data: image.data,
+            };
+        },
+    };
+}
+/** Decode vector tile bytes. Exported so an application holding a `.mvt`
+ *  of its own can hand the map a parsed tile through a source. */
+export function parseVectorTile(bytes) {
+    return parseTile(gunzipIfNeeded(bytes));
+}
+/**
+ * Google's Map Tiles API, as a `MapSource`.
+ *
+ * **Raster, and that is not a limitation of this adapter.** Google publishes
+ * no vector tile endpoint and no schema, so there is nothing for a
+ * `mapStyle` to name: what arrives is Google's own cartography, already
+ * drawn. `mapType` and `language` are the styling controls, and they are
+ * applied server-side when the session is created.
+ *
+ * Three things about it that differ from every other source here, and each
+ * is the API's rather than this package's:
+ *
+ * - **A session token comes first.** One POST, reused for every tile,
+ *   good for two weeks, and it is what carries the display options — so
+ *   changing `mapType` means a new session, which this handles by making a
+ *   new source.
+ * - **A key is required**, and it is yours: it goes in `createSession` and
+ *   in the tile URL, both of which are the application's callbacks.
+ * - **The terms restrict caching.** `<Map>` keeps parsed tiles and rendered
+ *   surfaces in memory for the session, which is what any renderer does;
+ *   writing tiles to disk is a different thing and the policies forbid it.
+ *   Read them before shipping — they also govern showing Google's tiles
+ *   beside another map's.
+ */
+export function googleTileSource(options) {
+    let session = null;
+    let pending = null;
+    let tileSize = 256;
+    const ensure = async () => {
+        const expiry = Number(session?.expiry ?? 0);
+        // A minute of slack, so a token does not expire between being chosen
+        // and being used.
+        if (session && (!expiry || expiry * 1000 > Date.now() + 60_000)) {
+            return session;
+        }
+        if (!pending) {
+            pending = Promise.resolve(options.createSession({
+                mapType: options.mapType ?? 'roadmap',
+                language: options.language ?? 'en-US',
+                region: options.region ?? 'US',
+                ...(options.layerTypes
+                    ? { layerTypes: [...options.layerTypes] }
+                    : {}),
+                ...(options.scale ? { scale: options.scale } : {}),
+                ...(options.highDpi !== undefined
+                    ? { highDpi: options.highDpi }
+                    : {}),
+            }))
+                .then((answer) => {
+                session = answer;
+                if (answer.tileWidth && answer.tileWidth > 0) {
+                    tileSize = answer.tileWidth;
+                }
+                return answer;
+            })
+                .finally(() => {
+                pending = null;
+            });
+        }
+        return pending;
+    };
+    return {
+        id: options.id ?? `google-${options.mapType ?? 'roadmap'}`,
+        minZoom: 0,
+        // Google serves to 22, deeper than any vector pyramid here — and since
+        // these are finished images there is nothing to sub-tile past it.
+        maxZoom: options.maxZoom ?? 22,
+        get tileSize() {
+            return tileSize;
+        },
+        attribution: options.attribution ?? 'Google Maps',
+        async load(request) {
+            const token = await ensure();
+            const url = `https://tile.googleapis.com/v1/2dtiles/${request.z}/${request.x}/${request.y}` +
+                `?session=${encodeURIComponent(token.session)}`;
+            const bytes = await options.fetch(url, request.signal, request);
+            if (!bytes || bytes.length === 0)
+                return null;
+            const image = options.decode(bytes);
+            return {
+                kind: 'raster',
+                width: image.width,
+                height: image.height,
+                data: image.data,
+            };
+        },
+    };
+}
+//# sourceMappingURL=sources.js.map

package/dist/maps/sources.js.map

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

package/dist/maps/style.d.ts

@@ -0,0 +1,141 @@
+import type { FeatureValue } from './mvt.js';
+import type { FeatureCursor } from './mvt.js';
+/**
+ * A value that may vary with the zoom.
+ *
+ * A bare value is constant. `{ stops }` is a list of `[zoom, value]` pairs,
+ * ordered by zoom: numbers interpolate linearly between the surrounding
+ * pair, and anything else steps at each stop. Outside the range the nearest
+ * stop holds, which is what makes a two-stop ramp a sensible whole answer
+ * rather than something that vanishes at zoom 0.
+ */
+export type Zoomed<T> = T | {
+    stops: readonly (readonly [number, T])[];
+};
+/** Mapbox's legacy filter syntax, which is the part of it a style here
+ *  speaks. Compiled with {@link compileFilter}. */
+export type MapFilter = readonly ['==' | '!=', string, FeatureValue] | readonly ['<' | '<=' | '>' | '>=', string, number] | readonly ['in' | '!in', string, ...FeatureValue[]] | readonly ['has' | '!has', string] | readonly ['all' | 'any' | 'none', ...MapFilter[]] | readonly ['geometry', 'point' | 'line' | 'polygon'];
+interface LayerBase {
+    /** This layer's name in the style. Used in a `<Map>` event payload and as
+     *  the cache key for anything derived from it. */
+    id: string;
+    /** Which source, when the map has more than one. The first source by
+     *  default. */
+    source?: string;
+    /** Which layer of the tile — `'streets'`, `'water_polygons'`. */
+    sourceLayer: string;
+    /** The zoom range this layer draws in. A layer outside its range costs
+     *  nothing: it is skipped before its features are touched. */
+    minZoom?: number;
+    maxZoom?: number;
+    filter?: MapFilter;
+    /** `false` keeps the layer in the style and stops drawing it — what a
+     *  layer toggle in an application's UI switches. */
+    visible?: boolean;
+}
+/** An area. */
+export interface FillLayer extends LayerBase {
+    type: 'fill';
+    color: Zoomed<string>;
+    opacity?: Zoomed<number>;
+    /** Stroked at one logical pixel around each ring, after the fill. */
+    outlineColor?: Zoomed<string>;
+}
+/** A line: a road, a river, a boundary, a route. */
+export interface LineLayer extends LayerBase {
+    type: 'line';
+    color: Zoomed<string>;
+    /** Logical pixels. */
+    width: Zoomed<number>;
+    opacity?: Zoomed<number>;
+    /** A dash pattern in logical pixels. */
+    dash?: readonly number[];
+    cap?: 'butt' | 'round' | 'square';
+    join?: 'miter' | 'round' | 'bevel';
+}
+/** A point, as a disc. */
+export interface CircleLayer extends LayerBase {
+    type: 'circle';
+    radius: Zoomed<number>;
+    color: Zoomed<string>;
+    opacity?: Zoomed<number>;
+    strokeColor?: Zoomed<string>;
+    strokeWidth?: Zoomed<number>;
+}
+/**
+ * A label.
+ *
+ * Symbol layers are **not** rasterized into the tile: they are collected as
+ * candidates, placed against every other label on screen, and drawn into
+ * the frame directly. Three reasons, and each of them is a bug if it is
+ * done the other way. Collision is global — two labels in different tiles
+ * overlap just as readily as two in one — so a per-tile placement produces
+ * a map that reads as clutter at every seam. A label baked into a tile
+ * surface is stretched by the fractional zoom, and text is the one thing on
+ * a map nobody accepts blurred. And a tile's labels would be clipped at its
+ * edge, which is exactly where half of them sit.
+ */
+export interface SymbolLayer extends LayerBase {
+    type: 'symbol';
+    /** The tag to read the text from — `'name'`, or `'name:en'`. */
+    textField: string;
+    /** Logical pixels. */
+    textSize?: Zoomed<number>;
+    textColor?: Zoomed<string>;
+    /** Drawn under the glyphs, so a place name stays readable over a road. */
+    textHaloColor?: Zoomed<string>;
+    textHaloWidth?: Zoomed<number>;
+    /**
+     * Which label wins a collision, layer-wide. Higher wins; 0 by default,
+     * and the style's layer order breaks a tie.
+     *
+     * Deliberately not a per-feature expression. A schema's own importance
+     * field looks like the obvious input and is not usable as one: Shortbread
+     * carries `population`, which is 8,000,000 for London and 500 for Soho,
+     * so adding it to a rank that also has to order against street names
+     * needs a normalization nobody can guess. Splitting by `filter` — a layer
+     * for cities, a layer for suburbs — is exact, is what the ordering
+     * actually wants, and costs one more entry in a list.
+     */
+    rank?: number;
+    /**
+     * How far apart, in pixels, the same text may repeat within this layer.
+     * 250 by default; `0` lets it repeat as often as it fits.
+     *
+     * Not a nicety. A street is one feature **per segment** in every schema
+     * there is, so `street_labels` offers "Oxford Street" a dozen times over
+     * for one street, and a placement that only tests overlap accepts all
+     * twelve — they do not overlap, they are strung out along the road. The
+     * same is true of an administrative area whose name arrives once per
+     * polygon part. Repeating a long street's name across a wide view is
+     * wanted; repeating it four times in a hundred pixels is not, and the
+     * distance is where that line goes.
+     */
+    repeatDistance?: number;
+}
+export type MapStyleLayer = FillLayer | LineLayer | CircleLayer | SymbolLayer;
+/** A whole style. */
+export interface MapStyle {
+    /** Painted under every tile — the colour of the parts of the world that
+     *  have no data yet, so it is what a map looks like while it loads. */
+    background?: string;
+    layers: readonly MapStyleLayer[];
+    /** The face labels are set in. The theme's `fontFamily` by default. */
+    fontFamily?: string;
+}
+/** A {@link Zoomed} at one zoom. Numbers interpolate, everything else
+ *  steps. */
+export declare function resolveZoomed<T>(value: Zoomed<T>, zoom: number): T;
+/** A compiled filter: the shape the rasterizer calls per feature. */
+export type CompiledFilter = (feature: FeatureCursor) => boolean;
+/**
+ * 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 declare function compileFilter(filter: MapFilter | undefined): CompiledFilter;
+export {};
+//# sourceMappingURL=style.d.ts.map

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

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