microsoft · scottn12 · Jun 1, 2026
@@ -0,0 +1,16 @@
+---
+"@fluidframework/fluid-static": minor
+"@fluidframework/azure-client": minor
+"@fluidframework/tinylicious-client": minor
+"__section": legacy
+---
+
+Remove deprecated CompatibilityMode APIs
+
+Deprecated `CompatibilityMode` exports and overloads have been removed from `@fluidframework/fluid-static`, `@fluidframework/azure-client`, and `@fluidframework/tinylicious-client`.
+
+Use `MinimumVersionForCollab` SemVer strings instead:
+
+- Pass `minVersionForCollaboration` to `createTreeContainerRuntimeFactory`.
+- Pass a `MinimumVersionForCollab` argument to `AzureClient.createContainer`, `AzureClient.getContainer`, `AzureClient.viewContainerVersion`, `TinyliciousClient.createContainer`, and `TinyliciousClient.getContainer`.
+- Replace legacy mode values `"1"` and `"2"` with `"1.0.0"` and `"2.0.0"`.
diff --git a/packages/framework/fluid-static/api-report/fluid-static.alpha.api.md b/packages/framework/fluid-static/api-report/fluid-static.alpha.api.md
@@ -4,9 +4,6 @@
 
 ```ts
 
-// @public @deprecated
-export type CompatibilityMode = "1" | "2";
-
 // @public
 export type ContainerAttachProps<T = unknown> = T;
 

@@ -4,9 +4,6 @@
 
 ```ts
 
-// @public @deprecated
-export type CompatibilityMode = "1" | "2";
-
 // @public
 export type ContainerAttachProps<T = unknown> = T;
 

@@ -4,9 +4,6 @@
 
 ```ts
 
-// @public @deprecated
-export type CompatibilityMode = "1" | "2";
-
 // @public
 export type ContainerAttachProps<T = unknown> = T;
 
@@ -24,15 +21,6 @@ export function createTreeContainerRuntimeFactory(props: {
     readonly runtimeOptionOverrides?: Partial<IContainerRuntimeOptions>;
 }): IRuntimeFactory;
 
-// @beta @deprecated @legacy
-export function createTreeContainerRuntimeFactory(props: {
-    readonly schema: TreeContainerSchema;
-    readonly compatibilityMode: CompatibilityMode;
-    readonly rootDataStoreRegistry?: IFluidDataStoreRegistry;
-    readonly runtimeOptionOverrides?: Partial<IContainerRuntimeOptions>;
-    readonly minVersionForCollabOverride?: MinimumVersionForCollab;
-}): IRuntimeFactory;
-
 // @public
 export const getPresence: (fluidContainer: IFluidContainer) => Presence;
 

@@ -4,9 +4,6 @@
 
 ```ts
 
-// @public @deprecated
-export type CompatibilityMode = "1" | "2";
-
 // @public
 export type ContainerAttachProps<T = unknown> = T;
 

@@ -4,9 +4,6 @@
 
 ```ts
 
-// @public @deprecated
-export type CompatibilityMode = "1" | "2";
-
 // @public
 export type ContainerAttachProps<T = unknown> = T;
 

diff --git a/packages/framework/fluid-static/package.json b/packages/framework/fluid-static/package.json
@@ -171,7 +171,12 @@
 		"typescript": "~5.4.5"
 	},
 	"typeValidation": {
-		"broken": {},
+		"broken": {
+			"TypeAlias_CompatibilityMode": {
+				"forwardCompat": false,
+				"backCompat": false
+			}
+		},
 		"entrypoint": "public"
 	}
 }
diff --git a/packages/framework/fluid-static/src/index.ts b/packages/framework/fluid-static/src/index.ts
@@ -22,7 +22,6 @@ export { createDOProviderContainerRuntimeFactory } from "./rootDataObject.js";
 export { createServiceAudience } from "./serviceAudience.js";
 export { createTreeContainerRuntimeFactory } from "./treeRootDataObject.js";
 export type {
-	CompatibilityMode,
 	ContainerSchema,
 	ContainerAttachProps,
 	IConnection,
@@ -33,7 +32,4 @@ export type {
 	Myself,
 	TreeContainerSchema,
 } from "./types.js";
-export {
-	isTreeContainerSchema,
-	resolveCompatibilityModeToMinVersionForCollab,
-} from "./utils.js";
+export { isTreeContainerSchema } from "./utils.js";
diff --git a/packages/framework/fluid-static/src/test/types/validateFluidStaticPrevious.generated.ts b/packages/framework/fluid-static/src/test/types/validateFluidStaticPrevious.generated.ts
@@ -132,6 +132,7 @@ declare type current_as_old_for_Interface_IServiceAudienceEvents = requireAssign
  * typeValidation.broken:
  * "TypeAlias_CompatibilityMode": {"forwardCompat": false}
  */
+// @ts-expect-error compatibility expected to be broken
 declare type old_as_current_for_TypeAlias_CompatibilityMode = requireAssignableTo<TypeOnly<old.CompatibilityMode>, TypeOnly<current.CompatibilityMode>>
 
 /*
@@ -141,6 +142,7 @@ declare type old_as_current_for_TypeAlias_CompatibilityMode = requireAssignableT
  * typeValidation.broken:
  * "TypeAlias_CompatibilityMode": {"backCompat": false}
  */
+// @ts-expect-error compatibility expected to be broken
 declare type current_as_old_for_TypeAlias_CompatibilityMode = requireAssignableTo<TypeOnly<current.CompatibilityMode>, TypeOnly<old.CompatibilityMode>>
 
 /*

diff --git a/packages/framework/fluid-static/src/treeRootDataObject.ts b/packages/framework/fluid-static/src/treeRootDataObject.ts
@@ -33,8 +33,6 @@ import type { SharedObjectKind } from "@fluidframework/shared-object-base/intern
 
 import { defaultRuntimeOptionsForMinVersion } from "./compatibilityConfiguration.js";
 import type {
-	// eslint-disable-next-line import-x/no-deprecated
-	CompatibilityMode,
 	IRootDataObject,
 	IStaticEntryPoint,
 	LoadableObjectKind,
@@ -48,7 +46,6 @@ import {
 	isSharedObjectKind,
 	makeFluidObject,
 	parseDataObjectsFromSharedObjects,
-	resolveCompatibilityModeToMinVersionForCollab,
 } from "./utils.js";
 
 /**
@@ -225,80 +222,15 @@ export function createTreeContainerRuntimeFactory(props: {
 	readonly runtimeOptionOverrides?: Partial<IContainerRuntimeOptions>;
 }): IRuntimeFactory;
 
-/**
- * Creates an {@link @fluidframework/aqueduct#IRuntimeFactory} which constructs containers
- * with an entry point containing single tree-based root data object.
- *
- * @remarks
- * The entry point is opaque to caller.
- * The root data object's registry and shared objects are configured based on the provided
- * SharedTree and optional data store registry.
- *
- * @deprecated Pass `minVersionForCollaboration` directly instead of using `compatibilityMode`.
- *
- * @legacy @beta
- */
-export function createTreeContainerRuntimeFactory(props: {
-	/**
-	 * The schema for the container.
-	 */
-	readonly schema: TreeContainerSchema;
-
-	/**
-	 * Legacy compatibility mode for the container.
-	 */
-	// eslint-disable-next-line import-x/no-deprecated
-	readonly compatibilityMode: CompatibilityMode;
-	/**
-	 * Optional registry of data stores to pass to the DataObject factory.
-	 * If not provided, one will be created based on the schema.
-	 */
-	readonly rootDataStoreRegistry?: IFluidDataStoreRegistry;
-	/**
-	 * Optional overrides for the container runtime options.
-	 * If not provided, only the default options for the given compatibilityMode will be used.
-	 */
-	readonly runtimeOptionOverrides?: Partial<IContainerRuntimeOptions>;
-	/**
-	 * Optional override for minimum version for collaboration.
-	 * @remarks
-	 * If not provided, the default for the given compatibilityMode will be used.
-	 * Rather than defining this, omit `compatibilityMode` and pass `minVersionForCollaboration` directly.
-	 */
-	readonly minVersionForCollabOverride?: MinimumVersionForCollab;
-}): IRuntimeFactory;
-
 // Implementation
 export function createTreeContainerRuntimeFactory(props: {
 	readonly schema: TreeContainerSchema;
-	// eslint-disable-next-line import-x/no-deprecated
-	readonly compatibilityMode?: CompatibilityMode;
-	readonly minVersionForCollaboration?: MinimumVersionForCollab;
+	readonly minVersionForCollaboration: MinimumVersionForCollab;
 	readonly rootDataStoreRegistry?: IFluidDataStoreRegistry;
 	readonly runtimeOptionOverrides?: Partial<IContainerRuntimeOptions>;
-	readonly minVersionForCollabOverride?: MinimumVersionForCollab;
 }): IRuntimeFactory {
-	const {
-		compatibilityMode,
-		minVersionForCollaboration,
-		minVersionForCollabOverride,
-		rootDataStoreRegistry,
-		runtimeOptionOverrides,
-		schema,
-	} = props;
-
-	let minVersionForCollab: MinimumVersionForCollab;
-	if (minVersionForCollaboration !== undefined) {
-		minVersionForCollab = minVersionForCollaboration;
-	} else if (compatibilityMode === undefined) {
-		throw new Error(
-			"Either minVersionForCollaboration or compatibilityMode (deprecated) must be provided.",
-		);
-	} else {
-		minVersionForCollab =
-			minVersionForCollabOverride ??
-			resolveCompatibilityModeToMinVersionForCollab(compatibilityMode);
-	}
+	const { minVersionForCollaboration, rootDataStoreRegistry, runtimeOptionOverrides, schema } =
+		props;
 
 	const [registryEntries, sharedObjects] = parseDataObjectsFromSharedObjects(schema);
 	const registry = rootDataStoreRegistry ?? new FluidDataStoreRegistry(registryEntries);
@@ -307,7 +239,7 @@ export function createTreeContainerRuntimeFactory(props: {
 		new TreeRootDataObjectFactory(sharedObjects, registry),
 		{
 			runtimeOptions: runtimeOptionOverrides,
-			minVersionForCollab,
+			minVersionForCollab: minVersionForCollaboration,
 		},
 	);
 }
diff --git a/packages/framework/fluid-static/src/types.ts b/packages/framework/fluid-static/src/types.ts
@@ -17,21 +17,6 @@ import type {
 } from "@fluidframework/shared-object-base/internal";
 import type { ITree } from "@fluidframework/tree";
 
-/**
- * Determines the set of runtime options that Fluid Framework will use when running.
- * In "1" mode we support full interop between 2.x clients and 1.x clients,
- * while in "2" mode we only support interop between 2.x clients.
- *
- * @deprecated Specify the minimum Fluid Framework version directly via the
- * `minVersionForCollab` parameter, which accepts a
- * {@link @fluidframework/runtime-definitions#MinimumVersionForCollab} SemVer string. The
- * legacy mode "1" is equivalent to `minVersionForCollab: "1.0.0"`; mode "2" is
- * equivalent to `"2.0.0"`.
- *
- * @public
- */
-export type CompatibilityMode = "1" | "2";
-
 /**
  * A mapping of string identifiers to instantiated `DataObject`s or `SharedObject`s.
  */

diff --git a/packages/framework/fluid-static/src/utils.ts b/packages/framework/fluid-static/src/utils.ts
@@ -12,20 +12,13 @@ import type {
 } from "@fluidframework/datastore-definitions/internal";
 import type {
 	IFluidDataStoreContext,
-	MinimumVersionForCollab,
 	NamedFluidDataStoreRegistryEntry,
 } from "@fluidframework/runtime-definitions/internal";
 import type { ISharedObjectKind } from "@fluidframework/shared-object-base/internal";
 import { UsageError } from "@fluidframework/telemetry-utils/internal";
 import { SharedTreeFactoryType } from "@fluidframework/tree/internal";
 
-import type {
-	// eslint-disable-next-line import-x/no-deprecated
-	CompatibilityMode,
-	ContainerSchema,
-	LoadableObjectKind,
-	TreeContainerSchema,
-} from "./types.js";
+import type { ContainerSchema, LoadableObjectKind, TreeContainerSchema } from "./types.js";
 
 /**
  * Runtime check to determine if an object is a {@link DataObjectKind}.
@@ -147,26 +140,6 @@ export function makeFluidObject<
 	return Object.defineProperty(object, providerKey, { value: object }) as T;
 }
 
-/**
- * Resolves the `compatibilityMode` input — either a `MinimumVersionForCollab`
- * SemVer string or a legacy `CompatibilityMode` value — into a precise
- * `MinimumVersionForCollab`.
- *
- * TODO: AB#73679: This can be removed when the deprecated CompatibilityMode is removed
- *
- * @internal
- */
-export function resolveCompatibilityModeToMinVersionForCollab(
-	// eslint-disable-next-line import-x/no-deprecated
-	compatibilityMode: MinimumVersionForCollab | CompatibilityMode,
-): MinimumVersionForCollab {
-	return compatibilityMode === "1"
-		? "1.0.0"
-		: compatibilityMode === "2"
-			? "2.0.0"
-			: compatibilityMode;
-}
-
 /**
  * Determines if the provided schema is a valid tree-based container schema.
  * @internal

@@ -11,28 +11,14 @@ export class AzureClient {
         container: IFluidContainer<TContainerSchema>;
         services: AzureContainerServices;
     }>;
-    // @deprecated
-    createContainer<const TContainerSchema extends ContainerSchema>(containerSchema: TContainerSchema, compatibilityMode: CompatibilityMode): Promise<{
-        container: IFluidContainer<TContainerSchema>;
-        services: AzureContainerServices;
-    }>;
     getContainer<TContainerSchema extends ContainerSchema>(id: string, containerSchema: TContainerSchema, minVersionForCollab: MinimumVersionForCollab): Promise<{
         container: IFluidContainer<TContainerSchema>;
         services: AzureContainerServices;
     }>;
-    // @deprecated
-    getContainer<TContainerSchema extends ContainerSchema>(id: string, containerSchema: TContainerSchema, compatibilityMode: CompatibilityMode): Promise<{
-        container: IFluidContainer<TContainerSchema>;
-        services: AzureContainerServices;
-    }>;
     getContainerVersions(id: string, options?: AzureGetVersionsOptions): Promise<AzureContainerVersion[]>;
     viewContainerVersion<TContainerSchema extends ContainerSchema>(id: string, containerSchema: TContainerSchema, version: AzureContainerVersion, minVersionForCollab: MinimumVersionForCollab): Promise<{
         container: IFluidContainer<TContainerSchema>;
     }>;
-    // @deprecated
-    viewContainerVersion<TContainerSchema extends ContainerSchema>(id: string, containerSchema: TContainerSchema, version: AzureContainerVersion, compatibilityMode: CompatibilityMode): Promise<{
-        container: IFluidContainer<TContainerSchema>;
-    }>;
 }
 
 // @public
@@ -87,9 +73,6 @@ export interface AzureRemoteConnectionConfig extends AzureConnectionConfig {
     type: "remote";
 }
 
-// @public @deprecated
-export type CompatibilityMode = "1" | "2";
-
 // @public
 export type IAzureAudience = IServiceAudience<AzureMember>;
 

@@ -11,28 +11,14 @@ export class AzureClient {
         container: IFluidContainer<TContainerSchema>;
         services: AzureContainerServices;
     }>;
-    // @deprecated
-    createContainer<const TContainerSchema extends ContainerSchema>(containerSchema: TContainerSchema, compatibilityMode: CompatibilityMode): Promise<{
-        container: IFluidContainer<TContainerSchema>;
-        services: AzureContainerServices;
-    }>;
     getContainer<TContainerSchema extends ContainerSchema>(id: string, containerSchema: TContainerSchema, minVersionForCollab: MinimumVersionForCollab): Promise<{
         container: IFluidContainer<TContainerSchema>;
         services: AzureContainerServices;
     }>;
-    // @deprecated
-    getContainer<TContainerSchema extends ContainerSchema>(id: string, containerSchema: TContainerSchema, compatibilityMode: CompatibilityMode): Promise<{
-        container: IFluidContainer<TContainerSchema>;
-        services: AzureContainerServices;
-    }>;
     getContainerVersions(id: string, options?: AzureGetVersionsOptions): Promise<AzureContainerVersion[]>;
     viewContainerVersion<TContainerSchema extends ContainerSchema>(id: string, containerSchema: TContainerSchema, version: AzureContainerVersion, minVersionForCollab: MinimumVersionForCollab): Promise<{
         container: IFluidContainer<TContainerSchema>;
     }>;
-    // @deprecated
-    viewContainerVersion<TContainerSchema extends ContainerSchema>(id: string, containerSchema: TContainerSchema, version: AzureContainerVersion, compatibilityMode: CompatibilityMode): Promise<{
-        container: IFluidContainer<TContainerSchema>;
-    }>;
 }
 
 // @public
@@ -87,9 +73,6 @@ export interface AzureRemoteConnectionConfig extends AzureConnectionConfig {
     type: "remote";
 }
 
-// @public @deprecated
-export type CompatibilityMode = "1" | "2";
-
 // @public
 export type IAzureAudience = IServiceAudience<AzureMember>;