react-os-shell 0.4.0 → 0.6.1

package/dist/{chunk-LZCEK7JF.js → chunk-XNXIIGHP.js}

@@ -1,6 +1,6 @@
-import { setPdfPreview } from './chunk-NRT2CU5Q.js';
+import { setPdfPreview } from './chunk-HG3O6XHN.js';
 import { toast_default } from './chunk-WIJ45SYD.js';
-import { setSpreadsheetPreview } from './chunk-6YY6A6SV.js';
+import { setSpreadsheetPreview } from './chunk-NVAWKCAI.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-LZCEK7JF.js.map
-//# sourceMappingURL=chunk-LZCEK7JF.js.map
+//# sourceMappingURL=chunk-XNXIIGHP.js.map
+//# sourceMappingURL=chunk-XNXIIGHP.js.map

package/dist/{chunk-LZCEK7JF.js.map → chunk-XNXIIGHP.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-LZCEK7JF.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-XNXIIGHP.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/{chunk-SSA762W5.js → chunk-ZF6AYO4G.js}

@@ -26,7 +26,7 @@ function setShellNavIcons(icons) {
 }
 var sectionIcons = {};
 var navSections = [];
-var startMenuCategories = { erp: [], system: [], virtual: [] };
+var startMenuCategories = { erp: [], system: [], virtual: [], footer: [] };
 
 // src/utils/glass.ts
 function getMenuOpacity() {
@@ -67,5 +67,5 @@ var GLASS_DIVIDER = "border-white/20";
 var GLASS_INPUT_BG = "glass-input-bg";
 
 export { GLASS_DIVIDER, GLASS_INPUT_BG, glassStyle, isSection, navIcons, navSections, sectionIcons, setShellNavIcons, startMenuCategories };
-//# sourceMappingURL=chunk-SSA762W5.js.map
-//# sourceMappingURL=chunk-SSA762W5.js.map
+//# sourceMappingURL=chunk-ZF6AYO4G.js.map
+//# sourceMappingURL=chunk-ZF6AYO4G.js.map

package/dist/chunk-ZF6AYO4G.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/shell/nav-types.ts","../src/shell-config/nav.tsx","../src/utils/glass.ts"],"names":[],"mappings":";AAkDO,SAAS,UAAU,IAAA,EAAgD;AACxE,EAAA,OAAO,OAAA,IAAW,IAAA;AACpB;;;ACpCA,IAAM,YAAuC,EAAC;AACvC,IAAM,QAAA,GAAsC,IAAI,KAAA,CAAM,SAAA,EAAW;AAAA,EACtE,GAAA,CAAI,IAAI,CAAA,EAAW;AAAE,IAAA,OAAO,UAAU,CAAC,CAAA;AAAA,EAAG,CAAA;AAAA,EAC1C,GAAA,CAAI,IAAI,CAAA,EAAW;AAAE,IAAA,OAAO,CAAA,IAAK,SAAA;AAAA,EAAW,CAAA;AAAA,EAC5C,OAAA,GAAU;AAAE,IAAA,OAAO,MAAA,CAAO,KAAK,SAAS,CAAA;AAAA,EAAG,CAAA;AAAA,EAC3C,wBAAA,CAAyB,IAAI,CAAA,EAAW;AACtC,IAAA,IAAI,CAAA,IAAK,SAAA,EAAW,OAAO,EAAE,YAAA,EAAc,IAAA,EAAM,UAAA,EAAY,IAAA,EAAM,KAAA,EAAO,SAAA,CAAU,CAAC,CAAA,EAAE;AACvF,IAAA,OAAO,MAAA;AAAA,EACT;AACF,CAAC;AACM,SAAS,iBAAiB,KAAA,EAAwC;AACvE,EAAA,KAAA,MAAW,KAAK,MAAA,CAAO,IAAA,CAAK,SAAS,CAAA,EAAG,OAAO,UAAU,CAAC,CAAA;AAC1D,EAAA,MAAA,CAAO,MAAA,CAAO,WAAW,KAAK,CAAA;AAChC;AAEO,IAAM,eAA0C;AAChD,IAAM,cAAwC;AAC9C,IAAM,mBAAA,GAA2C,EAAE,GAAA,EAAK,EAAC,EAAG,MAAA,EAAQ,EAAC,EAAG,OAAA,EAAS,EAAC,EAAG,MAAA,EAAQ,EAAC;;;AC9BrG,SAAS,cAAA,GAAyB;AAChC,EAAA,IAAI;AACF,IAAA,MAAM,GAAA,GAAM,iBAAiB,QAAA,CAAS,eAAe,EAAE,gBAAA,CAAiB,gBAAgB,GAAG,IAAA,EAAK;AAChG,IAAA,IAAI,GAAA,EAAK,OAAO,UAAA,CAAW,GAAG,CAAA;AAAA,EAChC,CAAA,CAAA,MAAQ;AAAA,EAAC;AACT,EAAA,OAAO,IAAA;AACT;AAEA,SAAS,WAAA,GAAuB;AAC9B,EAAA,IAAI;AACF,IAAA,OAAO,QAAA,CAAS,eAAA,CAAgB,YAAA,CAAa,YAAY,CAAA,KAAM,MAAA;AAAA,EACjE,CAAA,CAAA,MAAQ;AACN,IAAA,OAAO,KAAA;AAAA,EACT;AACF;AAKO,SAAS,WAAW,OAAA,EAAiC;AAC1D,EAAA,MAAM,CAAA,GAAI,WAAW,cAAA,EAAe;AACpC,EAAA,IAAI,aAAY,EAAG;AAGjB,IAAA,OAAO;AAAA,MACL,UAAA,EAAY,yCAAyC,CAAA,GAAI,IAAI,uBAAuB,CAAA,GAAI,IAAI,CAAA,qBAAA,EAAwB,CAAA,GAAI,IAAI,CAAA,OAAA,CAAA;AAAA,MAC5H,cAAA,EAAgB,0BAAA;AAAA,MAChB,oBAAA,EAAsB,0BAAA;AAAA,MACtB,MAAA,EAAQ,kCAAA;AAAA,MACR,SAAA,EAAW;AAAA,KACb;AAAA,EACF;AACA,EAAA,OAAO;AAAA,IACL,UAAA,EAAY,4CAA4C,CAAA,GAAI,IAAI,0BAA0B,CAAA,GAAI,IAAI,CAAA,wBAAA,EAA2B,CAAA,GAAI,IAAI,CAAA,OAAA,CAAA;AAAA,IACrI,cAAA,EAAgB,0BAAA;AAAA,IAChB,oBAAA,EAAsB,0BAAA;AAAA,IACtB,MAAA,EAAQ,kCAAA;AAAA,IACR,SAAA,EAAW;AAAA,GACb;AACF;AAGO,IAAM,aAAA,GAAgB;AAKtB,IAAM,cAAA,GAAiB","file":"chunk-ZF6AYO4G.js","sourcesContent":["/**\n * Nav data types used by <Layout> + <StartMenu>. The actual sections, icons,\n * and categories are consumer-supplied via Layout props — the package never\n * ships nav DATA, only the shape it expects.\n */\nimport type { ReactNode } from 'react';\n\nexport interface NavItem {\n  to: string;\n  label: string;\n  perms?: string[];\n  dividerAfter?: boolean;\n  /** Optional 3rd-level sub-items. Hovering the parent in <StartMenu> opens\n   *  a nested flyout; in <Sidebar> the parent becomes an inline sub-accordion. */\n  children?: NavItem[];\n}\n\nexport interface NavSection {\n  label: string;\n  items: NavItem[];\n  perms?: string[];\n  /** Optional landing route for clicks on the section title itself\n   *  (e.g. R&D's `/rd` dashboard). */\n  to?: string;\n}\n\nexport interface VirtualSection {\n  label: string;\n  items: NavItem[];\n  icon?: ReactNode;\n}\n\nexport interface StartMenuCategories {\n  /** Section labels rendered in the \"ERP\" group (bold, with section icon). */\n  erp: string[];\n  /** Section labels rendered in the \"system\" group. */\n  system: string[];\n  /** Optional virtual flyouts (e.g. a \"Utilities\" tray). */\n  virtual?: VirtualSection[];\n  /** Optional section labels pinned to the bottom of the menu, next to the user\n   *  profile, separated from the ERP group by a divider. */\n  footer?: string[];\n  /** Optional flat top-level items pinned to the bottom of the menu, next to\n   *  the user profile, separated from the ERP group by a divider. Unlike\n   *  `footer` (section labels rendered as flyouts), these render as direct\n   *  clickable rows — use for standalone destinations like System Preferences\n   *  or a bug-report link. */\n  footerItems?: NavItem[];\n}\n\nexport function isSection(item: NavSection | NavItem): item is NavSection {\n  return 'items' in item;\n}\n","/**\n * INTERNAL stub — package-side compatibility for files that legacy-imported\n * default nav data from `shell-config/nav`. The package never ships nav\n * DATA; consumers always supply `navSections` / `navIcons` / `sectionIcons` /\n * `categories` as Layout props.\n *\n * Empty defaults exported here so the copied files compile during the\n * extraction transition. Each consumer-facing field is also re-exported as\n * a TYPE alias for code that only needed the shape.\n */\nimport type { ReactNode } from 'react';\nimport type { NavItem, NavSection, StartMenuCategories, VirtualSection } from '../shell/nav-types';\n\n// Live proxy: WindowManager reads window-title icons from this module-level\n// map. Consumers register their full icon set once at app startup so the\n// title bars show the same glyphs as the start menu.\nconst _navIcons: Record<string, ReactNode> = {};\nexport const navIcons: Record<string, ReactNode> = new Proxy(_navIcons, {\n  get(_t, k: string) { return _navIcons[k]; },\n  has(_t, k: string) { return k in _navIcons; },\n  ownKeys() { return Object.keys(_navIcons); },\n  getOwnPropertyDescriptor(_t, k: string) {\n    if (k in _navIcons) return { configurable: true, enumerable: true, value: _navIcons[k] };\n    return undefined;\n  },\n});\nexport function setShellNavIcons(icons: Record<string, ReactNode>): void {\n  for (const k of Object.keys(_navIcons)) delete _navIcons[k];\n  Object.assign(_navIcons, icons);\n}\n\nexport const sectionIcons: Record<string, ReactNode> = {};\nexport const navSections: (NavSection | NavItem)[] = [];\nexport const startMenuCategories: StartMenuCategories = { erp: [], system: [], virtual: [], footer: [] };\n\nexport { isSection } from '../shell/nav-types';\nexport type { NavItem, NavSection, StartMenuCategories, VirtualSection };\n","import type { CSSProperties } from 'react';\n\n/** Read the system menu opacity from CSS custom property set by Layout */\nfunction getMenuOpacity(): number {\n  try {\n    const val = getComputedStyle(document.documentElement).getPropertyValue('--menu-opacity')?.trim();\n    if (val) return parseFloat(val);\n  } catch {}\n  return 0.95;\n}\n\nfunction isDarkTheme(): boolean {\n  try {\n    return document.documentElement.getAttribute('data-theme') === 'dark';\n  } catch {\n    return false;\n  }\n}\n\n/** Frosted glass style — shared across all menus, popups, and glass UI elements.\n * Reads --menu-opacity CSS variable set by the theme system, and adapts the\n * base tint to dark mode so menus don't stay light-cream when text is light. */\nexport function glassStyle(opacity?: number): CSSProperties {\n  const o = opacity ?? getMenuOpacity();\n  if (isDarkTheme()) {\n    // Dark frosted glass — Catppuccin-aligned base (#1e1e2e / 30,30,46) with\n    // a subtle gradient and lighter inner highlight.\n    return {\n      background: `linear-gradient(135deg, rgba(30,30,46,${o * 0.85}) 0%, rgba(24,24,37,${o * 0.75}) 50%, rgba(30,30,46,${o * 0.85}) 100%)`,\n      backdropFilter: 'blur(40px) saturate(1.6)',\n      WebkitBackdropFilter: 'blur(40px) saturate(1.6)',\n      border: '1px solid rgba(255,255,255,0.08)',\n      boxShadow: 'inset 0 1px 0 rgba(255,255,255,0.06), inset 0 -1px 0 rgba(0,0,0,0.4), 0 8px 32px rgba(0,0,0,0.5), 0 2px 8px rgba(0,0,0,0.3)',\n    };\n  }\n  return {\n    background: `linear-gradient(135deg, rgba(255,255,255,${o * 0.85}) 0%, rgba(255,255,255,${o * 0.65}) 50%, rgba(255,255,255,${o * 0.75}) 100%)`,\n    backdropFilter: 'blur(40px) saturate(1.8)',\n    WebkitBackdropFilter: 'blur(40px) saturate(1.8)',\n    border: '1px solid rgba(255,255,255,0.35)',\n    boxShadow: 'inset 0 1px 0 rgba(255,255,255,0.4), inset 0 -1px 0 rgba(255,255,255,0.1), 0 8px 32px rgba(0,0,0,0.15), 0 2px 8px rgba(0,0,0,0.08)',\n  };\n}\n\n/** Glass divider border color */\nexport const GLASS_DIVIDER = 'border-white/20';\n\n/** Glass input/search bar background — declared in styles.css so it can adapt\n *  to dark mode (a flat `bg-white/15` reads as a too-bright tile on the dark\n *  glass gradient). */\nexport const GLASS_INPUT_BG = 'glass-input-bg';\n"]}

package/dist/index.d.ts

@@ -33,6 +33,9 @@ interface NavItem {
     label: string;
     perms?: string[];
     dividerAfter?: boolean;
+    /** Optional 3rd-level sub-items. Hovering the parent in <StartMenu> opens
+     *  a nested flyout; in <Sidebar> the parent becomes an inline sub-accordion. */
+    children?: NavItem[];
 }
 interface NavSection {
     label: string;
@@ -54,6 +57,15 @@ interface StartMenuCategories {
     system: string[];
     /** Optional virtual flyouts (e.g. a "Utilities" tray). */
     virtual?: VirtualSection[];
+    /** Optional section labels pinned to the bottom of the menu, next to the user
+     *  profile, separated from the ERP group by a divider. */
+    footer?: string[];
+    /** Optional flat top-level items pinned to the bottom of the menu, next to
+     *  the user profile, separated from the ERP group by a divider. Unlike
+     *  `footer` (section labels rendered as flyouts), these render as direct
+     *  clickable rows — use for standalone destinations like System Preferences
+     *  or a bug-report link. */
+    footerItems?: NavItem[];
 }
 
 /**
@@ -705,8 +717,11 @@ interface LayoutProps {
      *  the shell. The shell renders the node as-is — keep it small (a
      *  single icon-sized button) so it fits the existing tray rhythm. */
     taskbarTrayLeft?: ReactNode;
+    /** Show the Mail & Calendar connect button in the system tray.
+     *  Defaults to true. Set false for portals with no mail integration. */
+    showMail?: boolean;
 }
-declare function Layout({ productName, productIcon, wallpapers, navSections, navIcons, sectionIcons, categories, notifications, search, taskbarTrayLeft, }?: LayoutProps): react_jsx_runtime.JSX.Element;
+declare function Layout({ productName, productIcon, wallpapers, navSections, navIcons, sectionIcons, categories, notifications, search, taskbarTrayLeft, showMail, }?: LayoutProps): react_jsx_runtime.JSX.Element;
 
 interface StartMenuProps {
     open: boolean;

package/dist/index.js

@@ -6,21 +6,21 @@ export { setShellMailServer, useMailAuth } from './chunk-VBFB3ZIN.js';
 import { subscribePomo, getPomoSnapshot } from './chunk-MK3HLUO4.js';
 import { useShellPrefs } from './chunk-36VM54SC.js';
 export { ShellPrefsProvider, useLocalStoragePrefs, useShellPrefs } from './chunk-36VM54SC.js';
-import { PREVIEW_OPENED_EVENT, openPreviewFile } from './chunk-LZCEK7JF.js';
+import { PREVIEW_OPENED_EVENT, openPreviewFile } from './chunk-XNXIIGHP.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-NRT2CU5Q.js';
+import { setPdfPreview } from './chunk-HG3O6XHN.js';
 import './chunk-KUIPWCTJ.js';
 import { toast_default } from './chunk-WIJ45SYD.js';
 export { toast_default as toast } from './chunk-WIJ45SYD.js';
-export { EditableGrid } from './chunk-6YY6A6SV.js';
-import { useWindowManager, PopupMenu, PopupMenuLabel, PopupMenuDivider, PopupMenuItem, Modal, ModalActions, useIsMobile, useModalActive, client_default, LoadingSpinner, WINDOW_REGISTRY, isPageEntry, ThumbCard, activateModal } from './chunk-GI7ABQPU.js';
-export { CancelButton, CopyButton, DocFavStar, Modal, ModalActions, PopupMenu, PopupMenuDivider, PopupMenuItem, PopupMenuLabel, WindowManagerProvider, WindowTitle, commitExposeHighlight, exitExposeMode, getActiveWindowRoute, getExposeHighlight, isEntityEntry, isPageEntry, setExposeHighlight, setShellApiClient, setShellWindowRegistry, setWindowDefaultPosition, subscribeExposeHighlight, toggleExposeMode, useModalActive, useWidgetSettings, useWindowManager, useWindowMenuItem, useWindowTitle } from './chunk-GI7ABQPU.js';
+export { EditableGrid } from './chunk-NVAWKCAI.js';
+import { useWindowManager, PopupMenu, PopupMenuLabel, PopupMenuDivider, PopupMenuItem, Modal, ModalActions, useIsMobile, useModalActive, client_default, LoadingSpinner, WINDOW_REGISTRY, isPageEntry, ThumbCard, activateModal } from './chunk-3RQ5TVEL.js';
+export { CancelButton, CopyButton, DocFavStar, Modal, ModalActions, PopupMenu, PopupMenuDivider, PopupMenuItem, PopupMenuLabel, WindowManagerProvider, WindowTitle, commitExposeHighlight, exitExposeMode, getActiveWindowRoute, getExposeHighlight, isEntityEntry, isPageEntry, setExposeHighlight, setShellApiClient, setShellWindowRegistry, setWindowDefaultPosition, subscribeExposeHighlight, toggleExposeMode, useModalActive, useWidgetSettings, useWindowManager, useWindowMenuItem, useWindowTitle } from './chunk-3RQ5TVEL.js';
 import { confirm } from './chunk-PLGHQ7QW.js';
 export { ConfirmProvider, confirm, confirmDestructive, prompt } from './chunk-PLGHQ7QW.js';
 import { useAuth, useShellAuth } from './chunk-ADJ3CERD.js';
 export { ShellAuthProvider, setShellAuthBridge, useShellAuth } from './chunk-ADJ3CERD.js';
-import { glassStyle, startMenuCategories, navSections, isSection, GLASS_INPUT_BG, navIcons, sectionIcons } from './chunk-SSA762W5.js';
-export { GLASS_DIVIDER, GLASS_INPUT_BG, glassStyle, setShellNavIcons } from './chunk-SSA762W5.js';
+import { glassStyle, startMenuCategories, navSections, isSection, GLASS_INPUT_BG, navIcons, sectionIcons } from './chunk-ZF6AYO4G.js';
+export { GLASS_DIVIDER, GLASS_INPUT_BG, glassStyle, setShellNavIcons } from './chunk-ZF6AYO4G.js';
 import { createContext, lazy, useState, useRef, useEffect, useCallback, useLayoutEffect, useContext, Suspense, isValidElement, cloneElement, useMemo, useSyncExternalStore } from 'react';
 import { jsxs, jsx, Fragment } from 'react/jsx-runtime';
 import { Dialog, DialogBackdrop, DialogPanel, DialogTitle } from '@headlessui/react';
@@ -915,7 +915,7 @@ function StatusBadge({ status }) {
 }
 
 // src/version.ts
-var VERSION = "0.4.0" ;
+var VERSION = "0.6.1" ;
 var APP_VERSION = VERSION;
 
 // src/changelog.ts
@@ -2887,25 +2887,35 @@ function StartMenu({
 }) {
   const erpLabels = new Set(categories.erp);
   const systemLabels = new Set(categories.system);
+  const footerLabels = new Set(categories.footer ?? []);
   const virtualSections = categories.virtual ?? [];
   const virtualByLabel = Object.fromEntries(
     virtualSections.map((v) => [v.label, v])
   );
   const { hasAnyPerm } = useAuth();
+  const footerItems = (categories.footerItems ?? []).filter((item) => !item.perms || hasAnyPerm(item.perms));
   const isMobile = useIsMobile();
   const [hoveredSection, setHoveredSection] = useState(null);
   const [hoveredY, setHoveredY] = useState(0);
+  const [hoveredChild, setHoveredChild] = useState(null);
+  const [hoveredChildY, setHoveredChildY] = useState(0);
   const [search, setSearch] = useState("");
   const [searchIdx, setSearchIdx] = useState(0);
   const menuRef = useRef(null);
+  const flyoutRef = useRef(null);
   const hoverTimeout = useRef();
+  const childHoverTimeout = useRef();
   useEffect(() => {
     if (!open) {
       setSearch("");
       setHoveredSection(null);
+      setHoveredChild(null);
       setSearchIdx(0);
     }
   }, [open]);
+  useEffect(() => {
+    setHoveredChild(null);
+  }, [hoveredSection]);
   useEffect(() => {
     if (!open) return;
     const handler = (e) => {
@@ -2929,20 +2939,23 @@ function StartMenu({
   };
   if (isMobile) {
     const allItems = [];
+    const pushItem = (it, sectionLabel) => {
+      if (it.perms && !hasAnyPerm(it.perms)) return;
+      allItems.push({ item: it, sectionLabel });
+      if (it.children) {
+        for (const c of it.children) pushItem(c, it.label);
+      }
+    };
     for (const entry of navSections2) {
       if (isSection(entry)) {
         const sec = entry;
         if (sec.perms && !hasAnyPerm(sec.perms)) continue;
-        for (const it of sec.items) {
-          if (it.perms && !hasAnyPerm(it.perms)) continue;
-          allItems.push({ item: it, sectionLabel: sec.label });
-        }
+        for (const it of sec.items) pushItem(it, sec.label);
       } else {
-        const it = entry;
-        if (it.perms && !hasAnyPerm(it.perms)) continue;
-        allItems.push({ item: it });
+        pushItem(entry);
       }
     }
+    for (const it of footerItems) pushItem(it);
     const filtered = search.length >= 1 ? allItems.filter(({ item }) => item.label.toLowerCase().includes(search.toLowerCase())) : allItems;
     return /* @__PURE__ */ jsxs(
       "div",
@@ -2993,13 +3006,29 @@ function StartMenu({
   const topItems = navSections2.filter((item) => !isSection(item));
   const erpSections = navSections2.filter((item) => isSection(item) && erpLabels.has(item.label));
   const systemSections = navSections2.filter((item) => isSection(item) && systemLabels.has(item.label));
+  const footerSections = navSections2.filter((item) => isSection(item) && footerLabels.has(item.label));
   const getVisibleItems = (section) => section.items.filter((item) => !item.perms || hasAnyPerm(item.perms));
-  const searchResults = search.length >= 2 ? navSections2.flatMap((item) => {
-    if (isSection(item)) {
-      return item.items.filter((i) => (!i.perms || hasAnyPerm(i.perms)) && i.label.toLowerCase().includes(search.toLowerCase())).map((i) => ({ ...i, section: item.label }));
+  const matchTree = (it, sectionLabel) => {
+    if (it.perms && !hasAnyPerm(it.perms)) return [];
+    const hits = [];
+    if (it.label.toLowerCase().includes(search.toLowerCase())) {
+      hits.push({ ...it, section: sectionLabel });
+    }
+    if (it.children) {
+      for (const c of it.children) hits.push(...matchTree(c, it.label));
     }
-    return item.label.toLowerCase().includes(search.toLowerCase()) ? [{ ...item, section: "" }] : [];
-  }) : [];
+    return hits;
+  };
+  const searchResults = search.length >= 2 ? [
+    ...navSections2.flatMap((item) => {
+      if (isSection(item)) {
+        const sec = item;
+        return sec.items.flatMap((i) => matchTree(i, sec.label));
+      }
+      return matchTree(item, "");
+    }),
+    ...footerItems.flatMap((item) => matchTree(item, ""))
+  ] : [];
   const posStyle = taskbarPosition === "top" ? { top: taskbarH + 8, left: 8 } : taskbarPosition === "left" ? { top: 8, left: taskbarW + 8 } : taskbarPosition === "right" ? { top: 8, right: taskbarW + 8 } : { bottom: taskbarH + 8, left: 8 };
   const iconEl = (path) => {
     const icon = navIcons2[path];
@@ -3012,7 +3041,7 @@ function StartMenu({
     return null;
   };
   const hoveredVirtual = hoveredSection ? virtualByLabel[hoveredSection] : void 0;
-  const hoveredData = hoveredVirtual ? null : hoveredSection ? [...erpSections, ...systemSections].find((s) => s.label === hoveredSection) : null;
+  const hoveredData = hoveredVirtual ? null : hoveredSection ? [...erpSections, ...systemSections, ...footerSections].find((s) => s.label === hoveredSection) : null;
   const flyoutItems = hoveredVirtual ? hoveredVirtual.items : hoveredData ? getVisibleItems(hoveredData) : [];
   const menuDensity = typeof document !== "undefined" ? getComputedStyle(document.documentElement).getPropertyValue("--menu-density")?.trim() || "normal" : "normal";
   const tight = menuDensity === "tight";
@@ -3126,6 +3155,20 @@ function StartMenu({
               i
             )) }) : /* @__PURE__ */ jsxs("div", { className: "flex-1 overflow-y-auto px-1 pb-1 flex flex-col", children: [
               isVertical && /* @__PURE__ */ jsxs(Fragment, { children: [
+                footerItems.map((item) => /* @__PURE__ */ jsxs(
+                  "button",
+                  {
+                    onClick: () => handleClick(item.to),
+                    className: `${itemCls} text-gray-700 hover:bg-blue-50 hover:text-blue-700 transition-colors`,
+                    children: [
+                      iconEl(item.to),
+                      /* @__PURE__ */ jsx("span", { children: item.label })
+                    ]
+                  },
+                  item.to
+                )),
+                footerSections.map((s) => renderSection(s, false)),
+                (footerSections.length > 0 || footerItems.length > 0) && /* @__PURE__ */ jsx("div", { className: "border-t border-white/20 my-1.5 mx-2" }),
                 erpSections.map((s) => renderSection(s, true)),
                 /* @__PURE__ */ jsx("div", { className: "border-t border-white/20 my-1.5 mx-2" }),
                 topItems.map((item) => /* @__PURE__ */ jsxs("div", { children: [
@@ -3171,7 +3214,21 @@ function StartMenu({
                 systemSections.map((s) => renderSection(s, false)),
                 virtualSections.map((v) => renderVirtualSection(v)),
                 /* @__PURE__ */ jsx("div", { className: "border-t border-white/20 my-1.5 mx-2" }),
-                erpSections.map((s) => renderSection(s, true))
+                erpSections.map((s) => renderSection(s, true)),
+                (footerSections.length > 0 || footerItems.length > 0) && /* @__PURE__ */ jsx("div", { className: "border-t border-white/20 my-1.5 mx-2" }),
+                footerSections.map((s) => renderSection(s, false)),
+                footerItems.map((item) => /* @__PURE__ */ jsxs(
+                  "button",
+                  {
+                    onClick: () => handleClick(item.to),
+                    className: `${itemCls} text-gray-700 hover:bg-blue-50 hover:text-blue-700 transition-colors`,
+                    children: [
+                      iconEl(item.to),
+                      /* @__PURE__ */ jsx("span", { children: item.label })
+                    ]
+                  },
+                  item.to
+                ))
               ] })
             ] }),
             /* @__PURE__ */ jsx("div", { className: `${isVertical ? "border-b" : "border-t"} border-white/20 p-1`, children: /* @__PURE__ */ jsxs(
@@ -3204,28 +3261,91 @@ function StartMenu({
       hoveredSection && flyoutItems.length > 0 && search.length < 2 && /* @__PURE__ */ jsx(
         "div",
         {
+          ref: flyoutRef,
           className: `fixed ${sizeConfig.fw} rounded-2xl overflow-hidden`,
           style: { left: menuRef.current ? menuRef.current.getBoundingClientRect().right + 4 : menuWidth + 12, top: flyoutTop, animation: "submenu-in 0.1s ease-out", ...menuGlass },
           onMouseEnter: () => clearTimeout(hoverTimeout.current),
           onMouseLeave: () => {
-            hoverTimeout.current = setTimeout(() => setHoveredSection(null), 200);
+            hoverTimeout.current = setTimeout(() => {
+              setHoveredSection(null);
+              setHoveredChild(null);
+            }, 200);
           },
-          children: /* @__PURE__ */ jsx("div", { className: "py-1 px-1", children: flyoutItems.map((item) => /* @__PURE__ */ jsxs("div", { children: [
-            /* @__PURE__ */ jsxs(
-              "button",
+          children: /* @__PURE__ */ jsx("div", { className: "py-1 px-1", children: flyoutItems.map((item) => {
+            const hasChildren = !!item.children && item.children.length > 0;
+            const isChildHovered = hoveredChild === item.to;
+            return /* @__PURE__ */ jsxs(
+              "div",
               {
-                onClick: () => handleClick(item.to),
-                className: `${itemCls} text-gray-700 hover:bg-blue-50 hover:text-blue-700 transition-colors`,
+                onMouseEnter: hasChildren ? (e) => {
+                  clearTimeout(childHoverTimeout.current);
+                  const rect = e.currentTarget.getBoundingClientRect();
+                  setHoveredChildY(rect.top + rect.height / 2);
+                  setHoveredChild(item.to);
+                } : () => {
+                  childHoverTimeout.current = setTimeout(() => setHoveredChild(null), 200);
+                },
                 children: [
-                  iconEl(item.to),
-                  /* @__PURE__ */ jsx("span", { children: item.label })
+                  /* @__PURE__ */ jsxs(
+                    "button",
+                    {
+                      onClick: () => handleClick(item.to),
+                      className: `${itemCls} transition-colors ${isChildHovered ? "bg-blue-50 text-blue-700" : "text-gray-700 hover:bg-blue-50 hover:text-blue-700"}`,
+                      children: [
+                        iconEl(item.to),
+                        /* @__PURE__ */ jsx("span", { children: item.label }),
+                        hasChildren && /* @__PURE__ */ jsx("svg", { className: "h-3.5 w-3.5 ml-auto text-gray-500", fill: "none", viewBox: "0 0 24 24", stroke: "currentColor", strokeWidth: 2, children: /* @__PURE__ */ jsx("path", { strokeLinecap: "round", strokeLinejoin: "round", d: "M8.25 4.5l7.5 7.5-7.5 7.5" }) })
+                      ]
+                    }
+                  ),
+                  item.dividerAfter && /* @__PURE__ */ jsx("div", { className: "border-t border-white/20 my-1.5 mx-2" })
                 ]
-              }
-            ),
-            item.dividerAfter && /* @__PURE__ */ jsx("div", { className: "border-t border-white/20 my-1.5 mx-2" })
-          ] }, item.to)) })
+              },
+              item.to
+            );
+          }) })
         }
-      )
+      ),
+      (() => {
+        if (search.length >= 2 || !hoveredChild) return null;
+        const parent = flyoutItems.find((it) => it.to === hoveredChild);
+        const kids = (parent?.children ?? []).filter((c) => !c.perms || hasAnyPerm(c.perms));
+        if (!parent || kids.length === 0) return null;
+        const flyoutRect = flyoutRef.current?.getBoundingClientRect();
+        const subLeft = flyoutRect ? flyoutRect.right + 4 : 0;
+        const subH = kids.length * sizeConfig.itemH + 12;
+        let subTop = hoveredChildY - subH / 2;
+        if (subTop < minTop) subTop = minTop;
+        if (subTop + subH > maxBottom) subTop = maxBottom - subH;
+        return /* @__PURE__ */ jsx(
+          "div",
+          {
+            className: `fixed ${sizeConfig.fw} rounded-2xl overflow-hidden`,
+            style: { left: subLeft, top: subTop, animation: "submenu-in 0.1s ease-out", ...menuGlass },
+            onMouseEnter: () => {
+              clearTimeout(hoverTimeout.current);
+              clearTimeout(childHoverTimeout.current);
+            },
+            onMouseLeave: () => {
+              childHoverTimeout.current = setTimeout(() => setHoveredChild(null), 200);
+            },
+            children: /* @__PURE__ */ jsx("div", { className: "py-1 px-1", children: kids.map((child) => /* @__PURE__ */ jsxs("div", { children: [
+              /* @__PURE__ */ jsxs(
+                "button",
+                {
+                  onClick: () => handleClick(child.to),
+                  className: `${itemCls} text-gray-700 hover:bg-blue-50 hover:text-blue-700 transition-colors`,
+                  children: [
+                    iconEl(child.to),
+                    /* @__PURE__ */ jsx("span", { children: child.label })
+                  ]
+                }
+              ),
+              child.dividerAfter && /* @__PURE__ */ jsx("div", { className: "border-t border-white/20 my-1.5 mx-2" })
+            ] }, child.to)) })
+          }
+        );
+      })()
     ] }),
     /* @__PURE__ */ jsx("style", { children: `
         @keyframes menu-in { from { opacity: 0; transform: scale(0.95) translateY(8px); } to { opacity: 1; transform: scale(1) translateY(0); } }
@@ -3996,7 +4116,7 @@ function MobileBottomNav({
     }
   );
 }
-var Sidebar = lazy(() => import('./Sidebar-4V6NQROQ.js'));
+var Sidebar = lazy(() => import('./Sidebar-Q3PRJ2FP.js'));
 function useFavorites(wallpapers) {
   const { prefs, save } = useShellPrefs();
   const favorites = prefs.favorite_pages || [];
@@ -4193,7 +4313,8 @@ function Layout({
   categories = startMenuCategories,
   notifications,
   search,
-  taskbarTrayLeft
+  taskbarTrayLeft,
+  showMail = true
 } = {}) {
   const bugReport = useBugReport();
   const { user, logout, hasAnyPerm } = useAuth();
@@ -4526,7 +4647,7 @@ function Layout({
                 /* Vertical: clock + mail-connect + bell evenly spaced */
                 /* @__PURE__ */ jsx("div", { className: "w-full px-2", children: /* @__PURE__ */ jsxs("div", { className: `flex items-center justify-center gap-2 ${taskbarPosition === "right" ? "flex-row-reverse" : ""}`, children: [
                   /* @__PURE__ */ jsx(TaskbarClock, {}),
-                  /* @__PURE__ */ jsx(
+                  showMail && /* @__PURE__ */ jsx(
                     "button",
                     {
                       onClick: () => setMailConnectOpen(true),
@@ -4545,7 +4666,7 @@ function Layout({
                   /* @__PURE__ */ jsx(TaskbarPomodoro, {}),
                   taskbarTrayLeft,
                   notifications && /* @__PURE__ */ jsx(NotificationBell, { ...notifications }),
-                  /* @__PURE__ */ jsx(
+                  showMail && /* @__PURE__ */ jsx(
                     "button",
                     {
                       onClick: () => setMailConnectOpen(true),