Merge branch 'plumb-minversion-down-2' into set-st-flags

Author: TommyBrosman

.changeset/cute-kids-bake.md

@@ -1,27 +1,23 @@
 ---
 "@fluidframework/datastore": minor
-"@fluidframework/datastore-definitions": minor
 "@fluidframework/runtime-definitions": minor
 "@fluidframework/test-runtime-utils": minor
 "__section": feature
 ---
-`minVersionForCollab` is now available on `IContainerRuntimeBase`, `IFluidDataStoreContext`, and `IFluidDataStoreRuntime`
+`minVersionForCollab` is now available on `IFluidDataStoreContext`
 
 `minVersionForCollab` is now passed down from the `ContainerRuntime` to the Datastore layer where it is made available for
 `SharedObject` construction.
 DDSes may optionally consume this value and use it to determine which sets of feature flags should be enabled.
 
-#### Interface changes
+#### Public type changes
 
-All implementers of `IContainerRuntimeBase`, `IFluidDataStoreContext`, and `IFluidDataStoreRuntime` should forward the `minVersionForCollab`
-value. Constraints for the interfaces that now provide the value via accessors or fields:
-
-- **@fluidframework/runtime-definitions: `IContainerRuntimeBase`** - Exposes the `minVersionForCollab` passed to ContainerRuntime.
-- **@fluidframework/runtime-definitions: `IFluidDataStoreContext`** - Implementation (`FluidDataStoreContext`) must read
-`minVersionForCollab` from `IContainerRuntimeBase` (class member).
-- **@fluidframework/datastore-definitions: `IFluidDataStoreRuntime`** - Implementation (`FluidDataStoreRuntime`) must read
-`minVersionForCollab` from `IFluidDataStoreContext` in the constructor.
+- **@fluidframework/datastore: `FluidDataStoreRuntime`** - Exposes `minVersionForCollab`.
+- **@fluidframework/runtime-definitions: `IFluidDataStoreContext`** - Exposes optional member `getMinVersionForCollab`.
+See `FluidDataStoreContext` for an example implementation.
+- **@fluidframework/test-runtime-utils: `MockFluidDataStoreContext`, `MockFluidDataStoreRuntime`** - Exposes `minVersionForCollab`
+either via a getter or as a readonly field.
 
 Note that the new implementations are either optional accessors, can return undefined, or both.
-This is needed layer compatibility, and in a future release these members will no longer be optional or return
+This is needed for layer compatibility, and in a future release these members will no longer be optional or return
 values that may be undefined.

.changeset/damp-toads-stall.md

@@ -0,0 +1,172 @@
+<!-- THIS IS AN AUTOGENERATED FILE. DO NOT EDIT THIS FILE DIRECTLY. -->
+
+# Fluid Framework v2.60.0
+
+## Contents
+
+- [🚨 Breaking Changes](#-breaking-changes)
+  - [Remove unnecessary and internal APIs in ISequenceIntervalCollection and related interval types (#25244)](#remove-unnecessary-and-internal-apis-in-isequenceintervalcollection-and-related-interval-types-25244)
+- [🌳 SharedTree DDS Changes](#-sharedtree-dds-changes)
+  - [Single-node insertion/removal APIs have been removed from TableSchema (alpha) (#25233)](#single-node-insertionremoval-apis-have-been-removed-from-tableschema-alpha-25233)
+  - [Range-based row/column removal methods have been added to TableSchema APIs (alpha) (#25235)](#range-based-rowcolumn-removal-methods-have-been-added-to-tableschema-apis-alpha-25235)
+  - [Replace "TreeEncodingOptions.useStoredKeys" with "keys" and "KeyEncodingOptions" (#25263)](#replace-treeencodingoptionsusestoredkeys-with-keys-and-keyencodingoptions-25263)
+  - [Hoist runTransaction method from TreeViewAlpha to TreeBranch (#25280)](#hoist-runtransaction-method-from-treeviewalpha-to-treebranch-25280)
+  - [SchemaFactoryAlpha.recordRecursive now supports metadata (#25289)](#schemafactoryalpharecordrecursive-now-supports-metadata-25289)
+  - [FormatValidator added to replace JsonValidator (#25311)](#formatvalidator-added-to-replace-jsonvalidator-25311)
+  - [Add SchemaFactoryBeta (#25313)](#add-schemafactorybeta-25313)
+
+## 🚨 Breaking Changes
+
+### Remove unnecessary and internal APIs in ISequenceIntervalCollection and related interval types ([#25244](https://github.com/microsoft/FluidFramework/issues/25244))
+
+The following APIs are now removed:
+
+- `IInterval.clone`
+- `IInterval.modify`
+- `IInterval.union`
+- `ISerializableInterval`
+- `SequenceInterval.clone`
+- `SequenceInterval.modify`
+- `SequenceInterval.union`
+- `SequenceInterval.serialize`
+- `SequenceInterval.addPositionChangeListeners`
+- `SequenceInterval.removePositionChangeListeners`
+
+These APIs were never intended for public use. There is no migration path, and any usage is strongly discouraged, as it may result in severe errors or data corruption. Please remove any dependencies on these APIs as soon as possible.
+
+#### Change details
+
+Commit: [`15d476e`](https://github.com/microsoft/FluidFramework/commit/15d476ea7069eb4de317a726733aa8fb9e8486e8)
+
+Affected packages:
+
+- fluid-framework
+- @fluidframework/sequence
+
+[⬆️ Table of contents](#contents)
+
+## 🌳 SharedTree DDS Changes
+
+### Single-node insertion/removal APIs have been removed from TableSchema (alpha) ([#25233](https://github.com/microsoft/FluidFramework/issues/25233))
+
+There is a significant performance benefit to inserting / removing rows / columns in batches. To help encourage more performant usage patterns, single-node insertion and removal APIs have been removed. The APIs that operate on batches should be used instead.
+
+Specifically:
+
+- `insertColumn`
+  - Use `insertColumns` instead
+- `insertRow`
+  - Use `insertRows` instead
+- `removeColumn`
+  - Use `removeColumns` instead
+- `removeRow`
+  - Use `removeRows` instead
+
+#### Change details
+
+Commit: [`99281d2`](https://github.com/microsoft/FluidFramework/commit/99281d2b24ec406760c9029aad5aa72a9265a65d)
+
+Affected packages:
+
+- @fluidframework/tree
+- fluid-framework
+
+[⬆️ Table of contents](#contents)
+
+### Range-based row/column removal methods have been added to TableSchema APIs (alpha) ([#25235](https://github.com/microsoft/FluidFramework/issues/25235))
+
+Adds range-based overloads to `removeColumns` and `removeRows` for removing contiguous ranges of rows and columns.
+
+The `removeAllColumns` and `removeAllRows` methods have been removed, as they can be trivially implemented in terms of the new methods.
+
+#### Change details
+
+Commit: [`c803393`](https://github.com/microsoft/FluidFramework/commit/c803393cec6847f4294dc34b4a074ec93baf111c)
+
+Affected packages:
+
+- @fluidframework/tree
+- fluid-framework
+
+[⬆️ Table of contents](#contents)
+
+### Replace "TreeEncodingOptions.useStoredKeys" with "keys" and "KeyEncodingOptions" ([#25263](https://github.com/microsoft/FluidFramework/issues/25263))
+
+The alpha API `TreeEncodingOptions` has had its `useStoredKeys` `boolean` replaced with `keys` that takes a `KeyEncodingOptions` allowing for three options instead of the previous two. With the new API, it is now possible to control, for APIs which support it (like [`TreeAlpha.exportVerbose`](https://fluidframework.com/docs/api/fluid-framework/treealpha-interface#exportverbose-methodsignature)), if unknown optional fields will be included when exporting data using stored keys.
+
+Additionally, the relevant options interfaces have been marked as `@input`, indicating that more options may be added as optional parameters in the future, and that should be considered non-breaking.
+
+#### Change details
+
+Commit: [`b65f2a8`](https://github.com/microsoft/FluidFramework/commit/b65f2a86d44d690a675867600a0a7e3c1608a473)
+
+Affected packages:
+
+- fluid-framework
+- @fluidframework/tree
+
+[⬆️ Table of contents](#contents)
+
+### Hoist runTransaction method from TreeViewAlpha to TreeBranch ([#25280](https://github.com/microsoft/FluidFramework/issues/25280))
+
+Transactions are not view-schema-dependent, so it isn't necessary for them to be exclusive to the view type. `runTransaction` is now available on `TreeBranch` (alpha). `TreeViewAlpha` extends `TreeBranch`, so this change strictly makes the API more accessible.
+
+#### Change details
+
+Commit: [`a66b3b7`](https://github.com/microsoft/FluidFramework/commit/a66b3b77df346d1689ddedcefc16846eda45991a)
+
+Affected packages:
+
+- fluid-framework
+- @fluidframework/tree
+
+[⬆️ Table of contents](#contents)
+
+### SchemaFactoryAlpha.recordRecursive now supports metadata ([#25289](https://github.com/microsoft/FluidFramework/issues/25289))
+
+`SchemaFactoryAlpha.recordRecursive` now support metadata like `SchemaFactoryAlpha.recordAlpha` and the other `TreeNodeSchema` creation methods on `SchemaFactoryAlpha` (except for `SchemaFactoryAlpha.record` which does not support metadata).
+
+#### Change details
+
+Commit: [`8324170`](https://github.com/microsoft/FluidFramework/commit/83241702d5fb5608cfa0add569c7803837abcf82)
+
+Affected packages:
+
+- fluid-framework
+- @fluidframework/tree
+
+[⬆️ Table of contents](#contents)
+
+### FormatValidator added to replace JsonValidator ([#25311](https://github.com/microsoft/FluidFramework/issues/25311))
+
+The existing `@alpha` type [`JsonValidator`](https://fluidframework.com/docs/api/fluid-framework/jsonvalidator-interface) has a new type-erased alternative, `FormatValidator`, which is planned to be stabilized to `@beta` in the future. It replaces `JsonValidator` in `ICodecOptions`. Existing code using `ICodecOptions` should migrate to use `FormatValidator`, but this is not required for adopting this release as `JsonValidator` is still supported.
+
+#### Change details
+
+Commit: [`9db6e08`](https://github.com/microsoft/FluidFramework/commit/9db6e08ec12973e7cc4f7fe86fecd054bafcd1c0)
+
+Affected packages:
+
+- fluid-framework
+- @fluidframework/tree
+
+[⬆️ Table of contents](#contents)
+
+### Add SchemaFactoryBeta ([#25313](https://github.com/microsoft/FluidFramework/issues/25313))
+
+`SchemaFactoryBeta` is added to provide a place to partially stabilize APIs from [`SchemaFactoryAlpha`](https://fluidframework.com/docs/api/fluid-framework/schemafactoryalpha-class). Initially just one APIs is added as `@beta`: `scopedFactory`. Users of the existing `@alpha` `scopedFactory` API on `SchemaFactoryAlpha` will need to update to use `scopedFactoryAlpha` if they require the returned factory to be a `SchemaFactoryAlpha` instance.
+
+#### Change details
+
+Commit: [`dca2361`](https://github.com/microsoft/FluidFramework/commit/dca2361d33dd959f5d913cbb59601685f85ff6f0)
+
+Affected packages:
+
+- fluid-framework
+- @fluidframework/tree
+
+[⬆️ Table of contents](#contents)
+
+### 🛠️ Start Building Today!
+
+Please continue to engage with us on GitHub [Discussion](https://github.com/microsoft/FluidFramework/discussions) and [Issue](https://github.com/microsoft/FluidFramework/issues) pages as you adopt Fluid Framework!