@formio/js 5.0.0-rc.54 → 5.0.0-rc.56

package/dist/formio.utils.min.js.LICENSE.txt

@@ -18,11 +18,11 @@
  * MIT licensed
  */
 
-/*! @license DOMPurify 3.1.2 | (c) Cure53 and other contributors | Released under the Apache license 2.0 and Mozilla Public License 2.0 | github.com/cure53/DOMPurify/blob/3.1.2/LICENSE */
-
 /*! @license DOMPurify 3.1.3 | (c) Cure53 and other contributors | Released under the Apache license 2.0 and Mozilla Public License 2.0 | github.com/cure53/DOMPurify/blob/3.1.3/LICENSE */
 
-/*! formiojs v5.0.0-rc.54 | https://unpkg.com/formiojs@5.0.0-rc.54/LICENSE.txt */
+/*! @license DOMPurify 3.1.4 | (c) Cure53 and other contributors | Released under the Apache license 2.0 and Mozilla Public License 2.0 | github.com/cure53/DOMPurify/blob/3.1.4/LICENSE */
+
+/*! formiojs v5.0.0-rc.56 | https://unpkg.com/formiojs@5.0.0-rc.56/LICENSE.txt */
 
 /**
  * @license

package/lib/cjs/Element.d.ts

@@ -233,10 +233,11 @@ export default class Element {
      * @param {string|Function|object} func - The function or string to evaluate.
      * @param {object} args - The arguments to pass to the evaluation.
      * @param {string} ret - The name of the variable within the evaluation context to return.
-     * @param {boolean} tokenize - Determines if it should replace all {{ }} token references with actual data.
+     * @param {boolean} interpolate - Determines if it should replace all {{ }} token references with actual data.
+     * @param {import('@formio/core').EvaluatorOptions} options - The options to pass to the evaluation.
      * @returns {*} - The result of the evaluation.
      */
-    evaluate(func: string | Function | object, args: object, ret: string, tokenize: boolean): any;
+    evaluate(func: string | Function | object, args: object, ret: string, interpolate: boolean, options?: import('@formio/core').EvaluatorOptions): any;
     /**
      * Allow for options to hook into the functionality of this renderer.
      * @returns {*} - The result of the hook function.

package/lib/cjs/Element.js

@@ -563,11 +563,12 @@ class Element {
      * @param {string|Function|object} func - The function or string to evaluate.
      * @param {object} args - The arguments to pass to the evaluation.
      * @param {string} ret - The name of the variable within the evaluation context to return.
-     * @param {boolean} tokenize - Determines if it should replace all {{ }} token references with actual data.
+     * @param {boolean} interpolate - Determines if it should replace all {{ }} token references with actual data.
+     * @param {import('@formio/core').EvaluatorOptions} options - The options to pass to the evaluation.
      * @returns {*} - The result of the evaluation.
      */
-    evaluate(func, args, ret, tokenize) {
-        return FormioUtils.evaluate(func, this.evalContext(args), ret, tokenize);
+    evaluate(func, args, ret, interpolate, options = {}) {
+        return FormioUtils.evaluate(func, this.evalContext(args), ret, interpolate, options);
     }
     /**
      * Allow for options to hook into the functionality of this renderer.

package/lib/cjs/Embed.js

@@ -297,14 +297,17 @@ class Formio {
             if (_a.config.template && _a.config.includeLibs) {
                 yield _a.addLibrary(libWrapper, _a.config.libs[_a.config.template], _a.config.template);
             }
-            // Add the premium modules.
+            if (!_a.config.libraries) {
+                _a.config.libraries = _a.config.modules || {};
+            }
+            // Adding premium if it is provided via the config.
             if (_a.config.premium) {
-                _a.config.modules.premium = _a.config.premium;
+                _a.config.libraries.premium = _a.config.premium;
             }
             // Allow adding dynamic modules.
-            if (_a.config.modules) {
-                for (const name in _a.config.modules) {
-                    const lib = _a.config.modules[name];
+            if (_a.config.libraries) {
+                for (const name in _a.config.libraries) {
+                    const lib = _a.config.libraries[name];
                     lib.use = lib.use || true;
                     yield _a.addLibrary(libWrapper, lib, name);
                 }

package/lib/cjs/Form.d.ts

@@ -15,32 +15,32 @@ export default class Form extends Element {
      */
     /**
      * @typedef {object} FormioHooks
-     * @property {Function} [beforeSubmit]
-     * @property {Function} [beforeCancel]
-     * @property {Function} [beforeNext]
-     * @property {Function} [beforePrev]
-     * @property {Function} [attachComponent]
-     * @property {Function} [setDataValue]
-     * @property {Function} [addComponents]
-     * @property {Function} [addComponent]
-     * @property {Function} [customValidation]
-     * @property {Function} [attachWebform]
+     * @property {Function} [beforeSubmit] - Called before a submission is made.
+     * @property {Function} [beforeCancel] - Called before a cancel is made.
+     * @property {Function} [beforeNext] - Called before the next page is navigated to.
+     * @property {Function} [beforePrev] - Called before the previous page is navigated to.
+     * @property {Function} [attachComponent] - Called when a component is attached.
+     * @property {Function} [setDataValue] - Called when a data value is set.
+     * @property {Function} [addComponents] - Called when components are added.
+     * @property {Function} [addComponent] - Called when a component is added.
+     * @property {Function} [customValidation] - Called when a custom validation is made.
+     * @property {Function} [attachWebform] - Called when a webform is attached.
      */
     /**
      * @typedef {object} SanitizeConfig
-     * @property {string[]} [addAttr]
-     * @property {string[]} [addTags]
-     * @property {string[]} [allowedAttrs]
-     * @property {string[]} [allowedTags]
-     * @property {string[]} [allowedUriRegex]
-     * @property {string[]} [addUriSafeAttr]
+     * @property {string[]} [addAttr] - The html attributes to allow with sanitization.
+     * @property {string[]} [addTags] - The html tags to allow with sanitization.
+     * @property {string[]} [allowedAttrs] - The html attributes to allow with sanitization.
+     * @property {string[]} [allowedTags] - The html tags to allow with sanitization.
+     * @property {string[]} [allowedUriRegex] - The regex for allowed URIs.
+     * @property {string[]} [addUriSafeAttr] - The URI attributes to allow with sanitization.
      */
     /**
      * @typedef {object} ButtonSettings
-     * @property {boolean} [showPrevious]
-     * @property {boolean} [showNext]
-     * @property {boolean} [showCancel]
-     * @property {boolean} [showSubmit]
+     * @property {boolean} [showPrevious] - Show the previous button in wizard forms.
+     * @property {boolean} [showNext] - Show the next button in wizard forms.
+     * @property {boolean} [showCancel] - Show the cancel button in wizard forms.
+     * @property {boolean} [showSubmit] - Show the submit button in wizard forms.
      */
     /**
      * @typedef {object} FormOptions
@@ -212,15 +212,45 @@ export default class Form extends Element {
          * - The hooks for this form.
          */
         hooks?: {
+            /**
+             * - Called before a submission is made.
+             */
             beforeSubmit?: Function | undefined;
+            /**
+             * - Called before a cancel is made.
+             */
             beforeCancel?: Function | undefined;
+            /**
+             * - Called before the next page is navigated to.
+             */
             beforeNext?: Function | undefined;
+            /**
+             * - Called before the previous page is navigated to.
+             */
             beforePrev?: Function | undefined;
+            /**
+             * - Called when a component is attached.
+             */
             attachComponent?: Function | undefined;
+            /**
+             * - Called when a data value is set.
+             */
             setDataValue?: Function | undefined;
+            /**
+             * - Called when components are added.
+             */
             addComponents?: Function | undefined;
+            /**
+             * - Called when a component is added.
+             */
             addComponent?: Function | undefined;
+            /**
+             * - Called when a custom validation is made.
+             */
             customValidation?: Function | undefined;
+            /**
+             * - Called when a webform is attached.
+             */
             attachWebform?: Function | undefined;
         } | undefined;
         /**
@@ -251,20 +281,50 @@ export default class Form extends Element {
          * - The sanitize configuration for this form.
          */
         sanitizeConfig?: {
+            /**
+             * - The html attributes to allow with sanitization.
+             */
             addAttr?: string[] | undefined;
+            /**
+             * - The html tags to allow with sanitization.
+             */
             addTags?: string[] | undefined;
+            /**
+             * - The html attributes to allow with sanitization.
+             */
             allowedAttrs?: string[] | undefined;
+            /**
+             * - The html tags to allow with sanitization.
+             */
             allowedTags?: string[] | undefined;
+            /**
+             * - The regex for allowed URIs.
+             */
             allowedUriRegex?: string[] | undefined;
+            /**
+             * - The URI attributes to allow with sanitization.
+             */
             addUriSafeAttr?: string[] | undefined;
         } | undefined;
         /**
          * - The button settings for this form.
          */
         buttonSettings?: {
+            /**
+             * - Show the previous button in wizard forms.
+             */
             showPrevious?: boolean | undefined;
+            /**
+             * - Show the next button in wizard forms.
+             */
             showNext?: boolean | undefined;
+            /**
+             * - Show the cancel button in wizard forms.
+             */
             showCancel?: boolean | undefined;
+            /**
+             * - Show the submit button in wizard forms.
+             */
             showSubmit?: boolean | undefined;
         } | undefined;
         /**
@@ -300,13 +360,13 @@ export default class Form extends Element {
     /**
      * Create a new form instance provided the display of the form.
      * @param {string} display - The display of the form, either "wizard", "form", or "pdf"
-     * @returns {*}
+     * @returns {Webform|Wizard|PDF} - The new form instance for the display.
      */
-    create(display: string): any;
+    create(display: string): Webform | Wizard | PDF;
     /**
      * Sets the form. Either as JSON or a URL to a form JSON schema.
      * @param {string|object} formParam - Either the form JSON or the URL of the form json.
-     * @returns {*}
+     * @returns {void}
      */
     set form(formParam: object);
     /**
@@ -332,35 +392,38 @@ export default class Form extends Element {
     /**
      * Check Subdirectories path and provide correct options
      * @param {string} url - The the URL of the form json.
-     * @param {form} object - The form json.
-     * @param form
+     * @param {import('@formio/core').Form} form - The form json.
      * @returns {object} The initial options with base and project.
      */
-    getFormInitOptions(url: string, form: any): object;
-    setForm(formParam: any): any;
+    getFormInitOptions(url: string, form: import('@formio/core').Form): object;
+    /**
+     * Sets the form to the JSON schema of a form.
+     * @param {import('@formio/core').Form} formParam - The form JSON to set this form to.
+     * @returns {Promise<Webform|Wizard|PDF>} - The webform instance that was created.
+     */
+    setForm(formParam: import('@formio/core').Form): Promise<Webform | Wizard | PDF>;
     _form: any;
     getSubmission(formio: any, opts: any): any;
     /**
      * Changes the display of the form.
      * @param {string} display - The display to set this form. Either "wizard", "form", or "pdf"
-     * @returns {Promise<T>}
+     * @returns {Promise<Webform|Wizard|PDF>} - The form instance that was created after changing the display.
      */
-    setDisplay(display: string): Promise<T>;
+    setDisplay(display: string): Promise<Webform | Wizard | PDF>;
     empty(): void;
     /**
      * Sanitize an html string.
-     * @param string
-     * @param dirty
-     * @param forceSanitize
-     * @returns {*}
+     * @param {string} dirty - The dirty html string to sanitize.
+     * @param {boolean} forceSanitize - If the string should be force sanitized.
+     * @returns {string} - The sanitized html string.
      */
-    sanitize(dirty: any, forceSanitize: any): any;
+    sanitize(dirty: string, forceSanitize: boolean): string;
     setContent(element: any, content: any, forceSanitize: any): boolean;
     /**
      * Build a new form.
-     * @returns {Promise<T>}
+     * @returns {Promise<Webform|Wizard|PDF>} - The form instance that was created.
      */
-    build(): Promise<T>;
+    build(): Promise<Webform | Wizard | PDF>;
     render(): Promise<any>;
     attach(element: any): any;
 }

package/lib/cjs/Form.js

@@ -120,7 +120,7 @@ class Form extends Element_1.default {
     /**
      * Create a new form instance provided the display of the form.
      * @param {string} display - The display of the form, either "wizard", "form", or "pdf"
-     * @returns {*}
+     * @returns {Webform|Wizard|PDF} - The new form instance for the display.
      */
     create(display) {
         if (this.options && (this.options.flatten || this.options.renderMode === 'flat')) {
@@ -138,7 +138,7 @@ class Form extends Element_1.default {
     /**
      * Sets the form. Either as JSON or a URL to a form JSON schema.
      * @param {string|object} formParam - Either the form JSON or the URL of the form json.
-     * @returns {*}
+     * @returns {void}
      */
     set form(formParam) {
         this.setForm(formParam);
@@ -167,8 +167,7 @@ class Form extends Element_1.default {
     /**
      * Check Subdirectories path and provide correct options
      * @param {string} url - The the URL of the form json.
-     * @param {form} object - The form json.
-     * @param form
+     * @param {import('@formio/core').Form} form - The form json.
      * @returns {object} The initial options with base and project.
      */
     getFormInitOptions(url, form) {
@@ -194,6 +193,11 @@ class Form extends Element_1.default {
         }
         return {};
     }
+    /**
+     * Sets the form to the JSON schema of a form.
+     * @param {import('@formio/core').Form} formParam - The form JSON to set this form to.
+     * @returns {Promise<Webform|Wizard|PDF>} - The webform instance that was created.
+     */
     setForm(formParam) {
         let result;
         formParam = formParam || this.form;
@@ -262,7 +266,7 @@ class Form extends Element_1.default {
     /**
      * Changes the display of the form.
      * @param {string} display - The display to set this form. Either "wizard", "form", or "pdf"
-     * @returns {Promise<T>}
+     * @returns {Promise<Webform|Wizard|PDF>} - The form instance that was created after changing the display.
      */
     setDisplay(display) {
         if ((this.display === display) && this.instance) {
@@ -303,10 +307,9 @@ class Form extends Element_1.default {
     }
     /**
      * Sanitize an html string.
-     * @param string
-     * @param dirty
-     * @param forceSanitize
-     * @returns {*}
+     * @param {string} dirty - The dirty html string to sanitize.
+     * @param {boolean} forceSanitize - If the string should be force sanitized.
+     * @returns {string} - The sanitized html string.
      */
     sanitize(dirty, forceSanitize) {
         // If Sanitize is turned off
@@ -324,7 +327,7 @@ class Form extends Element_1.default {
     }
     /**
      * Build a new form.
-     * @returns {Promise<T>}
+     * @returns {Promise<Webform|Wizard|PDF>} - The form instance that was created.
      */
     build() {
         if (!this.instance) {
@@ -380,14 +383,16 @@ exports.default = Form;
 // Allow simple embedding.
 Formio_1.Formio.embedForm = (embed) => Form.embed(embed);
 /**
- * Factory that creates a new form based on the form parameters.
- * @param element {HMTLElement} - The HTML Element to add this form to.
- * @param form {string|Object} - The src of the form, or a form object.
- * @param options {Object} - The options to create this form.
- * @param {...any} args
- * @returns {Promise} - When the form is instance is ready.
+ * Creates an easy to use interface for embedding webforms, pdfs, and wizards into your application.
+ * @param {object} elementOrForm - The DOM element you wish to render this form within, or the form definition.
+ * @param {object | string | FormOptions} formOrOptions - A Form JSON schema, the URL of a hosted form, or the form options.
+ * @param {FormOptions} [options] - The options to create a new form instance.
+ * @returns {Promise<Webform|Wizard|PDF>} - The form instance that was created.
+ * @example
+ * import { Formio } from '@formio/js';
+ * Formio.createForm(document.getElementById('formio'), 'https://examples.form.io/example');
  */
-Formio_1.Formio.createForm = (...args) => {
-    return (new Form(...args)).ready;
+Formio_1.Formio.createForm = (elementOrForm, formOrOptions, options) => {
+    return (new Form(elementOrForm, formOrOptions, options)).ready;
 };
 Formio_1.Formio.Form = Form;

package/lib/cjs/PDF.d.ts

@@ -11,23 +11,24 @@ export default class PDF extends Webform {
     iframeElement: any;
     /**
      * Get the submission from the iframe.
-     * @returns {Promise<any>}
+     * @returns {Promise<any>} - The submission from the iframe.
      */
     getSubmission(): Promise<any>;
     /**
      * Ensure we have the submission from the iframe before we submit the form.
-     * @param options
-     * @returns {*}
+     * @param {any} options - The options for submission.
+     * @returns {Promise<any>} - Resolves when the form is submitted.
      */
-    submitForm(options?: {}): any;
+    submitForm(options?: any): Promise<any>;
     getSrc(): string;
     setForm(form: any, flags?: {}): Promise<void>;
     /**
      * Set's the value of this form component.
-     * @param submission
-     * @param flags
+     * @param {import('@formio/core').Submission} submission - The submission JSON to set the value of this form.
+     * @param {any} flags - The flags to use when setting the submission.
+     * @returns {boolean} - If the value changed or not.
      */
-    setValue(submission: any, flags?: {}): boolean;
+    setValue(submission: import('@formio/core').Submission, flags?: any): boolean;
     postMessage(message: any): void;
     iframeFormSetUp: boolean | undefined;
     focusOnComponent(key: any): void;

package/lib/cjs/PDF.js

@@ -143,7 +143,7 @@ class PDF extends Webform_1.default {
     }
     /**
      * Get the submission from the iframe.
-     * @returns {Promise<any>}
+     * @returns {Promise<any>} - The submission from the iframe.
      */
     getSubmission() {
         return new Promise((resolve) => {
@@ -153,8 +153,8 @@ class PDF extends Webform_1.default {
     }
     /**
      * Ensure we have the submission from the iframe before we submit the form.
-     * @param options
-     * @returns {*}
+     * @param {any} options - The options for submission.
+     * @returns {Promise<any>} - Resolves when the form is submitted.
      */
     submitForm(options = {}) {
         this.postMessage({ name: 'getErrors' });
@@ -196,8 +196,9 @@ class PDF extends Webform_1.default {
     }
     /**
      * Set's the value of this form component.
-     * @param submission
-     * @param flags
+     * @param {import('@formio/core').Submission} submission - The submission JSON to set the value of this form.
+     * @param {any} flags - The flags to use when setting the submission.
+     * @returns {boolean} - If the value changed or not.
      */
     setValue(submission, flags = {}) {
         const changed = super.setValue(submission, flags);

package/lib/cjs/Webform.d.ts

@@ -83,9 +83,6 @@
  * @property {boolean} [building] - If we are in the process of building the form.
  * @property {number} [zoom] - The zoom for PDF forms.
  */
-/**
- * Renders a Form.io form within the webpage.
- */
 declare class Webform extends NestedDataComponent {
     /**
      * Creates a new Form instance.
@@ -301,7 +298,7 @@ declare class Webform extends NestedDataComponent {
      * @param {any} flags - Any flags to apply when setting the form.
      * @returns {Promise} - The promise that is triggered when the form is set.
      */
-    setForm(form: object, flags: any): Promise<any>;
+    setForm(form: object, flags?: any): Promise<any>;
     initialized: boolean | undefined;
     /**
      * Sets the form value.

package/lib/cjs/Webform.js

@@ -134,23 +134,20 @@ function getOptions(options) {
  * @property {boolean} [building] - If we are in the process of building the form.
  * @property {number} [zoom] - The zoom for PDF forms.
  */
-/**
- * Renders a Form.io form within the webpage.
- */
 class Webform extends NestedDataComponent_1.default {
     /**
      * Creates a new Form instance.
      * @param {HTMLElement | object | import('Form').FormOptions} [elementOrOptions] - The DOM element to render this form within or the options to create this form instance.
      * @param {import('Form').FormOptions} [options] - The options to create a new form instance.
      */
-    constructor(elementOrOptions, options) {
+    constructor(elementOrOptions, options = undefined) {
         let element, formOptions;
         if (elementOrOptions instanceof HTMLElement || options) {
             element = elementOrOptions;
-            formOptions = options;
+            formOptions = options || {};
         }
         else {
-            formOptions = elementOrOptions;
+            formOptions = elementOrOptions || {};
         }
         super(null, getOptions(formOptions));
         this.executeShortcuts = (event) => {
@@ -196,7 +193,7 @@ class Webform extends NestedDataComponent_1.default {
         this._loading = false;
         this._form = {};
         this.draftEnabled = false;
-        this.savingDraft = true;
+        this.savingDraft = false;
         if (this.options.saveDraftThrottle) {
             this.triggerSaveDraft = lodash_1.default.throttle(this.saveDraft.bind(this), this.options.saveDraftThrottle);
         }
@@ -293,14 +290,20 @@ class Webform extends NestedDataComponent_1.default {
         // Set language after everything is established.
         this.language = this.i18next.language;
         // See if we need to restore the draft from a user.
-        if (this.options.saveDraft && !this.options.skipDraftRestore) {
-            this.formReady.then(() => {
-                const user = Formio_1.Formio.getUser();
-                // Only restore a draft if the submission isn't explicitly set.
-                if (user && !this.submissionSet) {
-                    this.restoreDraft(user._id);
-                }
-            });
+        if (this.options.saveDraft) {
+            if (this.options.skipDraftRestore) {
+                this.draftEnabled = true;
+                this.savingDraft = false;
+            }
+            else {
+                this.formReady.then(() => {
+                    const user = Formio_1.Formio.getUser();
+                    // Only restore a draft if the submission isn't explicitly set.
+                    if (user && !this.submissionSet) {
+                        this.restoreDraft(user._id);
+                    }
+                });
+            }
         }
         this.component.clearOnHide = false;
         // Ensure the root is set to this component.
@@ -577,7 +580,7 @@ class Webform extends NestedDataComponent_1.default {
      * @param {any} flags - Any flags to apply when setting the form.
      * @returns {Promise} - The promise that is triggered when the form is set.
      */
-    setForm(form, flags) {
+    setForm(form, flags = {}) {
         var _a, _b, _c;
         const isFormAlreadySet = this._form && ((_a = this._form.components) === null || _a === void 0 ? void 0 : _a.length);
         try {

package/lib/cjs/WebformBuilder.d.ts

@@ -56,9 +56,10 @@ export default class WebformBuilder extends Component {
     /**
      * When a component sets its api key, we need to check if it is unique within its namespace. Find the namespace root
      * so we can calculate this correctly.
-     * @param component
+     * @param {import('@formio/core').Component} component - The component to find the namespace root for.
+     * @returns {import('@formio/core').Component[]} - The components root for this namespace.
      */
-    findNamespaceRoot(component: any): any;
+    findNamespaceRoot(component: import('@formio/core').Component): import('@formio/core').Component[];
     recurseNamespace(component: any): any;
     render(): any;
     attach(element: any): Promise<any>;
@@ -80,13 +81,13 @@ export default class WebformBuilder extends Component {
     highlightInvalidComponents(): void;
     /**
      * Called when a new component is saved.
-     * @param parent
-     * @param component
-     * @param isNew
-     * @param original
-     * @returns {boolean}
+     * @param {Component} component - The component instance to save.
+     * @param {Component} parent - The parent component.
+     * @param {boolean} isNew - If this is a new component.
+     * @param {Component} original - The original component.
+     * @returns {boolean} - If the component was saved.
      */
-    saveComponent(component: any, parent: any, isNew: any, original: any): boolean;
+    saveComponent(component: Component, parent: Component, isNew: boolean, original: Component): boolean;
     isComponentCreated: boolean | undefined;
     emitSaveComponentEvent(schema: any, originalComp: any, parentComponentSchema: any, path: any, index: any, isNew: any, originalComponentSchema: any): void;
     attachEditComponentControls(component: any, parent: any, isNew: any, original: any, ComponentClass: any): void;
@@ -106,16 +107,16 @@ export default class WebformBuilder extends Component {
     addNewComponent(element: any): void;
     /**
      * Creates copy of component schema and stores it under sessionStorage.
-     * @param {Component} component
-     * @returns {*}
+     * @param {Component} component - The component to copy.
+     * @returns {void}
      */
-    copyComponent(component: Component): any;
+    copyComponent(component: Component): void;
     /**
      * Paste copied component after the current component.
-     * @param {Component} component
-     * @returns {*}
+     * @param {Component} component - The component to paste after.
+     * @returns {void}
      */
-    pasteComponent(component: Component): any;
+    pasteComponent(component: Component): void;
     isParentSaveChildMethod(parentComp: any): boolean;
     getParentElement(element: any): any;
     addBuilderComponentInfo(component: any): any;

package/lib/cjs/WebformBuilder.js

@@ -428,7 +428,8 @@ class WebformBuilder extends Component_1.default {
     /**
      * When a component sets its api key, we need to check if it is unique within its namespace. Find the namespace root
      * so we can calculate this correctly.
-     * @param component
+     * @param {import('@formio/core').Component} component - The component to find the namespace root for.
+     * @returns {import('@formio/core').Component[]} - The components root for this namespace.
      */
     findNamespaceRoot(component) {
         const path = (0, utils_1.getArrayFromComponentPath)(component.path);
@@ -1133,11 +1134,11 @@ class WebformBuilder extends Component_1.default {
     }
     /**
      * Called when a new component is saved.
-     * @param parent
-     * @param component
-     * @param isNew
-     * @param original
-     * @returns {boolean}
+     * @param {Component} component - The component instance to save.
+     * @param {Component} parent - The parent component.
+     * @param {boolean} isNew - If this is a new component.
+     * @param {Component} original - The original component.
+     * @returns {boolean} - If the component was saved.
      */
     saveComponent(component, parent, isNew, original) {
         this.editForm.detach();
@@ -1504,8 +1505,8 @@ class WebformBuilder extends Component_1.default {
     }
     /**
      * Creates copy of component schema and stores it under sessionStorage.
-     * @param {Component} component
-     * @returns {*}
+     * @param {Component} component - The component to copy.
+     * @returns {void}
      */
     copyComponent(component) {
         if (!window.sessionStorage) {
@@ -1516,8 +1517,8 @@ class WebformBuilder extends Component_1.default {
     }
     /**
      * Paste copied component after the current component.
-     * @param {Component} component
-     * @returns {*}
+     * @param {Component} component - The component to paste after.
+     * @returns {void}
      */
     pasteComponent(component) {
         if (!window.sessionStorage) {