@snaptrude/plugin-core 0.3.0 → 0.5.0

package/src/api/presentation/import.ts

@@ -0,0 +1,112 @@
+import * as z from "zod"
+import { PluginApiReturn } from "../../types"
+
+/**
+ * Presentation import — bring external reference assets onto the Present canvas.
+ *
+ * `import.image` places a reference image and `import.pdf` places a PDF (each
+ * page vectorized to SVG) onto the current Present sheet, returning the created
+ * canvas shape ids. Requires Present mode to be open.
+ *
+ * The host engine takes a browser `File`, which a plugin worker cannot supply,
+ * so these accept a `url`/`dataUrl` that the host adapts into a `File`.
+ *
+ * Accessed via `snaptrude.presentation.import`.
+ */
+export abstract class PluginPresentationImportApi {
+  constructor() {}
+
+  /**
+   * Import a reference image onto the current Present sheet.
+   *
+   * @param source - The asset to import: exactly one of `url` or `dataUrl`.
+   * @param options - Optional `position` — where to place the image on the
+   *   sheet.
+   * @returns A {@linkcode PluginPresentationImportResult} with the created
+   *   `shapeIds`.
+   * @throws If Present mode is not open or the source cannot be loaded.
+   *
+   * @examplePrompt Import this reference image onto the present canvas
+   * @examplePrompt Add a JPG to my presentation board
+   * @examplePrompt Drop this site photo onto the current sheet
+   * @examplePrompt Bring an inspiration image into Present mode
+   *
+   * # Example
+   * ```ts
+   * const { shapeIds } = await snaptrude.presentation.import.image(
+   *   { url: "https://example.com/ref.png" },
+   *   { position: { x: 200, y: 150 } },
+   * )
+   * ```
+   */
+  public abstract image(
+    source: { url?: string; dataUrl?: string },
+    options?: { position?: { x: number; y: number } },
+  ): PluginApiReturn<PluginPresentationImportResult>
+
+  /**
+   * Import a PDF onto the current Present sheet (one shape per page).
+   *
+   * Each page is converted to vector SVG and placed as a canvas shape.
+   *
+   * @param source - The asset to import: exactly one of `url` or `dataUrl`.
+   * @param options - Optional `position` — where to place the pages on the
+   *   sheet.
+   * @returns A {@linkcode PluginPresentationImportResult} with one `shapeId` per
+   *   page.
+   * @throws If Present mode is not open or the source cannot be loaded.
+   *
+   * @examplePrompt Import this PDF onto the present canvas
+   * @examplePrompt Add a multi-page PDF reference to my board
+   * @examplePrompt Bring a PDF floor plan into Present mode as vectors
+   * @examplePrompt Place each page of this PDF on the sheet
+   *
+   * # Example
+   * ```ts
+   * const { shapeIds } = await snaptrude.presentation.import.pdf({
+   *   url: "https://example.com/plans.pdf",
+   * })
+   * ```
+   */
+  public abstract pdf(
+    source: { url?: string; dataUrl?: string },
+    options?: { position?: { x: number; y: number } },
+  ): PluginApiReturn<PluginPresentationImportResult>
+}
+
+/**
+ * Arguments for {@linkcode PluginPresentationImportApi.image} /
+ * {@linkcode PluginPresentationImportApi.pdf}. Provide exactly one source.
+ *
+ * | Property | Type | Description |
+ * |---|---|---|
+ * | `url` | `string \| undefined` | URL of the asset to import |
+ * | `dataUrl` | `string \| undefined` | Base64 data URL of the asset |
+ * | `position` | `{ x: number; y: number } \| undefined` | Where to place it on the sheet |
+ */
+export const PluginPresentationImportArgs = z
+  .object({
+    url: z.string().optional(),
+    dataUrl: z.string().optional(),
+    position: z.object({ x: z.number(), y: z.number() }).optional(),
+  })
+  .refine((a) => Boolean(a.url) || Boolean(a.dataUrl), {
+    message: "Provide a url or a dataUrl",
+  })
+export type PluginPresentationImportArgs = z.infer<
+  typeof PluginPresentationImportArgs
+>
+
+/**
+ * Result of an import.
+ *
+ * | Property | Type | Description |
+ * |---|---|---|
+ * | `shapeIds` | `string[]` | Ids of the created canvas shapes (one per page for PDFs) |
+ */
+export const PluginPresentationImportResult = z.object({
+  shapeIds: z.array(z.string()),
+})
+export type PluginPresentationImportResult = z.infer<
+  typeof PluginPresentationImportResult
+>

package/src/api/presentation/index.ts

@@ -0,0 +1,48 @@
+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 abstract class PluginPresentationApi {
+  /** Saved 2D/3D views. See {@linkcode PluginPresentationViewsApi}. */
+  public abstract views: PluginPresentationViewsApi
+  /** Layout sheets — list/get/create and place views (Present mode). See {@linkcode PluginPresentationSheetsApi}. */
+  public abstract sheets: PluginPresentationSheetsApi
+  /** Program/adjacency/site diagrams — place images on sheets. See {@linkcode PluginPresentationDiagramsApi}. */
+  public abstract diagrams: PluginPresentationDiagramsApi
+  /** Import reference images/PDFs onto the Present canvas. See {@linkcode PluginPresentationImportApi}. */
+  public 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.)_
+   */
+  public aiInspiration?: PluginPresentationAIInspirationApi
+
+  constructor() {}
+}
+
+export * from "./views"
+export * from "./sheets"
+export * from "./diagrams"
+export * from "./import"
+export * from "./aiInspiration"

package/src/api/presentation/sheets.ts

@@ -0,0 +1,198 @@
+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 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()
+   * ```
+   */
+  public 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")
+   * ```
+   */
+  public 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")
+   * ```
+   */
+  public 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")
+   * ```
+   */
+  public 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 const PluginPresentationSheet = z.object({
+  id: z.string(),
+  name: z.string(),
+})
+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 const PluginSheetPosition = z.object({
+  x: z.number(),
+  y: z.number(),
+})
+export type PluginSheetPosition = z.infer<typeof PluginSheetPosition>
+
+/** Result of {@linkcode PluginPresentationSheetsApi.list}. */
+export const PluginPresentationSheetsListResult = z.object({
+  sheets: z.array(PluginPresentationSheet),
+})
+export type PluginPresentationSheetsListResult = z.infer<
+  typeof PluginPresentationSheetsListResult
+>
+
+/** Arguments for {@linkcode PluginPresentationSheetsApi.get}. */
+export const PluginPresentationSheetsGetArgs = z.object({
+  id: z.string(),
+})
+export type PluginPresentationSheetsGetArgs = z.infer<
+  typeof PluginPresentationSheetsGetArgs
+>
+
+/** Result of {@linkcode PluginPresentationSheetsApi.get} — the sheet, or `null`. */
+export const PluginPresentationSheetsGetResult =
+  PluginPresentationSheet.nullable()
+export type PluginPresentationSheetsGetResult = z.infer<
+  typeof PluginPresentationSheetsGetResult
+>
+
+/** Arguments for {@linkcode PluginPresentationSheetsApi.create}. */
+export const PluginPresentationSheetsCreateArgs = z.object({
+  name: z.string().optional(),
+})
+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 const PluginPresentationSheetsPlaceArgs = z.object({
+  sheetId: z.string(),
+  viewId: z.string(),
+  position: PluginSheetPosition.optional(),
+})
+export type PluginPresentationSheetsPlaceArgs = z.infer<
+  typeof PluginPresentationSheetsPlaceArgs
+>
+
+/**
+ * Result of {@linkcode PluginPresentationSheetsApi.place}.
+ *
+ * | Property | Type | Description |
+ * |---|---|---|
+ * | `shapeId` | `string` | Id of the created canvas shape |
+ */
+export const PluginPresentationSheetsPlaceResult = z.object({
+  shapeId: z.string(),
+})
+export type PluginPresentationSheetsPlaceResult = z.infer<
+  typeof PluginPresentationSheetsPlaceResult
+>

package/src/api/presentation/views.ts

@@ -0,0 +1,303 @@
+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 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")
+   * ```
+   */
+  public 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")
+   * ```
+   */
+  public 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()
+   * ```
+   */
+  public 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" })
+   * ```
+   */
+  public 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")
+   * ```
+   */
+  public 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")
+   * ```
+   */
+  public 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 const PluginPresentationViewType = z.enum(["2d", "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 const PluginPresentationView = z.object({
+  id: z.string(),
+  name: z.string(),
+  type: PluginPresentationViewType,
+  isActive: z.boolean(),
+})
+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 const PluginPresentationViewsListResult = z.object({
+  views: z.array(PluginPresentationView),
+})
+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 const PluginPresentationViewsGetArgs = z.object({
+  id: z.string(),
+})
+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 const PluginPresentationViewsGetResult =
+  PluginPresentationView.nullable()
+export type PluginPresentationViewsGetResult = z.infer<
+  typeof PluginPresentationViewsGetResult
+>
+
+/** Image format for {@linkcode PluginPresentationViewsApi.capture}. */
+export const PluginPresentationImageFormat = z.enum(["png", "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 const PluginPresentationViewsCaptureArgs = z.object({
+  viewId: z.string().optional(),
+  format: PluginPresentationImageFormat.optional(),
+  resolution: z.string().optional(),
+})
+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 const PluginPresentationViewsCaptureResult = z.object({
+  image: z.string(),
+})
+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 const PluginPresentationViewsSetActiveArgs = z.object({
+  id: z.string(),
+})
+export type PluginPresentationViewsSetActiveArgs = z.infer<
+  typeof PluginPresentationViewsSetActiveArgs
+>
+
+/** Result of {@linkcode PluginPresentationViewsApi.setActive} — the active view's id. */
+export const PluginPresentationViewsSetActiveResult = z.object({
+  id: z.string(),
+})
+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 const PluginPresentationViewsCreateArgs = z.object({
+  name: z.string().optional(),
+  kind: z.enum(["view", "sitePlan"]).optional(),
+})
+export type PluginPresentationViewsCreateArgs = z.infer<
+  typeof PluginPresentationViewsCreateArgs
+>
+
+/** Result of {@linkcode PluginPresentationViewsApi.create} — the saved view. */
+export const PluginPresentationViewsCreateResult = PluginPresentationView
+export type PluginPresentationViewsCreateResult = z.infer<
+  typeof PluginPresentationViewsCreateResult
+>