Tweak and partially integrate ClientVersionDispatchingCodecBuilder

[CraigMacomber]

Description

Allow ClientVersionDispatchingCodecBuilder to support overrides to better align with the approach in #24422

Use ClientVersionDispatchingCodecBuilder for EditManager, though the ability to actually control its version via overrides and and fluid client version are not fully connected to the shared tree configuration (configuredSharedTree).

Reviewer Guidance

The review process is outlined on this wiki page.

[Copilot]

Pull Request Overview

This PR extends the versioned codec system with per-codec override support and wires it into the EditManager and SharedTree, enabling clients to request specific format versions.

• Introduces CodecName and FormatVersion types and augments CodecWriteOptions with writeVersionOverrides and allowPossiblyIncompatibleWriteVersionOverrides.
• Implements ClientVersionDispatchingCodecBuilder to replace prior dispatch utilities and integrates it into makeEditManagerCodec and SharedTreeCore.
• Updates default SharedTree options and tests to exercise the new override logic.

Reviewed Changes

Copilot reviewed 13 out of 13 changed files in this pull request and generated 1 comment.

Show a summary per file

File	Description
packages/framework/fluid-framework/api-report/fluid-framework.alpha.api.md	Adds CodecName, FormatVersion, and new options to public API docs
packages/dds/tree/api-report/tree.alpha.api.md	Mirrors the new types and options in tree API docs
packages/dds/tree/src/codec/index.ts	Exports CodecName, CodecVersion, and ClientVersionDispatchingCodecBuilder
packages/dds/tree/src/codec/versioned/index.ts	Exports builder and CodecVersion type from versioned package
packages/dds/tree/src/codec/versioned/codec.ts	Implements ClientVersionDispatchingCodecBuilder with override logic
packages/dds/tree/src/shared-tree-core/editManagerCodecs.ts	Changes makeEditManagerCodec to return the new builder and registry
packages/dds/tree/src/shared-tree-core/sharedTreeCore.ts	Uses builder.build with override options in SharedTreeCore
packages/dds/tree/src/shared-tree/sharedTree.ts	Adds override fields to defaultSharedTreeOptions and per-version mappings
packages/dds/tree/src/index.ts	Updates top-level exports for new types and FluidClientVersion
packages/dds/tree/src/test/codec/versioned/codec.spec.ts	Updates versioned codec tests to use the new builder and override scenarios
packages/dds/tree/src/test/shared-tree-core/edit-manager/editManagerCodecs.test.ts	Switches tests to the builder API and tests error/success for overrides
packages/dds/tree/src/test/shared-tree-core/utils.ts	Imports FluidClientVersion in test utilities for formatVersion data

Comments suppressed due to low confidence (1)

packages/dds/tree/src/shared-tree/sharedTree.ts:747

• Ensure that SharedTreeOptionsInternal (and its public counterpart) include the new writeVersionOverrides and allowPossiblyIncompatibleWriteVersionOverrides fields, or consumers will see a type mismatch.

    writeVersionOverrides: new Map(),

[github-actions]

🔗 No broken links found! ✅

Your attention to detail is admirable.

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

Crawling...

Stats:
  222981 links
    1707 destination URLs
    1939 URLs ignored
       0 warnings
       0 errors