@grafloria/element 0.4.2 → 0.4.3

package/src/lib/dashboard-kit/index.d.ts

@@ -1,4 +1,6 @@
 export { bindDashboardGrid, type DashboardGridApi, type DashboardGridOptions, type DashboardGridHandle, type DashboardResponsiveOptions, } from './grid-binder.js';
+export { bindDashboardSplit, SetSplitTreeCommand, SPLIT_TREE_KEY, type DashboardSplitOptions, type DashboardSplitHandle, } from './split-binder.js';
+export { projectSplit, dividersOf, addSplitLeaf, removeSplitLeaf, insertSplitLeaf, moveSplitDivider, splitFromCells, cellsFromSplit, splitLeaves, type SplitNode, type SplitGroup, type SplitLeaf, type SplitDir, type SplitSide, type SplitDivider, } from './split-layout.js';
 export { rowHeightFor, boardHeightFor, columnUnitFor, cellToRect, pointToCell, sizeToSpan, spanWidthPx, gridItemFromCell, cellFromGridItem, buildCommitCommands, type CellRect, type WorldRect, type DashboardGridGeometry, type TileDelta, } from './grid-mapping.js';
 export { ensureDashboardKitStyles, DASHBOARD_KIT_STYLE_ID } from './styles.js';
 export { dashboard, type DashboardOptions, type DashboardSpec, type DashboardSnapshot, type DashboardHandle, type DashboardViewSpec, type DashboardWidgetSpec, type WidgetHandle, } from './dashboard.js';

package/src/lib/dashboard-kit/index.js

@@ -1,4 +1,6 @@
 export { bindDashboardGrid, } from './grid-binder.js';
+export { bindDashboardSplit, SetSplitTreeCommand, SPLIT_TREE_KEY, } from './split-binder.js';
+export { projectSplit, dividersOf, addSplitLeaf, removeSplitLeaf, insertSplitLeaf, moveSplitDivider, splitFromCells, cellsFromSplit, splitLeaves, } from './split-layout.js';
 export { rowHeightFor, boardHeightFor, columnUnitFor, cellToRect, pointToCell, sizeToSpan, spanWidthPx, gridItemFromCell, cellFromGridItem, buildCommitCommands, } from './grid-mapping.js';
 export { ensureDashboardKitStyles, DASHBOARD_KIT_STYLE_ID } from './styles.js';
 // The DATA-FIRST authoring API (the erDiagram/umlDiagram equivalent).

package/src/lib/dashboard-kit/split-binder.d.ts

@@ -0,0 +1,69 @@
+/**
+ * SPLIT BINDER — a board laid out as a splitter tree (see split-layout.ts),
+ * bound to a group the way `bindDashboardGrid` binds a grid: it implements the
+ * same `DashboardGridHandle`, so `dashboard()`, `fromDocument()` and the
+ * history plumbing drive it without knowing which layout a view runs.
+ *
+ * THE MODEL (measured on the DevExpress designer, 6 Sep 2026):
+ *  - the board is always covered: one widget fills it, the next halves the
+ *    largest one along its longer axis, a removed widget's slot goes to its
+ *    siblings;
+ *  - a DIVIDER between two siblings drags as a PERCENTAGE of their group; a
+ *    widget alone in its group has no divider on that axis;
+ *  - a DRAG lifts the widget out at once (its siblings take the slot live), an
+ *    INSERTION LINE on the nearest edge of the widget under the pointer says
+ *    where it will land, and the drop splits that widget's slot on that side.
+ *
+ * THE UNDO STORY is one command: `SetSplitTreeCommand` swaps the whole tree
+ * (plain JSON on the group as `dashboardTree`). A gesture, a keyboard step, an
+ * add and a removal are each one tree write, so one undo is always one thing.
+ *
+ * Sizing is always 'fit': the tree is a division of the frame. On a fluid
+ * board the frame follows the container (both axes); on a fixed board it is
+ * the authored size.
+ */
+import { Command, type GroupModel } from '@grafloria/engine';
+import type { DashboardGridApi, DashboardGridHandle, DashboardGridOptions } from './grid-binder.js';
+import { type SplitNode } from './split-layout.js';
+/** Group metadata key the tree persists under. */
+export declare const SPLIT_TREE_KEY = "dashboardTree";
+export interface DashboardSplitOptions extends Pick<DashboardGridOptions, 'columns' | 'gap' | 'padding' | 'rtl' | 'fluid' | 'static' | 'designHeight' | 'baseRowHeight' | 'dragOut' | 'removeZone' | 'onRemoveRequest' | 'onDropIn' | 'onGesture'> {
+    /** An authored tree. Default: the persisted one, else derived from the members' cells. */
+    tree?: SplitNode | null;
+}
+/** The split handle is the grid handle plus the tree itself. */
+export interface DashboardSplitHandle extends DashboardGridHandle {
+    getSplitTree(): SplitNode | null;
+    /** Replace the tree through the history (one undoable step). */
+    setSplitTree(tree: SplitNode | null): Promise<void>;
+}
+/**
+ * Undoable whole-tree write. Everything a split board does to its layout is
+ * one of these — a gesture, a keyboard step, an add, a removal — so one undo
+ * is always exactly one thing, and a batch that removes a node can fold the
+ * tree-without-it in beside the node removal.
+ */
+export declare class SetSplitTreeCommand extends Command {
+    private readonly groupId;
+    private readonly before;
+    private readonly after;
+    constructor(groupId: string, before: SplitNode | null, after: SplitNode | null);
+    private apply;
+    execute(context: {
+        diagram?: unknown;
+    }): void;
+    undo(context: {
+        diagram?: unknown;
+    }): void;
+    serialize(): {
+        id: string;
+        name: string;
+        timestamp: number;
+        data: {
+            groupId: string;
+            before: SplitNode | null;
+            after: SplitNode | null;
+        };
+    };
+}
+export declare function bindDashboardSplit(api: DashboardGridApi, group: GroupModel, options?: DashboardSplitOptions): DashboardSplitHandle;