@unmap/sdk 0.9.1 → 0.12.0

package/README.md

@@ -26,6 +26,21 @@ await unmap.router.route([-114.07, 51.05], [-113.99, 51.05], { mode: 'bicycle' }
 await unmap.router.isochrone([-114.07, 51.05], { minutes: [10, 20] })
 ```
 
+## Without a build step
+
+The same SDK loads from a script tag, with MapLibre already inside it:
+
+```html
+<link rel="stylesheet" href="https://cdn.unmap.dev/sdk/0.12.0/unmap.css">
+<div id="map" style="height: 400px"></div>
+<script src="https://cdn.unmap.dev/sdk/0.12.0/unmap.js"></script>
+<script>
+  unmap.createMap({ key: 'um_live_...', container: '#map', center: [-114.07, 51.05] })
+</script>
+```
+
+Everything above is on the `unmap` global: `unmap.Unmap`, `unmap.Geocoder`, `unmap.Router`, `unmap.maplibregl`. Pin the exact version in production; `/sdk/0.12/` follows patches and `/sdk/latest/` follows everything.
+
 ## Options
 
 | Option      | Type                    | Notes                                                                        |

package/dist/index.d.ts

@@ -1,13 +1,17 @@
-import { Map, UnmapMapOptions, UnmapControlsOptions } from '@unmap/maps';
-export { DEMO_CITIES, DemoCity, Map, Projection, STYLE_NAMES, StyleInput, StyleName, UnmapControlsOptions, UnmapMapOptions, createMap, maplibregl, unmapStyle } from '@unmap/maps';
-import { Geocoder } from '@unmap/geocoding';
+import { Map, MapProfile, UnmapMapOptions, UnmapControlsOptions } from '@unmap/maps';
+export { DEMO_CITIES, DemoCity, Map, MapProfile, Projection, STYLE_NAMES, StyleInput, StyleName, UnmapControlsOptions, UnmapMapOptions, createMap, maplibregl, unmapStyle } from '@unmap/maps';
+import { Geocoder, QueryOptions, QueryResponse, IdentifyOptions, IdentifyResponse } from '@unmap/geocoding';
 export * from '@unmap/geocoding';
 import { Router } from '@unmap/routing';
 export * from '@unmap/routing';
+import { Elevation } from '@unmap/elevation';
+export * from '@unmap/elevation';
 
 interface UnmapOptions {
     key: string;
     gateway?: string;
+    /** Override the fetch implementation (tests, non-global environments). */
+    fetch?: typeof fetch;
     /** If provided, a map is mounted in this container. */
     container?: string | HTMLElement;
     style?: string;
@@ -18,6 +22,10 @@ interface UnmapOptions {
     lang?: string;
     /** Compact `ut1.` theme code from unmap.dev/create. Wins over the path style on the gateway. */
     theme?: string;
+    /** Catalog layer ids composed onto the style (`municipalities`, `survey.dls`, …). */
+    overlays?: readonly string[];
+    /** Composition preset. Not a style. Explicit overlays replace the profile list. */
+    profile?: MapProfile;
     /** `"globe"` or `"mercator"`. See `@unmap/maps` `UnmapMapOptions.projection`. */
     projection?: UnmapMapOptions["projection"];
     center?: [number, number];
@@ -27,15 +35,21 @@ interface UnmapOptions {
 }
 /**
  * One Stripe-style key, the whole platform. With a `container` you get a rendered map;
- * `geocoder` and `router` are always available.
+ * `geocoder`, `router` and `elevation` are always available.
  *
  *   const map = new Unmap({ key: "um_live_...", container: "#map", center: [-75.69, 45.42] });
  */
 declare class Unmap {
     readonly geocoder: Geocoder;
     readonly router: Router;
+    readonly elevation: Elevation;
+    readonly data: {
+        query(opts: QueryOptions): Promise<QueryResponse>;
+    };
     readonly map?: Map;
     constructor(opts: UnmapOptions);
+    /** Which catalog features contain a point. See `Geocoder.identify`. */
+    identify(opts: IdentifyOptions): Promise<IdentifyResponse>;
 }
 
 export { Unmap, type UnmapOptions };

package/dist/index.js

@@ -4,20 +4,30 @@ import {
 } from "@unmap/maps";
 import { Geocoder } from "@unmap/geocoding";
 import { Router } from "@unmap/routing";
+import { Elevation } from "@unmap/elevation";
 export * from "@unmap/geocoding";
 export * from "@unmap/routing";
+export * from "@unmap/elevation";
 import { createMap as createMap2, unmapStyle, DEMO_CITIES, STYLE_NAMES, maplibregl } from "@unmap/maps";
 var Unmap = class {
   geocoder;
   router;
+  elevation;
+  data;
   map;
   constructor(opts) {
     this.geocoder = new Geocoder(opts);
     this.router = new Router(opts);
+    this.elevation = new Elevation(opts);
+    this.data = { query: (queryOpts) => this.geocoder.queryLayer(queryOpts) };
     if (opts.container) {
       this.map = createMap({ ...opts, container: opts.container });
     }
   }
+  /** Which catalog features contain a point. See `Geocoder.identify`. */
+  identify(opts) {
+    return this.geocoder.identify(opts);
+  }
 };
 export {
   DEMO_CITIES,

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import {\n  createMap,\n  type Map as MaplibreMap,\n  type UnmapControlsOptions,\n  type UnmapMapOptions,\n} from \"@unmap/maps\";\nimport { Geocoder } from \"@unmap/geocoding\";\nimport { Router } from \"@unmap/routing\";\n\nexport * from \"@unmap/geocoding\";\nexport * from \"@unmap/routing\";\nexport { createMap, unmapStyle, DEMO_CITIES, STYLE_NAMES, maplibregl } from \"@unmap/maps\";\nexport type {\n  Map,\n  UnmapMapOptions,\n  UnmapControlsOptions,\n  DemoCity,\n  StyleName,\n  StyleInput,\n  Projection,\n} from \"@unmap/maps\";\n\nexport interface UnmapOptions {\n  key: string;\n  gateway?: string;\n  /** If provided, a map is mounted in this container. */\n  container?: string | HTMLElement;\n  style?: string;\n  flavor?: string;\n  /** \"light\" or \"dark\". Selects the mode half of the named style. */\n  mode?: string;\n  /** Label language, e.g. \"fr\". Omit to follow the request's Accept-Language. */\n  lang?: string;\n  /** Compact `ut1.` theme code from unmap.dev/create. Wins over the path style on the gateway. */\n  theme?: string;\n  /** `\"globe\"` or `\"mercator\"`. See `@unmap/maps` `UnmapMapOptions.projection`. */\n  projection?: UnmapMapOptions[\"projection\"];\n  center?: [number, number];\n  zoom?: number;\n  /** On-map controls. `true` (the default) adds zoom and compass buttons; `false` adds none. */\n  controls?: boolean | UnmapControlsOptions;\n}\n\n/**\n * One Stripe-style key, the whole platform. With a `container` you get a rendered map;\n * `geocoder` and `router` are always available.\n *\n *   const map = new Unmap({ key: \"um_live_...\", container: \"#map\", center: [-75.69, 45.42] });\n */\nexport class Unmap {\n  readonly geocoder: Geocoder;\n  readonly router: Router;\n  readonly map?: MaplibreMap;\n\n  constructor(opts: UnmapOptions) {\n    this.geocoder = new Geocoder(opts);\n    this.router = new Router(opts);\n    if (opts.container) {\n      this.map = createMap({ ...opts, container: opts.container } as UnmapMapOptions);\n    }\n  }\n}\n"],"mappings":";AAAA;AAAA,EACE;AAAA,OAIK;AACP,SAAS,gBAAgB;AACzB,SAAS,cAAc;AAEvB,cAAc;AACd,cAAc;AACd,SAAS,aAAAA,YAAW,YAAY,aAAa,aAAa,kBAAkB;AAsCrE,IAAM,QAAN,MAAY;AAAA,EACR;AAAA,EACA;AAAA,EACA;AAAA,EAET,YAAY,MAAoB;AAC9B,SAAK,WAAW,IAAI,SAAS,IAAI;AACjC,SAAK,SAAS,IAAI,OAAO,IAAI;AAC7B,QAAI,KAAK,WAAW;AAClB,WAAK,MAAM,UAAU,EAAE,GAAG,MAAM,WAAW,KAAK,UAAU,CAAoB;AAAA,IAChF;AAAA,EACF;AACF;","names":["createMap"]}
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import {\n  createMap,\n  type Map as MaplibreMap,\n  type MapProfile,\n  type UnmapControlsOptions,\n  type UnmapMapOptions,\n} from \"@unmap/maps\";\nimport { Geocoder, type IdentifyOptions, type IdentifyResponse, type QueryOptions, type QueryResponse } from \"@unmap/geocoding\";\nimport { Router } from \"@unmap/routing\";\nimport { Elevation } from \"@unmap/elevation\";\n\nexport * from \"@unmap/geocoding\";\nexport * from \"@unmap/routing\";\nexport * from \"@unmap/elevation\";\nexport { createMap, unmapStyle, DEMO_CITIES, STYLE_NAMES, maplibregl } from \"@unmap/maps\";\nexport type {\n  Map,\n  UnmapMapOptions,\n  UnmapControlsOptions,\n  DemoCity,\n  StyleName,\n  StyleInput,\n  Projection,\n  MapProfile,\n} from \"@unmap/maps\";\n\nexport interface UnmapOptions {\n  key: string;\n  gateway?: string;\n  /** Override the fetch implementation (tests, non-global environments). */\n  fetch?: typeof fetch;\n  /** If provided, a map is mounted in this container. */\n  container?: string | HTMLElement;\n  style?: string;\n  flavor?: string;\n  /** \"light\" or \"dark\". Selects the mode half of the named style. */\n  mode?: string;\n  /** Label language, e.g. \"fr\". Omit to follow the request's Accept-Language. */\n  lang?: string;\n  /** Compact `ut1.` theme code from unmap.dev/create. Wins over the path style on the gateway. */\n  theme?: string;\n  /** Catalog layer ids composed onto the style (`municipalities`, `survey.dls`, …). */\n  overlays?: readonly string[];\n  /** Composition preset. Not a style. Explicit overlays replace the profile list. */\n  profile?: MapProfile;\n  /** `\"globe\"` or `\"mercator\"`. See `@unmap/maps` `UnmapMapOptions.projection`. */\n  projection?: UnmapMapOptions[\"projection\"];\n  center?: [number, number];\n  zoom?: number;\n  /** On-map controls. `true` (the default) adds zoom and compass buttons; `false` adds none. */\n  controls?: boolean | UnmapControlsOptions;\n}\n\n/**\n * One Stripe-style key, the whole platform. With a `container` you get a rendered map;\n * `geocoder`, `router` and `elevation` are always available.\n *\n *   const map = new Unmap({ key: \"um_live_...\", container: \"#map\", center: [-75.69, 45.42] });\n */\nexport class Unmap {\n  readonly geocoder: Geocoder;\n  readonly router: Router;\n  readonly elevation: Elevation;\n  readonly data: { query(opts: QueryOptions): Promise<QueryResponse> };\n  readonly map?: MaplibreMap;\n\n  constructor(opts: UnmapOptions) {\n    this.geocoder = new Geocoder(opts);\n    this.router = new Router(opts);\n    this.elevation = new Elevation(opts);\n    this.data = { query: (queryOpts) => this.geocoder.queryLayer(queryOpts) };\n    if (opts.container) {\n      this.map = createMap({ ...opts, container: opts.container } as UnmapMapOptions);\n    }\n  }\n\n  /** Which catalog features contain a point. See `Geocoder.identify`. */\n  identify(opts: IdentifyOptions): Promise<IdentifyResponse> {\n    return this.geocoder.identify(opts);\n  }\n}\n"],"mappings":";AAAA;AAAA,EACE;AAAA,OAKK;AACP,SAAS,gBAAoG;AAC7G,SAAS,cAAc;AACvB,SAAS,iBAAiB;AAE1B,cAAc;AACd,cAAc;AACd,cAAc;AACd,SAAS,aAAAA,YAAW,YAAY,aAAa,aAAa,kBAAkB;AA6CrE,IAAM,QAAN,MAAY;AAAA,EACR;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EAET,YAAY,MAAoB;AAC9B,SAAK,WAAW,IAAI,SAAS,IAAI;AACjC,SAAK,SAAS,IAAI,OAAO,IAAI;AAC7B,SAAK,YAAY,IAAI,UAAU,IAAI;AACnC,SAAK,OAAO,EAAE,OAAO,CAAC,cAAc,KAAK,SAAS,WAAW,SAAS,EAAE;AACxE,QAAI,KAAK,WAAW;AAClB,WAAK,MAAM,UAAU,EAAE,GAAG,MAAM,WAAW,KAAK,UAAU,CAAoB;AAAA,IAChF;AAAA,EACF;AAAA;AAAA,EAGA,SAAS,MAAkD;AACzD,WAAO,KAAK,SAAS,SAAS,IAAI;AAAA,EACpC;AACF;","names":["createMap"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unmap/sdk",
-  "version": "0.9.1",
+  "version": "0.12.0",
   "description": "One key, the whole unmap platform: map + geocoder + router",
   "license": "MIT",
   "keywords": [
@@ -40,10 +40,11 @@
   },
   "dependencies": {
     "maplibre-gl": "^6.7.0",
-    "@unmap/maps": "0.9.1",
-    "@unmap/geocoding": "0.9.1",
-    "@unmap/routing": "0.9.1",
-    "@unmap/core": "0.9.1"
+    "@unmap/core": "0.12.0",
+    "@unmap/elevation": "0.12.0",
+    "@unmap/geocoding": "0.12.0",
+    "@unmap/maps": "0.12.0",
+    "@unmap/routing": "0.12.0"
   },
   "devDependencies": {
     "tsup": "^8.3.0",