@grafloria/element 0.4.2 → 0.4.4

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

@@ -189,6 +189,29 @@ export interface DashboardGridOptions {
     }) => void;
     /** Inject the hover-revealed corner resize handle into member hosts (default true). */
     resizeHandles?: boolean;
+    /**
+     * FLUID board: the group's frame follows the CANVAS CONTAINER — width
+     * always, and height too in 'fit' — so the dashboard is laid out at real CSS
+     * pixels like every other grid library, never as a picture the camera scales
+     * (review D1: a 900-px viewport drew 30-px KPI figures at 18 px). The binder
+     * owns the ResizeObserver; `sync()` re-reads the container as well.
+     */
+    fluid?: boolean;
+    /**
+     * What FIT mode does past its row floor. 'bounded' (default): the design
+     * height is a CAPACITY — a drop, resize or add that would need one row too
+     * many is refused (the engine's `capacity`), visibly, at design time.
+     * 'scroll': no bound; the frame extends to hold the rows at the floor height
+     * so nothing paints outside it, and the canvas pans. Either way a fit board
+     * never paints past its own edge (review D6: 204 px of tiles below the frame).
+     */
+    overflow?: 'bounded' | 'scroll';
+    /**
+     * STATIC board (gridstack's `staticGrid`): the pointer can neither drag nor
+     * resize and no handles are injected; the API (moveTo/resizeTo, adds, undo)
+     * still works. The viewer's mode — see `setStatic` for the live switch.
+     */
+    static?: boolean;
 }
 export interface DashboardGridHandle {
     /** Rebuild the engine from the group's members + their cells, re-project pixels. */
@@ -219,6 +242,16 @@ export interface DashboardGridHandle {
     /** RTL mirroring, live. Cells never change — only the pixels. */
     setRtl(on: boolean): void;
     getRtl(): boolean;
+    /** Static mode, live: pointer gestures off (and handles gone) or back on. */
+    setStatic(on: boolean): void;
+    getStatic(): boolean;
+    /**
+     * Move keyboard focus to a member (the roving tabindex lands on it). The
+     * host takes DOM focus when it exists; returns false for a non-member.
+     */
+    focusWidget(id: string): boolean;
+    /** The member the roving tabindex currently rests on. */
+    getFocusedWidget(): string | undefined;
     /**
      * The layout to PERSIST — from the engine's LARGEST cached column count, so
      * saving while the board is narrow still saves the wide layout the user
@@ -236,6 +269,10 @@ export interface DashboardGridHandle {
         maxColumns: number;
         rtl: boolean;
         responsive: boolean;
+        fluid: boolean;
+        static: boolean;
+        /** Fit-mode row capacity (undefined when unbounded). */
+        capacity: number | undefined;
         gap: number;
         padding: number;
         sizing: 'fit' | 'grow';
@@ -245,6 +282,12 @@ export interface DashboardGridHandle {
         boardHeight: number;
         frame: WorldRect;
     };
+    /**
+     * Would a w×h tile fit on the board as it is now (gridstack's `willItFit`)?
+     * Always true on an unbounded board; on a bounded fit board this is what
+     * `addWidget()` asks before creating anything.
+     */
+    willItFit(w: number, h: number): boolean;
     /** The engine's cell record for a member (undefined when not a member). */
     cellOf(id: string): CellRect | undefined;
     /** World rect the member's current cells project to. */