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

package/dist/{editor-DSADZszj.d.mts → editor-KRAmUodY.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,114 +305,20 @@ declare class Camera {
   screen_to_world(p: Vec2): Vec2;
   /** Convert a world-space point to screen-space. */
   world_to_screen(p: Vec2): Vec2;
-  private notify;
-}
-//#endregion
-//#region src/commands/registry.d.ts
-/**
- * Command registry.
- *
- * A passive id-keyed registry of handlers. Built so that:
- *
- *  - keybindings (in `src/keymap`) can address commands by stable id;
- *  - new commands can be added in ONE place (`src/commands/defaults.ts`)
- *    without growing the public surface of the editor;
- *  - "one key, many meanings" can be expressed via chain semantics: a
- *    handler returns `true` if it consumed, `false`/`void` otherwise,
- *    and the dispatcher tries the next candidate in the chain.
- *
- * Handlers are plain closures — they capture whatever editor reference
- * they need. The registry itself stays unaware of the editor's type,
- * which avoids a circular type dependency between editor and registry.
- */
-/** Stable, dotted id for a command, e.g. `"history.undo"`. */
-type CommandId = string;
-/**
- * A command handler.
- *
- * Return `true` if the handler consumed the invocation. Return `false`
- * or `undefined` to signal "did not apply" — the dispatcher will try
- * the next candidate registered for the same key.
- *
- * Handlers are closures: they capture their editor reference. No
- * editor parameter is passed — keep handlers self-contained.
- */
-type CommandHandler = (args?: unknown) => boolean | void;
-declare class CommandRegistry {
-  private readonly map;
   /**
-   * Register a command. Returns an unregister function. Re-registering
-   * the same id replaces the previous handler (last writer wins).
+   * 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.
    */
-  register(id: CommandId, handler: CommandHandler): () => void;
+  private apply_constraints;
   /**
-   * Invoke a command by id. Returns `true` if the handler consumed,
-   * `false` otherwise (including unknown ids and handlers that returned
-   * `false`/`undefined`).
+   * Re-clamp the stored transform against the current constraint. Called
+   * from the `constraints` setter; `_set_viewport_size` has its own
+   * notify-inclusive path.
    */
-  invoke(id: CommandId, args?: unknown): boolean;
-  has(id: CommandId): boolean;
-  /** All registered ids, for debugging / introspection. */
-  ids(): readonly CommandId[];
-}
-//#endregion
-//#region src/keymap/keymap.d.ts
-type KeymapBinding = {
-  /** Declarative key combination. Build with `kb()` / `c()` / `seq()`. */keybinding: Keybinding; /** Command id to invoke on match. */
-  command: CommandId; /** Forwarded as the `args` parameter to the command handler. */
-  args?: unknown; /** Higher priorities run first in the chain. Default 0. */
-  priority?: number;
-  /**
-   * Reserved for V2; not honored by the V1 dispatcher. When added, this
-   * will be evaluated before the handler runs; if false, the binding is
-   * skipped without invoking the handler.
-   */
-  when?: (ctx: unknown) => boolean;
-};
-declare class Keymap {
-  private readonly commands;
-  private readonly platformGetter;
-  /**
-   * Bindings bucketed by canonical chunk-key hash, computed per
-   * `@grida/keybinding`'s `chunkKey`. Each list is the chain for that
-   * key, sorted in dispatch order (priority desc, then registration
-   * order).
-   */
-  private readonly buckets;
-  /** Insert order, so ties on priority are deterministic. */
-  private seq;
-  constructor(commands: CommandRegistry, platformGetter?: () => Platform);
-  /**
-   * Bind a key combination to a command. Returns an unbind function.
-   * The same `Keybinding` can be bound to multiple commands — they will
-   * all be tried in chain order on dispatch.
-   */
-  bind(binding: KeymapBinding): () => void;
-  /**
-   * Remove bindings matching the spec. If both filters are passed, only
-   * bindings that match BOTH are removed.
-   */
-  unbind(spec: {
-    keybinding?: Keybinding;
-    command?: CommandId;
-  }): void;
-  /** All registered bindings, for introspection. Order is not guaranteed. */
-  bindings(): readonly KeymapBinding[];
-  /**
-   * Match the event against bound chunks, then run candidates in chain
-   * order. Returns `true` and calls `preventDefault()` on the first
-   * handler that consumes; returns `false` if nothing matched or all
-   * matches fell through.
-   */
-  dispatch(event: KeyboardEvent): boolean;
-  /**
-   * Compute the set of canonical hashes a `Keybinding` lights up. A
-   * binding with aliases (multiple sequences) contributes one hash per
-   * single-chunk alias; multi-chunk sequences (chords) are skipped in
-   * V1.
-   */
-  private chunkKeysFor;
-  private has_safe_mod;
+  private reenforce;
+  private notify;
 }
 //#endregion
 //#region src/core/parser.d.ts
@@ -501,6 +450,19 @@ declare class SvgDocument implements DocumentEvents {
     property: string;
     value: string;
   }>;
+  /**
+   * Whether `id` can be opened in the flat-string text editor.
+   *
+   * v1 contract: the editor only operates on a *single flat text run*. That
+   * means the target must be a `<text>` or `<tspan>` whose direct children
+   * are all text nodes (or it has no children). A `<text>` containing a
+   * `<tspan>` is *not* honestly editable — `text_of` would drop the tspan
+   * content from the editor's view, and a flat-text write would leave the
+   * tspan dangling. Tspan-as-target is fine and well-defined when it's a
+   * leaf; only the host decides whether to route double-click to a tspan
+   * or its parent text.
+   */
+  is_text_edit_target(id: NodeId): boolean;
   text_of(id: NodeId): string;
   /** Replace all direct text children with a single text node carrying `value`. */
   set_text(id: NodeId, value: string): void;
@@ -530,6 +492,113 @@ type Defs = {
   gradients: GradientsApi;
 };
 //#endregion
+//#region src/commands/registry.d.ts
+/**
+ * Command registry.
+ *
+ * A passive id-keyed registry of handlers. Built so that:
+ *
+ *  - keybindings (in `src/keymap`) can address commands by stable id;
+ *  - new commands can be added in ONE place (`src/commands/defaults.ts`)
+ *    without growing the public surface of the editor;
+ *  - "one key, many meanings" can be expressed via chain semantics: a
+ *    handler returns `true` if it consumed, `false`/`void` otherwise,
+ *    and the dispatcher tries the next candidate in the chain.
+ *
+ * Handlers are plain closures — they capture whatever editor reference
+ * they need. The registry itself stays unaware of the editor's type,
+ * which avoids a circular type dependency between editor and registry.
+ */
+/** Stable, dotted id for a command, e.g. `"history.undo"`. */
+type CommandId = string;
+/**
+ * A command handler.
+ *
+ * Return `true` if the handler consumed the invocation. Return `false`
+ * or `undefined` to signal "did not apply" — the dispatcher will try
+ * the next candidate registered for the same key.
+ *
+ * Handlers are closures: they capture their editor reference. No
+ * editor parameter is passed — keep handlers self-contained.
+ */
+type CommandHandler = (args?: unknown) => boolean | void;
+declare class CommandRegistry {
+  private readonly map;
+  /**
+   * Register a command. Returns an unregister function. Re-registering
+   * the same id replaces the previous handler (last writer wins).
+   */
+  register(id: CommandId, handler: CommandHandler): () => void;
+  /**
+   * Invoke a command by id. Returns `true` if the handler consumed,
+   * `false` otherwise (including unknown ids and handlers that returned
+   * `false`/`undefined`).
+   */
+  invoke(id: CommandId, args?: unknown): boolean;
+  has(id: CommandId): boolean;
+  /** All registered ids, for debugging / introspection. */
+  ids(): readonly CommandId[];
+}
+//#endregion
+//#region src/keymap/keymap.d.ts
+type KeymapBinding = {
+  /** Declarative key combination. Build with `kb()` / `c()` / `seq()`. */keybinding: Keybinding; /** Command id to invoke on match. */
+  command: CommandId; /** Forwarded as the `args` parameter to the command handler. */
+  args?: unknown; /** Higher priorities run first in the chain. Default 0. */
+  priority?: number;
+  /**
+   * Reserved for V2; not honored by the V1 dispatcher. When added, this
+   * will be evaluated before the handler runs; if false, the binding is
+   * skipped without invoking the handler.
+   */
+  when?: (ctx: unknown) => boolean;
+};
+declare class Keymap {
+  private readonly commands;
+  private readonly platformGetter;
+  /**
+   * Bindings bucketed by canonical chunk-key hash, computed per
+   * `@grida/keybinding`'s `chunkKey`. Each list is the chain for that
+   * key, sorted in dispatch order (priority desc, then registration
+   * order).
+   */
+  private readonly buckets;
+  /** Insert order, so ties on priority are deterministic. */
+  private seq;
+  constructor(commands: CommandRegistry, platformGetter?: () => Platform);
+  /**
+   * Bind a key combination to a command. Returns an unbind function.
+   * The same `Keybinding` can be bound to multiple commands — they will
+   * all be tried in chain order on dispatch.
+   */
+  bind(binding: KeymapBinding): () => void;
+  /**
+   * Remove bindings matching the spec. If both filters are passed, only
+   * bindings that match BOTH are removed.
+   */
+  unbind(spec: {
+    keybinding?: Keybinding;
+    command?: CommandId;
+  }): void;
+  /** All registered bindings, for introspection. Order is not guaranteed. */
+  bindings(): readonly KeymapBinding[];
+  /**
+   * Match the event against bound chunks, then run candidates in chain
+   * order. Returns `true` and calls `preventDefault()` on the first
+   * handler that consumes; returns `false` if nothing matched or all
+   * matches fell through.
+   */
+  dispatch(event: KeyboardEvent): boolean;
+  /**
+   * Compute the set of canonical hashes a `Keybinding` lights up. A
+   * binding with aliases (multiple sequences) contributes one hash per
+   * single-chunk alias; multi-chunk sequences (chords) are skipped in
+   * V1.
+   */
+  private chunkKeysFor;
+  private has_safe_mod;
+}
+//#endregion
 //#region src/core/properties.d.ts
 declare function read_property(doc: SvgDocument, id: NodeId, property: string): PropertyValue;
 //#endregion
@@ -619,9 +688,18 @@ type Surface = {
 type SurfaceHandle = {
   detach(): void;
 };
+/**
+ * Mode for `commands.select`. Matches the HUD's `SelectMode` vocabulary so
+ * intents can be threaded through without lossy collapsing.
+ *
+ * - `"replace"` (default) — set selection to `ids`, discarding the previous set.
+ * - `"add"` — union: each id in `ids` is added; existing members stay.
+ * - `"toggle"` — flip each id's membership (present → removed; absent → added).
+ */
+type SelectMode = "replace" | "add" | "toggle";
 type Commands = {
   select(target: NodeId | ReadonlyArray<NodeId>, opts?: {
-    additive?: boolean;
+    mode?: SelectMode;
   }): void;
   deselect(): void;
   enter_scope(group: NodeId): void;
@@ -759,4 +837,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 { InvalidComputedValue as A, Provenance as B, EditorState as C, GradientDefinition as D, FontResolver as E, PaintFallback as F, Unsubscribe as G, RadialGradientDefinition as H, PaintPreviewSession as I, Vec2 as K, PaintValue as L, Mode as M, NodeId as N, GradientEntry as O, Paint as P, PreviewSession as R, DEFAULT_STYLE as S, FileIOProvider as T, Rect as U, Providers as V, ReorderDirection as W, Camera as _, SelectMode as a, ClipboardProvider as b, createSvgEditor as c, GestureId as d, Gestures as f, BoundsResolver as g, CommandId as h, DomComputedResolver as i, LinearGradientDefinition as j, GradientStop as k, GestureBinding as l, CommandHandler as m, CreateSvgEditorOptions as n, SurfaceHandle as o, KeymapBinding as p, DomComputedPaint as r, SvgEditor as s, Commands as t, GestureContext as u, CameraConstraints as v, EditorStyle as w, Color as x, CameraOptions as y, PropertyValue 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 InvalidComputedValue, B as Provenance, C as EditorState, D as GradientDefinition, E as FontResolver, F as PaintFallback, G as Unsubscribe, H as RadialGradientDefinition, I as PaintPreviewSession, K as Vec2, L as PaintValue, M as Mode, N as NodeId, O as GradientEntry, P as Paint, R as PreviewSession, S as DEFAULT_STYLE, T as FileIOProvider, U as Rect, V as Providers, W as ReorderDirection, _ as Camera, a as SelectMode, b as ClipboardProvider, c as createSvgEditor, d as GestureId, f as Gestures, g as BoundsResolver, h as CommandId, i as DomComputedResolver, j as LinearGradientDefinition, k as GradientStop, l as GestureBinding, m as CommandHandler, n as CreateSvgEditorOptions, o as SurfaceHandle, p as KeymapBinding, r as DomComputedPaint, s as SvgEditor, t as Commands, u as GestureContext, v as CameraConstraints, w as EditorStyle, x as Color, y as CameraOptions, z as PropertyValue } from "./editor-KRAmUodY.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, SelectMode, 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 InvalidComputedValue, B as Provenance, C as EditorState, D as GradientDefinition, E as FontResolver, F as PaintFallback, G as Unsubscribe, H as RadialGradientDefinition, I as PaintPreviewSession, K as Vec2, L as PaintValue, M as Mode, N as NodeId, O as GradientEntry, P as Paint, R as PreviewSession, S as DEFAULT_STYLE, T as FileIOProvider, U as Rect, V as Providers, W as ReorderDirection, _ as Camera, a as SelectMode, b as ClipboardProvider, c as createSvgEditor, d as GestureId, f as Gestures, g as BoundsResolver, h as CommandId, i as DomComputedResolver, j as LinearGradientDefinition, k as GradientStop, l as GestureBinding, m as CommandHandler, n as CreateSvgEditorOptions, o as SurfaceHandle, p as KeymapBinding, r as DomComputedPaint, s as SvgEditor, t as Commands, u as GestureContext, v as CameraConstraints, w as EditorStyle, x as Color, y as CameraOptions, z as PropertyValue } from "./editor-DdgqLDC9.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, SelectMode, 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-Ds47eN37.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-CRflVqEz.mjs";
 export { DEFAULT_STYLE, createSvgEditor };

package/dist/{paint-CVLZazOa.js → paint-cTjePy5e.js}

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

package/dist/presets.d.mts

@@ -0,0 +1,46 @@
+import { s as SvgEditor } from "./editor-KRAmUodY.mjs";
+import { n as DomSurfaceOptions, t as DomSurfaceHandle } from "./dom-CMXNUMjP.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 { s as SvgEditor } from "./editor-DdgqLDC9.js";
+import { n as DomSurfaceOptions, t as DomSurfaceHandle } from "./dom-eIgcZ4JC.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,52 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_dom = require("./dom-DyJy1H6Q.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) {
+	const inner = require_dom.attach_dom_surface(editor, {
+		...opts.surface,
+		container: opts.container,
+		fit: true
+	});
+	const apply = (p) => {
+		inner.camera.constraints = {
+			type: "cover",
+			bounds: "<root>",
+			padding: p
+		};
+	};
+	apply(opts.padding ?? 80);
+	const unsub_load = editor.subscribe_with_selector((s) => s.load_version, () => inner.camera.fit("<root>", { margin: inner.camera.constraints?.padding ?? 0 }));
+	return {
+		camera: inner.camera,
+		gestures: inner.gestures,
+		set_padding(p) {
+			apply(p);
+			inner.camera.fit("<root>", { margin: p });
+		},
+		detach: () => {
+			unsub_load();
+			inner.detach();
+		}
+	};
+}
+//#endregion
+Object.defineProperty(exports, "keynote", {
+	enumerable: true,
+	get: function() {
+		return keynote_exports;
+	}
+});

package/dist/presets.mjs

@@ -0,0 +1,47 @@
+import { t as __exportAll } from "./chunk-CfYAbeIz.mjs";
+import { t as attach_dom_surface } from "./dom-l5Y1Wf8C.mjs";
+//#region src/presets/keynote.ts
+var keynote_exports = /* @__PURE__ */ __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) {
+	const inner = attach_dom_surface(editor, {
+		...opts.surface,
+		container: opts.container,
+		fit: true
+	});
+	const apply = (p) => {
+		inner.camera.constraints = {
+			type: "cover",
+			bounds: "<root>",
+			padding: p
+		};
+	};
+	apply(opts.padding ?? 80);
+	const unsub_load = editor.subscribe_with_selector((s) => s.load_version, () => inner.camera.fit("<root>", { margin: inner.camera.constraints?.padding ?? 0 }));
+	return {
+		camera: inner.camera,
+		gestures: inner.gestures,
+		set_padding(p) {
+			apply(p);
+			inner.camera.fit("<root>", { margin: p });
+		},
+		detach: () => {
+			unsub_load();
+			inner.detach();
+		}
+	};
+}
+//#endregion
+export { keynote_exports as keynote };

package/dist/react.d.mts

@@ -1,5 +1,5 @@
-import { S as EditorStyle, o as SvgEditor, t as Commands, x as EditorState, z as Providers } from "./editor-DSADZszj.mjs";
-import { DomSurfaceHandle } from "./dom.mjs";
+import { C as EditorState, V as Providers, s as SvgEditor, t as Commands, w as EditorStyle } from "./editor-KRAmUodY.mjs";
+import { t as DomSurfaceHandle } from "./dom-CMXNUMjP.mjs";
 import cmath from "@grida/cmath";
 import { ReactNode } from "react";
 import * as _$react_jsx_runtime0 from "react/jsx-runtime";

package/dist/react.d.ts

@@ -1,5 +1,5 @@
-import { S as EditorStyle, o as SvgEditor, t as Commands, x as EditorState, z as Providers } from "./editor-Da446SPO.js";
-import { DomSurfaceHandle } from "./dom.js";
+import { C as EditorState, V as Providers, s as SvgEditor, t as Commands, w as EditorStyle } from "./editor-DdgqLDC9.js";
+import { t as DomSurfaceHandle } from "./dom-eIgcZ4JC.js";
 import cmath from "@grida/cmath";
 import * as _$react_jsx_runtime0 from "react/jsx-runtime";
 import { ReactNode } from "react";

package/dist/react.js

@@ -1,7 +1,7 @@
 "use client";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_dom = require("./dom-BlJZWpR_.js");
-const require_editor = require("./editor-Eon0043Z.js");
+const require_dom = require("./dom-DyJy1H6Q.js");
+const require_editor = require("./editor-Ds47eN37.js");
 let react = require("react");
 let react_jsx_runtime = require("react/jsx-runtime");
 //#region src/react.tsx

package/dist/react.mjs

@@ -1,6 +1,6 @@
 "use client";
-import { t as createSvgEditor } from "./editor-DP36h-SE.mjs";
-import { t as attach_dom_surface } from "./dom-D-5D_3o0.mjs";
+import { t as createSvgEditor } from "./editor-CRflVqEz.mjs";
+import { t as attach_dom_surface } from "./dom-l5Y1Wf8C.mjs";
 import { createContext, useContext, useEffect, useMemo, useRef, useSyncExternalStore } from "react";
 import { jsx } from "react/jsx-runtime";
 //#region src/react.tsx