@snaptrude/plugin-core 0.9.17 → 0.9.18-edgesetbacks-20261021.1

package/dist/api/presentation/views.d.ts

@@ -1,7 +1,7 @@
 import * as z from "zod";
 import { PluginApiReturn } from "../../types";
 /**
- * Presentation views — read the saved 2D/3D views used to prepare presentations.
+ * Presentation views — read the saved plan, 3D, and elevation views used to prepare presentations.
  *
  * A **view** is a saved camera/plan: a sheet-ready 2D plan or a saved 3D view.
  * A plugin can list and read views, capture them to images, activate one (move
@@ -22,10 +22,10 @@ export declare abstract class PluginPresentationViewsApi {
      * List the saved views in the active project.
      *
      * @returns A {@linkcode PluginPresentationViewsListResult} with a `views` array
-     *   of 2D and 3D views (empty when the project has none).
+     *   of plan, 3D, and elevation views (empty when the project has none).
      *
      * @examplePrompt List all the saved views
-     * @examplePrompt What 2D and 3D views are in this project?
+     * @examplePrompt What plan, 3D, and elevation views are in this project?
      * @examplePrompt Which view is currently active?
      * @examplePrompt Get the names of every presentation view
      * @examplePrompt Show me the 3D views I can put on a sheet
@@ -107,6 +107,10 @@ export declare abstract class PluginPresentationViewsApi {
      * Applies the view's camera, visibility, and storey state to the live scene.
      * Paired with {@linkcode PluginPresentationViewsApi.getActive}.
      *
+     * While Present is open this sets the Design frame a view saved in Present
+     * is taken from; it never moves the Present sheet canvas; use
+     * `presentation.camera` for that.
+     *
      * @param viewId - The id of the view to activate.
      * @returns The id of the now-active view.
      * @throws If no view has the given id.
@@ -127,6 +131,15 @@ export declare abstract class PluginPresentationViewsApi {
      *
      * Creates a camera bookmark (not geometry) from where the camera is now.
      *
+     * Works while Present mode is open. Present draws its drawings on the same
+     * 3D scene, so a view saved in Present takes its framing (camera, 2D or 3D
+     * mode, projection, storey, building) from the Design frame instead: the one
+     * the user had when Present opened, or one a plugin set since with
+     * `setActive`, `updateSettings({ viewMode })`, `core.camera`, `core.zoom`,
+     * `core.storeys.setActive`, `core.storeys.layers.setActive` or
+     * `core.buildings.setActive`. It never moves the Present sheet canvas; use
+     * `presentation.camera` for that.
+     *
      * @param name - Name for the new view (a default is used when omitted).
      * @param options - Optional `kind` (what kind of view to save, default
      *   `"view"`) and `storey` (save the view on a specific storey — the storey is
@@ -159,12 +172,16 @@ export declare abstract class PluginPresentationViewsApi {
      *
      * @param viewId - The id of the view to read settings for.
      * @returns The view's {@linkcode PluginPresentationViewSettings}, or `null` if
-     *   no view has that id.
+     *   no view has that id. A plan view also reports its `cutPlaneHeight`,
+     *   `viewDepthStorey` and `showOverheadObjects` (saved values, or the product
+     *   defaults for a plan saved before cut ranges existed); other views omit them.
      *
      * @examplePrompt What color mode is the Ground Floor view using?
      * @examplePrompt Get the display settings for this view
      * @examplePrompt Does the site plan view show axes and labels?
      * @examplePrompt Read the background color of the active view
+     * @examplePrompt What is the cut height of this plan?
+     * @examplePrompt How deep does this plan look below the cut?
      *
      * # Example
      * ```ts
@@ -211,14 +228,24 @@ export declare abstract class PluginPresentationViewsApi {
      * toggle the view-settings modal runs); on other views the mode is applied
      * the next time the view is activated.
      *
+     * `cutPlaneHeight`, `viewDepthStorey` and `showOverheadObjects` set the plan's
+     * cut range and apply to **plan views only** (patching them on a 3D, elevation
+     * or site-plan view is rejected). `cutPlaneHeight` is in engine units, the same
+     * unit as `story.height`, and must be greater than 0 and less than the plan
+     * storey's height. `viewDepthStorey` must be an existing storey at or below the
+     * plan's storey. A sparse patch leaves the other two range fields as they
+     * were; on the active plan the canvas redraws live.
+     *
      * @param viewId - The id of the view to update.
      * @param settings - A partial {@linkcode PluginPresentationViewSettings}; any
      *   omitted field is left unchanged.
      * @returns The updated view's `id`.
      * @throws If writes are disabled, no view has the given id, the patch is
      *   contradictory (`showLabels: false` with a non-empty `labels`, or
-     *   `showLabels: true` with an explicitly empty `labels` list), or
-     *   `viewMode: "perspective"` is patched on a 2D plan view.
+     *   `showLabels: true` with an explicitly empty `labels` list),
+     *   `viewMode: "perspective"` is patched on a 2D plan view, a plan-range
+     *   field is patched on a view that is not a plan, or the cut height / depth
+     *   is out of range.
      *
      * @examplePrompt Switch this view to monochrome color mode
      * @examplePrompt Turn off the axis in the Ground Floor view
@@ -226,6 +253,9 @@ export declare abstract class PluginPresentationViewsApi {
      * @examplePrompt Show area labels on this view
      * @examplePrompt Enable hidden-line mode for the section view
      * @examplePrompt Make the 3D view orthographic instead of perspective
+     * @examplePrompt Raise the cut plane of the Ground Floor plan to 1.8 m
+     * @examplePrompt Show the basement below in this plan
+     * @examplePrompt Hide the overhead objects in this plan
      *
      * # Example
      * ```ts
@@ -237,6 +267,12 @@ export declare abstract class PluginPresentationViewsApi {
      * await snaptrude.presentation.views.updateSettings("view_123", {
      *   viewMode: "isometric",
      * })
+     * // set a plan's range: cut 1.2 m up, show the basement below, no overhead
+     * await snaptrude.presentation.views.updateSettings("plan_1", {
+     *   cutPlaneHeight: 4.72,
+     *   viewDepthStorey: -1,
+     *   showOverheadObjects: false,
+     * })
      * ```
      */
     abstract updateSettings(viewId: string, settings: Partial<PluginPresentationViewSettings>): PluginApiReturn<PluginPresentationViewsUpdateSettingsResult>;
@@ -289,13 +325,31 @@ export declare abstract class PluginPresentationViewsApi {
     abstract delete(viewId: string): PluginApiReturn<PluginPresentationViewsDeleteResult>;
 }
 /**
- * The kind of a saved view: a 2D plan view or a 3D view.
+ * The rendering category of a saved view. Existing plan/3D values are preserved;
+ * elevations are identified independently of their orthographic 3D camera.
  */
 export declare const PluginPresentationViewType: z.ZodEnum<{
+    elevation: "elevation";
     "2d": "2d";
     "3d": "3d";
 }>;
 export type PluginPresentationViewType = z.infer<typeof PluginPresentationViewType>;
+/** The native semantic kind persisted for a saved view. */
+export declare const PluginPresentationViewKind: z.ZodEnum<{
+    elevation: "elevation";
+    plan: "plan";
+    sitePlan: "sitePlan";
+    threeD: "threeD";
+}>;
+export type PluginPresentationViewKind = z.infer<typeof PluginPresentationViewKind>;
+/** Cardinal direction for an elevation; non-elevation views return `null`. */
+export declare const PluginPresentationElevationDirection: z.ZodEnum<{
+    north: "north";
+    south: "south";
+    east: "east";
+    west: "west";
+}>;
+export type PluginPresentationElevationDirection = z.infer<typeof PluginPresentationElevationDirection>;
 /**
  * A saved presentation view.
  *
@@ -303,7 +357,9 @@ export type PluginPresentationViewType = z.infer<typeof PluginPresentationViewTy
  * |---|---|---|
  * | `id` | `string` | Unique view id |
  * | `name` | `string` | Display name |
- * | `type` | `"2d" \| "3d"` | Whether this is a 2D plan view or a 3D view |
+ * | `type` | `"2d" \| "3d" \| "elevation"` | Rendering category; elevations are distinct from ordinary 3D views |
+ * | `kind` | {@linkcode PluginPresentationViewKind} | Native semantic view kind |
+ * | `direction` | {@linkcode PluginPresentationElevationDirection}` \| null` | Cardinal direction for elevations; otherwise `null` |
  * | `isActive` | `boolean` | Whether this view is the currently active view |
  * | `storey` | `number \| null` | The storey this view was saved on (`null` on older views saved without one) |
  */
@@ -311,9 +367,22 @@ export declare const PluginPresentationView: z.ZodObject<{
     id: z.ZodString;
     name: z.ZodString;
     type: z.ZodEnum<{
+        elevation: "elevation";
         "2d": "2d";
         "3d": "3d";
     }>;
+    kind: z.ZodEnum<{
+        elevation: "elevation";
+        plan: "plan";
+        sitePlan: "sitePlan";
+        threeD: "threeD";
+    }>;
+    direction: z.ZodNullable<z.ZodEnum<{
+        north: "north";
+        south: "south";
+        east: "east";
+        west: "west";
+    }>>;
     isActive: z.ZodBoolean;
     storey: z.ZodNullable<z.ZodNumber>;
 }, z.core.$strip>;
@@ -330,9 +399,22 @@ export declare const PluginPresentationViewsListResult: z.ZodObject<{
         id: z.ZodString;
         name: z.ZodString;
         type: z.ZodEnum<{
+            elevation: "elevation";
             "2d": "2d";
             "3d": "3d";
         }>;
+        kind: z.ZodEnum<{
+            elevation: "elevation";
+            plan: "plan";
+            sitePlan: "sitePlan";
+            threeD: "threeD";
+        }>;
+        direction: z.ZodNullable<z.ZodEnum<{
+            north: "north";
+            south: "south";
+            east: "east";
+            west: "west";
+        }>>;
         isActive: z.ZodBoolean;
         storey: z.ZodNullable<z.ZodNumber>;
     }, z.core.$strip>>;
@@ -358,9 +440,22 @@ export declare const PluginPresentationViewsGetResult: z.ZodNullable<z.ZodObject
     id: z.ZodString;
     name: z.ZodString;
     type: z.ZodEnum<{
+        elevation: "elevation";
         "2d": "2d";
         "3d": "3d";
     }>;
+    kind: z.ZodEnum<{
+        elevation: "elevation";
+        plan: "plan";
+        sitePlan: "sitePlan";
+        threeD: "threeD";
+    }>;
+    direction: z.ZodNullable<z.ZodEnum<{
+        north: "north";
+        south: "south";
+        east: "east";
+        west: "west";
+    }>>;
     isActive: z.ZodBoolean;
     storey: z.ZodNullable<z.ZodNumber>;
 }, z.core.$strip>>;
@@ -439,9 +534,22 @@ export declare const PluginPresentationViewsCreateResult: z.ZodObject<{
     id: z.ZodString;
     name: z.ZodString;
     type: z.ZodEnum<{
+        elevation: "elevation";
         "2d": "2d";
         "3d": "3d";
     }>;
+    kind: z.ZodEnum<{
+        elevation: "elevation";
+        plan: "plan";
+        sitePlan: "sitePlan";
+        threeD: "threeD";
+    }>;
+    direction: z.ZodNullable<z.ZodEnum<{
+        north: "north";
+        south: "south";
+        east: "east";
+        west: "west";
+    }>>;
     isActive: z.ZodBoolean;
     storey: z.ZodNullable<z.ZodNumber>;
 }, z.core.$strip>;
@@ -509,6 +617,9 @@ export type PluginPresentationViewMode = z.infer<typeof PluginPresentationViewMo
  * | `showEdges` | `boolean` | Whether edges are shown; `false` = hidden-line rendering |
  * | `showLabels` | `boolean` | Master label switch — whether on-canvas labels are shown at all. `true` always pairs with a non-empty `labels` selection (labels render only while the selection is non-empty; there is no labels-on-with-empty-selection state) |
  * | `labels` | {@linkcode PluginPresentationViewLabel}`[]` | Which label categories are selected. When `showLabels` is `false` the view stores no selection and this reads `[]` |
+ * | `cutPlaneHeight` | `number`? | **Plan views only.** Height of the plan's cut plane above its storey base, in engine units (the unit `story.height` uses). Absent on 3D and elevation views |
+ * | `viewDepthStorey` | `number`? | **Plan views only.** The lowest storey the plan shows below the cut; defaults to the plan's own storey. Absent on 3D and elevation views |
+ * | `showOverheadObjects` | `boolean`? | **Plan views only.** Whether objects above the cut are drawn as dashed overhead linework. Absent on 3D and elevation views |
  */
 export declare const PluginPresentationViewSettings: z.ZodObject<{
     backgroundColor: z.ZodString;
@@ -529,6 +640,9 @@ export declare const PluginPresentationViewSettings: z.ZodObject<{
         objectLabels: "objectLabels";
         areas: "areas";
     }>>;
+    cutPlaneHeight: z.ZodOptional<z.ZodNumber>;
+    viewDepthStorey: z.ZodOptional<z.ZodNumber>;
+    showOverheadObjects: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>;
 export type PluginPresentationViewSettings = z.infer<typeof PluginPresentationViewSettings>;
 /**
@@ -565,6 +679,9 @@ export declare const PluginPresentationViewsGetSettingsResult: z.ZodNullable<z.Z
         objectLabels: "objectLabels";
         areas: "areas";
     }>>;
+    cutPlaneHeight: z.ZodOptional<z.ZodNumber>;
+    viewDepthStorey: z.ZodOptional<z.ZodNumber>;
+    showOverheadObjects: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>>;
 export type PluginPresentationViewsGetSettingsResult = z.infer<typeof PluginPresentationViewsGetSettingsResult>;
 /**
@@ -600,6 +717,9 @@ export declare const PluginPresentationViewsUpdateSettingsArgs: z.ZodObject<{
             objectLabels: "objectLabels";
             areas: "areas";
         }>>>;
+        cutPlaneHeight: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+        viewDepthStorey: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+        showOverheadObjects: z.ZodOptional<z.ZodOptional<z.ZodBoolean>>;
     }, z.core.$strip>;
 }, z.core.$strip>;
 export type PluginPresentationViewsUpdateSettingsArgs = z.infer<typeof PluginPresentationViewsUpdateSettingsArgs>;
@@ -626,9 +746,22 @@ export declare const PluginPresentationViewsRenameResult: z.ZodObject<{
     id: z.ZodString;
     name: z.ZodString;
     type: z.ZodEnum<{
+        elevation: "elevation";
         "2d": "2d";
         "3d": "3d";
     }>;
+    kind: z.ZodEnum<{
+        elevation: "elevation";
+        plan: "plan";
+        sitePlan: "sitePlan";
+        threeD: "threeD";
+    }>;
+    direction: z.ZodNullable<z.ZodEnum<{
+        north: "north";
+        south: "south";
+        east: "east";
+        west: "west";
+    }>>;
     isActive: z.ZodBoolean;
     storey: z.ZodNullable<z.ZodNumber>;
 }, z.core.$strip>;

package/dist/api/presentation/views.d.ts.map

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

package/dist/api/presentation/walkthroughs.d.ts

@@ -1252,10 +1252,10 @@ export type PluginWalkthroughExportArgs = z.infer<typeof PluginWalkthroughExport
  */
 export declare const PluginWalkthroughExportJobStatus: z.ZodEnum<{
     failed: "failed";
-    running: "running";
     queued: "queued";
-    completed: "completed";
     cancelled: "cancelled";
+    running: "running";
+    completed: "completed";
 }>;
 export type PluginWalkthroughExportJobStatus = z.infer<typeof PluginWalkthroughExportJobStatus>;
 /**
@@ -1297,10 +1297,10 @@ export declare const PluginWalkthroughExportJob: z.ZodObject<{
     walkthroughId: z.ZodString;
     status: z.ZodEnum<{
         failed: "failed";
-        running: "running";
         queued: "queued";
-        completed: "completed";
         cancelled: "cancelled";
+        running: "running";
+        completed: "completed";
     }>;
     createdAt: z.ZodNumber;
     updatedAt: z.ZodNumber;
@@ -1326,10 +1326,10 @@ export declare const PluginWalkthroughListJobsResult: z.ZodObject<{
         walkthroughId: z.ZodString;
         status: z.ZodEnum<{
             failed: "failed";
-            running: "running";
             queued: "queued";
-            completed: "completed";
             cancelled: "cancelled";
+            running: "running";
+            completed: "completed";
         }>;
         createdAt: z.ZodNumber;
         updatedAt: z.ZodNumber;

package/dist/errors/codes.d.ts

@@ -7,8 +7,10 @@
  * (`HANDLE_INVALID`) so error responses cannot be used as an existence /
  * ownership oracle (PLUGIN_HANDLE_MIGRATION_HLD §6). `HANDLE_KIND_MISMATCH`
  * stays distinct because the kind is information the caller already holds.
+ * `HANDLE_STALE` is the one deliberate exception: a handle the caller
+ * legitimately held whose entity was since retired (deleted or rebuilt).
  */
-export declare const PLUGIN_ERROR_CODES: readonly ["VALIDATION", "INVALID_RPC_FORMAT", "METHOD_NOT_FOUND", "METHOD_NOT_PERMITTED", "HANDLE_INVALID", "HANDLE_KIND_MISMATCH", "RESOURCE_QUOTA_EXCEEDED", "RATE_LIMITED", "PRECONDITION_FAILED", "OPERATION_FAILED", "TIMEOUT", "CALL_TIMEOUT", "TRANSPORT_LOST", "PLUGIN_NOT_READY", "PLUGIN_TERMINATED", "RESULT_NOT_SERIALIZABLE", "RESULT_TOO_LARGE", "BATCH_PARTIAL", "STORY_UPDATE_FAILED", "STORY_HEIGHT_REJECTED", "NO_ACTIVE_STRUCTURE", "NO_ELIGIBLE_ELEMENTS", "PROPOSAL_SWITCH_BLOCKED", "INTERNAL", "UNKNOWN"];
+export declare const PLUGIN_ERROR_CODES: readonly ["VALIDATION", "INVALID_RPC_FORMAT", "METHOD_NOT_FOUND", "METHOD_NOT_PERMITTED", "HANDLE_INVALID", "HANDLE_KIND_MISMATCH", "RESOURCE_QUOTA_EXCEEDED", "RATE_LIMITED", "PRECONDITION_FAILED", "OPERATION_FAILED", "TIMEOUT", "CALL_TIMEOUT", "TRANSPORT_LOST", "PLUGIN_NOT_READY", "PLUGIN_TERMINATED", "RESULT_NOT_SERIALIZABLE", "RESULT_TOO_LARGE", "BATCH_PARTIAL", "STORY_UPDATE_FAILED", "STORY_HEIGHT_REJECTED", "NO_ACTIVE_STRUCTURE", "NO_ELIGIBLE_ELEMENTS", "PROPOSAL_SWITCH_BLOCKED", "INTERNAL", "UNKNOWN", "HANDLE_STALE"];
 export type PluginErrorCode = (typeof PLUGIN_ERROR_CODES)[number];
 /**
  * A known code, or a string outside the union — a plugin built against an

package/dist/errors/codes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"codes.d.ts","sourceRoot":"","sources":["../../src/errors/codes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,eAAO,MAAM,kBAAkB,kgBA0BrB,CAAA;AAEV,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAA;AAEjE;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,GAAG,eAAe,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAA;AAEjE,MAAM,MAAM,mBAAmB,GAC3B,YAAY,GACZ,WAAW,GACX,YAAY,GACZ,QAAQ,GACR,OAAO,GACP,SAAS,GACT,WAAW,GACX,WAAW,GACX,WAAW,GACX,UAAU,CAAA;AAEd;;;;GAIG;AACH,MAAM,WAAW,QAAQ;IACvB,kEAAkE;IAClE,QAAQ,EAAE,mBAAmB,CAAA;IAC7B,yDAAyD;IACzD,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAED,eAAO,MAAM,SAAS,EAAE,MAAM,CAAC,eAAe,EAAE,QAAQ,CA2DvD,CAAA;AAED,uEAAuE;AACvE,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,eAAe,CAEzE"}
+{"version":3,"file":"codes.d.ts","sourceRoot":"","sources":["../../src/errors/codes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,kBAAkB,khBA2BrB,CAAA;AAEV,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAA;AAEjE;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,GAAG,eAAe,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAA;AAEjE,MAAM,MAAM,mBAAmB,GAC3B,YAAY,GACZ,WAAW,GACX,YAAY,GACZ,QAAQ,GACR,OAAO,GACP,SAAS,GACT,WAAW,GACX,WAAW,GACX,WAAW,GACX,UAAU,CAAA;AAEd;;;;GAIG;AACH,MAAM,WAAW,QAAQ;IACvB,kEAAkE;IAClE,QAAQ,EAAE,mBAAmB,CAAA;IAC7B,yDAAyD;IACzD,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAED,eAAO,MAAM,SAAS,EAAE,MAAM,CAAC,eAAe,EAAE,QAAQ,CA+DvD,CAAA;AAED,uEAAuE;AACvE,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,eAAe,CAEzE"}