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

package/src/api/core/geom/update/contour.ts

@@ -4,7 +4,6 @@ import {
   ContourHandle,
   ProfileHandle,
   Vec3Handle,
-  Vec3Input,
   Vec3Components,
 } from "../../../../handles"
 
@@ -70,7 +69,7 @@ export abstract class PluginGeomUpdateContourApi {
    */
   public abstract move(
     contour: ContourHandle,
-    translation: Vec3Input,
+    translation: Vec3Handle,
   ): PluginApiReturn<ContourHandle>
 
   /**
@@ -97,9 +96,9 @@ export abstract class PluginGeomUpdateContourApi {
    */
   public abstract rotate(
     contour: ContourHandle,
-    axis: Vec3Input,
+    axis: Vec3Handle,
     angle: number,
-    pivot?: Vec3Input,
+    pivot?: Vec3Handle,
   ): PluginApiReturn<ContourHandle>
 
   /**
@@ -125,7 +124,7 @@ export abstract class PluginGeomUpdateContourApi {
   public abstract scale(
     contour: ContourHandle,
     factor: number | Vec3Components,
-    pivot?: Vec3Input,
+    pivot?: Vec3Handle,
   ): PluginApiReturn<ContourHandle>
 
   /**
@@ -150,7 +149,7 @@ export abstract class PluginGeomUpdateContourApi {
    */
   public abstract mirror(
     contour: ContourHandle,
-    plane: { point: Vec3Input; normal: Vec3Input },
+    plane: { point: Vec3Handle; normal: Vec3Handle },
   ): PluginApiReturn<ContourHandle>
 
   /**
@@ -234,7 +233,7 @@ export type PluginGeomUpdateContourOffsetArgs = z.infer<typeof PluginGeomUpdateC
  */
 export const PluginGeomUpdateContourMoveArgs = z.object({
   contour: ContourHandle,
-  translation: Vec3Input,
+  translation: Vec3Handle,
 })
 
 export type PluginGeomUpdateContourMoveArgs = z.infer<typeof PluginGeomUpdateContourMoveArgs>
@@ -251,9 +250,9 @@ export type PluginGeomUpdateContourMoveArgs = z.infer<typeof PluginGeomUpdateCon
  */
 export const PluginGeomUpdateContourRotateArgs = z.object({
   contour: ContourHandle,
-  axis: Vec3Input,
+  axis: Vec3Handle,
   angle: z.number(),
-  pivot: Vec3Input.optional(),
+  pivot: Vec3Handle.optional(),
 })
 
 export type PluginGeomUpdateContourRotateArgs = z.infer<typeof PluginGeomUpdateContourRotateArgs>
@@ -270,7 +269,7 @@ export type PluginGeomUpdateContourRotateArgs = z.infer<typeof PluginGeomUpdateC
 export const PluginGeomUpdateContourScaleArgs = z.object({
   contour: ContourHandle,
   factor: z.union([z.number(), Vec3Components]),
-  pivot: Vec3Input.optional(),
+  pivot: Vec3Handle.optional(),
 })
 
 export type PluginGeomUpdateContourScaleArgs = z.infer<typeof PluginGeomUpdateContourScaleArgs>
@@ -286,8 +285,8 @@ export type PluginGeomUpdateContourScaleArgs = z.infer<typeof PluginGeomUpdateCo
 export const PluginGeomUpdateContourMirrorArgs = z.object({
   contour: ContourHandle,
   plane: z.object({
-    point: Vec3Input,
-    normal: Vec3Input,
+    point: Vec3Handle,
+    normal: Vec3Handle,
   }),
 })
 

package/src/api/core/geom/update/curve.ts

@@ -1,6 +1,6 @@
 import * as z from "zod"
 import { PluginApiReturn } from "../../../../types"
-import { Vec3Handle, Vec3Input, CurveHandle } from "../../../../handles"
+import { Vec3Handle, CurveHandle } from "../../../../handles"
 
 /**
  * Curve editing — produce NEW curves from an existing one (all-handle model, §11).
@@ -61,7 +61,7 @@ export abstract class PluginGeomUpdateCurveApi {
    */
   public abstract split(
     curve: CurveHandle,
-    point: Vec3Input,
+    point: Vec3Handle,
   ): PluginApiReturn<CurveHandle[]>
 
   /**
@@ -110,7 +110,7 @@ export abstract class PluginGeomUpdateCurveApi {
    */
   public abstract offset(
     curve: CurveHandle,
-    vector: Vec3Input,
+    vector: Vec3Handle,
   ): PluginApiReturn<CurveHandle>
 
   /**
@@ -158,7 +158,7 @@ export type PluginGeomUpdateCurveExtendArgs = z.infer<typeof PluginGeomUpdateCur
  */
 export const PluginGeomUpdateCurveSplitArgs = z.object({
   curve: CurveHandle,
-  point: Vec3Input,
+  point: Vec3Handle,
 })
 
 export type PluginGeomUpdateCurveSplitArgs = z.infer<typeof PluginGeomUpdateCurveSplitArgs>
@@ -190,7 +190,7 @@ export type PluginGeomUpdateCurveTrimArgs = z.infer<typeof PluginGeomUpdateCurve
  */
 export const PluginGeomUpdateCurveOffsetArgs = z.object({
   curve: CurveHandle,
-  vector: Vec3Input,
+  vector: Vec3Handle,
 })
 
 export type PluginGeomUpdateCurveOffsetArgs = z.infer<typeof PluginGeomUpdateCurveOffsetArgs>

package/src/api/core/geom/update/profile.ts

@@ -3,7 +3,6 @@ import { PluginApiReturn } from "../../../../types"
 import {
   ProfileHandle,
   Vec3Handle,
-  Vec3Input,
   CurveHandle,
   Vec3Components,
 } from "../../../../handles"
@@ -67,7 +66,7 @@ export abstract class PluginGeomUpdateProfileApi {
    */
   public abstract move(
     profile: ProfileHandle,
-    translation: Vec3Input,
+    translation: Vec3Handle,
   ): PluginApiReturn<ProfileHandle>
 
   /**
@@ -92,9 +91,9 @@ export abstract class PluginGeomUpdateProfileApi {
    */
   public abstract rotate(
     profile: ProfileHandle,
-    axis: Vec3Input,
+    axis: Vec3Handle,
     angle: number,
-    pivot?: Vec3Input,
+    pivot?: Vec3Handle,
   ): PluginApiReturn<ProfileHandle>
 
   /**
@@ -119,7 +118,7 @@ export abstract class PluginGeomUpdateProfileApi {
   public abstract scale(
     profile: ProfileHandle,
     factor: number | Vec3Components,
-    pivot?: Vec3Input,
+    pivot?: Vec3Handle,
   ): PluginApiReturn<ProfileHandle>
 
   /**
@@ -143,7 +142,7 @@ export abstract class PluginGeomUpdateProfileApi {
    */
   public abstract mirror(
     profile: ProfileHandle,
-    plane: { point: Vec3Input; normal: Vec3Input },
+    plane: { point: Vec3Handle; normal: Vec3Handle },
   ): PluginApiReturn<ProfileHandle>
 
   /**
@@ -262,7 +261,7 @@ export type PluginGeomUpdateProfileOffsetArgs = z.infer<typeof PluginGeomUpdateP
  */
 export const PluginGeomUpdateProfileMoveArgs = z.object({
   profile: ProfileHandle,
-  translation: Vec3Input,
+  translation: Vec3Handle,
 })
 
 export type PluginGeomUpdateProfileMoveArgs = z.infer<typeof PluginGeomUpdateProfileMoveArgs>
@@ -279,9 +278,9 @@ export type PluginGeomUpdateProfileMoveArgs = z.infer<typeof PluginGeomUpdatePro
  */
 export const PluginGeomUpdateProfileRotateArgs = z.object({
   profile: ProfileHandle,
-  axis: Vec3Input,
+  axis: Vec3Handle,
   angle: z.number(),
-  pivot: Vec3Input.optional(),
+  pivot: Vec3Handle.optional(),
 })
 
 export type PluginGeomUpdateProfileRotateArgs = z.infer<typeof PluginGeomUpdateProfileRotateArgs>
@@ -298,7 +297,7 @@ export type PluginGeomUpdateProfileRotateArgs = z.infer<typeof PluginGeomUpdateP
 export const PluginGeomUpdateProfileScaleArgs = z.object({
   profile: ProfileHandle,
   factor: z.union([z.number(), Vec3Components]),
-  pivot: Vec3Input.optional(),
+  pivot: Vec3Handle.optional(),
 })
 
 export type PluginGeomUpdateProfileScaleArgs = z.infer<typeof PluginGeomUpdateProfileScaleArgs>
@@ -314,8 +313,8 @@ export type PluginGeomUpdateProfileScaleArgs = z.infer<typeof PluginGeomUpdatePr
 export const PluginGeomUpdateProfileMirrorArgs = z.object({
   profile: ProfileHandle,
   plane: z.object({
-    point: Vec3Input,
-    normal: Vec3Input,
+    point: Vec3Handle,
+    normal: Vec3Handle,
   }),
 })
 

package/src/api/core/io/import/index.ts

@@ -2,7 +2,6 @@ import * as z from "zod"
 import { PluginApiReturn } from "../../../../types"
 import {
   Vec3Handle,
-  Vec3Input,
   UnderlayHandle,
   TerrainHandle,
   ImportJobHandle,
@@ -267,7 +266,7 @@ export abstract class PluginCoreIoImportApi {
     source: string,
     storey?: number,
     format?: ModelFormat,
-    position?: Vec3Input,
+    position?: Vec3Handle,
     label?: string,
   ): PluginApiReturn<ComponentHandle>
 
@@ -446,7 +445,7 @@ export const PluginImportModelArgs = z.object({
   source: ImportSource,
   storey: z.number().int().optional(),
   format: ModelFormat.optional(),
-  position: Vec3Input.optional(),
+  position: Vec3Handle.optional(),
   label: z.string().optional(),
 })
 export type PluginImportModelArgs = z.infer<typeof PluginImportModelArgs>

package/src/api/core/math/quat.ts

@@ -1,5 +1,5 @@
 import { PluginApiReturn } from "../../../types"
-import { Vec3Handle, Vec3Input, QuatHandle, QuatComponents } from "../../../handles"
+import { Vec3Handle, QuatHandle, QuatComponents } from "../../../handles"
 
 /**
  * Quaternion operations (all-handle model, §11).
@@ -39,7 +39,7 @@ export abstract class PluginQuatApi {
    * const quarterTurn = await snaptrude.core.math.quat.fromAxisAngle(axis, Math.PI / 2)
    * ```
    */
-  abstract fromAxisAngle(axis: Vec3Input, angle: number): PluginApiReturn<QuatHandle>
+  abstract fromAxisAngle(axis: Vec3Handle, angle: number): PluginApiReturn<QuatHandle>
   /**
    * Build a quaternion from Euler angles in radians.
    *

package/src/api/core/math/vec3.ts

@@ -1,5 +1,5 @@
 import { PluginApiReturn } from "../../../types"
-import { Vec3Handle, Vec3Input, Vec3Components } from "../../../handles"
+import { Vec3Handle, Vec3Components } from "../../../handles"
 
 /**
  * 3D vector operations (all-handle model, §11).
@@ -31,7 +31,7 @@ export abstract class PluginVec3Api {
    * const sum = await snaptrude.core.math.vec3.add(a, b)
    * ```
    */
-  abstract add(a: Vec3Input, b: Vec3Input): PluginApiReturn<Vec3Handle>
+  abstract add(a: Vec3Handle, b: Vec3Handle): PluginApiReturn<Vec3Handle>
   /**
    * Subtract vector `b` from `a` component-wise (`a - b`).
    *
@@ -42,7 +42,7 @@ export abstract class PluginVec3Api {
    * const diff = await snaptrude.core.math.vec3.subtract(a, b)
    * ```
    */
-  abstract subtract(a: Vec3Input, b: Vec3Input): PluginApiReturn<Vec3Handle>
+  abstract subtract(a: Vec3Handle, b: Vec3Handle): PluginApiReturn<Vec3Handle>
   /**
    * Scale `v` by a scalar.
    *
@@ -52,7 +52,7 @@ export abstract class PluginVec3Api {
    * const doubled = await snaptrude.core.math.vec3.scale(v, 2)
    * ```
    */
-  abstract scale(v: Vec3Input, scalar: number): PluginApiReturn<Vec3Handle>
+  abstract scale(v: Vec3Handle, scalar: number): PluginApiReturn<Vec3Handle>
   /**
    * Compute the dot product of two vectors.
    *
@@ -63,7 +63,7 @@ export abstract class PluginVec3Api {
    * const d = await snaptrude.core.math.vec3.dot(a, b) // 0.5
    * ```
    */
-  abstract dot(a: Vec3Input, b: Vec3Input): PluginApiReturn<number>
+  abstract dot(a: Vec3Handle, b: Vec3Handle): PluginApiReturn<number>
   /**
    * Compute the cross product `a × b` — the vector perpendicular to both.
    *
@@ -74,7 +74,7 @@ export abstract class PluginVec3Api {
    * const perpendicular = await snaptrude.core.math.vec3.cross(a, b)
    * ```
    */
-  abstract cross(a: Vec3Input, b: Vec3Input): PluginApiReturn<Vec3Handle>
+  abstract cross(a: Vec3Handle, b: Vec3Handle): PluginApiReturn<Vec3Handle>
   /**
    * Compute the Euclidean length (magnitude) of a vector.
    *
@@ -84,7 +84,7 @@ export abstract class PluginVec3Api {
    * const len = await snaptrude.core.math.vec3.length(v) // 5
    * ```
    */
-  abstract length(v: Vec3Input): PluginApiReturn<number>
+  abstract length(v: Vec3Handle): PluginApiReturn<number>
   /**
    * Compute the squared Euclidean length of a vector (avoids the sqrt).
    *
@@ -94,7 +94,7 @@ export abstract class PluginVec3Api {
    * const sq = await snaptrude.core.math.vec3.lengthSquared(v) // 25
    * ```
    */
-  abstract lengthSquared(v: Vec3Input): PluginApiReturn<number>
+  abstract lengthSquared(v: Vec3Handle): PluginApiReturn<number>
   /**
    * Return the unit vector in the same direction (the zero vector if length is 0).
    *
@@ -104,7 +104,7 @@ export abstract class PluginVec3Api {
    * const unit = await snaptrude.core.math.vec3.normalize(v) // (0, 0, 1)
    * ```
    */
-  abstract normalize(v: Vec3Input): PluginApiReturn<Vec3Handle>
+  abstract normalize(v: Vec3Handle): PluginApiReturn<Vec3Handle>
   /**
    * Measure the straight-line (Euclidean) distance between two points.
    *
@@ -118,7 +118,7 @@ export abstract class PluginVec3Api {
    * const dist = await snaptrude.core.math.vec3.distance(a, b) // 5
    * ```
    */
-  abstract distance(a: Vec3Input, b: Vec3Input): PluginApiReturn<number>
+  abstract distance(a: Vec3Handle, b: Vec3Handle): PluginApiReturn<number>
   /**
    * Linearly interpolate between two vectors: `a + (b - a) * t`.
    *
@@ -129,7 +129,7 @@ export abstract class PluginVec3Api {
    * const midpoint = await snaptrude.core.math.vec3.lerp(a, b, 0.5)
    * ```
    */
-  abstract lerp(a: Vec3Input, b: Vec3Input, t: number): PluginApiReturn<Vec3Handle>
+  abstract lerp(a: Vec3Handle, b: Vec3Handle, t: number): PluginApiReturn<Vec3Handle>
   /**
    * Negate a vector, reversing its direction.
    *
@@ -139,7 +139,7 @@ export abstract class PluginVec3Api {
    * const reversed = await snaptrude.core.math.vec3.negate(v) // (-1, 2, -3)
    * ```
    */
-  abstract negate(v: Vec3Input): PluginApiReturn<Vec3Handle>
+  abstract negate(v: Vec3Handle): PluginApiReturn<Vec3Handle>
   /**
    * Test whether two vectors have exactly equal components.
    *
@@ -150,7 +150,7 @@ export abstract class PluginVec3Api {
    * const same = await snaptrude.core.math.vec3.equals(a, b) // true
    * ```
    */
-  abstract equals(a: Vec3Input, b: Vec3Input): PluginApiReturn<boolean>
+  abstract equals(a: Vec3Handle, b: Vec3Handle): PluginApiReturn<boolean>
   /**
    * Test whether two vectors are equal within a tolerance `epsilon` (default `1e-6`).
    *
@@ -162,8 +162,8 @@ export abstract class PluginVec3Api {
    * ```
    */
   abstract equalsApprox(
-    a: Vec3Input,
-    b: Vec3Input,
+    a: Vec3Handle,
+    b: Vec3Handle,
     epsilon?: number,
   ): PluginApiReturn<boolean>
   /**
@@ -175,5 +175,5 @@ export abstract class PluginVec3Api {
    * const { x, y, z } = await snaptrude.core.math.vec3.components(v)
    * ```
    */
-  abstract components(v: Vec3Input): PluginApiReturn<Vec3Components>
+  abstract components(v: Vec3Handle): PluginApiReturn<Vec3Components>
 }

package/src/api/design/boolean/index.ts

@@ -1,6 +1,6 @@
 import * as z from "zod"
 import { PluginApiReturn } from "../../../types"
-import { ComponentHandle, Vec3Handle, Vec3Input } from "../../../handles"
+import { ComponentHandle, Vec3Handle } from "../../../handles"
 import { BooleanOutcome } from "../shared"
 
 /**
@@ -132,7 +132,7 @@ export abstract class PluginDesignBooleanApi {
  * | `offset` | {@linkcode Vec3Handle} | Translation added to the created result mass(es) (default: none) |
  */
 export const BooleanOptions = z.object({
-  offset: Vec3Input.optional(),
+  offset: Vec3Handle.optional(),
 })
 export type BooleanOptions = z.infer<typeof BooleanOptions>
 

package/src/api/design/create/bulk-items.ts

@@ -4,7 +4,6 @@ import {
   ContourHandle,
   ProfileHandle,
   Vec3Handle,
-  Vec3Input,
 } from "../../../handles"
 import { PluginOpeningBaseOptions } from "./opening-fields"
 import { PluginWallType } from "../types"
@@ -136,7 +135,7 @@ export type PluginCreateWallRunItems = z.infer<typeof PluginCreateWallRunItems>
 export const PluginCreateFloorItem = z.object({
   contour: ContourHandle,
   thickness: z.number(),
-  position: Vec3Input.optional(),
+  position: Vec3Handle.optional(),
 })
 export type PluginCreateFloorItem = z.infer<typeof PluginCreateFloorItem>
 
@@ -246,7 +245,7 @@ export type PluginCreateWindowItems = z.infer<typeof PluginCreateWindowItems>
  */
 export const PluginCreateFurnitureItem = z.object({
   catalogId: z.string().min(1),
-  position: Vec3Input,
+  position: Vec3Handle,
   label: z.string().optional(),
   angleInDegrees: z.number().optional(),
 })

package/src/api/design/create/index.ts

@@ -8,7 +8,6 @@ import {
   CurveHandle,
   ProfileHandle,
   Vec3Handle,
-  Vec3Input,
 } from "../../../handles"
 import { PluginGridStyleOptions } from "./grids"
 import { PluginGraphicsLineStyleId } from "../../presentation/graphics"
@@ -131,7 +130,7 @@ export abstract class PluginDesignCreateApi {
     contour: ContourHandle,
     height: number,
     label?: string,
-    position?: Vec3Input,
+    position?: Vec3Handle,
     spaceType?: PluginSpaceType,
     massType?: PluginMassType,
     departmentId?: PluginDepartmentId,
@@ -166,7 +165,7 @@ export abstract class PluginDesignCreateApi {
     contour: ContourHandle,
     height: number,
     label?: string,
-    position?: Vec3Input,
+    position?: Vec3Handle,
     massType?: PluginMassType,
   ): PluginApiReturn<ComponentHandle>
 
@@ -289,7 +288,7 @@ export abstract class PluginDesignCreateApi {
    */
   public abstract floor(
     ...args:
-      | [contour: ContourHandle, thickness: number, position?: Vec3Input]
+      | [contour: ContourHandle, thickness: number, position?: Vec3Handle]
       | [contour: ContourHandle, options: PluginFamilyFloorOptions]
   ): PluginApiReturn<ComponentHandle[]>
 
@@ -423,10 +422,10 @@ export abstract class PluginDesignCreateApi {
   public abstract column(
     ...args:
       | [
-          position: Vec3Input,
+          position: Vec3Handle,
           crossSection: ContourHandle,
           height: number,
-          directionUp?: Vec3Input,
+          directionUp?: Vec3Handle,
         ]
       | [axis: LineHandle, options: PluginFamilyPlacement]
   ): PluginApiReturn<ComponentHandle>
@@ -473,7 +472,7 @@ export abstract class PluginDesignCreateApi {
    */
   public abstract beam(
     ...args:
-      | [section: ContourHandle, length: number, direction?: Vec3Input]
+      | [section: ContourHandle, length: number, direction?: Vec3Handle]
       | [axis: LineHandle, options: PluginFamilyPlacement]
   ): PluginApiReturn<ComponentHandle>
 
@@ -650,7 +649,7 @@ export abstract class PluginDesignCreateApi {
    */
   public abstract staircase(
     preset: PluginStaircasePreset,
-    position: Vec3Input,
+    position: Vec3Handle,
     label?: string,
     structureId?: string,
     level?: string,
@@ -741,7 +740,7 @@ export abstract class PluginDesignCreateApi {
     spacingY: number,
     options?: {
       angle?: number
-      center?: Vec3Input
+      center?: Vec3Handle
     } & PluginGridStyleOptions,
   ): PluginApiReturn<ComponentHandle>
 
@@ -896,7 +895,7 @@ export abstract class PluginDesignCreateApi {
    */
   public abstract furniture(
     catalogId: string,
-    position: Vec3Input,
+    position: Vec3Handle,
     options?: { label?: string; createNewSourceMesh?: boolean },
     angleInDegrees?: number,
   ): PluginApiReturn<ComponentHandle>
@@ -1009,14 +1008,14 @@ export abstract class PluginDesignCreateApi {
   public abstract door(
     familyId: string,
     hostWall: ComponentHandle,
-    position: Vec3Input,
+    position: Vec3Handle,
     options?: {
       label?: string
-      hinge?: Vec3Input
+      hinge?: Vec3Handle
       version?: number
       values?: Record<string, number | string>
     },
-    facing?: Vec3Input,
+    facing?: Vec3Handle,
   ): PluginApiReturn<ComponentHandle>
 
   /**
@@ -1113,14 +1112,14 @@ export abstract class PluginDesignCreateApi {
   public abstract window(
     familyId: string,
     hostWall: ComponentHandle,
-    position: Vec3Input,
+    position: Vec3Handle,
     options?: {
       label?: string
-      hinge?: Vec3Input
+      hinge?: Vec3Handle
       version?: number
       values?: Record<string, number | string>
     },
-    facing?: Vec3Input,
+    facing?: Vec3Handle,
   ): PluginApiReturn<ComponentHandle>
 
   /**
@@ -1447,7 +1446,7 @@ export abstract class PluginDesignCreateApi {
    */
   public abstract copy(
     components: ComponentHandle[],
-    displacement: Vec3Input,
+    displacement: Vec3Handle,
     options?: { count?: number; mode?: PluginCopyMode },
   ): PluginApiReturn<ComponentHandle[]>
 
@@ -1670,7 +1669,7 @@ export const PluginDesignCreateSpaceArgs = z.object({
   contour: ContourHandle,
   height: z.number(),
   label: z.string().optional(),
-  position: Vec3Input.optional(),
+  position: Vec3Handle.optional(),
   spaceType: PluginSpaceType.optional(),
   massType: PluginMassType.optional(),
   departmentId: PluginDepartmentId.optional(),
@@ -1701,7 +1700,7 @@ export const PluginDesignCreateMassArgs = z.object({
   contour: ContourHandle,
   height: z.number(),
   label: z.string().optional(),
-  position: Vec3Input.optional(),
+  position: Vec3Handle.optional(),
   massType: PluginMassType.optional(),
 })
 export type PluginDesignCreateMassArgs = z.infer<
@@ -1768,7 +1767,7 @@ export type PluginDesignCreateSlabArgs = z.infer<
 export const PluginDesignCreateFloorArgs = z.object({
   contour: ContourHandle,
   thickness: z.number(),
-  position: Vec3Input.optional(),
+  position: Vec3Handle.optional(),
 })
 export type PluginDesignCreateFloorArgs = z.infer<
   typeof PluginDesignCreateFloorArgs
@@ -1831,10 +1830,10 @@ export type PluginDesignCreateCeilingArgs = z.infer<
  * | `directionUp` | {@linkcode Vec3Handle}? | Up axis (default world up) |
  */
 export const PluginDesignCreateColumnArgs = z.object({
-  position: Vec3Input,
+  position: Vec3Handle,
   crossSection: ContourHandle,
   height: z.number(),
-  directionUp: Vec3Input.optional(),
+  directionUp: Vec3Handle.optional(),
 })
 export type PluginDesignCreateColumnArgs = z.infer<
   typeof PluginDesignCreateColumnArgs
@@ -1856,7 +1855,7 @@ export type PluginDesignCreateColumnArgs = z.infer<
 export const PluginDesignCreateBeamArgs = z.object({
   section: ContourHandle,
   length: z.number(),
-  direction: Vec3Input.optional(),
+  direction: Vec3Handle.optional(),
 })
 export type PluginDesignCreateBeamArgs = z.infer<
   typeof PluginDesignCreateBeamArgs
@@ -1911,7 +1910,7 @@ export type PluginDesignCreateWallsArgs = z.infer<
  */
 export const PluginDesignCreateStaircaseArgs = z.object({
   preset: PluginStaircasePreset,
-  position: Vec3Input,
+  position: Vec3Handle,
   label: z.string().optional(),
   structureId: z.string().optional(),
   level: z.string().optional(),
@@ -1938,7 +1937,7 @@ export type PluginDesignCreateStaircaseArgs = z.infer<
  */
 export const PluginDesignCreateFurnitureArgs = z.object({
   catalogId: z.string().min(1),
-  position: Vec3Input,
+  position: Vec3Handle,
   label: z.string().optional(),
   createNewSourceMesh: z.boolean().optional(),
   angleInDegrees: z.number().optional(),
@@ -2196,7 +2195,7 @@ export type PluginCopyMode = z.infer<typeof PluginCopyMode>
  */
 export const PluginDesignCreateCopyArgs = z.object({
   components: z.array(ComponentHandle).min(1),
-  displacement: Vec3Input,
+  displacement: Vec3Handle,
   count: z.number().int().positive().optional(),
   mode: PluginCopyMode.optional(),
 })
@@ -2229,7 +2228,7 @@ export const PluginCreateSpaceItem = z.object({
   contour: ContourHandle,
   height: z.number(),
   label: z.string().optional(),
-  position: Vec3Input.optional(),
+  position: Vec3Handle.optional(),
   spaceType: PluginSpaceType.optional(),
   massType: PluginMassType.optional(),
   departmentId: PluginDepartmentId.optional(),

package/src/api/design/delete/index.ts

@@ -8,7 +8,7 @@ import { PluginDesignChangeResult } from "../lock"
  *
  * | Property | Type | Description |
  * |---|---|---|
- * | `components` | {@linkcode ComponentHandle}`[]` | Entities to delete. Handles that no longer resolve are skipped and returned as `missing`; the call rejects only when none resolve. |
+ * | `components` | {@linkcode ComponentHandle}`[]` | Entities to delete. Unknown/forged handles reject the whole call (fail-fast). |
  *
  * `.min(1)` is deliberately stricter than the shipped `PluginDesignLockArgs`
  * (which allows an empty array) — an empty delete is a caller error, not a no-op.
@@ -43,19 +43,12 @@ export abstract class PluginDesignDeleteApi {
    * entry, exactly as the editor's Delete key does — see `design.dimensions`. They are
    * NOT listed in `affected`, which reports component handles only.
    *
-   * @param components - Entities to delete. A handle that no longer resolves (already
-   *   removed by an earlier edit — a door deleted with its wall, a wall replaced by an
-   *   opening's re-cut) is skipped, not fatal.
-   * @returns `{ affected, cascaded?, missing?, rejected? }`: the entities you asked to delete
-   *   (echoed host-side — the engine returns no ids); `cascaded`, the derived walls/floors/slabs
-   *   the parametric graph removed with a deleted space; `missing`, handles that no longer
-   *   resolved and were skipped; `rejected`, handles the engine accepted but left standing
-   *   (delete them again, one at a time, or report them). Deleted handles are **stale**
-   *   afterwards: re-resolving one throws `HANDLE_STALE`.
-   * @throws `HANDLE_INVALID` when NONE of the supplied handles resolve (nothing is deleted);
-   *   hosts before Oct 2026 reject the whole call when any handle is gone. `OPERATION_FAILED`
-   *   when the parametric engine rejects the deletion — the batch is rolled back.
-   *   `HANDLE_STALE` for a handle the caller held that has since been retired.
+   * @param components - Entities to delete. Unknown/forged handles reject the whole call (fail-fast).
+   * @returns The entities that were deleted, as {@linkcode ComponentHandle}`[]`
+   *   (echoed host-side from the resolved+deleted set — the engine returns no ids).
+   *   Deleted handles are **stale** afterwards: re-resolving one throws `HANDLE_INVALID`.
+   * @throws If any supplied handle is unknown/forged (`HANDLE_INVALID`) — the whole
+   *   call rejects before anything is deleted (all-or-nothing resolution).
    *
    * @examplePrompt Delete the selected objects
    * @examplePrompt Remove these walls from the model