@fluidframework/tree 2.41.0-338401 → 2.42.0

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

@@ -13,14 +13,11 @@ import {
 	makeVersionDispatchingCodec,
 	withSchemaValidation,
 } from "../../codec/index.js";
-import {
-	makeSchemaCodec,
-	SchemaCodecVersion,
-	type Format as FormatV1,
-} from "../schema-index/index.js";
+import { makeSchemaCodec, type Format as FormatV1 } from "../schema-index/index.js";
 
 import { EncodedSchemaChange } from "./schemaChangeFormat.js";
 import type { SchemaChange } from "./schemaChangeTypes.js";
+import { SchemaVersion } from "../../core/index.js";
 
 /**
  * Create a family of schema change codecs.
@@ -28,7 +25,7 @@ import type { SchemaChange } from "./schemaChangeTypes.js";
  * @returns The composed codec family.
  */
 export function makeSchemaChangeCodecs(options: ICodecOptions): ICodecFamily<SchemaChange> {
-	return makeCodecFamily([[SchemaCodecVersion.v1, makeSchemaChangeCodecV1(options)]]);
+	return makeCodecFamily([[SchemaVersion.v1, makeSchemaChangeCodecV1(options)]]);
 }
 
 /**
@@ -39,7 +36,7 @@ export function makeSchemaChangeCodecs(options: ICodecOptions): ICodecFamily<Sch
  */
 export function makeSchemaChangeCodec(
 	options: ICodecOptions,
-	writeVersion: SchemaCodecVersion,
+	writeVersion: SchemaVersion,
 ): IJsonCodec<SchemaChange> {
 	const family = makeSchemaChangeCodecs(options);
 	return makeVersionDispatchingCodec(family, { ...options, writeVersion });
@@ -53,7 +50,7 @@ export function makeSchemaChangeCodec(
 function makeSchemaChangeCodecV1(
 	options: ICodecOptions,
 ): IJsonCodec<SchemaChange, EncodedSchemaChange> {
-	const schemaCodec = makeSchemaCodec(options, SchemaCodecVersion.v1);
+	const schemaCodec = makeSchemaCodec(options, SchemaVersion.v1);
 	const schemaChangeCodec: IJsonCodec<SchemaChange, EncodedSchemaChange> = {
 		encode: (schemaChange) => {
 			assert(

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

@@ -4,6 +4,7 @@
  */
 
 import { fail, unreachableCase } from "@fluidframework/core-utils/internal";
+
 import {
 	type FluidClientVersion,
 	type ICodecFamily,
@@ -14,12 +15,13 @@ import {
 	makeVersionedValidatedCodec,
 } from "../../codec/index.js";
 import {
+	SchemaVersion,
 	type TreeNodeSchemaIdentifier,
 	type TreeNodeStoredSchema,
 	type TreeStoredSchema,
 	decodeFieldSchema,
 	encodeFieldSchema,
-	schemaFormatV1,
+	type schemaFormatV1,
 	storedSchemaDecodeDispatcher,
 } from "../../core/index.js";
 import { brand, type JsonCompatible } from "../../util/index.js";
@@ -27,22 +29,15 @@ import { brand, type JsonCompatible } from "../../util/index.js";
 import { Format as FormatV1 } from "./formatV1.js";
 
 /**
- * Versions for the codec that encodes an in-memory representation of a stored schema {@link TreeStoredSchema} into a persisted format (or decodes it in the opposite direction).
- */
-export enum SchemaCodecVersion {
-	v1 = 1,
-}
-
-/**
- * Convert a FluidClientVersion to a SchemaCodecVersion.
+ * Convert a FluidClientVersion to a SchemaVersion.
  * @param clientVersion - The FluidClientVersion to convert.
- * @returns The SchemaCodecVersion that corresponds to the provided FluidClientVersion.
+ * @returns The SchemaVersion that corresponds to the provided FluidClientVersion.
  */
 export function clientVersionToSchemaVersion(
 	clientVersion: FluidClientVersion,
-): SchemaCodecVersion {
+): SchemaVersion {
 	// Only one version of the schema codec is currently supported.
-	return SchemaCodecVersion.v1;
+	return SchemaVersion.v1;
 }
 
 /**
@@ -55,7 +50,7 @@ export function clientVersionToSchemaVersion(
  */
 export function makeSchemaCodec(
 	options: ICodecOptions,
-	writeVersion: SchemaCodecVersion,
+	writeVersion: SchemaVersion,
 ): IJsonCodec<TreeStoredSchema> {
 	const family = makeSchemaCodecs(options);
 	return makeVersionDispatchingCodec(family, { ...options, writeVersion });
@@ -67,7 +62,7 @@ export function makeSchemaCodec(
  * @returns The composed codec family.
  */
 export function makeSchemaCodecs(options: ICodecOptions): ICodecFamily<TreeStoredSchema> {
-	return makeCodecFamily([[SchemaCodecVersion.v1, makeSchemaCodecV1(options)]]);
+	return makeCodecFamily([[SchemaVersion.v1, makeSchemaCodecV1(options)]]);
 }
 
 /**
@@ -76,12 +71,9 @@ export function makeSchemaCodecs(options: ICodecOptions): ICodecFamily<TreeStore
  * @param version - The schema write version.
  * @returns The encoded schema.
  */
-export function encodeRepo(
-	repo: TreeStoredSchema,
-	version: SchemaCodecVersion,
-): JsonCompatible {
+export function encodeRepo(repo: TreeStoredSchema, version: SchemaVersion): JsonCompatible {
 	switch (version) {
-		case SchemaCodecVersion.v1:
+		case SchemaVersion.v1:
 			return encodeRepoV1(repo);
 		default:
 			unreachableCase(version);
@@ -102,7 +94,7 @@ function encodeRepoV1(repo: TreeStoredSchema): FormatV1 {
 		});
 	}
 	return {
-		version: schemaFormatV1.version,
+		version: SchemaVersion.v1,
 		nodes: nodeSchema,
 		root: rootFieldSchema,
 	};
@@ -125,7 +117,7 @@ function decode(f: FormatV1): TreeStoredSchema {
  * @returns The codec.
  */
 function makeSchemaCodecV1(options: ICodecOptions): IJsonCodec<TreeStoredSchema, FormatV1> {
-	return makeVersionedValidatedCodec(options, new Set([schemaFormatV1.version]), FormatV1, {
+	return makeVersionedValidatedCodec(options, new Set([SchemaVersion.v1]), FormatV1, {
 		encode: (data: TreeStoredSchema) => encodeRepoV1(data),
 		decode: (data: FormatV1) => decode(data),
 	});

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

@@ -5,7 +5,7 @@
 
 import { type ObjectOptions, type Static, Type } from "@sinclair/typebox";
 
-import { schemaFormatV1 } from "../../core/index.js";
+import { SchemaVersion, schemaFormatV1 } from "../../core/index.js";
 
 const noAdditionalProps: ObjectOptions = { additionalProperties: false };
 
@@ -21,7 +21,7 @@ const noAdditionalProps: ObjectOptions = { additionalProperties: false };
  */
 export const Format = Type.Object(
 	{
-		version: Type.Literal(schemaFormatV1.version),
+		version: Type.Literal(SchemaVersion.v1),
 		nodes: Type.Record(Type.String(), schemaFormatV1.TreeNodeSchemaDataFormat),
 		root: schemaFormatV1.FieldSchemaFormat,
 	},

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

@@ -7,7 +7,6 @@ export { SchemaSummarizer, encodeTreeSchema } from "./schemaSummarizer.js";
 export {
 	makeSchemaCodec,
 	makeSchemaCodecs,
-	SchemaCodecVersion,
 	clientVersionToSchemaVersion,
 } from "./codec.js";
 export { Format } from "./formatV1.js";

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

@@ -25,10 +25,10 @@ import type {
 	SummaryElementParser,
 	SummaryElementStringifier,
 } from "../../shared-tree-core/index.js";
+import type { JsonCompatible } from "../../util/index.js";
 import type { CollabWindow } from "../incrementalSummarizationUtils.js";
 
 import { encodeRepo } from "./codec.js";
-import type { JsonCompatible } from "../../util/index.js";
 
 const schemaStringKey = "SchemaString";
 /**

package/src/feature-libraries/sequence-field/formatV3.ts

@@ -6,6 +6,7 @@
 import { type ObjectOptions, type Static, type TSchema, Type } from "@sinclair/typebox";
 
 import { unionOptions } from "../../codec/index.js";
+
 import {
 	CellId,
 	CellMark,

package/src/feature-libraries/sequence-field/markQueue.ts

@@ -4,6 +4,7 @@
  */
 
 import { assert, oob } from "@fluidframework/core-utils/internal";
+
 import { type MoveEffectTable, splitMarkForMoveEffects } from "./moveEffectTable.js";
 import type { Mark } from "./types.js";
 import { splitMark } from "./utils.js";

package/src/feature-libraries/sequence-field/prune.ts

@@ -4,6 +4,7 @@
  */
 
 import type { NodeChangePruner } from "../modular-schema/index.js";
+
 import { MarkListFactory } from "./markListFactory.js";
 import type { Changeset } from "./types.js";
 import { withNodeChange } from "./utils.js";

package/src/feature-libraries/sequence-field/rebase.ts

@@ -344,7 +344,7 @@ function rebaseMarkIgnoreChild(
 }
 
 /**
- * @returns A pair of marks that represent the effects which should remain in place in the face of concurrent move,
+ * Returns a pair of marks that represent the effects which should remain in place in the face of concurrent move,
  * and the effects that should be sent to the move destination.
  */
 function separateEffectsForMove(mark: MarkEffect): {

package/src/feature-libraries/sequence-field/relevantRemovedRoots.ts

@@ -7,10 +7,10 @@ import { assert } from "@fluidframework/core-utils/internal";
 
 import { type DeltaDetachedNodeId, offsetDetachId } from "../../core/index.js";
 import { nodeIdFromChangeAtom } from "../deltaUtils.js";
+import type { RelevantRemovedRootsFromChild } from "../modular-schema/index.js";
 
 import type { Changeset, Mark } from "./types.js";
 import { isAttachAndDetachEffect, isDetachOfRemovedNodes, isInsert } from "./utils.js";
-import type { RelevantRemovedRootsFromChild } from "../modular-schema/index.js";
 
 export function* relevantRemovedRoots(
 	change: Changeset,

package/src/feature-libraries/sequence-field/replaceRevisions.ts

@@ -4,7 +4,10 @@
  */
 
 import { unreachableCase } from "@fluidframework/core-utils/internal";
+
 import { type RevisionTag, replaceAtomRevisions } from "../../core/index.js";
+
+import type { MoveMarkEffect } from "./helperTypes.js";
 import { MarkListFactory } from "./markListFactory.js";
 import {
 	type Changeset,
@@ -16,7 +19,6 @@ import {
 	NoopMarkType,
 	type Rename,
 } from "./types.js";
-import type { MoveMarkEffect } from "./helperTypes.js";
 import { isDetach, isRename } from "./utils.js";
 
 export function replaceRevisions(

package/src/feature-libraries/sequence-field/sequenceFieldCodecV1.ts

@@ -15,6 +15,8 @@ import type {
 } from "../../core/index.js";
 import { type JsonCompatibleReadOnly, type Mutable, brand } from "../../util/index.js";
 import { makeChangeAtomIdCodec } from "../changeAtomIdCodec.js";
+import type { FieldChangeEncodingContext } from "../index.js";
+import { EncodedNodeChangeset } from "../modular-schema/index.js";
 
 import {
 	Changeset as ChangesetSchema,
@@ -37,8 +39,6 @@ import {
 	type Rename,
 } from "./types.js";
 import { isNoopMark, normalizeCellRename } from "./utils.js";
-import type { FieldChangeEncodingContext } from "../index.js";
-import { EncodedNodeChangeset } from "../modular-schema/index.js";
 
 export function makeV1Codec(
 	revisionTagCodec: IJsonCodec<

package/src/feature-libraries/sequence-field/sequenceFieldCodecV2.ts

@@ -19,8 +19,11 @@ import type {
 } from "../../core/index.js";
 import { type JsonCompatibleReadOnly, type Mutable, brand } from "../../util/index.js";
 import { makeChangeAtomIdCodec } from "../changeAtomIdCodec.js";
+import type { FieldChangeEncodingContext } from "../index.js";
+import { EncodedNodeChangeset } from "../modular-schema/index.js";
 
 import { Changeset as ChangesetSchema, type Encoded } from "./formatV2.js";
+import type { SequenceCodecHelpers } from "./helperTypes.js";
 import {
 	type Attach,
 	type AttachAndDetach,
@@ -36,9 +39,6 @@ import {
 	type Rename,
 } from "./types.js";
 import { isNoopMark, normalizeCellRename } from "./utils.js";
-import type { FieldChangeEncodingContext } from "../index.js";
-import { EncodedNodeChangeset } from "../modular-schema/index.js";
-import type { SequenceCodecHelpers } from "./helperTypes.js";
 
 export function makeV2CodecHelpers(
 	revisionTagCodec: IJsonCodec<

package/src/feature-libraries/sequence-field/sequenceFieldCodecV3.ts

@@ -12,13 +12,13 @@ import type {
 	RevisionTag,
 } from "../../core/index.js";
 import type { JsonCompatibleReadOnly } from "../../util/index.js";
+import type { FieldChangeEncodingContext } from "../index.js";
+import { EncodedNodeChangeset } from "../modular-schema/index.js";
 
 import { Changeset as ChangesetSchema, type Encoded } from "./formatV3.js";
+import { makeV2CodecHelpers } from "./sequenceFieldCodecV2.js";
 import type { Changeset, Mark, MarkEffect, Rename } from "./types.js";
 import { isNoopMark } from "./utils.js";
-import type { FieldChangeEncodingContext } from "../index.js";
-import { EncodedNodeChangeset } from "../modular-schema/index.js";
-import { makeV2CodecHelpers } from "./sequenceFieldCodecV2.js";
 
 export function makeV3Codec(
 	revisionTagCodec: IJsonCodec<

package/src/feature-libraries/sequence-field/sequenceFieldCodecs.ts

@@ -9,12 +9,12 @@ import type {
 	EncodedRevisionTag,
 	RevisionTag,
 } from "../../core/index.js";
-
-import type { Changeset, MarkList } from "./types.js";
 import type { FieldChangeEncodingContext } from "../index.js";
+
 import { makeV1Codec } from "./sequenceFieldCodecV1.js";
 import { makeV2Codec } from "./sequenceFieldCodecV2.js";
 import { makeV3Codec } from "./sequenceFieldCodecV3.js";
+import type { Changeset, MarkList } from "./types.js";
 
 export const sequenceFieldChangeCodecFactory = (
 	revisionTagCodec: IJsonCodec<

package/src/feature-libraries/sequence-field/sequenceFieldToDelta.ts

@@ -13,6 +13,7 @@ import {
 } from "../../core/index.js";
 import { getLast, hasSome, type Mutable } from "../../util/index.js";
 import { nodeIdFromChangeAtom } from "../deltaUtils.js";
+import type { FieldChangeDelta, ToDelta } from "../modular-schema/index.js";
 
 import { isMoveIn, isMoveOut } from "./moveEffectTable.js";
 import { type MarkList, NoopMarkType } from "./types.js";
@@ -24,7 +25,6 @@ import {
 	getInputCellId,
 	isAttachAndDetachEffect,
 } from "./utils.js";
-import type { FieldChangeDelta, ToDelta } from "../modular-schema/index.js";
 
 export function sequenceFieldToDelta(
 	change: MarkList,

package/src/feature-libraries/sequence-field/utils.ts

@@ -289,7 +289,7 @@ export function compareCellPositionsUsingTombstones(
 }
 
 /**
- * @returns the ID of the cell in the output context of the given detach `mark`.
+ * Gets the ID of the cell in the output context of the given detach `mark`.
  */
 export function getDetachOutputCellId(mark: Detach | Rename): ChangeAtomId {
 	if (isRename(mark)) {
@@ -304,7 +304,7 @@ export function getDetachOutputCellId(mark: Detach | Rename): ChangeAtomId {
 }
 
 /**
- * @returns the ID of the detached node in the output context of the given detach `mark`.
+ * Gets the ID of the detached node in the output context of the given detach `mark`.
  */
 export function getDetachedNodeId(mark: Detach | Rename): ChangeAtomId {
 	switch (mark.type) {
@@ -413,18 +413,18 @@ export function cloneCellId(id: CellId): CellId {
 }
 
 /**
+ * Gets the number of nodes within the output context of the mark.
  * @param mark - The mark to get the length of.
  * @param ignorePairing - When true, the length of a paired mark (e.g. MoveIn/MoveOut) whose matching mark is not active
  * will be treated the same as if the matching mark were active.
- * @returns The number of nodes within the output context of the mark.
  */
 export function getOutputLength(mark: Mark, ignorePairing: boolean = false): number {
 	return areOutputCellsEmpty(mark) ? 0 : mark.count;
 }
 
 /**
+ * Gets the number of nodes within the input context of the mark.
  * @param mark - The mark to get the length of.
- * @returns The number of nodes within the input context of the mark.
  */
 export function getInputLength(mark: Mark): number {
 	return areInputCellsEmpty(mark) ? 0 : mark.count;
@@ -491,7 +491,9 @@ export function settleMark(mark: Mark): Mark {
 }
 
 /**
- * @returns true, iff the given `mark` would have impact on the field when applied.
+ * Returns true if and only iff the given `mark` would have impact on the field when applied.
+ *
+ * @remarks
  * Ignores the impact of nested changes.
  * CellRename effects are considered impactful if they actually change the ID of the cells.
  */

package/src/feature-libraries/treeCursorUtils.ts

@@ -72,6 +72,11 @@ export function stackTreeFieldCursor<TNode>(
 	return cursor;
 }
 
+/**
+ * The representation of a field used by {@link CursorAdapter}.
+ */
+export type Field<TNode> = Pick<readonly TNode[], typeof Symbol.iterator | "length" | number>;
+
 /**
  * Provides functionality to allow a {@link stackTreeNodeCursor} and {@link stackTreeFieldCursor} to implement cursors.
  */
@@ -91,10 +96,10 @@ export interface CursorAdapter<TNode> {
 	/**
 	 * @returns the child nodes for the given node and key.
 	 */
-	getFieldFromNode(node: TNode, key: FieldKey): readonly TNode[];
+	getFieldFromNode(node: TNode, key: FieldKey): Field<TNode>;
 }
 
-type SiblingsOrKey<TNode> = readonly TNode[] | readonly FieldKey[];
+type SiblingsOrKey<TNode> = Field<TNode> | readonly FieldKey[];
 
 /**
  * A class that satisfies part of the ITreeCursorSynchronous implementation.
@@ -122,7 +127,7 @@ export abstract class SynchronousCursor {
  * 2. Support for cursors which are field cursors at the root.
  */
 class StackCursor<TNode> extends SynchronousCursor implements CursorWithNode<TNode> {
-	public readonly [CursorMarker] = true;
+	public override readonly [CursorMarker] = true;
 	/**
 	 * Might start at special root where fields are detached sequences.
 	 *
@@ -149,14 +154,18 @@ class StackCursor<TNode> extends SynchronousCursor implements CursorWithNode<TNo
 		debugAssert(() =>
 			this.mode === CursorLocationType.Fields ? true : "must be in fields mode",
 		);
-		return this.siblings[this.index] as FieldKey;
+		// index is kept inbounds as an invariant of the class.
+		// eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+		return (this.siblings as readonly FieldKey[])[this.index]!;
 	}
 
 	private getStackedFieldKey(height: number): FieldKey {
 		assert(height % 2 === 1, 0x3b8 /* must field height */);
 		const siblingStack = this.siblingStack[height] ?? oob();
 		const indexStack = this.indexStack[height] ?? oob();
-		return siblingStack[indexStack] as FieldKey;
+		// index is kept inbounds as an invariant of the class.
+		// eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+		return (siblingStack as readonly FieldKey[])[indexStack]!;
 	}
 
 	private getStackedNodeIndex(height: number): number {
@@ -166,9 +175,10 @@ class StackCursor<TNode> extends SynchronousCursor implements CursorWithNode<TNo
 
 	private getStackedNode(height: number): TNode {
 		const index = this.getStackedNodeIndex(height);
-		// Test is failing when using `?? oob()` here.
+		// Can not use `?? oob()` since null and undefined are valid values.
+		// index is kept inbounds as an invariant of the class.
 		// eslint-disable-next-line @typescript-eslint/no-non-null-assertion
-		return (this.siblingStack[height] as readonly TNode[])[index]!;
+		return (this.siblingStack[height] as Field<TNode>)[index]!;
 	}
 
 	public getFieldLength(): number {
@@ -358,12 +368,13 @@ class StackCursor<TNode> extends SynchronousCursor implements CursorWithNode<TNo
 
 	public getNode(): TNode {
 		// assert(this.mode === CursorLocationType.Nodes, "can only get node when in node");
-		// Test is failing when using `?? oob()` here.
+		// Can not use `?? oob()` since null and undefined are valid values.
+		// index is kept inbounds as an invariant of the class.
 		// eslint-disable-next-line @typescript-eslint/no-non-null-assertion
-		return (this.siblings as TNode[])[this.index]!;
+		return (this.siblings as Field<TNode>)[this.index]!;
 	}
 
-	private getField(): readonly TNode[] {
+	private getField(): Field<TNode> {
 		// assert(this.mode === CursorLocationType.Fields, "can only get field when in fields");
 		const parent = this.getStackedNode(this.indexStack.length - 1);
 		const key: FieldKey = this.getFieldKey();
@@ -372,14 +383,14 @@ class StackCursor<TNode> extends SynchronousCursor implements CursorWithNode<TNo
 	}
 
 	/**
-	 * @returns the value of the current node
+	 * The value of the current node
 	 */
 	public get value(): Value {
 		return this.adapter.value(this.getNode());
 	}
 
 	/**
-	 * @returns the type of the current node
+	 * The type of the current node
 	 */
 	public get type(): TreeType {
 		return this.adapter.type(this.getNode());

package/src/feature-libraries/treeTextCursor.ts

@@ -66,7 +66,7 @@ export function cursorForJsonableTreeNode(root: JsonableTree): ITreeCursorSynchr
 }
 
 /**
- * @returns an {@link ITreeCursorSynchronous} in fields mode for a JsonableTree field.
+ * Creates an {@link ITreeCursorSynchronous} in fields mode for a JsonableTree field.
  */
 export function cursorForJsonableTreeField(
 	trees: JsonableTree[],

package/src/index.ts

@@ -69,6 +69,7 @@ export {
 	independentInitializedView,
 	type ViewContent,
 	TreeAlpha,
+	type TreeIdentifierUtils,
 	independentView,
 	ForestTypeOptimized,
 	ForestTypeExpensiveDebug,
@@ -166,10 +167,6 @@ export {
 	type UnannotateAllowedTypeOrLazyItem,
 	type UnannotateImplicitFieldSchema,
 	type UnannotateSchemaRecord,
-	// test recursive schema for checking that d.ts files handles schema correctly
-	test_RecursiveObject,
-	test_RecursiveObject_base,
-	test_RecursiveObjectPojoMode,
 	// Beta APIs
 	TreeBeta,
 	type TreeChangeEventsBeta,
@@ -258,6 +255,7 @@ export { persistedToSimpleSchema } from "./shared-tree/index.js";
 
 export {
 	type ICodecOptions,
+	type CodecWriteOptions,
 	type JsonValidator,
 	type SchemaValidationFunction,
 	FluidClientVersion,

package/src/packageVersion.ts

@@ -6,4 +6,4 @@
  */
 
 export const pkgName = "@fluidframework/tree";
-export const pkgVersion = "2.41.0-338401";
+export const pkgVersion = "2.42.0";

package/src/shared-tree/checkoutFlexTreeView.ts

@@ -4,6 +4,7 @@
  */
 
 import { assert } from "@fluidframework/core-utils/internal";
+
 import {
 	Context,
 	type FlexTreeField,

package/src/shared-tree/independentView.ts

@@ -9,10 +9,12 @@ import {
 	type IIdCompressor,
 	createIdCompressor,
 } from "@fluidframework/id-compressor/internal";
+
 import type { ICodecOptions } from "../codec/index.js";
 import {
 	type RevisionTag,
 	RevisionTagCodec,
+	SchemaVersion,
 	TreeStoredSchemaRepository,
 } from "../core/index.js";
 import {
@@ -23,7 +25,6 @@ import {
 	defaultSchemaPolicy,
 	TreeCompressionStrategy,
 	initializeForest,
-	SchemaCodecVersion,
 } from "../feature-libraries/index.js";
 // eslint-disable-next-line import/no-internal-modules
 import type { Format } from "../feature-libraries/schema-index/formatV1.js";
@@ -32,7 +33,7 @@ import type {
 	ImplicitFieldSchema,
 	TreeViewAlpha,
 } from "../simple-tree/index.js";
-import type { JsonCompatibleReadOnly, JsonCompatible } from "../util/index.js";
+import { type JsonCompatibleReadOnly, type JsonCompatible, Breakable } from "../util/index.js";
 import {
 	buildConfiguredForest,
 	defaultSharedTreeOptions,
@@ -54,11 +55,13 @@ export function independentView<const TSchema extends ImplicitFieldSchema>(
 	config: TreeViewConfiguration<TSchema>,
 	options: ForestOptions & { idCompressor?: IIdCompressor | undefined },
 ): TreeViewAlpha<TSchema> {
+	const breaker = new Breakable("independentView");
 	const idCompressor: IIdCompressor = options.idCompressor ?? createIdCompressor();
 	const mintRevisionTag = (): RevisionTag => idCompressor.generateCompressedId();
 	const revisionTagCodec = new RevisionTagCodec(idCompressor);
 	const schema = new TreeStoredSchemaRepository();
 	const forest = buildConfiguredForest(
+		breaker,
 		options.forest ?? defaultSharedTreeOptions.forest,
 		schema,
 		idCompressor,
@@ -66,6 +69,7 @@ export function independentView<const TSchema extends ImplicitFieldSchema>(
 	const checkout = createTreeCheckout(idCompressor, mintRevisionTag, revisionTagCodec, {
 		forest,
 		schema,
+		breaker,
 	});
 	const out: TreeViewAlpha<TSchema> = new SchematizingSimpleTreeView<TSchema>(
 		checkout,
@@ -88,15 +92,17 @@ export function independentInitializedView<const TSchema extends ImplicitFieldSc
 	options: ForestOptions & ICodecOptions,
 	content: ViewContent,
 ): TreeViewAlpha<TSchema> {
+	const breaker = new Breakable("independentInitializedView");
 	const idCompressor: IIdCompressor = content.idCompressor;
 	const mintRevisionTag = (): RevisionTag => idCompressor.generateCompressedId();
 	const revisionTagCodec = new RevisionTagCodec(idCompressor);
 
 	const fieldBatchCodec = makeFieldBatchCodec(options, 1);
-	const schemaCodec = makeSchemaCodec(options, SchemaCodecVersion.v1);
+	const schemaCodec = makeSchemaCodec(options, SchemaVersion.v1);
 
 	const schema = new TreeStoredSchemaRepository(schemaCodec.decode(content.schema as Format));
 	const forest = buildConfiguredForest(
+		breaker,
 		options.forest ?? defaultSharedTreeOptions.forest,
 		schema,
 		idCompressor,
@@ -118,6 +124,7 @@ export function independentInitializedView<const TSchema extends ImplicitFieldSc
 	const checkout = createTreeCheckout(idCompressor, mintRevisionTag, revisionTagCodec, {
 		forest,
 		schema,
+		breaker,
 	});
 	const out: TreeViewAlpha<TSchema> = new SchematizingSimpleTreeView<TSchema>(
 		checkout,

package/src/shared-tree/index.ts

@@ -50,7 +50,10 @@ export type {
 export { Tree } from "./tree.js";
 export type { RunTransaction } from "./tree.js";
 
-export { TreeAlpha } from "./treeAlpha.js";
+export {
+	TreeAlpha,
+	type TreeIdentifierUtils,
+} from "./treeAlpha.js";
 
 export {
 	independentInitializedView,

package/src/shared-tree/schematizeTree.ts

@@ -19,9 +19,10 @@ import {
 	defaultSchemaPolicy,
 	mapTreeFromCursor,
 } from "../feature-libraries/index.js";
+import type { SchemaCompatibilityTester } from "../simple-tree/index.js";
 import { isReadonlyArray } from "../util/index.js";
+
 import type { ITreeCheckout } from "./treeCheckout.js";
-import type { SchemaCompatibilityTester } from "../simple-tree/index.js";
 
 /**
  * Modify `storedSchema` and invoke `setInitialTree` when it's time to set the tree content.