@snaptrude/plugin-core 0.9.6 → 0.11.0-rc.1

package/CHANGELOG.md

@@ -1,5 +1,22 @@
 # @snaptrude/plugin-core
 
+## 0.11.0
+
+### Minor Changes
+
+- **BREAKING — `design.create.floor` returns `ComponentHandle[]`** (was a single handle): the engine may split the footprint into several floors or merge it into a pre-existing neighbour; the call returns every floor covering the requested footprint after parametric resolution (created and/or absorbing; `[floor]` for a simple create). Destructure the first element for the previous single-floor behavior.
+
+- 13c1fb5: Plugin API 0.11.0 — additive types for the ParametricGraphsV2 (PG2) remediation. Strictly additive: no existing signature or result shape changes; deployed plugins are unaffected.
+  - **`design.query.getProperties` — `isVisible`**: new optional read-only property — whether the entity currently has a visible representation on canvas (user hide flag AND LOD/mode gating both considered). Read-only: it is deliberately NOT a `PluginEntityFilter` field.
+  - **Error codes — four appended**: `HANDLE_STALE` (a handle the caller legitimately held that a parametric resolution — merge/split/rebuild — has since retired; the one deliberate exception to the `HANDLE_INVALID` collapse, which forged/never-issued ids still get), `KIND_HIDDEN_IN_MODE` (the entity kind has no representation in the current mode/LOD), `MERGED_INTO_EXISTING` (created geometry merged into an existing entity — use the surviving handles), `BLOCKED_IN_BIM` (operation unavailable in BIM mode). Wrong-kind targets deliberately did NOT get a new code — the existing `HANDLE_KIND_MISMATCH` already covers them.
+  - **`design.delete.entities` — cascade report**: now returns `PluginDesignDeleteResult` — the shared change-result shape plus an optional `cascaded` `ComponentHandle[]`: components PG2 removed as a consequence (derived walls/floors/slabs of deleted spaces), returned for cache invalidation. The shared `PluginDesignChangeResult` used by lock/selection/visibility is unchanged.
+  - **`design.create.furniture` placement is grounded**: `position.y` = bounding-box bottom, always; origin-relative placement removed (plugins recompute during the fleet upgrade).
+  - **`design.create.walls` honors the engine's resolution**: touching curves may merge/split against existing walls; returns the actually-created set (count may differ from input curves). The 1:1-per-curve abort is removed; no `strict` flag.
+  - **`design.update.space` / `.spaces` — `rebuilt`**: `PluginSpaceUpdateResult` gains an optional `rebuilt` boolean — a geometry update rebuilt the space's derived BIM (hosted children re-created, previous derived handles retired).
+  - **`design.query.spaces.listGeneratedBim(space)`**: new read — the space's engine-derived BIM component handles as `{ walls, floors, slabs }` (`PluginSpaceGeneratedBim`). The set changes on merge/split — re-query after writes; this is the churn-recovery anchor for stale derived handles.
+  - **`presentation.placedViews`**: the placed-view record gains optional `lod` (`PluginViewLod`: `"design" | "bim"`) and `inactiveBuildingMask` fields; new `setLod(shapeId, lod)` sets the level of detail a placed view renders at.
+  - **`presentation.sheets.place` — `options.lod`**: optional `PluginViewLod` — the LOD of the placed view (default: the product's Design default).
+
 ## 0.9.6
 
 ### Patch Changes