@snaptrude/plugin-core 0.5.0 → 0.7.0

package/CHANGELOG.md

@@ -1,5 +1,78 @@
 # @snaptrude/plugin-core
 
+## 0.7.0
+
+### Minor Changes
+
+- e1915e4: Plugin API 0.7.0 — new families and methods (supersedes the cancelled `design.update.setLabel` 0.6.1 patch, now folded in).
+  - **`core.proposals.*`** — design options as infrastructure: `list` / `get` / `getActive` / `listForComponent` / `isActive` (reads) plus `create` / `rename` / `setActive` / `delete` (non-undoable writes).
+  - **`program.layout.*`** — the space-solver promoted to a real async-job family: `arrange` / `pack` now start a backend job and return immediately, with `getState` (poll) and `cancel`.
+  - **Door & window catalogs + placement** — `design.doors.*` / `design.windows.*` gain `listCatalogGroups` / `listCatalog` / `getCatalogItem` / `exists` (shared catalog DTOs), and `design.create.door` / `design.create.window` place a catalog item into a host wall.
+  - **`design.create.smartLayout`** — clone an in-scene template cluster into one or more target spaces in a single undo batch.
+  - **Furniture categories** — `design.furniture.listCategories` plus a `category` filter on `listCatalog`, and `thumbnailUrl` on catalog items.
+  - **`design.transform.align`** — snap components' bounding-box edges (left/right/center/top/bottom/middle), optionally to a reference.
+  - **Per-face materials** — `design.materials.applyToFaces` / `resetFaces` / `getByFace` / `listByFace` (BREP faces by durable index, visual-only).
+  - **Staircase params** — `design.query.getStaircaseParams` (read) and `design.update.staircase` (sparse parametric write).
+  - **Footprint-area lock** — `design.lockArea` / `unlockArea` / `isAreaLocked` / `listAreaLocked` for Room/Department spaces.
+  - **`entity.story.duplicate`** — duplicate a storey (or a subset) up/down, auto-creating the target storey.
+  - **`presentation.import.svg`** — import a guaranteed-vector SVG onto the Present sheet.
+  - **View display settings** — `presentation.views.getSettings` / `updateSettings` (background, color mode, axis, edges, labels).
+  - **`design.update.setLabel`** — set any component's panel Label (write pair of `design.query.getLabel`); undoable, lock-aware, validated.
+  - **`program.areas`** — area members now report their `areaClass` (`NET` / `GROSS` / `EXCLUDED`), with net/gross documented as the plain-English synonyms for carpet/built-up.
+  - **Typed plugin API errors** — every host failure now crosses the wire as a structured envelope instead of a flattened `Execution error: <msg>` string: a stable `code` from the shared plugin-core error registry, the offending handle, an authored `hint`, and `retryAfterMs` / `didYouMean` enrichment where applicable. Zod validation failures forward the first 10 issues, each projected to `{path, code, message}` (full count in `details.issueCount`); internal faults are sanitized and host-logged under an `errorId`. Every handler across the API surface now throws typed codes, each doc page gained an Errors section, and a drift test pins thrown code literals to the registry.
+
+## 0.6.0
+
+### Minor Changes
+
+- 934405e: New `analysis.heatmaps` family — render plugin-computed scalar data as a
+  heatmap: `renderSpaces` (flat colour per space top face), `renderGrid`
+  (coloured grid mesh from world-coordinate samples), `reset`, `isActive`.
+  Single active heatmap (a render replaces the previous one); values outside
+  `[min, max]` clamp to the end colours; ephemeral (auto-cleared on
+  scene-mutating edits, never persisted). The react host has landed, so all
+  members are required `abstract` and in the discovery manifest.
+- a68e866: New top-level `analysis` namespace:
+  `analysis.sunpath` (enable/disable/isActive), `analysis.shadows`
+  (enable/disable/isEnabled/setDateTime/getDateTime — ISO date-time strings),
+  and the async heatmap job families `analysis.sunlightHours` and
+  `analysis.illuminance` (compute/get/cancel/reset; illuminance is Pro-gated).
+  Also extends `program.site` with `getLocation()` and `getNorthAngle()` geo
+  reads. The react host has landed, so all new members are required `abstract`
+  and in the discovery manifest; the plugin-client mounts the `analysis` RPC
+  namespace.
+- New `core.io` namespace — file import, import jobs, and underlay/terrain
+  management:
+  - `core.io.import` — bring external files onto a storey: `image`, `pdf`
+    (page-selectable), `dwg`, `cadJson` (parsed CAD geometry as a sketch),
+    `model` (3D formats), and `terrain` (map snapshot at a lat/lng with
+    optional elevation). Slow formats return an `ImportJobHandle` instead of
+    blocking.
+  - `core.io.job` — poll those imports: `getStatus`, `isComplete`, `getResult`,
+    `getError`.
+  - `core.io.query` — pre-import inspection: `getPdfPageCount`,
+    `listCadLayers`.
+  - `core.io.underlay` — manage imported image/PDF/CAD underlays: `list`,
+    `getBounds`, `getScale`/`setScale`/`resetScale`, `getOpacity`/`setOpacity`,
+    `delete`.
+  - `core.io.terrain` — manage the imported map terrain: `exists`, `get`,
+    `getDatum` (current vertical position, world Y) / `setDatum` (relative
+    datum shift, not an absolute elevation), `delete`, `getReport`, elevation and satellite-imagery toggles
+    (`isElevationEnabled`/`enableElevation`/`disableElevation`,
+    `isSatelliteEnabled`/`enableSatellite`/`disableSatellite`), and
+    `getOpacity`/`setOpacity`.
+
+- New `design.selection.setByFilter(filter)` — the programmatic equivalent of
+  the editor's **Story selection** and **Filter selection** menus. Replaces the
+  selection with every visible entity of the active building matching
+  `{ storeys?: number[], types?: PluginSelectionEntityType[] }` (fields AND,
+  values within a field OR; at least one field required — use `clear()` to
+  deselect). The new `PluginSelectionEntityType` vocabulary covers all 24 menu
+  kinds, including selection-only kinds the query surface can't reach (sites,
+  terrain, CAD/PDF/image imports, dimension lines, 3D models, neighborhood
+  buildings, program blocks). One-shot bulk select, not a persistent mode; not
+  undoable, like the other selection mutators.
+
 ## 0.5.0
 
 ### Minor Changes