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

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

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

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

@@ -1,6 +1,6 @@
 import * as z from "zod"
 import { PluginApiReturn } from "../../../../types"
-import { Vec3Handle, CurveHandle } from "../../../../handles"
+import { Vec3Handle, Vec3Input, 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: Vec3Handle,
+    point: Vec3Input,
   ): PluginApiReturn<CurveHandle[]>
 
   /**
@@ -110,7 +110,7 @@ export abstract class PluginGeomUpdateCurveApi {
    */
   public abstract offset(
     curve: CurveHandle,
-    vector: Vec3Handle,
+    vector: Vec3Input,
   ): PluginApiReturn<CurveHandle>
 
   /**
@@ -158,7 +158,7 @@ export type PluginGeomUpdateCurveExtendArgs = z.infer<typeof PluginGeomUpdateCur
  */
 export const PluginGeomUpdateCurveSplitArgs = z.object({
   curve: CurveHandle,
-  point: Vec3Handle,
+  point: Vec3Input,
 })
 
 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: Vec3Handle,
+  vector: Vec3Input,
 })
 
 export type PluginGeomUpdateCurveOffsetArgs = z.infer<typeof PluginGeomUpdateCurveOffsetArgs>

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

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

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

@@ -2,6 +2,7 @@ import * as z from "zod"
 import { PluginApiReturn } from "../../../../types"
 import {
   Vec3Handle,
+  Vec3Input,
   UnderlayHandle,
   TerrainHandle,
   ImportJobHandle,
@@ -266,7 +267,7 @@ export abstract class PluginCoreIoImportApi {
     source: string,
     storey?: number,
     format?: ModelFormat,
-    position?: Vec3Handle,
+    position?: Vec3Input,
     label?: string,
   ): PluginApiReturn<ComponentHandle>
 
@@ -445,7 +446,7 @@ export const PluginImportModelArgs = z.object({
   source: ImportSource,
   storey: z.number().int().optional(),
   format: ModelFormat.optional(),
-  position: Vec3Handle.optional(),
+  position: Vec3Input.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, QuatHandle, QuatComponents } from "../../../handles"
+import { Vec3Handle, Vec3Input, 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: Vec3Handle, angle: number): PluginApiReturn<QuatHandle>
+  abstract fromAxisAngle(axis: Vec3Input, 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, Vec3Components } from "../../../handles"
+import { Vec3Handle, Vec3Input, 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: Vec3Handle, b: Vec3Handle): PluginApiReturn<Vec3Handle>
+  abstract add(a: Vec3Input, b: Vec3Input): 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: Vec3Handle, b: Vec3Handle): PluginApiReturn<Vec3Handle>
+  abstract subtract(a: Vec3Input, b: Vec3Input): 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: Vec3Handle, scalar: number): PluginApiReturn<Vec3Handle>
+  abstract scale(v: Vec3Input, 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: Vec3Handle, b: Vec3Handle): PluginApiReturn<number>
+  abstract dot(a: Vec3Input, b: Vec3Input): 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: Vec3Handle, b: Vec3Handle): PluginApiReturn<Vec3Handle>
+  abstract cross(a: Vec3Input, b: Vec3Input): 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: Vec3Handle): PluginApiReturn<number>
+  abstract length(v: Vec3Input): 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: Vec3Handle): PluginApiReturn<number>
+  abstract lengthSquared(v: Vec3Input): 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: Vec3Handle): PluginApiReturn<Vec3Handle>
+  abstract normalize(v: Vec3Input): 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: Vec3Handle, b: Vec3Handle): PluginApiReturn<number>
+  abstract distance(a: Vec3Input, b: Vec3Input): 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: Vec3Handle, b: Vec3Handle, t: number): PluginApiReturn<Vec3Handle>
+  abstract lerp(a: Vec3Input, b: Vec3Input, 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: Vec3Handle): PluginApiReturn<Vec3Handle>
+  abstract negate(v: Vec3Input): 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: Vec3Handle, b: Vec3Handle): PluginApiReturn<boolean>
+  abstract equals(a: Vec3Input, b: Vec3Input): 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: Vec3Handle,
-    b: Vec3Handle,
+    a: Vec3Input,
+    b: Vec3Input,
     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: Vec3Handle): PluginApiReturn<Vec3Components>
+  abstract components(v: Vec3Input): 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 } from "../../../handles"
+import { ComponentHandle, Vec3Handle, Vec3Input } 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: Vec3Handle.optional(),
+  offset: Vec3Input.optional(),
 })
 export type BooleanOptions = z.infer<typeof BooleanOptions>
 

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

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

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

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