@quenk/frontend 0.20.1 → 0.20.2

package/lib/app/scene/form/index.js

@@ -0,0 +1,142 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AppFormScene = exports.FormState = exports.Save = exports.Abort = void 0;
+const record_1 = require("@quenk/noni/lib/data/record");
+const array_1 = require("@quenk/noni/lib/data/array");
+const type_1 = require("@quenk/noni/lib/data/type");
+const case_1 = require("@quenk/noni/lib/control/match/case");
+const either_1 = require("@quenk/noni/lib/data/either");
+const __1 = require("../");
+/**
+ * Abort causes a FormScene to cease operations and return control to the
+ * actor that owns it.
+ */
+class Abort {
+}
+exports.Abort = Abort;
+/**
+ * Save causes a FormScene to trigger the "save" process for values collected.
+ */
+class Save {
+}
+exports.Save = Save;
+/**
+ * FormState indicates the state of the form when its lifecycle comes to an end.
+ *
+ * This message is used to indicate the form has either been saved or aborted
+ * and contains additional details of the form data up to that point.
+ */
+class FormState {
+    /**
+     * @param form   - The actor address of the form.
+     * @param ok     - Indicates whether the form was saved (true) or aborted
+     *                (false).
+     * @param data   - The form data.
+     * @param result - The result received from saving the form.
+     */
+    constructor(form, ok, data = {}, result) {
+        this.form = form;
+        this.ok = ok;
+        this.data = data;
+        this.result = result;
+    }
+}
+exports.FormState = FormState;
+/**
+ * AppFormScene provides an abstract implementation of the FormScene interface.
+ *
+ * Child classes provide a save() implementation to provide the logic of saving
+ * data. This actor is configured to process [[FormSceneMessage]]s including
+ * anything that looks like a InputEvent which will be passed to the set()
+ * method.
+ *
+ * Alternatively, values can be set directly via set() bypassing the actor
+ * system.
+ *
+ * @param system   - The potoo System this actor belongs to.
+ * @param display  - The address of the display to send the form's view to.
+ * @param owner    - The address of the actor that will receive life cycle
+ *                   messages.
+ * @param value    - Value of the AppFormScene tracked by the APIs of this
+ *                   class. This should not be modified outside of this actor.
+ */
+class AppFormScene extends __1.AppScene {
+    constructor(runtime, owner, display, value = {}) {
+        super(runtime);
+        this.runtime = runtime;
+        this.owner = owner;
+        this.display = display;
+        this.value = value;
+        /**
+         * fieldsModified tracks the names of those fields whose values have been
+         * modified via this class's APIs.
+         */
+        this.fieldsModifed = [];
+        this.errors = {};
+    }
+    selectors() {
+        return [
+            new case_1.TypeCase(Abort, () => {
+                this.abort();
+            }),
+            new case_1.TypeCase(Save, () => {
+                this.save();
+            }),
+            new case_1.TypeCase({ name: String, value: type_1.Any }, e => {
+                this.set(e.name, e.value);
+            })
+        ];
+    }
+    set(name, value) {
+        if (!(0, array_1.contains)(this.fieldsModifed, name))
+            this.fieldsModifed.push(name);
+        this.value[name] = value;
+        return this;
+    }
+    getValues() {
+        return (0, record_1.clone)(this.value);
+    }
+    getModifiedValues() {
+        return ((0, record_1.filter)(this.value, (_, k) => (0, array_1.contains)(this.fieldsModifed, k)));
+    }
+    hasErrors() {
+        return !(0, record_1.empty)(this.errors);
+    }
+    /**
+     * abort by default invokes the callback and exits.
+     *
+     * The message is also sent to the display which should result in the view
+     * being removed.
+     */
+    async abort() {
+        await this.tell(this.owner, new FormState(this.self, false, this.getValues()));
+        await this.exit();
+    }
+    /**
+     * doSave executes the form saving logic.
+     */
+    async doSave() {
+        return either_1.Either.right('');
+    }
+    /**
+     * save executes the form saving operation and takes care of invoking the
+     * callback.
+     *
+     * Execution takes place by submitting a future to the form's actor thread.
+     * The life cycle message is also sent to the display which should trigger
+     * the removal of the view. Note: instead of overriding this method,
+     * override execute instead unless you want to change its behaviour.
+     */
+    async save() {
+        this.errors = {};
+        let eresult = await this.doSave();
+        if (eresult.isRight()) {
+            // Leave it to the child class to handle error cases.
+            let result = eresult.takeRight();
+            await this.tell(this.owner, new FormState(this.self, true, this.getValues(), result));
+            await this.exit();
+        }
+    }
+}
+exports.AppFormScene = AppFormScene;
+//# sourceMappingURL=index.js.map

package/lib/app/scene/form/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/app/scene/form/index.ts"],"names":[],"mappings":"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"}

package/lib/app/scene/form/model.d.ts

@@ -0,0 +1,44 @@
+import { Value } from '@quenk/noni/lib/data/jsonx';
+import { Object } from '@quenk/noni/lib/data/jsonx';
+import { Except } from '@quenk/noni/lib/control/except';
+import { Address } from '@quenk/potoo/lib/actor/address';
+import { Runtime } from '@quenk/potoo/lib/actor/system/vm/runtime';
+import { Event } from '@quenk/wml-widgets/lib/control';
+import { Id, Model } from '../../model';
+import { AppFormScene } from '.';
+/**
+ * WriteMode hints what method to use to save the data.
+ */
+export type WriteMode = string;
+export declare const WRITE_MODE_CREATE = "create";
+export declare const WRITE_MODE_UPDATE = "update";
+/**
+ * ModelForm saves data using a Model.
+ */
+export declare abstract class ModelFormScene<T extends Object> extends AppFormScene<T> {
+    runtime: Runtime;
+    owner: Address;
+    display: Address;
+    value: Partial<T>;
+    mode: WriteMode;
+    constructor(runtime: Runtime, owner: Address, display: Address, value?: Partial<T>, mode?: WriteMode);
+    static WRITE_MODE_CREATE: string;
+    static WRTIE_MODE_UPDATE: string;
+    /**
+     * model to use for saving data.
+     */
+    abstract model: Model<T>;
+    /**
+     * id assumes the id is the "id" property on the value.
+     */
+    get id(): Id;
+    /**
+     * onChange handler can be used to collect values.
+     */
+    onChange: (e: Event<Value>) => Promise<void>;
+    /**
+     * doSave either a create or update depending on the specified write
+     * mode.
+     */
+    doSave(): Promise<Except<Value>>;
+}

package/lib/app/scene/form/model.js

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ModelFormScene = exports.WRITE_MODE_UPDATE = exports.WRITE_MODE_CREATE = void 0;
+const either_1 = require("@quenk/noni/lib/data/either");
+const _1 = require(".");
+exports.WRITE_MODE_CREATE = 'create';
+exports.WRITE_MODE_UPDATE = 'update';
+/**
+ * ModelForm saves data using a Model.
+ */
+class ModelFormScene extends _1.AppFormScene {
+    constructor(runtime, owner, display, value = {}, mode = ModelFormScene.WRITE_MODE_CREATE) {
+        super(runtime, owner, display, value);
+        this.runtime = runtime;
+        this.owner = owner;
+        this.display = display;
+        this.value = value;
+        this.mode = mode;
+        /**
+         * onChange handler can be used to collect values.
+         */
+        this.onChange = async (e) => this.tell(this.self, e);
+    }
+    /**
+     * id assumes the id is the "id" property on the value.
+     */
+    get id() {
+        return this.value.id;
+    }
+    /**
+     * doSave either a create or update depending on the specified write
+     * mode.
+     */
+    async doSave() {
+        if (this.mode === ModelFormScene.WRITE_MODE_CREATE) {
+            return this.model.create(this.getValues());
+        }
+        else {
+            await this.model.update(this.id, this.getModifiedValues());
+            return either_1.Either.right(this.id);
+        }
+    }
+}
+exports.ModelFormScene = ModelFormScene;
+ModelFormScene.WRITE_MODE_CREATE = exports.WRITE_MODE_CREATE;
+ModelFormScene.WRTIE_MODE_UPDATE = exports.WRITE_MODE_UPDATE;
+//# sourceMappingURL=model.js.map

package/lib/app/scene/form/model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.js","sourceRoot":"","sources":["../../../../src/app/scene/form/model.ts"],"names":[],"mappings":";;;AAGA,wDAAqD;AAQrD,wBAAiC;AAOpB,QAAA,iBAAiB,GAAG,QAAQ,CAAC;AAC7B,QAAA,iBAAiB,GAAG,QAAQ,CAAC;AAE1C;;GAEG;AACH,MAAsB,cAAiC,SAAQ,eAAe;IAC1E,YACW,OAAgB,EAChB,KAAc,EACd,OAAgB,EAChB,QAAoB,EAAE,EACtB,OAAkB,cAAc,CAAC,iBAAiB;QAEzD,KAAK,CAAC,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;QAN/B,YAAO,GAAP,OAAO,CAAS;QAChB,UAAK,GAAL,KAAK,CAAS;QACd,YAAO,GAAP,OAAO,CAAS;QAChB,UAAK,GAAL,KAAK,CAAiB;QACtB,SAAI,GAAJ,IAAI,CAA8C;QAqB7D;;WAEG;QACH,aAAQ,GAAG,KAAK,EAAE,CAAe,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IArB9D,CAAC;IAWD;;OAEG;IACH,IAAI,EAAE;QACF,OAAW,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;IAC7B,CAAC;IAOD;;;OAGG;IACH,KAAK,CAAC,MAAM;QACR,IAAI,IAAI,CAAC,IAAI,KAAK,cAAc,CAAC,iBAAiB,EAAE,CAAC;YACjD,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;QAC/C,CAAC;aAAM,CAAC;YACJ,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,iBAAiB,EAAE,CAAC,CAAC;YAC3D,OAAO,eAAM,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjC,CAAC;IACL,CAAC;;AA3CL,wCA4CC;AAjCU,gCAAiB,GAAG,yBAAiB,AAApB,CAAqB;AAEtC,gCAAiB,GAAG,yBAAiB,AAApB,CAAqB"}

package/lib/app/scene/form/validator/index.d.ts

@@ -0,0 +1,70 @@
+import { Object } from '@quenk/noni/lib/data/jsonx';
+import { Any } from '@quenk/noni/lib/data/type';
+import { FieldName, FieldValue, FieldError, FormScene, AppFormScene } from '../';
+import { ValidationStrategy } from './strategy';
+import { TypeCase } from '@quenk/noni/lib/control/match/case';
+/**
+ * ValidatorFormScene is the interface implemented by actors serving as the
+ * "controller" for HTML form views with validation.
+ *
+ * ValidatorFormScene differs from a regular [[FormScene]] by including client
+ * side validation in its design. As values are collected from the user, they
+ * can be validated and the feedback state of the form updated before being set.
+ *
+ * This allows for a more dynamic user experience when desirable.
+ */
+export interface ValidatorFormScene<T extends Object> extends FormScene<T> {
+    /**
+     * strategy used for validation.
+     *
+     * This determines how data is validated and the callbacks to apply.
+     */
+    strategy: ValidationStrategy;
+}
+/**
+ * FieldStateListener indicates an ValidatorFormScene has methods for reacting
+ * to the result of a single field's validation.
+ *
+ * Use to implement visual feedback to the user.
+ */
+export interface FieldStateListener<T extends Object> extends ValidatorFormScene<T> {
+    /**
+     * onFieldInvalid is applied when a field becomes invalid.
+     */
+    onFieldInvalid(name: FieldName, value: FieldValue, error: FieldError): void;
+    /**
+     * onFieldValid is applied when a field becomes valid.
+     */
+    onFieldValid(name: FieldName, value: FieldValue): void;
+}
+/**
+ * FormStateListener indicates an ValidatorFormScene has methods for reacting to
+ * the result of the entire form's validation.
+ *
+ * Use to provide the user with visual feedback such as enabling the save button.
+ */
+export interface FormStateListener<T extends Object> extends FieldStateListener<T> {
+    /**
+     * onFormInvalid is applied when the entire form becomes invalid.
+     */
+    onFormInvalid(): void;
+    /**
+     * onFormValid is applied when the entire form becomes valid.
+     */
+    onFormValid(): void;
+}
+/**
+ * AppValidatorFormScene is an abstract extension to the BaseFormScene
+ * class to add validation and feedback features.
+ */
+export declare abstract class AppValidatorFormScene<T extends Object> extends AppFormScene<T> implements FormStateListener<T> {
+    strategy: ValidationStrategy;
+    selectors(): (TypeCase<typeof import("../").Abort, void> | TypeCase<{
+        name: StringConstructor;
+        value: typeof Any;
+    }, void>)[];
+    onFieldInvalid(): void;
+    onFieldValid(): void;
+    onFormInvalid(): void;
+    onFormValid(): void;
+}

package/lib/app/scene/form/validator/index.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AppValidatorFormScene = void 0;
+const type_1 = require("@quenk/noni/lib/data/type");
+const __1 = require("../");
+const strategy_1 = require("./strategy");
+const case_1 = require("@quenk/noni/lib/control/match/case");
+/**
+ * AppValidatorFormScene is an abstract extension to the BaseFormScene
+ * class to add validation and feedback features.
+ */
+class AppValidatorFormScene extends __1.AppFormScene {
+    constructor() {
+        super(...arguments);
+        this.strategy = new strategy_1.NoStrategy(this);
+    }
+    selectors() {
+        return [
+            new case_1.TypeCase({ name: String, value: type_1.Any }, e => {
+                return this.strategy.validate(e);
+            }),
+            ...super.selectors()
+        ];
+    }
+    onFieldInvalid() { }
+    onFieldValid() { }
+    onFormInvalid() { }
+    onFormValid() { }
+}
+exports.AppValidatorFormScene = AppValidatorFormScene;
+//# sourceMappingURL=index.js.map

package/lib/app/scene/form/validator/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/app/scene/form/validator/index.ts"],"names":[],"mappings":";;;AACA,oDAAgD;AAEhD,2BAMa;AACb,yCAA4D;AAE5D,6DAA8D;AA2D9D;;;GAGG;AACH,MAAsB,qBAClB,SAAQ,gBAAe;IAD3B;;QAII,aAAQ,GAAuB,IAAI,qBAAU,CAAC,IAAI,CAAC,CAAC;IAmBxD,CAAC;IAjBG,SAAS;QACL,OAAO;YACH,IAAI,eAAQ,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,UAAG,EAAE,EAAE,CAAC,CAAC,EAAE;gBAC3C,OAAO,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAa,CAAC,CAAC,CAAC;YACjD,CAAC,CAAC;YAEF,GAAG,KAAK,CAAC,SAAS,EAAE;SACvB,CAAC;IACN,CAAC;IAED,cAAc,KAAI,CAAC;IAEnB,YAAY,KAAI,CAAC;IAEjB,aAAa,KAAI,CAAC;IAElB,WAAW,KAAI,CAAC;CACnB;AAvBD,sDAuBC"}

package/lib/app/scene/form/validator/strategy.d.ts

@@ -0,0 +1,94 @@
+import { Either } from '@quenk/noni/lib/data/either';
+import { Object } from '@quenk/noni/lib/data/jsonx';
+import { FieldName, FieldValue, FieldError, FormErrors } from '../';
+import { InputEvent } from '../';
+import { ValidatorFormScene, FieldStateListener, FormStateListener } from './';
+/**
+ * FieldValidator is an interface used to validate at the field level.
+ */
+export interface FieldValidator {
+    /**
+     * validate the value value of the field.
+     */
+    validate(key: FieldName, value: FieldValue): Either<FieldError, FieldValue>;
+}
+/**
+ * FormValidator extends FieldValidator to provide form level validation.
+ */
+export interface FormValidator<T extends Object> extends FieldValidator {
+    /**
+     * validateAll helper.
+     */
+    validateAll(value: T): Either<FormErrors, T>;
+}
+/**
+ * ValidationStrategy handles the actual validation of FieldEvents.
+ *
+ * This should also apply the relevant callbacks as desired.
+ */
+export interface ValidationStrategy {
+    /**
+     * validate a InputEvent.
+     */
+    validate(e: InputEvent): void;
+}
+/**
+ * FieldValidator is an interface used by some ValidateStrategys to validate
+ * actual values.
+ */
+export interface FieldValidator {
+    /**
+     * validate helper.
+     */
+    validate(key: FieldName, value: FieldValue): Either<FieldError, FieldValue>;
+}
+/**
+ * FormValidator extends FieldValidator to allow validation of all the values
+ * in an ValidatorFormScene.
+ */
+export interface FormValidator<T extends Object> extends FieldValidator {
+    /**
+     * validateAll helper.
+     */
+    validateAll(value: T): Either<FormErrors, T>;
+}
+/**
+ * NoStrategy simply sets the captured values on the ValidatorFormScene.
+ *
+ * This is useful if all validation is done on the server side.
+ */
+export declare class NoStrategy<T extends Object> implements ValidationStrategy {
+    form: ValidatorFormScene<T>;
+    constructor(form: ValidatorFormScene<T>);
+    validate({ name, value }: InputEvent): void;
+}
+/**
+ * OneForOneStrategy validates event input and triggers the respect
+ * onField(In)?Valid callback.
+ */
+export declare class OneForOneStrategy<T extends Object> implements ValidationStrategy {
+    form: FieldStateListener<T>;
+    validator: FieldValidator;
+    constructor(form: FieldStateListener<T>, validator: FieldValidator);
+    validate({ name, value }: InputEvent): void;
+}
+/**
+ * AllForOneStrategy validtes InputEvent input and invokes the
+ * respective callbacks.
+ *
+ * Callbacks for the entire form are also invoked.
+ */
+export declare class AllForOneStrategy<T extends Object> implements ValidationStrategy {
+    form: FormStateListener<T>;
+    validator: FormValidator<T>;
+    constructor(form: FormStateListener<T>, validator: FormValidator<T>);
+    getValues(): T;
+    validate({ name, value }: InputEvent): void;
+}
+/**
+ * ModifiedAllForOneStrategy is similar to AllForOneStrategy but only considers
+ * the values that have been modified when validating the entire form.
+ */
+export declare class ModifiedAllForOneStrategy<T extends Object> extends AllForOneStrategy<T> {
+    getValues(): T;
+}

package/lib/app/scene/form/validator/strategy.js

@@ -0,0 +1,85 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ModifiedAllForOneStrategy = exports.AllForOneStrategy = exports.OneForOneStrategy = exports.NoStrategy = void 0;
+/**
+ * NoStrategy simply sets the captured values on the ValidatorFormScene.
+ *
+ * This is useful if all validation is done on the server side.
+ */
+class NoStrategy {
+    constructor(form) {
+        this.form = form;
+    }
+    validate({ name, value }) {
+        this.form.set(name, value);
+    }
+}
+exports.NoStrategy = NoStrategy;
+/**
+ * OneForOneStrategy validates event input and triggers the respect
+ * onField(In)?Valid callback.
+ */
+class OneForOneStrategy {
+    constructor(form, validator) {
+        this.form = form;
+        this.validator = validator;
+    }
+    validate({ name, value }) {
+        let { form, validator } = this;
+        let eResult = validator.validate(name, value);
+        if (eResult.isLeft()) {
+            form.onFieldInvalid(name, value, eResult.takeLeft());
+        }
+        else {
+            let value = eResult.takeRight();
+            form.set(name, value);
+            form.onFieldValid(name, value);
+        }
+    }
+}
+exports.OneForOneStrategy = OneForOneStrategy;
+/**
+ * AllForOneStrategy validtes InputEvent input and invokes the
+ * respective callbacks.
+ *
+ * Callbacks for the entire form are also invoked.
+ */
+class AllForOneStrategy {
+    constructor(form, validator) {
+        this.form = form;
+        this.validator = validator;
+    }
+    getValues() {
+        return this.form.getValues();
+    }
+    validate({ name, value }) {
+        let { form, validator } = this;
+        let eResult = validator.validate(name, value);
+        if (eResult.isLeft()) {
+            form.onFieldInvalid(name, value, eResult.takeLeft());
+            form.onFormInvalid();
+        }
+        else {
+            let value = eResult.takeRight();
+            form.set(name, value);
+            form.onFieldValid(name, value);
+            let eAllResult = validator.validateAll(this.getValues());
+            if (eAllResult.isRight())
+                form.onFormValid();
+            else
+                form.onFormInvalid();
+        }
+    }
+}
+exports.AllForOneStrategy = AllForOneStrategy;
+/**
+ * ModifiedAllForOneStrategy is similar to AllForOneStrategy but only considers
+ * the values that have been modified when validating the entire form.
+ */
+class ModifiedAllForOneStrategy extends AllForOneStrategy {
+    getValues() {
+        return this.form.getModifiedValues();
+    }
+}
+exports.ModifiedAllForOneStrategy = ModifiedAllForOneStrategy;
+//# sourceMappingURL=strategy.js.map

package/lib/app/scene/form/validator/strategy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"strategy.js","sourceRoot":"","sources":["../../../../../src/app/scene/form/validator/strategy.ts"],"names":[],"mappings":";;;AA6DA;;;;GAIG;AACH,MAAa,UAAU;IACnB,YAAmB,IAA2B;QAA3B,SAAI,GAAJ,IAAI,CAAuB;IAAG,CAAC;IAElD,QAAQ,CAAC,EAAE,IAAI,EAAE,KAAK,EAAc;QAChC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAC/B,CAAC;CACJ;AAND,gCAMC;AAED;;;GAGG;AACH,MAAa,iBAAiB;IAC1B,YACW,IAA2B,EAC3B,SAAyB;QADzB,SAAI,GAAJ,IAAI,CAAuB;QAC3B,cAAS,GAAT,SAAS,CAAgB;IACjC,CAAC;IAEJ,QAAQ,CAAC,EAAE,IAAI,EAAE,KAAK,EAAc;QAChC,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC;QAC/B,IAAI,OAAO,GAAG,SAAS,CAAC,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAE9C,IAAI,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;YACnB,IAAI,CAAC,cAAc,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;QACzD,CAAC;aAAM,CAAC;YACJ,IAAI,KAAK,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;YAEhC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;YACtB,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QACnC,CAAC;IACL,CAAC;CACJ;AAnBD,8CAmBC;AAED;;;;;GAKG;AACH,MAAa,iBAAiB;IAC1B,YACW,IAA0B,EAC1B,SAA2B;QAD3B,SAAI,GAAJ,IAAI,CAAsB;QAC1B,cAAS,GAAT,SAAS,CAAkB;IACnC,CAAC;IAEJ,SAAS;QACL,OAAO,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;IACjC,CAAC;IAED,QAAQ,CAAC,EAAE,IAAI,EAAE,KAAK,EAAc;QAChC,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC;QAC/B,IAAI,OAAO,GAAG,SAAS,CAAC,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAE9C,IAAI,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;YACnB,IAAI,CAAC,cAAc,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;YACrD,IAAI,CAAC,aAAa,EAAE,CAAC;QACzB,CAAC;aAAM,CAAC;YACJ,IAAI,KAAK,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;YAEhC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;YACtB,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;YAE/B,IAAI,UAAU,GAAG,SAAS,CAAC,WAAW,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;YAEzD,IAAI,UAAU,CAAC,OAAO,EAAE;gBAAE,IAAI,CAAC,WAAW,EAAE,CAAC;;gBACxC,IAAI,CAAC,aAAa,EAAE,CAAC;QAC9B,CAAC;IACL,CAAC;CACJ;AA7BD,8CA6BC;AAED;;;GAGG;AACH,MAAa,yBAEX,SAAQ,iBAAoB;IAC1B,SAAS;QACL,OAAU,IAAI,CAAC,IAAI,CAAC,iBAAiB,EAAE,CAAC;IAC5C,CAAC;CACJ;AAND,8DAMC"}

package/lib/app/scene/index.d.ts

@@ -50,7 +50,7 @@ export interface Scene extends Api {
     display: Address;
 }
 /**
- * BaseAppScene that provides a basis for more specialized AppScenes.
+ * AppScene that provides a basis for more specialized AppScenes.
  *
  * This class only sends content to the display actor when run.
  */
@@ -61,6 +61,6 @@ export declare abstract class AppScene extends Immutable implements Scene {
     /**
      * show the AppScene by sending a message to the display.
      */
-    show(): void;
+    show(): Promise<void>;
     run(): Promise<void>;
 }

package/lib/app/scene/index.js

@@ -29,9 +29,9 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AppScene = void 0;
 const resident_1 = require("@quenk/potoo/lib/actor/framework/resident");
-const display_1 = require("app/display");
+const display_1 = require("../display");
 /**
- * BaseAppScene that provides a basis for more specialized AppScenes.
+ * AppScene that provides a basis for more specialized AppScenes.
  *
  * This class only sends content to the display actor when run.
  */
@@ -39,11 +39,11 @@ class AppScene extends resident_1.Immutable {
     /**
      * show the AppScene by sending a message to the display.
      */
-    show() {
-        this.tell(this.display, new display_1.Show(this.name, this.view, this.self));
+    async show() {
+        await this.tell(this.display, new display_1.Show(this.name, this.view, this.self));
     }
     async run() {
-        this.show();
+        await this.show();
     }
 }
 exports.AppScene = AppScene;

package/lib/app/scene/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/app/scene/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;;;AAIH,wEAAsE;AAGtE,yCAAmC;AA2BnC;;;;GAIG;AACH,MAAsB,QAClB,SAAQ,oBAAS;IASjB;;OAEG;IACH,IAAI;QAEA,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,cAAI,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAEvE,CAAC;IAED,KAAK,CAAC,GAAG;QAEL,IAAI,CAAC,IAAI,EAAE,CAAC;IAEhB,CAAC;CAEJ;AAzBD,4BAyBC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/app/scene/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;;;AAIH,wEAAsE;AAItE,wCAAkC;AAyBlC;;;;GAIG;AACH,MAAsB,QAAS,SAAQ,oBAAS;IAO5C;;OAEG;IACH,KAAK,CAAC,IAAI;QACN,MAAM,IAAI,CAAC,IAAI,CACX,IAAI,CAAC,OAAO,EACZ,IAAI,cAAI,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,CAC5C,CAAC;IACN,CAAC;IAED,KAAK,CAAC,GAAG;QACL,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;IACtB,CAAC;CACJ;AApBD,4BAoBC"}

package/lib/app/scene/page.d.ts

@@ -0,0 +1,56 @@
+import { TypeCase } from '@quenk/noni/lib/control/match/case';
+import { Runtime } from '@quenk/potoo/lib/actor/system/vm/runtime';
+import { Spawnable } from '@quenk/potoo/lib/actor/template';
+import { Address } from '@quenk/potoo/lib/actor/address';
+import { Pop, Push, ViewRemoved, ViewShown, DisplayListener } from '../display';
+import { Focus } from './director';
+import { FormState } from './form';
+import { AppScene } from './';
+/**
+ * Page is an actor used to provide one of the primary activity views of an
+ * application.
+ *
+ * These actors are meant to be used in combination with a [[Director]] instance
+ * which can spawn them on demand in response to the app's "route" changing.
+ *
+ * The [[Resume]] parameter serves as proof that the Page is allowed by the
+ * Director to send content to the user (by sending a [[Show]] message to the
+ * director).
+ *
+ * When the Director decides it's time for another actor to be given that right,
+ * the Page is terminiated but will receive a [[Suspend]] message which can
+ * be used to clean up.
+ *
+ * Page is intentionally basic to allow for the flexibility needed when
+ * composing the complex main activities of a routed application. However, to
+ * make working with [[FormScene]]s and [[Dialog]]s easier, it contains Case
+ * classes for redirecting content received to the Director.
+ */
+export declare abstract class Page extends AppScene implements DisplayListener {
+    runtime: Runtime;
+    focus: Focus;
+    constructor(runtime: Runtime, focus: Focus);
+    afterViewShown(_: ViewShown): Promise<void>;
+    afterViewRemoved(_: ViewRemoved): Promise<void>;
+    get display(): string;
+    selectors(): (TypeCase<typeof Push, Promise<void>> | TypeCase<typeof Pop, Promise<void>> | TypeCase<typeof ViewShown, Promise<void>>)[];
+    /**
+     * reload the AppScene by sending a Reload request to the Director.
+     *
+     * This will end this instance and spawn a new one.
+     */
+    reload(): Promise<void>;
+    /**
+     * spawnForm spawns a FormScene and returns a promise that resolves when the
+     * form has been saved or aborted.
+     *
+     * This method exists as an alternative to having the Page implement
+     * case classes to handle the form's life cycle messages.
+     *
+     * @param tmpl - The function that will be used to get the form actor's
+     *               template. Note that the address of the actor created to
+     *               spawn the form is passed so it has the correct owner.
+     */
+    spawnForm(tmpl: (addr: Address) => Spawnable): Promise<FormState>;
+    run(): Promise<void>;
+}