isard 1.5.0 → 1.6.0

package/dist/react/VectorGeometry.d.ts

@@ -3,6 +3,7 @@
 import { type ReactNode, type Ref } from 'react';
 import type { Style, StyleLayer } from '../basemap/vectorstyle.ts';
 import type { VectorLayer, VectorSublayer } from '../layers/vectors.ts';
+import type { RoofMode } from '../workers/basemap/geometry.ts';
 export interface VectorGeometryProps {
     /** A style URL or object (default OpenFreeMap's Positron); another one makes the layer anew */
     style?: string | Style;
@@ -12,6 +13,10 @@ export interface VectorGeometryProps {
     /** The line layers that glow at night (default those whose id names a road); another function makes the layer anew,
      * as `layers` */
     streets?: (layer: StyleLayer) => boolean;
+    /** The buildings' roofs (as `vectors({ roofs })`: `'data'` by default); another one makes the layer anew */
+    roofs?: RoofMode;
+    /** The buildings' walls show their windows (default false: `setFacades`, the tiles not cut again) */
+    facades?: boolean;
     /** Paint properties over the style's (`setPaintProperty`), by style layer id, or by style layer drawn once the style
      * is loaded (a function of its id, kind, source layer): compared by value, only those changed sent; one taken out
      * keeps its last value */

package/dist/react/VectorGeometry.js

@@ -6,7 +6,7 @@ import { MapContext, SwipeContext } from "./context.js";
 const changed = (sent, next) => Object.entries(next ?? {}).flatMap(([layer, properties]) => Object.entries(properties)
     .filter(([name, value]) => JSON.stringify(sent?.[layer]?.[name]) !== JSON.stringify(value))
     .map(([name, value]) => [layer, name, value]));
-const VectorGeometryComponent = forwardRef(function VectorGeometry({ style, layers, streets, paint, visible = true, order = 0, onLayer }, ref) {
+const VectorGeometryComponent = forwardRef(function VectorGeometry({ style, layers, streets, roofs, facades = false, paint, visible = true, order = 0, onLayer }, ref) {
     const binding = useContext(MapContext);
     const swipe = useContext(SwipeContext);
     const latest = useRef({ order, onLayer });
@@ -16,12 +16,16 @@ const VectorGeometryComponent = forwardRef(function VectorGeometry({ style, laye
     latest.current = { order, onLayer };
     useImperativeHandle(ref, () => layer, [layer]);
     // The tiles and their geometry layer created once the map is there, in the declared order; made anew when the
-    // style, the layers kept or the streets change; the tiles (and their layer) destroyed when unmounted
+    // style, the layers kept, the streets or the roofs change; the tiles (and their layer) destroyed when unmounted
     useEffect(() => {
         if (!binding)
             return;
         const tiles = binding.map.vectorTiles(style === undefined ? {} : { style });
-        const created = tiles.vectors({ ...(layers && { layers }), ...(streets && { streets }) });
+        const created = tiles.vectors({
+            ...(layers && { layers }),
+            ...(streets && { streets }),
+            ...(roofs && { roofs }),
+        });
         binding.order.place(created, latest.current.order);
         swipe?.set(created);
         sent.current = undefined;
@@ -33,7 +37,7 @@ const VectorGeometryComponent = forwardRef(function VectorGeometry({ style, laye
             tiles.destroy();
             setLayer(undefined);
         };
-    }, [binding, swipe, style, layers, streets]);
+    }, [binding, swipe, style, layers, streets, roofs]);
     // The paint properties changed since the last ones sent (all of them to a layer made anew), those of a function
     // once the style is loaded; a later render or layer drops the wait
     useEffect(() => {
@@ -62,6 +66,10 @@ const VectorGeometryComponent = forwardRef(function VectorGeometry({ style, laye
             wait.live = false;
         };
     }, [layer, paint]);
+    // The walls' windows shown or not
+    useEffect(() => {
+        layer?.setFacades(facades);
+    }, [layer, facades]);
     // Shown or hidden
     useEffect(() => {
         layer?.setVisible(visible);

package/dist/react/VectorGeometry.js.map

@@ -1 +1 @@
-{"version":3,"file":"VectorGeometry.js","sourceRoot":"","sources":["../../src/react/VectorGeometry.tsx"],"names":[],"mappings":"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","sourcesContent":["/** `<VectorGeometry>`: the fills and lines of a MapLibre style drawn as geometry (`vectorTiles().vectors()`), among the\n * layers of the components */\n\nimport {\n  forwardRef,\n  type ReactNode,\n  type Ref,\n  useContext,\n  useEffect,\n  useImperativeHandle,\n  useRef,\n  useState,\n} from 'react';\nimport type { Style, StyleLayer } from '../basemap/vectorstyle.ts';\nimport type { VectorLayer, VectorSublayer } from '../layers/vectors.ts';\nimport { MapContext, SwipeContext } from './context.ts';\n\nexport interface VectorGeometryProps {\n  /** A style URL or object (default OpenFreeMap's Positron); another one makes the layer anew */\n  style?: string | Style;\n  /** The style layers drawn (default all its fills and lines); another function makes the layer anew, so keep it in a\n   * memo or at the module's level */\n  layers?: (layer: StyleLayer) => boolean;\n  /** The line layers that glow at night (default those whose id names a road); another function makes the layer anew,\n   * as `layers` */\n  streets?: (layer: StyleLayer) => boolean;\n  /** Paint properties over the style's (`setPaintProperty`), by style layer id, or by style layer drawn once the style\n   * is loaded (a function of its id, kind, source layer): compared by value, only those changed sent; one taken out\n   * keeps its last value */\n  paint?: Paint | ((layer: VectorSublayer) => Record<string, unknown> | undefined);\n  /** Shown (default true) */\n  visible?: boolean;\n  /** Its place among the layers of the components (as `<Layer order>`) */\n  order?: number;\n  /** The layer, once created and each time it is made anew */\n  onLayer?: (layer: VectorLayer) => void;\n  ref?: Ref<VectorLayer | undefined>;\n}\n\n/** Paint properties by style layer id */\ntype Paint = Record<string, Record<string, unknown>>;\n\n/** The paint properties of `next` that differ from those of `sent`, as `[layer, name, value]` */\nconst changed = (sent: Paint | undefined, next: Paint | undefined): [layer: string, name: string, value: unknown][] =>\n  Object.entries(next ?? {}).flatMap(([layer, properties]) =>\n    Object.entries(properties)\n      .filter(([name, value]) => JSON.stringify(sent?.[layer]?.[name]) !== JSON.stringify(value))\n      .map(([name, value]): [string, string, unknown] => [layer, name, value]),\n  );\n\nconst VectorGeometryComponent = forwardRef<VectorLayer | undefined, Omit<VectorGeometryProps, 'ref'>>(\n  function VectorGeometry({ style, layers, streets, paint, visible = true, order = 0, onLayer }, ref) {\n    const binding = useContext(MapContext);\n    const swipe = useContext(SwipeContext);\n    const latest = useRef({ order, onLayer });\n    /** The paint properties sent to the current layer */\n    const sent = useRef<Paint>(undefined);\n    const [layer, setLayer] = useState<VectorLayer>();\n\n    latest.current = { order, onLayer };\n    useImperativeHandle(ref, () => layer, [layer]);\n\n    // The tiles and their geometry layer created once the map is there, in the declared order; made anew when the\n    // style, the layers kept or the streets change; the tiles (and their layer) destroyed when unmounted\n    useEffect(() => {\n      if (!binding) return;\n\n      const tiles = binding.map.vectorTiles(style === undefined ? {} : { style });\n      const created = tiles.vectors({ ...(layers && { layers }), ...(streets && { streets }) });\n\n      binding.order.place(created, latest.current.order);\n      swipe?.set(created);\n      sent.current = undefined;\n      setLayer(created);\n      latest.current.onLayer?.(created);\n\n      return () => {\n        binding.order.remove(created);\n        swipe?.unset(created);\n        tiles.destroy();\n        setLayer(undefined);\n      };\n    }, [binding, swipe, style, layers, streets]);\n\n    // The paint properties changed since the last ones sent (all of them to a layer made anew), those of a function\n    // once the style is loaded; a later render or layer drops the wait\n    useEffect(() => {\n      if (!layer) return;\n\n      const apply = (next: Paint | undefined) => {\n        changed(sent.current, next).forEach(([id, name, value]) => {\n          layer.setPaintProperty(id, name, value);\n        });\n        sent.current = next;\n      };\n\n      if (typeof paint !== 'function') {\n        apply(paint);\n\n        return;\n      }\n\n      const wait = { live: true };\n\n      layer.ready.then(\n        () => {\n          if (!wait.live) return;\n          apply(\n            Object.fromEntries(\n              layer.layers.flatMap((l) => {\n                const properties = paint(l);\n\n                return properties ? [[l.id, properties]] : [];\n              }),\n            ),\n          );\n        },\n        () => undefined,\n      );\n\n      return () => {\n        wait.live = false;\n      };\n    }, [layer, paint]);\n\n    // Shown or hidden\n    useEffect(() => {\n      layer?.setVisible(visible);\n    }, [layer, visible]);\n\n    // A new `order`: moved to its new place among the layers of the components\n    useEffect(() => {\n      if (binding && layer) binding.order.place(layer, order, layer);\n    }, [binding, layer, order]);\n\n    return null;\n  },\n);\n\n/**\n * The fills and lines of a MapLibre style drawn as geometry on the globe and the relief (`vectorTiles().vectors()`):\n * sharp at any zoom and pitch, restyled by `paint` without cutting the tiles again, picked by feature\n * (`map.pickFeature`). The ref and `onLayer` give its handle (`VectorLayer`: `layers`, `featureAt`, `ready`)\n */\nexport const VectorGeometry = VectorGeometryComponent as (props: VectorGeometryProps) => ReactNode;\n"]}
+{"version":3,"file":"VectorGeometry.js","sourceRoot":"","sources":["../../src/react/VectorGeometry.tsx"],"names":[],"mappings":"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","sourcesContent":["/** `<VectorGeometry>`: the fills and lines of a MapLibre style drawn as geometry (`vectorTiles().vectors()`), among the\n * layers of the components */\n\nimport {\n  forwardRef,\n  type ReactNode,\n  type Ref,\n  useContext,\n  useEffect,\n  useImperativeHandle,\n  useRef,\n  useState,\n} from 'react';\nimport type { Style, StyleLayer } from '../basemap/vectorstyle.ts';\nimport type { VectorLayer, VectorSublayer } from '../layers/vectors.ts';\nimport type { RoofMode } from '../workers/basemap/geometry.ts';\nimport { MapContext, SwipeContext } from './context.ts';\n\nexport interface VectorGeometryProps {\n  /** A style URL or object (default OpenFreeMap's Positron); another one makes the layer anew */\n  style?: string | Style;\n  /** The style layers drawn (default all its fills and lines); another function makes the layer anew, so keep it in a\n   * memo or at the module's level */\n  layers?: (layer: StyleLayer) => boolean;\n  /** The line layers that glow at night (default those whose id names a road); another function makes the layer anew,\n   * as `layers` */\n  streets?: (layer: StyleLayer) => boolean;\n  /** The buildings' roofs (as `vectors({ roofs })`: `'data'` by default); another one makes the layer anew */\n  roofs?: RoofMode;\n  /** The buildings' walls show their windows (default false: `setFacades`, the tiles not cut again) */\n  facades?: boolean;\n  /** Paint properties over the style's (`setPaintProperty`), by style layer id, or by style layer drawn once the style\n   * is loaded (a function of its id, kind, source layer): compared by value, only those changed sent; one taken out\n   * keeps its last value */\n  paint?: Paint | ((layer: VectorSublayer) => Record<string, unknown> | undefined);\n  /** Shown (default true) */\n  visible?: boolean;\n  /** Its place among the layers of the components (as `<Layer order>`) */\n  order?: number;\n  /** The layer, once created and each time it is made anew */\n  onLayer?: (layer: VectorLayer) => void;\n  ref?: Ref<VectorLayer | undefined>;\n}\n\n/** Paint properties by style layer id */\ntype Paint = Record<string, Record<string, unknown>>;\n\n/** The paint properties of `next` that differ from those of `sent`, as `[layer, name, value]` */\nconst changed = (sent: Paint | undefined, next: Paint | undefined): [layer: string, name: string, value: unknown][] =>\n  Object.entries(next ?? {}).flatMap(([layer, properties]) =>\n    Object.entries(properties)\n      .filter(([name, value]) => JSON.stringify(sent?.[layer]?.[name]) !== JSON.stringify(value))\n      .map(([name, value]): [string, string, unknown] => [layer, name, value]),\n  );\n\nconst VectorGeometryComponent = forwardRef<VectorLayer | undefined, Omit<VectorGeometryProps, 'ref'>>(\n  function VectorGeometry(\n    { style, layers, streets, roofs, facades = false, paint, visible = true, order = 0, onLayer },\n    ref,\n  ) {\n    const binding = useContext(MapContext);\n    const swipe = useContext(SwipeContext);\n    const latest = useRef({ order, onLayer });\n    /** The paint properties sent to the current layer */\n    const sent = useRef<Paint>(undefined);\n    const [layer, setLayer] = useState<VectorLayer>();\n\n    latest.current = { order, onLayer };\n    useImperativeHandle(ref, () => layer, [layer]);\n\n    // The tiles and their geometry layer created once the map is there, in the declared order; made anew when the\n    // style, the layers kept, the streets or the roofs change; the tiles (and their layer) destroyed when unmounted\n    useEffect(() => {\n      if (!binding) return;\n\n      const tiles = binding.map.vectorTiles(style === undefined ? {} : { style });\n      const created = tiles.vectors({\n        ...(layers && { layers }),\n        ...(streets && { streets }),\n        ...(roofs && { roofs }),\n      });\n\n      binding.order.place(created, latest.current.order);\n      swipe?.set(created);\n      sent.current = undefined;\n      setLayer(created);\n      latest.current.onLayer?.(created);\n\n      return () => {\n        binding.order.remove(created);\n        swipe?.unset(created);\n        tiles.destroy();\n        setLayer(undefined);\n      };\n    }, [binding, swipe, style, layers, streets, roofs]);\n\n    // The paint properties changed since the last ones sent (all of them to a layer made anew), those of a function\n    // once the style is loaded; a later render or layer drops the wait\n    useEffect(() => {\n      if (!layer) return;\n\n      const apply = (next: Paint | undefined) => {\n        changed(sent.current, next).forEach(([id, name, value]) => {\n          layer.setPaintProperty(id, name, value);\n        });\n        sent.current = next;\n      };\n\n      if (typeof paint !== 'function') {\n        apply(paint);\n\n        return;\n      }\n\n      const wait = { live: true };\n\n      layer.ready.then(\n        () => {\n          if (!wait.live) return;\n          apply(\n            Object.fromEntries(\n              layer.layers.flatMap((l) => {\n                const properties = paint(l);\n\n                return properties ? [[l.id, properties]] : [];\n              }),\n            ),\n          );\n        },\n        () => undefined,\n      );\n\n      return () => {\n        wait.live = false;\n      };\n    }, [layer, paint]);\n\n    // The walls' windows shown or not\n    useEffect(() => {\n      layer?.setFacades(facades);\n    }, [layer, facades]);\n\n    // Shown or hidden\n    useEffect(() => {\n      layer?.setVisible(visible);\n    }, [layer, visible]);\n\n    // A new `order`: moved to its new place among the layers of the components\n    useEffect(() => {\n      if (binding && layer) binding.order.place(layer, order, layer);\n    }, [binding, layer, order]);\n\n    return null;\n  },\n);\n\n/**\n * The fills and lines of a MapLibre style drawn as geometry on the globe and the relief (`vectorTiles().vectors()`):\n * sharp at any zoom and pitch, restyled by `paint` without cutting the tiles again, picked by feature\n * (`map.pickFeature`). The ref and `onLayer` give its handle (`VectorLayer`: `layers`, `featureAt`, `ready`)\n */\nexport const VectorGeometry = VectorGeometryComponent as (props: VectorGeometryProps) => ReactNode;\n"]}

package/dist/util/gltf.d.ts

@@ -0,0 +1,9 @@
+/** glTF binaries made by the page (the basemap's trees and lamps, the photos): their bounds, their chunks */
+/** Lowest and highest of interleaved x, y, z (glTF needs them on positions) */
+export declare const bounds: (xyz: readonly number[]) => {
+    min: number[];
+    max: number[];
+};
+/** A glTF binary of its JSON and its buffer, the chunks padded to 4 bytes (the JSON with spaces, the buffer with
+ * zeros) */
+export declare const glbOf: (gltf: unknown, bin: Uint8Array) => Uint8Array<ArrayBuffer>;

package/dist/util/gltf.js

@@ -0,0 +1,27 @@
+/** glTF binaries made by the page (the basemap's trees and lamps, the photos): their bounds, their chunks */
+/** Lowest and highest of interleaved x, y, z (glTF needs them on positions) */
+export const bounds = (xyz) => {
+    const axes = [0, 1, 2].map((a) => xyz.filter((_, i) => i % 3 === a));
+    return { min: axes.map((v) => Math.min(...v)), max: axes.map((v) => Math.max(...v)) };
+};
+/** A glTF binary of its JSON and its buffer, the chunks padded to 4 bytes (the JSON with spaces, the buffer with
+ * zeros) */
+export const glbOf = (gltf, bin) => {
+    const json = new TextEncoder().encode(JSON.stringify(gltf));
+    const jsonLength = Math.ceil(json.length / 4) * 4;
+    const binLength = Math.ceil(bin.byteLength / 4) * 4;
+    const out = new Uint8Array(12 + 8 + jsonLength + 8 + binLength);
+    const view = new DataView(out.buffer);
+    view.setUint32(0, 0x46546c67, true);
+    view.setUint32(4, 2, true);
+    view.setUint32(8, out.length, true);
+    view.setUint32(12, jsonLength, true);
+    view.setUint32(16, 0x4e4f534a, true);
+    out.fill(0x20, 20, 20 + jsonLength);
+    out.set(json, 20);
+    view.setUint32(20 + jsonLength, binLength, true);
+    view.setUint32(24 + jsonLength, 0x004e4942, true);
+    out.set(bin, 28 + jsonLength);
+    return out;
+};
+//# sourceMappingURL=gltf.js.map

package/dist/util/gltf.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gltf.js","sourceRoot":"","sources":["../../src/util/gltf.ts"],"names":[],"mappings":"AAAA,6GAA6G;AAE7G,+EAA+E;AAC/E,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,GAAsB,EAAoC,EAAE;IACjF,MAAM,IAAI,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAErE,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;AACxF,CAAC,CAAC;AAEF;YACY;AACZ,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,IAAa,EAAE,GAAe,EAA2B,EAAE;IAC/E,MAAM,IAAI,GAAG,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;IAC5D,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;IAClD,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;IACpD,MAAM,GAAG,GAAG,IAAI,UAAU,CAAC,EAAE,GAAG,CAAC,GAAG,UAAU,GAAG,CAAC,GAAG,SAAS,CAAC,CAAC;IAChE,MAAM,IAAI,GAAG,IAAI,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAEtC,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,CAAC;IACpC,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC;IAC3B,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACpC,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,UAAU,EAAE,IAAI,CAAC,CAAC;IACrC,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,UAAU,EAAE,IAAI,CAAC,CAAC;IACrC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,EAAE,EAAE,GAAG,UAAU,CAAC,CAAC;IACpC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IAClB,IAAI,CAAC,SAAS,CAAC,EAAE,GAAG,UAAU,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC;IACjD,IAAI,CAAC,SAAS,CAAC,EAAE,GAAG,UAAU,EAAE,UAAU,EAAE,IAAI,CAAC,CAAC;IAClD,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,GAAG,UAAU,CAAC,CAAC;IAE9B,OAAO,GAAG,CAAC;AACb,CAAC,CAAC","sourcesContent":["/** glTF binaries made by the page (the basemap's trees and lamps, the photos): their bounds, their chunks */\n\n/** Lowest and highest of interleaved x, y, z (glTF needs them on positions) */\nexport const bounds = (xyz: readonly number[]): { min: number[]; max: number[] } => {\n  const axes = [0, 1, 2].map((a) => xyz.filter((_, i) => i % 3 === a));\n\n  return { min: axes.map((v) => Math.min(...v)), max: axes.map((v) => Math.max(...v)) };\n};\n\n/** A glTF binary of its JSON and its buffer, the chunks padded to 4 bytes (the JSON with spaces, the buffer with\n * zeros) */\nexport const glbOf = (gltf: unknown, bin: Uint8Array): Uint8Array<ArrayBuffer> => {\n  const json = new TextEncoder().encode(JSON.stringify(gltf));\n  const jsonLength = Math.ceil(json.length / 4) * 4;\n  const binLength = Math.ceil(bin.byteLength / 4) * 4;\n  const out = new Uint8Array(12 + 8 + jsonLength + 8 + binLength);\n  const view = new DataView(out.buffer);\n\n  view.setUint32(0, 0x46546c67, true);\n  view.setUint32(4, 2, true);\n  view.setUint32(8, out.length, true);\n  view.setUint32(12, jsonLength, true);\n  view.setUint32(16, 0x4e4f534a, true);\n  out.fill(0x20, 20, 20 + jsonLength);\n  out.set(json, 20);\n  view.setUint32(20 + jsonLength, binLength, true);\n  view.setUint32(24 + jsonLength, 0x004e4942, true);\n  out.set(bin, 28 + jsonLength);\n\n  return out;\n};\n"]}

package/dist/util/roofs.d.ts

@@ -0,0 +1,10 @@
+/**
+ * The roofs of the buildings as the engine builds them (`RoofShape::number`): the shapes of OpenStreetMap's
+ * `roof:shape`, those it does not draw as the nearest of them, or generated from a building's outline
+ */
+/** A roof generated from its building's outline (`shapes::GENERATED_ROOF`) */
+export declare const GENERATED_ROOF = 255;
+/** The engine's number of a roof shape (`roof:shape`, or `generated`); undefined for a shape it does not know */
+export declare const roofNumber: (shape: string) => number | undefined;
+/** Metres per Mercator unit at a Mercator y (towards the south, [0, 1]): a roof's slopes run in metres */
+export declare const metresAt: (y: number) => number;

package/dist/util/roofs.js

@@ -0,0 +1,30 @@
+/**
+ * The roofs of the buildings as the engine builds them (`RoofShape::number`): the shapes of OpenStreetMap's
+ * `roof:shape`, those it does not draw as the nearest of them, or generated from a building's outline
+ */
+/** OpenStreetMap's `roof:shape` as the engine's roofs (1 flat, 2 hipped, 3 gabled, 4 pyramidal, 5 mansard) */
+const ROOF_SHAPES = {
+    flat: 1,
+    skillion: 1,
+    hipped: 2,
+    'half-hipped': 2,
+    side_hipped: 2,
+    dome: 2,
+    onion: 2,
+    round: 2,
+    gabled: 3,
+    saltbox: 3,
+    pyramidal: 4,
+    cone: 4,
+    mansard: 5,
+    gambrel: 5,
+};
+/** A roof generated from its building's outline (`shapes::GENERATED_ROOF`) */
+export const GENERATED_ROOF = 255;
+/** The Earth's circumference (metres) */
+const EARTH_METRES = 40_075_016.686;
+/** The engine's number of a roof shape (`roof:shape`, or `generated`); undefined for a shape it does not know */
+export const roofNumber = (shape) => shape === 'generated' ? GENERATED_ROOF : ROOF_SHAPES[shape];
+/** Metres per Mercator unit at a Mercator y (towards the south, [0, 1]): a roof's slopes run in metres */
+export const metresAt = (y) => EARTH_METRES * Math.cos(Math.atan(Math.sinh(Math.PI * (1 - 2 * y))));
+//# sourceMappingURL=roofs.js.map

package/dist/util/roofs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"roofs.js","sourceRoot":"","sources":["../../src/util/roofs.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,8GAA8G;AAC9G,MAAM,WAAW,GAAqC;IACpD,IAAI,EAAE,CAAC;IACP,QAAQ,EAAE,CAAC;IACX,MAAM,EAAE,CAAC;IACT,aAAa,EAAE,CAAC;IAChB,WAAW,EAAE,CAAC;IACd,IAAI,EAAE,CAAC;IACP,KAAK,EAAE,CAAC;IACR,KAAK,EAAE,CAAC;IACR,MAAM,EAAE,CAAC;IACT,OAAO,EAAE,CAAC;IACV,SAAS,EAAE,CAAC;IACZ,IAAI,EAAE,CAAC;IACP,OAAO,EAAE,CAAC;IACV,OAAO,EAAE,CAAC;CACX,CAAC;AAEF,8EAA8E;AAC9E,MAAM,CAAC,MAAM,cAAc,GAAG,GAAG,CAAC;AAElC,yCAAyC;AACzC,MAAM,YAAY,GAAG,cAAc,CAAC;AAEpC,iHAAiH;AACjH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,KAAa,EAAsB,EAAE,CAC9D,KAAK,KAAK,WAAW,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;AAE9D,0GAA0G;AAC1G,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,CAAS,EAAU,EAAE,CAAC,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC","sourcesContent":["/**\n * The roofs of the buildings as the engine builds them (`RoofShape::number`): the shapes of OpenStreetMap's\n * `roof:shape`, those it does not draw as the nearest of them, or generated from a building's outline\n */\n\n/** OpenStreetMap's `roof:shape` as the engine's roofs (1 flat, 2 hipped, 3 gabled, 4 pyramidal, 5 mansard) */\nconst ROOF_SHAPES: Readonly<Record<string, number>> = {\n  flat: 1,\n  skillion: 1,\n  hipped: 2,\n  'half-hipped': 2,\n  side_hipped: 2,\n  dome: 2,\n  onion: 2,\n  round: 2,\n  gabled: 3,\n  saltbox: 3,\n  pyramidal: 4,\n  cone: 4,\n  mansard: 5,\n  gambrel: 5,\n};\n\n/** A roof generated from its building's outline (`shapes::GENERATED_ROOF`) */\nexport const GENERATED_ROOF = 255;\n\n/** The Earth's circumference (metres) */\nconst EARTH_METRES = 40_075_016.686;\n\n/** The engine's number of a roof shape (`roof:shape`, or `generated`); undefined for a shape it does not know */\nexport const roofNumber = (shape: string): number | undefined =>\n  shape === 'generated' ? GENERATED_ROOF : ROOF_SHAPES[shape];\n\n/** Metres per Mercator unit at a Mercator y (towards the south, [0, 1]): a roof's slopes run in metres */\nexport const metresAt = (y: number): number => EARTH_METRES * Math.cos(Math.atan(Math.sinh(Math.PI * (1 - 2 * y))));\n"]}

package/dist/wasm/isard.d.ts

@@ -598,14 +598,18 @@ export class Engine {
     setExtrusionAnchors(id: number, key: number, anchors: Float32Array): void;
     /**
      * Adds or replaces batch `key` of an extrusion layer: polygons as for `addFills`, `feature_count` features (the
-     * feature style gives each its height and base height as its two sizes, metres)
+     * feature style gives each its height and base height as its two sizes, metres), each polygon's roof (`Roofs`)
      *
      * # Errors
      *
      * Throws (to JavaScript) when a WebGL buffer or vertex array of the batch cannot be created, or when
      * `feature_count` features need a table texture past the GPU's `MAX_TEXTURE_SIZE`
      */
-    setExtrusionBatch(id: number, key: number, points: Float64Array, ring_start: Uint32Array, polygon_start: Uint32Array, feature: Uint32Array, feature_count: number): void;
+    setExtrusionBatch(id: number, key: number, points: Float64Array, ring_start: Uint32Array, polygon_start: Uint32Array, feature: Uint32Array, feature_count: number, roofs: Uint8Array, roof_heights: Float32Array, metres: number): void;
+    /**
+     * Whether the buildings of an extrusion layer, or of a vector tiles layer, show their windows on their walls
+     */
+    setFacades(id: number, on: boolean): void;
     /**
      * Layer-wide style of a feature layer: opacity as zoom stops (four zooms then four values), the zoom range it
      * shows in (`min_zoom` included, `max_zoom` excluded), whether it shows at all
@@ -755,6 +759,16 @@ export class Engine {
      * Highest pitch the camera accepts, degrees (up to 85)
      */
     setMaxPitch(max: number): void;
+    /**
+     * Lights at night the part of a model layer's model from `from` metres up (a street lamp's head) in `r, g, b`;
+     * `from` not a number: none
+     */
+    setModelGlow(id: number, from: number, r: number, g: number, b: number): void;
+    /**
+     * Highlights the feature `feature` of a model layer's model (an IFC model's element) in `r, g, b`; `feature` not a
+     * number: none
+     */
+    setModelHighlight(id: number, feature: number, r: number, g: number, b: number): void;
     /**
      * Replaces the instances of a model layer (as for `addModels`) and the reference of their altitudes
      */
@@ -838,20 +852,21 @@ export class Engine {
     setSwipe(x: number, right: boolean, layers: Uint32Array, others: Uint32Array): void;
     /**
      * Layer-wide style of a symbol layer: size scale and opacity as zoom stops (four zooms then four values each),
-     * zoom range, visibility
+     * zoom range, visibility, hidden by the buildings
      */
-    setSymbolLayer(id: number, size: Float32Array, opacity: Float32Array, min_zoom: number, max_zoom: number, visible: boolean): void;
+    setSymbolLayer(id: number, size: Float32Array, opacity: Float32Array, min_zoom: number, max_zoom: number, visible: boolean, occluded: boolean): void;
     /**
      * Labels of a symbol layer, shaped by the page: anchors (Mercator, interleaved), their texts' boxes (min x, min y,
-     * max x, max y, CSS pixels from the anchor), styles (36 floats each, see `LABEL_FLOATS`) and glyph and icon quads
-     * (11 floats each, see `QUAD_FLOATS`)
+     * max x, max y, CSS pixels from the anchor), styles (37 floats each, see `LABEL_FLOATS`), glyph and icon quads
+     * (11 floats each, see `QUAD_FLOATS`) and the lines their curved texts follow (`paths`: for each label, its number
+     * of points, the index of its anchor among them, then the points, Mercator; 0, 0 and none for the others)
      *
      * # Errors
      *
      * Throws (to JavaScript) when the labels need a table texture past the GPU's `MAX_TEXTURE_SIZE`, or
      * when it cannot be created; the layer then keeps its labels
      */
-    setSymbols(id: number, anchors: Float64Array, boxes: Float32Array, styles: Float32Array, quads: Float32Array): void;
+    setSymbols(id: number, anchors: Float64Array, boxes: Float32Array, styles: Float32Array, quads: Float32Array, paths: Float64Array): void;
     /**
      * Relief under the raster layers, from raw altitudes (`image/x-bil;bits=32`, 256 × 256, or the same followed by
      * the validity mask of an `ArcGIS` raw grid): `url` is a template with `{bbox}` (WMS `GetMap` in EPSG:3857, or in
@@ -879,13 +894,17 @@ export class Engine {
      */
     setTiles3dStyle(id: number, max_error: number, opacity: number, point_size: number | null | undefined, color: Float32Array): void;
     /**
-     * The style layers of a vector tile layer, in drawing order: per layer, its kind (0 fill, 1 line, 2 extrusion), its zoom range
+     * The style layers of a vector tile layer, in drawing order: per layer, its kind (0 fill, 1 line, 2 extrusion, 3
+     * circle), its zoom range
      * (two numbers: shown from the first, included, to the second, excluded), whether it shows (0 or 1), its dashes
      * (four numbers: dash, gap, dash, gap, in line widths; 0: solid), its opacity as zoom stops (four zooms then four
      * values; missing: opaque), the caps of its lines' ends (0 butt, 1 round, 2 square; missing: round), whether its
-     * lines glow at night (streets; 0 or 1)
+     * lines glow at night (streets; 0 or 1), the joins of its lines (two numbers: 0 round, 1 miter, 2 bevel, then the
+     * miter limit in line widths; missing: round), the translation of its fills or lines (three numbers: x and y in CSS
+     * pixels, x right and y down, then 0 if it turns with the map, 1 if it stays on the screen; missing: none), whether its
+     * fills have patterns (0 or 1)
      */
-    setVectorSublayers(id: number, kinds: Uint8Array, zooms: Float64Array, visible: Uint8Array, dashes: Float32Array, opacities: Float32Array, caps: Uint8Array, lit: Uint8Array): void;
+    setVectorSublayers(id: number, kinds: Uint8Array, zooms: Float64Array, visible: Uint8Array, dashes: Float32Array, opacities: Float32Array, caps: Uint8Array, lit: Uint8Array, joins: Float32Array, translates: Float32Array, patterned: Uint8Array): void;
     /**
      * Adds or replaces tile `key` of a vector tile layer ready for the GPU, as the basemap workers make it (the
      * tessellation module): its polygons as for `setVectorTile` (picked here; their prisms built here if drawn in
@@ -902,20 +921,30 @@ export class Engine {
      * created, or when its features or lines need a table texture past the GPU's `MAX_TEXTURE_SIZE`
      */
     setVectorTileMesh(id: number, key: number, points: Float64Array, ring_start: Uint32Array, polygon_start: Uint32Array, polygon_feature: Uint32Array, fill_start: Uint32Array, vertices: Uint8Array, indices: Uint32Array, fill_ranges: Uint32Array, prism: boolean, pieces: Uint8Array, line_table: Float32Array, line_ranges: Uint32Array, blocks: Uint8Array, block_indices: Uint32Array, block_ranges: Uint32Array, bounds: Float64Array, feature_count: number): void;
+    /**
+     * The points of tile `key` of a vector tile layer, after the tile itself (`setVectorTile`, `setVectorTileMesh`):
+     * Mercator, interleaved, each with its feature (styled as a circle's: a color, a radius and a stroke width, then the
+     * stroke's color), `start` the first point of each sublayer and the end; the circle sublayers draw theirs
+     */
+    setVectorTilePoints(id: number, key: number, points: Float64Array, feature: Uint32Array, start: Uint32Array): void;
     /**
      * Adds or replaces tile `key` of a vector tile layer: its polygons as for `addFills` (`fill_start`: the first
      * polygon of each sublayer, and the end; those of an extrusion sublayer raised into blocks), its lines as for
      * `addLines` (`line_start`: the first line of each sublayer, and the end), `feature_count` features, styled as an
      * extrusion layer's (`setFeatureStyle` with the key: a color, then a line's width or a block's height and base);
      * `tile`: the corners of the tile they are cut to (west, north, east, south; empty: none), along whose edges no
-     * wall of a block rises
+     * wall of a block rises; `roofs` and `roof_heights`: per polygon, the shape and height of its block's roof
+     * (`shapes::Roofs`: 0 flat, 1 to 5 `RoofShape::number`, 255 generated from its outline; metres, not a number: as
+     * its slopes make it; empty: flat), the whole outlines of the buildings the tile cuts (`roof_outlines`, interleaved
+     * Mercator points, `roof_outline_start`: where each polygon's starts, and the end), `roof_metres` the metres per
+     * Mercator unit at the tile
      *
      * # Errors
      *
      * Throws (to JavaScript) when a WebGL object of the tile cannot be created, or when its features or lines need a
      * table texture past the GPU's `MAX_TEXTURE_SIZE`
      */
-    setVectorTile(id: number, key: number, points: Float64Array, ring_start: Uint32Array, polygon_start: Uint32Array, polygon_feature: Uint32Array, fill_start: Uint32Array, line_points: Float64Array, line_first: Uint32Array, line_feature: Uint32Array, line_start: Uint32Array, feature_count: number, tile: Float64Array): void;
+    setVectorTile(id: number, key: number, points: Float64Array, ring_start: Uint32Array, polygon_start: Uint32Array, polygon_feature: Uint32Array, fill_start: Uint32Array, line_points: Float64Array, line_first: Uint32Array, line_feature: Uint32Array, line_start: Uint32Array, feature_count: number, tile: Float64Array, roofs: Uint8Array, roof_heights: Float32Array, roof_outlines: Float64Array, roof_outline_start: Uint32Array, roof_metres: number): void;
     /**
      * Shows what can be seen from points, each within its range: `observers` holds 8 numbers per observer
      * (16 at most): longitude, latitude (degrees), metres above the ground, range (metres), then to look one way
@@ -989,6 +1018,11 @@ export class Engine {
      * A region of the icon atlas: `width` × `height` RGBA texels (premultiplied) at (`x`, `y`)
      */
     updateIconAtlas(x: number, y: number, width: number, height: number, data: Uint8Array): void;
+    /**
+     * Uploads a part more of the blocks of tile `key` of a vector tile layer (a large tile's, a part at a time over
+     * several frames); whether some are left. Its blocks are drawn once they are all there
+     */
+    uploadVectorTile(id: number, key: number): boolean;
     /**
      * Vector tiles (512 CSS pixels across at their level, as `MapLibre`'s) for the view of the last frame (else the
      * camera's), levels `min_z` to `max_z`, three numbers per tile (z, x, y), the nearest to the eye first: what a
@@ -1078,7 +1112,8 @@ export interface InitOutput {
     readonly engine_setCircleAlignment: (a: number, b: number, c: number) => void;
     readonly engine_setCircles: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
     readonly engine_setExtrusionAnchors: (a: number, b: number, c: number, d: number, e: number) => [number, number];
-    readonly engine_setExtrusionBatch: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number, k: number, l: number) => [number, number];
+    readonly engine_setExtrusionBatch: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number, k: number, l: number, m: number, n: number, o: number, p: number, q: number) => [number, number];
+    readonly engine_setFacades: (a: number, b: number, c: number) => void;
     readonly engine_setFeatureLayer: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => void;
     readonly engine_setFeatureMask: (a: number, b: number, c: number, d: number, e: number) => void;
     readonly engine_setFeatureRamp: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
@@ -1104,6 +1139,8 @@ export interface InitOutput {
     readonly engine_setLineDash: (a: number, b: number, c: number, d: number) => void;
     readonly engine_setLines: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number) => [number, number];
     readonly engine_setMaxPitch: (a: number, b: number) => void;
+    readonly engine_setModelGlow: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
+    readonly engine_setModelHighlight: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
     readonly engine_setModelInstances: (a: number, b: number, c: number, d: number, e: number) => void;
     readonly engine_setNetworkCosts: (a: number, b: number, c: number, d: number) => void;
     readonly engine_setNetworkRamp: (a: number, b: number, c: number, d: number) => void;
@@ -1118,14 +1155,15 @@ export interface InitOutput {
     readonly engine_setSky: (a: number, b: number) => void;
     readonly engine_setSun: (a: number, b: number, c: number, d: number, e: number) => [number, number];
     readonly engine_setSwipe: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => void;
-    readonly engine_setSymbolLayer: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number) => void;
-    readonly engine_setSymbols: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number) => [number, number];
+    readonly engine_setSymbolLayer: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number) => void;
+    readonly engine_setSymbols: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number, k: number, l: number) => [number, number];
     readonly engine_setTerrain: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => [number, number];
     readonly engine_setTileLoader: (a: number, b: any) => void;
     readonly engine_setTiles3dStyle: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number) => void;
-    readonly engine_setVectorSublayers: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number, k: number, l: number, m: number, n: number, o: number, p: number) => void;
-    readonly engine_setVectorTile: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number, k: number, l: number, m: number, n: number, o: number, p: number, q: number, r: number, s: number, t: number, u: number, v: number, w: number, x: number) => [number, number];
+    readonly engine_setVectorSublayers: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number, k: number, l: number, m: number, n: number, o: number, p: number, q: number, r: number, s: number, t: number, u: number, v: number) => void;
+    readonly engine_setVectorTile: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number, k: number, l: number, m: number, n: number, o: number, p: number, q: number, r: number, s: number, t: number, u: number, v: number, w: number, x: number, y: number, z: number, a1: number, b1: number, c1: number, d1: number, e1: number, f1: number, g1: number) => [number, number];
     readonly engine_setVectorTileMesh: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number, k: number, l: number, m: number, n: number, o: number, p: number, q: number, r: number, s: number, t: number, u: number, v: number, w: number, x: number, y: number, z: number, a1: number, b1: number, c1: number, d1: number, e1: number, f1: number, g1: number, h1: number, i1: number) => [number, number];
+    readonly engine_setVectorTilePoints: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number) => void;
     readonly engine_setViewshed: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number) => [number, number];
     readonly engine_setZoomRange: (a: number, b: number, c: number) => void;
     readonly engine_stats: (a: number) => any;
@@ -1139,6 +1177,7 @@ export interface InitOutput {
     readonly engine_updateGlyphPage: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number) => void;
     readonly engine_updateGroundTexture: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number, k: number) => [number, number];
     readonly engine_updateIconAtlas: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => void;
+    readonly engine_uploadVectorTile: (a: number, b: number, c: number) => number;
     readonly engine_vectorTilesInView: (a: number, b: number, c: number) => [number, number];
     readonly engine_wantedTiles: (a: number, b: number) => [number, number];
     readonly engine_zoomAt: (a: number, b: number, c: number, d: number) => void;