@snaptrude/plugin-core 1.0.2-plainpoint-20261026.2 → 1.0.2-plainpoint-20261102.2

package/AGENTS.md

@@ -169,6 +169,7 @@ These are in-browser integration tests that exercise the plugin API end-to-end.
 | `design/query/*`                                  | `tests/designQuery.ts`       |
 | `design/selection/*`                              | `tests/designSelection.ts`   |
 | `design/lock.ts`                                  | `tests/designLock.ts`        |
+| `design/text.ts`                                  | `tests/designText.ts`        |
 | `design/delete/*`                                 | `tests/delete.ts`            |
 | `design/erase/*`                                  | `tests/erase.ts`             |
 | `design/doors/*`                                  | `tests/doors.ts`             |

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @snaptrude/plugin-core
 
+## 1.0.2
+
+### Patch Changes
+
+- c05661a: Add `design.text` — authored text and annotations (Text / Annotate tools): `create`, `list`, `get`, `update`, `setLeader`; texts are `ComponentHandle`s, so delete / move / rotate / copy / hide / lock use the generic design APIs. Paper Pens gains a `"Text"` annotation category (projection pen = leader weight, `annotationText.Text.textMm` size, resolved `text.annotationMm`; no per-view override), and `presentation.placedViews.updateStyles` gains the `"Text"` and `"Annotation"` categories with `textFontFamily`, `textFontStyle` and `leaderVisible`.
+
+## 1.0.1
+
+### Patch Changes
+
+- b404589: Add design.family.duplicate and design.family.saveToLibrary
+
 ## 1.0.0
 
 ### Major Changes

package/api-manifest.json

@@ -540,7 +540,7 @@
       "Point the camera at the centre of the building from the side",
       "Set the eye to this point and aim it at that point\n\n# Example\n```ts\nconst { vec3 } = snaptrude.core.math\nawait snaptrude.core.camera.lookFrom(vec3.new(50, 30, 50), vec3.new(0, 0, 0))\n```"
     ],
-    "argsType": "Vec3Handle",
+    "argsType": "Vec3Input",
     "resultType": "boolean"
   },
   {
@@ -797,7 +797,7 @@
       "Draw an arc between these two points around a centre",
       "Add a curved segment from A to B"
     ],
-    "argsType": "Vec3Handle",
+    "argsType": "Vec3Input",
     "resultType": "ArcHandle"
   },
   {
@@ -1074,7 +1074,7 @@
       "Make a circle of radius 2 at this point",
       "Draw a circular outline 5m across"
     ],
-    "argsType": "Vec3Handle",
+    "argsType": "Vec3Input",
     "resultType": "CircleHandle"
   },
   {
@@ -1112,7 +1112,7 @@
       "Draw a line from point A to point B",
       "Draw a straight edge between these two points"
     ],
-    "argsType": "Vec3Handle",
+    "argsType": "Vec3Input",
     "resultType": "LineHandle"
   },
   {
@@ -1133,7 +1133,7 @@
       "Draw a closed polygon through these corner points",
       "Create an L-shaped outline from a list of points"
     ],
-    "argsType": "Vec3Handle[]",
+    "argsType": "Vec3Input[]",
     "resultType": "ProfileHandle"
   },
   {
@@ -1145,7 +1145,7 @@
       "Organic curved outline through these corners",
       "Freeform podium profile\n\n# Example\n```ts\nconst profile = await snaptrude.core.geom.create.profileFromSplinePoints([p0, p1, p2, p3, p4])\nconst contour = await snaptrude.core.geom.create.contourFromProfile(profile)\nconst brep = await snaptrude.core.geom.create.brepFromExtrusion(contour, { x: 0, y: 1, z: 0 }, 3)\nconst podium = await snaptrude.design.create.massFromBrep(brep, \"Podium\")\n```"
     ],
-    "argsType": "Vec3Handle[]",
+    "argsType": "Vec3Input[]",
     "resultType": "ProfileHandle"
   },
   {
@@ -1166,7 +1166,7 @@
     "examplePrompts": [
       "Draw a smooth curve controlled by these four points\n\n# Example\n```ts\nconst curve = await snaptrude.core.geom.create.splineFromControlPoints([p0, p1, p2, p3])\n// Quadratic instead of the default cubic\nconst tighter = await snaptrude.core.geom.create.splineFromControlPoints(\n[p0, p1, p2, p3],\n{ degree: 2 },\n)\n```"
     ],
-    "argsType": "Vec3Handle[]",
+    "argsType": "Vec3Input[]",
     "resultType": "SplineHandle"
   },
   {
@@ -1178,7 +1178,7 @@
       "Make a wavy edge that passes through A, B, C and D",
       "Freeform curved wall path through these clicks\n\n# Example\n```ts\nconst spline = await snaptrude.core.geom.create.splineFromPoints([p0, p1, p2, p3])\n// Mixed profile: smooth top, straight closing base\nconst base = await snaptrude.core.geom.create.line(p3, p0)\nconst profile = await snaptrude.core.geom.create.profileFromCurves([spline, base])\n```"
     ],
-    "argsType": "Vec3Handle[]",
+    "argsType": "Vec3Input[]",
     "resultType": "SplineHandle"
   },
   {
@@ -3486,7 +3486,7 @@
     "namespace": "core.math.quat",
     "summary": "Build a quaternion from a rotation axis and an angle in radians.",
     "examplePrompts": [],
-    "argsType": "Vec3Handle",
+    "argsType": "Vec3Input",
     "resultType": "QuatHandle"
   },
   {
@@ -3566,7 +3566,7 @@
     "namespace": "core.math.vec3",
     "summary": "Add two vectors component-wise (`a + b`).",
     "examplePrompts": [],
-    "argsType": "Vec3Handle",
+    "argsType": "Vec3Input",
     "resultType": "Vec3Handle"
   },
   {
@@ -3574,7 +3574,7 @@
     "namespace": "core.math.vec3",
     "summary": "Read the primitive `{ x, y, z }` components of a vector handle.",
     "examplePrompts": [],
-    "argsType": "Vec3Handle",
+    "argsType": "Vec3Input",
     "resultType": "Vec3Components"
   },
   {
@@ -3582,7 +3582,7 @@
     "namespace": "core.math.vec3",
     "summary": "Compute the cross product `a × b` — the vector perpendicular to both.",
     "examplePrompts": [],
-    "argsType": "Vec3Handle",
+    "argsType": "Vec3Input",
     "resultType": "Vec3Handle"
   },
   {
@@ -3593,7 +3593,7 @@
       "What is the distance between these two points?",
       "Measure how far apart these two points are\n\n# Example\n```ts\nconst a = await snaptrude.core.math.vec3.new(0, 0, 0)\nconst b = await snaptrude.core.math.vec3.new(3, 4, 0)\nconst dist = await snaptrude.core.math.vec3.distance(a, b) // 5\n```"
     ],
-    "argsType": "Vec3Handle",
+    "argsType": "Vec3Input",
     "resultType": "number"
   },
   {
@@ -3601,7 +3601,7 @@
     "namespace": "core.math.vec3",
     "summary": "Compute the dot product of two vectors.",
     "examplePrompts": [],
-    "argsType": "Vec3Handle",
+    "argsType": "Vec3Input",
     "resultType": "number"
   },
   {
@@ -3609,7 +3609,7 @@
     "namespace": "core.math.vec3",
     "summary": "Test whether two vectors have exactly equal components.",
     "examplePrompts": [],
-    "argsType": "Vec3Handle",
+    "argsType": "Vec3Input",
     "resultType": "boolean"
   },
   {
@@ -3617,7 +3617,7 @@
     "namespace": "core.math.vec3",
     "summary": "Test whether two vectors are equal within a tolerance `epsilon` (default `1e-6`).",
     "examplePrompts": [],
-    "argsType": "Vec3Handle",
+    "argsType": "Vec3Input",
     "resultType": "boolean"
   },
   {
@@ -3625,7 +3625,7 @@
     "namespace": "core.math.vec3",
     "summary": "Compute the Euclidean length (magnitude) of a vector.",
     "examplePrompts": [],
-    "argsType": "Vec3Handle",
+    "argsType": "Vec3Input",
     "resultType": "number"
   },
   {
@@ -3633,7 +3633,7 @@
     "namespace": "core.math.vec3",
     "summary": "Compute the squared Euclidean length of a vector (avoids the sqrt).",
     "examplePrompts": [],
-    "argsType": "Vec3Handle",
+    "argsType": "Vec3Input",
     "resultType": "number"
   },
   {
@@ -3641,7 +3641,7 @@
     "namespace": "core.math.vec3",
     "summary": "Linearly interpolate between two vectors: `a + (b - a) * t`.",
     "examplePrompts": [],
-    "argsType": "Vec3Handle",
+    "argsType": "Vec3Input",
     "resultType": "Vec3Handle"
   },
   {
@@ -3649,7 +3649,7 @@
     "namespace": "core.math.vec3",
     "summary": "Negate a vector, reversing its direction.",
     "examplePrompts": [],
-    "argsType": "Vec3Handle",
+    "argsType": "Vec3Input",
     "resultType": "Vec3Handle"
   },
   {
@@ -3665,7 +3665,7 @@
     "namespace": "core.math.vec3",
     "summary": "Return the unit vector in the same direction (the zero vector if length is 0).",
     "examplePrompts": [],
-    "argsType": "Vec3Handle",
+    "argsType": "Vec3Input",
     "resultType": "Vec3Handle"
   },
   {
@@ -3673,7 +3673,7 @@
     "namespace": "core.math.vec3",
     "summary": "Scale `v` by a scalar.",
     "examplePrompts": [],
-    "argsType": "Vec3Handle",
+    "argsType": "Vec3Input",
     "resultType": "Vec3Handle"
   },
   {
@@ -3681,7 +3681,7 @@
     "namespace": "core.math.vec3",
     "summary": "Subtract vector `b` from `a` component-wise (`a - b`).",
     "examplePrompts": [],
-    "argsType": "Vec3Handle",
+    "argsType": "Vec3Input",
     "resultType": "Vec3Handle"
   },
   {
@@ -4689,7 +4689,7 @@
       "Run a 300x600 beam across the room",
       "Extrude this cross-section into a 5m long beam\n\n# Example\n```ts\nconst rect = await snaptrude.core.geom.create.profileRect(0.3, 0.6)\nconst section = await snaptrude.core.geom.create.contourFromProfile(rect)\nconst alongX = await snaptrude.core.math.vec3.new(1, 0, 0)\nconst beam = await snaptrude.design.create.beam(section, 6, alongX)\n```"
     ],
-    "argsType": "| [section: ContourHandle, length: number, direction?: Vec3Handle]\n      | [axis: LineHandle, options: PluginFamilyPlacement]",
+    "argsType": "| [section: ContourHandle, length: number, direction?: Vec3Input]\n      | [axis: LineHandle, options: PluginFamilyPlacement]",
     "resultType": "ComponentHandle"
   },
   {
@@ -4739,7 +4739,7 @@
       "Create a 450mm square concrete column 4 metres high",
       "Stand a column up from this base point\n\n# Example\n```ts\nconst rect = await snaptrude.core.geom.create.profileRect(0.45, 0.45)\nconst crossSection = await snaptrude.core.geom.create.contourFromProfile(rect)\nconst base = await snaptrude.core.math.vec3.new(4, 0, 4)\nconst column = await snaptrude.design.create.column(base, crossSection, 3)\n```"
     ],
-    "argsType": "| [\n          position: Vec3Handle,\n          crossSection: ContourHandle,\n          height: number,\n          directionUp?: Vec3Handle,\n        ]\n      | [axis: LineHandle, options: PluginFamilyPlacement]",
+    "argsType": "| [\n          position: Vec3Input,\n          crossSection: ContourHandle,\n          height: number,\n          directionUp?: Vec3Input,\n        ]\n      | [axis: LineHandle, options: PluginFamilyPlacement]",
     "resultType": "ComponentHandle"
   },
   {
@@ -4793,7 +4793,7 @@
       "Place a door in every room in one operation",
       "Bulk add the entrance doors from this schedule",
       "Put three doors on this wall in a single undo step",
-      "Add all the doors for this floor plan together"
+      "Add all the doors for this floor plan together\n\nA width/height (top-level, or under the family's own keys in `values`) on a family that\ntakes its size from its Type while Custom Sizes is off is never dropped: the Type within\n25 mm is chosen, else Custom Sizes is turned on and that size is built, leaving the Type\nlabel stale. `design.doors.checkPlacement` reports which as `sizing`; `customSizes: \"No\"`\nwith a size no Type matches is refused."
     ],
     "argsType": "PluginCreateDoorItem[]",
     "resultType": "ComponentHandle[]",
@@ -4809,7 +4809,7 @@
       "Lay flooring across the selected outline",
       "Put a floor at this position with 150mm thickness\n\n# Example\n```ts\nconst rect = await snaptrude.core.geom.create.profileRect(5, 4)\nconst contour = await snaptrude.core.geom.create.contourFromProfile(rect)\nconst floor = await snaptrude.design.create.floor(contour, 0.1)\n```"
     ],
-    "argsType": "| [contour: ContourHandle, thickness: number, position?: Vec3Handle]\n      | [contour: ContourHandle, options: PluginFamilyFloorOptions]",
+    "argsType": "| [contour: ContourHandle, thickness: number, position?: Vec3Input]\n      | [contour: ContourHandle, options: PluginFamilyFloorOptions]",
     "resultType": "ComponentHandle[]",
     "performance": "For dimensional floors, `design.create.floors(items[])` uses one host round-trip and one undo entry. That bulk method does not accept native family options; use this method for a family-backed floor."
   },
@@ -5068,18 +5068,17 @@
   {
     "path": "design.create.wallRuns",
     "namespace": "design.create",
-    "summary": "Create **many wall runs** in one undoable operation (bulk plural of {@linkcode walls}). Each item is one full run — a wall per curve in that item's profile chain, mitred at shared endpoints. Junctions resolve within a run, not between runs. Each item carries its own dimensions, `wallType` and `storey`, so a single call can build a whole floor plate or several storeys at once. Per-curve `topProfiles` make raked or gabled walls (see {@linkcode PluginWallTopProfile}). Validate-all-or-throw; one command.",
+    "summary": "Create **many wall runs** in one undoable operation (bulk plural of {@linkcode walls}). Each item is one full run — a wall per curve in that item's profile chain, mitred at shared endpoints. Junctions resolve within a run, not between runs. Each item carries its own dimensions, `wallType` and `storey`, so a single call can build a whole floor plate or several storeys at once. Walls have one height: a non-null `topProfiles` entry is refused with `PRECONDITION_FAILED` (`details.itemIndex` names the item) and nothing is created. Validate-all-or-throw; one command.",
     "examplePrompts": [
       "Draw all the walls of this floor plan at once",
       "Build every room's perimeter in one operation",
       "Bulk create wall runs from these centerlines",
       "Create the walls for both storeys in a single undo step",
-      "Turn these polylines into 200mm brick walls together",
-      "Import these raked walls with their top profiles in one go"
+      "Turn these polylines into 200mm brick walls together"
     ],
     "argsType": "PluginCreateWallRunItem[]",
     "resultType": "ComponentHandle[][]",
-    "performance": "Bulk creator — the whole batch is ONE host round-trip and ONE undo entry. Always prefer this over calling `design.create.walls` in a loop: build the full `items[]` array first (all profiles up front), then make one call. # Example ```ts const v = snaptrude.core.math.vec3 const ground = await snaptrude.core.geom.create.profileFromLinePoints([ await v.new(0, 0, 0), await v.new(8, 0, 0), await v.new(8, 0, 6), ]) const upper = await snaptrude.core.geom.create.profileFromLinePoints([ await v.new(0, 0, 0), await v.new(8, 0, 0), ]) const [groundWalls, upperWalls] = await snaptrude.design.create.wallRuns([ { profile: ground, height: 3, thickness: 0.2 }, { profile: upper, height: 3, storey: 2 }, // one gable wall: 3m at both ends, 5m ridge in the middle { profile: upper, thickness: 0.2, storey: 3, topProfiles: [[{ along: 0, height: 3 }, { along: 0.5, height: 5 }, { along: 1, height: 3 }]] }, ]) console.log(groundWalls.length, \"walls on the ground floor\") ```"
+    "performance": "Bulk creator — the whole batch is ONE host round-trip and ONE undo entry. Always prefer this over calling `design.create.walls` in a loop: build the full `items[]` array first (all profiles up front), then make one call. # Example ```ts const v = snaptrude.core.math.vec3 const ground = await snaptrude.core.geom.create.profileFromLinePoints([ await v.new(0, 0, 0), await v.new(8, 0, 0), await v.new(8, 0, 6), ]) const upper = await snaptrude.core.geom.create.profileFromLinePoints([ await v.new(0, 0, 0), await v.new(8, 0, 0), ]) const [groundWalls, upperWalls] = await snaptrude.design.create.wallRuns([ { profile: ground, height: 3, thickness: 0.2 }, { profile: upper, height: 3, storey: 2 }, ]) console.log(groundWalls.length, \"walls on the ground floor\") ```"
   },
   {
     "path": "design.create.walls",
@@ -5092,10 +5091,7 @@
       "Turn this polyline sketch into walls",
       "Add walls with mitred corners along the path",
       "Draw brick walls with plaster along this outline",
-      "Build the perimeter in exposed concrete walls",
-      "Create a raked wall that slopes from 3m to 5m",
-      "Build a gable end wall with the ridge in the middle",
-      "Draw a wall with a sloped top edge\n\n# Example\n```ts\nconst v = snaptrude.core.math.vec3\nconst centerlines = await snaptrude.core.geom.create.profileFromLinePoints([\nawait v.new(0, 0, 0),\nawait v.new(8, 0, 0),\nawait v.new(8, 0, 6),\n])\nconst walls = await snaptrude.design.create.walls(centerlines, 3, 0.2)\n// …built as a specific wall type (layers/material/thickness from the type):\nconst [brick] = await snaptrude.design.types.list(\"wall\")\nconst brickWalls = await snaptrude.design.create.walls(\ncenterlines, 3, undefined, brick.label,\n)\n// …a raked wall (3m at the start, 5m at the end) on a single centerline:\nconst run = await snaptrude.core.geom.create.profileFromCurves([\nawait snaptrude.core.geom.create.line(await v.new(0, 0, 10), await v.new(8, 0, 10)),\n])\nconst [raked] = await snaptrude.design.create.walls(run, undefined, 0.2, undefined, undefined, [\n[{ along: 0, height: 3 }, { along: 1, height: 5 }],\n])\n```"
+      "Build the perimeter in exposed concrete walls\n\n# Example\n```ts\nconst v = snaptrude.core.math.vec3\nconst centerlines = await snaptrude.core.geom.create.profileFromLinePoints([\nawait v.new(0, 0, 0),\nawait v.new(8, 0, 0),\nawait v.new(8, 0, 6),\n])\nconst walls = await snaptrude.design.create.walls(centerlines, 3, 0.2)\n// …built as a specific wall type (layers/material/thickness from the type):\nconst [brick] = await snaptrude.design.types.list(\"wall\")\nconst brickWalls = await snaptrude.design.create.walls(\ncenterlines, 3, undefined, brick.label,\n)\n```"
     ],
     "argsType": "ProfileHandle",
     "resultType": "ComponentHandle[]",
@@ -5126,7 +5122,7 @@
       "Place a window in every bedroom in one operation",
       "Bulk add the windows from this schedule",
       "Put four windows on this wall in a single undo step",
-      "Add all the windows with a 0.9m sill height together"
+      "Add all the windows with a 0.9m sill height together\n\nA width/height (top-level, or under the family's own keys in `values`) on a family that\ntakes its size from its Type while Custom Sizes is off is never dropped: the Type within\n25 mm is chosen, else Custom Sizes is turned on and that size is built, leaving the Type\nlabel stale. `design.windows.checkPlacement` reports which as `sizing`; `customSizes: \"No\"`\nwith a size no Type matches is refused."
     ],
     "argsType": "PluginCreateWindowItem[]",
     "resultType": "ComponentHandle[]",
@@ -5157,7 +5153,7 @@
       "Add a dimension line along this wall",
       "Measure the width of this room and label it on the plan\n\n# Example\n```ts\nconst { design, core } = snaptrude\nconst v = core.math.vec3\nconst curve = core.geom.query.curve\nfor (const wall of await design.query.listWalls({ storeys: [2] })) {\nconst cl = await design.query.geometry.getCenterline(wall)\nif (!cl) continue\nconst a = await curve.getStartPoint(cl)\nconst b = await curve.getEndPoint(cl)\nawait design.dimensions.create(\nawait v.new(a.x, a.y, a.z),\nawait v.new(b.x, b.y, b.z),\nwall,\n)\n}\n```"
     ],
-    "argsType": "Vec3Handle",
+    "argsType": "Vec3Input",
     "resultType": "DimensionHandle"
   },
   {
@@ -5224,6 +5220,16 @@
     "resultType": "PluginDimensionsChangeResult",
     "performance": "Array API — one host round-trip and one undo entry for the whole set. # Example ```ts const dims = snaptrude.design.dimensions const hidden = await dims.list({ isHidden: true }) await dims.show(hidden.map((d) => d.id)) ```"
   },
+  {
+    "path": "design.doors.checkPlacement",
+    "namespace": "design.doors",
+    "summary": "Trial the native host fit and geometry rebuild, then restore the model without publishing commands. The first result uses the creation options; subsequent results use candidateWidths in input order. Widths are authored parameters, not physical envelopes or a guaranteed maximum width. No catalog save, history entry or model persistence occurs. Rerun after model edits. A failed fit leaves cut unverified. Family-host cuts are also unverified: their rebuild cannot supply a reversible, authoritative trial result. Material clearance checks evaluated parts against physical neighbours across hosts. The intended host uses native fit/cut checks. Creation repeats clearance immediately before placement; this report grants no later approval. Editing permission is required; locked hosts and an active opening tool reject. It does not say which room the door opens into: read `opensInto` from `design.validation.access()` after placement (see {@linkcode getSwingDirection}). A requested width/height on a family sized by its Type (Custom Sizes off) picks the Type within 25 mm, else turns Custom Sizes on; each result's `sizing` says which. Creation (`design.create.door(s)`) applies the same rule, so the size you pass is the size built.",
+    "examplePrompts": [
+      "Check which door widths fit this host without placing a door"
+    ],
+    "argsType": "PluginOpeningPlacementArgs",
+    "resultType": "PluginOpeningPlacementResult"
+  },
   {
     "path": "design.doors.exists",
     "namespace": "design.doors",
@@ -5310,7 +5316,8 @@
       "Which way does this door swing?",
       "Is the selected door left-handed or right-handed?",
       "Check the hinge side of this door",
-      "Does the entrance door open to the left or the right?\n\n# Example\n```ts\nconst [door] = await snaptrude.design.query.listDoors({ isSelected: true })\nconst swing = await snaptrude.design.doors.getSwingDirection(door)\nif (swing) console.log(\"opens as a\", swing, \"hand door\")\n```"
+      "Does the entrance door open to the left or the right?",
+      "Which room does this door open into?\n\n# Example\n```ts\nconst [door] = await snaptrude.design.query.listDoors({ isSelected: true })\nconst swing = await snaptrude.design.doors.getSwingDirection(door)\nif (swing) console.log(\"opens as a\", swing, \"hand door\")\n// Which room it opens into\nconst { topology } = await snaptrude.design.validation.access()\nconst side = topology.rooms.flatMap((r) => r.doors).find((d) => d.door === door)?.opensInto\n```"
     ],
     "argsType": "ComponentHandle",
     "resultType": "\"left\" | \"right\" | null"
@@ -5370,7 +5377,7 @@
   {
     "path": "design.doors.mirror",
     "namespace": "design.doors",
-    "summary": "Change authored controls in one undo step: x (default) toggles swing front/back; z toggles hand left/right. The recipe must declare these enums. Axis y rejects. No mesh reflection occurs. Recipes use outputs.swingSide (1 or -1) for the adjoining room's floor ownership. A door between two room floors requires this output; a missing or invalid report rejects the cut.",
+    "summary": "Change authored controls in one undo step: x (default) toggles swing front/back; z toggles hand left/right. The recipe must declare these enums. Axis y rejects. No mesh reflection occurs. Recipes use outputs.swingSide (1 or -1) for the adjoining room's floor ownership. A door between two room floors requires this output; a missing or invalid report rejects the cut. The same side decides `opensInto` in `design.validation.access()`; read it there to confirm which room the door now opens into.",
     "examplePrompts": [
       "Flip this door's swing",
       "Mirror the selected door",
@@ -6767,6 +6774,66 @@
     "argsType": "PluginSelectionFilter",
     "resultType": "PluginDesignChangeResult"
   },
+  {
+    "path": "design.text.create",
+    "namespace": "design.text",
+    "summary": "Place a text, or an annotation when `options.arrowhead` is given.",
+    "examplePrompts": [
+      "Label the living room \"LIVING\" on the plan",
+      "Add an annotation pointing at this column saying \"RCC 300x300\"",
+      "Write \"NORTH ENTRY\" in red bold text at the entrance on level 2\n\n# Example\n```ts\nconst { design, core } = snaptrude\nconst v = core.math.vec3\n// A plain label on storey 1.\nawait design.text.create(await v.new(10, 0, 20), \"LIVING\", { storey: 1 })\n// An annotation whose leader points at a wall corner.\nawait design.text.create(await v.new(30, 0, 40), \"Shear wall\", {\narrowhead: await v.new(22, 0, 32),\ncolor: \"#c62828\",\nfontStyle: \"Bold\",\n})\n```"
+    ],
+    "argsType": "Vec3Handle",
+    "resultType": "ComponentHandle"
+  },
+  {
+    "path": "design.text.get",
+    "namespace": "design.text",
+    "summary": "Read one text by handle.",
+    "examplePrompts": [
+      "What does this text say?",
+      "Read the annotation I just placed\n\n# Example\n```ts\nconst t = await snaptrude.design.text.get(handle)\nif (t?.leader) console.log(t.content, \"points at\", t.leader.arrowhead)\n```"
+    ],
+    "argsType": "ComponentHandle",
+    "resultType": "PluginText | null"
+  },
+  {
+    "path": "design.text.list",
+    "namespace": "design.text",
+    "summary": "List the texts and annotations of every building in the active design option as full records (each carries its `buildingId`).",
+    "examplePrompts": [
+      "List all the text labels on level 1",
+      "Which annotations are in this model?",
+      "Find the text that says \"LOBBY\""
+    ],
+    "argsType": "{\n    storeys?: number[]\n    kind?: PluginTextKind\n    isHidden?: boolean\n  }",
+    "resultType": "PluginText[]",
+    "performance": "Array read — one host round-trip returns every record. Filter in one call rather than calling `get` per text. # Example ```ts const texts = await snaptrude.design.text.list({ storeys: [1] }) const lobby = texts.find((t) => t.content === \"LOBBY\") ```"
+  },
+  {
+    "path": "design.text.setLeader",
+    "namespace": "design.text",
+    "summary": "Point a text's leader at a new place — the same edit as dragging an annotation's arrowhead with the Edit tool. Passing `null` removes the leader (the annotation becomes a plain text); giving a plain text an arrowhead turns it into an annotation. The text itself does not move. To move the text while its arrowhead stays put, move it with `design.transform.move`, then call this with the old `leader.arrowhead`.",
+    "examplePrompts": [
+      "Point this annotation at the door instead",
+      "Remove the leader from this label\n\n# Example\n```ts\nconst { design, core } = snaptrude\nawait design.text.setLeader(handle, await core.math.vec3.new(12, 0, 8))\n```"
+    ],
+    "argsType": "ComponentHandle",
+    "resultType": "PluginText"
+  },
+  {
+    "path": "design.text.update",
+    "namespace": "design.text",
+    "summary": "Change the words, colour or font of one or more texts — the same edit as the Properties panel. Fields left out keep each text's own value. A font style the (new) family does not have falls back to `\"Regular\"`, as in the panel. One undo entry for the whole batch.",
+    "examplePrompts": [
+      "Make all the room labels bold",
+      "Change this annotation to read \"Fire exit\"",
+      "Use Roboto in blue for every text on level 2"
+    ],
+    "argsType": "ComponentHandle[]",
+    "resultType": "PluginTextChangeResult",
+    "performance": "Array API — pass the whole set in one call (one host round-trip, one undo entry). Never loop this per text. # Example ```ts const text = snaptrude.design.text const level2 = await text.list({ storeys: [2] }) await text.update(level2.map((t) => t.id), { fontFamily: \"Roboto\", color: \"#1565c0\" }) ```"
+  },
   {
     "path": "design.transform.align",
     "namespace": "design.transform",
@@ -7178,6 +7245,16 @@
     "argsType": null,
     "resultType": "PluginDesignChangeResult"
   },
+  {
+    "path": "design.windows.checkPlacement",
+    "namespace": "design.windows",
+    "summary": "Trial the native host fit and geometry rebuild, then restore the model without publishing commands. The first result uses the creation options; subsequent results use candidateWidths in input order. Widths are authored parameters, not physical envelopes or a guaranteed maximum width. No catalog save, history entry or model persistence occurs. Rerun after model edits. A failed fit leaves cut unverified. Family-host cuts are also unverified: their rebuild cannot supply a reversible, authoritative trial result. Material clearance checks evaluated parts against physical neighbours across hosts. The intended host uses native fit/cut checks. Creation repeats clearance immediately before placement; this report grants no later approval. Editing permission is required; locked hosts and an active opening tool reject. A requested width/height on a family sized by its Type (Custom Sizes off) picks the Type within 25 mm, else turns Custom Sizes on; each result's `sizing` says which. Creation (`design.create.window(s)`) applies the same rule, so the size you pass is the size built.",
+    "examplePrompts": [
+      "Check whether this window fits and its host can be cut"
+    ],
+    "argsType": "PluginOpeningPlacementArgs",
+    "resultType": "PluginOpeningPlacementResult"
+  },
   {
     "path": "design.windows.exists",
     "namespace": "design.windows",

package/dist/api/core/camera/index.d.ts

@@ -28,12 +28,14 @@ export declare abstract class PluginCameraApi {
      * Point the camera: place its eye at `eye` looking toward `target` (world
      * coordinates, internal `babylon` units). View-state only — not undoable.
      *
+     * From a 2D plan the camera first switches to 3D (a plan's camera is pinned
+     * top-down, so an eye there would be ignored); read `getPose().mode` after.
      * While Present is open this sets the Design frame a view saved in Present
      * is taken from; it never moves the Present sheet canvas; use
      * `presentation.camera` for that.
      *
-     * @param eye - Camera position as a {@linkcode Vec3Handle}
-     * @param target - Point the camera looks at as a {@linkcode Vec3Handle}
+     * @param eye - Camera position: a {@linkcode Vec3Handle} or a plain `{ x, y, z }`
+     * @param target - Point the camera looks at: a {@linkcode Vec3Handle} or a plain `{ x, y, z }`
      * @returns `true` once the camera has been positioned.
      *
      * @examplePrompt Look at the model from above the north-east corner

package/dist/api/core/camera/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/api/core/camera/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/api/core/camera/index.ts"],"names":[],"mappings":"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"}

package/dist/api/core/storeys/index.d.ts

@@ -84,6 +84,11 @@ export declare abstract class PluginCoreStoreysApi {
      * The new storey is inserted at the position specified by `storyValue`. This
      * operation is undoable.
      *
+     * Storeys are added at the ends of the stack only. A value above the top (or below the
+     * bottom) also creates every storey in between at the default height — `create(5)` on a
+     * stack of 1–2 adds 3, 4 and 5 and returns only 5 — and a value inside a gap of the
+     * stack is refused (PRECONDITION_FAILED). Read the stack back with `list` afterwards.
+     *
      * @param storyValue - Integer storey number
      *   to create (e.g. `3` to add a third floor)
      * @param height - Optional height in Babylon

package/dist/api/core/storeys/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/api/core/storeys/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAA;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAClD,OAAO,EACL,sBAAsB,EACtB,oBAAoB,EAEpB,uBAAuB,EACvB,uBAAuB,EACvB,0BAA0B,EAC1B,uBAAuB,EACvB,0BAA0B,EAC3B,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EAAE,0BAA0B,EAAE,MAAM,UAAU,CAAA;AAErD;;;;;;;;;;;;;;;;;GAiBG;AACH,8BAAsB,oBAAoB;;IAGxC;;;;OAIG;IACH,SAAgB,MAAM,EAAE,0BAA0B,CAAA;IAElD;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;aACa,GAAG,CACjB,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,sBAAsB,EAAE,GACnC,eAAe,CAAC,oBAAoB,CAAC;IAExC;;;;;;;;;;;;;;;;;;;;;OAqBG;aACa,IAAI,IAAI,eAAe,CAAC,2BAA2B,CAAC;IAEpE;;;;;;;;;;;;;;;;;;;;;;;OAuBG;aACa,MAAM,CACpB,UAAU,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,MAAM,GACd,eAAe,CAAC,uBAAuB,CAAC;IAE3C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAyCG;aACa,MAAM,CACpB,UAAU,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAC1B,eAAe,CAAC,uBAAuB,CAAC;IAE3C;;;;;;;;;;;;OAYG;aACa,SAAS,IAAI,eAAe,CAAC,MAAM,CAAC;IAEpD;;;;;;;;;;;;;;;;;;;;;;;OAuBG;aACa,SAAS,CACvB,UAAU,EAAE,MAAM,GACjB,eAAe,CAAC,0BAA0B,CAAC;IAE9C;;;;;;;;;;;;;;;;;;;;;;OAsBG;aACa,MAAM,CACpB,UAAU,EAAE,MAAM,GACjB,eAAe,CAAC,uBAAuB,CAAC;IAE3C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA0CG;aACa,IAAI,CAClB,SAAS,EAAE,IAAI,GAAG,MAAM,EACxB,OAAO,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,eAAe,EAAE,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,GAC7D,eAAe,CAAC,0BAA0B,CAAC;CAC/C;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,2BAA2B;;;;;;iBAEtC,CAAA;AAEF,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAC/C,OAAO,2BAA2B,CACnC,CAAA;AAED,cAAc,UAAU,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/api/core/storeys/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAA;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAClD,OAAO,EACL,sBAAsB,EACtB,oBAAoB,EAEpB,uBAAuB,EACvB,uBAAuB,EACvB,0BAA0B,EAC1B,uBAAuB,EACvB,0BAA0B,EAC3B,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EAAE,0BAA0B,EAAE,MAAM,UAAU,CAAA;AAErD;;;;;;;;;;;;;;;;;GAiBG;AACH,8BAAsB,oBAAoB;;IAGxC;;;;OAIG;IACH,SAAgB,MAAM,EAAE,0BAA0B,CAAA;IAElD;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;aACa,GAAG,CACjB,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,sBAAsB,EAAE,GACnC,eAAe,CAAC,oBAAoB,CAAC;IAExC;;;;;;;;;;;;;;;;;;;;;OAqBG;aACa,IAAI,IAAI,eAAe,CAAC,2BAA2B,CAAC;IAEpE;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;aACa,MAAM,CACpB,UAAU,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,MAAM,GACd,eAAe,CAAC,uBAAuB,CAAC;IAE3C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAyCG;aACa,MAAM,CACpB,UAAU,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAC1B,eAAe,CAAC,uBAAuB,CAAC;IAE3C;;;;;;;;;;;;OAYG;aACa,SAAS,IAAI,eAAe,CAAC,MAAM,CAAC;IAEpD;;;;;;;;;;;;;;;;;;;;;;;OAuBG;aACa,SAAS,CACvB,UAAU,EAAE,MAAM,GACjB,eAAe,CAAC,0BAA0B,CAAC;IAE9C;;;;;;;;;;;;;;;;;;;;;;OAsBG;aACa,MAAM,CACpB,UAAU,EAAE,MAAM,GACjB,eAAe,CAAC,uBAAuB,CAAC;IAE3C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA0CG;aACa,IAAI,CAClB,SAAS,EAAE,IAAI,GAAG,MAAM,EACxB,OAAO,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,eAAe,EAAE,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,GAC7D,eAAe,CAAC,0BAA0B,CAAC;CAC/C;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,2BAA2B;;;;;;iBAEtC,CAAA;AAEF,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAC/C,OAAO,2BAA2B,CACnC,CAAA;AAED,cAAc,UAAU,CAAA"}

package/dist/api/design/create/bulk-items.d.ts

@@ -20,6 +20,10 @@ export declare const PluginWallTopProfilePoint: z.ZodObject<{
 }, z.core.$strip>;
 export type PluginWallTopProfilePoint = z.infer<typeof PluginWallTopProfilePoint>;
 /**
+ * Current hosts refuse a non-null top profile (`PRECONDITION_FAILED`, "Walls have one
+ * height: sloped or stepped tops are not supported") and create nothing; the shape is
+ * kept for compatibility. The description below is the original contract.
+ *
  * The top edge of ONE wall as a polyline over its centerline: at least two
  * points, `along` strictly increasing from `0` (curve start) to `1` (curve end),
  * straight segments between them. Two points give a single slope (a raked
@@ -143,9 +147,21 @@ export declare const PluginCreateDoorItem: z.ZodObject<{
     version: z.ZodOptional<z.ZodNumber>;
     values: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>>;
     hostWall: z.ZodPipe<z.ZodString, z.ZodTransform<ComponentHandle, string>>;
-    position: z.ZodPipe<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>, z.ZodTransform<import("../../..").Handle<"vec3">, string>>;
-    facing: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>, z.ZodTransform<import("../../..").Handle<"vec3">, string>>>;
-    hinge: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>, z.ZodTransform<import("../../..").Handle<"vec3">, string>>>;
+    position: z.ZodUnion<readonly [z.ZodPipe<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>, z.ZodTransform<import("../../..").Handle<"vec3">, string>>, z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+        z: z.ZodNumber;
+    }, z.core.$strip>]>;
+    facing: z.ZodOptional<z.ZodUnion<readonly [z.ZodPipe<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>, z.ZodTransform<import("../../..").Handle<"vec3">, string>>, z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+        z: z.ZodNumber;
+    }, z.core.$strip>]>>;
+    hinge: z.ZodOptional<z.ZodUnion<readonly [z.ZodPipe<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>, z.ZodTransform<import("../../..").Handle<"vec3">, string>>, z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+        z: z.ZodNumber;
+    }, z.core.$strip>]>>;
     label: z.ZodOptional<z.ZodString>;
     width: z.ZodOptional<z.ZodNumber>;
     height: z.ZodOptional<z.ZodNumber>;
@@ -157,9 +173,21 @@ export declare const PluginCreateDoorItems: z.ZodArray<z.ZodObject<{
     version: z.ZodOptional<z.ZodNumber>;
     values: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>>;
     hostWall: z.ZodPipe<z.ZodString, z.ZodTransform<ComponentHandle, string>>;
-    position: z.ZodPipe<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>, z.ZodTransform<import("../../..").Handle<"vec3">, string>>;
-    facing: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>, z.ZodTransform<import("../../..").Handle<"vec3">, string>>>;
-    hinge: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>, z.ZodTransform<import("../../..").Handle<"vec3">, string>>>;
+    position: z.ZodUnion<readonly [z.ZodPipe<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>, z.ZodTransform<import("../../..").Handle<"vec3">, string>>, z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+        z: z.ZodNumber;
+    }, z.core.$strip>]>;
+    facing: z.ZodOptional<z.ZodUnion<readonly [z.ZodPipe<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>, z.ZodTransform<import("../../..").Handle<"vec3">, string>>, z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+        z: z.ZodNumber;
+    }, z.core.$strip>]>>;
+    hinge: z.ZodOptional<z.ZodUnion<readonly [z.ZodPipe<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>, z.ZodTransform<import("../../..").Handle<"vec3">, string>>, z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+        z: z.ZodNumber;
+    }, z.core.$strip>]>>;
     label: z.ZodOptional<z.ZodString>;
     width: z.ZodOptional<z.ZodNumber>;
     height: z.ZodOptional<z.ZodNumber>;
@@ -194,9 +222,21 @@ export declare const PluginCreateWindowItem: z.ZodObject<{
     version: z.ZodOptional<z.ZodNumber>;
     values: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>>;
     hostWall: z.ZodPipe<z.ZodString, z.ZodTransform<ComponentHandle, string>>;
-    position: z.ZodPipe<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>, z.ZodTransform<import("../../..").Handle<"vec3">, string>>;
-    facing: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>, z.ZodTransform<import("../../..").Handle<"vec3">, string>>>;
-    hinge: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>, z.ZodTransform<import("../../..").Handle<"vec3">, string>>>;
+    position: z.ZodUnion<readonly [z.ZodPipe<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>, z.ZodTransform<import("../../..").Handle<"vec3">, string>>, z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+        z: z.ZodNumber;
+    }, z.core.$strip>]>;
+    facing: z.ZodOptional<z.ZodUnion<readonly [z.ZodPipe<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>, z.ZodTransform<import("../../..").Handle<"vec3">, string>>, z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+        z: z.ZodNumber;
+    }, z.core.$strip>]>>;
+    hinge: z.ZodOptional<z.ZodUnion<readonly [z.ZodPipe<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>, z.ZodTransform<import("../../..").Handle<"vec3">, string>>, z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+        z: z.ZodNumber;
+    }, z.core.$strip>]>>;
     label: z.ZodOptional<z.ZodString>;
     width: z.ZodOptional<z.ZodNumber>;
     height: z.ZodOptional<z.ZodNumber>;
@@ -209,9 +249,21 @@ export declare const PluginCreateWindowItems: z.ZodArray<z.ZodObject<{
     version: z.ZodOptional<z.ZodNumber>;
     values: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>>;
     hostWall: z.ZodPipe<z.ZodString, z.ZodTransform<ComponentHandle, string>>;
-    position: z.ZodPipe<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>, z.ZodTransform<import("../../..").Handle<"vec3">, string>>;
-    facing: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>, z.ZodTransform<import("../../..").Handle<"vec3">, string>>>;
-    hinge: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>, z.ZodTransform<import("../../..").Handle<"vec3">, string>>>;
+    position: z.ZodUnion<readonly [z.ZodPipe<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>, z.ZodTransform<import("../../..").Handle<"vec3">, string>>, z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+        z: z.ZodNumber;
+    }, z.core.$strip>]>;
+    facing: z.ZodOptional<z.ZodUnion<readonly [z.ZodPipe<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>, z.ZodTransform<import("../../..").Handle<"vec3">, string>>, z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+        z: z.ZodNumber;
+    }, z.core.$strip>]>>;
+    hinge: z.ZodOptional<z.ZodUnion<readonly [z.ZodPipe<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>, z.ZodTransform<import("../../..").Handle<"vec3">, string>>, z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+        z: z.ZodNumber;
+    }, z.core.$strip>]>>;
     label: z.ZodOptional<z.ZodString>;
     width: z.ZodOptional<z.ZodNumber>;
     height: z.ZodOptional<z.ZodNumber>;