react-os-shell 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,642 @@
+import { W as WindowRegistry } from './types-CFIZ1_xt.js';
+export { M as ModalRegistryEntry, P as PageRegistryEntry, a as WindowRegistryEntry, i as isEntityEntry, b as isPageEntry, s as setShellWindowRegistry } from './types-CFIZ1_xt.js';
+import * as react from 'react';
+import { ReactNode, CSSProperties, RefObject } from 'react';
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { AxiosInstance } from 'axios';
+
+/**
+ * createWindowRegistry — composes a window registry from one or more partial
+ * registry maps. Used at the consumer's App layer to merge package-bundled
+ * apps with the consumer's own entity windows.
+ *
+ *   const windows = createWindowRegistry(
+ *     bundledApps,        // utility apps + games + Google apps from the package
+ *     entityWindows,      // consumer-defined entity windows (e.g. Sales Order, Invoice)
+ *   );
+ *
+ * Later partials override earlier ones on the same key — handy when a
+ * consumer wants to swap a built-in app for their own variant.
+ */
+
+declare function createWindowRegistry(...partials: WindowRegistry[]): WindowRegistry;
+
+/**
+ * Nav data types used by <Layout> + <StartMenu>. The actual sections, icons,
+ * and categories are consumer-supplied via Layout props — the package never
+ * ships nav DATA, only the shape it expects.
+ */
+
+interface NavItem {
+    to: string;
+    label: string;
+    perms?: string[];
+    dividerAfter?: boolean;
+}
+interface NavSection {
+    label: string;
+    items: NavItem[];
+    perms?: string[];
+    /** Optional landing route for clicks on the section title itself
+     *  (e.g. R&D's `/rd` dashboard). */
+    to?: string;
+}
+interface VirtualSection {
+    label: string;
+    items: NavItem[];
+    icon?: ReactNode;
+}
+interface StartMenuCategories {
+    /** Section labels rendered in the "ERP" group (bold, with section icon). */
+    erp: string[];
+    /** Section labels rendered in the "system" group. */
+    system: string[];
+    /** Optional virtual flyouts (e.g. a "Utilities" tray). */
+    virtual?: VirtualSection[];
+}
+
+/**
+ * INTERNAL stub — package-side compatibility for files that legacy-imported
+ * default nav data from `shell-config/nav`. The package never ships nav
+ * DATA; consumers always supply `navSections` / `navIcons` / `sectionIcons` /
+ * `categories` as Layout props.
+ *
+ * Empty defaults exported here so the copied files compile during the
+ * extraction transition. Each consumer-facing field is also re-exported as
+ * a TYPE alias for code that only needed the shape.
+ */
+
+declare function setShellNavIcons(icons: Record<string, ReactNode>): void;
+
+/** Hook for widget components to register a settings handler for the right-click menu. */
+declare function useWidgetSettings(handler: () => void): void;
+/** Hook to add custom items to the window title menu from inside a modal */
+declare function useWindowMenuItem(label: string, onClick: () => void, icon?: React.ReactNode): void;
+/** Component that updates the surrounding window's title bar. Render anywhere
+ *  inside a Modal-rendered page. Cross-bundle safe (uses DOM traversal rather
+ *  than React Context, which has separate instances in each bundle). */
+declare function WindowTitle({ title }: {
+    title: string;
+}): react_jsx_runtime.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;
+/**
+ * Portal component — renders children into the nearest Modal's footer actions area.
+ * position="left" for destructive actions (Delete), default is right for primary actions.
+ */
+declare function CopyButton({ text }: {
+    text: string;
+}): react_jsx_runtime.JSX.Element;
+/** Hook to check if the current modal is active (frontmost) */
+declare function useModalActive(): boolean;
+declare function ModalActions({ children, position }: {
+    children: React.ReactNode;
+    position?: 'left' | 'right';
+}): react.ReactPortal | null;
+/**
+ * Cancel button that checks for unsaved changes before calling onClick.
+ * Automatically detects dirty state from the nearest Modal context.
+ */
+declare function CancelButton({ onClick, children, className }: {
+    onClick: () => void;
+    children?: React.ReactNode;
+    className?: string;
+}): react_jsx_runtime.JSX.Element;
+interface ModalProps {
+    open: boolean;
+    onClose: () => void;
+    title: React.ReactNode;
+    /** Window icon — shown before title, clicking it opens window menu */
+    icon?: React.ReactNode;
+    /** Text to copy when the copy icon in the header is clicked (e.g. entity number) */
+    copyText?: string;
+    size?: 'sm' | 'md' | 'lg' | 'xl' | '2xl';
+    dirty?: boolean | 'auto';
+    onNext?: () => void;
+    onPrev?: () => void;
+    footer?: React.ReactNode;
+    /** When true, body uses overflow-hidden — child content manages its own scrolling */
+    bodyScroll?: false;
+    /** Custom minimize handler — called instead of the default global minimize */
+    onMinimize?: (savedBox: {
+        x: number;
+        y: number;
+        w: number;
+        h: number;
+        maximized: boolean;
+    }) => void;
+    /** Restore to a previously saved position/size */
+    initialBox?: {
+        x: number;
+        y: number;
+        w: number;
+        h: number;
+        maximized: boolean;
+    };
+    /** Footer actions (right side) — alternative to ModalActions portal */
+    actions?: React.ReactNode;
+    /** Footer actions (left side) — alternative to ModalActions portal */
+    actionsLeft?: React.ReactNode;
+    /** Allow the window to be pinned on top of all others */
+    allowPinOnTop?: boolean;
+    /** Initial position hint */
+    initialPosition?: 'top-right' | 'top-left';
+    /** Widget mode: no title/footer, drag anywhere, right-click context menu */
+    widget?: boolean;
+    /** Compact title bar: smaller header with title + close only, no minimize/maximize */
+    compact?: boolean;
+    /** Auto-size height based on content (widget only) */
+    autoHeight?: boolean;
+    /** Custom menu items for widget right-click context menu */
+    widgetMenu?: React.ReactNode;
+    /** Custom window dimensions [width, height] in pixels */
+    dimensions?: [number, number];
+    /** Stable key for persisting window position to sessionStorage */
+    windowKey?: string;
+    children: React.ReactNode;
+}
+declare function Modal({ open, onClose, title, icon, copyText, size, dirty, onNext, onPrev, footer, bodyScroll, onMinimize, initialBox, actions, actionsLeft, allowPinOnTop, initialPosition, widget, compact, autoHeight, widgetMenu, dimensions, windowKey, children }: ModalProps): react.ReactPortal | null;
+
+/**
+ * Unified popup menu component — used for all context menus, dropdowns, and flyouts.
+ * Reads --menu-density CSS variable: 'tight' or 'normal' (default).
+ */
+interface PopupMenuProps {
+    children: ReactNode;
+    style?: CSSProperties;
+    className?: string;
+    onClose?: () => void;
+    minWidth?: number;
+}
+/** Container for a popup menu — auto-clamps to stay within viewport */
+declare function PopupMenu({ children, style, className, onClose, minWidth }: PopupMenuProps): react_jsx_runtime.JSX.Element;
+/** A clickable menu item */
+declare function PopupMenuItem({ onClick, children, className, danger, disabled }: {
+    onClick?: () => void;
+    children: ReactNode;
+    className?: string;
+    danger?: boolean;
+    disabled?: boolean;
+}): react_jsx_runtime.JSX.Element;
+/** A divider line between menu items */
+declare function PopupMenuDivider(): react_jsx_runtime.JSX.Element;
+/** A section header label */
+declare function PopupMenuLabel({ children }: {
+    children: ReactNode;
+}): react_jsx_runtime.JSX.Element;
+
+interface ConfirmOptions {
+    title?: string;
+    message: string;
+    confirmLabel?: string;
+    cancelLabel?: string;
+    variant?: 'danger' | 'warning' | 'info';
+}
+declare const confirm: (opts: ConfirmOptions | string) => Promise<boolean>;
+interface DestructiveConfirmOptions {
+    title?: string;
+    message: string;
+    confirmWord: string;
+    variant?: 'danger' | 'warning';
+}
+declare const confirmDestructive: (opts: DestructiveConfirmOptions) => Promise<boolean>;
+declare function ConfirmProvider({ children }: {
+    children: React.ReactNode;
+}): react_jsx_runtime.JSX.Element;
+
+interface SearchResult {
+    /** Category label, e.g. "Sales Order". */
+    type: string;
+    /** Primary text shown in the result row. */
+    label: string;
+    /** Optional secondary line. */
+    sub?: string;
+    /** Window-registry key passed to openEntity. */
+    entity_type: string;
+    entity_id: string;
+}
+/** A search provider — given a query, returns matching results. The shell
+ *  calls every provider in parallel and concatenates the responses. */
+type SearchProvider = (query: string) => Promise<SearchResult[]>;
+/** Bundle of search-related consumer config. */
+interface SearchConfig {
+    providers: SearchProvider[];
+    /** Per-result-type icon (SVG path `d` attribute). Unmatched types fall
+     *  back to a generic magnifier glyph. */
+    typeIcons?: Record<string, string>;
+    placeholder?: string;
+}
+interface GlobalSearchProps extends Partial<SearchConfig> {
+}
+declare function GlobalSearch({ providers, typeIcons, placeholder }?: GlobalSearchProps): react_jsx_runtime.JSX.Element | null;
+
+declare function ShortcutHelp(): react_jsx_runtime.JSX.Element;
+
+declare const isMac: boolean;
+/** Platform-aware modifier symbols */
+declare const MOD: string;
+declare const ALT: string;
+declare const SHIFT = "\u21E7";
+declare const ENTER = "\u23CE";
+/** Common shortcut labels */
+declare const CMD_ENTER: string;
+declare const CMD_S: string;
+declare const CMD_K: string;
+declare const CMD_DOT: string;
+declare const CMD_A: string;
+declare const ALT_SHIFT_D: string;
+declare const ALT_SHIFT_E: string;
+declare const ALT_SHIFT_N: string;
+
+/**
+ * Two notification systems:
+ *
+ * 1. toast.success/error — operation feedback, top-center, auto-dismiss 3s
+ * 2. toast.info — system notification, top-right, stays 10s, dismissible
+ */
+declare const toast: {
+    success: (message: string) => void;
+    error: (message: string) => void;
+    info: (message: string, opts?: {
+        duration?: number;
+    }) => void;
+};
+
+/** Generic notification shape consumed by the shell. Consumer-specific
+ * fields live on `extra` (or just on additional properties — TS structural
+ * typing is permissive). */
+interface ShellNotification {
+    id: string;
+    title: string;
+    message?: string;
+    entity_type?: string;
+    entity_id?: string;
+    entity_label?: string;
+    is_read: boolean;
+    actor_name?: string;
+    created_at: string;
+}
+/** Config bundle for the notification system. Supplied by the consumer;
+ * the shell never calls a hardcoded URL. */
+interface NotificationsConfig {
+    /** Hook called inside <NotificationBell> on every render. Return the
+     *  current unread count for the signed-in user. */
+    useUnreadCount: () => number;
+    /** Fetcher for the dropdown list (most recent first). */
+    list: (params?: {
+        page_size?: number;
+    }) => Promise<{
+        results: ShellNotification[];
+    }>;
+    /** Mark a single notification as read. */
+    markRead: (id: string) => Promise<unknown>;
+    /** Mark every unread notification as read. */
+    markAllRead: () => Promise<unknown>;
+    /** Click handler for a notification item. */
+    onItemClick: (notif: ShellNotification) => void;
+    /** Click handler for "View all notifications". When omitted, the link is hidden. */
+    onViewAll?: () => void;
+}
+interface NotificationBellProps extends NotificationsConfig {
+    popDirection?: 'left' | 'right';
+}
+declare function NotificationBell({ useUnreadCount, list, markRead, markAllRead, onItemClick, onViewAll, popDirection, }: NotificationBellProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * Bug report review dialog — shows the captured screenshot and lets the user
+ * add a quick description before sending.
+ *
+ * Triggered imperatively from utils/reportBug.ts via openBugReportDialog().
+ * The Provider is mounted once at the App root.
+ */
+interface BugReportSubmission {
+    description: string;
+}
+/** Generic bug-report record shape consumed by the shell's list/detail UI. */
+interface BugReport {
+    id: string;
+    report_code?: string;
+    reporter_name?: string | null;
+    screenshot_url?: string | null;
+    url?: string;
+    user_agent?: string;
+    viewport?: string;
+    description?: string;
+    is_resolved: boolean;
+    resolution_note?: string;
+    created_at: string;
+    [k: string]: unknown;
+}
+/** Payload that <reportBug> sends to the consumer's `submit` callback. */
+interface BugReportSubmitPayload {
+    description?: string;
+    screenshot?: Blob;
+    url: string;
+    userAgent: string;
+    viewport: string;
+}
+/** Config bundle for the bug-report subsystem. Consumer-supplied; the shell
+ *  never calls a hardcoded URL. */
+interface BugReportConfig {
+    submit: (p: BugReportSubmitPayload) => Promise<unknown>;
+    /** Fetcher for the admin Bug Reports list. Receives query-string-shaped
+     *  params (e.g. `is_resolved=false`); paginated response. When omitted the
+     *  Bug Reports list page is unavailable. */
+    list?: (params?: Record<string, string>) => Promise<{
+        results: BugReport[];
+        count?: number;
+        next?: string | null;
+        previous?: string | null;
+    }>;
+    /** Mark a report resolved or reopened, with an optional admin note. */
+    resolve?: (id: string, is_resolved: boolean, resolution_note?: string) => Promise<BugReport>;
+}
+declare function BugReportConfigProvider({ value, children }: {
+    value: BugReportConfig;
+    children: ReactNode;
+}): react_jsx_runtime.JSX.Element;
+/** Returns the consumer-supplied bug-report config, or null when no provider
+ *  is mounted. Click handlers should hide their menu item if this is null. */
+declare function useBugReport(): BugReportConfig | null;
+type OpenFn = (screenshot: Blob | null) => Promise<BugReportSubmission | null>;
+declare const openBugReportDialog: OpenFn;
+declare function BugReportProvider({ children }: {
+    children: React.ReactNode;
+}): react_jsx_runtime.JSX.Element;
+
+interface Props {
+    report: BugReport;
+    onClose?: () => void;
+}
+declare function BugReportDetail({ report }: Props): react_jsx_runtime.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;
+interface StatusBadgeProps {
+    status: string;
+}
+declare function StatusBadge({ status }: StatusBadgeProps): react_jsx_runtime.JSX.Element;
+
+interface SavedBox {
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+    maximized: boolean;
+}
+interface MinimizedItem {
+    id: string;
+    type: 'part_number' | 'modal' | 'page';
+    label: string;
+    /** Route path for icon lookup (e.g. '/orders', '/invoices') */
+    route?: string;
+    savedBox?: SavedBox;
+    /** Entity registry key (e.g. 'order', 'manufacturer') for restore */
+    entityType?: string;
+    /** Entity UUID for API fetch on cross-page restore */
+    entityId?: string;
+    /** Cached entity data for instant rendering while refetch happens */
+    entitySnapshot?: any;
+}
+interface MinimizedContextType {
+    openWindows: MinimizedItem[];
+    openEntity: (entityType: string, entityId: string, snapshot?: any, label?: string, route?: string) => void;
+    openPage: (path: string) => void;
+    closeEntity: (id: string) => void;
+    /** @deprecated kept for backward compat — aliases openEntity/closeEntity */
+    minimize: (item: MinimizedItem) => void;
+    items: MinimizedItem[];
+    restore: (item: MinimizedItem) => void;
+    remove: (id: string) => void;
+    restoreIfMinimized: (label: string) => boolean;
+    openItems: MinimizedItem[];
+}
+declare function useWindowManager(): MinimizedContextType;
+/** Star button to favorite a document — saves to preferences.favorite_documents */
+declare function DocFavStar({ entityType, entityId, label }: {
+    entityType: string;
+    entityId: string;
+    label: string;
+}): react_jsx_runtime.JSX.Element;
+declare function WindowManagerProvider({ children }: {
+    children: ReactNode;
+}): react_jsx_runtime.JSX.Element;
+
+interface DesktopItem {
+    entityType: string;
+    entityId: string;
+    label: string;
+    x?: number;
+    y?: number;
+    folderId?: string;
+}
+interface DesktopFolder {
+    id: string;
+    name: string;
+    x?: number;
+    y?: number;
+}
+interface StickyEntityRef {
+    /** Window-registry key used by `openEntity`. */
+    entityType: string;
+    entityId: string;
+    /** Optional human-readable label (defaults to `${prefix}#${number}`). */
+    label?: string;
+    /** Optional pre-fetched entity payload passed to openEntity as snapshot. */
+    snapshot?: unknown;
+}
+type StickyResolver = (prefix: string, number: string) => Promise<StickyEntityRef | null>;
+interface DesktopHostConfig {
+    /** Product name shown in the About dialog and desktop context menu. */
+    productName?: string;
+    /** Tagline shown under the product name in the About dialog. */
+    productTagline?: string;
+    /** Icon URL shown in the About dialog. Defaults to `/favicon.svg`. */
+    productIcon?: string;
+    /** Copyright line in the About dialog footer. Hidden when omitted. */
+    productCopyright?: string;
+    /** Website URL in the About dialog footer. Hidden when omitted. */
+    productWebsite?: string;
+    /** Wallpaper picker options for the Customization settings page. */
+    wallpapers?: {
+        src: string;
+        label: string;
+    }[];
+    /** Resolves sticky-note refs (e.g. "SO#27150") to window-registry coords. */
+    stickyResolver?: StickyResolver;
+    /** Persists the user's desktop shortcut list. */
+    saveShortcuts?: (items: DesktopItem[]) => void | Promise<void>;
+    /** Persists the user's folder list. */
+    saveFolders?: (folders: DesktopFolder[]) => void | Promise<void>;
+    /** Persists the snap-to-grid preference. */
+    saveSnap?: (snap: boolean) => void | Promise<void>;
+    /** Persists the user's notepad / sticky-note content. */
+    saveNotes?: (notes: unknown[]) => void | Promise<void>;
+}
+declare function DesktopHostProvider({ value, children }: {
+    value: DesktopHostConfig;
+    children: ReactNode;
+}): react_jsx_runtime.JSX.Element;
+declare function useDesktopHost(): DesktopHostConfig;
+declare function Desktop({ profile }: {
+    profile: any;
+}): react_jsx_runtime.JSX.Element;
+
+interface LayoutProps {
+    /** Brand label rendered on the start-menu button. */
+    productName?: string;
+    /** Icon URL rendered next to the brand label. Defaults to `/favicon.svg`. */
+    productIcon?: string;
+    /** Wallpaper image URLs for the desktop background. When omitted, the
+     *  desktop renders with no image (just the dark fallback). */
+    wallpapers?: string[];
+    /** Override the default nav sections shown in the start menu. */
+    navSections?: (NavSection | NavItem)[];
+    /** Override the per-route icon map used by start menu and favorites. */
+    navIcons?: Record<string, ReactNode>;
+    /** Override the per-section header icon map used by start menu. */
+    sectionIcons?: Record<string, ReactNode>;
+    /** Override the start menu's section grouping + virtual flyouts. */
+    categories?: StartMenuCategories;
+    /** Notification system config — when omitted, the bell isn't rendered. */
+    notifications?: NotificationsConfig;
+    /** Universal search config — when omitted, Cmd-K opens the picker but no
+     *  results ever come back. */
+    search?: SearchConfig;
+}
+declare function Layout({ productName, productIcon, wallpapers, navSections, navIcons, sectionIcons, categories, notifications, search, }?: LayoutProps): react_jsx_runtime.JSX.Element;
+
+interface StartMenuProps {
+    open: boolean;
+    onClose: () => void;
+    openPage: (path: string) => void;
+    openWindows: {
+        route?: string;
+        label: string;
+    }[];
+    profile: any;
+    user: any;
+    onLogout: () => void;
+    onNavigate: (path: string) => void;
+    taskbarPosition: 'top' | 'bottom' | 'left' | 'right';
+    taskbarH: number;
+    taskbarW?: number;
+    size?: 'small' | 'medium' | 'large';
+    /** Override the default nav sections (sections + top-level items). */
+    navSections?: (NavSection | NavItem)[];
+    /** Per-route icon map for items in the menu. */
+    navIcons?: Record<string, ReactNode>;
+    /** Per-section header icon map. */
+    sectionIcons?: Record<string, ReactNode>;
+    /** 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 Customization(): react_jsx_runtime.JSX.Element;
+
+interface ShellAuth {
+    /** Returns true if the current user has any of the listed permission codes. */
+    hasAnyPerm: (perms: string[]) => boolean;
+}
+declare function ShellAuthProvider({ value, children }: {
+    value: ShellAuth;
+    children: ReactNode;
+}): react_jsx_runtime.JSX.Element;
+declare function useShellAuth(): ShellAuth;
+
+interface ShellPrefsAdapter {
+    /** The current prefs object. The shell reads its known keys directly off
+     *  this; consumer-private keys are ignored. */
+    prefs: Record<string, any>;
+    /** Patch a subset of prefs. The shell calls this with shallow diffs. */
+    save: (patch: Record<string, any>) => Promise<void> | void;
+}
+declare function ShellPrefsProvider({ value, children, }: {
+    value: ShellPrefsAdapter;
+    children: ReactNode;
+}): react_jsx_runtime.JSX.Element;
+/** Default localStorage-backed adapter — useful when the consumer doesn't
+ *  ship a backend. Pass the result into <ShellPrefsProvider value={…}>. */
+declare function useLocalStoragePrefs(storageKey?: string): ShellPrefsAdapter;
+/** Returns the active prefs adapter. When no provider is mounted, returns a
+ *  no-op adapter that reads as empty and silently drops saves — components
+ *  still render, but persistence is a no-op. */
+declare function useShellPrefs(): ShellPrefsAdapter;
+
+type EntityFetcher = (endpoint: string, id: string) => Promise<any>;
+declare function ShellEntityFetcherProvider({ value, children, }: {
+    value: EntityFetcher;
+    children: ReactNode;
+}): react_jsx_runtime.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. */
+declare function useShellEntityFetcher(): EntityFetcher;
+
+/**
+ * INTERNAL stub — bridges legacy `apiClient.get/patch('/auth/me/', ...)` calls
+ * inside the shell to the new <ShellPrefsProvider> contract. This keeps the
+ * package's copied source compiling without rewriting every call site at
+ * once; consumer-supplied prefs flow through `<ShellPrefsProvider>`.
+ *
+ * Outside calls (anything not hitting `/auth/me/`) need the consumer to mount
+ * <ShellEntityFetcherProvider> and wire `entityFetcher` on <WindowManager>.
+ *
+ * Long-term this file is removed when each call site migrates to
+ * `useShellPrefs()` directly.
+ */
+
+/** Consumer registers their own axios instance — typically the same one
+ *  they use elsewhere. The package only delegates HTTP to this. */
+declare function setShellApiClient(instance: AxiosInstance): void;
+
+interface ShellUser {
+    email?: string;
+    first_name?: string;
+    last_name?: string;
+    avatar_url?: string;
+}
+/** Consumer registers user-identity + logout handler once at app startup. */
+declare function setShellAuthBridge(bridge: {
+    user?: ShellUser;
+    logout?: () => void;
+}): void;
+
+/** Frosted glass style — shared across all menus, popups, and glass UI elements.
+ * Reads --menu-opacity CSS variable set by the theme system, and adapts the
+ * base tint to dark mode so menus don't stay light-cream when text is light. */
+declare function glassStyle(opacity?: number): CSSProperties;
+/** Glass divider border color */
+declare const GLASS_DIVIDER = "border-white/20";
+/** Glass input/search bar background */
+declare const GLASS_INPUT_BG = "bg-white/15";
+
+declare function reportBug(submit: BugReportConfig['submit']): Promise<void>;
+
+/**
+ * Format a date string (YYYY-MM-DD or ISO timestamp) for display.
+ * Returns '—' for null/empty values.
+ */
+declare function formatDate(value: string | null | undefined): string;
+
+declare function useClickOutside(ref: RefObject<HTMLElement | null>, onClose: () => void): void;
+
+/**
+ * Registers Alt+Shift+N (Windows) / Opt+Shift+N (Mac) hotkey to trigger a "New" action.
+ * Uses e.code (physical key) to avoid locale/modifier character issues.
+ */
+declare function useNewHotkey(callback: () => void): void;
+
+/**
+ * Registers Alt+Shift+E (Windows) / Opt+Shift+E (Mac) hotkey to trigger an "Edit" action.
+ * Uses e.code (physical key) to avoid locale/modifier character issues.
+ * Only fires for the active (frontmost) modal.
+ */
+declare function useEditHotkey(callback: (() => void) | null): void;
+
+export { ALT, ALT_SHIFT_D, ALT_SHIFT_E, ALT_SHIFT_N, type BugReport, type BugReportConfig, BugReportConfigProvider, BugReportDetail, BugReportProvider, type BugReportSubmission, type BugReportSubmitPayload, CMD_A, CMD_DOT, CMD_ENTER, CMD_K, CMD_S, CancelButton, ConfirmProvider, CopyButton, Customization, Desktop, type DesktopHostConfig, DesktopHostProvider, DocFavStar, ENTER, type EntityFetcher, GLASS_DIVIDER, GLASS_INPUT_BG, GlobalSearch, Layout, type LayoutProps, MOD, Modal, ModalActions, NotificationBell, type NotificationsConfig, PopupMenu, PopupMenuDivider, PopupMenuItem, PopupMenuLabel, SHIFT, type SearchConfig, type SearchProvider, type SearchResult, type SemanticGroup, type ShellAuth, ShellAuthProvider, ShellEntityFetcherProvider, type ShellNotification, type ShellPrefsAdapter, ShellPrefsProvider, ShortcutHelp, StartMenu, StatusBadge, StatusBadgeProvider, type StickyEntityRef, type StickyResolver, WindowManagerProvider, WindowRegistry, WindowTitle, confirm, confirmDestructive, createWindowRegistry, formatDate, glassStyle, isMac, openBugReportDialog, reportBug, setShellApiClient, setShellAuthBridge, setShellNavIcons, toast, useBugReport, useClickOutside, useDesktopHost, useEditHotkey, useLocalStoragePrefs, useModalActive, useNewHotkey, useShellAuth, useShellEntityFetcher, useShellPrefs, useWidgetSettings, useWindowManager, useWindowMenuItem, useWindowTitle };