isard 2.2.2 → 2.3.0

package/CHANGELOG.md

@@ -5,6 +5,23 @@ versions [Semantic Versioning](https://semver.org) (before 1.0.0, a minor versio
 
 ## [Unreleased]
 
+## [2.3.0] - 2026-11-01
+
+With `isard-react-native` and `isard-map` (Python) 2.3.0.
+
+### Changed
+
+- The section box is a clipping volume, a box, a cylinder or a prism standing on a polygon:
+  `map.setClipVolume({ shape, … })` in place of `setClipBox`, `getClipVolume()`, the `'clipvolume'` event, in React
+  `<ClipVolume>` and `onClipVolume`. A box's size is its `width`, `length` and `height` (`size` gone)
+
+### Added
+
+- A cylinder (`shape: 'cylinder'`, its `position` and `radius`) and a prism on a polygon (`shape: 'polygon'`, 3 to 16
+  vertices) cut the 3D layers as the box does; their handles: a cylinder's rim, a polygon's vertices dragged on the
+  ground, the top, the bottom and the middle of each. The example A section box chooses its shape, on the KIT's
+  FZK-Haus (a house of two storeys, set on its plot in Karlsruhe) in place of buildingSMART's test scene
+
 ## [2.2.2] - 2026-11-01
 
 With `isard-react-native` and `isard-map` (Python) 2.2.2.

package/dist/index.d.ts

@@ -67,7 +67,7 @@ export { type VectorFeature, VectorLayer, type VectorSublayer } from './layers/v
 export type { HoverPicking } from './map/hover-pick.ts';
 export { GeoMap, type LayerSpec } from './map.ts';
 export { PANORAMAX_API, type PanoramaxPicture, type PanoramaxSequenceOptions, panoramaxPanoramas, panoramaxPhoto, panoramaxPicture, panoramaxSequence, panoramaxStyle, } from './panoramax.ts';
-export type { AnimationOptions, AtmosphereOptions, Basemap, BasemapName, BodyOptions, CelestialBody, ClipBox, Drape, FeatureColor, FeatureHit, FirstPersonView, FlyToOptions, GeoMapOptions, LoadingMode, LonLat, MapEvents, MapGpuTimings, MapHoverFeatureEvent, MapMemory, MapPointerEvent, NetworkOptions, NetworkStyle, PickOptions, Placement, Point, Projection, Quality, RasterGrid, RasterOptions, RasterStyle, SunOptions, SwipeOptions, TerrainEncoding, TerrainModel, TerrainOptions, Tiles3dOptions, Tiles3dStyle, ViewshedOptions, } from './types.ts';
+export type { AnimationOptions, AtmosphereOptions, Basemap, BasemapName, BodyOptions, CelestialBody, ClipBox, ClipCylinder, ClipPolygon, ClipVolume, Drape, FeatureColor, FeatureHit, FirstPersonView, FlyToOptions, GeoMapOptions, LoadingMode, LonLat, MapEvents, MapGpuTimings, MapHoverFeatureEvent, MapMemory, MapPointerEvent, NetworkOptions, NetworkStyle, PickOptions, Placement, Point, Projection, Quality, RasterGrid, RasterOptions, RasterStyle, SunOptions, SwipeOptions, TerrainEncoding, TerrainModel, TerrainOptions, Tiles3dOptions, Tiles3dStyle, ViewshedOptions, } from './types.ts';
 export { AttributionControl, type AttributionOptions, type Control, type ControlPosition, NavigationControl, type NavigationOptions, } from './ui/controls.ts';
 export { MinimapControl, type MinimapOptions } from './ui/minimap.ts';
 export { type Anchor, Marker, type MarkerEvent, type MarkerEvents, type MarkerOptions, Panel, type PanelOptions, Popup, type PopupEvents, type PopupOptions, } from './ui/overlay.ts';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * isard: a WebGL2 map engine for large, interactive data layers, labels and 3D Tiles.\n *\n * ```ts\n * import { GeoMap } from 'isard';\n * const map = await GeoMap.create(container, { center: [2.4246, 48.8457], zoom: 13 });\n * const network = map.addNetwork({ nodes, edges, max: 1800, contour: 300 });\n * map.on('hover', ({ lonLat }) => lonLat && network.setValues(travelTimes(lonLat)));\n * map.addTiles3d({ url: 'https://…/tileset.json' });\n * map.addControl(new NavigationControl());\n * new Marker().setLonLat([2.4246, 48.8457]).setPopup(new Popup({ offset: [0, -34] }).setText('Here')).addTo(map);\n * ```\n */\nexport { OPENFREEMAP_ATTRIBUTION, TERRAIN_TILES_ATTRIBUTION } from './basemap/basemaps.ts';\nexport type { TileGrid, TileMatrix } from './basemap/grid.ts';\nexport { coniferModel, type TreeColors, treeModel } from './basemap/models/trees.ts';\nexport {\n  PMTiles,\n  type PmtilesEntry,\n  type PmtilesHeader,\n  type PmtilesTileType,\n  tileIdToZxy,\n  zxyToTileId,\n} from './basemap/pmtiles.ts';\nexport { basicStyle, type PmtilesOptions } from './basemap/pmtileslayer.ts';\nexport type {\n  CandidateIcon,\n  CandidateOverlap,\n  Json,\n  LabelCandidate,\n  RasterSource,\n  Style,\n  StyleLayer,\n} from './basemap/vectorstyle.ts';\nexport type { VectorExtrusionOptions } from './basemap/vectortiles/extrusions.ts';\nexport type { FurnitureOptions } from './basemap/vectortiles/furniture.ts';\nexport type { LabelsOptions } from './basemap/vectortiles/labels.ts';\nexport type { LampsOptions } from './basemap/vectortiles/lamps.ts';\nexport type { StreetWindLayer, StreetWindOptions } from './basemap/vectortiles/street-wind.ts';\nexport type { LoadedStyle } from './basemap/vectortiles/style.ts';\nexport type { TreesOptions } from './basemap/vectortiles/trees.ts';\nexport { isStreet, type VectorsOptions } from './basemap/vectortiles/vectors.ts';\nexport type { VectorRasterOptions, VectorTilesOptions } from './basemap/vectortiles.ts';\nexport { OPENFREEMAP_STYLES, PLAN_STYLES, VectorTiles } from './basemap/vectortiles.ts';\nexport { parseWmtsGrid, wmtsGrid } from './basemap/wmts.ts';\nexport { type ColladaImages, colladaImages, loadCollada, parseCollada } from './data/collada.ts';\nexport {\n  type Crs,\n  type CrsLike,\n  getCrs,\n  lambertConformalConic,\n  registerCrs,\n  reproject,\n  transverseMercator,\n} from './data/crs.ts';\nexport { parseGpx } from './data/gpx.ts';\nexport {\n  type IfcElement,\n  type IfcModel,\n  type IfcOptions,\n  type IfcPlace,\n  type IfcProperties,\n  type IfcStorey,\n  loadIfc,\n  WEB_IFC,\n} from './data/ifc.ts';\nexport { parseKml } from './data/kml.ts';\nexport { parseTopoJson, type TopoGeometry, type Topology } from './data/topojson.ts';\nexport type { DecoderUrls } from './decoding/decoders.ts';\nexport {\n  BATIMENTS_3D_URL,\n  type BdTopoBuilding,\n  batiments3d,\n  bdtopoBuildings,\n  bdtopoRoofs,\n  type GeocodedPlace,\n  geoplateformeGeocode,\n  geoplateformeWfs,\n  geoplateformeWms,\n  geoplateformeWmts,\n  IGN_ATTRIBUTION,\n  IGN_PRESETS,\n  type IgnPreset,\n  lambert93Grid,\n} from './geoplateforme.ts';\nexport { type Grid, windAt, windFields } from './grids.ts';\nexport type { CustomFrame, CustomLayerInterface } from './layers/custom.ts';\nexport { CustomLayer } from './layers/custom.ts';\nexport type { ExtrusionOptions, ExtrusionStyle, PolygonArrays, TileKey } from './layers/extrusions.ts';\nexport { ExtrusionLayer } from './layers/extrusions.ts';\nexport type {\n  CircleOptions,\n  CircleStyle,\n  Feature,\n  FeatureCollection,\n  FeatureData,\n  FeatureLayerStyle,\n  FillOptions,\n  FillStyle,\n  Geometry,\n  LineOptions,\n  LineStyle,\n  Position,\n  Properties,\n  Ramp,\n  Size,\n  Stops,\n  Styled,\n} from './layers/features.ts';\nexport { CircleLayer, FeatureLayer, FillLayer, interpolate, LineLayer, parseColor } from './layers/features.ts';\nexport type { FlowField, FlowOptions, FlowStyle, TimedField } from './layers/flow.ts';\nexport { FlowLayer, flowFieldFromImage, flowFieldsFromImage } from './layers/flow.ts';\nexport type { TextPart } from './layers/glyphs.ts';\nexport { DEFAULT_FONT, GLYPHS_URL } from './layers/glyphs.ts';\nexport type { GroundOptions, GroundTexture, GroundUniform } from './layers/ground.ts';\nexport { GroundLayer } from './layers/ground.ts';\nexport type { ImageOptions, Pixels, SpriteIcon } from './layers/icons.ts';\nexport { Layer } from './layers/layers.ts';\nexport type { ModelInstance, ModelOptions } from './layers/models.ts';\nexport { ModelLayer } from './layers/models.ts';\nexport { NetworkLayer } from './layers/network.ts';\nexport {\n  type CalibratedPanoramaOptions,\n  type Panorama,\n  type PanoramaOptions,\n  type PanoramaPhoto,\n  Panoramas,\n  type PhotoPanoramaOptions,\n} from './layers/panoramas.ts';\nexport { type PhotoOptions, photoModel } from './layers/photos.ts';\nexport type { ClassStyle, PointCloudOptions, PointCloudStyle, PointColor } from './layers/pointclouds.ts';\nexport { CLASSIFICATIONS, ELEVATION_RAMP, PointCloudLayer } from './layers/pointclouds.ts';\nexport { RasterLayer } from './layers/raster.ts';\nexport type { Overlap, SymbolOptions, SymbolStyle } from './layers/symbols.ts';\nexport { SymbolLayer } from './layers/symbols.ts';\nexport { Tiles3dLayer } from './layers/tiles3d.ts';\nexport { type TreeKind, type TreeOptions, treeKind } from './layers/trees.ts';\nexport { type VectorFeature, VectorLayer, type VectorSublayer } from './layers/vectors.ts';\nexport type { HoverPicking } from './map/hover-pick.ts';\nexport { GeoMap, type LayerSpec } from './map.ts';\nexport {\n  PANORAMAX_API,\n  type PanoramaxPicture,\n  type PanoramaxSequenceOptions,\n  panoramaxPanoramas,\n  panoramaxPhoto,\n  panoramaxPicture,\n  panoramaxSequence,\n  panoramaxStyle,\n} from './panoramax.ts';\nexport type {\n  AnimationOptions,\n  AtmosphereOptions,\n  Basemap,\n  BasemapName,\n  BodyOptions,\n  CelestialBody,\n  ClipBox,\n  Drape,\n  FeatureColor,\n  FeatureHit,\n  FirstPersonView,\n  FlyToOptions,\n  GeoMapOptions,\n  LoadingMode,\n  LonLat,\n  MapEvents,\n  MapGpuTimings,\n  MapHoverFeatureEvent,\n  MapMemory,\n  MapPointerEvent,\n  NetworkOptions,\n  NetworkStyle,\n  PickOptions,\n  Placement,\n  Point,\n  Projection,\n  Quality,\n  RasterGrid,\n  RasterOptions,\n  RasterStyle,\n  SunOptions,\n  SwipeOptions,\n  TerrainEncoding,\n  TerrainModel,\n  TerrainOptions,\n  Tiles3dOptions,\n  Tiles3dStyle,\n  ViewshedOptions,\n} from './types.ts';\nexport {\n  AttributionControl,\n  type AttributionOptions,\n  type Control,\n  type ControlPosition,\n  NavigationControl,\n  type NavigationOptions,\n} from './ui/controls.ts';\nexport { MinimapControl, type MinimapOptions } from './ui/minimap.ts';\nexport {\n  type Anchor,\n  Marker,\n  type MarkerEvent,\n  type MarkerEvents,\n  type MarkerOptions,\n  Panel,\n  type PanelOptions,\n  Popup,\n  type PopupEvents,\n  type PopupOptions,\n} from './ui/overlay.ts';\nexport { lengthLabel, roundLength, ScaleControl, type ScaleOptions } from './ui/scale.ts';\nexport { SearchControl, type SearchOptions } from './ui/search.ts';\nexport { setRequestHeaders } from './util/requests.ts';\nexport type { RoofMode } from './util/roofs.ts';\nexport { sunPosition } from './util/sun.ts';\nexport type {\n  Camera,\n  NetworkStats,\n  PickHit,\n  PickResult,\n  PointCloudInfo,\n  PointCloudPoint,\n  PointCloudStats,\n  RasterLayerStats,\n  Tiles3dStats,\n} from './wasm/isard_webgpu.js';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * isard: a WebGL2 map engine for large, interactive data layers, labels and 3D Tiles.\n *\n * ```ts\n * import { GeoMap } from 'isard';\n * const map = await GeoMap.create(container, { center: [2.4246, 48.8457], zoom: 13 });\n * const network = map.addNetwork({ nodes, edges, max: 1800, contour: 300 });\n * map.on('hover', ({ lonLat }) => lonLat && network.setValues(travelTimes(lonLat)));\n * map.addTiles3d({ url: 'https://…/tileset.json' });\n * map.addControl(new NavigationControl());\n * new Marker().setLonLat([2.4246, 48.8457]).setPopup(new Popup({ offset: [0, -34] }).setText('Here')).addTo(map);\n * ```\n */\nexport { OPENFREEMAP_ATTRIBUTION, TERRAIN_TILES_ATTRIBUTION } from './basemap/basemaps.ts';\nexport type { TileGrid, TileMatrix } from './basemap/grid.ts';\nexport { coniferModel, type TreeColors, treeModel } from './basemap/models/trees.ts';\nexport {\n  PMTiles,\n  type PmtilesEntry,\n  type PmtilesHeader,\n  type PmtilesTileType,\n  tileIdToZxy,\n  zxyToTileId,\n} from './basemap/pmtiles.ts';\nexport { basicStyle, type PmtilesOptions } from './basemap/pmtileslayer.ts';\nexport type {\n  CandidateIcon,\n  CandidateOverlap,\n  Json,\n  LabelCandidate,\n  RasterSource,\n  Style,\n  StyleLayer,\n} from './basemap/vectorstyle.ts';\nexport type { VectorExtrusionOptions } from './basemap/vectortiles/extrusions.ts';\nexport type { FurnitureOptions } from './basemap/vectortiles/furniture.ts';\nexport type { LabelsOptions } from './basemap/vectortiles/labels.ts';\nexport type { LampsOptions } from './basemap/vectortiles/lamps.ts';\nexport type { StreetWindLayer, StreetWindOptions } from './basemap/vectortiles/street-wind.ts';\nexport type { LoadedStyle } from './basemap/vectortiles/style.ts';\nexport type { TreesOptions } from './basemap/vectortiles/trees.ts';\nexport { isStreet, type VectorsOptions } from './basemap/vectortiles/vectors.ts';\nexport type { VectorRasterOptions, VectorTilesOptions } from './basemap/vectortiles.ts';\nexport { OPENFREEMAP_STYLES, PLAN_STYLES, VectorTiles } from './basemap/vectortiles.ts';\nexport { parseWmtsGrid, wmtsGrid } from './basemap/wmts.ts';\nexport { type ColladaImages, colladaImages, loadCollada, parseCollada } from './data/collada.ts';\nexport {\n  type Crs,\n  type CrsLike,\n  getCrs,\n  lambertConformalConic,\n  registerCrs,\n  reproject,\n  transverseMercator,\n} from './data/crs.ts';\nexport { parseGpx } from './data/gpx.ts';\nexport {\n  type IfcElement,\n  type IfcModel,\n  type IfcOptions,\n  type IfcPlace,\n  type IfcProperties,\n  type IfcStorey,\n  loadIfc,\n  WEB_IFC,\n} from './data/ifc.ts';\nexport { parseKml } from './data/kml.ts';\nexport { parseTopoJson, type TopoGeometry, type Topology } from './data/topojson.ts';\nexport type { DecoderUrls } from './decoding/decoders.ts';\nexport {\n  BATIMENTS_3D_URL,\n  type BdTopoBuilding,\n  batiments3d,\n  bdtopoBuildings,\n  bdtopoRoofs,\n  type GeocodedPlace,\n  geoplateformeGeocode,\n  geoplateformeWfs,\n  geoplateformeWms,\n  geoplateformeWmts,\n  IGN_ATTRIBUTION,\n  IGN_PRESETS,\n  type IgnPreset,\n  lambert93Grid,\n} from './geoplateforme.ts';\nexport { type Grid, windAt, windFields } from './grids.ts';\nexport type { CustomFrame, CustomLayerInterface } from './layers/custom.ts';\nexport { CustomLayer } from './layers/custom.ts';\nexport type { ExtrusionOptions, ExtrusionStyle, PolygonArrays, TileKey } from './layers/extrusions.ts';\nexport { ExtrusionLayer } from './layers/extrusions.ts';\nexport type {\n  CircleOptions,\n  CircleStyle,\n  Feature,\n  FeatureCollection,\n  FeatureData,\n  FeatureLayerStyle,\n  FillOptions,\n  FillStyle,\n  Geometry,\n  LineOptions,\n  LineStyle,\n  Position,\n  Properties,\n  Ramp,\n  Size,\n  Stops,\n  Styled,\n} from './layers/features.ts';\nexport { CircleLayer, FeatureLayer, FillLayer, interpolate, LineLayer, parseColor } from './layers/features.ts';\nexport type { FlowField, FlowOptions, FlowStyle, TimedField } from './layers/flow.ts';\nexport { FlowLayer, flowFieldFromImage, flowFieldsFromImage } from './layers/flow.ts';\nexport type { TextPart } from './layers/glyphs.ts';\nexport { DEFAULT_FONT, GLYPHS_URL } from './layers/glyphs.ts';\nexport type { GroundOptions, GroundTexture, GroundUniform } from './layers/ground.ts';\nexport { GroundLayer } from './layers/ground.ts';\nexport type { ImageOptions, Pixels, SpriteIcon } from './layers/icons.ts';\nexport { Layer } from './layers/layers.ts';\nexport type { ModelInstance, ModelOptions } from './layers/models.ts';\nexport { ModelLayer } from './layers/models.ts';\nexport { NetworkLayer } from './layers/network.ts';\nexport {\n  type CalibratedPanoramaOptions,\n  type Panorama,\n  type PanoramaOptions,\n  type PanoramaPhoto,\n  Panoramas,\n  type PhotoPanoramaOptions,\n} from './layers/panoramas.ts';\nexport { type PhotoOptions, photoModel } from './layers/photos.ts';\nexport type { ClassStyle, PointCloudOptions, PointCloudStyle, PointColor } from './layers/pointclouds.ts';\nexport { CLASSIFICATIONS, ELEVATION_RAMP, PointCloudLayer } from './layers/pointclouds.ts';\nexport { RasterLayer } from './layers/raster.ts';\nexport type { Overlap, SymbolOptions, SymbolStyle } from './layers/symbols.ts';\nexport { SymbolLayer } from './layers/symbols.ts';\nexport { Tiles3dLayer } from './layers/tiles3d.ts';\nexport { type TreeKind, type TreeOptions, treeKind } from './layers/trees.ts';\nexport { type VectorFeature, VectorLayer, type VectorSublayer } from './layers/vectors.ts';\nexport type { HoverPicking } from './map/hover-pick.ts';\nexport { GeoMap, type LayerSpec } from './map.ts';\nexport {\n  PANORAMAX_API,\n  type PanoramaxPicture,\n  type PanoramaxSequenceOptions,\n  panoramaxPanoramas,\n  panoramaxPhoto,\n  panoramaxPicture,\n  panoramaxSequence,\n  panoramaxStyle,\n} from './panoramax.ts';\nexport type {\n  AnimationOptions,\n  AtmosphereOptions,\n  Basemap,\n  BasemapName,\n  BodyOptions,\n  CelestialBody,\n  ClipBox,\n  ClipCylinder,\n  ClipPolygon,\n  ClipVolume,\n  Drape,\n  FeatureColor,\n  FeatureHit,\n  FirstPersonView,\n  FlyToOptions,\n  GeoMapOptions,\n  LoadingMode,\n  LonLat,\n  MapEvents,\n  MapGpuTimings,\n  MapHoverFeatureEvent,\n  MapMemory,\n  MapPointerEvent,\n  NetworkOptions,\n  NetworkStyle,\n  PickOptions,\n  Placement,\n  Point,\n  Projection,\n  Quality,\n  RasterGrid,\n  RasterOptions,\n  RasterStyle,\n  SunOptions,\n  SwipeOptions,\n  TerrainEncoding,\n  TerrainModel,\n  TerrainOptions,\n  Tiles3dOptions,\n  Tiles3dStyle,\n  ViewshedOptions,\n} from './types.ts';\nexport {\n  AttributionControl,\n  type AttributionOptions,\n  type Control,\n  type ControlPosition,\n  NavigationControl,\n  type NavigationOptions,\n} from './ui/controls.ts';\nexport { MinimapControl, type MinimapOptions } from './ui/minimap.ts';\nexport {\n  type Anchor,\n  Marker,\n  type MarkerEvent,\n  type MarkerEvents,\n  type MarkerOptions,\n  Panel,\n  type PanelOptions,\n  Popup,\n  type PopupEvents,\n  type PopupOptions,\n} from './ui/overlay.ts';\nexport { lengthLabel, roundLength, ScaleControl, type ScaleOptions } from './ui/scale.ts';\nexport { SearchControl, type SearchOptions } from './ui/search.ts';\nexport { setRequestHeaders } from './util/requests.ts';\nexport type { RoofMode } from './util/roofs.ts';\nexport { sunPosition } from './util/sun.ts';\nexport type {\n  Camera,\n  NetworkStats,\n  PickHit,\n  PickResult,\n  PointCloudInfo,\n  PointCloudPoint,\n  PointCloudStats,\n  RasterLayerStats,\n  Tiles3dStats,\n} from './wasm/isard_webgpu.js';\n"]}

package/dist/map/clip-volume.d.ts

@@ -0,0 +1,60 @@
+/**
+ * The clipping volume (`GeoMap.setClipVolume`): given to the engine, and its handles over the map, an outline of its
+ * edges and discs to size it (on a box's faces, a cylinder's rim, a polygon's vertices, its top and bottom) and one at
+ * its middle to move it, placed after every frame.
+ */
+import type { ClipVolume, LonLat, Point } from '../types.ts';
+import type { Positioned } from '../ui/overlay.ts';
+import type { Engine } from '../wasm/isard_webgpu.js';
+/** Sets the volume in the engine, or clears it without one; `radius` the body's (metres to degrees) */
+export declare const applyClipVolume: (engine: Engine, volume: ClipVolume | undefined, radius: number) => void;
+/** What the handles need from the map */
+export interface ClipVolumeHost {
+    project(lonLat: LonLat, height?: number): Point | undefined;
+    unproject(point: Point): LonLat | undefined;
+    elevationAt(lonLat: LonLat): number | undefined;
+    getCanvas(): HTMLCanvasElement;
+    /** The volume changed by a handle: set, and told */
+    moved(volume: ClipVolume): void;
+}
+/** The handles of a volume, over the map */
+export declare class ClipVolumeHandles implements Positioned {
+    private readonly host;
+    private volume;
+    /** Metres of the body's radius (metres to degrees) */
+    private readonly radius;
+    /** Over the canvas, its drawing within */
+    readonly element: HTMLDivElement;
+    private readonly svg;
+    private lines;
+    private discs;
+    /** The handles drawn, as the discs are */
+    private handles;
+    /** The handle held (its disc), the pointer and the volume where it was pressed, the ground grabbed */
+    private held;
+    constructor(host: ClipVolumeHost, volume: ClipVolume, 
+    /** Metres of the body's radius (metres to degrees) */
+    radius: number);
+    /** The volume the handles follow from the next placing (`position`, after each frame) */
+    set(volume: ClipVolume): void;
+    position(): void;
+    /** `elements` grown or cut to `count`, those made put `under` the others (the lines under the discs) or over them */
+    private resized;
+    private disc;
+    /** A point of the volume on the screen */
+    private screen;
+    /** The volume's foot outline (metres east and north of its center), closed by its first point */
+    private foot;
+    /** The edges: the foot's and the top's outlines, and the uprights at their corners (four of a cylinder's) */
+    private outline;
+    /** The handles of a volume: its sides', its top's and bottom's, the one that moves it */
+    private handlesOf;
+    /** The handles on a volume's sides: a box's four faces, a cylinder's rim, a polygon's vertices */
+    private sides;
+    private local;
+    private down;
+    private move;
+    /** Metres the pointer dragged a handle along its direction: the drag along that direction on the screen */
+    private dragged;
+    private up;
+}

package/dist/map/clip-volume.js

@@ -0,0 +1,352 @@
+/**
+ * The clipping volume (`GeoMap.setClipVolume`): given to the engine, and its handles over the map, an outline of its
+ * edges and discs to size it (on a box's faces, a cylinder's rim, a polygon's vertices, its top and bottom) and one at
+ * its middle to move it, placed after every frame.
+ */
+import { rgb } from "../settings.js";
+/** The faces' color by default: plaster, as a section on a plan */
+const SECTION = '#d9cfc1';
+/** Metres a side, a radius or a height keeps at least */
+const SMALLEST = 0.2;
+/** The vertices a polygon keeps at most (the engine's) */
+const POLYGON = 16;
+/** Segments of a cylinder's outline */
+const ROUND = 48;
+const SVG = 'http://www.w3.org/2000/svg';
+const SHAPES = { box: 0, cylinder: 1, polygon: 2 };
+/** A volume's foot's center: a box's or a cylinder's position, a polygon's vertices' mean */
+const originOf = (volume) => {
+    if (volume.shape !== 'polygon')
+        return volume.position;
+    const n = Math.max(1, volume.polygon.length);
+    const [lon, lat] = volume.polygon.reduce(([a, b], [x, y]) => [a + x, b + y], [0, 0]);
+    return [lon / n, lat / n];
+};
+/** Metres east and north of `origin` to degrees, and back, on a body of `radius` metres */
+const metric = (origin, radius) => {
+    const degrees = 180 / Math.PI;
+    const across = radius * Math.cos(origin[1] / degrees);
+    return {
+        lonLat: (east, north) => [
+            origin[0] + (east / across) * degrees,
+            origin[1] + (north / radius) * degrees,
+        ],
+        local: ([lon, lat]) => [
+            ((lon - origin[0]) / degrees) * across,
+            ((lat - origin[1]) / degrees) * radius,
+        ],
+    };
+};
+/** A volume's metres across and along (a cylinder's diameter) and its heading, for the engine */
+const footprintOf = (volume) => {
+    if (volume.shape === 'box')
+        return [volume.width, volume.length, volume.heading ?? 0];
+    if (volume.shape === 'cylinder')
+        return [volume.radius * 2, volume.radius * 2, 0];
+    return [0, 0, 0];
+};
+/** Sets the volume in the engine, or clears it without one; `radius` the body's (metres to degrees) */
+export const applyClipVolume = (engine, volume, radius) => {
+    if (!volume) {
+        engine.clearClipVolume();
+        return;
+    }
+    const origin = originOf(volume);
+    const { local } = metric(origin, radius);
+    const section = volume.sectionColor === null ? [] : rgb(volume.sectionColor ?? SECTION);
+    const [width, length, heading] = footprintOf(volume);
+    const polygon = volume.shape === 'polygon' ? volume.polygon.slice(0, POLYGON).flatMap((v) => local(v)) : [];
+    engine.setClipVolume(new Float64Array([
+        origin[0],
+        origin[1],
+        volume.altitude ?? 0,
+        width,
+        length,
+        volume.height,
+        heading,
+        volume.cut === 'outside' ? 0 : 1,
+        volume.altitudeReference === 'sea' ? 0 : 1,
+        SHAPES[volume.shape],
+    ]), new Float64Array(polygon), new Float32Array(section));
+};
+/** The volume's foot and top moved: `top` the top face, else the bottom one, `metres` outward */
+const heightened = (volume, top, metres) => {
+    const height = Math.max(SMALLEST, volume.height + metres);
+    return top
+        ? { ...volume, height }
+        : { ...volume, height, altitude: (volume.altitude ?? 0) - (height - volume.height) };
+};
+/** The volume moved `east` and `north` metres */
+const moved = (volume, east, north, radius) => {
+    if (volume.shape === 'polygon') {
+        return {
+            ...volume,
+            polygon: volume.polygon.map((v) => {
+                const { local, lonLat } = metric(v, radius);
+                const [e, n] = local(v);
+                return lonLat(e + east, n + north);
+            }),
+        };
+    }
+    return { ...volume, position: metric(volume.position, radius).lonLat(east, north) };
+};
+/** The handles of a volume, over the map */
+export class ClipVolumeHandles {
+    host;
+    volume;
+    radius;
+    /** Over the canvas, its drawing within */
+    element;
+    svg;
+    lines = [];
+    discs = [];
+    /** The handles drawn, as the discs are */
+    handles = [];
+    /** The handle held (its disc), the pointer and the volume where it was pressed, the ground grabbed */
+    held;
+    constructor(host, volume, 
+    /** Metres of the body's radius (metres to degrees) */
+    radius) {
+        this.host = host;
+        this.volume = volume;
+        this.radius = radius;
+        this.svg = document.createElementNS(SVG, 'svg');
+        this.element = document.createElement('div');
+        this.element.className = 'isard-clipvolume';
+        this.element.append(this.svg);
+    }
+    /** The volume the handles follow from the next placing (`position`, after each frame) */
+    set(volume) {
+        this.volume = volume;
+    }
+    position() {
+        const segments = this.outline(this.volume);
+        this.handles = this.handlesOf(this.volume);
+        this.lines = this.resized(this.lines, segments.length, () => document.createElementNS(SVG, 'line'), true);
+        this.discs = this.resized(this.discs, this.handles.length, () => this.disc(), false);
+        segments.forEach(([a, b], i) => {
+            const [p, q] = [this.screen(a), this.screen(b)];
+            const line = this.lines[i];
+            if (!line)
+                return;
+            line.style.display = p && q ? '' : 'none';
+            if (!p || !q)
+                return;
+            line.setAttribute('x1', String(p[0]));
+            line.setAttribute('y1', String(p[1]));
+            line.setAttribute('x2', String(q[0]));
+            line.setAttribute('y2', String(q[1]));
+        });
+        this.handles.forEach((handle, i) => {
+            const p = this.screen(handle.at);
+            const disc = this.discs[i];
+            if (!disc)
+                return;
+            disc.setAttribute('r', handle.move ? '8' : '6');
+            disc.setAttribute('class', handle.move ? 'isard-clipvolume-move' : 'isard-clipvolume-size');
+            disc.style.display = p ? '' : 'none';
+            if (!p)
+                return;
+            disc.setAttribute('cx', String(p[0]));
+            disc.setAttribute('cy', String(p[1]));
+        });
+    }
+    /** `elements` grown or cut to `count`, those made put `under` the others (the lines under the discs) or over them */
+    resized(elements, count, make, under) {
+        elements.slice(count).forEach((e) => {
+            e.remove();
+        });
+        const kept = elements.slice(0, count);
+        const made = Array.from({ length: count - kept.length }, make);
+        made.forEach((e) => {
+            if (under)
+                this.svg.prepend(e);
+            else
+                this.svg.append(e);
+        });
+        return [...kept, ...made];
+    }
+    disc() {
+        const disc = document.createElementNS(SVG, 'circle');
+        disc.addEventListener('pointerdown', (e) => this.down(e, disc));
+        disc.addEventListener('pointermove', (e) => this.move(e));
+        disc.addEventListener('pointerup', (e) => this.up(e));
+        disc.addEventListener('pointercancel', (e) => this.up(e));
+        // Safari may let the capture go: the release would then reach the map, not the disc
+        disc.addEventListener('lostpointercapture', (e) => this.up(e));
+        return disc;
+    }
+    /** A point of the volume on the screen */
+    screen([east, north, up], volume = this.volume) {
+        const origin = originOf(volume);
+        const lonLat = metric(origin, this.radius).lonLat(east, north);
+        // `project` measures from the relief: an altitude above the ellipsoid less the relief under the volume
+        const ground = volume.altitudeReference === 'sea' ? (this.host.elevationAt(origin) ?? 0) : 0;
+        return this.host.project(lonLat, (volume.altitude ?? 0) - ground + up);
+    }
+    /** The volume's foot outline (metres east and north of its center), closed by its first point */
+    foot(volume) {
+        if (volume.shape === 'cylinder') {
+            return Array.from({ length: ROUND }, (_, k) => {
+                const a = (2 * Math.PI * k) / ROUND;
+                return [volume.radius * Math.cos(a), volume.radius * Math.sin(a)];
+            });
+        }
+        if (volume.shape === 'polygon') {
+            const { local } = metric(originOf(volume), this.radius);
+            return volume.polygon.map((v) => local(v));
+        }
+        const heading = ((volume.heading ?? 0) * Math.PI) / 180;
+        const [sin, cos] = [Math.sin(heading), Math.cos(heading)];
+        const [w, l] = [volume.width / 2, volume.length / 2];
+        return [
+            [-w, -l],
+            [w, -l],
+            [w, l],
+            [-w, l],
+        ].map(([a, b]) => [(a ?? 0) * cos + (b ?? 0) * sin, (b ?? 0) * cos - (a ?? 0) * sin]);
+    }
+    /** The edges: the foot's and the top's outlines, and the uprights at their corners (four of a cylinder's) */
+    outline(volume) {
+        const foot = this.foot(volume);
+        const h = volume.height;
+        const ring = (up) => foot.map(([e, n], k) => {
+            const [e2, n2] = foot[(k + 1) % foot.length] ?? [e, n];
+            return [
+                [e, n, up],
+                [e2, n2, up],
+            ];
+        });
+        const uprights = (volume.shape === 'cylinder' ? foot.filter((_, k) => k % (ROUND / 4) === 0) : foot).map(([e, n]) => [
+            [e, n, 0],
+            [e, n, h],
+        ]);
+        return [...ring(0), ...ring(h), ...uprights];
+    }
+    /** The handles of a volume: its sides', its top's and bottom's, the one that moves it */
+    handlesOf(volume) {
+        const h = volume.height;
+        const vertical = [
+            { at: [0, 0, h], along: [0, 0, 1], resize: (v, m) => heightened(v, true, m) },
+            { at: [0, 0, 0], along: [0, 0, -1], resize: (v, m) => heightened(v, false, m) },
+        ];
+        const move = {
+            at: [0, 0, h / 2],
+            move: true,
+            ground: (v, east, north) => moved(v, east, north, this.radius),
+        };
+        return [...this.sides(volume), ...vertical, move];
+    }
+    /** The handles on a volume's sides: a box's four faces, a cylinder's rim, a polygon's vertices */
+    sides(volume) {
+        const h = volume.height / 2;
+        if (volume.shape === 'cylinder') {
+            return [
+                {
+                    at: [volume.radius, 0, h],
+                    along: [1, 0, 0],
+                    resize: (v, m) => (v.shape === 'cylinder' ? { ...v, radius: Math.max(SMALLEST, v.radius + m) } : v),
+                },
+            ];
+        }
+        if (volume.shape === 'polygon') {
+            const { local } = metric(originOf(volume), this.radius);
+            const shifted = (vertex, east, north) => metric(vertex, this.radius).lonLat(east, north);
+            return volume.polygon.map((vertex, k) => {
+                const [e, n] = local(vertex);
+                return {
+                    at: [e, n, 0],
+                    ground: (v, east, north) => v.shape === 'polygon'
+                        ? { ...v, polygon: v.polygon.map((p, i) => (i === k ? shifted(p, east, north) : p)) }
+                        : v,
+                };
+            });
+        }
+        const heading = ((volume.heading ?? 0) * Math.PI) / 180;
+        const [sin, cos] = [Math.sin(heading), Math.cos(heading)];
+        // Across and along its heading, east and north
+        const across = [cos, -sin];
+        const along = [sin, cos];
+        const face = (axis, half, side, width) => ({
+            at: [axis[0] * half * side, axis[1] * half * side, h],
+            along: [axis[0] * side, axis[1] * side, 0],
+            resize: (v, m) => {
+                if (v.shape !== 'box')
+                    return v;
+                const size = Math.max(SMALLEST, (width ? v.width : v.length) + m);
+                const shift = (side * (size - (width ? v.width : v.length))) / 2;
+                const box = width ? { ...v, width: size } : { ...v, length: size };
+                // The center half-way along the move, on the side of the face moved: the opposite face where it was
+                return moved(box, axis[0] * shift, axis[1] * shift, this.radius);
+            },
+        });
+        return [
+            face(across, volume.width / 2, -1, true),
+            face(across, volume.width / 2, 1, true),
+            face(along, volume.length / 2, -1, false),
+            face(along, volume.length / 2, 1, false),
+        ];
+    }
+    local(e) {
+        const rect = this.host.getCanvas().getBoundingClientRect();
+        return [e.clientX - rect.left, e.clientY - rect.top];
+    }
+    down(e, disc) {
+        const handle = this.handles[this.discs.indexOf(disc)];
+        if (e.button !== 0 || !handle)
+            return;
+        const start = this.local(e);
+        // The map must not pan under the handle
+        e.stopPropagation();
+        e.preventDefault();
+        disc.setPointerCapture(e.pointerId);
+        // The spot of the ground grabbed, kept under the pointer as the volume moves
+        this.held = { handle, disc, start, volume: this.volume, grab: this.host.unproject(start) };
+    }
+    move(e) {
+        if (!this.held)
+            return;
+        // No button held any more: its release was missed (the capture lost), the drag is over
+        if (e.buttons === 0) {
+            this.up(e);
+            return;
+        }
+        e.stopPropagation();
+        const { handle, start, volume, grab } = this.held;
+        const at = this.local(e);
+        if ('ground' in handle) {
+            const lonLat = this.host.unproject(at);
+            if (!lonLat || !grab)
+                return;
+            // As far as the ground under the pointer moved from the spot grabbed
+            const [east, north] = metric(grab, this.radius).local(lonLat);
+            this.host.moved(handle.ground(volume, east, north));
+            return;
+        }
+        const metres = this.dragged(volume, handle, [at[0] - start[0], at[1] - start[1]]);
+        if (metres !== undefined)
+            this.host.moved(handle.resize(volume, metres));
+    }
+    /** Metres the pointer dragged a handle along its direction: the drag along that direction on the screen */
+    dragged(volume, handle, [dx, dy]) {
+        const [e, n, u] = handle.at;
+        const [de, dn, du] = handle.along;
+        const from = this.screen(handle.at, volume);
+        // Where the handle goes a metre that way, on the screen: pixels per metre along it
+        const to = this.screen([e + de, n + dn, u + du], volume);
+        if (!from || !to)
+            return undefined;
+        const [ax, ay] = [to[0] - from[0], to[1] - from[1]];
+        const squared = ax * ax + ay * ay;
+        return squared > 1e-6 ? (dx * ax + dy * ay) / squared : undefined;
+    }
+    up(e) {
+        if (!this.held)
+            return;
+        e.stopPropagation();
+        if (this.held.disc.hasPointerCapture(e.pointerId))
+            this.held.disc.releasePointerCapture(e.pointerId);
+        this.held = undefined;
+    }
+}
+//# sourceMappingURL=clip-volume.js.map

package/dist/map/clip-volume.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clip-volume.js","sourceRoot":"","sources":["../../src/map/clip-volume.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,GAAG,EAAE,MAAM,gBAAgB,CAAC;AAKrC,mEAAmE;AACnE,MAAM,OAAO,GAAG,SAAS,CAAC;AAC1B,yDAAyD;AACzD,MAAM,QAAQ,GAAG,GAAG,CAAC;AACrB,0DAA0D;AAC1D,MAAM,OAAO,GAAG,EAAE,CAAC;AACnB,uCAAuC;AACvC,MAAM,KAAK,GAAG,EAAE,CAAC;AACjB,MAAM,GAAG,GAAG,4BAA4B,CAAC;AACzC,MAAM,MAAM,GAAG,EAAE,GAAG,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAW,CAAC;AAK5D,6FAA6F;AAC7F,MAAM,QAAQ,GAAG,CAAC,MAAkB,EAAU,EAAE;IAC9C,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS;QAAE,OAAO,MAAM,CAAC,QAAQ,CAAC;IAEvD,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAC7C,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAErF,OAAO,CAAC,GAAG,GAAG,CAAC,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC;AAC5B,CAAC,CAAC;AAEF,2FAA2F;AAC3F,MAAM,MAAM,GAAG,CAAC,MAAc,EAAE,MAAc,EAAE,EAAE;IAChD,MAAM,OAAO,GAAG,GAAG,GAAG,IAAI,CAAC,EAAE,CAAC;IAC9B,MAAM,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC;IAEtD,OAAO;QACL,MAAM,EAAE,CAAC,IAAY,EAAE,KAAa,EAAU,EAAE,CAAC;YAC/C,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,GAAG,MAAM,CAAC,GAAG,OAAO;YACrC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,GAAG,MAAM,CAAC,GAAG,OAAO;SACvC;QACD,KAAK,EAAE,CAAC,CAAC,GAAG,EAAE,GAAG,CAAS,EAAoB,EAAE,CAAC;YAC/C,CAAC,CAAC,GAAG,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,GAAG,MAAM;YACtC,CAAC,CAAC,GAAG,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,GAAG,MAAM;SACvC;KACF,CAAC;AACJ,CAAC,CAAC;AAEF,iGAAiG;AACjG,MAAM,WAAW,GAAG,CAAC,MAAkB,EAA4B,EAAE;IACnE,IAAI,MAAM,CAAC,KAAK,KAAK,KAAK;QAAE,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC;IACtF,IAAI,MAAM,CAAC,KAAK,KAAK,UAAU;QAAE,OAAO,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;IAElF,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;AACnB,CAAC,CAAC;AAEF,uGAAuG;AACvG,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,MAAc,EAAE,MAA8B,EAAE,MAAc,EAAQ,EAAE;IACtG,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,CAAC,eAAe,EAAE,CAAC;QAEzB,OAAO;IACT,CAAC;IAED,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC;IAChC,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,MAAM,OAAO,GAAG,MAAM,CAAC,YAAY,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,YAAY,IAAI,OAAO,CAAC,CAAC;IACxF,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;IACrD,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAE5G,MAAM,CAAC,aAAa,CAClB,IAAI,YAAY,CAAC;QACf,MAAM,CAAC,CAAC,CAAC;QACT,MAAM,CAAC,CAAC,CAAC;QACT,MAAM,CAAC,QAAQ,IAAI,CAAC;QACpB,KAAK;QACL,MAAM;QACN,MAAM,CAAC,MAAM;QACb,OAAO;QACP,MAAM,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAChC,MAAM,CAAC,iBAAiB,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC1C,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC;KACrB,CAAC,EACF,IAAI,YAAY,CAAC,OAAO,CAAC,EACzB,IAAI,YAAY,CAAC,OAAO,CAAC,CAC1B,CAAC;AACJ,CAAC,CAAC;AAsBF,iGAAiG;AACjG,MAAM,UAAU,GAAG,CAAC,MAAkB,EAAE,GAAY,EAAE,MAAc,EAAc,EAAE;IAClF,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;IAE1D,OAAO,GAAG;QACR,CAAC,CAAC,EAAE,GAAG,MAAM,EAAE,MAAM,EAAE;QACvB,CAAC,CAAC,EAAE,GAAG,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,MAAM,CAAC,QAAQ,IAAI,CAAC,CAAC,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;AACzF,CAAC,CAAC;AAEF,iDAAiD;AACjD,MAAM,KAAK,GAAG,CAAC,MAAkB,EAAE,IAAY,EAAE,KAAa,EAAE,MAAc,EAAc,EAAE;IAC5F,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAC/B,OAAO;YACL,GAAG,MAAM;YACT,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;gBAChC,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;gBAC5C,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;gBAExB,OAAO,MAAM,CAAC,CAAC,GAAG,IAAI,EAAE,CAAC,GAAG,KAAK,CAAC,CAAC;YACrC,CAAC,CAAC;SACH,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,GAAG,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,CAAC;AACtF,CAAC,CAAC;AAEF,4CAA4C;AAC5C,MAAM,OAAO,iBAAiB;IAcT;IACT;IAES;IAhBnB,0CAA0C;IACjC,OAAO,CAAiB;IAChB,GAAG,CAAgB;IAC5B,KAAK,GAAqB,EAAE,CAAC;IAC7B,KAAK,GAAuB,EAAE,CAAC;IACvC,0CAA0C;IAClC,OAAO,GAAa,EAAE,CAAC;IAC/B,sGAAsG;IAC9F,IAAI,CAEE;IAEd,YACmB,IAAoB,EAC7B,MAAkB;IAC1B,sDAAsD;IACrC,MAAc;QAHd,SAAI,GAAJ,IAAI,CAAgB;QAC7B,WAAM,GAAN,MAAM,CAAY;QAET,WAAM,GAAN,MAAM,CAAQ;QAE/B,IAAI,CAAC,GAAG,GAAG,QAAQ,CAAC,eAAe,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAChD,IAAI,CAAC,OAAO,GAAG,QAAQ,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;QAC7C,IAAI,CAAC,OAAO,CAAC,SAAS,GAAG,kBAAkB,CAAC;QAC5C,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAChC,CAAC;IAED,yFAAyF;IACzF,GAAG,CAAC,MAAkB;QACpB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,QAAQ;QACN,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAE3C,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC3C,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,eAAe,CAAC,GAAG,EAAE,MAAM,CAAC,EAAE,IAAI,CAAC,CAAC;QAC1G,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,KAAK,CAAC,CAAC;QACrF,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;YAC7B,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;YAChD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YAE3B,IAAI,CAAC,IAAI;gBAAE,OAAO;YAClB,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC;YAC1C,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC;gBAAE,OAAO;YACrB,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACtC,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACtC,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACtC,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACxC,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE;YACjC,MAAM,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YACjC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YAE3B,IAAI,CAAC,IAAI;gBAAE,OAAO;YAClB,IAAI,CAAC,YAAY,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;YAChD,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,uBAAuB,CAAC,CAAC,CAAC,uBAAuB,CAAC,CAAC;YAC5F,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC;YACrC,IAAI,CAAC,CAAC;gBAAE,OAAO;YACf,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACtC,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACxC,CAAC,CAAC,CAAC;IACL,CAAC;IAED,qHAAqH;IAC7G,OAAO,CAAuB,QAAa,EAAE,KAAa,EAAE,IAAa,EAAE,KAAc;QAC/F,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE;YAClC,CAAC,CAAC,MAAM,EAAE,CAAC;QACb,CAAC,CAAC,CAAC;QAEH,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;QACtC,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,EAAE,IAAI,CAAC,CAAC;QAE/D,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE;YACjB,IAAI,KAAK;gBAAE,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;;gBAC1B,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QAC1B,CAAC,CAAC,CAAC;QAEH,OAAO,CAAC,GAAG,IAAI,EAAE,GAAG,IAAI,CAAC,CAAC;IAC5B,CAAC;IAEO,IAAI;QACV,MAAM,IAAI,GAAG,QAAQ,CAAC,eAAe,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;QAErD,IAAI,CAAC,gBAAgB,CAAC,aAAa,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC;QAChE,IAAI,CAAC,gBAAgB,CAAC,aAAa,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QAC1D,IAAI,CAAC,gBAAgB,CAAC,WAAW,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QACtD,IAAI,CAAC,gBAAgB,CAAC,eAAe,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QAC1D,oFAAoF;QACpF,IAAI,CAAC,gBAAgB,CAAC,oBAAoB,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QAE/D,OAAO,IAAI,CAAC;IACd,CAAC;IAED,0CAA0C;IAClC,MAAM,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAQ,EAAE,MAAM,GAAG,IAAI,CAAC,MAAM;QAC3D,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC;QAChC,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAC/D,uGAAuG;QACvG,MAAM,MAAM,GAAG,MAAM,CAAC,iBAAiB,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAE7F,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,QAAQ,IAAI,CAAC,CAAC,GAAG,MAAM,GAAG,EAAE,CAAC,CAAC;IACzE,CAAC;IAED,iGAAiG;IACzF,IAAI,CAAC,MAAkB;QAC7B,IAAI,MAAM,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;YAChC,OAAO,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;gBAC5C,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC;gBAEpC,OAAO,CAAC,MAAM,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;YACpE,CAAC,CAAC,CAAC;QACL,CAAC;QACD,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YAC/B,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;YAExD,OAAO,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QAC7C,CAAC;QAED,MAAM,OAAO,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC;QACxD,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;QAC1D,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAErD,OAAO;YACL,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YACR,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YACP,CAAC,CAAC,EAAE,CAAC,CAAC;YACN,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;SACR,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC;IACxF,CAAC;IAED,6GAA6G;IACrG,OAAO,CAAC,MAAkB;QAChC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC/B,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC;QACxB,MAAM,IAAI,GAAG,CAAC,EAAU,EAAE,EAAE,CAC1B,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAkB,EAAE;YACrC,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YAEvD,OAAO;gBACL,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;gBACV,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC;aACb,CAAC;QACJ,CAAC,CAAC,CAAC;QACL,MAAM,QAAQ,GAAG,CAAC,MAAM,CAAC,KAAK,KAAK,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CACtG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAkB,EAAE,CAAC;YAC1B,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;YACT,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;SACV,CACF,CAAC;QAEF,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,QAAQ,CAAC,CAAC;IAC/C,CAAC;IAED,yFAAyF;IACjF,SAAS,CAAC,MAAkB;QAClC,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC;QACxB,MAAM,QAAQ,GAAa;YACzB,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE;YAC7E,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,EAAE;SAChF,CAAC;QACF,MAAM,IAAI,GAAW;YACnB,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;YACjB,IAAI,EAAE,IAAI;YACV,MAAM,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC;SAC/D,CAAC;QAEF,OAAO,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,GAAG,QAAQ,EAAE,IAAI,CAAC,CAAC;IACpD,CAAC;IAED,kGAAkG;IAC1F,KAAK,CAAC,MAAkB;QAC9B,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC;QAE5B,IAAI,MAAM,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;YAChC,OAAO;gBACL;oBACE,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC;oBACzB,KAAK,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;oBAChB,MAAM,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,KAAK,UAAU,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;iBACpG;aACF,CAAC;QACJ,CAAC;QACD,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YAC/B,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;YACxD,MAAM,OAAO,GAAG,CAAC,MAAc,EAAE,IAAY,EAAE,KAAa,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;YAEjH,OAAO,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE;gBACtC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;gBAE7B,OAAO;oBACL,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;oBACb,MAAM,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,CACzB,CAAC,CAAC,KAAK,KAAK,SAAS;wBACnB,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE;wBACrF,CAAC,CAAC,CAAC;iBACR,CAAC;YACJ,CAAC,CAAC,CAAC;QACL,CAAC;QAED,MAAM,OAAO,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC;QACxD,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;QAC1D,+CAA+C;QAC/C,MAAM,MAAM,GAAqB,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC;QAC7C,MAAM,KAAK,GAAqB,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QAC3C,MAAM,IAAI,GAAG,CAAC,IAAsB,EAAE,IAAY,EAAE,IAAY,EAAE,KAAc,EAAU,EAAE,CAAC,CAAC;YAC5F,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,IAAI,EAAE,CAAC,CAAC;YACrD,KAAK,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC;YAC1C,MAAM,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;gBACf,IAAI,CAAC,CAAC,KAAK,KAAK,KAAK;oBAAE,OAAO,CAAC,CAAC;gBAEhC,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;gBAClE,MAAM,KAAK,GAAG,CAAC,IAAI,GAAG,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;gBACjE,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;gBAEnE,oGAAoG;gBACpG,OAAO,KAAK,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC,GAAG,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC,GAAG,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;YACnE,CAAC;SACF,CAAC,CAAC;QAEH,OAAO;YACL,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,GAAG,CAAC,EAAE,CAAC,CAAC,EAAE,IAAI,CAAC;YACxC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,GAAG,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC;YACvC,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,CAAC,EAAE,KAAK,CAAC;YACzC,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,EAAE,KAAK,CAAC;SACzC,CAAC;IACJ,CAAC;IAEO,KAAK,CAAC,CAAe;QAC3B,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,qBAAqB,EAAE,CAAC;QAE3D,OAAO,CAAC,CAAC,CAAC,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;IACvD,CAAC;IAEO,IAAI,CAAC,CAAe,EAAE,IAAsB;QAClD,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;QAEtD,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,MAAM;YAAE,OAAO;QAEtC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAE5B,wCAAwC;QACxC,CAAC,CAAC,eAAe,EAAE,CAAC;QACpB,CAAC,CAAC,cAAc,EAAE,CAAC;QACnB,IAAI,CAAC,iBAAiB,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QACpC,6EAA6E;QAC7E,IAAI,CAAC,IAAI,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;IAC7F,CAAC;IAEO,IAAI,CAAC,CAAe;QAC1B,IAAI,CAAC,IAAI,CAAC,IAAI;YAAE,OAAO;QACvB,uFAAuF;QACvF,IAAI,CAAC,CAAC,OAAO,KAAK,CAAC,EAAE,CAAC;YACpB,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;YAEX,OAAO;QACT,CAAC;QACD,CAAC,CAAC,eAAe,EAAE,CAAC;QAEpB,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC;QAClD,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAEzB,IAAI,QAAQ,IAAI,MAAM,EAAE,CAAC;YACvB,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;YAEvC,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI;gBAAE,OAAO;YAE7B,qEAAqE;YACrE,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,GAAG,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YAE9D,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;YAEpD,OAAO;QACT,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAElF,IAAI,MAAM,KAAK,SAAS;YAAE,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAC3E,CAAC;IAED,2GAA2G;IACnG,OAAO,CAAC,MAAkB,EAAE,MAAiC,EAAE,CAAC,EAAE,EAAE,EAAE,CAAQ;QACpF,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GAAG,MAAM,CAAC,EAAE,CAAC;QAC5B,MAAM,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC;QAClC,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;QAC5C,mFAAmF;QACnF,MAAM,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC;QAEzD,IAAI,CAAC,IAAI,IAAI,CAAC,EAAE;YAAE,OAAO,SAAS,CAAC;QAEnC,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QACpD,MAAM,OAAO,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;QAElC,OAAO,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;IACpE,CAAC;IAEO,EAAE,CAAC,CAAe;QACxB,IAAI,CAAC,IAAI,CAAC,IAAI;YAAE,OAAO;QACvB,CAAC,CAAC,eAAe,EAAE,CAAC;QACpB,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC,CAAC,SAAS,CAAC;YAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QACrG,IAAI,CAAC,IAAI,GAAG,SAAS,CAAC;IACxB,CAAC;CACF","sourcesContent":["/**\n * The clipping volume (`GeoMap.setClipVolume`): given to the engine, and its handles over the map, an outline of its\n * edges and discs to size it (on a box's faces, a cylinder's rim, a polygon's vertices, its top and bottom) and one at\n * its middle to move it, placed after every frame.\n */\n\nimport { rgb } from '../settings.ts';\nimport type { ClipVolume, LonLat, Point } from '../types.ts';\nimport type { Positioned } from '../ui/overlay.ts';\nimport type { Engine } from '../wasm/isard_webgpu.js';\n\n/** The faces' color by default: plaster, as a section on a plan */\nconst SECTION = '#d9cfc1';\n/** Metres a side, a radius or a height keeps at least */\nconst SMALLEST = 0.2;\n/** The vertices a polygon keeps at most (the engine's) */\nconst POLYGON = 16;\n/** Segments of a cylinder's outline */\nconst ROUND = 48;\nconst SVG = 'http://www.w3.org/2000/svg';\nconst SHAPES = { box: 0, cylinder: 1, polygon: 2 } as const;\n\n/** Metres east, north and up of a volume's foot's center */\ntype Local = [east: number, north: number, up: number];\n\n/** A volume's foot's center: a box's or a cylinder's position, a polygon's vertices' mean */\nconst originOf = (volume: ClipVolume): LonLat => {\n  if (volume.shape !== 'polygon') return volume.position;\n\n  const n = Math.max(1, volume.polygon.length);\n  const [lon, lat] = volume.polygon.reduce(([a, b], [x, y]) => [a + x, b + y], [0, 0]);\n\n  return [lon / n, lat / n];\n};\n\n/** Metres east and north of `origin` to degrees, and back, on a body of `radius` metres */\nconst metric = (origin: LonLat, radius: number) => {\n  const degrees = 180 / Math.PI;\n  const across = radius * Math.cos(origin[1] / degrees);\n\n  return {\n    lonLat: (east: number, north: number): LonLat => [\n      origin[0] + (east / across) * degrees,\n      origin[1] + (north / radius) * degrees,\n    ],\n    local: ([lon, lat]: LonLat): [number, number] => [\n      ((lon - origin[0]) / degrees) * across,\n      ((lat - origin[1]) / degrees) * radius,\n    ],\n  };\n};\n\n/** A volume's metres across and along (a cylinder's diameter) and its heading, for the engine */\nconst footprintOf = (volume: ClipVolume): [number, number, number] => {\n  if (volume.shape === 'box') return [volume.width, volume.length, volume.heading ?? 0];\n  if (volume.shape === 'cylinder') return [volume.radius * 2, volume.radius * 2, 0];\n\n  return [0, 0, 0];\n};\n\n/** Sets the volume in the engine, or clears it without one; `radius` the body's (metres to degrees) */\nexport const applyClipVolume = (engine: Engine, volume: ClipVolume | undefined, radius: number): void => {\n  if (!volume) {\n    engine.clearClipVolume();\n\n    return;\n  }\n\n  const origin = originOf(volume);\n  const { local } = metric(origin, radius);\n  const section = volume.sectionColor === null ? [] : rgb(volume.sectionColor ?? SECTION);\n  const [width, length, heading] = footprintOf(volume);\n  const polygon = volume.shape === 'polygon' ? volume.polygon.slice(0, POLYGON).flatMap((v) => local(v)) : [];\n\n  engine.setClipVolume(\n    new Float64Array([\n      origin[0],\n      origin[1],\n      volume.altitude ?? 0,\n      width,\n      length,\n      volume.height,\n      heading,\n      volume.cut === 'outside' ? 0 : 1,\n      volume.altitudeReference === 'sea' ? 0 : 1,\n      SHAPES[volume.shape],\n    ]),\n    new Float64Array(polygon),\n    new Float32Array(section),\n  );\n};\n\n/** What the handles need from the map */\nexport interface ClipVolumeHost {\n  project(lonLat: LonLat, height?: number): Point | undefined;\n  unproject(point: Point): LonLat | undefined;\n  elevationAt(lonLat: LonLat): number | undefined;\n  getCanvas(): HTMLCanvasElement;\n  /** The volume changed by a handle: set, and told */\n  moved(volume: ClipVolume): void;\n}\n\n/**\n * A handle: where it stands, and how a drag changes the volume. `along`: dragged along a direction (metres east, north\n * and up a metre), the volume changed by the metres dragged that way; `ground`: dragged on the ground, the volume\n * changed by the metres east and north the ground under the pointer moved\n */\ntype Handle = { at: Local; move?: true } & (\n  | { along: Local; resize: (volume: ClipVolume, metres: number) => ClipVolume }\n  | { ground: (volume: ClipVolume, east: number, north: number) => ClipVolume }\n);\n\n/** The volume's foot and top moved: `top` the top face, else the bottom one, `metres` outward */\nconst heightened = (volume: ClipVolume, top: boolean, metres: number): ClipVolume => {\n  const height = Math.max(SMALLEST, volume.height + metres);\n\n  return top\n    ? { ...volume, height }\n    : { ...volume, height, altitude: (volume.altitude ?? 0) - (height - volume.height) };\n};\n\n/** The volume moved `east` and `north` metres */\nconst moved = (volume: ClipVolume, east: number, north: number, radius: number): ClipVolume => {\n  if (volume.shape === 'polygon') {\n    return {\n      ...volume,\n      polygon: volume.polygon.map((v) => {\n        const { local, lonLat } = metric(v, radius);\n        const [e, n] = local(v);\n\n        return lonLat(e + east, n + north);\n      }),\n    };\n  }\n\n  return { ...volume, position: metric(volume.position, radius).lonLat(east, north) };\n};\n\n/** The handles of a volume, over the map */\nexport class ClipVolumeHandles implements Positioned {\n  /** Over the canvas, its drawing within */\n  readonly element: HTMLDivElement;\n  private readonly svg: SVGSVGElement;\n  private lines: SVGLineElement[] = [];\n  private discs: SVGCircleElement[] = [];\n  /** The handles drawn, as the discs are */\n  private handles: Handle[] = [];\n  /** The handle held (its disc), the pointer and the volume where it was pressed, the ground grabbed */\n  private held:\n    | { handle: Handle; disc: SVGCircleElement; start: Point; volume: ClipVolume; grab: LonLat | undefined }\n    | undefined;\n\n  constructor(\n    private readonly host: ClipVolumeHost,\n    private volume: ClipVolume,\n    /** Metres of the body's radius (metres to degrees) */\n    private readonly radius: number,\n  ) {\n    this.svg = document.createElementNS(SVG, 'svg');\n    this.element = document.createElement('div');\n    this.element.className = 'isard-clipvolume';\n    this.element.append(this.svg);\n  }\n\n  /** The volume the handles follow from the next placing (`position`, after each frame) */\n  set(volume: ClipVolume): void {\n    this.volume = volume;\n  }\n\n  position(): void {\n    const segments = this.outline(this.volume);\n\n    this.handles = this.handlesOf(this.volume);\n    this.lines = this.resized(this.lines, segments.length, () => document.createElementNS(SVG, 'line'), true);\n    this.discs = this.resized(this.discs, this.handles.length, () => this.disc(), false);\n    segments.forEach(([a, b], i) => {\n      const [p, q] = [this.screen(a), this.screen(b)];\n      const line = this.lines[i];\n\n      if (!line) return;\n      line.style.display = p && q ? '' : 'none';\n      if (!p || !q) return;\n      line.setAttribute('x1', String(p[0]));\n      line.setAttribute('y1', String(p[1]));\n      line.setAttribute('x2', String(q[0]));\n      line.setAttribute('y2', String(q[1]));\n    });\n    this.handles.forEach((handle, i) => {\n      const p = this.screen(handle.at);\n      const disc = this.discs[i];\n\n      if (!disc) return;\n      disc.setAttribute('r', handle.move ? '8' : '6');\n      disc.setAttribute('class', handle.move ? 'isard-clipvolume-move' : 'isard-clipvolume-size');\n      disc.style.display = p ? '' : 'none';\n      if (!p) return;\n      disc.setAttribute('cx', String(p[0]));\n      disc.setAttribute('cy', String(p[1]));\n    });\n  }\n\n  /** `elements` grown or cut to `count`, those made put `under` the others (the lines under the discs) or over them */\n  private resized<T extends SVGElement>(elements: T[], count: number, make: () => T, under: boolean): T[] {\n    elements.slice(count).forEach((e) => {\n      e.remove();\n    });\n\n    const kept = elements.slice(0, count);\n    const made = Array.from({ length: count - kept.length }, make);\n\n    made.forEach((e) => {\n      if (under) this.svg.prepend(e);\n      else this.svg.append(e);\n    });\n\n    return [...kept, ...made];\n  }\n\n  private disc(): SVGCircleElement {\n    const disc = document.createElementNS(SVG, 'circle');\n\n    disc.addEventListener('pointerdown', (e) => this.down(e, disc));\n    disc.addEventListener('pointermove', (e) => this.move(e));\n    disc.addEventListener('pointerup', (e) => this.up(e));\n    disc.addEventListener('pointercancel', (e) => this.up(e));\n    // Safari may let the capture go: the release would then reach the map, not the disc\n    disc.addEventListener('lostpointercapture', (e) => this.up(e));\n\n    return disc;\n  }\n\n  /** A point of the volume on the screen */\n  private screen([east, north, up]: Local, volume = this.volume): Point | undefined {\n    const origin = originOf(volume);\n    const lonLat = metric(origin, this.radius).lonLat(east, north);\n    // `project` measures from the relief: an altitude above the ellipsoid less the relief under the volume\n    const ground = volume.altitudeReference === 'sea' ? (this.host.elevationAt(origin) ?? 0) : 0;\n\n    return this.host.project(lonLat, (volume.altitude ?? 0) - ground + up);\n  }\n\n  /** The volume's foot outline (metres east and north of its center), closed by its first point */\n  private foot(volume: ClipVolume): [number, number][] {\n    if (volume.shape === 'cylinder') {\n      return Array.from({ length: ROUND }, (_, k) => {\n        const a = (2 * Math.PI * k) / ROUND;\n\n        return [volume.radius * Math.cos(a), volume.radius * Math.sin(a)];\n      });\n    }\n    if (volume.shape === 'polygon') {\n      const { local } = metric(originOf(volume), this.radius);\n\n      return volume.polygon.map((v) => local(v));\n    }\n\n    const heading = ((volume.heading ?? 0) * Math.PI) / 180;\n    const [sin, cos] = [Math.sin(heading), Math.cos(heading)];\n    const [w, l] = [volume.width / 2, volume.length / 2];\n\n    return [\n      [-w, -l],\n      [w, -l],\n      [w, l],\n      [-w, l],\n    ].map(([a, b]) => [(a ?? 0) * cos + (b ?? 0) * sin, (b ?? 0) * cos - (a ?? 0) * sin]);\n  }\n\n  /** The edges: the foot's and the top's outlines, and the uprights at their corners (four of a cylinder's) */\n  private outline(volume: ClipVolume): [Local, Local][] {\n    const foot = this.foot(volume);\n    const h = volume.height;\n    const ring = (up: number) =>\n      foot.map(([e, n], k): [Local, Local] => {\n        const [e2, n2] = foot[(k + 1) % foot.length] ?? [e, n];\n\n        return [\n          [e, n, up],\n          [e2, n2, up],\n        ];\n      });\n    const uprights = (volume.shape === 'cylinder' ? foot.filter((_, k) => k % (ROUND / 4) === 0) : foot).map(\n      ([e, n]): [Local, Local] => [\n        [e, n, 0],\n        [e, n, h],\n      ],\n    );\n\n    return [...ring(0), ...ring(h), ...uprights];\n  }\n\n  /** The handles of a volume: its sides', its top's and bottom's, the one that moves it */\n  private handlesOf(volume: ClipVolume): Handle[] {\n    const h = volume.height;\n    const vertical: Handle[] = [\n      { at: [0, 0, h], along: [0, 0, 1], resize: (v, m) => heightened(v, true, m) },\n      { at: [0, 0, 0], along: [0, 0, -1], resize: (v, m) => heightened(v, false, m) },\n    ];\n    const move: Handle = {\n      at: [0, 0, h / 2],\n      move: true,\n      ground: (v, east, north) => moved(v, east, north, this.radius),\n    };\n\n    return [...this.sides(volume), ...vertical, move];\n  }\n\n  /** The handles on a volume's sides: a box's four faces, a cylinder's rim, a polygon's vertices */\n  private sides(volume: ClipVolume): Handle[] {\n    const h = volume.height / 2;\n\n    if (volume.shape === 'cylinder') {\n      return [\n        {\n          at: [volume.radius, 0, h],\n          along: [1, 0, 0],\n          resize: (v, m) => (v.shape === 'cylinder' ? { ...v, radius: Math.max(SMALLEST, v.radius + m) } : v),\n        },\n      ];\n    }\n    if (volume.shape === 'polygon') {\n      const { local } = metric(originOf(volume), this.radius);\n      const shifted = (vertex: LonLat, east: number, north: number) => metric(vertex, this.radius).lonLat(east, north);\n\n      return volume.polygon.map((vertex, k) => {\n        const [e, n] = local(vertex);\n\n        return {\n          at: [e, n, 0],\n          ground: (v, east, north) =>\n            v.shape === 'polygon'\n              ? { ...v, polygon: v.polygon.map((p, i) => (i === k ? shifted(p, east, north) : p)) }\n              : v,\n        };\n      });\n    }\n\n    const heading = ((volume.heading ?? 0) * Math.PI) / 180;\n    const [sin, cos] = [Math.sin(heading), Math.cos(heading)];\n    // Across and along its heading, east and north\n    const across: [number, number] = [cos, -sin];\n    const along: [number, number] = [sin, cos];\n    const face = (axis: [number, number], half: number, side: -1 | 1, width: boolean): Handle => ({\n      at: [axis[0] * half * side, axis[1] * half * side, h],\n      along: [axis[0] * side, axis[1] * side, 0],\n      resize: (v, m) => {\n        if (v.shape !== 'box') return v;\n\n        const size = Math.max(SMALLEST, (width ? v.width : v.length) + m);\n        const shift = (side * (size - (width ? v.width : v.length))) / 2;\n        const box = width ? { ...v, width: size } : { ...v, length: size };\n\n        // The center half-way along the move, on the side of the face moved: the opposite face where it was\n        return moved(box, axis[0] * shift, axis[1] * shift, this.radius);\n      },\n    });\n\n    return [\n      face(across, volume.width / 2, -1, true),\n      face(across, volume.width / 2, 1, true),\n      face(along, volume.length / 2, -1, false),\n      face(along, volume.length / 2, 1, false),\n    ];\n  }\n\n  private local(e: PointerEvent): Point {\n    const rect = this.host.getCanvas().getBoundingClientRect();\n\n    return [e.clientX - rect.left, e.clientY - rect.top];\n  }\n\n  private down(e: PointerEvent, disc: SVGCircleElement): void {\n    const handle = this.handles[this.discs.indexOf(disc)];\n\n    if (e.button !== 0 || !handle) return;\n\n    const start = this.local(e);\n\n    // The map must not pan under the handle\n    e.stopPropagation();\n    e.preventDefault();\n    disc.setPointerCapture(e.pointerId);\n    // The spot of the ground grabbed, kept under the pointer as the volume moves\n    this.held = { handle, disc, start, volume: this.volume, grab: this.host.unproject(start) };\n  }\n\n  private move(e: PointerEvent): void {\n    if (!this.held) return;\n    // No button held any more: its release was missed (the capture lost), the drag is over\n    if (e.buttons === 0) {\n      this.up(e);\n\n      return;\n    }\n    e.stopPropagation();\n\n    const { handle, start, volume, grab } = this.held;\n    const at = this.local(e);\n\n    if ('ground' in handle) {\n      const lonLat = this.host.unproject(at);\n\n      if (!lonLat || !grab) return;\n\n      // As far as the ground under the pointer moved from the spot grabbed\n      const [east, north] = metric(grab, this.radius).local(lonLat);\n\n      this.host.moved(handle.ground(volume, east, north));\n\n      return;\n    }\n\n    const metres = this.dragged(volume, handle, [at[0] - start[0], at[1] - start[1]]);\n\n    if (metres !== undefined) this.host.moved(handle.resize(volume, metres));\n  }\n\n  /** Metres the pointer dragged a handle along its direction: the drag along that direction on the screen */\n  private dragged(volume: ClipVolume, handle: Handle & { along: Local }, [dx, dy]: Point): number | undefined {\n    const [e, n, u] = handle.at;\n    const [de, dn, du] = handle.along;\n    const from = this.screen(handle.at, volume);\n    // Where the handle goes a metre that way, on the screen: pixels per metre along it\n    const to = this.screen([e + de, n + dn, u + du], volume);\n\n    if (!from || !to) return undefined;\n\n    const [ax, ay] = [to[0] - from[0], to[1] - from[1]];\n    const squared = ax * ax + ay * ay;\n\n    return squared > 1e-6 ? (dx * ax + dy * ay) / squared : undefined;\n  }\n\n  private up(e: PointerEvent): void {\n    if (!this.held) return;\n    e.stopPropagation();\n    if (this.held.disc.hasPointerCapture(e.pointerId)) this.held.disc.releasePointerCapture(e.pointerId);\n    this.held = undefined;\n  }\n}\n"]}

package/dist/map/events.js

@@ -14,7 +14,7 @@ export class MapListeners {
         quality: new Set(),
         idle: new Set(),
         leave: new Set(),
-        clipbox: new Set(),
+        clipvolume: new Set(),
     };
     /** Listens to an event; returns the function that stops listening */
     on(type, listener) {

package/dist/map/events.js.map

@@ -1 +1 @@
-{"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/map/events.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAG9E,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAIrC,iDAAiD;AACjD,MAAM,OAAO,YAAY;IACN,SAAS,GAAc;QACtC,SAAS,EAAE,IAAI,GAAG,EAAE;QACpB,IAAI,EAAE,IAAI,GAAG,EAAE;QACf,OAAO,EAAE,IAAI,GAAG,EAAE;QAClB,MAAM,EAAE,IAAI,GAAG,EAAE;QACjB,KAAK,EAAE,IAAI,GAAG,EAAE;QAChB,YAAY,EAAE,IAAI,GAAG,EAAE;QACvB,KAAK,EAAE,IAAI,GAAG,EAAE;QAChB,MAAM,EAAE,IAAI,GAAG,EAAE;QACjB,OAAO,EAAE,IAAI,GAAG,EAAE;QAClB,IAAI,EAAE,IAAI,GAAG,EAAE;QACf,KAAK,EAAE,IAAI,GAAG,EAAE;QAChB,OAAO,EAAE,IAAI,GAAG,EAAE;KACnB,CAAC;IAEF,qEAAqE;IACrE,EAAE,CAA4B,IAAO,EAAE,QAAuC;QAC5E,MAAM,SAAS,GAAuC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QAE3E,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAExB,OAAO,GAAG,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC1C,CAAC;IAED,kGAAkG;IAClG,IAAI,CAA4B,IAAO,EAAE,KAAmB;QAC1D,MAAM,SAAS,GAAuC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QAE3E,SAAS,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,EAAE;YAC7B,IAAI,CAAC;gBACH,QAAQ,CAAC,KAAK,CAAC,CAAC;YAClB,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,CAAC,KAAK,CAAC,CAAC;YAChB,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAED,kCAAkC;IAClC,GAAG,CAAC,IAAqB;QACvB,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC;IACvC,CAAC;IAED,6BAA6B;IAC7B,KAAK;QACH,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,CAAC,SAAS,EAAE,EAAE;YAClD,SAAS,CAAC,KAAK,EAAE,CAAC;QACpB,CAAC,CAAC,CAAC;IACL,CAAC;CACF","sourcesContent":["/** The listeners of the map's events: added, called, cleared with the map. */\n\nimport type { MapEvents } from '../types.ts';\nimport { report } from './checks.ts';\n\ntype Listeners = { [K in keyof MapEvents]: Set<(event: MapEvents[K]) => void> };\n\n/** The listeners of the map's events, by type */\nexport class MapListeners {\n  private readonly listeners: Listeners = {\n    movestart: new Set(),\n    move: new Set(),\n    moveend: new Set(),\n    resize: new Set(),\n    hover: new Set(),\n    hoverfeature: new Set(),\n    click: new Set(),\n    render: new Set(),\n    quality: new Set(),\n    idle: new Set(),\n    leave: new Set(),\n    clipbox: new Set(),\n  };\n\n  /** Listens to an event; returns the function that stops listening */\n  on<K extends keyof MapEvents>(type: K, listener: (event: MapEvents[K]) => void): () => void {\n    const listeners: Set<(event: MapEvents[K]) => void> = this.listeners[type];\n\n    listeners.add(listener);\n\n    return () => listeners.delete(listener);\n  }\n\n  /** Calls the listeners; one that throws is reported and does not stop the others nor the frame */\n  emit<K extends keyof MapEvents>(type: K, event: MapEvents[K]): void {\n    const listeners: Set<(event: MapEvents[K]) => void> = this.listeners[type];\n\n    listeners.forEach((listener) => {\n      try {\n        listener(event);\n      } catch (error) {\n        report(error);\n      }\n    });\n  }\n\n  /** Something listens to `type` */\n  has(type: keyof MapEvents): boolean {\n    return this.listeners[type].size > 0;\n  }\n\n  /** Forgets every listener */\n  clear(): void {\n    Object.values(this.listeners).forEach((listeners) => {\n      listeners.clear();\n    });\n  }\n}\n"]}
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/map/events.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAG9E,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAIrC,iDAAiD;AACjD,MAAM,OAAO,YAAY;IACN,SAAS,GAAc;QACtC,SAAS,EAAE,IAAI,GAAG,EAAE;QACpB,IAAI,EAAE,IAAI,GAAG,EAAE;QACf,OAAO,EAAE,IAAI,GAAG,EAAE;QAClB,MAAM,EAAE,IAAI,GAAG,EAAE;QACjB,KAAK,EAAE,IAAI,GAAG,EAAE;QAChB,YAAY,EAAE,IAAI,GAAG,EAAE;QACvB,KAAK,EAAE,IAAI,GAAG,EAAE;QAChB,MAAM,EAAE,IAAI,GAAG,EAAE;QACjB,OAAO,EAAE,IAAI,GAAG,EAAE;QAClB,IAAI,EAAE,IAAI,GAAG,EAAE;QACf,KAAK,EAAE,IAAI,GAAG,EAAE;QAChB,UAAU,EAAE,IAAI,GAAG,EAAE;KACtB,CAAC;IAEF,qEAAqE;IACrE,EAAE,CAA4B,IAAO,EAAE,QAAuC;QAC5E,MAAM,SAAS,GAAuC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QAE3E,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAExB,OAAO,GAAG,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC1C,CAAC;IAED,kGAAkG;IAClG,IAAI,CAA4B,IAAO,EAAE,KAAmB;QAC1D,MAAM,SAAS,GAAuC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QAE3E,SAAS,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,EAAE;YAC7B,IAAI,CAAC;gBACH,QAAQ,CAAC,KAAK,CAAC,CAAC;YAClB,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,CAAC,KAAK,CAAC,CAAC;YAChB,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAED,kCAAkC;IAClC,GAAG,CAAC,IAAqB;QACvB,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC;IACvC,CAAC;IAED,6BAA6B;IAC7B,KAAK;QACH,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,CAAC,SAAS,EAAE,EAAE;YAClD,SAAS,CAAC,KAAK,EAAE,CAAC;QACpB,CAAC,CAAC,CAAC;IACL,CAAC;CACF","sourcesContent":["/** The listeners of the map's events: added, called, cleared with the map. */\n\nimport type { MapEvents } from '../types.ts';\nimport { report } from './checks.ts';\n\ntype Listeners = { [K in keyof MapEvents]: Set<(event: MapEvents[K]) => void> };\n\n/** The listeners of the map's events, by type */\nexport class MapListeners {\n  private readonly listeners: Listeners = {\n    movestart: new Set(),\n    move: new Set(),\n    moveend: new Set(),\n    resize: new Set(),\n    hover: new Set(),\n    hoverfeature: new Set(),\n    click: new Set(),\n    render: new Set(),\n    quality: new Set(),\n    idle: new Set(),\n    leave: new Set(),\n    clipvolume: new Set(),\n  };\n\n  /** Listens to an event; returns the function that stops listening */\n  on<K extends keyof MapEvents>(type: K, listener: (event: MapEvents[K]) => void): () => void {\n    const listeners: Set<(event: MapEvents[K]) => void> = this.listeners[type];\n\n    listeners.add(listener);\n\n    return () => listeners.delete(listener);\n  }\n\n  /** Calls the listeners; one that throws is reported and does not stop the others nor the frame */\n  emit<K extends keyof MapEvents>(type: K, event: MapEvents[K]): void {\n    const listeners: Set<(event: MapEvents[K]) => void> = this.listeners[type];\n\n    listeners.forEach((listener) => {\n      try {\n        listener(event);\n      } catch (error) {\n        report(error);\n      }\n    });\n  }\n\n  /** Something listens to `type` */\n  has(type: keyof MapEvents): boolean {\n    return this.listeners[type].size > 0;\n  }\n\n  /** Forgets every listener */\n  clear(): void {\n    Object.values(this.listeners).forEach((listeners) => {\n      listeners.clear();\n    });\n  }\n}\n"]}