fluid-framework 2.0.0-dev-rc.1.0.0.225277 → 2.0.0-dev-rc.1.0.0.232845
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/CHANGELOG.md +4 -0
- package/README.md +53 -27
- package/api-extractor.json +8 -1
- package/api-report/fluid-framework.api.md +266 -2194
- package/dist/fluid-framework-alpha.d.ts +699 -1656
- package/dist/fluid-framework-beta.d.ts +763 -1037
- package/dist/fluid-framework-public.d.ts +1655 -835
- package/dist/fluid-framework-untrimmed.d.ts +1077 -6663
- package/dist/index.d.ts +11 -12
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +31 -0
- package/dist/index.js.map +1 -0
- package/dist/tsdoc-metadata.json +1 -1
- package/lib/fluid-framework-alpha.d.mts +138 -137
- package/lib/fluid-framework-beta.d.mts +138 -138
- package/lib/fluid-framework-public.d.mts +138 -138
- package/lib/fluid-framework-untrimmed.d.mts +133 -145
- package/lib/index.d.mts +9 -9
- package/lib/index.d.mts.map +1 -1
- package/lib/index.mjs +4 -5
- package/lib/index.mjs.map +1 -1
- package/package.json +19 -19
- package/src/index.ts +67 -78
- package/dist/index.cjs +0 -54
- package/dist/index.cjs.map +0 -1
- /package/{.eslintrc.js → .eslintrc.cjs} +0 -0
package/CHANGELOG.md
CHANGED
package/README.md
CHANGED
|
@@ -1,8 +1,30 @@
|
|
|
1
1
|
# fluid-framework
|
|
2
2
|
|
|
3
|
-
The `fluid-framework` package bundles a collection of Fluid Framework client
|
|
3
|
+
The `fluid-framework` package bundles a collection of Fluid Framework client libraries for easy use when paired with a corresponding service client package (e.g. `@fluidframework/azure-client`, `@fluidframework/tinylicious-client`, or `@fluid-experimental/osdp-client (BETA)`).
|
|
4
4
|
|
|
5
|
-
|
|
5
|
+
## Contents
|
|
6
|
+
|
|
7
|
+
The `fluid-framework` package consists primarily of two portions: the `IFluidContainer` and a selection of distributed data structures (DDSes).
|
|
8
|
+
|
|
9
|
+
### IFluidContainer
|
|
10
|
+
|
|
11
|
+
The **[IFluidContainer][]** interface is one of the types returned by calls to `createContainer()` and `getContainer()` on the service clients such as `AzureClient`.
|
|
12
|
+
It includes functionality to retrieve the Fluid data contained within, as well as to inspect the state of the collaboration session connection.
|
|
13
|
+
|
|
14
|
+
### DDS packages
|
|
15
|
+
|
|
16
|
+
You'll use one or more DDS data structures in your container to model your collaborative data.
|
|
17
|
+
The `fluid-framework` package offers the following data structures:
|
|
18
|
+
|
|
19
|
+
1. **[SharedTree][]**
|
|
20
|
+
1. **[SharedMap][]**, a map-like data structure for storing key/value pair data
|
|
21
|
+
- Note: as of version 2.0, `SharedMap` is deprecated. Please use `SharedTree` instead.
|
|
22
|
+
|
|
23
|
+
## Tutorial
|
|
24
|
+
|
|
25
|
+
Check out the [Hello World tutorial](https://fluidframework.com/docs/start/tutorial/) using `fluid-framework`.
|
|
26
|
+
|
|
27
|
+
<!-- AUTO-GENERATED-CONTENT:START (LIBRARY_PACKAGE_README:scripts=FALSE) -->
|
|
6
28
|
|
|
7
29
|
<!-- prettier-ignore-start -->
|
|
8
30
|
<!-- NOTE: This section is automatically generated using @fluid-tools/markdown-magic. Do not update these generated contents directly. -->
|
|
@@ -13,40 +35,45 @@ When taking a dependency on a Fluid Framework library, we recommend using a `^`
|
|
|
13
35
|
While Fluid Framework libraries may use different ranges with interdependencies between other Fluid Framework libraries,
|
|
14
36
|
library consumers should always prefer `^`.
|
|
15
37
|
|
|
16
|
-
|
|
17
|
-
you must use a `>= <` dependency range (such as `>=2.0.0-internal.x.y.z <2.0.0-internal.w.0.0` where `w` is `x+1`).
|
|
18
|
-
Standard `^` and `~` ranges will not work as expected.
|
|
19
|
-
See the [@fluid-tools/version-tools](https://github.com/microsoft/FluidFramework/blob/main/build-tools/packages/version-tools/README.md)
|
|
20
|
-
package for more information including tools to convert between version schemes.
|
|
38
|
+
## Installation
|
|
21
39
|
|
|
22
|
-
|
|
40
|
+
To get started, install the package by running the following command:
|
|
23
41
|
|
|
24
|
-
|
|
42
|
+
```bash
|
|
43
|
+
npm i fluid-framework
|
|
44
|
+
```
|
|
25
45
|
|
|
26
|
-
##
|
|
46
|
+
## API Documentation
|
|
27
47
|
|
|
28
|
-
|
|
48
|
+
API documentation for **fluid-framework** is available at <https://fluidframework.com/docs/apis/fluid-framework>.
|
|
29
49
|
|
|
30
|
-
|
|
50
|
+
## Contribution Guidelines
|
|
31
51
|
|
|
32
|
-
|
|
52
|
+
There are many ways to [contribute](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md) to Fluid.
|
|
33
53
|
|
|
34
|
-
|
|
54
|
+
- Participate in Q&A in our [GitHub Discussions](https://github.com/microsoft/FluidFramework/discussions).
|
|
55
|
+
- [Submit bugs](https://github.com/microsoft/FluidFramework/issues) and help us verify fixes as they are checked in.
|
|
56
|
+
- Review the [source code changes](https://github.com/microsoft/FluidFramework/pulls).
|
|
57
|
+
- [Contribute bug fixes](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md).
|
|
35
58
|
|
|
36
|
-
|
|
59
|
+
Detailed instructions for working in the repo can be found in the [Wiki](https://github.com/microsoft/FluidFramework/wiki).
|
|
37
60
|
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
3. **[SharedString][]**, a data structure for string data
|
|
61
|
+
This project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).
|
|
62
|
+
For more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.
|
|
41
63
|
|
|
42
|
-
|
|
64
|
+
This project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.
|
|
65
|
+
Use of these trademarks or logos must follow Microsoft’s [Trademark & Brand Guidelines](https://www.microsoft.com/trademarks).
|
|
66
|
+
Use of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.
|
|
43
67
|
|
|
44
|
-
|
|
68
|
+
## Help
|
|
45
69
|
|
|
46
|
-
|
|
70
|
+
Not finding what you're looking for in this README? Check out our [GitHub
|
|
71
|
+
Wiki](https://github.com/microsoft/FluidFramework/wiki) or [fluidframework.com](https://fluidframework.com/docs/).
|
|
47
72
|
|
|
48
|
-
|
|
49
|
-
|
|
73
|
+
Still not finding what you're looking for? Please [file an
|
|
74
|
+
issue](https://github.com/microsoft/FluidFramework/wiki/Submitting-Bugs-and-Feature-Requests).
|
|
75
|
+
|
|
76
|
+
Thank you!
|
|
50
77
|
|
|
51
78
|
## Trademark
|
|
52
79
|
|
|
@@ -62,7 +89,6 @@ Use of Microsoft trademarks or logos in modified versions of this project must n
|
|
|
62
89
|
|
|
63
90
|
<!-- Links -->
|
|
64
91
|
|
|
65
|
-
[ifluidcontainer]: https://fluidframework.com/docs/
|
|
66
|
-
[sharedmap]: https://fluidframework.com/docs/
|
|
67
|
-
[
|
|
68
|
-
[sharedstring]: https://fluidframework.com/docs/apis/sequence/sharedstring/
|
|
92
|
+
[ifluidcontainer]: https://fluidframework.com/docs/api/v2/fluid-framework/ifluidcontainer-interface
|
|
93
|
+
[sharedmap]: https://fluidframework.com/docs/data-structures/map/
|
|
94
|
+
[sharedtree]: https://fluidframework.com/docs/data-structures/tree/
|
package/api-extractor.json
CHANGED
|
@@ -1,7 +1,14 @@
|
|
|
1
1
|
{
|
|
2
2
|
"$schema": "https://developer.microsoft.com/json-schemas/api-extractor/v7/api-extractor.schema.json",
|
|
3
3
|
"extends": "../../../common/build/build-common/api-extractor-base.json",
|
|
4
|
-
"bundledPackages": [
|
|
4
|
+
"bundledPackages": [
|
|
5
|
+
"@fluidframework/container-definitions",
|
|
6
|
+
"@fluidframework/container-loader",
|
|
7
|
+
"@fluidframework/driver-definitions",
|
|
8
|
+
"@fluidframework/fluid-static",
|
|
9
|
+
"@fluidframework/map",
|
|
10
|
+
"@fluidframework/tree"
|
|
11
|
+
],
|
|
5
12
|
"messages": {
|
|
6
13
|
"extractorMessageReporting": {
|
|
7
14
|
// TODO: Add missing documentation and remove this rule override
|