@dou-ui/dashboard 0.1.0-alpha.3 → 0.1.0-alpha.5

package/dist/types/dashboard/dashboard.vue.d.ts

@@ -15,19 +15,31 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_PublicProps, Das
     breakpointChange: (breakpoint: string) => any;
     "update:filters": (value: DashboardFilters) => any;
     exportError: (event: DashboardExportErrorEvent) => any;
+    widgetError: (event: import("./types").DashboardWidgetErrorEvent) => any;
+    "update:comments": (threads: import("dou-ui").CommentThread[]) => any;
+    "update:activeComment": (id: string | null) => any;
+    commentAction: (action: import("dou-ui").CommentAction) => any;
 }, string, import("vue").PublicProps, Readonly<__VLS_PublicProps> & Readonly<{
     onChange?: ((transaction: DashboardTransaction) => any) | undefined;
     "onUpdate:modelValue"?: ((value: DashboardDocument) => any) | undefined;
     onBreakpointChange?: ((breakpoint: string) => any) | undefined;
     "onUpdate:filters"?: ((value: DashboardFilters) => any) | undefined;
     onExportError?: ((event: DashboardExportErrorEvent) => any) | undefined;
+    onWidgetError?: ((event: import("./types").DashboardWidgetErrorEvent) => any) | undefined;
+    "onUpdate:comments"?: ((threads: import("dou-ui").CommentThread[]) => any) | undefined;
+    "onUpdate:activeComment"?: ((id: string | null) => any) | undefined;
+    onCommentAction?: ((action: import("dou-ui").CommentAction) => any) | undefined;
 }>, {
+    comments: import("dou-ui").CommentThread[];
     columns: number | Record<string, number>;
     breakpoints: Record<string, number>;
     rowHeight: number;
     gap: number | [number, number];
     compact: import("..").GridCompact;
     widgets: DashboardWidgetType<any>[];
+    author: import("dou-ui").CommentAuthor;
+    activeComment: string | null;
+    commentable: boolean;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const _default: typeof __VLS_export;
 export default _default;

package/dist/types/dashboard/error-boundary.d.ts

@@ -0,0 +1,12 @@
+import type { Ref } from 'vue';
+/**
+ * Whether an error broke what a component shows. Errors in event handlers,
+ * watchers and the like leave it showing: they go on to the app as usual.
+ */
+export declare function breaksView(info: string): boolean;
+/**
+ * Keeps an error that breaks a widget's content or settings in that part:
+ * `failed` turns on, `report` is told, and the error goes no further. The
+ * caller shows the error state and turns `failed` off to try again.
+ */
+export declare function useErrorBoundary(label: () => string, report: (error: unknown) => void): Ref<boolean>;

package/dist/types/dashboard/frame-context.d.ts

@@ -1,6 +1,7 @@
 import type { SheetWorkbook } from '@dou-ui/sheet/core';
 import type { Component, InjectionKey } from 'vue';
 import type { DashboardPeer } from '../core/collaboration';
+import type { DashboardComments } from './comments';
 import type { DashboardWidget } from '../core/types';
 import type { DashboardLinkedFilter } from '../data/types';
 import type { DashboardMessages } from '../locale';
@@ -18,6 +19,7 @@ export interface FrameExporter {
  * that widget's frame again, not every frame on the grid.
  */
 export interface FrameContext {
+    comments: DashboardComments;
     widget: (id: string) => DashboardWidget | undefined;
     type: (widget: DashboardWidget) => DashboardWidgetType<any> | undefined;
     title: (widget: DashboardWidget) => string;
@@ -50,5 +52,7 @@ export interface FrameContext {
     /** Why the last export from a widget's menu failed. */
     exportError: (id: string) => string | undefined;
     clearExportError: (id: string) => void;
+    /** A widget's content broke, for `widgetError`. */
+    reportError: (id: string, error: unknown) => void;
 }
 export declare const frameContextKey: InjectionKey<FrameContext>;

package/dist/types/dashboard/types.d.ts

@@ -1,3 +1,4 @@
+import type { CommentAction, CommentAuthor, CommentThread } from 'dou-ui';
 import type { SheetExporterOptionsOf } from '@dou-ui/sheet';
 import type { SheetExporter } from '@dou-ui/sheet/core';
 import type { DashboardCollaboration } from '../core/collaboration';
@@ -8,6 +9,10 @@ import type { GridCompact } from '../layout/types';
 import type { DashboardMessagesOverride } from '../locale';
 import type { DashboardWidgetType } from '../widget/define';
 import type { DashboardImageOptions } from './export';
+/** What a comment thread is about: a widget. */
+export interface DashboardCommentAnchor {
+    widget: string;
+}
 export interface DashboardProps {
     /** The dashboard, bound with `v-model`; a new document object after every change. */
     modelValue?: DashboardDocument;
@@ -58,6 +63,18 @@ export interface DashboardProps {
      * such as PNG, are left out.
      */
     exporters?: readonly SheetExporter[];
+    /**
+     * The comment threads, bound with `v-model:comments`. The widget a thread
+     * is about keeps the thread's id in its `comments`. Left out, there are
+     * no comments.
+     */
+    comments?: CommentThread[];
+    /** Who is commenting. Without it comments can be read but not written. */
+    author?: CommentAuthor;
+    /** The thread open now, bound with `v-model:activeComment`. */
+    activeComment?: string | null;
+    /** Threads can be started and replied to; also while not `editable`. On by default. */
+    commentable?: boolean;
 }
 /** Options of a dashboard's `exportWidget`. */
 export interface DashboardExportOptions<Options = any> {
@@ -71,6 +88,17 @@ export interface DashboardSaveOptions<Options = any> extends DashboardExportOpti
     /** The file's name, with its extension; the widget's title by default. */
     fileName?: string;
 }
+/**
+ * A widget's component threw while setting up or drawing its content or
+ * settings form; that part shows an error with a retry button instead.
+ */
+export interface DashboardWidgetErrorEvent {
+    /** The widget's id. */
+    widget: string;
+    /** Which part broke: what the widget shows, or its settings form. */
+    part: 'content' | 'settings';
+    error: unknown;
+}
 /** A widget's export from its menu failed. */
 export interface DashboardExportErrorEvent {
     /** The widget's id. */
@@ -92,6 +120,16 @@ export interface DashboardEmits {
     breakpointChange: [breakpoint: string];
     /** Exporting a widget from its menu or `saveWidget` failed; the widget tells of it unless prevented. */
     exportError: [event: DashboardExportErrorEvent];
+    /**
+     * A widget's content or settings form threw while it set up or drew; it
+     * shows an error in its place, and the error goes no further. To report
+     * to error tracking.
+     */
+    widgetError: [event: DashboardWidgetErrorEvent];
+    'update:comments': [threads: CommentThread[]];
+    'update:activeComment': [id: string | null];
+    /** A change to the comments made here: to send to a server, notify people, keep a log. */
+    commentAction: [action: CommentAction];
 }
 export interface DashboardAddOptions {
     /** Where on the widest breakpoint; defaults to the first spot it fits. */
@@ -114,6 +152,15 @@ export interface DashboardExpose {
     /** Adds a widget of a registered type; returns its id, or `undefined` for an unknown type. */
     addWidget: (type: string, options?: DashboardAddOptions) => string | undefined;
     removeWidget: (id: string) => void;
+    /**
+     * Opens the open threads on a widget (the one holding the focus when
+     * left out), ready to reply, or starts one there; `false` when there is
+     * no such widget, comments are off, or there is nothing to open and
+     * comments can't be written.
+     */
+    comment: (id?: string) => boolean;
+    /** The widget each thread is about; `null` when it is gone. Not reactive. */
+    getCommentAnchors: () => Record<string, DashboardCommentAnchor | null>;
     /** Adds a copy of a widget next to it; returns the copy's id. */
     duplicateWidget: (id: string) => string | undefined;
     focusWidget: (id: string) => void;

package/dist/types/dashboard/widget-body.vue.d.ts

@@ -13,6 +13,8 @@ type __VLS_Props = {
     }) => void;
     /** Where the widget's workbook goes, for its export menu; the full-screen copy has none. */
     setWorkbook?: (id: string, get: () => SheetWorkbook | undefined) => () => void;
+    /** Told when the widget's content breaks, for the dashboard's `widgetError`. */
+    reportError?: (id: string, error: unknown) => void;
 };
 declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const _default: typeof __VLS_export;

package/dist/types/dashboard/widget-settings.vue.d.ts

@@ -1,11 +1,15 @@
 import type { DashboardWidget } from '../core/types';
+import type { DashboardMessages } from '../locale';
 import type { DashboardWidgetType } from '../widget/define';
 type __VLS_Props = {
     widget: DashboardWidget;
     type: DashboardWidgetType<any>;
+    messages: DashboardMessages;
     setProps: (id: string, patch: Record<string, unknown>, options?: {
         group?: string;
     }) => void;
+    /** Told when the settings form breaks, for the dashboard's `widgetError`. */
+    reportError?: (id: string, error: unknown) => void;
 };
 declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     "update:props": (props: Record<string, unknown>) => any;

package/dist/types/index.d.ts

@@ -154,6 +154,7 @@ export declare const DouGridLayoutHandle: import("dou-ui").WithInstall<{
     };
 }), import("vue").HTMLAttributes>;
 export declare const DouDashboard: import("dou-ui").WithInstall<import("vue").DefineComponent<{
+    comments?: import("dou-ui").CommentThread[] | undefined;
     columns?: (number | Record<string, number>) | undefined;
     editable?: boolean | undefined;
     label?: string | undefined;
@@ -167,6 +168,9 @@ export declare const DouDashboard: import("dou-ui").WithInstall<import("vue").De
     createId?: ((type: string) => string) | undefined;
     collaboration?: import("./index.js").DashboardCollaboration | undefined;
     exporters?: readonly import("@dou-ui/sheet").SheetExporter[] | undefined;
+    author?: import("dou-ui").CommentAuthor | undefined;
+    activeComment?: string | null | undefined;
+    commentable?: boolean | undefined;
 } & {
     modelValue?: import("./index.js").DashboardDocument;
     filters?: import("./index.js").DashboardFilters;
@@ -176,7 +180,12 @@ export declare const DouDashboard: import("dou-ui").WithInstall<import("vue").De
     breakpointChange: (breakpoint: string) => any;
     "update:filters": (value: import("./index.js").DashboardFilters) => any;
     exportError: (event: import("./index.js").DashboardExportErrorEvent) => any;
+    widgetError: (event: import("./index.js").DashboardWidgetErrorEvent) => any;
+    "update:comments": (threads: import("dou-ui").CommentThread[]) => any;
+    "update:activeComment": (id: string | null) => any;
+    commentAction: (action: import("dou-ui").CommentAction) => any;
 }, string, import("vue").PublicProps, Readonly<{
+    comments?: import("dou-ui").CommentThread[] | undefined;
     columns?: (number | Record<string, number>) | undefined;
     editable?: boolean | undefined;
     label?: string | undefined;
@@ -190,6 +199,9 @@ export declare const DouDashboard: import("dou-ui").WithInstall<import("vue").De
     createId?: ((type: string) => string) | undefined;
     collaboration?: import("./index.js").DashboardCollaboration | undefined;
     exporters?: readonly import("@dou-ui/sheet").SheetExporter[] | undefined;
+    author?: import("dou-ui").CommentAuthor | undefined;
+    activeComment?: string | null | undefined;
+    commentable?: boolean | undefined;
 } & {
     modelValue?: import("./index.js").DashboardDocument;
     filters?: import("./index.js").DashboardFilters;
@@ -199,13 +211,21 @@ export declare const DouDashboard: import("dou-ui").WithInstall<import("vue").De
     onBreakpointChange?: ((breakpoint: string) => any) | undefined;
     "onUpdate:filters"?: ((value: import("./index.js").DashboardFilters) => any) | undefined;
     onExportError?: ((event: import("./index.js").DashboardExportErrorEvent) => any) | undefined;
+    onWidgetError?: ((event: import("./index.js").DashboardWidgetErrorEvent) => any) | undefined;
+    "onUpdate:comments"?: ((threads: import("dou-ui").CommentThread[]) => any) | undefined;
+    "onUpdate:activeComment"?: ((id: string | null) => any) | undefined;
+    onCommentAction?: ((action: import("dou-ui").CommentAction) => any) | undefined;
 }>, {
+    comments: import("dou-ui").CommentThread[];
     columns: number | Record<string, number>;
     breakpoints: Record<string, number>;
     rowHeight: number;
     gap: number | [number, number];
     compact: import("./layout").GridCompact;
     widgets: import("./index.js").DashboardWidgetType<any>[];
+    author: import("dou-ui").CommentAuthor;
+    activeComment: string | null;
+    commentable: boolean;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>, import("vue").HTMLAttributes>;
 export declare const DouDashboardPalette: import("dou-ui").WithInstall<{
     new (...args: any[]): import("vue").CreateComponentPublicInstanceWithMixins<Readonly<import("./index.js").DashboardPaletteProps> & Readonly<{}>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, import("vue").PublicProps, {
@@ -264,11 +284,12 @@ export declare const DouDashboardFilterBar: import("dou-ui").WithInstall<{
         default?: () => unknown;
     };
 }), import("vue").HTMLAttributes>;
-export type { DashboardAddOptions, DashboardEmits, DashboardExportErrorEvent, DashboardExportOptions, DashboardSaveOptions, DashboardExpose, DashboardFilterBarProps, DashboardPaletteProps, DashboardProps, } from './dashboard/types';
+export type { DashboardAddOptions, DashboardEmits, DashboardExportErrorEvent, DashboardWidgetErrorEvent, DashboardExportOptions, DashboardSaveOptions, DashboardCommentAnchor, DashboardExpose, DashboardFilterBarProps, DashboardPaletteProps, DashboardProps, } from './dashboard/types';
 export type { DashboardDocument, DashboardPlace, DashboardWidget } from './core/types';
 export { checkDocument, emptyDocument, isDashboardPlace, migrateDocument } from './core/document';
 export type { CheckDocumentOptions, DocumentProblem } from './core/document';
 export { applySteps, DashboardTransaction, replaceWidgets, sameValue } from './core/transaction';
+export type { ReplaceWidgetsOptions } from './core/transaction';
 export type { DashboardCollaboration, DashboardCollaborationHost, DashboardPeer, DashboardPresence, DashboardPresenceAction, } from './core/collaboration';
 export type { DashboardStep, DashboardTransactionMeta, DashboardWidgetPatch, } from './core/transaction';
 export { DashboardHistory } from './core/history';

package/dist/types/locale.d.ts

@@ -37,6 +37,10 @@ export interface DashboardMessages {
     nothingToExport: string;
     duplicate: string;
     remove: string;
+    /** The comment button and the card of a widget's discussions. */
+    comment: string;
+    /** The comment button of a widget with discussions; `{count}` is how many are open. */
+    comments: string;
     /** The settings drawer's title: `{title}`. */
     settingsTitle: string;
     /** The title field in the settings drawer. */
@@ -49,6 +53,10 @@ export interface DashboardMessages {
     /** A widget's status. */
     loading: string;
     error: string;
+    /** A widget that failed to show, e.g. for props it can't use. */
+    renderError: string;
+    /** A widget's settings form that failed to show. */
+    settingsError: string;
     empty: string;
     retry: string;
     /** A dashboard without widgets, while editing. */

package/dist/types/pivot/read-props.d.ts

@@ -0,0 +1,3 @@
+import type { PivotWidgetProps } from './types';
+/** The pivot widget's props as its type says; what isn't the right type counts as not set. */
+export declare function pivotPropsOf(props: Record<string, unknown>): PivotWidgetProps;

package/dist/types/widgets/index.d.ts

@@ -1,7 +1,7 @@
 import type { DashboardWidgetType } from '../widget/define';
 import type { StatWidgetProps, TableWidgetProps, TextWidgetProps } from './types';
 export type { StatWidgetProps, TableWidgetColumn, TableWidgetProps, TextWidgetProps } from './types';
-export { fieldsOf, filterValueOf, numberFieldsOf, rowsOf, valueAt } from './shared';
+export { fieldsOf, filterValueOf, flagOf, numberFieldsOf, numberOf, recordOf, rowsOf, textOf, textsOf, valueAt, } from './shared';
 /** What a built-in widget's definition can change: its type, label, icon, size and more. */
 export type WidgetOverrides<P extends object> = Partial<Omit<DashboardWidgetType<P>, 'component'>>;
 /**

package/dist/types/widgets/read-props.d.ts

@@ -0,0 +1,4 @@
+import type { StatWidgetProps, TableWidgetProps, TextWidgetProps } from './types';
+export declare function statPropsOf(props: Record<string, unknown>): StatWidgetProps;
+export declare function textPropsOf(props: Record<string, unknown>): TextWidgetProps;
+export declare function tablePropsOf(props: Record<string, unknown>): TableWidgetProps;

package/dist/types/widgets/shared.d.ts

@@ -1,8 +1,24 @@
 import type { SheetWorkbook } from '@dou-ui/sheet/core';
-/** The value at a dotted path, e.g. `total.amount`; the data itself for an empty path. */
-export declare function valueAt(data: unknown, path: string | undefined): unknown;
-/** The rows of a source's data: the data when it is a list, or the list at `path`. */
-export declare function rowsOf(data: unknown, path?: string): Record<string, unknown>[];
+/**
+ * The value at a dotted path, e.g. `total.amount`; the data itself for an
+ * empty path. A path that isn't text, e.g. a number in JSON written by hand
+ * or by a program, finds nothing.
+ */
+export declare function valueAt(data: unknown, path: unknown): unknown;
+/** The rows of a source's data: the data when it is a list, or the list at `path`. Items that aren't objects are left out. */
+export declare function rowsOf(data: unknown, path?: unknown): Record<string, unknown>[];
+/** Text, or not set. */
+export declare const textOf: (value: unknown) => string | undefined;
+/** A list of texts: the texts in it, or none. */
+export declare const textsOf: (value: unknown) => string[];
+/** A finite number, or text that is one (`'12'`, as a number read from data); otherwise not set. */
+export declare function numberOf(value: unknown): number | undefined;
+/** On only for `true`: `'no'` or `1` don't turn a switch on. */
+export declare const flagOf: (value: unknown) => boolean;
+/** A plain object, not a list; otherwise not set. */
+export declare const recordOf: (value: unknown) => Record<string, unknown> | undefined;
+/** One of the values listed, or not set. */
+export declare const oneOf: <T extends string>(value: unknown, values: readonly T[]) => T | undefined;
 /** The keys of the first row of a list, or of an object: the fields to pick from in settings. */
 export declare function fieldsOf(data: unknown): string[];
 /** The keys whose value in the first row is a number. */

package/dist/widgets/index.js

@@ -1,5 +1,5 @@
 import { defineDashboardWidget } from "../widget/define.js";
-import { fieldsOf, filterValueOf, numberFieldsOf, rowsOf, valueAt } from "./shared.js";
+import { fieldsOf, filterValueOf, flagOf, numberFieldsOf, numberOf, recordOf, rowsOf, textOf, textsOf, valueAt } from "./shared.js";
 import stat_default from "./stat.js";
 import stat_settings_default from "./stat-settings.js";
 import table_default from "./table.js";
@@ -69,6 +69,6 @@ function tableWidget(overrides = {}) {
 		...overrides
 	});
 }
-export { fieldsOf, filterValueOf, numberFieldsOf, rowsOf, statWidget, tableWidget, textWidget, valueAt };
+export { fieldsOf, filterValueOf, flagOf, numberFieldsOf, numberOf, recordOf, rowsOf, statWidget, tableWidget, textOf, textWidget, textsOf, valueAt };
 
 //# sourceMappingURL=index.js.map

package/dist/widgets/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["Stat","StatSettings","Text","TextSettings","Table","TableSettings"],"sources":["../../src/widgets/index.ts"],"sourcesContent":["import { HashIcon, TableIcon, TypeIcon } from '@dou-ui/icons'\nimport { defineDashboardWidget } from '../widget/define'\nimport type { DashboardWidgetType } from '../widget/define'\nimport Stat from './stat.vue'\nimport StatSettings from './stat-settings.vue'\nimport Table from './table.vue'\nimport TableSettings from './table-settings.vue'\nimport Text from './text.vue'\nimport TextSettings from './text-settings.vue'\nimport type { StatWidgetProps, TableWidgetProps, TextWidgetProps } from './types'\n\nexport type { StatWidgetProps, TableWidgetColumn, TableWidgetProps, TextWidgetProps } from './types'\nexport { fieldsOf, filterValueOf, numberFieldsOf, rowsOf, valueAt } from './shared'\n\n/** What a built-in widget's definition can change: its type, label, icon, size and more. */\nexport type WidgetOverrides<P extends object> = Partial<Omit<DashboardWidgetType<P>, 'component'>>\n\n/**\n * A number, read from a source or given, with its change since the last\n * period and a sparkline under it.\n */\nexport function statWidget(overrides: WidgetOverrides<StatWidgetProps> = {}) {\n  return defineDashboardWidget<StatWidgetProps>({\n    type: 'stat',\n    label: '统计数字',\n    icon: HashIcon,\n    size: { w: 3, h: 2, minW: 2, minH: 2 },\n    defaultProps: { value: 0 },\n    component: Stat,\n    settings: StatSettings,\n    fullscreen: false,\n    ...overrides,\n  })\n}\n\n/** A note: plain text in three sizes, its line breaks kept. */\nexport function textWidget(overrides: WidgetOverrides<TextWidgetProps> = {}) {\n  return defineDashboardWidget<TextWidgetProps>({\n    type: 'text',\n    label: '文字',\n    icon: TypeIcon,\n    size: { w: 4, h: 2, minW: 2, minH: 1 },\n    defaultProps: { text: '', size: 'md' },\n    component: Text,\n    settings: TextSettings,\n    fullscreen: false,\n    ...overrides,\n  })\n}\n\n/** A source's rows in a table, with the columns picked in its settings. */\nexport function tableWidget(overrides: WidgetOverrides<TableWidgetProps> = {}) {\n  return defineDashboardWidget<TableWidgetProps>({\n    type: 'table',\n    label: '表格',\n    icon: TableIcon,\n    size: { w: 6, h: 4, minW: 3, minH: 3 },\n    component: Table,\n    settings: TableSettings,\n    ...overrides,\n  })\n}\n"],"mappings":";;;;;;;;;;;;;;AAqBA,SAAgB,WAAW,YAA8C,CAAC,GAAG;CAC3E,OAAO,sBAAuC;EAC5C,MAAM;EACN,OAAO;EACP,MAAM;EACN,MAAM;GAAE,GAAG;GAAG,GAAG;GAAG,MAAM;GAAG,MAAM;EAAE;EACrC,cAAc,EAAE,OAAO,EAAE;EACzB,WAAWA;EACX,UAAUC;EACV,YAAY;EACZ,GAAG;CACL,CAAC;AACH;;AAGA,SAAgB,WAAW,YAA8C,CAAC,GAAG;CAC3E,OAAO,sBAAuC;EAC5C,MAAM;EACN,OAAO;EACP,MAAM;EACN,MAAM;GAAE,GAAG;GAAG,GAAG;GAAG,MAAM;GAAG,MAAM;EAAE;EACrC,cAAc;GAAE,MAAM;GAAI,MAAM;EAAK;EACrC,WAAWC;EACX,UAAUC;EACV,YAAY;EACZ,GAAG;CACL,CAAC;AACH;;AAGA,SAAgB,YAAY,YAA+C,CAAC,GAAG;CAC7E,OAAO,sBAAwC;EAC7C,MAAM;EACN,OAAO;EACP,MAAM;EACN,MAAM;GAAE,GAAG;GAAG,GAAG;GAAG,MAAM;GAAG,MAAM;EAAE;EACrC,WAAWC;EACX,UAAUC;EACV,GAAG;CACL,CAAC;AACH"}
+{"version":3,"file":"index.js","names":["Stat","StatSettings","Text","TextSettings","Table","TableSettings"],"sources":["../../src/widgets/index.ts"],"sourcesContent":["import { HashIcon, TableIcon, TypeIcon } from '@dou-ui/icons'\nimport { defineDashboardWidget } from '../widget/define'\nimport type { DashboardWidgetType } from '../widget/define'\nimport Stat from './stat.vue'\nimport StatSettings from './stat-settings.vue'\nimport Table from './table.vue'\nimport TableSettings from './table-settings.vue'\nimport Text from './text.vue'\nimport TextSettings from './text-settings.vue'\nimport type { StatWidgetProps, TableWidgetProps, TextWidgetProps } from './types'\n\nexport type { StatWidgetProps, TableWidgetColumn, TableWidgetProps, TextWidgetProps } from './types'\nexport {\n  fieldsOf,\n  filterValueOf,\n  flagOf,\n  numberFieldsOf,\n  numberOf,\n  recordOf,\n  rowsOf,\n  textOf,\n  textsOf,\n  valueAt,\n} from './shared'\n\n/** What a built-in widget's definition can change: its type, label, icon, size and more. */\nexport type WidgetOverrides<P extends object> = Partial<Omit<DashboardWidgetType<P>, 'component'>>\n\n/**\n * A number, read from a source or given, with its change since the last\n * period and a sparkline under it.\n */\nexport function statWidget(overrides: WidgetOverrides<StatWidgetProps> = {}) {\n  return defineDashboardWidget<StatWidgetProps>({\n    type: 'stat',\n    label: '统计数字',\n    icon: HashIcon,\n    size: { w: 3, h: 2, minW: 2, minH: 2 },\n    defaultProps: { value: 0 },\n    component: Stat,\n    settings: StatSettings,\n    fullscreen: false,\n    ...overrides,\n  })\n}\n\n/** A note: plain text in three sizes, its line breaks kept. */\nexport function textWidget(overrides: WidgetOverrides<TextWidgetProps> = {}) {\n  return defineDashboardWidget<TextWidgetProps>({\n    type: 'text',\n    label: '文字',\n    icon: TypeIcon,\n    size: { w: 4, h: 2, minW: 2, minH: 1 },\n    defaultProps: { text: '', size: 'md' },\n    component: Text,\n    settings: TextSettings,\n    fullscreen: false,\n    ...overrides,\n  })\n}\n\n/** A source's rows in a table, with the columns picked in its settings. */\nexport function tableWidget(overrides: WidgetOverrides<TableWidgetProps> = {}) {\n  return defineDashboardWidget<TableWidgetProps>({\n    type: 'table',\n    label: '表格',\n    icon: TableIcon,\n    size: { w: 6, h: 4, minW: 3, minH: 3 },\n    component: Table,\n    settings: TableSettings,\n    ...overrides,\n  })\n}\n"],"mappings":";;;;;;;;;;;;;;AAgCA,SAAgB,WAAW,YAA8C,CAAC,GAAG;CAC3E,OAAO,sBAAuC;EAC5C,MAAM;EACN,OAAO;EACP,MAAM;EACN,MAAM;GAAE,GAAG;GAAG,GAAG;GAAG,MAAM;GAAG,MAAM;EAAE;EACrC,cAAc,EAAE,OAAO,EAAE;EACzB,WAAWA;EACX,UAAUC;EACV,YAAY;EACZ,GAAG;CACL,CAAC;AACH;;AAGA,SAAgB,WAAW,YAA8C,CAAC,GAAG;CAC3E,OAAO,sBAAuC;EAC5C,MAAM;EACN,OAAO;EACP,MAAM;EACN,MAAM;GAAE,GAAG;GAAG,GAAG;GAAG,MAAM;GAAG,MAAM;EAAE;EACrC,cAAc;GAAE,MAAM;GAAI,MAAM;EAAK;EACrC,WAAWC;EACX,UAAUC;EACV,YAAY;EACZ,GAAG;CACL,CAAC;AACH;;AAGA,SAAgB,YAAY,YAA+C,CAAC,GAAG;CAC7E,OAAO,sBAAwC;EAC7C,MAAM;EACN,OAAO;EACP,MAAM;EACN,MAAM;GAAE,GAAG;GAAG,GAAG;GAAG,MAAM;GAAG,MAAM;EAAE;EACrC,WAAWC;EACX,UAAUC;EACV,GAAG;CACL,CAAC;AACH"}

package/dist/widgets/read-props.js

@@ -0,0 +1,52 @@
+import { numberOf, oneOf, recordOf, textOf } from "./shared.js";
+// src/widgets/read-props.ts
+function statPropsOf(props) {
+	const precision = numberOf(props.precision);
+	return {
+		source: textOf(props.source),
+		field: textOf(props.field),
+		value: numberOf(props.value),
+		prefix: textOf(props.prefix),
+		suffix: textOf(props.suffix),
+		precision: precision !== void 0 && Number.isInteger(precision) && precision >= 0 && precision <= 20 ? precision : void 0,
+		trend: textOf(props.trend),
+		delta: textOf(props.delta)
+	};
+}
+function textPropsOf(props) {
+	const text = props.text;
+	return {
+		text: typeof text === "number" ? String(text) : textOf(text),
+		size: oneOf(props.size, [
+			"sm",
+			"md",
+			"lg"
+		])
+	};
+}
+/** The columns given, those with a text `key`; not set when not a list. */
+function columnsOf(value) {
+	if (!Array.isArray(value)) return void 0;
+	const columns = [];
+	for (const item of value) {
+		const column = recordOf(item);
+		if (typeof column?.key !== "string") continue;
+		const title = textOf(column.title);
+		columns.push(title === void 0 ? { key: column.key } : {
+			key: column.key,
+			title
+		});
+	}
+	return columns;
+}
+function tablePropsOf(props) {
+	return {
+		source: textOf(props.source),
+		path: textOf(props.path),
+		columns: columnsOf(props.columns),
+		rowKey: textOf(props.rowKey)
+	};
+}
+export { statPropsOf, tablePropsOf, textPropsOf };
+
+//# sourceMappingURL=read-props.js.map

package/dist/widgets/read-props.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-props.js","names":[],"sources":["../../src/widgets/read-props.ts"],"sourcesContent":["import { numberOf, oneOf, recordOf, textOf } from './shared'\nimport type { StatWidgetProps, TableWidgetColumn, TableWidgetProps, TextWidgetProps } from './types'\n\n/*\n * The props of the built-in widgets as their types say, from whatever JSON\n * was saved: what isn't the right type counts as not set. The widgets and\n * their settings both read through these.\n */\n\nexport function statPropsOf(props: Record<string, unknown>): StatWidgetProps {\n  const precision = numberOf(props.precision)\n  return {\n    source: textOf(props.source),\n    field: textOf(props.field),\n    value: numberOf(props.value),\n    prefix: textOf(props.prefix),\n    suffix: textOf(props.suffix),\n    precision:\n      precision !== undefined && Number.isInteger(precision) && precision >= 0 && precision <= 20\n        ? precision\n        : undefined,\n    trend: textOf(props.trend),\n    delta: textOf(props.delta),\n  }\n}\n\nexport function textPropsOf(props: Record<string, unknown>): TextWidgetProps {\n  const text = props.text\n  return {\n    text: typeof text === 'number' ? String(text) : textOf(text),\n    size: oneOf(props.size, ['sm', 'md', 'lg'] as const),\n  }\n}\n\n/** The columns given, those with a text `key`; not set when not a list. */\nfunction columnsOf(value: unknown): TableWidgetColumn[] | undefined {\n  if (!Array.isArray(value)) return undefined\n  const columns: TableWidgetColumn[] = []\n  for (const item of value) {\n    const column = recordOf(item)\n    if (typeof column?.key !== 'string') continue\n    const title = textOf(column.title)\n    columns.push(title === undefined ? { key: column.key } : { key: column.key, title })\n  }\n  return columns\n}\n\nexport function tablePropsOf(props: Record<string, unknown>): TableWidgetProps {\n  return {\n    source: textOf(props.source),\n    path: textOf(props.path),\n    columns: columnsOf(props.columns),\n    rowKey: textOf(props.rowKey),\n  }\n}\n"],"mappings":";;AASA,SAAgB,YAAY,OAAiD;CAC3E,MAAM,YAAY,SAAS,MAAM,SAAS;CAC1C,OAAO;EACL,QAAQ,OAAO,MAAM,MAAM;EAC3B,OAAO,OAAO,MAAM,KAAK;EACzB,OAAO,SAAS,MAAM,KAAK;EAC3B,QAAQ,OAAO,MAAM,MAAM;EAC3B,QAAQ,OAAO,MAAM,MAAM;EAC3B,WACE,cAAc,KAAA,KAAa,OAAO,UAAU,SAAS,KAAK,aAAa,KAAK,aAAa,KACrF,YACA,KAAA;EACN,OAAO,OAAO,MAAM,KAAK;EACzB,OAAO,OAAO,MAAM,KAAK;CAC3B;AACF;AAEA,SAAgB,YAAY,OAAiD;CAC3E,MAAM,OAAO,MAAM;CACnB,OAAO;EACL,MAAM,OAAO,SAAS,WAAW,OAAO,IAAI,IAAI,OAAO,IAAI;EAC3D,MAAM,MAAM,MAAM,MAAM;GAAC;GAAM;GAAM;EAAI,CAAU;CACrD;AACF;;AAGA,SAAS,UAAU,OAAiD;CAClE,IAAI,CAAC,MAAM,QAAQ,KAAK,GAAG,OAAO,KAAA;CAClC,MAAM,UAA+B,CAAC;CACtC,KAAK,MAAM,QAAQ,OAAO;EACxB,MAAM,SAAS,SAAS,IAAI;EAC5B,IAAI,OAAO,QAAQ,QAAQ,UAAU;EACrC,MAAM,QAAQ,OAAO,OAAO,KAAK;EACjC,QAAQ,KAAK,UAAU,KAAA,IAAY,EAAE,KAAK,OAAO,IAAI,IAAI;GAAE,KAAK,OAAO;GAAK;EAAM,CAAC;CACrF;CACA,OAAO;AACT;AAEA,SAAgB,aAAa,OAAkD;CAC7E,OAAO;EACL,QAAQ,OAAO,MAAM,MAAM;EAC3B,MAAM,OAAO,MAAM,IAAI;EACvB,SAAS,UAAU,MAAM,OAAO;EAChC,QAAQ,OAAO,MAAM,MAAM;CAC7B;AACF"}

package/dist/widgets/shared.js

@@ -1,7 +1,12 @@
 // src/widgets/shared.ts
-/** The value at a dotted path, e.g. `total.amount`; the data itself for an empty path. */
+/**
+* The value at a dotted path, e.g. `total.amount`; the data itself for an
+* empty path. A path that isn't text, e.g. a number in JSON written by hand
+* or by a program, finds nothing.
+*/
 function valueAt(data, path) {
-	if (!path) return data;
+	if (path === void 0 || path === null || path === "") return data;
+	if (typeof path !== "string") return void 0;
 	let value = data;
 	for (const key of path.split(".")) {
 		if (value == null || typeof value !== "object") return void 0;
@@ -9,11 +14,28 @@ function valueAt(data, path) {
 	}
 	return value;
 }
-/** The rows of a source's data: the data when it is a list, or the list at `path`. */
+/** The rows of a source's data: the data when it is a list, or the list at `path`. Items that aren't objects are left out. */
 function rowsOf(data, path) {
 	const value = valueAt(data, path);
-	return Array.isArray(value) ? value : [];
+	if (!Array.isArray(value)) return [];
+	return value.every(isRecord) ? value : value.filter(isRecord);
+}
+var isRecord = (value) => value !== null && typeof value === "object";
+/** Text, or not set. */
+var textOf = (value) => typeof value === "string" ? value : void 0;
+/** A list of texts: the texts in it, or none. */
+var textsOf = (value) => Array.isArray(value) ? value.filter((item) => typeof item === "string") : [];
+/** A finite number, or text that is one (`'12'`, as a number read from data); otherwise not set. */
+function numberOf(value) {
+	const n = typeof value === "number" ? value : typeof value === "string" && value.trim() ? Number(value) : NaN;
+	return Number.isFinite(n) ? n : void 0;
 }
+/** On only for `true`: `'no'` or `1` don't turn a switch on. */
+var flagOf = (value) => value === true;
+/** A plain object, not a list; otherwise not set. */
+var recordOf = (value) => isRecord(value) && !Array.isArray(value) ? value : void 0;
+/** One of the values listed, or not set. */
+var oneOf = (value, values) => values.includes(value) ? value : void 0;
 /** The keys of the first row of a list, or of an object: the fields to pick from in settings. */
 function fieldsOf(data) {
 	const first = Array.isArray(data) ? data[0] : data;
@@ -63,6 +85,6 @@ function rowsToWorkbook(name, columns, rows) {
 		styles: { head: { bold: true } }
 	};
 }
-export { fieldsOf, filterValueOf, numberFieldsOf, rowsOf, rowsToWorkbook, valueAt };
+export { fieldsOf, filterValueOf, flagOf, numberFieldsOf, numberOf, oneOf, recordOf, rowsOf, rowsToWorkbook, textOf, textsOf, valueAt };
 
 //# sourceMappingURL=shared.js.map

package/dist/widgets/shared.js.map

@@ -1 +1 @@
-{"version":3,"file":"shared.js","names":[],"sources":["../../src/widgets/shared.ts"],"sourcesContent":["import type { SheetValue, SheetWorkbook } from '@dou-ui/sheet/core'\n\n/** The value at a dotted path, e.g. `total.amount`; the data itself for an empty path. */\nexport function valueAt(data: unknown, path: string | undefined): unknown {\n  if (!path) return data\n  let value = data\n  for (const key of path.split('.')) {\n    if (value == null || typeof value !== 'object') return undefined\n    value = (value as Record<string, unknown>)[key]\n  }\n  return value\n}\n\n/** The rows of a source's data: the data when it is a list, or the list at `path`. */\nexport function rowsOf(data: unknown, path?: string): Record<string, unknown>[] {\n  const value = valueAt(data, path)\n  return Array.isArray(value) ? (value as Record<string, unknown>[]) : []\n}\n\n/** The keys of the first row of a list, or of an object: the fields to pick from in settings. */\nexport function fieldsOf(data: unknown): string[] {\n  const first = Array.isArray(data) ? data[0] : data\n  return first && typeof first === 'object' && !Array.isArray(first) ? Object.keys(first) : []\n}\n\n/** The keys whose value in the first row is a number. */\nexport function numberFieldsOf(data: unknown): string[] {\n  const first = Array.isArray(data) ? data[0] : data\n  return fieldsOf(data).filter((key) => typeof (first as Record<string, unknown>)[key] === 'number')\n}\n\n/** A filter value from a value of the data: dates as `YYYY-MM-DD`, so the filters stay JSON. */\nconst pad = (n: number) => String(n).padStart(2, '0')\n\nexport function filterValueOf(value: unknown): unknown {\n  if (!(value instanceof Date)) return value\n  return `${value.getFullYear()}-${pad(value.getMonth() + 1)}-${pad(value.getDate())}`\n}\n\n/** A value of the data as a sheet cell's: dates as `YYYY-MM-DD`, text starting with `=` kept as text. */\nfunction sheetValueOf(value: unknown): SheetValue {\n  if (value == null) return null\n  if (typeof value === 'number') return Number.isFinite(value) ? value : null\n  if (typeof value === 'boolean') return value\n  const text = value instanceof Date ? (filterValueOf(value) as string) : String(value)\n  return text.startsWith('=') ? `'${text}` : text\n}\n\n/**\n * Rows of data as a workbook, for the dashboard's export menu: one sheet,\n * a bold head row with the columns' titles, a row per row of data. An\n * empty `name` takes the widget's title.\n */\nexport function rowsToWorkbook(\n  name: string,\n  columns: readonly { key: string; title: string; width?: number }[],\n  rows: readonly Record<string, unknown>[],\n): SheetWorkbook {\n  const colSizes: Record<number, number> = {}\n  columns.forEach((column, i) => column.width && (colSizes[i] = Math.round(column.width)))\n  return {\n    version: 1,\n    sheets: [\n      {\n        name,\n        cells: [\n          columns.map((column) => ({ value: sheetValueOf(column.title), style: 'head' })),\n          ...rows.map((row) => columns.map((column) => sheetValueOf(row[column.key]))),\n        ],\n        freeze: { rows: 1, cols: 0 },\n        colSizes,\n      },\n    ],\n    styles: { head: { bold: true } },\n  }\n}\n"],"mappings":";;AAGA,SAAgB,QAAQ,MAAe,MAAmC;CACxE,IAAI,CAAC,MAAM,OAAO;CAClB,IAAI,QAAQ;CACZ,KAAK,MAAM,OAAO,KAAK,MAAM,GAAG,GAAG;EACjC,IAAI,SAAS,QAAQ,OAAO,UAAU,UAAU,OAAO,KAAA;EACvD,QAAS,MAAkC;CAC7C;CACA,OAAO;AACT;;AAGA,SAAgB,OAAO,MAAe,MAA0C;CAC9E,MAAM,QAAQ,QAAQ,MAAM,IAAI;CAChC,OAAO,MAAM,QAAQ,KAAK,IAAK,QAAsC,CAAC;AACxE;;AAGA,SAAgB,SAAS,MAAyB;CAChD,MAAM,QAAQ,MAAM,QAAQ,IAAI,IAAI,KAAK,KAAK;CAC9C,OAAO,SAAS,OAAO,UAAU,YAAY,CAAC,MAAM,QAAQ,KAAK,IAAI,OAAO,KAAK,KAAK,IAAI,CAAC;AAC7F;;AAGA,SAAgB,eAAe,MAAyB;CACtD,MAAM,QAAQ,MAAM,QAAQ,IAAI,IAAI,KAAK,KAAK;CAC9C,OAAO,SAAS,IAAI,CAAC,CAAC,QAAQ,QAAQ,OAAQ,MAAkC,SAAS,QAAQ;AACnG;;AAGA,IAAM,OAAO,MAAc,OAAO,CAAC,CAAC,CAAC,SAAS,GAAG,GAAG;AAEpD,SAAgB,cAAc,OAAyB;CACrD,IAAI,EAAE,iBAAiB,OAAO,OAAO;CACrC,OAAO,GAAG,MAAM,YAAY,EAAE,GAAG,IAAI,MAAM,SAAS,IAAI,CAAC,EAAE,GAAG,IAAI,MAAM,QAAQ,CAAC;AACnF;;AAGA,SAAS,aAAa,OAA4B;CAChD,IAAI,SAAS,MAAM,OAAO;CAC1B,IAAI,OAAO,UAAU,UAAU,OAAO,OAAO,SAAS,KAAK,IAAI,QAAQ;CACvE,IAAI,OAAO,UAAU,WAAW,OAAO;CACvC,MAAM,OAAO,iBAAiB,OAAQ,cAAc,KAAK,IAAe,OAAO,KAAK;CACpF,OAAO,KAAK,WAAW,GAAG,IAAI,IAAI,SAAS;AAC7C;;;;;;AAOA,SAAgB,eACd,MACA,SACA,MACe;CACf,MAAM,WAAmC,CAAC;CAC1C,QAAQ,SAAS,QAAQ,MAAM,OAAO,UAAU,SAAS,KAAK,KAAK,MAAM,OAAO,KAAK,EAAE;CACvF,OAAO;EACL,SAAS;EACT,QAAQ,CACN;GACE;GACA,OAAO,CACL,QAAQ,KAAK,YAAY;IAAE,OAAO,aAAa,OAAO,KAAK;IAAG,OAAO;GAAO,EAAE,GAC9E,GAAG,KAAK,KAAK,QAAQ,QAAQ,KAAK,WAAW,aAAa,IAAI,OAAO,IAAI,CAAC,CAAC,CAC7E;GACA,QAAQ;IAAE,MAAM;IAAG,MAAM;GAAE;GAC3B;EACF,CACF;EACA,QAAQ,EAAE,MAAM,EAAE,MAAM,KAAK,EAAE;CACjC;AACF"}
+{"version":3,"file":"shared.js","names":[],"sources":["../../src/widgets/shared.ts"],"sourcesContent":["import type { SheetValue, SheetWorkbook } from '@dou-ui/sheet/core'\n\n/**\n * The value at a dotted path, e.g. `total.amount`; the data itself for an\n * empty path. A path that isn't text, e.g. a number in JSON written by hand\n * or by a program, finds nothing.\n */\nexport function valueAt(data: unknown, path: unknown): unknown {\n  if (path === undefined || path === null || path === '') return data\n  if (typeof path !== 'string') return undefined\n  let value = data\n  for (const key of path.split('.')) {\n    if (value == null || typeof value !== 'object') return undefined\n    value = (value as Record<string, unknown>)[key]\n  }\n  return value\n}\n\n/** The rows of a source's data: the data when it is a list, or the list at `path`. Items that aren't objects are left out. */\nexport function rowsOf(data: unknown, path?: unknown): Record<string, unknown>[] {\n  const value = valueAt(data, path)\n  if (!Array.isArray(value)) return []\n  return value.every(isRecord) ? value : value.filter(isRecord)\n}\n\nconst isRecord = (value: unknown): value is Record<string, unknown> =>\n  value !== null && typeof value === 'object'\n\n/*\n * A widget's props come from JSON that types don't check, often written by a\n * program or an AI. These read one prop as the type it is meant to be; any\n * other value counts as not set, so a widget never throws on it.\n */\n\n/** Text, or not set. */\nexport const textOf = (value: unknown): string | undefined =>\n  typeof value === 'string' ? value : undefined\n\n/** A list of texts: the texts in it, or none. */\nexport const textsOf = (value: unknown): string[] =>\n  Array.isArray(value) ? value.filter((item): item is string => typeof item === 'string') : []\n\n/** A finite number, or text that is one (`'12'`, as a number read from data); otherwise not set. */\nexport function numberOf(value: unknown): number | undefined {\n  const n =\n    typeof value === 'number'\n      ? value\n      : typeof value === 'string' && value.trim()\n        ? Number(value)\n        : Number.NaN\n  return Number.isFinite(n) ? n : undefined\n}\n\n/** On only for `true`: `'no'` or `1` don't turn a switch on. */\nexport const flagOf = (value: unknown): boolean => value === true\n\n/** A plain object, not a list; otherwise not set. */\nexport const recordOf = (value: unknown): Record<string, unknown> | undefined =>\n  isRecord(value) && !Array.isArray(value) ? value : undefined\n\n/** One of the values listed, or not set. */\nexport const oneOf = <T extends string>(value: unknown, values: readonly T[]): T | undefined =>\n  values.includes(value as T) ? (value as T) : undefined\n\n/** The keys of the first row of a list, or of an object: the fields to pick from in settings. */\nexport function fieldsOf(data: unknown): string[] {\n  const first = Array.isArray(data) ? data[0] : data\n  return first && typeof first === 'object' && !Array.isArray(first) ? Object.keys(first) : []\n}\n\n/** The keys whose value in the first row is a number. */\nexport function numberFieldsOf(data: unknown): string[] {\n  const first = Array.isArray(data) ? data[0] : data\n  return fieldsOf(data).filter((key) => typeof (first as Record<string, unknown>)[key] === 'number')\n}\n\n/** A filter value from a value of the data: dates as `YYYY-MM-DD`, so the filters stay JSON. */\nconst pad = (n: number) => String(n).padStart(2, '0')\n\nexport function filterValueOf(value: unknown): unknown {\n  if (!(value instanceof Date)) return value\n  return `${value.getFullYear()}-${pad(value.getMonth() + 1)}-${pad(value.getDate())}`\n}\n\n/** A value of the data as a sheet cell's: dates as `YYYY-MM-DD`, text starting with `=` kept as text. */\nfunction sheetValueOf(value: unknown): SheetValue {\n  if (value == null) return null\n  if (typeof value === 'number') return Number.isFinite(value) ? value : null\n  if (typeof value === 'boolean') return value\n  const text = value instanceof Date ? (filterValueOf(value) as string) : String(value)\n  return text.startsWith('=') ? `'${text}` : text\n}\n\n/**\n * Rows of data as a workbook, for the dashboard's export menu: one sheet,\n * a bold head row with the columns' titles, a row per row of data. An\n * empty `name` takes the widget's title.\n */\nexport function rowsToWorkbook(\n  name: string,\n  columns: readonly { key: string; title: string; width?: number }[],\n  rows: readonly Record<string, unknown>[],\n): SheetWorkbook {\n  const colSizes: Record<number, number> = {}\n  columns.forEach((column, i) => column.width && (colSizes[i] = Math.round(column.width)))\n  return {\n    version: 1,\n    sheets: [\n      {\n        name,\n        cells: [\n          columns.map((column) => ({ value: sheetValueOf(column.title), style: 'head' })),\n          ...rows.map((row) => columns.map((column) => sheetValueOf(row[column.key]))),\n        ],\n        freeze: { rows: 1, cols: 0 },\n        colSizes,\n      },\n    ],\n    styles: { head: { bold: true } },\n  }\n}\n"],"mappings":";;;;;;AAOA,SAAgB,QAAQ,MAAe,MAAwB;CAC7D,IAAI,SAAS,KAAA,KAAa,SAAS,QAAQ,SAAS,IAAI,OAAO;CAC/D,IAAI,OAAO,SAAS,UAAU,OAAO,KAAA;CACrC,IAAI,QAAQ;CACZ,KAAK,MAAM,OAAO,KAAK,MAAM,GAAG,GAAG;EACjC,IAAI,SAAS,QAAQ,OAAO,UAAU,UAAU,OAAO,KAAA;EACvD,QAAS,MAAkC;CAC7C;CACA,OAAO;AACT;;AAGA,SAAgB,OAAO,MAAe,MAA2C;CAC/E,MAAM,QAAQ,QAAQ,MAAM,IAAI;CAChC,IAAI,CAAC,MAAM,QAAQ,KAAK,GAAG,OAAO,CAAC;CACnC,OAAO,MAAM,MAAM,QAAQ,IAAI,QAAQ,MAAM,OAAO,QAAQ;AAC9D;AAEA,IAAM,YAAY,UAChB,UAAU,QAAQ,OAAO,UAAU;;AASrC,IAAa,UAAU,UACrB,OAAO,UAAU,WAAW,QAAQ,KAAA;;AAGtC,IAAa,WAAW,UACtB,MAAM,QAAQ,KAAK,IAAI,MAAM,QAAQ,SAAyB,OAAO,SAAS,QAAQ,IAAI,CAAC;;AAG7F,SAAgB,SAAS,OAAoC;CAC3D,MAAM,IACJ,OAAO,UAAU,WACb,QACA,OAAO,UAAU,YAAY,MAAM,KAAK,IACtC,OAAO,KAAK,IACZ;CACR,OAAO,OAAO,SAAS,CAAC,IAAI,IAAI,KAAA;AAClC;;AAGA,IAAa,UAAU,UAA4B,UAAU;;AAG7D,IAAa,YAAY,UACvB,SAAS,KAAK,KAAK,CAAC,MAAM,QAAQ,KAAK,IAAI,QAAQ,KAAA;;AAGrD,IAAa,SAA2B,OAAgB,WACtD,OAAO,SAAS,KAAU,IAAK,QAAc,KAAA;;AAG/C,SAAgB,SAAS,MAAyB;CAChD,MAAM,QAAQ,MAAM,QAAQ,IAAI,IAAI,KAAK,KAAK;CAC9C,OAAO,SAAS,OAAO,UAAU,YAAY,CAAC,MAAM,QAAQ,KAAK,IAAI,OAAO,KAAK,KAAK,IAAI,CAAC;AAC7F;;AAGA,SAAgB,eAAe,MAAyB;CACtD,MAAM,QAAQ,MAAM,QAAQ,IAAI,IAAI,KAAK,KAAK;CAC9C,OAAO,SAAS,IAAI,CAAC,CAAC,QAAQ,QAAQ,OAAQ,MAAkC,SAAS,QAAQ;AACnG;;AAGA,IAAM,OAAO,MAAc,OAAO,CAAC,CAAC,CAAC,SAAS,GAAG,GAAG;AAEpD,SAAgB,cAAc,OAAyB;CACrD,IAAI,EAAE,iBAAiB,OAAO,OAAO;CACrC,OAAO,GAAG,MAAM,YAAY,EAAE,GAAG,IAAI,MAAM,SAAS,IAAI,CAAC,EAAE,GAAG,IAAI,MAAM,QAAQ,CAAC;AACnF;;AAGA,SAAS,aAAa,OAA4B;CAChD,IAAI,SAAS,MAAM,OAAO;CAC1B,IAAI,OAAO,UAAU,UAAU,OAAO,OAAO,SAAS,KAAK,IAAI,QAAQ;CACvE,IAAI,OAAO,UAAU,WAAW,OAAO;CACvC,MAAM,OAAO,iBAAiB,OAAQ,cAAc,KAAK,IAAe,OAAO,KAAK;CACpF,OAAO,KAAK,WAAW,GAAG,IAAI,IAAI,SAAS;AAC7C;;;;;;AAOA,SAAgB,eACd,MACA,SACA,MACe;CACf,MAAM,WAAmC,CAAC;CAC1C,QAAQ,SAAS,QAAQ,MAAM,OAAO,UAAU,SAAS,KAAK,KAAK,MAAM,OAAO,KAAK,EAAE;CACvF,OAAO;EACL,SAAS;EACT,QAAQ,CACN;GACE;GACA,OAAO,CACL,QAAQ,KAAK,YAAY;IAAE,OAAO,aAAa,OAAO,KAAK;IAAG,OAAO;GAAO,EAAE,GAC9E,GAAG,KAAK,KAAK,QAAQ,QAAQ,KAAK,WAAW,aAAa,IAAI,OAAO,IAAI,CAAC,CAAC,CAC7E;GACA,QAAQ;IAAE,MAAM;IAAG,MAAM;GAAE;GAC3B;EACF,CACF;EACA,QAAQ,EAAE,MAAM,EAAE,MAAM,KAAK,EAAE;CACjC;AACF"}

package/dist/widgets/stat-settings.js.map

@@ -1 +1 @@
-{"version":3,"file":"stat-settings.js","names":["_sfc_main"],"sources":["../../src/widgets/stat-settings.vue"],"sourcesContent":["<script setup lang=\"ts\">\nimport { DouInput, DouInputNumber } from 'dou-ui'\nimport { computed } from 'vue'\nimport { useDashboardMessages } from '../locale'\nimport { useDashboardWidget } from '../widget/context'\nimport FieldSelect from './field-select.vue'\nimport SettingsField from './settings-field.vue'\nimport { fieldsOf } from './shared'\nimport SourceField from './source-field.vue'\nimport type { StatWidgetProps } from './types'\n\ndefineOptions({ name: 'DouDashboardStatSettings' })\n\nconst model = defineModel<StatWidgetProps>({ required: true })\nconst messages = useDashboardMessages()\nconst { data } = useDashboardWidget()\nconst fields = computed(() => fieldsOf(data.value))\nconst set = (patch: Partial<StatWidgetProps>) => (model.value = { ...model.value, ...patch })\n</script>\n\n<template>\n  <div class=\"dou-dashboard__settings\">\n    <SourceField\n      :model-value=\"model.source\"\n      optional\n      @update:model-value=\"(source) => set({ source })\"\n    />\n    <FieldSelect\n      v-if=\"model.source\"\n      :model-value=\"model.field\"\n      :label=\"messages.value\"\n      :fields=\"fields\"\n      @update:model-value=\"(field) => set({ field: field as string | undefined })\"\n    />\n    <SettingsField v-else :label=\"messages.value\">\n      <DouInputNumber\n        :model-value=\"model.value ?? null\"\n        :aria-label=\"messages.value\"\n        @update:model-value=\"(value) => set({ value: value ?? undefined })\"\n      />\n    </SettingsField>\n    <div class=\"dou-dashboard__field-row\">\n      <SettingsField :label=\"messages.prefix\">\n        <DouInput\n          :model-value=\"model.prefix ?? ''\"\n          :aria-label=\"messages.prefix\"\n          @update:model-value=\"(prefix) => set({ prefix: prefix || undefined })\"\n        />\n      </SettingsField>\n      <SettingsField :label=\"messages.suffix\">\n        <DouInput\n          :model-value=\"model.suffix ?? ''\"\n          :aria-label=\"messages.suffix\"\n          @update:model-value=\"(suffix) => set({ suffix: suffix || undefined })\"\n        />\n      </SettingsField>\n    </div>\n    <SettingsField :label=\"messages.precision\">\n      <DouInputNumber\n        :model-value=\"model.precision ?? null\"\n        :min=\"0\"\n        :max=\"6\"\n        :aria-label=\"messages.precision\"\n        @update:model-value=\"(precision) => set({ precision: precision ?? undefined })\"\n      />\n    </SettingsField>\n    <template v-if=\"model.source\">\n      <FieldSelect\n        :model-value=\"model.trend\"\n        :label=\"messages.trend\"\n        :fields=\"fields\"\n        @update:model-value=\"(trend) => set({ trend: trend as string | undefined })\"\n      />\n      <FieldSelect\n        :model-value=\"model.delta\"\n        :label=\"messages.delta\"\n        :fields=\"fields\"\n        @update:model-value=\"(delta) => set({ delta: delta as string | undefined })\"\n      />\n    </template>\n  </div>\n</template>\n"],"mappings":""}
+{"version":3,"file":"stat-settings.js","names":["_sfc_main"],"sources":["../../src/widgets/stat-settings.vue"],"sourcesContent":["<script setup lang=\"ts\">\nimport { DouInput, DouInputNumber } from 'dou-ui'\nimport { computed } from 'vue'\nimport { useDashboardMessages } from '../locale'\nimport { useDashboardWidget } from '../widget/context'\nimport FieldSelect from './field-select.vue'\nimport SettingsField from './settings-field.vue'\nimport { fieldsOf } from './shared'\nimport SourceField from './source-field.vue'\nimport type { StatWidgetProps } from './types'\nimport { statPropsOf } from './read-props'\n\ndefineOptions({ name: 'DouDashboardStatSettings' })\n\nconst model = defineModel<StatWidgetProps>({ required: true })\n// the props as saved may have the wrong types: read them as the widget does\nconst view = computed(() => statPropsOf(model.value as Record<string, unknown>))\nconst messages = useDashboardMessages()\nconst { data } = useDashboardWidget()\nconst fields = computed(() => fieldsOf(data.value))\nconst set = (patch: Partial<StatWidgetProps>) => (model.value = { ...model.value, ...patch })\n</script>\n\n<template>\n  <div class=\"dou-dashboard__settings\">\n    <SourceField\n      :model-value=\"view.source\"\n      optional\n      @update:model-value=\"(source) => set({ source })\"\n    />\n    <FieldSelect\n      v-if=\"view.source\"\n      :model-value=\"view.field\"\n      :label=\"messages.value\"\n      :fields=\"fields\"\n      @update:model-value=\"(field) => set({ field: field as string | undefined })\"\n    />\n    <SettingsField v-else :label=\"messages.value\">\n      <DouInputNumber\n        :model-value=\"view.value ?? null\"\n        :aria-label=\"messages.value\"\n        @update:model-value=\"(value) => set({ value: value ?? undefined })\"\n      />\n    </SettingsField>\n    <div class=\"dou-dashboard__field-row\">\n      <SettingsField :label=\"messages.prefix\">\n        <DouInput\n          :model-value=\"view.prefix ?? ''\"\n          :aria-label=\"messages.prefix\"\n          @update:model-value=\"(prefix) => set({ prefix: prefix || undefined })\"\n        />\n      </SettingsField>\n      <SettingsField :label=\"messages.suffix\">\n        <DouInput\n          :model-value=\"view.suffix ?? ''\"\n          :aria-label=\"messages.suffix\"\n          @update:model-value=\"(suffix) => set({ suffix: suffix || undefined })\"\n        />\n      </SettingsField>\n    </div>\n    <SettingsField :label=\"messages.precision\">\n      <DouInputNumber\n        :model-value=\"view.precision ?? null\"\n        :min=\"0\"\n        :max=\"6\"\n        :aria-label=\"messages.precision\"\n        @update:model-value=\"(precision) => set({ precision: precision ?? undefined })\"\n      />\n    </SettingsField>\n    <template v-if=\"view.source\">\n      <FieldSelect\n        :model-value=\"view.trend\"\n        :label=\"messages.trend\"\n        :fields=\"fields\"\n        @update:model-value=\"(trend) => set({ trend: trend as string | undefined })\"\n      />\n      <FieldSelect\n        :model-value=\"view.delta\"\n        :label=\"messages.delta\"\n        :fields=\"fields\"\n        @update:model-value=\"(delta) => set({ delta: delta as string | undefined })\"\n      />\n    </template>\n  </div>\n</template>\n"],"mappings":""}

package/dist/widgets/stat-settings.vue_vue_type_script_setup_true_lang.js

@@ -1,6 +1,7 @@
 import { useDashboardMessages } from "../locale.js";
 import { useDashboardWidget } from "../widget/context.js";
 import { fieldsOf } from "./shared.js";
+import { statPropsOf } from "./read-props.js";
 import settings_field_default from "./settings-field.js";
 import field_select_default from "./field-select.js";
 import source_field_default from "./source-field.js";
@@ -19,6 +20,7 @@ var stat_settings_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ de
 	emits: ["update:modelValue"],
 	setup(__props) {
 		const model = useModel(__props, "modelValue");
+		const view = computed(() => statPropsOf(model.value));
 		const messages = useDashboardMessages();
 		const { data } = useDashboardWidget();
 		const fields = computed(() => fieldsOf(data.value));
@@ -29,13 +31,13 @@ var stat_settings_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ de
 		return (_ctx, _cache) => {
 			return openBlock(), createElementBlock("div", _hoisted_1, [
 				createVNode(source_field_default, {
-					"model-value": model.value.source,
+					"model-value": view.value.source,
 					optional: "",
 					"onUpdate:modelValue": _cache[0] || (_cache[0] = (source) => set({ source }))
 				}, null, 8, ["model-value"]),
-				model.value.source ? (openBlock(), createBlock(field_select_default, {
+				view.value.source ? (openBlock(), createBlock(field_select_default, {
 					key: 0,
-					"model-value": model.value.field,
+					"model-value": view.value.field,
 					label: unref(messages).value,
 					fields: fields.value,
 					"onUpdate:modelValue": _cache[1] || (_cache[1] = (field) => set({ field }))
@@ -48,7 +50,7 @@ var stat_settings_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ de
 					label: unref(messages).value
 				}, {
 					default: withCtx(() => [createVNode(unref(DouInputNumber), {
-						"model-value": model.value.value ?? null,
+						"model-value": view.value.value ?? null,
 						"aria-label": unref(messages).value,
 						"onUpdate:modelValue": _cache[2] || (_cache[2] = (value) => set({ value: value ?? void 0 }))
 					}, null, 8, ["model-value", "aria-label"])]),
@@ -56,14 +58,14 @@ var stat_settings_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ de
 				}, 8, ["label"])),
 				createElementVNode("div", _hoisted_2, [createVNode(settings_field_default, { label: unref(messages).prefix }, {
 					default: withCtx(() => [createVNode(unref(DouInput), {
-						"model-value": model.value.prefix ?? "",
+						"model-value": view.value.prefix ?? "",
 						"aria-label": unref(messages).prefix,
 						"onUpdate:modelValue": _cache[3] || (_cache[3] = (prefix) => set({ prefix: prefix || void 0 }))
 					}, null, 8, ["model-value", "aria-label"])]),
 					_: 1
 				}, 8, ["label"]), createVNode(settings_field_default, { label: unref(messages).suffix }, {
 					default: withCtx(() => [createVNode(unref(DouInput), {
-						"model-value": model.value.suffix ?? "",
+						"model-value": view.value.suffix ?? "",
 						"aria-label": unref(messages).suffix,
 						"onUpdate:modelValue": _cache[4] || (_cache[4] = (suffix) => set({ suffix: suffix || void 0 }))
 					}, null, 8, ["model-value", "aria-label"])]),
@@ -71,7 +73,7 @@ var stat_settings_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ de
 				}, 8, ["label"])]),
 				createVNode(settings_field_default, { label: unref(messages).precision }, {
 					default: withCtx(() => [createVNode(unref(DouInputNumber), {
-						"model-value": model.value.precision ?? null,
+						"model-value": view.value.precision ?? null,
 						min: 0,
 						max: 6,
 						"aria-label": unref(messages).precision,
@@ -79,8 +81,8 @@ var stat_settings_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ de
 					}, null, 8, ["model-value", "aria-label"])]),
 					_: 1
 				}, 8, ["label"]),
-				model.value.source ? (openBlock(), createElementBlock(Fragment, { key: 2 }, [createVNode(field_select_default, {
-					"model-value": model.value.trend,
+				view.value.source ? (openBlock(), createElementBlock(Fragment, { key: 2 }, [createVNode(field_select_default, {
+					"model-value": view.value.trend,
 					label: unref(messages).trend,
 					fields: fields.value,
 					"onUpdate:modelValue": _cache[6] || (_cache[6] = (trend) => set({ trend }))
@@ -89,7 +91,7 @@ var stat_settings_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ de
 					"label",
 					"fields"
 				]), createVNode(field_select_default, {
-					"model-value": model.value.delta,
+					"model-value": view.value.delta,
 					label: unref(messages).delta,
 					fields: fields.value,
 					"onUpdate:modelValue": _cache[7] || (_cache[7] = (delta) => set({ delta }))