Add Clone to SharedTree Revertible

[jikim-msft]

Description

13864

This PR adds forkable revertible feature to the Revertible object of SharedTree.

• Removed DisposableRevertible and replaced by RevertibleAlpha.
• Added clone() method to the new interface.
• Uses TreeBranch (which is subset of TreeCheckout) to access data necessary for revert operation.

[msfluid-bot]

Code Coverage Summary

↓ packages.dds.tree.src.shared-tree:
Line Coverage Change: -0.02%    Branch Coverage Change: -0.17%

Metric Name	Baseline coverage	PR coverage	Coverage Diff
Branch Coverage	91.76%	91.59%	↓ -0.17%
Line Coverage	97.30%	97.28%	↓ -0.02%

↑ packages.dds.tree.src.simple-tree.api:
Line Coverage Change: 0.02%    Branch Coverage Change: No change

Metric Name	Baseline coverage	PR coverage	Coverage Diff
Branch Coverage	89.77%	89.77%	→ No change
Line Coverage	82.34%	82.36%	↑ 0.02%

---

Baseline commit: d3bf90c
Baseline build: 308876
Happy Coding!!

Code coverage comparison check passed!!

[msfluid-bot]

⯅ @fluid-example/bundle-size-tests: +919 Bytes

Metric Name	Baseline Size	Compare Size	Size Diff
aqueduct.js	467.24 KB	467.27 KB	⯅ +35 Bytes
azureClient.js	564.01 KB	564.06 KB	⯅ +49 Bytes
connectionState.js	724 Bytes	724 Bytes	■ No change
containerRuntime.js	263.43 KB	263.45 KB	⯅ +14 Bytes
fluidFramework.js	428.51 KB	428.85 KB	⯅ +351 Bytes
loader.js	134.18 KB	134.19 KB	⯅ +14 Bytes
map.js	42.71 KB	42.71 KB	⯅ +7 Bytes
matrix.js	150.15 KB	150.16 KB	⯅ +7 Bytes
odspClient.js	529.85 KB	529.89 KB	⯅ +49 Bytes
odspDriver.js	97.88 KB	97.9 KB	⯅ +21 Bytes
odspPrefetchSnapshot.js	42.81 KB	42.83 KB	⯅ +14 Bytes
sharedString.js	166.23 KB	166.24 KB	⯅ +7 Bytes
sharedTree.js	418.97 KB	419.3 KB	⯅ +344 Bytes
Total Size	3.38 MB	3.38 MB	⯅ +919 Bytes

---

Baseline commit: 224f59a

Generated by 🚫 dangerJS against d6afed1

Copilot reviewed 5 out of 6 changed files in this pull request and generated no suggestions.

Files not reviewed (1)

• packages/dds/tree/src/core/index.ts: Evaluated as low risk

Comments skipped due to low confidence (2)

packages/dds/tree/src/shared-tree/treeCheckout.ts:634

• [nitpick] The method name 'clone' might be ambiguous. Consider renaming it to 'createClone' or 'duplicate' for better clarity.

clone: (forkedBranch?: TreeBranch) => {

packages/dds/tree/src/shared-tree/treeCheckout.ts:639

• [nitpick] The error message 'Unable to dispose a revertible that has already been disposed.' could be more descriptive. Consider providing more context about why this error might occur.

throw new UsageError("Unable to dispose a revertible that has already been disposed.");

Tip: Copilot code review supports C#, Go, Java, JavaScript, Markdown, Python, Ruby and TypeScript, with more languages coming soon. Learn more

[noencke]

Implementation looks correct. You'll need to a changeset and get docs review before checking in.

[github-actions]

🔗 No broken links found! ✅

Your attention to detail is admirable.

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

Crawling...

Stats:
  170005 links
    1595 destination URLs
    1825 URLs ignored
       0 warnings
       0 errors

[jzaffiro]

Approved for docs pending one minor comment