@statelyai/layout 0.3.0 → 0.4.1

package/src/internal/layered-trace.ts

@@ -0,0 +1,48 @@
+/** Development-only phase observations for differential tracing against real ELK. */
+export type LayeredTraceEvent =
+  | {
+      kind: "sweep";
+      scope: string;
+      attempt: number;
+      forward: boolean;
+      firstSweep: boolean;
+      crossings: number;
+      layers: readonly (readonly string[])[];
+    }
+  | {
+      kind: "port-lists";
+      scope: string;
+      ports: ReadonlyMap<
+        string,
+        readonly { name?: string; outgoing: readonly string[]; incoming: readonly string[] }[]
+      >;
+    }
+  | {
+      kind: "initial-order";
+      scope: string;
+      layers: readonly (readonly string[])[];
+    }
+  | {
+      kind: "crossing-order";
+      scope: string;
+      edgeIds: readonly string[];
+      reversedEdgeIds: readonly string[];
+      layerByNodeId: ReadonlyMap<string, number>;
+      layers: readonly (readonly string[])[];
+    };
+
+let observer: ((event: LayeredTraceEvent) => void) | undefined;
+
+/** Install an observer and return the previous one. Production code never sets one. */
+export function setLayeredTraceObserver(
+  next: ((event: LayeredTraceEvent) => void) | undefined,
+): ((event: LayeredTraceEvent) => void) | undefined {
+  const previous = observer;
+  observer = next;
+  return previous;
+}
+
+/** Build and emit an event only while an observer is installed. */
+export function traceLayeredPhase(event: () => LayeredTraceEvent): void {
+  observer?.(event());
+}

package/src/internal/layout-engine.ts

@@ -1,7 +1,7 @@
 import type { Graph, VisualGraph } from "@statelyai/graph";
 import { boxAlgorithm, elkjs0111BoxAlgorithm, type BoxLayoutOptions } from "../box";
 import { fixedAlgorithm, type FixedLayoutOptions } from "../fixed";
-import { layeredAlgorithm, type LayeredLayoutOptions } from "../layered";
+import { layeredAlgorithm, elkjs0111LayeredAlgorithm, type LayeredLayoutOptions } from "../layered";
 import {
   elkjs0111RectanglePackingAlgorithm,
   rectanglePackingAlgorithm,
@@ -43,6 +43,7 @@ const elkjs0111LayoutAlgorithms = {
   ...builtInLayoutAlgorithms,
   box: elkjs0111BoxAlgorithm,
   random: elkjs0111RandomAlgorithm,
+  layered: elkjs0111LayeredAlgorithm,
   rectpacking: elkjs0111RectanglePackingAlgorithm,
 } satisfies {
   [Id in BuiltInLayoutAlgorithmId]: LayoutAlgorithm<BuiltInLayoutOptionsById[Id]>;

package/src/java-random.ts

@@ -9,6 +9,12 @@ export class JavaRandom {
     this.#seed = (BigInt(seed) ^ JavaRandom.#multiplier) & JavaRandom.#mask;
   }
 
+  clone(): JavaRandom {
+    const copy = new JavaRandom(0);
+    copy.#seed = this.#seed;
+    return copy;
+  }
+
   #next(bits: number): number {
     this.#seed = (this.#seed * JavaRandom.#multiplier + JavaRandom.#addend) & JavaRandom.#mask;
     return Number(this.#seed >> BigInt(48 - bits));