@fluidframework/tree 2.90.0-378676 → 2.91.0

package/lib/alpha.d.ts

@@ -1,300 +0,0 @@
-/*!
- * Copyright (c) Microsoft Corporation and contributors. All rights reserved.
- * Licensed under the MIT License.
- */
-
-/*
- * THIS IS AN AUTOGENERATED FILE. DO NOT EDIT THIS FILE DIRECTLY.
- * Generated by "flub generate entrypoints" in @fluid-tools/build-cli.
- */
-
-export {
-	// #region Unrestricted APIs
-	InternalTypes,
-	// #endregion
-	 
-	// #region @public APIs
-	AllowedTypes, 
-	CommitKind, 
-	CommitMetadata, 
-	FieldKind, 
-	FieldProps, 
-	FieldSchema, 
-	FieldSchemaMetadata, 
-	ITree, 
-	ITreeConfigurationOptions, 
-	ITreeViewConfiguration, 
-	ImplicitAllowedTypes, 
-	ImplicitFieldSchema, 
-	Input, 
-	InsertableTreeFieldFromImplicitField, 
-	InsertableTreeNodeFromAllowedTypes, 
-	InsertableTreeNodeFromImplicitAllowedTypes, 
-	InsertableTypedNode, 
-	InternalTreeNode, 
-	IsListener, 
-	IsUnion, 
-	IterableTreeArrayContent, 
-	LazyItem, 
-	LeafSchema, 
-	Listenable, 
-	Listeners, 
-	MakeNominal, 
-	MapNodeInsertableData, 
-	NodeFromSchema, 
-	NodeInDocumentConstraint, 
-	NodeKind, 
-	NodeSchemaMetadata, 
-	NodeSchemaOptions, 
-	NumberKeys, 
-	ObjectFromSchemaRecord, 
-	Off, 
-	ReadonlyArrayNode, 
-	RestrictiveReadonlyRecord, 
-	RestrictiveStringRecord, 
-	Revertible, 
-	RevertibleFactory, 
-	RevertibleStatus, 
-	RunTransaction, 
-	SchemaCompatibilityStatus, 
-	SchemaFactory, 
-	SchemaFactory_base, 
-	SchemaStatics, 
-	SimpleNodeSchemaBase, 
-	System_Unsafe, 
-	TransactionConstraint, 
-	Tree, 
-	TreeArrayNode, 
-	TreeChangeEvents, 
-	TreeFieldFromImplicitField, 
-	TreeLeafValue, 
-	TreeMapNode, 
-	TreeNode, 
-	TreeNodeApi, 
-	TreeNodeFromImplicitAllowedTypes, 
-	TreeNodeSchema, 
-	TreeNodeSchemaClass, 
-	TreeNodeSchemaCore, 
-	TreeNodeSchemaNonClass, 
-	TreeObjectNode, 
-	TreeStatus, 
-	TreeView, 
-	TreeViewConfiguration, 
-	TreeViewEvents, 
-	Unenforced, 
-	Unhydrated, 
-	UnionToIntersection, 
-	ValidateRecursiveSchema, 
-	ValidateRecursiveSchemaTemplate, 
-	ViewableTree, 
-	WithType, 
-	rollback, 
-	typeSchemaSymbol,
-	// #endregion
- 
-	// #region @beta APIs
-	AllowedTypeMetadata, 
-	AllowedTypesFull, 
-	AllowedTypesFullEvaluated, 
-	AllowedTypesFullFromMixed, 
-	AllowedTypesFullFromMixedUnsafe, 
-	AllowedTypesMetadata, 
-	AnnotateAllowedTypesList, 
-	AnnotateAllowedTypesListUnsafe, 
-	AnnotatedAllowedType, 
-	AnnotatedAllowedTypeUnsafe, 
-	AnnotatedAllowedTypes, 
-	AnnotatedAllowedTypesUnsafe, 
-	CodecWriteOptionsBeta, 
-	ConciseTree, 
-	ExtensibleUnionNode, 
-	FixRecursiveArraySchema, 
-	FluidSerializableAsTree, 
-	ForestOptions, 
-	ForestType, 
-	ForestTypeExpensiveDebug, 
-	ForestTypeOptimized, 
-	ForestTypeReference, 
-	JsonCompatible, 
-	JsonCompatibleObject, 
-	KeyEncodingOptions, 
-	NodeChangedData, 
-	ObjectSchemaOptions, 
-	PopUnion, 
-	RecordNodeInsertableData, 
-	SchemaFactoryBeta, 
-	SchemaStaticsBeta, 
-	SchemaUpgrade, 
-	SharedTreeOptionsBeta, 
-	System_TableSchema, 
-	TableSchema, 
-	TreeBeta, 
-	TreeBranch, 
-	TreeChangeEventsBeta, 
-	TreeEncodingOptions, 
-	TreeRecordNode, 
-	TreeRecordNodeUnsafe, 
-	TreeViewBeta, 
-	UnannotateAllowedTypeUnsafe, 
-	UnannotateAllowedTypesList, 
-	UnannotateAllowedTypesListUnsafe, 
-	UnionToTuple, 
-	adaptEnum, 
-	asBeta, 
-	configuredSharedTreeBeta, 
-	createIndependentTreeBeta, 
-	enumFromStrings, 
-	singletonSchema,
-	// #endregion
- 
-	// #region @alpha APIs
-	AllowedTypesFullUnsafe, 
-	ArrayNodeCustomizableSchema, 
-	ArrayNodeCustomizableSchemaUnsafe, 
-	ArrayNodePojoEmulationSchema, 
-	ArrayNodeSchema, 
-	ArrayPlaceAnchor, 
-	BranchableTree, 
-	ChangeMetadata, 
-	CodecName, 
-	CodecWriteOptions, 
-	CreateIndependentTreeAlphaOptions, 
-	DirtyTreeMap, 
-	DirtyTreeStatus, 
-	FactoryContent, 
-	FactoryContentObject, 
-	FieldPropsAlpha, 
-	FieldSchemaAlpha, 
-	FieldSchemaAlphaUnsafe, 
-	FluidClientVersion, 
-	FormatValidator, 
-	FormatValidatorBasic, 
-	FormatValidatorNoOp, 
-	FormatVersion, 
-	HandleConverter, 
-	ICodecOptions, 
-	ITreeAlpha, 
-	IdentifierIndex, 
-	IncrementalEncodingPolicy, 
-	IndependentViewOptions, 
-	Insertable, 
-	InsertableContent, 
-	InsertableField, 
-	JsonArrayNodeSchema, 
-	JsonAsTree, 
-	JsonCompatibleReadOnly, 
-	JsonCompatibleReadOnlyObject, 
-	JsonFieldSchema, 
-	JsonLeafNodeSchema, 
-	JsonLeafSchemaType, 
-	JsonMapNodeSchema, 
-	JsonNodeSchema, 
-	JsonNodeSchemaBase, 
-	JsonObjectNodeSchema, 
-	JsonRecordNodeSchema, 
-	JsonRefPath, 
-	JsonSchemaId, 
-	JsonSchemaRef, 
-	JsonSchemaType, 
-	JsonStringKeyPatternProperties, 
-	JsonTreeSchema, 
-	LocalChangeMetadata, 
-	MapNodeCustomizableSchema, 
-	MapNodeCustomizableSchemaUnsafe, 
-	MapNodePojoEmulationSchema, 
-	MapNodeSchema, 
-	NoChangeConstraint, 
-	NodeSchemaOptionsAlpha, 
-	ObjectNodeSchema, 
-	ObjectSchemaOptionsAlpha, 
-	ObservationResults, 
-	ReadSchema, 
-	ReadableField, 
-	RecordNodeCustomizableSchema, 
-	RecordNodePojoEmulationSchema, 
-	RecordNodeSchema, 
-	RemoteChangeMetadata, 
-	RevertibleAlpha, 
-	RevertibleAlphaFactory, 
-	RunTransactionParams, 
-	SchemaFactoryAlpha, 
-	SchemaType, 
-	SharedTreeFormatOptions, 
-	SharedTreeOptions, 
-	SimpleAllowedTypeAttributes, 
-	SimpleArrayNodeSchema, 
-	SimpleFieldSchema, 
-	SimpleLeafNodeSchema, 
-	SimpleMapNodeSchema, 
-	SimpleNodeSchema, 
-	SimpleNodeSchemaBaseAlpha, 
-	SimpleObjectFieldSchema, 
-	SimpleObjectNodeSchema, 
-	SimpleRecordNodeSchema, 
-	SimpleTreeIndex, 
-	SimpleTreeSchema, 
-	SnapshotFileSystem, 
-	SnapshotSchemaCompatibilityOptions, 
-	TransactionCallbackStatus, 
-	TransactionConstraintAlpha, 
-	TransactionResult, 
-	TransactionResultExt, 
-	TransactionResultFailed, 
-	TransactionResultSuccess, 
-	TreeAlpha, 
-	TreeBranchAlpha, 
-	TreeBranchEvents, 
-	TreeBranchFork, 
-	TreeCompressionStrategy, 
-	TreeIdentifierUtils, 
-	TreeIndex, 
-	TreeIndexKey, 
-	TreeIndexNodes, 
-	TreeParsingOptions, 
-	TreeSchema, 
-	TreeSchemaEncodingOptions, 
-	TreeViewAlpha, 
-	TreeViewConfigurationAlpha, 
-	UnsafeUnknownSchema, 
-	ValueSchema, 
-	VerboseTree, 
-	VerboseTreeNode, 
-	ViewContent, 
-	VoidTransactionCallbackStatus, 
-	allowUnused, 
-	asAlpha, 
-	asTreeViewAlpha, 
-	checkCompatibility, 
-	cloneWithReplacements, 
-	comparePersistedSchema, 
-	configuredSharedTreeAlpha, 
-	contentSchemaSymbol, 
-	createArrayInsertionAnchor, 
-	createIdentifierIndex, 
-	createIndependentTreeAlpha, 
-	createSimpleTreeIndex, 
-	decodeSchemaCompatibilitySnapshot, 
-	encodeSchemaCompatibilitySnapshot, 
-	eraseSchemaDetails, 
-	eraseSchemaDetailsSubclassable, 
-	evaluateLazySchema, 
-	exportCompatibilitySchemaSnapshot, 
-	extractPersistedSchema, 
-	generateSchemaFromSimpleSchema, 
-	getBranch, 
-	getJsonSchema, 
-	getSimpleSchema, 
-	importCompatibilitySchemaSnapshot, 
-	incrementalEncodingPolicyForAllowedTypes, 
-	incrementalSummaryHint, 
-	independentInitializedView, 
-	independentView, 
-	normalizeAllowedTypes, 
-	persistedToSimpleSchema, 
-	replaceConciseTreeHandles, 
-	replaceHandles, 
-	replaceVerboseTreeHandles, 
-	snapshotSchemaCompatibility, 
-	trackDirtyNodes
-	// #endregion
-} from "./index.js";

package/lib/core/schema-view/index.d.ts

@@ -1,6 +0,0 @@
-/*!
- * Copyright (c) Microsoft Corporation and contributors. All rights reserved.
- * Licensed under the MIT License.
- */
-export { type Adapters, type TreeAdapter, AdaptedViewSchema, } from "./view.js";
-//# sourceMappingURL=index.d.ts.map

package/lib/core/schema-view/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/schema-view/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACN,KAAK,QAAQ,EACb,KAAK,WAAW,EAChB,iBAAiB,GACjB,MAAM,WAAW,CAAC"}

package/lib/core/schema-view/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/schema-view/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAGN,iBAAiB,GACjB,MAAM,WAAW,CAAC","sourcesContent":["/*!\n * Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n */\n\nexport {\n\ttype Adapters,\n\ttype TreeAdapter,\n\tAdaptedViewSchema,\n} from \"./view.js\";\n"]}

package/lib/core/schema-view/view.d.ts

@@ -1,31 +0,0 @@
-/*!
- * Copyright (c) Microsoft Corporation and contributors. All rights reserved.
- * Licensed under the MIT License.
- */
-import type { TreeNodeSchemaIdentifier, TreeStoredSchema } from "../schema-stored/index.js";
-/**
- * APIs for applying `view schema` to documents.
- */
-export interface TreeAdapter {
-    readonly output: TreeNodeSchemaIdentifier;
-    readonly input: TreeNodeSchemaIdentifier;
-}
-/**
- * Minimal selection of adapters (nothing for general out of schema, field level adjustments etc.).
- * Would be used with schematize and have actual conversion/update functionality.
- *
- * TODO: Support more kinds of adapters
- * TODO: support efficient lookup of adapters
- */
-export interface Adapters {
-    readonly tree?: readonly TreeAdapter[];
-}
-/**
- * A collection of View information for schema, including policy.
- */
-export declare class AdaptedViewSchema {
-    readonly adapters: Adapters;
-    readonly adaptedForViewSchema: TreeStoredSchema;
-    constructor(adapters: Adapters, adaptedForViewSchema: TreeStoredSchema);
-}
-//# sourceMappingURL=view.d.ts.map

package/lib/core/schema-view/view.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"view.d.ts","sourceRoot":"","sources":["../../../src/core/schema-view/view.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,wBAAwB,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAE5F;;GAEG;AAEH,MAAM,WAAW,WAAW;IAC3B,QAAQ,CAAC,MAAM,EAAE,wBAAwB,CAAC;IAC1C,QAAQ,CAAC,KAAK,EAAE,wBAAwB,CAAC;CAGzC;AAED;;;;;;GAMG;AACH,MAAM,WAAW,QAAQ;IACxB,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,WAAW,EAAE,CAAC;CACvC;AAED;;GAEG;AACH,qBAAa,iBAAiB;aAEZ,QAAQ,EAAE,QAAQ;aAClB,oBAAoB,EAAE,gBAAgB;gBADtC,QAAQ,EAAE,QAAQ,EAClB,oBAAoB,EAAE,gBAAgB;CAEvD"}

package/lib/core/schema-view/view.js

@@ -1,14 +0,0 @@
-/*!
- * Copyright (c) Microsoft Corporation and contributors. All rights reserved.
- * Licensed under the MIT License.
- */
-/**
- * A collection of View information for schema, including policy.
- */
-export class AdaptedViewSchema {
-    constructor(adapters, adaptedForViewSchema) {
-        this.adapters = adapters;
-        this.adaptedForViewSchema = adaptedForViewSchema;
-    }
-}
-//# sourceMappingURL=view.js.map

package/lib/core/schema-view/view.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"view.js","sourceRoot":"","sources":["../../../src/core/schema-view/view.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA0BH;;GAEG;AACH,MAAM,OAAO,iBAAiB;IAC7B,YACiB,QAAkB,EAClB,oBAAsC;QADtC,aAAQ,GAAR,QAAQ,CAAU;QAClB,yBAAoB,GAApB,oBAAoB,CAAkB;IACpD,CAAC;CACJ","sourcesContent":["/*!\n * Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n */\n\nimport type { TreeNodeSchemaIdentifier, TreeStoredSchema } from \"../schema-stored/index.js\";\n\n/**\n * APIs for applying `view schema` to documents.\n */\n\nexport interface TreeAdapter {\n\treadonly output: TreeNodeSchemaIdentifier;\n\treadonly input: TreeNodeSchemaIdentifier;\n\n\t// TODO: include actual adapter functionality, not just what types it converts\n}\n\n/**\n * Minimal selection of adapters (nothing for general out of schema, field level adjustments etc.).\n * Would be used with schematize and have actual conversion/update functionality.\n *\n * TODO: Support more kinds of adapters\n * TODO: support efficient lookup of adapters\n */\nexport interface Adapters {\n\treadonly tree?: readonly TreeAdapter[];\n}\n\n/**\n * A collection of View information for schema, including policy.\n */\nexport class AdaptedViewSchema {\n\tpublic constructor(\n\t\tpublic readonly adapters: Adapters,\n\t\tpublic readonly adaptedForViewSchema: TreeStoredSchema,\n\t) {}\n}\n"]}

package/lib/feature-libraries/default-schema/locationBasedEditBuilder.d.ts

@@ -1,40 +0,0 @@
-/*!
- * Copyright (c) Microsoft Corporation and contributors. All rights reserved.
- * Licensed under the MIT License.
- */
-import { type ChangeAtomId, type FieldKey, type FieldUpPath, type UpPath, type TreeChunk, type EditorOptions } from "../../core/index.js";
-import type { DetachedRootIds, DataEditor, OptionalFieldEditor, RequiredFieldEditor, SequenceFieldEditor } from "./defaultEditBuilder.js";
-export type DetachedRootLocation = FieldKey;
-export type DetachedRootsLocation = readonly DetachedRootRangeLocation[];
-export interface DetachedRootRangeLocation {
-    readonly field: FieldKey;
-    readonly count: number;
-}
-export interface Locator {
-    locationFromId(id: ChangeAtomId): DetachedRootLocation;
-    idFromLocation(id: DetachedRootLocation): ChangeAtomId;
-    locationsFromIdRanges(id: DetachedRootIds): DetachedRootsLocation;
-    idRangesFromLocations(id: DetachedRootsLocation): DetachedRootIds;
-    isAttachable(id: ChangeAtomId): boolean | undefined;
-}
-export type ILocationBasedDataEditor = DataEditor<TreeChunk, DetachedRootLocation, DetachedRootsLocation>;
-/**
- * Implementation of {@link DataEditor} based on the default set of supported field kinds.
- * @sealed
- */
-export declare class LocationBasedDataEditor implements DataEditor<TreeChunk, DetachedRootLocation, DetachedRootsLocation> {
-    private readonly idBasedEditor;
-    private readonly locator;
-    private readonly options;
-    constructor(idBasedEditor: DataEditor<TreeChunk, ChangeAtomId, DetachedRootIds>, locator: Locator, options: EditorOptions);
-    addNodeExistsConstraint(path: UpPath): void;
-    addNodeExistsConstraintOnRevert(path: UpPath): void;
-    addNoChangeConstraint(): void;
-    addNoChangeConstraintOnRevert(): void;
-    buildRoots(content: TreeChunk): DetachedRootsLocation;
-    valueField(field: FieldUpPath): RequiredFieldEditor<TreeChunk, DetachedRootLocation>;
-    optionalField(field: FieldUpPath): OptionalFieldEditor<TreeChunk, DetachedRootLocation>;
-    move(sourceField: FieldUpPath, sourceIndex: number, count: number, destinationField: FieldUpPath, destIndex: number): void;
-    sequenceField(field: FieldUpPath): SequenceFieldEditor<TreeChunk, DetachedRootsLocation>;
-}
-//# sourceMappingURL=locationBasedEditBuilder.d.ts.map

package/lib/feature-libraries/default-schema/locationBasedEditBuilder.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"locationBasedEditBuilder.d.ts","sourceRoot":"","sources":["../../../src/feature-libraries/default-schema/locationBasedEditBuilder.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,EACN,KAAK,YAAY,EACjB,KAAK,QAAQ,EACb,KAAK,WAAW,EAChB,KAAK,MAAM,EACX,KAAK,SAAS,EAMd,KAAK,aAAa,EAClB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,KAAK,EACX,eAAe,EACf,UAAU,EACV,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACnB,MAAM,yBAAyB,CAAC;AAEjC,MAAM,MAAM,oBAAoB,GAAG,QAAQ,CAAC;AAC5C,MAAM,MAAM,qBAAqB,GAAG,SAAS,yBAAyB,EAAE,CAAC;AACzE,MAAM,WAAW,yBAAyB;IACzC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,OAAO;IACvB,cAAc,CAAC,EAAE,EAAE,YAAY,GAAG,oBAAoB,CAAC;IACvD,cAAc,CAAC,EAAE,EAAE,oBAAoB,GAAG,YAAY,CAAC;IACvD,qBAAqB,CAAC,EAAE,EAAE,eAAe,GAAG,qBAAqB,CAAC;IAClE,qBAAqB,CAAC,EAAE,EAAE,qBAAqB,GAAG,eAAe,CAAC;IAClE,YAAY,CAAC,EAAE,EAAE,YAAY,GAAG,OAAO,GAAG,SAAS,CAAC;CACpD;AAED,MAAM,MAAM,wBAAwB,GAAG,UAAU,CAChD,SAAS,EACT,oBAAoB,EACpB,qBAAqB,CACrB,CAAC;AAEF;;;GAGG;AACH,qBAAa,uBACZ,YAAW,UAAU,CAAC,SAAS,EAAE,oBAAoB,EAAE,qBAAqB,CAAC;IAG5E,OAAO,CAAC,QAAQ,CAAC,aAAa;IAC9B,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAFP,aAAa,EAAE,UAAU,CAAC,SAAS,EAAE,YAAY,EAAE,eAAe,CAAC,EACnE,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,aAAa;IAGjC,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAK3C,+BAA+B,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAKnD,qBAAqB,IAAI,IAAI;IAI7B,6BAA6B,IAAI,IAAI;IAIrC,UAAU,CAAC,OAAO,EAAE,SAAS,GAAG,qBAAqB;IAMrD,UAAU,CAAC,KAAK,EAAE,WAAW,GAAG,mBAAmB,CAAC,SAAS,EAAE,oBAAoB,CAAC;IAiBpF,aAAa,CACnB,KAAK,EAAE,WAAW,GAChB,mBAAmB,CAAC,SAAS,EAAE,oBAAoB,CAAC;IAwBhD,IAAI,CACV,WAAW,EAAE,WAAW,EACxB,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,MAAM,EACb,gBAAgB,EAAE,WAAW,EAC7B,SAAS,EAAE,MAAM,GACf,IAAI;IAUA,aAAa,CACnB,KAAK,EAAE,WAAW,GAChB,mBAAmB,CAAC,SAAS,EAAE,qBAAqB,CAAC;CAmBxD"}

package/lib/feature-libraries/default-schema/locationBasedEditBuilder.js

@@ -1,149 +0,0 @@
-/*!
- * Copyright (c) Microsoft Corporation and contributors. All rights reserved.
- * Licensed under the MIT License.
- */
-import { UsageError } from "@fluidframework/telemetry-utils/internal";
-import { rootFieldKey, makeDetachedNodeId, offsetChangeAtomId, } from "../../core/index.js";
-/**
- * Implementation of {@link DataEditor} based on the default set of supported field kinds.
- * @sealed
- */
-export class LocationBasedDataEditor {
-    constructor(idBasedEditor, locator, options) {
-        this.idBasedEditor = idBasedEditor;
-        this.locator = locator;
-        this.options = options;
-    }
-    addNodeExistsConstraint(path) {
-        const normal = normalizeUpPath(path, this.locator, this.options);
-        this.idBasedEditor.addNodeExistsConstraint(normal);
-    }
-    addNodeExistsConstraintOnRevert(path) {
-        const normal = normalizeUpPath(path, this.locator, this.options);
-        this.idBasedEditor.addNodeExistsConstraintOnRevert(normal);
-    }
-    addNoChangeConstraint() {
-        this.idBasedEditor.addNoChangeConstraint();
-    }
-    addNoChangeConstraintOnRevert() {
-        this.idBasedEditor.addNoChangeConstraintOnRevert();
-    }
-    buildRoots(content) {
-        const roots = this.idBasedEditor.buildRoots(content);
-        const locations = this.locator.locationsFromIdRanges(roots);
-        return locations;
-    }
-    valueField(field) {
-        const normal = normalizeFieldUpPath(field, this.locator, this.options);
-        const lowLevelEditor = this.idBasedEditor.valueField(normal);
-        const locator = this.locator;
-        const editBuilder = {
-            set: (newContent) => {
-                lowLevelEditor.set(newContent);
-            },
-            attach: (newContent) => {
-                const changeAtom = locator.idFromLocation(newContent);
-                validateIsAttachable(changeAtom, locator);
-                lowLevelEditor.attach(changeAtom);
-            },
-        };
-        return editBuilder;
-    }
-    optionalField(field) {
-        const normal = normalizeFieldUpPath(field, this.locator, this.options);
-        const lowLevelEditor = this.idBasedEditor.optionalField(normal);
-        const locator = this.locator;
-        const editBuilder = {
-            set: (newContent, wasEmpty) => {
-                lowLevelEditor.set(newContent, wasEmpty);
-            },
-            attach: (newContent, wasEmpty) => {
-                if (newContent === undefined) {
-                    editBuilder.clear(wasEmpty);
-                    return;
-                }
-                const changeAtom = locator.idFromLocation(newContent);
-                validateIsAttachable(changeAtom, locator);
-                lowLevelEditor.attach(changeAtom, wasEmpty);
-            },
-            clear: (wasEmpty) => {
-                lowLevelEditor.clear(wasEmpty);
-            },
-        };
-        return editBuilder;
-    }
-    move(sourceField, sourceIndex, count, destinationField, destIndex) {
-        const normalSource = normalizeFieldUpPath(sourceField, this.locator, this.options);
-        const normalDestination = normalizeFieldUpPath(destinationField, this.locator, this.options);
-        this.idBasedEditor.move(normalSource, sourceIndex, count, normalDestination, destIndex);
-    }
-    sequenceField(field) {
-        const normal = normalizeFieldUpPath(field, this.locator, this.options);
-        const lowLevelEditor = this.idBasedEditor.sequenceField(normal);
-        const locator = this.locator;
-        const editBuilder = {
-            insert: (index, content) => {
-                lowLevelEditor.insert(index, content);
-            },
-            attach: (index, newContent) => {
-                const range = locator.idRangesFromLocations(newContent);
-                validateAreAttachable(range, locator);
-                lowLevelEditor.attach(index, range);
-            },
-            remove: (index, count) => {
-                lowLevelEditor.remove(index, count);
-            },
-        };
-        return editBuilder;
-    }
-}
-function normalizeUpPath(path, locator, options) {
-    if (path.parent === undefined) {
-        if (path.parentField === rootFieldKey) {
-            return { ...path, parent: undefined, detachedNodeId: undefined };
-        }
-        else {
-            if (options.enableDetachedRootEditing !== true) {
-                throw new UsageError(`Edits and constraints on detached trees require a minimum version for collaboration >= TBD.`);
-            }
-            const nodeId = locator.idFromLocation(path.parentField);
-            const detachedNodeId = makeDetachedNodeId(nodeId.revision, nodeId.localId);
-            return { ...path, parent: undefined, detachedNodeId };
-        }
-    }
-    else {
-        return {
-            parent: normalizeUpPath(path.parent, locator, options),
-            parentField: path.parentField,
-            parentIndex: path.parentIndex,
-        };
-    }
-}
-function normalizeFieldUpPath(path, locator, options) {
-    if (path.parent === undefined) {
-        if (path.field === rootFieldKey) {
-            return { parent: undefined, field: rootFieldKey };
-        }
-        else {
-            throw new UsageError("Editing only allowed on the root field or on fields under nodes with TreeStatus.InDocument or TreeStatus.Removed status");
-        }
-    }
-    else {
-        return { parent: normalizeUpPath(path.parent, locator, options), field: path.field };
-    }
-}
-function validateAreAttachable(nodeIds, locator) {
-    for (const idRange of nodeIds) {
-        const baseAtom = idRange.first;
-        for (let idOffset = 0; idOffset < idRange.count; idOffset++) {
-            validateIsAttachable(offsetChangeAtomId(baseAtom, idOffset), locator);
-        }
-    }
-}
-function validateIsAttachable(nodeId, locator) {
-    const isAttachable = locator.isAttachable(nodeId);
-    if (!(isAttachable ?? false)) {
-        throw new UsageError(`Nodes that may have been detached from a required field can only be re-attached by reverting the detach.`);
-    }
-}
-//# sourceMappingURL=locationBasedEditBuilder.js.map

package/lib/feature-libraries/default-schema/locationBasedEditBuilder.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"locationBasedEditBuilder.js","sourceRoot":"","sources":["../../../src/feature-libraries/default-schema/locationBasedEditBuilder.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,0CAA0C,CAAC;AAEtE,OAAO,EAQN,YAAY,EACZ,kBAAkB,EAClB,kBAAkB,GAElB,MAAM,qBAAqB,CAAC;AA+B7B;;;GAGG;AACH,MAAM,OAAO,uBAAuB;IAGnC,YACkB,aAAmE,EACnE,OAAgB,EAChB,OAAsB;QAFtB,kBAAa,GAAb,aAAa,CAAsD;QACnE,YAAO,GAAP,OAAO,CAAS;QAChB,YAAO,GAAP,OAAO,CAAe;IACrC,CAAC;IAEG,uBAAuB,CAAC,IAAY;QAC1C,MAAM,MAAM,GAAG,eAAe,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QACjE,IAAI,CAAC,aAAa,CAAC,uBAAuB,CAAC,MAAM,CAAC,CAAC;IACpD,CAAC;IAEM,+BAA+B,CAAC,IAAY;QAClD,MAAM,MAAM,GAAG,eAAe,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QACjE,IAAI,CAAC,aAAa,CAAC,+BAA+B,CAAC,MAAM,CAAC,CAAC;IAC5D,CAAC;IAEM,qBAAqB;QAC3B,IAAI,CAAC,aAAa,CAAC,qBAAqB,EAAE,CAAC;IAC5C,CAAC;IAEM,6BAA6B;QACnC,IAAI,CAAC,aAAa,CAAC,6BAA6B,EAAE,CAAC;IACpD,CAAC;IAEM,UAAU,CAAC,OAAkB;QACnC,MAAM,KAAK,GAAG,IAAI,CAAC,aAAa,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;QACrD,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,qBAAqB,CAAC,KAAK,CAAC,CAAC;QAC5D,OAAO,SAAS,CAAC;IAClB,CAAC;IAEM,UAAU,CAAC,KAAkB;QACnC,MAAM,MAAM,GAAG,oBAAoB,CAAC,KAAK,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QACvE,MAAM,cAAc,GAAG,IAAI,CAAC,aAAa,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QAC7D,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;QAC7B,MAAM,WAAW,GAAG;YACnB,GAAG,EAAE,CAAC,UAAqB,EAAQ,EAAE;gBACpC,cAAc,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;YAChC,CAAC;YACD,MAAM,EAAE,CAAC,UAAgC,EAAQ,EAAE;gBAClD,MAAM,UAAU,GAAG,OAAO,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC;gBACtD,oBAAoB,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;gBAC1C,cAAc,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;YACnC,CAAC;SACD,CAAC;QACF,OAAO,WAAW,CAAC;IACpB,CAAC;IAEM,aAAa,CACnB,KAAkB;QAElB,MAAM,MAAM,GAAG,oBAAoB,CAAC,KAAK,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QACvE,MAAM,cAAc,GAAG,IAAI,CAAC,aAAa,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;QAChE,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;QAC7B,MAAM,WAAW,GAAG;YACnB,GAAG,EAAE,CAAC,UAAiC,EAAE,QAAiB,EAAQ,EAAE;gBACnE,cAAc,CAAC,GAAG,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;YAC1C,CAAC;YACD,MAAM,EAAE,CAAC,UAA4C,EAAE,QAAiB,EAAQ,EAAE;gBACjF,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;oBAC9B,WAAW,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;oBAC5B,OAAO;gBACR,CAAC;gBACD,MAAM,UAAU,GAAG,OAAO,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC;gBACtD,oBAAoB,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;gBAC1C,cAAc,CAAC,MAAM,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;YAC7C,CAAC;YACD,KAAK,EAAE,CAAC,QAAiB,EAAQ,EAAE;gBAClC,cAAc,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;YAChC,CAAC;SACD,CAAC;QACF,OAAO,WAAW,CAAC;IACpB,CAAC;IAEM,IAAI,CACV,WAAwB,EACxB,WAAmB,EACnB,KAAa,EACb,gBAA6B,EAC7B,SAAiB;QAEjB,MAAM,YAAY,GAAG,oBAAoB,CAAC,WAAW,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QACnF,MAAM,iBAAiB,GAAG,oBAAoB,CAC7C,gBAAgB,EAChB,IAAI,CAAC,OAAO,EACZ,IAAI,CAAC,OAAO,CACZ,CAAC;QACF,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,YAAY,EAAE,WAAW,EAAE,KAAK,EAAE,iBAAiB,EAAE,SAAS,CAAC,CAAC;IACzF,CAAC;IAEM,aAAa,CACnB,KAAkB;QAElB,MAAM,MAAM,GAAG,oBAAoB,CAAC,KAAK,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QACvE,MAAM,cAAc,GAAG,IAAI,CAAC,aAAa,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;QAChE,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;QAC7B,MAAM,WAAW,GAAG;YACnB,MAAM,EAAE,CAAC,KAAa,EAAE,OAAkB,EAAQ,EAAE;gBACnD,cAAc,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;YACvC,CAAC;YACD,MAAM,EAAE,CAAC,KAAa,EAAE,UAAiC,EAAQ,EAAE;gBAClE,MAAM,KAAK,GAAG,OAAO,CAAC,qBAAqB,CAAC,UAAU,CAAC,CAAC;gBACxD,qBAAqB,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;gBACtC,cAAc,CAAC,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;YACrC,CAAC;YACD,MAAM,EAAE,CAAC,KAAa,EAAE,KAAa,EAAQ,EAAE;gBAC9C,cAAc,CAAC,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;YACrC,CAAC;SACD,CAAC;QACF,OAAO,WAAW,CAAC;IACpB,CAAC;CACD;AAED,SAAS,eAAe,CACvB,IAAY,EACZ,OAAgB,EAChB,OAAsB;IAEtB,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAC/B,IAAI,IAAI,CAAC,WAAW,KAAK,YAAY,EAAE,CAAC;YACvC,OAAO,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,cAAc,EAAE,SAAS,EAAE,CAAC;QAClE,CAAC;aAAM,CAAC;YACP,IAAI,OAAO,CAAC,yBAAyB,KAAK,IAAI,EAAE,CAAC;gBAChD,MAAM,IAAI,UAAU,CACnB,6FAA6F,CAC7F,CAAC;YACH,CAAC;YACD,MAAM,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YACxD,MAAM,cAAc,GAAG,kBAAkB,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;YAC3E,OAAO,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,cAAc,EAAE,CAAC;QACvD,CAAC;IACF,CAAC;SAAM,CAAC;QACP,OAAO;YACN,MAAM,EAAE,eAAe,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC;YACtD,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,WAAW,EAAE,IAAI,CAAC,WAAW;SAC7B,CAAC;IACH,CAAC;AACF,CAAC;AAED,SAAS,oBAAoB,CAC5B,IAAiB,EACjB,OAAgB,EAChB,OAAsB;IAEtB,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAC/B,IAAI,IAAI,CAAC,KAAK,KAAK,YAAY,EAAE,CAAC;YACjC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC;QACnD,CAAC;aAAM,CAAC;YACP,MAAM,IAAI,UAAU,CACnB,yHAAyH,CACzH,CAAC;QACH,CAAC;IACF,CAAC;SAAM,CAAC;QACP,OAAO,EAAE,MAAM,EAAE,eAAe,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC;IACtF,CAAC;AACF,CAAC;AAED,SAAS,qBAAqB,CAAC,OAAwB,EAAE,OAAgB;IACxE,KAAK,MAAM,OAAO,IAAI,OAAO,EAAE,CAAC;QAC/B,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC;QAC/B,KAAK,IAAI,QAAQ,GAAG,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,CAAC;YAC7D,oBAAoB,CAAC,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,CAAC,EAAE,OAAO,CAAC,CAAC;QACvE,CAAC;IACF,CAAC;AACF,CAAC;AAED,SAAS,oBAAoB,CAAC,MAAoB,EAAE,OAAgB;IACnE,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;IAClD,IAAI,CAAC,CAAC,YAAY,IAAI,KAAK,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,UAAU,CACnB,0GAA0G,CAC1G,CAAC;IACH,CAAC;AACF,CAAC","sourcesContent":["/*!\n * Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n */\n\nimport { UsageError } from \"@fluidframework/telemetry-utils/internal\";\n\nimport {\n\ttype ChangeAtomId,\n\ttype FieldKey,\n\ttype FieldUpPath,\n\ttype UpPath,\n\ttype TreeChunk,\n\ttype NormalizedUpPath,\n\ttype NormalizedFieldUpPath,\n\trootFieldKey,\n\tmakeDetachedNodeId,\n\toffsetChangeAtomId,\n\ttype EditorOptions,\n} from \"../../core/index.js\";\n\nimport type {\n\tDetachedRootIds,\n\tDataEditor,\n\tOptionalFieldEditor,\n\tRequiredFieldEditor,\n\tSequenceFieldEditor,\n} from \"./defaultEditBuilder.js\";\n\nexport type DetachedRootLocation = FieldKey;\nexport type DetachedRootsLocation = readonly DetachedRootRangeLocation[];\nexport interface DetachedRootRangeLocation {\n\treadonly field: FieldKey;\n\treadonly count: number;\n}\n\nexport interface Locator {\n\tlocationFromId(id: ChangeAtomId): DetachedRootLocation;\n\tidFromLocation(id: DetachedRootLocation): ChangeAtomId;\n\tlocationsFromIdRanges(id: DetachedRootIds): DetachedRootsLocation;\n\tidRangesFromLocations(id: DetachedRootsLocation): DetachedRootIds;\n\tisAttachable(id: ChangeAtomId): boolean | undefined;\n}\n\nexport type ILocationBasedDataEditor = DataEditor<\n\tTreeChunk,\n\tDetachedRootLocation,\n\tDetachedRootsLocation\n>;\n\n/**\n * Implementation of {@link DataEditor} based on the default set of supported field kinds.\n * @sealed\n */\nexport class LocationBasedDataEditor\n\timplements DataEditor<TreeChunk, DetachedRootLocation, DetachedRootsLocation>\n{\n\tpublic constructor(\n\t\tprivate readonly idBasedEditor: DataEditor<TreeChunk, ChangeAtomId, DetachedRootIds>,\n\t\tprivate readonly locator: Locator,\n\t\tprivate readonly options: EditorOptions,\n\t) {}\n\n\tpublic addNodeExistsConstraint(path: UpPath): void {\n\t\tconst normal = normalizeUpPath(path, this.locator, this.options);\n\t\tthis.idBasedEditor.addNodeExistsConstraint(normal);\n\t}\n\n\tpublic addNodeExistsConstraintOnRevert(path: UpPath): void {\n\t\tconst normal = normalizeUpPath(path, this.locator, this.options);\n\t\tthis.idBasedEditor.addNodeExistsConstraintOnRevert(normal);\n\t}\n\n\tpublic addNoChangeConstraint(): void {\n\t\tthis.idBasedEditor.addNoChangeConstraint();\n\t}\n\n\tpublic addNoChangeConstraintOnRevert(): void {\n\t\tthis.idBasedEditor.addNoChangeConstraintOnRevert();\n\t}\n\n\tpublic buildRoots(content: TreeChunk): DetachedRootsLocation {\n\t\tconst roots = this.idBasedEditor.buildRoots(content);\n\t\tconst locations = this.locator.locationsFromIdRanges(roots);\n\t\treturn locations;\n\t}\n\n\tpublic valueField(field: FieldUpPath): RequiredFieldEditor<TreeChunk, DetachedRootLocation> {\n\t\tconst normal = normalizeFieldUpPath(field, this.locator, this.options);\n\t\tconst lowLevelEditor = this.idBasedEditor.valueField(normal);\n\t\tconst locator = this.locator;\n\t\tconst editBuilder = {\n\t\t\tset: (newContent: TreeChunk): void => {\n\t\t\t\tlowLevelEditor.set(newContent);\n\t\t\t},\n\t\t\tattach: (newContent: DetachedRootLocation): void => {\n\t\t\t\tconst changeAtom = locator.idFromLocation(newContent);\n\t\t\t\tvalidateIsAttachable(changeAtom, locator);\n\t\t\t\tlowLevelEditor.attach(changeAtom);\n\t\t\t},\n\t\t};\n\t\treturn editBuilder;\n\t}\n\n\tpublic optionalField(\n\t\tfield: FieldUpPath,\n\t): OptionalFieldEditor<TreeChunk, DetachedRootLocation> {\n\t\tconst normal = normalizeFieldUpPath(field, this.locator, this.options);\n\t\tconst lowLevelEditor = this.idBasedEditor.optionalField(normal);\n\t\tconst locator = this.locator;\n\t\tconst editBuilder = {\n\t\t\tset: (newContent: TreeChunk | undefined, wasEmpty: boolean): void => {\n\t\t\t\tlowLevelEditor.set(newContent, wasEmpty);\n\t\t\t},\n\t\t\tattach: (newContent: DetachedRootLocation | undefined, wasEmpty: boolean): void => {\n\t\t\t\tif (newContent === undefined) {\n\t\t\t\t\teditBuilder.clear(wasEmpty);\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t\tconst changeAtom = locator.idFromLocation(newContent);\n\t\t\t\tvalidateIsAttachable(changeAtom, locator);\n\t\t\t\tlowLevelEditor.attach(changeAtom, wasEmpty);\n\t\t\t},\n\t\t\tclear: (wasEmpty: boolean): void => {\n\t\t\t\tlowLevelEditor.clear(wasEmpty);\n\t\t\t},\n\t\t};\n\t\treturn editBuilder;\n\t}\n\n\tpublic move(\n\t\tsourceField: FieldUpPath,\n\t\tsourceIndex: number,\n\t\tcount: number,\n\t\tdestinationField: FieldUpPath,\n\t\tdestIndex: number,\n\t): void {\n\t\tconst normalSource = normalizeFieldUpPath(sourceField, this.locator, this.options);\n\t\tconst normalDestination = normalizeFieldUpPath(\n\t\t\tdestinationField,\n\t\t\tthis.locator,\n\t\t\tthis.options,\n\t\t);\n\t\tthis.idBasedEditor.move(normalSource, sourceIndex, count, normalDestination, destIndex);\n\t}\n\n\tpublic sequenceField(\n\t\tfield: FieldUpPath,\n\t): SequenceFieldEditor<TreeChunk, DetachedRootsLocation> {\n\t\tconst normal = normalizeFieldUpPath(field, this.locator, this.options);\n\t\tconst lowLevelEditor = this.idBasedEditor.sequenceField(normal);\n\t\tconst locator = this.locator;\n\t\tconst editBuilder = {\n\t\t\tinsert: (index: number, content: TreeChunk): void => {\n\t\t\t\tlowLevelEditor.insert(index, content);\n\t\t\t},\n\t\t\tattach: (index: number, newContent: DetachedRootsLocation): void => {\n\t\t\t\tconst range = locator.idRangesFromLocations(newContent);\n\t\t\t\tvalidateAreAttachable(range, locator);\n\t\t\t\tlowLevelEditor.attach(index, range);\n\t\t\t},\n\t\t\tremove: (index: number, count: number): void => {\n\t\t\t\tlowLevelEditor.remove(index, count);\n\t\t\t},\n\t\t};\n\t\treturn editBuilder;\n\t}\n}\n\nfunction normalizeUpPath(\n\tpath: UpPath,\n\tlocator: Locator,\n\toptions: EditorOptions,\n): NormalizedUpPath {\n\tif (path.parent === undefined) {\n\t\tif (path.parentField === rootFieldKey) {\n\t\t\treturn { ...path, parent: undefined, detachedNodeId: undefined };\n\t\t} else {\n\t\t\tif (options.enableDetachedRootEditing !== true) {\n\t\t\t\tthrow new UsageError(\n\t\t\t\t\t`Edits and constraints on detached trees require a minimum version for collaboration >= TBD.`,\n\t\t\t\t);\n\t\t\t}\n\t\t\tconst nodeId = locator.idFromLocation(path.parentField);\n\t\t\tconst detachedNodeId = makeDetachedNodeId(nodeId.revision, nodeId.localId);\n\t\t\treturn { ...path, parent: undefined, detachedNodeId };\n\t\t}\n\t} else {\n\t\treturn {\n\t\t\tparent: normalizeUpPath(path.parent, locator, options),\n\t\t\tparentField: path.parentField,\n\t\t\tparentIndex: path.parentIndex,\n\t\t};\n\t}\n}\n\nfunction normalizeFieldUpPath(\n\tpath: FieldUpPath,\n\tlocator: Locator,\n\toptions: EditorOptions,\n): NormalizedFieldUpPath {\n\tif (path.parent === undefined) {\n\t\tif (path.field === rootFieldKey) {\n\t\t\treturn { parent: undefined, field: rootFieldKey };\n\t\t} else {\n\t\t\tthrow new UsageError(\n\t\t\t\t\"Editing only allowed on the root field or on fields under nodes with TreeStatus.InDocument or TreeStatus.Removed status\",\n\t\t\t);\n\t\t}\n\t} else {\n\t\treturn { parent: normalizeUpPath(path.parent, locator, options), field: path.field };\n\t}\n}\n\nfunction validateAreAttachable(nodeIds: DetachedRootIds, locator: Locator): void {\n\tfor (const idRange of nodeIds) {\n\t\tconst baseAtom = idRange.first;\n\t\tfor (let idOffset = 0; idOffset < idRange.count; idOffset++) {\n\t\t\tvalidateIsAttachable(offsetChangeAtomId(baseAtom, idOffset), locator);\n\t\t}\n\t}\n}\n\nfunction validateIsAttachable(nodeId: ChangeAtomId, locator: Locator): void {\n\tconst isAttachable = locator.isAttachable(nodeId);\n\tif (!(isAttachable ?? false)) {\n\t\tthrow new UsageError(\n\t\t\t`Nodes that may have been detached from a required field can only be re-attached by reverting the detach.`,\n\t\t);\n\t}\n}\n"]}

package/lib/feature-libraries/forest-summary/formatV1.d.ts

@@ -1,12 +0,0 @@
-/*!
- * Copyright (c) Microsoft Corporation and contributors. All rights reserved.
- * Licensed under the MIT License.
- */
-import type { Static } from "@sinclair/typebox";
-export declare const FormatV1: import("@sinclair/typebox").TObject<{
-    version: import("@sinclair/typebox").TLiteral<import("../../util/brand.js").Brand<1, "ForestFormatVersion">>;
-    keys: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TUnsafe<import("../../core/index.js").FieldKey>>;
-    fields: import("@sinclair/typebox").TUnsafe<import("../../index.js").JsonCompatibleReadOnly>;
-}>;
-export type FormatV1 = Static<typeof FormatV1>;
-//# sourceMappingURL=formatV1.d.ts.map

package/lib/feature-libraries/forest-summary/formatV1.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"formatV1.d.ts","sourceRoot":"","sources":["../../../src/feature-libraries/forest-summary/formatV1.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAIhD,eAAO,MAAM,QAAQ;;;;EAAuC,CAAC;AAC7D,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,QAAQ,CAAC,CAAC"}

package/lib/feature-libraries/forest-summary/formatV1.js

@@ -1,7 +0,0 @@
-/*!
- * Copyright (c) Microsoft Corporation and contributors. All rights reserved.
- * Licensed under the MIT License.
- */
-import { FormatCommon, ForestFormatVersion } from "./formatCommon.js";
-export const FormatV1 = FormatCommon(ForestFormatVersion.v1);
-//# sourceMappingURL=formatV1.js.map

package/lib/feature-libraries/forest-summary/formatV1.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"formatV1.js","sourceRoot":"","sources":["../../../src/feature-libraries/forest-summary/formatV1.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAEtE,MAAM,CAAC,MAAM,QAAQ,GAAG,YAAY,CAAC,mBAAmB,CAAC,EAAE,CAAC,CAAC","sourcesContent":["/*!\n * Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n */\n\nimport type { Static } from \"@sinclair/typebox\";\n\nimport { FormatCommon, ForestFormatVersion } from \"./formatCommon.js\";\n\nexport const FormatV1 = FormatCommon(ForestFormatVersion.v1);\nexport type FormatV1 = Static<typeof FormatV1>;\n"]}

package/lib/feature-libraries/forest-summary/formatV2.d.ts

@@ -1,12 +0,0 @@
-/*!
- * Copyright (c) Microsoft Corporation and contributors. All rights reserved.
- * Licensed under the MIT License.
- */
-import type { Static } from "@sinclair/typebox";
-export declare const FormatV2: import("@sinclair/typebox").TObject<{
-    version: import("@sinclair/typebox").TLiteral<import("../../util/brand.js").Brand<2, "ForestFormatVersion">>;
-    keys: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TUnsafe<import("../../core/index.js").FieldKey>>;
-    fields: import("@sinclair/typebox").TUnsafe<import("../../index.js").JsonCompatibleReadOnly>;
-}>;
-export type FormatV2 = Static<typeof FormatV2>;
-//# sourceMappingURL=formatV2.d.ts.map

package/lib/feature-libraries/forest-summary/formatV2.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"formatV2.d.ts","sourceRoot":"","sources":["../../../src/feature-libraries/forest-summary/formatV2.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAIhD,eAAO,MAAM,QAAQ;;;;EAAuC,CAAC;AAC7D,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,QAAQ,CAAC,CAAC"}

package/lib/feature-libraries/forest-summary/formatV2.js

@@ -1,7 +0,0 @@
-/*!
- * Copyright (c) Microsoft Corporation and contributors. All rights reserved.
- * Licensed under the MIT License.
- */
-import { FormatCommon, ForestFormatVersion } from "./formatCommon.js";
-export const FormatV2 = FormatCommon(ForestFormatVersion.v2);
-//# sourceMappingURL=formatV2.js.map

package/lib/feature-libraries/forest-summary/formatV2.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"formatV2.js","sourceRoot":"","sources":["../../../src/feature-libraries/forest-summary/formatV2.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAEtE,MAAM,CAAC,MAAM,QAAQ,GAAG,YAAY,CAAC,mBAAmB,CAAC,EAAE,CAAC,CAAC","sourcesContent":["/*!\n * Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n */\n\nimport type { Static } from \"@sinclair/typebox\";\n\nimport { FormatCommon, ForestFormatVersion } from \"./formatCommon.js\";\n\nexport const FormatV2 = FormatCommon(ForestFormatVersion.v2);\nexport type FormatV2 = Static<typeof FormatV2>;\n"]}