@snaptrude/plugin-core 0.3.0 → 0.6.0

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

@@ -0,0 +1,440 @@
+import * as z from "zod";
+import type { PluginApiReturn } from "../../types";
+declare const JsonPrimitive: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>;
+type JsonValue = z.infer<typeof JsonPrimitive> | JsonValue[] | {
+    [key: string]: JsonValue;
+};
+declare const JsonValue: z.ZodType<JsonValue>;
+export declare const PluginAIInspirationOutputKind: z.ZodEnum<{
+    image: "image";
+    source: "source";
+    video: "video";
+}>;
+export type PluginAIInspirationOutputKind = z.infer<typeof PluginAIInspirationOutputKind>;
+export declare const PluginAIInspirationModelOutput: z.ZodEnum<{
+    image: "image";
+    video: "video";
+}>;
+export type PluginAIInspirationModelOutput = z.infer<typeof PluginAIInspirationModelOutput>;
+export declare const PluginAIInspirationShapeKind: z.ZodEnum<{
+    image: "image";
+    view: "view";
+    video: "video";
+}>;
+export type PluginAIInspirationShapeKind = z.infer<typeof PluginAIInspirationShapeKind>;
+export declare const PluginAIInspirationVideoMode: z.ZodEnum<{
+    animate: "animate";
+    references: "references";
+    keyframes: "keyframes";
+}>;
+export type PluginAIInspirationVideoMode = z.infer<typeof PluginAIInspirationVideoMode>;
+export declare const PluginAIInspirationVideoMotion: z.ZodEnum<{
+    auto: "auto";
+    "slow-dolly": "slow-dolly";
+    "subtle-orbit": "subtle-orbit";
+    reveal: "reveal";
+}>;
+export type PluginAIInspirationVideoMotion = z.infer<typeof PluginAIInspirationVideoMotion>;
+export declare const PluginAIInspirationVideoDuration: z.ZodEnum<{
+    "4s": "4s";
+    "6s": "6s";
+    "8s": "8s";
+}>;
+export type PluginAIInspirationVideoDuration = z.infer<typeof PluginAIInspirationVideoDuration>;
+export declare const PluginAIInspirationRegionHint: z.ZodObject<{
+    x: z.ZodNumber;
+    y: z.ZodNumber;
+    w: z.ZodNumber;
+    h: z.ZodNumber;
+}, z.core.$strip>;
+export type PluginAIInspirationRegionHint = z.infer<typeof PluginAIInspirationRegionHint>;
+export declare const PluginAIInspirationPoint: z.ZodObject<{
+    x: z.ZodNumber;
+    y: z.ZodNumber;
+}, z.core.$strip>;
+export type PluginAIInspirationPoint = z.infer<typeof PluginAIInspirationPoint>;
+export declare const PluginAIInspirationTextAnnotation: z.ZodObject<{
+    text: z.ZodString;
+    x: z.ZodOptional<z.ZodNumber>;
+    y: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type PluginAIInspirationTextAnnotation = z.infer<typeof PluginAIInspirationTextAnnotation>;
+export declare const PluginAIInspirationSketchGuidance: z.ZodObject<{
+    visualShapeIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    textAnnotations: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        text: z.ZodString;
+        x: z.ZodOptional<z.ZodNumber>;
+        y: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export type PluginAIInspirationSketchGuidance = z.infer<typeof PluginAIInspirationSketchGuidance>;
+export declare const PluginAIInspirationSiteOptions: z.ZodObject<{
+    includeSatellite: z.ZodOptional<z.ZodBoolean>;
+    includeStreetView: z.ZodOptional<z.ZodBoolean>;
+    includeAerial: z.ZodOptional<z.ZodBoolean>;
+    aerialBearing: z.ZodOptional<z.ZodNumber>;
+    aerialPitch: z.ZodOptional<z.ZodNumber>;
+    selectedDiagramIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    location: z.ZodOptional<z.ZodObject<{
+        lat: z.ZodNumber;
+        lng: z.ZodNumber;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type PluginAIInspirationSiteOptions = z.infer<typeof PluginAIInspirationSiteOptions>;
+export declare const PluginAIInspirationAppliedPreset: z.ZodObject<{
+    source: z.ZodEnum<{
+        curated: "curated";
+        user: "user";
+    }>;
+    presetId: z.ZodString;
+    name: z.ZodString;
+    savedPresetKind: z.ZodOptional<z.ZodEnum<{
+        style: "style";
+        prompt: "prompt";
+    }>>;
+    stylePrompt: z.ZodOptional<z.ZodString>;
+    modelId: z.ZodOptional<z.ZodString>;
+    referenceImages: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        url: z.ZodString;
+        label: z.ZodOptional<z.ZodString>;
+        weight: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>>;
+    siteDefaults: z.ZodOptional<z.ZodObject<{
+        includeSatellite: z.ZodOptional<z.ZodBoolean>;
+        includeStreetView: z.ZodOptional<z.ZodBoolean>;
+        includeAerial: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type PluginAIInspirationAppliedPreset = z.infer<typeof PluginAIInspirationAppliedPreset>;
+export declare const PluginAIInspirationVideoOptions: z.ZodObject<{
+    mode: z.ZodOptional<z.ZodEnum<{
+        animate: "animate";
+        references: "references";
+        keyframes: "keyframes";
+    }>>;
+    endFrameShapeId: z.ZodOptional<z.ZodString>;
+    motion: z.ZodOptional<z.ZodEnum<{
+        auto: "auto";
+        "slow-dolly": "slow-dolly";
+        "subtle-orbit": "subtle-orbit";
+        reveal: "reveal";
+    }>>;
+    duration: z.ZodOptional<z.ZodEnum<{
+        "4s": "4s";
+        "6s": "6s";
+        "8s": "8s";
+    }>>;
+}, z.core.$strip>;
+export type PluginAIInspirationVideoOptions = z.infer<typeof PluginAIInspirationVideoOptions>;
+export declare const PluginAIInspirationModel: z.ZodObject<{
+    id: z.ZodString;
+    label: z.ZodString;
+    supportsMultiImage: z.ZodBoolean;
+    output: z.ZodEnum<{
+        image: "image";
+        video: "video";
+    }>;
+    isDefault: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export type PluginAIInspirationModel = z.infer<typeof PluginAIInspirationModel>;
+export declare const PluginAIInspirationListModelsResult: z.ZodObject<{
+    defaultModelId: z.ZodString;
+    models: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodString;
+        supportsMultiImage: z.ZodBoolean;
+        output: z.ZodEnum<{
+            image: "image";
+            video: "video";
+        }>;
+        isDefault: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type PluginAIInspirationListModelsResult = z.infer<typeof PluginAIInspirationListModelsResult>;
+export declare const PluginAIInspirationShapeRef: z.ZodObject<{
+    shapeId: z.ZodString;
+    assetId: z.ZodOptional<z.ZodString>;
+    kind: z.ZodEnum<{
+        image: "image";
+        view: "view";
+        video: "video";
+    }>;
+    name: z.ZodOptional<z.ZodString>;
+    width: z.ZodOptional<z.ZodNumber>;
+    height: z.ZodOptional<z.ZodNumber>;
+    outputType: z.ZodOptional<z.ZodEnum<{
+        image: "image";
+        source: "source";
+        video: "video";
+    }>>;
+    sourceUrl: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type PluginAIInspirationShapeRef = z.infer<typeof PluginAIInspirationShapeRef>;
+export declare const PluginAIInspirationListSourcesArgs: z.ZodObject<{
+    includeGenerated: z.ZodOptional<z.ZodBoolean>;
+    includeSourceUrl: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export type PluginAIInspirationListSourcesArgs = z.infer<typeof PluginAIInspirationListSourcesArgs>;
+export declare const PluginAIInspirationListSourcesResult: z.ZodObject<{
+    sources: z.ZodArray<z.ZodObject<{
+        shapeId: z.ZodString;
+        assetId: z.ZodOptional<z.ZodString>;
+        kind: z.ZodEnum<{
+            image: "image";
+            view: "view";
+            video: "video";
+        }>;
+        name: z.ZodOptional<z.ZodString>;
+        width: z.ZodOptional<z.ZodNumber>;
+        height: z.ZodOptional<z.ZodNumber>;
+        outputType: z.ZodOptional<z.ZodEnum<{
+            image: "image";
+            source: "source";
+            video: "video";
+        }>>;
+        sourceUrl: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type PluginAIInspirationListSourcesResult = z.infer<typeof PluginAIInspirationListSourcesResult>;
+export declare const PluginAIInspirationOutput: z.ZodObject<{
+    outputType: z.ZodEnum<{
+        image: "image";
+        video: "video";
+    }>;
+    shapeId: z.ZodString;
+    assetId: z.ZodString;
+    outputUrl: z.ZodOptional<z.ZodString>;
+    position: z.ZodOptional<z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type PluginAIInspirationOutput = z.infer<typeof PluginAIInspirationOutput>;
+export declare const PluginAIInspirationDebugSummary: z.ZodRecord<z.ZodString, z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>>;
+export type PluginAIInspirationDebugSummary = z.infer<typeof PluginAIInspirationDebugSummary>;
+export declare const PluginAIInspirationRunMetadata: z.ZodObject<{
+    geometryFidelity: z.ZodOptional<z.ZodString>;
+    debugSummary: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>>>;
+    streetViewComposite: z.ZodOptional<z.ZodObject<{
+        used: z.ZodBoolean;
+        renderMode: z.ZodEnum<{
+            prompt_refs_default: "prompt_refs_default";
+            masked_composite_pilot: "masked_composite_pilot";
+        }>;
+        backgroundLabel: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type PluginAIInspirationRunMetadata = z.infer<typeof PluginAIInspirationRunMetadata>;
+export declare const PluginAIInspirationGenerateArgs: z.ZodObject<{
+    sourceShapeId: z.ZodString;
+    prompt: z.ZodString;
+    modelId: z.ZodOptional<z.ZodString>;
+    referenceShapeIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    referenceStrength: z.ZodOptional<z.ZodEnum<{
+        low: "low";
+        medium: "medium";
+        high: "high";
+    }>>;
+    appliedPreset: z.ZodOptional<z.ZodObject<{
+        source: z.ZodEnum<{
+            curated: "curated";
+            user: "user";
+        }>;
+        presetId: z.ZodString;
+        name: z.ZodString;
+        savedPresetKind: z.ZodOptional<z.ZodEnum<{
+            style: "style";
+            prompt: "prompt";
+        }>>;
+        stylePrompt: z.ZodOptional<z.ZodString>;
+        modelId: z.ZodOptional<z.ZodString>;
+        referenceImages: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            url: z.ZodString;
+            label: z.ZodOptional<z.ZodString>;
+            weight: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>>;
+        siteDefaults: z.ZodOptional<z.ZodObject<{
+            includeSatellite: z.ZodOptional<z.ZodBoolean>;
+            includeStreetView: z.ZodOptional<z.ZodBoolean>;
+            includeAerial: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    site: z.ZodOptional<z.ZodObject<{
+        includeSatellite: z.ZodOptional<z.ZodBoolean>;
+        includeStreetView: z.ZodOptional<z.ZodBoolean>;
+        includeAerial: z.ZodOptional<z.ZodBoolean>;
+        aerialBearing: z.ZodOptional<z.ZodNumber>;
+        aerialPitch: z.ZodOptional<z.ZodNumber>;
+        selectedDiagramIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        location: z.ZodOptional<z.ZodObject<{
+            lat: z.ZodNumber;
+            lng: z.ZodNumber;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    regionHint: z.ZodOptional<z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+        w: z.ZodNumber;
+        h: z.ZodNumber;
+    }, z.core.$strip>>;
+    sketchGuidance: z.ZodOptional<z.ZodObject<{
+        visualShapeIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        textAnnotations: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            text: z.ZodString;
+            x: z.ZodOptional<z.ZodNumber>;
+            y: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>>;
+    video: z.ZodOptional<z.ZodObject<{
+        mode: z.ZodOptional<z.ZodEnum<{
+            animate: "animate";
+            references: "references";
+            keyframes: "keyframes";
+        }>>;
+        endFrameShapeId: z.ZodOptional<z.ZodString>;
+        motion: z.ZodOptional<z.ZodEnum<{
+            auto: "auto";
+            "slow-dolly": "slow-dolly";
+            "subtle-orbit": "subtle-orbit";
+            reveal: "reveal";
+        }>>;
+        duration: z.ZodOptional<z.ZodEnum<{
+            "4s": "4s";
+            "6s": "6s";
+            "8s": "8s";
+        }>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type PluginAIInspirationGenerateArgs = z.infer<typeof PluginAIInspirationGenerateArgs>;
+export declare const PluginAIInspirationRunResult: z.ZodObject<{
+    outputs: z.ZodArray<z.ZodObject<{
+        outputType: z.ZodEnum<{
+            image: "image";
+            video: "video";
+        }>;
+        shapeId: z.ZodString;
+        assetId: z.ZodString;
+        outputUrl: z.ZodOptional<z.ZodString>;
+        position: z.ZodOptional<z.ZodObject<{
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    metadata: z.ZodOptional<z.ZodObject<{
+        geometryFidelity: z.ZodOptional<z.ZodString>;
+        debugSummary: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>>>;
+        streetViewComposite: z.ZodOptional<z.ZodObject<{
+            used: z.ZodBoolean;
+            renderMode: z.ZodEnum<{
+                prompt_refs_default: "prompt_refs_default";
+                masked_composite_pilot: "masked_composite_pilot";
+            }>;
+            backgroundLabel: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type PluginAIInspirationRunResult = z.infer<typeof PluginAIInspirationRunResult>;
+export declare const PluginAIInspirationRefineArgs: z.ZodObject<{
+    sourceShapeId: z.ZodString;
+    upscaleFactor: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<1.5>, z.ZodLiteral<2>, z.ZodLiteral<4>]>>;
+}, z.core.$strip>;
+export type PluginAIInspirationRefineArgs = z.infer<typeof PluginAIInspirationRefineArgs>;
+/**
+ * Present-mode AI Inspiration APIs.
+ *
+ * These APIs operate on Present canvas shape IDs and inherit the current user's
+ * AI quota. They create outputs on the Present canvas; pure backend generation
+ * without canvas output is intentionally out of scope.
+ *
+ * Accessed via `snaptrude.presentation.aiInspiration`.
+ */
+export declare abstract class PluginPresentationAIInspirationApi {
+    constructor();
+    /**
+     * List AI Inspiration models that can be used for generation.
+     *
+     * @returns The default model ID and available model descriptors.
+     *
+     * @examplePrompt What AI inspiration models can I use?
+     * @examplePrompt List the available image and video models
+     * @examplePrompt Which generation model is the default?
+     *
+     * # Example
+     * ```ts
+     * const { defaultModelId, models } = await snaptrude.presentation.aiInspiration.listModels()
+     * const videoModels = models.filter((m) => m.output === "video")
+     * console.log(defaultModelId, videoModels.map((m) => m.id))
+     * ```
+     */
+    abstract listModels(): PluginApiReturn<PluginAIInspirationListModelsResult>;
+    /**
+     * List image/view/video sources on the current Present page.
+     *
+     * @param args - Optional filters. Set `includeGenerated` to include AI outputs.
+     * @returns Serializable shape references using Present canvas shape IDs.
+     *
+     * @examplePrompt List the images I can generate from on this page
+     * @examplePrompt What source shapes are on the present canvas?
+     * @examplePrompt Show me the reference images available for AI generation
+     *
+     * # Example
+     * ```ts
+     * const { sources } = await snaptrude.presentation.aiInspiration.listSources({ includeGenerated: true })
+     * for (const s of sources) console.log(s.kind, s.shapeId, s.name)
+     * ```
+     */
+    abstract listSources(args: PluginAIInspirationListSourcesArgs): PluginApiReturn<PluginAIInspirationListSourcesResult>;
+    /**
+     * Generate an image or video from a Present canvas source.
+     *
+     * @param args - Generation options including source, prompt, model, references, site context,
+     * region guidance, sketch guidance, and video options.
+     * @returns The created canvas output(s).
+     *
+     * @examplePrompt Generate an image from this sketch
+     * @examplePrompt Render the selected view as a photorealistic image
+     * @examplePrompt Make an AI image of a modern facade from this source
+     * @examplePrompt Generate a video from this image
+     * @examplePrompt Turn this massing into a rendered street view
+     *
+     * # Example
+     * ```ts
+     * const { sources } = await snaptrude.presentation.aiInspiration.listSources({})
+     * const [source, ...refs] = sources
+     * const { outputs } = await snaptrude.presentation.aiInspiration.generate({
+     *   sourceShapeId: source.shapeId,
+     *   prompt: "Photorealistic render of a modern timber facade at dusk",
+     *   referenceShapeIds: refs.slice(0, 2).map((r) => r.shapeId),
+     *   referenceStrength: "medium",
+     * })
+     * for (const out of outputs) console.log(out.outputType, out.shapeId, out.outputUrl)
+     * ```
+     */
+    abstract generate(args: PluginAIInspirationGenerateArgs): PluginApiReturn<PluginAIInspirationRunResult>;
+    /**
+     * Refine/upscale an AI Inspiration source image.
+     *
+     * @param args - Source shape and optional upscale factor.
+     * @returns The refined canvas output(s).
+     *
+     * @examplePrompt Upscale this AI image
+     * @examplePrompt Refine and sharpen the selected render
+     * @examplePrompt Make this generated image higher resolution
+     *
+     * # Example
+     * ```ts
+     * const { sources } = await snaptrude.presentation.aiInspiration.listSources({ includeGenerated: true })
+     * const image = sources.find((s) => s.kind === "image")
+     * if (image) {
+     *   const { outputs } = await snaptrude.presentation.aiInspiration.refine({
+     *     sourceShapeId: image.shapeId,
+     *     upscaleFactor: 2,
+     *   })
+     *   console.log(outputs[0].shapeId)
+     * }
+     * ```
+     */
+    abstract refine(args: PluginAIInspirationRefineArgs): PluginApiReturn<PluginAIInspirationRunResult>;
+}
+export {};
+//# sourceMappingURL=aiInspiration.d.ts.map

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

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

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

@@ -0,0 +1,81 @@
+import * as z from "zod";
+import { PluginApiReturn } from "../../types";
+/**
+ * Presentation diagrams — place diagram images onto sheets.
+ *
+ * {@linkcode PluginPresentationDiagramsApi.place} drops diagram images (by
+ * URL) onto a sheet and returns the created canvas shape ids (requires Present
+ * mode to be open). Adjacency data itself is read and computed via
+ * `program.adjacency` (see {@linkcode PluginProgramAdjacencyApi}).
+ *
+ * A future one-step spec-based `place` — which would render a diagram spec
+ * and place it in a single call — awaits a public generator from the
+ * documentation engine; until that generator exists, `place` takes ready
+ * image `urls` (we do not ship a spec-based `place` that would only throw).
+ *
+ * Accessed via `snaptrude.presentation.diagrams`.
+ */
+export declare abstract class PluginPresentationDiagramsApi {
+    constructor();
+    /**
+     * Place diagram images onto a sheet.
+     *
+     * Drops the given diagram image URLs onto a sheet and returns the ids of the
+     * created canvas shapes. Requires Present mode to be open.
+     *
+     * @param sheetId - The sheet to place onto.
+     * @param urls - Diagram image URLs to place.
+     * @param options - Optional `position` (`{ x, y }`, relative to the sheet)
+     *   for the placed images.
+     * @returns A {@linkcode PluginPresentationDiagramsPlaceResult} with the created
+     *   `shapeIds`.
+     * @throws If Present mode is not open or the sheet id is invalid.
+     *
+     * @examplePrompt Place the adjacency diagram on Sheet 1
+     * @examplePrompt Add the program diagram to the cover sheet
+     * @examplePrompt Drop these diagram images onto the layout
+     *
+     * # Example
+     * ```ts
+     * await snaptrude.presentation.diagrams.place("sheet_1", [
+     *   "https://example.com/program-diagram.png",
+     * ])
+     * ```
+     */
+    abstract place(sheetId: string, urls: string[], options?: {
+        position?: {
+            x: number;
+            y: number;
+        };
+    }): PluginApiReturn<PluginPresentationDiagramsPlaceResult>;
+}
+/**
+ * Arguments for {@linkcode PluginPresentationDiagramsApi.place}.
+ *
+ * | Property | Type | Description |
+ * |---|---|---|
+ * | `sheetId` | `string` | The sheet to place onto |
+ * | `urls` | `string[]` | Diagram image URLs |
+ * | `position` | `{ x: number; y: number } \| undefined` | Where to place them |
+ */
+export declare const PluginPresentationDiagramsPlaceArgs: z.ZodObject<{
+    sheetId: z.ZodString;
+    urls: z.ZodArray<z.ZodString>;
+    position: z.ZodOptional<z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type PluginPresentationDiagramsPlaceArgs = z.infer<typeof PluginPresentationDiagramsPlaceArgs>;
+/**
+ * Result of {@linkcode PluginPresentationDiagramsApi.place}.
+ *
+ * | Property | Type | Description |
+ * |---|---|---|
+ * | `shapeIds` | `string[]` | Ids of the created canvas shapes |
+ */
+export declare const PluginPresentationDiagramsPlaceResult: z.ZodObject<{
+    shapeIds: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+export type PluginPresentationDiagramsPlaceResult = z.infer<typeof PluginPresentationDiagramsPlaceResult>;
+//# sourceMappingURL=diagrams.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"diagrams.d.ts","sourceRoot":"","sources":["../../../src/api/presentation/diagrams.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAA;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAE7C;;;;;;;;;;;;;;GAcG;AACH,8BAAsB,6BAA6B;;IAGjD;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;aACa,KAAK,CACnB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE;YAAE,CAAC,EAAE,MAAM,CAAC;YAAC,CAAC,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,GAChD,eAAe,CAAC,qCAAqC,CAAC;CAC1D;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,mCAAmC;;;;;;;iBAI9C,CAAA;AACF,MAAM,MAAM,mCAAmC,GAAG,CAAC,CAAC,KAAK,CACvD,OAAO,mCAAmC,CAC3C,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,qCAAqC;;iBAEhD,CAAA;AACF,MAAM,MAAM,qCAAqC,GAAG,CAAC,CAAC,KAAK,CACzD,OAAO,qCAAqC,CAC7C,CAAA"}

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

@@ -0,0 +1,113 @@
+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 declare 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 } },
+     * )
+     * ```
+     */
+    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",
+     * })
+     * ```
+     */
+    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 declare const PluginPresentationImportArgs: z.ZodObject<{
+    url: z.ZodOptional<z.ZodString>;
+    dataUrl: z.ZodOptional<z.ZodString>;
+    position: z.ZodOptional<z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+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 declare const PluginPresentationImportResult: z.ZodObject<{
+    shapeIds: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+export type PluginPresentationImportResult = z.infer<typeof PluginPresentationImportResult>;
+//# sourceMappingURL=import.d.ts.map

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

@@ -0,0 +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;;;;;;;;;;;GAWG;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;CACnD;AAED;;;;;;;;;GASG;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"}