@morgan-stanley/composeui-fdc3 0.1.0-alpha.7 → 0.1.0-alpha.9
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.
- package/README.md +54 -3
- package/dist/fdc3-iife-bundle.js +1 -1
- package/package.json +3 -3
package/README.md
CHANGED
|
@@ -1,6 +1,57 @@
|
|
|
1
1
|
<!-- Morgan Stanley makes this available to you under the Apache License, Version 2.0 (the "License"). You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0. See the NOTICE file distributed with this work for additional information regarding copyright ownership. Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. -->
|
|
2
2
|
|
|
3
|
-
#
|
|
3
|
+
# composeui-fdc3
|
|
4
4
|
|
|
5
|
-
|
|
6
|
-
|
|
5
|
+
`composeui-fdc3` is a TypeScript/JavaScript package that provides [FDC3](https://fdc3.finos.org/) support for [ComposeUI](https://morganstanley.github.io/ComposeUI/) applications. It enables interoperability between desktop applications by implementing the FDC3 standard APIs for context sharing, intent handling, and application discovery.
|
|
6
|
+
|
|
7
|
+
**Note:** This package currently supports only FDC3 version 2.0.
|
|
8
|
+
It uses the [MessageRouter TypeScript library](https://github.com/morganstanley/ComposeUI/tree/main/src/messagerouter/js) as its messaging layer.
|
|
9
|
+
|
|
10
|
+
## Features
|
|
11
|
+
|
|
12
|
+
- Implements FDC3 APIs for context, intents, and app channels
|
|
13
|
+
- TypeScript typings included
|
|
14
|
+
|
|
15
|
+
## Installation
|
|
16
|
+
|
|
17
|
+
You need to embed the generated bundle into your shell application, similar to how it is handled in the current Shell POC. In that example, a .NET Framework WPF application includes the bundle as an embedded resource. When using WebView2 to load web windows, the application initializes the bundle as a script and injects it into the page.
|
|
18
|
+
|
|
19
|
+
To use the FDC3 APIs, install the official FINOS FDC3 library (version 2.0) in your application:
|
|
20
|
+
|
|
21
|
+
```sh
|
|
22
|
+
npm install @finos/fdc3@2.0.0
|
|
23
|
+
```
|
|
24
|
+
|
|
25
|
+
## Usage
|
|
26
|
+
|
|
27
|
+
Import and use the FDC3 API in your application as needed.
|
|
28
|
+
|
|
29
|
+
```typescript
|
|
30
|
+
// Raise an intent
|
|
31
|
+
fdc3.raiseIntent('ViewChart', { instrument: { type: 'fdc3.instrument', id: { ticker: 'AAPL' } } });
|
|
32
|
+
|
|
33
|
+
// Broadcast context
|
|
34
|
+
fdc3.broadcast({ type: 'fdc3.contact', name: 'Jane Doe' });
|
|
35
|
+
|
|
36
|
+
// Listen for context
|
|
37
|
+
fdc3.addContextListener('fdc3.instrument', context => {
|
|
38
|
+
console.log('Received instrument context:', context);
|
|
39
|
+
});
|
|
40
|
+
```
|
|
41
|
+
|
|
42
|
+
## API
|
|
43
|
+
|
|
44
|
+
This package implements the [FDC3 2.0+ API](https://fdc3.finos.org/docs/2.0/api/spec). See the FDC3 documentation for details on available methods and context types.
|
|
45
|
+
|
|
46
|
+
## Setup
|
|
47
|
+
|
|
48
|
+
- Have a Shell bundling the generated resource into the webpage.
|
|
49
|
+
- Import and use the FDC3 API from the FINOS library as shown above.
|
|
50
|
+
- Ensure your environment is configured to support FDC3 interoperability, e.g., having the FDC3 DesktopAgent backend for handling the requests.
|
|
51
|
+
|
|
52
|
+
## Documentation
|
|
53
|
+
|
|
54
|
+
- [FDC3 Standard](https://fdc3.finos.org/)
|
|
55
|
+
- [ComposeUI Documentation](https://morganstanley.github.io/ComposeUI/)
|
|
56
|
+
|
|
57
|
+
© Morgan Stanley. See NOTICE file for additional information.
|
package/dist/fdc3-iife-bundle.js
CHANGED
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@morgan-stanley/composeui-fdc3",
|
|
3
|
-
"version": "0.1.0-alpha.
|
|
3
|
+
"version": "0.1.0-alpha.9",
|
|
4
4
|
"private": false,
|
|
5
5
|
"description": "FDC3 DesktopAgent implementation for Compose UI",
|
|
6
6
|
"type": "module",
|
|
@@ -40,10 +40,10 @@
|
|
|
40
40
|
"jsdom": "^26.0.0",
|
|
41
41
|
"rimraf": "6.0.1",
|
|
42
42
|
"rollup": "^4.12.1",
|
|
43
|
-
"ts-jest": "29.
|
|
43
|
+
"ts-jest": "29.4.1",
|
|
44
44
|
"ts-node": "10.9.2",
|
|
45
45
|
"tslib": "^2.4.0",
|
|
46
46
|
"typescript": "^5.3.3"
|
|
47
47
|
},
|
|
48
|
-
"gitHead": "
|
|
48
|
+
"gitHead": "2841b9301647a15719dc5eff719832631105cfde"
|
|
49
49
|
}
|