@olwiba/ui 0.2.23 → 0.2.25

package/dist/index.d.ts

@@ -226,6 +226,8 @@ interface AppShellUser {
     email: string;
     name?: string;
     avatar?: string;
+    /** Product-owned artwork shown when no avatar image exists. Defaults to the Olwiba bird. */
+    avatarFallback?: ReactNode;
     /** Displayed as a sub-label (e.g. plan tier). */
     plan?: string;
     onSignOut?: () => void;
@@ -256,6 +258,11 @@ type AppShellBreadcrumb = string | {
     label: string;
     href?: string;
 };
+interface AppShellHeaderControls {
+    /** Expands the desktop sidebar or opens its native mobile presentation. */
+    expandSidebar: () => void;
+}
+type AppShellHeaderStart = ReactNode | ((controls: AppShellHeaderControls) => ReactNode);
 interface AppShellProps {
     brand?: AppShellBrand;
     navItems?: AppNavItem[];
@@ -274,10 +281,16 @@ interface AppShellProps {
      * and preferred over `pageTitle` when supplied.
      */
     breadcrumbs?: AppShellBreadcrumb[];
-    /** Slot rendered at the start of the top header bar, after the sidebar trigger. */
-    headerStart?: ReactNode;
+    /**
+     * Slot rendered at the start of the top header bar, after the sidebar trigger.
+     * Use the render form when a custom control needs to expand the shell's own
+     * sidebar without importing its private provider context.
+     */
+    headerStart?: AppShellHeaderStart;
     /** Slot rendered at the end of the top header bar. */
     headerEnd?: ReactNode;
+    /** Product chrome rendered above the user menu in the sidebar footer. */
+    sidebarFooterStart?: ReactNode;
     /**
      * App chrome rendered after the page outlet — normally an `AppFooter`. This
      * belongs to the shell, not to a page pattern: otherwise every route
@@ -300,6 +313,10 @@ interface AppShellProps {
      * - `"contained"` — fills its parent container; use in docs sandboxes, modals, or embedded previews.
      */
     sidebarPosition?: 'viewport' | 'contained';
+    /** Remount key for an animated sidebar identity or navigation-mode change. */
+    sidebarContentKey?: string;
+    /** Classes applied to the sidebar header, content, and footer. */
+    sidebarContentClassName?: string;
     /** Which side the sidebar sits on. @default "left" */
     side?: 'left' | 'right';
     /**
@@ -312,7 +329,7 @@ interface AppShellProps {
      */
     contentClassName?: string;
 }
-declare function AppShell({ brand, navItems, action, user, pageTitle, breadcrumbs, footer, headerStart, headerEnd, renderLink, collapsible, sidebarPosition, side, contentClassName, children, }?: AppShellProps): react_jsx_runtime.JSX.Element;
+declare function AppShell({ brand, navItems, action, user, pageTitle, breadcrumbs, footer, headerStart, headerEnd, renderLink, collapsible, sidebarPosition, sidebarContentKey, sidebarContentClassName, sidebarFooterStart, side, contentClassName, children, }?: AppShellProps): react_jsx_runtime.JSX.Element;
 
 interface AppPageHeroProps {
     eyebrow?: ReactNode;
@@ -354,8 +371,9 @@ interface AppFooterProps extends HTMLAttributes<HTMLElement> {
  * the page outlet rather than inside a page pattern. Public marketing pages use
  * the full `Footer` instead — this exists so long app pages do not end abruptly.
  *
- * The row owns geometry only. What the slots contain — live status, version,
- * links, product copy — stays with the product.
+ * The row owns its solid chrome surface and geometry so page ambience cannot
+ * bleed through it. What the slots contain — live status, version, links,
+ * product copy — stays with the product.
  */
 declare function AppFooter({ start, end, children, className, ...props }: AppFooterProps): react_jsx_runtime.JSX.Element;
 
@@ -527,10 +545,18 @@ declare function OnboardingWizard({ steps, onComplete, onStepChange, step: stepP
 interface EmptyStateProps extends React.HTMLAttributes<HTMLDivElement> {
     icon?: LucideIcon;
     title: string;
-    description?: string;
+    description?: React.ReactNode;
+    eyebrow?: React.ReactNode;
     action?: React.ReactNode;
+    secondaryAction?: React.ReactNode;
+    /** Adds the application-card surface used for route-level empty states. */
+    variant?: 'plain' | 'card';
+    /** Reduces the card presentation's minimum height and padding. */
+    compact?: boolean;
+    /** Fills a flex-sized parent rather than using a fixed minimum height. */
+    fill?: boolean;
 }
-declare function EmptyState({ icon: Icon, title, description, action, className, ...props }: EmptyStateProps): react_jsx_runtime.JSX.Element;
+declare function EmptyState({ icon: Icon, title, description, eyebrow, action, secondaryAction, variant, compact, fill, className, ...props }: EmptyStateProps): react_jsx_runtime.JSX.Element;
 
 interface ErrorPageLink {
     label: string;
@@ -1191,8 +1217,14 @@ interface FooterProps {
         icon: ReactNode;
     }>;
     legal?: string;
+    /**
+     * Live status pill. `label` is a ReactNode, not a string: a real status
+     * pill often carries per-service detail in a tooltip, and typing it as
+     * string forced consumers to smuggle that through `as unknown as string`.
+     * A plain string still works and is the common case.
+     */
     status?: {
-        label: string;
+        label: ReactNode;
         operational?: boolean;
     };
     renderLink?: AppShellRenderLink;
@@ -1487,6 +1519,23 @@ interface DataTableProps<TData> {
     onSelectionChange?: (rows: TData[]) => void;
     /** Rows per page. Set to `0` to disable pagination entirely. @default 10 */
     pageSize?: number;
+    /**
+     * Hands pagination to the caller, for data the client does not hold all of.
+     *
+     * With this set, `data` is treated as the current page rather than the whole
+     * set: the table stops slicing, and the footer reports and drives the
+     * caller's page instead of its own. Without it nothing changes — a table
+     * given every row keeps paginating locally, which is right for the common
+     * case and avoids making every consumer implement paging to get a table.
+     */
+    pagination?: {
+        pageIndex: number;
+        /** Total pages. Omit when unknown — the footer then relies on `hasNext`. */
+        pageCount?: number;
+        hasNext?: boolean;
+        hasPrevious?: boolean;
+        onPageChange: (pageIndex: number) => void;
+    };
     /** Slot rendered top-right of the toolbar — e.g. an "Add" button. */
     toolbar?: React.ReactNode;
     onRowClick?: (row: TData) => void;
@@ -1498,7 +1547,21 @@ interface DataTableProps<TData> {
  * toggle `searchKey`/`selectable`/`pageSize` rather than reaching for a
  * different table component per use case.
  */
-declare function DataTable<TData>({ columns, data, searchKey, searchPlaceholder, selectable, onSelectionChange, pageSize, toolbar, onRowClick, emptyMessage, className, }: DataTableProps<TData>): react_jsx_runtime.JSX.Element;
+declare function DataTable<TData>({ columns, data, searchKey, searchPlaceholder, selectable, onSelectionChange, pageSize, pagination, toolbar, onRowClick, emptyMessage, className, }: DataTableProps<TData>): react_jsx_runtime.JSX.Element;
+
+interface LoadMoreProps extends React.HTMLAttributes<HTMLDivElement> {
+    hasNextPage: boolean;
+    isFetchingNextPage: boolean;
+    fetchNextPage: () => void | Promise<unknown>;
+    /** Watches the sentinel instead of showing a manual button. */
+    auto?: boolean;
+    /** Plural noun used by the manual button, for example `properties`. */
+    label?: string;
+    /** Starts loading before the sentinel reaches the viewport. */
+    rootMargin?: string;
+}
+/** Cursor-pagination footer with either guarded infinite scroll or a manual fallback. */
+declare function LoadMore({ hasNextPage, isFetchingNextPage, fetchNextPage, auto, label, rootMargin, className, ...props }: LoadMoreProps): react_jsx_runtime.JSX.Element | null;
 
 type ViewMode = 'cards' | 'list';
 interface UseViewModeReturn {
@@ -1595,6 +1658,27 @@ interface ChartProps {
     grid?: boolean;
     /** Legend. @default true for multiple series or donut, false for one series */
     legend?: boolean;
+    /**
+     * Stack series instead of overlaying them. Area and bar only — a stacked
+     * line is a shape people misread as absolute values.
+     *
+     * Off by default: stacking answers "what does the total split into", and
+     * silently switching a two-series comparison to it would change what an
+     * existing chart claims.
+     */
+    stacked?: boolean;
+    /**
+     * Formats x-axis ticks. Separate from `valueFormatter`, which formats the
+     * measured value — an axis of ISO dates wants shortening without changing
+     * what the tooltip reports.
+     */
+    xTickFormatter?: (value: string) => string;
+    /**
+     * Fixes the y-axis range. Without it recharts scales to the data, which for
+     * a percentage series makes a 98-100%% band fill the plot and read as
+     * volatility.
+     */
+    yDomain?: [number, number];
     /** Formats values in tooltips and the y-axis, e.g. `(v) => \`$${v}\``. */
     valueFormatter?: (value: number) => string;
     className?: string;
@@ -1606,7 +1690,7 @@ interface ChartProps {
  * comparison, donut for part-of-whole identity. More than 5 donut slices:
  * fold the tail into an "Other" slice in your data instead of adding hues.
  */
-declare function Chart({ type, data, xKey, series, height, grid, legend, valueFormatter, className, }: ChartProps): react_jsx_runtime.JSX.Element;
+declare function Chart({ type, data, xKey, series, height, grid, legend, stacked, xTickFormatter, yDomain, valueFormatter, className, }: ChartProps): react_jsx_runtime.JSX.Element;
 
 interface FileUploadEntry {
     id: string;
@@ -1666,6 +1750,10 @@ interface NotificationToastProps {
  */
 declare function NotificationToast({ variant, title, description, avatar, action, secondaryAction, onDismiss, }: NotificationToastProps): react_jsx_runtime.JSX.Element;
 interface NotifyOptions extends Omit<NotificationToastProps, 'onDismiss'> {
+    /**
+     * Overrides the per-variant default below. Explicit always wins — a caller
+     * that has thought about the timing knows more than this heuristic does.
+     */
     duration?: number;
 }
 /** Fires a `NotificationToast` through sonner. Requires `<Toaster />` from `@olwiba/cn` mounted once in your app. */
@@ -2060,7 +2148,11 @@ interface PostListProps {
     posts: PostCardProps[];
     renderLink?: AppShellRenderLink;
     emptyMessage?: string;
-    /** Max columns at the widest breakpoint. */
+    /**
+     * Max columns at the widest breakpoint. When omitted, one- and two-post
+     * collections are balanced automatically instead of leaving an empty third
+     * column.
+     */
     columns?: 2 | 3;
     className?: string;
 }
@@ -2148,4 +2240,4 @@ interface UsePaginationReturn {
 }
 declare function usePagination(total: number, pageSize: number): UsePaginationReturn;
 
-export { ActivityFeed, type ActivityFeedItem, type ActivityFeedProps, AnimatedPill, type AnimatedPillProps, AnimatedSwap, type AnimatedSwapEffect, type AnimatedSwapProps, type AnimatedSwapSpec, AppContent, type AppContentProps, AppFooter, type AppFooterProps, AppGrid, AppGridCell, type AppGridCellProps, type AppGridColumns, type AppGridProps, type AppNavItem, AppPageHero, type AppPageHeroProps, AppScreen, AppShell, type AppShellAction, type AppShellBrand, type AppShellBreadcrumb, type AppShellProps, type AppShellRenderLink, type AppShellUser, type AuthFormProps, AuthSection, type AuthSectionProps, Badge, type BadgeProps, type BillingInvoice, BillingPanel, type BillingPanelProps, type BillingPaymentMethod, type BillingUsageMetric, BrandColorSwitchMinimal, Button, type ButtonProps, Card, type CardProps, Carousel, type CarouselProps, ChangelogCard, type ChangelogCardProps, type ChangelogHighlight, ChangelogList, type ChangelogListProps, type ChangelogReleaseType, Chart, type ChartProps, type ChartSeries, Checkbox, type CheckboxProps, CommandMenu, type CommandMenuGroup, type CommandMenuItem, type CommandMenuProps, type ComparisonColumn, ComparisonSection, type ComparisonSectionProps, ConfirmDialog, type ConfirmDialogProps, type ConfirmOptions, type ContactInfoItem, ContactSection, type ContactSectionProps, ContextMenu, type ContextMenuDef, type ContextMenuProps, CountUp, type CountUpProps, CountdownTimer, type CountdownTimerProps, CtaSection, type CtaSectionProps, DataTable, type DataTableProps, DataView, type DataViewProps, DevBanner, type DevBannerProps, Dock, type DockItem, type DockProps, EmptyState, type EmptyStateProps, ErrorPage, type ErrorPageProps, FadeIn, type FadeInProps, FaqSection, type FaqSectionProps, FeatureCard, type FeatureCardProps, type FeatureMarqueeItem, type FeatureMarqueeRow, FeatureMarqueeSection, type FeatureMarqueeSectionProps, FeaturesSection, type FeaturesSectionProps, FileUpload, type FileUploadEntry, type FileUploadProps, FlowBracket, type FlowBracketProps, FlowConnector, type FlowConnectorProps, Footer, type FooterProps, FullPageSpinner, GlassCard, type GlassCardProps, Grid, GridItem, type GridItemProps, type GridProps, type GroupedFeatureGroup, GroupedFeaturesSection, type GroupedFeaturesSectionProps, HeroSection, type HeroSectionProps, type Hotkey, ImageCard, type ImageCardProps, Input, type InputProps, LogoStrip, type LogoStripProps, type MarketingSectionSpacing, type MarketingSurface, MarketingSurfaceProvider, MediaCard, type MediaCardProps, ModeSwitchMinimal, Navbar, type NavbarProps, NewsletterSection, type NewsletterSectionProps, type NotificationItem, NotificationToast, type NotificationToastProps, NotificationsPopover, type NotificationsPopoverProps, type NotifyAction, type NotifyOptions, OlwibaUIProvider, type OlwibaUIProviderProps, type OnboardingStep, OnboardingWizard, type OnboardingWizardProps, Overlay, type OverlayProps, type OverlayVariant, PageHeader, type PageHeaderBackButton, type PageHeaderBreadcrumb, type PageHeaderProps, PageTransition, type PageTransitionProps, PhoneFrame, type PhoneFrameProps, type PostAuthor, PostCard, type PostCardProps, PostList, type PostListProps, PricingCard, type PricingCardProps, type PricingFeature, type PricingPlan, PricingSection, type PricingSectionProps, PublicPageFrame, type PublicPageFrameProps, type QualificationColumn, QualificationSection, type QualificationSectionProps, RegisterHotkeys, RootErrorFallback, Section, type SectionProps, SectionTitle, type SectionTitleProps, SettingsSection, type SettingsSectionProps, Sortable, type SortableProps, Spotlight, type SpotlightGroup, type SpotlightItem, type SpotlightProps, Stack, type StackProps, StaggerChildren, type StaggerChildrenProps, StatCard, type StatCardProps, StatsSection, type StatsSectionProps, type StepGroup, type StepItem, StepsSection, type StepsSectionProps, Suspensed, Switch, type SwitchProps, type TeamMember, type TeamMemberRecord, TeamMembersPanel, type TeamMembersPanelProps, TeamSection, type TeamSectionProps, type TechStackItem, TechStackSection, type TechStackSectionProps, TestimonialCard, type TestimonialCardProps, TestimonialsSection, type TestimonialsSectionProps, Textarea, type TextareaProps, ThemeColorUpdater, ThemeSwitchMinimal, type UIMode, Underlay, type UnderlayProps, type UnderlayVariant, UpdateBanner, type UpdateBannerProps, type UpgradeComparisonRow, UpgradePrompt, type UpgradePromptProps, type UseConfirmReturn, type UseControlledOpenReturn, type UsePaginationReturn, type UseViewModeReturn, VersionBanner, type ViewMode, ViewToggle, type ViewToggleProps, cn, marketingSectionSpacing, notify, useConfirm, useControlledOpen, useCopyToClipboard, useDebounce, useIntersectionObserver, useLocalStorage, useMarketingSurface, useMediaQuery, useMounted, useOlwibaUI, usePagination, useScrolledPast, useSectionSurface, useUIMode, useViewMode };
+export { ActivityFeed, type ActivityFeedItem, type ActivityFeedProps, AnimatedPill, type AnimatedPillProps, AnimatedSwap, type AnimatedSwapEffect, type AnimatedSwapProps, type AnimatedSwapSpec, AppContent, type AppContentProps, AppFooter, type AppFooterProps, AppGrid, AppGridCell, type AppGridCellProps, type AppGridColumns, type AppGridProps, type AppNavItem, AppPageHero, type AppPageHeroProps, AppScreen, AppShell, type AppShellAction, type AppShellBrand, type AppShellBreadcrumb, type AppShellHeaderControls, type AppShellHeaderStart, type AppShellProps, type AppShellRenderLink, type AppShellUser, type AuthFormProps, AuthSection, type AuthSectionProps, Badge, type BadgeProps, type BillingInvoice, BillingPanel, type BillingPanelProps, type BillingPaymentMethod, type BillingUsageMetric, BrandColorSwitchMinimal, Button, type ButtonProps, Card, type CardProps, Carousel, type CarouselProps, ChangelogCard, type ChangelogCardProps, type ChangelogHighlight, ChangelogList, type ChangelogListProps, type ChangelogReleaseType, Chart, type ChartProps, type ChartSeries, Checkbox, type CheckboxProps, CommandMenu, type CommandMenuGroup, type CommandMenuItem, type CommandMenuProps, type ComparisonColumn, ComparisonSection, type ComparisonSectionProps, ConfirmDialog, type ConfirmDialogProps, type ConfirmOptions, type ContactInfoItem, ContactSection, type ContactSectionProps, ContextMenu, type ContextMenuDef, type ContextMenuProps, CountUp, type CountUpProps, CountdownTimer, type CountdownTimerProps, CtaSection, type CtaSectionProps, DataTable, type DataTableProps, DataView, type DataViewProps, DevBanner, type DevBannerProps, Dock, type DockItem, type DockProps, EmptyState, type EmptyStateProps, ErrorPage, type ErrorPageProps, FadeIn, type FadeInProps, FaqSection, type FaqSectionProps, FeatureCard, type FeatureCardProps, type FeatureMarqueeItem, type FeatureMarqueeRow, FeatureMarqueeSection, type FeatureMarqueeSectionProps, FeaturesSection, type FeaturesSectionProps, FileUpload, type FileUploadEntry, type FileUploadProps, FlowBracket, type FlowBracketProps, FlowConnector, type FlowConnectorProps, Footer, type FooterProps, FullPageSpinner, GlassCard, type GlassCardProps, Grid, GridItem, type GridItemProps, type GridProps, type GroupedFeatureGroup, GroupedFeaturesSection, type GroupedFeaturesSectionProps, HeroSection, type HeroSectionProps, type Hotkey, ImageCard, type ImageCardProps, Input, type InputProps, LoadMore, type LoadMoreProps, LogoStrip, type LogoStripProps, type MarketingSectionSpacing, type MarketingSurface, MarketingSurfaceProvider, MediaCard, type MediaCardProps, ModeSwitchMinimal, Navbar, type NavbarProps, NewsletterSection, type NewsletterSectionProps, type NotificationItem, NotificationToast, type NotificationToastProps, NotificationsPopover, type NotificationsPopoverProps, type NotifyAction, type NotifyOptions, OlwibaUIProvider, type OlwibaUIProviderProps, type OnboardingStep, OnboardingWizard, type OnboardingWizardProps, Overlay, type OverlayProps, type OverlayVariant, PageHeader, type PageHeaderBackButton, type PageHeaderBreadcrumb, type PageHeaderProps, PageTransition, type PageTransitionProps, PhoneFrame, type PhoneFrameProps, type PostAuthor, PostCard, type PostCardProps, PostList, type PostListProps, PricingCard, type PricingCardProps, type PricingFeature, type PricingPlan, PricingSection, type PricingSectionProps, PublicPageFrame, type PublicPageFrameProps, type QualificationColumn, QualificationSection, type QualificationSectionProps, RegisterHotkeys, RootErrorFallback, Section, type SectionProps, SectionTitle, type SectionTitleProps, SettingsSection, type SettingsSectionProps, Sortable, type SortableProps, Spotlight, type SpotlightGroup, type SpotlightItem, type SpotlightProps, Stack, type StackProps, StaggerChildren, type StaggerChildrenProps, StatCard, type StatCardProps, StatsSection, type StatsSectionProps, type StepGroup, type StepItem, StepsSection, type StepsSectionProps, Suspensed, Switch, type SwitchProps, type TeamMember, type TeamMemberRecord, TeamMembersPanel, type TeamMembersPanelProps, TeamSection, type TeamSectionProps, type TechStackItem, TechStackSection, type TechStackSectionProps, TestimonialCard, type TestimonialCardProps, TestimonialsSection, type TestimonialsSectionProps, Textarea, type TextareaProps, ThemeColorUpdater, ThemeSwitchMinimal, type UIMode, Underlay, type UnderlayProps, type UnderlayVariant, UpdateBanner, type UpdateBannerProps, type UpgradeComparisonRow, UpgradePrompt, type UpgradePromptProps, type UseConfirmReturn, type UseControlledOpenReturn, type UsePaginationReturn, type UseViewModeReturn, VersionBanner, type ViewMode, ViewToggle, type ViewToggleProps, cn, marketingSectionSpacing, notify, useConfirm, useControlledOpen, useCopyToClipboard, useDebounce, useIntersectionObserver, useLocalStorage, useMarketingSurface, useMediaQuery, useMounted, useOlwibaUI, usePagination, useScrolledPast, useSectionSurface, useUIMode, useViewMode };