@crazyhappyone/auto-graph 0.2.8 → 0.2.11

package/dist/index.d.cts

@@ -436,7 +436,8 @@ interface ConstraintSolverInput {
     minSiblingGap?: number;
     distributeContainedChildren?: boolean | "spread";
     /** When "spread" or true, distribute children inside non-contract
-     * swimlane lane content boxes (Issue #60). Default "spread". */
+     * swimlane lane content boxes (Issue #60). Opt-in: no redistribution
+     * occurs unless explicitly set. */
     distributeSwimlaneChildren?: boolean | "spread";
     boxes: ReadonlyMap<string, Box>;
     /** Swimlanes for lane-aware child distribution (Issue #60). */
@@ -769,6 +770,12 @@ interface RouteEdgeInput {
     hardObstacleIndex?: BoxSpatialIndex;
     /** Maximum greedy rerouting iterations (default 5). */
     maxRoutingAttempts?: number;
+    /** Corridor expansion margin in px for corner-graph prefilter (default 32).
+     * Larger values include more obstacles in the local routing window. */
+    corridorMargin?: number;
+    /** Route-length / direct-distance ratio above which a backtracking
+     * warning is emitted (default 20). */
+    maxBacktrackingRatio?: number;
 }
 interface RouteEdgeResult {
     points: Point[];
@@ -806,7 +813,7 @@ interface SolveDiagramOptions {
     minSiblingGap?: number;
     distributeContainedChildren?: boolean | "spread";
     /** When "spread", distribute children within non-contract swimlane
-     * lanes (Issue #60). Default "spread". */
+     * lanes (Issue #60). Opt-in: no redistribution occurs unless explicitly set. */
     distributeSwimlaneChildren?: boolean | "spread";
     pageBounds?: {
         width: number;
@@ -831,6 +838,15 @@ interface SolveDiagramOptions {
     labelPlacement?: "beside" | "on-path";
     /** Pixels to offset edge labels from the edge path when labelPlacement is "beside". */
     labelOffset?: number;
+    /** Corridor expansion margin for corner-graph prefilter.
+     * - number: fixed px margin
+     * - "auto" (default): max(200, contentDiagonal * 0.3)
+     * Larger margins include more obstacles in the local routing window,
+     * improving path quality on dense diagrams at the cost of more vertices. */
+    corridorMargin?: number | "auto";
+    /** Route-length / direct-distance ratio above which a backtracking
+     * warning is emitted (default 20). */
+    maxBacktrackingRatio?: number;
 }
 interface PortShiftingOptions {
     enabled?: boolean;

package/dist/index.d.ts

@@ -436,7 +436,8 @@ interface ConstraintSolverInput {
     minSiblingGap?: number;
     distributeContainedChildren?: boolean | "spread";
     /** When "spread" or true, distribute children inside non-contract
-     * swimlane lane content boxes (Issue #60). Default "spread". */
+     * swimlane lane content boxes (Issue #60). Opt-in: no redistribution
+     * occurs unless explicitly set. */
     distributeSwimlaneChildren?: boolean | "spread";
     boxes: ReadonlyMap<string, Box>;
     /** Swimlanes for lane-aware child distribution (Issue #60). */
@@ -769,6 +770,12 @@ interface RouteEdgeInput {
     hardObstacleIndex?: BoxSpatialIndex;
     /** Maximum greedy rerouting iterations (default 5). */
     maxRoutingAttempts?: number;
+    /** Corridor expansion margin in px for corner-graph prefilter (default 32).
+     * Larger values include more obstacles in the local routing window. */
+    corridorMargin?: number;
+    /** Route-length / direct-distance ratio above which a backtracking
+     * warning is emitted (default 20). */
+    maxBacktrackingRatio?: number;
 }
 interface RouteEdgeResult {
     points: Point[];
@@ -806,7 +813,7 @@ interface SolveDiagramOptions {
     minSiblingGap?: number;
     distributeContainedChildren?: boolean | "spread";
     /** When "spread", distribute children within non-contract swimlane
-     * lanes (Issue #60). Default "spread". */
+     * lanes (Issue #60). Opt-in: no redistribution occurs unless explicitly set. */
     distributeSwimlaneChildren?: boolean | "spread";
     pageBounds?: {
         width: number;
@@ -831,6 +838,15 @@ interface SolveDiagramOptions {
     labelPlacement?: "beside" | "on-path";
     /** Pixels to offset edge labels from the edge path when labelPlacement is "beside". */
     labelOffset?: number;
+    /** Corridor expansion margin for corner-graph prefilter.
+     * - number: fixed px margin
+     * - "auto" (default): max(200, contentDiagonal * 0.3)
+     * Larger margins include more obstacles in the local routing window,
+     * improving path quality on dense diagrams at the cost of more vertices. */
+    corridorMargin?: number | "auto";
+    /** Route-length / direct-distance ratio above which a backtracking
+     * warning is emitted (default 20). */
+    maxBacktrackingRatio?: number;
 }
 interface PortShiftingOptions {
     enabled?: boolean;