@fluidframework/tree 2.81.0-374083 → 2.81.1

package/src/simple-tree/api/simpleSchemaToJsonSchema.ts

@@ -5,8 +5,28 @@
 
 import { unreachableCase } from "@fluidframework/core-utils/internal";
 import { UsageError } from "@fluidframework/telemetry-utils/internal";
+
 import { ValueSchema } from "../../core/index.js";
 import { copyProperty, hasSingle, type Mutable } from "../../util/index.js";
+import { NodeKind, type TreeNodeSchema } from "../core/index.js";
+import { FieldKind } from "../fieldSchema.js";
+import { LeafNodeSchema } from "../leafNodeSchema.js";
+import {
+	ArrayNodeSchema,
+	isMapNodeSchema,
+	isRecordNodeSchema,
+	ObjectNodeSchema,
+} from "../node-kinds/index.js";
+import type {
+	SimpleArrayNodeSchema,
+	SimpleLeafNodeSchema,
+	SimpleMapNodeSchema,
+	SimpleRecordNodeSchema,
+} from "../simpleSchema.js";
+import type { TreeSchema } from "../treeSchema.js";
+
+import { KeyEncodingOptions } from "./customTree.js";
+import type { TreeSchemaEncodingOptions } from "./getJsonSchema.js";
 import type {
 	JsonArrayNodeSchema,
 	JsonFieldSchema,
@@ -20,24 +40,6 @@ import type {
 	JsonLeafSchemaType,
 	JsonRecordNodeSchema,
 } from "./jsonSchema.js";
-import { FieldKind } from "../fieldSchema.js";
-import type {
-	SimpleArrayNodeSchema,
-	SimpleLeafNodeSchema,
-	SimpleMapNodeSchema,
-	SimpleRecordNodeSchema,
-} from "../simpleSchema.js";
-import { NodeKind, type TreeNodeSchema } from "../core/index.js";
-import type { TreeSchema } from "../treeSchema.js";
-import type { TreeSchemaEncodingOptions } from "./getJsonSchema.js";
-import {
-	ArrayNodeSchema,
-	isMapNodeSchema,
-	isRecordNodeSchema,
-	ObjectNodeSchema,
-} from "../node-kinds/index.js";
-import { LeafNodeSchema } from "../leafNodeSchema.js";
-import { KeyEncodingOptions } from "./customTree.js";
 
 /**
  * Generates a JSON Schema representation from a simple tree schema.

package/src/simple-tree/api/simpleTreeIndex.ts

@@ -4,6 +4,7 @@
  */
 
 import { fail } from "@fluidframework/core-utils/internal";
+
 import type {
 	AnchorNode,
 	FieldKey,
@@ -19,18 +20,19 @@ import {
 	type TreeIndexKey,
 	type KeyFinder,
 } from "../../feature-libraries/index.js";
+import type { SchematizingSimpleTreeView } from "../../shared-tree/index.js";
 import { brand } from "../../util/index.js";
-import type { ImplicitFieldSchema } from "../fieldSchema.js";
 import {
 	treeNodeFromAnchor,
 	type TreeNode,
 	type TreeNodeSchema,
 	type NodeFromSchema,
 } from "../core/index.js";
-import { treeNodeApi } from "./treeNodeApi.js";
-import type { TreeView } from "./tree.js";
+import type { ImplicitFieldSchema } from "../fieldSchema.js";
 import { walkFieldSchema } from "../walkFieldSchema.js";
-import type { SchematizingSimpleTreeView } from "../../shared-tree/index.js";
+
+import type { TreeView } from "./tree.js";
+import { treeNodeApi } from "./treeNodeApi.js";
 
 /**
  * A {@link TreeIndex} that returns tree nodes given their associated keys.

package/src/simple-tree/api/snapshotCompatibilityChecker.ts

@@ -3,14 +3,16 @@
  * Licensed under the MIT License.
  */
 
-import * as semver from "semver-ts";
 import { assert, transformMapValues } from "@fluidframework/core-utils/internal";
-import { UsageError } from "@fluidframework/telemetry-utils/internal";
 import { selectVersionRoundedDown } from "@fluidframework/runtime-utils/internal";
+import { UsageError } from "@fluidframework/telemetry-utils/internal";
+import * as semver from "semver-ts";
+
 import type { JsonCompatibleReadOnly } from "../../util/index.js";
 import { toInitialSchema } from "../toStoredSchema.js";
-import { TreeViewConfigurationAlpha, TreeViewConfiguration } from "./configuration.js";
 import { createTreeSchema } from "../treeSchema.js";
+
+import { TreeViewConfigurationAlpha, TreeViewConfiguration } from "./configuration.js";
 import { SchemaCompatibilityTester } from "./schemaCompatibilityTester.js";
 import { generateSchemaFromSimpleSchema } from "./schemaFromSimple.js";
 import {
@@ -398,7 +400,7 @@ export function checkSchemaCompatibilitySnapshots(
 	const compatibilityErrors: string[] = [];
 
 	function updatableError(message: string): void {
-		assert(mode === "test", "updatableError should only be called in test mode");
+		assert(mode === "test", 0xcc6 /* updatableError should only be called in test mode */);
 		compatibilityErrors.push(
 			`${message} If this is expected, checkSchemaCompatibilitySnapshots can be rerun in "update" mode to update the snapshot.`,
 		);
@@ -512,7 +514,7 @@ export function checkSchemaCompatibilitySnapshots(
 			if (selectedMinVersionForCollaborationSnapshot === undefined) {
 				assert(
 					compatibilityErrors.length > 0,
-					"expected compatibility errors for missing min collab version snapshot",
+					0xcc7 /* expected compatibility errors for missing min collab version snapshot */,
 				);
 			} else {
 				// Collaboration with this version is expected to work.

package/src/simple-tree/api/storedSchema.ts

@@ -4,6 +4,7 @@
  */
 
 import type { MinimumVersionForCollab } from "@fluidframework/runtime-definitions/internal";
+
 import {
 	FluidClientVersion,
 	FormatValidatorNoOp,
@@ -19,8 +20,8 @@ import type { JsonCompatible } from "../../util/index.js";
 import type { SchemaUpgrade } from "../core/index.js";
 import { normalizeFieldSchema, type ImplicitFieldSchema } from "../fieldSchema.js";
 import { toStoredSchema } from "../toStoredSchema.js";
-import { TreeViewConfigurationAlpha } from "./configuration.js";
 
+import { TreeViewConfigurationAlpha } from "./configuration.js";
 import { SchemaCompatibilityTester } from "./schemaCompatibilityTester.js";
 import type { SchemaCompatibilityStatus } from "./tree.js";
 

package/src/simple-tree/api/tree.ts

@@ -16,6 +16,7 @@ import type {
 	// eslint-disable-next-line @typescript-eslint/no-unused-vars, unused-imports/no-unused-imports
 	TreeAlpha,
 } from "../../shared-tree/index.js";
+import type { JsonCompatibleReadOnly } from "../../util/index.js";
 import type {
 	ImplicitFieldSchema,
 	InsertableField,
@@ -24,8 +25,8 @@ import type {
 	ReadSchema,
 	TreeFieldFromImplicitField,
 } from "../fieldSchema.js";
-import type { UnsafeUnknownSchema } from "../unsafeUnknownSchema.js";
 import type { SimpleTreeSchema } from "../simpleSchema.js";
+import type { UnsafeUnknownSchema } from "../unsafeUnknownSchema.js";
 
 import type { TreeViewConfiguration } from "./configuration.js";
 import type {
@@ -36,7 +37,6 @@ import type {
 	VoidTransactionCallbackStatus,
 } from "./transactionTypes.js";
 import type { VerboseTree } from "./verboseTree.js";
-import type { JsonCompatibleReadOnly } from "../../util/index.js";
 
 /**
  * A tree from which a {@link TreeView} can be created.

package/src/simple-tree/api/treeBeta.ts

@@ -32,14 +32,14 @@ import {
 	unhydratedFlexTreeFromInsertable,
 	type InsertableContent,
 } from "../unhydratedFlexTreeFromInsertable.js";
+import type { InsertableField, UnsafeUnknownSchema } from "../unsafeUnknownSchema.js";
 
-import { createFromCursor } from "./create.js";
 import { conciseFromCursor, type ConciseTree } from "./conciseTree.js";
+import { createFromCursor } from "./create.js";
 import type { TreeEncodingOptions } from "./customTree.js";
-import { cursorFromVerbose } from "./verboseTree.js";
 import type { TreeChangeEvents } from "./treeChangeEvents.js";
 import { treeNodeApi } from "./treeNodeApi.js";
-import type { InsertableField, UnsafeUnknownSchema } from "../unsafeUnknownSchema.js";
+import { cursorFromVerbose } from "./verboseTree.js";
 
 // Tests for this file are grouped with those for treeNodeApi.ts as that is where this functionality will eventually land,
 // and where most of the actual implementation is for much of it.

package/src/simple-tree/api/treeNodeApi.ts

@@ -3,22 +3,14 @@
  * Licensed under the MIT License.
  */
 
+import type { Off } from "@fluidframework/core-interfaces";
 import { assert, oob, fail, unreachableCase } from "@fluidframework/core-utils/internal";
+import { isFluidHandle } from "@fluidframework/runtime-utils/internal";
+import { UsageError } from "@fluidframework/telemetry-utils/internal";
 
 import { EmptyKey, rootFieldKey } from "../../core/index.js";
 import { type TreeStatus, isTreeValue, FieldKinds } from "../../feature-libraries/index.js";
 import { extractFromOpaque } from "../../util/index.js";
-import { type ImplicitFieldSchema, FieldSchema } from "../fieldSchema.js";
-import {
-	booleanSchema,
-	handleSchema,
-	nullSchema,
-	numberSchema,
-	stringSchema,
-} from "../leafNodeSchema.js";
-import { isFluidHandle } from "@fluidframework/runtime-utils/internal";
-import { UsageError } from "@fluidframework/telemetry-utils/internal";
-import type { Off } from "@fluidframework/core-interfaces";
 import {
 	getKernel,
 	isTreeNode,
@@ -34,9 +26,18 @@ import {
 	type TreeNodeFromImplicitAllowedTypes,
 	normalizeAllowedTypes,
 } from "../core/index.js";
-import type { TreeChangeEvents } from "./treeChangeEvents.js";
-import { isArrayNodeSchema, isObjectNodeSchema } from "../node-kinds/index.js";
+import { type ImplicitFieldSchema, FieldSchema } from "../fieldSchema.js";
 import { tryGetTreeNodeForField } from "../getTreeNodeForField.js";
+import {
+	booleanSchema,
+	handleSchema,
+	nullSchema,
+	numberSchema,
+	stringSchema,
+} from "../leafNodeSchema.js";
+import { isArrayNodeSchema, isObjectNodeSchema } from "../node-kinds/index.js";
+
+import type { TreeChangeEvents } from "./treeChangeEvents.js";
 
 /**
  * Provides various functions for analyzing {@link TreeNode}s.

package/src/simple-tree/api/typesUnsafe.ts

@@ -8,14 +8,6 @@ import type {
 	RestrictiveStringRecord,
 	UnionToIntersection,
 } from "../../util/index.js";
-
-import type {
-	ApplyKind,
-	ApplyKindInput,
-	FieldKind,
-	FieldSchema,
-	FieldSchemaAlpha,
-} from "../fieldSchema.js";
 import type {
 	NodeKind,
 	WithType,
@@ -32,6 +24,13 @@ import type {
 	AnnotatedAllowedType,
 	AnnotatedAllowedTypes,
 } from "../core/index.js";
+import type {
+	ApplyKind,
+	ApplyKindInput,
+	FieldKind,
+	FieldSchema,
+	FieldSchemaAlpha,
+} from "../fieldSchema.js";
 import type { TreeArrayNode } from "../node-kinds/index.js";
 import type {
 	SchemaType,

package/src/simple-tree/api/verboseTree.ts

@@ -4,8 +4,8 @@
  */
 
 import type { IFluidHandle } from "@fluidframework/core-interfaces";
-import { isFluidHandle } from "@fluidframework/runtime-utils/internal";
 import { assert, fail } from "@fluidframework/core-utils/internal";
+import { isFluidHandle } from "@fluidframework/runtime-utils/internal";
 import { UsageError } from "@fluidframework/telemetry-utils/internal";
 
 import {
@@ -18,15 +18,16 @@ import {
 	type ITreeCursorSynchronous,
 	type TreeNodeStoredSchema,
 } from "../../core/index.js";
-import { brand } from "../../util/index.js";
-import type { ImplicitFieldSchema } from "../fieldSchema.js";
-import type { Context, TreeLeafValue, TreeNodeSchema } from "../core/index.js";
 import {
 	isTreeValue,
 	stackTreeFieldCursor,
 	stackTreeNodeCursor,
 	type CursorAdapter,
 } from "../../feature-libraries/index.js";
+import { brand } from "../../util/index.js";
+import type { Context, TreeLeafValue, TreeNodeSchema } from "../core/index.js";
+import { getUnhydratedContext } from "../createContext.js";
+import type { ImplicitFieldSchema } from "../fieldSchema.js";
 import {
 	booleanSchema,
 	handleSchema,
@@ -35,6 +36,7 @@ import {
 	stringSchema,
 } from "../leafNodeSchema.js";
 import { isObjectNodeSchema } from "../node-kinds/index.js";
+
 import {
 	customFromCursor,
 	KeyEncodingOptions,
@@ -45,7 +47,6 @@ import {
 	type SchemalessParseOptions,
 	type TreeEncodingOptions,
 } from "./customTree.js";
-import { getUnhydratedContext } from "../createContext.js";
 
 /**
  * Verbose encoding of a {@link TreeNode} or {@link TreeLeafValue}.

package/src/simple-tree/core/allowedTypes.ts

@@ -3,13 +3,12 @@
  * Licensed under the MIT License.
  */
 
-import { UsageError } from "@fluidframework/telemetry-utils/internal";
-import { Lazy } from "@fluidframework/core-utils/internal";
-
 import {
 	type ErasedBaseType,
 	ErasedTypeImplementation,
 } from "@fluidframework/core-interfaces/internal";
+import { Lazy } from "@fluidframework/core-utils/internal";
+import { UsageError } from "@fluidframework/telemetry-utils/internal";
 
 import {
 	getOrCreate,
@@ -17,6 +16,8 @@ import {
 	type IsUnion,
 	type MakeNominal,
 } from "../../util/index.js";
+import type { SchemaType, SimpleAllowedTypeAttributes } from "../simpleSchema.js";
+
 import { isLazy, type FlexListToUnion, type LazyItem } from "./flexList.js";
 import {
 	NodeKind,
@@ -25,7 +26,6 @@ import {
 	type TreeNodeSchema,
 } from "./treeNodeSchema.js";
 import { schemaAsTreeNodeValid } from "./treeNodeValid.js";
-import type { SchemaType, SimpleAllowedTypeAttributes } from "../simpleSchema.js";
 
 /**
  * Schema for types allowed in some location in a tree (like a field, map entry or array).

package/src/simple-tree/core/context.ts

@@ -9,8 +9,8 @@ import type {
 	FlexTreeHydratedContext,
 } from "../../feature-libraries/index.js";
 import { brand } from "../../util/index.js";
-import type { AllowedTypesFullEvaluated } from "./allowedTypes.js";
 
+import type { AllowedTypesFullEvaluated } from "./allowedTypes.js";
 import type { TreeNodeSchema } from "./treeNodeSchema.js";
 import { walkAllowedTypes } from "./walkSchema.js";
 

package/src/simple-tree/core/treeNode.ts

@@ -6,11 +6,11 @@
 import { assert } from "@fluidframework/core-utils/internal";
 import { UsageError } from "@fluidframework/telemetry-utils/internal";
 
+import { markEager } from "./flexList.js";
 import { tryGetTreeNodeSchema } from "./treeNodeKernel.js";
 import { NodeKind, type TreeNodeSchemaClass } from "./treeNodeSchema.js";
 // eslint-disable-next-line import-x/no-deprecated
 import { type WithType, typeNameSymbol, type typeSchemaSymbol } from "./withType.js";
-import { markEager } from "./flexList.js";
 
 /**
  * A non-{@link NodeKind.Leaf|leaf} SharedTree node. Includes objects, arrays, and maps.

package/src/simple-tree/core/treeNodeKernel.ts

@@ -348,9 +348,7 @@ class KernelEventBuffer implements Listenable<KernelEvents> {
 	/**
 	 * Listen to {@link flushEventsEmitter} to know when to flush buffered events.
 	 */
-	readonly #disposeOnFlushListener = flushEventsEmitter.on("flush", () => {
-		this.flush();
-	});
+	readonly #disposeOnFlushListener = flushEventsEmitter.on("flush", this.flush.bind(this));
 
 	readonly #events = createEmitter<KernelEvents>();
 

package/src/simple-tree/core/treeNodeSchema.ts

@@ -3,18 +3,19 @@
  * Licensed under the MIT License.
  */
 
-import { assert } from "@fluidframework/core-utils/internal";
 import type { IFluidHandle } from "@fluidframework/core-interfaces";
+import { assert } from "@fluidframework/core-utils/internal";
 
-import type { SimpleNodeSchemaBase } from "./simpleNodeSchemaBase.js";
-import type { TreeNode } from "./treeNode.js";
-import type { InternalTreeNode, Unhydrated } from "./types.js";
+import type { FieldKey, NodeData } from "../../core/index.js";
 import type { UnionToIntersection } from "../../util/index.js";
+import type { FactoryContent } from "../unhydratedFlexTreeFromInsertable.js";
+
 import type { AllowedTypesFullEvaluated, AllowedTypesFull } from "./allowedTypes.js";
 import type { Context } from "./context.js";
-import type { FieldKey, NodeData } from "../../core/index.js";
+import type { SimpleNodeSchemaBase } from "./simpleNodeSchemaBase.js";
+import type { TreeNode } from "./treeNode.js";
+import type { InternalTreeNode, Unhydrated } from "./types.js";
 import type { UnhydratedFlexTreeField } from "./unhydratedFlexTree.js";
-import type { FactoryContent } from "../unhydratedFlexTreeFromInsertable.js";
 
 /**
  * Schema for a {@link TreeNode} or {@link TreeLeafValue}.

package/src/simple-tree/core/treeNodeValid.ts

@@ -8,8 +8,15 @@ import { UsageError } from "@fluidframework/telemetry-utils/internal";
 
 import { type FlexTreeNode, isFlexTreeNode } from "../../feature-libraries/index.js";
 
+import type { AllowedTypesFull } from "./allowedTypes.js";
+import type { SimpleNodeSchemaBase } from "./simpleNodeSchemaBase.js";
 import { inPrototypeChain, privateToken, TreeNode } from "./treeNode.js";
-import { UnhydratedFlexTreeNode } from "./unhydratedFlexTree.js";
+import {
+	getSimpleNodeSchemaFromInnerNode,
+	isTreeNode,
+	TreeNodeKernel,
+	type InnerNode,
+} from "./treeNodeKernel.js";
 import {
 	NodeKind,
 	type TreeNodeSchema,
@@ -17,16 +24,9 @@ import {
 	type TreeNodeSchemaInitializedData,
 	type TreeNodeSchemaPrivateData,
 } from "./treeNodeSchema.js";
-import {
-	getSimpleNodeSchemaFromInnerNode,
-	isTreeNode,
-	TreeNodeKernel,
-	type InnerNode,
-} from "./treeNodeKernel.js";
 import type { InternalTreeNode } from "./types.js";
+import { UnhydratedFlexTreeNode } from "./unhydratedFlexTree.js";
 import { typeSchemaSymbol } from "./withType.js";
-import type { AllowedTypesFull } from "./allowedTypes.js";
-import type { SimpleNodeSchemaBase } from "./simpleNodeSchemaBase.js";
 
 /**
  * Class which all {@link TreeNode}s must extend.