react-os-shell 3.8.3 → 3.8.5

package/dist/index.d.ts

@@ -1,9 +1,8 @@
-import { W as WindowRegistry } from './types-CTPtgkiG.js';
-export { M as ModalRegistryEntry, P as PageRegistryEntry, a as WindowRegistryEntry, i as isEntityEntry, b as isPageEntry, s as setShellWindowRegistry } from './types-CTPtgkiG.js';
+import { W as WindowRegistry } from './types-CXBKusuC.js';
+export { M as ModalRegistryEntry, P as PageRegistryEntry, a as WindowRegistryEntry, i as isEntityEntry, b as isPageEntry, s as setShellWindowRegistry } from './types-CXBKusuC.js';
 import * as react from 'react';
 import react__default, { ReactNode, Component, ErrorInfo, CSSProperties, Dispatch, SetStateAction, RefObject, ButtonHTMLAttributes, InputHTMLAttributes, TextareaHTMLAttributes, SelectHTMLAttributes, LabelHTMLAttributes } from 'react';
-import * as react_jsx_runtime from 'react/jsx-runtime';
-import * as _tanstack_query_core from '@tanstack/query-core';
+import * as _tanstack_react_query from '@tanstack/react-query';
 import { AxiosInstance } from 'axios';
 
 /**
@@ -90,7 +89,7 @@ declare function useWindowMenuItem(label: string, onClick: () => void, icon?: Re
  *  than React Context, which has separate instances in each bundle). */
 declare function WindowTitle({ title }: {
     title: string;
-}): react_jsx_runtime.JSX.Element;
+}): react.JSX.Element;
 /** @deprecated Use <WindowTitle> instead — the hook variant doesn't work
  *  across bundle boundaries (apps barrel has its own ModalIdContext). */
 declare function useWindowTitle(_title: string): void;
@@ -100,7 +99,7 @@ declare function useWindowTitle(_title: string): void;
  */
 declare function CopyButton({ text }: {
     text: string;
-}): react_jsx_runtime.JSX.Element;
+}): react.JSX.Element;
 /** Hook to check if the current modal is active (frontmost) */
 declare function useModalActive(): boolean;
 declare function ModalActions({ children, position }: {
@@ -115,7 +114,7 @@ declare function CancelButton({ onClick, children, className }: {
     onClick: () => void;
     children?: React.ReactNode;
     className?: string;
-}): react_jsx_runtime.JSX.Element;
+}): react.JSX.Element;
 /**
  * Seed an initial position for a window — applied only when no saved
  * position already exists for the given key. Use this from the consumer
@@ -247,7 +246,7 @@ declare function Modal({ open, onClose, title, icon, copyText, size, dirty, onNe
 declare function WindowCrashedFallback({ error, onReload }: {
     error: Error;
     onReload: () => void;
-}): react_jsx_runtime.JSX.Element;
+}): react.JSX.Element;
 interface WindowErrorBoundaryProps {
     children: ReactNode;
     /** Replaces the default inline {@link WindowCrashedFallback}. `reset`
@@ -274,7 +273,7 @@ declare class WindowErrorBoundary extends Component<WindowErrorBoundaryProps, {
     };
     componentDidCatch(error: Error, info: ErrorInfo): void;
     reset: () => void;
-    render(): string | number | boolean | Iterable<ReactNode> | react_jsx_runtime.JSX.Element | null | undefined;
+    render(): string | number | boolean | Iterable<ReactNode> | react.JSX.Element | null | undefined;
 }
 
 /**
@@ -296,7 +295,7 @@ interface PopupMenuProps {
     portal?: boolean;
 }
 /** Container for a popup menu — auto-clamps to stay within viewport */
-declare function PopupMenu({ children, style, className, onClose, minWidth, portal }: PopupMenuProps): react_jsx_runtime.JSX.Element;
+declare function PopupMenu({ children, style, className, onClose, minWidth, portal }: PopupMenuProps): react.JSX.Element;
 /** A clickable menu item */
 declare function PopupMenuItem({ onClick, children, className, danger, disabled }: {
     onClick?: () => void;
@@ -304,13 +303,13 @@ declare function PopupMenuItem({ onClick, children, className, danger, disabled
     className?: string;
     danger?: boolean;
     disabled?: boolean;
-}): react_jsx_runtime.JSX.Element;
+}): react.JSX.Element;
 /** A divider line between menu items */
-declare function PopupMenuDivider(): react_jsx_runtime.JSX.Element;
+declare function PopupMenuDivider(): react.JSX.Element;
 /** A section header label */
 declare function PopupMenuLabel({ children }: {
     children: ReactNode;
-}): react_jsx_runtime.JSX.Element;
+}): react.JSX.Element;
 
 interface ConfirmOptions {
     title?: string;
@@ -339,7 +338,7 @@ interface PromptOptions {
 declare const prompt: (opts: PromptOptions | string) => Promise<string | null>;
 declare function ConfirmProvider({ children }: {
     children: React.ReactNode;
-}): react_jsx_runtime.JSX.Element;
+}): react.JSX.Element;
 
 interface SearchResult {
     /** Category label, e.g. "Sales Order". */
@@ -365,9 +364,9 @@ interface SearchConfig {
 }
 interface GlobalSearchProps extends Partial<SearchConfig> {
 }
-declare function GlobalSearch({ providers, typeIcons, placeholder }?: GlobalSearchProps): react_jsx_runtime.JSX.Element | null;
+declare function GlobalSearch({ providers, typeIcons, placeholder }?: GlobalSearchProps): react.JSX.Element | null;
 
-declare function ShortcutHelp(): react_jsx_runtime.JSX.Element;
+declare function ShortcutHelp(): react.JSX.Element;
 
 /**
  * One help article. Generic shape — the consuming portal maps its own
@@ -412,13 +411,13 @@ interface HelpCenterProps {
  * Search is client-side: a case-insensitive substring match over title, body
  * and category label. While searching, matching groups auto-expand.
  */
-declare function HelpCenter({ docs, loading, categoryOrder, canEdit, onNew, onEdit, renderBody, emptyMessage, }: HelpCenterProps): react_jsx_runtime.JSX.Element;
+declare function HelpCenter({ docs, loading, categoryOrder, canEdit, onNew, onEdit, renderBody, emptyMessage, }: HelpCenterProps): react.JSX.Element;
 
 interface MarkdownProps {
     children: string;
     className?: string;
 }
-declare function Markdown({ children, className }: MarkdownProps): react_jsx_runtime.JSX.Element;
+declare function Markdown({ children, className }: MarkdownProps): react.JSX.Element;
 
 declare const isMac: boolean;
 /** Platform-aware modifier symbols */
@@ -507,7 +506,7 @@ interface EditableGridProps {
  * - Multi-cell paste from spreadsheets (Ctrl+V)
  * - Tab/Enter/Arrow keyboard navigation
  */
-declare function EditableGrid({ columns, data, onChange, onColumnsChange, fixedRows, minRows, maxHeight, cellStyles, onFocusChange, onSelectionChange }: EditableGridProps): react_jsx_runtime.JSX.Element;
+declare function EditableGrid({ columns, data, onChange, onColumnsChange, fixedRows, minRows, maxHeight, cellStyles, onFocusChange, onSelectionChange }: EditableGridProps): react.JSX.Element;
 
 /**
  * Two-pane layout with a drag-to-resize sidebar (left or right).
@@ -550,7 +549,7 @@ interface SidebarLayoutProps {
     /** Classes for the main content pane. Defaults to a white background. */
     contentClassName?: string;
 }
-declare function SidebarLayout({ sidebar, children, side, storageKey, defaultWidth, minWidth, maxWidth, className, sidebarClassName, contentClassName, }: SidebarLayoutProps): react_jsx_runtime.JSX.Element;
+declare function SidebarLayout({ sidebar, children, side, storageKey, defaultWidth, minWidth, maxWidth, className, sidebarClassName, contentClassName, }: SidebarLayoutProps): react.JSX.Element;
 
 interface SearchableOption {
     value: string;
@@ -592,7 +591,7 @@ interface SearchableSelectProps {
      *  Hidden while the user is typing so the search text stays legible. */
     rightAdornment?: ReactNode;
 }
-declare function SearchableSelect({ value, onChange, options, placeholder, emptyOptionLabel, className, disabled, id, allowFreeText, onSearchChange, rightAdornment, }: SearchableSelectProps): react_jsx_runtime.JSX.Element;
+declare function SearchableSelect({ value, onChange, options, placeholder, emptyOptionLabel, className, disabled, id, allowFreeText, onSearchChange, rightAdornment, }: SearchableSelectProps): react.JSX.Element;
 
 /**
  * Generic top navigation bar. A horizontal row of tab-style links with an
@@ -624,7 +623,7 @@ interface TopNavProps {
     actions?: ReactNode;
     className?: string;
 }
-declare function TopNav({ items, activeKey, onSelect, brand, actions, className }: TopNavProps): react_jsx_runtime.JSX.Element;
+declare function TopNav({ items, activeKey, onSelect, brand, actions, className }: TopNavProps): react.JSX.Element;
 
 /**
  * Generic breadcrumb trail. Self-contained and styled with the same Tailwind
@@ -653,7 +652,7 @@ interface BreadcrumbsProps {
     maxItems?: number;
     className?: string;
 }
-declare function Breadcrumbs({ items, separator, maxItems, className }: BreadcrumbsProps): react_jsx_runtime.JSX.Element | null;
+declare function Breadcrumbs({ items, separator, maxItems, className }: BreadcrumbsProps): react.JSX.Element | null;
 
 /** Generic notification shape consumed by the shell. Consumer-specific
  * fields live on `extra` (or just on additional properties — TS structural
@@ -693,17 +692,17 @@ interface NotificationsConfig {
 interface NotificationBellProps extends NotificationsConfig {
     popDirection?: 'left' | 'right';
 }
-declare function NotificationBell({ useUnreadCount, list, markRead, markAllRead, onItemClick, onViewAll, popDirection, }: NotificationBellProps): react_jsx_runtime.JSX.Element;
+declare function NotificationBell({ useUnreadCount, list, markRead, markAllRead, onItemClick, onViewAll, popDirection, }: NotificationBellProps): react.JSX.Element;
 
 type SemanticGroup = 'success' | 'active' | 'queued' | 'info' | 'pending' | 'warning' | 'danger' | 'draft' | 'neutral';
 declare function StatusBadgeProvider({ groups, children, }: {
     groups: Record<string, SemanticGroup>;
     children: ReactNode;
-}): react_jsx_runtime.JSX.Element;
+}): react.JSX.Element;
 interface StatusBadgeProps {
     status: string;
 }
-declare function StatusBadge({ status }: StatusBadgeProps): react_jsx_runtime.JSX.Element;
+declare function StatusBadge({ status }: StatusBadgeProps): react.JSX.Element;
 
 /**
  * System-tray badge shown only when the app is served from a developer's own
@@ -711,7 +710,7 @@ declare function StatusBadge({ status }: StatusBadgeProps): react_jsx_runtime.JS
  * slot — it renders nothing off-localhost, so it's safe to leave wired on every
  * build. Visibility is gated on the runtime hostname; see utils/env.ts.
  */
-declare function DevIndicator(): react_jsx_runtime.JSX.Element | null;
+declare function DevIndicator(): react.JSX.Element | null;
 
 /**
  * Dev-environment detection + browser chrome.
@@ -790,7 +789,7 @@ declare function DocFavStar({ entityType, entityId, label }: {
     entityType: string;
     entityId: string;
     label: string;
-}): react_jsx_runtime.JSX.Element;
+}): react.JSX.Element;
 /** Public, framework-free helper: route ('/orders', '/qc-reports', …)
  *  of the window the user is currently focused on. Returns undefined
  *  when no app window is active (start menu / dashboard with nothing
@@ -800,7 +799,7 @@ declare function DocFavStar({ entityType, entityId, label }: {
 declare function getActiveWindowRoute(): string | undefined;
 declare function WindowManagerProvider({ children }: {
     children: ReactNode;
-}): react_jsx_runtime.JSX.Element;
+}): react.JSX.Element;
 
 /**
  * INTERNAL stub — Desktop's About modal references the consumer-side
@@ -893,11 +892,11 @@ interface DesktopHostConfig {
 declare function DesktopHostProvider({ value, children }: {
     value: DesktopHostConfig;
     children: ReactNode;
-}): react_jsx_runtime.JSX.Element;
+}): react.JSX.Element;
 declare function useDesktopHost(): DesktopHostConfig;
 declare function Desktop({ profile }: {
     profile: any;
-}): react_jsx_runtime.JSX.Element;
+}): react.JSX.Element;
 
 interface LayoutProps {
     /** Brand label rendered on the start-menu button. */
@@ -947,7 +946,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, }?: LayoutProps): react.JSX.Element;
 
 interface StartMenuProps {
     open: boolean;
@@ -974,7 +973,7 @@ interface StartMenuProps {
     /** Section grouping + virtual flyouts (Utilities-style trays). */
     categories?: StartMenuCategories;
 }
-declare function StartMenu({ open, onClose, openPage, profile, user, onLogout, taskbarPosition, taskbarH, taskbarW, size, navSections, navIcons, sectionIcons, categories, }: StartMenuProps): react_jsx_runtime.JSX.Element | null;
+declare function StartMenu({ open, onClose, openPage, profile, user, onLogout, taskbarPosition, taskbarH, taskbarW, size, navSections, navIcons, sectionIcons, categories, }: StartMenuProps): react.JSX.Element | null;
 
 /**
  * Widget gallery — the "manage widgets on the desktop" surface.
@@ -994,7 +993,7 @@ declare function StartMenu({ open, onClose, openPage, profile, user, onLogout, t
 declare function WidgetManager({ open, onClose }: {
     open: boolean;
     onClose: () => void;
-}): react_jsx_runtime.JSX.Element | null;
+}): react.JSX.Element | null;
 
 /** Sections that can be omitted from the inline Customization page when the
  *  consumer renders them elsewhere (e.g. as separate entries in SystemPreferences). */
@@ -1008,7 +1007,7 @@ interface CustomizationProps {
     /** Render only one logical group of settings. Omit to render everything. */
     section?: CustomizationSection;
 }
-declare function Customization({ omit, section }?: CustomizationProps): react_jsx_runtime.JSX.Element;
+declare function Customization({ omit, section }?: CustomizationProps): react.JSX.Element;
 
 /**
  * Standalone Behavior settings panel — window position, double-click,
@@ -1018,7 +1017,7 @@ declare function Customization({ omit, section }?: CustomizationProps): react_js
  * Reads/writes shell prefs via `useShellPrefs()`. Suitable for use as a
  * section in `SystemPreferences` or rendered standalone.
  */
-declare function BehaviorPanel(): react_jsx_runtime.JSX.Element;
+declare function BehaviorPanel(): react.JSX.Element;
 
 /**
  * Standalone Sounds settings panel — sound effects toggle + per-event
@@ -1027,7 +1026,7 @@ declare function BehaviorPanel(): react_jsx_runtime.JSX.Element;
  * picked. Suitable as a section in `SystemPreferences` or rendered
  * standalone.
  */
-declare function SoundsPanel(): react_jsx_runtime.JSX.Element;
+declare function SoundsPanel(): react.JSX.Element;
 
 /** One section in the SystemPreferences sidebar. */
 interface SystemPreferencesSection {
@@ -1074,7 +1073,7 @@ interface SystemPreferencesProps {
  * ]} />
  * ```
  */
-declare function SystemPreferences({ sections, defaultSelected, className, }: SystemPreferencesProps): react_jsx_runtime.JSX.Element;
+declare function SystemPreferences({ sections, defaultSelected, className, }: SystemPreferencesProps): react.JSX.Element;
 
 interface ImageAnnotatorHandle {
     copy: () => Promise<void>;
@@ -1159,7 +1158,7 @@ interface EntityListProps<T> {
  *     emptyState={<EmptyState message="No suppliers yet." />}
  *   />
  */
-declare function EntityList<T>(props: EntityListProps<T>): react_jsx_runtime.JSX.Element;
+declare function EntityList<T>(props: EntityListProps<T>): react.JSX.Element;
 
 /**
  * Generic, drag-and-drop Kanban board. Self-contained (native HTML5 DnD, no
@@ -1221,7 +1220,7 @@ interface KanbanProps<T> {
     /** Label for the per-column add button. */
     addItemText?: string;
 }
-declare function Kanban<T>({ items, columns, columnOf, getId, onMove, renderCard, onCardClick, sortInColumn, isLoading, loadingText, emptyState, columnEmptyText, onAddItem, addItemText, }: KanbanProps<T>): react_jsx_runtime.JSX.Element;
+declare function Kanban<T>({ items, columns, columnOf, getId, onMove, renderCard, onCardClick, sortInColumn, isLoading, loadingText, emptyState, columnEmptyText, onAddItem, addItemText, }: KanbanProps<T>): react.JSX.Element;
 
 interface PaginatedResponse<T> {
     count: number;
@@ -1270,7 +1269,7 @@ interface ResizableTableProps {
  * - per-user persistence (via the shell-registered apiClient)
  * - mobile-aware selection mode toggle
  */
-declare function ResizableTable({ tableId, columns, sort, onSort, footer, afterBody, saveDefaultPerms, children, }: ResizableTableProps): react_jsx_runtime.JSX.Element;
+declare function ResizableTable({ tableId, columns, sort, onSort, footer, afterBody, saveDefaultPerms, children, }: ResizableTableProps): react.JSX.Element;
 
 interface ListFooterProps {
     selectedCount: number;
@@ -1286,7 +1285,7 @@ interface ListFooterProps {
  *   "Y of Z records · Loading more..."
  *   "All N records loaded"
  */
-declare function ListFooter({ selectedCount, loadedCount, totalCount, label, isFetchingMore, extra, }: ListFooterProps): react_jsx_runtime.JSX.Element;
+declare function ListFooter({ selectedCount, loadedCount, totalCount, label, isFetchingMore, extra, }: ListFooterProps): react.JSX.Element;
 
 /**
  * Keyboard + shift-click navigation for table rows.
@@ -1364,7 +1363,7 @@ declare function useInfiniteScroll<T>({ queryKey, fetchFn, extraParams, pageSize
     isFetchingNextPage: boolean;
     hasNextPage: boolean;
     sentinelRef: react.RefObject<HTMLDivElement>;
-    refetch: (options?: _tanstack_query_core.RefetchOptions) => Promise<_tanstack_query_core.QueryObserverResult<_tanstack_query_core.InfiniteData<PaginatedResponse<T>, unknown>, Error>>;
+    refetch: (options?: _tanstack_react_query.RefetchOptions) => Promise<_tanstack_react_query.QueryObserverResult<_tanstack_react_query.InfiniteData<PaginatedResponse<T>, unknown>, Error>>;
 };
 
 /**
@@ -1397,7 +1396,7 @@ interface PaginationProps {
     showEdges?: boolean;
     className?: string;
 }
-declare function Pagination({ page, pageCount, onPageChange, siblingCount, showEdges, className, }: PaginationProps): react_jsx_runtime.JSX.Element | null;
+declare function Pagination({ page, pageCount, onPageChange, siblingCount, showEdges, className, }: PaginationProps): react.JSX.Element | null;
 
 type ButtonVariant = 'primary' | 'secondary' | 'ghost' | 'danger';
 type ButtonSize = 'sm' | 'md';
@@ -1481,13 +1480,13 @@ interface FormFieldProps {
     className?: string;
     children: ReactNode;
 }
-declare function FormField({ label, htmlFor, hint, error, required, className, children, }: FormFieldProps): react_jsx_runtime.JSX.Element;
+declare function FormField({ label, htmlFor, hint, error, required, className, children, }: FormFieldProps): react.JSX.Element;
 
 interface LabelProps extends LabelHTMLAttributes<HTMLLabelElement> {
     /** Append a red asterisk. */
     required?: boolean;
 }
-declare function Label({ required, children, className, ...rest }: LabelProps): react_jsx_runtime.JSX.Element;
+declare function Label({ required, children, className, ...rest }: LabelProps): react.JSX.Element;
 
 /**
  * Shared form-control styling — the single source of truth for the kit's
@@ -1518,7 +1517,7 @@ interface CardProps {
     padded?: boolean;
     className?: string;
 }
-declare function Card({ children, header, footer, padded, className }: CardProps): react_jsx_runtime.JSX.Element;
+declare function Card({ children, header, footer, padded, className }: CardProps): react.JSX.Element;
 interface StatCardProps {
     label: ReactNode;
     value: ReactNode;
@@ -1530,7 +1529,7 @@ interface StatCardProps {
     };
     className?: string;
 }
-declare function StatCard({ label, value, icon, delta, className }: StatCardProps): react_jsx_runtime.JSX.Element;
+declare function StatCard({ label, value, icon, delta, className }: StatCardProps): react.JSX.Element;
 
 type AvatarSize = 'xs' | 'sm' | 'md' | 'lg';
 type AvatarStatus = 'online' | 'offline' | 'busy' | 'away';
@@ -1542,7 +1541,7 @@ interface AvatarProps {
     status?: AvatarStatus;
     className?: string;
 }
-declare function Avatar({ src, name, size, status, className }: AvatarProps): react_jsx_runtime.JSX.Element;
+declare function Avatar({ src, name, size, status, className }: AvatarProps): react.JSX.Element;
 interface AvatarGroupProps {
     children: ReactNode;
     /** Show at most this many avatars; the rest collapse into a +N chip. */
@@ -1552,7 +1551,7 @@ interface AvatarGroupProps {
     size?: AvatarSize;
     className?: string;
 }
-declare function AvatarGroup({ children, max, size, className }: AvatarGroupProps): react_jsx_runtime.JSX.Element;
+declare function AvatarGroup({ children, max, size, className }: AvatarGroupProps): react.JSX.Element;
 
 type BannerTone = 'info' | 'success' | 'warning' | 'danger';
 interface BannerProps {
@@ -1565,7 +1564,7 @@ interface BannerProps {
     onDismiss?: () => void;
     className?: string;
 }
-declare function Banner({ tone, title, children, icon, onDismiss, className }: BannerProps): react_jsx_runtime.JSX.Element;
+declare function Banner({ tone, title, children, icon, onDismiss, className }: BannerProps): react.JSX.Element;
 
 interface TabItem {
     id: string;
@@ -1580,7 +1579,7 @@ interface TabsProps {
     variant?: 'underline' | 'pill';
     className?: string;
 }
-declare function Tabs({ items, value, onChange, variant, className }: TabsProps): react_jsx_runtime.JSX.Element;
+declare function Tabs({ items, value, onChange, variant, className }: TabsProps): react.JSX.Element;
 
 interface AccordionItem {
     id: string;
@@ -1597,7 +1596,7 @@ interface AccordionProps {
     allowMultiple?: boolean;
     className?: string;
 }
-declare function Accordion({ items, defaultOpenIds, openIds, onOpenChange, allowMultiple, className, }: AccordionProps): react_jsx_runtime.JSX.Element;
+declare function Accordion({ items, defaultOpenIds, openIds, onOpenChange, allowMultiple, className, }: AccordionProps): react.JSX.Element;
 
 interface TooltipProps {
     content: ReactNode;
@@ -1606,7 +1605,7 @@ interface TooltipProps {
     delay?: number;
     children: ReactNode;
 }
-declare function Tooltip({ content, side, delay, children }: TooltipProps): react_jsx_runtime.JSX.Element;
+declare function Tooltip({ content, side, delay, children }: TooltipProps): react.JSX.Element;
 
 interface ColoredBadgeProps {
     /** Tailwind classes for the badge color, e.g. `bg-green-100 text-green-800`.
@@ -1625,7 +1624,7 @@ interface ColoredBadgeProps {
  * Tailwind class string. Generic counterpart to StatusBadge (which maps status
  * strings to semantic groups); use this when the caller already knows the color.
  */
-declare function ColoredBadge({ colorClass, children, size, capitalize }: ColoredBadgeProps): react_jsx_runtime.JSX.Element;
+declare function ColoredBadge({ colorClass, children, size, capitalize }: ColoredBadgeProps): react.JSX.Element;
 
 interface EmptyStateProps {
     /** Bold heading, e.g. "No invoices yet". */
@@ -1652,7 +1651,7 @@ interface EmptyStateProps {
  * copies: accepts both the `title`/`description` and `message`/`hint`/`frameless`
  * prop shapes, with a single unified look.
  */
-declare function EmptyState({ title, message, description, hint, variant, frameless, icon, children, }: EmptyStateProps): react_jsx_runtime.JSX.Element;
+declare function EmptyState({ title, message, description, hint, variant, frameless, icon, children, }: EmptyStateProps): react.JSX.Element;
 
 interface PageHeaderProps {
     title: string;
@@ -1669,7 +1668,7 @@ interface PageHeaderProps {
  * right-aligned actions slot. Accepts both the `description`/`actions` and the
  * `subtitle`/`children` prop shapes the portals previously used locally.
  */
-declare function PageHeader({ title, description, subtitle, actions, children }: PageHeaderProps): react_jsx_runtime.JSX.Element;
+declare function PageHeader({ title, description, subtitle, actions, children }: PageHeaderProps): react.JSX.Element;
 
 interface LoadingSpinnerProps {
     /** Ring diameter: `sm` = 20px, `md` = 32px (default), `lg` = 48px. */
@@ -1683,7 +1682,7 @@ interface LoadingSpinnerProps {
  * LoadingSpinner — a centered animated ring for pending/loading regions.
  * (Distinct from the shell's internal "Loading…" text used inside data grids.)
  */
-declare function LoadingSpinner({ size, padding, className }: LoadingSpinnerProps): react_jsx_runtime.JSX.Element;
+declare function LoadingSpinner({ size, padding, className }: LoadingSpinnerProps): react.JSX.Element;
 
 interface FilterOption {
     label: string;
@@ -1706,7 +1705,7 @@ interface FilterBarProps {
  * `<select>` or, for long lists, a glass-styled searchable dropdown; a "Clear
  * filters" button appears when any filter is active. Pair with `useFilters`.
  */
-declare function FilterBar({ filters, values, onChange, onClear, children }: FilterBarProps): react_jsx_runtime.JSX.Element;
+declare function FilterBar({ filters, values, onChange, onClear, children }: FilterBarProps): react.JSX.Element;
 /** Local filter-state helper: tracks active filter values + derived params. */
 declare function useFilters(): {
     filterValues: Record<string, string>;
@@ -1722,13 +1721,13 @@ declare function useFilters(): {
  */
 declare function SidebarGroupLabel({ children }: {
     children: ReactNode;
-}): react_jsx_runtime.JSX.Element;
+}): react.JSX.Element;
 declare function SidebarNavItem({ label, count, active, onClick }: {
     label: string;
     count?: number;
     active: boolean;
     onClick: () => void;
-}): react_jsx_runtime.JSX.Element;
+}): react.JSX.Element;
 
 /**
  * Semantic role of a column, used to auto-map CSV columns to fields and to
@@ -1780,7 +1779,7 @@ interface BulkImportGridProps {
  * column's `kind` (`price`/`qty`) to opt it into CSV auto-detection and the
  * totals strip.
  */
-declare function BulkImportGrid({ columns, onImport, description, mergeDuplicates }: BulkImportGridProps): react_jsx_runtime.JSX.Element;
+declare function BulkImportGrid({ columns, onImport, description, mergeDuplicates }: BulkImportGridProps): react.JSX.Element;
 
 /**
  * Pure helpers for reconciling a bulk-import grid (rows of string cells) against
@@ -1887,7 +1886,7 @@ interface ContainerFillChartProps<T = ContainerFillItem> {
  * `getVolume` to inject per-unit volumes; the chart owns the container math and
  * the instruction-vs-loaded dual-bar rendering.
  */
-declare function ContainerFillChart<T = ContainerFillItem>({ items, getVolume, qtyField, showNewIndicator, getInstructionQty, getActualQty, isFilled, isNew, className, style, }: ContainerFillChartProps<T>): react_jsx_runtime.JSX.Element | null;
+declare function ContainerFillChart<T = ContainerFillItem>({ items, getVolume, qtyField, showNewIndicator, getInstructionQty, getActualQty, isFilled, isNew, className, style, }: ContainerFillChartProps<T>): react.JSX.Element | null;
 
 /** Result of a single health poll. `latencyMs` is optional; when omitted on
  *  an ok result the indicator simply shows no latency for that poll. */
@@ -1932,7 +1931,7 @@ interface ServerStatusIndicatorProps {
  * notification bell; supply `healthCheck` (or `healthUrl`), `user`, and
  * `version` via a thin per-app wrapper.
  */
-declare function ServerStatusIndicator({ healthCheck, healthUrl, pollMs, requestTimeoutMs, user, version, }: ServerStatusIndicatorProps): react_jsx_runtime.JSX.Element;
+declare function ServerStatusIndicator({ healthCheck, healthUrl, pollMs, requestTimeoutMs, user, version, }: ServerStatusIndicatorProps): react.JSX.Element;
 
 interface ChangePasswordFormProps {
     /**
@@ -1959,7 +1958,7 @@ interface ChangePasswordFormProps {
  * Product-agnostic change-password form. The host supplies `onSubmit` to do the
  * actual change (e.g. call an API then re-authenticate).
  */
-declare function ChangePasswordForm({ onSubmit, onSuccess, confirmOnSuccess, minLength, submitLabel, doneLabel, }: ChangePasswordFormProps): react_jsx_runtime.JSX.Element;
+declare function ChangePasswordForm({ onSubmit, onSuccess, confirmOnSuccess, minLength, submitLabel, doneLabel, }: ChangePasswordFormProps): react.JSX.Element;
 
 interface PdfActionButtonProps {
     /**
@@ -2005,7 +2004,7 @@ interface PdfActionButtonProps {
  * recent-documents logging) are lifted to the optional `onEmail` /
  * `onPreviewOpened` callbacks.
  */
-declare function PdfActionButton({ fetchPdf, filename, label, className, disabled, onEmail, onPreviewOpened, icon, }: PdfActionButtonProps): react_jsx_runtime.JSX.Element;
+declare function PdfActionButton({ fetchPdf, filename, label, className, disabled, onEmail, onPreviewOpened, icon, }: PdfActionButtonProps): react.JSX.Element;
 
 /** Visual category for a milestone. Drives shape + colour so the user can
  *  tell different milestone types apart at a glance. */
@@ -2065,7 +2064,7 @@ interface MilestoneTimelineProps {
  * Product-agnostic: it takes generic `Milestone` data as props. Map your
  * domain records to the `Milestone` shape in a thin wrapper at the call site.
  */
-declare function MilestoneTimeline({ title, milestones, summary, endDate, phaseLabels }: MilestoneTimelineProps): react_jsx_runtime.JSX.Element;
+declare function MilestoneTimeline({ title, milestones, summary, endDate, phaseLabels }: MilestoneTimelineProps): react.JSX.Element;
 
 /**
  * Shared chart types. The charts are dependency-free inline SVG/CSS — color
@@ -2118,35 +2117,35 @@ interface DonutChartProps {
     style?: CSSProperties;
 }
 
-declare function Sparkline({ data, width, height, stroke, fill, strokeWidth, showDots, className, style, }: SparklineProps): react_jsx_runtime.JSX.Element | null;
+declare function Sparkline({ data, width, height, stroke, fill, strokeWidth, showDots, className, style, }: SparklineProps): react.JSX.Element | null;
 
-declare function BarChart({ data, labels, height, color, colors, max, gap, className, style, }: BarChartProps): react_jsx_runtime.JSX.Element | null;
+declare function BarChart({ data, labels, height, color, colors, max, gap, className, style, }: BarChartProps): react.JSX.Element | null;
 
-declare function DonutChart({ segments, size, thickness, centerLabel, className, style }: DonutChartProps): react_jsx_runtime.JSX.Element;
+declare function DonutChart({ segments, size, thickness, centerLabel, className, style }: DonutChartProps): react.JSX.Element;
 
-declare function DashboardTemplate(): react_jsx_runtime.JSX.Element;
+declare function DashboardTemplate(): react.JSX.Element;
 
-declare function DataTablePage(): react_jsx_runtime.JSX.Element;
+declare function DataTablePage(): react.JSX.Element;
 
-declare function FormLayoutPage(): react_jsx_runtime.JSX.Element;
+declare function FormLayoutPage(): react.JSX.Element;
 
-declare function CheckoutTemplate(): react_jsx_runtime.JSX.Element;
+declare function CheckoutTemplate(): react.JSX.Element;
 
-declare function EmailTemplate(): react_jsx_runtime.JSX.Element;
+declare function EmailTemplate(): react.JSX.Element;
 
-declare function ChatTemplate(): react_jsx_runtime.JSX.Element;
+declare function ChatTemplate(): react.JSX.Element;
 
-declare function GalleryTemplate(): react_jsx_runtime.JSX.Element;
+declare function GalleryTemplate(): react.JSX.Element;
 
 interface AuthScreenProps {
     mode?: 'login' | 'register' | 'forgot';
 }
-declare function AuthScreen({ mode }: AuthScreenProps): react_jsx_runtime.JSX.Element;
+declare function AuthScreen({ mode }: AuthScreenProps): react.JSX.Element;
 
 interface ErrorPageProps {
     code?: 403 | 404 | 500;
 }
-declare function ErrorPage({ code }: ErrorPageProps): react_jsx_runtime.JSX.Element;
+declare function ErrorPage({ code }: ErrorPageProps): react.JSX.Element;
 
 /** Package version, injected by tsup at build time. Stays as an empty
  *  string when the source is consumed without a build (e.g. tests). */
@@ -2159,7 +2158,7 @@ interface ShellAuth {
 declare function ShellAuthProvider({ value, children }: {
     value: ShellAuth;
     children: ReactNode;
-}): react_jsx_runtime.JSX.Element;
+}): react.JSX.Element;
 declare function useShellAuth(): ShellAuth;
 
 interface ShellPrefsAdapter {
@@ -2172,7 +2171,7 @@ interface ShellPrefsAdapter {
 declare function ShellPrefsProvider({ value, children, }: {
     value: ShellPrefsAdapter;
     children: ReactNode;
-}): react_jsx_runtime.JSX.Element;
+}): react.JSX.Element;
 /** Default localStorage-backed adapter — useful when the consumer doesn't
  *  ship a backend. Pass the result into <ShellPrefsProvider value={…}>.
  *
@@ -2189,7 +2188,7 @@ type EntityFetcher = (endpoint: string, id: string) => Promise<any>;
 declare function ShellEntityFetcherProvider({ value, children, }: {
     value: EntityFetcher;
     children: ReactNode;
-}): react_jsx_runtime.JSX.Element;
+}): react.JSX.Element;
 /** Returns the consumer-supplied entity fetcher, or a stub that throws
  *  on call. Components that fetch entities call this hook eagerly so any
  *  misconfiguration surfaces synchronously rather than at click-time. */

package/dist/index.js

@@ -1,20 +1,20 @@
 import { subscribePomo, getPomoSnapshot } from './chunk-F2KBTMSP.js';
 export { setShellTodoProvider } from './chunk-F2KBTMSP.js';
-import { PREVIEW_OPENED_EVENT, publishDesktopFolders, requestFilesTrashView, FolderGlyph, openPreviewFile, requestFilesDesktopFolderView, FileIconTile, hashGradient } from './chunk-Z6OFNDHV.js';
-export { Breadcrumbs } from './chunk-Z6OFNDHV.js';
+import { PREVIEW_OPENED_EVENT, publishDesktopFolders, requestFilesTrashView, FolderGlyph, openPreviewFile, requestFilesDesktopFolderView, FileIconTile, hashGradient } from './chunk-OY6GC3ZI.js';
+export { Breadcrumbs } from './chunk-OY6GC3ZI.js';
 import { SidebarLayout } from './chunk-VGTEM5RZ.js';
 export { SidebarLayout } from './chunk-VGTEM5RZ.js';
 import { playNotification, playStartup, soundsEnabled, getSoundConfig, SOUND_PACK_KEYS, SOUND_PACKS, SOUND_TYPES, SOUND_TYPE_LABELS, setSoundForType, previewSound, setAllSounds, playLogout } from './chunk-D7PYW2QS.js';
-import { setPdfPreview } from './chunk-76Y7ARZ6.js';
-export { ImageAnnotator_default as ImageAnnotator } from './chunk-76Y7ARZ6.js';
+import { setPdfPreview } from './chunk-S3ZVBCKK.js';
+export { ImageAnnotator_default as ImageAnnotator } from './chunk-S3ZVBCKK.js';
 import { toast_default } from './chunk-VENYVK3L.js';
 export { toast_default as toast } from './chunk-VENYVK3L.js';
-import { EditableGrid } from './chunk-G6GRIOEQ.js';
-export { EditableGrid } from './chunk-G6GRIOEQ.js';
+import { EditableGrid } from './chunk-3T75O6VR.js';
+export { EditableGrid } from './chunk-3T75O6VR.js';
 import { useAuth, useShellAuth } from './chunk-ADJ3CERD.js';
 export { ShellAuthProvider, setShellAuthBridge, useShellAuth } from './chunk-ADJ3CERD.js';
-import { APP_VERSION, VERSION } from './chunk-N4LKUQFC.js';
-export { VERSION } from './chunk-N4LKUQFC.js';
+import { APP_VERSION, VERSION } from './chunk-6FET2LA4.js';
+export { VERSION } from './chunk-6FET2LA4.js';
 import { useWindowManager, PopupMenu, PopupMenuLabel, PopupMenuDivider, PopupMenuItem, WINDOW_REGISTRY, isPageEntry, Modal, useShellPrefs, useIsMobile, ModalActions, useModalActive, client_default, LoadingSpinner, CancelButton, setWindowPosition, ThumbCard, activateModal } from './chunk-HJ5ZNXPB.js';
 export { CancelButton, CopyButton, DocFavStar, Modal, ModalActions, PopupMenu, PopupMenuDivider, PopupMenuItem, PopupMenuLabel, ShellPrefsProvider, WindowCrashedFallback, WindowErrorBoundary, WindowManagerProvider, WindowTitle, commitExposeHighlight, exitExposeMode, getActiveWindowRoute, getExposeHighlight, getWindowPosition, isEntityEntry, isPageEntry, registerModalEscapeInterceptor, setExposeHighlight, setShellApiClient, setShellWindowRegistry, setWindowDefaultPosition, setWindowPosition, subscribeExposeHighlight, toggleExposeMode, useLocalStoragePrefs, useModalActive, useShellPrefs, useWidgetSettings, useWindowManager, useWindowMenuItem, useWindowTitle } from './chunk-HJ5ZNXPB.js';
 export { ConfirmProvider, confirm, confirmDestructive, prompt } from './chunk-UBN4IUDE.js';
@@ -5351,8 +5351,8 @@ function useTableNav(items, onSelect, onToggle, onSelectAll, onSelectRange) {
         setFocusIdx(idx);
       }
     };
-    document.addEventListener("click", handler);
-    return () => document.removeEventListener("click", handler);
+    document.addEventListener("click", handler, true);
+    return () => document.removeEventListener("click", handler, true);
   }, []);
   useEffect(() => {
     const handler = (e) => {
@@ -6150,7 +6150,14 @@ function useInfiniteScroll({
     observer.observe(el);
     return () => observer.disconnect();
   }, [handleObserver]);
-  const allItems = (query.data?.pages.flatMap((page) => page?.results ?? []) ?? []).filter((x) => x != null);
+  const seenIds = /* @__PURE__ */ new Set();
+  const allItems = (query.data?.pages.flatMap((page) => page?.results ?? []) ?? []).filter((x) => x != null).filter((x) => {
+    const id = x.id;
+    if (id == null) return true;
+    if (seenIds.has(id)) return false;
+    seenIds.add(id);
+    return true;
+  });
   const totalCount = query.data?.pages[0]?.count ?? 0;
   return {
     items: allItems,