@woosh/meep-engine 3.28.0 → 3.29.0

package/src/core/model/node-graph/visual/layout/NodeGraphLayoutOptions.d.ts

@@ -1,55 +1,15 @@
 /**
- * Every number the layout is allowed to be tuned by.
+ * Every number the layout is allowed to be tuned by, the router's included.
  *
- * They live in one place because they are not independent: the room a channel has for tracks is set
- * by `layer_gap`, the room a wire lane has is set by `wire_gap`, and a router told to bend for less
- * than it costs to go around will do neither well. Somebody changing one of these needs to see the
- * others.
+ * The placement half of them is {@link BoxLayoutOptions}, and what is added here is not independent
+ * of it: the room a channel has for tracks is set by `layer_gap`, the room a wire lane has is set by
+ * `wire_gap`, and a router told to bend for less than it costs to go around will do neither well.
+ * Somebody changing one of these needs to see the others.
  *
  * @author Alex Goldring
  * @copyright Company Named Limited (c) 2026
  */
-export class NodeGraphLayoutOptions {
-    /**
-     * @param {Partial<NodeGraphLayoutOptions>} [overrides]
-     * @returns {NodeGraphLayoutOptions}
-     */
-    static from(overrides?: Partial<NodeGraphLayoutOptions>): NodeGraphLayoutOptions;
-    /**
-     * Horizontal gap between one column of boxes and the next.
-     *
-     * This is the width of the channel every edge crossing that boundary has to share, so it is
-     * also what limits how many wires can run side by side without one of them having to detour.
-     *
-     * @type {number}
-     */
-    layer_gap: number;
-    /**
-     * Vertical gap between two node boxes sharing a column.
-     * @type {number}
-     */
-    node_gap: number;
-    /**
-     * Vertical room reserved for one wire passing through a column it does not stop at.
-     *
-     * An edge spanning several columns gets a lane of this height in each one it crosses, which is
-     * what keeps a long edge from being drawn over the boxes it passes.
-     *
-     * @type {number}
-     */
-    wire_gap: number;
-    /**
-     * How far outside a box the router runs alongside it, and how far a wire leaves its port before
-     * it is allowed to turn.
-     *
-     * It is one number because it is one line: the grid's line around a box is where a wire
-     * alongside it runs, and it is also the first place a wire leaving a port can turn. A wire on
-     * the box boundary reads as touching it, and a wire that turns the moment it leaves a port
-     * makes it hard to see which port it belongs to.
-     *
-     * @type {number}
-     */
-    clearance: number;
+export class NodeGraphLayoutOptions extends BoxLayoutOptions {
     /**
      * Routing tracks placed across each channel, on top of the lines the boxes themselves induce.
      *
@@ -147,11 +107,6 @@ export class NodeGraphLayoutOptions {
      * @type {number}
      */
     corner_radius: number;
-    /**
-     * Ordering passes over the layers.
-     * @type {number}
-     */
-    order_sweeps: number;
     /**
      * Ceiling on the routing grid, in vertices.
      *
@@ -172,4 +127,5 @@ export class NodeGraphLayoutOptions {
      */
     max_route_expansions: number;
 }
+import { BoxLayoutOptions } from "../../../../graph/layout/layered/BoxLayoutOptions.js";
 //# sourceMappingURL=NodeGraphLayoutOptions.d.ts.map

package/src/core/model/node-graph/visual/layout/NodeGraphLayoutOptions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"NodeGraphLayoutOptions.d.ts","sourceRoot":"","sources":["../../../../../../../src/core/model/node-graph/visual/layout/NodeGraphLayoutOptions.js"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH;IA8KI;;;OAGG;IACH,wBAHW,QAAQ,sBAAsB,CAAC,GAC7B,sBAAsB,CAclC;IA5LD;;;;;;;OAOG;IACH,WAFU,MAAM,CAEA;IAEhB;;;OAGG;IACH,UAFU,MAAM,CAEF;IAEd;;;;;;;OAOG;IACH,UAFU,MAAM,CAEF;IAEd;;;;;;;;;;OAUG;IACH,WAFU,MAAM,CAED;IAEf;;;;;;;;OAQG;IACH,gBAFU,MAAM,CAEG;IAEnB;;;;;;;;;OASG;IACH,cAFU,MAAM,CAEE;IAElB;;;;;;;;;;;OAWG;IACH,kBAFU,MAAM,CAEM;IAEtB;;;;;;;;;;;OAWG;IACH,oBAFU,MAAM,CAEO;IAEvB;;;;;;;;;;;;;OAaG;IACH,uBAFU,MAAM,CAEU;IAE1B;;;;;;;;;OASG;IACH,cAFU,MAAM,CAEC;IAEjB;;;OAGG;IACH,gBAFU,MAAM,CAEG;IAEnB;;;;;;;;OAQG;IACH,cAFU,MAAM,CAEC;IAEjB;;;;;;;OAOG;IACH,eAFU,MAAM,CAEG;IAEnB;;;OAGG;IACH,cAFU,MAAM,CAEC;IAEjB;;;;;;;;OAQG;IACH,mBAFU,MAAM,CAEY;IAE5B;;;;;;;OAOG;IACH,sBAFU,MAAM,CAEc;CAmBjC"}
+{"version":3,"file":"NodeGraphLayoutOptions.d.ts","sourceRoot":"","sources":["../../../../../../../src/core/model/node-graph/visual/layout/NodeGraphLayoutOptions.js"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AACH;IAEI;;;;;;;;OAQG;IACH,gBAFU,MAAM,CAEG;IAEnB;;;;;;;;;OASG;IACH,cAFU,MAAM,CAEE;IAElB;;;;;;;;;;;OAWG;IACH,kBAFU,MAAM,CAEM;IAEtB;;;;;;;;;;;OAWG;IACH,oBAFU,MAAM,CAEO;IAEvB;;;;;;;;;;;;;OAaG;IACH,uBAFU,MAAM,CAEU;IAE1B;;;;;;;;;OASG;IACH,cAFU,MAAM,CAEC;IAEjB;;;OAGG;IACH,gBAFU,MAAM,CAEG;IAEnB;;;;;;;;OAQG;IACH,cAFU,MAAM,CAEC;IAEjB;;;;;;;OAOG;IACH,eAFU,MAAM,CAEG;IAEnB;;;;;;;;OAQG;IACH,mBAFU,MAAM,CAEY;IAE5B;;;;;;;OAOG;IACH,sBAFU,MAAM,CAEc;CACjC;iCA7IgC,sDAAsD"}

package/src/core/model/node-graph/visual/layout/NodeGraphLayoutOptions.js

@@ -1,54 +1,17 @@
+import { BoxLayoutOptions } from "../../../../graph/layout/layered/BoxLayoutOptions.js";
+
 /**
- * Every number the layout is allowed to be tuned by.
+ * Every number the layout is allowed to be tuned by, the router's included.
  *
- * They live in one place because they are not independent: the room a channel has for tracks is set
- * by `layer_gap`, the room a wire lane has is set by `wire_gap`, and a router told to bend for less
- * than it costs to go around will do neither well. Somebody changing one of these needs to see the
- * others.
+ * The placement half of them is {@link BoxLayoutOptions}, and what is added here is not independent
+ * of it: the room a channel has for tracks is set by `layer_gap`, the room a wire lane has is set by
+ * `wire_gap`, and a router told to bend for less than it costs to go around will do neither well.
+ * Somebody changing one of these needs to see the others.
  *
  * @author Alex Goldring
  * @copyright Company Named Limited (c) 2026
  */
-export class NodeGraphLayoutOptions {
-
-    /**
-     * Horizontal gap between one column of boxes and the next.
-     *
-     * This is the width of the channel every edge crossing that boundary has to share, so it is
-     * also what limits how many wires can run side by side without one of them having to detour.
-     *
-     * @type {number}
-     */
-    layer_gap = 140;
-
-    /**
-     * Vertical gap between two node boxes sharing a column.
-     * @type {number}
-     */
-    node_gap = 44;
-
-    /**
-     * Vertical room reserved for one wire passing through a column it does not stop at.
-     *
-     * An edge spanning several columns gets a lane of this height in each one it crosses, which is
-     * what keeps a long edge from being drawn over the boxes it passes.
-     *
-     * @type {number}
-     */
-    wire_gap = 20;
-
-    /**
-     * How far outside a box the router runs alongside it, and how far a wire leaves its port before
-     * it is allowed to turn.
-     *
-     * It is one number because it is one line: the grid's line around a box is where a wire
-     * alongside it runs, and it is also the first place a wire leaving a port can turn. A wire on
-     * the box boundary reads as touching it, and a wire that turns the moment it leaves a port
-     * makes it hard to see which port it belongs to.
-     *
-     * @type {number}
-     */
-    clearance = 24;
+export class NodeGraphLayoutOptions extends BoxLayoutOptions {
 
     /**
      * Routing tracks placed across each channel, on top of the lines the boxes themselves induce.
@@ -156,12 +119,6 @@ export class NodeGraphLayoutOptions {
      */
     corner_radius = 30;
 
-    /**
-     * Ordering passes over the layers.
-     * @type {number}
-     */
-    order_sweeps = 8;
-
     /**
      * Ceiling on the routing grid, in vertices.
      *
@@ -182,22 +139,4 @@ export class NodeGraphLayoutOptions {
      * @type {number}
      */
     max_route_expansions = 200000;
-
-    /**
-     * @param {Partial<NodeGraphLayoutOptions>} [overrides]
-     * @returns {NodeGraphLayoutOptions}
-     */
-    static from(overrides) {
-        const r = new NodeGraphLayoutOptions();
-
-        if (overrides !== undefined) {
-            for (const key in overrides) {
-                if (key in r) {
-                    r[key] = overrides[key];
-                }
-            }
-        }
-
-        return r;
-    }
 }

package/src/core/model/node-graph/visual/layout/layout_build_problem.js

@@ -1,5 +1,5 @@
 import { number_compare_ascending } from "../../../../primitives/numbers/number_compare_ascending.js";
-import { LayoutBoxGraph, LAYOUT_BOX_NODE } from "./LayoutBoxGraph.js";
+import { LayoutBoxGraph, LAYOUT_BOX_NODE } from "../../../../graph/layout/layered/LayoutBoxGraph.js";
 import { LayoutProblem, layout_side_of } from "./LayoutProblem.js";
 
 /**

package/src/core/model/node-graph/visual/layout/layout_node_graph.js

@@ -1,10 +1,10 @@
-import { layout_assign_coordinates } from "./layout_assign_coordinates.js";
-import { layout_assign_layers } from "./layout_assign_layers.js";
-import { layout_break_cycles } from "./layout_break_cycles.js";
+import { layout_assign_coordinates } from "../../../../graph/layout/layered/layout_assign_coordinates.js";
+import { layout_assign_layers } from "../../../../graph/layout/layered/layout_assign_layers.js";
+import { layout_break_cycles } from "../../../../graph/layout/layered/layout_break_cycles.js";
 import { layout_build_problem } from "./layout_build_problem.js";
-import { layout_insert_lanes } from "./layout_insert_lanes.js";
-import { layout_order_layers } from "./layout_order_layers.js";
-import { layout_orient_links } from "./layout_orient_links.js";
+import { layout_insert_lanes } from "../../../../graph/layout/layered/layout_insert_lanes.js";
+import { layout_order_layers } from "../../../../graph/layout/layered/layout_order_layers.js";
+import { layout_orient_links } from "../../../../graph/layout/layered/layout_orient_links.js";
 import { NodeGraphLayoutOptions } from "./NodeGraphLayoutOptions.js";
 import { route_connections } from "./route_connections.js";
 import { route_grid_build } from "./route_grid_build.js";

package/src/core/model/node-graph/visual/layout/route_grid_build.js

@@ -1,4 +1,4 @@
-import { LAYOUT_BOX_LANE } from "./LayoutBoxGraph.js";
+import { LAYOUT_BOX_LANE } from "../../../../graph/layout/layered/LayoutBoxGraph.js";
 import { number_compare_ascending } from "../../../../primitives/numbers/number_compare_ascending.js";
 import { LAYOUT_SIDE_BOTTOM, LAYOUT_SIDE_TOP } from "./LayoutProblem.js";
 import { ROUTE_GRID_EPSILON, RouteGrid } from "./RouteGrid.js";

package/src/engine/graphics3/DebugDrawSystem.d.ts

@@ -52,21 +52,23 @@ export class DebugDrawSystem extends System<any> {
     #private;
 }
 /**
- * **The single deliberate exception to the fog of war.** Everything else drawn into the scene is
- * concealed by it; developer geometry that the fog can hide is a debugging tool that stops working
- * exactly where debugging is needed, so this says so rather than relying on where it was registered.
+ * **On top.** Developer geometry that a later effect can conceal is a debugging tool that stops
+ * working exactly where debugging is needed, so this asks to be last rather than relying on where it
+ * was registered.
+ *
+ * The number is far out of the way of the ordinary ones rather than one above the fog, so that a
+ * composite added later can push past the fog without having to know this exists. It is not a
+ * guarantee — nothing here can be — but out here it takes a deliberate act to land above it.
  */
 export class DebugDrawExtension extends RenderExtension {
     /**
      * @param {DebugDrawSystem} system
      */
     constructor(system: DebugDrawSystem);
-    after: (typeof FogOfWarExtension)[];
     record(frame: any): void;
     #private;
 }
 import { System } from "../ecs/System.js";
 import { DynamicMeshBatch } from "../../shade/renderer/scene/DynamicMeshBatch.js";
 import { RenderExtension } from "../../shade/renderer/extension/RenderExtension.js";
-import { FogOfWarExtension } from "./FogOfWarSystem.js";
 //# sourceMappingURL=DebugDrawSystem.d.ts.map

package/src/engine/graphics3/DebugDrawSystem.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DebugDrawSystem.d.ts","sourceRoot":"","sources":["../../../../src/engine/graphics3/DebugDrawSystem.js"],"names":[],"mappings":"AAeA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH;IAkEI;;OAEG;IACH,sCAYC;IAhFD;;;;;;;;;OASG;IACH,YAFU,MAAM,CAED;IA8Cf;;;;OAIG;IACH,8BAEC;IAmBD,2CAMC;IAED,4CAYC;IAED;;OAEG;IACH,kCAwBC;;CACJ;AAED;;;;GAIG;AACH;IAYI;;OAEG;IACH,oBAFW,eAAe,EAMzB;IAdD,oCAA4B;IAgB5B,yBAEC;;CACJ;uBAhMsB,kBAAkB;iCADR,gDAAgD;gCAJjD,mDAAmD;kCAFjD,qBAAqB"}
+{"version":3,"file":"DebugDrawSystem.d.ts","sourceRoot":"","sources":["../../../../src/engine/graphics3/DebugDrawSystem.js"],"names":[],"mappings":"AAcA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH;IAkEI;;OAEG;IACH,sCAYC;IAhFD;;;;;;;;;OASG;IACH,YAFU,MAAM,CAED;IA8Cf;;;;OAIG;IACH,8BAEC;IAmBD,2CAMC;IAED,4CAYC;IAED;;OAEG;IACH,kCAwBC;;CACJ;AAED;;;;;;;;GAQG;AACH;IAYI;;OAEG;IACH,oBAFW,eAAe,EAMzB;IAED,yBAEC;;CACJ;uBApMsB,kBAAkB;iCADR,gDAAgD;gCAJjD,mDAAmD"}