@sakaniui/react 0.10.2 → 0.11.0

package/dist/manifest.json

@@ -1,7 +1,7 @@
 {
   "schemaVersion": 6,
   "name": "@sakaniui/react",
-  "version": "0.10.2",
+  "version": "0.11.0",
   "description": "Machine-readable contract of the SakaniUI React library, generated from its TypeScript source.",
   "docs": "https://www.sakaniui.com",
   "guide": "https://www.sakaniui.com/llms-full.txt",
@@ -24,7 +24,7 @@
     "@sakaniui/react/emoji": "Fluent Emoji (full colour): EmojiName, one module each (1594 emoji, 311 with skin tones)."
   },
   "conventions": {
-    "version": "This manifest describes @sakaniui/react@0.10.2. Each component has `since`, the first release that contained it; a prop added later has its own `since`, and a value added later is listed in the prop's `valuesSince`. If the project has an older version installed, anything newer than that does not exist there.",
+    "version": "This manifest describes @sakaniui/react@0.11.0. Each component has `since`, the first release that contained it; a prop added later has its own `since`, and a value added later is listed in the prop's `valuesSince`. If the project has an older version installed, anything newer than that does not exist there.",
     "acceptsNativeProps": "Components forward native HTML attributes (className, style, aria-*, event handlers) to their root element unless a prop says otherwise; only the props that are specific to SakaniUI are listed here.",
     "accessibleName": "When `contract.requiresAccessibleName` is true, a required prop (aria-label, aria-labelledby or an alt text) is the only thing that names the control or image. Do not omit it.",
     "tokens": "Use only the token names listed under `tokens`. Colour tokens follow the theme (the `.dark` class flips them); do not hard-code colours.",
@@ -459,9 +459,9 @@
     }
   },
   "counts": {
-    "components": 127,
+    "components": 134,
     "blocks": 42,
-    "utilities": 7
+    "utilities": 8
   },
   "components": [
     {
@@ -4015,6 +4015,1585 @@
       "since": "0.3.0",
       "example": "import { LocationDot } from '@sakaniui/react';\n\n<LocationDot location=\"Location\" />"
     },
+    {
+      "name": "Map",
+      "kind": "component",
+      "category": "Composite",
+      "import": "@sakaniui/react",
+      "summary": "Interactive tile map with pan, zoom and controls. Place MapMarker and MapPopup children by [latitude, longitude]; `tileUrl` swaps the tile provider (OpenStreetMap by default).",
+      "props": [
+        {
+          "name": "center",
+          "type": "LatLng",
+          "required": false,
+          "default": "[51.505, -0.09]",
+          "description": "Where the map starts, as [latitude, longitude]. Changing it later flies the map there.",
+          "shape": {
+            "type": "LatLng",
+            "collection": "object",
+            "fields": [
+              {
+                "name": "0",
+                "type": "number",
+                "required": true
+              },
+              {
+                "name": "1",
+                "type": "number",
+                "required": true
+              },
+              {
+                "name": "length",
+                "type": "2",
+                "required": true
+              },
+              {
+                "name": "toString",
+                "type": "() => string",
+                "required": true,
+                "description": "Returns a string representation of an array."
+              },
+              {
+                "name": "toLocaleString",
+                "type": "{ (): string; (locales: string | string[], options?: (NumberFormatOptions & DateTimeFormatOptions) | undefined): string; }",
+                "required": true,
+                "description": "Returns a string representation of an array. The elements are converted to string using their toLocaleString methods."
+              },
+              {
+                "name": "pop",
+                "type": "() => number",
+                "required": true,
+                "description": "Removes the last element from an array and returns it. If the array is empty, undefined is returned and the array is not modified."
+              },
+              {
+                "name": "push",
+                "type": "(...items: number[]) => number",
+                "required": true,
+                "description": "Appends new elements to the end of an array, and returns the new length of the array."
+              },
+              {
+                "name": "concat",
+                "type": "{ (...items: ConcatArray<number>[]): number[]; (...items: (number | ConcatArray<number>)[]): number[]; }",
+                "required": true,
+                "description": "Combines two or more arrays. This method returns a new array without modifying any existing arrays."
+              },
+              {
+                "name": "join",
+                "type": "(separator?: string | undefined) => string",
+                "required": true,
+                "description": "Adds all the elements of an array into a string, separated by the specified separator string."
+              },
+              {
+                "name": "reverse",
+                "type": "() => number[]",
+                "required": true,
+                "description": "Reverses the elements in an array in place. This method mutates the array and returns a reference to the same array."
+              },
+              {
+                "name": "shift",
+                "type": "() => number",
+                "required": true,
+                "description": "Removes the first element from an array and returns it. If the array is empty, undefined is returned and the array is not modified."
+              },
+              {
+                "name": "slice",
+                "type": "(start?: number | undefined, end?: number | undefined) => number[]",
+                "required": true,
+                "description": "Returns a copy of a section of an array. For both start and end, a negative index can be used to indicate an offset from the end of the array. For example, -2 refers to the second to last element of the array."
+              },
+              {
+                "name": "sort",
+                "type": "(compareFn?: ((a: number, b: number) => number) | undefined) => LatLng",
+                "required": true,
+                "description": "Sorts an array in place. This method mutates the array and returns a reference to the same array."
+              },
+              {
+                "name": "splice",
+                "type": "{ (start: number, deleteCount?: number | undefined): number[]; (start: number, deleteCount: number, ...items: number[]): number[]; }",
+                "required": true,
+                "description": "Removes elements from an array and, if necessary, inserts new elements in their place, returning the deleted elements."
+              },
+              {
+                "name": "unshift",
+                "type": "(...items: number[]) => number",
+                "required": true,
+                "description": "Inserts new elements at the start of an array, and returns the new length of the array."
+              },
+              {
+                "name": "indexOf",
+                "type": "(searchElement: number, fromIndex?: number | undefined) => number",
+                "required": true,
+                "description": "Returns the index of the first occurrence of a value in an array, or -1 if it is not present."
+              },
+              {
+                "name": "lastIndexOf",
+                "type": "(searchElement: number, fromIndex?: number | undefined) => number",
+                "required": true,
+                "description": "Returns the index of the last occurrence of a specified value in an array, or -1 if it is not present."
+              },
+              {
+                "name": "every",
+                "type": "{ <S extends number>(predicate: (value: number, index: number, array: number[]) => value is S, thisArg?: any): this is S[]; (predicate: (value: number, index: number, array: number[]) => unknown, thisArg?: any): boolean; }",
+                "required": true,
+                "description": "Determines whether all the members of an array satisfy the specified test."
+              },
+              {
+                "name": "some",
+                "type": "(predicate: (value: number, index: number, array: number[]) => unknown, thisArg?: any) => boolean",
+                "required": true,
+                "description": "Determines whether the specified callback function returns true for any element of an array."
+              },
+              {
+                "name": "forEach",
+                "type": "(callbackfn: (value: number, index: number, array: number[]) => void, thisArg?: any) => void",
+                "required": true,
+                "description": "Performs the specified action for each element in an array."
+              },
+              {
+                "name": "map",
+                "type": "<U>(callbackfn: (value: number, index: number, array: number[]) => U, thisArg?: any) => U[]",
+                "required": true,
+                "description": "Calls a defined callback function on each element of an array, and returns an array that contains the results."
+              },
+              {
+                "name": "filter",
+                "type": "{ <S extends number>(predicate: (value: number, index: number, array: number[]) => value is S, thisArg?: any): S[]; (predicate: (value: number, index: number, array: number[]) => unknown, thisArg?: any): number[]; }",
+                "required": true,
+                "description": "Returns the elements of an array that meet the condition specified in a callback function."
+              },
+              {
+                "name": "reduce",
+                "type": "{ (callbackfn: (previousValue: number, currentValue: number, currentIndex: number, array: number[]) => number): number; (callbackfn: (previousValue: number, currentValue: number, currentIndex: number, array: number[]) => number, initialValue: number): number; <U>(callbackfn: (previousValue: U, currentValue: number, currentIndex: number, array: number[]) => U, initialValue: U): U; }",
+                "required": true,
+                "description": "Calls the specified callback function for all the elements in an array. The return value of the callback function is the accumulated result, and is provided as an argument in the next call to the callback function."
+              },
+              {
+                "name": "reduceRight",
+                "type": "{ (callbackfn: (previousValue: number, currentValue: number, currentIndex: number, array: number[]) => number): number; (callbackfn: (previousValue: number, currentValue: number, currentIndex: number, array: number[]) => number, initialValue: number): number; <U>(callbackfn: (previousValue: U, currentValue: number, currentIndex: number, array: number[]) => U, initialValue: U): U; }",
+                "required": true,
+                "description": "Calls the specified callback function for all the elements in an array, in descending order. The return value of the callback function is the accumulated result, and is provided as an argument in the next call to the callback function."
+              },
+              {
+                "name": "find",
+                "type": "{ <S extends number>(predicate: (value: number, index: number, obj: number[]) => value is S, thisArg?: any): S | undefined; (predicate: (value: number, index: number, obj: number[]) => unknown, thisArg?: any): number | undefined; }",
+                "required": true,
+                "description": "Returns the value of the first element in the array where predicate is true, and undefined otherwise."
+              },
+              {
+                "name": "findIndex",
+                "type": "(predicate: (value: number, index: number, obj: number[]) => unknown, thisArg?: any) => number",
+                "required": true,
+                "description": "Returns the index of the first element in the array where predicate is true, and -1 otherwise."
+              },
+              {
+                "name": "fill",
+                "type": "(value: number, start?: number | undefined, end?: number | undefined) => LatLng",
+                "required": true,
+                "description": "Changes all array elements from `start` to `end` index to a static `value` and returns the modified array"
+              },
+              {
+                "name": "copyWithin",
+                "type": "(target: number, start: number, end?: number | undefined) => LatLng",
+                "required": true,
+                "description": "Returns the this object after copying a section of the array identified by start and end to the same array starting at position target"
+              },
+              {
+                "name": "entries",
+                "type": "() => ArrayIterator<[number, number]>",
+                "required": true,
+                "description": "Returns an iterable of key, value pairs for every entry in the array"
+              },
+              {
+                "name": "keys",
+                "type": "() => ArrayIterator<number>",
+                "required": true,
+                "description": "Returns an iterable of keys in the array"
+              },
+              {
+                "name": "values",
+                "type": "() => ArrayIterator<number>",
+                "required": true,
+                "description": "Returns an iterable of values in the array"
+              },
+              {
+                "name": "includes",
+                "type": "(searchElement: number, fromIndex?: number | undefined) => boolean",
+                "required": true,
+                "description": "Determines whether an array includes a certain element, returning true or false as appropriate."
+              },
+              {
+                "name": "flatMap",
+                "type": "<U, This = undefined>(callback: (this: This, value: number, index: number, array: number[]) => U | readonly U[], thisArg?: This | undefined) => U[]",
+                "required": true,
+                "description": "Calls a defined callback function on each element of an array. Then, flattens the result into a new array. This is identical to a map followed by flat with depth 1."
+              },
+              {
+                "name": "flat",
+                "type": "<A, D extends number = 1>(this: A, depth?: D | undefined) => FlatArray<A, D>[]",
+                "required": true,
+                "description": "Returns a new array with all sub-array elements concatenated into it recursively up to the specified depth."
+              },
+              {
+                "name": "at",
+                "type": "(index: number) => number",
+                "required": true,
+                "description": "Returns the item located at the specified index."
+              },
+              {
+                "name": "__@iterator@12750",
+                "type": "() => ArrayIterator<number>",
+                "required": true,
+                "description": "Iterator"
+              },
+              {
+                "name": "__@unscopables@12780",
+                "type": "{ [x: number]: boolean | undefined; length?: boolean | undefined; toString?: boolean | undefined; toLocaleString?: boolean | undefined; pop?: boolean | undefined; push?: boolean | undefined; concat?: boolean | undefined; join?: boolean | undefined; reverse?: boolean | undefined; shift?: boolean | undefined; slice?: boolean | undefined; sort?: boolean | undefined; splice?: boolean | undefined; unshift?: boolean | undefined; indexOf?: boolean | undefined; lastIndexOf?: boolean | undefined; every?: boolean | undefined; some?: boolean | undefined; forEach?: boolean | undefined; map?: boolean | undefined; filter?: boolean | undefined; reduce?: boolean | undefined; reduceRight?: boolean | undefined; find?: boolean | undefined; findIndex?: boolean | undefined; fill?: boolean | undefined; copyWithin?: boolean | undefined; entries?: boolean | undefined; keys?: boolean | undefined; values?: boolean | undefined; includes?: boolean | undefined; flatMap?: boolean | undefined; flat?: boolean | undefined; at?: boolean | undefined; [Symbol.iterator]?: boolean | undefined; readonly [Symbol.unscopables]?: boolean | undefined; }",
+                "required": true,
+                "description": "Is an object whose properties have the value 'true' when they will be absent when used in a 'with' statement."
+              }
+            ]
+          }
+        },
+        {
+          "name": "zoom",
+          "type": "number",
+          "required": false,
+          "default": 12,
+          "description": "Starting zoom, 0 (whole world) to maxZoom. Changing it later animates to it."
+        },
+        {
+          "name": "minZoom",
+          "type": "number",
+          "required": false,
+          "default": 2
+        },
+        {
+          "name": "maxZoom",
+          "type": "number",
+          "required": false,
+          "default": 18
+        },
+        {
+          "name": "onViewChange",
+          "type": "((view: MapView) => void)",
+          "required": false,
+          "description": "Called whenever the user pans or zooms."
+        },
+        {
+          "name": "tileUrl",
+          "type": "string",
+          "required": false,
+          "default": "https://tile.openstreetmap.org/{z}/{x}/{y}.png",
+          "description": "Tile URL template with {z}, {x} and {y}. Defaults to OpenStreetMap."
+        },
+        {
+          "name": "tileUrlDark",
+          "type": "string",
+          "required": false,
+          "description": "Tiles to use in dark mode, from a provider that has a dark style. Without it the same tiles are darkened with `--map-tile-filter` (flat dark land, blue water, roads darker than the land)."
+        },
+        {
+          "name": "theme",
+          "type": "\"auto\" | \"dark\"",
+          "required": false,
+          "values": [
+            "auto",
+            "dark"
+          ],
+          "default": "auto",
+          "description": "\"auto\" follows the surrounding theme (a `.dark` class on <html> or any ancestor)."
+        },
+        {
+          "name": "attribution",
+          "type": "ReactNode",
+          "required": false,
+          "description": "Attribution text required by the tile provider. Pass null to hide it (only if your provider allows)."
+        },
+        {
+          "name": "controls",
+          "type": "boolean",
+          "required": false,
+          "default": true,
+          "description": "Show the zoom controls. Defaults to true."
+        },
+        {
+          "name": "locate",
+          "type": "boolean",
+          "required": false,
+          "default": false,
+          "description": "Show the locate button (uses the browser's geolocation). Defaults to false."
+        },
+        {
+          "name": "onLocate",
+          "type": "((position: LatLng) => void)",
+          "required": false,
+          "description": "Called with the user's position after the locate button finds it."
+        },
+        {
+          "name": "onLocateError",
+          "type": "((error: GeolocationPositionError | Error) => void)",
+          "required": false,
+          "description": "Called when the locate button cannot find the user (permission denied, no signal, no support)."
+        },
+        {
+          "name": "height",
+          "type": "string | number",
+          "required": false,
+          "default": 400,
+          "description": "Height in px or any CSS length. Defaults to 400."
+        },
+        {
+          "name": "aria-label",
+          "type": "string",
+          "required": false,
+          "default": "Map",
+          "description": "Accessible name for the map region. Defaults to \"Map\"."
+        },
+        {
+          "name": "className",
+          "type": "string",
+          "required": false
+        },
+        {
+          "name": "children",
+          "type": "ReactNode",
+          "required": false,
+          "description": "MapMarker and MapPopup elements."
+        }
+      ],
+      "contract": {
+        "requiredProps": [],
+        "requiresAccessibleName": false
+      },
+      "since": "0.11.0",
+      "example": "import { Map } from '@sakaniui/react';\n\n<Map />",
+      "recipes": [
+        {
+          "title": "A live feed: markers that slide to each new position",
+          "description": "Keep the positions in state, update them when the feed (WebSocket, server-sent events, polling) delivers, and give each MapMarker `glide` of about the interval between updates so it slides instead of jumping. A MapPopup that points at a moving marker needs the same `glide`.",
+          "code": "import React from 'react';\nimport { Map, MapMarker, type LatLng } from '@sakaniui/react';\n\nexport const Example = () => {\n  const [vehicles, setVehicles] = React.useState<{ id: string; position: LatLng }[]>([{ id: 'v1', position: [51.5, -0.09] }]);\n  React.useEffect(() => {\n    const socket = new WebSocket('wss://example.com/vehicles');\n    socket.onmessage = (e) => setVehicles(JSON.parse(e.data));\n    return () => socket.close();\n  }, []);\n  return (\n    <Map center={[51.5, -0.09]} zoom={13} height={420}>\n      {vehicles.map((v) => (\n        <MapMarker key={v.id} variant=\"dot\" position={v.position} glide={1900} label={v.id} />\n      ))}\n    </Map>\n  );\n};"
+        },
+        {
+          "title": "Thousands of places: cluster them",
+          "description": "Put the places in a MapClusterLayer instead of mapping them to MapMarkers yourself. Nearby places become a counted cluster that zooms in on click, and only what is in view is rendered. Key each marker returned from `renderPoint` by the point id.",
+          "code": "import { Map, MapMarker, MapClusterLayer, type LatLng } from '@sakaniui/react';\n\nconst points: { id: number; position: LatLng }[] = [\n  { id: 1, position: [51.5, -0.12] },\n  { id: 2, position: [53.48, -2.24] },\n];\n\nexport const Example = () => (\n  <Map center={[53, -1.8]} zoom={6} height={420}>\n    <MapClusterLayer\n      points={points}\n      renderPoint={(p) => <MapMarker key={p.id} variant=\"dot\" position={p.position} label={`Place ${p.id}`} />}\n    />\n  </Map>\n);"
+        }
+      ],
+      "aliases": [
+        "map view",
+        "interactive map",
+        "street map",
+        "location map",
+        "leaflet",
+        "mapbox",
+        "google map",
+        "google maps",
+        "slippy map",
+        "tile map"
+      ]
+    },
+    {
+      "name": "MapClusterLayer",
+      "kind": "component",
+      "category": "Composite",
+      "import": "@sakaniui/react",
+      "summary": "Draws thousands of places on a Map by grouping nearby ones into counted cluster markers (click to zoom in) and rendering only what is in view. `renderPoint` draws each single place.",
+      "props": [
+        {
+          "name": "points",
+          "type": "T[]",
+          "required": true,
+          "shape": {
+            "type": "MapClusterPoint",
+            "collection": "array",
+            "fields": [
+              {
+                "name": "id",
+                "type": "string | number",
+                "required": true
+              },
+              {
+                "name": "position",
+                "type": "LatLng",
+                "required": true
+              }
+            ]
+          }
+        },
+        {
+          "name": "renderPoint",
+          "type": "(point: T) => ReactNode",
+          "required": true,
+          "description": "Draws one place that is not clustered, usually a <MapMarker>. Give it the point's `id` as its key."
+        },
+        {
+          "name": "radius",
+          "type": "number",
+          "required": false,
+          "default": 56,
+          "description": "Grid size in px: larger groups more places together. Defaults to 56."
+        },
+        {
+          "name": "clusterMaxZoom",
+          "type": "number",
+          "required": false,
+          "default": 16,
+          "description": "From this zoom up, nothing clusters. Defaults to 16."
+        },
+        {
+          "name": "onClusterClick",
+          "type": "((points: T[]) => void)",
+          "required": false,
+          "description": "Called after a cluster is clicked, with the places in it. The map zooms to them first."
+        }
+      ],
+      "contract": {
+        "requiredProps": [
+          "points",
+          "renderPoint"
+        ],
+        "requiresAccessibleName": false
+      },
+      "since": "0.11.0",
+      "example": "import { MapClusterLayer } from '@sakaniui/react';\n\n<MapClusterLayer points={[{ id: \"item-1\", position: [1, 1] }]} renderPoint={() => {}} />",
+      "aliases": [
+        "marker clustering",
+        "cluster markers",
+        "supercluster",
+        "many markers",
+        "point clustering",
+        "heatmap markers"
+      ]
+    },
+    {
+      "name": "MapControlButton",
+      "kind": "component",
+      "category": "Composite",
+      "import": "@sakaniui/react",
+      "summary": "A 32px icon button for a map overlay (the zoom and locate buttons Map shows). Needs an icon and an aria-label; has hover and disabled states.",
+      "props": [
+        {
+          "name": "icon",
+          "type": "IconComponent",
+          "required": true,
+          "description": "The icon, drawn at 16px."
+        },
+        {
+          "name": "aria-label",
+          "type": "string",
+          "required": true,
+          "description": "Accessible name; the button has no visible text."
+        },
+        {
+          "name": "disabled",
+          "type": "boolean",
+          "required": false
+        },
+        {
+          "name": "hovered",
+          "type": "boolean",
+          "required": false,
+          "description": "Shows the hover appearance without a pointer (documentation and visual tests)."
+        },
+        {
+          "name": "onClick",
+          "type": "(() => void)",
+          "required": false
+        },
+        {
+          "name": "className",
+          "type": "string",
+          "required": false
+        }
+      ],
+      "contract": {
+        "requiredProps": [
+          "icon",
+          "aria-label"
+        ],
+        "requiresAccessibleName": true
+      },
+      "since": "0.11.0",
+      "example": "import { MapControlButton } from '@sakaniui/react';\nimport { IconStar } from '@sakaniui/react/icons';\n\n<MapControlButton icon={IconStar} aria-label=\"Describe the action\" />",
+      "aliases": [
+        "map button",
+        "zoom button",
+        "map control"
+      ]
+    },
+    {
+      "name": "MapControls",
+      "kind": "component",
+      "category": "Composite",
+      "import": "@sakaniui/react",
+      "summary": "The zoom group and optional locate button a Map shows top-right. Map renders it itself; use it to build a custom overlay.",
+      "props": [
+        {
+          "name": "onZoomIn",
+          "type": "(() => void)",
+          "required": false
+        },
+        {
+          "name": "onZoomOut",
+          "type": "(() => void)",
+          "required": false
+        },
+        {
+          "name": "zoomInDisabled",
+          "type": "boolean",
+          "required": false,
+          "description": "Disables the zoom-in button, e.g. at the map's maximum zoom."
+        },
+        {
+          "name": "zoomOutDisabled",
+          "type": "boolean",
+          "required": false
+        },
+        {
+          "name": "zoom",
+          "type": "boolean",
+          "required": false,
+          "default": true,
+          "description": "Show the zoom group. Defaults to true."
+        },
+        {
+          "name": "locate",
+          "type": "boolean",
+          "required": false,
+          "default": false
+        },
+        {
+          "name": "onLocate",
+          "type": "(() => void)",
+          "required": false
+        },
+        {
+          "name": "className",
+          "type": "string",
+          "required": false
+        }
+      ],
+      "contract": {
+        "requiredProps": [],
+        "requiresAccessibleName": false
+      },
+      "since": "0.11.0",
+      "example": "import { MapControls } from '@sakaniui/react';\n\n<MapControls />",
+      "aliases": [
+        "zoom controls",
+        "map zoom",
+        "zoom in out",
+        "locate button"
+      ]
+    },
+    {
+      "name": "MapGlobe",
+      "kind": "component",
+      "category": "Composite",
+      "import": "@sakaniui/react",
+      "summary": "A 3D dotted globe that spins and can be dragged. `variant` \"land\" dots the continents, \"ocean\" dots the sea; pass `markers` and `arcs` to show places and routes. Follows light and dark.",
+      "props": [
+        {
+          "name": "variant",
+          "type": "\"land\" | \"ocean\"",
+          "required": false,
+          "values": [
+            "land",
+            "ocean"
+          ],
+          "default": "land",
+          "description": "Which part gets the bright dots. Defaults to \"land\"."
+        },
+        {
+          "name": "center",
+          "type": "LatLng",
+          "required": false,
+          "default": "[15, 90]",
+          "description": "The place facing the viewer at first, as [latitude, longitude].",
+          "shape": {
+            "type": "LatLng",
+            "collection": "object",
+            "fields": [
+              {
+                "name": "0",
+                "type": "number",
+                "required": true
+              },
+              {
+                "name": "1",
+                "type": "number",
+                "required": true
+              },
+              {
+                "name": "length",
+                "type": "2",
+                "required": true
+              },
+              {
+                "name": "toString",
+                "type": "() => string",
+                "required": true,
+                "description": "Returns a string representation of an array."
+              },
+              {
+                "name": "toLocaleString",
+                "type": "{ (): string; (locales: string | string[], options?: (NumberFormatOptions & DateTimeFormatOptions) | undefined): string; }",
+                "required": true,
+                "description": "Returns a string representation of an array. The elements are converted to string using their toLocaleString methods."
+              },
+              {
+                "name": "pop",
+                "type": "() => number",
+                "required": true,
+                "description": "Removes the last element from an array and returns it. If the array is empty, undefined is returned and the array is not modified."
+              },
+              {
+                "name": "push",
+                "type": "(...items: number[]) => number",
+                "required": true,
+                "description": "Appends new elements to the end of an array, and returns the new length of the array."
+              },
+              {
+                "name": "concat",
+                "type": "{ (...items: ConcatArray<number>[]): number[]; (...items: (number | ConcatArray<number>)[]): number[]; }",
+                "required": true,
+                "description": "Combines two or more arrays. This method returns a new array without modifying any existing arrays."
+              },
+              {
+                "name": "join",
+                "type": "(separator?: string | undefined) => string",
+                "required": true,
+                "description": "Adds all the elements of an array into a string, separated by the specified separator string."
+              },
+              {
+                "name": "reverse",
+                "type": "() => number[]",
+                "required": true,
+                "description": "Reverses the elements in an array in place. This method mutates the array and returns a reference to the same array."
+              },
+              {
+                "name": "shift",
+                "type": "() => number",
+                "required": true,
+                "description": "Removes the first element from an array and returns it. If the array is empty, undefined is returned and the array is not modified."
+              },
+              {
+                "name": "slice",
+                "type": "(start?: number | undefined, end?: number | undefined) => number[]",
+                "required": true,
+                "description": "Returns a copy of a section of an array. For both start and end, a negative index can be used to indicate an offset from the end of the array. For example, -2 refers to the second to last element of the array."
+              },
+              {
+                "name": "sort",
+                "type": "(compareFn?: ((a: number, b: number) => number) | undefined) => LatLng",
+                "required": true,
+                "description": "Sorts an array in place. This method mutates the array and returns a reference to the same array."
+              },
+              {
+                "name": "splice",
+                "type": "{ (start: number, deleteCount?: number | undefined): number[]; (start: number, deleteCount: number, ...items: number[]): number[]; }",
+                "required": true,
+                "description": "Removes elements from an array and, if necessary, inserts new elements in their place, returning the deleted elements."
+              },
+              {
+                "name": "unshift",
+                "type": "(...items: number[]) => number",
+                "required": true,
+                "description": "Inserts new elements at the start of an array, and returns the new length of the array."
+              },
+              {
+                "name": "indexOf",
+                "type": "(searchElement: number, fromIndex?: number | undefined) => number",
+                "required": true,
+                "description": "Returns the index of the first occurrence of a value in an array, or -1 if it is not present."
+              },
+              {
+                "name": "lastIndexOf",
+                "type": "(searchElement: number, fromIndex?: number | undefined) => number",
+                "required": true,
+                "description": "Returns the index of the last occurrence of a specified value in an array, or -1 if it is not present."
+              },
+              {
+                "name": "every",
+                "type": "{ <S extends number>(predicate: (value: number, index: number, array: number[]) => value is S, thisArg?: any): this is S[]; (predicate: (value: number, index: number, array: number[]) => unknown, thisArg?: any): boolean; }",
+                "required": true,
+                "description": "Determines whether all the members of an array satisfy the specified test."
+              },
+              {
+                "name": "some",
+                "type": "(predicate: (value: number, index: number, array: number[]) => unknown, thisArg?: any) => boolean",
+                "required": true,
+                "description": "Determines whether the specified callback function returns true for any element of an array."
+              },
+              {
+                "name": "forEach",
+                "type": "(callbackfn: (value: number, index: number, array: number[]) => void, thisArg?: any) => void",
+                "required": true,
+                "description": "Performs the specified action for each element in an array."
+              },
+              {
+                "name": "map",
+                "type": "<U>(callbackfn: (value: number, index: number, array: number[]) => U, thisArg?: any) => U[]",
+                "required": true,
+                "description": "Calls a defined callback function on each element of an array, and returns an array that contains the results."
+              },
+              {
+                "name": "filter",
+                "type": "{ <S extends number>(predicate: (value: number, index: number, array: number[]) => value is S, thisArg?: any): S[]; (predicate: (value: number, index: number, array: number[]) => unknown, thisArg?: any): number[]; }",
+                "required": true,
+                "description": "Returns the elements of an array that meet the condition specified in a callback function."
+              },
+              {
+                "name": "reduce",
+                "type": "{ (callbackfn: (previousValue: number, currentValue: number, currentIndex: number, array: number[]) => number): number; (callbackfn: (previousValue: number, currentValue: number, currentIndex: number, array: number[]) => number, initialValue: number): number; <U>(callbackfn: (previousValue: U, currentValue: number, currentIndex: number, array: number[]) => U, initialValue: U): U; }",
+                "required": true,
+                "description": "Calls the specified callback function for all the elements in an array. The return value of the callback function is the accumulated result, and is provided as an argument in the next call to the callback function."
+              },
+              {
+                "name": "reduceRight",
+                "type": "{ (callbackfn: (previousValue: number, currentValue: number, currentIndex: number, array: number[]) => number): number; (callbackfn: (previousValue: number, currentValue: number, currentIndex: number, array: number[]) => number, initialValue: number): number; <U>(callbackfn: (previousValue: U, currentValue: number, currentIndex: number, array: number[]) => U, initialValue: U): U; }",
+                "required": true,
+                "description": "Calls the specified callback function for all the elements in an array, in descending order. The return value of the callback function is the accumulated result, and is provided as an argument in the next call to the callback function."
+              },
+              {
+                "name": "find",
+                "type": "{ <S extends number>(predicate: (value: number, index: number, obj: number[]) => value is S, thisArg?: any): S | undefined; (predicate: (value: number, index: number, obj: number[]) => unknown, thisArg?: any): number | undefined; }",
+                "required": true,
+                "description": "Returns the value of the first element in the array where predicate is true, and undefined otherwise."
+              },
+              {
+                "name": "findIndex",
+                "type": "(predicate: (value: number, index: number, obj: number[]) => unknown, thisArg?: any) => number",
+                "required": true,
+                "description": "Returns the index of the first element in the array where predicate is true, and -1 otherwise."
+              },
+              {
+                "name": "fill",
+                "type": "(value: number, start?: number | undefined, end?: number | undefined) => LatLng",
+                "required": true,
+                "description": "Changes all array elements from `start` to `end` index to a static `value` and returns the modified array"
+              },
+              {
+                "name": "copyWithin",
+                "type": "(target: number, start: number, end?: number | undefined) => LatLng",
+                "required": true,
+                "description": "Returns the this object after copying a section of the array identified by start and end to the same array starting at position target"
+              },
+              {
+                "name": "entries",
+                "type": "() => ArrayIterator<[number, number]>",
+                "required": true,
+                "description": "Returns an iterable of key, value pairs for every entry in the array"
+              },
+              {
+                "name": "keys",
+                "type": "() => ArrayIterator<number>",
+                "required": true,
+                "description": "Returns an iterable of keys in the array"
+              },
+              {
+                "name": "values",
+                "type": "() => ArrayIterator<number>",
+                "required": true,
+                "description": "Returns an iterable of values in the array"
+              },
+              {
+                "name": "includes",
+                "type": "(searchElement: number, fromIndex?: number | undefined) => boolean",
+                "required": true,
+                "description": "Determines whether an array includes a certain element, returning true or false as appropriate."
+              },
+              {
+                "name": "flatMap",
+                "type": "<U, This = undefined>(callback: (this: This, value: number, index: number, array: number[]) => U | readonly U[], thisArg?: This | undefined) => U[]",
+                "required": true,
+                "description": "Calls a defined callback function on each element of an array. Then, flattens the result into a new array. This is identical to a map followed by flat with depth 1."
+              },
+              {
+                "name": "flat",
+                "type": "<A, D extends number = 1>(this: A, depth?: D | undefined) => FlatArray<A, D>[]",
+                "required": true,
+                "description": "Returns a new array with all sub-array elements concatenated into it recursively up to the specified depth."
+              },
+              {
+                "name": "at",
+                "type": "(index: number) => number",
+                "required": true,
+                "description": "Returns the item located at the specified index."
+              },
+              {
+                "name": "__@iterator@12750",
+                "type": "() => ArrayIterator<number>",
+                "required": true,
+                "description": "Iterator"
+              },
+              {
+                "name": "__@unscopables@12780",
+                "type": "{ [x: number]: boolean | undefined; length?: boolean | undefined; toString?: boolean | undefined; toLocaleString?: boolean | undefined; pop?: boolean | undefined; push?: boolean | undefined; concat?: boolean | undefined; join?: boolean | undefined; reverse?: boolean | undefined; shift?: boolean | undefined; slice?: boolean | undefined; sort?: boolean | undefined; splice?: boolean | undefined; unshift?: boolean | undefined; indexOf?: boolean | undefined; lastIndexOf?: boolean | undefined; every?: boolean | undefined; some?: boolean | undefined; forEach?: boolean | undefined; map?: boolean | undefined; filter?: boolean | undefined; reduce?: boolean | undefined; reduceRight?: boolean | undefined; find?: boolean | undefined; findIndex?: boolean | undefined; fill?: boolean | undefined; copyWithin?: boolean | undefined; entries?: boolean | undefined; keys?: boolean | undefined; values?: boolean | undefined; includes?: boolean | undefined; flatMap?: boolean | undefined; flat?: boolean | undefined; at?: boolean | undefined; [Symbol.iterator]?: boolean | undefined; readonly [Symbol.unscopables]?: boolean | undefined; }",
+                "required": true,
+                "description": "Is an object whose properties have the value 'true' when they will be absent when used in a 'with' statement."
+              }
+            ]
+          }
+        },
+        {
+          "name": "markers",
+          "type": "MapGlobeMarker[]",
+          "required": false,
+          "default": "[]",
+          "shape": {
+            "type": "MapGlobeMarker",
+            "collection": "array",
+            "fields": [
+              {
+                "name": "position",
+                "type": "LatLng",
+                "required": true,
+                "description": "[latitude, longitude]"
+              },
+              {
+                "name": "active",
+                "type": "boolean",
+                "required": false,
+                "description": "Draws a pulsing ring around it."
+              },
+              {
+                "name": "selected",
+                "type": "boolean",
+                "required": false,
+                "description": "The larger halo, for the marker the user picked."
+              },
+              {
+                "name": "hovered",
+                "type": "boolean",
+                "required": false,
+                "description": "Shows the hover appearance without a pointer (documentation and visual tests). Real hover works on its own."
+              },
+              {
+                "name": "label",
+                "type": "string",
+                "required": false,
+                "description": "Name shown in a small card above the marker while it is hovered or selected; also its accessible name."
+              }
+            ]
+          }
+        },
+        {
+          "name": "arcs",
+          "type": "MapGlobeArc[]",
+          "required": false,
+          "default": "[]",
+          "shape": {
+            "type": "MapGlobeArc",
+            "collection": "array",
+            "fields": [
+              {
+                "name": "from",
+                "type": "LatLng",
+                "required": true
+              },
+              {
+                "name": "to",
+                "type": "LatLng",
+                "required": true
+              }
+            ]
+          }
+        },
+        {
+          "name": "autoRotate",
+          "type": "boolean",
+          "required": false,
+          "default": true,
+          "description": "Spin on its own. Defaults to true (off under reduced motion)."
+        },
+        {
+          "name": "rotationSpeed",
+          "type": "number",
+          "required": false,
+          "default": 6,
+          "description": "Degrees per second. Defaults to 6."
+        },
+        {
+          "name": "draggable",
+          "type": "boolean",
+          "required": false,
+          "default": true,
+          "description": "Let people drag to spin it. Defaults to true."
+        },
+        {
+          "name": "atmosphere",
+          "type": "boolean",
+          "required": false,
+          "default": true,
+          "description": "The soft halo past the edge. Defaults to true."
+        },
+        {
+          "name": "dotSpacing",
+          "type": "number",
+          "required": false,
+          "default": 1.3,
+          "description": "Degrees between dots; smaller is denser. Defaults to 1.3."
+        },
+        {
+          "name": "theme",
+          "type": "\"auto\" | \"dark\"",
+          "required": false,
+          "values": [
+            "auto",
+            "dark"
+          ],
+          "default": "auto",
+          "description": "\"auto\" follows the surrounding theme. \"dark\" draws light dots wherever the globe sits, for a globe on a dark surface inside a light page. (The globe has no background of its own; it takes the colour behind it.)"
+        },
+        {
+          "name": "onMarkerClick",
+          "type": "((index: number, marker: MapGlobeMarker) => void)",
+          "required": false,
+          "description": "Called when a marker is clicked or activated from the keyboard (markers with a `label` get a hidden button)."
+        },
+        {
+          "name": "onMarkerHover",
+          "type": "((index: number | null) => void)",
+          "required": false,
+          "description": "Called when the pointer or keyboard focus moves onto a marker, and with null when it leaves."
+        },
+        {
+          "name": "aria-label",
+          "type": "string",
+          "required": false,
+          "default": "Globe",
+          "description": "Accessible description. Defaults to \"Globe\"."
+        },
+        {
+          "name": "className",
+          "type": "string",
+          "required": false
+        }
+      ],
+      "contract": {
+        "requiredProps": [],
+        "requiresAccessibleName": false
+      },
+      "since": "0.11.0",
+      "example": "import { MapGlobe } from '@sakaniui/react';\n\n<MapGlobe />",
+      "aliases": [
+        "globe",
+        "3d globe",
+        "world globe",
+        "earth",
+        "dotted globe",
+        "spinning globe",
+        "world map",
+        "dot globe"
+      ]
+    },
+    {
+      "name": "MapMarker",
+      "kind": "component",
+      "category": "Composite",
+      "import": "@sakaniui/react",
+      "summary": "A place on a Map.",
+      "props": [
+        {
+          "name": "position",
+          "type": "LatLng",
+          "required": true,
+          "description": "[latitude, longitude]",
+          "shape": {
+            "type": "LatLng",
+            "collection": "object",
+            "fields": [
+              {
+                "name": "0",
+                "type": "number",
+                "required": true
+              },
+              {
+                "name": "1",
+                "type": "number",
+                "required": true
+              },
+              {
+                "name": "length",
+                "type": "2",
+                "required": true
+              },
+              {
+                "name": "toString",
+                "type": "() => string",
+                "required": true,
+                "description": "Returns a string representation of an array."
+              },
+              {
+                "name": "toLocaleString",
+                "type": "{ (): string; (locales: string | string[], options?: (NumberFormatOptions & DateTimeFormatOptions) | undefined): string; }",
+                "required": true,
+                "description": "Returns a string representation of an array. The elements are converted to string using their toLocaleString methods."
+              },
+              {
+                "name": "pop",
+                "type": "() => number",
+                "required": true,
+                "description": "Removes the last element from an array and returns it. If the array is empty, undefined is returned and the array is not modified."
+              },
+              {
+                "name": "push",
+                "type": "(...items: number[]) => number",
+                "required": true,
+                "description": "Appends new elements to the end of an array, and returns the new length of the array."
+              },
+              {
+                "name": "concat",
+                "type": "{ (...items: ConcatArray<number>[]): number[]; (...items: (number | ConcatArray<number>)[]): number[]; }",
+                "required": true,
+                "description": "Combines two or more arrays. This method returns a new array without modifying any existing arrays."
+              },
+              {
+                "name": "join",
+                "type": "(separator?: string | undefined) => string",
+                "required": true,
+                "description": "Adds all the elements of an array into a string, separated by the specified separator string."
+              },
+              {
+                "name": "reverse",
+                "type": "() => number[]",
+                "required": true,
+                "description": "Reverses the elements in an array in place. This method mutates the array and returns a reference to the same array."
+              },
+              {
+                "name": "shift",
+                "type": "() => number",
+                "required": true,
+                "description": "Removes the first element from an array and returns it. If the array is empty, undefined is returned and the array is not modified."
+              },
+              {
+                "name": "slice",
+                "type": "(start?: number | undefined, end?: number | undefined) => number[]",
+                "required": true,
+                "description": "Returns a copy of a section of an array. For both start and end, a negative index can be used to indicate an offset from the end of the array. For example, -2 refers to the second to last element of the array."
+              },
+              {
+                "name": "sort",
+                "type": "(compareFn?: ((a: number, b: number) => number) | undefined) => LatLng",
+                "required": true,
+                "description": "Sorts an array in place. This method mutates the array and returns a reference to the same array."
+              },
+              {
+                "name": "splice",
+                "type": "{ (start: number, deleteCount?: number | undefined): number[]; (start: number, deleteCount: number, ...items: number[]): number[]; }",
+                "required": true,
+                "description": "Removes elements from an array and, if necessary, inserts new elements in their place, returning the deleted elements."
+              },
+              {
+                "name": "unshift",
+                "type": "(...items: number[]) => number",
+                "required": true,
+                "description": "Inserts new elements at the start of an array, and returns the new length of the array."
+              },
+              {
+                "name": "indexOf",
+                "type": "(searchElement: number, fromIndex?: number | undefined) => number",
+                "required": true,
+                "description": "Returns the index of the first occurrence of a value in an array, or -1 if it is not present."
+              },
+              {
+                "name": "lastIndexOf",
+                "type": "(searchElement: number, fromIndex?: number | undefined) => number",
+                "required": true,
+                "description": "Returns the index of the last occurrence of a specified value in an array, or -1 if it is not present."
+              },
+              {
+                "name": "every",
+                "type": "{ <S extends number>(predicate: (value: number, index: number, array: number[]) => value is S, thisArg?: any): this is S[]; (predicate: (value: number, index: number, array: number[]) => unknown, thisArg?: any): boolean; }",
+                "required": true,
+                "description": "Determines whether all the members of an array satisfy the specified test."
+              },
+              {
+                "name": "some",
+                "type": "(predicate: (value: number, index: number, array: number[]) => unknown, thisArg?: any) => boolean",
+                "required": true,
+                "description": "Determines whether the specified callback function returns true for any element of an array."
+              },
+              {
+                "name": "forEach",
+                "type": "(callbackfn: (value: number, index: number, array: number[]) => void, thisArg?: any) => void",
+                "required": true,
+                "description": "Performs the specified action for each element in an array."
+              },
+              {
+                "name": "map",
+                "type": "<U>(callbackfn: (value: number, index: number, array: number[]) => U, thisArg?: any) => U[]",
+                "required": true,
+                "description": "Calls a defined callback function on each element of an array, and returns an array that contains the results."
+              },
+              {
+                "name": "filter",
+                "type": "{ <S extends number>(predicate: (value: number, index: number, array: number[]) => value is S, thisArg?: any): S[]; (predicate: (value: number, index: number, array: number[]) => unknown, thisArg?: any): number[]; }",
+                "required": true,
+                "description": "Returns the elements of an array that meet the condition specified in a callback function."
+              },
+              {
+                "name": "reduce",
+                "type": "{ (callbackfn: (previousValue: number, currentValue: number, currentIndex: number, array: number[]) => number): number; (callbackfn: (previousValue: number, currentValue: number, currentIndex: number, array: number[]) => number, initialValue: number): number; <U>(callbackfn: (previousValue: U, currentValue: number, currentIndex: number, array: number[]) => U, initialValue: U): U; }",
+                "required": true,
+                "description": "Calls the specified callback function for all the elements in an array. The return value of the callback function is the accumulated result, and is provided as an argument in the next call to the callback function."
+              },
+              {
+                "name": "reduceRight",
+                "type": "{ (callbackfn: (previousValue: number, currentValue: number, currentIndex: number, array: number[]) => number): number; (callbackfn: (previousValue: number, currentValue: number, currentIndex: number, array: number[]) => number, initialValue: number): number; <U>(callbackfn: (previousValue: U, currentValue: number, currentIndex: number, array: number[]) => U, initialValue: U): U; }",
+                "required": true,
+                "description": "Calls the specified callback function for all the elements in an array, in descending order. The return value of the callback function is the accumulated result, and is provided as an argument in the next call to the callback function."
+              },
+              {
+                "name": "find",
+                "type": "{ <S extends number>(predicate: (value: number, index: number, obj: number[]) => value is S, thisArg?: any): S | undefined; (predicate: (value: number, index: number, obj: number[]) => unknown, thisArg?: any): number | undefined; }",
+                "required": true,
+                "description": "Returns the value of the first element in the array where predicate is true, and undefined otherwise."
+              },
+              {
+                "name": "findIndex",
+                "type": "(predicate: (value: number, index: number, obj: number[]) => unknown, thisArg?: any) => number",
+                "required": true,
+                "description": "Returns the index of the first element in the array where predicate is true, and -1 otherwise."
+              },
+              {
+                "name": "fill",
+                "type": "(value: number, start?: number | undefined, end?: number | undefined) => LatLng",
+                "required": true,
+                "description": "Changes all array elements from `start` to `end` index to a static `value` and returns the modified array"
+              },
+              {
+                "name": "copyWithin",
+                "type": "(target: number, start: number, end?: number | undefined) => LatLng",
+                "required": true,
+                "description": "Returns the this object after copying a section of the array identified by start and end to the same array starting at position target"
+              },
+              {
+                "name": "entries",
+                "type": "() => ArrayIterator<[number, number]>",
+                "required": true,
+                "description": "Returns an iterable of key, value pairs for every entry in the array"
+              },
+              {
+                "name": "keys",
+                "type": "() => ArrayIterator<number>",
+                "required": true,
+                "description": "Returns an iterable of keys in the array"
+              },
+              {
+                "name": "values",
+                "type": "() => ArrayIterator<number>",
+                "required": true,
+                "description": "Returns an iterable of values in the array"
+              },
+              {
+                "name": "includes",
+                "type": "(searchElement: number, fromIndex?: number | undefined) => boolean",
+                "required": true,
+                "description": "Determines whether an array includes a certain element, returning true or false as appropriate."
+              },
+              {
+                "name": "flatMap",
+                "type": "<U, This = undefined>(callback: (this: This, value: number, index: number, array: number[]) => U | readonly U[], thisArg?: This | undefined) => U[]",
+                "required": true,
+                "description": "Calls a defined callback function on each element of an array. Then, flattens the result into a new array. This is identical to a map followed by flat with depth 1."
+              },
+              {
+                "name": "flat",
+                "type": "<A, D extends number = 1>(this: A, depth?: D | undefined) => FlatArray<A, D>[]",
+                "required": true,
+                "description": "Returns a new array with all sub-array elements concatenated into it recursively up to the specified depth."
+              },
+              {
+                "name": "at",
+                "type": "(index: number) => number",
+                "required": true,
+                "description": "Returns the item located at the specified index."
+              },
+              {
+                "name": "__@iterator@12750",
+                "type": "() => ArrayIterator<number>",
+                "required": true,
+                "description": "Iterator"
+              },
+              {
+                "name": "__@unscopables@12780",
+                "type": "{ [x: number]: boolean | undefined; length?: boolean | undefined; toString?: boolean | undefined; toLocaleString?: boolean | undefined; pop?: boolean | undefined; push?: boolean | undefined; concat?: boolean | undefined; join?: boolean | undefined; reverse?: boolean | undefined; shift?: boolean | undefined; slice?: boolean | undefined; sort?: boolean | undefined; splice?: boolean | undefined; unshift?: boolean | undefined; indexOf?: boolean | undefined; lastIndexOf?: boolean | undefined; every?: boolean | undefined; some?: boolean | undefined; forEach?: boolean | undefined; map?: boolean | undefined; filter?: boolean | undefined; reduce?: boolean | undefined; reduceRight?: boolean | undefined; find?: boolean | undefined; findIndex?: boolean | undefined; fill?: boolean | undefined; copyWithin?: boolean | undefined; entries?: boolean | undefined; keys?: boolean | undefined; values?: boolean | undefined; includes?: boolean | undefined; flatMap?: boolean | undefined; flat?: boolean | undefined; at?: boolean | undefined; [Symbol.iterator]?: boolean | undefined; readonly [Symbol.unscopables]?: boolean | undefined; }",
+                "required": true,
+                "description": "Is an object whose properties have the value 'true' when they will be absent when used in a 'with' statement."
+              }
+            ]
+          }
+        },
+        {
+          "name": "variant",
+          "type": "\"pin\" | \"dot\" | \"cluster\"",
+          "required": false,
+          "values": [
+            "pin",
+            "dot",
+            "cluster"
+          ],
+          "default": "pin"
+        },
+        {
+          "name": "count",
+          "type": "number",
+          "required": false,
+          "description": "Number shown on a cluster."
+        },
+        {
+          "name": "selected",
+          "type": "boolean",
+          "required": false
+        },
+        {
+          "name": "hovered",
+          "type": "boolean",
+          "required": false,
+          "description": "Shows the hover appearance without a pointer (documentation and visual tests). Real hover works on its own."
+        },
+        {
+          "name": "glide",
+          "type": "number",
+          "required": false,
+          "description": "Milliseconds to slide to a new `position` instead of jumping, for markers fed by a live source (about the interval between updates reads as continuous). Off by default; reduced motion turns it off."
+        },
+        {
+          "name": "label",
+          "type": "string",
+          "required": false,
+          "description": "Accessible name, e.g. the place's name."
+        },
+        {
+          "name": "onClick",
+          "type": "((e: MouseEvent<HTMLButtonElement, MouseEvent>) => void)",
+          "required": false
+        },
+        {
+          "name": "className",
+          "type": "string",
+          "required": false
+        }
+      ],
+      "contract": {
+        "requiredProps": [
+          "position"
+        ],
+        "requiresAccessibleName": false
+      },
+      "since": "0.11.0",
+      "example": "import { MapMarker } from '@sakaniui/react';\n\n<MapMarker position={[1, 1]} />",
+      "aliases": [
+        "map pin",
+        "pin",
+        "location pin",
+        "map marker pin",
+        "live marker",
+        "moving marker",
+        "vehicle marker"
+      ]
+    },
+    {
+      "name": "MapPopup",
+      "kind": "component",
+      "category": "Composite",
+      "import": "@sakaniui/react",
+      "summary": "Card that opens above a place on a Map.",
+      "props": [
+        {
+          "name": "position",
+          "type": "LatLng",
+          "required": true,
+          "description": "[latitude, longitude] the pointer points at.",
+          "shape": {
+            "type": "LatLng",
+            "collection": "object",
+            "fields": [
+              {
+                "name": "0",
+                "type": "number",
+                "required": true
+              },
+              {
+                "name": "1",
+                "type": "number",
+                "required": true
+              },
+              {
+                "name": "length",
+                "type": "2",
+                "required": true
+              },
+              {
+                "name": "toString",
+                "type": "() => string",
+                "required": true,
+                "description": "Returns a string representation of an array."
+              },
+              {
+                "name": "toLocaleString",
+                "type": "{ (): string; (locales: string | string[], options?: (NumberFormatOptions & DateTimeFormatOptions) | undefined): string; }",
+                "required": true,
+                "description": "Returns a string representation of an array. The elements are converted to string using their toLocaleString methods."
+              },
+              {
+                "name": "pop",
+                "type": "() => number",
+                "required": true,
+                "description": "Removes the last element from an array and returns it. If the array is empty, undefined is returned and the array is not modified."
+              },
+              {
+                "name": "push",
+                "type": "(...items: number[]) => number",
+                "required": true,
+                "description": "Appends new elements to the end of an array, and returns the new length of the array."
+              },
+              {
+                "name": "concat",
+                "type": "{ (...items: ConcatArray<number>[]): number[]; (...items: (number | ConcatArray<number>)[]): number[]; }",
+                "required": true,
+                "description": "Combines two or more arrays. This method returns a new array without modifying any existing arrays."
+              },
+              {
+                "name": "join",
+                "type": "(separator?: string | undefined) => string",
+                "required": true,
+                "description": "Adds all the elements of an array into a string, separated by the specified separator string."
+              },
+              {
+                "name": "reverse",
+                "type": "() => number[]",
+                "required": true,
+                "description": "Reverses the elements in an array in place. This method mutates the array and returns a reference to the same array."
+              },
+              {
+                "name": "shift",
+                "type": "() => number",
+                "required": true,
+                "description": "Removes the first element from an array and returns it. If the array is empty, undefined is returned and the array is not modified."
+              },
+              {
+                "name": "slice",
+                "type": "(start?: number | undefined, end?: number | undefined) => number[]",
+                "required": true,
+                "description": "Returns a copy of a section of an array. For both start and end, a negative index can be used to indicate an offset from the end of the array. For example, -2 refers to the second to last element of the array."
+              },
+              {
+                "name": "sort",
+                "type": "(compareFn?: ((a: number, b: number) => number) | undefined) => LatLng",
+                "required": true,
+                "description": "Sorts an array in place. This method mutates the array and returns a reference to the same array."
+              },
+              {
+                "name": "splice",
+                "type": "{ (start: number, deleteCount?: number | undefined): number[]; (start: number, deleteCount: number, ...items: number[]): number[]; }",
+                "required": true,
+                "description": "Removes elements from an array and, if necessary, inserts new elements in their place, returning the deleted elements."
+              },
+              {
+                "name": "unshift",
+                "type": "(...items: number[]) => number",
+                "required": true,
+                "description": "Inserts new elements at the start of an array, and returns the new length of the array."
+              },
+              {
+                "name": "indexOf",
+                "type": "(searchElement: number, fromIndex?: number | undefined) => number",
+                "required": true,
+                "description": "Returns the index of the first occurrence of a value in an array, or -1 if it is not present."
+              },
+              {
+                "name": "lastIndexOf",
+                "type": "(searchElement: number, fromIndex?: number | undefined) => number",
+                "required": true,
+                "description": "Returns the index of the last occurrence of a specified value in an array, or -1 if it is not present."
+              },
+              {
+                "name": "every",
+                "type": "{ <S extends number>(predicate: (value: number, index: number, array: number[]) => value is S, thisArg?: any): this is S[]; (predicate: (value: number, index: number, array: number[]) => unknown, thisArg?: any): boolean; }",
+                "required": true,
+                "description": "Determines whether all the members of an array satisfy the specified test."
+              },
+              {
+                "name": "some",
+                "type": "(predicate: (value: number, index: number, array: number[]) => unknown, thisArg?: any) => boolean",
+                "required": true,
+                "description": "Determines whether the specified callback function returns true for any element of an array."
+              },
+              {
+                "name": "forEach",
+                "type": "(callbackfn: (value: number, index: number, array: number[]) => void, thisArg?: any) => void",
+                "required": true,
+                "description": "Performs the specified action for each element in an array."
+              },
+              {
+                "name": "map",
+                "type": "<U>(callbackfn: (value: number, index: number, array: number[]) => U, thisArg?: any) => U[]",
+                "required": true,
+                "description": "Calls a defined callback function on each element of an array, and returns an array that contains the results."
+              },
+              {
+                "name": "filter",
+                "type": "{ <S extends number>(predicate: (value: number, index: number, array: number[]) => value is S, thisArg?: any): S[]; (predicate: (value: number, index: number, array: number[]) => unknown, thisArg?: any): number[]; }",
+                "required": true,
+                "description": "Returns the elements of an array that meet the condition specified in a callback function."
+              },
+              {
+                "name": "reduce",
+                "type": "{ (callbackfn: (previousValue: number, currentValue: number, currentIndex: number, array: number[]) => number): number; (callbackfn: (previousValue: number, currentValue: number, currentIndex: number, array: number[]) => number, initialValue: number): number; <U>(callbackfn: (previousValue: U, currentValue: number, currentIndex: number, array: number[]) => U, initialValue: U): U; }",
+                "required": true,
+                "description": "Calls the specified callback function for all the elements in an array. The return value of the callback function is the accumulated result, and is provided as an argument in the next call to the callback function."
+              },
+              {
+                "name": "reduceRight",
+                "type": "{ (callbackfn: (previousValue: number, currentValue: number, currentIndex: number, array: number[]) => number): number; (callbackfn: (previousValue: number, currentValue: number, currentIndex: number, array: number[]) => number, initialValue: number): number; <U>(callbackfn: (previousValue: U, currentValue: number, currentIndex: number, array: number[]) => U, initialValue: U): U; }",
+                "required": true,
+                "description": "Calls the specified callback function for all the elements in an array, in descending order. The return value of the callback function is the accumulated result, and is provided as an argument in the next call to the callback function."
+              },
+              {
+                "name": "find",
+                "type": "{ <S extends number>(predicate: (value: number, index: number, obj: number[]) => value is S, thisArg?: any): S | undefined; (predicate: (value: number, index: number, obj: number[]) => unknown, thisArg?: any): number | undefined; }",
+                "required": true,
+                "description": "Returns the value of the first element in the array where predicate is true, and undefined otherwise."
+              },
+              {
+                "name": "findIndex",
+                "type": "(predicate: (value: number, index: number, obj: number[]) => unknown, thisArg?: any) => number",
+                "required": true,
+                "description": "Returns the index of the first element in the array where predicate is true, and -1 otherwise."
+              },
+              {
+                "name": "fill",
+                "type": "(value: number, start?: number | undefined, end?: number | undefined) => LatLng",
+                "required": true,
+                "description": "Changes all array elements from `start` to `end` index to a static `value` and returns the modified array"
+              },
+              {
+                "name": "copyWithin",
+                "type": "(target: number, start: number, end?: number | undefined) => LatLng",
+                "required": true,
+                "description": "Returns the this object after copying a section of the array identified by start and end to the same array starting at position target"
+              },
+              {
+                "name": "entries",
+                "type": "() => ArrayIterator<[number, number]>",
+                "required": true,
+                "description": "Returns an iterable of key, value pairs for every entry in the array"
+              },
+              {
+                "name": "keys",
+                "type": "() => ArrayIterator<number>",
+                "required": true,
+                "description": "Returns an iterable of keys in the array"
+              },
+              {
+                "name": "values",
+                "type": "() => ArrayIterator<number>",
+                "required": true,
+                "description": "Returns an iterable of values in the array"
+              },
+              {
+                "name": "includes",
+                "type": "(searchElement: number, fromIndex?: number | undefined) => boolean",
+                "required": true,
+                "description": "Determines whether an array includes a certain element, returning true or false as appropriate."
+              },
+              {
+                "name": "flatMap",
+                "type": "<U, This = undefined>(callback: (this: This, value: number, index: number, array: number[]) => U | readonly U[], thisArg?: This | undefined) => U[]",
+                "required": true,
+                "description": "Calls a defined callback function on each element of an array. Then, flattens the result into a new array. This is identical to a map followed by flat with depth 1."
+              },
+              {
+                "name": "flat",
+                "type": "<A, D extends number = 1>(this: A, depth?: D | undefined) => FlatArray<A, D>[]",
+                "required": true,
+                "description": "Returns a new array with all sub-array elements concatenated into it recursively up to the specified depth."
+              },
+              {
+                "name": "at",
+                "type": "(index: number) => number",
+                "required": true,
+                "description": "Returns the item located at the specified index."
+              },
+              {
+                "name": "__@iterator@12750",
+                "type": "() => ArrayIterator<number>",
+                "required": true,
+                "description": "Iterator"
+              },
+              {
+                "name": "__@unscopables@12780",
+                "type": "{ [x: number]: boolean | undefined; length?: boolean | undefined; toString?: boolean | undefined; toLocaleString?: boolean | undefined; pop?: boolean | undefined; push?: boolean | undefined; concat?: boolean | undefined; join?: boolean | undefined; reverse?: boolean | undefined; shift?: boolean | undefined; slice?: boolean | undefined; sort?: boolean | undefined; splice?: boolean | undefined; unshift?: boolean | undefined; indexOf?: boolean | undefined; lastIndexOf?: boolean | undefined; every?: boolean | undefined; some?: boolean | undefined; forEach?: boolean | undefined; map?: boolean | undefined; filter?: boolean | undefined; reduce?: boolean | undefined; reduceRight?: boolean | undefined; find?: boolean | undefined; findIndex?: boolean | undefined; fill?: boolean | undefined; copyWithin?: boolean | undefined; entries?: boolean | undefined; keys?: boolean | undefined; values?: boolean | undefined; includes?: boolean | undefined; flatMap?: boolean | undefined; flat?: boolean | undefined; at?: boolean | undefined; [Symbol.iterator]?: boolean | undefined; readonly [Symbol.unscopables]?: boolean | undefined; }",
+                "required": true,
+                "description": "Is an object whose properties have the value 'true' when they will be absent when used in a 'with' statement."
+              }
+            ]
+          }
+        },
+        {
+          "name": "title",
+          "type": "ReactNode",
+          "required": false
+        },
+        {
+          "name": "description",
+          "type": "ReactNode",
+          "required": false
+        },
+        {
+          "name": "onClose",
+          "type": "(() => void)",
+          "required": false,
+          "description": "Shows a close button when given."
+        },
+        {
+          "name": "offset",
+          "type": "number",
+          "required": false,
+          "default": 48,
+          "description": "Gap between the place and the pointer tip, in px. Defaults to 48 (above a pin); use 14 for a dot."
+        },
+        {
+          "name": "pointer",
+          "type": "boolean",
+          "required": false,
+          "default": true
+        },
+        {
+          "name": "glide",
+          "type": "number",
+          "required": false,
+          "description": "Milliseconds to follow a moving `position`; use the same value as the marker it points at."
+        },
+        {
+          "name": "children",
+          "type": "ReactNode",
+          "required": false,
+          "description": "Extra content under the description (actions, a thumbnail...)."
+        },
+        {
+          "name": "className",
+          "type": "string",
+          "required": false
+        }
+      ],
+      "contract": {
+        "requiredProps": [
+          "position"
+        ],
+        "requiresAccessibleName": false
+      },
+      "since": "0.11.0",
+      "example": "import { MapPopup } from '@sakaniui/react';\n\n<MapPopup position={[1, 1]} />",
+      "aliases": [
+        "map tooltip",
+        "info window",
+        "marker popup"
+      ]
+    },
     {
       "name": "Marquee",
       "kind": "component",
@@ -11229,6 +12808,12 @@
       "kind": "hook",
       "import": "@sakaniui/react",
       "since": "0.4.0"
+    },
+    {
+      "name": "useMapContext",
+      "kind": "hook",
+      "import": "@sakaniui/react",
+      "since": "0.11.0"
     }
   ]
 }