@formio/js 5.0.0-dev.5613.3476921 → 5.0.0-dev.5614.b5c93f3

package/lib/mjs/formio.embed.d.ts

@@ -1,2 +1 @@
-export { Formio };
-import { Formio } from './Embed';
+export {};

package/lib/mjs/formio.embed.js

@@ -1,99 +1,2 @@
-import { Formio } from './Embed';
-const scripts = document.getElementsByTagName('script');
-const config = window.FormioConfig || {};
-let thisScript = null;
-let i = scripts.length;
-const scriptName = config.scriptName || 'formio.embed.';
-while (i--) {
-    if (scripts[i].src && (scripts[i].src.indexOf(scriptName) !== -1)) {
-        thisScript = scripts[i];
-        break;
-    }
-}
-if (thisScript) {
-    const query = {};
-    const queryString = thisScript.src.replace(/^[^?]+\??/, '');
-    queryString.replace(/\?/g, '&').split('&').forEach((item) => {
-        query[item.split('=')[0]] = item.split('=')[1] && decodeURIComponent(item.split('=')[1]);
-    });
-    let scriptSrc = thisScript.src.replace(/^([^?]+).*/, '$1').split('/');
-    scriptSrc.pop();
-    if (config.formioPath) {
-        config.formioPath(scriptSrc);
-    }
-    scriptSrc = scriptSrc.join('/');
-    const debug = (query.debug === 'true' || query.debug === '1');
-    const renderer = debug ? 'formio.form' : 'formio.form.min';
-    Formio.config = Object.assign({
-        script: query.script || (`${config.updatePath ? config.updatePath() : scriptSrc}/${renderer}.js`),
-        style: query.styles || (`${config.updatePath ? config.updatePath() : scriptSrc}/${renderer}.css`),
-        cdn: query.cdn,
-        class: (query.class || 'formio-form-wrapper'),
-        src: query.src,
-        form: null,
-        submission: null,
-        project: query.project,
-        base: query.base || 'https://api.form.io',
-        submit: query.submit,
-        includeLibs: (query.libs === 'true' || query.libs === '1'),
-        template: query.template,
-        debug: debug,
-        config: {},
-        redirect: (query.return || query.redirect),
-        embedCSS: (`${config.updatePath ? config.updatePath() : scriptSrc}/formio.embed.css`),
-        success: query.success || 'Thank you for your submission!',
-        before: null,
-        after: null
-    }, config);
-    const form = (Formio.config.form || Formio.config.src);
-    if (form) {
-        Formio.debug('Embedding Configuration', config);
-        if (Formio.config.addPremiumLib) {
-            Formio.config.addPremiumLib(Formio.config, scriptSrc);
-        }
-        // The id for this embedded form.
-        Formio.config.id = `formio-${Math.random().toString(36).substring(7)}`;
-        Formio.debug('Creating form element');
-        const element = Formio.createElement('div', {
-            'id': Formio.config.id,
-            class: Formio.config.class
-        });
-        // insertAfter doesn't exist, but effect is identical.
-        thisScript.parentNode.insertBefore(element, thisScript.parentNode.firstElementChild.nextSibling);
-        Formio.createForm(element, form, Formio.config.config).then((instance) => {
-            if (Formio.config.submit) {
-                instance.nosubmit = true;
-            }
-            // Configure a redirect.
-            instance.on('submit', (submission) => {
-                Formio.debug("on('submit')", submission);
-                if (Formio.config.submit) {
-                    Formio.debug(`Sending submission to ${Formio.config.submit}`);
-                    const headers = {
-                        'content-type': 'application/json'
-                    };
-                    const token = Formio.FormioClass.getToken();
-                    if (token) {
-                        headers['x-jwt-token'] = token;
-                    }
-                    Formio.FormioClass.fetch(Formio.config.submit, {
-                        body: JSON.stringify(submission),
-                        headers: headers,
-                        method: 'POST',
-                        mode: 'cors',
-                    })
-                        .then(resp => resp.json())
-                        .then(submission => Formio.submitDone(instance, submission));
-                }
-                else {
-                    Formio.submitDone(instance, submission);
-                }
-            });
-        });
-    }
-}
-else {
-    // Show an error if the script cannot be found.
-    document.write('<span>Could not locate the Embedded form.</span>');
-}
-export { Formio };
+import { embed } from './InlineEmbed';
+embed();

package/lib/mjs/formio.form.d.ts

@@ -1,10 +1,17 @@
 /**
  * Register a module
- * @param {*} plugin
- * @returns
+ * @param {any} mod - The module object to register. This can also be a function which accepts Formio as an argument.
+ * @param {Function|null} [defaultFn] - The default function to call if the module does not have a known key.
+ * @param {any} options - Options for the module.
+ * @returns {void}
  */
-export function registerModule(mod: any, defaultFn?: null, options?: {}): void;
-export function useModule(defaultFn?: null): (plugins: any, options?: {}) => void;
+export function registerModule(mod: any, defaultFn?: Function | null | undefined, options?: any): void;
+/**
+ * @param {Function|null} defaultFn - The default function to call if the module does not have a known key.
+ * @returns {void}
+ */
+export function useModule(defaultFn?: Function | null): void;
+export { Formio as FormioCore } from "./Formio";
 import Components from './components/Components';
 import Displays from './displays/Displays';
 import Providers from './providers';

package/lib/mjs/formio.form.js

@@ -8,7 +8,7 @@ import Providers from './providers';
 import Widgets from './widgets';
 import Form from './Form';
 import Utils from './utils';
-import Evaluator from './utils/Evaluator';
+import { Evaluator } from './utils/Evaluator';
 import Licenses from './licenses';
 import EventEmitter from './EventEmitter';
 import Webform from './Webform';
@@ -35,8 +35,10 @@ Formio.Formio = Formio;
 Formio.Components.setComponents(AllComponents);
 /**
  * Register a module
- * @param {*} plugin
- * @returns
+ * @param {any} mod - The module object to register. This can also be a function which accepts Formio as an argument.
+ * @param {Function|null} [defaultFn] - The default function to call if the module does not have a known key.
+ * @param {any} options - Options for the module.
+ * @returns {void}
  */
 export function registerModule(mod, defaultFn = null, options = {}) {
     if (typeof mod === 'function') {
@@ -97,6 +99,10 @@ export function registerModule(mod, defaultFn = null, options = {}) {
         }
     }
 }
+/**
+ * @param {Function|null} defaultFn - The default function to call if the module does not have a known key.
+ * @returns {void}
+ */
 export function useModule(defaultFn = null) {
     return (plugins, options = {}) => {
         plugins = _.isArray(plugins) ? plugins : [plugins];
@@ -117,5 +123,6 @@ export function useModule(defaultFn = null) {
  * Formio.plugins([plugin1, plugin2, etc], options);
  */
 Formio.use = useModule();
+export { Formio as FormioCore } from './Formio';
 // Export the components.
 export { Components, Displays, Providers, Widgets, Templates, Utils, Form, Formio, Licenses, EventEmitter, Webform };

package/lib/mjs/providers/Providers.d.ts

@@ -1,7 +1,14 @@
+/**
+ * @class Providers
+ * @classdesc Represents a collection of providers.
+ */
+/**
+ * Represents a collection of providers.
+ */
 export default class Providers {
     static providers: {
         address: {
-            [x: string]: typeof import("./address/CustomAddressProvider").CustomAddressProvider | typeof import("./address/GoogleAddressProvider").GoogleAddressProvider;
+            [x: string]: typeof import("./address/AzureAddressProvider").AzureAddressProvider | typeof import("./address/CustomAddressProvider").CustomAddressProvider | typeof import("./address/GoogleAddressProvider").GoogleAddressProvider | typeof import("./address/NominatimAddressProvider").NominatimAddressProvider;
         };
         auth: {};
         storage: {
@@ -13,8 +20,32 @@ export default class Providers {
             googledrive: typeof import("./storage/googleDrive").default;
         };
     };
-    static addProvider(type: any, name: any, provider: any): void;
-    static addProviders(type: any, providers: any): void;
-    static getProvider(type: any, name: any): any;
-    static getProviders(type: any): any;
+    /**
+     * Adds a provider to the collection.
+     * @param {string} type - The type of the provider.
+     * @param {string} name - The name of the provider.
+     * @param {Provider} provider - The provider object.
+     */
+    static addProvider(type: string, name: string, provider: Provider): void;
+    /**
+     * Adds multiple providers to the collection.
+     * @param {string} type - The type of the providers.
+     * @param {{ [key: string]: Provider }} providers - The collection of providers.
+     */
+    static addProviders(type: string, providers: {
+        [key: string]: Provider;
+    }): void;
+    /**
+     * Retrives a provider a provider from the collection.
+     * @param {string} type - The type of the provider.
+     * @param {string} name - The name of the provider.
+     * @returns {Provider | void} The provider object.
+     */
+    static getProvider(type: string, name: string): Provider | void;
+    /**
+     * Retrives all providers of a given type.
+     * @param {string} type - The type of the providers.
+     * @returns {Provider[] | void} The collection of providers.
+     */
+    static getProviders(type: string): Provider[] | void;
 }

package/lib/mjs/providers/Providers.js

@@ -2,24 +2,53 @@ import _ from 'lodash';
 import address from './address';
 import auth from './auth';
 import storage from './storage';
+/**
+ * @class Providers
+ * @classdesc Represents a collection of providers.
+ */
+/**
+ * Represents a collection of providers.
+ */
 export default class Providers {
     static providers = {
         address,
         auth,
         storage,
     };
+    /**
+     * Adds a provider to the collection.
+     * @param {string} type - The type of the provider.
+     * @param {string} name - The name of the provider.
+     * @param {Provider} provider - The provider object.
+     */
     static addProvider(type, name, provider) {
         Providers.providers[type] = Providers.providers[type] || {};
         Providers.providers[type][name] = provider;
     }
+    /**
+     * Adds multiple providers to the collection.
+     * @param {string} type - The type of the providers.
+     * @param {{ [key: string]: Provider }} providers - The collection of providers.
+     */
     static addProviders(type, providers) {
         Providers.providers[type] = _.merge(Providers.providers[type], providers);
     }
+    /**
+     * Retrives a provider a provider from the collection.
+     * @param {string} type - The type of the provider.
+     * @param {string} name - The name of the provider.
+     * @returns {Provider | void} The provider object.
+     */
     static getProvider(type, name) {
         if (Providers.providers[type] && Providers.providers[type][name]) {
             return Providers.providers[type][name];
         }
     }
+    /**
+     * Retrives all providers of a given type.
+     * @param {string} type - The type of the providers.
+     * @returns {Provider[] | void} The collection of providers.
+     */
     static getProviders(type) {
         if (Providers.providers[type]) {
             return Providers.providers[type];

package/lib/mjs/providers/address/AddressProvider.d.ts

@@ -1,17 +1,136 @@
+/**
+ * @typedef {object} RequestOptions
+ * @property {object} params - The request parameters.
+ * @property {boolean} noToken - Whether to include a token in the request.
+ */
+/**
+ * @typedef {object} Address
+ * @property {string} street - The street address.
+ * @property {string} city - The city.
+ * @property {string} state - The state.
+ * @property {string} country - The country.
+ * @property {string} postalCode - The postal code.
+ */
+/**
+ * @class AddressProvider
+ * @classdesc Represents an address provider.
+ */
 export class AddressProvider {
+    /**
+     * @static
+     * @type {string}
+     * @description The name of the address provider.
+     */
     static get name(): string;
+    /**
+     * @static
+     * @type {string}
+     * @description The display name of the address provider.
+     */
     static get displayName(): string;
-    constructor(options?: {});
+    /**
+     * @class
+     * @param {object} options - The options for the address provider.
+     */
+    constructor(options?: object);
     options: any;
-    beforeMergeOptions(): void;
-    get defaultOptions(): {};
-    get queryProperty(): string;
-    get responseProperty(): null;
-    get displayValueProperty(): null;
-    serialize(params: any): any;
-    getRequestOptions(options?: {}): any;
-    getRequestUrl(options?: {}): void;
-    makeRequest(options?: {}): any;
-    search(query: any, options?: {}): any;
-    getDisplayValue(address: any): any;
+    /**
+     * @private
+     * @description Executes before merging the options.
+     */
+    private beforeMergeOptions;
+    /**
+     * @private
+     * @type {object}
+     * @description The default options for the address provider.
+     */
+    private get defaultOptions();
+    /**
+     * @private
+     * @type {string}
+     * @description The query property name.
+     */
+    private get queryProperty();
+    /**
+     * @private
+     * @type {string|null}
+     * @description The response property name.
+     */
+    private get responseProperty();
+    /**
+     * @private
+     * @type {string|null}
+     * @description The display value property name.
+     */
+    private get displayValueProperty();
+    /**
+     * @private
+     * @param {object} params - The parameters to serialize.
+     * @returns {string} The serialized parameters.
+     */
+    private serialize;
+    /**
+     * @private
+     * @param {object} options - The request options.
+     * @returns {RequestOptions} The merged request options.
+     */
+    private getRequestOptions;
+    /**
+     * @private
+     * @param {object} _options - The request options.
+     * @throws {Error} Throws an error if the method is not implemented.
+     */
+    private getRequestUrl;
+    /**
+     * @private
+     * @param {object} options - The request options.
+     * @returns {Promise} A promise that resolves with the request result.
+     */
+    private makeRequest;
+    /**
+     * @public
+     * @description The search parameters for the request.
+     * @param {string} query - The search query.
+     * @param {object} options - The search options.
+     * @returns {Promise<Address[]>} A promise that resolves with the search results.
+     */
+    public search(query: string, options?: object): Promise<Address[]>;
+    /**
+     * @public
+     * @param {Address} address - The address object.
+     * @returns {string} The display value of the address.
+     */
+    public getDisplayValue(address: Address): string;
 }
+export type RequestOptions = {
+    /**
+     * - The request parameters.
+     */
+    params: object;
+    /**
+     * - Whether to include a token in the request.
+     */
+    noToken: boolean;
+};
+export type Address = {
+    /**
+     * - The street address.
+     */
+    street: string;
+    /**
+     * - The city.
+     */
+    city: string;
+    /**
+     * - The state.
+     */
+    state: string;
+    /**
+     * - The country.
+     */
+    country: string;
+    /**
+     * - The postal code.
+     */
+    postalCode: string;
+};

package/lib/mjs/providers/address/AddressProvider.js

@@ -1,46 +1,127 @@
 import _ from 'lodash';
 import { Formio } from '../../Formio';
+/**
+ * @typedef {object} RequestOptions
+ * @property {object} params - The request parameters.
+ * @property {boolean} noToken - Whether to include a token in the request.
+ */
+/**
+ * @typedef {object} Address
+ * @property {string} street - The street address.
+ * @property {string} city - The city.
+ * @property {string} state - The state.
+ * @property {string} country - The country.
+ * @property {string} postalCode - The postal code.
+ */
+/**
+ * @class AddressProvider
+ * @classdesc Represents an address provider.
+ */
 export class AddressProvider {
+    /**
+     * @static
+     * @type {string}
+     * @description The name of the address provider.
+     */
     static get name() {
         return 'address';
     }
+    /**
+     * @static
+     * @type {string}
+     * @description The display name of the address provider.
+     */
     static get displayName() {
         return 'Address';
     }
+    /**
+     * @class
+     * @param {object} options - The options for the address provider.
+     */
     constructor(options = {}) {
         this.beforeMergeOptions(options);
         this.options = _.merge({}, this.defaultOptions, options);
     }
+    /**
+     * @private
+     * @description Executes before merging the options.
+     */
     beforeMergeOptions() {
         return;
     }
+    /**
+     * @private
+     * @type {object}
+     * @description The default options for the address provider.
+     */
     get defaultOptions() {
         return {};
     }
+    /**
+     * @private
+     * @type {string}
+     * @description The query property name.
+     */
     get queryProperty() {
         return 'query';
     }
+    /**
+     * @private
+     * @type {string|null}
+     * @description The response property name.
+     */
     get responseProperty() {
         return null;
     }
+    /**
+     * @private
+     * @type {string|null}
+     * @description The display value property name.
+     */
     get displayValueProperty() {
         return null;
     }
+    /**
+     * @private
+     * @param {object} params - The parameters to serialize.
+     * @returns {string} The serialized parameters.
+     */
     serialize(params) {
         return _.toPairs(params).map(([key, value]) => `${encodeURIComponent(key)}=${encodeURIComponent(value)}`).join('&');
     }
+    /**
+     * @private
+     * @param {object} options - The request options.
+     * @returns {RequestOptions} The merged request options.
+     */
     getRequestOptions(options = {}) {
         return _.merge({}, this.options, options);
     }
-    // eslint-disable-next-line no-unused-vars
-    getRequestUrl(options = {}) {
+    /**
+     * @private
+     * @param {object} _options - The request options.
+     * @throws {Error} Throws an error if the method is not implemented.
+     */
+    getRequestUrl(_options = {}) {
         throw new Error('Method AddressProvider#getRequestUrl(options) is abstract.');
     }
+    /**
+     * @private
+     * @param {object} options - The request options.
+     * @returns {Promise} A promise that resolves with the request result.
+     */
     makeRequest(options = {}) {
         return Formio.makeStaticRequest(this.getRequestUrl(options), 'GET', null, {
             noToken: true,
         });
     }
+    /**
+     * @public
+     * @description The search parameters for the request.
+     * @param {string} query - The search query.
+     * @param {object} options - The search options.
+     * @returns {Promise<Address[]>} A promise that resolves with the search results.
+     */
     search(query, options = {}) {
         const requestOptions = this.getRequestOptions(options);
         const params = requestOptions.params = requestOptions.params || {};
@@ -48,6 +129,11 @@ export class AddressProvider {
         return this.makeRequest(requestOptions)
             .then((result) => this.responseProperty ? _.get(result, this.responseProperty, []) : result);
     }
+    /**
+     * @public
+     * @param {Address} address - The address object.
+     * @returns {string} The display value of the address.
+     */
     getDisplayValue(address) {
         return this.displayValueProperty ? _.get(address, this.displayValueProperty, '') : String(address);
     }

package/lib/mjs/providers/address/AzureAddressProvider.d.ts

@@ -1,12 +1,59 @@
+/**
+ * @typedef {object} AzureAddressProviderOptionsParams
+ * @property {string} 'api-version' - The version of the Azure Maps API.
+ * @property {string} typeahead - Whether to enable typeahead in the search.
+ * @typedef {object} AzureAddressProviderOptions
+ * @property {AzureAddressProviderOptionsParams} params - The parameters for the Azure Maps API request.
+ */
+/**
+ * @class
+ * @augments AddressProvider
+ * @classdesc Represents an Azure Maps address provider.
+ */
 export class AzureAddressProvider extends AddressProvider {
+    /**
+     * Gets the default options for the address provider.
+     * @returns {{ params: { 'api-version': string, typeahead: string } }} The default options.
+     */
     get defaultOptions(): {
         params: {
             'api-version': string;
             typeahead: string;
         };
     };
+    /**
+     * Gets the response property for the address provider.
+     * @type {string}
+     */
     get responseProperty(): string;
+    /**
+     * Gets the display value property for the address provider.
+     * @type {string}
+     */
     get displayValueProperty(): string;
-    getRequestUrl(options?: {}): string;
+    /**
+     * Gets the request URL for the address provider.
+     * @param {{params: any}} options - The request options.
+     * @returns {string} The request URL.
+     */
+    getRequestUrl(options?: {
+        params: any;
+    }): string;
 }
+export type AzureAddressProviderOptionsParams = {
+    /**
+     * 'api-version' - The version of the Azure Maps API.
+     */
+    "": string;
+    /**
+     * - Whether to enable typeahead in the search.
+     */
+    typeahead: string;
+};
+export type AzureAddressProviderOptions = {
+    /**
+     * - The parameters for the Azure Maps API request.
+     */
+    params: AzureAddressProviderOptionsParams;
+};
 import { AddressProvider } from './AddressProvider';

package/lib/mjs/providers/address/AzureAddressProvider.js

@@ -1,11 +1,35 @@
 import { AddressProvider } from './AddressProvider';
+/**
+ * @typedef {object} AzureAddressProviderOptionsParams
+ * @property {string} 'api-version' - The version of the Azure Maps API.
+ * @property {string} typeahead - Whether to enable typeahead in the search.
+ * @typedef {object} AzureAddressProviderOptions
+ * @property {AzureAddressProviderOptionsParams} params - The parameters for the Azure Maps API request.
+ */
+/**
+ * @class
+ * @augments AddressProvider
+ * @classdesc Represents an Azure Maps address provider.
+ */
 export class AzureAddressProvider extends AddressProvider {
+    /**
+     * Gets the name of the address provider.
+     * @type {string}
+     */
     static get name() {
         return 'azure';
     }
+    /**
+     * Gets the display name of the address provider.
+     * @type {string}
+     */
     static get displayName() {
         return 'Azure Maps';
     }
+    /**
+     * Gets the default options for the address provider.
+     * @returns {{ params: { 'api-version': string, typeahead: string } }} The default options.
+     */
     get defaultOptions() {
         return {
             params: {
@@ -14,12 +38,25 @@ export class AzureAddressProvider extends AddressProvider {
             },
         };
     }
+    /**
+     * Gets the response property for the address provider.
+     * @type {string}
+     */
     get responseProperty() {
         return 'results';
     }
+    /**
+     * Gets the display value property for the address provider.
+     * @type {string}
+     */
     get displayValueProperty() {
         return 'address.freeformAddress';
     }
+    /**
+     * Gets the request URL for the address provider.
+     * @param {{params: any}} options - The request options.
+     * @returns {string} The request URL.
+     */
     getRequestUrl(options = {}) {
         const { params } = options;
         return `https://atlas.microsoft.com/search/address/json?${this.serialize(params)}`;