@fluidframework/tree 2.0.0-rc.2.0.2 → 2.0.0-rc.3.0.0

package/lib/public.d.ts

@@ -0,0 +1,90 @@
+/*!
+ * 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 @fluidframework/build-tools.
+ */
+
+export {
+	// public APIs
+	AllowedTypes, 
+	ApplyKind, 
+	CommitKind, 
+	CommitMetadata, 
+	Events, 
+	ExtractItemType, 
+	FieldKind, 
+	FieldProps, 
+	FieldSchema, 
+	FieldSchemaUnsafe, 
+	FlexList, 
+	FlexListToUnion, 
+	IDisposable, 
+	ISubscribable, 
+	ITree, 
+	ImplicitAllowedTypes, 
+	ImplicitFieldSchema, 
+	InsertableObjectFromSchemaRecord, 
+	InsertableObjectFromSchemaRecordUnsafe, 
+	InsertableTreeFieldFromImplicitField, 
+	InsertableTreeFieldFromImplicitFieldUnsafe, 
+	InsertableTreeNodeFromImplicitAllowedTypes, 
+	InsertableTreeNodeFromImplicitAllowedTypesUnsafe, 
+	InsertableTypedNode, 
+	InsertableTypedNodeUnsafe, 
+	IsEvent, 
+	IterableTreeArrayContent, 
+	LazyItem, 
+	MakeNominal, 
+	NodeBuilderData, 
+	NodeBuilderDataUnsafe, 
+	NodeFromSchema, 
+	NodeFromSchemaUnsafe, 
+	NodeInDocumentConstraint, 
+	NodeKind, 
+	ObjectFromSchemaRecord, 
+	ObjectFromSchemaRecordUnsafe, 
+	RestrictiveReadonlyRecord, 
+	Revertible, 
+	RevertibleFactory, 
+	RevertibleStatus, 
+	SchemaFactory, 
+	SchemaIncompatible, 
+	ScopedSchemaName, 
+	SharedTree, 
+	TransactionConstraint, 
+	Tree, 
+	TreeApi, 
+	TreeArrayNode, 
+	TreeArrayNodeBase, 
+	TreeArrayNodeUnsafe, 
+	TreeChangeEvents, 
+	TreeConfiguration, 
+	TreeFieldFromImplicitField, 
+	TreeFieldFromImplicitFieldUnsafe, 
+	TreeLeafValue, 
+	TreeMapNode, 
+	TreeMapNodeUnsafe, 
+	TreeNode, 
+	TreeNodeApi, 
+	TreeNodeFromImplicitAllowedTypes, 
+	TreeNodeFromImplicitAllowedTypesUnsafe, 
+	TreeNodeSchema, 
+	TreeNodeSchemaClass, 
+	TreeNodeSchemaCore, 
+	TreeNodeSchemaNonClass, 
+	TreeObjectNode, 
+	TreeObjectNodeUnsafe, 
+	TreeStatus, 
+	TreeView, 
+	TreeViewEvents, 
+	Unenforced, 
+	Unhydrated, 
+	ValidateRecursiveSchema, 
+	WithType, 
+	disposeSymbol, 
+	type
+} from "./index.js";

package/lib/shared-tree/index.d.ts

@@ -2,10 +2,10 @@
  * Copyright (c) Microsoft Corporation and contributors. All rights reserved.
  * Licensed under the MIT License.
  */
-export { ISharedTree, SharedTreeFactory, SharedTreeOptions, SharedTree, ForestType, SharedTreeContentSnapshot, } from "./sharedTree.js";
-export { createTreeCheckout, TreeCheckout, ITreeCheckout, runSynchronous, CheckoutEvents, ITransaction, ITreeCheckoutFork, } from "./treeCheckout.js";
+export { ISharedTree, SharedTreeFactory, SharedTreeOptions, SharedTree, ForestType, SharedTreeContentSnapshot, SharedTreeFormatOptions, SharedTreeFormatVersion, } from "./sharedTree.js";
+export { createTreeCheckout, TreeCheckout, ITreeCheckout, runSynchronous, CheckoutEvents, ITransaction, ITreeCheckoutFork, RevertibleFactory, } from "./treeCheckout.js";
 export { SchematizeConfiguration, TreeContent, InitializeAndSchematizeConfiguration, SchemaConfiguration, buildTreeConfiguration, } from "./schematizeTree.js";
 export { FlexTreeView, CheckoutFlexTreeView, ITreeViewFork } from "./treeView.js";
 export { ISharedTreeEditor, ISchemaEditor } from "./sharedTreeEditBuilder.js";
-export { treeApi as Tree, TreeApi } from "./treeApi.js";
+export { treeApi as Tree, TreeApi, TransactionConstraint, NodeInDocumentConstraint, } from "./treeApi.js";
 //# sourceMappingURL=index.d.ts.map

package/lib/shared-tree/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/shared-tree/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACN,WAAW,EACX,iBAAiB,EACjB,iBAAiB,EACjB,UAAU,EACV,UAAU,EACV,yBAAyB,GACzB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACN,kBAAkB,EAClB,YAAY,EACZ,aAAa,EACb,cAAc,EACd,cAAc,EACd,YAAY,EACZ,iBAAiB,GACjB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACN,uBAAuB,EACvB,WAAW,EACX,oCAAoC,EACpC,mBAAmB,EACnB,sBAAsB,GACtB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,YAAY,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAElF,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAE9E,OAAO,EAAE,OAAO,IAAI,IAAI,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/shared-tree/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACN,WAAW,EACX,iBAAiB,EACjB,iBAAiB,EACjB,UAAU,EACV,UAAU,EACV,yBAAyB,EACzB,uBAAuB,EACvB,uBAAuB,GACvB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACN,kBAAkB,EAClB,YAAY,EACZ,aAAa,EACb,cAAc,EACd,cAAc,EACd,YAAY,EACZ,iBAAiB,EACjB,iBAAiB,GACjB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACN,uBAAuB,EACvB,WAAW,EACX,oCAAoC,EACpC,mBAAmB,EACnB,sBAAsB,GACtB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,YAAY,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAElF,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAE9E,OAAO,EACN,OAAO,IAAI,IAAI,EACf,OAAO,EACP,qBAAqB,EACrB,wBAAwB,GACxB,MAAM,cAAc,CAAC"}

package/lib/shared-tree/index.js

@@ -2,9 +2,9 @@
  * Copyright (c) Microsoft Corporation and contributors. All rights reserved.
  * Licensed under the MIT License.
  */
-export { SharedTreeFactory, SharedTree, ForestType, } from "./sharedTree.js";
+export { SharedTreeFactory, SharedTree, ForestType, SharedTreeFormatVersion, } from "./sharedTree.js";
 export { createTreeCheckout, TreeCheckout, runSynchronous, } from "./treeCheckout.js";
 export { buildTreeConfiguration, } from "./schematizeTree.js";
 export { CheckoutFlexTreeView } from "./treeView.js";
-export { treeApi as Tree } from "./treeApi.js";
+export { treeApi as Tree, } from "./treeApi.js";
 //# sourceMappingURL=index.js.map

package/lib/shared-tree/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/shared-tree/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAEN,iBAAiB,EAEjB,UAAU,EACV,UAAU,GAEV,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACN,kBAAkB,EAClB,YAAY,EAEZ,cAAc,GAId,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAKN,sBAAsB,GACtB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAgB,oBAAoB,EAAiB,MAAM,eAAe,CAAC;AAIlF,OAAO,EAAE,OAAO,IAAI,IAAI,EAAW,MAAM,cAAc,CAAC","sourcesContent":["/*!\n * Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n */\n\nexport {\n\tISharedTree,\n\tSharedTreeFactory,\n\tSharedTreeOptions,\n\tSharedTree,\n\tForestType,\n\tSharedTreeContentSnapshot,\n} from \"./sharedTree.js\";\n\nexport {\n\tcreateTreeCheckout,\n\tTreeCheckout,\n\tITreeCheckout,\n\trunSynchronous,\n\tCheckoutEvents,\n\tITransaction,\n\tITreeCheckoutFork,\n} from \"./treeCheckout.js\";\n\nexport {\n\tSchematizeConfiguration,\n\tTreeContent,\n\tInitializeAndSchematizeConfiguration,\n\tSchemaConfiguration,\n\tbuildTreeConfiguration,\n} from \"./schematizeTree.js\";\n\nexport { FlexTreeView, CheckoutFlexTreeView, ITreeViewFork } from \"./treeView.js\";\n\nexport { ISharedTreeEditor, ISchemaEditor } from \"./sharedTreeEditBuilder.js\";\n\nexport { treeApi as Tree, TreeApi } from \"./treeApi.js\";\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/shared-tree/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAEN,iBAAiB,EAEjB,UAAU,EACV,UAAU,EAGV,uBAAuB,GACvB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACN,kBAAkB,EAClB,YAAY,EAEZ,cAAc,GAKd,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAKN,sBAAsB,GACtB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAgB,oBAAoB,EAAiB,MAAM,eAAe,CAAC;AAIlF,OAAO,EACN,OAAO,IAAI,IAAI,GAIf,MAAM,cAAc,CAAC","sourcesContent":["/*!\n * Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n */\n\nexport {\n\tISharedTree,\n\tSharedTreeFactory,\n\tSharedTreeOptions,\n\tSharedTree,\n\tForestType,\n\tSharedTreeContentSnapshot,\n\tSharedTreeFormatOptions,\n\tSharedTreeFormatVersion,\n} from \"./sharedTree.js\";\n\nexport {\n\tcreateTreeCheckout,\n\tTreeCheckout,\n\tITreeCheckout,\n\trunSynchronous,\n\tCheckoutEvents,\n\tITransaction,\n\tITreeCheckoutFork,\n\tRevertibleFactory,\n} from \"./treeCheckout.js\";\n\nexport {\n\tSchematizeConfiguration,\n\tTreeContent,\n\tInitializeAndSchematizeConfiguration,\n\tSchemaConfiguration,\n\tbuildTreeConfiguration,\n} from \"./schematizeTree.js\";\n\nexport { FlexTreeView, CheckoutFlexTreeView, ITreeViewFork } from \"./treeView.js\";\n\nexport { ISharedTreeEditor, ISchemaEditor } from \"./sharedTreeEditBuilder.js\";\n\nexport {\n\ttreeApi as Tree,\n\tTreeApi,\n\tTransactionConstraint,\n\tNodeInDocumentConstraint,\n} from \"./treeApi.js\";\n"]}

package/lib/shared-tree/schematizeTree.d.ts

@@ -3,7 +3,7 @@
  * Licensed under the MIT License.
  */
 import { AllowedUpdateType, ITreeCursorSynchronous } from "../core/index.js";
-import { FlexTreeSchema, FlexFieldSchema, ViewSchema, InsertableFlexField } from "../feature-libraries/index.js";
+import { FlexFieldSchema, FlexTreeSchema, InsertableFlexField, ViewSchema } from "../feature-libraries/index.js";
 import { ITreeCheckout } from "./treeCheckout.js";
 /**
  * Modify `storedSchema` and invoke `setInitialTree` when it's time to set the tree content.

package/lib/shared-tree/schematizeTree.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schematizeTree.d.ts","sourceRoot":"","sources":["../../src/shared-tree/schematizeTree.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EACN,iBAAiB,EAGjB,sBAAsB,EAGtB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAIN,cAAc,EACd,eAAe,EACf,UAAU,EACV,mBAAmB,EAGnB,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAElD;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAChC,gBAAgB,EAAE;IACjB,YAAY,EAAE,aAAa,CAAC,cAAc,CAAC,CAAC;IAC5C,YAAY,EAAE,aAAa,CAAC,cAAc,CAAC,CAAC;CAC5C,EACD,SAAS,EAAE,cAAc,EACzB,cAAc,EAAE,MAAM,IAAI,GACxB,IAAI,CAgDN;AAED,oBAAY,UAAU;IACrB;;OAEG;IACH,IAAI,IAAA;IACJ;;OAEG;IACH,UAAU,IAAA;IACV;;OAEG;IACH,gBAAgB,IAAA;IAChB;;OAEG;IACH,YAAY,IAAA;CACZ;AAED,wBAAgB,cAAc,CAC7B,UAAU,EAAE,UAAU,EACtB,0BAA0B,EAAE,iBAAiB,EAC7C,QAAQ,EAAE,aAAa,GACrB,UAAU,CA4BZ;AAED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,aAAa,GAAG,OAAO,CAG9D;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAC3B,UAAU,EAAE,UAAU,EACtB,0BAA0B,EAAE,iBAAiB,EAC7C,QAAQ,EAAE,aAAa,EACvB,WAAW,EAAE,WAAW,GAAG,SAAS,GAClC,OAAO,CAgET;AAED;;;;GAIG;AACH,MAAM,WAAW,mBAAmB,CAAC,KAAK,SAAS,eAAe,GAAG,eAAe;IACnF;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC,KAAK,CAAC,CAAC;CACvC;AAED;;;;GAIG;AACH,MAAM,WAAW,WAAW,CAAC,KAAK,SAAS,eAAe,GAAG,eAAe,CAC3E,SAAQ,mBAAmB,CAAC,KAAK,CAAC;IAClC;;;OAGG;IACH,QAAQ,CAAC,WAAW,EACjB,mBAAmB,CAAC,KAAK,CAAC,GAC1B,SAAS,sBAAsB,EAAE,GACjC,sBAAsB,CAAC;CAC1B;AAED;;;;GAIG;AACH,MAAM,WAAW,uBAAuB,CAAC,KAAK,SAAS,eAAe,GAAG,eAAe,CACvF,SAAQ,mBAAmB,CAAC,KAAK,CAAC;IAClC;;OAEG;IACH,QAAQ,CAAC,0BAA0B,EAAE,iBAAiB,CAAC;CACvD;AAED;;;;GAIG;AACH,MAAM,WAAW,oCAAoC,CACpD,KAAK,SAAS,eAAe,GAAG,eAAe,CAC9C,SAAQ,WAAW,CAAC,KAAK,CAAC,EAC1B,uBAAuB,CAAC,KAAK,CAAC;CAAG;AAEnC;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,SAAS,eAAe,EAC/D,MAAM,EAAE,oCAAoC,CAAC,CAAC,CAAC,GAC7C,oCAAoC,CAAC,CAAC,CAAC,CAEzC"}
+{"version":3,"file":"schematizeTree.d.ts","sourceRoot":"","sources":["../../src/shared-tree/schematizeTree.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,EACN,iBAAiB,EAEjB,sBAAsB,EAItB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAEN,eAAe,EACf,cAAc,EACd,mBAAmB,EACnB,UAAU,EAKV,MAAM,+BAA+B,CAAC;AAGvC,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAElD;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAChC,gBAAgB,EAAE;IACjB,YAAY,EAAE,aAAa,CAAC,cAAc,CAAC,CAAC;IAC5C,YAAY,EAAE,aAAa,CAAC,cAAc,CAAC,CAAC;CAC5C,EACD,SAAS,EAAE,cAAc,EACzB,cAAc,EAAE,MAAM,IAAI,GACxB,IAAI,CAgDN;AAED,oBAAY,UAAU;IACrB;;OAEG;IACH,IAAI,IAAA;IACJ;;OAEG;IACH,UAAU,IAAA;IACV;;OAEG;IACH,gBAAgB,IAAA;IAChB;;OAEG;IACH,YAAY,IAAA;CACZ;AAED,wBAAgB,cAAc,CAC7B,UAAU,EAAE,UAAU,EACtB,0BAA0B,EAAE,iBAAiB,EAC7C,QAAQ,EAAE,aAAa,GACrB,UAAU,CA4BZ;AAED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,aAAa,GAAG,OAAO,CAG9D;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAC3B,UAAU,EAAE,UAAU,EACtB,0BAA0B,EAAE,iBAAiB,EAC7C,QAAQ,EAAE,aAAa,EACvB,WAAW,EAAE,WAAW,GAAG,SAAS,GAClC,OAAO,CAgET;AAED;;;;GAIG;AACH,MAAM,WAAW,mBAAmB,CAAC,KAAK,SAAS,eAAe,GAAG,eAAe;IACnF;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC,KAAK,CAAC,CAAC;CACvC;AAED;;;;GAIG;AACH,MAAM,WAAW,WAAW,CAAC,KAAK,SAAS,eAAe,GAAG,eAAe,CAC3E,SAAQ,mBAAmB,CAAC,KAAK,CAAC;IAClC;;;OAGG;IACH,QAAQ,CAAC,WAAW,EACjB,mBAAmB,CAAC,KAAK,CAAC,GAC1B,SAAS,sBAAsB,EAAE,GACjC,sBAAsB,CAAC;CAC1B;AAED;;;;GAIG;AACH,MAAM,WAAW,uBAAuB,CAAC,KAAK,SAAS,eAAe,GAAG,eAAe,CACvF,SAAQ,mBAAmB,CAAC,KAAK,CAAC;IAClC;;OAEG;IACH,QAAQ,CAAC,0BAA0B,EAAE,iBAAiB,CAAC;CACvD;AAED;;;;GAIG;AACH,MAAM,WAAW,oCAAoC,CACpD,KAAK,SAAS,eAAe,GAAG,eAAe,CAC9C,SAAQ,WAAW,CAAC,KAAK,CAAC,EAC1B,uBAAuB,CAAC,KAAK,CAAC;CAAG;AAEnC;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,SAAS,eAAe,EAC/D,MAAM,EAAE,oCAAoC,CAAC,CAAC,CAAC,GAC7C,oCAAoC,CAAC,CAAC,CAAC,CAEzC"}

package/lib/shared-tree/schematizeTree.js

@@ -2,9 +2,9 @@
  * Copyright (c) Microsoft Corporation and contributors. All rights reserved.
  * Licensed under the MIT License.
  */
-import { assert, unreachableCase } from "@fluidframework/core-utils";
-import { AllowedUpdateType, Compatibility, schemaDataIsEmpty, rootFieldKey, } from "../core/index.js";
-import { defaultSchemaPolicy, FieldKinds, allowsRepoSuperset, intoStoredSchema, normalizeNewFieldContent, } from "../feature-libraries/index.js";
+import { assert, unreachableCase } from "@fluidframework/core-utils/internal";
+import { AllowedUpdateType, Compatibility, rootFieldKey, schemaDataIsEmpty, } from "../core/index.js";
+import { FieldKinds, allowsRepoSuperset, defaultSchemaPolicy, intoStoredSchema, normalizeNewFieldContent, } from "../feature-libraries/index.js";
 import { fail } from "../util/index.js";
 /**
  * Modify `storedSchema` and invoke `setInitialTree` when it's time to set the tree content.
@@ -22,7 +22,7 @@ export function initializeContent(schemaRepository, newSchema, setInitialTree) {
     assert(schemaDataIsEmpty(schemaRepository.storedSchema), 0x743 /* cannot initialize after a schema is set */);
     const schema = intoStoredSchema(newSchema);
     const rootSchema = schema.rootFieldSchema;
-    const rootKind = rootSchema.kind.identifier;
+    const rootKind = rootSchema.kind;
     // To keep the data in schema during the update, first define a schema that tolerates the current (empty) tree as well as the final (initial) tree.
     let incrementalSchemaUpdate;
     if (rootKind === FieldKinds.sequence.identifier ||
@@ -36,7 +36,7 @@ export function initializeContent(schemaRepository, newSchema, setInitialTree) {
         incrementalSchemaUpdate = {
             nodeSchema: schema.nodeSchema,
             rootFieldSchema: {
-                kind: FieldKinds.optional,
+                kind: FieldKinds.optional.identifier,
                 types: rootSchema.types,
             },
         };
@@ -143,7 +143,7 @@ export function ensureSchema(viewSchema, allowedSchemaModifications, checkout, t
             initializeContent(checkout, treeContent.schema, () => {
                 const field = { field: rootFieldKey, parent: undefined };
                 const content = normalizeNewFieldContent({ schema: treeContent.schema }, treeContent.schema.rootFieldSchema, treeContent.initialTree);
-                switch (checkout.storedSchema.rootFieldSchema.kind.identifier) {
+                switch (checkout.storedSchema.rootFieldSchema.kind) {
                     case FieldKinds.optional.identifier: {
                         const fieldEditor = checkout.editor.optionalField(field);
                         assert(content.getFieldLength() <= 1, 0x7f4 /* optional field content should normalize at most one item */);

package/lib/shared-tree/schematizeTree.js.map

@@ -1 +1 @@
-{"version":3,"file":"schematizeTree.js","sourceRoot":"","sources":["../../src/shared-tree/schematizeTree.ts"],"names":[],"mappings":"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","sourcesContent":["/*!\n * Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n */\n\nimport { assert, unreachableCase } from \"@fluidframework/core-utils\";\nimport {\n\tAllowedUpdateType,\n\tCompatibility,\n\tTreeStoredSchema,\n\tITreeCursorSynchronous,\n\tschemaDataIsEmpty,\n\trootFieldKey,\n} from \"../core/index.js\";\nimport {\n\tdefaultSchemaPolicy,\n\tFieldKinds,\n\tallowsRepoSuperset,\n\tFlexTreeSchema,\n\tFlexFieldSchema,\n\tViewSchema,\n\tInsertableFlexField,\n\tintoStoredSchema,\n\tnormalizeNewFieldContent,\n} from \"../feature-libraries/index.js\";\nimport { fail } from \"../util/index.js\";\nimport { ITreeCheckout } from \"./treeCheckout.js\";\n\n/**\n * Modify `storedSchema` and invoke `setInitialTree` when it's time to set the tree content.\n *\n * Requires `storedSchema` to be in its default/empty state.\n *\n * This is done in such a way that if the content (implicitly assumed to start empty)\n * is never out of schema.\n * This means that if the root field of the new schema requires content (like a value field),\n * a temporary intermediate schema is used so the initial empty state is not out of schema.\n *\n * Since this makes multiple changes, callers may want to wrap it in a transaction.\n */\nexport function initializeContent(\n\tschemaRepository: {\n\t\tstoredSchema: ITreeCheckout[\"storedSchema\"];\n\t\tupdateSchema: ITreeCheckout[\"updateSchema\"];\n\t},\n\tnewSchema: FlexTreeSchema,\n\tsetInitialTree: () => void,\n): void {\n\tassert(\n\t\tschemaDataIsEmpty(schemaRepository.storedSchema),\n\t\t0x743 /* cannot initialize after a schema is set */,\n\t);\n\n\tconst schema = intoStoredSchema(newSchema);\n\tconst rootSchema = schema.rootFieldSchema;\n\tconst rootKind = rootSchema.kind.identifier;\n\n\t// To keep the data in schema during the update, first define a schema that tolerates the current (empty) tree as well as the final (initial) tree.\n\tlet incrementalSchemaUpdate: TreeStoredSchema;\n\tif (\n\t\trootKind === FieldKinds.sequence.identifier ||\n\t\trootKind === FieldKinds.optional.identifier\n\t) {\n\t\t// These kinds are known to tolerate empty, so use the schema as is:\n\t\tincrementalSchemaUpdate = schema;\n\t} else {\n\t\tassert(rootKind === FieldKinds.required.identifier, 0x5c8 /* Unexpected kind */);\n\t\t// Replace value kind with optional kind in root field schema:\n\t\tincrementalSchemaUpdate = {\n\t\t\tnodeSchema: schema.nodeSchema,\n\t\t\trootFieldSchema: {\n\t\t\t\tkind: FieldKinds.optional,\n\t\t\t\ttypes: rootSchema.types,\n\t\t\t},\n\t\t};\n\t}\n\n\t// TODO: fix issues with schema comparison and enable this.\n\t// assert(\n\t// \tallowsRepoSuperset(defaultSchemaPolicy, tree.storedSchema, incrementalSchemaUpdate),\n\t// \t\"Incremental Schema update should support the existing empty tree\",\n\t// );\n\tassert(\n\t\tallowsRepoSuperset(defaultSchemaPolicy, schema, incrementalSchemaUpdate),\n\t\t0x5c9 /* Incremental Schema during update should be a allow a superset of the final schema */,\n\t);\n\t// Update to intermediate schema\n\tschemaRepository.updateSchema(incrementalSchemaUpdate);\n\t// Insert initial tree\n\tsetInitialTree();\n\n\t// If intermediate schema is not final desired schema, update to the final schema:\n\tif (incrementalSchemaUpdate !== schema) {\n\t\tschemaRepository.updateSchema(schema);\n\t}\n}\n\nexport enum UpdateType {\n\t/**\n\t * Already compatible, no update needed.\n\t */\n\tNone,\n\t/**\n\t * Empty: needs initializing.\n\t */\n\tInitialize,\n\t/**\n\t * Schema can be upgraded leaving tree as is.\n\t */\n\tSchemaCompatible,\n\t/**\n\t * No update currently supported.\n\t */\n\tIncompatible,\n}\n\nexport function evaluateUpdate(\n\tviewSchema: ViewSchema,\n\tallowedSchemaModifications: AllowedUpdateType,\n\tcheckout: ITreeCheckout,\n): UpdateType {\n\tconst compatibility = viewSchema.checkCompatibility(checkout.storedSchema);\n\n\tif (\n\t\tcompatibility.read === Compatibility.Compatible &&\n\t\tcompatibility.write === Compatibility.Compatible\n\t) {\n\t\t// Compatible as is\n\t\treturn UpdateType.None;\n\t}\n\n\t// eslint-disable-next-line no-bitwise\n\tif (allowedSchemaModifications & AllowedUpdateType.Initialize && canInitialize(checkout)) {\n\t\treturn UpdateType.Initialize;\n\t}\n\n\tif (compatibility.read !== Compatibility.Compatible) {\n\t\t// Existing stored schema permits trees which are incompatible with the view schema, so schema can not be updated\n\t\treturn UpdateType.Incompatible;\n\t}\n\n\tassert(compatibility.write === Compatibility.Incompatible, 0x8bd /* unexpected case */);\n\tassert(compatibility.read === Compatibility.Compatible, 0x8be /* unexpected case */);\n\n\t// eslint-disable-next-line no-bitwise\n\treturn allowedSchemaModifications & AllowedUpdateType.SchemaCompatible\n\t\t? UpdateType.SchemaCompatible\n\t\t: UpdateType.Incompatible;\n}\n\nexport function canInitialize(checkout: ITreeCheckout): boolean {\n\t// Check for empty.\n\treturn checkout.forest.isEmpty && schemaDataIsEmpty(checkout.storedSchema);\n}\n\n/**\n * Ensure a {@link ITreeCheckout} can be used with a given {@link ViewSchema}.\n *\n * @remarks\n * It is up to the caller to ensure that compatibility is reevaluated if the checkout's stored schema is edited in the future.\n *\n * @param viewSchema - View schema that `checkout` should be made compatible with.\n * @param allowedSchemaModifications - Flags enum describing the ways this is allowed to modify `checkout`.\n * @param checkout - To be modified as needed to be compatible with `viewSchema`.\n * @param treeContent - Content to be used to initialize `checkout`'s the tree if needed and allowed.\n * @returns true iff checkout now is compatible with `viewSchema`.\n */\nexport function ensureSchema(\n\tviewSchema: ViewSchema,\n\tallowedSchemaModifications: AllowedUpdateType,\n\tcheckout: ITreeCheckout,\n\ttreeContent: TreeContent | undefined,\n): boolean {\n\tlet possibleModifications = allowedSchemaModifications;\n\tif (treeContent === undefined) {\n\t\t// Clear bit for Initialize if initial tree is not provided.\n\t\t// eslint-disable-next-line no-bitwise\n\t\tpossibleModifications &= ~AllowedUpdateType.Initialize;\n\t}\n\tconst updatedNeeded = evaluateUpdate(viewSchema, possibleModifications, checkout);\n\tswitch (updatedNeeded) {\n\t\tcase UpdateType.None: {\n\t\t\treturn true;\n\t\t}\n\t\tcase UpdateType.Incompatible: {\n\t\t\treturn false;\n\t\t}\n\t\tcase UpdateType.SchemaCompatible: {\n\t\t\tcheckout.updateSchema(intoStoredSchema(viewSchema.schema));\n\t\t\treturn true;\n\t\t}\n\t\tcase UpdateType.Initialize: {\n\t\t\tif (treeContent === undefined) {\n\t\t\t\treturn false;\n\t\t\t}\n\t\t\t// TODO:\n\t\t\t// When this becomes a more proper out of schema adapter, editing should be made lazy.\n\t\t\t// This will improve support for readonly documents, cross version collaboration and attribution.\n\n\t\t\tcheckout.transaction.start();\n\t\t\tinitializeContent(checkout, treeContent.schema, () => {\n\t\t\t\tconst field = { field: rootFieldKey, parent: undefined };\n\t\t\t\tconst content = normalizeNewFieldContent(\n\t\t\t\t\t{ schema: treeContent.schema },\n\t\t\t\t\ttreeContent.schema.rootFieldSchema,\n\t\t\t\t\ttreeContent.initialTree,\n\t\t\t\t);\n\t\t\t\tswitch (checkout.storedSchema.rootFieldSchema.kind.identifier) {\n\t\t\t\t\tcase FieldKinds.optional.identifier: {\n\t\t\t\t\t\tconst fieldEditor = checkout.editor.optionalField(field);\n\t\t\t\t\t\tassert(\n\t\t\t\t\t\t\tcontent.getFieldLength() <= 1,\n\t\t\t\t\t\t\t0x7f4 /* optional field content should normalize at most one item */,\n\t\t\t\t\t\t);\n\t\t\t\t\t\tfieldEditor.set(content.getFieldLength() === 0 ? undefined : content, true);\n\t\t\t\t\t\tbreak;\n\t\t\t\t\t}\n\t\t\t\t\tcase FieldKinds.sequence.identifier: {\n\t\t\t\t\t\tconst fieldEditor = checkout.editor.sequenceField(field);\n\t\t\t\t\t\t// TODO: should do an idempotent edit here.\n\t\t\t\t\t\tfieldEditor.insert(0, content);\n\t\t\t\t\t\tbreak;\n\t\t\t\t\t}\n\t\t\t\t\tdefault: {\n\t\t\t\t\t\tfail(\"unexpected root field kind during initialize\");\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t});\n\t\t\tcheckout.transaction.commit();\n\n\t\t\treturn true;\n\t\t}\n\t\tdefault: {\n\t\t\tunreachableCase(updatedNeeded);\n\t\t}\n\t}\n}\n\n/**\n * View Schema for a `SharedTree`.\n *\n * @internal\n */\nexport interface SchemaConfiguration<TRoot extends FlexFieldSchema = FlexFieldSchema> {\n\t/**\n\t * The schema which the application wants to view the tree with.\n\t */\n\treadonly schema: FlexTreeSchema<TRoot>;\n}\n\n/**\n * Content that can populate a `SharedTree`.\n *\n * @internal\n */\nexport interface TreeContent<TRoot extends FlexFieldSchema = FlexFieldSchema>\n\textends SchemaConfiguration<TRoot> {\n\t/**\n\t * Default tree content to initialize the tree with iff the tree is uninitialized\n\t * (meaning it does not even have any schema set at all).\n\t */\n\treadonly initialTree:\n\t\t| InsertableFlexField<TRoot>\n\t\t| readonly ITreeCursorSynchronous[]\n\t\t| ITreeCursorSynchronous;\n}\n\n/**\n * Options used to schematize a `SharedTree`.\n *\n * @internal\n */\nexport interface SchematizeConfiguration<TRoot extends FlexFieldSchema = FlexFieldSchema>\n\textends SchemaConfiguration<TRoot> {\n\t/**\n\t * Controls if and how schema from existing documents can be updated to accommodate the view schema.\n\t */\n\treadonly allowedSchemaModifications: AllowedUpdateType;\n}\n\n/**\n * Options used to initialize (if needed) and schematize a `SharedTree`.\n *\n * @internal\n */\nexport interface InitializeAndSchematizeConfiguration<\n\tTRoot extends FlexFieldSchema = FlexFieldSchema,\n> extends TreeContent<TRoot>,\n\t\tSchematizeConfiguration<TRoot> {}\n\n/**\n * Options used to initialize (if needed) and schematize a `SharedTree`.\n * @remarks\n * Using this builder improves type safety and error quality over just constructing the configuration as a object.\n * @internal\n */\nexport function buildTreeConfiguration<T extends FlexFieldSchema>(\n\tconfig: InitializeAndSchematizeConfiguration<T>,\n): InitializeAndSchematizeConfiguration<T> {\n\treturn config;\n}\n"]}
+{"version":3,"file":"schematizeTree.js","sourceRoot":"","sources":["../../src/shared-tree/schematizeTree.ts"],"names":[],"mappings":"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","sourcesContent":["/*!\n * Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n */\n\nimport { assert, unreachableCase } from \"@fluidframework/core-utils/internal\";\n\nimport {\n\tAllowedUpdateType,\n\tCompatibility,\n\tITreeCursorSynchronous,\n\tTreeStoredSchema,\n\trootFieldKey,\n\tschemaDataIsEmpty,\n} from \"../core/index.js\";\nimport {\n\tFieldKinds,\n\tFlexFieldSchema,\n\tFlexTreeSchema,\n\tInsertableFlexField,\n\tViewSchema,\n\tallowsRepoSuperset,\n\tdefaultSchemaPolicy,\n\tintoStoredSchema,\n\tnormalizeNewFieldContent,\n} from \"../feature-libraries/index.js\";\nimport { fail } from \"../util/index.js\";\n\nimport { ITreeCheckout } from \"./treeCheckout.js\";\n\n/**\n * Modify `storedSchema` and invoke `setInitialTree` when it's time to set the tree content.\n *\n * Requires `storedSchema` to be in its default/empty state.\n *\n * This is done in such a way that if the content (implicitly assumed to start empty)\n * is never out of schema.\n * This means that if the root field of the new schema requires content (like a value field),\n * a temporary intermediate schema is used so the initial empty state is not out of schema.\n *\n * Since this makes multiple changes, callers may want to wrap it in a transaction.\n */\nexport function initializeContent(\n\tschemaRepository: {\n\t\tstoredSchema: ITreeCheckout[\"storedSchema\"];\n\t\tupdateSchema: ITreeCheckout[\"updateSchema\"];\n\t},\n\tnewSchema: FlexTreeSchema,\n\tsetInitialTree: () => void,\n): void {\n\tassert(\n\t\tschemaDataIsEmpty(schemaRepository.storedSchema),\n\t\t0x743 /* cannot initialize after a schema is set */,\n\t);\n\n\tconst schema = intoStoredSchema(newSchema);\n\tconst rootSchema = schema.rootFieldSchema;\n\tconst rootKind = rootSchema.kind;\n\n\t// To keep the data in schema during the update, first define a schema that tolerates the current (empty) tree as well as the final (initial) tree.\n\tlet incrementalSchemaUpdate: TreeStoredSchema;\n\tif (\n\t\trootKind === FieldKinds.sequence.identifier ||\n\t\trootKind === FieldKinds.optional.identifier\n\t) {\n\t\t// These kinds are known to tolerate empty, so use the schema as is:\n\t\tincrementalSchemaUpdate = schema;\n\t} else {\n\t\tassert(rootKind === FieldKinds.required.identifier, 0x5c8 /* Unexpected kind */);\n\t\t// Replace value kind with optional kind in root field schema:\n\t\tincrementalSchemaUpdate = {\n\t\t\tnodeSchema: schema.nodeSchema,\n\t\t\trootFieldSchema: {\n\t\t\t\tkind: FieldKinds.optional.identifier,\n\t\t\t\ttypes: rootSchema.types,\n\t\t\t},\n\t\t};\n\t}\n\n\t// TODO: fix issues with schema comparison and enable this.\n\t// assert(\n\t// \tallowsRepoSuperset(defaultSchemaPolicy, tree.storedSchema, incrementalSchemaUpdate),\n\t// \t\"Incremental Schema update should support the existing empty tree\",\n\t// );\n\tassert(\n\t\tallowsRepoSuperset(defaultSchemaPolicy, schema, incrementalSchemaUpdate),\n\t\t0x5c9 /* Incremental Schema during update should be a allow a superset of the final schema */,\n\t);\n\t// Update to intermediate schema\n\tschemaRepository.updateSchema(incrementalSchemaUpdate);\n\t// Insert initial tree\n\tsetInitialTree();\n\n\t// If intermediate schema is not final desired schema, update to the final schema:\n\tif (incrementalSchemaUpdate !== schema) {\n\t\tschemaRepository.updateSchema(schema);\n\t}\n}\n\nexport enum UpdateType {\n\t/**\n\t * Already compatible, no update needed.\n\t */\n\tNone,\n\t/**\n\t * Empty: needs initializing.\n\t */\n\tInitialize,\n\t/**\n\t * Schema can be upgraded leaving tree as is.\n\t */\n\tSchemaCompatible,\n\t/**\n\t * No update currently supported.\n\t */\n\tIncompatible,\n}\n\nexport function evaluateUpdate(\n\tviewSchema: ViewSchema,\n\tallowedSchemaModifications: AllowedUpdateType,\n\tcheckout: ITreeCheckout,\n): UpdateType {\n\tconst compatibility = viewSchema.checkCompatibility(checkout.storedSchema);\n\n\tif (\n\t\tcompatibility.read === Compatibility.Compatible &&\n\t\tcompatibility.write === Compatibility.Compatible\n\t) {\n\t\t// Compatible as is\n\t\treturn UpdateType.None;\n\t}\n\n\t// eslint-disable-next-line no-bitwise\n\tif (allowedSchemaModifications & AllowedUpdateType.Initialize && canInitialize(checkout)) {\n\t\treturn UpdateType.Initialize;\n\t}\n\n\tif (compatibility.read !== Compatibility.Compatible) {\n\t\t// Existing stored schema permits trees which are incompatible with the view schema, so schema can not be updated\n\t\treturn UpdateType.Incompatible;\n\t}\n\n\tassert(compatibility.write === Compatibility.Incompatible, 0x8bd /* unexpected case */);\n\tassert(compatibility.read === Compatibility.Compatible, 0x8be /* unexpected case */);\n\n\t// eslint-disable-next-line no-bitwise\n\treturn allowedSchemaModifications & AllowedUpdateType.SchemaCompatible\n\t\t? UpdateType.SchemaCompatible\n\t\t: UpdateType.Incompatible;\n}\n\nexport function canInitialize(checkout: ITreeCheckout): boolean {\n\t// Check for empty.\n\treturn checkout.forest.isEmpty && schemaDataIsEmpty(checkout.storedSchema);\n}\n\n/**\n * Ensure a {@link ITreeCheckout} can be used with a given {@link ViewSchema}.\n *\n * @remarks\n * It is up to the caller to ensure that compatibility is reevaluated if the checkout's stored schema is edited in the future.\n *\n * @param viewSchema - View schema that `checkout` should be made compatible with.\n * @param allowedSchemaModifications - Flags enum describing the ways this is allowed to modify `checkout`.\n * @param checkout - To be modified as needed to be compatible with `viewSchema`.\n * @param treeContent - Content to be used to initialize `checkout`'s the tree if needed and allowed.\n * @returns true iff checkout now is compatible with `viewSchema`.\n */\nexport function ensureSchema(\n\tviewSchema: ViewSchema,\n\tallowedSchemaModifications: AllowedUpdateType,\n\tcheckout: ITreeCheckout,\n\ttreeContent: TreeContent | undefined,\n): boolean {\n\tlet possibleModifications = allowedSchemaModifications;\n\tif (treeContent === undefined) {\n\t\t// Clear bit for Initialize if initial tree is not provided.\n\t\t// eslint-disable-next-line no-bitwise\n\t\tpossibleModifications &= ~AllowedUpdateType.Initialize;\n\t}\n\tconst updatedNeeded = evaluateUpdate(viewSchema, possibleModifications, checkout);\n\tswitch (updatedNeeded) {\n\t\tcase UpdateType.None: {\n\t\t\treturn true;\n\t\t}\n\t\tcase UpdateType.Incompatible: {\n\t\t\treturn false;\n\t\t}\n\t\tcase UpdateType.SchemaCompatible: {\n\t\t\tcheckout.updateSchema(intoStoredSchema(viewSchema.schema));\n\t\t\treturn true;\n\t\t}\n\t\tcase UpdateType.Initialize: {\n\t\t\tif (treeContent === undefined) {\n\t\t\t\treturn false;\n\t\t\t}\n\t\t\t// TODO:\n\t\t\t// When this becomes a more proper out of schema adapter, editing should be made lazy.\n\t\t\t// This will improve support for readonly documents, cross version collaboration and attribution.\n\n\t\t\tcheckout.transaction.start();\n\t\t\tinitializeContent(checkout, treeContent.schema, () => {\n\t\t\t\tconst field = { field: rootFieldKey, parent: undefined };\n\t\t\t\tconst content = normalizeNewFieldContent(\n\t\t\t\t\t{ schema: treeContent.schema },\n\t\t\t\t\ttreeContent.schema.rootFieldSchema,\n\t\t\t\t\ttreeContent.initialTree,\n\t\t\t\t);\n\t\t\t\tswitch (checkout.storedSchema.rootFieldSchema.kind) {\n\t\t\t\t\tcase FieldKinds.optional.identifier: {\n\t\t\t\t\t\tconst fieldEditor = checkout.editor.optionalField(field);\n\t\t\t\t\t\tassert(\n\t\t\t\t\t\t\tcontent.getFieldLength() <= 1,\n\t\t\t\t\t\t\t0x7f4 /* optional field content should normalize at most one item */,\n\t\t\t\t\t\t);\n\t\t\t\t\t\tfieldEditor.set(content.getFieldLength() === 0 ? undefined : content, true);\n\t\t\t\t\t\tbreak;\n\t\t\t\t\t}\n\t\t\t\t\tcase FieldKinds.sequence.identifier: {\n\t\t\t\t\t\tconst fieldEditor = checkout.editor.sequenceField(field);\n\t\t\t\t\t\t// TODO: should do an idempotent edit here.\n\t\t\t\t\t\tfieldEditor.insert(0, content);\n\t\t\t\t\t\tbreak;\n\t\t\t\t\t}\n\t\t\t\t\tdefault: {\n\t\t\t\t\t\tfail(\"unexpected root field kind during initialize\");\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t});\n\t\t\tcheckout.transaction.commit();\n\n\t\t\treturn true;\n\t\t}\n\t\tdefault: {\n\t\t\tunreachableCase(updatedNeeded);\n\t\t}\n\t}\n}\n\n/**\n * View Schema for a `SharedTree`.\n *\n * @internal\n */\nexport interface SchemaConfiguration<TRoot extends FlexFieldSchema = FlexFieldSchema> {\n\t/**\n\t * The schema which the application wants to view the tree with.\n\t */\n\treadonly schema: FlexTreeSchema<TRoot>;\n}\n\n/**\n * Content that can populate a `SharedTree`.\n *\n * @internal\n */\nexport interface TreeContent<TRoot extends FlexFieldSchema = FlexFieldSchema>\n\textends SchemaConfiguration<TRoot> {\n\t/**\n\t * Default tree content to initialize the tree with iff the tree is uninitialized\n\t * (meaning it does not even have any schema set at all).\n\t */\n\treadonly initialTree:\n\t\t| InsertableFlexField<TRoot>\n\t\t| readonly ITreeCursorSynchronous[]\n\t\t| ITreeCursorSynchronous;\n}\n\n/**\n * Options used to schematize a `SharedTree`.\n *\n * @internal\n */\nexport interface SchematizeConfiguration<TRoot extends FlexFieldSchema = FlexFieldSchema>\n\textends SchemaConfiguration<TRoot> {\n\t/**\n\t * Controls if and how schema from existing documents can be updated to accommodate the view schema.\n\t */\n\treadonly allowedSchemaModifications: AllowedUpdateType;\n}\n\n/**\n * Options used to initialize (if needed) and schematize a `SharedTree`.\n *\n * @internal\n */\nexport interface InitializeAndSchematizeConfiguration<\n\tTRoot extends FlexFieldSchema = FlexFieldSchema,\n> extends TreeContent<TRoot>,\n\t\tSchematizeConfiguration<TRoot> {}\n\n/**\n * Options used to initialize (if needed) and schematize a `SharedTree`.\n * @remarks\n * Using this builder improves type safety and error quality over just constructing the configuration as a object.\n * @internal\n */\nexport function buildTreeConfiguration<T extends FlexFieldSchema>(\n\tconfig: InitializeAndSchematizeConfiguration<T>,\n): InitializeAndSchematizeConfiguration<T> {\n\treturn config;\n}\n"]}

package/lib/shared-tree/schematizingTreeView.d.ts

@@ -1,15 +1,19 @@
+/*!
+ * Copyright (c) Microsoft Corporation and contributors. All rights reserved.
+ * Licensed under the MIT License.
+ */
 import { FieldKey } from "../core/index.js";
-import { FlexFieldSchema, ViewSchema, NodeKeyManager } from "../feature-libraries/index.js";
 import { HasListeners, IEmitter, ISubscribable } from "../events/index.js";
+import { FlexFieldSchema, NodeKeyManager, ViewSchema } from "../feature-libraries/index.js";
+import { ImplicitFieldSchema, InsertableTreeFieldFromImplicitField, SchemaIncompatible, TreeConfiguration, TreeFieldFromImplicitField, TreeView, TreeViewEvents } from "../simple-tree/index.js";
 import { disposeSymbol } from "../util/index.js";
-import { TreeConfiguration, ImplicitFieldSchema, TreeFieldFromImplicitField, TreeView, TreeViewEvents, SchemaIncompatible } from "../simple-tree/index.js";
 import { UpdateType } from "./schematizeTree.js";
 import { TreeCheckout } from "./treeCheckout.js";
 import { CheckoutFlexTreeView } from "./treeView.js";
 /**
  * Implementation of TreeView wrapping a FlexTreeView.
  */
-export declare class SchematizingSimpleTreeView<in out TRootSchema extends ImplicitFieldSchema> implements TreeView<TreeFieldFromImplicitField<TRootSchema>> {
+export declare class SchematizingSimpleTreeView<in out TRootSchema extends ImplicitFieldSchema> implements TreeView<TRootSchema> {
     readonly checkout: TreeCheckout;
     readonly config: TreeConfiguration<TRootSchema>;
     readonly nodeKeyManager: NodeKeyManager;
@@ -24,7 +28,9 @@ export declare class SchematizingSimpleTreeView<in out TRootSchema extends Impli
     private readonly flexConfig;
     readonly events: ISubscribable<TreeViewEvents> & IEmitter<TreeViewEvents> & HasListeners<TreeViewEvents>;
     private readonly viewSchema;
+    private readonly unregisterCallbacks;
     private disposed;
+    private readonly rootFieldSchema;
     constructor(checkout: TreeCheckout, config: TreeConfiguration<TRootSchema>, nodeKeyManager: NodeKeyManager, nodeKeyFieldKey: FieldKey);
     upgradeSchema(): void;
     /**
@@ -45,6 +51,7 @@ export declare class SchematizingSimpleTreeView<in out TRootSchema extends Impli
     get error(): SchematizeError | undefined;
     [disposeSymbol](): void;
     get root(): TreeFieldFromImplicitField<TRootSchema>;
+    set root(newRoot: InsertableTreeFieldFromImplicitField<TRootSchema>);
 }
 export declare class SchematizeError implements SchemaIncompatible {
     readonly updateType: UpdateType;

package/lib/shared-tree/schematizingTreeView.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schematizingTreeView.d.ts","sourceRoot":"","sources":["../../src/shared-tree/schematizingTreeView.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,QAAQ,EAAgD,MAAM,kBAAkB,CAAC;AAC1F,OAAO,EAEN,eAAe,EACf,UAAU,EACV,cAAc,EACd,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,aAAa,EAAiB,MAAM,oBAAoB,CAAC;AAC1F,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EACN,iBAAiB,EAEjB,mBAAmB,EACnB,0BAA0B,EAC1B,QAAQ,EACR,cAAc,EAEd,kBAAkB,EAClB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAe,UAAU,EAAgC,MAAM,qBAAqB,CAAC;AAC5F,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAErD;;GAEG;AACH,qBAAa,0BAA0B,CAAC,EAAE,CAAC,GAAG,CAAC,WAAW,SAAS,mBAAmB,CACrF,YAAW,QAAQ,CAAC,0BAA0B,CAAC,WAAW,CAAC,CAAC;aAmB3C,QAAQ,EAAE,YAAY;aACtB,MAAM,EAAE,iBAAiB,CAAC,WAAW,CAAC;aACtC,cAAc,EAAE,cAAc;aAC9B,eAAe,EAAE,QAAQ;IApB1C;;;;;OAKG;IACH,OAAO,CAAC,IAAI,CAAsE;IAClF,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAc;IACzC,SAAgB,MAAM,EAAE,aAAa,CAAC,cAAc,CAAC,GACpD,QAAQ,CAAC,cAAc,CAAC,GACxB,YAAY,CAAC,cAAc,CAAC,CAAmB;IAEhD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAa;IAExC,OAAO,CAAC,QAAQ,CAAS;gBAGR,QAAQ,EAAE,YAAY,EACtB,MAAM,EAAE,iBAAiB,CAAC,WAAW,CAAC,EACtC,cAAc,EAAE,cAAc,EAC9B,eAAe,EAAE,QAAQ;IAOnC,aAAa,IAAI,IAAI;IAyB5B;;;OAGG;IACI,cAAc,IAAI,oBAAoB,CAAC,eAAe,CAAC,GAAG,eAAe;IAQhF;;;;;;;OAOG;IACH,OAAO,CAAC,MAAM;IA6Dd,OAAO,CAAC,WAAW;IAOnB,IAAW,KAAK,IAAI,eAAe,GAAG,SAAS,CAG9C;IAEM,CAAC,aAAa,CAAC,IAAI,IAAI;IAM9B,IAAW,IAAI,IAAI,0BAA0B,CAAC,WAAW,CAAC,CAQzD;CACD;AAED,qBAAa,eAAgB,YAAW,kBAAkB;aACtB,UAAU,EAAE,UAAU;gBAAtB,UAAU,EAAE,UAAU;IAEzD,IAAW,UAAU,IAAI,OAAO,CAK/B;IAED,IAAW,aAAa,IAAI,OAAO,CAElC;CACD;AAWD;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,SAAS,eAAe,EAC1D,QAAQ,EAAE,YAAY,EACtB,UAAU,EAAE,UAAU,CAAC,KAAK,CAAC,EAC7B,SAAS,EAAE,MAAM,IAAI,EACrB,cAAc,EAAE,cAAc,EAC9B,eAAe,EAAE,QAAQ,GACvB,oBAAoB,CAAC,KAAK,CAAC,CAuC7B"}
+{"version":3,"file":"schematizingTreeView.d.ts","sourceRoot":"","sources":["../../src/shared-tree/schematizingTreeView.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,EAAoC,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC9E,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,aAAa,EAAiB,MAAM,oBAAoB,CAAC;AAC1F,OAAO,EACN,eAAe,EACf,cAAc,EACd,UAAU,EAGV,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAEN,mBAAmB,EACnB,oCAAoC,EACpC,kBAAkB,EAClB,iBAAiB,EACjB,0BAA0B,EAC1B,QAAQ,EACR,cAAc,EAMd,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD,OAAO,EAAe,UAAU,EAAgC,MAAM,qBAAqB,CAAC;AAC5F,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAErD;;GAEG;AACH,qBAAa,0BAA0B,CAAC,EAAE,CAAC,GAAG,CAAC,WAAW,SAAS,mBAAmB,CACrF,YAAW,QAAQ,CAAC,WAAW,CAAC;aAsBf,QAAQ,EAAE,YAAY;aACtB,MAAM,EAAE,iBAAiB,CAAC,WAAW,CAAC;aACtC,cAAc,EAAE,cAAc;aAC9B,eAAe,EAAE,QAAQ;IAvB1C;;;;;OAKG;IACH,OAAO,CAAC,IAAI,CAAsE;IAClF,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAc;IACzC,SAAgB,MAAM,EAAE,aAAa,CAAC,cAAc,CAAC,GACpD,QAAQ,CAAC,cAAc,CAAC,GACxB,YAAY,CAAC,cAAc,CAAC,CAAmB;IAEhD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAa;IAExC,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAyB;IAC7D,OAAO,CAAC,QAAQ,CAAS;IAEzB,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAc;gBAG7B,QAAQ,EAAE,YAAY,EACtB,MAAM,EAAE,iBAAiB,CAAC,WAAW,CAAC,EACtC,cAAc,EAAE,cAAc,EAC9B,eAAe,EAAE,QAAQ;IAcnC,aAAa,IAAI,IAAI;IAyB5B;;;OAGG;IACI,cAAc,IAAI,oBAAoB,CAAC,eAAe,CAAC,GAAG,eAAe;IAQhF;;;;;;;OAOG;IACH,OAAO,CAAC,MAAM;IA+Dd,OAAO,CAAC,WAAW;IAQnB,IAAW,KAAK,IAAI,eAAe,GAAG,SAAS,CAG9C;IAEM,CAAC,aAAa,CAAC,IAAI,IAAI;IAM9B,IAAW,IAAI,IAAI,0BAA0B,CAAC,WAAW,CAAC,CAQzD;IAED,IAAW,IAAI,CAAC,OAAO,EAAE,oCAAoC,CAAC,WAAW,CAAC,EASzE;CACD;AAED,qBAAa,eAAgB,YAAW,kBAAkB;aACtB,UAAU,EAAE,UAAU;gBAAtB,UAAU,EAAE,UAAU;IAEzD,IAAW,UAAU,IAAI,OAAO,CAK/B;IAED,IAAW,aAAa,IAAI,OAAO,CAElC;CACD;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,SAAS,eAAe,EAC1D,QAAQ,EAAE,YAAY,EACtB,UAAU,EAAE,UAAU,CAAC,KAAK,CAAC,EAC7B,SAAS,EAAE,MAAM,IAAI,EACrB,cAAc,EAAE,cAAc,EAC9B,eAAe,EAAE,QAAQ,GACvB,oBAAoB,CAAC,KAAK,CAAC,CAkC7B"}

package/lib/shared-tree/schematizingTreeView.js

@@ -2,13 +2,13 @@
  * Copyright (c) Microsoft Corporation and contributors. All rights reserved.
  * Licensed under the MIT License.
  */
-import { assert, unreachableCase } from "@fluidframework/core-utils";
-import { UsageError } from "@fluidframework/telemetry-utils";
-import { AllowedUpdateType, anchorSlot, Compatibility } from "../core/index.js";
-import { defaultSchemaPolicy, ViewSchema, } from "../feature-libraries/index.js";
+import { assert, unreachableCase } from "@fluidframework/core-utils/internal";
+import { UsageError } from "@fluidframework/telemetry-utils/internal";
+import { AllowedUpdateType, Compatibility } from "../core/index.js";
 import { createEmitter } from "../events/index.js";
+import { ViewSchema, defaultSchemaPolicy, ContextSlot, } from "../feature-libraries/index.js";
+import { getProxyForField, toFlexConfig, setField, normalizeFieldSchema, } from "../simple-tree/index.js";
 import { disposeSymbol } from "../util/index.js";
-import { toFlexConfig, getProxyForField, } from "../simple-tree/index.js";
 import { UpdateType, ensureSchema, evaluateUpdate } from "./schematizeTree.js";
 import { CheckoutFlexTreeView } from "./treeView.js";
 /**
@@ -21,10 +21,13 @@ export class SchematizingSimpleTreeView {
         this.nodeKeyManager = nodeKeyManager;
         this.nodeKeyFieldKey = nodeKeyFieldKey;
         this.events = createEmitter();
+        this.unregisterCallbacks = new Set();
         this.disposed = false;
+        this.rootFieldSchema = normalizeFieldSchema(config.schema);
         this.flexConfig = toFlexConfig(config);
         this.viewSchema = new ViewSchema(defaultSchemaPolicy, {}, this.flexConfig.schema);
         this.update();
+        this.unregisterCallbacks.add(this.checkout.events.on("commitApplied", (data, getRevertible) => this.events.emit("commitApplied", data, getRevertible)));
     }
     upgradeSchema() {
         // Errors if disposed.
@@ -99,8 +102,10 @@ export class SchematizingSimpleTreeView {
                 this.view = new SchematizeError(compatibility);
                 const unregister = this.checkout.storedSchema.on("afterSchemaChange", () => {
                     unregister();
+                    this.unregisterCallbacks.delete(unregister);
                     this.update();
                 });
+                this.unregisterCallbacks.add(unregister);
                 break;
             }
             default: {
@@ -113,6 +118,7 @@ export class SchematizingSimpleTreeView {
         if (this.view !== undefined && !(this.view instanceof SchematizeError)) {
             this.view[disposeSymbol]();
             this.view = undefined;
+            this.unregisterCallbacks.forEach((unregister) => unregister());
         }
     }
     get error() {
@@ -131,6 +137,13 @@ export class SchematizingSimpleTreeView {
         }
         return getProxyForField(view.flexTree);
     }
+    set root(newRoot) {
+        const view = this.getViewOrError();
+        if (view instanceof SchematizeError) {
+            throw new UsageError("Document is out of schema. Check TreeView.error before accessing TreeView.root.");
+        }
+        setField(view.context.root, this.rootFieldSchema, newRoot);
+    }
 }
 export class SchematizeError {
     constructor(updateType) {
@@ -144,14 +157,6 @@ export class SchematizeError {
         return this.updateType === UpdateType.Initialize;
     }
 }
-/**
- * Creating multiple flex tree contexts for the same branch, and thus with the same underlying AnchorSet does not work due to how TreeNode caching works.
- * This slot is used to detect if one already exists and error if creating a second.
- *
- * TODO:
- * 1. API docs need to reflect this limitation or the limitation has to be removed.
- */
-const ViewSlot = anchorSlot();
 /**
  * Flex-Tree schematizing layer.
  * Creates a view that self-disposes when stored schema becomes incompatible.
@@ -159,19 +164,14 @@ const ViewSlot = anchorSlot();
  */
 export function requireSchema(checkout, viewSchema, onDispose, nodeKeyManager, nodeKeyFieldKey) {
     const slots = checkout.forest.anchors.slots;
-    assert(!slots.has(ViewSlot), 0x8c2 /* Cannot create second view from checkout */);
+    assert(!slots.has(ContextSlot), 0x8c2 /* Cannot create second view from checkout */);
     {
         const compatibility = viewSchema.checkCompatibility(checkout.storedSchema);
         assert(compatibility.write === Compatibility.Compatible &&
             compatibility.read === Compatibility.Compatible, 0x8c3 /* requireSchema invoked with incompatible schema */);
     }
-    const view = new CheckoutFlexTreeView(checkout, viewSchema.schema, nodeKeyManager, nodeKeyFieldKey, () => {
-        const deleted = slots.delete(ViewSlot);
-        assert(deleted, 0x8c4 /* unexpected dispose */);
-        onDispose();
-    });
-    assert(!slots.has(ViewSlot), 0x8c5 /* Cannot create second view from checkout */);
-    slots.set(ViewSlot, view);
+    const view = new CheckoutFlexTreeView(checkout, viewSchema.schema, nodeKeyManager, nodeKeyFieldKey, onDispose);
+    assert(slots.has(ContextSlot), 0x90d /* Context should be tracked in slot */);
     const unregister = checkout.storedSchema.on("afterSchemaChange", () => {
         const compatibility = viewSchema.checkCompatibility(checkout.storedSchema);
         if (compatibility.write !== Compatibility.Compatible ||

package/lib/shared-tree/schematizingTreeView.js.map

@@ -1 +1 @@
-{"version":3,"file":"schematizingTreeView.js","sourceRoot":"","sources":["../../src/shared-tree/schematizingTreeView.ts"],"names":[],"mappings":"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","sourcesContent":["/*!\n * Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n */\nimport { assert, unreachableCase } from \"@fluidframework/core-utils\";\nimport { UsageError } from \"@fluidframework/telemetry-utils\";\nimport { FieldKey, AllowedUpdateType, anchorSlot, Compatibility } from \"../core/index.js\";\nimport {\n\tdefaultSchemaPolicy,\n\tFlexFieldSchema,\n\tViewSchema,\n\tNodeKeyManager,\n} from \"../feature-libraries/index.js\";\nimport { HasListeners, IEmitter, ISubscribable, createEmitter } from \"../events/index.js\";\nimport { disposeSymbol } from \"../util/index.js\";\nimport {\n\tTreeConfiguration,\n\ttoFlexConfig,\n\tImplicitFieldSchema,\n\tTreeFieldFromImplicitField,\n\tTreeView,\n\tTreeViewEvents,\n\tgetProxyForField,\n\tSchemaIncompatible,\n} from \"../simple-tree/index.js\";\nimport { TreeContent, UpdateType, ensureSchema, evaluateUpdate } from \"./schematizeTree.js\";\nimport { TreeCheckout } from \"./treeCheckout.js\";\nimport { CheckoutFlexTreeView } from \"./treeView.js\";\n\n/**\n * Implementation of TreeView wrapping a FlexTreeView.\n */\nexport class SchematizingSimpleTreeView<in out TRootSchema extends ImplicitFieldSchema>\n\timplements TreeView<TreeFieldFromImplicitField<TRootSchema>>\n{\n\t/**\n\t * In one of three states:\n\t * 1. Valid: A checkout is present, not disposed, and it's stored schema and view schema are compatible.\n\t * 2. SchematizeError: stored schema and view schema are not compatible.\n\t * 3. disposed: `view` is undefined, and using this object will error. Some methods also transiently leave view undefined.\n\t */\n\tprivate view: CheckoutFlexTreeView<FlexFieldSchema> | SchematizeError | undefined;\n\tprivate readonly flexConfig: TreeContent;\n\tpublic readonly events: ISubscribable<TreeViewEvents> &\n\t\tIEmitter<TreeViewEvents> &\n\t\tHasListeners<TreeViewEvents> = createEmitter();\n\n\tprivate readonly viewSchema: ViewSchema;\n\n\tprivate disposed = false;\n\n\tpublic constructor(\n\t\tpublic readonly checkout: TreeCheckout,\n\t\tpublic readonly config: TreeConfiguration<TRootSchema>,\n\t\tpublic readonly nodeKeyManager: NodeKeyManager,\n\t\tpublic readonly nodeKeyFieldKey: FieldKey,\n\t) {\n\t\tthis.flexConfig = toFlexConfig(config);\n\t\tthis.viewSchema = new ViewSchema(defaultSchemaPolicy, {}, this.flexConfig.schema);\n\t\tthis.update();\n\t}\n\n\tpublic upgradeSchema(): void {\n\t\t// Errors if disposed.\n\t\tconst error = this.error;\n\n\t\t// No-op non error state.\n\t\tif (error === undefined) {\n\t\t\treturn;\n\t\t}\n\n\t\tif (this.error?.canUpgrade !== true) {\n\t\t\tthrow new UsageError(\n\t\t\t\t\"Existing stored schema can not be upgraded (see TreeView.canUpgrade).\",\n\t\t\t);\n\t\t}\n\n\t\tconst result = ensureSchema(\n\t\t\tthis.viewSchema,\n\t\t\t// eslint-disable-next-line no-bitwise\n\t\t\tAllowedUpdateType.SchemaCompatible | AllowedUpdateType.Initialize,\n\t\t\tthis.checkout,\n\t\t\tthis.flexConfig,\n\t\t);\n\t\tassert(result, 0x8bf /* Schema upgrade should always work if canUpgrade is set. */);\n\t}\n\n\t/**\n\t * Gets the view is the stored schema is compatible with the view schema,\n\t * otherwise returns an error detailing the schema incompatibility.\n\t */\n\tpublic getViewOrError(): CheckoutFlexTreeView<FlexFieldSchema> | SchematizeError {\n\t\tif (this.disposed) {\n\t\t\tthrow new UsageError(\"Accessed a disposed TreeView.\");\n\t\t}\n\t\tassert(this.view !== undefined, 0x8c0 /* unexpected getViewOrError */);\n\t\treturn this.view;\n\t}\n\n\t/**\n\t * Updates `this.view`.\n\t * Invoked during initialization and when `this.view` needs to be replaced due to stored schema changes.\n\t * Handled re-registering for events to call update in the future.\n\t * @remarks\n\t * This does not check if the view needs to be replaced, it replaces it unconditionally:\n\t * callers should do any checking to detect if its really needed before calling `update`.\n\t */\n\tprivate update(): void {\n\t\t// This implementation avoids making any edits, which prevents it from being invoked reentrantly.\n\t\t// If implicit initialization (or some other edit) is desired, it should be done outside of this method.\n\n\t\tconst compatibility = evaluateUpdate(\n\t\t\tthis.viewSchema,\n\t\t\t// eslint-disable-next-line no-bitwise\n\t\t\tAllowedUpdateType.SchemaCompatible | AllowedUpdateType.Initialize,\n\t\t\tthis.checkout,\n\t\t);\n\t\tthis.disposeView();\n\t\tswitch (compatibility) {\n\t\t\tcase UpdateType.None: {\n\t\t\t\t// Remove event from checkout when view is disposed\n\t\t\t\tthis.view = requireSchema(\n\t\t\t\t\tthis.checkout,\n\t\t\t\t\tthis.viewSchema,\n\t\t\t\t\t() => {\n\t\t\t\t\t\tassert(cleanupCheckOutEvents !== undefined, 0x8c1 /* missing cleanup */);\n\t\t\t\t\t\tcleanupCheckOutEvents();\n\t\t\t\t\t\tthis.view = undefined;\n\t\t\t\t\t\tif (!this.disposed) {\n\t\t\t\t\t\t\tthis.update();\n\t\t\t\t\t\t}\n\t\t\t\t\t},\n\t\t\t\t\tthis.nodeKeyManager,\n\t\t\t\t\tthis.nodeKeyFieldKey,\n\t\t\t\t);\n\n\t\t\t\t// Trigger \"rootChanged\" if the root changes in the future.\n\t\t\t\t// Currently there is no good way to do this as FlexTreeField has no events for changes.\n\t\t\t\t// this.view.flexTree.on(????)\n\t\t\t\t// As a workaround for the above, trigger \"rootChanged\" in \"afterBatch\"\n\t\t\t\t// which isn't the correct time since we normally do events during the batch when the forest is modified, but its better than nothing.\n\t\t\t\t// TODO: provide a better event: this.view.flexTree.on(????)\n\t\t\t\tlet lastRoot = this.root;\n\t\t\t\tconst cleanupCheckOutEvents = this.checkout.events.on(\"afterBatch\", () => {\n\t\t\t\t\tif (lastRoot !== this.root) {\n\t\t\t\t\t\tlastRoot = this.root;\n\t\t\t\t\t\tthis.events.emit(\"rootChanged\");\n\t\t\t\t\t}\n\t\t\t\t});\n\t\t\t\tbreak;\n\t\t\t}\n\t\t\tcase UpdateType.Incompatible:\n\t\t\tcase UpdateType.Initialize:\n\t\t\tcase UpdateType.SchemaCompatible: {\n\t\t\t\tthis.view = new SchematizeError(compatibility);\n\t\t\t\tconst unregister = this.checkout.storedSchema.on(\"afterSchemaChange\", () => {\n\t\t\t\t\tunregister();\n\t\t\t\t\tthis.update();\n\t\t\t\t});\n\t\t\t\tbreak;\n\t\t\t}\n\t\t\tdefault: {\n\t\t\t\tunreachableCase(compatibility);\n\t\t\t}\n\t\t}\n\t\tthis.events.emit(\"rootChanged\");\n\t}\n\n\tprivate disposeView(): void {\n\t\tif (this.view !== undefined && !(this.view instanceof SchematizeError)) {\n\t\t\tthis.view[disposeSymbol]();\n\t\t\tthis.view = undefined;\n\t\t}\n\t}\n\n\tpublic get error(): SchematizeError | undefined {\n\t\tconst view = this.getViewOrError();\n\t\treturn view instanceof SchematizeError ? view : undefined;\n\t}\n\n\tpublic [disposeSymbol](): void {\n\t\tthis.getViewOrError();\n\t\tthis.disposed = true;\n\t\tthis.disposeView();\n\t}\n\n\tpublic get root(): TreeFieldFromImplicitField<TRootSchema> {\n\t\tconst view = this.getViewOrError();\n\t\tif (view instanceof SchematizeError) {\n\t\t\tthrow new UsageError(\n\t\t\t\t\"Document is out of schema. Check TreeView.error before accessing TreeView.root.\",\n\t\t\t);\n\t\t}\n\t\treturn getProxyForField(view.flexTree) as TreeFieldFromImplicitField<TRootSchema>;\n\t}\n}\n\nexport class SchematizeError implements SchemaIncompatible {\n\tpublic constructor(public readonly updateType: UpdateType) {}\n\n\tpublic get canUpgrade(): boolean {\n\t\treturn (\n\t\t\tthis.updateType === UpdateType.Initialize ||\n\t\t\tthis.updateType === UpdateType.SchemaCompatible\n\t\t);\n\t}\n\n\tpublic get canInitialize(): boolean {\n\t\treturn this.updateType === UpdateType.Initialize;\n\t}\n}\n\n/**\n * Creating multiple flex tree contexts for the same branch, and thus with the same underlying AnchorSet does not work due to how TreeNode caching works.\n * This slot is used to detect if one already exists and error if creating a second.\n *\n * TODO:\n * 1. API docs need to reflect this limitation or the limitation has to be removed.\n */\nconst ViewSlot = anchorSlot<CheckoutFlexTreeView<any>>();\n\n/**\n * Flex-Tree schematizing layer.\n * Creates a view that self-disposes when stored schema becomes incompatible.\n * This may only be called when the schema is already known to be compatible (typically via ensureSchema).\n */\nexport function requireSchema<TRoot extends FlexFieldSchema>(\n\tcheckout: TreeCheckout,\n\tviewSchema: ViewSchema<TRoot>,\n\tonDispose: () => void,\n\tnodeKeyManager: NodeKeyManager,\n\tnodeKeyFieldKey: FieldKey,\n): CheckoutFlexTreeView<TRoot> {\n\tconst slots = checkout.forest.anchors.slots;\n\tassert(!slots.has(ViewSlot), 0x8c2 /* Cannot create second view from checkout */);\n\n\t{\n\t\tconst compatibility = viewSchema.checkCompatibility(checkout.storedSchema);\n\t\tassert(\n\t\t\tcompatibility.write === Compatibility.Compatible &&\n\t\t\t\tcompatibility.read === Compatibility.Compatible,\n\t\t\t0x8c3 /* requireSchema invoked with incompatible schema */,\n\t\t);\n\t}\n\n\tconst view = new CheckoutFlexTreeView(\n\t\tcheckout,\n\t\tviewSchema.schema,\n\t\tnodeKeyManager,\n\t\tnodeKeyFieldKey,\n\t\t() => {\n\t\t\tconst deleted = slots.delete(ViewSlot);\n\t\t\tassert(deleted, 0x8c4 /* unexpected dispose */);\n\t\t\tonDispose();\n\t\t},\n\t);\n\tassert(!slots.has(ViewSlot), 0x8c5 /* Cannot create second view from checkout */);\n\tslots.set(ViewSlot, view);\n\n\tconst unregister = checkout.storedSchema.on(\"afterSchemaChange\", () => {\n\t\tconst compatibility = viewSchema.checkCompatibility(checkout.storedSchema);\n\t\tif (\n\t\t\tcompatibility.write !== Compatibility.Compatible ||\n\t\t\tcompatibility.read !== Compatibility.Compatible\n\t\t) {\n\t\t\tunregister();\n\t\t\tview[disposeSymbol]();\n\t\t}\n\t});\n\n\treturn view;\n}\n"]}
+{"version":3,"file":"schematizingTreeView.js","sourceRoot":"","sources":["../../src/shared-tree/schematizingTreeView.ts"],"names":[],"mappings":"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","sourcesContent":["/*!\n * Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n */\n\nimport { assert, unreachableCase } from \"@fluidframework/core-utils/internal\";\nimport { UsageError } from \"@fluidframework/telemetry-utils/internal\";\n\nimport { AllowedUpdateType, Compatibility, FieldKey } from \"../core/index.js\";\nimport { HasListeners, IEmitter, ISubscribable, createEmitter } from \"../events/index.js\";\nimport {\n\tFlexFieldSchema,\n\tNodeKeyManager,\n\tViewSchema,\n\tdefaultSchemaPolicy,\n\tContextSlot,\n} from \"../feature-libraries/index.js\";\nimport {\n\tFieldSchema,\n\tImplicitFieldSchema,\n\tInsertableTreeFieldFromImplicitField,\n\tSchemaIncompatible,\n\tTreeConfiguration,\n\tTreeFieldFromImplicitField,\n\tTreeView,\n\tTreeViewEvents,\n\tgetProxyForField,\n\ttoFlexConfig,\n\tsetField,\n\tnormalizeFieldSchema,\n\tInsertableContent,\n} from \"../simple-tree/index.js\";\nimport { disposeSymbol } from \"../util/index.js\";\n\nimport { TreeContent, UpdateType, ensureSchema, evaluateUpdate } from \"./schematizeTree.js\";\nimport { TreeCheckout } from \"./treeCheckout.js\";\nimport { CheckoutFlexTreeView } from \"./treeView.js\";\n\n/**\n * Implementation of TreeView wrapping a FlexTreeView.\n */\nexport class SchematizingSimpleTreeView<in out TRootSchema extends ImplicitFieldSchema>\n\timplements TreeView<TRootSchema>\n{\n\t/**\n\t * In one of three states:\n\t * 1. Valid: A checkout is present, not disposed, and it's stored schema and view schema are compatible.\n\t * 2. SchematizeError: stored schema and view schema are not compatible.\n\t * 3. disposed: `view` is undefined, and using this object will error. Some methods also transiently leave view undefined.\n\t */\n\tprivate view: CheckoutFlexTreeView<FlexFieldSchema> | SchematizeError | undefined;\n\tprivate readonly flexConfig: TreeContent;\n\tpublic readonly events: ISubscribable<TreeViewEvents> &\n\t\tIEmitter<TreeViewEvents> &\n\t\tHasListeners<TreeViewEvents> = createEmitter();\n\n\tprivate readonly viewSchema: ViewSchema;\n\n\tprivate readonly unregisterCallbacks = new Set<() => void>();\n\tprivate disposed = false;\n\n\tprivate readonly rootFieldSchema: FieldSchema;\n\n\tpublic constructor(\n\t\tpublic readonly checkout: TreeCheckout,\n\t\tpublic readonly config: TreeConfiguration<TRootSchema>,\n\t\tpublic readonly nodeKeyManager: NodeKeyManager,\n\t\tpublic readonly nodeKeyFieldKey: FieldKey,\n\t) {\n\t\tthis.rootFieldSchema = normalizeFieldSchema(config.schema);\n\t\tthis.flexConfig = toFlexConfig(config);\n\t\tthis.viewSchema = new ViewSchema(defaultSchemaPolicy, {}, this.flexConfig.schema);\n\t\tthis.update();\n\n\t\tthis.unregisterCallbacks.add(\n\t\t\tthis.checkout.events.on(\"commitApplied\", (data, getRevertible) =>\n\t\t\t\tthis.events.emit(\"commitApplied\", data, getRevertible),\n\t\t\t),\n\t\t);\n\t}\n\n\tpublic upgradeSchema(): void {\n\t\t// Errors if disposed.\n\t\tconst error = this.error;\n\n\t\t// No-op non error state.\n\t\tif (error === undefined) {\n\t\t\treturn;\n\t\t}\n\n\t\tif (this.error?.canUpgrade !== true) {\n\t\t\tthrow new UsageError(\n\t\t\t\t\"Existing stored schema can not be upgraded (see TreeView.canUpgrade).\",\n\t\t\t);\n\t\t}\n\n\t\tconst result = ensureSchema(\n\t\t\tthis.viewSchema,\n\t\t\t// eslint-disable-next-line no-bitwise\n\t\t\tAllowedUpdateType.SchemaCompatible | AllowedUpdateType.Initialize,\n\t\t\tthis.checkout,\n\t\t\tthis.flexConfig,\n\t\t);\n\t\tassert(result, 0x8bf /* Schema upgrade should always work if canUpgrade is set. */);\n\t}\n\n\t/**\n\t * Gets the view is the stored schema is compatible with the view schema,\n\t * otherwise returns an error detailing the schema incompatibility.\n\t */\n\tpublic getViewOrError(): CheckoutFlexTreeView<FlexFieldSchema> | SchematizeError {\n\t\tif (this.disposed) {\n\t\t\tthrow new UsageError(\"Accessed a disposed TreeView.\");\n\t\t}\n\t\tassert(this.view !== undefined, 0x8c0 /* unexpected getViewOrError */);\n\t\treturn this.view;\n\t}\n\n\t/**\n\t * Updates `this.view`.\n\t * Invoked during initialization and when `this.view` needs to be replaced due to stored schema changes.\n\t * Handled re-registering for events to call update in the future.\n\t * @remarks\n\t * This does not check if the view needs to be replaced, it replaces it unconditionally:\n\t * callers should do any checking to detect if its really needed before calling `update`.\n\t */\n\tprivate update(): void {\n\t\t// This implementation avoids making any edits, which prevents it from being invoked reentrantly.\n\t\t// If implicit initialization (or some other edit) is desired, it should be done outside of this method.\n\n\t\tconst compatibility = evaluateUpdate(\n\t\t\tthis.viewSchema,\n\t\t\t// eslint-disable-next-line no-bitwise\n\t\t\tAllowedUpdateType.SchemaCompatible | AllowedUpdateType.Initialize,\n\t\t\tthis.checkout,\n\t\t);\n\t\tthis.disposeView();\n\t\tswitch (compatibility) {\n\t\t\tcase UpdateType.None: {\n\t\t\t\t// Remove event from checkout when view is disposed\n\t\t\t\tthis.view = requireSchema(\n\t\t\t\t\tthis.checkout,\n\t\t\t\t\tthis.viewSchema,\n\t\t\t\t\t() => {\n\t\t\t\t\t\tassert(cleanupCheckOutEvents !== undefined, 0x8c1 /* missing cleanup */);\n\t\t\t\t\t\tcleanupCheckOutEvents();\n\t\t\t\t\t\tthis.view = undefined;\n\t\t\t\t\t\tif (!this.disposed) {\n\t\t\t\t\t\t\tthis.update();\n\t\t\t\t\t\t}\n\t\t\t\t\t},\n\t\t\t\t\tthis.nodeKeyManager,\n\t\t\t\t\tthis.nodeKeyFieldKey,\n\t\t\t\t);\n\n\t\t\t\t// Trigger \"rootChanged\" if the root changes in the future.\n\t\t\t\t// Currently there is no good way to do this as FlexTreeField has no events for changes.\n\t\t\t\t// this.view.flexTree.on(????)\n\t\t\t\t// As a workaround for the above, trigger \"rootChanged\" in \"afterBatch\"\n\t\t\t\t// which isn't the correct time since we normally do events during the batch when the forest is modified, but its better than nothing.\n\t\t\t\t// TODO: provide a better event: this.view.flexTree.on(????)\n\t\t\t\tlet lastRoot = this.root;\n\t\t\t\tconst cleanupCheckOutEvents = this.checkout.events.on(\"afterBatch\", () => {\n\t\t\t\t\tif (lastRoot !== this.root) {\n\t\t\t\t\t\tlastRoot = this.root;\n\t\t\t\t\t\tthis.events.emit(\"rootChanged\");\n\t\t\t\t\t}\n\t\t\t\t});\n\t\t\t\tbreak;\n\t\t\t}\n\t\t\tcase UpdateType.Incompatible:\n\t\t\tcase UpdateType.Initialize:\n\t\t\tcase UpdateType.SchemaCompatible: {\n\t\t\t\tthis.view = new SchematizeError(compatibility);\n\t\t\t\tconst unregister = this.checkout.storedSchema.on(\"afterSchemaChange\", () => {\n\t\t\t\t\tunregister();\n\t\t\t\t\tthis.unregisterCallbacks.delete(unregister);\n\t\t\t\t\tthis.update();\n\t\t\t\t});\n\t\t\t\tthis.unregisterCallbacks.add(unregister);\n\t\t\t\tbreak;\n\t\t\t}\n\t\t\tdefault: {\n\t\t\t\tunreachableCase(compatibility);\n\t\t\t}\n\t\t}\n\t\tthis.events.emit(\"rootChanged\");\n\t}\n\n\tprivate disposeView(): void {\n\t\tif (this.view !== undefined && !(this.view instanceof SchematizeError)) {\n\t\t\tthis.view[disposeSymbol]();\n\t\t\tthis.view = undefined;\n\t\t\tthis.unregisterCallbacks.forEach((unregister) => unregister());\n\t\t}\n\t}\n\n\tpublic get error(): SchematizeError | undefined {\n\t\tconst view = this.getViewOrError();\n\t\treturn view instanceof SchematizeError ? view : undefined;\n\t}\n\n\tpublic [disposeSymbol](): void {\n\t\tthis.getViewOrError();\n\t\tthis.disposed = true;\n\t\tthis.disposeView();\n\t}\n\n\tpublic get root(): TreeFieldFromImplicitField<TRootSchema> {\n\t\tconst view = this.getViewOrError();\n\t\tif (view instanceof SchematizeError) {\n\t\t\tthrow new UsageError(\n\t\t\t\t\"Document is out of schema. Check TreeView.error before accessing TreeView.root.\",\n\t\t\t);\n\t\t}\n\t\treturn getProxyForField(view.flexTree) as TreeFieldFromImplicitField<TRootSchema>;\n\t}\n\n\tpublic set root(newRoot: InsertableTreeFieldFromImplicitField<TRootSchema>) {\n\t\tconst view = this.getViewOrError();\n\t\tif (view instanceof SchematizeError) {\n\t\t\tthrow new UsageError(\n\t\t\t\t\"Document is out of schema. Check TreeView.error before accessing TreeView.root.\",\n\t\t\t);\n\t\t}\n\n\t\tsetField(view.context.root, this.rootFieldSchema, newRoot as InsertableContent);\n\t}\n}\n\nexport class SchematizeError implements SchemaIncompatible {\n\tpublic constructor(public readonly updateType: UpdateType) {}\n\n\tpublic get canUpgrade(): boolean {\n\t\treturn (\n\t\t\tthis.updateType === UpdateType.Initialize ||\n\t\t\tthis.updateType === UpdateType.SchemaCompatible\n\t\t);\n\t}\n\n\tpublic get canInitialize(): boolean {\n\t\treturn this.updateType === UpdateType.Initialize;\n\t}\n}\n\n/**\n * Flex-Tree schematizing layer.\n * Creates a view that self-disposes when stored schema becomes incompatible.\n * This may only be called when the schema is already known to be compatible (typically via ensureSchema).\n */\nexport function requireSchema<TRoot extends FlexFieldSchema>(\n\tcheckout: TreeCheckout,\n\tviewSchema: ViewSchema<TRoot>,\n\tonDispose: () => void,\n\tnodeKeyManager: NodeKeyManager,\n\tnodeKeyFieldKey: FieldKey,\n): CheckoutFlexTreeView<TRoot> {\n\tconst slots = checkout.forest.anchors.slots;\n\tassert(!slots.has(ContextSlot), 0x8c2 /* Cannot create second view from checkout */);\n\n\t{\n\t\tconst compatibility = viewSchema.checkCompatibility(checkout.storedSchema);\n\t\tassert(\n\t\t\tcompatibility.write === Compatibility.Compatible &&\n\t\t\t\tcompatibility.read === Compatibility.Compatible,\n\t\t\t0x8c3 /* requireSchema invoked with incompatible schema */,\n\t\t);\n\t}\n\n\tconst view = new CheckoutFlexTreeView(\n\t\tcheckout,\n\t\tviewSchema.schema,\n\t\tnodeKeyManager,\n\t\tnodeKeyFieldKey,\n\t\tonDispose,\n\t);\n\tassert(slots.has(ContextSlot), 0x90d /* Context should be tracked in slot */);\n\n\tconst unregister = checkout.storedSchema.on(\"afterSchemaChange\", () => {\n\t\tconst compatibility = viewSchema.checkCompatibility(checkout.storedSchema);\n\t\tif (\n\t\t\tcompatibility.write !== Compatibility.Compatible ||\n\t\t\tcompatibility.read !== Compatibility.Compatible\n\t\t) {\n\t\t\tunregister();\n\t\t\tview[disposeSymbol]();\n\t\t}\n\t});\n\n\treturn view;\n}\n"]}

package/lib/shared-tree/sharedTree.d.ts

@@ -5,15 +5,15 @@
 import { IChannelAttributes, IChannelFactory, IChannelServices, IChannelStorageService, IFluidDataStoreRuntime } from "@fluidframework/datastore-definitions";
 import { ISharedObject } from "@fluidframework/shared-object-base";
 import { ICodecOptions } from "../codec/index.js";
-import { TreeStoredSchemaRepository, JsonableTree, TreeStoredSchema } from "../core/index.js";
-import { SharedTreeCore } from "../shared-tree-core/index.js";
+import { JsonableTree, TreeStoredSchema, TreeStoredSchemaRepository } from "../core/index.js";
 import { FlexFieldSchema, TreeCompressionStrategy } from "../feature-libraries/index.js";
-import { ITree, TreeConfiguration, ImplicitFieldSchema, TreeFieldFromImplicitField, TreeView } from "../simple-tree/index.js";
+import { SharedTreeCore } from "../shared-tree-core/index.js";
+import { ITree, ImplicitFieldSchema, TreeConfiguration, TreeView } from "../simple-tree/index.js";
 import { InitializeAndSchematizeConfiguration } from "./schematizeTree.js";
-import { TreeCheckout } from "./treeCheckout.js";
-import { CheckoutFlexTreeView, FlexTreeView } from "./treeView.js";
 import { SharedTreeChange } from "./sharedTreeChangeTypes.js";
 import { SharedTreeEditBuilder } from "./sharedTreeEditBuilder.js";
+import { TreeCheckout } from "./treeCheckout.js";
+import { CheckoutFlexTreeView, FlexTreeView } from "./treeView.js";
 /**
  * Copy of data from an {@link ISharedTree} at some point in time.
  * @remarks
@@ -74,18 +74,68 @@ export declare class SharedTree extends SharedTreeCore<SharedTreeEditBuilder, Sh
     constructor(id: string, runtime: IFluidDataStoreRuntime, attributes: IChannelAttributes, optionsParam: SharedTreeOptions, telemetryContextPrefix: string);
     contentSnapshot(): SharedTreeContentSnapshot;
     schematizeFlexTree<TRoot extends FlexFieldSchema>(config: InitializeAndSchematizeConfiguration<TRoot>, onDispose: () => void): CheckoutFlexTreeView<TRoot> | undefined;
-    schematize<TRoot extends ImplicitFieldSchema>(config: TreeConfiguration<TRoot>): TreeView<TreeFieldFromImplicitField<TRoot>>;
+    schematize<TRoot extends ImplicitFieldSchema>(config: TreeConfiguration<TRoot>): TreeView<TRoot>;
     protected loadCore(services: IChannelStorageService): Promise<void>;
 }
 /**
+ * Format versions supported by SharedTree.
+ *
+ * Each version documents a required minimum version of the \@fluidframework/tree package.
+ * @internal
+ */
+export declare const SharedTreeFormatVersion: {
+    /**
+     * Requires \@fluidframework/tree \>= 2.0.0.
+     *
+     * @deprecated - FF does not currently plan on supporting this format long-term.
+     * Do not write production documents using this format, as they may not be loadable in the future.
+     */
+    readonly v1: 1;
+    /**
+     * Requires \@fluidframework/tree \>= 2.0.0.
+     */
+    readonly v2: 2;
+};
+/**
+ * Format versions supported by SharedTree.
+ *
+ * Each version documents a required minimum version of the \@fluidframework/tree package.
  * @internal
+ * @privateRemarks
+ * See packages/dds/tree/docs/main/compatibility.md for information on how to add support for a new format.
  */
-export interface SharedTreeOptions extends Partial<ICodecOptions> {
+export type SharedTreeFormatVersion = typeof SharedTreeFormatVersion;
+/**
+ * @internal
+ */
+export type SharedTreeOptions = Partial<ICodecOptions> & Partial<SharedTreeFormatOptions> & {
     /**
      * The {@link ForestType} indicating which forest type should be created for the SharedTree.
      */
     forest?: ForestType;
-    treeEncodeType?: TreeCompressionStrategy;
+};
+/**
+ * Options for configuring the persisted format SharedTree uses.
+ * @internal
+ */
+export interface SharedTreeFormatOptions {
+    /**
+     * See {@link TreeCompressionStrategy}.
+     * default: TreeCompressionStrategy.Compressed
+     */
+    treeEncodeType: TreeCompressionStrategy;
+    /**
+     * The format version SharedTree should use to persist documents.
+     *
+     * This option has compatibility implications for applications using SharedTree.
+     * Each version documents a required minimum version of \@fluidframework/tree.
+     * If this minimum version fails to be met, the SharedTree may fail to load.
+     * To be safe, application authors should verify that they have saturated this version
+     * of \@fluidframework/tree in their ecosystem before changing the format version.
+     *
+     * This option defaults to SharedTreeFormatVersion.v2.
+     */
+    formatVersion: SharedTreeFormatVersion[keyof SharedTreeFormatVersion];
 }
 /**
  * Used to distinguish between different forest types.

package/lib/shared-tree/sharedTree.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sharedTree.d.ts","sourceRoot":"","sources":["../../src/shared-tree/sharedTree.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"sharedTree.d.ts","sourceRoot":"","sources":["../../src/shared-tree/sharedTree.ts"],"names":[],"mappings":"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"}