(tree) Update how shared tree codec versions are generated

[agarwal-navin]

This change updates how the write version for the different codecs in tree are determined.
Currently, there is a mapping of SharedTreeFormatVersion to a list of write versions for all codecs. The SharedTreeFormatVersion is one of the options that can be passed when creating a tree and the codecs version are selected from the mapping based on this value.

With this change, SharedTreeFormatVersion will be removed. Instead, the write versions for the codecs will be selected based on the minVersionForCollab option that is also passed during tree creation. The minVersionForCollab will be passed down to each codec and it can decide what write version it wants based on this.

This PR also standardizes how the various versions are maintained by the codecs (using an as const enum-like object and branded values, and a function that generates the right version based on the minVersionForCollab).

The mapping from SharedTreeFormatVersion to minVersionForCollab is as follows:

• SharedTreeFormatVersion.v1: no longer an option
• SharedTreeFormatVersion.v2: no longer an option
• SharedTreeFormatVersion.v3: minVersionForCollab: FluidClientVersion.v2_0
• SharedTreeFormatVersion.v4: was never an option, still not an option
• SharedTreeFormatVersion.v5: minVersionForCollab: FluidClientVersion.v2_43
• SharedTreeFormatVersion.vSharedBranches: no longer an option. Use SharedTreeOptions.enableSharedBranches instead.

Unchanged: specifying minVersionForCollab: FluidClientVersion.v2_52 will enable DetachedFieldIndexFormatVersion.v2.

AB#51463.

Breaking Changes

SharedTreeFormatOptions (internal) no longer has a formatVersion field.

[Copilot]

Pull Request Overview

This PR refactors version handling across the codebase by standardizing on MinimumVersionForCollab (from @fluidframework/runtime-definitions) as the primary versioning mechanism, replacing various explicit format version numbers and enums. The changes introduce currentVersion as a constant defaulting to FluidClientVersion.v2_0 and update codec creation to accept CodecWriteOptions instead of explicit version parameters.

Key changes include:

• Replace SchemaVersion enum with SchemaFormatVersion const object
• Introduce converter functions (e.g., clientVersionToSchemaVersion, clientVersionToMessageFormatVersion) to map from MinimumVersionForCollab to specific format versions
• Remove explicit version parameters from codec factory functions, deriving them from minVersionForCollab instead

Reviewed Changes

Copilot reviewed 64 out of 64 changed files in this pull request and generated 5 comments.

Show a summary per file

File	Description
packages/dds/tree/src/codec/index.ts	Exports currentVersion constant
packages/dds/tree/src/core/schema-stored/schema.ts	Converts SchemaVersion enum to SchemaFormatVersion const object
packages/dds/tree/src/feature-libraries/schema-index/codec.ts	Adds clientVersionToSchemaVersion converter; updates makeSchemaCodec signature
packages/dds/tree/src/feature-libraries/chunked-forest/codec/codecs.ts	Adds clientVersionToFieldBatchVersion converter; removes fluidVersionToFieldBatchCodecWriteVersion
packages/dds/tree/src/shared-tree-core/messageCodecs.ts	Moves MessageFormatVersion to separate file; adds clientVersionToMessageFormatVersion
packages/dds/tree/src/shared-tree-core/editManagerCodecs.ts	Adds clientVersionToEditManagerFormatVersion converter
packages/dds/tree/src/shared-tree/sharedTree.ts	Removes large ExplicitCodecVersions mapping; simplifies codec tree generation
Test files	Updates to use currentVersion and new codec signatures

[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

> fluid-framework-docs-site@0.0.0 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"


> fluid-framework-docs-site@0.0.0 serve
> docusaurus serve --no-open

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

> fluid-framework-docs-site@0.0.0 check-links
> linkcheck http://localhost:3000 --skip-file skipped-urls.txt

 ELIFECYCLE  Command failed with exit code 1.

[Josmithr]

Docs and API changes look good.