@marktiderman/genesis-ui 1.0.0

package/dist/chunk-ZDAT5JDH.js

@@ -0,0 +1,82 @@
+import { cn } from './chunk-NZ5WBA4R.js';
+import { FileQuestion, Lightbulb, MessageSquare, Search } from 'lucide-react';
+import { jsxs, jsx } from 'react/jsx-runtime';
+
+function EmptyState({
+  icon: Icon = FileQuestion,
+  title,
+  description,
+  action,
+  className
+}) {
+  return /* @__PURE__ */ jsxs(
+    "div",
+    {
+      className: cn(
+        "flex flex-col items-center justify-center py-12 px-4 text-center",
+        className
+      ),
+      children: [
+        /* @__PURE__ */ jsx("div", { className: "flex h-16 w-16 items-center justify-center rounded-full bg-muted", children: /* @__PURE__ */ jsx(Icon, { className: "h-8 w-8 text-muted-foreground", "aria-hidden": "true" }) }),
+        /* @__PURE__ */ jsx("h3", { className: "mt-4 text-lg font-semibold", children: title }),
+        description && /* @__PURE__ */ jsx("p", { className: "mt-2 text-sm text-muted-foreground max-w-sm", children: description }),
+        action && /* @__PURE__ */ jsx("div", { className: "mt-6", children: action })
+      ]
+    }
+  );
+}
+function NoFeaturesFound({ onCreate }) {
+  return /* @__PURE__ */ jsx(
+    EmptyState,
+    {
+      icon: Lightbulb,
+      title: "No features found",
+      description: "Start building your product roadmap by creating your first epic.",
+      action: onCreate && /* @__PURE__ */ jsx(
+        "button",
+        {
+          type: "button",
+          onClick: onCreate,
+          className: "rounded-lg bg-primary px-4 py-2 text-sm font-medium text-primary-foreground hover:bg-primary/90",
+          children: "Create Epic"
+        }
+      )
+    }
+  );
+}
+function NoFeedbackFound() {
+  return /* @__PURE__ */ jsx(
+    EmptyState,
+    {
+      icon: MessageSquare,
+      title: "No feedback yet",
+      description: "Feedback from users will appear here as they use the app."
+    }
+  );
+}
+function NoSearchResults({
+  query,
+  onClear
+}) {
+  return /* @__PURE__ */ jsx(
+    EmptyState,
+    {
+      icon: Search,
+      title: "No results found",
+      description: query ? `No results found for "${query}". Try a different search term.` : "No results match your current filters.",
+      action: onClear && /* @__PURE__ */ jsx(
+        "button",
+        {
+          type: "button",
+          onClick: onClear,
+          className: "text-sm text-primary hover:text-primary/80 font-medium",
+          children: "Clear search"
+        }
+      )
+    }
+  );
+}
+
+export { EmptyState, NoFeaturesFound, NoFeedbackFound, NoSearchResults };
+//# sourceMappingURL=chunk-ZDAT5JDH.js.map
+//# sourceMappingURL=chunk-ZDAT5JDH.js.map

package/dist/chunk-ZDAT5JDH.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/components/ui/empty-state.tsx"],"names":[],"mappings":";;;;AAkBO,SAAS,UAAA,CAAW;AAAA,EACzB,MAAM,IAAA,GAAO,YAAA;AAAA,EACb,KAAA;AAAA,EACA,WAAA;AAAA,EACA,MAAA;AAAA,EACA;AACF,CAAA,EAAoB;AAClB,EAAA,uBACE,IAAA;AAAA,IAAC,KAAA;AAAA,IAAA;AAAA,MACC,SAAA,EAAW,EAAA;AAAA,QACT,kEAAA;AAAA,QACA;AAAA,OACF;AAAA,MAEA,QAAA,EAAA;AAAA,wBAAA,GAAA,CAAC,KAAA,EAAA,EAAI,WAAU,kEAAA,EACb,QAAA,kBAAA,GAAA,CAAC,QAAK,SAAA,EAAU,+BAAA,EAAgC,aAAA,EAAY,MAAA,EAAO,CAAA,EACrE,CAAA;AAAA,wBACA,GAAA,CAAC,IAAA,EAAA,EAAG,SAAA,EAAU,4BAAA,EAA8B,QAAA,EAAA,KAAA,EAAM,CAAA;AAAA,QACjD,WAAA,oBACC,GAAA,CAAC,GAAA,EAAA,EAAE,SAAA,EAAU,+CACV,QAAA,EAAA,WAAA,EACH,CAAA;AAAA,QAED,MAAA,oBAAU,GAAA,CAAC,KAAA,EAAA,EAAI,SAAA,EAAU,QAAQ,QAAA,EAAA,MAAA,EAAO;AAAA;AAAA;AAAA,GAC3C;AAEJ;AAEO,SAAS,eAAA,CAAgB,EAAE,QAAA,EAAS,EAA8B;AACvE,EAAA,uBACE,GAAA;AAAA,IAAC,UAAA;AAAA,IAAA;AAAA,MACC,IAAA,EAAM,SAAA;AAAA,MACN,KAAA,EAAM,mBAAA;AAAA,MACN,WAAA,EAAY,kEAAA;AAAA,MACZ,QACE,QAAA,oBACE,GAAA;AAAA,QAAC,QAAA;AAAA,QAAA;AAAA,UACC,IAAA,EAAK,QAAA;AAAA,UACL,OAAA,EAAS,QAAA;AAAA,UACT,SAAA,EAAU,iGAAA;AAAA,UACX,QAAA,EAAA;AAAA;AAAA;AAED;AAAA,GAGN;AAEJ;AAEO,SAAS,eAAA,GAAkB;AAChC,EAAA,uBACE,GAAA;AAAA,IAAC,UAAA;AAAA,IAAA;AAAA,MACC,IAAA,EAAM,aAAA;AAAA,MACN,KAAA,EAAM,iBAAA;AAAA,MACN,WAAA,EAAY;AAAA;AAAA,GACd;AAEJ;AAEO,SAAS,eAAA,CAAgB;AAAA,EAC9B,KAAA;AAAA,EACA;AACF,CAAA,EAGG;AACD,EAAA,uBACE,GAAA;AAAA,IAAC,UAAA;AAAA,IAAA;AAAA,MACC,IAAA,EAAM,MAAA;AAAA,MACN,KAAA,EAAM,kBAAA;AAAA,MACN,WAAA,EACE,KAAA,GACI,CAAA,sBAAA,EAAyB,KAAK,CAAA,+BAAA,CAAA,GAC9B,wCAAA;AAAA,MAEN,QACE,OAAA,oBACE,GAAA;AAAA,QAAC,QAAA;AAAA,QAAA;AAAA,UACC,IAAA,EAAK,QAAA;AAAA,UACL,OAAA,EAAS,OAAA;AAAA,UACT,SAAA,EAAU,wDAAA;AAAA,UACX,QAAA,EAAA;AAAA;AAAA;AAED;AAAA,GAGN;AAEJ","file":"chunk-ZDAT5JDH.js","sourcesContent":["import * as React from \"react\";\nimport { cn } from \"../../utils\";\nimport {\n  FileQuestion,\n  Lightbulb,\n  MessageSquare,\n  Search,\n  type LucideIcon,\n} from \"lucide-react\";\n\ninterface EmptyStateProps {\n  icon?: LucideIcon;\n  title: string;\n  description?: string;\n  action?: React.ReactNode;\n  className?: string;\n}\n\nexport function EmptyState({\n  icon: Icon = FileQuestion,\n  title,\n  description,\n  action,\n  className,\n}: EmptyStateProps) {\n  return (\n    <div\n      className={cn(\n        \"flex flex-col items-center justify-center py-12 px-4 text-center\",\n        className\n      )}\n    >\n      <div className=\"flex h-16 w-16 items-center justify-center rounded-full bg-muted\">\n        <Icon className=\"h-8 w-8 text-muted-foreground\" aria-hidden=\"true\" />\n      </div>\n      <h3 className=\"mt-4 text-lg font-semibold\">{title}</h3>\n      {description && (\n        <p className=\"mt-2 text-sm text-muted-foreground max-w-sm\">\n          {description}\n        </p>\n      )}\n      {action && <div className=\"mt-6\">{action}</div>}\n    </div>\n  );\n}\n\nexport function NoFeaturesFound({ onCreate }: { onCreate?: () => void }) {\n  return (\n    <EmptyState\n      icon={Lightbulb}\n      title=\"No features found\"\n      description=\"Start building your product roadmap by creating your first epic.\"\n      action={\n        onCreate && (\n          <button\n            type=\"button\"\n            onClick={onCreate}\n            className=\"rounded-lg bg-primary px-4 py-2 text-sm font-medium text-primary-foreground hover:bg-primary/90\"\n          >\n            Create Epic\n          </button>\n        )\n      }\n    />\n  );\n}\n\nexport function NoFeedbackFound() {\n  return (\n    <EmptyState\n      icon={MessageSquare}\n      title=\"No feedback yet\"\n      description=\"Feedback from users will appear here as they use the app.\"\n    />\n  );\n}\n\nexport function NoSearchResults({\n  query,\n  onClear,\n}: {\n  query?: string;\n  onClear?: () => void;\n}) {\n  return (\n    <EmptyState\n      icon={Search}\n      title=\"No results found\"\n      description={\n        query\n          ? `No results found for \"${query}\". Try a different search term.`\n          : \"No results match your current filters.\"\n      }\n      action={\n        onClear && (\n          <button\n            type=\"button\"\n            onClick={onClear}\n            className=\"text-sm text-primary hover:text-primary/80 font-medium\"\n          >\n            Clear search\n          </button>\n        )\n      }\n    />\n  );\n}\n"]}

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

@@ -0,0 +1,458 @@
+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 { LucideIcon } from 'lucide-react';
+import { Density } from '../../hooks/use-view-settings.js';
+import { a as ResourceColumnDef } from '../../use-resource-page-BzvUM8de.js';
+export { D as DataTable, c as DataTableColumn, d as DataTableProps, L as LinkCell, R as ResourceActions, T as ThumbnailCell } from '../../use-resource-page-BzvUM8de.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 { UseFormReturn, Control, FieldErrors } from 'react-hook-form';
+import { UseResourceOptions } from '../../hooks/use-resource.js';
+import { F as FilterParam } from '../../types-HIZY7zxO.js';
+import { ResourceFormFieldDef } from '@marktiderman/genesis-core';
+export { FieldType, ResourceFormFieldDef, SelectOption } from '@marktiderman/genesis-core';
+import { WizardStep } from '../../hooks/use-wizard.js';
+import '@tanstack/react-query';
+
+interface DataPageShellProps {
+    /** Display title for the page */
+    title: string;
+    icon?: LucideIcon;
+    /** Singular entity name for generated text, e.g. "session" */
+    entityName?: string;
+    /** Subtitle text */
+    subtitle?: string;
+    createAction?: ReactNode;
+    isLoading?: boolean;
+    isEmpty?: boolean;
+    emptyIcon?: LucideIcon;
+    emptyMessage?: string;
+    emptyAction?: ReactNode;
+    /** Error state */
+    hasError?: boolean;
+    errorMessage?: string;
+    onRetry?: () => void;
+    /** Number of filtered/visible items */
+    count?: number;
+    /** Total items before filtering */
+    totalCount?: number;
+    viewMode?: ViewMode;
+    onViewModeChange?: (mode: ViewMode) => void;
+    /** View settings */
+    pageSize?: number;
+    onPageSizeChange?: (size: number) => void;
+    density?: Density;
+    onDensityChange?: (density: Density) => void;
+    /** Slot for filter bar */
+    filters?: ReactNode;
+    /** Whether filters are currently active */
+    hasActiveFilters?: boolean;
+    onClearFilters?: () => void;
+    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;
+
+interface FilterOption {
+    value: string;
+    label?: string;
+    count?: number;
+}
+interface FilterComboboxProps {
+    label: string;
+    icon: LucideIcon;
+    options: FilterOption[];
+    selected: string[];
+    onChange: (selected: string[]) => void;
+    searchPlaceholder?: string;
+    allLabel?: string;
+    /** 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;
+
+interface DataFilterConfig {
+    key: string;
+    label: string;
+    icon: LucideIcon;
+    options: FilterOption[];
+    selected: string[];
+    onChange: (values: string[]) => void;
+    searchPlaceholder?: string;
+    allLabel?: string;
+    labelMap?: Record<string, string>;
+}
+interface SavedViewItem {
+    id: string;
+    name: string;
+    filters: Record<string, unknown>;
+}
+interface DataFiltersProps {
+    search: string;
+    onSearchChange: (value: string) => void;
+    searchPlaceholder?: string;
+    sort: string;
+    onSortChange: (sort: string) => void;
+    sortOptions: Array<{
+        value: string;
+        label: string;
+    }>;
+    filters?: DataFilterConfig[];
+    /** Status chip toggles */
+    statusChips?: {
+        options: string[];
+        selected: string[];
+        onChange: (values: string[]) => void;
+    };
+    /** Saved views */
+    savedViews?: SavedViewItem[];
+    onLoadView?: (filters: Record<string, unknown>) => void;
+    onSaveView?: (name: string) => void;
+    onDeleteView?: (id: string) => void;
+    canSaveViews?: boolean;
+    /** Called after a view is saved successfully */
+    onViewSaved?: (name: string) => void;
+    /** Called when an error occurs */
+    onError?: (message: string) => void;
+    /** Called when "Clear all" is clicked */
+    onClearAll?: () => void;
+    /** 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;
+
+interface DataGridProps<T> {
+    items: T[];
+    viewMode: ViewMode;
+    /** Items per infinite scroll batch (grid only). Default 48 */
+    batchSize?: number;
+    /** Tailwind grid column classes */
+    gridCols?: string;
+    /** Render a single card in grid mode */
+    renderCard: (item: T, index: number) => ReactNode;
+    /** Render the table view (receives currently visible items) */
+    renderTable?: (items: T[]) => ReactNode;
+    /** Render a compact list row */
+    renderListItem?: (item: T, index: number) => ReactNode;
+    /** Animate cards with staggered fade-in. Default true */
+    staggerAnimation?: boolean;
+    /** Unique key extractor. Defaults to (item as any).id */
+    getKey?: (item: T) => string;
+    /** Keyboard navigation: focused item index (-1 = none) */
+    focusedIndex?: number;
+    /** 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;
+
+interface BulkAction {
+    label: string;
+    icon: LucideIcon;
+    onClick: () => void;
+    variant?: "default" | "destructive" | "outline" | "secondary" | "ghost" | "link";
+}
+interface DataBulkBarProps {
+    selected: Set<string>;
+    totalCount: number;
+    onToggleAll: () => void;
+    onClearSelection: () => void;
+    actions: BulkAction[];
+}
+declare function DataBulkBar({ selected, totalCount, onToggleAll, onClearSelection, actions, }: DataBulkBarProps): react_jsx_runtime.JSX.Element | null;
+
+/**
+ * DateCell -- shows relative date by default, formatted date otherwise.
+ * Compatible with DataTableColumn<T>'s `render` prop.
+ */
+declare function DateCell(options?: {
+    relative?: boolean;
+    format?: string;
+}): (_item: unknown, value: unknown) => string;
+/**
+ * NumberCell -- locale-aware number formatting.
+ */
+declare function NumberCell(options?: Intl.NumberFormatOptions): (_item: unknown, value: unknown) => string;
+/**
+ * CurrencyCell -- currency formatting with string-safe parsing.
+ */
+declare function CurrencyCell(currency?: string, locale?: string): (_item: unknown, value: unknown) => string;
+/**
+ * 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 | "—";
+
+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;
+    value: string | number;
+    icon?: LucideIcon;
+    /** Semantic color key or raw Tailwind class */
+    color?: StatCardColor | string;
+    /** When set, the card renders as a link to this path. */
+    href?: string;
+    /**
+     * Injectable link component used when `href` is set. Defaults to a plain
+     * `<a>` (no router). Pass a router adapter for client-side navigation.
+     */
+    linkComponent?: LinkComponent;
+    trend?: {
+        value: number;
+        label: string;
+    };
+    className?: string;
+}
+declare function StatCard({ label, value, icon: Icon, color, href, linkComponent: Link, trend, className, }: StatCardProps): react_jsx_runtime.JSX.Element;
+
+type ColumnStatus = "neutral" | "warning" | "success" | "info" | "destructive" | "primary";
+interface KanbanColumn<T> {
+    key: string;
+    label: string;
+    /** Semantic status for automatic color mapping */
+    status?: ColumnStatus;
+    /** Raw color class (used if status not provided) */
+    color?: string;
+    /** Raw bg color class (used if status not provided) */
+    bgColor?: string;
+    items: T[];
+}
+interface KanbanBoardProps<T> {
+    columns: KanbanColumn<T>[];
+    renderCard: (item: T) => ReactNode;
+    emptyMessage?: string;
+    className?: string;
+}
+declare function KanbanBoard<T>({ columns, renderCard, emptyMessage, className, }: KanbanBoardProps<T>): react_jsx_runtime.JSX.Element;
+
+interface DataListProps<T> {
+    items: T[];
+    renderItem: (item: T, index: number) => ReactNode;
+    emptyMessage?: string;
+    className?: string;
+}
+declare function DataList<T>({ items, renderItem, emptyMessage, className, }: DataListProps<T>): react_jsx_runtime.JSX.Element;
+
+interface DetailPanelProps<T> {
+    /** The record to display */
+    item: T | null;
+    /** Whether panel is visible */
+    open: boolean;
+    /** Close handler */
+    onClose: () => void;
+    /** Header title */
+    title?: string;
+    /** Header subtitle */
+    subtitle?: string;
+    /** Shows edit button if provided */
+    onEdit?: (item: T) => void;
+    /** Shows delete button if provided */
+    onDelete?: (item: T) => void;
+    /** Custom content renderer */
+    children?: (item: T) => ReactNode;
+    /** Field definitions for auto-rendering */
+    fields?: Array<{
+        key: string;
+        label: string;
+        render?: (value: unknown, item: T) => ReactNode;
+    }>;
+    /** Panel width */
+    width?: "sm" | "md" | "lg";
+}
+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;
+
+interface ResourcePageProps<T extends Record<string, unknown> = Record<string, unknown>> {
+    /** Client-side mode: resource name passed to useResource / DataProvider. */
+    resource?: string;
+    /** Server-data mode: pre-fetched data array. */
+    data?: T[];
+    /** Server-data mode: total record count (before client-side filtering). */
+    total?: number;
+    title: string;
+    /** Page subtitle shown below the title. */
+    subtitle?: string;
+    icon?: LucideIcon;
+    columns?: Array<string | ResourceColumnDef<T>>;
+    /** How row-click detail is shown. Default "panel". */
+    detail?: "panel" | "modal" | "route" | "none";
+    detailWidth?: "sm" | "md" | "lg";
+    titleField?: string;
+    subtitleField?: string;
+    renderDetail?: (item: T) => ReactNode;
+    detailFields?: Array<{
+        key: string;
+        label: string;
+        render?: (value: unknown, item: T) => ReactNode;
+    }>;
+    statusFilter?: string | {
+        field: string;
+        options?: string[];
+    };
+    searchFields?: string[];
+    searchPlaceholder?: string;
+    initialFilters?: FilterParam[];
+    onFiltersChange?: (filters: FilterParam[]) => void;
+    onCreate?: () => void;
+    onEdit?: (item: T) => void;
+    onDelete?: (item: T) => void;
+    createLabel?: string;
+    /** Enable built-in create form (ignored if onCreate callback is provided). */
+    allowCreate?: boolean;
+    /** Enable built-in edit form (ignored if onEdit callback is provided). */
+    allowEdit?: boolean;
+    /** Field definitions for the built-in form. */
+    formFields?: ResourceFormFieldDef[];
+    /** Custom form renderer — receives form instance and resolved fields. */
+    renderForm?: (form: UseFormReturn<Record<string, unknown>>, fields: ResourceFormFieldDef[]) => ReactNode;
+    /** Form presentation mode. Default "standard". */
+    formMode?: "standard" | "wizard";
+    /** Wizard step definitions. Required when formMode is "wizard". */
+    formSteps?: WizardStep[];
+    /** Layout mode for the built-in form container. If not set, defaults to sheet for edit, dialog for create. */
+    formLayout?: "dialog" | "sheet" | "page";
+    bulkActions?: Array<{
+        label: string;
+        icon?: LucideIcon;
+        variant?: "default" | "destructive";
+        onAction: (ids: string[]) => void | Promise<void>;
+    }>;
+    toolbar?: ReactNode;
+    emptyState?: ReactNode;
+    /**
+     * Imperative navigation used only when `detail="route"` (navigates to
+     * `/{resource}/{id}` on row click). Defaults to a full-page navigation.
+     * Router consumers pass their navigate fn — e.g. RR `useNavigate()` or
+     * Next `router.push`.
+     */
+    onNavigate?: NavigateFn;
+    resourceOptions?: UseResourceOptions<T>;
+    defaultView?: ViewMode;
+}
+declare function ResourcePage<T extends Record<string, unknown> = Record<string, unknown>>(props: ResourcePageProps<T>): react_jsx_runtime.JSX.Element;
+
+interface ResourceFormProps {
+    resource: string;
+    action: "create" | "edit";
+    item?: Record<string, unknown>;
+    open: boolean;
+    onOpenChange: (open: boolean) => void;
+    title?: string;
+    fields?: ResourceFormFieldDef[];
+    /** Full dataset used to auto-detect select fields from unique values. */
+    listData?: Record<string, unknown>[];
+    renderForm?: (form: UseFormReturn<Record<string, unknown>>, fields: ResourceFormFieldDef[]) => ReactNode;
+    onSuccess?: (data: Record<string, unknown>) => void;
+    onError?: (error: Error) => void;
+    /** Layout mode for the form container. Default "dialog". */
+    layout?: "dialog" | "sheet" | "page";
+    /** Form presentation mode. Default "standard". */
+    mode?: "standard" | "wizard";
+    /** Wizard step definitions. Required when mode is "wizard". */
+    steps?: WizardStep[];
+    /** Number of columns for the form layout. Default 1. */
+    columns?: 1 | 2;
+}
+declare function ResourceForm(props: ResourceFormProps): react_jsx_runtime.JSX.Element | null;
+
+interface RelationFieldProps {
+    field: ResourceFormFieldDef;
+    value: string;
+    onChange: (value: string) => void;
+    disabled?: boolean;
+}
+declare function RelationField({ field, value, onChange, disabled, }: RelationFieldProps): react_jsx_runtime.JSX.Element;
+
+interface FileUploadFieldProps {
+    field: ResourceFormFieldDef;
+    value: File | File[] | null;
+    onChange: (value: File | File[] | null) => void;
+    disabled?: boolean;
+}
+declare function FileUploadField({ field, value, onChange, disabled, }: FileUploadFieldProps): react_jsx_runtime.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;
+
+interface WizardFormProps {
+    steps: WizardStep[];
+    form: UseFormReturn<Record<string, unknown>>;
+    fields: ResourceFormFieldDef[];
+    onSubmit: (data: Record<string, unknown>) => Promise<void>;
+    isSaving: boolean;
+    renderField?: (field: ResourceFormFieldDef, control: UseFormReturn<Record<string, unknown>>["control"], action: "create" | "edit", watchedValues: Record<string, unknown>) => ReactNode;
+    action: "create" | "edit";
+    onInvalid?: (errors: FieldErrors) => void;
+}
+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
+ */
+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;
+
+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 };