marionette 5.0.0-beta.3 → 5.0.0-beta.5

package/changelog.md

@@ -1,4 +1,40 @@
-### Unreleased
+### v5.0.0-beta.5
+
+> An Application can keep its children without keeping yesterday’s living room.
+
+* Separate Application root ownership from its host Region. Stopping an Application
+  releases its prepared and displayed roots without clearing another Application's
+  replacement in a borrowed Region. Prepare roots with `setView()` and hand them
+  to the Region with `showView()`; displaying a View directly through a Region
+  does not transfer Application ownership.
+* Accept an existing Region in `start({ region })` and `restart({ region })`, so
+  retained child Applications can follow recreated parent layouts. Constructor
+  Region definitions remain owned; startup Regions are borrowed. Use `restart()`
+  when changing the host of an active Application.
+* Add `childApps` constructor maps or functions for static, no-argument children.
+  Construct and register them once before parent initialization; activation stays
+  explicit. Subclass and option declarations replace inherited maps. Use
+  `addChildApp()` for dynamic children or constructor arguments.
+* Expand executable lifecycle and migration guidance, and direct documentation
+  retrieval toward relevant contracts. These changes do not establish measured
+  agent-effectiveness or stable-v5 readiness.
+* Shard Windows release certification while retaining the complete fixture gate.
+
+### v5.0.0-beta.4
+
+> Events announce. Preparation waits. Apparently those needed separate job descriptions.
+
+* Separate Application preparation from lifecycle notifications. Await
+  `prepareStart`, `prepareStop`, and `prepareDestroy`; `onBefore*` hooks and
+  `before:*` events are synchronous notifications. Pass `prepareStart`'s resolved
+  value unchanged to `onStart` and `start` as the third argument. Migrate async
+  `onBefore*` work to the corresponding preparation method.
+* Preserve inferred startup result types for optional preparation methods, including
+  `undefined` when the method is absent.
+* Include referenced consumer resources in documentation exports and keep maintainer
+  material out of the packaged consumer documentation.
+* Clarify packaged and copied agent-skill helper paths, with executable lookup
+  examples checked against the installed documentation.
 
 ### v5.0.0-beta.3
 

package/dist/agent-skill/SKILL.md

@@ -11,11 +11,20 @@ choices. This skill does not authorize dependency upgrades.
 ## Locate matching docs
 
 Resolve the package from the application workspace, not the copied skill directory
-or a neighboring monorepo package. The read-only helper requires Node 24 or later:
+or a neighboring monorepo package. The read-only helper requires Node 24 or later.
+Its path is `scripts/docs.mjs` relative to the directory containing this `SKILL.md`:
+
+- In the npm package, that directory is `<package-root>/dist/agent-skill/`.
+- After copying the skill, it is the copied directory, such as
+  `/path/to/application/.agents/skills/marionette/`.
+
+Replace `/path/to/skill-directory` with that directory's absolute path and
+`/path/to/application` with the application's absolute path. These commands work
+from any working directory:
 
 ```sh
-node /path/to/marionette/scripts/docs.mjs --project /path/to/application --list
-node /path/to/marionette/scripts/docs.mjs --project /path/to/application --page docs/agents.md
+node "/path/to/skill-directory/scripts/docs.mjs" --project "/path/to/application" --list
+node "/path/to/skill-directory/scripts/docs.mjs" --project "/path/to/application" --page docs/agents.md
 ```
 
 These are lookup options, not a required sequence. `--list` returns provenance and

package/dist/docs/config/api-contracts/inventory.json

@@ -1,11 +1,11 @@
 {
   "schemaVersion": 1,
   "authority": "authored TypeScript and explicit public behavioral evidence",
-  "semanticsSha256": "c007c7b263af096f58e58b22347ff1b67c7a4f66abb63b4a2be5d2b73ecd9e30",
+  "semanticsSha256": "077157bce1349db05f4e0870f4c4bce89077b3b0d227da7ec485034388c79074",
   "entrypoints": [
     {
       "name": "marionette",
-      "version": "5.0.0-beta.3",
+      "version": "5.0.0-beta.5",
       "kind": "runtime",
       "source": "src/index.ts",
       "conditions": {
@@ -39,7 +39,7 @@
           "members": {
             "apply": "(receiver: object, args: IArguments | [options?: ApplicationOptions | undefined]) => void",
             "call": "(receiver: object, options?: ApplicationOptions | undefined) => void",
-            "extend": "<Added extends object = {}, AddedStatics extends object = {}>(this: Added extends { constructor: (...args: never[]) => unknown; } ? object : (this: object, ...args: never[]) => unknown, prototypeProperties?: (Added & ThisType<Merge<ApplicationInstance<Merge<DefaultOptions<Added>, OptionsFor<ArgumentsFor<Added, [options?: ApplicationOptions | undefined]>>>, SuppliedState<Added, Added extends { createState: (...args: never[]) => infer State; } ? State : object>>, \"options\" extends keyof Added ? Omit<Added, keyof Added & \"options\"> : Added>>) | undefined, staticProperties?: (AddedStatics & ThisType<ApplicationConstructor<Added, ArgumentsFor<Added, [options?: ApplicationOptions | undefined]>, SuppliedState<Added, Added extends { createState: (...args: never[]) => infer State; } ? State : object>, AddedStatics>>) | undefined) => ApplicationConstructor<Added, ArgumentsFor<Added, [options?: ApplicationOptions | undefined]>, SuppliedState<Added, Added extends { createState: (...args: never[]) => infer State; } ? State : object>, AddedStatics>",
+            "extend": "<Added extends object = {}, AddedStatics extends object = {}>(this: Added extends { constructor: (...args: never[]) => unknown; } ? object : (this: object, ...args: never[]) => unknown, prototypeProperties?: (Added & ThisType<Merge<ApplicationInstance<Merge<DefaultOptions<Added>, OptionsFor<ArgumentsFor<Added, [options?: ApplicationOptions | undefined]>>>, SuppliedState<Added, Added extends { createState: (...args: never[]) => infer State; } ? State : object>, StartResultFor<Added>>, \"options\" extends keyof Added ? Omit<Added, keyof Added & \"options\"> : Added>>) | undefined, staticProperties?: (AddedStatics & ThisType<ApplicationConstructor<Added, ArgumentsFor<Added, [options?: ApplicationOptions | undefined]>, SuppliedState<Added, Added extends { createState: (...args: never[]) => infer State; } ? State : object>, AddedStatics>>) | undefined) => ApplicationConstructor<Added, ArgumentsFor<Added, [options?: ApplicationOptions | undefined]>, SuppliedState<Added, Added extends { createState: (...args: never[]) => infer State; } ? State : object>, AddedStatics>",
             "setStateApi": "<Receiver extends StateApiClass, Mixin extends object>(this: Receiver, mixin?: string | number | bigint | boolean | symbol | (Mixin & Partial<StateApi<never>>) | null | undefined) => Receiver"
           },
           "callableMembers": [
@@ -49,20 +49,21 @@
             "setStateApi"
           ],
           "construct": [
-            "<Provided extends [options?: ApplicationOptions | undefined] = [options?: ApplicationOptions | undefined]>(...args: Provided): ApplicationInstance<object & OptionsFor<Provided>, SuppliedState<Provided[0], object>>"
+            "<Provided extends [options?: ApplicationOptions | undefined] = [options?: ApplicationOptions | undefined]>(...args: Provided): ApplicationInstance<object & OptionsFor<Provided>, SuppliedState<Provided[0], object>, unknown>"
           ],
           "instance": {
             "addChildApp": "<Child extends ApplicationInstance<object, unknown>>(name: string, application: Child) => Child",
             "bindEvents": "<Receiver extends Listener>(this: Receiver, entity?: false | \"\" | 0 | 0n | EventSource | null | undefined, bindings?: false | object | \"\" | 0 | 0n | null | undefined) => Receiver",
             "bindRequests": "<Receiver>(this: Receiver, channel?: false | \"\" | 0 | 0n | ReplyChannel | null | undefined, bindings?: false | object | \"\" | 0 | 0n | null | undefined) => Receiver",
             "channelName": "?string | (() => string) | undefined",
+            "childApps": "?ChildApplications | (() => ChildApplications) | undefined",
             "cid": "string",
             "cidPrefix": "string",
             "createState": "(options?: (object & ApplicationOptions) | undefined) => unknown",
             "destroy": "(options?: unknown) => Promise<boolean>",
             "getChannel": "() => Channel | undefined",
-            "getChildApp": "(name: string) => ApplicationInstance<object, unknown> | undefined",
-            "getChildApps": "() => Record<string, ApplicationInstance<object, unknown>>",
+            "getChildApp": "(name: string) => ApplicationInstance<object, unknown, unknown> | undefined",
+            "getChildApps": "() => Record<string, ApplicationInstance<object, unknown, unknown>>",
             "getName": "() => string | undefined",
             "getOption": "{ (optionName?: null | undefined): undefined; <Receiver extends object, Name extends PropertyKey | null | undefined>(this: Receiver, optionName: Name): GetOptionResult<Receiver, Name>; (this: object, optionName: PropertyKey | null | undefined): unknown; }",
             "getRegion": "() => RegionInstance<RegionOptions> | undefined",
@@ -78,25 +79,28 @@
             "normalizeMethods": "{ (this: unknown, hash?: false | \"\" | 0 | 0n | null | undefined): undefined; (this: unknown, hash: object): EventMap; (this: unknown, hash?: OptionalBindings): EventMap | undefined; }",
             "off": "{ <Receiver>(this: Receiver, name?: string | null | undefined, callback?: EventCallback | null | undefined, context?: unknown): Receiver; <Receiver>(this: Receiver, events: EventMap, context?: unknown, explicitContext?: unknown): Receiver; }",
             "on": "{ <Receiver>(this: Receiver, name: string, callback?: EventCallback | undefined, context?: unknown): Receiver; <Receiver>(this: Receiver, events: EventMap, context?: unknown, explicitContext?: unknown): Receiver; }",
-            "onBeforeDestroy": "?((application: ApplicationInstance<object & ApplicationOptions, object>, options: unknown, context: LifecycleContext) => unknown) | undefined",
-            "onBeforeStart": "?((application: ApplicationInstance<object & ApplicationOptions, object>, options: unknown, context: LifecycleContext) => unknown) | undefined",
-            "onBeforeStop": "?((application: ApplicationInstance<object & ApplicationOptions, object>, options: unknown, context: LifecycleContext) => unknown) | undefined",
+            "onBeforeDestroy": "?((application: ApplicationInstance<object & ApplicationOptions, object, unknown>, options: unknown) => unknown) | undefined",
+            "onBeforeStart": "?((application: ApplicationInstance<object & ApplicationOptions, object, unknown>, options: unknown) => unknown) | undefined",
+            "onBeforeStop": "?((application: ApplicationInstance<object & ApplicationOptions, object, unknown>, options: unknown) => unknown) | undefined",
             "once": "{ <Receiver>(this: Receiver, name: string, callback?: EventCallback | undefined, context?: unknown): Receiver; <Receiver>(this: Receiver, events: EventMap, context?: unknown, explicitContext?: unknown): Receiver; }",
-            "onDestroy": "?((application: ApplicationInstance<object & ApplicationOptions, object>, options: unknown) => unknown) | undefined",
-            "onStart": "?((application: ApplicationInstance<object & ApplicationOptions, object>, options: unknown) => unknown) | undefined",
-            "onStop": "?((application: ApplicationInstance<object & ApplicationOptions, object>, options: unknown) => unknown) | undefined",
+            "onDestroy": "?((application: ApplicationInstance<object & ApplicationOptions, object, unknown>, options: unknown) => unknown) | undefined",
+            "onStart": "?((application: ApplicationInstance<object & ApplicationOptions, object, unknown>, options: unknown, result: unknown) => unknown) | undefined",
+            "onStop": "?((application: ApplicationInstance<object & ApplicationOptions, object, unknown>, options: unknown) => unknown) | undefined",
             "options": "object & ApplicationOptions",
             "preinitialize": "(options?: (object & ApplicationOptions) | undefined) => void",
+            "prepareDestroy": "?((options: unknown, context: LifecycleContext) => unknown) | undefined",
+            "prepareStart": "?((options: unknown, context: LifecycleContext) => unknown) | undefined",
+            "prepareStop": "?((options: unknown, context: LifecycleContext) => unknown) | undefined",
             "Radio": "RadioApi",
             "radioEvents": "?object | (() => object) | undefined",
             "radioRequests": "?object | (() => object) | undefined",
             "region": "?RegionDefinition | undefined",
             "regionClass": "RegionClass",
-            "removeChildApp": "(name: string, options?: unknown) => Promise<ApplicationInstance<object, unknown> | undefined>",
-            "restart": "(options?: unknown) => Promise<boolean>",
+            "removeChildApp": "(name: string, options?: unknown) => Promise<ApplicationInstance<object, unknown, unknown> | undefined>",
+            "restart": "(options?: ApplicationStartOptions | undefined) => Promise<boolean>",
             "setView": "<Child extends SupportedView>(view: Child) => Child",
             "showView": "{ (view?: undefined, options?: ShowOptions | undefined): SupportedView | undefined; <Child extends SupportedView>(view: Child, options?: ShowOptions | undefined): Child; }",
-            "start": "(options?: unknown) => Promise<boolean>",
+            "start": "(options?: ApplicationStartOptions | undefined) => Promise<boolean>",
             "state": "?unknown",
             "State": "Partial<StateApi<never>>",
             "stateEvents": "?object | (() => object) | undefined",
@@ -139,6 +143,9 @@
             "onStart",
             "onStop",
             "preinitialize",
+            "prepareDestroy",
+            "prepareStart",
+            "prepareStop",
             "removeChildApp",
             "restart",
             "setView",
@@ -257,6 +264,15 @@
               "preinitialize": [
                 "application-composition"
               ],
+              "prepareDestroy": [
+                "application-lifecycle"
+              ],
+              "prepareStart": [
+                "application-lifecycle"
+              ],
+              "prepareStop": [
+                "application-lifecycle"
+              ],
               "removeChildApp": [
                 "application-composition"
               ],
@@ -309,7 +325,7 @@
             "call"
           ],
           "construct": [
-            "<Provided extends Args = Args>(...args: Provided): Constructed<Props, Merge<ApplicationInstance<Merge<DefaultOptions<Props>, OptionsFor<Provided>>, SuppliedState<Provided[0], State>>, \"options\" extends keyof Props ? Omit<Props, keyof Props & \"options\"> : Props>>"
+            "<Provided extends Args = Args>(...args: Provided): Constructed<Props, Merge<ApplicationInstance<Merge<DefaultOptions<Props>, OptionsFor<Provided>>, SuppliedState<Provided[0], State>, StartResultFor<Props>>, \"options\" extends keyof Props ? Omit<Props, keyof Props & \"options\"> : Props>>"
           ],
           "instance": {},
           "callableInstanceMembers": [],
@@ -330,7 +346,7 @@
         {
           "name": "ApplicationInstance",
           "kind": "type",
-          "signature": "ApplicationInstance<Options, State>",
+          "signature": "ApplicationInstance<Options, State, StartResult>",
           "contracts": [
             "type-shapes"
           ],
@@ -339,13 +355,14 @@
             "bindEvents": "<Receiver extends Listener>(this: Receiver, entity?: false | \"\" | 0 | 0n | EventSource | null | undefined, bindings?: false | object | \"\" | 0 | 0n | null | undefined) => Receiver",
             "bindRequests": "<Receiver>(this: Receiver, channel?: false | \"\" | 0 | 0n | ReplyChannel | null | undefined, bindings?: false | object | \"\" | 0 | 0n | null | undefined) => Receiver",
             "channelName": "?string | (() => string) | undefined",
+            "childApps": "?ChildApplications | (() => ChildApplications) | undefined",
             "cid": "string",
             "cidPrefix": "string",
             "createState": "(options?: Options | undefined) => unknown",
             "destroy": "(options?: unknown) => Promise<boolean>",
             "getChannel": "() => Channel | undefined",
-            "getChildApp": "(name: string) => ApplicationInstance<object, unknown> | undefined",
-            "getChildApps": "() => Record<string, ApplicationInstance<object, unknown>>",
+            "getChildApp": "(name: string) => ApplicationInstance<object, unknown, unknown> | undefined",
+            "getChildApps": "() => Record<string, ApplicationInstance<object, unknown, unknown>>",
             "getName": "() => string | undefined",
             "getOption": "{ (optionName?: null | undefined): undefined; <Receiver extends object, Name extends PropertyKey | null | undefined>(this: Receiver, optionName: Name): GetOptionResult<Receiver, Name>; (this: object, optionName: PropertyKey | null | undefined): unknown; }",
             "getRegion": "() => RegionInstance<RegionOptions> | undefined",
@@ -361,25 +378,28 @@
             "normalizeMethods": "{ (this: unknown, hash?: false | \"\" | 0 | 0n | null | undefined): undefined; (this: unknown, hash: object): EventMap; (this: unknown, hash?: OptionalBindings): EventMap | undefined; }",
             "off": "{ <Receiver>(this: Receiver, name?: string | null | undefined, callback?: EventCallback | null | undefined, context?: unknown): Receiver; <Receiver>(this: Receiver, events: EventMap, context?: unknown, explicitContext?: unknown): Receiver; }",
             "on": "{ <Receiver>(this: Receiver, name: string, callback?: EventCallback | undefined, context?: unknown): Receiver; <Receiver>(this: Receiver, events: EventMap, context?: unknown, explicitContext?: unknown): Receiver; }",
-            "onBeforeDestroy": "?((application: ApplicationInstance<Options, State>, options: unknown, context: LifecycleContext) => unknown) | undefined",
-            "onBeforeStart": "?((application: ApplicationInstance<Options, State>, options: unknown, context: LifecycleContext) => unknown) | undefined",
-            "onBeforeStop": "?((application: ApplicationInstance<Options, State>, options: unknown, context: LifecycleContext) => unknown) | undefined",
+            "onBeforeDestroy": "?((application: ApplicationInstance<Options, State, StartResult>, options: unknown) => unknown) | undefined",
+            "onBeforeStart": "?((application: ApplicationInstance<Options, State, StartResult>, options: unknown) => unknown) | undefined",
+            "onBeforeStop": "?((application: ApplicationInstance<Options, State, StartResult>, options: unknown) => unknown) | undefined",
             "once": "{ <Receiver>(this: Receiver, name: string, callback?: EventCallback | undefined, context?: unknown): Receiver; <Receiver>(this: Receiver, events: EventMap, context?: unknown, explicitContext?: unknown): Receiver; }",
-            "onDestroy": "?((application: ApplicationInstance<Options, State>, options: unknown) => unknown) | undefined",
-            "onStart": "?((application: ApplicationInstance<Options, State>, options: unknown) => unknown) | undefined",
-            "onStop": "?((application: ApplicationInstance<Options, State>, options: unknown) => unknown) | undefined",
+            "onDestroy": "?((application: ApplicationInstance<Options, State, StartResult>, options: unknown) => unknown) | undefined",
+            "onStart": "?((application: ApplicationInstance<Options, State, StartResult>, options: unknown, result: StartResult) => unknown) | undefined",
+            "onStop": "?((application: ApplicationInstance<Options, State, StartResult>, options: unknown) => unknown) | undefined",
             "options": "Options",
             "preinitialize": "(options?: Options | undefined) => void",
+            "prepareDestroy": "?((options: unknown, context: LifecycleContext) => unknown) | undefined",
+            "prepareStart": "?((options: unknown, context: LifecycleContext) => StartResult | PromiseLike<StartResult>) | undefined",
+            "prepareStop": "?((options: unknown, context: LifecycleContext) => unknown) | undefined",
             "Radio": "RadioApi",
             "radioEvents": "?object | (() => object) | undefined",
             "radioRequests": "?object | (() => object) | undefined",
             "region": "?RegionDefinition | undefined",
             "regionClass": "RegionClass",
-            "removeChildApp": "(name: string, options?: unknown) => Promise<ApplicationInstance<object, unknown> | undefined>",
-            "restart": "(options?: unknown) => Promise<boolean>",
+            "removeChildApp": "(name: string, options?: unknown) => Promise<ApplicationInstance<object, unknown, unknown> | undefined>",
+            "restart": "(options?: ApplicationStartOptions | undefined) => Promise<boolean>",
             "setView": "<Child extends SupportedView>(view: Child) => Child",
             "showView": "{ (view?: undefined, options?: ShowOptions | undefined): SupportedView | undefined; <Child extends SupportedView>(view: Child, options?: ShowOptions | undefined): Child; }",
-            "start": "(options?: unknown) => Promise<boolean>",
+            "start": "(options?: ApplicationStartOptions | undefined) => Promise<boolean>",
             "state": "?unknown",
             "State": "Partial<StateApi<never>>",
             "stateEvents": "?object | (() => object) | undefined",
@@ -422,6 +442,9 @@
             "onStart",
             "onStop",
             "preinitialize",
+            "prepareDestroy",
+            "prepareStart",
+            "prepareStop",
             "removeChildApp",
             "restart",
             "setView",
@@ -529,6 +552,15 @@
               "preinitialize": [
                 "type-shapes"
               ],
+              "prepareDestroy": [
+                "type-shapes"
+              ],
+              "prepareStart": [
+                "type-shapes"
+              ],
+              "prepareStop": [
+                "type-shapes"
+              ],
               "removeChildApp": [
                 "type-shapes"
               ],
@@ -574,6 +606,7 @@
           ],
           "members": {
             "channelName": "?string | (() => string) | undefined",
+            "childApps": "?ChildApplications | (() => ChildApplications) | undefined",
             "radioEvents": "?object | (() => object) | undefined",
             "radioRequests": "?object | (() => object) | undefined",
             "region": "?RegionDefinition | undefined",
@@ -584,6 +617,19 @@
           "callableMembers": [],
           "operationContracts": {}
         },
+        {
+          "name": "ApplicationStartOptions",
+          "kind": "type",
+          "signature": "ApplicationStartOptions",
+          "contracts": [
+            "type-shapes"
+          ],
+          "members": {
+            "region": "?RegionInstance<RegionOptions> | undefined"
+          },
+          "callableMembers": [],
+          "operationContracts": {}
+        },
         {
           "name": "Behavior",
           "kind": "value",
@@ -5312,7 +5358,7 @@
     },
     {
       "name": "@mnjs/utils",
-      "version": "5.0.0-beta.3",
+      "version": "5.0.0-beta.5",
       "kind": "runtime",
       "source": "packages/utils/src/index.ts",
       "conditions": {
@@ -5933,7 +5979,7 @@
     },
     {
       "name": "@mnjs/radio",
-      "version": "5.0.0-beta.3",
+      "version": "5.0.0-beta.5",
       "kind": "runtime",
       "source": "packages/radio/src/index.ts",
       "conditions": {
@@ -6394,7 +6440,7 @@
     },
     {
       "name": "@mnjs/data",
-      "version": "5.0.0-beta.3",
+      "version": "5.0.0-beta.5",
       "kind": "runtime",
       "source": "packages/data/src/index.ts",
       "conditions": {
@@ -6927,7 +6973,7 @@
     },
     {
       "name": "@mnjs/adapters/backbone",
-      "version": "5.0.0-beta.3",
+      "version": "5.0.0-beta.5",
       "kind": "runtime",
       "source": "packages/adapters/src/data/backbone.ts",
       "conditions": {
@@ -7002,7 +7048,7 @@
     },
     {
       "name": "@mnjs/adapters/dom/jquery",
-      "version": "5.0.0-beta.3",
+      "version": "5.0.0-beta.5",
       "kind": "runtime",
       "source": "packages/adapters/src/dom/jquery.ts",
       "conditions": {
@@ -7062,7 +7108,7 @@
     },
     {
       "name": "@mnjs/adapters/xstate",
-      "version": "5.0.0-beta.3",
+      "version": "5.0.0-beta.5",
       "kind": "runtime",
       "source": "packages/adapters/src/data/xstate.ts",
       "conditions": {
@@ -7149,7 +7195,7 @@
     },
     {
       "name": "@mnjs/adapters/dom/morphdom",
-      "version": "5.0.0-beta.3",
+      "version": "5.0.0-beta.5",
       "kind": "runtime",
       "source": "packages/adapters/src/dom/morphdom.ts",
       "conditions": {
@@ -7189,7 +7235,7 @@
     },
     {
       "name": "@mnjs/adapters/dom/lit-html",
-      "version": "5.0.0-beta.3",
+      "version": "5.0.0-beta.5",
       "kind": "runtime",
       "source": "packages/adapters/src/dom/lit-html.ts",
       "conditions": {
@@ -7414,6 +7460,13 @@
         "Region",
         "View"
       ]
+    },
+    {
+      "code": "MN0041",
+      "slug": "application-region-conflict",
+      "objects": [
+        "Application"
+      ]
     }
   ],
   "toolingEntrypoints": [
@@ -7806,8 +7859,7 @@
       "kind": "literal",
       "arguments": [
         "application",
-        "options",
-        "context"
+        "options"
       ]
     },
     {
@@ -7816,7 +7868,8 @@
       "kind": "literal",
       "arguments": [
         "application",
-        "options"
+        "options",
+        "result"
       ]
     },
     {
@@ -7825,8 +7878,7 @@
       "kind": "literal",
       "arguments": [
         "application",
-        "options",
-        "context"
+        "options"
       ]
     },
     {
@@ -7844,8 +7896,7 @@
       "kind": "literal",
       "arguments": [
         "this",
-        "options",
-        "context"
+        "options"
       ]
     },
     {
@@ -8002,7 +8053,7 @@
     "packages/utils/src/trigger-method.ts": "3a6460a5fdc6e0a319a6eea1e323f34f19fa0811ee1ea71fccaa45ade531d38f",
     "packages/utils/src/unique-id.ts": "22f5f12062eeef10c1336ee01e4b28b7d0cfe562c0f53f79e2a3219eb389f72b",
     "src/create-marionette.ts": "12baf1aadeeae54aefbb7e5777db9392f74650a407dcd506e97ebf18b73cfcc1",
-    "src/index.ts": "0fdbaa2bbb16566dd1032f786273e7b1acc8683390033b2c63b196e2dc04b449",
+    "src/index.ts": "41476602f9a5712f0742954fdc7d20a09bef62ba80711d25abe3d1bda8064656",
     "src/mixins/behaviors.ts": "720633138c31d36c3c9e9367c1cd9ef4a9b8514b2e5cfcb88e04bfdea7566991",
     "src/mixins/common.ts": "375340ed4f7c5db6c3bd9dc9d73c73b49e69347e3451c0db7dd646ae714f5156",
     "src/mixins/delegate-entity-events.ts": "778dc193ff0b32611e6a9112e133f961c2f522c6864ea847c70e7d676fb41c9c",
@@ -8013,7 +8064,7 @@
     "src/mixins/ui.ts": "5cb417e1456cd17b43357e480102be3fc1b436167c43b853af7d45ab79d35ffd",
     "src/mixins/view-events.ts": "108a31ba7d0f74916848c5b2f85b422afe15703a8e9fa2dbca0b17b6a5ff0fb2",
     "src/mixins/view.ts": "d0895d07d087d24d5cd8ce8d051a7acbbc9cee64fd2b5a6824b26973fc064e18",
-    "src/modules/application.ts": "11a9541a102d67f1d76ca83ec4bd65e8d68bfc7790e818aaeded14965dae42ec",
+    "src/modules/application.ts": "a13c62d8e5985de4c05806c71265a051023ab845dc9b9c65fa120734494817e8",
     "src/modules/behavior.ts": "475fe0451e629559992bd0f5ec18ad16438309b018bf643b5917dfc47a1693b6",
     "src/modules/child-view-container.ts": "ab52685a0a4fd8861534b8e9784704791c3e72a15ee19547766293be4a030803",
     "src/modules/collection-view.ts": "40bbaefedea29de171597e905f8fdde7ee6f55877da9e441996c9b5bf56bfe58",
@@ -8034,38 +8085,41 @@
     "src/utils/subscribe-bindings.ts": "24633b6b39c2d0a8c833670e2ab1d584fb6bed2fae3ac5cfb5d42461cf233f4a"
   },
   "evidence": {
-    "config/diagnostics/catalog.json": "76cc4270e2ec939078cc3c8537d66e45bf0a58010fe25eeef81ab21f58886997",
+    "config/diagnostics/catalog.json": "45360deea6dfe7d531b256dbbebb443e9fa578fb0d43fc9becce7ab5126c76bf",
     "docs/choosing-integrations.md": "385bfb2c7d85a8e0db71fd795ed1fef488aa637aa5094e93210810ff91f31f12",
     "docs/common.md": "1d14004d1c49e98ca40be9fd28d35faaf372f2a12f13fae6afa3cac8a8bf14cc",
-    "docs/data.api.md": "c4e946abf9806eadb86996f296de3b06e5265e0e724186ff33e172e5f43d8a23",
+    "docs/data.api.md": "f96a24fa8f08ed1437944d558e91878a16f941b7efd3dcc40c91b2de52d1f5a2",
     "docs/diagnostic-catalog.md": "1df844c7e8edbea59a8c07776d656d45f77266108babb770d7690183fe85d180",
     "docs/dom.api.md": "a697a637ae4c6cc92aa5d72850b404763f08e0417800feacc0b431ec073d3916",
     "docs/dom.interactions.md": "81bd678c7d498e08c08c84cfc3bbe1d27451ef46ed521e67fff4f72450bdbadb",
-    "docs/events.class.md": "7370bdc890168105ab61fd6140aae9f43ec473a0872fd7cdf1812d2cf9fd9e00",
-    "docs/events.md": "227484aca95a4003903bd8df51f3c38c11144480ace919b63bacbf5bc2bb3d22",
-    "docs/marionette.application.md": "9bf34ebf6130126135129ac04b03d37ee24ba7868d5596a15ffafdcbdc9af5a3",
+    "docs/events.class.md": "faed5ac4f6eca3ec447ae7cd44b6efd8f039e935b38a4c191076d485bd57a35f",
+    "docs/events.md": "8225ceda0d100b6bf466ab779cacc1001b7eec16b8dfd09d8c43d97924228e50",
+    "docs/marionette.application.md": "711283795f71f7bff273498e97a0e0c54a815f02f1ff9339a22fdf13d8bca048",
     "docs/marionette.behavior.md": "bf002b5ba380cf1bb1054b98f9813d89b4aef16ba6495d02b823ed178ab3f0c4",
     "docs/marionette.collectionview.md": "5af1ed04daaf0e976fdd0538b0931fd370fd09167079d0c21b01195f8628cefe",
     "docs/marionette.mnobject.md": "056bb3041902d66831a0031e2e9c97770f485f613450861ae55aba46ca592243",
-    "docs/marionette.region.md": "6716880b5ab5a6bf7b4b4a6dd7b66e7fdb7bd9c1c451578ad551d64f4be9e40d",
-    "docs/marionette.state.md": "fbee628142604499747a83f19055b05c0ba5831944760cf0910cc11cceef55f5",
+    "docs/marionette.region.md": "4b205c3699d771e6d6b288fd0914b15af80a7a76cfaaae9e63a92ac9ed0a6dee",
+    "docs/marionette.state.md": "2598f36fad1f5103f1f940312e311e1ed3c446d2e7725bdac690367511f73d97",
     "docs/marionette.view.md": "b7b5871b0b56474cc3bc2513c2e2c4fdabdafcd724bfbaa8076ea7eee40d5ab5",
-    "docs/optional-backbone.md": "f630fdcf2d6659cd4b0a7bf76c5e18ce9ae92312e35e98e312fb8afea4c1d664",
+    "docs/optional-backbone.md": "f1d47cd797e109a9a57f56e1db187b50bafd16f1ff2775f03559f9f7e59bc86c",
     "docs/radio.md": "c0013e382554aa6cd4e46ab60908f5e6cce7117c134b3f4656c37a163f8a5f4e",
     "docs/runtime-isolation.md": "e18927a5aa30558805018c9c28dffceaf02d953394efce8eaa7d35f0711de7f4",
-    "docs/typescript.md": "47ec746e0dcc04cce56f6227f0645d4c777585a2ae797f00c4683b32585922f1",
+    "docs/typescript.md": "08361d38a3b3c29dcc45097fc44d74962cee91d9d97bea9f84006c1a9639e59b",
     "docs/utils.md": "5c2d0854895bb19f613926788cf81c5849cf18af1e43ac540e860b226fa80d2a",
-    "docs/view.lifecycle.md": "2cc29e59e056174bb2fcbd2888ee508ff6fb044b86e9fcacd1025c1f4e036133",
-    "docs/view.rendering.md": "6b397b0925b00c06ff644cd549b2273ba6235e1d6148ad6fa0514394f9c92df5",
-    "packages/adapters/readme.md": "3199ad1d13ca2ea6253c6f95af1806d7b2b28680074b5488da861b2af1aaaba5",
-    "packages/data/readme.md": "ca98cee5fcb519278b47e9a12e3e8838f5e9c9c5913646c14398fc7111d6f8d6",
-    "packages/utils/readme.md": "8fe46e7f62e691e208ef87bba47ec0209302cfed15faa0d87a221f66cf666348",
+    "docs/view.lifecycle.md": "1e5f0e77d9bba799296ed40860a1d466e58cc086c36f72314cbe3c9daeedf8e3",
+    "docs/view.rendering.md": "106bd7c14f5897513a5072bed98d36e029b9be91650267f17ebcf90b03d8cb13",
+    "packages/adapters/readme.md": "d1be90d2631fcd4346b9e4648e7288e63ff28063fd7ffb860f32de25164d5d29",
+    "packages/data/readme.md": "041e330fad1a87c891844b774dd5309aae61cc7a36d76b3dcf9ec5dfcd7b8c95",
+    "packages/utils/readme.md": "2ea64109e9b65c9fb66d48c30fec86b6475aa4d8c809cc68c68a28925ed93021",
     "test/contracts/dom-adapters.js": "a3f71df6a2e52f8d4a52ebb2d3cbbc8e77e055f459daf7c071f4e5fd55ad8c3f",
-    "test/unit/application-child-lifecycle.spec.js": "fae6cd469119901a1a39e1ee9f8aa5aae55db39d50df7a3cb145e640fba8d400",
-    "test/unit/application-lifecycle.spec.js": "52adc58534d8cb079dacb9b8b5f608bd62783c14ad5b98bb8cd85dcdd757c331",
-    "test/unit/application-ownership.spec.js": "6710968792d0c52877110abc63b4622b18efc3b030d5f5f1060e4de046326095",
-    "test/unit/application-prepared-view.spec.js": "440619dba9c73570974f1531bbe8b601fcb9a27ed64b499d6c10b9e8ca955dca",
-    "test/unit/application-root-view.spec.js": "2c1c642bb872836425b942580cc6600236cf3110186b427b1f7b2fd6263ff78d",
+    "test/unit/application-child-declarations.spec.js": "3b98e033f99902a8bff5c533c03599375381da4b4a01b9014e825eb21cb80e2b",
+    "test/unit/application-child-lifecycle.spec.js": "e69e6a140e341563b49333d09bd1c483151f9f4b2a494960a4dfc78bb81f8dcb",
+    "test/unit/application-lifecycle.spec.js": "43da21063d3b03c1c16fd047735458a26a98abe003ef75e607bad0f01a473f37",
+    "test/unit/application-ownership.spec.js": "f1e6a74f639bb6ceedd85957c696a45de28e1526ed41df0f34663a23b25bb68f",
+    "test/unit/application-preparation.spec.js": "23e58351eec5983b4d412be099a7e9306f4b758a1f501874f46baca8be940b56",
+    "test/unit/application-prepared-view.spec.js": "9d97d5e8f4783d3fb9ffff19afda25d46e6c6fd5f61a89929c42d559f2a2cee4",
+    "test/unit/application-root-view.spec.js": "e497b73aa9f1c67c228008dc744ba6675cfb7a72b3279367f95cf304d76b02da",
+    "test/unit/application-start-region.spec.js": "d29546de2a4f7a56153eaeee39386b9c3f07933fb11c6c4e4d3ad0fdf60bb703",
     "test/unit/backbone-adapter.spec.js": "016907f55d5e20d695f916dbd4189ac7e3e543a0f903df6a3922c207dade59df",
     "test/unit/behavior-lifecycle.spec.js": "8c70d05fa530d27eac901291a3487c9cacac1ef1d0c22a3adda917da5774d05a",
     "test/unit/behavior-ui-contract.spec.js": "65def27b40f17e3d931803faeff7c9dbb3c580e14f157fa5d2f8145fb95c1761",
@@ -8090,7 +8144,7 @@
     "test/unit/events-parity.spec.js": "a0ec7cd3dac3636803ec6ecc6fb7161df2a74fa7d5e6d532477e12539a9bd71c",
     "test/unit/events-single-dispatch.spec.js": "9405ceb5a59c4ebddf3aeb4a902588dcf81a6bc35aca40bde0e8aa41760fb6ce",
     "test/unit/jquery-dom-api.spec.js": "4b0187d3ca5dac647394dd906fe6c6ca11764688c12ef864bc4eae867a629ded",
-    "test/unit/model-based/application.spec.js": "606f73e131faa4991ac2dc5370abc80b0f61467623705b0d929587e654cc7e35",
+    "test/unit/model-based/application.spec.js": "e40a27ede3317869f8e3a1e10563be78f1bfe768365d62bcd1fedd38322a84ed",
     "test/unit/modules-error.spec.js": "3ca32416b3329999cb3fcdd3fbc66751d722e7a2c0082195b702b64dce6284c3",
     "test/unit/object.spec.js": "ca82986738229a1af224aa3bd2b0ab88d70ca92dc556806796e5b056b19ebb3e",
     "test/unit/provider-acceptance.spec.js": "9eb8795a222745b41ba2d76ae770dfa702e2f0f1ec8e17be8402be42c6166db9",