@richardmcquiston01/dashboard-widgets-toolkit 0.14.0 → 0.16.0

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

@@ -738,6 +738,112 @@ declare function tableDetailData(data: TableWidgetData): DetailData;
  */
 declare function deriveDetailData(data: WidgetData, locale?: Locale): DetailData | undefined;
 
+/**
+ * Alternate views: other ways to show the same data. A widget declares
+ * `views`, each one built from the widget's own payload by a named,
+ * parameterized conversion (data, not functions, so definitions stay JSON).
+ * Switching is instant: no second load. Pure functions, no I/O.
+ */
+
+/** The key of the widget's own kind, always available as a view. */
+declare const BASE_VIEW_KEY = "base";
+/** Most views one widget may declare, the base view not counted. */
+declare const MAX_WIDGET_VIEWS = 8;
+/** How a view is built from the widget's payload. */
+type ViewConversion = {
+    readonly type: 'tableToBarList';
+    /** Column index of the bar labels. */
+    readonly label: number;
+    /** Column index of the bar values (cells need a numeric `value`). */
+    readonly value: number;
+} | {
+    readonly type: 'tableToGraph';
+    /** Column index of the x labels. */
+    readonly label: number;
+    /** Column indexes of the series (cells need a numeric `value`). */
+    readonly values: readonly number[];
+    readonly chartType: 'bar' | 'line';
+    /** How the numbers read. Default `number`. */
+    readonly valueFormat?: ValueFormat;
+    readonly currency?: string;
+} | {
+    readonly type: 'barListToTable';
+    /** Heading of the label column. Default "Name". */
+    readonly labelHeading?: string;
+    /** Heading of the value column. Default "Value". */
+    readonly valueHeading?: string;
+} | {
+    readonly type: 'graphToTable';
+} | {
+    readonly type: 'barListToGraph';
+    readonly chartType: 'bar' | 'line';
+    /** Name of the one series. Default "Value". */
+    readonly seriesName?: string;
+    readonly valueFormat?: ValueFormat;
+    readonly currency?: string;
+};
+/** The kinds a conversion reads and produces. */
+declare const VIEW_CONVERSIONS: Readonly<Record<ViewConversion['type'], {
+    from: WidgetKind;
+    to: WidgetKind;
+}>>;
+/** One alternate way to show a widget. */
+interface WidgetView {
+    /** Unique within the widget; not `base`. Stored in the viewer's settings. */
+    readonly key: string;
+    /** What the viewer sees in the View field, e.g. "Bars". */
+    readonly label: string;
+    /** What this view renders; must match what the conversion produces. */
+    readonly kind: WidgetKind;
+    /** Builds this view from the widget's payload. */
+    readonly convert: ViewConversion;
+}
+/** What these functions need from a definition. */
+type ViewsItem = Pick<WidgetDefinition, 'key' | 'kind'> & Partial<Pick<WidgetDefinition, 'views' | 'defaultView' | 'baseViewLabel'>>;
+/** A kind's plain name, used for the base view unless `baseViewLabel` is set. */
+declare function kindLabel(kind: WidgetKind): string;
+/** Whether the definition offers a choice of views. */
+declare function hasViews(item: Pick<ViewsItem, 'views'>): boolean;
+/** The view with this key, or undefined (`base` is not a declared view). */
+declare function findView(item: Pick<ViewsItem, 'views'>, key: string): WidgetView | undefined;
+/** Every view a viewer may pick: the base first, then the declared ones. */
+declare function viewChoices(item: ViewsItem): readonly {
+    key: string;
+    label: string;
+    kind: WidgetKind;
+}[];
+/**
+ * The view in effect: the viewer's pick when the definition declares it,
+ * else `defaultView`, else the base. Always a valid key.
+ */
+declare function effectiveViewKey(item: ViewsItem, chosen: string | undefined): string;
+/** The kind the widget renders as under this view key. */
+declare function viewKind(item: ViewsItem, chosen: string | undefined): WidgetKind;
+/** Options for `convertView`. */
+interface ConvertViewOptions {
+    /** Locale for numbers a conversion has to format (graph to table). */
+    readonly locale?: Locale;
+}
+/**
+ * Builds a view's payload from the widget's payload. The error names the
+ * widget, the view and what to fix, for example `Widget "top-products" view
+ * "bars": row 3, column 2 ("Sold") has no numeric value. Add value to the
+ * cells.` Never throws.
+ */
+declare function convertView(widgetKey: string, view: Pick<WidgetView, 'key' | 'convert'>, data: WidgetData, options?: ConvertViewOptions): Result<WidgetData>;
+/**
+ * What a view keeps of a table, for the dialog: "Shows Name and Sold only."
+ * Empty when the view loses nothing worth saying.
+ */
+declare function viewNote(view: WidgetView, data: WidgetData | undefined): string;
+/**
+ * The widget as the chosen view shows it: the payload converted and the
+ * definition's `kind` set to the view's kind, so renderers work unchanged.
+ * A widget that isn't `ok`, or whose view is the base, comes back as is; a
+ * failed conversion becomes an `error` widget naming the fix.
+ */
+declare function applyView<W extends DashboardWidget>(widget: W, chosen: string | undefined, options?: ConvertViewOptions): DashboardWidget;
+
 /** A size hint for grid layouts; renderers may map it to column spans. */
 declare const WIDGET_SIZES: readonly ["small", "medium", "large", "full"];
 type WidgetSize = (typeof WIDGET_SIZES)[number];
@@ -815,6 +921,21 @@ interface WidgetDefinition {
      * `ProviderOptions.options`. See `options.ts`.
      */
     readonly options?: readonly WidgetOption[];
+    /**
+     * Other ways to show this widget, built from its payload by a named
+     * conversion (a table as bars or a chart). The widget's own `kind` is
+     * always available as the view `base`. See `views.ts`.
+     */
+    readonly views?: readonly WidgetView[];
+    /** The view shown until a viewer picks another: `base` or a `views` key. Default `base`. */
+    readonly defaultView?: string;
+    /** What the base view is called in the View field. Default: its kind's name. */
+    readonly baseViewLabel?: string;
+    /**
+     * Set on a clone (see `clones.ts`): the key of the widget it copies. Its
+     * data comes from that widget's provider. Authors never set it.
+     */
+    readonly sourceKey?: string;
 }
 /** What a viewer may not do to a locked widget. */
 interface WidgetLock {
@@ -826,6 +947,8 @@ interface WidgetLock {
     readonly minimize?: boolean;
     /** Can't be given a title, width or option values of the viewer's own. */
     readonly options?: boolean;
+    /** Can't be duplicated into a clone. */
+    readonly clone?: boolean;
 }
 /** `WidgetLock` with every default filled in. */
 type ResolvedWidgetLock = Required<WidgetLock>;
@@ -845,70 +968,63 @@ declare function sortDefinitions<D extends WidgetDefinition>(definitions: readon
 /** Whether a widget is active and visible to someone with these roles. */
 declare function isWidgetVisibleTo(definition: WidgetDefinition, roles: readonly string[] | undefined): boolean;
 
-/** 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.
+ * Clones: copies of a widget a viewer made to keep it twice with different
+ * settings (another view, width or option values). A clone is stored as
+ * `{ key, from }` in `layout.clones`, its settings under its own key in
+ * `layout.settings`, and it shares the original's provider. Pure functions,
+ * no I/O.
  */
-declare function baseColumnSpan(size: WidgetSize | undefined, columns: number, largeSpan?: number): number;
+
+/** A widget the viewer made from another. */
+interface WidgetClone {
+    /** Unique across definitions and clones: `from#1`, `from#2`, ... */
+    readonly key: string;
+    /** The original's key. Always an original, never another clone. */
+    readonly from: string;
+}
 /**
- * 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.
+ * Most clones `parseLayout` keeps: a safety ceiling against malformed or
+ * hostile JSON, not a product limit (a page's capacity is the real limit).
  */
-declare function fillColumnSpans(items: readonly GridItem[], columns: number, largeSpan?: number): Map<string, number>;
+declare const MAX_PARSED_CLONES = 500;
+/** What these functions need from a definition. */
+type CloneItem = Pick<WidgetDefinition, 'key'> & Partial<Pick<WidgetDefinition, 'title' | 'locked' | 'sourceKey'>>;
+/** Options for the clone functions. */
+interface CloneOptions {
+    /** Keep clones that a widget's `locked.clone` forbids (an administrator). */
+    readonly overrideLocks?: boolean;
+}
 /**
- * Like `fillColumnSpans` for a 12-column grid: each item starts at its
- * `width` (see `itemWidth`) and width-fillers share the leftover twelfths.
+ * Reads the `clones` field of a saved layout. Anything malformed is dropped
+ * (wrong types, empty or repeated keys, a clone of itself). Returns undefined
+ * when nothing usable is left.
  */
-declare function fillWidthSpans(items: readonly GridItem[]): Map<string, number>;
-/** One row of a placed grid: the widgets in it and their final column spans. */
-interface PlacedRow {
-    readonly keys: readonly string[];
-    /** Column spans, in `keys` order, after width-fillers took the leftovers. */
-    readonly spans: readonly number[];
-}
+declare function parseClones(raw: unknown): readonly WidgetClone[] | undefined;
+/** The JSON-ready form of `layout.clones`; undefined when there are none. */
+declare function serializeClones(clones: readonly WidgetClone[] | undefined): WidgetClone[] | undefined;
+/** The number in a clone key (`orders#3` is 3), or undefined. */
+declare function cloneNumber(key: string): number | undefined;
 /**
- * The rows `items` occupy in a 12-column grid, exactly as `fillWidthSpans`
- * places them: left to right, a widget that doesn't fit in the rest of a row
- * starts the next row whole (a widget is never split), and width-fillers then
- * grow into the leftover columns. Growth never changes how many rows there
- * are.
+ * The clones that can exist for these definitions: the original is a real
+ * widget (not itself a clone), the key doesn't shadow another widget, and the
+ * original's `locked.clone` allows it. Returns the same array when nothing is
+ * dropped. Clones already present as definitions (see `withClones`) count as
+ * valid, so the function is idempotent.
  */
-declare function placeRows(items: readonly GridItem[]): readonly PlacedRow[];
+declare function cleanClones<D extends CloneItem>(definitions: readonly D[], clones: readonly WidgetClone[] | undefined, options?: CloneOptions): readonly WidgetClone[] | undefined;
 /**
- * How many of `items`, in order, fit in `maxRows` rows of a 12-column grid.
- * Placement is left to right, so this is the length of the longest prefix
- * whose rows number at most `maxRows`.
+ * The definitions with each clone added right after its original. A clone's
+ * definition copies the original's, with its own key, `sourceKey` set to the
+ * original, the title "Original (#n)" and no locks (a clone is the viewer's
+ * to move, hide and delete). Settings still apply on top (`effectiveDefinitions`).
+ * Pass the result to `useWidgets` so clones load, and to the settings and
+ * layout functions. Idempotent; returns the same array when there are no
+ * clones to add.
  */
-declare function fitCount(items: readonly GridItem[], maxRows: number): number;
+declare function withClones<D extends CloneItem>(definitions: readonly D[], layout: {
+    readonly clones?: readonly WidgetClone[];
+}, options?: CloneOptions): readonly D[];
 
 /**
  * A viewer's own choices for a widget: a title, a width and values for the
@@ -927,6 +1043,8 @@ interface WidgetViewerSettings {
     readonly flexible?: boolean;
     /** Values for declared options, by option key. */
     readonly options?: Readonly<Record<string, OptionValue>>;
+    /** The view to show: `base` or a key from the definition's `views`. */
+    readonly view?: string;
 }
 /** Viewer settings by widget key. */
 type LayoutSettings = Readonly<Record<string, WidgetViewerSettings>>;
@@ -938,7 +1056,7 @@ declare const MAX_WIDGET_TITLE_LENGTH = 80;
  */
 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'>>;
+type SettingsItem = Pick<WidgetDefinition, 'key'> & Partial<Pick<WidgetDefinition, 'title' | 'width' | 'minWidth' | 'maxWidth' | 'fill' | 'locked' | 'options' | 'views' | 'defaultView'>>;
 /**
  * Reads the `settings` field of a saved layout. Anything malformed is
  * dropped (wrong types, titles over the limit are cut, widths outside 2 to
@@ -999,6 +1117,8 @@ interface WidgetSettingsPatch {
     readonly flexible?: boolean | undefined;
     /** Replaces all of the widget's option values (`undefined` clears them). */
     readonly options?: Readonly<Record<string, OptionValue>> | undefined;
+    /** The view key (`base` or a declared view); `undefined` clears it. */
+    readonly view?: string | undefined;
 }
 type LayoutWithSettings<L> = L & {
     readonly settings?: LayoutSettings;
@@ -1072,6 +1192,12 @@ interface DashboardLayout {
      * widget key. See `settings.ts`. Absent when they chose nothing.
      */
     readonly settings?: LayoutSettings;
+    /**
+     * Widgets the viewer made from others, as `{ key, from }`. Their settings
+     * live in `settings` under their own key. See `clones.ts`. Absent when
+     * there are none.
+     */
+    readonly clones?: readonly WidgetClone[];
 }
 /** One page of a paged layout: the same lists as a layout, plus a name. */
 interface LayoutPage {
@@ -1170,6 +1296,71 @@ interface EnforceLocksOptions {
  */
 declare function enforceLocks<T extends LayoutItem>(definitions: readonly T[], layout: DashboardLayout, options?: EnforceLocksOptions): DashboardLayout;
 
+/** 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>;
+/** One row of a placed grid: the widgets in it and their final column spans. */
+interface PlacedRow {
+    readonly keys: readonly string[];
+    /** Column spans, in `keys` order, after width-fillers took the leftovers. */
+    readonly spans: readonly number[];
+}
+/**
+ * The rows `items` occupy in a 12-column grid, exactly as `fillWidthSpans`
+ * places them: left to right, a widget that doesn't fit in the rest of a row
+ * starts the next row whole (a widget is never split), and width-fillers then
+ * grow into the leftover columns. Growth never changes how many rows there
+ * are.
+ */
+declare function placeRows(items: readonly GridItem[]): readonly PlacedRow[];
+/**
+ * How many of `items`, in order, fit in `maxRows` rows of a 12-column grid.
+ * Placement is left to right, so this is the length of the longest prefix
+ * whose rows number at most `maxRows`.
+ */
+declare function fitCount(items: readonly GridItem[], maxRows: number): number;
+
 /**
  * Pages of widgets: a dashboard split into pages, like the home screens of a
  * phone. Each page is a small layout (order, hidden, minimized) with a name
@@ -1471,4 +1662,4 @@ interface LayoutPersistence {
  */
 declare function createLayoutPersistence(adapter: StorageAdapter, options?: LayoutPersistenceOptions): LayoutPersistence;
 
-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 };
+export { DEFAULT_MAX_LAYOUT_BYTES as $, type AlertListWidgetData as A, type BarListWidgetData as B, type CloneOptions as C, type DashboardWidget as D, type BooleanOption as E, type CachedPayload as F, type GraphWidgetData as G, type ChoiceOption as H, type CloneItem as I, type ColorOption as J, type KpiWidgetData as K, type Locale as L, type ColumnsOption as M, type NiceDomain as N, type OptionValues as O, type PageItem as P, type ConflictPolicy as Q, type ResolvedTableControls as R, type StoreScope as S, type TableWidgetData as T, type ConvertViewOptions as U, DATE_RANGE_PRESETS as V, type WidgetSize as W, DEFAULT_COMPARISON_LABEL as X, DEFAULT_CURRENCY as Y, DEFAULT_DETAIL_PAGE_SIZE as Z, DEFAULT_EMPTY_TEXT as _, type WidgetFill as a, type SortOption as a$, DEFAULT_PAGE_KEY as a0, DEFAULT_PAGE_ROWS as a1, DETAIL_MODES as a2, type DateRangeOption as a3, type DateRangePreset as a4, type DeltaDirection as a5, type DeltaSentiment as a6, type DetailCell as a7, type DetailColumn as a8, type DetailMode as a9, MAX_PARSED_CLONES as aA, MAX_PARSED_PAGES as aB, MAX_PARSED_SETTINGS as aC, MAX_TEXT_OPTION_LENGTH as aD, MAX_WIDGET_OPTIONS as aE, MAX_WIDGET_TITLE_LENGTH as aF, MAX_WIDGET_VIEWS as aG, MAX_WIDGET_WIDTH as aH, MIN_WIDGET_WIDTH as aI, type NormalizeSettingsOptions as aJ, type NumberOption as aK, OPTION_KEY_PATTERN as aL, type Ok as aM, type OkWidget as aN, type OptionContext as aO, type OptionValue as aP, type PageRoom as aQ, type PlacedRow as aR, type ProviderOptions as aS, type ResolvedDetailOptions as aT, type ResolvedWidget as aU, type ResolvedWidgetLock as aV, type RetryOptions as aW, type SaveOptions as aX, type SavedLayout as aY, type SettingsItem as aZ, type SortDirection as a_, type DetailPage as aa, type DetailProvider as ab, type DetailProviders as ac, EMPTY_LAYOUT as ad, type EmptyWidget as ae, type EncodingOptions as af, type EnforceLocksOptions as ag, type Err as ah, type ErrorWidget as ai, type FormatOptions as aj, type GraphPoint as ak, type GraphSeries as al, type GridItem as am, type KpiDelta as an, type KpiDeltaOptions as ao, LAYOUT_ENVELOPE_VERSION as ap, type LayoutItem as aq, type LayoutPage as ar, type LayoutPersistenceOptions as as, type LayoutSettings as at, type LoadedLayout as au, type LoadingWidget as av, MAX_DETAIL_PAGE_SIZE as aw, MAX_GRAPH_SERIES as ax, MAX_PAGE_ROWS as ay, MAX_PAGE_TITLE_LENGTH as az, type WidgetDefinition as b, hasPages as b$, type StorageAdapter as b0, type StorageLogEvent as b1, type StoreErrorCode as b2, type StoreResult as b3, type StoredValue as b4, type TableCell as b5, type TableColumn as b6, type TextOption as b7, VALUE_FORMATS as b8, VIEW_CONVERSIONS as b9, clearWidgetSettings as bA, cloneNumber as bB, coerceOptionValue as bC, convertView as bD, createLayoutPersistence as bE, defaultDetailQuery as bF, defaultOptionValue as bG, defineWidget as bH, deriveDetailData as bI, describeUnknownError as bJ, effectiveDefinitions as bK, effectiveViewKey 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, findView as bW, fitCount as bX, formatCount as bY, formatPercentChange as bZ, formatValue as b_, type ValueFormat as ba, type ViewConversion as bb, type ViewsItem as bc, WIDGET_FILLS as bd, WIDGET_KINDS as be, WIDGET_OPTION_TYPES as bf, WIDGET_SIZES as bg, WIDTH_COLUMNS as bh, type WidgetCache as bi, type WidgetDataOf as bj, type WidgetDetailOptions as bk, type WidgetEmptyState as bl, type WidgetLock as bm, type WidgetOption as bn, type WidgetProvider as bo, type WidgetStatus as bp, type WidgetTableControls as bq, type WidgetView as br, addPage as bs, applyClientOptions as bt, applySettings as bu, applyView as bv, assignPages as bw, baseColumnSpan as bx, cacheKeyFor as by, cleanClones as bz, type DetailProviderOptions as c, resolveWidgetUnapplied as c$, hasViews as c0, hiddenWidgets as c1, hideWidget as c2, isClientApplied as c3, isColumnKeyFor as c4, isFlexible as c5, isHidden as c6, isIsoInterval as c7, isMinimized as c8, isOptionsLocked as c9, optionValuesFromLayout as cA, optionsCacheSuffix as cB, pageLayout as cC, pageList as cD, pageOf as cE, pageRoom as cF, pageWidgets as cG, parseClones as cH, parseDetailQuery as cI, parseLayout as cJ, parseSettings as cK, parseSortValue as cL, percentChange as cM, placeRows as cN, pruneLayout as cO, queryRows as cP, readOnly as cQ, removePage as cR, renamePage as cS, resolveDateRange as cT, resolveDetailOptions as cU, resolveOptionValues as cV, resolvePageKey as cW, resolvePayload as cX, resolveTableControls as cY, resolveWidget as cZ, resolveWidgetLock as c_, isTitleInUse as ca, isWidgetEmptyState as cb, isWidgetKind as cc, isWidgetVisibleTo as cd, isWidgetWidth as ce, itemWidth as cf, kindLabel as cg, kpiDelta as ch, labelStride as ci, loadingWidgets as cj, memoryAdapter as ck, minimizeWidget as cl, movePage as cm, moveWidget as cn, moveWidgetBy as co, moveWidgetDown as cp, moveWidgetToPage as cq, moveWidgetUp as cr, nextPageKey as cs, niceDomain as ct, niceStep as cu, normalizeLayout as cv, normalizeSettings as cw, normalizeTitle as cx, ok as cy, optionValuesFor as cz, type DetailData as d, resolveWidgets as d0, restoreWidget as d1, sameOptionValues as d2, serializeClones as d3, serializeDetailQuery as d4, serializeLayout as d5, serializeSettings as d6, setWidgetSettings as d7, shareOf as d8, showWidget as d9, sortDefinitions as da, sortFromOptions as db, tableDetailData as dc, toggleHidden as dd, toggleMinimized as de, usesWidthColumns as df, utf8Length as dg, validateDetailData as dh, viewChoices as di, viewKind as dj, viewNote as dk, visibleWidgets as dl, widgetOptionValues as dm, widgetsFor as dn, widthForSize as dp, widthRange as dq, widthShareLabel as dr, withClones as ds, withEncoding as dt, withFallback as du, withLogging as dv, withPageLayout as dw, withPrefix as dx, withReadCache as dy, withRetry as dz, 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 PageOptions as r, type Result as s, type WidgetClone as t, type WidgetKind as u, type WidgetPayload as v, type AddPageOptions as w, type AlertListItem as x, BASE_VIEW_KEY as y, type BarListItem as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@richardmcquiston01/dashboard-widgets-toolkit",
-  "version": "0.14.0",
+  "version": "0.16.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",