@flamingo-stack/openframe-frontend-core 0.0.705 → 0.0.706-snapshot.20261006190707

package/dist/{chunk-MKXO4Q5P.js → chunk-KUC673HM.js}

@@ -9,7 +9,7 @@ import {
   parseSchemaParams,
   positiveInt,
   shouldIncludeInUrl
-} from "./chunk-MP2C3LJ4.js";
+} from "./chunk-CUME3VTQ.js";
 import {
   ToolIcon,
   apiErrorMessage,
@@ -18,30 +18,28 @@ import {
   scrollElementIntoView,
   useAutoplay,
   useDebounce
-} from "./chunk-PDWVPI3S.js";
+} from "./chunk-CZ7Y7UG4.js";
 import {
   useRouter,
   useSearchParams
 } from "./chunk-GY4IZG22.js";
-import {
-  FlamingoLogo,
-  MlgLogo,
-  OpenmspLogo
-} from "./chunk-2YXVWZVF.js";
-import {
-  Chevron02DownIcon,
-  XmarkIcon
-} from "./chunk-Z2VNQQ74.js";
 import {
   breakpoints,
   createLocalStorageAdapter,
   getPlatformBrandClasses,
   useMediaQuery
-} from "./chunk-NDESEPW5.js";
+} from "./chunk-FXJ3WWUB.js";
 import {
+  FlamingoLogo,
   MiamiCyberGangLogoFaceOnly,
-  OpenFrameLogo
-} from "./chunk-O43V3EOS.js";
+  MlgLogo,
+  OpenFrameLogo,
+  OpenmspLogo
+} from "./chunk-N45D4ZXQ.js";
+import {
+  Chevron02DownIcon,
+  XmarkIcon
+} from "./chunk-NCPTID44.js";
 import {
   cn
 } from "./chunk-7RXWKTAP.js";
@@ -897,8 +895,219 @@ function useWindowSize() {
 // src/hooks/ui/index.ts
 import { usePreventScroll } from "@react-aria/overlays";
 
+// src/hooks/ui/use-active-section.ts
+import { useMemo as useMemo3 } from "react";
+function pathOf(href) {
+  if (!href || !href.startsWith("/") || href.startsWith("//")) return null;
+  const path = href.split(/[?#]/)[0];
+  return path.length > 1 ? path.replace(/\/+$/, "") : "/";
+}
+function prefixHolds(prefix, pathname) {
+  if (prefix === "/") return pathname === "/";
+  return pathname === prefix || pathname.startsWith(`${prefix}/`);
+}
+function resolveActiveSection(menus, pathname) {
+  const current = pathOf(pathname ?? void 0);
+  if (!current) return null;
+  let best = null;
+  for (const menu of menus) {
+    const prefixes = menu.match?.length ? menu.match : [menu.href];
+    for (const raw of prefixes) {
+      const prefix = pathOf(raw);
+      if (!prefix || !prefixHolds(prefix, current)) continue;
+      if (!best || prefix.length > best.length) best = { id: menu.id, length: prefix.length };
+    }
+  }
+  return best?.id ?? null;
+}
+function useActiveSection(menus, pathname) {
+  return useMemo3(() => resolveActiveSection(menus, pathname), [menus, pathname]);
+}
+
+// src/hooks/ui/use-nav-menus.ts
+import {
+  useCallback as useCallback8,
+  useEffect as useEffect10,
+  useId,
+  useRef as useRef8,
+  useState as useState10
+} from "react";
+function useNavMenus({
+  pathname,
+  hoverOpenMs = 150,
+  hoverCloseMs = 300
+}) {
+  const baseId = useId();
+  const [opened, setOpened] = useState10(null);
+  const stale = opened !== null && opened.pathname !== pathname;
+  if (stale) setOpened(null);
+  const openId = opened && !stale ? opened.id : null;
+  const triggers = useRef8(/* @__PURE__ */ new Map());
+  const panels = useRef8(/* @__PURE__ */ new Map());
+  const openTimer = useRef8(null);
+  const closeTimer = useRef8(null);
+  const openedByHover = useRef8(null);
+  const clearTimers = useCallback8(() => {
+    if (openTimer.current) clearTimeout(openTimer.current);
+    if (closeTimer.current) clearTimeout(closeTimer.current);
+    openTimer.current = null;
+    closeTimer.current = null;
+  }, []);
+  useEffect10(() => clearTimers, [clearTimers]);
+  const close = useCallback8(() => {
+    clearTimers();
+    setOpened(null);
+  }, [clearTimers]);
+  const cancelClose = useCallback8(() => {
+    if (closeTimer.current) clearTimeout(closeTimer.current);
+    closeTimer.current = null;
+  }, []);
+  const scheduleClose = useCallback8(() => {
+    if (openTimer.current) clearTimeout(openTimer.current);
+    openTimer.current = null;
+    cancelClose();
+    closeTimer.current = setTimeout(() => {
+      closeTimer.current = null;
+      setOpened(null);
+    }, hoverCloseMs);
+  }, [cancelClose, hoverCloseMs]);
+  useEffect10(() => {
+    if (!openId) return void 0;
+    const handleKeyDown = (event) => {
+      if (event.key !== "Escape") return;
+      const trigger = triggers.current.get(openId);
+      close();
+      trigger?.focus({ preventScroll: true });
+    };
+    const handlePointerDown = (event) => {
+      const target = event.target;
+      if (!(target instanceof Node)) return;
+      for (const el of triggers.current.values()) if (el.contains(target)) return;
+      for (const el of panels.current.values()) if (el.contains(target)) return;
+      close();
+    };
+    document.addEventListener("keydown", handleKeyDown);
+    document.addEventListener("pointerdown", handlePointerDown);
+    return () => {
+      document.removeEventListener("keydown", handleKeyDown);
+      document.removeEventListener("pointerdown", handlePointerDown);
+    };
+  }, [openId, close]);
+  const getTriggerProps = useCallback8(
+    (id) => ({
+      ref: (el) => {
+        if (el) triggers.current.set(id, el);
+        else triggers.current.delete(id);
+      },
+      "aria-expanded": openId === id,
+      "aria-controls": `${baseId}-panel-${id}`,
+      onClick: () => {
+        clearTimers();
+        const hovered = openedByHover.current === id;
+        openedByHover.current = null;
+        if (hovered) {
+          setOpened({ id, pathname });
+          return;
+        }
+        setOpened((prev) => prev && prev.id === id && prev.pathname === pathname ? null : { id, pathname });
+      },
+      onMouseEnter: () => {
+        clearTimers();
+        if (openId === id) return;
+        if (openId !== null) {
+          openedByHover.current = id;
+          setOpened({ id, pathname });
+          return;
+        }
+        openTimer.current = setTimeout(() => {
+          openTimer.current = null;
+          openedByHover.current = id;
+          setOpened({ id, pathname });
+        }, hoverOpenMs);
+      },
+      onMouseLeave: scheduleClose
+    }),
+    [baseId, openId, pathname, hoverOpenMs, clearTimers, scheduleClose]
+  );
+  const getPanelProps = useCallback8(
+    (id) => ({
+      ref: (el) => {
+        if (el) panels.current.set(id, el);
+        else panels.current.delete(id);
+      },
+      id: `${baseId}-panel-${id}`,
+      inert: openId !== id,
+      "data-state": openId === id ? "open" : "closed",
+      onMouseEnter: cancelClose,
+      onMouseLeave: scheduleClose
+    }),
+    [baseId, openId, cancelClose, scheduleClose]
+  );
+  return { openId, close, getTriggerProps, getPanelProps };
+}
+
+// src/hooks/ui/use-visitor-os.ts
+import { useSyncExternalStore as useSyncExternalStore2 } from "react";
+
+// src/utils/visitor-os.ts
+var DESKTOP_OSES = ["mac", "windows", "linux"];
+var HINT_PLATFORMS = {
+  macos: "mac",
+  windows: "windows",
+  linux: "linux",
+  "chrome os": "linux",
+  "chromium os": "linux",
+  android: "android",
+  ios: "ios"
+};
+function detectVisitorOs(userAgent, hints = {}) {
+  const touchMac = (os) => os === "mac" && (hints.maxTouchPoints ?? 0) > 1 ? "ios" : os;
+  const hinted = HINT_PLATFORMS[(hints.platform ?? "").replace(/"/g, "").trim().toLowerCase()];
+  if (hinted) return touchMac(hinted);
+  const ua = userAgent ?? "";
+  if (!ua) return null;
+  if (/iPhone|iPad|iPod/i.test(ua)) return "ios";
+  if (/Android/i.test(ua)) return "android";
+  if (/Windows NT|Win64|Win32/i.test(ua)) return "windows";
+  if (/Macintosh|Mac OS X/i.test(ua)) return touchMac("mac");
+  if (/Linux|X11|CrOS/i.test(ua)) return "linux";
+  return null;
+}
+function desktopOsOf(os) {
+  return os !== null && DESKTOP_OSES.includes(os) ? os : null;
+}
+function detectDesktopOs(userAgent, hints) {
+  return desktopOsOf(detectVisitorOs(userAgent, hints));
+}
+function usesCommandKey(os) {
+  return os === "mac" || os === "ios";
+}
+function shortcutLabel(os, key) {
+  return usesCommandKey(os) ? `\u2318${key}` : `Ctrl ${key}`;
+}
+
+// src/hooks/ui/use-visitor-os.ts
+var UNKNOWN = { known: false, os: null };
+var KNOWN = /* @__PURE__ */ new Map();
+var subscribe2 = () => () => {
+};
+var getServerSnapshot = () => UNKNOWN;
+function getSnapshot() {
+  const stated = navigator.userAgentData?.platform;
+  const os = detectVisitorOs(navigator.userAgent, { platform: stated, maxTouchPoints: navigator.maxTouchPoints });
+  let state = KNOWN.get(os);
+  if (!state) {
+    state = { known: true, os };
+    KNOWN.set(os, state);
+  }
+  return state;
+}
+function useVisitorOs() {
+  return useSyncExternalStore2(subscribe2, getSnapshot, getServerSnapshot);
+}
+
 // src/hooks/platform/use-platform-config.ts
-import { useState as useState10, useEffect as useEffect10 } from "react";
+import { useState as useState11, useEffect as useEffect11 } from "react";
 
 // src/utils/platform-config.tsx
 import { Globe } from "lucide-react";
@@ -1011,10 +1220,10 @@ function toPlatformConfigs(payload) {
   return configs;
 }
 function usePlatformConfig() {
-  const [platforms, setPlatforms] = useState10(platformCache || []);
-  const [isLoading, setIsLoading] = useState10(!platformCache);
-  const [error, setError] = useState10(null);
-  useEffect10(() => {
+  const [platforms, setPlatforms] = useState11(platformCache || []);
+  const [isLoading, setIsLoading] = useState11(!platformCache);
+  const [error, setError] = useState11(null);
+  useEffect11(() => {
     const commit = (data) => {
       setPlatforms((prev) => prev === data ? prev : data);
       setIsLoading(false);
@@ -1082,7 +1291,7 @@ function useValidatePlatform(value) {
 import { toast as sonnerToast2 } from "sonner";
 
 // src/components/ui/toaster.tsx
-import { useState as useState11 } from "react";
+import { useState as useState12 } from "react";
 import { Toaster as SonnerToaster, toast as sonnerToast } from "sonner";
 import { Fragment, jsx as jsx2, jsxs } from "react/jsx-runtime";
 var dotColorByVariant = {
@@ -1198,7 +1407,7 @@ function CommandApprovalToast({
   defaultExpanded = false,
   className
 }) {
-  const [expanded, setExpanded] = useState11(defaultExpanded);
+  const [expanded, setExpanded] = useState12(defaultExpanded);
   const handleApprove = () => {
     onApprove?.();
     sonnerToast.dismiss(id);
@@ -1398,15 +1607,15 @@ var useToast = () => ({
 });
 
 // src/hooks/use-contact-submission.ts
-import { useState as useState12, useCallback as useCallback8, useEffect as useEffect11 } from "react";
+import { useState as useState13, useCallback as useCallback9, useEffect as useEffect12 } from "react";
 function useContactSubmission(options = {}) {
   const { userId, successRedirectUrl, successToastMessage, onSuccess } = options;
   const { toast: toast2 } = useToast();
   const router = useRouter();
   const { contactUrl } = useRequiredEndpointsRuntime();
-  const [isSubmitting, setIsSubmitting] = useState12(false);
-  const [isSuccess, setIsSuccess] = useState12(false);
-  const submit = useCallback8(
+  const [isSubmitting, setIsSubmitting] = useState13(false);
+  const [isSuccess, setIsSuccess] = useState13(false);
+  const submit = useCallback9(
     async (formData) => {
       if (isSubmitting) return;
       setIsSubmitting(true);
@@ -1444,7 +1653,7 @@ function useContactSubmission(options = {}) {
     },
     [isSubmitting, toast2, userId, successToastMessage, contactUrl]
   );
-  useEffect11(() => {
+  useEffect12(() => {
     if (!isSuccess || !successRedirectUrl) return void 0;
     console.log("\u{1F680} Contact submission successful, redirecting to:", successRedirectUrl);
     const timer = setTimeout(() => {
@@ -1457,7 +1666,7 @@ function useContactSubmission(options = {}) {
     }, 1500);
     return () => clearTimeout(timer);
   }, [isSuccess, successRedirectUrl, router]);
-  useEffect11(() => {
+  useEffect12(() => {
     if (isSuccess && onSuccess) {
       onSuccess();
     }
@@ -1466,7 +1675,7 @@ function useContactSubmission(options = {}) {
 }
 
 // src/hooks/use-copy-to-clipboard.ts
-import { useCallback as useCallback9, useState as useState13 } from "react";
+import { useCallback as useCallback10, useState as useState14 } from "react";
 function useCopyToClipboard({
   successTitle = "Copied",
   successDescription = "Copied to clipboard",
@@ -1475,8 +1684,8 @@ function useCopyToClipboard({
   resetDelay = 2e3
 } = {}) {
   const { toast: toast2 } = useToast();
-  const [copied, setCopied] = useState13(false);
-  const copy = useCallback9(
+  const [copied, setCopied] = useState14(false);
+  const copy = useCallback10(
     async (text) => {
       try {
         await navigator.clipboard.writeText(text);
@@ -1493,7 +1702,7 @@ function useCopyToClipboard({
 }
 
 // src/hooks/use-batch-images.ts
-import { useEffect as useEffect12, useMemo as useMemo3, useState as useState14, useRef as useRef8 } from "react";
+import { useEffect as useEffect13, useMemo as useMemo4, useState as useState15, useRef as useRef9 } from "react";
 var globalBatchImageConfig = {};
 function configureBatchImageFetch(config) {
   globalBatchImageConfig = { ...globalBatchImageConfig, ...config };
@@ -1566,17 +1775,17 @@ async function batchFetchAuthenticatedImages(imageUrls, config) {
   return results;
 }
 function useBatchImages(imageUrls, config) {
-  const [fetchedImages, setFetchedImages] = useState14({});
-  const uniqueUrls = useMemo3(
+  const [fetchedImages, setFetchedImages] = useState15({});
+  const uniqueUrls = useMemo4(
     () => Array.from(new Set(imageUrls.filter((url) => Boolean(url)))),
     [imageUrls]
   );
-  const requestedUrls = useRef8(/* @__PURE__ */ new Set());
-  const fetchedImagesRef = useRef8(fetchedImages);
-  useEffect12(() => {
+  const requestedUrls = useRef9(/* @__PURE__ */ new Set());
+  const fetchedImagesRef = useRef9(fetchedImages);
+  useEffect13(() => {
     fetchedImagesRef.current = fetchedImages;
   }, [fetchedImages]);
-  useEffect12(
+  useEffect13(
     () => () => {
       Object.values(fetchedImagesRef.current).forEach((blobUrl) => {
         if (blobUrl && blobUrl.startsWith("blob:")) {
@@ -1586,7 +1795,7 @@ function useBatchImages(imageUrls, config) {
     },
     []
   );
-  useEffect12(() => {
+  useEffect13(() => {
     const urlsToFetch = uniqueUrls.filter((url) => !requestedUrls.current.has(url));
     if (urlsToFetch.length === 0) {
       return;
@@ -1604,7 +1813,7 @@ function useBatchImages(imageUrls, config) {
 }
 
 // src/hooks/use-authenticated-image.ts
-import { useEffect as useEffect13, useState as useState15, useRef as useRef9 } from "react";
+import { useEffect as useEffect14, useState as useState16, useRef as useRef10 } from "react";
 var globalImageConfig = {};
 var imageCache = /* @__PURE__ */ new Map();
 var pendingRequests = /* @__PURE__ */ new Map();
@@ -1633,8 +1842,8 @@ function getImageConfig() {
   };
 }
 function useAuthenticatedImage(imageUrl, refreshKey, config) {
-  const [settled, setSettled] = useState15(null);
-  const currentCacheKeyRef = useRef9(null);
+  const [settled, setSettled] = useState16(null);
+  const currentCacheKeyRef = useRef10(null);
   const { tenantHostUrl, enableDevMode, accessTokenKey } = {
     ...getImageConfig(),
     ...config
@@ -1652,7 +1861,7 @@ function useAuthenticatedImage(imageUrl, refreshKey, config) {
     }
   }
   const cacheKey = fullImageUrl === null ? null : refreshKey ? `${fullImageUrl}?v=${refreshKey}` : fullImageUrl;
-  useEffect13(() => {
+  useEffect14(() => {
     if (cacheKey === null) {
       if (currentCacheKeyRef.current) {
         const entry = imageCache.get(currentCacheKeyRef.current);
@@ -1729,7 +1938,7 @@ function useAuthenticatedImage(imageUrl, refreshKey, config) {
     });
     pendingRequests.set(cacheKey, fetchPromise2);
   }, [cacheKey, fullImageUrl, refreshKey, enableDevMode, accessTokenKey]);
-  useEffect13(() => {
+  useEffect14(() => {
     return () => {
       if (currentCacheKeyRef.current) {
         const entry = imageCache.get(currentCacheKeyRef.current);
@@ -1750,7 +1959,7 @@ function useAuthenticatedImage(imageUrl, refreshKey, config) {
 }
 
 // src/hooks/state/use-query-params.ts
-import { useEffect as useEffect14, useState as useState16, useMemo as useMemo4, useCallback as useCallback10, useRef as useRef10 } from "react";
+import { useEffect as useEffect15, useState as useState17, useMemo as useMemo5, useCallback as useCallback11, useRef as useRef11 } from "react";
 
 // src/hooks/state/flatten-schema.ts
 function flattenQueryVariables(queryVariables, introspector2) {
@@ -2201,26 +2410,26 @@ function validateVariables(variables, schema) {
 function useQueryParams(query, options = {}) {
   const router = useRouter();
   const searchParams = useSearchParams();
-  const [isLoading, setIsLoading] = useState16(true);
-  const [isReady, setIsReady] = useState16(false);
-  const [error, setError] = useState16(null);
-  const [schema, setSchema] = useState16({});
-  const defaultValues = useMemo4(() => options.defaultValues || {}, [options.defaultValues]);
+  const [isLoading, setIsLoading] = useState17(true);
+  const [isReady, setIsReady] = useState17(false);
+  const [error, setError] = useState17(null);
+  const [schema, setSchema] = useState17({});
+  const defaultValues = useMemo5(() => options.defaultValues || {}, [options.defaultValues]);
   const skipIntrospection = options.skipIntrospection || false;
   const debug = options.debug || false;
-  const initSourceRef = useRef10({
+  const initSourceRef = useRef11({
     introspectionHeaders: options.introspectionHeaders,
     paramMapping: options.paramMapping,
     defaultValues
   });
-  useEffect14(() => {
+  useEffect15(() => {
     initSourceRef.current = {
       introspectionHeaders: options.introspectionHeaders,
       paramMapping: options.paramMapping,
       defaultValues
     };
   });
-  useEffect14(() => {
+  useEffect15(() => {
     let cancelled = false;
     async function initialize() {
       try {
@@ -2267,7 +2476,7 @@ function useQueryParams(query, options = {}) {
       cancelled = true;
     };
   }, [query, options.introspectionEndpoint, skipIntrospection, debug]);
-  const variables = useMemo4(() => {
+  const variables = useMemo5(() => {
     if (!isReady) {
       return defaultValues;
     }
@@ -2283,7 +2492,7 @@ function useQueryParams(query, options = {}) {
       return defaultValues;
     }
   }, [searchParams, schema, isReady, defaultValues, debug]);
-  const params = useMemo4(() => {
+  const params = useMemo5(() => {
     const result = {};
     searchParams.forEach((value, key) => {
       const existing = result[key];
@@ -2297,7 +2506,7 @@ function useQueryParams(query, options = {}) {
     });
     return result;
   }, [searchParams]);
-  const updateUrl = useCallback10(
+  const updateUrl = useCallback11(
     (newParams) => {
       const url = newParams.toString() ? `?${newParams.toString()}` : window.location.pathname;
       if (debug) {
@@ -2307,7 +2516,7 @@ function useQueryParams(query, options = {}) {
     },
     [router, debug]
   );
-  const setParam = useCallback10(
+  const setParam = useCallback11(
     (key, value) => {
       if (!isReady) {
         console.warn("[useQueryParams] Schema not ready, cannot set param");
@@ -2323,7 +2532,7 @@ function useQueryParams(query, options = {}) {
     },
     [variables, schema, isReady, updateUrl]
   );
-  const setParams = useCallback10(
+  const setParams = useCallback11(
     (updates) => {
       if (!isReady) {
         console.warn("[useQueryParams] Schema not ready, cannot set params");
@@ -2339,7 +2548,7 @@ function useQueryParams(query, options = {}) {
     },
     [variables, schema, isReady, updateUrl]
   );
-  const clearParamsHandler = useCallback10(
+  const clearParamsHandler = useCallback11(
     (keys) => {
       if (!isReady) {
         console.warn("[useQueryParams] Schema not ready, cannot clear params");
@@ -2355,7 +2564,7 @@ function useQueryParams(query, options = {}) {
     },
     [variables, schema, isReady, updateUrl]
   );
-  const resetParams = useCallback10(() => {
+  const resetParams = useCallback11(() => {
     if (debug) {
       console.log("[useQueryParams] Resetting params");
     }
@@ -2390,9 +2599,9 @@ function applyParamMapping(schema, mapping) {
 }
 
 // src/hooks/state/use-api-params.ts
-import { useCallback as useCallback11, useEffect as useEffect15, useMemo as useMemo5, useRef as useRef11, useState as useState17 } from "react";
+import { useCallback as useCallback12, useEffect as useEffect16, useMemo as useMemo6, useRef as useRef12, useState as useState18 } from "react";
 function useContentStable(value, key) {
-  const [cached, setCached] = useState17({ value, key });
+  const [cached, setCached] = useState18({ value, key });
   if (cached.key !== key) setCached({ value, key });
   return cached.key === key ? cached.value : value;
 }
@@ -2419,14 +2628,14 @@ function useApiParams(schema, options = {}) {
   const searchParamsLive = useSearchParams();
   const debug = options.debug || false;
   const searchString = searchParamsLive.toString();
-  const pendingRef = useRef11([]);
-  const [pendingTail, setPendingTail] = useState17(void 0);
-  const syncPendingTail = useCallback11(() => {
+  const pendingRef = useRef12([]);
+  const [pendingTail, setPendingTail] = useState18(void 0);
+  const syncPendingTail = useCallback12(() => {
     setPendingTail(pendingRef.current[pendingRef.current.length - 1]);
   }, []);
-  const schemaKey = useMemo5(() => JSON.stringify(schema), [schema]);
+  const schemaKey = useMemo6(() => JSON.stringify(schema), [schema]);
   const stableSchema = useContentStable(schema, schemaKey);
-  const flattenedSchema = useMemo5(() => {
+  const flattenedSchema = useMemo6(() => {
     const flattened = {};
     for (const [key, config] of Object.entries(stableSchema)) {
       flattened[key] = {
@@ -2440,7 +2649,7 @@ function useApiParams(schema, options = {}) {
     }
     return flattened;
   }, [stableSchema]);
-  const rawParams = useMemo5(() => {
+  const rawParams = useMemo6(() => {
     const result = parseSchemaParams(stableSchema, new URLSearchParams(searchString), {
       absent: options.absent === "null" ? "null" : "undefined"
     });
@@ -2449,17 +2658,17 @@ function useApiParams(schema, options = {}) {
     }
     return result;
   }, [searchString, debug, stableSchema, options.absent]);
-  const [paramsCache, setParamsCache] = useState17(() => ({ src: rawParams, value: rawParams }));
+  const [paramsCache, setParamsCache] = useState18(() => ({ src: rawParams, value: rawParams }));
   let stableParams = paramsCache.value;
   if (paramsCache.src !== rawParams) {
     stableParams = reuseArrayRefs(paramsCache.value, rawParams);
     setParamsCache({ src: rawParams, value: stableParams });
   }
   const params = stableParams;
-  const addParamToSearchParams = useCallback11((searchParams, key, value) => {
+  const addParamToSearchParams = useCallback12((searchParams, key, value) => {
     for (const [k, v] of createSearchParams({ [key]: value })) searchParams.append(k, v);
   }, []);
-  const urlSearchParams = useMemo5(() => {
+  const urlSearchParams = useMemo6(() => {
     const newParams = new URLSearchParams();
     for (const key of Object.keys(stableSchema)) {
       const value = params[key];
@@ -2471,7 +2680,7 @@ function useApiParams(schema, options = {}) {
     }
     return newParams;
   }, [params, flattenedSchema, addParamToSearchParams, stableSchema]);
-  const updateUrl = useCallback11(
+  const updateUrl = useCallback12(
     (newParams, keysToRemove = []) => {
       const base = pendingRef.current[pendingRef.current.length - 1] ?? searchString;
       const finalParams = new URLSearchParams(base);
@@ -2506,14 +2715,14 @@ function useApiParams(schema, options = {}) {
     },
     [router, debug, searchString, stableSchema, syncPendingTail]
   );
-  useEffect15(() => {
+  useEffect16(() => {
     const queue = pendingRef.current;
     if (queue.length === 0) return;
     const hit = queue.indexOf(searchString);
     pendingRef.current = hit === -1 ? [] : queue.slice(hit + 1);
     syncPendingTail();
   }, [searchString, syncPendingTail]);
-  const setParam = useCallback11(
+  const setParam = useCallback12(
     (key, value) => {
       const config = stableSchema[key];
       if (!config) {
@@ -2530,7 +2739,7 @@ function useApiParams(schema, options = {}) {
     },
     [updateUrl, addParamToSearchParams, stableSchema]
   );
-  const setParams = useCallback11(
+  const setParams = useCallback12(
     (updates) => {
       const newParams = new URLSearchParams();
       const keysToRemove = [];
@@ -2550,20 +2759,20 @@ function useApiParams(schema, options = {}) {
     },
     [updateUrl, addParamToSearchParams, stableSchema, flattenedSchema]
   );
-  const clearParams2 = useCallback11(
+  const clearParams2 = useCallback12(
     (keys) => {
       const newParams = new URLSearchParams();
       updateUrl(newParams, keys);
     },
     [updateUrl]
   );
-  const resetParams = useCallback11(() => {
+  const resetParams = useCallback12(() => {
     if (debug) {
       console.log("[useApiParams] Resetting params");
     }
     router.replace(window.location.pathname, { scroll: false });
   }, [router, debug]);
-  const pendingParams = useMemo5(() => {
+  const pendingParams = useMemo6(() => {
     if (pendingTail === void 0 || pendingTail === searchString) return params;
     return parseSchemaParams(stableSchema, new URLSearchParams(pendingTail), {
       absent: options.absent === "null" ? "null" : "undefined"
@@ -2581,7 +2790,7 @@ function useApiParams(schema, options = {}) {
 }
 
 // src/hooks/state/use-cursor-pagination-state.ts
-import { useCallback as useCallback12, useEffect as useEffect16, useRef as useRef12, useState as useState18 } from "react";
+import { useCallback as useCallback13, useEffect as useEffect17, useRef as useRef13, useState as useState19 } from "react";
 var urlSchema = {
   search: { type: "string", default: "" },
   cursor: { type: "string", default: "" }
@@ -2589,21 +2798,21 @@ var urlSchema = {
 function useCursorPaginationState(options) {
   const { onInitialLoad, onSearchChange } = options;
   const { params, setParam, setParams } = useApiParams(urlSchema);
-  const [searchInput, setSearchInput] = useState18(params.search || "");
-  const [hasLoadedBeyondFirst, setHasLoadedBeyondFirst] = useState18(false);
-  const [initialLoadCount, setInitialLoadCount] = useState18(0);
-  const lastSearchRef = useRef12(null);
-  const isSyncingFromUrl = useRef12(false);
-  const isInitialLoadInProgress = useRef12(true);
-  const searchInputRef = useRef12(searchInput);
-  const onInitialLoadRef = useRef12(onInitialLoad);
-  const paramsRef = useRef12(params);
-  useEffect16(() => {
+  const [searchInput, setSearchInput] = useState19(params.search || "");
+  const [hasLoadedBeyondFirst, setHasLoadedBeyondFirst] = useState19(false);
+  const [initialLoadCount, setInitialLoadCount] = useState19(0);
+  const lastSearchRef = useRef13(null);
+  const isSyncingFromUrl = useRef13(false);
+  const isInitialLoadInProgress = useRef13(true);
+  const searchInputRef = useRef13(searchInput);
+  const onInitialLoadRef = useRef13(onInitialLoad);
+  const paramsRef = useRef13(params);
+  useEffect17(() => {
     searchInputRef.current = searchInput;
     onInitialLoadRef.current = onInitialLoad;
     paramsRef.current = params;
   });
-  useEffect16(() => {
+  useEffect17(() => {
     if (isInitialLoadInProgress.current) return;
     const urlSearch = params.search || "";
     if (urlSearch !== searchInputRef.current) {
@@ -2614,7 +2823,7 @@ function useCursorPaginationState(options) {
       }, 0);
     }
   }, [params.search, initialLoadCount]);
-  useEffect16(() => {
+  useEffect17(() => {
     if (isInitialLoadInProgress.current) return;
     if (isSyncingFromUrl.current) return;
     if (searchInput !== params.search) {
@@ -2625,7 +2834,7 @@ function useCursorPaginationState(options) {
       });
     }
   }, [searchInput, params.search, setParams, initialLoadCount]);
-  useEffect16(() => {
+  useEffect17(() => {
     if (initialLoadCount === 0) {
       const cursor = paramsRef.current.cursor || null;
       const search = paramsRef.current.search || "";
@@ -2641,7 +2850,7 @@ function useCursorPaginationState(options) {
       });
     }
   }, [initialLoadCount]);
-  useEffect16(() => {
+  useEffect17(() => {
     if (isInitialLoadInProgress.current) return;
     if (initialLoadCount === 0) return;
     const currentSearch = params.search || "";
@@ -2653,7 +2862,7 @@ function useCursorPaginationState(options) {
       });
     }
   }, [params.search, onSearchChange, initialLoadCount]);
-  const handleNextPage = useCallback12(
+  const handleNextPage = useCallback13(
     async (endCursor, fetchFn) => {
       setParam("cursor", endCursor);
       await fetchFn();
@@ -2661,7 +2870,7 @@ function useCursorPaginationState(options) {
     },
     [setParam]
   );
-  const handleResetToFirstPage = useCallback12(
+  const handleResetToFirstPage = useCallback13(
     async (fetchFn) => {
       setParam("cursor", "");
       await fetchFn();
@@ -2683,22 +2892,22 @@ function useCursorPaginationState(options) {
 }
 
 // src/hooks/nats/use-nats-client.ts
-import { useEffect as useEffect17, useMemo as useMemo6, useState as useState19 } from "react";
+import { useEffect as useEffect18, useMemo as useMemo7, useState as useState20 } from "react";
 function useNatsClient(clientOptions, options = {}) {
   const { autoConnect = true } = options;
-  const client = useMemo6(() => {
+  const client = useMemo7(() => {
     if (!clientOptions) return null;
     return createNatsClient(clientOptions);
   }, [clientOptions]);
-  const [status, setStatus] = useState19("disconnected");
-  const [lastError, setLastError] = useState19(null);
-  const [statusClient, setStatusClient] = useState19(client);
+  const [status, setStatus] = useState20("disconnected");
+  const [lastError, setLastError] = useState20(null);
+  const [statusClient, setStatusClient] = useState20(client);
   if (statusClient !== client) {
     setStatusClient(client);
     setStatus("disconnected");
     setLastError(null);
   }
-  useEffect17(() => {
+  useEffect18(() => {
     if (!client) return void 0;
     const off = client.onStatus((event) => {
       setStatus(event.status);
@@ -2725,7 +2934,7 @@ function useNatsClient(clientOptions, options = {}) {
 }
 
 // src/hooks/use-scenario-player.ts
-import { useCallback as useCallback13, useEffect as useEffect18, useRef as useRef13, useState as useState20 } from "react";
+import { useCallback as useCallback14, useEffect as useEffect19, useRef as useRef14, useState as useState21 } from "react";
 var START_MS = 300;
 function useScenarioPlayer({
   scenarioCount,
@@ -2738,14 +2947,14 @@ function useScenarioPlayer({
 }) {
   const auto = useAutoplay(enabled);
   const { reducedMotion, paused, setPaused } = auto;
-  const [scenario, setScenario] = useState20(initialScenario);
-  const [rawStep, setRawStep] = useState20(startAtEnd ? Number.MAX_SAFE_INTEGER : 0);
+  const [scenario, setScenario] = useState21(initialScenario);
+  const [rawStep, setRawStep] = useState21(startAtEnd ? Number.MAX_SAFE_INTEGER : 0);
   const lastStep = typeof lastStepOption === "function" ? lastStepOption(scenario) : lastStepOption;
   const step = reducedMotion ? lastStep : Math.min(rawStep, lastStep);
   const playing = auto.playing && scenarioCount > 0;
-  const starting = useRef13(false);
-  const wasPlaying = useRef13(false);
-  useEffect18(() => {
+  const starting = useRef14(false);
+  const wasPlaying = useRef14(false);
+  useEffect19(() => {
     if (playing && !wasPlaying.current) starting.current = true;
     wasPlaying.current = playing;
     if (!playing) return void 0;
@@ -2765,14 +2974,14 @@ function useScenarioPlayer({
     );
     return () => clearTimeout(timer);
   }, [playing, rawStep, lastStep, stepMs, holdMs, scenario, scenarioCount]);
-  const setStep = useCallback13(
+  const setStep = useCallback14(
     (next) => {
       setRawStep(Math.max(0, Math.min(lastStep, next)));
       setPaused(false);
     },
     [lastStep, setPaused]
   );
-  const go = useCallback13(
+  const go = useCallback14(
     (next) => {
       setScenario(next);
       setRawStep(0);
@@ -2886,7 +3095,7 @@ function useAccessCodeIntegration() {
 }
 
 // src/hooks/use-claude-mirror-src.ts
-import { useEffect as useEffect19, useState as useState21 } from "react";
+import { useEffect as useEffect20, useState as useState22 } from "react";
 
 // src/utils/embed-url-converters.ts
 function toGoogleSheetsEmbedUrl(url) {
@@ -2976,9 +3185,9 @@ async function revalidateMirror(mirrorPath) {
 function useClaudeMirrorSrc(url) {
   const endpoints = useEndpointsRuntime();
   const mirrorPath = toClaudeMirrorPath(url, endpoints?.storageViewBaseUrl);
-  const [resolved, setResolved] = useState21(null);
+  const [resolved, setResolved] = useState22(null);
   const state = resolved && resolved.key === mirrorPath ? resolved.value : { src: null, status: mirrorPath ? "probing" : "absent" };
-  useEffect19(() => {
+  useEffect20(() => {
     if (!mirrorPath) return void 0;
     let cancelled = false;
     const settle = (value) => {
@@ -3004,12 +3213,33 @@ function useClaudeMirrorSrc(url) {
   return state;
 }
 
+// src/hooks/use-location-hash.ts
+import { useSyncExternalStore as useSyncExternalStore3 } from "react";
+var HASH_EVENTS = ["hashchange", "popstate"];
+function subscribe3(onChange) {
+  for (const event of HASH_EVENTS) window.addEventListener(event, onChange);
+  return () => {
+    for (const event of HASH_EVENTS) window.removeEventListener(event, onChange);
+  };
+}
+function readHash() {
+  const raw = normalizeHashFragment(window.location.hash).replace(/^#/, "");
+  try {
+    return decodeURIComponent(raw);
+  } catch {
+    return raw;
+  }
+}
+function useLocationHash() {
+  return useSyncExternalStore3(subscribe3, readHash, () => "");
+}
+
 // src/hooks/use-scroll-to-hash.ts
-import { useEffect as useEffect20 } from "react";
+import { useEffect as useEffect21 } from "react";
 var MAX_POLL_FRAMES = 60;
 function useScrollToHash(readyDep = true, options) {
   const headerOffset = options?.headerOffset ?? 0;
-  useEffect20(() => {
+  useEffect21(() => {
     if (typeof window === "undefined") return void 0;
     if (readyDep === null || readyDep === false) return void 0;
     let rafId = null;
@@ -3049,7 +3279,7 @@ function useScrollToHash(readyDep = true, options) {
 }
 
 // src/hooks/use-humanity-signals.ts
-import { useCallback as useCallback14, useRef as useRef14, useState as useState22 } from "react";
+import { useCallback as useCallback15, useRef as useRef15, useState as useState23 } from "react";
 
 // src/utils/humanity-signals.ts
 var HONEYPOT_FIELD = "form_extra_note";
@@ -3111,17 +3341,17 @@ var splitCsvEnv = (s) => s?.split(",").map((t) => t.trim()).filter(Boolean) ?? [
 
 // src/hooks/use-humanity-signals.ts
 function useHumanitySignals() {
-  const ref = useRef14(null);
-  const [mountedAt] = useState22(() => typeof performance !== "undefined" ? performance.now() : 0);
-  const startedAtRef = useRef14(mountedAt);
-  const getSignals = useCallback14(
+  const ref = useRef15(null);
+  const [mountedAt] = useState23(() => typeof performance !== "undefined" ? performance.now() : 0);
+  const startedAtRef = useRef15(mountedAt);
+  const getSignals = useCallback15(
     () => ({
       [HONEYPOT_FIELD]: ref.current?.value ?? "",
       [ELAPSED_MS_FIELD]: typeof performance !== "undefined" ? Math.round(performance.now() - startedAtRef.current) : 0
     }),
     []
   );
-  const resetSignals = useCallback14(() => {
+  const resetSignals = useCallback15(() => {
     if (ref.current) ref.current.value = "";
     if (typeof performance !== "undefined") startedAtRef.current = performance.now();
   }, []);
@@ -3129,7 +3359,7 @@ function useHumanitySignals() {
 }
 
 // src/hooks/use-form-rescue.ts
-import { useCallback as useCallback15, useEffect as useEffect21, useMemo as useMemo7, useRef as useRef15 } from "react";
+import { useCallback as useCallback16, useEffect as useEffect22, useMemo as useMemo8, useRef as useRef16 } from "react";
 
 // src/utils/form-rescue.ts
 var FORM_ID_PATTERN = /^[a-z][a-z0-9_]{1,47}$/;
@@ -3343,27 +3573,27 @@ function readUtm() {
 function useFormRescue({ form, fieldNames, onRestore, getSignals }) {
   const draftsUrl = useEndpointsRuntime()?.formDraftsUrl;
   const formId = form?.id ?? null;
-  const attemptIdRef = useRef15(null);
-  const resumeTokenRef = useRef15(null);
-  const latestRef = useRef15(null);
-  const dirtyRef = useRef15(false);
-  const startedRef = useRef15(false);
-  const leadCapturedRef = useRef15(false);
-  const completedRef = useRef15(false);
-  const timerRef = useRef15(null);
-  const fieldNamesRef = useRef15(fieldNames);
-  const onRestoreRef = useRef15(onRestore);
-  const getSignalsRef = useRef15(getSignals);
-  useEffect21(() => {
+  const attemptIdRef = useRef16(null);
+  const resumeTokenRef = useRef16(null);
+  const latestRef = useRef16(null);
+  const dirtyRef = useRef16(false);
+  const startedRef = useRef16(false);
+  const leadCapturedRef = useRef16(false);
+  const completedRef = useRef16(false);
+  const timerRef = useRef16(null);
+  const fieldNamesRef = useRef16(fieldNames);
+  const onRestoreRef = useRef16(onRestore);
+  const getSignalsRef = useRef16(getSignals);
+  useEffect22(() => {
     fieldNamesRef.current = fieldNames;
     onRestoreRef.current = onRestore;
     getSignalsRef.current = getSignals;
   });
-  const attemptId = useCallback15(() => {
+  const attemptId = useCallback16(() => {
     if (!attemptIdRef.current) attemptIdRef.current = newAttemptId();
     return attemptIdRef.current;
   }, []);
-  const send = useCallback15(
+  const send = useCallback16(
     (keepalive) => {
       if (!formId || !draftsUrl || !dirtyRef.current || completedRef.current || !latestRef.current) return;
       dirtyRef.current = false;
@@ -3394,7 +3624,7 @@ function useFormRescue({ form, fieldNames, onRestore, getSignals }) {
     },
     [attemptId, draftsUrl, formId]
   );
-  useEffect21(() => {
+  useEffect22(() => {
     if (!formId || typeof window === "undefined") return void 0;
     let cancelled = false;
     const token = new URLSearchParams(window.location.search).get(FORM_RESCUE_RESUME_PARAM);
@@ -3424,7 +3654,7 @@ function useFormRescue({ form, fieldNames, onRestore, getSignals }) {
       cancelled = true;
     };
   }, [attemptId, draftsUrl, formId]);
-  useEffect21(() => {
+  useEffect22(() => {
     if (!formId || typeof document === "undefined") return void 0;
     const onHide = () => {
       if (completedRef.current || !startedRef.current) return;
@@ -3451,7 +3681,7 @@ function useFormRescue({ form, fieldNames, onRestore, getSignals }) {
       if (timerRef.current) clearTimeout(timerRef.current);
     };
   }, [attemptId, formId, send]);
-  const track = useCallback15(
+  const track = useCallback16(
     (values, lastField) => {
       if (!formId || completedRef.current) return;
       const names = fieldNamesRef.current;
@@ -3484,14 +3714,14 @@ function useFormRescue({ form, fieldNames, onRestore, getSignals }) {
     },
     [attemptId, formId, send]
   );
-  const submitFields = useCallback15(() => {
+  const submitFields = useCallback16(() => {
     if (!formId) return {};
     return {
       [FORM_RESCUE_ATTEMPT_FIELD]: attemptId(),
       ...resumeTokenRef.current ? { [FORM_RESCUE_RESUME_FIELD]: resumeTokenRef.current } : {}
     };
   }, [attemptId, formId]);
-  const complete = useCallback15(() => {
+  const complete = useCallback16(() => {
     if (!formId) return;
     if (timerRef.current) {
       clearTimeout(timerRef.current);
@@ -3505,11 +3735,11 @@ function useFormRescue({ form, fieldNames, onRestore, getSignals }) {
     startedRef.current = false;
     leadCapturedRef.current = false;
   }, [attemptId, form, formId]);
-  return useMemo7(() => ({ track, submitFields, complete }), [track, submitFields, complete]);
+  return useMemo8(() => ({ track, submitFields, complete }), [track, submitFields, complete]);
 }
 
 // src/hooks/use-rescued-form.ts
-import { useEffect as useEffect22 } from "react";
+import { useEffect as useEffect23 } from "react";
 function flattenOneLevel(values) {
   const flat = {};
   for (const [key, value] of Object.entries(values)) {
@@ -3533,7 +3763,7 @@ function useRescuedForm(form, { rescue, fields, getSignals, fieldPath }) {
       }
     }
   });
-  useEffect22(() => {
+  useEffect23(() => {
     const subscription = watch((values, { name }) => {
       handle.track(flattenOneLevel(values), name ? name.split(".").pop() ?? null : null);
     });
@@ -3558,6 +3788,16 @@ export {
   useTablePagination,
   useThrottle,
   useWindowSize,
+  resolveActiveSection,
+  useActiveSection,
+  useNavMenus,
+  DESKTOP_OSES,
+  detectVisitorOs,
+  desktopOsOf,
+  detectDesktopOs,
+  usesCommandKey,
+  shortcutLabel,
+  useVisitorOs,
   usePreventScroll,
   platformIcons,
   transformPlatformConfigsToOptions,
@@ -3618,6 +3858,7 @@ export {
   toClaudeMirrorPath,
   toClaudeEmbedUrl,
   useClaudeMirrorSrc,
+  useLocationHash,
   useScrollToHash,
   HONEYPOT_FIELD,
   ELAPSED_MS_FIELD,