@fluidframework/tree 2.62.0 → 2.63.0-359286

package/src/feature-libraries/default-schema/defaultFieldKinds.ts

@@ -32,6 +32,8 @@ import {
 import { sequenceFieldChangeHandler } from "../sequence-field/index.js";
 
 import { noChangeCodecFamily } from "./noChangeCodecs.js";
+import type { CodecTree } from "../../codec/index.js";
+import { brand, type Brand } from "../../util/index.js";
 
 /**
  * ChangeHandler that only handles no-op / identity changes.
@@ -205,9 +207,12 @@ export const forbidden = new FieldKindWithEditor(
 	new Set(),
 );
 
-export const fieldKindConfigurations: ReadonlyMap<number, FieldKindConfiguration> = new Map([
+export const fieldKindConfigurations: ReadonlyMap<
+	ModularChangeFormatVersion,
+	FieldKindConfiguration
+> = new Map([
 	[
-		1,
+		brand(1),
 		new Map<FieldKindIdentifier, FieldKindConfigurationEntry>([
 			[nodeKey.identifier, { kind: nodeKey, formatVersion: 1 }],
 			[required.identifier, { kind: required, formatVersion: 1 }],
@@ -218,7 +223,7 @@ export const fieldKindConfigurations: ReadonlyMap<number, FieldKindConfiguration
 		]),
 	],
 	[
-		2,
+		brand(2),
 		new Map<FieldKindIdentifier, FieldKindConfigurationEntry>([
 			[nodeKey.identifier, { kind: nodeKey, formatVersion: 1 }],
 			[required.identifier, { kind: required, formatVersion: 2 }],
@@ -229,7 +234,7 @@ export const fieldKindConfigurations: ReadonlyMap<number, FieldKindConfiguration
 		]),
 	],
 	[
-		3,
+		brand(3),
 		new Map<FieldKindIdentifier, FieldKindConfigurationEntry>([
 			[nodeKey.identifier, { kind: nodeKey, formatVersion: 1 }],
 			[required.identifier, { kind: required, formatVersion: 2 }],
@@ -240,7 +245,7 @@ export const fieldKindConfigurations: ReadonlyMap<number, FieldKindConfiguration
 		]),
 	],
 	[
-		4,
+		brand(4),
 		new Map<FieldKindIdentifier, FieldKindConfigurationEntry>([
 			[nodeKey.identifier, { kind: nodeKey, formatVersion: 1 }],
 			[required.identifier, { kind: required, formatVersion: 2 }],
@@ -252,6 +257,25 @@ export const fieldKindConfigurations: ReadonlyMap<number, FieldKindConfiguration
 	],
 ]);
 
+export type ModularChangeFormatVersion = Brand<1 | 2 | 3 | 4, "ModularChangeFormatVersion">;
+export function getCodecTreeForModularChangeFormat(
+	version: ModularChangeFormatVersion,
+): CodecTree {
+	const dependencies =
+		fieldKindConfigurations.get(version) ?? fail("Unknown modular change format");
+	const children: CodecTree[] = Array.from(dependencies.entries()).map(
+		([key, { formatVersion }]) => ({
+			name: `FieldKind:${key}`,
+			version: formatVersion,
+		}),
+	);
+	return {
+		name: "ModularChange",
+		version,
+		children,
+	};
+}
+
 /**
  * All supported field kinds.
  *

package/src/feature-libraries/default-schema/index.ts

@@ -12,6 +12,8 @@ export {
 	type Forbidden,
 	fieldKinds,
 	fieldKindConfigurations,
+	getCodecTreeForModularChangeFormat,
+	type ModularChangeFormatVersion,
 } from "./defaultFieldKinds.js";
 
 export {

package/src/feature-libraries/forest-summary/codec.ts

@@ -6,6 +6,7 @@
 import { assert, oob } from "@fluidframework/core-utils/internal";
 
 import {
+	type CodecTree,
 	type ICodecOptions,
 	type IJsonCodec,
 	makeVersionedValidatedCodec,
@@ -14,6 +15,7 @@ import type { FieldKey, ITreeCursorSynchronous } from "../../core/index.js";
 import type { FieldBatchCodec, FieldBatchEncodingContext } from "../chunked-forest/index.js";
 
 import { Format } from "./format.js";
+import type { Brand } from "../../util/index.js";
 
 /**
  * Uses field cursors
@@ -50,3 +52,8 @@ export function makeForestSummarizerCodec(
 		},
 	});
 }
+
+export type ForestFormatVersion = Brand<1, "ForestFormatVersion">;
+export function getCodecTreeForForestFormat(version: ForestFormatVersion): CodecTree {
+	return { name: "Forest", version };
+}

package/src/feature-libraries/forest-summary/index.ts

@@ -4,3 +4,4 @@
  */
 
 export { forestSummaryKey, ForestSummarizer } from "./forestSummarizer.js";
+export { getCodecTreeForForestFormat, type ForestFormatVersion } from "./codec.js";

package/src/feature-libraries/index.ts

@@ -9,7 +9,11 @@ export {
 } from "./editableTreeBinder.js";
 export { allowsValue, assertAllowedValue, isTreeValue } from "./valueUtilities.js";
 
-export { ForestSummarizer } from "./forest-summary/index.js";
+export {
+	ForestSummarizer,
+	getCodecTreeForForestFormat,
+	type ForestFormatVersion,
+} from "./forest-summary/index.js";
 export {
 	cursorForMapTreeField,
 	cursorForMapTreeNode,
@@ -28,6 +32,7 @@ export {
 	encodeTreeSchema,
 	makeSchemaCodec,
 	makeSchemaCodecs,
+	getCodecTreeForSchemaFormat,
 } from "./schema-index/index.js";
 export {
 	stackTreeNodeCursor,
@@ -98,6 +103,8 @@ export {
 	defaultChunkPolicy,
 	type FieldBatch,
 	type FieldBatchCodec,
+	type FieldBatchFormatVersion,
+	getCodecTreeForFieldBatchFormat,
 	makeTreeChunker,
 	makeFieldBatchCodec,
 	fluidVersionToFieldBatchCodecWriteVersion,
@@ -139,6 +146,8 @@ export {
 	isNodeInSchema,
 	isFieldInSchema,
 	throwOutOfSchema,
+	getCodecTreeForModularChangeFormat,
+	type ModularChangeFormatVersion,
 } from "./default-schema/index.js";
 
 export {
@@ -190,6 +199,8 @@ export {
 	type SchemaChange,
 	makeSchemaChangeCodecs,
 	EncodedSchemaChange,
+	getCodecTreeForSchemaChangeFormat,
+	type SchemaChangeFormatVersion,
 } from "./schema-edits/index.js";
 
 export { makeMitigatedChangeFamily } from "./mitigatedChangeFamily.js";

package/src/feature-libraries/modular-schema/modularChangeFamily.ts

@@ -504,7 +504,7 @@ export class ModularChangeFamily
 		}
 
 		for (const [field, fieldChange2] of change2) {
-			if (change1 === undefined || !change1.has(field)) {
+			if (!change1?.has(field)) {
 				composedFields.set(field, fieldChange2);
 			}
 		}

package/src/feature-libraries/schema-edits/index.ts

@@ -3,6 +3,10 @@
  * Licensed under the MIT License.
  */
 
-export { makeSchemaChangeCodecs } from "./schemaChangeCodecs.js";
+export {
+	makeSchemaChangeCodecs,
+	getCodecTreeForSchemaChangeFormat,
+	type SchemaChangeFormatVersion,
+} from "./schemaChangeCodecs.js";
 export type { SchemaChange } from "./schemaChangeTypes.js";
 export { EncodedSchemaChange } from "./schemaChangeFormat.js";

package/src/feature-libraries/schema-edits/schemaChangeCodecs.ts

@@ -6,6 +6,7 @@
 import { assert } from "@fluidframework/core-utils/internal";
 
 import {
+	type CodecTree,
 	type ICodecFamily,
 	type ICodecOptions,
 	type IJsonCodec,
@@ -13,11 +14,12 @@ import {
 	makeVersionDispatchingCodec,
 	withSchemaValidation,
 } from "../../codec/index.js";
-import { makeSchemaCodec } from "../schema-index/index.js";
+import { getCodecTreeForSchemaFormat, makeSchemaCodec } from "../schema-index/index.js";
 
 import { EncodedSchemaChange } from "./schemaChangeFormat.js";
 import type { SchemaChange } from "./schemaChangeTypes.js";
 import { SchemaVersion } from "../../core/index.js";
+import type { Brand } from "../../util/index.js";
 
 /**
  * Create a family of schema change codecs.
@@ -31,6 +33,20 @@ export function makeSchemaChangeCodecs(options: ICodecOptions): ICodecFamily<Sch
 	]);
 }
 
+export type SchemaChangeFormatVersion = Brand<
+	SchemaVersion.v1 | SchemaVersion.v2,
+	"SchemaChangeFormatVersion"
+>;
+export function getCodecTreeForSchemaChangeFormat(
+	version: SchemaChangeFormatVersion,
+): CodecTree {
+	return {
+		name: "SchemaChange",
+		version,
+		children: [getCodecTreeForSchemaFormat(version)],
+	};
+}
+
 /**
  * Create a schema change codec.
  * @param options - Specifies common codec options, including which `validator` to use.

package/src/feature-libraries/schema-index/codec.ts

@@ -6,6 +6,7 @@
 import { fail, unreachableCase } from "@fluidframework/core-utils/internal";
 
 import {
+	type CodecTree,
 	type FluidClientVersion,
 	type ICodecFamily,
 	type ICodecOptions,
@@ -41,6 +42,10 @@ export function clientVersionToSchemaVersion(
 	return SchemaVersion.v1;
 }
 
+export function getCodecTreeForSchemaFormat(version: SchemaVersion): CodecTree {
+	return { name: "Schema", version };
+}
+
 /**
  * Create a schema codec.
  * @param options - Specifies common codec options, including which `validator` to use.

package/src/feature-libraries/schema-index/index.ts

@@ -8,6 +8,7 @@ export {
 	makeSchemaCodec,
 	makeSchemaCodecs,
 	clientVersionToSchemaVersion,
+	getCodecTreeForSchemaFormat,
 } from "./codec.js";
 export { Format as FormatV1 } from "./formatV1.js";
 export { Format as FormatV2 } from "./formatV2.js";

package/src/packageVersion.ts

@@ -6,4 +6,4 @@
  */
 
 export const pkgName = "@fluidframework/tree";
-export const pkgVersion = "2.62.0";
+export const pkgVersion = "2.63.0-359286";

package/src/serializableDomainSchema.ts

@@ -7,13 +7,14 @@ import type { IFluidHandle } from "@fluidframework/core-interfaces";
 
 import {
 	SchemaFactory,
+	SchemaFactoryAlpha,
 	type FixRecursiveArraySchema,
 	type TreeNodeFromImplicitAllowedTypes,
 	type ValidateRecursiveSchema,
 } from "./simple-tree/index.js";
 import type { JsonCompatible } from "./util/index.js";
 
-const sf = new SchemaFactory("com.fluidframework.serializable");
+const sf = new SchemaFactoryAlpha("com.fluidframework.serializable");
 
 /**
  * Utilities for storing {@link FluidSerializableAsTree.Data|Fluid Serializable data} in {@link TreeNode}s.
@@ -23,14 +24,14 @@ const sf = new SchemaFactory("com.fluidframework.serializable");
  * Schema which replicate the Fluid Serializable data model with {@link TreeNode}s.
  *
  * Fluid Serializable data can be imported from the {@link FluidSerializableAsTree.Data|Fluid Serializable format} into this format using {@link (TreeAlpha:interface).importConcise} with the {@link FluidSerializableAsTree.(Tree:variable)} schema.
- * @internal
+ * @alpha
  */
 export namespace FluidSerializableAsTree {
 	/**
 	 * Data which can be serialized by Fluid.
 	 * @remarks
 	 * Can be encoded as a {@link FluidSerializableAsTree.(Tree:type)} using {@link (TreeAlpha:interface).importConcise}.
-	 * @internal
+	 * @alpha
 	 */
 	export type Data = JsonCompatible<IFluidHandle>;
 
@@ -40,7 +41,7 @@ export namespace FluidSerializableAsTree {
 	 * ```typescript
 	 * const tree = TreeAlpha.importConcise(FluidSerializableAsTree.Tree, { example: { nested: true }, value: 5 });
 	 * ```
-	 * @internal
+	 * @alpha
 	 */
 	export const Tree = [
 		() => FluidSerializableObject,
@@ -49,15 +50,15 @@ export namespace FluidSerializableAsTree {
 	] as const;
 
 	/**
-	 * @internal
+	 * @alpha
 	 */
 	export type Tree = TreeNodeFromImplicitAllowedTypes<typeof Tree>;
 
 	/**
 	 * Do not use. Exists only as a workaround for {@link https://github.com/microsoft/TypeScript/issues/59550} and {@link https://github.com/microsoft/rushstack/issues/4429}.
-	 * @system @internal
+	 * @system @alpha
 	 */
-	export const _APIExtractorWorkaroundObjectBase = sf.mapRecursive("object", Tree);
+	export const _APIExtractorWorkaroundObjectBase = sf.recordRecursive("object", Tree);
 
 	/**
 	 * Arbitrary Fluid Serializable object as a {@link TreeNode}.
@@ -74,7 +75,7 @@ export namespace FluidSerializableAsTree {
 	 * ```
 	 * @privateRemarks
 	 * Due to https://github.com/microsoft/TypeScript/issues/61270 this can't be named `Object`.
-	 * @sealed @internal
+	 * @sealed @alpha
 	 */
 	export class FluidSerializableObject extends _APIExtractorWorkaroundObjectBase {}
 	{
@@ -86,7 +87,7 @@ export namespace FluidSerializableAsTree {
 	 * @privateRemarks
 	 * In the past this this had to reference the base type (_APIExtractorWorkaroundArrayBase).
 	 * Testing for this in examples/utils/import-testing now shows it has to reference FluidSerializableAsTree.Array instead.
-	 * @system @internal
+	 * @system @alpha
 	 */
 	export declare type _RecursiveArrayWorkaroundJsonArray = FixRecursiveArraySchema<
 		typeof Array
@@ -94,7 +95,7 @@ export namespace FluidSerializableAsTree {
 
 	/**
 	 * Do not use. Exists only as a workaround for {@link https://github.com/microsoft/TypeScript/issues/59550} and {@link https://github.com/microsoft/rushstack/issues/4429}.
-	 * @system @internal
+	 * @system @alpha
 	 */
 	export const _APIExtractorWorkaroundArrayBase = sf.arrayRecursive("array", Tree);
 
@@ -113,7 +114,7 @@ export namespace FluidSerializableAsTree {
 	 * assert(Tree.is(inner, FluidSerializableAsTree.Array));
 	 * const leaf = inner[0];
 	 * ```
-	 * @sealed @internal
+	 * @sealed @alpha
 	 */
 	export class Array extends _APIExtractorWorkaroundArrayBase {}
 	{

package/src/shared-tree/index.ts

@@ -24,6 +24,7 @@ export {
 	exportSimpleSchema,
 	type SharedTreeKernelView,
 	persistedToSimpleSchema,
+	getCodecTreeForSharedTreeFormat,
 } from "./sharedTree.js";
 
 export {
@@ -60,3 +61,8 @@ export {
 } from "./independentView.js";
 
 export type { SharedTreeChange } from "./sharedTreeChangeTypes.js";
+
+export {
+	getCodecTreeForChangeFormat,
+	type SharedTreeChangeFormatVersion,
+} from "./sharedTreeChangeCodecs.js";

package/src/shared-tree/sharedTree.ts

@@ -4,7 +4,7 @@
  */
 
 import type { ErasedType, IFluidLoadable } from "@fluidframework/core-interfaces/internal";
-import { assert, fail } from "@fluidframework/core-utils/internal";
+import { assert, fail, unreachableCase } from "@fluidframework/core-utils/internal";
 import type { IChannelStorageService } from "@fluidframework/datastore-definitions/internal";
 import type { IIdCompressor, StableId } from "@fluidframework/id-compressor";
 import type {
@@ -18,12 +18,15 @@ import {
 } from "@fluidframework/telemetry-utils/internal";
 
 import {
+	type CodecTree,
 	type CodecWriteOptions,
+	DependentFormatVersion,
 	FluidClientVersion,
 	FormatValidatorNoOp,
 	type ICodecOptions,
 } from "../codec/index.js";
 import {
+	type DetachedFieldIndexFormatVersion,
 	type FieldKey,
 	type GraphCommit,
 	type IEditableForest,
@@ -32,6 +35,7 @@ import {
 	MapNodeStoredSchema,
 	ObjectNodeStoredSchema,
 	RevisionTagCodec,
+	type SchemaFormatVersion,
 	SchemaVersion,
 	type TreeFieldStoredSchema,
 	type TreeNodeSchemaIdentifier,
@@ -39,6 +43,7 @@ import {
 	type TreeStoredSchema,
 	TreeStoredSchemaRepository,
 	type TreeStoredSchemaSubscription,
+	getCodecTreeForDetachedFieldIndexFormat,
 	makeDetachedFieldIndex,
 	moveToDetachedField,
 } from "../core/index.js";
@@ -51,11 +56,16 @@ import {
 	buildChunkedForest,
 	buildForest,
 	defaultSchemaPolicy,
+	getCodecTreeForFieldBatchFormat,
+	getCodecTreeForForestFormat,
+	getCodecTreeForSchemaFormat,
 	jsonableTreeFromFieldCursor,
 	makeFieldBatchCodec,
 	makeMitigatedChangeFamily,
 	makeSchemaCodec,
 	makeTreeChunker,
+	type FieldBatchFormatVersion,
+	type ForestFormatVersion,
 	type TreeCompressionStrategyPrivate,
 } from "../feature-libraries/index.js";
 // eslint-disable-next-line import/no-internal-modules
@@ -63,7 +73,11 @@ import type { FormatV1 } from "../feature-libraries/schema-index/index.js";
 import {
 	type BranchId,
 	type ClonableSchemaAndPolicy,
+	type EditManagerFormatVersion,
 	type ExplicitCoreCodecVersions,
+	getCodecTreeForEditManagerFormatWithChange,
+	getCodecTreeForMessageFormatWithChange,
+	type MessageFormatVersion,
 	SharedTreeCore,
 } from "../shared-tree-core/index.js";
 import {
@@ -92,11 +106,16 @@ import type { SharedTreeChange } from "./sharedTreeChangeTypes.js";
 import type { SharedTreeEditBuilder } from "./sharedTreeEditBuilder.js";
 import { type TreeCheckout, type BranchableTree, createTreeCheckout } from "./treeCheckout.js";
 import {
+	brand,
 	type Breakable,
 	breakingClass,
 	type JsonCompatible,
 	throwIfBroken,
 } from "../util/index.js";
+import {
+	getCodecTreeForChangeFormat,
+	type SharedTreeChangeFormatVersion,
+} from "./sharedTreeChangeCodecs.js";
 
 /**
  * Copy of data from an {@link ITreePrivate} at some point in time.
@@ -161,36 +180,78 @@ export interface ITreePrivate extends ITreeInternal {
  * TODO: Plumb these write versions into forest, schema, detached field index codec creation.
  */
 interface ExplicitCodecVersions extends ExplicitCoreCodecVersions {
-	forest: number;
-	schema: SchemaVersion;
-	detachedFieldIndex: number;
-	fieldBatch: number;
+	forest: ForestFormatVersion;
+	schema: SchemaFormatVersion;
+	detachedFieldIndex: DetachedFieldIndexFormatVersion;
+	fieldBatch: FieldBatchFormatVersion;
 }
 
 const formatVersionToTopLevelCodecVersions = new Map<number, ExplicitCodecVersions>([
 	[
 		1,
-		{ forest: 1, schema: 1, detachedFieldIndex: 1, editManager: 1, message: 1, fieldBatch: 1 },
+		{
+			forest: brand(1),
+			schema: brand(1),
+			detachedFieldIndex: brand(1),
+			editManager: brand(1),
+			message: brand(1),
+			fieldBatch: brand(1),
+		},
 	],
 	[
 		2,
-		{ forest: 1, schema: 1, detachedFieldIndex: 1, editManager: 2, message: 2, fieldBatch: 1 },
+		{
+			forest: brand(1),
+			schema: brand(1),
+			detachedFieldIndex: brand(1),
+			editManager: brand(2),
+			message: brand(2),
+			fieldBatch: brand(1),
+		},
 	],
 	[
 		3,
-		{ forest: 1, schema: 1, detachedFieldIndex: 1, editManager: 3, message: 3, fieldBatch: 1 },
+		{
+			forest: brand(1),
+			schema: brand(1),
+			detachedFieldIndex: brand(1),
+			editManager: brand(3),
+			message: brand(3),
+			fieldBatch: brand(1),
+		},
 	],
 	[
 		4,
-		{ forest: 1, schema: 1, detachedFieldIndex: 1, editManager: 4, message: 4, fieldBatch: 1 },
+		{
+			forest: brand(1),
+			schema: brand(1),
+			detachedFieldIndex: brand(1),
+			editManager: brand(4),
+			message: brand(4),
+			fieldBatch: brand(1),
+		},
 	],
 	[
 		5,
-		{ forest: 1, schema: 2, detachedFieldIndex: 1, editManager: 4, message: 4, fieldBatch: 1 },
+		{
+			forest: brand(1),
+			schema: brand(2),
+			detachedFieldIndex: brand(1),
+			editManager: brand(4),
+			message: brand(4),
+			fieldBatch: brand(1),
+		},
 	],
 	[
 		100, // SharedTreeFormatVersion.vSharedBranches
-		{ forest: 1, schema: 2, detachedFieldIndex: 1, editManager: 5, message: 5, fieldBatch: 1 },
+		{
+			forest: brand(1),
+			schema: brand(2),
+			detachedFieldIndex: brand(1),
+			editManager: brand(5),
+			message: brand(5),
+			fieldBatch: brand(1),
+		},
 	],
 ]);
 
@@ -321,6 +382,8 @@ export class SharedTreeKernel
 			changeFamily,
 			options,
 			codecVersions,
+			changeFormatVersionForEditManager,
+			changeFormatVersionForMessage,
 			idCompressor,
 			schema,
 			defaultSchemaPolicy,
@@ -635,6 +698,83 @@ export const SharedTreeFormatVersion = {
  */
 export type SharedTreeFormatVersion = typeof SharedTreeFormatVersion;
 
+/**
+ * Defines for each EditManagerFormatVersion the SharedTreeChangeFormatVersion to use.
+ * This is an arbitrary mapping that is injected in the EditManger codec.
+ * Once an entry is defined and used in production, it cannot be changed.
+ * This is because the format for SharedTree changes are not explicitly versioned.
+ */
+export const changeFormatVersionForEditManager = DependentFormatVersion.fromPairs([
+	[brand<EditManagerFormatVersion>(1), brand<SharedTreeChangeFormatVersion>(1)],
+	[brand<EditManagerFormatVersion>(2), brand<SharedTreeChangeFormatVersion>(2)],
+	[brand<EditManagerFormatVersion>(3), brand<SharedTreeChangeFormatVersion>(3)],
+	[brand<EditManagerFormatVersion>(4), brand<SharedTreeChangeFormatVersion>(4)],
+	[brand<EditManagerFormatVersion>(5), brand<SharedTreeChangeFormatVersion>(4)],
+]);
+
+/**
+ * Defines for each MessageFormatVersion the SharedTreeChangeFormatVersion to use.
+ * This is an arbitrary mapping that is injected in the message codec.
+ * Once an entry is defined and used in production, it cannot be changed.
+ * This is because the format for SharedTree changes are not explicitly versioned.
+ */
+export const changeFormatVersionForMessage = DependentFormatVersion.fromPairs([
+	[brand<MessageFormatVersion>(undefined), brand<SharedTreeChangeFormatVersion>(1)],
+	[brand<MessageFormatVersion>(1), brand<SharedTreeChangeFormatVersion>(1)],
+	[brand<MessageFormatVersion>(2), brand<SharedTreeChangeFormatVersion>(2)],
+	[brand<MessageFormatVersion>(3), brand<SharedTreeChangeFormatVersion>(3)],
+	[brand<MessageFormatVersion>(4), brand<SharedTreeChangeFormatVersion>(4)],
+	[brand<MessageFormatVersion>(5), brand<SharedTreeChangeFormatVersion>(4)],
+]);
+
+function getCodecTreeForEditManagerFormat(version: EditManagerFormatVersion): CodecTree {
+	const change = changeFormatVersionForEditManager.lookup(version);
+	const changeCodecTree = getCodecTreeForChangeFormat(change);
+	return getCodecTreeForEditManagerFormatWithChange(version, changeCodecTree);
+}
+
+function getCodecTreeForMessageFormat(version: MessageFormatVersion): CodecTree {
+	const change = changeFormatVersionForMessage.lookup(version);
+	const changeCodecTree = getCodecTreeForChangeFormat(change);
+	return getCodecTreeForMessageFormatWithChange(version, changeCodecTree);
+}
+
+export function getCodecTreeForSharedTreeFormat(
+	version: SharedTreeFormatVersion[keyof SharedTreeFormatVersion],
+): CodecTree {
+	const children: CodecTree[] = [];
+	const childCodecs = getCodecVersions(version);
+	for (const name of Object.keys(childCodecs) as (keyof ExplicitCodecVersions)[]) {
+		switch (name) {
+			case "editManager":
+				children.push(getCodecTreeForEditManagerFormat(childCodecs.editManager));
+				break;
+			case "message":
+				children.push(getCodecTreeForMessageFormat(childCodecs.message));
+				break;
+			case "forest":
+				children.push(getCodecTreeForForestFormat(childCodecs.forest));
+				break;
+			case "schema":
+				children.push(getCodecTreeForSchemaFormat(childCodecs.schema));
+				break;
+			case "detachedFieldIndex":
+				children.push(getCodecTreeForDetachedFieldIndexFormat(childCodecs.detachedFieldIndex));
+				break;
+			case "fieldBatch":
+				children.push(getCodecTreeForFieldBatchFormat(childCodecs.fieldBatch));
+				break;
+			default:
+				unreachableCase(name);
+		}
+	}
+	return {
+		name: "SharedTree",
+		version,
+		children,
+	};
+}
+
 /**
  * Configuration options for SharedTree.
  * @beta @input