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

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,11 @@
 # @snaptrude/plugin-core
 
+## 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

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": "Vec3Input",
+    "argsType": "Vec3Handle",
     "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": "Vec3Input",
+    "argsType": "Vec3Handle",
     "resultType": "ArcHandle"
   },
   {
@@ -1074,7 +1074,7 @@
       "Make a circle of radius 2 at this point",
       "Draw a circular outline 5m across"
     ],
-    "argsType": "Vec3Input",
+    "argsType": "Vec3Handle",
     "resultType": "CircleHandle"
   },
   {
@@ -1112,7 +1112,7 @@
       "Draw a line from point A to point B",
       "Draw a straight edge between these two points"
     ],
-    "argsType": "Vec3Input",
+    "argsType": "Vec3Handle",
     "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": "Vec3Input[]",
+    "argsType": "Vec3Handle[]",
     "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": "Vec3Input[]",
+    "argsType": "Vec3Handle[]",
     "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": "Vec3Input[]",
+    "argsType": "Vec3Handle[]",
     "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": "Vec3Input[]",
+    "argsType": "Vec3Handle[]",
     "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": "Vec3Input",
+    "argsType": "Vec3Handle",
     "resultType": "QuatHandle"
   },
   {
@@ -3566,7 +3566,7 @@
     "namespace": "core.math.vec3",
     "summary": "Add two vectors component-wise (`a + b`).",
     "examplePrompts": [],
-    "argsType": "Vec3Input",
+    "argsType": "Vec3Handle",
     "resultType": "Vec3Handle"
   },
   {
@@ -3574,7 +3574,7 @@
     "namespace": "core.math.vec3",
     "summary": "Read the primitive `{ x, y, z }` components of a vector handle.",
     "examplePrompts": [],
-    "argsType": "Vec3Input",
+    "argsType": "Vec3Handle",
     "resultType": "Vec3Components"
   },
   {
@@ -3582,7 +3582,7 @@
     "namespace": "core.math.vec3",
     "summary": "Compute the cross product `a × b` — the vector perpendicular to both.",
     "examplePrompts": [],
-    "argsType": "Vec3Input",
+    "argsType": "Vec3Handle",
     "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": "Vec3Input",
+    "argsType": "Vec3Handle",
     "resultType": "number"
   },
   {
@@ -3601,7 +3601,7 @@
     "namespace": "core.math.vec3",
     "summary": "Compute the dot product of two vectors.",
     "examplePrompts": [],
-    "argsType": "Vec3Input",
+    "argsType": "Vec3Handle",
     "resultType": "number"
   },
   {
@@ -3609,7 +3609,7 @@
     "namespace": "core.math.vec3",
     "summary": "Test whether two vectors have exactly equal components.",
     "examplePrompts": [],
-    "argsType": "Vec3Input",
+    "argsType": "Vec3Handle",
     "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": "Vec3Input",
+    "argsType": "Vec3Handle",
     "resultType": "boolean"
   },
   {
@@ -3625,7 +3625,7 @@
     "namespace": "core.math.vec3",
     "summary": "Compute the Euclidean length (magnitude) of a vector.",
     "examplePrompts": [],
-    "argsType": "Vec3Input",
+    "argsType": "Vec3Handle",
     "resultType": "number"
   },
   {
@@ -3633,7 +3633,7 @@
     "namespace": "core.math.vec3",
     "summary": "Compute the squared Euclidean length of a vector (avoids the sqrt).",
     "examplePrompts": [],
-    "argsType": "Vec3Input",
+    "argsType": "Vec3Handle",
     "resultType": "number"
   },
   {
@@ -3641,7 +3641,7 @@
     "namespace": "core.math.vec3",
     "summary": "Linearly interpolate between two vectors: `a + (b - a) * t`.",
     "examplePrompts": [],
-    "argsType": "Vec3Input",
+    "argsType": "Vec3Handle",
     "resultType": "Vec3Handle"
   },
   {
@@ -3649,7 +3649,7 @@
     "namespace": "core.math.vec3",
     "summary": "Negate a vector, reversing its direction.",
     "examplePrompts": [],
-    "argsType": "Vec3Input",
+    "argsType": "Vec3Handle",
     "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": "Vec3Input",
+    "argsType": "Vec3Handle",
     "resultType": "Vec3Handle"
   },
   {
@@ -3673,7 +3673,7 @@
     "namespace": "core.math.vec3",
     "summary": "Scale `v` by a scalar.",
     "examplePrompts": [],
-    "argsType": "Vec3Input",
+    "argsType": "Vec3Handle",
     "resultType": "Vec3Handle"
   },
   {
@@ -3681,7 +3681,7 @@
     "namespace": "core.math.vec3",
     "summary": "Subtract vector `b` from `a` component-wise (`a - b`).",
     "examplePrompts": [],
-    "argsType": "Vec3Input",
+    "argsType": "Vec3Handle",
     "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?: Vec3Input]\n      | [axis: LineHandle, options: PluginFamilyPlacement]",
+    "argsType": "| [section: ContourHandle, length: number, direction?: Vec3Handle]\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: Vec3Input,\n          crossSection: ContourHandle,\n          height: number,\n          directionUp?: Vec3Input,\n        ]\n      | [axis: LineHandle, options: PluginFamilyPlacement]",
+    "argsType": "| [\n          position: Vec3Handle,\n          crossSection: ContourHandle,\n          height: number,\n          directionUp?: Vec3Handle,\n        ]\n      | [axis: LineHandle, options: PluginFamilyPlacement]",
     "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?: Vec3Input]\n      | [contour: ContourHandle, options: PluginFamilyFloorOptions]",
+    "argsType": "| [contour: ContourHandle, thickness: number, position?: Vec3Handle]\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,17 +5068,18 @@
   {
     "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. 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.",
+    "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.",
     "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"
+      "Turn these polylines into 200mm brick walls together",
+      "Import these raked walls with their top profiles in one go"
     ],
     "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 }, ]) 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 }, // 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\") ```"
   },
   {
     "path": "design.create.walls",
@@ -5091,7 +5092,10 @@
       "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\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```"
+      "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```"
     ],
     "argsType": "ProfileHandle",
     "resultType": "ComponentHandle[]",
@@ -5153,7 +5157,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": "Vec3Input",
+    "argsType": "Vec3Handle",
     "resultType": "DimensionHandle"
   },
   {

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

@@ -1,6 +1,6 @@
 import * as z from "zod";
 import { PluginApiReturn } from "../../../types";
-import { Vec3Input } from "../../../handles";
+import { Vec3Handle } from "../../../handles";
 /**
  * Camera controls.
  *
@@ -28,14 +28,12 @@ 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: 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 }`
+     * @param eye - Camera position as a {@linkcode Vec3Handle}
+     * @param target - Point the camera looks at as a {@linkcode Vec3Handle}
      * @returns `true` once the camera has been positioned.
      *
      * @examplePrompt Look at the model from above the north-east corner
@@ -49,7 +47,7 @@ export declare abstract class PluginCameraApi {
      * await snaptrude.core.camera.lookFrom(vec3.new(50, 30, 50), vec3.new(0, 0, 0))
      * ```
      */
-    abstract lookFrom(eye: Vec3Input, target: Vec3Input): PluginApiReturn<boolean>;
+    abstract lookFrom(eye: Vec3Handle, target: Vec3Handle): PluginApiReturn<boolean>;
     /**
      * Snap the camera to a standard view — the five orthographic elevations
      * (`top` / `front` / `back` / `left` / `right`) or the 3D `iso` (isometric
@@ -402,16 +400,8 @@ export type PluginCameraProjection = z.infer<typeof PluginCameraProjection>;
  * | `target` | {@linkcode Vec3Handle} | Point the camera looks at |
  */
 export declare const PluginCameraLookFromArgs: z.ZodObject<{
-    eye: 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>]>;
-    target: 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>]>;
+    eye: z.ZodPipe<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>, z.ZodTransform<import("../../..").Handle<"vec3">, string>>;
+    target: z.ZodPipe<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>, z.ZodTransform<import("../../..").Handle<"vec3">, string>>;
 }, z.core.$strip>;
 export type PluginCameraLookFromArgs = z.infer<typeof PluginCameraLookFromArgs>;
 /**

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":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAA;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAChD,OAAO,EAA8B,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAExE;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,8BAAsB,eAAe;;IAGnC;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;aACa,QAAQ,CACtB,GAAG,EAAE,SAAS,EACd,MAAM,EAAE,SAAS,GAChB,eAAe,CAAC,OAAO,CAAC;IAE3B;;;;;;;;;;;;;;;;;;;;;;;OAuBG;aACa,eAAe,CAC7B,IAAI,EAAE,kBAAkB,GACvB,eAAe,CAAC,OAAO,CAAC;IAE3B;;;;;;;;;;;;;;OAcG;aACa,OAAO,IAAI,eAAe,CAAC,gBAAgB,CAAC;IAE5D;;;;;;;;;;;;;;;;;;;;;OAqBG;aACa,OAAO,CAAC,IAAI,EAAE,gBAAgB,GAAG,eAAe,CAAC,OAAO,CAAC;IAEzE;;;;;;;;;;;;;;;;OAgBG;aACa,aAAa,IAAI,eAAe,CAAC,sBAAsB,CAAC;IAExE;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;aACa,aAAa,CAC3B,UAAU,EAAE,sBAAsB,GACjC,eAAe,CAAC,OAAO,CAAC;IAE3B;;;;;;;;;;;;;;;;;;;;OAoBG;aACa,WAAW,IAAI,eAAe,CAAC,OAAO,CAAC;IAEvD;;;;;;;;;;;;;;;;;;;;;OAqBG;aACa,aAAa,IAAI,eAAe,CAAC,OAAO,CAAC;IAEzD;;;;;;;;;;;;;;;;;;;OAmBG;aACa,OAAO,IAAI,eAAe,CAAC,gBAAgB,CAAC;IAE5D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAsCG;aACa,OAAO,CACrB,IAAI,EAAE,qBAAqB,EAC3B,OAAO,CAAC,EAAE,0BAA0B,GACnC,eAAe,CAAC,gBAAgB,CAAC;IAEpC;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;aACa,IAAI,CAClB,YAAY,EAAE,4BAA4B,EAC1C,OAAO,CAAC,EAAE,uBAAuB,GAChC,eAAe,CAAC,gBAAgB,CAAC;IAEpC;;;;;;;;;;;;;;;;;;;;;;OAsBG;aACa,MAAM,CACpB,YAAY,EAAE,MAAM,EACpB,cAAc,CAAC,EAAE,MAAM,EACvB,OAAO,CAAC,EAAE,yBAAyB,GAClC,eAAe,CAAC,gBAAgB,CAAC;IAEpC;;;;;;;;;;;;;;;;OAgBG;aACa,qBAAqB,IAAI,eAAe,CAAC,8BAA8B,CAAC;IAExF;;;;;;;;;;;;;;;;;;;;;OAqBG;aACa,wBAAwB,CACtC,KAAK,EAAE,mCAAmC,GACzC,eAAe,CAAC,8BAA8B,CAAC;CACnD;AAED;;;GAGG;AACH,eAAO,MAAM,kBAAkB;;;;;;;EAO7B,CAAA;AACF,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAA;AAEnE;;GAEG;AACH,eAAO,MAAM,gBAAgB;;;EAAuB,CAAA;AACpD,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAA;AAE/D;;;GAGG;AACH,eAAO,MAAM,sBAAsB;;;EAA0C,CAAA;AAC7E,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAA;AAE3E;;;;;;;GAOG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;;;;iBAGnC,CAAA;AACF,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAA;AAE/E;;;;;;GAMG;AACH,eAAO,MAAM,+BAA+B;;;;;;;;;iBAE1C,CAAA;AACF,MAAM,MAAM,+BAA+B,GAAG,CAAC,CAAC,KAAK,CACnD,OAAO,+BAA+B,CACvC,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,uBAAuB;;;;;iBAElC,CAAA;AACF,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAA;AAE7E;;;;;;GAMG;AACH,eAAO,MAAM,6BAA6B;;;;;iBAExC,CAAA;AACF,MAAM,MAAM,6BAA6B,GAAG,CAAC,CAAC,KAAK,CACjD,OAAO,6BAA6B,CACrC,CAAA;AAeD;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;iBAQ3B,CAAA;AACF,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAA;AAE/D;;;;;;;;;;GAUG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;oBAiBhC,CAAA;AACF,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAA;AAEzE;;;;;;GAMG;AACH,eAAO,MAAM,0BAA0B;;kBAE5B,CAAA;AACX,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAC9C,OAAO,0BAA0B,CAClC,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAGlC,CAAA;AACF,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAA;AAE7E;;;;;;;;;GASG;AACH,eAAO,MAAM,4BAA4B;;;;kBAM9B,CAAA;AACX,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAChD,OAAO,4BAA4B,CACpC,CAAA;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,uBAAuB;;;kBAKzB,CAAA;AACX,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAA;AAE7E;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;iBAG/B,CAAA;AACF,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAA;AAEvE;;;;;;GAMG;AACH,eAAO,MAAM,yBAAyB;;kBAE3B,CAAA;AACX,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAC7C,OAAO,yBAAyB,CACjC,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,sBAAsB;;;;;;iBAIjC,CAAA;AACF,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAA;AAE3E;;GAEG;AACH,eAAO,MAAM,qBAAqB;;;;EAAqC,CAAA;AACvE,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAA;AAEzE;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,8BAA8B;;;;;;;;;iBAKzC,CAAA;AACF,MAAM,MAAM,8BAA8B,GAAG,CAAC,CAAC,KAAK,CAClD,OAAO,8BAA8B,CACtC,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,mCAAmC;;;;;;;;;kBAOrC,CAAA;AACX,MAAM,MAAM,mCAAmC,GAAG,CAAC,CAAC,KAAK,CACvD,OAAO,mCAAmC,CAC3C,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,wCAAwC;;;;;;;;;;;iBAEnD,CAAA;AACF,MAAM,MAAM,wCAAwC,GAAG,CAAC,CAAC,KAAK,CAC5D,OAAO,wCAAwC,CAChD,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/api/core/camera/index.ts"],"names":[],"mappings":"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"}

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

@@ -1,6 +1,6 @@
 import * as z from "zod";
 import { PluginApiReturn } from "../../../types";
-import { Vec3Input, ComponentHandle, Vec3Components } from "../../../handles";
+import { Vec3Handle, ComponentHandle, Vec3Components } from "../../../handles";
 /**
  * Comments — create, edit, resolve, tag, and list scene/project comments.
  *
@@ -35,7 +35,7 @@ export declare abstract class PluginCommentApi {
      * )
      * ```
      */
-    abstract create(message: string, component?: ComponentHandle, position?: Vec3Input, mentions?: string[]): PluginApiReturn<CommentHandle>;
+    abstract create(message: string, component?: ComponentHandle, position?: Vec3Handle, mentions?: string[]): PluginApiReturn<CommentHandle>;
     /**
      * Edit a comment's message (and optional @mentions).
      *
@@ -226,11 +226,7 @@ export declare const CommentHandle: z.ZodPipe<z.ZodString, z.ZodTransform<Commen
  */
 export declare const PluginCommentCreateArgs: z.ZodObject<{
     component: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<ComponentHandle, string>>>;
-    position: 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>]>>;
+    position: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>, z.ZodTransform<import("../../..").Handle<"vec3">, string>>>;
     message: z.ZodString;
     mentions: z.ZodOptional<z.ZodArray<z.ZodString>>;
 }, z.core.$strip>;

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

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

package/dist/api/core/geom/create/index.d.ts

@@ -1,7 +1,7 @@
 import * as z from "zod";
 import { PluginApiReturn } from "../../../../types";
 import type { SweepAlongCurveRecordOptions } from "../../../../massParameters";
-import { Vec3Input, LineHandle, ArcHandle, SplineHandle, CircleHandle, CurveHandle, ProfileHandle, ContourHandle, BrepHandle, FaceHandle, EdgeHandle, Vec3Components } from "../../../../handles";
+import { Vec3Handle, LineHandle, ArcHandle, SplineHandle, CircleHandle, CurveHandle, ProfileHandle, ContourHandle, BrepHandle, FaceHandle, EdgeHandle, Vec3Components } from "../../../../handles";
 /** Maximum boundary items one patch may span. */
 export declare const MAX_PATCH_BOUNDARY_CURVES = 16;
 /** Maximum interior points one patch may be pulled through. */
@@ -57,7 +57,7 @@ export declare abstract class PluginGeomCreateApi {
      * const line = snaptrude.core.geom.create.line(startPoint, endPoint)
      * ```
      */
-    abstract line(startPoint: Vec3Input, endPoint: Vec3Input): PluginApiReturn<LineHandle>;
+    abstract line(startPoint: Vec3Handle, endPoint: Vec3Handle): PluginApiReturn<LineHandle>;
     /**
      * Create a circular arc from its start, end, centre, and axis point handles.
      * Host API call — returns a handle.
@@ -76,7 +76,7 @@ export declare abstract class PluginGeomCreateApi {
      * const arc = snaptrude.core.geom.create.arc(startPoint, endPoint, centrePoint, axis)
      * ```
      */
-    abstract arc(startPoint: Vec3Input, endPoint: Vec3Input, centrePoint: Vec3Input, axis: Vec3Input): PluginApiReturn<ArcHandle>;
+    abstract arc(startPoint: Vec3Handle, endPoint: Vec3Handle, centrePoint: Vec3Handle, axis: Vec3Handle): PluginApiReturn<ArcHandle>;
     /**
      * Create a circle from a centre point, an axis (plane normal), and a radius.
      * Host API call — returns a handle. A circle is a closed curve; read it back via
@@ -95,7 +95,7 @@ export declare abstract class PluginGeomCreateApi {
      * const circle = snaptrude.core.geom.create.circle(centrePoint, axis, 2)
      * ```
      */
-    abstract circle(centrePoint: Vec3Input, axis: Vec3Input, radius: number): PluginApiReturn<CircleHandle>;
+    abstract circle(centrePoint: Vec3Handle, axis: Vec3Handle, radius: number): PluginApiReturn<CircleHandle>;
     /**
      * Create an open NURBS curve passing exactly THROUGH each point, in order
      * (centripetal Catmull-Rom fit → clamped cubic B-spline; C1-smooth, no cusps
@@ -126,7 +126,7 @@ export declare abstract class PluginGeomCreateApi {
      * const profile = await snaptrude.core.geom.create.profileFromCurves([spline, base])
      * ```
      */
-    abstract splineFromPoints(points: Vec3Input[]): PluginApiReturn<SplineHandle>;
+    abstract splineFromPoints(points: Vec3Handle[]): PluginApiReturn<SplineHandle>;
     /**
      * Create an open NURBS curve DEFINED BY control points — the curve is pulled
      * TOWARD the interior points, not through them; it starts at the first point
@@ -159,7 +159,7 @@ export declare abstract class PluginGeomCreateApi {
      * )
      * ```
      */
-    abstract splineFromControlPoints(controlPoints: Vec3Input[], options?: {
+    abstract splineFromControlPoints(controlPoints: Vec3Handle[], options?: {
         degree?: number;
     }): PluginApiReturn<SplineHandle>;
     /**
@@ -194,7 +194,7 @@ export declare abstract class PluginGeomCreateApi {
      * const profile = snaptrude.core.geom.create.profileFromLinePoints(points)
      * ```
      */
-    abstract profileFromLinePoints(points: Vec3Input[]): PluginApiReturn<ProfileHandle>;
+    abstract profileFromLinePoints(points: Vec3Handle[]): PluginApiReturn<ProfileHandle>;
     /**
      * Create a profile from an ordered list of curve handles forming a closed loop.
      * Host API call — returns a handle.
@@ -241,7 +241,7 @@ export declare abstract class PluginGeomCreateApi {
      * const podium = await snaptrude.design.create.massFromBrep(brep, "Podium")
      * ```
      */
-    abstract profileFromSplinePoints(points: Vec3Input[]): PluginApiReturn<ProfileHandle>;
+    abstract profileFromSplinePoints(points: Vec3Handle[]): PluginApiReturn<ProfileHandle>;
     /**
      * Create an axis-aligned **rectangle** profile in the XZ plane,
      * `width` × `depth`, centred at `center` (defaults to the origin). Host API
@@ -266,7 +266,7 @@ export declare abstract class PluginGeomCreateApi {
      * const space = snaptrude.design.create.space(contour, 3)
      * ```
      */
-    abstract profileRect(width: number, depth: number, center?: Vec3Input): PluginApiReturn<ProfileHandle>;
+    abstract profileRect(width: number, depth: number, center?: Vec3Handle): PluginApiReturn<ProfileHandle>;
     /**
      * Create a contour (an outer profile loop, no holes). Host API call — returns a handle.
      *
@@ -1364,16 +1364,8 @@ export declare abstract class PluginGeomCreateApi {
  * | `endPoint` | {@linkcode Vec3Handle} | End point of the line segment |
  */
 export declare const PluginGeomCreateLineArgs: z.ZodObject<{
-    startPoint: 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>]>;
-    endPoint: 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>]>;
+    startPoint: z.ZodPipe<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>, z.ZodTransform<import("../../../..").Handle<"vec3">, string>>;
+    endPoint: z.ZodPipe<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>, z.ZodTransform<import("../../../..").Handle<"vec3">, string>>;
 }, z.core.$strip>;
 export type PluginGeomCreateLineArgs = z.infer<typeof PluginGeomCreateLineArgs>;
 /**
@@ -1387,26 +1379,10 @@ export type PluginGeomCreateLineArgs = z.infer<typeof PluginGeomCreateLineArgs>;
  * | `axis` | {@linkcode Vec3Handle} | Axis direction of the arc |
  */
 export declare const PluginGeomCreateArcArgs: z.ZodObject<{
-    startPoint: 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>]>;
-    endPoint: 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>]>;
-    centrePoint: 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>]>;
-    axis: 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>]>;
+    startPoint: z.ZodPipe<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>, z.ZodTransform<import("../../../..").Handle<"vec3">, string>>;
+    endPoint: z.ZodPipe<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>, z.ZodTransform<import("../../../..").Handle<"vec3">, string>>;
+    centrePoint: z.ZodPipe<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>, z.ZodTransform<import("../../../..").Handle<"vec3">, string>>;
+    axis: z.ZodPipe<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>, z.ZodTransform<import("../../../..").Handle<"vec3">, string>>;
 }, z.core.$strip>;
 export type PluginGeomCreateArcArgs = z.infer<typeof PluginGeomCreateArcArgs>;
 /**
@@ -1419,16 +1395,8 @@ export type PluginGeomCreateArcArgs = z.infer<typeof PluginGeomCreateArcArgs>;
  * | `radius` | `number` | Radius of the circle |
  */
 export declare const PluginGeomCreateCircleArgs: z.ZodObject<{
-    centrePoint: 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>]>;
-    axis: 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>]>;
+    centrePoint: z.ZodPipe<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>, z.ZodTransform<import("../../../..").Handle<"vec3">, string>>;
+    axis: z.ZodPipe<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>, z.ZodTransform<import("../../../..").Handle<"vec3">, string>>;
     radius: z.ZodNumber;
 }, z.core.$strip>;
 export type PluginGeomCreateCircleArgs = z.infer<typeof PluginGeomCreateCircleArgs>;
@@ -1440,11 +1408,7 @@ export type PluginGeomCreateCircleArgs = z.infer<typeof PluginGeomCreateCircleAr
  * | `points` | {@linkcode Vec3Handle}`[]` | 3..256 ordered through-points of the curve |
  */
 export declare const PluginGeomCreateSplineFromPointsArgs: z.ZodObject<{
-    points: z.ZodArray<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>]>>;
+    points: z.ZodArray<z.ZodPipe<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>, z.ZodTransform<import("../../../..").Handle<"vec3">, string>>>;
 }, z.core.$strip>;
 export type PluginGeomCreateSplineFromPointsArgs = z.infer<typeof PluginGeomCreateSplineFromPointsArgs>;
 /**
@@ -1456,11 +1420,7 @@ export type PluginGeomCreateSplineFromPointsArgs = z.infer<typeof PluginGeomCrea
  * | `options` | `object`? | `degree`: 2 or 3 (default `min(3, controlPoints.length - 1)`) |
  */
 export declare const PluginGeomCreateSplineFromControlPointsArgs: z.ZodObject<{
-    controlPoints: z.ZodArray<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>]>>;
+    controlPoints: z.ZodArray<z.ZodPipe<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>, z.ZodTransform<import("../../../..").Handle<"vec3">, string>>>;
     options: z.ZodOptional<z.ZodObject<{
         degree: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>>;
@@ -1474,11 +1434,7 @@ export type PluginGeomCreateSplineFromControlPointsArgs = z.infer<typeof PluginG
  * | `points` | {@linkcode Vec3Handle}`[]` | Ordered vertex handles of the profile |
  */
 export declare const PluginGeomCreateProfileFromLinePointsArgs: z.ZodObject<{
-    points: z.ZodArray<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>]>>;
+    points: z.ZodArray<z.ZodPipe<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>, z.ZodTransform<import("../../../..").Handle<"vec3">, string>>>;
 }, z.core.$strip>;
 export type PluginGeomCreateProfileFromLinePointsArgs = z.infer<typeof PluginGeomCreateProfileFromLinePointsArgs>;
 /**
@@ -1500,11 +1456,7 @@ export type PluginGeomCreateProfileFromCurvesArgs = z.infer<typeof PluginGeomCre
  * | `points` | {@linkcode Vec3Handle}`[]` | 3..256 ordered through-points of the closed loop (first point NOT repeated) |
  */
 export declare const PluginGeomCreateProfileFromSplinePointsArgs: z.ZodObject<{
-    points: z.ZodArray<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>]>>;
+    points: z.ZodArray<z.ZodPipe<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>, z.ZodTransform<import("../../../..").Handle<"vec3">, string>>>;
 }, z.core.$strip>;
 export type PluginGeomCreateProfileFromSplinePointsArgs = z.infer<typeof PluginGeomCreateProfileFromSplinePointsArgs>;
 /**