@snaptrude/plugin-core 1.0.2 → 1.0.4

package/AGENTS.md

@@ -214,6 +214,23 @@ check **all** consumers of `@snaptrude/plugin-client` or `@snaptrude/plugin-core
 
 Search these directories for usage of the changed API and update accordingly.
 
+### 8. snapagents (every API change, breaking or not)
+
+The Snap agent (`snapagents` repo) does not install this package. It keeps a synced copy of the
+built `dist/**/*.d.ts` under `plugin-types/plugin-core/` and compiles every script the
+agent writes against them before it runs, so a stale copy means the agent is held
+to an old API. After a plugin-core release, in the snapagents checkout run:
+
+```bash
+npm run sync:plugin-core -- <path to packages/plugin-core>
+```
+
+It copies new and changed declaration files, keeps snapagents' agent-only files,
+refuses to overwrite its hand-merged files (and prints what to merge), and stamps
+`plugin-types/plugin-core/.synced.json` with the version. Where the editor validates a
+parameter against a fixed list, declare it as that literal union here, not as
+`string`: the agent's type-check can only reject what the type names.
+
 ## Adding a new API namespace (end-to-end)
 
 When adding an entirely new namespace (e.g. `snaptrude.materials`):

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @snaptrude/plugin-core
 
+## 1.0.4
+
+### Patch Changes
+
+- 3862bd8: handles: new `Vec3Input` (a `Vec3Handle` in any inbound form, or a plain finite `{ x, y, z }` point) is the type of every vec3 ARGUMENT — transform displacement/axis/pivot, create positions and directions, opening facing/hinge, dimension ends, camera eye/target, `core.math.vec3` operands, geometry create/update/query points. Geometry reads return plain points, so they can be passed straight back; hosts from Oct 2026 resolve the point as a vector, older hosts reject it as an invalid handle. Returns stay `Vec3Handle`. `PluginDesignChangeResult` gains optional `cascaded`, `missing` and `rejected` (delete only). design.delete / design.transform JSDoc updated. The openings' `position` / `facing` / `hinge` (`design.create.door` / `window` / `doors` / `windows` / `opening`) take `Vec3Input` too. `PluginPresentationViewsCreateResult` declares the `framed` flag `views.create` already returns.
+
+## 1.0.3
+
+### Patch Changes
+
+- Add `design.doors.checkPlacement` and `design.windows.checkPlacement` — trial an opening's host fit, cut and material clearance (plus up to 12 `candidateWidths`) and restore the model without publishing commands, history or saves. A width/height on a family sized by its Type (Custom Sizes off) now picks the Type within 25 mm, else turns Custom Sizes on; `checkPlacement` reports which as `sizing`, and `design.create.door(s)` / `window(s)` apply the same rule. Door docs: a room door's `facing` goes inside the room it serves, and `getSwingDirection` / `mirror` point to `design.validation.access()` `opensInto` for which room a door opens into.
+
 ## 1.0.2
 
 ### Patch Changes