@richardmcquiston01/dashboard-widgets-toolkit 0.13.0 → 0.14.0

package/dist/{storage-DNB7gjvT.d.cts → storage-_Eb8Y98-.d.cts}

@@ -775,6 +775,14 @@ interface WidgetDefinition {
      * give widgets more room automatically.
      */
     readonly width?: number;
+    /**
+     * The narrowest and widest a viewer may make the widget (integers from 2 to
+     * 12, `minWidth <= width <= maxWidth`). A table that needs room sets
+     * `minWidth: 6`; a KPI tile that looks silly wide sets `maxWidth: 4`.
+     * Without them the full 2 to 12 range applies.
+     */
+    readonly minWidth?: number;
+    readonly maxWidth?: number;
     /**
      * Gives the widget a detail view: a full list with sorting, filtering and
      * paging. `true` uses defaults. The data comes from a detail provider.
@@ -790,8 +798,8 @@ interface WidgetDefinition {
     /** Fill free space in the row (height, width or both). Default: none. */
     readonly fill?: WidgetFill;
     /**
-     * Keeps viewers from rearranging this widget. `true` locks everything:
-     * move, hide and minimize. Use an object to lock only some; fields left out
+     * Keeps viewers from changing this widget. `true` locks everything:
+     * move, hide, minimize and options. Use an object to lock only some; fields left out
      * are not locked.
      */
     readonly locked?: boolean | WidgetLock;
@@ -816,6 +824,8 @@ interface WidgetLock {
     readonly hide?: boolean;
     /** Can't be collapsed to its header. */
     readonly minimize?: boolean;
+    /** Can't be given a title, width or option values of the viewer's own. */
+    readonly options?: boolean;
 }
 /** `WidgetLock` with every default filled in. */
 type ResolvedWidgetLock = Required<WidgetLock>;
@@ -900,6 +910,132 @@ declare function placeRows(items: readonly GridItem[]): readonly PlacedRow[];
  */
 declare function fitCount(items: readonly GridItem[], maxRows: number): number;
 
+/**
+ * A viewer's own choices for a widget: a title, a width and values for the
+ * options its author declared. They live in the layout (`layout.settings`),
+ * so the consumer's existing persistence saves them, and they override what
+ * the definition says without changing it. Pure functions, no I/O.
+ */
+
+/** What one viewer chose for one widget. Every field is optional. */
+interface WidgetViewerSettings {
+    /** Replaces the widget's title. Plain text, at most 80 characters. */
+    readonly title?: string;
+    /** Share of the row in twelfths, within the definition's min and max. */
+    readonly width?: number;
+    /** May grow into the columns left over in its row (see `fill`). */
+    readonly flexible?: boolean;
+    /** Values for declared options, by option key. */
+    readonly options?: Readonly<Record<string, OptionValue>>;
+}
+/** Viewer settings by widget key. */
+type LayoutSettings = Readonly<Record<string, WidgetViewerSettings>>;
+/** Longest title a viewer can give a widget; longer ones are cut. */
+declare const MAX_WIDGET_TITLE_LENGTH = 80;
+/**
+ * Most widgets `parseLayout` keeps settings for: a safety ceiling against
+ * malformed or hostile JSON, not a product limit.
+ */
+declare const MAX_PARSED_SETTINGS = 500;
+/** What these functions need from a definition. */
+type SettingsItem = Pick<WidgetDefinition, 'key'> & Partial<Pick<WidgetDefinition, 'title' | 'width' | 'minWidth' | 'maxWidth' | 'fill' | 'locked' | 'options'>>;
+/**
+ * Reads the `settings` field of a saved layout. Anything malformed is
+ * dropped (wrong types, titles over the limit are cut, widths outside 2 to
+ * 12), never an error. Returns undefined when nothing usable is left.
+ */
+declare function parseSettings(raw: unknown): LayoutSettings | undefined;
+/** The JSON-ready form of `layout.settings`; fields keep a stable order. */
+declare function serializeSettings(settings: LayoutSettings | undefined): Record<string, WidgetViewerSettings> | undefined;
+/** The narrowest and widest share a widget may take. */
+declare function widthRange(item: Pick<SettingsItem, 'minWidth' | 'maxWidth'>): {
+    readonly min: number;
+    readonly max: number;
+};
+/** A width as a share of the row: 2 is `1/6`, 6 is `1/2`, 12 is `Full`. */
+declare function widthShareLabel(width: number): string;
+/** Whether the lock on this widget forbids viewer settings. */
+declare function isOptionsLocked(item: Pick<SettingsItem, 'locked'>): boolean;
+/** Whether the widget grows into free columns: the viewer's choice, else its `fill`. */
+declare function isFlexible(item: Pick<SettingsItem, 'fill'>, settings: WidgetViewerSettings | undefined): boolean;
+/**
+ * The definition as this viewer sees it: their title, their width (kept
+ * within the definition's limits) and their choice of Flexible applied on
+ * top of the author's. Returns the same object when there is nothing to
+ * apply. Options are not part of the definition; read them with
+ * `widgetOptionValues`.
+ */
+declare function applySettings<D extends SettingsItem>(definition: D, settings: WidgetViewerSettings | undefined): D;
+/**
+ * The definitions with each viewer's settings applied. A widget whose lock
+ * forbids options (`locked.options`) ignores them, so a saved layout can't
+ * reach around a lock. Pass `overrideLocks` for an administrator.
+ */
+declare function effectiveDefinitions<D extends SettingsItem>(definitions: readonly D[], layout: {
+    readonly settings?: LayoutSettings;
+}, options?: {
+    readonly overrideLocks?: boolean;
+}): D[];
+/**
+ * The chosen option values for a widget, resolved: the viewer's where valid,
+ * else the author's defaults. Empty when it declares no options.
+ */
+declare function widgetOptionValues(definition: Pick<SettingsItem, 'options'>, settings: WidgetViewerSettings | undefined): OptionValues;
+/**
+ * What to pass `useWidgets({ optionValues })` so the data follows the
+ * layout: for every widget that declares options, the viewer's chosen
+ * values (empty when they haven't chosen, which means the defaults). Every
+ * such widget is listed so Reset sends its defaults back to the provider.
+ */
+declare function optionValuesFromLayout(definitions: readonly Pick<SettingsItem, 'key' | 'options' | 'locked'>[], layout: {
+    readonly settings?: LayoutSettings;
+}, options?: {
+    readonly overrideLocks?: boolean;
+}): Record<string, Readonly<Record<string, OptionValue>>>;
+/** Fields `setWidgetSettings` can change; `undefined` clears one. */
+interface WidgetSettingsPatch {
+    readonly title?: string | undefined;
+    readonly width?: number | undefined;
+    readonly flexible?: boolean | undefined;
+    /** Replaces all of the widget's option values (`undefined` clears them). */
+    readonly options?: Readonly<Record<string, OptionValue>> | undefined;
+}
+type LayoutWithSettings<L> = L & {
+    readonly settings?: LayoutSettings;
+};
+/**
+ * A layout with `patch` applied to one widget's settings. Fields the patch
+ * names as `undefined` are cleared; others stay. An entry left empty is
+ * removed. Returns the same layout when nothing changes.
+ */
+declare function setWidgetSettings<L extends object>(layout: LayoutWithSettings<L>, key: string, patch: WidgetSettingsPatch): LayoutWithSettings<L>;
+/** A layout without one widget's settings (Reset to defaults). */
+declare function clearWidgetSettings<L extends object>(layout: LayoutWithSettings<L>, key: string): LayoutWithSettings<L>;
+/** Lower-cased, trimmed and Unicode-normalized, for comparing titles. */
+declare function normalizeTitle(title: string): string;
+/**
+ * Whether another widget already shows `title`: compared trimmed,
+ * case-insensitive and Unicode-normalized, against the other widgets'
+ * effective titles. A dialog uses it to refuse a duplicate.
+ */
+declare function isTitleInUse<D extends SettingsItem>(definitions: readonly D[], layout: {
+    readonly settings?: LayoutSettings;
+}, key: string, title: string): boolean;
+/** Options for `normalizeSettings`. */
+interface NormalizeSettingsOptions {
+    /** Keep settings that a widget's `locked.options` forbids. */
+    readonly overrideLocks?: boolean;
+}
+/**
+ * Cleans a layout's settings against the definitions, for a save endpoint:
+ * drops settings of unknown widgets and of widgets locked against options,
+ * clamps widths to `minWidth` and `maxWidth`, trims titles, drops option
+ * values the definition didn't declare or that aren't valid for their
+ * option, and makes titles unique by appending "(#n)". Idempotent; returns
+ * the same layout when nothing changes.
+ */
+declare function normalizeSettings<D extends SettingsItem, L extends object>(definitions: readonly D[], layout: LayoutWithSettings<L>, options?: NormalizeSettingsOptions): LayoutWithSettings<L>;
+
 /**
  * A viewer's dashboard customization: order, hidden and minimized widgets.
  * Pure functions over a small JSON-serialisable object. Persist it however
@@ -931,6 +1067,11 @@ interface DashboardLayout {
      * empty. See `pages.ts`.
      */
     readonly pages?: readonly LayoutPage[];
+    /**
+     * What the viewer chose for each widget (title, width, option values), by
+     * widget key. See `settings.ts`. Absent when they chose nothing.
+     */
+    readonly settings?: LayoutSettings;
 }
 /** One page of a paged layout: the same lists as a layout, plus a name. */
 interface LayoutPage {
@@ -1330,4 +1471,4 @@ interface LayoutPersistence {
  */
 declare function createLayoutPersistence(adapter: StorageAdapter, options?: LayoutPersistenceOptions): LayoutPersistence;
 
-export { type DetailCell as $, type AlertListWidgetData as A, type BarListWidgetData as B, type CachedPayload as C, type DashboardWidget as D, DATE_RANGE_PRESETS as E, DEFAULT_COMPARISON_LABEL as F, type GraphWidgetData as G, DEFAULT_CURRENCY as H, DEFAULT_DETAIL_PAGE_SIZE as I, DEFAULT_EMPTY_TEXT as J, type KpiWidgetData as K, type Locale as L, DEFAULT_MAX_LAYOUT_BYTES as M, type NiceDomain as N, type OptionValues as O, type PageItem as P, DEFAULT_PAGE_KEY as Q, type ResolvedTableControls as R, type StoreScope as S, type TableWidgetData as T, DEFAULT_PAGE_ROWS as U, DETAIL_MODES as V, type WidgetSize as W, type DateRangeOption as X, type DateRangePreset as Y, type DeltaDirection as Z, type DeltaSentiment as _, type WidgetFill as a, WIDGET_SIZES as a$, type DetailColumn as a0, type DetailMode as a1, type DetailPage as a2, type DetailProvider as a3, type DetailProviders as a4, EMPTY_LAYOUT as a5, type EmptyWidget as a6, type EncodingOptions as a7, type EnforceLocksOptions as a8, type Err as a9, type OptionContext as aA, type OptionValue as aB, type PageOptions as aC, type PageRoom as aD, type PlacedRow as aE, type ProviderOptions as aF, type ResolvedDetailOptions as aG, type ResolvedWidget as aH, type ResolvedWidgetLock as aI, type RetryOptions as aJ, type SaveOptions as aK, type SavedLayout as aL, type SortDirection as aM, type SortOption as aN, type StorageAdapter as aO, type StorageLogEvent as aP, type StoreErrorCode as aQ, type StoreResult as aR, type StoredValue as aS, type TableCell as aT, type TableColumn as aU, type TextOption as aV, VALUE_FORMATS as aW, type ValueFormat as aX, WIDGET_FILLS as aY, WIDGET_KINDS as aZ, WIDGET_OPTION_TYPES as a_, type ErrorWidget as aa, type FormatOptions as ab, type GraphPoint as ac, type GraphSeries as ad, type GridItem as ae, type KpiDelta as af, type KpiDeltaOptions as ag, LAYOUT_ENVELOPE_VERSION as ah, type LayoutItem as ai, type LayoutPage as aj, type LayoutPersistenceOptions as ak, type LoadedLayout as al, type LoadingWidget as am, MAX_DETAIL_PAGE_SIZE as an, MAX_GRAPH_SERIES as ao, MAX_PAGE_ROWS as ap, MAX_PAGE_TITLE_LENGTH as aq, MAX_PARSED_PAGES as ar, MAX_TEXT_OPTION_LENGTH as as, MAX_WIDGET_OPTIONS as at, MAX_WIDGET_WIDTH as au, MIN_WIDGET_WIDTH as av, type NumberOption as aw, OPTION_KEY_PATTERN as ax, type Ok as ay, type OkWidget as az, type WidgetDefinition as b, normalizeLayout as b$, WIDTH_COLUMNS as b0, type WidgetCache as b1, type WidgetDataOf as b2, type WidgetDetailOptions as b3, type WidgetEmptyState as b4, type WidgetLock as b5, type WidgetOption as b6, type WidgetProvider as b7, type WidgetStatus as b8, type WidgetTableControls as b9, hasPages as bA, hiddenWidgets as bB, hideWidget as bC, isClientApplied as bD, isColumnKeyFor as bE, isHidden as bF, isIsoInterval as bG, isMinimized as bH, isWidgetEmptyState as bI, isWidgetKind as bJ, isWidgetVisibleTo as bK, isWidgetWidth as bL, itemWidth as bM, kpiDelta as bN, labelStride as bO, loadingWidgets as bP, memoryAdapter as bQ, minimizeWidget as bR, movePage as bS, moveWidget as bT, moveWidgetBy as bU, moveWidgetDown as bV, moveWidgetToPage as bW, moveWidgetUp as bX, nextPageKey as bY, niceDomain as bZ, niceStep as b_, addPage as ba, applyClientOptions as bb, assignPages as bc, baseColumnSpan as bd, cacheKeyFor as be, coerceOptionValue as bf, createLayoutPersistence as bg, defaultDetailQuery as bh, defaultOptionValue as bi, defineWidget as bj, deriveDetailData as bk, describeUnknownError as bl, emptyTextFor as bm, emptyWidget as bn, enforceLocks as bo, err as bp, failedWidget as bq, fillColumnSpans as br, fillWidthSpans as bs, fillsHeight as bt, fillsWidth as bu, finalizeWidget as bv, fitCount as bw, formatCount as bx, formatPercentChange as by, formatValue as bz, type DetailProviderOptions as c, ok as c0, optionValuesFor as c1, optionsCacheSuffix as c2, pageLayout as c3, pageList as c4, pageOf as c5, pageRoom as c6, pageWidgets as c7, parseDetailQuery as c8, parseLayout as c9, tableDetailData as cA, toggleHidden as cB, toggleMinimized as cC, usesWidthColumns as cD, utf8Length as cE, validateDetailData as cF, visibleWidgets as cG, widgetsFor as cH, widthForSize as cI, withEncoding as cJ, withFallback as cK, withLogging as cL, withPageLayout as cM, withPrefix as cN, withReadCache as cO, withRetry as cP, parseSortValue as ca, percentChange as cb, placeRows as cc, pruneLayout as cd, queryRows as ce, readOnly as cf, removePage as cg, renamePage as ch, resolveDateRange as ci, resolveDetailOptions as cj, resolveOptionValues as ck, resolvePageKey as cl, resolvePayload as cm, resolveTableControls as cn, resolveWidget as co, resolveWidgetLock as cp, resolveWidgetUnapplied as cq, resolveWidgets as cr, restoreWidget as cs, sameOptionValues as ct, serializeDetailQuery as cu, serializeLayout as cv, shareOf as cw, showWidget as cx, sortDefinitions as cy, sortFromOptions as cz, type DetailData as d, type DetailQuery as e, type DashboardLayout as f, type GaugeWidgetData as g, type DetailSort as h, type TextWidgetData as i, type WidgetData as j, type LayoutPersistence as k, type NormalizeOptions as l, type ResolveOptions as m, type WidgetContext as n, type WidgetProviders as o, type Result as p, type WidgetKind as q, type WidgetPayload as r, type AddPageOptions as s, type AlertListItem as t, type BarListItem as u, type BooleanOption as v, type ChoiceOption as w, type ColorOption as x, type ColumnsOption as y, type ConflictPolicy as z };
+export { type DeltaDirection as $, type AlertListWidgetData as A, type BarListWidgetData as B, type CachedPayload as C, type DashboardWidget as D, type ColumnsOption as E, type ConflictPolicy as F, type GraphWidgetData as G, DATE_RANGE_PRESETS as H, DEFAULT_COMPARISON_LABEL as I, DEFAULT_CURRENCY as J, type KpiWidgetData as K, type Locale as L, DEFAULT_DETAIL_PAGE_SIZE as M, type NiceDomain as N, type OptionValues as O, type PageItem as P, DEFAULT_EMPTY_TEXT as Q, type ResolvedTableControls as R, type StoreScope as S, type TableWidgetData as T, DEFAULT_MAX_LAYOUT_BYTES as U, DEFAULT_PAGE_KEY as V, type WidgetSize as W, DEFAULT_PAGE_ROWS as X, DETAIL_MODES as Y, type DateRangeOption as Z, type DateRangePreset as _, type WidgetFill as a, type TableColumn as a$, type DeltaSentiment as a0, type DetailCell as a1, type DetailColumn as a2, type DetailMode as a3, type DetailPage as a4, type DetailProvider as a5, type DetailProviders as a6, EMPTY_LAYOUT as a7, type EmptyWidget as a8, type EncodingOptions as a9, MIN_WIDGET_WIDTH as aA, type NormalizeSettingsOptions as aB, type NumberOption as aC, OPTION_KEY_PATTERN as aD, type Ok as aE, type OkWidget as aF, type OptionContext as aG, type OptionValue as aH, type PageOptions as aI, type PageRoom as aJ, type PlacedRow as aK, type ProviderOptions as aL, type ResolvedDetailOptions as aM, type ResolvedWidget as aN, type ResolvedWidgetLock as aO, type RetryOptions as aP, type SaveOptions as aQ, type SavedLayout as aR, type SettingsItem as aS, type SortDirection as aT, type SortOption as aU, type StorageAdapter as aV, type StorageLogEvent as aW, type StoreErrorCode as aX, type StoreResult as aY, type StoredValue as aZ, type TableCell as a_, type EnforceLocksOptions as aa, type Err as ab, type ErrorWidget as ac, type FormatOptions as ad, type GraphPoint as ae, type GraphSeries as af, type GridItem as ag, type KpiDelta as ah, type KpiDeltaOptions as ai, LAYOUT_ENVELOPE_VERSION as aj, type LayoutItem as ak, type LayoutPage as al, type LayoutPersistenceOptions as am, type LayoutSettings as an, type LoadedLayout as ao, type LoadingWidget as ap, MAX_DETAIL_PAGE_SIZE as aq, MAX_GRAPH_SERIES as ar, MAX_PAGE_ROWS as as, MAX_PAGE_TITLE_LENGTH as at, MAX_PARSED_PAGES as au, MAX_PARSED_SETTINGS as av, MAX_TEXT_OPTION_LENGTH as aw, MAX_WIDGET_OPTIONS as ax, MAX_WIDGET_TITLE_LENGTH as ay, MAX_WIDGET_WIDTH as az, type WidgetDefinition as b, labelStride as b$, type TextOption as b0, VALUE_FORMATS as b1, type ValueFormat as b2, WIDGET_FILLS as b3, WIDGET_KINDS as b4, WIDGET_OPTION_TYPES as b5, WIDGET_SIZES as b6, WIDTH_COLUMNS as b7, type WidgetCache as b8, type WidgetDataOf as b9, failedWidget as bA, fillColumnSpans as bB, fillWidthSpans as bC, fillsHeight as bD, fillsWidth as bE, finalizeWidget as bF, fitCount as bG, formatCount as bH, formatPercentChange as bI, formatValue as bJ, hasPages as bK, hiddenWidgets as bL, hideWidget as bM, isClientApplied as bN, isColumnKeyFor as bO, isFlexible as bP, isHidden as bQ, isIsoInterval as bR, isMinimized as bS, isOptionsLocked as bT, isTitleInUse as bU, isWidgetEmptyState as bV, isWidgetKind as bW, isWidgetVisibleTo as bX, isWidgetWidth as bY, itemWidth as bZ, kpiDelta as b_, type WidgetDetailOptions as ba, type WidgetEmptyState as bb, type WidgetLock as bc, type WidgetOption as bd, type WidgetProvider as be, type WidgetStatus as bf, type WidgetTableControls as bg, addPage as bh, applyClientOptions as bi, applySettings as bj, assignPages as bk, baseColumnSpan as bl, cacheKeyFor as bm, clearWidgetSettings as bn, coerceOptionValue as bo, createLayoutPersistence as bp, defaultDetailQuery as bq, defaultOptionValue as br, defineWidget as bs, deriveDetailData as bt, describeUnknownError as bu, effectiveDefinitions as bv, emptyTextFor as bw, emptyWidget as bx, enforceLocks as by, err as bz, type DetailProviderOptions as c, widgetsFor as c$, loadingWidgets as c0, memoryAdapter as c1, minimizeWidget as c2, movePage as c3, moveWidget as c4, moveWidgetBy as c5, moveWidgetDown as c6, moveWidgetToPage as c7, moveWidgetUp as c8, nextPageKey as c9, resolveDetailOptions as cA, resolveOptionValues as cB, resolvePageKey as cC, resolvePayload as cD, resolveTableControls as cE, resolveWidget as cF, resolveWidgetLock as cG, resolveWidgetUnapplied as cH, resolveWidgets as cI, restoreWidget as cJ, sameOptionValues as cK, serializeDetailQuery as cL, serializeLayout as cM, serializeSettings as cN, setWidgetSettings as cO, shareOf as cP, showWidget as cQ, sortDefinitions as cR, sortFromOptions as cS, tableDetailData as cT, toggleHidden as cU, toggleMinimized as cV, usesWidthColumns as cW, utf8Length as cX, validateDetailData as cY, visibleWidgets as cZ, widgetOptionValues as c_, niceDomain as ca, niceStep as cb, normalizeLayout as cc, normalizeSettings as cd, normalizeTitle as ce, ok as cf, optionValuesFor as cg, optionValuesFromLayout as ch, optionsCacheSuffix as ci, pageLayout as cj, pageList as ck, pageOf as cl, pageRoom as cm, pageWidgets as cn, parseDetailQuery as co, parseLayout as cp, parseSettings as cq, parseSortValue as cr, percentChange as cs, placeRows as ct, pruneLayout as cu, queryRows as cv, readOnly as cw, removePage as cx, renamePage as cy, resolveDateRange as cz, type DetailData as d, widthForSize as d0, widthRange as d1, widthShareLabel as d2, withEncoding as d3, withFallback as d4, withLogging as d5, withPageLayout as d6, withPrefix as d7, withReadCache as d8, withRetry as d9, type DetailQuery as e, type DashboardLayout as f, type WidgetViewerSettings as g, type WidgetSettingsPatch as h, type GaugeWidgetData as i, type DetailSort as j, type TextWidgetData as k, type WidgetData as l, type LayoutPersistence as m, type NormalizeOptions as n, type ResolveOptions as o, type WidgetContext as p, type WidgetProviders as q, type Result as r, type WidgetKind as s, type WidgetPayload as t, type AddPageOptions as u, type AlertListItem as v, type BarListItem as w, type BooleanOption as x, type ChoiceOption as y, type ColorOption as z };

package/dist/{storage-DNB7gjvT.d.ts → storage-_Eb8Y98-.d.ts}

@@ -775,6 +775,14 @@ interface WidgetDefinition {
      * give widgets more room automatically.
      */
     readonly width?: number;
+    /**
+     * The narrowest and widest a viewer may make the widget (integers from 2 to
+     * 12, `minWidth <= width <= maxWidth`). A table that needs room sets
+     * `minWidth: 6`; a KPI tile that looks silly wide sets `maxWidth: 4`.
+     * Without them the full 2 to 12 range applies.
+     */
+    readonly minWidth?: number;
+    readonly maxWidth?: number;
     /**
      * Gives the widget a detail view: a full list with sorting, filtering and
      * paging. `true` uses defaults. The data comes from a detail provider.
@@ -790,8 +798,8 @@ interface WidgetDefinition {
     /** Fill free space in the row (height, width or both). Default: none. */
     readonly fill?: WidgetFill;
     /**
-     * Keeps viewers from rearranging this widget. `true` locks everything:
-     * move, hide and minimize. Use an object to lock only some; fields left out
+     * Keeps viewers from changing this widget. `true` locks everything:
+     * move, hide, minimize and options. Use an object to lock only some; fields left out
      * are not locked.
      */
     readonly locked?: boolean | WidgetLock;
@@ -816,6 +824,8 @@ interface WidgetLock {
     readonly hide?: boolean;
     /** Can't be collapsed to its header. */
     readonly minimize?: boolean;
+    /** Can't be given a title, width or option values of the viewer's own. */
+    readonly options?: boolean;
 }
 /** `WidgetLock` with every default filled in. */
 type ResolvedWidgetLock = Required<WidgetLock>;
@@ -900,6 +910,132 @@ declare function placeRows(items: readonly GridItem[]): readonly PlacedRow[];
  */
 declare function fitCount(items: readonly GridItem[], maxRows: number): number;
 
+/**
+ * A viewer's own choices for a widget: a title, a width and values for the
+ * options its author declared. They live in the layout (`layout.settings`),
+ * so the consumer's existing persistence saves them, and they override what
+ * the definition says without changing it. Pure functions, no I/O.
+ */
+
+/** What one viewer chose for one widget. Every field is optional. */
+interface WidgetViewerSettings {
+    /** Replaces the widget's title. Plain text, at most 80 characters. */
+    readonly title?: string;
+    /** Share of the row in twelfths, within the definition's min and max. */
+    readonly width?: number;
+    /** May grow into the columns left over in its row (see `fill`). */
+    readonly flexible?: boolean;
+    /** Values for declared options, by option key. */
+    readonly options?: Readonly<Record<string, OptionValue>>;
+}
+/** Viewer settings by widget key. */
+type LayoutSettings = Readonly<Record<string, WidgetViewerSettings>>;
+/** Longest title a viewer can give a widget; longer ones are cut. */
+declare const MAX_WIDGET_TITLE_LENGTH = 80;
+/**
+ * Most widgets `parseLayout` keeps settings for: a safety ceiling against
+ * malformed or hostile JSON, not a product limit.
+ */
+declare const MAX_PARSED_SETTINGS = 500;
+/** What these functions need from a definition. */
+type SettingsItem = Pick<WidgetDefinition, 'key'> & Partial<Pick<WidgetDefinition, 'title' | 'width' | 'minWidth' | 'maxWidth' | 'fill' | 'locked' | 'options'>>;
+/**
+ * Reads the `settings` field of a saved layout. Anything malformed is
+ * dropped (wrong types, titles over the limit are cut, widths outside 2 to
+ * 12), never an error. Returns undefined when nothing usable is left.
+ */
+declare function parseSettings(raw: unknown): LayoutSettings | undefined;
+/** The JSON-ready form of `layout.settings`; fields keep a stable order. */
+declare function serializeSettings(settings: LayoutSettings | undefined): Record<string, WidgetViewerSettings> | undefined;
+/** The narrowest and widest share a widget may take. */
+declare function widthRange(item: Pick<SettingsItem, 'minWidth' | 'maxWidth'>): {
+    readonly min: number;
+    readonly max: number;
+};
+/** A width as a share of the row: 2 is `1/6`, 6 is `1/2`, 12 is `Full`. */
+declare function widthShareLabel(width: number): string;
+/** Whether the lock on this widget forbids viewer settings. */
+declare function isOptionsLocked(item: Pick<SettingsItem, 'locked'>): boolean;
+/** Whether the widget grows into free columns: the viewer's choice, else its `fill`. */
+declare function isFlexible(item: Pick<SettingsItem, 'fill'>, settings: WidgetViewerSettings | undefined): boolean;
+/**
+ * The definition as this viewer sees it: their title, their width (kept
+ * within the definition's limits) and their choice of Flexible applied on
+ * top of the author's. Returns the same object when there is nothing to
+ * apply. Options are not part of the definition; read them with
+ * `widgetOptionValues`.
+ */
+declare function applySettings<D extends SettingsItem>(definition: D, settings: WidgetViewerSettings | undefined): D;
+/**
+ * The definitions with each viewer's settings applied. A widget whose lock
+ * forbids options (`locked.options`) ignores them, so a saved layout can't
+ * reach around a lock. Pass `overrideLocks` for an administrator.
+ */
+declare function effectiveDefinitions<D extends SettingsItem>(definitions: readonly D[], layout: {
+    readonly settings?: LayoutSettings;
+}, options?: {
+    readonly overrideLocks?: boolean;
+}): D[];
+/**
+ * The chosen option values for a widget, resolved: the viewer's where valid,
+ * else the author's defaults. Empty when it declares no options.
+ */
+declare function widgetOptionValues(definition: Pick<SettingsItem, 'options'>, settings: WidgetViewerSettings | undefined): OptionValues;
+/**
+ * What to pass `useWidgets({ optionValues })` so the data follows the
+ * layout: for every widget that declares options, the viewer's chosen
+ * values (empty when they haven't chosen, which means the defaults). Every
+ * such widget is listed so Reset sends its defaults back to the provider.
+ */
+declare function optionValuesFromLayout(definitions: readonly Pick<SettingsItem, 'key' | 'options' | 'locked'>[], layout: {
+    readonly settings?: LayoutSettings;
+}, options?: {
+    readonly overrideLocks?: boolean;
+}): Record<string, Readonly<Record<string, OptionValue>>>;
+/** Fields `setWidgetSettings` can change; `undefined` clears one. */
+interface WidgetSettingsPatch {
+    readonly title?: string | undefined;
+    readonly width?: number | undefined;
+    readonly flexible?: boolean | undefined;
+    /** Replaces all of the widget's option values (`undefined` clears them). */
+    readonly options?: Readonly<Record<string, OptionValue>> | undefined;
+}
+type LayoutWithSettings<L> = L & {
+    readonly settings?: LayoutSettings;
+};
+/**
+ * A layout with `patch` applied to one widget's settings. Fields the patch
+ * names as `undefined` are cleared; others stay. An entry left empty is
+ * removed. Returns the same layout when nothing changes.
+ */
+declare function setWidgetSettings<L extends object>(layout: LayoutWithSettings<L>, key: string, patch: WidgetSettingsPatch): LayoutWithSettings<L>;
+/** A layout without one widget's settings (Reset to defaults). */
+declare function clearWidgetSettings<L extends object>(layout: LayoutWithSettings<L>, key: string): LayoutWithSettings<L>;
+/** Lower-cased, trimmed and Unicode-normalized, for comparing titles. */
+declare function normalizeTitle(title: string): string;
+/**
+ * Whether another widget already shows `title`: compared trimmed,
+ * case-insensitive and Unicode-normalized, against the other widgets'
+ * effective titles. A dialog uses it to refuse a duplicate.
+ */
+declare function isTitleInUse<D extends SettingsItem>(definitions: readonly D[], layout: {
+    readonly settings?: LayoutSettings;
+}, key: string, title: string): boolean;
+/** Options for `normalizeSettings`. */
+interface NormalizeSettingsOptions {
+    /** Keep settings that a widget's `locked.options` forbids. */
+    readonly overrideLocks?: boolean;
+}
+/**
+ * Cleans a layout's settings against the definitions, for a save endpoint:
+ * drops settings of unknown widgets and of widgets locked against options,
+ * clamps widths to `minWidth` and `maxWidth`, trims titles, drops option
+ * values the definition didn't declare or that aren't valid for their
+ * option, and makes titles unique by appending "(#n)". Idempotent; returns
+ * the same layout when nothing changes.
+ */
+declare function normalizeSettings<D extends SettingsItem, L extends object>(definitions: readonly D[], layout: LayoutWithSettings<L>, options?: NormalizeSettingsOptions): LayoutWithSettings<L>;
+
 /**
  * A viewer's dashboard customization: order, hidden and minimized widgets.
  * Pure functions over a small JSON-serialisable object. Persist it however
@@ -931,6 +1067,11 @@ interface DashboardLayout {
      * empty. See `pages.ts`.
      */
     readonly pages?: readonly LayoutPage[];
+    /**
+     * What the viewer chose for each widget (title, width, option values), by
+     * widget key. See `settings.ts`. Absent when they chose nothing.
+     */
+    readonly settings?: LayoutSettings;
 }
 /** One page of a paged layout: the same lists as a layout, plus a name. */
 interface LayoutPage {
@@ -1330,4 +1471,4 @@ interface LayoutPersistence {
  */
 declare function createLayoutPersistence(adapter: StorageAdapter, options?: LayoutPersistenceOptions): LayoutPersistence;
 
-export { type DetailCell as $, type AlertListWidgetData as A, type BarListWidgetData as B, type CachedPayload as C, type DashboardWidget as D, DATE_RANGE_PRESETS as E, DEFAULT_COMPARISON_LABEL as F, type GraphWidgetData as G, DEFAULT_CURRENCY as H, DEFAULT_DETAIL_PAGE_SIZE as I, DEFAULT_EMPTY_TEXT as J, type KpiWidgetData as K, type Locale as L, DEFAULT_MAX_LAYOUT_BYTES as M, type NiceDomain as N, type OptionValues as O, type PageItem as P, DEFAULT_PAGE_KEY as Q, type ResolvedTableControls as R, type StoreScope as S, type TableWidgetData as T, DEFAULT_PAGE_ROWS as U, DETAIL_MODES as V, type WidgetSize as W, type DateRangeOption as X, type DateRangePreset as Y, type DeltaDirection as Z, type DeltaSentiment as _, type WidgetFill as a, WIDGET_SIZES as a$, type DetailColumn as a0, type DetailMode as a1, type DetailPage as a2, type DetailProvider as a3, type DetailProviders as a4, EMPTY_LAYOUT as a5, type EmptyWidget as a6, type EncodingOptions as a7, type EnforceLocksOptions as a8, type Err as a9, type OptionContext as aA, type OptionValue as aB, type PageOptions as aC, type PageRoom as aD, type PlacedRow as aE, type ProviderOptions as aF, type ResolvedDetailOptions as aG, type ResolvedWidget as aH, type ResolvedWidgetLock as aI, type RetryOptions as aJ, type SaveOptions as aK, type SavedLayout as aL, type SortDirection as aM, type SortOption as aN, type StorageAdapter as aO, type StorageLogEvent as aP, type StoreErrorCode as aQ, type StoreResult as aR, type StoredValue as aS, type TableCell as aT, type TableColumn as aU, type TextOption as aV, VALUE_FORMATS as aW, type ValueFormat as aX, WIDGET_FILLS as aY, WIDGET_KINDS as aZ, WIDGET_OPTION_TYPES as a_, type ErrorWidget as aa, type FormatOptions as ab, type GraphPoint as ac, type GraphSeries as ad, type GridItem as ae, type KpiDelta as af, type KpiDeltaOptions as ag, LAYOUT_ENVELOPE_VERSION as ah, type LayoutItem as ai, type LayoutPage as aj, type LayoutPersistenceOptions as ak, type LoadedLayout as al, type LoadingWidget as am, MAX_DETAIL_PAGE_SIZE as an, MAX_GRAPH_SERIES as ao, MAX_PAGE_ROWS as ap, MAX_PAGE_TITLE_LENGTH as aq, MAX_PARSED_PAGES as ar, MAX_TEXT_OPTION_LENGTH as as, MAX_WIDGET_OPTIONS as at, MAX_WIDGET_WIDTH as au, MIN_WIDGET_WIDTH as av, type NumberOption as aw, OPTION_KEY_PATTERN as ax, type Ok as ay, type OkWidget as az, type WidgetDefinition as b, normalizeLayout as b$, WIDTH_COLUMNS as b0, type WidgetCache as b1, type WidgetDataOf as b2, type WidgetDetailOptions as b3, type WidgetEmptyState as b4, type WidgetLock as b5, type WidgetOption as b6, type WidgetProvider as b7, type WidgetStatus as b8, type WidgetTableControls as b9, hasPages as bA, hiddenWidgets as bB, hideWidget as bC, isClientApplied as bD, isColumnKeyFor as bE, isHidden as bF, isIsoInterval as bG, isMinimized as bH, isWidgetEmptyState as bI, isWidgetKind as bJ, isWidgetVisibleTo as bK, isWidgetWidth as bL, itemWidth as bM, kpiDelta as bN, labelStride as bO, loadingWidgets as bP, memoryAdapter as bQ, minimizeWidget as bR, movePage as bS, moveWidget as bT, moveWidgetBy as bU, moveWidgetDown as bV, moveWidgetToPage as bW, moveWidgetUp as bX, nextPageKey as bY, niceDomain as bZ, niceStep as b_, addPage as ba, applyClientOptions as bb, assignPages as bc, baseColumnSpan as bd, cacheKeyFor as be, coerceOptionValue as bf, createLayoutPersistence as bg, defaultDetailQuery as bh, defaultOptionValue as bi, defineWidget as bj, deriveDetailData as bk, describeUnknownError as bl, emptyTextFor as bm, emptyWidget as bn, enforceLocks as bo, err as bp, failedWidget as bq, fillColumnSpans as br, fillWidthSpans as bs, fillsHeight as bt, fillsWidth as bu, finalizeWidget as bv, fitCount as bw, formatCount as bx, formatPercentChange as by, formatValue as bz, type DetailProviderOptions as c, ok as c0, optionValuesFor as c1, optionsCacheSuffix as c2, pageLayout as c3, pageList as c4, pageOf as c5, pageRoom as c6, pageWidgets as c7, parseDetailQuery as c8, parseLayout as c9, tableDetailData as cA, toggleHidden as cB, toggleMinimized as cC, usesWidthColumns as cD, utf8Length as cE, validateDetailData as cF, visibleWidgets as cG, widgetsFor as cH, widthForSize as cI, withEncoding as cJ, withFallback as cK, withLogging as cL, withPageLayout as cM, withPrefix as cN, withReadCache as cO, withRetry as cP, parseSortValue as ca, percentChange as cb, placeRows as cc, pruneLayout as cd, queryRows as ce, readOnly as cf, removePage as cg, renamePage as ch, resolveDateRange as ci, resolveDetailOptions as cj, resolveOptionValues as ck, resolvePageKey as cl, resolvePayload as cm, resolveTableControls as cn, resolveWidget as co, resolveWidgetLock as cp, resolveWidgetUnapplied as cq, resolveWidgets as cr, restoreWidget as cs, sameOptionValues as ct, serializeDetailQuery as cu, serializeLayout as cv, shareOf as cw, showWidget as cx, sortDefinitions as cy, sortFromOptions as cz, type DetailData as d, type DetailQuery as e, type DashboardLayout as f, type GaugeWidgetData as g, type DetailSort as h, type TextWidgetData as i, type WidgetData as j, type LayoutPersistence as k, type NormalizeOptions as l, type ResolveOptions as m, type WidgetContext as n, type WidgetProviders as o, type Result as p, type WidgetKind as q, type WidgetPayload as r, type AddPageOptions as s, type AlertListItem as t, type BarListItem as u, type BooleanOption as v, type ChoiceOption as w, type ColorOption as x, type ColumnsOption as y, type ConflictPolicy as z };
+export { type DeltaDirection as $, type AlertListWidgetData as A, type BarListWidgetData as B, type CachedPayload as C, type DashboardWidget as D, type ColumnsOption as E, type ConflictPolicy as F, type GraphWidgetData as G, DATE_RANGE_PRESETS as H, DEFAULT_COMPARISON_LABEL as I, DEFAULT_CURRENCY as J, type KpiWidgetData as K, type Locale as L, DEFAULT_DETAIL_PAGE_SIZE as M, type NiceDomain as N, type OptionValues as O, type PageItem as P, DEFAULT_EMPTY_TEXT as Q, type ResolvedTableControls as R, type StoreScope as S, type TableWidgetData as T, DEFAULT_MAX_LAYOUT_BYTES as U, DEFAULT_PAGE_KEY as V, type WidgetSize as W, DEFAULT_PAGE_ROWS as X, DETAIL_MODES as Y, type DateRangeOption as Z, type DateRangePreset as _, type WidgetFill as a, type TableColumn as a$, type DeltaSentiment as a0, type DetailCell as a1, type DetailColumn as a2, type DetailMode as a3, type DetailPage as a4, type DetailProvider as a5, type DetailProviders as a6, EMPTY_LAYOUT as a7, type EmptyWidget as a8, type EncodingOptions as a9, MIN_WIDGET_WIDTH as aA, type NormalizeSettingsOptions as aB, type NumberOption as aC, OPTION_KEY_PATTERN as aD, type Ok as aE, type OkWidget as aF, type OptionContext as aG, type OptionValue as aH, type PageOptions as aI, type PageRoom as aJ, type PlacedRow as aK, type ProviderOptions as aL, type ResolvedDetailOptions as aM, type ResolvedWidget as aN, type ResolvedWidgetLock as aO, type RetryOptions as aP, type SaveOptions as aQ, type SavedLayout as aR, type SettingsItem as aS, type SortDirection as aT, type SortOption as aU, type StorageAdapter as aV, type StorageLogEvent as aW, type StoreErrorCode as aX, type StoreResult as aY, type StoredValue as aZ, type TableCell as a_, type EnforceLocksOptions as aa, type Err as ab, type ErrorWidget as ac, type FormatOptions as ad, type GraphPoint as ae, type GraphSeries as af, type GridItem as ag, type KpiDelta as ah, type KpiDeltaOptions as ai, LAYOUT_ENVELOPE_VERSION as aj, type LayoutItem as ak, type LayoutPage as al, type LayoutPersistenceOptions as am, type LayoutSettings as an, type LoadedLayout as ao, type LoadingWidget as ap, MAX_DETAIL_PAGE_SIZE as aq, MAX_GRAPH_SERIES as ar, MAX_PAGE_ROWS as as, MAX_PAGE_TITLE_LENGTH as at, MAX_PARSED_PAGES as au, MAX_PARSED_SETTINGS as av, MAX_TEXT_OPTION_LENGTH as aw, MAX_WIDGET_OPTIONS as ax, MAX_WIDGET_TITLE_LENGTH as ay, MAX_WIDGET_WIDTH as az, type WidgetDefinition as b, labelStride as b$, type TextOption as b0, VALUE_FORMATS as b1, type ValueFormat as b2, WIDGET_FILLS as b3, WIDGET_KINDS as b4, WIDGET_OPTION_TYPES as b5, WIDGET_SIZES as b6, WIDTH_COLUMNS as b7, type WidgetCache as b8, type WidgetDataOf as b9, failedWidget as bA, fillColumnSpans as bB, fillWidthSpans as bC, fillsHeight as bD, fillsWidth as bE, finalizeWidget as bF, fitCount as bG, formatCount as bH, formatPercentChange as bI, formatValue as bJ, hasPages as bK, hiddenWidgets as bL, hideWidget as bM, isClientApplied as bN, isColumnKeyFor as bO, isFlexible as bP, isHidden as bQ, isIsoInterval as bR, isMinimized as bS, isOptionsLocked as bT, isTitleInUse as bU, isWidgetEmptyState as bV, isWidgetKind as bW, isWidgetVisibleTo as bX, isWidgetWidth as bY, itemWidth as bZ, kpiDelta as b_, type WidgetDetailOptions as ba, type WidgetEmptyState as bb, type WidgetLock as bc, type WidgetOption as bd, type WidgetProvider as be, type WidgetStatus as bf, type WidgetTableControls as bg, addPage as bh, applyClientOptions as bi, applySettings as bj, assignPages as bk, baseColumnSpan as bl, cacheKeyFor as bm, clearWidgetSettings as bn, coerceOptionValue as bo, createLayoutPersistence as bp, defaultDetailQuery as bq, defaultOptionValue as br, defineWidget as bs, deriveDetailData as bt, describeUnknownError as bu, effectiveDefinitions as bv, emptyTextFor as bw, emptyWidget as bx, enforceLocks as by, err as bz, type DetailProviderOptions as c, widgetsFor as c$, loadingWidgets as c0, memoryAdapter as c1, minimizeWidget as c2, movePage as c3, moveWidget as c4, moveWidgetBy as c5, moveWidgetDown as c6, moveWidgetToPage as c7, moveWidgetUp as c8, nextPageKey as c9, resolveDetailOptions as cA, resolveOptionValues as cB, resolvePageKey as cC, resolvePayload as cD, resolveTableControls as cE, resolveWidget as cF, resolveWidgetLock as cG, resolveWidgetUnapplied as cH, resolveWidgets as cI, restoreWidget as cJ, sameOptionValues as cK, serializeDetailQuery as cL, serializeLayout as cM, serializeSettings as cN, setWidgetSettings as cO, shareOf as cP, showWidget as cQ, sortDefinitions as cR, sortFromOptions as cS, tableDetailData as cT, toggleHidden as cU, toggleMinimized as cV, usesWidthColumns as cW, utf8Length as cX, validateDetailData as cY, visibleWidgets as cZ, widgetOptionValues as c_, niceDomain as ca, niceStep as cb, normalizeLayout as cc, normalizeSettings as cd, normalizeTitle as ce, ok as cf, optionValuesFor as cg, optionValuesFromLayout as ch, optionsCacheSuffix as ci, pageLayout as cj, pageList as ck, pageOf as cl, pageRoom as cm, pageWidgets as cn, parseDetailQuery as co, parseLayout as cp, parseSettings as cq, parseSortValue as cr, percentChange as cs, placeRows as ct, pruneLayout as cu, queryRows as cv, readOnly as cw, removePage as cx, renamePage as cy, resolveDateRange as cz, type DetailData as d, widthForSize as d0, widthRange as d1, widthShareLabel as d2, withEncoding as d3, withFallback as d4, withLogging as d5, withPageLayout as d6, withPrefix as d7, withReadCache as d8, withRetry as d9, type DetailQuery as e, type DashboardLayout as f, type WidgetViewerSettings as g, type WidgetSettingsPatch as h, type GaugeWidgetData as i, type DetailSort as j, type TextWidgetData as k, type WidgetData as l, type LayoutPersistence as m, type NormalizeOptions as n, type ResolveOptions as o, type WidgetContext as p, type WidgetProviders as q, type Result as r, type WidgetKind as s, type WidgetPayload as t, type AddPageOptions as u, type AlertListItem as v, type BarListItem as w, type BooleanOption as x, type ChoiceOption as y, type ColorOption as z };

package/dist/styles.css

@@ -935,3 +935,149 @@
     display: inline-flex;
   }
 }
+
+/* Options dialog --------------------------------------------------------- */
+
+:where(.dwt-options-dialog) {
+  margin: auto;
+  box-sizing: border-box;
+  width: min(520px, 100vw - 32px);
+  max-height: calc(100vh - 32px);
+  padding: 0;
+  overflow: auto;
+  color: var(--dwt-text);
+  background: var(--dwt-surface);
+  border: 1px solid var(--dwt-border);
+  border-radius: var(--dwt-radius, 8px);
+  font-family: var(--dwt-font);
+}
+
+:where(.dwt-options-dialog)::backdrop {
+  background: rgba(0, 0, 0, 0.5);
+}
+
+:where(.dwt-options) {
+  display: flex;
+  flex-direction: column;
+  gap: 14px;
+  padding: 20px;
+}
+
+:where(.dwt-options-heading) {
+  margin: 0;
+  font-size: 1.125rem;
+}
+
+:where(.dwt-options-field) {
+  display: flex;
+  flex-direction: column;
+  gap: 4px;
+  font-size: 0.875rem;
+}
+
+:where(.dwt-options-field label, .dwt-options-group legend) {
+  color: var(--dwt-text-secondary);
+}
+
+:where(.dwt-options-field input, .dwt-options-field select) {
+  box-sizing: border-box;
+  max-width: 100%;
+  min-height: 32px;
+  padding: 4px 8px;
+  color: var(--dwt-text);
+  background: var(--dwt-surface);
+  border: 1px solid var(--dwt-border);
+  border-radius: 6px;
+  font: inherit;
+}
+
+:where(.dwt-options-field input[type='color']) {
+  width: 56px;
+  padding: 2px;
+}
+
+:where(.dwt-options-pair) {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 8px;
+}
+
+:where(.dwt-options-check) {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  font-size: 0.875rem;
+}
+
+:where(.dwt-options-group, .dwt-options-columns) {
+  display: flex;
+  flex-direction: column;
+  gap: 12px;
+  margin: 0;
+  padding: 12px;
+  border: 1px solid var(--dwt-border);
+  border-radius: 6px;
+}
+
+:where(.dwt-options-columns) {
+  padding: 8px 12px;
+  font-size: 0.875rem;
+}
+
+:where(.dwt-options-columns ul) {
+  margin: 0;
+  padding: 0;
+  list-style: none;
+}
+
+:where(.dwt-options-columns li) {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: 8px;
+  min-height: 32px;
+}
+
+:where(.dwt-options-columns label) {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+}
+
+:where(.dwt-options-move) {
+  display: inline-flex;
+  gap: 4px;
+}
+
+:where(.dwt-options-error) {
+  margin: 0;
+  color: var(--dwt-bad);
+  font-size: 0.8125rem;
+}
+
+:where(.dwt-options-actions) {
+  display: flex;
+  flex-wrap: wrap;
+  align-items: center;
+  gap: 8px;
+}
+
+:where(.dwt-options-actions button:disabled) {
+  opacity: 0.5;
+  cursor: default;
+}
+
+@media (max-width: 640px) {
+  :where(.dwt-options-dialog) {
+    width: 100vw;
+    max-width: 100vw;
+    max-height: 100vh;
+    border-radius: 0;
+  }
+}
+
+:where(.dwt-button-primary) {
+  color: var(--dwt-surface);
+  background: var(--dwt-link);
+  border-color: transparent;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@richardmcquiston01/dashboard-widgets-toolkit",
-  "version": "0.13.0",
+  "version": "0.14.0",
   "description": "Framework-agnostic dashboard widget toolkit: typed widget definitions and data payloads (KPI, gauge, table, bar list, alert list, chart), user layout (order, hide, minimise), and React renderers. Bring your own data providers.",
   "keywords": [
     "dashboard",