Shared Tree: Use minVersionForCollab instead of oldestCompatibleClient to specify min client version

[TommyBrosman]

Description

This change replaces SharedTreeOptions.oldestCompatibleClient with minVersionForCollab. Additionally, Shared Tree will now use the minVersionForCollab specified at the ContainerRuntime level when minVersionForCollab is not specified at the Shared Tree level.

Changes APIs and codec code to use MinimumVersionForCollab in place of FluidClientVersion. Also changes FluidClientVersion to a const object that contains MinimumVersionForCollab values.

Breaking Changes

This change breaks the following alpha APIs:

• SharedTreeOptions: oldestCompatibleClient has been replaced with minVersionForCollab. See changeset notes on how to specify the minimum compatible version.
• CodecWriteOptions.oldestCompatibleClient (type change)
• makeDetachedFieldIndexCodec (parameter type change)
• TreeAlpha.exportCompressed (parameter type change)
• extractPersistedSchema (parameter type change)

Reviewer Guidance

Todo

• Rebase onto main once Plumb minVersionForCollab down to SharedObject so that it can be consumed by DDSes #25130 is committed.
• Determine which flags/formats can be set as part of this change.

[Copilot]

Pull Request Overview

This PR replaces FluidClientVersion with MinimumVersionForCollab in APIs and codec code to better align with runtime versioning standards. The change also converts FluidClientVersion from an enum to a const object containing MinimumVersionForCollab values.

Key changes:

• Updated API signatures to use MinimumVersionForCollab instead of FluidClientVersion
• Converted FluidClientVersion from enum to const object with version string values
• Updated test code to use package version instead of unstable feature flags

Reviewed Changes

Copilot reviewed 12 out of 13 changed files in this pull request and generated no comments.

Show a summary per file

File	Description
packages/framework/fluid-framework/api-report/fluid-framework.alpha.api.md	Updates API report to reflect type changes from FluidClientVersion to MinimumVersionForCollab
packages/dds/tree/src/treeFactory.ts	Adds MinimumVersionForCollab import and selectFeatureFlags function
packages/dds/tree/src/test/shared-tree/fuzz/baseModel.ts	Updates test models to use package version instead of EnableUnstableFeatures
packages/dds/tree/src/test/codec/versioned/codec.spec.ts	Updates test code to use string versions and semver comparison
packages/dds/tree/src/simple-tree/api/storedSchema.ts	Updates extractPersistedSchema function signature
packages/dds/tree/src/feature-libraries/schema-index/codec.ts	Updates clientVersionToSchemaVersion function signature
packages/dds/tree/src/feature-libraries/chunked-forest/codec/codecs.ts	Updates fluidVersionToFieldBatchCodecWriteVersion function signature
packages/dds/tree/src/codec/versioned/codec.ts	Updates ClientVersionDispatchingCodecBuilder to use MinimumVersionForCollab
packages/dds/tree/src/codec/codec.ts	Converts FluidClientVersion from enum to const object and updates related types
packages/dds/tree/package.json	Adds semver-ts dependency
packages/dds/tree/api-report/tree.alpha.api.md	Updates tree API report to reflect type changes
.changeset/warm-windows-cross.md	Documents the breaking change

Files not reviewed (1)

• pnpm-lock.yaml: Language not supported

[alexvy86]

Approving for docs. I had a quick look at the rest of the change and made sense to me but probably get someone else to also review.

[github-actions]

🔗 Found some broken links! 💔

Run a link check locally to find them. See
https://github.com/microsoft/FluidFramework/wiki/Checking-for-broken-links-in-the-documentation for more information.

linkcheck output

> [email protected] ci:check-links /home/runner/work/FluidFramework/FluidFramework/docs
> start-server-and-test "npm run serve -- --no-open" 3000 check-links

1: starting server using command "npm run serve -- --no-open"
and when url "[ 'http://127.0.0.1:3000' ]" is responding with HTTP status code 200
running tests using command "npm run check-links"


> [email protected] serve
> docusaurus serve --no-open

[SUCCESS] Serving "build" directory at: http://localhost:3000/

> [email protected] check-links
> linkcheck http://localhost:3000 --skip-file skipped-urls.txt

 ELIFECYCLE  Command failed with exit code 1.