@pixerate/editor 0.280.0 → 0.281.0

package/dist/canvas/edgePaths.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Edge path geometry for canvas edges, matching xyflow's (`getBezierPath`, `getStraightPath`,
+ * `getSimpleBezierPath`, `getSmoothStepPath`) so the same path is drawn with or without React Flow /
+ * Svelte Flow, plus a small SVG path measurer (`measureSvgPath`) for placing things along a path.
+ * No DOM and no xyflow import.
+ */
+import type { CanvasConnectionLineType } from './connectors.js';
+import type { Position } from './types.js';
+export interface CanvasEdgePathParams {
+    sourceX: number;
+    sourceY: number;
+    targetX: number;
+    targetY: number;
+    /** Side of the source node the edge leaves from. Default `bottom`. */
+    sourcePosition?: Position;
+    /** Side of the target node the edge enters. Default `top`. */
+    targetPosition?: Position;
+    /** Path style, as xyflow's edge `type`. Default `default` (bézier). */
+    type?: CanvasConnectionLineType;
+    /** Bézier curvature (`default`). Default 0.25. */
+    curvature?: number;
+    /** Corner radius for `smoothstep`, in canvas units. Default 5 (`step` is 0). */
+    borderRadius?: number;
+    /** Distance the step paths run straight out of a handle before turning, in canvas units. Default 20. */
+    offset?: number;
+}
+export interface CanvasEdgePath {
+    /** SVG path data. */
+    path: string;
+    /** Where a label sits (xyflow's `labelX` / `labelY`). */
+    labelX: number;
+    labelY: number;
+}
+/**
+ * The SVG path of a canvas edge, the same as xyflow draws for that edge `type` (`default` bézier,
+ * `straight`, `step`, `smoothstep`, `simplebezier`), with the label position.
+ */
+export declare function getCanvasEdgePath(params: CanvasEdgePathParams): CanvasEdgePath;
+/** A point on a path with the direction of travel there (radians, 0 = +x). */
+export interface SvgPathPoint {
+    x: number;
+    y: number;
+    angle: number;
+}
+export interface MeasuredSvgPath {
+    /** Total length in path units. */
+    length: number;
+    /** Bounding box of the flattened path. */
+    bounds: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+    /** The point `distance` along the path (clamped to [0, length]). */
+    pointAt(distance: number): SvgPathPoint;
+}
+/**
+ * Measures SVG path data (M, L, H, V, C, S, Q, T, Z, absolute or relative; arcs are drawn as
+ * straight lines). Curves are flattened to `segments` pieces each (default 24), which is well under
+ * a canvas unit of error for edge-sized curves.
+ */
+export declare function measureSvgPath(d: string, segments?: number): MeasuredSvgPath;