@snaptrude/plugin-core 0.0.0-dev-20260911064951 → 0.0.0-surfaces-20260921090636

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

@@ -3,13 +3,11 @@ import { PluginApiReturn } from "../../../types";
 import { BrepHandle, ComponentHandle, ContourHandle, ProfileHandle, Vec3Handle } from "../../../handles";
 import { PluginSpaceType, PluginMassType, PluginDepartmentId } from "../../entity/space";
 import { PluginBuildableEnvelopePolygonVertex, PluginBuildableEnvelopeSetbackTier, PluginBuildableEnvelopeVerticalCap, PluginBuildableEnvelopeCreateResult } from "../../entity/buildableEnvelope";
-import type { PluginCreateDoorItem, PluginCreateFloorItem, PluginCreateFurnitureItem, PluginCreateWallRunItem, PluginCreateWindowItem } from "./bulk-items";
 /**
  * `design.create.*` — author new scene-committed BIM entities.
  *
  * Every creator takes geometry handles + scalars and returns a
- * {@linkcode ComponentHandle} (or `ComponentHandle[]` for plural creators;
- * `wallRuns` returns one `ComponentHandle[]` per run) — the
+ * {@linkcode ComponentHandle} (or `ComponentHandle[]` for plural creators) — the
  * `Component.id` of the created entity, resolvable across the rest of the
  * `design.*` surface. Creation is an undoable host call; it **throws** on failure
  * (no `Result` wrapper — consistent with `core.geom.create.*`).
@@ -192,49 +190,8 @@ export declare abstract class PluginDesignCreateApi {
      * const contour = await snaptrude.core.geom.create.contourFromProfile(rect)
      * const floor = await snaptrude.design.create.floor(contour, 0.1)
      * ```
-     *
-     * @performance For MORE THAN ONE floor, call `design.create.floors(items[])` — one
-     *   host round-trip and ONE undo entry for the whole batch. Looping this single-floor
-     *   creator is N round-trips and N undo entries.
      */
     abstract floor(contour: ContourHandle, thickness: number, position?: Vec3Handle): PluginApiReturn<ComponentHandle>;
-    /**
-     * Create **many floors** in one undoable operation (bulk plural of
-     * {@linkcode floor}). Each item extrudes its own footprint contour (outer
-     * profile + holes) upward by its own `thickness`, at its own optional
-     * position offset. Validate-all-or-throw; one command.
-     *
-     * @param items - One {@linkcode PluginCreateFloorItem} per floor to create
-     *   (≥1, ≤1000)
-     * @returns the created floors as {@linkcode ComponentHandle}`[]`, in input order
-     * @throws `VALIDATION` if the items fail the schema (empty array, more than
-     *   1000 items, a non-positive thickness) or a contour is degenerate;
-     *   `HANDLE_INVALID` if a `contour` or `position` handle is unknown or
-     *   released; `OPERATION_FAILED` if extrusion fails (nothing is created —
-     *   `details.itemIndex` is the failing item); `METHOD_NOT_PERMITTED` if the
-     *   plugin may not write.
-     *
-     * @examplePrompt Create floors for all these room outlines at once
-     * @examplePrompt Add a floor to every space in one operation
-     * @examplePrompt Bulk create the floor plates for this building
-     * @examplePrompt Lay 100mm floors across these five footprints in one undo step
-     * @examplePrompt Create the ground and first floor slabs together
-     *
-     * @performance Bulk creator — the whole batch is ONE host round-trip and ONE undo
-     *   entry. Always prefer this over calling `design.create.floor` in a loop: build the
-     *   full `items[]` array first (all contours and offsets up front), then make one call.
-     *
-     * # Example
-     * ```ts
-     * const rect = await snaptrude.core.geom.create.profileRect(5, 4)
-     * const contour = await snaptrude.core.geom.create.contourFromProfile(rect)
-     * const [ground, upper] = await snaptrude.design.create.floors([
-     *   { contour, thickness: 0.1 },
-     *   { contour, thickness: 0.1, position: await snaptrude.core.math.vec3.new(0, 3, 0) },
-     * ])
-     * ```
-     */
-    abstract floors(items: PluginCreateFloorItem[]): PluginApiReturn<ComponentHandle[]>;
     /**
      * Create a **roof** by extruding a footprint contour by `thickness`. Created
      * flat (extruded downward); pitch/slope is a separate post-creation edit.
@@ -396,63 +353,8 @@ export declare abstract class PluginDesignCreateApi {
      *   centerlines, 3, undefined, brick.label,
      * )
      * ```
-     *
-     * @performance For MORE THAN ONE run, call `design.create.wallRuns(items[])` — one
-     *   host round-trip and ONE undo entry for every run in the batch. Looping this
-     *   single-run creator is N round-trips and N undo entries.
      */
     abstract walls(profile: ProfileHandle, height?: number, thickness?: number, wallType?: string, storey?: number): PluginApiReturn<ComponentHandle[]>;
-    /**
-     * Create **many wall runs** in one undoable operation (bulk plural of
-     * {@linkcode walls}). Each item is one full run — a wall per curve in that
-     * item's profile chain, mitred at shared endpoints. Junctions resolve within a
-     * run, not between runs. Each item carries its own
-     * dimensions, `wallType` and `storey`, so a single call can build a whole
-     * floor plate or several storeys at once. Validate-all-or-throw; one command.
-     *
-     * @param items - One {@linkcode PluginCreateWallRunItem} per run to create
-     *   (≥1, ≤1000)
-     * @returns one {@linkcode ComponentHandle}`[]` per item, in input order —
-     *   each inner array holding that run's walls in profile-curve order
-     * @throws `VALIDATION` if the items fail the schema (empty array, more than
-     *   1000 items, a non-positive height or thickness, a zero-length curve);
-     *   `HANDLE_INVALID` if a `profile` handle is unknown or released;
-     *   `PRECONDITION_FAILED` if a profile has no curves, `wallType` names no
-     *   wall type in the project, or `storey` does not exist;
-     *   `OPERATION_FAILED` if wall creation fails (nothing is created —
-     *   `details.itemIndex` is the failing item); `METHOD_NOT_PERMITTED` if the
-     *   plugin may not write.
-     *
-     * @examplePrompt Draw all the walls of this floor plan at once
-     * @examplePrompt Build every room's perimeter in one operation
-     * @examplePrompt Bulk create wall runs from these centerlines
-     * @examplePrompt Create the walls for both storeys in a single undo step
-     * @examplePrompt Turn these polylines into 200mm brick walls together
-     *
-     * @performance Bulk creator — the whole batch is ONE host round-trip and ONE undo
-     *   entry. Always prefer this over calling `design.create.walls` in a loop: build the
-     *   full `items[]` array first (all profiles up front), then make one call.
-     *
-     * # Example
-     * ```ts
-     * const v = snaptrude.core.math.vec3
-     * const ground = await snaptrude.core.geom.create.profileFromLinePoints([
-     *   await v.new(0, 0, 0),
-     *   await v.new(8, 0, 0),
-     *   await v.new(8, 0, 6),
-     * ])
-     * const upper = await snaptrude.core.geom.create.profileFromLinePoints([
-     *   await v.new(0, 0, 0),
-     *   await v.new(8, 0, 0),
-     * ])
-     * const [groundWalls, upperWalls] = await snaptrude.design.create.wallRuns([
-     *   { profile: ground, height: 3, thickness: 0.2 },
-     *   { profile: upper, height: 3, storey: 2 },
-     * ])
-     * console.log(groundWalls.length, "walls on the ground floor")
-     * ```
-     */
-    abstract wallRuns(items: PluginCreateWallRunItem[]): PluginApiReturn<ComponentHandle[][]>;
     /**
      * Create a **staircase** from a parametric preset, placed at a point.
      *
@@ -542,19 +444,15 @@ export declare abstract class PluginDesignCreateApi {
      *   `position.y` (the same surface-flush contract as interactive drag-drop) —
      *   pass the floor/storey elevation to stand furniture on it; never add half
      *   the item's height yourself.
-     * @param options - Optional placement options: `label` — instance name and
-     *   readable label (`design.query.getLabel`; default auto `${name}Ins${n}`);
-     *   `createNewSourceMesh` — legacy flag, kept for compatibility. The host owns
-     *   source-mesh persistence: a catalog source is recorded exactly once, by the
-     *   first placement that brings it in, and this flag cannot skip that record.
+     * @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;
-     *   `PRECONDITION_FAILED` (`details.engineCode: "TOOL_ACTIVE"`) while the interactive
-     *   furniture tool is active — finish or cancel it first
+     * @throws if the catalog id is unknown, the source mesh fails to load, or placement fails
      *
      * @examplePrompt Place a chair from the library at this spot
      * @examplePrompt Add a sofa from the furniture catalog to the living room
@@ -578,58 +476,11 @@ export declare abstract class PluginDesignCreateApi {
      *   90,
      * )
      * ```
-     *
-     * @performance For MORE THAN ONE item, call `design.create.furnitureItems(items[])` —
-     *   one host round-trip and ONE undo entry, and a catalog source shared by several
-     *   items is fetched once. Looping this single-item creator is N round-trips.
      */
     abstract furniture(catalogId: string, position: Vec3Handle, options?: {
         label?: string;
         createNewSourceMesh?: boolean;
     }, angleInDegrees?: number): PluginApiReturn<ComponentHandle>;
-    /**
-     * Place **many furniture items** in one undoable operation (bulk plural of
-     * {@linkcode furniture}). Each item names a catalog id and an absolute world
-     * position (`position.y` is the REST elevation — the same grounding contract
-     * as the singular creator), with optional label and rotation. A catalog
-     * source shared by several items is fetched and recorded once for the whole
-     * batch, so the host — not the caller — owns source persistence (there is no
-     * per-item `createNewSourceMesh`). Validate-all-or-throw; one command.
-     *
-     * @param items - One {@linkcode PluginCreateFurnitureItem} per instance to
-     *   place (≥1, ≤1000)
-     * @returns the placed instances as {@linkcode ComponentHandle}`[]`, in input order
-     * @throws `VALIDATION` if the items fail the schema (empty array, more than
-     *   1000 items); `HANDLE_INVALID` if a `position` handle is unknown or
-     *   released; `PRECONDITION_FAILED` if a catalog id is unknown, a furniture
-     *   tool is active, or a parametric group is active (exit it first, or place
-     *   items one at a time with `furniture`); `OPERATION_FAILED` if a source
-     *   mesh fails to load or placement fails (nothing is created —
-     *   `details.itemIndex` is the failing item); `METHOD_NOT_PERMITTED` if the plugin may not write.
-     *
-     * @examplePrompt Place all the desks for this office at once
-     * @examplePrompt Furnish every bedroom in one operation
-     * @examplePrompt Bulk place these chairs around the table
-     * @examplePrompt Add the whole furniture layout in a single undo step
-     * @examplePrompt Drop twenty copies of this chair at these positions
-     *
-     * @performance Bulk creator — the whole batch is ONE host round-trip and ONE undo
-     *   entry, and each distinct catalog source loads once. Always prefer this over
-     *   calling `design.create.furniture` in a loop: build the full `items[]` array
-     *   first (all positions and angles up front), then make one call.
-     *
-     * # Example
-     * ```ts
-     * const v = snaptrude.core.math.vec3
-     * const [chair] = await snaptrude.design.furniture.listCatalog()
-     * const placed = await snaptrude.design.create.furnitureItems([
-     *   { catalogId: chair.id, position: await v.new(3, 0, 5), label: "Chair-01" },
-     *   { catalogId: chair.id, position: await v.new(4, 0, 5), angleInDegrees: 90 },
-     *   { catalogId: chair.id, position: await v.new(5, 0, 5), angleInDegrees: 180 },
-     * ])
-     * ```
-     */
-    abstract furnitureItems(items: PluginCreateFurnitureItem[]): PluginApiReturn<ComponentHandle[]>;
     /**
      * Place a **door** from the catalog into a host wall.
      *
@@ -643,15 +494,12 @@ export declare abstract class PluginDesignCreateApi {
      * @param catalogId - Library id: team `_id` or general `fullName`
      * @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;
-     *   `hinge` — world point near the jamb the door is hinged on (the door is
-     *   reflected along the wall so its hinged jamb is the one nearer this
-     *   point; default the catalog item's authored hinge side)
-     * @param facing - World point on the side of the wall the door swings open
-     *   to (the room it opens into — where the plan symbol draws the swing arc).
-     *   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).
+     * @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
@@ -662,7 +510,6 @@ export declare abstract class PluginDesignCreateApi {
      * @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
-     * @examplePrompt Put a door here hinged on the north jamb
      *
      * # Example
      * ```ts
@@ -682,76 +529,11 @@ export declare abstract class PluginDesignCreateApi {
      *   undefined,
      *   await snaptrude.core.math.vec3.new(3, 0, 9),
      * )
-     * // …and hinged on the jamb nearest a point (here the +x end of the opening):
-     * const hingedRight = await snaptrude.design.create.door(
-     *   entry.id,
-     *   wall,
-     *   await snaptrude.core.math.vec3.new(3, 0, 5),
-     *   { hinge: await snaptrude.core.math.vec3.new(3.5, 0, 5) },
-     *   await snaptrude.core.math.vec3.new(3, 0, 9),
-     * )
      * ```
-     *
-     * @performance For MORE THAN ONE door, call `design.create.doors(items[])` — one host
-     *   round-trip and ONE undo entry, with each host wall re-cut once per opening inside
-     *   that single call. Looping this single-door creator is N round-trips.
      */
     abstract door(catalogId: string, hostWall: ComponentHandle, position: Vec3Handle, options?: {
         label?: string;
-        hinge?: Vec3Handle;
     }, facing?: Vec3Handle): PluginApiReturn<ComponentHandle>;
-    /**
-     * Place **many doors** into host walls in one undoable operation (bulk plural
-     * of {@linkcode door}). Each item carries its own catalog id, host wall,
-     * world position, and optional `facing`, `label`, `width` and `height` — the
-     * same fields as a `"door"` {@linkcode PluginDesignCreateOpeningOptions}.
-     * Validate-all-or-throw; one command.
-     *
-     * As with the singular creator, placing an opening **re-cuts its host wall**:
-     * the wall you passed as `hostWall` stops resolving once the call returns.
-     * Several items MAY name the same original wall handle in one call — the host
-     * chains the re-cuts internally — but after the call recover the surviving
-     * wall with `design.query.getHost(opening)`, never by reusing the handle you
-     * passed in.
-     *
-     * @param items - One {@linkcode PluginCreateDoorItem} per door to place
-     *   (≥1, ≤1000)
-     * @returns the placed doors as {@linkcode ComponentHandle}`[]`, in input order
-     * @throws `VALIDATION` if the items fail the schema (empty array, more than
-     *   1000 items, unknown fields, a non-positive `width`/`height`);
-     *   `HANDLE_INVALID` if a `position`, `facing` or `hinge` handle is unknown
-     *   or released; `PRECONDITION_FAILED` if a catalog id is unknown, a `hostWall`
-     *   is not a wall / is locked / is not in the active proposal, the projected
-     *   point falls outside its host wall, or a door tool is active;
-     *   `OPERATION_FAILED` if a source mesh fails to load or placement fails
-     *   (nothing is created — `details.itemIndex` is the failing item);
-     *   `METHOD_NOT_PERMITTED` if the plugin may not write.
-     *
-     * @examplePrompt Add doors to all of these walls at once
-     * @examplePrompt Place a door in every room in one operation
-     * @examplePrompt Bulk add the entrance doors from this schedule
-     * @examplePrompt Put three doors on this wall in a single undo step
-     * @examplePrompt Add all the doors for this floor plan together
-     *
-     * @performance Bulk creator — the whole batch is ONE host round-trip and ONE undo
-     *   entry, and each distinct catalog source loads once. Always prefer this over
-     *   calling `design.create.door` in a loop: build the full `items[]` array first
-     *   (all host walls and points up front), then make one call.
-     *
-     * # Example
-     * ```ts
-     * const v = snaptrude.core.math.vec3
-     * const [wall] = await snaptrude.design.query.listWalls({ isSelected: true })
-     * const [entry] = await snaptrude.design.doors.listCatalog()
-     * const [front, side] = await snaptrude.design.create.doors([
-     *   { catalogId: entry.id, hostWall: wall, position: await v.new(2, 0, 5), label: "D-01" },
-     *   { catalogId: entry.id, hostWall: wall, position: await v.new(6, 0, 5), width: 1.2 },
-     * ])
-     * // `wall` was re-cut twice and no longer resolves — ask the opening for its host:
-     * const currentWall = await snaptrude.design.query.getHost(front)
-     * ```
-     */
-    abstract doors(items: PluginCreateDoorItem[]): PluginApiReturn<ComponentHandle[]>;
     /**
      * Place a **window** from the catalog into a host wall.
      *
@@ -765,14 +547,11 @@ export declare abstract class PluginDesignCreateApi {
      * @param catalogId - Library id: team `_id` or general `fullName`
      * @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;
-     *   `hinge` — world point near the jamb the window is hinged on (same rule
-     *   as {@linkcode PluginDesignCreateApi.door}; default the catalog item's
-     *   authored side)
-     * @param facing - World point on the side of the wall the window opens to
-     *   (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).
+     * @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
@@ -795,68 +574,10 @@ export declare abstract class PluginDesignCreateApi {
      *   { label: "Win-01" },
      * )
      * ```
-     *
-     * @performance For MORE THAN ONE window, call `design.create.windows(items[])` — one
-     *   host round-trip and ONE undo entry, with each host wall re-cut once per opening
-     *   inside that single call. Looping this single-window creator is N round-trips.
      */
     abstract window(catalogId: string, hostWall: ComponentHandle, position: Vec3Handle, options?: {
         label?: string;
-        hinge?: Vec3Handle;
     }, facing?: Vec3Handle): PluginApiReturn<ComponentHandle>;
-    /**
-     * Place **many windows** into host walls in one undoable operation (bulk
-     * plural of {@linkcode window}). Each item carries its own catalog id, host
-     * wall, world position, and optional `facing`, `label`, `width`, `height` and
-     * `sillHeight` — the same fields as a `"window"`
-     * {@linkcode PluginDesignCreateOpeningOptions}. `sillHeight` is measured from
-     * the host wall base to the BOTTOM of the window. Validate-all-or-throw; one
-     * command.
-     *
-     * As with the singular creator, placing an opening **re-cuts its host wall**:
-     * the wall you passed as `hostWall` stops resolving once the call returns.
-     * Several items MAY name the same original wall handle in one call — the host
-     * chains the re-cuts internally — but after the call recover the surviving
-     * wall with `design.query.getHost(opening)`, never by reusing the handle you
-     * passed in.
-     *
-     * @param items - One {@linkcode PluginCreateWindowItem} per window to place
-     *   (≥1, ≤1000)
-     * @returns the placed windows as {@linkcode ComponentHandle}`[]`, in input order
-     * @throws `VALIDATION` if the items fail the schema (empty array, more than
-     *   1000 items, unknown fields, a non-positive `width`/`height`, a negative
-     *   `sillHeight`); `HANDLE_INVALID` if a `position`, `facing` or `hinge`
-     *   handle is unknown or released; `PRECONDITION_FAILED` if a catalog id is unknown, a
-     *   `hostWall` is not a wall / is locked / is not in the active proposal, the
-     *   projected point falls outside its host wall, or a window tool is active;
-     *   `OPERATION_FAILED` if a source mesh fails to load or placement fails
-     *   (nothing is created — `details.itemIndex` is the failing item);
-     *   `METHOD_NOT_PERMITTED` if the plugin may not write.
-     *
-     * @examplePrompt Add windows along this whole facade at once
-     * @examplePrompt Place a window in every bedroom in one operation
-     * @examplePrompt Bulk add the windows from this schedule
-     * @examplePrompt Put four windows on this wall in a single undo step
-     * @examplePrompt Add all the windows with a 0.9m sill height together
-     *
-     * @performance Bulk creator — the whole batch is ONE host round-trip and ONE undo
-     *   entry, and each distinct catalog source loads once. Always prefer this over
-     *   calling `design.create.window` in a loop: build the full `items[]` array first
-     *   (all host walls and points up front), then make one call.
-     *
-     * # Example
-     * ```ts
-     * const v = snaptrude.core.math.vec3
-     * const [wall] = await snaptrude.design.query.listWalls({ isSelected: true })
-     * const [casement] = await snaptrude.design.windows.listCatalog()
-     * const placed = await snaptrude.design.create.windows([
-     *   { catalogId: casement.id, hostWall: wall, position: await v.new(2, 0, 5), sillHeight: 0.9 },
-     *   { catalogId: casement.id, hostWall: wall, position: await v.new(5, 0, 5), sillHeight: 0.9 },
-     * ])
-     * const currentWall = await snaptrude.design.query.getHost(placed[0])
-     * ```
-     */
-    abstract windows(items: PluginCreateWindowItem[]): PluginApiReturn<ComponentHandle[]>;
     /**
      * Place a catalog **door or window** into a host wall with optional size overrides.
      *
@@ -866,7 +587,7 @@ export declare abstract class PluginDesignCreateApi {
      * its center. Placement is asynchronous and committed as one undoable creation.
      *
      * @param options - Opening kind, catalog and host references, placement, and
-     *   optional facing (swing side), hinge (hinged jamb), label, and dimensions
+     *   optional facing, label, and dimensions
      * @returns the {@linkcode ComponentHandle} of the placed door or window
      * @throws if the options are invalid, the catalog id is unknown, the host is
      *   not a wall, loading fails, or the opening cannot be placed on the host
@@ -874,9 +595,8 @@ export declare abstract class PluginDesignCreateApi {
      * @examplePrompt Add a 1m wide door to this wall here
      * @examplePrompt Place a window with a 0.9m sill height on the selected wall
      *
-     * @performance Single-opening creator — use it for one hosted opening. For MORE
-     *   THAN ONE, call `design.create.doors(items[])` / `design.create.windows(items[])`:
-     *   the same per-item fields, one host round-trip, ONE undo entry.
+     * @performance Single-opening creator — use it for one hosted opening. A plural
+     *   API is intentionally unavailable until host placement can be atomic.
      *
      * # Example
      * ```ts
@@ -1398,7 +1118,7 @@ export type PluginDesignCreateStaircaseArgs = z.infer<typeof PluginDesignCreateS
  * | `catalogId` | `string` | Library id: team `_id` or general `fullName` |
  * | `position` | {@linkcode Vec3Handle} | Absolute world placement point |
  * | `label` | `string`? | Instance name (default auto `${name}Ins${n}`) |
- * | `createNewSourceMesh` | `boolean`? | Legacy, kept for compatibility; the host records a catalog source exactly once and this flag cannot skip it |
+ * | `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<{
@@ -1418,8 +1138,7 @@ 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 swings open to (default engine-chosen) |
- * | `hinge` | {@linkcode Vec3Handle}? | World point near the jamb the door is hinged on (default the catalog item's authored side) |
+ * | `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;
@@ -1427,7 +1146,6 @@ export declare const PluginDesignCreateDoorArgs: z.ZodObject<{
     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>>>;
-    hinge: 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>;
 /**
@@ -1439,8 +1157,7 @@ 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 opens to (default engine-chosen) |
- * | `hinge` | {@linkcode Vec3Handle}? | World point near the jamb the window is hinged on (default the catalog item's authored side) |
+ * | `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;
@@ -1448,7 +1165,6 @@ export declare const PluginDesignCreateWindowArgs: z.ZodObject<{
     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>>>;
-    hinge: 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>;
 /**
@@ -1462,7 +1178,6 @@ export declare const PluginDesignCreateOpeningOptions: z.ZodDiscriminatedUnion<[
     hostWall: z.ZodPipe<z.ZodString, z.ZodTransform<ComponentHandle, string>>;
     position: z.ZodPipe<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>, z.ZodTransform<import("../../..").Handle<"vec3">, string>>;
     facing: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>, z.ZodTransform<import("../../..").Handle<"vec3">, string>>>;
-    hinge: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>, z.ZodTransform<import("../../..").Handle<"vec3">, string>>>;
     label: z.ZodOptional<z.ZodString>;
     width: z.ZodOptional<z.ZodNumber>;
     height: z.ZodOptional<z.ZodNumber>;
@@ -1473,7 +1188,6 @@ export declare const PluginDesignCreateOpeningOptions: z.ZodDiscriminatedUnion<[
     hostWall: z.ZodPipe<z.ZodString, z.ZodTransform<ComponentHandle, string>>;
     position: z.ZodPipe<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>, z.ZodTransform<import("../../..").Handle<"vec3">, string>>;
     facing: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>, z.ZodTransform<import("../../..").Handle<"vec3">, string>>>;
-    hinge: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>, z.ZodTransform<import("../../..").Handle<"vec3">, string>>>;
     label: z.ZodOptional<z.ZodString>;
     width: z.ZodOptional<z.ZodNumber>;
     height: z.ZodOptional<z.ZodNumber>;
@@ -1634,6 +1348,4 @@ export declare const PluginCreateSpaceItem: z.ZodObject<{
     storey: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
 export type PluginCreateSpaceItem = z.infer<typeof PluginCreateSpaceItem>;
-export * from "./opening-fields";
-export * from "./bulk-items";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/api/design/create/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/api/design/create/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAA;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAChD,OAAO,EACL,UAAU,EACV,eAAe,EACf,aAAa,EACb,aAAa,EACb,UAAU,EACX,MAAM,kBAAkB,CAAA;AACzB,OAAO,EACL,eAAe,EACf,cAAc,EACd,kBAAkB,EACnB,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EACL,oCAAoC,EACpC,kCAAkC,EAClC,kCAAkC,EAClC,mCAAmC,EACpC,MAAM,gCAAgC,CAAA;AAEvC;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,8BAAsB,qBAAqB;;IAGzC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAkDG;aACa,KAAK,CACnB,OAAO,EAAE,aAAa,EACtB,MAAM,EAAE,MAAM,EACd,KAAK,CAAC,EAAE,MAAM,EACd,QAAQ,CAAC,EAAE,UAAU,EACrB,SAAS,CAAC,EAAE,eAAe,EAC3B,QAAQ,CAAC,EAAE,cAAc,EACzB,YAAY,CAAC,EAAE,kBAAkB,EACjC,MAAM,CAAC,EAAE,MAAM,GACd,eAAe,CAAC,eAAe,CAAC;IAEnC;;;;;;;;;;;;;;;;;;;;;;;OAuBG;aACa,IAAI,CAClB,OAAO,EAAE,aAAa,EACtB,MAAM,EAAE,MAAM,EACd,KAAK,CAAC,EAAE,MAAM,EACd,QAAQ,CAAC,EAAE,UAAU,EACrB,QAAQ,CAAC,EAAE,cAAc,GACxB,eAAe,CAAC,eAAe,CAAC;IAEnC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAuCG;aACa,YAAY,CAC1B,IAAI,EAAE,UAAU,EAChB,KAAK,CAAC,EAAE,MAAM,GACb,eAAe,CAAC,eAAe,CAAC;IAEnC;;;;;;;;;;;;;;;;;;;;;;;OAuBG;aACa,IAAI,CAClB,OAAO,EAAE,aAAa,EACtB,SAAS,EAAE,MAAM,EACjB,SAAS,CAAC,EAAE,IAAI,GAAG,MAAM,EACzB,QAAQ,CAAC,EAAE,cAAc,GACxB,eAAe,CAAC,eAAe,CAAC;IAEnC;;;;;;;;;;;;;;;;;;;;;OAqBG;aACa,KAAK,CACnB,OAAO,EAAE,aAAa,EACtB,SAAS,EAAE,MAAM,EACjB,QAAQ,CAAC,EAAE,UAAU,GACpB,eAAe,CAAC,eAAe,CAAC;IAEnC;;;;;;;;;;;;;;;;;;;;OAoBG;aACa,IAAI,CAClB,OAAO,EAAE,aAAa,EACtB,SAAS,EAAE,MAAM,GAChB,eAAe,CAAC,eAAe,CAAC;IAEnC;;;;;;;;;;;;;;;;;;;;;OAqBG;aACa,OAAO,CACrB,OAAO,EAAE,aAAa,EACtB,SAAS,EAAE,MAAM,EACjB,eAAe,CAAC,EAAE,MAAM,GACvB,eAAe,CAAC,eAAe,CAAC;IAEnC;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;aACa,MAAM,CACpB,QAAQ,EAAE,UAAU,EACpB,YAAY,EAAE,aAAa,EAC3B,MAAM,EAAE,MAAM,EACd,WAAW,CAAC,EAAE,UAAU,GACvB,eAAe,CAAC,eAAe,CAAC;IAEnC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAuCG;aACa,IAAI,CAClB,OAAO,EAAE,aAAa,EACtB,MAAM,EAAE,MAAM,EACd,SAAS,CAAC,EAAE,UAAU,GACrB,eAAe,CAAC,eAAe,CAAC;IAEnC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA+CG;aACa,KAAK,CACnB,OAAO,EAAE,aAAa,EACtB,MAAM,CAAC,EAAE,MAAM,EACf,SAAS,CAAC,EAAE,MAAM,EAClB,QAAQ,CAAC,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,MAAM,GACd,eAAe,CAAC,eAAe,EAAE,CAAC;IAErC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAgCG;aACa,SAAS,CACvB,MAAM,EAAE,qBAAqB,EAC7B,QAAQ,EAAE,UAAU,EACpB,KAAK,CAAC,EAAE,MAAM,EACd,WAAW,CAAC,EAAE,MAAM,EACpB,KAAK,CAAC,EAAE,MAAM,EACd,UAAU,CAAC,EAAE,yBAAyB,GACrC,eAAe,CAAC,eAAe,CAAC;IAEnC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAmCG;aACa,cAAc,CAC5B,OAAO,EAAE,aAAa,EACtB,KAAK,CAAC,EAAE,MAAM,EACd,SAAS,CAAC,EAAE,MAAM,EAClB,KAAK,CAAC,EAAE,wBAAwB,EAChC,OAAO,CAAC,EAAE,MAAM,GACf,eAAe,CAAC,eAAe,EAAE,CAAC;IAErC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAkDG;aACa,SAAS,CACvB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,UAAU,EACpB,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,mBAAmB,CAAC,EAAE,OAAO,CAAA;KAAE,EAC3D,cAAc,CAAC,EAAE,MAAM,GACtB,eAAe,CAAC,eAAe,CAAC;IAEnC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAiDG;aACa,IAAI,CAClB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,eAAe,EACzB,QAAQ,EAAE,UAAU,EACpB,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,EAC5B,MAAM,CAAC,EAAE,UAAU,GAClB,eAAe,CAAC,eAAe,CAAC;IAEnC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAwCG;aACa,MAAM,CACpB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,eAAe,EACzB,QAAQ,EAAE,UAAU,EACpB,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,EAC5B,MAAM,CAAC,EAAE,UAAU,GAClB,eAAe,CAAC,eAAe,CAAC;IAEnC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAgCG;aACa,OAAO,CACrB,OAAO,EAAE,gCAAgC,GACxC,eAAe,CAAC,eAAe,CAAC;IAEnC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6CG;aACa,WAAW,CACzB,OAAO,EAAE,qBAAqB,GAC7B,eAAe,CAAC,uBAAuB,CAAC;IAE3C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAoCG;aACa,IAAI,CAClB,UAAU,EAAE,eAAe,EAAE,EAC7B,YAAY,EAAE,UAAU,EACxB,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,cAAc,CAAA;KAAE,GAClD,eAAe,CAAC,eAAe,EAAE,CAAC;IAErC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAiCG;aACa,MAAM,CACpB,KAAK,EAAE,qBAAqB,EAAE,GAC7B,eAAe,CAAC,eAAe,EAAE,CAAC;IAErC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAyCG;aACa,iBAAiB,CAC/B,WAAW,EAAE,oCAAoC,EAAE,EACnD,UAAU,EAAE,IAAI,GAAG,GAAG,EACtB,QAAQ,EAAE,kCAAkC,EAAE,EAC9C,WAAW,EAAE,kCAAkC,EAC/C,YAAY,EAAE,MAAM,EACpB,QAAQ,CAAC,EAAE,MAAM,EACjB,iBAAiB,CAAC,EAAE,MAAM,GACzB,eAAe,CAAC,mCAAmC,CAAC;CACxD;AAMD;;;;;;;;GAQG;AACH,eAAO,MAAM,wBAAwB;;;;EAA0C,CAAA;AAC/E,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAA;AAE/E;;;;;;;;;GASG;AACH,eAAO,MAAM,cAAc;;;;;EAKzB,CAAA;AACF,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAA;AAE3D;;;;GAIG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;EAiBhC,CAAA;AACF,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAA;AAEzE;;;;GAIG;AACH,eAAO,MAAM,yBAAyB;;;;;;kBAQ3B,CAAA;AACX,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAC7C,OAAO,yBAAyB,CACjC,CAAA;AAMD;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAStC,CAAA;AACF,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAC/C,OAAO,2BAA2B,CACnC,CAAA;AAQD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;iBAMrC,CAAA;AACF,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAC9C,OAAO,0BAA0B,CAClC,CAAA;AAMD;;;;;;;GAOG;AACH,eAAO,MAAM,kCAAkC;;;iBAG7C,CAAA;AACF,MAAM,MAAM,kCAAkC,GAAG,CAAC,CAAC,KAAK,CACtD,OAAO,kCAAkC,CAC1C,CAAA;AAMD;;;;;;;;;GASG;AACH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;iBAKrC,CAAA;AACF,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAC9C,OAAO,0BAA0B,CAClC,CAAA;AAMD;;;;;;;;GAQG;AACH,eAAO,MAAM,2BAA2B;;;;iBAItC,CAAA;AACF,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAC/C,OAAO,2BAA2B,CACnC,CAAA;AAMD;;;;;;;GAOG;AACH,eAAO,MAAM,0BAA0B;;;iBAGrC,CAAA;AACF,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAC9C,OAAO,0BAA0B,CAClC,CAAA;AAMD;;;;;;;;GAQG;AACH,eAAO,MAAM,6BAA6B;;;;iBAIxC,CAAA;AACF,MAAM,MAAM,6BAA6B,GAAG,CAAC,CAAC,KAAK,CACjD,OAAO,6BAA6B,CACrC,CAAA;AAMD;;;;;;;;;GASG;AACH,eAAO,MAAM,4BAA4B;;;;;iBAKvC,CAAA;AACF,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAChD,OAAO,4BAA4B,CACpC,CAAA;AAMD;;;;;;;;GAQG;AACH,eAAO,MAAM,0BAA0B;;;;iBAIrC,CAAA;AACF,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAC9C,OAAO,0BAA0B,CAClC,CAAA;AAMD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,2BAA2B;;;;;;iBAMtC,CAAA;AACF,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAC/C,OAAO,2BAA2B,CACnC,CAAA;AAQD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAO1C,CAAA;AACF,MAAM,MAAM,+BAA+B,GAAG,CAAC,CAAC,KAAK,CACnD,OAAO,+BAA+B,CACvC,CAAA;AAMD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,+BAA+B;;;;;;iBAM1C,CAAA;AACF,MAAM,MAAM,+BAA+B,GAAG,CAAC,CAAC,KAAK,CACnD,OAAO,+BAA+B,CACvC,CAAA;AAQD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,0BAA0B;;;;;;iBAMrC,CAAA;AACF,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAC9C,OAAO,0BAA0B,CAClC,CAAA;AAQD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,4BAA4B;;;;;;iBAMvC,CAAA;AACF,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAChD,OAAO,4BAA4B,CACpC,CAAA;AAkBD;;;;;GAKG;AACH,eAAO,MAAM,gCAAgC;;;;;;;;;;;;;;;;;;;4BAc3C,CAAA;AACF,MAAM,MAAM,gCAAgC,GAAG,CAAC,CAAC,KAAK,CACpD,OAAO,gCAAgC,CACxC,CAAA;AAMD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,qBAAqB;;;;;iBAc/B,CAAA;AACH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAA;AAEzE;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;iBASlC,CAAA;AACF,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAA;AAM7E;;;;;;;;;;GAUG;AACH,eAAO,MAAM,oCAAoC;;;;;;;;;;iBAM/C,CAAA;AACF,MAAM,MAAM,oCAAoC,GAAG,CAAC,CAAC,KAAK,CACxD,OAAO,oCAAoC,CAC5C,CAAA;AAMD;;;;;;;GAOG;AACH,eAAO,MAAM,cAAc;;;EAAiC,CAAA;AAC5D,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAA;AAE3D;;;;;;;;;GASG;AACH,eAAO,MAAM,0BAA0B;;;;;;;;iBAKrC,CAAA;AACF,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAC9C,OAAO,0BAA0B,CAClC,CAAA;AAQD;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAShC,CAAA;AACF,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAA"}

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

@@ -36,10 +36,6 @@ export declare abstract class PluginDesignDeleteApi {
      * children are removed and linked-list neighbours are fixed up — not caller-tunable
      * in v1. Undoable — commits as a **single** undo entry.
      *
-     * Dimension lines anchored to a deleted entity are removed with it, in the same undo
-     * 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).

package/dist/api/design/delete/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/api/design/delete/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAA;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAClD,OAAO,EAAE,wBAAwB,EAAE,MAAM,SAAS,CAAA;AAElD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,8BAA8B;;iBAEzC,CAAA;AACF,MAAM,MAAM,8BAA8B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAA;AAE3F;;;;;;;;;GASG;AACH,8BAAsB,qBAAqB;;IAGzC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAkCG;aACa,QAAQ,CACtB,UAAU,EAAE,eAAe,EAAE,GAC5B,eAAe,CAAC,wBAAwB,CAAC;CAC7C"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/api/design/delete/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAA;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAClD,OAAO,EAAE,wBAAwB,EAAE,MAAM,SAAS,CAAA;AAElD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,8BAA8B;;iBAEzC,CAAA;AACF,MAAM,MAAM,8BAA8B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAA;AAE3F;;;;;;;;;GASG;AACH,8BAAsB,qBAAqB;;IAGzC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8BG;aACa,QAAQ,CACtB,UAAU,EAAE,eAAe,EAAE,GAC5B,eAAe,CAAC,wBAAwB,CAAC;CAC7C"}

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

@@ -7,11 +7,9 @@ import { PluginDesignChangeResult } from "../lock";
  * `design.create.door`; generic reads (`listDoors`/`getHost`/`getProperties`) live at
  * `design.query.*`. Door targets are {@linkcode ComponentHandle}s.
  *
- * `getSwingDirection` is a DERIVED read (no persisted field) — computed from the placed
- * mesh's orientation: stand on the side the door swings open to, facing it; `'left'`
- * when the hinged jamb is on your left. `mirror` reflects the door about one of its own
- * axes (undoable, one command): `'x'` flips the swing side, `'z'` swaps the hinged jamb;
- * `setType` is intentionally absent (the engine has no in-place re-type —
+ * `getSwingDirection` is a DERIVED read (no persisted field) — computed from the door
+ * mesh reflection state. `mirror` reflects the door across an axis (undoable, one
+ * command); `setType` is intentionally absent (the engine has no in-place re-type —
  * it would require delete+recreate).
  *
  * The **catalog** reads (`listCatalogGroups`/`listCatalog`/`getCatalogItem`/`exists`)
@@ -146,11 +144,9 @@ export declare abstract class PluginDesignDoorsApi {
      */
     abstract getSupportFloor(door: ComponentHandle): PluginApiReturn<ComponentHandle | null>;
     /**
-     * Get a door's swing (hinge) handedness. Stand on the side the door swings
-     * open to, facing the door: `'left'` when the hinged jamb is on your left,
-     * `'right'` when it is on your right. Derived from the placed mesh's
-     * orientation (the same reflection `mirror` and the `hinge` placement option
-     * apply), not a persisted field.
+     * Get a door's swing (hinge) handedness — whether it opens as a left-hand or
+     * right-hand door. Derived from the door mesh's reflection state, not a
+     * persisted field.
      *
      * @param door The door to query
      * @returns `'left'` / `'right'`, or `null` if indeterminate
@@ -169,13 +165,11 @@ export declare abstract class PluginDesignDoorsApi {
      */
     abstract getSwingDirection(door: ComponentHandle): PluginApiReturn<"left" | "right" | null>;
     /**
-     * Mirror a door about its own axes. `'x'` (default) flips the swing side —
-     * the door opens to the other side of the wall; `'z'` swaps the hinged jamb
-     * (left-hand ↔ right-hand, same swing side); `'y'` turns it upside down.
-     * Undoable as a single command.
+     * Mirror a door across an axis, flipping its swing so it opens from the
+     * other side. Undoable as a single command.
      *
      * @param door The door to mirror
-     * @param axis Reflection axis (optional; default `'x'` — the swing-flip axis; `'z'` — the hinge-jamb axis)
+     * @param axis Reflection axis (optional; default `'x'` — the swing-flip axis)
      * @returns The affected door(s)
      *
      * @examplePrompt Flip this door's swing
@@ -186,11 +180,10 @@ export declare abstract class PluginDesignDoorsApi {
      *
      * # Example
      * ```ts
-     * // Flip the selected door's swing side — axis defaults to "x"
+     * // Flip the selected door's swing — axis defaults to "x" (the swing-flip
+     * // axis); pass "y" or "z" to reflect across a different axis
      * const [door] = await snaptrude.design.query.listDoors({ isSelected: true })
      * const { affected } = await snaptrude.design.doors.mirror(door)
-     * // …or swap the hinged jamb instead (keeps the swing side)
-     * await snaptrude.design.doors.mirror(door, "z")
      * ```
      */
     abstract mirror(door: ComponentHandle, axis?: PluginMirrorAxis): PluginApiReturn<PluginDesignChangeResult>;
@@ -341,7 +334,7 @@ export declare const PluginDoorDimensions: z.ZodObject<{
     thickness: z.ZodNumber;
 }, z.core.$strip>;
 export type PluginDoorDimensions = z.infer<typeof PluginDoorDimensions>;
-/** Mirror axis — tokens mirror the engine `FlipDirection` verbatim: `'x'` flips the swing side, `'z'` swaps the hinged jamb, `'y'` turns the door upside down. */
+/** Mirror axis — tokens mirror the engine `FlipDirection` verbatim (§6.1). */
 export declare const PluginMirrorAxis: z.ZodEnum<{
     x: "x";
     y: "y";
@@ -354,7 +347,7 @@ export type PluginMirrorAxis = z.infer<typeof PluginMirrorAxis>;
  * | Property | Type | Description |
  * |---|---|---|
  * | `door` | {@linkcode ComponentHandle} | The door to mirror |
- * | `axis` | {@linkcode PluginMirrorAxis} | Reflection axis (optional; default `'x'` — the swing-flip axis; `'z'` — the hinge-jamb axis) |
+ * | `axis` | {@linkcode PluginMirrorAxis} | Reflection axis (optional; default `'x'` — the swing-flip axis) |
  */
 export declare const PluginDesignDoorMirrorArgs: z.ZodObject<{
     door: z.ZodPipe<z.ZodString, z.ZodTransform<ComponentHandle, string>>;