@snaptrude/plugin-core 0.10.0 → 1.0.0

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

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

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

@@ -1,13 +1,13 @@
 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.
+ * file (PDF / PNG / JPG), returning base64 by default or starting a browser download.
  *
  * 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).
+ * (svg2pdf/jspdf) or rasterized to a PNG/JPG. By default the plugin receives the
+ * encoded bytes to save, upload or preview. With `download: true`, the host
+ * initiates browser downloads and returns metadata only, keeping agent results small.
  *
  * Requires **Present mode to be open** (the documentation editor); the call
  * throws `PRECONDITION_FAILED` when it is not.
@@ -56,7 +56,8 @@ export type PluginPresentationExportResolution = z.infer<typeof PluginPresentati
  * | `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) |
+ * | `fileName` | `string \| undefined` | Base file name WITHOUT an extension (`"Floor Pattern View"`, never `"Floor Pattern View.pdf"`); the host appends the extension for the format, and a name ending in .pdf/.svg/.png/.jpg/.jpeg, a dot or a space is rejected |
+ * | `download` | `boolean \| undefined` | Start browser downloads and return metadata without base64 (default `false`) |
  */
 export declare const PluginPresentationExportArgs: z.ZodObject<{
     format: z.ZodEnum<{
@@ -71,8 +72,11 @@ export declare const PluginPresentationExportArgs: z.ZodObject<{
         height: z.ZodNumber;
     }, z.core.$strip>>;
     fileName: z.ZodOptional<z.ZodString>;
+    download: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>;
 export type PluginPresentationExportArgs = z.infer<typeof PluginPresentationExportArgs>;
+/** Options after the positional export format. Omitted `download` preserves base64 results. */
+export type PluginPresentationExportOptions = Omit<PluginPresentationExportArgs, "format">;
 /**
  * A single exported file.
  *
@@ -105,4 +109,18 @@ export declare const PluginPresentationExportResult: z.ZodObject<{
     }, z.core.$strip>>;
 }, z.core.$strip>;
 export type PluginPresentationExportResult = z.infer<typeof PluginPresentationExportResult>;
+/**
+ * Metadata-only result for `download: true`. `downloadStarted` confirms initiation,
+ * not an OS-saved file: browsers may require multiple-download permission. No base64
+ * is returned. Default exports retain their existing result and TypeScript contract.
+ */
+export declare const PluginPresentationExportDownloadResult: z.ZodObject<{
+    files: z.ZodArray<z.ZodObject<{
+        fileName: z.ZodString;
+        mimeType: z.ZodString;
+        byteLength: z.ZodNumber;
+    }, z.core.$strip>>;
+    downloadStarted: z.ZodBoolean;
+}, z.core.$strip>;
+export type PluginPresentationExportDownloadResult = z.infer<typeof PluginPresentationExportDownloadResult>;
 //# sourceMappingURL=export.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"export.d.ts","sourceRoot":"","sources":["../../../src/api/presentation/export.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAA;AAExB;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;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"}
+{"version":3,"file":"export.d.ts","sourceRoot":"","sources":["../../../src/api/presentation/export.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAA;AAGxB;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;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;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;iBAOvC,CAAA;AACF,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAChD,OAAO,4BAA4B,CACpC,CAAA;AAED,+FAA+F;AAC/F,MAAM,MAAM,+BAA+B,GAAG,IAAI,CAChD,4BAA4B,EAC5B,QAAQ,CACT,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;AAED;;;;GAIG;AACH,eAAO,MAAM,sCAAsC;;;;;;;iBAOjD,CAAA;AACF,MAAM,MAAM,sCAAsC,GAAG,CAAC,CAAC,KAAK,CAC1D,OAAO,sCAAsC,CAC9C,CAAA"}

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

@@ -0,0 +1,419 @@
+import * as z from "zod";
+import type { PluginApiReturn } from "../../types";
+/** A saved view id. Omit it to address the current Design/BIM view. */
+export declare const PluginGraphicsViewId: z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>;
+export type PluginGraphicsViewId = z.infer<typeof PluginGraphicsViewId>;
+/** A scale denominator: 50 means 1:50, not a world-coordinate multiplier. */
+export declare const PluginGraphicsScale: z.ZodNumber;
+export declare const PluginGraphicsDetailLevel: z.ZodEnum<{
+    coarse: "coarse";
+    fine: "fine";
+}>;
+export type PluginGraphicsDetailLevel = z.infer<typeof PluginGraphicsDetailLevel>;
+export declare const PluginGraphicsViewKind: z.ZodEnum<{
+    elevation: "elevation";
+    plan: "plan";
+    section: "section";
+    "three-d": "three-d";
+}>;
+export declare const PluginGraphicsPen: z.ZodNumber;
+/** Native Object Styles category keys; use these keys rather than the displayed plural labels. */
+export declare const PluginGraphicsModelCategory: z.ZodEnum<{
+    "Buildable Envelope": "Buildable Envelope";
+    Ceilings: "Ceilings";
+    Columns: "Columns";
+    Departments: "Departments";
+    Doors: "Doors";
+    Floors: "Floors";
+    Furniture: "Furniture";
+    Families: "Families";
+    "Facade/Mass": "Facade/Mass";
+    Roofs: "Roofs";
+    Slabs: "Slabs";
+    Space: "Space";
+    Staircase: "Staircase";
+    Beams: "Beams";
+    Walls: "Walls";
+    Windows: "Windows";
+}>;
+export declare const PluginGraphicsAnnotationCategory: z.ZodEnum<{
+    Dimension: "Dimension";
+    Grids: "Grids";
+    Sections: "Sections";
+}>;
+export declare const PluginGraphicsCategory: z.ZodEnum<{
+    "Buildable Envelope": "Buildable Envelope";
+    Ceilings: "Ceilings";
+    Columns: "Columns";
+    Departments: "Departments";
+    Doors: "Doors";
+    Floors: "Floors";
+    Furniture: "Furniture";
+    Families: "Families";
+    "Facade/Mass": "Facade/Mass";
+    Roofs: "Roofs";
+    Slabs: "Slabs";
+    Space: "Space";
+    Staircase: "Staircase";
+    Beams: "Beams";
+    Walls: "Walls";
+    Windows: "Windows";
+    Dimension: "Dimension";
+    Grids: "Grids";
+    Sections: "Sections";
+}>;
+export declare const PluginGraphicsOverrideCategory: z.ZodEnum<{
+    "Buildable Envelope": "Buildable Envelope";
+    Ceilings: "Ceilings";
+    Columns: "Columns";
+    Departments: "Departments";
+    Doors: "Doors";
+    Floors: "Floors";
+    Furniture: "Furniture";
+    Families: "Families";
+    "Facade/Mass": "Facade/Mass";
+    Roofs: "Roofs";
+    Slabs: "Slabs";
+    Space: "Space";
+    Staircase: "Staircase";
+    Beams: "Beams";
+    Walls: "Walls";
+    Windows: "Windows";
+    Dimension: "Dimension";
+    Grids: "Grids";
+    Sections: "Sections";
+    Lines: "Lines";
+}>;
+export type PluginGraphicsOverrideCategory = z.infer<typeof PluginGraphicsOverrideCategory>;
+/** Project line-style ids. These select a pen and pattern together. */
+export declare const PluginGraphicsLineStyleId: z.ZodEnum<{
+    hidden: "hidden";
+    thin: "thin";
+    medium: "medium";
+    wide: "wide";
+    overhead: "overhead";
+    demolished: "demolished";
+    centerline: "centerline";
+}>;
+export type PluginGraphicsLineStyleId = z.infer<typeof PluginGraphicsLineStyleId>;
+/** Paper dash patterns; their lengths are paper millimetres, not model units. */
+export declare const PluginGraphicsPatternId: z.ZodEnum<{
+    center: "center";
+    hidden: "hidden";
+    overhead: "overhead";
+    demolished: "demolished";
+    solid: "solid";
+    dash: "dash";
+    "long-dash": "long-dash";
+    "loose-dash": "loose-dash";
+    dot: "dot";
+    "dash-dot": "dash-dot";
+    "dash-dot-dot": "dash-dot-dot";
+    "double-dash": "double-dash";
+    "triple-dash": "triple-dash";
+}>;
+export type PluginGraphicsPatternId = z.infer<typeof PluginGraphicsPatternId>;
+/**
+ * Machine-readable reasons in PluginError.details.reason. Wire codes remain the
+ * published PRECONDITION_FAILED (feature disabled) or VALIDATION (file errors).
+ */
+export declare const PluginPaperPensErrorReason: z.ZodEnum<{
+    PAPER_PENS_DISABLED: "PAPER_PENS_DISABLED";
+    NOT_ACTIVE_VIEW: "NOT_ACTIVE_VIEW";
+    NOT_A_STANDARD: "NOT_A_STANDARD";
+    NEWER_STANDARD: "NEWER_STANDARD";
+    STANDARD_TOO_LARGE: "STANDARD_TOO_LARGE";
+}>;
+export type PluginPaperPensErrorReason = z.infer<typeof PluginPaperPensErrorReason>;
+/**
+ * Sparse category edit. Omitted fields stay unchanged; false clears a flag and
+ * null clears a pen override. Pens are numbers 1–16, never paper-mm widths.
+ * Lines supports flags only; annotation rows do not have a cut pen.
+ */
+export declare const PluginGraphicsOverride: z.ZodObject<{
+    hidden: z.ZodOptional<z.ZodBoolean>;
+    halftone: z.ZodOptional<z.ZodBoolean>;
+    projection: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    cut: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+}, z.core.$strict>;
+export declare const PluginGraphicsOverrides: z.ZodRecord<z.ZodEnum<{
+    "Buildable Envelope": "Buildable Envelope";
+    Ceilings: "Ceilings";
+    Columns: "Columns";
+    Departments: "Departments";
+    Doors: "Doors";
+    Floors: "Floors";
+    Furniture: "Furniture";
+    Families: "Families";
+    "Facade/Mass": "Facade/Mass";
+    Roofs: "Roofs";
+    Slabs: "Slabs";
+    Space: "Space";
+    Staircase: "Staircase";
+    Beams: "Beams";
+    Walls: "Walls";
+    Windows: "Windows";
+    Dimension: "Dimension";
+    Grids: "Grids";
+    Sections: "Sections";
+    Lines: "Lines";
+}> & z.core.$partial, z.ZodObject<{
+    hidden: z.ZodOptional<z.ZodBoolean>;
+    halftone: z.ZodOptional<z.ZodBoolean>;
+    projection: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    cut: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+}, z.core.$strict>>;
+export type PluginGraphicsOverrides = z.infer<typeof PluginGraphicsOverrides>;
+/**
+ * One Design/BIM view's graphics. viewId:null means an unsaved current view.
+ * scale/scaleLabel:null means the camera has no applicable paper scale (free3D
+ * or a perspective section/elevation). Transient scale/detail edits are not saved.
+ */
+export declare const PluginViewGraphics: z.ZodObject<{
+    viewId: z.ZodNullable<z.ZodString>;
+    kind: z.ZodEnum<{
+        elevation: "elevation";
+        plan: "plan";
+        section: "section";
+        "three-d": "three-d";
+    }>;
+    scale: z.ZodNullable<z.ZodNumber>;
+    scaleLabel: z.ZodNullable<z.ZodString>;
+    isCustomScale: z.ZodBoolean;
+    detailLevel: z.ZodEnum<{
+        coarse: "coarse";
+        fine: "fine";
+    }>;
+    overrides: z.ZodRecord<z.ZodEnum<{
+        "Buildable Envelope": "Buildable Envelope";
+        Ceilings: "Ceilings";
+        Columns: "Columns";
+        Departments: "Departments";
+        Doors: "Doors";
+        Floors: "Floors";
+        Furniture: "Furniture";
+        Families: "Families";
+        "Facade/Mass": "Facade/Mass";
+        Roofs: "Roofs";
+        Slabs: "Slabs";
+        Space: "Space";
+        Staircase: "Staircase";
+        Beams: "Beams";
+        Walls: "Walls";
+        Windows: "Windows";
+        Dimension: "Dimension";
+        Grids: "Grids";
+        Sections: "Sections";
+        Lines: "Lines";
+    }> & z.core.$partial, z.ZodObject<{
+        hidden: z.ZodOptional<z.ZodBoolean>;
+        halftone: z.ZodOptional<z.ZodBoolean>;
+        projection: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        cut: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    }, z.core.$strict>>;
+}, z.core.$strip>;
+export type PluginViewGraphics = z.infer<typeof PluginViewGraphics>;
+/** The same ordered scale choices as the chip, including the current exceptional scale. */
+export declare const PluginGraphicsScaleOption: z.ZodObject<{
+    scale: z.ZodNumber;
+    label: z.ZodString;
+    isCustomScale: z.ZodBoolean;
+}, z.core.$strip>;
+export type PluginGraphicsScaleOption = z.infer<typeof PluginGraphicsScaleOption>;
+export declare const PluginGraphicsViewOptions: z.ZodObject<{
+    viewId: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+}, z.core.$strict>;
+export type PluginGraphicsViewOptions = z.infer<typeof PluginGraphicsViewOptions>;
+export declare const PluginGraphicsGetArgs: z.ZodObject<{
+    viewId: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+}, z.core.$strict>;
+export declare const PluginGraphicsSetScaleArgs: z.ZodObject<{
+    scale: z.ZodNumber;
+    options: z.ZodOptional<z.ZodObject<{
+        viewId: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export declare const PluginGraphicsSetDetailLevelArgs: z.ZodObject<{
+    level: z.ZodEnum<{
+        coarse: "coarse";
+        fine: "fine";
+    }>;
+    options: z.ZodOptional<z.ZodObject<{
+        viewId: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export declare const PluginGraphicsUpdateArgs: z.ZodObject<{
+    overrides: z.ZodRecord<z.ZodEnum<{
+        "Buildable Envelope": "Buildable Envelope";
+        Ceilings: "Ceilings";
+        Columns: "Columns";
+        Departments: "Departments";
+        Doors: "Doors";
+        Floors: "Floors";
+        Furniture: "Furniture";
+        Families: "Families";
+        "Facade/Mass": "Facade/Mass";
+        Roofs: "Roofs";
+        Slabs: "Slabs";
+        Space: "Space";
+        Staircase: "Staircase";
+        Beams: "Beams";
+        Walls: "Walls";
+        Windows: "Windows";
+        Dimension: "Dimension";
+        Grids: "Grids";
+        Sections: "Sections";
+        Lines: "Lines";
+    }> & z.core.$partial, z.ZodObject<{
+        hidden: z.ZodOptional<z.ZodBoolean>;
+        halftone: z.ZodOptional<z.ZodBoolean>;
+        projection: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        cut: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    }, z.core.$strict>>;
+    options: z.ZodOptional<z.ZodObject<{
+        viewId: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export declare const PluginGraphicsResetOptions: z.ZodObject<{
+    viewId: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+    category: z.ZodOptional<z.ZodEnum<{
+        "Buildable Envelope": "Buildable Envelope";
+        Ceilings: "Ceilings";
+        Columns: "Columns";
+        Departments: "Departments";
+        Doors: "Doors";
+        Floors: "Floors";
+        Furniture: "Furniture";
+        Families: "Families";
+        "Facade/Mass": "Facade/Mass";
+        Roofs: "Roofs";
+        Slabs: "Slabs";
+        Space: "Space";
+        Staircase: "Staircase";
+        Beams: "Beams";
+        Walls: "Walls";
+        Windows: "Windows";
+        Dimension: "Dimension";
+        Grids: "Grids";
+        Sections: "Sections";
+        Lines: "Lines";
+    }>>;
+}, z.core.$strict>;
+export type PluginGraphicsResetOptions = z.infer<typeof PluginGraphicsResetOptions>;
+export declare const PluginGraphicsResetArgs: z.ZodObject<{
+    options: z.ZodOptional<z.ZodObject<{
+        viewId: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+        category: z.ZodOptional<z.ZodEnum<{
+            "Buildable Envelope": "Buildable Envelope";
+            Ceilings: "Ceilings";
+            Columns: "Columns";
+            Departments: "Departments";
+            Doors: "Doors";
+            Floors: "Floors";
+            Furniture: "Furniture";
+            Families: "Families";
+            "Facade/Mass": "Facade/Mass";
+            Roofs: "Roofs";
+            Slabs: "Slabs";
+            Space: "Space";
+            Staircase: "Staircase";
+            Beams: "Beams";
+            Walls: "Walls";
+            Windows: "Windows";
+            Dimension: "Dimension";
+            Grids: "Grids";
+            Sections: "Sections";
+            Lines: "Lines";
+        }>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export declare const PluginGraphicsNoArgs: z.ZodObject<{}, z.core.$strict>;
+/**
+ * Paper Pens on the Design/BIM canvas. Does not require Present mode.
+ *
+ * Scale/detail use the native UI setters: saved views persist, but these two
+ * settings are not model undo steps. Overrides are one saved, undoable step.
+ * Thin Lines is a local viewer preference, never a model save/undo or peer edit.
+ * All writes refuse PRECONDITION_FAILED with details.reason=PAPER_PENS_DISABLED
+ * while canvas-view-scale is off; reads still answer. There is no flag setter.
+ */
+export declare abstract class PluginPresentationGraphicsApi {
+    /**
+     * Whether Paper Pens is enabled on this viewer. Never changes the feature flag.
+     * @returns The current canvas-view-scale value.
+     */
+    abstract isEnabled(): PluginApiReturn<boolean>;
+    /**
+     * Read a view's scale denominator, detail and category overrides.
+     * @param viewId - Saved view id; omitted uses the current view.
+     * @returns Its graphics, or null for an unknown/inaccessible saved view.
+     * @examplePrompt What scale is this plan drawn at?
+     */
+    abstract get(viewId?: PluginGraphicsViewId): PluginApiReturn<PluginViewGraphics | null>;
+    /**
+     * List the chip's scale choices for the project units, in the same order.
+     * Custom denominators need not be listed: any integer 1–24000 is valid.
+     * @param viewId - View whose current custom/other-unit scale should be included.
+     * @returns Scale records; [] for an unknown/inaccessible saved view.
+     */
+    abstract listScales(viewId?: PluginGraphicsViewId): PluginApiReturn<PluginGraphicsScaleOption[]>;
+    /**
+     * Set a paper view's denominator through the same path as the scale chip.
+     * A saved view persists this change; it is not a model undo step. Without a
+     * saved current view, only viewer state changes. Does not switch the camera. An inactive target refuses NOT_ACTIVE_VIEW.
+     * @param scale - Integer 1–24000; 50 means 1:50.
+     * @param options - Optional id must identify the active view; open another view first.
+     * @returns Updated graphics.
+     * @throws VALIDATION for an invalid denominator; PRECONDITION_FAILED when
+     *   Paper Pens is off or the target has no applicable paper scale.
+     * @examplePrompt Set this plan to 1:50
+     * @example await snaptrude.presentation.graphics.setScale(50)
+     */
+    abstract setScale(scale: number, options?: PluginGraphicsViewOptions): PluginApiReturn<PluginViewGraphics>;
+    /**
+     * Set the active plan's Coarse/Fine drawing detail through the native setter. Fine draws wall
+     * layers; this does not enable the project's Detailed View take-off setting.
+     * Saved for a saved view, not a model undo step; unsaved current views are transient.
+     * @param level - coarse or fine.
+     * @param options - Optional id must identify the active view; open another view first.
+     * @returns Updated graphics.
+     * @examplePrompt Show this plan in Fine detail
+     * @example await snaptrude.presentation.graphics.setDetailLevel("fine")
+     */
+    abstract setDetailLevel(level: PluginGraphicsDetailLevel, options?: PluginGraphicsViewOptions): PluginApiReturn<PluginViewGraphics>;
+    /**
+     * Change only supplied category fields, as one saved and undoable step.
+     * Does not edit project standards. Requires a saved view.
+     * @param overrides - Known category keys and sparse fields; false/null clear overrides.
+     * @param options - Target saved view; omitted uses the current view. Inactive views are supported.
+     * @returns Updated graphics.
+     * @examplePrompt Halftone the furniture in this view
+     * @example await snaptrude.presentation.graphics.update({ Furniture: { halftone: true } })
+     */
+    abstract update(overrides: PluginGraphicsOverrides, options?: PluginGraphicsViewOptions): PluginApiReturn<PluginViewGraphics>;
+    /**
+     * Clear one category or all category overrides, as one saved undoable step.
+     * The view's scale and detail level are preserved.
+     * @param options - Optional saved view and category; omit category to reset all rows.
+     * @returns Updated graphics.
+     */
+    abstract reset(options?: PluginGraphicsResetOptions): PluginApiReturn<PluginViewGraphics>;
+    /**
+     * Read the remembered Thin Lines preference. A disabled feature or capture
+     * suspension can make the renderer ignore a true preference temporarily.
+     * @returns The viewer preference, not the transient capture state.
+     */
+    abstract isThinLinesEnabled(): PluginApiReturn<boolean>;
+    /**
+     * Enable the viewer's Thin Lines preference. No model save, undo or peer change.
+     * capture_view and exported images deliberately suspend it and use real weights.
+     * @returns true.
+     */
+    abstract enableThinLines(): PluginApiReturn<boolean>;
+    /**
+     * Disable the viewer's Thin Lines preference. No model save, undo or peer change.
+     * @returns false.
+     */
+    abstract disableThinLines(): PluginApiReturn<boolean>;
+}
+//# sourceMappingURL=graphics.d.ts.map

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

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

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

@@ -1,15 +1,22 @@
 import { PluginApiReturn } from "../../types";
 import { PluginPresentationViewsApi } from "./views";
+import { PluginPresentationCameraApi } from "./camera";
 import { PluginPresentationAIInspirationApi } from "./aiInspiration";
 import { PluginPresentationSheetsApi } from "./sheets";
 import { PluginPresentationPlacedViewsApi } from "./placedViews";
 import { PluginPresentationDiagramsApi } from "./diagrams";
+import { PluginPresentationDrawingsApi } from "./drawings";
+import { PluginPresentationViewPresetsApi } from "./viewPresets";
 import { PluginPresentationAnnotateApi } from "./annotate";
 import { PluginPresentationShapesApi } from "./shapes";
 import { PluginPresentationTablesApi } from "./tables";
 import { PluginPresentationSlideshowApi } from "./slideshow";
 import { PluginPresentationImportApi } from "./import";
-import { PluginPresentationExportResult, type PluginPresentationExportFormat, type PluginPresentationExportResolution } from "./export";
+import { PluginPresentationWalkthroughsApi } from "./walkthroughs";
+import { PluginPresentationSectionsApi } from "./sections";
+import { PluginPresentationGraphicsApi } from "./graphics";
+import { PluginPresentationStandardsApi } from "./standards";
+import { type PluginPresentationExportResult, type PluginPresentationExportDownloadResult, type PluginPresentationExportFormat, type PluginPresentationExportOptions } from "./export";
 /**
  * Presentation APIs — prepare and assemble presentations.
  *
@@ -21,19 +28,33 @@ import { PluginPresentationExportResult, type PluginPresentationExportFormat, ty
  * 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.camera} — The Present canvas camera (screenshot, pan/zoom, frame sheets)
+ * - {@linkcode PluginPresentationApi.drawings} — Drawings made from saved views (create, rescale, crop, restyle, labels, export)
+ * - {@linkcode PluginPresentationApi.viewPresets} — Reusable drawing styles (list, get, create, update, copy, rename, delete)
+ * - {@linkcode PluginPresentationApi.sheets} — Layout sheets (list, get, create, place views and drawings)
  * - {@linkcode PluginPresentationApi.placedViews} — Views already placed on the canvas (move, scale, crop)
  * - {@linkcode PluginPresentationApi.diagrams} — Generate program/site diagram sheets, place diagram images
  * - {@linkcode PluginPresentationApi.tables} — Place data tables on sheets
  * - {@linkcode PluginPresentationApi.slideshow} — Run the Present-mode slideshow
  * - {@linkcode PluginPresentationApi.import} — Import reference images/PDFs onto the canvas
  * - {@linkcode PluginPresentationApi.aiInspiration} — Present-mode AI image/video generation
+ * - {@linkcode PluginPresentationApi.walkthroughs} — Camera paths through the model: create, play, capture, export as video
+ * - {@linkcode PluginPresentationApi.sections} — Section lines: create, edit, open their views, and read what each cuts
+ *
+ * - {@linkcode PluginPresentationApi.graphics} — Design/BIM view scale, detail, category overrides and viewer Thin Lines
+ * - {@linkcode PluginPresentationApi.standards} — Project graphic standards and standard-file interchange
  *
  * Accessed via `snaptrude.presentation`.
  */
 export declare abstract class PluginPresentationApi {
     /** Saved 2D/3D views. See {@linkcode PluginPresentationViewsApi}. */
     abstract views: PluginPresentationViewsApi;
+    /** The Present canvas camera — screenshot what is on screen, read/pan/zoom it, frame sheets (Present mode). See {@linkcode PluginPresentationCameraApi}. */
+    abstract camera: PluginPresentationCameraApi;
+    /** Drawing deliverables made from saved views, independent of sheet composition (Present mode). See {@linkcode PluginPresentationDrawingsApi}. */
+    abstract drawings: PluginPresentationDrawingsApi;
+    /** Reusable kernel-plan styles stored in the Present document. See {@linkcode PluginPresentationViewPresetsApi}. */
+    abstract viewPresets: PluginPresentationViewPresetsApi;
     /** 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}. */
@@ -55,17 +76,40 @@ export declare abstract class PluginPresentationApi {
      * {@linkcode PluginPresentationAIInspirationApi}.
      */
     abstract aiInspiration: PluginPresentationAIInspirationApi;
+    /**
+     * Walkthroughs — camera paths through the model: create (keyframes, floor
+     * points, camera-move presets), play, capture and export as video onto the
+     * Present canvas. See {@linkcode PluginPresentationWalkthroughsApi}.
+     */
+    abstract walkthroughs: PluginPresentationWalkthroughsApi;
+    /**
+     * Sections — lines on the plan that cut the model: create, edit and delete
+     * them, open their views, and read what each one cuts (`getCut`). See
+     * {@linkcode PluginPresentationSectionsApi}.
+     */
+    abstract sections: PluginPresentationSectionsApi;
+    /** Paper Pens scale, detail, overrides and Thin Lines on the Design/BIM canvas. */
+    abstract graphics: PluginPresentationGraphicsApi;
+    /** Project graphic standards in paper mm, including native file import/export. */
+    abstract standards: PluginPresentationStandardsApi;
     /**
      * 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.
+     * JPG). Return base64 by default; `download: true` initiates browser downloads
+     * and returns metadata without base64. Requires Present mode to be open.
+     * `fileName` is a base name WITHOUT an extension ("Floor Pattern View", never
+     * "Floor Pattern View.pdf"): the host appends the extension for the format, and
+     * a name ending in .pdf, .svg, .png, .jpg or .jpeg, a dot or a space is rejected.
      *
      * @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).
+     *   `resolution` (raster target size for `png`/`jpg`), `fileName` (a base name
+     *   WITHOUT an extension, e.g. "Floor Pattern View"; the host appends the
+     *   extension and rejects a name ending in .pdf/.svg/.png/.jpg/.jpeg), and `download`.
+     * @returns A `files` array (one entry for a combined PDF, one per sheet otherwise).
+     *   Downloads return {@linkcode PluginPresentationExportDownloadResult}; otherwise
+     *   {@linkcode PluginPresentationExportResult}. Download initiation does not prove
+     *   the browser saved the file; multiple downloads may require user permission.
      * @throws If Present mode is not open, a `sheetId` is unknown, or a sheet
      *   fails to serialize/encode.
      *
@@ -78,17 +122,20 @@ export declare abstract class PluginPresentationApi {
      * # Example
      * ```ts
      * const { files } = await snaptrude.presentation.export("pdf")
+     * const download = await snaptrude.presentation.export("pdf", { download: true })
      * ```
      */
-    abstract export(format: PluginPresentationExportFormat, options?: {
-        sheetIds?: string[];
-        combine?: boolean;
-        resolution?: PluginPresentationExportResolution;
-        fileName?: string;
+    abstract export(format: PluginPresentationExportFormat, options?: PluginPresentationExportOptions & {
+        download?: false;
     }): PluginApiReturn<PluginPresentationExportResult>;
+    abstract export(format: PluginPresentationExportFormat, options: PluginPresentationExportOptions & {
+        download: true;
+    }): PluginApiReturn<PluginPresentationExportDownloadResult>;
+    abstract export(format: PluginPresentationExportFormat, options?: PluginPresentationExportOptions): PluginApiReturn<PluginPresentationExportResult | PluginPresentationExportDownloadResult>;
     constructor();
 }
 export * from "./views";
+export * from "./camera";
 export * from "./sheets";
 export * from "./placedViews";
 export * from "./diagrams";
@@ -98,5 +145,12 @@ export * from "./tables";
 export * from "./slideshow";
 export * from "./import";
 export * from "./aiInspiration";
+export * from "./walkthroughs";
+export * from "./sections";
+export * from "./graphics";
+export * from "./standards";
 export * from "./export";
+export * from "./drawings";
+export * from "./drawingContract";
+export * from "./viewPresets";
 //# sourceMappingURL=index.d.ts.map