react-os-shell 0.13.1 → 0.14.0

package/dist/{chunk-3SIZAHR6.js → chunk-OB7T3Q5C.js}

@@ -1,6 +1,6 @@
-import { setPdfPreview } from './chunk-DMSHU2HJ.js';
+import { setPdfPreview } from './chunk-K354WXU5.js';
 import { toast_default } from './chunk-WIJ45SYD.js';
-import { setSpreadsheetPreview } from './chunk-66GIT3PM.js';
+import { setSpreadsheetPreview } from './chunk-6DDVFASF.js';
 
 // src/utils/openPreviewFile.ts
 var PREVIEW_OPENED_EVENT = "react-os-shell:preview-opened";
@@ -42,5 +42,5 @@ async function openPreviewFile(opts) {
 }
 
 export { PREVIEW_OPENED_EVENT, openPreviewFile };
-//# sourceMappingURL=chunk-3SIZAHR6.js.map
-//# sourceMappingURL=chunk-3SIZAHR6.js.map
+//# sourceMappingURL=chunk-OB7T3Q5C.js.map
+//# sourceMappingURL=chunk-OB7T3Q5C.js.map

package/dist/{chunk-3SIZAHR6.js.map → chunk-OB7T3Q5C.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/utils/openPreviewFile.ts"],"names":[],"mappings":";;;;;AA6BO,IAAM,oBAAA,GAAuB;AAQpC,SAAS,SAAA,GAAY;AACnB,EAAA,MAAM,QAAA,GAAY,OAAO,MAAA,KAAW,WAAA,IAAgB,MAAA,CAAe,8BAAA;AACnE,EAAA,OAAA,CAAQ,QAAA,IAAY,uBAAA,EAAyB,OAAA,CAAQ,KAAA,EAAO,EAAE,CAAA;AAChE;AAEA,eAAsB,gBAAgB,IAAA,EAA6C;AACjF,EAAA,MAAM,EAAE,QAAA,EAAU,QAAA,EAAU,IAAA,EAAM,UAAS,GAAI,IAAA;AAC/C,EAAA,IAAI;AACF,IAAA,MAAM,MAAM,MAAM,KAAA;AAAA,MAChB,GAAG,SAAA,EAAW,CAAA,eAAA,EAAkB,kBAAA,CAAmB,QAAQ,CAAC,CAAA,CAAA;AAAA,MAC5D,EAAE,aAAa,SAAA;AAAU,KAC3B;AACA,IAAA,IAAI,CAAC,IAAI,EAAA,EAAI;AACX,MAAA,aAAA,CAAM,KAAA,CAAM,CAAA,iBAAA,EAAoB,GAAA,CAAI,MAAM,CAAA,CAAA,CAAG,CAAA;AAC7C,MAAA,OAAO,KAAA;AAAA,IACT;AACA,IAAA,MAAM,IAAA,GAAO,MAAM,GAAA,CAAI,IAAA,EAAK;AAC5B,IAAA,IAAI,SAAS,KAAA,EAAO;AAClB,MAAA,MAAM,IAAA,GAAO,MAAM,IAAA,CAAK,IAAA,EAAK;AAC7B,MAAA,qBAAA,CAAsB,EAAE,GAAA,EAAK,IAAA,EAAM,QAAA,EAAU,CAAA;AAC7C,MAAA,QAAA,GAAW,cAAc,CAAA;AAAA,IAC3B,CAAA,MAAO;AACL,MAAA,MAAM,GAAA,GAAM,GAAA,CAAI,eAAA,CAAgB,IAAI,CAAA;AACpC,MAAA,aAAA,CAAc,EAAE,GAAA,EAAK,QAAA,EAAU,IAAA,EAAM,CAAA;AACrC,MAAA,QAAA,GAAW,UAAU,CAAA;AAAA,IACvB;AACA,IAAA,IAAI,OAAO,WAAW,WAAA,EAAa;AACjC,MAAA,MAAA,CAAO,aAAA,CAAc,IAAI,WAAA,CAAiC,oBAAA,EAAsB;AAAA,QAC9E,MAAA,EAAQ,EAAE,QAAA,EAAU,QAAA,EAAU,IAAA;AAAK,OACpC,CAAC,CAAA;AAAA,IACJ;AACA,IAAA,OAAO,IAAA;AAAA,EACT,SAAS,CAAA,EAAQ;AACf,IAAA,aAAA,CAAM,KAAA,CAAM,CAAA,EAAG,OAAA,IAAW,aAAa,CAAA;AACvC,IAAA,OAAO,KAAA;AAAA,EACT;AACF","file":"chunk-3SIZAHR6.js","sourcesContent":["/**\n * Fetch a file from the user's file-server and route it into the right\n * preview window. Shared by the Files app and the desktop Documents\n * folder's shortcut click-through.\n *\n * On success, dispatches `react-os-shell:preview-opened` so Desktop can\n * record the file as a shortcut without this util needing access to the\n * prefs adapter.\n */\nimport toast from '../shell/toast';\nimport { setPdfPreview } from '../apps/Preview';\nimport { setSpreadsheetPreview } from '../apps/Spreadsheet';\n\nexport type PreviewFileKind = 'pdf' | 'dxf' | '3d' | 'image' | 'csv';\n\nexport interface OpenPreviewFileOpts {\n  /** Server-relative path, e.g. \"/reports/Q1.pdf\". */\n  filePath: string;\n  /** Display name (also used as the download filename). */\n  filename: string;\n  /** Which viewer to route into. CSV opens in Spreadsheet; the rest open in Preview. */\n  kind: PreviewFileKind;\n  /** Optional callback invoked after staging the preview, with the route to\n   *  open (e.g. '/preview' or '/spreadsheet'). The caller is responsible\n   *  for actually opening the page since the window manager hook is\n   *  React-scoped. */\n  onStaged?: (route: '/preview' | '/spreadsheet') => void;\n}\n\nexport const PREVIEW_OPENED_EVENT = 'react-os-shell:preview-opened';\n\nexport interface PreviewOpenedDetail {\n  filePath: string;\n  filename: string;\n  kind: PreviewFileKind;\n}\n\nfunction getServer() {\n  const override = (typeof window !== 'undefined' && (window as any).__REACT_OS_SHELL_FILE_SERVER__) as string | undefined;\n  return (override || 'http://localhost:4000').replace(/\\/$/, '');\n}\n\nexport async function openPreviewFile(opts: OpenPreviewFileOpts): Promise<boolean> {\n  const { filePath, filename, kind, onStaged } = opts;\n  try {\n    const res = await fetch(\n      `${getServer()}/api/file?path=${encodeURIComponent(filePath)}`,\n      { credentials: 'include' },\n    );\n    if (!res.ok) {\n      toast.error(`Download failed (${res.status})`);\n      return false;\n    }\n    const blob = await res.blob();\n    if (kind === 'csv') {\n      const text = await blob.text();\n      setSpreadsheetPreview({ csv: text, filename });\n      onStaged?.('/spreadsheet');\n    } else {\n      const url = URL.createObjectURL(blob);\n      setPdfPreview({ url, filename, kind });\n      onStaged?.('/preview');\n    }\n    if (typeof window !== 'undefined') {\n      window.dispatchEvent(new CustomEvent<PreviewOpenedDetail>(PREVIEW_OPENED_EVENT, {\n        detail: { filePath, filename, kind },\n      }));\n    }\n    return true;\n  } catch (e: any) {\n    toast.error(e?.message || 'Open failed');\n    return false;\n  }\n}\n"]}
+{"version":3,"sources":["../src/utils/openPreviewFile.ts"],"names":[],"mappings":";;;;;AA6BO,IAAM,oBAAA,GAAuB;AAQpC,SAAS,SAAA,GAAY;AACnB,EAAA,MAAM,QAAA,GAAY,OAAO,MAAA,KAAW,WAAA,IAAgB,MAAA,CAAe,8BAAA;AACnE,EAAA,OAAA,CAAQ,QAAA,IAAY,uBAAA,EAAyB,OAAA,CAAQ,KAAA,EAAO,EAAE,CAAA;AAChE;AAEA,eAAsB,gBAAgB,IAAA,EAA6C;AACjF,EAAA,MAAM,EAAE,QAAA,EAAU,QAAA,EAAU,IAAA,EAAM,UAAS,GAAI,IAAA;AAC/C,EAAA,IAAI;AACF,IAAA,MAAM,MAAM,MAAM,KAAA;AAAA,MAChB,GAAG,SAAA,EAAW,CAAA,eAAA,EAAkB,kBAAA,CAAmB,QAAQ,CAAC,CAAA,CAAA;AAAA,MAC5D,EAAE,aAAa,SAAA;AAAU,KAC3B;AACA,IAAA,IAAI,CAAC,IAAI,EAAA,EAAI;AACX,MAAA,aAAA,CAAM,KAAA,CAAM,CAAA,iBAAA,EAAoB,GAAA,CAAI,MAAM,CAAA,CAAA,CAAG,CAAA;AAC7C,MAAA,OAAO,KAAA;AAAA,IACT;AACA,IAAA,MAAM,IAAA,GAAO,MAAM,GAAA,CAAI,IAAA,EAAK;AAC5B,IAAA,IAAI,SAAS,KAAA,EAAO;AAClB,MAAA,MAAM,IAAA,GAAO,MAAM,IAAA,CAAK,IAAA,EAAK;AAC7B,MAAA,qBAAA,CAAsB,EAAE,GAAA,EAAK,IAAA,EAAM,QAAA,EAAU,CAAA;AAC7C,MAAA,QAAA,GAAW,cAAc,CAAA;AAAA,IAC3B,CAAA,MAAO;AACL,MAAA,MAAM,GAAA,GAAM,GAAA,CAAI,eAAA,CAAgB,IAAI,CAAA;AACpC,MAAA,aAAA,CAAc,EAAE,GAAA,EAAK,QAAA,EAAU,IAAA,EAAM,CAAA;AACrC,MAAA,QAAA,GAAW,UAAU,CAAA;AAAA,IACvB;AACA,IAAA,IAAI,OAAO,WAAW,WAAA,EAAa;AACjC,MAAA,MAAA,CAAO,aAAA,CAAc,IAAI,WAAA,CAAiC,oBAAA,EAAsB;AAAA,QAC9E,MAAA,EAAQ,EAAE,QAAA,EAAU,QAAA,EAAU,IAAA;AAAK,OACpC,CAAC,CAAA;AAAA,IACJ;AACA,IAAA,OAAO,IAAA;AAAA,EACT,SAAS,CAAA,EAAQ;AACf,IAAA,aAAA,CAAM,KAAA,CAAM,CAAA,EAAG,OAAA,IAAW,aAAa,CAAA;AACvC,IAAA,OAAO,KAAA;AAAA,EACT;AACF","file":"chunk-OB7T3Q5C.js","sourcesContent":["/**\n * Fetch a file from the user's file-server and route it into the right\n * preview window. Shared by the Files app and the desktop Documents\n * folder's shortcut click-through.\n *\n * On success, dispatches `react-os-shell:preview-opened` so Desktop can\n * record the file as a shortcut without this util needing access to the\n * prefs adapter.\n */\nimport toast from '../shell/toast';\nimport { setPdfPreview } from '../apps/Preview';\nimport { setSpreadsheetPreview } from '../apps/Spreadsheet';\n\nexport type PreviewFileKind = 'pdf' | 'dxf' | '3d' | 'image' | 'csv';\n\nexport interface OpenPreviewFileOpts {\n  /** Server-relative path, e.g. \"/reports/Q1.pdf\". */\n  filePath: string;\n  /** Display name (also used as the download filename). */\n  filename: string;\n  /** Which viewer to route into. CSV opens in Spreadsheet; the rest open in Preview. */\n  kind: PreviewFileKind;\n  /** Optional callback invoked after staging the preview, with the route to\n   *  open (e.g. '/preview' or '/spreadsheet'). The caller is responsible\n   *  for actually opening the page since the window manager hook is\n   *  React-scoped. */\n  onStaged?: (route: '/preview' | '/spreadsheet') => void;\n}\n\nexport const PREVIEW_OPENED_EVENT = 'react-os-shell:preview-opened';\n\nexport interface PreviewOpenedDetail {\n  filePath: string;\n  filename: string;\n  kind: PreviewFileKind;\n}\n\nfunction getServer() {\n  const override = (typeof window !== 'undefined' && (window as any).__REACT_OS_SHELL_FILE_SERVER__) as string | undefined;\n  return (override || 'http://localhost:4000').replace(/\\/$/, '');\n}\n\nexport async function openPreviewFile(opts: OpenPreviewFileOpts): Promise<boolean> {\n  const { filePath, filename, kind, onStaged } = opts;\n  try {\n    const res = await fetch(\n      `${getServer()}/api/file?path=${encodeURIComponent(filePath)}`,\n      { credentials: 'include' },\n    );\n    if (!res.ok) {\n      toast.error(`Download failed (${res.status})`);\n      return false;\n    }\n    const blob = await res.blob();\n    if (kind === 'csv') {\n      const text = await blob.text();\n      setSpreadsheetPreview({ csv: text, filename });\n      onStaged?.('/spreadsheet');\n    } else {\n      const url = URL.createObjectURL(blob);\n      setPdfPreview({ url, filename, kind });\n      onStaged?.('/preview');\n    }\n    if (typeof window !== 'undefined') {\n      window.dispatchEvent(new CustomEvent<PreviewOpenedDetail>(PREVIEW_OPENED_EVENT, {\n        detail: { filePath, filename, kind },\n      }));\n    }\n    return true;\n  } catch (e: any) {\n    toast.error(e?.message || 'Open failed');\n    return false;\n  }\n}\n"]}

package/dist/index.d.ts

@@ -497,6 +497,67 @@ interface SidebarLayoutProps {
 }
 declare function SidebarLayout({ sidebar, children, side, storageKey, defaultWidth, minWidth, maxWidth, className, sidebarClassName, contentClassName, }: SidebarLayoutProps): react_jsx_runtime.JSX.Element;
 
+/**
+ * Generic top navigation bar. A horizontal row of tab-style links with an
+ * optional brand on the left and free-form actions on the right. Self-contained
+ * and styled with the shell's Tailwind utilities, so it themes for free.
+ *
+ * Controlled: pass `activeKey` and handle `onSelect`. The active item gets an
+ * accent underline. Items can carry an `icon`, a `badge` (e.g. a count) and be
+ * `disabled`.
+ */
+interface TopNavItem {
+    /** Stable key — what `onSelect` receives and `activeKey` matches. */
+    key: string;
+    label: ReactNode;
+    /** Optional leading icon (typically a 4×4 svg). */
+    icon?: ReactNode;
+    /** Optional trailing badge — a count, dot, "New", etc. */
+    badge?: ReactNode;
+    disabled?: boolean;
+}
+interface TopNavProps {
+    items: TopNavItem[];
+    /** Key of the active item — it gets the accent underline. */
+    activeKey?: string;
+    onSelect?: (key: string) => void;
+    /** Left slot — logo / product title. */
+    brand?: ReactNode;
+    /** Right slot — actions (buttons, search, avatar…). Pinned to the far right. */
+    actions?: ReactNode;
+    className?: string;
+}
+declare function TopNav({ items, activeKey, onSelect, brand, actions, className }: TopNavProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * Generic breadcrumb trail. Self-contained and styled with the same Tailwind
+ * utilities the shell already ships, so consumers get it for free.
+ *
+ * Pass an ordered list of `items` from root → current. Every crumb except the
+ * last renders as a button when it has an `onClick`; the last crumb is treated
+ * as the current location — rendered inert with `aria-current="page"`. When the
+ * trail is long, set `maxItems` to collapse the middle into an ellipsis
+ * (`first … last-n` ), keeping the first and the tail visible.
+ */
+interface BreadcrumbItem {
+    /** Visible label. */
+    label: ReactNode;
+    /** Optional leading icon (typically a 3.5×3.5 svg). */
+    icon?: ReactNode;
+    /** Navigate to this crumb. Omitted on the current (last) crumb. */
+    onClick?: () => void;
+}
+interface BreadcrumbsProps {
+    items: BreadcrumbItem[];
+    /** Node rendered between crumbs. Defaults to a chevron. */
+    separator?: ReactNode;
+    /** Collapse the middle to an ellipsis when there are more than this many
+     *  crumbs. `0` (default) never collapses. */
+    maxItems?: number;
+    className?: string;
+}
+declare function Breadcrumbs({ items, separator, maxItems, className }: BreadcrumbsProps): react_jsx_runtime.JSX.Element | null;
+
 /** Generic notification shape consumed by the shell. Consumer-specific
  * fields live on `extra` (or just on additional properties — TS structural
  * typing is permissive). */
@@ -929,10 +990,16 @@ declare function WidgetManager({ open, onClose }: {
 /** Sections that can be omitted from the inline Customization page when the
  *  consumer renders them elsewhere (e.g. as separate entries in SystemPreferences). */
 type CustomizationOmitSection = 'behavior' | 'desktop';
+/** A logical group of the Customization page. Pass `section` to render only one
+ *  group, so the page can be split across separate SystemPreferences entries
+ *  (Appearance / Layout / Behavior). Omit `section` to render the whole page. */
+type CustomizationSection = 'appearance' | 'layout' | 'behavior';
 interface CustomizationProps {
     omit?: readonly CustomizationOmitSection[];
+    /** Render only one logical group of settings. Omit to render everything. */
+    section?: CustomizationSection;
 }
-declare function Customization({ omit }?: CustomizationProps): react_jsx_runtime.JSX.Element;
+declare function Customization({ omit, section }?: CustomizationProps): react_jsx_runtime.JSX.Element;
 
 /**
  * Standalone Behavior settings panel — window position, double-click,
@@ -1437,4 +1504,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, BehaviorPanel, type BugReport, type BugReportConfig, BugReportConfigProvider, BugReportDetail, type BugReportExtraField, type BugReportExtraSelectField, BugReportProvider, type BugReportSubmission, type BugReportSubmitPayload, CMD_A, CMD_DOT, CMD_ENTER, CMD_K, CMD_S, CancelButton, type CellStyle, type ChangelogEntry, type ColumnDef, ConfirmProvider, CopyButton, Customization, type CustomizationOmitSection, type CustomizationProps, DEV_BANNER_TEXT, Desktop, type DesktopHostConfig, DesktopHostProvider, DevIndicator, DocFavStar, ENTER, EditableGrid, type EditableGridProps, type EntityFetcher, EntityList, type EntityListColumn, type EntityListProps, GLASS_DIVIDER, GLASS_INPUT_BG, GlobalSearch, type GridColumn, HelpCenter, type HelpCenterDoc, type HelpCenterProps, Kanban, type KanbanColumn, type KanbanProps, Layout, type LayoutProps, ListFooter, MOD, Markdown, type MarkdownProps, Modal, ModalActions, NotificationBell, type NotificationsConfig, type PaginatedResponse, PopupMenu, PopupMenuDivider, PopupMenuItem, PopupMenuLabel, type ReportType, ResizableTable, SHIFT, type SearchConfig, type SearchProvider, type SearchResult, type SemanticGroup, type ShellAuth, ShellAuthProvider, ShellEntityFetcherProvider, type ShellNotification, type ShellPrefsAdapter, ShellPrefsProvider, ShortcutHelp, SidebarLayout, type SidebarLayoutProps, type SortState, SoundsPanel, StartMenu, StatusBadge, StatusBadgeProvider, type StickyEntityRef, type StickyResolver, SystemPreferences, type SystemPreferencesProps, type SystemPreferencesSection, type TodoProvider, type TodoTask, VERSION, WidgetManager, WindowManagerProvider, WindowRegistry, WindowTitle, applyDevTitle, commitExposeHighlight, confirm, confirmDestructive, createWindowRegistry, exitExposeMode, formatDate, getActiveWindowRoute, getExposeHighlight, getWindowPosition, glassStyle, isDevEnv, isMac, openBugReportDialog, prompt, reportBug, setExposeHighlight, setShellApiClient, setShellAuthBridge, setShellNavIcons, setShellTodoProvider, setWindowDefaultPosition, setWindowPosition, subscribeExposeHighlight, toast, toggleExposeMode, useBugReport, useClickOutside, useColumnConfig, useDesktopHost, useEditHotkey, useInfiniteScroll, useLocalStoragePrefs, useModalActive, useNewHotkey, useShellAuth, useShellEntityFetcher, useShellPrefs, useSort, useTableNav, useWidgetSettings, useWindowManager, useWindowMenuItem, useWindowTitle };
+export { ALT, ALT_SHIFT_D, ALT_SHIFT_E, ALT_SHIFT_N, BehaviorPanel, type BreadcrumbItem, Breadcrumbs, type BreadcrumbsProps, type BugReport, type BugReportConfig, BugReportConfigProvider, BugReportDetail, type BugReportExtraField, type BugReportExtraSelectField, BugReportProvider, type BugReportSubmission, type BugReportSubmitPayload, CMD_A, CMD_DOT, CMD_ENTER, CMD_K, CMD_S, CancelButton, type CellStyle, type ChangelogEntry, type ColumnDef, ConfirmProvider, CopyButton, Customization, type CustomizationOmitSection, type CustomizationProps, type CustomizationSection, DEV_BANNER_TEXT, Desktop, type DesktopHostConfig, DesktopHostProvider, DevIndicator, DocFavStar, ENTER, EditableGrid, type EditableGridProps, type EntityFetcher, EntityList, type EntityListColumn, type EntityListProps, GLASS_DIVIDER, GLASS_INPUT_BG, GlobalSearch, type GridColumn, HelpCenter, type HelpCenterDoc, type HelpCenterProps, Kanban, type KanbanColumn, type KanbanProps, Layout, type LayoutProps, ListFooter, MOD, Markdown, type MarkdownProps, Modal, ModalActions, NotificationBell, type NotificationsConfig, type PaginatedResponse, PopupMenu, PopupMenuDivider, PopupMenuItem, PopupMenuLabel, type ReportType, ResizableTable, SHIFT, type SearchConfig, type SearchProvider, type SearchResult, type SemanticGroup, type ShellAuth, ShellAuthProvider, ShellEntityFetcherProvider, type ShellNotification, type ShellPrefsAdapter, ShellPrefsProvider, ShortcutHelp, SidebarLayout, type SidebarLayoutProps, type SortState, SoundsPanel, StartMenu, StatusBadge, StatusBadgeProvider, type StickyEntityRef, type StickyResolver, SystemPreferences, type SystemPreferencesProps, type SystemPreferencesSection, type TodoProvider, type TodoTask, TopNav, type TopNavItem, type TopNavProps, VERSION, WidgetManager, WindowManagerProvider, WindowRegistry, WindowTitle, applyDevTitle, commitExposeHighlight, confirm, confirmDestructive, createWindowRegistry, exitExposeMode, formatDate, getActiveWindowRoute, getExposeHighlight, getWindowPosition, glassStyle, isDevEnv, isMac, openBugReportDialog, prompt, reportBug, setExposeHighlight, setShellApiClient, setShellAuthBridge, setShellNavIcons, setShellTodoProvider, setWindowDefaultPosition, setWindowPosition, subscribeExposeHighlight, toast, toggleExposeMode, useBugReport, useClickOutside, useColumnConfig, useDesktopHost, useEditHotkey, useInfiniteScroll, useLocalStoragePrefs, useModalActive, useNewHotkey, useShellAuth, useShellEntityFetcher, useShellPrefs, useSort, useTableNav, useWidgetSettings, useWindowManager, useWindowMenuItem, useWindowTitle };