Expose `staged`, `types`, `stagedRecursive` and `typesRecursive` on `… by daesunp · Pull Request #25779 · microsoft/FluidFramework

daesunp · 2025-10-30T22:50:33Z

Description

This PR promotes SchemaStaticsAlpha to SchemaStaticsBeta, and exposes staged, types, stagedRecursive and typesRecursive to be used in beta apps.

…SchemaFactoryBeta`

docs/docs/data-structures/tree/schema-evolution/allowed-types-rollout.mdx

CraigMacomber · 2025-11-03T20:35:32Z

packages/dds/tree/api-report/tree.alpha.api.md

-    static readonly identifier: <const TCustomMetadata = unknown>(props?: Omit<FieldProps<TCustomMetadata>, "defaultProvider"> | undefined) => FieldSchemaAlpha<FieldKind.Identifier, LeafSchema<"string", string> & SimpleLeafNodeSchema, TCustomMetadata>;
-    static readonly leaves: readonly [LeafSchema<"string", string> & SimpleLeafNodeSchema, LeafSchema<"number", number> & SimpleLeafNodeSchema, LeafSchema<"boolean", boolean> & SimpleLeafNodeSchema, LeafSchema<"null", null> & SimpleLeafNodeSchema, LeafSchema<"handle", IFluidHandle_2<unknown>> & SimpleLeafNodeSchema];
-    readonly leaves: readonly [LeafSchema<"string", string> & SimpleLeafNodeSchema, LeafSchema<"number", number> & SimpleLeafNodeSchema, LeafSchema<"boolean", boolean> & SimpleLeafNodeSchema, LeafSchema<"null", null> & SimpleLeafNodeSchema, LeafSchema<"handle", IFluidHandle_2<unknown>> & SimpleLeafNodeSchema];
+    static readonly identifier: <const TCustomMetadata = unknown>(props?: Omit<FieldProps<TCustomMetadata>, "defaultProvider"> | undefined) => FieldSchemaAlpha<FieldKind.Identifier, LeafSchema_3<"string", string> & SimpleLeafNodeSchema_2, TCustomMetadata>;


There is a block of imports in SchemFactoryAlpha comments with

// These imports prevent a large number of type references in the API reports from showing up as *_2.

Try copying that into schema factory beta and seeing if that cleans up this mess.

Actually, I think the issue is you removed some of those imports from that block from schema factory alpha. Those unused imports clean up this mess (it is dumb included unused imports fixes things, but that's the world we live in)

Added back in the removed imports and re-ran npm run build:docs

CraigMacomber · 2025-11-05T00:02:05Z

.changeset/metal-games-love.md

+"@fluidframework/tree": minor
+"__section": feature
+---
+Expose `staged`, `types`, `stagedRecursive` and `typesRecursive` on `SchemaFactoryBeta`


See https://github.com/microsoft/FluidFramework/wiki/Changesets#formatting :

The title/heading should not contain code formatting

CraigMacomber · 2025-11-05T00:02:35Z

.changeset/metal-games-love.md

+---
+Expose `staged`, `types`, `stagedRecursive` and `typesRecursive` on `SchemaFactoryBeta`
+
+These APIs were previously only available on `SchemaFactoryAlpha`, but is now available on `SchemaFactoryBeta`.


Suggested change

These APIs were previously only available on `SchemaFactoryAlpha`, but is now available on `SchemaFactoryBeta`.

These APIs were previously only available on `SchemaFactoryAlpha`, but are now available on `SchemaFactoryBeta`.

Copilot

Pull Request Overview

This PR promotes the staged, types, stagedRecursive, and typesRecursive APIs from alpha to beta stability level by moving them from SchemaFactoryAlpha to SchemaFactoryBeta, along with related type definitions and documentation updates.

Key changes:

Move SchemaStaticsBeta interface and related APIs from SchemaFactoryAlpha to SchemaFactoryBeta
Update all documentation references from SchemaStaticsAlpha to SchemaStaticsBeta
Change API stability tags from @alpha to @beta for related types and interfaces

Reviewed Changes

Copilot reviewed 20 out of 20 changed files in this pull request and generated 4 comments.

Show a summary per file

File	Description
packages/dds/tree/src/simple-tree/api/schemaFactoryBeta.ts	Adds `SchemaStaticsBeta` interface and implements `staged`, `types`, `stagedRecursive`, and `typesRecursive` methods on `SchemaFactoryBeta`
packages/dds/tree/src/simple-tree/api/schemaFactoryAlpha.ts	Removes `SchemaStaticsAlpha` interface and related implementations (moved to Beta)
packages/dds/tree/src/simple-tree/api/typesUnsafe.ts	Updates API stability tags from `@alpha` to `@beta` for unsafe type utilities
packages/dds/tree/src/simple-tree/api/index.ts	Updates exports to export `SchemaStaticsBeta` from schemaFactoryBeta instead of `SchemaStaticsAlpha` from schemaFactoryAlpha
packages/dds/tree/src/simple-tree/index.ts	Updates public exports to expose `SchemaStaticsBeta` and remove `SchemaStaticsAlpha`
packages/dds/tree/src/index.ts	Updates main package exports for the API level change
packages/dds/tree/src/simple-tree/simpleSchema.ts	Updates documentation references from `SchemaStaticsAlpha` to `SchemaStaticsBeta`
packages/dds/tree/src/simple-tree/core/allowedTypes.ts	Updates documentation references from `SchemaStaticsAlpha` to `SchemaStaticsBeta`
packages/dds/tree/src/simple-tree/api/tree.ts	Updates documentation references from `SchemaStaticsAlpha` to `SchemaStaticsBeta`
packages/dds/tree/src/simple-tree/api/incrementalAllowedTypes.ts	Updates documentation reference from `SchemaStaticsAlpha` to `SchemaStaticsBeta`
packages/dds/tree/src/simple-tree/api/discrepancies.ts	Updates documentation references from `SchemaStaticsAlpha` to `SchemaStaticsBeta`
packages/dds/tree/src/shared-tree/treeAlpha.ts	Updates documentation reference from `SchemaStaticsAlpha` to `SchemaStaticsBeta`
docs/docs/data-structures/tree/schema-evolution/allowed-types-rollout.mdx	Updates documentation links from SchemaFactoryAlpha to SchemaFactoryBeta
packages/framework/fluid-framework/api-report/*.api.md	API report updates reflecting the stability level changes
packages/dds/tree/api-report/*.api.md	API report updates reflecting the stability level changes
.changeset/metal-games-love.md	Changeset documenting the feature promotion

docs/docs/data-structures/tree/schema-evolution/allowed-types-rollout.mdx

packages/dds/tree/src/simple-tree/api/schemaFactoryBeta.ts

Co-authored-by: Joshua Smithrud <54606601+Josmithr@users.noreply.github.com>

github-actions · 2025-11-05T21:20:40Z

🔗 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.

microsoft#25779) ## Description This PR promotes SchemaStaticsAlpha to SchemaStaticsBeta, and exposes `staged`, `types`, `stagedRecursive` and `typesRecursive` to be used in beta apps. --------- Co-authored-by: Joshua Smithrud <54606601+Josmithr@users.noreply.github.com>

Expose staged, types, stagedRecursive and typesRecursive on `…

b959b26

…SchemaFactoryBeta`

github-actions bot added area: dds Issues related to distributed data structures area: dds: tree changeset-present base: main PRs targeted against main branch labels Oct 30, 2025

Update api docs

d8dd525

github-actions bot added area: framework Framework is a tag for issues involving the developer framework. Eg Aqueduct public api change Changes to a public API labels Oct 31, 2025

daesunp added 3 commits October 31, 2025 18:46

api docs fix

8399356

export fix

1508f49

fix broken links

803e959

github-actions bot added the area: website label Oct 31, 2025

daesunp added 4 commits October 31, 2025 22:00

fix broken link

1a7582a

Revert previous link

6bdfb14

Merge branch 'main' into promote-staged-to-beta

c840c17

fix link

3cd1ad6

CraigMacomber reviewed Nov 3, 2025

View reviewed changes

docs/docs/data-structures/tree/schema-evolution/allowed-types-rollout.mdx Outdated Show resolved Hide resolved

CraigMacomber reviewed Nov 3, 2025

View reviewed changes

daesunp added 3 commits November 3, 2025 22:16

PR review

6cee8f5

Merge branch 'main' into promote-staged-to-beta

d470bc1

Update api docs after clearing node_modules

08b8fcf

daesunp marked this pull request as ready for review November 4, 2025 23:59

daesunp requested review from a team as code owners November 4, 2025 23:59

Copilot AI review requested due to automatic review settings November 4, 2025 23:59

daesunp requested a review from a team as a code owner November 4, 2025 23:59

CraigMacomber reviewed Nov 5, 2025

View reviewed changes

Copilot AI reviewed Nov 5, 2025

View reviewed changes

CraigMacomber reviewed Nov 5, 2025

View reviewed changes

docs/docs/data-structures/tree/schema-evolution/allowed-types-rollout.mdx Show resolved Hide resolved

Fixed changeset title and grammar

e387e0d

CraigMacomber approved these changes Nov 5, 2025

View reviewed changes

Josmithr reviewed Nov 5, 2025

View reviewed changes

packages/dds/tree/src/simple-tree/api/schemaFactoryBeta.ts Outdated Show resolved Hide resolved

Josmithr approved these changes Nov 5, 2025

View reviewed changes

Update packages/dds/tree/src/simple-tree/api/schemaFactoryBeta.ts

466ae02

Co-authored-by: Joshua Smithrud <54606601+Josmithr@users.noreply.github.com>

noencke approved these changes Nov 5, 2025

View reviewed changes

daesunp merged commit 75d7f11 into microsoft:main Nov 5, 2025
38 checks passed

This was referenced Nov 5, 2025

Upcoming Release: FluidFramework v2.92.0 #22101

Open

Upcoming Release: FluidFramework v2.92.0 tylerbutler/FluidFramework#26

Closed

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Expose `staged`, `types`, `stagedRecursive` and `typesRecursive` on `…#25779

Expose `staged`, `types`, `stagedRecursive` and `typesRecursive` on `…#25779
daesunp merged 14 commits intomicrosoft:mainfrom
daesunp:promote-staged-to-beta

daesunp commented Oct 30, 2025 •

edited

Loading

Uh oh!

Uh oh!

CraigMacomber Nov 3, 2025

Uh oh!

CraigMacomber Nov 3, 2025

Uh oh!

daesunp Nov 4, 2025

Uh oh!

CraigMacomber Nov 5, 2025

Uh oh!

CraigMacomber Nov 5, 2025

Uh oh!

Copilot AI left a comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

github-actions bot commented Nov 5, 2025

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

5 participants

	These APIs were previously only available on `SchemaFactoryAlpha`, but is now available on `SchemaFactoryBeta`.
	These APIs were previously only available on `SchemaFactoryAlpha`, but are now available on `SchemaFactoryBeta`.

Conversation

daesunp commented Oct 30, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Description

Uh oh!

Uh oh!

CraigMacomber Nov 3, 2025

Choose a reason for hiding this comment

Uh oh!

CraigMacomber Nov 3, 2025

Choose a reason for hiding this comment

Uh oh!

daesunp Nov 4, 2025

Choose a reason for hiding this comment

Uh oh!

CraigMacomber Nov 5, 2025

Choose a reason for hiding this comment

Uh oh!

CraigMacomber Nov 5, 2025

Choose a reason for hiding this comment

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!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

github-actions bot commented Nov 5, 2025

linkcheck output

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

5 participants

daesunp commented Oct 30, 2025 •

edited

Loading