@umbraco-forms/backoffice 17.2.1 → 17.3.0-rc2

package/package.json

@@ -9,7 +9,7 @@
     "url": "https://umbraco.com"
   },
   "type": "module",
-  "version": "17.2.1",
+  "version": "17.3.0-rc2",
   "types": "./types/umbraco-forms-public.d.ts",
   "exports": {
     ".": {
@@ -25,9 +25,11 @@
     "npm": ">=10.9"
   },
   "peerDependencies": {
-    "@umbraco-cms/backoffice": "^17.1.0",
+    "@umbraco-cms/backoffice": "^17.3.0",
     "aspnet-client-validation": "^0.11.1",
     "json-logic-js": "^2.0.5",
-    "moment": "^2.30.1"
+    "moment": "^2.30.1",
+    "chart.js": "^4.5.1",
+    "chartjs-plugin-annotation": "^3.1.0"
   }
 }

package/types/umbraco-forms-public.d.ts

@@ -1,27 +1,44 @@
 import type { ApiLoaderProperty } from '@umbraco-cms/backoffice/extension-api';
+import type { Chart } from 'chart.js';
+import { ChartData } from 'chart.js';
+import type { ChartType } from 'chart.js';
+import type { ChartTypeRegistry } from 'chart.js';
+import { CSSResult } from 'lit';
+import { HTMLElementConstructor } from '@umbraco-cms/backoffice/extension-api';
 import type { ManifestElement } from '@umbraco-cms/backoffice/extension-api';
 import type { ManifestElementAndApi } from '@umbraco-cms/backoffice/extension-api';
 import { Observable } from 'rxjs';
+import { PropertyValues } from '@umbraco-cms/backoffice/external/lit';
+import { TemplateResult } from 'lit-html';
+import { TemplateResult as TemplateResult_2 } from '@umbraco-cms/backoffice/external/lit';
+import type { TooltipOptions } from 'chart.js';
 import type { UmbApi } from '@umbraco-cms/backoffice/extension-api';
 import { UmbApiError } from '@umbraco-cms/backoffice/resources';
 import { UmbCancelError } from '@umbraco-cms/backoffice/resources';
 import type { UmbCollectionRepository } from '@umbraco-cms/backoffice/collection';
 import { UmbContextBase } from '@umbraco-cms/backoffice/class-api';
 import { UmbContextToken } from '@umbraco-cms/backoffice/context-api';
+import { UmbControllerBase } from '@umbraco-cms/backoffice/class-api';
 import type { UmbControllerHost } from '@umbraco-cms/backoffice/controller-api';
 import type { UmbControllerHostElement } from '@umbraco-cms/backoffice/controller-api';
 import { UmbDataSourceResponse } from '@umbraco-cms/backoffice/repository';
 import { UmbDetailRepositoryBase } from '@umbraco-cms/backoffice/repository';
+import { UmbElement } from '@umbraco-cms/backoffice/element-api';
 import { UmbEntityDetailWorkspaceContextCreateArgs } from '@umbraco-cms/backoffice/workspace';
 import { UmbEntityNamedDetailWorkspaceContextBase } from '@umbraco-cms/backoffice/workspace';
 import { UmbLitElement } from '@umbraco-cms/backoffice/lit-element';
+import { UmbModalBaseElement } from '@umbraco-cms/backoffice/modal';
+import { UmbModalToken } from '@umbraco-cms/backoffice/modal';
 import { UmbPagedModel } from '@umbraco-cms/backoffice/repository';
 import type { UmbPropertyEditorConfig } from '@umbraco-cms/backoffice/property-editor';
 import { UmbPropertyEditorConfigCollection } from '@umbraco-cms/backoffice/property-editor';
+import type { UmbPropertyEditorUiElement } from '@umbraco-cms/backoffice/property-editor';
 import type { UmbPropertyValueData } from '@umbraco-cms/backoffice/property';
 import { UmbRoutableWorkspaceContext } from '@umbraco-cms/backoffice/workspace';
 import { UmbSaveableWorkspaceContext } from '@umbraco-cms/backoffice/workspace';
 import type { UmbWorkspaceContext } from '@umbraco-cms/backoffice/workspace';
+import { UUIFormControlMixinElement } from '@umbraco-ui/uui-base';
+import { UUIRefNodeFormElement } from '@umbraco-cms/backoffice/external/uui';
 
 export declare interface ActionType {
     name: string;
@@ -34,6 +51,37 @@ export declare type AllowedUploadType = {
     checked: string;
 };
 
+export declare interface AnalyticsConfigType extends Partial<AnalyticsQueryGet> {
+    alias?: FormsPrefabType;
+}
+
+export declare type AnalyticsGroupBy = "day" | "week" | "month";
+
+export declare type AnalyticsQueryGet = {
+    startDate: string;
+    endDate: string;
+    metrics: Array<Metric>;
+    dimensions: Array<Dimension>;
+    sort: Column;
+    ascending: boolean;
+    page: number;
+    pageSize: number;
+    includeSubpages: boolean;
+    formId?: string | null;
+    filter?: string | null;
+};
+
+export declare type AnalyticsQueryResult = {
+    columns: Array<Column>;
+    currentPage: number;
+    rows: Array<Array<unknown>>;
+    rowsPerPage: number;
+    totalRows: number;
+    totalPages: number;
+    readonly fromRow: number;
+    readonly toRow: number;
+};
+
 export declare type BackOfficeConfig = {
     maxNumberOfColumnsInFormGroup: number;
     manageSecurityWithUserGroups: boolean;
@@ -50,6 +98,15 @@ export declare type BasicForm = {
     name: string;
     fields: string;
     summary: string;
+    entries: number;
+};
+
+declare type BasicForm_2 = {
+    id: string;
+    name: string;
+    fields: string;
+    summary: string;
+    entries: number;
 };
 
 export declare type BasicFormExtended = BasicForm & {
@@ -57,10 +114,76 @@ export declare type BasicFormExtended = BasicForm & {
     count: number;
 };
 
+declare type BasicFormExtended_2 = BasicForm_2 & {
+    gotEntries: boolean;
+    count: number;
+};
+
+export declare const Column: {
+    readonly UNDEFINED: "UNDEFINED";
+    readonly ENTRIES: "entries";
+    readonly WORKFLOW_ERRORS: "workflowErrors";
+    readonly WORKFLOW_COUNT: "workflowCount";
+    readonly FORM_ID: "formId";
+    readonly FORM_NAME: "formName";
+    readonly STORE_RECORDS: "storeRecords";
+    readonly RETENTION_DAYS: "retentionDays";
+    readonly IS_MULTI_PAGE: "isMultiPage";
+    readonly SOURCES: "sources";
+    readonly PAGE_ID: "pageId";
+    readonly PAGE_NAME: "pageName";
+    readonly PAGE_URL: "pageUrl";
+    readonly WORKFLOW_ID: "workflowId";
+    readonly WORKFLOW_NAME: "workflowName";
+    readonly TRIGGERED: "triggered";
+    readonly FAILURES: "failures";
+    readonly SUCCESS: "success";
+    readonly DATE: "date";
+    readonly HOUR: "hour";
+};
+
+export declare type Column = (typeof Column)[keyof typeof Column];
+
+export declare type ContainersSelectOptions = {
+    id: string;
+    pageName: string;
+    groupName: string;
+    selected: boolean;
+};
+
 export declare const DateOptions: Intl.DateTimeFormatOptions;
 
+export declare const DATEPICKER_MODES: {
+    readonly CUSTOM: "custom";
+    readonly TODAY: "today";
+    readonly YESTERDAY: "yesterday";
+    readonly LAST_7_DAYS: "last-7-days";
+    readonly LAST_30_DAYS: "last-30-days";
+    readonly THIS_MONTH: "this-month";
+    readonly LAST_MONTH: "last-month";
+    readonly THIS_YEAR: "this-year";
+    readonly LAST_YEAR: "last-year";
+    readonly PREVIOUS_YEAR: "previous-year";
+    readonly PREVIOUS_PERIOD: "previous-period";
+};
+
 export declare const DateTimeOptions: Intl.DateTimeFormatOptions;
 
+export declare const Dimension: {
+    readonly UNDEFINED: "UNDEFINED";
+    readonly FORM_ID: "formId";
+    readonly FORM_NAME: "formName";
+    readonly PAGE_ID: "pageId";
+    readonly PAGE_NAME: "pageName";
+    readonly PAGE_URL: "pageUrl";
+    readonly WORKFLOW_ID: "workflowId";
+    readonly WORKFLOW_NAME: "workflowName";
+    readonly DATE: "date";
+    readonly HOUR: "hour";
+};
+
+export declare type Dimension = (typeof Dimension)[keyof typeof Dimension];
+
 export declare type EntrySearchResultMetadata = {
     count: number;
     lastSubmittedDate: string;
@@ -255,6 +378,7 @@ export declare type FormDesign = {
     invalidErrorMessage: string;
     messageOnSubmit?: string | null;
     messageOnSubmitIsHtml: boolean;
+    messageOnSubmitBlocks?: string | null;
     goToPageOnSubmit?: string | null;
     xPathOnSubmit?: string | null;
     manualApproval: boolean;
@@ -305,8 +429,18 @@ export declare type FormFolderEntityType = typeof FORMS_FORM_FOLDER_ENTITY_TYPE;
 
 export declare type FormRootEntityType = typeof FORMS_FORM_ROOT_ENTITY_TYPE;
 
+export declare const FORMS_ANALYTICS_CONTEXT: UmbContextToken<FormsAnalyticsContext, FormsAnalyticsContext>;
+
+export declare const FORMS_ANALYTICS_WIDGET_TYPE = "formsAnalyticsWidget";
+
 export declare const FORMS_CONTEXT: UmbContextToken<FormsContext, FormsContext>;
 
+export declare const FORMS_DATERANGE_MANAGER_CONTEXT: UmbContextToken<FormsDateRangeManagerContext, FormsDateRangeManagerContext>;
+
+export declare const FORMS_DATERANGE_PICKER_MODAL: UmbModalToken<FormsDateRangePickerModalData, FormsDateRangePickerModalValue>;
+
+export declare const FORMS_DATERANGE_PICKER_MODAL_ALIAS = "Forms.Modal.DaterangePicker";
+
 export declare const FORMS_FORM_ENTITY_TYPE = "forms-form";
 
 export declare const FORMS_FORM_ENTRY_ENTITY_TYPE = "forms-form-entry";
@@ -317,6 +451,181 @@ export declare const FORMS_FORM_ROOT_ENTITY_TYPE = "forms-form-root";
 
 export declare const FORMS_FORM_WORKSPACE_CONTEXT: UmbContextToken<UmbWorkspaceContext, FormsFormWorkspaceContext>;
 
+export declare class FormsAnalyticsChartElement extends FormsChartBaseElement {
+    #private;
+    config?: FormsChartConfigUnionType;
+    showPercentages: boolean;
+    percentageData?: ChartData & {
+        dates: Array<Array<string>>;
+    };
+    absoluteData?: ChartData & {
+        dates: Array<Array<string>>;
+    };
+    drilldown?: Record<string, string | number>;
+    constructor();
+    protected updated(_changedProperties: PropertyValues): void;
+    loadChart(): Promise<void>;
+    render(): TemplateResult<1>;
+    static styles: CSSResult[];
+}
+
+export declare class FormsAnalyticsContext extends UmbContextBase {
+    #private;
+    readonly STORAGE_KEY = "formsAnalyticsContext";
+    readonly DEFAULT_DAY_RANGE = 30;
+    settings: Observable<FormsAnalyticsContextDefaultSettings>;
+    groupBy: Observable<AnalyticsGroupBy>;
+    constructor(host: UmbControllerHost);
+    query(config: AnalyticsConfigType): Promise<{
+        queryResults: Array<AnalyticsQueryResult | null | undefined>;
+        primaryQueryConfig: Partial<AnalyticsQueryGet>;
+        secondaryQueryConfig?: Partial<AnalyticsQueryGet>;
+    }>;
+    updateSettings(settings: Partial<FormsAnalyticsContextDefaultSettings>): void;
+}
+
+export declare interface FormsAnalyticsContextDefaultSettings {
+    includeNodeDescendants: boolean;
+    groupBy: AnalyticsGroupBy;
+    dateRange?: FormsDateRangePickerInputConfig;
+}
+
+export declare class FormsAnalyticsGroupByControlsElement extends UmbLitElement {
+    #private;
+    analyticsContext?: typeof FORMS_ANALYTICS_CONTEXT.TYPE;
+    private _groupBy;
+    constructor();
+    render(): TemplateResult<1>;
+    static styles: CSSResult;
+}
+
+export declare interface FormsAnalyticsMergedRow {
+    dimensions: Array<any>;
+    dateRanges: Array<FormsAnalyticsMergedRowDateRange>;
+}
+
+export declare interface FormsAnalyticsMergedRowDateRange {
+    label: string;
+    values?: Array<number | boolean>;
+}
+
+export declare interface FormsAnalyticsMergedTable {
+    columns?: Array<Column>;
+    rows: Array<FormsAnalyticsMergedRow>;
+    totalRows?: number;
+    dimensions: Array<Dimension>;
+}
+
+export declare class FormsAnalyticsPrefabTableElement extends FormsAnalyticsTableElement {
+    #private;
+    get alias(): FormsPrefabType | undefined;
+    set alias(value: FormsPrefabType | undefined);
+    get formId(): string | undefined;
+    set formId(value: string | undefined);
+}
+
+export declare class FormsAnalyticsTableElement extends UmbLitElement {
+    #private;
+    readonly PAGESIZES: number[];
+    set config(value: FormsTableConfigUnionType | undefined);
+    get config(): FormsTableConfigUnionType | undefined;
+    drilldownHandler?: (row?: FormsAnalyticsMergedRow) => void;
+    private _data?;
+    private _filteredRows;
+    private _dataPage?;
+    private _pageSize;
+    private _loading;
+    private _metricTotals;
+    constructor();
+    loadTable(): Promise<void>;
+    readonly metricGuardKeys: Set<string>;
+    disconnectedCallback(): void;
+    render(): TemplateResult<1>;
+    static styles: CSSResult;
+}
+
+export declare interface FormsAnalyticsWidget extends UmbControllerHostElement {
+    formId: string | undefined;
+    manifest: ManifestFormsAnalyticsWidget;
+}
+
+export declare interface FormsBarChartData {
+    label: string;
+    key: string;
+    data: Array<{
+        month: number;
+        year: number;
+        count: number;
+    }>;
+}
+
+export declare class FormsButtonGroupElement extends UmbLitElement implements UmbPropertyEditorUiElement {
+    #private;
+    label?: string;
+    value?: string | boolean;
+    values: Array<string | boolean>;
+    /**
+     * Provide an array of values to append to the button labels. This must be equal length to the values array
+     * This is reactive, so can be set asynchronously after the buttons have rendered
+     */
+    args: Array<any | undefined>;
+    /** Optionally provide an array of button label keys. These are localized, so must include the full key value */
+    buttonLabels?: Array<string>;
+    /** values can be provided from config via manifest, on the items config property */
+    set config(config: UmbPropertyEditorConfigCollection | undefined);
+    get config(): UmbPropertyEditorConfigCollection | undefined;
+    render(): TemplateResult<1>;
+    static styles: CSSResult;
+}
+
+export declare abstract class FormsChartBaseElement extends UmbLitElement {
+    #private;
+    chartElement?: HTMLCanvasElement;
+    legend?: TemplateResult_2;
+    protected loading: boolean;
+    protected chart?: Chart<keyof ChartTypeRegistry, [] | undefined, string>;
+    protected umsColors: string[];
+    protected readonly trendColor = "#FFBA00";
+    disconnectedCallback(): void;
+    protected empty: boolean;
+    protected chartColors: Array<string>;
+    protected legendLabels: Array<string>;
+    protected generateLegendItem(text: string, idx: number, subText?: TemplateResult_2): TemplateResult_2<1>;
+    protected defaultLegend(): TemplateResult_2<1>;
+    protected buildChartColors(key: string, i: number): void;
+    protected percentage(v?: number, total?: number): string;
+    static styles: CSSResult[];
+}
+
+export declare interface FormsChartConfig extends FormsPrefabChartPrefab {
+    alias?: FormsPrefabType;
+    type: ChartType;
+    size?: FormsChartSize;
+    showAnnotations?: boolean;
+    isFullHeight?: boolean;
+    stack?: boolean;
+    page: number;
+    pageSize: number;
+    aspect?: number;
+    dateRange?: FormsDateRangePickerInputConfig;
+    formId?: string | null;
+}
+
+export declare type FormsChartConfigUnionType = Partial<AnalyticsQueryGet> & Partial<FormsChartConfig>;
+
+export declare type FormsChartSize = "small" | "medium" | "large";
+
+export declare interface FormsChartTheme {
+    borderColor: string;
+    borderWidth?: number;
+    backgroundColor: string;
+    pointBackgroundColor?: string;
+    pointHoverBackgroundColor?: string;
+    type?: ChartType;
+}
+
+export declare const FormsChartTooltipDefaults: Partial<TooltipOptions>;
+
 export declare class FormsContext extends UmbContextBase {
     #private;
     config: Observable<BackOfficeConfig | undefined>;
@@ -326,6 +635,93 @@ export declare class FormsContext extends UmbContextBase {
     getUserSecurity(): Promise<void>;
 }
 
+export declare type FormsDatePickerModeKey = keyof typeof DATEPICKER_MODES;
+
+export declare type FormsDatePickerModeValue = (typeof DATEPICKER_MODES)[FormsDatePickerModeKey];
+
+export declare class FormsDateRangeManagerContext extends UmbContextBase {
+    #private;
+    dateRangeRange: {
+        primary: FormsDateRangePickerRangeConfig;
+        secondary: FormsDateRangePickerRangeConfig;
+    };
+    value: Observable<FormsDateRangePickerRangeConfig | undefined>;
+    config: Observable<FormsDateRangePickerInputConfig>;
+    constructor(host: UmbControllerHost);
+    updateConfig(value: FormsDateRangePickerInputConfig): void;
+    getValue(): FormsDateRangePickerRangeConfig | undefined;
+    getConfig(): FormsDateRangePickerInputConfig;
+    clear(): void;
+    computeDefaultRange(): void;
+    /**
+     * Calculate the date range based on the provided mode and range
+     * but does not update the internal state.
+     * This is useful for getting the computed range without affecting the current state - eg in a modal
+     * where we don't want to update the context until the user confirms their selection.
+     */
+    getComputedRange(config: FormsDateRangePickerModeConfig, range?: FormsDateRangePickerRangeConfig, compareToConfig?: FormsDateRangePickerModeConfig, compareToRange?: FormsDateRangePickerRangeConfig): {
+        from: string;
+        to: string;
+    };
+}
+
+export declare interface FormsDateRangePickerConfig {
+    range: any;
+    ui: {
+        isHidden: boolean;
+    };
+    pickers: {
+        primary: FormsDateRangePickerModeConfig;
+        secondary: FormsDateRangePickerModeConfig;
+    };
+    dateFormat?: string | null;
+    showToday?: boolean;
+}
+
+export declare class FormsDateRangePickerElement extends UmbLitElement {
+    #private;
+    showCompare: boolean;
+    label?: string;
+    private _currentDate;
+    private _config?;
+    value?: FormsDateRangePickerRangeConfig;
+    constructor();
+    render(): TemplateResult<1>;
+    static styles: CSSResult;
+}
+
+export declare interface FormsDateRangePickerInputConfig {
+    compare: boolean;
+    primary: FormsDateRangePickerModeConfig;
+    secondary: FormsDateRangePickerModeConfig;
+}
+
+export declare interface FormsDateRangePickerModalData extends FormsDateRangePickerInputConfig {
+    allowCompare: boolean;
+}
+
+export declare class FormsDaterangePickerModalElement extends UmbModalBaseElement<FormsDateRangePickerModalData, FormsDateRangePickerModalValue> {
+    #private;
+    constructor();
+    private _dateConfig?;
+    connectedCallback(): void;
+    render(): TemplateResult<1>;
+    static styles: CSSResult;
+}
+
+export declare interface FormsDateRangePickerModalValue extends FormsDateRangePickerInputConfig {
+}
+
+export declare interface FormsDateRangePickerModeConfig {
+    mode?: FormsDatePickerModeValue;
+    range: FormsDateRangePickerRangeConfig;
+}
+
+export declare interface FormsDateRangePickerRangeConfig {
+    from: string;
+    to: string;
+}
+
 export declare type FormSecurityForUser = {
     key: string;
     name: string;
@@ -451,17 +847,166 @@ export declare class FormsFormWorkspaceContext extends UmbEntityNamedDetailWorks
     getAllFields(): Field[];
     getAllFieldAliases(): string[];
     getFieldsWithPrevalues(): Array<FieldPrevalueDetail>;
+    getField(id: string): Field | null;
+    getContainerIndexPath(id: string): string;
     getContainerIndexPathForField(id: string): string;
+    getFullIndexPathForField(id: string): {
+        containerIndexPath: string;
+        fieldIndex: number;
+        pageIndex: number;
+        fieldsetIndex: number;
+        containerIndex: number;
+    } | null;
+    getContainersSelectOptions(fieldContainerIndexPath: string): Array<ContainersSelectOptions>;
     getConditionActionTypes: Array<ActionType>;
     getConditionLogicTypes: Array<LogicType>;
     getConditionOperators: Array<OperatorType>;
-    getRichTextConfiguration(): Promise<UmbPropertyEditorConfigCollection>;
+    getRichTextConfiguration(): Promise<{
+        config: UmbPropertyEditorConfigCollection;
+        propertyEditorUiAlias: string;
+    }>;
 }
 
 export declare interface FormsFormWorkspaceCreateArgs extends UmbEntityDetailWorkspaceContextCreateArgs<FormDesign> {
     template?: string;
 }
 
+export declare class FormsInputFolderElement extends FormsInputFolderElement_base {
+    #private;
+    get selection(): Array<string>;
+    set selection(ids: Array<string>);
+    set value(idsString: string);
+    get value(): string;
+    private _items?;
+    constructor();
+    connectedCallback(): void;
+    protected getFormElement(): undefined;
+    render(): TemplateResult<1>;
+    static styles: CSSResult[];
+}
+
+declare const FormsInputFolderElement_base: (new (...args: any[]) => UUIFormControlMixinElement<FormDataEntryValue | FormData>) & typeof UmbLitElement;
+
+export declare class FormsInputFormElement extends FormsInputFormElement_base {
+    #private;
+    get selection(): Array<string>;
+    set selection(ids: Array<string>);
+    multiple: boolean;
+    allowedFolders: Array<string>;
+    allowedForms: Array<string>;
+    private _userSecurity?;
+    private _items?;
+    constructor();
+    connectedCallback(): Promise<void>;
+    protected getFormElement(): undefined;
+    render(): TemplateResult<1>;
+    static styles: CSSResult[];
+}
+
+declare const FormsInputFormElement_base: (new (...args: any[]) => UUIFormControlMixinElement<FormDataEntryValue | FormData>) & typeof UmbLitElement;
+
+export declare class FormsInputThemeElement extends FormsInputThemeElement_base {
+    #private;
+    private _options;
+    private _value;
+    set value(val: string);
+    get value(): string;
+    connectedCallback(): Promise<void>;
+    protected getFormElement(): undefined;
+    render(): TemplateResult<1>;
+}
+
+declare const FormsInputThemeElement_base: (new (...args: any[]) => UUIFormControlMixinElement<FormDataEntryValue | FormData>) & typeof UmbLitElement;
+
+export declare interface FormsPieChartData {
+    label: string;
+    key: string;
+    data: number;
+}
+
+/**
+ * A prefab chart element that generates configuration from an alias.
+ * This provides a declarative way to use charts - just set the alias
+ * and formId, and the chart configures itself.
+ *
+ * @example
+ * ```html
+ * <forms-prefab-chart alias="submissions" .formId=${formId}></forms-prefab-chart>
+ * ```
+ */
+export declare class FormsPrefabChartElement extends FormsAnalyticsChartElement {
+    #private;
+    /**
+     * The prefab alias to use for generating chart configuration.
+     * When set, the chart will automatically configure itself based on the prefab definition.
+     */
+    get alias(): FormsPrefabType | undefined;
+    set alias(value: FormsPrefabType | undefined);
+    /**
+     * The form ID to query analytics for.
+     */
+    get formId(): string | undefined;
+    set formId(value: string | undefined);
+    /**
+     * The aspect ratio override.
+     */
+    get aspect(): number | undefined;
+    set aspect(value: number | undefined);
+}
+
+export declare class FormsPrefabChartGeneratorController extends FormsPrefabGeneratorControllerBase<FormsPrefabChartPrefab, FormsChartConfigUnionType> {
+    constructor(host: UmbControllerHost, callback?: () => unknown);
+    initializePrefabs(callback?: () => unknown): void;
+    generate<ConfigType extends FormsPrefabEntityBase>(prefabAlias: FormsPrefabType, config?: ConfigType): ConfigType;
+    options: FormsPrefabCollection<FormsPrefabChartPrefab>;
+}
+
+export declare interface FormsPrefabChartPrefab extends FormsPrefabEntityBase {
+    unit?: string;
+    unitSingular?: string;
+    type?: ChartType;
+    stack?: boolean;
+    trendIndex?: number;
+    colors?: Partial<Record<Metric, string | [string, string]>>;
+}
+
+export declare interface FormsPrefabCollection<T> extends Partial<Record<FormsPrefabType & string, T>> {
+}
+
+export declare interface FormsPrefabEntityBase {
+    alias?: FormsPrefabType;
+    metrics?: Array<Metric>;
+    dimensions?: Array<Dimension>;
+    realtime?: boolean;
+    filter?: string | null;
+    hideColumns?: Array<number>;
+    documentUnique?: string;
+    culture?: string;
+}
+
+export declare abstract class FormsPrefabGeneratorControllerBase<FormsPrefabType extends FormsPrefabEntityBase, ConfigType extends FormsPrefabType> extends UmbControllerBase {
+    protected abstract initializePrefabs(callback?: () => unknown): any;
+    protected abstract generate<ConfigType extends FormsPrefabType>(prefabAlias?: string, config?: ConfigType): ConfigType;
+    config?: ConfigType;
+    protected abstract options: FormsPrefabCollection<FormsPrefabType>;
+    protected prefab?: FormsPrefabType;
+    protected dataGenerationEnabled: boolean;
+    constructor(host: UmbControllerHost, callback?: () => unknown);
+    protected getPrefabFromConfiguration(prefabAlias?: string): void;
+    protected enableRealTimeReporting(): void;
+    protected determineAllMetrics(): void;
+    protected setPrefabProperty(key: keyof ConfigType, defaultValue?: any, prependDefault?: boolean): void;
+}
+
+export declare interface FormsPrefabTablePrefab extends FormsPrefabEntityBase {
+    name?: string;
+    ascending?: boolean;
+    columnWidths?: Array<string | undefined>;
+    boxed?: boolean;
+}
+
+export declare type FormsPrefabType = "overview" | "submissions" | "submissions-hourly" | "origins" | "origins-overview" | "workflows";
+
 export declare interface FormsPrevalueSourceCollectionFilterModel {
     skip?: number;
     take?: number;
@@ -474,12 +1019,33 @@ export declare class FormsPrevalueSourceCollectionRepository implements UmbColle
     destroy(): void;
 }
 
+export declare class FormsRefFormElement extends FormsRefFormElement_base {
+    #private;
+    selectable: boolean;
+    model?: BasicForm | BasicFormExtended_2;
+    config?: UserSecurity;
+    _count: number;
+    willUpdate(changedProperties: PropertyValues<this>): void;
+    render(): TemplateResult<1>;
+    static styles: CSSResult[];
+}
+
+declare const FormsRefFormElement_base: HTMLElementConstructor<UmbElement> & typeof UUIRefNodeFormElement;
+
 export declare interface FormsSettingValueConverterApi extends UmbApi {
     getSettingValueForEditor(setting: Setting, alias: string, value: string): Promise<unknown>;
     getSettingValueForPersistence(setting: Setting, valueData: UmbPropertyValueData): Promise<string>;
     getSettingPropertyConfig(setting: Setting, alias: string, values: Array<UmbPropertyValueData>): Promise<UmbPropertyEditorConfig>;
 }
 
+export declare interface FormsTableConfig extends FormsPrefabTablePrefab {
+    hasData?: boolean;
+    page: number;
+    pageSize: number;
+}
+
+export declare type FormsTableConfigUnionType = Partial<AnalyticsQueryGet> & Partial<FormsTableConfig>;
+
 export declare class FormsWorkflowTypeDetailRepository extends UmbDetailRepositoryBase<WorkflowTypeWithSettings> {
     constructor(host: UmbControllerHost);
 }
@@ -551,6 +1117,11 @@ export declare interface LogicType {
     value: string;
 }
 
+export declare interface ManifestFormsAnalyticsWidget extends ManifestElement<FormsAnalyticsWidget> {
+    type: typeof FORMS_ANALYTICS_WIDGET_TYPE;
+    meta: MetaFormsAnalytics;
+}
+
 export declare interface ManifestFormsFieldPreview extends ManifestElement {
     type: "formsFieldPreview";
 }
@@ -561,6 +1132,35 @@ export declare interface ManifestFormsSettingValueConverterPreview extends Manif
     api: ApiLoaderProperty<FormsSettingValueConverterApi>;
 }
 
+export declare interface MetaFormsAnalytics {
+    size: MetaFormsAnalyticsSize;
+    headline?: string | undefined;
+    chartAlias?: string | undefined;
+    aspect?: number | undefined;
+}
+
+export declare type MetaFormsAnalyticsSize = "small" | "large";
+
+export declare const Metric: {
+    readonly UNDEFINED: "UNDEFINED";
+    readonly ENTRIES: "entries";
+    readonly WORKFLOW_ERRORS: "workflowErrors";
+    readonly WORKFLOW_COUNT: "workflowCount";
+    readonly STORE_RECORDS: "storeRecords";
+    readonly RETENTION_DAYS: "retentionDays";
+    readonly IS_MULTI_PAGE: "isMultiPage";
+    readonly SOURCES: "sources";
+    readonly PAGE_ID: "pageId";
+    readonly PAGE_NAME: "pageName";
+    readonly WORKFLOW_ID: "workflowId";
+    readonly WORKFLOW_NAME: "workflowName";
+    readonly TRIGGERED: "triggered";
+    readonly FAILURES: "failures";
+    readonly SUCCESS: "success";
+};
+
+export declare type Metric = (typeof Metric)[keyof typeof Metric];
+
 export declare const MultiPageNavigationOption: {
     readonly NONE: "None";
     readonly SHOW_AT_TOP: "ShowAtTop";