@maptoolkit/maplibre-scene3d-control 0.3.2 → 0.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -6,7 +6,11 @@ var t = "maptoolkit:scene3d", n = {
6
6
  minzoom: 12,
7
7
  hideLayers: ["building_3d", "building_3d_multicolored"],
8
8
  idPrefix: "scene3d-"
9
- }, r = "<svg viewBox=\"0 0 24 24\" aria-hidden=\"true\"><path fill=\"currentColor\" d=\"M12 2 3 7v10l9 5 9-5V7l-9-5Zm0 2.3L18.7 8 12 11.7 5.3 8 12 4.3ZM5 9.7l6 3.3v6.7l-6-3.4V9.7Zm8 10V13l6-3.3v6.6l-6 3.4Z\"/></svg>", i = (e) => e.style, a = (e) => e ? JSON.stringify(e) : null, o = (e) => e ? `${e.source}|${e.exaggeration ?? 1}` : null, s = (e) => !!(e.lod1 || e.fill3d), c = class extends e {
9
+ }, r = "<svg viewBox=\"0 0 24 24\" aria-hidden=\"true\"><path fill=\"currentColor\" d=\"M12 2 3 7v10l9 5 9-5V7l-9-5Zm0 2.3L18.7 8 12 11.7 5.3 8 12 4.3ZM5 9.7l6 3.3v6.7l-6-3.4V9.7Zm8 10V13l6-3.3v6.6l-6 3.4Z\"/></svg>", i = (e) => e.style, a = (e) => e ? JSON.stringify(e) : null, o = (e) => e ? `${e.source}|${e.exaggeration ?? 1}` : null, s = (e) => !!(e.lod1 || e.fill3d), c = (e) => s(e) || !!e.landmarks, l = [
10
+ "==",
11
+ ["get", "source"],
12
+ "landmark"
13
+ ], u = class extends e {
10
14
  options;
11
15
  map;
12
16
  container;
@@ -49,7 +53,9 @@ var t = "maptoolkit:scene3d", n = {
49
53
  let e = document.createElement("button");
50
54
  e.type = "button", e.className = "maplibre-scene3d-control-toggle", e.title = "3D", e.setAttribute("aria-label", "3D"), e.innerHTML = r, e.addEventListener("click", () => this.setEnabled(!this.enabled)), t.appendChild(e), this.button = e, this.showState();
51
55
  } else t.classList.add("maplibre-scene3d-control-hidden");
52
- return this.container = t, e.on("style.load", this.onStyleLoad), e.on("styledata", this.onStyleData), e.on("terrain", this.onTerrain), e.on("pitch", this.syncPitch), e.on("zoomend", this.onZoom), i(e)?._loaded && this.onStyleLoad(), t;
56
+ this.container = t;
57
+ let n = e.getCanvas?.(), a = n?.getContext?.("webgl2") ?? n?.getContext?.("webgl");
58
+ return a && a.getContextAttributes?.()?.antialias === !1 && this.warnOnce("antialias", "Scene3dControl: the map's WebGL context has no multisampling, so the 3D buildings and trees get pixelated edges. Create the map with canvasContextAttributes: { antialias: true }."), e.on("style.load", this.onStyleLoad), e.on("styledata", this.onStyleData), e.on("terrain", this.onTerrain), e.on("pitch", this.syncPitch), e.on("zoomend", this.onZoom), i(e)?._loaded && this.onStyleLoad(), t;
53
59
  }
54
60
  onRemove() {
55
61
  let e = this.map;
@@ -97,7 +103,7 @@ var t = "maptoolkit:scene3d", n = {
97
103
  }
98
104
  this.sceneRef = t;
99
105
  }
100
- this.scene && (this.custom.some((t) => !e.getLayer(t.id)) ? this.refresh() : this.native.some((t) => !e.getLayer(t)) || s(this.scene) && !e.getSource(this.sourceId()) ? this.restoreNative() : this.syncPitch());
106
+ this.scene && (this.custom.some((t) => !e.getLayer(t.id)) ? this.refresh() : this.native.some((t) => !e.getLayer(t)) || c(this.scene) && !e.getSource(this.sourceId()) ? this.restoreNative() : this.syncPitch());
101
107
  }
102
108
  onTerrain = () => {
103
109
  this.map && this.styleReady() && this.custom.length && this.scene && o(this.map.getTerrain()) !== this.terrainKey && (this.removeCustom(), this.addCustom(this.scene, this.generation));
@@ -144,7 +150,7 @@ var t = "maptoolkit:scene3d", n = {
144
150
  }
145
151
  addNative(e, t = (e, t) => t) {
146
152
  let n = this.map, r = this.sourceId();
147
- if (!s(e)) return;
153
+ if (!c(e)) return;
148
154
  n.getSource(r) || n.addSource(r, {
149
155
  type: "vector",
150
156
  url: this.withKey(e.source)
@@ -159,14 +165,14 @@ var t = "maptoolkit:scene3d", n = {
159
165
  "source-layer": "buildings2d",
160
166
  ...a
161
167
  }, o(t)), this.native.push(`${i}lod1`);
162
- } else e.fill3d && (n.addLayer({
168
+ } else n.addLayer({
163
169
  id: `${i}consumer`,
164
170
  type: "fill",
165
171
  source: r,
166
172
  "source-layer": "buildings2d",
167
173
  filter: ["boolean", !1],
168
174
  paint: { "fill-opacity": 0 }
169
- }, o(e.fill3d.position)), this.native.push(`${i}consumer`));
175
+ }, o((e.fill3d ?? e.landmarks)?.position)), this.native.push(`${i}consumer`);
170
176
  }
171
177
  restoreNative() {
172
178
  let e = this.map, t = this.scene;
@@ -193,23 +199,39 @@ var t = "maptoolkit:scene3d", n = {
193
199
  };
194
200
  this.building = !0;
195
201
  try {
202
+ let t = e.landmarks ? e.landmarks.filter ?? l : void 0;
196
203
  if (e.fill3d) {
197
- let { position: t, ...n } = e.fill3d;
204
+ let { position: n, ...i } = e.fill3d, o = t && [
205
+ "all",
206
+ ...i.filter ? [i.filter] : [],
207
+ ["!", t]
208
+ ];
198
209
  s(new r.Fill3DLayer({
199
210
  id: `${a}fill3d`,
200
211
  source: this.sourceId(),
201
212
  "source-layer": "buildings3d",
202
- ...n
203
- }), t);
213
+ ...i,
214
+ ...o ? { filter: o } : {}
215
+ }), n);
204
216
  }
205
- let t = e.models ?? {};
206
- for (let i of e.gltf ?? []) {
207
- let { id: e, position: o, models: c, ...l } = i;
217
+ if (e.landmarks) {
218
+ let { position: n, ...i } = e.landmarks;
219
+ s(new r.Fill3DLayer({
220
+ id: `${a}landmarks`,
221
+ source: this.sourceId(),
222
+ "source-layer": "buildings3d",
223
+ ...i,
224
+ filter: t
225
+ }), n);
226
+ }
227
+ let i = e.models ?? {};
228
+ for (let t of e.gltf ?? []) {
229
+ let { id: e, position: o, models: c, ...l } = t;
208
230
  if (!n.getSource(l.source)) {
209
231
  this.warnOnce(`source-${l.source}`, `Scene3dControl: the style has no source "${l.source}", layer "${e}" left out`);
210
232
  continue;
211
233
  }
212
- let u = c ?? Object.keys(t), d = Object.fromEntries(u.filter((e) => t[e]).map((e) => [e, this.modelUrl(t[e])]));
234
+ let u = c ?? Object.keys(i), d = Object.fromEntries(u.filter((e) => i[e]).map((e) => [e, this.modelUrl(i[e])]));
213
235
  Object.keys(d).length && s(new r.GltfLayer({
214
236
  id: `${a}${e}`,
215
237
  models: d,
@@ -265,6 +287,6 @@ var t = "maptoolkit:scene3d", n = {
265
287
  this.warned.has(e) || (this.warned.add(e), console.warn(t));
266
288
  }
267
289
  };
268
- export { t as SCENE3D_METADATA_KEY, c as Scene3dControl };
290
+ export { t as SCENE3D_METADATA_KEY, u as Scene3dControl };
269
291
 
270
292
  //# sourceMappingURL=maplibre-scene3d-control.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"maplibre-scene3d-control.js","names":["SCENE3D_METADATA_KEY","DEFAULTS","CUBE_ICON","styleOf","map","sceneKeyOf","scene","terrainKeyOf","terrain","hasBuildings","Scene3dControl","Evented","rest","options","v","container","button","response","enabled","lib","err","next","l","id","pitch","sheet","generation","position","anchor","before","source","p","place","lod1","add","layer","fill3d","library","entry","ids","picked","models","m","restore","visibility","onData","e","url","u","key","message"],"sources":["../src/Scene3dControl.ts"],"sourcesContent":["import { Evented } from \"maplibre-gl\";\nimport type { ControlPosition, CustomLayerInterface, FilterSpecification, IControl, Map as MaplibreMap, MapLibreEvent, MapSourceDataEvent } from \"maplibre-gl\";\n\n/** Root metadata key under which a Maptoolkit style carries its 3D scene. */\nexport const SCENE3D_METADATA_KEY = \"maptoolkit:scene3d\";\n\n/**\n * Where a layer of the scene goes: under the style's labels (`\"below-labels\"`, the default: right below its first\n * symbol layer), on top of everything (`\"top\"`), or right below the style layer with that id. The position only\n * decides what draws over the 3D among symbol layers (labels, icons); fills and lines always end up under it. A\n * layer id the style lacks falls back to `\"below-labels\"`.\n */\nexport type Scene3dPosition = \"below-labels\" | \"top\" | (string & {});\n\ntype Expression = unknown;\n\n/** One glTF vegetation layer: maplibre-3d-layers `GltfLayer` options, `models` as ids of the scene's model library. */\nexport interface Scene3dGltfLayer {\n id: string;\n position?: Scene3dPosition;\n /** Model ids from {@link Scene3dManifest.models}; all of them when missing. */\n models?: string[];\n source: string;\n \"source-layer\"?: string;\n filter?: FilterSpecification;\n minzoom?: number;\n maxzoom?: number;\n layout?: Record<string, Expression>;\n paint?: Record<string, Expression>;\n lighting?: { ambient?: number; directional?: number; environment?: number };\n maxInstances?: number;\n doubleSided?: boolean;\n}\n\n/** The 3D scene of a style, `metadata[\"maptoolkit:scene3d\"]` (version 1). Values are plain MapLibre / maplibre-3d-layers options. */\nexport interface Scene3dManifest {\n version: 1;\n /** TileJSON URL of the buildings source, without api_key. */\n source: string;\n /** `fill-extrusion` on the source layer `buildings2d`. */\n lod1?: {\n position?: Scene3dPosition;\n minzoom?: number;\n maxzoom?: number;\n filter?: FilterSpecification;\n paint?: Record<string, Expression>;\n layout?: Record<string, Expression>;\n };\n /** `Fill3DLayer` on the source layer `buildings3d`. */\n fill3d?: { position?: Scene3dPosition; filter?: FilterSpecification; paint?: Record<string, Expression> };\n /** Model library of the vegetation: id → glTF/glb URL. */\n models?: Record<string, string>;\n gltf?: Scene3dGltfLayer[];\n}\n\n/** What the control needs from `@maptoolkit/maplibre-3d-layers`. */\nexport interface Scene3dLibrary {\n Fill3DLayer: new (options: Record<string, unknown>) => CustomLayerInterface;\n GltfLayer: new (options: Record<string, unknown>) => CustomLayerInterface;\n}\n\nexport interface Scene3dControlOptions {\n /** Maptoolkit API key, added to the buildings source URL as `api_key`. */\n apiKey?: string;\n /**\n * The scene to show. Left out: the one the current style names in `metadata[\"maptoolkit:scene3d\"]`,\n * re-read on every style change. A manifest or its URL replaces it; `null` shows none.\n */\n scene?: Scene3dManifest | string | null;\n /** Show the scene right away (default `true`). */\n enabled?: boolean;\n /** Add a 3D button that switches the scene on and off (default `false`: the control has no UI). */\n button?: boolean;\n /** The 3D library is loaded once the map reaches this zoom; the buildings source has no tiles below 12 (default `12`). */\n minzoom?: number;\n /**\n * Style layers hidden while the scene's buildings are shown, e.g. a style's own 3D buildings (default the v2 ids\n * `building_3d`, `building_3d_multicolored`). Hidden only once the buildings source has loaded, so without a working\n * API key the style keeps them.\n */\n hideLayers?: string[];\n /** Base for relative model URLs (default the document's base URL). */\n modelBase?: string;\n /** Loads `@maptoolkit/maplibre-3d-layers` (default a dynamic import of the package). Pass another loader for its standalone build or a CDN. */\n library?: () => Promise<Scene3dLibrary>;\n /** Prefix of the source and layer ids the control adds (default `\"scene3d-\"`). */\n idPrefix?: string;\n}\n\n/** Fired via `control.on(\"scene.change\", ...)` whenever the shown scene is (re)built or removed. */\nexport type Scene3dControlEventType = {\n \"scene.change\": MapLibreEvent<\"scene.change\"> & { scene: Scene3dManifest | null };\n};\n\ntype ResolvedOptions = Required<Omit<Scene3dControlOptions, \"apiKey\" | \"scene\" | \"modelBase\">> & Pick<Scene3dControlOptions, \"apiKey\" | \"modelBase\">;\n\nconst DEFAULTS: Omit<ResolvedOptions, \"library\"> = {\n enabled: true,\n button: false,\n minzoom: 12,\n hideLayers: [\"building_3d\", \"building_3d_multicolored\"],\n idPrefix: \"scene3d-\",\n};\n\nconst CUBE_ICON =\n '<svg viewBox=\"0 0 24 24\" aria-hidden=\"true\"><path fill=\"currentColor\" d=\"M12 2 3 7v10l9 5 9-5V7l-9-5Zm0 2.3L18.7 8 12 11.7 5.3 8 12 4.3ZM5 9.7l6 3.3v6.7l-6-3.4V9.7Zm8 10V13l6-3.3v6.6l-6 3.4Z\"/></svg>';\n\n// MapLibre's Style is private API; the control only reads whether it has loaded and its identity.\ntype StyleHandle = { _loaded?: boolean } | undefined;\nconst styleOf = (map: MaplibreMap) => (map as unknown as { style?: StyleHandle }).style;\n/** Compares scenes across style updates: the metadata comes as a new object each time. */\nconst sceneKeyOf = (scene: Scene3dManifest | null) => (scene ? JSON.stringify(scene) : null);\n/** Source and exaggeration of a terrain, to tell a real change from a repeated setTerrain. */\nconst terrainKeyOf = (terrain: { source: string; exaggeration?: number } | null | undefined) =>\n terrain ? `${terrain.source}|${terrain.exaggeration ?? 1}` : null;\n/** Whether a scene draws buildings, i.e. needs its buildings source. */\nconst hasBuildings = (scene: Scene3dManifest) => !!(scene.lod1 || scene.fill3d);\n\n/**\n * A MapLibre GL JS control plugin that adds the 3D scene of a Maptoolkit style: 3D buildings\n * (a `fill-extrusion` plus maplibre-3d-layers' `Fill3DLayer`) and glTF vegetation (`GltfLayer`).\n *\n * The scene comes from the style itself (`metadata[\"maptoolkit:scene3d\"]`, written by style-family-js),\n * so a style switch brings its own scene. The control keeps the tilt in the global state `pitch`\n * that the scene's opacity fades read, puts the layers under the style's labels, rebuilds them after\n * style and terrain changes and loads the 3D library only when the map gets close enough.\n */\nexport class Scene3dControl extends Evented<Scene3dControlEventType> implements IControl {\n readonly options: ResolvedOptions;\n\n private map?: MaplibreMap;\n private container?: HTMLElement;\n private button?: HTMLButtonElement;\n private enabled: boolean;\n /** undefined: the style's own scene. */\n private override: Scene3dManifest | null | undefined;\n private scene: Scene3dManifest | null = null;\n private lib?: Scene3dLibrary;\n private libPromise?: Promise<Scene3dLibrary>;\n private custom: CustomLayerInterface[] = [];\n private native: string[] = [];\n private hidden = new Map<string, \"visible\" | \"none\">();\n private loadedStyle: StyleHandle = undefined;\n private pitch: number | null = null;\n private building = false;\n private generation = 0;\n private warned = new Set<string>();\n /** Stops waiting for the buildings source (see hideOnceBuildingsLoad). */\n private stopWaiting?: () => void;\n /** The scene last read from the style or override (also an unsupported one), and as JSON; null for none. */\n private sceneRef: Scene3dManifest | null = null;\n private sceneKey: string | null = null;\n /** Whether the buildings source of the current scene has loaded (its TileJSON answered). */\n private sourceOk = false;\n /** The position each custom layer was added with (`\"below-labels\"` when the scene names none). */\n private customPosition = new Map<string, Scene3dPosition>();\n /** The terrain the 3D layers were built with (source and exaggeration), see onTerrain. */\n private terrainKey: string | null = null;\n\n constructor(options: Scene3dControlOptions = {}) {\n super();\n const { scene, ...rest } = options;\n this.options = {\n ...DEFAULTS,\n library: () => import(\"@maptoolkit/maplibre-3d-layers\") as unknown as Promise<Scene3dLibrary>,\n ...Object.fromEntries(Object.entries(rest).filter(([, v]) => v !== undefined)),\n } as ResolvedOptions;\n this.enabled = this.options.enabled;\n if (scene !== undefined) void this.setScene(scene);\n }\n\n getDefaultPosition(): ControlPosition {\n return \"top-right\";\n }\n\n onAdd(map: MaplibreMap): HTMLElement {\n this.map = map;\n const container = document.createElement(\"div\");\n container.className = \"maplibregl-ctrl maplibregl-ctrl-group maplibre-scene3d-control\";\n if (this.options.button) {\n const button = document.createElement(\"button\");\n button.type = \"button\";\n button.className = \"maplibre-scene3d-control-toggle\";\n button.title = \"3D\";\n button.setAttribute(\"aria-label\", \"3D\");\n button.innerHTML = CUBE_ICON;\n button.addEventListener(\"click\", () => this.setEnabled(!this.enabled));\n container.appendChild(button);\n this.button = button;\n this.showState();\n } else {\n container.classList.add(\"maplibre-scene3d-control-hidden\");\n }\n this.container = container;\n\n map.on(\"style.load\", this.onStyleLoad);\n map.on(\"styledata\", this.onStyleData);\n map.on(\"terrain\", this.onTerrain);\n map.on(\"pitch\", this.syncPitch);\n map.on(\"zoomend\", this.onZoom);\n // Added to a map whose style has already loaded: no style.load will come for it.\n if (styleOf(map)?._loaded) this.onStyleLoad();\n return container;\n }\n\n onRemove(): void {\n const map = this.map;\n if (!map) return;\n this.teardown(true);\n map.off(\"style.load\", this.onStyleLoad);\n map.off(\"styledata\", this.onStyleData);\n map.off(\"terrain\", this.onTerrain);\n map.off(\"pitch\", this.syncPitch);\n map.off(\"zoomend\", this.onZoom);\n this.container?.remove();\n this.container = this.button = undefined;\n this.map = undefined;\n this.loadedStyle = undefined;\n }\n\n /**\n * Replace the style's scene: a manifest, the URL of one, `null` for none, or `undefined` to go back\n * to the style's own scene. The same scene again keeps the layers.\n *\n * MapLibre ignores a diffed `setStyle` that changes nothing but the metadata, so a scene that changes\n * on its own never reaches the control that way; pass it here (or use `setStyle` with `diff: false`).\n */\n async setScene(scene: Scene3dManifest | string | null | undefined): Promise<void> {\n if (typeof scene === \"string\") {\n const response = await fetch(new URL(scene, document.baseURI).href);\n if (!response.ok) throw new Error(`Scene ${scene}: HTTP ${response.status}`);\n scene = (await response.json()) as Scene3dManifest;\n }\n // The same scene again (e.g. after every style update of an editor) keeps the layers.\n if (scene !== undefined && this.override !== undefined && sceneKeyOf(scene) === sceneKeyOf(this.override)) return;\n this.override = scene;\n this.refresh();\n }\n\n /** The scene shown now, or null. */\n getScene(): Scene3dManifest | null {\n return this.scene;\n }\n\n setEnabled(enabled: boolean): void {\n if (this.enabled === enabled) return;\n this.enabled = enabled;\n this.showState();\n this.refresh();\n }\n\n isEnabled(): boolean {\n return this.enabled;\n }\n\n /** The maplibre-3d-layers layers on the map (`Fill3DLayer`, `GltfLayer`s), e.g. to drive them frame by frame. */\n getLayers(): CustomLayerInterface[] {\n return [...this.custom];\n }\n\n /** The 3D library, once loaded. */\n getLibrary(): Scene3dLibrary | undefined {\n return this.lib;\n }\n\n /** Load the 3D library now instead of waiting for `minzoom`. */\n loadLibrary(): Promise<Scene3dLibrary> {\n this.libPromise ??= this.options.library().then(\n (lib) => (this.lib = lib),\n (err) => {\n this.libPromise = undefined;\n throw err;\n },\n );\n return this.libPromise;\n }\n\n // ---------------------------------------------------------------- map events\n\n private onStyleLoad = () => {\n if (!this.map) return;\n this.pitch = null; // a new style, or a diffed one, starts with its own global state\n // MapLibre 6 fires style.load after a diffed setStyle too; the Style object stays the same then.\n if (styleOf(this.map) === this.loadedStyle) {\n this.syncWithStyle();\n return;\n }\n this.loadedStyle = styleOf(this.map);\n this.teardown(false); // whatever of the old scene a style diff left behind\n this.refresh();\n };\n\n private onStyleData = () => this.syncWithStyle();\n\n // A diffed setStyle (setStyle without { diff: false }) keeps the Style object. It drops our source\n // and native layers as \"not in the new style\" but keeps the custom layers (MapLibre never serializes\n // them), and it may bring another scene or none. Same scene: put the source and native layers back\n // and keep the 3D layers. Another scene: rebuild.\n private syncWithStyle() {\n if (this.building || !this.map || !this.styleReady()) return;\n const map = this.map;\n const next = this.currentScene();\n if (next !== this.sceneRef) {\n if (sceneKeyOf(next) !== this.sceneKey) {\n this.refresh();\n return;\n }\n this.sceneRef = next; // the same scene in a new object\n }\n if (!this.scene) return;\n if (this.custom.some((l) => !map.getLayer(l.id))) this.refresh();\n else if (this.native.some((id) => !map.getLayer(id)) || (hasBuildings(this.scene) && !map.getSource(this.sourceId()))) this.restoreNative();\n else this.syncPitch();\n }\n\n // The 3D layers take the terrain source and exaggeration as they are when they are added (heights\n // are sampled from the current terrain each pass). MapLibre fires `terrain` on every setTerrain, also\n // with the same options; rebuilding then would restart model loading each time (an app re-applying\n // its terrain after every style update kept the models loading for good).\n private onTerrain = () => {\n if (!this.map || !this.styleReady() || !this.custom.length || !this.scene) return;\n if (terrainKeyOf(this.map.getTerrain()) === this.terrainKey) return;\n this.removeCustom();\n this.addCustom(this.scene, this.generation);\n };\n\n private onZoom = () => {\n if (!this.map || this.lib || !this.scene || this.map.getZoom() < this.options.minzoom) return;\n this.loadCustom(this.scene, this.generation);\n };\n\n /** `[\"global-state\", \"pitch\"]` for the scene's opacity fades. Whole degrees: each change is a style update. */\n private syncPitch = () => {\n if (!this.map || !this.styleReady()) return;\n const pitch = Math.round(this.map.getPitch());\n if (pitch === this.pitch) return;\n this.pitch = pitch;\n this.map.setGlobalStateProperty(\"pitch\", pitch);\n };\n\n // ---------------------------------------------------------------- building\n\n private styleReady(): boolean {\n return !!this.map && !!this.loadedStyle && styleOf(this.map) === this.loadedStyle;\n }\n\n private currentScene(): Scene3dManifest | null {\n if (!this.enabled) return null;\n if (this.override !== undefined) return this.override;\n // Straight from the stylesheet MapLibre keeps: this runs on every styledata (every whole degree of\n // tilt, see syncPitch), and getStyle() clones every layer. getStyle() only as a fallback.\n const sheet = (this.map as unknown as { style?: { stylesheet?: { metadata?: unknown } } } | undefined)?.style?.stylesheet;\n const metadata = (sheet ? sheet.metadata : this.map?.getStyle()?.metadata) as Record<string, unknown> | undefined;\n return (metadata?.[SCENE3D_METADATA_KEY] as Scene3dManifest | undefined) ?? null;\n }\n\n private refresh() {\n const map = this.map;\n if (!map || !this.styleReady()) return;\n this.building = true;\n try {\n this.teardown(true);\n const generation = ++this.generation;\n let scene = this.currentScene();\n this.sceneRef = scene;\n this.sceneKey = sceneKeyOf(scene);\n if (scene && scene.version !== 1) {\n this.warnOnce(`version-${String(scene.version)}`, `Scene3dControl: unsupported scene version ${String(scene.version)}`);\n scene = null;\n }\n this.scene = scene;\n if (scene) {\n this.syncPitch();\n if (hasBuildings(scene)) this.hideOnceBuildingsLoad(generation);\n this.addNative(scene);\n if (this.lib) this.addCustom(scene, generation);\n else if (map.getZoom() >= this.options.minzoom) this.loadCustom(scene, generation);\n }\n } finally {\n this.building = false;\n }\n this.fire(\"scene.change\", { scene: this.scene });\n }\n\n private sourceId() {\n return `${this.options.idPrefix}buildings`;\n }\n\n /** The id of the style's first symbol layer: the scene goes right below it. */\n private labelsAnchor(): string | undefined {\n return this.map?.getStyle().layers.find((l) => l.type === \"symbol\" && !l.id.startsWith(this.options.idPrefix))?.id;\n }\n\n /** The layer a scene layer goes below for `position`: none for \"top\", the style layer it names, else `anchor`. */\n private beforeFor(position: Scene3dPosition | undefined, anchor: string | undefined) {\n if (position === \"top\") return undefined;\n if (!position || position === \"below-labels\") return anchor;\n if (!position.startsWith(this.options.idPrefix) && this.map?.getLayer(position)) return position;\n this.warnOnce(`position-${position}`, `Scene3dControl: the style has no layer \"${position}\", the scene goes under the labels`);\n return anchor;\n }\n\n /**\n * The buildings source and the native layers, each below the layer its position names. `place` can pick another\n * layer for a position (restoreNative: the 3D layers with the same position).\n */\n private addNative(scene: Scene3dManifest, place = (_position: Scene3dPosition, before: string | undefined) => before) {\n const map = this.map!;\n const source = this.sourceId();\n if (!hasBuildings(scene)) return; // trees only: no buildings source to load (or to answer 403 without a key)\n if (!map.getSource(source)) map.addSource(source, { type: \"vector\", url: this.withKey(scene.source) });\n const p = this.options.idPrefix;\n const anchor = this.labelsAnchor();\n const before = (position: Scene3dPosition | undefined) => place(position ?? \"below-labels\", this.beforeFor(position, anchor));\n if (scene.lod1) {\n const { position, ...lod1 } = scene.lod1;\n map.addLayer({ id: `${p}lod1`, type: \"fill-extrusion\", source, \"source-layer\": \"buildings2d\", ...lod1 } as never, before(position));\n this.native.push(`${p}lod1`);\n } else if (scene.fill3d) {\n // The Fill3DLayer reads tiles MapLibre only loads for a source a style layer uses.\n map.addLayer(\n { id: `${p}consumer`, type: \"fill\", source, \"source-layer\": \"buildings2d\", filter: [\"boolean\", false], paint: { \"fill-opacity\": 0 } },\n before(scene.fill3d.position),\n );\n this.native.push(`${p}consumer`);\n }\n }\n\n /** After a diffed setStyle with the same scene: put back the source and native layers, keep the 3D layers. */\n private restoreNative() {\n const map = this.map!;\n const scene = this.scene!;\n this.building = true;\n try {\n for (const id of this.native) if (map.getLayer(id)) map.removeLayer(id);\n this.native = [];\n // The new style set its own visibility on the layers we hide; remember that one.\n this.hidden.clear();\n // Under the 3D layers with the same position again, as in a full build.\n this.addNative(scene, (position, before) => this.custom.find((l) => this.customPosition.get(l.id) === position)?.id ?? before);\n if (hasBuildings(scene)) {\n if (this.sourceOk) this.hideStyleLayers();\n else {\n this.stopWaiting?.();\n this.hideOnceBuildingsLoad(this.generation);\n }\n }\n this.pitch = null;\n this.syncPitch();\n } finally {\n this.building = false;\n }\n }\n\n private loadCustom(scene: Scene3dManifest, generation: number) {\n this.loadLibrary().then(\n () => {\n if (generation === this.generation && this.scene === scene && !this.custom.length) this.addCustom(scene, generation);\n },\n (err) => console.error(\"Scene3dControl: could not load @maptoolkit/maplibre-3d-layers\", err),\n );\n }\n\n private addCustom(scene: Scene3dManifest, generation: number) {\n const map = this.map;\n const lib = this.lib;\n if (!map || !lib || generation !== this.generation || !this.styleReady()) return;\n const anchor = this.labelsAnchor();\n const p = this.options.idPrefix;\n this.terrainKey = terrainKeyOf(map.getTerrain());\n const add = (layer: CustomLayerInterface, position: Scene3dPosition | undefined) => {\n map.addLayer(layer, this.beforeFor(position, anchor));\n this.custom.push(layer);\n this.customPosition.set(layer.id, position ?? \"below-labels\");\n };\n this.building = true;\n try {\n if (scene.fill3d) {\n const { position, ...fill3d } = scene.fill3d;\n add(new lib.Fill3DLayer({ id: `${p}fill3d`, source: this.sourceId(), \"source-layer\": \"buildings3d\", ...fill3d }), position);\n }\n const library = scene.models ?? {};\n for (const entry of scene.gltf ?? []) {\n const { id, position, models: ids, ...options } = entry;\n if (!map.getSource(options.source)) {\n this.warnOnce(`source-${options.source}`, `Scene3dControl: the style has no source \"${options.source}\", layer \"${id}\" left out`);\n continue;\n }\n const picked = ids ?? Object.keys(library);\n const models = Object.fromEntries(picked.filter((m) => library[m]).map((m) => [m, this.modelUrl(library[m])]));\n if (!Object.keys(models).length) continue;\n add(new lib.GltfLayer({ id: `${p}${id}`, models, ...options }), position);\n }\n } finally {\n this.building = false;\n }\n }\n\n private removeCustom() {\n const map = this.map;\n for (const layer of this.custom) {\n if (map?.getLayer(layer.id)) map.removeLayer(layer.id);\n // A replaced style never calls onRemove; without it the layer keeps listening to the map.\n else if (map) layer.onRemove?.(map, undefined as unknown as WebGL2RenderingContext);\n }\n this.custom = [];\n this.customPosition.clear();\n }\n\n /** Remove everything the control added; `restore` puts hidden style layers back. */\n private teardown(restore: boolean) {\n const map = this.map;\n this.stopWaiting?.();\n this.building = true;\n try {\n this.removeCustom();\n if (map) {\n for (const id of this.native) if (map.getLayer(id)) map.removeLayer(id);\n if (map.getSource(this.sourceId()) && this.styleReady()) map.removeSource(this.sourceId());\n if (restore && this.styleReady()) {\n for (const [id, visibility] of this.hidden) if (map.getLayer(id)) map.setLayoutProperty(id, \"visibility\", visibility);\n }\n }\n this.native = [];\n this.hidden.clear();\n this.scene = null;\n this.sourceOk = false;\n } finally {\n this.building = false;\n }\n }\n\n /**\n * Hide the style's own 3D buildings (`hideLayers`) only once the scene's buildings source has\n * loaded. Without a working API key it answers 403, and the style keeps its buildings.\n */\n private hideOnceBuildingsLoad(generation: number) {\n const map = this.map!;\n const id = this.sourceId();\n const onData = (e: MapSourceDataEvent) => {\n // removeSource fires a metadata event too; the source is gone by then.\n if (e.sourceId !== id || e.sourceDataType !== \"metadata\" || !map.getSource(id)) return;\n this.stopWaiting?.();\n if (generation !== this.generation || !this.styleReady()) return;\n this.sourceOk = true;\n this.hideStyleLayers();\n };\n map.on(\"sourcedata\", onData);\n this.stopWaiting = () => {\n map.off(\"sourcedata\", onData);\n this.stopWaiting = undefined;\n };\n }\n\n private hideStyleLayers() {\n const map = this.map!;\n for (const id of this.options.hideLayers) {\n if (!map.getLayer(id)) continue;\n this.hidden.set(id, (map.getLayoutProperty(id, \"visibility\") as \"visible\" | \"none\" | undefined) ?? \"visible\");\n map.setLayoutProperty(id, \"visibility\", \"none\");\n }\n }\n\n private withKey(url: string): string {\n if (!this.options.apiKey) return url;\n const u = new URL(url, document.baseURI);\n if (!u.searchParams.has(\"api_key\")) u.searchParams.set(\"api_key\", this.options.apiKey);\n return u.href;\n }\n\n private modelUrl(url: string): string {\n return new URL(url, this.options.modelBase ?? document.baseURI).href;\n }\n\n private showState() {\n this.button?.setAttribute(\"aria-pressed\", String(this.enabled));\n }\n\n private warnOnce(key: string, message: string) {\n if (this.warned.has(key)) return;\n this.warned.add(key);\n console.warn(message);\n }\n}\n"],"mappings":"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"}
1
+ {"version":3,"file":"maplibre-scene3d-control.js","names":["SCENE3D_METADATA_KEY","DEFAULTS","CUBE_ICON","styleOf","map","sceneKeyOf","scene","terrainKeyOf","terrain","hasBuildings","usesBuildingsSource","LANDMARKS_FILTER","Scene3dControl","Evented","rest","options","v","container","button","canvas","gl","response","enabled","lib","err","next","l","id","pitch","sheet","generation","position","anchor","before","source","p","place","lod1","add","layer","landmarksFilter","fill3d","filter","landmarks","library","entry","ids","picked","models","m","restore","visibility","onData","e","url","u","key","message"],"sources":["../src/Scene3dControl.ts"],"sourcesContent":["import { Evented } from \"maplibre-gl\";\nimport type { ControlPosition, CustomLayerInterface, FilterSpecification, IControl, Map as MaplibreMap, MapLibreEvent, MapSourceDataEvent } from \"maplibre-gl\";\n\n/** Root metadata key under which a Maptoolkit style carries its 3D scene. */\nexport const SCENE3D_METADATA_KEY = \"maptoolkit:scene3d\";\n\n/**\n * Where a layer of the scene goes: under the style's labels (`\"below-labels\"`, the default: right below its first\n * symbol layer), on top of everything (`\"top\"`), or right below the style layer with that id. The position only\n * decides what draws over the 3D among symbol layers (labels, icons); fills and lines always end up under it. A\n * layer id the style lacks falls back to `\"below-labels\"`.\n */\nexport type Scene3dPosition = \"below-labels\" | \"top\" | (string & {});\n\ntype Expression = unknown;\n\n/** One glTF vegetation layer: maplibre-3d-layers `GltfLayer` options, `models` as ids of the scene's model library. */\nexport interface Scene3dGltfLayer {\n id: string;\n position?: Scene3dPosition;\n /** Model ids from {@link Scene3dManifest.models}; all of them when missing. */\n models?: string[];\n source: string;\n \"source-layer\"?: string;\n filter?: FilterSpecification;\n minzoom?: number;\n maxzoom?: number;\n layout?: Record<string, Expression>;\n paint?: Record<string, Expression>;\n lighting?: { ambient?: number; directional?: number; environment?: number };\n maxInstances?: number;\n doubleSided?: boolean;\n}\n\n/** The 3D scene of a style, `metadata[\"maptoolkit:scene3d\"]` (version 1). Values are plain MapLibre / maplibre-3d-layers options. */\nexport interface Scene3dManifest {\n version: 1;\n /** TileJSON URL of the buildings source, without api_key. */\n source: string;\n /** `fill-extrusion` on the source layer `buildings2d`. */\n lod1?: {\n position?: Scene3dPosition;\n minzoom?: number;\n maxzoom?: number;\n filter?: FilterSpecification;\n paint?: Record<string, Expression>;\n layout?: Record<string, Expression>;\n };\n /** `Fill3DLayer` on the source layer `buildings3d`. */\n fill3d?: { position?: Scene3dPosition; filter?: FilterSpecification; paint?: Record<string, Expression> };\n /**\n * The landmarks in the source layer `buildings3d`, as a `Fill3DLayer` of their own: with their own paint and their\n * own place among the style's layers. `filter` picks them (default `[\"==\", [\"get\", \"source\"], \"landmark\"]`), and\n * `fill3d` then leaves those features out.\n */\n landmarks?: { position?: Scene3dPosition; filter?: FilterSpecification; paint?: Record<string, Expression> };\n /** Model library of the vegetation: id → glTF/glb URL. */\n models?: Record<string, string>;\n gltf?: Scene3dGltfLayer[];\n}\n\n/** What the control needs from `@maptoolkit/maplibre-3d-layers`. */\nexport interface Scene3dLibrary {\n Fill3DLayer: new (options: Record<string, unknown>) => CustomLayerInterface;\n GltfLayer: new (options: Record<string, unknown>) => CustomLayerInterface;\n}\n\nexport interface Scene3dControlOptions {\n /** Maptoolkit API key, added to the buildings source URL as `api_key`. */\n apiKey?: string;\n /**\n * The scene to show. Left out: the one the current style names in `metadata[\"maptoolkit:scene3d\"]`,\n * re-read on every style change. A manifest or its URL replaces it; `null` shows none.\n */\n scene?: Scene3dManifest | string | null;\n /** Show the scene right away (default `true`). */\n enabled?: boolean;\n /** Add a 3D button that switches the scene on and off (default `false`: the control has no UI). */\n button?: boolean;\n /** The 3D library is loaded once the map reaches this zoom; the buildings source has no tiles below 12 (default `12`). */\n minzoom?: number;\n /**\n * Style layers hidden while the scene's buildings are shown, e.g. a style's own 3D buildings (default the v2 ids\n * `building_3d`, `building_3d_multicolored`). Hidden only once the buildings source has loaded, so without a working\n * API key the style keeps them.\n */\n hideLayers?: string[];\n /** Base for relative model URLs (default the document's base URL). */\n modelBase?: string;\n /** Loads `@maptoolkit/maplibre-3d-layers` (default a dynamic import of the package). Pass another loader for its standalone build or a CDN. */\n library?: () => Promise<Scene3dLibrary>;\n /** Prefix of the source and layer ids the control adds (default `\"scene3d-\"`). */\n idPrefix?: string;\n}\n\n/** Fired via `control.on(\"scene.change\", ...)` whenever the shown scene is (re)built or removed. */\nexport type Scene3dControlEventType = {\n \"scene.change\": MapLibreEvent<\"scene.change\"> & { scene: Scene3dManifest | null };\n};\n\ntype ResolvedOptions = Required<Omit<Scene3dControlOptions, \"apiKey\" | \"scene\" | \"modelBase\">> & Pick<Scene3dControlOptions, \"apiKey\" | \"modelBase\">;\n\nconst DEFAULTS: Omit<ResolvedOptions, \"library\"> = {\n enabled: true,\n button: false,\n minzoom: 12,\n hideLayers: [\"building_3d\", \"building_3d_multicolored\"],\n idPrefix: \"scene3d-\",\n};\n\nconst CUBE_ICON =\n '<svg viewBox=\"0 0 24 24\" aria-hidden=\"true\"><path fill=\"currentColor\" d=\"M12 2 3 7v10l9 5 9-5V7l-9-5Zm0 2.3L18.7 8 12 11.7 5.3 8 12 4.3ZM5 9.7l6 3.3v6.7l-6-3.4V9.7Zm8 10V13l6-3.3v6.6l-6 3.4Z\"/></svg>';\n\n// MapLibre's Style is private API; the control only reads whether it has loaded and its identity.\ntype StyleHandle = { _loaded?: boolean } | undefined;\nconst styleOf = (map: MaplibreMap) => (map as unknown as { style?: StyleHandle }).style;\n/** Compares scenes across style updates: the metadata comes as a new object each time. */\nconst sceneKeyOf = (scene: Scene3dManifest | null) => (scene ? JSON.stringify(scene) : null);\n/** Source and exaggeration of a terrain, to tell a real change from a repeated setTerrain. */\nconst terrainKeyOf = (terrain: { source: string; exaggeration?: number } | null | undefined) =>\n terrain ? `${terrain.source}|${terrain.exaggeration ?? 1}` : null;\n/** Whether a scene draws buildings, in place of the style's own 3D buildings (`hideLayers`). */\nconst hasBuildings = (scene: Scene3dManifest) => !!(scene.lod1 || scene.fill3d);\n/** Whether a scene reads the buildings source: for its buildings or its landmarks. */\nconst usesBuildingsSource = (scene: Scene3dManifest) => hasBuildings(scene) || !!scene.landmarks;\n/** The landmarks among the features of the source layer `buildings3d`, unless the scene names another filter. */\nconst LANDMARKS_FILTER = [\"==\", [\"get\", \"source\"], \"landmark\"] as unknown as FilterSpecification;\n\n/**\n * A MapLibre GL JS control plugin that adds the 3D scene of a Maptoolkit style: 3D buildings\n * (a `fill-extrusion` plus maplibre-3d-layers' `Fill3DLayer`), the landmarks among them (a `Fill3DLayer`\n * of their own) and glTF vegetation (`GltfLayer`).\n *\n * The scene comes from the style itself (`metadata[\"maptoolkit:scene3d\"]`, written by style-family-js),\n * so a style switch brings its own scene. The control keeps the tilt in the global state `pitch`\n * that the scene's opacity fades read, puts the layers under the style's labels, rebuilds them after\n * style and terrain changes and loads the 3D library only when the map gets close enough.\n */\nexport class Scene3dControl extends Evented<Scene3dControlEventType> implements IControl {\n readonly options: ResolvedOptions;\n\n private map?: MaplibreMap;\n private container?: HTMLElement;\n private button?: HTMLButtonElement;\n private enabled: boolean;\n /** undefined: the style's own scene. */\n private override: Scene3dManifest | null | undefined;\n private scene: Scene3dManifest | null = null;\n private lib?: Scene3dLibrary;\n private libPromise?: Promise<Scene3dLibrary>;\n private custom: CustomLayerInterface[] = [];\n private native: string[] = [];\n private hidden = new Map<string, \"visible\" | \"none\">();\n private loadedStyle: StyleHandle = undefined;\n private pitch: number | null = null;\n private building = false;\n private generation = 0;\n private warned = new Set<string>();\n /** Stops waiting for the buildings source (see hideOnceBuildingsLoad). */\n private stopWaiting?: () => void;\n /** The scene last read from the style or override (also an unsupported one), and as JSON; null for none. */\n private sceneRef: Scene3dManifest | null = null;\n private sceneKey: string | null = null;\n /** Whether the buildings source of the current scene has loaded (its TileJSON answered). */\n private sourceOk = false;\n /** The position each custom layer was added with (`\"below-labels\"` when the scene names none). */\n private customPosition = new Map<string, Scene3dPosition>();\n /** The terrain the 3D layers were built with (source and exaggeration), see onTerrain. */\n private terrainKey: string | null = null;\n\n constructor(options: Scene3dControlOptions = {}) {\n super();\n const { scene, ...rest } = options;\n this.options = {\n ...DEFAULTS,\n library: () => import(\"@maptoolkit/maplibre-3d-layers\") as unknown as Promise<Scene3dLibrary>,\n ...Object.fromEntries(Object.entries(rest).filter(([, v]) => v !== undefined)),\n } as ResolvedOptions;\n this.enabled = this.options.enabled;\n if (scene !== undefined) void this.setScene(scene);\n }\n\n getDefaultPosition(): ControlPosition {\n return \"top-right\";\n }\n\n onAdd(map: MaplibreMap): HTMLElement {\n this.map = map;\n const container = document.createElement(\"div\");\n container.className = \"maplibregl-ctrl maplibregl-ctrl-group maplibre-scene3d-control\";\n if (this.options.button) {\n const button = document.createElement(\"button\");\n button.type = \"button\";\n button.className = \"maplibre-scene3d-control-toggle\";\n button.title = \"3D\";\n button.setAttribute(\"aria-label\", \"3D\");\n button.innerHTML = CUBE_ICON;\n button.addEventListener(\"click\", () => this.setEnabled(!this.enabled));\n container.appendChild(button);\n this.button = button;\n this.showState();\n } else {\n container.classList.add(\"maplibre-scene3d-control-hidden\");\n }\n this.container = container;\n\n // Multisampling is decided when the map creates its WebGL context; a control added later cannot switch it on.\n // Without it the buildings and trees get hard, pixelated edges, and the far trees lose their soft leaf edges.\n const canvas = map.getCanvas?.();\n const gl = canvas?.getContext?.(\"webgl2\") ?? canvas?.getContext?.(\"webgl\");\n if (gl && (gl as WebGLRenderingContext).getContextAttributes?.()?.antialias === false) {\n this.warnOnce(\n \"antialias\",\n \"Scene3dControl: the map's WebGL context has no multisampling, so the 3D buildings and trees get pixelated edges. Create the map with canvasContextAttributes: { antialias: true }.\",\n );\n }\n\n map.on(\"style.load\", this.onStyleLoad);\n map.on(\"styledata\", this.onStyleData);\n map.on(\"terrain\", this.onTerrain);\n map.on(\"pitch\", this.syncPitch);\n map.on(\"zoomend\", this.onZoom);\n // Added to a map whose style has already loaded: no style.load will come for it.\n if (styleOf(map)?._loaded) this.onStyleLoad();\n return container;\n }\n\n onRemove(): void {\n const map = this.map;\n if (!map) return;\n this.teardown(true);\n map.off(\"style.load\", this.onStyleLoad);\n map.off(\"styledata\", this.onStyleData);\n map.off(\"terrain\", this.onTerrain);\n map.off(\"pitch\", this.syncPitch);\n map.off(\"zoomend\", this.onZoom);\n this.container?.remove();\n this.container = this.button = undefined;\n this.map = undefined;\n this.loadedStyle = undefined;\n }\n\n /**\n * Replace the style's scene: a manifest, the URL of one, `null` for none, or `undefined` to go back\n * to the style's own scene. The same scene again keeps the layers.\n *\n * MapLibre ignores a diffed `setStyle` that changes nothing but the metadata, so a scene that changes\n * on its own never reaches the control that way; pass it here (or use `setStyle` with `diff: false`).\n */\n async setScene(scene: Scene3dManifest | string | null | undefined): Promise<void> {\n if (typeof scene === \"string\") {\n const response = await fetch(new URL(scene, document.baseURI).href);\n if (!response.ok) throw new Error(`Scene ${scene}: HTTP ${response.status}`);\n scene = (await response.json()) as Scene3dManifest;\n }\n // The same scene again (e.g. after every style update of an editor) keeps the layers.\n if (scene !== undefined && this.override !== undefined && sceneKeyOf(scene) === sceneKeyOf(this.override)) return;\n this.override = scene;\n this.refresh();\n }\n\n /** The scene shown now, or null. */\n getScene(): Scene3dManifest | null {\n return this.scene;\n }\n\n setEnabled(enabled: boolean): void {\n if (this.enabled === enabled) return;\n this.enabled = enabled;\n this.showState();\n this.refresh();\n }\n\n isEnabled(): boolean {\n return this.enabled;\n }\n\n /** The maplibre-3d-layers layers on the map (`Fill3DLayer`, `GltfLayer`s), e.g. to drive them frame by frame. */\n getLayers(): CustomLayerInterface[] {\n return [...this.custom];\n }\n\n /** The 3D library, once loaded. */\n getLibrary(): Scene3dLibrary | undefined {\n return this.lib;\n }\n\n /** Load the 3D library now instead of waiting for `minzoom`. */\n loadLibrary(): Promise<Scene3dLibrary> {\n this.libPromise ??= this.options.library().then(\n (lib) => (this.lib = lib),\n (err) => {\n this.libPromise = undefined;\n throw err;\n },\n );\n return this.libPromise;\n }\n\n // ---------------------------------------------------------------- map events\n\n private onStyleLoad = () => {\n if (!this.map) return;\n this.pitch = null; // a new style, or a diffed one, starts with its own global state\n // MapLibre 6 fires style.load after a diffed setStyle too; the Style object stays the same then.\n if (styleOf(this.map) === this.loadedStyle) {\n this.syncWithStyle();\n return;\n }\n this.loadedStyle = styleOf(this.map);\n this.teardown(false); // whatever of the old scene a style diff left behind\n this.refresh();\n };\n\n private onStyleData = () => this.syncWithStyle();\n\n // A diffed setStyle (setStyle without { diff: false }) keeps the Style object. It drops our source\n // and native layers as \"not in the new style\" but keeps the custom layers (MapLibre never serializes\n // them), and it may bring another scene or none. Same scene: put the source and native layers back\n // and keep the 3D layers. Another scene: rebuild.\n private syncWithStyle() {\n if (this.building || !this.map || !this.styleReady()) return;\n const map = this.map;\n const next = this.currentScene();\n if (next !== this.sceneRef) {\n if (sceneKeyOf(next) !== this.sceneKey) {\n this.refresh();\n return;\n }\n this.sceneRef = next; // the same scene in a new object\n }\n if (!this.scene) return;\n if (this.custom.some((l) => !map.getLayer(l.id))) this.refresh();\n else if (this.native.some((id) => !map.getLayer(id)) || (usesBuildingsSource(this.scene) && !map.getSource(this.sourceId()))) this.restoreNative();\n else this.syncPitch();\n }\n\n // The 3D layers take the terrain source and exaggeration as they are when they are added (heights\n // are sampled from the current terrain each pass). MapLibre fires `terrain` on every setTerrain, also\n // with the same options; rebuilding then would restart model loading each time (an app re-applying\n // its terrain after every style update kept the models loading for good).\n private onTerrain = () => {\n if (!this.map || !this.styleReady() || !this.custom.length || !this.scene) return;\n if (terrainKeyOf(this.map.getTerrain()) === this.terrainKey) return;\n this.removeCustom();\n this.addCustom(this.scene, this.generation);\n };\n\n private onZoom = () => {\n if (!this.map || this.lib || !this.scene || this.map.getZoom() < this.options.minzoom) return;\n this.loadCustom(this.scene, this.generation);\n };\n\n /** `[\"global-state\", \"pitch\"]` for the scene's opacity fades. Whole degrees: each change is a style update. */\n private syncPitch = () => {\n if (!this.map || !this.styleReady()) return;\n const pitch = Math.round(this.map.getPitch());\n if (pitch === this.pitch) return;\n this.pitch = pitch;\n this.map.setGlobalStateProperty(\"pitch\", pitch);\n };\n\n // ---------------------------------------------------------------- building\n\n private styleReady(): boolean {\n return !!this.map && !!this.loadedStyle && styleOf(this.map) === this.loadedStyle;\n }\n\n private currentScene(): Scene3dManifest | null {\n if (!this.enabled) return null;\n if (this.override !== undefined) return this.override;\n // Straight from the stylesheet MapLibre keeps: this runs on every styledata (every whole degree of\n // tilt, see syncPitch), and getStyle() clones every layer. getStyle() only as a fallback.\n const sheet = (this.map as unknown as { style?: { stylesheet?: { metadata?: unknown } } } | undefined)?.style?.stylesheet;\n const metadata = (sheet ? sheet.metadata : this.map?.getStyle()?.metadata) as Record<string, unknown> | undefined;\n return (metadata?.[SCENE3D_METADATA_KEY] as Scene3dManifest | undefined) ?? null;\n }\n\n private refresh() {\n const map = this.map;\n if (!map || !this.styleReady()) return;\n this.building = true;\n try {\n this.teardown(true);\n const generation = ++this.generation;\n let scene = this.currentScene();\n this.sceneRef = scene;\n this.sceneKey = sceneKeyOf(scene);\n if (scene && scene.version !== 1) {\n this.warnOnce(`version-${String(scene.version)}`, `Scene3dControl: unsupported scene version ${String(scene.version)}`);\n scene = null;\n }\n this.scene = scene;\n if (scene) {\n this.syncPitch();\n if (hasBuildings(scene)) this.hideOnceBuildingsLoad(generation);\n this.addNative(scene);\n if (this.lib) this.addCustom(scene, generation);\n else if (map.getZoom() >= this.options.minzoom) this.loadCustom(scene, generation);\n }\n } finally {\n this.building = false;\n }\n this.fire(\"scene.change\", { scene: this.scene });\n }\n\n private sourceId() {\n return `${this.options.idPrefix}buildings`;\n }\n\n /** The id of the style's first symbol layer: the scene goes right below it. */\n private labelsAnchor(): string | undefined {\n return this.map?.getStyle().layers.find((l) => l.type === \"symbol\" && !l.id.startsWith(this.options.idPrefix))?.id;\n }\n\n /** The layer a scene layer goes below for `position`: none for \"top\", the style layer it names, else `anchor`. */\n private beforeFor(position: Scene3dPosition | undefined, anchor: string | undefined) {\n if (position === \"top\") return undefined;\n if (!position || position === \"below-labels\") return anchor;\n if (!position.startsWith(this.options.idPrefix) && this.map?.getLayer(position)) return position;\n this.warnOnce(`position-${position}`, `Scene3dControl: the style has no layer \"${position}\", the scene goes under the labels`);\n return anchor;\n }\n\n /**\n * The buildings source and the native layers, each below the layer its position names. `place` can pick another\n * layer for a position (restoreNative: the 3D layers with the same position).\n */\n private addNative(scene: Scene3dManifest, place = (_position: Scene3dPosition, before: string | undefined) => before) {\n const map = this.map!;\n const source = this.sourceId();\n if (!usesBuildingsSource(scene)) return; // trees only: no buildings source to load (or to answer 403 without a key)\n if (!map.getSource(source)) map.addSource(source, { type: \"vector\", url: this.withKey(scene.source) });\n const p = this.options.idPrefix;\n const anchor = this.labelsAnchor();\n const before = (position: Scene3dPosition | undefined) => place(position ?? \"below-labels\", this.beforeFor(position, anchor));\n if (scene.lod1) {\n const { position, ...lod1 } = scene.lod1;\n map.addLayer({ id: `${p}lod1`, type: \"fill-extrusion\", source, \"source-layer\": \"buildings2d\", ...lod1 } as never, before(position));\n this.native.push(`${p}lod1`);\n } else {\n // The Fill3DLayers (buildings, landmarks) read tiles MapLibre only loads for a source a style layer uses.\n map.addLayer(\n { id: `${p}consumer`, type: \"fill\", source, \"source-layer\": \"buildings2d\", filter: [\"boolean\", false], paint: { \"fill-opacity\": 0 } },\n before((scene.fill3d ?? scene.landmarks)?.position),\n );\n this.native.push(`${p}consumer`);\n }\n }\n\n /** After a diffed setStyle with the same scene: put back the source and native layers, keep the 3D layers. */\n private restoreNative() {\n const map = this.map!;\n const scene = this.scene!;\n this.building = true;\n try {\n for (const id of this.native) if (map.getLayer(id)) map.removeLayer(id);\n this.native = [];\n // The new style set its own visibility on the layers we hide; remember that one.\n this.hidden.clear();\n // Under the 3D layers with the same position again, as in a full build.\n this.addNative(scene, (position, before) => this.custom.find((l) => this.customPosition.get(l.id) === position)?.id ?? before);\n if (hasBuildings(scene)) {\n if (this.sourceOk) this.hideStyleLayers();\n else {\n this.stopWaiting?.();\n this.hideOnceBuildingsLoad(this.generation);\n }\n }\n this.pitch = null;\n this.syncPitch();\n } finally {\n this.building = false;\n }\n }\n\n private loadCustom(scene: Scene3dManifest, generation: number) {\n this.loadLibrary().then(\n () => {\n if (generation === this.generation && this.scene === scene && !this.custom.length) this.addCustom(scene, generation);\n },\n (err) => console.error(\"Scene3dControl: could not load @maptoolkit/maplibre-3d-layers\", err),\n );\n }\n\n private addCustom(scene: Scene3dManifest, generation: number) {\n const map = this.map;\n const lib = this.lib;\n if (!map || !lib || generation !== this.generation || !this.styleReady()) return;\n const anchor = this.labelsAnchor();\n const p = this.options.idPrefix;\n this.terrainKey = terrainKeyOf(map.getTerrain());\n const add = (layer: CustomLayerInterface, position: Scene3dPosition | undefined) => {\n map.addLayer(layer, this.beforeFor(position, anchor));\n this.custom.push(layer);\n this.customPosition.set(layer.id, position ?? \"below-labels\");\n };\n this.building = true;\n try {\n // The landmarks have a layer of their own, so the buildings' layer leaves them out. A scene without\n // `landmarks` keeps them in `fill3d`: drawn as plain buildings rather than missing.\n const landmarksFilter = scene.landmarks ? (scene.landmarks.filter ?? LANDMARKS_FILTER) : undefined;\n if (scene.fill3d) {\n const { position, ...fill3d } = scene.fill3d;\n const filter = landmarksFilter && [\"all\", ...(fill3d.filter ? [fill3d.filter] : []), [\"!\", landmarksFilter]];\n add(\n new lib.Fill3DLayer({ id: `${p}fill3d`, source: this.sourceId(), \"source-layer\": \"buildings3d\", ...fill3d, ...(filter ? { filter } : {}) }),\n position,\n );\n }\n if (scene.landmarks) {\n const { position, ...landmarks } = scene.landmarks;\n add(\n new lib.Fill3DLayer({ id: `${p}landmarks`, source: this.sourceId(), \"source-layer\": \"buildings3d\", ...landmarks, filter: landmarksFilter }),\n position,\n );\n }\n const library = scene.models ?? {};\n for (const entry of scene.gltf ?? []) {\n const { id, position, models: ids, ...options } = entry;\n if (!map.getSource(options.source)) {\n this.warnOnce(`source-${options.source}`, `Scene3dControl: the style has no source \"${options.source}\", layer \"${id}\" left out`);\n continue;\n }\n const picked = ids ?? Object.keys(library);\n const models = Object.fromEntries(picked.filter((m) => library[m]).map((m) => [m, this.modelUrl(library[m])]));\n if (!Object.keys(models).length) continue;\n add(new lib.GltfLayer({ id: `${p}${id}`, models, ...options }), position);\n }\n } finally {\n this.building = false;\n }\n }\n\n private removeCustom() {\n const map = this.map;\n for (const layer of this.custom) {\n if (map?.getLayer(layer.id)) map.removeLayer(layer.id);\n // A replaced style never calls onRemove; without it the layer keeps listening to the map.\n else if (map) layer.onRemove?.(map, undefined as unknown as WebGL2RenderingContext);\n }\n this.custom = [];\n this.customPosition.clear();\n }\n\n /** Remove everything the control added; `restore` puts hidden style layers back. */\n private teardown(restore: boolean) {\n const map = this.map;\n this.stopWaiting?.();\n this.building = true;\n try {\n this.removeCustom();\n if (map) {\n for (const id of this.native) if (map.getLayer(id)) map.removeLayer(id);\n if (map.getSource(this.sourceId()) && this.styleReady()) map.removeSource(this.sourceId());\n if (restore && this.styleReady()) {\n for (const [id, visibility] of this.hidden) if (map.getLayer(id)) map.setLayoutProperty(id, \"visibility\", visibility);\n }\n }\n this.native = [];\n this.hidden.clear();\n this.scene = null;\n this.sourceOk = false;\n } finally {\n this.building = false;\n }\n }\n\n /**\n * Hide the style's own 3D buildings (`hideLayers`) only once the scene's buildings source has\n * loaded. Without a working API key it answers 403, and the style keeps its buildings.\n */\n private hideOnceBuildingsLoad(generation: number) {\n const map = this.map!;\n const id = this.sourceId();\n const onData = (e: MapSourceDataEvent) => {\n // removeSource fires a metadata event too; the source is gone by then.\n if (e.sourceId !== id || e.sourceDataType !== \"metadata\" || !map.getSource(id)) return;\n this.stopWaiting?.();\n if (generation !== this.generation || !this.styleReady()) return;\n this.sourceOk = true;\n this.hideStyleLayers();\n };\n map.on(\"sourcedata\", onData);\n this.stopWaiting = () => {\n map.off(\"sourcedata\", onData);\n this.stopWaiting = undefined;\n };\n }\n\n private hideStyleLayers() {\n const map = this.map!;\n for (const id of this.options.hideLayers) {\n if (!map.getLayer(id)) continue;\n this.hidden.set(id, (map.getLayoutProperty(id, \"visibility\") as \"visible\" | \"none\" | undefined) ?? \"visible\");\n map.setLayoutProperty(id, \"visibility\", \"none\");\n }\n }\n\n private withKey(url: string): string {\n if (!this.options.apiKey) return url;\n const u = new URL(url, document.baseURI);\n if (!u.searchParams.has(\"api_key\")) u.searchParams.set(\"api_key\", this.options.apiKey);\n return u.href;\n }\n\n private modelUrl(url: string): string {\n return new URL(url, this.options.modelBase ?? document.baseURI).href;\n }\n\n private showState() {\n this.button?.setAttribute(\"aria-pressed\", String(this.enabled));\n }\n\n private warnOnce(key: string, message: string) {\n if (this.warned.has(key)) return;\n this.warned.add(key);\n console.warn(message);\n }\n}\n"],"mappings":"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"}
@@ -6,7 +6,11 @@ var t = "maptoolkit:scene3d", n = {
6
6
  minzoom: 12,
7
7
  hideLayers: ["building_3d", "building_3d_multicolored"],
8
8
  idPrefix: "scene3d-"
9
- }, r = "<svg viewBox=\"0 0 24 24\" aria-hidden=\"true\"><path fill=\"currentColor\" d=\"M12 2 3 7v10l9 5 9-5V7l-9-5Zm0 2.3L18.7 8 12 11.7 5.3 8 12 4.3ZM5 9.7l6 3.3v6.7l-6-3.4V9.7Zm8 10V13l6-3.3v6.6l-6 3.4Z\"/></svg>", i = (e) => e.style, a = (e) => e ? JSON.stringify(e) : null, o = (e) => e ? `${e.source}|${e.exaggeration ?? 1}` : null, s = (e) => !!(e.lod1 || e.fill3d), c = class extends e {
9
+ }, r = "<svg viewBox=\"0 0 24 24\" aria-hidden=\"true\"><path fill=\"currentColor\" d=\"M12 2 3 7v10l9 5 9-5V7l-9-5Zm0 2.3L18.7 8 12 11.7 5.3 8 12 4.3ZM5 9.7l6 3.3v6.7l-6-3.4V9.7Zm8 10V13l6-3.3v6.6l-6 3.4Z\"/></svg>", i = (e) => e.style, a = (e) => e ? JSON.stringify(e) : null, o = (e) => e ? `${e.source}|${e.exaggeration ?? 1}` : null, s = (e) => !!(e.lod1 || e.fill3d), c = (e) => s(e) || !!e.landmarks, l = [
10
+ "==",
11
+ ["get", "source"],
12
+ "landmark"
13
+ ], u = class extends e {
10
14
  options;
11
15
  map;
12
16
  container;
@@ -49,7 +53,9 @@ var t = "maptoolkit:scene3d", n = {
49
53
  let e = document.createElement("button");
50
54
  e.type = "button", e.className = "maplibre-scene3d-control-toggle", e.title = "3D", e.setAttribute("aria-label", "3D"), e.innerHTML = r, e.addEventListener("click", () => this.setEnabled(!this.enabled)), t.appendChild(e), this.button = e, this.showState();
51
55
  } else t.classList.add("maplibre-scene3d-control-hidden");
52
- return this.container = t, e.on("style.load", this.onStyleLoad), e.on("styledata", this.onStyleData), e.on("terrain", this.onTerrain), e.on("pitch", this.syncPitch), e.on("zoomend", this.onZoom), i(e)?._loaded && this.onStyleLoad(), t;
56
+ this.container = t;
57
+ let n = e.getCanvas?.(), a = n?.getContext?.("webgl2") ?? n?.getContext?.("webgl");
58
+ return a && a.getContextAttributes?.()?.antialias === !1 && this.warnOnce("antialias", "Scene3dControl: the map's WebGL context has no multisampling, so the 3D buildings and trees get pixelated edges. Create the map with canvasContextAttributes: { antialias: true }."), e.on("style.load", this.onStyleLoad), e.on("styledata", this.onStyleData), e.on("terrain", this.onTerrain), e.on("pitch", this.syncPitch), e.on("zoomend", this.onZoom), i(e)?._loaded && this.onStyleLoad(), t;
53
59
  }
54
60
  onRemove() {
55
61
  let e = this.map;
@@ -97,7 +103,7 @@ var t = "maptoolkit:scene3d", n = {
97
103
  }
98
104
  this.sceneRef = t;
99
105
  }
100
- this.scene && (this.custom.some((t) => !e.getLayer(t.id)) ? this.refresh() : this.native.some((t) => !e.getLayer(t)) || s(this.scene) && !e.getSource(this.sourceId()) ? this.restoreNative() : this.syncPitch());
106
+ this.scene && (this.custom.some((t) => !e.getLayer(t.id)) ? this.refresh() : this.native.some((t) => !e.getLayer(t)) || c(this.scene) && !e.getSource(this.sourceId()) ? this.restoreNative() : this.syncPitch());
101
107
  }
102
108
  onTerrain = () => {
103
109
  this.map && this.styleReady() && this.custom.length && this.scene && o(this.map.getTerrain()) !== this.terrainKey && (this.removeCustom(), this.addCustom(this.scene, this.generation));
@@ -144,7 +150,7 @@ var t = "maptoolkit:scene3d", n = {
144
150
  }
145
151
  addNative(e, t = (e, t) => t) {
146
152
  let n = this.map, r = this.sourceId();
147
- if (!s(e)) return;
153
+ if (!c(e)) return;
148
154
  n.getSource(r) || n.addSource(r, {
149
155
  type: "vector",
150
156
  url: this.withKey(e.source)
@@ -159,14 +165,14 @@ var t = "maptoolkit:scene3d", n = {
159
165
  "source-layer": "buildings2d",
160
166
  ...a
161
167
  }, o(t)), this.native.push(`${i}lod1`);
162
- } else e.fill3d && (n.addLayer({
168
+ } else n.addLayer({
163
169
  id: `${i}consumer`,
164
170
  type: "fill",
165
171
  source: r,
166
172
  "source-layer": "buildings2d",
167
173
  filter: ["boolean", !1],
168
174
  paint: { "fill-opacity": 0 }
169
- }, o(e.fill3d.position)), this.native.push(`${i}consumer`));
175
+ }, o((e.fill3d ?? e.landmarks)?.position)), this.native.push(`${i}consumer`);
170
176
  }
171
177
  restoreNative() {
172
178
  let e = this.map, t = this.scene;
@@ -193,23 +199,39 @@ var t = "maptoolkit:scene3d", n = {
193
199
  };
194
200
  this.building = !0;
195
201
  try {
202
+ let t = e.landmarks ? e.landmarks.filter ?? l : void 0;
196
203
  if (e.fill3d) {
197
- let { position: t, ...n } = e.fill3d;
204
+ let { position: n, ...i } = e.fill3d, o = t && [
205
+ "all",
206
+ ...i.filter ? [i.filter] : [],
207
+ ["!", t]
208
+ ];
198
209
  s(new r.Fill3DLayer({
199
210
  id: `${a}fill3d`,
200
211
  source: this.sourceId(),
201
212
  "source-layer": "buildings3d",
202
- ...n
203
- }), t);
213
+ ...i,
214
+ ...o ? { filter: o } : {}
215
+ }), n);
204
216
  }
205
- let t = e.models ?? {};
206
- for (let i of e.gltf ?? []) {
207
- let { id: e, position: o, models: c, ...l } = i;
217
+ if (e.landmarks) {
218
+ let { position: n, ...i } = e.landmarks;
219
+ s(new r.Fill3DLayer({
220
+ id: `${a}landmarks`,
221
+ source: this.sourceId(),
222
+ "source-layer": "buildings3d",
223
+ ...i,
224
+ filter: t
225
+ }), n);
226
+ }
227
+ let i = e.models ?? {};
228
+ for (let t of e.gltf ?? []) {
229
+ let { id: e, position: o, models: c, ...l } = t;
208
230
  if (!n.getSource(l.source)) {
209
231
  this.warnOnce(`source-${l.source}`, `Scene3dControl: the style has no source "${l.source}", layer "${e}" left out`);
210
232
  continue;
211
233
  }
212
- let u = c ?? Object.keys(t), d = Object.fromEntries(u.filter((e) => t[e]).map((e) => [e, this.modelUrl(t[e])]));
234
+ let u = c ?? Object.keys(i), d = Object.fromEntries(u.filter((e) => i[e]).map((e) => [e, this.modelUrl(i[e])]));
213
235
  Object.keys(d).length && s(new r.GltfLayer({
214
236
  id: `${a}${e}`,
215
237
  models: d,
@@ -264,17 +286,17 @@ var t = "maptoolkit:scene3d", n = {
264
286
  warnOnce(e, t) {
265
287
  this.warned.has(e) || (this.warned.add(e), console.warn(t));
266
288
  }
267
- }, l = () => import(
289
+ }, d = () => import(
268
290
  /* @vite-ignore */
269
- new URL("./maplibre-3d-layers-0.5.6.standalone.mjs", import.meta.url).href
270
- ), u = class extends c {
291
+ new URL("./maplibre-3d-layers-0.6.0.standalone.mjs", import.meta.url).href
292
+ ), f = class extends u {
271
293
  constructor(e = {}) {
272
294
  super({
273
295
  ...e,
274
- library: e.library ?? l
296
+ library: e.library ?? d
275
297
  });
276
298
  }
277
299
  };
278
- export { t as SCENE3D_METADATA_KEY, u as Scene3dControl, l as bundledLibrary };
300
+ export { t as SCENE3D_METADATA_KEY, f as Scene3dControl, d as bundledLibrary };
279
301
 
280
302
  //# sourceMappingURL=maplibre-scene3d-control.standalone.js.map