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 CHANGED
@@ -1,5 +1,9 @@
1
1
  # fluid-framework
2
2
 
3
+ ## 2.0.0-rc.1.0.0
4
+
5
+ Dependency updates only.
6
+
3
7
  ## 2.0.0-internal.8.0.0
4
8
 
5
9
  ### Major Changes
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 packages for easy use when paired with a corresponding service client package (ex. `@fluidframework/azure-client` & `@fluidframework/tinylicious-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
- <!-- AUTO-GENERATED-CONTENT:START (README_DEPENDENCY_GUIDELINES_SECTION:includeHeading=TRUE) -->
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
- Note that when depending on a library version of the form `2.0.0-internal.x.y.z`, called the Fluid internal version scheme,
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
- <!-- prettier-ignore-end -->
40
+ To get started, install the package by running the following command:
23
41
 
24
- <!-- AUTO-GENERATED-CONTENT:END -->
42
+ ```bash
43
+ npm i fluid-framework
44
+ ```
25
45
 
26
- ## Contents
46
+ ## API Documentation
27
47
 
28
- The `fluid-framework` package consists primarily of two portions: the `IFluidContainer` and a selection of distributed data structures (DDSes).
48
+ API documentation for **fluid-framework** is available at <https://fluidframework.com/docs/apis/fluid-framework>.
29
49
 
30
- ### IFluidContainer
50
+ ## Contribution Guidelines
31
51
 
32
- The **[IFluidContainer][]** interface is the one of the types returned by calls to `createContainer()` and `getContainer()` on the service clients such as `AzureClient`. It includes functionality to retrieve the Fluid data contained within, as well as to inspect the state of the collaboration session connection.
52
+ There are many ways to [contribute](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md) to Fluid.
33
53
 
34
- ### DDS packages
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
- You'll use one or more DDS data structures in your container to model your collaborative data. The `fluid-framework` package comes with three data structures that cover a broad range of scenarios:
59
+ Detailed instructions for working in the repo can be found in the [Wiki](https://github.com/microsoft/FluidFramework/wiki).
37
60
 
38
- 1. **[SharedMap][]**, a map-like data structure for storing key/value pair data
39
- 2. **[SharedDirectory][]**, a map-like data structure with ability to organize keys into subdirectories
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
- ## Tutorial
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
- Check out the Hello World tutorial using the `fluid-framework` package [here](https://fluidframework.com/docs/start/tutorial/).
68
+ ## Help
45
69
 
46
- <!-- AUTO-GENERATED-CONTENT:START (README_TRADEMARK_SECTION:includeHeading=TRUE) -->
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
- <!-- prettier-ignore-start -->
49
- <!-- NOTE: This section is automatically generated using @fluid-tools/markdown-magic. Do not update these generated contents directly. -->
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/apis/fluid-static/ifluidcontainer/
66
- [sharedmap]: https://fluidframework.com/docs/apis/map/sharedmap/
67
- [shareddirectory]: https://fluidframework.com/docs/apis/map/shareddirectory/
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/
@@ -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": ["@fluidframework/map", "@fluidframework/tree"],
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