@formio/js 5.0.0-rc.51 → 5.0.0-rc.53

package/lib/cjs/components/_classes/nested/NestedComponent.d.ts

@@ -1,16 +1,96 @@
+/**
+ * NestedComponent class.
+ * @augments Field
+ */
 export default class NestedComponent extends Field {
     constructor(component: any, options: any, data: any);
     type: string;
-    _collapsed: boolean;
+    /**
+     * The collapsed state of this NestedComponent.
+     * @type {boolean}
+     * @default false
+     * @private
+     */
+    private _collapsed;
+    /**
+     * Set collapsed state.
+     * @param {boolean} value - The collapsed state.
+     * @returns {void}
+     */
     set collapsed(value: boolean);
+    /**
+     * Get collapsed state.
+     * @returns {boolean} The collapsed state.
+     */
     get collapsed(): boolean;
-    collapse(value: any): Promise<void>;
+    /**
+     * Set collapsed state.
+     * @param {boolean} value - The collapsed state.
+     * @returns {void}
+     */
+    collapse(value: boolean): void;
+    /**
+     * Set parent visibility.
+     * @param {boolean} value - The parent visibility.
+     * @returns {void}
+     */
+    set parentVisible(value: boolean);
+    /**
+     * Get parent visibility.
+     * @returns {boolean} The parent visibility.
+     */
+    get parentVisible(): boolean;
+    /**
+     * Get ready state from all components.
+     * @returns {Promise<Array>} - The promise that resolves when all components are ready.
+     */
     get ready(): Promise<any[]>;
-    set rowIndex(value: any);
-    get rowIndex(): any;
-    _rowIndex: any;
-    componentContext(): any;
-    getComponents(): any;
+    /**
+     * Set currentForm object.
+     * @param {object} instance - The current form object.
+     * @returns {void}
+     */
+    set currentForm(instance: object);
+    /**
+     * Get currentForm object.
+     * @returns {object} - The current form object.
+     */
+    get currentForm(): object;
+    /**
+     * Set Row Index to row and update each component.
+     * @param {number} value - The row index.
+     * @returns {void}
+     */
+    set rowIndex(value: number);
+    /**
+     * Get Row Index.
+     * @returns {number} - The row index.
+     */
+    get rowIndex(): number;
+    _rowIndex: number | undefined;
+    /**
+     * Get Contextual data of the component.
+     * @returns {object} - The contextual data of the component.
+     * @override
+     */
+    override componentContext(): object;
+    /**
+     * Set the data of the component.
+     * @param {object} value - The data of the component.
+     * @returns {void}
+     */
+    override set data(value: object);
+    /**
+     * Get the data of the component.
+     * @returns {object} - The data of the component.
+     * @override
+     */
+    override get data(): object;
+    /**
+     * Get components array.
+     * @returns {Array} - The components array.
+     */
+    getComponents(): any[];
     /**
      * Perform a deep iteration over every component, including those
      * within other container based components.
@@ -18,8 +98,17 @@ export default class NestedComponent extends Field {
      * @param {any} options - The options to include with this everyComponent call.
      */
     everyComponent(fn: Function, options?: any): void;
-    hasComponent(component: any): boolean;
-    flattenComponents(): {};
+    /**
+     * Check if the component has a component.
+     * @param {import('@formio/core').Component} component - The component to check.
+     * @returns {boolean} - TRUE if the component has a component, FALSE otherwise.
+     */
+    hasComponent(component: import('@formio/core').Component): boolean;
+    /**
+     * Get the flattened components of this NestedComponent.
+     * @returns {object} - The flattened components of this NestedComponent.
+     */
+    flattenComponents(): object;
     /**
      * Perform an iteration over each component within this container component.
      * @param {Function} fn - Called for each component
@@ -44,13 +133,13 @@ export default class NestedComponent extends Field {
     /**
      * Create a new component and add it to the components array.
      * @param {import('@formio/core').Component} component - The component JSON schema to create.
-     * @param {any} options - The options to create the component with.
-     * @param {any} data - The submission data object to house the data for this component.
-     * @param {*} [before] - The component before which to add this component.
-     * @param {*} [replacedComp] - The component to replace with this component.
+     * @param {object} options - The options to create the component with.
+     * @param {import('@formio/core').DataObject} data - The submission data object to house the data for this component.
+     * @param {import('@formio/core').Component} [before] - The component before which to add this component.
+     * @param {import('@formio/core').Component} [replacedComp] - The component to replace with this component.
      * @returns {any} - The created component instance.
      */
-    createComponent(component: import('@formio/core').Component, options: any, data: any, before?: any, replacedComp?: any): any;
+    createComponent(component: import('@formio/core').Component, options: object, data: import('@formio/core').DataObject, before?: import("@formio/core").Component | undefined, replacedComp?: import("@formio/core").Component | undefined): any;
     getContainer(): any;
     get componentComponents(): any;
     get nestedKey(): string;
@@ -58,31 +147,36 @@ export default class NestedComponent extends Field {
     components: any;
     /**
      * Add a new component instance to the components array.
-     * @param {any} [data] - The Submission data for this component.
-     * @param {any} [options] - The options for this component.
+     * @param {import('@formio/core').DataObject} [data] - The Submission data for this component.
+     * @param {object} [options] - The options for this component.
      */
-    addComponents(data?: any, options?: any): void;
+    addComponents(data?: import("@formio/core").DataObject | undefined, options?: object | undefined): void;
     /**
      * Add a new component to the components array.
-     * @param {object} component - The component JSON schema to add.
+     * @param {import('@formio/core').Component} component - The component JSON schema to add.
      * @param {object} data - The submission data object to house the data for this component.
      * @param {HTMLElement} before - A DOM element to insert this element before.
      * @param {boolean} [noAdd] - A possibly extraneous boolean flag.
      * @returns {any} - The created component instance.
      */
-    addComponent(component: object, data?: object, before?: HTMLElement, noAdd?: boolean | undefined): any;
+    addComponent(component: import('@formio/core').Component, data?: object, before?: HTMLElement, noAdd?: boolean | undefined): any;
     beforeFocus(): void;
+    render(children: any): Field;
     renderComponents(components: any): any;
     attach(element: any): Promise<[void, void]>;
-    attachComponentsLogic(components: any): void;
+    /**
+     * Attach the logic to the components.
+     * @param {import('@formio/core').Component[]} components - The components to attach logic to.
+     */
+    attachComponentsLogic(components: import('@formio/core').Component[]): void;
     attachComponents(element: any, components: any, container: any): Promise<any>;
     /**
      * Remove a component from the components array and from the children object
-     * @param {any} component - The component to remove from the components.
-     * @param {Array<any>} components - An array of components to remove this component from.
+     * @param {import('@formio/core').Component} component - The component to remove from the components.
+     * @param {import('@formio/core').Component[]} components - An array of components to remove this component from.
      * @param {boolean} [all] - If set to TRUE will cascade remove all components.
      */
-    removeComponent(component: any, components: Array<any>, all?: boolean | undefined): void;
+    removeComponent(component: import('@formio/core').Component, components: import('@formio/core').Component[], all?: boolean | undefined): void;
     /**
      * Removes a component provided the API key of that component.
      * @param {string} key - The API key of the component to remove.
@@ -125,27 +219,27 @@ export default class NestedComponent extends Field {
     }, flags: any): void;
     /**
      * Perform a validation on all child components of this nested component.
-     * @param {*} components - The components to validate.
-     * @param {*} data - The data to validate.
-     * @param {*} flags - The flags to use when validating.
+     * @param {import('@formio/core').Component[]} components - The components to validate.
+     * @param {import('@formio/core').DataObject} data - The data to validate.
+     * @param {object} flags - The flags to use when validating.
      * @returns {Promise<Array>|Array} - The errors if any exist.
      */
-    validateComponents(components?: any, data?: any, flags?: any): Promise<any[]> | any[];
+    validateComponents(components?: import('@formio/core').Component[], data?: import('@formio/core').DataObject, flags?: object): Promise<any[]> | any[];
     /**
      * Validate a nested component with data, or its own internal data.
-     * @param {*} data - The data to validate.
-     * @param {*} flags - The flags to use when validating.
-     * @returns {*} - The errors if any exist.
+     * @param {import('@formio/core').DataObject} data - The data to validate.
+     * @param {object} flags - The flags to use when validating.
+     * @returns {Array} - The errors if any exist.
      */
-    validate(data?: any, flags?: any): any;
+    validate(data?: import('@formio/core').DataObject, flags?: object): any[];
     checkComponentValidity(data?: null, dirty?: boolean, row?: null, flags?: {}, allErrors?: any[]): boolean;
     checkAsyncValidity(data?: null, dirty?: boolean, row?: null, silentCheck?: boolean): Promise<any>;
     setPristine(pristine: any): void;
-    get isPristine(): any;
-    get isDirty(): any;
+    get isDirty(): boolean | undefined;
     destroyComponents(all?: boolean): void;
     get visibleErrors(): any;
     get errors(): any;
+    getValue(): object;
     get dataReady(): Promise<any[]>;
     setNestedValue(component: any, value: any, flags?: {}): any;
     setValue(value: any, flags?: {}): any;

package/lib/cjs/components/_classes/nested/NestedComponent.js

@@ -8,6 +8,10 @@ const Field_1 = __importDefault(require("../field/Field"));
 const Components_1 = __importDefault(require("../../Components"));
 const utils_1 = require("../../../utils/utils");
 const process_1 = require("@formio/core/process");
+/**
+ * NestedComponent class.
+ * @augments Field
+ */
 class NestedComponent extends Field_1.default {
     static schema(...extend) {
         return Field_1.default.schema({
@@ -18,20 +22,40 @@ class NestedComponent extends Field_1.default {
     constructor(component, options, data) {
         super(component, options, data);
         this.type = 'components';
+        /**
+         * The collapsed state of this NestedComponent.
+         * @type {boolean}
+         * @default false
+         * @private
+         */
         this._collapsed = !!this.component.collapsed;
     }
     get defaultSchema() {
         return NestedComponent.schema();
     }
+    /**
+     * Get the schema for the NestedComponent.
+     * @returns {object} The schema for the NestedComponent.
+     * @override
+     */
     get schema() {
         const schema = super.schema;
         const components = lodash_1.default.uniqBy(this.getComponents(), 'component.key');
         schema.components = lodash_1.default.map(components, 'schema');
         return schema;
     }
+    /**
+     * Get collapsed state.
+     * @returns {boolean} The collapsed state.
+     */
     get collapsed() {
         return this._collapsed;
     }
+    /**
+     * Set collapsed state.
+     * @param {boolean} value - The collapsed state.
+     * @returns {void}
+     */
     collapse(value) {
         const promise = this.redraw();
         if (!value) {
@@ -39,10 +63,20 @@ class NestedComponent extends Field_1.default {
         }
         return promise;
     }
+    /**
+     * Set collapsed state.
+     * @param {boolean} value - The collapsed state.
+     * @returns {void}
+     */
     set collapsed(value) {
         this._collapsed = value;
         this.collapse(value);
     }
+    /**
+     * Set visible state of parent and each child component.
+     * @param {boolean} value - The visible state.
+     * @returns {void}
+     */
     set visible(value) {
         // DO NOT CALL super here.  There is an issue where clearOnHide was getting triggered with
         // subcomponents because the "parentVisible" flag was set to false when it should really be
@@ -73,65 +107,136 @@ class NestedComponent extends Field_1.default {
             this.redraw();
         }
     }
+    /**
+     * Get visible state.
+     * @returns {boolean} The visible state.
+     */
     get visible() {
         return super.visible;
     }
+    /**
+     * Set parent visibility.
+     * @param {boolean} value - The parent visibility.
+     * @returns {void}
+     */
     set parentVisible(value) {
         super.parentVisible = value;
         this.components.forEach(component => component.parentVisible = this.visible);
     }
+    /**
+     * Get parent visibility.
+     * @returns {boolean} The parent visibility.
+     */
     get parentVisible() {
         return super.parentVisible;
     }
+    /**
+     * Get the disabled state.
+     * @returns {boolean} - The disabled state.
+     */
     get disabled() {
         return super.disabled;
     }
+    /**
+     * Set the disabled state.
+     * @param {boolean} disabled - The disabled state.
+     */
     set disabled(disabled) {
         super.disabled = disabled;
         this.components.forEach((component) => component.parentDisabled = disabled);
     }
+    /**
+     * Set parent disabled state.
+     * @param {boolean} value - The parent disabled state.
+     * @returns {void}
+     */
     set parentDisabled(value) {
         super.parentDisabled = value;
         this.components.forEach(component => {
             component.parentDisabled = this.disabled;
         });
     }
+    /**
+     * Get parent disabled state.
+     * @returns {boolean} The parent disabled state.
+     */
     get parentDisabled() {
         return super.parentDisabled;
     }
+    /**
+     * Get ready state from all components.
+     * @returns {Promise<Array>} - The promise that resolves when all components are ready.
+     */
     get ready() {
         return Promise.all(this.getComponents().map(component => component.ready));
     }
+    /**
+     * Get currentForm object.
+     * @returns {object} - The current form object.
+     */
     get currentForm() {
         return super.currentForm;
     }
+    /**
+     * Set currentForm object.
+     * @param {object} instance - The current form object.
+     * @returns {void}
+     */
     set currentForm(instance) {
         super.currentForm = instance;
         this.getComponents().forEach(component => {
             component.currentForm = instance;
         });
     }
+    /**
+     * Get Row Index.
+     * @returns {number} - The row index.
+     */
     get rowIndex() {
         return this._rowIndex;
     }
+    /**
+     * Set Row Index to row and update each component.
+     * @param {number} value - The row index.
+     * @returns {void}
+     */
     set rowIndex(value) {
         this._rowIndex = value;
         this.eachComponent((component) => {
             component.rowIndex = value;
         });
     }
+    /**
+     * Get Contextual data of the component.
+     * @returns {object} - The contextual data of the component.
+     * @override
+     */
     componentContext() {
         return this._data;
     }
+    /**
+     * Get the data of the component.
+     * @returns {object} - The data of the component.
+     * @override
+     */
     get data() {
         return this._data;
     }
+    /**
+     * Set the data of the component.
+     * @param {object} value - The data of the component.
+     * @returns {void}
+     */
     set data(value) {
         this._data = value;
         this.eachComponent((component) => {
             component.data = this.componentContext(component);
         });
     }
+    /**
+     * Get components array.
+     * @returns {Array} - The components array.
+     */
     getComponents() {
         return this.components || [];
     }
@@ -154,6 +259,11 @@ class NestedComponent extends Field_1.default {
             }
         });
     }
+    /**
+     * Check if the component has a component.
+     * @param {import('@formio/core').Component} component - The component to check.
+     * @returns {boolean} - TRUE if the component has a component, FALSE otherwise.
+     */
     hasComponent(component) {
         let result = false;
         this.everyComponent((comp) => {
@@ -164,6 +274,10 @@ class NestedComponent extends Field_1.default {
         });
         return result;
     }
+    /**
+     * Get the flattened components of this NestedComponent.
+     * @returns {object} - The flattened components of this NestedComponent.
+     */
     flattenComponents() {
         const result = {};
         this.everyComponent((component) => {
@@ -256,10 +370,10 @@ class NestedComponent extends Field_1.default {
     /**
      * Create a new component and add it to the components array.
      * @param {import('@formio/core').Component} component - The component JSON schema to create.
-     * @param {any} options - The options to create the component with.
-     * @param {any} data - The submission data object to house the data for this component.
-     * @param {*} [before] - The component before which to add this component.
-     * @param {*} [replacedComp] - The component to replace with this component.
+     * @param {object} options - The options to create the component with.
+     * @param {import('@formio/core').DataObject} data - The submission data object to house the data for this component.
+     * @param {import('@formio/core').Component} [before] - The component before which to add this component.
+     * @param {import('@formio/core').Component} [replacedComp] - The component to replace with this component.
      * @returns {any} - The created component instance.
      */
     createComponent(component, options, data, before, replacedComp) {
@@ -323,8 +437,8 @@ class NestedComponent extends Field_1.default {
     }
     /**
      * Add a new component instance to the components array.
-     * @param {any} [data] - The Submission data for this component.
-     * @param {any} [options] - The options for this component.
+     * @param {import('@formio/core').DataObject} [data] - The Submission data for this component.
+     * @param {object} [options] - The options for this component.
      */
     addComponents(data, options) {
         data = data || this.data;
@@ -340,7 +454,7 @@ class NestedComponent extends Field_1.default {
     }
     /**
      * Add a new component to the components array.
-     * @param {object} component - The component JSON schema to add.
+     * @param {import('@formio/core').Component} component - The component JSON schema to add.
      * @param {object} data - The submission data object to house the data for this component.
      * @param {HTMLElement} before - A DOM element to insert this element before.
      * @param {boolean} [noAdd] - A possibly extraneous boolean flag.
@@ -407,6 +521,10 @@ class NestedComponent extends Field_1.default {
             childPromise,
         ]);
     }
+    /**
+     * Attach the logic to the components.
+     * @param {import('@formio/core').Component[]} components - The components to attach logic to.
+     */
     attachComponentsLogic(components) {
         components = components || this.components;
         lodash_1.default.each(components, (comp) => {
@@ -436,8 +554,8 @@ class NestedComponent extends Field_1.default {
     }
     /**
      * Remove a component from the components array and from the children object
-     * @param {any} component - The component to remove from the components.
-     * @param {Array<any>} components - An array of components to remove this component from.
+     * @param {import('@formio/core').Component} component - The component to remove from the components.
+     * @param {import('@formio/core').Component[]} components - An array of components to remove this component from.
      * @param {boolean} [all] - If set to TRUE will cascade remove all components.
      */
     removeComponent(component, components, all = false) {
@@ -575,9 +693,9 @@ class NestedComponent extends Field_1.default {
     }
     /**
      * Perform a validation on all child components of this nested component.
-     * @param {*} components - The components to validate.
-     * @param {*} data - The data to validate.
-     * @param {*} flags - The flags to use when validating.
+     * @param {import('@formio/core').Component[]} components - The components to validate.
+     * @param {import('@formio/core').DataObject} data - The data to validate.
+     * @param {object} flags - The flags to use when validating.
      * @returns {Promise<Array>|Array} - The errors if any exist.
      */
     validateComponents(components = null, data = null, flags = {}) {
@@ -615,9 +733,9 @@ class NestedComponent extends Field_1.default {
     }
     /**
      * Validate a nested component with data, or its own internal data.
-     * @param {*} data - The data to validate.
-     * @param {*} flags - The flags to use when validating.
-     * @returns {*} - The errors if any exist.
+     * @param {import('@formio/core').DataObject} data - The data to validate.
+     * @param {object} flags - The flags to use when validating.
+     * @returns {Array} - The errors if any exist.
      */
     validate(data = null, flags = {}) {
         data = data || this.rootValue;

package/lib/cjs/components/_classes/nesteddata/NestedDataComponent.d.ts

@@ -3,9 +3,15 @@ export default class NestedDataComponent extends NestedComponent {
     hasChanged(newValue: any, oldValue: any): boolean;
     get allowData(): boolean;
     get emptyValue(): {};
+    componentContext(): any;
     getValueAsString(value: any, options: any): string;
     getDataValueAsTable(value: any, options: any): string;
     everyComponent(fn: any, options?: {}): void;
+    /**
+     * Get the value of this component.
+     * @returns {*}
+     */
+    getValue(): any;
     updateValue(value: any, flags?: {}): boolean;
     setValue(value: any, flags?: {}): boolean;
 }

package/lib/cjs/components/address/Address.d.ts

@@ -54,7 +54,7 @@ export default class AddressComponent extends ContainerComponent {
     renderElement(value: any): any;
     renderRow(value: any, index: any): any;
     renderGrid(): any;
-    render(): string;
+    render(): Field;
     onSelectAddress(address: any, element: any, index: any): void;
     addRow(): void;
     attach(element: any): Promise<void>;
@@ -65,3 +65,4 @@ export default class AddressComponent extends ContainerComponent {
     getValueAsString(value: any, options: any): any;
 }
 import ContainerComponent from '../container/Container';
+import Field from '../_classes/field/Field';

package/lib/cjs/components/button/Button.d.ts

@@ -21,7 +21,7 @@ export default class ButtonComponent extends Field {
     get clicked(): any;
     get defaultValue(): boolean;
     get oauthConfig(): any;
-    render(): string;
+    render(): Field;
     attachButton(): void;
     hasError: boolean | undefined;
     isDisabledOnInvalid: any;

package/lib/cjs/components/checkbox/Checkbox.d.ts

@@ -39,7 +39,7 @@ export default class CheckBoxComponent extends Field {
     get labelInfo(): {
         hidden: boolean;
     };
-    render(): string;
+    render(): Field;
     attach(element: any): Promise<void>;
     input: any;
     detach(element: any): void;

package/lib/cjs/components/columns/Columns.d.ts

@@ -14,7 +14,7 @@ export default class ColumnsComponent extends NestedComponent {
     get columnKey(): string;
     columns: any[] | undefined;
     labelIsHidden(): boolean;
-    render(): string;
+    render(): import("../_classes/field/Field").default;
     justifyColumn(items: any, index: any): boolean;
     justify(): any;
     get gridSize(): number;

package/lib/cjs/components/container/Container.d.ts

@@ -9,6 +9,7 @@ export default class ContainerComponent extends NestedDataComponent {
         schema: any;
     };
     constructor(...args: any[]);
+    addComponents(data: any, options: any): void;
     checkData(data: any, flags: any, row: any, components: any): void;
     focus(): void;
 }

package/lib/cjs/components/datagrid/DataGrid.d.ts

@@ -54,7 +54,7 @@ export default class DataGridComponent extends NestedArrayComponent {
     hasTopSubmit(): any;
     hasBottomSubmit(): any;
     get canAddColumn(): boolean;
-    render(): string;
+    render(): import("../_classes/field/Field").default;
     getRows(): {}[];
     getColumns(): any[];
     hasHeader(): any;

package/lib/cjs/components/day/Day.d.ts

@@ -84,7 +84,7 @@ export default class DayComponent extends Field {
     }[] | undefined;
     setErrorClasses(elements: any, dirty: any, hasError: any): void;
     dayFirst: any;
-    render(): string;
+    render(): Field;
     renderField(name: any): any;
     attach(element: any): Promise<void>;
     set disabled(disabled: any);

package/lib/cjs/components/editgrid/EditGrid.d.ts

@@ -35,6 +35,8 @@ export default class EditGridComponent extends NestedArrayComponent {
     get inlineEditMode(): any;
     get saveEditMode(): boolean;
     get minLength(): any;
+    set data(value: any);
+    get data(): any;
     get displayAsTable(): any;
     get iteratableRows(): any;
     get defaultValue(): any[];

package/lib/cjs/components/file/File.d.ts

@@ -45,7 +45,7 @@ export default class FileComponent extends Field {
         type: number;
         actions: number;
     };
-    render(): string;
+    render(): Field;
     getVideoStream(constraints: any): any;
     stopVideoStream(videoStream: any): void;
     getFrame(videoPlayer: any): Promise<any>;
@@ -130,7 +130,7 @@ export default class FileComponent extends Field {
         message: string;
         file?: undefined;
     } | {
-        file: any;
+        file: FormData | null;
         status?: undefined;
         message?: undefined;
     }>;

package/lib/cjs/components/number/Number.d.ts

@@ -19,7 +19,7 @@ export default class NumberComponent extends Input {
     constructor(...args: any[]);
     decimalSeparator: any;
     delimiter: any;
-    decimalLimit: any;
+    decimalLimit: number;
     numberMask: any;
     /**
      * Creates the number mask for normal numbers.

package/lib/cjs/components/radio/Radio.d.ts

@@ -43,7 +43,7 @@ export default class RadioComponent extends ListComponent {
     itemsLoadedResolve: ((value: any) => void) | undefined;
     optionsLoaded: boolean | undefined;
     loadedOptions: any[] | undefined;
-    render(): string;
+    render(): import("../_classes/field/Field").default;
     attach(element: any): Promise<void>;
     detach(element: any): void;
     validateValueProperty(): boolean;