@crazyhappyone/auto-graph 0.2.9 → 0.2.10

package/dist/index.d.cts

@@ -770,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[];
@@ -832,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

@@ -770,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[];
@@ -832,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;