@grafloria/element 0.4.31 → 0.4.32

package/package.json

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

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

@@ -42,8 +42,8 @@
  * Cells are the truth and live in the existing `GridItemConfig`, so save/load
  * round-trips with no extra work — same as every other kit.
  */
-import { GroupModel, NodeModel, type GridColumnLayout } from '@grafloria/engine';
-import { type DashboardGridHandle, type TearOutPlan, type DashboardGridOptions, type DashboardResponsiveOptions } from './grid-binder.js';
+import { Command, GroupModel, NodeModel, type GridColumnLayout } from '@grafloria/engine';
+import { type DashboardGridHandle, type TabDropHooks, type TearOutPlan, type DashboardGridOptions, type DashboardResponsiveOptions } from './grid-binder.js';
 import type { DragHandleOption } from './grid-binder.js';
 import type { SplitNode } from './split-layout.js';
 import type { SectionCaption } from './caption.js';
@@ -373,6 +373,16 @@ export interface DashboardHandle {
     activateTab(containerId: string, pageId: string): boolean;
     /** The page showing in a tab container. */
     getActiveTab(containerId: string): string | undefined;
+    /**
+     * Move a WIDGET into `containerId` as a NEW TAB at `index` (default: the
+     * end): the widget becomes the only member of a fresh page named by its
+     * title, and that page the active tab — what dropping a widget on a strip
+     * does. One undoable step; the board it left re-packs, and a page it
+     * emptied closes.
+     */
+    moveToTab(widgetId: string, containerId: string, index?: number): Promise<boolean>;
+    /** Reorder a page along its container's strip. One undoable step; the order is saved with the container. */
+    moveTab(containerId: string, pageId: string, index: number): boolean;
     /** Live sizing/float switches — the two prototype toggles. */
     setSizing(mode: 'fit' | 'grow'): void;
     getSizing(): 'fit' | 'grow';
@@ -597,6 +607,10 @@ export interface DashboardHandleContext {
     detachTabsContainer?: (containerId: string) => void;
     /** The plan that makes a torn-out page a one-tab group of its own (the handle builder owns the specs and the registry). */
     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[];
+    /** 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. */
     onTabChange?: (containerId: string, pageId: string, viewId: string) => void;
     /** Set by finalize: re-bind a VIEW's board under the given layout (setLayout). */