@nika-js/onlymap 0.6.0 → 0.6.1

package/onlymapjs.html-data.json

@@ -127,6 +127,9 @@
             },
             {
               "name": "maptiler-terrain"
+            },
+            {
+              "name": "mapterhorn"
             }
           ]
         },
@@ -239,6 +242,9 @@
             {
               "name": "ArcLayer"
             },
+            {
+              "name": "BIMLayer"
+            },
             {
               "name": "BitmapLayer"
             },
@@ -442,6 +448,18 @@
           "name": "source",
           "description": "registerSource decoder plugin name for stream messages."
         },
+        {
+          "name": "site-origin",
+          "description": "Georeferencing (Tile3DLayer, PathLayer): where the model sits, \"[lng, lat]\" or \"[lng, lat, elevation]\". Overrides a tileset's baked position; required to place a PathLayer of local metres."
+        },
+        {
+          "name": "site-heading",
+          "description": "Georeferencing: bearing in degrees clockwise from true north. On its own, rotates the model where it stands."
+        },
+        {
+          "name": "site-scale",
+          "description": "Georeferencing: uniform scale multiplier (default 1)."
+        },
         {
           "name": "get-position",
           "description": "Accessor for deck.gl getPosition — expression language: $field, scale(), formatDate(), arithmetic."
@@ -890,6 +908,54 @@
           "name": "point-size",
           "description": "deck.gl pointSize."
         },
+        {
+          "name": "pick-features",
+          "description": "deck.gl pickFeatures."
+        },
+        {
+          "name": "feature-id-property",
+          "description": "deck.gl featureIdProperty."
+        },
+        {
+          "name": "feature-styles",
+          "description": "deck.gl featureStyles."
+        },
+        {
+          "name": "feature-color-by",
+          "description": "deck.gl featureColorBy."
+        },
+        {
+          "name": "feature-color-scale",
+          "description": "deck.gl featureColorScale."
+        },
+        {
+          "name": "feature-palette",
+          "description": "deck.gl featurePalette."
+        },
+        {
+          "name": "feature-color-strength",
+          "description": "deck.gl featureColorStrength."
+        },
+        {
+          "name": "feature-filter-field",
+          "description": "deck.gl featureFilterField."
+        },
+        {
+          "name": "isolate-features",
+          "description": "deck.gl isolateFeatures."
+        },
+        {
+          "name": "hide-features",
+          "description": "deck.gl hideFeatures."
+        },
+        {
+          "name": "ghost-features",
+          "description": "deck.gl ghostFeatures."
+        },
+        {
+          "name": "ghost-opacity",
+          "description": "deck.gl ghostOpacity."
+        },
         {
           "name": "get-point-color",
           "description": "Accessor for deck.gl getPointColor — expression language: $field, scale(), formatDate(), arithmetic."
@@ -1525,6 +1591,18 @@
         {
           "name": "layer",
           "description": "Scope selection-anchored overlays to one layer's picks."
+        },
+        {
+          "name": "selection-type",
+          "description": "Scope selection-anchored overlays to one pick type — \"click\" keeps a click-opened popup from following hover picks; \"hover\" is the mirror. Absent: every pick applies.",
+          "values": [
+            {
+              "name": "click"
+            },
+            {
+              "name": "hover"
+            }
+          ]
         }
       ],
       "references": [
@@ -1741,6 +1819,24 @@
             },
             {
               "name": "widgets-toggle"
+            },
+            {
+              "name": "ifc-browser"
+            },
+            {
+              "name": "ifc-legend"
+            },
+            {
+              "name": "feature-inspector"
+            },
+            {
+              "name": "ifc-inspector"
+            },
+            {
+              "name": "ifc-loader"
+            },
+            {
+              "name": "ifc-clash"
             }
           ]
         },
@@ -1930,6 +2026,62 @@
           "name": "options",
           "description": "Basemap-switcher: space-separated preset names to offer (default: every keyless registered preset)."
         },
+        {
+          "name": "fields",
+          "description": "IFC widgets: space-separated property-table fields — the group-by choices offered by ifc-browser, or the rows shown by feature-inspector. Hierarchy columns render as expandable TREES and are offered automatically when the model has them: \"spatialPath\" (site → storey), \"typePath\", \"systemPath\", \"classificationPath\"."
+        },
+        {
+          "name": "scale-fields",
+          "description": "ifc-browser: space-separated NUMERIC fields offered as graduated colour ramps alongside the categorical ones."
+        },
+        {
+          "name": "rows",
+          "description": "ifc-browser: visible rows before the value list scrolls (default 6)."
+        },
+        {
+          "name": "no-color",
+          "description": "ifc-browser: hide the colour-mode select and leave the model in its own IFC surface colours."
+        },
+        {
+          "name": "show-non-physical",
+          "description": "ifc-browser: include non-physical classes (IfcSpace, IfcOpeningElement, …) in the value list, which are hidden by default."
+        },
+        {
+          "name": "placeholder",
+          "description": "feature-inspector: text shown when nothing is selected."
+        },
+        {
+          "name": "no-outlines",
+          "description": "ifc-loader: skip the companion outline PathLayer for the models it loads."
+        },
+        {
+          "name": "layers",
+          "description": "ifc-clash: the two co-registered model layer ids to compare, e.g. \"arch mep\"."
+        },
+        {
+          "name": "tolerance",
+          "description": "ifc-clash: metres of real interpenetration required before a pair counts (default 0). Raise it to ignore modelling noise."
+        },
+        {
+          "name": "wasm-path",
+          "description": "ifc-loader: serve web-ifc from your own origin instead of unpkg — required for offline, air-gapped or strict-CSP deployments. Vendor the files with `npm run vendor:web-ifc <dir>` first."
+        },
+        {
+          "name": "federate",
+          "description": "ifc-loader: accept SEVERAL models into one co-registered scene (one drop zone, one layer per model, each with its own visibility toggle) instead of replacing the previous one."
+        },
+        {
+          "name": "independent",
+          "description": "ifc-loader: do NOT share the map’s model-space origin — for pages loading unrelated models rather than disciplines of one building."
+        },
+        {
+          "name": "outline-color",
+          "description": "ifc-loader: colour for the outline overlay it builds, e.g. \"[38, 46, 58, 200]\"."
+        },
+        {
+          "name": "ghost-opacity",
+          "description": "ifc-loader: ghost fade for the mesh layer it builds (default 0.15)."
+        },
         {
           "name": "title",
           "description": "Widget heading."

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nika-js/onlymap",
-  "version": "0.6.0",
+  "version": "0.6.1",
   "description": "Declarative deck.gl maps for HTML and React — interactive WebGL mapping with GeoJSON/CSV/Arrow data, MapLibre basemaps, widgets, popups, and live streams from a custom-element manifest or typed React components. TypeScript, no build step.",
   "license": "SEE LICENSE IN LICENSE.md",
   "publishConfig": {
@@ -116,6 +116,7 @@
     "test:e2e": "playwright test",
     "check-layout": "playwright test e2e/layout-audit.spec.ts",
     "gen:html-data": "vite-node dev/generate-html-data.ts",
+    "vendor:web-ifc": "node dev/tools/vendor-web-ifc.mjs",
     "gen:public": "npm run gen:html-data && vite-node dev/build-public.ts",
     "gen:site": "vite-node dev/build-site.ts",
     "test:public": "npm run gen:public -- --dry-run --strict",
@@ -163,6 +164,7 @@
     "hyparquet-compressors": "^1.1.1",
     "jotai": "^2.20.2",
     "maplibre-gl": "^5.24.0",
+    "meshoptimizer": "^1.2.0",
     "mobx": "^6.16.1",
     "playwright": "^1.61.1",
     "proj4": "^2.20.8",

package/skills/onlymapjs/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: onlymapjs
-description: Build, edit, debug, or review OnlyMapJS declarative HTML maps and dashboards, or React maps via the @nika-js/onlymap/react adapter. Use when a user asks for an interactive map, deck.gl-style visualization, geospatial dashboard, live fleet/telemetry map, choropleth, popup/tooltip map, map story/tour, manual drawing/sketch map, 3D map assets, a React map component, a map page shared as a single HTML file (incl. no-JS fallbacks for chat/email previews), a responsive/mobile map whose controls auto-fold on narrow screens, auditing a map's widget layout with the check-layout tool, syncing OnlyMapJS map/camera state into an app state store (Redux, MobX, Zustand, Jotai — the getStore contract), or help with OnlyMapJS syntax, validation, widgets, data formats, testing, or publishing examples.
+description: Build, edit, debug, or review OnlyMapJS declarative HTML maps and dashboards, or React maps via the @nika-js/onlymap/react adapter. Use when a user asks for an interactive map, deck.gl-style visualization, geospatial dashboard, live fleet/telemetry map, choropleth, popup/tooltip map, map story/tour, manual drawing/sketch map, 3D map assets, a React map component, a map page shared as a single HTML file (incl. no-JS fallbacks for chat/email previews), a responsive/mobile map whose controls auto-fold on narrow screens, auditing a map's widget layout with the check-layout tool, syncing OnlyMapJS map/camera state into an app state store (Redux, MobX, Zustand, Jotai — the getStore contract), BIM/IFC models (loading .ifc files in the browser, 3D Tiles per-element picking, isolate/hide/ghost, clash detection, model federation), or help with OnlyMapJS syntax, validation, widgets, data formats, testing, or publishing examples.
 ---
 
 # OnlyMapJS
@@ -23,7 +23,7 @@ Use OnlyMapJS as a declarative HTML map library. Write custom elements such as `
 </script>
 ```
 
-For no-build CDN pages, use the single-file standalone bundle from a raw-file CDN — `https://unpkg.com/@nika-js/onlymap@0.6.0` (the bare package URL serves `dist/onlymap.standalone.js`) — plus `<link rel="stylesheet" href="https://unpkg.com/@nika-js/onlymap@0.6.0/dist/onlymapjs.css">`. Never a rebundling CDN (esm.sh, skypack): re-bundling duplicates the deck.gl/luma.gl runtime and every layer fails shader compilation.
+For no-build CDN pages, use the single-file standalone bundle from a raw-file CDN — `https://unpkg.com/@nika-js/onlymap@0.6.1` (the bare package URL serves `dist/onlymap.standalone.js`) — plus `<link rel="stylesheet" href="https://unpkg.com/@nika-js/onlymap@0.6.1/dist/onlymapjs.css">`. Never a rebundling CDN (esm.sh, skypack): re-bundling duplicates the deck.gl/luma.gl runtime and every layer fails shader compilation.
 
 ## React Projects
 
@@ -73,6 +73,8 @@ Load the smallest reference needed for the task:
 - Group adjacent map buttons (zoom + undo + toggle into one control group) -> just place compact button widgets in the same `position` slot; they auto-cluster. `cluster="false"` opts one out. Do NOT build a wrapper widget.
 - GeoTIFF/COG raster (DEM, satellite imagery, NDVI) -> `<om-layer type="COGLayer" src="…tif">` with `min`/`max`/`colormap` for single-band data (see syntax.md — `src`, not `data`).
 - Zarr / GeoZarr raster (chunked N-D arrays — climate/weather grids, datacubes) -> `<om-layer type="ZarrLayer" src="…​.zarr" variable="…" select="time=0">` with `min`/`max`/`colormap` (same raster styling as COGLayer). Pick the `variable` and pin every non-spatial dim in `select`. A GeoZarr store georeferences itself; a plain Zarr needs manual `bounds` + `crs` + `spatial-dims`. `src`, not `data` — and it can be any absolute URL to a remote store, which needs no server setup but must be CORS-enabled (fetched in the browser) and public (authenticated stores are a follow-up). See syntax.md.
+- BIM model / .ifc file / 3D Tiles with per-element picking -> `<om-layer type="BIMLayer" src="…​.ifc" pickable>` (parses the IFC in-browser; web-ifc WASM is CDN-fetched on first use) or `type="Tile3DLayer" tileset="…" pick-features` for a pre-built tileset. Author `terrain` explicitly (`terrain="mapterhorn"`, or `terrain="off"` for flat ground) — a model that resolves real elevation (IfcMapConversion + OrthogonalHeight) on a terrain-less map raises an error through the validation channel at load time, and the library never writes attributes for you. Style by property with `feature-color-by`/`feature-color-scale` (+ `feature-palette`); isolate/hide/ghost elements declaratively with `feature-filter-field` + `isolate-features`/`hide-features`/`ghost-features` (undoable, story-steppable). See syntax.md.
+- Browse/inspect/clash-check BIM models -> widgets: `ifc-loader` (drop zone, `federate` for multi-model coordination), `ifc-browser` (group/count/colour by any property field), `feature-inspector` (per-element properties on pick; `ifc-inspector` is an alias), `ifc-clash` (AABB clash overlay between two co-registered models). See syntax.md.
 - Geotagged drone JPEG -> `<om-layer type="ImageOverlay" src="…jpg" georeference="exif">`; for saved/collaborative maps persist the processed image and reconstruct with explicit `bounds` (see syntax.md; this is visualization-grade, not orthorectification).
 - Dashed line/route/boundary (or any dashed stroke) -> the `dash` attribute on a path-stroking layer: `dash="[6, 3]"` (or SVG-style `dash="6 3"`, + optional `dash-justified`) on `PathLayer`/`GeoJsonLayer`/`PolygonLayer`/`TripsLayer`. `[dashLength, gapLength]` in line-width units. Do NOT hand-wire deck's `PathStyleExtension`/`getDashArray` — the attribute mounts it; `dash` on a non-path layer is ignored with a warning.
 - CityJSON/CityJSONSeq per-face surfaces mode (`?om-surfaces=1`) -> always pair the `SolidPolygonLayer` with a companion `<om-layer type="PathLayer">` using `get-path="$outline"` to make roof/wall edges visible. This mode is unlit and `SolidPolygonLayer`'s own `wireframe` prop does nothing here (deck only builds wireframe geometry when `extruded: true`); the `PathLayer` is the only way to see face edges. Give it the same `filter-field`/`filter-range` as the fill layer so filtered-out buildings' outlines disappear too. See syntax.md.

package/skills/onlymapjs/references/react.md

@@ -51,7 +51,7 @@ function StatsPanel({ onToggle }) {
 - **`<OmMap>`** — `center`/`zoom`/`pitch`/`bearing` (initial; later changes move the camera, unchanged props never fight user panning), `basemap`, `headless`, `widgetStyle` (layout-token sugar, the `widget-style` attribute's twin: `"gap:10 opacity:0.9"` → `--om-widget-*` custom properties), `widgetsHidden` (hide-all: hides authored managed widget wrappers without removal, so widget state survives; provider attribution and the license badge stay visible in their slots), `widgetsFold` (default true; map-width responsive side drawers, set false to opt out), `onReady`, `onViewStateChange`, `onRuntimeError`. Give it a size via `style`/`className`. `ref` exposes the imperative `MapController` handle: `flyTo`, `setView`, `emit`, `getLayers`, `getSelection`, `injectPick`, `ready` (promise), `project`.
 - **`<OmLayer>`** — `id` + `type` (any registered deck.gl layer type) + deck props. `data`: stable inline reference or URL string (full Data Layer: CSV/Arrow/Shapefile/KML formats, `ws(s)://` streams via `source`/`streamKey`/`flush`, `refresh` polling). `label`/`color` feed `ctx.layers`; `filterField`/`filterRange` = GPU filter; `onClick`/`onHover` receive the flattened picked object (`onHover(null)` = pointer left).
 - **`<OmWidget>`** — positioning shell: `position` takes one of 8 managed slots (logical, RTL-aware: `top-start|top-center|top-end|center-start|center-end|bottom-start|bottom-center|bottom-end`; legacy corners `top-left` etc. alias) + arbitrary JSX. Same-slot widgets stack with flush edges and a shared gap; at map widths ≤640px they auto-fold into per-side drawers (`fold="never"` exempts an essential control); provider attribution joins `bottom-end` and the license badge joins `bottom-start` as in-flow members; `order={1}` sets deterministic in-slot ordering. `position="manual"` renders a plain block at the JSX site — note it sits inside OmMap's overflow-hidden box, so for UI OUTSIDE the map render your own element next to `<OmMap>` and drive the map via `useOmMap()`/the ref instead. (Automatic button-clustering of adjacent compact widgets, and collision-dim of slots under an open overlay, are HTML-lane only — in React, compose your own control group in JSX and dim via your own state.)
-- **`<OmOverlay>`** — geo-anchored HTML with managed projection/tracking/culling. `anchor={[lng, lat]}` or `anchorFrom="selection"` (+ `layer` to scope which picks move it); children may be `(selection) => JSX`; `anchorOffset` (default `bottom-center`); `interactive={false}` for hover-following tooltips.
+- **`<OmOverlay>`** — geo-anchored HTML with managed projection/tracking/culling. `anchor={[lng, lat]}` or `anchorFrom="selection"` (+ `layer` to scope which picks move it, + `selectionType="click"|"hover"` to scope which pick TYPE — a click-opened popup wants `selectionType="click"`, else hovering any pickable feature drags and re-renders it; a click on empty space still dismisses); children may be `(selection) => JSX`; `anchorOffset` (default `bottom-center`); `interactive={false}` for hover-following tooltips.
 - **`useOmMap(watch?)`** — the same `ctx` contract HTML widget scripts get, typed: `layers`, `viewport`, `selection`, `emit`, `data()`, `dataInViewport()`, `stats()`. Watch tokens: `"viewport"`, `"selection"`, `"layers"`, `"data:<layerId>"`. Rides `useSyncExternalStore` (tearing-safe; `ctx` identity stable until a watched token fires).
 - **`controller.getStore(token)`** — framework-free `{subscribe, getSnapshot}` per watch token (cached plain-data snapshots; viewport snapshots carry `origin: "user"|"programmatic"` for echo-free two-way binding). Use it to sync map state into Redux/MobX/Zustand/Jotai — recipes in docs/external-stores.md; never mirror row arrays into a store (use the `data:<id>` version stamp + `ctx.data()`).