@react-x11/components 0.4.0 → 0.5.0

package/dist/maps/clip.d.ts

@@ -0,0 +1,43 @@
+/** The clip window, in the same target pixels the path is built in. */
+export interface ClipRect {
+    minX: number;
+    minY: number;
+    maxX: number;
+    maxY: number;
+}
+/**
+ * How far outside the pane geometry is still kept.
+ *
+ * Not zero: a line clipped exactly at the edge would have its join and its
+ * cap drawn at the boundary rather than outside it, which shows as a blunt
+ * end against the pane's edge. A margin wider than any stroke this draws
+ * puts those artefacts off-screen, and is still far inside the range that
+ * overflows.
+ */
+export declare const CLIP_MARGIN = 256;
+export declare function clipOf(pane: {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}, scale: number): ClipRect;
+/**
+ * Cohen-Sutherland: the visible piece of one segment, or null.
+ *
+ * Chosen over Liang-Barsky because the common case here is a segment wholly
+ * inside or wholly outside, and both are answered by one `&`/`|` of the two
+ * endpoints' codes with no arithmetic at all.
+ */
+export declare function clipSegment(ax: number, ay: number, bx: number, by: number, clip: ClipRect): [number, number, number, number] | null;
+/**
+ * Sutherland-Hodgman: a ring clipped to the rectangle, in place of the
+ * original.
+ *
+ * Rings rather than segments, because a fill needs a closed boundary: the
+ * part of a polygon that crosses the window has to come back along the
+ * window's edge, which segment clipping cannot produce. Winding is
+ * preserved, so an interior ring stays an interior ring and the non-zero
+ * fill still puts a hole where one belongs.
+ */
+export declare function clipRing(points: readonly number[], clip: ClipRect): number[];
+//# sourceMappingURL=clip.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"clip.d.ts","sourceRoot":"","sources":["../../src/maps/clip.ts"],"names":[],"mappings":"AAsBA,uEAAuE;AACvE,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,WAAW,MAAM,CAAC;AAE/B,wBAAgB,MAAM,CACpB,IAAI,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,EAC7D,KAAK,EAAE,MAAM,GACZ,QAAQ,CAOV;AAiBD;;;;;;GAMG;AACH,wBAAgB,WAAW,CACzB,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,QAAQ,GACb,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAoCzC;AAED;;;;;;;;;GASG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,GAAG,MAAM,EAAE,CAsD5E"}

package/dist/maps/clip.js

@@ -0,0 +1,171 @@
+// Clipping geometry to the target, and why anything has to.
+//
+// **Coordinates in this renderer are bounded and the world's are not.**
+// ntk hands a stroke's geometry to XRender as 16.16 fixed point, which
+// overflows a signed 32-bit word at 32,768, and a composite's coordinates
+// are int16. Two things routinely exceed that:
+//
+//  - an **overlay**, which is geography: a route's far end stays where it
+//    is when the camera zooms into one corner of it, and a world is
+//    `512 · 2^zoom` pixels — 134 million at zoom 20;
+//  - a **tile drawn past its own depth**, where one source tile is
+//    rasterized into each cell of a grid over it, so a tile-wide polygon is
+//    `span` tiles wide in the surface's pixels.
+//
+// Both want the same two algorithms, so they live here rather than twice.
+// Cohen-Sutherland for a line, because the common case is a segment wholly
+// inside or wholly outside and both are answered by one `&`/`|` of the
+// endpoints' codes with no arithmetic at all; Sutherland-Hodgman for an
+// area, because a fill needs a closed boundary — the part of a polygon that
+// crosses the window has to come back along the window's edge, which
+// segment clipping cannot produce.
+/**
+ * How far outside the pane geometry is still kept.
+ *
+ * Not zero: a line clipped exactly at the edge would have its join and its
+ * cap drawn at the boundary rather than outside it, which shows as a blunt
+ * end against the pane's edge. A margin wider than any stroke this draws
+ * puts those artefacts off-screen, and is still far inside the range that
+ * overflows.
+ */
+export const CLIP_MARGIN = 256;
+export function clipOf(pane, scale) {
+    return {
+        minX: (pane.x - CLIP_MARGIN) * scale,
+        minY: (pane.y - CLIP_MARGIN) * scale,
+        maxX: (pane.x + pane.width + CLIP_MARGIN) * scale,
+        maxY: (pane.y + pane.height + CLIP_MARGIN) * scale,
+    };
+}
+const INSIDE = 0;
+const LEFT = 1;
+const RIGHT = 2;
+const BOTTOM = 4;
+const TOP = 8;
+function outcode(x, y, clip) {
+    let code = INSIDE;
+    if (x < clip.minX)
+        code |= LEFT;
+    else if (x > clip.maxX)
+        code |= RIGHT;
+    if (y < clip.minY)
+        code |= BOTTOM;
+    else if (y > clip.maxY)
+        code |= TOP;
+    return code;
+}
+/**
+ * Cohen-Sutherland: the visible piece of one segment, or null.
+ *
+ * Chosen over Liang-Barsky because the common case here is a segment wholly
+ * inside or wholly outside, and both are answered by one `&`/`|` of the two
+ * endpoints' codes with no arithmetic at all.
+ */
+export function clipSegment(ax, ay, bx, by, clip) {
+    let x0 = ax;
+    let y0 = ay;
+    let x1 = bx;
+    let y1 = by;
+    let code0 = outcode(x0, y0, clip);
+    let code1 = outcode(x1, y1, clip);
+    for (;;) {
+        if ((code0 | code1) === 0)
+            return [x0, y0, x1, y1]; // both inside
+        if ((code0 & code1) !== 0)
+            return null; // both beyond one edge
+        const code = code0 !== 0 ? code0 : code1;
+        let x = 0;
+        let y = 0;
+        if (code & TOP) {
+            x = x0 + ((x1 - x0) * (clip.maxY - y0)) / (y1 - y0);
+            y = clip.maxY;
+        }
+        else if (code & BOTTOM) {
+            x = x0 + ((x1 - x0) * (clip.minY - y0)) / (y1 - y0);
+            y = clip.minY;
+        }
+        else if (code & RIGHT) {
+            y = y0 + ((y1 - y0) * (clip.maxX - x0)) / (x1 - x0);
+            x = clip.maxX;
+        }
+        else {
+            y = y0 + ((y1 - y0) * (clip.minX - x0)) / (x1 - x0);
+            x = clip.minX;
+        }
+        if (code === code0) {
+            x0 = x;
+            y0 = y;
+            code0 = outcode(x0, y0, clip);
+        }
+        else {
+            x1 = x;
+            y1 = y;
+            code1 = outcode(x1, y1, clip);
+        }
+    }
+}
+/**
+ * Sutherland-Hodgman: a ring clipped to the rectangle, in place of the
+ * original.
+ *
+ * Rings rather than segments, because a fill needs a closed boundary: the
+ * part of a polygon that crosses the window has to come back along the
+ * window's edge, which segment clipping cannot produce. Winding is
+ * preserved, so an interior ring stays an interior ring and the non-zero
+ * fill still puts a hole where one belongs.
+ */
+export function clipRing(points, clip) {
+    let output = [...points];
+    const edges = [
+        [
+            (x) => x >= clip.minX,
+            (ax, ay, bx, by) => [
+                clip.minX,
+                ay + ((by - ay) * (clip.minX - ax)) / (bx - ax),
+            ],
+        ],
+        [
+            (x) => x <= clip.maxX,
+            (ax, ay, bx, by) => [
+                clip.maxX,
+                ay + ((by - ay) * (clip.maxX - ax)) / (bx - ax),
+            ],
+        ],
+        [
+            (_x, y) => y >= clip.minY,
+            (ax, ay, bx, by) => [
+                ax + ((bx - ax) * (clip.minY - ay)) / (by - ay),
+                clip.minY,
+            ],
+        ],
+        [
+            (_x, y) => y <= clip.maxY,
+            (ax, ay, bx, by) => [
+                ax + ((bx - ax) * (clip.maxY - ay)) / (by - ay),
+                clip.maxY,
+            ],
+        ],
+    ];
+    for (const [inside, intersect] of edges) {
+        const input = output;
+        output = [];
+        if (input.length < 6)
+            return [];
+        for (let i = 0; i < input.length; i += 2) {
+            const ax = input[i];
+            const ay = input[i + 1];
+            const bx = input[(i + 2) % input.length];
+            const by = input[(i + 3) % input.length];
+            const aIn = inside(ax, ay);
+            const bIn = inside(bx, by);
+            if (aIn)
+                output.push(ax, ay);
+            if (aIn !== bIn) {
+                const [ix, iy] = intersect(ax, ay, bx, by);
+                output.push(ix, iy);
+            }
+        }
+    }
+    return output;
+}
+//# sourceMappingURL=clip.js.map

package/dist/maps/clip.js.map

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

package/dist/maps/gzip.d.ts

@@ -0,0 +1,15 @@
+/** The two bytes every gzip member starts with. */
+export declare function isGzip(bytes: Uint8Array): boolean;
+/**
+ * Teach this package how to un-gzip, for a runtime where it cannot find out
+ * by itself.
+ *
+ * ```ts
+ * import { gunzipSync } from 'node:zlib';
+ * setGunzip((data) => gunzipSync(data));
+ * ```
+ */
+export declare function setGunzip(gunzipSync: (data: Uint8Array) => Uint8Array): void;
+/** The bytes, un-gzipped if they were. */
+export declare function gunzipIfNeeded(bytes: Uint8Array): Uint8Array;
+//# sourceMappingURL=gzip.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"gzip.d.ts","sourceRoot":"","sources":["../../src/maps/gzip.ts"],"names":[],"mappings":"AAiBA,mDAAmD;AACnD,wBAAgB,MAAM,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAEjD;AAQD;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CAAC,UAAU,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,UAAU,GAAG,IAAI,CAE5E;AAeD,0CAA0C;AAC1C,wBAAgB,cAAc,CAAC,KAAK,EAAE,UAAU,GAAG,UAAU,CAU5D"}

package/dist/maps/gzip.js

@@ -0,0 +1,56 @@
+// Un-gzip a tile body, when it is one.
+//
+// Tile servers serve `Content-Encoding: gzip` — which a `fetch` undoes —
+// and a good number of them *also* store the tile gzipped inside that, so
+// the body an application hands over may still have the magic on it. That
+// is a transport detail rather than the decoder's business, so it is
+// unwrapped once, here, and `parseTile` only ever sees protobuf.
+//
+// `node:zlib` is reached the way `src/embed/host.ts` reaches `child_process`
+// and for the same reason: `tsconfig.build.json` sets `types: []`, so `src/`
+// may not name a Node module, and a package that did would stop resolving
+// on a runtime that has no such module. So the module is found on
+// `globalThis` if the host put it there and otherwise not at all — and a
+// runtime with no zlib gets a clear error naming the one line of
+// application code that fixes it, rather than a protobuf parse failure
+// twenty frames away.
+/** The two bytes every gzip member starts with. */
+export function isGzip(bytes) {
+    return bytes.length > 2 && bytes[0] === 0x1f && bytes[1] === 0x8b;
+}
+let zlib;
+/**
+ * Teach this package how to un-gzip, for a runtime where it cannot find out
+ * by itself.
+ *
+ * ```ts
+ * import { gunzipSync } from 'node:zlib';
+ * setGunzip((data) => gunzipSync(data));
+ * ```
+ */
+export function setGunzip(gunzipSync) {
+    zlib = { gunzipSync };
+}
+function findZlib() {
+    if (zlib !== undefined)
+        return zlib;
+    // Node and Bun both expose it on `globalThis` under a `require` that a
+    // bundler will not follow, which is what keeps this out of a browser
+    // bundle. Anything else: no zlib, and `setGunzip` is the way in.
+    const g = globalThis;
+    const module = g.process?.getBuiltinModule?.('node:zlib');
+    zlib = module && typeof module.gunzipSync === 'function' ? module : null;
+    return zlib;
+}
+/** The bytes, un-gzipped if they were. */
+export function gunzipIfNeeded(bytes) {
+    if (!isGzip(bytes))
+        return bytes;
+    const found = findZlib();
+    if (!found) {
+        throw new Error('a gzipped tile arrived and this runtime has no zlib — ' +
+            'un-gzip it in your source, or call setGunzip() once at startup');
+    }
+    return found.gunzipSync(bytes);
+}
+//# sourceMappingURL=gzip.js.map

package/dist/maps/gzip.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gzip.js","sourceRoot":"","sources":["../../src/maps/gzip.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,EAAE;AACF,yEAAyE;AACzE,0EAA0E;AAC1E,0EAA0E;AAC1E,qEAAqE;AACrE,iEAAiE;AACjE,EAAE;AACF,6EAA6E;AAC7E,6EAA6E;AAC7E,0EAA0E;AAC1E,kEAAkE;AAClE,yEAAyE;AACzE,iEAAiE;AACjE,uEAAuE;AACvE,sBAAsB;AAEtB,mDAAmD;AACnD,MAAM,UAAU,MAAM,CAAC,KAAiB;IACtC,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;AACpE,CAAC;AAMD,IAAI,IAA6B,CAAC;AAElC;;;;;;;;GAQG;AACH,MAAM,UAAU,SAAS,CAAC,UAA4C;IACpE,IAAI,GAAG,EAAE,UAAU,EAAE,CAAC;AACxB,CAAC;AAED,SAAS,QAAQ;IACf,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IACpC,uEAAuE;IACvE,qEAAqE;IACrE,iEAAiE;IACjE,MAAM,CAAC,GAAG,UAET,CAAC;IACF,MAAM,MAAM,GAAG,CAAC,CAAC,OAAO,EAAE,gBAAgB,EAAE,CAAC,WAAW,CAAqB,CAAC;IAC9E,IAAI,GAAG,MAAM,IAAI,OAAO,MAAM,CAAC,UAAU,KAAK,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;IACzE,OAAO,IAAI,CAAC;AACd,CAAC;AAED,0CAA0C;AAC1C,MAAM,UAAU,cAAc,CAAC,KAAiB;IAC9C,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACjC,MAAM,KAAK,GAAG,QAAQ,EAAE,CAAC;IACzB,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CACb,wDAAwD;YACtD,gEAAgE,CACnE,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;AACjC,CAAC"}

package/dist/maps/index.d.ts

@@ -0,0 +1,55 @@
+import type { ReactElement } from 'react';
+import { ELEMENT, MapViewNode } from './node.js';
+import type { MapProps, MapViewProps } from './types.js';
+/**
+ * A map.
+ *
+ * ```tsx
+ * const source = osmVectorSource({
+ *   fetch: async (url, signal) => {
+ *     const response = await fetch(url, { signal });
+ *     if (response.status === 404) return null;
+ *     return new Uint8Array(await response.arrayBuffer());
+ *   },
+ * });
+ *
+ * <Map
+ *   sources={[source]}
+ *   defaultCamera={{ center: { lon: -0.1281, lat: 51.508 }, zoom: 13 }}
+ *   markers={[{ id: 'home', position: { lon: -0.1281, lat: 51.508 } }]}
+ *   onMarkerClick={(marker) => select(marker.id)}
+ * />
+ * ```
+ *
+ * Pass `camera` and `onCameraChange` instead of `defaultCamera` for the
+ * controlled form, where the application owns where the map is looking.
+ */
+export declare function Map(props: MapProps): ReactElement;
+/** The host element name, for an application that would rather write
+ *  `<mapview>`. The raw element is the whole component minus the
+ *  controlled/uncontrolled fork and the box around it. */
+export { ELEMENT as MAPVIEW_ELEMENT, MapViewNode };
+export { DEFAULT_TILE_SIZE, EARTH_CIRCUMFERENCE, EARTH_RADIUS, MAX_LATITUDE, boundsOf, cameraForBounds, dataTileFor, distanceMetres, latFromMercatorY, lonFromMercatorX, mercatorScale, mercatorXFromLon, mercatorYFromLat, metresPerPixel, parentTile, project, projectLngLat, projectPoint, rasterFor, sourceZoomFor, subTileOf, tileBounds, tileContains, tileCountAt, tileCover, tileKey, tileOf, tileTransform, transformFor, unproject, unprojectPoint, visibleBounds, worldSize, zoomOffsetFor, wrapLon, wrapTileX, } from './proj.js';
+export { OSM_ATTRIBUTION, OSM_RASTER_URL, OSM_VECTOR_URL, googleTileSource, osmRasterSource, osmVectorSource, parseVectorTile, pyramidOf, tileUrl, } from './sources.js';
+export { setGunzip } from './gzip.js';
+export { DARK_PALETTE, LIGHT_PALETTE, openMapTilesStyle, shortbreadStyle, } from './styles.js';
+export { compileFilter, resolveZoomed } from './style.js';
+export { decodePolyline, geoJsonOverlays, markerAt, markerRect, } from './overlay.js';
+export { GeomType, GeometryBuffer, MvtError, parseTile } from './mvt.js';
+export { TileCache } from './tiles.js';
+export type { FitBoundsOptions, MapFrameStats, MapHandle, MapPointerEvent, MapProps, MapViewProps, } from './types.js';
+export type { LngLat, LngLatBounds, MapCamera, MercatorPoint, TileCoverEntry, TileId, TilePyramid, TileRaster, Transform, } from './proj.js';
+export type { GoogleSession, GoogleTileSourceOptions, MapSource, TileData, TileRequest, } from './sources.js';
+export type { MapMarker, MapOverlay, GeoJsonLike } from './overlay.js';
+export type { CircleLayer, FillLayer, LineLayer, MapFilter, MapStyle, MapStyleLayer, SymbolLayer, Zoomed, } from './style.js';
+export type { MapPalette, OpenMapTilesStyleOptions, ShortbreadStyleOptions, } from './styles.js';
+export type { FeatureValue, GeometryData, VectorTile, VectorTileLayer, FeatureCursor, } from './mvt.js';
+export type { CachedTile, TileStatus } from './tiles.js';
+declare module 'react-x11/jsx-runtime' {
+    namespace JSX {
+        interface IntrinsicElements {
+            mapview: MapViewProps;
+        }
+    }
+}
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/maps/index.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAS1C,OAAO,EAAE,OAAO,EAAE,WAAW,EAAsB,MAAM,WAAW,CAAC;AACrE,OAAO,KAAK,EAIV,QAAQ,EACR,YAAY,EACb,MAAM,YAAY,CAAC;AAoCpB;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,GAAG,CAAC,KAAK,EAAE,QAAQ,GAAG,YAAY,CAmFjD;AAED;;0DAE0D;AAC1D,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,WAAW,EAAE,CAAC;AAEnD,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,YAAY,EACZ,YAAY,EACZ,QAAQ,EACR,eAAe,EACf,WAAW,EACX,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAChB,aAAa,EACb,gBAAgB,EAChB,gBAAgB,EAChB,cAAc,EACd,UAAU,EACV,OAAO,EACP,aAAa,EACb,YAAY,EACZ,SAAS,EACT,aAAa,EACb,SAAS,EACT,UAAU,EACV,YAAY,EACZ,WAAW,EACX,SAAS,EACT,OAAO,EACP,MAAM,EACN,aAAa,EACb,YAAY,EACZ,SAAS,EACT,cAAc,EACd,aAAa,EACb,SAAS,EACT,aAAa,EACb,OAAO,EACP,SAAS,GACV,MAAM,WAAW,CAAC;AAEnB,OAAO,EACL,eAAe,EACf,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,eAAe,EACf,SAAS,EACT,OAAO,GACR,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,OAAO,EACL,YAAY,EACZ,aAAa,EACb,iBAAiB,EACjB,eAAe,GAChB,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE1D,OAAO,EACL,cAAc,EACd,eAAe,EACf,QAAQ,EACR,UAAU,GACX,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAEzE,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAEvC,YAAY,EACV,gBAAgB,EAChB,aAAa,EACb,SAAS,EACT,eAAe,EACf,QAAQ,EACR,YAAY,GACb,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,MAAM,EACN,YAAY,EACZ,SAAS,EACT,aAAa,EACb,cAAc,EACd,MAAM,EACN,WAAW,EACX,UAAU,EACV,SAAS,GACV,MAAM,WAAW,CAAC;AACnB,YAAY,EACV,aAAa,EACb,uBAAuB,EACvB,SAAS,EACT,QAAQ,EACR,WAAW,GACZ,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AACvE,YAAY,EACV,WAAW,EACX,SAAS,EACT,SAAS,EACT,SAAS,EACT,QAAQ,EACR,aAAa,EACb,WAAW,EACX,MAAM,GACP,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,UAAU,EACV,wBAAwB,EACxB,sBAAsB,GACvB,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,eAAe,EACf,aAAa,GACd,MAAM,UAAU,CAAC;AAClB,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAKzD,OAAO,QAAQ,uBAAuB,CAAC;IACrC,UAAU,GAAG,CAAC;QACZ,UAAU,iBAAiB;YACzB,OAAO,EAAE,YAAY,CAAC;SACvB;KACF;CACF"}

package/dist/maps/index.js

@@ -0,0 +1,141 @@
+// `<Map>` — a 2D map: vector tiles the application supplies, drawn, panned,
+// zoomed, with markers and overlays on top.
+//
+// The surface is deliberately close to Leaflet's and MapLibre's, because a
+// map's API is a solved problem and an application that has described a
+// camera, a marker and a tile source for one of those should not have to
+// describe them again. What differs is the one thing that could not be
+// carried over: nothing here fetches. A source is a function the
+// application supplies, for the reason `src/html/`'s `onResource` is — see
+// `./sources.ts`.
+//
+// **Registration happens when this module is evaluated**, which is the
+// design and not a shortcut: nothing in the package registers anything
+// until an application imports the component that needs it, so
+// `sideEffects: false` stays honest. Do not move it into `../index.ts`
+// (AGENTS.md, "Tree-shaking is a constraint").
+import React, { useImperativeHandle, useRef } from 'react';
+import { registerElement, registeredElements } from 'react-x11/host';
+import { createStyles, flattenStyle } from 'react-x11/style';
+import { ELEMENT, MapViewNode, SELF_DAMAGED_PROPS } from './node.js';
+if (!registeredElements().includes(ELEMENT)) {
+    registerElement(ELEMENT, {
+        create: (props, app) => new MapViewNode(props, app),
+        // No `semanticNames`: not one of this element's prop names is also a
+        // style name — `center`, `zoom`, `sources` and `markers` are all clear,
+        // and the map style is `mapStyle` precisely so that `style` stays
+        // react-x11's. `test/maps.test.ts` is what keeps that true, because the
+        // failure it guards against (throws in development, works in
+        // production) is the worst shape a bug can have.
+        childrenAllowed: false,
+        // The commit claim: changes to these damage nothing by name — the
+        // element's own `applyProps` diffs them into the boxes that actually
+        // changed (react-x11#301). Without this, every pan step's new `camera`
+        // and every moved marker would repaint the whole pane.
+        selfDamagedProps: [...SELF_DAMAGED_PROPS],
+    });
+}
+/**
+ * `pane` is the default for the box `<Map>` renders: it fills its parent —
+ * unless the application's own style gives it a height or a `flexGrow`, in
+ * which case adding one would silently override what it asked for.
+ * Checked against the *flattened* style, so an array works too.
+ */
+const styles = createStyles({
+    pane: { flexGrow: 1, overflow: 'hidden' },
+    clip: { overflow: 'hidden' },
+    fill: { flexGrow: 1 },
+});
+const DEFAULT_CAMERA = { center: { lon: 0, lat: 20 }, zoom: 2 };
+/**
+ * A map.
+ *
+ * ```tsx
+ * const source = osmVectorSource({
+ *   fetch: async (url, signal) => {
+ *     const response = await fetch(url, { signal });
+ *     if (response.status === 404) return null;
+ *     return new Uint8Array(await response.arrayBuffer());
+ *   },
+ * });
+ *
+ * <Map
+ *   sources={[source]}
+ *   defaultCamera={{ center: { lon: -0.1281, lat: 51.508 }, zoom: 13 }}
+ *   markers={[{ id: 'home', position: { lon: -0.1281, lat: 51.508 } }]}
+ *   onMarkerClick={(marker) => select(marker.id)}
+ * />
+ * ```
+ *
+ * Pass `camera` and `onCameraChange` instead of `defaultCamera` for the
+ * controlled form, where the application owns where the map is looking.
+ */
+export function Map(props) {
+    const { camera, defaultCamera, onCameraChange, style, children, ref, ...rest } = props;
+    const view = useRef(null);
+    const controlled = camera !== undefined;
+    useImperativeHandle(ref, () => ({
+        // Every method reads the node at call time rather than closing over
+        // it: the ref attaches after the commit that created the node, and a
+        // handle built once must still work for the whole mount.
+        getCamera: () => view.current?.getCamera() ?? DEFAULT_CAMERA,
+        setCamera: (next) => view.current?.setCamera(next),
+        panBy: (dx, dy) => view.current?.panBy(dx, dy),
+        zoomIn: (step) => view.current?.zoomIn(step),
+        zoomOut: (step) => view.current?.zoomOut(step),
+        zoomTo: (zoom) => view.current?.zoomTo(zoom),
+        fitBounds: (bounds, options) => view.current?.fitBounds(bounds, options),
+        fitMarkers: (ids, options) => view.current?.fitMarkers(ids, options),
+        getBounds: () => view.current?.getBounds() ?? {
+            west: -180,
+            south: -85,
+            east: 180,
+            north: 85,
+        },
+        project: (position) => view.current?.project(position) ?? { x: 0, y: 0 },
+        unproject: (x, y) => view.current?.unproject(x, y) ?? { lon: 0, lat: 0 },
+        markerAt: (x, y) => view.current?.markerAt(x, y) ?? null,
+        refresh: () => view.current?.refresh(),
+        stats: () => view.current?.stats() ?? null,
+    }), []);
+    const flat = flattenStyle(style ?? null);
+    const sized = flat.height !== undefined ||
+        flat.flexGrow !== undefined ||
+        flat.flexBasis !== undefined;
+    // The pane and anything the application puts over it are siblings rather
+    // than parent and children: a registered element's own drawing happens
+    // *after* `super.paint` has painted its children, so anything mounted
+    // inside would be painted over by the map. Beside it, and after it, a
+    // legend or a control panel lands on top. `<Flow>` makes the same
+    // arrangement for the same reason.
+    return React.createElement('box', { style: sized ? [styles.clip, style] : [styles.pane, style] }, React.createElement(ELEMENT, {
+        ...rest,
+        key: 'pane',
+        ref: view,
+        // The controlled/uncontrolled fork, and the whole of it. Controlled:
+        // the application's camera goes down and the element only ever
+        // *asks* to move. Uncontrolled: nothing goes down after the seed, the
+        // element owns the camera, and a pan never reaches React — which is
+        // the difference between a drag that blits a strip and one that
+        // re-renders and re-claims the pane on every pointer step.
+        camera: controlled ? camera : undefined,
+        defaultCamera: controlled ? undefined : (defaultCamera ?? DEFAULT_CAMERA),
+        onCameraChange,
+        style: styles.fill,
+        role: rest.role ?? 'group',
+        'aria-label': rest['aria-label'] ?? 'Map',
+    }), children);
+}
+/** The host element name, for an application that would rather write
+ *  `<mapview>`. The raw element is the whole component minus the
+ *  controlled/uncontrolled fork and the box around it. */
+export { ELEMENT as MAPVIEW_ELEMENT, MapViewNode };
+export { DEFAULT_TILE_SIZE, EARTH_CIRCUMFERENCE, EARTH_RADIUS, MAX_LATITUDE, boundsOf, cameraForBounds, dataTileFor, distanceMetres, latFromMercatorY, lonFromMercatorX, mercatorScale, mercatorXFromLon, mercatorYFromLat, metresPerPixel, parentTile, project, projectLngLat, projectPoint, rasterFor, sourceZoomFor, subTileOf, tileBounds, tileContains, tileCountAt, tileCover, tileKey, tileOf, tileTransform, transformFor, unproject, unprojectPoint, visibleBounds, worldSize, zoomOffsetFor, wrapLon, wrapTileX, } from './proj.js';
+export { OSM_ATTRIBUTION, OSM_RASTER_URL, OSM_VECTOR_URL, googleTileSource, osmRasterSource, osmVectorSource, parseVectorTile, pyramidOf, tileUrl, } from './sources.js';
+export { setGunzip } from './gzip.js';
+export { DARK_PALETTE, LIGHT_PALETTE, openMapTilesStyle, shortbreadStyle, } from './styles.js';
+export { compileFilter, resolveZoomed } from './style.js';
+export { decodePolyline, geoJsonOverlays, markerAt, markerRect, } from './overlay.js';
+export { GeomType, GeometryBuffer, MvtError, parseTile } from './mvt.js';
+export { TileCache } from './tiles.js';
+//# sourceMappingURL=index.js.map

package/dist/maps/index.js.map

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

package/dist/maps/labels.d.ts

@@ -0,0 +1,123 @@
+import type { MapCanvas } from './paint.js';
+import { GeometryBuffer } from './mvt.js';
+import type { VectorTile } from './mvt.js';
+import type { PreparedStyle, PreparedLayer } from './paint.js';
+import type { TileId, Transform } from './proj.js';
+/** ntk's font cache, structurally — the same slice `src/flow/draw.ts`
+ *  names, for the same reason. */
+export interface FontsLike {
+    layout(content: string, style: Record<string, unknown>, options?: Record<string, unknown>): {
+        width: number;
+        height: number;
+        draw(ctx: unknown, x: number, y: number): void;
+    };
+}
+/** One shaped string, kept between frames. Shaping is the expensive half of
+ *  drawing text and a label does not change between frames. */
+export interface ShapedLabel {
+    width: number;
+    height: number;
+    layout: {
+        draw(ctx: unknown, x: number, y: number): void;
+    };
+}
+/**
+ * A label that could be drawn.
+ *
+ * `mx`/`my` are normalized mercator, so a candidate outlives every camera
+ * move — it is a property of the data, and collected once per tile per
+ * zoom.
+ */
+export interface LabelCandidate {
+    /** Stable for the life of the tile, which is what lets a placement be
+     *  compared frame to frame. */
+    id: string;
+    /** `layer|text` — what the repeat-distance rule counts as "the same
+     *  label". Keyed on the layer as well as the text so that a street and a
+     *  place of the same name do not suppress each other. */
+    key: string;
+    text: string;
+    mx: number;
+    my: number;
+    /** Layer-wide priority; higher wins a collision. */
+    rank: number;
+    /** Logical pixels. */
+    size: number;
+    color: string;
+    halo: string | undefined;
+    haloWidth: number;
+    /** Pixels within which this text may not repeat. */
+    repeat: number;
+}
+/** A candidate that won its place, with the box it occupies in world
+ *  pixels at the zoom it was placed for. */
+export interface PlacedLabel extends LabelCandidate {
+    /** World pixels: `mercator × worldSize`. */
+    wx: number;
+    wy: number;
+    width: number;
+    height: number;
+    shaped: ShapedLabel;
+}
+/**
+ * The label candidates one tile contributes.
+ *
+ * Point geometry anchors at the point. Line and polygon geometry anchor at
+ * the **midpoint of the longest part** — which is not a true label
+ * placement (a street name should follow its street, and a country name
+ * should sit at the pole of inaccessibility of its border) but is the
+ * anchor those two would start from, and is right often enough to be worth
+ * having while line placement is unwritten. See `docs/prd-maps.md`.
+ */
+export declare function collectLabels(tile: VectorTile, id: TileId, prepared: PreparedStyle, zoom: number, buffer: GeometryBuffer): LabelCandidate[];
+/** Cache of shaped strings, owned by the element. */
+export declare class LabelShaper {
+    private readonly _cache;
+    private _fonts;
+    private _family;
+    /** Device pixels per logical pixel. Text is shaped at the device size the
+     *  panel wants, exactly as core shapes a `<text>` — a label on a retina
+     *  screen is sharper, not bigger. */
+    private _scale;
+    constructor(fonts: FontsLike | null, family: string, scale: number);
+    /** Re-point at a new font manager, face or scale, dropping what was
+     *  shaped for the old one. */
+    reconfigure(fonts: FontsLike | null, family: string, scale: number): void;
+    /** Shape one label, or null on a backend with no font manager. Widths
+     *  come back in **logical** pixels, which is what placement is in. */
+    shape(text: string, size: number, color: string): ShapedLabel | null;
+}
+/**
+ * Place candidates against each other, in world pixels.
+ *
+ * Greedy by rank, which is what every map does: sort, and take a label if
+ * nothing already taken overlaps it. The order has to be **total and
+ * stable** — rank, then the candidate's id — because a tie broken by array
+ * order would flicker as tiles arrived in a different order.
+ */
+export declare function placeLabels(candidates: readonly LabelCandidate[], worldSize: number, shaper: LabelShaper, options?: {
+    padding?: number;
+}): PlacedLabel[];
+/**
+ * Draw the placed labels that land in the pane.
+ *
+ * The halo is the same string shaped a second time in the halo colour and
+ * drawn four times around the glyphs, rather than a real outline: ntk has
+ * no glyph-outline stroke, and both runs are cached, so a label costs five
+ * composites of two shaped runs. That is cheap for the few dozen labels a
+ * pane holds and it is the difference between a place name that is
+ * readable over a motorway and one that is not.
+ */
+export declare function drawLabels(ctx: MapCanvas, placed: readonly PlacedLabel[], transform: Transform, pane: {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}, scale: number, clip: {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+} | null, shaper: LabelShaper): number;
+export type { PreparedLayer };
+//# sourceMappingURL=labels.d.ts.map