@grafloria/element 0.4.55 → 0.4.57

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@grafloria/element",
-  "version": "0.4.55",
+  "version": "0.4.57",
   "type": "module",
   "main": "./src/index.js",
   "types": "./src/index.d.ts",

package/src/lib/dashboard-kit/board-ctx.d.ts

@@ -12,6 +12,12 @@
 import type { DiagramModel, GridPackEngine, GroupModel, NodeModel } from '@grafloria/engine';
 import type { DashboardGridGeometry, WorldRect } from './grid-mapping.js';
 import type { DashboardGridApi, DashboardGridOptions } from './grid-binder.js';
+/**
+ * Small overshoots CLAMP onto the board instead of counting as off-board — the
+ * plan prototype cannot leave its board at all (cells clamp at the edges), so a
+ * 60 px slip past the frame must not dim or delete.
+ */
+export declare const EDGE_GRACE = 60;
 export interface BoardCtx {
     readonly api: DashboardGridApi;
     readonly group: GroupModel;

package/src/lib/dashboard-kit/board-ctx.js

@@ -1,2 +1,7 @@
-export {};
+/**
+ * Small overshoots CLAMP onto the board instead of counting as off-board — the
+ * plan prototype cannot leave its board at all (cells clamp at the edges), so a
+ * 60 px slip past the frame must not dim or delete.
+ */
+export const EDGE_GRACE = 60;
 //# sourceMappingURL=board-ctx.js.map

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

@@ -619,6 +619,8 @@ export interface DashboardHandleContext {
     tearOutPlan?: (containerId: string, pageId: string) => TearOutPlan | null;
     /** The commands that close `boardId` when it is a tab PAGE about to lose its last member `leaving` — and its container when that was its last page. */
     closePageIfEmptied?: (boardId: string, leaving: string) => Command[];
+    /** The bookkeeping for a CONTAINER a gesture moved from one board to another (tile first, 4b-ii): its spec entry, its registry. */
+    moveContainerCommands?: (containerId: string, fromBoardId: string, toBoardId: string) => Command[];
     /** A widget dragged over a strip: hit-test, marks, and the drop that makes it a new tab. Handed to every binder. */
     tabDrop?: TabDropHooks;
     /** Set by finalize: the user's `onTabChange`, so the handle can fire it. */

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

@@ -790,6 +790,54 @@ export function createDashboardHandle(ctx) {
      * looked like. Undo reopens the page (its grid re-binds on the history event)
      * and then the widget comes back into it.
      */
+    /**
+     * A CONTAINER CROSSES BOARDS by hand (tile first, 4b-ii): a section carried
+     * into a page, a tab container into a section. The membership commands
+     * move it; this moves what the kit keeps beside the membership — the
+     * authored entry from the old board's list to the new one's, and which
+     * board the container is filed under — as a register/unregister pair, the
+     * way the tear-out plan files a group it creates. `toJSON()` reads the
+     * membership, so the document is right either way; the registry is what
+     * `addWidget` and the page-closing rule read.
+     */
+    ctx.moveContainerCommands = (containerId, fromBoardId, toBoardId) => {
+        if (!ctx.boardGroups.has(containerId))
+            return [];
+        const spec = specById.get(containerId);
+        const fromArr = ctx.boardWidgets.get(fromBoardId);
+        const toArr = ctx.boardWidgets.get(toBoardId);
+        const prevFiled = viewOfWidget.get(containerId);
+        let slot = -1;
+        const moved = {
+            register: () => {
+                viewOfWidget.set(containerId, toBoardId);
+                if (spec && fromArr) {
+                    const i = fromArr.findIndex((w) => w.id === containerId);
+                    if (i >= 0) {
+                        slot = i;
+                        fromArr.splice(i, 1);
+                    }
+                }
+                if (spec && toArr && !toArr.some((w) => w.id === containerId))
+                    toArr.push(spec);
+            },
+            unregister: () => {
+                if (prevFiled !== undefined)
+                    viewOfWidget.set(containerId, prevFiled);
+                else
+                    viewOfWidget.delete(containerId);
+                if (spec && toArr) {
+                    const i = toArr.findIndex((w) => w.id === containerId);
+                    if (i >= 0)
+                        toArr.splice(i, 1);
+                }
+                if (spec && fromArr && !fromArr.some((w) => w.id === containerId)) {
+                    fromArr.splice(slot < 0 ? fromArr.length : Math.min(slot, fromArr.length), 0, spec);
+                }
+            },
+        };
+        return [new RegisterWidgetCommand(moved, 'register')];
+    };
     ctx.closePageIfEmptied = (boardId, leaving) => {
         var _a, _b, _c, _d, _e, _f;
         const model = (_a = ctx.apiRef) === null || _a === void 0 ? void 0 : _a.getModel();
@@ -2303,7 +2351,7 @@ export function dashboard(options) {
                         if (e.type === 'commit')
                             reportChanged();
                         (_b = (_a = options.binder) === null || _a === void 0 ? void 0 : _a.onGesture) === null || _b === void 0 ? void 0 : _b.call(_a, e);
-                    }, onSelect: (id) => { var _a; return (_a = options.onSelect) === null || _a === void 0 ? void 0 : _a.call(options, id, v.id); } }), captionHooks(v.id)), { onMemberLeaving: (memberId) => { var _a, _b; return (_b = (_a = ctx.closePageIfEmptied) === null || _a === void 0 ? void 0 : _a.call(ctx, v.id, memberId)) !== null && _b !== void 0 ? _b : []; } }), (ctx.tabDrop ? { tabDrop: ctx.tabDrop } : {}));
+                    }, onSelect: (id) => { var _a; return (_a = options.onSelect) === null || _a === void 0 ? void 0 : _a.call(options, id, v.id); } }), captionHooks(v.id)), { onMemberLeaving: (memberId) => { var _a, _b; return (_b = (_a = ctx.closePageIfEmptied) === null || _a === void 0 ? void 0 : _a.call(ctx, v.id, memberId)) !== null && _b !== void 0 ? _b : []; }, onMemberMoving: (memberId, from, to) => { var _a, _b; return (_b = (_a = ctx.moveContainerCommands) === null || _a === void 0 ? void 0 : _a.call(ctx, memberId, from, to)) !== null && _b !== void 0 ? _b : []; } }), (ctx.tabDrop ? { tabDrop: ctx.tabDrop } : {}));
                 if (viewLayout === 'split') {
                     return bindDashboardSplit(a, g, Object.assign(Object.assign(Object.assign({}, common), { columns: (_h = v.columns) !== null && _h !== void 0 ? _h : columns, baseRowHeight: rowHeight, designHeight: viewH(v) }), (v.tree !== undefined ? { tree: v.tree } : {})));
                 }
@@ -2321,7 +2369,7 @@ export function dashboard(options) {
                         if (e.type === 'commit')
                             reportChanged();
                         (_b = (_a = options.binder) === null || _a === void 0 ? void 0 : _a.onGesture) === null || _b === void 0 ? void 0 : _b.call(_a, e);
-                    }, onSelect: (id) => { var _a, _b; return (_a = options.onSelect) === null || _a === void 0 ? void 0 : _a.call(options, id, (_b = ctx.viewOfBoard.get(w.id)) !== null && _b !== void 0 ? _b : ctx.active); } }), captionHooks((_h = ctx.viewOfBoard.get(w.id)) !== null && _h !== void 0 ? _h : ctx.active)), { onMemberLeaving: (memberId) => { var _a, _b; return (_b = (_a = ctx.closePageIfEmptied) === null || _a === void 0 ? void 0 : _a.call(ctx, w.id, memberId)) !== null && _b !== void 0 ? _b : []; } }), (ctx.tabDrop ? { tabDrop: ctx.tabDrop } : {}));
+                    }, onSelect: (id) => { var _a, _b; return (_a = options.onSelect) === null || _a === void 0 ? void 0 : _a.call(options, id, (_b = ctx.viewOfBoard.get(w.id)) !== null && _b !== void 0 ? _b : ctx.active); } }), captionHooks((_h = ctx.viewOfBoard.get(w.id)) !== null && _h !== void 0 ? _h : ctx.active)), { onMemberLeaving: (memberId) => { var _a, _b; return (_b = (_a = ctx.closePageIfEmptied) === null || _a === void 0 ? void 0 : _a.call(ctx, w.id, memberId)) !== null && _b !== void 0 ? _b : []; }, onMemberMoving: (memberId, from, to) => { var _a, _b; return (_b = (_a = ctx.moveContainerCommands) === null || _a === void 0 ? void 0 : _a.call(ctx, memberId, from, to)) !== null && _b !== void 0 ? _b : []; } }), (ctx.tabDrop ? { tabDrop: ctx.tabDrop } : {}));
                 if (((_j = ctx.layoutOf.get(w.id)) !== null && _j !== void 0 ? _j : w.layout) === 'split') {
                     // A splitter tree covering the pane; the pane's frame is the parent's
                     // slab, so no design height of its own.

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

@@ -55,6 +55,7 @@ import { type CellRect, type WorldRect } from './grid-mapping.js';
 import { type BesideSide } from './zones.js';
 import { type ResizeEdges } from './edges.js';
 import { type DragHandleOption } from './grip.js';
+export { TEAR_OUT_MIN_ROWS } from './tear-out.js';
 export { EDGE_GRIP, anyEdge, type ResizeEdges } from './edges.js';
 export { GRIP_CLASS, DRAG_HANDLE_CLASS, CAPTION_BAND, normalizeDragHandle, dragHandleSelector, gripOf, syncGrip, gripHostOf, pressOnDragHandle, type DragGripOptions, type DragHandleOption } from './grip.js';
 export { SequenceCommand, SetGroupCellCommand } from './commit.js';
@@ -203,6 +204,12 @@ export interface DashboardGridOptions {
      * it in the same batch — a tab page emptied by the move closes.
      */
     onMemberLeaving?: (memberId: string) => Command[];
+    /**
+     * A member CONTAINER is moving from this board to another by a gesture
+     * (tile first, 4b-ii). Answers the commands that carry the host's own
+     * bookkeeping for it — the spec entry, the registry — in the same batch.
+     */
+    onMemberMoving?: (memberId: string, fromBoardId: string, toBoardId: string) => Command[];
     /** A widget dragged over a tab STRIP becomes a new tab there: the hooks that hit-test, mark and commit it. */
     tabDrop?: TabDropHooks;
     /** Fires after commits/cancels/removals so the page can refocus/refit/flash. */
@@ -568,8 +575,6 @@ export interface TearOutPlan {
         collapse: Command[];
     };
 }
-/** A torn-out page never arrives shorter than this: a strip with no room under it is not a group. */
-export declare const TEAR_OUT_MIN_ROWS = 2;
 /**
  * A WIDGET dropped on a tab strip becomes a new tab there (a tab dropped on
  * one joins; a widget wraps into a page of its own first). The dashboard
@@ -586,7 +591,7 @@ export interface TabDropHooks {
     /** The commands that make `widgetId` a new tab of `containerId` at `index`; `displaced` are this board's survivors. Empty = refused. */
     dropIntoStrip(widgetId: string, containerId: string, index: number, sourceBoardId: string, displaced: Command[]): Command[];
 }
-interface AdoptOptions {
+export interface AdoptOptions {
     /**
      * 'shrink': take the cell under the pointer at the height that FITS there
      * (down to TEAR_OUT_MIN_ROWS) before looking for another row — a torn-out
@@ -604,7 +609,7 @@ interface AdoptOptions {
         side: BesideSide;
     };
 }
-interface AdoptedLeg {
+export interface AdoptedLeg {
     groupId: string;
     /** Drive the target engine from the source binder's pointer stream. `push`: the tile means it — solid tiles under the wanted cell are pushed (D2). */
     move(world: {