@septkit/ui 0.0.57 → 0.0.58

package/dist/index.d.ts

@@ -540,6 +540,11 @@ export declare function createDocumentStore<GenericBaseDocument, GenericAugmente
     clear: () => void;
 };
 
+/** Create an ELK-backed `LayoutEngine`. Each instance owns its own ELK
+ * worker/instance so callers/tests stay isolated. `defaults` are applied to
+ * every `layout()` call and can be overridden per call via its `options`. */
+export declare function createElkLayoutEngine(defaults?: LayoutOptions): LayoutEngine;
+
 /** A user's binary choice on a decision group. */
 export declare type DecisionAction = 'accept' | 'skip';
 
@@ -746,6 +751,77 @@ export declare function highlightCode(code: string, options?: {
     lineStatuses?: readonly LineStatus[];
 }): Promise<string>;
 
+export declare type LayoutDirection = 'UP' | 'DOWN' | 'LEFT' | 'RIGHT';
+
+/** A connection between nodes. Arrays mirror ELK's hyperedge model, so a
+ * single logical edge can bundle multiple sources/targets (for example
+ * ELK's `mergeEdges` bus-style routing). */
+export declare type LayoutEdge = {
+    id: string;
+    sources: string[];
+    targets: string[];
+};
+
+/** A swappable diagram layout algorithm. */
+export declare type LayoutEngine = {
+    layout(input: LayoutGraphInput, options?: LayoutOptions): Promise<LayoutGraphResult>;
+};
+
+export declare type LayoutGraphInput = {
+    nodes: LayoutNode[];
+    edges: LayoutEdge[];
+};
+
+export declare type LayoutGraphResult = {
+    /** Computed position per node id. */
+    positions: Record<string, LayoutPoint>;
+    /**
+     * Computed route points per edge id (start, optional bend points, end),
+     * when the engine produces routed edges. Absent/empty for engines that
+     * don't route edges explicitly.
+     */
+    edgeRoutes: Record<string, LayoutPoint[]>;
+};
+
+/**
+ * Normalized, engine-agnostic diagram layout contract. No Vue, Pinia, SCL,
+ * Dialecte, or VueFlow types may appear here — see ADR-0024 (shared
+ * swappable diagram layout engine).
+ */
+/** A single node to be positioned. */
+export declare type LayoutNode = {
+    id: string;
+    width: number;
+    height: number;
+    /**
+     * Rank used to order siblings left-to-right during layout (for example
+     * to keep expansion order stable). Engines that don't support ordering
+     * hints may ignore this.
+     */
+    orderHint?: number;
+    /** Nested child nodes, for engines/consumers that lay out containment. */
+    children?: LayoutNode[];
+};
+
+export declare type LayoutOptions = {
+    direction?: LayoutDirection;
+    /** Minimum spacing between sibling nodes. */
+    nodeSpacing?: number;
+    /** Minimum spacing between layers/ranks. */
+    layerSpacing?: number;
+    /**
+     * Engine-specific escape hatch. `ElkLayoutEngine` forwards these
+     * verbatim as ELK layout options; other engines may ignore it.
+     */
+    elkOptions?: Record<string, string>;
+};
+
+/** An absolute point on an edge's route. */
+export declare type LayoutPoint = {
+    x: number;
+    y: number;
+};
+
 export declare type LineStatus = 'added' | 'removed' | 'unchanged';
 
 /**

package/dist/index.js

@@ -37,4 +37,6 @@ import P from "./context-menu/context-menu.js";
 import "./context-menu/index.js";
 import F from "./split-layout/split-layout.js";
 import "./split-layout/index.js";
-export { s as Button, y as CATEGORY_ELEMENTS, T as CodeBlock, l as Combobox, P as ContextMenu, O as DecisionToggle, d as Dialog, _ as DialogHost, v as DocumentProgressBar, c as Dropdown, b as ELEMENT_TO_COLOR, x as ELEMENT_TO_ICON, k as ElementDetail, f as FeedbackDialog, N as MergeReview, A as MergeTree, u as MultiSelect, C as SclExplorer, F as SplitLayout, j as TypeNameAuthority, D as XmlDiff, S as collectExpandableNodeIds, p as createDialogHost, e as createDocumentStore, m as dialogHostKey, E as diffLines, w as highlightCode, h as provideDialogHost, i as useActiveDocument, t as useDialecteChannel, g as useDialog, a as useDocumentProgress, o as useDocumentState, n as useLiveData, M as useMergeSession, r as useProjectLiveData };
+import { createElkLayoutEngine as I } from "./diagram-layout/elk-layout-engine.js";
+import "./diagram-layout/index.js";
+export { s as Button, y as CATEGORY_ELEMENTS, T as CodeBlock, l as Combobox, P as ContextMenu, O as DecisionToggle, d as Dialog, _ as DialogHost, v as DocumentProgressBar, c as Dropdown, b as ELEMENT_TO_COLOR, x as ELEMENT_TO_ICON, k as ElementDetail, f as FeedbackDialog, N as MergeReview, A as MergeTree, u as MultiSelect, C as SclExplorer, F as SplitLayout, j as TypeNameAuthority, D as XmlDiff, S as collectExpandableNodeIds, p as createDialogHost, e as createDocumentStore, I as createElkLayoutEngine, m as dialogHostKey, E as diffLines, w as highlightCode, h as provideDialogHost, i as useActiveDocument, t as useDialecteChannel, g as useDialog, a as useDocumentProgress, o as useDocumentState, n as useLiveData, M as useMergeSession, r as useProjectLiveData };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@septkit/ui",
-  "version": "0.0.57",
+  "version": "0.0.58",
   "type": "module",
   "source": "lib/index.ts",
   "files": [
@@ -22,6 +22,7 @@
     "@tailwindcss/vite": "4.2.2",
     "@vueuse/components": "^13.9.0",
     "@vueuse/core": "^14.2.1",
+    "elkjs": "^0.10.2",
     "pinia": "^3.0.4",
     "reka-ui": "^2.9.6",
     "shiki": "^3.0.0",