@marktiderman/genesis-ui 1.2.0 → 2.0.0

package/dist/{chunk-TKA4LOMT.js → chunk-ZZ7H7VVX.js}

@@ -1,13 +1,13 @@
 "use client";
 import { cn } from './chunk-NZ5WBA4R.js';
 import * as React from 'react';
-import * as RadioGroupPrimitive from '@radix-ui/react-radio-group';
+import { RadioGroup as RadioGroup$1 } from 'radix-ui';
 import { Circle } from 'lucide-react';
 import { jsx } from 'react/jsx-runtime';
 
 var RadioGroup = React.forwardRef(({ className, ...props }, ref) => {
   return /* @__PURE__ */ jsx(
-    RadioGroupPrimitive.Root,
+    RadioGroup$1.Root,
     {
       className: cn("grid gap-2", className),
       ...props,
@@ -15,10 +15,10 @@ var RadioGroup = React.forwardRef(({ className, ...props }, ref) => {
     }
   );
 });
-RadioGroup.displayName = RadioGroupPrimitive.Root.displayName;
+RadioGroup.displayName = RadioGroup$1.Root.displayName;
 var RadioGroupItem = React.forwardRef(({ className, ...props }, ref) => {
   return /* @__PURE__ */ jsx(
-    RadioGroupPrimitive.Item,
+    RadioGroup$1.Item,
     {
       ref,
       className: cn(
@@ -26,12 +26,12 @@ var RadioGroupItem = React.forwardRef(({ className, ...props }, ref) => {
         className
       ),
       ...props,
-      children: /* @__PURE__ */ jsx(RadioGroupPrimitive.Indicator, { className: "flex items-center justify-center", children: /* @__PURE__ */ jsx(Circle, { className: "h-2.5 w-2.5 fill-current text-current" }) })
+      children: /* @__PURE__ */ jsx(RadioGroup$1.Indicator, { className: "flex items-center justify-center", children: /* @__PURE__ */ jsx(Circle, { className: "h-2.5 w-2.5 fill-current text-current" }) })
     }
   );
 });
-RadioGroupItem.displayName = RadioGroupPrimitive.Item.displayName;
+RadioGroupItem.displayName = RadioGroup$1.Item.displayName;
 
 export { RadioGroup, RadioGroupItem };
-//# sourceMappingURL=chunk-TKA4LOMT.js.map
-//# sourceMappingURL=chunk-TKA4LOMT.js.map
+//# sourceMappingURL=chunk-ZZ7H7VVX.js.map
+//# sourceMappingURL=chunk-ZZ7H7VVX.js.map

package/dist/chunk-ZZ7H7VVX.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/components/ui/radio-group.tsx"],"names":["RadioGroupPrimitive"],"mappings":";;;;;;AAOA,IAAM,UAAA,GAAmB,iBAGvB,CAAC,EAAE,WAAW,GAAG,KAAA,IAAS,GAAA,KAAQ;AAClC,EAAA,uBACE,GAAA;AAAA,IAACA,YAAA,CAAoB,IAAA;AAAA,IAApB;AAAA,MACC,SAAA,EAAW,EAAA,CAAG,YAAA,EAAc,SAAS,CAAA;AAAA,MACpC,GAAG,KAAA;AAAA,MACJ;AAAA;AAAA,GACF;AAEJ,CAAC;AACD,UAAA,CAAW,WAAA,GAAcA,aAAoB,IAAA,CAAK,WAAA;AAElD,IAAM,cAAA,GAAuB,iBAG3B,CAAC,EAAE,WAAW,GAAG,KAAA,IAAS,GAAA,KAAQ;AAClC,EAAA,uBACE,GAAA;AAAA,IAACA,YAAA,CAAoB,IAAA;AAAA,IAApB;AAAA,MACC,GAAA;AAAA,MACA,SAAA,EAAW,EAAA;AAAA,QACT,0OAAA;AAAA,QACA;AAAA,OACF;AAAA,MACC,GAAG,KAAA;AAAA,MAEJ,QAAA,kBAAA,GAAA,CAACA,YAAA,CAAoB,SAAA,EAApB,EAA8B,SAAA,EAAU,oCACvC,QAAA,kBAAA,GAAA,CAAC,MAAA,EAAA,EAAO,SAAA,EAAU,uCAAA,EAAwC,CAAA,EAC5D;AAAA;AAAA,GACF;AAEJ,CAAC;AACD,cAAA,CAAe,WAAA,GAAcA,aAAoB,IAAA,CAAK,WAAA","file":"chunk-ZZ7H7VVX.js","sourcesContent":["\"use client\";\n\nimport * as React from \"react\";\nimport { RadioGroup as RadioGroupPrimitive } from \"radix-ui\";\nimport { Circle } from \"lucide-react\";\nimport { cn } from \"../../utils\";\n\nconst RadioGroup = React.forwardRef<\n  React.ComponentRef<typeof RadioGroupPrimitive.Root>,\n  React.ComponentPropsWithoutRef<typeof RadioGroupPrimitive.Root>\n>(({ className, ...props }, ref) => {\n  return (\n    <RadioGroupPrimitive.Root\n      className={cn(\"grid gap-2\", className)}\n      {...props}\n      ref={ref}\n    />\n  );\n});\nRadioGroup.displayName = RadioGroupPrimitive.Root.displayName;\n\nconst RadioGroupItem = React.forwardRef<\n  React.ComponentRef<typeof RadioGroupPrimitive.Item>,\n  React.ComponentPropsWithoutRef<typeof RadioGroupPrimitive.Item>\n>(({ className, ...props }, ref) => {\n  return (\n    <RadioGroupPrimitive.Item\n      ref={ref}\n      className={cn(\n        \"aspect-square h-4 w-4 rounded-full border border-primary text-primary ring-offset-background focus:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2 disabled:cursor-not-allowed disabled:opacity-50\",\n        className,\n      )}\n      {...props}\n    >\n      <RadioGroupPrimitive.Indicator className=\"flex items-center justify-center\">\n        <Circle className=\"h-2.5 w-2.5 fill-current text-current\" />\n      </RadioGroupPrimitive.Indicator>\n    </RadioGroupPrimitive.Item>\n  );\n});\nRadioGroupItem.displayName = RadioGroupPrimitive.Item.displayName;\n\nexport { RadioGroup, RadioGroupItem };\n"]}

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

@@ -1,19 +1,25 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as React from 'react';
 import { ReactNode, RefObject } from 'react';
-import { V as ViewMode } from '../../ViewToggle-DDe_Luj2.js';
-export { a as ViewToggle } from '../../ViewToggle-DDe_Luj2.js';
+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 { LucideIcon } from 'lucide-react';
 import { Density } from '../../hooks/use-view-settings.js';
-import { a as ResourceColumnDef } from '../../use-resource-page-B-CFcikK.js';
-export { D as DataTable, c as DataTableColumn, d as DataTableProps, L as LinkCell, R as ResourceActions, T as ThumbnailCell } from '../../use-resource-page-B-CFcikK.js';
-import { L as LinkComponent, N as NavigateFn } from '../../navigation-qI86Ldug.js';
-export { D as DefaultLink, G as GenesisLinkProps, d as defaultNavigate, i as isPathActive } from '../../navigation-qI86Ldug.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';
+export { EmptyState } from '../patterns/empty-state.js';
+export { V as ViewSettings } from '../../view-settings--KXNT_jE.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 } from '@marktiderman/genesis-core/provider';
+import { FilterParam, 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';
+export { UseSavedViewsReturn, useSavedViews } from '../../hooks/use-saved-views.js';
 
 interface DataPageShellProps {
     /** Display title for the page */
@@ -49,9 +55,26 @@ interface DataPageShellProps {
     /** Whether filters are currently active */
     hasActiveFilters?: boolean;
     onClearFilters?: () => void;
+    /**
+     * When true, filters render inside PageHeader details (collapsed by default).
+     * Default false preserves always-visible filters on existing boards.
+     */
+    filtersCollapsible?: boolean;
+    defaultFiltersOpen?: boolean;
+    filtersOpen?: boolean;
+    onFiltersOpenChange?: (open: boolean) => void;
+    filtersLabel?: string;
+    filtersHint?: ReactNode;
+    /**
+     * PageHeader chrome config — developer defaults; users can further
+     * customize via the in-header Header options menu.
+     */
+    headerOptions?: PageHeaderOptions;
+    /** Persist user header-option overrides (localStorage) */
+    headerOptionsStorageKey?: string;
     children: ReactNode;
 }
-declare function DataPageShell({ title, icon: Icon, entityName, subtitle, createAction, isLoading, isEmpty, emptyIcon, emptyMessage, emptyAction, hasError, errorMessage, onRetry, count, totalCount, viewMode, onViewModeChange, pageSize, onPageSizeChange, density, onDensityChange, filters, hasActiveFilters, onClearFilters, 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_runtime.JSX.Element;
 
 interface FilterOption {
     value: string;
@@ -181,24 +204,6 @@ declare function CurrencyCell(currency?: string, locale?: string): (_item: unkno
  */
 declare function BadgeCell(colorMap?: Record<string, "default" | "secondary" | "destructive" | "outline" | "success" | "warning" | "info" | "muted">): (_item: unknown, value: unknown) => react_jsx_runtime.JSX.Element | "—";
 
-interface EmptyStateProps {
-    icon?: LucideIcon;
-    message?: string;
-    action?: ReactNode;
-    /** If true, shows a "no results" message with clear button */
-    hasFilters?: boolean;
-    onClearFilters?: () => void;
-}
-declare function EmptyState({ icon: Icon, message, action, hasFilters, onClearFilters, }: EmptyStateProps): react_jsx_runtime.JSX.Element;
-
-interface ViewSettingsProps {
-    pageSize: number;
-    onPageSizeChange: (size: number) => void;
-    density: Density;
-    onDensityChange: (density: Density) => void;
-}
-declare function ViewSettings({ pageSize, onPageSizeChange, density, onDensityChange, }: ViewSettingsProps): react_jsx_runtime.JSX.Element;
-
 type StatCardColor = "primary" | "success" | "warning" | "info" | "destructive" | "muted";
 interface StatCardProps {
     label: string;
@@ -249,6 +254,13 @@ interface DataListProps<T> {
 }
 declare function DataList<T>({ items, renderItem, emptyMessage, className, }: DataListProps<T>): react_jsx_runtime.JSX.Element;
 
+/**
+ * Props for {@link DetailPanel} — a shell-agnostic record detail view.
+ * `layout` selects only the surrounding shell (inline / dialog / sheet);
+ * the header and content below it render identically across all three.
+ *
+ * @stability Beta
+ */
 interface DetailPanelProps<T> {
     /** The record to display */
     item: T | null;
@@ -272,11 +284,57 @@ interface DetailPanelProps<T> {
         label: string;
         render?: (value: unknown, item: T) => ReactNode;
     }>;
-    /** Panel width */
+    /**
+     * Panel width. For `"sheet"` / `"inline"` this is a fixed pixel width
+     * (matching this component's original, pre-`layout` sizing exactly). For
+     * `"dialog"` it maps to Tailwind's modal max-width scale instead, since a
+     * centered modal has a different sizing idiom than an edge-anchored panel.
+     */
     width?: "sm" | "md" | "lg";
+    /**
+     * Rendering shell for the header + content below.
+     * - `"sheet"` (default): fixed, right-anchored slide-in panel, composed
+     *   from the shared `Sheet` primitive. Matches this component's original
+     *   (pre-`layout`-prop) behavior — existing consumers that don't pass
+     *   `layout` see no change, other than an overlay now present at all
+     *   breakpoints (previously mobile-only) since it's a real `Sheet`.
+     * - `"dialog"`: centered modal overlay, composed from the shared `Dialog`
+     *   primitive.
+     * - `"inline"`: plain in-flow panel — no overlay, backdrop, or fixed
+     *   positioning — for master-detail / split-pane layouts.
+     */
+    layout?: "inline" | "dialog" | "sheet";
 }
-declare function DetailPanel<T extends Record<string, unknown>>({ item, open, onClose, title, subtitle, onEdit, onDelete, children, fields, width, }: 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_runtime.JSX.Element | null;
 
+/**
+ * Row-bound actions handed to `renderCard`, on top of the resource-wide
+ * `ResourceActions`. `open` is per-row, which is why it lives here rather
+ * than on `ResourceActions` — that object is built once and shared by every
+ * row and column, so it cannot carry a row-specific callback.
+ *
+ * @stability Beta
+ */
+interface ResourceCardActions<T> extends ResourceActions<T> {
+    /**
+     * Activate this row — opens the configured detail panel / modal / route,
+     * exactly as clicking the built-in card does. Wire it to your card's
+     * `onClick` (and call `stopPropagation` on any nested control that should
+     * not also activate the row).
+     */
+    open: () => void;
+}
+/**
+ * Config-driven resource page: wires data-fetching (or a pre-fetched `data`
+ * array), search/filter/sort, table/grid/list views, and a detail
+ * panel/modal/route around a `DataProvider` resource — the CRUD page most
+ * apps hand-roll, expressed as one component tree. `renderCard` lets a
+ * consumer fully own item presentation while ResourcePage keeps handling
+ * data-fetching, filtering, and layout; see also the built-in
+ * `useKeyboardNavigation` wiring (`keyboardNavigation` prop) and `gridCols`.
+ *
+ * @stability Beta
+ */
 interface ResourcePageProps<T extends Record<string, unknown> = Record<string, unknown>> {
     /** Client-side mode: resource name passed to useResource / DataProvider. */
     resource?: string;
@@ -332,6 +390,46 @@ interface ResourcePageProps<T extends Record<string, unknown> = Record<string, u
         variant?: "default" | "destructive";
         onAction: (ids: string[]) => void | Promise<void>;
     }>;
+    /**
+     * Override the default card renderer used for grid view (and, absent a
+     * dedicated list layout, list view too — DataGrid falls back to the same
+     * renderer there). ResourcePage still owns data-fetching, filtering,
+     * sorting, and layout (grid columns, infinite-scroll batching, stagger
+     * animation) — this only swaps what's rendered inside each item slot.
+     *
+     * Receives `ResourceCardActions`: the row's `update`/`remove`/`refetch`
+     * plus `open()` to activate the row (opening the configured detail
+     * panel/modal/route). Row activation is *not* applied automatically to a
+     * custom card — wrapping it would double-fire against cards that bring
+     * their own click handling and would hijack clicks on nested buttons — so
+     * call `actions.open()` from wherever your card should activate.
+     */
+    renderCard?: (item: T, index: number, actions: ResourceCardActions<T>) => ReactNode;
+    /**
+     * Tailwind grid-column classes for the card grid, passed through to
+     * `DataGrid`'s `gridCols` — e.g. `"grid-cols-1 sm:grid-cols-2 lg:grid-cols-3"`.
+     * Defaults to DataGrid's own responsive 1/2/3/4-column ramp.
+     */
+    gridCols?: string;
+    /**
+     * Built-in list keyboard navigation via `useKeyboardNavigation`: j/k (or
+     * Arrow Up/Down) move a focus cursor, Enter opens the focused item,
+     * Backspace (⌫) closes an open detail view, and x toggles the focused
+     * item's selection when `bulkActions` are configured. Set to `false` to
+     * opt out.
+     *
+     * Default-on, and scoped so that being on by default stays safe:
+     * - Only while the grid or list view is showing. Table view keeps its own
+     *   independent sort/pagination, so a flat focus index can't reliably map
+     *   onto its visible rows.
+     * - Cursor keys suspend while a detail panel/modal or the built-in form
+     *   is open, so they can't drive the list behind the overlay; ⌫ stays
+     *   live there so it can close it.
+     * - Backspace is only intercepted while there's an open detail to close.
+     * - Modified chords (Ctrl/Cmd/Alt) are never captured, so an app's
+     *   Cmd+K-style shortcuts keep working.
+     */
+    keyboardNavigation?: boolean;
     toolbar?: ReactNode;
     emptyState?: ReactNode;
     /**
@@ -343,9 +441,93 @@ interface ResourcePageProps<T extends Record<string, unknown> = Record<string, u
     onNavigate?: NavigateFn;
     resourceOptions?: UseResourceOptions<T>;
     defaultView?: ViewMode;
+    /**
+     * Persist key for density / page size via `useViewSettings`.
+     * Defaults to `resource` or a slug of `title`.
+     */
+    viewSettingsKey?: string;
 }
 declare function ResourcePage<T extends Record<string, unknown> = Record<string, unknown>>(props: ResourcePageProps<T>): react_jsx_runtime.JSX.Element;
 
+interface ResourceDetailPageProps<T extends BaseRecord = BaseRecord> {
+    /** Resource name, resolved through the mounted `DataProvider`. */
+    resource: string;
+    /**
+     * Record id. Nullish means "not resolved yet" — no request goes out and the
+     * page shows its loading state, which is what a route param that hasn't
+     * arrived should look like. It is deliberately NOT the not-found state:
+     * nothing has been asked, so nothing is missing.
+     */
+    id: Identifier | undefined | null;
+    /**
+     * Field used as the page title. Defaults to `name`, then `title`, then the
+     * id — the same fallback chain `ResourcePage` uses for a row's label.
+     */
+    titleField?: string;
+    /** Field used as the line under the title. */
+    subtitleField?: string;
+    /** Provider select/join syntax, e.g. `"*, owner:profiles(name)"`. */
+    select?: string;
+    /** Slot above the title: a `Breadcrumb`, a back link, a `StatusBadge`. */
+    breadcrumb?: ReactNode;
+    /** Record-scoped controls, built from the loaded record. */
+    actions?: (record: T) => ReactNode;
+    /** Metadata column, built from the loaded record. */
+    sidebar?: (record: T) => ReactNode;
+    /** The primary content region. */
+    children: (record: T) => ReactNode;
+    className?: string;
+    /** Stable test/automation selector (emitted as `data-testid`). */
+    testID?: string;
+}
+/**
+ * ResourceDetailPage — `DetailPage` with a record bound to it: fetches one
+ * record by id through the mounted `DataProvider` and hands it to the title,
+ * the actions, the sidebar and the content.
+ *
+ * ```tsx
+ * <ResourceDetailPage
+ *   resource="people"
+ *   id={params.id}
+ *   subtitleField="role"
+ *   actions={(person) => <Button testID="edit">Edit {person.name}</Button>}
+ *   sidebar={(person) => <StatCard label="Sessions" value={person.session_count} />}
+ * >
+ *   {(person) => <Section title="Timeline"><Timeline personId={person.id} /></Section>}
+ * </ResourceDetailPage>
+ * ```
+ *
+ * This is the detail-route counterpart to `ResourcePage`, which is the list
+ * one. Both are **data-bound**, not layouts: they need a resource contract
+ * to be useful, which is the layers table's admission test for this tier.
+ * The structure they render is a layout and lives one layer down —
+ * `DetailPage` in `@marktiderman/genesis-ui/layout` — so an app with its own
+ * fetching keeps the page shape without inheriting the provider. That
+ * layout/data-bound pairing is the same one `AppShell` and `ResourcePage`
+ * already have.
+ *
+ * The three non-record states are rendered here rather than left to the
+ * caller, because a per-app "loading…" is exactly the hand-written code a
+ * template exists to remove:
+ * - loading, or no id yet -> `PageLoading`
+ * - absent -> `EmptyState` saying so, distinct from the error state, since a
+ *   deleted record and a broken query need different words. Every provider
+ *   Genesis ships signals "no such row" by throwing rather than by resolving
+ *   empty, so this state is reached by classifying the error (see
+ *   `isNotFoundError`) as well as by a falsy `data`
+ * - any other failure -> `EmptyState` carrying the provider's message, which
+ *   is kept verbatim: an error state that hides what went wrong is the one
+ *   nobody can act on
+ *
+ * `titleField` is exact: name a field and you get that field, empty string
+ * included. The `name` -> `title` -> id chain is the DEFAULT, not a fallback
+ * layered under an explicit choice — a page silently titled by a different
+ * column than the one asked for is worse than a blank one.
+ *
+ * @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;
+
 interface ResourceFormProps {
     resource: string;
     action: "create" | "edit";
@@ -405,52 +587,19 @@ interface WizardFormProps {
 }
 declare function WizardForm({ steps, form, fields, onSubmit, isSaving, renderField, action, onInvalid, }: WizardFormProps): react_jsx_runtime.JSX.Element;
 
-interface NavItem {
-    to: string;
-    icon: LucideIcon;
-    label: string;
-}
 /**
- * @stability Beta
+ * @deprecated Import `AppShell` from `@marktiderman/genesis-ui/layout` instead.
+ * `AppShell` is a layout, not a data-bound component. This `/data` alias is
+ * removed in the next major — see docs/FRAMEWORK.md rule 5.
+ * @stability Deprecated
  */
-interface AppShellProps {
-    /** App name shown in sidebar header */
-    appName: string;
-    /** App logo letter or short text */
-    appLogo?: string;
-    /** Navigation items */
-    navItems: NavItem[];
-    /** Page content */
-    children: ReactNode;
-    /** Show theme toggle (default: true) */
-    showThemeToggle?: boolean;
-    /**
-     * Injectable link component. Defaults to a plain `<a>` (no router). Pass a
-     * router adapter — e.g. React Router `({ href, ...p }) => <Link to={href} {...p} />`
-     * or Next.js `next/link` — to get client-side navigation.
-     */
-    linkComponent?: LinkComponent;
-    /**
-     * Current path used to highlight the active nav item. Router consumers pass
-     * `useLocation().pathname` (RR) or `usePathname()` (Next). Omit to disable
-     * active highlighting.
-     */
-    activePath?: string;
-    /**
-     * Optional custom active-state matcher. Defaults to a prefix match (with `/`
-     * treated as exact), mirroring React Router `NavLink`.
-     */
-    isActive?: (to: string, activePath?: string) => boolean;
-}
-declare function AppShell({ appName, appLogo, navItems, children, showThemeToggle, linkComponent, activePath, isActive, }: AppShellProps): react_jsx_runtime.JSX.Element;
-
-interface PageHeaderProps {
-    title: string;
-    subtitle?: string;
-    icon?: LucideIcon;
-    /** Optional action area (buttons, etc.) */
-    actions?: ReactNode;
-}
-declare function PageHeader({ title, subtitle, icon: Icon, actions }: PageHeaderProps): react_jsx_runtime.JSX.Element;
+declare const AppShell: typeof AppShell$1;
+/**
+ * @deprecated Import `PageHeader` from `@marktiderman/genesis-ui/layout`
+ * instead. `PageHeader` is a layout, not a data-bound component. This `/data`
+ * alias is removed in the next major — see docs/FRAMEWORK.md rule 5.
+ * @stability Deprecated
+ */
+declare const PageHeader: typeof PageHeader$1;
 
-export { AppShell, type AppShellProps, BadgeCell, type BulkAction, type ColumnStatus, CurrencyCell, DataBulkBar, type DataFilterConfig, DataFilters, DataGrid, DataList, type DataListProps, DataPageShell, type DataPageShellProps, DateCell, DetailPanel, type DetailPanelProps, EmptyState, FieldArrayRenderer, FileUploadField, FilterCombobox, type FilterOption, KanbanBoard, type KanbanBoardProps, type KanbanColumn, LinkComponent, type NavItem, NavigateFn, NumberCell, PageHeader, type PageHeaderProps, RelationField, ResourceColumnDef, ResourceForm, type ResourceFormProps, ResourcePage, type ResourcePageProps, StatCard, type StatCardColor, type StatCardProps, ViewMode, ViewSettings, WizardForm };
+export { AppShell, BadgeCell, type BulkAction, type ColumnStatus, CurrencyCell, DataBulkBar, type DataFilterConfig, DataFilters, DataGrid, DataList, type DataListProps, DataPageShell, type DataPageShellProps, DateCell, Density, DetailPanel, type DetailPanelProps, FieldArrayRenderer, FileUploadField, FilterCombobox, type FilterOption, KanbanBoard, type KanbanBoardProps, type KanbanColumn, LinkComponent, NavigateFn, NumberCell, PageHeader, PageHeaderOptions, RelationField, ResourceActions, type ResourceCardActions, ResourceColumnDef, ResourceDetailPage, type ResourceDetailPageProps, ResourceForm, type ResourceFormProps, ResourcePage, type ResourcePageProps, type SavedViewItem, StatCard, type StatCardColor, type StatCardProps, ViewMode, WizardForm };