@snaptrude/plugin-core 0.3.0 → 0.5.0

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

@@ -0,0 +1,46 @@
+import { PluginPresentationViewsApi } from "./views";
+import { PluginPresentationAIInspirationApi } from "./aiInspiration";
+import { PluginPresentationSheetsApi } from "./sheets";
+import { PluginPresentationDiagramsApi } from "./diagrams";
+import { PluginPresentationImportApi } from "./import";
+/**
+ * Presentation APIs — prepare and assemble presentations.
+ *
+ * Reads describe the artifacts a presentation is built from (saved views, layout
+ * sheets); writes assemble them (place views/diagrams on sheets, import
+ * references, capture/save views). Present-mode AI Inspiration also lives here.
+ *
+ * Several members require **Present mode to be open** (the documentation editor):
+ * sheets, diagram placement, and import.
+ *
+ * - {@linkcode PluginPresentationApi.views} — Saved 2D/3D views (list, get, capture, activate, create)
+ * - {@linkcode PluginPresentationApi.sheets} — Layout sheets (list, get, create, place views)
+ * - {@linkcode PluginPresentationApi.diagrams} — Place program/adjacency/site diagram images on sheets
+ * - {@linkcode PluginPresentationApi.import} — Import reference images/PDFs onto the canvas
+ * - {@linkcode PluginPresentationApi.aiInspiration} — Present-mode AI image/video generation
+ *
+ * Accessed via `snaptrude.presentation`.
+ */
+export declare abstract class PluginPresentationApi {
+    /** Saved 2D/3D views. See {@linkcode PluginPresentationViewsApi}. */
+    abstract views: PluginPresentationViewsApi;
+    /** Layout sheets — list/get/create and place views (Present mode). See {@linkcode PluginPresentationSheetsApi}. */
+    abstract sheets: PluginPresentationSheetsApi;
+    /** Program/adjacency/site diagrams — place images on sheets. See {@linkcode PluginPresentationDiagramsApi}. */
+    abstract diagrams: PluginPresentationDiagramsApi;
+    /** Import reference images/PDFs onto the Present canvas. See {@linkcode PluginPresentationImportApi}. */
+    abstract import: PluginPresentationImportApi;
+    /**
+     * Present-mode AI Inspiration image/video generation. See
+     * {@linkcode PluginPresentationAIInspirationApi}. _(authored ahead — optional
+     * until the host lands; the host implementation today is a stub.)_
+     */
+    aiInspiration?: PluginPresentationAIInspirationApi;
+    constructor();
+}
+export * from "./views";
+export * from "./sheets";
+export * from "./diagrams";
+export * from "./import";
+export * from "./aiInspiration";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/api/presentation/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,MAAM,SAAS,CAAA;AACpD,OAAO,EAAE,kCAAkC,EAAE,MAAM,iBAAiB,CAAA;AACpE,OAAO,EAAE,2BAA2B,EAAE,MAAM,UAAU,CAAA;AACtD,OAAO,EAAE,6BAA6B,EAAE,MAAM,YAAY,CAAA;AAC1D,OAAO,EAAE,2BAA2B,EAAE,MAAM,UAAU,CAAA;AAEtD;;;;;;;;;;;;;;;;;GAiBG;AACH,8BAAsB,qBAAqB;IACzC,qEAAqE;IACrE,SAAgB,KAAK,EAAE,0BAA0B,CAAA;IACjD,mHAAmH;IACnH,SAAgB,MAAM,EAAE,2BAA2B,CAAA;IACnD,+GAA+G;IAC/G,SAAgB,QAAQ,EAAE,6BAA6B,CAAA;IACvD,yGAAyG;IACzG,SAAgB,MAAM,EAAE,2BAA2B,CAAA;IACnD;;;;OAIG;IACI,aAAa,CAAC,EAAE,kCAAkC,CAAA;;CAG1D;AAED,cAAc,SAAS,CAAA;AACvB,cAAc,UAAU,CAAA;AACxB,cAAc,YAAY,CAAA;AAC1B,cAAc,UAAU,CAAA;AACxB,cAAc,iBAAiB,CAAA"}

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

@@ -0,0 +1,176 @@
+import * as z from "zod";
+import { PluginApiReturn } from "../../types";
+/**
+ * Presentation sheets — the layout sheets a presentation is assembled on.
+ *
+ * A **sheet** is a page in Present mode that views and diagrams are placed onto.
+ * These methods require **Present mode to be open** (the documentation editor) —
+ * reads return `[]`/`null` and writes throw when it is not.
+ *
+ * `list`/`get` are reads; `create` adds a sheet and `place` drops a saved view
+ * onto a sheet (returning the id of the created canvas shape).
+ *
+ * Accessed via `snaptrude.presentation.sheets`.
+ */
+export declare abstract class PluginPresentationSheetsApi {
+    constructor();
+    /**
+     * List the layout sheets in the presentation.
+     *
+     * @returns A {@linkcode PluginPresentationSheetsListResult} with a `sheets`
+     *   array (empty when Present mode is closed or there are no sheets).
+     *
+     * @examplePrompt List all the sheets
+     * @examplePrompt How many layout sheets are there?
+     * @examplePrompt Show me the presentation sheets
+     * @examplePrompt What sheets can I place views on?
+     *
+     * # Example
+     * ```ts
+     * const { sheets } = await snaptrude.presentation.sheets.list()
+     * ```
+     */
+    abstract list(): PluginApiReturn<PluginPresentationSheetsListResult>;
+    /**
+     * Get a single sheet by id.
+     *
+     * @param sheetId - The id of the sheet to read.
+     * @returns The matching {@linkcode PluginPresentationSheet}, or `null`.
+     *
+     * @examplePrompt Get the sheet with id sheet_1
+     * @examplePrompt Find the sheet called Cover
+     * @examplePrompt Look up a layout sheet by id
+     *
+     * # Example
+     * ```ts
+     * const sheet = await snaptrude.presentation.sheets.get("sheet_1")
+     * ```
+     */
+    abstract get(sheetId: string): PluginApiReturn<PluginPresentationSheetsGetResult>;
+    /**
+     * Create a new layout sheet.
+     *
+     * Requires Present mode to be open.
+     *
+     * @param name - Display name for the new sheet (optional).
+     * @returns The newly created {@linkcode PluginPresentationSheet}.
+     * @throws If Present mode is not open.
+     *
+     * @examplePrompt Create a new sheet called Cover
+     * @examplePrompt Add a layout sheet
+     * @examplePrompt Make a new presentation sheet named Floor Plans
+     *
+     * # Example
+     * ```ts
+     * const sheet = await snaptrude.presentation.sheets.create("Cover")
+     * ```
+     */
+    abstract create(name?: string): PluginApiReturn<PluginPresentationSheet>;
+    /**
+     * Place a saved view onto a sheet.
+     *
+     * Drops the given view onto the sheet at an optional position and returns the
+     * id of the created canvas shape. Requires Present mode to be open.
+     *
+     * @param sheetId - The id of the sheet to place onto.
+     * @param viewId - The id of the saved view to place.
+     * @param options - Optional `position` ({@linkcode PluginSheetPosition}) —
+     *   where to place it (a default is used when omitted).
+     * @returns A {@linkcode PluginPresentationSheetsPlaceResult} with the created
+     *   `shapeId`.
+     * @throws If Present mode is not open, or the sheet/view id is invalid.
+     *
+     * @examplePrompt Place the floor plan on Sheet 1
+     * @examplePrompt Add this 3D view to the cover sheet
+     * @examplePrompt Drop the site plan onto the layout sheet at 100, 200
+     * @examplePrompt Put the Ground Floor view on sheet_1
+     *
+     * # Example
+     * ```ts
+     * const { shapeId } = await snaptrude.presentation.sheets.place("sheet_1", "view_123")
+     * ```
+     */
+    abstract place(sheetId: string, viewId: string, options?: {
+        position?: PluginSheetPosition;
+    }): PluginApiReturn<PluginPresentationSheetsPlaceResult>;
+}
+/**
+ * A layout sheet in the presentation.
+ *
+ * | Property | Type | Description |
+ * |---|---|---|
+ * | `id` | `string` | Unique sheet id |
+ * | `name` | `string` | Display name |
+ */
+export declare const PluginPresentationSheet: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+}, z.core.$strip>;
+export type PluginPresentationSheet = z.infer<typeof PluginPresentationSheet>;
+/**
+ * A position on a sheet/canvas (sheet coordinates).
+ *
+ * | Property | Type | Description |
+ * |---|---|---|
+ * | `x` | `number` | X coordinate |
+ * | `y` | `number` | Y coordinate |
+ */
+export declare const PluginSheetPosition: z.ZodObject<{
+    x: z.ZodNumber;
+    y: z.ZodNumber;
+}, z.core.$strip>;
+export type PluginSheetPosition = z.infer<typeof PluginSheetPosition>;
+/** Result of {@linkcode PluginPresentationSheetsApi.list}. */
+export declare const PluginPresentationSheetsListResult: z.ZodObject<{
+    sheets: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type PluginPresentationSheetsListResult = z.infer<typeof PluginPresentationSheetsListResult>;
+/** Arguments for {@linkcode PluginPresentationSheetsApi.get}. */
+export declare const PluginPresentationSheetsGetArgs: z.ZodObject<{
+    id: z.ZodString;
+}, z.core.$strip>;
+export type PluginPresentationSheetsGetArgs = z.infer<typeof PluginPresentationSheetsGetArgs>;
+/** Result of {@linkcode PluginPresentationSheetsApi.get} — the sheet, or `null`. */
+export declare const PluginPresentationSheetsGetResult: z.ZodNullable<z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+}, z.core.$strip>>;
+export type PluginPresentationSheetsGetResult = z.infer<typeof PluginPresentationSheetsGetResult>;
+/** Arguments for {@linkcode PluginPresentationSheetsApi.create}. */
+export declare const PluginPresentationSheetsCreateArgs: z.ZodObject<{
+    name: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type PluginPresentationSheetsCreateArgs = z.infer<typeof PluginPresentationSheetsCreateArgs>;
+/**
+ * Arguments for {@linkcode PluginPresentationSheetsApi.place}.
+ *
+ * | Property | Type | Description |
+ * |---|---|---|
+ * | `sheetId` | `string` | The sheet to place onto |
+ * | `viewId` | `string` | The saved view to place |
+ * | `position` | {@linkcode PluginSheetPosition}` \| undefined` | Where to place it (a default is used when omitted) |
+ */
+export declare const PluginPresentationSheetsPlaceArgs: z.ZodObject<{
+    sheetId: z.ZodString;
+    viewId: z.ZodString;
+    position: z.ZodOptional<z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type PluginPresentationSheetsPlaceArgs = z.infer<typeof PluginPresentationSheetsPlaceArgs>;
+/**
+ * Result of {@linkcode PluginPresentationSheetsApi.place}.
+ *
+ * | Property | Type | Description |
+ * |---|---|---|
+ * | `shapeId` | `string` | Id of the created canvas shape |
+ */
+export declare const PluginPresentationSheetsPlaceResult: z.ZodObject<{
+    shapeId: z.ZodString;
+}, z.core.$strip>;
+export type PluginPresentationSheetsPlaceResult = z.infer<typeof PluginPresentationSheetsPlaceResult>;
+//# sourceMappingURL=sheets.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sheets.d.ts","sourceRoot":"","sources":["../../../src/api/presentation/sheets.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAA;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAE7C;;;;;;;;;;;GAWG;AACH,8BAAsB,2BAA2B;;IAG/C;;;;;;;;;;;;;;;OAeG;aACa,IAAI,IAAI,eAAe,CAAC,kCAAkC,CAAC;IAE3E;;;;;;;;;;;;;;OAcG;aACa,GAAG,CACjB,OAAO,EAAE,MAAM,GACd,eAAe,CAAC,iCAAiC,CAAC;IAErD;;;;;;;;;;;;;;;;;OAiBG;aACa,MAAM,CACpB,IAAI,CAAC,EAAE,MAAM,GACZ,eAAe,CAAC,uBAAuB,CAAC;IAE3C;;;;;;;;;;;;;;;;;;;;;;;OAuBG;aACa,KAAK,CACnB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,mBAAmB,CAAA;KAAE,GAC3C,eAAe,CAAC,mCAAmC,CAAC;CACxD;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,uBAAuB;;;iBAGlC,CAAA;AACF,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAA;AAE7E;;;;;;;GAOG;AACH,eAAO,MAAM,mBAAmB;;;iBAG9B,CAAA;AACF,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAA;AAErE,8DAA8D;AAC9D,eAAO,MAAM,kCAAkC;;;;;iBAE7C,CAAA;AACF,MAAM,MAAM,kCAAkC,GAAG,CAAC,CAAC,KAAK,CACtD,OAAO,kCAAkC,CAC1C,CAAA;AAED,iEAAiE;AACjE,eAAO,MAAM,+BAA+B;;iBAE1C,CAAA;AACF,MAAM,MAAM,+BAA+B,GAAG,CAAC,CAAC,KAAK,CACnD,OAAO,+BAA+B,CACvC,CAAA;AAED,oFAAoF;AACpF,eAAO,MAAM,iCAAiC;;;kBACV,CAAA;AACpC,MAAM,MAAM,iCAAiC,GAAG,CAAC,CAAC,KAAK,CACrD,OAAO,iCAAiC,CACzC,CAAA;AAED,oEAAoE;AACpE,eAAO,MAAM,kCAAkC;;iBAE7C,CAAA;AACF,MAAM,MAAM,kCAAkC,GAAG,CAAC,CAAC,KAAK,CACtD,OAAO,kCAAkC,CAC1C,CAAA;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,iCAAiC;;;;;;;iBAI5C,CAAA;AACF,MAAM,MAAM,iCAAiC,GAAG,CAAC,CAAC,KAAK,CACrD,OAAO,iCAAiC,CACzC,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,mCAAmC;;iBAE9C,CAAA;AACF,MAAM,MAAM,mCAAmC,GAAG,CAAC,CAAC,KAAK,CACvD,OAAO,mCAAmC,CAC3C,CAAA"}

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

@@ -0,0 +1,296 @@
+import * as z from "zod";
+import { PluginApiReturn } from "../../types";
+/**
+ * Presentation views — read the saved 2D/3D 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
+ * the camera to it), and save the current camera as a new view.
+ *
+ * `list`/`get`/`getActive`/`capture` are reads; `setActive`/`create` are writes
+ * (a view is a camera bookmark — not geometry). Members typed optional (`?`) are
+ * authored ahead of the host: declared for plugins/codegen but not yet on the
+ * live discovery surface until the host lands them.
+ *
+ * Accessed via `snaptrude.presentation.views`.
+ */
+export declare abstract class PluginPresentationViewsApi {
+    constructor();
+    /**
+     * 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).
+     *
+     * @examplePrompt List all the saved views
+     * @examplePrompt What 2D and 3D 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
+     *
+     * # Example
+     * ```ts
+     * const { views } = await snaptrude.presentation.views.list()
+     * const active = views.find((v) => v.isActive)
+     * const plans = views.filter((v) => v.type === "2d")
+     * ```
+     */
+    abstract list(): PluginApiReturn<PluginPresentationViewsListResult>;
+    /**
+     * Get a single saved view by id.
+     *
+     * @param viewId - The id of the view to read.
+     * @returns The matching {@linkcode PluginPresentationView}, or `null` if no view
+     *   has that id.
+     *
+     * @examplePrompt Get the view with id view_12345
+     * @examplePrompt Find the saved view called Ground Floor Plan
+     * @examplePrompt Look up a presentation view by its id
+     *
+     * # Example
+     * ```ts
+     * const view = await snaptrude.presentation.views.get("view_123")
+     * ```
+     */
+    abstract get(viewId: string): PluginApiReturn<PluginPresentationViewsGetResult>;
+    /**
+     * Get the currently active view.
+     *
+     * @returns The active {@linkcode PluginPresentationView}, or `null` if none is
+     *   active.
+     *
+     * @examplePrompt Which view is active right now?
+     * @examplePrompt Get the current view
+     * @examplePrompt What view am I looking at?
+     *
+     * # Example
+     * ```ts
+     * const active = await snaptrude.presentation.views.getActive()
+     * ```
+     */
+    abstract getActive(): PluginApiReturn<PluginPresentationViewsGetResult>;
+    /**
+     * Capture a screenshot of a view as a base64 image.
+     *
+     * Captures the **current** viewport by default; pass `viewId` to capture a
+     * specific saved view (which briefly applies that view to the scene). Use
+     * `format`/`resolution` to control the output.
+     *
+     * @param options - All optional: `viewId` (capture this saved view; omit for the
+     *   current viewport), `format` (default `"png"`), `resolution` (e.g. `"1280x720"`).
+     * @returns A {@linkcode PluginPresentationViewsCaptureResult} with the base64
+     *   `image` data URL.
+     * @throws If a given `viewId` does not exist.
+     *
+     * @examplePrompt Take a screenshot of the current view
+     * @examplePrompt Capture this view as a PNG
+     * @examplePrompt Render the Site Plan view to an image
+     * @examplePrompt Export a high-res image of what I'm looking at
+     *
+     * # Example
+     * ```ts
+     * const { image } = await snaptrude.presentation.views.capture({ format: "png" })
+     * ```
+     */
+    abstract capture(options?: {
+        viewId?: string;
+        format?: "png" | "jpeg";
+        resolution?: string;
+    }): PluginApiReturn<PluginPresentationViewsCaptureResult>;
+    /**
+     * Activate a saved view — move the camera to it and restore its scene state.
+     *
+     * Applies the view's camera, visibility, and storey state to the live scene.
+     * Paired with {@linkcode PluginPresentationViewsApi.getActive}.
+     *
+     * @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.
+     *
+     * @examplePrompt Switch to the Ground Floor plan view
+     * @examplePrompt Make the 3D view active
+     * @examplePrompt Go to the view named Entrance
+     * @examplePrompt Load the site plan view
+     *
+     * # Example
+     * ```ts
+     * await snaptrude.presentation.views.setActive("view_123")
+     * ```
+     */
+    abstract setActive(viewId: string): PluginApiReturn<PluginPresentationViewsSetActiveResult>;
+    /**
+     * Save the current camera/scene state as a new named view.
+     *
+     * Creates a camera bookmark (not geometry) from where the camera is now.
+     *
+     * @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"`).
+     * @returns The newly created {@linkcode PluginPresentationView}.
+     * @throws If the view could not be saved.
+     *
+     * @examplePrompt Save the current view as Lobby Perspective
+     * @examplePrompt Create a new saved view from where I'm looking
+     * @examplePrompt Bookmark this camera angle
+     * @examplePrompt Save the current 2D plan as a view
+     *
+     * # Example
+     * ```ts
+     * const view = await snaptrude.presentation.views.create("Lobby")
+     * ```
+     */
+    abstract create(name?: string, options?: {
+        kind?: "view" | "sitePlan";
+    }): PluginApiReturn<PluginPresentationViewsCreateResult>;
+}
+/**
+ * The kind of a saved view: a 2D plan view or a 3D view.
+ */
+export declare const PluginPresentationViewType: z.ZodEnum<{
+    "2d": "2d";
+    "3d": "3d";
+}>;
+export type PluginPresentationViewType = z.infer<typeof PluginPresentationViewType>;
+/**
+ * A saved presentation view.
+ *
+ * | Property | Type | Description |
+ * |---|---|---|
+ * | `id` | `string` | Unique view id |
+ * | `name` | `string` | Display name |
+ * | `type` | `"2d" \| "3d"` | Whether this is a 2D plan view or a 3D view |
+ * | `isActive` | `boolean` | Whether this view is the currently active view |
+ */
+export declare const PluginPresentationView: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    type: z.ZodEnum<{
+        "2d": "2d";
+        "3d": "3d";
+    }>;
+    isActive: z.ZodBoolean;
+}, z.core.$strip>;
+export type PluginPresentationView = z.infer<typeof PluginPresentationView>;
+/**
+ * Result of {@linkcode PluginPresentationViewsApi.list}.
+ *
+ * | Property | Type | Description |
+ * |---|---|---|
+ * | `views` | {@linkcode PluginPresentationView}`[]` | All saved views in the project |
+ */
+export declare const PluginPresentationViewsListResult: z.ZodObject<{
+    views: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        type: z.ZodEnum<{
+            "2d": "2d";
+            "3d": "3d";
+        }>;
+        isActive: z.ZodBoolean;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type PluginPresentationViewsListResult = z.infer<typeof PluginPresentationViewsListResult>;
+/**
+ * Arguments for {@linkcode PluginPresentationViewsApi.get}.
+ *
+ * | Property | Type | Description |
+ * |---|---|---|
+ * | `id` | `string` | The id of the view to read |
+ */
+export declare const PluginPresentationViewsGetArgs: z.ZodObject<{
+    id: z.ZodString;
+}, z.core.$strip>;
+export type PluginPresentationViewsGetArgs = z.infer<typeof PluginPresentationViewsGetArgs>;
+/**
+ * Result of {@linkcode PluginPresentationViewsApi.get} and
+ * {@linkcode PluginPresentationViewsApi.getActive} — the view, or `null` when
+ * there is no match / no active view.
+ */
+export declare const PluginPresentationViewsGetResult: z.ZodNullable<z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    type: z.ZodEnum<{
+        "2d": "2d";
+        "3d": "3d";
+    }>;
+    isActive: z.ZodBoolean;
+}, z.core.$strip>>;
+export type PluginPresentationViewsGetResult = z.infer<typeof PluginPresentationViewsGetResult>;
+/** Image format for {@linkcode PluginPresentationViewsApi.capture}. */
+export declare const PluginPresentationImageFormat: z.ZodEnum<{
+    png: "png";
+    jpeg: "jpeg";
+}>;
+export type PluginPresentationImageFormat = z.infer<typeof PluginPresentationImageFormat>;
+/**
+ * Arguments for {@linkcode PluginPresentationViewsApi.capture}. All optional.
+ *
+ * | Property | Type | Description |
+ * |---|---|---|
+ * | `viewId` | `string \| undefined` | Capture this saved view; omit to capture the current viewport |
+ * | `format` | `"png" \| "jpeg" \| undefined` | Output image format (default `"png"`) |
+ * | `resolution` | `string \| undefined` | Optional resolution hint (e.g. `"1280x720"`) |
+ */
+export declare const PluginPresentationViewsCaptureArgs: z.ZodObject<{
+    viewId: z.ZodOptional<z.ZodString>;
+    format: z.ZodOptional<z.ZodEnum<{
+        png: "png";
+        jpeg: "jpeg";
+    }>>;
+    resolution: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type PluginPresentationViewsCaptureArgs = z.infer<typeof PluginPresentationViewsCaptureArgs>;
+/**
+ * Result of {@linkcode PluginPresentationViewsApi.capture}.
+ *
+ * | Property | Type | Description |
+ * |---|---|---|
+ * | `image` | `string` | The captured image as a base64 data URL |
+ */
+export declare const PluginPresentationViewsCaptureResult: z.ZodObject<{
+    image: z.ZodString;
+}, z.core.$strip>;
+export type PluginPresentationViewsCaptureResult = z.infer<typeof PluginPresentationViewsCaptureResult>;
+/**
+ * Arguments for {@linkcode PluginPresentationViewsApi.setActive}.
+ *
+ * | Property | Type | Description |
+ * |---|---|---|
+ * | `id` | `string` | The id of the view to activate |
+ */
+export declare const PluginPresentationViewsSetActiveArgs: z.ZodObject<{
+    id: z.ZodString;
+}, z.core.$strip>;
+export type PluginPresentationViewsSetActiveArgs = z.infer<typeof PluginPresentationViewsSetActiveArgs>;
+/** Result of {@linkcode PluginPresentationViewsApi.setActive} — the active view's id. */
+export declare const PluginPresentationViewsSetActiveResult: z.ZodObject<{
+    id: z.ZodString;
+}, z.core.$strip>;
+export type PluginPresentationViewsSetActiveResult = z.infer<typeof PluginPresentationViewsSetActiveResult>;
+/**
+ * Arguments for {@linkcode PluginPresentationViewsApi.create}. All optional.
+ *
+ * | Property | Type | Description |
+ * |---|---|---|
+ * | `name` | `string \| undefined` | Name for the new view (a default is used when omitted) |
+ * | `kind` | `"view" \| "sitePlan" \| undefined` | What kind of view to save (default `"view"`). `"plan"` is not offered — the host cannot create a plan view without a `planId` this API does not carry. |
+ */
+export declare const PluginPresentationViewsCreateArgs: z.ZodObject<{
+    name: z.ZodOptional<z.ZodString>;
+    kind: z.ZodOptional<z.ZodEnum<{
+        view: "view";
+        sitePlan: "sitePlan";
+    }>>;
+}, z.core.$strip>;
+export type PluginPresentationViewsCreateArgs = z.infer<typeof PluginPresentationViewsCreateArgs>;
+/** Result of {@linkcode PluginPresentationViewsApi.create} — the saved view. */
+export declare const PluginPresentationViewsCreateResult: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    type: z.ZodEnum<{
+        "2d": "2d";
+        "3d": "3d";
+    }>;
+    isActive: z.ZodBoolean;
+}, z.core.$strip>;
+export type PluginPresentationViewsCreateResult = z.infer<typeof PluginPresentationViewsCreateResult>;
+//# sourceMappingURL=views.d.ts.map

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

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