@crazyhappyone/auto-graph 0.2.8 → 0.2.10

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,18 @@ 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;
+    /** Max corner-graph vertices. Undefined → adaptive (derived from
+     * corridor size + obstacle count, clamped to a safe range). */
+    maxCorners?: number;
+    /** Max grid A* nodes. Undefined → adaptive (derived from obstacle
+     * count + corridor, clamped to a safe range). */
+    maxNodes?: number;
 }
 interface RouteEdgeResult {
     points: Point[];
@@ -806,7 +819,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 +844,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,18 @@ 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;
+    /** Max corner-graph vertices. Undefined → adaptive (derived from
+     * corridor size + obstacle count, clamped to a safe range). */
+    maxCorners?: number;
+    /** Max grid A* nodes. Undefined → adaptive (derived from obstacle
+     * count + corridor, clamped to a safe range). */
+    maxNodes?: number;
 }
 interface RouteEdgeResult {
     points: Point[];
@@ -806,7 +819,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 +844,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;