react-os-shell 4.4.0 → 4.6.0

package/dist/index.js

@@ -15,8 +15,8 @@ export { setShellAuthBridge } from './chunk-3NZSR3ZG.js';
 import { EditableGrid } from './chunk-GP4Y3VCB.js';
 export { EditableGrid } from './chunk-GP4Y3VCB.js';
 import './chunk-4SQU5YV6.js';
-import { APP_VERSION, VERSION } from './chunk-GDOCYHAG.js';
-export { VERSION } from './chunk-GDOCYHAG.js';
+import { APP_VERSION, VERSION } from './chunk-3DIOUFVR.js';
+export { VERSION } from './chunk-3DIOUFVR.js';
 import { registerModalEscapeInterceptor, useIsMobile, useWindowManager, PopupMenu, PopupMenuLabel, PopupMenuDivider, PopupMenuItem, WINDOW_REGISTRY, isPageEntry, Modal, setPerfCollecting, drainPerfEvents, useShellPrefs, markMenuOpen, SIDEBAR_STRIP_W, forgetMaximizedWindowBoxes, ModalActions, useModalActive, client_default, LoadingSpinner, isShellApiClientConfigured, useUndo, CancelButton, setWindowPosition } from './chunk-EF5W3EXL.js';
 export { CancelButton, ConfirmProvider, CopyButton, DocFavStar, Modal, ModalActions, PopupMenu, PopupMenuDivider, PopupMenuItem, PopupMenuLabel, ShellPrefsProvider, UndoProvider, WindowCrashedFallback, WindowErrorBoundary, WindowManagerProvider, WindowTitle, beginWindowGesture, commitExposeHighlight, confirm, confirmDestructive, exitExposeMode, getActiveWindowRoute, getExposeHighlight, getWindowPosition, isEntityEntry, isPageEntry, markMenuOpen, prompt, registerModalEscapeInterceptor, setExposeHighlight, setShellApiClient, setShellWindowRegistry, setWindowDefaultPosition, setWindowPosition, subscribeExposeHighlight, toggleExposeMode, useIsActiveWindow, useLocalStoragePrefs, useModalActive, useShellPrefs, useUndo, useUndoable, useUndoableState, useWidgetSettings, useWindowManager, useWindowMenuItem, useWindowTitle } from './chunk-EF5W3EXL.js';
 import { glassStyle, startMenuCategories, navSections, isSection, GLASS_INPUT_BG, navIcons, isReachable, sectionIcons, useShellAuth, visibleChildren } from './chunk-DKDD5KXG.js';
@@ -466,9 +466,9 @@ function HelpCenter({
       (a, b) => (rank.get(a.key) ?? Infinity) - (rank.get(b.key) ?? Infinity)
     );
   }, [docs, categoryOrder]);
-  const matches = (doc) => !q || doc.title.toLowerCase().includes(q) || doc.body.toLowerCase().includes(q) || doc.category_label.toLowerCase().includes(q);
+  const matches2 = (doc) => !q || doc.title.toLowerCase().includes(q) || doc.body.toLowerCase().includes(q) || doc.category_label.toLowerCase().includes(q);
   const visibleGroups = useMemo(
-    () => groups.map((g) => ({ ...g, docs: g.docs.filter(matches) })).filter((g) => g.docs.length > 0),
+    () => groups.map((g) => ({ ...g, docs: g.docs.filter(matches2) })).filter((g) => g.docs.length > 0),
     [groups, q]
   );
   const visibleDocs = useMemo(() => visibleGroups.flatMap((g) => g.docs), [visibleGroups]);
@@ -1399,13 +1399,13 @@ function summariseFrames(timestamps) {
   };
 }
 function classify(reading) {
-  const { fps, blockedPct } = reading;
+  const { fps: fps2, blockedPct } = reading;
   const threadBlocked = blockedPct !== null && blockedPct >= BLOCKED_PCT_CPU;
-  if (!Number.isFinite(fps) || fps <= 0) {
+  if (!Number.isFinite(fps2) || fps2 <= 0) {
     if (threadBlocked) return CPU_BOUND;
     return { kind: "unknown", label: "Measuring\u2026", detail: "Collecting frame timings." };
   }
-  if (fps >= SMOOTH_FPS) {
+  if (fps2 >= SMOOTH_FPS) {
     return {
       kind: "smooth",
       label: "Smooth",
@@ -1550,6 +1550,138 @@ function toCsv(log) {
     ...log.map((r) => CSV_COLUMNS.map((c) => cell(r[c])).join(","))
   ].join("\n");
 }
+
+// src/shell/perfEnvironment.ts
+function pickBrand(brands) {
+  if (!brands?.length) return null;
+  const real = brands.filter((b) => !/not[^a-z]*a[^a-z]*brand/i.test(b.brand));
+  const named = real.find((b) => b.brand !== "Chromium") ?? real[0];
+  return named ? `${named.brand} ${named.version}` : null;
+}
+function asString(value) {
+  return typeof value === "string" && value ? value : null;
+}
+async function requestAsyncEnvironment() {
+  return { hints: await readHints(), battery: await readBattery() };
+}
+async function readHints() {
+  const uaData = navigator.userAgentData;
+  if (!uaData) return null;
+  const base = {
+    platform: uaData.platform ?? null,
+    platformVersion: null,
+    architecture: null,
+    model: null,
+    browser: pickBrand(uaData.brands)
+  };
+  if (!uaData.getHighEntropyValues) return base;
+  try {
+    const high = await uaData.getHighEntropyValues([
+      "platform",
+      "platformVersion",
+      "architecture",
+      "model",
+      "fullVersionList"
+    ]);
+    const full = high.fullVersionList;
+    return {
+      platform: asString(high.platform) ?? base.platform,
+      platformVersion: asString(high.platformVersion),
+      architecture: asString(high.architecture),
+      model: asString(high.model),
+      // The full list carries the build number; the low-entropy brands only
+      // carry the major, which is not enough to match against a known bug.
+      browser: pickBrand(full) ?? base.browser
+    };
+  } catch {
+    return base;
+  }
+}
+async function readBattery() {
+  const getBattery = navigator.getBattery;
+  if (!getBattery) return null;
+  try {
+    const battery = await getBattery.call(navigator);
+    return { charging: battery.charging, level: battery.level };
+  } catch {
+    return null;
+  }
+}
+function readGpu() {
+  if (typeof document === "undefined") return { renderer: null, vendor: null, available: false };
+  try {
+    const gl = document.createElement("canvas").getContext("webgl");
+    if (!gl) return { renderer: null, vendor: null, available: false };
+    const debug = gl.getExtension("WEBGL_debug_renderer_info");
+    const renderer = debug ? gl.getParameter(debug.UNMASKED_RENDERER_WEBGL) : gl.getParameter(gl.RENDERER);
+    const vendor = debug ? gl.getParameter(debug.UNMASKED_VENDOR_WEBGL) : gl.getParameter(gl.VENDOR);
+    gl.getExtension("WEBGL_lose_context")?.loseContext();
+    return { renderer: asString(renderer), vendor: asString(vendor), available: true };
+  } catch {
+    return { renderer: null, vendor: null, available: false };
+  }
+}
+function matches(query) {
+  try {
+    return window.matchMedia(query).matches;
+  } catch {
+    return false;
+  }
+}
+function readEnvironment(async_) {
+  const nav = navigator;
+  const memory = performance.memory;
+  const hints = async_?.hints ?? null;
+  const gpu = readGpu();
+  const conn = nav.connection;
+  return {
+    userAgent: nav.userAgent,
+    browser: hints?.browser ?? null,
+    platform: hints?.platform ?? null,
+    platformVersion: hints?.platformVersion ?? null,
+    architecture: hints?.architecture ?? null,
+    model: hints?.model ?? null,
+    cpuCores: typeof nav.hardwareConcurrency === "number" ? nav.hardwareConcurrency : null,
+    deviceMemoryGB: typeof nav.deviceMemory === "number" ? nav.deviceMemory : null,
+    gpu: gpu.renderer,
+    gpuVendor: gpu.vendor,
+    webglAvailable: gpu.available,
+    screen: {
+      width: screen.width,
+      height: screen.height,
+      dpr: window.devicePixelRatio,
+      colorDepth: typeof screen.colorDepth === "number" ? screen.colorDepth : null
+    },
+    viewport: { width: window.innerWidth, height: window.innerHeight },
+    heapLimitMB: memory ? Math.round(memory.jsHeapSizeLimit / 1048576) : null,
+    network: conn ? {
+      effectiveType: asString(conn.effectiveType),
+      downlinkMbps: typeof conn.downlink === "number" ? conn.downlink : null,
+      rttMs: typeof conn.rtt === "number" ? conn.rtt : null,
+      saveData: conn.saveData === true
+    } : null,
+    battery: async_?.battery ?? null,
+    prefersReducedMotion: matches("(prefers-reduced-motion: reduce)"),
+    forcedColors: matches("(forced-colors: active)"),
+    reducedTransparency: document.documentElement.classList.contains("rosh-reduce-transparency"),
+    touchPoints: typeof nav.maxTouchPoints === "number" ? nav.maxTouchPoints : null
+  };
+}
+function describeMachine(env) {
+  const parts = [];
+  if (env.browser) parts.push(env.browser);
+  const os = [env.platform, env.platformVersion].filter(Boolean).join(" ");
+  if (os) parts.push(env.architecture ? `${os} (${env.architecture})` : os);
+  if (env.gpu) parts.push(env.gpu);
+  else if (!env.webglAvailable) parts.push("no WebGL (software rendering)");
+  if (env.cpuCores) parts.push(`${env.cpuCores} cores`);
+  if (env.deviceMemoryGB) parts.push(`${env.deviceMemoryGB}GB+ RAM`);
+  parts.push(`${env.screen.width}\xD7${env.screen.height} @${env.screen.dpr}x`);
+  if (env.battery && !env.battery.charging) parts.push(`on battery ${Math.round(env.battery.level * 100)}%`);
+  if (env.reducedTransparency) parts.push("reduce transparency on");
+  if (env.prefersReducedMotion) parts.push("reduced motion");
+  return parts.join(" \xB7 ");
+}
 var FLUSH_MS = 500;
 var WINDOW_MS = 1e3;
 var HISTORY = 40;
@@ -1586,6 +1718,7 @@ function PerfStats({ onClose, onSubmit, className = "" }) {
   const startedAtRef = useRef(0);
   const persistedAtRef = useRef(0);
   const snapshotRef = useRef(null);
+  const envRef = useRef(null);
   const [longTaskSupported, setLongTaskSupported] = useState(false);
   const [reading, setReading] = useState({ fps: 0, frameMs: 0, worstMs: 0, blockedPct: null });
   const [history, setHistory] = useState([]);
@@ -1599,6 +1732,15 @@ function PerfStats({ onClose, onSubmit, className = "" }) {
     setPerfCollecting(true);
     return () => setPerfCollecting(false);
   }, []);
+  useEffect(() => {
+    let live = true;
+    requestAsyncEnvironment().then((env) => {
+      if (live) envRef.current = env;
+    });
+    return () => {
+      live = false;
+    };
+  }, []);
   useEffect(() => {
     let raf = 0;
     const tick = (now) => {
@@ -1733,20 +1875,21 @@ function PerfStats({ onClose, onSubmit, className = "" }) {
   const buildReport = useCallback(() => {
     const records = snapshotRef.current ?? logRef.current;
     const stamp = (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-").slice(0, 19);
+    const summary = summariseLog(records);
+    const environment = readEnvironment(envRef.current);
     return {
       message,
       filename: `perf-log-${stamp}.json`,
-      summary: summariseLog(records),
+      summary,
+      environment,
       verdict: verdict.label,
       json: JSON.stringify(
         {
           generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
           message,
           verdict: verdict.label,
-          userAgent: navigator.userAgent,
-          screen: { width: window.screen.width, height: window.screen.height, dpr: window.devicePixelRatio },
-          reducedTransparency: document.documentElement.classList.contains("rosh-reduce-transparency"),
-          summary: summariseLog(records),
+          environment,
+          summary,
           records
         },
         null,
@@ -4973,7 +5116,7 @@ function Customization({ omit, section } = {}) {
           /* @__PURE__ */ jsxs("span", { className: "text-sm text-gray-700", children: [
             "Show performance stats",
             /* @__PURE__ */ jsx("span", { className: "block text-xs text-gray-400", children: "Overlays frame rate, worst frame time and a bottleneck reading on the desktop, beside the version number. Turn it on to check whether Reduce transparency actually helps on this machine \u2014 or whether the slowness is coming from somewhere else." }),
-            /* @__PURE__ */ jsx("span", { className: "block text-xs text-gray-400 mt-1", children: "While it is on, each reading is recorded with what was happening at the time \u2014 how many windows were open, which one was on top, which menu or submenu you opened, how long you spent moving or resizing a window, and counts of clicks, keystrokes and scrolls. No page content or keystroke text is recorded. The log stays on this device unless you use the overlay's Report button, which sends it \u2014 with whatever you type in the box \u2014 to the team as a bug report." })
+            /* @__PURE__ */ jsx("span", { className: "block text-xs text-gray-400 mt-1", children: "While it is on, each reading is recorded with what was happening at the time \u2014 how many windows were open, which one was on top, which menu or submenu you opened, how long you spent moving or resizing a window, and counts of clicks, keystrokes and scrolls. No page content or keystroke text is recorded. The log stays on this device unless you use the overlay's Report button, which sends it \u2014 with whatever you type in the box, and a description of this computer (browser, operating system, processor cores, memory, graphics card, screen, connection speed and whether you are on battery) \u2014 to the team as a bug report." })
           ] })
         ] })
       ] })
@@ -8521,6 +8664,46 @@ function MetricBar({
   ] });
 }
 
+// src/shell/perfDescribe.ts
+var TOP_GROUPS = 3;
+var fps = (n) => n > 0 ? `${n.toFixed(0)} fps` : "stalled";
+var duration = (ms) => {
+  const seconds = Math.round(ms / 1e3);
+  return seconds < 60 ? `${seconds}s` : `${Math.round(seconds / 60)}m`;
+};
+function describePerfReport(report) {
+  const { summary, message, verdict, environment } = report;
+  const lines = [`Performance report \u2014 ${verdict}`, ""];
+  lines.push(message.trim() || "(No description given.)", "");
+  lines.push(`Machine: ${describeMachine(environment)}`);
+  const net = environment.network;
+  if (net?.effectiveType && net.effectiveType !== "4g") {
+    lines.push(`Connection: ${net.effectiveType}${net.rttMs ? ` \xB7 ${net.rttMs} ms round trip` : ""}`);
+  }
+  lines.push("");
+  lines.push(
+    `Median ${fps(summary.medianFps)} over ${duration(summary.durationMs)} (${summary.samples} samples), worst frame ${summary.worstFrameMs.toFixed(0)} ms.`
+  );
+  const activity = summary.byActivity.slice(0, TOP_GROUPS);
+  if (activity.length) {
+    lines.push(
+      `Slowest while: ${activity.map((a) => `${a.kind} ${fps(a.medianFps)} (worst ${a.worstMs.toFixed(0)} ms)`).join(" \xB7 ")}`
+    );
+  }
+  const menu = summary.worstMenus[0];
+  if (menu) lines.push(`Slowest menu: ${menu.key} \u2014 ${fps(menu.medianFps)}`);
+  const win = summary.worstWindows[0];
+  if (win) lines.push(`Slowest window: ${win.key} \u2014 ${fps(win.medianFps)}`);
+  if (summary.idle && summary.interacting) {
+    lines.push(`At rest ${fps(summary.idle.medianFps)} vs in use ${fps(summary.interacting.medianFps)}.`);
+  }
+  lines.push("", `Full log attached as ${report.filename}.`);
+  return lines.join("\n");
+}
+function perfReportFile(report) {
+  return new File([report.json], report.filename, { type: "application/json" });
+}
+
 // src/utils/mergeBulkItems.ts
 function findDuplicateKeys(rows, keyRowKey) {
   const groups = /* @__PURE__ */ new Map();
@@ -10637,6 +10820,6 @@ function useEditHotkey(callback) {
   }, [callback, isActive]);
 }
 
-export { ALT, ALT_SHIFT_D, ALT_SHIFT_E, ALT_SHIFT_N, Accordion, AuthScreen, Avatar, AvatarGroup, BLOCKED_PCT_CPU, 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, DateRangePicker, Desktop, DesktopHostProvider, DevIndicator, DonutChart, ENTER, EmailTemplate, EmptyState, EntityList, ErrorPage, FilterBar, FormField, FormLayoutPage, GalleryTemplate, GlobalSearch, HelpCenter, INPUT_BASE, Input_default as Input, Kanban, LOG_CAP, Label, Layout, ListFooter, ListLoadError, LoadingSpinner2 as LoadingSpinner, MIN_EVENT_SAMPLES, MIN_GROUP_SAMPLES, MOD, Markdown, MediaUploadField, MediaUploadGrid, MetricBar, MilestoneTimeline, NativeSelect, NotificationBell, PageHeader, Pagination, PdfActionButton, PerfStats, Radio_default as Radio, ResizableTable, SHIFT, SMOOTH_FPS, 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, UndoControls, WidgetManager, appendRecord as appendPerfRecord, applyDevTitle, classifyActivity, classify as classifyPerf, createWindowRegistry, findDuplicateKeys, formatDate, inputClasses, isDevEnv, isInteracting, isMac, isSeverityTone, mediaFileName, mergeBulkItems, toCsv as perfLogToCsv, severityOf, summariseFrames, summariseLog as summarisePerfLog, toISODate2 as toISODate, 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, BLOCKED_PCT_CPU, 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, DateRangePicker, Desktop, DesktopHostProvider, DevIndicator, DonutChart, ENTER, EmailTemplate, EmptyState, EntityList, ErrorPage, FilterBar, FormField, FormLayoutPage, GalleryTemplate, GlobalSearch, HelpCenter, INPUT_BASE, Input_default as Input, Kanban, LOG_CAP, Label, Layout, ListFooter, ListLoadError, LoadingSpinner2 as LoadingSpinner, MIN_EVENT_SAMPLES, MIN_GROUP_SAMPLES, MOD, Markdown, MediaUploadField, MediaUploadGrid, MetricBar, MilestoneTimeline, NativeSelect, NotificationBell, PageHeader, Pagination, PdfActionButton, PerfStats, Radio_default as Radio, ResizableTable, SHIFT, SMOOTH_FPS, 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, UndoControls, WidgetManager, appendRecord as appendPerfRecord, applyDevTitle, classifyActivity, classify as classifyPerf, createWindowRegistry, describeMachine, describePerfReport, findDuplicateKeys, formatDate, inputClasses, isDevEnv, isInteracting, isMac, isSeverityTone, mediaFileName, mergeBulkItems, toCsv as perfLogToCsv, perfReportFile, readEnvironment as readPerfEnvironment, requestAsyncEnvironment, severityOf, summariseFrames, summariseLog as summarisePerfLog, toISODate2 as toISODate, useClickOutside, useColumnConfig, useDesktopHost, useEditHotkey, useFilters, useInfiniteScroll, useNewHotkey, useShellEntityFetcher, useSort, useTableNav };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map