@grida/svg-editor 1.0.0-alpha.13 → 1.0.0-alpha.14

package/dist/dom-Dz_V6q0Y.d.mts

@@ -0,0 +1,114 @@
+import { c as SvgEditor, p as Gestures, s as SurfaceHandle, w as Camera } from "./editor-YQwdWHBb.mjs";
+import cmath from "@grida/cmath";
+import { guide } from "@grida/cmath/_snap";
+
+//#region src/core/snap/options.d.ts
+type SnapOptions = {
+  /** When false, snap behavior and snap-guide rendering are both off. */enabled: boolean;
+  /** Snap threshold in HUD canvas pixels (container CSS px in svg-editor;
+   *  whatever space the consumer feeds in). Constant across zoom because
+   *  the input rects are already in screen-equivalent units. */
+  threshold_px: number;
+};
+declare const DEFAULT_SNAP_OPTIONS: SnapOptions;
+//#endregion
+//#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;
+/**
+ * Affine projection of a point through a 2×3 CTM, then offset by a
+ * container origin (in page CSS-px). Mirrors how `line_endpoints_in_container`
+ * and `shape_of` (transformed branch) bridge from local SVG coords to the
+ * HUD's container-CSS-px space (HUD keeps its own transform at identity;
+ * the SVG carries the camera as a CSS transform, which getScreenCTM
+ * folds in).
+ *
+ * Exported for headless test coverage — pure function, no DOM types.
+ */
+declare function project_point_through_ctm(px: number, py: number, ctm: {
+  a: number;
+  b: number;
+  c: number;
+  d: number;
+  e: number;
+  f: number;
+}, container_offset: readonly [number, number]): [number, number];
+/**
+ * Inverse of the CTM's linear part applied to a delta vector. Drops
+ * translation. Used to convert a HUD-reported container-space drag delta
+ * back to the path's local coord space for `PathModel.translateVertices`.
+ *
+ * Throws on a degenerate (det = 0) matrix — the caller is expected to
+ * have a non-singular CTM for any visible element.
+ */
+declare function project_delta_inverse_ctm(dx: number, dy: number, ctm: {
+  a: number;
+  b: number;
+  c: number;
+  d: number;
+}): [number, number];
+/**
+ * Inverse-project a doc-space rect through a CTM + container offset back
+ * into the element's local frame. The output is the AABB of the four
+ * inverse-projected corners — when the CTM has a rotation component the
+ * AABB is an approximation, but it matches what the user visually
+ * expects from a screen-aligned marquee drag.
+ *
+ * Returns `null` when the CTM's linear part is singular (degenerate
+ * camera) — the caller should skip any test that needs the local rect.
+ */
+declare function inverse_project_rect(rect: {
+  x: number;
+  y: number;
+  width: number;
+  height: number;
+}, ctm: {
+  a: number;
+  b: number;
+  c: number;
+  d: number;
+  e: number;
+  f: number;
+}, offset: readonly [number, number]): cmath.Rectangle | null;
+//#endregion
+export { project_delta_inverse_ctm as a, SnapOptions as c, inverse_project_rect as i, DomSurfaceOptions as n, project_point_through_ctm as o, attach_dom_surface as r, DEFAULT_SNAP_OPTIONS as s, DomSurfaceHandle as t };

package/dist/dom.d.mts

@@ -1,3 +1,3 @@
-import { b as CameraConstraints, d as GestureContext, f as GestureId, g as MemoizedGeometryProvider, h as GeometrySignals, i as DomComputedResolver, m as GeometryProvider, p as Gestures, r as DomComputedPaint, u as GestureBinding, v as BoundsResolver, x as CameraOptions, y as Camera } from "./editor-BH03X8cX.mjs";
-import { a as SnapOptions, i as DEFAULT_SNAP_OPTIONS, n as DomSurfaceOptions, r as attach_dom_surface, t as DomSurfaceHandle } from "./dom-DgB4f-TE.mjs";
-export { BoundsResolver, Camera, CameraConstraints, CameraOptions, DEFAULT_SNAP_OPTIONS, DomComputedPaint, DomComputedResolver, DomSurfaceHandle, DomSurfaceOptions, GeometryProvider, GeometrySignals, GestureBinding, GestureContext, GestureId, Gestures, MemoizedGeometryProvider, SnapOptions, attach_dom_surface };
+import { C as BoundsResolver, E as CameraOptions, T as CameraConstraints, d as GestureContext, f as GestureId, g as MemoizedGeometryProvider, h as GeometrySignals, i as DomComputedResolver, m as GeometryProvider, p as Gestures, r as DomComputedPaint, u as GestureBinding, w as Camera } from "./editor-YQwdWHBb.mjs";
+import { a as project_delta_inverse_ctm, c as SnapOptions, i as inverse_project_rect, n as DomSurfaceOptions, o as project_point_through_ctm, r as attach_dom_surface, s as DEFAULT_SNAP_OPTIONS, t as DomSurfaceHandle } from "./dom-Dz_V6q0Y.mjs";
+export { type BoundsResolver, Camera, type CameraConstraints, type CameraOptions, DEFAULT_SNAP_OPTIONS, type DomComputedPaint, type DomComputedResolver, DomSurfaceHandle, DomSurfaceOptions, type GeometryProvider, type GeometrySignals, type GestureBinding, type GestureContext, type GestureId, Gestures, MemoizedGeometryProvider, type SnapOptions, attach_dom_surface, inverse_project_rect, project_delta_inverse_ctm, project_point_through_ctm };

package/dist/dom.d.ts

@@ -1,3 +1,3 @@
-import { b as CameraConstraints, d as GestureContext, f as GestureId, g as MemoizedGeometryProvider, h as GeometrySignals, i as DomComputedResolver, m as GeometryProvider, p as Gestures, r as DomComputedPaint, u as GestureBinding, v as BoundsResolver, x as CameraOptions, y as Camera } from "./editor-Bd4-VCEJ.js";
-import { a as SnapOptions, i as DEFAULT_SNAP_OPTIONS, n as DomSurfaceOptions, r as attach_dom_surface, t as DomSurfaceHandle } from "./dom-DCX-a8Kr.js";
-export { BoundsResolver, Camera, CameraConstraints, CameraOptions, DEFAULT_SNAP_OPTIONS, DomComputedPaint, DomComputedResolver, DomSurfaceHandle, DomSurfaceOptions, GeometryProvider, GeometrySignals, GestureBinding, GestureContext, GestureId, Gestures, MemoizedGeometryProvider, SnapOptions, attach_dom_surface };
+import { C as BoundsResolver, E as CameraOptions, T as CameraConstraints, d as GestureContext, f as GestureId, g as MemoizedGeometryProvider, h as GeometrySignals, i as DomComputedResolver, m as GeometryProvider, p as Gestures, r as DomComputedPaint, u as GestureBinding, w as Camera } from "./editor-CJ2KuRh5.js";
+import { a as project_delta_inverse_ctm, c as SnapOptions, i as inverse_project_rect, n as DomSurfaceOptions, o as project_point_through_ctm, r as attach_dom_surface, s as DEFAULT_SNAP_OPTIONS, t as DomSurfaceHandle } from "./dom-D4dy6kq5.js";
+export { type BoundsResolver, Camera, type CameraConstraints, type CameraOptions, DEFAULT_SNAP_OPTIONS, type DomComputedPaint, type DomComputedResolver, DomSurfaceHandle, DomSurfaceOptions, type GeometryProvider, type GeometrySignals, type GestureBinding, type GestureContext, type GestureId, Gestures, MemoizedGeometryProvider, type SnapOptions, attach_dom_surface, inverse_project_rect, project_delta_inverse_ctm, project_point_through_ctm };

package/dist/dom.js

@@ -1,7 +1,10 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_dom = require("./dom-Cvm9Towu.js");
+const require_dom = require("./dom-BuD8TKmL.js");
 exports.Camera = require_dom.Camera;
 exports.DEFAULT_SNAP_OPTIONS = require_dom.DEFAULT_SNAP_OPTIONS;
 exports.Gestures = require_dom.Gestures;
 exports.MemoizedGeometryProvider = require_dom.MemoizedGeometryProvider;
 exports.attach_dom_surface = require_dom.attach_dom_surface;
+exports.inverse_project_rect = require_dom.inverse_project_rect;
+exports.project_delta_inverse_ctm = require_dom.project_delta_inverse_ctm;
+exports.project_point_through_ctm = require_dom.project_point_through_ctm;

package/dist/dom.mjs

@@ -1,2 +1,2 @@
-import { a as Camera, i as MemoizedGeometryProvider, n as Gestures, r as DEFAULT_SNAP_OPTIONS, t as attach_dom_surface } from "./dom-BlMk07oX.mjs";
-export { Camera, DEFAULT_SNAP_OPTIONS, Gestures, MemoizedGeometryProvider, attach_dom_surface };
+import { a as Gestures, c as Camera, i as project_point_through_ctm, n as inverse_project_rect, o as DEFAULT_SNAP_OPTIONS, r as project_delta_inverse_ctm, s as MemoizedGeometryProvider, t as attach_dom_surface } from "./dom-DSjfCllZ.mjs";
+export { Camera, DEFAULT_SNAP_OPTIONS, Gestures, MemoizedGeometryProvider, attach_dom_surface, inverse_project_rect, project_delta_inverse_ctm, project_point_through_ctm };