react-os-shell 3.24.0 → 3.26.0

package/dist/index.js

@@ -1,5 +1,5 @@
-import { subscribePomo, getPomoSnapshot } from './chunk-WNZH4GVY.js';
-export { setShellTodoProvider } from './chunk-WNZH4GVY.js';
+import { subscribePomo, getPomoSnapshot } from './chunk-MU7UZXAS.js';
+export { setShellTodoProvider } from './chunk-MU7UZXAS.js';
 export { ImageAnnotator_default as ImageAnnotator } from './chunk-QU5L5ZYM.js';
 import { PREVIEW_OPENED_EVENT, openPreviewFile } from './chunk-DINNWYVB.js';
 export { Breadcrumbs } from './chunk-DINNWYVB.js';
@@ -15,11 +15,10 @@ export { ShellAuthProvider, setShellAuthBridge, useShellAuth } from './chunk-ADJ
 import { EditableGrid } from './chunk-GP4Y3VCB.js';
 export { EditableGrid } from './chunk-GP4Y3VCB.js';
 import './chunk-4SQU5YV6.js';
-import { APP_VERSION, VERSION } from './chunk-TGEZDU6N.js';
-export { VERSION } from './chunk-TGEZDU6N.js';
-import { useWindowManager, PopupMenu, PopupMenuLabel, PopupMenuDivider, PopupMenuItem, WINDOW_REGISTRY, isPageEntry, Modal, useShellPrefs, useIsMobile, ModalActions, useModalActive, client_default, LoadingSpinner, isShellApiClientConfigured, CancelButton, setWindowPosition, ThumbCard, activateModal } from './chunk-2YTZ6COH.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-2YTZ6COH.js';
-export { ConfirmProvider, confirm, confirmDestructive, prompt } from './chunk-UBN4IUDE.js';
+import { APP_VERSION, VERSION } from './chunk-4BOGLRCL.js';
+export { VERSION } from './chunk-4BOGLRCL.js';
+import { useWindowManager, PopupMenu, PopupMenuLabel, PopupMenuDivider, PopupMenuItem, WINDOW_REGISTRY, isPageEntry, Modal, useShellPrefs, useIsMobile, ModalActions, useModalActive, client_default, LoadingSpinner, isShellApiClientConfigured, CancelButton, setWindowPosition, ThumbCard, activateModal } from './chunk-E6ZOCXEA.js';
+export { CancelButton, ConfirmProvider, CopyButton, DocFavStar, Modal, ModalActions, PopupMenu, PopupMenuDivider, PopupMenuItem, PopupMenuLabel, ShellPrefsProvider, WindowCrashedFallback, WindowErrorBoundary, WindowManagerProvider, WindowTitle, commitExposeHighlight, confirm, confirmDestructive, exitExposeMode, getActiveWindowRoute, getExposeHighlight, getWindowPosition, isEntityEntry, isPageEntry, prompt, registerModalEscapeInterceptor, setExposeHighlight, setShellApiClient, setShellWindowRegistry, setWindowDefaultPosition, setWindowPosition, subscribeExposeHighlight, toggleExposeMode, useLocalStoragePrefs, useModalActive, useShellPrefs, useWidgetSettings, useWindowManager, useWindowMenuItem, useWindowTitle } from './chunk-E6ZOCXEA.js';
 import { glassStyle, startMenuCategories, navSections, isSection, GLASS_INPUT_BG, navIcons, sectionIcons } from './chunk-GW3RA6IS.js';
 export { GLASS_DIVIDER, GLASS_INPUT_BG, glassStyle, setShellNavIcons } from './chunk-GW3RA6IS.js';
 import { createContext, lazy, forwardRef, useCallback, useState, useRef, useEffect, useMemo, useLayoutEffect, useContext, isValidElement, cloneElement, Suspense, Fragment as Fragment$1, useId, Children, useSyncExternalStore } from 'react';
@@ -7601,10 +7600,84 @@ function useFilters() {
   }
   return { filterValues, setFilter, clearFilters, filterParams };
 }
+
+// src/shell/severity.ts
+var SEVERITY_TONES = ["success", "warning", "danger"];
+function isSeverityTone(value) {
+  return typeof value === "string" && SEVERITY_TONES.includes(value);
+}
+function severityOf(value, warn, crit) {
+  if (value == null || !Number.isFinite(value)) return null;
+  const warnAt = boundOf(warn);
+  const critAt = boundOf(crit);
+  if (warnAt == null && critAt == null) return null;
+  if (critAt != null && value >= critAt) return "danger";
+  if (warnAt != null && value >= warnAt) return "warning";
+  return "success";
+}
+function boundOf(value) {
+  return value != null && Number.isFinite(value) ? value : null;
+}
+var SEVERITY_FILL = {
+  success: "bg-green-500",
+  warning: "bg-amber-500",
+  danger: "bg-red-500"
+};
+var SEVERITY_INK = {
+  success: "text-gray-900",
+  warning: "text-amber-600",
+  danger: "text-red-600"
+};
+var SEVERITY_WORD = {
+  success: "ok",
+  warning: "warning",
+  danger: "critical"
+};
+var SEVERITY_UNKNOWN_FILL = "bg-gray-300 border border-red-500";
+var SEVERITY_UNKNOWN_INK = "text-gray-900";
+var TONE_STYLES = {
+  success: { tone: "success", fill: SEVERITY_FILL.success, ink: SEVERITY_INK.success, word: SEVERITY_WORD.success },
+  warning: { tone: "warning", fill: SEVERITY_FILL.warning, ink: SEVERITY_INK.warning, word: SEVERITY_WORD.warning },
+  danger: { tone: "danger", fill: SEVERITY_FILL.danger, ink: SEVERITY_INK.danger, word: SEVERITY_WORD.danger }
+};
+function styleForTone(tone) {
+  return tone == null ? null : TONE_STYLES[tone];
+}
+function describeToken(value) {
+  const raw = typeof value === "string" ? JSON.stringify(value) : typeof value === "number" || typeof value === "boolean" || typeof value === "bigint" ? String(value) : Object.prototype.toString.call(value);
+  return raw.length > 32 ? `${raw.slice(0, 31)}\u2026` : raw;
+}
+var reported = /* @__PURE__ */ new Set();
+function reportUnknownSeverity(component, described) {
+  const key = `${component}:${described}`;
+  if (reported.has(key)) return;
+  reported.add(key);
+  console.error(
+    `[react-os-shell] ${component}: severity ${described} is not one of ${SEVERITY_TONES.join(" | ")}. Rendering an "unknown severity" marker \u2014 a health marker must never silently disappear. If this came from a backend rollup, map it to the shell's vocabulary at the fetch boundary (see isSeverityTone).`
+  );
+}
+function resolveSeverity(severity, component) {
+  if (severity == null) return null;
+  if (isSeverityTone(severity)) return TONE_STYLES[severity];
+  const described = describeToken(severity);
+  reportUnknownSeverity(component, described);
+  return {
+    tone: null,
+    fill: SEVERITY_UNKNOWN_FILL,
+    ink: SEVERITY_UNKNOWN_INK,
+    word: `unrecognised severity ${described}`
+  };
+}
+function warnOnce(key, message) {
+  if (reported.has(key)) return;
+  reported.add(key);
+  console.error(message);
+}
 function SidebarGroupLabel({ children }) {
   return /* @__PURE__ */ jsx("p", { className: "px-2.5 pb-1 pt-1 text-[11px] font-semibold uppercase tracking-wide text-gray-400", children });
 }
-function SidebarNavItem({ label, count, active, onClick }) {
+function SidebarNavItem({ label, count, active, onClick, severity }) {
+  const marker = resolveSeverity(severity, "SidebarNavItem");
   return /* @__PURE__ */ jsxs(
     "button",
     {
@@ -7612,12 +7685,118 @@ function SidebarNavItem({ label, count, active, onClick }) {
       onClick,
       className: `flex w-full items-center justify-between gap-2 rounded-lg px-2.5 py-1.5 text-sm text-left ${active ? "bg-blue-50 font-medium text-blue-700" : "text-gray-700 hover:bg-gray-100"}`,
       children: [
-        /* @__PURE__ */ jsx("span", { className: "truncate", children: label }),
+        marker && // Decorative in the a11y tree — the word itself follows the label, so
+        // the item reads "Warehouses, warning, 12" in that order instead of
+        // leading with a tone before anyone knows what it belongs to.
+        /* @__PURE__ */ jsx(
+          "span",
+          {
+            "aria-hidden": "true",
+            title: marker.word,
+            className: `shrink-0 h-1.5 w-1.5 rounded-full ${marker.fill}`
+          }
+        ),
+        /* @__PURE__ */ jsx("span", { className: marker ? "truncate mr-auto" : "truncate", children: label }),
+        marker && /* @__PURE__ */ jsx("span", { className: "sr-only", children: marker.word }),
         count != null && count > 0 && /* @__PURE__ */ jsx("span", { className: `shrink-0 inline-flex items-center justify-center min-w-[1.25rem] px-1.5 h-5 rounded-full text-[11px] font-medium ${active ? "bg-blue-100 text-blue-700" : "bg-gray-100 text-gray-600"}`, children: count })
       ]
     }
   );
 }
+function Tick({ at, title, className }) {
+  return /* @__PURE__ */ jsx(
+    "div",
+    {
+      title,
+      className: `absolute -top-[3px] h-3 w-0.5 rounded-[1px] ${className}`,
+      style: { left: `${at}%` }
+    }
+  );
+}
+var clampPct = (n) => Math.min(100, Math.max(0, n));
+function MetricBar({
+  label,
+  value,
+  max = 100,
+  warn,
+  crit,
+  severity,
+  detail,
+  formatValue,
+  emptyLabel = "no data",
+  size = "sm",
+  ariaLabel,
+  className = ""
+}) {
+  const reading = value != null && Number.isFinite(value) ? value : null;
+  const scale = Number.isFinite(max) && max > 0 ? max : null;
+  if (scale == null) {
+    warnOnce(
+      `MetricBar:max:${String(max)}`,
+      `[react-os-shell] MetricBar: max=${String(max)} is not a positive finite number, so there is no scale to draw a proportional bar against. Printing the value without a bar. Pass the real capacity, or leave the reading out entirely (value={null}) when it is unknown \u2014 do not pass 0.`
+    );
+  }
+  const supplied = resolveSeverity(severity, "MetricBar");
+  const paint = reading != null ? supplied ?? styleForTone(severityOf(reading, warn, crit)) : null;
+  const warnAt = boundOf(warn);
+  const critAt = boundOf(crit);
+  const width = reading != null && scale != null ? clampPct(reading / scale * 100) : 0;
+  const format = formatValue ?? ((v) => scale === 100 ? `${v.toFixed(1)}%` : String(v));
+  const printed = reading != null ? format(reading) : "\u2014";
+  const showTicks = reading != null && scale != null && (warnAt != null || critAt != null);
+  const meterLabel = ariaLabel ?? (typeof label === "string" ? label : void 0);
+  const barHeight = size === "md" ? "h-2" : "h-1.5";
+  const isMeter = reading != null && scale != null;
+  const bar = /* @__PURE__ */ jsxs(
+    "div",
+    {
+      ...isMeter ? {
+        role: "meter",
+        "aria-label": meterLabel,
+        "aria-valuemin": 0,
+        "aria-valuemax": scale,
+        // Kept inside the declared range: the bar clamps, and a valuenow
+        // past its own valuemax is an invalid widget. `aria-valuetext`
+        // still carries the unclamped truth, and takes precedence in the
+        // announcement.
+        "aria-valuenow": Math.min(scale, Math.max(0, reading)),
+        "aria-valuetext": printed
+      } : { "aria-hidden": true },
+      className: isMeter && paint ? `relative mt-2 ${barHeight} rounded-full bg-gray-200` : `relative mt-2 ${barHeight} rounded-full border border-dashed border-gray-300 bg-transparent`,
+      children: [
+        isMeter && // Grey when unjudged: the magnitude is real, the verdict is not ours.
+        /* @__PURE__ */ jsx(
+          "div",
+          {
+            className: `absolute inset-y-0 left-0 rounded-full ${paint ? paint.fill : "bg-gray-400"}`,
+            style: { width: `${width}%` }
+          }
+        ),
+        showTicks && scale != null && warnAt != null && /* @__PURE__ */ jsx(Tick, { at: clampPct(warnAt / scale * 100), title: `warning \u2265 ${warnAt}`, className: "bg-gray-400 opacity-75" }),
+        showTicks && scale != null && critAt != null && /* @__PURE__ */ jsx(Tick, { at: clampPct(critAt / scale * 100), title: `critical \u2265 ${critAt}`, className: "bg-gray-500" })
+      ]
+    }
+  );
+  const valueInk = paint ? paint.ink : reading != null ? "text-gray-900" : "text-gray-400";
+  if (size === "md") {
+    return /* @__PURE__ */ jsxs("div", { className, children: [
+      label != null && /* @__PURE__ */ jsx("div", { className: "text-[10px] font-medium uppercase tracking-wide text-gray-500", children: label }),
+      /* @__PURE__ */ jsxs("div", { className: "mt-1 flex items-baseline gap-2", children: [
+        /* @__PURE__ */ jsx("span", { className: `text-2xl font-semibold leading-[30px] tabular-nums ${valueInk}`, children: printed }),
+        /* @__PURE__ */ jsx("span", { className: "min-w-0 truncate text-[11px] tabular-nums text-gray-400", children: reading != null ? detail : emptyLabel })
+      ] }),
+      bar
+    ] });
+  }
+  return /* @__PURE__ */ jsxs("div", { className, children: [
+    /* @__PURE__ */ jsxs("div", { className: "flex items-baseline gap-2", children: [
+      label != null && /* @__PURE__ */ jsx("span", { className: "w-14 shrink-0 truncate text-[10px] font-medium uppercase tracking-wide text-gray-500", children: label }),
+      /* @__PURE__ */ jsx("span", { className: `text-sm font-semibold tabular-nums ${valueInk}`, children: printed }),
+      /* @__PURE__ */ jsx("span", { className: "ml-auto min-w-0 truncate text-[10px] tabular-nums text-gray-400", children: reading != null ? detail : emptyLabel })
+    ] }),
+    bar
+  ] });
+}
 
 // src/utils/mergeBulkItems.ts
 function findDuplicateKeys(rows, keyRowKey) {
@@ -9700,6 +9879,6 @@ function useEditHotkey(callback) {
   }, [callback, isActive]);
 }
 
-export { ALT, ALT_SHIFT_D, ALT_SHIFT_E, ALT_SHIFT_N, Accordion, AuthScreen, Avatar, AvatarGroup, Banner, BarChart, BehaviorPanel, BulkImportGrid, Button_default as Button, CMD_A, CMD_DOT, CMD_ENTER, CMD_K, CMD_S, Card, ChangePasswordForm, ChatTemplate, Checkbox_default as Checkbox, CheckoutTemplate, ColoredBadge, ContainerFillChart, Customization, DEV_BANNER_TEXT, DashboardTemplate, DataTablePage, Desktop, DesktopHostProvider, DevIndicator, DonutChart, ENTER, EmailTemplate, EmptyState, EntityList, ErrorPage, FilterBar, FormField, FormLayoutPage, GalleryTemplate, GlobalSearch, HelpCenter, INPUT_BASE, Input_default as Input, Kanban, Label, Layout, ListFooter, LoadingSpinner2 as LoadingSpinner, MOD, Markdown, MediaUploadField, MediaUploadGrid, MilestoneTimeline, NotificationBell, PageHeader, Pagination, PdfActionButton, Radio_default as Radio, ResizableTable, SHIFT, SearchableSelect, Select_default as Select, ServerStatusIndicator, ShellEntityFetcherProvider, ShortcutHelp, SidebarActionButton, SidebarGroupLabel, SidebarNavItem, SoundsPanel, Sparkline, StartMenu, StatCard, StatusBadge, StatusBadgeProvider, SystemPreferences, Tabs, Textarea_default as Textarea, Tooltip, TopNav, WidgetManager, applyDevTitle, createWindowRegistry, findDuplicateKeys, formatDate, inputClasses, isDevEnv, isMac, mediaFileName, mergeBulkItems, useClickOutside, useColumnConfig, useDesktopHost, useEditHotkey, useFilters, useInfiniteScroll, useNewHotkey, useShellEntityFetcher, useSort, useTableNav };
+export { ALT, ALT_SHIFT_D, ALT_SHIFT_E, ALT_SHIFT_N, Accordion, AuthScreen, Avatar, AvatarGroup, Banner, BarChart, BehaviorPanel, BulkImportGrid, Button_default as Button, CMD_A, CMD_DOT, CMD_ENTER, CMD_K, CMD_S, Card, ChangePasswordForm, ChatTemplate, Checkbox_default as Checkbox, CheckoutTemplate, ColoredBadge, ContainerFillChart, Customization, DEV_BANNER_TEXT, DashboardTemplate, DataTablePage, Desktop, DesktopHostProvider, DevIndicator, DonutChart, ENTER, EmailTemplate, EmptyState, EntityList, ErrorPage, FilterBar, FormField, FormLayoutPage, GalleryTemplate, GlobalSearch, HelpCenter, INPUT_BASE, Input_default as Input, Kanban, Label, Layout, ListFooter, LoadingSpinner2 as LoadingSpinner, MOD, Markdown, MediaUploadField, MediaUploadGrid, MetricBar, MilestoneTimeline, NotificationBell, PageHeader, Pagination, PdfActionButton, Radio_default as Radio, ResizableTable, SHIFT, SearchableSelect, Select_default as Select, ServerStatusIndicator, ShellEntityFetcherProvider, ShortcutHelp, SidebarActionButton, SidebarGroupLabel, SidebarNavItem, SoundsPanel, Sparkline, StartMenu, StatCard, StatusBadge, StatusBadgeProvider, SystemPreferences, Tabs, Textarea_default as Textarea, Tooltip, TopNav, WidgetManager, applyDevTitle, createWindowRegistry, findDuplicateKeys, formatDate, inputClasses, isDevEnv, isMac, isSeverityTone, mediaFileName, mergeBulkItems, severityOf, useClickOutside, useColumnConfig, useDesktopHost, useEditHotkey, useFilters, useInfiniteScroll, useNewHotkey, useShellEntityFetcher, useSort, useTableNav };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map