@snaptrude/plugin-core 0.7.1 → 0.9.0

package/dist/api/design/create/index.d.ts

@@ -1,7 +1,8 @@
 import * as z from "zod";
 import { PluginApiReturn } from "../../../types";
-import { ComponentHandle, ContourHandle, ProfileHandle, Vec3Handle } from "../../../handles";
+import { BrepHandle, ComponentHandle, ContourHandle, ProfileHandle, Vec3Handle } from "../../../handles";
 import { PluginSpaceType, PluginMassType, PluginDepartmentId } from "../../entity/space";
+import { PluginBuildableEnvelopePolygonVertex, PluginBuildableEnvelopeSetbackTier, PluginBuildableEnvelopeVerticalCap, PluginBuildableEnvelopeCreateResult } from "../../entity/buildableEnvelope";
 /**
  * `design.create.*` — author new scene-committed BIM entities.
  *
@@ -39,14 +40,25 @@ export declare abstract class PluginDesignCreateApi {
      * @param spaceType - Space-type classification (default `Room`)
      * @param massType - Mass-type classification (default `Room`)
      * @param departmentId - Department assignment (default department)
+     * @param storey - Target storey number to place the space on — the same integer
+     *   `entity.story` uses (`1` ground, `2` first floor, `-1` basement). Default:
+     *   the active storey. Folds a `core.storeys.setActive` call into the create,
+     *   placing the space at that storey's floor elevation (any `position` offset is
+     *   applied on top). Throws if no storey has that value.
      * @returns the {@linkcode ComponentHandle} of the created space
-     * @throws if the contour is invalid or the height is not positive
+     * @throws if the contour is invalid, the height is not positive, or the target
+     *   storey does not exist
      *
      * @examplePrompt Create a room called Living Room that's 3m tall from this outline
      * @examplePrompt Add a new space on the current storey using this footprint
      * @examplePrompt Make a bedroom here and assign it to the Residential department
      * @examplePrompt Extrude this closed outline into a 10 foot high room
      * @examplePrompt Can you create a Kitchen space from the sketch I just drew?
+     * @examplePrompt Create a bedroom on the second floor from this outline
+     *
+     * @performance For MORE THAN ONE space, call `design.create.spaces(items[])` — the whole
+     *   batch is one host round-trip. Looping this single-space creator is N round-trips (slow,
+     *   and a large loop can trip the plugin rate limit).
      *
      * # Example
      * ```ts
@@ -59,9 +71,13 @@ export declare abstract class PluginDesignCreateApi {
      * ])
      * const contour = await snaptrude.core.geom.create.contourFromProfile(outer)
      * const space = await snaptrude.design.create.space(contour, 3, "Living")
+     * // …place one directly on the second floor (no setActive dance):
+     * const upstairs = await snaptrude.design.create.space(
+     *   contour, 3, "Bedroom", undefined, undefined, undefined, undefined, 2,
+     * )
      * ```
      */
-    abstract space(contour: ContourHandle, height: number, label?: string, position?: Vec3Handle, spaceType?: PluginSpaceType, massType?: PluginMassType, departmentId?: PluginDepartmentId): PluginApiReturn<ComponentHandle>;
+    abstract space(contour: ContourHandle, height: number, label?: string, position?: Vec3Handle, spaceType?: PluginSpaceType, massType?: PluginMassType, departmentId?: PluginDepartmentId, storey?: number): PluginApiReturn<ComponentHandle>;
     /**
      * Create a **mass** — a generic extruded prism (default `massType` "Generic mass").
      * Same footprint-extrude path as {@linkcode PluginDesignCreateApi.space}.
@@ -87,6 +103,47 @@ export declare abstract class PluginDesignCreateApi {
      * ```
      */
     abstract mass(contour: ContourHandle, height: number, label?: string, position?: Vec3Handle, massType?: PluginMassType): PluginApiReturn<ComponentHandle>;
+    /**
+     * Create a **mass** from a custom solid built with a `core.geom.create` brep
+     * constructor (`brepFromFaces`, `brepFromExtrusion`, `brepFromLoft`,
+     * `brepFromMesh`, or a brep boolean) — the free-form counterpart of
+     * {@linkcode PluginDesignCreateApi.mass}, for solids that are not simple
+     * footprint extrusions (pyramids, wedges, faceted volumes).
+     *
+     * Only accepts breps **minted by a `core.geom.create` brep constructor** —
+     * scene-derived breps from `design.query.geometry.getBrep` are read-only and
+     * throw. The mass is created as a generic mass (`massType` "Generic mass") at
+     * the exact coordinates the solid was authored in, committed as a single
+     * undo step, and synced to collaborators like any other creator.
+     *
+     * @param brep - A solid from a `core.geom.create` brep constructor
+     * @param label - Label (maps to `room_type`)
+     * @returns the {@linkcode ComponentHandle} of the created mass
+     * @throws if the brep handle is invalid, or the brep was not created by a
+     *   `core.geom.create` brep constructor
+     *
+     * @examplePrompt Create a mass from these faces
+     * @examplePrompt Turn this custom brep into a scene mass
+     * @examplePrompt Add a pyramid-shaped mass to the model
+     *
+     * # Example
+     * ```ts
+     * const apex = { x: 0, y: 4, z: 0 }
+     * const a = { x: -2, y: 0, z: -2 }
+     * const b = { x: 2, y: 0, z: -2 }
+     * const c = { x: 2, y: 0, z: 2 }
+     * const d = { x: -2, y: 0, z: 2 }
+     * const brep = await snaptrude.core.geom.create.brepFromFaces([
+     *   [a, d, c, b],
+     *   [a, b, apex],
+     *   [b, c, apex],
+     *   [c, d, apex],
+     *   [d, a, apex],
+     * ])
+     * const pyramid = await snaptrude.design.create.massFromBrep(brep, "Pavilion")
+     * ```
+     */
+    abstract massFromBrep(brep: BrepHandle, label?: string): PluginApiReturn<ComponentHandle>;
     /**
      * Create a **slab** by extruding a footprint contour by `thickness`
      * (default direction: down).
@@ -182,14 +239,17 @@ export declare abstract class PluginDesignCreateApi {
     abstract ceiling(contour: ContourHandle, thickness: number, heightFromFloor?: number): PluginApiReturn<ComponentHandle>;
     /**
      * Create a **column** by extruding a cross-section contour upward by `height`
-     * from a base `position`.
+     * from a base `position`. The column is built to EXACTLY `height` — unlike
+     * the interactive draw tool, no slab-thickness deduction is applied.
      *
      * @param position - Base point
      * @param crossSection - Column cross-section footprint
-     * @param height - Column height (> 0)
-     * @param directionUp - Up axis (default world up)
+     * @param height - Column height (> 0), built exactly
+     * @param directionUp - Up axis (default world up); normalized by the host, so
+     * magnitude does not scale the height
      * @returns the {@linkcode ComponentHandle} of the created column
-     * @throws if the cross-section is invalid or the height is not positive
+     * @throws if the cross-section is invalid, the height is not positive, or the
+     * direction is zero / lies in the cross-section plane (degenerate extrusion)
      *
      * @examplePrompt Add a 3m tall column at this point
      * @examplePrompt Place a column at the grid intersection
@@ -207,13 +267,30 @@ export declare abstract class PluginDesignCreateApi {
     abstract column(position: Vec3Handle, crossSection: ContourHandle, height: number, directionUp?: Vec3Handle): PluginApiReturn<ComponentHandle>;
     /**
      * Create a **beam** by extruding a cross-section contour along `direction` by
-     * `length`.
+     * `length`. Matches the Snaptrude beam tool's semantics: the beam body hangs
+     * BELOW the plane the section is authored on.
+     *
+     * For a **horizontal** `direction` (the common spanning beam), author the
+     * section as an axis-aligned plan rectangle: its X extent is the beam's
+     * width, its Z extent is the beam's depth (the vertical drop). The beam runs
+     * `length` along `direction` starting at the section's centre, hanging below
+     * the authoring plane by its depth — exactly like an interactively drawn
+     * beam. Only axis-aligned rectangular sections are supported horizontally.
      *
-     * @param section - Beam cross-section footprint
-     * @param length - Beam length along `direction` (> 0)
-     * @param direction - Extrusion axis (default world up)
+     * For a **vertical** `direction` (the default), the section itself is
+     * extruded by `length`, again hanging below the authoring plane. Diagonal
+     * directions are rejected.
+     *
+     * @param section - Beam cross-section, an axis-aligned rectangle in plan
+     * (X extent = width, Z extent = depth)
+     * @param length - Beam length along `direction` (> 0); direction is
+     * normalized by the host, so magnitude does not scale the length
+     * @param direction - Beam axis: horizontal for a spanning beam, or vertical
+     * (default world up). Diagonal directions throw.
      * @returns the {@linkcode ComponentHandle} of the created beam
-     * @throws if the section is invalid or the length is not positive
+     * @throws if the section is invalid (horizontal beams: not an axis-aligned
+     * plan rectangle), the length is not positive, or the direction is zero or
+     * diagonal
      *
      * @examplePrompt Add a beam spanning 6 metres between the columns
      * @examplePrompt Create a horizontal beam along the X axis
@@ -235,15 +312,25 @@ export declare abstract class PluginDesignCreateApi {
      *
      * @param profile - Ordered curve chain (wall centerlines)
      * @param height - Wall height (default engine default)
-     * @param thickness - Wall thickness (default engine default)
+     * @param thickness - Wall thickness (default: the `wallType`'s total layer
+     *   thickness when `wallType` is given, else the engine default)
+     * @param wallType - Wall type to build with — the same searchable list the
+     *   Draw tab's Wall Type dropdown offers. Pass a name from
+     *   `design.types.list("wall")` (the summary's `label`, or its `"wall:…"` id).
+     *   Drives the wall's construction layers and default material, and — when
+     *   `thickness` is omitted — its total layer thickness. Default: the engine's
+     *   generic wall.
      * @returns a {@linkcode ComponentHandle}`[]` (one per wall), in profile order
-     * @throws if the profile is empty or wall creation fails
+     * @throws if the profile is empty, `wallType` names no wall type in the
+     *   project, or wall creation fails
      *
      * @examplePrompt Draw walls along this centerline
      * @examplePrompt Create 3m high, 200mm thick walls from these points
      * @examplePrompt Build a wall run around the room outline
      * @examplePrompt Turn this polyline sketch into walls
      * @examplePrompt Add walls with mitred corners along the path
+     * @examplePrompt Draw brick walls with plaster along this outline
+     * @examplePrompt Build the perimeter in exposed concrete walls
      *
      * # Example
      * ```ts
@@ -254,9 +341,14 @@ export declare abstract class PluginDesignCreateApi {
      *   await v.new(8, 0, 6),
      * ])
      * const walls = await snaptrude.design.create.walls(centerlines, 3, 0.2)
+     * // …built as a specific wall type (layers/material/thickness from the type):
+     * const [brick] = await snaptrude.design.types.list("wall")
+     * const brickWalls = await snaptrude.design.create.walls(
+     *   centerlines, 3, undefined, brick.label,
+     * )
      * ```
      */
-    abstract walls(profile: ProfileHandle, height?: number, thickness?: number): PluginApiReturn<ComponentHandle[]>;
+    abstract walls(profile: ProfileHandle, height?: number, thickness?: number, wallType?: string): PluginApiReturn<ComponentHandle[]>;
     /**
      * Create a **staircase** from a parametric preset, placed at a point.
      *
@@ -331,14 +423,19 @@ export declare abstract class PluginDesignCreateApi {
      * with {@linkcode PluginDesignFurnitureApi.listCatalog}. Placement is asynchronous
      * (the source mesh is fetched if not cached) and creates one undo entry.
      *
-     * Placed at the item's default rotation; rotate afterward via `design.transform.rotate`
-     * on the returned handle (planned namespace).
+     * Placed at the item's default rotation unless `angleInDegrees` is given, which
+     * rotates it about the vertical axis at creation time (baked into the same undo
+     * entry). To rotate an existing instance instead, use `design.transform.rotate`.
      *
      * @param catalogId - Library id: team `_id` or general `fullName`
      * @param position - Absolute world placement point
      * @param options - Optional placement options: `label` — instance name
      *   (default auto `${name}Ins${n}`); `createNewSourceMesh` — emit a
      *   source-mesh creation command (default `true`)
+     * @param angleInDegrees - Optional signed rotation about the vertical axis, in
+     *   degrees (same convention as {@linkcode PluginDesignTransformApi.rotate}).
+     *   Applied at creation time so it is part of the placement's single undo entry.
+     *   Default: the item's own (unrotated) orientation.
      * @returns the {@linkcode ComponentHandle} of the placed furniture instance
      * @throws if the catalog id is unknown, the source mesh fails to load, or placement fails
      *
@@ -347,6 +444,7 @@ export declare abstract class PluginDesignCreateApi {
      * @examplePrompt Drop a desk into the scene at 3, 0, 5
      * @examplePrompt Insert the uploaded bed model in the bedroom
      * @examplePrompt Put a table from my project library here and name it Table-01
+     * @examplePrompt Place a chair here rotated 90 degrees
      *
      * # Example
      * ```ts
@@ -355,12 +453,19 @@ export declare abstract class PluginDesignCreateApi {
      *   await snaptrude.core.math.vec3.new(3, 0, 5),
      *   { label: "Chair-01" },
      * )
+     * // …placed already turned 90° about the vertical axis:
+     * const turned = await snaptrude.design.create.furniture(
+     *   "6620f1a…",
+     *   await snaptrude.core.math.vec3.new(3, 0, 5),
+     *   undefined,
+     *   90,
+     * )
      * ```
      */
     abstract furniture(catalogId: string, position: Vec3Handle, options?: {
         label?: string;
         createNewSourceMesh?: boolean;
-    }): PluginApiReturn<ComponentHandle>;
+    }, angleInDegrees?: number): PluginApiReturn<ComponentHandle>;
     /**
      * Place a **door** from the catalog into a host wall.
      *
@@ -375,6 +480,11 @@ export declare abstract class PluginDesignCreateApi {
      * @param hostWall - The wall to host the door
      * @param position - World point projected onto the wall to locate the opening
      * @param options - Optional placement options: `label` — instance name
+     * @param facing - World point selecting which side of the wall the door faces
+     *   (the room it opens into) — the same convention as approaching the wall
+     *   from that side with the cursor in the interactive tool. Any point clearly
+     *   on that side works (e.g. the room's center). Default: the engine picks a
+     *   side (nondeterministic when `position` sits on the wall centerline).
      * @returns the {@linkcode ComponentHandle} of the placed door
      * @throws if the catalog id is unknown, the host is not a wall, the source
      *   mesh fails to load, or the projected point falls **outside** the host wall
@@ -384,6 +494,7 @@ export declare abstract class PluginDesignCreateApi {
      * @examplePrompt Put a door from the catalog at this point on the wall
      * @examplePrompt Insert the entrance door into this wall
      * @examplePrompt Add a door to the wall and call it Entry-01
+     * @examplePrompt Add a door that opens into the living room
      *
      * # Example
      * ```ts
@@ -395,11 +506,19 @@ export declare abstract class PluginDesignCreateApi {
      *   await snaptrude.core.math.vec3.new(3, 0, 5),
      *   { label: "Entry-01" },
      * )
+     * // …facing a specific side of the wall (pass a point inside that room):
+     * const intoKitchen = await snaptrude.design.create.door(
+     *   entry.id,
+     *   wall,
+     *   await snaptrude.core.math.vec3.new(3, 0, 5),
+     *   undefined,
+     *   await snaptrude.core.math.vec3.new(3, 0, 9),
+     * )
      * ```
      */
     abstract door(catalogId: string, hostWall: ComponentHandle, position: Vec3Handle, options?: {
         label?: string;
-    }): PluginApiReturn<ComponentHandle>;
+    }, facing?: Vec3Handle): PluginApiReturn<ComponentHandle>;
     /**
      * Place a **window** from the catalog into a host wall.
      *
@@ -414,6 +533,10 @@ export declare abstract class PluginDesignCreateApi {
      * @param hostWall - The wall to host the window
      * @param position - World point projected onto the wall to locate the opening
      * @param options - Optional placement options: `label` — instance name
+     * @param facing - World point selecting which side of the wall the window
+     *   faces (matters for asymmetric windows, e.g. casement swing) — same
+     *   convention as {@linkcode PluginDesignCreateApi.door}. Default: the engine
+     *   picks a side (nondeterministic when `position` sits on the centerline).
      * @returns the {@linkcode ComponentHandle} of the placed window
      * @throws if the catalog id is unknown, the host is not a wall, the source
      *   mesh fails to load, or the projected point falls **outside** the host wall
@@ -423,6 +546,7 @@ export declare abstract class PluginDesignCreateApi {
      * @examplePrompt Put a window from the catalog at this point on the wall
      * @examplePrompt Insert a window into the living room wall
      * @examplePrompt Add a window to the wall and name it Win-01
+     * @examplePrompt Add a casement window opening toward the garden side
      *
      * # Example
      * ```ts
@@ -438,7 +562,7 @@ export declare abstract class PluginDesignCreateApi {
      */
     abstract window(catalogId: string, hostWall: ComponentHandle, position: Vec3Handle, options?: {
         label?: string;
-    }): PluginApiReturn<ComponentHandle>;
+    }, facing?: Vec3Handle): PluginApiReturn<ComponentHandle>;
     /**
      * Place a **smart layout** — clone an in-scene template cluster (walls,
      * furniture, doors, windows, floors) into one or more target ROOM/DEPARTMENT
@@ -512,6 +636,11 @@ export declare abstract class PluginDesignCreateApi {
      * @examplePrompt Array these walls with a 3m offset
      * @examplePrompt Clone the desk as a unique copy, not an instance
      *
+     * @performance To place N repeats of the same geometry, bulk-create the seed(s) once then
+     *   call this ONCE with `{ count: N - 1 }` — one host round-trip for all copies. Never
+     *   reproduce geometry by looping `design.create.*` N times. Copy only after the create
+     *   that mints the seed ids.
+     *
      * # Example
      * ```ts
      * const { vec3 } = snaptrude.core.math
@@ -527,15 +656,24 @@ export declare abstract class PluginDesignCreateApi {
      * Migrated from the removed `entity.space.bulkCreate`. Each item extrudes a contour
      * footprint up `height`. Validate-all-or-throw; one command. For a rectangular
      * (box) space, build the footprint with `core.geom.create.profileRect` →
-     * `contourFromProfile`, then pass it as an item.
+     * `contourFromProfile`, then pass it as an item. Each item may carry its own
+     * `storey` (see {@linkcode PluginCreateSpaceItem}) so a single call can populate
+     * several floors at once.
      *
      * @param items - One {@linkcode PluginCreateSpaceItem} per space to create (≥1)
      * @returns the created spaces as {@linkcode ComponentHandle}`[]`, in input order
+     * @throws if any item's contour is invalid, its height is not positive, or its
+     *   target `storey` does not exist (all-or-nothing — nothing is created)
      *
      * @examplePrompt Create several rooms at once from these footprints
      * @examplePrompt Generate all the bedrooms in one operation
      * @examplePrompt Bulk create the spaces for this floor plan
      * @examplePrompt Add three rooms with different heights in a single undo step
+     * @examplePrompt Create one room on the ground floor and one on the first floor
+     *
+     * @performance Bulk creator — the whole batch is ONE host round-trip. Always prefer this
+     *   over calling `design.create.space` in a loop: build the full `items[]` array first
+     *   (all per-item math and geometry up front), then make one call.
      *
      * # Example
      * ```ts
@@ -548,6 +686,49 @@ export declare abstract class PluginDesignCreateApi {
      * ```
      */
     abstract spaces(items: PluginCreateSpaceItem[]): PluginApiReturn<ComponentHandle[]>;
+    /**
+     * Create a new parametric buildable envelope — the zoning-regulated volume a
+     * building may occupy — generated from a site polygon, tiered setbacks, a
+     * height or floor-count cap, and optional FAR and lot-coverage limits. The host
+     * mints the envelope id and returns it. Canonical home of the create formerly
+     * at `entity.buildableEnvelope.create` (now deprecated).
+     *
+     * @param sitePolygon - Site polygon vertices in `lengthUnit`; minimum 3 vertices.
+     * @param lengthUnit - Unit used by all length fields (`"ft" | "m"`).
+     * @param setbacks - Setback profile, ground tier first; minimum 1 tier.
+     * @param verticalCap - Maximum height or floor count.
+     * @param floorToFloor - Required floor-to-floor height in `lengthUnit`.
+     * @param farRatio - Optional FAR value, positive when provided.
+     * @param lotCoverageMaxPct - Optional lot coverage cap, `0..100`.
+     * @returns A {@linkcode PluginBuildableEnvelopeCreateResult} with the
+     *   `buildableEnvelopeId` of the created envelope.
+     * @throws If validation fails or generation produces no renderable geometry.
+     *
+     * @examplePrompt Create a buildable envelope for my site
+     * @examplePrompt Generate the zoning envelope with 10ft front setbacks
+     * @examplePrompt Show the maximum buildable volume with a 150ft height limit
+     * @examplePrompt Create a zoning envelope capped at 12 floors with FAR 3
+     *
+     * # Example
+     * ```ts
+     * const { buildableEnvelopeId } = await snaptrude.design.create.buildableEnvelope(
+     *   [
+     *     { x: 0, z: 0 },
+     *     { x: 100, z: 0 },
+     *     { x: 100, z: 80 },
+     *     { x: 0, z: 80 },
+     *   ],
+     *   "ft",
+     *   [
+     *     { aboveHeight: 0, front: 10, side: 5, rear: 10 },
+     *     { aboveHeight: 100, front: 20, side: 10, rear: 20 },
+     *   ],
+     *   { kind: "max_height", maxHeight: 150 },
+     *   12,
+     * )
+     * ```
+     */
+    abstract buildableEnvelope(sitePolygon: PluginBuildableEnvelopePolygonVertex[], lengthUnit: "ft" | "m", setbacks: PluginBuildableEnvelopeSetbackTier[], verticalCap: PluginBuildableEnvelopeVerticalCap, floorToFloor: number, farRatio?: number, lotCoverageMaxPct?: number): PluginApiReturn<PluginBuildableEnvelopeCreateResult>;
 }
 /**
  * Line style of a reference line (mirrors the engine `ReferenceLineMode` verbatim).
@@ -617,12 +798,13 @@ export type PluginStaircasePreset = z.infer<typeof PluginStaircasePreset>;
  * | `spaceType` | {@linkcode PluginSpaceType}? | Space-type classification (default `Room`) |
  * | `massType` | {@linkcode PluginMassType}? | Mass-type classification (default `Room`) |
  * | `departmentId` | {@linkcode PluginDepartmentId}? | Department assignment (default department) |
+ * | `storey` | `number`? (int) | Target storey number (default active storey) |
  */
 export declare const PluginDesignCreateSpaceArgs: z.ZodObject<{
-    contour: z.ZodPipe<z.ZodString, z.ZodTransform<import("../../..").Handle<"contour">, string>>;
+    contour: z.ZodPipe<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>, z.ZodTransform<import("../../..").Handle<"contour">, string>>;
     height: z.ZodNumber;
     label: z.ZodOptional<z.ZodString>;
-    position: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<import("../../..").Handle<"vec3">, string>>>;
+    position: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>, z.ZodTransform<import("../../..").Handle<"vec3">, string>>>;
     spaceType: z.ZodOptional<z.ZodEnum<{
         Room: "Room";
         "Program Block": "Program Block";
@@ -655,6 +837,7 @@ export declare const PluginDesignCreateSpaceArgs: z.ZodObject<{
         ENVELOPE: "ENVELOPE";
         CORE: "CORE";
     }>, z.ZodUUID]>>;
+    storey: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
 export type PluginDesignCreateSpaceArgs = z.infer<typeof PluginDesignCreateSpaceArgs>;
 /**
@@ -669,10 +852,10 @@ export type PluginDesignCreateSpaceArgs = z.infer<typeof PluginDesignCreateSpace
  * | `massType` | {@linkcode PluginMassType}? | Mass type (default `Generic mass`) |
  */
 export declare const PluginDesignCreateMassArgs: z.ZodObject<{
-    contour: z.ZodPipe<z.ZodString, z.ZodTransform<import("../../..").Handle<"contour">, string>>;
+    contour: z.ZodPipe<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>, z.ZodTransform<import("../../..").Handle<"contour">, string>>;
     height: z.ZodNumber;
     label: z.ZodOptional<z.ZodString>;
-    position: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<import("../../..").Handle<"vec3">, string>>>;
+    position: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>, z.ZodTransform<import("../../..").Handle<"vec3">, string>>>;
     massType: z.ZodOptional<z.ZodEnum<{
         Room: "Room";
         Plinth: "Plinth";
@@ -689,6 +872,19 @@ export declare const PluginDesignCreateMassArgs: z.ZodObject<{
     }>>;
 }, z.core.$strip>;
 export type PluginDesignCreateMassArgs = z.infer<typeof PluginDesignCreateMassArgs>;
+/**
+ * Arguments for {@linkcode PluginDesignCreateApi.massFromBrep}.
+ *
+ * | Property | Type | Description |
+ * |---|---|---|
+ * | `brep` | {@linkcode BrepHandle} | A solid from a `core.geom.create` brep constructor |
+ * | `label` | `string`? | Label (maps to `room_type`) |
+ */
+export declare const PluginDesignCreateMassFromBrepArgs: z.ZodObject<{
+    brep: z.ZodPipe<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>, z.ZodTransform<import("../../..").Handle<"brep">, string>>;
+    label: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type PluginDesignCreateMassFromBrepArgs = z.infer<typeof PluginDesignCreateMassFromBrepArgs>;
 /**
  * Arguments for {@linkcode PluginDesignCreateApi.slab}.
  *
@@ -700,7 +896,7 @@ export type PluginDesignCreateMassArgs = z.infer<typeof PluginDesignCreateMassAr
  * | `slabType` | {@linkcode PluginSlabType}? | Slab-type classification |
  */
 export declare const PluginDesignCreateSlabArgs: z.ZodObject<{
-    contour: z.ZodPipe<z.ZodString, z.ZodTransform<import("../../..").Handle<"contour">, string>>;
+    contour: z.ZodPipe<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>, z.ZodTransform<import("../../..").Handle<"contour">, string>>;
     thickness: z.ZodNumber;
     direction: z.ZodOptional<z.ZodEnum<{
         up: "up";
@@ -724,9 +920,9 @@ export type PluginDesignCreateSlabArgs = z.infer<typeof PluginDesignCreateSlabAr
  * | `position` | {@linkcode Vec3Handle}? | Offset from origin |
  */
 export declare const PluginDesignCreateFloorArgs: z.ZodObject<{
-    contour: z.ZodPipe<z.ZodString, z.ZodTransform<import("../../..").Handle<"contour">, string>>;
+    contour: z.ZodPipe<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>, z.ZodTransform<import("../../..").Handle<"contour">, string>>;
     thickness: z.ZodNumber;
-    position: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<import("../../..").Handle<"vec3">, string>>>;
+    position: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>, z.ZodTransform<import("../../..").Handle<"vec3">, string>>>;
 }, z.core.$strip>;
 export type PluginDesignCreateFloorArgs = z.infer<typeof PluginDesignCreateFloorArgs>;
 /**
@@ -738,7 +934,7 @@ export type PluginDesignCreateFloorArgs = z.infer<typeof PluginDesignCreateFloor
  * | `thickness` | `number` | Roof-slab thickness (> 0) |
  */
 export declare const PluginDesignCreateRoofArgs: z.ZodObject<{
-    contour: z.ZodPipe<z.ZodString, z.ZodTransform<import("../../..").Handle<"contour">, string>>;
+    contour: z.ZodPipe<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>, z.ZodTransform<import("../../..").Handle<"contour">, string>>;
     thickness: z.ZodNumber;
 }, z.core.$strip>;
 export type PluginDesignCreateRoofArgs = z.infer<typeof PluginDesignCreateRoofArgs>;
@@ -752,7 +948,7 @@ export type PluginDesignCreateRoofArgs = z.infer<typeof PluginDesignCreateRoofAr
  * | `heightFromFloor` | `number`? | Lift above the floor (default 0) |
  */
 export declare const PluginDesignCreateCeilingArgs: z.ZodObject<{
-    contour: z.ZodPipe<z.ZodString, z.ZodTransform<import("../../..").Handle<"contour">, string>>;
+    contour: z.ZodPipe<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>, z.ZodTransform<import("../../..").Handle<"contour">, string>>;
     thickness: z.ZodNumber;
     heightFromFloor: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
@@ -768,10 +964,10 @@ export type PluginDesignCreateCeilingArgs = z.infer<typeof PluginDesignCreateCei
  * | `directionUp` | {@linkcode Vec3Handle}? | Up axis (default world up) |
  */
 export declare const PluginDesignCreateColumnArgs: z.ZodObject<{
-    position: z.ZodPipe<z.ZodString, z.ZodTransform<import("../../..").Handle<"vec3">, string>>;
-    crossSection: z.ZodPipe<z.ZodString, z.ZodTransform<import("../../..").Handle<"contour">, string>>;
+    position: z.ZodPipe<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>, z.ZodTransform<import("../../..").Handle<"vec3">, string>>;
+    crossSection: z.ZodPipe<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>, z.ZodTransform<import("../../..").Handle<"contour">, string>>;
     height: z.ZodNumber;
-    directionUp: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<import("../../..").Handle<"vec3">, string>>>;
+    directionUp: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>, z.ZodTransform<import("../../..").Handle<"vec3">, string>>>;
 }, z.core.$strip>;
 export type PluginDesignCreateColumnArgs = z.infer<typeof PluginDesignCreateColumnArgs>;
 /**
@@ -784,9 +980,9 @@ export type PluginDesignCreateColumnArgs = z.infer<typeof PluginDesignCreateColu
  * | `direction` | {@linkcode Vec3Handle}? | Extrusion axis (default world up) |
  */
 export declare const PluginDesignCreateBeamArgs: z.ZodObject<{
-    section: z.ZodPipe<z.ZodString, z.ZodTransform<import("../../..").Handle<"contour">, string>>;
+    section: z.ZodPipe<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>, z.ZodTransform<import("../../..").Handle<"contour">, string>>;
     length: z.ZodNumber;
-    direction: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<import("../../..").Handle<"vec3">, string>>>;
+    direction: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>, z.ZodTransform<import("../../..").Handle<"vec3">, string>>>;
 }, z.core.$strip>;
 export type PluginDesignCreateBeamArgs = z.infer<typeof PluginDesignCreateBeamArgs>;
 /**
@@ -796,12 +992,14 @@ export type PluginDesignCreateBeamArgs = z.infer<typeof PluginDesignCreateBeamAr
  * |---|---|---|
  * | `profile` | {@linkcode ProfileHandle} | Ordered curve chain (wall centerlines) |
  * | `height` | `number`? | Wall height (default engine default) |
- * | `thickness` | `number`? | Wall thickness (default engine default) |
+ * | `thickness` | `number`? | Wall thickness (default: `wallType`'s total layer thickness when given, else engine default) |
+ * | `wallType` | `string`? | Wall type name from `design.types.list("wall")` — layers/material/thickness defaults (default generic) |
  */
 export declare const PluginDesignCreateWallsArgs: z.ZodObject<{
-    profile: z.ZodPipe<z.ZodString, z.ZodTransform<import("../../..").Handle<"profile">, string>>;
+    profile: z.ZodPipe<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>, z.ZodTransform<import("../../..").Handle<"profile">, string>>;
     height: z.ZodOptional<z.ZodNumber>;
     thickness: z.ZodOptional<z.ZodNumber>;
+    wallType: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export type PluginDesignCreateWallsArgs = z.infer<typeof PluginDesignCreateWallsArgs>;
 /**
@@ -834,7 +1032,7 @@ export declare const PluginDesignCreateStaircaseArgs: z.ZodObject<{
         mezzanineFloorDogLegged: "mezzanineFloorDogLegged";
         mezzanineFloorLShaped: "mezzanineFloorLShaped";
     }>;
-    position: z.ZodPipe<z.ZodString, z.ZodTransform<import("../../..").Handle<"vec3">, string>>;
+    position: z.ZodPipe<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>, z.ZodTransform<import("../../..").Handle<"vec3">, string>>;
     label: z.ZodOptional<z.ZodString>;
     structureId: z.ZodOptional<z.ZodString>;
     level: z.ZodOptional<z.ZodString>;
@@ -849,12 +1047,14 @@ export type PluginDesignCreateStaircaseArgs = z.infer<typeof PluginDesignCreateS
  * | `position` | {@linkcode Vec3Handle} | Absolute world placement point |
  * | `label` | `string`? | Instance name (default auto `${name}Ins${n}`) |
  * | `createNewSourceMesh` | `boolean`? | Emit a source-mesh creation command (default `true`) |
+ * | `angleInDegrees` | `number`? | Rotation about the vertical axis, in degrees (default unrotated) |
  */
 export declare const PluginDesignCreateFurnitureArgs: z.ZodObject<{
     catalogId: z.ZodString;
-    position: z.ZodPipe<z.ZodString, z.ZodTransform<import("../../..").Handle<"vec3">, string>>;
+    position: z.ZodPipe<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>, z.ZodTransform<import("../../..").Handle<"vec3">, string>>;
     label: z.ZodOptional<z.ZodString>;
     createNewSourceMesh: z.ZodOptional<z.ZodBoolean>;
+    angleInDegrees: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
 export type PluginDesignCreateFurnitureArgs = z.infer<typeof PluginDesignCreateFurnitureArgs>;
 /**
@@ -866,12 +1066,14 @@ export type PluginDesignCreateFurnitureArgs = z.infer<typeof PluginDesignCreateF
  * | `hostWall` | {@linkcode ComponentHandle} | The wall to host the door |
  * | `position` | {@linkcode Vec3Handle} | World point projected onto the wall |
  * | `label` | `string`? | Instance name (optional) |
+ * | `facing` | {@linkcode Vec3Handle}? | World point on the side of the wall the door faces (default engine-chosen) |
  */
 export declare const PluginDesignCreateDoorArgs: z.ZodObject<{
     catalogId: z.ZodString;
     hostWall: z.ZodPipe<z.ZodString, z.ZodTransform<ComponentHandle, string>>;
-    position: z.ZodPipe<z.ZodString, z.ZodTransform<import("../../..").Handle<"vec3">, string>>;
+    position: z.ZodPipe<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>, z.ZodTransform<import("../../..").Handle<"vec3">, string>>;
     label: z.ZodOptional<z.ZodString>;
+    facing: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>, z.ZodTransform<import("../../..").Handle<"vec3">, string>>>;
 }, z.core.$strip>;
 export type PluginDesignCreateDoorArgs = z.infer<typeof PluginDesignCreateDoorArgs>;
 /**
@@ -883,12 +1085,14 @@ export type PluginDesignCreateDoorArgs = z.infer<typeof PluginDesignCreateDoorAr
  * | `hostWall` | {@linkcode ComponentHandle} | The wall to host the window |
  * | `position` | {@linkcode Vec3Handle} | World point projected onto the wall |
  * | `label` | `string`? | Instance name (optional) |
+ * | `facing` | {@linkcode Vec3Handle}? | World point on the side of the wall the window faces (default engine-chosen) |
  */
 export declare const PluginDesignCreateWindowArgs: z.ZodObject<{
     catalogId: z.ZodString;
     hostWall: z.ZodPipe<z.ZodString, z.ZodTransform<ComponentHandle, string>>;
-    position: z.ZodPipe<z.ZodString, z.ZodTransform<import("../../..").Handle<"vec3">, string>>;
+    position: z.ZodPipe<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>, z.ZodTransform<import("../../..").Handle<"vec3">, string>>;
     label: z.ZodOptional<z.ZodString>;
+    facing: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>, z.ZodTransform<import("../../..").Handle<"vec3">, string>>>;
 }, z.core.$strip>;
 export type PluginDesignCreateWindowArgs = z.infer<typeof PluginDesignCreateWindowArgs>;
 /**
@@ -946,7 +1150,7 @@ export type PluginSmartLayoutResult = z.infer<typeof PluginSmartLayoutResult>;
  * | `gridTag` | `string`? | Grid tag label (default `"A"`) |
  */
 export declare const PluginDesignCreateReferenceLinesArgs: z.ZodObject<{
-    profile: z.ZodPipe<z.ZodString, z.ZodTransform<import("../../..").Handle<"profile">, string>>;
+    profile: z.ZodPipe<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>, z.ZodTransform<import("../../..").Handle<"profile">, string>>;
     color: z.ZodOptional<z.ZodString>;
     thickness: z.ZodOptional<z.ZodNumber>;
     style: z.ZodOptional<z.ZodEnum<{
@@ -966,8 +1170,8 @@ export type PluginDesignCreateReferenceLinesArgs = z.infer<typeof PluginDesignCr
  * | `"unique"` | Independent geometry copies |
  */
 export declare const PluginCopyMode: z.ZodEnum<{
-    instance: "instance";
     unique: "unique";
+    instance: "instance";
 }>;
 export type PluginCopyMode = z.infer<typeof PluginCopyMode>;
 /**
@@ -982,11 +1186,11 @@ export type PluginCopyMode = z.infer<typeof PluginCopyMode>;
  */
 export declare const PluginDesignCreateCopyArgs: z.ZodObject<{
     components: z.ZodArray<z.ZodPipe<z.ZodString, z.ZodTransform<ComponentHandle, string>>>;
-    displacement: z.ZodPipe<z.ZodString, z.ZodTransform<import("../../..").Handle<"vec3">, string>>;
+    displacement: z.ZodPipe<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>, z.ZodTransform<import("../../..").Handle<"vec3">, string>>;
     count: z.ZodOptional<z.ZodNumber>;
     mode: z.ZodOptional<z.ZodEnum<{
-        instance: "instance";
         unique: "unique";
+        instance: "instance";
     }>>;
 }, z.core.$strip>;
 export type PluginDesignCreateCopyArgs = z.infer<typeof PluginDesignCreateCopyArgs>;
@@ -1003,12 +1207,13 @@ export type PluginDesignCreateCopyArgs = z.infer<typeof PluginDesignCreateCopyAr
  * | `spaceType` | `PluginSpaceType`? | Space type |
  * | `massType` | `PluginMassType`? | Mass type |
  * | `departmentId` | `PluginDepartmentId`? | Department |
+ * | `storey` | `number`? (int) | Target storey number (default active storey) |
  */
 export declare const PluginCreateSpaceItem: z.ZodObject<{
-    contour: z.ZodPipe<z.ZodString, z.ZodTransform<import("../../..").Handle<"contour">, string>>;
+    contour: z.ZodPipe<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>, z.ZodTransform<import("../../..").Handle<"contour">, string>>;
     height: z.ZodNumber;
     label: z.ZodOptional<z.ZodString>;
-    position: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<import("../../..").Handle<"vec3">, string>>>;
+    position: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>, z.ZodTransform<import("../../..").Handle<"vec3">, string>>>;
     spaceType: z.ZodOptional<z.ZodEnum<{
         Room: "Room";
         "Program Block": "Program Block";
@@ -1041,6 +1246,7 @@ export declare const PluginCreateSpaceItem: z.ZodObject<{
         ENVELOPE: "ENVELOPE";
         CORE: "CORE";
     }>, z.ZodUUID]>>;
+    storey: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
 export type PluginCreateSpaceItem = z.infer<typeof PluginCreateSpaceItem>;
 //# sourceMappingURL=index.d.ts.map