@marktiderman/genesis-ui 2.0.0 → 2.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Mark Tiderman
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/{AppShell-BJarYZzz.d.ts → AppShell-sQT0UbXg.d.ts}

@@ -1,7 +1,7 @@
-import * as react_jsx_runtime from 'react/jsx-runtime';
+import * as React from 'react';
 import { ReactNode } from 'react';
 import { LucideIcon } from 'lucide-react';
-import { V as ViewMode } from './view-toggle-DDe_Luj2.js';
+import { V as ViewMode } from './view-toggle-CahQ87PW.js';
 import { Density } from './hooks/use-view-settings.js';
 import { L as LinkComponent } from './navigation-CpOEyUSb.js';
 
@@ -65,7 +65,7 @@ interface PageHeaderProps {
     onDensityChange?: (density: Density) => void;
     createAction?: ReactNode;
 }
-declare function PageHeader({ title, subtitle, icon: Icon, options: optionsProp, optionsStorageKey, actions, details, detailsOpen, onDetailsOpenChange, detailsActive, detailsHint, count, totalCount, entityName, countActive, viewMode, onViewModeChange, pageSize, onPageSizeChange, density, onDensityChange, createAction, }: PageHeaderProps): react_jsx_runtime.JSX.Element;
+declare function PageHeader({ title, subtitle, icon: Icon, options: optionsProp, optionsStorageKey, actions, details, detailsOpen, onDetailsOpenChange, detailsActive, detailsHint, count, totalCount, entityName, countActive, viewMode, onViewModeChange, pageSize, onPageSizeChange, density, onDensityChange, createAction, }: PageHeaderProps): React.JSX.Element;
 
 interface NavItem {
     to: string;
@@ -193,6 +193,6 @@ interface AppShellProps {
      */
     isActive?: (to: string, activePath?: string) => boolean;
 }
-declare function AppShell({ appName, appLogo, logo, navItems, secondaryNavItems, secondaryNavLabel, mobileNavItems, headerSlot, collapsedHeaderSlot, footer, userSlot, children, showThemeToggle: showThemeToggleProp, options: optionsProp, optionsStorageKey, collapsed: collapsedProp, onCollapsedChange, linkComponent, activePath, isActive, }: AppShellProps): react_jsx_runtime.JSX.Element;
+declare function AppShell({ appName, appLogo, logo, navItems, secondaryNavItems, secondaryNavLabel, mobileNavItems, headerSlot, collapsedHeaderSlot, footer, userSlot, children, showThemeToggle: showThemeToggleProp, options: optionsProp, optionsStorageKey, collapsed: collapsedProp, onCollapsedChange, linkComponent, activePath, isActive, }: AppShellProps): React.JSX.Element;
 
 export { AppShell as A, type NavItem as N, PageHeader as P, type AppShellOptions as a, type AppShellProps as b, type PageHeaderOptions as c, type PageHeaderProps as d };

package/dist/{chunk-Q4I4SFBD.js → chunk-GDFNAHI4.js}

@@ -77,7 +77,8 @@ function useResourcePage(props) {
     titleField: titleFieldProp,
     subtitleField: subtitleFieldProp,
     initialFilters,
-    onFiltersChange
+    onFiltersChange,
+    controlled = false
   } = props;
   const [viewMode, setViewMode] = useViewPreference(
     resource ?? "resource-page",
@@ -136,6 +137,7 @@ function useResourcePage(props) {
     [searchFieldsProp, rawData]
   );
   const filteredData = useMemo(() => {
+    if (controlled) return rawData;
     let result = rawData;
     if (search) {
       result = result.filter(
@@ -152,7 +154,7 @@ function useResourcePage(props) {
       result = [...result].sort((a, b) => compareItems(a, b, sort));
     }
     return result;
-  }, [rawData, search, searchFields, statusFieldName, statusValue, sort]);
+  }, [controlled, rawData, search, searchFields, statusFieldName, statusValue, sort]);
   const sortOptions = useMemo(() => {
     const opts = [];
     for (const col of resolvedColumns) {
@@ -258,7 +260,9 @@ function useResourcePage(props) {
   );
   return {
     data: filteredData,
-    total: filteredData.length,
+    // Controlled mode: `filteredData` is one server page, so its length is
+    // not the record count — the server's total is.
+    total: controlled ? rawTotal : filteredData.length,
     columns: resolvedColumns,
     tableColumns,
     filterConfig,
@@ -284,5 +288,5 @@ function useResourcePage(props) {
 }
 
 export { titleCase, useResourcePage };
-//# sourceMappingURL=chunk-Q4I4SFBD.js.map
-//# sourceMappingURL=chunk-Q4I4SFBD.js.map
+//# sourceMappingURL=chunk-GDFNAHI4.js.map
+//# sourceMappingURL=chunk-GDFNAHI4.js.map

package/dist/chunk-GDFNAHI4.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/hooks/use-resource-page.ts"],"names":[],"mappings":"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","file":"chunk-GDFNAHI4.js","sourcesContent":["\"use client\";\n\nimport { useState, useMemo, useCallback, useEffect, useRef } from \"react\";\nimport type { ReactNode } from \"react\";\nimport type { DataTableColumn } from \"../components/data/DataTable\";\nimport type { DataFilterConfig } from \"../components/data/DataFilters\";\nimport type { ViewMode } from \"../components/patterns/view-toggle\";\nimport type { Identifier, FilterParam, SortParam } from \"@marktiderman/genesis-core/provider\";\nimport { useViewPreference } from \"./use-view-preference\";\n\n// ---------------------------------------------------------------------------\n// Public types\n// ---------------------------------------------------------------------------\n\n/** Actions available inside column render functions. */\nexport interface ResourceActions<T> {\n  update: (id: Identifier, data: Partial<T>) => Promise<T>;\n  remove: (id: Identifier) => Promise<void>;\n  refetch: () => void;\n}\n\n/** Column definition — full config form. */\nexport interface ResourceColumnDef<T> {\n  key: string;\n  header?: string;\n  sortable?: boolean;\n  hideBelow?: \"sm\" | \"md\" | \"lg\" | \"xl\";\n  render?: (\n    item: T,\n    value: unknown,\n    actions: ResourceActions<T>,\n  ) => ReactNode;\n}\n\nexport interface UseResourcePageProps<T> {\n  /** Resource name — used for view-preference storage key. */\n  resource?: string;\n  /** The data to display (pre-fetched or from useResource). */\n  data: T[];\n  /** Total count of records (before client-side filtering). */\n  total: number;\n  /** Column definitions. Strings are expanded to `{ key, header, sortable }`. Omit to auto-generate from data keys. */\n  columns?: Array<string | ResourceColumnDef<T>>;\n  /** Status filter config. String = field name (options auto-derived). Object = explicit field + options. */\n  statusFilter?: string | { field: string; options?: string[] };\n  /** Fields to search across. Defaults to all string-valued fields in data. */\n  searchFields?: string[];\n  /** Initial filter params applied on mount. */\n  initialFilters?: FilterParam[];\n  /** Callback when filters change. */\n  onFiltersChange?: (filters: FilterParam[]) => void;\n  /** Default view mode. */\n  defaultView?: ViewMode;\n  /** Detail interaction mode. */\n  detail?: \"panel\" | \"modal\" | \"route\" | \"none\";\n  /** Field used for the detail title. Defaults to first column key. */\n  titleField?: string;\n  /** Field used for the detail subtitle. Defaults to second column key. */\n  subtitleField?: string;\n  /**\n   * Server-controlled mode. The `data` handed in has ALREADY been searched,\n   * sorted and paginated by the server, so this hook must not do any of it a\n   * second time — `data` is returned untouched and `total` is the server's\n   * `total` rather than the length of a client-filtered slice.\n   *\n   * Search / sort / status state is still tracked (the filter UI stays\n   * controlled and `onFiltersChange` still fires) — only the client-side\n   * transform of `data` is skipped. Defaults to `false`, so every existing\n   * caller keeps its current client-side behavior.\n   */\n  controlled?: boolean;\n}\n\nexport interface UseResourcePageReturn<T> {\n  /** Filtered and sorted data for display. */\n  data: T[];\n  /** Total count (of the filtered set; the server's `total` when `controlled`). */\n  total: number;\n  /** Resolved column definitions. */\n  columns: ResourceColumnDef<T>[];\n  /** Columns mapped to DataTable format. */\n  tableColumns: DataTableColumn<T>[];\n  /** Ready-to-spread filter config for DataFilters. */\n  filterConfig: {\n    search: string;\n    onSearchChange: (value: string) => void;\n    sort: string;\n    onSortChange: (sort: string) => void;\n    sortOptions: Array<{ value: string; label: string }>;\n    statusChips?: {\n      options: string[];\n      selected: string[];\n      onChange: (values: string[]) => void;\n    };\n  };\n  viewMode: ViewMode;\n  setViewMode: (mode: ViewMode) => void;\n  search: string;\n  setSearch: (value: string) => void;\n  sort: SortParam | null;\n  setSort: (sort: SortParam | null) => void;\n  statusValue: string[];\n  setStatusValue: (values: string[]) => void;\n  selectedItem: T | null;\n  setSelectedItem: (item: T | null) => void;\n  detailOpen: boolean;\n  setDetailOpen: (open: boolean) => void;\n  handleRowClick: (item: T) => void;\n  titleField: string;\n  subtitleField: string;\n  statusOptions: string[];\n  hasActiveFilters: boolean;\n  clearFilters: () => void;\n}\n\n// ---------------------------------------------------------------------------\n// Helpers\n// ---------------------------------------------------------------------------\n\n/**\n * Convert a key string to title case.\n *   \"created_at\" → \"Created At\"\n *   \"firstName\"  → \"First Name\"\n */\nexport function titleCase(str: string): string {\n  // Split on underscores, hyphens, and camelCase boundaries\n  const words = str\n    .replace(/([a-z])([A-Z])/g, \"$1 $2\") // camelCase → camel Case\n    .replace(/[_-]/g, \" \") // snake_case / kebab-case → spaces\n    .split(/\\s+/)\n    .filter(Boolean);\n\n  return words\n    .map((w) => w.charAt(0).toUpperCase() + w.slice(1).toLowerCase())\n    .join(\" \");\n}\n\n/**\n * Resolve column shorthand into full ResourceColumnDef objects.\n * - undefined + data present → auto-generate from Object.keys(data[0]), skip \"id\"\n * - undefined + empty data  → empty array\n * - string items            → { key, header: titleCase(key), sortable: true }\n * - object items            → defaults applied\n */\nfunction resolveColumns<T>(\n  columns: Array<string | ResourceColumnDef<T>> | undefined,\n  data: T[],\n): ResourceColumnDef<T>[] {\n  if (columns === undefined) {\n    if (data.length === 0) return [];\n    const keys = Object.keys(data[0] as Record<string, unknown>).filter(\n      (k) => k !== \"id\",\n    );\n    return keys.map((key) => ({\n      key,\n      header: titleCase(key),\n      sortable: true,\n    }));\n  }\n\n  return columns.map((col) => {\n    if (typeof col === \"string\") {\n      return { key: col, header: titleCase(col), sortable: true };\n    }\n    return {\n      ...col,\n      header: col.header ?? titleCase(col.key),\n      sortable: col.sortable ?? true,\n    };\n  });\n}\n\n/**\n * Derive the list of string fields in a data set (for default search).\n */\nfunction deriveStringFields<T>(data: T[]): string[] {\n  if (data.length === 0) return [];\n  const first = data[0] as Record<string, unknown>;\n  return Object.keys(first).filter((k) => typeof first[k] === \"string\");\n}\n\n/**\n * Derive unique status options from a data array.\n */\nfunction deriveStatusOptions<T>(data: T[], field: string): string[] {\n  const values = new Set<string>();\n  for (const item of data) {\n    const val = (item as Record<string, unknown>)[field];\n    if (val != null) values.add(String(val));\n  }\n  return Array.from(values).sort();\n}\n\n/**\n * Client-side text search across multiple fields.\n */\nfunction matchesSearch<T>(\n  item: T,\n  query: string,\n  fields: string[],\n): boolean {\n  if (!query) return true;\n  const lower = query.toLowerCase();\n  const record = item as Record<string, unknown>;\n  return fields.some((f) => {\n    const val = record[f];\n    return val != null && String(val).toLowerCase().includes(lower);\n  });\n}\n\n/**\n * Client-side sort comparator.\n */\nfunction compareItems<T>(a: T, b: T, sort: SortParam): number {\n  const ra = a as Record<string, unknown>;\n  const rb = b as Record<string, unknown>;\n  const va = ra[sort.field];\n  const vb = rb[sort.field];\n  const sa = va == null ? \"\" : String(va);\n  const sb = vb == null ? \"\" : String(vb);\n  const cmp = sa.localeCompare(sb, undefined, {\n    numeric: true,\n    sensitivity: \"base\",\n  });\n  return sort.order === \"asc\" ? cmp : -cmp;\n}\n\n// ---------------------------------------------------------------------------\n// Hook\n// ---------------------------------------------------------------------------\n\nexport function useResourcePage<T = Record<string, unknown>>(\n  props: UseResourcePageProps<T>,\n): UseResourcePageReturn<T> {\n  const {\n    resource,\n    data: rawData,\n    total: rawTotal,\n    columns: columnsProp,\n    statusFilter: statusFilterProp,\n    searchFields: searchFieldsProp,\n    defaultView = \"table\",\n    detail = \"panel\",\n    titleField: titleFieldProp,\n    subtitleField: subtitleFieldProp,\n    initialFilters,\n    onFiltersChange,\n    controlled = false,\n  } = props;\n\n  // -- View mode --\n  const [viewMode, setViewMode] = useViewPreference(\n    resource ?? \"resource-page\",\n    defaultView,\n  );\n\n  // -- Derive initial values from initialFilters --\n  const initialSearch = useMemo(() => {\n    if (!initialFilters) return \"\";\n    const searchFilter = initialFilters.find(\n      (f) => f.operator === \"contains\" && f.field === \"__search__\",\n    );\n    return searchFilter && \"value\" in searchFilter ? String(searchFilter.value ?? \"\") : \"\";\n  }, []); // eslint-disable-line react-hooks/exhaustive-deps -- only on mount\n\n  const initialSort = useMemo(() => {\n    if (!initialFilters) return null;\n    const sortFilter = initialFilters.find(\n      (f) => f.field === \"__sort__\",\n    );\n    if (!sortFilter || !(\"value\" in sortFilter) || typeof sortFilter.value !== \"string\") return null;\n    const [field, order] = sortFilter.value.split(\":\");\n    if (!field || (order !== \"asc\" && order !== \"desc\")) return null;\n    return { field, order } as SortParam;\n  }, []); // eslint-disable-line react-hooks/exhaustive-deps -- only on mount\n\n  const initialStatus = useMemo(() => {\n    if (!initialFilters) return [];\n    const statusFilter = initialFilters.find(\n      (f) => f.operator === \"in\" && f.field === \"__status__\",\n    );\n    if (!statusFilter || statusFilter.operator !== \"in\") return [];\n    return statusFilter.value.map((v) => String(v));\n  }, []); // eslint-disable-line react-hooks/exhaustive-deps -- only on mount\n\n  // -- Search --\n  const [search, setSearch] = useState(initialSearch);\n\n  // -- Sort --\n  const [sort, setSort] = useState<SortParam | null>(initialSort);\n\n  // -- Status filter --\n  const [statusValue, setStatusValue] = useState<string[]>(initialStatus);\n\n  // -- Detail panel --\n  const [selectedItem, setSelectedItem] = useState<T | null>(null);\n  const [detailOpen, setDetailOpen] = useState(false);\n\n  // -- Resolve columns --\n  const resolvedColumns = useMemo(\n    () => resolveColumns(columnsProp, rawData),\n    [columnsProp, rawData],\n  );\n\n  // -- Title / subtitle fields --\n  const titleField =\n    titleFieldProp ?? resolvedColumns[0]?.key ?? \"name\";\n  const subtitleField =\n    subtitleFieldProp ?? resolvedColumns[1]?.key ?? \"\";\n\n  // -- Status filter config --\n  const statusFieldName = useMemo(() => {\n    if (!statusFilterProp) return null;\n    return typeof statusFilterProp === \"string\"\n      ? statusFilterProp\n      : statusFilterProp.field;\n  }, [statusFilterProp]);\n\n  const statusOptions = useMemo(() => {\n    if (!statusFilterProp) return [];\n    if (typeof statusFilterProp === \"object\" && statusFilterProp.options) {\n      return statusFilterProp.options;\n    }\n    if (!statusFieldName) return [];\n    return deriveStatusOptions(rawData, statusFieldName);\n  }, [statusFilterProp, statusFieldName, rawData]);\n\n  // -- Search fields --\n  const searchFields = useMemo(\n    () => searchFieldsProp ?? deriveStringFields(rawData),\n    [searchFieldsProp, rawData],\n  );\n\n  // -- Client-side filtering + sorting --\n  // Skipped entirely in controlled mode: the server already applied the\n  // search, the sort and the page window, so re-running them here would\n  // filter the current page against a query the server has already honoured\n  // (and re-sort a slice of rows that is not the full result set).\n  const filteredData = useMemo(() => {\n    if (controlled) return rawData;\n\n    let result = rawData;\n\n    // Text search\n    if (search) {\n      result = result.filter((item) =>\n        matchesSearch(item, search, searchFields),\n      );\n    }\n\n    // Status filter\n    if (statusFieldName && statusValue.length > 0) {\n      result = result.filter((item) => {\n        const val = (item as Record<string, unknown>)[statusFieldName];\n        return val != null && statusValue.includes(String(val));\n      });\n    }\n\n    // Sort\n    if (sort) {\n      result = [...result].sort((a, b) => compareItems(a, b, sort));\n    }\n\n    return result;\n  }, [controlled, rawData, search, searchFields, statusFieldName, statusValue, sort]);\n\n  // -- Sort options (built from resolved columns) --\n  const sortOptions = useMemo(() => {\n    const opts: Array<{ value: string; label: string }> = [];\n    for (const col of resolvedColumns) {\n      if (col.sortable !== false) {\n        opts.push({\n          value: `${col.key}:asc`,\n          label: `${col.header ?? titleCase(col.key)} (A-Z)`,\n        });\n        opts.push({\n          value: `${col.key}:desc`,\n          label: `${col.header ?? titleCase(col.key)} (Z-A)`,\n        });\n      }\n    }\n    return opts;\n  }, [resolvedColumns]);\n\n  // -- Sort string for DataFilters select --\n  const sortString = sort ? `${sort.field}:${sort.order}` : \"\";\n\n  const handleSortChange = useCallback((value: string) => {\n    if (!value) {\n      setSort(null);\n      return;\n    }\n    const [field, order] = value.split(\":\");\n    setSort({ field, order: order as \"asc\" | \"desc\" });\n  }, []);\n\n  // -- Map to DataTableColumn --\n  const tableColumns: DataTableColumn<T>[] = useMemo(\n    () =>\n      resolvedColumns.map((col) => ({\n        key: col.key,\n        header: col.header ?? titleCase(col.key),\n        sortable: col.sortable ?? true,\n        hideBelow: col.hideBelow,\n        render: col.render\n          ? (item: T, value: unknown) =>\n              col.render!(item, value, {\n                update: async () => {\n                  throw new Error(\n                    \"ResourceActions.update not available in server-data mode\",\n                  );\n                },\n                remove: async () => {\n                  throw new Error(\n                    \"ResourceActions.remove not available in server-data mode\",\n                  );\n                },\n                refetch: () => {\n                  /* no-op in server-data mode */\n                },\n              })\n          : undefined,\n      })),\n    [resolvedColumns],\n  );\n\n  // -- Active filters check --\n  const hasActiveFilters =\n    search !== \"\" || statusValue.length > 0 || sort !== null;\n\n  const clearFilters = useCallback(() => {\n    setSearch(\"\");\n    setStatusValue([]);\n    setSort(null);\n  }, []);\n\n  // -- Notify parent of filter changes --\n  const onFiltersChangeRef = useRef(onFiltersChange);\n  onFiltersChangeRef.current = onFiltersChange;\n\n  useEffect(() => {\n    if (!onFiltersChangeRef.current) return;\n    const filters: FilterParam[] = [];\n    if (search) {\n      filters.push({ field: \"__search__\", operator: \"contains\", value: search });\n    }\n    if (sort) {\n      filters.push({ field: \"__sort__\", operator: \"eq\", value: `${sort.field}:${sort.order}` });\n    }\n    if (statusValue.length > 0) {\n      filters.push({ field: \"__status__\", operator: \"in\", value: statusValue });\n    }\n    onFiltersChangeRef.current(filters);\n  }, [search, sort, statusValue]);\n\n  // -- Row click --\n  const handleRowClick = useCallback(\n    (item: T) => {\n      if (detail === \"none\") return;\n      setSelectedItem(item);\n      setDetailOpen(true);\n    },\n    [detail],\n  );\n\n  // -- Filter config (ready to spread into DataFilters) --\n  const filterConfig = useMemo(\n    () => ({\n      search,\n      onSearchChange: setSearch,\n      sort: sortString,\n      onSortChange: handleSortChange,\n      sortOptions,\n      ...(statusFieldName && statusOptions.length > 0\n        ? {\n            statusChips: {\n              options: statusOptions,\n              selected: statusValue,\n              onChange: setStatusValue,\n            },\n          }\n        : {}),\n    }),\n    [\n      search,\n      sortString,\n      handleSortChange,\n      sortOptions,\n      statusFieldName,\n      statusOptions,\n      statusValue,\n    ],\n  );\n\n  return {\n    data: filteredData,\n    // Controlled mode: `filteredData` is one server page, so its length is\n    // not the record count — the server's total is.\n    total: controlled ? rawTotal : filteredData.length,\n    columns: resolvedColumns,\n    tableColumns,\n    filterConfig,\n    viewMode,\n    setViewMode,\n    search,\n    setSearch,\n    sort,\n    setSort,\n    statusValue,\n    setStatusValue,\n    selectedItem,\n    setSelectedItem,\n    detailOpen,\n    setDetailOpen,\n    handleRowClick,\n    titleField,\n    subtitleField,\n    statusOptions,\n    hasActiveFilters,\n    clearFilters,\n  };\n}\n"]}

package/dist/components/data/index.d.ts

@@ -1,21 +1,20 @@
-import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as React from 'react';
 import { ReactNode, RefObject } from 'react';
-import { c as PageHeaderOptions, A as AppShell$1, P as PageHeader$1 } from '../../AppShell-BJarYZzz.js';
-export { a as AppShellOptions, b as AppShellProps, N as NavItem, d as PageHeaderProps } from '../../AppShell-BJarYZzz.js';
-import { V as ViewMode } from '../../view-toggle-DDe_Luj2.js';
-export { a as ViewToggle } from '../../view-toggle-DDe_Luj2.js';
+import { c as PageHeaderOptions, A as AppShell$1, P as PageHeader$1 } from '../../AppShell-sQT0UbXg.js';
+export { a as AppShellOptions, b as AppShellProps, N as NavItem, d as PageHeaderProps } from '../../AppShell-sQT0UbXg.js';
+import { V as ViewMode } from '../../view-toggle-CahQ87PW.js';
+export { a as ViewToggle } from '../../view-toggle-CahQ87PW.js';
 import { LucideIcon } from 'lucide-react';
 import { Density } from '../../hooks/use-view-settings.js';
-import { R as ResourceActions, a as ResourceColumnDef } from '../../use-resource-page-CPs6wjKt.js';
-export { D as DataTable, c as DataTableColumn, d as DataTableProps, L as LinkCell, T as ThumbnailCell } from '../../use-resource-page-CPs6wjKt.js';
+import { R as ResourceActions, a as ResourceColumnDef } from '../../use-resource-page-DTQS011Q.js';
+export { D as DataTable, c as DataTableColumn, d as DataTableProps, L as LinkCell, T as ThumbnailCell } from '../../use-resource-page-DTQS011Q.js';
 export { EmptyState } from '../patterns/empty-state.js';
-export { V as ViewSettings } from '../../view-settings--KXNT_jE.js';
+export { V as ViewSettings } from '../../view-settings-kHKCHMjj.js';
 import { L as LinkComponent, N as NavigateFn } from '../../navigation-CpOEyUSb.js';
 export { D as DefaultLink, G as GenesisLinkProps, d as defaultNavigate, i as isPathActive } from '../../navigation-CpOEyUSb.js';
 import { UseFormReturn, Control, FieldErrors } from 'react-hook-form';
 import { WizardStep, UseResourceOptions } from '@marktiderman/genesis-core/hooks';
-import { FilterParam, BaseRecord, Identifier } from '@marktiderman/genesis-core/provider';
+import { FilterParam, SortParam, BaseRecord, Identifier } from '@marktiderman/genesis-core/provider';
 import { ResourceFormFieldDef } from '@marktiderman/genesis-core';
 export { FieldType, ResourceFormFieldDef, SelectOption } from '@marktiderman/genesis-core';
 export { CommandPalette, CommandPaletteItem, CommandPaletteProps, useCommandPaletteHotkey } from '../ui/command-palette.js';
@@ -74,7 +73,7 @@ interface DataPageShellProps {
     headerOptionsStorageKey?: string;
     children: ReactNode;
 }
-declare function DataPageShell({ title, icon, entityName, subtitle, createAction, isLoading, isEmpty, emptyIcon, emptyMessage, emptyAction, hasError, errorMessage, onRetry, count, totalCount, viewMode, onViewModeChange, pageSize, onPageSizeChange, density, onDensityChange, filters, hasActiveFilters, onClearFilters, filtersCollapsible, defaultFiltersOpen, filtersOpen, onFiltersOpenChange, filtersLabel, filtersHint, headerOptions, headerOptionsStorageKey, children, }: DataPageShellProps): react_jsx_runtime.JSX.Element;
+declare function DataPageShell({ title, icon, entityName, subtitle, createAction, isLoading, isEmpty, emptyIcon, emptyMessage, emptyAction, hasError, errorMessage, onRetry, count, totalCount, viewMode, onViewModeChange, pageSize, onPageSizeChange, density, onDensityChange, filters, hasActiveFilters, onClearFilters, filtersCollapsible, defaultFiltersOpen, filtersOpen, onFiltersOpenChange, filtersLabel, filtersHint, headerOptions, headerOptionsStorageKey, children, }: DataPageShellProps): React.JSX.Element;
 
 interface FilterOption {
     value: string;
@@ -92,7 +91,7 @@ interface FilterComboboxProps {
     /** Optional map of value -> display label */
     labelMap?: Record<string, string>;
 }
-declare function FilterCombobox({ label, icon: Icon, options, selected, onChange, searchPlaceholder, allLabel, labelMap, }: FilterComboboxProps): react_jsx_runtime.JSX.Element;
+declare function FilterCombobox({ label, icon: Icon, options, selected, onChange, searchPlaceholder, allLabel, labelMap, }: FilterComboboxProps): React.JSX.Element;
 
 interface DataFilterConfig {
     key: string;
@@ -142,7 +141,7 @@ interface DataFiltersProps {
     /** Expose the search input ref for keyboard nav "/" shortcut */
     searchInputRef?: React.RefObject<HTMLInputElement | null>;
 }
-declare function DataFilters({ search, onSearchChange, searchPlaceholder, sort, onSortChange, sortOptions, filters, statusChips, savedViews, onLoadView, onSaveView, onDeleteView, canSaveViews, onViewSaved, onClearAll, searchInputRef, }: DataFiltersProps): react_jsx_runtime.JSX.Element;
+declare function DataFilters({ search, onSearchChange, searchPlaceholder, sort, onSortChange, sortOptions, filters, statusChips, savedViews, onLoadView, onSaveView, onDeleteView, canSaveViews, onViewSaved, onClearAll, searchInputRef, }: DataFiltersProps): React.JSX.Element;
 
 interface DataGridProps<T> {
     items: T[];
@@ -166,7 +165,7 @@ interface DataGridProps<T> {
     /** Keyboard navigation: container ref for scroll management */
     keyboardContainerRef?: RefObject<HTMLDivElement | null>;
 }
-declare function DataGrid<T>({ items, viewMode, batchSize, gridCols, renderCard, renderTable, renderListItem, staggerAnimation, getKey, focusedIndex, keyboardContainerRef, }: DataGridProps<T>): react_jsx_runtime.JSX.Element;
+declare function DataGrid<T>({ items, viewMode, batchSize, gridCols, renderCard, renderTable, renderListItem, staggerAnimation, getKey, focusedIndex, keyboardContainerRef, }: DataGridProps<T>): React.JSX.Element;
 
 interface BulkAction {
     label: string;
@@ -181,7 +180,7 @@ interface DataBulkBarProps {
     onClearSelection: () => void;
     actions: BulkAction[];
 }
-declare function DataBulkBar({ selected, totalCount, onToggleAll, onClearSelection, actions, }: DataBulkBarProps): react_jsx_runtime.JSX.Element | null;
+declare function DataBulkBar({ selected, totalCount, onToggleAll, onClearSelection, actions, }: DataBulkBarProps): React.JSX.Element | null;
 
 /**
  * DateCell -- shows relative date by default, formatted date otherwise.
@@ -202,7 +201,7 @@ declare function CurrencyCell(currency?: string, locale?: string): (_item: unkno
 /**
  * BadgeCell -- status badge with configurable color map.
  */
-declare function BadgeCell(colorMap?: Record<string, "default" | "secondary" | "destructive" | "outline" | "success" | "warning" | "info" | "muted">): (_item: unknown, value: unknown) => react_jsx_runtime.JSX.Element | "—";
+declare function BadgeCell(colorMap?: Record<string, "default" | "secondary" | "destructive" | "outline" | "success" | "warning" | "info" | "muted">): (_item: unknown, value: unknown) => React.JSX.Element | "—";
 
 type StatCardColor = "primary" | "success" | "warning" | "info" | "destructive" | "muted";
 interface StatCardProps {
@@ -224,7 +223,7 @@ interface StatCardProps {
     };
     className?: string;
 }
-declare function StatCard({ label, value, icon: Icon, color, href, linkComponent: Link, trend, className, }: StatCardProps): react_jsx_runtime.JSX.Element;
+declare function StatCard({ label, value, icon: Icon, color, href, linkComponent: Link, trend, className, }: StatCardProps): React.JSX.Element;
 
 type ColumnStatus = "neutral" | "warning" | "success" | "info" | "destructive" | "primary";
 interface KanbanColumn<T> {
@@ -244,7 +243,7 @@ interface KanbanBoardProps<T> {
     emptyMessage?: string;
     className?: string;
 }
-declare function KanbanBoard<T>({ columns, renderCard, emptyMessage, className, }: KanbanBoardProps<T>): react_jsx_runtime.JSX.Element;
+declare function KanbanBoard<T>({ columns, renderCard, emptyMessage, className, }: KanbanBoardProps<T>): React.JSX.Element;
 
 interface DataListProps<T> {
     items: T[];
@@ -252,7 +251,7 @@ interface DataListProps<T> {
     emptyMessage?: string;
     className?: string;
 }
-declare function DataList<T>({ items, renderItem, emptyMessage, className, }: DataListProps<T>): react_jsx_runtime.JSX.Element;
+declare function DataList<T>({ items, renderItem, emptyMessage, className, }: DataListProps<T>): React.JSX.Element;
 
 /**
  * Props for {@link DetailPanel} — a shell-agnostic record detail view.
@@ -305,7 +304,7 @@ interface DetailPanelProps<T> {
      */
     layout?: "inline" | "dialog" | "sheet";
 }
-declare function DetailPanel<T extends Record<string, unknown>>({ item, open, onClose, title, subtitle, onEdit, onDelete, children, fields, width, layout, }: DetailPanelProps<T>): react_jsx_runtime.JSX.Element | null;
+declare function DetailPanel<T extends Record<string, unknown>>({ item, open, onClose, title, subtitle, onEdit, onDelete, children, fields, width, layout, }: DetailPanelProps<T>): React.JSX.Element | null;
 
 /**
  * Row-bound actions handed to `renderCard`, on top of the resource-wide
@@ -333,6 +332,26 @@ interface ResourceCardActions<T> extends ResourceActions<T> {
  * data-fetching, filtering, and layout; see also the built-in
  * `useKeyboardNavigation` wiring (`keyboardNavigation` prop) and `gridCols`.
  *
+ * Three levels of control, and each option is available at all three:
+ *
+ * 1. **The primitive offers it** — table / grid / list views, search, sort,
+ *    status chips, column visibility and resizing, density, page size,
+ *    detail panel / modal / route, built-in create and edit forms.
+ * 2. **The instance turns it on or off** — every one of those is a prop, so
+ *    a given page decides which affordances it offers at all.
+ * 3. **The end user picks their own, and it sticks** — for the options left
+ *    on at level 2, the user's choice persists to their own storage:
+ *    `viewSettingsKey` for page size and density, `columnVisibilityKey` and
+ *    `resizeKey` for column layout, `savedViews` (pair with `useSavedViews`)
+ *    for named filter sets. Persistence needs a key; without one the choice
+ *    lasts only for the session.
+ *
+ * A server-paginated list drives the same component through the controlled
+ * props (`page`, `perPage`, `onPageChange`, `onSortChange`, `onSearchChange`
+ * and friends) — supplying any of them stops ResourcePage from searching,
+ * sorting or paging the `data` a second time. See that block in
+ * {@link ResourcePageProps}.
+ *
  * @stability Beta
  */
 interface ResourcePageProps<T extends Record<string, unknown> = Record<string, unknown>> {
@@ -340,7 +359,17 @@ interface ResourcePageProps<T extends Record<string, unknown> = Record<string, u
     resource?: string;
     /** Server-data mode: pre-fetched data array. */
     data?: T[];
-    /** Server-data mode: total record count (before client-side filtering). */
+    /**
+     * Server-data mode: total record count (before client-side filtering).
+     *
+     * Required whenever `onPageChange` is supplied. It cannot be derived from
+     * `data`, which holds only the current page. Omitted, `displayTotal` falls
+     * back to `0`, so the range span reads "No records" and `Next` stays
+     * disabled while the rows render directly below it. Rather than show a
+     * pager that contradicts the list, the component refuses to render the
+     * pager and shows an error instead. See {@link perPage} and
+     * {@link onPageChange}.
+     */
     total?: number;
     title: string;
     /** Page subtitle shown below the title. */
@@ -358,6 +387,16 @@ interface ResourcePageProps<T extends Record<string, unknown> = Record<string, u
         label: string;
         render?: (value: unknown, item: T) => ReactNode;
     }>;
+    /**
+     * Adds a status-chip filter. There is no dedicated status-change
+     * callback: chip clicks update the same filter state that already
+     * reports through `onFiltersChange`, whether or not the page is in
+     * server-controlled mode. A caller combining `statusFilter` with server
+     * pagination (`onPageChange` et al.) must supply `onFiltersChange` — see
+     * that prop — or status changes will update the chip UI without ever
+     * reaching the server. In server-controlled mode a status change also
+     * resets to page 1 via `onPageChange(1)` — see {@link onPageChange}.
+     */
     statusFilter?: string | {
         field: string;
         options?: string[];
@@ -366,6 +405,74 @@ interface ResourcePageProps<T extends Record<string, unknown> = Record<string, u
     searchPlaceholder?: string;
     initialFilters?: FilterParam[];
     onFiltersChange?: (filters: FilterParam[]) => void;
+    /** Current page, 1-based. Server-controlled mode only. */
+    page?: number;
+    /**
+     * Rows per page the server was asked for. Required whenever
+     * `onPageChange` is supplied: pager math (total pages, range start, Next)
+     * cannot be inferred from `data.length`, because a short final page is
+     * smaller than the real page size. Wins over the per-user page size
+     * persisted by `viewSettingsKey` — an explicit prop always beats a stored
+     * preference.
+     *
+     * Required whenever `onPageChange` is supplied. A short final page (the
+     * server's last page returning fewer rows than its page size) is
+     * indistinguishable from a small page size — there is no correct way to
+     * infer the divisor from the rows handed back. Rather than guess and
+     * render a wrong range or a stuck Next button, the component refuses to
+     * render the pager and shows an error instead when `onPageChange` is
+     * present without `perPage`.
+     *
+     * `total` is required on the same terms — see {@link total}. The error
+     * names every missing prop, not just the first.
+     */
+    perPage?: number;
+    /**
+     * Called with the next 1-based page number. The pager only renders when
+     * this is supplied AND both `perPage` and `total` are supplied — see
+     * {@link perPage} and {@link total}. Supplying this without either one
+     * renders an error naming the missing props instead of a pager.
+     *
+     * Status changes reach the server through `onFiltersChange` — not a
+     * dedicated callback here — because `statusFilter` state is tracked by
+     * the same filter machinery that already calls `onFiltersChange`
+     * regardless of controlled mode (see {@link statusFilter}). In
+     * server-controlled mode a status change also calls `onPageChange(1)`
+     * directly, since the previous page number is meaningless against a new
+     * filtered result set.
+     */
+    onPageChange?: (page: number) => void;
+    /** Called when the user picks a different page size in the header's view settings. */
+    onPerPageChange?: (perPage: number) => void;
+    /** Called when the user changes the sort, with `null` when the sort is cleared. */
+    onSortChange?: (sort: SortParam | null) => void;
+    /** Called when the user changes the search text (including clearing it). */
+    onSearchChange?: (search: string) => void;
+    /** Saved filter views to offer. Pair with `useSavedViews` for per-user storage. */
+    savedViews?: SavedViewItem[];
+    onLoadView?: (filters: Record<string, unknown>) => void;
+    onSaveView?: (name: string) => void;
+    onDeleteView?: (id: string) => void;
+    /** Show the "save current view" affordance. */
+    canSaveViews?: boolean;
+    /** Show the column-visibility dropdown. DataTable's default is `true`. */
+    columnVisibility?: boolean;
+    /** Persist key for the user's column-visibility picks. */
+    columnVisibilityKey?: string;
+    /** Allow drag-resizing columns. DataTable's default is `true`. */
+    resizableColumns?: boolean;
+    /** Persist key for the user's column widths. */
+    resizeKey?: string;
+    /** Keep the table header visible while scrolling. DataTable's default is `true`. */
+    stickyHeader?: boolean;
+    /** Keep the first column visible while scrolling horizontally. */
+    stickyFirstColumn?: boolean;
+    /**
+     * Page-size choices offered by `DataTable`'s own pager. Client-side mode
+     * only — server-controlled mode switches that pager off. (The header's
+     * view-settings popover has its own fixed 10/25/50/100 list.)
+     */
+    pageSizeOptions?: number[];
     onCreate?: () => void;
     onEdit?: (item: T) => void;
     onDelete?: (item: T) => void;
@@ -447,7 +554,7 @@ interface ResourcePageProps<T extends Record<string, unknown> = Record<string, u
      */
     viewSettingsKey?: string;
 }
-declare function ResourcePage<T extends Record<string, unknown> = Record<string, unknown>>(props: ResourcePageProps<T>): react_jsx_runtime.JSX.Element;
+declare function ResourcePage<T extends Record<string, unknown> = Record<string, unknown>>(props: ResourcePageProps<T>): React.JSX.Element;
 
 interface ResourceDetailPageProps<T extends BaseRecord = BaseRecord> {
     /** Resource name, resolved through the mounted `DataProvider`. */
@@ -526,7 +633,7 @@ interface ResourceDetailPageProps<T extends BaseRecord = BaseRecord> {
  *
  * @stability Beta
  */
-declare function ResourceDetailPage<T extends BaseRecord = BaseRecord>({ resource, id, titleField, subtitleField, select, breadcrumb, actions, sidebar, children, className, testID, }: ResourceDetailPageProps<T>): react_jsx_runtime.JSX.Element;
+declare function ResourceDetailPage<T extends BaseRecord = BaseRecord>({ resource, id, titleField, subtitleField, select, breadcrumb, actions, sidebar, children, className, testID, }: ResourceDetailPageProps<T>): React.JSX.Element;
 
 interface ResourceFormProps {
     resource: string;
@@ -550,7 +657,7 @@ interface ResourceFormProps {
     /** Number of columns for the form layout. Default 1. */
     columns?: 1 | 2;
 }
-declare function ResourceForm(props: ResourceFormProps): react_jsx_runtime.JSX.Element | null;
+declare function ResourceForm(props: ResourceFormProps): React.JSX.Element | null;
 
 interface RelationFieldProps {
     field: ResourceFormFieldDef;
@@ -558,7 +665,7 @@ interface RelationFieldProps {
     onChange: (value: string) => void;
     disabled?: boolean;
 }
-declare function RelationField({ field, value, onChange, disabled, }: RelationFieldProps): react_jsx_runtime.JSX.Element;
+declare function RelationField({ field, value, onChange, disabled, }: RelationFieldProps): React.JSX.Element;
 
 interface FileUploadFieldProps {
     field: ResourceFormFieldDef;
@@ -566,14 +673,14 @@ interface FileUploadFieldProps {
     onChange: (value: File | File[] | null) => void;
     disabled?: boolean;
 }
-declare function FileUploadField({ field, value, onChange, disabled, }: FileUploadFieldProps): react_jsx_runtime.JSX.Element;
+declare function FileUploadField({ field, value, onChange, disabled, }: FileUploadFieldProps): React.JSX.Element;
 
 declare function FieldArrayRenderer({ field, control, action, watchedValues, }: {
     field: ResourceFormFieldDef;
     control: Control<Record<string, unknown>>;
     action: "create" | "edit";
     watchedValues?: Record<string, unknown>;
-}): react_jsx_runtime.JSX.Element;
+}): React.JSX.Element;
 
 interface WizardFormProps {
     steps: WizardStep[];
@@ -585,7 +692,7 @@ interface WizardFormProps {
     action: "create" | "edit";
     onInvalid?: (errors: FieldErrors) => void;
 }
-declare function WizardForm({ steps, form, fields, onSubmit, isSaving, renderField, action, onInvalid, }: WizardFormProps): react_jsx_runtime.JSX.Element;
+declare function WizardForm({ steps, form, fields, onSubmit, isSaving, renderField, action, onInvalid, }: WizardFormProps): React.JSX.Element;
 
 /**
  * @deprecated Import `AppShell` from `@marktiderman/genesis-ui/layout` instead.