feat(tree): Promote TableSchema APIs to beta by Josmithr · Pull Request #26339 · microsoft/FluidFramework

Josmithr · 2026-02-02T17:40:37Z

Promotes TableSchema APIs from alpha to beta.

For docs on these APIs, see here: https://fluidframework.com/docs/api/fluid-framework/tableschema-namespace

packages/dds/tree/src/tableSchema.ts

Copilot

Pull request overview

This pull request promotes the TableSchema APIs from alpha to beta status, marking them as more stable for use.

Changes:

Updated all JSDoc tags from @alpha to @beta for TableSchema and System_TableSchema namespaces
Removed alpha-stage warning from the main TableSchema namespace documentation
Relocated orphaned cells documentation from TableSchema to System_TableSchema namespace

Reviewed changes

Copilot reviewed 7 out of 7 changed files in this pull request and generated 2 comments.

Show a summary per file

File	Description
packages/framework/fluid-framework/api-report/fluid-framework.legacy.beta.api.md	Added TableSchema and System_TableSchema namespaces to beta API surface
packages/framework/fluid-framework/api-report/fluid-framework.beta.api.md	Added TableSchema and System_TableSchema namespaces to beta API surface
packages/framework/fluid-framework/api-report/fluid-framework.alpha.api.md	Updated namespace tags from @Alpha to @beta and removed @Sealed tag from createRowSchema
packages/dds/tree/api-report/tree.legacy.beta.api.md	Added TableSchema and System_TableSchema namespaces to beta API surface
packages/dds/tree/api-report/tree.beta.api.md	Added TableSchema and System_TableSchema namespaces to beta API surface
packages/dds/tree/api-report/tree.alpha.api.md	Updated namespace tags from @Alpha to @beta and removed @Sealed tag from createRowSchema
packages/dds/tree/src/tableSchema.ts	Updated JSDoc tags from @Alpha to @beta, reorganized documentation by moving orphaned cells info to System_TableSchema

packages/dds/tree/src/tableSchema.ts

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Josmithr · 2026-02-02T18:03:26Z

packages/dds/tree/src/tableSchema.ts

 	/**
 	 * Factory for creating row schema.
-	 * @sealed @alpha
+	 * @system @beta


Note for reviewers: the @sealed tag here was wrong. It should have been @system

packages/dds/tree/src/tableSchema.ts

packages/framework/fluid-framework/api-report/fluid-framework.beta.api.md

packages/dds/tree/src/tableSchema.ts

CraigMacomber

Seems like this should have a changeset

…apis

Josmithr · 2026-02-03T01:17:32Z

packages/dds/tree/src/tableSchema.ts

-		// This is effectively a work-around that allows columns and rows to invoke table methods
-		// without having to pass the table as a parameter to their construction, which isn't possible.
-		// eslint-disable-next-line @typescript-eslint/no-explicit-any
-		(Table as any)[tableSchemaSymbol] = true;


Note for reviewers: this symbol was being set, but was not read anywhere. The associated behaviors were removed a while back, and this appears to have been missed at that time.

.changeset/gross-apples-defend.md

.changeset/sickly-insects-whisper.md

CraigMacomber · 2026-02-03T17:41:48Z

packages/dds/tree/src/tableSchema.ts

- * A private symbol put on table schema to help identify them.
- */
-const tableSchemaSymbol: unique symbol = Symbol("tableNode");
+const baseSchemaScope = "com.fluidframework.tableV2";


Not necessarily for this this PR, but somewhere somehow, we should track all the scopes we have used at various points in time to avoid accidently reusing table someday. I imagine apps will have similar issues, so we should probably come up with something nice. Maybe a snapshot-based test setup, or a way to consume scopes so using them again will error.

Starting up a simple list of them in a DEV.md might be a good way to track them for now until we have a better system.

packages/runtime/runtime-definitions/README.md

.changeset/sickly-insects-whisper.md

Co-authored-by: Craig Macomber (Microsoft) <42876482+CraigMacomber@users.noreply.github.com>

…/FluidFramework into tree/promote-table-apis

github-actions · 2026-02-04T00:32:25Z

🔗 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:
  252163 links
    1804 destination URLs
    2045 URLs ignored
       0 warnings
       0 errors

feat(tree): Promote TableSchema APIs to beta

216600c

Josmithr requested review from a team, jumyhre and yann-achard-MS February 2, 2026 17:40

Josmithr requested review from a team as code owners February 2, 2026 17:40

Josmithr requested review from Copilot and noencke February 2, 2026 17:40

Copilot started reviewing on behalf of Josmithr February 2, 2026 17:41 View session

Josmithr commented Feb 2, 2026

View reviewed changes

packages/dds/tree/src/tableSchema.ts Show resolved Hide resolved

Josmithr commented Feb 2, 2026

View reviewed changes

packages/dds/tree/src/tableSchema.ts Show resolved Hide resolved

Copilot AI reviewed Feb 2, 2026

View reviewed changes

packages/dds/tree/src/tableSchema.ts Outdated Show resolved Hide resolved

packages/dds/tree/src/tableSchema.ts Outdated Show resolved Hide resolved

Josmithr and others added 3 commits February 2, 2026 17:59

docs: Add warning about extranious modification

45c8aee

docs: Fix typo

4ff1a5d

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

docs: Add missing @system tag

e6b281f

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Josmithr commented Feb 2, 2026

View reviewed changes

Josmithr added 2 commits February 2, 2026 18:05

docs: Update comment

0530cff

docs: Update API reports

793627c

Josmithr added the release-blocking Must be addressed before we cut and publish the next release label Feb 2, 2026

Josmithr requested review from CraigMacomber and jatgarg February 2, 2026 18:41

CraigMacomber reviewed Feb 2, 2026

View reviewed changes

packages/dds/tree/src/tableSchema.ts Outdated Show resolved Hide resolved

CraigMacomber reviewed Feb 2, 2026

View reviewed changes

packages/dds/tree/src/tableSchema.ts Show resolved Hide resolved

CraigMacomber reviewed Feb 2, 2026

View reviewed changes

packages/framework/fluid-framework/api-report/fluid-framework.beta.api.md Show resolved Hide resolved

CraigMacomber reviewed Feb 2, 2026

View reviewed changes

packages/dds/tree/src/tableSchema.ts Show resolved Hide resolved

CraigMacomber reviewed Feb 2, 2026

View reviewed changes

Josmithr added 4 commits February 2, 2026 13:08

docs: Update compat docs

0ced6ee

docs: Add remarks about index keys

11fdf89

docs: Add more index notes

f675595

feat(runtime-definitions): Promote MinimumVersionForCollab to beta

f75721d

Josmithr added 4 commits February 2, 2026 17:01

Merge branch 'tree/promote-minVersionOption' into tree/promote-table-…

43fb7c7

…apis

remove: Unused symbol property

4277c2d

refactor: Change schema scope naming and restore @beta tags

3f4eb8e

docs: Restore changeset

7cecfa0

Josmithr commented Feb 3, 2026

View reviewed changes

Merge branch 'main' into tree/promote-table-apis

ea0d391

CraigMacomber reviewed Feb 3, 2026

View reviewed changes

.changeset/gross-apples-defend.md Show resolved Hide resolved

CraigMacomber reviewed Feb 3, 2026

View reviewed changes

.changeset/sickly-insects-whisper.md Outdated Show resolved Hide resolved

CraigMacomber reviewed Feb 3, 2026

View reviewed changes

packages/runtime/runtime-definitions/README.md Show resolved Hide resolved

Josmithr added 7 commits February 3, 2026 09:50

Merge branch 'main' into tree/promote-table-apis

38332bf

Merge branch 'main' into tree/promote-table-apis

6082d9b

docs: Update changeset section

667cd5d

revert: runtime-definitions changes

857fb5d

revert(tree): Codec API changes

5b6446d

docs: Revert README change

55c881a

docs: Restore reverted documentation changes

5b1eb9c

CraigMacomber reviewed Feb 3, 2026

View reviewed changes

.changeset/sickly-insects-whisper.md Show resolved Hide resolved

Josmithr and others added 2 commits February 3, 2026 12:27

docs: Add compat note to changeset

45d2fc0

Co-authored-by: Craig Macomber (Microsoft) <42876482+CraigMacomber@users.noreply.github.com>

Merge branch 'main' into tree/promote-table-apis

698b710

CraigMacomber approved these changes Feb 3, 2026

View reviewed changes

jatgarg approved these changes Feb 3, 2026

View reviewed changes

Josmithr added 3 commits February 3, 2026 16:14

Merge branch 'main' into tree/promote-table-apis

cc8b0be

test: Update snapshots

0e9cf85

Merge branch 'tree/promote-table-apis' of https://github.com/Josmithr…

65b5dc6

…/FluidFramework into tree/promote-table-apis

CraigMacomber approved these changes Feb 4, 2026

View reviewed changes

Josmithr merged commit 36a625a into microsoft:main Feb 4, 2026
33 checks passed

Josmithr deleted the tree/promote-table-apis branch February 4, 2026 01:32

github-actions bot mentioned this pull request Feb 4, 2026

Upcoming Release: FluidFramework v2.93.0 #22101

Open

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

feat(tree): Promote TableSchema APIs to beta#26339

feat(tree): Promote TableSchema APIs to beta#26339
Josmithr merged 46 commits intomicrosoft:mainfrom
Josmithr:tree/promote-table-apis

Josmithr commented Feb 2, 2026 •

edited

Loading

Uh oh!

Uh oh!

Uh oh!

Copilot AI left a comment

Uh oh!

Uh oh!

Uh oh!

Josmithr Feb 2, 2026

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

CraigMacomber left a comment

Uh oh!

Josmithr Feb 3, 2026

Uh oh!

Uh oh!

Uh oh!

CraigMacomber Feb 3, 2026

Uh oh!

Uh oh!

Uh oh!

github-actions bot commented Feb 4, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

Conversation

Josmithr commented Feb 2, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Uh oh!

Uh oh!

Josmithr Feb 2, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

CraigMacomber left a comment

Choose a reason for hiding this comment

Uh oh!

Josmithr Feb 3, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

CraigMacomber Feb 3, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

github-actions bot commented Feb 4, 2026

linkcheck output

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

Josmithr commented Feb 2, 2026 •

edited

Loading