@sprucelabs/spruce-form-utils 12.0.22 → 12.0.23

package/build/__tests__/support/formAssert.js

@@ -11,4 +11,3 @@ const formAssert = {
     },
 };
 exports.default = formAssert;
-//# sourceMappingURL=formAssert.js.map

package/build/completing/FormPlayerCard.vc.js

@@ -182,4 +182,3 @@ class FormPlayerCardViewController extends heartwood_view_controllers_1.Abstract
 }
 exports.default = FormPlayerCardViewController;
 FormPlayerCardViewController.id = 'form-player-card';
-//# sourceMappingURL=FormPlayerCard.vc.js.map

package/build/completing/formCompletionCalculator.js

@@ -53,4 +53,3 @@ const formCompletionCalculator = {
     },
 };
 exports.default = formCompletionCalculator;
-//# sourceMappingURL=formCompletionCalculator.js.map

package/build/esm/__tests__/support/formAssert.d.ts

@@ -0,0 +1,4 @@
+declare const formAssert: {
+    valuesAreEqual(obj: any, form: any): void;
+};
+export default formAssert;

package/build/esm/__tests__/support/formAssert.js

@@ -0,0 +1,11 @@
+import { assert } from '@sprucelabs/test-utils';
+const formAssert = {
+    valuesAreEqual(obj, form) {
+        assert.isEqual(JSON.stringify(obj, (key, value) => {
+            return value === null ? undefined : value;
+        }, 2), JSON.stringify(form, (key, value) => {
+            return value === null ? undefined : value;
+        }, 2));
+    },
+};
+export default formAssert;

package/build/esm/completing/FormPlayerCard.vc.d.ts

@@ -0,0 +1,48 @@
+import { AbstractViewController, FormViewController, SwipeCardViewController, ViewControllerOptions, Router } from '@sprucelabs/heartwood-view-controllers';
+import { SpruceSchemas } from '@sprucelabs/spruce-core-schemas';
+export default class FormPlayerCardViewController extends AbstractViewController<SpruceSchemas.HeartwoodViewControllers.v2021_02_11.Card> {
+    private swipeVc;
+    static id: string;
+    private onChangeHandler?;
+    private builderSource;
+    private shouldIgnoreChanges;
+    private router?;
+    constructor(options: FormPlayerCardViewControllerOptions & ViewControllerOptions);
+    private SwipeVc;
+    private handleSlideChange;
+    private renderFooter;
+    private handleClickSaveProgress;
+    private handleClickSaveAndDone;
+    private handleClickNext;
+    private renderHeader;
+    setIsBusy(isLoading: boolean): void;
+    private renderSlides;
+    private handleOnChange;
+    getHasCriticalError(): boolean;
+    getIsBusy(): boolean;
+    setCriticalError(err: SpruceSchemas.HeartwoodViewControllers.v2021_02_11.CriticalError): void;
+    getSwipeVc(): SwipeCardViewController;
+    load(options: PlayerLoadOptions): Promise<void>;
+    private updateFooter;
+    setValues(values: FormPlayerImportObject['values']): Promise<void>;
+    getValues(): Record<string, any>[];
+    getFormVcs(): FormViewController<any>[];
+    getFormVc(idx: number): FormViewController<any>;
+    getSourceBuilder(): Partial<FormPlayerImportObject>;
+    render(): SpruceSchemas.HeartwoodViewControllers.v2021_02_11.Card;
+}
+export declare type FormPlayerImportObject = SpruceSchemas.HeartwoodViewControllers.v2021_02_11.FormBuilderImportExportObject & {
+    values: Record<string, any>[];
+};
+declare type ChangeHandler = (options: {
+    values: Record<string, any>[];
+}) => Promise<void> | void;
+export declare type FormPlayerCardViewControllerOptions = Partial<FormPlayerImportObject> & {
+    onChange?: ChangeHandler;
+    isBusy?: boolean;
+    id?: string;
+};
+export declare type PlayerLoadOptions = Partial<FormPlayerImportObject> & {
+    router?: Router;
+};
+export {};

package/build/esm/completing/FormPlayerCard.vc.js

@@ -0,0 +1,202 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __rest = (this && this.__rest) || function (s, e) {
+    var t = {};
+    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
+        t[p] = s[p];
+    if (s != null && typeof Object.getOwnPropertySymbols === "function")
+        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
+            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
+                t[p[i]] = s[p[i]];
+        }
+    return t;
+};
+import { AbstractViewController, removeUniversalViewOptions, } from '@sprucelabs/heartwood-view-controllers';
+import { SchemaError } from '@sprucelabs/schema';
+export default class FormPlayerCardViewController extends AbstractViewController {
+    constructor(options) {
+        super(options);
+        this.shouldIgnoreChanges = false;
+        const { onChange, isBusy, id } = options, builderSource = __rest(options, ["onChange", "isBusy", "id"]);
+        this.builderSource = removeUniversalViewOptions(builderSource);
+        this.swipeVc = this.SwipeVc(id, builderSource);
+        if (!options.pages || isBusy) {
+            this.swipeVc.setIsBusy(true);
+        }
+        else if (options.values) {
+            void this.setValues(options.values);
+        }
+        this.onChangeHandler = onChange;
+    }
+    SwipeVc(id, builderSource) {
+        return this.Controller('swipeCard', {
+            id,
+            header: this.renderHeader(builderSource),
+            slides: this.renderSlides(builderSource),
+            footer: this.renderFooter(),
+            onSlideChange: this.handleSlideChange.bind(this),
+        });
+    }
+    handleSlideChange() {
+        this.updateFooter();
+    }
+    renderFooter() {
+        var _a, _b, _c, _d;
+        const totalPages = (_b = (_a = this.builderSource.pages) === null || _a === void 0 ? void 0 : _a.length) !== null && _b !== void 0 ? _b : 0;
+        const currentPage = (_d = (_c = this.swipeVc) === null || _c === void 0 ? void 0 : _c.getPresentSlide()) !== null && _d !== void 0 ? _d : 0;
+        const buttons = [
+            {
+                id: 'saveProgress',
+                label: 'Save progress',
+                onClick: this.handleClickSaveProgress.bind(this),
+            },
+        ];
+        if (totalPages === currentPage + 1) {
+            buttons.push({
+                id: 'save',
+                label: 'Save and be done',
+                type: 'primary',
+                onClick: this.handleClickSaveAndDone.bind(this),
+            });
+        }
+        else {
+            buttons.push({
+                id: 'next',
+                label: 'Next page',
+                type: 'primary',
+                onClick: this.handleClickNext.bind(this),
+            });
+        }
+        return {
+            buttons,
+        };
+    }
+    handleClickSaveProgress() {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield this.alert({
+                message: `Progress saved! 💪`,
+                style: 'success',
+            });
+        });
+    }
+    handleClickSaveAndDone() {
+        var _a;
+        return __awaiter(this, void 0, void 0, function* () {
+            yield this.alert({
+                message: `Progress saved, lets get outa here! 🚀`,
+                style: 'success',
+            });
+            yield ((_a = this.router) === null || _a === void 0 ? void 0 : _a.redirect('profile.root'));
+        });
+    }
+    handleClickNext() {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield this.swipeVc.jumpToSlide(this.swipeVc.getPresentSlide() + 1);
+        });
+    }
+    renderHeader(options) {
+        var _a;
+        return {
+            title: (_a = options.title) !== null && _a !== void 0 ? _a : 'Loading your form...',
+            subtitle: options.subtitle,
+        };
+    }
+    setIsBusy(isLoading) {
+        this.swipeVc.setIsBusy(isLoading);
+    }
+    renderSlides(options) {
+        var _a, _b;
+        return ((_b = (_a = options.pages) === null || _a === void 0 ? void 0 : _a.map((_a) => {
+            var { title } = _a, form = __rest(_a, ["title"]);
+            return ({
+                title,
+                form: this.Controller('form', Object.assign(Object.assign({}, form), { shouldShowSubmitControls: false, onChange: () => __awaiter(this, void 0, void 0, function* () {
+                        yield this.handleOnChange();
+                    }) })).render(),
+            });
+        })) !== null && _b !== void 0 ? _b : []);
+    }
+    handleOnChange() {
+        var _a;
+        return __awaiter(this, void 0, void 0, function* () {
+            if (!this.shouldIgnoreChanges) {
+                yield ((_a = this.onChangeHandler) === null || _a === void 0 ? void 0 : _a.call(this, { values: this.getValues() }));
+            }
+        });
+    }
+    getHasCriticalError() {
+        return this.swipeVc.getHasCriticalError();
+    }
+    getIsBusy() {
+        return this.swipeVc.isBusy();
+    }
+    setCriticalError(err) {
+        this.swipeVc.setCriticalError(err);
+    }
+    getSwipeVc() {
+        return this.swipeVc;
+    }
+    load(options) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const { router } = options, source = __rest(options, ["router"]);
+            const { title, subtitle } = this.renderHeader(source);
+            this.router = router;
+            this.swipeVc.setHeaderTitle(title !== null && title !== void 0 ? title : null);
+            this.swipeVc.setHeaderSubtitle(subtitle !== null && subtitle !== void 0 ? subtitle : null);
+            this.swipeVc.setSections(this.renderSlides(source));
+            if (source.values) {
+                yield this.setValues(source.values);
+            }
+            this.builderSource = source;
+            this.updateFooter();
+            this.swipeVc.setIsBusy(false);
+        });
+    }
+    updateFooter() {
+        this.swipeVc.setFooter(this.router ? this.renderFooter() : null);
+    }
+    setValues(values) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (!Array.isArray(values)) {
+                throw new Error('values must be an array!');
+            }
+            const vcs = this.getFormVcs();
+            this.shouldIgnoreChanges = true;
+            yield Promise.all(values.map((v, idx) => __awaiter(this, void 0, void 0, function* () { return vcs[idx].setValues(v); })));
+            this.shouldIgnoreChanges = false;
+            yield this.handleOnChange();
+        });
+    }
+    getValues() {
+        return this.getFormVcs().map((vc) => vc.getValues());
+    }
+    getFormVcs() {
+        var _a, _b;
+        return ((_b = (_a = this.swipeVc.getSlides()) === null || _a === void 0 ? void 0 : _a.map((s) => { var _a; return (_a = s.form) === null || _a === void 0 ? void 0 : _a.controller; })) !== null && _b !== void 0 ? _b : []);
+    }
+    getFormVc(idx) {
+        const formVc = this.getFormVcs()[idx];
+        if (!formVc) {
+            throw new SchemaError({
+                code: 'INVALID_PARAMETERS',
+                friendlyMessage: `I couldn't find a form at index ${idx}.`,
+                parameters: ['formIdx'],
+            });
+        }
+        return formVc;
+    }
+    getSourceBuilder() {
+        return this.builderSource;
+    }
+    render() {
+        return this.swipeVc.render();
+    }
+}
+FormPlayerCardViewController.id = 'form-player-card';

package/build/esm/completing/formCompletionCalculator.d.ts

@@ -0,0 +1,5 @@
+import { FormBuilderPage } from '@sprucelabs/heartwood-view-controllers';
+declare const formCompletionCalculator: {
+    calculate(pages: FormBuilderPage[], values: Record<string, any>[]): number;
+};
+export default formCompletionCalculator;

package/build/esm/completing/formCompletionCalculator.js

@@ -0,0 +1,53 @@
+import { assertOptions, SchemaError } from '@sprucelabs/schema';
+function validateOptions(pages, values) {
+    assertOptions({
+        pages,
+        values,
+    }, ['pages', 'values']);
+    if (!Array.isArray(pages)) {
+        throw new SchemaError({
+            code: 'INVALID_PARAMETERS',
+            parameters: ['pages'],
+            friendlyMessage: 'pages must be an array',
+        });
+    }
+    if (!Array.isArray(values)) {
+        throw new SchemaError({
+            code: 'INVALID_PARAMETERS',
+            parameters: ['values'],
+            friendlyMessage: 'values must be an array',
+        });
+    }
+}
+const formCompletionCalculator = {
+    calculate(pages, values) {
+        var _a, _b, _c, _d;
+        validateOptions(pages, values);
+        const requiredFields = [];
+        let totalFields = 0;
+        for (const page of pages) {
+            const fields = (_a = page.schema.fields) !== null && _a !== void 0 ? _a : {};
+            for (const section of page.sections) {
+                for (const field of (_b = section.fields) !== null && _b !== void 0 ? _b : []) {
+                    const fieldKey = (_c = field.name) !== null && _c !== void 0 ? _c : field;
+                    const f = (_d = fields[fieldKey]) !== null && _d !== void 0 ? _d : {};
+                    if (f.isRequired) {
+                        totalFields++;
+                        requiredFields.push(fieldKey);
+                    }
+                }
+            }
+        }
+        if (totalFields === 0) {
+            return 1;
+        }
+        let totalAnswered = 0;
+        for (const value of values) {
+            totalAnswered += Object.keys(value !== null && value !== void 0 ? value : {}).filter((k) => {
+                return !!value[k] && requiredFields.indexOf(k) !== -1;
+            }).length;
+        }
+        return parseFloat((totalAnswered / totalFields).toFixed(2));
+    },
+};
+export default formCompletionCalculator;

package/build/esm/index-module.d.ts

@@ -0,0 +1,4 @@
+export { default as formAssert } from './__tests__/support/formAssert';
+export { default as formCompletionCalculator } from './completing/formCompletionCalculator';
+export { default as FormPlayerCardViewController } from './completing/FormPlayerCard.vc';
+export * from './types/types-module';

package/build/esm/index-module.js

@@ -0,0 +1,4 @@
+export { default as formAssert } from './__tests__/support/formAssert.js';
+export { default as formCompletionCalculator } from './completing/formCompletionCalculator.js';
+export { default as FormPlayerCardViewController } from './completing/FormPlayerCard.vc.js';
+export * from './types/types-module.js';

package/build/esm/types/types-module.d.ts

@@ -0,0 +1,21 @@
+import { Scope, SpruceSchemas, ViewController } from '@sprucelabs/heartwood-view-controllers';
+import FormPlayerCardViewController, { FormPlayerCardViewControllerOptions } from '../completing/FormPlayerCard.vc';
+declare type Card = SpruceSchemas.HeartwoodViewControllers.v2021_02_11.Card;
+export declare type UpdateForm = SpruceSchemas.Forms.v2021_07_02.UpdateForm;
+export interface RemoteFormBuilderCardLoadOptions {
+    scope: Scope;
+    formId?: string;
+}
+export interface RemoteFormBuilderCard extends ViewController<Card> {
+    load?(options: RemoteFormBuilderCardLoadOptions): Promise<void>;
+    didSaveForm?(form: UpdateForm): Promise<void>;
+}
+declare module '@sprucelabs/heartwood-view-controllers/build/types/heartwood.types' {
+    interface ViewControllerMap {
+        formPlayerCard: FormPlayerCardViewController;
+    }
+    interface ViewControllerOptionsMap {
+        formPlayerCard: FormPlayerCardViewControllerOptions;
+    }
+}
+export {};

package/build/esm/types/types-module.js

@@ -0,0 +1 @@
+export {};

package/build/index-module.js

@@ -25,4 +25,3 @@ Object.defineProperty(exports, "formCompletionCalculator", { enumerable: true, g
 var FormPlayerCard_vc_1 = require("./completing/FormPlayerCard.vc");
 Object.defineProperty(exports, "FormPlayerCardViewController", { enumerable: true, get: function () { return __importDefault(FormPlayerCard_vc_1).default; } });
 __exportStar(require("./types/types-module"), exports);
-//# sourceMappingURL=index-module.js.map

package/build/types/types-module.js

@@ -1,3 +1,2 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=types-module.js.map

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@sprucelabs/spruce-form-utils",
   "description": "Support for working with forms and Sprucebot. 📄",
-  "version": "12.0.22",
+  "version": "12.0.23",
   "skill": {
     "namespace": "forms"
   },