react-os-shell 3.26.0 → 4.0.0

package/dist/index.d.ts

@@ -954,6 +954,19 @@ declare function Desktop({ profile }: {
     profile: any;
 }): react_jsx_runtime.JSX.Element;
 
+interface MobileAppConfig {
+    /** Link the primary button opens — a native deep link, an App Store /
+     *  Play Store page, or a mobile-optimised web app. When omitted the screen
+     *  still renders (branding + message) but without a call-to-action. */
+    url?: string;
+    /** Primary button label. Defaults to `Open the app`. */
+    ctaLabel?: string;
+    /** Headline. Defaults to a message built from the product name. */
+    heading?: string;
+    /** Supporting copy under the headline. */
+    description?: string;
+}
+
 interface LayoutProps {
     /** Brand label rendered on the start-menu button. */
     productName?: string;
@@ -986,6 +999,11 @@ interface LayoutProps {
      *  (e.g. tasks due that day) inside the mini month calendar. When omitted
      *  the popover stays a plain date grid. */
     clockCalendar?: ClockCalendarConfig;
+    /** Mobile-app link shown on phone/tablet-portrait viewports in place of the
+     *  desktop chrome. The shell has no built-in touch UI — wire a link to your
+     *  dedicated mobile app here (see MobileAppConfig). When omitted, small
+     *  screens get a plain "best viewed on desktop" notice. */
+    mobileApp?: MobileAppConfig;
 }
 interface ClockCalendarConfig {
     /** Local dates (YYYY-MM-DD) to mark with a dot in the mini month grid —
@@ -1002,7 +1020,7 @@ interface ClockCalendarConfig {
         close: () => void;
     }) => ReactNode;
 }
-declare function Layout({ productName, productIcon, wallpapers, navSections, navIcons, sectionIcons, categories, notifications, search, taskbarTrayLeft, clockCalendar, }?: LayoutProps): react_jsx_runtime.JSX.Element;
+declare function Layout({ productName, productIcon, wallpapers, navSections, navIcons, sectionIcons, categories, notifications, search, taskbarTrayLeft, clockCalendar, mobileApp, }?: LayoutProps): react_jsx_runtime.JSX.Element;
 
 interface StartMenuProps {
     open: boolean;
@@ -1175,6 +1193,14 @@ interface EntityListProps<T> {
     isLoading: boolean;
     emptyState: ReactNode;
     totalCount?: number;
+    /** When true and no rows have loaded yet, render {@link ListLoadError}
+     *  (with a retry) instead of `emptyState` — so a failed fetch reads as an
+     *  error, not "nothing here". Wire `useInfiniteScroll`'s `isError`. A
+     *  mid-scroll next-page failure (rows already loaded) keeps the list.
+     *  Defaults to unset → behaviour unchanged for existing callers. */
+    isError?: boolean;
+    /** Retry handler for the error state — wire the data source's `refetch`. */
+    onRetry?: () => void;
     tableId: string;
     columns: EntityListColumn[];
     renderCell: (item: T, colKey: string) => ReactNode;
@@ -1366,6 +1392,26 @@ interface ListFooterProps {
  */
 declare function ListFooter({ selectedCount, loadedCount, totalCount, label, isFetchingMore, extra, }: ListFooterProps): react_jsx_runtime.JSX.Element;
 
+interface ListLoadErrorProps {
+    /** Bold heading. Defaults to "Couldn't load this list". */
+    title?: string;
+    /** Muted explanatory line. Defaults to a generic connection/retry message. */
+    message?: string;
+    /** When provided, renders a "Try again" button that calls it (wire the
+     *  data source's `refetch`). Omit for a static, non-retryable error. */
+    onRetry?: () => void;
+    /** Frame around the content, mirroring {@link EmptyState}: `dashed`
+     *  (default), `card` (bordered surface), or `none`. */
+    variant?: 'dashed' | 'card' | 'none';
+}
+/**
+ * ListLoadError — the error counterpart to `EmptyState` for data lists. Shown
+ * when a list's fetch fails (5xx, auth expiry, network) so an outage reads as
+ * an error with a retry affordance instead of a misleading "nothing here"
+ * empty state. Visual language mirrors `EmptyState`, tinted for error.
+ */
+declare function ListLoadError({ title, message, onRetry, variant, }: ListLoadErrorProps): react_jsx_runtime.JSX.Element;
+
 /**
  * Keyboard + shift-click navigation for table rows.
  *
@@ -1439,6 +1485,8 @@ declare function useInfiniteScroll<T>({ queryKey, fetchFn, extraParams, pageSize
     items: T[];
     totalCount: number;
     isLoading: boolean;
+    isError: boolean;
+    error: Error | null;
     isFetchingNextPage: boolean;
     hasNextPage: boolean;
     sentinelRef: react.RefObject<HTMLDivElement>;
@@ -1535,6 +1583,13 @@ interface SelectProps extends Omit<SelectHTMLAttributes<HTMLSelectElement>, 'onC
     invalid?: boolean;
     className?: string;
 }
+/**
+ * Raw native `<select>` styled to match the kit's inputs. This is the original
+ * Select — kept as the mobile rendering and exported for callers that need a
+ * real `HTMLSelectElement` (form posts, native attribute spread, focus).
+ */
+declare const NativeSelect: react.ForwardRefExoticComponent<SelectProps & react.RefAttributes<HTMLSelectElement>>;
+/** Smart Select: native `<select>` on touch, custom listbox on desktop. */
 declare const Select: react.ForwardRefExoticComponent<SelectProps & react.RefAttributes<HTMLSelectElement>>;
 
 interface CheckboxProps extends Omit<InputHTMLAttributes<HTMLInputElement>, 'type' | 'onChange' | 'checked' | 'className'> {
@@ -1925,9 +1980,15 @@ interface FilterBarProps {
     children?: ReactNode;
 }
 /**
- * FilterBar — a horizontal row of filter controls. Each filter renders a native
- * `<select>` or, for long lists, a glass-styled searchable dropdown; a "Clear
- * filters" button appears when any filter is active. Pair with `useFilters`.
+ * FilterBar — a horizontal row of filter controls. Each filter renders a custom
+ * listbox dropdown or, for long lists, a glass-styled searchable dropdown; a
+ * "Clear filters" button appears when any filter is active. Pair with
+ * `useFilters`.
+ *
+ * The short-list path used to render a native `<select>`, but a native select's
+ * OS popup swallows every key event while open — so list-page hotkeys died
+ * until it closed (BG#00421). PlainFilter is a custom listbox that keeps key
+ * events flowing to the page.
  */
 declare function FilterBar({ filters, values, onChange, onClear, children }: FilterBarProps): react_jsx_runtime.JSX.Element;
 /** Local filter-state helper: tracks active filter values + derived params. */
@@ -2631,4 +2692,4 @@ declare function useNewHotkey(callback: () => void): void;
  */
 declare function useEditHotkey(callback: (() => void) | null): void;
 
-export { ALT, ALT_SHIFT_D, ALT_SHIFT_E, ALT_SHIFT_N, Accordion, type AccordionItem, type AccordionProps, AuthScreen, type AuthScreenProps, Avatar, AvatarGroup, type AvatarGroupProps, type AvatarProps, type AvatarSize, type AvatarStatus, Banner, type BannerProps, type BannerTone, BarChart, type BarChartProps, BehaviorPanel, type BreadcrumbItem, Breadcrumbs, type BreadcrumbsProps, type BulkColumn, type BulkColumnKind, BulkImportGrid, type BulkImportGridProps, type BulkRow, Button, type ButtonProps, type ButtonSize, type ButtonVariant, CMD_A, CMD_DOT, CMD_ENTER, CMD_K, CMD_S, CancelButton, Card, type CardProps, type CellStyle, ChangePasswordForm, type ChangePasswordFormProps, type ChangelogEntry, ChatTemplate, Checkbox, type CheckboxProps, CheckoutTemplate, type ClockCalendarConfig, ColoredBadge, type ColoredBadgeProps, type ColumnDef, ConfirmProvider, ContainerFillChart, type ContainerFillChartProps, type ContainerFillItem, CopyButton, Customization, type CustomizationOmitSection, type CustomizationProps, type CustomizationSection, DEV_BANNER_TEXT, DashboardTemplate, DataTablePage, Desktop, type DesktopContextMenuItem, type DesktopHostConfig, DesktopHostProvider, DevIndicator, DocFavStar, DonutChart, type DonutChartProps, type DonutSegment, type DuplicateGroup, ENTER, EditableGrid, type EditableGridProps, EmailTemplate, EmptyState, type EmptyStateProps, type EntityFetcher, EntityList, type EntityListColumn, type EntityListContextAction, type EntityListProps, ErrorPage, type ErrorPageProps, FilterBar, type FilterOption, FormField, type FormFieldProps, FormLayoutPage, GLASS_DIVIDER, GLASS_INPUT_BG, GalleryTemplate, GlobalSearch, type GridColumn, type HealthCheckResult, HelpCenter, type HelpCenterDoc, type HelpCenterProps, INPUT_BASE, ImageAnnotator, type ImageAnnotatorHandle, type ImageAnnotatorProps, Input, type InputProps, Kanban, type KanbanColumn, type KanbanProps, Label, type LabelProps, Layout, type LayoutProps, ListFooter, LoadingSpinner, type LoadingSpinnerProps, MOD, Markdown, type MarkdownProps, MediaUploadField, type MediaUploadFieldProps, MediaUploadGrid, type MediaUploadGridItem, type MediaUploadGridProps, type MergeBulkOptions, type MergeBulkResult, MetricBar, type MetricBarProps, type Milestone, type MilestoneKind, MilestoneTimeline, type MilestoneTimelineProps, Modal, ModalActions, NotificationBell, type NotificationsConfig, PageHeader, type PageHeaderProps, type PaginatedResponse, Pagination, type PaginationProps, PdfActionButton, type PdfActionButtonProps, PopupMenu, PopupMenuDivider, PopupMenuItem, PopupMenuLabel, Radio, type RadioProps, ResizableTable, SHIFT, type SearchConfig, type SearchProvider, type SearchResult, type SearchableOption, SearchableSelect, type SearchableSelectProps, Select, type SelectOption, type SelectProps, type SemanticGroup, ServerStatusIndicator, type ServerStatusIndicatorProps, type ServerStatusUser, type SeverityTone, type ShellAuth, ShellAuthProvider, ShellEntityFetcherProvider, type ShellNotification, type ShellPrefsAdapter, ShellPrefsProvider, ShortcutHelp, SidebarActionButton, type SidebarActionButtonProps, SidebarGroupLabel, SidebarLayout, type SidebarLayoutProps, SidebarNavItem, type SortState, SoundsPanel, Sparkline, type SparklineProps, StartMenu, StatCard, type StatCardProps, StatusBadge, StatusBadgeProvider, type StickyEntityRef, type StickyResolver, SystemPreferences, type SystemPreferencesProps, type SystemPreferencesSection, type TabItem, Tabs, type TabsProps, Textarea, type TextareaProps, type TodoProvider, type TodoTask, Tooltip, type TooltipProps, TopNav, type TopNavItem, type TopNavProps, VERSION, WidgetManager, WindowCrashedFallback, WindowErrorBoundary, WindowManagerProvider, WindowRegistry, WindowTitle, applyDevTitle, commitExposeHighlight, confirm, confirmDestructive, createWindowRegistry, exitExposeMode, findDuplicateKeys, formatDate, getActiveWindowRoute, getExposeHighlight, getWindowPosition, glassStyle, inputClasses, isDevEnv, isMac, isSeverityTone, mediaFileName, mergeBulkItems, prompt, registerModalEscapeInterceptor, setExposeHighlight, setShellApiClient, setShellAuthBridge, setShellNavIcons, setShellTodoProvider, setWindowDefaultPosition, setWindowPosition, severityOf, subscribeExposeHighlight, toast, toggleExposeMode, useClickOutside, useColumnConfig, useDesktopHost, useEditHotkey, useFilters, useInfiniteScroll, useLocalStoragePrefs, useModalActive, useNewHotkey, useShellAuth, useShellEntityFetcher, useShellPrefs, useSort, useTableNav, useWidgetSettings, useWindowManager, useWindowMenuItem, useWindowTitle };
+export { ALT, ALT_SHIFT_D, ALT_SHIFT_E, ALT_SHIFT_N, Accordion, type AccordionItem, type AccordionProps, AuthScreen, type AuthScreenProps, Avatar, AvatarGroup, type AvatarGroupProps, type AvatarProps, type AvatarSize, type AvatarStatus, Banner, type BannerProps, type BannerTone, BarChart, type BarChartProps, BehaviorPanel, type BreadcrumbItem, Breadcrumbs, type BreadcrumbsProps, type BulkColumn, type BulkColumnKind, BulkImportGrid, type BulkImportGridProps, type BulkRow, Button, type ButtonProps, type ButtonSize, type ButtonVariant, CMD_A, CMD_DOT, CMD_ENTER, CMD_K, CMD_S, CancelButton, Card, type CardProps, type CellStyle, ChangePasswordForm, type ChangePasswordFormProps, type ChangelogEntry, ChatTemplate, Checkbox, type CheckboxProps, CheckoutTemplate, type ClockCalendarConfig, ColoredBadge, type ColoredBadgeProps, type ColumnDef, ConfirmProvider, ContainerFillChart, type ContainerFillChartProps, type ContainerFillItem, CopyButton, Customization, type CustomizationOmitSection, type CustomizationProps, type CustomizationSection, DEV_BANNER_TEXT, DashboardTemplate, DataTablePage, Desktop, type DesktopContextMenuItem, type DesktopHostConfig, DesktopHostProvider, DevIndicator, DocFavStar, DonutChart, type DonutChartProps, type DonutSegment, type DuplicateGroup, ENTER, EditableGrid, type EditableGridProps, EmailTemplate, EmptyState, type EmptyStateProps, type EntityFetcher, EntityList, type EntityListColumn, type EntityListContextAction, type EntityListProps, ErrorPage, type ErrorPageProps, FilterBar, type FilterOption, FormField, type FormFieldProps, FormLayoutPage, GLASS_DIVIDER, GLASS_INPUT_BG, GalleryTemplate, GlobalSearch, type GridColumn, type HealthCheckResult, HelpCenter, type HelpCenterDoc, type HelpCenterProps, INPUT_BASE, ImageAnnotator, type ImageAnnotatorHandle, type ImageAnnotatorProps, Input, type InputProps, Kanban, type KanbanColumn, type KanbanProps, Label, type LabelProps, Layout, type LayoutProps, ListFooter, ListLoadError, type ListLoadErrorProps, LoadingSpinner, type LoadingSpinnerProps, MOD, Markdown, type MarkdownProps, MediaUploadField, type MediaUploadFieldProps, MediaUploadGrid, type MediaUploadGridItem, type MediaUploadGridProps, type MergeBulkOptions, type MergeBulkResult, MetricBar, type MetricBarProps, type Milestone, type MilestoneKind, MilestoneTimeline, type MilestoneTimelineProps, type MobileAppConfig, Modal, ModalActions, NativeSelect, NotificationBell, type NotificationsConfig, PageHeader, type PageHeaderProps, type PaginatedResponse, Pagination, type PaginationProps, PdfActionButton, type PdfActionButtonProps, PopupMenu, PopupMenuDivider, PopupMenuItem, PopupMenuLabel, Radio, type RadioProps, ResizableTable, SHIFT, type SearchConfig, type SearchProvider, type SearchResult, type SearchableOption, SearchableSelect, type SearchableSelectProps, Select, type SelectOption, type SelectProps, type SemanticGroup, ServerStatusIndicator, type ServerStatusIndicatorProps, type ServerStatusUser, type SeverityTone, type ShellAuth, ShellAuthProvider, ShellEntityFetcherProvider, type ShellNotification, type ShellPrefsAdapter, ShellPrefsProvider, ShortcutHelp, SidebarActionButton, type SidebarActionButtonProps, SidebarGroupLabel, SidebarLayout, type SidebarLayoutProps, SidebarNavItem, type SortState, SoundsPanel, Sparkline, type SparklineProps, StartMenu, StatCard, type StatCardProps, StatusBadge, StatusBadgeProvider, type StickyEntityRef, type StickyResolver, SystemPreferences, type SystemPreferencesProps, type SystemPreferencesSection, type TabItem, Tabs, type TabsProps, Textarea, type TextareaProps, type TodoProvider, type TodoTask, Tooltip, type TooltipProps, TopNav, type TopNavItem, type TopNavProps, VERSION, WidgetManager, WindowCrashedFallback, WindowErrorBoundary, WindowManagerProvider, WindowRegistry, WindowTitle, applyDevTitle, commitExposeHighlight, confirm, confirmDestructive, createWindowRegistry, exitExposeMode, findDuplicateKeys, formatDate, getActiveWindowRoute, getExposeHighlight, getWindowPosition, glassStyle, inputClasses, isDevEnv, isMac, isSeverityTone, mediaFileName, mergeBulkItems, prompt, registerModalEscapeInterceptor, setExposeHighlight, setShellApiClient, setShellAuthBridge, setShellNavIcons, setShellTodoProvider, setWindowDefaultPosition, setWindowPosition, severityOf, subscribeExposeHighlight, toast, toggleExposeMode, useClickOutside, useColumnConfig, useDesktopHost, useEditHotkey, useFilters, useInfiniteScroll, useLocalStoragePrefs, useModalActive, useNewHotkey, useShellAuth, useShellEntityFetcher, useShellPrefs, useSort, useTableNav, useWidgetSettings, useWindowManager, useWindowMenuItem, useWindowTitle };