@snaptrude/plugin-client 0.9.1 → 0.9.3

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # @snaptrude/plugin-client
 
+## 0.9.3
+
+### Patch Changes
+
+- 3584bde: Expose configured BIM creation and Site Analysis sheet APIs: `design.create.opening` (catalog door/window with width/height/sillHeight), staircase `dimensions` overrides (strict-validated, quarter-turn rotation), and `program.site.getSiteAnalysis`/`updateSiteAnalysis` with merge/append semantics. `PluginSiteAnalysisUpdateOptions` accepts `null` as "no options".
+- Updated dependencies [3584bde]
+  - @snaptrude/plugin-core@0.9.3
+
+## 0.9.2
+
+### Patch Changes
+
+- 5b91c7b: OCC geometry batch: new `core.geom.create` brep constructors — `brepFromFillet`, `brepFromChamfer`, `brepFromOffset`, `brepFromShell`, `brepsFromSplit`, `brepFromSweep`, `brepFromRevolution`; `brepFromLoft` widened with optional `intermediateContours` (multi-section lofts); new `core.geom.query.brep.getDistance` (minimum distance between two solids with witness points).
+- Updated dependencies [5b91c7b]
+  - @snaptrude/plugin-core@0.9.2
+
 ## 0.9.0
 
 ### Minor Changes
@@ -12,7 +28,6 @@
 
 - More additions to the APIs, infra changes.
 - Plugin API 0.8.0 — the 0.8 API wave, handle lifecycle, and worker events.
-
   - **Events** — `PluginWorker.subscribe("model:changed", handler)`: debounced model-change notifications delivered to the worker for user and plugin edits alike; subscriptions live for the plugin's lifetime and are cleared automatically on stop.
   - **The 0.8 API wave** — client types/passthrough for export, element editing, camera, storey management, visibility, dimensions, locale/user reads, and the behavior corrections in the host (world-unit `program.site` footprints, real beam/column geometry, live-only `design.query.list*`); see `@snaptrude/plugin-core@0.8.0` and `upgrade-notes/0.7.1-to-0.8.0.md`.
   - **Handle lifecycle (`core.handles.*`) + GC-backed `Handle` objects** — `Handle` is now a class wrapping the wire id (public type names unchanged): `handle.id`, `toString()` stays the bare id, `equals()` compares by id, and `toJSON()` emits the `{__h: id}` wire tag — `JSON.stringify` output containing handles changes shape. New namespace: `core.handles.release(handles[])` (batched, arena-agnostic, silent no-op on unknown/released ids), `core.handles.releaseAll(kind?)`, mint-recording scopes `beginScope()` / `endScope(scope, retain?)` (token-addressed, retain promotes to the enclosing scope), and `core.handles.stats()`. The client runs a FinalizationRegistry-backed auto-release queue, so unreferenced handles are reclaimed host-side without explicit code. `core.geom.delete.profile/contour` are retained as deprecated aliases of `core.handles.release`. Entity-style kinds (component/material/underlay/terrain/importJob) remain branded strings.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@snaptrude/plugin-client",
-  "version": "0.9.1",
+  "version": "0.9.3",
   "type": "module",
   "main": "./dist/index.js",
   "module": "./dist/index.js",
@@ -23,7 +23,7 @@
   ],
   "dependencies": {
     "comlink": "^4.4.2",
-    "@snaptrude/plugin-core": "0.9.1"
+    "@snaptrude/plugin-core": "0.9.3"
   },
   "devDependencies": {
     "tsup": "^8.5.1",

package/upgrade-notes/0.8.0-to-0.9.0.md

@@ -10,26 +10,7 @@ breaking: false
 
 ## Breaking changes
 
-None. All 0.9.0 moves are deprecate-in-place aliases; no signatures or result shapes changed on existing paths.
-
-## Moved paths (deprecated → canonical)
-
-- `entity.story.get` → `core.storeys.get`
-- `entity.story.getAll` → `core.storeys.list` — the canonical result names the field `storeys` where `getAll` named it `stories`; the records are identical
-- `entity.story.create` → `core.storeys.create`
-- `entity.story.update` → `core.storeys.update`
-- `entity.story.delete` → `core.storeys.delete`
-- `entity.story.duplicate` → `core.storeys.copy`
-- `entity.story.setActive` → `core.storeys.setActive`
-- `entity.referenceLine.createMulti` → `design.create.referenceLines` — adds optional styling args and returns a `ComponentHandle[]` where `createMulti` returned `{ referenceLineIds }`
-- `entity.referenceLine.get` → `design.query.referenceLines.get`
-- `entity.referenceLine.getAll` → `design.query.listReferenceLines` — returns a filterable `ComponentHandle[]` where `getAll` returned `{ referenceLineIds }`
-- `entity.referenceLine.delete` → `design.delete.entities`
-- `entity.buildableEnvelope.create` → `design.create.buildableEnvelope`
-- `entity.buildableEnvelope.update` → `design.update.buildableEnvelope`
-- `core.zoom.extents` → `core.camera.zoomExtents`
-- `core.zoom.selection` → `core.camera.zoomSelection`
-- `core.tags.getTagsForComponent` → `core.tags.listForComponent`
+_None._
 
 ## New APIs
 
@@ -56,6 +37,31 @@ None. All 0.9.0 moves are deprecate-in-place aliases; no signatures or result sh
 - **`design.create.massFromBrep(brep, label?)`** — commit a mass from any `core.geom.create` brep constructor's handle (scene-derived `getBrep` breps stay read-only → `PRECONDITION_FAILED`): generic mass at the authored coordinates, single undo step, collab-synced. Together with the constructors this closes the loop — author faces / extrude / loft / boolean, then place the result in the scene.
 - **`presentation.placedViews` — layout control over placed views.** Inspect and edit the LAYOUT of view shapes already placed on Present sheets (content refresh stays on `sheets.updatePlacedView`): `list(sheetId?)` / `get(shapeId)` return sheet, sheet-local position, size, architectural scale (`null` for 3D), rotation, crop and link state; `move(shapeId, position, { sheetId? })` repositions or reparents across sheets; `scale(shapeId, factor)` is a uniform corner-drag-equivalent resize; `setScale(shapeId, scale)` sets a standard architectural scale (2D views only); `setCrop(shapeId, crop | null)` crops with native tldraw fractions, keeping the visible region page-anchored — and the crop survives `updatePlacedView` refreshes. Identity is the shape id `sheets.place` returns.
 
+## Behavior changes
+
+All 0.9.0 namespace moves are deprecate-in-place aliases — no signatures or
+result shapes changed on existing paths; each deprecated path delegates to the
+same implementation as its canonical replacement.
+
+### Moved paths (deprecated → canonical)
+
+- `entity.story.get` → `core.storeys.get`
+- `entity.story.getAll` → `core.storeys.list` — the canonical result names the field `storeys` where `getAll` named it `stories`; the records are identical
+- `entity.story.create` → `core.storeys.create`
+- `entity.story.update` → `core.storeys.update`
+- `entity.story.delete` → `core.storeys.delete`
+- `entity.story.duplicate` → `core.storeys.copy`
+- `entity.story.setActive` → `core.storeys.setActive`
+- `entity.referenceLine.createMulti` → `design.create.referenceLines` — adds optional styling args and returns a `ComponentHandle[]` where `createMulti` returned `{ referenceLineIds }`
+- `entity.referenceLine.get` → `design.query.referenceLines.get`
+- `entity.referenceLine.getAll` → `design.query.listReferenceLines` — returns a filterable `ComponentHandle[]` where `getAll` returned `{ referenceLineIds }`
+- `entity.referenceLine.delete` → `design.delete.entities`
+- `entity.buildableEnvelope.create` → `design.create.buildableEnvelope`
+- `entity.buildableEnvelope.update` → `design.update.buildableEnvelope`
+- `core.zoom.extents` → `core.camera.zoomExtents`
+- `core.zoom.selection` → `core.camera.zoomSelection`
+- `core.tags.getTagsForComponent` → `core.tags.listForComponent`
+
 ## No action needed
 
 All 0.9.0 changes are additive. Deprecated paths remain until at least the next major version, and removal is gated on call metrics showing zero live traffic plus a consumer sweep. To modernize a plugin: rename calls per the moved-paths list above (only `core.storeys.list` and the two reference-line list/create reads have different result shapes from their predecessors — everything else is a pure rename).