@richardmcquiston01/dashboard-widgets-toolkit 0.9.0 → 0.11.0

package/dist/core.d.cts

@@ -1,5 +1,5 @@
-import { b as WidgetDefinition, W as WidgetSize, a as WidgetFill, D as DashboardWidget, k as WidgetContext, j as ResolveOptions, l as WidgetProviders, m as WidgetKind, n as Result, o as WidgetPayload } from './scale-CrXxawQn.cjs';
-export { p as AlertListItem, A as AlertListWidgetData, q as BarListItem, B as BarListWidgetData, C as CachedPayload, r as DEFAULT_COMPARISON_LABEL, s as DEFAULT_CURRENCY, t as DEFAULT_DETAIL_PAGE_SIZE, u as DEFAULT_EMPTY_TEXT, v as DETAIL_MODES, f as DashboardLayout, w as DeltaDirection, x as DeltaSentiment, y as DetailCell, z as DetailColumn, d as DetailData, E as DetailMode, F as DetailPage, H as DetailProvider, c as DetailProviderOptions, I as DetailProviders, e as DetailQuery, J as DetailSort, M as EMPTY_LAYOUT, O as EmptyWidget, P as EnforceLocksOptions, Q as Err, S as ErrorWidget, U as FormatOptions, g as GaugeWidgetData, V as GraphPoint, X as GraphSeries, G as GraphWidgetData, Y as KpiDelta, Z as KpiDeltaOptions, K as KpiWidgetData, _ as LayoutItem, $ as LoadingWidget, L as Locale, a0 as MAX_DETAIL_PAGE_SIZE, a1 as MAX_GRAPH_SERIES, N as NiceDomain, a2 as Ok, a3 as OkWidget, a4 as ProviderOptions, a5 as ResolvedDetailOptions, R as ResolvedTableControls, a6 as ResolvedWidget, a7 as ResolvedWidgetLock, a8 as SortDirection, a9 as TableCell, aa as TableColumn, T as TableWidgetData, h as TextWidgetData, ab as VALUE_FORMATS, ac as ValueFormat, ad as WIDGET_FILLS, ae as WIDGET_KINDS, af as WIDGET_SIZES, ag as WidgetCache, i as WidgetData, ah as WidgetDataOf, ai as WidgetDetailOptions, aj as WidgetEmptyState, ak as WidgetLock, al as WidgetProvider, am as WidgetStatus, an as WidgetTableControls, ao as cacheKeyFor, ap as defaultDetailQuery, aq as defineWidget, ar as deriveDetailData, as as describeUnknownError, at as emptyTextFor, au as emptyWidget, av as enforceLocks, aw as err, ax as failedWidget, ay as formatCount, az as formatPercentChange, aA as formatValue, aB as hiddenWidgets, aC as hideWidget, aD as isHidden, aE as isMinimized, aF as isWidgetEmptyState, aG as isWidgetKind, aH as isWidgetVisibleTo, aI as kpiDelta, aJ as labelStride, aK as loadingWidgets, aL as minimizeWidget, aM as moveWidget, aN as moveWidgetBy, aO as moveWidgetDown, aP as moveWidgetUp, aQ as niceDomain, aR as niceStep, aS as ok, aT as parseDetailQuery, aU as parseLayout, aV as percentChange, aW as pruneLayout, aX as queryRows, aY as resolveDetailOptions, aZ as resolvePayload, a_ as resolveTableControls, a$ as resolveWidget, b0 as resolveWidgetLock, b1 as resolveWidgets, b2 as restoreWidget, b3 as serializeDetailQuery, b4 as serializeLayout, b5 as shareOf, b6 as showWidget, b7 as sortDefinitions, b8 as tableDetailData, b9 as toggleHidden, ba as toggleMinimized, bb as validateDetailData, bc as visibleWidgets, bd as widgetsFor } from './scale-CrXxawQn.cjs';
+import { b as WidgetDefinition, D as DashboardWidget, n as WidgetContext, m as ResolveOptions, o as WidgetProviders, p as WidgetKind, q as Result, r as WidgetPayload } from './storage-VaaysVnZ.cjs';
+export { s as AddPageOptions, t as AlertListItem, A as AlertListWidgetData, u as BarListItem, B as BarListWidgetData, v as BooleanOption, C as CachedPayload, w as ChoiceOption, x as ColorOption, y as ColumnsOption, z as ConflictPolicy, E as DATE_RANGE_PRESETS, F as DEFAULT_COMPARISON_LABEL, H as DEFAULT_CURRENCY, I as DEFAULT_DETAIL_PAGE_SIZE, J as DEFAULT_EMPTY_TEXT, M as DEFAULT_MAX_LAYOUT_BYTES, Q as DEFAULT_PAGE_KEY, U as DEFAULT_PAGE_ROWS, V as DETAIL_MODES, f as DashboardLayout, X as DateRangeOption, Y as DateRangePreset, Z as DeltaDirection, _ as DeltaSentiment, $ as DetailCell, a0 as DetailColumn, d as DetailData, a1 as DetailMode, a2 as DetailPage, a3 as DetailProvider, c as DetailProviderOptions, a4 as DetailProviders, e as DetailQuery, h as DetailSort, a5 as EMPTY_LAYOUT, a6 as EmptyWidget, a7 as EncodingOptions, a8 as EnforceLocksOptions, a9 as Err, aa as ErrorWidget, ab as FormatOptions, g as GaugeWidgetData, ac as GraphPoint, ad as GraphSeries, G as GraphWidgetData, ae as GridItem, af as KpiDelta, ag as KpiDeltaOptions, K as KpiWidgetData, ah as LAYOUT_ENVELOPE_VERSION, ai as LayoutItem, aj as LayoutPage, k as LayoutPersistence, ak as LayoutPersistenceOptions, al as LoadedLayout, am as LoadingWidget, L as Locale, an as MAX_DETAIL_PAGE_SIZE, ao as MAX_GRAPH_SERIES, ap as MAX_PAGE_ROWS, aq as MAX_PAGE_TITLE_LENGTH, ar as MAX_PARSED_PAGES, as as MAX_TEXT_OPTION_LENGTH, at as MAX_WIDGET_OPTIONS, au as MAX_WIDGET_WIDTH, av as MIN_WIDGET_WIDTH, N as NiceDomain, l as NormalizeOptions, aw as NumberOption, ax as OPTION_KEY_PATTERN, ay as Ok, az as OkWidget, aA as OptionContext, aB as OptionValue, O as OptionValues, P as PageItem, aC as PageOptions, aD as PageRoom, aE as PlacedRow, aF as ProviderOptions, aG as ResolvedDetailOptions, R as ResolvedTableControls, aH as ResolvedWidget, aI as ResolvedWidgetLock, aJ as RetryOptions, aK as SaveOptions, aL as SavedLayout, aM as SortDirection, aN as SortOption, aO as StorageAdapter, aP as StorageLogEvent, aQ as StoreErrorCode, aR as StoreResult, S as StoreScope, aS as StoredValue, aT as TableCell, aU as TableColumn, T as TableWidgetData, aV as TextOption, i as TextWidgetData, aW as VALUE_FORMATS, aX as ValueFormat, aY as WIDGET_FILLS, aZ as WIDGET_KINDS, a_ as WIDGET_OPTION_TYPES, a$ as WIDGET_SIZES, b0 as WIDTH_COLUMNS, b1 as WidgetCache, j as WidgetData, b2 as WidgetDataOf, b3 as WidgetDetailOptions, b4 as WidgetEmptyState, a as WidgetFill, b5 as WidgetLock, b6 as WidgetOption, b7 as WidgetProvider, W as WidgetSize, b8 as WidgetStatus, b9 as WidgetTableControls, ba as addPage, bb as applyClientOptions, bc as assignPages, bd as baseColumnSpan, be as cacheKeyFor, bf as coerceOptionValue, bg as createLayoutPersistence, bh as defaultDetailQuery, bi as defaultOptionValue, bj as defineWidget, bk as deriveDetailData, bl as describeUnknownError, bm as emptyTextFor, bn as emptyWidget, bo as enforceLocks, bp as err, bq as failedWidget, br as fillColumnSpans, bs as fillWidthSpans, bt as fillsHeight, bu as fillsWidth, bv as finalizeWidget, bw as fitCount, bx as formatCount, by as formatPercentChange, bz as formatValue, bA as hasPages, bB as hiddenWidgets, bC as hideWidget, bD as isClientApplied, bE as isColumnKeyFor, bF as isHidden, bG as isIsoInterval, bH as isMinimized, bI as isWidgetEmptyState, bJ as isWidgetKind, bK as isWidgetVisibleTo, bL as isWidgetWidth, bM as itemWidth, bN as kpiDelta, bO as labelStride, bP as loadingWidgets, bQ as memoryAdapter, bR as minimizeWidget, bS as movePage, bT as moveWidget, bU as moveWidgetBy, bV as moveWidgetDown, bW as moveWidgetToPage, bX as moveWidgetUp, bY as nextPageKey, bZ as niceDomain, b_ as niceStep, b$ as normalizeLayout, c0 as ok, c1 as optionValuesFor, c2 as optionsCacheSuffix, c3 as pageLayout, c4 as pageList, c5 as pageOf, c6 as pageRoom, c7 as pageWidgets, c8 as parseDetailQuery, c9 as parseLayout, ca as parseSortValue, cb as percentChange, cc as placeRows, cd as pruneLayout, ce as queryRows, cf as readOnly, cg as removePage, ch as renamePage, ci as resolveDateRange, cj as resolveDetailOptions, ck as resolveOptionValues, cl as resolvePageKey, cm as resolvePayload, cn as resolveTableControls, co as resolveWidget, cp as resolveWidgetLock, cq as resolveWidgetUnapplied, cr as resolveWidgets, cs as restoreWidget, ct as sameOptionValues, cu as serializeDetailQuery, cv as serializeLayout, cw as shareOf, cx as showWidget, cy as sortDefinitions, cz as sortFromOptions, cA as tableDetailData, cB as toggleHidden, cC as toggleMinimized, cD as usesWidthColumns, cE as utf8Length, cF as validateDetailData, cG as visibleWidgets, cH as widgetsFor, cI as widthForSize, cJ as withEncoding, cK as withFallback, cL as withLogging, cM as withPageLayout, cN as withPrefix, cO as withReadCache, cP as withRetry } from './storage-VaaysVnZ.cjs';
 
 /**
  * Maker Toolkit compatibility. Its API (`apps/api/src/widgets`) serves
@@ -33,51 +33,6 @@ interface LegacyWidgetDefinition {
  */
 declare function fromLegacyDefinition(legacy: LegacyWidgetDefinition): WidgetDefinition | null;
 
-/** The parts of a widget definition that decide its place in a grid. */
-interface GridItem {
-    readonly key: string;
-    readonly defaultSize?: WidgetSize;
-    readonly fill?: WidgetFill;
-    readonly width?: number;
-}
-/** Columns in a grid that uses widget `width`. */
-declare const WIDTH_COLUMNS = 12;
-/** Smallest and largest `width`, in twelfths of a row. */
-declare const MIN_WIDGET_WIDTH = 2;
-declare const MAX_WIDGET_WIDTH = 12;
-/** Whether `value` is a valid widget `width`: an integer from 2 to 12. */
-declare function isWidgetWidth(value: unknown): value is number;
-/** The width (in twelfths) a `defaultSize` stands for. Default `medium`. */
-declare function widthForSize(size: WidgetSize | undefined): number;
-/** The 12-column width of an item: its `width`, else from its size. */
-declare function itemWidth(item: GridItem): number;
-/** Whether a grid of `items` should use 12 columns (any item sets `width`). */
-declare function usesWidthColumns(items: readonly GridItem[]): boolean;
-/** Whether the widget should take the columns left over in its row. */
-declare function fillsWidth(fill: WidgetFill | undefined): boolean;
-/** Whether the widget should stretch to the height of its row. */
-declare function fillsHeight(fill: WidgetFill | undefined): boolean;
-/**
- * Columns a size takes in a grid of `columns` tracks: `large` spans
- * `largeSpan` (default 2), `full` spans every column, anything else one.
- */
-declare function baseColumnSpan(size: WidgetSize | undefined, columns: number, largeSpan?: number): number;
-/**
- * Places `items` in a grid of `columns` tracks the way a sparse grid
- * auto-places them (left to right, wrapping to a new row when an item does
- * not fit), then gives the columns left over in each row to the items that
- * `fill` their width, shared evenly (earlier items get the remainder).
- *
- * Returns the column span for each width-filling item, keyed by `key`. Items
- * that do not fill width keep their normal size and are not in the map.
- */
-declare function fillColumnSpans(items: readonly GridItem[], columns: number, largeSpan?: number): Map<string, number>;
-/**
- * Like `fillColumnSpans` for a 12-column grid: each item starts at its
- * `width` (see `itemWidth`) and width-fillers share the leftover twelfths.
- */
-declare function fillWidthSpans(items: readonly GridItem[]): Map<string, number>;
-
 /**
  * Loads widgets one by one, after the first render, and reports each result
  * as it arrives. It is the logic behind the React `useWidgets` hook, kept
@@ -117,6 +72,16 @@ interface WidgetLoader {
      * than the interval would otherwise be restarted forever and never finish).
      */
     refresh(key?: string, options?: RefreshOptions): void;
+    /**
+     * Sets the values chosen for a widget's options (all of them: keys left out
+     * go back to their defaults). A choice only the toolkit applies (`sort` or
+     * `columns` with `apply: 'client'`) re-derives the payload it already has.
+     * A choice your provider sees reloads that widget alone: what is shown stays
+     * (marked `stale`) until the new data arrives, and an earlier answer for the
+     * same choices comes back from the cache. Does nothing when the resolved
+     * values don't change.
+     */
+    setOptions(key: string, chosen: Readonly<Record<string, unknown>>): void;
     /** Aborts everything in flight and ignores any later result. */
     dispose(): void;
 }
@@ -159,4 +124,4 @@ declare function validateWidgetData(value: unknown, options?: ValidateWidgetData
  */
 declare function validateWidgetDefinition(value: unknown): Result<WidgetDefinition>;
 
-export { DashboardWidget, type GridItem, type LegacyWidgetDefinition, MAX_REPORTED_PROBLEMS, MAX_WIDGET_WIDTH, MIN_WIDGET_WIDTH, type RefreshOptions, ResolveOptions, Result, type ValidateWidgetDataOptions, WIDTH_COLUMNS, WidgetContext, WidgetDefinition, WidgetFill, WidgetKind, type WidgetLoader, type WidgetLoaderOptions, WidgetPayload, WidgetProviders, WidgetSize, baseColumnSpan, createWidgetLoader, fillColumnSpans, fillWidthSpans, fillsHeight, fillsWidth, fromLegacyDefinition, isSafeHref, isSafeImageUrl, isWidgetWidth, itemWidth, upgradeLegacyWidgetData, usesWidthColumns, validateWidgetData, validateWidgetDefinition, widthForSize };
+export { DashboardWidget, type LegacyWidgetDefinition, MAX_REPORTED_PROBLEMS, type RefreshOptions, ResolveOptions, Result, type ValidateWidgetDataOptions, WidgetContext, WidgetDefinition, WidgetKind, type WidgetLoader, type WidgetLoaderOptions, WidgetPayload, WidgetProviders, createWidgetLoader, fromLegacyDefinition, isSafeHref, isSafeImageUrl, upgradeLegacyWidgetData, validateWidgetData, validateWidgetDefinition };

package/dist/core.d.ts

@@ -1,5 +1,5 @@
-import { b as WidgetDefinition, W as WidgetSize, a as WidgetFill, D as DashboardWidget, k as WidgetContext, j as ResolveOptions, l as WidgetProviders, m as WidgetKind, n as Result, o as WidgetPayload } from './scale-CrXxawQn.js';
-export { p as AlertListItem, A as AlertListWidgetData, q as BarListItem, B as BarListWidgetData, C as CachedPayload, r as DEFAULT_COMPARISON_LABEL, s as DEFAULT_CURRENCY, t as DEFAULT_DETAIL_PAGE_SIZE, u as DEFAULT_EMPTY_TEXT, v as DETAIL_MODES, f as DashboardLayout, w as DeltaDirection, x as DeltaSentiment, y as DetailCell, z as DetailColumn, d as DetailData, E as DetailMode, F as DetailPage, H as DetailProvider, c as DetailProviderOptions, I as DetailProviders, e as DetailQuery, J as DetailSort, M as EMPTY_LAYOUT, O as EmptyWidget, P as EnforceLocksOptions, Q as Err, S as ErrorWidget, U as FormatOptions, g as GaugeWidgetData, V as GraphPoint, X as GraphSeries, G as GraphWidgetData, Y as KpiDelta, Z as KpiDeltaOptions, K as KpiWidgetData, _ as LayoutItem, $ as LoadingWidget, L as Locale, a0 as MAX_DETAIL_PAGE_SIZE, a1 as MAX_GRAPH_SERIES, N as NiceDomain, a2 as Ok, a3 as OkWidget, a4 as ProviderOptions, a5 as ResolvedDetailOptions, R as ResolvedTableControls, a6 as ResolvedWidget, a7 as ResolvedWidgetLock, a8 as SortDirection, a9 as TableCell, aa as TableColumn, T as TableWidgetData, h as TextWidgetData, ab as VALUE_FORMATS, ac as ValueFormat, ad as WIDGET_FILLS, ae as WIDGET_KINDS, af as WIDGET_SIZES, ag as WidgetCache, i as WidgetData, ah as WidgetDataOf, ai as WidgetDetailOptions, aj as WidgetEmptyState, ak as WidgetLock, al as WidgetProvider, am as WidgetStatus, an as WidgetTableControls, ao as cacheKeyFor, ap as defaultDetailQuery, aq as defineWidget, ar as deriveDetailData, as as describeUnknownError, at as emptyTextFor, au as emptyWidget, av as enforceLocks, aw as err, ax as failedWidget, ay as formatCount, az as formatPercentChange, aA as formatValue, aB as hiddenWidgets, aC as hideWidget, aD as isHidden, aE as isMinimized, aF as isWidgetEmptyState, aG as isWidgetKind, aH as isWidgetVisibleTo, aI as kpiDelta, aJ as labelStride, aK as loadingWidgets, aL as minimizeWidget, aM as moveWidget, aN as moveWidgetBy, aO as moveWidgetDown, aP as moveWidgetUp, aQ as niceDomain, aR as niceStep, aS as ok, aT as parseDetailQuery, aU as parseLayout, aV as percentChange, aW as pruneLayout, aX as queryRows, aY as resolveDetailOptions, aZ as resolvePayload, a_ as resolveTableControls, a$ as resolveWidget, b0 as resolveWidgetLock, b1 as resolveWidgets, b2 as restoreWidget, b3 as serializeDetailQuery, b4 as serializeLayout, b5 as shareOf, b6 as showWidget, b7 as sortDefinitions, b8 as tableDetailData, b9 as toggleHidden, ba as toggleMinimized, bb as validateDetailData, bc as visibleWidgets, bd as widgetsFor } from './scale-CrXxawQn.js';
+import { b as WidgetDefinition, D as DashboardWidget, n as WidgetContext, m as ResolveOptions, o as WidgetProviders, p as WidgetKind, q as Result, r as WidgetPayload } from './storage-VaaysVnZ.js';
+export { s as AddPageOptions, t as AlertListItem, A as AlertListWidgetData, u as BarListItem, B as BarListWidgetData, v as BooleanOption, C as CachedPayload, w as ChoiceOption, x as ColorOption, y as ColumnsOption, z as ConflictPolicy, E as DATE_RANGE_PRESETS, F as DEFAULT_COMPARISON_LABEL, H as DEFAULT_CURRENCY, I as DEFAULT_DETAIL_PAGE_SIZE, J as DEFAULT_EMPTY_TEXT, M as DEFAULT_MAX_LAYOUT_BYTES, Q as DEFAULT_PAGE_KEY, U as DEFAULT_PAGE_ROWS, V as DETAIL_MODES, f as DashboardLayout, X as DateRangeOption, Y as DateRangePreset, Z as DeltaDirection, _ as DeltaSentiment, $ as DetailCell, a0 as DetailColumn, d as DetailData, a1 as DetailMode, a2 as DetailPage, a3 as DetailProvider, c as DetailProviderOptions, a4 as DetailProviders, e as DetailQuery, h as DetailSort, a5 as EMPTY_LAYOUT, a6 as EmptyWidget, a7 as EncodingOptions, a8 as EnforceLocksOptions, a9 as Err, aa as ErrorWidget, ab as FormatOptions, g as GaugeWidgetData, ac as GraphPoint, ad as GraphSeries, G as GraphWidgetData, ae as GridItem, af as KpiDelta, ag as KpiDeltaOptions, K as KpiWidgetData, ah as LAYOUT_ENVELOPE_VERSION, ai as LayoutItem, aj as LayoutPage, k as LayoutPersistence, ak as LayoutPersistenceOptions, al as LoadedLayout, am as LoadingWidget, L as Locale, an as MAX_DETAIL_PAGE_SIZE, ao as MAX_GRAPH_SERIES, ap as MAX_PAGE_ROWS, aq as MAX_PAGE_TITLE_LENGTH, ar as MAX_PARSED_PAGES, as as MAX_TEXT_OPTION_LENGTH, at as MAX_WIDGET_OPTIONS, au as MAX_WIDGET_WIDTH, av as MIN_WIDGET_WIDTH, N as NiceDomain, l as NormalizeOptions, aw as NumberOption, ax as OPTION_KEY_PATTERN, ay as Ok, az as OkWidget, aA as OptionContext, aB as OptionValue, O as OptionValues, P as PageItem, aC as PageOptions, aD as PageRoom, aE as PlacedRow, aF as ProviderOptions, aG as ResolvedDetailOptions, R as ResolvedTableControls, aH as ResolvedWidget, aI as ResolvedWidgetLock, aJ as RetryOptions, aK as SaveOptions, aL as SavedLayout, aM as SortDirection, aN as SortOption, aO as StorageAdapter, aP as StorageLogEvent, aQ as StoreErrorCode, aR as StoreResult, S as StoreScope, aS as StoredValue, aT as TableCell, aU as TableColumn, T as TableWidgetData, aV as TextOption, i as TextWidgetData, aW as VALUE_FORMATS, aX as ValueFormat, aY as WIDGET_FILLS, aZ as WIDGET_KINDS, a_ as WIDGET_OPTION_TYPES, a$ as WIDGET_SIZES, b0 as WIDTH_COLUMNS, b1 as WidgetCache, j as WidgetData, b2 as WidgetDataOf, b3 as WidgetDetailOptions, b4 as WidgetEmptyState, a as WidgetFill, b5 as WidgetLock, b6 as WidgetOption, b7 as WidgetProvider, W as WidgetSize, b8 as WidgetStatus, b9 as WidgetTableControls, ba as addPage, bb as applyClientOptions, bc as assignPages, bd as baseColumnSpan, be as cacheKeyFor, bf as coerceOptionValue, bg as createLayoutPersistence, bh as defaultDetailQuery, bi as defaultOptionValue, bj as defineWidget, bk as deriveDetailData, bl as describeUnknownError, bm as emptyTextFor, bn as emptyWidget, bo as enforceLocks, bp as err, bq as failedWidget, br as fillColumnSpans, bs as fillWidthSpans, bt as fillsHeight, bu as fillsWidth, bv as finalizeWidget, bw as fitCount, bx as formatCount, by as formatPercentChange, bz as formatValue, bA as hasPages, bB as hiddenWidgets, bC as hideWidget, bD as isClientApplied, bE as isColumnKeyFor, bF as isHidden, bG as isIsoInterval, bH as isMinimized, bI as isWidgetEmptyState, bJ as isWidgetKind, bK as isWidgetVisibleTo, bL as isWidgetWidth, bM as itemWidth, bN as kpiDelta, bO as labelStride, bP as loadingWidgets, bQ as memoryAdapter, bR as minimizeWidget, bS as movePage, bT as moveWidget, bU as moveWidgetBy, bV as moveWidgetDown, bW as moveWidgetToPage, bX as moveWidgetUp, bY as nextPageKey, bZ as niceDomain, b_ as niceStep, b$ as normalizeLayout, c0 as ok, c1 as optionValuesFor, c2 as optionsCacheSuffix, c3 as pageLayout, c4 as pageList, c5 as pageOf, c6 as pageRoom, c7 as pageWidgets, c8 as parseDetailQuery, c9 as parseLayout, ca as parseSortValue, cb as percentChange, cc as placeRows, cd as pruneLayout, ce as queryRows, cf as readOnly, cg as removePage, ch as renamePage, ci as resolveDateRange, cj as resolveDetailOptions, ck as resolveOptionValues, cl as resolvePageKey, cm as resolvePayload, cn as resolveTableControls, co as resolveWidget, cp as resolveWidgetLock, cq as resolveWidgetUnapplied, cr as resolveWidgets, cs as restoreWidget, ct as sameOptionValues, cu as serializeDetailQuery, cv as serializeLayout, cw as shareOf, cx as showWidget, cy as sortDefinitions, cz as sortFromOptions, cA as tableDetailData, cB as toggleHidden, cC as toggleMinimized, cD as usesWidthColumns, cE as utf8Length, cF as validateDetailData, cG as visibleWidgets, cH as widgetsFor, cI as widthForSize, cJ as withEncoding, cK as withFallback, cL as withLogging, cM as withPageLayout, cN as withPrefix, cO as withReadCache, cP as withRetry } from './storage-VaaysVnZ.js';
 
 /**
  * Maker Toolkit compatibility. Its API (`apps/api/src/widgets`) serves
@@ -33,51 +33,6 @@ interface LegacyWidgetDefinition {
  */
 declare function fromLegacyDefinition(legacy: LegacyWidgetDefinition): WidgetDefinition | null;
 
-/** The parts of a widget definition that decide its place in a grid. */
-interface GridItem {
-    readonly key: string;
-    readonly defaultSize?: WidgetSize;
-    readonly fill?: WidgetFill;
-    readonly width?: number;
-}
-/** Columns in a grid that uses widget `width`. */
-declare const WIDTH_COLUMNS = 12;
-/** Smallest and largest `width`, in twelfths of a row. */
-declare const MIN_WIDGET_WIDTH = 2;
-declare const MAX_WIDGET_WIDTH = 12;
-/** Whether `value` is a valid widget `width`: an integer from 2 to 12. */
-declare function isWidgetWidth(value: unknown): value is number;
-/** The width (in twelfths) a `defaultSize` stands for. Default `medium`. */
-declare function widthForSize(size: WidgetSize | undefined): number;
-/** The 12-column width of an item: its `width`, else from its size. */
-declare function itemWidth(item: GridItem): number;
-/** Whether a grid of `items` should use 12 columns (any item sets `width`). */
-declare function usesWidthColumns(items: readonly GridItem[]): boolean;
-/** Whether the widget should take the columns left over in its row. */
-declare function fillsWidth(fill: WidgetFill | undefined): boolean;
-/** Whether the widget should stretch to the height of its row. */
-declare function fillsHeight(fill: WidgetFill | undefined): boolean;
-/**
- * Columns a size takes in a grid of `columns` tracks: `large` spans
- * `largeSpan` (default 2), `full` spans every column, anything else one.
- */
-declare function baseColumnSpan(size: WidgetSize | undefined, columns: number, largeSpan?: number): number;
-/**
- * Places `items` in a grid of `columns` tracks the way a sparse grid
- * auto-places them (left to right, wrapping to a new row when an item does
- * not fit), then gives the columns left over in each row to the items that
- * `fill` their width, shared evenly (earlier items get the remainder).
- *
- * Returns the column span for each width-filling item, keyed by `key`. Items
- * that do not fill width keep their normal size and are not in the map.
- */
-declare function fillColumnSpans(items: readonly GridItem[], columns: number, largeSpan?: number): Map<string, number>;
-/**
- * Like `fillColumnSpans` for a 12-column grid: each item starts at its
- * `width` (see `itemWidth`) and width-fillers share the leftover twelfths.
- */
-declare function fillWidthSpans(items: readonly GridItem[]): Map<string, number>;
-
 /**
  * Loads widgets one by one, after the first render, and reports each result
  * as it arrives. It is the logic behind the React `useWidgets` hook, kept
@@ -117,6 +72,16 @@ interface WidgetLoader {
      * than the interval would otherwise be restarted forever and never finish).
      */
     refresh(key?: string, options?: RefreshOptions): void;
+    /**
+     * Sets the values chosen for a widget's options (all of them: keys left out
+     * go back to their defaults). A choice only the toolkit applies (`sort` or
+     * `columns` with `apply: 'client'`) re-derives the payload it already has.
+     * A choice your provider sees reloads that widget alone: what is shown stays
+     * (marked `stale`) until the new data arrives, and an earlier answer for the
+     * same choices comes back from the cache. Does nothing when the resolved
+     * values don't change.
+     */
+    setOptions(key: string, chosen: Readonly<Record<string, unknown>>): void;
     /** Aborts everything in flight and ignores any later result. */
     dispose(): void;
 }
@@ -159,4 +124,4 @@ declare function validateWidgetData(value: unknown, options?: ValidateWidgetData
  */
 declare function validateWidgetDefinition(value: unknown): Result<WidgetDefinition>;
 
-export { DashboardWidget, type GridItem, type LegacyWidgetDefinition, MAX_REPORTED_PROBLEMS, MAX_WIDGET_WIDTH, MIN_WIDGET_WIDTH, type RefreshOptions, ResolveOptions, Result, type ValidateWidgetDataOptions, WIDTH_COLUMNS, WidgetContext, WidgetDefinition, WidgetFill, WidgetKind, type WidgetLoader, type WidgetLoaderOptions, WidgetPayload, WidgetProviders, WidgetSize, baseColumnSpan, createWidgetLoader, fillColumnSpans, fillWidthSpans, fillsHeight, fillsWidth, fromLegacyDefinition, isSafeHref, isSafeImageUrl, isWidgetWidth, itemWidth, upgradeLegacyWidgetData, usesWidthColumns, validateWidgetData, validateWidgetDefinition, widthForSize };
+export { DashboardWidget, type LegacyWidgetDefinition, MAX_REPORTED_PROBLEMS, type RefreshOptions, ResolveOptions, Result, type ValidateWidgetDataOptions, WidgetContext, WidgetDefinition, WidgetKind, type WidgetLoader, type WidgetLoaderOptions, WidgetPayload, WidgetProviders, createWidgetLoader, fromLegacyDefinition, isSafeHref, isSafeImageUrl, upgradeLegacyWidgetData, validateWidgetData, validateWidgetDefinition };