Promote IFluidDevtools to beta (microsoft#25695)

#### 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>

Author: 2 people

.changeset/few-plants-strive.md

@@ -0,0 +1,32 @@
+---
+"@fluidframework/devtools-core": minor
+"__section": feature
+---
+Promote core devtools APIs from alpha to beta
+
+The primary devtools APIs may now be imported from `/beta`. This includes:
+
+- **`initializeDevtools`** - Initialize the devtools singleton
+- **`tryGetFluidDevtools`** - Get the existing devtools instance if initialized
+- **`IFluidDevtools`** - Main devtools interface for registering containers
+- **`ContainerDevtoolsProps`** - Properties for registering containers with devtools
+
+For example:
+
+```typescript
+import {
+  initializeDevtools,
+  tryGetFluidDevtools,
+  type IFluidDevtools,
+  type ContainerDevtoolsProps
+} from "@fluidframework/devtools-core/beta";
+
+// Initialize devtools
+const devtools = initializeDevtools();
+
+// Register a container
+devtools.registerContainerDevtools({
+  containerKey: "my-container",
+  container: myContainer
+});
+```

packages/tools/devtools/devtools-core/README.md

@@ -34,6 +34,8 @@ For more information on the related support guarantees, see [API Support Levels]
 
 To access the `public` ([SemVer](https://semver.org/)) APIs, import via `@fluidframework/devtools-core` like normal.
 
+To access the `beta` APIs, import via `@fluidframework/devtools-core/beta`.
+
 To access the `alpha` APIs, import via `@fluidframework/devtools-core/alpha`.
 
 ## API Documentation

packages/tools/devtools/devtools-core/api-extractor/api-extractor-lint-beta.cjs.json

@@ -0,0 +1,5 @@
+{
+	"$schema": "https://developer.microsoft.com/json-schemas/api-extractor/v7/api-extractor.schema.json",
+	"extends": "<projectFolder>/../../../../common/build/build-common/api-extractor-lint.entrypoint.json",
+	"mainEntryPointFilePath": "<projectFolder>/dist/beta.d.ts"
+}

packages/tools/devtools/devtools-core/api-extractor/api-extractor-lint-beta.esm.json

@@ -0,0 +1,5 @@
+{
+	"$schema": "https://developer.microsoft.com/json-schemas/api-extractor/v7/api-extractor.schema.json",
+	"extends": "<projectFolder>/../../../../common/build/build-common/api-extractor-lint.entrypoint.json",
+	"mainEntryPointFilePath": "<projectFolder>/lib/beta.d.ts"
+}

packages/tools/devtools/devtools-core/api-report/devtools-core.alpha.api.md

@@ -4,28 +4,28 @@
 
 ```ts
 
-// @alpha
+// @beta @sealed @input
 export interface ContainerDevtoolsProps extends HasContainerKey {
-    container: IContainer;
-    containerData?: Record<string, IFluidLoadable>;
+    readonly container: IContainer;
+    readonly containerData?: Record<string, IFluidLoadable>;
 }
 
 // @beta
 export type ContainerKey = string;
 
-// @alpha @input
+// @beta @sealed @input
 export interface ContainerRuntimeProps {
-    label?: string;
+    readonly label?: string;
     readonly runtime: IContainerRuntime;
 }
 
 // @beta
 export function createDevtoolsLogger(baseLogger?: ITelemetryBaseLogger): IDevtoolsLogger;
 
-// @alpha
+// @beta @sealed @input
 export interface FluidDevtoolsProps {
-    initialContainers?: ContainerDevtoolsProps[];
-    logger?: IDevtoolsLogger;
+    readonly initialContainers?: ContainerDevtoolsProps[];
+    readonly logger?: IDevtoolsLogger;
 }
 
 // @beta @sealed @system
@@ -37,17 +37,17 @@ export interface HasContainerKey {
 export interface IDevtoolsLogger extends ITelemetryBaseLogger {
 }
 
-// @alpha @sealed
+// @beta @sealed
 export interface IFluidDevtools extends IDisposable {
     closeContainerDevtools(containerKey: ContainerKey): void;
     registerContainerDevtools(props: ContainerDevtoolsProps): void;
     registerContainerRuntime(props: ContainerRuntimeProps): Promise<void>;
 }
 
-// @alpha
+// @beta
 export function initializeDevtools(props?: FluidDevtoolsProps): IFluidDevtools;
 
-// @alpha
+// @beta
 export function tryGetFluidDevtools(): IFluidDevtools | undefined;
 
 ```

packages/tools/devtools/devtools-core/api-report/devtools-core.beta.api.md

@@ -4,12 +4,30 @@
 
 ```ts
 
+// @beta @sealed @input
+export interface ContainerDevtoolsProps extends HasContainerKey {
+    readonly container: IContainer;
+    readonly containerData?: Record<string, IFluidLoadable>;
+}
+
 // @beta
 export type ContainerKey = string;
 
+// @beta @sealed @input
+export interface ContainerRuntimeProps {
+    readonly label?: string;
+    readonly runtime: IContainerRuntime;
+}
+
 // @beta
 export function createDevtoolsLogger(baseLogger?: ITelemetryBaseLogger): IDevtoolsLogger;
 
+// @beta @sealed @input
+export interface FluidDevtoolsProps {
+    readonly initialContainers?: ContainerDevtoolsProps[];
+    readonly logger?: IDevtoolsLogger;
+}
+
 // @beta @sealed @system
 export interface HasContainerKey {
     readonly containerKey: ContainerKey;
@@ -19,4 +37,17 @@ export interface HasContainerKey {
 export interface IDevtoolsLogger extends ITelemetryBaseLogger {
 }
 
+// @beta @sealed
+export interface IFluidDevtools extends IDisposable {
+    closeContainerDevtools(containerKey: ContainerKey): void;
+    registerContainerDevtools(props: ContainerDevtoolsProps): void;
+    registerContainerRuntime(props: ContainerRuntimeProps): Promise<void>;
+}
+
+// @beta
+export function initializeDevtools(props?: FluidDevtoolsProps): IFluidDevtools;
+
+// @beta
+export function tryGetFluidDevtools(): IFluidDevtools | undefined;
+
 ```

packages/tools/devtools/devtools-core/package.json

@@ -33,6 +33,16 @@
 				"default": "./dist/index.js"
 			}
 		},
+		"./beta": {
+			"import": {
+				"types": "./lib/beta.d.ts",
+				"default": "./lib/index.js"
+			},
+			"require": {
+				"types": "./dist/beta.d.ts",
+				"default": "./dist/index.js"
+			}
+		},
 		"./internal": {
 			"import": {
 				"types": "./lib/index.d.ts",
@@ -64,8 +74,10 @@
 		"check:exports": "concurrently \"npm:check:exports:*\"",
 		"check:exports:bundle-release-tags": "api-extractor run --config api-extractor/api-extractor-lint-bundle.json",
 		"check:exports:cjs:alpha": "api-extractor run --config api-extractor/api-extractor-lint-alpha.cjs.json",
+		"check:exports:cjs:beta": "api-extractor run --config api-extractor/api-extractor-lint-beta.cjs.json",
 		"check:exports:cjs:public": "api-extractor run --config api-extractor/api-extractor-lint-public.cjs.json",
 		"check:exports:esm:alpha": "api-extractor run --config api-extractor/api-extractor-lint-alpha.esm.json",
+		"check:exports:esm:beta": "api-extractor run --config api-extractor/api-extractor-lint-beta.esm.json",
 		"check:exports:esm:public": "api-extractor run --config api-extractor/api-extractor-lint-public.esm.json",
 		"check:format": "npm run check:biome",
 		"ci:build:docs": "api-extractor run",

packages/tools/devtools/devtools-core/src/ContainerDevtools.ts

@@ -18,13 +18,15 @@ import {
 
 /**
  * Properties for registering a {@link @fluidframework/container-definitions#IContainer} with the Devtools.
- * @alpha
+ * @beta
+ * @input
+ * @sealed
  */
 export interface ContainerDevtoolsProps extends HasContainerKey {
 	/**
 	 * The Container to register with the Devtools.
 	 */
-	container: IContainer;
+	readonly container: IContainer;
 
 	/**
 	 * (optional) Distributed Data Structures (DDSs) associated with the
@@ -39,7 +41,7 @@ export interface ContainerDevtoolsProps extends HasContainerKey {
 	 *
 	 * @privateRemarks TODO: rename this to make it more clear that this data does not *belong* to the Container.
 	 */
-	containerData?: Record<string, IFluidLoadable>;
+	readonly containerData?: Record<string, IFluidLoadable>;
 
 	// TODO: Add ability for customers to specify custom visualizer overrides
 }

packages/tools/devtools/devtools-core/src/ContainerRuntimeDevtools.ts

@@ -23,7 +23,8 @@ import type { InboundHandlers } from "./messaging/index.js";
 
 /**
  * Properties for registering a container runtime with the Devtools.
- * @alpha
+ * @beta
+ * @sealed
  * @input
  */
 export interface ContainerRuntimeProps {
@@ -35,7 +36,7 @@ export interface ContainerRuntimeProps {
 	/**
 	 * Optional label for the container runtime replacing the guid generated by {@link @fluidframework/container-runtime#IContainerRuntime.generateDocumentUniqueId}.
 	 */
-	label?: string;
+	readonly label?: string;
 }
 
 /**

packages/tools/devtools/devtools-core/src/FluidDevtools.ts

@@ -77,7 +77,9 @@ export function getContainerAlreadyRegisteredErrorText(containerKey: ContainerKe
 
 /**
  * Properties for configuring the Devtools.
- * @alpha
+ * @beta
+ * @input
+ * @sealed
  */
 export interface FluidDevtoolsProps {
 	/**
@@ -90,14 +92,14 @@ export interface FluidDevtoolsProps {
 	 * This is provided to the Devtools instance strictly to enable communicating supported / desired functionality with
 	 * external listeners.
 	 */
-	logger?: IDevtoolsLogger;
+	readonly logger?: IDevtoolsLogger;
 
 	/**
 	 * (optional) List of Containers to initialize the devtools with.
 	 *
 	 * @remarks Additional Containers can be registered with the Devtools via {@link IFluidDevtools.registerContainerDevtools}.
 	 */
-	initialContainers?: ContainerDevtoolsProps[];
+	readonly initialContainers?: ContainerDevtoolsProps[];
 
 	// TODO: Add ability for customers to specify custom data visualizer overrides
 }
@@ -517,15 +519,15 @@ export class FluidDevtools implements IFluidDevtools {
  *
  * It is automatically disposed on webpage unload, but it can be closed earlier by calling `dispose`
  * on the returned handle.
- * @alpha
+ * @beta
  */
 export function initializeDevtools(props?: FluidDevtoolsProps): IFluidDevtools {
 	return FluidDevtools.initialize(props);
 }
 
 /**
  * Gets the Devtools singleton if it has been {@link initializeDevtools | initialized}, otherwise returns `undefined`.
- * @alpha
+ * @beta
  */
 export function tryGetFluidDevtools(): IFluidDevtools | undefined {
 	return FluidDevtools.tryGet();