basalt-ui 1.41.0 → 2.0.0

package/dist/provider/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/provider/index.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/provider/index.tsx"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAA;AASzD,OAAO,EAAE,SAAS,EAAqE,MAAM,OAAO,CAAA;AACpG,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAKjD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AAStD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAA;AAExD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AAE7C,OAAO,KAAK,EAAE,YAAY,EAAuB,MAAM,iBAAiB,CAAA;AAIxE,MAAM,MAAM,mBAAmB,GAAG;IAChC,qFAAqF;IACrF,MAAM,EAAE,YAAY,CAAA;IACpB,qFAAqF;IACrF,KAAK,CAAC,EAAE,oBAAoB,CAAC,OAAO,CAAC,CAAA;IACrC;;;;OAIG;IACH,SAAS,CAAC,EAAE,SAAS,CAAA;IACrB,yGAAyG;IACzG,QAAQ,CAAC,EAAE,SAAS,GAAG,CAAC,CAAC,KAAK,EAAE,OAAO,KAAK,SAAS,CAAC,CAAA;IACtD;;;;OAIG;IACH,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB;;;OAGG;IACH,cAAc,CAAC,EAAE,gBAAgB,CAAA;IACjC,8CAA8C;IAC9C,kBAAkB,CAAC,EAAE,oBAAoB,CAAC,oBAAoB,CAAC,CAAA;IAC/D;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;IACd;;;OAGG;IACH,aAAa,CAAC,EAAE,SAAS,CAAA;CAC1B,GAAG,IAAI,CAAC,oBAAoB,EAAE,UAAU,GAAG,OAAO,GAAG,oBAAoB,GAAG,sBAAsB,CAAC,CAAA;AAIpG,KAAK,iBAAiB,GAAG;IACvB,QAAQ,EAAE,SAAS,CAAA;IACnB,IAAI,EAAE,SAAS,CAAA;IACf,QAAQ,EAAE,mBAAmB,CAAC,UAAU,CAAC,CAAA;CAC1C,CAAA;AAED,KAAK,aAAa,GAAG;IAAE,QAAQ,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAAA;AAwB1D,mGAAmG;AACnG,qBAAa,YAAa,SAAQ,SAAS,CAAC,iBAAiB,EAAE,aAAa,CAAC;gBAC/D,KAAK,EAAE,iBAAiB;IAKpC,MAAM,CAAC,wBAAwB,CAAC,KAAK,EAAE,OAAO,GAAG,aAAa;IAIrD,iBAAiB,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,GAAG,IAAI;IAczD,MAAM,IAAI,SAAS;CAO7B;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,GACjB,MAAM,CAER;AAYD;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAmBvC;AAqMD,wBAAgB,cAAc,CAAC,EAC7B,MAAM,EACN,KAAK,EACL,SAAS,EACT,QAAQ,EACR,aAAoB,EACpB,cAAc,EACd,kBAA2B,EAC3B,KAAK,EACL,aAAyB,EACzB,GAAG,IAAI,EACR,EAAE,mBAAmB,+BA6ErB"}

package/dist/provider/index.js

@@ -1,29 +1,26 @@
-import { jsx, jsxs } from "react/jsx-runtime";
-import {
-  MantineProvider,
-  useComputedColorScheme,
-  useMantineColorScheme,
-  useMantineTheme
-} from "@mantine/core";
-import { Component, useEffect, useMemo } from "react";
-import { VxThemeProvider } from "../charts/theme.js";
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+import { MantineProvider, useMantineColorScheme, useMantineTheme } from "@mantine/core";
+import { ModalsProvider } from "@mantine/modals";
+import { Notifications } from "@mantine/notifications";
+import { Spotlight } from "@mantine/spotlight";
+import { QueryClientProvider } from "@tanstack/react-query";
+import { RouterProvider } from "@tanstack/react-router";
+import { Component, Suspense, lazy, useCallback, useEffect, useMemo, useRef, useState } from "react";
 import fallbackClasses from "./error-fallback.module.css";
-import { ConnectivityProvider } from "./connectivity-provider.js";
 import { cssVariablesResolver } from "../theme/index.js";
 import { useLabTheme } from "./lab-theme.js";
-import { buildDensityCss, buildFontsCss, buildPaletteCss, buildRadiusCss } from "../tokens/index.js";
+import { buildDensityCss, buildFontsCss, buildPaletteCss, buildRadiusCss } from "../tokens/core.js";
 import { isDefaultDeriveConfig } from "../tokens/derive.js";
 import { buildPaletteData } from "../tokens/palette.js";
 import { useMediaQuery } from "../common/use-media-query.js";
+import { registerModalsProvider } from "../commands/define-overlays.js";
 import { registerColorSchemeSetter } from "../commands/shell-bridge.js";
 import { useIsomorphicLayoutEffect } from "../common/isomorphic-layout-effect.js";
 import { PageTitle } from "../shell/page-title.js";
 import { SizeClassHintContext } from "../shell/use-size-class.js";
-function defaultOnError(error, ctx) {
-  if (process.env.NODE_ENV !== "production") {
-    console.error("[BasaltProvider] unhandled error", ctx.kind, error);
-  }
-}
+import { TelemetryContext, bindRouterTelemetry, createEmitter, errorName, now } from "../telemetry.js";
+import { useRegistryHotkeys } from "./hotkeys.js";
+import { buildSpotlightActions } from "./spotlight-actions.js";
 function DefaultErrorFallback() {
   return /* @__PURE__ */ jsxs("div", { className: fallbackClasses.root, children: [
     /* @__PURE__ */ jsx(
@@ -44,7 +41,7 @@ function DefaultErrorFallback() {
     )
   ] });
 }
-class BasaltErrorBoundary extends Component {
+class RootBoundary extends Component {
   constructor(props) {
     super(props);
     this.state = { hasError: false, error: void 0 };
@@ -52,22 +49,29 @@ class BasaltErrorBoundary extends Component {
   static getDerivedStateFromError(error) {
     return { hasError: true, error };
   }
-  componentDidCatch(error, info) {
-    const onError = this.props.onError ?? defaultOnError;
-    onError(error, { kind: "render", info });
+  componentDidCatch(error, _info) {
+    if (process.env.NODE_ENV !== "production") console.error("[basalt] render error", error);
+    this.props.emit({
+      type: "render.error",
+      failed: true,
+      start: now(),
+      attributes: {
+        "exception.type": errorName(error),
+        "basalt.error.kind": "render",
+        "basalt.error.boundary": "root"
+      }
+    });
   }
   render() {
-    if (this.state.hasError) {
-      const { fallback } = this.props;
-      if (fallback === void 0) return /* @__PURE__ */ jsx(DefaultErrorFallback, {});
-      if (fallback === null) return null;
-      return typeof fallback === "function" ? fallback(this.state.error) : fallback;
-    }
-    return this.props.children;
+    if (!this.state.hasError) return this.props.children;
+    const { fallback } = this.props;
+    if (fallback === void 0) return /* @__PURE__ */ jsx(DefaultErrorFallback, {});
+    if (fallback === null) return null;
+    return typeof fallback === "function" ? fallback(this.state.error) : fallback;
   }
 }
-function composeInjectedCss(base, fontsCss, radiusCss, densityCss, inputsCss = "") {
-  return [base, fontsCss, radiusCss, densityCss, inputsCss].filter(Boolean).join("\n");
+function composeInjectedCss(base, fontsCss, radiusCss, densityCss) {
+  return [base, fontsCss, radiusCss, densityCss].filter(Boolean).join("\n");
 }
 function createMountCounter() {
   let count = 0;
@@ -92,10 +96,8 @@ function BasaltBridge({
   children,
   injectPalette,
   paletteOptions,
-  nonce,
-  onError
+  nonce
 }) {
-  const resolved = useComputedColorScheme("dark");
   const { setColorScheme: setMantineColorScheme } = useMantineColorScheme();
   useEffect(() => {
     registerColorSchemeSetter(setMantineColorScheme);
@@ -106,7 +108,6 @@ function BasaltBridge({
   const fontsConfig = theme.other?.basaltFonts;
   const radiusConfig = theme.other?.basaltRadius;
   const densityConfig = theme.other?.basaltDensity;
-  const desktopInputs = theme.other?.["basaltInputs"] === "desktop";
   const paletteCss = useMemo(() => {
     if (!injectPalette) return "";
     const base = deriveConfig === void 0 || isDefaultDeriveConfig(deriveConfig) ? buildPaletteCss(paletteOptions) : (
@@ -114,36 +115,14 @@ function BasaltBridge({
       // per-render re-derivation once a given config has been built once.
       buildPaletteCss(paletteOptions, buildPaletteData(deriveConfig))
     );
-    const fontsCss = buildFontsCss(fontsConfig);
-    const radiusCss = buildRadiusCss(radiusConfig);
-    const densityCss = buildDensityCss(densityConfig);
-    const inputsCss = desktopInputs ? ":root {\n--basalt-input-fz-floor: 0px;\n}" : "";
-    return composeInjectedCss(base, fontsCss, radiusCss, densityCss, inputsCss);
-  }, [
-    injectPalette,
-    deriveConfig,
-    fontsConfig,
-    radiusConfig,
-    densityConfig,
-    desktopInputs,
-    paletteOptions
-  ]);
-  useEffect(() => {
-    if (typeof window === "undefined") return;
-    const handleError = (e) => {
-      onError(e.error ?? e, { kind: "window", event: e });
-    };
-    const handleUnhandledRejection = (e) => {
-      onError(e.reason, { kind: "unhandledrejection", reason: e.reason });
-    };
-    window.addEventListener("error", handleError);
-    window.addEventListener("unhandledrejection", handleUnhandledRejection);
-    return () => {
-      window.removeEventListener("error", handleError);
-      window.removeEventListener("unhandledrejection", handleUnhandledRejection);
-    };
-  }, [onError]);
-  return /* @__PURE__ */ jsxs(VxThemeProvider, { colorScheme: resolved, children: [
+    return composeInjectedCss(
+      base,
+      buildFontsCss(fontsConfig),
+      buildRadiusCss(radiusConfig),
+      buildDensityCss(densityConfig)
+    );
+  }, [injectPalette, deriveConfig, fontsConfig, radiusConfig, densityConfig, paletteOptions]);
+  return /* @__PURE__ */ jsxs(Fragment, { children: [
     injectPalette ? /* @__PURE__ */ jsx("style", { nonce, children: paletteCss }) : null,
     children
   ] });
@@ -153,34 +132,142 @@ function useDuplicateProviderGuard() {
   useEffect(() => {
     if (providerMounts.mount() > 1 && process.env.NODE_ENV !== "production") {
       console.warn(
-        "[basalt] BasaltProvider: more than one instance is mounted at once \u2014 nested/duplicate BasaltProviders double-mount MantineProvider, the palette <style> and ConnectivityProvider. Mount exactly one, at the app root."
+        "[basalt] BasaltProvider: more than one instance is mounted at once \u2014 nested/duplicate BasaltProviders double-mount MantineProvider, the palette <style>, the router and the overlays. Mount exactly one, at the app root."
       );
     }
     return () => void providerMounts.unmount();
   }, []);
 }
+function useWindowErrors(emit) {
+  useEffect(() => {
+    const report = (source, error) => {
+      if (process.env.NODE_ENV !== "production") console.error(`[basalt] ${source}`, error);
+      emit({
+        type: "window.error",
+        failed: true,
+        start: now(),
+        attributes: {
+          "exception.type": errorName(error),
+          "basalt.error.kind": source === "error" ? "window" : "unhandledrejection",
+          "basalt.error.source": source
+        }
+      });
+    };
+    const onError = (e) => report("error", e.error ?? e);
+    const onRejection = (e) => report("unhandledrejection", e.reason);
+    window.addEventListener("error", onError);
+    window.addEventListener("unhandledrejection", onRejection);
+    return () => {
+      window.removeEventListener("error", onError);
+      window.removeEventListener("unhandledrejection", onRejection);
+    };
+  }, [emit]);
+}
+function useDataTelemetry(router, client, emit) {
+  useEffect(() => {
+    const unbind = bindRouterTelemetry(router, emit);
+    let pending;
+    const offBefore = router.subscribe("onBeforeNavigate", (ev) => {
+      pending = { href: ev.toLocation.href, start: now(), from: ev.fromLocation?.pathname ?? "" };
+    });
+    const offResolved = router.subscribe("onResolved", (ev) => {
+      if (pending?.href !== ev.toLocation.href) return;
+      const { start, from } = pending;
+      pending = void 0;
+      emit({
+        type: "route.navigate",
+        failed: false,
+        start,
+        duration: now() - start,
+        attributes: {
+          "basalt.route.id": router.state.matches.at(-1)?.routeId ?? "unknown",
+          "basalt.route.from": from,
+          "url.path": ev.toLocation.pathname
+        }
+      });
+    });
+    const offQuery = client.getQueryCache().subscribe((ev) => {
+      if (ev.type !== "updated" || ev.action.type !== "error") return;
+      emit({
+        type: "query.error",
+        failed: true,
+        start: now(),
+        attributes: {
+          "basalt.query.hash": ev.query.queryHash,
+          "basalt.query.failure_count": ev.query.state.fetchFailureCount,
+          "exception.type": errorName(ev.action.error),
+          "basalt.error.kind": "query"
+        }
+      });
+    });
+    const offMutation = client.getMutationCache().subscribe((ev) => {
+      if (ev.type !== "updated" || ev.action.type !== "error") return;
+      emit({
+        type: "mutation.error",
+        failed: true,
+        start: now(),
+        attributes: {
+          "basalt.mutation.key": JSON.stringify(ev.mutation.options.mutationKey ?? null),
+          "exception.type": errorName(ev.action.error),
+          "basalt.error.kind": "mutation"
+        }
+      });
+    });
+    return () => {
+      unbind();
+      offBefore();
+      offResolved();
+      offQuery();
+      offMutation();
+    };
+  }, [router, client, emit]);
+}
+const LazyDevDock = lazy(() => import("../dev-dock.js").then((m) => ({ default: m.BasaltDevDock })));
+function readQueryClient(router) {
+  const client = router.options.context?.queryClient;
+  if (client === void 0) {
+    throw new Error(
+      "[basalt] BasaltProvider: the router has no context.queryClient \u2014 create it with createBasaltRouter({ routeTree })."
+    );
+  }
+  return client;
+}
 function BasaltProvider({
-  children,
+  router,
   theme,
+  telemetry,
+  fallback,
   injectPalette = true,
   paletteOptions,
   defaultColorScheme = "dark",
-  onError,
   nonce,
-  connectivity,
   sizeClassHint = "compact",
   ...rest
 }) {
   useDuplicateProviderGuard();
   useHostAttribute();
-  const errorHandler = onError ?? defaultOnError;
+  const sinkRef = useRef(telemetry);
+  useEffect(() => {
+    sinkRef.current = telemetry;
+  });
+  const emit = useMemo(() => createEmitter((event) => sinkRef.current?.(event)), []);
+  useWindowErrors(emit);
+  useRegistryHotkeys();
+  useEffect(() => registerModalsProvider(), []);
+  const client = readQueryClient(router);
+  useDataTelemetry(router, client, emit);
+  const [devTool, setDevTool] = useState(null);
+  const [actions, setActions] = useState([]);
+  const refreshActions = useCallback(
+    () => setActions(buildSpotlightActions(router, setDevTool)),
+    [router]
+  );
+  useEffect(refreshActions, [refreshActions]);
   const resolvedTheme = useLabTheme(theme);
-  const resolvedConnectivity = connectivity ?? {};
   return (
     // `...rest` spreads FIRST so a consumer's `MantineProviderProps` can never shadow the three
     // values that follow it — `cssVariablesResolver` in particular is the resolver the package
-    // exists to install (F24); `theme`/`defaultColorScheme` are excluded from `rest`'s type too,
-    // this is belt-and-braces against a widened rest at the call site.
+    // exists to install.
     /* @__PURE__ */ jsx(
       MantineProvider,
       {
@@ -188,23 +275,36 @@ function BasaltProvider({
         theme: resolvedTheme,
         cssVariablesResolver,
         defaultColorScheme,
-        children: /* @__PURE__ */ jsx(BasaltErrorBoundary, { onError: errorHandler, children: /* @__PURE__ */ jsx(
-          BasaltBridge,
-          {
-            injectPalette,
-            paletteOptions,
-            nonce,
-            onError: errorHandler,
-            children: /* @__PURE__ */ jsx(SizeClassHintContext.Provider, { value: sizeClassHint, children: /* @__PURE__ */ jsx(ConnectivityProvider, { ...resolvedConnectivity, children }) })
-          }
-        ) })
+        children: /* @__PURE__ */ jsx(RootBoundary, { emit, fallback, children: /* @__PURE__ */ jsx(BasaltBridge, { injectPalette, paletteOptions, nonce, children: /* @__PURE__ */ jsx(TelemetryContext.Provider, { value: emit, children: /* @__PURE__ */ jsxs(SizeClassHintContext.Provider, { value: sizeClassHint, children: [
+          /* @__PURE__ */ jsx(QueryClientProvider, { client, children: /* @__PURE__ */ jsxs(ModalsProvider, { children: [
+            /* @__PURE__ */ jsx(RouterProvider, { router }),
+            process.env.NODE_ENV !== "production" && /* @__PURE__ */ jsx(Suspense, { fallback: null, children: /* @__PURE__ */ jsx(
+              LazyDevDock,
+              {
+                tool: devTool,
+                onClose: () => setDevTool(null),
+                router
+              }
+            ) })
+          ] }) }),
+          /* @__PURE__ */ jsx(Notifications, { position: "bottom-right", autoClose: 4e3, limit: 5 }),
+          /* @__PURE__ */ jsx(
+            Spotlight,
+            {
+              actions,
+              onSpotlightOpen: refreshActions,
+              shortcut: "mod + K",
+              maxHeight: 420
+            }
+          )
+        ] }) }) }) })
       }
     )
   );
 }
 export {
-  BasaltErrorBoundary,
   BasaltProvider,
+  RootBoundary,
   composeInjectedCss,
   useHostAttribute
 };

package/dist/provider/lab-theme.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lab-theme.d.ts","sourceRoot":"","sources":["../../src/provider/lab-theme.ts"],"names":[],"mappings":"AAyCA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAA;AAGzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAA;AA2C/D;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,oBAAoB,EAC1B,IAAI,EAAE,oBAAoB,GACzB,oBAAoB,CAEtB;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,oBAAoB,GAAG,SAAS,EAC3C,QAAQ,EAAE,cAAc,GAAG,IAAI,GAC9B,oBAAoB,CAWtB;AAuBD;;;;;;;;;GASG;AACH,iBAAS,cAAc,CAAC,SAAS,EAAE,oBAAoB,GAAG,SAAS,GAAG,oBAAoB,CAGzF;AAOD;;;;;;GAMG;AACH,eAAO,MAAM,WAAW,uBAA2E,CAAA"}
+{"version":3,"file":"lab-theme.d.ts","sourceRoot":"","sources":["../../src/provider/lab-theme.ts"],"names":[],"mappings":"AAyCA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAA;AAGzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAA;AA4C/D;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,oBAAoB,EAC1B,IAAI,EAAE,oBAAoB,GACzB,oBAAoB,CAEtB;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,oBAAoB,GAAG,SAAS,EAC3C,QAAQ,EAAE,cAAc,GAAG,IAAI,GAC9B,oBAAoB,CAWtB;AAuBD;;;;;;;;;GASG;AACH,iBAAS,cAAc,CAAC,SAAS,EAAE,oBAAoB,GAAG,SAAS,GAAG,oBAAoB,CAGzF;AAOD;;;;;;GAMG;AACH,eAAO,MAAM,WAAW,uBAA2E,CAAA"}

package/dist/provider/route-transition.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Route view transitions (V2-SPEC § 5): the direction of a navigation, read off `BasaltShell` nav
+ * order, plus the guard that keeps the router's discarded `ViewTransition` promises quiet.
+ *
+ * The router owns the call (`router-core` `startViewTransition`, router.js:490-508): it passes
+ * `{ update, types }` to `document.startViewTransition` when the browser supports
+ * `:active-view-transition-type()`, a bare callback otherwise, and returns only `updateCallbackDone`,
+ * so `ready` and `finished` are dropped on the floor.
+ */
+import type { AnyRouter } from '@tanstack/react-router';
+import { flattenNav, getActiveNav } from '../router-tanstack/nav.js';
+/** The three `:active-view-transition-type()` names `styles.css` animates. Namespaced: a consumer's own cannot collide. */
+export declare const ROUTE_TRANSITION_TYPES: {
+    readonly forward: "basalt-forward";
+    readonly back: "basalt-back";
+    readonly sibling: "basalt-sibling";
+};
+/** The argument of the router's `types` callback, derived from its own option type. */
+type RouterLocationChange = Parameters<Extract<Extract<AnyRouter['options']['defaultViewTransition'], object>['types'], (...args: never[]) => unknown>>[0];
+/** The part of it the direction reads: two pathnames and whether the path changed. */
+type LocationChange = Pick<RouterLocationChange, 'pathChanged'> & {
+    fromLocation?: Pick<NonNullable<RouterLocationChange['fromLocation']>, 'pathname'>;
+    toLocation: Pick<RouterLocationChange['toLocation'], 'pathname'>;
+};
+type ActiveNav = NonNullable<ReturnType<typeof getActiveNav>>;
+type NavItem = ReturnType<typeof flattenNav>[number];
+/**
+ * The flattened-nav index of the item that owns `pathname`, picked as the sidebar picks its active
+ * item: of the matches, the most specific (most non-empty segments in `link.to`) wins and the first
+ * in definition order takes a tie. `-1` when nothing matches.
+ *
+ * @internal exported for the corpus test against the router's real `matchRoute`.
+ */
+export declare function navIndexOf(flat: ReadonlyArray<NavItem>, pathname: string): number;
+/**
+ * The `types` callback for the router's `defaultViewTransition`. Pure: the nav is a parameter.
+ *
+ * - No `fromLocation`: the first load. The router also runs it through `startViewTransition`
+ *   (load-client.js:916), but there is no previous page to animate from, so `false`.
+ * - Same path (search or hash only): `false`, the page does not change.
+ * - A later nav item than the one you left: `forward`; an earlier one: `back`.
+ * - Same item (a detail beneath it), or either side outside the nav: `sibling`, a plain crossfade.
+ */
+export declare function routeTransitionTypes({ fromLocation, toLocation, pathChanged }: LocationChange, nav: ActiveNav | undefined): string[] | false;
+/**
+ * The router's own gate for passing `types` (router.js:495): without it the callback is never
+ * called and every navigation, first load and filter changes included, gets the UA's full-page
+ * crossfade. So below this support line there is no route transition at all. Server: none.
+ */
+export declare function supportsViewTransitionTypes(): boolean;
+/** What `createBasaltRouter` hands the router as `defaultViewTransition`. */
+export declare const routeViewTransition: {
+    types: (change: LocationChange) => false | string[];
+};
+/**
+ * Attaches a catch to `ready` and `finished` of every `document.startViewTransition` call, once per
+ * installed function (idempotent across routers). Router-core drops both (it returns only
+ * `updateCallbackDone`), and a superseded transition rejects them with `AbortError: Transition was
+ * skipped` (router discussion #7733), which `window` `unhandledrejection` — and so basalt's
+ * telemetry sink — would report.
+ *
+ * - `ready`: a skip is swallowed; any other reason goes to `reportError`, so it surfaces once, there
+ *   (a throwing handler would create a second, unowned rejection).
+ * - `finished`: always swallowed. A non-skip reason is the update callback's error, which `ready`
+ *   (and, for the router, its own `await updateCallbackDone`) already carries.
+ * - `updateCallbackDone` is left alone: the router awaits it, and a catch here would re-raise a
+ *   real error from a derived promise nobody owns.
+ *
+ * Chosen over an `unhandledrejection` filter because it removes the rejection at its source: it
+ * never becomes unhandled, so no listener (basalt's, a consumer's, devtools) sees it, and
+ * `preventDefault()` on a shared event would hide real rejections from the others. The wrapper
+ * returns the original `ViewTransition`. A no-op where the API is absent, and on the server.
+ */
+export declare function guardViewTransitionRejections(): void;
+export {};
+//# sourceMappingURL=route-transition.d.ts.map

package/dist/provider/route-transition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-transition.d.ts","sourceRoot":"","sources":["../../src/provider/route-transition.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAA;AACvD,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAA;AAEjE,2HAA2H;AAC3H,eAAO,MAAM,sBAAsB;;;;CAIzB,CAAA;AAEV,uFAAuF;AACvF,KAAK,oBAAoB,GAAG,UAAU,CACpC,OAAO,CACL,OAAO,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,uBAAuB,CAAC,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,EACvE,CAAC,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,OAAO,CAC9B,CACF,CAAC,CAAC,CAAC,CAAA;AAEJ,sFAAsF;AACtF,KAAK,cAAc,GAAG,IAAI,CAAC,oBAAoB,EAAE,aAAa,CAAC,GAAG;IAChE,YAAY,CAAC,EAAE,IAAI,CAAC,WAAW,CAAC,oBAAoB,CAAC,cAAc,CAAC,CAAC,EAAE,UAAU,CAAC,CAAA;IAClF,UAAU,EAAE,IAAI,CAAC,oBAAoB,CAAC,YAAY,CAAC,EAAE,UAAU,CAAC,CAAA;CACjE,CAAA;AAED,KAAK,SAAS,GAAG,WAAW,CAAC,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC,CAAA;AAC7D,KAAK,OAAO,GAAG,UAAU,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAA;AAoDpD;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,aAAa,CAAC,OAAO,CAAC,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAejF;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAClC,EAAE,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,EAAE,cAAc,EACzD,GAAG,EAAE,SAAS,GAAG,SAAS,GACzB,MAAM,EAAE,GAAG,KAAK,CAQlB;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,IAAI,OAAO,CAIrD;AAED,6EAA6E;AAC7E,eAAO,MAAM,mBAAmB;oBACd,cAAc;CAC/B,CAAA;AAqBD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,6BAA6B,IAAI,IAAI,CAYpD"}

package/dist/provider/route-transition.js

@@ -0,0 +1,98 @@
+import { flattenNav, getActiveNav } from "../router-tanstack/nav.js";
+const ROUTE_TRANSITION_TYPES = {
+  forward: "basalt-forward",
+  back: "basalt-back",
+  sibling: "basalt-sibling"
+};
+const trimTrailingSlash = (path) => path.length > 1 && path.endsWith("/") ? path.slice(0, -1) : path;
+const segmentsOf = (path) => path.split("/").filter(Boolean);
+function patternOf(item) {
+  const params = item.link.params;
+  const given = typeof params === "object" && params !== null ? params : {};
+  return segmentsOf(item.link.to).map((segment) => {
+    if (segment === "$") return { kind: "splat" };
+    const param = /^\{?(-?)\$([\w-]+)\}?$/.exec(segment);
+    if (param === null) return { kind: "literal", text: segment.toLowerCase() };
+    const value = given[param[2] ?? ""];
+    if (value !== void 0) return { kind: "value", text: String(value) };
+    return { kind: param[1] === "-" ? "optional" : "param" };
+  });
+}
+function matchParts(parts, path, at, fuzzy) {
+  const [part, ...rest] = parts;
+  if (part === void 0) return fuzzy || at === path.length;
+  if (part.kind === "splat") return true;
+  if (part.kind === "optional" && matchParts(rest, path, at, fuzzy)) return true;
+  const actual = path[at];
+  if (actual === void 0) return false;
+  if (part.kind === "literal" && part.text !== actual.lower) return false;
+  if (part.kind === "value" && part.text !== actual.raw) return false;
+  return matchParts(rest, path, at + 1, fuzzy);
+}
+function onItem(item, path) {
+  const fuzzy = item.exact !== true && item.link.to !== "/";
+  return matchParts(patternOf(item), path, 0, fuzzy);
+}
+function navIndexOf(flat, pathname) {
+  const path = segmentsOf(trimTrailingSlash(pathname)).map((raw) => ({
+    raw,
+    lower: raw.toLowerCase()
+  }));
+  let winner = -1;
+  let winnerSpecificity = -1;
+  for (const [index, item] of flat.entries()) {
+    const specificity = segmentsOf(item.link.to).length;
+    if (specificity > winnerSpecificity && onItem(item, path)) {
+      winner = index;
+      winnerSpecificity = specificity;
+    }
+  }
+  return winner;
+}
+function routeTransitionTypes({ fromLocation, toLocation, pathChanged }, nav) {
+  if (!fromLocation || !pathChanged) return false;
+  const flat = nav ? flattenNav(nav) : [];
+  const fromIndex = navIndexOf(flat, fromLocation.pathname);
+  const toIndex = navIndexOf(flat, toLocation.pathname);
+  if (fromIndex === -1 || toIndex === -1 || fromIndex === toIndex)
+    return [ROUTE_TRANSITION_TYPES.sibling];
+  return [toIndex > fromIndex ? ROUTE_TRANSITION_TYPES.forward : ROUTE_TRANSITION_TYPES.back];
+}
+function supportsViewTransitionTypes() {
+  if (typeof window === "undefined") return false;
+  const css = window.CSS;
+  return css?.supports?.("selector(:active-view-transition-type(a))") === true;
+}
+const routeViewTransition = {
+  types: (change) => routeTransitionTypes(change, getActiveNav())
+};
+const SKIP_NAMES = /* @__PURE__ */ new Set(["AbortError", "InvalidStateError", "TimeoutError"]);
+const isTransitionSkip = (reason) => reason instanceof DOMException && SKIP_NAMES.has(reason.name);
+const reportOnce = (reason) => {
+  if (isTransitionSkip(reason)) return;
+  if (typeof reportError === "function") reportError(reason);
+};
+const ignore = () => {
+};
+const guarded = /* @__PURE__ */ new WeakSet();
+function guardViewTransitionRejections() {
+  if (typeof document === "undefined" || typeof document.startViewTransition !== "function") return;
+  if (guarded.has(document.startViewTransition)) return;
+  const original = document.startViewTransition.bind(document);
+  const wrapped = (...args) => {
+    const transition = original(...args);
+    transition.ready.catch(reportOnce);
+    transition.finished.catch(ignore);
+    return transition;
+  };
+  guarded.add(wrapped);
+  document.startViewTransition = wrapped;
+}
+export {
+  ROUTE_TRANSITION_TYPES,
+  guardViewTransitionRejections,
+  navIndexOf,
+  routeTransitionTypes,
+  routeViewTransition,
+  supportsViewTransitionTypes
+};

package/dist/provider/spotlight-actions.d.ts

@@ -0,0 +1,10 @@
+/**
+ * The provider's Spotlight list: the `defineCommands` registry, then the `defineNav` destinations
+ * (via `flattenNav`), then the three dev-dock commands in dev. A snapshot rebuilt each time Spotlight
+ * opens, so a command's `when()` is current. Not for use during render (`detectMac` reads `navigator`).
+ */
+import type { SpotlightActionData } from '@mantine/spotlight';
+import type { AnyRouter } from '@tanstack/react-router';
+import type { BasaltDevDockTool } from '../dev-dock.js';
+export declare function buildSpotlightActions(router: AnyRouter, openDevTool: (tool: BasaltDevDockTool) => void): SpotlightActionData[];
+//# sourceMappingURL=spotlight-actions.d.ts.map

package/dist/provider/spotlight-actions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spotlight-actions.d.ts","sourceRoot":"","sources":["../../src/provider/spotlight-actions.tsx"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAA;AAC7D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAA;AAIvD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AASpD,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,SAAS,EACjB,WAAW,EAAE,CAAC,IAAI,EAAE,iBAAiB,KAAK,IAAI,GAC7C,mBAAmB,EAAE,CA8CvB"}

package/dist/provider/spotlight-actions.js

@@ -0,0 +1,55 @@
+import { getActiveCommands } from "../commands/define-commands.js";
+import { detectMac, formatShortcutDisplay } from "../commands/shortcut-format.js";
+import { flattenNav, getActiveNav } from "../router-tanstack/nav.js";
+import { runCommandSafely } from "./hotkeys.js";
+const DEV_TOOLS = [
+  { tool: "router", label: "Router devtools" },
+  { tool: "query", label: "Query devtools" },
+  { tool: "theme", label: "Theme lab" }
+];
+function buildSpotlightActions(router, openDevTool) {
+  const actions = [];
+  for (const [id, cmd] of Object.entries(getActiveCommands())) {
+    if (cmd.when !== void 0 && !cmd.when()) continue;
+    actions.push({
+      id,
+      label: cmd.label,
+      leftSection: cmd.icon,
+      keywords: [cmd.group ?? "", id].join(" ").trim(),
+      ...cmd.group !== void 0 && { group: cmd.group },
+      ...cmd.shortcut !== void 0 && {
+        description: formatShortcutDisplay(cmd.shortcut, detectMac())
+      },
+      onClick: () => runCommandSafely(cmd)
+    });
+  }
+  const nav = getActiveNav();
+  if (nav !== void 0) {
+    for (const item of flattenNav(nav)) {
+      if (item.disabled === true) continue;
+      actions.push({
+        id: `nav.${item.id}`,
+        label: item.label,
+        group: item.groupLabel,
+        leftSection: item.icon,
+        // `link` is the destination's own `linkOptions`, so a store-backed `search` thunk restores
+        // the last selection exactly as the sidebar link does.
+        onClick: () => void router.navigate(item.link)
+      });
+    }
+  }
+  if (process.env.NODE_ENV !== "production") {
+    for (const { tool, label } of DEV_TOOLS) {
+      actions.push({
+        id: `dev.${tool}`,
+        label,
+        group: "Dev",
+        onClick: () => openDevTool(tool)
+      });
+    }
+  }
+  return actions;
+}
+export {
+  buildSpotlightActions
+};

package/dist/provider/test-router.d.ts

@@ -0,0 +1,6 @@
+import type { AnyRouter } from '@tanstack/react-router';
+import type { BasaltRouterContext } from './create-router.js';
+/** The router's QueryClient — a plain root route declares no context type, so read it untyped. */
+export declare const queryClientOf: (router: AnyRouter) => BasaltRouterContext["queryClient"];
+export declare function testRouter(text?: string): import("./create-router.js").BasaltRouter<import("@tanstack/router-core").Route<import("@tanstack/router-core").Register, any, "/", "/", string, "__root__", undefined, {}, {}, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, {}, undefined, readonly [import("@tanstack/react-router").Route<unknown, import("@tanstack/react-router").RootRoute<import("@tanstack/router-core").Register, undefined, {}, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, {}, undefined, unknown, unknown, unknown, unknown, undefined>, "/other", "/other", string, "/other", undefined, import("@tanstack/router-core").ResolveParams<"/other">, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, {}, undefined, unknown, unknown, unknown, unknown, undefined>], unknown, unknown, unknown, undefined>>;
+//# sourceMappingURL=test-router.d.ts.map

package/dist/provider/test-router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-router.d.ts","sourceRoot":"","sources":["../../src/provider/test-router.tsx"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAA;AAEvD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAA;AAE1D,kGAAkG;AAClG,eAAO,MAAM,aAAa,GAAI,QAAQ,SAAS,KAAG,mBAAmB,CAAC,aAAa,CACtB,CAAA;AAE7D,wBAAgB,UAAU,CAAC,IAAI,SAAY,i6BAW1C"}