@snaptrude/plugin-core 0.7.0 → 0.8.0

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

@@ -0,0 +1,104 @@
+import * as z from "zod";
+/**
+ * Presentation export — render the Present-mode layout sheets to a downloadable
+ * file (PDF / PNG / JPG) and hand the plugin the bytes as base64.
+ *
+ * This wraps the same pipeline the Present-mode **Export** dialog drives:
+ * each sheet is serialized to an SVG, then either composed into a PDF
+ * (svg2pdf/jspdf) or rasterized to a PNG/JPG. Nothing is written to disk
+ * host-side — the plugin receives the encoded bytes and decides what to do
+ * with them (save, upload, preview).
+ *
+ * Requires **Present mode to be open** (the documentation editor); the call
+ * throws `PRECONDITION_FAILED` when it is not.
+ *
+ * The result is always a uniform `{ files }` array (see
+ * {@linkcode PluginPresentationExportResult}):
+ * - `pdf` with `combine` (the default) → a single multi-page file.
+ * - `pdf` with `combine: false`, or any `png`/`jpg` → one file per sheet.
+ *
+ * Accessed via `snaptrude.presentation.export`.
+ *
+ * The schemas and result types live here; the callable method is declared on
+ * {@linkcode PluginPresentationApi.export}.
+ */
+/** Output file format: a vector `pdf`, or a rasterized `png` / `jpg`. */
+export declare const PluginPresentationExportFormat: z.ZodEnum<{
+    pdf: "pdf";
+    png: "png";
+    jpg: "jpg";
+}>;
+export type PluginPresentationExportFormat = z.infer<typeof PluginPresentationExportFormat>;
+/**
+ * Target pixel dimensions for a rasterized (`png`/`jpg`) export. Ignored for
+ * `pdf`, which stays vector and takes its size from the sheet.
+ *
+ * | Property | Type | Description |
+ * |---|---|---|
+ * | `width` | `number` | Output width in pixels |
+ * | `height` | `number` | Output height in pixels |
+ */
+export declare const PluginPresentationExportResolution: z.ZodObject<{
+    width: z.ZodNumber;
+    height: z.ZodNumber;
+}, z.core.$strip>;
+export type PluginPresentationExportResolution = z.infer<typeof PluginPresentationExportResolution>;
+/**
+ * Arguments for {@linkcode PluginPresentationApi.export}.
+ *
+ * | Property | Type | Description |
+ * |---|---|---|
+ * | `format` | `"pdf" \| "png" \| "jpg"` | Output format |
+ * | `sheetIds` | `string[] \| undefined` | Sheets to export (all sheets when omitted) |
+ * | `combine` | `boolean \| undefined` | PDF only: one multi-page file (default `true`) vs one file per sheet |
+ * | `resolution` | {@linkcode PluginPresentationExportResolution}` \| undefined` | Raster target size (`png`/`jpg` only) |
+ * | `fileName` | `string \| undefined` | Base file name (without extension) |
+ */
+export declare const PluginPresentationExportArgs: z.ZodObject<{
+    format: z.ZodEnum<{
+        pdf: "pdf";
+        png: "png";
+        jpg: "jpg";
+    }>;
+    sheetIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    combine: z.ZodOptional<z.ZodBoolean>;
+    resolution: z.ZodOptional<z.ZodObject<{
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+    }, z.core.$strip>>;
+    fileName: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type PluginPresentationExportArgs = z.infer<typeof PluginPresentationExportArgs>;
+/**
+ * A single exported file.
+ *
+ * | Property | Type | Description |
+ * |---|---|---|
+ * | `fileName` | `string` | File name including extension |
+ * | `mimeType` | `string` | MIME type (`application/pdf`, `image/png`, `image/jpeg`) |
+ * | `dataBase64` | `string` | The file bytes, base64-encoded (no data-URL prefix) |
+ */
+export declare const PluginPresentationExportFile: z.ZodObject<{
+    fileName: z.ZodString;
+    mimeType: z.ZodString;
+    dataBase64: z.ZodString;
+}, z.core.$strip>;
+export type PluginPresentationExportFile = z.infer<typeof PluginPresentationExportFile>;
+/**
+ * Result of {@linkcode PluginPresentationApi.export} — always a `files` array.
+ * A combined PDF yields one entry; per-sheet exports yield one entry each, in
+ * sheet order.
+ *
+ * | Property | Type | Description |
+ * |---|---|---|
+ * | `files` | {@linkcode PluginPresentationExportFile}`[]` | The exported files |
+ */
+export declare const PluginPresentationExportResult: z.ZodObject<{
+    files: z.ZodArray<z.ZodObject<{
+        fileName: z.ZodString;
+        mimeType: z.ZodString;
+        dataBase64: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type PluginPresentationExportResult = z.infer<typeof PluginPresentationExportResult>;
+//# sourceMappingURL=export.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"export.d.ts","sourceRoot":"","sources":["../../../src/api/presentation/export.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAA;AAExB;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,yEAAyE;AACzE,eAAO,MAAM,8BAA8B;;;;EAAgC,CAAA;AAC3E,MAAM,MAAM,8BAA8B,GAAG,CAAC,CAAC,KAAK,CAClD,OAAO,8BAA8B,CACtC,CAAA;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,kCAAkC;;;iBAG7C,CAAA;AACF,MAAM,MAAM,kCAAkC,GAAG,CAAC,CAAC,KAAK,CACtD,OAAO,kCAAkC,CAC1C,CAAA;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;iBAMvC,CAAA;AACF,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAChD,OAAO,4BAA4B,CACpC,CAAA;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,4BAA4B;;;;iBAIvC,CAAA;AACF,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAChD,OAAO,4BAA4B,CACpC,CAAA;AAED;;;;;;;;GAQG;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,11 @@
+import { PluginApiReturn } from "../../types";
 import { PluginPresentationViewsApi } from "./views";
 import { PluginPresentationAIInspirationApi } from "./aiInspiration";
 import { PluginPresentationSheetsApi } from "./sheets";
 import { PluginPresentationDiagramsApi } from "./diagrams";
+import { PluginPresentationAnnotateApi } from "./annotate";
 import { PluginPresentationImportApi } from "./import";
+import { PluginPresentationExportResult, type PluginPresentationExportFormat, type PluginPresentationExportResolution } from "./export";
 /**
  * Presentation APIs — prepare and assemble presentations.
  *
@@ -28,19 +31,53 @@ export declare abstract class PluginPresentationApi {
     abstract sheets: PluginPresentationSheetsApi;
     /** 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;
     /** 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.)_
+     * {@linkcode PluginPresentationAIInspirationApi}.
      */
-    aiInspiration?: 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 "./diagrams";
+export * from "./annotate";
 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;;;;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"}
+{"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,6BAA6B,EAAE,MAAM,YAAY,CAAA;AAC1D,OAAO,EAAE,6BAA6B,EAAE,MAAM,YAAY,CAAA;AAC1D,OAAO,EAAE,2BAA2B,EAAE,MAAM,UAAU,CAAA;AACtD,OAAO,EACL,8BAA8B,EAC9B,KAAK,8BAA8B,EACnC,KAAK,kCAAkC,EACxC,MAAM,UAAU,CAAA;AAEjB;;;;;;;;;;;;;;;;;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,wHAAwH;IACxH,SAAgB,QAAQ,EAAE,6BAA6B,CAAA;IACvD,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,YAAY,CAAA;AAC1B,cAAc,YAAY,CAAA;AAC1B,cAAc,UAAU,CAAA;AACxB,cAAc,iBAAiB,CAAA;AAC/B,cAAc,UAAU,CAAA"}