@snaptrude/plugin-core 0.2.9 → 0.5.0

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

@@ -0,0 +1,178 @@
+import * as z from "zod";
+import { PluginApiReturn } from "../../../types";
+import { ComponentHandle } from "../../../handles";
+import { PluginSpaceUpdateResult } from "../../entity/space";
+/**
+ * Sparse property updates for a space. Only provided fields change.
+ *
+ * | Property | Type | Description |
+ * |---|---|---|
+ * | `room_type` | `string`? | Room label |
+ * | `massType` | `PluginMassType`? | Mass type |
+ * | `spaceType` | `PluginSpaceType`? | Space type |
+ * | `areaClass` | `PluginAreaClass`? | Area class (NET/GROSS/EXCLUDED) |
+ * | `departmentId` | `PluginDepartmentId`? | Department |
+ */
+export declare const PluginSpacePropertyUpdates: z.ZodObject<{
+    room_type: z.ZodOptional<z.ZodString>;
+    massType: z.ZodOptional<z.ZodEnum<{
+        Room: "Room";
+        Plinth: "Plinth";
+        Void: "Void";
+        Pergola: "Pergola";
+        Furniture: "Furniture";
+        "Facade element": "Facade element";
+        "Generic mass": "Generic mass";
+        Department: "Department";
+        Building: "Building";
+        "Revit Import": "Revit Import";
+        Mass: "Mass";
+        Site: "Site";
+    }>>;
+    spaceType: z.ZodOptional<z.ZodEnum<{
+        Room: "Room";
+        "Program Block": "Program Block";
+        Balcony: "Balcony";
+        Road: "Road";
+        Garden: "Garden";
+        Deck: "Deck";
+        Pool: "Pool";
+        Walkway: "Walkway";
+        Envelope: "Envelope";
+        Parking: "Parking";
+    }>>;
+    areaClass: z.ZodOptional<z.ZodEnum<{
+        NET: "NET";
+        GROSS: "GROSS";
+        EXCLUDED: "EXCLUDED";
+    }>>;
+    departmentId: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<{
+        DEFAULT: "DEFAULT";
+        SITE: "SITE";
+        ENVELOPE: "ENVELOPE";
+        CORE: "CORE";
+    }>, z.ZodUUID]>>;
+}, z.core.$strip>;
+export type PluginSpacePropertyUpdates = z.infer<typeof PluginSpacePropertyUpdates>;
+/** Geometry replacement for a space — re-extrude a profile. */
+export declare const PluginSpaceGeometryUpdate: z.ZodObject<{
+    profile: z.ZodPipe<z.ZodString, z.ZodTransform<import("../../..").Handle<"profile">, string>>;
+    extrudeHeight: z.ZodNumber;
+}, z.core.$strip>;
+export type PluginSpaceGeometryUpdate = z.infer<typeof PluginSpaceGeometryUpdate>;
+/** One space to update via {@linkcode PluginDesignUpdateApi.spaces}. */
+export declare const PluginUpdateSpaceItem: z.ZodObject<{
+    space: z.ZodPipe<z.ZodString, z.ZodTransform<ComponentHandle, string>>;
+    properties: z.ZodOptional<z.ZodObject<{
+        room_type: z.ZodOptional<z.ZodString>;
+        massType: z.ZodOptional<z.ZodEnum<{
+            Room: "Room";
+            Plinth: "Plinth";
+            Void: "Void";
+            Pergola: "Pergola";
+            Furniture: "Furniture";
+            "Facade element": "Facade element";
+            "Generic mass": "Generic mass";
+            Department: "Department";
+            Building: "Building";
+            "Revit Import": "Revit Import";
+            Mass: "Mass";
+            Site: "Site";
+        }>>;
+        spaceType: z.ZodOptional<z.ZodEnum<{
+            Room: "Room";
+            "Program Block": "Program Block";
+            Balcony: "Balcony";
+            Road: "Road";
+            Garden: "Garden";
+            Deck: "Deck";
+            Pool: "Pool";
+            Walkway: "Walkway";
+            Envelope: "Envelope";
+            Parking: "Parking";
+        }>>;
+        areaClass: z.ZodOptional<z.ZodEnum<{
+            NET: "NET";
+            GROSS: "GROSS";
+            EXCLUDED: "EXCLUDED";
+        }>>;
+        departmentId: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<{
+            DEFAULT: "DEFAULT";
+            SITE: "SITE";
+            ENVELOPE: "ENVELOPE";
+            CORE: "CORE";
+        }>, z.ZodUUID]>>;
+    }, z.core.$strip>>;
+    geometry: z.ZodOptional<z.ZodObject<{
+        profile: z.ZodPipe<z.ZodString, z.ZodTransform<import("../../..").Handle<"profile">, string>>;
+        extrudeHeight: z.ZodNumber;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type PluginUpdateSpaceItem = z.infer<typeof PluginUpdateSpaceItem>;
+/**
+ * `snaptrude.design.update` — edit existing scene entities (properties + geometry).
+ *
+ * Migrated from the removed `entity.space.{update, updateGeometryFromProfile, bulkUpdate}`.
+ * Only provided fields change; each call is undoable. Failures throw (RPC rejects).
+ */
+export declare abstract class PluginDesignUpdateApi {
+    constructor();
+    /**
+     * Update a single space (room) — change its properties (room label, space
+     * type, mass type, area class, department) and/or replace its geometry by
+     * re-extruding a profile to a new height. Sparse and undoable: only the
+     * fields you provide change.
+     *
+     * @param space - The space to update
+     * @param options - `properties` (sparse) and/or `geometry` ({ profile, extrudeHeight })
+     * @returns the updated space's echoed {@linkcode PluginSpaceUpdateResult}
+     *
+     * @examplePrompt Rename this room to Office
+     * @examplePrompt Change this space's room type to Meeting Room
+     * @examplePrompt Set the height of this room to 3 metres
+     * @examplePrompt Move this space into the Circulation department
+     * @examplePrompt Exclude this room from the area calculations
+     *
+     * # Example
+     * ```ts
+     * await snaptrude.design.update.space("space-id", { properties: { room_type: "Office" } })
+     * ```
+     */
+    abstract space(space: ComponentHandle, options: {
+        properties?: PluginSpacePropertyUpdates;
+        geometry?: PluginSpaceGeometryUpdate;
+    }): PluginApiReturn<PluginSpaceUpdateResult>;
+    /**
+     * Update many spaces (rooms) in one undoable operation — the bulk form of
+     * {@linkcode space}. Each item pairs a space with the sparse property
+     * changes and/or geometry re-extrude to apply; every item is validated up
+     * front, then all changes are applied as a single command.
+     *
+     * Migrated from `entity.space.bulkUpdate`.
+     *
+     * @param items - One {@linkcode PluginUpdateSpaceItem} per space
+     * @returns one {@linkcode PluginSpaceUpdateResult} per item, in input order
+     *
+     * @examplePrompt Label all the selected rooms as Bedrooms
+     * @examplePrompt Change the room type of these five spaces at once
+     * @examplePrompt Set every room on this floor to a 3m height in one go
+     * @examplePrompt Bulk-assign these spaces to the Service department
+     * @examplePrompt Mark all of these rooms as excluded from area in one update
+     *
+     * # Example
+     * ```ts
+     * // Re-label every selected room and mark it NET area — one undoable bulk update
+     * const rooms = await snaptrude.design.query.listSpaces({ isSelected: true })
+     * const results = await snaptrude.design.update.spaces(
+     *   rooms.map((space) => ({
+     *     space,
+     *     properties: { room_type: "Bedroom", areaClass: "NET" },
+     *   })),
+     * )
+     * // One result per item, in input order
+     * console.log(results.map((r) => r.spaceId))
+     * ```
+     */
+    abstract spaces(items: PluginUpdateSpaceItem[]): PluginApiReturn<PluginSpaceUpdateResult[]>;
+}
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/api/design/update/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAA;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAChD,OAAO,EAAE,eAAe,EAAiB,MAAM,kBAAkB,CAAA;AACjE,OAAO,EAKL,uBAAuB,EACxB,MAAM,oBAAoB,CAAA;AAE3B;;;;;;;;;;GAUG;AACH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAMrC,CAAA;AACF,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAA;AAEnF,+DAA+D;AAC/D,eAAO,MAAM,yBAAyB;;;iBAGpC,CAAA;AACF,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAA;AAEjF,wEAAwE;AACxE,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAIhC,CAAA;AACF,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAA;AAEzE;;;;;GAKG;AACH,8BAAsB,qBAAqB;;IAGzC;;;;;;;;;;;;;;;;;;;;OAoBG;aACa,KAAK,CACnB,KAAK,EAAE,eAAe,EACtB,OAAO,EAAE;QACP,UAAU,CAAC,EAAE,0BAA0B,CAAA;QACvC,QAAQ,CAAC,EAAE,yBAAyB,CAAA;KACrC,GACA,eAAe,CAAC,uBAAuB,CAAC;IAE3C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8BG;aACa,MAAM,CAAC,KAAK,EAAE,qBAAqB,EAAE,GAAG,eAAe,CAAC,uBAAuB,EAAE,CAAC;CACnG"}

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

@@ -0,0 +1,189 @@
+import * as z from "zod";
+import { PluginApiReturn } from "../../../types";
+import { ComponentHandle } from "../../../handles";
+import { PluginDesignChangeResult } from "../lock";
+/**
+ * `snaptrude.design.windows` — window-specific reads. Creation lives at
+ * `design.create.window`; generic reads (`listWindows`/`getHost`/`getProperties`) live
+ * at `design.query.*`. Window targets are {@linkcode ComponentHandle}s.
+ *
+ * `listTypes` (UI-const catalog), `getSillHeight` (bounds-derived), and the
+ * command-wired `mirror` land in a later pass.
+ */
+export declare abstract class PluginDesignWindowsApi {
+    constructor();
+    /**
+     * Get the type name of a window — the label that identifies which kind of
+     * window the instance is, as shown in its properties.
+     *
+     * @param window The window to query
+     * @returns The type as a `string`, or `null`
+     *
+     * @examplePrompt What type of window is this?
+     * @examplePrompt Is the selected window a casement or a slider?
+     * @examplePrompt Tell me the window type used on this wall
+     * @examplePrompt Check what kind of window the living room has
+     *
+     * # Example
+     * ```ts
+     * const [win] = await snaptrude.design.query.listWindows({ isSelected: true })
+     * const type = await snaptrude.design.windows.getType(win)
+     * if (type) console.log("window type:", type)
+     * ```
+     */
+    abstract getType(window: ComponentHandle): PluginApiReturn<string | null>;
+    /**
+     * Get the width of a window — how wide its opening is along the host wall.
+     *
+     * @param window The window to query
+     * @returns The width as a `number`, or `null`
+     *
+     * @examplePrompt How wide is this window?
+     * @examplePrompt What's the width of the selected window?
+     * @examplePrompt Measure the width of the kitchen window
+     * @examplePrompt Check whether this window is 1200mm wide
+     *
+     * # Example
+     * ```ts
+     * const [win] = await snaptrude.design.query.listWindows()
+     * const width = await snaptrude.design.windows.getWidth(win)
+     * if (width !== null) console.log("window width:", width)
+     * ```
+     */
+    abstract getWidth(window: ComponentHandle): PluginApiReturn<number | null>;
+    /**
+     * Get the height of a window — how tall its opening is on the host wall.
+     *
+     * @param window The window to query
+     * @returns The height as a `number`, or `null`
+     *
+     * @examplePrompt How tall is this window?
+     * @examplePrompt What's the height of the selected window?
+     * @examplePrompt Check the window height on this wall
+     * @examplePrompt Is the bedroom window 1.5m high?
+     *
+     * # Example
+     * ```ts
+     * const [win] = await snaptrude.design.query.listWindows()
+     * const height = await snaptrude.design.windows.getHeight(win)
+     * if (height !== null) console.log("window height:", height)
+     * ```
+     */
+    abstract getHeight(window: ComponentHandle): PluginApiReturn<number | null>;
+    /**
+     * Get a window's full dimensions in one call — width along the wall, vertical
+     * height, and thickness through the wall — measured in the window's local
+     * oriented space.
+     *
+     * @param window The window to query
+     * @returns The dimensions, or `null`
+     *
+     * @examplePrompt What are the dimensions of this window?
+     * @examplePrompt How big is the selected window?
+     * @examplePrompt Give me the width, height and depth of this window
+     * @examplePrompt Measure the living room window
+     * @examplePrompt Get the window size including its thickness through the wall
+     *
+     * # Example
+     * ```ts
+     * const [win] = await snaptrude.design.query.listWindows({ isSelected: true })
+     * const dims = await snaptrude.design.windows.getDimensions(win)
+     * if (dims) console.log(dims.width, dims.height, dims.thickness)
+     * ```
+     */
+    abstract getDimensions(window: ComponentHandle): PluginApiReturn<PluginWindowDimensions | null>;
+    /**
+     * Set the width of a window, resizing its opening and re-cutting the host
+     * wall. Width is in engine units; the change is undoable.
+     *
+     * @param window The window to resize
+     * @param width New width (engine units)
+     * @returns The affected window
+     *
+     * @examplePrompt Make this window 1200mm wide
+     * @examplePrompt Widen the selected window to 4 feet
+     * @examplePrompt Change the window width to 1.5m
+     * @examplePrompt Resize the kitchen window to 900 wide
+     *
+     * # Example
+     * ```ts
+     * // Takes a single window (unlike design.doors.setWidth, which takes an array)
+     * const [win] = await snaptrude.design.query.listWindows({ isSelected: true })
+     * const { affected } = await snaptrude.design.windows.setWidth(win, 1200)
+     * ```
+     */
+    abstract setWidth(window: ComponentHandle, width: number): PluginApiReturn<PluginDesignChangeResult>;
+    /**
+     * Set the height of a window, resizing its opening and re-cutting the host
+     * wall. Height is in engine units; the change is undoable.
+     *
+     * @param window The window to resize
+     * @param height New height (engine units)
+     * @returns The affected window
+     *
+     * @examplePrompt Make this window 1.5m tall
+     * @examplePrompt Change the window height to 4 feet
+     * @examplePrompt Shorten the selected window to 900mm high
+     * @examplePrompt Set the bedroom window height to 1200
+     *
+     * # Example
+     * ```ts
+     * const [win] = await snaptrude.design.query.listWindows({ isSelected: true })
+     * await snaptrude.design.windows.setHeight(win, 1500)
+     * ```
+     */
+    abstract setHeight(window: ComponentHandle, height: number): PluginApiReturn<PluginDesignChangeResult>;
+}
+/**
+ * Arguments for the single-window read methods.
+ *
+ * | Property | Type | Description |
+ * |---|---|---|
+ * | `window` | {@linkcode ComponentHandle} | The window to query |
+ */
+export declare const PluginDesignWindowArgs: z.ZodObject<{
+    window: z.ZodPipe<z.ZodString, z.ZodTransform<ComponentHandle, string>>;
+}, z.core.$strip>;
+export type PluginDesignWindowArgs = z.infer<typeof PluginDesignWindowArgs>;
+/**
+ * A window's dimensions.
+ *
+ * | Property | Type | Description |
+ * |---|---|---|
+ * | `width` | `number` | Along the wall |
+ * | `height` | `number` | Vertical |
+ * | `thickness` | `number` | Through the wall (engine `length` axis) |
+ */
+export declare const PluginWindowDimensions: z.ZodObject<{
+    width: z.ZodNumber;
+    height: z.ZodNumber;
+    thickness: z.ZodNumber;
+}, z.core.$strip>;
+export type PluginWindowDimensions = z.infer<typeof PluginWindowDimensions>;
+/**
+ * Arguments for {@linkcode PluginDesignWindowsApi.setWidth}.
+ *
+ * | Property | Type | Description |
+ * |---|---|---|
+ * | `window` | {@linkcode ComponentHandle} | The window to resize |
+ * | `width` | `number` | New width (engine units) |
+ */
+export declare const PluginDesignWindowSetWidthArgs: z.ZodObject<{
+    window: z.ZodPipe<z.ZodString, z.ZodTransform<ComponentHandle, string>>;
+    width: z.ZodNumber;
+}, z.core.$strip>;
+export type PluginDesignWindowSetWidthArgs = z.infer<typeof PluginDesignWindowSetWidthArgs>;
+/**
+ * Arguments for {@linkcode PluginDesignWindowsApi.setHeight}.
+ *
+ * | Property | Type | Description |
+ * |---|---|---|
+ * | `window` | {@linkcode ComponentHandle} | The window to resize |
+ * | `height` | `number` | New height (engine units) |
+ */
+export declare const PluginDesignWindowSetHeightArgs: z.ZodObject<{
+    window: z.ZodPipe<z.ZodString, z.ZodTransform<ComponentHandle, string>>;
+    height: z.ZodNumber;
+}, z.core.$strip>;
+export type PluginDesignWindowSetHeightArgs = z.infer<typeof PluginDesignWindowSetHeightArgs>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/api/design/windows/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;;;;;;;GAOG;AACH,8BAAsB,sBAAsB;;IAG1C;;;;;;;;;;;;;;;;;;OAkBG;aACa,OAAO,CAAC,MAAM,EAAE,eAAe,GAAG,eAAe,CAAC,MAAM,GAAG,IAAI,CAAC;IAEhF;;;;;;;;;;;;;;;;;OAiBG;aACa,QAAQ,CAAC,MAAM,EAAE,eAAe,GAAG,eAAe,CAAC,MAAM,GAAG,IAAI,CAAC;IAEjF;;;;;;;;;;;;;;;;;OAiBG;aACa,SAAS,CAAC,MAAM,EAAE,eAAe,GAAG,eAAe,CAAC,MAAM,GAAG,IAAI,CAAC;IAElF;;;;;;;;;;;;;;;;;;;;OAoBG;aACa,aAAa,CAC3B,MAAM,EAAE,eAAe,GACtB,eAAe,CAAC,sBAAsB,GAAG,IAAI,CAAC;IAEjD;;;;;;;;;;;;;;;;;;;OAmBG;aACa,QAAQ,CACtB,MAAM,EAAE,eAAe,EACvB,KAAK,EAAE,MAAM,GACZ,eAAe,CAAC,wBAAwB,CAAC;IAE5C;;;;;;;;;;;;;;;;;;OAkBG;aACa,SAAS,CACvB,MAAM,EAAE,eAAe,EACvB,MAAM,EAAE,MAAM,GACb,eAAe,CAAC,wBAAwB,CAAC;CAC7C;AAED;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB;;iBAEjC,CAAA;AACF,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAA;AAE3E;;;;;;;;GAQG;AACH,eAAO,MAAM,sBAAsB;;;;iBAIjC,CAAA;AACF,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAA;AAE3E;;;;;;;GAOG;AACH,eAAO,MAAM,8BAA8B;;;iBAGzC,CAAA;AACF,MAAM,MAAM,8BAA8B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAA;AAE3F;;;;;;;GAOG;AACH,eAAO,MAAM,+BAA+B;;;iBAG1C,CAAA;AACF,MAAM,MAAM,+BAA+B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAA"}

package/dist/api/entity/buildableEnvelope.d.ts

@@ -13,62 +13,90 @@ import { PluginApiReturn } from "../../types";
 export declare abstract class PluginBuildableEnvelopeApi {
     constructor();
     /**
-     * Create a new parametric buildable envelope.
+     * 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.
      *
-     * @param args - A {@linkcode PluginBuildableEnvelopeCreateArgs} object.
+     * @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 Model the allowable massing from the setback rules
+     * @examplePrompt Create a zoning envelope capped at 12 floors with FAR 3
+     *
      * # Example
      * ```ts
-     * const { buildableEnvelopeId } = await snaptrude.entity.buildableEnvelope.create({
-     *   sitePolygon: [
+     * const { buildableEnvelopeId } = await snaptrude.entity.buildableEnvelope.create(
+     *   [
      *     { x: 0, z: 0 },
      *     { x: 100, z: 0 },
      *     { x: 100, z: 80 },
      *     { x: 0, z: 80 },
      *   ],
-     *   lengthUnit: "ft",
-     *   setbacks: [
+     *   "ft",
+     *   [
      *     { aboveHeight: 0, front: 10, side: 5, rear: 10 },
      *     { aboveHeight: 100, front: 20, side: 10, rear: 20 },
      *   ],
-     *   verticalCap: { kind: "max_height", maxHeight: 150 },
-     *   floorToFloor: 12,
-     * })
+     *   { kind: "max_height", maxHeight: 150 },
+     *   12,
+     * )
      * ```
      */
-    abstract create(args: PluginBuildableEnvelopeCreateArgs): PluginApiReturn<PluginBuildableEnvelopeCreateResult>;
+    abstract create(sitePolygon: PluginBuildableEnvelopePolygonVertex[], lengthUnit: "ft" | "m", setbacks: PluginBuildableEnvelopeSetbackTier[], verticalCap: PluginBuildableEnvelopeVerticalCap, floorToFloor: number, farRatio?: number, lotCoverageMaxPct?: number): PluginApiReturn<PluginBuildableEnvelopeCreateResult>;
     /**
-     * Update an existing parametric buildable envelope.
+     * Update an existing parametric buildable envelope — regenerate the zoning
+     * volume from a revised site polygon, setbacks, vertical cap, or FAR and
+     * lot-coverage limits, keeping the same envelope id.
      *
-     * @param args - A {@linkcode PluginBuildableEnvelopeUpdateArgs} object.
-     *   `buildableEnvelopeId` is required and must match an existing envelope on
-     *   the canvas.
+     * @param buildableEnvelopeId - Existing envelope ID to update; non-empty and
+     *   must match an existing envelope on the canvas.
+     * @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 PluginBuildableEnvelopeUpdateResult} with the
      *   `buildableEnvelopeId` of the updated envelope.
      * @throws If validation fails, the envelope does not exist, or generation
      *   produces no renderable geometry.
      *
+     * @examplePrompt Change the envelope's height limit to 175 feet
+     * @examplePrompt Update the setbacks on the buildable envelope
+     * @examplePrompt Regenerate the zoning envelope with a new site boundary
+     * @examplePrompt Increase the FAR on the buildable volume
+     * @examplePrompt Modify the envelope to allow 15 storeys instead
+     *
      * # Example
      * ```ts
-     * const { buildableEnvelopeId } = await snaptrude.entity.buildableEnvelope.update({
-     *   buildableEnvelopeId: existingId,
-     *   sitePolygon: [
+     * const { buildableEnvelopeId } = await snaptrude.entity.buildableEnvelope.update(
+     *   existingId,
+     *   [
      *     { x: 0, z: 0 },
      *     { x: 100, z: 0 },
      *     { x: 100, z: 80 },
      *     { x: 0, z: 80 },
      *   ],
-     *   lengthUnit: "ft",
-     *   setbacks: [{ aboveHeight: 0, front: 10, side: 5, rear: 10 }],
-     *   verticalCap: { kind: "max_height", maxHeight: 175 },
-     *   floorToFloor: 12,
-     * })
+     *   "ft",
+     *   [{ aboveHeight: 0, front: 10, side: 5, rear: 10 }],
+     *   { kind: "max_height", maxHeight: 175 },
+     *   12,
+     * )
      * ```
      */
-    abstract update(args: PluginBuildableEnvelopeUpdateArgs): PluginApiReturn<PluginBuildableEnvelopeUpdateResult>;
+    abstract update(buildableEnvelopeId: string, sitePolygon: PluginBuildableEnvelopePolygonVertex[], lengthUnit: "ft" | "m", setbacks: PluginBuildableEnvelopeSetbackTier[], verticalCap: PluginBuildableEnvelopeVerticalCap, floorToFloor: number, farRatio?: number, lotCoverageMaxPct?: number): PluginApiReturn<PluginBuildableEnvelopeUpdateResult>;
 }
 /**
  * Site polygon vertex in the request `lengthUnit`.

package/dist/api/entity/buildableEnvelope.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"buildableEnvelope.d.ts","sourceRoot":"","sources":["../../../src/api/entity/buildableEnvelope.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAA;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAE7C;;;;;;;;;GASG;AACH,8BAAsB,0BAA0B;;IAG9C;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;aACa,MAAM,CACpB,IAAI,EAAE,iCAAiC,GACtC,eAAe,CAAC,mCAAmC,CAAC;IAEvD;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;aACa,MAAM,CACpB,IAAI,EAAE,iCAAiC,GACtC,eAAe,CAAC,mCAAmC,CAAC;CACxD;AAED;;;;;GAKG;AACH,eAAO,MAAM,oCAAoC;;;kEAG/C,CAAA;AAEF,MAAM,MAAM,oCAAoC,GAAG,CAAC,CAAC,KAAK,CACxD,OAAO,oCAAoC,CAC5C,CAAA;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,kCAAkC;;;;;;4BAS7C,CAAA;AAEF,MAAM,MAAM,kCAAkC,GAAG,CAAC,CAAC,KAAK,CACtD,OAAO,kCAAkC,CAC1C,CAAA;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,kCAAkC;;;;;kBAKpC,CAAA;AAEX,MAAM,MAAM,kCAAkC,GAAG,CAAC,CAAC,KAAK,CACtD,OAAO,kCAAkC,CAC1C,CAAA;AA+BD;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,iCAAiC;;;;;;;;;;;;;;;;;;;;;;kBAWZ,CAAA;AAElC,MAAM,MAAM,iCAAiC,GAAG,CAAC,CAAC,KAAK,CACrD,OAAO,iCAAiC,CACzC,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,mCAAmC;;kBAErC,CAAA;AAEX,MAAM,MAAM,mCAAmC,GAAG,CAAC,CAAC,KAAK,CACvD,OAAO,mCAAmC,CAC3C,CAAA;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,iCAAiC;;;;;;;;;;;;;;;;;;;;;;;kBAYZ,CAAA;AAElC,MAAM,MAAM,iCAAiC,GAAG,CAAC,CAAC,KAAK,CACrD,OAAO,iCAAiC,CACzC,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,mCAAmC;;kBAErC,CAAA;AAEX,MAAM,MAAM,mCAAmC,GAAG,CAAC,CAAC,KAAK,CACvD,OAAO,mCAAmC,CAC3C,CAAA"}
+{"version":3,"file":"buildableEnvelope.d.ts","sourceRoot":"","sources":["../../../src/api/entity/buildableEnvelope.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAA;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAE7C;;;;;;;;;GASG;AACH,8BAAsB,0BAA0B;;IAG9C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAwCG;aACa,MAAM,CACpB,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;IAEvD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAyCG;aACa,MAAM,CACpB,mBAAmB,EAAE,MAAM,EAC3B,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;AAED;;;;;GAKG;AACH,eAAO,MAAM,oCAAoC;;;kEAG/C,CAAA;AAEF,MAAM,MAAM,oCAAoC,GAAG,CAAC,CAAC,KAAK,CACxD,OAAO,oCAAoC,CAC5C,CAAA;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,kCAAkC;;;;;;4BAS7C,CAAA;AAEF,MAAM,MAAM,kCAAkC,GAAG,CAAC,CAAC,KAAK,CACtD,OAAO,kCAAkC,CAC1C,CAAA;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,kCAAkC;;;;;kBAKpC,CAAA;AAEX,MAAM,MAAM,kCAAkC,GAAG,CAAC,CAAC,KAAK,CACtD,OAAO,kCAAkC,CAC1C,CAAA;AA+BD;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,iCAAiC;;;;;;;;;;;;;;;;;;;;;;kBAWZ,CAAA;AAElC,MAAM,MAAM,iCAAiC,GAAG,CAAC,CAAC,KAAK,CACrD,OAAO,iCAAiC,CACzC,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,mCAAmC;;kBAErC,CAAA;AAEX,MAAM,MAAM,mCAAmC,GAAG,CAAC,CAAC,KAAK,CACvD,OAAO,mCAAmC,CAC3C,CAAA;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,iCAAiC;;;;;;;;;;;;;;;;;;;;;;;kBAYZ,CAAA;AAElC,MAAM,MAAM,iCAAiC,GAAG,CAAC,CAAC,KAAK,CACrD,OAAO,iCAAiC,CACzC,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,mCAAmC;;kBAErC,CAAA;AAEX,MAAM,MAAM,mCAAmC,GAAG,CAAC,CAAC,KAAK,CACvD,OAAO,mCAAmC,CAC3C,CAAA"}

package/dist/api/entity/department.d.ts

@@ -1,99 +1 @@
-import * as z from "zod";
-import { PluginApiReturn } from "../../types";
-/**
- * Department management — create and query departments.
- *
- * A **department** is a named, colored grouping applied to spaces.
- * Departments are used to categorize spaces by function (e.g. "FOH",
- * "Emergency", "Residential") and control their visual appearance.
- *
- * Accessed via `snaptrude.entity.department`.
- */
-export declare abstract class PluginDepartmentApi {
-    constructor();
-    /**
-     * Create a new department.
-     *
-     * @param args - An object containing:
-     *   - {@linkcode PluginDepartmentCreateArgs.name args.name} — Display name
-     *   - {@linkcode PluginDepartmentCreateArgs.color args.color} — CSS hex color string (e.g. `"#b5e1dc"`)
-     * @returns A {@linkcode PluginDepartmentCreateResult} with the `departmentId`
-     *   of the created department
-     * @throws If department creation fails
-     *
-     * # Example
-     * ```ts
-     * const { departmentId } = await snaptrude.entity.department.create({
-     *   name: "Emergency",
-     *   color: "#f5e68b",
-     * })
-     * ```
-     */
-    abstract create(args: PluginDepartmentCreateArgs): PluginApiReturn<PluginDepartmentCreateResult>;
-    /**
-     * Get all departments in the current project.
-     *
-     * Returns every department including well-known ones (Default, Site, etc.)
-     * and user-created departments.
-     *
-     * @returns A {@linkcode PluginDepartmentGetAllResult} with a `departments` array
-     *
-     * # Example
-     * ```ts
-     * const { departments } = await snaptrude.entity.department.getAll()
-     * for (const dept of departments) {
-     *   console.log(dept.id, dept.name, dept.color)
-     * }
-     * ```
-     */
-    abstract getAll(): PluginApiReturn<PluginDepartmentGetAllResult>;
-}
-/**
- * Arguments for {@linkcode PluginDepartmentApi.create}.
- *
- * | Property | Type | Description |
- * |---|---|---|
- * | `name` | `string` | Display name of the department |
- * | `color` | `string` | CSS hex color string (e.g. `"#b5e1dc"`) |
- */
-export declare const PluginDepartmentCreateArgs: z.ZodObject<{
-    name: z.ZodString;
-    color: z.ZodString;
-}, z.core.$strip>;
-export type PluginDepartmentCreateArgs = z.infer<typeof PluginDepartmentCreateArgs>;
-/**
- * Result of {@linkcode PluginDepartmentApi.create}.
- *
- * | Property | Type | Description |
- * |---|---|---|
- * | `departmentId` | `string` | Unique ID of the created department |
- */
-export declare const PluginDepartmentCreateResult: z.ZodObject<{
-    departmentId: z.ZodString;
-}, z.core.$strip>;
-export type PluginDepartmentCreateResult = z.infer<typeof PluginDepartmentCreateResult>;
-/**
- * A single department entry returned by {@linkcode PluginDepartmentApi.getAll}.
- */
-export declare const PluginDepartmentEntry: z.ZodObject<{
-    id: z.ZodString;
-    name: z.ZodString;
-    color: z.ZodString;
-}, z.core.$strip>;
-export type PluginDepartmentEntry = z.infer<typeof PluginDepartmentEntry>;
-/**
- * Result of {@linkcode PluginDepartmentApi.getAll}.
- *
- * | Property | Type | Description |
- * |---|---|---|
- * | `departments` | {@linkcode PluginDepartmentEntry}`[]` | All departments in the project |
- */
-export declare const PluginDepartmentGetAllResult: z.ZodObject<{
-    departments: z.ZodArray<z.ZodObject<{
-        id: z.ZodString;
-        name: z.ZodString;
-        color: z.ZodString;
-    }, z.core.$strip>>;
-}, z.core.$strip>;
-export type PluginDepartmentGetAllResult = z.infer<typeof PluginDepartmentGetAllResult>;
 //# sourceMappingURL=department.d.ts.map

package/dist/api/entity/department.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"department.d.ts","sourceRoot":"","sources":["../../../src/api/entity/department.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAA;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAE7C;;;;;;;;GAQG;AACH,8BAAsB,mBAAmB;;IAGvC;;;;;;;;;;;;;;;;;OAiBG;aACa,MAAM,CACpB,IAAI,EAAE,0BAA0B,GAC/B,eAAe,CAAC,4BAA4B,CAAC;IAEhD;;;;;;;;;;;;;;;OAeG;aACa,MAAM,IAAI,eAAe,CAAC,4BAA4B,CAAC;CACxE;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,0BAA0B;;;iBAGrC,CAAA;AAEF,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAC9C,OAAO,0BAA0B,CAClC,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,4BAA4B;;iBAEvC,CAAA;AAEF,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAChD,OAAO,4BAA4B,CACpC,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,qBAAqB;;;;iBAIhC,CAAA;AAEF,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAA;AAEzE;;;;;;GAMG;AACH,eAAO,MAAM,4BAA4B;;;;;;iBAEvC,CAAA;AAEF,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAChD,OAAO,4BAA4B,CACpC,CAAA"}
+{"version":3,"file":"department.d.ts","sourceRoot":"","sources":["../../../src/api/entity/department.ts"],"names":[],"mappings":""}

package/dist/api/entity/index.d.ts

@@ -1,32 +1,27 @@
 import { PluginBuildableEnvelopeApi } from "./buildableEnvelope";
-import { PluginDepartmentApi } from "./department";
 import { PluginReferenceLineApi } from "./referenceLine";
-import { PluginSpaceApi } from "./space";
 import { PluginStoryApi } from "./story";
 /**
  * CRUD operations on Snaptrude building entities.
  *
- * - {@linkcode PluginEntityApi.space} — Create, query, and delete spaces (rooms/masses)
  * - {@linkcode PluginEntityApi.story} — Create, query, and update stories (floors)
  * - {@linkcode PluginEntityApi.referenceLine} — Create, query, and delete reference lines
- * - {@linkcode PluginEntityApi.department} — Create and query departments
  * - {@linkcode PluginEntityApi.buildableEnvelope} — Create or update parametric buildable envelopes
+ *
+ * Space operations moved to `design.create.spaces` / `design.update.*` /
+ * `design.query.*` / `design.delete.entities` (the `entity.space` API was removed);
+ * `./space` still exports the shared space value types.
  */
 export declare abstract class PluginEntityApi {
-    /** Space (room/mass) operations. See {@linkcode PluginSpaceApi}. */
-    abstract space: PluginSpaceApi;
     /** Story (floor/storey) operations. See {@linkcode PluginStoryApi}. */
     abstract story: PluginStoryApi;
     /** Reference line operations. See {@linkcode PluginReferenceLineApi}. */
     abstract referenceLine: PluginReferenceLineApi;
-    /** Department operations. See {@linkcode PluginDepartmentApi}. */
-    abstract department: PluginDepartmentApi;
     /** Buildable Envelope operations. See {@linkcode PluginBuildableEnvelopeApi}. */
     abstract buildableEnvelope: PluginBuildableEnvelopeApi;
     constructor();
 }
 export * from "./buildableEnvelope";
-export * from "./department";
 export * from "./referenceLine";
 export * from "./space";
 export * from "./story";

package/dist/api/entity/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/api/entity/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,MAAM,qBAAqB,CAAA;AAChE,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAA;AAClD,OAAO,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAA;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AACxC,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AAExC;;;;;;;;GAQG;AACH,8BAAsB,eAAe;IACnC,oEAAoE;IACpE,SAAgB,KAAK,EAAE,cAAc,CAAA;IACrC,uEAAuE;IACvE,SAAgB,KAAK,EAAE,cAAc,CAAA;IACrC,yEAAyE;IACzE,SAAgB,aAAa,EAAE,sBAAsB,CAAA;IACrD,kEAAkE;IAClE,SAAgB,UAAU,EAAE,mBAAmB,CAAA;IAC/C,iFAAiF;IACjF,SAAgB,iBAAiB,EAAE,0BAA0B,CAAA;;CAG9D;AAED,cAAc,qBAAqB,CAAA;AACnC,cAAc,cAAc,CAAA;AAC5B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,SAAS,CAAA;AACvB,cAAc,SAAS,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/api/entity/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,MAAM,qBAAqB,CAAA;AAChE,OAAO,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAA;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AAExC;;;;;;;;;;GAUG;AACH,8BAAsB,eAAe;IACnC,uEAAuE;IACvE,SAAgB,KAAK,EAAE,cAAc,CAAA;IACrC,yEAAyE;IACzE,SAAgB,aAAa,EAAE,sBAAsB,CAAA;IACrD,iFAAiF;IACjF,SAAgB,iBAAiB,EAAE,0BAA0B,CAAA;;CAG9D;AAED,cAAc,qBAAqB,CAAA;AACnC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,SAAS,CAAA;AACvB,cAAc,SAAS,CAAA"}