@12-apps/ui 6.13.0 → 6.13.2

package/dist/data-display/DataViews.js

@@ -1,92 +1,93 @@
 import {
   DataViewsTableBase
-} from "../chunk-BMAOQDVY.js";
+} from "../chunk-RRYQG5Y6.js";
 import "../chunk-LS42VJAI.js";
 import {
   DataViewsGrid
-} from "../chunk-JHBQZZHT.js";
+} from "../chunk-HNDUCGM3.js";
 import {
   BaseListCard
-} from "../chunk-XYRS4JOF.js";
+} from "../chunk-RDYBS45D.js";
 import "../chunk-UNF65XZW.js";
-import "../chunk-QRKBBOSY.js";
-import "../chunk-ZQPG57GA.js";
+import "../chunk-4KSOSI3U.js";
+import "../chunk-EICVL6GS.js";
 import "../chunk-2JCRNWHE.js";
 import {
   BaseCard
-} from "../chunk-WXHJG2UU.js";
+} from "../chunk-6U7NA74A.js";
 import "../chunk-MQUU2XZB.js";
+import "../chunk-ZOLAYP2D.js";
 import {
   DragContainerProvider,
   DropIndicator,
   useDragItem
 } from "../chunk-JCJGJX7V.js";
-import "../chunk-ZOLAYP2D.js";
-import "../chunk-W3UM2KEW.js";
-import "../chunk-IN642YHK.js";
+import "../chunk-Q4ITS2EP.js";
+import "../chunk-4VNUOSTQ.js";
 import "../chunk-S7CAXRRP.js";
-import "../chunk-WLCVOQCJ.js";
+import "../chunk-RUO4D4N6.js";
 import "../chunk-5WNQJ5KS.js";
 import "../chunk-ECIGNYSI.js";
-import "../chunk-ZHPKFV7Y.js";
-import "../chunk-NC2AATCC.js";
-import "../chunk-XIYPVNEB.js";
+import "../chunk-N6JGYVRY.js";
+import "../chunk-6PFBYCBU.js";
+import "../chunk-QQE2PVLO.js";
 import {
   DataViewsBoard
 } from "../chunk-3DQP6OPC.js";
-import "../chunk-BZTFPSWT.js";
+import "../chunk-XEE7PLDR.js";
+import "../chunk-FV36LFPX.js";
 import "../chunk-F4RR4666.js";
 import "../chunk-CBOB5AV6.js";
 import "../chunk-VR5HDUBK.js";
 import "../chunk-TQ6FPOPD.js";
 import "../chunk-IAGOUTI6.js";
-import "../chunk-FV36LFPX.js";
+import "../chunk-AWTERXCW.js";
 import "../chunk-2I5B5NNT.js";
 import "../chunk-A7Q5AQVD.js";
-import "../chunk-E2H7MBPM.js";
+import "../chunk-OGGHD64H.js";
 import "../chunk-GCZJH4XL.js";
 import {
   DEFAULT_RAILS,
   ListCardGroup,
   RAIL_COUNT
-} from "../chunk-YQJMVUBG.js";
+} from "../chunk-CZPU5TW3.js";
 import {
   DEFAULT_CELL_WIDTH
 } from "../chunk-6VP2L3DJ.js";
-import "../chunk-XPS7FWZS.js";
-import "../chunk-U7SO3N42.js";
-import "../chunk-UHXNEXOC.js";
-import "../chunk-5M4TYFR3.js";
-import "../chunk-FZHKKLOO.js";
-import "../chunk-WKRSVGT6.js";
+import "../chunk-WXBBWSNU.js";
 import "../chunk-NQCYVYP3.js";
-import "../chunk-P55UFXYW.js";
+import "../chunk-HGBZZDP6.js";
 import "../chunk-2PPWKCMW.js";
-import "../chunk-YRFKPRV2.js";
+import "../chunk-SCGVB7DS.js";
 import "../chunk-SNR537TI.js";
 import {
   cardMinWidthForZoom,
   cardScaleForZoom
-} from "../chunk-ZIPCGZA3.js";
+} from "../chunk-ZPIMPOHV.js";
 import "../chunk-QTPKACVO.js";
-import "../chunk-WIEXYVMU.js";
+import "../chunk-4ZEU22L2.js";
+import "../chunk-UHXNEXOC.js";
+import "../chunk-U7SO3N42.js";
+import "../chunk-5M4TYFR3.js";
+import "../chunk-HR7YTBR7.js";
 import "../chunk-DZEC6RFM.js";
-import "../chunk-TOUSE63W.js";
+import "../chunk-2UCJJACD.js";
 import "../chunk-4QQVIGRG.js";
 import "../chunk-YGQX7BNI.js";
 import "../chunk-IMLIIW77.js";
-import "../chunk-WTOTWP6A.js";
+import "../chunk-LLZWB32X.js";
 import {
   DataViewsScopeTabs,
   assertNoScopePillOverlap,
   resolveScope
 } from "../chunk-LYKV3C7B.js";
+import "../chunk-U5FOJBLG.js";
 import "../chunk-5VZPVDUF.js";
 import {
   CARD_ASPECT_RATIOS,
   DATA_VIEWS_LAYOUTS,
   toSavedViewSummary
-} from "../chunk-QEPGWTJT.js";
+} from "../chunk-LHHAYZ55.js";
 import "../chunk-T4SM36XC.js";
 import {
   DataViewsCopyProvider,
@@ -169,8 +170,8 @@ import "../chunk-X5MPHXG5.js";
 import "../chunk-DLJGBJZW.js";
 import "../chunk-KZLLTOB2.js";
 import "../chunk-E5LWJDI3.js";
-import "../chunk-5E3XZAED.js";
 import "../chunk-G3E66C6J.js";
+import "../chunk-5E3XZAED.js";
 import "../chunk-SNCSGLJ6.js";
 import "../chunk-TCAB2ERD.js";
 import "../chunk-NUGT7LMR.js";

package/dist/types/components/data-display/DataViews/data-views-grid-parts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"data-views-grid-parts.d.ts","sourceRoot":"","sources":["../../../../../src/components/data-display/DataViews/data-views-grid-parts.tsx"],"names":[],"mappings":"AASA,OAAO,EAGL,KAAK,eAAe,EACrB,MAAM,6BAA6B,CAAC;AAGrC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAIzD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAI1D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAGvD,OAAO,KAAK,EACV,qBAAqB,EACrB,iBAAiB,EACjB,gBAAgB,EAEhB,SAAS,EACV,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAuLlE,UAAU,cAAc,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACxD,CAAC,EAAE,mBAAmB,CAAC,CAAC,CAAC,CAAC;IAC1B,IAAI,EAAE,CAAC,EAAE,CAAC;IACV,MAAM,EAAE,iBAAiB,CAAC,CAAC,CAAC,EAAE,CAAC;IAC/B,WAAW,EAAE,gBAAgB,CAAC,CAAC,CAAC,EAAE,CAAC;IACnC,QAAQ,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,MAAM,GAAG,MAAM,CAAC;IACtC,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC7B,gBAAgB,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACnC,UAAU,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;IAC5B,WAAW,CAAC,EAAE,CAAC,YAAY,EAAE,CAAC,EAAE,EAAE,cAAc,EAAE,MAAM,IAAI,KAAK,KAAK,CAAC,SAAS,CAAC;IACjF;gDAC4C;IAC5C,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,EAAE,SAAS,EAAE,qBAAqB,KAAK,KAAK,CAAC,SAAS,CAAC;IAC3E;;;;OAIG;IACH,KAAK,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC;IACvB,6EAA6E;IAC7E,aAAa,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,EAAE,SAAS,EAAE,qBAAqB,KAAK,KAAK,CAAC,SAAS,CAAC;IAC9E,uEAAuE;IACvE,SAAS,CAAC,EAAE,eAAe,CAAC,CAAC,CAAC,CAAC;IAC/B,mEAAmE;IACnE,MAAM,CAAC,EAAE,WAAW,EAAE,CAAC;IACvB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,+EAA+E;IAC/E,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,yDAAyD;IACzD,WAAW,CAAC,EAAE,gBAAgB,CAAC;IAC/B,qEAAqE;IACrE,YAAY,CAAC,EAAE,cAAc,CAAC;IAC9B,2EAA2E;IAC3E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+DAA+D;IAC/D,aAAa,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAChC,8FAA8F;IAC9F,aAAa,CAAC,EAAE,eAAe,CAAC;IAChC,iFAAiF;IACjF,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B;;;;OAIG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB;;;;;;OAMG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAiFD,wBAAgB,SAAS,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAsCxG"}
+{"version":3,"file":"data-views-grid-parts.d.ts","sourceRoot":"","sources":["../../../../../src/components/data-display/DataViews/data-views-grid-parts.tsx"],"names":[],"mappings":"AASA,OAAO,EAGL,KAAK,eAAe,EACrB,MAAM,6BAA6B,CAAC;AAGrC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAIzD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAI1D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAGvD,OAAO,KAAK,EACV,qBAAqB,EACrB,iBAAiB,EACjB,gBAAgB,EAEhB,SAAS,EACV,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAwLlE,UAAU,cAAc,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACxD,CAAC,EAAE,mBAAmB,CAAC,CAAC,CAAC,CAAC;IAC1B,IAAI,EAAE,CAAC,EAAE,CAAC;IACV,MAAM,EAAE,iBAAiB,CAAC,CAAC,CAAC,EAAE,CAAC;IAC/B,WAAW,EAAE,gBAAgB,CAAC,CAAC,CAAC,EAAE,CAAC;IACnC,QAAQ,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,MAAM,GAAG,MAAM,CAAC;IACtC,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC7B,gBAAgB,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACnC,UAAU,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;IAC5B,WAAW,CAAC,EAAE,CAAC,YAAY,EAAE,CAAC,EAAE,EAAE,cAAc,EAAE,MAAM,IAAI,KAAK,KAAK,CAAC,SAAS,CAAC;IACjF;gDAC4C;IAC5C,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,EAAE,SAAS,EAAE,qBAAqB,KAAK,KAAK,CAAC,SAAS,CAAC;IAC3E;;;;OAIG;IACH,KAAK,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC;IACvB,6EAA6E;IAC7E,aAAa,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,EAAE,SAAS,EAAE,qBAAqB,KAAK,KAAK,CAAC,SAAS,CAAC;IAC9E,uEAAuE;IACvE,SAAS,CAAC,EAAE,eAAe,CAAC,CAAC,CAAC,CAAC;IAC/B,mEAAmE;IACnE,MAAM,CAAC,EAAE,WAAW,EAAE,CAAC;IACvB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,+EAA+E;IAC/E,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,yDAAyD;IACzD,WAAW,CAAC,EAAE,gBAAgB,CAAC;IAC/B,qEAAqE;IACrE,YAAY,CAAC,EAAE,cAAc,CAAC;IAC9B,2EAA2E;IAC3E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+DAA+D;IAC/D,aAAa,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAChC,8FAA8F;IAC9F,aAAa,CAAC,EAAE,eAAe,CAAC;IAChC,iFAAiF;IACjF,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B;;;;OAIG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB;;;;;;OAMG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAiFD,wBAAgB,SAAS,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAsCxG"}

package/dist/types/components/data-display/DataViews/data-views-selection.d.ts

@@ -4,7 +4,7 @@ interface DataViewsSelection<T> {
     setSelectedIds: (ids: Set<string | number>) => void;
     /** Add/remove ONE id — what a card's or board card's checkbox calls. */
     toggleId: (id: string | number) => void;
-    /** The selected rows, narrowed to what is currently rendered. */
+    /** The selected rows, INCLUDING ones the current page no longer renders. */
     selectedRows: T[];
     clearSelection: () => void;
     selectAll: () => void;
@@ -18,7 +18,36 @@ interface DataViewsSelection<T> {
  * because `toggleId` needs a functional update: two cards toggled in the same
  * tick would otherwise both read the pre-render set and the second would drop
  * the first's change.
+ *
+ * ## A selection has to survive PAGING
+ *
+ * `selectedIds` always did — nothing clears it when the page changes — but
+ * `selectedRows` was `matched.filter(...)`, and in SERVER mode `matched` is one
+ * page. So ticking three rows, paging, and ticking two more left the checkboxes
+ * claiming five and the bulk action receiving two, silently, with the other
+ * three still ticked on a page nobody was looking at.
+ *
+ * That is the worst shape a bug can have here: the UI and the write disagree,
+ * neither says so, and the rows that did not move are exactly the ones out of
+ * sight. So a row is REMEMBERED for as long as its id is selected, and
+ * `selectedRows` answers from that memory for anything the current page does
+ * not hold.
+ *
+ * **Server mode only** ({@link SelectionOptions.rememberOffPage}), and the
+ * distinction is not a hedge. In client mode `matched` is the whole filtered
+ * result, so nothing is ever off-page and there is nothing to remember — while
+ * narrowing the selection as the FILTER narrows is the behaviour a client-mode
+ * grid should keep. Remembering there would mean a bulk action reaching rows
+ * the operator has just filtered away.
  */
-export declare function useSelection<T>(matched: T[], getRowId: (row: T) => string | number): DataViewsSelection<T>;
+export interface SelectionOptions {
+    /**
+     * Keep rows the current page no longer renders.
+     *
+     * True in server mode, where `matched` is a page rather than the result.
+     */
+    rememberOffPage?: boolean;
+}
+export declare function useSelection<T>(matched: T[], getRowId: (row: T) => string | number, options?: SelectionOptions): DataViewsSelection<T>;
 export {};
 //# sourceMappingURL=data-views-selection.d.ts.map

package/dist/types/components/data-display/DataViews/data-views-selection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"data-views-selection.d.ts","sourceRoot":"","sources":["../../../../../src/components/data-display/DataViews/data-views-selection.ts"],"names":[],"mappings":"AAIA,+EAA+E;AAC/E,UAAU,kBAAkB,CAAC,CAAC;IAC5B,WAAW,EAAE,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;IAClC,cAAc,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC,KAAK,IAAI,CAAC;IACpD,wEAAwE;IACxE,QAAQ,EAAE,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,KAAK,IAAI,CAAC;IACxC,iEAAiE;IACjE,YAAY,EAAE,CAAC,EAAE,CAAC;IAClB,cAAc,EAAE,MAAM,IAAI,CAAC;IAC3B,SAAS,EAAE,MAAM,IAAI,CAAC;CACvB;AAED;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAC5B,OAAO,EAAE,CAAC,EAAE,EACZ,QAAQ,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,MAAM,GAAG,MAAM,GACpC,kBAAkB,CAAC,CAAC,CAAC,CAoBvB"}
+{"version":3,"file":"data-views-selection.d.ts","sourceRoot":"","sources":["../../../../../src/components/data-display/DataViews/data-views-selection.ts"],"names":[],"mappings":"AAIA,+EAA+E;AAC/E,UAAU,kBAAkB,CAAC,CAAC;IAC5B,WAAW,EAAE,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;IAClC,cAAc,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC,KAAK,IAAI,CAAC;IACpD,wEAAwE;IACxE,QAAQ,EAAE,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,KAAK,IAAI,CAAC;IACxC,4EAA4E;IAC5E,YAAY,EAAE,CAAC,EAAE,CAAC;IAClB,cAAc,EAAE,MAAM,IAAI,CAAC;IAC3B,SAAS,EAAE,MAAM,IAAI,CAAC;CACvB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;;OAIG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,wBAAgB,YAAY,CAAC,CAAC,EAC5B,OAAO,EAAE,CAAC,EAAE,EACZ,QAAQ,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,MAAM,GAAG,MAAM,EACrC,OAAO,GAAE,gBAAqB,GAC7B,kBAAkB,CAAC,CAAC,CAAC,CA4CvB"}

package/dist/types/components/data-display/DataViews/data-views-types.d.ts

@@ -135,6 +135,14 @@ export interface DataViewColumn<T extends Record<string, unknown>> extends GridC
  */
 export type DataViewsLayout = "cards" | "list" | "board" | "table";
 /** The full, serializable state a view captures. */
+/**
+ * A view-state patch: the fields to merge, or an updater given the CURRENT
+ * state. Use the updater whenever the patch derives from state it also changes
+ * — a render-scoped snapshot would let two calls in one tick read the same
+ * `prev` and the second overwrite the first, which is exactly what a control
+ * emitting one call per changed value does.
+ */
+export type DataViewStatePatch = Partial<DataViewState> | ((prev: DataViewState) => Partial<DataViewState>);
 export interface DataViewState {
     /** Free text matched across every `searchable` column. */
     search: string;

package/dist/types/components/data-display/DataViews/data-views-types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"data-views-types.d.ts","sourceRoot":"","sources":["../../../../../src/components/data-display/DataViews/data-views-types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"data-views-types.d.ts","sourceRoot":"","sources":["../../../../../src/components/data-display/DataViews/data-views-types.ts"],"names":[],"mappings":"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"}

package/dist/types/components/data-display/DataViews/data-views-writers.d.ts

@@ -0,0 +1,20 @@
+import { type Dispatch, type SetStateAction } from "react";
+import { type DataViewState, type DataViewStatePatch } from "./data-views-types";
+/**
+ * The two ways a DataViews state is WRITTEN, spelled once.
+ *
+ * Both are `setState` with a shape — a whole-state patch, and the one column
+ * toggle that has to merge into a list rather than replace a field. They sat
+ * inline in `useDataViewsState`, which is permanently at the size gate's
+ * ceiling; here they sit next to each other, where the fact that
+ * `toggleColumn` is just a `patch` with a merge rule is visible.
+ *
+ * Extracted for the same reason `useSelection` was: that hook is a COMPOSITION
+ * of the pieces below it, and every piece that can be named on its own leaves
+ * it reading as what it assembles rather than as how each part works.
+ */
+export declare function useStateWriters(setState: Dispatch<SetStateAction<DataViewState>>): {
+    patch: (next: DataViewStatePatch) => void;
+    toggleColumn: (id: string, visible: boolean) => void;
+};
+//# sourceMappingURL=data-views-writers.d.ts.map

package/dist/types/components/data-display/DataViews/data-views-writers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-views-writers.d.ts","sourceRoot":"","sources":["../../../../../src/components/data-display/DataViews/data-views-writers.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,QAAQ,EAAE,KAAK,cAAc,EAAE,MAAM,OAAO,CAAC;AAE3D,OAAO,EAAE,KAAK,aAAa,EAAE,KAAK,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAcjF;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,QAAQ,CAAC,cAAc,CAAC,aAAa,CAAC,CAAC,GAAG;IAClF,KAAK,EAAE,CAAC,IAAI,EAAE,kBAAkB,KAAK,IAAI,CAAC;IAC1C,YAAY,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;CACtD,CAUA"}

package/dist/types/components/data-display/DataViews/use-data-views-state.d.ts

@@ -2,7 +2,7 @@ import { type GridColumn } from "../DataGrid";
 import { type SortFieldDefinition } from "../../layout/ContentToolbar";
 import { type HideableColumn } from "./data-views-columns";
 import { type ScopeConfig } from "./data-views-scopes";
-import { type DataViewColumn, type DataViewServer, type DataViewState, type DataViewSyncState, type FilterFieldConfig, type RangeFieldConfig, type DataViewQuery, type RangeValue, type RowAction } from "./data-views-types";
+import { type DataViewColumn, type DataViewServer, type DataViewState, type DataViewStatePatch, type DataViewSyncState, type FilterFieldConfig, type RangeFieldConfig, type DataViewQuery, type RangeValue, type RowAction } from "./data-views-types";
 export type { HideableColumn };
 /** Inputs the hook needs to own the view state + derived data. */
 interface UseDataViewsStateArgs<T extends Record<string, unknown>> {
@@ -46,7 +46,15 @@ interface UseDataViewsStateArgs<T extends Record<string, unknown>> {
 export interface DataViewsController<T extends Record<string, unknown>> {
     state: DataViewState;
     ranges: Record<string, RangeValue>;
-    patch: (next: Partial<DataViewState>) => void;
+    /**
+     * Merge a partial into the view state.
+     *
+     * The UPDATER form is the one to reach for when the patch is derived from
+     * state you are also changing — successive calls within one tick each see the
+     * previous call's result, where the object form would have every caller build
+     * its patch from the same render-scoped snapshot and the last write would win.
+     */
+    patch: (next: DataViewStatePatch) => void;
     matched: T[];
     gridColumns: GridColumn<T>[];
     /** Columns eligible for the show/hide menu (hideable, with a text header). */

package/dist/types/components/data-display/DataViews/use-data-views-state.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-data-views-state.d.ts","sourceRoot":"","sources":["../../../../../src/components/data-display/DataViews/use-data-views-state.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"use-data-views-state.d.ts","sourceRoot":"","sources":["../../../../../src/components/data-display/DataViews/use-data-views-state.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@12-apps/ui",
-  "version": "6.13.0",
+  "version": "6.13.2",
   "license": "MIT",
   "packageManager": "pnpm@10.34.5",
   "type": "module",

package/src/components/data-display/DataViews/data-views-grid-parts.tsx

@@ -200,8 +200,9 @@ function useGridShellFilters<T extends Record<string, unknown>>({
     pills: state.pills,
     ranges: c.ranges,
     onSearchChange: (value) => c.patch({ search: value }),
+    // Updater, never the render's `state` — see {@link DataViewStatePatch}.
     onTogglePill: (fieldId, value, checked) =>
-      c.patch({ pills: { ...state.pills, [fieldId]: togglePillValues(state.pills[fieldId], value, checked) } }),
+      c.patch(({ pills }) => ({ pills: { ...pills, [fieldId]: togglePillValues(pills[fieldId], value, checked) } })),
     onChangeRange: (fieldId, range) => c.patch({ ranges: { ...c.ranges, [fieldId]: range } }),
     onClearField: (fieldId) => c.patch({ pills: { ...state.pills, [fieldId]: [] } }),
     onClearAll: () => c.patch({ search: "", pills: {}, ranges: {} }),

package/src/components/data-display/DataViews/data-views-selection.ts

@@ -1,6 +1,6 @@
 "use client";
 
-import { useMemo, useState } from "react";
+import { useMemo, useRef, useState } from "react";
 
 /** The multi-select model, identical in every layout (table, cards, board). */
 interface DataViewsSelection<T> {
@@ -8,7 +8,7 @@ interface DataViewsSelection<T> {
   setSelectedIds: (ids: Set<string | number>) => void;
   /** Add/remove ONE id — what a card's or board card's checkbox calls. */
   toggleId: (id: string | number) => void;
-  /** The selected rows, narrowed to what is currently rendered. */
+  /** The selected rows, INCLUDING ones the current page no longer renders. */
   selectedRows: T[];
   clearSelection: () => void;
   selectAll: () => void;
@@ -23,16 +23,71 @@ interface DataViewsSelection<T> {
  * because `toggleId` needs a functional update: two cards toggled in the same
  * tick would otherwise both read the pre-render set and the second would drop
  * the first's change.
+ *
+ * ## A selection has to survive PAGING
+ *
+ * `selectedIds` always did — nothing clears it when the page changes — but
+ * `selectedRows` was `matched.filter(...)`, and in SERVER mode `matched` is one
+ * page. So ticking three rows, paging, and ticking two more left the checkboxes
+ * claiming five and the bulk action receiving two, silently, with the other
+ * three still ticked on a page nobody was looking at.
+ *
+ * That is the worst shape a bug can have here: the UI and the write disagree,
+ * neither says so, and the rows that did not move are exactly the ones out of
+ * sight. So a row is REMEMBERED for as long as its id is selected, and
+ * `selectedRows` answers from that memory for anything the current page does
+ * not hold.
+ *
+ * **Server mode only** ({@link SelectionOptions.rememberOffPage}), and the
+ * distinction is not a hedge. In client mode `matched` is the whole filtered
+ * result, so nothing is ever off-page and there is nothing to remember — while
+ * narrowing the selection as the FILTER narrows is the behaviour a client-mode
+ * grid should keep. Remembering there would mean a bulk action reaching rows
+ * the operator has just filtered away.
  */
+export interface SelectionOptions {
+  /**
+   * Keep rows the current page no longer renders.
+   *
+   * True in server mode, where `matched` is a page rather than the result.
+   */
+  rememberOffPage?: boolean;
+}
+
 export function useSelection<T>(
   matched: T[],
   getRowId: (row: T) => string | number,
+  options: SelectionOptions = {},
 ): DataViewsSelection<T> {
   const [selectedIds, setSelectedIds] = useState<Set<string | number>>(new Set());
-  const selectedRows = useMemo(
-    () => matched.filter((row) => selectedIds.has(getRowId(row))),
-    [matched, selectedIds, getRowId],
-  );
+  // Rows seen while selected, so a selection outlives the page that made it.
+  // A ref rather than state: it is a CACHE derived from what has been rendered,
+  // and holding it in state would re-render on every page load to store rows
+  // nothing is waiting for.
+  const remembered = useRef(new Map<string | number, T>());
+
+  const selectedRows = useMemo(() => {
+    const onPage = matched.filter((row) => selectedIds.has(getRowId(row)));
+    if (!options.rememberOffPage) return onPage;
+
+    const cache = remembered.current;
+    // Refresh from what is on screen NOW: a row edited elsewhere and re-fetched
+    // must not be acted on through a stale snapshot from three pages ago.
+    for (const row of onPage) cache.set(getRowId(row), row);
+    // …and forget anything no longer selected, so the map cannot outgrow the
+    // selection it exists to describe.
+    for (const id of cache.keys()) if (!selectedIds.has(id)) cache.delete(id);
+
+    // On-page rows first, in the page's own order — unchanged from before this
+    // — then the remembered tail. Appending rather than interleaving keeps the
+    // familiar case byte-identical and makes the addition exactly the addition.
+    const onPageIds = new Set(onPage.map(getRowId));
+    const offPage = [...cache.entries()].flatMap(([id, row]) =>
+      onPageIds.has(id) ? [] : [row],
+    );
+    return [...onPage, ...offPage];
+  }, [matched, selectedIds, getRowId, options.rememberOffPage]);
+
   return {
     selectedIds,
     setSelectedIds,

package/src/components/data-display/DataViews/data-views-types.ts

@@ -170,6 +170,17 @@ export interface DataViewColumn<T extends Record<string, unknown>> extends GridC
 export type DataViewsLayout = "cards" | "list" | "board" | "table";
 
 /** The full, serializable state a view captures. */
+/**
+ * A view-state patch: the fields to merge, or an updater given the CURRENT
+ * state. Use the updater whenever the patch derives from state it also changes
+ * — a render-scoped snapshot would let two calls in one tick read the same
+ * `prev` and the second overwrite the first, which is exactly what a control
+ * emitting one call per changed value does.
+ */
+export type DataViewStatePatch =
+  | Partial<DataViewState>
+  | ((prev: DataViewState) => Partial<DataViewState>);
+
 export interface DataViewState {
   /** Free text matched across every `searchable` column. */
   search: string;

package/src/components/data-display/DataViews/data-views-writers.ts

@@ -0,0 +1,45 @@
+"use client";
+
+import { type Dispatch, type SetStateAction } from "react";
+
+import { type DataViewState, type DataViewStatePatch } from "./data-views-types";
+
+/**
+ * Add or remove one column id from the visible-columns list.
+ *
+ * Moved here with its only caller. A visible column is APPENDED rather than
+ * restored to its original index, which is what makes re-showing a column put
+ * it last — the behaviour the Exibir panel has always had.
+ */
+function nextVisibleColumns(current: string[], id: string, visible: boolean): string[] {
+  const without = current.filter((colId) => colId !== id);
+  return visible ? [...without, id] : without;
+}
+
+/**
+ * The two ways a DataViews state is WRITTEN, spelled once.
+ *
+ * Both are `setState` with a shape — a whole-state patch, and the one column
+ * toggle that has to merge into a list rather than replace a field. They sat
+ * inline in `useDataViewsState`, which is permanently at the size gate's
+ * ceiling; here they sit next to each other, where the fact that
+ * `toggleColumn` is just a `patch` with a merge rule is visible.
+ *
+ * Extracted for the same reason `useSelection` was: that hook is a COMPOSITION
+ * of the pieces below it, and every piece that can be named on its own leaves
+ * it reading as what it assembles rather than as how each part works.
+ */
+export function useStateWriters(setState: Dispatch<SetStateAction<DataViewState>>): {
+  patch: (next: DataViewStatePatch) => void;
+  toggleColumn: (id: string, visible: boolean) => void;
+} {
+  return {
+    patch: (next) =>
+      setState((prev) => ({ ...prev, ...(typeof next === "function" ? next(prev) : next) })),
+    toggleColumn: (id, visible) =>
+      setState((prev) => ({
+        ...prev,
+        visibleColumns: nextVisibleColumns(prev.visibleColumns, id, visible),
+      })),
+  };
+}

package/src/components/data-display/DataViews/use-data-views-state.ts

@@ -15,11 +15,13 @@ import { computeActiveFilterCount, defaultSortFields } from "./data-views-grid-h
 import { resolveScope, useScopeConfigChecks, type ScopeConfig } from "./data-views-scopes";
 import { serverDerived, useServerQuery } from "./data-views-server-query";
 import { useSelection } from "./data-views-selection";
+import { useStateWriters } from "./data-views-writers";
 import {
   emptyViewState,
   type DataViewColumn,
   type DataViewServer,
   type DataViewState,
+  type DataViewStatePatch,
   type DataViewSyncState,
   type FilterFieldConfig,
   type RangeFieldConfig,
@@ -73,7 +75,15 @@ interface UseDataViewsStateArgs<T extends Record<string, unknown>> {
 export interface DataViewsController<T extends Record<string, unknown>> {
   state: DataViewState;
   ranges: Record<string, RangeValue>;
-  patch: (next: Partial<DataViewState>) => void;
+  /**
+   * Merge a partial into the view state.
+   *
+   * The UPDATER form is the one to reach for when the patch is derived from
+   * state you are also changing — successive calls within one tick each see the
+   * previous call's result, where the object form would have every caller build
+   * its patch from the same render-scoped snapshot and the last write would win.
+   */
+  patch: (next: DataViewStatePatch) => void;
   matched: T[];
   gridColumns: GridColumn<T>[];
   /** Columns eligible for the show/hide menu (hideable, with a text header). */
@@ -159,12 +169,6 @@ function useMatchedRows<T extends Record<string, unknown>>(
   );
 }
 
-/** Add or remove one column id from the visible-columns list. */
-function nextVisibleColumns(current: string[], id: string, visible: boolean): string[] {
-  const without = current.filter((colId) => colId !== id);
-  return visible ? [...without, id] : without;
-}
-
 /**
  * Reconcile external state changes and surface every change to the caller:
  * - `appliedState` (a saved view) fully REPLACES the state — it is columns-
@@ -229,7 +233,7 @@ function seedState(
  * same reason changing any other part of the query clears it.
  */
 function makeSetScope(
-  patch: (next: Partial<DataViewState>) => void,
+  patch: (next: DataViewStatePatch) => void,
   clearSelection: () => void,
 ): (id: string) => void {
   return (id) => {
@@ -327,7 +331,7 @@ export function useDataViewsState<T extends Record<string, unknown>>({
 
   useStateSyncEffects(appliedState, syncState, state, onStateChange, setState);
 
-  const patch = (next: Partial<DataViewState>): void => setState((prev) => ({ ...prev, ...next }));
+  const { patch, toggleColumn } = useStateWriters(setState);
   const matched = useMatchedRows(server, rows, columns, fields, rangeFields, state);
   // Resolved at READ time, every render: a stale deep link or a saved view naming
   // a scope that has since been removed falls back to the first declared scope
@@ -341,9 +345,8 @@ export function useDataViewsState<T extends Record<string, unknown>>({
     onRowClick,
     state.order,
   );
-  const toggleColumn = (id: string, visible: boolean): void =>
-    setState((prev) => ({ ...prev, visibleColumns: nextVisibleColumns(prev.visibleColumns, id, visible) }));
-  const selection = useSelection(matched, getRowId);
+  // Server mode is where `matched` is a PAGE — see `useSelection` (FUT-942).
+  const selection = useSelection(matched, getRowId, { rememberOffPage: Boolean(server) });
   const resolvedSortFields = sortFields ?? defaultSortFields(columns);
 
   return {

package/dist/chunk-QEPGWTJT.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/components/data-display/DataViews/data-views-types.ts"],"sourcesContent":["import type { GridColumn, GridSort } from \"../DataGrid\";\nimport type { DropdownMenuItem } from \"../../navigation/DropdownMenu\";\n// A re-export does not bring the name into local scope, and the state/query\n// types below are written in terms of it.\nimport type { RangeValue } from \"./data-views-range-types\";\n\n/**\n * Shared types for the reusable admin \"DataViews\" table (FUT-88): a filter bar\n * (search-across-all + typed multi-select pills + column visibility) whose full\n * state — filters + sort + visible columns — a saved view (FUT-89) can capture\n * and restore. Each table declares its own columns + filter fields.\n */\n\n/**\n * A single, reusable row action. ONE definition drives BOTH the per-row \"⋮\"\n * kebab menu and the bulk-actions menu (tabwoah model): `onSelect` receives the\n * affected rows — `[row]` from a kebab, the whole selection from the bulk menu.\n * Single-item-only actions (e.g. \"Editar\") set `bulk: false` so they never\n * appear in the bulk menu.\n */\nexport interface RowAction<T extends Record<string, unknown>> {\n  /** Stable id (also the `data-testid` suffix). */\n  id: string;\n  /** Menu label. In the kebab, `rowLabel` overrides it per row when provided. */\n  label: string;\n  /** Menu-item colour (e.g. `\"error\"` for destructive). */\n  color?: DropdownMenuItem[\"color\"];\n  /**\n   * Runs on the affected rows: `[row]` from the kebab, all selected from bulk.\n   * May be async — the bulk menu awaits it and only clears the selection once it\n   * settles (keeping the selection on failure so the user can retry).\n   */\n  onSelect: (rows: T[]) => void | Promise<void>;\n  /** Include in the bulk menu (2+ selected). Defaults to `true`. */\n  bulk?: boolean;\n  /** Include in the per-row kebab. Defaults to `true`. */\n  row?: boolean;\n  /** Per-row kebab label (e.g. `row.active ? \"Inativar\" : \"Ativar\"`). */\n  rowLabel?: (row: T) => string;\n  /**\n   * Per-row applicability (e.g. state-machine guards). `false` hides the\n   * kebab item for that row; in bulk the action runs only on the passing\n   * rows and is dropped when none pass. Defaults to applicable.\n   */\n  isVisible?: (row: T) => boolean;\n}\n\n/** Selection state handed to a card renderer so it can drive its own checkbox. */\nexport interface DataViewCardSelection {\n  selected: boolean;\n  onToggleSelect: () => void;\n  /**\n   * Card SIZE multiplier from the toolbar zoom slider. The grid sizes the card's\n   * width to `base × scale`; a card passes this to {@link BaseCard} `scale` so its\n   * padding + typography grow by the same factor — the whole card scales together\n   * (scale 2 → ~2× size). The proportion (aspect ratio) stays constant.\n   */\n  scale: number;\n}\n\n/**\n * The fixed proportions a {@link BaseCard} tile can take. The tile keeps this\n * ratio and grows in BOTH width and height as the zoom slider widens its grid\n * track, so a grid of cards stays visually uniform.\n */\nexport type CardAspectRatio = \"1:1\" | \"4:3\" | \"16:9\" | \"9:16\" | \"3:4\" | \"3:1\";\n\n/** Numeric width/height factor for each {@link CardAspectRatio} (CSS `aspect-ratio`). */\nexport const CARD_ASPECT_RATIOS: Record<CardAspectRatio, number> = {\n  \"1:1\": 1,\n  \"4:3\": 4 / 3,\n  \"16:9\": 16 / 9,\n  \"9:16\": 9 / 16,\n  \"3:4\": 3 / 4,\n  /**\n   * The BANNER tile: too short for media, sized for two lines of text.\n   *\n   * Every other ratio here is picture-shaped, because they were added for cards\n   * built around a thumbnail. A card whose subject is a NAME and a NUMBER — a\n   * cart, an order, anything triaged rather than browsed — spends most of a 4:3\n   * tile on an icon that repeats down the whole grid and says nothing.\n   */\n  \"3:1\": 3,\n};\n\n/** One selectable value inside a filter pill. */\nexport interface FilterOption {\n  value: string;\n  label: string;\n  /**\n   * Parent option's `value`, for a hierarchical field (`control: \"category\"`).\n   * Ignored by the flat controls, so one option list serves both.\n   */\n  parentId?: string | null;\n}\n\n/** A typed, multi-select filter pill's configuration for a table. */\nexport interface FilterFieldConfig<T extends Record<string, unknown>> {\n  /** Stable id; also the default row key when no `accessor` is given. */\n  id: string;\n  label: string;\n  options: FilterOption[];\n  /**\n   * How the field renders in the filter panel. `checkboxes` (default) is best for\n   * a few fixed options; `multiselect` is a compact dropdown for long option\n   * lists; `category` is the hierarchical picker, for an option set that nests\n   * via {@link FilterOption.parentId} — it renders parents as headings and\n   * their children as the selectable rows, rather than flattening the tree into\n   * one indistinguishable list.\n   */\n  control?: \"checkboxes\" | \"multiselect\" | \"category\";\n  /**\n   * Lets a `control: \"category\"` pill select a PARENT category, not just its\n   * children. Off by default, which keeps the leaf-only reading: the parent is\n   * a heading and its subcategories are the rows you tick.\n   *\n   * Turn it on where \"the whole category\" is a filter a user would reach for —\n   * selecting a parent then selects every subcategory under it, and the chip\n   * tray collapses that back to one chip bearing the category's name.\n   *\n   * A category with NO children is selectable either way: it is itself the\n   * leaf, so the flag has nothing to gate there.\n   */\n  allowParentSelection?: boolean;\n  /**\n   * Forces this filter to render as a searchable multi-select dropdown with the\n   * search box always shown, regardless of how many options are currently\n   * loaded. Use it when the option set can grow unbounded (e.g. a filter backed\n   * by a relation such as Roles or Categories). Omit it for a closed value set\n   * (an enum), which keeps the plain checkbox / \"search only when long\"\n   * behavior.\n   */\n  searchEnabled?: boolean;\n  /**\n   * Reads the row's value(s) for this field. A row matches the pill when any of\n   * its values is selected. Defaults to `String(row[id])`.\n   */\n  accessor?: (row: T) => string | string[];\n}\n\n/**\n * The range types live in `data-views-range-types` (this file outgrew the\n * size gate); they are re-exported here so `data-views-types` stays the one\n * name every consumer imports the model from.\n */\nexport type {\n  DayRangeFieldConfig,\n  NumberRangeFieldConfig,\n  RangeFieldConfig,\n  RangeFieldKind,\n  RangePreset,\n  RangeValue,\n} from \"./data-views-range-types\";\n\n/** A grid column that can join the search scan and the column-visibility menu. */\nexport interface DataViewColumn<T extends Record<string, unknown>> extends GridColumn<T> {\n  /** Included in \"search across all columns\" (needs a resolvable value). */\n  searchable?: boolean;\n  /** Toggleable in the column-visibility menu. Defaults to true; set false for\n   *  structural columns (image thumbnail, actions kebab) that must always show. */\n  hideable?: boolean;\n}\n\n/**\n * The DataViews layout (view type): the dense \"Tabela\" grid, the \"Grade\" of\n * cards, the \"Lista\" of full-width rows, or the \"Quadro\" board of state columns.\n * Lives with the state types rather than with the toggle because a saved view\n * CAPTURES it — see {@link DataViewState.layout}.\n */\nexport type DataViewsLayout = \"cards\" | \"list\" | \"board\" | \"table\";\n\n/** The full, serializable state a view captures. */\nexport interface DataViewState {\n  /** Free text matched across every `searchable` column. */\n  search: string;\n  /** fieldId → selected option values (empty/absent = no constraint). */\n  pills: Record<string, string[]>;\n  /** fieldId → selected numeric range (min/max). Absent/empty = no constraint. */\n  ranges?: Record<string, RangeValue>;\n  sortBy: GridSort[];\n  /** Column ids kept visible; a hideable column not listed here is hidden. */\n  visibleColumns: string[];\n  /**\n   * Column ids in READING ORDER. Absent ⇒ the order the table declared them in.\n   *\n   * Order is view state for the same reason visibility is: reordering columns is\n   * an operator deciding what to read FIRST, and a saved view that restored the\n   * columns but not their order would restore half a decision. Ids the table no\n   * longer declares are ignored at render, and ids missing from a stale list\n   * fall in after it — so a column added since the view was saved appears rather\n   * than disappearing.\n   */\n  order?: string[];\n  /**\n   * The active SCOPE id — the page-level partition the scope tabs select (see\n   * `ScopeConfig`). Optional, so a table that declares no scopes is untouched\n   * and no view persisted before scopes existed breaks.\n   *\n   * Stored raw and RESOLVED at read time: the declared scopes change underneath\n   * a saved view, and a view naming a scope that has since been removed must\n   * fall back at render rather than break.\n   */\n  scope?: string;\n  /**\n   * The layout the view was saved in. Optional — absent means \"whatever the user\n   * is currently using\", which is the pre-existing behaviour.\n   *\n   * A LAYOUT FALLBACK IS NOT A LAYOUT CHANGE: a table rendered as stacked rows\n   * on a phone still has `\"table\"` stored here, so the view round-trips the\n   * stored layout regardless of the device that opened it.\n   */\n  layout?: DataViewsLayout;\n}\n\n/** A pristine view state showing every given column and no filters/sort. */\nexport function emptyViewState(visibleColumns: string[]): DataViewState {\n  return { search: \"\", pills: {}, ranges: {}, sortBy: [], visibleColumns };\n}\n\n/**\n * The URL-driven slice of {@link DataViewState} — the controls a server-mode host\n * mirrors from the address bar (search / pills / ranges / sort), WITHOUT\n * `visibleColumns`. Supplying it re-applies those controls when its reference\n * changes (e.g. browser back/forward or a deep-link on the same route), merging\n * over the current state so a user's show/hide column choices are preserved —\n * unlike `appliedState`, which fully replaces the state to apply a saved view.\n */\nexport type DataViewSyncState = Pick<\n  DataViewState,\n  \"search\" | \"pills\" | \"ranges\" | \"sortBy\" | \"scope\"\n>;\n\n/**\n * The query a SERVER-mode table emits whenever its filter/sort/page changes\n * (FUT-180). The host translates this into a backend request (see\n * `@12-apps/shared-helpers/search`) — in server mode the grid never filters,\n * sorts, or paginates in the browser; it renders exactly the page the server\n * returned. `page` is 1-based to match the backend contract.\n */\nexport interface DataViewQuery {\n  search: string;\n  pills: Record<string, string[]>;\n  ranges: Record<string, RangeValue>;\n  sortBy: GridSort[];\n  /**\n   * The RESOLVED active scope (see `resolveScope`), when the table declares\n   * scopes. The KEY IS ABSENT for a table that declares none — not present-and-\n   * undefined — so a host that never opted in sees a byte-identical query.\n   *\n   * It carries the resolved id, never the stored one: a deep link or a saved\n   * view naming a scope the table no longer declares must not put that id on the\n   * wire, where the backend would reject it and replace the page with an error.\n   */\n  scope?: string;\n  page: number;\n  pageSize: number;\n}\n\n/**\n * Server-mode wiring for a DataViews table. Its PRESENCE flips the table from\n * in-browser filtering/sorting/pagination to backend-driven: the rows handed in\n * are already the current page, `totalCount` is the unpaginated total, and\n * `onQueryChange` fires (search debounced by the host) whenever the user changes\n * a filter, the sort, or the page. This is the ONLY way an admin list should run\n * (see the app-side `DataViewsTable` wrapper, which requires it).\n */\nexport interface DataViewServer {\n  /** Total matched rows across all pages (drives the counter + page count). */\n  totalCount: number;\n  /** Current 1-based page. */\n  page: number;\n  /** Rows per page. */\n  pageSize: number;\n  /** Fired when the effective query changes; the host re-fetches the page. */\n  onQueryChange: (query: DataViewQuery) => void;\n  /**\n   * Per-scope totals for the scope tabs: `scopeId → count`. THE ONLY PIECE OF\n   * THIS CONTRACT THAT CANNOT BE DONE CLIENT-SIDE — a count computed from the\n   * loaded page is wrong the moment there is a second page, which is the\n   * concrete bug scopes exist to fix.\n   *\n   * Compute it over search + pills + ranges while IGNORING the active scope.\n   * Computed WITH the scope applied, every inactive tab reads zero, which is\n   * worse than no counts at all.\n   *\n   * Omit it and the tabs render with no numbers. Nothing is ever invented from\n   * the loaded rows to fill the gap.\n   */\n  scopeCounts?: Record<string, number>;\n}\n\n/**\n * Coerce an opaque persisted state (a saved view's JSON) into a valid\n * DataViewState, filling any missing part with a sane default. Guards against\n * legacy/older shapes so applying a saved view never renders an empty grid.\n */\nexport function coerceViewState(raw: unknown, allColumnIds: string[]): DataViewState {\n  const value = (raw ?? {}) as Partial<DataViewState>;\n  return {\n    search: typeof value.search === \"string\" ? value.search : \"\",\n    pills: asRecord<string[]>(value.pills),\n    ranges: asRecord<RangeValue>(value.ranges),\n    sortBy: Array.isArray(value.sortBy) ? value.sortBy : [],\n    visibleColumns: Array.isArray(value.visibleColumns) ? value.visibleColumns : allColumnIds,\n    order: Array.isArray(value.order) ? value.order : undefined,\n    // Carried through UNVALIDATED against the declared scopes on purpose: a view\n    // written before scopes existed has none (⇒ undefined ⇒ the first declared\n    // scope at render), and one naming a since-removed scope keeps its stored id\n    // here and falls back at READ time. Resolving here would rewrite the view.\n    scope: typeof value.scope === \"string\" ? value.scope : undefined,\n    layout: isLayout(value.layout) ? value.layout : undefined,\n  };\n}\n\n/** Every layout this build knows how to render — the guard's single source. */\nexport const DATA_VIEWS_LAYOUTS: readonly DataViewsLayout[] = [\"cards\", \"list\", \"board\", \"table\"];\n\n/** Is this a layout this build knows how to render? Guards persisted JSON. */\nfunction isLayout(value: unknown): value is DataViewsLayout {\n  return DATA_VIEWS_LAYOUTS.includes(value as DataViewsLayout);\n}\n\n/** A persisted map, or an empty one — persisted JSON can hold anything. */\nfunction asRecord<V>(value: unknown): Record<string, V> {\n  return value !== null && typeof value === \"object\" ? (value as Record<string, V>) : {};\n}\n\n/** A saved view as consumed by the DataViews UI (FUT-89), with ownership flag. */\nexport interface SavedViewSummary {\n  id: string;\n  name: string;\n  description: string | null;\n  state: DataViewState;\n  shared: boolean;\n  pinned: boolean;\n  isDefault: boolean;\n  /** True when the current user owns the view (may edit/delete/pin/share it). */\n  isOwner: boolean;\n}\n\n/** A saved-view repository record (opaque `state`), as returned to server pages. */\ninterface SavedViewRecordLike {\n  id: string;\n  name: string;\n  description: string | null;\n  state: unknown;\n  shared: boolean;\n  pinned: boolean;\n  isDefault: boolean;\n  isOwner: boolean;\n}\n\n/** Map a repository record to the client summary (opaque state → DataViewState). */\nexport function toSavedViewSummary(record: SavedViewRecordLike): SavedViewSummary {\n  return { ...record, state: (record.state ?? {}) as DataViewState };\n}\n\n/**\n * Dependency-injection contracts for the framework-agnostic DataViewsTableBase:\n * the host app supplies saved-view persistence + router side-effects so the ui\n * component imports neither a backend (server actions) nor a framework router.\n */\n\n/** A saved view's editable fields, as the host persists them. */\nexport interface DataViewSaveInput {\n  name: string;\n  description: string;\n  state: DataViewState;\n  shared: boolean;\n  pinned: boolean;\n  isDefault: boolean;\n}\n\n/** Result of a persistence call — mirrors the app's `Result` without importing it. */\nexport type DataViewMutationResult = { ok: true } | { ok: false; error: string };\n\n/** Injected saved-view persistence (create/update/delete), wired by the host. */\nexport interface DataViewPersistence {\n  create: (input: DataViewSaveInput) => Promise<DataViewMutationResult>;\n  update: (id: string, input: DataViewSaveInput) => Promise<DataViewMutationResult>;\n  remove: (id: string) => Promise<DataViewMutationResult>;\n}\n\n/** Injected router side-effects: sync the `?view=` param and re-fetch on change. */\nexport interface DataViewRouter {\n  syncViewParam: (viewId: string | null) => void;\n  refresh: () => void;\n}\n"],"mappings":";AAoEO,IAAM,qBAAsD;AAAA,EACjE,OAAO;AAAA,EACP,OAAO,IAAI;AAAA,EACX,QAAQ,KAAK;AAAA,EACb,QAAQ,IAAI;AAAA,EACZ,OAAO,IAAI;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASX,OAAO;AACT;AAoIO,SAAS,eAAe,gBAAyC;AACtE,SAAO,EAAE,QAAQ,IAAI,OAAO,CAAC,GAAG,QAAQ,CAAC,GAAG,QAAQ,CAAC,GAAG,eAAe;AACzE;AA+EO,SAAS,gBAAgB,KAAc,cAAuC;AACnF,QAAM,QAAS,OAAO,CAAC;AACvB,SAAO;AAAA,IACL,QAAQ,OAAO,MAAM,WAAW,WAAW,MAAM,SAAS;AAAA,IAC1D,OAAO,SAAmB,MAAM,KAAK;AAAA,IACrC,QAAQ,SAAqB,MAAM,MAAM;AAAA,IACzC,QAAQ,MAAM,QAAQ,MAAM,MAAM,IAAI,MAAM,SAAS,CAAC;AAAA,IACtD,gBAAgB,MAAM,QAAQ,MAAM,cAAc,IAAI,MAAM,iBAAiB;AAAA,IAC7E,OAAO,MAAM,QAAQ,MAAM,KAAK,IAAI,MAAM,QAAQ;AAAA;AAAA;AAAA;AAAA;AAAA,IAKlD,OAAO,OAAO,MAAM,UAAU,WAAW,MAAM,QAAQ;AAAA,IACvD,QAAQ,SAAS,MAAM,MAAM,IAAI,MAAM,SAAS;AAAA,EAClD;AACF;AAGO,IAAM,qBAAiD,CAAC,SAAS,QAAQ,SAAS,OAAO;AAGhG,SAAS,SAAS,OAA0C;AAC1D,SAAO,mBAAmB,SAAS,KAAwB;AAC7D;AAGA,SAAS,SAAY,OAAmC;AACtD,SAAO,UAAU,QAAQ,OAAO,UAAU,WAAY,QAA8B,CAAC;AACvF;AA4BO,SAAS,mBAAmB,QAA+C;AAChF,SAAO,EAAE,GAAG,QAAQ,OAAQ,OAAO,SAAS,CAAC,EAAoB;AACnE;","names":[]}