npm - @fluidframework/devtools-core - Versions diffs - 2.71.0 → 2.73.0 - Mend

@fluidframework/devtools-core 2.71.0 → 2.73.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (15) hide show

package/.eslintrc.cjs +1 -1
package/CHANGELOG.md +8 -10
package/dist/data-visualization/DataVisualization.js +1 -1
package/dist/data-visualization/DataVisualization.js.map +1 -1
package/dist/packageVersion.d.ts +1 -1
package/dist/packageVersion.js +1 -1
package/dist/packageVersion.js.map +1 -1
package/lib/data-visualization/DataVisualization.js +1 -1
package/lib/data-visualization/DataVisualization.js.map +1 -1
package/lib/packageVersion.d.ts +1 -1
package/lib/packageVersion.js +1 -1
package/lib/packageVersion.js.map +1 -1
package/package.json +27 -27
package/src/data-visualization/DataVisualization.ts +2 -2
package/src/packageVersion.ts +1 -1

package/.eslintrc.cjs CHANGED Viewed

@@ -22,7 +22,7 @@ module.exports = {
 			plugins: ["chai-expect"],
 			extends: ["plugin:chai-expect/recommended"],
 			rules: {
-				"import/no-nodejs-modules": "off",
+				"import-x/no-nodejs-modules": "off",
 				"unicorn/prefer-module": "off",
 				// Superseded by chai-expect rule

package/CHANGELOG.md CHANGED Viewed

@@ -1,5 +1,13 @@
 # @fluidframework/devtools-core
+## 2.73.0
+Dependency updates only.
+## 2.72.0
+Dependency updates only.
 ## 2.71.0
 Dependency updates only.
@@ -11,7 +19,6 @@ Dependency updates only.
 - Promote core devtools APIs from alpha to beta ([#25695](https://github.com/microsoft/FluidFramework/pull/25695)) [7c8e203249](https://github.com/microsoft/FluidFramework/commit/7c8e20324935717d8f7b599c3ec2a1b570b96ba1)
   The primary devtools APIs may now be imported from `/beta`. This includes:
   - **`initializeDevtools`** - Initialize the devtools singleton
   - **`tryGetFluidDevtools`** - Get the existing devtools instance if initialized
   - **`IFluidDevtools`** - Main devtools interface for registering containers
@@ -133,12 +140,10 @@ Dependency updates only.
   APIs that were never intended for direct consumer use have been marked as `@system`.
   These are:
   - HasContainerKey
   APIs that were not intended to be extended by consumers have been marked as `@sealed`.
   These are:
   - ContainerDevtoolsProps
   - DevtoolsProps
   - HasContainerKey
@@ -159,7 +164,6 @@ Dependency updates only.
   Similarly, `IDeltaManager.outbound` contained functionality that could break core runtime features such as generation of batches and chunking. Data loss or corruption could occur when `IDeltaManger.inbound.pause()` or `IDeltaManager.inbound.resume()` were called.
   #### Alternatives
   - Alternatives to `IDeltaManager.inbound.on("op", ...)` are `IDeltaManager.on("op", ...)`
   - Alternatives to calling `IDeltaManager.inbound.pause`, `IDeltaManager.outbound.pause` for `IContainer` disconnect use `IContainer.disconnect`.
   - Alternatives to calling `IDeltaManager.inbound.resume`, `IDeltaManager.outbound.resume` for `IContainer` reconnect use `IContainer.connect`.
@@ -207,7 +211,6 @@ Dependency updates only.
   TypeScript types and implementation code.
   This means that using Fluid Framework packages require the following TypeScript settings in tsconfig.json:
   - `"moduleResolution": "Node16"` with `"module": "Node16"`
   - `"moduleResolution": "Bundler"` with `"module": "ESNext"`
@@ -246,7 +249,6 @@ Dependency updates only.
   limitation of serialization.
   Additional modifications:
   - `Jsonable`'s `TReplacement` parameter default has also been changed from `void` to `never`, which now disallows
     `void`.
   - Unrecognized primitive types like `symbol` are now filtered to `never` instead of `{}`.
@@ -284,7 +286,6 @@ Dependency updates only.
 - Dependencies on @fluidframework/protocol-definitions package updated to 3.0.0 [871b3493dd](https://github.com/microsoft/FluidFramework/commits/871b3493dd0d7ea3a89be64998ceb6cb9021a04e)
   This included the following changes from the protocol-definitions release:
   - Updating signal interfaces for some planned improvements. The intention is split the interface between signals
     submitted by clients to the server and the resulting signals sent from the server to clients.
     - A new optional type member is available on the ISignalMessage interface and a new ISentSignalMessage interface has
@@ -295,7 +296,6 @@ Dependency updates only.
 - Server upgrade: dependencies on Fluid server packages updated to 2.0.1 [871b3493dd](https://github.com/microsoft/FluidFramework/commits/871b3493dd0d7ea3a89be64998ceb6cb9021a04e)
   Dependencies on the following Fluid server package have been updated to version 2.0.1:
   - @fluidframework/gitresources: 2.0.1
   - @fluidframework/server-kafka-orderer: 2.0.1
   - @fluidframework/server-lambdas: 2.0.1
@@ -320,7 +320,6 @@ Dependency updates only.
 - test-utils: provideEntryPoint is required [871b3493dd](https://github.com/microsoft/FluidFramework/commits/871b3493dd0d7ea3a89be64998ceb6cb9021a04e)
   The optional `provideEntryPoint` method has become required on a number of constructors. A value will need to be provided to the following classes:
   - `BaseContainerRuntimeFactory`
   - `RuntimeFactory`
   - `ContainerRuntime` (constructor and `loadRuntime`)
@@ -353,7 +352,6 @@ Dependency updates only.
   The **@fluidframework/common-definitions** package is being deprecated, so the following interfaces and types are now
   imported from the **@fluidframework/core-interfaces** package:
   - interface IDisposable
   - interface IErrorEvent
   - interface IErrorEvent

package/dist/data-visualization/DataVisualization.js CHANGED Viewed

@@ -311,7 +311,7 @@ async function visualizeChildData(data, resolveHandle) {
             nodeKind: VisualTree_js_1.VisualNodeKind.ValueNode,
         };
     }
-    // eslint-disable-next-line import/no-deprecated
+    // eslint-disable-next-line import-x/no-deprecated
     if (data?.IFluidHandle !== undefined) {
         // If we encounter a Fluid handle, register it for future rendering, and return a node with its ID.
         const handle = data;

package/dist/data-visualization/DataVisualization.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"DataVisualization.js","sourceRoot":"","sources":["../../src/data-visualization/DataVisualization.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH,sDAAsD;AACtD,uEAAuE;AAEvE,+DAAiE;AACjE,gEAA+E;AAa/E,4DAA4D;AAE5D,mEAIiC;AACjC,mDAQyB;AA0FzB;;;;;;;;;;;GAWG;AACH,MAAa,mBACZ,SAAQ,gCAAuC;IAwB/C;IACC;;OAEG;IACc,QAAwC;IAEzD;;OAEG;IACc,WAAoC;QAErD,KAAK,EAAE,CAAC;QAPS,aAAQ,GAAR,QAAQ,CAAgC;QAKxC,gBAAW,GAAX,WAAW,CAAyB;QAlBtD;;;WAGG;QACc,0BAAqB,GAAG,CAAC,UAA2B,EAAW,EAAE;YACjF,IAAI,CAAC,gBAAgB,CAAC,UAAU,CAAC,CAAC;YAClC,OAAO,IAAI,CAAC;QACb,CAAC,CAAC;QAeD,IAAI,CAAC,eAAe,GAAG,IAAI,GAAG,EAAiC,CAAC;QAEhE,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC;IACxB,CAAC;IAED;;OAEG;IACH,IAAW,QAAQ;QAClB,OAAO,IAAI,CAAC,SAAS,CAAC;IACvB,CAAC;IAED;;OAEG;IACK,gBAAgB,CAAC,UAA2B;QACnD,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IACjC,CAAC;IAED;;;OAGG;IACI,KAAK,CAAC,iBAAiB;QAC7B,0HAA0H;QAE1H,sGAAsG;QACtG,0FAA0F;QAC1F,MAAM,eAAe,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAEtD,MAAM,MAAM,GAAmC,EAAE,CAAC;QAClD,MAAM,OAAO,CAAC,GAAG,CAChB,eAAe,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE;YAC1C,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;gBAChC,OAAO,CAAC,KAAK,CACZ,wDAAwD,GAAG,qBAAqB,CAChF,CAAC;gBACF,MAAM,CAAC,GAAG,CAAC,GAAG,iCAAiB,CAAC;YACjC,CAAC;iBAAM,CAAC;gBACP,MAAM,aAAa,GAAG,MAAM,IAAI,CAAC,2BAA2B,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;gBAC3E,MAAM,CAAC,GAAG,CAAC;oBACV,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,iCAAiB,CAAC,CAAC,CAAC,IAAA,gCAAgB,EAAC,aAAa,CAAC,CAAC;YACpF,CAAC;QACF,CAAC,CAAC,CACF,CAAC;QACF,OAAO,MAAM,CAAC;IACf,CAAC;IAED;;;OAGG;IACI,KAAK,CAAC,MAAM,CAAC,aAA4B;QAC/C,2FAA2F;QAC3F,+FAA+F;QAC/F,4DAA4D;QAC5D,OAAO,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,aAAa,CAAC,EAAE,MAAM,EAAE,IAAI,SAAS,CAAC;IACvE,CAAC;IAED;;;OAGG;IACK,uCAAuC,CAC9C,kBAA2C;QAE3C,gDAAgD;QAChD,MAAM,SAAS,GAAG,YAAY,CAAC,kBAAkB,CAAC,CAAC;QACnD,MAAM,aAAa,GAAG,gBAAgB,CAAC,kBAAkB,CAAC,CAAC;QAE3D,IAAI,qBAA4C,CAAC;QACjD,IAAI,gBAA+B,CAAC;QACpC,IAAI,QAAuB,CAAC;QAE5B,IAAI,SAAS,EAAE,CAAC;YACf,gBAAgB,GAAI,kBAAqE;iBACvF,IAAI,CAAC;YACP,QAAQ,GAAG,IAAA,wCAAoB,EAAC,gBAAgB,CAAC,CAAC;YAClD,qBAAqB,GAAG,2CAAmB,CAAC;QAC7C,CAAC;aAAM,IAAI,aAAa,EAAE,CAAC;YAC1B,gBAAgB,GAAI,kBAAkE;iBACpF,IAAI,CAAC;YACP,QAAQ,GAAG,IAAA,wCAAoB,EAAC,gBAAgB,CAAC,CAAC;YAClD,qBAAqB,GAAG,+CAAuB,CAAC;QACjD,CAAC;aAAM,CAAC;YACP,gBAAgB,GAAG,kBAAkB,CAAC;YACtC,QAAQ,GAAG,IAAA,wCAAoB,EAAC,kBAAkB,CAAC,CAAC;YACpD,qBAAqB;gBACnB,IAAI,CAAC,WAAW,CAAC,kBAAkB,CAAC,UAAU,CAAC,IAAI,CAA2B;oBAC/E,oDAA4B,CAAC;QAC/B,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;YACzC,MAAM,cAAc,GAAG,IAAI,cAAc,CACxC,gBAAgB,EAChB,qBAAqB,EACrB,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,2BAA2B,CAAC,MAAM,CAAC,CAC1D,CAAC;YAEF,2DAA2D;YAC3D,cAAc,CAAC,EAAE,CAAC,QAAQ,EAAE,IAAI,CAAC,qBAAqB,CAAC,CAAC;YAExD,4CAA4C;YAC5C,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC;QACpD,CAAC;QAED,OAAO,QAAQ,CAAC;IACjB,CAAC;IAED;;;;;;;;;;OAUG;IACK,KAAK,CAAC,2BAA2B,CACxC,MAAoB;QAEpB,MAAM,cAAc,GAAG,MAAM,MAAM,CAAC,GAAG,EAAE,CAAC;QAE1C,IAAI,YAAY,CAAC,cAAc,CAAC,IAAI,gBAAgB,CAAC,cAAc,CAAC,EAAE,CAAC;YACtE,OAAO,IAAI,CAAC,uCAAuC,CAAC,cAAc,CAAC,CAAC;QACrE,CAAC;QAED,+CAA+C;QAC/C,MAAM,YAAY,GAAG,cAAwC,CAAC;QAC9D,IAAI,cAAc,CAAC,YAAY,CAAC,EAAE,CAAC;YAClC,OAAO,IAAI,CAAC,uCAAuC,CAAC,YAAY,CAAC,CAAC;QACnE,CAAC;aAAM,CAAC;YACP,gBAAgB;YAChB,OAAO,CAAC,IAAI,CACX,2EAA2E,CAC3E,CAAC;YACF,OAAO,SAAS,CAAC;QAClB,CAAC;IACF,CAAC;IAED;;OAEG;IACI,OAAO;QACb,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACrB,4BAA4B;YAC5B,KAAK,MAAM,cAAc,IAAI,IAAI,CAAC,eAAe,CAAC,MAAM,EAAE,EAAE,CAAC;gBAC5D,cAAc,CAAC,OAAO,EAAE,CAAC;YAC1B,CAAC;YACD,IAAI,CAAC,eAAe,CAAC,KAAK,EAAE,CAAC;YAE7B,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QACvB,CAAC;IACF,CAAC;CACD;AAlMD,kDAkMC;AAED;;;;;;;;;;GAUG;AACH,MAAa,cACZ,SAAQ,gCAAuC;IA8B/C;IACC;;OAEG;IACa,YAA2B;IAE3C;;;OAGG;IACc,qBAA4C;IAE7D;;;;;;;;OAQG;IACc,cAEsB;QAEvC,KAAK,EAAE,CAAC;QArBQ,iBAAY,GAAZ,YAAY,CAAe;QAM1B,0BAAqB,GAArB,qBAAqB,CAAuB;QAW5C,mBAAc,GAAd,cAAc,CAEQ;QAlDxC;;;;WAIG;QACc,gBAAW,GAAG,KAAK,IAAsB,EAAE;YAC3D,IAAI,CAAC;gBACJ,MAAM,IAAI,CAAC,gBAAgB,EAAE,CAAC;gBAC9B,OAAO,IAAI,CAAC;YACb,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBAChB,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;gBACrB,OAAO,KAAK,CAAC;YACd,CAAC;QACF,CAAC,CAAC;QAOF;;WAEG;QACc,kBAAa,GAAG,GAAS,EAAE;YAC3C,IAAI,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;QAC3D,CAAC,CAAC;QA6BD,IAAI,CAAC,YAAY,CAAC,EAAE,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC;QAEjD,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC;IACxB,CAAC;IAED;;OAEG;IACH,IAAW,QAAQ;QAClB,OAAO,IAAI,CAAC,SAAS,CAAC;IACvB,CAAC;IAED;;;;OAIG;IACK,KAAK,CAAC,gBAAgB;QAC7B,IAAI,CAAC;YACJ,MAAM,UAAU,GAAoB,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC;YACxD,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;QACjC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACpB,CAAC;IACF,CAAC;IAED;;;;;;;;;;OAUG;IACI,KAAK,CAAC,MAAM;QAClB,OAAO,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,YAAY,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,CACnE,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,CAC1B,CAAC;IACH,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,eAAe,CAAC,IAAa;QAC1C,OAAO,kBAAkB,CAAC,IAAI,EAAE,IAAI,CAAC,cAAc,CAAC,CAAC;IACtD,CAAC;IAED;;OAEG;IACI,OAAO;QACb,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACrB,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC;YAChD,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QACvB,CAAC;IACF,CAAC;CACD;AArHD,wCAqHC;AAED;;;;;;;;GAQG;AACI,KAAK,UAAU,kBAAkB,CACvC,IAAa,EACb,aAA2E;IAE3E,8DAA8D;IAC9D,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;QACnB,OAAO;YACN,KAAK,EAAE,IAAI;YACX,YAAY,EAAE,MAAM;YACpB,QAAQ,EAAE,8BAAc,CAAC,SAAS;SAClC,CAAC;IACH,CAAC;IAED,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,OAAO,IAAI,KAAK,UAAU,EAAE,CAAC;QAC5D,oEAAoE;QACpE,OAAO;YACN,KAAK,EAAE,IAAiB;YACxB,YAAY,EAAE,OAAO,IAAI;YACzB,QAAQ,EAAE,8BAAc,CAAC,SAAS;SAClC,CAAC;IACH,CAAC;IAED,gDAAgD;IAChD,IAAK,IAA4B,EAAE,YAAY,KAAK,SAAS,EAAE,CAAC;QAC/D,mGAAmG;QACnG,MAAM,MAAM,GAAG,IAAoB,CAAC;QACpC,MAAM,aAAa,GAAG,MAAM,aAAa,CAAC,MAAM,CAAC,CAAC;QAClD,2DAA2D;QAC3D,mGAAmG;QACnG,OAAO,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,iCAAiB,CAAC,CAAC,CAAC,IAAA,gCAAgB,EAAC,aAAa,CAAC,CAAC;IAC1F,CAAC;IAED,gGAAgG;IAChG,oCAAoC;IACpC,MAAM,YAAY,GAAG,MAAM,CAAC,OAAO,CAAC,IAAiD,CAAC,CAAC;IAEvF,MAAM,QAAQ,GAAoC,EAAE,CAAC;IACrD,MAAM,OAAO,CAAC,GAAG,CAChB,YAAY,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE;QACvC,MAAM,SAAS,GAAG,MAAM,kBAAkB,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC;QACjE,QAAQ,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC;IAC3B,CAAC,CAAC,CACF,CAAC;IAEF,OAAO;QACN,QAAQ;QACR,QAAQ,EAAE,8BAAc,CAAC,QAAQ;QACjC,YAAY,EAAE,QAAQ;KACtB,CAAC;AACH,CAAC;AAjDD,gDAiDC;AAED;;;GAGG;AACH,SAAS,cAAc,CAAC,KAAc;IACrC,OAAO,CACL,KAAsB,CAAC,EAAE,KAAK,SAAS;QACvC,KAAsB,CAAC,UAAU,EAAE,IAAI,KAAK,SAAS;QACrD,KAAsB,CAAC,EAAE,KAAK,SAAS,CACxC,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,SAAS,YAAY,CAAC,KAAc;IACnC,IACC,KAAK,YAAY,qBAAU;QAC3B,CAAC,OAAQ,KAAoB,CAAC,kBAAkB,KAAK,UAAU;YAC9D,OAAQ,KAAmD;iBACzD,2BAA2B,CAAC,KAAK,UAAU,EAC7C,CAAC;QACF,gEAAgE;QAChE,MAAM,IAAI,GAAI,KAA8C,CAAC,IAAI,CAAC;QAClE,IAAI,CAAC,IAAI,EAAE,CAAC;YACX,MAAM,IAAI,KAAK,CAAC,+DAA+D,CAAC,CAAC;QAClF,CAAC;QAED,OAAO,IAAI,CAAC;IACb,CAAC;IAED,OAAO,KAAK,CAAC;AACd,CAAC;AAED;;;;;;;;;GASG;AACH,SAAS,gBAAgB,CAAC,KAAc;IACvC,IACC,KAAK,YAAY,yBAAc;QAC/B,CAAC,OAAQ,KAAwB,CAAC,kBAAkB,KAAK,UAAU;YAClE,MAAM,CAAC,wBAAwB,CAAC,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,EAAE,GAAG,KAAK,SAAS,CAAC,EACzF,CAAC;QACF,MAAM,IAAI,GAAI,KAA2C,CAAC,IAAI,CAAC;QAC/D,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CAAC,mEAAmE,CAAC,CAAC;QACtF,CAAC;QAED,OAAO,IAAI,CAAC;IACb,CAAC;IAED,OAAO,KAAK,CAAC;AACd,CAAC","sourcesContent":["/!\n Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n /\n\n// Indexed-object style is used to ease documentation.\n/ eslint-disable @typescript-eslint/consistent-indexed-object-style /\n\nimport { TypedEventEmitter } from \"@fluid-internal/client-utils\";\nimport { DataObject, TreeDataObject } from \"@fluidframework/aqueduct/internal\";\nimport type {\n\tIDisposable,\n\tIEvent,\n\tIFluidHandle,\n\tIFluidLoadable,\n} from \"@fluidframework/core-interfaces\";\n// eslint-disable-next-line import/no-deprecated\nimport type { IProvideFluidHandle } from \"@fluidframework/core-interfaces/internal\";\nimport type { ISharedDirectory } from \"@fluidframework/map/internal\";\nimport type { ISharedObject, SharedObject } from \"@fluidframework/shared-object-base/internal\";\n\nimport type { FluidObjectId } from \"../CommonInterfaces.js\";\nimport { getKeyForFluidObject } from \"../FluidObjectKey.js\";\n\nimport {\n\tvisualizeDataObject,\n\tvisualizeTreeDataObject,\n\tvisualizeUnknownSharedObject,\n} from \"./DefaultVisualizers.js\";\nimport {\n\ttype FluidObjectNode,\n\ttype Primitive,\n\ttype RootHandleNode,\n\ttype VisualChildNode,\n\tVisualNodeKind,\n\tcreateHandleNode,\n\tunknownObjectNode,\n} from \"./VisualTree.js\";\n\n// Ideas:\n// - Hold onto previous summary and only transmit diff?\n\n// TODOs:\n// - Dependency tracking\n// - When a particular DDS is no longer reachable via the input data, we need to remove it from the map and stop\n// emitting updates.\n\n/\n The type of a shared object.\n \n @remarks\n \n This can be acquired via {@link @fluidframework/datastore-definitions#IChannelFactory.Type} field of\n * your shared object's factory class.\n /\nexport type SharedObjectType = string;\n\n/\n Generates a visual description of the provided {@link @fluidframework/shared-object-base#ISharedObject}'s\n * current state.\n \n @param sharedObject - The object whose data will be rendered.\n * @param visualizeChildData - Callback to render child content of the shared object.\n \n @returns A visual tree representation of the provided `sharedObject`.\n \n @internal\n /\nexport type VisualizeSharedObject = (\n\tsharedObject: ISharedObject,\n\tvisualizeChildData: VisualizeChildData,\n) => Promise<FluidObjectNode>;\n\n/\n Recursively renders child contents of a {@link @fluidframework/shared-object-base#ISharedObject}.\n \n @param data - The child data to render.\n * Since this is child data of a DDS (and must be serializable), we know that it must be one of the following:\n \n - Primitive data\n \n - A serializable Record\n \n - A handle to another Fluid object\n \n @returns A visual tree representation of the input `data`.\n \n @internal\n /\nexport type VisualizeChildData = (data: unknown) => Promise<VisualChildNode>;\n\n/\n Utility type for a union of things that can be visualized.\n /\nexport type VisualizableFluidObject = ISharedObject \| DataObject \| TreeDataObject;\n\n/\n Specifies renderers for different {@link @fluidframework/shared-object-base#ISharedObject} types.\n \n @remarks\n \n - `key`: The type of Shared object ({@link @fluidframework/datastore-definitions#IChannelFactory.Type}).\n \n - `value`: A renderer that takes a {@link @fluidframework/shared-object-base#ISharedObject} of the\n * specified type and generates a corresponding {@link VisualizerNode} for it.\n /\nexport interface SharedObjectVisualizers {\n\t/\n\t Individual Fluid object visualizers, keyed by {@link SharedObjectType}.\n\t /\n\t[k: SharedObjectType]: VisualizeSharedObject;\n}\n\n/\n Data visualization update events.\n /\nexport interface DataVisualizerEvents extends IEvent {\n\t/\n\t Emitted whenever the associated {@link @fluidframework/shared-object-base#ISharedObject}'s data is updated.\n\t \n\t @param visualTree - The updated visual tree representing the shared object's state.\n\t \n\t @eventProperty\n\t /\n\t(event: \"update\", listener: (visualTree: FluidObjectNode) => void): unknown;\n}\n\n/\n Manages {@link VisualizerNode \| visualizers} for shared objects reachable by\n * the provided {@link DataVisualizerGraph.rootData}.\n \n @remarks\n \n {@link VisualizerNode}s are initialized lazily.\n \n Consumers can begin tree visualization by calling {@link DataVisualizerGraph.renderRootHandles}.\n * The returned handle nodes provide the IDs required to make subsequent calls to {@link DataVisualizerGraph.render}\n * to visualize subtrees as needed.\n /\nexport class DataVisualizerGraph\n\textends TypedEventEmitter<DataVisualizerEvents>\n\timplements IDisposable\n{\n\t/\n\t Map of registered {@link VisualizerNode}s, keyed by their corresponding {@link FluidObjectId}.\n\t \n\t @privateRemarks TODO: Dependency tracking so we don't leak memory.\n\t /\n\tprivate readonly visualizerNodes: Map<FluidObjectId, VisualizerNode>;\n\n\t/\n\t Private {@link VisualizerNode.disposed} tracking.\n\t /\n\tprivate _disposed: boolean;\n\n\t/\n\t Handler for a visualizer node's \"update\" event.\n\t * Bubbles up the event to graph subscribers.\n\t /\n\tprivate readonly onVisualUpdateHandler = (visualTree: FluidObjectNode): boolean => {\n\t\tthis.emitVisualUpdate(visualTree);\n\t\treturn true;\n\t};\n\n\tpublic constructor(\n\t\t/\n\t\t {@inheritDoc IContainerDevtools.containerData}\n\t\t /\n\t\tprivate readonly rootData: Record<string, IFluidLoadable>,\n\n\t\t/\n\t\t Policy object for visualizing different kinds of shared objects.\n\t\t /\n\t\tprivate readonly visualizers: SharedObjectVisualizers,\n\t) {\n\t\tsuper();\n\n\t\tthis.visualizerNodes = new Map<FluidObjectId, VisualizerNode>();\n\n\t\tthis._disposed = false;\n\t}\n\n\t/\n\t {@inheritDoc IDisposable.disposed}\n\t /\n\tpublic get disposed(): boolean {\n\t\treturn this._disposed;\n\t}\n\n\t/\n\t Emits a visual tree update from one of the registered visualizer nodes.\n\t /\n\tprivate emitVisualUpdate(visualTree: FluidObjectNode): void {\n\t\tthis.emit(\"update\", visualTree);\n\t}\n\n\t/\n\t Generates and returns visual descriptions ({@link FluidHandleNode}s) for each of the specified\n\t * {@link DataVisualizerGraph.rootData \| root shared objects}.\n\t /\n\tpublic async renderRootHandles(): Promise<Record<string, RootHandleNode>> {\n\t\t// TODO: We should be rendering the DataObject from the root, but this requires change in the devtools package in general.\n\n\t\t// Rendering the root entries amounts to initializing visualizer nodes for each of them, and returning\n\t\t// a list of handle nodes. Consumers can request data for each of these handles as needed.\n\t\tconst rootDataEntries = Object.entries(this.rootData);\n\n\t\tconst result: Record<string, RootHandleNode> = {};\n\t\tawait Promise.all(\n\t\t\trootDataEntries.map(async ([key, value]) => {\n\t\t\t\tif (value.handle === undefined) {\n\t\t\t\t\tconsole.error(\n\t\t\t\t\t\t`Container data includes a non-Fluid object under key ${key}. Cannot visualize!`,\n\t\t\t\t\t);\n\t\t\t\t\tresult[key] = unknownObjectNode;\n\t\t\t\t} else {\n\t\t\t\t\tconst fluidObjectId = await this.registerVisualizerForHandle(value.handle);\n\t\t\t\t\tresult[key] =\n\t\t\t\t\t\tfluidObjectId === undefined ? unknownObjectNode : createHandleNode(fluidObjectId);\n\t\t\t\t}\n\t\t\t}),\n\t\t);\n\t\treturn result;\n\t}\n\n\t/\n\t Generates and returns a visual description of the specified Fluid object if it exists in the graph.\n\t * If no such object exists in the graph, returns `undefined`.\n\t /\n\tpublic async render(fluidObjectId: FluidObjectId): Promise<FluidObjectNode \| undefined> {\n\t\t// If we don't have anything registered for the requested Fluid object, return `undefined`.\n\t\t// This could indicate a stale data request from an external consumer, or could indicate a bug,\n\t\t// but this library isn't capable of telling the difference.\n\t\treturn this.visualizerNodes.get(fluidObjectId)?.render() ?? undefined;\n\t}\n\n\t/\n\t Adds a visualizer node to the collection for the specified\n\t * {@link VisualizableFluidObject} if one does not already exist.\n\t /\n\tprivate registerVisualizerForVisualizableObject(\n\t\tvisualizableObject: VisualizableFluidObject,\n\t): FluidObjectId {\n\t\t// Store type check results to avoid recomputing\n\t\tconst isDataObj = isDataObject(visualizableObject);\n\t\tconst isTreeDataObj = isTreeDataObject(visualizableObject);\n\n\t\tlet visualizationFunction: VisualizeSharedObject;\n\t\tlet rootSharedObject: ISharedObject;\n\t\tlet objectId: FluidObjectId;\n\n\t\tif (isDataObj) {\n\t\t\trootSharedObject = (visualizableObject as unknown as { readonly root: ISharedDirectory })\n\t\t\t\t.root;\n\t\t\tobjectId = getKeyForFluidObject(rootSharedObject);\n\t\t\tvisualizationFunction = visualizeDataObject;\n\t\t} else if (isTreeDataObj) {\n\t\t\trootSharedObject = (visualizableObject as unknown as { readonly tree: ISharedObject })\n\t\t\t\t.tree;\n\t\t\tobjectId = getKeyForFluidObject(rootSharedObject);\n\t\t\tvisualizationFunction = visualizeTreeDataObject;\n\t\t} else {\n\t\t\trootSharedObject = visualizableObject;\n\t\t\tobjectId = getKeyForFluidObject(visualizableObject);\n\t\t\tvisualizationFunction =\n\t\t\t\t(this.visualizers[visualizableObject.attributes.type] as VisualizeSharedObject) ??\n\t\t\t\tvisualizeUnknownSharedObject;\n\t\t}\n\n\t\tif (!this.visualizerNodes.has(objectId)) {\n\t\t\tconst visualizerNode = new VisualizerNode(\n\t\t\t\trootSharedObject,\n\t\t\t\tvisualizationFunction,\n\t\t\t\tasync (handle) => this.registerVisualizerForHandle(handle),\n\t\t\t);\n\n\t\t\t// Register event handler so we can bubble up update events\n\t\t\tvisualizerNode.on(\"update\", this.onVisualUpdateHandler);\n\n\t\t\t// Add the visualizer node to our collection\n\t\t\tthis.visualizerNodes.set(objectId, visualizerNode);\n\t\t}\n\n\t\treturn objectId;\n\t}\n\n\t/\n\t Adds a visualizer node to the collection for the specified {@link @fluidframework/core-interfaces#(IFluidHandle:interface)}\n\t * if one does not already exist.\n\t \n\t @returns\n\t \n\t The ID of object associated with the provided handle, if the handle resolves to a {@link ISharedObject}.\n\t * If the handle resolves to something else, this sytem has no way to reason about it sufficiently to generate\n\t * visual descriptors from it.\n\t * In this case, we return `undefined`.\n\t /\n\tprivate async registerVisualizerForHandle(\n\t\thandle: IFluidHandle,\n\t): Promise<FluidObjectId \| undefined> {\n\t\tconst resolvedObject = await handle.get();\n\n\t\tif (isDataObject(resolvedObject) \|\| isTreeDataObject(resolvedObject)) {\n\t\t\treturn this.registerVisualizerForVisualizableObject(resolvedObject);\n\t\t}\n\n\t\t// TODO: is this the right type check for this?\n\t\tconst sharedObject = resolvedObject as Partial<ISharedObject>;\n\t\tif (isSharedObject(sharedObject)) {\n\t\t\treturn this.registerVisualizerForVisualizableObject(sharedObject);\n\t\t} else {\n\t\t\t// Unknown data.\n\t\t\tconsole.warn(\n\t\t\t\t\"Fluid Handle resolved to data that is not a SharedObject or a DataObject.\",\n\t\t\t);\n\t\t\treturn undefined;\n\t\t}\n\t}\n\n\t/\n\t {@inheritDoc IDisposable.dispose}\n\t /\n\tpublic dispose(): void {\n\t\tif (!this._disposed) {\n\t\t\t// Dispose visualizer nodes.\n\t\t\tfor (const visualizerNode of this.visualizerNodes.values()) {\n\t\t\t\tvisualizerNode.dispose();\n\t\t\t}\n\t\t\tthis.visualizerNodes.clear();\n\n\t\t\tthis._disposed = true;\n\t\t}\n\t}\n}\n\n/\n Wraps a {@link @fluidframework/shared-object-base#ISharedObject} and encapsulates policy for\n * generating visual tree representations of its data.\n \n @remarks\n \n A visual representation can be requested via {@link VisualizerNode.render}.\n \n Additionally, whenever the associated `ISharedObject` is updated (i.e. whenever its \"op\" event is emitted),\n * an updated visual tree will be emitted via this object's {@link SharedObjectListenerEvents \| \"update\" event}.\n /\nexport class VisualizerNode\n\textends TypedEventEmitter<DataVisualizerEvents>\n\timplements IDisposable\n{\n\t/\n\t Handler for {@link VisualizerNode.sharedObject}'s \"op\" event.\n\t * Will broadcast an updated visual tree representation of the DDS's data via the\n\t * {@link SharedObjectListenerEvents \| \"update\"} event.\n\t /\n\tprivate readonly onOpHandler = async (): Promise<boolean> => {\n\t\ttry {\n\t\t\tawait this.emitVisualUpdate();\n\t\t\treturn true;\n\t\t} catch (error) {\n\t\t\tconsole.error(error);\n\t\t\treturn false;\n\t\t}\n\t};\n\n\t/\n\t Private {@link VisualizerNode.disposed} tracking.\n\t /\n\tprivate _disposed: boolean;\n\n\t/\n\t Handles the returned promise for {@link onOpHandler}.\n\t /\n\tprivate readonly syncOpHandler = (): void => {\n\t\tthis.onOpHandler().catch((error) => console.error(error));\n\t};\n\n\tpublic constructor(\n\t\t/\n\t\t The Fluid object whose data will be emitted in visualized form when requested / whenever its data is updated.\n\t\t /\n\t\tpublic readonly sharedObject: ISharedObject,\n\n\t\t/\n\t\t Callback for visualizing {@link VisualizerNode.sharedObject}.\n\t\t * Encapsulates the policies for rendering different kinds of DDSs.\n\t\t /\n\t\tprivate readonly visualizeSharedObject: VisualizeSharedObject,\n\n\t\t/\n\t\t Registers some child handle to a Fluid object for future rendering.\n\t\t \n\t\t @remarks\n\t\t \n\t\t Called during {@link VisualizerNode.render} whenever a Fluid handle is encountered.\n\t\t * Ensures that the consumer of this object's visual tree will be able to request a rendering of the handle's\n\t\t * corresponding DDS as needed.\n\t\t /\n\t\tprivate readonly registerHandle: (\n\t\t\thandle: IFluidHandle,\n\t\t) => Promise<FluidObjectId \| undefined>,\n\t) {\n\t\tsuper();\n\n\t\tthis.sharedObject.on?.(\"op\", this.syncOpHandler);\n\n\t\tthis._disposed = false;\n\t}\n\n\t/\n\t {@inheritDoc IDisposable.disposed}\n\t /\n\tpublic get disposed(): boolean {\n\t\treturn this._disposed;\n\t}\n\n\t/\n\t Emits a {@link VisualizerNode.render \| visual tree representation} of\n\t * {@link VisualizerNode.sharedObject}'s current state as an\n\t * {@link SharedObjectListenerEvents \| \"update\"} event.\n\t /\n\tprivate async emitVisualUpdate(): Promise<void> {\n\t\ttry {\n\t\t\tconst visualTree: FluidObjectNode = await this.render();\n\t\t\tthis.emit(\"update\", visualTree);\n\t\t} catch (error) {\n\t\t\tconsole.log(error);\n\t\t}\n\t}\n\n\t/\n\t Generates a visual description of the associated {@link VisualizerNode.sharedObject}'s\n\t * current state.\n\t \n\t @remarks\n\t \n\t Will recursively render child contents of {@link VisualizerNode.sharedObject}, terminating at\n\t * primitive data and handles to other Fluid objects.\n\t \n\t @returns A visual tree representation of {@link VisualizerNode.sharedObject}.\n\t /\n\tpublic async render(): Promise<FluidObjectNode> {\n\t\treturn this.visualizeSharedObject(this.sharedObject, async (data) =>\n\t\t\tthis.renderChildData(data),\n\t\t);\n\t}\n\n\t/\n\t {@inheritDoc VisualizeChildData}\n\t /\n\tprivate async renderChildData(data: unknown): Promise<VisualChildNode> {\n\t\treturn visualizeChildData(data, this.registerHandle);\n\t}\n\n\t/\n\t {@inheritDoc IDisposable.dispose}\n\t /\n\tpublic dispose(): void {\n\t\tif (!this._disposed) {\n\t\t\tthis.sharedObject.off(\"op\", this.syncOpHandler);\n\t\t\tthis._disposed = true;\n\t\t}\n\t}\n}\n\n/\n See {@link VisualizeChildData}.\n \n @param data - The child data to (recursively) render.\n * @param resolveHandle - Function which accepts an {@link @fluidframework/core-interfaces#(IFluidHandle:interface)}\n * and returns its resolved object ID.\n \n @privateRemarks Exported from this module for testing purposes. This is not intended to be exported by the package.\n /\nexport async function visualizeChildData(\n\tdata: unknown,\n\tresolveHandle: (handle: IFluidHandle) => Promise<FluidObjectId \| undefined>,\n): Promise<VisualChildNode> {\n\t// Special case for `null` because `typeof null === \"object\"`.\n\tif (data === null) {\n\t\treturn {\n\t\t\tvalue: data,\n\t\t\ttypeMetadata: \"null\",\n\t\t\tnodeKind: VisualNodeKind.ValueNode,\n\t\t};\n\t}\n\n\tif (typeof data !== \"object\" && typeof data !== \"function\") {\n\t\t// Render primitives and falsy types via their string representation\n\t\treturn {\n\t\t\tvalue: data as Primitive,\n\t\t\ttypeMetadata: typeof data,\n\t\t\tnodeKind: VisualNodeKind.ValueNode,\n\t\t};\n\t}\n\n\t// eslint-disable-next-line import/no-deprecated\n\tif ((data as IProvideFluidHandle)?.IFluidHandle !== undefined) {\n\t\t// If we encounter a Fluid handle, register it for future rendering, and return a node with its ID.\n\t\tconst handle = data as IFluidHandle;\n\t\tconst fluidObjectId = await resolveHandle(handle);\n\t\t// If no ID was found, then the data is not a SharedObject.\n\t\t// In this case, return an \"Unknown Data\" node so consumers can note this (as desired) to the user.\n\t\treturn fluidObjectId === undefined ? unknownObjectNode : createHandleNode(fluidObjectId);\n\t}\n\n\t// Assume any other data must be a record of some kind (since DDS contents must be serializable)\n\t// and simply recurse over its keys.\n\tconst childEntries = Object.entries(data as Record<string \| number \| symbol, unknown>);\n\n\tconst children: Record<string, VisualChildNode> = {};\n\tawait Promise.all(\n\t\tchildEntries.map(async ([key, value]) => {\n\t\t\tconst childNode = await visualizeChildData(value, resolveHandle);\n\t\t\tchildren[key] = childNode;\n\t\t}),\n\t);\n\n\treturn {\n\t\tchildren,\n\t\tnodeKind: VisualNodeKind.TreeNode,\n\t\ttypeMetadata: \"object\",\n\t};\n}\n\n/\n Determines whether or not the provided value is an {@link ISharedObject}, for the purposes of this library.\n * @remarks Implemented by checking for the particular properties / methods we use in this module.\n /\nfunction isSharedObject(value: unknown): value is ISharedObject {\n\treturn (\n\t\t(value as SharedObject).id !== undefined &&\n\t\t(value as SharedObject).attributes?.type !== undefined &&\n\t\t(value as SharedObject).on !== undefined\n\t);\n}\n\n/\n Determines whether or not the provided value is an {@link DataObject} using `instanceof`, for the purposes of this library.\n * @remarks\n * Uses `instanceof` over checking specific properties or methods, because we decided that a version mix-up with\n * {@link @fluidframework/aqueduct#} is unlikely between devtools and end-user applications, and we don't support it anyway.\n /\nfunction isDataObject(value: unknown): value is DataObject {\n\tif (\n\t\tvalue instanceof DataObject \|\|\n\t\t(typeof (value as DataObject).initializeInternal === \"function\" &&\n\t\t\ttypeof (value as { getUninitializedErrorString(): string })\n\t\t\t\t.getUninitializedErrorString) === \"function\"\n\t) {\n\t\t// If root is missing, throw an error instead of returning false\n\t\tconst root = (value as { readonly root?: ISharedDirectory }).root;\n\t\tif (!root) {\n\t\t\tthrow new Error(\"DataObject must have a `root` property, but it was undefined.\");\n\t\t}\n\n\t\treturn true;\n\t}\n\n\treturn false;\n}\n\n/\n Determines whether or not the provided value is a {@link TreeDataObject} using `instanceof`, for the purposes of this library.\n * @remarks\n * Tries to use `instanceof` because we decided that a version mix-up with\n * {@link @fluidframework/aqueduct#} is unlikely between devtools and end-user applications, and we don't support it anyway.\n * In addition, we check for the presence of key properties that make a `TreeDataObject` unique:\n * - `TreeDataObject.tree` getter\n * - `TreeDataObject.treeView` getter\n * - `TreeDataObject.initializeInternal` method\n */\nfunction isTreeDataObject(value: unknown): value is TreeDataObject {\n\tif (\n\t\tvalue instanceof TreeDataObject \|\|\n\t\t(typeof (value as TreeDataObject).initializeInternal === \"function\" &&\n\t\t\tObject.getOwnPropertyDescriptor(Object.getPrototypeOf(value), \"tree\")?.get !== undefined)\n\t) {\n\t\tconst tree = (value as { readonly tree?: ISharedObject }).tree;\n\t\tif (tree === undefined) {\n\t\t\tthrow new Error(\"TreeDataObject must have a `tree` property, but it was undefined.\");\n\t\t}\n\n\t\treturn true;\n\t}\n\n\treturn false;\n}\n"]}
1	+ {"version":3,"file":"DataVisualization.js","sourceRoot":"","sources":["../../src/data-visualization/DataVisualization.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\n// Indexed-object style is used to ease documentation.\n/ eslint-disable @typescript-eslint/consistent-indexed-object-style /\n\nimport { TypedEventEmitter } from \"@fluid-internal/client-utils\";\nimport { DataObject, TreeDataObject } from \"@fluidframework/aqueduct/internal\";\nimport type {\n\tIDisposable,\n\tIEvent,\n\tIFluidHandle,\n\tIFluidLoadable,\n} from \"@fluidframework/core-interfaces\";\n// eslint-disable-next-line import-x/no-deprecated\nimport type { IProvideFluidHandle } from \"@fluidframework/core-interfaces/internal\";\nimport type { ISharedDirectory } from \"@fluidframework/map/internal\";\nimport type { ISharedObject, SharedObject } from \"@fluidframework/shared-object-base/internal\";\n\nimport type { FluidObjectId } from \"../CommonInterfaces.js\";\nimport { getKeyForFluidObject } from \"../FluidObjectKey.js\";\n\nimport {\n\tvisualizeDataObject,\n\tvisualizeTreeDataObject,\n\tvisualizeUnknownSharedObject,\n} from \"./DefaultVisualizers.js\";\nimport {\n\ttype FluidObjectNode,\n\ttype Primitive,\n\ttype RootHandleNode,\n\ttype VisualChildNode,\n\tVisualNodeKind,\n\tcreateHandleNode,\n\tunknownObjectNode,\n} from \"./VisualTree.js\";\n\n// Ideas:\n// - Hold onto previous summary and only transmit diff?\n\n// TODOs:\n// - Dependency tracking\n// - When a particular DDS is no longer reachable via the input data, we need to remove it from the map and stop\n// emitting updates.\n\n/\n The type of a shared object.\n \n @remarks\n \n This can be acquired via {@link @fluidframework/datastore-definitions#IChannelFactory.Type} field of\n * your shared object's factory class.\n /\nexport type SharedObjectType = string;\n\n/\n Generates a visual description of the provided {@link @fluidframework/shared-object-base#ISharedObject}'s\n * current state.\n \n @param sharedObject - The object whose data will be rendered.\n * @param visualizeChildData - Callback to render child content of the shared object.\n \n @returns A visual tree representation of the provided `sharedObject`.\n \n @internal\n /\nexport type VisualizeSharedObject = (\n\tsharedObject: ISharedObject,\n\tvisualizeChildData: VisualizeChildData,\n) => Promise<FluidObjectNode>;\n\n/\n Recursively renders child contents of a {@link @fluidframework/shared-object-base#ISharedObject}.\n \n @param data - The child data to render.\n * Since this is child data of a DDS (and must be serializable), we know that it must be one of the following:\n \n - Primitive data\n \n - A serializable Record\n \n - A handle to another Fluid object\n \n @returns A visual tree representation of the input `data`.\n \n @internal\n /\nexport type VisualizeChildData = (data: unknown) => Promise<VisualChildNode>;\n\n/\n Utility type for a union of things that can be visualized.\n /\nexport type VisualizableFluidObject = ISharedObject \| DataObject \| TreeDataObject;\n\n/\n Specifies renderers for different {@link @fluidframework/shared-object-base#ISharedObject} types.\n \n @remarks\n \n - `key`: The type of Shared object ({@link @fluidframework/datastore-definitions#IChannelFactory.Type}).\n \n - `value`: A renderer that takes a {@link @fluidframework/shared-object-base#ISharedObject} of the\n * specified type and generates a corresponding {@link VisualizerNode} for it.\n /\nexport interface SharedObjectVisualizers {\n\t/\n\t Individual Fluid object visualizers, keyed by {@link SharedObjectType}.\n\t /\n\t[k: SharedObjectType]: VisualizeSharedObject;\n}\n\n/\n Data visualization update events.\n /\nexport interface DataVisualizerEvents extends IEvent {\n\t/\n\t Emitted whenever the associated {@link @fluidframework/shared-object-base#ISharedObject}'s data is updated.\n\t \n\t @param visualTree - The updated visual tree representing the shared object's state.\n\t \n\t @eventProperty\n\t /\n\t(event: \"update\", listener: (visualTree: FluidObjectNode) => void): unknown;\n}\n\n/\n Manages {@link VisualizerNode \| visualizers} for shared objects reachable by\n * the provided {@link DataVisualizerGraph.rootData}.\n \n @remarks\n \n {@link VisualizerNode}s are initialized lazily.\n \n Consumers can begin tree visualization by calling {@link DataVisualizerGraph.renderRootHandles}.\n * The returned handle nodes provide the IDs required to make subsequent calls to {@link DataVisualizerGraph.render}\n * to visualize subtrees as needed.\n /\nexport class DataVisualizerGraph\n\textends TypedEventEmitter<DataVisualizerEvents>\n\timplements IDisposable\n{\n\t/\n\t Map of registered {@link VisualizerNode}s, keyed by their corresponding {@link FluidObjectId}.\n\t \n\t @privateRemarks TODO: Dependency tracking so we don't leak memory.\n\t /\n\tprivate readonly visualizerNodes: Map<FluidObjectId, VisualizerNode>;\n\n\t/\n\t Private {@link VisualizerNode.disposed} tracking.\n\t /\n\tprivate _disposed: boolean;\n\n\t/\n\t Handler for a visualizer node's \"update\" event.\n\t * Bubbles up the event to graph subscribers.\n\t /\n\tprivate readonly onVisualUpdateHandler = (visualTree: FluidObjectNode): boolean => {\n\t\tthis.emitVisualUpdate(visualTree);\n\t\treturn true;\n\t};\n\n\tpublic constructor(\n\t\t/\n\t\t {@inheritDoc IContainerDevtools.containerData}\n\t\t /\n\t\tprivate readonly rootData: Record<string, IFluidLoadable>,\n\n\t\t/\n\t\t Policy object for visualizing different kinds of shared objects.\n\t\t /\n\t\tprivate readonly visualizers: SharedObjectVisualizers,\n\t) {\n\t\tsuper();\n\n\t\tthis.visualizerNodes = new Map<FluidObjectId, VisualizerNode>();\n\n\t\tthis._disposed = false;\n\t}\n\n\t/\n\t {@inheritDoc IDisposable.disposed}\n\t /\n\tpublic get disposed(): boolean {\n\t\treturn this._disposed;\n\t}\n\n\t/\n\t Emits a visual tree update from one of the registered visualizer nodes.\n\t /\n\tprivate emitVisualUpdate(visualTree: FluidObjectNode): void {\n\t\tthis.emit(\"update\", visualTree);\n\t}\n\n\t/\n\t Generates and returns visual descriptions ({@link FluidHandleNode}s) for each of the specified\n\t * {@link DataVisualizerGraph.rootData \| root shared objects}.\n\t /\n\tpublic async renderRootHandles(): Promise<Record<string, RootHandleNode>> {\n\t\t// TODO: We should be rendering the DataObject from the root, but this requires change in the devtools package in general.\n\n\t\t// Rendering the root entries amounts to initializing visualizer nodes for each of them, and returning\n\t\t// a list of handle nodes. Consumers can request data for each of these handles as needed.\n\t\tconst rootDataEntries = Object.entries(this.rootData);\n\n\t\tconst result: Record<string, RootHandleNode> = {};\n\t\tawait Promise.all(\n\t\t\trootDataEntries.map(async ([key, value]) => {\n\t\t\t\tif (value.handle === undefined) {\n\t\t\t\t\tconsole.error(\n\t\t\t\t\t\t`Container data includes a non-Fluid object under key ${key}. Cannot visualize!`,\n\t\t\t\t\t);\n\t\t\t\t\tresult[key] = unknownObjectNode;\n\t\t\t\t} else {\n\t\t\t\t\tconst fluidObjectId = await this.registerVisualizerForHandle(value.handle);\n\t\t\t\t\tresult[key] =\n\t\t\t\t\t\tfluidObjectId === undefined ? unknownObjectNode : createHandleNode(fluidObjectId);\n\t\t\t\t}\n\t\t\t}),\n\t\t);\n\t\treturn result;\n\t}\n\n\t/\n\t Generates and returns a visual description of the specified Fluid object if it exists in the graph.\n\t * If no such object exists in the graph, returns `undefined`.\n\t /\n\tpublic async render(fluidObjectId: FluidObjectId): Promise<FluidObjectNode \| undefined> {\n\t\t// If we don't have anything registered for the requested Fluid object, return `undefined`.\n\t\t// This could indicate a stale data request from an external consumer, or could indicate a bug,\n\t\t// but this library isn't capable of telling the difference.\n\t\treturn this.visualizerNodes.get(fluidObjectId)?.render() ?? undefined;\n\t}\n\n\t/\n\t Adds a visualizer node to the collection for the specified\n\t * {@link VisualizableFluidObject} if one does not already exist.\n\t /\n\tprivate registerVisualizerForVisualizableObject(\n\t\tvisualizableObject: VisualizableFluidObject,\n\t): FluidObjectId {\n\t\t// Store type check results to avoid recomputing\n\t\tconst isDataObj = isDataObject(visualizableObject);\n\t\tconst isTreeDataObj = isTreeDataObject(visualizableObject);\n\n\t\tlet visualizationFunction: VisualizeSharedObject;\n\t\tlet rootSharedObject: ISharedObject;\n\t\tlet objectId: FluidObjectId;\n\n\t\tif (isDataObj) {\n\t\t\trootSharedObject = (visualizableObject as unknown as { readonly root: ISharedDirectory })\n\t\t\t\t.root;\n\t\t\tobjectId = getKeyForFluidObject(rootSharedObject);\n\t\t\tvisualizationFunction = visualizeDataObject;\n\t\t} else if (isTreeDataObj) {\n\t\t\trootSharedObject = (visualizableObject as unknown as { readonly tree: ISharedObject })\n\t\t\t\t.tree;\n\t\t\tobjectId = getKeyForFluidObject(rootSharedObject);\n\t\t\tvisualizationFunction = visualizeTreeDataObject;\n\t\t} else {\n\t\t\trootSharedObject = visualizableObject;\n\t\t\tobjectId = getKeyForFluidObject(visualizableObject);\n\t\t\tvisualizationFunction =\n\t\t\t\t(this.visualizers[visualizableObject.attributes.type] as VisualizeSharedObject) ??\n\t\t\t\tvisualizeUnknownSharedObject;\n\t\t}\n\n\t\tif (!this.visualizerNodes.has(objectId)) {\n\t\t\tconst visualizerNode = new VisualizerNode(\n\t\t\t\trootSharedObject,\n\t\t\t\tvisualizationFunction,\n\t\t\t\tasync (handle) => this.registerVisualizerForHandle(handle),\n\t\t\t);\n\n\t\t\t// Register event handler so we can bubble up update events\n\t\t\tvisualizerNode.on(\"update\", this.onVisualUpdateHandler);\n\n\t\t\t// Add the visualizer node to our collection\n\t\t\tthis.visualizerNodes.set(objectId, visualizerNode);\n\t\t}\n\n\t\treturn objectId;\n\t}\n\n\t/\n\t Adds a visualizer node to the collection for the specified {@link @fluidframework/core-interfaces#(IFluidHandle:interface)}\n\t * if one does not already exist.\n\t \n\t @returns\n\t \n\t The ID of object associated with the provided handle, if the handle resolves to a {@link ISharedObject}.\n\t * If the handle resolves to something else, this sytem has no way to reason about it sufficiently to generate\n\t * visual descriptors from it.\n\t * In this case, we return `undefined`.\n\t /\n\tprivate async registerVisualizerForHandle(\n\t\thandle: IFluidHandle,\n\t): Promise<FluidObjectId \| undefined> {\n\t\tconst resolvedObject = await handle.get();\n\n\t\tif (isDataObject(resolvedObject) \|\| isTreeDataObject(resolvedObject)) {\n\t\t\treturn this.registerVisualizerForVisualizableObject(resolvedObject);\n\t\t}\n\n\t\t// TODO: is this the right type check for this?\n\t\tconst sharedObject = resolvedObject as Partial<ISharedObject>;\n\t\tif (isSharedObject(sharedObject)) {\n\t\t\treturn this.registerVisualizerForVisualizableObject(sharedObject);\n\t\t} else {\n\t\t\t// Unknown data.\n\t\t\tconsole.warn(\n\t\t\t\t\"Fluid Handle resolved to data that is not a SharedObject or a DataObject.\",\n\t\t\t);\n\t\t\treturn undefined;\n\t\t}\n\t}\n\n\t/\n\t {@inheritDoc IDisposable.dispose}\n\t /\n\tpublic dispose(): void {\n\t\tif (!this._disposed) {\n\t\t\t// Dispose visualizer nodes.\n\t\t\tfor (const visualizerNode of this.visualizerNodes.values()) {\n\t\t\t\tvisualizerNode.dispose();\n\t\t\t}\n\t\t\tthis.visualizerNodes.clear();\n\n\t\t\tthis._disposed = true;\n\t\t}\n\t}\n}\n\n/\n Wraps a {@link @fluidframework/shared-object-base#ISharedObject} and encapsulates policy for\n * generating visual tree representations of its data.\n \n @remarks\n \n A visual representation can be requested via {@link VisualizerNode.render}.\n \n Additionally, whenever the associated `ISharedObject` is updated (i.e. whenever its \"op\" event is emitted),\n * an updated visual tree will be emitted via this object's {@link SharedObjectListenerEvents \| \"update\" event}.\n /\nexport class VisualizerNode\n\textends TypedEventEmitter<DataVisualizerEvents>\n\timplements IDisposable\n{\n\t/\n\t Handler for {@link VisualizerNode.sharedObject}'s \"op\" event.\n\t * Will broadcast an updated visual tree representation of the DDS's data via the\n\t * {@link SharedObjectListenerEvents \| \"update\"} event.\n\t /\n\tprivate readonly onOpHandler = async (): Promise<boolean> => {\n\t\ttry {\n\t\t\tawait this.emitVisualUpdate();\n\t\t\treturn true;\n\t\t} catch (error) {\n\t\t\tconsole.error(error);\n\t\t\treturn false;\n\t\t}\n\t};\n\n\t/\n\t Private {@link VisualizerNode.disposed} tracking.\n\t /\n\tprivate _disposed: boolean;\n\n\t/\n\t Handles the returned promise for {@link onOpHandler}.\n\t /\n\tprivate readonly syncOpHandler = (): void => {\n\t\tthis.onOpHandler().catch((error) => console.error(error));\n\t};\n\n\tpublic constructor(\n\t\t/\n\t\t The Fluid object whose data will be emitted in visualized form when requested / whenever its data is updated.\n\t\t /\n\t\tpublic readonly sharedObject: ISharedObject,\n\n\t\t/\n\t\t Callback for visualizing {@link VisualizerNode.sharedObject}.\n\t\t * Encapsulates the policies for rendering different kinds of DDSs.\n\t\t /\n\t\tprivate readonly visualizeSharedObject: VisualizeSharedObject,\n\n\t\t/\n\t\t Registers some child handle to a Fluid object for future rendering.\n\t\t \n\t\t @remarks\n\t\t \n\t\t Called during {@link VisualizerNode.render} whenever a Fluid handle is encountered.\n\t\t * Ensures that the consumer of this object's visual tree will be able to request a rendering of the handle's\n\t\t * corresponding DDS as needed.\n\t\t /\n\t\tprivate readonly registerHandle: (\n\t\t\thandle: IFluidHandle,\n\t\t) => Promise<FluidObjectId \| undefined>,\n\t) {\n\t\tsuper();\n\n\t\tthis.sharedObject.on?.(\"op\", this.syncOpHandler);\n\n\t\tthis._disposed = false;\n\t}\n\n\t/\n\t {@inheritDoc IDisposable.disposed}\n\t /\n\tpublic get disposed(): boolean {\n\t\treturn this._disposed;\n\t}\n\n\t/\n\t Emits a {@link VisualizerNode.render \| visual tree representation} of\n\t * {@link VisualizerNode.sharedObject}'s current state as an\n\t * {@link SharedObjectListenerEvents \| \"update\"} event.\n\t /\n\tprivate async emitVisualUpdate(): Promise<void> {\n\t\ttry {\n\t\t\tconst visualTree: FluidObjectNode = await this.render();\n\t\t\tthis.emit(\"update\", visualTree);\n\t\t} catch (error) {\n\t\t\tconsole.log(error);\n\t\t}\n\t}\n\n\t/\n\t Generates a visual description of the associated {@link VisualizerNode.sharedObject}'s\n\t * current state.\n\t \n\t @remarks\n\t \n\t Will recursively render child contents of {@link VisualizerNode.sharedObject}, terminating at\n\t * primitive data and handles to other Fluid objects.\n\t \n\t @returns A visual tree representation of {@link VisualizerNode.sharedObject}.\n\t /\n\tpublic async render(): Promise<FluidObjectNode> {\n\t\treturn this.visualizeSharedObject(this.sharedObject, async (data) =>\n\t\t\tthis.renderChildData(data),\n\t\t);\n\t}\n\n\t/\n\t {@inheritDoc VisualizeChildData}\n\t /\n\tprivate async renderChildData(data: unknown): Promise<VisualChildNode> {\n\t\treturn visualizeChildData(data, this.registerHandle);\n\t}\n\n\t/\n\t {@inheritDoc IDisposable.dispose}\n\t /\n\tpublic dispose(): void {\n\t\tif (!this._disposed) {\n\t\t\tthis.sharedObject.off(\"op\", this.syncOpHandler);\n\t\t\tthis._disposed = true;\n\t\t}\n\t}\n}\n\n/\n See {@link VisualizeChildData}.\n \n @param data - The child data to (recursively) render.\n * @param resolveHandle - Function which accepts an {@link @fluidframework/core-interfaces#(IFluidHandle:interface)}\n * and returns its resolved object ID.\n \n @privateRemarks Exported from this module for testing purposes. This is not intended to be exported by the package.\n /\nexport async function visualizeChildData(\n\tdata: unknown,\n\tresolveHandle: (handle: IFluidHandle) => Promise<FluidObjectId \| undefined>,\n): Promise<VisualChildNode> {\n\t// Special case for `null` because `typeof null === \"object\"`.\n\tif (data === null) {\n\t\treturn {\n\t\t\tvalue: data,\n\t\t\ttypeMetadata: \"null\",\n\t\t\tnodeKind: VisualNodeKind.ValueNode,\n\t\t};\n\t}\n\n\tif (typeof data !== \"object\" && typeof data !== \"function\") {\n\t\t// Render primitives and falsy types via their string representation\n\t\treturn {\n\t\t\tvalue: data as Primitive,\n\t\t\ttypeMetadata: typeof data,\n\t\t\tnodeKind: VisualNodeKind.ValueNode,\n\t\t};\n\t}\n\n\t// eslint-disable-next-line import-x/no-deprecated\n\tif ((data as IProvideFluidHandle)?.IFluidHandle !== undefined) {\n\t\t// If we encounter a Fluid handle, register it for future rendering, and return a node with its ID.\n\t\tconst handle = data as IFluidHandle;\n\t\tconst fluidObjectId = await resolveHandle(handle);\n\t\t// If no ID was found, then the data is not a SharedObject.\n\t\t// In this case, return an \"Unknown Data\" node so consumers can note this (as desired) to the user.\n\t\treturn fluidObjectId === undefined ? unknownObjectNode : createHandleNode(fluidObjectId);\n\t}\n\n\t// Assume any other data must be a record of some kind (since DDS contents must be serializable)\n\t// and simply recurse over its keys.\n\tconst childEntries = Object.entries(data as Record<string \| number \| symbol, unknown>);\n\n\tconst children: Record<string, VisualChildNode> = {};\n\tawait Promise.all(\n\t\tchildEntries.map(async ([key, value]) => {\n\t\t\tconst childNode = await visualizeChildData(value, resolveHandle);\n\t\t\tchildren[key] = childNode;\n\t\t}),\n\t);\n\n\treturn {\n\t\tchildren,\n\t\tnodeKind: VisualNodeKind.TreeNode,\n\t\ttypeMetadata: \"object\",\n\t};\n}\n\n/\n Determines whether or not the provided value is an {@link ISharedObject}, for the purposes of this library.\n * @remarks Implemented by checking for the particular properties / methods we use in this module.\n /\nfunction isSharedObject(value: unknown): value is ISharedObject {\n\treturn (\n\t\t(value as SharedObject).id !== undefined &&\n\t\t(value as SharedObject).attributes?.type !== undefined &&\n\t\t(value as SharedObject).on !== undefined\n\t);\n}\n\n/\n Determines whether or not the provided value is an {@link DataObject} using `instanceof`, for the purposes of this library.\n * @remarks\n * Uses `instanceof` over checking specific properties or methods, because we decided that a version mix-up with\n * {@link @fluidframework/aqueduct#} is unlikely between devtools and end-user applications, and we don't support it anyway.\n /\nfunction isDataObject(value: unknown): value is DataObject {\n\tif (\n\t\tvalue instanceof DataObject \|\|\n\t\t(typeof (value as DataObject).initializeInternal === \"function\" &&\n\t\t\ttypeof (value as { getUninitializedErrorString(): string })\n\t\t\t\t.getUninitializedErrorString) === \"function\"\n\t) {\n\t\t// If root is missing, throw an error instead of returning false\n\t\tconst root = (value as { readonly root?: ISharedDirectory }).root;\n\t\tif (!root) {\n\t\t\tthrow new Error(\"DataObject must have a `root` property, but it was undefined.\");\n\t\t}\n\n\t\treturn true;\n\t}\n\n\treturn false;\n}\n\n/\n Determines whether or not the provided value is a {@link TreeDataObject} using `instanceof`, for the purposes of this library.\n * @remarks\n * Tries to use `instanceof` because we decided that a version mix-up with\n * {@link @fluidframework/aqueduct#} is unlikely between devtools and end-user applications, and we don't support it anyway.\n * In addition, we check for the presence of key properties that make a `TreeDataObject` unique:\n * - `TreeDataObject.tree` getter\n * - `TreeDataObject.treeView` getter\n * - `TreeDataObject.initializeInternal` method\n */\nfunction isTreeDataObject(value: unknown): value is TreeDataObject {\n\tif (\n\t\tvalue instanceof TreeDataObject \|\|\n\t\t(typeof (value as TreeDataObject).initializeInternal === \"function\" &&\n\t\t\tObject.getOwnPropertyDescriptor(Object.getPrototypeOf(value), \"tree\")?.get !== undefined)\n\t) {\n\t\tconst tree = (value as { readonly tree?: ISharedObject }).tree;\n\t\tif (tree === undefined) {\n\t\t\tthrow new Error(\"TreeDataObject must have a `tree` property, but it was undefined.\");\n\t\t}\n\n\t\treturn true;\n\t}\n\n\treturn false;\n}\n"]}

package/dist/packageVersion.d.ts CHANGED Viewed

@@ -5,5 +5,5 @@
  * THIS IS AN AUTOGENERATED FILE. DO NOT EDIT THIS FILE DIRECTLY
  */
 export declare const pkgName = "@fluidframework/devtools-core";
-export declare const pkgVersion = "2.71.0";
+export declare const pkgVersion = "2.73.0";
 //# sourceMappingURL=packageVersion.d.ts.map

package/dist/packageVersion.js CHANGED Viewed

@@ -8,5 +8,5 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.pkgVersion = exports.pkgName = void 0;
 exports.pkgName = "@fluidframework/devtools-core";
-exports.pkgVersion = "2.71.0";
+exports.pkgVersion = "2.73.0";
 //# sourceMappingURL=packageVersion.js.map

package/dist/packageVersion.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"packageVersion.js","sourceRoot":"","sources":["../src/packageVersion.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEU,QAAA,OAAO,GAAG,+BAA+B,CAAC;AAC1C,QAAA,UAAU,GAAG,QAAQ,CAAC","sourcesContent":["/!\n Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n \n THIS IS AN AUTOGENERATED FILE. DO NOT EDIT THIS FILE DIRECTLY\n */\n\nexport const pkgName = \"@fluidframework/devtools-core\";\nexport const pkgVersion = \"2.71.0\";\n"]}
1	+ {"version":3,"file":"packageVersion.js","sourceRoot":"","sources":["../src/packageVersion.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEU,QAAA,OAAO,GAAG,+BAA+B,CAAC;AAC1C,QAAA,UAAU,GAAG,QAAQ,CAAC","sourcesContent":["/!\n Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n \n THIS IS AN AUTOGENERATED FILE. DO NOT EDIT THIS FILE DIRECTLY\n */\n\nexport const pkgName = \"@fluidframework/devtools-core\";\nexport const pkgVersion = \"2.73.0\";\n"]}

package/lib/data-visualization/DataVisualization.js CHANGED Viewed

@@ -306,7 +306,7 @@ export async function visualizeChildData(data, resolveHandle) {
             nodeKind: VisualNodeKind.ValueNode,
         };
     }
-    // eslint-disable-next-line import/no-deprecated
+    // eslint-disable-next-line import-x/no-deprecated
     if (data?.IFluidHandle !== undefined) {
         // If we encounter a Fluid handle, register it for future rendering, and return a node with its ID.
         const handle = data;

package/lib/data-visualization/DataVisualization.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"DataVisualization.js","sourceRoot":"","sources":["../../src/data-visualization/DataVisualization.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\n// Indexed-object style is used to ease documentation.\n/ eslint-disable @typescript-eslint/consistent-indexed-object-style /\n\nimport { TypedEventEmitter } from \"@fluid-internal/client-utils\";\nimport { DataObject, TreeDataObject } from \"@fluidframework/aqueduct/internal\";\nimport type {\n\tIDisposable,\n\tIEvent,\n\tIFluidHandle,\n\tIFluidLoadable,\n} from \"@fluidframework/core-interfaces\";\n// eslint-disable-next-line import/no-deprecated\nimport type { IProvideFluidHandle } from \"@fluidframework/core-interfaces/internal\";\nimport type { ISharedDirectory } from \"@fluidframework/map/internal\";\nimport type { ISharedObject, SharedObject } from \"@fluidframework/shared-object-base/internal\";\n\nimport type { FluidObjectId } from \"../CommonInterfaces.js\";\nimport { getKeyForFluidObject } from \"../FluidObjectKey.js\";\n\nimport {\n\tvisualizeDataObject,\n\tvisualizeTreeDataObject,\n\tvisualizeUnknownSharedObject,\n} from \"./DefaultVisualizers.js\";\nimport {\n\ttype FluidObjectNode,\n\ttype Primitive,\n\ttype RootHandleNode,\n\ttype VisualChildNode,\n\tVisualNodeKind,\n\tcreateHandleNode,\n\tunknownObjectNode,\n} from \"./VisualTree.js\";\n\n// Ideas:\n// - Hold onto previous summary and only transmit diff?\n\n// TODOs:\n// - Dependency tracking\n// - When a particular DDS is no longer reachable via the input data, we need to remove it from the map and stop\n// emitting updates.\n\n/\n The type of a shared object.\n \n @remarks\n \n This can be acquired via {@link @fluidframework/datastore-definitions#IChannelFactory.Type} field of\n * your shared object's factory class.\n /\nexport type SharedObjectType = string;\n\n/\n Generates a visual description of the provided {@link @fluidframework/shared-object-base#ISharedObject}'s\n * current state.\n \n @param sharedObject - The object whose data will be rendered.\n * @param visualizeChildData - Callback to render child content of the shared object.\n \n @returns A visual tree representation of the provided `sharedObject`.\n \n @internal\n /\nexport type VisualizeSharedObject = (\n\tsharedObject: ISharedObject,\n\tvisualizeChildData: VisualizeChildData,\n) => Promise<FluidObjectNode>;\n\n/\n Recursively renders child contents of a {@link @fluidframework/shared-object-base#ISharedObject}.\n \n @param data - The child data to render.\n * Since this is child data of a DDS (and must be serializable), we know that it must be one of the following:\n \n - Primitive data\n \n - A serializable Record\n \n - A handle to another Fluid object\n \n @returns A visual tree representation of the input `data`.\n \n @internal\n /\nexport type VisualizeChildData = (data: unknown) => Promise<VisualChildNode>;\n\n/\n Utility type for a union of things that can be visualized.\n /\nexport type VisualizableFluidObject = ISharedObject \| DataObject \| TreeDataObject;\n\n/\n Specifies renderers for different {@link @fluidframework/shared-object-base#ISharedObject} types.\n \n @remarks\n \n - `key`: The type of Shared object ({@link @fluidframework/datastore-definitions#IChannelFactory.Type}).\n \n - `value`: A renderer that takes a {@link @fluidframework/shared-object-base#ISharedObject} of the\n * specified type and generates a corresponding {@link VisualizerNode} for it.\n /\nexport interface SharedObjectVisualizers {\n\t/\n\t Individual Fluid object visualizers, keyed by {@link SharedObjectType}.\n\t /\n\t[k: SharedObjectType]: VisualizeSharedObject;\n}\n\n/\n Data visualization update events.\n /\nexport interface DataVisualizerEvents extends IEvent {\n\t/\n\t Emitted whenever the associated {@link @fluidframework/shared-object-base#ISharedObject}'s data is updated.\n\t \n\t @param visualTree - The updated visual tree representing the shared object's state.\n\t \n\t @eventProperty\n\t /\n\t(event: \"update\", listener: (visualTree: FluidObjectNode) => void): unknown;\n}\n\n/\n Manages {@link VisualizerNode \| visualizers} for shared objects reachable by\n * the provided {@link DataVisualizerGraph.rootData}.\n \n @remarks\n \n {@link VisualizerNode}s are initialized lazily.\n \n Consumers can begin tree visualization by calling {@link DataVisualizerGraph.renderRootHandles}.\n * The returned handle nodes provide the IDs required to make subsequent calls to {@link DataVisualizerGraph.render}\n * to visualize subtrees as needed.\n /\nexport class DataVisualizerGraph\n\textends TypedEventEmitter<DataVisualizerEvents>\n\timplements IDisposable\n{\n\t/\n\t Map of registered {@link VisualizerNode}s, keyed by their corresponding {@link FluidObjectId}.\n\t \n\t @privateRemarks TODO: Dependency tracking so we don't leak memory.\n\t /\n\tprivate readonly visualizerNodes: Map<FluidObjectId, VisualizerNode>;\n\n\t/\n\t Private {@link VisualizerNode.disposed} tracking.\n\t /\n\tprivate _disposed: boolean;\n\n\t/\n\t Handler for a visualizer node's \"update\" event.\n\t * Bubbles up the event to graph subscribers.\n\t /\n\tprivate readonly onVisualUpdateHandler = (visualTree: FluidObjectNode): boolean => {\n\t\tthis.emitVisualUpdate(visualTree);\n\t\treturn true;\n\t};\n\n\tpublic constructor(\n\t\t/\n\t\t {@inheritDoc IContainerDevtools.containerData}\n\t\t /\n\t\tprivate readonly rootData: Record<string, IFluidLoadable>,\n\n\t\t/\n\t\t Policy object for visualizing different kinds of shared objects.\n\t\t /\n\t\tprivate readonly visualizers: SharedObjectVisualizers,\n\t) {\n\t\tsuper();\n\n\t\tthis.visualizerNodes = new Map<FluidObjectId, VisualizerNode>();\n\n\t\tthis._disposed = false;\n\t}\n\n\t/\n\t {@inheritDoc IDisposable.disposed}\n\t /\n\tpublic get disposed(): boolean {\n\t\treturn this._disposed;\n\t}\n\n\t/\n\t Emits a visual tree update from one of the registered visualizer nodes.\n\t /\n\tprivate emitVisualUpdate(visualTree: FluidObjectNode): void {\n\t\tthis.emit(\"update\", visualTree);\n\t}\n\n\t/\n\t Generates and returns visual descriptions ({@link FluidHandleNode}s) for each of the specified\n\t * {@link DataVisualizerGraph.rootData \| root shared objects}.\n\t /\n\tpublic async renderRootHandles(): Promise<Record<string, RootHandleNode>> {\n\t\t// TODO: We should be rendering the DataObject from the root, but this requires change in the devtools package in general.\n\n\t\t// Rendering the root entries amounts to initializing visualizer nodes for each of them, and returning\n\t\t// a list of handle nodes. Consumers can request data for each of these handles as needed.\n\t\tconst rootDataEntries = Object.entries(this.rootData);\n\n\t\tconst result: Record<string, RootHandleNode> = {};\n\t\tawait Promise.all(\n\t\t\trootDataEntries.map(async ([key, value]) => {\n\t\t\t\tif (value.handle === undefined) {\n\t\t\t\t\tconsole.error(\n\t\t\t\t\t\t`Container data includes a non-Fluid object under key ${key}. Cannot visualize!`,\n\t\t\t\t\t);\n\t\t\t\t\tresult[key] = unknownObjectNode;\n\t\t\t\t} else {\n\t\t\t\t\tconst fluidObjectId = await this.registerVisualizerForHandle(value.handle);\n\t\t\t\t\tresult[key] =\n\t\t\t\t\t\tfluidObjectId === undefined ? unknownObjectNode : createHandleNode(fluidObjectId);\n\t\t\t\t}\n\t\t\t}),\n\t\t);\n\t\treturn result;\n\t}\n\n\t/\n\t Generates and returns a visual description of the specified Fluid object if it exists in the graph.\n\t * If no such object exists in the graph, returns `undefined`.\n\t /\n\tpublic async render(fluidObjectId: FluidObjectId): Promise<FluidObjectNode \| undefined> {\n\t\t// If we don't have anything registered for the requested Fluid object, return `undefined`.\n\t\t// This could indicate a stale data request from an external consumer, or could indicate a bug,\n\t\t// but this library isn't capable of telling the difference.\n\t\treturn this.visualizerNodes.get(fluidObjectId)?.render() ?? undefined;\n\t}\n\n\t/\n\t Adds a visualizer node to the collection for the specified\n\t * {@link VisualizableFluidObject} if one does not already exist.\n\t /\n\tprivate registerVisualizerForVisualizableObject(\n\t\tvisualizableObject: VisualizableFluidObject,\n\t): FluidObjectId {\n\t\t// Store type check results to avoid recomputing\n\t\tconst isDataObj = isDataObject(visualizableObject);\n\t\tconst isTreeDataObj = isTreeDataObject(visualizableObject);\n\n\t\tlet visualizationFunction: VisualizeSharedObject;\n\t\tlet rootSharedObject: ISharedObject;\n\t\tlet objectId: FluidObjectId;\n\n\t\tif (isDataObj) {\n\t\t\trootSharedObject = (visualizableObject as unknown as { readonly root: ISharedDirectory })\n\t\t\t\t.root;\n\t\t\tobjectId = getKeyForFluidObject(rootSharedObject);\n\t\t\tvisualizationFunction = visualizeDataObject;\n\t\t} else if (isTreeDataObj) {\n\t\t\trootSharedObject = (visualizableObject as unknown as { readonly tree: ISharedObject })\n\t\t\t\t.tree;\n\t\t\tobjectId = getKeyForFluidObject(rootSharedObject);\n\t\t\tvisualizationFunction = visualizeTreeDataObject;\n\t\t} else {\n\t\t\trootSharedObject = visualizableObject;\n\t\t\tobjectId = getKeyForFluidObject(visualizableObject);\n\t\t\tvisualizationFunction =\n\t\t\t\t(this.visualizers[visualizableObject.attributes.type] as VisualizeSharedObject) ??\n\t\t\t\tvisualizeUnknownSharedObject;\n\t\t}\n\n\t\tif (!this.visualizerNodes.has(objectId)) {\n\t\t\tconst visualizerNode = new VisualizerNode(\n\t\t\t\trootSharedObject,\n\t\t\t\tvisualizationFunction,\n\t\t\t\tasync (handle) => this.registerVisualizerForHandle(handle),\n\t\t\t);\n\n\t\t\t// Register event handler so we can bubble up update events\n\t\t\tvisualizerNode.on(\"update\", this.onVisualUpdateHandler);\n\n\t\t\t// Add the visualizer node to our collection\n\t\t\tthis.visualizerNodes.set(objectId, visualizerNode);\n\t\t}\n\n\t\treturn objectId;\n\t}\n\n\t/\n\t Adds a visualizer node to the collection for the specified {@link @fluidframework/core-interfaces#(IFluidHandle:interface)}\n\t * if one does not already exist.\n\t \n\t @returns\n\t \n\t The ID of object associated with the provided handle, if the handle resolves to a {@link ISharedObject}.\n\t * If the handle resolves to something else, this sytem has no way to reason about it sufficiently to generate\n\t * visual descriptors from it.\n\t * In this case, we return `undefined`.\n\t /\n\tprivate async registerVisualizerForHandle(\n\t\thandle: IFluidHandle,\n\t): Promise<FluidObjectId \| undefined> {\n\t\tconst resolvedObject = await handle.get();\n\n\t\tif (isDataObject(resolvedObject) \|\| isTreeDataObject(resolvedObject)) {\n\t\t\treturn this.registerVisualizerForVisualizableObject(resolvedObject);\n\t\t}\n\n\t\t// TODO: is this the right type check for this?\n\t\tconst sharedObject = resolvedObject as Partial<ISharedObject>;\n\t\tif (isSharedObject(sharedObject)) {\n\t\t\treturn this.registerVisualizerForVisualizableObject(sharedObject);\n\t\t} else {\n\t\t\t// Unknown data.\n\t\t\tconsole.warn(\n\t\t\t\t\"Fluid Handle resolved to data that is not a SharedObject or a DataObject.\",\n\t\t\t);\n\t\t\treturn undefined;\n\t\t}\n\t}\n\n\t/\n\t {@inheritDoc IDisposable.dispose}\n\t /\n\tpublic dispose(): void {\n\t\tif (!this._disposed) {\n\t\t\t// Dispose visualizer nodes.\n\t\t\tfor (const visualizerNode of this.visualizerNodes.values()) {\n\t\t\t\tvisualizerNode.dispose();\n\t\t\t}\n\t\t\tthis.visualizerNodes.clear();\n\n\t\t\tthis._disposed = true;\n\t\t}\n\t}\n}\n\n/\n Wraps a {@link @fluidframework/shared-object-base#ISharedObject} and encapsulates policy for\n * generating visual tree representations of its data.\n \n @remarks\n \n A visual representation can be requested via {@link VisualizerNode.render}.\n \n Additionally, whenever the associated `ISharedObject` is updated (i.e. whenever its \"op\" event is emitted),\n * an updated visual tree will be emitted via this object's {@link SharedObjectListenerEvents \| \"update\" event}.\n /\nexport class VisualizerNode\n\textends TypedEventEmitter<DataVisualizerEvents>\n\timplements IDisposable\n{\n\t/\n\t Handler for {@link VisualizerNode.sharedObject}'s \"op\" event.\n\t * Will broadcast an updated visual tree representation of the DDS's data via the\n\t * {@link SharedObjectListenerEvents \| \"update\"} event.\n\t /\n\tprivate readonly onOpHandler = async (): Promise<boolean> => {\n\t\ttry {\n\t\t\tawait this.emitVisualUpdate();\n\t\t\treturn true;\n\t\t} catch (error) {\n\t\t\tconsole.error(error);\n\t\t\treturn false;\n\t\t}\n\t};\n\n\t/\n\t Private {@link VisualizerNode.disposed} tracking.\n\t /\n\tprivate _disposed: boolean;\n\n\t/\n\t Handles the returned promise for {@link onOpHandler}.\n\t /\n\tprivate readonly syncOpHandler = (): void => {\n\t\tthis.onOpHandler().catch((error) => console.error(error));\n\t};\n\n\tpublic constructor(\n\t\t/\n\t\t The Fluid object whose data will be emitted in visualized form when requested / whenever its data is updated.\n\t\t /\n\t\tpublic readonly sharedObject: ISharedObject,\n\n\t\t/\n\t\t Callback for visualizing {@link VisualizerNode.sharedObject}.\n\t\t * Encapsulates the policies for rendering different kinds of DDSs.\n\t\t /\n\t\tprivate readonly visualizeSharedObject: VisualizeSharedObject,\n\n\t\t/\n\t\t Registers some child handle to a Fluid object for future rendering.\n\t\t \n\t\t @remarks\n\t\t \n\t\t Called during {@link VisualizerNode.render} whenever a Fluid handle is encountered.\n\t\t * Ensures that the consumer of this object's visual tree will be able to request a rendering of the handle's\n\t\t * corresponding DDS as needed.\n\t\t /\n\t\tprivate readonly registerHandle: (\n\t\t\thandle: IFluidHandle,\n\t\t) => Promise<FluidObjectId \| undefined>,\n\t) {\n\t\tsuper();\n\n\t\tthis.sharedObject.on?.(\"op\", this.syncOpHandler);\n\n\t\tthis._disposed = false;\n\t}\n\n\t/\n\t {@inheritDoc IDisposable.disposed}\n\t /\n\tpublic get disposed(): boolean {\n\t\treturn this._disposed;\n\t}\n\n\t/\n\t Emits a {@link VisualizerNode.render \| visual tree representation} of\n\t * {@link VisualizerNode.sharedObject}'s current state as an\n\t * {@link SharedObjectListenerEvents \| \"update\"} event.\n\t /\n\tprivate async emitVisualUpdate(): Promise<void> {\n\t\ttry {\n\t\t\tconst visualTree: FluidObjectNode = await this.render();\n\t\t\tthis.emit(\"update\", visualTree);\n\t\t} catch (error) {\n\t\t\tconsole.log(error);\n\t\t}\n\t}\n\n\t/\n\t Generates a visual description of the associated {@link VisualizerNode.sharedObject}'s\n\t * current state.\n\t \n\t @remarks\n\t \n\t Will recursively render child contents of {@link VisualizerNode.sharedObject}, terminating at\n\t * primitive data and handles to other Fluid objects.\n\t \n\t @returns A visual tree representation of {@link VisualizerNode.sharedObject}.\n\t /\n\tpublic async render(): Promise<FluidObjectNode> {\n\t\treturn this.visualizeSharedObject(this.sharedObject, async (data) =>\n\t\t\tthis.renderChildData(data),\n\t\t);\n\t}\n\n\t/\n\t {@inheritDoc VisualizeChildData}\n\t /\n\tprivate async renderChildData(data: unknown): Promise<VisualChildNode> {\n\t\treturn visualizeChildData(data, this.registerHandle);\n\t}\n\n\t/\n\t {@inheritDoc IDisposable.dispose}\n\t /\n\tpublic dispose(): void {\n\t\tif (!this._disposed) {\n\t\t\tthis.sharedObject.off(\"op\", this.syncOpHandler);\n\t\t\tthis._disposed = true;\n\t\t}\n\t}\n}\n\n/\n See {@link VisualizeChildData}.\n \n @param data - The child data to (recursively) render.\n * @param resolveHandle - Function which accepts an {@link @fluidframework/core-interfaces#(IFluidHandle:interface)}\n * and returns its resolved object ID.\n \n @privateRemarks Exported from this module for testing purposes. This is not intended to be exported by the package.\n /\nexport async function visualizeChildData(\n\tdata: unknown,\n\tresolveHandle: (handle: IFluidHandle) => Promise<FluidObjectId \| undefined>,\n): Promise<VisualChildNode> {\n\t// Special case for `null` because `typeof null === \"object\"`.\n\tif (data === null) {\n\t\treturn {\n\t\t\tvalue: data,\n\t\t\ttypeMetadata: \"null\",\n\t\t\tnodeKind: VisualNodeKind.ValueNode,\n\t\t};\n\t}\n\n\tif (typeof data !== \"object\" && typeof data !== \"function\") {\n\t\t// Render primitives and falsy types via their string representation\n\t\treturn {\n\t\t\tvalue: data as Primitive,\n\t\t\ttypeMetadata: typeof data,\n\t\t\tnodeKind: VisualNodeKind.ValueNode,\n\t\t};\n\t}\n\n\t// eslint-disable-next-line import/no-deprecated\n\tif ((data as IProvideFluidHandle)?.IFluidHandle !== undefined) {\n\t\t// If we encounter a Fluid handle, register it for future rendering, and return a node with its ID.\n\t\tconst handle = data as IFluidHandle;\n\t\tconst fluidObjectId = await resolveHandle(handle);\n\t\t// If no ID was found, then the data is not a SharedObject.\n\t\t// In this case, return an \"Unknown Data\" node so consumers can note this (as desired) to the user.\n\t\treturn fluidObjectId === undefined ? unknownObjectNode : createHandleNode(fluidObjectId);\n\t}\n\n\t// Assume any other data must be a record of some kind (since DDS contents must be serializable)\n\t// and simply recurse over its keys.\n\tconst childEntries = Object.entries(data as Record<string \| number \| symbol, unknown>);\n\n\tconst children: Record<string, VisualChildNode> = {};\n\tawait Promise.all(\n\t\tchildEntries.map(async ([key, value]) => {\n\t\t\tconst childNode = await visualizeChildData(value, resolveHandle);\n\t\t\tchildren[key] = childNode;\n\t\t}),\n\t);\n\n\treturn {\n\t\tchildren,\n\t\tnodeKind: VisualNodeKind.TreeNode,\n\t\ttypeMetadata: \"object\",\n\t};\n}\n\n/\n Determines whether or not the provided value is an {@link ISharedObject}, for the purposes of this library.\n * @remarks Implemented by checking for the particular properties / methods we use in this module.\n /\nfunction isSharedObject(value: unknown): value is ISharedObject {\n\treturn (\n\t\t(value as SharedObject).id !== undefined &&\n\t\t(value as SharedObject).attributes?.type !== undefined &&\n\t\t(value as SharedObject).on !== undefined\n\t);\n}\n\n/\n Determines whether or not the provided value is an {@link DataObject} using `instanceof`, for the purposes of this library.\n * @remarks\n * Uses `instanceof` over checking specific properties or methods, because we decided that a version mix-up with\n * {@link @fluidframework/aqueduct#} is unlikely between devtools and end-user applications, and we don't support it anyway.\n /\nfunction isDataObject(value: unknown): value is DataObject {\n\tif (\n\t\tvalue instanceof DataObject \|\|\n\t\t(typeof (value as DataObject).initializeInternal === \"function\" &&\n\t\t\ttypeof (value as { getUninitializedErrorString(): string })\n\t\t\t\t.getUninitializedErrorString) === \"function\"\n\t) {\n\t\t// If root is missing, throw an error instead of returning false\n\t\tconst root = (value as { readonly root?: ISharedDirectory }).root;\n\t\tif (!root) {\n\t\t\tthrow new Error(\"DataObject must have a `root` property, but it was undefined.\");\n\t\t}\n\n\t\treturn true;\n\t}\n\n\treturn false;\n}\n\n/\n Determines whether or not the provided value is a {@link TreeDataObject} using `instanceof`, for the purposes of this library.\n * @remarks\n * Tries to use `instanceof` because we decided that a version mix-up with\n * {@link @fluidframework/aqueduct#} is unlikely between devtools and end-user applications, and we don't support it anyway.\n * In addition, we check for the presence of key properties that make a `TreeDataObject` unique:\n * - `TreeDataObject.tree` getter\n * - `TreeDataObject.treeView` getter\n * - `TreeDataObject.initializeInternal` method\n */\nfunction isTreeDataObject(value: unknown): value is TreeDataObject {\n\tif (\n\t\tvalue instanceof TreeDataObject \|\|\n\t\t(typeof (value as TreeDataObject).initializeInternal === \"function\" &&\n\t\t\tObject.getOwnPropertyDescriptor(Object.getPrototypeOf(value), \"tree\")?.get !== undefined)\n\t) {\n\t\tconst tree = (value as { readonly tree?: ISharedObject }).tree;\n\t\tif (tree === undefined) {\n\t\t\tthrow new Error(\"TreeDataObject must have a `tree` property, but it was undefined.\");\n\t\t}\n\n\t\treturn true;\n\t}\n\n\treturn false;\n}\n"]}
1	+ {"version":3,"file":"DataVisualization.js","sourceRoot":"","sources":["../../src/data-visualization/DataVisualization.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\n// Indexed-object style is used to ease documentation.\n/ eslint-disable @typescript-eslint/consistent-indexed-object-style /\n\nimport { TypedEventEmitter } from \"@fluid-internal/client-utils\";\nimport { DataObject, TreeDataObject } from \"@fluidframework/aqueduct/internal\";\nimport type {\n\tIDisposable,\n\tIEvent,\n\tIFluidHandle,\n\tIFluidLoadable,\n} from \"@fluidframework/core-interfaces\";\n// eslint-disable-next-line import-x/no-deprecated\nimport type { IProvideFluidHandle } from \"@fluidframework/core-interfaces/internal\";\nimport type { ISharedDirectory } from \"@fluidframework/map/internal\";\nimport type { ISharedObject, SharedObject } from \"@fluidframework/shared-object-base/internal\";\n\nimport type { FluidObjectId } from \"../CommonInterfaces.js\";\nimport { getKeyForFluidObject } from \"../FluidObjectKey.js\";\n\nimport {\n\tvisualizeDataObject,\n\tvisualizeTreeDataObject,\n\tvisualizeUnknownSharedObject,\n} from \"./DefaultVisualizers.js\";\nimport {\n\ttype FluidObjectNode,\n\ttype Primitive,\n\ttype RootHandleNode,\n\ttype VisualChildNode,\n\tVisualNodeKind,\n\tcreateHandleNode,\n\tunknownObjectNode,\n} from \"./VisualTree.js\";\n\n// Ideas:\n// - Hold onto previous summary and only transmit diff?\n\n// TODOs:\n// - Dependency tracking\n// - When a particular DDS is no longer reachable via the input data, we need to remove it from the map and stop\n// emitting updates.\n\n/\n The type of a shared object.\n \n @remarks\n \n This can be acquired via {@link @fluidframework/datastore-definitions#IChannelFactory.Type} field of\n * your shared object's factory class.\n /\nexport type SharedObjectType = string;\n\n/\n Generates a visual description of the provided {@link @fluidframework/shared-object-base#ISharedObject}'s\n * current state.\n \n @param sharedObject - The object whose data will be rendered.\n * @param visualizeChildData - Callback to render child content of the shared object.\n \n @returns A visual tree representation of the provided `sharedObject`.\n \n @internal\n /\nexport type VisualizeSharedObject = (\n\tsharedObject: ISharedObject,\n\tvisualizeChildData: VisualizeChildData,\n) => Promise<FluidObjectNode>;\n\n/\n Recursively renders child contents of a {@link @fluidframework/shared-object-base#ISharedObject}.\n \n @param data - The child data to render.\n * Since this is child data of a DDS (and must be serializable), we know that it must be one of the following:\n \n - Primitive data\n \n - A serializable Record\n \n - A handle to another Fluid object\n \n @returns A visual tree representation of the input `data`.\n \n @internal\n /\nexport type VisualizeChildData = (data: unknown) => Promise<VisualChildNode>;\n\n/\n Utility type for a union of things that can be visualized.\n /\nexport type VisualizableFluidObject = ISharedObject \| DataObject \| TreeDataObject;\n\n/\n Specifies renderers for different {@link @fluidframework/shared-object-base#ISharedObject} types.\n \n @remarks\n \n - `key`: The type of Shared object ({@link @fluidframework/datastore-definitions#IChannelFactory.Type}).\n \n - `value`: A renderer that takes a {@link @fluidframework/shared-object-base#ISharedObject} of the\n * specified type and generates a corresponding {@link VisualizerNode} for it.\n /\nexport interface SharedObjectVisualizers {\n\t/\n\t Individual Fluid object visualizers, keyed by {@link SharedObjectType}.\n\t /\n\t[k: SharedObjectType]: VisualizeSharedObject;\n}\n\n/\n Data visualization update events.\n /\nexport interface DataVisualizerEvents extends IEvent {\n\t/\n\t Emitted whenever the associated {@link @fluidframework/shared-object-base#ISharedObject}'s data is updated.\n\t \n\t @param visualTree - The updated visual tree representing the shared object's state.\n\t \n\t @eventProperty\n\t /\n\t(event: \"update\", listener: (visualTree: FluidObjectNode) => void): unknown;\n}\n\n/\n Manages {@link VisualizerNode \| visualizers} for shared objects reachable by\n * the provided {@link DataVisualizerGraph.rootData}.\n \n @remarks\n \n {@link VisualizerNode}s are initialized lazily.\n \n Consumers can begin tree visualization by calling {@link DataVisualizerGraph.renderRootHandles}.\n * The returned handle nodes provide the IDs required to make subsequent calls to {@link DataVisualizerGraph.render}\n * to visualize subtrees as needed.\n /\nexport class DataVisualizerGraph\n\textends TypedEventEmitter<DataVisualizerEvents>\n\timplements IDisposable\n{\n\t/\n\t Map of registered {@link VisualizerNode}s, keyed by their corresponding {@link FluidObjectId}.\n\t \n\t @privateRemarks TODO: Dependency tracking so we don't leak memory.\n\t /\n\tprivate readonly visualizerNodes: Map<FluidObjectId, VisualizerNode>;\n\n\t/\n\t Private {@link VisualizerNode.disposed} tracking.\n\t /\n\tprivate _disposed: boolean;\n\n\t/\n\t Handler for a visualizer node's \"update\" event.\n\t * Bubbles up the event to graph subscribers.\n\t /\n\tprivate readonly onVisualUpdateHandler = (visualTree: FluidObjectNode): boolean => {\n\t\tthis.emitVisualUpdate(visualTree);\n\t\treturn true;\n\t};\n\n\tpublic constructor(\n\t\t/\n\t\t {@inheritDoc IContainerDevtools.containerData}\n\t\t /\n\t\tprivate readonly rootData: Record<string, IFluidLoadable>,\n\n\t\t/\n\t\t Policy object for visualizing different kinds of shared objects.\n\t\t /\n\t\tprivate readonly visualizers: SharedObjectVisualizers,\n\t) {\n\t\tsuper();\n\n\t\tthis.visualizerNodes = new Map<FluidObjectId, VisualizerNode>();\n\n\t\tthis._disposed = false;\n\t}\n\n\t/\n\t {@inheritDoc IDisposable.disposed}\n\t /\n\tpublic get disposed(): boolean {\n\t\treturn this._disposed;\n\t}\n\n\t/\n\t Emits a visual tree update from one of the registered visualizer nodes.\n\t /\n\tprivate emitVisualUpdate(visualTree: FluidObjectNode): void {\n\t\tthis.emit(\"update\", visualTree);\n\t}\n\n\t/\n\t Generates and returns visual descriptions ({@link FluidHandleNode}s) for each of the specified\n\t * {@link DataVisualizerGraph.rootData \| root shared objects}.\n\t /\n\tpublic async renderRootHandles(): Promise<Record<string, RootHandleNode>> {\n\t\t// TODO: We should be rendering the DataObject from the root, but this requires change in the devtools package in general.\n\n\t\t// Rendering the root entries amounts to initializing visualizer nodes for each of them, and returning\n\t\t// a list of handle nodes. Consumers can request data for each of these handles as needed.\n\t\tconst rootDataEntries = Object.entries(this.rootData);\n\n\t\tconst result: Record<string, RootHandleNode> = {};\n\t\tawait Promise.all(\n\t\t\trootDataEntries.map(async ([key, value]) => {\n\t\t\t\tif (value.handle === undefined) {\n\t\t\t\t\tconsole.error(\n\t\t\t\t\t\t`Container data includes a non-Fluid object under key ${key}. Cannot visualize!`,\n\t\t\t\t\t);\n\t\t\t\t\tresult[key] = unknownObjectNode;\n\t\t\t\t} else {\n\t\t\t\t\tconst fluidObjectId = await this.registerVisualizerForHandle(value.handle);\n\t\t\t\t\tresult[key] =\n\t\t\t\t\t\tfluidObjectId === undefined ? unknownObjectNode : createHandleNode(fluidObjectId);\n\t\t\t\t}\n\t\t\t}),\n\t\t);\n\t\treturn result;\n\t}\n\n\t/\n\t Generates and returns a visual description of the specified Fluid object if it exists in the graph.\n\t * If no such object exists in the graph, returns `undefined`.\n\t /\n\tpublic async render(fluidObjectId: FluidObjectId): Promise<FluidObjectNode \| undefined> {\n\t\t// If we don't have anything registered for the requested Fluid object, return `undefined`.\n\t\t// This could indicate a stale data request from an external consumer, or could indicate a bug,\n\t\t// but this library isn't capable of telling the difference.\n\t\treturn this.visualizerNodes.get(fluidObjectId)?.render() ?? undefined;\n\t}\n\n\t/\n\t Adds a visualizer node to the collection for the specified\n\t * {@link VisualizableFluidObject} if one does not already exist.\n\t /\n\tprivate registerVisualizerForVisualizableObject(\n\t\tvisualizableObject: VisualizableFluidObject,\n\t): FluidObjectId {\n\t\t// Store type check results to avoid recomputing\n\t\tconst isDataObj = isDataObject(visualizableObject);\n\t\tconst isTreeDataObj = isTreeDataObject(visualizableObject);\n\n\t\tlet visualizationFunction: VisualizeSharedObject;\n\t\tlet rootSharedObject: ISharedObject;\n\t\tlet objectId: FluidObjectId;\n\n\t\tif (isDataObj) {\n\t\t\trootSharedObject = (visualizableObject as unknown as { readonly root: ISharedDirectory })\n\t\t\t\t.root;\n\t\t\tobjectId = getKeyForFluidObject(rootSharedObject);\n\t\t\tvisualizationFunction = visualizeDataObject;\n\t\t} else if (isTreeDataObj) {\n\t\t\trootSharedObject = (visualizableObject as unknown as { readonly tree: ISharedObject })\n\t\t\t\t.tree;\n\t\t\tobjectId = getKeyForFluidObject(rootSharedObject);\n\t\t\tvisualizationFunction = visualizeTreeDataObject;\n\t\t} else {\n\t\t\trootSharedObject = visualizableObject;\n\t\t\tobjectId = getKeyForFluidObject(visualizableObject);\n\t\t\tvisualizationFunction =\n\t\t\t\t(this.visualizers[visualizableObject.attributes.type] as VisualizeSharedObject) ??\n\t\t\t\tvisualizeUnknownSharedObject;\n\t\t}\n\n\t\tif (!this.visualizerNodes.has(objectId)) {\n\t\t\tconst visualizerNode = new VisualizerNode(\n\t\t\t\trootSharedObject,\n\t\t\t\tvisualizationFunction,\n\t\t\t\tasync (handle) => this.registerVisualizerForHandle(handle),\n\t\t\t);\n\n\t\t\t// Register event handler so we can bubble up update events\n\t\t\tvisualizerNode.on(\"update\", this.onVisualUpdateHandler);\n\n\t\t\t// Add the visualizer node to our collection\n\t\t\tthis.visualizerNodes.set(objectId, visualizerNode);\n\t\t}\n\n\t\treturn objectId;\n\t}\n\n\t/\n\t Adds a visualizer node to the collection for the specified {@link @fluidframework/core-interfaces#(IFluidHandle:interface)}\n\t * if one does not already exist.\n\t \n\t @returns\n\t \n\t The ID of object associated with the provided handle, if the handle resolves to a {@link ISharedObject}.\n\t * If the handle resolves to something else, this sytem has no way to reason about it sufficiently to generate\n\t * visual descriptors from it.\n\t * In this case, we return `undefined`.\n\t /\n\tprivate async registerVisualizerForHandle(\n\t\thandle: IFluidHandle,\n\t): Promise<FluidObjectId \| undefined> {\n\t\tconst resolvedObject = await handle.get();\n\n\t\tif (isDataObject(resolvedObject) \|\| isTreeDataObject(resolvedObject)) {\n\t\t\treturn this.registerVisualizerForVisualizableObject(resolvedObject);\n\t\t}\n\n\t\t// TODO: is this the right type check for this?\n\t\tconst sharedObject = resolvedObject as Partial<ISharedObject>;\n\t\tif (isSharedObject(sharedObject)) {\n\t\t\treturn this.registerVisualizerForVisualizableObject(sharedObject);\n\t\t} else {\n\t\t\t// Unknown data.\n\t\t\tconsole.warn(\n\t\t\t\t\"Fluid Handle resolved to data that is not a SharedObject or a DataObject.\",\n\t\t\t);\n\t\t\treturn undefined;\n\t\t}\n\t}\n\n\t/\n\t {@inheritDoc IDisposable.dispose}\n\t /\n\tpublic dispose(): void {\n\t\tif (!this._disposed) {\n\t\t\t// Dispose visualizer nodes.\n\t\t\tfor (const visualizerNode of this.visualizerNodes.values()) {\n\t\t\t\tvisualizerNode.dispose();\n\t\t\t}\n\t\t\tthis.visualizerNodes.clear();\n\n\t\t\tthis._disposed = true;\n\t\t}\n\t}\n}\n\n/\n Wraps a {@link @fluidframework/shared-object-base#ISharedObject} and encapsulates policy for\n * generating visual tree representations of its data.\n \n @remarks\n \n A visual representation can be requested via {@link VisualizerNode.render}.\n \n Additionally, whenever the associated `ISharedObject` is updated (i.e. whenever its \"op\" event is emitted),\n * an updated visual tree will be emitted via this object's {@link SharedObjectListenerEvents \| \"update\" event}.\n /\nexport class VisualizerNode\n\textends TypedEventEmitter<DataVisualizerEvents>\n\timplements IDisposable\n{\n\t/\n\t Handler for {@link VisualizerNode.sharedObject}'s \"op\" event.\n\t * Will broadcast an updated visual tree representation of the DDS's data via the\n\t * {@link SharedObjectListenerEvents \| \"update\"} event.\n\t /\n\tprivate readonly onOpHandler = async (): Promise<boolean> => {\n\t\ttry {\n\t\t\tawait this.emitVisualUpdate();\n\t\t\treturn true;\n\t\t} catch (error) {\n\t\t\tconsole.error(error);\n\t\t\treturn false;\n\t\t}\n\t};\n\n\t/\n\t Private {@link VisualizerNode.disposed} tracking.\n\t /\n\tprivate _disposed: boolean;\n\n\t/\n\t Handles the returned promise for {@link onOpHandler}.\n\t /\n\tprivate readonly syncOpHandler = (): void => {\n\t\tthis.onOpHandler().catch((error) => console.error(error));\n\t};\n\n\tpublic constructor(\n\t\t/\n\t\t The Fluid object whose data will be emitted in visualized form when requested / whenever its data is updated.\n\t\t /\n\t\tpublic readonly sharedObject: ISharedObject,\n\n\t\t/\n\t\t Callback for visualizing {@link VisualizerNode.sharedObject}.\n\t\t * Encapsulates the policies for rendering different kinds of DDSs.\n\t\t /\n\t\tprivate readonly visualizeSharedObject: VisualizeSharedObject,\n\n\t\t/\n\t\t Registers some child handle to a Fluid object for future rendering.\n\t\t \n\t\t @remarks\n\t\t \n\t\t Called during {@link VisualizerNode.render} whenever a Fluid handle is encountered.\n\t\t * Ensures that the consumer of this object's visual tree will be able to request a rendering of the handle's\n\t\t * corresponding DDS as needed.\n\t\t /\n\t\tprivate readonly registerHandle: (\n\t\t\thandle: IFluidHandle,\n\t\t) => Promise<FluidObjectId \| undefined>,\n\t) {\n\t\tsuper();\n\n\t\tthis.sharedObject.on?.(\"op\", this.syncOpHandler);\n\n\t\tthis._disposed = false;\n\t}\n\n\t/\n\t {@inheritDoc IDisposable.disposed}\n\t /\n\tpublic get disposed(): boolean {\n\t\treturn this._disposed;\n\t}\n\n\t/\n\t Emits a {@link VisualizerNode.render \| visual tree representation} of\n\t * {@link VisualizerNode.sharedObject}'s current state as an\n\t * {@link SharedObjectListenerEvents \| \"update\"} event.\n\t /\n\tprivate async emitVisualUpdate(): Promise<void> {\n\t\ttry {\n\t\t\tconst visualTree: FluidObjectNode = await this.render();\n\t\t\tthis.emit(\"update\", visualTree);\n\t\t} catch (error) {\n\t\t\tconsole.log(error);\n\t\t}\n\t}\n\n\t/\n\t Generates a visual description of the associated {@link VisualizerNode.sharedObject}'s\n\t * current state.\n\t \n\t @remarks\n\t \n\t Will recursively render child contents of {@link VisualizerNode.sharedObject}, terminating at\n\t * primitive data and handles to other Fluid objects.\n\t \n\t @returns A visual tree representation of {@link VisualizerNode.sharedObject}.\n\t /\n\tpublic async render(): Promise<FluidObjectNode> {\n\t\treturn this.visualizeSharedObject(this.sharedObject, async (data) =>\n\t\t\tthis.renderChildData(data),\n\t\t);\n\t}\n\n\t/\n\t {@inheritDoc VisualizeChildData}\n\t /\n\tprivate async renderChildData(data: unknown): Promise<VisualChildNode> {\n\t\treturn visualizeChildData(data, this.registerHandle);\n\t}\n\n\t/\n\t {@inheritDoc IDisposable.dispose}\n\t /\n\tpublic dispose(): void {\n\t\tif (!this._disposed) {\n\t\t\tthis.sharedObject.off(\"op\", this.syncOpHandler);\n\t\t\tthis._disposed = true;\n\t\t}\n\t}\n}\n\n/\n See {@link VisualizeChildData}.\n \n @param data - The child data to (recursively) render.\n * @param resolveHandle - Function which accepts an {@link @fluidframework/core-interfaces#(IFluidHandle:interface)}\n * and returns its resolved object ID.\n \n @privateRemarks Exported from this module for testing purposes. This is not intended to be exported by the package.\n /\nexport async function visualizeChildData(\n\tdata: unknown,\n\tresolveHandle: (handle: IFluidHandle) => Promise<FluidObjectId \| undefined>,\n): Promise<VisualChildNode> {\n\t// Special case for `null` because `typeof null === \"object\"`.\n\tif (data === null) {\n\t\treturn {\n\t\t\tvalue: data,\n\t\t\ttypeMetadata: \"null\",\n\t\t\tnodeKind: VisualNodeKind.ValueNode,\n\t\t};\n\t}\n\n\tif (typeof data !== \"object\" && typeof data !== \"function\") {\n\t\t// Render primitives and falsy types via their string representation\n\t\treturn {\n\t\t\tvalue: data as Primitive,\n\t\t\ttypeMetadata: typeof data,\n\t\t\tnodeKind: VisualNodeKind.ValueNode,\n\t\t};\n\t}\n\n\t// eslint-disable-next-line import-x/no-deprecated\n\tif ((data as IProvideFluidHandle)?.IFluidHandle !== undefined) {\n\t\t// If we encounter a Fluid handle, register it for future rendering, and return a node with its ID.\n\t\tconst handle = data as IFluidHandle;\n\t\tconst fluidObjectId = await resolveHandle(handle);\n\t\t// If no ID was found, then the data is not a SharedObject.\n\t\t// In this case, return an \"Unknown Data\" node so consumers can note this (as desired) to the user.\n\t\treturn fluidObjectId === undefined ? unknownObjectNode : createHandleNode(fluidObjectId);\n\t}\n\n\t// Assume any other data must be a record of some kind (since DDS contents must be serializable)\n\t// and simply recurse over its keys.\n\tconst childEntries = Object.entries(data as Record<string \| number \| symbol, unknown>);\n\n\tconst children: Record<string, VisualChildNode> = {};\n\tawait Promise.all(\n\t\tchildEntries.map(async ([key, value]) => {\n\t\t\tconst childNode = await visualizeChildData(value, resolveHandle);\n\t\t\tchildren[key] = childNode;\n\t\t}),\n\t);\n\n\treturn {\n\t\tchildren,\n\t\tnodeKind: VisualNodeKind.TreeNode,\n\t\ttypeMetadata: \"object\",\n\t};\n}\n\n/\n Determines whether or not the provided value is an {@link ISharedObject}, for the purposes of this library.\n * @remarks Implemented by checking for the particular properties / methods we use in this module.\n /\nfunction isSharedObject(value: unknown): value is ISharedObject {\n\treturn (\n\t\t(value as SharedObject).id !== undefined &&\n\t\t(value as SharedObject).attributes?.type !== undefined &&\n\t\t(value as SharedObject).on !== undefined\n\t);\n}\n\n/\n Determines whether or not the provided value is an {@link DataObject} using `instanceof`, for the purposes of this library.\n * @remarks\n * Uses `instanceof` over checking specific properties or methods, because we decided that a version mix-up with\n * {@link @fluidframework/aqueduct#} is unlikely between devtools and end-user applications, and we don't support it anyway.\n /\nfunction isDataObject(value: unknown): value is DataObject {\n\tif (\n\t\tvalue instanceof DataObject \|\|\n\t\t(typeof (value as DataObject).initializeInternal === \"function\" &&\n\t\t\ttypeof (value as { getUninitializedErrorString(): string })\n\t\t\t\t.getUninitializedErrorString) === \"function\"\n\t) {\n\t\t// If root is missing, throw an error instead of returning false\n\t\tconst root = (value as { readonly root?: ISharedDirectory }).root;\n\t\tif (!root) {\n\t\t\tthrow new Error(\"DataObject must have a `root` property, but it was undefined.\");\n\t\t}\n\n\t\treturn true;\n\t}\n\n\treturn false;\n}\n\n/\n Determines whether or not the provided value is a {@link TreeDataObject} using `instanceof`, for the purposes of this library.\n * @remarks\n * Tries to use `instanceof` because we decided that a version mix-up with\n * {@link @fluidframework/aqueduct#} is unlikely between devtools and end-user applications, and we don't support it anyway.\n * In addition, we check for the presence of key properties that make a `TreeDataObject` unique:\n * - `TreeDataObject.tree` getter\n * - `TreeDataObject.treeView` getter\n * - `TreeDataObject.initializeInternal` method\n */\nfunction isTreeDataObject(value: unknown): value is TreeDataObject {\n\tif (\n\t\tvalue instanceof TreeDataObject \|\|\n\t\t(typeof (value as TreeDataObject).initializeInternal === \"function\" &&\n\t\t\tObject.getOwnPropertyDescriptor(Object.getPrototypeOf(value), \"tree\")?.get !== undefined)\n\t) {\n\t\tconst tree = (value as { readonly tree?: ISharedObject }).tree;\n\t\tif (tree === undefined) {\n\t\t\tthrow new Error(\"TreeDataObject must have a `tree` property, but it was undefined.\");\n\t\t}\n\n\t\treturn true;\n\t}\n\n\treturn false;\n}\n"]}

package/lib/packageVersion.d.ts CHANGED Viewed

@@ -5,5 +5,5 @@
  * THIS IS AN AUTOGENERATED FILE. DO NOT EDIT THIS FILE DIRECTLY
  */
 export declare const pkgName = "@fluidframework/devtools-core";
-export declare const pkgVersion = "2.71.0";
+export declare const pkgVersion = "2.73.0";
 //# sourceMappingURL=packageVersion.d.ts.map

package/lib/packageVersion.js CHANGED Viewed

@@ -5,5 +5,5 @@
  * THIS IS AN AUTOGENERATED FILE. DO NOT EDIT THIS FILE DIRECTLY
  */
 export const pkgName = "@fluidframework/devtools-core";
-export const pkgVersion = "2.71.0";
+export const pkgVersion = "2.73.0";
 //# sourceMappingURL=packageVersion.js.map

package/lib/packageVersion.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"packageVersion.js","sourceRoot":"","sources":["../src/packageVersion.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,CAAC,MAAM,OAAO,GAAG,+BAA+B,CAAC;AACvD,MAAM,CAAC,MAAM,UAAU,GAAG,QAAQ,CAAC","sourcesContent":["/!\n Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n \n THIS IS AN AUTOGENERATED FILE. DO NOT EDIT THIS FILE DIRECTLY\n */\n\nexport const pkgName = \"@fluidframework/devtools-core\";\nexport const pkgVersion = \"2.71.0\";\n"]}
1	+ {"version":3,"file":"packageVersion.js","sourceRoot":"","sources":["../src/packageVersion.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,CAAC,MAAM,OAAO,GAAG,+BAA+B,CAAC;AACvD,MAAM,CAAC,MAAM,UAAU,GAAG,QAAQ,CAAC","sourcesContent":["/!\n Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n \n THIS IS AN AUTOGENERATED FILE. DO NOT EDIT THIS FILE DIRECTLY\n */\n\nexport const pkgName = \"@fluidframework/devtools-core\";\nexport const pkgVersion = \"2.73.0\";\n"]}

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@fluidframework/devtools-core",
-  "version": "2.71.0",
+  "version": "2.73.0",
   "description": "Fluid Framework developer tools core functionality",
   "homepage": "https://fluidframework.com",
   "repository": {
@@ -77,37 +77,37 @@
     "temp-directory": "nyc/.nyc_output"
   },
   "dependencies": {
-    "@fluid-internal/client-utils": "~2.71.0",
-    "@fluidframework/aqueduct": "~2.71.0",
-    "@fluidframework/cell": "~2.71.0",
-    "@fluidframework/container-definitions": "~2.71.0",
-    "@fluidframework/container-loader": "~2.71.0",
-    "@fluidframework/container-runtime": "~2.71.0",
-    "@fluidframework/container-runtime-definitions": "~2.71.0",
-    "@fluidframework/core-interfaces": "~2.71.0",
-    "@fluidframework/core-utils": "~2.71.0",
-    "@fluidframework/counter": "~2.71.0",
-    "@fluidframework/datastore-definitions": "~2.71.0",
-    "@fluidframework/driver-definitions": "~2.71.0",
-    "@fluidframework/map": "~2.71.0",
-    "@fluidframework/matrix": "~2.71.0",
-    "@fluidframework/runtime-definitions": "~2.71.0",
-    "@fluidframework/sequence": "~2.71.0",
-    "@fluidframework/shared-object-base": "~2.71.0",
-    "@fluidframework/telemetry-utils": "~2.71.0",
-    "@fluidframework/tree": "~2.71.0"
+    "@fluid-internal/client-utils": "~2.73.0",
+    "@fluidframework/aqueduct": "~2.73.0",
+    "@fluidframework/cell": "~2.73.0",
+    "@fluidframework/container-definitions": "~2.73.0",
+    "@fluidframework/container-loader": "~2.73.0",
+    "@fluidframework/container-runtime": "~2.73.0",
+    "@fluidframework/container-runtime-definitions": "~2.73.0",
+    "@fluidframework/core-interfaces": "~2.73.0",
+    "@fluidframework/core-utils": "~2.73.0",
+    "@fluidframework/counter": "~2.73.0",
+    "@fluidframework/datastore-definitions": "~2.73.0",
+    "@fluidframework/driver-definitions": "~2.73.0",
+    "@fluidframework/map": "~2.73.0",
+    "@fluidframework/matrix": "~2.73.0",
+    "@fluidframework/runtime-definitions": "~2.73.0",
+    "@fluidframework/sequence": "~2.73.0",
+    "@fluidframework/shared-object-base": "~2.73.0",
+    "@fluidframework/telemetry-utils": "~2.73.0",
+    "@fluidframework/tree": "~2.73.0"
   },
   "devDependencies": {
     "@arethetypeswrong/cli": "^0.17.1",
     "@biomejs/biome": "~1.9.3",
-    "@fluid-internal/mocha-test-setup": "~2.71.0",
-    "@fluid-tools/build-cli": "^0.58.3",
+    "@fluid-internal/mocha-test-setup": "~2.73.0",
+    "@fluid-tools/build-cli": "^0.60.0",
     "@fluidframework/build-common": "^2.0.3",
-    "@fluidframework/build-tools": "^0.58.3",
-    "@fluidframework/devtools-core-previous": "npm:@fluidframework/devtools-core@2.70.0",
-    "@fluidframework/eslint-config-fluid": "^7.0.0",
-    "@fluidframework/id-compressor": "~2.71.0",
-    "@fluidframework/test-runtime-utils": "~2.71.0",
+    "@fluidframework/build-tools": "^0.60.0",
+    "@fluidframework/devtools-core-previous": "npm:@fluidframework/devtools-core@2.71.0",
+    "@fluidframework/eslint-config-fluid": "~2.73.0",
+    "@fluidframework/id-compressor": "~2.73.0",
+    "@fluidframework/test-runtime-utils": "~2.73.0",
     "@microsoft/api-extractor": "7.52.11",
     "@types/chai": "^4.0.0",
     "@types/mocha": "^10.0.10",

package/src/data-visualization/DataVisualization.ts CHANGED Viewed

@@ -14,7 +14,7 @@ import type {
 	IFluidHandle,
 	IFluidLoadable,
 } from "@fluidframework/core-interfaces";
-// eslint-disable-next-line import/no-deprecated
+// eslint-disable-next-line import-x/no-deprecated
 import type { IProvideFluidHandle } from "@fluidframework/core-interfaces/internal";
 import type { ISharedDirectory } from "@fluidframework/map/internal";
 import type { ISharedObject, SharedObject } from "@fluidframework/shared-object-base/internal";
@@ -494,7 +494,7 @@ export async function visualizeChildData(
 		};
 	}
-	// eslint-disable-next-line import/no-deprecated
+	// eslint-disable-next-line import-x/no-deprecated
 	if ((data as IProvideFluidHandle)?.IFluidHandle !== undefined) {
 		// If we encounter a Fluid handle, register it for future rendering, and return a node with its ID.
 		const handle = data as IFluidHandle;

package/src/packageVersion.ts CHANGED Viewed

@@ -6,4 +6,4 @@
  */
 export const pkgName = "@fluidframework/devtools-core";
-export const pkgVersion = "2.71.0";
+export const pkgVersion = "2.73.0";