npm - @teambit/application - Versions diffs - 1.0.310 → 1.0.312 - Mend

@teambit/application 1.0.310 → 1.0.312

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (12) hide show

package/artifacts/__bit_junit.xml +1 -1
package/artifacts/preview/teambit_harmony_application-preview.js +1 -1
package/artifacts/schema.json +540 -384
package/dist/app.cmd.js +1 -0
package/dist/app.cmd.js.map +1 -1
package/dist/application.main.runtime.d.ts +13 -0
package/dist/application.main.runtime.js +18 -0
package/dist/application.main.runtime.js.map +1 -1
package/dist/{preview-1718853656395.js → preview-1719154175406.js} +2 -2
package/dist/run.cmd.js +1 -0
package/dist/run.cmd.js.map +1 -1
package/package.json +12 -12

package/artifacts/schema.json CHANGED Viewed

@@ -88,7 +88,8 @@
                     "character": 3
                   },
                   "raw": "/**\n   * port in which app is running.\n   */",
-                  "comment": "port in which app is running."
+                  "comment": "port in which app is running.",
+                  "tags": []
                 },
                 "signature": "(property) port?: number | undefined",
                 "name": "port",
@@ -118,7 +119,8 @@
                     "character": 3
                   },
                   "raw": "/**\n   * name of the app\n   */",
-                  "comment": "name of the app"
+                  "comment": "name of the app",
+                  "tags": []
                 },
                 "signature": "(property) appName?: string | undefined",
                 "name": "appName",
@@ -148,7 +150,8 @@
                     "character": 3
                   },
                   "raw": "/**\n   * url of the running app.\n   */",
-                  "comment": "url of the running app."
+                  "comment": "url of the running app.",
+                  "tags": []
                 },
                 "signature": "(property) url?: string | undefined",
                 "name": "url",
@@ -178,7 +181,8 @@
                     "character": 3
                   },
                   "raw": "/**\n   * function for closing the server.\n   */",
-                  "comment": "function for closing the server."
+                  "comment": "function for closing the server.",
+                  "tags": []
                 },
                 "signature": "(property) stop?: (() => Promise<void>) | undefined",
                 "name": "stop",
@@ -243,7 +247,8 @@
               "character": 1
             },
             "raw": "/**\n * an instance of an application deployment.\n */",
-            "comment": "an instance of an application deployment."
+            "comment": "an instance of an application deployment.",
+            "tags": []
           },
           "signature": "type ApplicationDeployment = {\n    timestamp?: string | undefined;\n    appName?: string | undefined;\n    url?: string | undefined;\n}",
           "name": "ApplicationDeployment",
@@ -270,7 +275,8 @@
                     "character": 3
                   },
                   "raw": "/**\n   * timestamp of the deployment.\n   */",
-                  "comment": "timestamp of the deployment."
+                  "comment": "timestamp of the deployment.",
+                  "tags": []
                 },
                 "signature": "(property) timestamp?: string | undefined",
                 "name": "timestamp",
@@ -300,7 +306,8 @@
                     "character": 3
                   },
                   "raw": "/**\n   * name of the deployed app.\n   */",
-                  "comment": "name of the deployed app."
+                  "comment": "name of the deployed app.",
+                  "tags": []
                 },
                 "signature": "(property) appName?: string | undefined",
                 "name": "appName",
@@ -330,7 +337,8 @@
                     "character": 3
                   },
                   "raw": "/**\n   * url the deployed app.\n   */",
-                  "comment": "url the deployed app."
+                  "comment": "url the deployed app.",
+                  "tags": []
                 },
                 "signature": "(property) url?: string | undefined",
                 "name": "url",
@@ -678,7 +686,8 @@
                   "character": 3
                 },
                 "raw": "/**\n   * register a new app.\n   */",
-                "comment": "register a new app."
+                "comment": "register a new app.",
+                "tags": []
               },
               "signature": "(method) ApplicationMain.registerApp(app: Application): this",
               "name": "registerApp",
@@ -730,7 +739,8 @@
                   "character": 3
                 },
                 "raw": "/**\n   * list all registered apps.\n   */",
-                "comment": "list all registered apps."
+                "comment": "list all registered apps.",
+                "tags": []
               },
               "signature": "(method) ApplicationMain.listApps(): Application[]",
               "name": "listApps",
@@ -769,7 +779,8 @@
                   "character": 3
                 },
                 "raw": "/**\n   * map all apps by component ID.\n   */",
-                "comment": "map all apps by component ID."
+                "comment": "map all apps by component ID.",
+                "tags": []
               },
               "signature": "(method) ApplicationMain.mapApps(): [string, Application[]][]",
               "name": "mapApps",
@@ -789,7 +800,7 @@
               "__schema": "FunctionLikeSchema",
               "location": {
                 "filePath": "application.main.runtime.ts",
-                "line": 118,
+                "line": 119,
                 "character": 3
               },
               "doc": {
@@ -799,8 +810,43 @@
                   "line": 115,
                   "character": 3
                 },
-                "raw": "/**\n   * list apps by a component id.\n   */",
-                "comment": "list apps by a component id."
+                "raw": "/**\n   * instead of adding apps to workspace.jsonc, this method gets all apps components and load them as aspects so then\n   * they could register to the apps slots and be available to list/run etc.\n   */",
+                "comment": "instead of adding apps to workspace.jsonc, this method gets all apps components and load them as aspects so then\nthey could register to the apps slots and be available to list/run etc.",
+                "tags": []
+              },
+              "signature": "(method) ApplicationMain.loadAllAppsAsAspects(): Promise<void>",
+              "name": "loadAllAppsAsAspects",
+              "params": [],
+              "returnType": {
+                "__schema": "InferenceTypeSchema",
+                "location": {
+                  "filePath": "application.main.runtime.ts",
+                  "line": 119,
+                  "character": 3
+                },
+                "type": "Promise<void>"
+              },
+              "modifiers": [
+                "async"
+              ]
+            },
+            {
+              "__schema": "FunctionLikeSchema",
+              "location": {
+                "filePath": "application.main.runtime.ts",
+                "line": 128,
+                "character": 3
+              },
+              "doc": {
+                "__schema": "DocSchema",
+                "location": {
+                  "filePath": "application.main.runtime.ts",
+                  "line": 124,
+                  "character": 3
+                },
+                "raw": "/**\n   * list apps by a component id.\n   * make sure to call `this.loadAllAppsAsAspects` before calling this method in case the app is not listed in workspace.jsonc\n   */",
+                "comment": "list apps by a component id.\nmake sure to call `this.loadAllAppsAsAspects` before calling this method in case the app is not listed in workspace.jsonc",
+                "tags": []
               },
               "signature": "(method) ApplicationMain.listAppsById(id?: ComponentID): Application[] | undefined",
               "name": "listAppsById",
@@ -809,7 +855,7 @@
                   "__schema": "ParameterSchema",
                   "location": {
                     "filePath": "application.main.runtime.ts",
-                    "line": 118,
+                    "line": 128,
                     "character": 16
                   },
                   "name": "id",
@@ -817,7 +863,7 @@
                     "__schema": "TypeRefSchema",
                     "location": {
                       "filePath": "application.main.runtime.ts",
-                      "line": 118,
+                      "line": 128,
                       "character": 21
                     },
                     "name": "ComponentID",
@@ -834,7 +880,7 @@
                 "__schema": "TypeUnionSchema",
                 "location": {
                   "filePath": "application.main.runtime.ts",
-                  "line": 118,
+                  "line": 128,
                   "character": 35
                 },
                 "types": [
@@ -842,14 +888,14 @@
                     "__schema": "TypeArraySchema",
                     "location": {
                       "filePath": "application.main.runtime.ts",
-                      "line": 118,
+                      "line": 128,
                       "character": 35
                     },
                     "type": {
                       "__schema": "TypeRefSchema",
                       "location": {
                         "filePath": "application.main.runtime.ts",
-                        "line": 118,
+                        "line": 128,
                         "character": 35
                       },
                       "name": "Application"
@@ -859,7 +905,7 @@
                     "__schema": "KeywordTypeSchema",
                     "location": {
                       "filePath": "application.main.runtime.ts",
-                      "line": 118,
+                      "line": 128,
                       "character": 51
                     },
                     "name": "undefined"
@@ -872,18 +918,19 @@
               "__schema": "FunctionLikeSchema",
               "location": {
                 "filePath": "application.main.runtime.ts",
-                "line": 126,
+                "line": 137,
                 "character": 3
               },
               "doc": {
                 "__schema": "DocSchema",
                 "location": {
                   "filePath": "application.main.runtime.ts",
-                  "line": 123,
+                  "line": 133,
                   "character": 3
                 },
-                "raw": "/**\n   * get an application by a component id.\n   */",
-                "comment": "get an application by a component id."
+                "raw": "/**\n   * get an application by a component id.\n   * make sure to call `this.loadAllAppsAsAspects` before calling this method in case the app is not listed in workspace.jsonc\n   */",
+                "comment": "get an application by a component id.\nmake sure to call `this.loadAllAppsAsAspects` before calling this method in case the app is not listed in workspace.jsonc",
+                "tags": []
               },
               "signature": "(method) ApplicationMain.getAppById(id: ComponentID): Promise<Application | undefined>",
               "name": "getAppById",
@@ -892,7 +939,7 @@
                   "__schema": "ParameterSchema",
                   "location": {
                     "filePath": "application.main.runtime.ts",
-                    "line": 126,
+                    "line": 137,
                     "character": 20
                   },
                   "name": "id",
@@ -900,7 +947,7 @@
                     "__schema": "TypeRefSchema",
                     "location": {
                       "filePath": "application.main.runtime.ts",
-                      "line": 126,
+                      "line": 137,
                       "character": 24
                     },
                     "name": "ComponentID",
@@ -917,7 +964,7 @@
                 "__schema": "InferenceTypeSchema",
                 "location": {
                   "filePath": "application.main.runtime.ts",
-                  "line": 126,
+                  "line": 137,
                   "character": 3
                 },
                 "type": "Promise<Application | undefined>"
@@ -930,18 +977,19 @@
               "__schema": "FunctionLikeSchema",
               "location": {
                 "filePath": "application.main.runtime.ts",
-                "line": 136,
+                "line": 147,
                 "character": 3
               },
               "doc": {
                 "__schema": "DocSchema",
                 "location": {
                   "filePath": "application.main.runtime.ts",
-                  "line": 132,
+                  "line": 143,
                   "character": 3
                 },
                 "raw": "/**\n   * calculate an application by a component.\n   * This should be only used during the on component load slot\n   */",
-                "comment": "calculate an application by a component.\nThis should be only used during the on component load slot"
+                "comment": "calculate an application by a component.\nThis should be only used during the on component load slot",
+                "tags": []
               },
               "signature": "(method) ApplicationMain.calculateAppByComponent(component: Component): Application | undefined",
               "name": "calculateAppByComponent",
@@ -950,7 +998,7 @@
                   "__schema": "ParameterSchema",
                   "location": {
                     "filePath": "application.main.runtime.ts",
-                    "line": 136,
+                    "line": 147,
                     "character": 27
                   },
                   "name": "component",
@@ -958,7 +1006,7 @@
                     "__schema": "TypeRefSchema",
                     "location": {
                       "filePath": "application.main.runtime.ts",
-                      "line": 136,
+                      "line": 147,
                       "character": 38
                     },
                     "name": "Component",
@@ -975,7 +1023,7 @@
                 "__schema": "TypeRefSchema",
                 "location": {
                   "filePath": "application.main.runtime.ts",
-                  "line": 136,
+                  "line": 147,
                   "character": 3
                 },
                 "name": "Application"
@@ -986,7 +1034,7 @@
               "__schema": "FunctionLikeSchema",
               "location": {
                 "filePath": "application.main.runtime.ts",
-                "line": 142,
+                "line": 153,
                 "character": 3
               },
               "signature": "(method) ApplicationMain.listAppTypes(): ApplicationType<unknown>[]",
@@ -996,7 +1044,7 @@
                 "__schema": "TypeRefSchema",
                 "location": {
                   "filePath": "application.main.runtime.ts",
-                  "line": 142,
+                  "line": 153,
                   "character": 3
                 },
                 "name": "ApplicationType"
@@ -1007,23 +1055,24 @@
               "__schema": "FunctionLikeSchema",
               "location": {
                 "filePath": "application.main.runtime.ts",
-                "line": 150,
+                "line": 161,
                 "character": 3
               },
               "doc": {
                 "__schema": "DocSchema",
                 "location": {
                   "filePath": "application.main.runtime.ts",
-                  "line": 146,
+                  "line": 157,
                   "character": 3
                 },
                 "raw": "/**\n   * @deprecated use `listAppsComponents` instead.\n   * @returns\n   */",
+                "comment": "",
                 "tags": [
                   {
                     "__schema": "TagSchema",
                     "location": {
                       "filePath": "application.main.runtime.ts",
-                      "line": 147,
+                      "line": 158,
                       "character": 6
                     },
                     "tagName": "deprecated",
@@ -1033,7 +1082,7 @@
                     "__schema": "ReturnTagSchema",
                     "location": {
                       "filePath": "application.main.runtime.ts",
-                      "line": 148,
+                      "line": 159,
                       "character": 6
                     },
                     "tagName": "return"
@@ -1047,7 +1096,7 @@
                 "__schema": "TypeRefSchema",
                 "location": {
                   "filePath": "application.main.runtime.ts",
-                  "line": 150,
+                  "line": 161,
                   "character": 35
                 },
                 "name": "Promise",
@@ -1056,14 +1105,14 @@
                     "__schema": "TypeArraySchema",
                     "location": {
                       "filePath": "application.main.runtime.ts",
-                      "line": 150,
+                      "line": 161,
                       "character": 43
                     },
                     "type": {
                       "__schema": "TypeRefSchema",
                       "location": {
                         "filePath": "application.main.runtime.ts",
-                        "line": 150,
+                        "line": 161,
                         "character": 43
                       },
                       "name": "Component",
@@ -1083,7 +1132,7 @@
               "__schema": "FunctionLikeSchema",
               "location": {
                 "filePath": "application.main.runtime.ts",
-                "line": 154,
+                "line": 165,
                 "character": 3
               },
               "signature": "(method) ApplicationMain.listAppsComponents(): Promise<Component[]>",
@@ -1093,7 +1142,7 @@
                 "__schema": "TypeRefSchema",
                 "location": {
                   "filePath": "application.main.runtime.ts",
-                  "line": 154,
+                  "line": 165,
                   "character": 31
                 },
                 "name": "Promise",
@@ -1102,14 +1151,14 @@
                     "__schema": "TypeArraySchema",
                     "location": {
                       "filePath": "application.main.runtime.ts",
-                      "line": 154,
+                      "line": 165,
                       "character": 39
                     },
                     "type": {
                       "__schema": "TypeRefSchema",
                       "location": {
                         "filePath": "application.main.runtime.ts",
-                        "line": 154,
+                        "line": 165,
                         "character": 39
                       },
                       "name": "Component",
@@ -1129,7 +1178,7 @@
               "__schema": "FunctionLikeSchema",
               "location": {
                 "filePath": "application.main.runtime.ts",
-                "line": 168,
+                "line": 179,
                 "character": 3
               },
               "signature": "(method) ApplicationMain.getAppPatterns(): string[]",
@@ -1139,7 +1188,7 @@
                 "__schema": "InferenceTypeSchema",
                 "location": {
                   "filePath": "application.main.runtime.ts",
-                  "line": 168,
+                  "line": 179,
                   "character": 3
                 },
                 "type": "string[]"
@@ -1150,7 +1199,7 @@
               "__schema": "FunctionLikeSchema",
               "location": {
                 "filePath": "application.main.runtime.ts",
-                "line": 177,
+                "line": 188,
                 "character": 3
               },
               "signature": "(method) ApplicationMain.loadApps(): Promise<Application[]>",
@@ -1160,7 +1209,7 @@
                 "__schema": "TypeRefSchema",
                 "location": {
                   "filePath": "application.main.runtime.ts",
-                  "line": 177,
+                  "line": 188,
                   "character": 21
                 },
                 "name": "Promise",
@@ -1169,14 +1218,14 @@
                     "__schema": "TypeArraySchema",
                     "location": {
                       "filePath": "application.main.runtime.ts",
-                      "line": 177,
+                      "line": 188,
                       "character": 29
                     },
                     "type": {
                       "__schema": "TypeRefSchema",
                       "location": {
                         "filePath": "application.main.runtime.ts",
-                        "line": 177,
+                        "line": 188,
                         "character": 29
                       },
                       "name": "Application"
@@ -1192,7 +1241,7 @@
               "__schema": "FunctionLikeSchema",
               "location": {
                 "filePath": "application.main.runtime.ts",
-                "line": 210,
+                "line": 221,
                 "character": 3
               },
               "signature": "(method) ApplicationMain.loadAppsFromComponent(component: Component, rootDir: string): Promise<Application[] | undefined>",
@@ -1202,7 +1251,7 @@
                   "__schema": "ParameterSchema",
                   "location": {
                     "filePath": "application.main.runtime.ts",
-                    "line": 210,
+                    "line": 221,
                     "character": 31
                   },
                   "name": "component",
@@ -1210,7 +1259,7 @@
                     "__schema": "TypeRefSchema",
                     "location": {
                       "filePath": "application.main.runtime.ts",
-                      "line": 210,
+                      "line": 221,
                       "character": 42
                     },
                     "name": "Component",
@@ -1226,7 +1275,7 @@
                   "__schema": "ParameterSchema",
                   "location": {
                     "filePath": "application.main.runtime.ts",
-                    "line": 210,
+                    "line": 221,
                     "character": 53
                   },
                   "name": "rootDir",
@@ -1234,7 +1283,7 @@
                     "__schema": "KeywordTypeSchema",
                     "location": {
                       "filePath": "application.main.runtime.ts",
-                      "line": 210,
+                      "line": 221,
                       "character": 62
                     },
                     "name": "string"
@@ -1247,7 +1296,7 @@
                 "__schema": "TypeRefSchema",
                 "location": {
                   "filePath": "application.main.runtime.ts",
-                  "line": 210,
+                  "line": 221,
                   "character": 71
                 },
                 "name": "Promise",
@@ -1256,7 +1305,7 @@
                     "__schema": "TypeUnionSchema",
                     "location": {
                       "filePath": "application.main.runtime.ts",
-                      "line": 210,
+                      "line": 221,
                       "character": 79
                     },
                     "types": [
@@ -1264,14 +1313,14 @@
                         "__schema": "TypeArraySchema",
                         "location": {
                           "filePath": "application.main.runtime.ts",
-                          "line": 210,
+                          "line": 221,
                           "character": 79
                         },
                         "type": {
                           "__schema": "TypeRefSchema",
                           "location": {
                             "filePath": "application.main.runtime.ts",
-                            "line": 210,
+                            "line": 221,
                             "character": 79
                           },
                           "name": "Application"
@@ -1281,7 +1330,7 @@
                         "__schema": "KeywordTypeSchema",
                         "location": {
                           "filePath": "application.main.runtime.ts",
-                          "line": 210,
+                          "line": 221,
                           "character": 95
                         },
                         "name": "undefined"
@@ -1298,18 +1347,19 @@
               "__schema": "FunctionLikeSchema",
               "location": {
                 "filePath": "application.main.runtime.ts",
-                "line": 236,
+                "line": 248,
                 "character": 3
               },
               "doc": {
                 "__schema": "DocSchema",
                 "location": {
                   "filePath": "application.main.runtime.ts",
-                  "line": 233,
+                  "line": 244,
                   "character": 3
                 },
-                "raw": "/**\n   * get an app.\n   */",
-                "comment": "get an app."
+                "raw": "/**\n   * get an app.\n   * make sure to call `this.loadAllAppsAsAspects` before calling this method in case the app is not listed in workspace.jsonc\n   */",
+                "comment": "get an app.\nmake sure to call `this.loadAllAppsAsAspects` before calling this method in case the app is not listed in workspace.jsonc",
+                "tags": []
               },
               "signature": "(method) ApplicationMain.getApp(appName: string, id?: ComponentID): Application | undefined",
               "name": "getApp",
@@ -1318,7 +1368,7 @@
                   "__schema": "ParameterSchema",
                   "location": {
                     "filePath": "application.main.runtime.ts",
-                    "line": 236,
+                    "line": 248,
                     "character": 10
                   },
                   "name": "appName",
@@ -1326,7 +1376,7 @@
                     "__schema": "KeywordTypeSchema",
                     "location": {
                       "filePath": "application.main.runtime.ts",
-                      "line": 236,
+                      "line": 248,
                       "character": 19
                     },
                     "name": "string"
@@ -1338,7 +1388,7 @@
                   "__schema": "ParameterSchema",
                   "location": {
                     "filePath": "application.main.runtime.ts",
-                    "line": 236,
+                    "line": 248,
                     "character": 27
                   },
                   "name": "id",
@@ -1346,7 +1396,7 @@
                     "__schema": "TypeRefSchema",
                     "location": {
                       "filePath": "application.main.runtime.ts",
-                      "line": 236,
+                      "line": 248,
                       "character": 32
                     },
                     "name": "ComponentID",
@@ -1363,7 +1413,7 @@
                 "__schema": "TypeUnionSchema",
                 "location": {
                   "filePath": "application.main.runtime.ts",
-                  "line": 236,
+                  "line": 248,
                   "character": 46
                 },
                 "types": [
@@ -1371,7 +1421,7 @@
                     "__schema": "TypeRefSchema",
                     "location": {
                       "filePath": "application.main.runtime.ts",
-                      "line": 236,
+                      "line": 248,
                       "character": 46
                     },
                     "name": "Application"
@@ -1380,7 +1430,7 @@
                     "__schema": "KeywordTypeSchema",
                     "location": {
                       "filePath": "application.main.runtime.ts",
-                      "line": 236,
+                      "line": 248,
                       "character": 60
                     },
                     "name": "undefined"
@@ -1393,7 +1443,7 @@
               "__schema": "FunctionLikeSchema",
               "location": {
                 "filePath": "application.main.runtime.ts",
-                "line": 242,
+                "line": 254,
                 "character": 3
               },
               "signature": "(method) ApplicationMain.getAppByNameOrId(appNameOrId: string): Application | undefined",
@@ -1403,7 +1453,7 @@
                   "__schema": "ParameterSchema",
                   "location": {
                     "filePath": "application.main.runtime.ts",
-                    "line": 242,
+                    "line": 254,
                     "character": 20
                   },
                   "name": "appNameOrId",
@@ -1411,7 +1461,7 @@
                     "__schema": "KeywordTypeSchema",
                     "location": {
                       "filePath": "application.main.runtime.ts",
-                      "line": 242,
+                      "line": 254,
                       "character": 33
                     },
                     "name": "string"
@@ -1424,7 +1474,7 @@
                 "__schema": "TypeUnionSchema",
                 "location": {
                   "filePath": "application.main.runtime.ts",
-                  "line": 242,
+                  "line": 254,
                   "character": 42
                 },
                 "types": [
@@ -1432,7 +1482,7 @@
                     "__schema": "TypeRefSchema",
                     "location": {
                       "filePath": "application.main.runtime.ts",
-                      "line": 242,
+                      "line": 254,
                       "character": 42
                     },
                     "name": "Application"
@@ -1441,7 +1491,7 @@
                     "__schema": "KeywordTypeSchema",
                     "location": {
                       "filePath": "application.main.runtime.ts",
-                      "line": 242,
+                      "line": 254,
                       "character": 56
                     },
                     "name": "undefined"
@@ -1454,7 +1504,7 @@
               "__schema": "FunctionLikeSchema",
               "location": {
                 "filePath": "application.main.runtime.ts",
-                "line": 255,
+                "line": 267,
                 "character": 3
               },
               "signature": "(method) ApplicationMain.getAppPattern(appType: ApplicationType<unknown>): string",
@@ -1464,7 +1514,7 @@
                   "__schema": "ParameterSchema",
                   "location": {
                     "filePath": "application.main.runtime.ts",
-                    "line": 255,
+                    "line": 267,
                     "character": 17
                   },
                   "name": "appType",
@@ -1472,7 +1522,7 @@
                     "__schema": "TypeRefSchema",
                     "location": {
                       "filePath": "application.main.runtime.ts",
-                      "line": 255,
+                      "line": 267,
                       "character": 26
                     },
                     "name": "ApplicationType",
@@ -1481,7 +1531,7 @@
                         "__schema": "KeywordTypeSchema",
                         "location": {
                           "filePath": "application.main.runtime.ts",
-                          "line": 255,
+                          "line": 267,
                           "character": 42
                         },
                         "name": "unknown"
@@ -1496,7 +1546,7 @@
                 "__schema": "InferenceTypeSchema",
                 "location": {
                   "filePath": "application.main.runtime.ts",
-                  "line": 255,
+                  "line": 267,
                   "character": 3
                 },
                 "type": "string"
@@ -1507,18 +1557,19 @@
               "__schema": "FunctionLikeSchema",
               "location": {
                 "filePath": "application.main.runtime.ts",
-                "line": 263,
+                "line": 275,
                 "character": 3
               },
               "doc": {
                 "__schema": "DocSchema",
                 "location": {
                   "filePath": "application.main.runtime.ts",
-                  "line": 260,
+                  "line": 272,
                   "character": 3
                 },
                 "raw": "/**\n   * registers a new app and sets a plugin for it.\n   */",
-                "comment": "registers a new app and sets a plugin for it."
+                "comment": "registers a new app and sets a plugin for it.",
+                "tags": []
               },
               "signature": "(method) ApplicationMain.registerAppType<T>(...appTypes: Array<ApplicationType<T>>): this",
               "name": "registerAppType",
@@ -1527,7 +1578,7 @@
                   "__schema": "ParameterSchema",
                   "location": {
                     "filePath": "application.main.runtime.ts",
-                    "line": 263,
+                    "line": 275,
                     "character": 22
                   },
                   "name": "appTypes",
@@ -1535,7 +1586,7 @@
                     "__schema": "TypeRefSchema",
                     "location": {
                       "filePath": "application.main.runtime.ts",
-                      "line": 263,
+                      "line": 275,
                       "character": 35
                     },
                     "name": "Array",
@@ -1544,7 +1595,7 @@
                         "__schema": "TypeRefSchema",
                         "location": {
                           "filePath": "application.main.runtime.ts",
-                          "line": 263,
+                          "line": 275,
                           "character": 41
                         },
                         "name": "ApplicationType",
@@ -1553,7 +1604,7 @@
                             "__schema": "TypeRefSchema",
                             "location": {
                               "filePath": "application.main.runtime.ts",
-                              "line": 263,
+                              "line": 275,
                               "character": 57
                             },
                             "name": "T"
@@ -1570,7 +1621,7 @@
                 "__schema": "TypeRefSchema",
                 "location": {
                   "filePath": "application.main.runtime.ts",
-                  "line": 263,
+                  "line": 275,
                   "character": 3
                 },
                 "name": "ApplicationMain"
@@ -1584,18 +1635,19 @@
               "__schema": "FunctionLikeSchema",
               "location": {
                 "filePath": "application.main.runtime.ts",
-                "line": 276,
+                "line": 288,
                 "character": 3
               },
               "doc": {
                 "__schema": "DocSchema",
                 "location": {
                   "filePath": "application.main.runtime.ts",
-                  "line": 273,
+                  "line": 285,
                   "character": 3
                 },
                 "raw": "/**\n   * get an app AspectId.\n   */",
-                "comment": "get an app AspectId."
+                "comment": "get an app AspectId.",
+                "tags": []
               },
               "signature": "(method) ApplicationMain.getAppAspect(appName: string): string | undefined",
               "name": "getAppAspect",
@@ -1604,7 +1656,7 @@
                   "__schema": "ParameterSchema",
                   "location": {
                     "filePath": "application.main.runtime.ts",
-                    "line": 276,
+                    "line": 288,
                     "character": 16
                   },
                   "name": "appName",
@@ -1612,7 +1664,7 @@
                     "__schema": "KeywordTypeSchema",
                     "location": {
                       "filePath": "application.main.runtime.ts",
-                      "line": 276,
+                      "line": 288,
                       "character": 25
                     },
                     "name": "string"
@@ -1625,7 +1677,7 @@
                 "__schema": "TypeUnionSchema",
                 "location": {
                   "filePath": "application.main.runtime.ts",
-                  "line": 276,
+                  "line": 288,
                   "character": 34
                 },
                 "types": [
@@ -1633,7 +1685,7 @@
                     "__schema": "KeywordTypeSchema",
                     "location": {
                       "filePath": "application.main.runtime.ts",
-                      "line": 276,
+                      "line": 288,
                       "character": 34
                     },
                     "name": "string"
@@ -1642,7 +1694,7 @@
                     "__schema": "KeywordTypeSchema",
                     "location": {
                       "filePath": "application.main.runtime.ts",
-                      "line": 276,
+                      "line": 288,
                       "character": 43
                     },
                     "name": "undefined"
@@ -1655,18 +1707,19 @@
               "__schema": "FunctionLikeSchema",
               "location": {
                 "filePath": "application.main.runtime.ts",
-                "line": 283,
+                "line": 296,
                 "character": 3
               },
               "doc": {
                 "__schema": "DocSchema",
                 "location": {
                   "filePath": "application.main.runtime.ts",
-                  "line": 280,
+                  "line": 292,
                   "character": 3
                 },
-                "raw": "/**\n   * get app to throw.\n   */",
-                "comment": "get app to throw."
+                "raw": "/**\n   * get app to throw.\n   * make sure to call `this.loadAllAppsAsAspects` before calling this method in case the app is not listed in workspace.jsonc\n   */",
+                "comment": "get app to throw.\nmake sure to call `this.loadAllAppsAsAspects` before calling this method in case the app is not listed in workspace.jsonc",
+                "tags": []
               },
               "signature": "(method) ApplicationMain.getAppOrThrow(appName: string): Application",
               "name": "getAppOrThrow",
@@ -1675,7 +1728,7 @@
                   "__schema": "ParameterSchema",
                   "location": {
                     "filePath": "application.main.runtime.ts",
-                    "line": 283,
+                    "line": 296,
                     "character": 17
                   },
                   "name": "appName",
@@ -1683,7 +1736,7 @@
                     "__schema": "KeywordTypeSchema",
                     "location": {
                       "filePath": "application.main.runtime.ts",
-                      "line": 283,
+                      "line": 296,
                       "character": 26
                     },
                     "name": "string"
@@ -1696,7 +1749,7 @@
                 "__schema": "TypeRefSchema",
                 "location": {
                   "filePath": "application.main.runtime.ts",
-                  "line": 283,
+                  "line": 296,
                   "character": 3
                 },
                 "name": "Application"
@@ -1707,7 +1760,7 @@
               "__schema": "VariableLikeSchema",
               "location": {
                 "filePath": "application.main.runtime.ts",
-                "line": 289,
+                "line": 302,
                 "character": 3
               },
               "signature": "(property) ApplicationMain.defaultOpts: ServeAppOptions",
@@ -1716,7 +1769,7 @@
                 "__schema": "TypeRefSchema",
                 "location": {
                   "filePath": "application.main.runtime.ts",
-                  "line": 289,
+                  "line": 302,
                   "character": 3
                 },
                 "name": "ServeAppOptions",
@@ -1729,7 +1782,7 @@
               "__schema": "FunctionLikeSchema",
               "location": {
                 "filePath": "application.main.runtime.ts",
-                "line": 302,
+                "line": 315,
                 "character": 3
               },
               "signature": "(method) ApplicationMain.loadAppsToSlot(): Promise<this>",
@@ -1739,7 +1792,7 @@
                 "__schema": "InferenceTypeSchema",
                 "location": {
                   "filePath": "application.main.runtime.ts",
-                  "line": 302,
+                  "line": 315,
                   "character": 3
                 },
                 "type": "Promise<this>"
@@ -1752,9 +1805,20 @@
               "__schema": "FunctionLikeSchema",
               "location": {
                 "filePath": "application.main.runtime.ts",
-                "line": 308,
+                "line": 325,
                 "character": 3
               },
+              "doc": {
+                "__schema": "DocSchema",
+                "location": {
+                  "filePath": "application.main.runtime.ts",
+                  "line": 321,
+                  "character": 3
+                },
+                "raw": "/**\n   * run an app.\n   * make sure to call `this.loadAllAppsAsAspects` before calling this method in case the app is not listed in workspace.jsonc\n   */",
+                "comment": "run an app.\nmake sure to call `this.loadAllAppsAsAspects` before calling this method in case the app is not listed in workspace.jsonc",
+                "tags": []
+              },
               "signature": "(method) ApplicationMain.runApp(appName: string, options?: ServeAppOptions): Promise<{\n    app: Application;\n    port: number | undefined;\n    errors?: Error[] | undefined;\n    isOldApi: boolean;\n}>",
               "name": "runApp",
               "params": [
@@ -1762,7 +1826,7 @@
                   "__schema": "ParameterSchema",
                   "location": {
                     "filePath": "application.main.runtime.ts",
-                    "line": 309,
+                    "line": 326,
                     "character": 5
                   },
                   "name": "appName",
@@ -1770,7 +1834,7 @@
                     "__schema": "KeywordTypeSchema",
                     "location": {
                       "filePath": "application.main.runtime.ts",
-                      "line": 309,
+                      "line": 326,
                       "character": 14
                     },
                     "name": "string"
@@ -1782,7 +1846,7 @@
                   "__schema": "ParameterSchema",
                   "location": {
                     "filePath": "application.main.runtime.ts",
-                    "line": 310,
+                    "line": 327,
                     "character": 5
                   },
                   "name": "options",
@@ -1790,7 +1854,7 @@
                     "__schema": "TypeRefSchema",
                     "location": {
                       "filePath": "application.main.runtime.ts",
-                      "line": 310,
+                      "line": 327,
                       "character": 15
                     },
                     "name": "ServeAppOptions",
@@ -1804,7 +1868,7 @@
                 "__schema": "TypeRefSchema",
                 "location": {
                   "filePath": "application.main.runtime.ts",
-                  "line": 311,
+                  "line": 328,
                   "character": 6
                 },
                 "name": "Promise",
@@ -1813,7 +1877,7 @@
                     "__schema": "TypeLiteralSchema",
                     "location": {
                       "filePath": "application.main.runtime.ts",
-                      "line": 311,
+                      "line": 328,
                       "character": 14
                     },
                     "members": [
@@ -1821,7 +1885,7 @@
                         "__schema": "VariableLikeSchema",
                         "location": {
                           "filePath": "application.main.runtime.ts",
-                          "line": 312,
+                          "line": 329,
                           "character": 5
                         },
                         "signature": "(property) app: Application",
@@ -1830,7 +1894,7 @@
                           "__schema": "TypeRefSchema",
                           "location": {
                             "filePath": "application.main.runtime.ts",
-                            "line": 312,
+                            "line": 329,
                             "character": 5
                           },
                           "name": "Application"
@@ -1841,7 +1905,7 @@
                         "__schema": "VariableLikeSchema",
                         "location": {
                           "filePath": "application.main.runtime.ts",
-                          "line": 313,
+                          "line": 330,
                           "character": 5
                         },
                         "signature": "(property) port: number | undefined",
@@ -1850,7 +1914,7 @@
                           "__schema": "TypeUnionSchema",
                           "location": {
                             "filePath": "application.main.runtime.ts",
-                            "line": 313,
+                            "line": 330,
                             "character": 11
                           },
                           "types": [
@@ -1858,7 +1922,7 @@
                               "__schema": "KeywordTypeSchema",
                               "location": {
                                 "filePath": "application.main.runtime.ts",
-                                "line": 313,
+                                "line": 330,
                                 "character": 11
                               },
                               "name": "number"
@@ -1867,7 +1931,7 @@
                               "__schema": "KeywordTypeSchema",
                               "location": {
                                 "filePath": "application.main.runtime.ts",
-                                "line": 313,
+                                "line": 330,
                                 "character": 20
                               },
                               "name": "undefined"
@@ -1880,7 +1944,7 @@
                         "__schema": "VariableLikeSchema",
                         "location": {
                           "filePath": "application.main.runtime.ts",
-                          "line": 314,
+                          "line": 331,
                           "character": 5
                         },
                         "signature": "(property) errors?: Error[] | undefined",
@@ -1889,14 +1953,14 @@
                           "__schema": "TypeArraySchema",
                           "location": {
                             "filePath": "application.main.runtime.ts",
-                            "line": 314,
+                            "line": 331,
                             "character": 14
                           },
                           "type": {
                             "__schema": "TypeRefSchema",
                             "location": {
                               "filePath": "application.main.runtime.ts",
-                              "line": 314,
+                              "line": 331,
                               "character": 14
                             },
                             "name": "Error"
@@ -1908,7 +1972,7 @@
                         "__schema": "VariableLikeSchema",
                         "location": {
                           "filePath": "application.main.runtime.ts",
-                          "line": 315,
+                          "line": 332,
                           "character": 5
                         },
                         "signature": "(property) isOldApi: boolean",
@@ -1917,7 +1981,7 @@
                           "__schema": "KeywordTypeSchema",
                           "location": {
                             "filePath": "application.main.runtime.ts",
-                            "line": 315,
+                            "line": 332,
                             "character": 15
                           },
                           "name": "boolean"
@@ -1936,18 +2000,19 @@
               "__schema": "FunctionLikeSchema",
               "location": {
                 "filePath": "application.main.runtime.ts",
-                "line": 344,
+                "line": 361,
                 "character": 3
               },
               "doc": {
                 "__schema": "DocSchema",
                 "location": {
                   "filePath": "application.main.runtime.ts",
-                  "line": 341,
+                  "line": 358,
                   "character": 3
                 },
                 "raw": "/**\n   * get the component ID of a certain app.\n   */",
-                "comment": "get the component ID of a certain app."
+                "comment": "get the component ID of a certain app.",
+                "tags": []
               },
               "signature": "(method) ApplicationMain.getAppIdOrThrow(appName: string): Promise<ComponentID>",
               "name": "getAppIdOrThrow",
@@ -1956,7 +2021,7 @@
                   "__schema": "ParameterSchema",
                   "location": {
                     "filePath": "application.main.runtime.ts",
-                    "line": 344,
+                    "line": 361,
                     "character": 25
                   },
                   "name": "appName",
@@ -1964,7 +2029,7 @@
                     "__schema": "KeywordTypeSchema",
                     "location": {
                       "filePath": "application.main.runtime.ts",
-                      "line": 344,
+                      "line": 361,
                       "character": 34
                     },
                     "name": "string"
@@ -1977,7 +2042,7 @@
                 "__schema": "InferenceTypeSchema",
                 "location": {
                   "filePath": "application.main.runtime.ts",
-                  "line": 344,
+                  "line": 361,
                   "character": 3
                 },
                 "type": "Promise<ComponentID>"
@@ -1990,7 +2055,7 @@
               "__schema": "FunctionLikeSchema",
               "location": {
                 "filePath": "application.main.runtime.ts",
-                "line": 384,
+                "line": 401,
                 "character": 3
               },
               "signature": "(method) ApplicationMain.createAppBuildContext(id: ComponentID, appName: string, capsuleRootDir: string, rootDir?: string): Promise<AppContext>",
@@ -2000,7 +2065,7 @@
                   "__schema": "ParameterSchema",
                   "location": {
                     "filePath": "application.main.runtime.ts",
-                    "line": 384,
+                    "line": 401,
                     "character": 31
                   },
                   "name": "id",
@@ -2008,7 +2073,7 @@
                     "__schema": "TypeRefSchema",
                     "location": {
                       "filePath": "application.main.runtime.ts",
-                      "line": 384,
+                      "line": 401,
                       "character": 35
                     },
                     "name": "ComponentID",
@@ -2024,7 +2089,7 @@
                   "__schema": "ParameterSchema",
                   "location": {
                     "filePath": "application.main.runtime.ts",
-                    "line": 384,
+                    "line": 401,
                     "character": 48
                   },
                   "name": "appName",
@@ -2032,7 +2097,7 @@
                     "__schema": "KeywordTypeSchema",
                     "location": {
                       "filePath": "application.main.runtime.ts",
-                      "line": 384,
+                      "line": 401,
                       "character": 57
                     },
                     "name": "string"
@@ -2044,7 +2109,7 @@
                   "__schema": "ParameterSchema",
                   "location": {
                     "filePath": "application.main.runtime.ts",
-                    "line": 384,
+                    "line": 401,
                     "character": 65
                   },
                   "name": "capsuleRootDir",
@@ -2052,7 +2117,7 @@
                     "__schema": "KeywordTypeSchema",
                     "location": {
                       "filePath": "application.main.runtime.ts",
-                      "line": 384,
+                      "line": 401,
                       "character": 81
                     },
                     "name": "string"
@@ -2064,7 +2129,7 @@
                   "__schema": "ParameterSchema",
                   "location": {
                     "filePath": "application.main.runtime.ts",
-                    "line": 384,
+                    "line": 401,
                     "character": 89
                   },
                   "name": "rootDir",
@@ -2072,7 +2137,7 @@
                     "__schema": "KeywordTypeSchema",
                     "location": {
                       "filePath": "application.main.runtime.ts",
-                      "line": 384,
+                      "line": 401,
                       "character": 99
                     },
                     "name": "string"
@@ -2085,7 +2150,7 @@
                 "__schema": "InferenceTypeSchema",
                 "location": {
                   "filePath": "application.main.runtime.ts",
-                  "line": 384,
+                  "line": 401,
                   "character": 3
                 },
                 "type": "Promise<AppContext>"
@@ -2098,7 +2163,7 @@
               "__schema": "VariableLikeSchema",
               "location": {
                 "filePath": "application.main.runtime.ts",
-                "line": 410,
+                "line": 427,
                 "character": 3
               },
               "signature": "(property) ApplicationMain.runtime: RuntimeDefinition",
@@ -2107,7 +2172,7 @@
                 "__schema": "InferenceTypeSchema",
                 "location": {
                   "filePath": "application.main.runtime.ts",
-                  "line": 410,
+                  "line": 427,
                   "character": 3
                 },
                 "type": "RuntimeDefinition"
@@ -2119,7 +2184,7 @@
               "__schema": "VariableLikeSchema",
               "location": {
                 "filePath": "application.main.runtime.ts",
-                "line": 411,
+                "line": 428,
                 "character": 3
               },
               "signature": "(property) ApplicationMain.dependencies: Aspect[]",
@@ -2128,7 +2193,7 @@
                 "__schema": "InferenceTypeSchema",
                 "location": {
                   "filePath": "application.main.runtime.ts",
-                  "line": 411,
+                  "line": 428,
                   "character": 3
                 },
                 "type": "Aspect[]"
@@ -2140,7 +2205,7 @@
               "__schema": "VariableLikeSchema",
               "location": {
                 "filePath": "application.main.runtime.ts",
-                "line": 423,
+                "line": 440,
                 "character": 3
               },
               "signature": "(property) ApplicationMain.slots: (((registerFn: () => string) => SlotRegistry<ApplicationType<unknown>[]>) | ((registerFn: () => string) => SlotRegistry<Application[]>) | ((registerFn: () => string) => SlotRegistry<...>))[]",
@@ -2149,7 +2214,7 @@
                 "__schema": "InferenceTypeSchema",
                 "location": {
                   "filePath": "application.main.runtime.ts",
-                  "line": 423,
+                  "line": 440,
                   "character": 3
                 },
                 "type": "(((registerFn: () => string) => SlotRegistry<ApplicationType<unknown>[]>) | ((registerFn: () => string) => SlotRegistry<Application[]>) | ((registerFn: () => string) => SlotRegistry<...>))[]"
@@ -2161,7 +2226,7 @@
               "__schema": "FunctionLikeSchema",
               "location": {
                 "filePath": "application.main.runtime.ts",
-                "line": 429,
+                "line": 446,
                 "character": 3
               },
               "signature": "(method) ApplicationMain.provider([cli, loggerAspect, builder, envs, component, aspectLoader, workspace, watcher, scope]: [\n    CLIMain,\n    LoggerMain,\n    BuilderMain,\n    EnvsMain,\n    ComponentMain,\n    AspectLoaderMain,\n    Workspace,\n    WatcherMain,\n    ScopeMain\n], config: ApplicationAspectConfig, [appTypeSlot, appSlot, deploymentProviderSlot]: [ApplicationTypeSlot, ApplicationSlot, DeploymentProviderSlot], harmony: Harmony): Promise<ApplicationMain>",
@@ -2171,7 +2236,7 @@
                   "__schema": "ParameterSchema",
                   "location": {
                     "filePath": "application.main.runtime.ts",
-                    "line": 430,
+                    "line": 447,
                     "character": 5
                   },
                   "name": "[ cli, loggerAspect, builder, envs, component, aspectLoader, workspace, watcher, scope ]",
@@ -2179,7 +2244,7 @@
                     "__schema": "TupleTypeSchema",
                     "location": {
                       "filePath": "application.main.runtime.ts",
-                      "line": 430,
+                      "line": 447,
                       "character": 93
                     },
                     "elements": [
@@ -2187,7 +2252,7 @@
                         "__schema": "TypeRefSchema",
                         "location": {
                           "filePath": "application.main.runtime.ts",
-                          "line": 431,
+                          "line": 448,
                           "character": 7
                         },
                         "name": "CLIMain",
@@ -2200,7 +2265,7 @@
                         "__schema": "TypeRefSchema",
                         "location": {
                           "filePath": "application.main.runtime.ts",
-                          "line": 432,
+                          "line": 449,
                           "character": 7
                         },
                         "name": "LoggerMain",
@@ -2213,7 +2278,7 @@
                         "__schema": "TypeRefSchema",
                         "location": {
                           "filePath": "application.main.runtime.ts",
-                          "line": 433,
+                          "line": 450,
                           "character": 7
                         },
                         "name": "BuilderMain",
@@ -2226,7 +2291,7 @@
                         "__schema": "TypeRefSchema",
                         "location": {
                           "filePath": "application.main.runtime.ts",
-                          "line": 434,
+                          "line": 451,
                           "character": 7
                         },
                         "name": "EnvsMain",
@@ -2239,7 +2304,7 @@
                         "__schema": "TypeRefSchema",
                         "location": {
                           "filePath": "application.main.runtime.ts",
-                          "line": 435,
+                          "line": 452,
                           "character": 7
                         },
                         "name": "ComponentMain",
@@ -2252,7 +2317,7 @@
                         "__schema": "TypeRefSchema",
                         "location": {
                           "filePath": "application.main.runtime.ts",
-                          "line": 436,
+                          "line": 453,
                           "character": 7
                         },
                         "name": "AspectLoaderMain",
@@ -2265,7 +2330,7 @@
                         "__schema": "TypeRefSchema",
                         "location": {
                           "filePath": "application.main.runtime.ts",
-                          "line": 437,
+                          "line": 454,
                           "character": 7
                         },
                         "name": "Workspace",
@@ -2278,7 +2343,7 @@
                         "__schema": "TypeRefSchema",
                         "location": {
                           "filePath": "application.main.runtime.ts",
-                          "line": 438,
+                          "line": 455,
                           "character": 7
                         },
                         "name": "WatcherMain",
@@ -2291,7 +2356,7 @@
                         "__schema": "TypeRefSchema",
                         "location": {
                           "filePath": "application.main.runtime.ts",
-                          "line": 439,
+                          "line": 456,
                           "character": 7
                         },
                         "name": "ScopeMain",
@@ -2309,7 +2374,7 @@
                   "__schema": "ParameterSchema",
                   "location": {
                     "filePath": "application.main.runtime.ts",
-                    "line": 441,
+                    "line": 458,
                     "character": 5
                   },
                   "name": "config",
@@ -2317,7 +2382,7 @@
                     "__schema": "TypeRefSchema",
                     "location": {
                       "filePath": "application.main.runtime.ts",
-                      "line": 441,
+                      "line": 458,
                       "character": 13
                     },
                     "name": "ApplicationAspectConfig",
@@ -2330,7 +2395,7 @@
                   "__schema": "ParameterSchema",
                   "location": {
                     "filePath": "application.main.runtime.ts",
-                    "line": 442,
+                    "line": 459,
                     "character": 5
                   },
                   "name": "[ appTypeSlot, appSlot, deploymentProviderSlot ]",
@@ -2338,7 +2403,7 @@
                     "__schema": "TupleTypeSchema",
                     "location": {
                       "filePath": "application.main.runtime.ts",
-                      "line": 442,
+                      "line": 459,
                       "character": 53
                     },
                     "elements": [
@@ -2346,7 +2411,7 @@
                         "__schema": "TypeRefSchema",
                         "location": {
                           "filePath": "application.main.runtime.ts",
-                          "line": 442,
+                          "line": 459,
                           "character": 54
                         },
                         "name": "ApplicationTypeSlot",
@@ -2356,7 +2421,7 @@
                         "__schema": "TypeRefSchema",
                         "location": {
                           "filePath": "application.main.runtime.ts",
-                          "line": 442,
+                          "line": 459,
                           "character": 75
                         },
                         "name": "ApplicationSlot",
@@ -2366,7 +2431,7 @@
                         "__schema": "TypeRefSchema",
                         "location": {
                           "filePath": "application.main.runtime.ts",
-                          "line": 442,
+                          "line": 459,
                           "character": 92
                         },
                         "name": "DeploymentProviderSlot",
@@ -2381,7 +2446,7 @@
                   "__schema": "ParameterSchema",
                   "location": {
                     "filePath": "application.main.runtime.ts",
-                    "line": 443,
+                    "line": 460,
                     "character": 5
                   },
                   "name": "harmony",
@@ -2389,7 +2454,7 @@
                     "__schema": "TypeRefSchema",
                     "location": {
                       "filePath": "application.main.runtime.ts",
-                      "line": 443,
+                      "line": 460,
                       "character": 14
                     },
                     "name": "Harmony",
@@ -2407,7 +2472,7 @@
                 "__schema": "InferenceTypeSchema",
                 "location": {
                   "filePath": "application.main.runtime.ts",
-                  "line": 429,
+                  "line": 446,
                   "character": 3
                 },
                 "type": "Promise<ApplicationMain>"
@@ -2445,7 +2510,8 @@
               "character": 1
             },
             "raw": "/**\n * Application meta data that is stored on the component on load if it's an application.\n */",
-            "comment": "Application meta data that is stored on the component on load if it's an application."
+            "comment": "Application meta data that is stored on the component on load if it's an application.",
+            "tags": []
           },
           "signature": "type ApplicationMetadata = {\n    appName: string;\n    type?: string | undefined;\n}",
           "name": "ApplicationMetadata",
@@ -2534,7 +2600,8 @@
                   "character": 3
                 },
                 "raw": "/**\n   * name of the application. e.g. ripple-ci.\n   */",
-                "comment": "name of the application. e.g. ripple-ci."
+                "comment": "name of the application. e.g. ripple-ci.",
+                "tags": []
               },
               "signature": "(property) Application.name: string",
               "name": "name",
@@ -2564,7 +2631,8 @@
                   "character": 3
                 },
                 "raw": "/**\n   * run the application.\n   */",
-                "comment": "run the application."
+                "comment": "run the application.",
+                "tags": []
               },
               "signature": "(method) Application.run(context: AppContext): Promise<ApplicationInstance | number>",
               "name": "run",
@@ -2646,7 +2714,8 @@
                   "character": 3
                 },
                 "raw": "/**\n   * build the application.\n   */",
-                "comment": "build the application."
+                "comment": "build the application.",
+                "tags": []
               },
               "signature": "(property) Application.build?: BuildFn | undefined",
               "name": "build",
@@ -2676,7 +2745,8 @@
                   "character": 3
                 },
                 "raw": "/**\n   * application deployment. this is a build task.\n   */",
-                "comment": "application deployment. this is a build task."
+                "comment": "application deployment. this is a build task.",
+                "tags": []
               },
               "signature": "(property) Application.deploy?: DeployFn | undefined",
               "name": "deploy",
@@ -2706,7 +2776,8 @@
                   "character": 3
                 },
                 "raw": "/**\n   * Type of the application\n   */",
-                "comment": "Type of the application"
+                "comment": "Type of the application",
+                "tags": []
               },
               "signature": "(property) Application.applicationType?: string | undefined",
               "name": "applicationType",
@@ -3263,7 +3334,8 @@
                   "character": 3
                 },
                 "raw": "/**\n   * return a logger instance for the env.\n   */",
-                "comment": "return a logger instance for the env."
+                "comment": "return a logger instance for the env.",
+                "tags": []
               },
               "signature": "(method) AppContext.createLogger(name?: string): Logger",
               "name": "createLogger",
@@ -3319,7 +3391,8 @@
                   "character": 3
                 },
                 "raw": "/**\n   * get an instance of an aspect.\n   * make sure it is loaded prior to requesting it.\n   */",
-                "comment": "get an instance of an aspect.\nmake sure it is loaded prior to requesting it."
+                "comment": "get an instance of an aspect.\nmake sure it is loaded prior to requesting it.",
+                "tags": []
               },
               "signature": "(method) AppContext.getAspect<T>(aspectId: string): T | undefined",
               "name": "getAspect",
@@ -3476,7 +3549,7 @@
                   "_legacy": {
                     "scope": "teambit.harmony",
                     "name": "application",
-                    "version": "1.0.310"
+                    "version": "1.0.312"
                   },
                   "_scope": "teambit.harmony"
                 }
@@ -3561,7 +3634,8 @@
                   "character": 3
                 },
                 "raw": "/**\n   * name of the type of the app. e.g. `react-app`\n   */",
-                "comment": "name of the type of the app. e.g. `react-app`"
+                "comment": "name of the type of the app. e.g. `react-app`",
+                "tags": []
               },
               "signature": "(property) ApplicationType<T>.name: string",
               "name": "name",
@@ -3591,7 +3665,8 @@
                   "character": 3
                 },
                 "raw": "/**\n   * pattern of the app.\n   */",
-                "comment": "pattern of the app."
+                "comment": "pattern of the app.",
+                "tags": []
               },
               "signature": "(property) ApplicationType<T>.globPattern?: string | undefined",
               "name": "globPattern",
@@ -3621,7 +3696,8 @@
                   "character": 3
                 },
                 "raw": "/**\n   * a function that creates the app instance.\n   */",
-                "comment": "a function that creates the app instance."
+                "comment": "a function that creates the app instance.",
+                "tags": []
               },
               "signature": "(method) ApplicationType<T>.createApp(options: T): Application",
               "name": "createApp",
@@ -3865,7 +3941,7 @@
                               "_legacy": {
                                 "scope": "teambit.harmony",
                                 "name": "application",
-                                "version": "1.0.310"
+                                "version": "1.0.312"
                               },
                               "_scope": "teambit.harmony"
                             }
@@ -4193,7 +4269,8 @@
                               "character": 3
                             },
                             "raw": "/**\n   * return a logger instance for the env.\n   */",
-                            "comment": "return a logger instance for the env."
+                            "comment": "return a logger instance for the env.",
+                            "tags": []
                           },
                           "signature": "(method) AppContext.createLogger(name?: string): Logger"
                         },
@@ -4267,7 +4344,8 @@
                               "character": 3
                             },
                             "raw": "/**\n   * get an instance of an aspect.\n   * make sure it is loaded prior to requesting it.\n   */",
-                            "comment": "get an instance of an aspect.\nmake sure it is loaded prior to requesting it."
+                            "comment": "get an instance of an aspect.\nmake sure it is loaded prior to requesting it.",
+                            "tags": []
                           },
                           "signature": "(method) AppContext.getAspect<T>(aspectId: string): T | undefined"
                         },
@@ -4372,7 +4450,7 @@
                         "_legacy": {
                           "scope": "teambit.harmony",
                           "name": "application",
-                          "version": "1.0.310"
+                          "version": "1.0.312"
                         },
                         "_scope": "teambit.harmony"
                       }
@@ -5198,7 +5276,7 @@
                         "_legacy": {
                           "scope": "teambit.harmony",
                           "name": "application",
-                          "version": "1.0.310"
+                          "version": "1.0.312"
                         },
                         "_scope": "teambit.harmony"
                       }
@@ -5526,7 +5604,8 @@
                         "character": 3
                       },
                       "raw": "/**\n   * return a logger instance for the env.\n   */",
-                      "comment": "return a logger instance for the env."
+                      "comment": "return a logger instance for the env.",
+                      "tags": []
                     },
                     "signature": "(method) AppContext.createLogger(name?: string): Logger"
                   },
@@ -5600,7 +5679,8 @@
                         "character": 3
                       },
                       "raw": "/**\n   * get an instance of an aspect.\n   * make sure it is loaded prior to requesting it.\n   */",
-                      "comment": "get an instance of an aspect.\nmake sure it is loaded prior to requesting it."
+                      "comment": "get an instance of an aspect.\nmake sure it is loaded prior to requesting it.",
+                      "tags": []
                     },
                     "signature": "(method) AppContext.getAspect<T>(aspectId: string): T | undefined"
                   },
@@ -5705,7 +5785,7 @@
                   "_legacy": {
                     "scope": "teambit.harmony",
                     "name": "application",
-                    "version": "1.0.310"
+                    "version": "1.0.312"
                   },
                   "_scope": "teambit.harmony"
                 }
@@ -5779,7 +5859,8 @@
                   "character": 3
                 },
                 "raw": "/**\n   * errors thrown during the build process.\n   */",
-                "comment": "errors thrown during the build process."
+                "comment": "errors thrown during the build process.",
+                "tags": []
               },
               "signature": "(property) AppBuildResult.errors?: Error[] | undefined",
               "name": "errors",
@@ -5817,7 +5898,8 @@
                   "character": 3
                 },
                 "raw": "/**\n   * warnings thrown during the build process.\n   */",
-                "comment": "warnings thrown during the build process."
+                "comment": "warnings thrown during the build process.",
+                "tags": []
               },
               "signature": "(property) AppBuildResult.warnings?: string[] | undefined",
               "name": "warnings",
@@ -5855,7 +5937,8 @@
                   "character": 3
                 },
                 "raw": "/**\n   * metadata to persist.\n   * this is the only property that actually gets saved into the objects (in builder aspect, aspectsData.buildDeployContexts[deployContext]).\n   * in some scenarios, the build and deploy pipelines run in different processes, and then the only data the deploy\n   * gets is what saved into the objects.\n   * examples of data that gets save here:\n   * React: { publicDir, ssrPublicDir }.\n   * Node: { mainFile, artifactsDir }.\n   */",
-                "comment": "metadata to persist.\nthis is the only property that actually gets saved into the objects (in builder aspect, aspectsData.buildDeployContexts[deployContext]).\nin some scenarios, the build and deploy pipelines run in different processes, and then the only data the deploy\ngets is what saved into the objects.\nexamples of data that gets save here:\nReact: { publicDir, ssrPublicDir }.\nNode: { mainFile, artifactsDir }."
+                "comment": "metadata to persist.\nthis is the only property that actually gets saved into the objects (in builder aspect, aspectsData.buildDeployContexts[deployContext]).\nin some scenarios, the build and deploy pipelines run in different processes, and then the only data the deploy\ngets is what saved into the objects.\nexamples of data that gets save here:\nReact: { publicDir, ssrPublicDir }.\nNode: { mainFile, artifactsDir }.",
+                "tags": []
               },
               "signature": "(property) AppBuildResult.metadata?: Record<string, any> | undefined",
               "name": "metadata",
@@ -5958,7 +6041,8 @@
                   "character": 3
                 },
                 "raw": "/**\n   * return a template list instance.\n   */",
-                "comment": "return a template list instance."
+                "comment": "return a template list instance.",
+                "tags": []
               },
               "signature": "(method) AppsEnv.apps?(): EnvHandler<AppTypeList>",
               "name": "apps",
@@ -6512,7 +6596,8 @@
                     "character": 3
                   },
                   "raw": "/**\n   * envs ids to load app types.\n   */",
-                  "comment": "envs ids to load app types."
+                  "comment": "envs ids to load app types.",
+                  "tags": []
                 },
                 "signature": "(property) envs?: string[] | undefined",
                 "name": "envs",
@@ -6553,7 +6638,8 @@
               "character": 1
             },
             "raw": "/**\n * Application meta data that is stored on the component on load if it's an application.\n */",
-            "comment": "Application meta data that is stored on the component on load if it's an application."
+            "comment": "Application meta data that is stored on the component on load if it's an application.",
+            "tags": []
           },
           "signature": "type ApplicationMetadata = {\n    appName: string;\n    type?: string | undefined;\n}",
           "name": "ApplicationMetadata",
@@ -6640,7 +6726,8 @@
                     "character": 3
                   },
                   "raw": "/**\n   * default port range used to serve applications.\n   */",
-                  "comment": "default port range used to serve applications."
+                  "comment": "default port range used to serve applications.",
+                  "tags": []
                 },
                 "signature": "(property) defaultPortRange?: [start: number, end: number] | undefined",
                 "name": "defaultPortRange",
@@ -6707,7 +6794,8 @@
                     "character": 3
                   },
                   "raw": "/**\n   * determine whether to start the application in dev mode.\n   */",
-                  "comment": "determine whether to start the application in dev mode."
+                  "comment": "determine whether to start the application in dev mode.",
+                  "tags": []
                 },
                 "signature": "(property) dev: boolean",
                 "name": "dev",
@@ -6821,7 +6909,8 @@
                     "character": 3
                   },
                   "raw": "/**\n   * exact port to run the app\n   */",
-                  "comment": "exact port to run the app"
+                  "comment": "exact port to run the app",
+                  "tags": []
                 },
                 "signature": "(property) port?: number | undefined",
                 "name": "port",
@@ -7160,7 +7249,8 @@
                   "character": 3
                 },
                 "raw": "/**\n   * register a new app.\n   */",
-                "comment": "register a new app."
+                "comment": "register a new app.",
+                "tags": []
               },
               "signature": "(method) ApplicationMain.registerApp(app: Application): this",
               "name": "registerApp",
@@ -7212,7 +7302,8 @@
                   "character": 3
                 },
                 "raw": "/**\n   * list all registered apps.\n   */",
-                "comment": "list all registered apps."
+                "comment": "list all registered apps.",
+                "tags": []
               },
               "signature": "(method) ApplicationMain.listApps(): Application[]",
               "name": "listApps",
@@ -7251,7 +7342,8 @@
                   "character": 3
                 },
                 "raw": "/**\n   * map all apps by component ID.\n   */",
-                "comment": "map all apps by component ID."
+                "comment": "map all apps by component ID.",
+                "tags": []
               },
               "signature": "(method) ApplicationMain.mapApps(): [string, Application[]][]",
               "name": "mapApps",
@@ -7271,7 +7363,7 @@
               "__schema": "FunctionLikeSchema",
               "location": {
                 "filePath": "application.main.runtime.ts",
-                "line": 118,
+                "line": 119,
                 "character": 3
               },
               "doc": {
@@ -7281,8 +7373,43 @@
                   "line": 115,
                   "character": 3
                 },
-                "raw": "/**\n   * list apps by a component id.\n   */",
-                "comment": "list apps by a component id."
+                "raw": "/**\n   * instead of adding apps to workspace.jsonc, this method gets all apps components and load them as aspects so then\n   * they could register to the apps slots and be available to list/run etc.\n   */",
+                "comment": "instead of adding apps to workspace.jsonc, this method gets all apps components and load them as aspects so then\nthey could register to the apps slots and be available to list/run etc.",
+                "tags": []
+              },
+              "signature": "(method) ApplicationMain.loadAllAppsAsAspects(): Promise<void>",
+              "name": "loadAllAppsAsAspects",
+              "params": [],
+              "returnType": {
+                "__schema": "InferenceTypeSchema",
+                "location": {
+                  "filePath": "application.main.runtime.ts",
+                  "line": 119,
+                  "character": 3
+                },
+                "type": "Promise<void>"
+              },
+              "modifiers": [
+                "async"
+              ]
+            },
+            {
+              "__schema": "FunctionLikeSchema",
+              "location": {
+                "filePath": "application.main.runtime.ts",
+                "line": 128,
+                "character": 3
+              },
+              "doc": {
+                "__schema": "DocSchema",
+                "location": {
+                  "filePath": "application.main.runtime.ts",
+                  "line": 124,
+                  "character": 3
+                },
+                "raw": "/**\n   * list apps by a component id.\n   * make sure to call `this.loadAllAppsAsAspects` before calling this method in case the app is not listed in workspace.jsonc\n   */",
+                "comment": "list apps by a component id.\nmake sure to call `this.loadAllAppsAsAspects` before calling this method in case the app is not listed in workspace.jsonc",
+                "tags": []
               },
               "signature": "(method) ApplicationMain.listAppsById(id?: ComponentID): Application[] | undefined",
               "name": "listAppsById",
@@ -7291,7 +7418,7 @@
                   "__schema": "ParameterSchema",
                   "location": {
                     "filePath": "application.main.runtime.ts",
-                    "line": 118,
+                    "line": 128,
                     "character": 16
                   },
                   "name": "id",
@@ -7299,7 +7426,7 @@
                     "__schema": "TypeRefSchema",
                     "location": {
                       "filePath": "application.main.runtime.ts",
-                      "line": 118,
+                      "line": 128,
                       "character": 21
                     },
                     "name": "ComponentID",
@@ -7316,7 +7443,7 @@
                 "__schema": "TypeUnionSchema",
                 "location": {
                   "filePath": "application.main.runtime.ts",
-                  "line": 118,
+                  "line": 128,
                   "character": 35
                 },
                 "types": [
@@ -7324,14 +7451,14 @@
                     "__schema": "TypeArraySchema",
                     "location": {
                       "filePath": "application.main.runtime.ts",
-                      "line": 118,
+                      "line": 128,
                       "character": 35
                     },
                     "type": {
                       "__schema": "TypeRefSchema",
                       "location": {
                         "filePath": "application.main.runtime.ts",
-                        "line": 118,
+                        "line": 128,
                         "character": 35
                       },
                       "name": "Application"
@@ -7341,7 +7468,7 @@
                     "__schema": "KeywordTypeSchema",
                     "location": {
                       "filePath": "application.main.runtime.ts",
-                      "line": 118,
+                      "line": 128,
                       "character": 51
                     },
                     "name": "undefined"
@@ -7354,18 +7481,19 @@
               "__schema": "FunctionLikeSchema",
               "location": {
                 "filePath": "application.main.runtime.ts",
-                "line": 126,
+                "line": 137,
                 "character": 3
               },
               "doc": {
                 "__schema": "DocSchema",
                 "location": {
                   "filePath": "application.main.runtime.ts",
-                  "line": 123,
+                  "line": 133,
                   "character": 3
                 },
-                "raw": "/**\n   * get an application by a component id.\n   */",
-                "comment": "get an application by a component id."
+                "raw": "/**\n   * get an application by a component id.\n   * make sure to call `this.loadAllAppsAsAspects` before calling this method in case the app is not listed in workspace.jsonc\n   */",
+                "comment": "get an application by a component id.\nmake sure to call `this.loadAllAppsAsAspects` before calling this method in case the app is not listed in workspace.jsonc",
+                "tags": []
               },
               "signature": "(method) ApplicationMain.getAppById(id: ComponentID): Promise<Application | undefined>",
               "name": "getAppById",
@@ -7374,7 +7502,7 @@
                   "__schema": "ParameterSchema",
                   "location": {
                     "filePath": "application.main.runtime.ts",
-                    "line": 126,
+                    "line": 137,
                     "character": 20
                   },
                   "name": "id",
@@ -7382,7 +7510,7 @@
                     "__schema": "TypeRefSchema",
                     "location": {
                       "filePath": "application.main.runtime.ts",
-                      "line": 126,
+                      "line": 137,
                       "character": 24
                     },
                     "name": "ComponentID",
@@ -7399,7 +7527,7 @@
                 "__schema": "InferenceTypeSchema",
                 "location": {
                   "filePath": "application.main.runtime.ts",
-                  "line": 126,
+                  "line": 137,
                   "character": 3
                 },
                 "type": "Promise<Application | undefined>"
@@ -7412,18 +7540,19 @@
               "__schema": "FunctionLikeSchema",
               "location": {
                 "filePath": "application.main.runtime.ts",
-                "line": 136,
+                "line": 147,
                 "character": 3
               },
               "doc": {
                 "__schema": "DocSchema",
                 "location": {
                   "filePath": "application.main.runtime.ts",
-                  "line": 132,
+                  "line": 143,
                   "character": 3
                 },
                 "raw": "/**\n   * calculate an application by a component.\n   * This should be only used during the on component load slot\n   */",
-                "comment": "calculate an application by a component.\nThis should be only used during the on component load slot"
+                "comment": "calculate an application by a component.\nThis should be only used during the on component load slot",
+                "tags": []
               },
               "signature": "(method) ApplicationMain.calculateAppByComponent(component: Component): Application | undefined",
               "name": "calculateAppByComponent",
@@ -7432,7 +7561,7 @@
                   "__schema": "ParameterSchema",
                   "location": {
                     "filePath": "application.main.runtime.ts",
-                    "line": 136,
+                    "line": 147,
                     "character": 27
                   },
                   "name": "component",
@@ -7440,7 +7569,7 @@
                     "__schema": "TypeRefSchema",
                     "location": {
                       "filePath": "application.main.runtime.ts",
-                      "line": 136,
+                      "line": 147,
                       "character": 38
                     },
                     "name": "Component",
@@ -7457,7 +7586,7 @@
                 "__schema": "TypeRefSchema",
                 "location": {
                   "filePath": "application.main.runtime.ts",
-                  "line": 136,
+                  "line": 147,
                   "character": 3
                 },
                 "name": "Application"
@@ -7468,7 +7597,7 @@
               "__schema": "FunctionLikeSchema",
               "location": {
                 "filePath": "application.main.runtime.ts",
-                "line": 142,
+                "line": 153,
                 "character": 3
               },
               "signature": "(method) ApplicationMain.listAppTypes(): ApplicationType<unknown>[]",
@@ -7478,7 +7607,7 @@
                 "__schema": "TypeRefSchema",
                 "location": {
                   "filePath": "application.main.runtime.ts",
-                  "line": 142,
+                  "line": 153,
                   "character": 3
                 },
                 "name": "ApplicationType"
@@ -7489,23 +7618,24 @@
               "__schema": "FunctionLikeSchema",
               "location": {
                 "filePath": "application.main.runtime.ts",
-                "line": 150,
+                "line": 161,
                 "character": 3
               },
               "doc": {
                 "__schema": "DocSchema",
                 "location": {
                   "filePath": "application.main.runtime.ts",
-                  "line": 146,
+                  "line": 157,
                   "character": 3
                 },
                 "raw": "/**\n   * @deprecated use `listAppsComponents` instead.\n   * @returns\n   */",
+                "comment": "",
                 "tags": [
                   {
                     "__schema": "TagSchema",
                     "location": {
                       "filePath": "application.main.runtime.ts",
-                      "line": 147,
+                      "line": 158,
                       "character": 6
                     },
                     "tagName": "deprecated",
@@ -7515,7 +7645,7 @@
                     "__schema": "ReturnTagSchema",
                     "location": {
                       "filePath": "application.main.runtime.ts",
-                      "line": 148,
+                      "line": 159,
                       "character": 6
                     },
                     "tagName": "return"
@@ -7529,7 +7659,7 @@
                 "__schema": "TypeRefSchema",
                 "location": {
                   "filePath": "application.main.runtime.ts",
-                  "line": 150,
+                  "line": 161,
                   "character": 35
                 },
                 "name": "Promise",
@@ -7538,14 +7668,14 @@
                     "__schema": "TypeArraySchema",
                     "location": {
                       "filePath": "application.main.runtime.ts",
-                      "line": 150,
+                      "line": 161,
                       "character": 43
                     },
                     "type": {
                       "__schema": "TypeRefSchema",
                       "location": {
                         "filePath": "application.main.runtime.ts",
-                        "line": 150,
+                        "line": 161,
                         "character": 43
                       },
                       "name": "Component",
@@ -7565,7 +7695,7 @@
               "__schema": "FunctionLikeSchema",
               "location": {
                 "filePath": "application.main.runtime.ts",
-                "line": 154,
+                "line": 165,
                 "character": 3
               },
               "signature": "(method) ApplicationMain.listAppsComponents(): Promise<Component[]>",
@@ -7575,7 +7705,7 @@
                 "__schema": "TypeRefSchema",
                 "location": {
                   "filePath": "application.main.runtime.ts",
-                  "line": 154,
+                  "line": 165,
                   "character": 31
                 },
                 "name": "Promise",
@@ -7584,14 +7714,14 @@
                     "__schema": "TypeArraySchema",
                     "location": {
                       "filePath": "application.main.runtime.ts",
-                      "line": 154,
+                      "line": 165,
                       "character": 39
                     },
                     "type": {
                       "__schema": "TypeRefSchema",
                       "location": {
                         "filePath": "application.main.runtime.ts",
-                        "line": 154,
+                        "line": 165,
                         "character": 39
                       },
                       "name": "Component",
@@ -7611,7 +7741,7 @@
               "__schema": "FunctionLikeSchema",
               "location": {
                 "filePath": "application.main.runtime.ts",
-                "line": 168,
+                "line": 179,
                 "character": 3
               },
               "signature": "(method) ApplicationMain.getAppPatterns(): string[]",
@@ -7621,7 +7751,7 @@
                 "__schema": "InferenceTypeSchema",
                 "location": {
                   "filePath": "application.main.runtime.ts",
-                  "line": 168,
+                  "line": 179,
                   "character": 3
                 },
                 "type": "string[]"
@@ -7632,7 +7762,7 @@
               "__schema": "FunctionLikeSchema",
               "location": {
                 "filePath": "application.main.runtime.ts",
-                "line": 177,
+                "line": 188,
                 "character": 3
               },
               "signature": "(method) ApplicationMain.loadApps(): Promise<Application[]>",
@@ -7642,7 +7772,7 @@
                 "__schema": "TypeRefSchema",
                 "location": {
                   "filePath": "application.main.runtime.ts",
-                  "line": 177,
+                  "line": 188,
                   "character": 21
                 },
                 "name": "Promise",
@@ -7651,14 +7781,14 @@
                     "__schema": "TypeArraySchema",
                     "location": {
                       "filePath": "application.main.runtime.ts",
-                      "line": 177,
+                      "line": 188,
                       "character": 29
                     },
                     "type": {
                       "__schema": "TypeRefSchema",
                       "location": {
                         "filePath": "application.main.runtime.ts",
-                        "line": 177,
+                        "line": 188,
                         "character": 29
                       },
                       "name": "Application"
@@ -7674,7 +7804,7 @@
               "__schema": "FunctionLikeSchema",
               "location": {
                 "filePath": "application.main.runtime.ts",
-                "line": 210,
+                "line": 221,
                 "character": 3
               },
               "signature": "(method) ApplicationMain.loadAppsFromComponent(component: Component, rootDir: string): Promise<Application[] | undefined>",
@@ -7684,7 +7814,7 @@
                   "__schema": "ParameterSchema",
                   "location": {
                     "filePath": "application.main.runtime.ts",
-                    "line": 210,
+                    "line": 221,
                     "character": 31
                   },
                   "name": "component",
@@ -7692,7 +7822,7 @@
                     "__schema": "TypeRefSchema",
                     "location": {
                       "filePath": "application.main.runtime.ts",
-                      "line": 210,
+                      "line": 221,
                       "character": 42
                     },
                     "name": "Component",
@@ -7708,7 +7838,7 @@
                   "__schema": "ParameterSchema",
                   "location": {
                     "filePath": "application.main.runtime.ts",
-                    "line": 210,
+                    "line": 221,
                     "character": 53
                   },
                   "name": "rootDir",
@@ -7716,7 +7846,7 @@
                     "__schema": "KeywordTypeSchema",
                     "location": {
                       "filePath": "application.main.runtime.ts",
-                      "line": 210,
+                      "line": 221,
                       "character": 62
                     },
                     "name": "string"
@@ -7729,7 +7859,7 @@
                 "__schema": "TypeRefSchema",
                 "location": {
                   "filePath": "application.main.runtime.ts",
-                  "line": 210,
+                  "line": 221,
                   "character": 71
                 },
                 "name": "Promise",
@@ -7738,7 +7868,7 @@
                     "__schema": "TypeUnionSchema",
                     "location": {
                       "filePath": "application.main.runtime.ts",
-                      "line": 210,
+                      "line": 221,
                       "character": 79
                     },
                     "types": [
@@ -7746,14 +7876,14 @@
                         "__schema": "TypeArraySchema",
                         "location": {
                           "filePath": "application.main.runtime.ts",
-                          "line": 210,
+                          "line": 221,
                           "character": 79
                         },
                         "type": {
                           "__schema": "TypeRefSchema",
                           "location": {
                             "filePath": "application.main.runtime.ts",
-                            "line": 210,
+                            "line": 221,
                             "character": 79
                           },
                           "name": "Application"
@@ -7763,7 +7893,7 @@
                         "__schema": "KeywordTypeSchema",
                         "location": {
                           "filePath": "application.main.runtime.ts",
-                          "line": 210,
+                          "line": 221,
                           "character": 95
                         },
                         "name": "undefined"
@@ -7780,18 +7910,19 @@
               "__schema": "FunctionLikeSchema",
               "location": {
                 "filePath": "application.main.runtime.ts",
-                "line": 236,
+                "line": 248,
                 "character": 3
               },
               "doc": {
                 "__schema": "DocSchema",
                 "location": {
                   "filePath": "application.main.runtime.ts",
-                  "line": 233,
+                  "line": 244,
                   "character": 3
                 },
-                "raw": "/**\n   * get an app.\n   */",
-                "comment": "get an app."
+                "raw": "/**\n   * get an app.\n   * make sure to call `this.loadAllAppsAsAspects` before calling this method in case the app is not listed in workspace.jsonc\n   */",
+                "comment": "get an app.\nmake sure to call `this.loadAllAppsAsAspects` before calling this method in case the app is not listed in workspace.jsonc",
+                "tags": []
               },
               "signature": "(method) ApplicationMain.getApp(appName: string, id?: ComponentID): Application | undefined",
               "name": "getApp",
@@ -7800,7 +7931,7 @@
                   "__schema": "ParameterSchema",
                   "location": {
                     "filePath": "application.main.runtime.ts",
-                    "line": 236,
+                    "line": 248,
                     "character": 10
                   },
                   "name": "appName",
@@ -7808,7 +7939,7 @@
                     "__schema": "KeywordTypeSchema",
                     "location": {
                       "filePath": "application.main.runtime.ts",
-                      "line": 236,
+                      "line": 248,
                       "character": 19
                     },
                     "name": "string"
@@ -7820,7 +7951,7 @@
                   "__schema": "ParameterSchema",
                   "location": {
                     "filePath": "application.main.runtime.ts",
-                    "line": 236,
+                    "line": 248,
                     "character": 27
                   },
                   "name": "id",
@@ -7828,7 +7959,7 @@
                     "__schema": "TypeRefSchema",
                     "location": {
                       "filePath": "application.main.runtime.ts",
-                      "line": 236,
+                      "line": 248,
                       "character": 32
                     },
                     "name": "ComponentID",
@@ -7845,7 +7976,7 @@
                 "__schema": "TypeUnionSchema",
                 "location": {
                   "filePath": "application.main.runtime.ts",
-                  "line": 236,
+                  "line": 248,
                   "character": 46
                 },
                 "types": [
@@ -7853,7 +7984,7 @@
                     "__schema": "TypeRefSchema",
                     "location": {
                       "filePath": "application.main.runtime.ts",
-                      "line": 236,
+                      "line": 248,
                       "character": 46
                     },
                     "name": "Application"
@@ -7862,7 +7993,7 @@
                     "__schema": "KeywordTypeSchema",
                     "location": {
                       "filePath": "application.main.runtime.ts",
-                      "line": 236,
+                      "line": 248,
                       "character": 60
                     },
                     "name": "undefined"
@@ -7875,7 +8006,7 @@
               "__schema": "FunctionLikeSchema",
               "location": {
                 "filePath": "application.main.runtime.ts",
-                "line": 242,
+                "line": 254,
                 "character": 3
               },
               "signature": "(method) ApplicationMain.getAppByNameOrId(appNameOrId: string): Application | undefined",
@@ -7885,7 +8016,7 @@
                   "__schema": "ParameterSchema",
                   "location": {
                     "filePath": "application.main.runtime.ts",
-                    "line": 242,
+                    "line": 254,
                     "character": 20
                   },
                   "name": "appNameOrId",
@@ -7893,7 +8024,7 @@
                     "__schema": "KeywordTypeSchema",
                     "location": {
                       "filePath": "application.main.runtime.ts",
-                      "line": 242,
+                      "line": 254,
                       "character": 33
                     },
                     "name": "string"
@@ -7906,7 +8037,7 @@
                 "__schema": "TypeUnionSchema",
                 "location": {
                   "filePath": "application.main.runtime.ts",
-                  "line": 242,
+                  "line": 254,
                   "character": 42
                 },
                 "types": [
@@ -7914,7 +8045,7 @@
                     "__schema": "TypeRefSchema",
                     "location": {
                       "filePath": "application.main.runtime.ts",
-                      "line": 242,
+                      "line": 254,
                       "character": 42
                     },
                     "name": "Application"
@@ -7923,7 +8054,7 @@
                     "__schema": "KeywordTypeSchema",
                     "location": {
                       "filePath": "application.main.runtime.ts",
-                      "line": 242,
+                      "line": 254,
                       "character": 56
                     },
                     "name": "undefined"
@@ -7936,7 +8067,7 @@
               "__schema": "FunctionLikeSchema",
               "location": {
                 "filePath": "application.main.runtime.ts",
-                "line": 255,
+                "line": 267,
                 "character": 3
               },
               "signature": "(method) ApplicationMain.getAppPattern(appType: ApplicationType<unknown>): string",
@@ -7946,7 +8077,7 @@
                   "__schema": "ParameterSchema",
                   "location": {
                     "filePath": "application.main.runtime.ts",
-                    "line": 255,
+                    "line": 267,
                     "character": 17
                   },
                   "name": "appType",
@@ -7954,7 +8085,7 @@
                     "__schema": "TypeRefSchema",
                     "location": {
                       "filePath": "application.main.runtime.ts",
-                      "line": 255,
+                      "line": 267,
                       "character": 26
                     },
                     "name": "ApplicationType",
@@ -7963,7 +8094,7 @@
                         "__schema": "KeywordTypeSchema",
                         "location": {
                           "filePath": "application.main.runtime.ts",
-                          "line": 255,
+                          "line": 267,
                           "character": 42
                         },
                         "name": "unknown"
@@ -7978,7 +8109,7 @@
                 "__schema": "InferenceTypeSchema",
                 "location": {
                   "filePath": "application.main.runtime.ts",
-                  "line": 255,
+                  "line": 267,
                   "character": 3
                 },
                 "type": "string"
@@ -7989,18 +8120,19 @@
               "__schema": "FunctionLikeSchema",
               "location": {
                 "filePath": "application.main.runtime.ts",
-                "line": 263,
+                "line": 275,
                 "character": 3
               },
               "doc": {
                 "__schema": "DocSchema",
                 "location": {
                   "filePath": "application.main.runtime.ts",
-                  "line": 260,
+                  "line": 272,
                   "character": 3
                 },
                 "raw": "/**\n   * registers a new app and sets a plugin for it.\n   */",
-                "comment": "registers a new app and sets a plugin for it."
+                "comment": "registers a new app and sets a plugin for it.",
+                "tags": []
               },
               "signature": "(method) ApplicationMain.registerAppType<T>(...appTypes: Array<ApplicationType<T>>): this",
               "name": "registerAppType",
@@ -8009,7 +8141,7 @@
                   "__schema": "ParameterSchema",
                   "location": {
                     "filePath": "application.main.runtime.ts",
-                    "line": 263,
+                    "line": 275,
                     "character": 22
                   },
                   "name": "appTypes",
@@ -8017,7 +8149,7 @@
                     "__schema": "TypeRefSchema",
                     "location": {
                       "filePath": "application.main.runtime.ts",
-                      "line": 263,
+                      "line": 275,
                       "character": 35
                     },
                     "name": "Array",
@@ -8026,7 +8158,7 @@
                         "__schema": "TypeRefSchema",
                         "location": {
                           "filePath": "application.main.runtime.ts",
-                          "line": 263,
+                          "line": 275,
                           "character": 41
                         },
                         "name": "ApplicationType",
@@ -8035,7 +8167,7 @@
                             "__schema": "TypeRefSchema",
                             "location": {
                               "filePath": "application.main.runtime.ts",
-                              "line": 263,
+                              "line": 275,
                               "character": 57
                             },
                             "name": "T"
@@ -8052,7 +8184,7 @@
                 "__schema": "TypeRefSchema",
                 "location": {
                   "filePath": "application.main.runtime.ts",
-                  "line": 263,
+                  "line": 275,
                   "character": 3
                 },
                 "name": "ApplicationMain"
@@ -8066,18 +8198,19 @@
               "__schema": "FunctionLikeSchema",
               "location": {
                 "filePath": "application.main.runtime.ts",
-                "line": 276,
+                "line": 288,
                 "character": 3
               },
               "doc": {
                 "__schema": "DocSchema",
                 "location": {
                   "filePath": "application.main.runtime.ts",
-                  "line": 273,
+                  "line": 285,
                   "character": 3
                 },
                 "raw": "/**\n   * get an app AspectId.\n   */",
-                "comment": "get an app AspectId."
+                "comment": "get an app AspectId.",
+                "tags": []
               },
               "signature": "(method) ApplicationMain.getAppAspect(appName: string): string | undefined",
               "name": "getAppAspect",
@@ -8086,7 +8219,7 @@
                   "__schema": "ParameterSchema",
                   "location": {
                     "filePath": "application.main.runtime.ts",
-                    "line": 276,
+                    "line": 288,
                     "character": 16
                   },
                   "name": "appName",
@@ -8094,7 +8227,7 @@
                     "__schema": "KeywordTypeSchema",
                     "location": {
                       "filePath": "application.main.runtime.ts",
-                      "line": 276,
+                      "line": 288,
                       "character": 25
                     },
                     "name": "string"
@@ -8107,7 +8240,7 @@
                 "__schema": "TypeUnionSchema",
                 "location": {
                   "filePath": "application.main.runtime.ts",
-                  "line": 276,
+                  "line": 288,
                   "character": 34
                 },
                 "types": [
@@ -8115,7 +8248,7 @@
                     "__schema": "KeywordTypeSchema",
                     "location": {
                       "filePath": "application.main.runtime.ts",
-                      "line": 276,
+                      "line": 288,
                       "character": 34
                     },
                     "name": "string"
@@ -8124,7 +8257,7 @@
                     "__schema": "KeywordTypeSchema",
                     "location": {
                       "filePath": "application.main.runtime.ts",
-                      "line": 276,
+                      "line": 288,
                       "character": 43
                     },
                     "name": "undefined"
@@ -8137,18 +8270,19 @@
               "__schema": "FunctionLikeSchema",
               "location": {
                 "filePath": "application.main.runtime.ts",
-                "line": 283,
+                "line": 296,
                 "character": 3
               },
               "doc": {
                 "__schema": "DocSchema",
                 "location": {
                   "filePath": "application.main.runtime.ts",
-                  "line": 280,
+                  "line": 292,
                   "character": 3
                 },
-                "raw": "/**\n   * get app to throw.\n   */",
-                "comment": "get app to throw."
+                "raw": "/**\n   * get app to throw.\n   * make sure to call `this.loadAllAppsAsAspects` before calling this method in case the app is not listed in workspace.jsonc\n   */",
+                "comment": "get app to throw.\nmake sure to call `this.loadAllAppsAsAspects` before calling this method in case the app is not listed in workspace.jsonc",
+                "tags": []
               },
               "signature": "(method) ApplicationMain.getAppOrThrow(appName: string): Application",
               "name": "getAppOrThrow",
@@ -8157,7 +8291,7 @@
                   "__schema": "ParameterSchema",
                   "location": {
                     "filePath": "application.main.runtime.ts",
-                    "line": 283,
+                    "line": 296,
                     "character": 17
                   },
                   "name": "appName",
@@ -8165,7 +8299,7 @@
                     "__schema": "KeywordTypeSchema",
                     "location": {
                       "filePath": "application.main.runtime.ts",
-                      "line": 283,
+                      "line": 296,
                       "character": 26
                     },
                     "name": "string"
@@ -8178,7 +8312,7 @@
                 "__schema": "TypeRefSchema",
                 "location": {
                   "filePath": "application.main.runtime.ts",
-                  "line": 283,
+                  "line": 296,
                   "character": 3
                 },
                 "name": "Application"
@@ -8189,7 +8323,7 @@
               "__schema": "VariableLikeSchema",
               "location": {
                 "filePath": "application.main.runtime.ts",
-                "line": 289,
+                "line": 302,
                 "character": 3
               },
               "signature": "(property) ApplicationMain.defaultOpts: ServeAppOptions",
@@ -8198,7 +8332,7 @@
                 "__schema": "TypeRefSchema",
                 "location": {
                   "filePath": "application.main.runtime.ts",
-                  "line": 289,
+                  "line": 302,
                   "character": 3
                 },
                 "name": "ServeAppOptions",
@@ -8211,7 +8345,7 @@
               "__schema": "FunctionLikeSchema",
               "location": {
                 "filePath": "application.main.runtime.ts",
-                "line": 302,
+                "line": 315,
                 "character": 3
               },
               "signature": "(method) ApplicationMain.loadAppsToSlot(): Promise<this>",
@@ -8221,7 +8355,7 @@
                 "__schema": "InferenceTypeSchema",
                 "location": {
                   "filePath": "application.main.runtime.ts",
-                  "line": 302,
+                  "line": 315,
                   "character": 3
                 },
                 "type": "Promise<this>"
@@ -8234,9 +8368,20 @@
               "__schema": "FunctionLikeSchema",
               "location": {
                 "filePath": "application.main.runtime.ts",
-                "line": 308,
+                "line": 325,
                 "character": 3
               },
+              "doc": {
+                "__schema": "DocSchema",
+                "location": {
+                  "filePath": "application.main.runtime.ts",
+                  "line": 321,
+                  "character": 3
+                },
+                "raw": "/**\n   * run an app.\n   * make sure to call `this.loadAllAppsAsAspects` before calling this method in case the app is not listed in workspace.jsonc\n   */",
+                "comment": "run an app.\nmake sure to call `this.loadAllAppsAsAspects` before calling this method in case the app is not listed in workspace.jsonc",
+                "tags": []
+              },
               "signature": "(method) ApplicationMain.runApp(appName: string, options?: ServeAppOptions): Promise<{\n    app: Application;\n    port: number | undefined;\n    errors?: Error[] | undefined;\n    isOldApi: boolean;\n}>",
               "name": "runApp",
               "params": [
@@ -8244,7 +8389,7 @@
                   "__schema": "ParameterSchema",
                   "location": {
                     "filePath": "application.main.runtime.ts",
-                    "line": 309,
+                    "line": 326,
                     "character": 5
                   },
                   "name": "appName",
@@ -8252,7 +8397,7 @@
                     "__schema": "KeywordTypeSchema",
                     "location": {
                       "filePath": "application.main.runtime.ts",
-                      "line": 309,
+                      "line": 326,
                       "character": 14
                     },
                     "name": "string"
@@ -8264,7 +8409,7 @@
                   "__schema": "ParameterSchema",
                   "location": {
                     "filePath": "application.main.runtime.ts",
-                    "line": 310,
+                    "line": 327,
                     "character": 5
                   },
                   "name": "options",
@@ -8272,7 +8417,7 @@
                     "__schema": "TypeRefSchema",
                     "location": {
                       "filePath": "application.main.runtime.ts",
-                      "line": 310,
+                      "line": 327,
                       "character": 15
                     },
                     "name": "ServeAppOptions",
@@ -8286,7 +8431,7 @@
                 "__schema": "TypeRefSchema",
                 "location": {
                   "filePath": "application.main.runtime.ts",
-                  "line": 311,
+                  "line": 328,
                   "character": 6
                 },
                 "name": "Promise",
@@ -8295,7 +8440,7 @@
                     "__schema": "TypeLiteralSchema",
                     "location": {
                       "filePath": "application.main.runtime.ts",
-                      "line": 311,
+                      "line": 328,
                       "character": 14
                     },
                     "members": [
@@ -8303,7 +8448,7 @@
                         "__schema": "VariableLikeSchema",
                         "location": {
                           "filePath": "application.main.runtime.ts",
-                          "line": 312,
+                          "line": 329,
                           "character": 5
                         },
                         "signature": "(property) app: Application",
@@ -8312,7 +8457,7 @@
                           "__schema": "TypeRefSchema",
                           "location": {
                             "filePath": "application.main.runtime.ts",
-                            "line": 312,
+                            "line": 329,
                             "character": 5
                           },
                           "name": "Application"
@@ -8323,7 +8468,7 @@
                         "__schema": "VariableLikeSchema",
                         "location": {
                           "filePath": "application.main.runtime.ts",
-                          "line": 313,
+                          "line": 330,
                           "character": 5
                         },
                         "signature": "(property) port: number | undefined",
@@ -8332,7 +8477,7 @@
                           "__schema": "TypeUnionSchema",
                           "location": {
                             "filePath": "application.main.runtime.ts",
-                            "line": 313,
+                            "line": 330,
                             "character": 11
                           },
                           "types": [
@@ -8340,7 +8485,7 @@
                               "__schema": "KeywordTypeSchema",
                               "location": {
                                 "filePath": "application.main.runtime.ts",
-                                "line": 313,
+                                "line": 330,
                                 "character": 11
                               },
                               "name": "number"
@@ -8349,7 +8494,7 @@
                               "__schema": "KeywordTypeSchema",
                               "location": {
                                 "filePath": "application.main.runtime.ts",
-                                "line": 313,
+                                "line": 330,
                                 "character": 20
                               },
                               "name": "undefined"
@@ -8362,7 +8507,7 @@
                         "__schema": "VariableLikeSchema",
                         "location": {
                           "filePath": "application.main.runtime.ts",
-                          "line": 314,
+                          "line": 331,
                           "character": 5
                         },
                         "signature": "(property) errors?: Error[] | undefined",
@@ -8371,14 +8516,14 @@
                           "__schema": "TypeArraySchema",
                           "location": {
                             "filePath": "application.main.runtime.ts",
-                            "line": 314,
+                            "line": 331,
                             "character": 14
                           },
                           "type": {
                             "__schema": "TypeRefSchema",
                             "location": {
                               "filePath": "application.main.runtime.ts",
-                              "line": 314,
+                              "line": 331,
                               "character": 14
                             },
                             "name": "Error"
@@ -8390,7 +8535,7 @@
                         "__schema": "VariableLikeSchema",
                         "location": {
                           "filePath": "application.main.runtime.ts",
-                          "line": 315,
+                          "line": 332,
                           "character": 5
                         },
                         "signature": "(property) isOldApi: boolean",
@@ -8399,7 +8544,7 @@
                           "__schema": "KeywordTypeSchema",
                           "location": {
                             "filePath": "application.main.runtime.ts",
-                            "line": 315,
+                            "line": 332,
                             "character": 15
                           },
                           "name": "boolean"
@@ -8418,18 +8563,19 @@
               "__schema": "FunctionLikeSchema",
               "location": {
                 "filePath": "application.main.runtime.ts",
-                "line": 344,
+                "line": 361,
                 "character": 3
               },
               "doc": {
                 "__schema": "DocSchema",
                 "location": {
                   "filePath": "application.main.runtime.ts",
-                  "line": 341,
+                  "line": 358,
                   "character": 3
                 },
                 "raw": "/**\n   * get the component ID of a certain app.\n   */",
-                "comment": "get the component ID of a certain app."
+                "comment": "get the component ID of a certain app.",
+                "tags": []
               },
               "signature": "(method) ApplicationMain.getAppIdOrThrow(appName: string): Promise<ComponentID>",
               "name": "getAppIdOrThrow",
@@ -8438,7 +8584,7 @@
                   "__schema": "ParameterSchema",
                   "location": {
                     "filePath": "application.main.runtime.ts",
-                    "line": 344,
+                    "line": 361,
                     "character": 25
                   },
                   "name": "appName",
@@ -8446,7 +8592,7 @@
                     "__schema": "KeywordTypeSchema",
                     "location": {
                       "filePath": "application.main.runtime.ts",
-                      "line": 344,
+                      "line": 361,
                       "character": 34
                     },
                     "name": "string"
@@ -8459,7 +8605,7 @@
                 "__schema": "InferenceTypeSchema",
                 "location": {
                   "filePath": "application.main.runtime.ts",
-                  "line": 344,
+                  "line": 361,
                   "character": 3
                 },
                 "type": "Promise<ComponentID>"
@@ -8472,7 +8618,7 @@
               "__schema": "FunctionLikeSchema",
               "location": {
                 "filePath": "application.main.runtime.ts",
-                "line": 384,
+                "line": 401,
                 "character": 3
               },
               "signature": "(method) ApplicationMain.createAppBuildContext(id: ComponentID, appName: string, capsuleRootDir: string, rootDir?: string): Promise<AppContext>",
@@ -8482,7 +8628,7 @@
                   "__schema": "ParameterSchema",
                   "location": {
                     "filePath": "application.main.runtime.ts",
-                    "line": 384,
+                    "line": 401,
                     "character": 31
                   },
                   "name": "id",
@@ -8490,7 +8636,7 @@
                     "__schema": "TypeRefSchema",
                     "location": {
                       "filePath": "application.main.runtime.ts",
-                      "line": 384,
+                      "line": 401,
                       "character": 35
                     },
                     "name": "ComponentID",
@@ -8506,7 +8652,7 @@
                   "__schema": "ParameterSchema",
                   "location": {
                     "filePath": "application.main.runtime.ts",
-                    "line": 384,
+                    "line": 401,
                     "character": 48
                   },
                   "name": "appName",
@@ -8514,7 +8660,7 @@
                     "__schema": "KeywordTypeSchema",
                     "location": {
                       "filePath": "application.main.runtime.ts",
-                      "line": 384,
+                      "line": 401,
                       "character": 57
                     },
                     "name": "string"
@@ -8526,7 +8672,7 @@
                   "__schema": "ParameterSchema",
                   "location": {
                     "filePath": "application.main.runtime.ts",
-                    "line": 384,
+                    "line": 401,
                     "character": 65
                   },
                   "name": "capsuleRootDir",
@@ -8534,7 +8680,7 @@
                     "__schema": "KeywordTypeSchema",
                     "location": {
                       "filePath": "application.main.runtime.ts",
-                      "line": 384,
+                      "line": 401,
                       "character": 81
                     },
                     "name": "string"
@@ -8546,7 +8692,7 @@
                   "__schema": "ParameterSchema",
                   "location": {
                     "filePath": "application.main.runtime.ts",
-                    "line": 384,
+                    "line": 401,
                     "character": 89
                   },
                   "name": "rootDir",
@@ -8554,7 +8700,7 @@
                     "__schema": "KeywordTypeSchema",
                     "location": {
                       "filePath": "application.main.runtime.ts",
-                      "line": 384,
+                      "line": 401,
                       "character": 99
                     },
                     "name": "string"
@@ -8567,7 +8713,7 @@
                 "__schema": "InferenceTypeSchema",
                 "location": {
                   "filePath": "application.main.runtime.ts",
-                  "line": 384,
+                  "line": 401,
                   "character": 3
                 },
                 "type": "Promise<AppContext>"
@@ -8580,7 +8726,7 @@
               "__schema": "VariableLikeSchema",
               "location": {
                 "filePath": "application.main.runtime.ts",
-                "line": 410,
+                "line": 427,
                 "character": 3
               },
               "signature": "(property) ApplicationMain.runtime: RuntimeDefinition",
@@ -8589,7 +8735,7 @@
                 "__schema": "InferenceTypeSchema",
                 "location": {
                   "filePath": "application.main.runtime.ts",
-                  "line": 410,
+                  "line": 427,
                   "character": 3
                 },
                 "type": "RuntimeDefinition"
@@ -8601,7 +8747,7 @@
               "__schema": "VariableLikeSchema",
               "location": {
                 "filePath": "application.main.runtime.ts",
-                "line": 411,
+                "line": 428,
                 "character": 3
               },
               "signature": "(property) ApplicationMain.dependencies: Aspect[]",
@@ -8610,7 +8756,7 @@
                 "__schema": "InferenceTypeSchema",
                 "location": {
                   "filePath": "application.main.runtime.ts",
-                  "line": 411,
+                  "line": 428,
                   "character": 3
                 },
                 "type": "Aspect[]"
@@ -8622,7 +8768,7 @@
               "__schema": "VariableLikeSchema",
               "location": {
                 "filePath": "application.main.runtime.ts",
-                "line": 423,
+                "line": 440,
                 "character": 3
               },
               "signature": "(property) ApplicationMain.slots: (((registerFn: () => string) => SlotRegistry<ApplicationType<unknown>[]>) | ((registerFn: () => string) => SlotRegistry<Application[]>) | ((registerFn: () => string) => SlotRegistry<...>))[]",
@@ -8631,7 +8777,7 @@
                 "__schema": "InferenceTypeSchema",
                 "location": {
                   "filePath": "application.main.runtime.ts",
-                  "line": 423,
+                  "line": 440,
                   "character": 3
                 },
                 "type": "(((registerFn: () => string) => SlotRegistry<ApplicationType<unknown>[]>) | ((registerFn: () => string) => SlotRegistry<Application[]>) | ((registerFn: () => string) => SlotRegistry<...>))[]"
@@ -8643,7 +8789,7 @@
               "__schema": "FunctionLikeSchema",
               "location": {
                 "filePath": "application.main.runtime.ts",
-                "line": 429,
+                "line": 446,
                 "character": 3
               },
               "signature": "(method) ApplicationMain.provider([cli, loggerAspect, builder, envs, component, aspectLoader, workspace, watcher, scope]: [\n    CLIMain,\n    LoggerMain,\n    BuilderMain,\n    EnvsMain,\n    ComponentMain,\n    AspectLoaderMain,\n    Workspace,\n    WatcherMain,\n    ScopeMain\n], config: ApplicationAspectConfig, [appTypeSlot, appSlot, deploymentProviderSlot]: [ApplicationTypeSlot, ApplicationSlot, DeploymentProviderSlot], harmony: Harmony): Promise<ApplicationMain>",
@@ -8653,7 +8799,7 @@
                   "__schema": "ParameterSchema",
                   "location": {
                     "filePath": "application.main.runtime.ts",
-                    "line": 430,
+                    "line": 447,
                     "character": 5
                   },
                   "name": "[ cli, loggerAspect, builder, envs, component, aspectLoader, workspace, watcher, scope ]",
@@ -8661,7 +8807,7 @@
                     "__schema": "TupleTypeSchema",
                     "location": {
                       "filePath": "application.main.runtime.ts",
-                      "line": 430,
+                      "line": 447,
                       "character": 93
                     },
                     "elements": [
@@ -8669,7 +8815,7 @@
                         "__schema": "TypeRefSchema",
                         "location": {
                           "filePath": "application.main.runtime.ts",
-                          "line": 431,
+                          "line": 448,
                           "character": 7
                         },
                         "name": "CLIMain",
@@ -8682,7 +8828,7 @@
                         "__schema": "TypeRefSchema",
                         "location": {
                           "filePath": "application.main.runtime.ts",
-                          "line": 432,
+                          "line": 449,
                           "character": 7
                         },
                         "name": "LoggerMain",
@@ -8695,7 +8841,7 @@
                         "__schema": "TypeRefSchema",
                         "location": {
                           "filePath": "application.main.runtime.ts",
-                          "line": 433,
+                          "line": 450,
                           "character": 7
                         },
                         "name": "BuilderMain",
@@ -8708,7 +8854,7 @@
                         "__schema": "TypeRefSchema",
                         "location": {
                           "filePath": "application.main.runtime.ts",
-                          "line": 434,
+                          "line": 451,
                           "character": 7
                         },
                         "name": "EnvsMain",
@@ -8721,7 +8867,7 @@
                         "__schema": "TypeRefSchema",
                         "location": {
                           "filePath": "application.main.runtime.ts",
-                          "line": 435,
+                          "line": 452,
                           "character": 7
                         },
                         "name": "ComponentMain",
@@ -8734,7 +8880,7 @@
                         "__schema": "TypeRefSchema",
                         "location": {
                           "filePath": "application.main.runtime.ts",
-                          "line": 436,
+                          "line": 453,
                           "character": 7
                         },
                         "name": "AspectLoaderMain",
@@ -8747,7 +8893,7 @@
                         "__schema": "TypeRefSchema",
                         "location": {
                           "filePath": "application.main.runtime.ts",
-                          "line": 437,
+                          "line": 454,
                           "character": 7
                         },
                         "name": "Workspace",
@@ -8760,7 +8906,7 @@
                         "__schema": "TypeRefSchema",
                         "location": {
                           "filePath": "application.main.runtime.ts",
-                          "line": 438,
+                          "line": 455,
                           "character": 7
                         },
                         "name": "WatcherMain",
@@ -8773,7 +8919,7 @@
                         "__schema": "TypeRefSchema",
                         "location": {
                           "filePath": "application.main.runtime.ts",
-                          "line": 439,
+                          "line": 456,
                           "character": 7
                         },
                         "name": "ScopeMain",
@@ -8791,7 +8937,7 @@
                   "__schema": "ParameterSchema",
                   "location": {
                     "filePath": "application.main.runtime.ts",
-                    "line": 441,
+                    "line": 458,
                     "character": 5
                   },
                   "name": "config",
@@ -8799,7 +8945,7 @@
                     "__schema": "TypeRefSchema",
                     "location": {
                       "filePath": "application.main.runtime.ts",
-                      "line": 441,
+                      "line": 458,
                       "character": 13
                     },
                     "name": "ApplicationAspectConfig",
@@ -8812,7 +8958,7 @@
                   "__schema": "ParameterSchema",
                   "location": {
                     "filePath": "application.main.runtime.ts",
-                    "line": 442,
+                    "line": 459,
                     "character": 5
                   },
                   "name": "[ appTypeSlot, appSlot, deploymentProviderSlot ]",
@@ -8820,7 +8966,7 @@
                     "__schema": "TupleTypeSchema",
                     "location": {
                       "filePath": "application.main.runtime.ts",
-                      "line": 442,
+                      "line": 459,
                       "character": 53
                     },
                     "elements": [
@@ -8828,7 +8974,7 @@
                         "__schema": "TypeRefSchema",
                         "location": {
                           "filePath": "application.main.runtime.ts",
-                          "line": 442,
+                          "line": 459,
                           "character": 54
                         },
                         "name": "ApplicationTypeSlot",
@@ -8838,7 +8984,7 @@
                         "__schema": "TypeRefSchema",
                         "location": {
                           "filePath": "application.main.runtime.ts",
-                          "line": 442,
+                          "line": 459,
                           "character": 75
                         },
                         "name": "ApplicationSlot",
@@ -8848,7 +8994,7 @@
                         "__schema": "TypeRefSchema",
                         "location": {
                           "filePath": "application.main.runtime.ts",
-                          "line": 442,
+                          "line": 459,
                           "character": 92
                         },
                         "name": "DeploymentProviderSlot",
@@ -8863,7 +9009,7 @@
                   "__schema": "ParameterSchema",
                   "location": {
                     "filePath": "application.main.runtime.ts",
-                    "line": 443,
+                    "line": 460,
                     "character": 5
                   },
                   "name": "harmony",
@@ -8871,7 +9017,7 @@
                     "__schema": "TypeRefSchema",
                     "location": {
                       "filePath": "application.main.runtime.ts",
-                      "line": 443,
+                      "line": 460,
                       "character": 14
                     },
                     "name": "Harmony",
@@ -8889,7 +9035,7 @@
                 "__schema": "InferenceTypeSchema",
                 "location": {
                   "filePath": "application.main.runtime.ts",
-                  "line": 429,
+                  "line": 446,
                   "character": 3
                 },
                 "type": "Promise<ApplicationMain>"
@@ -8909,7 +9055,7 @@
           "__schema": "UnImplementedSchema",
           "location": {
             "filePath": "application.main.runtime.ts",
-            "line": 493,
+            "line": 510,
             "character": 1
           },
           "name": "ApplicationAspect.addRuntime(ApplicationMain);",
@@ -9206,7 +9352,8 @@
                   "character": 3
                 },
                 "raw": "/**\n   * return a logger instance for the env.\n   */",
-                "comment": "return a logger instance for the env."
+                "comment": "return a logger instance for the env.",
+                "tags": []
               },
               "signature": "(method) AppContext.createLogger(name?: string): Logger",
               "name": "createLogger",
@@ -9262,7 +9409,8 @@
                   "character": 3
                 },
                 "raw": "/**\n   * get an instance of an aspect.\n   * make sure it is loaded prior to requesting it.\n   */",
-                "comment": "get an instance of an aspect.\nmake sure it is loaded prior to requesting it."
+                "comment": "get an instance of an aspect.\nmake sure it is loaded prior to requesting it.",
+                "tags": []
               },
               "signature": "(method) AppContext.getAspect<T>(aspectId: string): T | undefined",
               "name": "getAspect",
@@ -9419,7 +9567,7 @@
                   "_legacy": {
                     "scope": "teambit.harmony",
                     "name": "application",
-                    "version": "1.0.310"
+                    "version": "1.0.312"
                   },
                   "_scope": "teambit.harmony"
                 }
@@ -10010,7 +10158,7 @@
                         "_legacy": {
                           "scope": "teambit.harmony",
                           "name": "application",
-                          "version": "1.0.310"
+                          "version": "1.0.312"
                         },
                         "_scope": "teambit.harmony"
                       }
@@ -10338,7 +10486,8 @@
                         "character": 3
                       },
                       "raw": "/**\n   * return a logger instance for the env.\n   */",
-                      "comment": "return a logger instance for the env."
+                      "comment": "return a logger instance for the env.",
+                      "tags": []
                     },
                     "signature": "(method) AppContext.createLogger(name?: string): Logger"
                   },
@@ -10412,7 +10561,8 @@
                         "character": 3
                       },
                       "raw": "/**\n   * get an instance of an aspect.\n   * make sure it is loaded prior to requesting it.\n   */",
-                      "comment": "get an instance of an aspect.\nmake sure it is loaded prior to requesting it."
+                      "comment": "get an instance of an aspect.\nmake sure it is loaded prior to requesting it.",
+                      "tags": []
                     },
                     "signature": "(method) AppContext.getAspect<T>(aspectId: string): T | undefined"
                   },
@@ -10517,7 +10667,7 @@
                   "_legacy": {
                     "scope": "teambit.harmony",
                     "name": "application",
-                    "version": "1.0.310"
+                    "version": "1.0.312"
                   },
                   "_scope": "teambit.harmony"
                 }
@@ -10728,7 +10878,7 @@
                               "_legacy": {
                                 "scope": "teambit.harmony",
                                 "name": "application",
-                                "version": "1.0.310"
+                                "version": "1.0.312"
                               },
                               "_scope": "teambit.harmony"
                             }
@@ -11056,7 +11206,8 @@
                               "character": 3
                             },
                             "raw": "/**\n   * return a logger instance for the env.\n   */",
-                            "comment": "return a logger instance for the env."
+                            "comment": "return a logger instance for the env.",
+                            "tags": []
                           },
                           "signature": "(method) AppContext.createLogger(name?: string): Logger"
                         },
@@ -11130,7 +11281,8 @@
                               "character": 3
                             },
                             "raw": "/**\n   * get an instance of an aspect.\n   * make sure it is loaded prior to requesting it.\n   */",
-                            "comment": "get an instance of an aspect.\nmake sure it is loaded prior to requesting it."
+                            "comment": "get an instance of an aspect.\nmake sure it is loaded prior to requesting it.",
+                            "tags": []
                           },
                           "signature": "(method) AppContext.getAspect<T>(aspectId: string): T | undefined"
                         },
@@ -11235,7 +11387,7 @@
                         "_legacy": {
                           "scope": "teambit.harmony",
                           "name": "application",
-                          "version": "1.0.310"
+                          "version": "1.0.312"
                         },
                         "_scope": "teambit.harmony"
                       }
@@ -11701,7 +11853,8 @@
                   "character": 3
                 },
                 "raw": "/**\n   * errors thrown during the build process.\n   */",
-                "comment": "errors thrown during the build process."
+                "comment": "errors thrown during the build process.",
+                "tags": []
               },
               "signature": "(property) AppBuildResult.errors?: Error[] | undefined",
               "name": "errors",
@@ -11739,7 +11892,8 @@
                   "character": 3
                 },
                 "raw": "/**\n   * warnings thrown during the build process.\n   */",
-                "comment": "warnings thrown during the build process."
+                "comment": "warnings thrown during the build process.",
+                "tags": []
               },
               "signature": "(property) AppBuildResult.warnings?: string[] | undefined",
               "name": "warnings",
@@ -11777,7 +11931,8 @@
                   "character": 3
                 },
                 "raw": "/**\n   * metadata to persist.\n   * this is the only property that actually gets saved into the objects (in builder aspect, aspectsData.buildDeployContexts[deployContext]).\n   * in some scenarios, the build and deploy pipelines run in different processes, and then the only data the deploy\n   * gets is what saved into the objects.\n   * examples of data that gets save here:\n   * React: { publicDir, ssrPublicDir }.\n   * Node: { mainFile, artifactsDir }.\n   */",
-                "comment": "metadata to persist.\nthis is the only property that actually gets saved into the objects (in builder aspect, aspectsData.buildDeployContexts[deployContext]).\nin some scenarios, the build and deploy pipelines run in different processes, and then the only data the deploy\ngets is what saved into the objects.\nexamples of data that gets save here:\nReact: { publicDir, ssrPublicDir }.\nNode: { mainFile, artifactsDir }."
+                "comment": "metadata to persist.\nthis is the only property that actually gets saved into the objects (in builder aspect, aspectsData.buildDeployContexts[deployContext]).\nin some scenarios, the build and deploy pipelines run in different processes, and then the only data the deploy\ngets is what saved into the objects.\nexamples of data that gets save here:\nReact: { publicDir, ssrPublicDir }.\nNode: { mainFile, artifactsDir }.",
+                "tags": []
               },
               "signature": "(property) AppBuildResult.metadata?: Record<string, any> | undefined",
               "name": "metadata",
@@ -11851,7 +12006,8 @@
                   "character": 3
                 },
                 "raw": "/**\n   * return a template list instance.\n   */",
-                "comment": "return a template list instance."
+                "comment": "return a template list instance.",
+                "tags": []
               },
               "signature": "(method) AppsEnv.apps?(): EnvHandler<AppTypeList>",
               "name": "apps",
@@ -12232,7 +12388,7 @@
   "componentId": {
     "scope": "teambit.harmony",
     "name": "application",
-    "version": "1.0.310"
+    "version": "1.0.312"
   },
   "taggedModuleExports": []
 }