@snaptrude/plugin-core 0.3.0 → 0.6.0

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

@@ -1,193 +1,14 @@
 import * as z from "zod";
-import { PluginApiReturn } from "../../types";
 /**
- * Space (room/mass) management — create, query, and delete spaces.
- *
- * A **space** is a 3D volume representing a room or mass in the
- * Snaptrude scene. Spaces live on a particular story and carry
- * properties such as name, area, department, and room type.
- *
- * All methods are **host API calls** that return Promises and support
- * undo/redo via Snaptrude's command system.
- *
- * Accessed via `snaptrude.entity.space`.
- */
-export declare abstract class PluginSpaceApi {
-    constructor();
-    /**
-     * Create a rectangular (box) space.
-     *
-     * Generates an axis-aligned box with the given dimensions at the
-     * specified position. The created space is automatically assigned
-     * to the active story and a default department.
-     *
-     * @param args - An object containing:
-     *   - {@linkcode PluginSpaceCreateRectangularArgs.position args.position} — Origin
-     *     position as a {@linkcode PVec3} in Babylon units
-     *   - {@linkcode PluginSpaceCreateRectangularArgs.dimensions args.dimensions} — Box
-     *     dimensions `{ width, height, depth }` in Babylon units
-     * @returns A {@linkcode PluginSpaceCreateRectangularResult} with the `spaceId`
-     *   of the created space
-     * @throws If space creation fails
-     *
-     * # Example
-     * ```ts
-     * const { vec3 } = snaptrude.core.math
-     *
-     * const { spaceId } = await snaptrude.entity.space.createRectangular({
-     *   position: vec3.new(0, 0, 0),
-     *   dimensions: { width: 5, height: 3, depth: 4 },
-     * })
-     * ```
-     */
-    abstract createRectangular({ position, dimensions, }: PluginSpaceCreateRectangularArgs): PluginApiReturn<PluginSpaceCreateRectangularResult>;
-    /**
-     * Create a space by extruding a 2D profile.
-     *
-     * The {@linkcode PluginSpaceCreateFromProfileArgs.profile profile} is extruded
-     * upward (along the Y axis) by {@linkcode PluginSpaceCreateFromProfileArgs.extrudeHeight
-     * extrudeHeight}, then offset by {@linkcode PluginSpaceCreateFromProfileArgs.position
-     * position}. The created space is automatically assigned to the active story
-     * and a default department.
-     *
-     * Use {@linkcode PluginProfileApi.fromLinePoints} to quickly build a profile
-     * from a list of points.
-     *
-     * @param args - An object containing:
-     *   - {@linkcode PluginSpaceCreateFromProfileArgs.profile args.profile} — A closed
-     *     {@linkcode PProfile} defining the floor shape
-     *   - {@linkcode PluginSpaceCreateFromProfileArgs.extrudeHeight args.extrudeHeight} —
-     *     Extrusion height in Babylon units
-     *   - {@linkcode PluginSpaceCreateFromProfileArgs.position args.position} — Offset
-     *     position as a {@linkcode PVec3} in Babylon units
-     * @returns A {@linkcode PluginSpaceCreateFromProfileResult} with the `spaceId`
-     *   of the created space
-     * @throws If the profile is invalid or mesh creation fails
-     *
-     * # Example
-     * ```ts
-     * const { vec3 } = snaptrude.core.math
-     *
-     * const profile = await snaptrude.core.geom.profile.fromLinePoints({
-     *   points: [
-     *     vec3.new(0, 0, 0),
-     *     vec3.new(10, 0, 0),
-     *     vec3.new(10, 0, 8),
-     *     vec3.new(0, 0, 8),
-     *   ],
-     * })
-     *
-     * const { spaceId } = await snaptrude.entity.space.createFromProfile({
-     *   profile,
-     *   extrudeHeight: 3,
-     *   position: vec3.new(0, 0, 0),
-     * })
-     * ```
-     */
-    abstract createFromProfile({ profile, extrudeHeight, position, }: PluginSpaceCreateFromProfileArgs): PluginApiReturn<PluginSpaceCreateFromProfileResult>;
-    /**
-     * Get the IDs of all spaces in the current project.
-     *
-     * Returns every space (mass that is not a building) across all stories.
-     * Use the returned IDs with {@linkcode PluginSpaceApi.get} to query
-     * individual space properties.
-     *
-     * @returns A {@linkcode PluginSpaceGetAllResult} with a `spacesIds` array
-     *
-     * # Example
-     * ```ts
-     * const { spacesIds } = await snaptrude.entity.space.getAll()
-     * console.log(`Project has ${spacesIds.length} spaces`)
-     * ```
-     */
-    abstract getAll(): PluginApiReturn<PluginSpaceGetAllResult>;
-    /**
-     * Get properties of a space by its ID.
-     *
-     * Only the properties listed in {@linkcode PluginSpaceGetArgs.properties
-     * args.properties} are returned — unlisted properties will be `undefined`
-     * in the result.
-     *
-     * @param args - An object containing:
-     *   - {@linkcode PluginSpaceGetArgs.spaceId args.spaceId} — The unique space ID
-     *     (as returned by creation methods or {@linkcode PluginSpaceApi.getAll})
-     *   - {@linkcode PluginSpaceGetArgs.properties args.properties} — Array of property
-     *     names to retrieve. See {@linkcode PluginSpaceGetProperty} for available values.
-     * @returns A partial {@linkcode PluginSpaceGetResult} containing only the requested
-     *   properties
-     * @throws If the space does not exist or the component is not a space/mass
-     *
-     * # Example
-     * ```ts
-     * const info = await snaptrude.entity.space.get({
-     *   spaceId: "some-space-id",
-     *   properties: ["name", "area", "position"],
-     * })
-     * console.log(info.name, info.area, info.position)
-     * ```
-     */
-    abstract get({ spaceId, properties, }: PluginSpaceGetArgs): PluginApiReturn<PluginSpaceGetResult>;
-    /**
-     * Delete a space by its ID.
-     *
-     * Permanently removes the space and its associated mesh from the scene.
-     * This operation is undoable via Snaptrude's command system.
-     *
-     * @param args - An object containing:
-     *   - {@linkcode PluginSpaceDeleteArgs.spaceId args.spaceId} — The unique space ID
-     *     to delete
-     * @throws If the space does not exist or the component is not a space/mass
-     *
-     * # Example
-     * ```ts
-     * await snaptrude.entity.space.delete({ spaceId: "some-space-id" })
-     * ```
-     */
-    abstract delete({ spaceId, }: PluginSpaceDeleteArgs): PluginApiReturn<PluginSpaceDeleteResult>;
-    /**
-     * Update properties of a space by its ID.
-     *
-     * Only the properties provided in {@linkcode PluginSpaceUpdateArgs.properties
-     * args.properties} will be updated — omitted properties remain unchanged.
-     * This operation is undoable via Snaptrude's command system.
-     *
-     * @param args - An object containing:
-     *   - {@linkcode PluginSpaceUpdateArgs.spaceId args.spaceId} — The unique space ID
-     *     to update
-     *   - {@linkcode PluginSpaceUpdateArgs.properties args.properties} — Key/value pairs
-     *     of properties to update. See {@linkcode PluginSpaceUpdateArgs} for supported fields.
-     * @returns A {@linkcode PluginSpaceUpdateResult} echoing back the `spaceId` and
-     *   the updated property values
-     * @throws If the space does not exist or the component is not a space/mass
-     *
-     * # Example
-     * ```ts
-     * const result = await snaptrude.entity.space.update({
-     *   spaceId: "some-space-id",
-     *   properties: {
-     *     room_type: "Kitchen",
-     *     massType: "Room",
-     *     departmentId: "CORE",
-     *   },
-     * })
-     * ```
-     */
-    abstract update(args: PluginSpaceUpdateArgs): PluginApiReturn<PluginSpaceUpdateResult>;
-}
-/**
- * Arguments for {@linkcode PluginSpaceApi.createRectangular}.
+ * Arguments for `createRectangular`.
  *
  * | Property | Type | Description |
  * |---|---|---|
- * | `position` | {@linkcode PVec3} | Origin position in Babylon units |
+ * | `position` | {@linkcode Vec3Handle} | Origin position in Babylon units |
  * | `dimensions` | `{ width, height, depth }` | Box dimensions in Babylon units |
  */
 export declare const PluginSpaceCreateRectangularArgs: z.ZodObject<{
-    position: z.ZodObject<{
-        x: z.ZodNumber;
-        y: z.ZodNumber;
-        z: z.ZodNumber;
-    }, z.core.$strip>;
+    position: z.ZodPipe<z.ZodString, z.ZodTransform<import("../..").Handle<"vec3">, string>>;
     dimensions: z.ZodObject<{
         width: z.ZodNumber;
         height: z.ZodNumber;
@@ -196,7 +17,7 @@ export declare const PluginSpaceCreateRectangularArgs: z.ZodObject<{
 }, z.core.$strip>;
 export type PluginSpaceCreateRectangularArgs = z.infer<typeof PluginSpaceCreateRectangularArgs>;
 /**
- * Result of {@linkcode PluginSpaceApi.createRectangular}.
+ * Result of `createRectangular`.
  *
  * | Property | Type | Description |
  * |---|---|---|
@@ -207,62 +28,24 @@ export declare const PluginSpaceCreateRectangularResult: z.ZodObject<{
 }, z.core.$strip>;
 export type PluginSpaceCreateRectangularResult = z.infer<typeof PluginSpaceCreateRectangularResult>;
 /**
- * Arguments for {@linkcode PluginSpaceApi.createFromProfile}.
+ * Arguments for `createFromProfile`.
  *
  * | Property | Type | Description |
  * |---|---|---|
- * | `profile` | {@linkcode PProfile} | Closed 2D profile defining the floor shape |
+ * | `profile` | {@linkcode ProfileHandle} | Handle to a closed 2D profile (the outer floor shape) |
+ * | `innerProfiles` | {@linkcode ProfileHandle}`[]` | Optional profile handles to subtract as holes |
  * | `extrudeHeight` | `number` | Extrusion height in Babylon units |
- * | `position` | {@linkcode PVec3} | Offset position in Babylon units |
+ * | `position` | {@linkcode Vec3Handle} | Offset position in Babylon units |
  */
 export declare const PluginSpaceCreateFromProfileArgs: z.ZodObject<{
-    profile: z.ZodObject<{
-        curves: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
-            curveType: z.ZodLiteral<"Line">;
-            startPoint: z.ZodObject<{
-                x: z.ZodNumber;
-                y: z.ZodNumber;
-                z: z.ZodNumber;
-            }, z.core.$strip>;
-            endPoint: z.ZodObject<{
-                x: z.ZodNumber;
-                y: z.ZodNumber;
-                z: z.ZodNumber;
-            }, z.core.$strip>;
-        }, z.core.$strip>, z.ZodObject<{
-            curveType: z.ZodLiteral<"Arc">;
-            startPoint: z.ZodObject<{
-                x: z.ZodNumber;
-                y: z.ZodNumber;
-                z: z.ZodNumber;
-            }, z.core.$strip>;
-            endPoint: z.ZodObject<{
-                x: z.ZodNumber;
-                y: z.ZodNumber;
-                z: z.ZodNumber;
-            }, z.core.$strip>;
-            centrePoint: z.ZodObject<{
-                x: z.ZodNumber;
-                y: z.ZodNumber;
-                z: z.ZodNumber;
-            }, z.core.$strip>;
-            axis: z.ZodObject<{
-                x: z.ZodNumber;
-                y: z.ZodNumber;
-                z: z.ZodNumber;
-            }, z.core.$strip>;
-        }, z.core.$strip>], "curveType">>;
-    }, z.core.$strip>;
+    profile: z.ZodPipe<z.ZodString, z.ZodTransform<import("../..").Handle<"profile">, string>>;
+    innerProfiles: z.ZodOptional<z.ZodArray<z.ZodPipe<z.ZodString, z.ZodTransform<import("../..").Handle<"profile">, string>>>>;
     extrudeHeight: z.ZodNumber;
-    position: z.ZodObject<{
-        x: z.ZodNumber;
-        y: z.ZodNumber;
-        z: z.ZodNumber;
-    }, z.core.$strip>;
+    position: z.ZodPipe<z.ZodString, z.ZodTransform<import("../..").Handle<"vec3">, string>>;
 }, z.core.$strip>;
 export type PluginSpaceCreateFromProfileArgs = z.infer<typeof PluginSpaceCreateFromProfileArgs>;
 /**
- * Result of {@linkcode PluginSpaceApi.createFromProfile}.
+ * Result of `createFromProfile`.
  *
  * | Property | Type | Description |
  * |---|---|---|
@@ -272,6 +55,32 @@ export declare const PluginSpaceCreateFromProfileResult: z.ZodObject<{
     spaceId: z.ZodString;
 }, z.core.$strip>;
 export type PluginSpaceCreateFromProfileResult = z.infer<typeof PluginSpaceCreateFromProfileResult>;
+/**
+ * Arguments for `updateGeometryFromProfile`.
+ *
+ * | Property | Type | Description |
+ * |---|---|---|
+ * | `spaceId` | `string` | Space to update |
+ * | `profile` | {@linkcode ProfileHandle} | Handle to the closed 2D profile defining the new floor shape |
+ * | `extrudeHeight` | `number` | New extrusion height in Babylon units |
+ */
+export declare const PluginSpaceUpdateGeometryFromProfileArgs: z.ZodObject<{
+    spaceId: z.ZodString;
+    profile: z.ZodPipe<z.ZodString, z.ZodTransform<import("../..").Handle<"profile">, string>>;
+    extrudeHeight: z.ZodNumber;
+}, z.core.$strip>;
+export type PluginSpaceUpdateGeometryFromProfileArgs = z.infer<typeof PluginSpaceUpdateGeometryFromProfileArgs>;
+/**
+ * Result of `updateGeometryFromProfile`.
+ *
+ * | Property | Type | Description |
+ * |---|---|---|
+ * | `spaceId` | `string` | Unique ID of the updated space |
+ */
+export declare const PluginSpaceUpdateGeometryFromProfileResult: z.ZodObject<{
+    spaceId: z.ZodString;
+}, z.core.$strip>;
+export type PluginSpaceUpdateGeometryFromProfileResult = z.infer<typeof PluginSpaceUpdateGeometryFromProfileResult>;
 /**
  * Available properties that can be queried on a space.
  *
@@ -300,39 +109,52 @@ export type PluginSpaceCreateFromProfileResult = z.infer<typeof PluginSpaceCreat
  * **Derived from mesh:**
  * | Value | Return Type | Description |
  * |---|---|---|
- * | `"position"` | {@linkcode PVec3} | Local position relative to parent |
- * | `"absolutePosition"` | {@linkcode PVec3} | Absolute position in the scene |
- * | `"rotation"` | {@linkcode PVec3} | Euler rotation angles (radians) |
- * | `"rotationQuaternion"` | {@linkcode PQuat} \| `null` | Quaternion rotation, or `null` if unset |
+ * | `"position"` | {@linkcode Vec3Components} | Local position relative to parent |
+ * | `"absolutePosition"` | {@linkcode Vec3Components} | Absolute position in the scene |
+ * | `"rotation"` | {@linkcode Vec3Components} | Euler rotation angles (radians) |
+ * | `"rotationQuaternion"` | {@linkcode QuatComponents} \| `null` | Quaternion rotation, or `null` if unset |
  *
  * **Derived from brep:**
  * | Value | Return Type | Description |
  * |---|---|---|
- * | `"planPoints"` | {@linkcode PVec3}`[]` | Bottom outer profile points in world space with `y = 0` (2D plan). No closing duplicate point. |
+ * | `"planPoints"` | {@linkcode Vec3Components}`[]` | Bottom outer profile points in world space with `y = 0` (2D plan). No closing duplicate point. |
+ * | `"profile"` | {@linkcode CurveHandle}`[]` | Bottom outer profile curves in world space, as opaque curve handles. Read coordinates via the `core.geom.curve` read API. |
+ * | `"innerProfiles"` | {@linkcode CurveHandle}`[][]` | Inner (hole) profile curve loops in world space — one loop per hole, `[]` when the space has none. Each curve is an opaque handle. |
+ * | `"innerPlanPoints"` | {@linkcode Vec3Components}`[][]` | Inner (hole) profile points in world space with `y = 0` — one loop per hole, no closing duplicate, `[]` when none. |
+ *
+ * **Derived from adjacency manager:**
+ * | Value | Return Type | Description |
+ * |---|---|---|
+ * | `"adjacency"` | `{ spaceId: string; value: number }[]` | Adjacency relationships to other spaces. `value`: `2` = Direct (required), `1` = Indirect or physical contact, `-1` = Restricted; `0` (no relationship) entries are filtered out. Empty when adjacency has never been computed — see `program.adjacency.compute`. |
  */
 export declare const PluginSpaceGetProperty: z.ZodEnum<{
-    name: "name";
-    departmentId: "departmentId";
-    id: "id";
+    profile: "profile";
+    type: "type";
     position: "position";
+    id: "id";
+    name: "name";
+    storey: "storey";
     height: "height";
     depth: "depth";
-    type: "type";
+    innerProfiles: "innerProfiles";
     room_type: "room_type";
     area: "area";
     breadth: "breadth";
     massType: "massType";
     spaceType: "spaceType";
-    storey: "storey";
+    areaClass: "areaClass";
+    departmentId: "departmentId";
     departmentName: "departmentName";
     departmentColor: "departmentColor";
     absolutePosition: "absolutePosition";
     rotation: "rotation";
     rotationQuaternion: "rotationQuaternion";
     planPoints: "planPoints";
+    innerPlanPoints: "innerPlanPoints";
+    adjacency: "adjacency";
 }>;
 /**
- * Arguments for {@linkcode PluginSpaceApi.get}.
+ * Arguments for `get`.
  *
  * | Property | Type | Description |
  * |---|---|---|
@@ -342,25 +164,30 @@ export declare const PluginSpaceGetProperty: z.ZodEnum<{
 export declare const PluginSpaceGetArgs: z.ZodObject<{
     spaceId: z.ZodString;
     properties: z.ZodArray<z.ZodEnum<{
-        name: "name";
-        departmentId: "departmentId";
-        id: "id";
+        profile: "profile";
+        type: "type";
         position: "position";
+        id: "id";
+        name: "name";
+        storey: "storey";
         height: "height";
         depth: "depth";
-        type: "type";
+        innerProfiles: "innerProfiles";
         room_type: "room_type";
         area: "area";
         breadth: "breadth";
         massType: "massType";
         spaceType: "spaceType";
-        storey: "storey";
+        areaClass: "areaClass";
+        departmentId: "departmentId";
         departmentName: "departmentName";
         departmentColor: "departmentColor";
         absolutePosition: "absolutePosition";
         rotation: "rotation";
         rotationQuaternion: "rotationQuaternion";
         planPoints: "planPoints";
+        innerPlanPoints: "innerPlanPoints";
+        adjacency: "adjacency";
     }>>;
 }, z.core.$strip>;
 export type PluginSpaceGetArgs = z.infer<typeof PluginSpaceGetArgs>;
@@ -394,8 +221,24 @@ export declare const PluginSpaceType: z.ZodEnum<{
     Envelope: "Envelope";
     Parking: "Parking";
 }>;
+/** The space-type value union (same-name type alias for positional signatures). */
+export type PluginSpaceType = z.infer<typeof PluginSpaceType>;
+/**
+ * Area-class classification of a space (mirrors the internal `AreaClass` enum).
+ *
+ * | Value | Description |
+ * |---|---|
+ * | `"NET"` | Net (usable) area |
+ * | `"GROSS"` | Gross area |
+ * | `"EXCLUDED"` | Excluded from area totals |
+ */
+export declare const PluginAreaClass: z.ZodEnum<{
+    NET: "NET";
+    GROSS: "GROSS";
+    EXCLUDED: "EXCLUDED";
+}>;
 /**
- * Result of {@linkcode PluginSpaceApi.get}.
+ * Result of `get`.
  *
  * A partial object — only the properties that were requested in
  * {@linkcode PluginSpaceGetArgs.properties} will be present.
@@ -422,6 +265,11 @@ export declare const PluginSpaceGetResult: z.ZodObject<{
         Envelope: "Envelope";
         Parking: "Parking";
     }>>>;
+    areaClass: z.ZodOptional<z.ZodEnum<{
+        NET: "NET";
+        GROSS: "GROSS";
+        EXCLUDED: "EXCLUDED";
+    }>>;
     storey: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
     departmentId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     departmentName: z.ZodOptional<z.ZodString>;
@@ -452,10 +300,21 @@ export declare const PluginSpaceGetResult: z.ZodObject<{
         y: z.ZodNumber;
         z: z.ZodNumber;
     }, z.core.$strip>>>;
+    profile: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodPipe<z.ZodString, z.ZodTransform<import("../..").Handle<"line">, string>>, z.ZodPipe<z.ZodString, z.ZodTransform<import("../..").Handle<"arc">, string>>]>>>;
+    innerProfiles: z.ZodOptional<z.ZodArray<z.ZodArray<z.ZodUnion<readonly [z.ZodPipe<z.ZodString, z.ZodTransform<import("../..").Handle<"line">, string>>, z.ZodPipe<z.ZodString, z.ZodTransform<import("../..").Handle<"arc">, string>>]>>>>;
+    innerPlanPoints: z.ZodOptional<z.ZodArray<z.ZodArray<z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+        z: z.ZodNumber;
+    }, z.core.$strip>>>>;
+    adjacency: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        spaceId: z.ZodString;
+        value: z.ZodNumber;
+    }, z.core.$strip>>>;
 }, z.core.$strip>;
 export type PluginSpaceGetResult = z.infer<typeof PluginSpaceGetResult>;
 /**
- * Result of {@linkcode PluginSpaceApi.getAll}.
+ * Result of `getAll`.
  *
  * | Property | Type | Description |
  * |---|---|---|
@@ -466,7 +325,7 @@ export declare const PluginSpaceGetAllResult: z.ZodObject<{
 }, z.core.$strip>;
 export type PluginSpaceGetAllResult = z.infer<typeof PluginSpaceGetAllResult>;
 /**
- * Arguments for {@linkcode PluginSpaceApi.delete}.
+ * Arguments for `delete`.
  *
  * | Property | Type | Description |
  * |---|---|---|
@@ -476,7 +335,7 @@ export declare const PluginSpaceDeleteArgs: z.ZodObject<{
     spaceId: z.ZodString;
 }, z.core.$strip>;
 export type PluginSpaceDeleteArgs = z.infer<typeof PluginSpaceDeleteArgs>;
-/** Result type for {@linkcode PluginSpaceApi.delete} — returns nothing on success. */
+/** Result type for `delete` — returns nothing on success. */
 export type PluginSpaceDeleteResult = void;
 /**
  * Supported mass type values for {@linkcode PluginSpaceUpdateArgs.properties.massType}.
@@ -512,6 +371,8 @@ export declare const PluginMassType: z.ZodEnum<{
     Mass: "Mass";
     Site: "Site";
 }>;
+/** The mass-type value union (same-name type alias for positional signatures). */
+export type PluginMassType = z.infer<typeof PluginMassType>;
 /**
  * Well-known (built-in) department IDs.
  *
@@ -538,8 +399,10 @@ export declare const PluginDepartmentId: z.ZodUnion<readonly [z.ZodEnum<{
     ENVELOPE: "ENVELOPE";
     CORE: "CORE";
 }>, z.ZodUUID]>;
+/** The department-id value union (same-name type alias for positional signatures). */
+export type PluginDepartmentId = z.infer<typeof PluginDepartmentId>;
 /**
- * Arguments for {@linkcode PluginSpaceApi.update}.
+ * Arguments for `update`.
  *
  * | Property | Type | Description |
  * |---|---|---|
@@ -579,6 +442,11 @@ export declare const PluginSpaceUpdateArgs: z.ZodObject<{
             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";
@@ -589,7 +457,7 @@ export declare const PluginSpaceUpdateArgs: z.ZodObject<{
 }, z.core.$strip>;
 export type PluginSpaceUpdateArgs = z.infer<typeof PluginSpaceUpdateArgs>;
 /**
- * Result of {@linkcode PluginSpaceApi.update}.
+ * Result of `update`.
  *
  * Echoes back the `spaceId` and the values of properties that were updated.
  * Properties that were not included in the update request will be `undefined`.
@@ -607,7 +475,372 @@ export declare const PluginSpaceUpdateResult: z.ZodObject<{
     room_type: z.ZodOptional<z.ZodString>;
     massType: z.ZodOptional<z.ZodString>;
     spaceType: z.ZodOptional<z.ZodString>;
+    areaClass: z.ZodOptional<z.ZodEnum<{
+        NET: "NET";
+        GROSS: "GROSS";
+        EXCLUDED: "EXCLUDED";
+    }>>;
     departmentId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
 }, z.core.$strip>;
 export type PluginSpaceUpdateResult = z.infer<typeof PluginSpaceUpdateResult>;
+/**
+ * A single item for `bulkCreate`.
+ *
+ * Discriminated on `kind`:
+ * - `"rectangular"` — a box defined by `position` + `dimensions` (mirrors
+ *   {@linkcode PluginSpaceCreateRectangularArgs})
+ * - `"profile"` — an extruded `profile` (with optional `innerProfiles`) by
+ *   `extrudeHeight` at `position` (mirrors {@linkcode PluginSpaceCreateFromProfileArgs})
+ *
+ * Every item may optionally set `room_type`, `spaceType`, `massType`, and
+ * `departmentId`; these are applied within the same single undo step as the
+ * creation.
+ */
+export declare const PluginSpaceBulkCreateItem: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"rectangular">;
+    position: z.ZodPipe<z.ZodString, z.ZodTransform<import("../..").Handle<"vec3">, string>>;
+    dimensions: z.ZodObject<{
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+        depth: z.ZodNumber;
+    }, z.core.$strip>;
+    room_type: z.ZodOptional<z.ZodString>;
+    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";
+    }>>;
+    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";
+    }>>;
+    departmentId: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<{
+        DEFAULT: "DEFAULT";
+        SITE: "SITE";
+        ENVELOPE: "ENVELOPE";
+        CORE: "CORE";
+    }>, z.ZodUUID]>>;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"profile">;
+    profile: z.ZodPipe<z.ZodString, z.ZodTransform<import("../..").Handle<"profile">, string>>;
+    innerProfiles: z.ZodOptional<z.ZodArray<z.ZodPipe<z.ZodString, z.ZodTransform<import("../..").Handle<"profile">, string>>>>;
+    extrudeHeight: z.ZodNumber;
+    position: z.ZodPipe<z.ZodString, z.ZodTransform<import("../..").Handle<"vec3">, string>>;
+    room_type: z.ZodOptional<z.ZodString>;
+    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";
+    }>>;
+    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";
+    }>>;
+    departmentId: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<{
+        DEFAULT: "DEFAULT";
+        SITE: "SITE";
+        ENVELOPE: "ENVELOPE";
+        CORE: "CORE";
+    }>, z.ZodUUID]>>;
+}, z.core.$strip>], "kind">;
+export type PluginSpaceBulkCreateItem = z.infer<typeof PluginSpaceBulkCreateItem>;
+/**
+ * Arguments for `bulkCreate`.
+ *
+ * | Property | Type | Description |
+ * |---|---|---|
+ * | `items` | {@linkcode PluginSpaceBulkCreateItem}`[]` | Spaces to create |
+ */
+export declare const PluginSpaceBulkCreateArgs: z.ZodObject<{
+    items: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"rectangular">;
+        position: z.ZodPipe<z.ZodString, z.ZodTransform<import("../..").Handle<"vec3">, string>>;
+        dimensions: z.ZodObject<{
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+            depth: z.ZodNumber;
+        }, z.core.$strip>;
+        room_type: z.ZodOptional<z.ZodString>;
+        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";
+        }>>;
+        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";
+        }>>;
+        departmentId: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<{
+            DEFAULT: "DEFAULT";
+            SITE: "SITE";
+            ENVELOPE: "ENVELOPE";
+            CORE: "CORE";
+        }>, z.ZodUUID]>>;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"profile">;
+        profile: z.ZodPipe<z.ZodString, z.ZodTransform<import("../..").Handle<"profile">, string>>;
+        innerProfiles: z.ZodOptional<z.ZodArray<z.ZodPipe<z.ZodString, z.ZodTransform<import("../..").Handle<"profile">, string>>>>;
+        extrudeHeight: z.ZodNumber;
+        position: z.ZodPipe<z.ZodString, z.ZodTransform<import("../..").Handle<"vec3">, string>>;
+        room_type: z.ZodOptional<z.ZodString>;
+        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";
+        }>>;
+        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";
+        }>>;
+        departmentId: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<{
+            DEFAULT: "DEFAULT";
+            SITE: "SITE";
+            ENVELOPE: "ENVELOPE";
+            CORE: "CORE";
+        }>, z.ZodUUID]>>;
+    }, z.core.$strip>], "kind">>;
+}, z.core.$strip>;
+export type PluginSpaceBulkCreateArgs = z.infer<typeof PluginSpaceBulkCreateArgs>;
+/**
+ * Result of `bulkCreate`.
+ *
+ * | Property | Type | Description |
+ * |---|---|---|
+ * | `spaceIds` | `string[]` | IDs of the created spaces, in input order |
+ */
+export declare const PluginSpaceBulkCreateResult: z.ZodObject<{
+    spaceIds: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+export type PluginSpaceBulkCreateResult = z.infer<typeof PluginSpaceBulkCreateResult>;
+/**
+ * A single item for `bulkUpdate`.
+ *
+ * Targets an existing space by `spaceId`. Geometry fields `profile` and
+ * `extrudeHeight` must be supplied **together** (mirrors
+ * {@linkcode PluginSpaceUpdateGeometryFromProfileArgs}). Property changes are
+ * nested under `properties`, mirroring {@linkcode PluginSpaceUpdateArgs}.
+ *
+ * | Property | Type | Description |
+ * |---|---|---|
+ * | `spaceId` | `string` | The space to update |
+ * | `profile` | {@linkcode ProfileHandle}`?` | New floor shape handle (requires `extrudeHeight`) |
+ * | `extrudeHeight` | `number?` | New extrusion height (requires `profile`) |
+ * | `properties` | `object?` | Property changes (same shape as {@linkcode PluginSpaceUpdateArgs.properties}) |
+ */
+export declare const PluginSpaceBulkUpdateItem: z.ZodObject<{
+    spaceId: z.ZodString;
+    profile: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<import("../..").Handle<"profile">, string>>>;
+    extrudeHeight: z.ZodOptional<z.ZodNumber>;
+    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>>;
+}, z.core.$strip>;
+export type PluginSpaceBulkUpdateItem = z.infer<typeof PluginSpaceBulkUpdateItem>;
+/**
+ * Arguments for `bulkUpdate`.
+ *
+ * | Property | Type | Description |
+ * |---|---|---|
+ * | `items` | {@linkcode PluginSpaceBulkUpdateItem}`[]` | Spaces to update |
+ */
+export declare const PluginSpaceBulkUpdateArgs: z.ZodObject<{
+    items: z.ZodArray<z.ZodObject<{
+        spaceId: z.ZodString;
+        profile: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<import("../..").Handle<"profile">, string>>>;
+        extrudeHeight: z.ZodOptional<z.ZodNumber>;
+        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>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type PluginSpaceBulkUpdateArgs = z.infer<typeof PluginSpaceBulkUpdateArgs>;
+/**
+ * Result of `bulkUpdate`.
+ *
+ * Echoes one {@linkcode PluginSpaceUpdateResult} per item, in input order —
+ * the same per-space shape returned by `update`.
+ *
+ * | Property | Type | Description |
+ * |---|---|---|
+ * | `spaces` | {@linkcode PluginSpaceUpdateResult}`[]` | Per-item updated values, in input order |
+ */
+export declare const PluginSpaceBulkUpdateResult: z.ZodObject<{
+    spaces: z.ZodArray<z.ZodObject<{
+        spaceId: z.ZodString;
+        room_type: z.ZodOptional<z.ZodString>;
+        massType: z.ZodOptional<z.ZodString>;
+        spaceType: z.ZodOptional<z.ZodString>;
+        areaClass: z.ZodOptional<z.ZodEnum<{
+            NET: "NET";
+            GROSS: "GROSS";
+            EXCLUDED: "EXCLUDED";
+        }>>;
+        departmentId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type PluginSpaceBulkUpdateResult = z.infer<typeof PluginSpaceBulkUpdateResult>;
+/**
+ * Arguments for `bulkDelete`.
+ *
+ * | Property | Type | Description |
+ * |---|---|---|
+ * | `spaceIds` | `string[]` | The space IDs to delete |
+ */
+export declare const PluginSpaceBulkDeleteArgs: z.ZodObject<{
+    spaceIds: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+export type PluginSpaceBulkDeleteArgs = z.infer<typeof PluginSpaceBulkDeleteArgs>;
+/**
+ * Result of `bulkDelete`.
+ *
+ * | Property | Type | Description |
+ * |---|---|---|
+ * | `deletedSpaceIds` | `string[]` | The space IDs that were removed |
+ */
+export declare const PluginSpaceBulkDeleteResult: z.ZodObject<{
+    deletedSpaceIds: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+export type PluginSpaceBulkDeleteResult = z.infer<typeof PluginSpaceBulkDeleteResult>;
 //# sourceMappingURL=space.d.ts.map