@richardmcquiston01/dashboard-widgets-toolkit 0.12.0 → 0.14.0

package/dist/core.d.cts

@@ -1,5 +1,5 @@
-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';
+import { b as WidgetDefinition, D as DashboardWidget, p as WidgetContext, o as ResolveOptions, q as WidgetProviders, r as Result, s as WidgetKind, t as WidgetPayload } from './storage-_Eb8Y98-.cjs';
+export { u as AddPageOptions, v as AlertListItem, A as AlertListWidgetData, w as BarListItem, B as BarListWidgetData, x as BooleanOption, C as CachedPayload, y as ChoiceOption, z as ColorOption, E as ColumnsOption, F as ConflictPolicy, H as DATE_RANGE_PRESETS, I as DEFAULT_COMPARISON_LABEL, J as DEFAULT_CURRENCY, M as DEFAULT_DETAIL_PAGE_SIZE, Q as DEFAULT_EMPTY_TEXT, U as DEFAULT_MAX_LAYOUT_BYTES, V as DEFAULT_PAGE_KEY, X as DEFAULT_PAGE_ROWS, Y as DETAIL_MODES, f as DashboardLayout, Z as DateRangeOption, _ as DateRangePreset, $ as DeltaDirection, a0 as DeltaSentiment, a1 as DetailCell, a2 as DetailColumn, d as DetailData, a3 as DetailMode, a4 as DetailPage, a5 as DetailProvider, c as DetailProviderOptions, a6 as DetailProviders, e as DetailQuery, j as DetailSort, a7 as EMPTY_LAYOUT, a8 as EmptyWidget, a9 as EncodingOptions, aa as EnforceLocksOptions, ab as Err, ac as ErrorWidget, ad as FormatOptions, i as GaugeWidgetData, ae as GraphPoint, af as GraphSeries, G as GraphWidgetData, ag as GridItem, ah as KpiDelta, ai as KpiDeltaOptions, K as KpiWidgetData, aj as LAYOUT_ENVELOPE_VERSION, ak as LayoutItem, al as LayoutPage, m as LayoutPersistence, am as LayoutPersistenceOptions, an as LayoutSettings, ao as LoadedLayout, ap as LoadingWidget, L as Locale, aq as MAX_DETAIL_PAGE_SIZE, ar as MAX_GRAPH_SERIES, as as MAX_PAGE_ROWS, at as MAX_PAGE_TITLE_LENGTH, au as MAX_PARSED_PAGES, av as MAX_PARSED_SETTINGS, aw as MAX_TEXT_OPTION_LENGTH, ax as MAX_WIDGET_OPTIONS, ay as MAX_WIDGET_TITLE_LENGTH, az as MAX_WIDGET_WIDTH, aA as MIN_WIDGET_WIDTH, N as NiceDomain, n as NormalizeOptions, aB as NormalizeSettingsOptions, aC as NumberOption, aD as OPTION_KEY_PATTERN, aE as Ok, aF as OkWidget, aG as OptionContext, aH as OptionValue, O as OptionValues, P as PageItem, aI as PageOptions, aJ as PageRoom, aK as PlacedRow, aL as ProviderOptions, aM as ResolvedDetailOptions, R as ResolvedTableControls, aN as ResolvedWidget, aO as ResolvedWidgetLock, aP as RetryOptions, aQ as SaveOptions, aR as SavedLayout, aS as SettingsItem, aT as SortDirection, aU as SortOption, aV as StorageAdapter, aW as StorageLogEvent, aX as StoreErrorCode, aY as StoreResult, S as StoreScope, aZ as StoredValue, a_ as TableCell, a$ as TableColumn, T as TableWidgetData, b0 as TextOption, k as TextWidgetData, b1 as VALUE_FORMATS, b2 as ValueFormat, b3 as WIDGET_FILLS, b4 as WIDGET_KINDS, b5 as WIDGET_OPTION_TYPES, b6 as WIDGET_SIZES, b7 as WIDTH_COLUMNS, b8 as WidgetCache, l as WidgetData, b9 as WidgetDataOf, ba as WidgetDetailOptions, bb as WidgetEmptyState, a as WidgetFill, bc as WidgetLock, bd as WidgetOption, be as WidgetProvider, h as WidgetSettingsPatch, W as WidgetSize, bf as WidgetStatus, bg as WidgetTableControls, g as WidgetViewerSettings, bh as addPage, bi as applyClientOptions, bj as applySettings, bk as assignPages, bl as baseColumnSpan, bm as cacheKeyFor, bn as clearWidgetSettings, bo as coerceOptionValue, bp as createLayoutPersistence, bq as defaultDetailQuery, br as defaultOptionValue, bs as defineWidget, bt as deriveDetailData, bu as describeUnknownError, bv as effectiveDefinitions, bw as emptyTextFor, bx as emptyWidget, by as enforceLocks, bz as err, bA as failedWidget, bB as fillColumnSpans, bC as fillWidthSpans, bD as fillsHeight, bE as fillsWidth, bF as finalizeWidget, bG as fitCount, bH as formatCount, bI as formatPercentChange, bJ as formatValue, bK as hasPages, bL as hiddenWidgets, bM as hideWidget, bN as isClientApplied, bO as isColumnKeyFor, bP as isFlexible, bQ as isHidden, bR as isIsoInterval, bS as isMinimized, bT as isOptionsLocked, bU as isTitleInUse, bV as isWidgetEmptyState, bW as isWidgetKind, bX as isWidgetVisibleTo, bY as isWidgetWidth, bZ as itemWidth, b_ as kpiDelta, b$ as labelStride, c0 as loadingWidgets, c1 as memoryAdapter, c2 as minimizeWidget, c3 as movePage, c4 as moveWidget, c5 as moveWidgetBy, c6 as moveWidgetDown, c7 as moveWidgetToPage, c8 as moveWidgetUp, c9 as nextPageKey, ca as niceDomain, cb as niceStep, cc as normalizeLayout, cd as normalizeSettings, ce as normalizeTitle, cf as ok, cg as optionValuesFor, ch as optionValuesFromLayout, ci as optionsCacheSuffix, cj as pageLayout, ck as pageList, cl as pageOf, cm as pageRoom, cn as pageWidgets, co as parseDetailQuery, cp as parseLayout, cq as parseSettings, cr as parseSortValue, cs as percentChange, ct as placeRows, cu as pruneLayout, cv as queryRows, cw as readOnly, cx as removePage, cy as renamePage, cz as resolveDateRange, cA as resolveDetailOptions, cB as resolveOptionValues, cC as resolvePageKey, cD as resolvePayload, cE as resolveTableControls, cF as resolveWidget, cG as resolveWidgetLock, cH as resolveWidgetUnapplied, cI as resolveWidgets, cJ as restoreWidget, cK as sameOptionValues, cL as serializeDetailQuery, cM as serializeLayout, cN as serializeSettings, cO as setWidgetSettings, cP as shareOf, cQ as showWidget, cR as sortDefinitions, cS as sortFromOptions, cT as tableDetailData, cU as toggleHidden, cV as toggleMinimized, cW as usesWidthColumns, cX as utf8Length, cY as validateDetailData, cZ as visibleWidgets, c_ as widgetOptionValues, c$ as widgetsFor, d0 as widthForSize, d1 as widthRange, d2 as widthShareLabel, d3 as withEncoding, d4 as withFallback, d5 as withLogging, d6 as withPageLayout, d7 as withPrefix, d8 as withReadCache, d9 as withRetry } from './storage-_Eb8Y98-.cjs';
 
 /**
  * Maker Toolkit compatibility. Its API (`apps/api/src/widgets`) serves
@@ -87,6 +87,60 @@ interface WidgetLoader {
 }
 declare function createWidgetLoader<C extends WidgetContext>(options: WidgetLoaderOptions<C>): WidgetLoader;
 
+/**
+ * Theming: turns a typed token object into scoped CSS for the `--dwt-*` custom
+ * properties. Runtime-neutral: it only builds a string, so a Node API, a build
+ * script or an SSR server can produce a theme without React or a DOM.
+ *
+ * The built-in defaults are declared on `.dwt-dashboard` and `.dwt-card`, so a
+ * variable set on an ancestor is shadowed. The generated selectors therefore
+ * target those two classes beneath a scope and out-rank the built-in dark rules.
+ * See docs/design/theming.md.
+ */
+
+type ThemeColorKey = 'surface' | 'page' | 'text' | 'textSecondary' | 'textMuted' | 'border' | 'grid' | 'baseline' | 'crosshair' | 'link' | 'focus' | 'good' | 'bad' | 'meterTrack' | 'barTrack' | 'buttonHover';
+type ThemeLengthKey = 'radius' | 'gap' | 'padding' | 'minColumn';
+type ThemeTokenKey = ThemeColorKey | ThemeLengthKey | 'font';
+/** The CSS custom property each token key sets (series are `--dwt-series-N`). */
+declare const THEME_TOKEN_VARIABLES: Readonly<Record<ThemeTokenKey, string>>;
+type ThemeTokens = {
+    readonly [Key in ThemeTokenKey]?: string;
+} & {
+    /** Chart colors in order; fills `--dwt-series-1` to `--dwt-series-N`. */
+    readonly series?: readonly string[];
+};
+interface ThemeOptions {
+    /** Lower-case letters, digits and hyphens, starting with a letter. */
+    readonly name: string;
+    /**
+     * Selector of an ancestor of the dashboard. Defaults to
+     * `[data-dwt-theme='<name>']`. Letters, digits, `_ - [ ] = . # ' "` and spaces
+     * only.
+     */
+    readonly scope?: string;
+    /** Applied in light and dark mode. */
+    readonly base?: ThemeTokens;
+    /** Applied in light mode only; wins over `base`. */
+    readonly light?: ThemeTokens;
+    /** Applied in dark mode only; wins over `base`. */
+    readonly dark?: ThemeTokens;
+}
+type ThemeMode = 'base' | 'light' | 'dark';
+interface WidgetThemeStyles {
+    readonly name: string;
+    readonly scope: string;
+    /** For a `<style>` element or the head of a server-rendered page. */
+    readonly css: string;
+    /** The resolved custom properties per mode, e.g. `{'--dwt-surface': '#fff'}`. */
+    readonly variables: Readonly<Record<ThemeMode, Readonly<Record<string, string>>>>;
+}
+/**
+ * Builds the CSS for a theme. Tokens left unset keep their built-in value in
+ * each mode. Returns an error naming the mode, the token and the value when
+ * anything is invalid.
+ */
+declare function createTheme(options: ThemeOptions): Result<WidgetThemeStyles>;
+
 /**
  * Link and image URL checks. Payloads often come from an API, so a link is
  * only rendered when it can't run script: http(s), mailto, or a relative
@@ -124,4 +178,4 @@ declare function validateWidgetData(value: unknown, options?: ValidateWidgetData
  */
 declare function validateWidgetDefinition(value: unknown): Result<WidgetDefinition>;
 
-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 };
+export { DashboardWidget, type LegacyWidgetDefinition, MAX_REPORTED_PROBLEMS, type RefreshOptions, ResolveOptions, Result, THEME_TOKEN_VARIABLES, type ThemeColorKey, type ThemeLengthKey, type ThemeMode, type ThemeOptions, type ThemeTokenKey, type ThemeTokens, type ValidateWidgetDataOptions, WidgetContext, WidgetDefinition, WidgetKind, type WidgetLoader, type WidgetLoaderOptions, WidgetPayload, WidgetProviders, type WidgetThemeStyles, createTheme, createWidgetLoader, fromLegacyDefinition, isSafeHref, isSafeImageUrl, upgradeLegacyWidgetData, validateWidgetData, validateWidgetDefinition };

package/dist/core.d.ts

@@ -1,5 +1,5 @@
-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';
+import { b as WidgetDefinition, D as DashboardWidget, p as WidgetContext, o as ResolveOptions, q as WidgetProviders, r as Result, s as WidgetKind, t as WidgetPayload } from './storage-_Eb8Y98-.js';
+export { u as AddPageOptions, v as AlertListItem, A as AlertListWidgetData, w as BarListItem, B as BarListWidgetData, x as BooleanOption, C as CachedPayload, y as ChoiceOption, z as ColorOption, E as ColumnsOption, F as ConflictPolicy, H as DATE_RANGE_PRESETS, I as DEFAULT_COMPARISON_LABEL, J as DEFAULT_CURRENCY, M as DEFAULT_DETAIL_PAGE_SIZE, Q as DEFAULT_EMPTY_TEXT, U as DEFAULT_MAX_LAYOUT_BYTES, V as DEFAULT_PAGE_KEY, X as DEFAULT_PAGE_ROWS, Y as DETAIL_MODES, f as DashboardLayout, Z as DateRangeOption, _ as DateRangePreset, $ as DeltaDirection, a0 as DeltaSentiment, a1 as DetailCell, a2 as DetailColumn, d as DetailData, a3 as DetailMode, a4 as DetailPage, a5 as DetailProvider, c as DetailProviderOptions, a6 as DetailProviders, e as DetailQuery, j as DetailSort, a7 as EMPTY_LAYOUT, a8 as EmptyWidget, a9 as EncodingOptions, aa as EnforceLocksOptions, ab as Err, ac as ErrorWidget, ad as FormatOptions, i as GaugeWidgetData, ae as GraphPoint, af as GraphSeries, G as GraphWidgetData, ag as GridItem, ah as KpiDelta, ai as KpiDeltaOptions, K as KpiWidgetData, aj as LAYOUT_ENVELOPE_VERSION, ak as LayoutItem, al as LayoutPage, m as LayoutPersistence, am as LayoutPersistenceOptions, an as LayoutSettings, ao as LoadedLayout, ap as LoadingWidget, L as Locale, aq as MAX_DETAIL_PAGE_SIZE, ar as MAX_GRAPH_SERIES, as as MAX_PAGE_ROWS, at as MAX_PAGE_TITLE_LENGTH, au as MAX_PARSED_PAGES, av as MAX_PARSED_SETTINGS, aw as MAX_TEXT_OPTION_LENGTH, ax as MAX_WIDGET_OPTIONS, ay as MAX_WIDGET_TITLE_LENGTH, az as MAX_WIDGET_WIDTH, aA as MIN_WIDGET_WIDTH, N as NiceDomain, n as NormalizeOptions, aB as NormalizeSettingsOptions, aC as NumberOption, aD as OPTION_KEY_PATTERN, aE as Ok, aF as OkWidget, aG as OptionContext, aH as OptionValue, O as OptionValues, P as PageItem, aI as PageOptions, aJ as PageRoom, aK as PlacedRow, aL as ProviderOptions, aM as ResolvedDetailOptions, R as ResolvedTableControls, aN as ResolvedWidget, aO as ResolvedWidgetLock, aP as RetryOptions, aQ as SaveOptions, aR as SavedLayout, aS as SettingsItem, aT as SortDirection, aU as SortOption, aV as StorageAdapter, aW as StorageLogEvent, aX as StoreErrorCode, aY as StoreResult, S as StoreScope, aZ as StoredValue, a_ as TableCell, a$ as TableColumn, T as TableWidgetData, b0 as TextOption, k as TextWidgetData, b1 as VALUE_FORMATS, b2 as ValueFormat, b3 as WIDGET_FILLS, b4 as WIDGET_KINDS, b5 as WIDGET_OPTION_TYPES, b6 as WIDGET_SIZES, b7 as WIDTH_COLUMNS, b8 as WidgetCache, l as WidgetData, b9 as WidgetDataOf, ba as WidgetDetailOptions, bb as WidgetEmptyState, a as WidgetFill, bc as WidgetLock, bd as WidgetOption, be as WidgetProvider, h as WidgetSettingsPatch, W as WidgetSize, bf as WidgetStatus, bg as WidgetTableControls, g as WidgetViewerSettings, bh as addPage, bi as applyClientOptions, bj as applySettings, bk as assignPages, bl as baseColumnSpan, bm as cacheKeyFor, bn as clearWidgetSettings, bo as coerceOptionValue, bp as createLayoutPersistence, bq as defaultDetailQuery, br as defaultOptionValue, bs as defineWidget, bt as deriveDetailData, bu as describeUnknownError, bv as effectiveDefinitions, bw as emptyTextFor, bx as emptyWidget, by as enforceLocks, bz as err, bA as failedWidget, bB as fillColumnSpans, bC as fillWidthSpans, bD as fillsHeight, bE as fillsWidth, bF as finalizeWidget, bG as fitCount, bH as formatCount, bI as formatPercentChange, bJ as formatValue, bK as hasPages, bL as hiddenWidgets, bM as hideWidget, bN as isClientApplied, bO as isColumnKeyFor, bP as isFlexible, bQ as isHidden, bR as isIsoInterval, bS as isMinimized, bT as isOptionsLocked, bU as isTitleInUse, bV as isWidgetEmptyState, bW as isWidgetKind, bX as isWidgetVisibleTo, bY as isWidgetWidth, bZ as itemWidth, b_ as kpiDelta, b$ as labelStride, c0 as loadingWidgets, c1 as memoryAdapter, c2 as minimizeWidget, c3 as movePage, c4 as moveWidget, c5 as moveWidgetBy, c6 as moveWidgetDown, c7 as moveWidgetToPage, c8 as moveWidgetUp, c9 as nextPageKey, ca as niceDomain, cb as niceStep, cc as normalizeLayout, cd as normalizeSettings, ce as normalizeTitle, cf as ok, cg as optionValuesFor, ch as optionValuesFromLayout, ci as optionsCacheSuffix, cj as pageLayout, ck as pageList, cl as pageOf, cm as pageRoom, cn as pageWidgets, co as parseDetailQuery, cp as parseLayout, cq as parseSettings, cr as parseSortValue, cs as percentChange, ct as placeRows, cu as pruneLayout, cv as queryRows, cw as readOnly, cx as removePage, cy as renamePage, cz as resolveDateRange, cA as resolveDetailOptions, cB as resolveOptionValues, cC as resolvePageKey, cD as resolvePayload, cE as resolveTableControls, cF as resolveWidget, cG as resolveWidgetLock, cH as resolveWidgetUnapplied, cI as resolveWidgets, cJ as restoreWidget, cK as sameOptionValues, cL as serializeDetailQuery, cM as serializeLayout, cN as serializeSettings, cO as setWidgetSettings, cP as shareOf, cQ as showWidget, cR as sortDefinitions, cS as sortFromOptions, cT as tableDetailData, cU as toggleHidden, cV as toggleMinimized, cW as usesWidthColumns, cX as utf8Length, cY as validateDetailData, cZ as visibleWidgets, c_ as widgetOptionValues, c$ as widgetsFor, d0 as widthForSize, d1 as widthRange, d2 as widthShareLabel, d3 as withEncoding, d4 as withFallback, d5 as withLogging, d6 as withPageLayout, d7 as withPrefix, d8 as withReadCache, d9 as withRetry } from './storage-_Eb8Y98-.js';
 
 /**
  * Maker Toolkit compatibility. Its API (`apps/api/src/widgets`) serves
@@ -87,6 +87,60 @@ interface WidgetLoader {
 }
 declare function createWidgetLoader<C extends WidgetContext>(options: WidgetLoaderOptions<C>): WidgetLoader;
 
+/**
+ * Theming: turns a typed token object into scoped CSS for the `--dwt-*` custom
+ * properties. Runtime-neutral: it only builds a string, so a Node API, a build
+ * script or an SSR server can produce a theme without React or a DOM.
+ *
+ * The built-in defaults are declared on `.dwt-dashboard` and `.dwt-card`, so a
+ * variable set on an ancestor is shadowed. The generated selectors therefore
+ * target those two classes beneath a scope and out-rank the built-in dark rules.
+ * See docs/design/theming.md.
+ */
+
+type ThemeColorKey = 'surface' | 'page' | 'text' | 'textSecondary' | 'textMuted' | 'border' | 'grid' | 'baseline' | 'crosshair' | 'link' | 'focus' | 'good' | 'bad' | 'meterTrack' | 'barTrack' | 'buttonHover';
+type ThemeLengthKey = 'radius' | 'gap' | 'padding' | 'minColumn';
+type ThemeTokenKey = ThemeColorKey | ThemeLengthKey | 'font';
+/** The CSS custom property each token key sets (series are `--dwt-series-N`). */
+declare const THEME_TOKEN_VARIABLES: Readonly<Record<ThemeTokenKey, string>>;
+type ThemeTokens = {
+    readonly [Key in ThemeTokenKey]?: string;
+} & {
+    /** Chart colors in order; fills `--dwt-series-1` to `--dwt-series-N`. */
+    readonly series?: readonly string[];
+};
+interface ThemeOptions {
+    /** Lower-case letters, digits and hyphens, starting with a letter. */
+    readonly name: string;
+    /**
+     * Selector of an ancestor of the dashboard. Defaults to
+     * `[data-dwt-theme='<name>']`. Letters, digits, `_ - [ ] = . # ' "` and spaces
+     * only.
+     */
+    readonly scope?: string;
+    /** Applied in light and dark mode. */
+    readonly base?: ThemeTokens;
+    /** Applied in light mode only; wins over `base`. */
+    readonly light?: ThemeTokens;
+    /** Applied in dark mode only; wins over `base`. */
+    readonly dark?: ThemeTokens;
+}
+type ThemeMode = 'base' | 'light' | 'dark';
+interface WidgetThemeStyles {
+    readonly name: string;
+    readonly scope: string;
+    /** For a `<style>` element or the head of a server-rendered page. */
+    readonly css: string;
+    /** The resolved custom properties per mode, e.g. `{'--dwt-surface': '#fff'}`. */
+    readonly variables: Readonly<Record<ThemeMode, Readonly<Record<string, string>>>>;
+}
+/**
+ * Builds the CSS for a theme. Tokens left unset keep their built-in value in
+ * each mode. Returns an error naming the mode, the token and the value when
+ * anything is invalid.
+ */
+declare function createTheme(options: ThemeOptions): Result<WidgetThemeStyles>;
+
 /**
  * Link and image URL checks. Payloads often come from an API, so a link is
  * only rendered when it can't run script: http(s), mailto, or a relative
@@ -124,4 +178,4 @@ declare function validateWidgetData(value: unknown, options?: ValidateWidgetData
  */
 declare function validateWidgetDefinition(value: unknown): Result<WidgetDefinition>;
 
-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 };
+export { DashboardWidget, type LegacyWidgetDefinition, MAX_REPORTED_PROBLEMS, type RefreshOptions, ResolveOptions, Result, THEME_TOKEN_VARIABLES, type ThemeColorKey, type ThemeLengthKey, type ThemeMode, type ThemeOptions, type ThemeTokenKey, type ThemeTokens, type ValidateWidgetDataOptions, WidgetContext, WidgetDefinition, WidgetKind, type WidgetLoader, type WidgetLoaderOptions, WidgetPayload, WidgetProviders, type WidgetThemeStyles, createTheme, createWidgetLoader, fromLegacyDefinition, isSafeHref, isSafeImageUrl, upgradeLegacyWidgetData, validateWidgetData, validateWidgetDefinition };