@snaptrude/plugin-core 0.7.1 → 0.9.0

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

@@ -1 +1 @@
-{"version":3,"file":"import.d.ts","sourceRoot":"","sources":["../../../src/api/presentation/import.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAA;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAE7C;;;;;;;;;;;;GAYG;AACH,8BAAsB,2BAA2B;;IAG/C;;;;;;;;;;;;;;;;;;;;;;OAsBG;aACa,KAAK,CACnB,MAAM,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,EAC1C,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE;YAAE,CAAC,EAAE,MAAM,CAAC;YAAC,CAAC,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,GAChD,eAAe,CAAC,8BAA8B,CAAC;IAElD;;;;;;;;;;;;;;;;;;;;;;;OAuBG;aACa,GAAG,CACjB,MAAM,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,EAC1C,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE;YAAE,CAAC,EAAE,MAAM,CAAC;YAAC,CAAC,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,GAChD,eAAe,CAAC,8BAA8B,CAAC;IAElD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAiCG;aACa,GAAG,CACjB,MAAM,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,EAC1C,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE;YAAE,CAAC,EAAE,MAAM,CAAC;YAAC,CAAC,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,GAChD,eAAe,CAAC,8BAA8B,CAAC;CACnD;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,4BAA4B;;;;;;;iBAQrC,CAAA;AACJ,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAChD,OAAO,4BAA4B,CACpC,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,8BAA8B;;iBAEzC,CAAA;AACF,MAAM,MAAM,8BAA8B,GAAG,CAAC,CAAC,KAAK,CAClD,OAAO,8BAA8B,CACtC,CAAA"}
+{"version":3,"file":"import.d.ts","sourceRoot":"","sources":["../../../src/api/presentation/import.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAA;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAE7C;;;;;;;;;;;;GAYG;AACH,8BAAsB,2BAA2B;;IAG/C;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;aACa,KAAK,CACnB,MAAM,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,EAC1C,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE;YAAE,CAAC,EAAE,MAAM,CAAC;YAAC,CAAC,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,GAChD,eAAe,CAAC,8BAA8B,CAAC;IAElD;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;aACa,GAAG,CACjB,MAAM,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,EAC1C,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE;YAAE,CAAC,EAAE,MAAM,CAAC;YAAC,CAAC,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,GAChD,eAAe,CAAC,8BAA8B,CAAC;IAElD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAiCG;aACa,GAAG,CACjB,MAAM,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,EAC1C,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE;YAAE,CAAC,EAAE,MAAM,CAAC;YAAC,CAAC,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,GAChD,eAAe,CAAC,8BAA8B,CAAC;CACnD;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,4BAA4B;;;;;;;iBAQrC,CAAA;AACJ,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAChD,OAAO,4BAA4B,CACpC,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,8BAA8B;;iBAEzC,CAAA;AACF,MAAM,MAAM,8BAA8B,GAAG,CAAC,CAAC,KAAK,CAClD,OAAO,8BAA8B,CACtC,CAAA"}

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

@@ -1,8 +1,13 @@
+import { PluginApiReturn } from "../../types";
 import { PluginPresentationViewsApi } from "./views";
 import { PluginPresentationAIInspirationApi } from "./aiInspiration";
 import { PluginPresentationSheetsApi } from "./sheets";
+import { PluginPresentationPlacedViewsApi } from "./placedViews";
 import { PluginPresentationDiagramsApi } from "./diagrams";
+import { PluginPresentationAnnotateApi } from "./annotate";
+import { PluginPresentationShapesApi } from "./shapes";
 import { PluginPresentationImportApi } from "./import";
+import { PluginPresentationExportResult, type PluginPresentationExportFormat, type PluginPresentationExportResolution } from "./export";
 /**
  * Presentation APIs — prepare and assemble presentations.
  *
@@ -15,6 +20,7 @@ import { PluginPresentationImportApi } from "./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.placedViews} — Views already placed on the canvas (move, scale, crop)
  * - {@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
@@ -26,8 +32,14 @@ export declare abstract class PluginPresentationApi {
     abstract views: PluginPresentationViewsApi;
     /** Layout sheets — list/get/create and place views (Present mode). See {@linkcode PluginPresentationSheetsApi}. */
     abstract sheets: PluginPresentationSheetsApi;
+    /** Placed views — layout of the view shapes on the canvas: move/scale/setScale/setCrop (Present mode). See {@linkcode PluginPresentationPlacedViewsApi}. */
+    abstract placedViews: PluginPresentationPlacedViewsApi;
     /** Program/adjacency/site diagrams — place images on sheets. See {@linkcode PluginPresentationDiagramsApi}. */
     abstract diagrams: PluginPresentationDiagramsApi;
+    /** Annotations on Present-mode sheets — text/arrows/notes/geo shapes. See {@linkcode PluginPresentationAnnotateApi}. */
+    abstract annotate: PluginPresentationAnnotateApi;
+    /** Plugin-owned keyed shapes — upsert/remove/list so reruns update instead of duplicating. See {@linkcode PluginPresentationShapesApi}. */
+    abstract shapes: PluginPresentationShapesApi;
     /** Import reference images/PDFs onto the Present canvas. See {@linkcode PluginPresentationImportApi}. */
     abstract import: PluginPresentationImportApi;
     /**
@@ -35,11 +47,46 @@ export declare abstract class PluginPresentationApi {
      * {@linkcode PluginPresentationAIInspirationApi}.
      */
     abstract aiInspiration: PluginPresentationAIInspirationApi;
+    /**
+     * Export the presentation's layout sheets to a downloadable file (PDF / PNG /
+     * JPG) and return the encoded bytes as base64. Wraps the Present-mode Export
+     * dialog pipeline headlessly. Requires Present mode to be open.
+     *
+     * @param format - Output format: `"pdf"`, `"png"`, or `"jpg"`.
+     * @param options - Optional `sheetIds` (all sheets when omitted), `combine`
+     *   (PDF only — one multi-page file vs one per sheet, default `true`),
+     *   `resolution` (raster target size for `png`/`jpg`), and `fileName`.
+     * @returns A {@linkcode PluginPresentationExportResult} — always a `files`
+     *   array (one entry for a combined PDF, one per sheet otherwise).
+     * @throws If Present mode is not open, a `sheetId` is unknown, or a sheet
+     *   fails to serialize/encode.
+     *
+     * @examplePrompt Export the presentation as a PDF
+     * @examplePrompt Download all sheets as a single PDF
+     * @examplePrompt Export sheet 1 as a PNG
+     * @examplePrompt Save the presentation sheets as JPG images
+     * @examplePrompt Export these sheets to PDF at high resolution
+     *
+     * # Example
+     * ```ts
+     * const { files } = await snaptrude.presentation.export("pdf")
+     * ```
+     */
+    abstract export(format: PluginPresentationExportFormat, options?: {
+        sheetIds?: string[];
+        combine?: boolean;
+        resolution?: PluginPresentationExportResolution;
+        fileName?: string;
+    }): PluginApiReturn<PluginPresentationExportResult>;
     constructor();
 }
 export * from "./views";
 export * from "./sheets";
+export * from "./placedViews";
 export * from "./diagrams";
+export * from "./annotate";
+export * from "./shapes";
 export * from "./import";
 export * from "./aiInspiration";
+export * from "./export";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +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;;;OAGG;IACH,SAAgB,aAAa,EAAE,kCAAkC,CAAA;;CAGlE;AAED,cAAc,SAAS,CAAA;AACvB,cAAc,UAAU,CAAA;AACxB,cAAc,YAAY,CAAA;AAC1B,cAAc,UAAU,CAAA;AACxB,cAAc,iBAAiB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/api/presentation/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAC7C,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,gCAAgC,EAAE,MAAM,eAAe,CAAA;AAChE,OAAO,EAAE,6BAA6B,EAAE,MAAM,YAAY,CAAA;AAC1D,OAAO,EAAE,6BAA6B,EAAE,MAAM,YAAY,CAAA;AAC1D,OAAO,EAAE,2BAA2B,EAAE,MAAM,UAAU,CAAA;AACtD,OAAO,EAAE,2BAA2B,EAAE,MAAM,UAAU,CAAA;AACtD,OAAO,EACL,8BAA8B,EAC9B,KAAK,8BAA8B,EACnC,KAAK,kCAAkC,EACxC,MAAM,UAAU,CAAA;AAEjB;;;;;;;;;;;;;;;;;;GAkBG;AACH,8BAAsB,qBAAqB;IACzC,qEAAqE;IACrE,SAAgB,KAAK,EAAE,0BAA0B,CAAA;IACjD,mHAAmH;IACnH,SAAgB,MAAM,EAAE,2BAA2B,CAAA;IACnD,4JAA4J;IAC5J,SAAgB,WAAW,EAAE,gCAAgC,CAAA;IAC7D,+GAA+G;IAC/G,SAAgB,QAAQ,EAAE,6BAA6B,CAAA;IACvD,wHAAwH;IACxH,SAAgB,QAAQ,EAAE,6BAA6B,CAAA;IACvD,2IAA2I;IAC3I,SAAgB,MAAM,EAAE,2BAA2B,CAAA;IACnD,yGAAyG;IACzG,SAAgB,MAAM,EAAE,2BAA2B,CAAA;IACnD;;;OAGG;IACH,SAAgB,aAAa,EAAE,kCAAkC,CAAA;IAEjE;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;aACa,MAAM,CACpB,MAAM,EAAE,8BAA8B,EACtC,OAAO,CAAC,EAAE;QACR,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;QACnB,OAAO,CAAC,EAAE,OAAO,CAAA;QACjB,UAAU,CAAC,EAAE,kCAAkC,CAAA;QAC/C,QAAQ,CAAC,EAAE,MAAM,CAAA;KAClB,GACA,eAAe,CAAC,8BAA8B,CAAC;;CAGnD;AAED,cAAc,SAAS,CAAA;AACvB,cAAc,UAAU,CAAA;AACxB,cAAc,eAAe,CAAA;AAC7B,cAAc,YAAY,CAAA;AAC1B,cAAc,YAAY,CAAA;AAC1B,cAAc,UAAU,CAAA;AACxB,cAAc,UAAU,CAAA;AACxB,cAAc,iBAAiB,CAAA;AAC/B,cAAc,UAAU,CAAA"}

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

@@ -0,0 +1,370 @@
+import * as z from "zod";
+import { PluginApiReturn } from "../../types";
+import { PluginSheetPosition } from "./sheets";
+/**
+ * Placed views — the view shapes already laid out on the Present canvas.
+ *
+ * A **placed view** is a saved view that has been dropped onto a layout sheet
+ * (or the open canvas) — the live linked view shape
+ * {@linkcode PluginPresentationSheetsApi.place} and the Present views panel's
+ * drag-drop create. These methods read and edit the **layout** of those
+ * shapes: where they sit, how big they are, their architectural scale, and
+ * their crop. To refresh a placed view's **content** from the current model,
+ * use `sheets.updatePlacedView` — content refresh lives on `sheets`,
+ * layout lives here.
+ *
+ * Reads (`list`) return `[]` when Present mode is closed; `get` and every
+ * write require Present mode to be open.
+ *
+ * Accessed via `snaptrude.presentation.placedViews`.
+ */
+export declare abstract class PluginPresentationPlacedViewsApi {
+    constructor();
+    /**
+     * List the placed views in the presentation.
+     *
+     * Returns every placed view shape on the Present canvas — those nested on a
+     * layout sheet (with that sheet's id) and those sitting loose on the canvas
+     * (`sheetId: null`). Pass `sheetId` to list only the views placed on that
+     * sheet.
+     *
+     * @param sheetId - Optional sheet id to filter by.
+     * @returns A {@linkcode PluginPresentationPlacedViewsListResult} with a
+     *   `placedViews` array (empty when Present mode is closed or nothing is
+     *   placed).
+     * @throws If `sheetId` is given but is not a sheet (with Present mode open).
+     *
+     * @examplePrompt Which views are placed on this sheet?
+     * @examplePrompt List all the placed views in the presentation
+     * @examplePrompt What's laid out on sheet 2?
+     * @examplePrompt Show me every view on the Present canvas
+     *
+     * # Example
+     * ```ts
+     * const { placedViews } = await snaptrude.presentation.placedViews.list("sheet_1")
+     * ```
+     */
+    abstract list(sheetId?: string): PluginApiReturn<PluginPresentationPlacedViewsListResult>;
+    /**
+     * Get a single placed view by its shape id.
+     *
+     * `shapeId` is the id `sheets.place` returned (also reported by `list`).
+     *
+     * @param shapeId - The id of the placed view shape to read.
+     * @returns The matching {@linkcode PluginPlacedView}.
+     * @throws If Present mode is not open, or `shapeId` is unknown or is not a
+     *   placed view.
+     *
+     * @examplePrompt Get the placed view I just dropped on the sheet
+     * @examplePrompt Read the position and scale of this placed view
+     * @examplePrompt What's the crop on shape_123?
+     *
+     * # Example
+     * ```ts
+     * const placed = await snaptrude.presentation.placedViews.get(shapeId)
+     * console.log(placed.position, placed.scale)
+     * ```
+     */
+    abstract get(shapeId: string): PluginApiReturn<PluginPlacedView>;
+    /**
+     * Move a placed view.
+     *
+     * Repositions the placed view on its sheet — `position` is the new top-left
+     * in sheet coordinates (page coordinates when the view is not on a sheet).
+     * Pass `options.sheetId` to move it onto another sheet: the view is
+     * reparented to that sheet and then positioned at `position` in the new
+     * sheet's coordinates. A grouped placed view (e.g. a sustainability 3D view
+     * with its legend) moves as one unit. Requires Present mode to be open.
+     *
+     * @param shapeId - The placed view shape to move.
+     * @param position - New top-left position (sheet-local; page coordinates
+     *   when off-sheet).
+     * @param options - Optional `sheetId` — move the view onto that sheet.
+     * @returns The updated {@linkcode PluginPlacedView}.
+     * @throws If Present mode is not open, `shapeId` is unknown or is not a
+     *   placed view, or `options.sheetId` is given but is not a sheet.
+     *
+     * @examplePrompt Move the site plan view to the top-left of sheet 2
+     * @examplePrompt Reposition this placed view to 100, 200
+     * @examplePrompt Move the hero perspective onto the cover sheet
+     *
+     * # Example
+     * ```ts
+     * await snaptrude.presentation.placedViews.move(shapeId, { x: 50, y: 50 }, {
+     *   sheetId: "sheet_2",
+     * })
+     * ```
+     */
+    abstract move(shapeId: string, position: PluginSheetPosition, options?: {
+        sheetId?: string;
+    }): PluginApiReturn<PluginPlacedView>;
+    /**
+     * Resize a placed view by a uniform factor.
+     *
+     * Scales the placed view about its top-left corner — the same resize as
+     * dragging a corner handle, aspect ratio held. Works for 2D and 3D views;
+     * labels and grouped legends resize with it. For a 2D view the **printed
+     * architectural scale changes proportionally** (doubling the size of a
+     * 1:100 plan makes it a 1:50 plan) — use
+     * {@linkcode PluginPresentationPlacedViewsApi.setScale} to land on an exact
+     * standard scale instead. Requires Present mode to be open.
+     *
+     * @param shapeId - The placed view shape to resize.
+     * @param factor - Uniform scale factor, between `0.01` and `100`
+     *   (`2` doubles the size, `0.5` halves it).
+     * @returns The updated {@linkcode PluginPlacedView}.
+     * @throws If Present mode is not open, `shapeId` is unknown or is not a
+     *   placed view, or `factor` is not a finite number between 0.01 and 100.
+     *
+     * @examplePrompt Make this placed view twice as big
+     * @examplePrompt Shrink the placed 3D view to half its size
+     * @examplePrompt Scale the placed plan up by 50%
+     *
+     * # Example
+     * ```ts
+     * await snaptrude.presentation.placedViews.scale(shapeId, 2)
+     * ```
+     */
+    abstract scale(shapeId: string, factor: number): PluginApiReturn<PluginPlacedView>;
+    /**
+     * Set a placed view's architectural scale.
+     *
+     * Applies a standard architectural scale — the same write the placed view's
+     * Scale dropdown performs. The view (and its labels) is resized about its
+     * top-left corner so it prints at the given scale. `scale` must be one of
+     * the standard values for the project's unit system (metric `10, 20, 50,
+     * 100, 150, 200, 250, 500, 1000`; imperial e.g. `48` for 1/4″ = 1′, `96`
+     * for 1/8″ = 1′, `120` for 1″ = 10′) — the same validation as
+     * `sheets.place`. 3D views have no architectural scale — calling this on
+     * one throws. Requires Present mode to be open.
+     *
+     * @param shapeId - The placed view shape to set the scale of.
+     * @param scale - A standard scale value for the project's unit system.
+     * @returns The updated {@linkcode PluginPlacedView}.
+     * @throws If Present mode is not open, `shapeId` is unknown or is not a
+     *   placed view, `scale` is not a standard value for the project's unit
+     *   system, or the placed view is a 3D view.
+     *
+     * @examplePrompt Set the plan to 1:100
+     * @examplePrompt Change the placed floor plan to 1:50 scale
+     * @examplePrompt Make this view print at quarter-inch scale
+     *
+     * # Example
+     * ```ts
+     * await snaptrude.presentation.placedViews.setScale(shapeId, 100) // 1:100
+     * ```
+     */
+    abstract setScale(shapeId: string, scale: number): PluginApiReturn<PluginPlacedView>;
+    /**
+     * Crop a placed view, or clear its crop.
+     *
+     * `crop` selects the visible window as **fractions (0–1) of the uncropped
+     * view** — `topLeft` must be strictly less than `bottomRight` on both axes.
+     * The visible region stays anchored on the page (the same behavior as the
+     * interactive crop), labels that fall outside the crop are hidden, and the
+     * view's architectural scale is untouched. Pass `null` to clear the crop
+     * and restore the full view in its uncropped footprint (the interactive
+     * double-click-edge reset). The crop **survives a content refresh**
+     * (`sheets.updatePlacedView` recomputes it against the refreshed content
+     * and only clears it when the refreshed view no longer overlaps the cropped
+     * region). Requires Present mode to be open.
+     *
+     * @param shapeId - The placed view shape to crop.
+     * @param crop - The crop window ({@linkcode PluginPlacedViewCrop},
+     *   fractions of the uncropped view), or `null` to clear.
+     * @returns The updated {@linkcode PluginPlacedView}.
+     * @throws If Present mode is not open, `shapeId` is unknown or is not a
+     *   placed view, or `crop` is not a valid 0–1 rectangle with
+     *   `topLeft < bottomRight` on both axes.
+     *
+     * @examplePrompt Crop the placed view to its left half
+     * @examplePrompt Crop this view to the top-right quarter
+     * @examplePrompt Remove the crop from the placed plan
+     *
+     * # Example
+     * ```ts
+     * // keep the left half of the view
+     * await snaptrude.presentation.placedViews.setCrop(shapeId, {
+     *   topLeft: { x: 0, y: 0 },
+     *   bottomRight: { x: 0.5, y: 1 },
+     * })
+     * await snaptrude.presentation.placedViews.setCrop(shapeId, null) // clear
+     * ```
+     */
+    abstract setCrop(shapeId: string, crop: PluginPlacedViewCrop | null): PluginApiReturn<PluginPlacedView>;
+}
+/**
+ * A crop window on a placed view, as fractions (0–1) of the **uncropped**
+ * view. `topLeft` must be strictly less than `bottomRight` on both axes.
+ *
+ * | Property | Type | Description |
+ * |---|---|---|
+ * | `topLeft` | `{ x: number, y: number }` | Top-left of the visible window (fractions 0–1) |
+ * | `bottomRight` | `{ x: number, y: number }` | Bottom-right of the visible window (fractions 0–1) |
+ */
+export declare const PluginPlacedViewCrop: z.ZodObject<{
+    topLeft: z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+    }, z.core.$strip>;
+    bottomRight: z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type PluginPlacedViewCrop = z.infer<typeof PluginPlacedViewCrop>;
+/**
+ * A view placed on the Present canvas.
+ *
+ * | Property | Type | Description |
+ * |---|---|---|
+ * | `shapeId` | `string` | Id of the placed view shape (the id `sheets.place` returns) |
+ * | `sheetId` | `string \| null` | The sheet it sits on (`null` when placed loose on the canvas) |
+ * | `title` | `string` | The saved view's title |
+ * | `viewId` | `string` | Id of the saved view it was placed from |
+ * | `position` | {@linkcode PluginSheetPosition} | Top-left position — sheet-local when on a sheet, page coordinates otherwise |
+ * | `size` | `{ width: number, height: number }` | Displayed size on the canvas |
+ * | `scale` | `number \| null` | Architectural scale (e.g. `100` = 1:100); `null` for 3D views |
+ * | `is3d` | `boolean` | Whether it is a 3D view (no architectural scale) |
+ * | `rotation` | `number` | Rotation in radians (nonzero only for 3D views) |
+ * | `crop` | {@linkcode PluginPlacedViewCrop}` \| null` | Crop window (`null` when uncropped) |
+ * | `isUnlinked` | `boolean` | Whether the source proposal was removed (an unlinked view no longer refreshes) |
+ */
+export declare const PluginPlacedView: z.ZodObject<{
+    shapeId: z.ZodString;
+    sheetId: z.ZodNullable<z.ZodString>;
+    title: z.ZodString;
+    viewId: z.ZodString;
+    position: z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+    }, z.core.$strip>;
+    size: z.ZodObject<{
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+    }, z.core.$strip>;
+    scale: z.ZodNullable<z.ZodNumber>;
+    is3d: z.ZodBoolean;
+    rotation: z.ZodNumber;
+    crop: z.ZodNullable<z.ZodObject<{
+        topLeft: z.ZodObject<{
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+        }, z.core.$strip>;
+        bottomRight: z.ZodObject<{
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+        }, z.core.$strip>;
+    }, z.core.$strip>>;
+    isUnlinked: z.ZodBoolean;
+}, z.core.$strip>;
+export type PluginPlacedView = z.infer<typeof PluginPlacedView>;
+/** Arguments for {@linkcode PluginPresentationPlacedViewsApi.list}. */
+export declare const PluginPresentationPlacedViewsListArgs: z.ZodObject<{
+    sheetId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type PluginPresentationPlacedViewsListArgs = z.infer<typeof PluginPresentationPlacedViewsListArgs>;
+/** Result of {@linkcode PluginPresentationPlacedViewsApi.list}. */
+export declare const PluginPresentationPlacedViewsListResult: z.ZodObject<{
+    placedViews: z.ZodArray<z.ZodObject<{
+        shapeId: z.ZodString;
+        sheetId: z.ZodNullable<z.ZodString>;
+        title: z.ZodString;
+        viewId: z.ZodString;
+        position: z.ZodObject<{
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+        }, z.core.$strip>;
+        size: z.ZodObject<{
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+        }, z.core.$strip>;
+        scale: z.ZodNullable<z.ZodNumber>;
+        is3d: z.ZodBoolean;
+        rotation: z.ZodNumber;
+        crop: z.ZodNullable<z.ZodObject<{
+            topLeft: z.ZodObject<{
+                x: z.ZodNumber;
+                y: z.ZodNumber;
+            }, z.core.$strip>;
+            bottomRight: z.ZodObject<{
+                x: z.ZodNumber;
+                y: z.ZodNumber;
+            }, z.core.$strip>;
+        }, z.core.$strip>>;
+        isUnlinked: z.ZodBoolean;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type PluginPresentationPlacedViewsListResult = z.infer<typeof PluginPresentationPlacedViewsListResult>;
+/** Arguments for {@linkcode PluginPresentationPlacedViewsApi.get}. */
+export declare const PluginPresentationPlacedViewsGetArgs: z.ZodObject<{
+    shapeId: z.ZodString;
+}, z.core.$strip>;
+export type PluginPresentationPlacedViewsGetArgs = z.infer<typeof PluginPresentationPlacedViewsGetArgs>;
+/**
+ * Arguments for {@linkcode PluginPresentationPlacedViewsApi.move}.
+ *
+ * | Property | Type | Description |
+ * |---|---|---|
+ * | `shapeId` | `string` | The placed view shape to move |
+ * | `position` | {@linkcode PluginSheetPosition} | New top-left position (sheet-local; page coordinates when off-sheet) |
+ * | `sheetId` | `string`? | Move the view onto this sheet |
+ */
+export declare const PluginPresentationPlacedViewsMoveArgs: z.ZodObject<{
+    shapeId: z.ZodString;
+    position: z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+    }, z.core.$strip>;
+    sheetId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type PluginPresentationPlacedViewsMoveArgs = z.infer<typeof PluginPresentationPlacedViewsMoveArgs>;
+/**
+ * Arguments for {@linkcode PluginPresentationPlacedViewsApi.scale}.
+ *
+ * | Property | Type | Description |
+ * |---|---|---|
+ * | `shapeId` | `string` | The placed view shape to resize |
+ * | `factor` | `number` | Uniform scale factor (0.01–100) |
+ */
+export declare const PluginPresentationPlacedViewsScaleArgs: z.ZodObject<{
+    shapeId: z.ZodString;
+    factor: z.ZodNumber;
+}, z.core.$strip>;
+export type PluginPresentationPlacedViewsScaleArgs = z.infer<typeof PluginPresentationPlacedViewsScaleArgs>;
+/**
+ * Arguments for {@linkcode PluginPresentationPlacedViewsApi.setScale}.
+ *
+ * | Property | Type | Description |
+ * |---|---|---|
+ * | `shapeId` | `string` | The placed view shape to set the scale of |
+ * | `scale` | `number` | A standard scale value for the project's unit system |
+ */
+export declare const PluginPresentationPlacedViewsSetScaleArgs: z.ZodObject<{
+    shapeId: z.ZodString;
+    scale: z.ZodNumber;
+}, z.core.$strip>;
+export type PluginPresentationPlacedViewsSetScaleArgs = z.infer<typeof PluginPresentationPlacedViewsSetScaleArgs>;
+/**
+ * Arguments for {@linkcode PluginPresentationPlacedViewsApi.setCrop}.
+ *
+ * | Property | Type | Description |
+ * |---|---|---|
+ * | `shapeId` | `string` | The placed view shape to crop |
+ * | `crop` | {@linkcode PluginPlacedViewCrop}` \| null` | The crop window, or `null` to clear |
+ */
+export declare const PluginPresentationPlacedViewsSetCropArgs: z.ZodObject<{
+    shapeId: z.ZodString;
+    crop: z.ZodNullable<z.ZodObject<{
+        topLeft: z.ZodObject<{
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+        }, z.core.$strip>;
+        bottomRight: z.ZodObject<{
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+        }, z.core.$strip>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type PluginPresentationPlacedViewsSetCropArgs = z.infer<typeof PluginPresentationPlacedViewsSetCropArgs>;
+//# sourceMappingURL=placedViews.d.ts.map

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

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