@snaptrude/plugin-core 0.2.9 → 0.5.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/api/design/query/index.ts"],"names":[],"mappings":"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"}

package/dist/api/design/query/spaces.d.ts

@@ -0,0 +1,221 @@
+import * as z from "zod";
+import { PluginApiReturn } from "../../../types";
+import { ComponentHandle, ContourHandle } from "../../../handles";
+/**
+ * `design.query.spaces.*` — space-specific reads (a space is a room mass).
+ *
+ * Only the space queries feasible against the engine today are exposed here.
+ * `getFloor` / `listBoundingWalls` (space↔wall topology) are deferred — they need
+ * engine work that does not exist yet. `listAdjacent` stays deferred because the
+ * shipped surfaces already answer it with value semantics: per-space via the
+ * `adjacency` field of `design.query.getProperties`, in bulk via
+ * `program.adjacency.getMatrix`.
+ *
+ * Accessed via `snaptrude.design.query.spaces`.
+ */
+export declare abstract class PluginDesignQuerySpacesApi {
+    constructor();
+    /**
+     * Get selected properties of a space — the selective multi-property read.
+     *
+     * Only the properties listed in `properties` are returned — unlisted
+     * properties will be `undefined` in the result. This is the canonical home of
+     * the read formerly at `entity.space.get` (now deprecated). Adjacency is not
+     * part of this read — it is an entity property: read it via the `adjacency`
+     * field of {@linkcode PluginDesignQueryApi.getProperties}.
+     *
+     * @param space - The space (room mass) to read
+     * @param properties - Array of property names to retrieve. See
+     *   {@linkcode PluginDesignQuerySpacesGetProperty} for available values.
+     * @returns A partial {@linkcode PluginDesignQuerySpacesGetResult} containing only
+     *   the requested properties
+     * @throws If the space does not exist or the component is not a space/mass
+     *
+     * @examplePrompt What is the area of this room?
+     * @examplePrompt Get the name, storey and height of the selected space
+     * @examplePrompt Which department does this room belong to?
+     * @examplePrompt Where is this space positioned on the plan?
+     * @examplePrompt Read the room type and dimensions of the selected room
+     *
+     * # Example
+     * ```ts
+     * const [space] = await snaptrude.design.query.listSpaces()
+     * const info = await snaptrude.design.query.spaces.get(space, ["name", "area", "position"])
+     * console.log(info.name, info.area, info.position)
+     * ```
+     */
+    abstract get(space: ComponentHandle, properties: PluginDesignQuerySpacesGetArgs["properties"]): PluginApiReturn<PluginDesignQuerySpacesGetResult>;
+    /**
+     * Get the **footprint** of a space — its bottom-face contour (outer profile +
+     * holes) as a reusable {@linkcode ContourHandle}. Equivalent to
+     * {@linkcode PluginDesignQueryGeometryApi.getBottomContour} narrowed to spaces.
+     *
+     * @param space - The space (room mass) to read
+     * @returns the footprint {@linkcode ContourHandle}, or `null` if the space has
+     *   no extractable footprint
+     *
+     * @examplePrompt Get the footprint of this room
+     * @examplePrompt Trace the floor outline of the selected space
+     * @examplePrompt What is the plan boundary of this room, including any holes?
+     * @examplePrompt Give me the base profile of the selected room mass
+     *
+     * # Example
+     * ```ts
+     * const [space] = await snaptrude.design.query.listSpaces()
+     * const footprint = await snaptrude.design.query.spaces.getFootprint(space)
+     * ```
+     */
+    abstract getFootprint(space: ComponentHandle): PluginApiReturn<ContourHandle | null>;
+}
+/**
+ * Arguments for {@linkcode PluginDesignQuerySpacesApi.getFootprint}.
+ *
+ * | Property | Type | Description |
+ * |---|---|---|
+ * | `space` | {@linkcode ComponentHandle} | The space (room mass) to read |
+ */
+export declare const PluginDesignQueryGetFootprintArgs: z.ZodObject<{
+    space: z.ZodPipe<z.ZodString, z.ZodTransform<ComponentHandle, string>>;
+}, z.core.$strip>;
+export type PluginDesignQueryGetFootprintArgs = z.infer<typeof PluginDesignQueryGetFootprintArgs>;
+/**
+ * Property names readable via {@linkcode PluginDesignQuerySpacesApi.get} — the
+ * legacy {@linkcode PluginSpaceGetProperty} set minus `"adjacency"` (adjacency is
+ * an entity property: see the `adjacency` field of
+ * {@linkcode PluginDesignQueryApi.getProperties}).
+ */
+export declare const PluginDesignQuerySpacesGetProperty: z.ZodEnum<{
+    profile: "profile";
+    type: "type";
+    position: "position";
+    id: "id";
+    name: "name";
+    height: "height";
+    depth: "depth";
+    innerProfiles: "innerProfiles";
+    room_type: "room_type";
+    area: "area";
+    breadth: "breadth";
+    massType: "massType";
+    spaceType: "spaceType";
+    areaClass: "areaClass";
+    storey: "storey";
+    departmentId: "departmentId";
+    departmentName: "departmentName";
+    departmentColor: "departmentColor";
+    absolutePosition: "absolutePosition";
+    rotation: "rotation";
+    rotationQuaternion: "rotationQuaternion";
+    planPoints: "planPoints";
+    innerPlanPoints: "innerPlanPoints";
+}>;
+export type PluginDesignQuerySpacesGetProperty = z.infer<typeof PluginDesignQuerySpacesGetProperty>;
+/**
+ * Arguments for {@linkcode PluginDesignQuerySpacesApi.get}.
+ *
+ * | Property | Type | Description |
+ * |---|---|---|
+ * | `space` | {@linkcode ComponentHandle} | The space (room mass) to read |
+ * | `properties` | {@linkcode PluginDesignQuerySpacesGetProperty}`[]` | Properties to retrieve |
+ */
+export declare const PluginDesignQuerySpacesGetArgs: z.ZodObject<{
+    space: z.ZodPipe<z.ZodString, z.ZodTransform<ComponentHandle, string>>;
+    properties: z.ZodArray<z.ZodEnum<{
+        profile: "profile";
+        type: "type";
+        position: "position";
+        id: "id";
+        name: "name";
+        height: "height";
+        depth: "depth";
+        innerProfiles: "innerProfiles";
+        room_type: "room_type";
+        area: "area";
+        breadth: "breadth";
+        massType: "massType";
+        spaceType: "spaceType";
+        areaClass: "areaClass";
+        storey: "storey";
+        departmentId: "departmentId";
+        departmentName: "departmentName";
+        departmentColor: "departmentColor";
+        absolutePosition: "absolutePosition";
+        rotation: "rotation";
+        rotationQuaternion: "rotationQuaternion";
+        planPoints: "planPoints";
+        innerPlanPoints: "innerPlanPoints";
+    }>>;
+}, z.core.$strip>;
+export type PluginDesignQuerySpacesGetArgs = z.infer<typeof PluginDesignQuerySpacesGetArgs>;
+/**
+ * Result of {@linkcode PluginDesignQuerySpacesApi.get} — the legacy
+ * {@linkcode PluginSpaceGetResult} record minus `adjacency`. Partial: only the
+ * requested properties are present.
+ */
+export declare const PluginDesignQuerySpacesGetResult: z.ZodObject<{
+    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>>]>>>;
+    type: z.ZodOptional<z.ZodString>;
+    position: z.ZodOptional<z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+        z: z.ZodNumber;
+    }, z.core.$strip>>;
+    id: z.ZodOptional<z.ZodString>;
+    name: z.ZodOptional<z.ZodString>;
+    height: z.ZodOptional<z.ZodNumber>;
+    depth: z.ZodOptional<z.ZodNumber>;
+    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>>]>>>>;
+    room_type: z.ZodOptional<z.ZodString>;
+    area: z.ZodOptional<z.ZodNumber>;
+    breadth: z.ZodOptional<z.ZodNumber>;
+    massType: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    spaceType: z.ZodOptional<z.ZodNullable<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";
+    }>>;
+    storey: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    departmentId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    departmentName: z.ZodOptional<z.ZodString>;
+    departmentColor: z.ZodOptional<z.ZodString>;
+    absolutePosition: z.ZodOptional<z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+        z: z.ZodNumber;
+    }, z.core.$strip>>;
+    rotation: z.ZodOptional<z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+        z: z.ZodNumber;
+    }, z.core.$strip>>;
+    rotationQuaternion: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+        z: z.ZodNumber;
+        w: z.ZodNumber;
+    }, z.core.$strip>>>;
+    planPoints: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+        z: z.ZodNumber;
+    }, z.core.$strip>>>;
+    innerPlanPoints: z.ZodOptional<z.ZodArray<z.ZodArray<z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+        z: z.ZodNumber;
+    }, z.core.$strip>>>>;
+}, z.core.$strip>;
+export type PluginDesignQuerySpacesGetResult = z.infer<typeof PluginDesignQuerySpacesGetResult>;
+//# sourceMappingURL=spaces.d.ts.map

package/dist/api/design/query/spaces.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spaces.d.ts","sourceRoot":"","sources":["../../../../src/api/design/query/spaces.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAA;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAChD,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAGjE;;;;;;;;;;;GAWG;AACH,8BAAsB,0BAA0B;;IAG9C;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;aACa,GAAG,CACjB,KAAK,EAAE,eAAe,EACtB,UAAU,EAAE,8BAA8B,CAAC,YAAY,CAAC,GACvD,eAAe,CAAC,gCAAgC,CAAC;IAEpD;;;;;;;;;;;;;;;;;;;OAmBG;aACa,YAAY,CAC1B,KAAK,EAAE,eAAe,GACrB,eAAe,CAAC,aAAa,GAAG,IAAI,CAAC;CACzC;AAED;;;;;;GAMG;AACH,eAAO,MAAM,iCAAiC;;iBAE5C,CAAA;AACF,MAAM,MAAM,iCAAiC,GAAG,CAAC,CAAC,KAAK,CACrD,OAAO,iCAAiC,CACzC,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,kCAAkC;;;;;;;;;;;;;;;;;;;;;;;;EACA,CAAA;AAC/C,MAAM,MAAM,kCAAkC,GAAG,CAAC,CAAC,KAAK,CACtD,OAAO,kCAAkC,CAC1C,CAAA;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAGzC,CAAA;AACF,MAAM,MAAM,8BAA8B,GAAG,CAAC,CAAC,KAAK,CAClD,OAAO,8BAA8B,CACtC,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,gCAAgC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAE3C,CAAA;AACF,MAAM,MAAM,gCAAgC,GAAG,CAAC,CAAC,KAAK,CACpD,OAAO,gCAAgC,CACxC,CAAA"}

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

@@ -0,0 +1,138 @@
+import * as z from "zod";
+import { PluginApiReturn } from "../../../types";
+import { ComponentHandle } from "../../../handles";
+import { PluginDesignChangeResult } from "../lock";
+/**
+ * `snaptrude.design.selection` — read and mutate the current scene selection.
+ *
+ * Selection targets are {@linkcode ComponentHandle}s. `get` is the one sanctioned
+ * `get`-returns-array accessor (§4.1(3)). The mutators (`set`/`add`/`remove`/`clear`)
+ * change the live selection and return the resulting selection snapshot — they are
+ * **not undoable** (the engine fires a selection listener, no command), so the
+ * returned {@linkcode PluginDesignChangeResult} is a committed-state snapshot.
+ */
+export declare abstract class PluginDesignSelectionApi {
+    constructor();
+    /**
+     * Read the current scene selection — the entities the user (or a previous
+     * call) has selected, returned as handles you can pass straight into other
+     * API calls.
+     *
+     * @returns The selection as {@linkcode ComponentHandle}`[]` (`[]` when nothing is selected)
+     *
+     * @examplePrompt What do I have selected right now?
+     * @examplePrompt List the currently selected objects
+     * @examplePrompt Which rooms are selected in the scene?
+     * @examplePrompt Get the ids of everything I've selected
+     * @examplePrompt Is anything selected?
+     *
+     * # Example
+     * ```ts
+     * // Selection handles feed straight into other API calls
+     * const selection = await snaptrude.design.selection.get()
+     * if (selection.length > 0) {
+     *   const props = await snaptrude.design.query.getProperties(selection[0])
+     * }
+     * ```
+     */
+    abstract get(): PluginApiReturn<ComponentHandle[]>;
+    /**
+     * Replace the selection with exactly the given entities — anything
+     * previously selected is deselected first, so afterwards only these
+     * entities are selected.
+     *
+     * @param components The entities to select
+     * @returns The resulting selection snapshot
+     *
+     * @examplePrompt Select these three walls
+     * @examplePrompt Select only the kitchen and deselect everything else
+     * @examplePrompt Change the selection to just these rooms
+     * @examplePrompt Highlight the spaces on the second storey
+     *
+     * # Example
+     * ```ts
+     * // Select only the ground-storey walls (replaces the previous selection)
+     * const walls = await snaptrude.design.query.listWalls({ storeys: [1] })
+     * const { affected } = await snaptrude.design.selection.set(walls)
+     * ```
+     */
+    abstract set(components: ComponentHandle[]): PluginApiReturn<PluginDesignChangeResult>;
+    /**
+     * Add entities to the current selection without deselecting anything — the
+     * selection grows to include the given entities alongside whatever was
+     * already selected.
+     *
+     * @param components The entities to add to the selection
+     * @returns The resulting selection snapshot
+     *
+     * @examplePrompt Add the corridor to my current selection
+     * @examplePrompt Select these columns too, keeping what's already selected
+     * @examplePrompt Also select the roof
+     * @examplePrompt Extend the selection to include all the doors on this floor
+     *
+     * # Example
+     * ```ts
+     * // Grow the selection to include every roof, keeping what's already selected
+     * const roofs = await snaptrude.design.query.listRoofs()
+     * await snaptrude.design.selection.add(roofs)
+     * ```
+     */
+    abstract add(components: ComponentHandle[]): PluginApiReturn<PluginDesignChangeResult>;
+    /**
+     * Remove entities from the current selection — the given entities are
+     * deselected while everything else stays selected.
+     *
+     * @param components The entities to remove from the selection
+     * @returns The resulting selection snapshot
+     *
+     * @examplePrompt Deselect the stair core but keep the rest selected
+     * @examplePrompt Remove these walls from my selection
+     * @examplePrompt Take the furniture out of the current selection
+     * @examplePrompt Unselect the two smaller rooms
+     *
+     * # Example
+     * ```ts
+     * // Deselect the furniture while keeping everything else selected
+     * const furniture = await snaptrude.design.query.listFurniture({ isSelected: true })
+     * await snaptrude.design.selection.remove(furniture)
+     * ```
+     */
+    abstract remove(components: ComponentHandle[]): PluginApiReturn<PluginDesignChangeResult>;
+    /**
+     * Clear the selection so nothing is selected (equivalent to `set([])`).
+     *
+     * @returns The resulting (empty) selection snapshot
+     *
+     * @examplePrompt Deselect everything
+     * @examplePrompt Clear my current selection
+     * @examplePrompt Unselect all objects in the scene
+     * @examplePrompt Make sure nothing is selected before we start
+     *
+     * # Example
+     * ```ts
+     * const { affected } = await snaptrude.design.selection.clear()
+     * // affected is the resulting selection — always [] here
+     * ```
+     */
+    abstract clear(): PluginApiReturn<PluginDesignChangeResult>;
+}
+/**
+ * Arguments for {@linkcode PluginDesignSelectionApi.set}.
+ *
+ * | Property | Type | Description |
+ * |---|---|---|
+ * | `components` | {@linkcode ComponentHandle}`[]` | The entities to select |
+ */
+export declare const PluginDesignSelectionSetArgs: z.ZodObject<{
+    components: z.ZodArray<z.ZodPipe<z.ZodString, z.ZodTransform<ComponentHandle, string>>>;
+}, z.core.$strip>;
+export type PluginDesignSelectionSetArgs = z.infer<typeof PluginDesignSelectionSetArgs>;
+export declare const PluginDesignSelectionAddArgs: z.ZodObject<{
+    components: z.ZodArray<z.ZodPipe<z.ZodString, z.ZodTransform<ComponentHandle, string>>>;
+}, z.core.$strip>;
+export type PluginDesignSelectionAddArgs = z.infer<typeof PluginDesignSelectionAddArgs>;
+export declare const PluginDesignSelectionRemoveArgs: z.ZodObject<{
+    components: z.ZodArray<z.ZodPipe<z.ZodString, z.ZodTransform<ComponentHandle, string>>>;
+}, z.core.$strip>;
+export type PluginDesignSelectionRemoveArgs = z.infer<typeof PluginDesignSelectionRemoveArgs>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/api/design/selection/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;;;;;;;;GAQG;AACH,8BAAsB,wBAAwB;;IAG5C;;;;;;;;;;;;;;;;;;;;;OAqBG;aACa,GAAG,IAAI,eAAe,CAAC,eAAe,EAAE,CAAC;IAEzD;;;;;;;;;;;;;;;;;;;OAmBG;aACa,GAAG,CAAC,UAAU,EAAE,eAAe,EAAE,GAAG,eAAe,CAAC,wBAAwB,CAAC;IAE7F;;;;;;;;;;;;;;;;;;;OAmBG;aACa,GAAG,CAAC,UAAU,EAAE,eAAe,EAAE,GAAG,eAAe,CAAC,wBAAwB,CAAC;IAE7F;;;;;;;;;;;;;;;;;;OAkBG;aACa,MAAM,CACpB,UAAU,EAAE,eAAe,EAAE,GAC5B,eAAe,CAAC,wBAAwB,CAAC;IAE5C;;;;;;;;;;;;;;;OAeG;aACa,KAAK,IAAI,eAAe,CAAC,wBAAwB,CAAC;CACnE;AAED;;;;;;GAMG;AACH,eAAO,MAAM,4BAA4B;;iBAEvC,CAAA;AACF,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAA;AAEvF,eAAO,MAAM,4BAA4B;;iBAA+B,CAAA;AACxE,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAA;AAEvF,eAAO,MAAM,+BAA+B;;iBAA+B,CAAA;AAC3E,MAAM,MAAM,+BAA+B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAA"}

package/dist/api/design/shared.d.ts

@@ -0,0 +1,38 @@
+import * as z from "zod";
+import { ComponentHandle } from "../../handles";
+/**
+ * Shared `design.*` operation return records (LLD Part A.3).
+ *
+ * `PluginDesignChangeResult` (`{ affected }`) is NOT here — it already lives in
+ * `./lock` and is reused verbatim by the transform/delete mutators.
+ *
+ * NOTE: `PluginMirrorAxis` currently lives in `./doors`; its relocation into this
+ * shared module is deferred to the transform wave (avoids a doors edit + a
+ * double-export while `design.transform` is unwired).
+ */
+/**
+ * Result of a CSG boolean op (`design.boolean.union/subtract/intersect`). Grounded
+ * in the engine `Boolean3dOperation.resultComponents { toCreate; toDelete }`:
+ * `created` are the result masses, `deleted` is every consumed input (for
+ * `subtract` this includes BOTH the target AND the tools). Errors throw (RPC
+ * rejects); no `Result<>` crosses the boundary.
+ */
+export declare const BooleanOutcome: z.ZodObject<{
+    created: z.ZodArray<z.ZodPipe<z.ZodString, z.ZodTransform<ComponentHandle, string>>>;
+    deleted: z.ZodArray<z.ZodPipe<z.ZodString, z.ZodTransform<ComponentHandle, string>>>;
+}, z.core.$strip>;
+export type BooleanOutcome = z.infer<typeof BooleanOutcome>;
+/**
+ * Result of `design.edit.offsetSplit` (migrated from `tools.offset`). `createdIds`
+ * are the components the offset produced; `deletedIds` are those a split-style
+ * offset removed. `offsetValue` is the engine's POST-clamp / post-sign applied
+ * distance — the only way a caller learns the actually-applied clamped distance
+ * (the shipped `tools.offset` result dropped it).
+ */
+export declare const OffsetSplitOutcome: z.ZodObject<{
+    createdIds: z.ZodArray<z.ZodPipe<z.ZodString, z.ZodTransform<ComponentHandle, string>>>;
+    deletedIds: z.ZodArray<z.ZodPipe<z.ZodString, z.ZodTransform<ComponentHandle, string>>>;
+    offsetValue: z.ZodNumber;
+}, z.core.$strip>;
+export type OffsetSplitOutcome = z.infer<typeof OffsetSplitOutcome>;
+//# sourceMappingURL=shared.d.ts.map

package/dist/api/design/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../../src/api/design/shared.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAA;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAE/C;;;;;;;;;GASG;AAEH;;;;;;GAMG;AACH,eAAO,MAAM,cAAc;;;iBAGzB,CAAA;AACF,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAA;AAE3D;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB;;;;iBAI7B,CAAA;AACF,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAA"}

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

@@ -0,0 +1,87 @@
+import * as z from "zod";
+import { PluginApiReturn } from "../../../types";
+import { ComponentHandle, Vec3Handle } from "../../../handles";
+import { PluginDesignChangeResult } from "../lock";
+/**
+ * `snaptrude.design.transform` — rigid transforms on scene entities.
+ *
+ * Migrated from the removed `tools.transform.*`. All ops are undoable and return
+ * {@linkcode PluginDesignChangeResult} `{ affected }`; failures throw (RPC rejects).
+ *
+ * `mirror` / `getPosition` / `setPosition` (and `scale`, an engine gap) are NOT in
+ * this surface yet — they are a later, non-migration pass.
+ */
+export declare abstract class PluginDesignTransformApi {
+    constructor();
+    /**
+     * Translate entities by a **relative** displacement vector (added to the first
+     * component's absolute position as the anchor). Undoable.
+     *
+     * @param components - Entities to move
+     * @param displacement - Relative translation as a {@linkcode Vec3Handle}
+     * @param options - `is2D`, `trackParentChange`
+     * @returns {@linkcode PluginDesignChangeResult}
+     *
+     * @examplePrompt Move the selected room 5 metres to the right
+     * @examplePrompt Shift these walls 3m along the x axis
+     * @examplePrompt Nudge this space 500mm north
+     * @examplePrompt Translate the furniture block by (10, 0, 5)
+     * @examplePrompt Move these masses up one storey
+     *
+     * # Example
+     * ```ts
+     * const { vec3 } = snaptrude.core.math
+     * await snaptrude.design.transform.move(["space-id"], vec3.new(10, 0, 0))
+     * ```
+     */
+    abstract move(components: ComponentHandle[], displacement: Vec3Handle, options?: {
+        is2D?: boolean;
+        trackParentChange?: boolean;
+    }): PluginApiReturn<PluginDesignChangeResult>;
+    /**
+     * Rotate entities by a **signed angle in DEGREES**, anchored at the combined
+     * bounding-box centre (positive = CCW about +Y). NOTE: unlike the removed
+     * `tools.transform.rotate` (radians + caller pivot), this canonical form takes
+     * DEGREES and has NO caller pivot — the pivot is always the bbox centre. Undoable.
+     *
+     * @param components - Entities to rotate
+     * @param angleInDegrees - Signed rotation angle in degrees
+     * @param options - `axis` (defaults to world +Y), `is2D`
+     * @returns {@linkcode PluginDesignChangeResult}
+     *
+     * @examplePrompt Rotate the selected building 90 degrees
+     * @examplePrompt Turn this room 45 degrees clockwise
+     * @examplePrompt Spin the furniture block 180 degrees about its centre
+     * @examplePrompt Rotate these masses 30 degrees around the vertical axis
+     *
+     * # Example
+     * ```ts
+     * await snaptrude.design.transform.rotate(["space-id"], 90)
+     * ```
+     */
+    abstract rotate(components: ComponentHandle[], angleInDegrees: number, options?: {
+        axis?: Vec3Handle;
+        is2D?: boolean;
+    }): PluginApiReturn<PluginDesignChangeResult>;
+}
+/**
+ * Arguments for {@linkcode PluginDesignTransformApi.move} (options flattened).
+ */
+export declare const PluginDesignMoveArgs: z.ZodObject<{
+    components: z.ZodArray<z.ZodPipe<z.ZodString, z.ZodTransform<ComponentHandle, string>>>;
+    displacement: z.ZodPipe<z.ZodString, z.ZodTransform<import("../../..").Handle<"vec3">, string>>;
+    is2D: z.ZodOptional<z.ZodBoolean>;
+    trackParentChange: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export type PluginDesignMoveArgs = z.infer<typeof PluginDesignMoveArgs>;
+/**
+ * Arguments for {@linkcode PluginDesignTransformApi.rotate} (options flattened).
+ */
+export declare const PluginDesignRotateArgs: z.ZodObject<{
+    components: z.ZodArray<z.ZodPipe<z.ZodString, z.ZodTransform<ComponentHandle, string>>>;
+    angleInDegrees: z.ZodNumber;
+    axis: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<import("../../..").Handle<"vec3">, string>>>;
+    is2D: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export type PluginDesignRotateArgs = z.infer<typeof PluginDesignRotateArgs>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/api/design/transform/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAA;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAChD,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAC9D,OAAO,EAAE,wBAAwB,EAAE,MAAM,SAAS,CAAA;AAElD;;;;;;;;GAQG;AACH,8BAAsB,wBAAwB;;IAG5C;;;;;;;;;;;;;;;;;;;;OAoBG;aACa,IAAI,CAClB,UAAU,EAAE,eAAe,EAAE,EAC7B,YAAY,EAAE,UAAU,EACxB,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,OAAO,CAAC;QAAC,iBAAiB,CAAC,EAAE,OAAO,CAAA;KAAE,GACxD,eAAe,CAAC,wBAAwB,CAAC;IAE5C;;;;;;;;;;;;;;;;;;;;OAoBG;aACa,MAAM,CACpB,UAAU,EAAE,eAAe,EAAE,EAC7B,cAAc,EAAE,MAAM,EACtB,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,UAAU,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE,GAC9C,eAAe,CAAC,wBAAwB,CAAC;CAC7C;AAED;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;;;iBAK/B,CAAA;AACF,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAA;AAEvE;;GAEG;AACH,eAAO,MAAM,sBAAsB;;;;;iBAKjC,CAAA;AACF,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAA"}