@richardmcquiston01/dashboard-widgets-toolkit 0.9.0 → 0.11.0

package/dist/react.d.cts

@@ -1,5 +1,5 @@
 import { ReactNode, RefObject } from 'react';
-import { D as DashboardWidget, W as WidgetSize, a as WidgetFill, G as GraphWidgetData, N as NiceDomain, b as WidgetDefinition, c as DetailProviderOptions, d as DetailData, e as DetailQuery, L as Locale, f as DashboardLayout, A as AlertListWidgetData, B as BarListWidgetData, g as GaugeWidgetData, K as KpiWidgetData, T as TableWidgetData, R as ResolvedTableControls, h as TextWidgetData, i as WidgetData, j as ResolveOptions, k as WidgetContext, l as WidgetProviders } from './scale-CrXxawQn.cjs';
+import { D as DashboardWidget, W as WidgetSize, a as WidgetFill, G as GraphWidgetData, N as NiceDomain, b as WidgetDefinition, c as DetailProviderOptions, d as DetailData, e as DetailQuery, O as OptionValues, L as Locale, f as DashboardLayout, A as AlertListWidgetData, B as BarListWidgetData, g as GaugeWidgetData, K as KpiWidgetData, T as TableWidgetData, R as ResolvedTableControls, h as DetailSort, i as TextWidgetData, j as WidgetData, k as LayoutPersistence, S as StoreScope, P as PageItem, l as NormalizeOptions, m as ResolveOptions, n as WidgetContext, o as WidgetProviders } from './storage-VaaysVnZ.cjs';
 
 interface WidgetCardProps {
     readonly title: string;
@@ -145,14 +145,16 @@ interface DetailLoadState {
  * `undefined`, `fallback` (for example the card's own complete data) is used
  * instead. `reload` runs it again. Keep `load` and `fallback` referentially
  * stable (`useCallback` / `useMemo`): a new value restarts the load.
+ * `optionValues` (the widget's resolved options) go to the loader as
+ * `options.options`.
  */
-declare function useDetailData(definition: WidgetDefinition, load: DetailLoader | undefined, enabled: boolean, fallback?: DetailData): {
+declare function useDetailData(definition: WidgetDefinition, load: DetailLoader | undefined, enabled: boolean, fallback?: DetailData, optionValues?: OptionValues): {
     readonly state: DetailLoadState;
     readonly reload: () => void;
 };
 
 /** Every element that carries a stable `dwt-*` class, for `classNames`. */
-type DashboardClassSlot = 'dashboard' | 'hiddenBar' | 'toolbar' | 'grid' | 'card' | 'cardHeader' | 'cardTitle' | 'cardDescription' | 'cardActions' | 'cardBody' | 'cardFooter' | 'button' | 'status' | 'empty' | 'error' | 'text' | 'kpi' | 'gauge' | 'table' | 'barList' | 'alertList' | 'chart' | 'legend' | 'tooltip' | 'tableTwin' | 'detail';
+type DashboardClassSlot = 'dashboard' | 'hiddenBar' | 'toolbar' | 'pageBar' | 'grid' | 'card' | 'cardHeader' | 'cardTitle' | 'cardDescription' | 'cardActions' | 'cardBody' | 'cardFooter' | 'button' | 'status' | 'empty' | 'error' | 'text' | 'kpi' | 'gauge' | 'table' | 'barList' | 'alertList' | 'chart' | 'legend' | 'tooltip' | 'tableTwin' | 'detail';
 /**
  * Extra classes per slot, appended to the `dwt-*` class (never replacing
  * it), e.g. `{ card: 'rounded-lg shadow-sm' }` for Tailwind.
@@ -190,6 +192,30 @@ interface DashboardLabels {
     readonly locked: (title: string) => string;
     /** The lock icon on a card shown to an administrator (`overrideLocks`). */
     readonly lockedForViewers: (title: string) => string;
+    /** Pages: names the tab list, and each tab ("Page 2 of 3: Sales"). */
+    readonly pageBar: string;
+    readonly pageTabName: (index: number, count: number, title: string) => string;
+    readonly previousPageButton: string;
+    readonly nextPageButton: string;
+    /** Page management while editing. */
+    readonly managePages: string;
+    readonly addPage: string;
+    readonly renamePage: (title: string) => string;
+    readonly pageTitle: string;
+    readonly savePageTitle: string;
+    readonly cancelPageTitle: string;
+    readonly deletePage: (title: string) => string;
+    readonly confirmDeletePage: (title: string) => string;
+    readonly movePageLeft: (title: string) => string;
+    readonly movePageRight: (title: string) => string;
+    /** The select on each card that moves it to another page. */
+    readonly moveToPage: (title: string) => string;
+    readonly moveToPagePlaceholder: string;
+    readonly moveToPageOption: (title: string, rowsFree: number) => string;
+    readonly newPageOption: string;
+    readonly movedToPage: (title: string, pageTitle: string) => string;
+    readonly pageFull: (pageTitle: string, maxRows: number) => string;
+    readonly emptyPage: string;
     /** Added to the accessible name of links that open in a new tab. */
     readonly opensInNewTab: string;
     /** The card's View button, opening the detail view. */
@@ -277,6 +303,19 @@ interface DashboardProps extends WidgetSettings {
     readonly defaultLayout?: DashboardLayout;
     /** Show the built-in Customize/Done/Reset toolbar (toggle mode). Default true. */
     readonly toolbar?: boolean;
+    /**
+     * The page in view (a page key) when the layout has pages. Controlled with
+     * `onActivePageChange`; without it the dashboard keeps its own, starting on
+     * `defaultActivePage` or the first page. Pages never listed fall back to
+     * the first.
+     */
+    readonly activePage?: string;
+    readonly defaultActivePage?: string;
+    readonly onActivePageChange?: (pageKey: string) => void;
+    /** Rows a page holds unless the page says otherwise. Default 4. */
+    readonly maxRows?: number;
+    /** Most pages the viewer can add while editing. Default: no limit. */
+    readonly maxPages?: number;
     readonly onRetry?: (key: string) => void;
     /**
      * Loads the full data for a widget's detail view (widgets whose definition
@@ -345,10 +384,12 @@ declare function GaugeWidget({ data, }: {
     readonly data: GaugeWidgetData;
 }): ReactNode;
 /** TABLE: a data table; cells with a safe `href` become links. */
-declare function TableWidget({ data, controls, }: {
+declare function TableWidget({ data, controls, initialSort, }: {
     readonly data: TableWidgetData;
     /** Search box and sortable headers; see `WidgetDefinition.tableControls`. */
     readonly controls?: ResolvedTableControls | undefined;
+    /** The header sort to start with, for example from a `sort` option. */
+    readonly initialSort?: DetailSort | undefined;
 }): ReactNode;
 /**
  * BAR_LIST: labelled horizontal bars. One series, so one color (slot 1)
@@ -362,12 +403,69 @@ declare function AlertListWidget({ data, }: {
     readonly data: AlertListWidgetData;
 }): ReactNode;
 /** Renders any payload with the renderer for its kind. */
-declare function WidgetContent({ data, tableControls, }: {
+declare function WidgetContent({ data, tableControls, initialSort, }: {
     readonly data: WidgetData;
     /** Search and sort for TABLE data; see `resolveTableControls`. */
     readonly tableControls?: ResolvedTableControls | undefined;
+    /** TABLE header sort to start with; see `sortFromOptions`. */
+    readonly initialSort?: DetailSort | undefined;
 }): ReactNode;
 
+type StoredLayoutStatus = 'loading' | 'ready' | 'saving' | 'error' | 'conflict';
+interface UseStoredLayoutOptions {
+    /** From `createLayoutPersistence`. Keep it referentially stable. */
+    readonly persistence: LayoutPersistence;
+    /** Which dashboard and viewer. Changing its key loads the other layout. */
+    readonly scope: StoreScope;
+    /** Keep stable (module constant or `useMemo`). */
+    readonly definitions: readonly PageItem[];
+    /** The organization default: shown until loaded and when nothing is stored. */
+    readonly defaultLayout: DashboardLayout;
+    /** Wait this long after the last change before saving. Default 500 ms. */
+    readonly saveDelayMs?: number;
+    /** From the server render, to avoid a flash; used instead of `defaultLayout` first. */
+    readonly initialLayout?: DashboardLayout;
+    readonly normalizeOptions?: NormalizeOptions;
+}
+interface StoredLayoutConflict {
+    /** The layout this viewer was saving. */
+    readonly mine: DashboardLayout;
+    /** The layout stored by someone else. */
+    readonly theirs: DashboardLayout;
+}
+interface UseStoredLayoutResult {
+    /** Pass to `Dashboard` as `layout`. */
+    readonly layout: DashboardLayout;
+    /** Pass to `Dashboard` as `onLayoutChange`. Saves after `saveDelayMs`. */
+    readonly setLayout: (layout: DashboardLayout) => void;
+    /** The pre-edit snapshot, or null. */
+    readonly backup: DashboardLayout | null;
+    /** Stores a snapshot at once (not debounced). Pass null to clear it in memory only. */
+    readonly setBackup: (layout: DashboardLayout | null) => void;
+    readonly status: StoredLayoutStatus;
+    /** The latest failure, specific enough to log or show; null when none. */
+    readonly error: string | null;
+    /** Set while `status` is `'conflict'`. */
+    readonly conflict: StoredLayoutConflict | null;
+    /** Settle a conflict: keep this viewer's layout (overwrite) or take the stored one. */
+    readonly resolveConflict: (choice: 'mine' | 'theirs') => void;
+    /**
+     * A change made in another tab or device while this one had unsaved edits.
+     * Without unsaved edits it is applied automatically and this stays null.
+     */
+    readonly remoteLayout: DashboardLayout | null;
+    /** Use or ignore `remoteLayout`. */
+    readonly resolveRemote: (choice: 'use' | 'ignore') => void;
+}
+/**
+ * Joins a `LayoutPersistence` to `Dashboard`. The dashboard never waits on
+ * storage: it shows `initialLayout` or `defaultLayout` while loading, and a
+ * failed load or save keeps the in-memory layout working and reports `error`.
+ * Saves are debounced and flushed when the page is hidden. Effects don't run
+ * on the server, so a server render shows the initial or default layout.
+ */
+declare function useStoredLayout(options: UseStoredLayoutOptions): UseStoredLayoutResult;
+
 interface UseWidgetsOptions extends ResolveOptions {
     /**
      * When each widget's provider starts. `'mount'` (default): right after the
@@ -383,12 +481,21 @@ interface UseWidgetsOptions extends ResolveOptions {
      * tab is hidden, and a widget still loading is not restarted.
      */
     readonly refreshMs?: number;
+    /**
+     * The viewer's chosen option values by widget key (see
+     * `WidgetDefinition.options`). Changing them reloads only the widgets whose
+     * resolved values changed; it never recreates the loader, so it may be a
+     * fresh object each render.
+     */
+    readonly optionValues?: Readonly<Record<string, Readonly<Record<string, unknown>> | undefined>>;
 }
 interface UseWidgetsResult {
     /** Pass to `Dashboard` or `WidgetGrid`: placeholders first, then results. */
     readonly widgets: readonly DashboardWidget[];
     /** Reload one widget (for example from the error card's Retry) or all. */
     readonly refresh: (key?: string) => void;
+    /** Choose option values for one widget; same effect as `optionValues`. */
+    readonly setOptions: (key: string, chosen: Readonly<Record<string, unknown>>) => void;
     /**
      * For `loadWhen: 'visible'`: attach to any element that contains the cards,
      * for example a wrapper `<div ref={gridRef}>` around `Dashboard`.
@@ -407,4 +514,4 @@ interface UseWidgetsResult {
  */
 declare function useWidgets<C extends WidgetContext>(definitions: readonly WidgetDefinition[], providers: WidgetProviders<C>, context: C, options?: UseWidgetsOptions): UseWidgetsResult;
 
-export { AlertListWidget, BarListWidget, DEFAULT_LABELS, DEFAULT_SERIES_COLORS, Dashboard, type DashboardClassNames, type DashboardClassSlot, type DashboardLabels, type DashboardProps, type DetailLoadState, type DetailLoader, GaugeWidget, GraphWidget, KpiWidget, ResolvedWidgetCard, type ResolvedWidgetCardProps, TableWidget, TextWidget, Thumbnail, type UseWidgetsOptions, type UseWidgetsResult, WidgetCard, type WidgetCardProps, WidgetContent, WidgetDetail, WidgetDetailDialog, type WidgetDetailDialogProps, type WidgetDetailProps, WidgetGrid, type WidgetGridProps, WidgetLink, type WidgetSettings, WidgetSettingsProvider, barPath, buildChartModel, describeChart, joinClassNames, seriesColor, useDetailData, useWidgetSettings, useWidgets, widgetTitle };
+export { AlertListWidget, BarListWidget, DEFAULT_LABELS, DEFAULT_SERIES_COLORS, Dashboard, type DashboardClassNames, type DashboardClassSlot, type DashboardLabels, type DashboardProps, type DetailLoadState, type DetailLoader, GaugeWidget, GraphWidget, KpiWidget, ResolvedWidgetCard, type ResolvedWidgetCardProps, type StoredLayoutConflict, type StoredLayoutStatus, TableWidget, TextWidget, Thumbnail, type UseStoredLayoutOptions, type UseStoredLayoutResult, type UseWidgetsOptions, type UseWidgetsResult, WidgetCard, type WidgetCardProps, WidgetContent, WidgetDetail, WidgetDetailDialog, type WidgetDetailDialogProps, type WidgetDetailProps, WidgetGrid, type WidgetGridProps, WidgetLink, type WidgetSettings, WidgetSettingsProvider, barPath, buildChartModel, describeChart, joinClassNames, seriesColor, useDetailData, useStoredLayout, useWidgetSettings, useWidgets, widgetTitle };

package/dist/react.d.ts

@@ -1,5 +1,5 @@
 import { ReactNode, RefObject } from 'react';
-import { D as DashboardWidget, W as WidgetSize, a as WidgetFill, G as GraphWidgetData, N as NiceDomain, b as WidgetDefinition, c as DetailProviderOptions, d as DetailData, e as DetailQuery, L as Locale, f as DashboardLayout, A as AlertListWidgetData, B as BarListWidgetData, g as GaugeWidgetData, K as KpiWidgetData, T as TableWidgetData, R as ResolvedTableControls, h as TextWidgetData, i as WidgetData, j as ResolveOptions, k as WidgetContext, l as WidgetProviders } from './scale-CrXxawQn.js';
+import { D as DashboardWidget, W as WidgetSize, a as WidgetFill, G as GraphWidgetData, N as NiceDomain, b as WidgetDefinition, c as DetailProviderOptions, d as DetailData, e as DetailQuery, O as OptionValues, L as Locale, f as DashboardLayout, A as AlertListWidgetData, B as BarListWidgetData, g as GaugeWidgetData, K as KpiWidgetData, T as TableWidgetData, R as ResolvedTableControls, h as DetailSort, i as TextWidgetData, j as WidgetData, k as LayoutPersistence, S as StoreScope, P as PageItem, l as NormalizeOptions, m as ResolveOptions, n as WidgetContext, o as WidgetProviders } from './storage-VaaysVnZ.js';
 
 interface WidgetCardProps {
     readonly title: string;
@@ -145,14 +145,16 @@ interface DetailLoadState {
  * `undefined`, `fallback` (for example the card's own complete data) is used
  * instead. `reload` runs it again. Keep `load` and `fallback` referentially
  * stable (`useCallback` / `useMemo`): a new value restarts the load.
+ * `optionValues` (the widget's resolved options) go to the loader as
+ * `options.options`.
  */
-declare function useDetailData(definition: WidgetDefinition, load: DetailLoader | undefined, enabled: boolean, fallback?: DetailData): {
+declare function useDetailData(definition: WidgetDefinition, load: DetailLoader | undefined, enabled: boolean, fallback?: DetailData, optionValues?: OptionValues): {
     readonly state: DetailLoadState;
     readonly reload: () => void;
 };
 
 /** Every element that carries a stable `dwt-*` class, for `classNames`. */
-type DashboardClassSlot = 'dashboard' | 'hiddenBar' | 'toolbar' | 'grid' | 'card' | 'cardHeader' | 'cardTitle' | 'cardDescription' | 'cardActions' | 'cardBody' | 'cardFooter' | 'button' | 'status' | 'empty' | 'error' | 'text' | 'kpi' | 'gauge' | 'table' | 'barList' | 'alertList' | 'chart' | 'legend' | 'tooltip' | 'tableTwin' | 'detail';
+type DashboardClassSlot = 'dashboard' | 'hiddenBar' | 'toolbar' | 'pageBar' | 'grid' | 'card' | 'cardHeader' | 'cardTitle' | 'cardDescription' | 'cardActions' | 'cardBody' | 'cardFooter' | 'button' | 'status' | 'empty' | 'error' | 'text' | 'kpi' | 'gauge' | 'table' | 'barList' | 'alertList' | 'chart' | 'legend' | 'tooltip' | 'tableTwin' | 'detail';
 /**
  * Extra classes per slot, appended to the `dwt-*` class (never replacing
  * it), e.g. `{ card: 'rounded-lg shadow-sm' }` for Tailwind.
@@ -190,6 +192,30 @@ interface DashboardLabels {
     readonly locked: (title: string) => string;
     /** The lock icon on a card shown to an administrator (`overrideLocks`). */
     readonly lockedForViewers: (title: string) => string;
+    /** Pages: names the tab list, and each tab ("Page 2 of 3: Sales"). */
+    readonly pageBar: string;
+    readonly pageTabName: (index: number, count: number, title: string) => string;
+    readonly previousPageButton: string;
+    readonly nextPageButton: string;
+    /** Page management while editing. */
+    readonly managePages: string;
+    readonly addPage: string;
+    readonly renamePage: (title: string) => string;
+    readonly pageTitle: string;
+    readonly savePageTitle: string;
+    readonly cancelPageTitle: string;
+    readonly deletePage: (title: string) => string;
+    readonly confirmDeletePage: (title: string) => string;
+    readonly movePageLeft: (title: string) => string;
+    readonly movePageRight: (title: string) => string;
+    /** The select on each card that moves it to another page. */
+    readonly moveToPage: (title: string) => string;
+    readonly moveToPagePlaceholder: string;
+    readonly moveToPageOption: (title: string, rowsFree: number) => string;
+    readonly newPageOption: string;
+    readonly movedToPage: (title: string, pageTitle: string) => string;
+    readonly pageFull: (pageTitle: string, maxRows: number) => string;
+    readonly emptyPage: string;
     /** Added to the accessible name of links that open in a new tab. */
     readonly opensInNewTab: string;
     /** The card's View button, opening the detail view. */
@@ -277,6 +303,19 @@ interface DashboardProps extends WidgetSettings {
     readonly defaultLayout?: DashboardLayout;
     /** Show the built-in Customize/Done/Reset toolbar (toggle mode). Default true. */
     readonly toolbar?: boolean;
+    /**
+     * The page in view (a page key) when the layout has pages. Controlled with
+     * `onActivePageChange`; without it the dashboard keeps its own, starting on
+     * `defaultActivePage` or the first page. Pages never listed fall back to
+     * the first.
+     */
+    readonly activePage?: string;
+    readonly defaultActivePage?: string;
+    readonly onActivePageChange?: (pageKey: string) => void;
+    /** Rows a page holds unless the page says otherwise. Default 4. */
+    readonly maxRows?: number;
+    /** Most pages the viewer can add while editing. Default: no limit. */
+    readonly maxPages?: number;
     readonly onRetry?: (key: string) => void;
     /**
      * Loads the full data for a widget's detail view (widgets whose definition
@@ -345,10 +384,12 @@ declare function GaugeWidget({ data, }: {
     readonly data: GaugeWidgetData;
 }): ReactNode;
 /** TABLE: a data table; cells with a safe `href` become links. */
-declare function TableWidget({ data, controls, }: {
+declare function TableWidget({ data, controls, initialSort, }: {
     readonly data: TableWidgetData;
     /** Search box and sortable headers; see `WidgetDefinition.tableControls`. */
     readonly controls?: ResolvedTableControls | undefined;
+    /** The header sort to start with, for example from a `sort` option. */
+    readonly initialSort?: DetailSort | undefined;
 }): ReactNode;
 /**
  * BAR_LIST: labelled horizontal bars. One series, so one color (slot 1)
@@ -362,12 +403,69 @@ declare function AlertListWidget({ data, }: {
     readonly data: AlertListWidgetData;
 }): ReactNode;
 /** Renders any payload with the renderer for its kind. */
-declare function WidgetContent({ data, tableControls, }: {
+declare function WidgetContent({ data, tableControls, initialSort, }: {
     readonly data: WidgetData;
     /** Search and sort for TABLE data; see `resolveTableControls`. */
     readonly tableControls?: ResolvedTableControls | undefined;
+    /** TABLE header sort to start with; see `sortFromOptions`. */
+    readonly initialSort?: DetailSort | undefined;
 }): ReactNode;
 
+type StoredLayoutStatus = 'loading' | 'ready' | 'saving' | 'error' | 'conflict';
+interface UseStoredLayoutOptions {
+    /** From `createLayoutPersistence`. Keep it referentially stable. */
+    readonly persistence: LayoutPersistence;
+    /** Which dashboard and viewer. Changing its key loads the other layout. */
+    readonly scope: StoreScope;
+    /** Keep stable (module constant or `useMemo`). */
+    readonly definitions: readonly PageItem[];
+    /** The organization default: shown until loaded and when nothing is stored. */
+    readonly defaultLayout: DashboardLayout;
+    /** Wait this long after the last change before saving. Default 500 ms. */
+    readonly saveDelayMs?: number;
+    /** From the server render, to avoid a flash; used instead of `defaultLayout` first. */
+    readonly initialLayout?: DashboardLayout;
+    readonly normalizeOptions?: NormalizeOptions;
+}
+interface StoredLayoutConflict {
+    /** The layout this viewer was saving. */
+    readonly mine: DashboardLayout;
+    /** The layout stored by someone else. */
+    readonly theirs: DashboardLayout;
+}
+interface UseStoredLayoutResult {
+    /** Pass to `Dashboard` as `layout`. */
+    readonly layout: DashboardLayout;
+    /** Pass to `Dashboard` as `onLayoutChange`. Saves after `saveDelayMs`. */
+    readonly setLayout: (layout: DashboardLayout) => void;
+    /** The pre-edit snapshot, or null. */
+    readonly backup: DashboardLayout | null;
+    /** Stores a snapshot at once (not debounced). Pass null to clear it in memory only. */
+    readonly setBackup: (layout: DashboardLayout | null) => void;
+    readonly status: StoredLayoutStatus;
+    /** The latest failure, specific enough to log or show; null when none. */
+    readonly error: string | null;
+    /** Set while `status` is `'conflict'`. */
+    readonly conflict: StoredLayoutConflict | null;
+    /** Settle a conflict: keep this viewer's layout (overwrite) or take the stored one. */
+    readonly resolveConflict: (choice: 'mine' | 'theirs') => void;
+    /**
+     * A change made in another tab or device while this one had unsaved edits.
+     * Without unsaved edits it is applied automatically and this stays null.
+     */
+    readonly remoteLayout: DashboardLayout | null;
+    /** Use or ignore `remoteLayout`. */
+    readonly resolveRemote: (choice: 'use' | 'ignore') => void;
+}
+/**
+ * Joins a `LayoutPersistence` to `Dashboard`. The dashboard never waits on
+ * storage: it shows `initialLayout` or `defaultLayout` while loading, and a
+ * failed load or save keeps the in-memory layout working and reports `error`.
+ * Saves are debounced and flushed when the page is hidden. Effects don't run
+ * on the server, so a server render shows the initial or default layout.
+ */
+declare function useStoredLayout(options: UseStoredLayoutOptions): UseStoredLayoutResult;
+
 interface UseWidgetsOptions extends ResolveOptions {
     /**
      * When each widget's provider starts. `'mount'` (default): right after the
@@ -383,12 +481,21 @@ interface UseWidgetsOptions extends ResolveOptions {
      * tab is hidden, and a widget still loading is not restarted.
      */
     readonly refreshMs?: number;
+    /**
+     * The viewer's chosen option values by widget key (see
+     * `WidgetDefinition.options`). Changing them reloads only the widgets whose
+     * resolved values changed; it never recreates the loader, so it may be a
+     * fresh object each render.
+     */
+    readonly optionValues?: Readonly<Record<string, Readonly<Record<string, unknown>> | undefined>>;
 }
 interface UseWidgetsResult {
     /** Pass to `Dashboard` or `WidgetGrid`: placeholders first, then results. */
     readonly widgets: readonly DashboardWidget[];
     /** Reload one widget (for example from the error card's Retry) or all. */
     readonly refresh: (key?: string) => void;
+    /** Choose option values for one widget; same effect as `optionValues`. */
+    readonly setOptions: (key: string, chosen: Readonly<Record<string, unknown>>) => void;
     /**
      * For `loadWhen: 'visible'`: attach to any element that contains the cards,
      * for example a wrapper `<div ref={gridRef}>` around `Dashboard`.
@@ -407,4 +514,4 @@ interface UseWidgetsResult {
  */
 declare function useWidgets<C extends WidgetContext>(definitions: readonly WidgetDefinition[], providers: WidgetProviders<C>, context: C, options?: UseWidgetsOptions): UseWidgetsResult;
 
-export { AlertListWidget, BarListWidget, DEFAULT_LABELS, DEFAULT_SERIES_COLORS, Dashboard, type DashboardClassNames, type DashboardClassSlot, type DashboardLabels, type DashboardProps, type DetailLoadState, type DetailLoader, GaugeWidget, GraphWidget, KpiWidget, ResolvedWidgetCard, type ResolvedWidgetCardProps, TableWidget, TextWidget, Thumbnail, type UseWidgetsOptions, type UseWidgetsResult, WidgetCard, type WidgetCardProps, WidgetContent, WidgetDetail, WidgetDetailDialog, type WidgetDetailDialogProps, type WidgetDetailProps, WidgetGrid, type WidgetGridProps, WidgetLink, type WidgetSettings, WidgetSettingsProvider, barPath, buildChartModel, describeChart, joinClassNames, seriesColor, useDetailData, useWidgetSettings, useWidgets, widgetTitle };
+export { AlertListWidget, BarListWidget, DEFAULT_LABELS, DEFAULT_SERIES_COLORS, Dashboard, type DashboardClassNames, type DashboardClassSlot, type DashboardLabels, type DashboardProps, type DetailLoadState, type DetailLoader, GaugeWidget, GraphWidget, KpiWidget, ResolvedWidgetCard, type ResolvedWidgetCardProps, type StoredLayoutConflict, type StoredLayoutStatus, TableWidget, TextWidget, Thumbnail, type UseStoredLayoutOptions, type UseStoredLayoutResult, type UseWidgetsOptions, type UseWidgetsResult, WidgetCard, type WidgetCardProps, WidgetContent, WidgetDetail, WidgetDetailDialog, type WidgetDetailDialogProps, type WidgetDetailProps, WidgetGrid, type WidgetGridProps, WidgetLink, type WidgetSettings, WidgetSettingsProvider, barPath, buildChartModel, describeChart, joinClassNames, seriesColor, useDetailData, useStoredLayout, useWidgetSettings, useWidgets, widgetTitle };