@olwiba/ui 0.2.22 → 0.2.24

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import { ClassValue } from 'clsx';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as React from 'react';
-import React__default, { ReactNode } from 'react';
+import React__default, { ReactNode, HTMLAttributes } from 'react';
 import { ButtonProps as ButtonProps$1, CardProps as CardProps$1, BadgeProps as BadgeProps$1, InputProps as InputProps$1, TextareaProps as TextareaProps$1, CheckboxProps as CheckboxProps$1, SwitchProps as SwitchProps$1 } from '@olwiba/cn';
 export { CardContent, CardDescription, CardFooter, CardHeader, CardTitle, Enchanted, EnchantedProps } from '@olwiba/cn';
 import { LucideIcon } from 'lucide-react';
@@ -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;
@@ -247,18 +249,54 @@ type AppShellRenderLink = (props: {
     children: ReactNode;
     className?: string;
 }) => ReactNode;
+/**
+ * One step in the header location trail. A bare string is a plain label; give
+ * it an `href` to make it walkable. The final crumb is the current route and is
+ * never rendered as a link.
+ */
+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[];
     /** Primary CTA rendered above nav (e.g. "New project", "Quick create") */
     action?: AppShellAction;
     user?: AppShellUser;
-    /** Text shown in the top header bar */
+    /**
+     * Location context shown in the top header bar. This is app chrome, not the
+     * page address — the page (or its page pattern) owns the `<h1>`. Repeating
+     * the page title here prints the same words twice on every route.
+     */
     pageTitle?: string;
-    /** Slot rendered at the start of the top header bar, after the sidebar trigger. */
-    headerStart?: ReactNode;
+    /**
+     * Where the current route sits in the app, e.g.
+     * `[{ label: "Admin", href: "/admin" }, "Users"]`. Rendered as a muted trail
+     * and preferred over `pageTitle` when supplied.
+     */
+    breadcrumbs?: AppShellBreadcrumb[];
+    /**
+     * 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
+     * re-declares it and height-filling pages fight it for the remaining space.
+     */
+    footer?: ReactNode;
     /** Override link rendering for SPA navigation. Defaults to a native <a>. */
     renderLink?: AppShellRenderLink;
     children?: ReactNode;
@@ -275,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';
     /**
@@ -287,7 +329,7 @@ interface AppShellProps {
      */
     contentClassName?: string;
 }
-declare function AppShell({ brand, navItems, action, user, pageTitle, 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;
@@ -297,6 +339,15 @@ interface AppPageHeroProps {
     action?: ReactNode;
     children?: ReactNode;
     compact?: boolean;
+    /**
+     * How the address is drawn.
+     * - `"card"` (default) — a bordered surface that introduces the route.
+     * - `"plain"` — type only. Use when the page content is itself made of
+     *   surfaces: a second card at the top competes with them instead of
+     *   introducing them, and pushes the region that actually does something
+     *   further down the page.
+     */
+    surface?: 'card' | 'plain';
     className?: string;
 }
 /**
@@ -305,7 +356,26 @@ interface AppPageHeroProps {
  * Use this when a route needs more visual weight than a simple `PageHeader`,
  * but still keep product-specific stats, actions, and copy in the consumer.
  */
-declare function AppPageHero({ eyebrow, title, description, icon: Icon, action, children, compact, className, }: AppPageHeroProps): react_jsx_runtime.JSX.Element;
+declare function AppPageHero({ eyebrow, title, description, icon: Icon, action, children, compact, surface, className, }: AppPageHeroProps): react_jsx_runtime.JSX.Element;
+
+interface AppFooterProps extends HTMLAttributes<HTMLElement> {
+    /** Leading content — a product line, build info, a rotating message. */
+    start?: ReactNode;
+    /** Trailing content — a status pill, version, or a short link row. */
+    end?: ReactNode;
+}
+/**
+ * Quiet utility row for signed-in chrome.
+ *
+ * Pass it to `AppShell`'s `footer` slot: it is app chrome, so it lives beside
+ * 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 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;
 
 interface AuthFormProps {
     /**
@@ -475,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;
@@ -1448,6 +1526,20 @@ interface DataTableProps<TData> {
  */
 declare function DataTable<TData>({ columns, data, searchKey, searchPlaceholder, selectable, onSelectionChange, pageSize, 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 {
     view: ViewMode;
@@ -2008,7 +2100,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;
 }
@@ -2096,4 +2192,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, AppGrid, AppGridCell, type AppGridCellProps, type AppGridColumns, type AppGridProps, type AppNavItem, AppPageHero, type AppPageHeroProps, AppScreen, AppShell, type AppShellAction, type AppShellBrand, 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 };