Skip to content

Promote IFluidDevtools to beta#25695

Merged
jikim-msft merged 15 commits intomicrosoft:mainfrom
jikim-msft:devtools/bump-to-beta
Oct 23, 2025
Merged

Promote IFluidDevtools to beta#25695
jikim-msft merged 15 commits intomicrosoft:mainfrom
jikim-msft:devtools/bump-to-beta

Conversation

@jikim-msft
Copy link
Copy Markdown
Contributor

@jikim-msft jikim-msft commented Oct 15, 2025

Description

This PR promotes IFluidDevtools interface from alpha to beta for integration into partner repos.

@jikim-msft jikim-msft requested review from a team as code owners October 15, 2025 07:31
Copilot AI review requested due to automatic review settings October 15, 2025 07:31
@github-actions github-actions bot added the public api change Changes to a public API label Oct 15, 2025
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull Request Overview

This PR promotes the IFluidDevtools interface and related components from alpha to beta stability level to support devtools integration in Office-Bohemia.

  • Updated API stability tags from @alpha to @beta for devtools interfaces
  • Added IFluidDevtools interface to the beta API surface
  • Updated alpha API report to reflect the promotion

Reviewed Changes

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

Show a summary per file
File Description
packages/tools/devtools/devtools-core/src/IFluidDevtools.ts Changed JSDoc tag from @alpha to @beta
packages/tools/devtools/devtools-core/src/ContainerRuntimeDevtools.ts Changed JSDoc tag from @alpha to @beta for ContainerRuntimeProps
packages/tools/devtools/devtools-core/src/ContainerDevtools.ts Changed JSDoc tag from @alpha to @beta for ContainerDevtoolsProps
packages/tools/devtools/devtools-core/api-report/devtools-core.beta.api.md Added IFluidDevtools interface to beta API surface
packages/tools/devtools/devtools-core/api-report/devtools-core.alpha.api.md Updated IFluidDevtools tag from @alpha to @beta

@github-actions github-actions bot added the base: main PRs targeted against main branch label Oct 15, 2025
@jikim-msft jikim-msft requested a review from a team as a code owner October 15, 2025 07:36
Copy link
Copy Markdown
Contributor

@alexvy86 alexvy86 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We need to also make initializeDevtools and/or tryGetFluidDevtools beta, right? Exposing just the interfaces doesn't really let applications do much, since they are not designed to be implemented externally.

---
Promote IFluidDevtools APIs from alpha to beta

`IFluidDevtools` may now be imported from `/beta`.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Have you verified that devtools-core's package.json includes an export for the beta level? If not, these APIs still won't be importable via /beta. I can help you make the necessary changes if not / you have questions :)

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for pointing out! Didn't know adding beta field in package.json is necessary.

I've referenced pacakges/dds/tree and added new esm & cjs config files and the new fields in the package.json.

@jikim-msft jikim-msft requested a review from alexvy86 October 21, 2025 10:21
Copy link
Copy Markdown
Contributor

@alexvy86 alexvy86 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Left a few more comments. I also think API report regeneration is needed? Some of the changes in the ts files aren't reflected in the API reports (readonly on some properties).

jikim-msft and others added 3 commits October 22, 2025 16:47
Co-authored-by: Alex Villarreal <716334+alexvy86@users.noreply.github.com>
…ools.ts

Co-authored-by: Alex Villarreal <716334+alexvy86@users.noreply.github.com>
Co-authored-by: Alex Villarreal <716334+alexvy86@users.noreply.github.com>
@github-actions
Copy link
Copy Markdown
Contributor

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

Copy link
Copy Markdown
Contributor

@alexvy86 alexvy86 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks good to me :)

@jikim-msft jikim-msft merged commit 7c8e203 into microsoft:main Oct 23, 2025
40 checks passed
anthony-murphy-agent pushed a commit to anthony-murphy-agent/FluidFramework that referenced this pull request Jan 14, 2026
#### Description 

This PR promotes `IFluidDevtools` interface from `alpha` to `beta` for
integration into partner repos.

---------

Co-authored-by: Alex Villarreal <716334+alexvy86@users.noreply.github.com>
@jikim-msft jikim-msft deleted the devtools/bump-to-beta branch March 14, 2026 01:52
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

base: main PRs targeted against main branch changeset-present public api change Changes to a public API

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants