@grida/svg-editor 1.0.0-alpha.3 → 1.0.0-alpha.4

package/dist/dom-DJnZhtOd.d.mts

@@ -0,0 +1,48 @@
+import { a as SurfaceHandle, d as Gestures, g as Camera, o as SvgEditor } from "./editor-Uu6dZX4y.mjs";
+import cmath from "@grida/cmath";
+
+//#region src/dom.d.ts
+type DomSurfaceOptions = {
+  /** Mount the SVG inside this container. */container: HTMLElement;
+  /**
+   * Install the default gesture set (wheel-pan/zoom, space-drag, middle-mouse,
+   * keyboard zoom). Default `true`. Pass `false` to start blank and bind à la
+   * carte via `handle.gestures.bind(...)`.
+   */
+  gestures?: boolean;
+  /**
+   * Auto-fit the document into the viewport on initial attach. Default
+   * `false`. Mirrors Excalidraw's `initialData.scrollToContent`.
+   * Subsequent `editor.load()` calls do NOT re-fit — call
+   * `handle.camera.fit("<root>")` yourself if you want that behavior.
+   */
+  fit?: boolean;
+  /**
+   * Initial camera transform. Default `cmath.transform.identity`. Ignored
+   * when `fit: true`.
+   */
+  initial_camera?: cmath.Transform;
+};
+/**
+ * Surface handle for the DOM surface. Extends the editor's core
+ * `SurfaceHandle` with the viewport-scoped concerns: pan/zoom (`camera`)
+ * and pointer/wheel/keyboard gesture bindings (`gestures`).
+ *
+ * Camera + gestures are **surface-scoped**: detaching the surface drops
+ * both. They never appear on the headless `SvgEditor`.
+ */
+type DomSurfaceHandle = SurfaceHandle & {
+  camera: Camera;
+  gestures: Gestures;
+};
+/**
+ * Attach a DOM surface to a headless editor. Returns a `DomSurfaceHandle`
+ * whose `detach()` is the inverse — DOM cleared, listeners removed,
+ * gestures uninstalled.
+ *
+ * Usage is one-shot per container: the surface owns the container's children
+ * for its lifetime, and `detach()` restores it to empty.
+ */
+declare function attach_dom_surface(editor: SvgEditor, options: DomSurfaceOptions): DomSurfaceHandle;
+//#endregion
+export { DomSurfaceOptions as n, attach_dom_surface as r, DomSurfaceHandle as t };

package/dist/dom.d.mts

@@ -1,48 +1,2 @@
-import { a as SurfaceHandle, d as Gestures, g as Camera, o as SvgEditor } from "./editor-DSADZszj.mjs";
-import cmath from "@grida/cmath";
-
-//#region src/dom.d.ts
-type DomSurfaceOptions = {
-  /** Mount the SVG inside this container. */container: HTMLElement;
-  /**
-   * Install the default gesture set (wheel-pan/zoom, space-drag, middle-mouse,
-   * keyboard zoom). Default `true`. Pass `false` to start blank and bind à la
-   * carte via `handle.gestures.bind(...)`.
-   */
-  gestures?: boolean;
-  /**
-   * Auto-fit the document into the viewport on initial attach. Default
-   * `false`. Mirrors Excalidraw's `initialData.scrollToContent`.
-   * Subsequent `editor.load()` calls do NOT re-fit — call
-   * `handle.camera.fit("<root>")` yourself if you want that behavior.
-   */
-  fit?: boolean;
-  /**
-   * Initial camera transform. Default `cmath.transform.identity`. Ignored
-   * when `fit: true`.
-   */
-  initial_camera?: cmath.Transform;
-};
-/**
- * Surface handle for the DOM surface. Extends the editor's core
- * `SurfaceHandle` with the viewport-scoped concerns: pan/zoom (`camera`)
- * and pointer/wheel/keyboard gesture bindings (`gestures`).
- *
- * Camera + gestures are **surface-scoped**: detaching the surface drops
- * both. They never appear on the headless `SvgEditor`.
- */
-type DomSurfaceHandle = SurfaceHandle & {
-  camera: Camera;
-  gestures: Gestures;
-};
-/**
- * Attach a DOM surface to a headless editor. Returns a `DomSurfaceHandle`
- * whose `detach()` is the inverse — DOM cleared, listeners removed,
- * gestures uninstalled.
- *
- * Usage is one-shot per container: the surface owns the container's children
- * for its lifetime, and `detach()` restores it to empty.
- */
-declare function attach_dom_surface(editor: SvgEditor, options: DomSurfaceOptions): DomSurfaceHandle;
-//#endregion
+import { n as DomSurfaceOptions, r as attach_dom_surface, t as DomSurfaceHandle } from "./dom-DJnZhtOd.mjs";
 export { DomSurfaceHandle, DomSurfaceOptions, attach_dom_surface };

package/dist/dom.d.ts

@@ -1,48 +1,2 @@
-import { a as SurfaceHandle, d as Gestures, g as Camera, o as SvgEditor } from "./editor-Da446SPO.js";
-import cmath from "@grida/cmath";
-
-//#region src/dom.d.ts
-type DomSurfaceOptions = {
-  /** Mount the SVG inside this container. */container: HTMLElement;
-  /**
-   * Install the default gesture set (wheel-pan/zoom, space-drag, middle-mouse,
-   * keyboard zoom). Default `true`. Pass `false` to start blank and bind à la
-   * carte via `handle.gestures.bind(...)`.
-   */
-  gestures?: boolean;
-  /**
-   * Auto-fit the document into the viewport on initial attach. Default
-   * `false`. Mirrors Excalidraw's `initialData.scrollToContent`.
-   * Subsequent `editor.load()` calls do NOT re-fit — call
-   * `handle.camera.fit("<root>")` yourself if you want that behavior.
-   */
-  fit?: boolean;
-  /**
-   * Initial camera transform. Default `cmath.transform.identity`. Ignored
-   * when `fit: true`.
-   */
-  initial_camera?: cmath.Transform;
-};
-/**
- * Surface handle for the DOM surface. Extends the editor's core
- * `SurfaceHandle` with the viewport-scoped concerns: pan/zoom (`camera`)
- * and pointer/wheel/keyboard gesture bindings (`gestures`).
- *
- * Camera + gestures are **surface-scoped**: detaching the surface drops
- * both. They never appear on the headless `SvgEditor`.
- */
-type DomSurfaceHandle = SurfaceHandle & {
-  camera: Camera;
-  gestures: Gestures;
-};
-/**
- * Attach a DOM surface to a headless editor. Returns a `DomSurfaceHandle`
- * whose `detach()` is the inverse — DOM cleared, listeners removed,
- * gestures uninstalled.
- *
- * Usage is one-shot per container: the surface owns the container's children
- * for its lifetime, and `detach()` restores it to empty.
- */
-declare function attach_dom_surface(editor: SvgEditor, options: DomSurfaceOptions): DomSurfaceHandle;
-//#endregion
+import { n as DomSurfaceOptions, r as attach_dom_surface, t as DomSurfaceHandle } from "./dom-Cn-RtjRL.js";
 export { DomSurfaceHandle, DomSurfaceOptions, attach_dom_surface };

package/dist/dom.js

@@ -1,3 +1,3 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_dom = require("./dom-BlJZWpR_.js");
+const require_dom = require("./dom-CoVZzFqy.js");
 exports.attach_dom_surface = require_dom.attach_dom_surface;

package/dist/dom.mjs

@@ -1,2 +1,2 @@
-import { t as attach_dom_surface } from "./dom-D-5D_3o0.mjs";
+import { t as attach_dom_surface } from "./dom-CmOu0HvI.mjs";
 export { attach_dom_surface };

package/dist/{editor-DP36h-SE.mjs → editor-CjK56cgb.mjs}

@@ -1,4 +1,4 @@
-import { i as apply_translate, l as is_text_input_focused, n as serialize_paint, o as capture_translate_baseline, t as parse_paint } from "./paint-BTKvRItP.mjs";
+import { i as apply_translate, l as is_text_input_focused, n as serialize_paint, o as capture_translate_baseline, t as parse_paint } from "./paint-Cfiw4g_J.mjs";
 import { HistoryImpl } from "@grida/history";
 import { KeyCode, M, chunkKey, eventToChunk, getKeyboardOS, kb, keybindingsToKeyCodes } from "@grida/keybinding";
 //#region src/commands/registry.ts
@@ -1318,6 +1318,13 @@ function createSvgEditor(opts) {
 	let doc_version = 0;
 	/** doc_version at the last load()/serialize(); compared to derive `dirty`. */
 	let baseline_doc_version = 0;
+	/**
+	* Bumps once per `editor.load(svg)` call. The constructor's initial parse
+	* does NOT count — it's the "factory" state. Hosts subscribe via
+	* `subscribe_with_selector(s => s.load_version, ...)` to react to fresh
+	* document loads without firing on every edit.
+	*/
+	let load_version = 0;
 	let style = {
 		...DEFAULT_STYLE,
 		...opts.style ?? {}
@@ -1335,7 +1342,8 @@ function createSvgEditor(opts) {
 			can_undo: history.stack.canUndo,
 			can_redo: history.stack.canRedo,
 			version,
-			structure_version: doc.structure_version
+			structure_version: doc.structure_version,
+			load_version
 		});
 	}
 	function emit() {
@@ -1643,6 +1651,7 @@ function createSvgEditor(opts) {
 		mode = "select";
 		history.clear();
 		baseline_doc_version = doc_version;
+		load_version++;
 		emit();
 	}
 	function serialize_svg() {

package/dist/{editor-Da446SPO.d.ts → editor-D2l_CDr0.d.ts}

@@ -158,6 +158,17 @@ type EditorState = {
    * `structure_version` so a drag doesn't invalidate the tree view.
    */
   readonly structure_version: number;
+  /**
+   * Bumps once per `editor.load(svg)` call. Distinct from
+   * `structure_version` (which bumps on edits too). Starts at 0; the
+   * constructor's initial SVG does NOT count as a load. Use this when
+   * you want to react to "a new document was loaded" — e.g. refit
+   * camera to the new root, reset host-side UI state, clear per-file
+   * scratch — without firing on text edits, reorders, or deletes.
+   *
+   * Monotonic, never resets.
+   */
+  readonly load_version: number;
 };
 type Unsubscribe = () => void;
 type ReorderDirection = "bring_forward" | "send_backward" | "bring_to_front" | "send_to_back";
@@ -186,6 +197,22 @@ type CameraOptions = {
   resolve_bounds: BoundsResolver;
   initial?: cmath.Transform;
 };
+/**
+ * Camera viewport constraint. Discriminated union with `type` so future
+ * variants (`'contain'`, `'pan-region'`) can be added without breaking
+ * existing call sites — each future variant has its own payload shape.
+ *
+ * v1.1 ships only `'cover'`. CSS analogy: `object-fit: cover` — the
+ * bounds rect covers the viewport edge-to-edge. Zoom is lower-bounded
+ * at fit-with-padding; pan is clamped so the bounds always covers the
+ * viewport. Use for slide / page / kiosk UX where the user should
+ * never see past the artwork.
+ */
+type CameraConstraints = {
+  /** Bounds cover viewport (viewport ⊆ bounds). Keynote / slide UX. */type: "cover"; /** World-space rect, or `"<root>"` to resolve via BoundsResolver. */
+  bounds: Rect | "<root>"; /** Screen-pixel breathing room between bounds and viewport edge. */
+  padding?: number;
+};
 /**
  * Surface-scoped pan/zoom state.
  *
@@ -199,7 +226,19 @@ declare class Camera {
   private viewport_h;
   private listeners;
   private resolve_bounds;
+  private _constraints;
   constructor(opts: CameraOptions);
+  /**
+   * Current viewport constraint, or `null` for free pan/zoom. Set with
+   * `camera.constraints = { type: 'cover', bounds: '<root>', padding: 80 }`
+   * to clamp zoom + pan; assign `null` to clear.
+   *
+   * Constraints are applied synchronously inside `set_transform` (and
+   * `_set_viewport_size`), so every public mutation respects them
+   * automatically — the host never needs to subscribe-and-clamp itself.
+   */
+  get constraints(): CameraConstraints | null;
+  set constraints(c: CameraConstraints | null);
   /** Underlying 2D affine. World→screen. */
   get transform(): cmath.Transform;
   /** Uniform scale factor. 1 = 100 %. */
@@ -227,6 +266,10 @@ declare class Camera {
    * makes external constraint loops (e.g. "subscribe → compute clamped →
    * set_transform") terminate: the clamp re-emits the same transform on
    * the second pass, set_transform short-circuits, no recursion.
+   *
+   * When `camera.constraints` is non-null, the input transform is clamped
+   * synchronously before being stored — every public mutation respects the
+   * constraint automatically.
    */
   set_transform(t: cmath.Transform): void;
   /** Viewport size in screen pixels. Read by host code computing constraints. */
@@ -262,6 +305,19 @@ declare class Camera {
   screen_to_world(p: Vec2): Vec2;
   /** Convert a world-space point to screen-space. */
   world_to_screen(p: Vec2): Vec2;
+  /**
+   * Apply the current constraint (if any) to a candidate transform.
+   * Pure: returns the clamped result, never mutates state. Returns the
+   * input unchanged when constraints are null / bounds are unresolvable /
+   * viewport is 0.
+   */
+  private apply_constraints;
+  /**
+   * Re-clamp the stored transform against the current constraint. Called
+   * from the `constraints` setter; `_set_viewport_size` has its own
+   * notify-inclusive path.
+   */
+  private reenforce;
   private notify;
 }
 //#endregion
@@ -759,4 +815,4 @@ declare function createSvgEditor(opts: CreateSvgEditorOptions): {
   keymap: Keymap;
 };
 //#endregion
-export { Mode as A, RadialGradientDefinition as B, FileIOProvider as C, GradientStop as D, GradientEntry as E, PaintValue as F, ReorderDirection as H, PreviewSession as I, PropertyValue as L, Paint as M, PaintFallback as N, InvalidComputedValue as O, PaintPreviewSession as P, Provenance as R, EditorStyle as S, GradientDefinition as T, Unsubscribe as U, Rect as V, Vec2 as W, CameraOptions as _, SurfaceHandle as a, DEFAULT_STYLE as b, GestureBinding as c, Gestures as d, KeymapBinding as f, Camera as g, BoundsResolver as h, DomComputedResolver as i, NodeId as j, LinearGradientDefinition as k, GestureContext as l, CommandId as m, CreateSvgEditorOptions as n, SvgEditor as o, CommandHandler as p, DomComputedPaint as r, createSvgEditor as s, Commands as t, GestureId as u, ClipboardProvider as v, FontResolver as w, EditorState as x, Color as y, Providers as z };
+export { LinearGradientDefinition as A, Providers as B, EditorStyle as C, GradientEntry as D, GradientDefinition as E, PaintPreviewSession as F, Vec2 as G, Rect as H, PaintValue as I, PreviewSession as L, NodeId as M, Paint as N, GradientStop as O, PaintFallback as P, PropertyValue as R, EditorState as S, FontResolver as T, ReorderDirection as U, RadialGradientDefinition as V, Unsubscribe as W, CameraConstraints as _, SurfaceHandle as a, Color as b, GestureBinding as c, Gestures as d, KeymapBinding as f, Camera as g, BoundsResolver as h, DomComputedResolver as i, Mode as j, InvalidComputedValue as k, GestureContext as l, CommandId as m, CreateSvgEditorOptions as n, SvgEditor as o, CommandHandler as p, DomComputedPaint as r, createSvgEditor as s, Commands as t, GestureId as u, CameraOptions as v, FileIOProvider as w, DEFAULT_STYLE as x, ClipboardProvider as y, Provenance as z };

package/dist/{editor-Eon0043Z.js → editor-D2zZAyny.js}

@@ -1,5 +1,5 @@
-require("./dom-BlJZWpR_.js");
-const require_paint = require("./paint-CVLZazOa.js");
+require("./dom-CoVZzFqy.js");
+const require_paint = require("./paint-dDV-Trt9.js");
 let _grida_history = require("@grida/history");
 let _grida_keybinding = require("@grida/keybinding");
 //#region src/commands/registry.ts
@@ -1319,6 +1319,13 @@ function createSvgEditor(opts) {
 	let doc_version = 0;
 	/** doc_version at the last load()/serialize(); compared to derive `dirty`. */
 	let baseline_doc_version = 0;
+	/**
+	* Bumps once per `editor.load(svg)` call. The constructor's initial parse
+	* does NOT count — it's the "factory" state. Hosts subscribe via
+	* `subscribe_with_selector(s => s.load_version, ...)` to react to fresh
+	* document loads without firing on every edit.
+	*/
+	let load_version = 0;
 	let style = {
 		...DEFAULT_STYLE,
 		...opts.style ?? {}
@@ -1336,7 +1343,8 @@ function createSvgEditor(opts) {
 			can_undo: history.stack.canUndo,
 			can_redo: history.stack.canRedo,
 			version,
-			structure_version: doc.structure_version
+			structure_version: doc.structure_version,
+			load_version
 		});
 	}
 	function emit() {
@@ -1644,6 +1652,7 @@ function createSvgEditor(opts) {
 		mode = "select";
 		history.clear();
 		baseline_doc_version = doc_version;
+		load_version++;
 		emit();
 	}
 	function serialize_svg() {

package/dist/{editor-DSADZszj.d.mts → editor-Uu6dZX4y.d.mts}

@@ -158,6 +158,17 @@ type EditorState = {
    * `structure_version` so a drag doesn't invalidate the tree view.
    */
   readonly structure_version: number;
+  /**
+   * Bumps once per `editor.load(svg)` call. Distinct from
+   * `structure_version` (which bumps on edits too). Starts at 0; the
+   * constructor's initial SVG does NOT count as a load. Use this when
+   * you want to react to "a new document was loaded" — e.g. refit
+   * camera to the new root, reset host-side UI state, clear per-file
+   * scratch — without firing on text edits, reorders, or deletes.
+   *
+   * Monotonic, never resets.
+   */
+  readonly load_version: number;
 };
 type Unsubscribe = () => void;
 type ReorderDirection = "bring_forward" | "send_backward" | "bring_to_front" | "send_to_back";
@@ -186,6 +197,22 @@ type CameraOptions = {
   resolve_bounds: BoundsResolver;
   initial?: cmath.Transform;
 };
+/**
+ * Camera viewport constraint. Discriminated union with `type` so future
+ * variants (`'contain'`, `'pan-region'`) can be added without breaking
+ * existing call sites — each future variant has its own payload shape.
+ *
+ * v1.1 ships only `'cover'`. CSS analogy: `object-fit: cover` — the
+ * bounds rect covers the viewport edge-to-edge. Zoom is lower-bounded
+ * at fit-with-padding; pan is clamped so the bounds always covers the
+ * viewport. Use for slide / page / kiosk UX where the user should
+ * never see past the artwork.
+ */
+type CameraConstraints = {
+  /** Bounds cover viewport (viewport ⊆ bounds). Keynote / slide UX. */type: "cover"; /** World-space rect, or `"<root>"` to resolve via BoundsResolver. */
+  bounds: Rect | "<root>"; /** Screen-pixel breathing room between bounds and viewport edge. */
+  padding?: number;
+};
 /**
  * Surface-scoped pan/zoom state.
  *
@@ -199,7 +226,19 @@ declare class Camera {
   private viewport_h;
   private listeners;
   private resolve_bounds;
+  private _constraints;
   constructor(opts: CameraOptions);
+  /**
+   * Current viewport constraint, or `null` for free pan/zoom. Set with
+   * `camera.constraints = { type: 'cover', bounds: '<root>', padding: 80 }`
+   * to clamp zoom + pan; assign `null` to clear.
+   *
+   * Constraints are applied synchronously inside `set_transform` (and
+   * `_set_viewport_size`), so every public mutation respects them
+   * automatically — the host never needs to subscribe-and-clamp itself.
+   */
+  get constraints(): CameraConstraints | null;
+  set constraints(c: CameraConstraints | null);
   /** Underlying 2D affine. World→screen. */
   get transform(): cmath.Transform;
   /** Uniform scale factor. 1 = 100 %. */
@@ -227,6 +266,10 @@ declare class Camera {
    * makes external constraint loops (e.g. "subscribe → compute clamped →
    * set_transform") terminate: the clamp re-emits the same transform on
    * the second pass, set_transform short-circuits, no recursion.
+   *
+   * When `camera.constraints` is non-null, the input transform is clamped
+   * synchronously before being stored — every public mutation respects the
+   * constraint automatically.
    */
   set_transform(t: cmath.Transform): void;
   /** Viewport size in screen pixels. Read by host code computing constraints. */
@@ -262,6 +305,19 @@ declare class Camera {
   screen_to_world(p: Vec2): Vec2;
   /** Convert a world-space point to screen-space. */
   world_to_screen(p: Vec2): Vec2;
+  /**
+   * Apply the current constraint (if any) to a candidate transform.
+   * Pure: returns the clamped result, never mutates state. Returns the
+   * input unchanged when constraints are null / bounds are unresolvable /
+   * viewport is 0.
+   */
+  private apply_constraints;
+  /**
+   * Re-clamp the stored transform against the current constraint. Called
+   * from the `constraints` setter; `_set_viewport_size` has its own
+   * notify-inclusive path.
+   */
+  private reenforce;
   private notify;
 }
 //#endregion
@@ -759,4 +815,4 @@ declare function createSvgEditor(opts: CreateSvgEditorOptions): {
   keymap: Keymap;
 };
 //#endregion
-export { Mode as A, RadialGradientDefinition as B, FileIOProvider as C, GradientStop as D, GradientEntry as E, PaintValue as F, ReorderDirection as H, PreviewSession as I, PropertyValue as L, Paint as M, PaintFallback as N, InvalidComputedValue as O, PaintPreviewSession as P, Provenance as R, EditorStyle as S, GradientDefinition as T, Unsubscribe as U, Rect as V, Vec2 as W, CameraOptions as _, SurfaceHandle as a, DEFAULT_STYLE as b, GestureBinding as c, Gestures as d, KeymapBinding as f, Camera as g, BoundsResolver as h, DomComputedResolver as i, NodeId as j, LinearGradientDefinition as k, GestureContext as l, CommandId as m, CreateSvgEditorOptions as n, SvgEditor as o, CommandHandler as p, DomComputedPaint as r, createSvgEditor as s, Commands as t, GestureId as u, ClipboardProvider as v, FontResolver as w, EditorState as x, Color as y, Providers as z };
+export { LinearGradientDefinition as A, Providers as B, EditorStyle as C, GradientEntry as D, GradientDefinition as E, PaintPreviewSession as F, Vec2 as G, Rect as H, PaintValue as I, PreviewSession as L, NodeId as M, Paint as N, GradientStop as O, PaintFallback as P, PropertyValue as R, EditorState as S, FontResolver as T, ReorderDirection as U, RadialGradientDefinition as V, Unsubscribe as W, CameraConstraints as _, SurfaceHandle as a, Color as b, GestureBinding as c, Gestures as d, KeymapBinding as f, Camera as g, BoundsResolver as h, DomComputedResolver as i, Mode as j, InvalidComputedValue as k, GestureContext as l, CommandId as m, CreateSvgEditorOptions as n, SvgEditor as o, CommandHandler as p, DomComputedPaint as r, createSvgEditor as s, Commands as t, GestureId as u, CameraOptions as v, FileIOProvider as w, DEFAULT_STYLE as x, ClipboardProvider as y, Provenance as z };

package/dist/index-CHiXYO9-.d.ts

@@ -0,0 +1 @@
+export { };

package/dist/index-ThDLM4Am.d.mts

@@ -0,0 +1 @@
+export { };

package/dist/index.d.mts

@@ -1,2 +1,2 @@
-import { A as Mode, B as RadialGradientDefinition, C as FileIOProvider, D as GradientStop, E as GradientEntry, F as PaintValue, H as ReorderDirection, I as PreviewSession, L as PropertyValue, M as Paint, N as PaintFallback, O as InvalidComputedValue, P as PaintPreviewSession, R as Provenance, S as EditorStyle, T as GradientDefinition, U as Unsubscribe, V as Rect, W as Vec2, _ as CameraOptions, a as SurfaceHandle, b as DEFAULT_STYLE, c as GestureBinding, d as Gestures, f as KeymapBinding, g as Camera, h as BoundsResolver, i as DomComputedResolver, j as NodeId, k as LinearGradientDefinition, l as GestureContext, m as CommandId, n as CreateSvgEditorOptions, o as SvgEditor, p as CommandHandler, r as DomComputedPaint, s as createSvgEditor, t as Commands, u as GestureId, v as ClipboardProvider, w as FontResolver, x as EditorState, y as Color, z as Providers } from "./editor-DSADZszj.mjs";
-export { type BoundsResolver, type Camera, type CameraOptions, type ClipboardProvider, type Color, type CommandHandler, type CommandId, type Commands, type CreateSvgEditorOptions, DEFAULT_STYLE, type DomComputedPaint, type DomComputedResolver, type EditorState, type EditorStyle, type FileIOProvider, type FontResolver, type GestureBinding, type GestureContext, type GestureId, type Gestures, type GradientDefinition, type GradientEntry, type GradientStop, type InvalidComputedValue, type KeymapBinding, type LinearGradientDefinition, type Mode, type NodeId, type Paint, type PaintFallback, type PaintPreviewSession, type PaintValue, type PreviewSession, type PropertyValue, type Provenance, type Providers, type RadialGradientDefinition, type Rect, type ReorderDirection, type SurfaceHandle, type SvgEditor, type Unsubscribe, type Vec2, createSvgEditor };
+import { A as LinearGradientDefinition, B as Providers, C as EditorStyle, D as GradientEntry, E as GradientDefinition, F as PaintPreviewSession, G as Vec2, H as Rect, I as PaintValue, L as PreviewSession, M as NodeId, N as Paint, O as GradientStop, P as PaintFallback, R as PropertyValue, S as EditorState, T as FontResolver, U as ReorderDirection, V as RadialGradientDefinition, W as Unsubscribe, _ as CameraConstraints, a as SurfaceHandle, b as Color, c as GestureBinding, d as Gestures, f as KeymapBinding, g as Camera, h as BoundsResolver, i as DomComputedResolver, j as Mode, k as InvalidComputedValue, l as GestureContext, m as CommandId, n as CreateSvgEditorOptions, o as SvgEditor, p as CommandHandler, r as DomComputedPaint, s as createSvgEditor, t as Commands, u as GestureId, v as CameraOptions, w as FileIOProvider, x as DEFAULT_STYLE, y as ClipboardProvider, z as Provenance } from "./editor-Uu6dZX4y.mjs";
+export { BoundsResolver, Camera, CameraConstraints, CameraOptions, ClipboardProvider, Color, CommandHandler, CommandId, Commands, CreateSvgEditorOptions, DEFAULT_STYLE, DomComputedPaint, DomComputedResolver, EditorState, EditorStyle, FileIOProvider, FontResolver, GestureBinding, GestureContext, GestureId, Gestures, GradientDefinition, GradientEntry, GradientStop, InvalidComputedValue, KeymapBinding, LinearGradientDefinition, Mode, NodeId, Paint, PaintFallback, PaintPreviewSession, PaintValue, PreviewSession, PropertyValue, Provenance, Providers, RadialGradientDefinition, Rect, ReorderDirection, SurfaceHandle, SvgEditor, Unsubscribe, Vec2, createSvgEditor };

package/dist/index.d.ts

@@ -1,2 +1,2 @@
-import { A as Mode, B as RadialGradientDefinition, C as FileIOProvider, D as GradientStop, E as GradientEntry, F as PaintValue, H as ReorderDirection, I as PreviewSession, L as PropertyValue, M as Paint, N as PaintFallback, O as InvalidComputedValue, P as PaintPreviewSession, R as Provenance, S as EditorStyle, T as GradientDefinition, U as Unsubscribe, V as Rect, W as Vec2, _ as CameraOptions, a as SurfaceHandle, b as DEFAULT_STYLE, c as GestureBinding, d as Gestures, f as KeymapBinding, g as Camera, h as BoundsResolver, i as DomComputedResolver, j as NodeId, k as LinearGradientDefinition, l as GestureContext, m as CommandId, n as CreateSvgEditorOptions, o as SvgEditor, p as CommandHandler, r as DomComputedPaint, s as createSvgEditor, t as Commands, u as GestureId, v as ClipboardProvider, w as FontResolver, x as EditorState, y as Color, z as Providers } from "./editor-Da446SPO.js";
-export { type BoundsResolver, type Camera, type CameraOptions, type ClipboardProvider, type Color, type CommandHandler, type CommandId, type Commands, type CreateSvgEditorOptions, DEFAULT_STYLE, type DomComputedPaint, type DomComputedResolver, type EditorState, type EditorStyle, type FileIOProvider, type FontResolver, type GestureBinding, type GestureContext, type GestureId, type Gestures, type GradientDefinition, type GradientEntry, type GradientStop, type InvalidComputedValue, type KeymapBinding, type LinearGradientDefinition, type Mode, type NodeId, type Paint, type PaintFallback, type PaintPreviewSession, type PaintValue, type PreviewSession, type PropertyValue, type Provenance, type Providers, type RadialGradientDefinition, type Rect, type ReorderDirection, type SurfaceHandle, type SvgEditor, type Unsubscribe, type Vec2, createSvgEditor };
+import { A as LinearGradientDefinition, B as Providers, C as EditorStyle, D as GradientEntry, E as GradientDefinition, F as PaintPreviewSession, G as Vec2, H as Rect, I as PaintValue, L as PreviewSession, M as NodeId, N as Paint, O as GradientStop, P as PaintFallback, R as PropertyValue, S as EditorState, T as FontResolver, U as ReorderDirection, V as RadialGradientDefinition, W as Unsubscribe, _ as CameraConstraints, a as SurfaceHandle, b as Color, c as GestureBinding, d as Gestures, f as KeymapBinding, g as Camera, h as BoundsResolver, i as DomComputedResolver, j as Mode, k as InvalidComputedValue, l as GestureContext, m as CommandId, n as CreateSvgEditorOptions, o as SvgEditor, p as CommandHandler, r as DomComputedPaint, s as createSvgEditor, t as Commands, u as GestureId, v as CameraOptions, w as FileIOProvider, x as DEFAULT_STYLE, y as ClipboardProvider, z as Provenance } from "./editor-D2l_CDr0.js";
+export { BoundsResolver, Camera, CameraConstraints, CameraOptions, ClipboardProvider, Color, CommandHandler, CommandId, Commands, CreateSvgEditorOptions, DEFAULT_STYLE, DomComputedPaint, DomComputedResolver, EditorState, EditorStyle, FileIOProvider, FontResolver, GestureBinding, GestureContext, GestureId, Gestures, GradientDefinition, GradientEntry, GradientStop, InvalidComputedValue, KeymapBinding, LinearGradientDefinition, Mode, NodeId, Paint, PaintFallback, PaintPreviewSession, PaintValue, PreviewSession, PropertyValue, Provenance, Providers, RadialGradientDefinition, Rect, ReorderDirection, SurfaceHandle, SvgEditor, Unsubscribe, Vec2, createSvgEditor };

package/dist/index.js

@@ -1,4 +1,4 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_editor = require("./editor-Eon0043Z.js");
+const require_editor = require("./editor-D2zZAyny.js");
 exports.DEFAULT_STYLE = require_editor.DEFAULT_STYLE;
 exports.createSvgEditor = require_editor.createSvgEditor;

package/dist/index.mjs

@@ -1,2 +1,2 @@
-import { n as DEFAULT_STYLE, t as createSvgEditor } from "./editor-DP36h-SE.mjs";
+import { n as DEFAULT_STYLE, t as createSvgEditor } from "./editor-CjK56cgb.mjs";
 export { DEFAULT_STYLE, createSvgEditor };

package/dist/{paint-CVLZazOa.js → paint-dDV-Trt9.js}

@@ -1,4 +1,4 @@
-require("./dom-BlJZWpR_.js");
+require("./dom-CoVZzFqy.js");
 let svg_pathdata = require("svg-pathdata");
 //#region src/util/dom.ts
 /**

package/dist/presets.d.mts

@@ -0,0 +1,46 @@
+import { o as SvgEditor } from "./editor-Uu6dZX4y.mjs";
+import { n as DomSurfaceOptions, t as DomSurfaceHandle } from "./dom-DJnZhtOd.mjs";
+declare namespace keynote_d_exports {
+  export { KeynoteAttachOptions, KeynoteSurfaceHandle, attach };
+}
+type KeynoteAttachOptions = {
+  /** Container to mount the SVG into. */container: HTMLElement;
+  /**
+   * Screen-pixel breathing room between the slide and the viewport edge.
+   * Used for both initial fit and the cover-constraint clamp. Default 80.
+   */
+  padding?: number;
+  /**
+   * Forward additional surface options (e.g. `gestures: false`). `container`,
+   * `fit`, and `initial_camera` are owned by the preset.
+   */
+  surface?: Omit<DomSurfaceOptions, "container" | "fit" | "initial_camera">;
+};
+/**
+ * Surface handle returned by `keynote.attach`. Extends `DomSurfaceHandle`
+ * with `set_padding` so hosts can vary the slide breathing room at runtime
+ * (e.g. on a "present mode" toggle that wants margin: 0 vs the default 80).
+ */
+type KeynoteSurfaceHandle = DomSurfaceHandle & {
+  /**
+   * Update the slide padding and re-fit. Mutates the live constraint AND
+   * the captured padding used by load-triggered refits.
+   */
+  set_padding(p: number): void;
+};
+/**
+ * Attach a keynote-shaped DOM surface:
+ * - Mounts via `attach_dom_surface` with `fit: true` (slide is visible on
+ *   first frame).
+ * - Installs a `'cover'` camera constraint bound to the document root, so
+ *   the user can't zoom out past the slide or pan past its edges.
+ * - Subscribes to `editor.state.load_version` so every `editor.load(svg)`
+ *   re-fits the camera to the new document.
+ *
+ * Returns a `KeynoteSurfaceHandle` — same shape as `DomSurfaceHandle` plus
+ * `set_padding` for present-mode toggles. The returned `detach()`
+ * additionally tears down the load subscription.
+ */
+declare function attach(editor: SvgEditor, opts: KeynoteAttachOptions): KeynoteSurfaceHandle;
+//#endregion
+export { type KeynoteAttachOptions, type KeynoteSurfaceHandle, keynote_d_exports as keynote };

package/dist/presets.d.ts

@@ -0,0 +1,46 @@
+import { o as SvgEditor } from "./editor-D2l_CDr0.js";
+import { n as DomSurfaceOptions, t as DomSurfaceHandle } from "./dom-Cn-RtjRL.js";
+declare namespace keynote_d_exports {
+  export { KeynoteAttachOptions, KeynoteSurfaceHandle, attach };
+}
+type KeynoteAttachOptions = {
+  /** Container to mount the SVG into. */container: HTMLElement;
+  /**
+   * Screen-pixel breathing room between the slide and the viewport edge.
+   * Used for both initial fit and the cover-constraint clamp. Default 80.
+   */
+  padding?: number;
+  /**
+   * Forward additional surface options (e.g. `gestures: false`). `container`,
+   * `fit`, and `initial_camera` are owned by the preset.
+   */
+  surface?: Omit<DomSurfaceOptions, "container" | "fit" | "initial_camera">;
+};
+/**
+ * Surface handle returned by `keynote.attach`. Extends `DomSurfaceHandle`
+ * with `set_padding` so hosts can vary the slide breathing room at runtime
+ * (e.g. on a "present mode" toggle that wants margin: 0 vs the default 80).
+ */
+type KeynoteSurfaceHandle = DomSurfaceHandle & {
+  /**
+   * Update the slide padding and re-fit. Mutates the live constraint AND
+   * the captured padding used by load-triggered refits.
+   */
+  set_padding(p: number): void;
+};
+/**
+ * Attach a keynote-shaped DOM surface:
+ * - Mounts via `attach_dom_surface` with `fit: true` (slide is visible on
+ *   first frame).
+ * - Installs a `'cover'` camera constraint bound to the document root, so
+ *   the user can't zoom out past the slide or pan past its edges.
+ * - Subscribes to `editor.state.load_version` so every `editor.load(svg)`
+ *   re-fits the camera to the new document.
+ *
+ * Returns a `KeynoteSurfaceHandle` — same shape as `DomSurfaceHandle` plus
+ * `set_padding` for present-mode toggles. The returned `detach()`
+ * additionally tears down the load subscription.
+ */
+declare function attach(editor: SvgEditor, opts: KeynoteAttachOptions): KeynoteSurfaceHandle;
+//#endregion
+export { type KeynoteAttachOptions, type KeynoteSurfaceHandle, keynote_d_exports as keynote };

package/dist/presets.js

@@ -0,0 +1,55 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_dom = require("./dom-CoVZzFqy.js");
+//#region src/presets/keynote.ts
+var keynote_exports = /* @__PURE__ */ require_dom.__exportAll({ attach: () => attach });
+/**
+* Attach a keynote-shaped DOM surface:
+* - Mounts via `attach_dom_surface` with `fit: true` (slide is visible on
+*   first frame).
+* - Installs a `'cover'` camera constraint bound to the document root, so
+*   the user can't zoom out past the slide or pan past its edges.
+* - Subscribes to `editor.state.load_version` so every `editor.load(svg)`
+*   re-fits the camera to the new document.
+*
+* Returns a `KeynoteSurfaceHandle` — same shape as `DomSurfaceHandle` plus
+* `set_padding` for present-mode toggles. The returned `detach()`
+* additionally tears down the load subscription.
+*/
+function attach(editor, opts) {
+	let padding = opts.padding ?? 80;
+	const inner = require_dom.attach_dom_surface(editor, {
+		...opts.surface,
+		container: opts.container,
+		fit: true
+	});
+	inner.camera.constraints = {
+		type: "cover",
+		bounds: "<root>",
+		padding
+	};
+	const unsub_load = editor.subscribe_with_selector((s) => s.load_version, () => inner.camera.fit("<root>", { margin: padding }));
+	return {
+		camera: inner.camera,
+		gestures: inner.gestures,
+		set_padding(p) {
+			padding = p;
+			inner.camera.constraints = {
+				type: "cover",
+				bounds: "<root>",
+				padding: p
+			};
+			inner.camera.fit("<root>", { margin: p });
+		},
+		detach: () => {
+			unsub_load();
+			inner.detach();
+		}
+	};
+}
+//#endregion
+Object.defineProperty(exports, "keynote", {
+	enumerable: true,
+	get: function() {
+		return keynote_exports;
+	}
+});