@marinoscar/platform-web 0.1.0-next.3 → 0.1.0-next.4

package/dist/datatable/headless/layout/useDataTableLayoutPrefs.d.ts

@@ -0,0 +1,123 @@
+/**
+ * DataTable — per-user layout persistence (issue #255, epic #238).
+ *
+ * Reads and writes ONE entry of the `dataTables` user-settings namespace
+ * through a {@link DataTablePreferencesPort}: by default the existing
+ * `GET` / `PATCH /api/user-settings` endpoints over the host's transport. There
+ * is no new endpoint and no new permission. With no port (no host mounted, no
+ * provider) everything stays in-session.
+ *
+ * ## Write discipline: debounced, fire-and-forget, in-session authoritative
+ *
+ * Three properties, and all three exist for the same reason — a layout
+ * preference is UI state that happens to be backed up, not domain data being
+ * submitted:
+ *
+ * - **In-session state is authoritative; the server copy is a cache.** The
+ *   layout the user sees comes from React state and is applied the instant they
+ *   click. The network is told afterwards, and is never consulted again for the
+ *   life of the mount. Nothing here ever calls `setState` from a response.
+ * - **Fire-and-forget.** A rejected write is logged and dropped. A user who
+ *   unchecks a column while offline must still get an unchecked column; making
+ *   the checkbox depend on a round trip would trade a working control for a
+ *   spinner and, on failure, a control that snaps back for no visible reason.
+ * - **Debounced.** Flipping four checkboxes is one intent, so it is one
+ *   request. The debounce is on the WRITE, never on the state update.
+ *
+ * ## Entry-replace PATCH semantics
+ *
+ * `PATCH /api/user-settings` merges `dataTables` per table id but replaces each
+ * ENTRY wholesale — a patch of `{ jobs: { pageSize: 100 } }` drops that
+ * entry's stored density and column list. So every write here sends the FULL
+ * in-session entry rather than a delta. That is cheap precisely because the
+ * hook already holds the complete resolved layout in state; it is also the only
+ * way "reset this field" stays expressible.
+ *
+ * "Reset to defaults" is the merge-patch delete, `{ [tableId]: null }`, which
+ * removes the entry entirely and frees its slot against the 40-table cap —
+ * rather than storing `{}`, which would be a second way to spell "absent".
+ */
+import type { DataTableColumn, DataTableDensity, DataTableLayout, DataTablePaginationConfig, DataTableSortConfig } from '../types.js';
+import { type DataTableSavedView } from './layoutModel.js';
+/**
+ * Options of {@link useDataTableLayoutPrefs}.
+ *
+ * @stability experimental
+ */
+export interface UseDataTableLayoutPrefsOptions<Row> {
+    /** Persistence key. Omit (or leave undefined) to keep everything in-session. */
+    tableId?: string;
+    /** The table's columns, to validate stored choices against. */
+    columns: DataTableColumn<Row>[];
+    /** The resolved layout, so `detail` folding composes with the user's choice. */
+    layout: DataTableLayout;
+    /** The page's default density — a floor the user's choice overrides. */
+    densityProp?: DataTableDensity;
+    /** Controlled sort, so a stored sort can be restored into the page's state. */
+    sort?: DataTableSortConfig;
+    /** Controlled pagination, likewise for a stored page size. */
+    pagination?: DataTablePaginationConfig;
+}
+/**
+ * What {@link useDataTableLayoutPrefs} returns.
+ *
+ * @stability experimental
+ */
+export interface DataTableLayoutPrefs {
+    /** Effective density: the user's choice, else the page's, else `standard`. */
+    density: DataTableDensity;
+    /** Column ids this layout draws right now (baseline ∩ user choice). */
+    visibleColumnIds: ReadonlySet<string>;
+    /** The user's choice alone, ignoring layout folding — what the picker shows. */
+    userVisibleColumnIds: ReadonlySet<string>;
+    /** `true` once a stored entry has been read (or persistence is off). */
+    hydrated: boolean;
+    /** `true` when anything differs from the contract defaults. */
+    customized: boolean;
+    /** Chooses the row density. */
+    setDensity: (density: DataTableDensity) => void;
+    /** Show/hide one column. Pinned (`hideable: false`) columns are ignored. */
+    toggleColumn: (columnId: string, visible: boolean) => void;
+    /** Drop every stored preference for this table (the saved views stay) and delete the server entry when nothing else is kept. */
+    reset: () => void;
+    /** The app's own stored JSON (`extra`), or `undefined` while there is none. Read-only. */
+    extra: Readonly<Record<string, unknown>> | undefined;
+    /**
+     * Sets (or, with `undefined`, removes) one key of `extra`. Refused (returns
+     * `false`, nothing changes) when the value is not bounded plain JSON or the
+     * entry would outgrow its limit.
+     */
+    setExtra: (key: string, value: unknown) => boolean;
+    /** The saved views, in the order they were saved. */
+    savedViews: readonly DataTableSavedView[];
+    /**
+     * Saves the current layout as a named view (`extra` defaults to the stored
+     * one; pass the app's own state, such as the filter model, to capture it).
+     * Returns the view, or `null` when refused: a blank or over-long name, 20
+     * views already, or an `extra` that is not bounded plain JSON.
+     */
+    saveView: (name: string, extra?: Record<string, unknown>) => DataTableSavedView | null;
+    /**
+     * Applies a saved view: its columns, density, extra, and (through the
+     * page's own callbacks) its sort and page size. Returns the view so the
+     * caller can restore what it kept in `layout.extra`, or `null` for an
+     * unknown id.
+     */
+    applyView: (id: string) => DataTableSavedView | null;
+    /** Deletes a saved view. */
+    deleteView: (id: string) => void;
+}
+/**
+ * Per-user layout preferences of one table: visible columns, density, sort and page size, restored from and persisted through the {@link DataTablePreferencesPort} in force.
+ *
+ * In-session state is authoritative: a change applies at once, and the write is debounced and fire-and-forget.
+ *
+ * @param options - the table id, its columns and the page's controlled sort and pagination.
+ * @returns the effective preferences and their setters.
+ *
+ * @extensionPoint hook
+ *
+ * @stability experimental
+ */
+export declare function useDataTableLayoutPrefs<Row>({ tableId, columns, layout, densityProp, sort, pagination, }: UseDataTableLayoutPrefsOptions<Row>): DataTableLayoutPrefs;
+//# sourceMappingURL=useDataTableLayoutPrefs.d.ts.map

package/dist/datatable/headless/layout/useDataTableLayoutPrefs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDataTableLayoutPrefs.d.ts","sourceRoot":"","sources":["../../../../src/datatable/headless/layout/useDataTableLayoutPrefs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAGH,OAAO,KAAK,EACV,eAAe,EACf,gBAAgB,EAChB,eAAe,EACf,yBAAyB,EACzB,mBAAmB,EACpB,MAAM,aAAa,CAAC;AACrB,OAAO,EAcL,KAAK,kBAAkB,EAIxB,MAAM,kBAAkB,CAAC;AAG1B;;;;GAIG;AACH,MAAM,WAAW,8BAA8B,CAAC,GAAG;IACjD,gFAAgF;IAChF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,+DAA+D;IAC/D,OAAO,EAAE,eAAe,CAAC,GAAG,CAAC,EAAE,CAAC;IAChC,gFAAgF;IAChF,MAAM,EAAE,eAAe,CAAC;IACxB,wEAAwE;IACxE,WAAW,CAAC,EAAE,gBAAgB,CAAC;IAC/B,+EAA+E;IAC/E,IAAI,CAAC,EAAE,mBAAmB,CAAC;IAC3B,8DAA8D;IAC9D,UAAU,CAAC,EAAE,yBAAyB,CAAC;CACxC;AAED;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC,8EAA8E;IAC9E,OAAO,EAAE,gBAAgB,CAAC;IAC1B,uEAAuE;IACvE,gBAAgB,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACtC,gFAAgF;IAChF,oBAAoB,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC1C,wEAAwE;IACxE,QAAQ,EAAE,OAAO,CAAC;IAClB,+DAA+D;IAC/D,UAAU,EAAE,OAAO,CAAC;IACpB,+BAA+B;IAC/B,UAAU,EAAE,CAAC,OAAO,EAAE,gBAAgB,KAAK,IAAI,CAAC;IAChD,4EAA4E;IAC5E,YAAY,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IAC3D,gIAAgI;IAChI,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,0FAA0F;IAC1F,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;IACrD;;;;OAIG;IACH,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC;IACnD,qDAAqD;IACrD,UAAU,EAAE,SAAS,kBAAkB,EAAE,CAAC;IAC1C;;;;;OAKG;IACH,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,kBAAkB,GAAG,IAAI,CAAC;IACvF;;;;;OAKG;IACH,SAAS,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,kBAAkB,GAAG,IAAI,CAAC;IACrD,4BAA4B;IAC5B,UAAU,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;CAClC;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,EAC3C,OAAO,EACP,OAAO,EACP,MAAM,EACN,WAAW,EACX,IAAI,EACJ,UAAU,GACX,EAAE,8BAA8B,CAAC,GAAG,CAAC,GAAG,oBAAoB,CA2Z5D"}

package/dist/datatable/headless/layout/useDataTableLayoutPrefs.js

@@ -0,0 +1,434 @@
+/**
+ * DataTable — per-user layout persistence (issue #255, epic #238).
+ *
+ * Reads and writes ONE entry of the `dataTables` user-settings namespace
+ * through a {@link DataTablePreferencesPort}: by default the existing
+ * `GET` / `PATCH /api/user-settings` endpoints over the host's transport. There
+ * is no new endpoint and no new permission. With no port (no host mounted, no
+ * provider) everything stays in-session.
+ *
+ * ## Write discipline: debounced, fire-and-forget, in-session authoritative
+ *
+ * Three properties, and all three exist for the same reason — a layout
+ * preference is UI state that happens to be backed up, not domain data being
+ * submitted:
+ *
+ * - **In-session state is authoritative; the server copy is a cache.** The
+ *   layout the user sees comes from React state and is applied the instant they
+ *   click. The network is told afterwards, and is never consulted again for the
+ *   life of the mount. Nothing here ever calls `setState` from a response.
+ * - **Fire-and-forget.** A rejected write is logged and dropped. A user who
+ *   unchecks a column while offline must still get an unchecked column; making
+ *   the checkbox depend on a round trip would trade a working control for a
+ *   spinner and, on failure, a control that snaps back for no visible reason.
+ * - **Debounced.** Flipping four checkboxes is one intent, so it is one
+ *   request. The debounce is on the WRITE, never on the state update.
+ *
+ * ## Entry-replace PATCH semantics
+ *
+ * `PATCH /api/user-settings` merges `dataTables` per table id but replaces each
+ * ENTRY wholesale — a patch of `{ jobs: { pageSize: 100 } }` drops that
+ * entry's stored density and column list. So every write here sends the FULL
+ * in-session entry rather than a delta. That is cheap precisely because the
+ * hook already holds the complete resolved layout in state; it is also the only
+ * way "reset this field" stays expressible.
+ *
+ * "Reset to defaults" is the merge-patch delete, `{ [tableId]: null }`, which
+ * removes the entry entirely and frees its slot against the 40-table cap —
+ * rather than storing `{}`, which would be a second way to spell "absent".
+ */
+import { useCallback, useEffect, useMemo, useRef, useState } from 'react';
+import { DATA_TABLE_ENTRY_MAX_BYTES, DATA_TABLE_MAX_ID_LENGTH, DATA_TABLE_MAX_SAVED_VIEWS, DATA_TABLE_PERSIST_DEBOUNCE_MS, DATA_TABLE_VIEW_NAME_MAX_LENGTH, encodeVisibility, isEmptyStoredLayout, isValidStoredExtra, jsonByteLength, resolveStoredSort, resolveUserVisibleColumnIds, resolveVisibleColumnIds, sanitizeStoredLayout, } from './layoutModel.js';
+import { useDataTablePreferencesPort } from './preferences.js';
+/**
+ * Per-user layout preferences of one table: visible columns, density, sort and page size, restored from and persisted through the {@link DataTablePreferencesPort} in force.
+ *
+ * In-session state is authoritative: a change applies at once, and the write is debounced and fire-and-forget.
+ *
+ * @param options - the table id, its columns and the page's controlled sort and pagination.
+ * @returns the effective preferences and their setters.
+ *
+ * @extensionPoint hook
+ *
+ * @stability experimental
+ */
+export function useDataTableLayoutPrefs({ tableId, columns, layout, densityProp, sort, pagination, }) {
+    // The one piece of authoritative state. Everything below either derives from
+    // it or pushes it at the network.
+    const [entry, setEntry] = useState({});
+    const [hydrated, setHydrated] = useState(!tableId);
+    const entryRef = useRef(entry);
+    entryRef.current = entry;
+    // Read through a ref, like the controlled configs below: a port that changes
+    // identity must not re-run the hydration effect or the write callback.
+    const port = useDataTablePreferencesPort();
+    const portRef = useRef(port);
+    portRef.current = port;
+    // Set as soon as the user touches a control, so a slow GET that lands
+    // afterwards can never overwrite a choice already on screen.
+    const touchedRef = useRef(false);
+    const mountedRef = useRef(true);
+    const timerRef = useRef(null);
+    // Read through refs: the controlled configs are recreated inline by most
+    // pages, and a restore effect that re-ran on every parent render would fight
+    // the page for its own state.
+    const columnsRef = useRef(columns);
+    columnsRef.current = columns;
+    const sortRef = useRef(sort);
+    sortRef.current = sort;
+    const paginationRef = useRef(pagination);
+    paginationRef.current = pagination;
+    /**
+     * The sort / page size this table is considered to have "started" at.
+     *
+     * Seeded once, at hydration, from the STORED entry where it has one and from
+     * the page's own props otherwise — so mounting a paginated table does not
+     * immediately persist its default page size as though the user had chosen it.
+     * Only a later divergence from this baseline is a preference worth storing.
+     */
+    const mirrorRef = useRef(null);
+    useEffect(() => {
+        mountedRef.current = true;
+        return () => {
+            mountedRef.current = false;
+        };
+    }, []);
+    // --- Writes ---------------------------------------------------------------
+    const write = useCallback((next) => {
+        if (!tableId)
+            return;
+        // `null` deletes the entry (JSON Merge Patch); an object replaces it
+        // wholesale, which is why `next` is always the COMPLETE entry.
+        //
+        // NO `If-Match` HEADER, DELIBERATELY.
+        //
+        // `PATCH /api/user-settings` supports optimistic concurrency: the
+        // controller reads `if-match` and the service compares it against the
+        // stored `version`, raising a 409 on a mismatch. The settings page's `useUserSettings`
+        // opts into that — it holds the whole settings object, shows a form, and a
+        // "settings were updated elsewhere" retry is the right answer there.
+        //
+        // It is the wrong answer here. This write is fire-and-forget UI backup
+        // (see the docblock above): it is debounced, its response is never read,
+        // and it only ever touches ONE key of ONE namespace. Sending a version we
+        // read at mount would make it fail on any race with a concurrent write to
+        // an UNRELATED namespace — a theme toggle in another tab bumps `version`,
+        // and the user's column choice would then silently fail to persist for no
+        // reason connected to columns. The server-side merge is already per-table
+        // and per-namespace, so there is no lost update to protect against: two
+        // concurrent writers of the SAME table entry is one user racing themselves.
+        //
+        // Verified against the API: `expectedVersion` is `undefined` when the
+        // header is absent, and the version check is skipped entirely in that case
+        // (`user-settings.controller.ts` → `user-settings.service.ts`).
+        const target = portRef.current;
+        if (!target)
+            return;
+        const failed = (error) => {
+            // Fire-and-forget by design: the layout the user is looking at came
+            // from state and stays there. Losing the backup is a warning, never
+            // a rollback.
+            console.warn(`Failed to persist DataTable layout for "${tableId}"`, error);
+        };
+        try {
+            void Promise.resolve(target.save(tableId, next)).catch(failed);
+        }
+        catch (error) {
+            failed(error);
+        }
+    }, [tableId]);
+    const cancelPending = useCallback(() => {
+        if (timerRef.current !== null) {
+            clearTimeout(timerRef.current);
+            timerRef.current = null;
+        }
+    }, []);
+    const schedule = useCallback((next) => {
+        if (!tableId)
+            return;
+        cancelPending();
+        timerRef.current = setTimeout(() => {
+            timerRef.current = null;
+            write(isEmptyStoredLayout(next) ? null : next);
+        }, DATA_TABLE_PERSIST_DEBOUNCE_MS);
+    }, [tableId, cancelPending, write]);
+    /** Apply a change to the in-session entry, then schedule one write for it. */
+    const commit = useCallback((mutate) => {
+        touchedRef.current = true;
+        const next = mutate(entryRef.current);
+        // A mutation that declined to change anything (a pinned column, say) is
+        // not a write — scheduling one would spend a request on nothing.
+        if (next === entryRef.current)
+            return;
+        entryRef.current = next;
+        setEntry(next);
+        schedule(next);
+    }, [schedule]);
+    // A pending write must survive the unmount that a route change causes —
+    // otherwise the last change before navigating away is the one that never
+    // lands. Flush it (still fire-and-forget) instead of cancelling it.
+    useEffect(() => () => {
+        if (timerRef.current !== null) {
+            clearTimeout(timerRef.current);
+            timerRef.current = null;
+            const pending = entryRef.current;
+            if (tableId)
+                write(isEmptyStoredLayout(pending) ? null : pending);
+        }
+    }, [tableId, write]);
+    // --- Hydration ------------------------------------------------------------
+    useEffect(() => {
+        if (!tableId) {
+            mirrorRef.current = {
+                sort: sortRef.current?.sort ?? null,
+                pageSize: paginationRef.current?.pageSize,
+            };
+            setHydrated(true);
+            return;
+        }
+        let cancelled = false;
+        setHydrated(false);
+        void (async () => {
+            let stored = {};
+            try {
+                const namespace = await portRef.current?.load();
+                stored = sanitizeStoredLayout(namespace?.[tableId]);
+            }
+            catch (error) {
+                // Same posture as a failed write: a settings outage costs the user
+                // their restored layout, never their ability to use the table.
+                console.warn(`Failed to load DataTable layout for "${tableId}"`, error);
+            }
+            if (cancelled || !mountedRef.current)
+                return;
+            // A choice made while the GET was in flight wins: in-session state is
+            // authoritative, and the server copy is only ever a starting point.
+            if (!touchedRef.current) {
+                entryRef.current = stored;
+                setEntry(stored);
+                // `sort` and `pageSize` are controlled by the PAGE, so restoring them
+                // means handing them back through the page's own callbacks rather than
+                // holding a second copy here. Both are validated against the current
+                // columns first: a stored sort on a column that has since been removed
+                // or made unsortable would be a query the server rejects.
+                const restoredSort = resolveStoredSort(columnsRef.current, stored);
+                const sortConfig = sortRef.current;
+                if (restoredSort && sortConfig) {
+                    const active = sortConfig.sort;
+                    if (!active ||
+                        active.field !== restoredSort.field ||
+                        active.direction !== restoredSort.direction) {
+                        sortConfig.onSortChange(restoredSort);
+                    }
+                }
+                const paginationConfig = paginationRef.current;
+                if (stored.pageSize && paginationConfig && stored.pageSize !== paginationConfig.pageSize) {
+                    // Page 0: a different page size makes the current offset meaningless.
+                    paginationConfig.onPaginationChange({ page: 0, pageSize: stored.pageSize });
+                }
+                // Baseline for the mirror effect below: a stored value where there is
+                // one (the restore we just requested will land on it), the page's own
+                // value otherwise. Either way, "no change yet" means "no write yet".
+                mirrorRef.current = {
+                    sort: restoredSort ?? sortRef.current?.sort ?? null,
+                    pageSize: stored.pageSize ?? paginationRef.current?.pageSize,
+                };
+            }
+            else {
+                mirrorRef.current = {
+                    sort: sortRef.current?.sort ?? null,
+                    pageSize: paginationRef.current?.pageSize,
+                };
+            }
+            setHydrated(true);
+        })();
+        return () => {
+            cancelled = true;
+        };
+    }, [tableId]);
+    // --- Mirroring the page's sort / pageSize into the entry -------------------
+    const activeSort = sort?.sort ?? null;
+    const activePageSize = pagination?.pageSize;
+    useEffect(() => {
+        if (!tableId || !hydrated)
+            return;
+        const baseline = mirrorRef.current;
+        if (!baseline)
+            return;
+        const nextSort = activeSort
+            ? { field: activeSort.field, direction: activeSort.direction }
+            : undefined;
+        const sortChanged = (baseline.sort?.field ?? null) !== (nextSort?.field ?? null) ||
+            (baseline.sort?.direction ?? null) !== (nextSort?.direction ?? null);
+        const pageSizeChanged = activePageSize !== undefined && baseline.pageSize !== activePageSize;
+        if (!sortChanged && !pageSizeChanged)
+            return;
+        mirrorRef.current = {
+            sort: nextSort ?? null,
+            pageSize: activePageSize ?? baseline.pageSize,
+        };
+        const current = entryRef.current;
+        const next = { ...current };
+        if (sortChanged) {
+            if (nextSort)
+                next.sort = nextSort;
+            else
+                delete next.sort;
+        }
+        if (pageSizeChanged)
+            next.pageSize = activePageSize;
+        entryRef.current = next;
+        setEntry(next);
+        schedule(next);
+    }, [tableId, hydrated, activeSort, activePageSize, schedule]);
+    // --- Derived layout -------------------------------------------------------
+    const density = entry.density ?? densityProp ?? 'standard';
+    const userVisibleColumnIds = useMemo(() => resolveUserVisibleColumnIds(columns, entry), [columns, entry]);
+    const visibleColumnIds = useMemo(() => resolveVisibleColumnIds(columns, entry, layout), [columns, entry, layout]);
+    const setDensity = useCallback((next) => {
+        commit((current) => ({ ...current, density: next }));
+    }, [commit]);
+    const toggleColumn = useCallback((columnId, visible) => {
+        commit((current) => {
+            const cols = columnsRef.current;
+            const column = cols.find((candidate) => candidate.id === columnId);
+            // A pinned column has no hidden state to store.
+            if (!column || column.hideable === false)
+                return current;
+            const chosen = new Set(resolveUserVisibleColumnIds(cols, current));
+            if (visible)
+                chosen.add(columnId);
+            else
+                chosen.delete(columnId);
+            return { ...current, visibleColumns: encodeVisibility(cols, chosen) };
+        });
+    }, [commit]);
+    const reset = useCallback(() => {
+        touchedRef.current = true;
+        cancelPending();
+        // The saved views are the user's own work, not a layout choice: "reset to
+        // defaults" keeps them. With none, the entry is deleted outright.
+        const views = entryRef.current.savedViews;
+        const kept = views && views.length > 0 ? { savedViews: views } : {};
+        entryRef.current = kept;
+        setEntry(kept);
+        // Immediate, not debounced: "reset" is a single deliberate gesture with
+        // nothing to coalesce, and it is expressed as the merge-patch DELETE so the
+        // entry stops existing rather than becoming an empty object.
+        write(isEmptyStoredLayout(kept) ? null : kept);
+    }, [cancelPending, write]);
+    const setExtra = useCallback((key, value) => {
+        const current = entryRef.current;
+        const nextExtra = { ...(current.extra ?? {}) };
+        if (value === undefined)
+            delete nextExtra[key];
+        else
+            nextExtra[key] = value;
+        const hasKeys = Object.keys(nextExtra).length > 0;
+        if (hasKeys && !isValidStoredExtra(nextExtra))
+            return false;
+        const next = { ...current };
+        if (hasKeys)
+            next.extra = nextExtra;
+        else
+            delete next.extra;
+        if (jsonByteLength(next) > DATA_TABLE_ENTRY_MAX_BYTES)
+            return false;
+        commit(() => next);
+        return true;
+    }, [commit]);
+    const saveView = useCallback((name, extra) => {
+        const trimmed = name.trim();
+        if (trimmed === '' || trimmed.length > DATA_TABLE_VIEW_NAME_MAX_LENGTH)
+            return null;
+        const current = entryRef.current;
+        const views = current.savedViews ?? [];
+        if (views.length >= DATA_TABLE_MAX_SAVED_VIEWS)
+            return null;
+        const captured = extra ?? current.extra;
+        if (captured !== undefined && Object.keys(captured).length > 0 && !isValidStoredExtra(captured))
+            return null;
+        const layout = {};
+        if (current.visibleColumns)
+            layout.visibleColumns = [...current.visibleColumns];
+        if (current.density)
+            layout.density = current.density;
+        const activeSort = sortRef.current?.sort;
+        if (activeSort)
+            layout.sort = { field: activeSort.field, direction: activeSort.direction };
+        const size = paginationRef.current?.pageSize;
+        if (size)
+            layout.pageSize = size;
+        if (captured && Object.keys(captured).length > 0)
+            layout.extra = captured;
+        const view = { id: uniqueViewId(trimmed, views), name: trimmed, layout };
+        const next = { ...current, savedViews: [...views, view] };
+        if (jsonByteLength(next) > DATA_TABLE_ENTRY_MAX_BYTES)
+            return null;
+        commit(() => next);
+        return view;
+    }, [commit]);
+    const applyView = useCallback((id) => {
+        const view = entryRef.current.savedViews?.find((candidate) => candidate.id === id);
+        if (!view)
+            return null;
+        commit((current) => ({ ...view.layout, ...(current.savedViews ? { savedViews: current.savedViews } : {}) }));
+        // Sort and page size are the PAGE's state: hand them back through its own
+        // callbacks, validated against the current columns like a restored layout.
+        const restoredSort = resolveStoredSort(columnsRef.current, view.layout);
+        const sortConfig = sortRef.current;
+        if (restoredSort && sortConfig)
+            sortConfig.onSortChange(restoredSort);
+        const paginationConfig = paginationRef.current;
+        if (view.layout.pageSize && paginationConfig && view.layout.pageSize !== paginationConfig.pageSize) {
+            paginationConfig.onPaginationChange({ page: 0, pageSize: view.layout.pageSize });
+        }
+        return view;
+    }, [commit]);
+    const deleteView = useCallback((id) => {
+        commit((current) => {
+            const views = current.savedViews;
+            if (!views?.some((view) => view.id === id))
+                return current;
+            const remaining = views.filter((view) => view.id !== id);
+            const next = { ...current };
+            if (remaining.length > 0)
+                next.savedViews = remaining;
+            else
+                delete next.savedViews;
+            return next;
+        });
+    }, [commit]);
+    return {
+        density,
+        visibleColumnIds,
+        userVisibleColumnIds,
+        hydrated,
+        customized: !isEmptyStoredLayout({ ...entry, savedViews: undefined }),
+        setDensity,
+        toggleColumn,
+        reset,
+        extra: entry.extra,
+        setExtra,
+        savedViews: entry.savedViews ?? NO_VIEWS,
+        saveView,
+        applyView,
+        deleteView,
+    };
+}
+const NO_VIEWS = Object.freeze([]);
+/** A slug of the name that no existing view uses, within the id length bound. */
+function uniqueViewId(name, views) {
+    const base = name
+        .toLowerCase()
+        .normalize('NFKD')
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '')
+        .slice(0, DATA_TABLE_MAX_ID_LENGTH - 6) || 'view';
+    const taken = new Set(views.map((view) => view.id));
+    let candidate = base;
+    for (let n = 2; taken.has(candidate); n += 1)
+        candidate = `${base}-${n}`;
+    return candidate;
+}
+//# sourceMappingURL=useDataTableLayoutPrefs.js.map

package/dist/datatable/headless/layout/useDataTableLayoutPrefs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDataTableLayoutPrefs.js","sourceRoot":"","sources":["../../../../src/datatable/headless/layout/useDataTableLayoutPrefs.ts"],"names":[],"mappings":"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"}