@fluidframework/tree 2.81.0 → 2.82.0

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

@@ -46,6 +46,8 @@ import {
 	type DeltaDetachedNodeRename,
 	mapTaggedChange,
 	type RevisionReplacer,
+	comparePartialRevisions,
+	comparePartialChangesetLocalIds,
 } from "../../core/index.js";
 import {
 	type IdAllocationState,
@@ -56,14 +58,17 @@ import {
 	idAllocatorFromState,
 	type RangeQueryResult,
 	getOrCreate,
-	newTupleBTree,
 	mergeTupleBTrees,
 	type TupleBTree,
 	RangeMap,
 	balancedReduce,
+	newTupleBTree,
+	compareStrings,
+	createTupleComparator,
 } from "../../util/index.js";
 import {
 	getFromChangeAtomIdMap,
+	newChangeAtomIdBTree,
 	setInChangeAtomIdMap,
 	type ChangeAtomIdBTree,
 } from "../changeAtomIdBTree.js";
@@ -732,7 +737,7 @@ export class ModularChangeFamily
 			revisionForInvert,
 		);
 
-		const invertedNodes: ChangeAtomIdBTree<NodeChangeset> = newTupleBTree();
+		const invertedNodes = newChangeAtomIdBTree<NodeChangeset>();
 		change.change.nodeChanges.forEachPair(([revision, localId], nodeChangeset) => {
 			invertedNodes.set(
 				[revision, localId],
@@ -897,12 +902,12 @@ export class ModularChangeFamily
 			newChange: change,
 			baseChange: over.change,
 			baseFieldToContext: new Map(),
-			baseToRebasedNodeId: newTupleBTree(),
+			baseToRebasedNodeId: newChangeAtomIdBTree(),
 			rebasedFields: new Set(),
 			rebasedNodeToParent: brand(change.nodeToParent.clone()),
 			rebasedCrossFieldKeys: change.crossFieldKeys.clone(),
 			nodeIdPairs: [],
-			affectedBaseFields: newTupleBTree(),
+			affectedBaseFields: newFieldIdKeyBTree(),
 			fieldsWithUnattachedChild: new Set(),
 		};
 
@@ -1365,7 +1370,7 @@ export class ModularChangeFamily
 		const change = nodeChangeFromId(crossFieldTable.newChange.nodeChanges, newId);
 		const over = nodeChangeFromId(crossFieldTable.baseChange.nodeChanges, baseId);
 
-		const baseMap: FieldChangeMap = over?.fieldChanges ?? new Map();
+		const baseMap: FieldChangeMap = over?.fieldChanges ?? new Map<FieldKey, FieldChange>();
 
 		const fieldChanges =
 			change.fieldChanges !== undefined && over.fieldChanges !== undefined
@@ -1522,8 +1527,11 @@ export class ModularChangeFamily
 	}
 
 	public getRevisions(change: ModularChangeset): Set<RevisionTag | undefined> {
+		if (change.revisions === undefined || change.revisions.length === 0) {
+			return new Set([undefined]);
+		}
 		const aggregated: Set<RevisionTag | undefined> = new Set();
-		for (const revInfo of change.revisions ?? [{ revision: undefined }]) {
+		for (const revInfo of change.revisions) {
 			aggregated.add(revInfo.revision);
 		}
 		return aggregated;
@@ -1551,7 +1559,7 @@ export class ModularChangeFamily
 			nodeToParent: updatedNodeToParent,
 
 			// We've updated all references to old node IDs, so we no longer need an alias table.
-			nodeAliases: newTupleBTree(),
+			nodeAliases: newChangeAtomIdBTree(),
 			crossFieldKeys: replaceCrossFieldKeyTableRevisions(
 				change.crossFieldKeys,
 				replacer,
@@ -1763,7 +1771,7 @@ function replaceCrossFieldKeyTableRevisions(
 	const updated: CrossFieldKeyTable = newCrossFieldKeyTable();
 	for (const entry of table.entries()) {
 		const key = entry.start;
-		const updatedKey: CrossFieldKey = replacer.getUpdatedAtomId(key);
+		const updatedKey: CrossFieldKey = replacer.getUpdatedAtomId(key, entry.length);
 
 		const field = entry.value;
 		const normalizedFieldId = normalizeFieldId(field, nodeAliases);
@@ -1788,7 +1796,7 @@ function replaceIdMapRevisions<T>(
 	replacer: RevisionReplacer,
 	valueMapper: (value: T) => T = (value) => value,
 ): ChangeAtomIdBTree<T> {
-	const updated: ChangeAtomIdBTree<T> = newTupleBTree();
+	const updated = newChangeAtomIdBTree<T>();
 	for (const [[revision, localId], value] of map.entries()) {
 		const newAtom = replacer.getUpdatedAtomId({ revision, localId });
 		updated.set([newAtom.revision, newAtom.localId], valueMapper(value));
@@ -1819,20 +1827,23 @@ function composeBuildsDestroysAndRefreshers(
 	// care to support at this time.
 	const allBuilds: ChangeAtomIdBTree<TreeChunk> = brand(
 		mergeTupleBTrees(
-			change1.builds ?? newTupleBTree(),
-			change2.builds ?? newTupleBTree(),
+			change1.builds ?? newChangeAtomIdBTree(),
+			change2.builds ?? newChangeAtomIdBTree(),
 			true,
 		),
 	);
 
 	const allDestroys: ChangeAtomIdBTree<number> = brand(
-		mergeTupleBTrees(change1.destroys ?? newTupleBTree(), change2.destroys ?? newTupleBTree()),
+		mergeTupleBTrees(
+			change1.destroys ?? newChangeAtomIdBTree(),
+			change2.destroys ?? newChangeAtomIdBTree(),
+		),
 	);
 
 	const allRefreshers: ChangeAtomIdBTree<TreeChunk> = brand(
 		mergeTupleBTrees(
-			change1.refreshers ?? newTupleBTree(),
-			change2.refreshers ?? newTupleBTree(),
+			change1.refreshers ?? newChangeAtomIdBTree(),
+			change2.refreshers ?? newChangeAtomIdBTree(),
 			true,
 		),
 	);
@@ -1942,7 +1953,7 @@ export function updateRefreshers(
 	removedRoots: Iterable<DeltaDetachedNodeId>,
 	requireRefreshers: boolean = true,
 ): ModularChangeset {
-	const refreshers: ChangeAtomIdBTree<TreeChunk> = newTupleBTree();
+	const refreshers = newChangeAtomIdBTree<TreeChunk>();
 	const chunkLengths: Map<RevisionTag | undefined, BTree<number, number>> = new Map();
 
 	if (change.builds !== undefined) {
@@ -2103,7 +2114,7 @@ function intoDeltaImpl(
 				return deltaFromNodeChange(nodeChange, nodeChanges, fieldKinds, global, rename);
 			},
 		);
-		if (fieldChanges !== undefined && fieldChanges.length > 0) {
+		if (fieldChanges !== undefined && fieldChanges.marks.length > 0) {
 			delta.set(field, fieldChanges);
 		}
 		for (const c of fieldGlobal ?? []) {
@@ -2235,7 +2246,7 @@ interface RebaseTable extends CrossFieldTable<FieldChange> {
 	readonly fieldsWithUnattachedChild: Set<FieldChange>;
 }
 
-type FieldIdKey = [RevisionTag | undefined, ChangesetLocalId | undefined, FieldKey];
+type FieldIdKey = readonly [RevisionTag | undefined, ChangesetLocalId | undefined, FieldKey];
 
 interface RebaseFieldContext {
 	baseChange: FieldChange;
@@ -2261,13 +2272,13 @@ function newComposeTable(
 		newChange,
 		fieldToContext: new Map(),
 		newFieldToBaseField: new Map(),
-		newToBaseNodeId: newTupleBTree(),
+		newToBaseNodeId: newChangeAtomIdBTree(),
 		composedNodes: new Set(),
 		composedNodeToParent,
 		pendingCompositions: {
 			nodeIdsToCompose: [],
-			affectedBaseFields: newTupleBTree(),
-			affectedNewFields: newTupleBTree(),
+			affectedBaseFields: newFieldIdKeyBTree(),
+			affectedNewFields: newFieldIdKeyBTree(),
 		},
 	};
 }
@@ -2625,10 +2636,10 @@ function makeModularChangeset(props?: {
 }): ModularChangeset {
 	const p = props ?? { maxId: -1 };
 	const changeset: Mutable<ModularChangeset> = {
-		fieldChanges: p.fieldChanges ?? new Map(),
-		nodeChanges: p.nodeChanges ?? newTupleBTree(),
-		nodeToParent: p.nodeToParent ?? newTupleBTree(),
-		nodeAliases: p.nodeAliases ?? newTupleBTree(),
+		fieldChanges: p.fieldChanges ?? new Map<FieldKey, FieldChange>(),
+		nodeChanges: p.nodeChanges ?? newChangeAtomIdBTree(),
+		nodeToParent: p.nodeToParent ?? newChangeAtomIdBTree(),
+		nodeAliases: p.nodeAliases ?? newChangeAtomIdBTree(),
 		crossFieldKeys: p.crossFieldKeys ?? newCrossFieldKeyTable(),
 	};
 
@@ -2717,7 +2728,7 @@ export class ModularEditBuilder extends EditBuilder<ModularChangeset> {
 		// This content will be added to a GlobalEditDescription whose lifetime exceeds the scope of this function.
 		content.referenceAdded();
 
-		const builds: ChangeAtomIdBTree<TreeChunk> = newTupleBTree();
+		const builds = newChangeAtomIdBTree<TreeChunk>();
 		builds.set([revision, firstId], content);
 
 		return {
@@ -2747,8 +2758,8 @@ export class ModularEditBuilder extends EditBuilder<ModularChangeset> {
 		const modularChange = buildModularChangesetFromField({
 			path: field,
 			fieldChange: { fieldKind, change },
-			nodeChanges: newTupleBTree(),
-			nodeToParent: newTupleBTree(),
+			nodeChanges: newChangeAtomIdBTree(),
+			nodeToParent: newChangeAtomIdBTree(),
 			crossFieldKeys: newCrossFieldKeyTable(),
 			idAllocator: this.idAllocator,
 			localCrossFieldKeys,
@@ -2779,8 +2790,8 @@ export class ModularEditBuilder extends EditBuilder<ModularChangeset> {
 								fieldKind: change.fieldKind,
 								change: change.change,
 							},
-							nodeChanges: newTupleBTree(),
-							nodeToParent: newTupleBTree(),
+							nodeChanges: newChangeAtomIdBTree(),
+							nodeToParent: newChangeAtomIdBTree(),
 							crossFieldKeys: newCrossFieldKeyTable(),
 							idAllocator: this.idAllocator,
 							localCrossFieldKeys: getChangeHandler(
@@ -2818,8 +2829,8 @@ export class ModularEditBuilder extends EditBuilder<ModularChangeset> {
 				buildModularChangesetFromNode({
 					path,
 					nodeChange,
-					nodeChanges: newTupleBTree(),
-					nodeToParent: newTupleBTree(),
+					nodeChanges: newChangeAtomIdBTree(),
+					nodeToParent: newChangeAtomIdBTree(),
 					crossFieldKeys: newCrossFieldKeyTable(),
 					idAllocator: this.idAllocator,
 					revision,
@@ -2839,8 +2850,8 @@ export class ModularEditBuilder extends EditBuilder<ModularChangeset> {
 				buildModularChangesetFromNode({
 					path,
 					nodeChange,
-					nodeChanges: newTupleBTree(),
-					nodeToParent: newTupleBTree(),
+					nodeChanges: newChangeAtomIdBTree(),
+					nodeToParent: newChangeAtomIdBTree(),
 					crossFieldKeys: newCrossFieldKeyTable(),
 					idAllocator: this.idAllocator,
 					revision,
@@ -3197,3 +3208,13 @@ interface ModularChangesetContent {
 function areEqualFieldIds(a: FieldId, b: FieldId): boolean {
 	return areEqualChangeAtomIdOpts(a.nodeId, b.nodeId) && a.field === b.field;
 }
+
+function newFieldIdKeyBTree<V>(): TupleBTree<FieldIdKey, V> {
+	return newTupleBTree(compareFieldIdKeys);
+}
+
+const compareFieldIdKeys = createTupleComparator([
+	comparePartialRevisions,
+	comparePartialChangesetLocalIds,
+	compareStrings<FieldKey>,
+]);

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

@@ -11,7 +11,6 @@ import {
 	JsonCompatibleReadOnlySchema,
 	brandedNumberType,
 } from "../../util/index.js";
-import { EncodedFieldBatch } from "../chunked-forest/index.js";
 
 const noAdditionalProps: ObjectOptions = { additionalProperties: false };
 
@@ -115,10 +114,9 @@ export const EncodedBuilds = Type.Object(
 	{
 		builds: EncodedBuildsArray,
 		/**
-		 * Fields indexed by the EncodedTreeIndexes above.
-		 * TODO: Strongly typing this here may result in redundant schema validation of this data.
+		 * FieldBatch codec encoded data indexed by the EncodedTreeIndexes above.
 		 */
-		trees: EncodedFieldBatch,
+		trees: JsonCompatibleReadOnlySchema,
 	},
 	noAdditionalProps,
 );

package/src/feature-libraries/optional-field/optionalField.ts

@@ -710,7 +710,7 @@ export function optionalFieldIntoDelta(
 	}
 
 	if (!markIsANoop) {
-		delta.local = [mark];
+		delta.local = { marks: [mark] };
 	}
 
 	return delta;

package/src/feature-libraries/optional-field/requiredField.ts

@@ -36,10 +36,8 @@ export interface RequiredFieldEditor extends FieldEditor<OptionalChangeset> {
 
 export const requiredFieldEditor: RequiredFieldEditor = {
 	...optionalFieldEditor,
-	set: (ids: {
-		fill: ChangeAtomId;
-		detach: ChangeAtomId;
-	}): OptionalChangeset => optionalFieldEditor.set(false, ids),
+	set: (ids: { fill: ChangeAtomId; detach: ChangeAtomId }): OptionalChangeset =>
+		optionalFieldEditor.set(false, ids),
 };
 
 export const requiredFieldChangeHandler: FieldChangeHandler<

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

@@ -80,7 +80,7 @@ function encodeNodeSchema<TFormat>(
 	repo: TreeStoredSchema,
 	encodeValue: (schema: TreeNodeStoredSchema) => TFormat,
 ): Record<string, TFormat> {
-	const nodeSchema: Record<string, TFormat> = Object.create(null);
+	const nodeSchema: Record<string, TFormat> = Object.create(null) as Record<string, TFormat>;
 	for (const name of [...repo.nodeSchema.keys()].sort()) {
 		const schema = repo.nodeSchema.get(name) ?? fail(0xb28 /* missing schema */);
 		Object.defineProperty(nodeSchema, name, {

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

@@ -130,7 +130,7 @@ export class SchemaSummarizer
 			0x3da /* there should not already be stored schema when loading stored schema */,
 		);
 
-		const schemaString = bufferToString(schemaBuffer, "utf-8");
+		const schemaString = bufferToString(schemaBuffer, "utf8");
 		// Currently no Fluid handles are used, so just use JSON.parse.
 		const decoded = this.codec.decode(JSON.parse(schemaString));
 		this.schema.apply(decoded);

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

@@ -189,7 +189,7 @@ function invertMark(
 			if (mark.finalEndpoint !== undefined) {
 				moveIn.finalEndpoint = {
 					localId: mark.finalEndpoint.localId,
-					revision: mark.revision,
+					revision,
 				};
 			}
 			let effect: MarkEffect = moveIn;
@@ -228,7 +228,7 @@ function invertMark(
 			if (mark.finalEndpoint) {
 				invertedMark.finalEndpoint = {
 					localId: mark.finalEndpoint.localId,
-					revision: mark.revision,
+					revision,
 				};
 			}
 			return applyMovedChanges(invertedMark, mark.revision, crossFieldManager);

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

@@ -40,9 +40,9 @@ export function replaceRevisions(changeset: Changeset, replacer: RevisionReplace
 }
 
 function updateMark(mark: Mark, replacer: RevisionReplacer): Mark {
-	const updatedMark = { ...updateEffect(mark, replacer) };
+	const updatedMark = { ...updateEffect(mark, mark.count, replacer) };
 	if (mark.cellId !== undefined) {
-		updatedMark.cellId = replacer.getUpdatedAtomId(mark.cellId);
+		updatedMark.cellId = replacer.getUpdatedAtomId(mark.cellId, mark.count);
 	}
 
 	if (mark.changes !== undefined) {
@@ -54,9 +54,11 @@ function updateMark(mark: Mark, replacer: RevisionReplacer): Mark {
 
 function updateEffect<TMark extends MarkEffect>(
 	input: TMark,
+	count: number,
 	replacer: RevisionReplacer,
 ): TMark {
-	const mark = isDetach(input) || isRename(input) ? updateIdOverride(input, replacer) : input;
+	const mark =
+		isDetach(input) || isRename(input) ? updateIdOverride(input, count, replacer) : input;
 	const type = mark.type;
 	switch (type) {
 		case "Rename":
@@ -66,8 +68,8 @@ function updateEffect<TMark extends MarkEffect>(
 		case "AttachAndDetach": {
 			return {
 				...mark,
-				attach: updateEffect(mark.attach, replacer),
-				detach: updateEffect(mark.detach, replacer),
+				attach: updateEffect(mark.attach, count, replacer),
+				detach: updateEffect(mark.detach, count, replacer),
 			};
 		}
 		case "MoveIn":
@@ -75,12 +77,13 @@ function updateEffect<TMark extends MarkEffect>(
 			return updateMoveEffect<TMark & MoveMarkEffect>(
 				// For some reason, TypeScript is not able to infer that `mark` cannot be a `NoopMark` here.
 				mark as MoveMarkEffect,
+				count,
 				replacer,
 			);
 		}
 		case "Insert":
 		case "Remove": {
-			return updateRevisionAndId(mark as (TMark & Insert) | (TMark & Remove), replacer);
+			return updateRevisionAndId(mark as (TMark & Insert) | (TMark & Remove), count, replacer);
 		}
 		default: {
 			unreachableCase(type);
@@ -90,38 +93,42 @@ function updateEffect<TMark extends MarkEffect>(
 
 function updateIdOverride<TEffect extends Detach | Rename>(
 	effect: TEffect,
+	count: number,
 	replacer: RevisionReplacer,
 ): TEffect {
 	if (effect.idOverride === undefined) {
 		return effect;
 	}
-	const idOverride = replacer.getUpdatedAtomId(effect.idOverride);
+	const idOverride = replacer.getUpdatedAtomId(effect.idOverride, count);
 	return { ...effect, idOverride };
 }
 
 function updateMoveEffect<TEffect extends HasMoveFields>(
 	effect: TEffect,
+	count: number,
 	replacer: RevisionReplacer,
 ): TEffect {
 	return effect.finalEndpoint === undefined
-		? updateRevisionAndId(effect, replacer)
+		? updateRevisionAndId(effect, count, replacer)
 		: updateRevisionAndId(
 				{
 					...effect,
-					finalEndpoint: replacer.getUpdatedAtomId(effect.finalEndpoint),
+					finalEndpoint: replacer.getUpdatedAtomId(effect.finalEndpoint, count),
 				},
+				count,
 				replacer,
 			);
 }
 
 function updateRevisionAndId<T extends HasRevisionTag & HasMoveId>(
 	input: T,
+	count: number,
 	replacer: RevisionReplacer,
 ): T {
 	if (!replacer.isObsolete(input.revision)) {
 		return input;
 	}
-	const newAtom = replacer.getUpdatedAtomId(makeChangeAtomId(input.id, input.revision));
+	const newAtom = replacer.getUpdatedAtomId(makeChangeAtomId(input.id, input.revision), count);
 	return withRevisionAndId(input, newAtom.revision, newAtom.localId);
 }
 

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

@@ -191,7 +191,7 @@ export function sequenceFieldToDelta(
 	}
 	const delta: Mutable<FieldChangeDelta> = {};
 	if (local.length > 0) {
-		delta.local = local;
+		delta.local = { marks: local };
 	}
 	if (global.length > 0) {
 		delta.global = global;

package/src/index.ts

@@ -76,8 +76,10 @@ export {
 	type ObservationResults,
 	type TreeIdentifierUtils,
 	independentView,
+	type IndependentViewOptions,
 	createIndependentTreeBeta,
 	createIndependentTreeAlpha,
+	type CreateIndependentTreeAlphaOptions,
 	ForestTypeOptimized,
 	ForestTypeExpensiveDebug,
 	ForestTypeReference,
@@ -301,6 +303,8 @@ export {
 	eraseSchemaDetails,
 	eraseSchemaDetailsSubclassable,
 	type SchemaCompatibilitySnapshotsOptions,
+	type ArrayPlaceAnchor,
+	createArrayInsertionAnchor,
 } from "./simple-tree/index.js";
 export {
 	SharedTree,
@@ -315,6 +319,7 @@ export { persistedToSimpleSchema } from "./shared-tree/index.js";
 export {
 	type ICodecOptions,
 	type CodecWriteOptions,
+	type CodecWriteOptionsBeta,
 	FluidClientVersion,
 	type FormatValidator,
 	FormatValidatorNoOp,
@@ -348,13 +353,12 @@ export type {
 export { cloneWithReplacements } from "./util/index.js";
 
 import * as InternalTypes from "./internalTypes.js";
-export {
-	/**
-	 * Contains types used by the API, but which serve mechanical purposes and do not represent semantic concepts.
-	 * They are used internally to implement API aspects, but are not intended for use by external consumers.
-	 */
-	InternalTypes,
-};
+/**
+ * Contains types used by the API, but which serve mechanical purposes and do not represent semantic concepts.
+ * They are used internally to implement API aspects, but are not intended for use by external consumers.
+ */
+// eslint-disable-next-line unicorn/prefer-export-from -- fixing requires `export * as` (breaks API-Extractor)
+export { InternalTypes };
 
 // Internal/System types:
 // These would be put in `internalTypes` except doing so tents to cause errors like:
@@ -367,3 +371,4 @@ export { TableSchema, type System_TableSchema } from "./tableSchema.js";
 export { asAlpha, asBeta } from "./api.js";
 
 export { TextAsTree, FormattedTextAsTree } from "./text/index.js";
+export { ExtensibleSchemaUnion } from "./extensibleSchemaUnion.js";

package/src/packageVersion.ts

@@ -6,4 +6,4 @@
  */
 
 export const pkgName = "@fluidframework/tree";
-export const pkgVersion = "2.81.0";
+export const pkgVersion = "2.82.0";

package/src/shared-tree/independentView.ts

@@ -61,6 +61,45 @@ import {
 } from "./sharedTree.js";
 import { createTreeCheckout } from "./treeCheckout.js";
 
+/**
+ * {@link independentView} options.
+ * @alpha @input
+ */
+export interface IndependentViewOptions extends ForestOptions, Partial<CodecWriteOptions> {
+	/**
+	 * Optional ID compressor for generating and compressing identifiers.
+	 * If not provided, a new one will be created.
+	 */
+	idCompressor?: IIdCompressor | undefined;
+}
+
+/**
+ * {@link createIndependentTreeAlpha} options.
+ * @alpha
+ */
+export type CreateIndependentTreeAlphaOptions = ForestOptions &
+	(
+		| (IndependentViewOptions & {
+				/**
+				 * Optional content for initializing the tree.
+				 * If not provided, the tree will be uninitialized.
+				 */
+				content?: never;
+		  })
+		| (ICodecOptions & {
+				/**
+				 * Content for initializing the tree.
+				 * The content includes the idCompressor, so idCompressor should not be provided at the top level.
+				 */
+				content: ViewContent;
+				/**
+				 * Should not be provided when content is specified.
+				 * The idCompressor will be obtained from the content.
+				 */
+				idCompressor?: never;
+		  })
+	);
+
 /**
  * Create an uninitialized {@link TreeView} that is not tied to any {@link ITree} instance.
  *
@@ -72,7 +111,7 @@ import { createTreeCheckout } from "./treeCheckout.js";
  */
 export function independentView<const TSchema extends ImplicitFieldSchema>(
 	config: TreeViewConfiguration<TSchema>,
-	options?: ForestOptions & { idCompressor?: IIdCompressor | undefined },
+	options?: IndependentViewOptions,
 ): TreeViewAlpha<TSchema> {
 	return createIndependentTreeAlpha(options).viewWith(config) as TreeViewAlpha<TSchema>;
 }
@@ -170,11 +209,7 @@ export function createIndependentTreeBeta<const TSchema extends ImplicitFieldSch
  * @alpha
  */
 export function createIndependentTreeAlpha<const TSchema extends ImplicitFieldSchema>(
-	options?: ForestOptions &
-		(
-			| ({ idCompressor?: IIdCompressor | undefined } & { content?: undefined })
-			| (ICodecOptions & { content: ViewContent } & { idCompressor?: undefined })
-		),
+	options?: CreateIndependentTreeAlphaOptions,
 ): ViewableTree & Pick<ITreeAlpha, "exportVerbose" | "exportSimpleSchema"> {
 	const breaker = new Breakable("independentView");
 	const idCompressor: IIdCompressor =
@@ -197,6 +232,7 @@ export function createIndependentTreeAlpha<const TSchema extends ImplicitFieldSc
 		forest,
 		schema: schemaRepository,
 		breaker,
+		codecOptions: options,
 	});
 
 	if (options?.content !== undefined) {

package/src/shared-tree/index.ts

@@ -59,8 +59,10 @@ export {
 	independentInitializedView,
 	type ViewContent,
 	independentView,
+	type IndependentViewOptions,
 	createIndependentTreeBeta,
 	createIndependentTreeAlpha,
+	type CreateIndependentTreeAlphaOptions,
 } from "./independentView.js";
 
 export type { SharedTreeChange } from "./sharedTreeChangeTypes.js";