@ankhorage/runtime 5.0.6 → 5.1.0

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 (38) hide show
  1. package/CHANGELOG.md +12 -0
  2. package/README.md +1 -1
  3. package/dist/ManifestContext.d.ts +7 -3
  4. package/dist/ManifestContext.d.ts.map +1 -1
  5. package/dist/ManifestContext.js +9 -2
  6. package/dist/ManifestContext.js.map +1 -1
  7. package/dist/RuntimeRenderer.d.ts.map +1 -1
  8. package/dist/RuntimeRenderer.js +36 -26
  9. package/dist/RuntimeRenderer.js.map +1 -1
  10. package/dist/RuntimeScreen.d.ts.map +1 -1
  11. package/dist/RuntimeScreen.js +6 -3
  12. package/dist/RuntimeScreen.js.map +1 -1
  13. package/dist/capabilities/index.d.ts +47 -0
  14. package/dist/capabilities/index.d.ts.map +1 -1
  15. package/dist/capabilities/index.js +34 -0
  16. package/dist/capabilities/index.js.map +1 -1
  17. package/dist/runtimeCapabilityExecutor.d.ts +3 -1
  18. package/dist/runtimeCapabilityExecutor.d.ts.map +1 -1
  19. package/dist/runtimeCapabilityExecutor.js +91 -2
  20. package/dist/runtimeCapabilityExecutor.js.map +1 -1
  21. package/dist/runtimeStateAdapter.d.ts.map +1 -1
  22. package/dist/runtimeStateAdapter.js +25 -13
  23. package/dist/runtimeStateAdapter.js.map +1 -1
  24. package/dist/useRuntimeStateBindings.d.ts +9 -0
  25. package/dist/useRuntimeStateBindings.d.ts.map +1 -0
  26. package/dist/useRuntimeStateBindings.js +50 -0
  27. package/dist/useRuntimeStateBindings.js.map +1 -0
  28. package/package.json +70 -3
  29. package/paradox/badges/npm.svg +3 -3
  30. package/paradox/components.md +8 -5
  31. package/paradox/diagrams/architecture-overview.mmd +13 -0
  32. package/paradox/diagrams/export-graph.mmd +2 -0
  33. package/paradox/diagrams/module-relationships.mmd +11 -0
  34. package/paradox/diagrams/sequences/runtime-screen.mmd +5 -0
  35. package/paradox/exports.json +25 -18
  36. package/paradox/exports.md +23 -14
  37. package/paradox/index.html +259 -92
  38. package/paradox/paradox.json +534 -99
@@ -3,12 +3,17 @@ sequenceDiagram
3
3
  participant participant_createRuntimeScreenOperationLoaderRequestLifecycle as createRuntimeScreenOperationLoaderRequestLifecycle
4
4
  participant participant_RuntimeScreen as RuntimeScreen
5
5
  participant participant_use as use
6
+ participant participant_useOptionalManifestContext as useOptionalManifestContext
6
7
  participant participant_useRuntimeRendererConfig as useRuntimeRendererConfig
7
8
  participant participant_useRuntimeScreenOperationLoaders as useRuntimeScreenOperationLoaders
8
9
  participant_RuntimeScreen->>participant_useRuntimeRendererConfig: useRuntimeRendererConfig()
9
10
  participant_useRuntimeRendererConfig->>participant_use: use()
10
11
  participant_use-->>participant_useRuntimeRendererConfig: return
11
12
  participant_useRuntimeRendererConfig-->>participant_RuntimeScreen: return
13
+ participant_RuntimeScreen->>participant_useOptionalManifestContext: useOptionalManifestContext()
14
+ participant_useOptionalManifestContext->>participant_use: use()
15
+ participant_use-->>participant_useOptionalManifestContext: return
16
+ participant_useOptionalManifestContext-->>participant_RuntimeScreen: return
12
17
  participant_RuntimeScreen->>participant_useRuntimeScreenOperationLoaders: useRuntimeScreenOperationLoaders()
13
18
  participant_useRuntimeScreenOperationLoaders->>participant_createRuntimeScreenOperationLoaderRequestLifecycle: createRuntimeScreenOperationLoaderRequestLifecycle()
14
19
  participant_createRuntimeScreenOperationLoaderRequestLifecycle-->>participant_useRuntimeScreenOperationLoaders: return
@@ -66,7 +66,7 @@
66
66
  {
67
67
  "name": "composeRuntimeCapabilityExecutor",
68
68
  "title": null,
69
- "description": "Routes manifest-owned API capabilities before delegating application-owned capabilities.",
69
+ "description": "Routes API and state capabilities before delegating application-owned capabilities.",
70
70
  "isReadme": false,
71
71
  "see": [],
72
72
  "security": [],
@@ -74,7 +74,7 @@
74
74
  "modulePath": "src/runtimeCapabilityExecutor.ts",
75
75
  "sourceLocation": {
76
76
  "filePath": "src/runtimeCapabilityExecutor.ts",
77
- "line": 13,
77
+ "line": 17,
78
78
  "column": 1
79
79
  },
80
80
  "exportPaths": [
@@ -472,7 +472,7 @@
472
472
  "modulePath": "src/runtimeStateAdapter.ts",
473
473
  "sourceLocation": {
474
474
  "filePath": "src/runtimeStateAdapter.ts",
475
- "line": 18,
475
+ "line": 22,
476
476
  "column": 1
477
477
  },
478
478
  "exportPaths": [
@@ -810,7 +810,7 @@
810
810
  "modulePath": "src/ManifestContext.tsx",
811
811
  "sourceLocation": {
812
812
  "filePath": "src/ManifestContext.tsx",
813
- "line": 10,
813
+ "line": 13,
814
814
  "column": 14
815
815
  },
816
816
  "exportPaths": [
@@ -824,7 +824,7 @@
824
824
  {
825
825
  "name": "ManifestProvider",
826
826
  "title": null,
827
- "description": null,
827
+ "description": "Owns one configured state adapter for every Runtime screen in an application tree.",
828
828
  "isReadme": false,
829
829
  "see": [],
830
830
  "security": [],
@@ -832,7 +832,7 @@
832
832
  "modulePath": "src/ManifestContext.tsx",
833
833
  "sourceLocation": {
834
834
  "filePath": "src/ManifestContext.tsx",
835
- "line": 12,
835
+ "line": 16,
836
836
  "column": 1
837
837
  },
838
838
  "exportPaths": [
@@ -2122,7 +2122,7 @@
2122
2122
  "modulePath": "src/runtimeCapabilityExecutor.ts",
2123
2123
  "sourceLocation": {
2124
2124
  "filePath": "src/runtimeCapabilityExecutor.ts",
2125
- "line": 7,
2125
+ "line": 10,
2126
2126
  "column": 1
2127
2127
  },
2128
2128
  "exportPaths": [
@@ -2146,6 +2146,13 @@
2146
2146
  "type": "RuntimeCapabilityExecutor | undefined",
2147
2147
  "required": false,
2148
2148
  "description": null
2149
+ },
2150
+ {
2151
+ "name": "stateAdapter",
2152
+ "kind": "property",
2153
+ "type": "StateAdapter | undefined",
2154
+ "required": false,
2155
+ "description": null
2149
2156
  }
2150
2157
  ],
2151
2158
  "structuredRows": []
@@ -2890,7 +2897,7 @@
2890
2897
  "modulePath": "src/runtimeStateAdapter.ts",
2891
2898
  "sourceLocation": {
2892
2899
  "filePath": "src/runtimeStateAdapter.ts",
2893
- "line": 14,
2900
+ "line": 18,
2894
2901
  "column": 1
2895
2902
  },
2896
2903
  "exportPaths": [
@@ -2942,7 +2949,7 @@
2942
2949
  "modulePath": "src/RuntimeRenderer.tsx",
2943
2950
  "sourceLocation": {
2944
2951
  "filePath": "src/RuntimeRenderer.tsx",
2945
- "line": 73,
2952
+ "line": 74,
2946
2953
  "column": 1
2947
2954
  },
2948
2955
  "exportPaths": [
@@ -3176,7 +3183,7 @@
3176
3183
  "modulePath": "src/RuntimeRenderer.tsx",
3177
3184
  "sourceLocation": {
3178
3185
  "filePath": "src/RuntimeRenderer.tsx",
3179
- "line": 54,
3186
+ "line": 55,
3180
3187
  "column": 1
3181
3188
  },
3182
3189
  "exportPaths": [
@@ -3419,7 +3426,7 @@
3419
3426
  "modulePath": "src/RuntimeScreen.tsx",
3420
3427
  "sourceLocation": {
3421
3428
  "filePath": "src/RuntimeScreen.tsx",
3422
- "line": 19,
3429
+ "line": 20,
3423
3430
  "column": 1
3424
3431
  },
3425
3432
  "exportPaths": [
@@ -3552,7 +3559,7 @@
3552
3559
  "modulePath": "src/RuntimeScreen.tsx",
3553
3560
  "sourceLocation": {
3554
3561
  "filePath": "src/RuntimeScreen.tsx",
3555
- "line": 12,
3562
+ "line": 13,
3556
3563
  "column": 1
3557
3564
  },
3558
3565
  "exportPaths": [
@@ -3631,7 +3638,7 @@
3631
3638
  {
3632
3639
  "name": "useManifest",
3633
3640
  "title": null,
3634
- "description": null,
3641
+ "description": "Returns the active application manifest from the owning Runtime provider.",
3635
3642
  "isReadme": false,
3636
3643
  "see": [],
3637
3644
  "security": [],
@@ -3639,7 +3646,7 @@
3639
3646
  "modulePath": "src/ManifestContext.tsx",
3640
3647
  "sourceLocation": {
3641
3648
  "filePath": "src/ManifestContext.tsx",
3642
- "line": 22,
3649
+ "line": 38,
3643
3650
  "column": 1
3644
3651
  },
3645
3652
  "exportPaths": [
@@ -3660,7 +3667,7 @@
3660
3667
  {
3661
3668
  "name": "useManifestContext",
3662
3669
  "title": null,
3663
- "description": null,
3670
+ "description": "Returns the active manifest scope, including its application-lifetime state adapter.",
3664
3671
  "isReadme": false,
3665
3672
  "see": [],
3666
3673
  "security": [],
@@ -3668,7 +3675,7 @@
3668
3675
  "modulePath": "src/ManifestContext.tsx",
3669
3676
  "sourceLocation": {
3670
3677
  "filePath": "src/ManifestContext.tsx",
3671
- "line": 30,
3678
+ "line": 47,
3672
3679
  "column": 1
3673
3680
  },
3674
3681
  "exportPaths": [
@@ -3689,7 +3696,7 @@
3689
3696
  {
3690
3697
  "name": "useOptionalManifestContext",
3691
3698
  "title": null,
3692
- "description": null,
3699
+ "description": "Reads an enclosing manifest scope without requiring hosts to provide one.",
3693
3700
  "isReadme": false,
3694
3701
  "see": [],
3695
3702
  "security": [],
@@ -3697,7 +3704,7 @@
3697
3704
  "modulePath": "src/ManifestContext.tsx",
3698
3705
  "sourceLocation": {
3699
3706
  "filePath": "src/ManifestContext.tsx",
3700
- "line": 38,
3707
+ "line": 56,
3701
3708
  "column": 1
3702
3709
  },
3703
3710
  "exportPaths": [
@@ -25,9 +25,9 @@ Source: `src/componentRegistry.ts:3:1`
25
25
 
26
26
  Kind: `function`
27
27
  Module: `src/runtimeCapabilityExecutor.ts`
28
- Source: `src/runtimeCapabilityExecutor.ts:13:1`
28
+ Source: `src/runtimeCapabilityExecutor.ts:17:1`
29
29
 
30
- Routes manifest-owned API capabilities before delegating application-owned capabilities.
30
+ Routes API and state capabilities before delegating application-owned capabilities.
31
31
 
32
32
  ### Signatures
33
33
 
@@ -158,7 +158,7 @@ Source: `src/runtimeEventOperationLifecycle.ts:40:1`
158
158
 
159
159
  Kind: `function`
160
160
  Module: `src/runtimeStateAdapter.ts`
161
- Source: `src/runtimeStateAdapter.ts:18:1`
161
+ Source: `src/runtimeStateAdapter.ts:22:1`
162
162
 
163
163
  ### Signatures
164
164
 
@@ -274,13 +274,15 @@ Determines whether a dot-separated path is exposed by a capability output schema
274
274
 
275
275
  Kind: `value`
276
276
  Module: `src/ManifestContext.tsx`
277
- Source: `src/ManifestContext.tsx:10:14`
277
+ Source: `src/ManifestContext.tsx:13:14`
278
278
 
279
279
  ## ManifestProvider
280
280
 
281
281
  Kind: `function`
282
282
  Module: `src/ManifestContext.tsx`
283
- Source: `src/ManifestContext.tsx:12:1`
283
+ Source: `src/ManifestContext.tsx:16:1`
284
+
285
+ Owns one configured state adapter for every Runtime screen in an application tree.
284
286
 
285
287
  ### Signatures
286
288
 
@@ -676,7 +678,7 @@ Source: `src/runtimeBindings.ts:36:1`
676
678
 
677
679
  Kind: `type`
678
680
  Module: `src/runtimeCapabilityExecutor.ts`
679
- Source: `src/runtimeCapabilityExecutor.ts:7:1`
681
+ Source: `src/runtimeCapabilityExecutor.ts:10:1`
680
682
 
681
683
  ### Members
682
684
 
@@ -684,6 +686,7 @@ Source: `src/runtimeCapabilityExecutor.ts:7:1`
684
686
  | --- | --- | --- | --- | --- |
685
687
  | apiCapabilityExecutor | property | `RuntimeCapabilityExecutor` | yes | |
686
688
  | capabilityExecutor | property | `RuntimeCapabilityExecutor \| undefined` | no | |
689
+ | stateAdapter | property | `StateAdapter \| undefined` | no | |
687
690
 
688
691
  ## RuntimeComponentEventDispatchArgs
689
692
 
@@ -889,7 +892,7 @@ Source: `src/runtimeMedia.ts:9:1`
889
892
 
890
893
  Kind: `type`
891
894
  Module: `src/runtimeStateAdapter.ts`
892
- Source: `src/runtimeStateAdapter.ts:14:1`
895
+ Source: `src/runtimeStateAdapter.ts:18:1`
893
896
 
894
897
  ### Members
895
898
 
@@ -907,7 +910,7 @@ Source: `node_modules/@ankhorage/contracts/dist/runtimeCallbacks.d.ts:6:1`
907
910
 
908
911
  Kind: `function`
909
912
  Module: `src/RuntimeRenderer.tsx`
910
- Source: `src/RuntimeRenderer.tsx:73:1`
913
+ Source: `src/RuntimeRenderer.tsx:74:1`
911
914
 
912
915
  ### Signatures
913
916
 
@@ -960,7 +963,7 @@ Source: `src/RuntimeRendererConfig.tsx:139:1`
960
963
 
961
964
  Kind: `type`
962
965
  Module: `src/RuntimeRenderer.tsx`
963
- Source: `src/RuntimeRenderer.tsx:54:1`
966
+ Source: `src/RuntimeRenderer.tsx:55:1`
964
967
 
965
968
  ### Members
966
969
 
@@ -1020,7 +1023,7 @@ Source: `node_modules/@ankhorage/contracts/dist/runtimeCallbacks.d.ts:2:1`
1020
1023
 
1021
1024
  Kind: `function`
1022
1025
  Module: `src/RuntimeScreen.tsx`
1023
- Source: `src/RuntimeScreen.tsx:19:1`
1026
+ Source: `src/RuntimeScreen.tsx:20:1`
1024
1027
 
1025
1028
  ### Signatures
1026
1029
 
@@ -1061,7 +1064,7 @@ Source: `src/runtimeScreenLoaders.ts:17:1`
1061
1064
 
1062
1065
  Kind: `type`
1063
1066
  Module: `src/RuntimeScreen.tsx`
1064
- Source: `src/RuntimeScreen.tsx:12:1`
1067
+ Source: `src/RuntimeScreen.tsx:13:1`
1065
1068
 
1066
1069
  ### Members
1067
1070
 
@@ -1088,7 +1091,9 @@ Source: `src/runtimeRepeatEmptyState.ts:3:1`
1088
1091
 
1089
1092
  Kind: `function`
1090
1093
  Module: `src/ManifestContext.tsx`
1091
- Source: `src/ManifestContext.tsx:22:1`
1094
+ Source: `src/ManifestContext.tsx:38:1`
1095
+
1096
+ Returns the active application manifest from the owning Runtime provider.
1092
1097
 
1093
1098
  ### Signatures
1094
1099
 
@@ -1099,7 +1104,9 @@ Source: `src/ManifestContext.tsx:22:1`
1099
1104
 
1100
1105
  Kind: `function`
1101
1106
  Module: `src/ManifestContext.tsx`
1102
- Source: `src/ManifestContext.tsx:30:1`
1107
+ Source: `src/ManifestContext.tsx:47:1`
1108
+
1109
+ Returns the active manifest scope, including its application-lifetime state adapter.
1103
1110
 
1104
1111
  ### Signatures
1105
1112
 
@@ -1110,7 +1117,9 @@ Source: `src/ManifestContext.tsx:30:1`
1110
1117
 
1111
1118
  Kind: `function`
1112
1119
  Module: `src/ManifestContext.tsx`
1113
- Source: `src/ManifestContext.tsx:38:1`
1120
+ Source: `src/ManifestContext.tsx:56:1`
1121
+
1122
+ Reads an enclosing manifest scope without requiring hosts to provide one.
1114
1123
 
1115
1124
  ### Signatures
1116
1125