@grafloria/element 0.4.11 → 0.4.12

package/package.json

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

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

@@ -199,6 +199,14 @@ export interface DashboardOptions {
      * interactive. Live: `handle.setDragHandle()`.
      */
     dragHandle?: DragHandleOption;
+    /**
+     * FIT AND THE ROW FLOOR. `true` (default): a bounded fit board squeezes its
+     * rows toward `minRowHeight` before refusing growth. `false`: rows freeze at
+     * the height they have now — a gesture that needs a row the frame does not
+     * hold is refused outright and no other tile shrinks. See the grid binder's
+     * `squeeze` for the exact rule.
+     */
+    squeeze?: boolean;
     /**
      * RIGHT-TO-LEFT boards: column x=0 renders at the RIGHT edge and columns run
      * leftwards. Cells are untouched — the same `widgets` array describes the

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

@@ -505,9 +505,20 @@ export function createDashboardHandle(ctx) {
             return makeWidgetHandle(id);
         },
         focusWidget(id) {
-            var _a, _b;
+            var _a;
             const b = binders.get((_a = viewOfWidget.get(id)) !== null && _a !== void 0 ? _a : '');
-            return (_b = b === null || b === void 0 ? void 0 : b.focusWidget(id)) !== null && _b !== void 0 ? _b : false;
+            if (!b)
+                return false;
+            if (b.focusWidget(id))
+                return true;
+            // A widget added in this same tick is not a member yet (adds commit
+            // asynchronously): the spec knows it, so select it once the commit lands.
+            if (!specById.has(id))
+                return false;
+            const retry = (n) => { if (!b.focusWidget(id) && n > 0)
+                setTimeout(() => retry(n - 1), 16); };
+            queueMicrotask(() => retry(4));
+            return true;
         },
         widgetsOf(viewId) {
             var _a;
@@ -1032,7 +1043,7 @@ export function dashboard(options) {
             // its tree from exactly those, so any stale tree is cleared first;
             // split → grid rebuilds from them, so the column cache goes too.
             ctx.rebindView = (viewId, next) => {
-                var _a;
+                var _a, _b;
                 const v = views.find((x) => x.id === viewId);
                 const g = groups.get(viewId);
                 const b = binders.get(viewId);
@@ -1040,6 +1051,7 @@ export function dashboard(options) {
                     return;
                 const cells = b.saveLayout().cells;
                 const live = { rtl: b.getRtl(), static: b.getStatic(), dragHandle: b.getDragHandle() };
+                const focused = b.getFocusedWidget();
                 b.dispose();
                 const write = (fn) => (model.runSystemWrite ? model.runSystemWrite(fn) : fn());
                 write(() => {
@@ -1059,6 +1071,10 @@ export function dashboard(options) {
                 ctx.layoutOf.set(viewId, next);
                 binders.set(viewId, bindView(v, g, next, live));
                 (_a = binders.get(viewId)) === null || _a === void 0 ? void 0 : _a.sync();
+                // The selected widget (and its grip) survives the switch, as it does in
+                // the DevExpress designer — the host used to have to restate it.
+                if (focused)
+                    (_b = binders.get(viewId)) === null || _b === void 0 ? void 0 : _b.focusWidget(focused);
             };
             handle.showView(ctx.active);
             ctx.rebindContainer = (id) => {
@@ -1153,7 +1169,7 @@ export function dashboard(options) {
              */
             function bindView(v, g, viewLayout, live) {
                 var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
-                const common = Object.assign(Object.assign({ gap, padding: gap, rtl: (_b = (_a = live === null || live === void 0 ? void 0 : live.rtl) !== null && _a !== void 0 ? _a : options.rtl) !== null && _b !== void 0 ? _b : false, fluid: mode === 'fluid', static: (_d = (_c = live === null || live === void 0 ? void 0 : live.static) !== null && _c !== void 0 ? _c : options.static) !== null && _d !== void 0 ? _d : false, dragHandle: (_f = (_e = live === null || live === void 0 ? void 0 : live.dragHandle) !== null && _e !== void 0 ? _e : options.dragHandle) !== null && _f !== void 0 ? _f : false }, ((_g = options.binder) !== null && _g !== void 0 ? _g : {})), { onGesture: (e) => {
+                const common = Object.assign(Object.assign(Object.assign({ gap, padding: gap, rtl: (_b = (_a = live === null || live === void 0 ? void 0 : live.rtl) !== null && _a !== void 0 ? _a : options.rtl) !== null && _b !== void 0 ? _b : false, fluid: mode === 'fluid', static: (_d = (_c = live === null || live === void 0 ? void 0 : live.static) !== null && _c !== void 0 ? _c : options.static) !== null && _d !== void 0 ? _d : false, dragHandle: (_f = (_e = live === null || live === void 0 ? void 0 : live.dragHandle) !== null && _e !== void 0 ? _e : options.dragHandle) !== null && _f !== void 0 ? _f : false }, (options.squeeze !== undefined ? { squeeze: options.squeeze } : {})), ((_g = options.binder) !== null && _g !== void 0 ? _g : {})), { onGesture: (e) => {
                         var _a, _b;
                         if (e.type === 'commit')
                             reportChanged();
@@ -1167,25 +1183,12 @@ export function dashboard(options) {
             /** Bind (or re-bind) a container's inner grid on its group. */
             function bindContainer(cg, w, viewId) {
                 var _a, _b, _c, _d, _e;
-                binders.set(w.id, bindDashboardGrid(a, cg, {
-                    columns: innerColumnsOf(w),
-                    gap,
-                    padding: 0,
-                    sizing: 'fit',
-                    baseRowHeight: rowHeight,
-                    designHeight: 0,
-                    maxRows: (_a = w.maxRows) !== null && _a !== void 0 ? _a : rowExtentOf((_b = w.widgets) !== null && _b !== void 0 ? _b : []),
-                    float: false,
-                    rtl: (_c = options.rtl) !== null && _c !== void 0 ? _c : false,
-                    static: (_d = options.static) !== null && _d !== void 0 ? _d : false,
-                    dragHandle: (_e = options.dragHandle) !== null && _e !== void 0 ? _e : false,
-                    onGesture: (e) => {
+                binders.set(w.id, bindDashboardGrid(a, cg, Object.assign(Object.assign({ columns: innerColumnsOf(w), gap, padding: 0, sizing: 'fit', baseRowHeight: rowHeight, designHeight: 0, maxRows: (_a = w.maxRows) !== null && _a !== void 0 ? _a : rowExtentOf((_b = w.widgets) !== null && _b !== void 0 ? _b : []), float: false, rtl: (_c = options.rtl) !== null && _c !== void 0 ? _c : false, static: (_d = options.static) !== null && _d !== void 0 ? _d : false, dragHandle: (_e = options.dragHandle) !== null && _e !== void 0 ? _e : false }, (options.squeeze !== undefined ? { squeeze: options.squeeze } : {})), { onGesture: (e) => {
                         var _a, _b;
                         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);
-                    },
-                }));
+                    } })));
             }
             /**
              * One reporter for every binder on a view — the view's own and each

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

@@ -223,6 +223,18 @@ export interface DashboardGridOptions {
      * interactive (scroll a table, click a legend). Live: `setDragHandle`.
      */
     dragHandle?: DragHandleOption;
+    /**
+     * FIT AND THE ROW FLOOR. `true` (default): a bounded fit board holds as many
+     * rows as fit at `minRowHeight` — a gesture that needs another row SQUEEZES
+     * every row toward the floor, and is refused only when even that is not
+     * enough. `false`: rows FREEZE at the height they have now — the capacity is
+     * what the frame holds at the current row height, so a resize, move or add
+     * that needs a row the frame does not have is refused outright (placeholder
+     * stays, `onGesture` reports `changed: false`) and no other tile shrinks. A
+     * board loaded with more rows than fit still squeezes to the frame (fit never
+     * scrolls); it just cannot be pushed further by a gesture.
+     */
+    squeeze?: boolean;
 }
 /** A painted grip: the only drag zone, placed along the card's top edge. */
 export interface DragGripOptions {
@@ -257,6 +269,8 @@ export declare function gripHostOf(target: Element | null): HTMLElement | null;
  * included — so the pointer need not hit the header's text to grab the tile.
  */
 export declare function pressOnDragHandle(sel: string, target: Element | null, hostEl: HTMLElement | null, clientX: number, clientY: number): boolean;
+/** The caption strip of a host with no kit header, px from the card's top. */
+export declare const CAPTION_BAND = 28;
 export interface DashboardGridHandle {
     /** Rebuild the engine from the group's members + their cells, re-project pixels. */
     sync(): void;

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

@@ -110,13 +110,15 @@ export function pressOnDragHandle(sel, target, hostEl, clientX, clientY) {
         return true;
     if (sel !== '.axdb-widget-h' || !hostEl)
         return false;
-    const header = hostEl.querySelector('.axdb-widget-h');
-    if (!header)
-        return false;
     const hr = hostEl.getBoundingClientRect();
-    const r = header.getBoundingClientRect();
-    return clientX >= hr.left && clientX <= hr.right && clientY >= hr.top && clientY <= r.bottom;
+    const header = hostEl.querySelector('.axdb-widget-h');
+    // A host painting its own content has no kit header: its caption is the top
+    // band of the card, so `dragHandle: true` still means something there.
+    const bottom = header ? header.getBoundingClientRect().bottom : hr.top + CAPTION_BAND;
+    return clientX >= hr.left && clientX <= hr.right && clientY >= hr.top && clientY <= bottom;
 }
+/** The caption strip of a host with no kit header, px from the card's top. */
+export const CAPTION_BAND = 28;
 /**
  * Binders on the same canvas find each other here. A WeakMap: a canvas that
  * is gone takes its (empty) peer set with it — the strong Map it replaced kept
@@ -237,6 +239,7 @@ export function bindDashboardGrid(api, group, options = {}) {
     const padding = (_c = options.padding) !== null && _c !== void 0 ? _c : gap;
     const baseRowHeight = (_d = options.baseRowHeight) !== null && _d !== void 0 ? _d : 110;
     const minRowHeight = (_e = options.minRowHeight) !== null && _e !== void 0 ? _e : 28;
+    const squeeze = options.squeeze !== false;
     let float = (_f = options.float) !== null && _f !== void 0 ? _f : false;
     /** The AUTHORED bound — a nested strip's design (row-first push, escalation). */
     const maxRows = options.maxRows;
@@ -285,7 +288,10 @@ export function bindDashboardGrid(api, group, options = {}) {
     const fitCapacity = () => {
         if (maxRows !== undefined || sizing !== 'fit' || overflow === 'scroll' || designH <= 0)
             return undefined;
-        const rowsThatFit = Math.floor((designH - 2 * padding + gap) / (minRowHeight + gap));
+        // Elastic (default): rows at the floor. Frozen (`squeeze: false`): rows at
+        // the height they have NOW, so a gesture never shrinks a neighbour.
+        const floor = squeeze ? minRowHeight : Math.max(minRowHeight, rowHeightFor(geom(), rows()));
+        const rowsThatFit = Math.floor((designH - 2 * padding + gap) / (floor + gap));
         return Math.max(1, rowsThatFit, engine.rows());
     };
     /** Re-derive the capacity; true when the engine must be rebuilt to carry it. */
@@ -664,6 +670,7 @@ export function bindDashboardGrid(api, group, options = {}) {
         syncA11y(only);
         if (disposed)
             return;
+        ensureStaticGuard();
         const grip = gripOf(dragHandle);
         for (const id of (_a = group.members) !== null && _a !== void 0 ? _a : []) {
             if (only && !only.has(id))
@@ -1828,9 +1835,50 @@ export function bindDashboardGrid(api, group, options = {}) {
             return;
         const node = diagram.getNode(id);
         const resizable = !!node && !isStatic && ((_f = node.state) === null || _f === void 0 ? void 0 : _f.locked) !== true && ((_g = node.getMetadata) === null || _g === void 0 ? void 0 : _g.call(node, 'widgetResizable')) !== false;
-        host.style.cursor = resizable ? cursorFor(edgesNear(host, e.clientX, e.clientY)) : '';
+        const cursor = resizable ? cursorFor(edgesNear(host, e.clientX, e.clientY)) : '';
+        // The affordance rides on an ATTRIBUTE, not the inline style: a repaint
+        // rewrites the host's style and used to clear the cursor mid-hover, and
+        // content that sets its own cursor (a chart canvas) hid it — the
+        // stylesheet applies the attribute's cursor to the host and everything in it.
+        if (cursor)
+            host.setAttribute('data-axdb-edge', cursor);
+        else
+            host.removeAttribute('data-axdb-edge');
     };
     api.container.addEventListener('pointermove', onHover, { passive: true });
+    /**
+     * STATIC BOARDS LET CONTENT BE CLICKED. The renderer prevents the default of
+     * every press a tool claims, which cancels the compatibility mouse events —
+     * a chart inside a read-only board could not be clicked. So under `static`
+     * a press inside a member's CONTENT (not on kit chrome) is stopped on the
+     * HTML layer, in the bubble phase: the content has already received it, the
+     * renderer never does, nothing is prevented.
+     */
+    const staticGuard = (e) => {
+        var _a, _b, _c, _d;
+        if (!isStatic || disposed)
+            return;
+        const t = e.target;
+        const host = (_a = t === null || t === void 0 ? void 0 : t.closest) === null || _a === void 0 ? void 0 : _a.call(t, '.grafloria-node-host');
+        if (!host || !((_b = group.members) !== null && _b !== void 0 ? _b : new Set()).has((_c = host.getAttribute('data-node-id')) !== null && _c !== void 0 ? _c : ''))
+            return;
+        if ((_d = t === null || t === void 0 ? void 0 : t.closest) === null || _d === void 0 ? void 0 : _d.call(t, '.axdb-rs, .axdb-grip, .axdb-div'))
+            return;
+        e.stopPropagation();
+    };
+    let guardedLayer = null;
+    const ensureStaticGuard = () => {
+        // One lookup, ever: the host observer budgets container lookups per
+        // repaint, and the layer element lives as long as the instance.
+        if (guardedLayer === null || guardedLayer === void 0 ? void 0 : guardedLayer.isConnected)
+            return;
+        const layer = htmlLayer();
+        if (!layer)
+            return;
+        guardedLayer === null || guardedLayer === void 0 ? void 0 : guardedLayer.removeEventListener('pointerdown', staticGuard);
+        guardedLayer = layer;
+        layer.addEventListener('pointerdown', staticGuard);
+    };
     /**
      * KEYBOARD OPERATION (WCAG 2.1.1, and the non-drag alternative 2.5.7 asks
      * for): on a focused member, arrows move it one cell, Shift+arrows resize it
@@ -2349,6 +2397,7 @@ export function bindDashboardGrid(api, group, options = {}) {
             peersOnCanvas().delete(selfPeer);
             unregisterTool();
             api.container.removeEventListener('pointermove', onHover);
+            guardedLayer === null || guardedLayer === void 0 ? void 0 : guardedLayer.removeEventListener('pointerdown', staticGuard);
             api.container.removeEventListener('focusin', onFocusIn);
             api.container.removeEventListener('keydown', onKey);
             hostObserver.disconnect();

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

@@ -27,7 +27,7 @@ import type { DashboardGridApi, DashboardGridHandle, DashboardGridOptions } from
 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' | 'dragHandle' | 'designHeight' | 'baseRowHeight' | 'dragOut' | 'removeZone' | 'onRemoveRequest' | 'onDropIn' | 'onGesture'> {
+export interface DashboardSplitOptions extends Pick<DashboardGridOptions, 'columns' | 'gap' | 'padding' | 'rtl' | 'fluid' | 'static' | 'dragHandle' | 'squeeze' | 'designHeight' | 'baseRowHeight' | 'dragOut' | 'removeZone' | 'onRemoveRequest' | 'onDropIn' | 'onGesture'> {
     /** An authored tree. Default: the persisted one, else derived from the members' cells. */
     tree?: SplitNode | null;
 }

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

@@ -377,23 +377,48 @@ export function bindDashboardSplit(api, group, options = {}) {
         selectedId = id;
         syncA11y();
     };
-    const syncA11y = () => {
+    // Static boards let content be clicked — see grid-binder's staticGuard.
+    const staticGuard = (e) => {
         var _a, _b, _c, _d;
+        if (!isStatic || disposed)
+            return;
+        const t = e.target;
+        const host = (_a = t === null || t === void 0 ? void 0 : t.closest) === null || _a === void 0 ? void 0 : _a.call(t, '.grafloria-node-host');
+        if (!host || !((_b = group.members) !== null && _b !== void 0 ? _b : new Set()).has((_c = host.getAttribute('data-node-id')) !== null && _c !== void 0 ? _c : ''))
+            return;
+        if ((_d = t === null || t === void 0 ? void 0 : t.closest) === null || _d === void 0 ? void 0 : _d.call(t, '.axdb-rs, .axdb-grip, .axdb-div'))
+            return;
+        e.stopPropagation();
+    };
+    let guardedLayer = null;
+    const ensureStaticGuard = () => {
+        if (guardedLayer === null || guardedLayer === void 0 ? void 0 : guardedLayer.isConnected)
+            return;
+        const layer = api.container.querySelector('.grafloria-html-layer');
+        if (!layer)
+            return;
+        guardedLayer === null || guardedLayer === void 0 ? void 0 : guardedLayer.removeEventListener('pointerdown', staticGuard);
+        guardedLayer = layer;
+        layer.addEventListener('pointerdown', staticGuard);
+    };
+    const syncA11y = () => {
+        var _a, _b, _c, _d, _e;
         if (disposed)
             return;
+        ensureStaticGuard();
         const order = splitLeaves(paintedTree()).filter((id) => !!diagram.getNode(id));
         if (selectedId && !order.includes(selectedId))
             selectedId = undefined;
         // No corner handles on a split board: size comes from the dividers. A host
         // that carried the grid's handle (a board switched live) sheds it here.
-        for (const id of order)
-            (_b = (_a = hostOf(id)) === null || _a === void 0 ? void 0 : _a.querySelector(':scope > .axdb-rs')) === null || _b === void 0 ? void 0 : _b.remove();
+        for (const id of (_a = group.members) !== null && _a !== void 0 ? _a : [])
+            (_c = (_b = hostOf(id)) === null || _b === void 0 ? void 0 : _b.querySelector(':scope > .axdb-rs')) === null || _c === void 0 ? void 0 : _c.remove();
         // The painted grip (or none), on every leaf host.
         for (const id of order) {
             const host = hostOf(id);
             const node = diagram.getNode(id);
             if (host && node)
-                syncGrip(host, gripOf(dragHandle), ((_c = node.state) === null || _c === void 0 ? void 0 : _c.locked) !== true && !isStatic && ((_d = node.getMetadata) === null || _d === void 0 ? void 0 : _d.call(node, 'widgetMovable')) !== false);
+                syncGrip(host, gripOf(dragHandle), ((_d = node.state) === null || _d === void 0 ? void 0 : _d.locked) !== true && !isStatic && ((_e = node.getMetadata) === null || _e === void 0 ? void 0 : _e.call(node, 'widgetMovable')) !== false);
         }
         if (focusedId && !order.includes(focusedId))
             focusedId = undefined;
@@ -1103,6 +1128,7 @@ export function bindDashboardSplit(api, group, options = {}) {
             });
         },
         dispose() {
+            guardedLayer === null || guardedLayer === void 0 ? void 0 : guardedLayer.removeEventListener('pointerdown', staticGuard);
             if (disposed)
                 return;
             cancelActiveGesture();

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

@@ -35,7 +35,7 @@ const CSS = `
 
 /* ===== keyboard focus: the roving tab stop shows where it is (WCAG 2.4.7) ===== */
 .grafloria-html-layer > .grafloria-node-host:focus-visible {
-  outline: 2px solid #3b52d9;
+  outline: 2px solid var(--axdb-accent, #3b52d9);
   outline-offset: 2px;
   border-radius: var(--axdb-rs-radius, 3px);
 }
@@ -203,9 +203,16 @@ const CSS = `
   content: ''; position: absolute; left: 5px; top: 2px; width: 12px; height: 6px;
   background: radial-gradient(circle, currentColor 1px, transparent 1.4px) 0 0 / 4px 3px;
 }
-.grafloria-node-host > .axdb-grip:hover { border-color: #3b52d9; color: #3b52d9; }
-/* The selected card says so, quietly. */
-.grafloria-node-host.axdb-selected > .axdb-widget { box-shadow: 0 0 0 1.5px rgba(59, 82, 217, .55), 0 1px 2px rgba(16, 24, 40, .05), 0 1px 3px rgba(16, 24, 40, .05); }
+.grafloria-node-host > .axdb-grip:hover { border-color: var(--axdb-accent, #3b52d9); color: var(--axdb-accent, #3b52d9); }
+/* The selected card says so, quietly. --axdb-accent themes the grip's hover, the
+   ring and the focus outline together; --axdb-accent-ring the ring alone. */
+.grafloria-node-host.axdb-selected > .axdb-widget { box-shadow: 0 0 0 1.5px var(--axdb-accent-ring, rgba(59, 82, 217, .55)), 0 1px 2px rgba(16, 24, 40, .05), 0 1px 3px rgba(16, 24, 40, .05); }
+/* While a resize edge is near, the host and everything in it (a chart canvas
+   with its own cursor included) show the edge's cursor. */
+.grafloria-node-host[data-axdb-edge="ns-resize"], .grafloria-node-host[data-axdb-edge="ns-resize"] * { cursor: ns-resize !important; }
+.grafloria-node-host[data-axdb-edge="ew-resize"], .grafloria-node-host[data-axdb-edge="ew-resize"] * { cursor: ew-resize !important; }
+.grafloria-node-host[data-axdb-edge="nwse-resize"], .grafloria-node-host[data-axdb-edge="nwse-resize"] * { cursor: nwse-resize !important; }
+.grafloria-node-host[data-axdb-edge="nesw-resize"], .grafloria-node-host[data-axdb-edge="nesw-resize"] * { cursor: nesw-resize !important; }
 /* INSIDE: centred on the header's text line and flush with the card padding,
    per size tier (padding 13/15, then 8/14, 4/12, 2/12). */
 .grafloria-node-host > .axdb-grip--inside { top: 14px; }