Merge branch 'main' of https://github.com/microsoft/FluidFramework in…

…to vermadhr/keylessAccessWork

azure/packages/test/scenario-runner/package.json

@@ -98,7 +98,7 @@
 		"@fluidframework/build-tools": "^0.51.0",
 		"@fluidframework/eslint-config-fluid": "^5.6.0",
 		"@types/js-yaml": "^4.0.5",
-		"@types/mocha": "^9.1.1",
+		"@types/mocha": "^10.0.10",
 		"@types/nock": "^9.3.0",
 		"@types/node": "^18.19.0",
 		"@types/sinon": "^17.0.3",

common/lib/common-utils/package.json

@@ -94,7 +94,7 @@
 		"@types/benchmark": "^2.1.0",
 		"@types/jest": "29.5.3",
 		"@types/jest-environment-puppeteer": "2.2.0",
-		"@types/mocha": "^9.1.1",
+		"@types/mocha": "^10.0.10",
 		"@types/node": "^18.19.39",
 		"@types/sinon": "^17.0.3",
 		"benchmark": "^2.1.4",

docs/docs/data-structures/tree/events.mdx

@@ -0,0 +1,44 @@
+---
+title: Events
+sidebar_position: 5
+---
+
+`SharedTree` supports two node level events: `nodeChanged` and `treeChanged`.
+
+Additionally, the `TreeView` object includes 2 events that operate over the whole tree.
+These are `rootChanged` and `commitApplied`.
+
+`rootChanged` fires when the root field (the field that contains the root node) changes.
+That is, if a new root node is assigned or the schema changes.
+This will not fire when the node itself changes.
+
+`changed` fires whenever a change is applied outside of a transaction or when a transaction is committed.
+This is used to get `Revertible` objects to put on the undo or redo stacks.
+See [undo redo support](./undo-redo.mdx) and [Transactions](./transactions.mdx).
+
+## Event Handling
+
+```typescript
+on<K extends keyof TreeChangeEvents>(
+		node: TreeNode,
+		eventName: K,
+		listener: TreeChangeEvents[K],
+	): () => void;
+```
+
+`Tree.on` assigns the specified `listener` function to the specified `eventName` for the specified `node`.
+The `node` can be any node of the tree.
+The `eventName` can be either "treeChanged" or "nodeChanged".
+`nodeChanged` fires whenever one or more properties of the specified node change.
+`treeChanged` fires whenever one or more properties of the specified node or any node in its subtree, change.
+We recommend looking at the documentation of each of the events for more details.
+
+The `Tree.on()` method returns a function that unsubscribes the handler from the event. This method is typically called in clean up code when the node is being removed. For example:
+
+```typescript
+const unsubscribe = Tree.on(myTreeNode, "nodeChanged", () => {...});
+
+// Later at some point when the event subscription is not needed anymore
+unsubscribe();
+
+```