basalt-ui 1.28.0 → 1.29.0

package/dist/index.d.ts

@@ -5,12 +5,13 @@
  * `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/*`.
  */
-export { BasaltProvider, type BasaltProviderProps, BasaltErrorBoundary, type BasaltErrorContext, } from './provider/index.js';
-export { type BasaltProps, type SlotClassNames, type SlotStylesProps, type Tone, type ToneWithNeutral, type Tier, cx, assignRef, mergeRefs, BASALT_PREFIX, requiredProp, oneOf, deprecatedProp, duplicateMount, missingLayer, useValidateProps, assertRequiredProps, scrollParentOf, SCROLLPORT_ATTRIBUTE, } from './common/index.js';
+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, } 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';
+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
@@ -18,20 +19,24 @@ export type { CtlSlotProps } from './theme/index.js';
  * `PageBar`/`BasaltShell` `actions` wrapper needs only this one subpath.
  */
 export { ActionGroup, type BarAction, type ActionGroupProps, type GlobalAction, } from './controls/actions.js';
-export { ThemeToggle, type ThemeToggleProps } from './theme-toggle/index.js';
-export { MOTION_DURATION, MOTION_SPRING, MOTION_EASE_STANDARD } from './motion/index.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, 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 { 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, useBreakpoint, type BreakpointName, 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, } from './widget-header/index.js';
-export { Section, type SectionProps, type SectionSlot } from './section/index.js';
-export { 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 QueryStateVariant, type QueryEmptyCopy, LoadingState, type LoadingStateProps, ErrorState, type ErrorStateProps, } from './dashboard/index.js';
-export { ConnectivityProvider, ConnectivityIndicator, useConnectivity } from './connectivity/index.js';
-export type { ConnectivityStatus, ConnectivitySnapshot, ConnectivityProviderProps, ConnectivityOverride, } from './connectivity/index.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, ToolChipProps, } 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';
 //# 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":"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"}

package/dist/index.js

@@ -4,26 +4,16 @@ import {
 } from "./provider/index.js";
 import {
   cx,
-  assignRef,
-  mergeRefs,
-  BASALT_PREFIX,
-  requiredProp,
-  oneOf,
-  deprecatedProp,
-  duplicateMount,
-  missingLayer,
-  useValidateProps,
-  assertRequiredProps,
   scrollParentOf,
   SCROLLPORT_ATTRIBUTE
 } from "./common/index.js";
 import { createBasaltTheme, baseTheme, cssVariablesResolver } from "./theme/index.js";
 import { CTL_THEME, CtlSlot } from "./theme/index.js";
+import { ThemeToggle } from "./theme/theme-toggle.js";
 import {
   ActionGroup
 } from "./controls/actions.js";
-import { ThemeToggle } from "./theme-toggle/index.js";
-import { MOTION_DURATION, MOTION_SPRING, MOTION_EASE_STANDARD } from "./motion/index.js";
+import { MOTION_DURATION, MOTION_SPRING, MOTION_EASE_STANDARD } from "./common/motion.js";
 import {
   BasaltShell,
   NavCountBadge,
@@ -37,7 +27,9 @@ import {
   MOBILE_MORE_KEY,
   AppBreadcrumbs,
   PageBar,
-  PageAside
+  PageAside,
+  useBreakpoint,
+  PageTitle
 } from "./shell/index.js";
 import {
   assertNever
@@ -49,10 +41,8 @@ import {
 } from "./state.js";
 import {
   WidgetHeader,
-  DeltaBadge
-} from "./widget-header/index.js";
-import { Section } from "./section/index.js";
-import {
+  DeltaBadge,
+  Section,
   StatCard,
   WidgetGrid,
   StatGroup,
@@ -64,7 +54,13 @@ import {
   LoadingState,
   ErrorState
 } from "./dashboard/index.js";
-import { ConnectivityProvider, ConnectivityIndicator, useConnectivity } from "./connectivity/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,
@@ -87,9 +83,10 @@ export {
   ActionGroup,
   AppBreadcrumbs,
   AppSidebar,
-  BASALT_PREFIX,
+  BasaltDevDock,
   BasaltErrorBoundary,
   BasaltProvider,
+  BasaltQueryDevtools,
   BasaltShell,
   CTL_THEME,
   Composer,
@@ -111,6 +108,7 @@ export {
   NavCountBadge,
   PageAside,
   PageBar,
+  PageTitle,
   QueryState,
   SCROLLPORT_ATTRIBUTE,
   Section,
@@ -131,29 +129,25 @@ export {
   WidgetGrid,
   WidgetHeader,
   assertNever,
-  assertRequiredProps,
-  assignRef,
   baseTheme,
   createAdapterThreadsStore,
+  createBasaltQueryClient,
   createBasaltTheme,
   createLocalStore,
   createPersistedState,
   createThreadsStore,
   cssVariablesResolver,
   cx,
-  deprecatedProp,
-  duplicateMount,
+  errorStatus,
   heuristicOutcome,
-  mergeRefs,
-  missingLayer,
-  oneOf,
   projectMobileNav,
   readPersistedValue,
-  requiredProp,
   scrollParentOf,
   threadPartRenderers,
   threadsStoreAdapterContract,
+  toErrorMessage,
+  unwrap,
   useAgentThreadRuns,
-  useConnectivity,
-  useValidateProps
+  useBreakpoint,
+  useConnectivity
 };

package/dist/notifications/index.d.ts

@@ -2,7 +2,9 @@
  * ./notifications — Mantine notification adapter battery.
  *
  * Provides notify helpers, a typed registry, a persisted history store, and a bell/center
- * overlay component on top of @mantine/notifications.
+ * component on top of @mantine/notifications. The overlay mount is `<BasaltOverlays notifications
+ * />` (`basalt-ui/commands`) — this subpath no longer ships one of its own (C1 consolidation:
+ * `BasaltNotifications` was superseded and is removed).
  *
  * Optional peer: @mantine/notifications ^9.3.0.
  *
@@ -10,8 +12,8 @@
  *
  * @example
  * // main.tsx — mount the overlay:
- * import { BasaltNotifications } from 'basalt-ui/notifications'
- * <BasaltProvider><BasaltNotifications /><App /></BasaltProvider>
+ * import { BasaltOverlays } from 'basalt-ui/commands'
+ * <BasaltProvider><BasaltOverlays><App /></BasaltOverlays></BasaltProvider>
  *
  * // Usage:
  * import { notifySuccess, notifyError, notifyPromise, NotificationBell } from 'basalt-ui/notifications'
@@ -35,6 +37,4 @@ export { NotificationBell } from './bell.js';
 export type { NotificationBellProps } from './bell.js';
 export { NotificationCenter } from './center.js';
 export type { NotificationCenterProps } from './center.js';
-export { BasaltNotifications } from './overlay.js';
-export type { BasaltNotificationsProps } from './overlay.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/notifications/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAGH,OAAO,EACL,MAAM,EACN,aAAa,EACb,WAAW,EACX,aAAa,EACb,UAAU,EACV,aAAa,EACb,UAAU,EACV,cAAc,GACf,MAAM,UAAU,CAAA;AACjB,YAAY,EACV,aAAa,EACb,qBAAqB,EACrB,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,UAAU,CAAA;AAGjB,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,IAAI,EACJ,aAAa,EACb,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,GACxB,MAAM,wBAAwB,CAAA;AAG/B,OAAO,EACL,GAAG,EACH,QAAQ,EACR,WAAW,EACX,OAAO,EACP,UAAU,EACV,MAAM,EACN,KAAK,EACL,cAAc,EACd,sBAAsB,GACvB,MAAM,SAAS,CAAA;AAChB,YAAY,EACV,qBAAqB,EACrB,uBAAuB,EACvB,wBAAwB,EACxB,4BAA4B,GAC7B,MAAM,SAAS,CAAA;AAGhB,OAAO,EAAE,gBAAgB,EAAE,MAAM,QAAQ,CAAA;AACzC,YAAY,EAAE,qBAAqB,EAAE,MAAM,QAAQ,CAAA;AAGnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAA;AAC7C,YAAY,EAAE,uBAAuB,EAAE,MAAM,UAAU,CAAA;AAGvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAA;AAC/C,YAAY,EAAE,wBAAwB,EAAE,MAAM,WAAW,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/notifications/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAGH,OAAO,EACL,MAAM,EACN,aAAa,EACb,WAAW,EACX,aAAa,EACb,UAAU,EACV,aAAa,EACb,UAAU,EACV,cAAc,GACf,MAAM,UAAU,CAAA;AACjB,YAAY,EACV,aAAa,EACb,qBAAqB,EACrB,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,UAAU,CAAA;AAGjB,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,IAAI,EACJ,aAAa,EACb,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,GACxB,MAAM,wBAAwB,CAAA;AAG/B,OAAO,EACL,GAAG,EACH,QAAQ,EACR,WAAW,EACX,OAAO,EACP,UAAU,EACV,MAAM,EACN,KAAK,EACL,cAAc,EACd,sBAAsB,GACvB,MAAM,SAAS,CAAA;AAChB,YAAY,EACV,qBAAqB,EACrB,uBAAuB,EACvB,wBAAwB,EACxB,4BAA4B,GAC7B,MAAM,SAAS,CAAA;AAGhB,OAAO,EAAE,gBAAgB,EAAE,MAAM,QAAQ,CAAA;AACzC,YAAY,EAAE,qBAAqB,EAAE,MAAM,QAAQ,CAAA;AAGnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAA;AAC7C,YAAY,EAAE,uBAAuB,EAAE,MAAM,UAAU,CAAA"}

package/dist/notifications/index.js

@@ -27,9 +27,7 @@ import {
 } from "./store.js";
 import { NotificationBell } from "./bell.js";
 import { NotificationCenter } from "./center.js";
-import { BasaltNotifications } from "./overlay.js";
 export {
-  BasaltNotifications,
   NotificationBell,
   NotificationCenter,
   add,

package/dist/notifications/mount-guard.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mount-guard.d.ts","sourceRoot":"","sources":["../../src/notifications/mount-guard.ts"],"names":[],"mappings":"AAoBA;;;;;GAKG;AACH,wBAAgB,0BAA0B,IAAI,IAAI,CAcjD"}
+{"version":3,"file":"mount-guard.d.ts","sourceRoot":"","sources":["../../src/notifications/mount-guard.ts"],"names":[],"mappings":"AAkBA;;;;;GAKG;AACH,wBAAgB,0BAA0B,IAAI,IAAI,CAcjD"}

package/dist/notifications/mount-guard.js

@@ -1,12 +1,12 @@
 import { useEffect } from "react";
-import { isDev } from "../utils/is-dev.js";
+import { isDev } from "../common/is-dev.js";
 let mountedNotificationsCount = 0;
 function useNotificationsMountGuard() {
   useEffect(() => {
     mountedNotificationsCount++;
     if (mountedNotificationsCount > 1 && isDev()) {
       console.warn(
-        "[basalt] more than one Notifications overlay is mounted at once \u2014 mount ONE of <BasaltOverlays notifications /> or <BasaltNotifications />, never both (they both render Mantine's <Notifications />, so toasts would double-fire)."
+        "[basalt] more than one Notifications overlay is mounted at once \u2014 mount exactly ONE <BasaltOverlays notifications /> (they all render Mantine's <Notifications />, so toasts would double-fire)."
       );
     }
     return () => {

package/dist/provider/connectivity-indicator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connectivity-indicator.d.ts","sourceRoot":"","sources":["../../src/provider/connectivity-indicator.tsx"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAKlD,MAAM,MAAM,0BAA0B,GAAG,WAAW,CAAA;AAyJpD;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,GAAE,0BAA+B,+BAiF1F"}

package/dist/{connectivity → provider}/connectivity-provider.d.ts

@@ -1,5 +1,5 @@
 import type { ReactNode } from 'react';
-import type { ConnectivitySnapshot, ConnectivityProviderProps } from './types.js';
+import type { ConnectivitySnapshot, ConnectivityProviderProps } from './connectivity-types.js';
 export declare const ConnectivityContext: import("react").Context<ConnectivitySnapshot | null>;
 export declare function ConnectivityProvider({ children, sseUrl, healthUrl, healthIntervalMs, override, }: ConnectivityProviderProps & {
     children: ReactNode;

package/dist/provider/connectivity-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connectivity-provider.d.ts","sourceRoot":"","sources":["../../src/provider/connectivity-provider.tsx"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAEtC,OAAO,KAAK,EAAE,oBAAoB,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAA;AAmB3F,eAAO,MAAM,mBAAmB,sDAAmD,CAAA;AAyBnF,wBAAgB,oBAAoB,CAAC,EACnC,QAAQ,EACR,MAAM,EACN,SAAS,EACT,gBAAyB,EACzB,QAAQ,GACT,EAAE,yBAAyB,GAAG;IAAE,QAAQ,EAAE,SAAS,CAAA;CAAE,+BAgIrD"}

package/dist/{connectivity/types.d.ts → provider/connectivity-types.d.ts}

@@ -33,4 +33,4 @@ export type ConnectivityProviderProps = {
     /** Override individual signal values for testing / simulation. Non-overridden keys use real signals. */
     override?: ConnectivityOverride;
 };
-//# sourceMappingURL=types.d.ts.map
+//# sourceMappingURL=connectivity-types.d.ts.map

package/dist/provider/connectivity-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connectivity-types.d.ts","sourceRoot":"","sources":["../../src/provider/connectivity-types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,MAAM,kBAAkB,GAAG,QAAQ,GAAG,SAAS,GAAG,UAAU,CAAA;AAElE,MAAM,MAAM,oBAAoB,GAAG;IACjC,MAAM,EAAE,kBAAkB,CAAA;IAC1B,+DAA+D;IAC/D,OAAO,EAAE;QACP,aAAa,EAAE,OAAO,CAAA;QAItB,WAAW,EAAE,OAAO,CAAA;QACpB,OAAO,EAAE,OAAO,GAAG,IAAI,CAAA;QACvB,aAAa,EAAE,OAAO,GAAG,IAAI,CAAA;KAC9B,CAAA;CACF,CAAA;AAED,MAAM,MAAM,oBAAoB,GAAG;IACjC,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI,CAAA;IACxB,aAAa,CAAC,EAAE,OAAO,GAAG,IAAI,CAAA;CAC/B,CAAA;AAED,MAAM,MAAM,yBAAyB,GAAG;IACtC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;IACzB,iGAAiG;IACjG,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,oGAAoG;IACpG,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,8DAA8D;IAC9D,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,wGAAwG;IACxG,QAAQ,CAAC,EAAE,oBAAoB,CAAA;CAChC,CAAA"}

package/dist/provider/error-fallback.module.css

@@ -0,0 +1,21 @@
+/* The boundary renders ABOVE MantineProvider, so its fallback is plain HTML styled here — no
+   Mantine primitive, no inline style object (hidden-inline-style). Tokens only. */
+.root {
+  max-width: 32rem;
+  margin: 0 auto;
+  padding: var(--vx-space-stack-xl);
+  display: flex;
+  flex-direction: column;
+  gap: var(--vx-space-stack-md);
+}
+
+.reload {
+  align-self: flex-start;
+  font: inherit;
+  cursor: pointer;
+  padding: var(--vx-space-stack-xs) var(--vx-space-stack-md);
+  border: 1px solid var(--vx-divider);
+  border-radius: var(--vx-radius-ctrl);
+  background: transparent;
+  color: inherit;
+}

package/dist/provider/error-fallback.module.css.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Typed CSS-module declaration (the S4 CSS-modules path). Named string props — not an index
+ * signature — so dot access stays verbatim under the package's strict flags.
+ */
+declare const classes: {
+  readonly root: string
+  readonly reload: string
+}
+export default classes

package/dist/provider/index.d.ts

@@ -1,7 +1,7 @@
 import type { MantineProviderProps } from '@mantine/core';
 import { Component } from 'react';
 import type { ErrorInfo, ReactNode } from 'react';
-import type { ConnectivityProviderProps } from '../connectivity/index.js';
+import type { ConnectivityProviderProps } from './connectivity-types.js';
 import type { BuildPaletteOpts } from '../tokens/index.js';
 /**
  * Where an error surfaced — drives consumer routing (a render error vs a global rejection differ).
@@ -75,30 +75,28 @@ export type BasaltProviderProps = {
      * 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`). Takes precedence over the deprecated flattened props below when both
-     * are set.
+     * `ConnectivityProvider`).
      */
     connectivity?: Omit<ConnectivityProviderProps, 'children'>;
+} & 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 = {
+    children: ReactNode;
     /**
-     * @deprecated Use `connectivity={{ sseUrl }}` instead. Still honoured when `connectivity` is
-     * unset or omits `sseUrl`; removed in 1.29.0.
-     */
-    sseUrl?: string;
-    /**
-     * @deprecated Use `connectivity={{ healthUrl }}` instead. Still honoured when `connectivity` is
-     * unset or omits `healthUrl`; removed in 1.29.0.
+     * 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.
      */
-    healthUrl?: string;
+    onError?: (error: unknown, ctx: BasaltErrorContext) => void;
     /**
-     * @deprecated Use `connectivity={{ healthIntervalMs }}` instead. Still honoured when
-     * `connectivity` is unset or omits `healthIntervalMs`; removed in 1.29.0.
+     * 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.
      */
-    healthIntervalMs?: number;
-} & Omit<MantineProviderProps, 'children' | 'theme' | 'defaultColorScheme' | 'cssVariablesResolver'>;
-type BoundaryProps = {
-    children: ReactNode;
-    onError: (error: unknown, ctx: BasaltErrorContext) => void;
-    /** Optional UI to render when a render error is caught. If a function, called with the error. Defaults to null. */
     fallback?: ReactNode | ((error: unknown) => ReactNode);
 };
 type BoundaryState = {
@@ -115,8 +113,8 @@ type BoundaryState = {
  *   <MyFeature />
  * </BasaltErrorBoundary>
  */
-export declare class BasaltErrorBoundary extends Component<BoundaryProps, BoundaryState> {
-    constructor(props: BoundaryProps);
+export declare class BasaltErrorBoundary extends Component<BasaltErrorBoundaryProps, BoundaryState> {
+    constructor(props: BasaltErrorBoundaryProps);
     static getDerivedStateFromError(error: unknown): BoundaryState;
     componentDidCatch(error: unknown, info: ErrorInfo): void;
     render(): ReactNode;
@@ -135,20 +133,6 @@ export declare class BasaltErrorBoundary extends Component<BoundaryProps, Bounda
  * rendering a React tree.
  */
 export declare function composeInjectedCss(base: string, fontsCss: string, radiusCss: string, densityCss: string): string;
-/**
- * Resolves the `connectivity` object against the three deprecated flattened props: `connectivity`
- * wins WHOLESALE when provided, not per-key — a partial `connectivity={{ sseUrl }}` no longer picks
- * up a stray `healthUrl` left on the old prop, which was surprising for a mid-migration consumer who
- * expected the new prop to fully replace the old ones once set. Warns once, dev builds only, when
- * both are actually supplied. Exported as a pure function (same rationale as `composeInjectedCss`
- * above) so `provider/index.test.ts` can assert the precedence without rendering a tree.
- */
-export declare function resolveConnectivityProps(props: {
-    connectivity: Omit<ConnectivityProviderProps, 'children'> | undefined;
-    sseUrl: string | undefined;
-    healthUrl: string | undefined;
-    healthIntervalMs: number | undefined;
-}): Omit<ConnectivityProviderProps, 'children'>;
-export declare function BasaltProvider({ children, theme, injectPalette, paletteOptions, defaultColorScheme, onError, nonce, connectivity, sseUrl, healthUrl, healthIntervalMs, ...rest }: BasaltProviderProps): import("react").JSX.Element;
+export declare function BasaltProvider({ children, theme, injectPalette, paletteOptions, defaultColorScheme, onError, nonce, connectivity, ...rest }: BasaltProviderProps): import("react").JSX.Element;
 export {};
 //# sourceMappingURL=index.d.ts.map

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":"AAuBA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAA;AACzD,OAAO,EAAE,SAAS,EAAsB,MAAM,OAAO,CAAA;AACrD,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAIjD,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAA;AAIrE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAA;AAOjD;;;;;;;;;;GAUG;AACH,MAAM,MAAM,kBAAkB,GAC1B;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,SAAS,CAAA;CAAE,GACnC;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,UAAU,CAAA;CAAE,GACrC;IAAE,IAAI,EAAE,oBAAoB,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,CAAA;AAEnD,MAAM,MAAM,mBAAmB,GAAG;IAChC,QAAQ,EAAE,SAAS,CAAA;IACnB,oFAAoF;IACpF,KAAK,CAAC,EAAE,oBAAoB,CAAC,OAAO,CAAC,CAAA;IACrC;;;;;;;;;;;;;;;;;;OAkBG;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;;;;;;;OAOG;IACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,kBAAkB,KAAK,IAAI,CAAA;IAC3D;;;;;OAKG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;IACd;;;;;OAKG;IACH,YAAY,CAAC,EAAE,IAAI,CAAC,yBAAyB,EAAE,UAAU,CAAC,CAAA;CAC3D,GAAG,IAAI,CAAC,oBAAoB,EAAE,UAAU,GAAG,OAAO,GAAG,oBAAoB,GAAG,sBAAsB,CAAC,CAAA;AAcpG;;;GAGG;AACH,MAAM,MAAM,wBAAwB,GAAG;IACrC,QAAQ,EAAE,SAAS,CAAA;IACnB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,kBAAkB,KAAK,IAAI,CAAA;IAC3D;;;;OAIG;IACH,QAAQ,CAAC,EAAE,SAAS,GAAG,CAAC,CAAC,KAAK,EAAE,OAAO,KAAK,SAAS,CAAC,CAAA;CACvD,CAAA;AAED,KAAK,aAAa,GAAG;IAAE,QAAQ,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAAA;AA2B1D;;;;;;;;;GASG;AACH,qBAAa,mBAAoB,SAAQ,SAAS,CAAC,wBAAwB,EAAE,aAAa,CAAC;gBAC7E,KAAK,EAAE,wBAAwB;IAK3C,MAAM,CAAC,wBAAwB,CAAC,KAAK,EAAE,OAAO,GAAG,aAAa;IAIrD,iBAAiB,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,GAAG,IAAI;IAKxD,MAAM,IAAI,SAAS;CAS7B;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,GACjB,MAAM,CAER;AAwHD,wBAAgB,cAAc,CAAC,EAC7B,QAAQ,EACR,KAAK,EACL,aAAoB,EACpB,cAAc,EACd,kBAA2B,EAC3B,OAAO,EACP,KAAK,EACL,YAAY,EACZ,GAAG,IAAI,EACR,EAAE,mBAAmB,+BAmCrB"}

package/dist/provider/index.js

@@ -1,19 +1,47 @@
 import { jsx, jsxs } from "react/jsx-runtime";
-import { MantineProvider, useComputedColorScheme, useMantineTheme } from "@mantine/core";
+import {
+  MantineProvider,
+  useComputedColorScheme,
+  useMantineColorScheme,
+  useMantineTheme
+} from "@mantine/core";
 import { Component, useEffect, useMemo } from "react";
 import { VxThemeProvider } from "../charts/theme.js";
-import { ConnectivityProvider } from "../connectivity/index.js";
+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 { isDefaultDeriveConfig } from "../tokens/derive.js";
 import { buildPaletteData } from "../tokens/palette.js";
-import { isDev } from "../utils/is-dev.js";
+import { isDev } from "../common/is-dev.js";
+import { registerColorSchemeSetter } from "../commands/shell-bridge.js";
+import { PageTitle } from "../shell/page-title.js";
 function defaultOnError(error, ctx) {
   if (isDev()) {
     console.error("[BasaltProvider] unhandled error", ctx.kind, error);
   }
 }
+function DefaultErrorFallback() {
+  return /* @__PURE__ */ jsxs("div", { className: fallbackClasses.root, children: [
+    /* @__PURE__ */ jsx(
+      PageTitle,
+      {
+        title: "Something went wrong",
+        subtitle: "The page hit an unexpected error and was unloaded to keep the app stable."
+      }
+    ),
+    /* @__PURE__ */ jsx(
+      "button",
+      {
+        type: "button",
+        className: fallbackClasses.reload,
+        onClick: () => window.location.reload(),
+        children: "Reload page"
+      }
+    )
+  ] });
+}
 class BasaltErrorBoundary extends Component {
   constructor(props) {
     super(props);
@@ -23,12 +51,14 @@ class BasaltErrorBoundary extends Component {
     return { hasError: true, error };
   }
   componentDidCatch(error, info) {
-    this.props.onError(error, { kind: "render", info });
+    const onError = this.props.onError ?? defaultOnError;
+    onError(error, { kind: "render", info });
   }
   render() {
     if (this.state.hasError) {
       const { fallback } = this.props;
-      if (fallback === void 0) return null;
+      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;
@@ -45,6 +75,11 @@ function BasaltBridge({
   onError
 }) {
   const resolved = useComputedColorScheme("dark");
+  const { setColorScheme: setMantineColorScheme } = useMantineColorScheme();
+  useEffect(() => {
+    registerColorSchemeSetter(setMantineColorScheme);
+    return () => registerColorSchemeSetter(null);
+  }, [setMantineColorScheme]);
   const theme = useMantineTheme();
   const deriveConfig = theme.other?.basaltDerive;
   const fontsConfig = theme.other?.basaltFonts;
@@ -96,22 +131,6 @@ function useDuplicateProviderGuard() {
     };
   }, []);
 }
-function resolveConnectivityProps(props) {
-  if (props.connectivity !== void 0) {
-    const hasDeprecated = props.sseUrl !== void 0 || props.healthUrl !== void 0 || props.healthIntervalMs !== void 0;
-    if (hasDeprecated && isDev()) {
-      console.warn(
-        "[basalt] BasaltProvider: `connectivity` and one of `sseUrl`/`healthUrl`/`healthIntervalMs` were both supplied \u2014 `connectivity` wins wholesale and the deprecated props are ignored."
-      );
-    }
-    return props.connectivity;
-  }
-  return {
-    ...props.sseUrl !== void 0 ? { sseUrl: props.sseUrl } : {},
-    ...props.healthUrl !== void 0 ? { healthUrl: props.healthUrl } : {},
-    ...props.healthIntervalMs !== void 0 ? { healthIntervalMs: props.healthIntervalMs } : {}
-  };
-}
 function BasaltProvider({
   children,
   theme,
@@ -121,20 +140,12 @@ function BasaltProvider({
   onError,
   nonce,
   connectivity,
-  sseUrl,
-  healthUrl,
-  healthIntervalMs,
   ...rest
 }) {
   useDuplicateProviderGuard();
   const errorHandler = onError ?? defaultOnError;
   const resolvedTheme = useLabTheme(theme);
-  const resolvedConnectivity = resolveConnectivityProps({
-    connectivity,
-    sseUrl,
-    healthUrl,
-    healthIntervalMs
-  });
+  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
@@ -164,6 +175,5 @@ function BasaltProvider({
 export {
   BasaltErrorBoundary,
   BasaltProvider,
-  composeInjectedCss,
-  resolveConnectivityProps
+  composeInjectedCss
 };

package/dist/provider/lab-theme.js

@@ -2,7 +2,7 @@ import { mergeThemeOverrides } from "@mantine/core";
 import { useMemo } from "react";
 import { useDeriveControlsState, toDeriveOverride } from "../theme-lab/derive-state.js";
 import { baseTheme, createBasaltTheme } from "../theme/index.js";
-import { isDev } from "../utils/is-dev.js";
+import { isDev } from "../common/is-dev.js";
 const isPlainObject = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
 function sameLeaf(a, b) {
   if (a === b) return true;

package/dist/provider/use-connectivity.d.ts

@@ -0,0 +1,3 @@
+import type { ConnectivitySnapshot } from './connectivity-types.js';
+export declare function useConnectivity(): ConnectivitySnapshot;
+//# sourceMappingURL=use-connectivity.d.ts.map

package/dist/provider/use-connectivity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-connectivity.d.ts","sourceRoot":"","sources":["../../src/provider/use-connectivity.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAA;AAEhE,wBAAgB,eAAe,IAAI,oBAAoB,CAUtD"}