isard 0.8.0 → 1.1.0

package/dist/react/index.d.ts

@@ -0,0 +1,119 @@
+/**
+ * Isard in React: the map, its layers, markers, popups, panels and effects as components, created when they mount,
+ * updated by the least their props need and removed when they unmount.
+ *
+ * ```tsx
+ * <IsardMap preset="ign-3d" center={[2.35, 48.85]} zoom={15} style={{ height: 400 }}>
+ *   <Layer type="lines" data={routes} color="#0057b8" width={3} />
+ *   <Marker lonLat={[2.35, 48.85]}><Popup>Here</Popup></Marker>
+ * </IsardMap>
+ * ```
+ */
+import { type CSSProperties, type ReactNode } from 'react';
+import type { Layer as LayerHandle } from '../layers/layers.ts';
+import { GeoMap, type LayerSpec } from '../map.ts';
+import type { GeoMapOptions, LonLat, MapEvents, Point, SwipeOptions, ViewshedOptions } from '../types.ts';
+import { type Anchor, Marker as MarkerHandle, Panel as PanelHandle, type PanelOptions, Popup as PopupHandle, type PopupOptions } from '../ui/overlay.ts';
+import type { Camera } from '../wasm/isard.js';
+/** The map of the `<IsardMap>` around, once created (undefined before) */
+export declare function useMap(): GeoMap | undefined;
+/** Listens to an event of the map around while the component is mounted; the listener may change at each render */
+export declare function useMapEvent<K extends keyof MapEvents>(type: K, listener: (event: MapEvents[K]) => void): void;
+/** The props of the map's events: `onClick` for 'click', `onMoveEnd` for 'moveend'… */
+export interface MapEventProps {
+    onMoveStart?: (camera: Camera) => void;
+    onMove?: (camera: Camera) => void;
+    onMoveEnd?: (camera: Camera) => void;
+    onResize?: (event: MapEvents['resize']) => void;
+    onHover?: (event: MapEvents['hover']) => void;
+    onHoverFeature?: (event: MapEvents['hoverfeature']) => void;
+    onClick?: (event: MapEvents['click']) => void;
+    onRender?: (event: MapEvents['render']) => void;
+    onIdle?: () => void;
+    onLeave?: () => void;
+}
+export interface IsardMapProps extends Omit<GeoMapOptions, keyof Camera>, MapEventProps {
+    /** The camera at creation, then left to the user's gestures */
+    center?: LonLat;
+    zoom?: number;
+    pitch?: number;
+    bearing?: number;
+    /** A camera the map follows: set again whenever it changes (with `onMove` to keep it in a state) */
+    camera?: Partial<Camera>;
+    /** The map, once created */
+    onLoad?: (map: GeoMap) => void;
+    /** The map's creation failed (no WebGL2, the engine not found) */
+    onError?: (error: unknown) => void;
+    id?: string;
+    className?: string;
+    style?: CSSProperties;
+    /** Layers, markers, popups, panels, effects; drawn once the map is created */
+    children?: ReactNode;
+}
+/**
+ * A map filling its element (give it a height). Created once mounted, destroyed when unmounted; the options read at
+ * creation only (`body`, `preset`, `interactive`, the URLs) need a new `key` to take another value
+ */
+export declare const IsardMap: import("react").ForwardRefExoticComponent<IsardMapProps & import("react").RefAttributes<GeoMap | undefined>>;
+export type LayerProps<P = Record<string, unknown>> = LayerSpec<P> & {
+    /** Its place among the layers of the components: from the bottom up, the same order by mounting (default 0) */
+    order?: number;
+    /** The layer, once created and each time it is made anew */
+    onLayer?: (layer: LayerHandle) => void;
+};
+/**
+ * A layer: the options of its `add…` method with its `type` (`map.add`). A change of data, style or instances updates
+ * it; a change of what is set at creation (its URL, grid, nodes…) makes it anew, in its place. Data, functions and
+ * arrays are compared by identity: keep them in a memo or a state. The ref gives the layer's handle
+ */
+export declare const Layer: import("react").ForwardRefExoticComponent<LayerProps<Record<string, unknown>> & import("react").RefAttributes<LayerHandle | undefined>>;
+export interface MarkerProps {
+    lonLat: LonLat;
+    /** Metres above the ground, its stem down to `base` (what it stands on: a roof, a mesh) */
+    height?: number;
+    base?: number;
+    draggable?: boolean;
+    offset?: Point;
+    /** Which part of the element sits on the position (default 'bottom' for the pin, 'center' with an icon) */
+    anchor?: Anchor;
+    className?: string;
+    /** The marker's look, in place of the default pin; the element changes with it */
+    icon?: ReactNode;
+    onDragStart?: (lonLat: LonLat) => void;
+    onDrag?: (lonLat: LonLat) => void;
+    onDragEnd?: (lonLat: LonLat) => void;
+    /** A `<Popup>` opened by a click on the marker */
+    children?: ReactNode;
+}
+/** A marker at a position, its look the default pin or the `icon` given */
+export declare function Marker(props: MarkerProps): ReactNode;
+export interface PopupProps extends PopupOptions {
+    /** Its position; in a `<Marker>`, the marker's */
+    lonLat?: LonLat;
+    /** Metres above the ground (in a `<Marker>`, the marker's) */
+    height?: number;
+    /** Open or closed, when the application decides; else open when mounted alone, on the marker's click in a marker */
+    open?: boolean;
+    onOpen?: () => void;
+    /** Closed by its button, a click on the map, or the marker's click */
+    onClose?: () => void;
+    children?: ReactNode;
+}
+/** A popup of JSX content, at a position or on a `<Marker>` */
+export declare function Popup(props: PopupProps): ReactNode;
+export interface PanelProps extends Omit<PanelOptions, 'element'> {
+    lonLat: LonLat;
+    /** What stands in 3D: a video, an iframe, a sign */
+    children?: ReactNode;
+}
+/** JSX standing in 3D at a position, `width` metres wide, facing `heading` */
+export declare function Panel(props: PanelProps): ReactNode;
+/** An observer's viewshed; several `<Viewshed>` are drawn together */
+export declare function Viewshed(props: ViewshedOptions): ReactNode;
+export interface SwipeProps extends Omit<SwipeOptions, 'layers'> {
+    /** The `<Layer>` shown on one side of the line only */
+    children?: ReactNode;
+}
+/** The `<Layer>` in it shown on one side of a vertical line only, at `position` CSS pixels from the left */
+export declare function Swipe(props: SwipeProps): ReactNode;
+export type { Camera, GeoMap, LayerHandle, LayerSpec, LonLat, MarkerHandle, PanelHandle, PopupHandle };

package/dist/react/index.js

@@ -0,0 +1,409 @@
+/**
+ * Isard in React: the map, its layers, markers, popups, panels and effects as components, created when they mount,
+ * updated by the least their props need and removed when they unmount.
+ *
+ * ```tsx
+ * <IsardMap preset="ign-3d" center={[2.35, 48.85]} zoom={15} style={{ height: 400 }}>
+ *   <Layer type="lines" data={routes} color="#0057b8" width={3} />
+ *   <Marker lonLat={[2.35, 48.85]}><Popup>Here</Popup></Marker>
+ * </IsardMap>
+ * ```
+ */
+import { createContext, createElement, forwardRef, useContext, useEffect, useImperativeHandle, useLayoutEffect, useMemo, useRef, useState, } from 'react';
+import { createPortal } from 'react-dom';
+import { applyLayerChange, LayerOrder, layerChange } from "../bind/layers.js";
+import { GeoMap } from "../map.js";
+import { Marker as MarkerHandle, Panel as PanelHandle, Popup as PopupHandle, } from "../ui/overlay.js";
+const MapContext = createContext(undefined);
+/** The map of the `<IsardMap>` around, once created (undefined before) */
+export function useMap() {
+    return useContext(MapContext)?.map;
+}
+/** Listens to an event of the map around while the component is mounted; the listener may change at each render */
+export function useMapEvent(type, listener) {
+    const map = useMap();
+    const latest = useRef(listener);
+    latest.current = listener;
+    useEffect(() => map?.on(type, (event) => latest.current(event)), [map, type]);
+}
+const EVENT_PROPS = {
+    onMoveStart: 'movestart',
+    onMove: 'move',
+    onMoveEnd: 'moveend',
+    onResize: 'resize',
+    onHover: 'hover',
+    onHoverFeature: 'hoverfeature',
+    onClick: 'click',
+    onRender: 'render',
+    onIdle: 'idle',
+    onLeave: 'leave',
+};
+/** Options the map takes again after its creation, and how */
+const LIVE_OPTIONS = {
+    basemap: (map, p) => {
+        if (p.basemap)
+            map.setBasemap(p.basemap, p.hillshade);
+    },
+    hillshade: (map, p) => {
+        if (p.basemap)
+            map.setBasemap(p.basemap, p.hillshade);
+    },
+    terrain: (map, p) => map.setTerrain(p.terrain ?? false),
+    minZoom: (map, p) => map.setMinZoom(p.minZoom ?? 0),
+    maxZoom: (map, p) => map.setMaxZoom(p.maxZoom ?? 22),
+    maxPitch: (map, p) => map.setMaxPitch(p.maxPitch ?? 70),
+    atmosphere: (map, p) => map.setAtmosphere(p.atmosphere),
+    projection: (map, p) => map.setProjection(p.projection ?? 'globe'),
+    loading: (map, p) => map.setLoading(p.loading ?? 'immediate'),
+    sky: (map, p) => map.setSky(p.sky ?? true),
+    background: (map, p) => {
+        if (p.background)
+            map.setBackground(p.background);
+    },
+};
+function sameCamera(a, b) {
+    return ((b.center === undefined || (a.center[0] === b.center[0] && a.center[1] === b.center[1])) &&
+        (b.zoom === undefined || a.zoom === b.zoom) &&
+        (b.pitch === undefined || a.pitch === b.pitch) &&
+        (b.bearing === undefined || a.bearing === b.bearing));
+}
+/**
+ * A map filling its element (give it a height). Created once mounted, destroyed when unmounted; the options read at
+ * creation only (`body`, `preset`, `interactive`, the URLs) need a new `key` to take another value
+ */
+export const IsardMap = forwardRef(function IsardMap(props, ref) {
+    const element = useRef(null);
+    const [binding, setBinding] = useState();
+    const latest = useRef(props);
+    latest.current = props;
+    useImperativeHandle(ref, () => binding?.map, [binding]);
+    useEffect(() => {
+        const container = element.current;
+        if (!container)
+            return;
+        let cancelled = false;
+        let created;
+        const { camera, center, zoom, pitch, bearing, children: _, ...options } = latest.current;
+        GeoMap.create(container, {
+            ...stripProps(options),
+            ...defined({ center, zoom, pitch, bearing }),
+            ...camera,
+        }).then((map) => {
+            // Unmounted while the engine was loading (or StrictMode's second mount): that map is not wanted
+            if (cancelled) {
+                map.destroy();
+                return;
+            }
+            created = map;
+            const viewsheds = new Map();
+            setBinding({
+                map,
+                order: new LayerOrder(),
+                viewsheds,
+                applyViewsheds: () => map.setViewshed(viewsheds.size > 0 ? [...viewsheds.values()] : undefined),
+            });
+            latest.current.onLoad?.(map);
+        }, (error) => {
+            if (cancelled)
+                return;
+            if (latest.current.onError)
+                latest.current.onError(error);
+            else
+                console.error(error);
+        });
+        return () => {
+            cancelled = true;
+            created?.destroy();
+            setBinding(undefined);
+        };
+    }, []);
+    // The events, each listened to once: the props may give another function at each render
+    const map = binding?.map;
+    useEffect(() => {
+        if (!map)
+            return;
+        const offs = Object.entries(EVENT_PROPS).map(([prop, type]) => map.on(type, (event) => latest.current[prop]?.(event)));
+        return () => {
+            for (const off of offs)
+                off();
+        };
+    }, [map]);
+    // The options taken again, compared with what the map was given last
+    const applied = useRef(props);
+    useEffect(() => {
+        if (!map)
+            return;
+        const last = applied.current;
+        applied.current = props;
+        const done = new Set();
+        for (const [key, apply] of Object.entries(LIVE_OPTIONS)) {
+            if (!apply || done.has(apply) || Object.is(last[key], props[key])) {
+                continue;
+            }
+            done.add(apply);
+            apply(map, props);
+        }
+    });
+    const { camera } = props;
+    useEffect(() => {
+        if (map && camera && !sameCamera(map.getCamera(), camera))
+            map.setCamera(camera);
+    }, [map, camera]);
+    return createElement('div', { ref: element, id: props.id, className: props.className, style: props.style }, binding ? createElement(MapContext.Provider, { value: binding }, props.children) : null);
+});
+/** The props that are not options of the map */
+function stripProps(props) {
+    const options = { ...props };
+    for (const key of [...Object.keys(EVENT_PROPS), 'onLoad', 'onError', 'id', 'className', 'style'])
+        delete options[key];
+    return options;
+}
+/** The entries of an object whose value is defined (`exactOptionalPropertyTypes`) */
+function defined(object) {
+    return Object.fromEntries(Object.entries(object).filter(([, value]) => value !== undefined));
+}
+// ── Layers ──
+const SwipeContext = createContext(undefined);
+/**
+ * A layer: the options of its `add…` method with its `type` (`map.add`). A change of data, style or instances updates
+ * it; a change of what is set at creation (its URL, grid, nodes…) makes it anew, in its place. Data, functions and
+ * arrays are compared by identity: keep them in a memo or a state. The ref gives the layer's handle
+ */
+export const Layer = forwardRef(function Layer(props, ref) {
+    const binding = useContext(MapContext);
+    const swipe = useContext(SwipeContext);
+    const { order = 0, onLayer, ...spec } = props;
+    const state = useRef(undefined);
+    const [layer, setLayer] = useState();
+    useImperativeHandle(ref, () => layer, [layer]);
+    const latest = useRef({ spec, order, onLayer });
+    latest.current = { spec, order, onLayer };
+    useEffect(() => {
+        if (!binding)
+            return;
+        const { spec, order, onLayer } = latest.current;
+        const created = binding.map.add(spec);
+        binding.order.place(created, order);
+        state.current = { layer: created, spec, order };
+        swipe?.set(created);
+        setLayer(created);
+        onLayer?.(created);
+        return () => {
+            const current = state.current;
+            state.current = undefined;
+            if (!current)
+                return;
+            binding.order.remove(current.layer);
+            swipe?.unset(current.layer);
+            if (binding.map.hasLayer(current.layer))
+                current.layer.remove();
+        };
+    }, [binding, swipe]);
+    useEffect(() => {
+        const current = state.current;
+        if (!binding || !current)
+            return;
+        const next = spec;
+        const change = layerChange(current.spec, next);
+        current.spec = next;
+        if (change?.rebuild) {
+            const old = current.layer;
+            const fresh = binding.map.rebuildLayer(old, next);
+            binding.order.place(fresh, order, old);
+            swipe?.unset(old);
+            swipe?.set(fresh);
+            current.layer = fresh;
+            current.order = order;
+            setLayer(fresh);
+            latest.current.onLayer?.(fresh);
+            return;
+        }
+        if (change)
+            applyLayerChange(current.layer, next, change);
+        if (current.order !== order) {
+            current.order = order;
+            binding.order.place(current.layer, order, current.layer);
+        }
+    });
+    return null;
+});
+// ── Markers, popups, panels ──
+/** The marker of a `<Marker>` around (a `<Popup>` in it opens on its click) */
+const MarkerContext = createContext(undefined);
+/** A marker at a position, its look the default pin or the `icon` given */
+export function Marker(props) {
+    const map = useMap();
+    const custom = props.icon !== undefined;
+    const { anchor, className } = props;
+    const element = useMemo(() => (custom ? document.createElement('div') : undefined), [custom]);
+    const marker = useMemo(() => new MarkerHandle({ ...defined({ anchor, className, element }) }), [anchor, className, element]);
+    const latest = useRef(props);
+    latest.current = props;
+    useEffect(() => {
+        if (!map)
+            return;
+        marker.addTo(map);
+        const offs = [
+            marker.on('dragstart', (e) => latest.current.onDragStart?.(e.lonLat)),
+            marker.on('drag', (e) => latest.current.onDrag?.(e.lonLat)),
+            marker.on('dragend', (e) => latest.current.onDragEnd?.(e.lonLat)),
+        ];
+        return () => {
+            for (const off of offs)
+                off();
+            marker.remove();
+        };
+    }, [map, marker]);
+    const { lonLat, height = 0, base = 0, draggable = false, offset } = props;
+    useLayoutEffect(() => {
+        marker.setLonLat(lonLat);
+    }, [marker, lonLat[0], lonLat[1]]);
+    useLayoutEffect(() => {
+        marker.setHeight(height, base);
+    }, [marker, height, base]);
+    useLayoutEffect(() => {
+        marker.setDraggable(draggable);
+    }, [marker, draggable]);
+    useLayoutEffect(() => {
+        if (offset)
+            marker.setOffset(offset);
+    }, [marker, offset?.[0], offset?.[1]]);
+    return createElement(MarkerContext.Provider, { value: marker }, element ? createPortal(props.icon, element) : null, props.children);
+}
+/** A popup of JSX content, at a position or on a `<Marker>` */
+export function Popup(props) {
+    const map = useMap();
+    const marker = useContext(MarkerContext);
+    const { anchor, closeButton, closeOnClick, maxWidth, className } = props;
+    const content = useMemo(() => document.createElement('div'), []);
+    const popup = useMemo(() => new PopupHandle(defined({ anchor, closeButton, closeOnClick, maxWidth, className })).setDOMContent(content), [anchor, closeButton, closeOnClick, maxWidth, className, content]);
+    const latest = useRef(props);
+    latest.current = props;
+    useEffect(() => {
+        if (!map)
+            return;
+        const offs = [
+            popup.on('open', () => latest.current.onOpen?.()),
+            popup.on('close', () => latest.current.onClose?.()),
+        ];
+        if (marker)
+            marker.setPopup(popup);
+        return () => {
+            for (const off of offs)
+                off();
+            if (marker?.getPopup() === popup)
+                marker.setPopup(undefined);
+            popup.remove();
+        };
+    }, [map, marker, popup]);
+    const { lonLat, height, open, offset } = props;
+    const opened = open ?? !marker;
+    useLayoutEffect(() => {
+        if (offset)
+            popup.setOffset(offset);
+    }, [popup, offset?.[0], offset?.[1]]);
+    useLayoutEffect(() => {
+        if (!map)
+            return;
+        if (lonLat)
+            popup.setLonLat(lonLat);
+        else if (marker)
+            popup.setLonLat(marker.getLonLat());
+        if (height !== undefined)
+            popup.setHeight(height);
+        if (open === undefined && marker)
+            return;
+        if (opened && !popup.isOpen())
+            popup.addTo(map);
+        if (!opened && popup.isOpen())
+            popup.remove();
+    }, [map, marker, popup, lonLat?.[0], lonLat?.[1], height, open, opened]);
+    return createPortal(props.children, content);
+}
+/** JSX standing in 3D at a position, `width` metres wide, facing `heading` */
+export function Panel(props) {
+    const map = useMap();
+    const { className } = props;
+    const element = useMemo(() => document.createElement('div'), []);
+    // The width at creation: the placement is set again by the effect below
+    const initialWidth = useRef(props.width);
+    const panel = useMemo(() => new PanelHandle({ element, width: initialWidth.current, ...defined({ className }) }), [element, className]);
+    useEffect(() => {
+        if (!map)
+            return;
+        panel.addTo(map);
+        return () => {
+            panel.remove();
+        };
+    }, [map, panel]);
+    const { lonLat, width, heading, pitch, height } = props;
+    useLayoutEffect(() => {
+        panel.setLonLat(lonLat);
+    }, [panel, lonLat[0], lonLat[1]]);
+    useLayoutEffect(() => {
+        panel.setPlacement(defined({ width, heading, pitch, height }));
+    }, [panel, width, heading, pitch, height]);
+    // Its content may change its CSS size
+    useLayoutEffect(() => {
+        panel.resize();
+    });
+    return createPortal(props.children, element);
+}
+// ── Effects ──
+/** An observer's viewshed; several `<Viewshed>` are drawn together */
+export function Viewshed(props) {
+    const binding = useContext(MapContext);
+    const key = useMemo(() => ({}), []);
+    useEffect(() => {
+        if (!binding)
+            return;
+        return () => {
+            binding.viewsheds.delete(key);
+            binding.applyViewsheds();
+        };
+    }, [binding, key]);
+    // Numbers, strings and the position: compared by value
+    const options = JSON.stringify(props);
+    useEffect(() => {
+        if (!binding)
+            return;
+        binding.viewsheds.set(key, JSON.parse(options));
+        binding.applyViewsheds();
+    }, [binding, key, options]);
+    return null;
+}
+/** The `<Layer>` in it shown on one side of a vertical line only, at `position` CSS pixels from the left */
+export function Swipe(props) {
+    const map = useMap();
+    const layers = useMemo(() => new Set(), []);
+    const latest = useRef(props);
+    latest.current = props;
+    const group = useMemo(() => {
+        if (!map)
+            return undefined;
+        const apply = () => {
+            const { position, side } = latest.current;
+            map.setSwipe(layers.size > 0 ? { position, layers: [...layers], ...defined({ side }) } : undefined);
+        };
+        return {
+            set: (layer) => {
+                layers.add(layer);
+                apply();
+            },
+            unset: (layer) => {
+                layers.delete(layer);
+                apply();
+            },
+        };
+    }, [map, layers]);
+    const { position, side } = props;
+    useEffect(() => {
+        if (map && layers.size > 0)
+            map.setSwipe({ position, layers: [...layers], ...defined({ side }) });
+    }, [map, layers, position, side]);
+    useEffect(() => () => {
+        map?.setSwipe(undefined);
+    }, [map]);
+    return createElement(SwipeContext.Provider, { value: group }, props.children);
+}
+//# sourceMappingURL=index.js.map

package/dist/react/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Isard in React: the map, its layers, markers, popups, panels and effects as components, created when they mount,\n * updated by the least their props need and removed when they unmount.\n *\n * ```tsx\n * <IsardMap preset=\"ign-3d\" center={[2.35, 48.85]} zoom={15} style={{ height: 400 }}>\n *   <Layer type=\"lines\" data={routes} color=\"#0057b8\" width={3} />\n *   <Marker lonLat={[2.35, 48.85]}><Popup>Here</Popup></Marker>\n * </IsardMap>\n * ```\n */\n\nimport {\n  type CSSProperties,\n  createContext,\n  createElement,\n  forwardRef,\n  type ReactNode,\n  useContext,\n  useEffect,\n  useImperativeHandle,\n  useLayoutEffect,\n  useMemo,\n  useRef,\n  useState,\n} from 'react';\nimport { createPortal } from 'react-dom';\nimport { applyLayerChange, LayerOrder, layerChange } from '../bind/layers.ts';\nimport type { Layer as LayerHandle } from '../layers/layers.ts';\nimport { GeoMap, type LayerSpec } from '../map.ts';\nimport type { GeoMapOptions, LonLat, MapEvents, Point, SwipeOptions, ViewshedOptions } from '../types.ts';\nimport {\n  type Anchor,\n  Marker as MarkerHandle,\n  Panel as PanelHandle,\n  type PanelOptions,\n  Popup as PopupHandle,\n  type PopupOptions,\n} from '../ui/overlay.ts';\nimport type { Camera } from '../wasm/isard.js';\n\n// ── The map ──\n\ninterface Binding {\n  map: GeoMap;\n  order: LayerOrder;\n  /** The observers of the `<Viewshed>` components, set on the map together */\n  viewsheds: Map<object, ViewshedOptions>;\n  applyViewsheds(): void;\n}\n\nconst MapContext = createContext<Binding | undefined>(undefined);\n\n/** The map of the `<IsardMap>` around, once created (undefined before) */\nexport function useMap(): GeoMap | undefined {\n  return useContext(MapContext)?.map;\n}\n\n/** Listens to an event of the map around while the component is mounted; the listener may change at each render */\nexport function useMapEvent<K extends keyof MapEvents>(type: K, listener: (event: MapEvents[K]) => void): void {\n  const map = useMap();\n  const latest = useRef(listener);\n  latest.current = listener;\n  useEffect(() => map?.on(type, (event) => latest.current(event)), [map, type]);\n}\n\n/** The props of the map's events: `onClick` for 'click', `onMoveEnd` for 'moveend'… */\nexport interface MapEventProps {\n  onMoveStart?: (camera: Camera) => void;\n  onMove?: (camera: Camera) => void;\n  onMoveEnd?: (camera: Camera) => void;\n  onResize?: (event: MapEvents['resize']) => void;\n  onHover?: (event: MapEvents['hover']) => void;\n  onHoverFeature?: (event: MapEvents['hoverfeature']) => void;\n  onClick?: (event: MapEvents['click']) => void;\n  onRender?: (event: MapEvents['render']) => void;\n  onIdle?: () => void;\n  onLeave?: () => void;\n}\n\nconst EVENT_PROPS = {\n  onMoveStart: 'movestart',\n  onMove: 'move',\n  onMoveEnd: 'moveend',\n  onResize: 'resize',\n  onHover: 'hover',\n  onHoverFeature: 'hoverfeature',\n  onClick: 'click',\n  onRender: 'render',\n  onIdle: 'idle',\n  onLeave: 'leave',\n} as const satisfies Record<keyof MapEventProps, keyof MapEvents>;\n\nexport interface IsardMapProps extends Omit<GeoMapOptions, keyof Camera>, MapEventProps {\n  /** The camera at creation, then left to the user's gestures */\n  center?: LonLat;\n  zoom?: number;\n  pitch?: number;\n  bearing?: number;\n  /** A camera the map follows: set again whenever it changes (with `onMove` to keep it in a state) */\n  camera?: Partial<Camera>;\n  /** The map, once created */\n  onLoad?: (map: GeoMap) => void;\n  /** The map's creation failed (no WebGL2, the engine not found) */\n  onError?: (error: unknown) => void;\n  id?: string;\n  className?: string;\n  style?: CSSProperties;\n  /** Layers, markers, popups, panels, effects; drawn once the map is created */\n  children?: ReactNode;\n}\n\n/** Options the map takes again after its creation, and how */\nconst LIVE_OPTIONS: { [K in keyof GeoMapOptions]?: (map: GeoMap, props: IsardMapProps) => void } = {\n  basemap: (map, p) => {\n    if (p.basemap) map.setBasemap(p.basemap, p.hillshade);\n  },\n  hillshade: (map, p) => {\n    if (p.basemap) map.setBasemap(p.basemap, p.hillshade);\n  },\n  terrain: (map, p) => map.setTerrain(p.terrain ?? false),\n  minZoom: (map, p) => map.setMinZoom(p.minZoom ?? 0),\n  maxZoom: (map, p) => map.setMaxZoom(p.maxZoom ?? 22),\n  maxPitch: (map, p) => map.setMaxPitch(p.maxPitch ?? 70),\n  atmosphere: (map, p) => map.setAtmosphere(p.atmosphere),\n  projection: (map, p) => map.setProjection(p.projection ?? 'globe'),\n  loading: (map, p) => map.setLoading(p.loading ?? 'immediate'),\n  sky: (map, p) => map.setSky(p.sky ?? true),\n  background: (map, p) => {\n    if (p.background) map.setBackground(p.background);\n  },\n};\n\nfunction sameCamera(a: Camera, b: Partial<Camera>): boolean {\n  return (\n    (b.center === undefined || (a.center[0] === b.center[0] && a.center[1] === b.center[1])) &&\n    (b.zoom === undefined || a.zoom === b.zoom) &&\n    (b.pitch === undefined || a.pitch === b.pitch) &&\n    (b.bearing === undefined || a.bearing === b.bearing)\n  );\n}\n\n/**\n * A map filling its element (give it a height). Created once mounted, destroyed when unmounted; the options read at\n * creation only (`body`, `preset`, `interactive`, the URLs) need a new `key` to take another value\n */\nexport const IsardMap = forwardRef<GeoMap | undefined, IsardMapProps>(function IsardMap(props, ref) {\n  const element = useRef<HTMLDivElement>(null);\n  const [binding, setBinding] = useState<Binding>();\n  const latest = useRef(props);\n  latest.current = props;\n  useImperativeHandle(ref, () => binding?.map, [binding]);\n\n  useEffect(() => {\n    const container = element.current;\n    if (!container) return;\n    let cancelled = false;\n    let created: GeoMap | undefined;\n    const { camera, center, zoom, pitch, bearing, children: _, ...options } = latest.current;\n    GeoMap.create(container, {\n      ...stripProps(options),\n      ...defined({ center, zoom, pitch, bearing }),\n      ...camera,\n    }).then(\n      (map) => {\n        // Unmounted while the engine was loading (or StrictMode's second mount): that map is not wanted\n        if (cancelled) {\n          map.destroy();\n          return;\n        }\n        created = map;\n        const viewsheds = new Map<object, ViewshedOptions>();\n        setBinding({\n          map,\n          order: new LayerOrder(),\n          viewsheds,\n          applyViewsheds: () => map.setViewshed(viewsheds.size > 0 ? [...viewsheds.values()] : undefined),\n        });\n        latest.current.onLoad?.(map);\n      },\n      (error: unknown) => {\n        if (cancelled) return;\n        if (latest.current.onError) latest.current.onError(error);\n        else console.error(error);\n      },\n    );\n    return () => {\n      cancelled = true;\n      created?.destroy();\n      setBinding(undefined);\n    };\n  }, []);\n\n  // The events, each listened to once: the props may give another function at each render\n  const map = binding?.map;\n  useEffect(() => {\n    if (!map) return;\n    const offs = Object.entries(EVENT_PROPS).map(([prop, type]) =>\n      map.on(type, (event) =>\n        (latest.current[prop as keyof MapEventProps] as ((e: unknown) => void) | undefined)?.(event),\n      ),\n    );\n    return () => {\n      for (const off of offs) off();\n    };\n  }, [map]);\n\n  // The options taken again, compared with what the map was given last\n  const applied = useRef<IsardMapProps>(props);\n  useEffect(() => {\n    if (!map) return;\n    const last = applied.current;\n    applied.current = props;\n    const done = new Set<(map: GeoMap, props: IsardMapProps) => void>();\n    for (const [key, apply] of Object.entries(LIVE_OPTIONS)) {\n      if (!apply || done.has(apply) || Object.is(last[key as keyof IsardMapProps], props[key as keyof IsardMapProps])) {\n        continue;\n      }\n      done.add(apply);\n      apply(map, props);\n    }\n  });\n\n  const { camera } = props;\n  useEffect(() => {\n    if (map && camera && !sameCamera(map.getCamera(), camera)) map.setCamera(camera);\n  }, [map, camera]);\n\n  return createElement(\n    'div',\n    { ref: element, id: props.id, className: props.className, style: props.style },\n    binding ? createElement(MapContext.Provider, { value: binding }, props.children) : null,\n  );\n});\n\n/** The props that are not options of the map */\nfunction stripProps(props: Partial<IsardMapProps>): GeoMapOptions {\n  const options: Record<string, unknown> = { ...props };\n  for (const key of [...Object.keys(EVENT_PROPS), 'onLoad', 'onError', 'id', 'className', 'style']) delete options[key];\n  return options as GeoMapOptions;\n}\n\n/** The entries of an object whose value is defined (`exactOptionalPropertyTypes`) */\nfunction defined<T extends object>(object: T): { [K in keyof T]?: Exclude<T[K], undefined> } {\n  return Object.fromEntries(Object.entries(object).filter(([, value]) => value !== undefined)) as {\n    [K in keyof T]?: Exclude<T[K], undefined>;\n  };\n}\n\n// ── Layers ──\n\nconst SwipeContext = createContext<SwipeGroup | undefined>(undefined);\n\nexport type LayerProps<P = Record<string, unknown>> = LayerSpec<P> & {\n  /** Its place among the layers of the components: from the bottom up, the same order by mounting (default 0) */\n  order?: number;\n  /** The layer, once created and each time it is made anew */\n  onLayer?: (layer: LayerHandle) => void;\n};\n\n/**\n * A layer: the options of its `add…` method with its `type` (`map.add`). A change of data, style or instances updates\n * it; a change of what is set at creation (its URL, grid, nodes…) makes it anew, in its place. Data, functions and\n * arrays are compared by identity: keep them in a memo or a state. The ref gives the layer's handle\n */\nexport const Layer = forwardRef<LayerHandle | undefined, LayerProps>(function Layer(props, ref) {\n  const binding = useContext(MapContext);\n  const swipe = useContext(SwipeContext);\n  const { order = 0, onLayer, ...spec } = props;\n  const state = useRef<{ layer: LayerHandle; spec: LayerSpec; order: number }>(undefined);\n  const [layer, setLayer] = useState<LayerHandle>();\n  useImperativeHandle(ref, () => layer, [layer]);\n  const latest = useRef({ spec, order, onLayer });\n  latest.current = { spec, order, onLayer };\n\n  useEffect(() => {\n    if (!binding) return;\n    const { spec, order, onLayer } = latest.current;\n    const created = binding.map.add(spec as LayerSpec);\n    binding.order.place(created, order);\n    state.current = { layer: created, spec, order };\n    swipe?.set(created);\n    setLayer(created);\n    onLayer?.(created);\n    return () => {\n      const current = state.current;\n      state.current = undefined;\n      if (!current) return;\n      binding.order.remove(current.layer);\n      swipe?.unset(current.layer);\n      if (binding.map.hasLayer(current.layer)) current.layer.remove();\n    };\n  }, [binding, swipe]);\n\n  useEffect(() => {\n    const current = state.current;\n    if (!binding || !current) return;\n    const next = spec as LayerSpec;\n    const change = layerChange(current.spec, next);\n    current.spec = next;\n    if (change?.rebuild) {\n      const old = current.layer;\n      const fresh = binding.map.rebuildLayer(old, next);\n      binding.order.place(fresh, order, old);\n      swipe?.unset(old);\n      swipe?.set(fresh);\n      current.layer = fresh;\n      current.order = order;\n      setLayer(fresh);\n      latest.current.onLayer?.(fresh);\n      return;\n    }\n    if (change) applyLayerChange(current.layer, next, change);\n    if (current.order !== order) {\n      current.order = order;\n      binding.order.place(current.layer, order, current.layer);\n    }\n  });\n\n  return null;\n});\n\n// ── Markers, popups, panels ──\n\n/** The marker of a `<Marker>` around (a `<Popup>` in it opens on its click) */\nconst MarkerContext = createContext<MarkerHandle | undefined>(undefined);\n\nexport interface MarkerProps {\n  lonLat: LonLat;\n  /** Metres above the ground, its stem down to `base` (what it stands on: a roof, a mesh) */\n  height?: number;\n  base?: number;\n  draggable?: boolean;\n  offset?: Point;\n  /** Which part of the element sits on the position (default 'bottom' for the pin, 'center' with an icon) */\n  anchor?: Anchor;\n  className?: string;\n  /** The marker's look, in place of the default pin; the element changes with it */\n  icon?: ReactNode;\n  onDragStart?: (lonLat: LonLat) => void;\n  onDrag?: (lonLat: LonLat) => void;\n  onDragEnd?: (lonLat: LonLat) => void;\n  /** A `<Popup>` opened by a click on the marker */\n  children?: ReactNode;\n}\n\n/** A marker at a position, its look the default pin or the `icon` given */\nexport function Marker(props: MarkerProps): ReactNode {\n  const map = useMap();\n  const custom = props.icon !== undefined;\n  const { anchor, className } = props;\n  const element = useMemo(() => (custom ? document.createElement('div') : undefined), [custom]);\n  const marker = useMemo(\n    () => new MarkerHandle({ ...defined({ anchor, className, element }) }),\n    [anchor, className, element],\n  );\n  const latest = useRef(props);\n  latest.current = props;\n\n  useEffect(() => {\n    if (!map) return;\n    marker.addTo(map);\n    const offs = [\n      marker.on('dragstart', (e) => latest.current.onDragStart?.(e.lonLat)),\n      marker.on('drag', (e) => latest.current.onDrag?.(e.lonLat)),\n      marker.on('dragend', (e) => latest.current.onDragEnd?.(e.lonLat)),\n    ];\n    return () => {\n      for (const off of offs) off();\n      marker.remove();\n    };\n  }, [map, marker]);\n\n  const { lonLat, height = 0, base = 0, draggable = false, offset } = props;\n  useLayoutEffect(() => {\n    marker.setLonLat(lonLat);\n  }, [marker, lonLat[0], lonLat[1]]);\n  useLayoutEffect(() => {\n    marker.setHeight(height, base);\n  }, [marker, height, base]);\n  useLayoutEffect(() => {\n    marker.setDraggable(draggable);\n  }, [marker, draggable]);\n  useLayoutEffect(() => {\n    if (offset) marker.setOffset(offset);\n  }, [marker, offset?.[0], offset?.[1]]);\n\n  return createElement(\n    MarkerContext.Provider,\n    { value: marker },\n    element ? createPortal(props.icon, element) : null,\n    props.children,\n  );\n}\n\nexport interface PopupProps extends PopupOptions {\n  /** Its position; in a `<Marker>`, the marker's */\n  lonLat?: LonLat;\n  /** Metres above the ground (in a `<Marker>`, the marker's) */\n  height?: number;\n  /** Open or closed, when the application decides; else open when mounted alone, on the marker's click in a marker */\n  open?: boolean;\n  onOpen?: () => void;\n  /** Closed by its button, a click on the map, or the marker's click */\n  onClose?: () => void;\n  children?: ReactNode;\n}\n\n/** A popup of JSX content, at a position or on a `<Marker>` */\nexport function Popup(props: PopupProps): ReactNode {\n  const map = useMap();\n  const marker = useContext(MarkerContext);\n  const { anchor, closeButton, closeOnClick, maxWidth, className } = props;\n  const content = useMemo(() => document.createElement('div'), []);\n  const popup = useMemo(\n    () => new PopupHandle(defined({ anchor, closeButton, closeOnClick, maxWidth, className })).setDOMContent(content),\n    [anchor, closeButton, closeOnClick, maxWidth, className, content],\n  );\n  const latest = useRef(props);\n  latest.current = props;\n\n  useEffect(() => {\n    if (!map) return;\n    const offs = [\n      popup.on('open', () => latest.current.onOpen?.()),\n      popup.on('close', () => latest.current.onClose?.()),\n    ];\n    if (marker) marker.setPopup(popup);\n    return () => {\n      for (const off of offs) off();\n      if (marker?.getPopup() === popup) marker.setPopup(undefined);\n      popup.remove();\n    };\n  }, [map, marker, popup]);\n\n  const { lonLat, height, open, offset } = props;\n  const opened = open ?? !marker;\n  useLayoutEffect(() => {\n    if (offset) popup.setOffset(offset);\n  }, [popup, offset?.[0], offset?.[1]]);\n  useLayoutEffect(() => {\n    if (!map) return;\n    if (lonLat) popup.setLonLat(lonLat);\n    else if (marker) popup.setLonLat(marker.getLonLat());\n    if (height !== undefined) popup.setHeight(height);\n    if (open === undefined && marker) return;\n    if (opened && !popup.isOpen()) popup.addTo(map);\n    if (!opened && popup.isOpen()) popup.remove();\n  }, [map, marker, popup, lonLat?.[0], lonLat?.[1], height, open, opened]);\n\n  return createPortal(props.children, content);\n}\n\nexport interface PanelProps extends Omit<PanelOptions, 'element'> {\n  lonLat: LonLat;\n  /** What stands in 3D: a video, an iframe, a sign */\n  children?: ReactNode;\n}\n\n/** JSX standing in 3D at a position, `width` metres wide, facing `heading` */\nexport function Panel(props: PanelProps): ReactNode {\n  const map = useMap();\n  const { className } = props;\n  const element = useMemo(() => document.createElement('div'), []);\n  // The width at creation: the placement is set again by the effect below\n  const initialWidth = useRef(props.width);\n  const panel = useMemo(\n    () => new PanelHandle({ element, width: initialWidth.current, ...defined({ className }) }),\n    [element, className],\n  );\n\n  useEffect(() => {\n    if (!map) return;\n    panel.addTo(map);\n    return () => {\n      panel.remove();\n    };\n  }, [map, panel]);\n\n  const { lonLat, width, heading, pitch, height } = props;\n  useLayoutEffect(() => {\n    panel.setLonLat(lonLat);\n  }, [panel, lonLat[0], lonLat[1]]);\n  useLayoutEffect(() => {\n    panel.setPlacement(defined({ width, heading, pitch, height }));\n  }, [panel, width, heading, pitch, height]);\n  // Its content may change its CSS size\n  useLayoutEffect(() => {\n    panel.resize();\n  });\n\n  return createPortal(props.children, element);\n}\n\n// ── Effects ──\n\n/** An observer's viewshed; several `<Viewshed>` are drawn together */\nexport function Viewshed(props: ViewshedOptions): ReactNode {\n  const binding = useContext(MapContext);\n  const key = useMemo(() => ({}), []);\n  useEffect(() => {\n    if (!binding) return;\n    return () => {\n      binding.viewsheds.delete(key);\n      binding.applyViewsheds();\n    };\n  }, [binding, key]);\n  // Numbers, strings and the position: compared by value\n  const options = JSON.stringify(props);\n  useEffect(() => {\n    if (!binding) return;\n    binding.viewsheds.set(key, JSON.parse(options) as ViewshedOptions);\n    binding.applyViewsheds();\n  }, [binding, key, options]);\n  return null;\n}\n\ninterface SwipeGroup {\n  set(layer: LayerHandle): void;\n  unset(layer: LayerHandle): void;\n}\n\nexport interface SwipeProps extends Omit<SwipeOptions, 'layers'> {\n  /** The `<Layer>` shown on one side of the line only */\n  children?: ReactNode;\n}\n\n/** The `<Layer>` in it shown on one side of a vertical line only, at `position` CSS pixels from the left */\nexport function Swipe(props: SwipeProps): ReactNode {\n  const map = useMap();\n  const layers = useMemo(() => new Set<LayerHandle>(), []);\n  const latest = useRef(props);\n  latest.current = props;\n  const group = useMemo<SwipeGroup | undefined>(() => {\n    if (!map) return undefined;\n    const apply = () => {\n      const { position, side } = latest.current;\n      map.setSwipe(layers.size > 0 ? { position, layers: [...layers], ...defined({ side }) } : undefined);\n    };\n    return {\n      set: (layer) => {\n        layers.add(layer);\n        apply();\n      },\n      unset: (layer) => {\n        layers.delete(layer);\n        apply();\n      },\n    };\n  }, [map, layers]);\n\n  const { position, side } = props;\n  useEffect(() => {\n    if (map && layers.size > 0) map.setSwipe({ position, layers: [...layers], ...defined({ side }) });\n  }, [map, layers, position, side]);\n  useEffect(\n    () => () => {\n      map?.setSwipe(undefined);\n    },\n    [map],\n  );\n\n  return createElement(SwipeContext.Provider, { value: group }, props.children);\n}\n\nexport type { Camera, GeoMap, LayerHandle, LayerSpec, LonLat, MarkerHandle, PanelHandle, PopupHandle };\n"]}

package/dist/settings.d.ts

@@ -1,4 +1,4 @@
-import type { PngEncoding } from './terrain.ts';
+import type { PngEncoding } from './basemap/terrain.ts';
 import type { AtmosphereOptions, BodyOptions, CelestialBody, LoadingMode, TerrainModel, TerrainOptions } from './types.ts';
 /** Decodes the relief tiles of a URL for the engine: 256 × 256 altitudes, null where there is no tile */
 export type TerrainLoader = (z: number, x: number, y: number, signal: AbortSignal) => Promise<Float32Array | null>;

package/dist/settings.js

@@ -2,8 +2,8 @@
  * The settings of a map's engine from its options: the body, its halo, its relief, the sky. Kept by the map and
  * replayed on a new engine (after a context loss, or on the engine with 3D Tiles).
  */
-import { BODY_TERRAINS, IGN_ATTRIBUTION, IMAGE_SERVER, imageServerTerrain, TERRAIN_TILES, TERRAIN_TILES_ATTRIBUTION, TERRAIN_URL, } from "./basemaps.js";
-import { parseCssColor } from "./color.js";
+import { BODY_TERRAINS, IGN_ATTRIBUTION, IMAGE_SERVER, imageServerTerrain, TERRAIN_TILES, TERRAIN_TILES_ATTRIBUTION, TERRAIN_URL, } from "./basemap/basemaps.js";
+import { parseCssColor } from "./util/color.js";
 /** The named bodies; a body's `color` is that of its globe under the tiles (the Earth's follows its basemap), its
  * `relief` the range of its ground (the Earth's dry land, from the Dead Sea to Everest). Mars: the sphere of its
  * equatorial radius (its data take planetocentric latitudes), a faint butterscotch halo of dust */