@snaptrude/plugin-core 0.8.0 → 0.9.1

package/dist/api/core/io/terrain/index.d.ts

@@ -158,6 +158,68 @@ export declare abstract class PluginCoreIoTerrainApi {
      * @examplePrompt Remove the satellite drape
      */
     abstract disableSatellite(): PluginApiReturn<void>;
+    /**
+     * Replace the terrain surface with a caller-supplied triangle mesh. Undoable
+     * (one step), and the replacement persists with the project.
+     *
+     * `positions` is a flat `[x, y, z, …]` array in **world space** — the same
+     * frame `design.query.geometry.getTriangulatedMeshes` reads — so a
+     * read-modify-write round trip needs no conversion. `indices` is a flat
+     * triangle list into `positions` (three indices per triangle). A
+     * predominantly down-facing surface is flipped automatically (reported in
+     * `warnings`), and zero-area sliver triangles are tolerated and counted.
+     *
+     * **What survives the replacement:** the datum, geolocation, opacity, lock
+     * state, and the elevation/satellite toggles. The map/satellite texture is
+     * re-projected onto the new surface from above (best effort — alignment is
+     * approximate, reported in `warnings`). **What resets:** cut/fill history
+     * and the earthwork report — the replaced surface starts with a clean
+     * grading slate.
+     *
+     * Limits: at most 500,000 triangles and 500,000 vertices; every coordinate
+     * must be finite and within the scene bound.
+     *
+     * @param positions - Flat `[x, y, z, …]` world-space vertex positions.
+     * @param indices - Flat triangle list into `positions`.
+     * @param units - `"world"` (default): coordinates are raw internal units;
+     *   `"meters"`: coordinates are metres and are converted on the way in.
+     * @param options - Optional {@linkcode PluginTerrainReplaceMeshOptions}:
+     *   optimistic-concurrency expectations (`expectedTerrain`,
+     *   `expectedModelRevision`), `preserve` opt-outs, idempotent replay via
+     *   `clientMutationId`, and the `coordinateSpace`/`baseline` declarations.
+     * @throws if writes are disabled, there is no terrain (import one first),
+     *   the terrain is **locked**, the mesh fails validation (non-finite or
+     *   out-of-bound coordinates, bad indices, degenerate-only geometry, over
+     *   the size caps), `expectedTerrain` does not match the live terrain, or
+     *   `expectedModelRevision` is stale.
+     *
+     * @examplePrompt Replace the terrain with this surveyed mesh
+     * @examplePrompt Flatten a building pad into the site surface
+     * @examplePrompt Load a custom DEM surface onto the terrain
+     * @examplePrompt Regrade the terrain from these points
+     *
+     * # Example
+     * ```ts
+     * // Projects with no terrain yet: import first, then replace.
+     * if (!(await snaptrude.core.io.terrain.exists())) {
+     *   await snaptrude.core.io.import.terrain(40.7128, -74.006, 300, 300)
+     * }
+     * const result = await snaptrude.core.io.terrain.replaceMesh(
+     *   positions, // [x0, y0, z0, x1, y1, z1, …] — world space
+     *   indices,   // [a0, b0, c0, a1, b1, c1, …]
+     *   "meters",
+     *   {
+     *     coordinateSpace: "world",
+     *     expectedTerrain: await snaptrude.core.io.terrain.get(),
+     *     baseline: "make-replacement-original",
+     *     preserve: { datum: true, geolocation: true, satellite: true, material: true },
+     *     clientMutationId: "survey-2026-08-05-r1",
+     *   },
+     * )
+     * // result.modelRevision — pass back as expectedModelRevision on the next call
+     * ```
+     */
+    abstract replaceMesh(positions: number[], indices: number[], units?: "world" | "meters", options?: PluginTerrainReplaceMeshOptions): PluginApiReturn<PluginTerrainReplaceMeshResult>;
     /** Read the terrain opacity, `0`..`1`, or `null` if no terrain. */
     abstract getOpacity(): PluginApiReturn<number | null>;
     /**
@@ -193,6 +255,76 @@ export declare const TerrainReport: z.ZodObject<{
     netVolume: z.ZodNumber;
 }, z.core.$strip>;
 export type TerrainReport = z.infer<typeof TerrainReport>;
+/**
+ * Result of {@link PluginCoreIoTerrainApi.replaceMesh}.
+ *
+ * | Property | Type | Description |
+ * |---|---|---|
+ * | `terrain` | `TerrainHandle` | The terrain (unchanged singleton handle) |
+ * | `modelRevision` | `number` | Session-scoped terrain-mesh revision after this replace — pass back as `expectedModelRevision` for compare-and-swap semantics |
+ * | `vertexCount` | `number` | Vertices in the applied mesh |
+ * | `triangleCount` | `number` | Triangles in the applied mesh |
+ * | `warnings` | `string[]` | Non-fatal notes: winding flipped, sliver triangles, approximate texture re-projection |
+ */
+export type PluginTerrainReplaceMeshResult = {
+    terrain: TerrainHandle;
+    modelRevision: number;
+    vertexCount: number;
+    triangleCount: number;
+    warnings: string[];
+};
+/**
+ * Options for {@link PluginCoreIoTerrainApi.replaceMesh}.
+ *
+ * | Property | Type | Description |
+ * |---|---|---|
+ * | `coordinateSpace` | `"world"`? | Declares the input frame. `world` is the only supported space (the same frame `getTriangulatedMeshes` reads) |
+ * | `expectedTerrain` | `TerrainHandle`? | Optimistic check: throws `HANDLE_INVALID` if the live terrain is not this handle (session-scoped — handles do not survive reloads) |
+ * | `expectedModelRevision` | `number`? | Optimistic check against the session terrain-mesh revision (starts at `0`, increments per successful `replaceMesh`; the result returns the new value). Stale → `PRECONDITION_FAILED` with the current revision in `details` |
+ * | `baseline` | `"make-replacement-original"`? | Declares replacement semantics. This is the only (and default) behavior: the replacement becomes the persisted surface; the app's terrain Reset restores the original map heightmap as the escape hatch |
+ * | `preserve` | object? | Opt-outs, all defaulting `true`. `datum: false` resets the terrain transform (authored coordinates become the local frame). `satellite: false` switches the drape off after the replace. `material: false` skips texture re-projection — the whole surface takes the ground material. `geolocation: false` is rejected (`VALIDATION`): geolocation is always preserved in this version |
+ * | `clientMutationId` | `string`? | Session-scoped idempotency: a repeated call with the same id returns the original result without re-executing |
+ */
+export declare const PluginTerrainReplaceMeshOptions: z.ZodObject<{
+    coordinateSpace: z.ZodOptional<z.ZodLiteral<"world">>;
+    expectedTerrain: z.ZodOptional<z.ZodString>;
+    expectedModelRevision: z.ZodOptional<z.ZodNumber>;
+    baseline: z.ZodOptional<z.ZodLiteral<"make-replacement-original">>;
+    preserve: z.ZodOptional<z.ZodObject<{
+        datum: z.ZodOptional<z.ZodBoolean>;
+        geolocation: z.ZodOptional<z.ZodBoolean>;
+        satellite: z.ZodOptional<z.ZodBoolean>;
+        material: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strict>>;
+    clientMutationId: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type PluginTerrainReplaceMeshOptions = z.infer<typeof PluginTerrainReplaceMeshOptions>;
+/**
+ * Arguments for {@link PluginCoreIoTerrainApi.replaceMesh}. The caps are the
+ * plugin surface's explicit payload ceiling: 500k vertices / 500k triangles.
+ */
+export declare const PluginTerrainReplaceMeshArgs: z.ZodObject<{
+    positions: z.ZodArray<z.ZodNumber>;
+    indices: z.ZodArray<z.ZodNumber>;
+    units: z.ZodOptional<z.ZodEnum<{
+        meters: "meters";
+        world: "world";
+    }>>;
+    options: z.ZodOptional<z.ZodObject<{
+        coordinateSpace: z.ZodOptional<z.ZodLiteral<"world">>;
+        expectedTerrain: z.ZodOptional<z.ZodString>;
+        expectedModelRevision: z.ZodOptional<z.ZodNumber>;
+        baseline: z.ZodOptional<z.ZodLiteral<"make-replacement-original">>;
+        preserve: z.ZodOptional<z.ZodObject<{
+            datum: z.ZodOptional<z.ZodBoolean>;
+            geolocation: z.ZodOptional<z.ZodBoolean>;
+            satellite: z.ZodOptional<z.ZodBoolean>;
+            material: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strict>>;
+        clientMutationId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+}, z.core.$strip>;
+export type PluginTerrainReplaceMeshArgs = z.infer<typeof PluginTerrainReplaceMeshArgs>;
 /** Arguments for {@link PluginCoreIoTerrainApi.setDatum}. */
 export declare const PluginTerrainSetDatumArgs: z.ZodObject<{
     offset: z.ZodNumber;

package/dist/api/core/io/terrain/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/api/core/io/terrain/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAA;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAEnD;;;;;;;;;;;;;;;;GAgBG;AACH,8BAAsB,sBAAsB;;IAG1C;;;;;;;;;;;;;;OAcG;aACa,MAAM,IAAI,eAAe,CAAC,OAAO,CAAC;IAElD;;;;;;;;;OASG;aACa,GAAG,IAAI,eAAe,CAAC,aAAa,GAAG,IAAI,CAAC;IAE5D;;;;;;;;;;;OAWG;aACa,QAAQ,IAAI,eAAe,CAAC,MAAM,GAAG,IAAI,CAAC;IAE1D;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;aACa,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,eAAe,CAAC,IAAI,CAAC;IAE/D;;;;;;;;;;OAUG;aACa,MAAM,IAAI,eAAe,CAAC,IAAI,CAAC;IAE/C;;;;;;;;;;;;;;OAcG;aACa,SAAS,IAAI,eAAe,CAAC,aAAa,GAAG,IAAI,CAAC;IAElE,0EAA0E;aAC1D,kBAAkB,IAAI,eAAe,CAAC,OAAO,GAAG,IAAI,CAAC;IACrE;;;;;;;;OAQG;aACa,eAAe,IAAI,eAAe,CAAC,IAAI,CAAC;IACxD;;;;;;;;OAQG;aACa,gBAAgB,IAAI,eAAe,CAAC,IAAI,CAAC;IAEzD,gFAAgF;aAChE,kBAAkB,IAAI,eAAe,CAAC,OAAO,GAAG,IAAI,CAAC;IACrE;;;;;;;;OAQG;aACa,eAAe,IAAI,eAAe,CAAC,IAAI,CAAC;IACxD;;;;;;;;OAQG;aACa,gBAAgB,IAAI,eAAe,CAAC,IAAI,CAAC;IAEzD,mEAAmE;aACnD,UAAU,IAAI,eAAe,CAAC,MAAM,GAAG,IAAI,CAAC;IAC5D;;;;;;;;;;;;;;OAcG;aACa,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,CAAC,IAAI,CAAC;CACnE;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,aAAa;;;;iBAIxB,CAAA;AACF,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAA;AAEzD,6DAA6D;AAC7D,eAAO,MAAM,yBAAyB;;iBAA4C,CAAA;AAClF,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAA;AAEjF,+DAA+D;AAC/D,eAAO,MAAM,2BAA2B;;iBAAkD,CAAA;AAC1F,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/api/core/io/terrain/index.ts"],"names":[],"mappings":"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"}

package/dist/api/core/mode/index.d.ts

@@ -0,0 +1,99 @@
+import * as z from "zod";
+import { PluginApiReturn } from "../../../types";
+/**
+ * The editor's top-bar application modes — the tabs a user switches between
+ * while working on a project.
+ */
+export declare const PluginAppMode: z.ZodEnum<{
+    design: "design";
+    bim: "bim";
+    present: "present";
+    program: "program";
+}>;
+export type PluginAppMode = z.infer<typeof PluginAppMode>;
+export declare const PluginCoreModeSetArgs: z.ZodObject<{
+    mode: z.ZodEnum<{
+        design: "design";
+        bim: "bim";
+        present: "present";
+        program: "program";
+    }>;
+}, z.core.$strip>;
+export type PluginCoreModeSetArgs = z.infer<typeof PluginCoreModeSetArgs>;
+export interface PluginCoreModeListResult {
+    modes: PluginAppMode[];
+}
+export interface PluginCoreModeSetResult {
+    mode: PluginAppMode;
+}
+/**
+ * Application-mode control — read and switch the editor's top-bar mode
+ * (Design, BIM, Present, Program), the same tabs a user clicks in the
+ * top menu bar. Accessed via `snaptrude.core.mode`.
+ *
+ * Not to be confused with the viewport's 2D/3D camera mode
+ * (`core.camera.setMode`) or saved presentation views (`presentation.views`).
+ *
+ * `set` covers `design`, `bim`, and `present` — in-page switches.
+ * `program` opens in its own browser tab in the product, which a plugin worker
+ * cannot do, so `set("program")` fails with `PRECONDITION_FAILED`; `get()`
+ * still reports `"program"` for code running in the Program tab.
+ */
+export declare abstract class PluginCoreModeApi {
+    constructor();
+    /**
+     * List every application mode the editor has.
+     *
+     * @returns The full set of mode tokens accepted by {@linkcode get} / {@linkcode set}.
+     *
+     * @examplePrompt What modes does Snaptrude have?
+     * @examplePrompt List the editor modes I can switch to
+     *
+     * # Example
+     * ```ts
+     * const { modes } = await snaptrude.core.mode.list()
+     * // ["design", "bim", "present", "program"]
+     * ```
+     */
+    abstract list(): PluginApiReturn<PluginCoreModeListResult>;
+    /**
+     * Get the currently active application mode.
+     *
+     * @returns The active mode token (e.g. `"design"`).
+     *
+     * @examplePrompt Which mode am I in right now?
+     * @examplePrompt Am I in present mode?
+     * @examplePrompt Check whether the editor is in BIM mode
+     *
+     * # Example
+     * ```ts
+     * const mode = await snaptrude.core.mode.get()
+     * if (mode !== "present") await snaptrude.core.mode.set("present")
+     * ```
+     */
+    abstract get(): PluginApiReturn<PluginAppMode>;
+    /**
+     * Switch the editor to another application mode — the same action as
+     * clicking that tab in the top menu bar.
+     *
+     * Supported: `"design"`, `"bim"`, `"present"`. Switching to
+     * `"program"` is rejected with `PRECONDITION_FAILED` (the Program surface
+     * opens in its own browser tab in the product; a plugin cannot open one).
+     *
+     * @param mode - Target mode token from {@linkcode PluginAppMode}
+     * @returns The committed `{ mode }` after the switch.
+     *
+     * @examplePrompt Switch to present mode
+     * @examplePrompt Open BIM mode
+     * @examplePrompt Go back to design mode
+     *
+     * # Example
+     * ```ts
+     * await snaptrude.core.mode.set("present")
+     * // ... presentation work ...
+     * await snaptrude.core.mode.set("design")
+     * ```
+     */
+    abstract set(mode: PluginAppMode): PluginApiReturn<PluginCoreModeSetResult>;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/api/core/mode/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/api/core/mode/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAA;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAEhD;;;GAGG;AACH,eAAO,MAAM,aAAa;;;;;EAAkD,CAAA;AAC5E,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAA;AAEzD,eAAO,MAAM,qBAAqB;;;;;;;iBAEhC,CAAA;AACF,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAA;AAEzE,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,aAAa,EAAE,CAAA;CACvB;AAED,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,aAAa,CAAA;CACpB;AAED;;;;;;;;;;;;GAYG;AACH,8BAAsB,iBAAiB;;IAGrC;;;;;;;;;;;;;OAaG;aACa,IAAI,IAAI,eAAe,CAAC,wBAAwB,CAAC;IAEjE;;;;;;;;;;;;;;OAcG;aACa,GAAG,IAAI,eAAe,CAAC,aAAa,CAAC;IAErD;;;;;;;;;;;;;;;;;;;;;OAqBG;aACa,GAAG,CAAC,IAAI,EAAE,aAAa,GAAG,eAAe,CAAC,uBAAuB,CAAC;CACnF"}

package/dist/api/core/storeys/index.d.ts

@@ -0,0 +1,251 @@
+import * as z from "zod";
+import { PluginApiReturn } from "../../../types";
+import { ComponentHandle } from "../../../handles";
+import { PluginStoryGetProperty, PluginStoryGetResult, PluginStoryCreateResult, PluginStoryUpdateResult, PluginStorySetActiveResult, PluginStoryDeleteResult, PluginStoryDuplicateResult } from "../../entity/story";
+/**
+ * Storey (floor) management.
+ *
+ * A storey represents a building floor in the Snaptrude project. Storeys are
+ * identified by their integer **storey value** (e.g. `1` for the ground floor,
+ * `2` for the first floor, `-1` for a basement).
+ *
+ * This is the canonical home for storey operations; it shares its implementation
+ * and schemas with the deprecated `entity.story` surface. All methods are **host
+ * API calls** that return Promises and support undo/redo via Snaptrude's command
+ * system (except {@linkcode PluginCoreStoreysApi.setActive}, a view change).
+ *
+ * Accessed via `snaptrude.core.storeys`.
+ */
+export declare abstract class PluginCoreStoreysApi {
+    constructor();
+    /**
+     * Get properties of a storey by its storey number.
+     *
+     * Only the properties listed in `properties` are returned — unlisted
+     * properties will be `undefined` in the result.
+     *
+     * @param storyValue - Integer storey number
+     *   (e.g. `1` for ground floor, `2` for first floor, `-1` for basement)
+     * @param properties - Array of property names to retrieve. See
+     *   {@linkcode PluginStoryGetProperty} for available values.
+     * @returns A partial {@linkcode PluginStoryGetResult} containing only the requested properties
+     * @throws If the storey with the given value does not exist
+     *
+     * @examplePrompt What is the height of the ground floor?
+     * @examplePrompt How many rooms are on the second storey?
+     * @examplePrompt Get the total floor area of level 3
+     * @examplePrompt Is the first floor hidden in the viewport?
+     * @examplePrompt Show me the name and height of storey 2
+     *
+     * # Example
+     * ```ts
+     * const info = await snaptrude.core.storeys.get(1, ["height", "name", "spacesCount"])
+     * console.log(info.name, info.height, info.spacesCount)
+     * ```
+     */
+    abstract get(storyValue: number, properties: PluginStoryGetProperty[]): PluginApiReturn<PluginStoryGetResult>;
+    /**
+     * List all storeys in the current project.
+     *
+     * Returns basic identification data for every storey. Storeys are sorted
+     * from **top to bottom** (highest storey value first).
+     *
+     * @returns A {@linkcode PluginCoreStoreysListResult} with a `storeys` array,
+     *   each entry containing `value`, `id`, and `name`
+     *
+     * @examplePrompt How many floors does this building have?
+     * @examplePrompt List all the storeys in the project
+     * @examplePrompt Show me every level with its name
+     * @examplePrompt Which storeys exist in this model?
+     *
+     * # Example
+     * ```ts
+     * const { storeys } = await snaptrude.core.storeys.list()
+     * for (const s of storeys) {
+     *   console.log(`Storey ${s.value}: ${s.name} (id: ${s.id})`)
+     * }
+     * ```
+     */
+    abstract list(): PluginApiReturn<PluginCoreStoreysListResult>;
+    /**
+     * Create a new storey (floor) in the project.
+     *
+     * The new storey is inserted at the position specified by `storyValue`. This
+     * operation is undoable.
+     *
+     * @param storyValue - Integer storey number
+     *   to create (e.g. `3` to add a third floor)
+     * @param height - Optional height in Babylon
+     *   units. If omitted, the project's default storey height is used.
+     * @returns A {@linkcode PluginStoryCreateResult} with `storyId` and `storyValue`
+     * @throws If a storey with the given value already exists or creation fails
+     *
+     * @examplePrompt Add a third floor to the building
+     * @examplePrompt Create a new storey above the second floor
+     * @examplePrompt Add a basement level to this project
+     * @examplePrompt Insert a new level with a custom floor height
+     *
+     * # Example
+     * ```ts
+     * // Create a new third floor with custom height
+     * const { storyId } = await snaptrude.core.storeys.create(3, 4.5)
+     * ```
+     */
+    abstract create(storyValue: number, height?: number): PluginApiReturn<PluginStoryCreateResult>;
+    /**
+     * Update a storey's floor-to-floor `height` and/or `name`.
+     *
+     * **Height** is the same operation as editing the height in the Storeys panel:
+     * the walls, columns, and masses on the storey are **stretched** to the new
+     * height, every storey **above shifts up/down** by the delta so the stack stays
+     * contiguous, and coupled elements (staircases, parametric curtain walls,
+     * furniture offsets) are re-fitted. The whole height cascade is committed as
+     * **one undo step**. Height-locked elements are left untouched.
+     *
+     * **Name** is the same as renaming the storey in the Storeys panel: it is
+     * persisted immediately but, mirroring the panel, is **not** part of the height
+     * undo step.
+     *
+     * At least one of `height` or `options.name` must be supplied. Omitting the
+     * `height` argument (e.g. for a rename-only update) leaves the height untouched.
+     *
+     * @param storyValue - Integer storey number identifying the storey to update
+     * @param height - New floor-to-floor height in
+     *   Babylon units. Omit to leave the height unchanged.
+     * @param options - `name` (new display name for the storey)
+     * @returns A {@linkcode PluginStoryUpdateResult} with the storey's
+     *   `storyValue`, `height`, and `name` after the update
+     * @throws `PRECONDITION_FAILED` if no storey has the given value;
+     *   `VALIDATION` if neither `height` nor `options.name` is supplied;
+     *   `STORY_HEIGHT_REJECTED` if the engine rejects the height;
+     *   `STORY_UPDATE_FAILED` if the storey cannot be re-read after the update
+     *
+     * @examplePrompt Change the ground floor height to 3.5 metres
+     * @examplePrompt Make the second storey taller
+     * @examplePrompt Rename the ground floor to "Lobby"
+     * @examplePrompt Set the floor-to-floor height of level 1
+     *
+     * # Example
+     * ```ts
+     * // Set ground floor height to 5 Babylon units — walls stretch and the
+     * // floors above move up to match, all in a single undo step.
+     * const result = await snaptrude.core.storeys.update(1, 5)
+     * // Rename only, leaving the height untouched.
+     * await snaptrude.core.storeys.update(1, undefined, { name: "Lobby" })
+     * ```
+     */
+    abstract update(storyValue: number, height?: number, options?: {
+        name?: string;
+    }): PluginApiReturn<PluginStoryUpdateResult>;
+    /**
+     * Make a storey the active storey — the same as clicking it in the storey/layer
+     * panel. Subsequent draws and creates target this storey, and in 2D the
+     * viewport switches to it. This is a view/navigation change: it is **not**
+     * undoable and commits nothing to the model.
+     *
+     * @param storyValue - Integer storey number to activate
+     * @returns A {@linkcode PluginStorySetActiveResult} echoing the now-active `storyValue`
+     * @throws `PRECONDITION_FAILED` if no storey has the given value
+     *
+     * @examplePrompt Switch to the second floor
+     * @examplePrompt Make the ground storey active
+     * @examplePrompt Go to the basement level
+     * @examplePrompt Set level 3 as the current storey
+     *
+     * # Example
+     * ```ts
+     * // Activate storey 2, then draw a wall — it lands on storey 2.
+     * await snaptrude.core.storeys.setActive(2)
+     * ```
+     */
+    abstract setActive(storyValue: number): PluginApiReturn<PluginStorySetActiveResult>;
+    /**
+     * Delete a storey and everything on it — the same as removing it from the
+     * storey panel. Every element placed on the storey (walls, floors, masses, …)
+     * is deleted with it, the remaining storeys are re-stacked, and the active
+     * storey falls back to an adjacent one. Committed as a single undo step.
+     *
+     * @param storyValue - Integer storey number to delete
+     * @returns A {@linkcode PluginStoryDeleteResult} with the deleted `storyValue`
+     *   and the `newActiveStory` the editor fell back to
+     * @throws `PRECONDITION_FAILED` if no storey has the given value; or if plugin
+     *   writes are disabled
+     *
+     * @examplePrompt Delete the top floor
+     * @examplePrompt Remove the basement level
+     * @examplePrompt Get rid of storey 3
+     * @examplePrompt Delete the second floor and everything on it
+     *
+     * # Example
+     * ```ts
+     * const { newActiveStory } = await snaptrude.core.storeys.delete(3)
+     * console.log(`Deleted storey 3; now on storey ${newActiveStory}`)
+     * ```
+     */
+    abstract delete(storyValue: number): PluginApiReturn<PluginStoryDeleteResult>;
+    /**
+     * Copy a storey into the adjacent level, up or down.
+     *
+     * By default the **whole storey** is copied: every eligible element on the
+     * active storey (walls, floors, roofs, masses, columns, beams, staircases,
+     * ceilings, parametric curtain walls, and furniture) is copied into the storey
+     * one level `"up"` or `"down"`. Pass `options.components` to copy only a subset
+     * instead. The target storey is **created automatically** if it does not yet
+     * exist, inheriting the source storey's height.
+     *
+     * Copies are **instanced** by default (`unique: false`) — they share geometry
+     * with the source, so later edits propagate. Set `unique: true` for independent
+     * geometry. Doors and windows are never copied on their own; they ride along
+     * with their host wall. Locked, throw-away, and unsupported elements are skipped
+     * and counted in `skipped`. The whole operation is a single undo step.
+     *
+     * @param direction - `"up"` to copy into the storey above, `"down"` for below
+     * @param options - `components` (restrict to a subset of the storey's elements;
+     *   omit for the whole storey) and `unique` (default `false` = instanced copies;
+     *   `true` = independent geometry)
+     * @returns A {@linkcode PluginStoryDuplicateResult} with the `sourceStory`, the
+     *   `targetStories` the copies landed on, the `created` component handles, the
+     *   `createdStoryValues` for any storeys generated to receive them, and the
+     *   `skipped` count of ineligible elements
+     * @throws `NO_ACTIVE_STRUCTURE` if there is no active structure to copy into;
+     *   `NO_ELIGIBLE_ELEMENTS` if nothing on the source storey (or in
+     *   `options.components`) is copyable; `HANDLE_INVALID` for a stale or foreign
+     *   supplied handle; or if plugin writes are disabled
+     *
+     * @examplePrompt Copy this floor to the storey above
+     * @examplePrompt Copy the ground floor down into a new basement
+     * @examplePrompt Repeat this level upwards with its own independent geometry
+     * @examplePrompt Copy just the selected walls onto the next floor up
+     *
+     * # Example
+     * ```ts
+     * // Copy the whole active storey one level up (instanced copies).
+     * const { targetStories, created, skipped } =
+     *   await snaptrude.core.storeys.copy("up")
+     * console.log(`Copied ${created.length} elements onto storey ${targetStories}`)
+     * if (skipped) console.log(`${skipped} elements were skipped`)
+     * ```
+     */
+    abstract copy(direction: "up" | "down", options?: {
+        components?: ComponentHandle[];
+        unique?: boolean;
+    }): PluginApiReturn<PluginStoryDuplicateResult>;
+}
+/**
+ * Result of {@linkcode PluginCoreStoreysApi.list} — the {@linkcode PluginStoryGetAllResult}
+ * shape with the array field renamed `stories` → `storeys`. Each entry shares the
+ * same element type: `{ value, id, name }`, sorted top to bottom.
+ *
+ * | Property | Type | Description |
+ * |---|---|---|
+ * | `storeys` | `Array<{ value, id, name }>` | All storeys, sorted top to bottom |
+ */
+export declare const PluginCoreStoreysListResult: z.ZodObject<{
+    storeys: z.ZodArray<z.ZodObject<{
+        value: z.ZodNumber;
+        id: z.ZodString;
+        name: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type PluginCoreStoreysListResult = z.infer<typeof PluginCoreStoreysListResult>;
+//# sourceMappingURL=index.d.ts.map

package/dist/api/core/storeys/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/api/core/storeys/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,EACL,sBAAsB,EACtB,oBAAoB,EAEpB,uBAAuB,EACvB,uBAAuB,EACvB,0BAA0B,EAC1B,uBAAuB,EACvB,0BAA0B,EAC3B,MAAM,oBAAoB,CAAA;AAE3B;;;;;;;;;;;;;GAaG;AACH,8BAAsB,oBAAoB;;IAGxC;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;aACa,GAAG,CACjB,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,sBAAsB,EAAE,GACnC,eAAe,CAAC,oBAAoB,CAAC;IAExC;;;;;;;;;;;;;;;;;;;;;OAqBG;aACa,IAAI,IAAI,eAAe,CAAC,2BAA2B,CAAC;IAEpE;;;;;;;;;;;;;;;;;;;;;;;OAuBG;aACa,MAAM,CACpB,UAAU,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,MAAM,GACd,eAAe,CAAC,uBAAuB,CAAC;IAE3C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAyCG;aACa,MAAM,CACpB,UAAU,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAC1B,eAAe,CAAC,uBAAuB,CAAC;IAE3C;;;;;;;;;;;;;;;;;;;;OAoBG;aACa,SAAS,CACvB,UAAU,EAAE,MAAM,GACjB,eAAe,CAAC,0BAA0B,CAAC;IAE9C;;;;;;;;;;;;;;;;;;;;;;OAsBG;aACa,MAAM,CACpB,UAAU,EAAE,MAAM,GACjB,eAAe,CAAC,uBAAuB,CAAC;IAE3C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA0CG;aACa,IAAI,CAClB,SAAS,EAAE,IAAI,GAAG,MAAM,EACxB,OAAO,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,eAAe,EAAE,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,GAC7D,eAAe,CAAC,0BAA0B,CAAC;CAC/C;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,2BAA2B;;;;;;iBAEtC,CAAA;AAEF,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAC/C,OAAO,2BAA2B,CACnC,CAAA"}

package/dist/api/core/tags.d.ts

@@ -119,8 +119,32 @@ export declare abstract class PluginCoreTagsApi {
      * const { tags } = await snaptrude.core.tags.getTagsForComponent("cmp_42")
      * for (const t of tags) console.log(t.categoryName, t.tagName)
      * ```
+     *
+     * @deprecated Use `core.tags.listForComponent`
      */
     abstract getTagsForComponent(componentId: ComponentHandle): PluginApiReturn<PluginCoreTagsGetTagsForComponentResult>;
+    /**
+     * List the tags carried by a component.
+     *
+     * Returns one entry per category the component is tagged in, each carrying the
+     * category and tag names and the tag color. Canonical home of the read formerly
+     * at `getTagsForComponent` (now deprecated).
+     *
+     * @param componentId - The `Component.id` to read.
+     * @returns A {@linkcode PluginCoreTagsGetTagsForComponentResult} with a `tags`
+     *   array (empty when the component has none or does not exist).
+     *
+     * @examplePrompt What tags does this space have?
+     * @examplePrompt List the tags on component cmp_42
+     * @examplePrompt Show the labels applied to this room
+     *
+     * # Example
+     * ```ts
+     * const { tags } = await snaptrude.core.tags.listForComponent("cmp_42")
+     * for (const t of tags) console.log(t.categoryName, t.tagName)
+     * ```
+     */
+    abstract listForComponent(componentId: ComponentHandle): PluginApiReturn<PluginCoreTagsGetTagsForComponentResult>;
     /**
      * List the components carrying a given tag or category.
      *

package/dist/api/core/tags.d.ts.map

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

package/dist/api/core/zoom/index.d.ts

@@ -22,6 +22,8 @@ export declare abstract class PluginZoomApi {
      * ```ts
      * await snaptrude.core.zoom.extents()
      * ```
+     *
+     * @deprecated Use `core.camera.zoomExtents`
      */
     abstract extents(): PluginApiReturn<boolean>;
     /**
@@ -39,6 +41,8 @@ export declare abstract class PluginZoomApi {
      * ```ts
      * await snaptrude.core.zoom.selection()
      * ```
+     *
+     * @deprecated Use `core.camera.zoomSelection`
      */
     abstract selection(): PluginApiReturn<boolean>;
 }

package/dist/api/core/zoom/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/api/core/zoom/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAEhD;;;;;GAKG;AACH,8BAAsB,aAAa;;IAGjC;;;;;;;;;;;;;;;OAeG;aACa,OAAO,IAAI,eAAe,CAAC,OAAO,CAAC;IAEnD;;;;;;;;;;;;;;;OAeG;aACa,SAAS,IAAI,eAAe,CAAC,OAAO,CAAC;CACtD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/api/core/zoom/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAEhD;;;;;GAKG;AACH,8BAAsB,aAAa;;IAGjC;;;;;;;;;;;;;;;;;OAiBG;aACa,OAAO,IAAI,eAAe,CAAC,OAAO,CAAC;IAEnD;;;;;;;;;;;;;;;;;OAiBG;aACa,SAAS,IAAI,eAAe,CAAC,OAAO,CAAC;CACtD"}