basalt-ui 1.41.0 → 2.0.1

package/dist/index.d.ts

@@ -1,51 +1,19 @@
 /**
- * basalt-ui root barrel — the Mantine-coupled surface.
- *
- * Provider + theme + the app shell. The Mantine-free token/chart layer is published under the
- * `basalt-ui/tokens` and `basalt-ui/charts` subpath exports (see package.json), NOT re-exported
- * here, so a tokens/charts-only consumer never pulls in `@mantine/*`.
+ * basalt-ui root barrel — the Mantine-coupled surface: provider, theme, the app shell and the
+ * dashboard atoms. The Mantine-free token/chart layer is published under `basalt-ui/tokens` and
+ * `basalt-ui/charts`, NOT re-exported here, so a tokens/charts-only consumer never pulls in
+ * `@mantine/*`. One import path per symbol: `docs/V2-SPEC.md` § 1; the per-symbol verdicts are
+ * `docs/waves/v2-surface.md`.
  */
-export { BasaltProvider, type BasaltProviderProps, BasaltErrorBoundary, type BasaltErrorBoundaryProps, type BasaltErrorContext, } from './provider/index.js';
-export { type BasaltProps, type SlotClassNames, type SlotStylesProps, type Tone, type ToneWithNeutral, type Tier, cx, scrollParentOf, SCROLLPORT_ATTRIBUTE, useCoarsePointer, } from './common/index.js';
-export { createBasaltTheme, baseTheme, cssVariablesResolver } from './theme/index.js';
-export type { BasaltFontsConfig, CreateBasaltThemeOptions } from './theme/index.js';
-export { CTL_THEME, CtlSlot } from './theme/index.js';
-export type { CtlSlotProps } from './theme/index.js';
-/**
- * The ACTIVE resolved spacing off the running theme, not the frozen level-0 `SPACE`/`SPACE_STEP`
- * snapshot on `basalt-ui/tokens`. Public because a consumer laying out ITS OWN chrome beside the
- * shell's (a sticky sub-header under the app header, a fixed rail beside the navbar) has to hit the
- * same rhythm the shell resolved, and every one of those numbers is JS-consumed — an AppShell
- * dimension or a `<Menu width={…}>` — so there is no `--vx-*` var to read it from instead. See
- * `theme/use-basalt-spacing.ts` for the level-0 fallback contract.
- */
-export { useBasaltSpacing } from './theme/index.js';
-export { ThemeToggle, type ThemeToggleProps } from './theme/theme-toggle.js';
-/**
- * The action vocabulary every home's `actions` slot takes (`docs/CONTROLS-SPEC.md` §2.1). The
- * OTHER components that project it (`OverflowMenu`, `SyncButton`, and the filter family) live on
- * `basalt-ui/controls`; `ActionGroup` is re-exported here alongside its own types so a typed
- * `PageBar`/`BasaltShell` `actions` wrapper needs only this one subpath.
- */
-export { ActionGroup, type BarAction, type ActionGroupProps, type GlobalAction, } from './controls/actions.js';
-export { MOTION_DURATION, MOTION_SPRING, MOTION_EASE_STANDARD } from './common/motion.js';
-export { BasaltShell, NavCountBadge, type NavCountBadgeProps, AppSidebar, SidebarSearch, type SidebarSearchProps, type SidebarSearchConfig, type SidebarSearchActions, SidebarAccount, MobileNav, type MobileNavProps, projectMobileNav, type ProjectMobileNavOptions, MOBILE_MAX_TABS_DEFAULT, MOBILE_MENU_MAX_DEFAULT, MOBILE_MORE_KEY, AppBreadcrumbs, type AppBreadcrumbsProps, PageBar, type PageBarProps, type PageBarSlot, PageAside, type PageAsideProps, type PageAsideSlot, useSizeClass, type SizeClass, PageTitle, type PageTitleProps, type PageTitleSlot, type SidebarSection, type SidebarItem, type SidebarBlock, type SidebarBlockItem, type SidebarBlockTone, type SidebarListBlock, type SidebarProgressBlock, type SidebarCustomBlock, type NavAnchor, type NavAnchorProps, type NavMobilePlacement, type NavSectionMobile, type MobileNavConfig, type MobileNavGroup, type MobileNavModel, type MobileNavSlot, type MobileNavSurface, type BasaltShellProps, type BrandConfig, type SettingsMenuItem, type AppSidebarProps, type AccountBadgeTone, type BasaltIdentity, type BasaltRole, type BasaltPlan, type AccountMenuItem, type BasaltAccountState, type BasaltAccountActions, type BasaltAccountProps, } from './shell/index.js';
-export { type BasaltRegister, type Slot, type Series, type SeriesKey, type AsyncState, assertNever, type StandardSchemaV1, } from './register.js';
-export { createPersistedState, type PersistedStateOptions, readPersistedValue, createLocalStore, type LocalStore, type AnyField, type BooleanField, type EnumField, type FieldFallback, type FieldHandle, type FieldLane, type FieldOption, type FieldSetOptions, type FieldValue, type MultiField, type NumberField, type RangeField, type RangeParams, type RangePresets, type RangeValue, type RangeWindow, type RangeWindows, type ResolvedLane, type ResolveLane, type SearchValues, type StoredValues, type StringField, } from './state.js';
-export { WidgetHeader, type WidgetHeaderDeltaProps, type WidgetHeaderMetricProps, type WidgetHeaderProps, type WidgetHeaderSlot, type WidgetHeaderTier, type WidgetHeaderTitleProps, DeltaBadge, type DeltaBadgeProps, type DeltaPolarity, Section, type SectionProps, type SectionSlot, StatCard, type StatCardBreakdownRow, type StatCardProps, type StatCardSlot, type StatCardTone, WidgetGrid, type WidgetGridCols, type WidgetGridItemProps, type WidgetGridProps, StatGroup, type StatGroupCols, type StatGroupProps, EmptyState, type EmptyStateProps, type EmptyStateSlot, SettingsSection, type SettingsSectionProps, type SettingsSectionSlot, SettingsRow, type SettingsRowProps, type SettingsRowSlot, DangerZone, type DangerZoneProps, QueryState, type QueryStateProps, type QueryStateLike, type QueryStateSlot, type QueryStateTier, type QueryEmptyCopy, LoadingState, type LoadingStateProps, ErrorState, type ErrorStateProps, } from './dashboard/index.js';
-export { ConnectivityProvider } from './provider/connectivity-provider.js';
-export { ConnectivityIndicator } from './provider/connectivity-indicator.js';
-export { useConnectivity } from './provider/use-connectivity.js';
-export type { ConnectivityStatus, ConnectivitySnapshot, ConnectivityProviderProps, ConnectivityOverride, } from './provider/connectivity-types.js';
-export type { ConnectivityIndicatorProps } from './provider/connectivity-indicator.js';
-export { createBasaltQueryClient, unwrap } from './query-client.js';
-export { BasaltQueryDevtools } from './query-devtools.js';
-export { toErrorMessage, errorStatus } from './common/errors.js';
-export { BasaltDevDock, type BasaltDevDockProps, type BasaltDevDockTool } from './dev-dock.js';
-export type { SurfaceSpec, RuleName, SkillName } from './surfaces.js';
-export type { GuardKind } from './guard/types.js';
-export { ThreadWorkspace, ThreadFeed, ThreadFeedRow, ThreadOutcomeCard, ThreadDetailPanel, Composer, threadPartRenderers, ThreadTranscript, ToolChip, } from './agent-chat/index.js';
-export type { ThreadWorkspaceProps, ThreadFeedProps, ThreadFeedRowProps, ThreadOutcomeCardProps, ThreadDetailPanelProps, ComposerProps, ComposerSubmit, ComposerAttachment, ComposerHandle, ThreadTranscriptProps, MessageAffordances, VirtualizeOptions, VirtualizeProps, RowHeightProps, ToolChipProps, } from './agent-chat/index.js';
-export { createAdapterThreadsStore, createThreadsStore, heuristicOutcome, threadsStoreAdapterContract, useAgentThreadRuns, } from './agent/index.js';
-export type { AdapterThreadsStoreOptions, AgentThread, AgentOutcome, ThreadStatus, ThreadsStore, ThreadsStoreAdapter, ThreadsStoreAdapterContractCase, ThreadsStoreOptions, OutcomeResolver, ChatMessage, AgentPart, AgentTransport, } from './agent/index.js';
+export { BasaltProvider } from './provider/index.js';
+export { createBasaltRouter, type BasaltRouter, type BasaltRouterContext, } from './provider/create-router.js';
+export type { BasaltEvent } from './telemetry.js';
+export { defineNav, navGroup, navTarget, flattenNav, useBasaltNav, type NavItemId, } from './router-tanstack/index.js';
+export { scrollParentOf, useCoarsePointer } from './common/index.js';
+export { createBasaltTheme } from './theme/index.js';
+export { ThemeToggle } from './theme/theme-toggle.js';
+export { BasaltShell, PageBar, PageAside, useSizeClass, PageTitle, type ShellBaseProps, type SidebarBlock, type SettingsMenuItem, } from './shell/index.js';
+export { WidgetHeader, DeltaBadge, Section, StatCard, type StatCardBreakdownRow, type StatCardTone, StatGroup, EmptyState, SettingsSection, SettingsRow, DangerZone, } from './dashboard/index.js';
+export { unwrap } from './query-client.js';
+export type { BasaltRegister, SeriesKey } from './register.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAC3C,OAAO,EACL,kBAAkB,EAClB,KAAK,YAAY,EACjB,KAAK,mBAAmB,GACzB,MAAM,0BAA0B,CAAA;AACjC,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAC9C,OAAO,EACL,SAAS,EACT,QAAQ,EACR,SAAS,EACT,UAAU,EACV,YAAY,EACZ,KAAK,SAAS,GACf,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAA;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAA;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAClD,OAAO,EACL,WAAW,EACX,OAAO,EACP,SAAS,EACT,YAAY,EACZ,SAAS,EACT,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,gBAAgB,GACtB,MAAM,SAAS,CAAA;AAChB,OAAO,EACL,YAAY,EACZ,UAAU,EACV,OAAO,EACP,QAAQ,EACR,KAAK,oBAAoB,EACzB,KAAK,YAAY,EACjB,SAAS,EACT,UAAU,EACV,eAAe,EACf,WAAW,EACX,UAAU,GACX,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAA;AAMvC,YAAY,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA"}

package/dist/index.js

@@ -1,157 +1,61 @@
-import {
-  BasaltProvider,
-  BasaltErrorBoundary
-} from "./provider/index.js";
-import {
-  cx,
-  scrollParentOf,
-  SCROLLPORT_ATTRIBUTE,
-  useCoarsePointer
-} from "./common/index.js";
-import { createBasaltTheme, baseTheme, cssVariablesResolver } from "./theme/index.js";
-import { CTL_THEME, CtlSlot } from "./theme/index.js";
-import { useBasaltSpacing } from "./theme/index.js";
+import { BasaltProvider } from "./provider/index.js";
+import {
+  createBasaltRouter
+} from "./provider/create-router.js";
+import {
+  defineNav,
+  navGroup,
+  navTarget,
+  flattenNav,
+  useBasaltNav
+} from "./router-tanstack/index.js";
+import { scrollParentOf, useCoarsePointer } from "./common/index.js";
+import { createBasaltTheme } from "./theme/index.js";
 import { ThemeToggle } from "./theme/theme-toggle.js";
-import {
-  ActionGroup
-} from "./controls/actions.js";
-import { MOTION_DURATION, MOTION_SPRING, MOTION_EASE_STANDARD } from "./common/motion.js";
 import {
   BasaltShell,
-  NavCountBadge,
-  AppSidebar,
-  SidebarSearch,
-  SidebarAccount,
-  MobileNav,
-  projectMobileNav,
-  MOBILE_MAX_TABS_DEFAULT,
-  MOBILE_MENU_MAX_DEFAULT,
-  MOBILE_MORE_KEY,
-  AppBreadcrumbs,
   PageBar,
   PageAside,
   useSizeClass,
   PageTitle
 } from "./shell/index.js";
-import {
-  assertNever
-} from "./register.js";
-import {
-  createPersistedState,
-  readPersistedValue,
-  createLocalStore
-} from "./state.js";
 import {
   WidgetHeader,
   DeltaBadge,
   Section,
   StatCard,
-  WidgetGrid,
   StatGroup,
   EmptyState,
   SettingsSection,
   SettingsRow,
-  DangerZone,
-  QueryState,
-  LoadingState,
-  ErrorState
+  DangerZone
 } from "./dashboard/index.js";
-import { ConnectivityProvider } from "./provider/connectivity-provider.js";
-import { ConnectivityIndicator } from "./provider/connectivity-indicator.js";
-import { useConnectivity } from "./provider/use-connectivity.js";
-import { createBasaltQueryClient, unwrap } from "./query-client.js";
-import { BasaltQueryDevtools } from "./query-devtools.js";
-import { toErrorMessage, errorStatus } from "./common/errors.js";
-import { BasaltDevDock } from "./dev-dock.js";
-import {
-  ThreadWorkspace,
-  ThreadFeed,
-  ThreadFeedRow,
-  ThreadOutcomeCard,
-  ThreadDetailPanel,
-  Composer,
-  threadPartRenderers,
-  ThreadTranscript,
-  ToolChip
-} from "./agent-chat/index.js";
-import {
-  createAdapterThreadsStore,
-  createThreadsStore,
-  heuristicOutcome,
-  threadsStoreAdapterContract,
-  useAgentThreadRuns
-} from "./agent/index.js";
+import { unwrap } from "./query-client.js";
 export {
-  ActionGroup,
-  AppBreadcrumbs,
-  AppSidebar,
-  BasaltDevDock,
-  BasaltErrorBoundary,
   BasaltProvider,
-  BasaltQueryDevtools,
   BasaltShell,
-  CTL_THEME,
-  Composer,
-  ConnectivityIndicator,
-  ConnectivityProvider,
-  CtlSlot,
   DangerZone,
   DeltaBadge,
   EmptyState,
-  ErrorState,
-  LoadingState,
-  MOBILE_MAX_TABS_DEFAULT,
-  MOBILE_MENU_MAX_DEFAULT,
-  MOBILE_MORE_KEY,
-  MOTION_DURATION,
-  MOTION_EASE_STANDARD,
-  MOTION_SPRING,
-  MobileNav,
-  NavCountBadge,
   PageAside,
   PageBar,
   PageTitle,
-  QueryState,
-  SCROLLPORT_ATTRIBUTE,
   Section,
   SettingsRow,
   SettingsSection,
-  SidebarAccount,
-  SidebarSearch,
   StatCard,
   StatGroup,
   ThemeToggle,
-  ThreadDetailPanel,
-  ThreadFeed,
-  ThreadFeedRow,
-  ThreadOutcomeCard,
-  ThreadTranscript,
-  ThreadWorkspace,
-  ToolChip,
-  WidgetGrid,
   WidgetHeader,
-  assertNever,
-  baseTheme,
-  createAdapterThreadsStore,
-  createBasaltQueryClient,
+  createBasaltRouter,
   createBasaltTheme,
-  createLocalStore,
-  createPersistedState,
-  createThreadsStore,
-  cssVariablesResolver,
-  cx,
-  errorStatus,
-  heuristicOutcome,
-  projectMobileNav,
-  readPersistedValue,
+  defineNav,
+  flattenNav,
+  navGroup,
+  navTarget,
   scrollParentOf,
-  threadPartRenderers,
-  threadsStoreAdapterContract,
-  toErrorMessage,
   unwrap,
-  useAgentThreadRuns,
-  useBasaltSpacing,
+  useBasaltNav,
   useCoarsePointer,
-  useConnectivity,
   useSizeClass
 };

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

@@ -0,0 +1,44 @@
+import type { QueryClient, QueryClientConfig } from '@tanstack/react-query';
+import { Router } from '@tanstack/react-router';
+import type { AnyRoute, RouterHistory } from '@tanstack/react-router';
+/** The root route's context: `createRootRouteWithContext<BasaltRouterContext>()`. */
+export type BasaltRouterContext = {
+    queryClient: QueryClient;
+};
+type BasaltRouterBase<TRouteTree extends AnyRoute> = Router<TRouteTree, 'never', false, RouterHistory, Record<string, any>>;
+declare const basaltRouterBrand: unique symbol;
+/**
+ * What `createBasaltRouter` returns, and the only router `BasaltProvider` accepts. The brand is
+ * type-level only: a plain `createRouter(...)` has the same shape without it and fails to compile,
+ * because the provider needs the `queryClient` context and the defaults `createBasaltRouter` sets.
+ *
+ * The route-tree default is TanStack's own `AnyRouter` shape (`any`): a specific tree is not
+ * assignable to `AnyRoute`, and `BasaltProvider` accepts any tree.
+ */
+export type BasaltRouter<TRouteTree extends AnyRoute = any> = BasaltRouterBase<TRouteTree> & {
+    readonly [basaltRouterBrand]: true;
+};
+/**
+ * Side effect, once per document: wraps `document.startViewTransition` so a skipped route
+ * transition (`AbortError`) never becomes an unhandled rejection (`guardViewTransitionRejections`).
+ * Nothing else global is touched.
+ *
+ * @example
+ * const router = createBasaltRouter({ routeTree })
+ * declare module '@tanstack/react-router' {
+ *   interface Register { router: typeof router }
+ * }
+ * // extra context (argo's auth) extends BasaltRouterContext:
+ * const router = createBasaltRouter({ routeTree, context: { auth }, query: { queryCache } })
+ */
+export declare function createBasaltRouter<TRouteTree extends AnyRoute, TContext extends object = Record<never, never>>(options: {
+    routeTree: TRouteTree;
+    /** Context beyond `queryClient`; the root route's context type extends `BasaltRouterContext`. */
+    context?: TContext;
+    /** Merged over basalt's QueryClient defaults (`staleTime` 30 s, `gcTime` 5 min, `retry` 2, no refetch on focus). */
+    query?: QueryClientConfig;
+    /** Route transitions are basalt's (V2-SPEC § 5): the router's would double them. */
+    defaultViewTransition?: never;
+}): BasaltRouter<TRouteTree>;
+export {};
+//# sourceMappingURL=create-router.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"create-router.d.ts","sourceRoot":"","sources":["../../src/provider/create-router.tsx"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAA;AAC3E,OAAO,EAAE,MAAM,EAAgB,MAAM,wBAAwB,CAAA;AAC7D,OAAO,KAAK,EAAE,QAAQ,EAAuB,aAAa,EAAE,MAAM,wBAAwB,CAAA;AAU1F,qFAAqF;AACrF,MAAM,MAAM,mBAAmB,GAAG;IAChC,WAAW,EAAE,WAAW,CAAA;CACzB,CAAA;AAED,KAAK,gBAAgB,CAAC,UAAU,SAAS,QAAQ,IAAI,MAAM,CACzD,UAAU,EACV,OAAO,EACP,KAAK,EACL,aAAa,EACb,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CACpB,CAAA;AAED,OAAO,CAAC,MAAM,iBAAiB,EAAE,OAAO,MAAM,CAAA;AAE9C;;;;;;;GAOG;AACH,MAAM,MAAM,YAAY,CACtB,UAAU,SAAS,QAAQ,GAAG,GAAG,IAC/B,gBAAgB,CAAC,UAAU,CAAC,GAAG;IACjC,QAAQ,CAAC,CAAC,iBAAiB,CAAC,EAAE,IAAI,CAAA;CACnC,CAAA;AAmCD;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAChC,UAAU,SAAS,QAAQ,EAC3B,QAAQ,SAAS,MAAM,GAAG,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,EAC9C,OAAO,EAAE;IACT,SAAS,EAAE,UAAU,CAAA;IACrB,iGAAiG;IACjG,OAAO,CAAC,EAAE,QAAQ,CAAA;IAClB,oHAAoH;IACpH,KAAK,CAAC,EAAE,iBAAiB,CAAA;IACzB,oFAAoF;IACpF,qBAAqB,CAAC,EAAE,KAAK,CAAA;CAC9B,GAAG,YAAY,CAAC,UAAU,CAAC,CA+B3B"}

package/dist/provider/create-router.js

@@ -0,0 +1,62 @@
+import { jsx, jsxs } from "react/jsx-runtime";
+import { Button, Center, Loader, Stack, Text } from "@mantine/core";
+import { Router, createRouter } from "@tanstack/react-router";
+import { toErrorMessage } from "../common/errors.js";
+import { makeQueryClient } from "../query-client.js";
+import { errorName, now, routerTelemetry } from "../telemetry.js";
+import {
+  guardViewTransitionRejections,
+  routeViewTransition,
+  supportsViewTransitionTypes
+} from "./route-transition.js";
+function PendingComponent() {
+  return /* @__PURE__ */ jsx(Center, { py: "xl", children: /* @__PURE__ */ jsx(Loader, { size: "sm" }) });
+}
+function ErrorComponent({ error, reset }) {
+  return /* @__PURE__ */ jsxs(Stack, { align: "flex-start", gap: "xs", p: "md", children: [
+    /* @__PURE__ */ jsx(Text, { fw: 600, children: "Something went wrong" }),
+    /* @__PURE__ */ jsx(Text, { c: "dimmed", size: "sm", children: toErrorMessage(error) }),
+    /* @__PURE__ */ jsx(Button, { size: "compact-sm", variant: "default", onClick: reset, children: "Try again" })
+  ] });
+}
+function NotFoundComponent() {
+  return /* @__PURE__ */ jsxs(Stack, { gap: 4, p: "md", children: [
+    /* @__PURE__ */ jsx(Text, { fw: 600, children: "Page not found" }),
+    /* @__PURE__ */ jsx(Text, { c: "dimmed", size: "sm", children: "This address does not match any page." })
+  ] });
+}
+function createBasaltRouter(options) {
+  guardViewTransitionRejections();
+  const queryClient = makeQueryClient(options.query);
+  const router = createRouter({
+    routeTree: options.routeTree,
+    context: { ...options.context, queryClient },
+    defaultPreload: "intent",
+    // Query owns freshness: a preload must not be cached a second time by the router.
+    defaultPreloadStaleTime: 0,
+    scrollRestoration: true,
+    // Route changes only; React's `<ViewTransition>` stays for in-page changes (the aside fold).
+    // Types-gated: without `:active-view-transition-type()` the router would crossfade the whole page.
+    defaultViewTransition: supportsViewTransitionTypes() ? routeViewTransition : false,
+    defaultPendingComponent: PendingComponent,
+    defaultErrorComponent: ErrorComponent,
+    defaultNotFoundComponent: NotFoundComponent,
+    defaultOnCatch: (error) => {
+      if (process.env.NODE_ENV !== "production") console.error("[basalt] route error", error);
+      routerTelemetry(router)({
+        type: "route.error",
+        failed: true,
+        start: now(),
+        attributes: {
+          "basalt.route.id": router.state.matches.at(-1)?.routeId ?? "unknown",
+          "exception.type": errorName(error),
+          "basalt.error.kind": "route"
+        }
+      });
+    }
+  });
+  return router;
+}
+export {
+  createBasaltRouter
+};

package/dist/provider/hotkeys.d.ts

@@ -0,0 +1,8 @@
+import type { Command } from '../commands/define-commands.js';
+/**
+ * Runs a command, swallowing a sync throw or async rejection so a failing command never becomes an
+ * unhandled rejection (which the provider would report as a `window.error`). Dev logs it.
+ */
+export declare function runCommandSafely(cmd: Command): void;
+export declare function useRegistryHotkeys(): void;
+//# sourceMappingURL=hotkeys.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hotkeys.d.ts","sourceRoot":"","sources":["../../src/provider/hotkeys.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,6BAA6B,CAAA;AAE1D;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CASnD;AAED,wBAAgB,kBAAkB,IAAI,IAAI,CAyCzC"}

package/dist/provider/hotkeys.js

@@ -0,0 +1,50 @@
+import { useEffect } from "react";
+import { getActiveCommands } from "../commands/define-commands.js";
+function runCommandSafely(cmd) {
+  const report = (error) => {
+    if (process.env.NODE_ENV !== "production") console.error("[basalt] command failed", error);
+  };
+  try {
+    Promise.resolve(cmd.run()).catch(report);
+  } catch (error) {
+    report(error);
+  }
+}
+function useRegistryHotkeys() {
+  useEffect(() => {
+    const commands = Object.values(getActiveCommands()).filter((c) => c.shortcut !== void 0);
+    if (commands.length === 0) return;
+    let cancelled = false;
+    const handles = [];
+    void import("@tanstack/react-hotkeys").catch(() => void 0).then((peer) => {
+      if (cancelled || peer === void 0) return;
+      const manager = peer.getHotkeyManager();
+      for (const cmd of commands) {
+        if (cmd.shortcut === void 0) continue;
+        handles.push(
+          manager.register(
+            cmd.shortcut,
+            (event) => {
+              if (cmd.when !== void 0 && !cmd.when()) return;
+              event.preventDefault();
+              runCommandSafely(cmd);
+            },
+            { preventDefault: false }
+          )
+        );
+      }
+    }).catch((error) => {
+      if (process.env.NODE_ENV !== "production") {
+        console.error("[basalt] command hotkeys failed to bind", error);
+      }
+    });
+    return () => {
+      cancelled = true;
+      for (const handle of handles) handle.unregister();
+    };
+  }, []);
+}
+export {
+  runCommandSafely,
+  useRegistryHotkeys
+};

package/dist/provider/index.d.ts

@@ -1,148 +1,71 @@
 import type { MantineProviderProps } from '@mantine/core';
 import { Component } from 'react';
 import type { ErrorInfo, ReactNode } from 'react';
-import type { ConnectivityProviderProps } from './connectivity-types.js';
-import type { BuildPaletteOpts } from '../tokens/index.js';
+import type { BuildPaletteOpts } from '../tokens/core.js';
 import type { SizeClass } from '../shell/use-size-class.js';
-/**
- * Where an error surfaced — drives consumer routing (a render error vs a global rejection differ).
- *
- * @example
- * <BasaltProvider
- *   onError={(e, ctx) => {
- *     if (ctx.kind === 'render') Sentry.captureException(e, { extra: { info: ctx.info } })
- *     if (ctx.kind === 'unhandledrejection') Sentry.captureException(e)
- *   }}
- * >
- */
-export type BasaltErrorContext = {
-    kind: 'render';
-    info: ErrorInfo;
-} | {
-    kind: 'window';
-    event: ErrorEvent;
-} | {
-    kind: 'unhandledrejection';
-    reason: unknown;
-};
+import type { Telemetry } from '../telemetry.js';
+import type { BasaltRouter } from './create-router.js';
 export type BasaltProviderProps = {
-    children: ReactNode;
-    /** Theme override merged onto the Basalt base. Omit to use the base theme as-is. */
+    /** From `createBasaltRouter`; the provider mounts it and reads its `queryClient`. */
+    router: BasaltRouter;
+    /** Theme override merged onto the Basalt base. Defaults to `createBasaltTheme()`. */
     theme?: MantineProviderProps['theme'];
+    /**
+     * Typed events (V2-SPEC § 7) — navigations, route/query/mutation/render/window errors. Called
+     * synchronously and wrapped in `try/catch`, so a throwing sink never breaks a render. Events carry
+     * ids, hashes, counts and durations only; no sink, no events.
+     */
+    telemetry?: Telemetry;
+    /** The root error boundary's UI. Unset → a minimal page with a reload button; `null` renders nothing. */
+    fallback?: ReactNode | ((error: unknown) => ReactNode);
     /**
      * Inject the `--vx-*` palette stylesheet once via an inline `<style>`. Default `true`. Set
-     * `false` to skip it (SSR / head injection — emit `buildPaletteCss(paletteOptions)` yourself, all
-     * three builders importable from `basalt-ui/tokens`).
-     * A `{ fonts }` config passed to `createBasaltTheme` rides this SAME injection (its
-     * `--basalt-font-*` declarations are appended to the same `<style>`), so `injectPalette={false}`
-     * opts fonts out too — emit `buildFontsCss(theme.other.basaltFonts)` yourself alongside the
-     * palette CSS in that case.
-     * A `{ radius }` config rides the SAME injection too (its `--vx-radius-*` override declarations
-     * are appended alongside), so `injectPalette={false}` opts radius out just the same — an SSR
-     * consumer disabling injection must also emit `buildRadiusCss(theme.other.basaltRadius)`
-     * themselves, or `var(--vx-radius-*)` consumers render at their defaults instead of the retuned
-     * level.
-     * A `{ density }` config rides the SAME injection too (its `--vx-space-*` override declarations
-     * are appended alongside), so `injectPalette={false}` opts density out just the same — an SSR
-     * consumer disabling injection must also emit `buildDensityCss(theme.other.basaltDensity)`
-     * themselves, or `var(--vx-space-*)` consumers render at their defaults instead of the retuned
-     * level.
+     * `false` to skip it (SSR / head injection — emit `buildPaletteCss(paletteOptions)` yourself).
+     * Fonts, radius and density configs ride the same injection, so `false` opts them out too.
      */
     injectPalette?: boolean;
     /**
      * Passed through to `buildPaletteCss` so a consumer can append its own series/groups/derived
-     * declarations on top of the framework primitives. Additive extension to the S0 stub shape.
+     * declarations on top of the framework primitives.
      */
     paletteOptions?: BuildPaletteOpts;
     /** Default color scheme. Defaults to dark. */
     defaultColorScheme?: MantineProviderProps['defaultColorScheme'];
     /**
-     * Report errors caught by the in-provider boundary AND global window/unhandledrejection listeners.
-     * Unset → console.error in dev (process.env.NODE_ENV !== 'production'), no-op in prod.
-     * NEVER a no-op prop — the BasaltErrorBoundary + listeners that feed it ship in this same freeze.
-     *
-     * @example
-     * <BasaltProvider onError={(e, ctx) => Sentry.captureException(e, { tags: { kind: ctx.kind } })}>
-     */
-    onError?: (error: unknown, ctx: BasaltErrorContext) => void;
-    /**
-     * CSP nonce for the raw palette `<style>` at provider/index.tsx (the one element `...rest`
-     * cannot reach — it is basalt's own JSX, not a Mantine prop). For Mantine's own injected styles,
-     * also pass `getStyleNonce={() => nonce}` via `...rest` — Mantine v9 has no top-level `nonce`
-     * prop; its nonce mechanism is `getStyleNonce: () => string`, which flows through `...rest`.
+     * CSP nonce for the raw palette `<style>` (the one element `...rest` cannot reach). For Mantine's
+     * own injected styles also pass `getStyleNonce={() => nonce}` via `...rest`.
      */
     nonce?: string;
-    /**
-     * Options threaded through to the auto-mounted `ConnectivityProvider` (everything except
-     * `children`) — `sseUrl`, `healthUrl`, `healthIntervalMs`, and `override` (previously
-     * unreachable through `BasaltProvider`: the only way to reach it was a second, shadowing
-     * `ConnectivityProvider`).
-     */
-    connectivity?: Omit<ConnectivityProviderProps, 'children'>;
     /**
      * The size class `useSizeClass()` reports on the server and during hydration, before `matchMedia`
-     * can answer. Default `'compact'` (mobile-first). SSR only: a client-rendered (`createRoot`) app
-     * reads `matchMedia` on its first render and never sees this value. An SSR app that knows the
-     * device class (UA hint, cookie) passes it so the first frame already matches. An SSR desktop app
-     * SHOULD pass it: without it the first paint is `'compact'`, and `PageAside`/`ThreadWorkspace`
-     * remount after hydration when the real class lands.
+     * can answer. Default `'compact'`. SSR only; an SSR desktop app SHOULD pass it.
      */
     sizeClassHint?: SizeClass;
 } & Omit<MantineProviderProps, 'children' | 'theme' | 'defaultColorScheme' | 'cssVariablesResolver'>;
-/**
- * `BasaltErrorBoundary`'s props — exported (C5 consolidation) so a consumer mounting a nested
- * boundary can name the type, e.g. for a wrapper component's own prop forwarding.
- */
-export type BasaltErrorBoundaryProps = {
+type RootBoundaryProps = {
     children: ReactNode;
-    /**
-     * Report the caught render error. Unset → `defaultOnError` (console.error in dev, no-op in
-     * prod — the same fallback `BasaltProvider`'s own top-level `onError` uses), so a NESTED
-     * boundary mounted with no `onError` still surfaces something in dev instead of silently
-     * swallowing it.
-     */
-    onError?: (error: unknown, ctx: BasaltErrorContext) => void;
-    /**
-     * UI to render when a render error is caught. If a function, called with the error. Unset →
-     * {@link DefaultErrorFallback} — a minimal `PageTitle` + reload button, never a silent `null`;
-     * pass `fallback={null}` explicitly for the old swallow-it behaviour.
-     */
-    fallback?: ReactNode | ((error: unknown) => ReactNode);
+    emit: Telemetry;
+    fallback: BasaltProviderProps['fallback'];
 };
 type BoundaryState = {
     hasError: boolean;
     error: unknown;
 };
-/**
- * Error boundary that catches render-phase errors inside `BasaltProvider`. Wraps `BasaltBridge` +
- * children INSIDE `MantineProvider` so a thrown render error still has theme context for a fallback.
- * Also exported so consumers can mount nested boundaries with the same `onError` contract.
- *
- * @example
- * <BasaltErrorBoundary onError={(e, ctx) => Sentry.captureException(e)} fallback={<p>Something went wrong.</p>}>
- *   <MyFeature />
- * </BasaltErrorBoundary>
- */
-export declare class BasaltErrorBoundary extends Component<BasaltErrorBoundaryProps, BoundaryState> {
-    constructor(props: BasaltErrorBoundaryProps);
+/** Catches render-phase errors inside `MantineProvider`, so a fallback still has theme context. */
+export declare class RootBoundary extends Component<RootBoundaryProps, BoundaryState> {
+    constructor(props: RootBoundaryProps);
     static getDerivedStateFromError(error: unknown): BoundaryState;
-    componentDidCatch(error: unknown, info: ErrorInfo): void;
+    componentDidCatch(error: unknown, _info: ErrorInfo): void;
     render(): ReactNode;
 }
 /**
  * Compose the four independently-built override CSS blocks into ONE injected `<style>` body, in
- * cascade-winning order. Every builder (`buildPaletteCss`/`buildFontsCss`/`buildRadiusCss`/
- * `buildDensityCss`) emits its declarations under a bare `:root { ... }` block — EQUAL selector
- * specificity across all four — so nothing but DOCUMENT ORDER decides which value a browser paints
- * when two blocks declare the same custom property. `density` must come LAST (its `--vx-space-*`
- * overrides must out-cascade the base palette's own defaults), `radius` after `fonts`, `fonts` after
- * `base` — reorder this array and the density/radius/fonts knobs silently stop working, with every
- * OTHER existing test still green (each builder is tested for its OWN output in isolation, not for
- * where it lands in the concatenated string). Exported as a pure function (not inlined in
- * `BasaltBridge`'s `useMemo`) purely so `provider/index.test.ts` can assert the ORDER holds without
- * rendering a React tree.
+ * cascade-winning order. Every builder emits its declarations under a bare `:root { ... }` block —
+ * EQUAL selector specificity — so nothing but DOCUMENT ORDER decides which value a browser paints.
+ * `density` must come LAST, `radius` after `fonts`, `fonts` after `base`; reorder this array and the
+ * knobs silently stop working. Exported as a pure function so a test can assert the ORDER.
  */
-export declare function composeInjectedCss(base: string, fontsCss: string, radiusCss: string, densityCss: string, inputsCss?: string): string;
+export declare function composeInjectedCss(base: string, fontsCss: string, radiusCss: string, densityCss: string): string;
 /**
  * `data-basalt-host` on `<html>` — the one place a `display-mode` query is read; CSS keys off it.
  *
@@ -153,6 +76,6 @@ export declare function composeInjectedCss(base: string, fontsCss: string, radiu
  * closes the gap between hydration and the next client paint.
  */
 export declare function useHostAttribute(): void;
-export declare function BasaltProvider({ children, theme, injectPalette, paletteOptions, defaultColorScheme, onError, nonce, connectivity, sizeClassHint, ...rest }: BasaltProviderProps): import("react").JSX.Element;
+export declare function BasaltProvider({ router, theme, telemetry, fallback, injectPalette, paletteOptions, defaultColorScheme, nonce, sizeClassHint, ...rest }: BasaltProviderProps): import("react").JSX.Element;
 export {};
 //# sourceMappingURL=index.d.ts.map