@snaptrude/plugin-core 0.9.16 → 0.9.18-edgesetbacks-20261021.1

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

@@ -1,317 +1,323 @@
-import * as z from "zod"
-import { PluginApiReturn } from "../../../../types"
-import {
-  ContourHandle,
-  ProfileHandle,
-  Vec3Handle,
-  Vec3Components,
-} from "../../../../handles"
-
-/**
- * Contour editing — produce NEW contours from an existing one (all-handle model, §11).
- *
- * A contour is an outer {@linkcode ProfileHandle} plus zero or more inner profiles
- * that punch holes in it. Every method here is an immutable derive-new operation:
- * it takes an opaque {@linkcode ContourHandle} (plus any extra inputs) and returns a
- * fresh {@linkcode ContourHandle} for the resulting contour. The input contour is
- * never mutated — the original handle keeps referring to the unchanged contour. Read
- * the resulting geometry back as plain values with the query namespace.
- *
- * Accessed via `snaptrude.core.geom.update.contour`.
- */
-export abstract class PluginGeomUpdateContourApi {
-  constructor() {}
-
-  /**
-   * Offset a contour inward/outward by a signed distance. Immutable — returns a NEW
-   * contour and leaves the input unchanged.
-   *
-   * @param contour The contour to offset
-   * @param distance Signed offset distance (outward when positive, inward when negative)
-   * @returns The offset contour as a NEW {@linkcode ContourHandle}
-   * @throws PRECONDITION_FAILED if the outline or a hole has a spline run
-   *   (splines cannot be offset yet)
-   *
-   * @examplePrompt Offset this boundary 500mm inward
-   * @examplePrompt Shrink this floor outline by half a metre all around
-   *
-   * # Example
-   * ```ts
-   * const rect = await snaptrude.core.geom.create.profileRect(10, 8)
-   * const contour = await snaptrude.core.geom.create.contourFromProfile(rect)
-   * const inset = await snaptrude.core.geom.update.contour.offset(contour, -0.5)
-   * const area = await snaptrude.core.geom.query.contour.getArea(inset)
-   * ```
-   */
-  public abstract offset(
-    contour: ContourHandle,
-    distance: number,
-  ): PluginApiReturn<ContourHandle>
-
-  /**
-   * Translate a contour by a vector. Immutable — returns a NEW contour and leaves
-   * the input unchanged.
-   *
-   * @param contour The contour to move
-   * @param translation Translation vector to move the contour by
-   * @returns The moved contour as a NEW {@linkcode ContourHandle}
-   *
-   * @examplePrompt Move this shape 2 metres to the right
-   * @examplePrompt Shift this outline over by 5 feet
-   *
-   * # Example
-   * ```ts
-   * const rect = await snaptrude.core.geom.create.profileRect(6, 4)
-   * const contour = await snaptrude.core.geom.create.contourFromProfile(rect)
-   * const shift = await snaptrude.core.math.vec3.new(2, 0, 0)
-   * const moved = await snaptrude.core.geom.update.contour.move(contour, shift)
-   * ```
-   */
-  public abstract move(
-    contour: ContourHandle,
-    translation: Vec3Handle,
-  ): PluginApiReturn<ContourHandle>
-
-  /**
-   * Rotate a contour about an axis through an optional pivot. Immutable — returns a
-   * NEW contour and leaves the input unchanged.
-   *
-   * @param contour The contour to rotate
-   * @param axis Rotation axis direction
-   * @param angle Rotation angle in radians
-   * @param pivot Optional pivot point to rotate about (defaults to the origin)
-   * @returns The rotated contour as a NEW {@linkcode ContourHandle}
-   *
-   * @examplePrompt Rotate this shape 45 degrees
-   * @examplePrompt Turn this outline 90 degrees about its corner
-   *
-   * # Example
-   * ```ts
-   * const rect = await snaptrude.core.geom.create.profileRect(6, 4)
-   * const contour = await snaptrude.core.geom.create.contourFromProfile(rect)
-   * const axis = await snaptrude.core.math.vec3.new(0, 1, 0)
-   * const pivot = await snaptrude.core.math.vec3.new(3, 0, 2)
-   * const rotated = await snaptrude.core.geom.update.contour.rotate(contour, axis, Math.PI / 4, pivot)
-   * ```
-   */
-  public abstract rotate(
-    contour: ContourHandle,
-    axis: Vec3Handle,
-    angle: number,
-    pivot?: Vec3Handle,
-  ): PluginApiReturn<ContourHandle>
-
-  /**
-   * Scale a contour uniformly or per-axis about an optional pivot. Immutable —
-   * returns a NEW contour and leaves the input unchanged.
-   *
-   * @param contour The contour to scale
-   * @param factor Uniform scale factor, or per-axis factors
-   * @param pivot Optional pivot point to scale about (defaults to the origin)
-   * @returns The scaled contour as a NEW {@linkcode ContourHandle}
-   *
-   * @examplePrompt Scale this shape up by a factor of 2
-   * @examplePrompt Make this outline half its current size
-   *
-   * # Example
-   * ```ts
-   * const rect = await snaptrude.core.geom.create.profileRect(6, 4)
-   * const contour = await snaptrude.core.geom.create.contourFromProfile(rect)
-   * const doubled = await snaptrude.core.geom.update.contour.scale(contour, 2)
-   * const stretched = await snaptrude.core.geom.update.contour.scale(contour, { x: 2, y: 1, z: 1 })
-   * ```
-   */
-  public abstract scale(
-    contour: ContourHandle,
-    factor: number | Vec3Components,
-    pivot?: Vec3Handle,
-  ): PluginApiReturn<ContourHandle>
-
-  /**
-   * Mirror a contour across a plane. Immutable — returns a NEW contour and leaves
-   * the input unchanged.
-   *
-   * @param contour The contour to mirror
-   * @param plane Mirror plane defined by a point on it and its normal
-   * @returns The mirrored contour as a NEW {@linkcode ContourHandle}
-   *
-   * @examplePrompt Mirror this shape across the gridline
-   * @examplePrompt Flip this outline to its mirror image
-   *
-   * # Example
-   * ```ts
-   * const rect = await snaptrude.core.geom.create.profileRect(6, 4)
-   * const contour = await snaptrude.core.geom.create.contourFromProfile(rect)
-   * const point = await snaptrude.core.math.vec3.new(0, 0, 0)
-   * const normal = await snaptrude.core.math.vec3.new(1, 0, 0)
-   * const mirrored = await snaptrude.core.geom.update.contour.mirror(contour, { point, normal })
-   * ```
-   */
-  public abstract mirror(
-    contour: ContourHandle,
-    plane: { point: Vec3Handle; normal: Vec3Handle },
-  ): PluginApiReturn<ContourHandle>
-
-  /**
-   * Add a hole to a contour by appending an inner profile. Immutable — returns a NEW
-   * contour and leaves the input unchanged.
-   *
-   * @param contour The contour to add a hole to
-   * @param hole The inner profile to add as a hole
-   * @returns The contour with the added hole as a NEW {@linkcode ContourHandle}
-   *
-   * @examplePrompt Cut a hole in this shape
-   * @examplePrompt Punch an opening through this floor outline
-   *
-   * # Example
-   * ```ts
-   * const outer = await snaptrude.core.geom.create.profileRect(10, 8)
-   * const contour = await snaptrude.core.geom.create.contourFromProfile(outer)
-   * const hole = await snaptrude.core.geom.create.profileRect(2, 2)
-   * const withHole = await snaptrude.core.geom.update.contour.addHole(contour, hole)
-   * const count = await snaptrude.core.geom.query.contour.getHoleCount(withHole) // 1
-   * ```
-   */
-  public abstract addHole(
-    contour: ContourHandle,
-    hole: ProfileHandle,
-  ): PluginApiReturn<ContourHandle>
-
-  /**
-   * Remove a hole from a contour by inner-profile index. Immutable — returns a NEW
-   * contour and leaves the input unchanged.
-   *
-   * @param contour The contour to remove a hole from
-   * @param index Zero-based index of the inner profile (hole) to remove
-   * @returns The contour with the hole removed as a NEW {@linkcode ContourHandle}
-   *
-   * @examplePrompt Remove the hole from this shape
-   * @examplePrompt Fill in the opening in this floor outline
-   *
-   * # Example
-   * ```ts
-   * const outer = await snaptrude.core.geom.create.profileRect(10, 8)
-   * const hole = await snaptrude.core.geom.create.profileRect(2, 2)
-   * const contour = await snaptrude.core.geom.create.contourFromProfiles(outer, [hole])
-   * const solid = await snaptrude.core.geom.update.contour.removeHole(contour, 0)
-   * ```
-   */
-  public abstract removeHole(
-    contour: ContourHandle,
-    index: number,
-  ): PluginApiReturn<ContourHandle>
-}
-
-/**
- * Arguments for {@linkcode PluginGeomUpdateContourApi.offset}.
- *
- * | Property | Type | Description |
- * |---|---|---|
- * | `contour` | {@linkcode ContourHandle} | The contour to offset |
- * | `distance` | `number` | Signed offset distance (outward when positive, inward when negative) |
- */
-export const PluginGeomUpdateContourOffsetArgs = z.object({
-  contour: ContourHandle,
-  distance: z.number(),
-})
-
-export type PluginGeomUpdateContourOffsetArgs = z.infer<typeof PluginGeomUpdateContourOffsetArgs>
-
-/**
- * Arguments for {@linkcode PluginGeomUpdateContourApi.move}.
- *
- * | Property | Type | Description |
- * |---|---|---|
- * | `contour` | {@linkcode ContourHandle} | The contour to move |
- * | `translation` | {@linkcode Vec3Handle} | Translation vector to move the contour by |
- */
-export const PluginGeomUpdateContourMoveArgs = z.object({
-  contour: ContourHandle,
-  translation: Vec3Handle,
-})
-
-export type PluginGeomUpdateContourMoveArgs = z.infer<typeof PluginGeomUpdateContourMoveArgs>
-
-/**
- * Arguments for {@linkcode PluginGeomUpdateContourApi.rotate}.
- *
- * | Property | Type | Description |
- * |---|---|---|
- * | `contour` | {@linkcode ContourHandle} | The contour to rotate |
- * | `axis` | {@linkcode Vec3Handle} | Rotation axis direction |
- * | `angle` | `number` | Rotation angle in radians |
- * | `pivot` | {@linkcode Vec3Handle} | Optional pivot point to rotate about (defaults to the origin) |
- */
-export const PluginGeomUpdateContourRotateArgs = z.object({
-  contour: ContourHandle,
-  axis: Vec3Handle,
-  angle: z.number(),
-  pivot: Vec3Handle.optional(),
-})
-
-export type PluginGeomUpdateContourRotateArgs = z.infer<typeof PluginGeomUpdateContourRotateArgs>
-
-/**
- * Arguments for {@linkcode PluginGeomUpdateContourApi.scale}.
- *
- * | Property | Type | Description |
- * |---|---|---|
- * | `contour` | {@linkcode ContourHandle} | The contour to scale |
- * | `factor` | `number` \| {@linkcode Vec3Components} | Uniform scale factor, or per-axis factors |
- * | `pivot` | {@linkcode Vec3Handle} | Optional pivot point to scale about (defaults to the origin) |
- */
-export const PluginGeomUpdateContourScaleArgs = z.object({
-  contour: ContourHandle,
-  factor: z.union([z.number(), Vec3Components]),
-  pivot: Vec3Handle.optional(),
-})
-
-export type PluginGeomUpdateContourScaleArgs = z.infer<typeof PluginGeomUpdateContourScaleArgs>
-
-/**
- * Arguments for {@linkcode PluginGeomUpdateContourApi.mirror}.
- *
- * | Property | Type | Description |
- * |---|---|---|
- * | `contour` | {@linkcode ContourHandle} | The contour to mirror |
- * | `plane` | `{ point: `{@linkcode Vec3Handle}`, normal: `{@linkcode Vec3Handle}` }` | Mirror plane defined by a point on it and its normal |
- */
-export const PluginGeomUpdateContourMirrorArgs = z.object({
-  contour: ContourHandle,
-  plane: z.object({
-    point: Vec3Handle,
-    normal: Vec3Handle,
-  }),
-})
-
-export type PluginGeomUpdateContourMirrorArgs = z.infer<typeof PluginGeomUpdateContourMirrorArgs>
-
-/**
- * Arguments for {@linkcode PluginGeomUpdateContourApi.addHole}.
- *
- * | Property | Type | Description |
- * |---|---|---|
- * | `contour` | {@linkcode ContourHandle} | The contour to add a hole to |
- * | `hole` | {@linkcode ProfileHandle} | The inner profile to add as a hole |
- */
-export const PluginGeomUpdateContourAddHoleArgs = z.object({
-  contour: ContourHandle,
-  hole: ProfileHandle,
-})
-
-export type PluginGeomUpdateContourAddHoleArgs = z.infer<typeof PluginGeomUpdateContourAddHoleArgs>
-
-/**
- * Arguments for {@linkcode PluginGeomUpdateContourApi.removeHole}.
- *
- * | Property | Type | Description |
- * |---|---|---|
- * | `contour` | {@linkcode ContourHandle} | The contour to remove a hole from |
- * | `index` | `number` | Zero-based index of the inner profile (hole) to remove |
- */
-export const PluginGeomUpdateContourRemoveHoleArgs = z.object({
-  contour: ContourHandle,
-  index: z.number(),
-})
-
-export type PluginGeomUpdateContourRemoveHoleArgs = z.infer<typeof PluginGeomUpdateContourRemoveHoleArgs>
+import * as z from "zod"
+import { PluginApiReturn } from "../../../../types"
+import {
+  ContourHandle,
+  ProfileHandle,
+  Vec3Handle,
+  Vec3Components,
+} from "../../../../handles"
+
+/**
+ * Contour editing — produce NEW contours from an existing one (all-handle model, §11).
+ *
+ * A contour is an outer {@linkcode ProfileHandle} plus zero or more inner profiles
+ * that punch holes in it. Every method here is an immutable derive-new operation:
+ * it takes an opaque {@linkcode ContourHandle} (plus any extra inputs) and returns a
+ * fresh {@linkcode ContourHandle} for the resulting contour. The input contour is
+ * never mutated — the original handle keeps referring to the unchanged contour. Read
+ * the resulting geometry back as plain values with the query namespace.
+ *
+ * Accessed via `snaptrude.core.geom.update.contour`.
+ */
+export abstract class PluginGeomUpdateContourApi {
+  constructor() {}
+
+  /**
+   * Offset a contour inward/outward by a signed distance. Immutable — returns a NEW
+   * contour and leaves the input unchanged.
+   *
+   * @param contour The contour to offset
+   * @param distance Signed offset distance (outward when positive, inward when negative)
+   * @returns The offset contour as a NEW {@linkcode ContourHandle}
+   * @throws PRECONDITION_FAILED if the outline or a hole has a spline run
+   *   (splines cannot be offset yet)
+   *
+   * @examplePrompt Offset this boundary 500mm inward
+   * @examplePrompt Shrink this floor outline by half a metre all around
+   *
+   * # Example
+   * ```ts
+   * const rect = await snaptrude.core.geom.create.profileRect(10, 8)
+   * const contour = await snaptrude.core.geom.create.contourFromProfile(rect)
+   * const inset = await snaptrude.core.geom.update.contour.offset(contour, -0.5)
+   * const area = await snaptrude.core.geom.query.contour.getArea(inset)
+   * ```
+   */
+  public abstract offset(
+    contour: ContourHandle,
+    distance: number,
+  ): PluginApiReturn<ContourHandle>
+
+  /**
+   * Translate a contour by a vector. Immutable — returns a NEW contour and leaves
+   * the input unchanged.
+   *
+   * @param contour The contour to move
+   * @param translation Translation vector to move the contour by
+   * @returns The moved contour as a NEW {@linkcode ContourHandle}
+   *
+   * @examplePrompt Move this shape 2 metres to the right
+   * @examplePrompt Shift this outline over by 5 feet
+   *
+   * # Example
+   * ```ts
+   * const rect = await snaptrude.core.geom.create.profileRect(6, 4)
+   * const contour = await snaptrude.core.geom.create.contourFromProfile(rect)
+   * const shift = await snaptrude.core.math.vec3.new(2, 0, 0)
+   * const moved = await snaptrude.core.geom.update.contour.move(contour, shift)
+   * ```
+   */
+  public abstract move(
+    contour: ContourHandle,
+    translation: Vec3Handle,
+  ): PluginApiReturn<ContourHandle>
+
+  /**
+   * Rotate a contour about an axis through an optional pivot. Immutable — returns a
+   * NEW contour and leaves the input unchanged.
+   *
+   * @param contour The contour to rotate
+   * @param axis Rotation axis direction
+   * @param angle Rotation angle in radians
+   * @param pivot Optional pivot point to rotate about (defaults to the origin)
+   * @returns The rotated contour as a NEW {@linkcode ContourHandle}
+   *
+   * @examplePrompt Rotate this shape 45 degrees
+   * @examplePrompt Turn this outline 90 degrees about its corner
+   *
+   * # Example
+   * ```ts
+   * const rect = await snaptrude.core.geom.create.profileRect(6, 4)
+   * const contour = await snaptrude.core.geom.create.contourFromProfile(rect)
+   * const axis = await snaptrude.core.math.vec3.new(0, 1, 0)
+   * const pivot = await snaptrude.core.math.vec3.new(3, 0, 2)
+   * const rotated = await snaptrude.core.geom.update.contour.rotate(contour, axis, Math.PI / 4, pivot)
+   * ```
+   */
+  public abstract rotate(
+    contour: ContourHandle,
+    axis: Vec3Handle,
+    angle: number,
+    pivot?: Vec3Handle,
+  ): PluginApiReturn<ContourHandle>
+
+  /**
+   * Scale a contour uniformly or per-axis about an optional pivot. Immutable —
+   * returns a NEW contour and leaves the input unchanged.
+   *
+   * @param contour The contour to scale
+   * @param factor Uniform scale factor, or per-axis factors
+   * @param pivot Optional pivot point to scale about (defaults to the origin)
+   * @returns The scaled contour as a NEW {@linkcode ContourHandle}
+   *
+   * @examplePrompt Scale this shape up by a factor of 2
+   * @examplePrompt Make this outline half its current size
+   *
+   * # Example
+   * ```ts
+   * const rect = await snaptrude.core.geom.create.profileRect(6, 4)
+   * const contour = await snaptrude.core.geom.create.contourFromProfile(rect)
+   * const doubled = await snaptrude.core.geom.update.contour.scale(contour, 2)
+   * const stretched = await snaptrude.core.geom.update.contour.scale(contour, { x: 2, y: 1, z: 1 })
+   * ```
+   */
+  public abstract scale(
+    contour: ContourHandle,
+    factor: number | Vec3Components,
+    pivot?: Vec3Handle,
+  ): PluginApiReturn<ContourHandle>
+
+  /**
+   * Mirror a contour across a plane. Immutable — returns a NEW contour and leaves
+   * the input unchanged.
+   *
+   * @param contour The contour to mirror
+   * @param plane Mirror plane defined by a point on it and its normal
+   * @returns The mirrored contour as a NEW {@linkcode ContourHandle}
+   *
+   * @examplePrompt Mirror this shape across the gridline
+   * @examplePrompt Flip this outline to its mirror image
+   *
+   * # Example
+   * ```ts
+   * const rect = await snaptrude.core.geom.create.profileRect(6, 4)
+   * const contour = await snaptrude.core.geom.create.contourFromProfile(rect)
+   * const point = await snaptrude.core.math.vec3.new(0, 0, 0)
+   * const normal = await snaptrude.core.math.vec3.new(1, 0, 0)
+   * const mirrored = await snaptrude.core.geom.update.contour.mirror(contour, { point, normal })
+   * ```
+   */
+  public abstract mirror(
+    contour: ContourHandle,
+    plane: { point: Vec3Handle; normal: Vec3Handle },
+  ): PluginApiReturn<ContourHandle>
+
+  /**
+   * Add a hole to a contour by appending an inner profile. Immutable — returns a NEW
+   * contour and leaves the input unchanged.
+   *
+   * Edits a contour value only; for an editable hole in an existing slab, floor
+   * or roof use `design.create.void`.
+   *
+   * @param contour The contour to add a hole to
+   * @param hole The inner profile to add as a hole
+   * @returns The contour with the added hole as a NEW {@linkcode ContourHandle}
+   *
+   * @examplePrompt Cut a hole in this shape
+   * @examplePrompt Punch an opening through this outline
+   *
+   * # Example
+   * ```ts
+   * const outer = await snaptrude.core.geom.create.profileRect(10, 8)
+   * const contour = await snaptrude.core.geom.create.contourFromProfile(outer)
+   * const hole = await snaptrude.core.geom.create.profileRect(2, 2)
+   * const withHole = await snaptrude.core.geom.update.contour.addHole(contour, hole)
+   * const count = await snaptrude.core.geom.query.contour.getHoleCount(withHole) // 1
+   * ```
+   */
+  public abstract addHole(
+    contour: ContourHandle,
+    hole: ProfileHandle,
+  ): PluginApiReturn<ContourHandle>
+
+  /**
+   * Remove a hole from a contour by inner-profile index. Immutable — returns a NEW
+   * contour and leaves the input unchanged.
+   *
+   * Edits a contour value only; for an editable hole in an existing slab, floor
+   * or roof use `design.create.void`.
+   *
+   * @param contour The contour to remove a hole from
+   * @param index Zero-based index of the inner profile (hole) to remove
+   * @returns The contour with the hole removed as a NEW {@linkcode ContourHandle}
+   *
+   * @examplePrompt Remove the hole from this shape
+   * @examplePrompt Fill in the opening in this outline
+   *
+   * # Example
+   * ```ts
+   * const outer = await snaptrude.core.geom.create.profileRect(10, 8)
+   * const hole = await snaptrude.core.geom.create.profileRect(2, 2)
+   * const contour = await snaptrude.core.geom.create.contourFromProfiles(outer, [hole])
+   * const solid = await snaptrude.core.geom.update.contour.removeHole(contour, 0)
+   * ```
+   */
+  public abstract removeHole(
+    contour: ContourHandle,
+    index: number,
+  ): PluginApiReturn<ContourHandle>
+}
+
+/**
+ * Arguments for {@linkcode PluginGeomUpdateContourApi.offset}.
+ *
+ * | Property | Type | Description |
+ * |---|---|---|
+ * | `contour` | {@linkcode ContourHandle} | The contour to offset |
+ * | `distance` | `number` | Signed offset distance (outward when positive, inward when negative) |
+ */
+export const PluginGeomUpdateContourOffsetArgs = z.object({
+  contour: ContourHandle,
+  distance: z.number(),
+})
+
+export type PluginGeomUpdateContourOffsetArgs = z.infer<typeof PluginGeomUpdateContourOffsetArgs>
+
+/**
+ * Arguments for {@linkcode PluginGeomUpdateContourApi.move}.
+ *
+ * | Property | Type | Description |
+ * |---|---|---|
+ * | `contour` | {@linkcode ContourHandle} | The contour to move |
+ * | `translation` | {@linkcode Vec3Handle} | Translation vector to move the contour by |
+ */
+export const PluginGeomUpdateContourMoveArgs = z.object({
+  contour: ContourHandle,
+  translation: Vec3Handle,
+})
+
+export type PluginGeomUpdateContourMoveArgs = z.infer<typeof PluginGeomUpdateContourMoveArgs>
+
+/**
+ * Arguments for {@linkcode PluginGeomUpdateContourApi.rotate}.
+ *
+ * | Property | Type | Description |
+ * |---|---|---|
+ * | `contour` | {@linkcode ContourHandle} | The contour to rotate |
+ * | `axis` | {@linkcode Vec3Handle} | Rotation axis direction |
+ * | `angle` | `number` | Rotation angle in radians |
+ * | `pivot` | {@linkcode Vec3Handle} | Optional pivot point to rotate about (defaults to the origin) |
+ */
+export const PluginGeomUpdateContourRotateArgs = z.object({
+  contour: ContourHandle,
+  axis: Vec3Handle,
+  angle: z.number(),
+  pivot: Vec3Handle.optional(),
+})
+
+export type PluginGeomUpdateContourRotateArgs = z.infer<typeof PluginGeomUpdateContourRotateArgs>
+
+/**
+ * Arguments for {@linkcode PluginGeomUpdateContourApi.scale}.
+ *
+ * | Property | Type | Description |
+ * |---|---|---|
+ * | `contour` | {@linkcode ContourHandle} | The contour to scale |
+ * | `factor` | `number` \| {@linkcode Vec3Components} | Uniform scale factor, or per-axis factors |
+ * | `pivot` | {@linkcode Vec3Handle} | Optional pivot point to scale about (defaults to the origin) |
+ */
+export const PluginGeomUpdateContourScaleArgs = z.object({
+  contour: ContourHandle,
+  factor: z.union([z.number(), Vec3Components]),
+  pivot: Vec3Handle.optional(),
+})
+
+export type PluginGeomUpdateContourScaleArgs = z.infer<typeof PluginGeomUpdateContourScaleArgs>
+
+/**
+ * Arguments for {@linkcode PluginGeomUpdateContourApi.mirror}.
+ *
+ * | Property | Type | Description |
+ * |---|---|---|
+ * | `contour` | {@linkcode ContourHandle} | The contour to mirror |
+ * | `plane` | `{ point: `{@linkcode Vec3Handle}`, normal: `{@linkcode Vec3Handle}` }` | Mirror plane defined by a point on it and its normal |
+ */
+export const PluginGeomUpdateContourMirrorArgs = z.object({
+  contour: ContourHandle,
+  plane: z.object({
+    point: Vec3Handle,
+    normal: Vec3Handle,
+  }),
+})
+
+export type PluginGeomUpdateContourMirrorArgs = z.infer<typeof PluginGeomUpdateContourMirrorArgs>
+
+/**
+ * Arguments for {@linkcode PluginGeomUpdateContourApi.addHole}.
+ *
+ * | Property | Type | Description |
+ * |---|---|---|
+ * | `contour` | {@linkcode ContourHandle} | The contour to add a hole to |
+ * | `hole` | {@linkcode ProfileHandle} | The inner profile to add as a hole |
+ */
+export const PluginGeomUpdateContourAddHoleArgs = z.object({
+  contour: ContourHandle,
+  hole: ProfileHandle,
+})
+
+export type PluginGeomUpdateContourAddHoleArgs = z.infer<typeof PluginGeomUpdateContourAddHoleArgs>
+
+/**
+ * Arguments for {@linkcode PluginGeomUpdateContourApi.removeHole}.
+ *
+ * | Property | Type | Description |
+ * |---|---|---|
+ * | `contour` | {@linkcode ContourHandle} | The contour to remove a hole from |
+ * | `index` | `number` | Zero-based index of the inner profile (hole) to remove |
+ */
+export const PluginGeomUpdateContourRemoveHoleArgs = z.object({
+  contour: ContourHandle,
+  index: z.number(),
+})
+
+export type PluginGeomUpdateContourRemoveHoleArgs = z.infer<typeof PluginGeomUpdateContourRemoveHoleArgs>