@sprucelabs/heartwood-view-controllers 111.1.29 → 111.1.31

package/build/.spruce/errors/errors.types.d.ts

@@ -387,3 +387,23 @@ export declare namespace SpruceErrors.HeartwoodViewControllers {
     }
     type CellDeletedEntity = SchemaEntity<SpruceErrors.HeartwoodViewControllers.CellDeletedSchema>;
 }
+export declare namespace SpruceErrors.HeartwoodViewControllers {
+    interface AppNotFound {
+        'namespace': string;
+    }
+    interface AppNotFoundSchema extends SpruceSchema.Schema {
+        id: 'appNotFound';
+        namespace: 'HeartwoodViewControllers';
+        name: 'App not found';
+        moduleToImportFromWhenRemote: '@sprucelabs/heartwood-view-controllers';
+        fields: {
+            /** . */
+            'namespace': {
+                type: 'id';
+                isRequired: true;
+                options: undefined;
+            };
+        };
+    }
+    type AppNotFoundEntity = SchemaEntity<SpruceErrors.HeartwoodViewControllers.AppNotFoundSchema>;
+}

package/build/.spruce/errors/heartwoodViewControllers/appNotFound.schema.d.ts

@@ -0,0 +1,3 @@
+import { SpruceErrors } from '../errors.types';
+declare const appNotFoundSchema: SpruceErrors.HeartwoodViewControllers.AppNotFoundSchema;
+export default appNotFoundSchema;

package/build/.spruce/errors/heartwoodViewControllers/appNotFound.schema.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const schema_1 = require("@sprucelabs/schema");
+const appNotFoundSchema = {
+    id: 'appNotFound',
+    namespace: 'HeartwoodViewControllers',
+    name: 'App not found',
+    moduleToImportFromWhenRemote: '@sprucelabs/heartwood-view-controllers',
+    fields: {
+        /** . */
+        'namespace': {
+            type: 'id',
+            isRequired: true,
+            options: undefined
+        },
+    }
+};
+schema_1.SchemaRegistry.getInstance().trackSchema(appNotFoundSchema);
+exports.default = appNotFoundSchema;

package/build/.spruce/errors/options.types.d.ts

@@ -57,5 +57,8 @@ export interface DateAlreadySelectedErrorOptions extends SpruceErrors.HeartwoodV
 export interface CellDeletedErrorOptions extends SpruceErrors.HeartwoodViewControllers.CellDeleted, ISpruceErrorOptions {
     code: 'CELL_DELETED';
 }
-type ErrorOptions = ViewAlreadyDestroyedErrorOptions | ToolNotFoundErrorOptions | StepNotCompleteErrorOptions | SlideNotFoundErrorOptions | RowDeletedErrorOptions | PersonNotFoundErrorOptions | NoFieldVcSetErrorOptions | MissingStorageErrorOptions | InvalidViewControllerSourceErrorOptions | InvalidViewControllerNameErrorOptions | InvalidSkillViewControllerErrorOptions | ExportFailedErrorOptions | EventNotFoundErrorOptions | DuplicateToolIdErrorOptions | DuplicateRowIdErrorOptions | DuplicateEventIdErrorOptions | DateNotSelectedErrorOptions | DateAlreadySelectedErrorOptions | CellDeletedErrorOptions;
+export interface AppNotFoundErrorOptions extends SpruceErrors.HeartwoodViewControllers.AppNotFound, ISpruceErrorOptions {
+    code: 'APP_NOT_FOUND';
+}
+type ErrorOptions = ViewAlreadyDestroyedErrorOptions | ToolNotFoundErrorOptions | StepNotCompleteErrorOptions | SlideNotFoundErrorOptions | RowDeletedErrorOptions | PersonNotFoundErrorOptions | NoFieldVcSetErrorOptions | MissingStorageErrorOptions | InvalidViewControllerSourceErrorOptions | InvalidViewControllerNameErrorOptions | InvalidSkillViewControllerErrorOptions | ExportFailedErrorOptions | EventNotFoundErrorOptions | DuplicateToolIdErrorOptions | DuplicateRowIdErrorOptions | DuplicateEventIdErrorOptions | DateNotSelectedErrorOptions | DateAlreadySelectedErrorOptions | CellDeletedErrorOptions | AppNotFoundErrorOptions;
 export default ErrorOptions;

package/build/errors/SpruceError.js

@@ -74,6 +74,9 @@ class SpruceError extends error_1.default {
             case 'STEP_NOT_COMPLETE':
                 message = `You tried to open step '${options.stepId}', but it's not complete!`;
                 break;
+            case 'APP_NOT_FOUND':
+                message = `I could not find an App with the namespace '${options.namespace}'!`;
+                break;
             default:
                 message = super.friendlyMessage();
         }

package/build/errors/appNotFound.builder.d.ts

@@ -0,0 +1,11 @@
+declare const _default: {
+    id: string;
+    name: string;
+    fields: {
+        namespace: {
+            type: "id";
+            isRequired: true;
+        };
+    };
+};
+export default _default;

package/build/errors/appNotFound.builder.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const schema_1 = require("@sprucelabs/schema");
+exports.default = (0, schema_1.buildErrorSchema)({
+    id: 'appNotFound',
+    name: 'App not found',
+    fields: {
+        namespace: {
+            type: 'id',
+            isRequired: true,
+        },
+    },
+});

package/build/esm/.spruce/errors/errors.types.d.ts

@@ -387,3 +387,23 @@ export declare namespace SpruceErrors.HeartwoodViewControllers {
     }
     type CellDeletedEntity = SchemaEntity<SpruceErrors.HeartwoodViewControllers.CellDeletedSchema>;
 }
+export declare namespace SpruceErrors.HeartwoodViewControllers {
+    interface AppNotFound {
+        'namespace': string;
+    }
+    interface AppNotFoundSchema extends SpruceSchema.Schema {
+        id: 'appNotFound';
+        namespace: 'HeartwoodViewControllers';
+        name: 'App not found';
+        moduleToImportFromWhenRemote: '@sprucelabs/heartwood-view-controllers';
+        fields: {
+            /** . */
+            'namespace': {
+                type: 'id';
+                isRequired: true;
+                options: undefined;
+            };
+        };
+    }
+    type AppNotFoundEntity = SchemaEntity<SpruceErrors.HeartwoodViewControllers.AppNotFoundSchema>;
+}

package/build/esm/.spruce/errors/options.types.d.ts

@@ -57,5 +57,8 @@ export interface DateAlreadySelectedErrorOptions extends SpruceErrors.HeartwoodV
 export interface CellDeletedErrorOptions extends SpruceErrors.HeartwoodViewControllers.CellDeleted, ISpruceErrorOptions {
     code: 'CELL_DELETED';
 }
-type ErrorOptions = ViewAlreadyDestroyedErrorOptions | ToolNotFoundErrorOptions | StepNotCompleteErrorOptions | SlideNotFoundErrorOptions | RowDeletedErrorOptions | PersonNotFoundErrorOptions | NoFieldVcSetErrorOptions | MissingStorageErrorOptions | InvalidViewControllerSourceErrorOptions | InvalidViewControllerNameErrorOptions | InvalidSkillViewControllerErrorOptions | ExportFailedErrorOptions | EventNotFoundErrorOptions | DuplicateToolIdErrorOptions | DuplicateRowIdErrorOptions | DuplicateEventIdErrorOptions | DateNotSelectedErrorOptions | DateAlreadySelectedErrorOptions | CellDeletedErrorOptions;
+export interface AppNotFoundErrorOptions extends SpruceErrors.HeartwoodViewControllers.AppNotFound, ISpruceErrorOptions {
+    code: 'APP_NOT_FOUND';
+}
+type ErrorOptions = ViewAlreadyDestroyedErrorOptions | ToolNotFoundErrorOptions | StepNotCompleteErrorOptions | SlideNotFoundErrorOptions | RowDeletedErrorOptions | PersonNotFoundErrorOptions | NoFieldVcSetErrorOptions | MissingStorageErrorOptions | InvalidViewControllerSourceErrorOptions | InvalidViewControllerNameErrorOptions | InvalidSkillViewControllerErrorOptions | ExportFailedErrorOptions | EventNotFoundErrorOptions | DuplicateToolIdErrorOptions | DuplicateRowIdErrorOptions | DuplicateEventIdErrorOptions | DateNotSelectedErrorOptions | DateAlreadySelectedErrorOptions | CellDeletedErrorOptions | AppNotFoundErrorOptions;
 export default ErrorOptions;

package/build/esm/errors/SpruceError.js

@@ -70,6 +70,9 @@ export default class SpruceError extends AbstractSpruceError {
             case 'STEP_NOT_COMPLETE':
                 message = `You tried to open step '${options.stepId}', but it's not complete!`;
                 break;
+            case 'APP_NOT_FOUND':
+                message = `I could not find an App with the namespace '${options.namespace}'!`;
+                break;
             default:
                 message = super.friendlyMessage();
         }

package/build/esm/errors/appNotFound.builder.d.ts

@@ -0,0 +1,11 @@
+declare const _default: {
+    id: string;
+    name: string;
+    fields: {
+        namespace: {
+            type: "id";
+            isRequired: true;
+        };
+    };
+};
+export default _default;

package/build/esm/errors/appNotFound.builder.js

@@ -0,0 +1,11 @@
+import { buildErrorSchema } from '@sprucelabs/schema';
+export default buildErrorSchema({
+    id: 'appNotFound',
+    name: 'App not found',
+    fields: {
+        namespace: {
+            type: 'id',
+            isRequired: true,
+        },
+    },
+});

package/build/esm/tests/constants.d.ts

@@ -5,6 +5,7 @@ export declare const importExportCwd: string;
 export declare const importExportSource: string;
 export declare const importExportSourceNoIds: string;
 export declare const importExportSourceApp: string;
+export declare const importExportSourceApp2: string;
 export declare const importExportDestinationApp: string;
 export declare const importExportDestinationNoIds: string;
 export declare const importExportSourceSyntaxError: string;

package/build/esm/tests/constants.js

@@ -12,6 +12,7 @@ export const importExportSource = '.' +
     diskUtil.resolvePath('src', '.spruce', 'views', 'views.ts');
 export const importExportSourceNoIds = diskUtil.resolvePath(__dirname, '..', '..', 'src', '__tests__', 'testDirsAndFiles', 'skill_no_ids', 'src', '.spruce', 'views', 'views.ts');
 export const importExportSourceApp = diskUtil.resolvePath(__dirname, '..', '..', 'src', '__tests__', 'testDirsAndFiles', 'skill_with_app', 'src', '.spruce', 'views', 'views.ts');
+export const importExportSourceApp2 = diskUtil.resolvePath(__dirname, '..', '..', 'src', '__tests__', 'testDirsAndFiles', 'skill_with_app_2', 'src', '.spruce', 'views', 'views.ts');
 export const importExportDestinationApp = diskUtil.resolvePath(diskUtil.createRandomTempDir(), 'bundle.js');
 export const importExportDestinationNoIds = diskUtil.resolvePath(diskUtil.createRandomTempDir(), 'bundle.js');
 export const importExportSourceSyntaxError = diskUtil.resolvePath(__dirname, '..', '..', 'src', '__tests__', 'testDirsAndFiles', 'skill_syntax_error', 'src', '.spruce', 'views', 'views.ts');

package/build/esm/types/heartwood.types.d.ts

@@ -205,7 +205,7 @@ export interface SkillViewController<Args extends Record<string, any> = Record<s
     getTitle?(): string | undefined;
     getSubtitle?(): string | undefined;
 }
-export type ImportedViewController = (new () => ViewController<any> | SkillViewController) & {
+export type ImportedViewController = (new (options: ViewControllerOptions) => ViewController<any> | SkillViewController) & {
     id: string;
 };
 export type ViewControllerId = keyof ViewControllerMap;

package/build/esm/viewControllers/Abstract.avc.d.ts

@@ -1,4 +1,5 @@
 import { AppViewController, ViewControllerOptions } from '../types/heartwood.types';
 export default abstract class AbstractAppViewController implements AppViewController {
+    static id: string;
     constructor(_options: ViewControllerOptions);
 }

package/build/esm/viewControllers/Abstract.vc.d.ts

@@ -4,6 +4,7 @@ import { Client, ViewController, ViewControllerOptions, ConfirmOptions, ViewCont
 import { DialogViewControllerOptions } from './Dialog.vc';
 import ViewControllerFactory from './ViewControllerFactory';
 export default abstract class AbstractViewController<ViewModel extends Record<string, any>> implements ViewController<ViewModel> {
+    static id: string;
     private vcFactory;
     private renderInDialogHandler;
     private confirmHandler;

package/build/esm/viewControllers/ViewControllerFactory.d.ts

@@ -1,6 +1,6 @@
 import { DateUtil } from '@sprucelabs/calendar-utils';
 import { Log } from '@sprucelabs/spruce-skill-utils';
-import { ConfirmHandler, ControllerOptions, ImportedViewController, RenderInDialogHandler, ViewController, ViewControllerMap, ViewControllerId, VoteHandler, Device, MapUtil, ViewControllerConstructor, ToastHandler, ViewControllerPlugins, ViewControllerPluginsByName, ConnectToApi, ViewControllerPlugin, ViewControllerPluginOptions, ViewControllerOptions, AppViewController } from '../types/heartwood.types';
+import { ConfirmHandler, ControllerOptions, ImportedViewController, RenderInDialogHandler, ViewController, ViewControllerMap, ViewControllerId, VoteHandler, Device, MapUtil, ViewControllerConstructor, ToastHandler, ViewControllerPlugins, ViewControllerPluginsByName, ConnectToApi, ViewControllerPlugin, ViewControllerPluginOptions, ViewControllerOptions, AppViewController, AppViewControllerConstructor } from '../types/heartwood.types';
 export default class ViewControllerFactory {
     static Class?: typeof ViewControllerFactory;
     private controllerMap;
@@ -14,6 +14,7 @@ export default class ViewControllerFactory {
     private toastHandler;
     protected log?: Log;
     protected plugins: ViewControllerPlugins;
+    private AppMap;
     constructor(options: ViewControllerFactoryConstructorOptions);
     setRenderInDialogHandler(handler: RenderInDialogHandler): void;
     setConfirmHandler(handler: ConfirmHandler): void;
@@ -21,7 +22,7 @@ export default class ViewControllerFactory {
     static Factory(options: ViewControllerFactoryOptions): ViewControllerFactory;
     setController<Vc extends ViewController<any>>(name: string, Class: ViewControllerConstructor<Vc>): void;
     mixinControllers(map: Record<string, ViewControllerConstructor<ViewController<any>>>): void;
-    importControllers<Vc extends ImportedViewController>(Vcs: Vc[], plugins?: ViewControllerPluginsByName): void;
+    importControllers<Vc extends ImportedViewController>(Vcs: Vc[], plugins?: ViewControllerPluginsByName, App?: AppViewControllerConstructor): void;
     private importPlugins;
     BuildPlugin<P extends ViewControllerPlugin>(Plugin: new (options: ViewControllerPluginOptions) => P): P;
     BuildApp<A extends AppViewController>(App: new (options: ViewControllerOptions) => A): A;
@@ -29,7 +30,8 @@ export default class ViewControllerFactory {
     getController<N extends ViewControllerId>(name: N): any;
     setDates(dates: DateUtil): void;
     addPlugin(named: string, plugin: ViewControllerPlugin): void;
-    Controller<N extends ViewControllerId, O extends ControllerOptions<N>>(name: N, options: O): ViewControllerMap[N];
+    App(namespace: string): AppViewController;
+    Controller<N extends ViewControllerId, O extends ControllerOptions<N>>(id: N, options: O): ViewControllerMap[N];
     protected buildViewContructorOptions(name: string, options?: Record<string, any>): ViewControllerOptions;
     private sharedConstructorOptions;
 }

package/build/esm/viewControllers/ViewControllerFactory.js

@@ -16,6 +16,7 @@ import mapUtil from '../maps/map.utility.js';
 export default class ViewControllerFactory {
     constructor(options) {
         this.plugins = {};
+        this.AppMap = {};
         const { controllerMap, renderInDialogHandler, confirmHandler, connectToApi, voteHandler, device, dates, maps, toastHandler, log, pluginsByName, } = options;
         this.controllerMap = Object.assign(Object.assign({}, controllerMap), CORE_CONTROLLER_MAP);
         this.renderInDialogHandler = renderInDialogHandler;
@@ -64,11 +65,15 @@ export default class ViewControllerFactory {
     mixinControllers(map) {
         this.controllerMap = Object.assign(Object.assign({}, this.controllerMap), map);
     }
-    importControllers(Vcs, plugins) {
+    importControllers(Vcs, plugins, App) {
         for (const Vc of Vcs) {
             //@ts-ignore
             this.controllerMap[Vc.id] = Vc;
         }
+        if (App) {
+            //@ts-ignore
+            this.AppMap[App.id] = App;
+        }
         this.importPlugins(plugins);
     }
     importPlugins(pluginsByName) {
@@ -97,16 +102,26 @@ export default class ViewControllerFactory {
         //@ts-ignore
         this.plugins[named] = plugin;
     }
-    Controller(name, options) {
-        const Class = this.controllerMap[name];
+    App(namespace) {
+        const App = this.AppMap[namespace];
+        if (!App) {
+            throw new SpruceError({
+                code: 'APP_NOT_FOUND',
+                namespace,
+            });
+        }
+        return this.BuildApp(App);
+    }
+    Controller(id, options) {
+        const Class = this.controllerMap[id];
         if (!Class) {
             throw new SpruceError({
                 code: 'INVALID_VIEW_CONTROLLER_NAME',
-                name,
+                name: id,
                 validNames: Object.keys(this.controllerMap),
             });
         }
-        const constructorOptions = this.buildViewContructorOptions(name, options);
+        const constructorOptions = this.buildViewContructorOptions(id, options);
         const oldController = Class.prototype.Controller;
         //@ts-ignore
         let instance = new Class(constructorOptions);
@@ -116,11 +131,11 @@ export default class ViewControllerFactory {
             throw new SpruceError({
                 code: 'INVALID_SKILL_VIEW_CONTROLLER',
                 friendlyMessage: `Property \`id\` is reserved. Please rename it to \`_id\`.`,
-                id: name,
+                id,
             });
         }
         //@ts-ignore
-        instance.id = name;
+        instance.id = id;
         //@ts-ignore
         return instance;
     }

package/build/tests/constants.d.ts

@@ -5,6 +5,7 @@ export declare const importExportCwd: string;
 export declare const importExportSource: string;
 export declare const importExportSourceNoIds: string;
 export declare const importExportSourceApp: string;
+export declare const importExportSourceApp2: string;
 export declare const importExportDestinationApp: string;
 export declare const importExportDestinationNoIds: string;
 export declare const importExportSourceSyntaxError: string;

package/build/tests/constants.js

@@ -3,7 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.importExportSourcePlugins2 = exports.importExportSourcePlugins1 = exports.importExportSourceWithDefines = exports.importExportSourceNodeModulesImport = exports.buildCwdNodeModulesImport = exports.importExportDestination = exports.importExportSourceSyntaxError = exports.importExportDestinationNoIds = exports.importExportDestinationApp = exports.importExportSourceApp = exports.importExportSourceNoIds = exports.importExportSource = exports.importExportCwd = exports.DEMO_NUMBER_ACTIVE_RECORD = exports.DEMO_NUMBER2 = exports.DEMO_NUMBER = void 0;
+exports.importExportSourcePlugins2 = exports.importExportSourcePlugins1 = exports.importExportSourceWithDefines = exports.importExportSourceNodeModulesImport = exports.buildCwdNodeModulesImport = exports.importExportDestination = exports.importExportSourceSyntaxError = exports.importExportDestinationNoIds = exports.importExportDestinationApp = exports.importExportSourceApp2 = exports.importExportSourceApp = exports.importExportSourceNoIds = exports.importExportSource = exports.importExportCwd = exports.DEMO_NUMBER_ACTIVE_RECORD = exports.DEMO_NUMBER2 = exports.DEMO_NUMBER = void 0;
 const path_1 = __importDefault(require("path"));
 const spruce_skill_utils_1 = require("@sprucelabs/spruce-skill-utils");
 const dotenv = require('dotenv');
@@ -17,6 +17,7 @@ exports.importExportSource = '.' +
     spruce_skill_utils_1.diskUtil.resolvePath('src', '.spruce', 'views', 'views.ts');
 exports.importExportSourceNoIds = spruce_skill_utils_1.diskUtil.resolvePath(__dirname, '..', '..', 'src', '__tests__', 'testDirsAndFiles', 'skill_no_ids', 'src', '.spruce', 'views', 'views.ts');
 exports.importExportSourceApp = spruce_skill_utils_1.diskUtil.resolvePath(__dirname, '..', '..', 'src', '__tests__', 'testDirsAndFiles', 'skill_with_app', 'src', '.spruce', 'views', 'views.ts');
+exports.importExportSourceApp2 = spruce_skill_utils_1.diskUtil.resolvePath(__dirname, '..', '..', 'src', '__tests__', 'testDirsAndFiles', 'skill_with_app_2', 'src', '.spruce', 'views', 'views.ts');
 exports.importExportDestinationApp = spruce_skill_utils_1.diskUtil.resolvePath(spruce_skill_utils_1.diskUtil.createRandomTempDir(), 'bundle.js');
 exports.importExportDestinationNoIds = spruce_skill_utils_1.diskUtil.resolvePath(spruce_skill_utils_1.diskUtil.createRandomTempDir(), 'bundle.js');
 exports.importExportSourceSyntaxError = spruce_skill_utils_1.diskUtil.resolvePath(__dirname, '..', '..', 'src', '__tests__', 'testDirsAndFiles', 'skill_syntax_error', 'src', '.spruce', 'views', 'views.ts');

package/build/types/heartwood.types.d.ts

@@ -205,7 +205,7 @@ export interface SkillViewController<Args extends Record<string, any> = Record<s
     getTitle?(): string | undefined;
     getSubtitle?(): string | undefined;
 }
-export type ImportedViewController = (new () => ViewController<any> | SkillViewController) & {
+export type ImportedViewController = (new (options: ViewControllerOptions) => ViewController<any> | SkillViewController) & {
     id: string;
 };
 export type ViewControllerId = keyof ViewControllerMap;

package/build/viewControllers/Abstract.avc.d.ts

@@ -1,4 +1,5 @@
 import { AppViewController, ViewControllerOptions } from '../types/heartwood.types';
 export default abstract class AbstractAppViewController implements AppViewController {
+    static id: string;
     constructor(_options: ViewControllerOptions);
 }

package/build/viewControllers/Abstract.vc.d.ts

@@ -4,6 +4,7 @@ import { Client, ViewController, ViewControllerOptions, ConfirmOptions, ViewCont
 import { DialogViewControllerOptions } from './Dialog.vc';
 import ViewControllerFactory from './ViewControllerFactory';
 export default abstract class AbstractViewController<ViewModel extends Record<string, any>> implements ViewController<ViewModel> {
+    static id: string;
     private vcFactory;
     private renderInDialogHandler;
     private confirmHandler;

package/build/viewControllers/ViewControllerFactory.d.ts

@@ -1,6 +1,6 @@
 import { DateUtil } from '@sprucelabs/calendar-utils';
 import { Log } from '@sprucelabs/spruce-skill-utils';
-import { ConfirmHandler, ControllerOptions, ImportedViewController, RenderInDialogHandler, ViewController, ViewControllerMap, ViewControllerId, VoteHandler, Device, MapUtil, ViewControllerConstructor, ToastHandler, ViewControllerPlugins, ViewControllerPluginsByName, ConnectToApi, ViewControllerPlugin, ViewControllerPluginOptions, ViewControllerOptions, AppViewController } from '../types/heartwood.types';
+import { ConfirmHandler, ControllerOptions, ImportedViewController, RenderInDialogHandler, ViewController, ViewControllerMap, ViewControllerId, VoteHandler, Device, MapUtil, ViewControllerConstructor, ToastHandler, ViewControllerPlugins, ViewControllerPluginsByName, ConnectToApi, ViewControllerPlugin, ViewControllerPluginOptions, ViewControllerOptions, AppViewController, AppViewControllerConstructor } from '../types/heartwood.types';
 export default class ViewControllerFactory {
     static Class?: typeof ViewControllerFactory;
     private controllerMap;
@@ -14,6 +14,7 @@ export default class ViewControllerFactory {
     private toastHandler;
     protected log?: Log;
     protected plugins: ViewControllerPlugins;
+    private AppMap;
     constructor(options: ViewControllerFactoryConstructorOptions);
     setRenderInDialogHandler(handler: RenderInDialogHandler): void;
     setConfirmHandler(handler: ConfirmHandler): void;
@@ -21,7 +22,7 @@ export default class ViewControllerFactory {
     static Factory(options: ViewControllerFactoryOptions): ViewControllerFactory;
     setController<Vc extends ViewController<any>>(name: string, Class: ViewControllerConstructor<Vc>): void;
     mixinControllers(map: Record<string, ViewControllerConstructor<ViewController<any>>>): void;
-    importControllers<Vc extends ImportedViewController>(Vcs: Vc[], plugins?: ViewControllerPluginsByName): void;
+    importControllers<Vc extends ImportedViewController>(Vcs: Vc[], plugins?: ViewControllerPluginsByName, App?: AppViewControllerConstructor): void;
     private importPlugins;
     BuildPlugin<P extends ViewControllerPlugin>(Plugin: new (options: ViewControllerPluginOptions) => P): P;
     BuildApp<A extends AppViewController>(App: new (options: ViewControllerOptions) => A): A;
@@ -29,7 +30,8 @@ export default class ViewControllerFactory {
     getController<N extends ViewControllerId>(name: N): any;
     setDates(dates: DateUtil): void;
     addPlugin(named: string, plugin: ViewControllerPlugin): void;
-    Controller<N extends ViewControllerId, O extends ControllerOptions<N>>(name: N, options: O): ViewControllerMap[N];
+    App(namespace: string): AppViewController;
+    Controller<N extends ViewControllerId, O extends ControllerOptions<N>>(id: N, options: O): ViewControllerMap[N];
     protected buildViewContructorOptions(name: string, options?: Record<string, any>): ViewControllerOptions;
     private sharedConstructorOptions;
 }

package/build/viewControllers/ViewControllerFactory.js

@@ -12,6 +12,7 @@ const map_utility_1 = __importDefault(require("../maps/map.utility"));
 class ViewControllerFactory {
     constructor(options) {
         this.plugins = {};
+        this.AppMap = {};
         const { controllerMap, renderInDialogHandler, confirmHandler, connectToApi, voteHandler, device, dates, maps, toastHandler, log, pluginsByName, } = options;
         this.controllerMap = { ...controllerMap, ...controllerMap_1.CORE_CONTROLLER_MAP };
         this.renderInDialogHandler = renderInDialogHandler;
@@ -62,11 +63,15 @@ class ViewControllerFactory {
             ...map,
         };
     }
-    importControllers(Vcs, plugins) {
+    importControllers(Vcs, plugins, App) {
         for (const Vc of Vcs) {
             //@ts-ignore
             this.controllerMap[Vc.id] = Vc;
         }
+        if (App) {
+            //@ts-ignore
+            this.AppMap[App.id] = App;
+        }
         this.importPlugins(plugins);
     }
     importPlugins(pluginsByName) {
@@ -95,16 +100,26 @@ class ViewControllerFactory {
         //@ts-ignore
         this.plugins[named] = plugin;
     }
-    Controller(name, options) {
-        const Class = this.controllerMap[name];
+    App(namespace) {
+        const App = this.AppMap[namespace];
+        if (!App) {
+            throw new SpruceError_1.default({
+                code: 'APP_NOT_FOUND',
+                namespace,
+            });
+        }
+        return this.BuildApp(App);
+    }
+    Controller(id, options) {
+        const Class = this.controllerMap[id];
         if (!Class) {
             throw new SpruceError_1.default({
                 code: 'INVALID_VIEW_CONTROLLER_NAME',
-                name,
+                name: id,
                 validNames: Object.keys(this.controllerMap),
             });
         }
-        const constructorOptions = this.buildViewContructorOptions(name, options);
+        const constructorOptions = this.buildViewContructorOptions(id, options);
         const oldController = Class.prototype.Controller;
         //@ts-ignore
         let instance = new Class(constructorOptions);
@@ -114,11 +129,11 @@ class ViewControllerFactory {
             throw new SpruceError_1.default({
                 code: 'INVALID_SKILL_VIEW_CONTROLLER',
                 friendlyMessage: `Property \`id\` is reserved. Please rename it to \`_id\`.`,
-                id: name,
+                id,
             });
         }
         //@ts-ignore
-        instance.id = name;
+        instance.id = id;
         //@ts-ignore
         return instance;
     }

package/package.json

@@ -13,7 +13,7 @@
   "sideEffects": false,
   "license": "MIT",
   "description": "All the power of Heartwood in one, convenient package.",
-  "version": "111.1.29",
+  "version": "111.1.31",
   "skill": {
     "namespace": "HeartwoodViewControllers",
     "commandOverrides": {