{"_id":"@fluid-experimental/devtools-core","_rev":"92-8792b3a56800d0d3f9a39903b58dba6d","name":"@fluid-experimental/devtools-core","dist-tags":{"latest":"2.0.0-dev.4.4.0.162574","next":"2.0.0-dev.7.4.0.221926","canary":"2.0.0-internal.8.0.8"},"versions":{"2.0.0-dev.4.4.0.162574":{"name":"@fluid-experimental/devtools-core","version":"2.0.0-dev.4.4.0.162574","author":{"name":"Microsoft and contributors"},"license":"MIT","_id":"@fluid-experimental/devtools-core@2.0.0-dev.4.4.0.162574","maintainers":[{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},{"name":"curtisman","email":"curtism@microsoft.com"}],"homepage":"https://fluidframework.com","bugs":{"url":"https://github.com/microsoft/FluidFramework/issues"},"nyc":{"all":true,"exclude":["src/test/**/*.ts","dist/test/**/*.js"],"include":["src/**/*.ts","dist/**/*.js"],"reporter":["cobertura","html","text"],"cache-dir":"nyc/.cache","report-dir":"nyc/report","temp-directory":"nyc/.nyc_output","exclude-after-remap":false},"dist":{"shasum":"f901d0eea6e20cbf2f1a2d463d287e747ebc79a4","tarball":"https://registry.npmjs.org/@fluid-experimental/devtools-core/-/devtools-core-2.0.0-dev.4.4.0.162574.tgz","fileCount":241,"integrity":"sha512-2Roy4+vrJUhr2n8KoN5NiwTlEzWXloTZ8XnDSPYIXg1Fal87aExUKZPj1hVz92yDEKN2sj7sIguDlJPMzntFmg==","signatures":[{"sig":"MEQCIGamXvBmG+y+Pj342JsQLZ5oa5gFOh25i1ceTgXOtpb8AiBZia6i5/w4q74q4rpPHOX4KaR11wA07whCKkEUoMXULQ==","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}],"unpackedSize":557970},"main":"dist/index.js","_from":"file:fluid-experimental-devtools-core-2.0.0-dev.4.4.0.162574.tgz","types":"dist/index.d.ts","scripts":{"tsc":"tsc","lint":"npm run prettier && npm run eslint","test":"npm run test:mocha","build":"concurrently npm:build:compile npm:lint && npm run build:docs","clean":"rimraf _api-extractor-temp nyc dist *.tsbuildinfo *.build.log","eslint":"eslint src","format":"npm run prettier:fix","rebuild":"npm run clean && npm run build","lint:fix":"npm run prettier:fix && npm run eslint:fix","prettier":"prettier --check . --ignore-path ../../../../.prettierignore","build:docs":"api-extractor run --local && copyfiles -u 1 ./_api-extractor-temp/doc-models/* ../../../../_api-extractor-temp/","build:full":"npm run build","eslint:fix":"eslint src --fix","test:mocha":"mocha dist/**/*.test.js --unhandled-rejections=strict --exit","prettier:fix":"prettier --write . --ignore-path ../../../../.prettierignore","build:compile":"npm run tsc","ci:build:docs":"api-extractor run && copyfiles -u 1 ./_api-extractor-temp/doc-models/* ../../../../_api-extractor-temp/","test:coverage":"npm run test:mocha:coverage","format-and-build":"npm run format && npm run build","build:full:compile":"npm run build:compile","format-and-compile":"npm run format && npm run build:compile","test:mocha:coverage":"nyc npm run test:mocha -- --reporter xunit --reporter-option output=nyc/junit-report.xml","test:mocha:multireport":"cross-env FLUID_TEST_MULTIREPORT=1 npm run test:mocha"},"_npmUser":{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},"_resolved":"/mnt/vss/_work/1/pack/scoped/fluid-experimental-devtools-core-2.0.0-dev.4.4.0.162574.tgz","_integrity":"sha512-2Roy4+vrJUhr2n8KoN5NiwTlEzWXloTZ8XnDSPYIXg1Fal87aExUKZPj1hVz92yDEKN2sj7sIguDlJPMzntFmg==","repository":{"url":"git+https://github.com/microsoft/FluidFramework.git","type":"git","directory":"packages/tools/devtools/devtools-core"},"_npmVersion":"8.19.4","description":"Fluid Framework developer tools core functionality","directories":{},"sideEffects":false,"_nodeVersion":"16.20.0","dependencies":{"@fluidframework/map":"2.0.0-dev.4.4.0.162574","@fluidframework/cell":"2.0.0-dev.4.4.0.162574","@fluidframework/matrix":"2.0.0-dev.4.4.0.162574","@fluidframework/counter":"2.0.0-dev.4.4.0.162574","@fluidframework/sequence":"2.0.0-dev.4.4.0.162574","@fluidframework/common-utils":"^1.1.1","@fluidframework/container-utils":"2.0.0-dev.4.4.0.162574","@fluidframework/core-interfaces":"2.0.0-dev.4.4.0.162574","@fluidframework/telemetry-utils":"2.0.0-dev.4.4.0.162574","@fluidframework/container-loader":"2.0.0-dev.4.4.0.162574","@fluidframework/common-definitions":"^0.20.1","@fluidframework/shared-object-base":"2.0.0-dev.4.4.0.162574","@fluidframework/protocol-definitions":"^1.1.0","@fluidframework/container-definitions":"2.0.0-dev.4.4.0.162574"},"_hasShrinkwrap":false,"typeValidation":{"broken":{},"disabled":true},"devDependencies":{"nyc":"^15.1.0","chai":"^4.2.0","mocha":"^10.2.0","eslint":"~8.6.0","events":"^3.1.0","moment":"^2.21.0","rimraf":"^4.4.0","prettier":"~2.6.2","copyfiles":"^2.4.1","cross-env":"^7.0.3","typescript":"~4.5.5","@types/chai":"^4.0.0","@types/mocha":"^9.1.1","concurrently":"^7.6.0","@types/events":"^3.0.0","mocha-multi-reporters":"^1.5.1","eslint-config-prettier":"~8.5.0","@microsoft/api-extractor":"^7.34.4","eslint-plugin-chai-expect":"~3.0.0","mocha-json-output-reporter":"^2.0.1","@fluidframework/build-tools":"^0.17.0","@fluidframework/build-common":"^1.1.0","@fluidframework/mocha-test-setup":"2.0.0-dev.4.4.0.162574","@fluidframework/driver-definitions":"2.0.0-dev.4.4.0.162574","@fluidframework/test-runtime-utils":"2.0.0-dev.4.4.0.162574","@fluidframework/eslint-config-fluid":"^2.0.0"},"_npmOperationalInternal":{"tmp":"tmp/devtools-core_2.0.0-dev.4.4.0.162574_1685038902055_0.9411638521975234","host":"s3://npm-registry-packages"}},"2.0.0-internal.4.4.0":{"name":"@fluid-experimental/devtools-core","version":"2.0.0-internal.4.4.0","author":{"name":"Microsoft and contributors"},"license":"MIT","_id":"@fluid-experimental/devtools-core@2.0.0-internal.4.4.0","maintainers":[{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},{"name":"curtisman","email":"curtism@microsoft.com"}],"homepage":"https://fluidframework.com","bugs":{"url":"https://github.com/microsoft/FluidFramework/issues"},"nyc":{"all":true,"exclude":["src/test/**/*.ts","dist/test/**/*.js"],"include":["src/**/*.ts","dist/**/*.js"],"reporter":["cobertura","html","text"],"cache-dir":"nyc/.cache","report-dir":"nyc/report","temp-directory":"nyc/.nyc_output","exclude-after-remap":false},"dist":{"shasum":"b09f823821ee88caad561d3c876d50b7c9225e57","tarball":"https://registry.npmjs.org/@fluid-experimental/devtools-core/-/devtools-core-2.0.0-internal.4.4.0.tgz","fileCount":242,"integrity":"sha512-LTBf2vDo5cpuL4h9CIhnpCLEIrIAwh5725uma1jVSgcY9witMd5dfSZZjq+3ZqIe4njIcqAxcTsuFi94+DqFWA==","signatures":[{"sig":"MEUCIHg7/SipvXkRnoQzfnHts1m9Ax/hamt+lYdzTyiWe5DxAiEApl3QE6aUDa8LF8o4GocWkQJ1VuRifvmcv60gey+xLZ0=","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}],"unpackedSize":560749},"main":"dist/index.js","_from":"file:fluid-experimental-devtools-core-2.0.0-internal.4.4.0.tgz","types":"dist/index.d.ts","readme":"# @fluid-experimental/devtools-core\n\nThis library contains developer tools for use alongside the Fluid Framework.\nIt is used to power our associated browser extensions.\n\nTODO: link to extensions once they are published.\n\n\n\n\n\n\n## Installation\n\nTo get started, install the package by running the following command:\n\n```bash\nnpm i @fluid-experimental/devtools-core -D\n```\n\n\n\n\n\n## Usage\n\nThe Devtools' API surface is designed to fit nicely into most application flows.\n\n### Initialization\n\nTo initialize a debugger session for your container, call `initializeDevtools`.\nThis function accepts a `DevtoolsLogger` for recording and communicating telemetry data, a list of initial Fluid `Containers` to associate with the session, and (optionally) customized data visualization configurations for visualizing `Container` data.\n\nTODO: link to API docs once API shape has settled.\n\n### Clean-up\n\nThe Devtools object is managed as a global singleton.\nThat singleton is automatically cleaned up prior to the Window's \"unload\" event.\nSo typical application flows likely won't need to worry about cleanup.\nThat said, if you wish to have tighter control over when the Devtools are torn down, you can simply call the `dispose` method on the handle returned by [initialization](#initialization).\n\n## Related Tooling\n\nThis library is designed to work alongside our Chromium browser extension.\n\nTODO: link to code on github once package names have been finalized.\nTODO: link to the various browsers' webstore pages for our extension once it has been publiched.\n\n## Working in the package\n\n### Build\n\nTo build the package locally, first ensure you have run `pnpm install` from the root of the mono-repo.\nNext, to build the code, run `npm run build` from the root of the mono-repo, or use [fluid-build](https://github.com/microsoft/FluidFramework/tree/main/build-tools/packages/build-tools#running-fluid-build-command-line) via `fluid-build -s build`.\n\n- Note: Once you have run a build from the root, assuming no other changes outside of this package, you may run `npm run build` directly within this directory for a faster build.\n If you make changes to any of this package's local dependencies, you will need to run a build again from the root before building again from directly within this package.\n\n### Test\n\nTo run the tests, first ensure you have followed the [build](#build) steps above.\nNext, run `npm run test` from a terminal within this directory.\n\n\n\n\n\n\n\n## API Documentation\n\nAPI documentation for **@fluid-experimental/devtools-core** is available at .\n\n\n\n\n\n\n\n\n\n\n## Contribution Guidelines\n\nThere are many ways to [contribute](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md) to Fluid.\n\n- Participate in Q&A in our [GitHub Discussions](https://github.com/microsoft/FluidFramework/discussions).\n- [Submit bugs](https://github.com/microsoft/FluidFramework/issues) and help us verify fixes as they are checked in.\n- Review the [source code changes](https://github.com/microsoft/FluidFramework/pulls).\n- [Contribute bug fixes](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md).\n\nDetailed instructions for working in the repo can be found in the [Wiki](https://github.com/microsoft/FluidFramework/wiki).\n\nThis project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).\nFor more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\nUse of these trademarks or logos must follow Microsoft’s [Trademark & Brand Guidelines](https://www.microsoft.com/trademarks).\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n\n\n\n## Help\n\nNot finding what you're looking for in this README? Check out our [GitHub\nWiki](https://github.com/microsoft/FluidFramework/wiki) or [fluidframework.com](https://fluidframework.com/docs/).\n\nStill not finding what you're looking for? Please [file an\nissue](https://github.com/microsoft/FluidFramework/wiki/Submitting-Bugs-and-Feature-Requests).\n\nThank you!\n\n\n\n\n\n\n\n\n\n\n## Trademark\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\n\nUse of these trademarks or logos must follow Microsoft's [Trademark & Brand\nGuidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general).\n\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n","scripts":{"tsc":"tsc","lint":"npm run prettier && npm run eslint","test":"npm run test:mocha","build":"concurrently npm:build:compile npm:lint && npm run build:docs","clean":"rimraf _api-extractor-temp nyc dist *.tsbuildinfo *.build.log","eslint":"eslint src","format":"npm run prettier:fix","rebuild":"npm run clean && npm run build","lint:fix":"npm run prettier:fix && npm run eslint:fix","prettier":"prettier --check . --ignore-path ../../../../.prettierignore","build:docs":"api-extractor run --local && copyfiles -u 1 ./_api-extractor-temp/doc-models/* ../../../../_api-extractor-temp/","build:full":"npm run build","eslint:fix":"eslint src --fix","test:mocha":"mocha dist/**/*.test.js --unhandled-rejections=strict --exit","prettier:fix":"prettier --write . --ignore-path ../../../../.prettierignore","build:compile":"npm run tsc","ci:build:docs":"api-extractor run && copyfiles -u 1 ./_api-extractor-temp/doc-models/* ../../../../_api-extractor-temp/","test:coverage":"npm run test:mocha:coverage","format-and-build":"npm run format && npm run build","build:full:compile":"npm run build:compile","format-and-compile":"npm run format && npm run build:compile","test:mocha:coverage":"nyc npm run test:mocha -- --reporter xunit --reporter-option output=nyc/junit-report.xml","test:mocha:multireport":"cross-env FLUID_TEST_MULTIREPORT=1 npm run test:mocha"},"_npmUser":{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},"_resolved":"/mnt/vss/_work/1/pack/scoped/fluid-experimental-devtools-core-2.0.0-internal.4.4.0.tgz","_integrity":"sha512-LTBf2vDo5cpuL4h9CIhnpCLEIrIAwh5725uma1jVSgcY9witMd5dfSZZjq+3ZqIe4njIcqAxcTsuFi94+DqFWA==","repository":{"url":"git+https://github.com/microsoft/FluidFramework.git","type":"git","directory":"packages/tools/devtools/devtools-core"},"_npmVersion":"8.19.4","description":"Fluid Framework developer tools core functionality","directories":{},"sideEffects":false,"_nodeVersion":"16.20.0","dependencies":{"@fluidframework/map":">=2.0.0-internal.4.4.0 <2.0.0-internal.4.5.0","@fluidframework/cell":">=2.0.0-internal.4.4.0 <2.0.0-internal.4.5.0","@fluidframework/matrix":">=2.0.0-internal.4.4.0 <2.0.0-internal.4.5.0","@fluidframework/counter":">=2.0.0-internal.4.4.0 <2.0.0-internal.4.5.0","@fluidframework/sequence":">=2.0.0-internal.4.4.0 <2.0.0-internal.4.5.0","@fluidframework/common-utils":"^1.1.1","@fluidframework/container-utils":">=2.0.0-internal.4.4.0 <2.0.0-internal.4.5.0","@fluidframework/core-interfaces":">=2.0.0-internal.4.4.0 <2.0.0-internal.4.5.0","@fluidframework/telemetry-utils":">=2.0.0-internal.4.4.0 <2.0.0-internal.4.5.0","@fluidframework/container-loader":">=2.0.0-internal.4.4.0 <2.0.0-internal.4.5.0","@fluidframework/common-definitions":"^0.20.1","@fluidframework/shared-object-base":">=2.0.0-internal.4.4.0 <2.0.0-internal.4.5.0","@fluidframework/protocol-definitions":"^1.1.0","@fluidframework/container-definitions":">=2.0.0-internal.4.4.0 <2.0.0-internal.4.5.0"},"_hasShrinkwrap":false,"readmeFilename":"README.md","typeValidation":{"broken":{},"disabled":true},"devDependencies":{"nyc":"^15.1.0","chai":"^4.2.0","mocha":"^10.2.0","eslint":"~8.6.0","events":"^3.1.0","moment":"^2.21.0","rimraf":"^4.4.0","prettier":"~2.6.2","copyfiles":"^2.4.1","cross-env":"^7.0.3","typescript":"~4.5.5","@types/chai":"^4.0.0","@types/mocha":"^9.1.1","concurrently":"^7.6.0","@types/events":"^3.0.0","mocha-multi-reporters":"^1.5.1","eslint-config-prettier":"~8.5.0","@microsoft/api-extractor":"^7.34.4","eslint-plugin-chai-expect":"~3.0.0","mocha-json-output-reporter":"^2.0.1","@fluidframework/build-tools":"^0.17.0","@fluidframework/build-common":"^1.1.0","@fluidframework/mocha-test-setup":">=2.0.0-internal.4.4.0 <2.0.0-internal.4.5.0","@fluidframework/driver-definitions":">=2.0.0-internal.4.4.0 <2.0.0-internal.4.5.0","@fluidframework/test-runtime-utils":">=2.0.0-internal.4.4.0 <2.0.0-internal.4.5.0","@fluidframework/eslint-config-fluid":"^2.0.0"},"_npmOperationalInternal":{"tmp":"tmp/devtools-core_2.0.0-internal.4.4.0_1685987143184_0.9249453661861926","host":"s3://npm-registry-packages"}},"2.0.0-internal.5.0.0":{"name":"@fluid-experimental/devtools-core","version":"2.0.0-internal.5.0.0","author":{"name":"Microsoft and contributors"},"license":"MIT","_id":"@fluid-experimental/devtools-core@2.0.0-internal.5.0.0","maintainers":[{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},{"name":"curtisman","email":"curtism@microsoft.com"}],"homepage":"https://fluidframework.com","bugs":{"url":"https://github.com/microsoft/FluidFramework/issues"},"nyc":{"all":true,"exclude":["src/test/**/*.ts","dist/test/**/*.js"],"include":["src/**/*.ts","dist/**/*.js"],"reporter":["cobertura","html","text"],"cache-dir":"nyc/.cache","report-dir":"nyc/report","temp-directory":"nyc/.nyc_output","exclude-after-remap":false},"dist":{"shasum":"69d916d66cedfab6d4d4772c557c5119878aa395","tarball":"https://registry.npmjs.org/@fluid-experimental/devtools-core/-/devtools-core-2.0.0-internal.5.0.0.tgz","fileCount":242,"integrity":"sha512-ZL6nOpmf//Rhfd7xbGm0qNsf3urmGIfDS3xMcbrPFmx0Y5LqHCDfOPLX7QVRjV3G8sxKiqSLJY2nX08mUirY3w==","signatures":[{"sig":"MEYCIQCLIybi2shshSvleW/ZIk0o0vkZmFVFJksaDnPJuBJS1gIhAOw9AkWWFbwJeRS4QT8/pTpTo7r41BFkPw2+Il8ACypj","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}],"unpackedSize":560800},"main":"dist/index.js","_from":"file:fluid-experimental-devtools-core-2.0.0-internal.5.0.0.tgz","types":"dist/index.d.ts","readme":"# @fluid-experimental/devtools-core\n\nThis library contains developer tools for use alongside the Fluid Framework.\nIt is used to power our associated browser extensions.\n\nTODO: link to extensions once they are published.\n\n\n\n\n\n\n## Installation\n\nTo get started, install the package by running the following command:\n\n```bash\nnpm i @fluid-experimental/devtools-core -D\n```\n\n\n\n\n\n## Usage\n\nThe Devtools' API surface is designed to fit nicely into most application flows.\n\n### Initialization\n\nTo initialize a debugger session for your container, call `initializeDevtools`.\nThis function accepts a `DevtoolsLogger` for recording and communicating telemetry data, a list of initial Fluid `Containers` to associate with the session, and (optionally) customized data visualization configurations for visualizing `Container` data.\n\nTODO: link to API docs once API shape has settled.\n\n### Clean-up\n\nThe Devtools object is managed as a global singleton.\nThat singleton is automatically cleaned up prior to the Window's \"unload\" event.\nSo typical application flows likely won't need to worry about cleanup.\nThat said, if you wish to have tighter control over when the Devtools are torn down, you can simply call the `dispose` method on the handle returned by [initialization](#initialization).\n\n## Related Tooling\n\nThis library is designed to work alongside our Chromium browser extension.\n\nTODO: link to code on github once package names have been finalized.\nTODO: link to the various browsers' webstore pages for our extension once it has been publiched.\n\n## Working in the package\n\n### Build\n\nTo build the package locally, first ensure you have run `pnpm install` from the root of the mono-repo.\nNext, to build the code, run `npm run build` from the root of the mono-repo, or use [fluid-build](https://github.com/microsoft/FluidFramework/tree/main/build-tools/packages/build-tools#running-fluid-build-command-line) via `fluid-build -s build`.\n\n- Note: Once you have run a build from the root, assuming no other changes outside of this package, you may run `npm run build` directly within this directory for a faster build.\n If you make changes to any of this package's local dependencies, you will need to run a build again from the root before building again from directly within this package.\n\n### Test\n\nTo run the tests, first ensure you have followed the [build](#build) steps above.\nNext, run `npm run test` from a terminal within this directory.\n\n\n\n\n\n\n\n## API Documentation\n\nAPI documentation for **@fluid-experimental/devtools-core** is available at .\n\n\n\n\n\n\n\n\n\n\n## Contribution Guidelines\n\nThere are many ways to [contribute](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md) to Fluid.\n\n- Participate in Q&A in our [GitHub Discussions](https://github.com/microsoft/FluidFramework/discussions).\n- [Submit bugs](https://github.com/microsoft/FluidFramework/issues) and help us verify fixes as they are checked in.\n- Review the [source code changes](https://github.com/microsoft/FluidFramework/pulls).\n- [Contribute bug fixes](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md).\n\nDetailed instructions for working in the repo can be found in the [Wiki](https://github.com/microsoft/FluidFramework/wiki).\n\nThis project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).\nFor more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\nUse of these trademarks or logos must follow Microsoft’s [Trademark & Brand Guidelines](https://www.microsoft.com/trademarks).\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n\n\n\n## Help\n\nNot finding what you're looking for in this README? Check out our [GitHub\nWiki](https://github.com/microsoft/FluidFramework/wiki) or [fluidframework.com](https://fluidframework.com/docs/).\n\nStill not finding what you're looking for? Please [file an\nissue](https://github.com/microsoft/FluidFramework/wiki/Submitting-Bugs-and-Feature-Requests).\n\nThank you!\n\n\n\n\n\n\n\n\n\n\n## Trademark\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\n\nUse of these trademarks or logos must follow Microsoft's [Trademark & Brand\nGuidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general).\n\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n","scripts":{"tsc":"tsc","lint":"npm run prettier && npm run eslint","test":"npm run test:mocha","build":"concurrently npm:build:compile npm:lint && npm run build:docs","clean":"rimraf _api-extractor-temp nyc dist *.tsbuildinfo *.build.log","eslint":"eslint src","format":"npm run prettier:fix","rebuild":"npm run clean && npm run build","lint:fix":"npm run prettier:fix && npm run eslint:fix","prettier":"prettier --check . --ignore-path ../../../../.prettierignore","build:docs":"api-extractor run --local && copyfiles -u 1 ./_api-extractor-temp/doc-models/* ../../../../_api-extractor-temp/","build:full":"npm run build","eslint:fix":"eslint src --fix","test:mocha":"mocha dist/**/*.test.js --unhandled-rejections=strict --exit","prettier:fix":"prettier --write . --ignore-path ../../../../.prettierignore","build:compile":"npm run tsc","ci:build:docs":"api-extractor run && copyfiles -u 1 ./_api-extractor-temp/doc-models/* ../../../../_api-extractor-temp/","test:coverage":"npm run test:mocha:coverage","format-and-build":"npm run format && npm run build","build:full:compile":"npm run build:compile","format-and-compile":"npm run format && npm run build:compile","test:mocha:coverage":"nyc npm run test:mocha -- --reporter xunit --reporter-option output=nyc/junit-report.xml","test:mocha:multireport":"cross-env FLUID_TEST_MULTIREPORT=1 npm run test:mocha"},"_npmUser":{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},"_resolved":"/mnt/vss/_work/1/pack/scoped/fluid-experimental-devtools-core-2.0.0-internal.5.0.0.tgz","_integrity":"sha512-ZL6nOpmf//Rhfd7xbGm0qNsf3urmGIfDS3xMcbrPFmx0Y5LqHCDfOPLX7QVRjV3G8sxKiqSLJY2nX08mUirY3w==","repository":{"url":"git+https://github.com/microsoft/FluidFramework.git","type":"git","directory":"packages/tools/devtools/devtools-core"},"_npmVersion":"8.19.4","description":"Fluid Framework developer tools core functionality","directories":{},"sideEffects":false,"_nodeVersion":"16.20.0","dependencies":{"@fluidframework/map":">=2.0.0-internal.5.0.0 <2.0.0-internal.5.1.0","@fluidframework/cell":">=2.0.0-internal.5.0.0 <2.0.0-internal.5.1.0","@fluidframework/matrix":">=2.0.0-internal.5.0.0 <2.0.0-internal.5.1.0","@fluidframework/counter":">=2.0.0-internal.5.0.0 <2.0.0-internal.5.1.0","@fluidframework/sequence":">=2.0.0-internal.5.0.0 <2.0.0-internal.5.1.0","@fluidframework/common-utils":"^1.1.1","@fluidframework/container-utils":">=2.0.0-internal.5.0.0 <2.0.0-internal.5.1.0","@fluidframework/core-interfaces":">=2.0.0-internal.5.0.0 <2.0.0-internal.5.1.0","@fluidframework/telemetry-utils":">=2.0.0-internal.5.0.0 <2.0.0-internal.5.1.0","@fluidframework/container-loader":">=2.0.0-internal.5.0.0 <2.0.0-internal.5.1.0","@fluidframework/common-definitions":"^0.20.1","@fluidframework/shared-object-base":">=2.0.0-internal.5.0.0 <2.0.0-internal.5.1.0","@fluidframework/protocol-definitions":"^1.1.0","@fluidframework/container-definitions":">=2.0.0-internal.5.0.0 <2.0.0-internal.5.1.0"},"_hasShrinkwrap":false,"readmeFilename":"README.md","typeValidation":{"broken":{},"disabled":true},"devDependencies":{"nyc":"^15.1.0","chai":"^4.2.0","mocha":"^10.2.0","eslint":"~8.6.0","events":"^3.1.0","moment":"^2.21.0","rimraf":"^4.4.0","prettier":"~2.6.2","copyfiles":"^2.4.1","cross-env":"^7.0.3","typescript":"~4.5.5","@types/chai":"^4.0.0","@types/mocha":"^9.1.1","concurrently":"^7.6.0","@types/events":"^3.0.0","mocha-multi-reporters":"^1.5.1","eslint-config-prettier":"~8.5.0","@microsoft/api-extractor":"^7.34.4","eslint-plugin-chai-expect":"~3.0.0","mocha-json-output-reporter":"^2.0.1","@fluidframework/build-tools":"^0.17.0","@fluidframework/build-common":"^1.1.0","@fluidframework/mocha-test-setup":">=2.0.0-internal.5.0.0 <2.0.0-internal.5.1.0","@fluidframework/driver-definitions":">=2.0.0-internal.5.0.0 <2.0.0-internal.5.1.0","@fluidframework/test-runtime-utils":">=2.0.0-internal.5.0.0 <2.0.0-internal.5.1.0","@fluidframework/eslint-config-fluid":"^2.0.0"},"_npmOperationalInternal":{"tmp":"tmp/devtools-core_2.0.0-internal.5.0.0_1686012113393_0.9896354477761382","host":"s3://npm-registry-packages"}},"2.0.0-internal.4.4.1":{"name":"@fluid-experimental/devtools-core","version":"2.0.0-internal.4.4.1","author":{"name":"Microsoft and contributors"},"license":"MIT","_id":"@fluid-experimental/devtools-core@2.0.0-internal.4.4.1","maintainers":[{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},{"name":"curtisman","email":"curtism@microsoft.com"}],"homepage":"https://fluidframework.com","bugs":{"url":"https://github.com/microsoft/FluidFramework/issues"},"nyc":{"all":true,"exclude":["src/test/**/*.ts","dist/test/**/*.js"],"include":["src/**/*.ts","dist/**/*.js"],"reporter":["cobertura","html","text"],"cache-dir":"nyc/.cache","report-dir":"nyc/report","temp-directory":"nyc/.nyc_output","exclude-after-remap":false},"dist":{"shasum":"9776e8f38cff90cc1704abad6e0086bd166d6fa5","tarball":"https://registry.npmjs.org/@fluid-experimental/devtools-core/-/devtools-core-2.0.0-internal.4.4.1.tgz","fileCount":242,"integrity":"sha512-ztft5cxEyzAUMdUasavjL/7cGOt0quikltfVYJVlw+yhn3CNJOmAdsyp9pwWGy3CWDMMFncjUKIo7IXJzBxvCg==","signatures":[{"sig":"MEUCIAXj1oVBxk161GvH/VFT0A6Y4UD4QojN/Kfv7qehwo5MAiEA+xHJjPXbyyomMXYJCSdOJN+nKQLevjyxQlA+WycItGg=","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}],"unpackedSize":560749},"main":"dist/index.js","_from":"file:fluid-experimental-devtools-core-2.0.0-internal.4.4.1.tgz","types":"dist/index.d.ts","readme":"# @fluid-experimental/devtools-core\n\nThis library contains developer tools for use alongside the Fluid Framework.\nIt is used to power our associated browser extensions.\n\nTODO: link to extensions once they are published.\n\n\n\n\n\n\n## Installation\n\nTo get started, install the package by running the following command:\n\n```bash\nnpm i @fluid-experimental/devtools-core -D\n```\n\n\n\n\n\n## Usage\n\nThe Devtools' API surface is designed to fit nicely into most application flows.\n\n### Initialization\n\nTo initialize a debugger session for your container, call `initializeDevtools`.\nThis function accepts a `DevtoolsLogger` for recording and communicating telemetry data, a list of initial Fluid `Containers` to associate with the session, and (optionally) customized data visualization configurations for visualizing `Container` data.\n\nTODO: link to API docs once API shape has settled.\n\n### Clean-up\n\nThe Devtools object is managed as a global singleton.\nThat singleton is automatically cleaned up prior to the Window's \"unload\" event.\nSo typical application flows likely won't need to worry about cleanup.\nThat said, if you wish to have tighter control over when the Devtools are torn down, you can simply call the `dispose` method on the handle returned by [initialization](#initialization).\n\n## Related Tooling\n\nThis library is designed to work alongside our Chromium browser extension.\n\nTODO: link to code on github once package names have been finalized.\nTODO: link to the various browsers' webstore pages for our extension once it has been publiched.\n\n## Working in the package\n\n### Build\n\nTo build the package locally, first ensure you have run `pnpm install` from the root of the mono-repo.\nNext, to build the code, run `npm run build` from the root of the mono-repo, or use [fluid-build](https://github.com/microsoft/FluidFramework/tree/main/build-tools/packages/build-tools#running-fluid-build-command-line) via `fluid-build -s build`.\n\n- Note: Once you have run a build from the root, assuming no other changes outside of this package, you may run `npm run build` directly within this directory for a faster build.\n If you make changes to any of this package's local dependencies, you will need to run a build again from the root before building again from directly within this package.\n\n### Test\n\nTo run the tests, first ensure you have followed the [build](#build) steps above.\nNext, run `npm run test` from a terminal within this directory.\n\n\n\n\n\n\n\n## API Documentation\n\nAPI documentation for **@fluid-experimental/devtools-core** is available at .\n\n\n\n\n\n\n\n\n\n\n## Contribution Guidelines\n\nThere are many ways to [contribute](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md) to Fluid.\n\n- Participate in Q&A in our [GitHub Discussions](https://github.com/microsoft/FluidFramework/discussions).\n- [Submit bugs](https://github.com/microsoft/FluidFramework/issues) and help us verify fixes as they are checked in.\n- Review the [source code changes](https://github.com/microsoft/FluidFramework/pulls).\n- [Contribute bug fixes](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md).\n\nDetailed instructions for working in the repo can be found in the [Wiki](https://github.com/microsoft/FluidFramework/wiki).\n\nThis project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).\nFor more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\nUse of these trademarks or logos must follow Microsoft’s [Trademark & Brand Guidelines](https://www.microsoft.com/trademarks).\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n\n\n\n## Help\n\nNot finding what you're looking for in this README? Check out our [GitHub\nWiki](https://github.com/microsoft/FluidFramework/wiki) or [fluidframework.com](https://fluidframework.com/docs/).\n\nStill not finding what you're looking for? Please [file an\nissue](https://github.com/microsoft/FluidFramework/wiki/Submitting-Bugs-and-Feature-Requests).\n\nThank you!\n\n\n\n\n\n\n\n\n\n\n## Trademark\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\n\nUse of these trademarks or logos must follow Microsoft's [Trademark & Brand\nGuidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general).\n\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n","scripts":{"tsc":"tsc","lint":"npm run prettier && npm run eslint","test":"npm run test:mocha","build":"concurrently npm:build:compile npm:lint && npm run build:docs","clean":"rimraf _api-extractor-temp nyc dist *.tsbuildinfo *.build.log","eslint":"eslint src","format":"npm run prettier:fix","rebuild":"npm run clean && npm run build","lint:fix":"npm run prettier:fix && npm run eslint:fix","prettier":"prettier --check . --ignore-path ../../../../.prettierignore","build:docs":"api-extractor run --local && copyfiles -u 1 ./_api-extractor-temp/doc-models/* ../../../../_api-extractor-temp/","build:full":"npm run build","eslint:fix":"eslint src --fix","test:mocha":"mocha dist/**/*.test.js --unhandled-rejections=strict --exit","prettier:fix":"prettier --write . --ignore-path ../../../../.prettierignore","build:compile":"npm run tsc","ci:build:docs":"api-extractor run && copyfiles -u 1 ./_api-extractor-temp/doc-models/* ../../../../_api-extractor-temp/","test:coverage":"npm run test:mocha:coverage","format-and-build":"npm run format && npm run build","build:full:compile":"npm run build:compile","format-and-compile":"npm run format && npm run build:compile","test:mocha:coverage":"nyc npm run test:mocha -- --reporter xunit --reporter-option output=nyc/junit-report.xml","test:mocha:multireport":"cross-env FLUID_TEST_MULTIREPORT=1 npm run test:mocha"},"_npmUser":{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},"_resolved":"/mnt/vss/_work/1/pack/scoped/fluid-experimental-devtools-core-2.0.0-internal.4.4.1.tgz","_integrity":"sha512-ztft5cxEyzAUMdUasavjL/7cGOt0quikltfVYJVlw+yhn3CNJOmAdsyp9pwWGy3CWDMMFncjUKIo7IXJzBxvCg==","repository":{"url":"git+https://github.com/microsoft/FluidFramework.git","type":"git","directory":"packages/tools/devtools/devtools-core"},"_npmVersion":"8.19.4","description":"Fluid Framework developer tools core functionality","directories":{},"sideEffects":false,"_nodeVersion":"16.20.0","dependencies":{"@fluidframework/map":">=2.0.0-internal.4.4.1 <2.0.0-internal.4.5.0","@fluidframework/cell":">=2.0.0-internal.4.4.1 <2.0.0-internal.4.5.0","@fluidframework/matrix":">=2.0.0-internal.4.4.1 <2.0.0-internal.4.5.0","@fluidframework/counter":">=2.0.0-internal.4.4.1 <2.0.0-internal.4.5.0","@fluidframework/sequence":">=2.0.0-internal.4.4.1 <2.0.0-internal.4.5.0","@fluidframework/common-utils":"^1.1.1","@fluidframework/container-utils":">=2.0.0-internal.4.4.1 <2.0.0-internal.4.5.0","@fluidframework/core-interfaces":">=2.0.0-internal.4.4.1 <2.0.0-internal.4.5.0","@fluidframework/telemetry-utils":">=2.0.0-internal.4.4.1 <2.0.0-internal.4.5.0","@fluidframework/container-loader":">=2.0.0-internal.4.4.1 <2.0.0-internal.4.5.0","@fluidframework/common-definitions":"^0.20.1","@fluidframework/shared-object-base":">=2.0.0-internal.4.4.1 <2.0.0-internal.4.5.0","@fluidframework/protocol-definitions":"^1.1.0","@fluidframework/container-definitions":">=2.0.0-internal.4.4.1 <2.0.0-internal.4.5.0"},"_hasShrinkwrap":false,"readmeFilename":"README.md","typeValidation":{"broken":{},"disabled":true},"devDependencies":{"nyc":"^15.1.0","chai":"^4.2.0","mocha":"^10.2.0","eslint":"~8.6.0","events":"^3.1.0","moment":"^2.21.0","rimraf":"^4.4.0","prettier":"~2.6.2","copyfiles":"^2.4.1","cross-env":"^7.0.3","typescript":"~4.5.5","@types/chai":"^4.0.0","@types/mocha":"^9.1.1","concurrently":"^7.6.0","@types/events":"^3.0.0","mocha-multi-reporters":"^1.5.1","eslint-config-prettier":"~8.5.0","@microsoft/api-extractor":"^7.34.4","eslint-plugin-chai-expect":"~3.0.0","mocha-json-output-reporter":"^2.0.1","@fluidframework/build-tools":"^0.18.2","@fluidframework/build-common":"^1.1.0","@fluidframework/mocha-test-setup":">=2.0.0-internal.4.4.1 <2.0.0-internal.4.5.0","@fluidframework/driver-definitions":">=2.0.0-internal.4.4.1 <2.0.0-internal.4.5.0","@fluidframework/test-runtime-utils":">=2.0.0-internal.4.4.1 <2.0.0-internal.4.5.0","@fluidframework/eslint-config-fluid":"^2.0.0"},"_npmOperationalInternal":{"tmp":"tmp/devtools-core_2.0.0-internal.4.4.1_1686773527685_0.7389650613195711","host":"s3://npm-registry-packages"}},"2.0.0-internal.5.0.1":{"name":"@fluid-experimental/devtools-core","version":"2.0.0-internal.5.0.1","author":{"name":"Microsoft and contributors"},"license":"MIT","_id":"@fluid-experimental/devtools-core@2.0.0-internal.5.0.1","maintainers":[{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},{"name":"curtisman","email":"curtism@microsoft.com"}],"homepage":"https://fluidframework.com","bugs":{"url":"https://github.com/microsoft/FluidFramework/issues"},"nyc":{"all":true,"exclude":["src/test/**/*.ts","dist/test/**/*.js"],"include":["src/**/*.ts","dist/**/*.js"],"reporter":["cobertura","html","text"],"cache-dir":"nyc/.cache","report-dir":"nyc/report","temp-directory":"nyc/.nyc_output","exclude-after-remap":false},"dist":{"shasum":"9a9dfea9328359b444cf729c37fd065d2a54c946","tarball":"https://registry.npmjs.org/@fluid-experimental/devtools-core/-/devtools-core-2.0.0-internal.5.0.1.tgz","fileCount":242,"integrity":"sha512-yQV5mybE2HmCPZAjiGaoZaJnFtEcyriLClnUyz/E8EHly+unWq0CohtuT8h04aSjhq0rq+1iXqJaMA27gkdVUA==","signatures":[{"sig":"MEUCIQDbrv5ixwAnv4x2XttEs4x6scjpQBPZIy0sYPYYzjEL5gIgSjMLtNsw1qTE9CwgYfeVSk1t28Hb48Zb2WcnQhXMPBQ=","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}],"unpackedSize":560800},"main":"dist/index.js","_from":"file:fluid-experimental-devtools-core-2.0.0-internal.5.0.1.tgz","types":"dist/index.d.ts","readme":"# @fluid-experimental/devtools-core\n\nThis library contains developer tools for use alongside the Fluid Framework.\nIt is used to power our associated browser extensions.\n\nTODO: link to extensions once they are published.\n\n\n\n\n\n\n## Installation\n\nTo get started, install the package by running the following command:\n\n```bash\nnpm i @fluid-experimental/devtools-core -D\n```\n\n\n\n\n\n## Usage\n\nThe Devtools' API surface is designed to fit nicely into most application flows.\n\n### Initialization\n\nTo initialize a debugger session for your container, call `initializeDevtools`.\nThis function accepts a `DevtoolsLogger` for recording and communicating telemetry data, a list of initial Fluid `Containers` to associate with the session, and (optionally) customized data visualization configurations for visualizing `Container` data.\n\nTODO: link to API docs once API shape has settled.\n\n### Clean-up\n\nThe Devtools object is managed as a global singleton.\nThat singleton is automatically cleaned up prior to the Window's \"unload\" event.\nSo typical application flows likely won't need to worry about cleanup.\nThat said, if you wish to have tighter control over when the Devtools are torn down, you can simply call the `dispose` method on the handle returned by [initialization](#initialization).\n\n## Related Tooling\n\nThis library is designed to work alongside our Chromium browser extension.\n\nTODO: link to code on github once package names have been finalized.\nTODO: link to the various browsers' webstore pages for our extension once it has been publiched.\n\n## Working in the package\n\n### Build\n\nTo build the package locally, first ensure you have run `pnpm install` from the root of the mono-repo.\nNext, to build the code, run `npm run build` from the root of the mono-repo, or use [fluid-build](https://github.com/microsoft/FluidFramework/tree/main/build-tools/packages/build-tools#running-fluid-build-command-line) via `fluid-build -s build`.\n\n- Note: Once you have run a build from the root, assuming no other changes outside of this package, you may run `npm run build` directly within this directory for a faster build.\n If you make changes to any of this package's local dependencies, you will need to run a build again from the root before building again from directly within this package.\n\n### Test\n\nTo run the tests, first ensure you have followed the [build](#build) steps above.\nNext, run `npm run test` from a terminal within this directory.\n\n\n\n\n\n\n\n## API Documentation\n\nAPI documentation for **@fluid-experimental/devtools-core** is available at .\n\n\n\n\n\n\n\n\n\n\n## Contribution Guidelines\n\nThere are many ways to [contribute](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md) to Fluid.\n\n- Participate in Q&A in our [GitHub Discussions](https://github.com/microsoft/FluidFramework/discussions).\n- [Submit bugs](https://github.com/microsoft/FluidFramework/issues) and help us verify fixes as they are checked in.\n- Review the [source code changes](https://github.com/microsoft/FluidFramework/pulls).\n- [Contribute bug fixes](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md).\n\nDetailed instructions for working in the repo can be found in the [Wiki](https://github.com/microsoft/FluidFramework/wiki).\n\nThis project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).\nFor more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\nUse of these trademarks or logos must follow Microsoft’s [Trademark & Brand Guidelines](https://www.microsoft.com/trademarks).\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n\n\n\n## Help\n\nNot finding what you're looking for in this README? Check out our [GitHub\nWiki](https://github.com/microsoft/FluidFramework/wiki) or [fluidframework.com](https://fluidframework.com/docs/).\n\nStill not finding what you're looking for? Please [file an\nissue](https://github.com/microsoft/FluidFramework/wiki/Submitting-Bugs-and-Feature-Requests).\n\nThank you!\n\n\n\n\n\n\n\n\n\n\n## Trademark\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\n\nUse of these trademarks or logos must follow Microsoft's [Trademark & Brand\nGuidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general).\n\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n","scripts":{"tsc":"tsc","lint":"npm run prettier && npm run eslint","test":"npm run test:mocha","build":"concurrently npm:build:compile npm:lint && npm run build:docs","clean":"rimraf _api-extractor-temp nyc dist *.tsbuildinfo *.build.log","eslint":"eslint src","format":"npm run prettier:fix","rebuild":"npm run clean && npm run build","lint:fix":"npm run prettier:fix && npm run eslint:fix","prettier":"prettier --check . --ignore-path ../../../../.prettierignore","build:docs":"api-extractor run --local && copyfiles -u 1 ./_api-extractor-temp/doc-models/* ../../../../_api-extractor-temp/","build:full":"npm run build","eslint:fix":"eslint src --fix","test:mocha":"mocha dist/**/*.test.js --unhandled-rejections=strict --exit","prettier:fix":"prettier --write . --ignore-path ../../../../.prettierignore","build:compile":"npm run tsc","ci:build:docs":"api-extractor run && copyfiles -u 1 ./_api-extractor-temp/doc-models/* ../../../../_api-extractor-temp/","test:coverage":"npm run test:mocha:coverage","format-and-build":"npm run format && npm run build","build:full:compile":"npm run build:compile","format-and-compile":"npm run format && npm run build:compile","test:mocha:coverage":"nyc npm run test:mocha -- --reporter xunit --reporter-option output=nyc/junit-report.xml","test:mocha:multireport":"cross-env FLUID_TEST_MULTIREPORT=1 npm run test:mocha"},"_npmUser":{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},"_resolved":"/mnt/vss/_work/1/pack/scoped/fluid-experimental-devtools-core-2.0.0-internal.5.0.1.tgz","_integrity":"sha512-yQV5mybE2HmCPZAjiGaoZaJnFtEcyriLClnUyz/E8EHly+unWq0CohtuT8h04aSjhq0rq+1iXqJaMA27gkdVUA==","repository":{"url":"git+https://github.com/microsoft/FluidFramework.git","type":"git","directory":"packages/tools/devtools/devtools-core"},"_npmVersion":"8.19.4","description":"Fluid Framework developer tools core functionality","directories":{},"sideEffects":false,"_nodeVersion":"16.20.0","dependencies":{"@fluidframework/map":">=2.0.0-internal.5.0.1 <2.0.0-internal.5.1.0","@fluidframework/cell":">=2.0.0-internal.5.0.1 <2.0.0-internal.5.1.0","@fluidframework/matrix":">=2.0.0-internal.5.0.1 <2.0.0-internal.5.1.0","@fluidframework/counter":">=2.0.0-internal.5.0.1 <2.0.0-internal.5.1.0","@fluidframework/sequence":">=2.0.0-internal.5.0.1 <2.0.0-internal.5.1.0","@fluidframework/common-utils":"^1.1.1","@fluidframework/container-utils":">=2.0.0-internal.5.0.1 <2.0.0-internal.5.1.0","@fluidframework/core-interfaces":">=2.0.0-internal.5.0.1 <2.0.0-internal.5.1.0","@fluidframework/telemetry-utils":">=2.0.0-internal.5.0.1 <2.0.0-internal.5.1.0","@fluidframework/container-loader":">=2.0.0-internal.5.0.1 <2.0.0-internal.5.1.0","@fluidframework/common-definitions":"^0.20.1","@fluidframework/shared-object-base":">=2.0.0-internal.5.0.1 <2.0.0-internal.5.1.0","@fluidframework/protocol-definitions":"^1.1.0","@fluidframework/container-definitions":">=2.0.0-internal.5.0.1 <2.0.0-internal.5.1.0"},"_hasShrinkwrap":false,"readmeFilename":"README.md","typeValidation":{"broken":{},"disabled":true},"devDependencies":{"nyc":"^15.1.0","chai":"^4.2.0","mocha":"^10.2.0","eslint":"~8.6.0","events":"^3.1.0","moment":"^2.21.0","rimraf":"^4.4.0","prettier":"~2.6.2","copyfiles":"^2.4.1","cross-env":"^7.0.3","typescript":"~4.5.5","@types/chai":"^4.0.0","@types/mocha":"^9.1.1","concurrently":"^7.6.0","@types/events":"^3.0.0","mocha-multi-reporters":"^1.5.1","eslint-config-prettier":"~8.5.0","@microsoft/api-extractor":"^7.34.4","eslint-plugin-chai-expect":"~3.0.0","mocha-json-output-reporter":"^2.0.1","@fluidframework/build-tools":"^0.18.2","@fluidframework/build-common":"^1.1.0","@fluidframework/mocha-test-setup":">=2.0.0-internal.5.0.1 <2.0.0-internal.5.1.0","@fluidframework/driver-definitions":">=2.0.0-internal.5.0.1 <2.0.0-internal.5.1.0","@fluidframework/test-runtime-utils":">=2.0.0-internal.5.0.1 <2.0.0-internal.5.1.0","@fluidframework/eslint-config-fluid":"^2.0.0"},"_npmOperationalInternal":{"tmp":"tmp/devtools-core_2.0.0-internal.5.0.1_1686777546210_0.012434366159470356","host":"s3://npm-registry-packages"}},"2.0.0-dev.5.2.0.169897":{"name":"@fluid-experimental/devtools-core","version":"2.0.0-dev.5.2.0.169897","author":{"name":"Microsoft and contributors"},"license":"MIT","_id":"@fluid-experimental/devtools-core@2.0.0-dev.5.2.0.169897","maintainers":[{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},{"name":"curtisman","email":"curtism@microsoft.com"}],"homepage":"https://fluidframework.com","bugs":{"url":"https://github.com/microsoft/FluidFramework/issues"},"nyc":{"all":true,"exclude":["src/test/**/*.ts","dist/test/**/*.js"],"include":["src/**/*.ts","dist/**/*.js"],"reporter":["cobertura","html","text"],"cache-dir":"nyc/.cache","report-dir":"nyc/report","temp-directory":"nyc/.nyc_output","exclude-after-remap":false},"dist":{"shasum":"6f0b67a2e786de19fdc34bf724ce116e55b90401","tarball":"https://registry.npmjs.org/@fluid-experimental/devtools-core/-/devtools-core-2.0.0-dev.5.2.0.169897.tgz","fileCount":248,"integrity":"sha512-5sBvJthqb53/+hpuopab57U8CKGMKAf5w4dKBNZGgL+WN0hAV00/G8cqtGQI5AnPG6LUCBP3+cHeA5K3ZYlBdA==","signatures":[{"sig":"MEQCIExEqh/Q0bHoL18dkeqHc/JjzASe6CCMCGVt06YAosOZAiBT1K02hwDAMQdkdzNWuf5tTMjDFGFML7E4OnaFr+NovQ==","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}],"unpackedSize":572051},"main":"dist/index.js","_from":"file:fluid-experimental-devtools-core-2.0.0-dev.5.2.0.169897.tgz","types":"dist/index.d.ts","readme":"# @fluid-experimental/devtools-core\n\nThis library contains developer tools for use alongside the Fluid Framework.\nIt is used to power our associated browser extensions.\n\n- Chrome: \n- Edge: \n\n\n\n\n\n\n## Installation\n\nTo get started, install the package by running the following command:\n\n```bash\nnpm i @fluid-experimental/devtools-core -D\n```\n\n\n\n\n\n## Usage\n\nThe Devtools' API surface is designed to fit nicely into most application flows.\n\n### Initialization\n\nTo initialize a devtools session for your container, call `initializeDevtools`.\nThis function accepts a `DevtoolsLogger` for recording and communicating telemetry data, a list of initial Fluid `Containers` to associate with the session, and (optionally) customized data visualization configurations for visualizing `Container` data.\n\nSee [here](https://fluidframework.com/docs/apis/devtools-core#initializedevtools-function) for associated API documentation.\n\n### Clean-up\n\nThe Devtools object is managed as a global singleton.\nThat singleton is automatically cleaned up prior to the Window's \"unload\" event.\nSo typical application flows likely won't need to worry about cleanup.\nThat said, if you wish to have tighter control over when the Devtools are torn down, you can simply call the `dispose` method on the handle returned by [initialization](#initialization).\n\n## Working in the package\n\n### Build\n\nTo build the package locally, first ensure you have run `pnpm install` from the root of the mono-repo.\nNext, to build the code, run `npm run build` from the root of the mono-repo, or use [fluid-build](https://github.com/microsoft/FluidFramework/tree/main/build-tools/packages/build-tools#running-fluid-build-command-line) via `fluid-build -t build`.\n\n- Note: Once you have run a build from the root, assuming no other changes outside of this package, you may run `npm run build` directly within this directory for a faster build.\n If you make changes to any of this package's local dependencies, you will need to run a build again from the root before building again from directly within this package.\n\n### Test\n\nTo run the tests, first ensure you have followed the [build](#build) steps above.\nNext, run `npm run test` from a terminal within this directory.\n\n\n\n\n\n\n\n## API Documentation\n\nAPI documentation for **@fluid-experimental/devtools-core** is available at .\n\n\n\n\n\n\n\n\n\n\n## Contribution Guidelines\n\nThere are many ways to [contribute](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md) to Fluid.\n\n- Participate in Q&A in our [GitHub Discussions](https://github.com/microsoft/FluidFramework/discussions).\n- [Submit bugs](https://github.com/microsoft/FluidFramework/issues) and help us verify fixes as they are checked in.\n- Review the [source code changes](https://github.com/microsoft/FluidFramework/pulls).\n- [Contribute bug fixes](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md).\n\nDetailed instructions for working in the repo can be found in the [Wiki](https://github.com/microsoft/FluidFramework/wiki).\n\nThis project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).\nFor more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\nUse of these trademarks or logos must follow Microsoft’s [Trademark & Brand Guidelines](https://www.microsoft.com/trademarks).\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n\n\n\n## Help\n\nNot finding what you're looking for in this README? Check out our [GitHub\nWiki](https://github.com/microsoft/FluidFramework/wiki) or [fluidframework.com](https://fluidframework.com/docs/).\n\nStill not finding what you're looking for? Please [file an\nissue](https://github.com/microsoft/FluidFramework/wiki/Submitting-Bugs-and-Feature-Requests).\n\nThank you!\n\n\n\n\n\n\n\n\n\n\n## Trademark\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\n\nUse of these trademarks or logos must follow Microsoft's [Trademark & Brand\nGuidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general).\n\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n","scripts":{"tsc":"tsc","lint":"npm run prettier && npm run eslint","test":"npm run test:mocha","build":"fluid-build . --task build","clean":"rimraf _api-extractor-temp nyc dist *.tsbuildinfo *.build.log","eslint":"eslint src","format":"npm run prettier:fix","rebuild":"npm run clean && npm run build","lint:fix":"npm run prettier:fix && npm run eslint:fix","prettier":"prettier --check . --ignore-path ../../../../.prettierignore","build:docs":"api-extractor run --local && copyfiles -u 1 ./_api-extractor-temp/doc-models/* ../../../../_api-extractor-temp/","eslint:fix":"eslint src --fix","test:mocha":"mocha dist/**/*.test.js --unhandled-rejections=strict --exit","prettier:fix":"prettier --write . --ignore-path ../../../../.prettierignore","build:compile":"fluid-build . --task compile","ci:build:docs":"api-extractor run && copyfiles -u 1 ./_api-extractor-temp/doc-models/* ../../../../_api-extractor-temp/","test:coverage":"npm run test:mocha:coverage","format-and-build":"npm run format && npm run build","format-and-compile":"npm run format && npm run build:compile","test:mocha:coverage":"nyc npm run test:mocha -- --reporter xunit --reporter-option output=nyc/junit-report.xml","test:mocha:multireport":"cross-env FLUID_TEST_MULTIREPORT=1 npm run test:mocha"},"_npmUser":{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},"_resolved":"/mnt/vss/_work/1/pack/scoped/fluid-experimental-devtools-core-2.0.0-dev.5.2.0.169897.tgz","_integrity":"sha512-5sBvJthqb53/+hpuopab57U8CKGMKAf5w4dKBNZGgL+WN0hAV00/G8cqtGQI5AnPG6LUCBP3+cHeA5K3ZYlBdA==","repository":{"url":"git+https://github.com/microsoft/FluidFramework.git","type":"git","directory":"packages/tools/devtools/devtools-core"},"_npmVersion":"8.19.4","description":"Fluid Framework developer tools core functionality","directories":{},"sideEffects":false,"_nodeVersion":"16.20.1","dependencies":{"@fluidframework/map":"2.0.0-dev.5.2.0.169897","@fluidframework/cell":"2.0.0-dev.5.2.0.169897","@fluidframework/matrix":"2.0.0-dev.5.2.0.169897","@fluidframework/counter":"2.0.0-dev.5.2.0.169897","@fluidframework/sequence":"2.0.0-dev.5.2.0.169897","@fluid-experimental/tree2":"2.0.0-dev.5.2.0.169897","@fluidframework/common-utils":"^1.1.1","@fluidframework/container-utils":"2.0.0-dev.5.2.0.169897","@fluidframework/core-interfaces":"2.0.0-dev.5.2.0.169897","@fluidframework/telemetry-utils":"2.0.0-dev.5.2.0.169897","@fluidframework/container-loader":"2.0.0-dev.5.2.0.169897","@fluidframework/common-definitions":"^0.20.1","@fluidframework/shared-object-base":"2.0.0-dev.5.2.0.169897","@fluidframework/protocol-definitions":"^1.1.0","@fluidframework/container-definitions":"2.0.0-dev.5.2.0.169897"},"_hasShrinkwrap":false,"readmeFilename":"README.md","typeValidation":{"broken":{},"disabled":true},"devDependencies":{"nyc":"^15.1.0","chai":"^4.2.0","mocha":"^10.2.0","eslint":"~8.6.0","events":"^3.1.0","moment":"^2.21.0","rimraf":"^4.4.0","prettier":"~2.6.2","copyfiles":"^2.4.1","cross-env":"^7.0.3","typescript":"~4.5.5","@types/chai":"^4.0.0","@types/mocha":"^9.1.1","concurrently":"^7.6.0","@types/events":"^3.0.0","mocha-multi-reporters":"^1.5.1","eslint-config-prettier":"~8.5.0","@microsoft/api-extractor":"^7.34.4","eslint-plugin-chai-expect":"~3.0.0","mocha-json-output-reporter":"^2.0.1","@fluidframework/build-tools":"^0.20.0-169245","@fluidframework/build-common":"^1.2.0","@fluidframework/mocha-test-setup":"2.0.0-dev.5.2.0.169897","@fluidframework/driver-definitions":"2.0.0-dev.5.2.0.169897","@fluidframework/test-runtime-utils":"2.0.0-dev.5.2.0.169897","@fluidframework/eslint-config-fluid":"^2.0.0"},"_npmOperationalInternal":{"tmp":"tmp/devtools-core_2.0.0-dev.5.2.0.169897_1687362567299_0.1126571110559782","host":"s3://npm-registry-packages"}},"2.0.0-internal.5.1.0":{"name":"@fluid-experimental/devtools-core","version":"2.0.0-internal.5.1.0","author":{"name":"Microsoft and contributors"},"license":"MIT","_id":"@fluid-experimental/devtools-core@2.0.0-internal.5.1.0","maintainers":[{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},{"name":"curtisman","email":"curtism@microsoft.com"}],"homepage":"https://fluidframework.com","bugs":{"url":"https://github.com/microsoft/FluidFramework/issues"},"nyc":{"all":true,"exclude":["src/test/**/*.ts","dist/test/**/*.js"],"include":["src/**/*.ts","dist/**/*.js"],"reporter":["cobertura","html","text"],"cache-dir":"nyc/.cache","report-dir":"nyc/report","temp-directory":"nyc/.nyc_output","exclude-after-remap":false},"dist":{"shasum":"c97536160657811b1c03edaed66e2de9a43d12e1","tarball":"https://registry.npmjs.org/@fluid-experimental/devtools-core/-/devtools-core-2.0.0-internal.5.1.0.tgz","fileCount":248,"integrity":"sha512-qahk94PH2nwTDL7m3VnB8oQXQyzpzfhZpnwnniut+5dUZhgl9EmYvxnb9U/AIEenSlEd8HnJFf1tIsis4jOWvg==","signatures":[{"sig":"MEYCIQDJwI9U4PNsTCK6afrtqyHLRSnY0kkvhC1k7Z8BN/nddgIhAKRtrk/XrZhfA0UYXtFv1608IwUkkavQCg287hEvzs8g","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}],"unpackedSize":567858},"main":"dist/index.js","_from":"file:fluid-experimental-devtools-core-2.0.0-internal.5.1.0.tgz","types":"dist/index.d.ts","readme":"# @fluid-experimental/devtools-core\n\nThis library contains developer tools for use alongside the Fluid Framework.\nIt is used to power our associated browser extensions.\n\nTODO: link to extensions once they are published.\n\n\n\n\n\n\n## Installation\n\nTo get started, install the package by running the following command:\n\n```bash\nnpm i @fluid-experimental/devtools-core -D\n```\n\n\n\n\n\n## Usage\n\nThe Devtools' API surface is designed to fit nicely into most application flows.\n\n### Initialization\n\nTo initialize a debugger session for your container, call `initializeDevtools`.\nThis function accepts a `DevtoolsLogger` for recording and communicating telemetry data, a list of initial Fluid `Containers` to associate with the session, and (optionally) customized data visualization configurations for visualizing `Container` data.\n\nTODO: link to API docs once API shape has settled.\n\n### Clean-up\n\nThe Devtools object is managed as a global singleton.\nThat singleton is automatically cleaned up prior to the Window's \"unload\" event.\nSo typical application flows likely won't need to worry about cleanup.\nThat said, if you wish to have tighter control over when the Devtools are torn down, you can simply call the `dispose` method on the handle returned by [initialization](#initialization).\n\n## Related Tooling\n\nThis library is designed to work alongside our Chromium browser extension.\n\nTODO: link to code on github once package names have been finalized.\nTODO: link to the various browsers' webstore pages for our extension once it has been publiched.\n\n## Working in the package\n\n### Build\n\nTo build the package locally, first ensure you have run `pnpm install` from the root of the mono-repo.\nNext, to build the code, run `npm run build` from the root of the mono-repo, or use [fluid-build](https://github.com/microsoft/FluidFramework/tree/main/build-tools/packages/build-tools#running-fluid-build-command-line) via `fluid-build -t build`.\n\n- Note: Once you have run a build from the root, assuming no other changes outside of this package, you may run `npm run build` directly within this directory for a faster build.\n If you make changes to any of this package's local dependencies, you will need to run a build again from the root before building again from directly within this package.\n\n### Test\n\nTo run the tests, first ensure you have followed the [build](#build) steps above.\nNext, run `npm run test` from a terminal within this directory.\n\n\n\n\n\n\n\n## API Documentation\n\nAPI documentation for **@fluid-experimental/devtools-core** is available at .\n\n\n\n\n\n\n\n\n\n\n## Contribution Guidelines\n\nThere are many ways to [contribute](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md) to Fluid.\n\n- Participate in Q&A in our [GitHub Discussions](https://github.com/microsoft/FluidFramework/discussions).\n- [Submit bugs](https://github.com/microsoft/FluidFramework/issues) and help us verify fixes as they are checked in.\n- Review the [source code changes](https://github.com/microsoft/FluidFramework/pulls).\n- [Contribute bug fixes](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md).\n\nDetailed instructions for working in the repo can be found in the [Wiki](https://github.com/microsoft/FluidFramework/wiki).\n\nThis project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).\nFor more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\nUse of these trademarks or logos must follow Microsoft’s [Trademark & Brand Guidelines](https://www.microsoft.com/trademarks).\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n\n\n\n## Help\n\nNot finding what you're looking for in this README? Check out our [GitHub\nWiki](https://github.com/microsoft/FluidFramework/wiki) or [fluidframework.com](https://fluidframework.com/docs/).\n\nStill not finding what you're looking for? Please [file an\nissue](https://github.com/microsoft/FluidFramework/wiki/Submitting-Bugs-and-Feature-Requests).\n\nThank you!\n\n\n\n\n\n\n\n\n\n\n## Trademark\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\n\nUse of these trademarks or logos must follow Microsoft's [Trademark & Brand\nGuidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general).\n\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n","scripts":{"tsc":"tsc","lint":"npm run prettier && npm run eslint","test":"npm run test:mocha","build":"fluid-build . --task build","clean":"rimraf _api-extractor-temp nyc dist *.tsbuildinfo *.build.log","eslint":"eslint src","format":"npm run prettier:fix","rebuild":"npm run clean && npm run build","lint:fix":"npm run prettier:fix && npm run eslint:fix","prettier":"prettier --check . --ignore-path ../../../../.prettierignore","build:docs":"api-extractor run --local && copyfiles -u 1 ./_api-extractor-temp/doc-models/* ../../../../_api-extractor-temp/","eslint:fix":"eslint src --fix","test:mocha":"mocha dist/**/*.test.js --unhandled-rejections=strict --exit","prettier:fix":"prettier --write . --ignore-path ../../../../.prettierignore","build:compile":"fluid-build . --task compile","ci:build:docs":"api-extractor run && copyfiles -u 1 ./_api-extractor-temp/doc-models/* ../../../../_api-extractor-temp/","test:coverage":"npm run test:mocha:coverage","format-and-build":"npm run format && npm run build","format-and-compile":"npm run format && npm run build:compile","test:mocha:coverage":"nyc npm run test:mocha -- --reporter xunit --reporter-option output=nyc/junit-report.xml","test:mocha:multireport":"cross-env FLUID_TEST_MULTIREPORT=1 npm run test:mocha"},"_npmUser":{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},"_resolved":"/mnt/vss/_work/1/pack/scoped/fluid-experimental-devtools-core-2.0.0-internal.5.1.0.tgz","_integrity":"sha512-qahk94PH2nwTDL7m3VnB8oQXQyzpzfhZpnwnniut+5dUZhgl9EmYvxnb9U/AIEenSlEd8HnJFf1tIsis4jOWvg==","repository":{"url":"git+https://github.com/microsoft/FluidFramework.git","type":"git","directory":"packages/tools/devtools/devtools-core"},"_npmVersion":"8.19.4","description":"Fluid Framework developer tools core functionality","directories":{},"sideEffects":false,"_nodeVersion":"16.20.1","dependencies":{"@fluidframework/map":">=2.0.0-internal.5.1.0 <2.0.0-internal.5.2.0","@fluidframework/cell":">=2.0.0-internal.5.1.0 <2.0.0-internal.5.2.0","@fluidframework/matrix":">=2.0.0-internal.5.1.0 <2.0.0-internal.5.2.0","@fluidframework/counter":">=2.0.0-internal.5.1.0 <2.0.0-internal.5.2.0","@fluidframework/sequence":">=2.0.0-internal.5.1.0 <2.0.0-internal.5.2.0","@fluidframework/common-utils":"^1.1.1","@fluidframework/container-utils":">=2.0.0-internal.5.1.0 <2.0.0-internal.5.2.0","@fluidframework/core-interfaces":">=2.0.0-internal.5.1.0 <2.0.0-internal.5.2.0","@fluidframework/telemetry-utils":">=2.0.0-internal.5.1.0 <2.0.0-internal.5.2.0","@fluidframework/container-loader":">=2.0.0-internal.5.1.0 <2.0.0-internal.5.2.0","@fluidframework/common-definitions":"^0.20.1","@fluidframework/shared-object-base":">=2.0.0-internal.5.1.0 <2.0.0-internal.5.2.0","@fluidframework/protocol-definitions":"^1.1.0","@fluidframework/container-definitions":">=2.0.0-internal.5.1.0 <2.0.0-internal.5.2.0"},"_hasShrinkwrap":false,"readmeFilename":"README.md","typeValidation":{"broken":{},"disabled":true},"devDependencies":{"nyc":"^15.1.0","chai":"^4.2.0","mocha":"^10.2.0","eslint":"~8.6.0","events":"^3.1.0","moment":"^2.21.0","rimraf":"^4.4.0","prettier":"~2.6.2","copyfiles":"^2.4.1","cross-env":"^7.0.3","typescript":"~4.5.5","@types/chai":"^4.0.0","@types/mocha":"^9.1.1","concurrently":"^7.6.0","@types/events":"^3.0.0","mocha-multi-reporters":"^1.5.1","eslint-config-prettier":"~8.5.0","@microsoft/api-extractor":"^7.34.4","eslint-plugin-chai-expect":"~3.0.0","mocha-json-output-reporter":"^2.0.1","@fluidframework/build-tools":"^0.19.0","@fluidframework/build-common":"^1.2.0","@fluidframework/mocha-test-setup":">=2.0.0-internal.5.1.0 <2.0.0-internal.5.2.0","@fluidframework/driver-definitions":">=2.0.0-internal.5.1.0 <2.0.0-internal.5.2.0","@fluidframework/test-runtime-utils":">=2.0.0-internal.5.1.0 <2.0.0-internal.5.2.0","@fluidframework/eslint-config-fluid":"^2.0.0"},"_npmOperationalInternal":{"tmp":"tmp/devtools-core_2.0.0-internal.5.1.0_1687371847809_0.07129537943985809","host":"s3://npm-registry-packages"}},"2.0.0-internal.5.1.1":{"name":"@fluid-experimental/devtools-core","version":"2.0.0-internal.5.1.1","author":{"name":"Microsoft and contributors"},"license":"MIT","_id":"@fluid-experimental/devtools-core@2.0.0-internal.5.1.1","maintainers":[{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},{"name":"curtisman","email":"curtism@microsoft.com"}],"homepage":"https://fluidframework.com","bugs":{"url":"https://github.com/microsoft/FluidFramework/issues"},"nyc":{"all":true,"exclude":["src/test/**/*.ts","dist/test/**/*.js"],"include":["src/**/*.ts","dist/**/*.js"],"reporter":["cobertura","html","text"],"cache-dir":"nyc/.cache","report-dir":"nyc/report","temp-directory":"nyc/.nyc_output","exclude-after-remap":false},"dist":{"shasum":"f3a51f168063627c04a7badab4a16f373b161f21","tarball":"https://registry.npmjs.org/@fluid-experimental/devtools-core/-/devtools-core-2.0.0-internal.5.1.1.tgz","fileCount":248,"integrity":"sha512-qZHWUaGShWP+HnmwVc9bnB1+wrmCyO36o9BhLzxLhwUO9gs5QLTwYl3E0EVi11+JP1juhJJvPv9/24XMCHJZNw==","signatures":[{"sig":"MEUCIB8z20hX+6iL9SrYEHK3nGX48tchfzpC/7v4Ex+yWF4FAiEArt+wx8sb0QS1sq+dT+37H2O/WUwVfA3N9pb8wnPZ9ag=","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}],"unpackedSize":567858},"main":"dist/index.js","_from":"file:fluid-experimental-devtools-core-2.0.0-internal.5.1.1.tgz","types":"dist/index.d.ts","readme":"# @fluid-experimental/devtools-core\n\nThis library contains developer tools for use alongside the Fluid Framework.\nIt is used to power our associated browser extensions.\n\nTODO: link to extensions once they are published.\n\n\n\n\n\n\n## Installation\n\nTo get started, install the package by running the following command:\n\n```bash\nnpm i @fluid-experimental/devtools-core -D\n```\n\n\n\n\n\n## Usage\n\nThe Devtools' API surface is designed to fit nicely into most application flows.\n\n### Initialization\n\nTo initialize a debugger session for your container, call `initializeDevtools`.\nThis function accepts a `DevtoolsLogger` for recording and communicating telemetry data, a list of initial Fluid `Containers` to associate with the session, and (optionally) customized data visualization configurations for visualizing `Container` data.\n\nTODO: link to API docs once API shape has settled.\n\n### Clean-up\n\nThe Devtools object is managed as a global singleton.\nThat singleton is automatically cleaned up prior to the Window's \"unload\" event.\nSo typical application flows likely won't need to worry about cleanup.\nThat said, if you wish to have tighter control over when the Devtools are torn down, you can simply call the `dispose` method on the handle returned by [initialization](#initialization).\n\n## Related Tooling\n\nThis library is designed to work alongside our Chromium browser extension.\n\nTODO: link to code on github once package names have been finalized.\nTODO: link to the various browsers' webstore pages for our extension once it has been publiched.\n\n## Working in the package\n\n### Build\n\nTo build the package locally, first ensure you have run `pnpm install` from the root of the mono-repo.\nNext, to build the code, run `npm run build` from the root of the mono-repo, or use [fluid-build](https://github.com/microsoft/FluidFramework/tree/main/build-tools/packages/build-tools#running-fluid-build-command-line) via `fluid-build -t build`.\n\n- Note: Once you have run a build from the root, assuming no other changes outside of this package, you may run `npm run build` directly within this directory for a faster build.\n If you make changes to any of this package's local dependencies, you will need to run a build again from the root before building again from directly within this package.\n\n### Test\n\nTo run the tests, first ensure you have followed the [build](#build) steps above.\nNext, run `npm run test` from a terminal within this directory.\n\n\n\n\n\n\n\n## API Documentation\n\nAPI documentation for **@fluid-experimental/devtools-core** is available at .\n\n\n\n\n\n\n\n\n\n\n## Contribution Guidelines\n\nThere are many ways to [contribute](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md) to Fluid.\n\n- Participate in Q&A in our [GitHub Discussions](https://github.com/microsoft/FluidFramework/discussions).\n- [Submit bugs](https://github.com/microsoft/FluidFramework/issues) and help us verify fixes as they are checked in.\n- Review the [source code changes](https://github.com/microsoft/FluidFramework/pulls).\n- [Contribute bug fixes](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md).\n\nDetailed instructions for working in the repo can be found in the [Wiki](https://github.com/microsoft/FluidFramework/wiki).\n\nThis project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).\nFor more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\nUse of these trademarks or logos must follow Microsoft’s [Trademark & Brand Guidelines](https://www.microsoft.com/trademarks).\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n\n\n\n## Help\n\nNot finding what you're looking for in this README? Check out our [GitHub\nWiki](https://github.com/microsoft/FluidFramework/wiki) or [fluidframework.com](https://fluidframework.com/docs/).\n\nStill not finding what you're looking for? Please [file an\nissue](https://github.com/microsoft/FluidFramework/wiki/Submitting-Bugs-and-Feature-Requests).\n\nThank you!\n\n\n\n\n\n\n\n\n\n\n## Trademark\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\n\nUse of these trademarks or logos must follow Microsoft's [Trademark & Brand\nGuidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general).\n\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n","scripts":{"tsc":"tsc","lint":"npm run prettier && npm run eslint","test":"npm run test:mocha","build":"fluid-build . --task build","clean":"rimraf _api-extractor-temp nyc dist *.tsbuildinfo *.build.log","eslint":"eslint src","format":"npm run prettier:fix","rebuild":"npm run clean && npm run build","lint:fix":"npm run prettier:fix && npm run eslint:fix","prettier":"prettier --check . --ignore-path ../../../../.prettierignore","build:docs":"api-extractor run --local && copyfiles -u 1 ./_api-extractor-temp/doc-models/* ../../../../_api-extractor-temp/","eslint:fix":"eslint src --fix","test:mocha":"mocha dist/**/*.test.js --unhandled-rejections=strict --exit","prettier:fix":"prettier --write . --ignore-path ../../../../.prettierignore","build:compile":"fluid-build . --task compile","ci:build:docs":"api-extractor run && copyfiles -u 1 ./_api-extractor-temp/doc-models/* ../../../../_api-extractor-temp/","test:coverage":"npm run test:mocha:coverage","format-and-build":"npm run format && npm run build","format-and-compile":"npm run format && npm run build:compile","test:mocha:coverage":"nyc npm run test:mocha -- --reporter xunit --reporter-option output=nyc/junit-report.xml","test:mocha:multireport":"cross-env FLUID_TEST_MULTIREPORT=1 npm run test:mocha"},"_npmUser":{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},"_resolved":"/mnt/vss/_work/1/pack/scoped/fluid-experimental-devtools-core-2.0.0-internal.5.1.1.tgz","_integrity":"sha512-qZHWUaGShWP+HnmwVc9bnB1+wrmCyO36o9BhLzxLhwUO9gs5QLTwYl3E0EVi11+JP1juhJJvPv9/24XMCHJZNw==","repository":{"url":"git+https://github.com/microsoft/FluidFramework.git","type":"git","directory":"packages/tools/devtools/devtools-core"},"_npmVersion":"8.19.4","description":"Fluid Framework developer tools core functionality","directories":{},"sideEffects":false,"_nodeVersion":"16.20.1","dependencies":{"@fluidframework/map":">=2.0.0-internal.5.1.1 <2.0.0-internal.5.2.0","@fluidframework/cell":">=2.0.0-internal.5.1.1 <2.0.0-internal.5.2.0","@fluidframework/matrix":">=2.0.0-internal.5.1.1 <2.0.0-internal.5.2.0","@fluidframework/counter":">=2.0.0-internal.5.1.1 <2.0.0-internal.5.2.0","@fluidframework/sequence":">=2.0.0-internal.5.1.1 <2.0.0-internal.5.2.0","@fluidframework/common-utils":"^1.1.1","@fluidframework/container-utils":">=2.0.0-internal.5.1.1 <2.0.0-internal.5.2.0","@fluidframework/core-interfaces":">=2.0.0-internal.5.1.1 <2.0.0-internal.5.2.0","@fluidframework/telemetry-utils":">=2.0.0-internal.5.1.1 <2.0.0-internal.5.2.0","@fluidframework/container-loader":">=2.0.0-internal.5.1.1 <2.0.0-internal.5.2.0","@fluidframework/common-definitions":"^0.20.1","@fluidframework/shared-object-base":">=2.0.0-internal.5.1.1 <2.0.0-internal.5.2.0","@fluidframework/protocol-definitions":"^1.1.0","@fluidframework/container-definitions":">=2.0.0-internal.5.1.1 <2.0.0-internal.5.2.0"},"_hasShrinkwrap":false,"readmeFilename":"README.md","typeValidation":{"broken":{},"disabled":true},"devDependencies":{"nyc":"^15.1.0","chai":"^4.2.0","mocha":"^10.2.0","eslint":"~8.6.0","events":"^3.1.0","moment":"^2.21.0","rimraf":"^4.4.0","prettier":"~2.6.2","copyfiles":"^2.4.1","cross-env":"^7.0.3","typescript":"~4.5.5","@types/chai":"^4.0.0","@types/mocha":"^9.1.1","concurrently":"^7.6.0","@types/events":"^3.0.0","mocha-multi-reporters":"^1.5.1","eslint-config-prettier":"~8.5.0","@microsoft/api-extractor":"^7.34.4","eslint-plugin-chai-expect":"~3.0.0","mocha-json-output-reporter":"^2.0.1","@fluidframework/build-tools":"^0.19.0","@fluidframework/build-common":"^1.2.0","@fluidframework/mocha-test-setup":">=2.0.0-internal.5.1.1 <2.0.0-internal.5.2.0","@fluidframework/driver-definitions":">=2.0.0-internal.5.1.1 <2.0.0-internal.5.2.0","@fluidframework/test-runtime-utils":">=2.0.0-internal.5.1.1 <2.0.0-internal.5.2.0","@fluidframework/eslint-config-fluid":"^2.0.0"},"_npmOperationalInternal":{"tmp":"tmp/devtools-core_2.0.0-internal.5.1.1_1688080941189_0.8215078737470114","host":"s3://npm-registry-packages"}},"2.0.0-internal.5.2.0":{"name":"@fluid-experimental/devtools-core","version":"2.0.0-internal.5.2.0","author":{"name":"Microsoft and contributors"},"license":"MIT","_id":"@fluid-experimental/devtools-core@2.0.0-internal.5.2.0","maintainers":[{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},{"name":"curtisman","email":"curtism@microsoft.com"}],"homepage":"https://fluidframework.com","bugs":{"url":"https://github.com/microsoft/FluidFramework/issues"},"nyc":{"all":true,"exclude":["src/test/**/*.ts","dist/test/**/*.js"],"include":["src/**/*.ts","dist/**/*.js"],"reporter":["cobertura","html","text"],"cache-dir":"nyc/.cache","report-dir":"nyc/report","temp-directory":"nyc/.nyc_output","exclude-after-remap":false},"dist":{"shasum":"5a19d5362d26b158201b823cb3bfd58fc21a12d1","tarball":"https://registry.npmjs.org/@fluid-experimental/devtools-core/-/devtools-core-2.0.0-internal.5.2.0.tgz","fileCount":248,"integrity":"sha512-+2qCs3aOkeIMHrIM9vaBhrKfOEjZmmOeQP1ji9sH+ZZnjnSdC6ffSaTS0+AGa4Ml89kFppiki+tnmy832b/MOQ==","signatures":[{"sig":"MEUCIE4IEtSdSNeCxatH1DzK5lg48XksFTSu39NG0AEuKEtuAiEAvThybuAspYxUkK6FHeMPGCNF/Qh7DLEUhd/8cuZb+Cw=","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}],"unpackedSize":572834},"main":"dist/index.js","_from":"file:fluid-experimental-devtools-core-2.0.0-internal.5.2.0.tgz","types":"dist/index.d.ts","readme":"# @fluid-experimental/devtools-core\n\nThis library contains developer tools for use alongside the Fluid Framework.\nIt is used to power our associated browser extensions.\n\n- Chrome: \n- Edge: \n\n\n\n\n\n\n## Installation\n\nTo get started, install the package by running the following command:\n\n```bash\nnpm i @fluid-experimental/devtools-core -D\n```\n\n\n\n\n\n## Usage\n\nThe Devtools' API surface is designed to fit nicely into most application flows.\n\n### Initialization\n\nTo initialize a devtools session for your container, call `initializeDevtools`.\nThis function accepts a `DevtoolsLogger` for recording and communicating telemetry data, a list of initial Fluid `Containers` to associate with the session, and (optionally) customized data visualization configurations for visualizing `Container` data.\n\nSee [here](https://fluidframework.com/docs/apis/devtools-core#initializedevtools-function) for associated API documentation.\n\n### Clean-up\n\nThe Devtools object is managed as a global singleton.\nThat singleton is automatically cleaned up prior to the Window's \"unload\" event.\nSo typical application flows likely won't need to worry about cleanup.\nThat said, if you wish to have tighter control over when the Devtools are torn down, you can simply call the `dispose` method on the handle returned by [initialization](#initialization).\n\n## Working in the package\n\n### Build\n\nTo build the package locally, first ensure you have run `pnpm install` from the root of the mono-repo.\nNext, to build the code, run `npm run build` from the root of the mono-repo, or use [fluid-build](https://github.com/microsoft/FluidFramework/tree/main/build-tools/packages/build-tools#running-fluid-build-command-line) via `fluid-build -t build`.\n\n- Note: Once you have run a build from the root, assuming no other changes outside of this package, you may run `npm run build` directly within this directory for a faster build.\n If you make changes to any of this package's local dependencies, you will need to run a build again from the root before building again from directly within this package.\n\n### Test\n\nTo run the tests, first ensure you have followed the [build](#build) steps above.\nNext, run `npm run test` from a terminal within this directory.\n\n\n\n\n\n\n\n## API Documentation\n\nAPI documentation for **@fluid-experimental/devtools-core** is available at .\n\n\n\n\n\n\n\n\n\n\n## Contribution Guidelines\n\nThere are many ways to [contribute](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md) to Fluid.\n\n- Participate in Q&A in our [GitHub Discussions](https://github.com/microsoft/FluidFramework/discussions).\n- [Submit bugs](https://github.com/microsoft/FluidFramework/issues) and help us verify fixes as they are checked in.\n- Review the [source code changes](https://github.com/microsoft/FluidFramework/pulls).\n- [Contribute bug fixes](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md).\n\nDetailed instructions for working in the repo can be found in the [Wiki](https://github.com/microsoft/FluidFramework/wiki).\n\nThis project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).\nFor more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\nUse of these trademarks or logos must follow Microsoft’s [Trademark & Brand Guidelines](https://www.microsoft.com/trademarks).\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n\n\n\n## Help\n\nNot finding what you're looking for in this README? Check out our [GitHub\nWiki](https://github.com/microsoft/FluidFramework/wiki) or [fluidframework.com](https://fluidframework.com/docs/).\n\nStill not finding what you're looking for? Please [file an\nissue](https://github.com/microsoft/FluidFramework/wiki/Submitting-Bugs-and-Feature-Requests).\n\nThank you!\n\n\n\n\n\n\n\n\n\n\n## Trademark\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\n\nUse of these trademarks or logos must follow Microsoft's [Trademark & Brand\nGuidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general).\n\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n","scripts":{"tsc":"tsc","lint":"npm run prettier && npm run eslint","test":"npm run test:mocha","build":"fluid-build . --task build","clean":"rimraf _api-extractor-temp nyc dist *.tsbuildinfo *.build.log","eslint":"eslint src","format":"npm run prettier:fix","rebuild":"npm run clean && npm run build","lint:fix":"npm run prettier:fix && npm run eslint:fix","prettier":"prettier --check . --ignore-path ../../../../.prettierignore","build:docs":"api-extractor run --local && copyfiles -u 1 ./_api-extractor-temp/doc-models/* ../../../../_api-extractor-temp/","eslint:fix":"eslint src --fix","test:mocha":"mocha dist/**/*.test.js --unhandled-rejections=strict --exit","prettier:fix":"prettier --write . --ignore-path ../../../../.prettierignore","build:compile":"fluid-build . --task compile","ci:build:docs":"api-extractor run && copyfiles -u 1 ./_api-extractor-temp/doc-models/* ../../../../_api-extractor-temp/","test:coverage":"npm run test:mocha:coverage","typetests:gen":"fluid-type-test-generator","format-and-build":"npm run format && npm run build","typetests:prepare":"flub generate typetests --prepare --dir . --pin","format-and-compile":"npm run format && npm run build:compile","test:mocha:coverage":"nyc npm run test:mocha -- --reporter xunit --reporter-option output=nyc/junit-report.xml","test:mocha:multireport":"cross-env FLUID_TEST_MULTIREPORT=1 npm run test:mocha"},"_npmUser":{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},"_resolved":"/mnt/vss/_work/1/pack/scoped/fluid-experimental-devtools-core-2.0.0-internal.5.2.0.tgz","_integrity":"sha512-+2qCs3aOkeIMHrIM9vaBhrKfOEjZmmOeQP1ji9sH+ZZnjnSdC6ffSaTS0+AGa4Ml89kFppiki+tnmy832b/MOQ==","fluidBuild":{"tasks":{"tsc":["...","typetests:gen"]}},"repository":{"url":"git+https://github.com/microsoft/FluidFramework.git","type":"git","directory":"packages/tools/devtools/devtools-core"},"_npmVersion":"8.19.4","description":"Fluid Framework developer tools core functionality","directories":{},"sideEffects":false,"_nodeVersion":"16.20.1","dependencies":{"@fluidframework/map":">=2.0.0-internal.5.2.0 <2.0.0-internal.5.3.0","@fluidframework/cell":">=2.0.0-internal.5.2.0 <2.0.0-internal.5.3.0","@fluidframework/matrix":">=2.0.0-internal.5.2.0 <2.0.0-internal.5.3.0","@fluidframework/counter":">=2.0.0-internal.5.2.0 <2.0.0-internal.5.3.0","@fluidframework/sequence":">=2.0.0-internal.5.2.0 <2.0.0-internal.5.3.0","@fluid-experimental/tree2":">=2.0.0-internal.5.2.0 <2.0.0-internal.5.3.0","@fluidframework/common-utils":"^1.1.1","@fluidframework/container-utils":">=2.0.0-internal.5.2.0 <2.0.0-internal.5.3.0","@fluidframework/core-interfaces":">=2.0.0-internal.5.2.0 <2.0.0-internal.5.3.0","@fluidframework/telemetry-utils":">=2.0.0-internal.5.2.0 <2.0.0-internal.5.3.0","@fluidframework/container-loader":">=2.0.0-internal.5.2.0 <2.0.0-internal.5.3.0","@fluidframework/common-definitions":"^0.20.1","@fluidframework/shared-object-base":">=2.0.0-internal.5.2.0 <2.0.0-internal.5.3.0","@fluidframework/protocol-definitions":"^1.1.0","@fluidframework/container-definitions":">=2.0.0-internal.5.2.0 <2.0.0-internal.5.3.0"},"_hasShrinkwrap":false,"readmeFilename":"README.md","typeValidation":{"broken":{}},"devDependencies":{"nyc":"^15.1.0","chai":"^4.2.0","mocha":"^10.2.0","eslint":"~8.6.0","events":"^3.1.0","moment":"^2.21.0","rimraf":"^4.4.0","prettier":"~2.6.2","copyfiles":"^2.4.1","cross-env":"^7.0.3","typescript":"~4.5.5","@types/chai":"^4.0.0","@types/mocha":"^9.1.1","concurrently":"^7.6.0","@types/events":"^3.0.0","mocha-multi-reporters":"^1.5.1","@fluid-tools/build-cli":"^0.20.0","eslint-config-prettier":"~8.5.0","@microsoft/api-extractor":"^7.34.4","eslint-plugin-chai-expect":"~3.0.0","mocha-json-output-reporter":"^2.0.1","@fluidframework/build-tools":"^0.20.0","@fluidframework/build-common":"^1.2.0","@fluidframework/mocha-test-setup":">=2.0.0-internal.5.2.0 <2.0.0-internal.5.3.0","@fluidframework/driver-definitions":">=2.0.0-internal.5.2.0 <2.0.0-internal.5.3.0","@fluidframework/test-runtime-utils":">=2.0.0-internal.5.2.0 <2.0.0-internal.5.3.0","@fluidframework/eslint-config-fluid":"^2.0.0","@fluid-experimental/devtools-core-previous":"npm:@fluid-experimental/devtools-core@2.0.0-internal.5.0.0"},"_npmOperationalInternal":{"tmp":"tmp/devtools-core_2.0.0-internal.5.2.0_1688584512835_0.10206060652133409","host":"s3://npm-registry-packages"}},"2.0.0-internal.5.3.0":{"name":"@fluid-experimental/devtools-core","version":"2.0.0-internal.5.3.0","author":{"name":"Microsoft and contributors"},"license":"MIT","_id":"@fluid-experimental/devtools-core@2.0.0-internal.5.3.0","maintainers":[{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},{"name":"curtisman","email":"curtism@microsoft.com"}],"homepage":"https://fluidframework.com","bugs":{"url":"https://github.com/microsoft/FluidFramework/issues"},"nyc":{"all":true,"exclude":["src/test/**/*.ts","dist/test/**/*.js"],"include":["src/**/*.ts","dist/**/*.js"],"reporter":["cobertura","html","text"],"cache-dir":"nyc/.cache","report-dir":"nyc/report","temp-directory":"nyc/.nyc_output","exclude-after-remap":false},"dist":{"shasum":"15d0f7f2116a429f1fbf6b732781223c93fd4388","tarball":"https://registry.npmjs.org/@fluid-experimental/devtools-core/-/devtools-core-2.0.0-internal.5.3.0.tgz","fileCount":465,"integrity":"sha512-r+C9mWouwj3opgVstsqZOL+E7v8pDOkNt8WHH1JkbTgVSWADM8qdcRRSYvUctQxKKYQdFrsWbgmiYL+c/cYzDQ==","signatures":[{"sig":"MEYCIQCaVm7gRE0VYwfY2+T33U7imARUltM1/99Cw+nD/77EPQIhANjzJ+PpIBvZH8n/6hnOZiodsCJaHPciWAiGi58T5xTG","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}],"unpackedSize":1284837},"main":"dist/index.js","_from":"file:fluid-experimental-devtools-core-2.0.0-internal.5.3.0.tgz","types":"dist/index.d.ts","readme":"# @fluid-experimental/devtools-core\n\nThis library contains developer tools for use alongside the Fluid Framework.\nIt is used to power our associated [browser extension][browser-extension].\n\n- Chrome: \n- Edge: \n\n\n\n\n\n\n## Installation\n\nTo get started, install the package by running the following command:\n\n```bash\nnpm i @fluid-experimental/devtools-core -D\n```\n\n\n\n\n\n## Usage\n\nThe Devtools' API surface is designed to fit nicely into most application flows.\n\n### Initialization\n\nTo initialize a devtools session for your container, call [`initializeDevtools`][initialize-devtools-docs].\nThis function accepts a `DevtoolsLogger` for receiving Fluid telemetry from your application, a list of initial Fluid\n`Containers` to associate with the session, and (optionally) customized data visualization configurations for visualizing\n`Container` data.\n\n#### About the [`DevtoolsLogger`][devtools-logger-docs]\n\nThe `DevtoolsLogger` is an optional piece when calling `initializeDevtools` but it is strongly recommended that you use\nit because several features in Fluid Devtools are powered by the telemetry that Fluid Framework generates, and this\nlogger is the way in which that telemetry gets into Fluid Devtools.\n\nYou can obtain a `DevtoolsLogger` by calling its constructor, and then should pass it to `initializeDevtools` _and_\nto the `Loader` instance you'll use to create/load Containers as shown below.\nThis way the logger will receive all the telemetry generated by Fluid Framework in your application, and forward it to\nFluid Devtools as necessary.\n\n```typescript\nimport { DevtoolsLogger, initializeDevtools } from \"@fluid-experimental/devtools-core\";\n\n// Instantiate the logger\nconst devtoolsLogger = new DevtoolsLogger();\n\n// Pass the logger when instantiating the Loader\nconst loader = new Loader({\n\tlogger: devtoolsLogger,\n\t// Other necessary properties ...\n});\n\n// Use the Loader to create (and optionally, attach) a Container\nconst container = await loader.createDetachedContainer(/* params */);\nawait container.attach(/* params */);\n\n// Initialize the Devtools passing the logger and your Container.\n// The Container could be added later as well with devtools.registerContainerDevtools().\nconst devtools = initializeDevtools({\n\tlogger: devtoolsLogger,\n\tinitialContainers: [\n\t\t{\n\t\t\tcontainer,\n\t\t\tcontainerKey: \"My Container\",\n\t\t},\n\t],\n});\n```\n\nIf you're working with `AzureClient` instead of lower-level APIs like the one described above, you probably want to\nrefer to the [@fluid-experimental/devtools package][devtools-package] instead of this one.\n\nDuring local development the recommendation is that your application should receive the `DevtoolsLogger` instance _instead_\nof any logger it would normally receive when deployed to a real environment, to avoid local development activity from\nmixing with real telemetry.\nIf you still want to provide a real application logger and use the Fluid Devtools features that are powered by telemetry\nat the same time, you can pass an existing logger to the `DevtoolsLogger` constructor and it will forward all telemetry\nit receives to that logger as well:\n\n```typescript\nimport { DevtoolsLogger } from \"@fluid-experimental/devtools-core\";\n\n// Your application's logger\nconst yourApplicationLogger = getInstanceOfYourApplicationLogger();\n\nconst devtoolsLogger = new DevtoolsLogger(yourApplicationLogger);\n\n// Pass devtoolsLogger to initializeDevtools() and to your application as described above\n```\n\n### Clean-up\n\nThe Devtools object is managed as a global singleton.\nThat singleton is automatically cleaned up prior to the Window's \"unload\" event.\nSo typical application flows likely won't need to worry about cleanup.\nThat said, if you wish to have tighter control over when the Devtools are torn down, you can simply call the `dispose` method on the handle returned by [initialization](#initialization).\n\n## Contributing to the package\n\n### Build\n\nTo build the package locally, first ensure you have run `pnpm install` from the root of the mono-repo.\nNext, to build the code, run `npm run build` from the root of the mono-repo, or use [fluid-build](https://github.com/microsoft/FluidFramework/tree/main/build-tools/packages/build-tools#running-fluid-build-command-line) via `fluid-build -t build`.\n\n- Note: Once you have run a build from the root, assuming no other changes outside of this package, you may run `npm run build` directly within this directory for a faster build.\n If you make changes to any of this package's local dependencies, you will need to run a build again from the root before building again from directly within this package.\n\n### Test\n\nTo run the tests, first ensure you have followed the [build](#build) steps above.\nNext, run `npm run test` from a terminal within this directory.\n\n\n\n\n\n\n\n## API Documentation\n\nAPI documentation for **@fluid-experimental/devtools-core** is available at .\n\n\n\n\n\n\n\n\n\n\n## Contribution Guidelines\n\nThere are many ways to [contribute](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md) to Fluid.\n\n- Participate in Q&A in our [GitHub Discussions](https://github.com/microsoft/FluidFramework/discussions).\n- [Submit bugs](https://github.com/microsoft/FluidFramework/issues) and help us verify fixes as they are checked in.\n- Review the [source code changes](https://github.com/microsoft/FluidFramework/pulls).\n- [Contribute bug fixes](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md).\n\nDetailed instructions for working in the repo can be found in the [Wiki](https://github.com/microsoft/FluidFramework/wiki).\n\nThis project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).\nFor more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\nUse of these trademarks or logos must follow Microsoft’s [Trademark & Brand Guidelines](https://www.microsoft.com/trademarks).\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n\n\n\n## Help\n\nNot finding what you're looking for in this README? Check out our [GitHub\nWiki](https://github.com/microsoft/FluidFramework/wiki) or [fluidframework.com](https://fluidframework.com/docs/).\n\nStill not finding what you're looking for? Please [file an\nissue](https://github.com/microsoft/FluidFramework/wiki/Submitting-Bugs-and-Feature-Requests).\n\nThank you!\n\n\n\n\n\n\n\n\n\n\n## Trademark\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\n\nUse of these trademarks or logos must follow Microsoft's [Trademark & Brand\nGuidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general).\n\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n[initialize-devtools-docs]: https://fluidframework.com/docs/apis/devtools-core#initializedevtools-function\n[devtools-logger-docs]: https://fluidframework.com/docs/apis/devtools-core/devtoolslogger-class\n[devtools-package]: https://www.npmjs.com/package/@fluid-experimental/devtools\n[browser-extension]: https://github.com/microsoft/FluidFramework/tree/main/packages/tools/devtools/devtools-browser-extension\n","scripts":{"tsc":"tsc","lint":"npm run prettier && npm run eslint","test":"npm run test:mocha","build":"fluid-build . --task build","clean":"rimraf _api-extractor-temp nyc dist lib *.tsbuildinfo *.build.log","eslint":"eslint src","format":"npm run prettier:fix","rebuild":"npm run clean && npm run build","lint:fix":"npm run prettier:fix && npm run eslint:fix","prettier":"prettier --check . --ignore-path ../../../../.prettierignore","build:docs":"api-extractor run --local && copyfiles -u 1 ./_api-extractor-temp/doc-models/* ../../../../_api-extractor-temp/","eslint:fix":"eslint src --fix","test:mocha":"mocha dist/**/*.test.js --unhandled-rejections=strict --exit","build:esnext":"tsc --project ./tsconfig.esnext.json","prettier:fix":"prettier --write . --ignore-path ../../../../.prettierignore","build:compile":"fluid-build . --task compile","ci:build:docs":"api-extractor run && copyfiles -u 1 ./_api-extractor-temp/doc-models/* ../../../../_api-extractor-temp/","test:coverage":"npm run test:mocha:coverage","typetests:gen":"fluid-type-test-generator","build:commonjs":"fluid-build . --task commonjs","format-and-build":"npm run format && npm run build","typetests:prepare":"flub typetests --dir . --reset --previous --normalize","format-and-compile":"npm run format && npm run build:compile","test:mocha:coverage":"nyc npm run test:mocha -- --reporter xunit --reporter-option output=nyc/junit-report.xml","test:mocha:multireport":"cross-env FLUID_TEST_MULTIREPORT=1 npm run test:mocha"},"_npmUser":{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},"_resolved":"/mnt/vss/_work/1/pack/scoped/fluid-experimental-devtools-core-2.0.0-internal.5.3.0.tgz","_integrity":"sha512-r+C9mWouwj3opgVstsqZOL+E7v8pDOkNt8WHH1JkbTgVSWADM8qdcRRSYvUctQxKKYQdFrsWbgmiYL+c/cYzDQ==","fluidBuild":{"tasks":{"tsc":["...","typetests:gen"]}},"repository":{"url":"git+https://github.com/microsoft/FluidFramework.git","type":"git","directory":"packages/tools/devtools/devtools-core"},"_npmVersion":"8.19.4","description":"Fluid Framework developer tools core functionality","directories":{},"sideEffects":false,"_nodeVersion":"16.20.1","dependencies":{"@fluidframework/map":">=2.0.0-internal.5.3.0 <2.0.0-internal.5.4.0","@fluidframework/cell":">=2.0.0-internal.5.3.0 <2.0.0-internal.5.4.0","@fluidframework/matrix":">=2.0.0-internal.5.3.0 <2.0.0-internal.5.4.0","@fluidframework/counter":">=2.0.0-internal.5.3.0 <2.0.0-internal.5.4.0","@fluidframework/sequence":">=2.0.0-internal.5.3.0 <2.0.0-internal.5.4.0","@fluid-experimental/tree2":">=2.0.0-internal.5.3.0 <2.0.0-internal.5.4.0","@fluidframework/common-utils":"^1.1.1","@fluidframework/container-utils":">=2.0.0-internal.5.3.0 <2.0.0-internal.5.4.0","@fluidframework/core-interfaces":">=2.0.0-internal.5.3.0 <2.0.0-internal.5.4.0","@fluidframework/telemetry-utils":">=2.0.0-internal.5.3.0 <2.0.0-internal.5.4.0","@fluidframework/container-loader":">=2.0.0-internal.5.3.0 <2.0.0-internal.5.4.0","@fluidframework/common-definitions":"^0.20.1","@fluidframework/shared-object-base":">=2.0.0-internal.5.3.0 <2.0.0-internal.5.4.0","@fluidframework/protocol-definitions":"^1.1.0","@fluidframework/container-definitions":">=2.0.0-internal.5.3.0 <2.0.0-internal.5.4.0"},"_hasShrinkwrap":false,"readmeFilename":"README.md","typeValidation":{"broken":{}},"devDependencies":{"nyc":"^15.1.0","chai":"^4.2.0","mocha":"^10.2.0","eslint":"~8.6.0","events":"^3.1.0","moment":"^2.21.0","rimraf":"^4.4.0","prettier":"~2.6.2","copyfiles":"^2.4.1","cross-env":"^7.0.3","typescript":"~4.5.5","@types/chai":"^4.0.0","@types/mocha":"^9.1.1","concurrently":"^7.6.0","@types/events":"^3.0.0","mocha-multi-reporters":"^1.5.1","@fluid-tools/build-cli":"^0.21.0","eslint-config-prettier":"~8.5.0","@microsoft/api-extractor":"^7.34.4","eslint-plugin-chai-expect":"~3.0.0","mocha-json-output-reporter":"^2.0.1","@fluidframework/build-tools":"^0.21.0","@fluidframework/build-common":"^1.2.0","@fluidframework/mocha-test-setup":">=2.0.0-internal.5.3.0 <2.0.0-internal.5.4.0","@fluidframework/driver-definitions":">=2.0.0-internal.5.3.0 <2.0.0-internal.5.4.0","@fluidframework/test-runtime-utils":">=2.0.0-internal.5.3.0 <2.0.0-internal.5.4.0","@fluidframework/eslint-config-fluid":"^2.0.0","@fluid-experimental/devtools-core-previous":"npm:@fluid-experimental/devtools-core@2.0.0-internal.5.2.0"},"_npmOperationalInternal":{"tmp":"tmp/devtools-core_2.0.0-internal.5.3.0_1689382668531_0.36872429558819997","host":"s3://npm-registry-packages"}},"2.0.0-internal.4.4.2":{"name":"@fluid-experimental/devtools-core","version":"2.0.0-internal.4.4.2","author":{"name":"Microsoft and contributors"},"license":"MIT","_id":"@fluid-experimental/devtools-core@2.0.0-internal.4.4.2","maintainers":[{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},{"name":"curtisman","email":"curtism@microsoft.com"}],"homepage":"https://fluidframework.com","bugs":{"url":"https://github.com/microsoft/FluidFramework/issues"},"nyc":{"all":true,"exclude":["src/test/**/*.ts","dist/test/**/*.js"],"include":["src/**/*.ts","dist/**/*.js"],"reporter":["cobertura","html","text"],"cache-dir":"nyc/.cache","report-dir":"nyc/report","temp-directory":"nyc/.nyc_output","exclude-after-remap":false},"dist":{"shasum":"ae13cb3ab22cd0ef0d323d94276df1cbe2a483c3","tarball":"https://registry.npmjs.org/@fluid-experimental/devtools-core/-/devtools-core-2.0.0-internal.4.4.2.tgz","fileCount":242,"integrity":"sha512-N9Ruoh+lYb76cFYMusWwGpRpAcuyTg/X0wVgp0oTA+NJm3An4BTcsZJwJmpxWadDvO56++YrFbP0Yd9rj/rx6w==","signatures":[{"sig":"MEUCIBNIMO6rY2TdbRpR3RZUO3eTwT686q83OBKhIly90uL0AiEA5HEsmESlbzjv63Vpn9fxWhTliEre+vwkqyA0ECZ5U3A=","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}],"unpackedSize":560749},"main":"dist/index.js","_from":"file:fluid-experimental-devtools-core-2.0.0-internal.4.4.2.tgz","types":"dist/index.d.ts","readme":"# @fluid-experimental/devtools-core\n\nThis library contains developer tools for use alongside the Fluid Framework.\nIt is used to power our associated browser extensions.\n\nTODO: link to extensions once they are published.\n\n\n\n\n\n\n## Installation\n\nTo get started, install the package by running the following command:\n\n```bash\nnpm i @fluid-experimental/devtools-core -D\n```\n\n\n\n\n\n## Usage\n\nThe Devtools' API surface is designed to fit nicely into most application flows.\n\n### Initialization\n\nTo initialize a debugger session for your container, call `initializeDevtools`.\nThis function accepts a `DevtoolsLogger` for recording and communicating telemetry data, a list of initial Fluid `Containers` to associate with the session, and (optionally) customized data visualization configurations for visualizing `Container` data.\n\nTODO: link to API docs once API shape has settled.\n\n### Clean-up\n\nThe Devtools object is managed as a global singleton.\nThat singleton is automatically cleaned up prior to the Window's \"unload\" event.\nSo typical application flows likely won't need to worry about cleanup.\nThat said, if you wish to have tighter control over when the Devtools are torn down, you can simply call the `dispose` method on the handle returned by [initialization](#initialization).\n\n## Related Tooling\n\nThis library is designed to work alongside our Chromium browser extension.\n\nTODO: link to code on github once package names have been finalized.\nTODO: link to the various browsers' webstore pages for our extension once it has been publiched.\n\n## Working in the package\n\n### Build\n\nTo build the package locally, first ensure you have run `pnpm install` from the root of the mono-repo.\nNext, to build the code, run `npm run build` from the root of the mono-repo, or use [fluid-build](https://github.com/microsoft/FluidFramework/tree/main/build-tools/packages/build-tools#running-fluid-build-command-line) via `fluid-build -s build`.\n\n- Note: Once you have run a build from the root, assuming no other changes outside of this package, you may run `npm run build` directly within this directory for a faster build.\n If you make changes to any of this package's local dependencies, you will need to run a build again from the root before building again from directly within this package.\n\n### Test\n\nTo run the tests, first ensure you have followed the [build](#build) steps above.\nNext, run `npm run test` from a terminal within this directory.\n\n\n\n\n\n\n\n## API Documentation\n\nAPI documentation for **@fluid-experimental/devtools-core** is available at .\n\n\n\n\n\n\n\n\n\n\n## Contribution Guidelines\n\nThere are many ways to [contribute](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md) to Fluid.\n\n- Participate in Q&A in our [GitHub Discussions](https://github.com/microsoft/FluidFramework/discussions).\n- [Submit bugs](https://github.com/microsoft/FluidFramework/issues) and help us verify fixes as they are checked in.\n- Review the [source code changes](https://github.com/microsoft/FluidFramework/pulls).\n- [Contribute bug fixes](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md).\n\nDetailed instructions for working in the repo can be found in the [Wiki](https://github.com/microsoft/FluidFramework/wiki).\n\nThis project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).\nFor more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\nUse of these trademarks or logos must follow Microsoft’s [Trademark & Brand Guidelines](https://www.microsoft.com/trademarks).\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n\n\n\n## Help\n\nNot finding what you're looking for in this README? Check out our [GitHub\nWiki](https://github.com/microsoft/FluidFramework/wiki) or [fluidframework.com](https://fluidframework.com/docs/).\n\nStill not finding what you're looking for? Please [file an\nissue](https://github.com/microsoft/FluidFramework/wiki/Submitting-Bugs-and-Feature-Requests).\n\nThank you!\n\n\n\n\n\n\n\n\n\n\n## Trademark\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\n\nUse of these trademarks or logos must follow Microsoft's [Trademark & Brand\nGuidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general).\n\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n","scripts":{"tsc":"tsc","lint":"npm run prettier && npm run eslint","test":"npm run test:mocha","build":"concurrently npm:build:compile npm:lint && npm run build:docs","clean":"rimraf _api-extractor-temp nyc dist *.tsbuildinfo *.build.log","eslint":"eslint src","format":"npm run prettier:fix","rebuild":"npm run clean && npm run build","lint:fix":"npm run prettier:fix && npm run eslint:fix","prettier":"prettier --check . --ignore-path ../../../../.prettierignore","build:docs":"api-extractor run --local && copyfiles -u 1 ./_api-extractor-temp/doc-models/* ../../../../_api-extractor-temp/","build:full":"npm run build","eslint:fix":"eslint src --fix","test:mocha":"mocha dist/**/*.test.js --unhandled-rejections=strict --exit","prettier:fix":"prettier --write . --ignore-path ../../../../.prettierignore","build:compile":"npm run tsc","ci:build:docs":"api-extractor run && copyfiles -u 1 ./_api-extractor-temp/doc-models/* ../../../../_api-extractor-temp/","test:coverage":"npm run test:mocha:coverage","format-and-build":"npm run format && npm run build","build:full:compile":"npm run build:compile","format-and-compile":"npm run format && npm run build:compile","test:mocha:coverage":"nyc npm run test:mocha -- --reporter xunit --reporter-option output=nyc/junit-report.xml","test:mocha:multireport":"cross-env FLUID_TEST_MULTIREPORT=1 npm run test:mocha"},"_npmUser":{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},"_resolved":"/mnt/vss/_work/1/pack/scoped/fluid-experimental-devtools-core-2.0.0-internal.4.4.2.tgz","_integrity":"sha512-N9Ruoh+lYb76cFYMusWwGpRpAcuyTg/X0wVgp0oTA+NJm3An4BTcsZJwJmpxWadDvO56++YrFbP0Yd9rj/rx6w==","repository":{"url":"git+https://github.com/microsoft/FluidFramework.git","type":"git","directory":"packages/tools/devtools/devtools-core"},"_npmVersion":"8.19.4","description":"Fluid Framework developer tools core functionality","directories":{},"sideEffects":false,"_nodeVersion":"16.20.1","dependencies":{"@fluidframework/map":">=2.0.0-internal.4.4.2 <2.0.0-internal.4.5.0","@fluidframework/cell":">=2.0.0-internal.4.4.2 <2.0.0-internal.4.5.0","@fluidframework/matrix":">=2.0.0-internal.4.4.2 <2.0.0-internal.4.5.0","@fluidframework/counter":">=2.0.0-internal.4.4.2 <2.0.0-internal.4.5.0","@fluidframework/sequence":">=2.0.0-internal.4.4.2 <2.0.0-internal.4.5.0","@fluidframework/common-utils":"^1.1.1","@fluidframework/container-utils":">=2.0.0-internal.4.4.2 <2.0.0-internal.4.5.0","@fluidframework/core-interfaces":">=2.0.0-internal.4.4.2 <2.0.0-internal.4.5.0","@fluidframework/telemetry-utils":">=2.0.0-internal.4.4.2 <2.0.0-internal.4.5.0","@fluidframework/container-loader":">=2.0.0-internal.4.4.2 <2.0.0-internal.4.5.0","@fluidframework/common-definitions":"^0.20.1","@fluidframework/shared-object-base":">=2.0.0-internal.4.4.2 <2.0.0-internal.4.5.0","@fluidframework/protocol-definitions":"^1.1.0","@fluidframework/container-definitions":">=2.0.0-internal.4.4.2 <2.0.0-internal.4.5.0"},"_hasShrinkwrap":false,"readmeFilename":"README.md","typeValidation":{"broken":{},"disabled":true},"devDependencies":{"nyc":"^15.1.0","chai":"^4.2.0","mocha":"^10.2.0","eslint":"~8.6.0","events":"^3.1.0","moment":"^2.21.0","rimraf":"^4.4.0","prettier":"~2.6.2","copyfiles":"^2.4.1","cross-env":"^7.0.3","typescript":"~4.5.5","@types/chai":"^4.0.0","@types/mocha":"^9.1.1","concurrently":"^7.6.0","@types/events":"^3.0.0","mocha-multi-reporters":"^1.5.1","eslint-config-prettier":"~8.5.0","@microsoft/api-extractor":"^7.34.4","eslint-plugin-chai-expect":"~3.0.0","mocha-json-output-reporter":"^2.0.1","@fluidframework/build-tools":"^0.18.2","@fluidframework/build-common":"^1.1.0","@fluidframework/mocha-test-setup":">=2.0.0-internal.4.4.2 <2.0.0-internal.4.5.0","@fluidframework/driver-definitions":">=2.0.0-internal.4.4.2 <2.0.0-internal.4.5.0","@fluidframework/test-runtime-utils":">=2.0.0-internal.4.4.2 <2.0.0-internal.4.5.0","@fluidframework/eslint-config-fluid":"^2.0.0"},"_npmOperationalInternal":{"tmp":"tmp/devtools-core_2.0.0-internal.4.4.2_1689973950776_0.3814498529718158","host":"s3://npm-registry-packages"}},"2.0.0-internal.5.3.1":{"name":"@fluid-experimental/devtools-core","version":"2.0.0-internal.5.3.1","author":{"name":"Microsoft and contributors"},"license":"MIT","_id":"@fluid-experimental/devtools-core@2.0.0-internal.5.3.1","maintainers":[{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},{"name":"curtisman","email":"curtism@microsoft.com"}],"homepage":"https://fluidframework.com","bugs":{"url":"https://github.com/microsoft/FluidFramework/issues"},"nyc":{"all":true,"exclude":["src/test/**/*.ts","dist/test/**/*.js"],"include":["src/**/*.ts","dist/**/*.js"],"reporter":["cobertura","html","text"],"cache-dir":"nyc/.cache","report-dir":"nyc/report","temp-directory":"nyc/.nyc_output","exclude-after-remap":false},"dist":{"shasum":"d3ddea8d7d51167f86c3b493a0f4c2f4d1ab4c06","tarball":"https://registry.npmjs.org/@fluid-experimental/devtools-core/-/devtools-core-2.0.0-internal.5.3.1.tgz","fileCount":465,"integrity":"sha512-CweUgvuL7Sa0tgmoJ1N/pJPiJFpUqR+ONKCaE5b3B60Vf3zo7BjgfcqL6QxFmj4rgx9242ih2C9o3zRGxB94FQ==","signatures":[{"sig":"MEUCIHwvd8VZR2DbrM9kNlcmxL8hODcVtP7MpmraSiu78IEiAiEA44HAWfttWrBgauvwo72YEv7wiREIwEw5zpuiWa8LsQo=","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}],"unpackedSize":1284837},"main":"dist/index.js","_from":"file:fluid-experimental-devtools-core-2.0.0-internal.5.3.1.tgz","types":"dist/index.d.ts","readme":"# @fluid-experimental/devtools-core\n\nThis library contains developer tools for use alongside the Fluid Framework.\nIt is used to power our associated [browser extension][browser-extension].\n\n- Chrome: \n- Edge: \n\n\n\n\n\n\n## Installation\n\nTo get started, install the package by running the following command:\n\n```bash\nnpm i @fluid-experimental/devtools-core -D\n```\n\n\n\n\n\n## Usage\n\nThe Devtools' API surface is designed to fit nicely into most application flows.\n\n### Initialization\n\nTo initialize a devtools session for your container, call [`initializeDevtools`][initialize-devtools-docs].\nThis function accepts a `DevtoolsLogger` for receiving Fluid telemetry from your application, a list of initial Fluid\n`Containers` to associate with the session, and (optionally) customized data visualization configurations for visualizing\n`Container` data.\n\n#### About the [`DevtoolsLogger`][devtools-logger-docs]\n\nThe `DevtoolsLogger` is an optional piece when calling `initializeDevtools` but it is strongly recommended that you use\nit because several features in Fluid Devtools are powered by the telemetry that Fluid Framework generates, and this\nlogger is the way in which that telemetry gets into Fluid Devtools.\n\nYou can obtain a `DevtoolsLogger` by calling its constructor, and then should pass it to `initializeDevtools` _and_\nto the `Loader` instance you'll use to create/load Containers as shown below.\nThis way the logger will receive all the telemetry generated by Fluid Framework in your application, and forward it to\nFluid Devtools as necessary.\n\n```typescript\nimport { DevtoolsLogger, initializeDevtools } from \"@fluid-experimental/devtools-core\";\n\n// Instantiate the logger\nconst devtoolsLogger = new DevtoolsLogger();\n\n// Pass the logger when instantiating the Loader\nconst loader = new Loader({\n\tlogger: devtoolsLogger,\n\t// Other necessary properties ...\n});\n\n// Use the Loader to create (and optionally, attach) a Container\nconst container = await loader.createDetachedContainer(/* params */);\nawait container.attach(/* params */);\n\n// Initialize the Devtools passing the logger and your Container.\n// The Container could be added later as well with devtools.registerContainerDevtools().\nconst devtools = initializeDevtools({\n\tlogger: devtoolsLogger,\n\tinitialContainers: [\n\t\t{\n\t\t\tcontainer,\n\t\t\tcontainerKey: \"My Container\",\n\t\t},\n\t],\n});\n```\n\nIf you're working with `AzureClient` instead of lower-level APIs like the one described above, you probably want to\nrefer to the [@fluid-experimental/devtools package][devtools-package] instead of this one.\n\nDuring local development the recommendation is that your application should receive the `DevtoolsLogger` instance _instead_\nof any logger it would normally receive when deployed to a real environment, to avoid local development activity from\nmixing with real telemetry.\nIf you still want to provide a real application logger and use the Fluid Devtools features that are powered by telemetry\nat the same time, you can pass an existing logger to the `DevtoolsLogger` constructor and it will forward all telemetry\nit receives to that logger as well:\n\n```typescript\nimport { DevtoolsLogger } from \"@fluid-experimental/devtools-core\";\n\n// Your application's logger\nconst yourApplicationLogger = getInstanceOfYourApplicationLogger();\n\nconst devtoolsLogger = new DevtoolsLogger(yourApplicationLogger);\n\n// Pass devtoolsLogger to initializeDevtools() and to your application as described above\n```\n\n### Clean-up\n\nThe Devtools object is managed as a global singleton.\nThat singleton is automatically cleaned up prior to the Window's \"unload\" event.\nSo typical application flows likely won't need to worry about cleanup.\nThat said, if you wish to have tighter control over when the Devtools are torn down, you can simply call the `dispose` method on the handle returned by [initialization](#initialization).\n\n## Contributing to the package\n\n### Build\n\nTo build the package locally, first ensure you have run `pnpm install` from the root of the mono-repo.\nNext, to build the code, run `npm run build` from the root of the mono-repo, or use [fluid-build](https://github.com/microsoft/FluidFramework/tree/main/build-tools/packages/build-tools#running-fluid-build-command-line) via `fluid-build -t build`.\n\n- Note: Once you have run a build from the root, assuming no other changes outside of this package, you may run `npm run build` directly within this directory for a faster build.\n If you make changes to any of this package's local dependencies, you will need to run a build again from the root before building again from directly within this package.\n\n### Test\n\nTo run the tests, first ensure you have followed the [build](#build) steps above.\nNext, run `npm run test` from a terminal within this directory.\n\n\n\n\n\n\n\n## API Documentation\n\nAPI documentation for **@fluid-experimental/devtools-core** is available at .\n\n\n\n\n\n\n\n\n\n\n## Contribution Guidelines\n\nThere are many ways to [contribute](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md) to Fluid.\n\n- Participate in Q&A in our [GitHub Discussions](https://github.com/microsoft/FluidFramework/discussions).\n- [Submit bugs](https://github.com/microsoft/FluidFramework/issues) and help us verify fixes as they are checked in.\n- Review the [source code changes](https://github.com/microsoft/FluidFramework/pulls).\n- [Contribute bug fixes](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md).\n\nDetailed instructions for working in the repo can be found in the [Wiki](https://github.com/microsoft/FluidFramework/wiki).\n\nThis project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).\nFor more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\nUse of these trademarks or logos must follow Microsoft’s [Trademark & Brand Guidelines](https://www.microsoft.com/trademarks).\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n\n\n\n## Help\n\nNot finding what you're looking for in this README? Check out our [GitHub\nWiki](https://github.com/microsoft/FluidFramework/wiki) or [fluidframework.com](https://fluidframework.com/docs/).\n\nStill not finding what you're looking for? Please [file an\nissue](https://github.com/microsoft/FluidFramework/wiki/Submitting-Bugs-and-Feature-Requests).\n\nThank you!\n\n\n\n\n\n\n\n\n\n\n## Trademark\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\n\nUse of these trademarks or logos must follow Microsoft's [Trademark & Brand\nGuidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general).\n\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n[initialize-devtools-docs]: https://fluidframework.com/docs/apis/devtools-core#initializedevtools-function\n[devtools-logger-docs]: https://fluidframework.com/docs/apis/devtools-core/devtoolslogger-class\n[devtools-package]: https://www.npmjs.com/package/@fluid-experimental/devtools\n[browser-extension]: https://github.com/microsoft/FluidFramework/tree/main/packages/tools/devtools/devtools-browser-extension\n","scripts":{"tsc":"tsc","lint":"npm run prettier && npm run eslint","test":"npm run test:mocha","build":"fluid-build . --task build","clean":"rimraf _api-extractor-temp nyc dist lib *.tsbuildinfo *.build.log","eslint":"eslint src","format":"npm run prettier:fix","rebuild":"npm run clean && npm run build","lint:fix":"npm run prettier:fix && npm run eslint:fix","prettier":"prettier --check . --ignore-path ../../../../.prettierignore","build:docs":"api-extractor run --local && copyfiles -u 1 ./_api-extractor-temp/doc-models/* ../../../../_api-extractor-temp/","eslint:fix":"eslint src --fix","test:mocha":"mocha dist/**/*.test.js --unhandled-rejections=strict --exit","build:esnext":"tsc --project ./tsconfig.esnext.json","prettier:fix":"prettier --write . --ignore-path ../../../../.prettierignore","build:compile":"fluid-build . --task compile","ci:build:docs":"api-extractor run && copyfiles -u 1 ./_api-extractor-temp/doc-models/* ../../../../_api-extractor-temp/","test:coverage":"npm run test:mocha:coverage","typetests:gen":"fluid-type-test-generator","build:commonjs":"fluid-build . --task commonjs","format-and-build":"npm run format && npm run build","typetests:prepare":"flub typetests --dir . --reset --previous --normalize","format-and-compile":"npm run format && npm run build:compile","test:mocha:coverage":"nyc npm run test:mocha -- --reporter xunit --reporter-option output=nyc/junit-report.xml","test:mocha:multireport":"cross-env FLUID_TEST_MULTIREPORT=1 npm run test:mocha"},"_npmUser":{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},"_resolved":"/mnt/vss/_work/1/pack/scoped/fluid-experimental-devtools-core-2.0.0-internal.5.3.1.tgz","_integrity":"sha512-CweUgvuL7Sa0tgmoJ1N/pJPiJFpUqR+ONKCaE5b3B60Vf3zo7BjgfcqL6QxFmj4rgx9242ih2C9o3zRGxB94FQ==","fluidBuild":{"tasks":{"tsc":["...","typetests:gen"]}},"repository":{"url":"git+https://github.com/microsoft/FluidFramework.git","type":"git","directory":"packages/tools/devtools/devtools-core"},"_npmVersion":"8.19.4","description":"Fluid Framework developer tools core functionality","directories":{},"sideEffects":false,"_nodeVersion":"16.20.1","dependencies":{"@fluidframework/map":">=2.0.0-internal.5.3.1 <2.0.0-internal.5.4.0","@fluidframework/cell":">=2.0.0-internal.5.3.1 <2.0.0-internal.5.4.0","@fluidframework/matrix":">=2.0.0-internal.5.3.1 <2.0.0-internal.5.4.0","@fluidframework/counter":">=2.0.0-internal.5.3.1 <2.0.0-internal.5.4.0","@fluidframework/sequence":">=2.0.0-internal.5.3.1 <2.0.0-internal.5.4.0","@fluid-experimental/tree2":">=2.0.0-internal.5.3.1 <2.0.0-internal.5.4.0","@fluidframework/common-utils":"^1.1.1","@fluidframework/container-utils":">=2.0.0-internal.5.3.1 <2.0.0-internal.5.4.0","@fluidframework/core-interfaces":">=2.0.0-internal.5.3.1 <2.0.0-internal.5.4.0","@fluidframework/telemetry-utils":">=2.0.0-internal.5.3.1 <2.0.0-internal.5.4.0","@fluidframework/container-loader":">=2.0.0-internal.5.3.1 <2.0.0-internal.5.4.0","@fluidframework/common-definitions":"^0.20.1","@fluidframework/shared-object-base":">=2.0.0-internal.5.3.1 <2.0.0-internal.5.4.0","@fluidframework/protocol-definitions":"^1.1.0","@fluidframework/container-definitions":">=2.0.0-internal.5.3.1 <2.0.0-internal.5.4.0"},"_hasShrinkwrap":false,"readmeFilename":"README.md","typeValidation":{"broken":{}},"devDependencies":{"nyc":"^15.1.0","chai":"^4.2.0","mocha":"^10.2.0","eslint":"~8.6.0","events":"^3.1.0","moment":"^2.21.0","rimraf":"^4.4.0","prettier":"~2.6.2","copyfiles":"^2.4.1","cross-env":"^7.0.3","typescript":"~4.5.5","@types/chai":"^4.0.0","@types/mocha":"^9.1.1","concurrently":"^7.6.0","@types/events":"^3.0.0","mocha-multi-reporters":"^1.5.1","@fluid-tools/build-cli":"^0.21.0","eslint-config-prettier":"~8.5.0","@microsoft/api-extractor":"^7.34.4","eslint-plugin-chai-expect":"~3.0.0","mocha-json-output-reporter":"^2.0.1","@fluidframework/build-tools":"^0.21.0","@fluidframework/build-common":"^1.2.0","@fluidframework/mocha-test-setup":">=2.0.0-internal.5.3.1 <2.0.0-internal.5.4.0","@fluidframework/driver-definitions":">=2.0.0-internal.5.3.1 <2.0.0-internal.5.4.0","@fluidframework/test-runtime-utils":">=2.0.0-internal.5.3.1 <2.0.0-internal.5.4.0","@fluidframework/eslint-config-fluid":"^2.0.0","@fluid-experimental/devtools-core-previous":"npm:@fluid-experimental/devtools-core@2.0.0-internal.5.2.0"},"_npmOperationalInternal":{"tmp":"tmp/devtools-core_2.0.0-internal.5.3.1_1690224142498_0.575287493734125","host":"s3://npm-registry-packages"}},"2.0.0-dev.5.3.2.178189":{"name":"@fluid-experimental/devtools-core","version":"2.0.0-dev.5.3.2.178189","author":{"name":"Microsoft and contributors"},"license":"MIT","_id":"@fluid-experimental/devtools-core@2.0.0-dev.5.3.2.178189","maintainers":[{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},{"name":"curtisman","email":"curtism@microsoft.com"}],"homepage":"https://fluidframework.com","bugs":{"url":"https://github.com/microsoft/FluidFramework/issues"},"nyc":{"all":true,"exclude":["src/test/**/*.ts","dist/test/**/*.js"],"include":["src/**/*.ts","dist/**/*.js"],"reporter":["cobertura","html","text"],"cache-dir":"nyc/.cache","report-dir":"nyc/report","temp-directory":"nyc/.nyc_output","exclude-after-remap":false},"dist":{"shasum":"3a61a7f204b7428973f1062a55176bc102ba16a4","tarball":"https://registry.npmjs.org/@fluid-experimental/devtools-core/-/devtools-core-2.0.0-dev.5.3.2.178189.tgz","fileCount":465,"integrity":"sha512-IALwLllgLV+ihUjWJ08i7kJabhycmMo0aK4pQKl6eatVpATGiz3Rq1UlkJS+8/+oGenZccVaPkySf5qJHyZwkw==","signatures":[{"sig":"MEQCICT2dSMWBQYXohSeH8Q9IaTIF7I2RwFk+K5YMSmsSvlHAiAVvzSsSrVydiqduCAvwNVKmoHnV4qIn1vV0zjGWcis4A==","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}],"unpackedSize":1284509},"main":"dist/index.js","_from":"file:fluid-experimental-devtools-core-2.0.0-dev.5.3.2.178189.tgz","types":"dist/index.d.ts","readme":"# @fluid-experimental/devtools-core\n\nThis library contains developer tools for use alongside the Fluid Framework.\nIt is used to power our associated [browser extension][browser-extension].\n\n- Chrome: \n- Edge: \n\n\n\n\n\n\n## Installation\n\nTo get started, install the package by running the following command:\n\n```bash\nnpm i @fluid-experimental/devtools-core -D\n```\n\n\n\n\n\n## Usage\n\nThe Devtools' API surface is designed to fit nicely into most application flows.\n\n### Initialization\n\nTo initialize a devtools session for your container, call [`initializeDevtools`][initialize-devtools-docs].\nThis function accepts a `DevtoolsLogger` for receiving Fluid telemetry from your application, a list of initial Fluid\n`Containers` to associate with the session, and (optionally) customized data visualization configurations for visualizing\n`Container` data.\n\n#### About the [`DevtoolsLogger`][devtools-logger-docs]\n\nThe `DevtoolsLogger` is an optional piece when calling `initializeDevtools` but it is strongly recommended that you use\nit because several features in Fluid Devtools are powered by the telemetry that Fluid Framework generates, and this\nlogger is the way in which that telemetry gets into Fluid Devtools.\n\nYou can obtain a `DevtoolsLogger` by calling its constructor, and then should pass it to `initializeDevtools` _and_\nto the `Loader` instance you'll use to create/load Containers as shown below.\nThis way the logger will receive all the telemetry generated by Fluid Framework in your application, and forward it to\nFluid Devtools as necessary.\n\n```typescript\nimport { DevtoolsLogger, initializeDevtools } from \"@fluid-experimental/devtools-core\";\n\n// Instantiate the logger\nconst devtoolsLogger = new DevtoolsLogger();\n\n// Pass the logger when instantiating the Loader\nconst loader = new Loader({\n\tlogger: devtoolsLogger,\n\t// Other necessary properties ...\n});\n\n// Use the Loader to create (and optionally, attach) a Container\nconst container = await loader.createDetachedContainer(/* params */);\nawait container.attach(/* params */);\n\n// Initialize the Devtools passing the logger and your Container.\n// The Container could be added later as well with devtools.registerContainerDevtools().\nconst devtools = initializeDevtools({\n\tlogger: devtoolsLogger,\n\tinitialContainers: [\n\t\t{\n\t\t\tcontainer,\n\t\t\tcontainerKey: \"My Container\",\n\t\t},\n\t],\n});\n```\n\nIf you're working with `AzureClient` instead of lower-level APIs like the one described above, you probably want to\nrefer to the [@fluid-experimental/devtools package][devtools-package] instead of this one.\n\nDuring local development the recommendation is that your application should receive the `DevtoolsLogger` instance _instead_\nof any logger it would normally receive when deployed to a real environment, to avoid local development activity from\nmixing with real telemetry.\nIf you still want to provide a real application logger and use the Fluid Devtools features that are powered by telemetry\nat the same time, you can pass an existing logger to the `DevtoolsLogger` constructor and it will forward all telemetry\nit receives to that logger as well:\n\n```typescript\nimport { DevtoolsLogger } from \"@fluid-experimental/devtools-core\";\n\n// Your application's logger\nconst yourApplicationLogger = getInstanceOfYourApplicationLogger();\n\nconst devtoolsLogger = new DevtoolsLogger(yourApplicationLogger);\n\n// Pass devtoolsLogger to initializeDevtools() and to your application as described above\n```\n\n### Clean-up\n\nThe Devtools object is managed as a global singleton.\nThat singleton is automatically cleaned up prior to the Window's \"unload\" event.\nSo typical application flows likely won't need to worry about cleanup.\nThat said, if you wish to have tighter control over when the Devtools are torn down, you can simply call the `dispose` method on the handle returned by [initialization](#initialization).\n\n## Contributing to the package\n\n### Build\n\nTo build the package locally, first ensure you have run `pnpm install` from the root of the mono-repo.\nNext, to build the code, run `npm run build` from the root of the mono-repo, or use [fluid-build](https://github.com/microsoft/FluidFramework/tree/main/build-tools/packages/build-tools#running-fluid-build-command-line) via `fluid-build -t build`.\n\n- Note: Once you have run a build from the root, assuming no other changes outside of this package, you may run `npm run build` directly within this directory for a faster build.\n If you make changes to any of this package's local dependencies, you will need to run a build again from the root before building again from directly within this package.\n\n### Test\n\nTo run the tests, first ensure you have followed the [build](#build) steps above.\nNext, run `npm run test` from a terminal within this directory.\n\n\n\n\n\n\n\n## API Documentation\n\nAPI documentation for **@fluid-experimental/devtools-core** is available at .\n\n\n\n\n\n\n\n\n\n\n## Contribution Guidelines\n\nThere are many ways to [contribute](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md) to Fluid.\n\n- Participate in Q&A in our [GitHub Discussions](https://github.com/microsoft/FluidFramework/discussions).\n- [Submit bugs](https://github.com/microsoft/FluidFramework/issues) and help us verify fixes as they are checked in.\n- Review the [source code changes](https://github.com/microsoft/FluidFramework/pulls).\n- [Contribute bug fixes](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md).\n\nDetailed instructions for working in the repo can be found in the [Wiki](https://github.com/microsoft/FluidFramework/wiki).\n\nThis project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).\nFor more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\nUse of these trademarks or logos must follow Microsoft’s [Trademark & Brand Guidelines](https://www.microsoft.com/trademarks).\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n\n\n\n## Help\n\nNot finding what you're looking for in this README? Check out our [GitHub\nWiki](https://github.com/microsoft/FluidFramework/wiki) or [fluidframework.com](https://fluidframework.com/docs/).\n\nStill not finding what you're looking for? Please [file an\nissue](https://github.com/microsoft/FluidFramework/wiki/Submitting-Bugs-and-Feature-Requests).\n\nThank you!\n\n\n\n\n\n\n\n\n\n\n## Trademark\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\n\nUse of these trademarks or logos must follow Microsoft's [Trademark & Brand\nGuidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general).\n\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n[initialize-devtools-docs]: https://fluidframework.com/docs/apis/devtools-core#initializedevtools-function\n[devtools-logger-docs]: https://fluidframework.com/docs/apis/devtools-core/devtoolslogger-class\n[devtools-package]: https://www.npmjs.com/package/@fluid-experimental/devtools\n[browser-extension]: https://github.com/microsoft/FluidFramework/tree/main/packages/tools/devtools/devtools-browser-extension\n","scripts":{"tsc":"tsc","lint":"npm run prettier && npm run eslint","test":"npm run test:mocha","build":"fluid-build . --task build","clean":"rimraf _api-extractor-temp nyc dist lib *.tsbuildinfo *.build.log","eslint":"eslint src","format":"npm run prettier:fix","rebuild":"npm run clean && npm run build","lint:fix":"npm run prettier:fix && npm run eslint:fix","prettier":"prettier --check . --ignore-path ../../../../.prettierignore","build:docs":"api-extractor run --local && copyfiles -u 1 ./_api-extractor-temp/doc-models/* ../../../../_api-extractor-temp/","eslint:fix":"eslint src --fix","test:mocha":"mocha dist/**/*.test.js --unhandled-rejections=strict --exit","build:esnext":"tsc --project ./tsconfig.esnext.json","prettier:fix":"prettier --write . --ignore-path ../../../../.prettierignore","build:compile":"fluid-build . --task compile","ci:build:docs":"api-extractor run && copyfiles -u 1 ./_api-extractor-temp/doc-models/* ../../../../_api-extractor-temp/","test:coverage":"npm run test:mocha:coverage","typetests:gen":"fluid-type-test-generator","build:commonjs":"fluid-build . --task commonjs","format-and-build":"npm run format && npm run build","typetests:prepare":"flub typetests --dir . --reset --previous --normalize","format-and-compile":"npm run format && npm run build:compile","test:mocha:coverage":"nyc npm run test:mocha -- --reporter xunit --reporter-option output=nyc/junit-report.xml","test:mocha:multireport":"cross-env FLUID_TEST_MULTIREPORT=1 npm run test:mocha"},"_npmUser":{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},"_resolved":"/mnt/vss/_work/1/pack/scoped/fluid-experimental-devtools-core-2.0.0-dev.5.3.2.178189.tgz","_integrity":"sha512-IALwLllgLV+ihUjWJ08i7kJabhycmMo0aK4pQKl6eatVpATGiz3Rq1UlkJS+8/+oGenZccVaPkySf5qJHyZwkw==","fluidBuild":{"tasks":{"tsc":["...","typetests:gen"]}},"repository":{"url":"git+https://github.com/microsoft/FluidFramework.git","type":"git","directory":"packages/tools/devtools/devtools-core"},"_npmVersion":"8.19.4","description":"Fluid Framework developer tools core functionality","directories":{},"sideEffects":false,"_nodeVersion":"16.20.1","dependencies":{"@fluidframework/map":"2.0.0-dev.5.3.2.178189","@fluidframework/cell":"2.0.0-dev.5.3.2.178189","@fluidframework/matrix":"2.0.0-dev.5.3.2.178189","@fluidframework/counter":"2.0.0-dev.5.3.2.178189","@fluidframework/sequence":"2.0.0-dev.5.3.2.178189","@fluid-experimental/tree2":"2.0.0-dev.5.3.2.178189","@fluidframework/common-utils":"^1.1.1","@fluidframework/container-utils":"2.0.0-dev.5.3.2.178189","@fluidframework/core-interfaces":"2.0.0-dev.5.3.2.178189","@fluidframework/telemetry-utils":"2.0.0-dev.5.3.2.178189","@fluidframework/container-loader":"2.0.0-dev.5.3.2.178189","@fluidframework/common-definitions":"^0.20.1","@fluidframework/shared-object-base":"2.0.0-dev.5.3.2.178189","@fluidframework/protocol-definitions":"^1.1.0","@fluidframework/container-definitions":"2.0.0-dev.5.3.2.178189"},"_hasShrinkwrap":false,"readmeFilename":"README.md","typeValidation":{"broken":{}},"devDependencies":{"nyc":"^15.1.0","chai":"^4.2.0","mocha":"^10.2.0","eslint":"~8.6.0","events":"^3.1.0","moment":"^2.21.0","rimraf":"^4.4.0","prettier":"~2.6.2","copyfiles":"^2.4.1","cross-env":"^7.0.3","typescript":"~4.5.5","@types/chai":"^4.0.0","@types/mocha":"^9.1.1","concurrently":"^7.6.0","@types/events":"^3.0.0","mocha-multi-reporters":"^1.5.1","@fluid-tools/build-cli":"^0.21.0","eslint-config-prettier":"~8.5.0","@microsoft/api-extractor":"^7.34.4","eslint-plugin-chai-expect":"~3.0.0","mocha-json-output-reporter":"^2.0.1","@fluidframework/build-tools":"^0.21.0","@fluidframework/build-common":"^1.2.0","@fluidframework/mocha-test-setup":"2.0.0-dev.5.3.2.178189","@fluidframework/driver-definitions":"2.0.0-dev.5.3.2.178189","@fluidframework/test-runtime-utils":"2.0.0-dev.5.3.2.178189","@fluidframework/eslint-config-fluid":"^2.0.0","@fluid-experimental/devtools-core-previous":"npm:@fluid-experimental/devtools-core@2.0.0-internal.5.2.0"},"_npmOperationalInternal":{"tmp":"tmp/devtools-core_2.0.0-dev.5.3.2.178189_1690310241843_0.28244735248971753","host":"s3://npm-registry-packages"}},"2.0.0-internal.4.4.3":{"name":"@fluid-experimental/devtools-core","version":"2.0.0-internal.4.4.3","author":{"name":"Microsoft and contributors"},"license":"MIT","_id":"@fluid-experimental/devtools-core@2.0.0-internal.4.4.3","maintainers":[{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},{"name":"curtisman","email":"curtism@microsoft.com"}],"homepage":"https://fluidframework.com","bugs":{"url":"https://github.com/microsoft/FluidFramework/issues"},"nyc":{"all":true,"exclude":["src/test/**/*.ts","dist/test/**/*.js"],"include":["src/**/*.ts","dist/**/*.js"],"reporter":["cobertura","html","text"],"cache-dir":"nyc/.cache","report-dir":"nyc/report","temp-directory":"nyc/.nyc_output","exclude-after-remap":false},"dist":{"shasum":"c2d2498e3f3cc96ccae193317ffe1077f9eb80dc","tarball":"https://registry.npmjs.org/@fluid-experimental/devtools-core/-/devtools-core-2.0.0-internal.4.4.3.tgz","fileCount":242,"integrity":"sha512-BNkOivVUlED+0xOolo0XUV0UsvdZiAZV2gFu7N8r7wqACqQCTy+0azKPoNXXQs/7p5ImQAfiobYdsoW5jhHZjg==","signatures":[{"sig":"MEUCIQDe0ISnmftJ0XjBVEwGQLQOWMtJrZHhDxsw7fr3bk+GIAIgFptGt50E52ZuTMQSRPUNOWjrG732R4x3fmFqKtTwSko=","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}],"unpackedSize":560749},"main":"dist/index.js","_from":"file:fluid-experimental-devtools-core-2.0.0-internal.4.4.3.tgz","types":"dist/index.d.ts","readme":"# @fluid-experimental/devtools-core\n\nThis library contains developer tools for use alongside the Fluid Framework.\nIt is used to power our associated browser extensions.\n\nTODO: link to extensions once they are published.\n\n\n\n\n\n\n## Installation\n\nTo get started, install the package by running the following command:\n\n```bash\nnpm i @fluid-experimental/devtools-core -D\n```\n\n\n\n\n\n## Usage\n\nThe Devtools' API surface is designed to fit nicely into most application flows.\n\n### Initialization\n\nTo initialize a debugger session for your container, call `initializeDevtools`.\nThis function accepts a `DevtoolsLogger` for recording and communicating telemetry data, a list of initial Fluid `Containers` to associate with the session, and (optionally) customized data visualization configurations for visualizing `Container` data.\n\nTODO: link to API docs once API shape has settled.\n\n### Clean-up\n\nThe Devtools object is managed as a global singleton.\nThat singleton is automatically cleaned up prior to the Window's \"unload\" event.\nSo typical application flows likely won't need to worry about cleanup.\nThat said, if you wish to have tighter control over when the Devtools are torn down, you can simply call the `dispose` method on the handle returned by [initialization](#initialization).\n\n## Related Tooling\n\nThis library is designed to work alongside our Chromium browser extension.\n\nTODO: link to code on github once package names have been finalized.\nTODO: link to the various browsers' webstore pages for our extension once it has been publiched.\n\n## Working in the package\n\n### Build\n\nTo build the package locally, first ensure you have run `pnpm install` from the root of the mono-repo.\nNext, to build the code, run `npm run build` from the root of the mono-repo, or use [fluid-build](https://github.com/microsoft/FluidFramework/tree/main/build-tools/packages/build-tools#running-fluid-build-command-line) via `fluid-build -s build`.\n\n- Note: Once you have run a build from the root, assuming no other changes outside of this package, you may run `npm run build` directly within this directory for a faster build.\n If you make changes to any of this package's local dependencies, you will need to run a build again from the root before building again from directly within this package.\n\n### Test\n\nTo run the tests, first ensure you have followed the [build](#build) steps above.\nNext, run `npm run test` from a terminal within this directory.\n\n\n\n\n\n\n\n## API Documentation\n\nAPI documentation for **@fluid-experimental/devtools-core** is available at .\n\n\n\n\n\n\n\n\n\n\n## Contribution Guidelines\n\nThere are many ways to [contribute](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md) to Fluid.\n\n- Participate in Q&A in our [GitHub Discussions](https://github.com/microsoft/FluidFramework/discussions).\n- [Submit bugs](https://github.com/microsoft/FluidFramework/issues) and help us verify fixes as they are checked in.\n- Review the [source code changes](https://github.com/microsoft/FluidFramework/pulls).\n- [Contribute bug fixes](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md).\n\nDetailed instructions for working in the repo can be found in the [Wiki](https://github.com/microsoft/FluidFramework/wiki).\n\nThis project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).\nFor more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\nUse of these trademarks or logos must follow Microsoft’s [Trademark & Brand Guidelines](https://www.microsoft.com/trademarks).\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n\n\n\n## Help\n\nNot finding what you're looking for in this README? Check out our [GitHub\nWiki](https://github.com/microsoft/FluidFramework/wiki) or [fluidframework.com](https://fluidframework.com/docs/).\n\nStill not finding what you're looking for? Please [file an\nissue](https://github.com/microsoft/FluidFramework/wiki/Submitting-Bugs-and-Feature-Requests).\n\nThank you!\n\n\n\n\n\n\n\n\n\n\n## Trademark\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\n\nUse of these trademarks or logos must follow Microsoft's [Trademark & Brand\nGuidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general).\n\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n","scripts":{"tsc":"tsc","lint":"npm run prettier && npm run eslint","test":"npm run test:mocha","build":"concurrently npm:build:compile npm:lint && npm run build:docs","clean":"rimraf _api-extractor-temp nyc dist *.tsbuildinfo *.build.log","eslint":"eslint src","format":"npm run prettier:fix","rebuild":"npm run clean && npm run build","lint:fix":"npm run prettier:fix && npm run eslint:fix","prettier":"prettier --check . --ignore-path ../../../../.prettierignore","build:docs":"api-extractor run --local && copyfiles -u 1 ./_api-extractor-temp/doc-models/* ../../../../_api-extractor-temp/","build:full":"npm run build","eslint:fix":"eslint src --fix","test:mocha":"mocha dist/**/*.test.js --unhandled-rejections=strict --exit","prettier:fix":"prettier --write . --ignore-path ../../../../.prettierignore","build:compile":"npm run tsc","ci:build:docs":"api-extractor run && copyfiles -u 1 ./_api-extractor-temp/doc-models/* ../../../../_api-extractor-temp/","test:coverage":"npm run test:mocha:coverage","format-and-build":"npm run format && npm run build","build:full:compile":"npm run build:compile","format-and-compile":"npm run format && npm run build:compile","test:mocha:coverage":"nyc npm run test:mocha -- --reporter xunit --reporter-option output=nyc/junit-report.xml","test:mocha:multireport":"cross-env FLUID_TEST_MULTIREPORT=1 npm run test:mocha"},"_npmUser":{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},"_resolved":"/mnt/vss/_work/1/pack/scoped/fluid-experimental-devtools-core-2.0.0-internal.4.4.3.tgz","_integrity":"sha512-BNkOivVUlED+0xOolo0XUV0UsvdZiAZV2gFu7N8r7wqACqQCTy+0azKPoNXXQs/7p5ImQAfiobYdsoW5jhHZjg==","repository":{"url":"git+https://github.com/microsoft/FluidFramework.git","type":"git","directory":"packages/tools/devtools/devtools-core"},"_npmVersion":"8.19.4","description":"Fluid Framework developer tools core functionality","directories":{},"sideEffects":false,"_nodeVersion":"16.20.1","dependencies":{"@fluidframework/map":">=2.0.0-internal.4.4.3 <2.0.0-internal.4.5.0","@fluidframework/cell":">=2.0.0-internal.4.4.3 <2.0.0-internal.4.5.0","@fluidframework/matrix":">=2.0.0-internal.4.4.3 <2.0.0-internal.4.5.0","@fluidframework/counter":">=2.0.0-internal.4.4.3 <2.0.0-internal.4.5.0","@fluidframework/sequence":">=2.0.0-internal.4.4.3 <2.0.0-internal.4.5.0","@fluidframework/common-utils":"^1.1.1","@fluidframework/container-utils":">=2.0.0-internal.4.4.3 <2.0.0-internal.4.5.0","@fluidframework/core-interfaces":">=2.0.0-internal.4.4.3 <2.0.0-internal.4.5.0","@fluidframework/telemetry-utils":">=2.0.0-internal.4.4.3 <2.0.0-internal.4.5.0","@fluidframework/container-loader":">=2.0.0-internal.4.4.3 <2.0.0-internal.4.5.0","@fluidframework/common-definitions":"^0.20.1","@fluidframework/shared-object-base":">=2.0.0-internal.4.4.3 <2.0.0-internal.4.5.0","@fluidframework/protocol-definitions":"^1.1.0","@fluidframework/container-definitions":">=2.0.0-internal.4.4.3 <2.0.0-internal.4.5.0"},"_hasShrinkwrap":false,"readmeFilename":"README.md","typeValidation":{"broken":{},"disabled":true},"devDependencies":{"nyc":"^15.1.0","chai":"^4.2.0","mocha":"^10.2.0","eslint":"~8.6.0","events":"^3.1.0","moment":"^2.21.0","rimraf":"^4.4.0","prettier":"~2.6.2","copyfiles":"^2.4.1","cross-env":"^7.0.3","typescript":"~4.5.5","@types/chai":"^4.0.0","@types/mocha":"^9.1.1","concurrently":"^7.6.0","@types/events":"^3.0.0","mocha-multi-reporters":"^1.5.1","eslint-config-prettier":"~8.5.0","@microsoft/api-extractor":"^7.34.4","eslint-plugin-chai-expect":"~3.0.0","mocha-json-output-reporter":"^2.0.1","@fluidframework/build-tools":"^0.18.2","@fluidframework/build-common":"^1.1.0","@fluidframework/mocha-test-setup":">=2.0.0-internal.4.4.3 <2.0.0-internal.4.5.0","@fluidframework/driver-definitions":">=2.0.0-internal.4.4.3 <2.0.0-internal.4.5.0","@fluidframework/test-runtime-utils":">=2.0.0-internal.4.4.3 <2.0.0-internal.4.5.0","@fluidframework/eslint-config-fluid":"^2.0.0"},"_npmOperationalInternal":{"tmp":"tmp/devtools-core_2.0.0-internal.4.4.3_1690486644223_0.5106114326543705","host":"s3://npm-registry-packages"}},"2.0.0-internal.5.3.2":{"name":"@fluid-experimental/devtools-core","version":"2.0.0-internal.5.3.2","author":{"name":"Microsoft and contributors"},"license":"MIT","_id":"@fluid-experimental/devtools-core@2.0.0-internal.5.3.2","maintainers":[{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},{"name":"curtisman","email":"curtism@microsoft.com"}],"homepage":"https://fluidframework.com","bugs":{"url":"https://github.com/microsoft/FluidFramework/issues"},"nyc":{"all":true,"exclude":["src/test/**/*.ts","dist/test/**/*.js"],"include":["src/**/*.ts","dist/**/*.js"],"reporter":["cobertura","html","text"],"cache-dir":"nyc/.cache","report-dir":"nyc/report","temp-directory":"nyc/.nyc_output","exclude-after-remap":false},"dist":{"shasum":"7444f6422ceb587522e831e20d2250ff5b79392a","tarball":"https://registry.npmjs.org/@fluid-experimental/devtools-core/-/devtools-core-2.0.0-internal.5.3.2.tgz","fileCount":465,"integrity":"sha512-pU2gUvC0rKWQwPBt8lCIomtiBZy9c2q5+kzEPFqUbDmWKYio1J5x26nd1hQUx1WTE673wRhKHS1R7t32zsRE1w==","signatures":[{"sig":"MEUCIQDFFedi6aYsRcJOi+E9a0bEoxDKFOhmJ0VOBxwx6mLsYQIgNh9S5NafMhW+Ye/ZeUo6TWPTSRuA9RDJ9wnwGsFVhJI=","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}],"unpackedSize":1284837},"main":"dist/index.js","_from":"file:fluid-experimental-devtools-core-2.0.0-internal.5.3.2.tgz","types":"dist/index.d.ts","readme":"# @fluid-experimental/devtools-core\n\nThis library contains developer tools for use alongside the Fluid Framework.\nIt is used to power our associated [browser extension][browser-extension].\n\n- Chrome: \n- Edge: \n\n\n\n\n\n\n## Installation\n\nTo get started, install the package by running the following command:\n\n```bash\nnpm i @fluid-experimental/devtools-core -D\n```\n\n\n\n\n\n## Usage\n\nThe Devtools' API surface is designed to fit nicely into most application flows.\n\n### Initialization\n\nTo initialize a devtools session for your container, call [`initializeDevtools`][initialize-devtools-docs].\nThis function accepts a `DevtoolsLogger` for receiving Fluid telemetry from your application, a list of initial Fluid\n`Containers` to associate with the session, and (optionally) customized data visualization configurations for visualizing\n`Container` data.\n\n#### About the [`DevtoolsLogger`][devtools-logger-docs]\n\nThe `DevtoolsLogger` is an optional piece when calling `initializeDevtools` but it is strongly recommended that you use\nit because several features in Fluid Devtools are powered by the telemetry that Fluid Framework generates, and this\nlogger is the way in which that telemetry gets into Fluid Devtools.\n\nYou can obtain a `DevtoolsLogger` by calling its constructor, and then should pass it to `initializeDevtools` _and_\nto the `Loader` instance you'll use to create/load Containers as shown below.\nThis way the logger will receive all the telemetry generated by Fluid Framework in your application, and forward it to\nFluid Devtools as necessary.\n\n```typescript\nimport { DevtoolsLogger, initializeDevtools } from \"@fluid-experimental/devtools-core\";\n\n// Instantiate the logger\nconst devtoolsLogger = new DevtoolsLogger();\n\n// Pass the logger when instantiating the Loader\nconst loader = new Loader({\n\tlogger: devtoolsLogger,\n\t// Other necessary properties ...\n});\n\n// Use the Loader to create (and optionally, attach) a Container\nconst container = await loader.createDetachedContainer(/* params */);\nawait container.attach(/* params */);\n\n// Initialize the Devtools passing the logger and your Container.\n// The Container could be added later as well with devtools.registerContainerDevtools().\nconst devtools = initializeDevtools({\n\tlogger: devtoolsLogger,\n\tinitialContainers: [\n\t\t{\n\t\t\tcontainer,\n\t\t\tcontainerKey: \"My Container\",\n\t\t},\n\t],\n});\n```\n\nIf you're working with `AzureClient` instead of lower-level APIs like the one described above, you probably want to\nrefer to the [@fluid-experimental/devtools package][devtools-package] instead of this one.\n\nDuring local development the recommendation is that your application should receive the `DevtoolsLogger` instance _instead_\nof any logger it would normally receive when deployed to a real environment, to avoid local development activity from\nmixing with real telemetry.\nIf you still want to provide a real application logger and use the Fluid Devtools features that are powered by telemetry\nat the same time, you can pass an existing logger to the `DevtoolsLogger` constructor and it will forward all telemetry\nit receives to that logger as well:\n\n```typescript\nimport { DevtoolsLogger } from \"@fluid-experimental/devtools-core\";\n\n// Your application's logger\nconst yourApplicationLogger = getInstanceOfYourApplicationLogger();\n\nconst devtoolsLogger = new DevtoolsLogger(yourApplicationLogger);\n\n// Pass devtoolsLogger to initializeDevtools() and to your application as described above\n```\n\n### Clean-up\n\nThe Devtools object is managed as a global singleton.\nThat singleton is automatically cleaned up prior to the Window's \"unload\" event.\nSo typical application flows likely won't need to worry about cleanup.\nThat said, if you wish to have tighter control over when the Devtools are torn down, you can simply call the `dispose` method on the handle returned by [initialization](#initialization).\n\n## Contributing to the package\n\n### Build\n\nTo build the package locally, first ensure you have run `pnpm install` from the root of the mono-repo.\nNext, to build the code, run `npm run build` from the root of the mono-repo, or use [fluid-build](https://github.com/microsoft/FluidFramework/tree/main/build-tools/packages/build-tools#running-fluid-build-command-line) via `fluid-build -t build`.\n\n- Note: Once you have run a build from the root, assuming no other changes outside of this package, you may run `npm run build` directly within this directory for a faster build.\n If you make changes to any of this package's local dependencies, you will need to run a build again from the root before building again from directly within this package.\n\n### Test\n\nTo run the tests, first ensure you have followed the [build](#build) steps above.\nNext, run `npm run test` from a terminal within this directory.\n\n\n\n\n\n\n\n## API Documentation\n\nAPI documentation for **@fluid-experimental/devtools-core** is available at .\n\n\n\n\n\n\n\n\n\n\n## Contribution Guidelines\n\nThere are many ways to [contribute](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md) to Fluid.\n\n- Participate in Q&A in our [GitHub Discussions](https://github.com/microsoft/FluidFramework/discussions).\n- [Submit bugs](https://github.com/microsoft/FluidFramework/issues) and help us verify fixes as they are checked in.\n- Review the [source code changes](https://github.com/microsoft/FluidFramework/pulls).\n- [Contribute bug fixes](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md).\n\nDetailed instructions for working in the repo can be found in the [Wiki](https://github.com/microsoft/FluidFramework/wiki).\n\nThis project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).\nFor more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\nUse of these trademarks or logos must follow Microsoft’s [Trademark & Brand Guidelines](https://www.microsoft.com/trademarks).\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n\n\n\n## Help\n\nNot finding what you're looking for in this README? Check out our [GitHub\nWiki](https://github.com/microsoft/FluidFramework/wiki) or [fluidframework.com](https://fluidframework.com/docs/).\n\nStill not finding what you're looking for? Please [file an\nissue](https://github.com/microsoft/FluidFramework/wiki/Submitting-Bugs-and-Feature-Requests).\n\nThank you!\n\n\n\n\n\n\n\n\n\n\n## Trademark\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\n\nUse of these trademarks or logos must follow Microsoft's [Trademark & Brand\nGuidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general).\n\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n[initialize-devtools-docs]: https://fluidframework.com/docs/apis/devtools-core#initializedevtools-function\n[devtools-logger-docs]: https://fluidframework.com/docs/apis/devtools-core/devtoolslogger-class\n[devtools-package]: https://www.npmjs.com/package/@fluid-experimental/devtools\n[browser-extension]: https://github.com/microsoft/FluidFramework/tree/main/packages/tools/devtools/devtools-browser-extension\n","scripts":{"tsc":"tsc","lint":"npm run prettier && npm run eslint","test":"npm run test:mocha","build":"fluid-build . --task build","clean":"rimraf _api-extractor-temp nyc dist lib *.tsbuildinfo *.build.log","eslint":"eslint src","format":"npm run prettier:fix","rebuild":"npm run clean && npm run build","lint:fix":"npm run prettier:fix && npm run eslint:fix","prettier":"prettier --check . --ignore-path ../../../../.prettierignore","build:docs":"api-extractor run --local && copyfiles -u 1 ./_api-extractor-temp/doc-models/* ../../../../_api-extractor-temp/","eslint:fix":"eslint src --fix","test:mocha":"mocha dist/**/*.test.js --unhandled-rejections=strict --exit","build:esnext":"tsc --project ./tsconfig.esnext.json","prettier:fix":"prettier --write . --ignore-path ../../../../.prettierignore","build:compile":"fluid-build . --task compile","ci:build:docs":"api-extractor run && copyfiles -u 1 ./_api-extractor-temp/doc-models/* ../../../../_api-extractor-temp/","test:coverage":"npm run test:mocha:coverage","typetests:gen":"fluid-type-test-generator","build:commonjs":"fluid-build . --task commonjs","format-and-build":"npm run format && npm run build","typetests:prepare":"flub typetests --dir . --reset --previous --normalize","format-and-compile":"npm run format && npm run build:compile","test:mocha:coverage":"nyc npm run test:mocha -- --reporter xunit --reporter-option output=nyc/junit-report.xml","test:mocha:multireport":"cross-env FLUID_TEST_MULTIREPORT=1 npm run test:mocha"},"_npmUser":{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},"_resolved":"/mnt/vss/_work/1/pack/scoped/fluid-experimental-devtools-core-2.0.0-internal.5.3.2.tgz","_integrity":"sha512-pU2gUvC0rKWQwPBt8lCIomtiBZy9c2q5+kzEPFqUbDmWKYio1J5x26nd1hQUx1WTE673wRhKHS1R7t32zsRE1w==","fluidBuild":{"tasks":{"tsc":["...","typetests:gen"]}},"repository":{"url":"git+https://github.com/microsoft/FluidFramework.git","type":"git","directory":"packages/tools/devtools/devtools-core"},"_npmVersion":"8.19.4","description":"Fluid Framework developer tools core functionality","directories":{},"sideEffects":false,"_nodeVersion":"16.20.1","dependencies":{"@fluidframework/map":">=2.0.0-internal.5.3.2 <2.0.0-internal.5.4.0","@fluidframework/cell":">=2.0.0-internal.5.3.2 <2.0.0-internal.5.4.0","@fluidframework/matrix":">=2.0.0-internal.5.3.2 <2.0.0-internal.5.4.0","@fluidframework/counter":">=2.0.0-internal.5.3.2 <2.0.0-internal.5.4.0","@fluidframework/sequence":">=2.0.0-internal.5.3.2 <2.0.0-internal.5.4.0","@fluid-experimental/tree2":">=2.0.0-internal.5.3.2 <2.0.0-internal.5.4.0","@fluidframework/common-utils":"^1.1.1","@fluidframework/container-utils":">=2.0.0-internal.5.3.2 <2.0.0-internal.5.4.0","@fluidframework/core-interfaces":">=2.0.0-internal.5.3.2 <2.0.0-internal.5.4.0","@fluidframework/telemetry-utils":">=2.0.0-internal.5.3.2 <2.0.0-internal.5.4.0","@fluidframework/container-loader":">=2.0.0-internal.5.3.2 <2.0.0-internal.5.4.0","@fluidframework/common-definitions":"^0.20.1","@fluidframework/shared-object-base":">=2.0.0-internal.5.3.2 <2.0.0-internal.5.4.0","@fluidframework/protocol-definitions":"^1.1.0","@fluidframework/container-definitions":">=2.0.0-internal.5.3.2 <2.0.0-internal.5.4.0"},"_hasShrinkwrap":false,"readmeFilename":"README.md","typeValidation":{"broken":{}},"devDependencies":{"nyc":"^15.1.0","chai":"^4.2.0","mocha":"^10.2.0","eslint":"~8.6.0","events":"^3.1.0","moment":"^2.21.0","rimraf":"^4.4.0","prettier":"~2.6.2","copyfiles":"^2.4.1","cross-env":"^7.0.3","typescript":"~4.5.5","@types/chai":"^4.0.0","@types/mocha":"^9.1.1","concurrently":"^7.6.0","@types/events":"^3.0.0","mocha-multi-reporters":"^1.5.1","@fluid-tools/build-cli":"^0.21.0","eslint-config-prettier":"~8.5.0","@microsoft/api-extractor":"^7.34.4","eslint-plugin-chai-expect":"~3.0.0","mocha-json-output-reporter":"^2.0.1","@fluidframework/build-tools":"^0.21.0","@fluidframework/build-common":"^1.2.0","@fluidframework/mocha-test-setup":">=2.0.0-internal.5.3.2 <2.0.0-internal.5.4.0","@fluidframework/driver-definitions":">=2.0.0-internal.5.3.2 <2.0.0-internal.5.4.0","@fluidframework/test-runtime-utils":">=2.0.0-internal.5.3.2 <2.0.0-internal.5.4.0","@fluidframework/eslint-config-fluid":"^2.0.0","@fluid-experimental/devtools-core-previous":"npm:@fluid-experimental/devtools-core@2.0.0-internal.5.2.0"},"_npmOperationalInternal":{"tmp":"tmp/devtools-core_2.0.0-internal.5.3.2_1690492189439_0.9724405335292303","host":"s3://npm-registry-packages"}},"2.0.0-internal.4.4.4":{"name":"@fluid-experimental/devtools-core","version":"2.0.0-internal.4.4.4","author":{"name":"Microsoft and contributors"},"license":"MIT","_id":"@fluid-experimental/devtools-core@2.0.0-internal.4.4.4","maintainers":[{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},{"name":"curtisman","email":"curtism@microsoft.com"}],"homepage":"https://fluidframework.com","bugs":{"url":"https://github.com/microsoft/FluidFramework/issues"},"nyc":{"all":true,"exclude":["src/test/**/*.ts","dist/test/**/*.js"],"include":["src/**/*.ts","dist/**/*.js"],"reporter":["cobertura","html","text"],"cache-dir":"nyc/.cache","report-dir":"nyc/report","temp-directory":"nyc/.nyc_output","exclude-after-remap":false},"dist":{"shasum":"a2aa57e6d4c5ae808826a7d9356ce65e20cf23e9","tarball":"https://registry.npmjs.org/@fluid-experimental/devtools-core/-/devtools-core-2.0.0-internal.4.4.4.tgz","fileCount":242,"integrity":"sha512-mg+CdeR9diSCuX6+rmD1DnGpJKf3pELsq8Dm8+ekisXZgVLWoSsqubOqKz4Tsp10jsL0BRmRs9GIJVKP0oOa7w==","signatures":[{"sig":"MEUCIQDI55oqFSjGh0HvptyWhpR136ecl+Ql6nHexncSEbClYAIgV4D2TjFX2izxFO6PR0RD+oyEQ6t8krwXnex4YE5o2jQ=","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}],"unpackedSize":560749},"main":"dist/index.js","_from":"file:fluid-experimental-devtools-core-2.0.0-internal.4.4.4.tgz","types":"dist/index.d.ts","readme":"# @fluid-experimental/devtools-core\n\nThis library contains developer tools for use alongside the Fluid Framework.\nIt is used to power our associated browser extensions.\n\nTODO: link to extensions once they are published.\n\n\n\n\n\n\n## Installation\n\nTo get started, install the package by running the following command:\n\n```bash\nnpm i @fluid-experimental/devtools-core -D\n```\n\n\n\n\n\n## Usage\n\nThe Devtools' API surface is designed to fit nicely into most application flows.\n\n### Initialization\n\nTo initialize a debugger session for your container, call `initializeDevtools`.\nThis function accepts a `DevtoolsLogger` for recording and communicating telemetry data, a list of initial Fluid `Containers` to associate with the session, and (optionally) customized data visualization configurations for visualizing `Container` data.\n\nTODO: link to API docs once API shape has settled.\n\n### Clean-up\n\nThe Devtools object is managed as a global singleton.\nThat singleton is automatically cleaned up prior to the Window's \"unload\" event.\nSo typical application flows likely won't need to worry about cleanup.\nThat said, if you wish to have tighter control over when the Devtools are torn down, you can simply call the `dispose` method on the handle returned by [initialization](#initialization).\n\n## Related Tooling\n\nThis library is designed to work alongside our Chromium browser extension.\n\nTODO: link to code on github once package names have been finalized.\nTODO: link to the various browsers' webstore pages for our extension once it has been publiched.\n\n## Working in the package\n\n### Build\n\nTo build the package locally, first ensure you have run `pnpm install` from the root of the mono-repo.\nNext, to build the code, run `npm run build` from the root of the mono-repo, or use [fluid-build](https://github.com/microsoft/FluidFramework/tree/main/build-tools/packages/build-tools#running-fluid-build-command-line) via `fluid-build -s build`.\n\n- Note: Once you have run a build from the root, assuming no other changes outside of this package, you may run `npm run build` directly within this directory for a faster build.\n If you make changes to any of this package's local dependencies, you will need to run a build again from the root before building again from directly within this package.\n\n### Test\n\nTo run the tests, first ensure you have followed the [build](#build) steps above.\nNext, run `npm run test` from a terminal within this directory.\n\n\n\n\n\n\n\n## API Documentation\n\nAPI documentation for **@fluid-experimental/devtools-core** is available at .\n\n\n\n\n\n\n\n\n\n\n## Contribution Guidelines\n\nThere are many ways to [contribute](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md) to Fluid.\n\n- Participate in Q&A in our [GitHub Discussions](https://github.com/microsoft/FluidFramework/discussions).\n- [Submit bugs](https://github.com/microsoft/FluidFramework/issues) and help us verify fixes as they are checked in.\n- Review the [source code changes](https://github.com/microsoft/FluidFramework/pulls).\n- [Contribute bug fixes](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md).\n\nDetailed instructions for working in the repo can be found in the [Wiki](https://github.com/microsoft/FluidFramework/wiki).\n\nThis project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).\nFor more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\nUse of these trademarks or logos must follow Microsoft’s [Trademark & Brand Guidelines](https://www.microsoft.com/trademarks).\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n\n\n\n## Help\n\nNot finding what you're looking for in this README? Check out our [GitHub\nWiki](https://github.com/microsoft/FluidFramework/wiki) or [fluidframework.com](https://fluidframework.com/docs/).\n\nStill not finding what you're looking for? Please [file an\nissue](https://github.com/microsoft/FluidFramework/wiki/Submitting-Bugs-and-Feature-Requests).\n\nThank you!\n\n\n\n\n\n\n\n\n\n\n## Trademark\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\n\nUse of these trademarks or logos must follow Microsoft's [Trademark & Brand\nGuidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general).\n\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n","scripts":{"tsc":"tsc","lint":"npm run prettier && npm run eslint","test":"npm run test:mocha","build":"concurrently npm:build:compile npm:lint && npm run build:docs","clean":"rimraf _api-extractor-temp nyc dist *.tsbuildinfo *.build.log","eslint":"eslint src","format":"npm run prettier:fix","rebuild":"npm run clean && npm run build","lint:fix":"npm run prettier:fix && npm run eslint:fix","prettier":"prettier --check . --ignore-path ../../../../.prettierignore","build:docs":"api-extractor run --local && copyfiles -u 1 ./_api-extractor-temp/doc-models/* ../../../../_api-extractor-temp/","build:full":"npm run build","eslint:fix":"eslint src --fix","test:mocha":"mocha dist/**/*.test.js --unhandled-rejections=strict --exit","prettier:fix":"prettier --write . --ignore-path ../../../../.prettierignore","build:compile":"npm run tsc","ci:build:docs":"api-extractor run && copyfiles -u 1 ./_api-extractor-temp/doc-models/* ../../../../_api-extractor-temp/","test:coverage":"npm run test:mocha:coverage","format-and-build":"npm run format && npm run build","build:full:compile":"npm run build:compile","format-and-compile":"npm run format && npm run build:compile","test:mocha:coverage":"nyc npm run test:mocha -- --reporter xunit --reporter-option output=nyc/junit-report.xml","test:mocha:multireport":"cross-env FLUID_TEST_MULTIREPORT=1 npm run test:mocha"},"_npmUser":{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},"_resolved":"/mnt/vss/_work/1/pack/scoped/fluid-experimental-devtools-core-2.0.0-internal.4.4.4.tgz","_integrity":"sha512-mg+CdeR9diSCuX6+rmD1DnGpJKf3pELsq8Dm8+ekisXZgVLWoSsqubOqKz4Tsp10jsL0BRmRs9GIJVKP0oOa7w==","repository":{"url":"git+https://github.com/microsoft/FluidFramework.git","type":"git","directory":"packages/tools/devtools/devtools-core"},"_npmVersion":"8.19.4","description":"Fluid Framework developer tools core functionality","directories":{},"sideEffects":false,"_nodeVersion":"16.20.1","dependencies":{"@fluidframework/map":">=2.0.0-internal.4.4.4 <2.0.0-internal.4.5.0","@fluidframework/cell":">=2.0.0-internal.4.4.4 <2.0.0-internal.4.5.0","@fluidframework/matrix":">=2.0.0-internal.4.4.4 <2.0.0-internal.4.5.0","@fluidframework/counter":">=2.0.0-internal.4.4.4 <2.0.0-internal.4.5.0","@fluidframework/sequence":">=2.0.0-internal.4.4.4 <2.0.0-internal.4.5.0","@fluidframework/common-utils":"^1.1.1","@fluidframework/container-utils":">=2.0.0-internal.4.4.4 <2.0.0-internal.4.5.0","@fluidframework/core-interfaces":">=2.0.0-internal.4.4.4 <2.0.0-internal.4.5.0","@fluidframework/telemetry-utils":">=2.0.0-internal.4.4.4 <2.0.0-internal.4.5.0","@fluidframework/container-loader":">=2.0.0-internal.4.4.4 <2.0.0-internal.4.5.0","@fluidframework/common-definitions":"^0.20.1","@fluidframework/shared-object-base":">=2.0.0-internal.4.4.4 <2.0.0-internal.4.5.0","@fluidframework/protocol-definitions":"^1.1.0","@fluidframework/container-definitions":">=2.0.0-internal.4.4.4 <2.0.0-internal.4.5.0"},"_hasShrinkwrap":false,"readmeFilename":"README.md","typeValidation":{"broken":{},"disabled":true},"devDependencies":{"nyc":"^15.1.0","chai":"^4.2.0","mocha":"^10.2.0","eslint":"~8.6.0","events":"^3.1.0","moment":"^2.21.0","rimraf":"^4.4.0","prettier":"~2.6.2","copyfiles":"^2.4.1","cross-env":"^7.0.3","typescript":"~4.5.5","@types/chai":"^4.0.0","@types/mocha":"^9.1.1","concurrently":"^7.6.0","@types/events":"^3.0.0","mocha-multi-reporters":"^1.5.1","eslint-config-prettier":"~8.5.0","@microsoft/api-extractor":"^7.34.4","eslint-plugin-chai-expect":"~3.0.0","mocha-json-output-reporter":"^2.0.1","@fluidframework/build-tools":"^0.18.2","@fluidframework/build-common":"^1.1.0","@fluidframework/mocha-test-setup":">=2.0.0-internal.4.4.4 <2.0.0-internal.4.5.0","@fluidframework/driver-definitions":">=2.0.0-internal.4.4.4 <2.0.0-internal.4.5.0","@fluidframework/test-runtime-utils":">=2.0.0-internal.4.4.4 <2.0.0-internal.4.5.0","@fluidframework/eslint-config-fluid":"^2.0.0"},"_npmOperationalInternal":{"tmp":"tmp/devtools-core_2.0.0-internal.4.4.4_1691098228903_0.4943995312651548","host":"s3://npm-registry-packages"}},"2.0.0-internal.5.4.0":{"name":"@fluid-experimental/devtools-core","version":"2.0.0-internal.5.4.0","author":{"name":"Microsoft and contributors"},"license":"MIT","_id":"@fluid-experimental/devtools-core@2.0.0-internal.5.4.0","maintainers":[{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},{"name":"curtisman","email":"curtism@microsoft.com"}],"homepage":"https://fluidframework.com","bugs":{"url":"https://github.com/microsoft/FluidFramework/issues"},"nyc":{"all":true,"exclude":["src/test/**/*.ts","dist/test/**/*.js"],"include":["src/**/*.ts","dist/**/*.js"],"reporter":["cobertura","html","text"],"cache-dir":"nyc/.cache","report-dir":"nyc/report","temp-directory":"nyc/.nyc_output","exclude-after-remap":false},"dist":{"shasum":"59a3420b17d5a9af1576e56d424d585a6b6c3386","tarball":"https://registry.npmjs.org/@fluid-experimental/devtools-core/-/devtools-core-2.0.0-internal.5.4.0.tgz","fileCount":501,"integrity":"sha512-CAICwfJUoLMF6ildxyiPVcwq/MMh1o0Cb3wVoZo0+53sY+5/jpz0dlntt26qoeviSNQ0dTD7sxRP3X5jypN95g==","signatures":[{"sig":"MEYCIQDWVMZhhcJqyfRwJ5Ejx+OmnzzjigPYre1El4dTSQUkzQIhAI7v4iCx0kPPMoYg8/8iJ6b4hO5FbTp4r7YSwqEG3g77","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}],"unpackedSize":1338014},"main":"dist/index.js","_from":"file:fluid-experimental-devtools-core-2.0.0-internal.5.4.0.tgz","types":"dist/index.d.ts","readme":"# @fluid-experimental/devtools-core\n\nThis library contains developer tools for use alongside the Fluid Framework.\nIt is used to power our associated [browser extension][browser-extension].\n\n- Chrome: \n- Edge: \n\n\n\n\n\n\n## Installation\n\nTo get started, install the package by running the following command:\n\n```bash\nnpm i @fluid-experimental/devtools-core -D\n```\n\n\n\n\n\n## Usage\n\nThe Devtools' API surface is designed to fit nicely into most application flows.\n\n### Initialization\n\nTo initialize a devtools session for your container, call [`initializeDevtools`][initialize-devtools-docs].\nThis function accepts a `DevtoolsLogger` for receiving Fluid telemetry from your application, a list of initial Fluid\n`Containers` to associate with the session, and (optionally) customized data visualization configurations for visualizing\n`Container` data.\n\n#### About the [`DevtoolsLogger`][devtools-logger-docs]\n\nThe `DevtoolsLogger` is an optional piece when calling `initializeDevtools` but it is strongly recommended that you use\nit because several features in Fluid Devtools are powered by the telemetry that Fluid Framework generates, and this\nlogger is the way in which that telemetry gets into Fluid Devtools.\n\nYou can obtain a `DevtoolsLogger` by calling its constructor, and then should pass it to `initializeDevtools` _and_\nto the `Loader` instance you'll use to create/load Containers as shown below.\nThis way the logger will receive all the telemetry generated by Fluid Framework in your application, and forward it to\nFluid Devtools as necessary.\n\n```typescript\nimport { DevtoolsLogger, initializeDevtools } from \"@fluid-experimental/devtools-core\";\n\n// Instantiate the logger\nconst devtoolsLogger = new DevtoolsLogger();\n\n// Pass the logger when instantiating the Loader\nconst loader = new Loader({\n\tlogger: devtoolsLogger,\n\t// Other necessary properties ...\n});\n\n// Use the Loader to create (and optionally, attach) a Container\nconst container = await loader.createDetachedContainer(/* params */);\nawait container.attach(/* params */);\n\n// Initialize the Devtools passing the logger and your Container.\n// The Container could be added later as well with devtools.registerContainerDevtools().\nconst devtools = initializeDevtools({\n\tlogger: devtoolsLogger,\n\tinitialContainers: [\n\t\t{\n\t\t\tcontainer,\n\t\t\tcontainerKey: \"My Container\",\n\t\t},\n\t],\n});\n```\n\nIf you're working with `AzureClient` instead of lower-level APIs like the one described above, you probably want to\nrefer to the [@fluid-experimental/devtools package][devtools-package] instead of this one.\n\nDuring local development the recommendation is that your application should receive the `DevtoolsLogger` instance _instead_\nof any logger it would normally receive when deployed to a real environment, to avoid local development activity from\nmixing with real telemetry.\nIf you still want to provide a real application logger and use the Fluid Devtools features that are powered by telemetry\nat the same time, you can pass an existing logger to the `DevtoolsLogger` constructor and it will forward all telemetry\nit receives to that logger as well:\n\n```typescript\nimport { DevtoolsLogger } from \"@fluid-experimental/devtools-core\";\n\n// Your application's logger\nconst yourApplicationLogger = getInstanceOfYourApplicationLogger();\n\nconst devtoolsLogger = new DevtoolsLogger(yourApplicationLogger);\n\n// Pass devtoolsLogger to initializeDevtools() and to your application as described above\n```\n\n### Clean-up\n\nThe Devtools object is managed as a global singleton.\nThat singleton is automatically cleaned up prior to the Window's \"unload\" event.\nSo typical application flows likely won't need to worry about cleanup.\nThat said, if you wish to have tighter control over when the Devtools are torn down, you can simply call the `dispose` method on the handle returned by [initialization](#initialization).\n\n## Contributing to the package\n\n### Build\n\nTo build the package locally, first ensure you have run `pnpm install` from the root of the mono-repo.\nNext, to build the code, run `npm run build` from the root of the mono-repo, or use [fluid-build](https://github.com/microsoft/FluidFramework/tree/main/build-tools/packages/build-tools#running-fluid-build-command-line) via `fluid-build -t build`.\n\n- Note: Once you have run a build from the root, assuming no other changes outside of this package, you may run `npm run build` directly within this directory for a faster build.\n If you make changes to any of this package's local dependencies, you will need to run a build again from the root before building again from directly within this package.\n\n### Test\n\nTo run the tests, first ensure you have followed the [build](#build) steps above.\nNext, run `npm run test` from a terminal within this directory.\n\n\n\n\n\n\n\n## API Documentation\n\nAPI documentation for **@fluid-experimental/devtools-core** is available at .\n\n\n\n\n\n\n\n\n\n\n## Contribution Guidelines\n\nThere are many ways to [contribute](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md) to Fluid.\n\n- Participate in Q&A in our [GitHub Discussions](https://github.com/microsoft/FluidFramework/discussions).\n- [Submit bugs](https://github.com/microsoft/FluidFramework/issues) and help us verify fixes as they are checked in.\n- Review the [source code changes](https://github.com/microsoft/FluidFramework/pulls).\n- [Contribute bug fixes](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md).\n\nDetailed instructions for working in the repo can be found in the [Wiki](https://github.com/microsoft/FluidFramework/wiki).\n\nThis project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).\nFor more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\nUse of these trademarks or logos must follow Microsoft’s [Trademark & Brand Guidelines](https://www.microsoft.com/trademarks).\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n\n\n\n## Help\n\nNot finding what you're looking for in this README? Check out our [GitHub\nWiki](https://github.com/microsoft/FluidFramework/wiki) or [fluidframework.com](https://fluidframework.com/docs/).\n\nStill not finding what you're looking for? Please [file an\nissue](https://github.com/microsoft/FluidFramework/wiki/Submitting-Bugs-and-Feature-Requests).\n\nThank you!\n\n\n\n\n\n\n\n\n\n\n## Trademark\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\n\nUse of these trademarks or logos must follow Microsoft's [Trademark & Brand\nGuidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general).\n\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n[initialize-devtools-docs]: https://fluidframework.com/docs/apis/devtools-core#initializedevtools-function\n[devtools-logger-docs]: https://fluidframework.com/docs/apis/devtools-core/devtoolslogger-class\n[devtools-package]: https://www.npmjs.com/package/@fluid-experimental/devtools\n[browser-extension]: https://github.com/microsoft/FluidFramework/tree/main/packages/tools/devtools/devtools-browser-extension\n","scripts":{"tsc":"tsc","lint":"npm run prettier && npm run eslint","test":"npm run test:mocha","build":"fluid-build . --task build","clean":"rimraf --glob \"_api-extractor-temp\" \"nyc\" \"dist\" \"lib\" \"*.tsbuildinfo\" \"*.build.log\"","eslint":"eslint src","format":"npm run prettier:fix","rebuild":"npm run clean && npm run build","lint:fix":"npm run prettier:fix && npm run eslint:fix","prettier":"prettier --check . --ignore-path ../../../../.prettierignore","build:docs":"api-extractor run --local && copyfiles -u 1 ./_api-extractor-temp/doc-models/* ../../../../_api-extractor-temp/","eslint:fix":"eslint src --fix","test:mocha":"mocha dist/**/*.test.js --unhandled-rejections=strict --exit","build:esnext":"tsc --project ./tsconfig.esnext.json","build:genver":"gen-version","prettier:fix":"prettier --write . --ignore-path ../../../../.prettierignore","build:compile":"fluid-build . --task compile","ci:build:docs":"api-extractor run && copyfiles -u 1 ./_api-extractor-temp/doc-models/* ../../../../_api-extractor-temp/","test:coverage":"npm run test:mocha:coverage","typetests:gen":"fluid-type-test-generator","build:commonjs":"fluid-build . --task commonjs","format-and-build":"npm run format && npm run build","typetests:prepare":"flub typetests --dir . --reset --previous --normalize","format-and-compile":"npm run format && npm run build:compile","test:mocha:coverage":"nyc npm run test:mocha -- --reporter xunit --reporter-option output=nyc/junit-report.xml","test:mocha:multireport":"cross-env FLUID_TEST_MULTIREPORT=1 npm run test:mocha"},"_npmUser":{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},"_resolved":"/mnt/vss/_work/1/pack/scoped/fluid-experimental-devtools-core-2.0.0-internal.5.4.0.tgz","_integrity":"sha512-CAICwfJUoLMF6ildxyiPVcwq/MMh1o0Cb3wVoZo0+53sY+5/jpz0dlntt26qoeviSNQ0dTD7sxRP3X5jypN95g==","fluidBuild":{"tasks":{"tsc":["...","typetests:gen"]}},"repository":{"url":"git+https://github.com/microsoft/FluidFramework.git","type":"git","directory":"packages/tools/devtools/devtools-core"},"_npmVersion":"8.11.0","description":"Fluid Framework developer tools core functionality","directories":{},"sideEffects":false,"_nodeVersion":"16.16.0","dependencies":{"@fluidframework/map":">=2.0.0-internal.5.4.0 <2.0.0-internal.5.5.0","@fluidframework/cell":">=2.0.0-internal.5.4.0 <2.0.0-internal.5.5.0","@fluidframework/matrix":">=2.0.0-internal.5.4.0 <2.0.0-internal.5.5.0","@fluidframework/counter":">=2.0.0-internal.5.4.0 <2.0.0-internal.5.5.0","@fluidframework/sequence":">=2.0.0-internal.5.4.0 <2.0.0-internal.5.5.0","@fluid-experimental/tree2":">=2.0.0-internal.5.4.0 <2.0.0-internal.5.5.0","@fluidframework/common-utils":"^1.1.1","@fluidframework/container-utils":">=2.0.0-internal.5.4.0 <2.0.0-internal.5.5.0","@fluidframework/core-interfaces":">=2.0.0-internal.5.4.0 <2.0.0-internal.5.5.0","@fluidframework/container-loader":">=2.0.0-internal.5.4.0 <2.0.0-internal.5.5.0","@fluidframework/common-definitions":"^0.20.1","@fluidframework/shared-object-base":">=2.0.0-internal.5.4.0 <2.0.0-internal.5.5.0","@fluidframework/protocol-definitions":"^1.1.0","@fluidframework/container-definitions":">=2.0.0-internal.5.4.0 <2.0.0-internal.5.5.0","@fluidframework/datastore-definitions":">=2.0.0-internal.5.4.0 <2.0.0-internal.5.5.0"},"_hasShrinkwrap":false,"readmeFilename":"README.md","typeValidation":{"broken":{"ClassDeclaration_DevtoolsLogger":{"backCompat":false},"InterfaceDeclaration_FluidDevtoolsProps":{"backCompat":false},"EnumDeclaration_ContainerDevtoolsFeature":{"backCompat":false},"RemovedTypeAliasDeclaration_VisualizeChildData":{"backCompat":false,"forwardCompat":false},"RemovedTypeAliasDeclaration_VisualizeSharedObject":{"backCompat":false,"forwardCompat":false}}},"devDependencies":{"nyc":"^15.1.0","chai":"^4.2.0","mocha":"^10.2.0","eslint":"~8.6.0","events":"^3.1.0","moment":"^2.21.0","rimraf":"^4.4.0","prettier":"~2.6.2","copyfiles":"^2.4.1","cross-env":"^7.0.3","typescript":"~4.5.5","@types/chai":"^4.0.0","@types/mocha":"^9.1.1","concurrently":"^7.6.0","@types/events":"^3.0.0","mocha-multi-reporters":"^1.5.1","@fluid-tools/build-cli":"^0.21.0","eslint-config-prettier":"~8.5.0","@microsoft/api-extractor":"^7.34.4","eslint-plugin-chai-expect":"~3.0.0","mocha-json-output-reporter":"^2.0.1","@fluidframework/build-tools":"^0.21.0","@fluidframework/build-common":"^1.2.0","@fluidframework/telemetry-utils":">=2.0.0-internal.5.4.0 <2.0.0-internal.5.5.0","@fluidframework/mocha-test-setup":">=2.0.0-internal.5.4.0 <2.0.0-internal.5.5.0","@fluidframework/driver-definitions":">=2.0.0-internal.5.4.0 <2.0.0-internal.5.5.0","@fluidframework/test-runtime-utils":">=2.0.0-internal.5.4.0 <2.0.0-internal.5.5.0","@fluidframework/eslint-config-fluid":"^2.0.0","@fluid-experimental/devtools-core-previous":"npm:@fluid-experimental/devtools-core@2.0.0-internal.5.2.0"},"_npmOperationalInternal":{"tmp":"tmp/devtools-core_2.0.0-internal.5.4.0_1691098431387_0.7851926381267154","host":"s3://npm-registry-packages"}},"2.0.0-internal.6.0.0":{"name":"@fluid-experimental/devtools-core","version":"2.0.0-internal.6.0.0","author":{"name":"Microsoft and contributors"},"license":"MIT","_id":"@fluid-experimental/devtools-core@2.0.0-internal.6.0.0","maintainers":[{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},{"name":"curtisman","email":"curtism@microsoft.com"}],"homepage":"https://fluidframework.com","bugs":{"url":"https://github.com/microsoft/FluidFramework/issues"},"nyc":{"all":true,"exclude":["src/test/**/*.ts","dist/test/**/*.js"],"include":["src/**/*.ts","dist/**/*.js"],"reporter":["cobertura","html","text"],"cache-dir":"nyc/.cache","report-dir":"nyc/report","temp-directory":"nyc/.nyc_output","exclude-after-remap":false},"dist":{"shasum":"6ceea91e63ee4601e12b77b4984f9bc9879df4a7","tarball":"https://registry.npmjs.org/@fluid-experimental/devtools-core/-/devtools-core-2.0.0-internal.6.0.0.tgz","fileCount":501,"integrity":"sha512-Mk1UTKqZmeHvqpYQkgoTL1czv8BVnZWvHWFIAEiE7tejTWAHWCj+HBTAP4F7pjqy8Jf3jypO5TZCooRBliRS4g==","signatures":[{"sig":"MEYCIQCd0fG9sBMioiulOS0YqfCYCV5pkEZIayC1gfd+7pU+PgIhAKdPfd75HvNH29PCVoyeH6WX6xiwaCuw5i4UBp4+TRbD","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}],"unpackedSize":1338945},"main":"dist/index.js","_from":"file:fluid-experimental-devtools-core-2.0.0-internal.6.0.0.tgz","types":"dist/index.d.ts","readme":"# @fluid-experimental/devtools-core\n\nThis library contains developer tools for use alongside the Fluid Framework.\nIt is used to power our associated [browser extension][browser-extension].\n\n- Chrome: \n- Edge: \n\n\n\n\n\n\n## Installation\n\nTo get started, install the package by running the following command:\n\n```bash\nnpm i @fluid-experimental/devtools-core -D\n```\n\n\n\n\n\n## Usage\n\nThe Devtools' API surface is designed to fit nicely into most application flows.\n\n### Initialization\n\nTo initialize a devtools session for your container, call [`initializeDevtools`][initialize-devtools-docs].\nThis function accepts a `DevtoolsLogger` for receiving Fluid telemetry from your application, a list of initial Fluid\n`Containers` to associate with the session, and (optionally) customized data visualization configurations for visualizing\n`Container` data.\n\n#### About the [`DevtoolsLogger`][devtools-logger-docs]\n\nThe `DevtoolsLogger` is an optional piece when calling `initializeDevtools` but it is strongly recommended that you use\nit because several features in Fluid Devtools are powered by the telemetry that Fluid Framework generates, and this\nlogger is the way in which that telemetry gets into Fluid Devtools.\n\nYou can obtain a `DevtoolsLogger` by calling its constructor, and then should pass it to `initializeDevtools` _and_\nto the `Loader` instance you'll use to create/load Containers as shown below.\nThis way the logger will receive all the telemetry generated by Fluid Framework in your application, and forward it to\nFluid Devtools as necessary.\n\n```typescript\nimport { DevtoolsLogger, initializeDevtools } from \"@fluid-experimental/devtools-core\";\n\n// Instantiate the logger\nconst devtoolsLogger = new DevtoolsLogger();\n\n// Pass the logger when instantiating the Loader\nconst loader = new Loader({\n\tlogger: devtoolsLogger,\n\t// Other necessary properties ...\n});\n\n// Use the Loader to create (and optionally, attach) a Container\nconst container = await loader.createDetachedContainer(/* params */);\nawait container.attach(/* params */);\n\n// Initialize the Devtools passing the logger and your Container.\n// The Container could be added later as well with devtools.registerContainerDevtools().\nconst devtools = initializeDevtools({\n\tlogger: devtoolsLogger,\n\tinitialContainers: [\n\t\t{\n\t\t\tcontainer,\n\t\t\tcontainerKey: \"My Container\",\n\t\t},\n\t],\n});\n```\n\nIf you're working with `AzureClient` instead of lower-level APIs like the one described above, you probably want to\nrefer to the [@fluid-experimental/devtools package][devtools-package] instead of this one.\n\nDuring local development the recommendation is that your application should receive the `DevtoolsLogger` instance _instead_\nof any logger it would normally receive when deployed to a real environment, to avoid local development activity from\nmixing with real telemetry.\nIf you still want to provide a real application logger and use the Fluid Devtools features that are powered by telemetry\nat the same time, you can pass an existing logger to the `DevtoolsLogger` constructor and it will forward all telemetry\nit receives to that logger as well:\n\n```typescript\nimport { DevtoolsLogger } from \"@fluid-experimental/devtools-core\";\n\n// Your application's logger\nconst yourApplicationLogger = getInstanceOfYourApplicationLogger();\n\nconst devtoolsLogger = new DevtoolsLogger(yourApplicationLogger);\n\n// Pass devtoolsLogger to initializeDevtools() and to your application as described above\n```\n\n### Clean-up\n\nThe Devtools object is managed as a global singleton.\nThat singleton is automatically cleaned up prior to the Window's \"unload\" event.\nSo typical application flows likely won't need to worry about cleanup.\nThat said, if you wish to have tighter control over when the Devtools are torn down, you can simply call the `dispose` method on the handle returned by [initialization](#initialization).\n\n## Contributing to the package\n\n### Build\n\nTo build the package locally, first ensure you have run `pnpm install` from the root of the mono-repo.\nNext, to build the code, run `npm run build` from the root of the mono-repo, or use [fluid-build](https://github.com/microsoft/FluidFramework/tree/main/build-tools/packages/build-tools#running-fluid-build-command-line) via `fluid-build -t build`.\n\n- Note: Once you have run a build from the root, assuming no other changes outside of this package, you may run `npm run build` directly within this directory for a faster build.\n If you make changes to any of this package's local dependencies, you will need to run a build again from the root before building again from directly within this package.\n\n### Test\n\nTo run the tests, first ensure you have followed the [build](#build) steps above.\nNext, run `npm run test` from a terminal within this directory.\n\n\n\n\n\n\n\n## API Documentation\n\nAPI documentation for **@fluid-experimental/devtools-core** is available at .\n\n\n\n\n\n\n\n\n\n\n## Contribution Guidelines\n\nThere are many ways to [contribute](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md) to Fluid.\n\n- Participate in Q&A in our [GitHub Discussions](https://github.com/microsoft/FluidFramework/discussions).\n- [Submit bugs](https://github.com/microsoft/FluidFramework/issues) and help us verify fixes as they are checked in.\n- Review the [source code changes](https://github.com/microsoft/FluidFramework/pulls).\n- [Contribute bug fixes](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md).\n\nDetailed instructions for working in the repo can be found in the [Wiki](https://github.com/microsoft/FluidFramework/wiki).\n\nThis project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).\nFor more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\nUse of these trademarks or logos must follow Microsoft’s [Trademark & Brand Guidelines](https://www.microsoft.com/trademarks).\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n\n\n\n## Help\n\nNot finding what you're looking for in this README? Check out our [GitHub\nWiki](https://github.com/microsoft/FluidFramework/wiki) or [fluidframework.com](https://fluidframework.com/docs/).\n\nStill not finding what you're looking for? Please [file an\nissue](https://github.com/microsoft/FluidFramework/wiki/Submitting-Bugs-and-Feature-Requests).\n\nThank you!\n\n\n\n\n\n\n\n\n\n\n## Trademark\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\n\nUse of these trademarks or logos must follow Microsoft's [Trademark & Brand\nGuidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general).\n\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n[initialize-devtools-docs]: https://fluidframework.com/docs/apis/devtools-core#initializedevtools-function\n[devtools-logger-docs]: https://fluidframework.com/docs/apis/devtools-core/devtoolslogger-class\n[devtools-package]: https://www.npmjs.com/package/@fluid-experimental/devtools\n[browser-extension]: https://github.com/microsoft/FluidFramework/tree/main/packages/tools/devtools/devtools-browser-extension\n","scripts":{"tsc":"tsc","lint":"npm run prettier && npm run eslint","test":"npm run test:mocha","build":"fluid-build . --task build","clean":"rimraf --glob \"_api-extractor-temp\" \"nyc\" \"dist\" \"lib\" \"*.tsbuildinfo\" \"*.build.log\"","eslint":"eslint src","format":"npm run prettier:fix","rebuild":"npm run clean && npm run build","lint:fix":"npm run prettier:fix && npm run eslint:fix","prettier":"prettier --check . --ignore-path ../../../../.prettierignore","build:docs":"api-extractor run --local && copyfiles -u 1 ./_api-extractor-temp/doc-models/* ../../../../_api-extractor-temp/","eslint:fix":"eslint src --fix","test:mocha":"mocha dist/**/*.test.js --unhandled-rejections=strict --exit","build:esnext":"tsc --project ./tsconfig.esnext.json","build:genver":"gen-version","prettier:fix":"prettier --write . --ignore-path ../../../../.prettierignore","build:compile":"fluid-build . --task compile","ci:build:docs":"api-extractor run && copyfiles -u 1 ./_api-extractor-temp/doc-models/* ../../../../_api-extractor-temp/","test:coverage":"npm run test:mocha:coverage","typetests:gen":"fluid-type-test-generator","build:commonjs":"fluid-build . --task commonjs","format-and-build":"npm run format && npm run build","typetests:prepare":"flub typetests --dir . --reset --previous --normalize","format-and-compile":"npm run format && npm run build:compile","test:mocha:coverage":"nyc npm run test:mocha -- --reporter xunit --reporter-option output=nyc/junit-report.xml","test:mocha:multireport":"cross-env FLUID_TEST_MULTIREPORT=1 npm run test:mocha"},"_npmUser":{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},"_resolved":"/mnt/vss/_work/1/pack/scoped/fluid-experimental-devtools-core-2.0.0-internal.6.0.0.tgz","_integrity":"sha512-Mk1UTKqZmeHvqpYQkgoTL1czv8BVnZWvHWFIAEiE7tejTWAHWCj+HBTAP4F7pjqy8Jf3jypO5TZCooRBliRS4g==","fluidBuild":{"tasks":{"tsc":["...","typetests:gen"]}},"repository":{"url":"git+https://github.com/microsoft/FluidFramework.git","type":"git","directory":"packages/tools/devtools/devtools-core"},"_npmVersion":"8.11.0","description":"Fluid Framework developer tools core functionality","directories":{},"sideEffects":false,"_nodeVersion":"16.16.0","dependencies":{"@fluidframework/map":">=2.0.0-internal.6.0.0 <2.0.0-internal.6.1.0","@fluidframework/cell":">=2.0.0-internal.6.0.0 <2.0.0-internal.6.1.0","@fluidframework/matrix":">=2.0.0-internal.6.0.0 <2.0.0-internal.6.1.0","@fluidframework/counter":">=2.0.0-internal.6.0.0 <2.0.0-internal.6.1.0","@fluidframework/sequence":">=2.0.0-internal.6.0.0 <2.0.0-internal.6.1.0","@fluid-experimental/tree2":">=2.0.0-internal.6.0.0 <2.0.0-internal.6.1.0","@fluidframework/common-utils":"^1.1.1","@fluidframework/container-utils":">=2.0.0-internal.6.0.0 <2.0.0-internal.6.1.0","@fluidframework/core-interfaces":">=2.0.0-internal.6.0.0 <2.0.0-internal.6.1.0","@fluidframework/container-loader":">=2.0.0-internal.6.0.0 <2.0.0-internal.6.1.0","@fluidframework/common-definitions":"^0.20.1","@fluidframework/shared-object-base":">=2.0.0-internal.6.0.0 <2.0.0-internal.6.1.0","@fluidframework/protocol-definitions":"^1.1.0","@fluidframework/container-definitions":">=2.0.0-internal.6.0.0 <2.0.0-internal.6.1.0","@fluidframework/datastore-definitions":">=2.0.0-internal.6.0.0 <2.0.0-internal.6.1.0"},"_hasShrinkwrap":false,"readmeFilename":"README.md","typeValidation":{"broken":{"ClassDeclaration_DevtoolsLogger":{"backCompat":false},"InterfaceDeclaration_FluidDevtoolsProps":{"backCompat":false},"EnumDeclaration_ContainerDevtoolsFeature":{"backCompat":false},"InterfaceDeclaration_ContainerDevtoolsProps":{"backCompat":false},"RemovedTypeAliasDeclaration_VisualizeChildData":{"backCompat":false,"forwardCompat":false},"RemovedTypeAliasDeclaration_VisualizeSharedObject":{"backCompat":false,"forwardCompat":false}}},"devDependencies":{"nyc":"^15.1.0","chai":"^4.2.0","mocha":"^10.2.0","eslint":"~8.6.0","events":"^3.1.0","moment":"^2.21.0","rimraf":"^4.4.0","prettier":"~2.6.2","copyfiles":"^2.4.1","cross-env":"^7.0.3","typescript":"~4.5.5","@types/chai":"^4.0.0","@types/mocha":"^9.1.1","concurrently":"^7.6.0","@types/events":"^3.0.0","mocha-multi-reporters":"^1.5.1","@fluid-tools/build-cli":"^0.21.0","eslint-config-prettier":"~8.5.0","@microsoft/api-extractor":"^7.34.4","eslint-plugin-chai-expect":"~3.0.0","mocha-json-output-reporter":"^2.0.1","@fluidframework/build-tools":"^0.21.0","@fluidframework/build-common":"^2.0.0","@fluidframework/telemetry-utils":">=2.0.0-internal.6.0.0 <2.0.0-internal.6.1.0","@fluidframework/mocha-test-setup":">=2.0.0-internal.6.0.0 <2.0.0-internal.6.1.0","@fluidframework/driver-definitions":">=2.0.0-internal.6.0.0 <2.0.0-internal.6.1.0","@fluidframework/test-runtime-utils":">=2.0.0-internal.6.0.0 <2.0.0-internal.6.1.0","@fluidframework/eslint-config-fluid":"^2.0.0","@fluid-experimental/devtools-core-previous":"npm:@fluid-experimental/devtools-core@2.0.0-internal.5.2.0"},"_npmOperationalInternal":{"tmp":"tmp/devtools-core_2.0.0-internal.6.0.0_1691101905785_0.22605874319836206","host":"s3://npm-registry-packages"}},"2.0.0-internal.5.3.4":{"name":"@fluid-experimental/devtools-core","version":"2.0.0-internal.5.3.4","author":{"name":"Microsoft and contributors"},"license":"MIT","_id":"@fluid-experimental/devtools-core@2.0.0-internal.5.3.4","maintainers":[{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},{"name":"curtisman","email":"curtism@microsoft.com"}],"homepage":"https://fluidframework.com","bugs":{"url":"https://github.com/microsoft/FluidFramework/issues"},"nyc":{"all":true,"exclude":["src/test/**/*.ts","dist/test/**/*.js"],"include":["src/**/*.ts","dist/**/*.js"],"reporter":["cobertura","html","text"],"cache-dir":"nyc/.cache","report-dir":"nyc/report","temp-directory":"nyc/.nyc_output","exclude-after-remap":false},"dist":{"shasum":"fef63d86ca64cd5ee124d9445a2ae77f85f52054","tarball":"https://registry.npmjs.org/@fluid-experimental/devtools-core/-/devtools-core-2.0.0-internal.5.3.4.tgz","fileCount":465,"integrity":"sha512-y7ab9+5XoREguyRM2cX4G3qUQ2JZKuqF+hfP/Q8NwO343sXgnz3G+pIL2nuG/XHM/qfKgJNpUY1qgV6Ln0sTjw==","signatures":[{"sig":"MEUCIQDlWOp8MDA+UOlTkCJ9IPa/saeVYoiCx4oLK1kQZjcK0AIgAiZV7+TkgAfLZNJkkJis922ZNEeB/cg/FhT36aRRPiE=","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}],"unpackedSize":1284837},"main":"dist/index.js","_from":"file:fluid-experimental-devtools-core-2.0.0-internal.5.3.4.tgz","types":"dist/index.d.ts","readme":"# @fluid-experimental/devtools-core\n\nThis library contains developer tools for use alongside the Fluid Framework.\nIt is used to power our associated [browser extension][browser-extension].\n\n- Chrome: \n- Edge: \n\n\n\n\n\n\n## Installation\n\nTo get started, install the package by running the following command:\n\n```bash\nnpm i @fluid-experimental/devtools-core -D\n```\n\n\n\n\n\n## Usage\n\nThe Devtools' API surface is designed to fit nicely into most application flows.\n\n### Initialization\n\nTo initialize a devtools session for your container, call [`initializeDevtools`][initialize-devtools-docs].\nThis function accepts a `DevtoolsLogger` for receiving Fluid telemetry from your application, a list of initial Fluid\n`Containers` to associate with the session, and (optionally) customized data visualization configurations for visualizing\n`Container` data.\n\n#### About the [`DevtoolsLogger`][devtools-logger-docs]\n\nThe `DevtoolsLogger` is an optional piece when calling `initializeDevtools` but it is strongly recommended that you use\nit because several features in Fluid Devtools are powered by the telemetry that Fluid Framework generates, and this\nlogger is the way in which that telemetry gets into Fluid Devtools.\n\nYou can obtain a `DevtoolsLogger` by calling its constructor, and then should pass it to `initializeDevtools` _and_\nto the `Loader` instance you'll use to create/load Containers as shown below.\nThis way the logger will receive all the telemetry generated by Fluid Framework in your application, and forward it to\nFluid Devtools as necessary.\n\n```typescript\nimport { DevtoolsLogger, initializeDevtools } from \"@fluid-experimental/devtools-core\";\n\n// Instantiate the logger\nconst devtoolsLogger = new DevtoolsLogger();\n\n// Pass the logger when instantiating the Loader\nconst loader = new Loader({\n\tlogger: devtoolsLogger,\n\t// Other necessary properties ...\n});\n\n// Use the Loader to create (and optionally, attach) a Container\nconst container = await loader.createDetachedContainer(/* params */);\nawait container.attach(/* params */);\n\n// Initialize the Devtools passing the logger and your Container.\n// The Container could be added later as well with devtools.registerContainerDevtools().\nconst devtools = initializeDevtools({\n\tlogger: devtoolsLogger,\n\tinitialContainers: [\n\t\t{\n\t\t\tcontainer,\n\t\t\tcontainerKey: \"My Container\",\n\t\t},\n\t],\n});\n```\n\nIf you're working with `AzureClient` instead of lower-level APIs like the one described above, you probably want to\nrefer to the [@fluid-experimental/devtools package][devtools-package] instead of this one.\n\nDuring local development the recommendation is that your application should receive the `DevtoolsLogger` instance _instead_\nof any logger it would normally receive when deployed to a real environment, to avoid local development activity from\nmixing with real telemetry.\nIf you still want to provide a real application logger and use the Fluid Devtools features that are powered by telemetry\nat the same time, you can pass an existing logger to the `DevtoolsLogger` constructor and it will forward all telemetry\nit receives to that logger as well:\n\n```typescript\nimport { DevtoolsLogger } from \"@fluid-experimental/devtools-core\";\n\n// Your application's logger\nconst yourApplicationLogger = getInstanceOfYourApplicationLogger();\n\nconst devtoolsLogger = new DevtoolsLogger(yourApplicationLogger);\n\n// Pass devtoolsLogger to initializeDevtools() and to your application as described above\n```\n\n### Clean-up\n\nThe Devtools object is managed as a global singleton.\nThat singleton is automatically cleaned up prior to the Window's \"unload\" event.\nSo typical application flows likely won't need to worry about cleanup.\nThat said, if you wish to have tighter control over when the Devtools are torn down, you can simply call the `dispose` method on the handle returned by [initialization](#initialization).\n\n## Contributing to the package\n\n### Build\n\nTo build the package locally, first ensure you have run `pnpm install` from the root of the mono-repo.\nNext, to build the code, run `npm run build` from the root of the mono-repo, or use [fluid-build](https://github.com/microsoft/FluidFramework/tree/main/build-tools/packages/build-tools#running-fluid-build-command-line) via `fluid-build -t build`.\n\n- Note: Once you have run a build from the root, assuming no other changes outside of this package, you may run `npm run build` directly within this directory for a faster build.\n If you make changes to any of this package's local dependencies, you will need to run a build again from the root before building again from directly within this package.\n\n### Test\n\nTo run the tests, first ensure you have followed the [build](#build) steps above.\nNext, run `npm run test` from a terminal within this directory.\n\n\n\n\n\n\n\n## API Documentation\n\nAPI documentation for **@fluid-experimental/devtools-core** is available at .\n\n\n\n\n\n\n\n\n\n\n## Contribution Guidelines\n\nThere are many ways to [contribute](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md) to Fluid.\n\n- Participate in Q&A in our [GitHub Discussions](https://github.com/microsoft/FluidFramework/discussions).\n- [Submit bugs](https://github.com/microsoft/FluidFramework/issues) and help us verify fixes as they are checked in.\n- Review the [source code changes](https://github.com/microsoft/FluidFramework/pulls).\n- [Contribute bug fixes](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md).\n\nDetailed instructions for working in the repo can be found in the [Wiki](https://github.com/microsoft/FluidFramework/wiki).\n\nThis project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).\nFor more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\nUse of these trademarks or logos must follow Microsoft’s [Trademark & Brand Guidelines](https://www.microsoft.com/trademarks).\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n\n\n\n## Help\n\nNot finding what you're looking for in this README? Check out our [GitHub\nWiki](https://github.com/microsoft/FluidFramework/wiki) or [fluidframework.com](https://fluidframework.com/docs/).\n\nStill not finding what you're looking for? Please [file an\nissue](https://github.com/microsoft/FluidFramework/wiki/Submitting-Bugs-and-Feature-Requests).\n\nThank you!\n\n\n\n\n\n\n\n\n\n\n## Trademark\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\n\nUse of these trademarks or logos must follow Microsoft's [Trademark & Brand\nGuidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general).\n\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n[initialize-devtools-docs]: https://fluidframework.com/docs/apis/devtools-core#initializedevtools-function\n[devtools-logger-docs]: https://fluidframework.com/docs/apis/devtools-core/devtoolslogger-class\n[devtools-package]: https://www.npmjs.com/package/@fluid-experimental/devtools\n[browser-extension]: https://github.com/microsoft/FluidFramework/tree/main/packages/tools/devtools/devtools-browser-extension\n","scripts":{"tsc":"tsc","lint":"npm run prettier && npm run eslint","test":"npm run test:mocha","build":"fluid-build . --task build","clean":"rimraf _api-extractor-temp nyc dist lib *.tsbuildinfo *.build.log","eslint":"eslint src","format":"npm run prettier:fix","rebuild":"npm run clean && npm run build","lint:fix":"npm run prettier:fix && npm run eslint:fix","prettier":"prettier --check . --ignore-path ../../../../.prettierignore","build:docs":"api-extractor run --local && copyfiles -u 1 ./_api-extractor-temp/doc-models/* ../../../../_api-extractor-temp/","eslint:fix":"eslint src --fix","test:mocha":"mocha dist/**/*.test.js --unhandled-rejections=strict --exit","build:esnext":"tsc --project ./tsconfig.esnext.json","prettier:fix":"prettier --write . --ignore-path ../../../../.prettierignore","build:compile":"fluid-build . --task compile","ci:build:docs":"api-extractor run && copyfiles -u 1 ./_api-extractor-temp/doc-models/* ../../../../_api-extractor-temp/","test:coverage":"npm run test:mocha:coverage","typetests:gen":"fluid-type-test-generator","build:commonjs":"fluid-build . --task commonjs","format-and-build":"npm run format && npm run build","typetests:prepare":"flub typetests --dir . --reset --previous --normalize","format-and-compile":"npm run format && npm run build:compile","test:mocha:coverage":"nyc npm run test:mocha -- --reporter xunit --reporter-option output=nyc/junit-report.xml","test:mocha:multireport":"cross-env FLUID_TEST_MULTIREPORT=1 npm run test:mocha"},"_npmUser":{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},"_resolved":"/mnt/vss/_work/1/pack/scoped/fluid-experimental-devtools-core-2.0.0-internal.5.3.4.tgz","_integrity":"sha512-y7ab9+5XoREguyRM2cX4G3qUQ2JZKuqF+hfP/Q8NwO343sXgnz3G+pIL2nuG/XHM/qfKgJNpUY1qgV6Ln0sTjw==","fluidBuild":{"tasks":{"tsc":["...","typetests:gen"]}},"repository":{"url":"git+https://github.com/microsoft/FluidFramework.git","type":"git","directory":"packages/tools/devtools/devtools-core"},"_npmVersion":"8.19.4","description":"Fluid Framework developer tools core functionality","directories":{},"sideEffects":false,"_nodeVersion":"16.20.1","dependencies":{"@fluidframework/map":">=2.0.0-internal.5.3.4 <2.0.0-internal.5.4.0","@fluidframework/cell":">=2.0.0-internal.5.3.4 <2.0.0-internal.5.4.0","@fluidframework/matrix":">=2.0.0-internal.5.3.4 <2.0.0-internal.5.4.0","@fluidframework/counter":">=2.0.0-internal.5.3.4 <2.0.0-internal.5.4.0","@fluidframework/sequence":">=2.0.0-internal.5.3.4 <2.0.0-internal.5.4.0","@fluid-experimental/tree2":">=2.0.0-internal.5.3.4 <2.0.0-internal.5.4.0","@fluidframework/common-utils":"^1.1.1","@fluidframework/container-utils":">=2.0.0-internal.5.3.4 <2.0.0-internal.5.4.0","@fluidframework/core-interfaces":">=2.0.0-internal.5.3.4 <2.0.0-internal.5.4.0","@fluidframework/telemetry-utils":">=2.0.0-internal.5.3.4 <2.0.0-internal.5.4.0","@fluidframework/container-loader":">=2.0.0-internal.5.3.4 <2.0.0-internal.5.4.0","@fluidframework/common-definitions":"^0.20.1","@fluidframework/shared-object-base":">=2.0.0-internal.5.3.4 <2.0.0-internal.5.4.0","@fluidframework/protocol-definitions":"^1.1.0","@fluidframework/container-definitions":">=2.0.0-internal.5.3.4 <2.0.0-internal.5.4.0"},"_hasShrinkwrap":false,"readmeFilename":"README.md","typeValidation":{"broken":{}},"devDependencies":{"nyc":"^15.1.0","chai":"^4.2.0","mocha":"^10.2.0","eslint":"~8.6.0","events":"^3.1.0","moment":"^2.21.0","rimraf":"^4.4.0","prettier":"~2.6.2","copyfiles":"^2.4.1","cross-env":"^7.0.3","typescript":"~4.5.5","@types/chai":"^4.0.0","@types/mocha":"^9.1.1","concurrently":"^7.6.0","@types/events":"^3.0.0","mocha-multi-reporters":"^1.5.1","@fluid-tools/build-cli":"^0.21.0","eslint-config-prettier":"~8.5.0","@microsoft/api-extractor":"^7.34.4","eslint-plugin-chai-expect":"~3.0.0","mocha-json-output-reporter":"^2.0.1","@fluidframework/build-tools":"^0.21.0","@fluidframework/build-common":"^1.2.0","@fluidframework/mocha-test-setup":">=2.0.0-internal.5.3.4 <2.0.0-internal.5.4.0","@fluidframework/driver-definitions":">=2.0.0-internal.5.3.4 <2.0.0-internal.5.4.0","@fluidframework/test-runtime-utils":">=2.0.0-internal.5.3.4 <2.0.0-internal.5.4.0","@fluidframework/eslint-config-fluid":"^2.0.0","@fluid-experimental/devtools-core-previous":"npm:@fluid-experimental/devtools-core@2.0.0-internal.5.2.0"},"_npmOperationalInternal":{"tmp":"tmp/devtools-core_2.0.0-internal.5.3.4_1691440016487_0.11316127283639377","host":"s3://npm-registry-packages"}},"2.0.0-internal.6.1.0":{"name":"@fluid-experimental/devtools-core","version":"2.0.0-internal.6.1.0","author":{"name":"Microsoft and contributors"},"license":"MIT","_id":"@fluid-experimental/devtools-core@2.0.0-internal.6.1.0","maintainers":[{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},{"name":"curtisman","email":"curtism@microsoft.com"}],"homepage":"https://fluidframework.com","bugs":{"url":"https://github.com/microsoft/FluidFramework/issues"},"nyc":{"all":true,"exclude":["src/test/**/*.ts","dist/test/**/*.js"],"include":["src/**/*.ts","dist/**/*.js"],"reporter":["cobertura","html","text"],"cache-dir":"nyc/.cache","report-dir":"nyc/report","temp-directory":"nyc/.nyc_output","exclude-after-remap":false},"dist":{"shasum":"56ab5563fb1d0f18b3ed5bd54c505da8b74d5c1e","tarball":"https://registry.npmjs.org/@fluid-experimental/devtools-core/-/devtools-core-2.0.0-internal.6.1.0.tgz","fileCount":501,"integrity":"sha512-FBNncOzBerYI1j1pC+4uLLxXX8aDPUxZD1JhUe/zEgkHNfBF8XjA0OhIlDQABJ29kHlRihfLyBRe+Dt4vvQhJw==","signatures":[{"sig":"MEYCIQD7eXF6O19Jt6h0kwqYycq149VgwRVIVOjLEaP6gTpsKAIhAIj2qaEyXdQ8VYhQ/goRyyFe9VDTAW2P1ygCqz2HSFZg","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}],"unpackedSize":1364941},"main":"dist/index.js","_from":"file:fluid-experimental-devtools-core-2.0.0-internal.6.1.0.tgz","types":"dist/index.d.ts","readme":"# @fluid-experimental/devtools-core\n\nThis library contains developer tools for use alongside the Fluid Framework.\nIt is used to power our associated [browser extension][browser-extension].\n\n- Chrome: \n- Edge: \n\n\n\n\n\n\n## Installation\n\nTo get started, install the package by running the following command:\n\n```bash\nnpm i @fluid-experimental/devtools-core -D\n```\n\n\n\n\n\n## Usage\n\nThe Devtools' API surface is designed to fit nicely into most application flows.\n\n### Initialization\n\nTo initialize a devtools session for your container, call [`initializeDevtools`][initialize-devtools-docs].\nThis function accepts a `DevtoolsLogger` for receiving Fluid telemetry from your application, a list of initial Fluid\n`Containers` to associate with the session, and (optionally) customized data visualization configurations for visualizing\n`Container` data.\n\n#### About the [`DevtoolsLogger`][devtools-logger-docs]\n\nThe `DevtoolsLogger` is an optional piece when calling `initializeDevtools` but it is strongly recommended that you use\nit because several features in Fluid Devtools are powered by the telemetry that Fluid Framework generates, and this\nlogger is the way in which that telemetry gets into Fluid Devtools.\n\nYou can obtain a `DevtoolsLogger` by calling its constructor, and then should pass it to `initializeDevtools` _and_\nto the `Loader` instance you'll use to create/load Containers as shown below.\nThis way the logger will receive all the telemetry generated by Fluid Framework in your application, and forward it to\nFluid Devtools as necessary.\n\n```typescript\nimport { DevtoolsLogger, initializeDevtools } from \"@fluid-experimental/devtools-core\";\n\n// Instantiate the logger\nconst devtoolsLogger = new DevtoolsLogger();\n\n// Pass the logger when instantiating the Loader\nconst loader = new Loader({\n\tlogger: devtoolsLogger,\n\t// Other necessary properties ...\n});\n\n// Use the Loader to create (and optionally, attach) a Container\nconst container = await loader.createDetachedContainer(/* params */);\nawait container.attach(/* params */);\n\n// Initialize the Devtools passing the logger and your Container.\n// The Container could be added later as well with devtools.registerContainerDevtools().\nconst devtools = initializeDevtools({\n\tlogger: devtoolsLogger,\n\tinitialContainers: [\n\t\t{\n\t\t\tcontainer,\n\t\t\tcontainerKey: \"My Container\",\n\t\t},\n\t],\n});\n```\n\nIf you're working with `AzureClient` instead of lower-level APIs like the one described above, you probably want to\nrefer to the [@fluid-experimental/devtools package][devtools-package] instead of this one.\n\nDuring local development the recommendation is that your application should receive the `DevtoolsLogger` instance _instead_\nof any logger it would normally receive when deployed to a real environment, to avoid local development activity from\nmixing with real telemetry.\nIf you still want to provide a real application logger and use the Fluid Devtools features that are powered by telemetry\nat the same time, you can pass an existing logger to the `DevtoolsLogger` constructor and it will forward all telemetry\nit receives to that logger as well:\n\n```typescript\nimport { DevtoolsLogger } from \"@fluid-experimental/devtools-core\";\n\n// Your application's logger\nconst yourApplicationLogger = getInstanceOfYourApplicationLogger();\n\nconst devtoolsLogger = new DevtoolsLogger(yourApplicationLogger);\n\n// Pass devtoolsLogger to initializeDevtools() and to your application as described above\n```\n\n### Clean-up\n\nThe Devtools object is managed as a global singleton.\nThat singleton is automatically cleaned up prior to the Window's \"unload\" event.\nSo typical application flows likely won't need to worry about cleanup.\nThat said, if you wish to have tighter control over when the Devtools are torn down, you can simply call the `dispose` method on the handle returned by [initialization](#initialization).\n\n## Contributing to the package\n\n### Build\n\nTo build the package locally, first ensure you have run `pnpm install` from the root of the mono-repo.\nNext, to build the code, run `npm run build` from the root of the mono-repo, or use [fluid-build](https://github.com/microsoft/FluidFramework/tree/main/build-tools/packages/build-tools#running-fluid-build-command-line) via `fluid-build -t build`.\n\n- Note: Once you have run a build from the root, assuming no other changes outside of this package, you may run `npm run build` directly within this directory for a faster build.\n If you make changes to any of this package's local dependencies, you will need to run a build again from the root before building again from directly within this package.\n\n### Test\n\nTo run the tests, first ensure you have followed the [build](#build) steps above.\nNext, run `npm run test` from a terminal within this directory.\n\n\n\n\n\n\n\n## API Documentation\n\nAPI documentation for **@fluid-experimental/devtools-core** is available at .\n\n\n\n\n\n\n\n\n\n\n## Contribution Guidelines\n\nThere are many ways to [contribute](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md) to Fluid.\n\n- Participate in Q&A in our [GitHub Discussions](https://github.com/microsoft/FluidFramework/discussions).\n- [Submit bugs](https://github.com/microsoft/FluidFramework/issues) and help us verify fixes as they are checked in.\n- Review the [source code changes](https://github.com/microsoft/FluidFramework/pulls).\n- [Contribute bug fixes](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md).\n\nDetailed instructions for working in the repo can be found in the [Wiki](https://github.com/microsoft/FluidFramework/wiki).\n\nThis project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).\nFor more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\nUse of these trademarks or logos must follow Microsoft’s [Trademark & Brand Guidelines](https://www.microsoft.com/trademarks).\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n\n\n\n## Help\n\nNot finding what you're looking for in this README? Check out our [GitHub\nWiki](https://github.com/microsoft/FluidFramework/wiki) or [fluidframework.com](https://fluidframework.com/docs/).\n\nStill not finding what you're looking for? Please [file an\nissue](https://github.com/microsoft/FluidFramework/wiki/Submitting-Bugs-and-Feature-Requests).\n\nThank you!\n\n\n\n\n\n\n\n\n\n\n## Trademark\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\n\nUse of these trademarks or logos must follow Microsoft's [Trademark & Brand\nGuidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general).\n\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n[initialize-devtools-docs]: https://fluidframework.com/docs/apis/devtools-core#initializedevtools-function\n[devtools-logger-docs]: https://fluidframework.com/docs/apis/devtools-core/devtoolslogger-class\n[devtools-package]: https://www.npmjs.com/package/@fluid-experimental/devtools\n[browser-extension]: https://github.com/microsoft/FluidFramework/tree/main/packages/tools/devtools/devtools-browser-extension\n","scripts":{"tsc":"tsc","lint":"npm run prettier && npm run eslint","test":"npm run test:mocha","build":"fluid-build . --task build","clean":"rimraf --glob \"_api-extractor-temp\" \"nyc\" \"dist\" \"lib\" \"*.tsbuildinfo\" \"*.build.log\"","eslint":"eslint src","format":"npm run prettier:fix","rebuild":"npm run clean && npm run build","lint:fix":"npm run prettier:fix && npm run eslint:fix","prettier":"prettier --check . --ignore-path ../../../../.prettierignore","build:docs":"api-extractor run --local && copyfiles -u 1 ./_api-extractor-temp/doc-models/* ../../../../_api-extractor-temp/","eslint:fix":"eslint src --fix","test:mocha":"mocha dist/**/*.test.js --unhandled-rejections=strict --exit","build:esnext":"tsc --project ./tsconfig.esnext.json","build:genver":"gen-version","prettier:fix":"prettier --write . --ignore-path ../../../../.prettierignore","build:compile":"fluid-build . --task compile","ci:build:docs":"api-extractor run && copyfiles -u 1 ./_api-extractor-temp/doc-models/* ../../../../_api-extractor-temp/","test:coverage":"npm run test:mocha:coverage","typetests:gen":"fluid-type-test-generator","build:commonjs":"fluid-build . --task commonjs","format-and-build":"npm run format && npm run build","typetests:prepare":"flub typetests --dir . --reset --previous --normalize","format-and-compile":"npm run format && npm run build:compile","test:mocha:coverage":"nyc npm run test:mocha -- --reporter xunit --reporter-option output=nyc/junit-report.xml","test:mocha:multireport":"cross-env FLUID_TEST_MULTIREPORT=1 npm run test:mocha"},"_npmUser":{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},"_resolved":"/mnt/vss/_work/1/pack/scoped/fluid-experimental-devtools-core-2.0.0-internal.6.1.0.tgz","_integrity":"sha512-FBNncOzBerYI1j1pC+4uLLxXX8aDPUxZD1JhUe/zEgkHNfBF8XjA0OhIlDQABJ29kHlRihfLyBRe+Dt4vvQhJw==","fluidBuild":{"tasks":{"tsc":["...","typetests:gen"]}},"repository":{"url":"git+https://github.com/microsoft/FluidFramework.git","type":"git","directory":"packages/tools/devtools/devtools-core"},"_npmVersion":"8.11.0","description":"Fluid Framework developer tools core functionality","directories":{},"sideEffects":false,"_nodeVersion":"16.16.0","dependencies":{"@fluidframework/map":">=2.0.0-internal.6.1.0 <2.0.0-internal.6.2.0","@fluidframework/cell":">=2.0.0-internal.6.1.0 <2.0.0-internal.6.2.0","@fluidframework/matrix":">=2.0.0-internal.6.1.0 <2.0.0-internal.6.2.0","@fluidframework/counter":">=2.0.0-internal.6.1.0 <2.0.0-internal.6.2.0","@fluidframework/sequence":">=2.0.0-internal.6.1.0 <2.0.0-internal.6.2.0","@fluid-experimental/tree2":">=2.0.0-internal.6.1.0 <2.0.0-internal.6.2.0","@fluidframework/common-utils":"^1.1.1","@fluidframework/container-utils":">=2.0.0-internal.6.1.0 <2.0.0-internal.6.2.0","@fluidframework/core-interfaces":">=2.0.0-internal.6.1.0 <2.0.0-internal.6.2.0","@fluidframework/container-loader":">=2.0.0-internal.6.1.0 <2.0.0-internal.6.2.0","@fluidframework/common-definitions":"^0.20.1","@fluidframework/shared-object-base":">=2.0.0-internal.6.1.0 <2.0.0-internal.6.2.0","@fluidframework/protocol-definitions":"^1.1.0","@fluidframework/container-definitions":">=2.0.0-internal.6.1.0 <2.0.0-internal.6.2.0","@fluidframework/datastore-definitions":">=2.0.0-internal.6.1.0 <2.0.0-internal.6.2.0"},"_hasShrinkwrap":false,"readmeFilename":"README.md","typeValidation":{"broken":{"EnumDeclaration_EditType":{"backCompat":false},"InterfaceDeclaration_Edit":{"backCompat":false},"EnumDeclaration_DevtoolsFeature":{"backCompat":false,"forwardCompat":false},"RemovedEnumDeclaration_EditType":{"backCompat":false,"forwardCompat":false},"TypeAliasDeclaration_VisualNode":{"backCompat":false},"InterfaceDeclaration_TreeNodeBase":{"backCompat":false},"InterfaceDeclaration_ValueNodeBase":{"backCompat":false},"InterfaceDeclaration_VisualNodeBase":{"backCompat":false},"InterfaceDeclaration_VisualTreeNode":{"backCompat":false},"TypeAliasDeclaration_RootHandleNode":{"backCompat":false},"InterfaceDeclaration_FluidHandleNode":{"backCompat":false},"InterfaceDeclaration_VisualValueNode":{"backCompat":false},"TypeAliasDeclaration_FluidObjectNode":{"backCompat":false},"TypeAliasDeclaration_VisualChildNode":{"backCompat":false},"InterfaceDeclaration_UnknownObjectNode":{"backCompat":false},"RemovedEnumDeclaration_DevtoolsFeature":{"backCompat":false,"forwardCompat":false},"EnumDeclaration_ContainerDevtoolsFeature":{"backCompat":false,"forwardCompat":false},"InterfaceDeclaration_FluidObjectNodeBase":{"backCompat":false},"InterfaceDeclaration_FluidObjectTreeNode":{"backCompat":false},"InterfaceDeclaration_FluidObjectValueNode":{"backCompat":false},"InterfaceDeclaration_FluidUnknownObjectNode":{"backCompat":false},"RemovedEnumDeclaration_ContainerDevtoolsFeature":{"backCompat":false,"forwardCompat":false}}},"devDependencies":{"nyc":"^15.1.0","chai":"^4.2.0","mocha":"^10.2.0","eslint":"~8.6.0","events":"^3.1.0","moment":"^2.21.0","rimraf":"^4.4.0","prettier":"~2.6.2","copyfiles":"^2.4.1","cross-env":"^7.0.3","typescript":"~4.5.5","@types/chai":"^4.0.0","@types/mocha":"^9.1.1","concurrently":"^7.6.0","@types/events":"^3.0.0","mocha-multi-reporters":"^1.5.1","@fluid-tools/build-cli":"^0.22.0","eslint-config-prettier":"~8.5.0","@microsoft/api-extractor":"^7.34.4","eslint-plugin-chai-expect":"~3.0.0","mocha-json-output-reporter":"^2.0.1","@fluidframework/build-tools":"^0.22.0","@fluidframework/build-common":"^2.0.0","@fluidframework/telemetry-utils":">=2.0.0-internal.6.1.0 <2.0.0-internal.6.2.0","@fluidframework/mocha-test-setup":">=2.0.0-internal.6.1.0 <2.0.0-internal.6.2.0","@fluidframework/driver-definitions":">=2.0.0-internal.6.1.0 <2.0.0-internal.6.2.0","@fluidframework/test-runtime-utils":">=2.0.0-internal.6.1.0 <2.0.0-internal.6.2.0","@fluidframework/eslint-config-fluid":"^2.0.0","@fluid-experimental/devtools-core-previous":"npm:@fluid-experimental/devtools-core@2.0.0-internal.6.0.0"},"_npmOperationalInternal":{"tmp":"tmp/devtools-core_2.0.0-internal.6.1.0_1692140773516_0.7164875757377875","host":"s3://npm-registry-packages"}},"2.0.0-internal.6.1.1":{"name":"@fluid-experimental/devtools-core","version":"2.0.0-internal.6.1.1","author":{"name":"Microsoft and contributors"},"license":"MIT","_id":"@fluid-experimental/devtools-core@2.0.0-internal.6.1.1","maintainers":[{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},{"name":"curtisman","email":"curtism@microsoft.com"}],"homepage":"https://fluidframework.com","bugs":{"url":"https://github.com/microsoft/FluidFramework/issues"},"nyc":{"all":true,"exclude":["src/test/**/*.ts","dist/test/**/*.js"],"include":["src/**/*.ts","dist/**/*.js"],"reporter":["cobertura","html","text"],"cache-dir":"nyc/.cache","report-dir":"nyc/report","temp-directory":"nyc/.nyc_output","exclude-after-remap":false},"dist":{"shasum":"d8c962f4f1f64523d55cebfea434a65af01e6a24","tarball":"https://registry.npmjs.org/@fluid-experimental/devtools-core/-/devtools-core-2.0.0-internal.6.1.1.tgz","fileCount":501,"integrity":"sha512-gPffGAtBXlR39fnf4gyQRVD93KfzfyLzXzUkykYAOEyKSwAj9VJ+fnbIPWTAz+rSIVArZL4rDTxL61u5SNKztQ==","signatures":[{"sig":"MEUCIQCsTfX7WsqtxBxrHpi3JsIXcYgE3Apu3BnjvdFIqnQxgAIgciKt1feNpOBTXTiz2z1kJ32YfenGX7S7X96ZOpIelWY=","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}],"unpackedSize":1364941},"main":"dist/index.js","_from":"file:fluid-experimental-devtools-core-2.0.0-internal.6.1.1.tgz","types":"dist/index.d.ts","readme":"# @fluid-experimental/devtools-core\n\nThis library contains developer tools for use alongside the Fluid Framework.\nIt is used to power our associated [browser extension][browser-extension].\n\n- Chrome: \n- Edge: \n\n\n\n\n\n\n## Installation\n\nTo get started, install the package by running the following command:\n\n```bash\nnpm i @fluid-experimental/devtools-core -D\n```\n\n\n\n\n\n## Usage\n\nThe Devtools' API surface is designed to fit nicely into most application flows.\n\n### Initialization\n\nTo initialize a devtools session for your container, call [`initializeDevtools`][initialize-devtools-docs].\nThis function accepts a `DevtoolsLogger` for receiving Fluid telemetry from your application, a list of initial Fluid\n`Containers` to associate with the session, and (optionally) customized data visualization configurations for visualizing\n`Container` data.\n\n#### About the [`DevtoolsLogger`][devtools-logger-docs]\n\nThe `DevtoolsLogger` is an optional piece when calling `initializeDevtools` but it is strongly recommended that you use\nit because several features in Fluid Devtools are powered by the telemetry that Fluid Framework generates, and this\nlogger is the way in which that telemetry gets into Fluid Devtools.\n\nYou can obtain a `DevtoolsLogger` by calling its constructor, and then should pass it to `initializeDevtools` _and_\nto the `Loader` instance you'll use to create/load Containers as shown below.\nThis way the logger will receive all the telemetry generated by Fluid Framework in your application, and forward it to\nFluid Devtools as necessary.\n\n```typescript\nimport { DevtoolsLogger, initializeDevtools } from \"@fluid-experimental/devtools-core\";\n\n// Instantiate the logger\nconst devtoolsLogger = new DevtoolsLogger();\n\n// Pass the logger when instantiating the Loader\nconst loader = new Loader({\n\tlogger: devtoolsLogger,\n\t// Other necessary properties ...\n});\n\n// Use the Loader to create (and optionally, attach) a Container\nconst container = await loader.createDetachedContainer(/* params */);\nawait container.attach(/* params */);\n\n// Initialize the Devtools passing the logger and your Container.\n// The Container could be added later as well with devtools.registerContainerDevtools().\nconst devtools = initializeDevtools({\n\tlogger: devtoolsLogger,\n\tinitialContainers: [\n\t\t{\n\t\t\tcontainer,\n\t\t\tcontainerKey: \"My Container\",\n\t\t},\n\t],\n});\n```\n\nIf you're working with `AzureClient` instead of lower-level APIs like the one described above, you probably want to\nrefer to the [@fluid-experimental/devtools package][devtools-package] instead of this one.\n\nDuring local development the recommendation is that your application should receive the `DevtoolsLogger` instance _instead_\nof any logger it would normally receive when deployed to a real environment, to avoid local development activity from\nmixing with real telemetry.\nIf you still want to provide a real application logger and use the Fluid Devtools features that are powered by telemetry\nat the same time, you can pass an existing logger to the `DevtoolsLogger` constructor and it will forward all telemetry\nit receives to that logger as well:\n\n```typescript\nimport { DevtoolsLogger } from \"@fluid-experimental/devtools-core\";\n\n// Your application's logger\nconst yourApplicationLogger = getInstanceOfYourApplicationLogger();\n\nconst devtoolsLogger = new DevtoolsLogger(yourApplicationLogger);\n\n// Pass devtoolsLogger to initializeDevtools() and to your application as described above\n```\n\n### Clean-up\n\nThe Devtools object is managed as a global singleton.\nThat singleton is automatically cleaned up prior to the Window's \"unload\" event.\nSo typical application flows likely won't need to worry about cleanup.\nThat said, if you wish to have tighter control over when the Devtools are torn down, you can simply call the `dispose` method on the handle returned by [initialization](#initialization).\n\n## Contributing to the package\n\n### Build\n\nTo build the package locally, first ensure you have run `pnpm install` from the root of the mono-repo.\nNext, to build the code, run `npm run build` from the root of the mono-repo, or use [fluid-build](https://github.com/microsoft/FluidFramework/tree/main/build-tools/packages/build-tools#running-fluid-build-command-line) via `fluid-build -t build`.\n\n- Note: Once you have run a build from the root, assuming no other changes outside of this package, you may run `npm run build` directly within this directory for a faster build.\n If you make changes to any of this package's local dependencies, you will need to run a build again from the root before building again from directly within this package.\n\n### Test\n\nTo run the tests, first ensure you have followed the [build](#build) steps above.\nNext, run `npm run test` from a terminal within this directory.\n\n\n\n\n\n\n\n## API Documentation\n\nAPI documentation for **@fluid-experimental/devtools-core** is available at .\n\n\n\n\n\n\n\n\n\n\n## Contribution Guidelines\n\nThere are many ways to [contribute](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md) to Fluid.\n\n- Participate in Q&A in our [GitHub Discussions](https://github.com/microsoft/FluidFramework/discussions).\n- [Submit bugs](https://github.com/microsoft/FluidFramework/issues) and help us verify fixes as they are checked in.\n- Review the [source code changes](https://github.com/microsoft/FluidFramework/pulls).\n- [Contribute bug fixes](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md).\n\nDetailed instructions for working in the repo can be found in the [Wiki](https://github.com/microsoft/FluidFramework/wiki).\n\nThis project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).\nFor more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\nUse of these trademarks or logos must follow Microsoft’s [Trademark & Brand Guidelines](https://www.microsoft.com/trademarks).\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n\n\n\n## Help\n\nNot finding what you're looking for in this README? Check out our [GitHub\nWiki](https://github.com/microsoft/FluidFramework/wiki) or [fluidframework.com](https://fluidframework.com/docs/).\n\nStill not finding what you're looking for? Please [file an\nissue](https://github.com/microsoft/FluidFramework/wiki/Submitting-Bugs-and-Feature-Requests).\n\nThank you!\n\n\n\n\n\n\n\n\n\n\n## Trademark\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\n\nUse of these trademarks or logos must follow Microsoft's [Trademark & Brand\nGuidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general).\n\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n[initialize-devtools-docs]: https://fluidframework.com/docs/apis/devtools-core#initializedevtools-function\n[devtools-logger-docs]: https://fluidframework.com/docs/apis/devtools-core/devtoolslogger-class\n[devtools-package]: https://www.npmjs.com/package/@fluid-experimental/devtools\n[browser-extension]: https://github.com/microsoft/FluidFramework/tree/main/packages/tools/devtools/devtools-browser-extension\n","scripts":{"tsc":"tsc","lint":"npm run prettier && npm run eslint","test":"npm run test:mocha","build":"fluid-build . --task build","clean":"rimraf --glob \"_api-extractor-temp\" \"nyc\" \"dist\" \"lib\" \"*.tsbuildinfo\" \"*.build.log\"","eslint":"eslint src","format":"npm run prettier:fix","rebuild":"npm run clean && npm run build","lint:fix":"npm run prettier:fix && npm run eslint:fix","prettier":"prettier --check . --ignore-path ../../../../.prettierignore","build:docs":"api-extractor run --local && copyfiles -u 1 ./_api-extractor-temp/doc-models/* ../../../../_api-extractor-temp/","eslint:fix":"eslint src --fix","test:mocha":"mocha dist/**/*.test.js --unhandled-rejections=strict --exit","build:esnext":"tsc --project ./tsconfig.esnext.json","build:genver":"gen-version","prettier:fix":"prettier --write . --ignore-path ../../../../.prettierignore","build:compile":"fluid-build . --task compile","ci:build:docs":"api-extractor run && copyfiles -u 1 ./_api-extractor-temp/doc-models/* ../../../../_api-extractor-temp/","test:coverage":"npm run test:mocha:coverage","typetests:gen":"fluid-type-test-generator","build:commonjs":"fluid-build . --task commonjs","format-and-build":"npm run format && npm run build","typetests:prepare":"flub typetests --dir . --reset --previous --normalize","format-and-compile":"npm run format && npm run build:compile","test:mocha:coverage":"nyc npm run test:mocha -- --reporter xunit --reporter-option output=nyc/junit-report.xml","test:mocha:multireport":"cross-env FLUID_TEST_MULTIREPORT=1 npm run test:mocha"},"_npmUser":{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},"_resolved":"/mnt/vss/_work/1/pack/scoped/fluid-experimental-devtools-core-2.0.0-internal.6.1.1.tgz","_integrity":"sha512-gPffGAtBXlR39fnf4gyQRVD93KfzfyLzXzUkykYAOEyKSwAj9VJ+fnbIPWTAz+rSIVArZL4rDTxL61u5SNKztQ==","fluidBuild":{"tasks":{"tsc":["...","typetests:gen"]}},"repository":{"url":"git+https://github.com/microsoft/FluidFramework.git","type":"git","directory":"packages/tools/devtools/devtools-core"},"_npmVersion":"8.11.0","description":"Fluid Framework developer tools core functionality","directories":{},"sideEffects":false,"_nodeVersion":"16.16.0","dependencies":{"@fluidframework/map":">=2.0.0-internal.6.1.1 <2.0.0-internal.6.2.0","@fluidframework/cell":">=2.0.0-internal.6.1.1 <2.0.0-internal.6.2.0","@fluidframework/matrix":">=2.0.0-internal.6.1.1 <2.0.0-internal.6.2.0","@fluidframework/counter":">=2.0.0-internal.6.1.1 <2.0.0-internal.6.2.0","@fluidframework/sequence":">=2.0.0-internal.6.1.1 <2.0.0-internal.6.2.0","@fluid-experimental/tree2":">=2.0.0-internal.6.1.1 <2.0.0-internal.6.2.0","@fluidframework/common-utils":"^1.1.1","@fluidframework/container-utils":">=2.0.0-internal.6.1.1 <2.0.0-internal.6.2.0","@fluidframework/core-interfaces":">=2.0.0-internal.6.1.1 <2.0.0-internal.6.2.0","@fluidframework/container-loader":">=2.0.0-internal.6.1.1 <2.0.0-internal.6.2.0","@fluidframework/common-definitions":"^0.20.1","@fluidframework/shared-object-base":">=2.0.0-internal.6.1.1 <2.0.0-internal.6.2.0","@fluidframework/protocol-definitions":"^1.1.0","@fluidframework/container-definitions":">=2.0.0-internal.6.1.1 <2.0.0-internal.6.2.0","@fluidframework/datastore-definitions":">=2.0.0-internal.6.1.1 <2.0.0-internal.6.2.0"},"_hasShrinkwrap":false,"readmeFilename":"README.md","typeValidation":{"broken":{"EnumDeclaration_EditType":{"backCompat":false},"InterfaceDeclaration_Edit":{"backCompat":false},"EnumDeclaration_DevtoolsFeature":{"backCompat":false,"forwardCompat":false},"RemovedEnumDeclaration_EditType":{"backCompat":false,"forwardCompat":false},"TypeAliasDeclaration_VisualNode":{"backCompat":false},"InterfaceDeclaration_TreeNodeBase":{"backCompat":false},"InterfaceDeclaration_ValueNodeBase":{"backCompat":false},"InterfaceDeclaration_VisualNodeBase":{"backCompat":false},"InterfaceDeclaration_VisualTreeNode":{"backCompat":false},"TypeAliasDeclaration_RootHandleNode":{"backCompat":false},"InterfaceDeclaration_FluidHandleNode":{"backCompat":false},"InterfaceDeclaration_VisualValueNode":{"backCompat":false},"TypeAliasDeclaration_FluidObjectNode":{"backCompat":false},"TypeAliasDeclaration_VisualChildNode":{"backCompat":false},"InterfaceDeclaration_UnknownObjectNode":{"backCompat":false},"RemovedEnumDeclaration_DevtoolsFeature":{"backCompat":false,"forwardCompat":false},"EnumDeclaration_ContainerDevtoolsFeature":{"backCompat":false,"forwardCompat":false},"InterfaceDeclaration_FluidObjectNodeBase":{"backCompat":false},"InterfaceDeclaration_FluidObjectTreeNode":{"backCompat":false},"InterfaceDeclaration_FluidObjectValueNode":{"backCompat":false},"InterfaceDeclaration_FluidUnknownObjectNode":{"backCompat":false},"RemovedEnumDeclaration_ContainerDevtoolsFeature":{"backCompat":false,"forwardCompat":false}}},"devDependencies":{"nyc":"^15.1.0","chai":"^4.2.0","mocha":"^10.2.0","eslint":"~8.6.0","events":"^3.1.0","moment":"^2.21.0","rimraf":"^4.4.0","prettier":"~2.6.2","copyfiles":"^2.4.1","cross-env":"^7.0.3","typescript":"~4.5.5","@types/chai":"^4.0.0","@types/mocha":"^9.1.1","concurrently":"^7.6.0","@types/events":"^3.0.0","mocha-multi-reporters":"^1.5.1","@fluid-tools/build-cli":"^0.22.0","eslint-config-prettier":"~8.5.0","@microsoft/api-extractor":"^7.34.4","eslint-plugin-chai-expect":"~3.0.0","mocha-json-output-reporter":"^2.0.1","@fluidframework/build-tools":"^0.22.0","@fluidframework/build-common":"^2.0.0","@fluidframework/telemetry-utils":">=2.0.0-internal.6.1.1 <2.0.0-internal.6.2.0","@fluidframework/mocha-test-setup":">=2.0.0-internal.6.1.1 <2.0.0-internal.6.2.0","@fluidframework/driver-definitions":">=2.0.0-internal.6.1.1 <2.0.0-internal.6.2.0","@fluidframework/test-runtime-utils":">=2.0.0-internal.6.1.1 <2.0.0-internal.6.2.0","@fluidframework/eslint-config-fluid":"^2.0.0","@fluid-experimental/devtools-core-previous":"npm:@fluid-experimental/devtools-core@2.0.0-internal.6.0.0"},"_npmOperationalInternal":{"tmp":"tmp/devtools-core_2.0.0-internal.6.1.1_1692316388328_0.1932174150679291","host":"s3://npm-registry-packages"}},"2.0.0-internal.5.4.2":{"name":"@fluid-experimental/devtools-core","version":"2.0.0-internal.5.4.2","author":{"name":"Microsoft and contributors"},"license":"MIT","_id":"@fluid-experimental/devtools-core@2.0.0-internal.5.4.2","maintainers":[{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},{"name":"curtisman","email":"curtism@microsoft.com"}],"homepage":"https://fluidframework.com","bugs":{"url":"https://github.com/microsoft/FluidFramework/issues"},"nyc":{"all":true,"exclude":["src/test/**/*.ts","dist/test/**/*.js"],"include":["src/**/*.ts","dist/**/*.js"],"reporter":["cobertura","html","text"],"cache-dir":"nyc/.cache","report-dir":"nyc/report","temp-directory":"nyc/.nyc_output","exclude-after-remap":false},"dist":{"shasum":"d0ba8c59e17fdd06effa2ab9076931ac71a8883c","tarball":"https://registry.npmjs.org/@fluid-experimental/devtools-core/-/devtools-core-2.0.0-internal.5.4.2.tgz","fileCount":501,"integrity":"sha512-BPvH5sx4nMvE40PjOF0tfEFqBw4BPBIna/aJPY36qvbHHlcxkF/MHFsjjdZuN7M1g+x9a/nqOC/gOzJlAdyfQQ==","signatures":[{"sig":"MEUCIGG8jBkVD1PvPflR7apqvfqwcvmWSF/tRDRgs2yw+0O3AiEA7fzUdWHZgB9Egiic96jp/cMV+eoyB+zbYKgMTslHtyA=","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}],"unpackedSize":1338014},"main":"dist/index.js","_from":"file:fluid-experimental-devtools-core-2.0.0-internal.5.4.2.tgz","types":"dist/index.d.ts","readme":"# @fluid-experimental/devtools-core\n\nThis library contains developer tools for use alongside the Fluid Framework.\nIt is used to power our associated [browser extension][browser-extension].\n\n- Chrome: \n- Edge: \n\n\n\n\n\n\n## Installation\n\nTo get started, install the package by running the following command:\n\n```bash\nnpm i @fluid-experimental/devtools-core -D\n```\n\n\n\n\n\n## Usage\n\nThe Devtools' API surface is designed to fit nicely into most application flows.\n\n### Initialization\n\nTo initialize a devtools session for your container, call [`initializeDevtools`][initialize-devtools-docs].\nThis function accepts a `DevtoolsLogger` for receiving Fluid telemetry from your application, a list of initial Fluid\n`Containers` to associate with the session, and (optionally) customized data visualization configurations for visualizing\n`Container` data.\n\n#### About the [`DevtoolsLogger`][devtools-logger-docs]\n\nThe `DevtoolsLogger` is an optional piece when calling `initializeDevtools` but it is strongly recommended that you use\nit because several features in Fluid Devtools are powered by the telemetry that Fluid Framework generates, and this\nlogger is the way in which that telemetry gets into Fluid Devtools.\n\nYou can obtain a `DevtoolsLogger` by calling its constructor, and then should pass it to `initializeDevtools` _and_\nto the `Loader` instance you'll use to create/load Containers as shown below.\nThis way the logger will receive all the telemetry generated by Fluid Framework in your application, and forward it to\nFluid Devtools as necessary.\n\n```typescript\nimport { DevtoolsLogger, initializeDevtools } from \"@fluid-experimental/devtools-core\";\n\n// Instantiate the logger\nconst devtoolsLogger = new DevtoolsLogger();\n\n// Pass the logger when instantiating the Loader\nconst loader = new Loader({\n\tlogger: devtoolsLogger,\n\t// Other necessary properties ...\n});\n\n// Use the Loader to create (and optionally, attach) a Container\nconst container = await loader.createDetachedContainer(/* params */);\nawait container.attach(/* params */);\n\n// Initialize the Devtools passing the logger and your Container.\n// The Container could be added later as well with devtools.registerContainerDevtools().\nconst devtools = initializeDevtools({\n\tlogger: devtoolsLogger,\n\tinitialContainers: [\n\t\t{\n\t\t\tcontainer,\n\t\t\tcontainerKey: \"My Container\",\n\t\t},\n\t],\n});\n```\n\nIf you're working with `AzureClient` instead of lower-level APIs like the one described above, you probably want to\nrefer to the [@fluid-experimental/devtools package][devtools-package] instead of this one.\n\nDuring local development the recommendation is that your application should receive the `DevtoolsLogger` instance _instead_\nof any logger it would normally receive when deployed to a real environment, to avoid local development activity from\nmixing with real telemetry.\nIf you still want to provide a real application logger and use the Fluid Devtools features that are powered by telemetry\nat the same time, you can pass an existing logger to the `DevtoolsLogger` constructor and it will forward all telemetry\nit receives to that logger as well:\n\n```typescript\nimport { DevtoolsLogger } from \"@fluid-experimental/devtools-core\";\n\n// Your application's logger\nconst yourApplicationLogger = getInstanceOfYourApplicationLogger();\n\nconst devtoolsLogger = new DevtoolsLogger(yourApplicationLogger);\n\n// Pass devtoolsLogger to initializeDevtools() and to your application as described above\n```\n\n### Clean-up\n\nThe Devtools object is managed as a global singleton.\nThat singleton is automatically cleaned up prior to the Window's \"unload\" event.\nSo typical application flows likely won't need to worry about cleanup.\nThat said, if you wish to have tighter control over when the Devtools are torn down, you can simply call the `dispose` method on the handle returned by [initialization](#initialization).\n\n## Contributing to the package\n\n### Build\n\nTo build the package locally, first ensure you have run `pnpm install` from the root of the mono-repo.\nNext, to build the code, run `npm run build` from the root of the mono-repo, or use [fluid-build](https://github.com/microsoft/FluidFramework/tree/main/build-tools/packages/build-tools#running-fluid-build-command-line) via `fluid-build -t build`.\n\n- Note: Once you have run a build from the root, assuming no other changes outside of this package, you may run `npm run build` directly within this directory for a faster build.\n If you make changes to any of this package's local dependencies, you will need to run a build again from the root before building again from directly within this package.\n\n### Test\n\nTo run the tests, first ensure you have followed the [build](#build) steps above.\nNext, run `npm run test` from a terminal within this directory.\n\n\n\n\n\n\n\n## API Documentation\n\nAPI documentation for **@fluid-experimental/devtools-core** is available at .\n\n\n\n\n\n\n\n\n\n\n## Contribution Guidelines\n\nThere are many ways to [contribute](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md) to Fluid.\n\n- Participate in Q&A in our [GitHub Discussions](https://github.com/microsoft/FluidFramework/discussions).\n- [Submit bugs](https://github.com/microsoft/FluidFramework/issues) and help us verify fixes as they are checked in.\n- Review the [source code changes](https://github.com/microsoft/FluidFramework/pulls).\n- [Contribute bug fixes](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md).\n\nDetailed instructions for working in the repo can be found in the [Wiki](https://github.com/microsoft/FluidFramework/wiki).\n\nThis project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).\nFor more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\nUse of these trademarks or logos must follow Microsoft’s [Trademark & Brand Guidelines](https://www.microsoft.com/trademarks).\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n\n\n\n## Help\n\nNot finding what you're looking for in this README? Check out our [GitHub\nWiki](https://github.com/microsoft/FluidFramework/wiki) or [fluidframework.com](https://fluidframework.com/docs/).\n\nStill not finding what you're looking for? Please [file an\nissue](https://github.com/microsoft/FluidFramework/wiki/Submitting-Bugs-and-Feature-Requests).\n\nThank you!\n\n\n\n\n\n\n\n\n\n\n## Trademark\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\n\nUse of these trademarks or logos must follow Microsoft's [Trademark & Brand\nGuidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general).\n\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n[initialize-devtools-docs]: https://fluidframework.com/docs/apis/devtools-core#initializedevtools-function\n[devtools-logger-docs]: https://fluidframework.com/docs/apis/devtools-core/devtoolslogger-class\n[devtools-package]: https://www.npmjs.com/package/@fluid-experimental/devtools\n[browser-extension]: https://github.com/microsoft/FluidFramework/tree/main/packages/tools/devtools/devtools-browser-extension\n","scripts":{"tsc":"tsc","lint":"npm run prettier && npm run eslint","test":"npm run test:mocha","build":"fluid-build . --task build","clean":"rimraf --glob \"_api-extractor-temp\" \"nyc\" \"dist\" \"lib\" \"*.tsbuildinfo\" \"*.build.log\"","eslint":"eslint src","format":"npm run prettier:fix","rebuild":"npm run clean && npm run build","lint:fix":"npm run prettier:fix && npm run eslint:fix","prettier":"prettier --check . --ignore-path ../../../../.prettierignore","build:docs":"api-extractor run --local && copyfiles -u 1 ./_api-extractor-temp/doc-models/* ../../../../_api-extractor-temp/","eslint:fix":"eslint src --fix","test:mocha":"mocha dist/**/*.test.js --unhandled-rejections=strict --exit","build:esnext":"tsc --project ./tsconfig.esnext.json","build:genver":"gen-version","prettier:fix":"prettier --write . --ignore-path ../../../../.prettierignore","build:compile":"fluid-build . --task compile","ci:build:docs":"api-extractor run && copyfiles -u 1 ./_api-extractor-temp/doc-models/* ../../../../_api-extractor-temp/","test:coverage":"npm run test:mocha:coverage","typetests:gen":"fluid-type-test-generator","build:commonjs":"fluid-build . --task commonjs","format-and-build":"npm run format && npm run build","typetests:prepare":"flub typetests --dir . --reset --previous --normalize","format-and-compile":"npm run format && npm run build:compile","test:mocha:coverage":"nyc npm run test:mocha -- --reporter xunit --reporter-option output=nyc/junit-report.xml","test:mocha:multireport":"cross-env FLUID_TEST_MULTIREPORT=1 npm run test:mocha"},"_npmUser":{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},"_resolved":"/mnt/vss/_work/1/pack/scoped/fluid-experimental-devtools-core-2.0.0-internal.5.4.2.tgz","_integrity":"sha512-BPvH5sx4nMvE40PjOF0tfEFqBw4BPBIna/aJPY36qvbHHlcxkF/MHFsjjdZuN7M1g+x9a/nqOC/gOzJlAdyfQQ==","fluidBuild":{"tasks":{"tsc":["...","typetests:gen"]}},"repository":{"url":"git+https://github.com/microsoft/FluidFramework.git","type":"git","directory":"packages/tools/devtools/devtools-core"},"_npmVersion":"8.11.0","description":"Fluid Framework developer tools core functionality","directories":{},"sideEffects":false,"_nodeVersion":"16.16.0","dependencies":{"@fluidframework/map":">=2.0.0-internal.5.4.2 <2.0.0-internal.5.5.0","@fluidframework/cell":">=2.0.0-internal.5.4.2 <2.0.0-internal.5.5.0","@fluidframework/matrix":">=2.0.0-internal.5.4.2 <2.0.0-internal.5.5.0","@fluidframework/counter":">=2.0.0-internal.5.4.2 <2.0.0-internal.5.5.0","@fluidframework/sequence":">=2.0.0-internal.5.4.2 <2.0.0-internal.5.5.0","@fluid-experimental/tree2":">=2.0.0-internal.5.4.2 <2.0.0-internal.5.5.0","@fluidframework/common-utils":"^1.1.1","@fluidframework/container-utils":">=2.0.0-internal.5.4.2 <2.0.0-internal.5.5.0","@fluidframework/core-interfaces":">=2.0.0-internal.5.4.2 <2.0.0-internal.5.5.0","@fluidframework/container-loader":">=2.0.0-internal.5.4.2 <2.0.0-internal.5.5.0","@fluidframework/common-definitions":"^0.20.1","@fluidframework/shared-object-base":">=2.0.0-internal.5.4.2 <2.0.0-internal.5.5.0","@fluidframework/protocol-definitions":"^1.1.0","@fluidframework/container-definitions":">=2.0.0-internal.5.4.2 <2.0.0-internal.5.5.0","@fluidframework/datastore-definitions":">=2.0.0-internal.5.4.2 <2.0.0-internal.5.5.0"},"_hasShrinkwrap":false,"readmeFilename":"README.md","typeValidation":{"broken":{"ClassDeclaration_DevtoolsLogger":{"backCompat":false},"InterfaceDeclaration_FluidDevtoolsProps":{"backCompat":false},"EnumDeclaration_ContainerDevtoolsFeature":{"backCompat":false},"RemovedTypeAliasDeclaration_VisualizeChildData":{"backCompat":false,"forwardCompat":false},"RemovedTypeAliasDeclaration_VisualizeSharedObject":{"backCompat":false,"forwardCompat":false}}},"devDependencies":{"nyc":"^15.1.0","chai":"^4.2.0","mocha":"^10.2.0","eslint":"~8.6.0","events":"^3.1.0","moment":"^2.21.0","rimraf":"^4.4.0","prettier":"~2.6.2","copyfiles":"^2.4.1","cross-env":"^7.0.3","typescript":"~4.5.5","@types/chai":"^4.0.0","@types/mocha":"^9.1.1","concurrently":"^7.6.0","@types/events":"^3.0.0","mocha-multi-reporters":"^1.5.1","@fluid-tools/build-cli":"^0.21.0","eslint-config-prettier":"~8.5.0","@microsoft/api-extractor":"^7.34.4","eslint-plugin-chai-expect":"~3.0.0","mocha-json-output-reporter":"^2.0.1","@fluidframework/build-tools":"^0.21.0","@fluidframework/build-common":"^1.2.0","@fluidframework/telemetry-utils":">=2.0.0-internal.5.4.2 <2.0.0-internal.5.5.0","@fluidframework/mocha-test-setup":">=2.0.0-internal.5.4.2 <2.0.0-internal.5.5.0","@fluidframework/driver-definitions":">=2.0.0-internal.5.4.2 <2.0.0-internal.5.5.0","@fluidframework/test-runtime-utils":">=2.0.0-internal.5.4.2 <2.0.0-internal.5.5.0","@fluidframework/eslint-config-fluid":"^2.0.0","@fluid-experimental/devtools-core-previous":"npm:@fluid-experimental/devtools-core@2.0.0-internal.5.2.0"},"_npmOperationalInternal":{"tmp":"tmp/devtools-core_2.0.0-internal.5.4.2_1692546683234_0.2184868403019804","host":"s3://npm-registry-packages"}},"2.0.0-internal.6.0.1":{"name":"@fluid-experimental/devtools-core","version":"2.0.0-internal.6.0.1","author":{"name":"Microsoft and contributors"},"license":"MIT","_id":"@fluid-experimental/devtools-core@2.0.0-internal.6.0.1","maintainers":[{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},{"name":"curtisman","email":"curtism@microsoft.com"}],"homepage":"https://fluidframework.com","bugs":{"url":"https://github.com/microsoft/FluidFramework/issues"},"nyc":{"all":true,"exclude":["src/test/**/*.ts","dist/test/**/*.js"],"include":["src/**/*.ts","dist/**/*.js"],"reporter":["cobertura","html","text"],"cache-dir":"nyc/.cache","report-dir":"nyc/report","temp-directory":"nyc/.nyc_output","exclude-after-remap":false},"dist":{"shasum":"a9125f0c49ecdd6145489ab967569aaf154aa5d8","tarball":"https://registry.npmjs.org/@fluid-experimental/devtools-core/-/devtools-core-2.0.0-internal.6.0.1.tgz","fileCount":501,"integrity":"sha512-fXdR2M8DCTKNEumy6qTcOnR9i1Gt8dVP28lqWM4tRZtIcWAPdcIzyM00kt5LFzL79KEh0sKDD54U9Bvla88qwg==","signatures":[{"sig":"MEUCIE0erLhlMSuCQ8zj1Nv7y2jggMmgtXU9Ps3Iu9drFVA5AiEA/zaDllOc/wMYBL6hfvmhCkcok8SYQHZ/jLwzi458H7E=","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}],"unpackedSize":1347878},"main":"dist/index.js","_from":"file:fluid-experimental-devtools-core-2.0.0-internal.6.0.1.tgz","types":"dist/index.d.ts","readme":"# @fluid-experimental/devtools-core\n\nThis library contains developer tools for use alongside the Fluid Framework.\nIt is used to power our associated [browser extension][browser-extension].\n\n- Chrome: \n- Edge: \n\n\n\n\n\n\n## Installation\n\nTo get started, install the package by running the following command:\n\n```bash\nnpm i @fluid-experimental/devtools-core -D\n```\n\n\n\n\n\n## Usage\n\nThe Devtools' API surface is designed to fit nicely into most application flows.\n\n### Initialization\n\nTo initialize a devtools session for your container, call [`initializeDevtools`][initialize-devtools-docs].\nThis function accepts a `DevtoolsLogger` for receiving Fluid telemetry from your application, a list of initial Fluid\n`Containers` to associate with the session, and (optionally) customized data visualization configurations for visualizing\n`Container` data.\n\n#### About the [`DevtoolsLogger`][devtools-logger-docs]\n\nThe `DevtoolsLogger` is an optional piece when calling `initializeDevtools` but it is strongly recommended that you use\nit because several features in Fluid Devtools are powered by the telemetry that Fluid Framework generates, and this\nlogger is the way in which that telemetry gets into Fluid Devtools.\n\nYou can obtain a `DevtoolsLogger` by calling its constructor, and then should pass it to `initializeDevtools` _and_\nto the `Loader` instance you'll use to create/load Containers as shown below.\nThis way the logger will receive all the telemetry generated by Fluid Framework in your application, and forward it to\nFluid Devtools as necessary.\n\n```typescript\nimport { DevtoolsLogger, initializeDevtools } from \"@fluid-experimental/devtools-core\";\n\n// Instantiate the logger\nconst devtoolsLogger = new DevtoolsLogger();\n\n// Pass the logger when instantiating the Loader\nconst loader = new Loader({\n\tlogger: devtoolsLogger,\n\t// Other necessary properties ...\n});\n\n// Use the Loader to create (and optionally, attach) a Container\nconst container = await loader.createDetachedContainer(/* params */);\nawait container.attach(/* params */);\n\n// Initialize the Devtools passing the logger and your Container.\n// The Container could be added later as well with devtools.registerContainerDevtools().\nconst devtools = initializeDevtools({\n\tlogger: devtoolsLogger,\n\tinitialContainers: [\n\t\t{\n\t\t\tcontainer,\n\t\t\tcontainerKey: \"My Container\",\n\t\t},\n\t],\n});\n```\n\nIf you're working with `AzureClient` instead of lower-level APIs like the one described above, you probably want to\nrefer to the [@fluid-experimental/devtools package][devtools-package] instead of this one.\n\nDuring local development the recommendation is that your application should receive the `DevtoolsLogger` instance _instead_\nof any logger it would normally receive when deployed to a real environment, to avoid local development activity from\nmixing with real telemetry.\nIf you still want to provide a real application logger and use the Fluid Devtools features that are powered by telemetry\nat the same time, you can pass an existing logger to the `DevtoolsLogger` constructor and it will forward all telemetry\nit receives to that logger as well:\n\n```typescript\nimport { DevtoolsLogger } from \"@fluid-experimental/devtools-core\";\n\n// Your application's logger\nconst yourApplicationLogger = getInstanceOfYourApplicationLogger();\n\nconst devtoolsLogger = new DevtoolsLogger(yourApplicationLogger);\n\n// Pass devtoolsLogger to initializeDevtools() and to your application as described above\n```\n\n### Clean-up\n\nThe Devtools object is managed as a global singleton.\nThat singleton is automatically cleaned up prior to the Window's \"unload\" event.\nSo typical application flows likely won't need to worry about cleanup.\nThat said, if you wish to have tighter control over when the Devtools are torn down, you can simply call the `dispose` method on the handle returned by [initialization](#initialization).\n\n## Contributing to the package\n\n### Build\n\nTo build the package locally, first ensure you have run `pnpm install` from the root of the mono-repo.\nNext, to build the code, run `npm run build` from the root of the mono-repo, or use [fluid-build](https://github.com/microsoft/FluidFramework/tree/main/build-tools/packages/build-tools#running-fluid-build-command-line) via `fluid-build -t build`.\n\n- Note: Once you have run a build from the root, assuming no other changes outside of this package, you may run `npm run build` directly within this directory for a faster build.\n If you make changes to any of this package's local dependencies, you will need to run a build again from the root before building again from directly within this package.\n\n### Test\n\nTo run the tests, first ensure you have followed the [build](#build) steps above.\nNext, run `npm run test` from a terminal within this directory.\n\n\n\n\n\n\n\n## API Documentation\n\nAPI documentation for **@fluid-experimental/devtools-core** is available at .\n\n\n\n\n\n\n\n\n\n\n## Contribution Guidelines\n\nThere are many ways to [contribute](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md) to Fluid.\n\n- Participate in Q&A in our [GitHub Discussions](https://github.com/microsoft/FluidFramework/discussions).\n- [Submit bugs](https://github.com/microsoft/FluidFramework/issues) and help us verify fixes as they are checked in.\n- Review the [source code changes](https://github.com/microsoft/FluidFramework/pulls).\n- [Contribute bug fixes](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md).\n\nDetailed instructions for working in the repo can be found in the [Wiki](https://github.com/microsoft/FluidFramework/wiki).\n\nThis project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).\nFor more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\nUse of these trademarks or logos must follow Microsoft’s [Trademark & Brand Guidelines](https://www.microsoft.com/trademarks).\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n\n\n\n## Help\n\nNot finding what you're looking for in this README? Check out our [GitHub\nWiki](https://github.com/microsoft/FluidFramework/wiki) or [fluidframework.com](https://fluidframework.com/docs/).\n\nStill not finding what you're looking for? Please [file an\nissue](https://github.com/microsoft/FluidFramework/wiki/Submitting-Bugs-and-Feature-Requests).\n\nThank you!\n\n\n\n\n\n\n\n\n\n\n## Trademark\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\n\nUse of these trademarks or logos must follow Microsoft's [Trademark & Brand\nGuidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general).\n\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n[initialize-devtools-docs]: https://fluidframework.com/docs/apis/devtools-core#initializedevtools-function\n[devtools-logger-docs]: https://fluidframework.com/docs/apis/devtools-core/devtoolslogger-class\n[devtools-package]: https://www.npmjs.com/package/@fluid-experimental/devtools\n[browser-extension]: https://github.com/microsoft/FluidFramework/tree/main/packages/tools/devtools/devtools-browser-extension\n","scripts":{"tsc":"tsc","lint":"npm run prettier && npm run eslint","test":"npm run test:mocha","build":"fluid-build . --task build","clean":"rimraf --glob \"_api-extractor-temp\" \"nyc\" \"dist\" \"lib\" \"*.tsbuildinfo\" \"*.build.log\"","eslint":"eslint src","format":"npm run prettier:fix","rebuild":"npm run clean && npm run build","lint:fix":"npm run prettier:fix && npm run eslint:fix","prettier":"prettier --check . --ignore-path ../../../../.prettierignore","build:docs":"api-extractor run --local && copyfiles -u 1 ./_api-extractor-temp/doc-models/* ../../../../_api-extractor-temp/","eslint:fix":"eslint src --fix","test:mocha":"mocha dist/**/*.test.js --unhandled-rejections=strict --exit","build:esnext":"tsc --project ./tsconfig.esnext.json","build:genver":"gen-version","prettier:fix":"prettier --write . --ignore-path ../../../../.prettierignore","build:compile":"fluid-build . --task compile","ci:build:docs":"api-extractor run && copyfiles -u 1 ./_api-extractor-temp/doc-models/* ../../../../_api-extractor-temp/","test:coverage":"npm run test:mocha:coverage","typetests:gen":"fluid-type-test-generator","build:commonjs":"fluid-build . --task commonjs","format-and-build":"npm run format && npm run build","typetests:prepare":"flub typetests --dir . --reset --previous --normalize","format-and-compile":"npm run format && npm run build:compile","test:mocha:coverage":"nyc npm run test:mocha -- --reporter xunit --reporter-option output=nyc/junit-report.xml","test:mocha:multireport":"cross-env FLUID_TEST_MULTIREPORT=1 npm run test:mocha"},"_npmUser":{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},"_resolved":"/mnt/vss/_work/1/pack/scoped/fluid-experimental-devtools-core-2.0.0-internal.6.0.1.tgz","_integrity":"sha512-fXdR2M8DCTKNEumy6qTcOnR9i1Gt8dVP28lqWM4tRZtIcWAPdcIzyM00kt5LFzL79KEh0sKDD54U9Bvla88qwg==","fluidBuild":{"tasks":{"tsc":["...","typetests:gen"]}},"repository":{"url":"git+https://github.com/microsoft/FluidFramework.git","type":"git","directory":"packages/tools/devtools/devtools-core"},"_npmVersion":"8.11.0","description":"Fluid Framework developer tools core functionality","directories":{},"sideEffects":false,"_nodeVersion":"16.16.0","dependencies":{"@fluidframework/map":">=2.0.0-internal.6.0.1 <2.0.0-internal.6.1.0","@fluidframework/cell":">=2.0.0-internal.6.0.1 <2.0.0-internal.6.1.0","@fluidframework/matrix":">=2.0.0-internal.6.0.1 <2.0.0-internal.6.1.0","@fluidframework/counter":">=2.0.0-internal.6.0.1 <2.0.0-internal.6.1.0","@fluidframework/sequence":">=2.0.0-internal.6.0.1 <2.0.0-internal.6.1.0","@fluid-experimental/tree2":">=2.0.0-internal.6.0.1 <2.0.0-internal.6.1.0","@fluidframework/common-utils":"^1.1.1","@fluidframework/container-utils":">=2.0.0-internal.6.0.1 <2.0.0-internal.6.1.0","@fluidframework/core-interfaces":">=2.0.0-internal.6.0.1 <2.0.0-internal.6.1.0","@fluidframework/container-loader":">=2.0.0-internal.6.0.1 <2.0.0-internal.6.1.0","@fluidframework/common-definitions":"^0.20.1","@fluidframework/shared-object-base":">=2.0.0-internal.6.0.1 <2.0.0-internal.6.1.0","@fluidframework/protocol-definitions":"^1.1.0","@fluidframework/container-definitions":">=2.0.0-internal.6.0.1 <2.0.0-internal.6.1.0","@fluidframework/datastore-definitions":">=2.0.0-internal.6.0.1 <2.0.0-internal.6.1.0"},"_hasShrinkwrap":false,"readmeFilename":"README.md","typeValidation":{"broken":{}},"devDependencies":{"nyc":"^15.1.0","chai":"^4.2.0","mocha":"^10.2.0","eslint":"~8.6.0","events":"^3.1.0","moment":"^2.21.0","rimraf":"^4.4.0","prettier":"~2.6.2","copyfiles":"^2.4.1","cross-env":"^7.0.3","typescript":"~4.5.5","@types/chai":"^4.0.0","@types/mocha":"^9.1.1","concurrently":"^7.6.0","@types/events":"^3.0.0","mocha-multi-reporters":"^1.5.1","@fluid-tools/build-cli":"^0.21.0","eslint-config-prettier":"~8.5.0","@microsoft/api-extractor":"^7.34.4","eslint-plugin-chai-expect":"~3.0.0","mocha-json-output-reporter":"^2.0.1","@fluidframework/build-tools":"^0.21.0","@fluidframework/build-common":"^2.0.0","@fluidframework/telemetry-utils":">=2.0.0-internal.6.0.1 <2.0.0-internal.6.1.0","@fluidframework/mocha-test-setup":">=2.0.0-internal.6.0.1 <2.0.0-internal.6.1.0","@fluidframework/driver-definitions":">=2.0.0-internal.6.0.1 <2.0.0-internal.6.1.0","@fluidframework/test-runtime-utils":">=2.0.0-internal.6.0.1 <2.0.0-internal.6.1.0","@fluidframework/eslint-config-fluid":"^2.0.0","@fluid-experimental/devtools-core-previous":"npm:@fluid-experimental/devtools-core@2.0.0-internal.6.0.0"},"_npmOperationalInternal":{"tmp":"tmp/devtools-core_2.0.0-internal.6.0.1_1692566590416_0.7408693546336549","host":"s3://npm-registry-packages"}},"2.0.0-internal.6.2.0":{"name":"@fluid-experimental/devtools-core","version":"2.0.0-internal.6.2.0","author":{"name":"Microsoft and contributors"},"license":"MIT","_id":"@fluid-experimental/devtools-core@2.0.0-internal.6.2.0","maintainers":[{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},{"name":"curtisman","email":"curtism@microsoft.com"}],"homepage":"https://fluidframework.com","bugs":{"url":"https://github.com/microsoft/FluidFramework/issues"},"nyc":{"all":true,"exclude":["src/test/**/*.ts","dist/test/**/*.js"],"include":["src/**/*.ts","dist/**/*.js"],"reporter":["cobertura","html","text"],"cache-dir":"nyc/.cache","report-dir":"nyc/report","temp-directory":"nyc/.nyc_output","exclude-after-remap":false},"dist":{"shasum":"3dac9fe67461efa6adf1ab5b8bc3a6e5928891db","tarball":"https://registry.npmjs.org/@fluid-experimental/devtools-core/-/devtools-core-2.0.0-internal.6.2.0.tgz","fileCount":501,"integrity":"sha512-hLEM83NGt3ugISsXhyb3OJguzUHsfkuWxXERuLNlrbkuBq7PqC+GT8P46x/Nun3vcv9B9nT7xr+eSLm/J4nPag==","signatures":[{"sig":"MEYCIQCZZ/nfLgoe0991QkC4IU0G4OjiApwNWHIHo5tntZHUNQIhALBSsrthsxo/8p9FfT3OCvVMkACO14ZWLkqT56M2TP8W","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}],"unpackedSize":1368282},"main":"dist/index.js","_from":"file:fluid-experimental-devtools-core-2.0.0-internal.6.2.0.tgz","types":"dist/index.d.ts","readme":"# @fluid-experimental/devtools-core\n\nThis library contains developer tools for use alongside the Fluid Framework.\nIt is used to power our associated [browser extension][browser-extension].\n\n- Chrome: \n- Edge: \n\n\n\n\n\n\n## Installation\n\nTo get started, install the package by running the following command:\n\n```bash\nnpm i @fluid-experimental/devtools-core -D\n```\n\n\n\n\n\n## Usage\n\nThe Devtools' API surface is designed to fit nicely into most application flows.\n\n### Initialization\n\nTo initialize a devtools session for your container, call [`initializeDevtools`][initialize-devtools-docs].\nThis function accepts a `DevtoolsLogger` for receiving Fluid telemetry from your application, a list of initial Fluid\n`Containers` to associate with the session, and (optionally) customized data visualization configurations for visualizing\n`Container` data.\n\n#### About the [`DevtoolsLogger`][devtools-logger-docs]\n\nThe `DevtoolsLogger` is an optional piece when calling `initializeDevtools` but it is strongly recommended that you use\nit because several features in Fluid Devtools are powered by the telemetry that Fluid Framework generates, and this\nlogger is the way in which that telemetry gets into Fluid Devtools.\n\nYou can obtain a `DevtoolsLogger` by calling its constructor, and then should pass it to `initializeDevtools` _and_\nto the `Loader` instance you'll use to create/load Containers as shown below.\nThis way the logger will receive all the telemetry generated by Fluid Framework in your application, and forward it to\nFluid Devtools as necessary.\n\n```typescript\nimport { DevtoolsLogger, initializeDevtools } from \"@fluid-experimental/devtools-core\";\n\n// Instantiate the logger\nconst devtoolsLogger = new DevtoolsLogger();\n\n// Pass the logger when instantiating the Loader\nconst loader = new Loader({\n\tlogger: devtoolsLogger,\n\t// Other necessary properties ...\n});\n\n// Use the Loader to create (and optionally, attach) a Container\nconst container = await loader.createDetachedContainer(/* params */);\nawait container.attach(/* params */);\n\n// Initialize the Devtools passing the logger and your Container.\n// The Container could be added later as well with devtools.registerContainerDevtools().\nconst devtools = initializeDevtools({\n\tlogger: devtoolsLogger,\n\tinitialContainers: [\n\t\t{\n\t\t\tcontainer,\n\t\t\tcontainerKey: \"My Container\",\n\t\t},\n\t],\n});\n```\n\nIf you're working with `AzureClient` instead of lower-level APIs like the one described above, you probably want to\nrefer to the [@fluid-experimental/devtools package][devtools-package] instead of this one.\n\nDuring local development the recommendation is that your application should receive the `DevtoolsLogger` instance _instead_\nof any logger it would normally receive when deployed to a real environment, to avoid local development activity from\nmixing with real telemetry.\nIf you still want to provide a real application logger and use the Fluid Devtools features that are powered by telemetry\nat the same time, you can pass an existing logger to the `DevtoolsLogger` constructor and it will forward all telemetry\nit receives to that logger as well:\n\n```typescript\nimport { DevtoolsLogger } from \"@fluid-experimental/devtools-core\";\n\n// Your application's logger\nconst yourApplicationLogger = getInstanceOfYourApplicationLogger();\n\nconst devtoolsLogger = new DevtoolsLogger(yourApplicationLogger);\n\n// Pass devtoolsLogger to initializeDevtools() and to your application as described above\n```\n\n### Clean-up\n\nThe Devtools object is managed as a global singleton.\nThat singleton is automatically cleaned up prior to the Window's \"unload\" event.\nSo typical application flows likely won't need to worry about cleanup.\nThat said, if you wish to have tighter control over when the Devtools are torn down, you can simply call the `dispose` method on the handle returned by [initialization](#initialization).\n\n## Contributing to the package\n\n### Build\n\nTo build the package locally, first ensure you have run `pnpm install` from the root of the mono-repo.\nNext, to build the code, run `npm run build` from the root of the mono-repo, or use [fluid-build](https://github.com/microsoft/FluidFramework/tree/main/build-tools/packages/build-tools#running-fluid-build-command-line) via `fluid-build -t build`.\n\n- Note: Once you have run a build from the root, assuming no other changes outside of this package, you may run `npm run build` directly within this directory for a faster build.\n If you make changes to any of this package's local dependencies, you will need to run a build again from the root before building again from directly within this package.\n\n### Test\n\nTo run the tests, first ensure you have followed the [build](#build) steps above.\nNext, run `npm run test` from a terminal within this directory.\n\n\n\n\n\n\n\n## API Documentation\n\nAPI documentation for **@fluid-experimental/devtools-core** is available at .\n\n\n\n\n\n\n\n\n\n\n## Contribution Guidelines\n\nThere are many ways to [contribute](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md) to Fluid.\n\n- Participate in Q&A in our [GitHub Discussions](https://github.com/microsoft/FluidFramework/discussions).\n- [Submit bugs](https://github.com/microsoft/FluidFramework/issues) and help us verify fixes as they are checked in.\n- Review the [source code changes](https://github.com/microsoft/FluidFramework/pulls).\n- [Contribute bug fixes](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md).\n\nDetailed instructions for working in the repo can be found in the [Wiki](https://github.com/microsoft/FluidFramework/wiki).\n\nThis project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).\nFor more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\nUse of these trademarks or logos must follow Microsoft’s [Trademark & Brand Guidelines](https://www.microsoft.com/trademarks).\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n\n\n\n## Help\n\nNot finding what you're looking for in this README? Check out our [GitHub\nWiki](https://github.com/microsoft/FluidFramework/wiki) or [fluidframework.com](https://fluidframework.com/docs/).\n\nStill not finding what you're looking for? Please [file an\nissue](https://github.com/microsoft/FluidFramework/wiki/Submitting-Bugs-and-Feature-Requests).\n\nThank you!\n\n\n\n\n\n\n\n\n\n\n## Trademark\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\n\nUse of these trademarks or logos must follow Microsoft's [Trademark & Brand\nGuidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general).\n\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n[initialize-devtools-docs]: https://fluidframework.com/docs/apis/devtools-core#initializedevtools-function\n[devtools-logger-docs]: https://fluidframework.com/docs/apis/devtools-core/devtoolslogger-class\n[devtools-package]: https://www.npmjs.com/package/@fluid-experimental/devtools\n[browser-extension]: https://github.com/microsoft/FluidFramework/tree/main/packages/tools/devtools/devtools-browser-extension\n","scripts":{"tsc":"tsc","lint":"npm run prettier && npm run eslint","test":"npm run test:mocha","build":"fluid-build . --task build","clean":"rimraf --glob \"_api-extractor-temp\" \"nyc\" \"dist\" \"lib\" \"*.tsbuildinfo\" \"*.build.log\"","eslint":"eslint src","format":"npm run prettier:fix","rebuild":"npm run clean && npm run build","lint:fix":"npm run prettier:fix && npm run eslint:fix","prettier":"prettier --check . --ignore-path ../../../../.prettierignore","tsc:watch":"tsc --watch","build:docs":"api-extractor run --local && copyfiles -u 1 ./_api-extractor-temp/doc-models/* ../../../../_api-extractor-temp/","eslint:fix":"eslint src --fix","test:mocha":"mocha dist/**/*.test.js --unhandled-rejections=strict --exit","build:esnext":"tsc --project ./tsconfig.esnext.json","build:genver":"gen-version","prettier:fix":"prettier --write . --ignore-path ../../../../.prettierignore","build:compile":"fluid-build . --task compile","ci:build:docs":"api-extractor run && copyfiles -u 1 ./_api-extractor-temp/doc-models/* ../../../../_api-extractor-temp/","test:coverage":"npm run test:mocha:coverage","typetests:gen":"fluid-type-test-generator","build:commonjs":"fluid-build . --task commonjs","format-and-build":"npm run format && npm run build","typetests:prepare":"flub typetests --dir . --reset --previous --normalize","format-and-compile":"npm run format && npm run build:compile","test:mocha:coverage":"nyc npm run test:mocha -- --reporter xunit --reporter-option output=nyc/junit-report.xml","test:mocha:multireport":"npm run test:mocha"},"_npmUser":{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},"_resolved":"/mnt/vss/_work/1/pack/scoped/fluid-experimental-devtools-core-2.0.0-internal.6.2.0.tgz","_integrity":"sha512-hLEM83NGt3ugISsXhyb3OJguzUHsfkuWxXERuLNlrbkuBq7PqC+GT8P46x/Nun3vcv9B9nT7xr+eSLm/J4nPag==","fluidBuild":{"tasks":{"tsc":["...","typetests:gen"]}},"repository":{"url":"git+https://github.com/microsoft/FluidFramework.git","type":"git","directory":"packages/tools/devtools/devtools-core"},"_npmVersion":"8.11.0","description":"Fluid Framework developer tools core functionality","directories":{},"sideEffects":false,"_nodeVersion":"16.16.0","dependencies":{"@fluidframework/map":">=2.0.0-internal.6.2.0 <2.0.0-internal.6.3.0","@fluidframework/cell":">=2.0.0-internal.6.2.0 <2.0.0-internal.6.3.0","@fluidframework/matrix":">=2.0.0-internal.6.2.0 <2.0.0-internal.6.3.0","@fluidframework/counter":">=2.0.0-internal.6.2.0 <2.0.0-internal.6.3.0","@fluidframework/sequence":">=2.0.0-internal.6.2.0 <2.0.0-internal.6.3.0","@fluid-experimental/tree2":">=2.0.0-internal.6.2.0 <2.0.0-internal.6.3.0","@fluidframework/common-utils":"^1.1.1","@fluidframework/core-interfaces":">=2.0.0-internal.6.2.0 <2.0.0-internal.6.3.0","@fluidframework/telemetry-utils":">=2.0.0-internal.6.2.0 <2.0.0-internal.6.3.0","@fluidframework/container-loader":">=2.0.0-internal.6.2.0 <2.0.0-internal.6.3.0","@fluidframework/shared-object-base":">=2.0.0-internal.6.2.0 <2.0.0-internal.6.3.0","@fluidframework/protocol-definitions":"^1.1.0","@fluidframework/container-definitions":">=2.0.0-internal.6.2.0 <2.0.0-internal.6.3.0","@fluidframework/datastore-definitions":">=2.0.0-internal.6.2.0 <2.0.0-internal.6.3.0"},"_hasShrinkwrap":false,"readmeFilename":"README.md","typeValidation":{"broken":{}},"devDependencies":{"nyc":"^15.1.0","chai":"^4.2.0","mocha":"^10.2.0","eslint":"~8.6.0","events":"^3.1.0","moment":"^2.21.0","rimraf":"^4.4.0","prettier":"~2.6.2","copyfiles":"^2.4.1","cross-env":"^7.0.3","typescript":"~4.5.5","@types/chai":"^4.0.0","@types/mocha":"^9.1.1","concurrently":"^7.6.0","@types/events":"^3.0.0","mocha-multi-reporters":"^1.5.1","@fluid-tools/build-cli":"^0.23.0","eslint-config-prettier":"~8.5.0","@microsoft/api-extractor":"^7.34.4","eslint-plugin-chai-expect":"~3.0.0","mocha-json-output-reporter":"^2.0.1","@fluidframework/build-tools":"^0.23.0","@fluidframework/build-common":"^2.0.0","@fluidframework/mocha-test-setup":">=2.0.0-internal.6.2.0 <2.0.0-internal.6.3.0","@fluidframework/driver-definitions":">=2.0.0-internal.6.2.0 <2.0.0-internal.6.3.0","@fluidframework/test-runtime-utils":">=2.0.0-internal.6.2.0 <2.0.0-internal.6.3.0","@fluidframework/eslint-config-fluid":"^2.1.0","@fluid-experimental/devtools-core-previous":"npm:@fluid-experimental/devtools-core@2.0.0-internal.6.1.1"},"_npmOperationalInternal":{"tmp":"tmp/devtools-core_2.0.0-internal.6.2.0_1693333511303_0.0359766021925958","host":"s3://npm-registry-packages"}},"2.0.0-internal.6.3.0":{"name":"@fluid-experimental/devtools-core","version":"2.0.0-internal.6.3.0","author":{"name":"Microsoft and contributors"},"license":"MIT","_id":"@fluid-experimental/devtools-core@2.0.0-internal.6.3.0","maintainers":[{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},{"name":"curtisman","email":"curtism@microsoft.com"}],"homepage":"https://fluidframework.com","bugs":{"url":"https://github.com/microsoft/FluidFramework/issues"},"c8":{"all":true,"exclude":["src/test/**/*.ts","dist/test/**/*.js"],"include":["src/**/*.ts","dist/**/*.js"],"reporter":["cobertura","html","text"],"cache-dir":"nyc/.cache","report-dir":"nyc/report","temp-directory":"nyc/.nyc_output","exclude-after-remap":false},"dist":{"shasum":"fea8e365f233e2030ff67b01596118812712c24c","tarball":"https://registry.npmjs.org/@fluid-experimental/devtools-core/-/devtools-core-2.0.0-internal.6.3.0.tgz","fileCount":501,"integrity":"sha512-B/pVdKNgCzhLzuqFMv5EKL/WVbkquaBFo68aJWN8dZMULyoPXQwFG3nyooBpfPLU4Fud9mJq8BpJrNfuAxtJ9Q==","signatures":[{"sig":"MEUCICNMzbzqlYHKCXnoheUVNs18eSOAGK5ywJG4YHZ9O/Z2AiEAp41WPWHR8qjEY3qYZfdDkhdf76LVGtgNKdiQMKtjNas=","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}],"unpackedSize":1368137},"main":"dist/index.js","_from":"file:fluid-experimental-devtools-core-2.0.0-internal.6.3.0.tgz","types":"dist/index.d.ts","module":"lib/index.js","readme":"# @fluid-experimental/devtools-core\n\nThis library contains developer tools for use alongside the Fluid Framework.\nIt is used to power our associated [browser extension][browser-extension].\n\n- Chrome: \n- Edge: \n\n\n\n\n\n\n## Installation\n\nTo get started, install the package by running the following command:\n\n```bash\nnpm i @fluid-experimental/devtools-core -D\n```\n\n\n\n\n\n## Usage\n\nThe Devtools' API surface is designed to fit nicely into most application flows.\n\n### Initialization\n\nTo initialize a devtools session for your container, call [`initializeDevtools`][initialize-devtools-docs].\nThis function accepts a `DevtoolsLogger` for receiving Fluid telemetry from your application, a list of initial Fluid\n`Containers` to associate with the session, and (optionally) customized data visualization configurations for visualizing\n`Container` data.\n\n#### About the [`DevtoolsLogger`][devtools-logger-docs]\n\nThe `DevtoolsLogger` is an optional piece when calling `initializeDevtools` but it is strongly recommended that you use\nit because several features in Fluid Devtools are powered by the telemetry that Fluid Framework generates, and this\nlogger is the way in which that telemetry gets into Fluid Devtools.\n\nYou can obtain a `DevtoolsLogger` by calling its constructor, and then should pass it to `initializeDevtools` _and_\nto the `Loader` instance you'll use to create/load Containers as shown below.\nThis way the logger will receive all the telemetry generated by Fluid Framework in your application, and forward it to\nFluid Devtools as necessary.\n\n```typescript\nimport { DevtoolsLogger, initializeDevtools } from \"@fluid-experimental/devtools-core\";\n\n// Instantiate the logger\nconst devtoolsLogger = new DevtoolsLogger();\n\n// Pass the logger when instantiating the Loader\nconst loader = new Loader({\n\tlogger: devtoolsLogger,\n\t// Other necessary properties ...\n});\n\n// Use the Loader to create (and optionally, attach) a Container\nconst container = await loader.createDetachedContainer(/* params */);\nawait container.attach(/* params */);\n\n// Initialize the Devtools passing the logger and your Container.\n// The Container could be added later as well with devtools.registerContainerDevtools().\nconst devtools = initializeDevtools({\n\tlogger: devtoolsLogger,\n\tinitialContainers: [\n\t\t{\n\t\t\tcontainer,\n\t\t\tcontainerKey: \"My Container\",\n\t\t},\n\t],\n});\n```\n\nIf you're working with `AzureClient` instead of lower-level APIs like the one described above, you probably want to\nrefer to the [@fluid-experimental/devtools package][devtools-package] instead of this one.\n\nDuring local development the recommendation is that your application should receive the `DevtoolsLogger` instance _instead_\nof any logger it would normally receive when deployed to a real environment, to avoid local development activity from\nmixing with real telemetry.\nIf you still want to provide a real application logger and use the Fluid Devtools features that are powered by telemetry\nat the same time, you can pass an existing logger to the `DevtoolsLogger` constructor and it will forward all telemetry\nit receives to that logger as well:\n\n```typescript\nimport { DevtoolsLogger } from \"@fluid-experimental/devtools-core\";\n\n// Your application's logger\nconst yourApplicationLogger = getInstanceOfYourApplicationLogger();\n\nconst devtoolsLogger = new DevtoolsLogger(yourApplicationLogger);\n\n// Pass devtoolsLogger to initializeDevtools() and to your application as described above\n```\n\n### Clean-up\n\nThe Devtools object is managed as a global singleton.\nThat singleton is automatically cleaned up prior to the Window's \"unload\" event.\nSo typical application flows likely won't need to worry about cleanup.\nThat said, if you wish to have tighter control over when the Devtools are torn down, you can simply call the `dispose` method on the handle returned by [initialization](#initialization).\n\n## Contributing to the package\n\n### Build\n\nTo build the package locally, first ensure you have run `pnpm install` from the root of the mono-repo.\nNext, to build the code, run `npm run build` from the root of the mono-repo, or use [fluid-build](https://github.com/microsoft/FluidFramework/tree/main/build-tools/packages/build-tools#running-fluid-build-command-line) via `fluid-build -t build`.\n\n- Note: Once you have run a build from the root, assuming no other changes outside of this package, you may run `npm run build` directly within this directory for a faster build.\n If you make changes to any of this package's local dependencies, you will need to run a build again from the root before building again from directly within this package.\n\n### Test\n\nTo run the tests, first ensure you have followed the [build](#build) steps above.\nNext, run `npm run test` from a terminal within this directory.\n\n\n\n\n\n\n\n## API Documentation\n\nAPI documentation for **@fluid-experimental/devtools-core** is available at .\n\n\n\n\n\n\n\n\n\n\n## Contribution Guidelines\n\nThere are many ways to [contribute](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md) to Fluid.\n\n- Participate in Q&A in our [GitHub Discussions](https://github.com/microsoft/FluidFramework/discussions).\n- [Submit bugs](https://github.com/microsoft/FluidFramework/issues) and help us verify fixes as they are checked in.\n- Review the [source code changes](https://github.com/microsoft/FluidFramework/pulls).\n- [Contribute bug fixes](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md).\n\nDetailed instructions for working in the repo can be found in the [Wiki](https://github.com/microsoft/FluidFramework/wiki).\n\nThis project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).\nFor more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\nUse of these trademarks or logos must follow Microsoft’s [Trademark & Brand Guidelines](https://www.microsoft.com/trademarks).\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n\n\n\n## Help\n\nNot finding what you're looking for in this README? Check out our [GitHub\nWiki](https://github.com/microsoft/FluidFramework/wiki) or [fluidframework.com](https://fluidframework.com/docs/).\n\nStill not finding what you're looking for? Please [file an\nissue](https://github.com/microsoft/FluidFramework/wiki/Submitting-Bugs-and-Feature-Requests).\n\nThank you!\n\n\n\n\n\n\n\n\n\n\n## Trademark\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\n\nUse of these trademarks or logos must follow Microsoft's [Trademark & Brand\nGuidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general).\n\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n[initialize-devtools-docs]: https://fluidframework.com/docs/apis/devtools-core#initializedevtools-function\n[devtools-logger-docs]: https://fluidframework.com/docs/apis/devtools-core/devtoolslogger-class\n[devtools-package]: https://www.npmjs.com/package/@fluid-experimental/devtools\n[browser-extension]: https://github.com/microsoft/FluidFramework/tree/main/packages/tools/devtools/devtools-browser-extension\n","scripts":{"tsc":"tsc","lint":"npm run prettier && npm run eslint","test":"npm run test:mocha","build":"fluid-build . --task build","clean":"rimraf --glob '_api-extractor-temp' 'nyc' 'dist' 'lib' '*.tsbuildinfo' '*.build.log'","eslint":"eslint src","format":"npm run prettier:fix","rebuild":"npm run clean && npm run build","lint:fix":"npm run prettier:fix && npm run eslint:fix","prettier":"prettier --check . --ignore-path ../../../../.prettierignore","tsc:watch":"tsc --watch","build:docs":"api-extractor run --local && copyfiles -u 1 ./_api-extractor-temp/doc-models/* ../../../../_api-extractor-temp/","eslint:fix":"eslint src --fix","test:mocha":"mocha dist/**/*.test.js --exit","build:esnext":"tsc --project ./tsconfig.esnext.json","build:genver":"gen-version","prettier:fix":"prettier --write . --ignore-path ../../../../.prettierignore","build:compile":"fluid-build . --task compile","ci:build:docs":"api-extractor run && copyfiles -u 1 ./_api-extractor-temp/doc-models/* ../../../../_api-extractor-temp/","test:coverage":"c8 npm test","typetests:gen":"fluid-type-test-generator","build:commonjs":"fluid-build . --task commonjs","format-and-build":"npm run format && npm run build","typetests:prepare":"flub typetests --dir . --reset --previous --normalize","format-and-compile":"npm run format && npm run build:compile"},"_npmUser":{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},"_resolved":"/mnt/vss/_work/1/pack/scoped/fluid-experimental-devtools-core-2.0.0-internal.6.3.0.tgz","_integrity":"sha512-B/pVdKNgCzhLzuqFMv5EKL/WVbkquaBFo68aJWN8dZMULyoPXQwFG3nyooBpfPLU4Fud9mJq8BpJrNfuAxtJ9Q==","fluidBuild":{"tasks":{"tsc":["...","typetests:gen"]}},"repository":{"url":"git+https://github.com/microsoft/FluidFramework.git","type":"git","directory":"packages/tools/devtools/devtools-core"},"_npmVersion":"9.6.7","description":"Fluid Framework developer tools core functionality","directories":{},"sideEffects":false,"_nodeVersion":"18.17.1","dependencies":{"@fluidframework/map":">=2.0.0-internal.6.3.0 <2.0.0-internal.6.4.0","@fluidframework/cell":">=2.0.0-internal.6.3.0 <2.0.0-internal.6.4.0","@fluidframework/matrix":">=2.0.0-internal.6.3.0 <2.0.0-internal.6.4.0","@fluidframework/counter":">=2.0.0-internal.6.3.0 <2.0.0-internal.6.4.0","@fluidframework/sequence":">=2.0.0-internal.6.3.0 <2.0.0-internal.6.4.0","@fluid-experimental/tree2":">=2.0.0-internal.6.3.0 <2.0.0-internal.6.4.0","@fluid-internal/client-utils":">=2.0.0-internal.6.3.0 <2.0.0-internal.6.4.0","@fluidframework/core-interfaces":">=2.0.0-internal.6.3.0 <2.0.0-internal.6.4.0","@fluidframework/telemetry-utils":">=2.0.0-internal.6.3.0 <2.0.0-internal.6.4.0","@fluidframework/container-loader":">=2.0.0-internal.6.3.0 <2.0.0-internal.6.4.0","@fluidframework/shared-object-base":">=2.0.0-internal.6.3.0 <2.0.0-internal.6.4.0","@fluidframework/protocol-definitions":"^1.1.0","@fluidframework/container-definitions":">=2.0.0-internal.6.3.0 <2.0.0-internal.6.4.0","@fluidframework/datastore-definitions":">=2.0.0-internal.6.3.0 <2.0.0-internal.6.4.0"},"_hasShrinkwrap":false,"readmeFilename":"README.md","typeValidation":{"broken":{}},"devDependencies":{"c8":"^7.7.1","chai":"^4.2.0","mocha":"^10.2.0","eslint":"~8.6.0","events":"^3.1.0","moment":"^2.21.0","rimraf":"^4.4.0","prettier":"~2.6.2","copyfiles":"^2.4.1","cross-env":"^7.0.3","typescript":"~4.5.5","@types/chai":"^4.0.0","@types/mocha":"^9.1.1","@types/events":"^3.0.0","mocha-multi-reporters":"^1.5.1","@fluid-tools/build-cli":"^0.22.0","eslint-config-prettier":"~8.5.0","@microsoft/api-extractor":"^7.34.4","eslint-plugin-chai-expect":"~3.0.0","mocha-json-output-reporter":"^2.0.1","@fluidframework/build-tools":"^0.22.0","@fluidframework/build-common":"^2.0.0","@fluidframework/mocha-test-setup":">=2.0.0-internal.6.3.0 <2.0.0-internal.6.4.0","@fluidframework/driver-definitions":">=2.0.0-internal.6.3.0 <2.0.0-internal.6.4.0","@fluidframework/test-runtime-utils":">=2.0.0-internal.6.3.0 <2.0.0-internal.6.4.0","@fluidframework/eslint-config-fluid":"^2.1.0","@fluid-experimental/devtools-core-previous":"npm:@fluid-experimental/devtools-core@2.0.0-internal.6.1.1"},"_npmOperationalInternal":{"tmp":"tmp/devtools-core_2.0.0-internal.6.3.0_1694039835073_0.3721710679647865","host":"s3://npm-registry-packages"}},"2.0.0-internal.6.3.1":{"name":"@fluid-experimental/devtools-core","version":"2.0.0-internal.6.3.1","author":{"name":"Microsoft and contributors"},"license":"MIT","_id":"@fluid-experimental/devtools-core@2.0.0-internal.6.3.1","maintainers":[{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},{"name":"curtisman","email":"curtism@microsoft.com"}],"homepage":"https://fluidframework.com","bugs":{"url":"https://github.com/microsoft/FluidFramework/issues"},"c8":{"all":true,"exclude":["src/test/**/*.ts","dist/test/**/*.js"],"include":["src/**/*.ts","dist/**/*.js"],"reporter":["cobertura","html","text"],"cache-dir":"nyc/.cache","report-dir":"nyc/report","temp-directory":"nyc/.nyc_output","exclude-after-remap":false},"dist":{"shasum":"46f4e2170e0f053719569578b73c7ca7f24a1af5","tarball":"https://registry.npmjs.org/@fluid-experimental/devtools-core/-/devtools-core-2.0.0-internal.6.3.1.tgz","fileCount":501,"integrity":"sha512-Rskb4jsw2RohEfkzDWiXW0Ztp1m9yege/lg6Mx2djkiNXu0evfIulidV+eJA4nyOy8lZmFbWH/ayhvrvJDP0dA==","signatures":[{"sig":"MEYCIQD+C3qkbc5sPq+JA8EJuvniqhFO9UqOOfCGYxcheELVRQIhAO0YlugHEyauDIX/iELa9t4V+iNJyYvKfCamBmK8wUZc","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}],"unpackedSize":1368137},"main":"dist/index.js","_from":"file:fluid-experimental-devtools-core-2.0.0-internal.6.3.1.tgz","types":"dist/index.d.ts","module":"lib/index.js","readme":"# @fluid-experimental/devtools-core\n\nThis library contains developer tools for use alongside the Fluid Framework.\nIt is used to power our associated [browser extension][browser-extension].\n\n- Chrome: \n- Edge: \n\n\n\n\n\n\n## Installation\n\nTo get started, install the package by running the following command:\n\n```bash\nnpm i @fluid-experimental/devtools-core -D\n```\n\n\n\n\n\n## Usage\n\nThe Devtools' API surface is designed to fit nicely into most application flows.\n\n### Initialization\n\nTo initialize a devtools session for your container, call [`initializeDevtools`][initialize-devtools-docs].\nThis function accepts a `DevtoolsLogger` for receiving Fluid telemetry from your application, a list of initial Fluid\n`Containers` to associate with the session, and (optionally) customized data visualization configurations for visualizing\n`Container` data.\n\n#### About the [`DevtoolsLogger`][devtools-logger-docs]\n\nThe `DevtoolsLogger` is an optional piece when calling `initializeDevtools` but it is strongly recommended that you use\nit because several features in Fluid Devtools are powered by the telemetry that Fluid Framework generates, and this\nlogger is the way in which that telemetry gets into Fluid Devtools.\n\nYou can obtain a `DevtoolsLogger` by calling its constructor, and then should pass it to `initializeDevtools` _and_\nto the `Loader` instance you'll use to create/load Containers as shown below.\nThis way the logger will receive all the telemetry generated by Fluid Framework in your application, and forward it to\nFluid Devtools as necessary.\n\n```typescript\nimport { DevtoolsLogger, initializeDevtools } from \"@fluid-experimental/devtools-core\";\n\n// Instantiate the logger\nconst devtoolsLogger = new DevtoolsLogger();\n\n// Pass the logger when instantiating the Loader\nconst loader = new Loader({\n\tlogger: devtoolsLogger,\n\t// Other necessary properties ...\n});\n\n// Use the Loader to create (and optionally, attach) a Container\nconst container = await loader.createDetachedContainer(/* params */);\nawait container.attach(/* params */);\n\n// Initialize the Devtools passing the logger and your Container.\n// The Container could be added later as well with devtools.registerContainerDevtools().\nconst devtools = initializeDevtools({\n\tlogger: devtoolsLogger,\n\tinitialContainers: [\n\t\t{\n\t\t\tcontainer,\n\t\t\tcontainerKey: \"My Container\",\n\t\t},\n\t],\n});\n```\n\nIf you're working with `AzureClient` instead of lower-level APIs like the one described above, you probably want to\nrefer to the [@fluid-experimental/devtools package][devtools-package] instead of this one.\n\nDuring local development the recommendation is that your application should receive the `DevtoolsLogger` instance _instead_\nof any logger it would normally receive when deployed to a real environment, to avoid local development activity from\nmixing with real telemetry.\nIf you still want to provide a real application logger and use the Fluid Devtools features that are powered by telemetry\nat the same time, you can pass an existing logger to the `DevtoolsLogger` constructor and it will forward all telemetry\nit receives to that logger as well:\n\n```typescript\nimport { DevtoolsLogger } from \"@fluid-experimental/devtools-core\";\n\n// Your application's logger\nconst yourApplicationLogger = getInstanceOfYourApplicationLogger();\n\nconst devtoolsLogger = new DevtoolsLogger(yourApplicationLogger);\n\n// Pass devtoolsLogger to initializeDevtools() and to your application as described above\n```\n\n### Clean-up\n\nThe Devtools object is managed as a global singleton.\nThat singleton is automatically cleaned up prior to the Window's \"unload\" event.\nSo typical application flows likely won't need to worry about cleanup.\nThat said, if you wish to have tighter control over when the Devtools are torn down, you can simply call the `dispose` method on the handle returned by [initialization](#initialization).\n\n## Contributing to the package\n\n### Build\n\nTo build the package locally, first ensure you have run `pnpm install` from the root of the mono-repo.\nNext, to build the code, run `npm run build` from the root of the mono-repo, or use [fluid-build](https://github.com/microsoft/FluidFramework/tree/main/build-tools/packages/build-tools#running-fluid-build-command-line) via `fluid-build -t build`.\n\n- Note: Once you have run a build from the root, assuming no other changes outside of this package, you may run `npm run build` directly within this directory for a faster build.\n If you make changes to any of this package's local dependencies, you will need to run a build again from the root before building again from directly within this package.\n\n### Test\n\nTo run the tests, first ensure you have followed the [build](#build) steps above.\nNext, run `npm run test` from a terminal within this directory.\n\n\n\n\n\n\n\n## API Documentation\n\nAPI documentation for **@fluid-experimental/devtools-core** is available at .\n\n\n\n\n\n\n\n\n\n\n## Contribution Guidelines\n\nThere are many ways to [contribute](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md) to Fluid.\n\n- Participate in Q&A in our [GitHub Discussions](https://github.com/microsoft/FluidFramework/discussions).\n- [Submit bugs](https://github.com/microsoft/FluidFramework/issues) and help us verify fixes as they are checked in.\n- Review the [source code changes](https://github.com/microsoft/FluidFramework/pulls).\n- [Contribute bug fixes](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md).\n\nDetailed instructions for working in the repo can be found in the [Wiki](https://github.com/microsoft/FluidFramework/wiki).\n\nThis project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).\nFor more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\nUse of these trademarks or logos must follow Microsoft’s [Trademark & Brand Guidelines](https://www.microsoft.com/trademarks).\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n\n\n\n## Help\n\nNot finding what you're looking for in this README? Check out our [GitHub\nWiki](https://github.com/microsoft/FluidFramework/wiki) or [fluidframework.com](https://fluidframework.com/docs/).\n\nStill not finding what you're looking for? Please [file an\nissue](https://github.com/microsoft/FluidFramework/wiki/Submitting-Bugs-and-Feature-Requests).\n\nThank you!\n\n\n\n\n\n\n\n\n\n\n## Trademark\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\n\nUse of these trademarks or logos must follow Microsoft's [Trademark & Brand\nGuidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general).\n\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n[initialize-devtools-docs]: https://fluidframework.com/docs/apis/devtools-core#initializedevtools-function\n[devtools-logger-docs]: https://fluidframework.com/docs/apis/devtools-core/devtoolslogger-class\n[devtools-package]: https://www.npmjs.com/package/@fluid-experimental/devtools\n[browser-extension]: https://github.com/microsoft/FluidFramework/tree/main/packages/tools/devtools/devtools-browser-extension\n","scripts":{"tsc":"tsc","lint":"npm run prettier && npm run eslint","test":"npm run test:mocha","build":"fluid-build . --task build","clean":"rimraf --glob '_api-extractor-temp' 'nyc' 'dist' 'lib' '*.tsbuildinfo' '*.build.log'","eslint":"eslint src","format":"npm run prettier:fix","rebuild":"npm run clean && npm run build","lint:fix":"npm run prettier:fix && npm run eslint:fix","prettier":"prettier --check . --ignore-path ../../../../.prettierignore","tsc:watch":"tsc --watch","build:docs":"api-extractor run --local && copyfiles -u 1 ./_api-extractor-temp/doc-models/* ../../../../_api-extractor-temp/","eslint:fix":"eslint src --fix","test:mocha":"mocha dist/**/*.test.js --exit","build:esnext":"tsc --project ./tsconfig.esnext.json","build:genver":"gen-version","prettier:fix":"prettier --write . --ignore-path ../../../../.prettierignore","build:compile":"fluid-build . --task compile","ci:build:docs":"api-extractor run && copyfiles -u 1 ./_api-extractor-temp/doc-models/* ../../../../_api-extractor-temp/","test:coverage":"c8 npm test","typetests:gen":"fluid-type-test-generator","build:commonjs":"fluid-build . --task commonjs","format-and-build":"npm run format && npm run build","typetests:prepare":"flub typetests --dir . --reset --previous --normalize","format-and-compile":"npm run format && npm run build:compile"},"_npmUser":{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},"_resolved":"/mnt/vss/_work/1/pack/scoped/fluid-experimental-devtools-core-2.0.0-internal.6.3.1.tgz","_integrity":"sha512-Rskb4jsw2RohEfkzDWiXW0Ztp1m9yege/lg6Mx2djkiNXu0evfIulidV+eJA4nyOy8lZmFbWH/ayhvrvJDP0dA==","fluidBuild":{"tasks":{"tsc":["...","typetests:gen"]}},"repository":{"url":"git+https://github.com/microsoft/FluidFramework.git","type":"git","directory":"packages/tools/devtools/devtools-core"},"_npmVersion":"9.6.7","description":"Fluid Framework developer tools core functionality","directories":{},"sideEffects":false,"_nodeVersion":"18.17.1","dependencies":{"@fluidframework/map":">=2.0.0-internal.6.3.1 <2.0.0-internal.6.4.0","@fluidframework/cell":">=2.0.0-internal.6.3.1 <2.0.0-internal.6.4.0","@fluidframework/matrix":">=2.0.0-internal.6.3.1 <2.0.0-internal.6.4.0","@fluidframework/counter":">=2.0.0-internal.6.3.1 <2.0.0-internal.6.4.0","@fluidframework/sequence":">=2.0.0-internal.6.3.1 <2.0.0-internal.6.4.0","@fluid-experimental/tree2":">=2.0.0-internal.6.3.1 <2.0.0-internal.6.4.0","@fluid-internal/client-utils":">=2.0.0-internal.6.3.1 <2.0.0-internal.6.4.0","@fluidframework/core-interfaces":">=2.0.0-internal.6.3.1 <2.0.0-internal.6.4.0","@fluidframework/telemetry-utils":">=2.0.0-internal.6.3.1 <2.0.0-internal.6.4.0","@fluidframework/container-loader":">=2.0.0-internal.6.3.1 <2.0.0-internal.6.4.0","@fluidframework/shared-object-base":">=2.0.0-internal.6.3.1 <2.0.0-internal.6.4.0","@fluidframework/protocol-definitions":"^1.1.0","@fluidframework/container-definitions":">=2.0.0-internal.6.3.1 <2.0.0-internal.6.4.0","@fluidframework/datastore-definitions":">=2.0.0-internal.6.3.1 <2.0.0-internal.6.4.0"},"_hasShrinkwrap":false,"readmeFilename":"README.md","typeValidation":{"broken":{}},"devDependencies":{"c8":"^7.7.1","chai":"^4.2.0","mocha":"^10.2.0","eslint":"~8.6.0","events":"^3.1.0","moment":"^2.21.0","rimraf":"^4.4.0","prettier":"~2.6.2","copyfiles":"^2.4.1","cross-env":"^7.0.3","typescript":"~4.5.5","@types/chai":"^4.0.0","@types/mocha":"^9.1.1","@types/events":"^3.0.0","mocha-multi-reporters":"^1.5.1","@fluid-tools/build-cli":"^0.22.0","eslint-config-prettier":"~8.5.0","@microsoft/api-extractor":"^7.34.4","eslint-plugin-chai-expect":"~3.0.0","mocha-json-output-reporter":"^2.0.1","@fluidframework/build-tools":"^0.22.0","@fluidframework/build-common":"^2.0.0","@fluidframework/mocha-test-setup":">=2.0.0-internal.6.3.1 <2.0.0-internal.6.4.0","@fluidframework/driver-definitions":">=2.0.0-internal.6.3.1 <2.0.0-internal.6.4.0","@fluidframework/test-runtime-utils":">=2.0.0-internal.6.3.1 <2.0.0-internal.6.4.0","@fluidframework/eslint-config-fluid":"^2.1.0","@fluid-experimental/devtools-core-previous":"npm:@fluid-experimental/devtools-core@2.0.0-internal.6.1.1"},"_npmOperationalInternal":{"tmp":"tmp/devtools-core_2.0.0-internal.6.3.1_1694116675925_0.7115472536018219","host":"s3://npm-registry-packages"}},"2.0.0-internal.6.0.2":{"name":"@fluid-experimental/devtools-core","version":"2.0.0-internal.6.0.2","author":{"name":"Microsoft and contributors"},"license":"MIT","_id":"@fluid-experimental/devtools-core@2.0.0-internal.6.0.2","maintainers":[{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},{"name":"curtisman","email":"curtism@microsoft.com"}],"homepage":"https://fluidframework.com","bugs":{"url":"https://github.com/microsoft/FluidFramework/issues"},"nyc":{"all":true,"exclude":["src/test/**/*.ts","dist/test/**/*.js"],"include":["src/**/*.ts","dist/**/*.js"],"reporter":["cobertura","html","text"],"cache-dir":"nyc/.cache","report-dir":"nyc/report","temp-directory":"nyc/.nyc_output","exclude-after-remap":false},"dist":{"shasum":"84b6dbf9179551605a5ec4db09c1dd677acf720d","tarball":"https://registry.npmjs.org/@fluid-experimental/devtools-core/-/devtools-core-2.0.0-internal.6.0.2.tgz","fileCount":501,"integrity":"sha512-b4sgfqQXOFqr5YX5e43rUnqt0og6/p8ImophFX/Qx35bV5CThou3jYhQGhyMvEOzx2NEE7YA0r/I0jUGJS3A0g==","signatures":[{"sig":"MEUCIQDXfxZQSyujuPevhYeQ34A1uS5336ngb7t/bZYbSUCmEAIgZFtdkZcIOEH/Sk2WjoooRTpt6e79rwfzRuI5kZt6SB8=","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}],"unpackedSize":1347878},"main":"dist/index.js","_from":"file:fluid-experimental-devtools-core-2.0.0-internal.6.0.2.tgz","types":"dist/index.d.ts","readme":"# @fluid-experimental/devtools-core\n\nThis library contains developer tools for use alongside the Fluid Framework.\nIt is used to power our associated [browser extension][browser-extension].\n\n- Chrome: \n- Edge: \n\n\n\n\n\n\n## Installation\n\nTo get started, install the package by running the following command:\n\n```bash\nnpm i @fluid-experimental/devtools-core -D\n```\n\n\n\n\n\n## Usage\n\nThe Devtools' API surface is designed to fit nicely into most application flows.\n\n### Initialization\n\nTo initialize a devtools session for your container, call [`initializeDevtools`][initialize-devtools-docs].\nThis function accepts a `DevtoolsLogger` for receiving Fluid telemetry from your application, a list of initial Fluid\n`Containers` to associate with the session, and (optionally) customized data visualization configurations for visualizing\n`Container` data.\n\n#### About the [`DevtoolsLogger`][devtools-logger-docs]\n\nThe `DevtoolsLogger` is an optional piece when calling `initializeDevtools` but it is strongly recommended that you use\nit because several features in Fluid Devtools are powered by the telemetry that Fluid Framework generates, and this\nlogger is the way in which that telemetry gets into Fluid Devtools.\n\nYou can obtain a `DevtoolsLogger` by calling its constructor, and then should pass it to `initializeDevtools` _and_\nto the `Loader` instance you'll use to create/load Containers as shown below.\nThis way the logger will receive all the telemetry generated by Fluid Framework in your application, and forward it to\nFluid Devtools as necessary.\n\n```typescript\nimport { DevtoolsLogger, initializeDevtools } from \"@fluid-experimental/devtools-core\";\n\n// Instantiate the logger\nconst devtoolsLogger = new DevtoolsLogger();\n\n// Pass the logger when instantiating the Loader\nconst loader = new Loader({\n\tlogger: devtoolsLogger,\n\t// Other necessary properties ...\n});\n\n// Use the Loader to create (and optionally, attach) a Container\nconst container = await loader.createDetachedContainer(/* params */);\nawait container.attach(/* params */);\n\n// Initialize the Devtools passing the logger and your Container.\n// The Container could be added later as well with devtools.registerContainerDevtools().\nconst devtools = initializeDevtools({\n\tlogger: devtoolsLogger,\n\tinitialContainers: [\n\t\t{\n\t\t\tcontainer,\n\t\t\tcontainerKey: \"My Container\",\n\t\t},\n\t],\n});\n```\n\nIf you're working with `AzureClient` instead of lower-level APIs like the one described above, you probably want to\nrefer to the [@fluid-experimental/devtools package][devtools-package] instead of this one.\n\nDuring local development the recommendation is that your application should receive the `DevtoolsLogger` instance _instead_\nof any logger it would normally receive when deployed to a real environment, to avoid local development activity from\nmixing with real telemetry.\nIf you still want to provide a real application logger and use the Fluid Devtools features that are powered by telemetry\nat the same time, you can pass an existing logger to the `DevtoolsLogger` constructor and it will forward all telemetry\nit receives to that logger as well:\n\n```typescript\nimport { DevtoolsLogger } from \"@fluid-experimental/devtools-core\";\n\n// Your application's logger\nconst yourApplicationLogger = getInstanceOfYourApplicationLogger();\n\nconst devtoolsLogger = new DevtoolsLogger(yourApplicationLogger);\n\n// Pass devtoolsLogger to initializeDevtools() and to your application as described above\n```\n\n### Clean-up\n\nThe Devtools object is managed as a global singleton.\nThat singleton is automatically cleaned up prior to the Window's \"unload\" event.\nSo typical application flows likely won't need to worry about cleanup.\nThat said, if you wish to have tighter control over when the Devtools are torn down, you can simply call the `dispose` method on the handle returned by [initialization](#initialization).\n\n## Contributing to the package\n\n### Build\n\nTo build the package locally, first ensure you have run `pnpm install` from the root of the mono-repo.\nNext, to build the code, run `npm run build` from the root of the mono-repo, or use [fluid-build](https://github.com/microsoft/FluidFramework/tree/main/build-tools/packages/build-tools#running-fluid-build-command-line) via `fluid-build -t build`.\n\n- Note: Once you have run a build from the root, assuming no other changes outside of this package, you may run `npm run build` directly within this directory for a faster build.\n If you make changes to any of this package's local dependencies, you will need to run a build again from the root before building again from directly within this package.\n\n### Test\n\nTo run the tests, first ensure you have followed the [build](#build) steps above.\nNext, run `npm run test` from a terminal within this directory.\n\n\n\n\n\n\n\n## API Documentation\n\nAPI documentation for **@fluid-experimental/devtools-core** is available at .\n\n\n\n\n\n\n\n\n\n\n## Contribution Guidelines\n\nThere are many ways to [contribute](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md) to Fluid.\n\n- Participate in Q&A in our [GitHub Discussions](https://github.com/microsoft/FluidFramework/discussions).\n- [Submit bugs](https://github.com/microsoft/FluidFramework/issues) and help us verify fixes as they are checked in.\n- Review the [source code changes](https://github.com/microsoft/FluidFramework/pulls).\n- [Contribute bug fixes](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md).\n\nDetailed instructions for working in the repo can be found in the [Wiki](https://github.com/microsoft/FluidFramework/wiki).\n\nThis project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).\nFor more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\nUse of these trademarks or logos must follow Microsoft’s [Trademark & Brand Guidelines](https://www.microsoft.com/trademarks).\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n\n\n\n## Help\n\nNot finding what you're looking for in this README? Check out our [GitHub\nWiki](https://github.com/microsoft/FluidFramework/wiki) or [fluidframework.com](https://fluidframework.com/docs/).\n\nStill not finding what you're looking for? Please [file an\nissue](https://github.com/microsoft/FluidFramework/wiki/Submitting-Bugs-and-Feature-Requests).\n\nThank you!\n\n\n\n\n\n\n\n\n\n\n## Trademark\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\n\nUse of these trademarks or logos must follow Microsoft's [Trademark & Brand\nGuidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general).\n\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n[initialize-devtools-docs]: https://fluidframework.com/docs/apis/devtools-core#initializedevtools-function\n[devtools-logger-docs]: https://fluidframework.com/docs/apis/devtools-core/devtoolslogger-class\n[devtools-package]: https://www.npmjs.com/package/@fluid-experimental/devtools\n[browser-extension]: https://github.com/microsoft/FluidFramework/tree/main/packages/tools/devtools/devtools-browser-extension\n","scripts":{"tsc":"tsc","lint":"npm run prettier && npm run eslint","test":"npm run test:mocha","build":"fluid-build . --task build","clean":"rimraf --glob \"_api-extractor-temp\" \"nyc\" \"dist\" \"lib\" \"*.tsbuildinfo\" \"*.build.log\"","eslint":"eslint src","format":"npm run prettier:fix","rebuild":"npm run clean && npm run build","lint:fix":"npm run prettier:fix && npm run eslint:fix","prettier":"prettier --check . --ignore-path ../../../../.prettierignore","build:docs":"api-extractor run --local && copyfiles -u 1 ./_api-extractor-temp/doc-models/* ../../../../_api-extractor-temp/","eslint:fix":"eslint src --fix","test:mocha":"mocha dist/**/*.test.js --unhandled-rejections=strict --exit","build:esnext":"tsc --project ./tsconfig.esnext.json","build:genver":"gen-version","prettier:fix":"prettier --write . --ignore-path ../../../../.prettierignore","build:compile":"fluid-build . --task compile","ci:build:docs":"api-extractor run && copyfiles -u 1 ./_api-extractor-temp/doc-models/* ../../../../_api-extractor-temp/","test:coverage":"npm run test:mocha:coverage","typetests:gen":"fluid-type-test-generator","build:commonjs":"fluid-build . --task commonjs","format-and-build":"npm run format && npm run build","typetests:prepare":"flub typetests --dir . --reset --previous --normalize","format-and-compile":"npm run format && npm run build:compile","test:mocha:coverage":"nyc npm run test:mocha -- --reporter xunit --reporter-option output=nyc/junit-report.xml","test:mocha:multireport":"cross-env FLUID_TEST_MULTIREPORT=1 npm run test:mocha"},"_npmUser":{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},"_resolved":"/mnt/vss/_work/1/pack/scoped/fluid-experimental-devtools-core-2.0.0-internal.6.0.2.tgz","_integrity":"sha512-b4sgfqQXOFqr5YX5e43rUnqt0og6/p8ImophFX/Qx35bV5CThou3jYhQGhyMvEOzx2NEE7YA0r/I0jUGJS3A0g==","fluidBuild":{"tasks":{"tsc":["...","typetests:gen"]}},"repository":{"url":"git+https://github.com/microsoft/FluidFramework.git","type":"git","directory":"packages/tools/devtools/devtools-core"},"_npmVersion":"8.11.0","description":"Fluid Framework developer tools core functionality","directories":{},"sideEffects":false,"_nodeVersion":"16.16.0","dependencies":{"@fluidframework/map":">=2.0.0-internal.6.0.2 <2.0.0-internal.6.1.0","@fluidframework/cell":">=2.0.0-internal.6.0.2 <2.0.0-internal.6.1.0","@fluidframework/matrix":">=2.0.0-internal.6.0.2 <2.0.0-internal.6.1.0","@fluidframework/counter":">=2.0.0-internal.6.0.2 <2.0.0-internal.6.1.0","@fluidframework/sequence":">=2.0.0-internal.6.0.2 <2.0.0-internal.6.1.0","@fluid-experimental/tree2":">=2.0.0-internal.6.0.2 <2.0.0-internal.6.1.0","@fluidframework/common-utils":"^1.1.1","@fluidframework/container-utils":">=2.0.0-internal.6.0.2 <2.0.0-internal.6.1.0","@fluidframework/core-interfaces":">=2.0.0-internal.6.0.2 <2.0.0-internal.6.1.0","@fluidframework/container-loader":">=2.0.0-internal.6.0.2 <2.0.0-internal.6.1.0","@fluidframework/common-definitions":"^0.20.1","@fluidframework/shared-object-base":">=2.0.0-internal.6.0.2 <2.0.0-internal.6.1.0","@fluidframework/protocol-definitions":"^1.1.0","@fluidframework/container-definitions":">=2.0.0-internal.6.0.2 <2.0.0-internal.6.1.0","@fluidframework/datastore-definitions":">=2.0.0-internal.6.0.2 <2.0.0-internal.6.1.0"},"_hasShrinkwrap":false,"readmeFilename":"README.md","typeValidation":{"broken":{}},"devDependencies":{"nyc":"^15.1.0","chai":"^4.2.0","mocha":"^10.2.0","eslint":"~8.6.0","events":"^3.1.0","moment":"^2.21.0","rimraf":"^4.4.0","prettier":"~2.6.2","copyfiles":"^2.4.1","cross-env":"^7.0.3","typescript":"~4.5.5","@types/chai":"^4.0.0","@types/mocha":"^9.1.1","concurrently":"^7.6.0","@types/events":"^3.0.0","mocha-multi-reporters":"^1.5.1","@fluid-tools/build-cli":"^0.21.0","eslint-config-prettier":"~8.5.0","@microsoft/api-extractor":"^7.34.4","eslint-plugin-chai-expect":"~3.0.0","mocha-json-output-reporter":"^2.0.1","@fluidframework/build-tools":"^0.21.0","@fluidframework/build-common":"^2.0.0","@fluidframework/telemetry-utils":">=2.0.0-internal.6.0.2 <2.0.0-internal.6.1.0","@fluidframework/mocha-test-setup":">=2.0.0-internal.6.0.2 <2.0.0-internal.6.1.0","@fluidframework/driver-definitions":">=2.0.0-internal.6.0.2 <2.0.0-internal.6.1.0","@fluidframework/test-runtime-utils":">=2.0.0-internal.6.0.2 <2.0.0-internal.6.1.0","@fluidframework/eslint-config-fluid":"^2.0.0","@fluid-experimental/devtools-core-previous":"npm:@fluid-experimental/devtools-core@2.0.0-internal.6.0.0"},"_npmOperationalInternal":{"tmp":"tmp/devtools-core_2.0.0-internal.6.0.2_1694134742420_0.055628261991337524","host":"s3://npm-registry-packages"}},"2.0.0-internal.6.3.2":{"name":"@fluid-experimental/devtools-core","version":"2.0.0-internal.6.3.2","author":{"name":"Microsoft and contributors"},"license":"MIT","_id":"@fluid-experimental/devtools-core@2.0.0-internal.6.3.2","maintainers":[{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},{"name":"curtisman","email":"curtism@microsoft.com"}],"homepage":"https://fluidframework.com","bugs":{"url":"https://github.com/microsoft/FluidFramework/issues"},"c8":{"all":true,"exclude":["src/test/**/*.ts","dist/test/**/*.js"],"include":["src/**/*.ts","dist/**/*.js"],"reporter":["cobertura","html","text"],"cache-dir":"nyc/.cache","report-dir":"nyc/report","temp-directory":"nyc/.nyc_output","exclude-after-remap":false},"dist":{"shasum":"2d04190df6eee2174e84c4f4f35dfb69e662434f","tarball":"https://registry.npmjs.org/@fluid-experimental/devtools-core/-/devtools-core-2.0.0-internal.6.3.2.tgz","fileCount":501,"integrity":"sha512-VCmsQuQxTCD1FReukhEuGwO9uXnRaiId2v9xLL5DMVnHdt6HWCv0ifEwSfhOox/rskF+OFFTlVdO3OkuHYZnHA==","signatures":[{"sig":"MEQCIF9vuB9/Zu7tD4pV/Dj5LaGDOOf/vklNVufQYo3GZ9utAiBgGPkD7yGItPzlLw+TqWlamOp4DuMh0FcI0q+WOOqTrw==","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}],"unpackedSize":1368137},"main":"dist/index.js","_from":"file:fluid-experimental-devtools-core-2.0.0-internal.6.3.2.tgz","types":"dist/index.d.ts","module":"lib/index.js","readme":"# @fluid-experimental/devtools-core\n\nThis library contains developer tools for use alongside the Fluid Framework.\nIt is used to power our associated [browser extension][browser-extension].\n\n- Chrome: \n- Edge: \n\n\n\n\n\n\n## Installation\n\nTo get started, install the package by running the following command:\n\n```bash\nnpm i @fluid-experimental/devtools-core -D\n```\n\n\n\n\n\n## Usage\n\nThe Devtools' API surface is designed to fit nicely into most application flows.\n\n### Initialization\n\nTo initialize a devtools session for your container, call [`initializeDevtools`][initialize-devtools-docs].\nThis function accepts a `DevtoolsLogger` for receiving Fluid telemetry from your application, a list of initial Fluid\n`Containers` to associate with the session, and (optionally) customized data visualization configurations for visualizing\n`Container` data.\n\n#### About the [`DevtoolsLogger`][devtools-logger-docs]\n\nThe `DevtoolsLogger` is an optional piece when calling `initializeDevtools` but it is strongly recommended that you use\nit because several features in Fluid Devtools are powered by the telemetry that Fluid Framework generates, and this\nlogger is the way in which that telemetry gets into Fluid Devtools.\n\nYou can obtain a `DevtoolsLogger` by calling its constructor, and then should pass it to `initializeDevtools` _and_\nto the `Loader` instance you'll use to create/load Containers as shown below.\nThis way the logger will receive all the telemetry generated by Fluid Framework in your application, and forward it to\nFluid Devtools as necessary.\n\n```typescript\nimport { DevtoolsLogger, initializeDevtools } from \"@fluid-experimental/devtools-core\";\n\n// Instantiate the logger\nconst devtoolsLogger = new DevtoolsLogger();\n\n// Pass the logger when instantiating the Loader\nconst loader = new Loader({\n\tlogger: devtoolsLogger,\n\t// Other necessary properties ...\n});\n\n// Use the Loader to create (and optionally, attach) a Container\nconst container = await loader.createDetachedContainer(/* params */);\nawait container.attach(/* params */);\n\n// Initialize the Devtools passing the logger and your Container.\n// The Container could be added later as well with devtools.registerContainerDevtools().\nconst devtools = initializeDevtools({\n\tlogger: devtoolsLogger,\n\tinitialContainers: [\n\t\t{\n\t\t\tcontainer,\n\t\t\tcontainerKey: \"My Container\",\n\t\t},\n\t],\n});\n```\n\nIf you're working with `AzureClient` instead of lower-level APIs like the one described above, you probably want to\nrefer to the [@fluid-experimental/devtools package][devtools-package] instead of this one.\n\nDuring local development the recommendation is that your application should receive the `DevtoolsLogger` instance _instead_\nof any logger it would normally receive when deployed to a real environment, to avoid local development activity from\nmixing with real telemetry.\nIf you still want to provide a real application logger and use the Fluid Devtools features that are powered by telemetry\nat the same time, you can pass an existing logger to the `DevtoolsLogger` constructor and it will forward all telemetry\nit receives to that logger as well:\n\n```typescript\nimport { DevtoolsLogger } from \"@fluid-experimental/devtools-core\";\n\n// Your application's logger\nconst yourApplicationLogger = getInstanceOfYourApplicationLogger();\n\nconst devtoolsLogger = new DevtoolsLogger(yourApplicationLogger);\n\n// Pass devtoolsLogger to initializeDevtools() and to your application as described above\n```\n\n### Clean-up\n\nThe Devtools object is managed as a global singleton.\nThat singleton is automatically cleaned up prior to the Window's \"unload\" event.\nSo typical application flows likely won't need to worry about cleanup.\nThat said, if you wish to have tighter control over when the Devtools are torn down, you can simply call the `dispose` method on the handle returned by [initialization](#initialization).\n\n## Contributing to the package\n\n### Build\n\nTo build the package locally, first ensure you have run `pnpm install` from the root of the mono-repo.\nNext, to build the code, run `npm run build` from the root of the mono-repo, or use [fluid-build](https://github.com/microsoft/FluidFramework/tree/main/build-tools/packages/build-tools#running-fluid-build-command-line) via `fluid-build -t build`.\n\n- Note: Once you have run a build from the root, assuming no other changes outside of this package, you may run `npm run build` directly within this directory for a faster build.\n If you make changes to any of this package's local dependencies, you will need to run a build again from the root before building again from directly within this package.\n\n### Test\n\nTo run the tests, first ensure you have followed the [build](#build) steps above.\nNext, run `npm run test` from a terminal within this directory.\n\n\n\n\n\n\n\n## API Documentation\n\nAPI documentation for **@fluid-experimental/devtools-core** is available at .\n\n\n\n\n\n\n\n\n\n\n## Contribution Guidelines\n\nThere are many ways to [contribute](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md) to Fluid.\n\n- Participate in Q&A in our [GitHub Discussions](https://github.com/microsoft/FluidFramework/discussions).\n- [Submit bugs](https://github.com/microsoft/FluidFramework/issues) and help us verify fixes as they are checked in.\n- Review the [source code changes](https://github.com/microsoft/FluidFramework/pulls).\n- [Contribute bug fixes](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md).\n\nDetailed instructions for working in the repo can be found in the [Wiki](https://github.com/microsoft/FluidFramework/wiki).\n\nThis project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).\nFor more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\nUse of these trademarks or logos must follow Microsoft’s [Trademark & Brand Guidelines](https://www.microsoft.com/trademarks).\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n\n\n\n## Help\n\nNot finding what you're looking for in this README? Check out our [GitHub\nWiki](https://github.com/microsoft/FluidFramework/wiki) or [fluidframework.com](https://fluidframework.com/docs/).\n\nStill not finding what you're looking for? Please [file an\nissue](https://github.com/microsoft/FluidFramework/wiki/Submitting-Bugs-and-Feature-Requests).\n\nThank you!\n\n\n\n\n\n\n\n\n\n\n## Trademark\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\n\nUse of these trademarks or logos must follow Microsoft's [Trademark & Brand\nGuidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general).\n\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n[initialize-devtools-docs]: https://fluidframework.com/docs/apis/devtools-core#initializedevtools-function\n[devtools-logger-docs]: https://fluidframework.com/docs/apis/devtools-core/devtoolslogger-class\n[devtools-package]: https://www.npmjs.com/package/@fluid-experimental/devtools\n[browser-extension]: https://github.com/microsoft/FluidFramework/tree/main/packages/tools/devtools/devtools-browser-extension\n","scripts":{"tsc":"tsc","lint":"npm run prettier && npm run eslint","test":"npm run test:mocha","build":"fluid-build . --task build","clean":"rimraf --glob '_api-extractor-temp' 'nyc' 'dist' 'lib' '*.tsbuildinfo' '*.build.log'","eslint":"eslint src","format":"npm run prettier:fix","rebuild":"npm run clean && npm run build","lint:fix":"npm run prettier:fix && npm run eslint:fix","prettier":"prettier --check . --ignore-path ../../../../.prettierignore","tsc:watch":"tsc --watch","build:docs":"api-extractor run --local && copyfiles -u 1 ./_api-extractor-temp/doc-models/* ../../../../_api-extractor-temp/","eslint:fix":"eslint src --fix","test:mocha":"mocha dist/**/*.test.js --exit","build:esnext":"tsc --project ./tsconfig.esnext.json","build:genver":"gen-version","prettier:fix":"prettier --write . --ignore-path ../../../../.prettierignore","build:compile":"fluid-build . --task compile","ci:build:docs":"api-extractor run && copyfiles -u 1 ./_api-extractor-temp/doc-models/* ../../../../_api-extractor-temp/","test:coverage":"c8 npm test","typetests:gen":"fluid-type-test-generator","build:commonjs":"fluid-build . --task commonjs","format-and-build":"npm run format && npm run build","typetests:prepare":"flub typetests --dir . --reset --previous --normalize","format-and-compile":"npm run format && npm run build:compile"},"_npmUser":{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},"_resolved":"/mnt/vss/_work/1/pack/scoped/fluid-experimental-devtools-core-2.0.0-internal.6.3.2.tgz","_integrity":"sha512-VCmsQuQxTCD1FReukhEuGwO9uXnRaiId2v9xLL5DMVnHdt6HWCv0ifEwSfhOox/rskF+OFFTlVdO3OkuHYZnHA==","fluidBuild":{"tasks":{"tsc":["...","typetests:gen"]}},"repository":{"url":"git+https://github.com/microsoft/FluidFramework.git","type":"git","directory":"packages/tools/devtools/devtools-core"},"_npmVersion":"9.6.7","description":"Fluid Framework developer tools core functionality","directories":{},"sideEffects":false,"_nodeVersion":"18.17.1","dependencies":{"@fluidframework/map":">=2.0.0-internal.6.3.2 <2.0.0-internal.6.4.0","@fluidframework/cell":">=2.0.0-internal.6.3.2 <2.0.0-internal.6.4.0","@fluidframework/matrix":">=2.0.0-internal.6.3.2 <2.0.0-internal.6.4.0","@fluidframework/counter":">=2.0.0-internal.6.3.2 <2.0.0-internal.6.4.0","@fluidframework/sequence":">=2.0.0-internal.6.3.2 <2.0.0-internal.6.4.0","@fluid-experimental/tree2":">=2.0.0-internal.6.3.2 <2.0.0-internal.6.4.0","@fluid-internal/client-utils":">=2.0.0-internal.6.3.2 <2.0.0-internal.6.4.0","@fluidframework/core-interfaces":">=2.0.0-internal.6.3.2 <2.0.0-internal.6.4.0","@fluidframework/telemetry-utils":">=2.0.0-internal.6.3.2 <2.0.0-internal.6.4.0","@fluidframework/container-loader":">=2.0.0-internal.6.3.2 <2.0.0-internal.6.4.0","@fluidframework/shared-object-base":">=2.0.0-internal.6.3.2 <2.0.0-internal.6.4.0","@fluidframework/protocol-definitions":"^1.1.0","@fluidframework/container-definitions":">=2.0.0-internal.6.3.2 <2.0.0-internal.6.4.0","@fluidframework/datastore-definitions":">=2.0.0-internal.6.3.2 <2.0.0-internal.6.4.0"},"_hasShrinkwrap":false,"readmeFilename":"README.md","typeValidation":{"broken":{}},"devDependencies":{"c8":"^7.7.1","chai":"^4.2.0","mocha":"^10.2.0","eslint":"~8.6.0","events":"^3.1.0","moment":"^2.21.0","rimraf":"^4.4.0","prettier":"~2.6.2","copyfiles":"^2.4.1","cross-env":"^7.0.3","typescript":"~4.5.5","@types/chai":"^4.0.0","@types/mocha":"^9.1.1","@types/events":"^3.0.0","mocha-multi-reporters":"^1.5.1","@fluid-tools/build-cli":"^0.22.0","eslint-config-prettier":"~8.5.0","@microsoft/api-extractor":"^7.34.4","eslint-plugin-chai-expect":"~3.0.0","mocha-json-output-reporter":"^2.0.1","@fluidframework/build-tools":"^0.22.0","@fluidframework/build-common":"^2.0.0","@fluidframework/mocha-test-setup":">=2.0.0-internal.6.3.2 <2.0.0-internal.6.4.0","@fluidframework/driver-definitions":">=2.0.0-internal.6.3.2 <2.0.0-internal.6.4.0","@fluidframework/test-runtime-utils":">=2.0.0-internal.6.3.2 <2.0.0-internal.6.4.0","@fluidframework/eslint-config-fluid":"^2.1.0","@fluid-experimental/devtools-core-previous":"npm:@fluid-experimental/devtools-core@2.0.0-internal.6.3.1"},"_npmOperationalInternal":{"tmp":"tmp/devtools-core_2.0.0-internal.6.3.2_1694213226312_0.924124190721447","host":"s3://npm-registry-packages"}},"2.0.0-internal.6.1.2":{"name":"@fluid-experimental/devtools-core","version":"2.0.0-internal.6.1.2","author":{"name":"Microsoft and contributors"},"license":"MIT","_id":"@fluid-experimental/devtools-core@2.0.0-internal.6.1.2","maintainers":[{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},{"name":"curtisman","email":"curtism@microsoft.com"}],"homepage":"https://fluidframework.com","bugs":{"url":"https://github.com/microsoft/FluidFramework/issues"},"nyc":{"all":true,"exclude":["src/test/**/*.ts","dist/test/**/*.js"],"include":["src/**/*.ts","dist/**/*.js"],"reporter":["cobertura","html","text"],"cache-dir":"nyc/.cache","report-dir":"nyc/report","temp-directory":"nyc/.nyc_output","exclude-after-remap":false},"dist":{"shasum":"d416df0e3d225f46b2c36088a1b6faac0d7b525f","tarball":"https://registry.npmjs.org/@fluid-experimental/devtools-core/-/devtools-core-2.0.0-internal.6.1.2.tgz","fileCount":501,"integrity":"sha512-m8Zvl+7Yyo1RY3fK0X69WKDdSTJjMv7MkcphtHaAuZ1n9fDh+e//5uGK66QwuF+B3qIPEqGzS+iB6dss8rTjRw==","signatures":[{"sig":"MEUCIHBYGQPQ9b1YkNsjYQ9GGfvYSB56Udt/AMGk8jEMoOJ0AiEA29FI8RC/jaO+HegEi9X6s9jxey0dX/U8uqc53zjZr2w=","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}],"unpackedSize":1363083},"main":"dist/index.js","_from":"file:fluid-experimental-devtools-core-2.0.0-internal.6.1.2.tgz","types":"dist/index.d.ts","readme":"# @fluid-experimental/devtools-core\n\nThis library contains developer tools for use alongside the Fluid Framework.\nIt is used to power our associated [browser extension][browser-extension].\n\n- Chrome: \n- Edge: \n\n\n\n\n\n\n## Installation\n\nTo get started, install the package by running the following command:\n\n```bash\nnpm i @fluid-experimental/devtools-core -D\n```\n\n\n\n\n\n## Usage\n\nThe Devtools' API surface is designed to fit nicely into most application flows.\n\n### Initialization\n\nTo initialize a devtools session for your container, call [`initializeDevtools`][initialize-devtools-docs].\nThis function accepts a `DevtoolsLogger` for receiving Fluid telemetry from your application, a list of initial Fluid\n`Containers` to associate with the session, and (optionally) customized data visualization configurations for visualizing\n`Container` data.\n\n#### About the [`DevtoolsLogger`][devtools-logger-docs]\n\nThe `DevtoolsLogger` is an optional piece when calling `initializeDevtools` but it is strongly recommended that you use\nit because several features in Fluid Devtools are powered by the telemetry that Fluid Framework generates, and this\nlogger is the way in which that telemetry gets into Fluid Devtools.\n\nYou can obtain a `DevtoolsLogger` by calling its constructor, and then should pass it to `initializeDevtools` _and_\nto the `Loader` instance you'll use to create/load Containers as shown below.\nThis way the logger will receive all the telemetry generated by Fluid Framework in your application, and forward it to\nFluid Devtools as necessary.\n\n```typescript\nimport { DevtoolsLogger, initializeDevtools } from \"@fluid-experimental/devtools-core\";\n\n// Instantiate the logger\nconst devtoolsLogger = new DevtoolsLogger();\n\n// Pass the logger when instantiating the Loader\nconst loader = new Loader({\n\tlogger: devtoolsLogger,\n\t// Other necessary properties ...\n});\n\n// Use the Loader to create (and optionally, attach) a Container\nconst container = await loader.createDetachedContainer(/* params */);\nawait container.attach(/* params */);\n\n// Initialize the Devtools passing the logger and your Container.\n// The Container could be added later as well with devtools.registerContainerDevtools().\nconst devtools = initializeDevtools({\n\tlogger: devtoolsLogger,\n\tinitialContainers: [\n\t\t{\n\t\t\tcontainer,\n\t\t\tcontainerKey: \"My Container\",\n\t\t},\n\t],\n});\n```\n\nIf you're working with `AzureClient` instead of lower-level APIs like the one described above, you probably want to\nrefer to the [@fluid-experimental/devtools package][devtools-package] instead of this one.\n\nDuring local development the recommendation is that your application should receive the `DevtoolsLogger` instance _instead_\nof any logger it would normally receive when deployed to a real environment, to avoid local development activity from\nmixing with real telemetry.\nIf you still want to provide a real application logger and use the Fluid Devtools features that are powered by telemetry\nat the same time, you can pass an existing logger to the `DevtoolsLogger` constructor and it will forward all telemetry\nit receives to that logger as well:\n\n```typescript\nimport { DevtoolsLogger } from \"@fluid-experimental/devtools-core\";\n\n// Your application's logger\nconst yourApplicationLogger = getInstanceOfYourApplicationLogger();\n\nconst devtoolsLogger = new DevtoolsLogger(yourApplicationLogger);\n\n// Pass devtoolsLogger to initializeDevtools() and to your application as described above\n```\n\n### Clean-up\n\nThe Devtools object is managed as a global singleton.\nThat singleton is automatically cleaned up prior to the Window's \"unload\" event.\nSo typical application flows likely won't need to worry about cleanup.\nThat said, if you wish to have tighter control over when the Devtools are torn down, you can simply call the `dispose` method on the handle returned by [initialization](#initialization).\n\n## Contributing to the package\n\n### Build\n\nTo build the package locally, first ensure you have run `pnpm install` from the root of the mono-repo.\nNext, to build the code, run `npm run build` from the root of the mono-repo, or use [fluid-build](https://github.com/microsoft/FluidFramework/tree/main/build-tools/packages/build-tools#running-fluid-build-command-line) via `fluid-build -t build`.\n\n- Note: Once you have run a build from the root, assuming no other changes outside of this package, you may run `npm run build` directly within this directory for a faster build.\n If you make changes to any of this package's local dependencies, you will need to run a build again from the root before building again from directly within this package.\n\n### Test\n\nTo run the tests, first ensure you have followed the [build](#build) steps above.\nNext, run `npm run test` from a terminal within this directory.\n\n\n\n\n\n\n\n## API Documentation\n\nAPI documentation for **@fluid-experimental/devtools-core** is available at .\n\n\n\n\n\n\n\n\n\n\n## Contribution Guidelines\n\nThere are many ways to [contribute](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md) to Fluid.\n\n- Participate in Q&A in our [GitHub Discussions](https://github.com/microsoft/FluidFramework/discussions).\n- [Submit bugs](https://github.com/microsoft/FluidFramework/issues) and help us verify fixes as they are checked in.\n- Review the [source code changes](https://github.com/microsoft/FluidFramework/pulls).\n- [Contribute bug fixes](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md).\n\nDetailed instructions for working in the repo can be found in the [Wiki](https://github.com/microsoft/FluidFramework/wiki).\n\nThis project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).\nFor more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\nUse of these trademarks or logos must follow Microsoft’s [Trademark & Brand Guidelines](https://www.microsoft.com/trademarks).\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n\n\n\n## Help\n\nNot finding what you're looking for in this README? Check out our [GitHub\nWiki](https://github.com/microsoft/FluidFramework/wiki) or [fluidframework.com](https://fluidframework.com/docs/).\n\nStill not finding what you're looking for? Please [file an\nissue](https://github.com/microsoft/FluidFramework/wiki/Submitting-Bugs-and-Feature-Requests).\n\nThank you!\n\n\n\n\n\n\n\n\n\n\n## Trademark\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\n\nUse of these trademarks or logos must follow Microsoft's [Trademark & Brand\nGuidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general).\n\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n[initialize-devtools-docs]: https://fluidframework.com/docs/apis/devtools-core#initializedevtools-function\n[devtools-logger-docs]: https://fluidframework.com/docs/apis/devtools-core/devtoolslogger-class\n[devtools-package]: https://www.npmjs.com/package/@fluid-experimental/devtools\n[browser-extension]: https://github.com/microsoft/FluidFramework/tree/main/packages/tools/devtools/devtools-browser-extension\n","scripts":{"tsc":"tsc","lint":"npm run prettier && npm run eslint","test":"npm run test:mocha","build":"fluid-build . --task build","clean":"rimraf --glob \"_api-extractor-temp\" \"nyc\" \"dist\" \"lib\" \"*.tsbuildinfo\" \"*.build.log\"","eslint":"eslint src","format":"npm run prettier:fix","rebuild":"npm run clean && npm run build","lint:fix":"npm run prettier:fix && npm run eslint:fix","prettier":"prettier --check . --ignore-path ../../../../.prettierignore","build:docs":"api-extractor run --local && copyfiles -u 1 ./_api-extractor-temp/doc-models/* ../../../../_api-extractor-temp/","eslint:fix":"eslint src --fix","test:mocha":"mocha dist/**/*.test.js --unhandled-rejections=strict --exit","build:esnext":"tsc --project ./tsconfig.esnext.json","build:genver":"gen-version","prettier:fix":"prettier --write . --ignore-path ../../../../.prettierignore","build:compile":"fluid-build . --task compile","ci:build:docs":"api-extractor run && copyfiles -u 1 ./_api-extractor-temp/doc-models/* ../../../../_api-extractor-temp/","test:coverage":"npm run test:mocha:coverage","typetests:gen":"fluid-type-test-generator","build:commonjs":"fluid-build . --task commonjs","format-and-build":"npm run format && npm run build","typetests:prepare":"flub typetests --dir . --reset --previous --normalize","format-and-compile":"npm run format && npm run build:compile","test:mocha:coverage":"nyc npm run test:mocha -- --reporter xunit --reporter-option output=nyc/junit-report.xml","test:mocha:multireport":"cross-env FLUID_TEST_MULTIREPORT=1 npm run test:mocha"},"_npmUser":{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},"_resolved":"/mnt/vss/_work/1/pack/scoped/fluid-experimental-devtools-core-2.0.0-internal.6.1.2.tgz","_integrity":"sha512-m8Zvl+7Yyo1RY3fK0X69WKDdSTJjMv7MkcphtHaAuZ1n9fDh+e//5uGK66QwuF+B3qIPEqGzS+iB6dss8rTjRw==","fluidBuild":{"tasks":{"tsc":["...","typetests:gen"]}},"repository":{"url":"git+https://github.com/microsoft/FluidFramework.git","type":"git","directory":"packages/tools/devtools/devtools-core"},"_npmVersion":"8.11.0","description":"Fluid Framework developer tools core functionality","directories":{},"sideEffects":false,"_nodeVersion":"16.16.0","dependencies":{"@fluidframework/map":">=2.0.0-internal.6.1.2 <2.0.0-internal.6.2.0","@fluidframework/cell":">=2.0.0-internal.6.1.2 <2.0.0-internal.6.2.0","@fluidframework/matrix":">=2.0.0-internal.6.1.2 <2.0.0-internal.6.2.0","@fluidframework/counter":">=2.0.0-internal.6.1.2 <2.0.0-internal.6.2.0","@fluidframework/sequence":">=2.0.0-internal.6.1.2 <2.0.0-internal.6.2.0","@fluid-experimental/tree2":">=2.0.0-internal.6.1.2 <2.0.0-internal.6.2.0","@fluidframework/common-utils":"^1.1.1","@fluidframework/container-utils":">=2.0.0-internal.6.1.2 <2.0.0-internal.6.2.0","@fluidframework/core-interfaces":">=2.0.0-internal.6.1.2 <2.0.0-internal.6.2.0","@fluidframework/container-loader":">=2.0.0-internal.6.1.2 <2.0.0-internal.6.2.0","@fluidframework/common-definitions":"^0.20.1","@fluidframework/shared-object-base":">=2.0.0-internal.6.1.2 <2.0.0-internal.6.2.0","@fluidframework/protocol-definitions":"^1.1.0","@fluidframework/container-definitions":">=2.0.0-internal.6.1.2 <2.0.0-internal.6.2.0","@fluidframework/datastore-definitions":">=2.0.0-internal.6.1.2 <2.0.0-internal.6.2.0"},"_hasShrinkwrap":false,"readmeFilename":"README.md","typeValidation":{"broken":{}},"devDependencies":{"nyc":"^15.1.0","chai":"^4.2.0","mocha":"^10.2.0","eslint":"~8.6.0","events":"^3.1.0","moment":"^2.21.0","rimraf":"^4.4.0","prettier":"~2.6.2","copyfiles":"^2.4.1","cross-env":"^7.0.3","typescript":"~4.5.5","@types/chai":"^4.0.0","@types/mocha":"^9.1.1","concurrently":"^7.6.0","@types/events":"^3.0.0","mocha-multi-reporters":"^1.5.1","@fluid-tools/build-cli":"^0.22.0","eslint-config-prettier":"~8.5.0","@microsoft/api-extractor":"^7.34.4","eslint-plugin-chai-expect":"~3.0.0","mocha-json-output-reporter":"^2.0.1","@fluidframework/build-tools":"^0.22.0","@fluidframework/build-common":"^2.0.0","@fluidframework/telemetry-utils":">=2.0.0-internal.6.1.2 <2.0.0-internal.6.2.0","@fluidframework/mocha-test-setup":">=2.0.0-internal.6.1.2 <2.0.0-internal.6.2.0","@fluidframework/driver-definitions":">=2.0.0-internal.6.1.2 <2.0.0-internal.6.2.0","@fluidframework/test-runtime-utils":">=2.0.0-internal.6.1.2 <2.0.0-internal.6.2.0","@fluidframework/eslint-config-fluid":"^2.0.0","@fluid-experimental/devtools-core-previous":"npm:@fluid-experimental/devtools-core@2.0.0-internal.6.1.1"},"_npmOperationalInternal":{"tmp":"tmp/devtools-core_2.0.0-internal.6.1.2_1694452829450_0.6591570436498739","host":"s3://npm-registry-packages"}},"2.0.0-internal.6.0.3":{"name":"@fluid-experimental/devtools-core","version":"2.0.0-internal.6.0.3","author":{"name":"Microsoft and contributors"},"license":"MIT","_id":"@fluid-experimental/devtools-core@2.0.0-internal.6.0.3","maintainers":[{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},{"name":"curtisman","email":"curtism@microsoft.com"}],"homepage":"https://fluidframework.com","bugs":{"url":"https://github.com/microsoft/FluidFramework/issues"},"nyc":{"all":true,"exclude":["src/test/**/*.ts","dist/test/**/*.js"],"include":["src/**/*.ts","dist/**/*.js"],"reporter":["cobertura","html","text"],"cache-dir":"nyc/.cache","report-dir":"nyc/report","temp-directory":"nyc/.nyc_output","exclude-after-remap":false},"dist":{"shasum":"0e0d5d71245719f38ecba4f5b3c5f029fe03d696","tarball":"https://registry.npmjs.org/@fluid-experimental/devtools-core/-/devtools-core-2.0.0-internal.6.0.3.tgz","fileCount":501,"integrity":"sha512-fdlZLnXwPMilLmgwf21g/98m9Il5vUhKw8pNLfEUPDKE00ZUed9JPwPmizDZ7zB9tyIgbELkfjx+I60l5eHbBw==","signatures":[{"sig":"MEUCIAVvA9vtKXoM3mfDtDDFsoRdZ1ioBDjxZs74zVWKUcEIAiEAttZlvJ6M5zx9zquQlvE4ZeCs9Ld/d+Nte08jguhWdgg=","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}],"unpackedSize":1347878},"main":"dist/index.js","_from":"file:fluid-experimental-devtools-core-2.0.0-internal.6.0.3.tgz","types":"dist/index.d.ts","readme":"# @fluid-experimental/devtools-core\n\nThis library contains developer tools for use alongside the Fluid Framework.\nIt is used to power our associated [browser extension][browser-extension].\n\n- Chrome: \n- Edge: \n\n\n\n\n\n\n## Installation\n\nTo get started, install the package by running the following command:\n\n```bash\nnpm i @fluid-experimental/devtools-core -D\n```\n\n\n\n\n\n## Usage\n\nThe Devtools' API surface is designed to fit nicely into most application flows.\n\n### Initialization\n\nTo initialize a devtools session for your container, call [`initializeDevtools`][initialize-devtools-docs].\nThis function accepts a `DevtoolsLogger` for receiving Fluid telemetry from your application, a list of initial Fluid\n`Containers` to associate with the session, and (optionally) customized data visualization configurations for visualizing\n`Container` data.\n\n#### About the [`DevtoolsLogger`][devtools-logger-docs]\n\nThe `DevtoolsLogger` is an optional piece when calling `initializeDevtools` but it is strongly recommended that you use\nit because several features in Fluid Devtools are powered by the telemetry that Fluid Framework generates, and this\nlogger is the way in which that telemetry gets into Fluid Devtools.\n\nYou can obtain a `DevtoolsLogger` by calling its constructor, and then should pass it to `initializeDevtools` _and_\nto the `Loader` instance you'll use to create/load Containers as shown below.\nThis way the logger will receive all the telemetry generated by Fluid Framework in your application, and forward it to\nFluid Devtools as necessary.\n\n```typescript\nimport { DevtoolsLogger, initializeDevtools } from \"@fluid-experimental/devtools-core\";\n\n// Instantiate the logger\nconst devtoolsLogger = new DevtoolsLogger();\n\n// Pass the logger when instantiating the Loader\nconst loader = new Loader({\n\tlogger: devtoolsLogger,\n\t// Other necessary properties ...\n});\n\n// Use the Loader to create (and optionally, attach) a Container\nconst container = await loader.createDetachedContainer(/* params */);\nawait container.attach(/* params */);\n\n// Initialize the Devtools passing the logger and your Container.\n// The Container could be added later as well with devtools.registerContainerDevtools().\nconst devtools = initializeDevtools({\n\tlogger: devtoolsLogger,\n\tinitialContainers: [\n\t\t{\n\t\t\tcontainer,\n\t\t\tcontainerKey: \"My Container\",\n\t\t},\n\t],\n});\n```\n\nIf you're working with `AzureClient` instead of lower-level APIs like the one described above, you probably want to\nrefer to the [@fluid-experimental/devtools package][devtools-package] instead of this one.\n\nDuring local development the recommendation is that your application should receive the `DevtoolsLogger` instance _instead_\nof any logger it would normally receive when deployed to a real environment, to avoid local development activity from\nmixing with real telemetry.\nIf you still want to provide a real application logger and use the Fluid Devtools features that are powered by telemetry\nat the same time, you can pass an existing logger to the `DevtoolsLogger` constructor and it will forward all telemetry\nit receives to that logger as well:\n\n```typescript\nimport { DevtoolsLogger } from \"@fluid-experimental/devtools-core\";\n\n// Your application's logger\nconst yourApplicationLogger = getInstanceOfYourApplicationLogger();\n\nconst devtoolsLogger = new DevtoolsLogger(yourApplicationLogger);\n\n// Pass devtoolsLogger to initializeDevtools() and to your application as described above\n```\n\n### Clean-up\n\nThe Devtools object is managed as a global singleton.\nThat singleton is automatically cleaned up prior to the Window's \"unload\" event.\nSo typical application flows likely won't need to worry about cleanup.\nThat said, if you wish to have tighter control over when the Devtools are torn down, you can simply call the `dispose` method on the handle returned by [initialization](#initialization).\n\n## Contributing to the package\n\n### Build\n\nTo build the package locally, first ensure you have run `pnpm install` from the root of the mono-repo.\nNext, to build the code, run `npm run build` from the root of the mono-repo, or use [fluid-build](https://github.com/microsoft/FluidFramework/tree/main/build-tools/packages/build-tools#running-fluid-build-command-line) via `fluid-build -t build`.\n\n- Note: Once you have run a build from the root, assuming no other changes outside of this package, you may run `npm run build` directly within this directory for a faster build.\n If you make changes to any of this package's local dependencies, you will need to run a build again from the root before building again from directly within this package.\n\n### Test\n\nTo run the tests, first ensure you have followed the [build](#build) steps above.\nNext, run `npm run test` from a terminal within this directory.\n\n\n\n\n\n\n\n## API Documentation\n\nAPI documentation for **@fluid-experimental/devtools-core** is available at .\n\n\n\n\n\n\n\n\n\n\n## Contribution Guidelines\n\nThere are many ways to [contribute](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md) to Fluid.\n\n- Participate in Q&A in our [GitHub Discussions](https://github.com/microsoft/FluidFramework/discussions).\n- [Submit bugs](https://github.com/microsoft/FluidFramework/issues) and help us verify fixes as they are checked in.\n- Review the [source code changes](https://github.com/microsoft/FluidFramework/pulls).\n- [Contribute bug fixes](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md).\n\nDetailed instructions for working in the repo can be found in the [Wiki](https://github.com/microsoft/FluidFramework/wiki).\n\nThis project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).\nFor more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\nUse of these trademarks or logos must follow Microsoft’s [Trademark & Brand Guidelines](https://www.microsoft.com/trademarks).\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n\n\n\n## Help\n\nNot finding what you're looking for in this README? Check out our [GitHub\nWiki](https://github.com/microsoft/FluidFramework/wiki) or [fluidframework.com](https://fluidframework.com/docs/).\n\nStill not finding what you're looking for? Please [file an\nissue](https://github.com/microsoft/FluidFramework/wiki/Submitting-Bugs-and-Feature-Requests).\n\nThank you!\n\n\n\n\n\n\n\n\n\n\n## Trademark\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\n\nUse of these trademarks or logos must follow Microsoft's [Trademark & Brand\nGuidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general).\n\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n[initialize-devtools-docs]: https://fluidframework.com/docs/apis/devtools-core#initializedevtools-function\n[devtools-logger-docs]: https://fluidframework.com/docs/apis/devtools-core/devtoolslogger-class\n[devtools-package]: https://www.npmjs.com/package/@fluid-experimental/devtools\n[browser-extension]: https://github.com/microsoft/FluidFramework/tree/main/packages/tools/devtools/devtools-browser-extension\n","scripts":{"tsc":"tsc","lint":"npm run prettier && npm run eslint","test":"npm run test:mocha","build":"fluid-build . --task build","clean":"rimraf --glob \"_api-extractor-temp\" \"nyc\" \"dist\" \"lib\" \"*.tsbuildinfo\" \"*.build.log\"","eslint":"eslint src","format":"npm run prettier:fix","rebuild":"npm run clean && npm run build","lint:fix":"npm run prettier:fix && npm run eslint:fix","prettier":"prettier --check . --ignore-path ../../../../.prettierignore","build:docs":"api-extractor run --local && copyfiles -u 1 ./_api-extractor-temp/doc-models/* ../../../../_api-extractor-temp/","eslint:fix":"eslint src --fix","test:mocha":"mocha dist/**/*.test.js --unhandled-rejections=strict --exit","build:esnext":"tsc --project ./tsconfig.esnext.json","build:genver":"gen-version","prettier:fix":"prettier --write . --ignore-path ../../../../.prettierignore","build:compile":"fluid-build . --task compile","ci:build:docs":"api-extractor run && copyfiles -u 1 ./_api-extractor-temp/doc-models/* ../../../../_api-extractor-temp/","test:coverage":"npm run test:mocha:coverage","typetests:gen":"fluid-type-test-generator","build:commonjs":"fluid-build . --task commonjs","format-and-build":"npm run format && npm run build","typetests:prepare":"flub typetests --dir . --reset --previous --normalize","format-and-compile":"npm run format && npm run build:compile","test:mocha:coverage":"nyc npm run test:mocha -- --reporter xunit --reporter-option output=nyc/junit-report.xml","test:mocha:multireport":"cross-env FLUID_TEST_MULTIREPORT=1 npm run test:mocha"},"_npmUser":{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},"_resolved":"/mnt/vss/_work/1/pack/scoped/fluid-experimental-devtools-core-2.0.0-internal.6.0.3.tgz","_integrity":"sha512-fdlZLnXwPMilLmgwf21g/98m9Il5vUhKw8pNLfEUPDKE00ZUed9JPwPmizDZ7zB9tyIgbELkfjx+I60l5eHbBw==","fluidBuild":{"tasks":{"tsc":["...","typetests:gen"]}},"repository":{"url":"git+https://github.com/microsoft/FluidFramework.git","type":"git","directory":"packages/tools/devtools/devtools-core"},"_npmVersion":"8.11.0","description":"Fluid Framework developer tools core functionality","directories":{},"sideEffects":false,"_nodeVersion":"16.16.0","dependencies":{"@fluidframework/map":">=2.0.0-internal.6.0.3 <2.0.0-internal.6.1.0","@fluidframework/cell":">=2.0.0-internal.6.0.3 <2.0.0-internal.6.1.0","@fluidframework/matrix":">=2.0.0-internal.6.0.3 <2.0.0-internal.6.1.0","@fluidframework/counter":">=2.0.0-internal.6.0.3 <2.0.0-internal.6.1.0","@fluidframework/sequence":">=2.0.0-internal.6.0.3 <2.0.0-internal.6.1.0","@fluid-experimental/tree2":">=2.0.0-internal.6.0.3 <2.0.0-internal.6.1.0","@fluidframework/common-utils":"^1.1.1","@fluidframework/container-utils":">=2.0.0-internal.6.0.3 <2.0.0-internal.6.1.0","@fluidframework/core-interfaces":">=2.0.0-internal.6.0.3 <2.0.0-internal.6.1.0","@fluidframework/container-loader":">=2.0.0-internal.6.0.3 <2.0.0-internal.6.1.0","@fluidframework/common-definitions":"^0.20.1","@fluidframework/shared-object-base":">=2.0.0-internal.6.0.3 <2.0.0-internal.6.1.0","@fluidframework/protocol-definitions":"^1.1.0","@fluidframework/container-definitions":">=2.0.0-internal.6.0.3 <2.0.0-internal.6.1.0","@fluidframework/datastore-definitions":">=2.0.0-internal.6.0.3 <2.0.0-internal.6.1.0"},"_hasShrinkwrap":false,"readmeFilename":"README.md","typeValidation":{"broken":{}},"devDependencies":{"nyc":"^15.1.0","chai":"^4.2.0","mocha":"^10.2.0","eslint":"~8.6.0","events":"^3.1.0","moment":"^2.21.0","rimraf":"^4.4.0","prettier":"~2.6.2","copyfiles":"^2.4.1","cross-env":"^7.0.3","typescript":"~4.5.5","@types/chai":"^4.0.0","@types/mocha":"^9.1.1","concurrently":"^7.6.0","@types/events":"^3.0.0","mocha-multi-reporters":"^1.5.1","@fluid-tools/build-cli":"^0.21.0","eslint-config-prettier":"~8.5.0","@microsoft/api-extractor":"^7.34.4","eslint-plugin-chai-expect":"~3.0.0","mocha-json-output-reporter":"^2.0.1","@fluidframework/build-tools":"^0.21.0","@fluidframework/build-common":"^2.0.0","@fluidframework/telemetry-utils":">=2.0.0-internal.6.0.3 <2.0.0-internal.6.1.0","@fluidframework/mocha-test-setup":">=2.0.0-internal.6.0.3 <2.0.0-internal.6.1.0","@fluidframework/driver-definitions":">=2.0.0-internal.6.0.3 <2.0.0-internal.6.1.0","@fluidframework/test-runtime-utils":">=2.0.0-internal.6.0.3 <2.0.0-internal.6.1.0","@fluidframework/eslint-config-fluid":"^2.0.0","@fluid-experimental/devtools-core-previous":"npm:@fluid-experimental/devtools-core@2.0.0-internal.6.0.0"},"_npmOperationalInternal":{"tmp":"tmp/devtools-core_2.0.0-internal.6.0.3_1694452988750_0.3031539527644187","host":"s3://npm-registry-packages"}},"2.0.0-internal.6.2.1":{"name":"@fluid-experimental/devtools-core","version":"2.0.0-internal.6.2.1","author":{"name":"Microsoft and contributors"},"license":"MIT","_id":"@fluid-experimental/devtools-core@2.0.0-internal.6.2.1","maintainers":[{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},{"name":"curtisman","email":"curtism@microsoft.com"}],"homepage":"https://fluidframework.com","bugs":{"url":"https://github.com/microsoft/FluidFramework/issues"},"nyc":{"all":true,"exclude":["src/test/**/*.ts","dist/test/**/*.js"],"include":["src/**/*.ts","dist/**/*.js"],"reporter":["cobertura","html","text"],"cache-dir":"nyc/.cache","report-dir":"nyc/report","temp-directory":"nyc/.nyc_output","exclude-after-remap":false},"dist":{"shasum":"a65c0fb71bfa02a441df685ec0783d5a613d25bb","tarball":"https://registry.npmjs.org/@fluid-experimental/devtools-core/-/devtools-core-2.0.0-internal.6.2.1.tgz","fileCount":501,"integrity":"sha512-sFdb1ozQz38jNsVR2//cickemy4/XMTBmPJajURgvRPsuKYsJ/XqknKrhf/vT0MwJXkkoIZ2ROGWlavsVcjhAg==","signatures":[{"sig":"MEUCIQDUk/tj/0ySWycWgDPMP8Xz6gAEuc/pVNhXJvre5IfDeAIgfhIINJgLZdGIB1cdwVc4VvcrX1YDio7MJM68yruRGMk=","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}],"unpackedSize":1368282},"main":"dist/index.js","_from":"file:fluid-experimental-devtools-core-2.0.0-internal.6.2.1.tgz","types":"dist/index.d.ts","readme":"# @fluid-experimental/devtools-core\n\nThis library contains developer tools for use alongside the Fluid Framework.\nIt is used to power our associated [browser extension][browser-extension].\n\n- Chrome: \n- Edge: \n\n\n\n\n\n\n## Installation\n\nTo get started, install the package by running the following command:\n\n```bash\nnpm i @fluid-experimental/devtools-core -D\n```\n\n\n\n\n\n## Usage\n\nThe Devtools' API surface is designed to fit nicely into most application flows.\n\n### Initialization\n\nTo initialize a devtools session for your container, call [`initializeDevtools`][initialize-devtools-docs].\nThis function accepts a `DevtoolsLogger` for receiving Fluid telemetry from your application, a list of initial Fluid\n`Containers` to associate with the session, and (optionally) customized data visualization configurations for visualizing\n`Container` data.\n\n#### About the [`DevtoolsLogger`][devtools-logger-docs]\n\nThe `DevtoolsLogger` is an optional piece when calling `initializeDevtools` but it is strongly recommended that you use\nit because several features in Fluid Devtools are powered by the telemetry that Fluid Framework generates, and this\nlogger is the way in which that telemetry gets into Fluid Devtools.\n\nYou can obtain a `DevtoolsLogger` by calling its constructor, and then should pass it to `initializeDevtools` _and_\nto the `Loader` instance you'll use to create/load Containers as shown below.\nThis way the logger will receive all the telemetry generated by Fluid Framework in your application, and forward it to\nFluid Devtools as necessary.\n\n```typescript\nimport { DevtoolsLogger, initializeDevtools } from \"@fluid-experimental/devtools-core\";\n\n// Instantiate the logger\nconst devtoolsLogger = new DevtoolsLogger();\n\n// Pass the logger when instantiating the Loader\nconst loader = new Loader({\n\tlogger: devtoolsLogger,\n\t// Other necessary properties ...\n});\n\n// Use the Loader to create (and optionally, attach) a Container\nconst container = await loader.createDetachedContainer(/* params */);\nawait container.attach(/* params */);\n\n// Initialize the Devtools passing the logger and your Container.\n// The Container could be added later as well with devtools.registerContainerDevtools().\nconst devtools = initializeDevtools({\n\tlogger: devtoolsLogger,\n\tinitialContainers: [\n\t\t{\n\t\t\tcontainer,\n\t\t\tcontainerKey: \"My Container\",\n\t\t},\n\t],\n});\n```\n\nIf you're working with `AzureClient` instead of lower-level APIs like the one described above, you probably want to\nrefer to the [@fluid-experimental/devtools package][devtools-package] instead of this one.\n\nDuring local development the recommendation is that your application should receive the `DevtoolsLogger` instance _instead_\nof any logger it would normally receive when deployed to a real environment, to avoid local development activity from\nmixing with real telemetry.\nIf you still want to provide a real application logger and use the Fluid Devtools features that are powered by telemetry\nat the same time, you can pass an existing logger to the `DevtoolsLogger` constructor and it will forward all telemetry\nit receives to that logger as well:\n\n```typescript\nimport { DevtoolsLogger } from \"@fluid-experimental/devtools-core\";\n\n// Your application's logger\nconst yourApplicationLogger = getInstanceOfYourApplicationLogger();\n\nconst devtoolsLogger = new DevtoolsLogger(yourApplicationLogger);\n\n// Pass devtoolsLogger to initializeDevtools() and to your application as described above\n```\n\n### Clean-up\n\nThe Devtools object is managed as a global singleton.\nThat singleton is automatically cleaned up prior to the Window's \"unload\" event.\nSo typical application flows likely won't need to worry about cleanup.\nThat said, if you wish to have tighter control over when the Devtools are torn down, you can simply call the `dispose` method on the handle returned by [initialization](#initialization).\n\n## Contributing to the package\n\n### Build\n\nTo build the package locally, first ensure you have run `pnpm install` from the root of the mono-repo.\nNext, to build the code, run `npm run build` from the root of the mono-repo, or use [fluid-build](https://github.com/microsoft/FluidFramework/tree/main/build-tools/packages/build-tools#running-fluid-build-command-line) via `fluid-build -t build`.\n\n- Note: Once you have run a build from the root, assuming no other changes outside of this package, you may run `npm run build` directly within this directory for a faster build.\n If you make changes to any of this package's local dependencies, you will need to run a build again from the root before building again from directly within this package.\n\n### Test\n\nTo run the tests, first ensure you have followed the [build](#build) steps above.\nNext, run `npm run test` from a terminal within this directory.\n\n\n\n\n\n\n\n## API Documentation\n\nAPI documentation for **@fluid-experimental/devtools-core** is available at .\n\n\n\n\n\n\n\n\n\n\n## Contribution Guidelines\n\nThere are many ways to [contribute](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md) to Fluid.\n\n- Participate in Q&A in our [GitHub Discussions](https://github.com/microsoft/FluidFramework/discussions).\n- [Submit bugs](https://github.com/microsoft/FluidFramework/issues) and help us verify fixes as they are checked in.\n- Review the [source code changes](https://github.com/microsoft/FluidFramework/pulls).\n- [Contribute bug fixes](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md).\n\nDetailed instructions for working in the repo can be found in the [Wiki](https://github.com/microsoft/FluidFramework/wiki).\n\nThis project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).\nFor more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\nUse of these trademarks or logos must follow Microsoft’s [Trademark & Brand Guidelines](https://www.microsoft.com/trademarks).\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n\n\n\n## Help\n\nNot finding what you're looking for in this README? Check out our [GitHub\nWiki](https://github.com/microsoft/FluidFramework/wiki) or [fluidframework.com](https://fluidframework.com/docs/).\n\nStill not finding what you're looking for? Please [file an\nissue](https://github.com/microsoft/FluidFramework/wiki/Submitting-Bugs-and-Feature-Requests).\n\nThank you!\n\n\n\n\n\n\n\n\n\n\n## Trademark\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\n\nUse of these trademarks or logos must follow Microsoft's [Trademark & Brand\nGuidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general).\n\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n[initialize-devtools-docs]: https://fluidframework.com/docs/apis/devtools-core#initializedevtools-function\n[devtools-logger-docs]: https://fluidframework.com/docs/apis/devtools-core/devtoolslogger-class\n[devtools-package]: https://www.npmjs.com/package/@fluid-experimental/devtools\n[browser-extension]: https://github.com/microsoft/FluidFramework/tree/main/packages/tools/devtools/devtools-browser-extension\n","scripts":{"tsc":"tsc","lint":"npm run prettier && npm run eslint","test":"npm run test:mocha","build":"fluid-build . --task build","clean":"rimraf --glob \"_api-extractor-temp\" \"nyc\" \"dist\" \"lib\" \"*.tsbuildinfo\" \"*.build.log\"","eslint":"eslint src","format":"npm run prettier:fix","rebuild":"npm run clean && npm run build","lint:fix":"npm run prettier:fix && npm run eslint:fix","prettier":"prettier --check . --ignore-path ../../../../.prettierignore","tsc:watch":"tsc --watch","build:docs":"api-extractor run --local && copyfiles -u 1 ./_api-extractor-temp/doc-models/* ../../../../_api-extractor-temp/","eslint:fix":"eslint src --fix","test:mocha":"mocha dist/**/*.test.js --unhandled-rejections=strict --exit","build:esnext":"tsc --project ./tsconfig.esnext.json","build:genver":"gen-version","prettier:fix":"prettier --write . --ignore-path ../../../../.prettierignore","build:compile":"fluid-build . --task compile","ci:build:docs":"api-extractor run && copyfiles -u 1 ./_api-extractor-temp/doc-models/* ../../../../_api-extractor-temp/","test:coverage":"npm run test:mocha:coverage","typetests:gen":"fluid-type-test-generator","build:commonjs":"fluid-build . --task commonjs","format-and-build":"npm run format && npm run build","typetests:prepare":"flub typetests --dir . --reset --previous --normalize","format-and-compile":"npm run format && npm run build:compile","test:mocha:coverage":"nyc npm run test:mocha -- --reporter xunit --reporter-option output=nyc/junit-report.xml","test:mocha:multireport":"npm run test:mocha"},"_npmUser":{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},"_resolved":"/mnt/vss/_work/1/pack/scoped/fluid-experimental-devtools-core-2.0.0-internal.6.2.1.tgz","_integrity":"sha512-sFdb1ozQz38jNsVR2//cickemy4/XMTBmPJajURgvRPsuKYsJ/XqknKrhf/vT0MwJXkkoIZ2ROGWlavsVcjhAg==","fluidBuild":{"tasks":{"tsc":["...","typetests:gen"]}},"repository":{"url":"git+https://github.com/microsoft/FluidFramework.git","type":"git","directory":"packages/tools/devtools/devtools-core"},"_npmVersion":"8.11.0","description":"Fluid Framework developer tools core functionality","directories":{},"sideEffects":false,"_nodeVersion":"16.16.0","dependencies":{"@fluidframework/map":">=2.0.0-internal.6.2.1 <2.0.0-internal.6.3.0","@fluidframework/cell":">=2.0.0-internal.6.2.1 <2.0.0-internal.6.3.0","@fluidframework/matrix":">=2.0.0-internal.6.2.1 <2.0.0-internal.6.3.0","@fluidframework/counter":">=2.0.0-internal.6.2.1 <2.0.0-internal.6.3.0","@fluidframework/sequence":">=2.0.0-internal.6.2.1 <2.0.0-internal.6.3.0","@fluid-experimental/tree2":">=2.0.0-internal.6.2.1 <2.0.0-internal.6.3.0","@fluidframework/common-utils":"^1.1.1","@fluidframework/core-interfaces":">=2.0.0-internal.6.2.1 <2.0.0-internal.6.3.0","@fluidframework/telemetry-utils":">=2.0.0-internal.6.2.1 <2.0.0-internal.6.3.0","@fluidframework/container-loader":">=2.0.0-internal.6.2.1 <2.0.0-internal.6.3.0","@fluidframework/shared-object-base":">=2.0.0-internal.6.2.1 <2.0.0-internal.6.3.0","@fluidframework/protocol-definitions":"^1.1.0","@fluidframework/container-definitions":">=2.0.0-internal.6.2.1 <2.0.0-internal.6.3.0","@fluidframework/datastore-definitions":">=2.0.0-internal.6.2.1 <2.0.0-internal.6.3.0"},"_hasShrinkwrap":false,"readmeFilename":"README.md","typeValidation":{"broken":{}},"devDependencies":{"nyc":"^15.1.0","chai":"^4.2.0","mocha":"^10.2.0","eslint":"~8.6.0","events":"^3.1.0","moment":"^2.21.0","rimraf":"^4.4.0","prettier":"~2.6.2","copyfiles":"^2.4.1","cross-env":"^7.0.3","typescript":"~4.5.5","@types/chai":"^4.0.0","@types/mocha":"^9.1.1","concurrently":"^7.6.0","@types/events":"^3.0.0","mocha-multi-reporters":"^1.5.1","@fluid-tools/build-cli":"^0.23.0","eslint-config-prettier":"~8.5.0","@microsoft/api-extractor":"^7.34.4","eslint-plugin-chai-expect":"~3.0.0","mocha-json-output-reporter":"^2.0.1","@fluidframework/build-tools":"^0.23.0","@fluidframework/build-common":"^2.0.0","@fluidframework/mocha-test-setup":">=2.0.0-internal.6.2.1 <2.0.0-internal.6.3.0","@fluidframework/driver-definitions":">=2.0.0-internal.6.2.1 <2.0.0-internal.6.3.0","@fluidframework/test-runtime-utils":">=2.0.0-internal.6.2.1 <2.0.0-internal.6.3.0","@fluidframework/eslint-config-fluid":"^2.1.0","@fluid-experimental/devtools-core-previous":"npm:@fluid-experimental/devtools-core@2.0.0-internal.6.1.1"},"_npmOperationalInternal":{"tmp":"tmp/devtools-core_2.0.0-internal.6.2.1_1694453150752_0.9830399084502501","host":"s3://npm-registry-packages"}},"2.0.0-dev.6.4.0.191258":{"name":"@fluid-experimental/devtools-core","version":"2.0.0-dev.6.4.0.191258","author":{"name":"Microsoft and contributors"},"license":"MIT","_id":"@fluid-experimental/devtools-core@2.0.0-dev.6.4.0.191258","maintainers":[{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},{"name":"curtisman","email":"curtism@microsoft.com"}],"homepage":"https://fluidframework.com","bugs":{"url":"https://github.com/microsoft/FluidFramework/issues"},"c8":{"all":true,"exclude":["src/test/**/*.ts","dist/test/**/*.js"],"include":["src/**/*.ts","dist/**/*.js"],"reporter":["cobertura","html","text"],"cache-dir":"nyc/.cache","report-dir":"nyc/report","temp-directory":"nyc/.nyc_output","exclude-after-remap":false},"dist":{"shasum":"78d41f0a9f28a45199d51cbdd5ac200f3589eaf7","tarball":"https://registry.npmjs.org/@fluid-experimental/devtools-core/-/devtools-core-2.0.0-dev.6.4.0.191258.tgz","fileCount":501,"integrity":"sha512-Qk6+iMqFymNvvyxBGwv+LeeYO2dKHJ9Ir85G7G1WX9Qf3zDY9la802/KjvU92AOsZUTLChAzQGM7hIwB6dc1jQ==","signatures":[{"sig":"MEUCIFIrz94G28G1Hho0cWWz486bOMl7ni/QI0LdOTuSS39QAiEA6li/aPqtPtB4yE/9+uau1wEpYGY2OVzcbRx0nI7x04U=","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}],"unpackedSize":1367856},"main":"dist/index.js","_from":"file:fluid-experimental-devtools-core-2.0.0-dev.6.4.0.191258.tgz","types":"dist/index.d.ts","module":"lib/index.js","readme":"# @fluid-experimental/devtools-core\n\nThis library contains developer tools for use alongside the Fluid Framework.\nIt is used to power our associated [browser extension][browser-extension].\n\n- Chrome: \n- Edge: \n\n\n\n\n\n\n## Installation\n\nTo get started, install the package by running the following command:\n\n```bash\nnpm i @fluid-experimental/devtools-core -D\n```\n\n\n\n\n\n## Usage\n\nThe Devtools' API surface is designed to fit nicely into most application flows.\n\n### Initialization\n\nTo initialize a devtools session for your container, call [`initializeDevtools`][initialize-devtools-docs].\nThis function accepts a `DevtoolsLogger` for receiving Fluid telemetry from your application, a list of initial Fluid\n`Containers` to associate with the session, and (optionally) customized data visualization configurations for visualizing\n`Container` data.\n\n#### About the [`DevtoolsLogger`][devtools-logger-docs]\n\nThe `DevtoolsLogger` is an optional piece when calling `initializeDevtools` but it is strongly recommended that you use\nit because several features in Fluid Devtools are powered by the telemetry that Fluid Framework generates, and this\nlogger is the way in which that telemetry gets into Fluid Devtools.\n\nYou can obtain a `DevtoolsLogger` by calling its constructor, and then should pass it to `initializeDevtools` _and_\nto the `Loader` instance you'll use to create/load Containers as shown below.\nThis way the logger will receive all the telemetry generated by Fluid Framework in your application, and forward it to\nFluid Devtools as necessary.\n\n```typescript\nimport { DevtoolsLogger, initializeDevtools } from \"@fluid-experimental/devtools-core\";\n\n// Instantiate the logger\nconst devtoolsLogger = new DevtoolsLogger();\n\n// Pass the logger when instantiating the Loader\nconst loader = new Loader({\n\tlogger: devtoolsLogger,\n\t// Other necessary properties ...\n});\n\n// Use the Loader to create (and optionally, attach) a Container\nconst container = await loader.createDetachedContainer(/* params */);\nawait container.attach(/* params */);\n\n// Initialize the Devtools passing the logger and your Container.\n// The Container could be added later as well with devtools.registerContainerDevtools().\nconst devtools = initializeDevtools({\n\tlogger: devtoolsLogger,\n\tinitialContainers: [\n\t\t{\n\t\t\tcontainer,\n\t\t\tcontainerKey: \"My Container\",\n\t\t},\n\t],\n});\n```\n\nIf you're working with `AzureClient` instead of lower-level APIs like the one described above, you probably want to\nrefer to the [@fluid-experimental/devtools package][devtools-package] instead of this one.\n\nDuring local development the recommendation is that your application should receive the `DevtoolsLogger` instance _instead_\nof any logger it would normally receive when deployed to a real environment, to avoid local development activity from\nmixing with real telemetry.\nIf you still want to provide a real application logger and use the Fluid Devtools features that are powered by telemetry\nat the same time, you can pass an existing logger to the `DevtoolsLogger` constructor and it will forward all telemetry\nit receives to that logger as well:\n\n```typescript\nimport { DevtoolsLogger } from \"@fluid-experimental/devtools-core\";\n\n// Your application's logger\nconst yourApplicationLogger = getInstanceOfYourApplicationLogger();\n\nconst devtoolsLogger = new DevtoolsLogger(yourApplicationLogger);\n\n// Pass devtoolsLogger to initializeDevtools() and to your application as described above\n```\n\n### Clean-up\n\nThe Devtools object is managed as a global singleton.\nThat singleton is automatically cleaned up prior to the Window's \"unload\" event.\nSo typical application flows likely won't need to worry about cleanup.\nThat said, if you wish to have tighter control over when the Devtools are torn down, you can simply call the `dispose` method on the handle returned by [initialization](#initialization).\n\n## Contributing to the package\n\n### Build\n\nTo build the package locally, first ensure you have run `pnpm install` from the root of the mono-repo.\nNext, to build the code, run `npm run build` from the root of the mono-repo, or use [fluid-build](https://github.com/microsoft/FluidFramework/tree/main/build-tools/packages/build-tools#running-fluid-build-command-line) via `fluid-build -t build`.\n\n- Note: Once you have run a build from the root, assuming no other changes outside of this package, you may run `npm run build` directly within this directory for a faster build.\n If you make changes to any of this package's local dependencies, you will need to run a build again from the root before building again from directly within this package.\n\n### Test\n\nTo run the tests, first ensure you have followed the [build](#build) steps above.\nNext, run `npm run test` from a terminal within this directory.\n\n\n\n\n\n\n\n## API Documentation\n\nAPI documentation for **@fluid-experimental/devtools-core** is available at .\n\n\n\n\n\n\n\n\n\n\n## Contribution Guidelines\n\nThere are many ways to [contribute](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md) to Fluid.\n\n- Participate in Q&A in our [GitHub Discussions](https://github.com/microsoft/FluidFramework/discussions).\n- [Submit bugs](https://github.com/microsoft/FluidFramework/issues) and help us verify fixes as they are checked in.\n- Review the [source code changes](https://github.com/microsoft/FluidFramework/pulls).\n- [Contribute bug fixes](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md).\n\nDetailed instructions for working in the repo can be found in the [Wiki](https://github.com/microsoft/FluidFramework/wiki).\n\nThis project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).\nFor more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\nUse of these trademarks or logos must follow Microsoft’s [Trademark & Brand Guidelines](https://www.microsoft.com/trademarks).\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n\n\n\n## Help\n\nNot finding what you're looking for in this README? Check out our [GitHub\nWiki](https://github.com/microsoft/FluidFramework/wiki) or [fluidframework.com](https://fluidframework.com/docs/).\n\nStill not finding what you're looking for? Please [file an\nissue](https://github.com/microsoft/FluidFramework/wiki/Submitting-Bugs-and-Feature-Requests).\n\nThank you!\n\n\n\n\n\n\n\n\n\n\n## Trademark\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\n\nUse of these trademarks or logos must follow Microsoft's [Trademark & Brand\nGuidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general).\n\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n[initialize-devtools-docs]: https://fluidframework.com/docs/apis/devtools-core#initializedevtools-function\n[devtools-logger-docs]: https://fluidframework.com/docs/apis/devtools-core/devtoolslogger-class\n[devtools-package]: https://www.npmjs.com/package/@fluid-experimental/devtools\n[browser-extension]: https://github.com/microsoft/FluidFramework/tree/main/packages/tools/devtools/devtools-browser-extension\n","scripts":{"tsc":"tsc","lint":"npm run prettier && npm run eslint","test":"npm run test:mocha","build":"fluid-build . --task build","clean":"rimraf --glob '_api-extractor-temp' 'nyc' 'dist' 'lib' '*.tsbuildinfo' '*.build.log'","eslint":"eslint src","format":"npm run prettier:fix","rebuild":"npm run clean && npm run build","lint:fix":"npm run prettier:fix && npm run eslint:fix","prettier":"prettier --check . --ignore-path ../../../../.prettierignore","tsc:watch":"tsc --watch","build:docs":"api-extractor run --local && copyfiles -u 1 ./_api-extractor-temp/doc-models/* ../../../../_api-extractor-temp/","eslint:fix":"eslint src --fix","test:mocha":"mocha dist/**/*.test.js --exit","build:esnext":"tsc --project ./tsconfig.esnext.json","build:genver":"gen-version","prettier:fix":"prettier --write . --ignore-path ../../../../.prettierignore","build:compile":"fluid-build . --task compile","ci:build:docs":"api-extractor run && copyfiles -u 1 ./_api-extractor-temp/doc-models/* ../../../../_api-extractor-temp/","test:coverage":"c8 npm test","typetests:gen":"fluid-type-test-generator","build:commonjs":"fluid-build . --task commonjs","format-and-build":"npm run format && npm run build","typetests:prepare":"flub typetests --dir . --reset --previous --normalize","format-and-compile":"npm run format && npm run build:compile"},"_npmUser":{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},"_resolved":"/mnt/vss/_work/1/pack/scoped/fluid-experimental-devtools-core-2.0.0-dev.6.4.0.191258.tgz","_integrity":"sha512-Qk6+iMqFymNvvyxBGwv+LeeYO2dKHJ9Ir85G7G1WX9Qf3zDY9la802/KjvU92AOsZUTLChAzQGM7hIwB6dc1jQ==","fluidBuild":{"tasks":{"tsc":["...","typetests:gen"]}},"repository":{"url":"git+https://github.com/microsoft/FluidFramework.git","type":"git","directory":"packages/tools/devtools/devtools-core"},"_npmVersion":"9.6.7","description":"Fluid Framework developer tools core functionality","directories":{},"sideEffects":false,"_nodeVersion":"18.17.1","dependencies":{"@fluidframework/map":"2.0.0-dev.6.4.0.191258","@fluidframework/cell":"2.0.0-dev.6.4.0.191258","@fluidframework/matrix":"2.0.0-dev.6.4.0.191258","@fluidframework/counter":"2.0.0-dev.6.4.0.191258","@fluidframework/sequence":"2.0.0-dev.6.4.0.191258","@fluid-experimental/tree2":"2.0.0-dev.6.4.0.191258","@fluid-internal/client-utils":"2.0.0-dev.6.4.0.191258","@fluidframework/core-interfaces":"2.0.0-dev.6.4.0.191258","@fluidframework/telemetry-utils":"2.0.0-dev.6.4.0.191258","@fluidframework/container-loader":"2.0.0-dev.6.4.0.191258","@fluidframework/shared-object-base":"2.0.0-dev.6.4.0.191258","@fluidframework/protocol-definitions":"^1.1.0","@fluidframework/container-definitions":"2.0.0-dev.6.4.0.191258","@fluidframework/datastore-definitions":"2.0.0-dev.6.4.0.191258"},"_hasShrinkwrap":false,"readmeFilename":"README.md","typeValidation":{"broken":{}},"devDependencies":{"c8":"^7.7.1","chai":"^4.2.0","mocha":"^10.2.0","eslint":"~8.6.0","events":"^3.1.0","moment":"^2.21.0","rimraf":"^4.4.0","prettier":"~2.6.2","copyfiles":"^2.4.1","cross-env":"^7.0.3","typescript":"~4.5.5","@types/chai":"^4.0.0","@types/mocha":"^9.1.1","@types/events":"^3.0.0","mocha-multi-reporters":"^1.5.1","@fluid-tools/build-cli":"^0.22.0","eslint-config-prettier":"~8.5.0","@microsoft/api-extractor":"^7.34.4","eslint-plugin-chai-expect":"~3.0.0","mocha-json-output-reporter":"^2.0.1","@fluidframework/build-tools":"^0.22.0","@fluidframework/build-common":"^2.0.0","@fluidframework/mocha-test-setup":"2.0.0-dev.6.4.0.191258","@fluidframework/driver-definitions":"2.0.0-dev.6.4.0.191258","@fluidframework/test-runtime-utils":"2.0.0-dev.6.4.0.191258","@fluidframework/eslint-config-fluid":"^2.1.0","@fluid-experimental/devtools-core-previous":"npm:@fluid-experimental/devtools-core@2.0.0-internal.6.3.0"},"_npmOperationalInternal":{"tmp":"tmp/devtools-core_2.0.0-dev.6.4.0.191258_1695095451792_0.3787604139185379","host":"s3://npm-registry-packages"}},"2.0.0-dev.6.4.0.191457":{"name":"@fluid-experimental/devtools-core","version":"2.0.0-dev.6.4.0.191457","author":{"name":"Microsoft and contributors"},"license":"MIT","_id":"@fluid-experimental/devtools-core@2.0.0-dev.6.4.0.191457","maintainers":[{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},{"name":"curtisman","email":"curtism@microsoft.com"}],"homepage":"https://fluidframework.com","bugs":{"url":"https://github.com/microsoft/FluidFramework/issues"},"c8":{"all":true,"exclude":["src/test/**/*.ts","dist/test/**/*.js"],"include":["src/**/*.ts","dist/**/*.js"],"reporter":["cobertura","html","text"],"cache-dir":"nyc/.cache","report-dir":"nyc/report","temp-directory":"nyc/.nyc_output","exclude-after-remap":false},"dist":{"shasum":"2732bf5ab53e337496e01d816f8e6319710af560","tarball":"https://registry.npmjs.org/@fluid-experimental/devtools-core/-/devtools-core-2.0.0-dev.6.4.0.191457.tgz","fileCount":501,"integrity":"sha512-i+3ZJQeHuktQBs8Iw8Kbeb3B3O6AJoGF3XmOmXRK+f/5jGDySMbV6o4YMmsQp6T8tX6R2A0A28Swzfg0eJNH3Q==","signatures":[{"sig":"MEQCIE8j5uVg9CRVXkWE2bWZp0gN14DG0yfziNlubUhg6AQxAiBJm2tlRGKeyDgBx7RYTE8LlUEofR4xsksMOjlEHu/2xA==","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}],"unpackedSize":1367856},"main":"dist/index.js","_from":"file:fluid-experimental-devtools-core-2.0.0-dev.6.4.0.191457.tgz","types":"dist/index.d.ts","module":"lib/index.js","readme":"# @fluid-experimental/devtools-core\n\nThis library contains developer tools for use alongside the Fluid Framework.\nIt is used to power our associated [browser extension][browser-extension].\n\n- Chrome: \n- Edge: \n\n\n\n\n\n\n## Installation\n\nTo get started, install the package by running the following command:\n\n```bash\nnpm i @fluid-experimental/devtools-core -D\n```\n\n\n\n\n\n## Usage\n\nThe Devtools' API surface is designed to fit nicely into most application flows.\n\n### Initialization\n\nTo initialize a devtools session for your container, call [`initializeDevtools`][initialize-devtools-docs].\nThis function accepts a `DevtoolsLogger` for receiving Fluid telemetry from your application, a list of initial Fluid\n`Containers` to associate with the session, and (optionally) customized data visualization configurations for visualizing\n`Container` data.\n\n#### About the [`DevtoolsLogger`][devtools-logger-docs]\n\nThe `DevtoolsLogger` is an optional piece when calling `initializeDevtools` but it is strongly recommended that you use\nit because several features in Fluid Devtools are powered by the telemetry that Fluid Framework generates, and this\nlogger is the way in which that telemetry gets into Fluid Devtools.\n\nYou can obtain a `DevtoolsLogger` by calling its constructor, and then should pass it to `initializeDevtools` _and_\nto the `Loader` instance you'll use to create/load Containers as shown below.\nThis way the logger will receive all the telemetry generated by Fluid Framework in your application, and forward it to\nFluid Devtools as necessary.\n\n```typescript\nimport { DevtoolsLogger, initializeDevtools } from \"@fluid-experimental/devtools-core\";\n\n// Instantiate the logger\nconst devtoolsLogger = new DevtoolsLogger();\n\n// Pass the logger when instantiating the Loader\nconst loader = new Loader({\n\tlogger: devtoolsLogger,\n\t// Other necessary properties ...\n});\n\n// Use the Loader to create (and optionally, attach) a Container\nconst container = await loader.createDetachedContainer(/* params */);\nawait container.attach(/* params */);\n\n// Initialize the Devtools passing the logger and your Container.\n// The Container could be added later as well with devtools.registerContainerDevtools().\nconst devtools = initializeDevtools({\n\tlogger: devtoolsLogger,\n\tinitialContainers: [\n\t\t{\n\t\t\tcontainer,\n\t\t\tcontainerKey: \"My Container\",\n\t\t},\n\t],\n});\n```\n\nIf you're working with `AzureClient` instead of lower-level APIs like the one described above, you probably want to\nrefer to the [@fluid-experimental/devtools package][devtools-package] instead of this one.\n\nDuring local development the recommendation is that your application should receive the `DevtoolsLogger` instance _instead_\nof any logger it would normally receive when deployed to a real environment, to avoid local development activity from\nmixing with real telemetry.\nIf you still want to provide a real application logger and use the Fluid Devtools features that are powered by telemetry\nat the same time, you can pass an existing logger to the `DevtoolsLogger` constructor and it will forward all telemetry\nit receives to that logger as well:\n\n```typescript\nimport { DevtoolsLogger } from \"@fluid-experimental/devtools-core\";\n\n// Your application's logger\nconst yourApplicationLogger = getInstanceOfYourApplicationLogger();\n\nconst devtoolsLogger = new DevtoolsLogger(yourApplicationLogger);\n\n// Pass devtoolsLogger to initializeDevtools() and to your application as described above\n```\n\n### Clean-up\n\nThe Devtools object is managed as a global singleton.\nThat singleton is automatically cleaned up prior to the Window's \"unload\" event.\nSo typical application flows likely won't need to worry about cleanup.\nThat said, if you wish to have tighter control over when the Devtools are torn down, you can simply call the `dispose` method on the handle returned by [initialization](#initialization).\n\n## Contributing to the package\n\n### Build\n\nTo build the package locally, first ensure you have run `pnpm install` from the root of the mono-repo.\nNext, to build the code, run `npm run build` from the root of the mono-repo, or use [fluid-build](https://github.com/microsoft/FluidFramework/tree/main/build-tools/packages/build-tools#running-fluid-build-command-line) via `fluid-build -t build`.\n\n- Note: Once you have run a build from the root, assuming no other changes outside of this package, you may run `npm run build` directly within this directory for a faster build.\n If you make changes to any of this package's local dependencies, you will need to run a build again from the root before building again from directly within this package.\n\n### Test\n\nTo run the tests, first ensure you have followed the [build](#build) steps above.\nNext, run `npm run test` from a terminal within this directory.\n\n\n\n\n\n\n\n## API Documentation\n\nAPI documentation for **@fluid-experimental/devtools-core** is available at .\n\n\n\n\n\n\n\n\n\n\n## Contribution Guidelines\n\nThere are many ways to [contribute](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md) to Fluid.\n\n- Participate in Q&A in our [GitHub Discussions](https://github.com/microsoft/FluidFramework/discussions).\n- [Submit bugs](https://github.com/microsoft/FluidFramework/issues) and help us verify fixes as they are checked in.\n- Review the [source code changes](https://github.com/microsoft/FluidFramework/pulls).\n- [Contribute bug fixes](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md).\n\nDetailed instructions for working in the repo can be found in the [Wiki](https://github.com/microsoft/FluidFramework/wiki).\n\nThis project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).\nFor more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\nUse of these trademarks or logos must follow Microsoft’s [Trademark & Brand Guidelines](https://www.microsoft.com/trademarks).\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n\n\n\n## Help\n\nNot finding what you're looking for in this README? Check out our [GitHub\nWiki](https://github.com/microsoft/FluidFramework/wiki) or [fluidframework.com](https://fluidframework.com/docs/).\n\nStill not finding what you're looking for? Please [file an\nissue](https://github.com/microsoft/FluidFramework/wiki/Submitting-Bugs-and-Feature-Requests).\n\nThank you!\n\n\n\n\n\n\n\n\n\n\n## Trademark\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\n\nUse of these trademarks or logos must follow Microsoft's [Trademark & Brand\nGuidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general).\n\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n[initialize-devtools-docs]: https://fluidframework.com/docs/apis/devtools-core#initializedevtools-function\n[devtools-logger-docs]: https://fluidframework.com/docs/apis/devtools-core/devtoolslogger-class\n[devtools-package]: https://www.npmjs.com/package/@fluid-experimental/devtools\n[browser-extension]: https://github.com/microsoft/FluidFramework/tree/main/packages/tools/devtools/devtools-browser-extension\n","scripts":{"tsc":"tsc","lint":"npm run prettier && npm run eslint","test":"npm run test:mocha","build":"fluid-build . --task build","clean":"rimraf --glob '_api-extractor-temp' 'nyc' 'dist' 'lib' '*.tsbuildinfo' '*.build.log'","eslint":"eslint src","format":"npm run prettier:fix","rebuild":"npm run clean && npm run build","lint:fix":"npm run prettier:fix && npm run eslint:fix","prettier":"prettier --check . --ignore-path ../../../../.prettierignore","tsc:watch":"tsc --watch","build:docs":"api-extractor run --local && copyfiles -u 1 ./_api-extractor-temp/doc-models/* ../../../../_api-extractor-temp/","eslint:fix":"eslint src --fix","test:mocha":"mocha dist/**/*.test.js --exit","build:esnext":"tsc --project ./tsconfig.esnext.json","build:genver":"gen-version","prettier:fix":"prettier --write . --ignore-path ../../../../.prettierignore","build:compile":"fluid-build . --task compile","ci:build:docs":"api-extractor run && copyfiles -u 1 ./_api-extractor-temp/doc-models/* ../../../../_api-extractor-temp/","test:coverage":"c8 npm test","typetests:gen":"fluid-type-test-generator","build:commonjs":"fluid-build . --task commonjs","format-and-build":"npm run format && npm run build","typetests:prepare":"flub typetests --dir . --reset --previous --normalize","format-and-compile":"npm run format && npm run build:compile"},"_npmUser":{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},"_resolved":"/mnt/vss/_work/1/pack/scoped/fluid-experimental-devtools-core-2.0.0-dev.6.4.0.191457.tgz","_integrity":"sha512-i+3ZJQeHuktQBs8Iw8Kbeb3B3O6AJoGF3XmOmXRK+f/5jGDySMbV6o4YMmsQp6T8tX6R2A0A28Swzfg0eJNH3Q==","fluidBuild":{"tasks":{"tsc":["...","typetests:gen"]}},"repository":{"url":"git+https://github.com/microsoft/FluidFramework.git","type":"git","directory":"packages/tools/devtools/devtools-core"},"_npmVersion":"9.6.7","description":"Fluid Framework developer tools core functionality","directories":{},"sideEffects":false,"_nodeVersion":"18.17.1","dependencies":{"@fluidframework/map":"2.0.0-dev.6.4.0.191457","@fluidframework/cell":"2.0.0-dev.6.4.0.191457","@fluidframework/matrix":"2.0.0-dev.6.4.0.191457","@fluidframework/counter":"2.0.0-dev.6.4.0.191457","@fluidframework/sequence":"2.0.0-dev.6.4.0.191457","@fluid-experimental/tree2":"2.0.0-dev.6.4.0.191457","@fluid-internal/client-utils":"2.0.0-dev.6.4.0.191457","@fluidframework/core-interfaces":"2.0.0-dev.6.4.0.191457","@fluidframework/telemetry-utils":"2.0.0-dev.6.4.0.191457","@fluidframework/container-loader":"2.0.0-dev.6.4.0.191457","@fluidframework/shared-object-base":"2.0.0-dev.6.4.0.191457","@fluidframework/protocol-definitions":"^1.1.0","@fluidframework/container-definitions":"2.0.0-dev.6.4.0.191457","@fluidframework/datastore-definitions":"2.0.0-dev.6.4.0.191457"},"_hasShrinkwrap":false,"readmeFilename":"README.md","typeValidation":{"broken":{}},"devDependencies":{"c8":"^7.7.1","chai":"^4.2.0","mocha":"^10.2.0","eslint":"~8.6.0","events":"^3.1.0","moment":"^2.21.0","rimraf":"^4.4.0","prettier":"~2.6.2","copyfiles":"^2.4.1","cross-env":"^7.0.3","typescript":"~4.5.5","@types/chai":"^4.0.0","@types/mocha":"^9.1.1","@types/events":"^3.0.0","mocha-multi-reporters":"^1.5.1","@fluid-tools/build-cli":"^0.22.0","eslint-config-prettier":"~8.5.0","@microsoft/api-extractor":"^7.34.4","eslint-plugin-chai-expect":"~3.0.0","mocha-json-output-reporter":"^2.0.1","@fluidframework/build-tools":"^0.22.0","@fluidframework/build-common":"^2.0.0","@fluidframework/mocha-test-setup":"2.0.0-dev.6.4.0.191457","@fluidframework/driver-definitions":"2.0.0-dev.6.4.0.191457","@fluidframework/test-runtime-utils":"2.0.0-dev.6.4.0.191457","@fluidframework/eslint-config-fluid":"^2.1.0","@fluid-experimental/devtools-core-previous":"npm:@fluid-experimental/devtools-core@2.0.0-internal.6.3.0"},"_npmOperationalInternal":{"tmp":"tmp/devtools-core_2.0.0-dev.6.4.0.191457_1695165566170_0.4609069989657404","host":"s3://npm-registry-packages"}},"2.0.0-dev.6.4.0.191515":{"name":"@fluid-experimental/devtools-core","version":"2.0.0-dev.6.4.0.191515","author":{"name":"Microsoft and contributors"},"license":"MIT","_id":"@fluid-experimental/devtools-core@2.0.0-dev.6.4.0.191515","maintainers":[{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},{"name":"curtisman","email":"curtism@microsoft.com"}],"homepage":"https://fluidframework.com","bugs":{"url":"https://github.com/microsoft/FluidFramework/issues"},"c8":{"all":true,"exclude":["src/test/**/*.ts","dist/test/**/*.js"],"include":["src/**/*.ts","dist/**/*.js"],"reporter":["cobertura","html","text"],"cache-dir":"nyc/.cache","report-dir":"nyc/report","temp-directory":"nyc/.nyc_output","exclude-after-remap":false},"dist":{"shasum":"24096f8163f9336d6976c83e2323dda312478410","tarball":"https://registry.npmjs.org/@fluid-experimental/devtools-core/-/devtools-core-2.0.0-dev.6.4.0.191515.tgz","fileCount":501,"integrity":"sha512-veGjls0k9yVo9PSx0n9eLXr0fXNZUwoHBrSbP+Csu6OtVRFev2cnDtKP0AZkfdjkMY56GQ/N+KJIW78Hr/OWDw==","signatures":[{"sig":"MEQCIBtMmbQb1vA4cTH981xQ+bDj47y7nNTkmTXwv7aslrpHAiBG9h5rO1HHt+ulBs+LL1rtQrpKS1i97WxAgckEj6PbpQ==","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}],"unpackedSize":1367856},"main":"dist/index.js","_from":"file:fluid-experimental-devtools-core-2.0.0-dev.6.4.0.191515.tgz","types":"dist/index.d.ts","module":"lib/index.js","readme":"# @fluid-experimental/devtools-core\n\nThis library contains developer tools for use alongside the Fluid Framework.\nIt is used to power our associated [browser extension][browser-extension].\n\n- Chrome: \n- Edge: \n\n\n\n\n\n\n## Installation\n\nTo get started, install the package by running the following command:\n\n```bash\nnpm i @fluid-experimental/devtools-core -D\n```\n\n\n\n\n\n## Usage\n\nThe Devtools' API surface is designed to fit nicely into most application flows.\n\n### Initialization\n\nTo initialize a devtools session for your container, call [`initializeDevtools`][initialize-devtools-docs].\nThis function accepts a `DevtoolsLogger` for receiving Fluid telemetry from your application, a list of initial Fluid\n`Containers` to associate with the session, and (optionally) customized data visualization configurations for visualizing\n`Container` data.\n\n#### About the [`DevtoolsLogger`][devtools-logger-docs]\n\nThe `DevtoolsLogger` is an optional piece when calling `initializeDevtools` but it is strongly recommended that you use\nit because several features in Fluid Devtools are powered by the telemetry that Fluid Framework generates, and this\nlogger is the way in which that telemetry gets into Fluid Devtools.\n\nYou can obtain a `DevtoolsLogger` by calling its constructor, and then should pass it to `initializeDevtools` _and_\nto the `Loader` instance you'll use to create/load Containers as shown below.\nThis way the logger will receive all the telemetry generated by Fluid Framework in your application, and forward it to\nFluid Devtools as necessary.\n\n```typescript\nimport { DevtoolsLogger, initializeDevtools } from \"@fluid-experimental/devtools-core\";\n\n// Instantiate the logger\nconst devtoolsLogger = new DevtoolsLogger();\n\n// Pass the logger when instantiating the Loader\nconst loader = new Loader({\n\tlogger: devtoolsLogger,\n\t// Other necessary properties ...\n});\n\n// Use the Loader to create (and optionally, attach) a Container\nconst container = await loader.createDetachedContainer(/* params */);\nawait container.attach(/* params */);\n\n// Initialize the Devtools passing the logger and your Container.\n// The Container could be added later as well with devtools.registerContainerDevtools().\nconst devtools = initializeDevtools({\n\tlogger: devtoolsLogger,\n\tinitialContainers: [\n\t\t{\n\t\t\tcontainer,\n\t\t\tcontainerKey: \"My Container\",\n\t\t},\n\t],\n});\n```\n\nIf you're working with `AzureClient` instead of lower-level APIs like the one described above, you probably want to\nrefer to the [@fluid-experimental/devtools package][devtools-package] instead of this one.\n\nDuring local development the recommendation is that your application should receive the `DevtoolsLogger` instance _instead_\nof any logger it would normally receive when deployed to a real environment, to avoid local development activity from\nmixing with real telemetry.\nIf you still want to provide a real application logger and use the Fluid Devtools features that are powered by telemetry\nat the same time, you can pass an existing logger to the `DevtoolsLogger` constructor and it will forward all telemetry\nit receives to that logger as well:\n\n```typescript\nimport { DevtoolsLogger } from \"@fluid-experimental/devtools-core\";\n\n// Your application's logger\nconst yourApplicationLogger = getInstanceOfYourApplicationLogger();\n\nconst devtoolsLogger = new DevtoolsLogger(yourApplicationLogger);\n\n// Pass devtoolsLogger to initializeDevtools() and to your application as described above\n```\n\n### Clean-up\n\nThe Devtools object is managed as a global singleton.\nThat singleton is automatically cleaned up prior to the Window's \"unload\" event.\nSo typical application flows likely won't need to worry about cleanup.\nThat said, if you wish to have tighter control over when the Devtools are torn down, you can simply call the `dispose` method on the handle returned by [initialization](#initialization).\n\n## Contributing to the package\n\n### Build\n\nTo build the package locally, first ensure you have run `pnpm install` from the root of the mono-repo.\nNext, to build the code, run `npm run build` from the root of the mono-repo, or use [fluid-build](https://github.com/microsoft/FluidFramework/tree/main/build-tools/packages/build-tools#running-fluid-build-command-line) via `fluid-build -t build`.\n\n- Note: Once you have run a build from the root, assuming no other changes outside of this package, you may run `npm run build` directly within this directory for a faster build.\n If you make changes to any of this package's local dependencies, you will need to run a build again from the root before building again from directly within this package.\n\n### Test\n\nTo run the tests, first ensure you have followed the [build](#build) steps above.\nNext, run `npm run test` from a terminal within this directory.\n\n\n\n\n\n\n\n## API Documentation\n\nAPI documentation for **@fluid-experimental/devtools-core** is available at .\n\n\n\n\n\n\n\n\n\n\n## Contribution Guidelines\n\nThere are many ways to [contribute](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md) to Fluid.\n\n- Participate in Q&A in our [GitHub Discussions](https://github.com/microsoft/FluidFramework/discussions).\n- [Submit bugs](https://github.com/microsoft/FluidFramework/issues) and help us verify fixes as they are checked in.\n- Review the [source code changes](https://github.com/microsoft/FluidFramework/pulls).\n- [Contribute bug fixes](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md).\n\nDetailed instructions for working in the repo can be found in the [Wiki](https://github.com/microsoft/FluidFramework/wiki).\n\nThis project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).\nFor more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\nUse of these trademarks or logos must follow Microsoft’s [Trademark & Brand Guidelines](https://www.microsoft.com/trademarks).\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n\n\n\n## Help\n\nNot finding what you're looking for in this README? Check out our [GitHub\nWiki](https://github.com/microsoft/FluidFramework/wiki) or [fluidframework.com](https://fluidframework.com/docs/).\n\nStill not finding what you're looking for? Please [file an\nissue](https://github.com/microsoft/FluidFramework/wiki/Submitting-Bugs-and-Feature-Requests).\n\nThank you!\n\n\n\n\n\n\n\n\n\n\n## Trademark\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\n\nUse of these trademarks or logos must follow Microsoft's [Trademark & Brand\nGuidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general).\n\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n[initialize-devtools-docs]: https://fluidframework.com/docs/apis/devtools-core#initializedevtools-function\n[devtools-logger-docs]: https://fluidframework.com/docs/apis/devtools-core/devtoolslogger-class\n[devtools-package]: https://www.npmjs.com/package/@fluid-experimental/devtools\n[browser-extension]: https://github.com/microsoft/FluidFramework/tree/main/packages/tools/devtools/devtools-browser-extension\n","scripts":{"tsc":"tsc","lint":"npm run prettier && npm run eslint","test":"npm run test:mocha","build":"fluid-build . --task build","clean":"rimraf --glob '_api-extractor-temp' 'nyc' 'dist' 'lib' '*.tsbuildinfo' '*.build.log'","eslint":"eslint src","format":"npm run prettier:fix","rebuild":"npm run clean && npm run build","lint:fix":"npm run prettier:fix && npm run eslint:fix","prettier":"prettier --check . --ignore-path ../../../../.prettierignore","tsc:watch":"tsc --watch","build:docs":"api-extractor run --local && copyfiles -u 1 ./_api-extractor-temp/doc-models/* ../../../../_api-extractor-temp/","eslint:fix":"eslint src --fix","test:mocha":"mocha dist/**/*.test.js --exit","build:esnext":"tsc --project ./tsconfig.esnext.json","build:genver":"gen-version","prettier:fix":"prettier --write . --ignore-path ../../../../.prettierignore","build:compile":"fluid-build . --task compile","ci:build:docs":"api-extractor run && copyfiles -u 1 ./_api-extractor-temp/doc-models/* ../../../../_api-extractor-temp/","test:coverage":"c8 npm test","typetests:gen":"fluid-type-test-generator","build:commonjs":"fluid-build . --task commonjs","format-and-build":"npm run format && npm run build","typetests:prepare":"flub typetests --dir . --reset --previous --normalize","format-and-compile":"npm run format && npm run build:compile"},"_npmUser":{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},"_resolved":"/mnt/vss/_work/1/pack/scoped/fluid-experimental-devtools-core-2.0.0-dev.6.4.0.191515.tgz","_integrity":"sha512-veGjls0k9yVo9PSx0n9eLXr0fXNZUwoHBrSbP+Csu6OtVRFev2cnDtKP0AZkfdjkMY56GQ/N+KJIW78Hr/OWDw==","fluidBuild":{"tasks":{"tsc":["...","typetests:gen"]}},"repository":{"url":"git+https://github.com/microsoft/FluidFramework.git","type":"git","directory":"packages/tools/devtools/devtools-core"},"_npmVersion":"9.6.7","description":"Fluid Framework developer tools core functionality","directories":{},"sideEffects":false,"_nodeVersion":"18.17.1","dependencies":{"@fluidframework/map":"2.0.0-dev.6.4.0.191515","@fluidframework/cell":"2.0.0-dev.6.4.0.191515","@fluidframework/matrix":"2.0.0-dev.6.4.0.191515","@fluidframework/counter":"2.0.0-dev.6.4.0.191515","@fluidframework/sequence":"2.0.0-dev.6.4.0.191515","@fluid-experimental/tree2":"2.0.0-dev.6.4.0.191515","@fluid-internal/client-utils":"2.0.0-dev.6.4.0.191515","@fluidframework/core-interfaces":"2.0.0-dev.6.4.0.191515","@fluidframework/telemetry-utils":"2.0.0-dev.6.4.0.191515","@fluidframework/container-loader":"2.0.0-dev.6.4.0.191515","@fluidframework/shared-object-base":"2.0.0-dev.6.4.0.191515","@fluidframework/protocol-definitions":"^1.1.0","@fluidframework/container-definitions":"2.0.0-dev.6.4.0.191515","@fluidframework/datastore-definitions":"2.0.0-dev.6.4.0.191515"},"_hasShrinkwrap":false,"readmeFilename":"README.md","typeValidation":{"broken":{}},"devDependencies":{"c8":"^7.7.1","chai":"^4.2.0","mocha":"^10.2.0","eslint":"~8.6.0","events":"^3.1.0","moment":"^2.21.0","rimraf":"^4.4.0","prettier":"~2.6.2","copyfiles":"^2.4.1","cross-env":"^7.0.3","typescript":"~4.5.5","@types/chai":"^4.0.0","@types/mocha":"^9.1.1","@types/events":"^3.0.0","mocha-multi-reporters":"^1.5.1","@fluid-tools/build-cli":"^0.22.0","eslint-config-prettier":"~8.5.0","@microsoft/api-extractor":"^7.34.4","eslint-plugin-chai-expect":"~3.0.0","mocha-json-output-reporter":"^2.0.1","@fluidframework/build-tools":"^0.22.0","@fluidframework/build-common":"^2.0.0","@fluidframework/mocha-test-setup":"2.0.0-dev.6.4.0.191515","@fluidframework/driver-definitions":"2.0.0-dev.6.4.0.191515","@fluidframework/test-runtime-utils":"2.0.0-dev.6.4.0.191515","@fluidframework/eslint-config-fluid":"^2.1.0","@fluid-experimental/devtools-core-previous":"npm:@fluid-experimental/devtools-core@2.0.0-internal.6.3.0"},"_npmOperationalInternal":{"tmp":"tmp/devtools-core_2.0.0-dev.6.4.0.191515_1695169953827_0.6937794661461303","host":"s3://npm-registry-packages"}},"2.0.0-dev.6.4.0.192049":{"name":"@fluid-experimental/devtools-core","version":"2.0.0-dev.6.4.0.192049","author":{"name":"Microsoft and contributors"},"license":"MIT","_id":"@fluid-experimental/devtools-core@2.0.0-dev.6.4.0.192049","maintainers":[{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},{"name":"curtisman","email":"curtism@microsoft.com"}],"homepage":"https://fluidframework.com","bugs":{"url":"https://github.com/microsoft/FluidFramework/issues"},"c8":{"all":true,"exclude":["src/test/**/*.ts","dist/test/**/*.js"],"include":["src/**/*.ts","dist/**/*.js"],"reporter":["cobertura","html","text"],"cache-dir":"nyc/.cache","report-dir":"nyc/report","temp-directory":"nyc/.nyc_output","exclude-after-remap":false},"dist":{"shasum":"c7d9a025f754b31a9f46f69e413fad01498cad4f","tarball":"https://registry.npmjs.org/@fluid-experimental/devtools-core/-/devtools-core-2.0.0-dev.6.4.0.192049.tgz","fileCount":501,"integrity":"sha512-UVEB1pgE9IzlfEtTMXRyVSd0Mn+wYQ0X3crwuIGvDNsX9Ib4A/5QDnrtowOTUDCYLe2N4QOesjEOM0UNwr6PuA==","signatures":[{"sig":"MEYCIQCmKL2zKpdKogKwqE8jwoEuDpXR2MRv0yghEV/14rURogIhAJ4/Oz07tVHwX284xwlpesn0ChvUqYNhA74Tv8uC7NZc","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}],"unpackedSize":1367856},"main":"dist/index.js","_from":"file:fluid-experimental-devtools-core-2.0.0-dev.6.4.0.192049.tgz","types":"dist/index.d.ts","module":"lib/index.js","readme":"# @fluid-experimental/devtools-core\n\nThis library contains developer tools for use alongside the Fluid Framework.\nIt is used to power our associated [browser extension][browser-extension].\n\n- Chrome: \n- Edge: \n\n\n\n\n\n\n## Installation\n\nTo get started, install the package by running the following command:\n\n```bash\nnpm i @fluid-experimental/devtools-core -D\n```\n\n\n\n\n\n## Usage\n\nThe Devtools' API surface is designed to fit nicely into most application flows.\n\n### Initialization\n\nTo initialize a devtools session for your container, call [`initializeDevtools`][initialize-devtools-docs].\nThis function accepts a `DevtoolsLogger` for receiving Fluid telemetry from your application, a list of initial Fluid\n`Containers` to associate with the session, and (optionally) customized data visualization configurations for visualizing\n`Container` data.\n\n#### About the [`DevtoolsLogger`][devtools-logger-docs]\n\nThe `DevtoolsLogger` is an optional piece when calling `initializeDevtools` but it is strongly recommended that you use\nit because several features in Fluid Devtools are powered by the telemetry that Fluid Framework generates, and this\nlogger is the way in which that telemetry gets into Fluid Devtools.\n\nYou can obtain a `DevtoolsLogger` by calling its constructor, and then should pass it to `initializeDevtools` _and_\nto the `Loader` instance you'll use to create/load Containers as shown below.\nThis way the logger will receive all the telemetry generated by Fluid Framework in your application, and forward it to\nFluid Devtools as necessary.\n\n```typescript\nimport { DevtoolsLogger, initializeDevtools } from \"@fluid-experimental/devtools-core\";\n\n// Instantiate the logger\nconst devtoolsLogger = new DevtoolsLogger();\n\n// Pass the logger when instantiating the Loader\nconst loader = new Loader({\n\tlogger: devtoolsLogger,\n\t// Other necessary properties ...\n});\n\n// Use the Loader to create (and optionally, attach) a Container\nconst container = await loader.createDetachedContainer(/* params */);\nawait container.attach(/* params */);\n\n// Initialize the Devtools passing the logger and your Container.\n// The Container could be added later as well with devtools.registerContainerDevtools().\nconst devtools = initializeDevtools({\n\tlogger: devtoolsLogger,\n\tinitialContainers: [\n\t\t{\n\t\t\tcontainer,\n\t\t\tcontainerKey: \"My Container\",\n\t\t},\n\t],\n});\n```\n\nIf you're working with `AzureClient` instead of lower-level APIs like the one described above, you probably want to\nrefer to the [@fluid-experimental/devtools package][devtools-package] instead of this one.\n\nDuring local development the recommendation is that your application should receive the `DevtoolsLogger` instance _instead_\nof any logger it would normally receive when deployed to a real environment, to avoid local development activity from\nmixing with real telemetry.\nIf you still want to provide a real application logger and use the Fluid Devtools features that are powered by telemetry\nat the same time, you can pass an existing logger to the `DevtoolsLogger` constructor and it will forward all telemetry\nit receives to that logger as well:\n\n```typescript\nimport { DevtoolsLogger } from \"@fluid-experimental/devtools-core\";\n\n// Your application's logger\nconst yourApplicationLogger = getInstanceOfYourApplicationLogger();\n\nconst devtoolsLogger = new DevtoolsLogger(yourApplicationLogger);\n\n// Pass devtoolsLogger to initializeDevtools() and to your application as described above\n```\n\n### Clean-up\n\nThe Devtools object is managed as a global singleton.\nThat singleton is automatically cleaned up prior to the Window's \"unload\" event.\nSo typical application flows likely won't need to worry about cleanup.\nThat said, if you wish to have tighter control over when the Devtools are torn down, you can simply call the `dispose` method on the handle returned by [initialization](#initialization).\n\n## Contributing to the package\n\n### Build\n\nTo build the package locally, first ensure you have run `pnpm install` from the root of the mono-repo.\nNext, to build the code, run `npm run build` from the root of the mono-repo, or use [fluid-build](https://github.com/microsoft/FluidFramework/tree/main/build-tools/packages/build-tools#running-fluid-build-command-line) via `fluid-build -t build`.\n\n- Note: Once you have run a build from the root, assuming no other changes outside of this package, you may run `npm run build` directly within this directory for a faster build.\n If you make changes to any of this package's local dependencies, you will need to run a build again from the root before building again from directly within this package.\n\n### Test\n\nTo run the tests, first ensure you have followed the [build](#build) steps above.\nNext, run `npm run test` from a terminal within this directory.\n\n\n\n\n\n\n\n## API Documentation\n\nAPI documentation for **@fluid-experimental/devtools-core** is available at .\n\n\n\n\n\n\n\n\n\n\n## Contribution Guidelines\n\nThere are many ways to [contribute](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md) to Fluid.\n\n- Participate in Q&A in our [GitHub Discussions](https://github.com/microsoft/FluidFramework/discussions).\n- [Submit bugs](https://github.com/microsoft/FluidFramework/issues) and help us verify fixes as they are checked in.\n- Review the [source code changes](https://github.com/microsoft/FluidFramework/pulls).\n- [Contribute bug fixes](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md).\n\nDetailed instructions for working in the repo can be found in the [Wiki](https://github.com/microsoft/FluidFramework/wiki).\n\nThis project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).\nFor more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\nUse of these trademarks or logos must follow Microsoft’s [Trademark & Brand Guidelines](https://www.microsoft.com/trademarks).\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n\n\n\n## Help\n\nNot finding what you're looking for in this README? Check out our [GitHub\nWiki](https://github.com/microsoft/FluidFramework/wiki) or [fluidframework.com](https://fluidframework.com/docs/).\n\nStill not finding what you're looking for? Please [file an\nissue](https://github.com/microsoft/FluidFramework/wiki/Submitting-Bugs-and-Feature-Requests).\n\nThank you!\n\n\n\n\n\n\n\n\n\n\n## Trademark\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\n\nUse of these trademarks or logos must follow Microsoft's [Trademark & Brand\nGuidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general).\n\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n[initialize-devtools-docs]: https://fluidframework.com/docs/apis/devtools-core#initializedevtools-function\n[devtools-logger-docs]: https://fluidframework.com/docs/apis/devtools-core/devtoolslogger-class\n[devtools-package]: https://www.npmjs.com/package/@fluid-experimental/devtools\n[browser-extension]: https://github.com/microsoft/FluidFramework/tree/main/packages/tools/devtools/devtools-browser-extension\n","scripts":{"tsc":"tsc","lint":"npm run prettier && npm run eslint","test":"npm run test:mocha","build":"fluid-build . --task build","clean":"rimraf --glob '_api-extractor-temp' 'nyc' 'dist' 'lib' '*.tsbuildinfo' '*.build.log'","eslint":"eslint src","format":"npm run prettier:fix","rebuild":"npm run clean && npm run build","lint:fix":"npm run prettier:fix && npm run eslint:fix","prettier":"prettier --check . --ignore-path ../../../../.prettierignore","tsc:watch":"tsc --watch","build:docs":"api-extractor run --local && copyfiles -u 1 ./_api-extractor-temp/doc-models/* ../../../../_api-extractor-temp/","eslint:fix":"eslint src --fix","test:mocha":"mocha dist/**/*.test.js --exit","build:esnext":"tsc --project ./tsconfig.esnext.json","build:genver":"gen-version","prettier:fix":"prettier --write . --ignore-path ../../../../.prettierignore","build:compile":"fluid-build . --task compile","ci:build:docs":"api-extractor run && copyfiles -u 1 ./_api-extractor-temp/doc-models/* ../../../../_api-extractor-temp/","test:coverage":"c8 npm test","typetests:gen":"fluid-type-test-generator","build:commonjs":"fluid-build . --task commonjs","format-and-build":"npm run format && npm run build","typetests:prepare":"flub typetests --dir . --reset --previous --normalize","format-and-compile":"npm run format && npm run build:compile"},"_npmUser":{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},"_resolved":"/mnt/vss/_work/1/pack/scoped/fluid-experimental-devtools-core-2.0.0-dev.6.4.0.192049.tgz","_integrity":"sha512-UVEB1pgE9IzlfEtTMXRyVSd0Mn+wYQ0X3crwuIGvDNsX9Ib4A/5QDnrtowOTUDCYLe2N4QOesjEOM0UNwr6PuA==","fluidBuild":{"tasks":{"tsc":["...","typetests:gen"]}},"repository":{"url":"git+https://github.com/microsoft/FluidFramework.git","type":"git","directory":"packages/tools/devtools/devtools-core"},"_npmVersion":"9.6.7","description":"Fluid Framework developer tools core functionality","directories":{},"sideEffects":false,"_nodeVersion":"18.17.1","dependencies":{"@fluidframework/map":"2.0.0-dev.6.4.0.192049","@fluidframework/cell":"2.0.0-dev.6.4.0.192049","@fluidframework/matrix":"2.0.0-dev.6.4.0.192049","@fluidframework/counter":"2.0.0-dev.6.4.0.192049","@fluidframework/sequence":"2.0.0-dev.6.4.0.192049","@fluid-experimental/tree2":"2.0.0-dev.6.4.0.192049","@fluid-internal/client-utils":"2.0.0-dev.6.4.0.192049","@fluidframework/core-interfaces":"2.0.0-dev.6.4.0.192049","@fluidframework/telemetry-utils":"2.0.0-dev.6.4.0.192049","@fluidframework/container-loader":"2.0.0-dev.6.4.0.192049","@fluidframework/shared-object-base":"2.0.0-dev.6.4.0.192049","@fluidframework/protocol-definitions":"^1.1.0","@fluidframework/container-definitions":"2.0.0-dev.6.4.0.192049","@fluidframework/datastore-definitions":"2.0.0-dev.6.4.0.192049"},"_hasShrinkwrap":false,"readmeFilename":"README.md","typeValidation":{"broken":{}},"devDependencies":{"c8":"^7.7.1","chai":"^4.2.0","mocha":"^10.2.0","eslint":"~8.6.0","events":"^3.1.0","moment":"^2.21.0","rimraf":"^4.4.0","prettier":"~2.6.2","copyfiles":"^2.4.1","cross-env":"^7.0.3","typescript":"~4.5.5","@types/chai":"^4.0.0","@types/mocha":"^9.1.1","@types/events":"^3.0.0","mocha-multi-reporters":"^1.5.1","@fluid-tools/build-cli":"^0.22.0","eslint-config-prettier":"~8.5.0","@microsoft/api-extractor":"^7.34.4","eslint-plugin-chai-expect":"~3.0.0","mocha-json-output-reporter":"^2.0.1","@fluidframework/build-tools":"^0.22.0","@fluidframework/build-common":"^2.0.0","@fluidframework/mocha-test-setup":"2.0.0-dev.6.4.0.192049","@fluidframework/driver-definitions":"2.0.0-dev.6.4.0.192049","@fluidframework/test-runtime-utils":"2.0.0-dev.6.4.0.192049","@fluidframework/eslint-config-fluid":"^2.1.0","@fluid-experimental/devtools-core-previous":"npm:@fluid-experimental/devtools-core@2.0.0-internal.6.3.0"},"_npmOperationalInternal":{"tmp":"tmp/devtools-core_2.0.0-dev.6.4.0.192049_1695252835730_0.5269796768773811","host":"s3://npm-registry-packages"}},"2.0.0-internal.6.3.3":{"name":"@fluid-experimental/devtools-core","version":"2.0.0-internal.6.3.3","author":{"name":"Microsoft and contributors"},"license":"MIT","_id":"@fluid-experimental/devtools-core@2.0.0-internal.6.3.3","maintainers":[{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},{"name":"curtisman","email":"curtism@microsoft.com"}],"homepage":"https://fluidframework.com","bugs":{"url":"https://github.com/microsoft/FluidFramework/issues"},"c8":{"all":true,"exclude":["src/test/**/*.ts","dist/test/**/*.js"],"include":["src/**/*.ts","dist/**/*.js"],"reporter":["cobertura","html","text"],"cache-dir":"nyc/.cache","report-dir":"nyc/report","temp-directory":"nyc/.nyc_output","exclude-after-remap":false},"dist":{"shasum":"6ed6fa86961c214fbb8fc4590ddf71ae66f1fb0e","tarball":"https://registry.npmjs.org/@fluid-experimental/devtools-core/-/devtools-core-2.0.0-internal.6.3.3.tgz","fileCount":501,"integrity":"sha512-vQYKw4zxSK2Bi8G5qF0n/b/8UgUalU1aHPm/IHC0Iv/N2593aM19uJKO81PE9ylAzEP2eIX7dt+l7CX2xYM13g==","signatures":[{"sig":"MEYCIQC2OKzVEggKXuLZZGE7UEgWhUb7trSSNygkDjLAyghr6gIhAKr2lwjXMM4qBBZweikHZBZEXTJXis2SmclNV3w10fEz","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}],"unpackedSize":1368137},"main":"dist/index.js","_from":"file:fluid-experimental-devtools-core-2.0.0-internal.6.3.3.tgz","types":"dist/index.d.ts","module":"lib/index.js","readme":"# @fluid-experimental/devtools-core\n\nThis library contains developer tools for use alongside the Fluid Framework.\nIt is used to power our associated [browser extension][browser-extension].\n\n- Chrome: \n- Edge: \n\n\n\n\n\n\n## Installation\n\nTo get started, install the package by running the following command:\n\n```bash\nnpm i @fluid-experimental/devtools-core -D\n```\n\n\n\n\n\n## Usage\n\nThe Devtools' API surface is designed to fit nicely into most application flows.\n\n### Initialization\n\nTo initialize a devtools session for your container, call [`initializeDevtools`][initialize-devtools-docs].\nThis function accepts a `DevtoolsLogger` for receiving Fluid telemetry from your application, a list of initial Fluid\n`Containers` to associate with the session, and (optionally) customized data visualization configurations for visualizing\n`Container` data.\n\n#### About the [`DevtoolsLogger`][devtools-logger-docs]\n\nThe `DevtoolsLogger` is an optional piece when calling `initializeDevtools` but it is strongly recommended that you use\nit because several features in Fluid Devtools are powered by the telemetry that Fluid Framework generates, and this\nlogger is the way in which that telemetry gets into Fluid Devtools.\n\nYou can obtain a `DevtoolsLogger` by calling its constructor, and then should pass it to `initializeDevtools` _and_\nto the `Loader` instance you'll use to create/load Containers as shown below.\nThis way the logger will receive all the telemetry generated by Fluid Framework in your application, and forward it to\nFluid Devtools as necessary.\n\n```typescript\nimport { DevtoolsLogger, initializeDevtools } from \"@fluid-experimental/devtools-core\";\n\n// Instantiate the logger\nconst devtoolsLogger = new DevtoolsLogger();\n\n// Pass the logger when instantiating the Loader\nconst loader = new Loader({\n\tlogger: devtoolsLogger,\n\t// Other necessary properties ...\n});\n\n// Use the Loader to create (and optionally, attach) a Container\nconst container = await loader.createDetachedContainer(/* params */);\nawait container.attach(/* params */);\n\n// Initialize the Devtools passing the logger and your Container.\n// The Container could be added later as well with devtools.registerContainerDevtools().\nconst devtools = initializeDevtools({\n\tlogger: devtoolsLogger,\n\tinitialContainers: [\n\t\t{\n\t\t\tcontainer,\n\t\t\tcontainerKey: \"My Container\",\n\t\t},\n\t],\n});\n```\n\nIf you're working with `AzureClient` instead of lower-level APIs like the one described above, you probably want to\nrefer to the [@fluid-experimental/devtools package][devtools-package] instead of this one.\n\nDuring local development the recommendation is that your application should receive the `DevtoolsLogger` instance _instead_\nof any logger it would normally receive when deployed to a real environment, to avoid local development activity from\nmixing with real telemetry.\nIf you still want to provide a real application logger and use the Fluid Devtools features that are powered by telemetry\nat the same time, you can pass an existing logger to the `DevtoolsLogger` constructor and it will forward all telemetry\nit receives to that logger as well:\n\n```typescript\nimport { DevtoolsLogger } from \"@fluid-experimental/devtools-core\";\n\n// Your application's logger\nconst yourApplicationLogger = getInstanceOfYourApplicationLogger();\n\nconst devtoolsLogger = new DevtoolsLogger(yourApplicationLogger);\n\n// Pass devtoolsLogger to initializeDevtools() and to your application as described above\n```\n\n### Clean-up\n\nThe Devtools object is managed as a global singleton.\nThat singleton is automatically cleaned up prior to the Window's \"unload\" event.\nSo typical application flows likely won't need to worry about cleanup.\nThat said, if you wish to have tighter control over when the Devtools are torn down, you can simply call the `dispose` method on the handle returned by [initialization](#initialization).\n\n## Contributing to the package\n\n### Build\n\nTo build the package locally, first ensure you have run `pnpm install` from the root of the mono-repo.\nNext, to build the code, run `npm run build` from the root of the mono-repo, or use [fluid-build](https://github.com/microsoft/FluidFramework/tree/main/build-tools/packages/build-tools#running-fluid-build-command-line) via `fluid-build -t build`.\n\n- Note: Once you have run a build from the root, assuming no other changes outside of this package, you may run `npm run build` directly within this directory for a faster build.\n If you make changes to any of this package's local dependencies, you will need to run a build again from the root before building again from directly within this package.\n\n### Test\n\nTo run the tests, first ensure you have followed the [build](#build) steps above.\nNext, run `npm run test` from a terminal within this directory.\n\n\n\n\n\n\n\n## API Documentation\n\nAPI documentation for **@fluid-experimental/devtools-core** is available at .\n\n\n\n\n\n\n\n\n\n\n## Contribution Guidelines\n\nThere are many ways to [contribute](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md) to Fluid.\n\n- Participate in Q&A in our [GitHub Discussions](https://github.com/microsoft/FluidFramework/discussions).\n- [Submit bugs](https://github.com/microsoft/FluidFramework/issues) and help us verify fixes as they are checked in.\n- Review the [source code changes](https://github.com/microsoft/FluidFramework/pulls).\n- [Contribute bug fixes](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md).\n\nDetailed instructions for working in the repo can be found in the [Wiki](https://github.com/microsoft/FluidFramework/wiki).\n\nThis project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).\nFor more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\nUse of these trademarks or logos must follow Microsoft’s [Trademark & Brand Guidelines](https://www.microsoft.com/trademarks).\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n\n\n\n## Help\n\nNot finding what you're looking for in this README? Check out our [GitHub\nWiki](https://github.com/microsoft/FluidFramework/wiki) or [fluidframework.com](https://fluidframework.com/docs/).\n\nStill not finding what you're looking for? Please [file an\nissue](https://github.com/microsoft/FluidFramework/wiki/Submitting-Bugs-and-Feature-Requests).\n\nThank you!\n\n\n\n\n\n\n\n\n\n\n## Trademark\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\n\nUse of these trademarks or logos must follow Microsoft's [Trademark & Brand\nGuidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general).\n\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n[initialize-devtools-docs]: https://fluidframework.com/docs/apis/devtools-core#initializedevtools-function\n[devtools-logger-docs]: https://fluidframework.com/docs/apis/devtools-core/devtoolslogger-class\n[devtools-package]: https://www.npmjs.com/package/@fluid-experimental/devtools\n[browser-extension]: https://github.com/microsoft/FluidFramework/tree/main/packages/tools/devtools/devtools-browser-extension\n","scripts":{"tsc":"tsc","lint":"npm run prettier && npm run eslint","test":"npm run test:mocha","build":"fluid-build . --task build","clean":"rimraf --glob '_api-extractor-temp' 'nyc' 'dist' 'lib' '*.tsbuildinfo' '*.build.log'","eslint":"eslint src","format":"npm run prettier:fix","rebuild":"npm run clean && npm run build","lint:fix":"npm run prettier:fix && npm run eslint:fix","prettier":"prettier --check . --ignore-path ../../../../.prettierignore","tsc:watch":"tsc --watch","build:docs":"api-extractor run --local && copyfiles -u 1 ./_api-extractor-temp/doc-models/* ../../../../_api-extractor-temp/","eslint:fix":"eslint src --fix","test:mocha":"mocha dist/**/*.test.js --exit","build:esnext":"tsc --project ./tsconfig.esnext.json","build:genver":"gen-version","prettier:fix":"prettier --write . --ignore-path ../../../../.prettierignore","build:compile":"fluid-build . --task compile","ci:build:docs":"api-extractor run && copyfiles -u 1 ./_api-extractor-temp/doc-models/* ../../../../_api-extractor-temp/","test:coverage":"c8 npm test","typetests:gen":"fluid-type-test-generator","build:commonjs":"fluid-build . --task commonjs","format-and-build":"npm run format && npm run build","typetests:prepare":"flub typetests --dir . --reset --previous --normalize","format-and-compile":"npm run format && npm run build:compile"},"_npmUser":{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},"_resolved":"/mnt/vss/_work/1/pack/scoped/fluid-experimental-devtools-core-2.0.0-internal.6.3.3.tgz","_integrity":"sha512-vQYKw4zxSK2Bi8G5qF0n/b/8UgUalU1aHPm/IHC0Iv/N2593aM19uJKO81PE9ylAzEP2eIX7dt+l7CX2xYM13g==","fluidBuild":{"tasks":{"tsc":["...","typetests:gen"]}},"repository":{"url":"git+https://github.com/microsoft/FluidFramework.git","type":"git","directory":"packages/tools/devtools/devtools-core"},"_npmVersion":"9.6.7","description":"Fluid Framework developer tools core functionality","directories":{},"sideEffects":false,"_nodeVersion":"18.17.1","dependencies":{"@fluidframework/map":">=2.0.0-internal.6.3.3 <2.0.0-internal.6.4.0","@fluidframework/cell":">=2.0.0-internal.6.3.3 <2.0.0-internal.6.4.0","@fluidframework/matrix":">=2.0.0-internal.6.3.3 <2.0.0-internal.6.4.0","@fluidframework/counter":">=2.0.0-internal.6.3.3 <2.0.0-internal.6.4.0","@fluidframework/sequence":">=2.0.0-internal.6.3.3 <2.0.0-internal.6.4.0","@fluid-experimental/tree2":">=2.0.0-internal.6.3.3 <2.0.0-internal.6.4.0","@fluid-internal/client-utils":">=2.0.0-internal.6.3.3 <2.0.0-internal.6.4.0","@fluidframework/core-interfaces":">=2.0.0-internal.6.3.3 <2.0.0-internal.6.4.0","@fluidframework/telemetry-utils":">=2.0.0-internal.6.3.3 <2.0.0-internal.6.4.0","@fluidframework/container-loader":">=2.0.0-internal.6.3.3 <2.0.0-internal.6.4.0","@fluidframework/shared-object-base":">=2.0.0-internal.6.3.3 <2.0.0-internal.6.4.0","@fluidframework/protocol-definitions":"^1.1.0","@fluidframework/container-definitions":">=2.0.0-internal.6.3.3 <2.0.0-internal.6.4.0","@fluidframework/datastore-definitions":">=2.0.0-internal.6.3.3 <2.0.0-internal.6.4.0"},"_hasShrinkwrap":false,"readmeFilename":"README.md","typeValidation":{"broken":{}},"devDependencies":{"c8":"^7.7.1","chai":"^4.2.0","mocha":"^10.2.0","eslint":"~8.6.0","events":"^3.1.0","moment":"^2.21.0","rimraf":"^4.4.0","prettier":"~2.6.2","copyfiles":"^2.4.1","cross-env":"^7.0.3","typescript":"~4.5.5","@types/chai":"^4.0.0","@types/mocha":"^9.1.1","@types/events":"^3.0.0","mocha-multi-reporters":"^1.5.1","@fluid-tools/build-cli":"^0.22.0","eslint-config-prettier":"~8.5.0","@microsoft/api-extractor":"^7.34.4","eslint-plugin-chai-expect":"~3.0.0","mocha-json-output-reporter":"^2.0.1","@fluidframework/build-tools":"^0.22.0","@fluidframework/build-common":"^2.0.0","@fluidframework/mocha-test-setup":">=2.0.0-internal.6.3.3 <2.0.0-internal.6.4.0","@fluidframework/driver-definitions":">=2.0.0-internal.6.3.3 <2.0.0-internal.6.4.0","@fluidframework/test-runtime-utils":">=2.0.0-internal.6.3.3 <2.0.0-internal.6.4.0","@fluidframework/eslint-config-fluid":"^2.1.0","@fluid-experimental/devtools-core-previous":"npm:@fluid-experimental/devtools-core@2.0.0-internal.6.3.1"},"_npmOperationalInternal":{"tmp":"tmp/devtools-core_2.0.0-internal.6.3.3_1695333200839_0.11602502783794555","host":"s3://npm-registry-packages"}},"2.0.0-internal.6.4.0":{"name":"@fluid-experimental/devtools-core","version":"2.0.0-internal.6.4.0","author":{"name":"Microsoft and contributors"},"license":"MIT","_id":"@fluid-experimental/devtools-core@2.0.0-internal.6.4.0","maintainers":[{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},{"name":"curtisman","email":"curtism@microsoft.com"}],"homepage":"https://fluidframework.com","bugs":{"url":"https://github.com/microsoft/FluidFramework/issues"},"c8":{"all":true,"exclude":["src/test/**/*.ts","dist/test/**/*.js"],"include":["src/**/*.ts","dist/**/*.js"],"reporter":["cobertura","html","text"],"cache-dir":"nyc/.cache","report-dir":"nyc/report","temp-directory":"nyc/.nyc_output","exclude-after-remap":false},"dist":{"shasum":"838215ac20ad71d474675f0232ba1dd08f65601d","tarball":"https://registry.npmjs.org/@fluid-experimental/devtools-core/-/devtools-core-2.0.0-internal.6.4.0.tgz","fileCount":501,"integrity":"sha512-71B5Gv8qv+wenHq/ryDdS1HTE+6yK0ag24jNKps+DyRjhIZczWjNW9nPU2vp9czfEEFVeZ6S0ZP974wUDRzEtg==","signatures":[{"sig":"MEYCIQC7tp5WazmVGJ/t39UJG6UOSoOvDmnnmmK/ouFHn0HuwQIhAJnudJbcP9t8epyn3e30SyW159H3hkhAj8VAwvtstdpL","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}],"unpackedSize":1374979},"main":"dist/index.js","_from":"file:fluid-experimental-devtools-core-2.0.0-internal.6.4.0.tgz","types":"dist/index.d.ts","module":"lib/index.js","readme":"# @fluid-experimental/devtools-core\n\nThis library contains developer tools for use alongside the Fluid Framework.\nIt is used to power our associated [browser extension][browser-extension].\n\n- Chrome: \n- Edge: \n\n\n\n\n\n\n## Installation\n\nTo get started, install the package by running the following command:\n\n```bash\nnpm i @fluid-experimental/devtools-core -D\n```\n\n\n\n\n\n## Usage\n\nThe Devtools' API surface is designed to fit nicely into most application flows.\n\n### Initialization\n\nTo initialize a devtools session for your container, call [`initializeDevtools`][initialize-devtools-docs].\nThis function accepts a `DevtoolsLogger` for receiving Fluid telemetry from your application, a list of initial Fluid\n`Containers` to associate with the session, and (optionally) customized data visualization configurations for visualizing\n`Container` data.\n\n#### About the [`DevtoolsLogger`][devtools-logger-docs]\n\nThe `DevtoolsLogger` is an optional piece when calling `initializeDevtools` but it is strongly recommended that you use\nit because several features in Fluid Devtools are powered by the telemetry that Fluid Framework generates, and this\nlogger is the way in which that telemetry gets into Fluid Devtools.\n\nYou can obtain a `DevtoolsLogger` by calling its constructor, and then should pass it to `initializeDevtools` _and_\nto the `Loader` instance you'll use to create/load Containers as shown below.\nThis way the logger will receive all the telemetry generated by Fluid Framework in your application, and forward it to\nFluid Devtools as necessary.\n\n```typescript\nimport { DevtoolsLogger, initializeDevtools } from \"@fluid-experimental/devtools-core\";\n\n// Instantiate the logger\nconst devtoolsLogger = new DevtoolsLogger();\n\n// Pass the logger when instantiating the Loader\nconst loader = new Loader({\n\tlogger: devtoolsLogger,\n\t// Other necessary properties ...\n});\n\n// Use the Loader to create (and optionally, attach) a Container\nconst container = await loader.createDetachedContainer(/* params */);\nawait container.attach(/* params */);\n\n// Initialize the Devtools passing the logger and your Container.\n// The Container could be added later as well with devtools.registerContainerDevtools().\nconst devtools = initializeDevtools({\n\tlogger: devtoolsLogger,\n\tinitialContainers: [\n\t\t{\n\t\t\tcontainer,\n\t\t\tcontainerKey: \"My Container\",\n\t\t},\n\t],\n});\n```\n\nIf you're working with `AzureClient` instead of lower-level APIs like the one described above, you probably want to\nrefer to the [@fluid-experimental/devtools package][devtools-package] instead of this one.\n\nDuring local development the recommendation is that your application should receive the `DevtoolsLogger` instance _instead_\nof any logger it would normally receive when deployed to a real environment, to avoid local development activity from\nmixing with real telemetry.\nIf you still want to provide a real application logger and use the Fluid Devtools features that are powered by telemetry\nat the same time, you can pass an existing logger to the `DevtoolsLogger` constructor and it will forward all telemetry\nit receives to that logger as well:\n\n```typescript\nimport { DevtoolsLogger } from \"@fluid-experimental/devtools-core\";\n\n// Your application's logger\nconst yourApplicationLogger = getInstanceOfYourApplicationLogger();\n\nconst devtoolsLogger = new DevtoolsLogger(yourApplicationLogger);\n\n// Pass devtoolsLogger to initializeDevtools() and to your application as described above\n```\n\n### Clean-up\n\nThe Devtools object is managed as a global singleton.\nThat singleton is automatically cleaned up prior to the Window's \"unload\" event.\nSo typical application flows likely won't need to worry about cleanup.\nThat said, if you wish to have tighter control over when the Devtools are torn down, you can simply call the `dispose` method on the handle returned by [initialization](#initialization).\n\n## Contributing to the package\n\n### Build\n\nTo build the package locally, first ensure you have run `pnpm install` from the root of the mono-repo.\nNext, to build the code, run `npm run build` from the root of the mono-repo, or use [fluid-build](https://github.com/microsoft/FluidFramework/tree/main/build-tools/packages/build-tools#running-fluid-build-command-line) via `fluid-build -t build`.\n\n- Note: Once you have run a build from the root, assuming no other changes outside of this package, you may run `npm run build` directly within this directory for a faster build.\n If you make changes to any of this package's local dependencies, you will need to run a build again from the root before building again from directly within this package.\n\n### Test\n\nTo run the tests, first ensure you have followed the [build](#build) steps above.\nNext, run `npm run test` from a terminal within this directory.\n\n\n\n\n\n\n\n## API Documentation\n\nAPI documentation for **@fluid-experimental/devtools-core** is available at .\n\n\n\n\n\n\n\n\n\n\n## Contribution Guidelines\n\nThere are many ways to [contribute](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md) to Fluid.\n\n- Participate in Q&A in our [GitHub Discussions](https://github.com/microsoft/FluidFramework/discussions).\n- [Submit bugs](https://github.com/microsoft/FluidFramework/issues) and help us verify fixes as they are checked in.\n- Review the [source code changes](https://github.com/microsoft/FluidFramework/pulls).\n- [Contribute bug fixes](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md).\n\nDetailed instructions for working in the repo can be found in the [Wiki](https://github.com/microsoft/FluidFramework/wiki).\n\nThis project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).\nFor more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\nUse of these trademarks or logos must follow Microsoft’s [Trademark & Brand Guidelines](https://www.microsoft.com/trademarks).\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n\n\n\n## Help\n\nNot finding what you're looking for in this README? Check out our [GitHub\nWiki](https://github.com/microsoft/FluidFramework/wiki) or [fluidframework.com](https://fluidframework.com/docs/).\n\nStill not finding what you're looking for? Please [file an\nissue](https://github.com/microsoft/FluidFramework/wiki/Submitting-Bugs-and-Feature-Requests).\n\nThank you!\n\n\n\n\n\n\n\n\n\n\n## Trademark\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\n\nUse of these trademarks or logos must follow Microsoft's [Trademark & Brand\nGuidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general).\n\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n[initialize-devtools-docs]: https://fluidframework.com/docs/apis/devtools-core#initializedevtools-function\n[devtools-logger-docs]: https://fluidframework.com/docs/apis/devtools-core/devtoolslogger-class\n[devtools-package]: https://www.npmjs.com/package/@fluid-experimental/devtools\n[browser-extension]: https://github.com/microsoft/FluidFramework/tree/main/packages/tools/devtools/devtools-browser-extension\n","scripts":{"tsc":"tsc","lint":"npm run prettier && npm run eslint","test":"npm run test:mocha","build":"fluid-build . --task build","clean":"rimraf --glob '_api-extractor-temp' 'nyc' 'dist' 'lib' '*.tsbuildinfo' '*.build.log'","eslint":"eslint src","format":"npm run prettier:fix","rebuild":"npm run clean && npm run build","lint:fix":"npm run prettier:fix && npm run eslint:fix","prettier":"prettier --check . --ignore-path ../../../../.prettierignore","tsc:watch":"tsc --watch","build:docs":"api-extractor run --local && copyfiles -u 1 ./_api-extractor-temp/doc-models/* ../../../../_api-extractor-temp/","eslint:fix":"eslint src --fix","test:mocha":"mocha dist/**/*.test.js --exit","build:esnext":"tsc --project ./tsconfig.esnext.json","build:genver":"gen-version","prettier:fix":"prettier --write . --ignore-path ../../../../.prettierignore","build:compile":"fluid-build . --task compile","ci:build:docs":"api-extractor run && copyfiles -u 1 ./_api-extractor-temp/doc-models/* ../../../../_api-extractor-temp/","test:coverage":"c8 npm test","typetests:gen":"fluid-type-test-generator","build:commonjs":"fluid-build . --task commonjs","format-and-build":"npm run format && npm run build","typetests:prepare":"flub typetests --dir . --reset --previous --normalize","format-and-compile":"npm run format && npm run build:compile"},"_npmUser":{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},"_resolved":"/mnt/vss/_work/1/pack/scoped/fluid-experimental-devtools-core-2.0.0-internal.6.4.0.tgz","_integrity":"sha512-71B5Gv8qv+wenHq/ryDdS1HTE+6yK0ag24jNKps+DyRjhIZczWjNW9nPU2vp9czfEEFVeZ6S0ZP974wUDRzEtg==","fluidBuild":{"tasks":{"tsc":["...","typetests:gen"]}},"repository":{"url":"git+https://github.com/microsoft/FluidFramework.git","type":"git","directory":"packages/tools/devtools/devtools-core"},"_npmVersion":"9.6.7","description":"Fluid Framework developer tools core functionality","directories":{},"sideEffects":false,"_nodeVersion":"18.17.1","dependencies":{"@fluidframework/map":">=2.0.0-internal.6.4.0 <2.0.0-internal.6.5.0","@fluidframework/cell":">=2.0.0-internal.6.4.0 <2.0.0-internal.6.5.0","@fluidframework/matrix":">=2.0.0-internal.6.4.0 <2.0.0-internal.6.5.0","@fluidframework/counter":">=2.0.0-internal.6.4.0 <2.0.0-internal.6.5.0","@fluidframework/sequence":">=2.0.0-internal.6.4.0 <2.0.0-internal.6.5.0","@fluid-experimental/tree2":">=2.0.0-internal.6.4.0 <2.0.0-internal.6.5.0","@fluid-internal/client-utils":">=2.0.0-internal.6.4.0 <2.0.0-internal.6.5.0","@fluidframework/core-interfaces":">=2.0.0-internal.6.4.0 <2.0.0-internal.6.5.0","@fluidframework/telemetry-utils":">=2.0.0-internal.6.4.0 <2.0.0-internal.6.5.0","@fluidframework/container-loader":">=2.0.0-internal.6.4.0 <2.0.0-internal.6.5.0","@fluidframework/shared-object-base":">=2.0.0-internal.6.4.0 <2.0.0-internal.6.5.0","@fluidframework/protocol-definitions":"^1.1.0","@fluidframework/container-definitions":">=2.0.0-internal.6.4.0 <2.0.0-internal.6.5.0","@fluidframework/datastore-definitions":">=2.0.0-internal.6.4.0 <2.0.0-internal.6.5.0"},"_hasShrinkwrap":false,"readmeFilename":"README.md","typeValidation":{"broken":{}},"devDependencies":{"c8":"^7.7.1","chai":"^4.2.0","mocha":"^10.2.0","eslint":"~8.6.0","events":"^3.1.0","moment":"^2.21.0","rimraf":"^4.4.0","prettier":"~2.6.2","copyfiles":"^2.4.1","cross-env":"^7.0.3","typescript":"~4.5.5","@types/chai":"^4.0.0","@types/mocha":"^9.1.1","@types/events":"^3.0.0","mocha-multi-reporters":"^1.5.1","@fluid-tools/build-cli":"^0.22.0","eslint-config-prettier":"~8.5.0","@microsoft/api-extractor":"^7.34.4","eslint-plugin-chai-expect":"~3.0.0","mocha-json-output-reporter":"^2.0.1","@fluidframework/build-tools":"^0.22.0","@fluidframework/build-common":"^2.0.0","@fluidframework/mocha-test-setup":">=2.0.0-internal.6.4.0 <2.0.0-internal.6.5.0","@fluidframework/driver-definitions":">=2.0.0-internal.6.4.0 <2.0.0-internal.6.5.0","@fluidframework/test-runtime-utils":">=2.0.0-internal.6.4.0 <2.0.0-internal.6.5.0","@fluidframework/eslint-config-fluid":"^2.1.0","@fluid-experimental/devtools-core-previous":"npm:@fluid-experimental/devtools-core@2.0.0-internal.6.3.0"},"_npmOperationalInternal":{"tmp":"tmp/devtools-core_2.0.0-internal.6.4.0_1695863110741_0.4359453030307616","host":"s3://npm-registry-packages"}},"2.0.0-internal.7.0.0":{"name":"@fluid-experimental/devtools-core","version":"2.0.0-internal.7.0.0","author":{"name":"Microsoft and contributors"},"license":"MIT","_id":"@fluid-experimental/devtools-core@2.0.0-internal.7.0.0","maintainers":[{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},{"name":"curtisman","email":"curtism@microsoft.com"}],"homepage":"https://fluidframework.com","bugs":{"url":"https://github.com/microsoft/FluidFramework/issues"},"c8":{"all":true,"exclude":["src/test/**/*.ts","dist/test/**/*.js"],"include":["src/**/*.ts","dist/**/*.js"],"reporter":["cobertura","html","text"],"cache-dir":"nyc/.cache","report-dir":"nyc/report","temp-directory":"nyc/.nyc_output","exclude-after-remap":false},"dist":{"shasum":"c7e71bb1cf359015fc360aa66dffc202c141f6a2","tarball":"https://registry.npmjs.org/@fluid-experimental/devtools-core/-/devtools-core-2.0.0-internal.7.0.0.tgz","fileCount":501,"integrity":"sha512-EtojPTfKmGRY/9hd40JFFB+Dd5BjC1SFf8bOhVFuYMNd6LVVB9PZOqNxxe/qtsv1wQfqWBBAhkn7b1B2WUxQoA==","signatures":[{"sig":"MEYCIQDVAdM9tvDe+L99CRZagZLHacbNBaq10wqMs56ymVcgLwIhANOBiA7EvbbThkShA/bevtSwmShgxa6Jhd5kHnhyFEWU","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}],"unpackedSize":1378772},"main":"dist/index.js","_from":"file:fluid-experimental-devtools-core-2.0.0-internal.7.0.0.tgz","types":"dist/index.d.ts","module":"lib/index.js","readme":"# @fluid-experimental/devtools-core\n\nThis library contains developer tools for use alongside the Fluid Framework.\nIt is used to power our associated [browser extension][browser-extension].\n\n- Chrome: \n- Edge: \n\n\n\n\n\n\n## Installation\n\nTo get started, install the package by running the following command:\n\n```bash\nnpm i @fluid-experimental/devtools-core -D\n```\n\n\n\n\n\n## Usage\n\nThe Devtools' API surface is designed to fit nicely into most application flows.\n\n### Initialization\n\nTo initialize a devtools session for your container, call [`initializeDevtools`][initialize-devtools-docs].\nThis function accepts a `DevtoolsLogger` for receiving Fluid telemetry from your application, a list of initial Fluid\n`Containers` to associate with the session, and (optionally) customized data visualization configurations for visualizing\n`Container` data.\n\n#### About the [`DevtoolsLogger`][devtools-logger-docs]\n\nThe `DevtoolsLogger` is an optional piece when calling `initializeDevtools` but it is strongly recommended that you use\nit because several features in Fluid Devtools are powered by the telemetry that Fluid Framework generates, and this\nlogger is the way in which that telemetry gets into Fluid Devtools.\n\nYou can obtain a `DevtoolsLogger` by calling its constructor, and then should pass it to `initializeDevtools` _and_\nto the `Loader` instance you'll use to create/load Containers as shown below.\nThis way the logger will receive all the telemetry generated by Fluid Framework in your application, and forward it to\nFluid Devtools as necessary.\n\n```typescript\nimport { DevtoolsLogger, initializeDevtools } from \"@fluid-experimental/devtools-core\";\n\n// Instantiate the logger\nconst devtoolsLogger = new DevtoolsLogger();\n\n// Pass the logger when instantiating the Loader\nconst loader = new Loader({\n\tlogger: devtoolsLogger,\n\t// Other necessary properties ...\n});\n\n// Use the Loader to create (and optionally, attach) a Container\nconst container = await loader.createDetachedContainer(/* params */);\nawait container.attach(/* params */);\n\n// Initialize the Devtools passing the logger and your Container.\n// The Container could be added later as well with devtools.registerContainerDevtools().\nconst devtools = initializeDevtools({\n\tlogger: devtoolsLogger,\n\tinitialContainers: [\n\t\t{\n\t\t\tcontainer,\n\t\t\tcontainerKey: \"My Container\",\n\t\t},\n\t],\n});\n```\n\nIf you're working with `AzureClient` instead of lower-level APIs like the one described above, you probably want to\nrefer to the [@fluid-experimental/devtools package][devtools-package] instead of this one.\n\nDuring local development the recommendation is that your application should receive the `DevtoolsLogger` instance _instead_\nof any logger it would normally receive when deployed to a real environment, to avoid local development activity from\nmixing with real telemetry.\nIf you still want to provide a real application logger and use the Fluid Devtools features that are powered by telemetry\nat the same time, you can pass an existing logger to the `DevtoolsLogger` constructor and it will forward all telemetry\nit receives to that logger as well:\n\n```typescript\nimport { DevtoolsLogger } from \"@fluid-experimental/devtools-core\";\n\n// Your application's logger\nconst yourApplicationLogger = getInstanceOfYourApplicationLogger();\n\nconst devtoolsLogger = new DevtoolsLogger(yourApplicationLogger);\n\n// Pass devtoolsLogger to initializeDevtools() and to your application as described above\n```\n\n### Clean-up\n\nThe Devtools object is managed as a global singleton.\nThat singleton is automatically cleaned up prior to the Window's \"unload\" event.\nSo typical application flows likely won't need to worry about cleanup.\nThat said, if you wish to have tighter control over when the Devtools are torn down, you can simply call the `dispose` method on the handle returned by [initialization](#initialization).\n\n## Contributing to the package\n\n### Build\n\nTo build the package locally, first ensure you have run `pnpm install` from the root of the mono-repo.\nNext, to build the code, run `npm run build` from the root of the mono-repo, or use [fluid-build](https://github.com/microsoft/FluidFramework/tree/main/build-tools/packages/build-tools#running-fluid-build-command-line) via `fluid-build -t build`.\n\n- Note: Once you have run a build from the root, assuming no other changes outside of this package, you may run `npm run build` directly within this directory for a faster build.\n If you make changes to any of this package's local dependencies, you will need to run a build again from the root before building again from directly within this package.\n\n### Test\n\nTo run the tests, first ensure you have followed the [build](#build) steps above.\nNext, run `npm run test` from a terminal within this directory.\n\n\n\n\n\n\n\n## API Documentation\n\nAPI documentation for **@fluid-experimental/devtools-core** is available at .\n\n\n\n\n\n\n\n\n\n\n## Contribution Guidelines\n\nThere are many ways to [contribute](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md) to Fluid.\n\n- Participate in Q&A in our [GitHub Discussions](https://github.com/microsoft/FluidFramework/discussions).\n- [Submit bugs](https://github.com/microsoft/FluidFramework/issues) and help us verify fixes as they are checked in.\n- Review the [source code changes](https://github.com/microsoft/FluidFramework/pulls).\n- [Contribute bug fixes](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md).\n\nDetailed instructions for working in the repo can be found in the [Wiki](https://github.com/microsoft/FluidFramework/wiki).\n\nThis project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).\nFor more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\nUse of these trademarks or logos must follow Microsoft’s [Trademark & Brand Guidelines](https://www.microsoft.com/trademarks).\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n\n\n\n## Help\n\nNot finding what you're looking for in this README? Check out our [GitHub\nWiki](https://github.com/microsoft/FluidFramework/wiki) or [fluidframework.com](https://fluidframework.com/docs/).\n\nStill not finding what you're looking for? Please [file an\nissue](https://github.com/microsoft/FluidFramework/wiki/Submitting-Bugs-and-Feature-Requests).\n\nThank you!\n\n\n\n\n\n\n\n\n\n\n## Trademark\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\n\nUse of these trademarks or logos must follow Microsoft's [Trademark & Brand\nGuidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general).\n\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n[initialize-devtools-docs]: https://fluidframework.com/docs/apis/devtools-core#initializedevtools-function\n[devtools-logger-docs]: https://fluidframework.com/docs/apis/devtools-core/devtoolslogger-class\n[devtools-package]: https://www.npmjs.com/package/@fluid-experimental/devtools\n[browser-extension]: https://github.com/microsoft/FluidFramework/tree/main/packages/tools/devtools/devtools-browser-extension\n","scripts":{"tsc":"tsc","lint":"npm run prettier && npm run eslint","test":"npm run test:mocha","build":"fluid-build . --task build","clean":"rimraf --glob '_api-extractor-temp' 'nyc' 'dist' 'lib' '*.tsbuildinfo' '*.build.log'","eslint":"eslint src","format":"npm run prettier:fix","rebuild":"npm run clean && npm run build","lint:fix":"npm run prettier:fix && npm run eslint:fix","prettier":"prettier --check . --ignore-path ../../../../.prettierignore","tsc:watch":"tsc --watch","build:docs":"api-extractor run --local && copyfiles -u 1 ./_api-extractor-temp/doc-models/* ../../../../_api-extractor-temp/","eslint:fix":"eslint src --fix","test:mocha":"mocha dist/**/*.test.js --exit","build:esnext":"tsc --project ./tsconfig.esnext.json","build:genver":"gen-version","prettier:fix":"prettier --write . --ignore-path ../../../../.prettierignore","build:compile":"fluid-build . --task compile","ci:build:docs":"api-extractor run && copyfiles -u 1 ./_api-extractor-temp/doc-models/* ../../../../_api-extractor-temp/","test:coverage":"c8 npm test","typetests:gen":"fluid-type-test-generator","build:commonjs":"fluid-build . --task commonjs","format-and-build":"npm run format && npm run build","typetests:prepare":"flub typetests --dir . --reset --previous --normalize","format-and-compile":"npm run format && npm run build:compile"},"_npmUser":{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},"_resolved":"/mnt/vss/_work/1/pack/scoped/fluid-experimental-devtools-core-2.0.0-internal.7.0.0.tgz","_integrity":"sha512-EtojPTfKmGRY/9hd40JFFB+Dd5BjC1SFf8bOhVFuYMNd6LVVB9PZOqNxxe/qtsv1wQfqWBBAhkn7b1B2WUxQoA==","fluidBuild":{"tasks":{"tsc":["...","typetests:gen"]}},"repository":{"url":"git+https://github.com/microsoft/FluidFramework.git","type":"git","directory":"packages/tools/devtools/devtools-core"},"_npmVersion":"9.6.7","description":"Fluid Framework developer tools core functionality","directories":{},"sideEffects":false,"_nodeVersion":"18.17.1","dependencies":{"@fluidframework/map":">=2.0.0-internal.7.0.0 <2.0.0-internal.7.1.0","@fluidframework/cell":">=2.0.0-internal.7.0.0 <2.0.0-internal.7.1.0","@fluidframework/matrix":">=2.0.0-internal.7.0.0 <2.0.0-internal.7.1.0","@fluidframework/counter":">=2.0.0-internal.7.0.0 <2.0.0-internal.7.1.0","@fluidframework/sequence":">=2.0.0-internal.7.0.0 <2.0.0-internal.7.1.0","@fluid-experimental/tree2":">=2.0.0-internal.7.0.0 <2.0.0-internal.7.1.0","@fluid-internal/client-utils":">=2.0.0-internal.7.0.0 <2.0.0-internal.7.1.0","@fluidframework/core-interfaces":">=2.0.0-internal.7.0.0 <2.0.0-internal.7.1.0","@fluidframework/telemetry-utils":">=2.0.0-internal.7.0.0 <2.0.0-internal.7.1.0","@fluidframework/container-loader":">=2.0.0-internal.7.0.0 <2.0.0-internal.7.1.0","@fluidframework/shared-object-base":">=2.0.0-internal.7.0.0 <2.0.0-internal.7.1.0","@fluidframework/protocol-definitions":"^3.0.0","@fluidframework/container-definitions":">=2.0.0-internal.7.0.0 <2.0.0-internal.7.1.0","@fluidframework/datastore-definitions":">=2.0.0-internal.7.0.0 <2.0.0-internal.7.1.0"},"_hasShrinkwrap":false,"readmeFilename":"README.md","typeValidation":{"broken":{"InterfaceDeclaration_FluidDevtoolsProps":{"forwardCompat":false},"InterfaceDeclaration_ContainerDevtoolsProps":{"forwardCompat":false}}},"devDependencies":{"c8":"^7.7.1","chai":"^4.2.0","mocha":"^10.2.0","eslint":"~8.6.0","events":"^3.1.0","moment":"^2.21.0","rimraf":"^4.4.0","prettier":"~2.6.2","copyfiles":"^2.4.1","cross-env":"^7.0.3","typescript":"~5.1.6","@types/chai":"^4.0.0","@types/mocha":"^9.1.1","@types/events":"^3.0.0","mocha-multi-reporters":"^1.5.1","@fluid-tools/build-cli":"^0.24.0","eslint-config-prettier":"~8.5.0","@microsoft/api-extractor":"^7.37.0","eslint-plugin-chai-expect":"~3.0.0","mocha-json-output-reporter":"^2.0.1","@fluidframework/build-tools":"^0.24.0","@fluidframework/build-common":"^2.0.0","@fluidframework/mocha-test-setup":">=2.0.0-internal.7.0.0 <2.0.0-internal.7.1.0","@fluidframework/driver-definitions":">=2.0.0-internal.7.0.0 <2.0.0-internal.7.1.0","@fluidframework/test-runtime-utils":">=2.0.0-internal.7.0.0 <2.0.0-internal.7.1.0","@fluidframework/eslint-config-fluid":"^2.1.0","@fluid-experimental/devtools-core-previous":"npm:@fluid-experimental/devtools-core@2.0.0-internal.6.3.0"},"_npmOperationalInternal":{"tmp":"tmp/devtools-core_2.0.0-internal.7.0.0_1695922951697_0.7453628344467902","host":"s3://npm-registry-packages"}},"2.0.0-internal.6.0.4":{"name":"@fluid-experimental/devtools-core","version":"2.0.0-internal.6.0.4","author":{"name":"Microsoft and contributors"},"license":"MIT","_id":"@fluid-experimental/devtools-core@2.0.0-internal.6.0.4","maintainers":[{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},{"name":"curtisman","email":"curtism@microsoft.com"}],"homepage":"https://fluidframework.com","bugs":{"url":"https://github.com/microsoft/FluidFramework/issues"},"nyc":{"all":true,"exclude":["src/test/**/*.ts","dist/test/**/*.js"],"include":["src/**/*.ts","dist/**/*.js"],"reporter":["cobertura","html","text"],"cache-dir":"nyc/.cache","report-dir":"nyc/report","temp-directory":"nyc/.nyc_output","exclude-after-remap":false},"dist":{"shasum":"ce57fb5dad695876430e1d3d26f0e7d73f985cff","tarball":"https://registry.npmjs.org/@fluid-experimental/devtools-core/-/devtools-core-2.0.0-internal.6.0.4.tgz","fileCount":501,"integrity":"sha512-QIn5Xwp1KpNhEcJaT94fXSZMt4uVXObOgYjoqZXpiLU7Hpbm2b1rh95ElF7vjk4Q8howpNaZR4xdgjLDj1iXOA==","signatures":[{"sig":"MEYCIQC+2JqXuJGh4y1mQEODXUQLT55nOtvl2cBwYcTmfUGTfAIhAP9GIv1hP+FPfPncT6r/iDRYwB88y6lThvXOMc/TMuKZ","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}],"unpackedSize":1347878},"main":"dist/index.js","_from":"file:fluid-experimental-devtools-core-2.0.0-internal.6.0.4.tgz","types":"dist/index.d.ts","readme":"# @fluid-experimental/devtools-core\n\nThis library contains developer tools for use alongside the Fluid Framework.\nIt is used to power our associated [browser extension][browser-extension].\n\n- Chrome: \n- Edge: \n\n\n\n\n\n\n## Installation\n\nTo get started, install the package by running the following command:\n\n```bash\nnpm i @fluid-experimental/devtools-core -D\n```\n\n\n\n\n\n## Usage\n\nThe Devtools' API surface is designed to fit nicely into most application flows.\n\n### Initialization\n\nTo initialize a devtools session for your container, call [`initializeDevtools`][initialize-devtools-docs].\nThis function accepts a `DevtoolsLogger` for receiving Fluid telemetry from your application, a list of initial Fluid\n`Containers` to associate with the session, and (optionally) customized data visualization configurations for visualizing\n`Container` data.\n\n#### About the [`DevtoolsLogger`][devtools-logger-docs]\n\nThe `DevtoolsLogger` is an optional piece when calling `initializeDevtools` but it is strongly recommended that you use\nit because several features in Fluid Devtools are powered by the telemetry that Fluid Framework generates, and this\nlogger is the way in which that telemetry gets into Fluid Devtools.\n\nYou can obtain a `DevtoolsLogger` by calling its constructor, and then should pass it to `initializeDevtools` _and_\nto the `Loader` instance you'll use to create/load Containers as shown below.\nThis way the logger will receive all the telemetry generated by Fluid Framework in your application, and forward it to\nFluid Devtools as necessary.\n\n```typescript\nimport { DevtoolsLogger, initializeDevtools } from \"@fluid-experimental/devtools-core\";\n\n// Instantiate the logger\nconst devtoolsLogger = new DevtoolsLogger();\n\n// Pass the logger when instantiating the Loader\nconst loader = new Loader({\n\tlogger: devtoolsLogger,\n\t// Other necessary properties ...\n});\n\n// Use the Loader to create (and optionally, attach) a Container\nconst container = await loader.createDetachedContainer(/* params */);\nawait container.attach(/* params */);\n\n// Initialize the Devtools passing the logger and your Container.\n// The Container could be added later as well with devtools.registerContainerDevtools().\nconst devtools = initializeDevtools({\n\tlogger: devtoolsLogger,\n\tinitialContainers: [\n\t\t{\n\t\t\tcontainer,\n\t\t\tcontainerKey: \"My Container\",\n\t\t},\n\t],\n});\n```\n\nIf you're working with `AzureClient` instead of lower-level APIs like the one described above, you probably want to\nrefer to the [@fluid-experimental/devtools package][devtools-package] instead of this one.\n\nDuring local development the recommendation is that your application should receive the `DevtoolsLogger` instance _instead_\nof any logger it would normally receive when deployed to a real environment, to avoid local development activity from\nmixing with real telemetry.\nIf you still want to provide a real application logger and use the Fluid Devtools features that are powered by telemetry\nat the same time, you can pass an existing logger to the `DevtoolsLogger` constructor and it will forward all telemetry\nit receives to that logger as well:\n\n```typescript\nimport { DevtoolsLogger } from \"@fluid-experimental/devtools-core\";\n\n// Your application's logger\nconst yourApplicationLogger = getInstanceOfYourApplicationLogger();\n\nconst devtoolsLogger = new DevtoolsLogger(yourApplicationLogger);\n\n// Pass devtoolsLogger to initializeDevtools() and to your application as described above\n```\n\n### Clean-up\n\nThe Devtools object is managed as a global singleton.\nThat singleton is automatically cleaned up prior to the Window's \"unload\" event.\nSo typical application flows likely won't need to worry about cleanup.\nThat said, if you wish to have tighter control over when the Devtools are torn down, you can simply call the `dispose` method on the handle returned by [initialization](#initialization).\n\n## Contributing to the package\n\n### Build\n\nTo build the package locally, first ensure you have run `pnpm install` from the root of the mono-repo.\nNext, to build the code, run `npm run build` from the root of the mono-repo, or use [fluid-build](https://github.com/microsoft/FluidFramework/tree/main/build-tools/packages/build-tools#running-fluid-build-command-line) via `fluid-build -t build`.\n\n- Note: Once you have run a build from the root, assuming no other changes outside of this package, you may run `npm run build` directly within this directory for a faster build.\n If you make changes to any of this package's local dependencies, you will need to run a build again from the root before building again from directly within this package.\n\n### Test\n\nTo run the tests, first ensure you have followed the [build](#build) steps above.\nNext, run `npm run test` from a terminal within this directory.\n\n\n\n\n\n\n\n## API Documentation\n\nAPI documentation for **@fluid-experimental/devtools-core** is available at .\n\n\n\n\n\n\n\n\n\n\n## Contribution Guidelines\n\nThere are many ways to [contribute](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md) to Fluid.\n\n- Participate in Q&A in our [GitHub Discussions](https://github.com/microsoft/FluidFramework/discussions).\n- [Submit bugs](https://github.com/microsoft/FluidFramework/issues) and help us verify fixes as they are checked in.\n- Review the [source code changes](https://github.com/microsoft/FluidFramework/pulls).\n- [Contribute bug fixes](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md).\n\nDetailed instructions for working in the repo can be found in the [Wiki](https://github.com/microsoft/FluidFramework/wiki).\n\nThis project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).\nFor more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\nUse of these trademarks or logos must follow Microsoft’s [Trademark & Brand Guidelines](https://www.microsoft.com/trademarks).\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n\n\n\n## Help\n\nNot finding what you're looking for in this README? Check out our [GitHub\nWiki](https://github.com/microsoft/FluidFramework/wiki) or [fluidframework.com](https://fluidframework.com/docs/).\n\nStill not finding what you're looking for? Please [file an\nissue](https://github.com/microsoft/FluidFramework/wiki/Submitting-Bugs-and-Feature-Requests).\n\nThank you!\n\n\n\n\n\n\n\n\n\n\n## Trademark\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\n\nUse of these trademarks or logos must follow Microsoft's [Trademark & Brand\nGuidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general).\n\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n[initialize-devtools-docs]: https://fluidframework.com/docs/apis/devtools-core#initializedevtools-function\n[devtools-logger-docs]: https://fluidframework.com/docs/apis/devtools-core/devtoolslogger-class\n[devtools-package]: https://www.npmjs.com/package/@fluid-experimental/devtools\n[browser-extension]: https://github.com/microsoft/FluidFramework/tree/main/packages/tools/devtools/devtools-browser-extension\n","scripts":{"tsc":"tsc","lint":"npm run prettier && npm run eslint","test":"npm run test:mocha","build":"fluid-build . --task build","clean":"rimraf --glob \"_api-extractor-temp\" \"nyc\" \"dist\" \"lib\" \"*.tsbuildinfo\" \"*.build.log\"","eslint":"eslint src","format":"npm run prettier:fix","rebuild":"npm run clean && npm run build","lint:fix":"npm run prettier:fix && npm run eslint:fix","prettier":"prettier --check . --ignore-path ../../../../.prettierignore","build:docs":"api-extractor run --local && copyfiles -u 1 ./_api-extractor-temp/doc-models/* ../../../../_api-extractor-temp/","eslint:fix":"eslint src --fix","test:mocha":"mocha dist/**/*.test.js --unhandled-rejections=strict --exit","build:esnext":"tsc --project ./tsconfig.esnext.json","build:genver":"gen-version","prettier:fix":"prettier --write . --ignore-path ../../../../.prettierignore","build:compile":"fluid-build . --task compile","ci:build:docs":"api-extractor run && copyfiles -u 1 ./_api-extractor-temp/doc-models/* ../../../../_api-extractor-temp/","test:coverage":"npm run test:mocha:coverage","typetests:gen":"fluid-type-test-generator","build:commonjs":"fluid-build . --task commonjs","format-and-build":"npm run format && npm run build","typetests:prepare":"flub typetests --dir . --reset --previous --normalize","format-and-compile":"npm run format && npm run build:compile","test:mocha:coverage":"nyc npm run test:mocha -- --reporter xunit --reporter-option output=nyc/junit-report.xml","test:mocha:multireport":"cross-env FLUID_TEST_MULTIREPORT=1 npm run test:mocha"},"_npmUser":{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},"_resolved":"/mnt/vss/_work/1/pack/scoped/fluid-experimental-devtools-core-2.0.0-internal.6.0.4.tgz","_integrity":"sha512-QIn5Xwp1KpNhEcJaT94fXSZMt4uVXObOgYjoqZXpiLU7Hpbm2b1rh95ElF7vjk4Q8howpNaZR4xdgjLDj1iXOA==","fluidBuild":{"tasks":{"tsc":["...","typetests:gen"]}},"repository":{"url":"git+https://github.com/microsoft/FluidFramework.git","type":"git","directory":"packages/tools/devtools/devtools-core"},"_npmVersion":"8.11.0","description":"Fluid Framework developer tools core functionality","directories":{},"sideEffects":false,"_nodeVersion":"16.16.0","dependencies":{"@fluidframework/map":">=2.0.0-internal.6.0.4 <2.0.0-internal.6.1.0","@fluidframework/cell":">=2.0.0-internal.6.0.4 <2.0.0-internal.6.1.0","@fluidframework/matrix":">=2.0.0-internal.6.0.4 <2.0.0-internal.6.1.0","@fluidframework/counter":">=2.0.0-internal.6.0.4 <2.0.0-internal.6.1.0","@fluidframework/sequence":">=2.0.0-internal.6.0.4 <2.0.0-internal.6.1.0","@fluid-experimental/tree2":">=2.0.0-internal.6.0.4 <2.0.0-internal.6.1.0","@fluidframework/common-utils":"^1.1.1","@fluidframework/container-utils":">=2.0.0-internal.6.0.4 <2.0.0-internal.6.1.0","@fluidframework/core-interfaces":">=2.0.0-internal.6.0.4 <2.0.0-internal.6.1.0","@fluidframework/container-loader":">=2.0.0-internal.6.0.4 <2.0.0-internal.6.1.0","@fluidframework/common-definitions":"^0.20.1","@fluidframework/shared-object-base":">=2.0.0-internal.6.0.4 <2.0.0-internal.6.1.0","@fluidframework/protocol-definitions":"^1.1.0","@fluidframework/container-definitions":">=2.0.0-internal.6.0.4 <2.0.0-internal.6.1.0","@fluidframework/datastore-definitions":">=2.0.0-internal.6.0.4 <2.0.0-internal.6.1.0"},"_hasShrinkwrap":false,"readmeFilename":"README.md","typeValidation":{"broken":{}},"devDependencies":{"nyc":"^15.1.0","chai":"^4.2.0","mocha":"^10.2.0","eslint":"~8.6.0","events":"^3.1.0","moment":"^2.21.0","rimraf":"^4.4.0","prettier":"~2.6.2","copyfiles":"^2.4.1","cross-env":"^7.0.3","typescript":"~4.5.5","@types/chai":"^4.0.0","@types/mocha":"^9.1.1","concurrently":"^7.6.0","@types/events":"^3.0.0","mocha-multi-reporters":"^1.5.1","@fluid-tools/build-cli":"^0.21.0","eslint-config-prettier":"~8.5.0","@microsoft/api-extractor":"^7.34.4","eslint-plugin-chai-expect":"~3.0.0","mocha-json-output-reporter":"^2.0.1","@fluidframework/build-tools":"^0.21.0","@fluidframework/build-common":"^2.0.0","@fluidframework/telemetry-utils":">=2.0.0-internal.6.0.4 <2.0.0-internal.6.1.0","@fluidframework/mocha-test-setup":">=2.0.0-internal.6.0.4 <2.0.0-internal.6.1.0","@fluidframework/driver-definitions":">=2.0.0-internal.6.0.4 <2.0.0-internal.6.1.0","@fluidframework/test-runtime-utils":">=2.0.0-internal.6.0.4 <2.0.0-internal.6.1.0","@fluidframework/eslint-config-fluid":"^2.0.0","@fluid-experimental/devtools-core-previous":"npm:@fluid-experimental/devtools-core@2.0.0-internal.6.0.0"},"_npmOperationalInternal":{"tmp":"tmp/devtools-core_2.0.0-internal.6.0.4_1696292853686_0.47847332207645366","host":"s3://npm-registry-packages"}},"2.0.0-internal.6.1.3":{"name":"@fluid-experimental/devtools-core","version":"2.0.0-internal.6.1.3","author":{"name":"Microsoft and contributors"},"license":"MIT","_id":"@fluid-experimental/devtools-core@2.0.0-internal.6.1.3","maintainers":[{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},{"name":"curtisman","email":"curtism@microsoft.com"}],"homepage":"https://fluidframework.com","bugs":{"url":"https://github.com/microsoft/FluidFramework/issues"},"nyc":{"all":true,"exclude":["src/test/**/*.ts","dist/test/**/*.js"],"include":["src/**/*.ts","dist/**/*.js"],"reporter":["cobertura","html","text"],"cache-dir":"nyc/.cache","report-dir":"nyc/report","temp-directory":"nyc/.nyc_output","exclude-after-remap":false},"dist":{"shasum":"4f02544ed310198fbcf22da66c161d4daf6fc15d","tarball":"https://registry.npmjs.org/@fluid-experimental/devtools-core/-/devtools-core-2.0.0-internal.6.1.3.tgz","fileCount":501,"integrity":"sha512-lWbS6DDOmkUJERUYXrSrpEwsYi8nbGfDJzGdRXg0M0ZBkZpkEr+Wd++Xe6IAGFfOxWgzR8n5OtMR1KfYkr++6g==","signatures":[{"sig":"MEUCIERtD1kT8RnQx25meWtyDQYDMfC9FiU10zRbSlwRWpUFAiEA/7QYE2CLy20BAcZwglVdm3ffvsR+jKD/Qevo7u6noPk=","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}],"unpackedSize":1363083},"main":"dist/index.js","_from":"file:fluid-experimental-devtools-core-2.0.0-internal.6.1.3.tgz","types":"dist/index.d.ts","readme":"# @fluid-experimental/devtools-core\n\nThis library contains developer tools for use alongside the Fluid Framework.\nIt is used to power our associated [browser extension][browser-extension].\n\n- Chrome: \n- Edge: \n\n\n\n\n\n\n## Installation\n\nTo get started, install the package by running the following command:\n\n```bash\nnpm i @fluid-experimental/devtools-core -D\n```\n\n\n\n\n\n## Usage\n\nThe Devtools' API surface is designed to fit nicely into most application flows.\n\n### Initialization\n\nTo initialize a devtools session for your container, call [`initializeDevtools`][initialize-devtools-docs].\nThis function accepts a `DevtoolsLogger` for receiving Fluid telemetry from your application, a list of initial Fluid\n`Containers` to associate with the session, and (optionally) customized data visualization configurations for visualizing\n`Container` data.\n\n#### About the [`DevtoolsLogger`][devtools-logger-docs]\n\nThe `DevtoolsLogger` is an optional piece when calling `initializeDevtools` but it is strongly recommended that you use\nit because several features in Fluid Devtools are powered by the telemetry that Fluid Framework generates, and this\nlogger is the way in which that telemetry gets into Fluid Devtools.\n\nYou can obtain a `DevtoolsLogger` by calling its constructor, and then should pass it to `initializeDevtools` _and_\nto the `Loader` instance you'll use to create/load Containers as shown below.\nThis way the logger will receive all the telemetry generated by Fluid Framework in your application, and forward it to\nFluid Devtools as necessary.\n\n```typescript\nimport { DevtoolsLogger, initializeDevtools } from \"@fluid-experimental/devtools-core\";\n\n// Instantiate the logger\nconst devtoolsLogger = new DevtoolsLogger();\n\n// Pass the logger when instantiating the Loader\nconst loader = new Loader({\n\tlogger: devtoolsLogger,\n\t// Other necessary properties ...\n});\n\n// Use the Loader to create (and optionally, attach) a Container\nconst container = await loader.createDetachedContainer(/* params */);\nawait container.attach(/* params */);\n\n// Initialize the Devtools passing the logger and your Container.\n// The Container could be added later as well with devtools.registerContainerDevtools().\nconst devtools = initializeDevtools({\n\tlogger: devtoolsLogger,\n\tinitialContainers: [\n\t\t{\n\t\t\tcontainer,\n\t\t\tcontainerKey: \"My Container\",\n\t\t},\n\t],\n});\n```\n\nIf you're working with `AzureClient` instead of lower-level APIs like the one described above, you probably want to\nrefer to the [@fluid-experimental/devtools package][devtools-package] instead of this one.\n\nDuring local development the recommendation is that your application should receive the `DevtoolsLogger` instance _instead_\nof any logger it would normally receive when deployed to a real environment, to avoid local development activity from\nmixing with real telemetry.\nIf you still want to provide a real application logger and use the Fluid Devtools features that are powered by telemetry\nat the same time, you can pass an existing logger to the `DevtoolsLogger` constructor and it will forward all telemetry\nit receives to that logger as well:\n\n```typescript\nimport { DevtoolsLogger } from \"@fluid-experimental/devtools-core\";\n\n// Your application's logger\nconst yourApplicationLogger = getInstanceOfYourApplicationLogger();\n\nconst devtoolsLogger = new DevtoolsLogger(yourApplicationLogger);\n\n// Pass devtoolsLogger to initializeDevtools() and to your application as described above\n```\n\n### Clean-up\n\nThe Devtools object is managed as a global singleton.\nThat singleton is automatically cleaned up prior to the Window's \"unload\" event.\nSo typical application flows likely won't need to worry about cleanup.\nThat said, if you wish to have tighter control over when the Devtools are torn down, you can simply call the `dispose` method on the handle returned by [initialization](#initialization).\n\n## Contributing to the package\n\n### Build\n\nTo build the package locally, first ensure you have run `pnpm install` from the root of the mono-repo.\nNext, to build the code, run `npm run build` from the root of the mono-repo, or use [fluid-build](https://github.com/microsoft/FluidFramework/tree/main/build-tools/packages/build-tools#running-fluid-build-command-line) via `fluid-build -t build`.\n\n- Note: Once you have run a build from the root, assuming no other changes outside of this package, you may run `npm run build` directly within this directory for a faster build.\n If you make changes to any of this package's local dependencies, you will need to run a build again from the root before building again from directly within this package.\n\n### Test\n\nTo run the tests, first ensure you have followed the [build](#build) steps above.\nNext, run `npm run test` from a terminal within this directory.\n\n\n\n\n\n\n\n## API Documentation\n\nAPI documentation for **@fluid-experimental/devtools-core** is available at .\n\n\n\n\n\n\n\n\n\n\n## Contribution Guidelines\n\nThere are many ways to [contribute](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md) to Fluid.\n\n- Participate in Q&A in our [GitHub Discussions](https://github.com/microsoft/FluidFramework/discussions).\n- [Submit bugs](https://github.com/microsoft/FluidFramework/issues) and help us verify fixes as they are checked in.\n- Review the [source code changes](https://github.com/microsoft/FluidFramework/pulls).\n- [Contribute bug fixes](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md).\n\nDetailed instructions for working in the repo can be found in the [Wiki](https://github.com/microsoft/FluidFramework/wiki).\n\nThis project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).\nFor more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\nUse of these trademarks or logos must follow Microsoft’s [Trademark & Brand Guidelines](https://www.microsoft.com/trademarks).\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n\n\n\n## Help\n\nNot finding what you're looking for in this README? Check out our [GitHub\nWiki](https://github.com/microsoft/FluidFramework/wiki) or [fluidframework.com](https://fluidframework.com/docs/).\n\nStill not finding what you're looking for? Please [file an\nissue](https://github.com/microsoft/FluidFramework/wiki/Submitting-Bugs-and-Feature-Requests).\n\nThank you!\n\n\n\n\n\n\n\n\n\n\n## Trademark\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\n\nUse of these trademarks or logos must follow Microsoft's [Trademark & Brand\nGuidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general).\n\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n[initialize-devtools-docs]: https://fluidframework.com/docs/apis/devtools-core#initializedevtools-function\n[devtools-logger-docs]: https://fluidframework.com/docs/apis/devtools-core/devtoolslogger-class\n[devtools-package]: https://www.npmjs.com/package/@fluid-experimental/devtools\n[browser-extension]: https://github.com/microsoft/FluidFramework/tree/main/packages/tools/devtools/devtools-browser-extension\n","scripts":{"tsc":"tsc","lint":"npm run prettier && npm run eslint","test":"npm run test:mocha","build":"fluid-build . --task build","clean":"rimraf --glob \"_api-extractor-temp\" \"nyc\" \"dist\" \"lib\" \"*.tsbuildinfo\" \"*.build.log\"","eslint":"eslint src","format":"npm run prettier:fix","rebuild":"npm run clean && npm run build","lint:fix":"npm run prettier:fix && npm run eslint:fix","prettier":"prettier --check . --ignore-path ../../../../.prettierignore","build:docs":"api-extractor run --local && copyfiles -u 1 ./_api-extractor-temp/doc-models/* ../../../../_api-extractor-temp/","eslint:fix":"eslint src --fix","test:mocha":"mocha dist/**/*.test.js --unhandled-rejections=strict --exit","build:esnext":"tsc --project ./tsconfig.esnext.json","build:genver":"gen-version","prettier:fix":"prettier --write . --ignore-path ../../../../.prettierignore","build:compile":"fluid-build . --task compile","ci:build:docs":"api-extractor run && copyfiles -u 1 ./_api-extractor-temp/doc-models/* ../../../../_api-extractor-temp/","test:coverage":"npm run test:mocha:coverage","typetests:gen":"fluid-type-test-generator","build:commonjs":"fluid-build . --task commonjs","format-and-build":"npm run format && npm run build","typetests:prepare":"flub typetests --dir . --reset --previous --normalize","format-and-compile":"npm run format && npm run build:compile","test:mocha:coverage":"nyc npm run test:mocha -- --reporter xunit --reporter-option output=nyc/junit-report.xml","test:mocha:multireport":"cross-env FLUID_TEST_MULTIREPORT=1 npm run test:mocha"},"_npmUser":{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},"_resolved":"/mnt/vss/_work/1/pack/scoped/fluid-experimental-devtools-core-2.0.0-internal.6.1.3.tgz","_integrity":"sha512-lWbS6DDOmkUJERUYXrSrpEwsYi8nbGfDJzGdRXg0M0ZBkZpkEr+Wd++Xe6IAGFfOxWgzR8n5OtMR1KfYkr++6g==","fluidBuild":{"tasks":{"tsc":["...","typetests:gen"]}},"repository":{"url":"git+https://github.com/microsoft/FluidFramework.git","type":"git","directory":"packages/tools/devtools/devtools-core"},"_npmVersion":"8.11.0","description":"Fluid Framework developer tools core functionality","directories":{},"sideEffects":false,"_nodeVersion":"16.16.0","dependencies":{"@fluidframework/map":">=2.0.0-internal.6.1.3 <2.0.0-internal.6.2.0","@fluidframework/cell":">=2.0.0-internal.6.1.3 <2.0.0-internal.6.2.0","@fluidframework/matrix":">=2.0.0-internal.6.1.3 <2.0.0-internal.6.2.0","@fluidframework/counter":">=2.0.0-internal.6.1.3 <2.0.0-internal.6.2.0","@fluidframework/sequence":">=2.0.0-internal.6.1.3 <2.0.0-internal.6.2.0","@fluid-experimental/tree2":">=2.0.0-internal.6.1.3 <2.0.0-internal.6.2.0","@fluidframework/common-utils":"^1.1.1","@fluidframework/container-utils":">=2.0.0-internal.6.1.3 <2.0.0-internal.6.2.0","@fluidframework/core-interfaces":">=2.0.0-internal.6.1.3 <2.0.0-internal.6.2.0","@fluidframework/container-loader":">=2.0.0-internal.6.1.3 <2.0.0-internal.6.2.0","@fluidframework/common-definitions":"^0.20.1","@fluidframework/shared-object-base":">=2.0.0-internal.6.1.3 <2.0.0-internal.6.2.0","@fluidframework/protocol-definitions":"^1.1.0","@fluidframework/container-definitions":">=2.0.0-internal.6.1.3 <2.0.0-internal.6.2.0","@fluidframework/datastore-definitions":">=2.0.0-internal.6.1.3 <2.0.0-internal.6.2.0"},"_hasShrinkwrap":false,"readmeFilename":"README.md","typeValidation":{"broken":{}},"devDependencies":{"nyc":"^15.1.0","chai":"^4.2.0","mocha":"^10.2.0","eslint":"~8.6.0","events":"^3.1.0","moment":"^2.21.0","rimraf":"^4.4.0","prettier":"~2.6.2","copyfiles":"^2.4.1","cross-env":"^7.0.3","typescript":"~4.5.5","@types/chai":"^4.0.0","@types/mocha":"^9.1.1","concurrently":"^7.6.0","@types/events":"^3.0.0","mocha-multi-reporters":"^1.5.1","@fluid-tools/build-cli":"^0.22.0","eslint-config-prettier":"~8.5.0","@microsoft/api-extractor":"^7.34.4","eslint-plugin-chai-expect":"~3.0.0","mocha-json-output-reporter":"^2.0.1","@fluidframework/build-tools":"^0.22.0","@fluidframework/build-common":"^2.0.0","@fluidframework/telemetry-utils":">=2.0.0-internal.6.1.3 <2.0.0-internal.6.2.0","@fluidframework/mocha-test-setup":">=2.0.0-internal.6.1.3 <2.0.0-internal.6.2.0","@fluidframework/driver-definitions":">=2.0.0-internal.6.1.3 <2.0.0-internal.6.2.0","@fluidframework/test-runtime-utils":">=2.0.0-internal.6.1.3 <2.0.0-internal.6.2.0","@fluidframework/eslint-config-fluid":"^2.0.0","@fluid-experimental/devtools-core-previous":"npm:@fluid-experimental/devtools-core@2.0.0-internal.6.1.1"},"_npmOperationalInternal":{"tmp":"tmp/devtools-core_2.0.0-internal.6.1.3_1696297141383_0.7542525503909245","host":"s3://npm-registry-packages"}},"2.0.0-internal.6.3.4":{"name":"@fluid-experimental/devtools-core","version":"2.0.0-internal.6.3.4","author":{"name":"Microsoft and contributors"},"license":"MIT","_id":"@fluid-experimental/devtools-core@2.0.0-internal.6.3.4","maintainers":[{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},{"name":"curtisman","email":"curtism@microsoft.com"}],"homepage":"https://fluidframework.com","bugs":{"url":"https://github.com/microsoft/FluidFramework/issues"},"c8":{"all":true,"exclude":["src/test/**/*.ts","dist/test/**/*.js"],"include":["src/**/*.ts","dist/**/*.js"],"reporter":["cobertura","html","text"],"cache-dir":"nyc/.cache","report-dir":"nyc/report","temp-directory":"nyc/.nyc_output","exclude-after-remap":false},"dist":{"shasum":"f0e03058fef7ecb3e87b38b4a933e9e48e7f2767","tarball":"https://registry.npmjs.org/@fluid-experimental/devtools-core/-/devtools-core-2.0.0-internal.6.3.4.tgz","fileCount":501,"integrity":"sha512-53r+TlpvbzJEVpSrtagSJ9ruLc5qHB6+cfaCyuuUqU99kw9Eug8+nhIpX0G9CKrkEUIA20g0gKvbn3Hg5SAVnA==","signatures":[{"sig":"MEUCIQDtVRUxZ5OfjGYAj68XWpwCm3JfHH3Cut2up4Ijg43PmwIgdhKFe+FhgeXmMviegmM1vVG3ppRoobHkUlu5bJhyWU8=","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}],"unpackedSize":1368137},"main":"dist/index.js","_from":"file:fluid-experimental-devtools-core-2.0.0-internal.6.3.4.tgz","types":"dist/index.d.ts","module":"lib/index.js","readme":"# @fluid-experimental/devtools-core\n\nThis library contains developer tools for use alongside the Fluid Framework.\nIt is used to power our associated [browser extension][browser-extension].\n\n- Chrome: \n- Edge: \n\n\n\n\n\n\n## Installation\n\nTo get started, install the package by running the following command:\n\n```bash\nnpm i @fluid-experimental/devtools-core -D\n```\n\n\n\n\n\n## Usage\n\nThe Devtools' API surface is designed to fit nicely into most application flows.\n\n### Initialization\n\nTo initialize a devtools session for your container, call [`initializeDevtools`][initialize-devtools-docs].\nThis function accepts a `DevtoolsLogger` for receiving Fluid telemetry from your application, a list of initial Fluid\n`Containers` to associate with the session, and (optionally) customized data visualization configurations for visualizing\n`Container` data.\n\n#### About the [`DevtoolsLogger`][devtools-logger-docs]\n\nThe `DevtoolsLogger` is an optional piece when calling `initializeDevtools` but it is strongly recommended that you use\nit because several features in Fluid Devtools are powered by the telemetry that Fluid Framework generates, and this\nlogger is the way in which that telemetry gets into Fluid Devtools.\n\nYou can obtain a `DevtoolsLogger` by calling its constructor, and then should pass it to `initializeDevtools` _and_\nto the `Loader` instance you'll use to create/load Containers as shown below.\nThis way the logger will receive all the telemetry generated by Fluid Framework in your application, and forward it to\nFluid Devtools as necessary.\n\n```typescript\nimport { DevtoolsLogger, initializeDevtools } from \"@fluid-experimental/devtools-core\";\n\n// Instantiate the logger\nconst devtoolsLogger = new DevtoolsLogger();\n\n// Pass the logger when instantiating the Loader\nconst loader = new Loader({\n\tlogger: devtoolsLogger,\n\t// Other necessary properties ...\n});\n\n// Use the Loader to create (and optionally, attach) a Container\nconst container = await loader.createDetachedContainer(/* params */);\nawait container.attach(/* params */);\n\n// Initialize the Devtools passing the logger and your Container.\n// The Container could be added later as well with devtools.registerContainerDevtools().\nconst devtools = initializeDevtools({\n\tlogger: devtoolsLogger,\n\tinitialContainers: [\n\t\t{\n\t\t\tcontainer,\n\t\t\tcontainerKey: \"My Container\",\n\t\t},\n\t],\n});\n```\n\nIf you're working with `AzureClient` instead of lower-level APIs like the one described above, you probably want to\nrefer to the [@fluid-experimental/devtools package][devtools-package] instead of this one.\n\nDuring local development the recommendation is that your application should receive the `DevtoolsLogger` instance _instead_\nof any logger it would normally receive when deployed to a real environment, to avoid local development activity from\nmixing with real telemetry.\nIf you still want to provide a real application logger and use the Fluid Devtools features that are powered by telemetry\nat the same time, you can pass an existing logger to the `DevtoolsLogger` constructor and it will forward all telemetry\nit receives to that logger as well:\n\n```typescript\nimport { DevtoolsLogger } from \"@fluid-experimental/devtools-core\";\n\n// Your application's logger\nconst yourApplicationLogger = getInstanceOfYourApplicationLogger();\n\nconst devtoolsLogger = new DevtoolsLogger(yourApplicationLogger);\n\n// Pass devtoolsLogger to initializeDevtools() and to your application as described above\n```\n\n### Clean-up\n\nThe Devtools object is managed as a global singleton.\nThat singleton is automatically cleaned up prior to the Window's \"unload\" event.\nSo typical application flows likely won't need to worry about cleanup.\nThat said, if you wish to have tighter control over when the Devtools are torn down, you can simply call the `dispose` method on the handle returned by [initialization](#initialization).\n\n## Contributing to the package\n\n### Build\n\nTo build the package locally, first ensure you have run `pnpm install` from the root of the mono-repo.\nNext, to build the code, run `npm run build` from the root of the mono-repo, or use [fluid-build](https://github.com/microsoft/FluidFramework/tree/main/build-tools/packages/build-tools#running-fluid-build-command-line) via `fluid-build -t build`.\n\n- Note: Once you have run a build from the root, assuming no other changes outside of this package, you may run `npm run build` directly within this directory for a faster build.\n If you make changes to any of this package's local dependencies, you will need to run a build again from the root before building again from directly within this package.\n\n### Test\n\nTo run the tests, first ensure you have followed the [build](#build) steps above.\nNext, run `npm run test` from a terminal within this directory.\n\n\n\n\n\n\n\n## API Documentation\n\nAPI documentation for **@fluid-experimental/devtools-core** is available at .\n\n\n\n\n\n\n\n\n\n\n## Contribution Guidelines\n\nThere are many ways to [contribute](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md) to Fluid.\n\n- Participate in Q&A in our [GitHub Discussions](https://github.com/microsoft/FluidFramework/discussions).\n- [Submit bugs](https://github.com/microsoft/FluidFramework/issues) and help us verify fixes as they are checked in.\n- Review the [source code changes](https://github.com/microsoft/FluidFramework/pulls).\n- [Contribute bug fixes](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md).\n\nDetailed instructions for working in the repo can be found in the [Wiki](https://github.com/microsoft/FluidFramework/wiki).\n\nThis project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).\nFor more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\nUse of these trademarks or logos must follow Microsoft’s [Trademark & Brand Guidelines](https://www.microsoft.com/trademarks).\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n\n\n\n## Help\n\nNot finding what you're looking for in this README? Check out our [GitHub\nWiki](https://github.com/microsoft/FluidFramework/wiki) or [fluidframework.com](https://fluidframework.com/docs/).\n\nStill not finding what you're looking for? Please [file an\nissue](https://github.com/microsoft/FluidFramework/wiki/Submitting-Bugs-and-Feature-Requests).\n\nThank you!\n\n\n\n\n\n\n\n\n\n\n## Trademark\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\n\nUse of these trademarks or logos must follow Microsoft's [Trademark & Brand\nGuidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general).\n\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n[initialize-devtools-docs]: https://fluidframework.com/docs/apis/devtools-core#initializedevtools-function\n[devtools-logger-docs]: https://fluidframework.com/docs/apis/devtools-core/devtoolslogger-class\n[devtools-package]: https://www.npmjs.com/package/@fluid-experimental/devtools\n[browser-extension]: https://github.com/microsoft/FluidFramework/tree/main/packages/tools/devtools/devtools-browser-extension\n","scripts":{"tsc":"tsc","lint":"npm run prettier && npm run eslint","test":"npm run test:mocha","build":"fluid-build . --task build","clean":"rimraf --glob '_api-extractor-temp' 'nyc' 'dist' 'lib' '*.tsbuildinfo' '*.build.log'","eslint":"eslint src","format":"npm run prettier:fix","rebuild":"npm run clean && npm run build","lint:fix":"npm run prettier:fix && npm run eslint:fix","prettier":"prettier --check . --ignore-path ../../../../.prettierignore","tsc:watch":"tsc --watch","build:docs":"api-extractor run --local && copyfiles -u 1 ./_api-extractor-temp/doc-models/* ../../../../_api-extractor-temp/","eslint:fix":"eslint src --fix","test:mocha":"mocha dist/**/*.test.js --exit","build:esnext":"tsc --project ./tsconfig.esnext.json","build:genver":"gen-version","prettier:fix":"prettier --write . --ignore-path ../../../../.prettierignore","build:compile":"fluid-build . --task compile","ci:build:docs":"api-extractor run && copyfiles -u 1 ./_api-extractor-temp/doc-models/* ../../../../_api-extractor-temp/","test:coverage":"c8 npm test","typetests:gen":"fluid-type-test-generator","build:commonjs":"fluid-build . --task commonjs","format-and-build":"npm run format && npm run build","typetests:prepare":"flub typetests --dir . --reset --previous --normalize","format-and-compile":"npm run format && npm run build:compile"},"_npmUser":{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},"_resolved":"/mnt/vss/_work/1/pack/scoped/fluid-experimental-devtools-core-2.0.0-internal.6.3.4.tgz","_integrity":"sha512-53r+TlpvbzJEVpSrtagSJ9ruLc5qHB6+cfaCyuuUqU99kw9Eug8+nhIpX0G9CKrkEUIA20g0gKvbn3Hg5SAVnA==","fluidBuild":{"tasks":{"tsc":["...","typetests:gen"]}},"repository":{"url":"git+https://github.com/microsoft/FluidFramework.git","type":"git","directory":"packages/tools/devtools/devtools-core"},"_npmVersion":"9.6.7","description":"Fluid Framework developer tools core functionality","directories":{},"sideEffects":false,"_nodeVersion":"18.17.1","dependencies":{"@fluidframework/map":">=2.0.0-internal.6.3.4 <2.0.0-internal.6.4.0","@fluidframework/cell":">=2.0.0-internal.6.3.4 <2.0.0-internal.6.4.0","@fluidframework/matrix":">=2.0.0-internal.6.3.4 <2.0.0-internal.6.4.0","@fluidframework/counter":">=2.0.0-internal.6.3.4 <2.0.0-internal.6.4.0","@fluidframework/sequence":">=2.0.0-internal.6.3.4 <2.0.0-internal.6.4.0","@fluid-experimental/tree2":">=2.0.0-internal.6.3.4 <2.0.0-internal.6.4.0","@fluid-internal/client-utils":">=2.0.0-internal.6.3.4 <2.0.0-internal.6.4.0","@fluidframework/core-interfaces":">=2.0.0-internal.6.3.4 <2.0.0-internal.6.4.0","@fluidframework/telemetry-utils":">=2.0.0-internal.6.3.4 <2.0.0-internal.6.4.0","@fluidframework/container-loader":">=2.0.0-internal.6.3.4 <2.0.0-internal.6.4.0","@fluidframework/shared-object-base":">=2.0.0-internal.6.3.4 <2.0.0-internal.6.4.0","@fluidframework/protocol-definitions":"^1.1.0","@fluidframework/container-definitions":">=2.0.0-internal.6.3.4 <2.0.0-internal.6.4.0","@fluidframework/datastore-definitions":">=2.0.0-internal.6.3.4 <2.0.0-internal.6.4.0"},"_hasShrinkwrap":false,"readmeFilename":"README.md","typeValidation":{"broken":{}},"devDependencies":{"c8":"^7.7.1","chai":"^4.2.0","mocha":"^10.2.0","eslint":"~8.6.0","events":"^3.1.0","moment":"^2.21.0","rimraf":"^4.4.0","prettier":"~2.6.2","copyfiles":"^2.4.1","cross-env":"^7.0.3","typescript":"~4.5.5","@types/chai":"^4.0.0","@types/mocha":"^9.1.1","@types/events":"^3.0.0","mocha-multi-reporters":"^1.5.1","@fluid-tools/build-cli":"^0.22.0","eslint-config-prettier":"~8.5.0","@microsoft/api-extractor":"^7.34.4","eslint-plugin-chai-expect":"~3.0.0","mocha-json-output-reporter":"^2.0.1","@fluidframework/build-tools":"^0.22.0","@fluidframework/build-common":"^2.0.0","@fluidframework/mocha-test-setup":">=2.0.0-internal.6.3.4 <2.0.0-internal.6.4.0","@fluidframework/driver-definitions":">=2.0.0-internal.6.3.4 <2.0.0-internal.6.4.0","@fluidframework/test-runtime-utils":">=2.0.0-internal.6.3.4 <2.0.0-internal.6.4.0","@fluidframework/eslint-config-fluid":"^2.1.0","@fluid-experimental/devtools-core-previous":"npm:@fluid-experimental/devtools-core@2.0.0-internal.6.3.1"},"_npmOperationalInternal":{"tmp":"tmp/devtools-core_2.0.0-internal.6.3.4_1696300810729_0.45749929662868705","host":"s3://npm-registry-packages"}},"2.0.0-internal.6.2.2":{"name":"@fluid-experimental/devtools-core","version":"2.0.0-internal.6.2.2","author":{"name":"Microsoft and contributors"},"license":"MIT","_id":"@fluid-experimental/devtools-core@2.0.0-internal.6.2.2","maintainers":[{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},{"name":"curtisman","email":"curtism@microsoft.com"}],"homepage":"https://fluidframework.com","bugs":{"url":"https://github.com/microsoft/FluidFramework/issues"},"nyc":{"all":true,"exclude":["src/test/**/*.ts","dist/test/**/*.js"],"include":["src/**/*.ts","dist/**/*.js"],"reporter":["cobertura","html","text"],"cache-dir":"nyc/.cache","report-dir":"nyc/report","temp-directory":"nyc/.nyc_output","exclude-after-remap":false},"dist":{"shasum":"4a32b4a4857536db30fa1adb9eb30e85ec5d2530","tarball":"https://registry.npmjs.org/@fluid-experimental/devtools-core/-/devtools-core-2.0.0-internal.6.2.2.tgz","fileCount":501,"integrity":"sha512-bDmwpFawbxpHV23m8mq3SjeyUrc8Ktx+3CSTzlyi3KIC4n32svv5umaZiofL2km1Ix/1qLvHXwRSfZsMjyiwXA==","signatures":[{"sig":"MEQCIG20xRRAczLN14+am3xYQI1P97KyCG9enG/FlTl0UFqdAiA/2tOOWc9ib4hI4jC1L34Ik9a0iiJqBfe25sc0nx92LQ==","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}],"unpackedSize":1368282},"main":"dist/index.js","_from":"file:fluid-experimental-devtools-core-2.0.0-internal.6.2.2.tgz","types":"dist/index.d.ts","readme":"# @fluid-experimental/devtools-core\n\nThis library contains developer tools for use alongside the Fluid Framework.\nIt is used to power our associated [browser extension][browser-extension].\n\n- Chrome: \n- Edge: \n\n\n\n\n\n\n## Installation\n\nTo get started, install the package by running the following command:\n\n```bash\nnpm i @fluid-experimental/devtools-core -D\n```\n\n\n\n\n\n## Usage\n\nThe Devtools' API surface is designed to fit nicely into most application flows.\n\n### Initialization\n\nTo initialize a devtools session for your container, call [`initializeDevtools`][initialize-devtools-docs].\nThis function accepts a `DevtoolsLogger` for receiving Fluid telemetry from your application, a list of initial Fluid\n`Containers` to associate with the session, and (optionally) customized data visualization configurations for visualizing\n`Container` data.\n\n#### About the [`DevtoolsLogger`][devtools-logger-docs]\n\nThe `DevtoolsLogger` is an optional piece when calling `initializeDevtools` but it is strongly recommended that you use\nit because several features in Fluid Devtools are powered by the telemetry that Fluid Framework generates, and this\nlogger is the way in which that telemetry gets into Fluid Devtools.\n\nYou can obtain a `DevtoolsLogger` by calling its constructor, and then should pass it to `initializeDevtools` _and_\nto the `Loader` instance you'll use to create/load Containers as shown below.\nThis way the logger will receive all the telemetry generated by Fluid Framework in your application, and forward it to\nFluid Devtools as necessary.\n\n```typescript\nimport { DevtoolsLogger, initializeDevtools } from \"@fluid-experimental/devtools-core\";\n\n// Instantiate the logger\nconst devtoolsLogger = new DevtoolsLogger();\n\n// Pass the logger when instantiating the Loader\nconst loader = new Loader({\n\tlogger: devtoolsLogger,\n\t// Other necessary properties ...\n});\n\n// Use the Loader to create (and optionally, attach) a Container\nconst container = await loader.createDetachedContainer(/* params */);\nawait container.attach(/* params */);\n\n// Initialize the Devtools passing the logger and your Container.\n// The Container could be added later as well with devtools.registerContainerDevtools().\nconst devtools = initializeDevtools({\n\tlogger: devtoolsLogger,\n\tinitialContainers: [\n\t\t{\n\t\t\tcontainer,\n\t\t\tcontainerKey: \"My Container\",\n\t\t},\n\t],\n});\n```\n\nIf you're working with `AzureClient` instead of lower-level APIs like the one described above, you probably want to\nrefer to the [@fluid-experimental/devtools package][devtools-package] instead of this one.\n\nDuring local development the recommendation is that your application should receive the `DevtoolsLogger` instance _instead_\nof any logger it would normally receive when deployed to a real environment, to avoid local development activity from\nmixing with real telemetry.\nIf you still want to provide a real application logger and use the Fluid Devtools features that are powered by telemetry\nat the same time, you can pass an existing logger to the `DevtoolsLogger` constructor and it will forward all telemetry\nit receives to that logger as well:\n\n```typescript\nimport { DevtoolsLogger } from \"@fluid-experimental/devtools-core\";\n\n// Your application's logger\nconst yourApplicationLogger = getInstanceOfYourApplicationLogger();\n\nconst devtoolsLogger = new DevtoolsLogger(yourApplicationLogger);\n\n// Pass devtoolsLogger to initializeDevtools() and to your application as described above\n```\n\n### Clean-up\n\nThe Devtools object is managed as a global singleton.\nThat singleton is automatically cleaned up prior to the Window's \"unload\" event.\nSo typical application flows likely won't need to worry about cleanup.\nThat said, if you wish to have tighter control over when the Devtools are torn down, you can simply call the `dispose` method on the handle returned by [initialization](#initialization).\n\n## Contributing to the package\n\n### Build\n\nTo build the package locally, first ensure you have run `pnpm install` from the root of the mono-repo.\nNext, to build the code, run `npm run build` from the root of the mono-repo, or use [fluid-build](https://github.com/microsoft/FluidFramework/tree/main/build-tools/packages/build-tools#running-fluid-build-command-line) via `fluid-build -t build`.\n\n- Note: Once you have run a build from the root, assuming no other changes outside of this package, you may run `npm run build` directly within this directory for a faster build.\n If you make changes to any of this package's local dependencies, you will need to run a build again from the root before building again from directly within this package.\n\n### Test\n\nTo run the tests, first ensure you have followed the [build](#build) steps above.\nNext, run `npm run test` from a terminal within this directory.\n\n\n\n\n\n\n\n## API Documentation\n\nAPI documentation for **@fluid-experimental/devtools-core** is available at .\n\n\n\n\n\n\n\n\n\n\n## Contribution Guidelines\n\nThere are many ways to [contribute](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md) to Fluid.\n\n- Participate in Q&A in our [GitHub Discussions](https://github.com/microsoft/FluidFramework/discussions).\n- [Submit bugs](https://github.com/microsoft/FluidFramework/issues) and help us verify fixes as they are checked in.\n- Review the [source code changes](https://github.com/microsoft/FluidFramework/pulls).\n- [Contribute bug fixes](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md).\n\nDetailed instructions for working in the repo can be found in the [Wiki](https://github.com/microsoft/FluidFramework/wiki).\n\nThis project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).\nFor more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\nUse of these trademarks or logos must follow Microsoft’s [Trademark & Brand Guidelines](https://www.microsoft.com/trademarks).\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n\n\n\n## Help\n\nNot finding what you're looking for in this README? Check out our [GitHub\nWiki](https://github.com/microsoft/FluidFramework/wiki) or [fluidframework.com](https://fluidframework.com/docs/).\n\nStill not finding what you're looking for? Please [file an\nissue](https://github.com/microsoft/FluidFramework/wiki/Submitting-Bugs-and-Feature-Requests).\n\nThank you!\n\n\n\n\n\n\n\n\n\n\n## Trademark\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\n\nUse of these trademarks or logos must follow Microsoft's [Trademark & Brand\nGuidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general).\n\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n[initialize-devtools-docs]: https://fluidframework.com/docs/apis/devtools-core#initializedevtools-function\n[devtools-logger-docs]: https://fluidframework.com/docs/apis/devtools-core/devtoolslogger-class\n[devtools-package]: https://www.npmjs.com/package/@fluid-experimental/devtools\n[browser-extension]: https://github.com/microsoft/FluidFramework/tree/main/packages/tools/devtools/devtools-browser-extension\n","scripts":{"tsc":"tsc","lint":"npm run prettier && npm run eslint","test":"npm run test:mocha","build":"fluid-build . --task build","clean":"rimraf --glob \"_api-extractor-temp\" \"nyc\" \"dist\" \"lib\" \"*.tsbuildinfo\" \"*.build.log\"","eslint":"eslint src","format":"npm run prettier:fix","rebuild":"npm run clean && npm run build","lint:fix":"npm run prettier:fix && npm run eslint:fix","prettier":"prettier --check . --ignore-path ../../../../.prettierignore","tsc:watch":"tsc --watch","build:docs":"api-extractor run --local && copyfiles -u 1 ./_api-extractor-temp/doc-models/* ../../../../_api-extractor-temp/","eslint:fix":"eslint src --fix","test:mocha":"mocha dist/**/*.test.js --unhandled-rejections=strict --exit","build:esnext":"tsc --project ./tsconfig.esnext.json","build:genver":"gen-version","prettier:fix":"prettier --write . --ignore-path ../../../../.prettierignore","build:compile":"fluid-build . --task compile","ci:build:docs":"api-extractor run && copyfiles -u 1 ./_api-extractor-temp/doc-models/* ../../../../_api-extractor-temp/","test:coverage":"npm run test:mocha:coverage","typetests:gen":"fluid-type-test-generator","build:commonjs":"fluid-build . --task commonjs","format-and-build":"npm run format && npm run build","typetests:prepare":"flub typetests --dir . --reset --previous --normalize","format-and-compile":"npm run format && npm run build:compile","test:mocha:coverage":"nyc npm run test:mocha -- --reporter xunit --reporter-option output=nyc/junit-report.xml","test:mocha:multireport":"npm run test:mocha"},"_npmUser":{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},"_resolved":"/mnt/vss/_work/1/pack/scoped/fluid-experimental-devtools-core-2.0.0-internal.6.2.2.tgz","_integrity":"sha512-bDmwpFawbxpHV23m8mq3SjeyUrc8Ktx+3CSTzlyi3KIC4n32svv5umaZiofL2km1Ix/1qLvHXwRSfZsMjyiwXA==","fluidBuild":{"tasks":{"tsc":["...","typetests:gen"]}},"repository":{"url":"git+https://github.com/microsoft/FluidFramework.git","type":"git","directory":"packages/tools/devtools/devtools-core"},"_npmVersion":"8.11.0","description":"Fluid Framework developer tools core functionality","directories":{},"sideEffects":false,"_nodeVersion":"16.16.0","dependencies":{"@fluidframework/map":">=2.0.0-internal.6.2.2 <2.0.0-internal.6.3.0","@fluidframework/cell":">=2.0.0-internal.6.2.2 <2.0.0-internal.6.3.0","@fluidframework/matrix":">=2.0.0-internal.6.2.2 <2.0.0-internal.6.3.0","@fluidframework/counter":">=2.0.0-internal.6.2.2 <2.0.0-internal.6.3.0","@fluidframework/sequence":">=2.0.0-internal.6.2.2 <2.0.0-internal.6.3.0","@fluid-experimental/tree2":">=2.0.0-internal.6.2.2 <2.0.0-internal.6.3.0","@fluidframework/common-utils":"^1.1.1","@fluidframework/core-interfaces":">=2.0.0-internal.6.2.2 <2.0.0-internal.6.3.0","@fluidframework/telemetry-utils":">=2.0.0-internal.6.2.2 <2.0.0-internal.6.3.0","@fluidframework/container-loader":">=2.0.0-internal.6.2.2 <2.0.0-internal.6.3.0","@fluidframework/shared-object-base":">=2.0.0-internal.6.2.2 <2.0.0-internal.6.3.0","@fluidframework/protocol-definitions":"^1.1.0","@fluidframework/container-definitions":">=2.0.0-internal.6.2.2 <2.0.0-internal.6.3.0","@fluidframework/datastore-definitions":">=2.0.0-internal.6.2.2 <2.0.0-internal.6.3.0"},"_hasShrinkwrap":false,"readmeFilename":"README.md","typeValidation":{"broken":{}},"devDependencies":{"nyc":"^15.1.0","chai":"^4.2.0","mocha":"^10.2.0","eslint":"~8.6.0","events":"^3.1.0","moment":"^2.21.0","rimraf":"^4.4.0","prettier":"~2.6.2","copyfiles":"^2.4.1","cross-env":"^7.0.3","typescript":"~4.5.5","@types/chai":"^4.0.0","@types/mocha":"^9.1.1","concurrently":"^7.6.0","@types/events":"^3.0.0","mocha-multi-reporters":"^1.5.1","@fluid-tools/build-cli":"^0.23.0","eslint-config-prettier":"~8.5.0","@microsoft/api-extractor":"^7.34.4","eslint-plugin-chai-expect":"~3.0.0","mocha-json-output-reporter":"^2.0.1","@fluidframework/build-tools":"^0.23.0","@fluidframework/build-common":"^2.0.0","@fluidframework/mocha-test-setup":">=2.0.0-internal.6.2.2 <2.0.0-internal.6.3.0","@fluidframework/driver-definitions":">=2.0.0-internal.6.2.2 <2.0.0-internal.6.3.0","@fluidframework/test-runtime-utils":">=2.0.0-internal.6.2.2 <2.0.0-internal.6.3.0","@fluidframework/eslint-config-fluid":"^2.1.0","@fluid-experimental/devtools-core-previous":"npm:@fluid-experimental/devtools-core@2.0.0-internal.6.1.1"},"_npmOperationalInternal":{"tmp":"tmp/devtools-core_2.0.0-internal.6.2.2_1696310009077_0.7406416014365509","host":"s3://npm-registry-packages"}},"2.0.0-internal.7.1.0":{"name":"@fluid-experimental/devtools-core","version":"2.0.0-internal.7.1.0","author":{"name":"Microsoft and contributors"},"license":"MIT","_id":"@fluid-experimental/devtools-core@2.0.0-internal.7.1.0","maintainers":[{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},{"name":"curtisman","email":"curtism@microsoft.com"}],"homepage":"https://fluidframework.com","bugs":{"url":"https://github.com/microsoft/FluidFramework/issues"},"c8":{"all":true,"exclude":["src/test/**/*.ts","dist/test/**/*.js"],"include":["src/**/*.ts","dist/**/*.js"],"reporter":["cobertura","html","text"],"cache-dir":"nyc/.cache","report-dir":"nyc/report","temp-directory":"nyc/.nyc_output","exclude-after-remap":false},"dist":{"shasum":"cfdff52fe57393ecaf317c710075f1f4187e3428","tarball":"https://registry.npmjs.org/@fluid-experimental/devtools-core/-/devtools-core-2.0.0-internal.7.1.0.tgz","fileCount":505,"integrity":"sha512-z/jjBlG86L5Pwj2efFnSOiBsXO1snnfxVQE2KhKlUOI148XICY6aZv3/Qnco/LgSiGmlZJwoeuyAbr0b4+48vg==","signatures":[{"sig":"MEYCIQD/OdCJ7A07HtXp4TTtaGzbsASh4zYjfH9UGptCM12YVAIhAP9FVxJ2Jk3LPuzW8uy/pebRIdpQPoYst+5jXFZ+sVHI","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}],"unpackedSize":1468034},"main":"dist/index.js","_from":"file:fluid-experimental-devtools-core-2.0.0-internal.7.1.0.tgz","types":"dist/index.d.ts","module":"lib/index.js","readme":"# @fluid-experimental/devtools-core\n\nThis library contains developer tools for use alongside the Fluid Framework.\nIt is used to power our associated [browser extension][browser-extension].\n\n- Chrome: \n- Edge: \n\n\n\n\n\n\n## Installation\n\nTo get started, install the package by running the following command:\n\n```bash\nnpm i @fluid-experimental/devtools-core -D\n```\n\n\n\n\n\n## Usage\n\nThe Devtools' API surface is designed to fit nicely into most application flows.\n\n### Initialization\n\nTo initialize a devtools session for your container, call [`initializeDevtools`][initialize-devtools-docs].\nThis function accepts a `DevtoolsLogger` for receiving Fluid telemetry from your application, a list of initial Fluid\n`Containers` to associate with the session, and (optionally) customized data visualization configurations for visualizing\n`Container` data.\n\n#### About the [`DevtoolsLogger`][devtools-logger-docs]\n\nThe `DevtoolsLogger` is an optional piece when calling `initializeDevtools` but it is strongly recommended that you use\nit because several features in Fluid Devtools are powered by the telemetry that Fluid Framework generates, and this\nlogger is the way in which that telemetry gets into Fluid Devtools.\n\nYou can obtain a `DevtoolsLogger` by calling its constructor, and then should pass it to `initializeDevtools` _and_\nto the `Loader` instance you'll use to create/load Containers as shown below.\nThis way the logger will receive all the telemetry generated by Fluid Framework in your application, and forward it to\nFluid Devtools as necessary.\n\n```typescript\nimport { DevtoolsLogger, initializeDevtools } from \"@fluid-experimental/devtools-core\";\n\n// Instantiate the logger\nconst devtoolsLogger = new DevtoolsLogger();\n\n// Pass the logger when instantiating the Loader\nconst loader = new Loader({\n\tlogger: devtoolsLogger,\n\t// Other necessary properties ...\n});\n\n// Use the Loader to create (and optionally, attach) a Container\nconst container = await loader.createDetachedContainer(/* params */);\nawait container.attach(/* params */);\n\n// Initialize the Devtools passing the logger and your Container.\n// The Container could be added later as well with devtools.registerContainerDevtools().\nconst devtools = initializeDevtools({\n\tlogger: devtoolsLogger,\n\tinitialContainers: [\n\t\t{\n\t\t\tcontainer,\n\t\t\tcontainerKey: \"My Container\",\n\t\t},\n\t],\n});\n```\n\nIf you're working with `AzureClient` instead of lower-level APIs like the one described above, you probably want to\nrefer to the [@fluid-experimental/devtools package][devtools-package] instead of this one.\n\nDuring local development the recommendation is that your application should receive the `DevtoolsLogger` instance _instead_\nof any logger it would normally receive when deployed to a real environment, to avoid local development activity from\nmixing with real telemetry.\nIf you still want to provide a real application logger and use the Fluid Devtools features that are powered by telemetry\nat the same time, you can pass an existing logger to the `DevtoolsLogger` constructor and it will forward all telemetry\nit receives to that logger as well:\n\n```typescript\nimport { DevtoolsLogger } from \"@fluid-experimental/devtools-core\";\n\n// Your application's logger\nconst yourApplicationLogger = getInstanceOfYourApplicationLogger();\n\nconst devtoolsLogger = new DevtoolsLogger(yourApplicationLogger);\n\n// Pass devtoolsLogger to initializeDevtools() and to your application as described above\n```\n\n### Clean-up\n\nThe Devtools object is managed as a global singleton.\nThat singleton is automatically cleaned up prior to the Window's \"unload\" event.\nSo typical application flows likely won't need to worry about cleanup.\nThat said, if you wish to have tighter control over when the Devtools are torn down, you can simply call the `dispose` method on the handle returned by [initialization](#initialization).\n\n## Contributing to the package\n\n### Build\n\nTo build the package locally, first ensure you have run `pnpm install` from the root of the mono-repo.\nNext, to build the code, run `npm run build` from the root of the mono-repo, or use [fluid-build](https://github.com/microsoft/FluidFramework/tree/main/build-tools/packages/build-tools#running-fluid-build-command-line) via `fluid-build -t build`.\n\n- Note: Once you have run a build from the root, assuming no other changes outside of this package, you may run `npm run build` directly within this directory for a faster build.\n If you make changes to any of this package's local dependencies, you will need to run a build again from the root before building again from directly within this package.\n\n### Test\n\nTo run the tests, first ensure you have followed the [build](#build) steps above.\nNext, run `npm run test` from a terminal within this directory.\n\n\n\n\n\n\n\n## API Documentation\n\nAPI documentation for **@fluid-experimental/devtools-core** is available at .\n\n\n\n\n\n\n\n\n\n\n## Contribution Guidelines\n\nThere are many ways to [contribute](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md) to Fluid.\n\n- Participate in Q&A in our [GitHub Discussions](https://github.com/microsoft/FluidFramework/discussions).\n- [Submit bugs](https://github.com/microsoft/FluidFramework/issues) and help us verify fixes as they are checked in.\n- Review the [source code changes](https://github.com/microsoft/FluidFramework/pulls).\n- [Contribute bug fixes](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md).\n\nDetailed instructions for working in the repo can be found in the [Wiki](https://github.com/microsoft/FluidFramework/wiki).\n\nThis project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).\nFor more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\nUse of these trademarks or logos must follow Microsoft’s [Trademark & Brand Guidelines](https://www.microsoft.com/trademarks).\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n\n\n\n## Help\n\nNot finding what you're looking for in this README? Check out our [GitHub\nWiki](https://github.com/microsoft/FluidFramework/wiki) or [fluidframework.com](https://fluidframework.com/docs/).\n\nStill not finding what you're looking for? Please [file an\nissue](https://github.com/microsoft/FluidFramework/wiki/Submitting-Bugs-and-Feature-Requests).\n\nThank you!\n\n\n\n\n\n\n\n\n\n\n## Trademark\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\n\nUse of these trademarks or logos must follow Microsoft's [Trademark & Brand\nGuidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general).\n\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n[initialize-devtools-docs]: https://fluidframework.com/docs/apis/devtools-core#initializedevtools-function\n[devtools-logger-docs]: https://fluidframework.com/docs/apis/devtools-core/devtoolslogger-class\n[devtools-package]: https://www.npmjs.com/package/@fluid-experimental/devtools\n[browser-extension]: https://github.com/microsoft/FluidFramework/tree/main/packages/tools/devtools/devtools-browser-extension\n","scripts":{"tsc":"tsc","lint":"npm run prettier && npm run eslint","test":"npm run test:mocha","build":"fluid-build . --task build","clean":"rimraf --glob '_api-extractor-temp' 'nyc' 'dist' 'lib' '*.tsbuildinfo' '*.build.log'","eslint":"eslint src","format":"npm run prettier:fix","rebuild":"npm run clean && npm run build","lint:fix":"npm run prettier:fix && npm run eslint:fix","prettier":"prettier --check . --ignore-path ../../../../.prettierignore","tsc:watch":"tsc --watch","build:docs":"api-extractor run --local","eslint:fix":"eslint src --fix","test:mocha":"mocha dist/**/*.test.js --exit","build:esnext":"tsc --project ./tsconfig.esnext.json","build:genver":"gen-version","prettier:fix":"prettier --write . --ignore-path ../../../../.prettierignore","build:compile":"fluid-build . --task compile","ci:build:docs":"api-extractor run","test:coverage":"c8 npm test","typetests:gen":"fluid-type-test-generator","build:commonjs":"fluid-build . --task commonjs","format-and-build":"npm run format && npm run build","typetests:prepare":"flub typetests --dir . --reset --previous --normalize","format-and-compile":"npm run format && npm run build:compile"},"_npmUser":{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},"_resolved":"/mnt/vss/_work/1/pack/scoped/fluid-experimental-devtools-core-2.0.0-internal.7.1.0.tgz","_integrity":"sha512-z/jjBlG86L5Pwj2efFnSOiBsXO1snnfxVQE2KhKlUOI148XICY6aZv3/Qnco/LgSiGmlZJwoeuyAbr0b4+48vg==","fluidBuild":{"tasks":{"tsc":["...","typetests:gen"]}},"repository":{"url":"git+https://github.com/microsoft/FluidFramework.git","type":"git","directory":"packages/tools/devtools/devtools-core"},"_npmVersion":"9.6.7","description":"Fluid Framework developer tools core functionality","directories":{},"sideEffects":false,"_nodeVersion":"18.17.1","dependencies":{"@fluidframework/map":">=2.0.0-internal.7.1.0 <2.0.0-internal.7.2.0","@fluidframework/cell":">=2.0.0-internal.7.1.0 <2.0.0-internal.7.2.0","@fluidframework/matrix":">=2.0.0-internal.7.1.0 <2.0.0-internal.7.2.0","@fluidframework/counter":">=2.0.0-internal.7.1.0 <2.0.0-internal.7.2.0","@fluidframework/sequence":">=2.0.0-internal.7.1.0 <2.0.0-internal.7.2.0","@fluid-experimental/tree2":">=2.0.0-internal.7.1.0 <2.0.0-internal.7.2.0","@fluid-internal/client-utils":">=2.0.0-internal.7.1.0 <2.0.0-internal.7.2.0","@fluidframework/core-interfaces":">=2.0.0-internal.7.1.0 <2.0.0-internal.7.2.0","@fluidframework/telemetry-utils":">=2.0.0-internal.7.1.0 <2.0.0-internal.7.2.0","@fluidframework/container-loader":">=2.0.0-internal.7.1.0 <2.0.0-internal.7.2.0","@fluidframework/shared-object-base":">=2.0.0-internal.7.1.0 <2.0.0-internal.7.2.0","@fluidframework/protocol-definitions":"^3.0.0","@fluidframework/container-definitions":">=2.0.0-internal.7.1.0 <2.0.0-internal.7.2.0","@fluidframework/datastore-definitions":">=2.0.0-internal.7.1.0 <2.0.0-internal.7.2.0"},"_hasShrinkwrap":false,"readmeFilename":"README.md","typeValidation":{"broken":{}},"devDependencies":{"c8":"^7.7.1","chai":"^4.2.0","mocha":"^10.2.0","eslint":"~8.50.0","events":"^3.1.0","moment":"^2.21.0","rimraf":"^4.4.0","prettier":"~3.0.3","copyfiles":"^2.4.1","cross-env":"^7.0.3","typescript":"~5.1.6","@types/chai":"^4.0.0","@types/mocha":"^9.1.1","@types/events":"^3.0.0","mocha-multi-reporters":"^1.5.1","@fluid-tools/build-cli":"^0.25.0","eslint-config-prettier":"~9.0.0","@microsoft/api-extractor":"^7.37.0","eslint-plugin-chai-expect":"~3.0.0","mocha-json-output-reporter":"^2.0.1","@fluidframework/build-tools":"^0.25.0","@fluidframework/build-common":"^2.0.1","@fluidframework/mocha-test-setup":">=2.0.0-internal.7.1.0 <2.0.0-internal.7.2.0","@fluidframework/driver-definitions":">=2.0.0-internal.7.1.0 <2.0.0-internal.7.2.0","@fluidframework/test-runtime-utils":">=2.0.0-internal.7.1.0 <2.0.0-internal.7.2.0","@fluidframework/eslint-config-fluid":"^3.0.0","@fluid-experimental/devtools-core-previous":"npm:@fluid-experimental/devtools-core@2.0.0-internal.7.0.0"},"_npmOperationalInternal":{"tmp":"tmp/devtools-core_2.0.0-internal.7.1.0_1697236363816_0.6726610889915297","host":"s3://npm-registry-packages"}},"2.0.0-dev.7.2.0.203917":{"name":"@fluid-experimental/devtools-core","version":"2.0.0-dev.7.2.0.203917","author":{"name":"Microsoft and contributors"},"license":"MIT","_id":"@fluid-experimental/devtools-core@2.0.0-dev.7.2.0.203917","maintainers":[{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},{"name":"curtisman","email":"curtism@microsoft.com"}],"homepage":"https://fluidframework.com","bugs":{"url":"https://github.com/microsoft/FluidFramework/issues"},"c8":{"all":true,"exclude":["src/test/**/*.ts","dist/test/**/*.js"],"include":["src/**/*.ts","dist/**/*.js"],"reporter":["cobertura","html","text"],"cache-dir":"nyc/.cache","report-dir":"nyc/report","temp-directory":"nyc/.nyc_output","exclude-after-remap":false},"dist":{"shasum":"ee70c56923f50b51d70dc284fc7817ba8e3ca5a9","tarball":"https://registry.npmjs.org/@fluid-experimental/devtools-core/-/devtools-core-2.0.0-dev.7.2.0.203917.tgz","fileCount":505,"integrity":"sha512-tN0fhlzCkk0fTwMd9Jlx07mnz6FvnF+XJX2URXjC4a91GswmARa65yyLbXdw47xGLl3EXs8ZfjPvl66YLPW0ew==","signatures":[{"sig":"MEQCIFJ8mZk9XG8jAC+YdpVW3vGV5Bg1VjxG9DuNAqXjQ4XkAiAYmP7NA6QBYrRT596bCz+V+AHr0O1Es8NVf5Dits8sHA==","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}],"unpackedSize":1467677},"main":"dist/index.js","_from":"file:fluid-experimental-devtools-core-2.0.0-dev.7.2.0.203917.tgz","types":"dist/index.d.ts","module":"lib/index.js","readme":"# @fluid-experimental/devtools-core\n\nThis library contains developer tools for use alongside the Fluid Framework.\nIt is used to power our associated [browser extension][browser-extension].\n\n- Chrome: \n- Edge: \n\n\n\n\n\n\n## Installation\n\nTo get started, install the package by running the following command:\n\n```bash\nnpm i @fluid-experimental/devtools-core -D\n```\n\n\n\n\n\n## Usage\n\nThe Devtools' API surface is designed to fit nicely into most application flows.\n\n### Initialization\n\nTo initialize a devtools session for your container, call [`initializeDevtools`][initialize-devtools-docs].\nThis function accepts a `DevtoolsLogger` for receiving Fluid telemetry from your application, a list of initial Fluid\n`Containers` to associate with the session, and (optionally) customized data visualization configurations for visualizing\n`Container` data.\n\n#### About the [`DevtoolsLogger`][devtools-logger-docs]\n\nThe `DevtoolsLogger` is an optional piece when calling `initializeDevtools` but it is strongly recommended that you use\nit because several features in Fluid Devtools are powered by the telemetry that Fluid Framework generates, and this\nlogger is the way in which that telemetry gets into Fluid Devtools.\n\nYou can obtain a `DevtoolsLogger` by calling its constructor, and then should pass it to `initializeDevtools` _and_\nto the `Loader` instance you'll use to create/load Containers as shown below.\nThis way the logger will receive all the telemetry generated by Fluid Framework in your application, and forward it to\nFluid Devtools as necessary.\n\n```typescript\nimport { DevtoolsLogger, initializeDevtools } from \"@fluid-experimental/devtools-core\";\n\n// Instantiate the logger\nconst devtoolsLogger = new DevtoolsLogger();\n\n// Pass the logger when instantiating the Loader\nconst loader = new Loader({\n\tlogger: devtoolsLogger,\n\t// Other necessary properties ...\n});\n\n// Use the Loader to create (and optionally, attach) a Container\nconst container = await loader.createDetachedContainer(/* params */);\nawait container.attach(/* params */);\n\n// Initialize the Devtools passing the logger and your Container.\n// The Container could be added later as well with devtools.registerContainerDevtools().\nconst devtools = initializeDevtools({\n\tlogger: devtoolsLogger,\n\tinitialContainers: [\n\t\t{\n\t\t\tcontainer,\n\t\t\tcontainerKey: \"My Container\",\n\t\t},\n\t],\n});\n```\n\nIf you're working with `AzureClient` instead of lower-level APIs like the one described above, you probably want to\nrefer to the [@fluid-experimental/devtools package][devtools-package] instead of this one.\n\nDuring local development the recommendation is that your application should receive the `DevtoolsLogger` instance _instead_\nof any logger it would normally receive when deployed to a real environment, to avoid local development activity from\nmixing with real telemetry.\nIf you still want to provide a real application logger and use the Fluid Devtools features that are powered by telemetry\nat the same time, you can pass an existing logger to the `DevtoolsLogger` constructor and it will forward all telemetry\nit receives to that logger as well:\n\n```typescript\nimport { DevtoolsLogger } from \"@fluid-experimental/devtools-core\";\n\n// Your application's logger\nconst yourApplicationLogger = getInstanceOfYourApplicationLogger();\n\nconst devtoolsLogger = new DevtoolsLogger(yourApplicationLogger);\n\n// Pass devtoolsLogger to initializeDevtools() and to your application as described above\n```\n\n### Clean-up\n\nThe Devtools object is managed as a global singleton.\nThat singleton is automatically cleaned up prior to the Window's \"unload\" event.\nSo typical application flows likely won't need to worry about cleanup.\nThat said, if you wish to have tighter control over when the Devtools are torn down, you can simply call the `dispose` method on the handle returned by [initialization](#initialization).\n\n## Contributing to the package\n\n### Build\n\nTo build the package locally, first ensure you have run `pnpm install` from the root of the mono-repo.\nNext, to build the code, run `npm run build` from the root of the mono-repo, or use [fluid-build](https://github.com/microsoft/FluidFramework/tree/main/build-tools/packages/build-tools#running-fluid-build-command-line) via `fluid-build -t build`.\n\n- Note: Once you have run a build from the root, assuming no other changes outside of this package, you may run `npm run build` directly within this directory for a faster build.\n If you make changes to any of this package's local dependencies, you will need to run a build again from the root before building again from directly within this package.\n\n### Test\n\nTo run the tests, first ensure you have followed the [build](#build) steps above.\nNext, run `npm run test` from a terminal within this directory.\n\n\n\n\n\n\n\n## API Documentation\n\nAPI documentation for **@fluid-experimental/devtools-core** is available at .\n\n\n\n\n\n\n\n\n\n\n## Contribution Guidelines\n\nThere are many ways to [contribute](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md) to Fluid.\n\n- Participate in Q&A in our [GitHub Discussions](https://github.com/microsoft/FluidFramework/discussions).\n- [Submit bugs](https://github.com/microsoft/FluidFramework/issues) and help us verify fixes as they are checked in.\n- Review the [source code changes](https://github.com/microsoft/FluidFramework/pulls).\n- [Contribute bug fixes](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md).\n\nDetailed instructions for working in the repo can be found in the [Wiki](https://github.com/microsoft/FluidFramework/wiki).\n\nThis project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).\nFor more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\nUse of these trademarks or logos must follow Microsoft’s [Trademark & Brand Guidelines](https://www.microsoft.com/trademarks).\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n\n\n\n## Help\n\nNot finding what you're looking for in this README? Check out our [GitHub\nWiki](https://github.com/microsoft/FluidFramework/wiki) or [fluidframework.com](https://fluidframework.com/docs/).\n\nStill not finding what you're looking for? Please [file an\nissue](https://github.com/microsoft/FluidFramework/wiki/Submitting-Bugs-and-Feature-Requests).\n\nThank you!\n\n\n\n\n\n\n\n\n\n\n## Trademark\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\n\nUse of these trademarks or logos must follow Microsoft's [Trademark & Brand\nGuidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general).\n\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n[initialize-devtools-docs]: https://fluidframework.com/docs/apis/devtools-core#initializedevtools-function\n[devtools-logger-docs]: https://fluidframework.com/docs/apis/devtools-core/devtoolslogger-class\n[devtools-package]: https://www.npmjs.com/package/@fluid-experimental/devtools\n[browser-extension]: https://github.com/microsoft/FluidFramework/tree/main/packages/tools/devtools/devtools-browser-extension\n","scripts":{"tsc":"tsc","lint":"npm run prettier && npm run eslint","test":"npm run test:mocha","build":"fluid-build . --task build","clean":"rimraf --glob '_api-extractor-temp' 'nyc' 'dist' 'lib' '*.tsbuildinfo' '*.build.log'","eslint":"eslint src","format":"npm run prettier:fix","rebuild":"npm run clean && npm run build","lint:fix":"npm run prettier:fix && npm run eslint:fix","prettier":"prettier --check . --ignore-path ../../../../.prettierignore","tsc:watch":"tsc --watch","build:docs":"api-extractor run --local","eslint:fix":"eslint src --fix","test:mocha":"mocha dist/**/*.test.js --exit","build:esnext":"tsc --project ./tsconfig.esnext.json","build:genver":"gen-version","prettier:fix":"prettier --write . --ignore-path ../../../../.prettierignore","build:compile":"fluid-build . --task compile","ci:build:docs":"api-extractor run","test:coverage":"c8 npm test","typetests:gen":"fluid-type-test-generator","build:commonjs":"fluid-build . --task commonjs","format-and-build":"npm run format && npm run build","typetests:prepare":"flub typetests --dir . --reset --previous --normalize","format-and-compile":"npm run format && npm run build:compile"},"_npmUser":{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},"_resolved":"/mnt/vss/_work/1/pack/scoped/fluid-experimental-devtools-core-2.0.0-dev.7.2.0.203917.tgz","_integrity":"sha512-tN0fhlzCkk0fTwMd9Jlx07mnz6FvnF+XJX2URXjC4a91GswmARa65yyLbXdw47xGLl3EXs8ZfjPvl66YLPW0ew==","fluidBuild":{"tasks":{"tsc":["...","typetests:gen"]}},"repository":{"url":"git+https://github.com/microsoft/FluidFramework.git","type":"git","directory":"packages/tools/devtools/devtools-core"},"_npmVersion":"9.6.7","description":"Fluid Framework developer tools core functionality","directories":{},"sideEffects":false,"_nodeVersion":"18.17.1","dependencies":{"@fluidframework/map":"2.0.0-dev.7.2.0.203917","@fluidframework/cell":"2.0.0-dev.7.2.0.203917","@fluidframework/matrix":"2.0.0-dev.7.2.0.203917","@fluidframework/counter":"2.0.0-dev.7.2.0.203917","@fluidframework/sequence":"2.0.0-dev.7.2.0.203917","@fluid-experimental/tree2":"2.0.0-dev.7.2.0.203917","@fluid-internal/client-utils":"2.0.0-dev.7.2.0.203917","@fluidframework/core-interfaces":"2.0.0-dev.7.2.0.203917","@fluidframework/telemetry-utils":"2.0.0-dev.7.2.0.203917","@fluidframework/container-loader":"2.0.0-dev.7.2.0.203917","@fluidframework/shared-object-base":"2.0.0-dev.7.2.0.203917","@fluidframework/protocol-definitions":"^3.0.0","@fluidframework/container-definitions":"2.0.0-dev.7.2.0.203917","@fluidframework/datastore-definitions":"2.0.0-dev.7.2.0.203917"},"_hasShrinkwrap":false,"readmeFilename":"README.md","typeValidation":{"broken":{}},"devDependencies":{"c8":"^7.7.1","chai":"^4.2.0","mocha":"^10.2.0","eslint":"~8.50.0","events":"^3.1.0","moment":"^2.21.0","rimraf":"^4.4.0","prettier":"~3.0.3","cross-env":"^7.0.3","typescript":"~5.1.6","@types/chai":"^4.0.0","@types/mocha":"^9.1.1","@types/events":"^3.0.0","mocha-multi-reporters":"^1.5.1","@fluid-tools/build-cli":"0.26.0-203096","eslint-config-prettier":"~9.0.0","@microsoft/api-extractor":"^7.37.0","eslint-plugin-chai-expect":"~3.0.0","mocha-json-output-reporter":"^2.0.1","@fluidframework/build-tools":"0.26.0-203096","@fluidframework/build-common":"^2.0.2","@fluidframework/mocha-test-setup":"2.0.0-dev.7.2.0.203917","@fluidframework/driver-definitions":"2.0.0-dev.7.2.0.203917","@fluidframework/test-runtime-utils":"2.0.0-dev.7.2.0.203917","@fluidframework/eslint-config-fluid":"^3.0.0","@fluid-experimental/devtools-core-previous":"npm:@fluid-experimental/devtools-core@2.0.0-internal.7.1.0"},"_npmOperationalInternal":{"tmp":"tmp/devtools-core_2.0.0-dev.7.2.0.203917_1698100127595_0.14880202146520327","host":"s3://npm-registry-packages"}},"2.0.0-dev.7.2.0.204906":{"name":"@fluid-experimental/devtools-core","version":"2.0.0-dev.7.2.0.204906","author":{"name":"Microsoft and contributors"},"license":"MIT","_id":"@fluid-experimental/devtools-core@2.0.0-dev.7.2.0.204906","maintainers":[{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},{"name":"curtisman","email":"curtism@microsoft.com"}],"homepage":"https://fluidframework.com","bugs":{"url":"https://github.com/microsoft/FluidFramework/issues"},"c8":{"all":true,"exclude":["src/test/**/*.ts","dist/test/**/*.js"],"include":["src/**/*.ts","dist/**/*.js"],"reporter":["cobertura","html","text"],"cache-dir":"nyc/.cache","report-dir":"nyc/report","temp-directory":"nyc/.nyc_output","exclude-after-remap":false},"dist":{"shasum":"fe48f6e6a6e97f24e21028e41ac46adf85904d35","tarball":"https://registry.npmjs.org/@fluid-experimental/devtools-core/-/devtools-core-2.0.0-dev.7.2.0.204906.tgz","fileCount":505,"integrity":"sha512-iNa8KsbvbcIX7x0ogA45ko124gM9HcEO06qNB8ouM/MOML+CMrrRQDecipZAQpH4FC+rI1Td5oyJw2w0jRzxhQ==","signatures":[{"sig":"MEUCIFUIGUZDnMes/aSRovNGXMCgD7dXyV2qAB9r5ZSZXkniAiEAxHUvvF4BQ9ddXlrb4T/yOeuZBL3+ylbbCW6v4AdA4X8=","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}],"unpackedSize":1467715},"main":"dist/index.js","_from":"file:fluid-experimental-devtools-core-2.0.0-dev.7.2.0.204906.tgz","types":"dist/index.d.ts","module":"lib/index.js","readme":"# @fluid-experimental/devtools-core\n\nThis library contains developer tools for use alongside the Fluid Framework.\nIt is used to power our associated [browser extension][browser-extension].\n\n- Chrome: \n- Edge: \n\n\n\n\n\n\n## Installation\n\nTo get started, install the package by running the following command:\n\n```bash\nnpm i @fluid-experimental/devtools-core -D\n```\n\n\n\n\n\n## Usage\n\nThe Devtools' API surface is designed to fit nicely into most application flows.\n\n### Initialization\n\nTo initialize a devtools session for your container, call [`initializeDevtools`][initialize-devtools-docs].\nThis function accepts a `DevtoolsLogger` for receiving Fluid telemetry from your application, a list of initial Fluid\n`Containers` to associate with the session, and (optionally) customized data visualization configurations for visualizing\n`Container` data.\n\n#### About the [`DevtoolsLogger`][devtools-logger-docs]\n\nThe `DevtoolsLogger` is an optional piece when calling `initializeDevtools` but it is strongly recommended that you use\nit because several features in Fluid Devtools are powered by the telemetry that Fluid Framework generates, and this\nlogger is the way in which that telemetry gets into Fluid Devtools.\n\nYou can obtain a `DevtoolsLogger` by calling its constructor, and then should pass it to `initializeDevtools` _and_\nto the `Loader` instance you'll use to create/load Containers as shown below.\nThis way the logger will receive all the telemetry generated by Fluid Framework in your application, and forward it to\nFluid Devtools as necessary.\n\n```typescript\nimport { DevtoolsLogger, initializeDevtools } from \"@fluid-experimental/devtools-core\";\n\n// Instantiate the logger\nconst devtoolsLogger = new DevtoolsLogger();\n\n// Pass the logger when instantiating the Loader\nconst loader = new Loader({\n\tlogger: devtoolsLogger,\n\t// Other necessary properties ...\n});\n\n// Use the Loader to create (and optionally, attach) a Container\nconst container = await loader.createDetachedContainer(/* params */);\nawait container.attach(/* params */);\n\n// Initialize the Devtools passing the logger and your Container.\n// The Container could be added later as well with devtools.registerContainerDevtools().\nconst devtools = initializeDevtools({\n\tlogger: devtoolsLogger,\n\tinitialContainers: [\n\t\t{\n\t\t\tcontainer,\n\t\t\tcontainerKey: \"My Container\",\n\t\t},\n\t],\n});\n```\n\nIf you're working with `AzureClient` instead of lower-level APIs like the one described above, you probably want to\nrefer to the [@fluid-experimental/devtools package][devtools-package] instead of this one.\n\nDuring local development the recommendation is that your application should receive the `DevtoolsLogger` instance _instead_\nof any logger it would normally receive when deployed to a real environment, to avoid local development activity from\nmixing with real telemetry.\nIf you still want to provide a real application logger and use the Fluid Devtools features that are powered by telemetry\nat the same time, you can pass an existing logger to the `DevtoolsLogger` constructor and it will forward all telemetry\nit receives to that logger as well:\n\n```typescript\nimport { DevtoolsLogger } from \"@fluid-experimental/devtools-core\";\n\n// Your application's logger\nconst yourApplicationLogger = getInstanceOfYourApplicationLogger();\n\nconst devtoolsLogger = new DevtoolsLogger(yourApplicationLogger);\n\n// Pass devtoolsLogger to initializeDevtools() and to your application as described above\n```\n\n### Clean-up\n\nThe Devtools object is managed as a global singleton.\nThat singleton is automatically cleaned up prior to the Window's \"unload\" event.\nSo typical application flows likely won't need to worry about cleanup.\nThat said, if you wish to have tighter control over when the Devtools are torn down, you can simply call the `dispose` method on the handle returned by [initialization](#initialization).\n\n## Contributing to the package\n\n### Build\n\nTo build the package locally, first ensure you have run `pnpm install` from the root of the mono-repo.\nNext, to build the code, run `npm run build` from the root of the mono-repo, or use [fluid-build](https://github.com/microsoft/FluidFramework/tree/main/build-tools/packages/build-tools#running-fluid-build-command-line) via `fluid-build -t build`.\n\n- Note: Once you have run a build from the root, assuming no other changes outside of this package, you may run `npm run build` directly within this directory for a faster build.\n If you make changes to any of this package's local dependencies, you will need to run a build again from the root before building again from directly within this package.\n\n### Test\n\nTo run the tests, first ensure you have followed the [build](#build) steps above.\nNext, run `npm run test` from a terminal within this directory.\n\n\n\n\n\n\n\n## API Documentation\n\nAPI documentation for **@fluid-experimental/devtools-core** is available at .\n\n\n\n\n\n\n\n\n\n\n## Contribution Guidelines\n\nThere are many ways to [contribute](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md) to Fluid.\n\n- Participate in Q&A in our [GitHub Discussions](https://github.com/microsoft/FluidFramework/discussions).\n- [Submit bugs](https://github.com/microsoft/FluidFramework/issues) and help us verify fixes as they are checked in.\n- Review the [source code changes](https://github.com/microsoft/FluidFramework/pulls).\n- [Contribute bug fixes](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md).\n\nDetailed instructions for working in the repo can be found in the [Wiki](https://github.com/microsoft/FluidFramework/wiki).\n\nThis project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).\nFor more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\nUse of these trademarks or logos must follow Microsoft’s [Trademark & Brand Guidelines](https://www.microsoft.com/trademarks).\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n\n\n\n## Help\n\nNot finding what you're looking for in this README? Check out our [GitHub\nWiki](https://github.com/microsoft/FluidFramework/wiki) or [fluidframework.com](https://fluidframework.com/docs/).\n\nStill not finding what you're looking for? Please [file an\nissue](https://github.com/microsoft/FluidFramework/wiki/Submitting-Bugs-and-Feature-Requests).\n\nThank you!\n\n\n\n\n\n\n\n\n\n\n## Trademark\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\n\nUse of these trademarks or logos must follow Microsoft's [Trademark & Brand\nGuidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general).\n\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n[initialize-devtools-docs]: https://fluidframework.com/docs/apis/devtools-core#initializedevtools-function\n[devtools-logger-docs]: https://fluidframework.com/docs/apis/devtools-core/devtoolslogger-class\n[devtools-package]: https://www.npmjs.com/package/@fluid-experimental/devtools\n[browser-extension]: https://github.com/microsoft/FluidFramework/tree/main/packages/tools/devtools/devtools-browser-extension\n","scripts":{"tsc":"tsc","lint":"npm run prettier && npm run eslint","test":"npm run test:mocha","build":"fluid-build . --task build","clean":"rimraf --glob '_api-extractor-temp' 'nyc' 'dist' 'lib' '*.tsbuildinfo' '*.build.log'","eslint":"eslint src","format":"npm run prettier:fix","rebuild":"npm run clean && npm run build","lint:fix":"npm run prettier:fix && npm run eslint:fix","prettier":"prettier --check . --ignore-path ../../../../.prettierignore","tsc:watch":"tsc --watch","build:docs":"api-extractor run --local","eslint:fix":"eslint src --fix","test:mocha":"mocha dist/**/*.test.js --exit","build:esnext":"tsc --project ./tsconfig.esnext.json","build:genver":"gen-version","prettier:fix":"prettier --write . --ignore-path ../../../../.prettierignore","build:compile":"fluid-build . --task compile","ci:build:docs":"api-extractor run","test:coverage":"c8 npm test","typetests:gen":"fluid-type-test-generator","build:commonjs":"fluid-build . --task commonjs","format-and-build":"npm run format && npm run build","typetests:prepare":"flub typetests --dir . --reset --previous --normalize","format-and-compile":"npm run format && npm run build:compile"},"_npmUser":{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},"_resolved":"/mnt/vss/_work/1/pack/scoped/fluid-experimental-devtools-core-2.0.0-dev.7.2.0.204906.tgz","_integrity":"sha512-iNa8KsbvbcIX7x0ogA45ko124gM9HcEO06qNB8ouM/MOML+CMrrRQDecipZAQpH4FC+rI1Td5oyJw2w0jRzxhQ==","fluidBuild":{"tasks":{"tsc":["...","typetests:gen"]}},"repository":{"url":"git+https://github.com/microsoft/FluidFramework.git","type":"git","directory":"packages/tools/devtools/devtools-core"},"_npmVersion":"9.6.7","description":"Fluid Framework developer tools core functionality","directories":{},"sideEffects":false,"_nodeVersion":"18.17.1","dependencies":{"@fluidframework/map":"2.0.0-dev.7.2.0.204906","@fluidframework/cell":"2.0.0-dev.7.2.0.204906","@fluidframework/matrix":"2.0.0-dev.7.2.0.204906","@fluidframework/counter":"2.0.0-dev.7.2.0.204906","@fluidframework/sequence":"2.0.0-dev.7.2.0.204906","@fluid-experimental/tree2":"2.0.0-dev.7.2.0.204906","@fluid-internal/client-utils":"2.0.0-dev.7.2.0.204906","@fluidframework/core-interfaces":"2.0.0-dev.7.2.0.204906","@fluidframework/telemetry-utils":"2.0.0-dev.7.2.0.204906","@fluidframework/container-loader":"2.0.0-dev.7.2.0.204906","@fluidframework/shared-object-base":"2.0.0-dev.7.2.0.204906","@fluidframework/protocol-definitions":"^3.0.0","@fluidframework/container-definitions":"2.0.0-dev.7.2.0.204906","@fluidframework/datastore-definitions":"2.0.0-dev.7.2.0.204906"},"_hasShrinkwrap":false,"readmeFilename":"README.md","typeValidation":{"broken":{}},"devDependencies":{"c8":"^7.7.1","chai":"^4.2.0","mocha":"^10.2.0","eslint":"~8.50.0","events":"^3.1.0","moment":"^2.21.0","rimraf":"^4.4.0","prettier":"~3.0.3","cross-env":"^7.0.3","typescript":"~5.1.6","@types/chai":"^4.0.0","@types/mocha":"^9.1.1","@types/events":"^3.0.0","mocha-multi-reporters":"^1.5.1","@fluid-tools/build-cli":"0.26.0-203096","eslint-config-prettier":"~9.0.0","@microsoft/api-extractor":"^7.37.0","eslint-plugin-chai-expect":"~3.0.0","mocha-json-output-reporter":"^2.0.1","@fluidframework/build-tools":"0.26.0-203096","@fluidframework/build-common":"^2.0.2","@fluidframework/mocha-test-setup":"2.0.0-dev.7.2.0.204906","@fluidframework/driver-definitions":"2.0.0-dev.7.2.0.204906","@fluidframework/test-runtime-utils":"2.0.0-dev.7.2.0.204906","@fluidframework/eslint-config-fluid":"^3.0.0","@fluid-experimental/devtools-core-previous":"npm:@fluid-experimental/devtools-core@2.0.0-internal.7.1.0"},"_npmOperationalInternal":{"tmp":"tmp/devtools-core_2.0.0-dev.7.2.0.204906_1698254596757_0.7237837091168335","host":"s3://npm-registry-packages"}},"2.0.0-dev.7.2.0.205722":{"name":"@fluid-experimental/devtools-core","version":"2.0.0-dev.7.2.0.205722","author":{"name":"Microsoft and contributors"},"license":"MIT","_id":"@fluid-experimental/devtools-core@2.0.0-dev.7.2.0.205722","maintainers":[{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},{"name":"curtisman","email":"curtism@microsoft.com"}],"homepage":"https://fluidframework.com","bugs":{"url":"https://github.com/microsoft/FluidFramework/issues"},"c8":{"all":true,"exclude":["src/test/**/*.ts","dist/test/**/*.js"],"include":["src/**/*.ts","dist/**/*.js"],"reporter":["cobertura","html","text"],"cache-dir":"nyc/.cache","report-dir":"nyc/report","temp-directory":"nyc/.nyc_output","exclude-after-remap":false},"dist":{"shasum":"99b5dd14adced2c451f37b497f28b233e174693b","tarball":"https://registry.npmjs.org/@fluid-experimental/devtools-core/-/devtools-core-2.0.0-dev.7.2.0.205722.tgz","fileCount":505,"integrity":"sha512-yl3Nt5wY2SHeQ1ckRZuQi7sLIK4en/HZca/zAQ2JOeq6TurfpQvWar2/tSCqiuqv1B67axKWjZJjDxGlZGLEyQ==","signatures":[{"sig":"MEUCIBVVQ//89doP+BoLSaU/Pq9WMT4hzxIKm5MkNtLWyi8xAiEA7Dcbp94iHUTQpeFUqvnQElchqu+fd+iE9BQgMi40nZ8=","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}],"unpackedSize":1467699},"main":"dist/index.js","_from":"file:fluid-experimental-devtools-core-2.0.0-dev.7.2.0.205722.tgz","types":"dist/index.d.ts","module":"lib/index.js","readme":"# @fluid-experimental/devtools-core\n\nThis library contains developer tools for use alongside the Fluid Framework.\nIt is used to power our associated [browser extension][browser-extension].\n\n- Chrome: \n- Edge: \n\n\n\n\n\n\n## Installation\n\nTo get started, install the package by running the following command:\n\n```bash\nnpm i @fluid-experimental/devtools-core -D\n```\n\n\n\n\n\n## Usage\n\nThe Devtools' API surface is designed to fit nicely into most application flows.\n\n### Initialization\n\nTo initialize a devtools session for your container, call [`initializeDevtools`][initialize-devtools-docs].\nThis function accepts a `DevtoolsLogger` for receiving Fluid telemetry from your application, a list of initial Fluid\n`Containers` to associate with the session, and (optionally) customized data visualization configurations for visualizing\n`Container` data.\n\n#### About the [`DevtoolsLogger`][devtools-logger-docs]\n\nThe `DevtoolsLogger` is an optional piece when calling `initializeDevtools` but it is strongly recommended that you use\nit because several features in Fluid Devtools are powered by the telemetry that Fluid Framework generates, and this\nlogger is the way in which that telemetry gets into Fluid Devtools.\n\nYou can obtain a `DevtoolsLogger` by calling its constructor, and then should pass it to `initializeDevtools` _and_\nto the `Loader` instance you'll use to create/load Containers as shown below.\nThis way the logger will receive all the telemetry generated by Fluid Framework in your application, and forward it to\nFluid Devtools as necessary.\n\n```typescript\nimport { DevtoolsLogger, initializeDevtools } from \"@fluid-experimental/devtools-core\";\n\n// Instantiate the logger\nconst devtoolsLogger = new DevtoolsLogger();\n\n// Pass the logger when instantiating the Loader\nconst loader = new Loader({\n\tlogger: devtoolsLogger,\n\t// Other necessary properties ...\n});\n\n// Use the Loader to create (and optionally, attach) a Container\nconst container = await loader.createDetachedContainer(/* params */);\nawait container.attach(/* params */);\n\n// Initialize the Devtools passing the logger and your Container.\n// The Container could be added later as well with devtools.registerContainerDevtools().\nconst devtools = initializeDevtools({\n\tlogger: devtoolsLogger,\n\tinitialContainers: [\n\t\t{\n\t\t\tcontainer,\n\t\t\tcontainerKey: \"My Container\",\n\t\t},\n\t],\n});\n```\n\nIf you're working with `AzureClient` instead of lower-level APIs like the one described above, you probably want to\nrefer to the [@fluid-experimental/devtools package][devtools-package] instead of this one.\n\nDuring local development the recommendation is that your application should receive the `DevtoolsLogger` instance _instead_\nof any logger it would normally receive when deployed to a real environment, to avoid local development activity from\nmixing with real telemetry.\nIf you still want to provide a real application logger and use the Fluid Devtools features that are powered by telemetry\nat the same time, you can pass an existing logger to the `DevtoolsLogger` constructor and it will forward all telemetry\nit receives to that logger as well:\n\n```typescript\nimport { DevtoolsLogger } from \"@fluid-experimental/devtools-core\";\n\n// Your application's logger\nconst yourApplicationLogger = getInstanceOfYourApplicationLogger();\n\nconst devtoolsLogger = new DevtoolsLogger(yourApplicationLogger);\n\n// Pass devtoolsLogger to initializeDevtools() and to your application as described above\n```\n\n### Clean-up\n\nThe Devtools object is managed as a global singleton.\nThat singleton is automatically cleaned up prior to the Window's \"unload\" event.\nSo typical application flows likely won't need to worry about cleanup.\nThat said, if you wish to have tighter control over when the Devtools are torn down, you can simply call the `dispose` method on the handle returned by [initialization](#initialization).\n\n## Contributing to the package\n\n### Build\n\nTo build the package locally, first ensure you have run `pnpm install` from the root of the mono-repo.\nNext, to build the code, run `npm run build` from the root of the mono-repo, or use [fluid-build](https://github.com/microsoft/FluidFramework/tree/main/build-tools/packages/build-tools#running-fluid-build-command-line) via `fluid-build -t build`.\n\n- Note: Once you have run a build from the root, assuming no other changes outside of this package, you may run `npm run build` directly within this directory for a faster build.\n If you make changes to any of this package's local dependencies, you will need to run a build again from the root before building again from directly within this package.\n\n### Test\n\nTo run the tests, first ensure you have followed the [build](#build) steps above.\nNext, run `npm run test` from a terminal within this directory.\n\n\n\n\n\n\n\n## API Documentation\n\nAPI documentation for **@fluid-experimental/devtools-core** is available at .\n\n\n\n\n\n\n\n\n\n\n## Contribution Guidelines\n\nThere are many ways to [contribute](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md) to Fluid.\n\n- Participate in Q&A in our [GitHub Discussions](https://github.com/microsoft/FluidFramework/discussions).\n- [Submit bugs](https://github.com/microsoft/FluidFramework/issues) and help us verify fixes as they are checked in.\n- Review the [source code changes](https://github.com/microsoft/FluidFramework/pulls).\n- [Contribute bug fixes](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md).\n\nDetailed instructions for working in the repo can be found in the [Wiki](https://github.com/microsoft/FluidFramework/wiki).\n\nThis project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).\nFor more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\nUse of these trademarks or logos must follow Microsoft’s [Trademark & Brand Guidelines](https://www.microsoft.com/trademarks).\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n\n\n\n## Help\n\nNot finding what you're looking for in this README? Check out our [GitHub\nWiki](https://github.com/microsoft/FluidFramework/wiki) or [fluidframework.com](https://fluidframework.com/docs/).\n\nStill not finding what you're looking for? Please [file an\nissue](https://github.com/microsoft/FluidFramework/wiki/Submitting-Bugs-and-Feature-Requests).\n\nThank you!\n\n\n\n\n\n\n\n\n\n\n## Trademark\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\n\nUse of these trademarks or logos must follow Microsoft's [Trademark & Brand\nGuidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general).\n\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n[initialize-devtools-docs]: https://fluidframework.com/docs/apis/devtools-core#initializedevtools-function\n[devtools-logger-docs]: https://fluidframework.com/docs/apis/devtools-core/devtoolslogger-class\n[devtools-package]: https://www.npmjs.com/package/@fluid-experimental/devtools\n[browser-extension]: https://github.com/microsoft/FluidFramework/tree/main/packages/tools/devtools/devtools-browser-extension\n","scripts":{"tsc":"tsc","lint":"npm run prettier && npm run eslint","test":"npm run test:mocha","build":"fluid-build . --task build","clean":"rimraf --glob _api-extractor-temp nyc dist lib \"*.tsbuildinfo\" \"*.build.log\"","eslint":"eslint src","format":"npm run prettier:fix","rebuild":"npm run clean && npm run build","lint:fix":"npm run prettier:fix && npm run eslint:fix","prettier":"prettier --check . --ignore-path ../../../../.prettierignore","tsc:watch":"tsc --watch","build:docs":"api-extractor run --local","eslint:fix":"eslint src --fix","test:mocha":"mocha dist/**/*.test.js --exit","build:esnext":"tsc --project ./tsconfig.esnext.json","build:genver":"gen-version","prettier:fix":"prettier --write . --ignore-path ../../../../.prettierignore","build:compile":"fluid-build . --task compile","ci:build:docs":"api-extractor run","test:coverage":"c8 npm test","typetests:gen":"fluid-type-test-generator","build:commonjs":"fluid-build . --task commonjs","format-and-build":"npm run format && npm run build","typetests:prepare":"flub typetests --dir . --reset --previous --normalize","format-and-compile":"npm run format && npm run build:compile"},"_npmUser":{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},"_resolved":"/mnt/vss/_work/1/pack/scoped/fluid-experimental-devtools-core-2.0.0-dev.7.2.0.205722.tgz","_integrity":"sha512-yl3Nt5wY2SHeQ1ckRZuQi7sLIK4en/HZca/zAQ2JOeq6TurfpQvWar2/tSCqiuqv1B67axKWjZJjDxGlZGLEyQ==","fluidBuild":{"tasks":{"tsc":["...","typetests:gen"]}},"repository":{"url":"git+https://github.com/microsoft/FluidFramework.git","type":"git","directory":"packages/tools/devtools/devtools-core"},"_npmVersion":"9.6.7","description":"Fluid Framework developer tools core functionality","directories":{},"sideEffects":false,"_nodeVersion":"18.17.1","dependencies":{"@fluidframework/map":"2.0.0-dev.7.2.0.205722","@fluidframework/cell":"2.0.0-dev.7.2.0.205722","@fluidframework/matrix":"2.0.0-dev.7.2.0.205722","@fluidframework/counter":"2.0.0-dev.7.2.0.205722","@fluidframework/sequence":"2.0.0-dev.7.2.0.205722","@fluid-experimental/tree2":"2.0.0-dev.7.2.0.205722","@fluid-internal/client-utils":"2.0.0-dev.7.2.0.205722","@fluidframework/core-interfaces":"2.0.0-dev.7.2.0.205722","@fluidframework/telemetry-utils":"2.0.0-dev.7.2.0.205722","@fluidframework/container-loader":"2.0.0-dev.7.2.0.205722","@fluidframework/shared-object-base":"2.0.0-dev.7.2.0.205722","@fluidframework/protocol-definitions":"^3.0.0","@fluidframework/container-definitions":"2.0.0-dev.7.2.0.205722","@fluidframework/datastore-definitions":"2.0.0-dev.7.2.0.205722"},"_hasShrinkwrap":false,"readmeFilename":"README.md","typeValidation":{"broken":{}},"devDependencies":{"c8":"^7.7.1","chai":"^4.2.0","mocha":"^10.2.0","eslint":"~8.50.0","events":"^3.1.0","moment":"^2.21.0","rimraf":"^4.4.0","prettier":"~3.0.3","cross-env":"^7.0.3","typescript":"~5.1.6","@types/chai":"^4.0.0","@types/mocha":"^9.1.1","@types/events":"^3.0.0","mocha-multi-reporters":"^1.5.1","@fluid-tools/build-cli":"^0.26.1","eslint-config-prettier":"~9.0.0","@microsoft/api-extractor":"^7.37.0","eslint-plugin-chai-expect":"~3.0.0","mocha-json-output-reporter":"^2.0.1","@fluidframework/build-tools":"^0.26.1","@fluidframework/build-common":"^2.0.3","@fluidframework/mocha-test-setup":"2.0.0-dev.7.2.0.205722","@fluidframework/driver-definitions":"2.0.0-dev.7.2.0.205722","@fluidframework/test-runtime-utils":"2.0.0-dev.7.2.0.205722","@fluidframework/eslint-config-fluid":"^3.0.0","@fluid-experimental/devtools-core-previous":"npm:@fluid-experimental/devtools-core@2.0.0-internal.7.1.0"},"_npmOperationalInternal":{"tmp":"tmp/devtools-core_2.0.0-dev.7.2.0.205722_1698362132839_0.6104655443443163","host":"s3://npm-registry-packages"}},"2.0.0-internal.7.2.0":{"name":"@fluid-experimental/devtools-core","version":"2.0.0-internal.7.2.0","author":{"name":"Microsoft and contributors"},"license":"MIT","_id":"@fluid-experimental/devtools-core@2.0.0-internal.7.2.0","maintainers":[{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},{"name":"curtisman","email":"curtism@microsoft.com"}],"homepage":"https://fluidframework.com","bugs":{"url":"https://github.com/microsoft/FluidFramework/issues"},"c8":{"all":true,"exclude":["src/test/**/*.ts","dist/test/**/*.js"],"include":["src/**/*.ts","dist/**/*.js"],"reporter":["cobertura","html","text"],"cache-dir":"nyc/.cache","report-dir":"nyc/report","temp-directory":"nyc/.nyc_output","exclude-after-remap":false},"dist":{"shasum":"fde8a0d867ec48e9ff43757e05828473d4a2e8df","tarball":"https://registry.npmjs.org/@fluid-experimental/devtools-core/-/devtools-core-2.0.0-internal.7.2.0.tgz","fileCount":505,"integrity":"sha512-0wz1gieoidisI+AsEzMDlpVXKvwOR7SUBhilwu+QvCNybUy7tVKv/BBzStXSgq2Qu3IA2FEh5Y4NPLW/AU1JeQ==","signatures":[{"sig":"MEUCIHueghbrEX/pGavY3SFcS8zgq6GhUBx7XV0Wz2YZUYvPAiEAg96TBV3n7YpVa1i/NxUqtnEfVOEpvBSM5Y09MctQklA=","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}],"unpackedSize":1468086},"main":"dist/index.js","_from":"file:fluid-experimental-devtools-core-2.0.0-internal.7.2.0.tgz","types":"dist/index.d.ts","module":"lib/index.js","readme":"# @fluid-experimental/devtools-core\n\nThis library contains developer tools for use alongside the Fluid Framework.\nIt is used to power our associated [browser extension][browser-extension].\n\n- Chrome: \n- Edge: \n\n\n\n\n\n\n## Installation\n\nTo get started, install the package by running the following command:\n\n```bash\nnpm i @fluid-experimental/devtools-core -D\n```\n\n\n\n\n\n## Usage\n\nThe Devtools' API surface is designed to fit nicely into most application flows.\n\n### Initialization\n\nTo initialize a devtools session for your container, call [`initializeDevtools`][initialize-devtools-docs].\nThis function accepts a `DevtoolsLogger` for receiving Fluid telemetry from your application, a list of initial Fluid\n`Containers` to associate with the session, and (optionally) customized data visualization configurations for visualizing\n`Container` data.\n\n#### About the [`DevtoolsLogger`][devtools-logger-docs]\n\nThe `DevtoolsLogger` is an optional piece when calling `initializeDevtools` but it is strongly recommended that you use\nit because several features in Fluid Devtools are powered by the telemetry that Fluid Framework generates, and this\nlogger is the way in which that telemetry gets into Fluid Devtools.\n\nYou can obtain a `DevtoolsLogger` by calling its constructor, and then should pass it to `initializeDevtools` _and_\nto the `Loader` instance you'll use to create/load Containers as shown below.\nThis way the logger will receive all the telemetry generated by Fluid Framework in your application, and forward it to\nFluid Devtools as necessary.\n\n```typescript\nimport { DevtoolsLogger, initializeDevtools } from \"@fluid-experimental/devtools-core\";\n\n// Instantiate the logger\nconst devtoolsLogger = new DevtoolsLogger();\n\n// Pass the logger when instantiating the Loader\nconst loader = new Loader({\n\tlogger: devtoolsLogger,\n\t// Other necessary properties ...\n});\n\n// Use the Loader to create (and optionally, attach) a Container\nconst container = await loader.createDetachedContainer(/* params */);\nawait container.attach(/* params */);\n\n// Initialize the Devtools passing the logger and your Container.\n// The Container could be added later as well with devtools.registerContainerDevtools().\nconst devtools = initializeDevtools({\n\tlogger: devtoolsLogger,\n\tinitialContainers: [\n\t\t{\n\t\t\tcontainer,\n\t\t\tcontainerKey: \"My Container\",\n\t\t},\n\t],\n});\n```\n\nIf you're working with `AzureClient` instead of lower-level APIs like the one described above, you probably want to\nrefer to the [@fluid-experimental/devtools package][devtools-package] instead of this one.\n\nDuring local development the recommendation is that your application should receive the `DevtoolsLogger` instance _instead_\nof any logger it would normally receive when deployed to a real environment, to avoid local development activity from\nmixing with real telemetry.\nIf you still want to provide a real application logger and use the Fluid Devtools features that are powered by telemetry\nat the same time, you can pass an existing logger to the `DevtoolsLogger` constructor and it will forward all telemetry\nit receives to that logger as well:\n\n```typescript\nimport { DevtoolsLogger } from \"@fluid-experimental/devtools-core\";\n\n// Your application's logger\nconst yourApplicationLogger = getInstanceOfYourApplicationLogger();\n\nconst devtoolsLogger = new DevtoolsLogger(yourApplicationLogger);\n\n// Pass devtoolsLogger to initializeDevtools() and to your application as described above\n```\n\n### Clean-up\n\nThe Devtools object is managed as a global singleton.\nThat singleton is automatically cleaned up prior to the Window's \"unload\" event.\nSo typical application flows likely won't need to worry about cleanup.\nThat said, if you wish to have tighter control over when the Devtools are torn down, you can simply call the `dispose` method on the handle returned by [initialization](#initialization).\n\n## Contributing to the package\n\n### Build\n\nTo build the package locally, first ensure you have run `pnpm install` from the root of the mono-repo.\nNext, to build the code, run `npm run build` from the root of the mono-repo, or use [fluid-build](https://github.com/microsoft/FluidFramework/tree/main/build-tools/packages/build-tools#running-fluid-build-command-line) via `fluid-build -t build`.\n\n- Note: Once you have run a build from the root, assuming no other changes outside of this package, you may run `npm run build` directly within this directory for a faster build.\n If you make changes to any of this package's local dependencies, you will need to run a build again from the root before building again from directly within this package.\n\n### Test\n\nTo run the tests, first ensure you have followed the [build](#build) steps above.\nNext, run `npm run test` from a terminal within this directory.\n\n\n\n\n\n\n\n## API Documentation\n\nAPI documentation for **@fluid-experimental/devtools-core** is available at .\n\n\n\n\n\n\n\n\n\n\n## Contribution Guidelines\n\nThere are many ways to [contribute](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md) to Fluid.\n\n- Participate in Q&A in our [GitHub Discussions](https://github.com/microsoft/FluidFramework/discussions).\n- [Submit bugs](https://github.com/microsoft/FluidFramework/issues) and help us verify fixes as they are checked in.\n- Review the [source code changes](https://github.com/microsoft/FluidFramework/pulls).\n- [Contribute bug fixes](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md).\n\nDetailed instructions for working in the repo can be found in the [Wiki](https://github.com/microsoft/FluidFramework/wiki).\n\nThis project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).\nFor more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\nUse of these trademarks or logos must follow Microsoft’s [Trademark & Brand Guidelines](https://www.microsoft.com/trademarks).\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n\n\n\n## Help\n\nNot finding what you're looking for in this README? Check out our [GitHub\nWiki](https://github.com/microsoft/FluidFramework/wiki) or [fluidframework.com](https://fluidframework.com/docs/).\n\nStill not finding what you're looking for? Please [file an\nissue](https://github.com/microsoft/FluidFramework/wiki/Submitting-Bugs-and-Feature-Requests).\n\nThank you!\n\n\n\n\n\n\n\n\n\n\n## Trademark\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\n\nUse of these trademarks or logos must follow Microsoft's [Trademark & Brand\nGuidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general).\n\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n[initialize-devtools-docs]: https://fluidframework.com/docs/apis/devtools-core#initializedevtools-function\n[devtools-logger-docs]: https://fluidframework.com/docs/apis/devtools-core/devtoolslogger-class\n[devtools-package]: https://www.npmjs.com/package/@fluid-experimental/devtools\n[browser-extension]: https://github.com/microsoft/FluidFramework/tree/main/packages/tools/devtools/devtools-browser-extension\n","scripts":{"tsc":"tsc","lint":"npm run prettier && npm run eslint","test":"npm run test:mocha","build":"fluid-build . --task build","clean":"rimraf --glob _api-extractor-temp nyc dist lib \"*.tsbuildinfo\" \"*.build.log\"","eslint":"eslint src","format":"npm run prettier:fix","rebuild":"npm run clean && npm run build","lint:fix":"npm run prettier:fix && npm run eslint:fix","prettier":"prettier --check . --ignore-path ../../../../.prettierignore","tsc:watch":"tsc --watch","build:docs":"api-extractor run --local","eslint:fix":"eslint src --fix","test:mocha":"mocha dist/**/*.test.js --exit","build:esnext":"tsc --project ./tsconfig.esnext.json","build:genver":"gen-version","prettier:fix":"prettier --write . --ignore-path ../../../../.prettierignore","build:compile":"fluid-build . --task compile","ci:build:docs":"api-extractor run","test:coverage":"c8 npm test","typetests:gen":"fluid-type-test-generator","build:commonjs":"fluid-build . --task commonjs","format-and-build":"npm run format && npm run build","typetests:prepare":"flub typetests --dir . --reset --previous --normalize","format-and-compile":"npm run format && npm run build:compile"},"_npmUser":{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},"_resolved":"/mnt/vss/_work/1/pack/scoped/fluid-experimental-devtools-core-2.0.0-internal.7.2.0.tgz","_integrity":"sha512-0wz1gieoidisI+AsEzMDlpVXKvwOR7SUBhilwu+QvCNybUy7tVKv/BBzStXSgq2Qu3IA2FEh5Y4NPLW/AU1JeQ==","fluidBuild":{"tasks":{"tsc":["...","typetests:gen"]}},"repository":{"url":"git+https://github.com/microsoft/FluidFramework.git","type":"git","directory":"packages/tools/devtools/devtools-core"},"_npmVersion":"9.6.7","description":"Fluid Framework developer tools core functionality","directories":{},"sideEffects":false,"_nodeVersion":"18.17.1","dependencies":{"@fluidframework/map":">=2.0.0-internal.7.2.0 <2.0.0-internal.7.3.0","@fluidframework/cell":">=2.0.0-internal.7.2.0 <2.0.0-internal.7.3.0","@fluidframework/matrix":">=2.0.0-internal.7.2.0 <2.0.0-internal.7.3.0","@fluidframework/counter":">=2.0.0-internal.7.2.0 <2.0.0-internal.7.3.0","@fluidframework/sequence":">=2.0.0-internal.7.2.0 <2.0.0-internal.7.3.0","@fluid-experimental/tree2":">=2.0.0-internal.7.2.0 <2.0.0-internal.7.3.0","@fluid-internal/client-utils":">=2.0.0-internal.7.2.0 <2.0.0-internal.7.3.0","@fluidframework/core-interfaces":">=2.0.0-internal.7.2.0 <2.0.0-internal.7.3.0","@fluidframework/telemetry-utils":">=2.0.0-internal.7.2.0 <2.0.0-internal.7.3.0","@fluidframework/container-loader":">=2.0.0-internal.7.2.0 <2.0.0-internal.7.3.0","@fluidframework/shared-object-base":">=2.0.0-internal.7.2.0 <2.0.0-internal.7.3.0","@fluidframework/protocol-definitions":"^3.0.0","@fluidframework/container-definitions":">=2.0.0-internal.7.2.0 <2.0.0-internal.7.3.0","@fluidframework/datastore-definitions":">=2.0.0-internal.7.2.0 <2.0.0-internal.7.3.0"},"_hasShrinkwrap":false,"readmeFilename":"README.md","typeValidation":{"broken":{}},"devDependencies":{"c8":"^7.7.1","chai":"^4.2.0","mocha":"^10.2.0","eslint":"~8.50.0","events":"^3.1.0","moment":"^2.21.0","rimraf":"^4.4.0","prettier":"~3.0.3","cross-env":"^7.0.3","typescript":"~5.1.6","@types/chai":"^4.0.0","@types/mocha":"^9.1.1","@types/events":"^3.0.0","mocha-multi-reporters":"^1.5.1","@fluid-tools/build-cli":"^0.26.1","eslint-config-prettier":"~9.0.0","@microsoft/api-extractor":"^7.37.0","eslint-plugin-chai-expect":"~3.0.0","mocha-json-output-reporter":"^2.0.1","@fluidframework/build-tools":"^0.26.1","@fluidframework/build-common":"^2.0.3","@fluidframework/mocha-test-setup":">=2.0.0-internal.7.2.0 <2.0.0-internal.7.3.0","@fluidframework/driver-definitions":">=2.0.0-internal.7.2.0 <2.0.0-internal.7.3.0","@fluidframework/test-runtime-utils":">=2.0.0-internal.7.2.0 <2.0.0-internal.7.3.0","@fluidframework/eslint-config-fluid":"^3.0.0","@fluid-experimental/devtools-core-previous":"npm:@fluid-experimental/devtools-core@2.0.0-internal.7.1.0"},"_npmOperationalInternal":{"tmp":"tmp/devtools-core_2.0.0-internal.7.2.0_1698369584930_0.31523854397109097","host":"s3://npm-registry-packages"}},"2.0.0-internal.7.2.1":{"name":"@fluid-experimental/devtools-core","version":"2.0.0-internal.7.2.1","author":{"name":"Microsoft and contributors"},"license":"MIT","_id":"@fluid-experimental/devtools-core@2.0.0-internal.7.2.1","maintainers":[{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},{"name":"curtisman","email":"curtism@microsoft.com"}],"homepage":"https://fluidframework.com","bugs":{"url":"https://github.com/microsoft/FluidFramework/issues"},"c8":{"all":true,"exclude":["src/test/**/*.ts","dist/test/**/*.js"],"include":["src/**/*.ts","dist/**/*.js"],"reporter":["cobertura","html","text"],"cache-dir":"nyc/.cache","report-dir":"nyc/report","temp-directory":"nyc/.nyc_output","exclude-after-remap":false},"dist":{"shasum":"85dab04aab6eae37cc8456fded77e5f2c2587930","tarball":"https://registry.npmjs.org/@fluid-experimental/devtools-core/-/devtools-core-2.0.0-internal.7.2.1.tgz","fileCount":505,"integrity":"sha512-8QBHdOIliquGUF+d2Ts2bFlfBiIY66BQXdZZOc40FP1Ty/xPwsQ5VqKa8mtHByP7icrIfeI4PDpzTj+X55pCNA==","signatures":[{"sig":"MEUCIGCcfDegNSSOV/x3GYQEoOvEAM087iqMAHqFUJetDdOnAiEAhVOfjOXrklmfGjgpNodlWzPa0pWBifNrfj1c8/LQxfI=","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}],"unpackedSize":1468086},"main":"dist/index.js","_from":"file:fluid-experimental-devtools-core-2.0.0-internal.7.2.1.tgz","types":"dist/index.d.ts","module":"lib/index.js","readme":"# @fluid-experimental/devtools-core\n\nThis library contains developer tools for use alongside the Fluid Framework.\nIt is used to power our associated [browser extension][browser-extension].\n\n- Chrome: \n- Edge: \n\n\n\n\n\n\n## Installation\n\nTo get started, install the package by running the following command:\n\n```bash\nnpm i @fluid-experimental/devtools-core -D\n```\n\n\n\n\n\n## Usage\n\nThe Devtools' API surface is designed to fit nicely into most application flows.\n\n### Initialization\n\nTo initialize a devtools session for your container, call [`initializeDevtools`][initialize-devtools-docs].\nThis function accepts a `DevtoolsLogger` for receiving Fluid telemetry from your application, a list of initial Fluid\n`Containers` to associate with the session, and (optionally) customized data visualization configurations for visualizing\n`Container` data.\n\n#### About the [`DevtoolsLogger`][devtools-logger-docs]\n\nThe `DevtoolsLogger` is an optional piece when calling `initializeDevtools` but it is strongly recommended that you use\nit because several features in Fluid Devtools are powered by the telemetry that Fluid Framework generates, and this\nlogger is the way in which that telemetry gets into Fluid Devtools.\n\nYou can obtain a `DevtoolsLogger` by calling its constructor, and then should pass it to `initializeDevtools` _and_\nto the `Loader` instance you'll use to create/load Containers as shown below.\nThis way the logger will receive all the telemetry generated by Fluid Framework in your application, and forward it to\nFluid Devtools as necessary.\n\n```typescript\nimport { DevtoolsLogger, initializeDevtools } from \"@fluid-experimental/devtools-core\";\n\n// Instantiate the logger\nconst devtoolsLogger = new DevtoolsLogger();\n\n// Pass the logger when instantiating the Loader\nconst loader = new Loader({\n\tlogger: devtoolsLogger,\n\t// Other necessary properties ...\n});\n\n// Use the Loader to create (and optionally, attach) a Container\nconst container = await loader.createDetachedContainer(/* params */);\nawait container.attach(/* params */);\n\n// Initialize the Devtools passing the logger and your Container.\n// The Container could be added later as well with devtools.registerContainerDevtools().\nconst devtools = initializeDevtools({\n\tlogger: devtoolsLogger,\n\tinitialContainers: [\n\t\t{\n\t\t\tcontainer,\n\t\t\tcontainerKey: \"My Container\",\n\t\t},\n\t],\n});\n```\n\nIf you're working with `AzureClient` instead of lower-level APIs like the one described above, you probably want to\nrefer to the [@fluid-experimental/devtools package][devtools-package] instead of this one.\n\nDuring local development the recommendation is that your application should receive the `DevtoolsLogger` instance _instead_\nof any logger it would normally receive when deployed to a real environment, to avoid local development activity from\nmixing with real telemetry.\nIf you still want to provide a real application logger and use the Fluid Devtools features that are powered by telemetry\nat the same time, you can pass an existing logger to the `DevtoolsLogger` constructor and it will forward all telemetry\nit receives to that logger as well:\n\n```typescript\nimport { DevtoolsLogger } from \"@fluid-experimental/devtools-core\";\n\n// Your application's logger\nconst yourApplicationLogger = getInstanceOfYourApplicationLogger();\n\nconst devtoolsLogger = new DevtoolsLogger(yourApplicationLogger);\n\n// Pass devtoolsLogger to initializeDevtools() and to your application as described above\n```\n\n### Clean-up\n\nThe Devtools object is managed as a global singleton.\nThat singleton is automatically cleaned up prior to the Window's \"unload\" event.\nSo typical application flows likely won't need to worry about cleanup.\nThat said, if you wish to have tighter control over when the Devtools are torn down, you can simply call the `dispose` method on the handle returned by [initialization](#initialization).\n\n## Contributing to the package\n\n### Build\n\nTo build the package locally, first ensure you have run `pnpm install` from the root of the mono-repo.\nNext, to build the code, run `npm run build` from the root of the mono-repo, or use [fluid-build](https://github.com/microsoft/FluidFramework/tree/main/build-tools/packages/build-tools#running-fluid-build-command-line) via `fluid-build -t build`.\n\n- Note: Once you have run a build from the root, assuming no other changes outside of this package, you may run `npm run build` directly within this directory for a faster build.\n If you make changes to any of this package's local dependencies, you will need to run a build again from the root before building again from directly within this package.\n\n### Test\n\nTo run the tests, first ensure you have followed the [build](#build) steps above.\nNext, run `npm run test` from a terminal within this directory.\n\n\n\n\n\n\n\n## API Documentation\n\nAPI documentation for **@fluid-experimental/devtools-core** is available at .\n\n\n\n\n\n\n\n\n\n\n## Contribution Guidelines\n\nThere are many ways to [contribute](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md) to Fluid.\n\n- Participate in Q&A in our [GitHub Discussions](https://github.com/microsoft/FluidFramework/discussions).\n- [Submit bugs](https://github.com/microsoft/FluidFramework/issues) and help us verify fixes as they are checked in.\n- Review the [source code changes](https://github.com/microsoft/FluidFramework/pulls).\n- [Contribute bug fixes](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md).\n\nDetailed instructions for working in the repo can be found in the [Wiki](https://github.com/microsoft/FluidFramework/wiki).\n\nThis project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).\nFor more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\nUse of these trademarks or logos must follow Microsoft’s [Trademark & Brand Guidelines](https://www.microsoft.com/trademarks).\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n\n\n\n## Help\n\nNot finding what you're looking for in this README? Check out our [GitHub\nWiki](https://github.com/microsoft/FluidFramework/wiki) or [fluidframework.com](https://fluidframework.com/docs/).\n\nStill not finding what you're looking for? Please [file an\nissue](https://github.com/microsoft/FluidFramework/wiki/Submitting-Bugs-and-Feature-Requests).\n\nThank you!\n\n\n\n\n\n\n\n\n\n\n## Trademark\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\n\nUse of these trademarks or logos must follow Microsoft's [Trademark & Brand\nGuidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general).\n\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n[initialize-devtools-docs]: https://fluidframework.com/docs/apis/devtools-core#initializedevtools-function\n[devtools-logger-docs]: https://fluidframework.com/docs/apis/devtools-core/devtoolslogger-class\n[devtools-package]: https://www.npmjs.com/package/@fluid-experimental/devtools\n[browser-extension]: https://github.com/microsoft/FluidFramework/tree/main/packages/tools/devtools/devtools-browser-extension\n","scripts":{"tsc":"tsc","lint":"npm run prettier && npm run eslint","test":"npm run test:mocha","build":"fluid-build . --task build","clean":"rimraf --glob _api-extractor-temp nyc dist lib \"*.tsbuildinfo\" \"*.build.log\"","eslint":"eslint src","format":"npm run prettier:fix","rebuild":"npm run clean && npm run build","lint:fix":"npm run prettier:fix && npm run eslint:fix","prettier":"prettier --check . --ignore-path ../../../../.prettierignore","tsc:watch":"tsc --watch","build:docs":"api-extractor run --local","eslint:fix":"eslint src --fix","test:mocha":"mocha dist/**/*.test.js --exit","build:esnext":"tsc --project ./tsconfig.esnext.json","build:genver":"gen-version","prettier:fix":"prettier --write . --ignore-path ../../../../.prettierignore","build:compile":"fluid-build . --task compile","ci:build:docs":"api-extractor run","test:coverage":"c8 npm test","typetests:gen":"fluid-type-test-generator","build:commonjs":"fluid-build . --task commonjs","format-and-build":"npm run format && npm run build","typetests:prepare":"flub typetests --dir . --reset --previous --normalize","format-and-compile":"npm run format && npm run build:compile"},"_npmUser":{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},"_resolved":"/mnt/vss/_work/1/pack/scoped/fluid-experimental-devtools-core-2.0.0-internal.7.2.1.tgz","_integrity":"sha512-8QBHdOIliquGUF+d2Ts2bFlfBiIY66BQXdZZOc40FP1Ty/xPwsQ5VqKa8mtHByP7icrIfeI4PDpzTj+X55pCNA==","fluidBuild":{"tasks":{"tsc":["...","typetests:gen"]}},"repository":{"url":"git+https://github.com/microsoft/FluidFramework.git","type":"git","directory":"packages/tools/devtools/devtools-core"},"_npmVersion":"9.6.7","description":"Fluid Framework developer tools core functionality","directories":{},"sideEffects":false,"_nodeVersion":"18.17.1","dependencies":{"@fluidframework/map":">=2.0.0-internal.7.2.1 <2.0.0-internal.7.3.0","@fluidframework/cell":">=2.0.0-internal.7.2.1 <2.0.0-internal.7.3.0","@fluidframework/matrix":">=2.0.0-internal.7.2.1 <2.0.0-internal.7.3.0","@fluidframework/counter":">=2.0.0-internal.7.2.1 <2.0.0-internal.7.3.0","@fluidframework/sequence":">=2.0.0-internal.7.2.1 <2.0.0-internal.7.3.0","@fluid-experimental/tree2":">=2.0.0-internal.7.2.1 <2.0.0-internal.7.3.0","@fluid-internal/client-utils":">=2.0.0-internal.7.2.1 <2.0.0-internal.7.3.0","@fluidframework/core-interfaces":">=2.0.0-internal.7.2.1 <2.0.0-internal.7.3.0","@fluidframework/telemetry-utils":">=2.0.0-internal.7.2.1 <2.0.0-internal.7.3.0","@fluidframework/container-loader":">=2.0.0-internal.7.2.1 <2.0.0-internal.7.3.0","@fluidframework/shared-object-base":">=2.0.0-internal.7.2.1 <2.0.0-internal.7.3.0","@fluidframework/protocol-definitions":"^3.0.0","@fluidframework/container-definitions":">=2.0.0-internal.7.2.1 <2.0.0-internal.7.3.0","@fluidframework/datastore-definitions":">=2.0.0-internal.7.2.1 <2.0.0-internal.7.3.0"},"_hasShrinkwrap":false,"readmeFilename":"README.md","typeValidation":{"broken":{}},"devDependencies":{"c8":"^7.7.1","chai":"^4.2.0","mocha":"^10.2.0","eslint":"~8.50.0","events":"^3.1.0","moment":"^2.21.0","rimraf":"^4.4.0","prettier":"~3.0.3","cross-env":"^7.0.3","typescript":"~5.1.6","@types/chai":"^4.0.0","@types/mocha":"^9.1.1","@types/events":"^3.0.0","mocha-multi-reporters":"^1.5.1","@fluid-tools/build-cli":"^0.26.1","eslint-config-prettier":"~9.0.0","@microsoft/api-extractor":"^7.37.0","eslint-plugin-chai-expect":"~3.0.0","mocha-json-output-reporter":"^2.0.1","@fluidframework/build-tools":"^0.26.1","@fluidframework/build-common":"^2.0.3","@fluidframework/mocha-test-setup":">=2.0.0-internal.7.2.1 <2.0.0-internal.7.3.0","@fluidframework/driver-definitions":">=2.0.0-internal.7.2.1 <2.0.0-internal.7.3.0","@fluidframework/test-runtime-utils":">=2.0.0-internal.7.2.1 <2.0.0-internal.7.3.0","@fluidframework/eslint-config-fluid":"^3.0.0","@fluid-experimental/devtools-core-previous":"npm:@fluid-experimental/devtools-core@2.0.0-internal.7.1.0"},"_npmOperationalInternal":{"tmp":"tmp/devtools-core_2.0.0-internal.7.2.1_1698452885669_0.12772986661780905","host":"s3://npm-registry-packages"}},"2.0.0-internal.7.0.1":{"name":"@fluid-experimental/devtools-core","version":"2.0.0-internal.7.0.1","author":{"name":"Microsoft and contributors"},"license":"MIT","_id":"@fluid-experimental/devtools-core@2.0.0-internal.7.0.1","maintainers":[{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},{"name":"curtisman","email":"curtism@microsoft.com"}],"homepage":"https://fluidframework.com","bugs":{"url":"https://github.com/microsoft/FluidFramework/issues"},"c8":{"all":true,"exclude":["src/test/**/*.ts","dist/test/**/*.js"],"include":["src/**/*.ts","dist/**/*.js"],"reporter":["cobertura","html","text"],"cache-dir":"nyc/.cache","report-dir":"nyc/report","temp-directory":"nyc/.nyc_output","exclude-after-remap":false},"dist":{"shasum":"7cb230708699396134ac716443926d7cad16cda4","tarball":"https://registry.npmjs.org/@fluid-experimental/devtools-core/-/devtools-core-2.0.0-internal.7.0.1.tgz","fileCount":501,"integrity":"sha512-QQbSHRvtaMQmXxMucDAuJOEMdidkzTtX/TXYPRQPUyV+94fil7aApKEItl6dYxsRxjI46nVXNUYNYKnUQR0K4w==","signatures":[{"sig":"MEUCICKPuNlMx63cJMYuocgQ3kwJ4/lGD8lRxoR7OKY8iZ84AiEAgETfexovTGJ9Zx8zp/LRtDlvuTjqS/YlpkPQSMlgy+k=","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}],"unpackedSize":1378772},"main":"dist/index.js","_from":"file:fluid-experimental-devtools-core-2.0.0-internal.7.0.1.tgz","types":"dist/index.d.ts","module":"lib/index.js","readme":"# @fluid-experimental/devtools-core\n\nThis library contains developer tools for use alongside the Fluid Framework.\nIt is used to power our associated [browser extension][browser-extension].\n\n- Chrome: \n- Edge: \n\n\n\n\n\n\n## Installation\n\nTo get started, install the package by running the following command:\n\n```bash\nnpm i @fluid-experimental/devtools-core -D\n```\n\n\n\n\n\n## Usage\n\nThe Devtools' API surface is designed to fit nicely into most application flows.\n\n### Initialization\n\nTo initialize a devtools session for your container, call [`initializeDevtools`][initialize-devtools-docs].\nThis function accepts a `DevtoolsLogger` for receiving Fluid telemetry from your application, a list of initial Fluid\n`Containers` to associate with the session, and (optionally) customized data visualization configurations for visualizing\n`Container` data.\n\n#### About the [`DevtoolsLogger`][devtools-logger-docs]\n\nThe `DevtoolsLogger` is an optional piece when calling `initializeDevtools` but it is strongly recommended that you use\nit because several features in Fluid Devtools are powered by the telemetry that Fluid Framework generates, and this\nlogger is the way in which that telemetry gets into Fluid Devtools.\n\nYou can obtain a `DevtoolsLogger` by calling its constructor, and then should pass it to `initializeDevtools` _and_\nto the `Loader` instance you'll use to create/load Containers as shown below.\nThis way the logger will receive all the telemetry generated by Fluid Framework in your application, and forward it to\nFluid Devtools as necessary.\n\n```typescript\nimport { DevtoolsLogger, initializeDevtools } from \"@fluid-experimental/devtools-core\";\n\n// Instantiate the logger\nconst devtoolsLogger = new DevtoolsLogger();\n\n// Pass the logger when instantiating the Loader\nconst loader = new Loader({\n\tlogger: devtoolsLogger,\n\t// Other necessary properties ...\n});\n\n// Use the Loader to create (and optionally, attach) a Container\nconst container = await loader.createDetachedContainer(/* params */);\nawait container.attach(/* params */);\n\n// Initialize the Devtools passing the logger and your Container.\n// The Container could be added later as well with devtools.registerContainerDevtools().\nconst devtools = initializeDevtools({\n\tlogger: devtoolsLogger,\n\tinitialContainers: [\n\t\t{\n\t\t\tcontainer,\n\t\t\tcontainerKey: \"My Container\",\n\t\t},\n\t],\n});\n```\n\nIf you're working with `AzureClient` instead of lower-level APIs like the one described above, you probably want to\nrefer to the [@fluid-experimental/devtools package][devtools-package] instead of this one.\n\nDuring local development the recommendation is that your application should receive the `DevtoolsLogger` instance _instead_\nof any logger it would normally receive when deployed to a real environment, to avoid local development activity from\nmixing with real telemetry.\nIf you still want to provide a real application logger and use the Fluid Devtools features that are powered by telemetry\nat the same time, you can pass an existing logger to the `DevtoolsLogger` constructor and it will forward all telemetry\nit receives to that logger as well:\n\n```typescript\nimport { DevtoolsLogger } from \"@fluid-experimental/devtools-core\";\n\n// Your application's logger\nconst yourApplicationLogger = getInstanceOfYourApplicationLogger();\n\nconst devtoolsLogger = new DevtoolsLogger(yourApplicationLogger);\n\n// Pass devtoolsLogger to initializeDevtools() and to your application as described above\n```\n\n### Clean-up\n\nThe Devtools object is managed as a global singleton.\nThat singleton is automatically cleaned up prior to the Window's \"unload\" event.\nSo typical application flows likely won't need to worry about cleanup.\nThat said, if you wish to have tighter control over when the Devtools are torn down, you can simply call the `dispose` method on the handle returned by [initialization](#initialization).\n\n## Contributing to the package\n\n### Build\n\nTo build the package locally, first ensure you have run `pnpm install` from the root of the mono-repo.\nNext, to build the code, run `npm run build` from the root of the mono-repo, or use [fluid-build](https://github.com/microsoft/FluidFramework/tree/main/build-tools/packages/build-tools#running-fluid-build-command-line) via `fluid-build -t build`.\n\n- Note: Once you have run a build from the root, assuming no other changes outside of this package, you may run `npm run build` directly within this directory for a faster build.\n If you make changes to any of this package's local dependencies, you will need to run a build again from the root before building again from directly within this package.\n\n### Test\n\nTo run the tests, first ensure you have followed the [build](#build) steps above.\nNext, run `npm run test` from a terminal within this directory.\n\n\n\n\n\n\n\n## API Documentation\n\nAPI documentation for **@fluid-experimental/devtools-core** is available at .\n\n\n\n\n\n\n\n\n\n\n## Contribution Guidelines\n\nThere are many ways to [contribute](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md) to Fluid.\n\n- Participate in Q&A in our [GitHub Discussions](https://github.com/microsoft/FluidFramework/discussions).\n- [Submit bugs](https://github.com/microsoft/FluidFramework/issues) and help us verify fixes as they are checked in.\n- Review the [source code changes](https://github.com/microsoft/FluidFramework/pulls).\n- [Contribute bug fixes](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md).\n\nDetailed instructions for working in the repo can be found in the [Wiki](https://github.com/microsoft/FluidFramework/wiki).\n\nThis project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).\nFor more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\nUse of these trademarks or logos must follow Microsoft’s [Trademark & Brand Guidelines](https://www.microsoft.com/trademarks).\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n\n\n\n## Help\n\nNot finding what you're looking for in this README? Check out our [GitHub\nWiki](https://github.com/microsoft/FluidFramework/wiki) or [fluidframework.com](https://fluidframework.com/docs/).\n\nStill not finding what you're looking for? Please [file an\nissue](https://github.com/microsoft/FluidFramework/wiki/Submitting-Bugs-and-Feature-Requests).\n\nThank you!\n\n\n\n\n\n\n\n\n\n\n## Trademark\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\n\nUse of these trademarks or logos must follow Microsoft's [Trademark & Brand\nGuidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general).\n\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n[initialize-devtools-docs]: https://fluidframework.com/docs/apis/devtools-core#initializedevtools-function\n[devtools-logger-docs]: https://fluidframework.com/docs/apis/devtools-core/devtoolslogger-class\n[devtools-package]: https://www.npmjs.com/package/@fluid-experimental/devtools\n[browser-extension]: https://github.com/microsoft/FluidFramework/tree/main/packages/tools/devtools/devtools-browser-extension\n","scripts":{"tsc":"tsc","lint":"npm run prettier && npm run eslint","test":"npm run test:mocha","build":"fluid-build . --task build","clean":"rimraf --glob '_api-extractor-temp' 'nyc' 'dist' 'lib' '*.tsbuildinfo' '*.build.log'","eslint":"eslint src","format":"npm run prettier:fix","rebuild":"npm run clean && npm run build","lint:fix":"npm run prettier:fix && npm run eslint:fix","prettier":"prettier --check . --ignore-path ../../../../.prettierignore","tsc:watch":"tsc --watch","build:docs":"api-extractor run --local && copyfiles -u 1 ./_api-extractor-temp/doc-models/* ../../../../_api-extractor-temp/","eslint:fix":"eslint src --fix","test:mocha":"mocha dist/**/*.test.js --exit","build:esnext":"tsc --project ./tsconfig.esnext.json","build:genver":"gen-version","prettier:fix":"prettier --write . --ignore-path ../../../../.prettierignore","build:compile":"fluid-build . --task compile","ci:build:docs":"api-extractor run && copyfiles -u 1 ./_api-extractor-temp/doc-models/* ../../../../_api-extractor-temp/","test:coverage":"c8 npm test","typetests:gen":"fluid-type-test-generator","build:commonjs":"fluid-build . --task commonjs","format-and-build":"npm run format && npm run build","typetests:prepare":"flub typetests --dir . --reset --previous --normalize","format-and-compile":"npm run format && npm run build:compile"},"_npmUser":{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},"_resolved":"/mnt/vss/_work/1/pack/scoped/fluid-experimental-devtools-core-2.0.0-internal.7.0.1.tgz","_integrity":"sha512-QQbSHRvtaMQmXxMucDAuJOEMdidkzTtX/TXYPRQPUyV+94fil7aApKEItl6dYxsRxjI46nVXNUYNYKnUQR0K4w==","fluidBuild":{"tasks":{"tsc":["...","typetests:gen"]}},"repository":{"url":"git+https://github.com/microsoft/FluidFramework.git","type":"git","directory":"packages/tools/devtools/devtools-core"},"_npmVersion":"9.6.7","description":"Fluid Framework developer tools core functionality","directories":{},"sideEffects":false,"_nodeVersion":"18.17.1","dependencies":{"@fluidframework/map":">=2.0.0-internal.7.0.1 <2.0.0-internal.7.1.0","@fluidframework/cell":">=2.0.0-internal.7.0.1 <2.0.0-internal.7.1.0","@fluidframework/matrix":">=2.0.0-internal.7.0.1 <2.0.0-internal.7.1.0","@fluidframework/counter":">=2.0.0-internal.7.0.1 <2.0.0-internal.7.1.0","@fluidframework/sequence":">=2.0.0-internal.7.0.1 <2.0.0-internal.7.1.0","@fluid-experimental/tree2":">=2.0.0-internal.7.0.1 <2.0.0-internal.7.1.0","@fluid-internal/client-utils":">=2.0.0-internal.7.0.1 <2.0.0-internal.7.1.0","@fluidframework/core-interfaces":">=2.0.0-internal.7.0.1 <2.0.0-internal.7.1.0","@fluidframework/telemetry-utils":">=2.0.0-internal.7.0.1 <2.0.0-internal.7.1.0","@fluidframework/container-loader":">=2.0.0-internal.7.0.1 <2.0.0-internal.7.1.0","@fluidframework/shared-object-base":">=2.0.0-internal.7.0.1 <2.0.0-internal.7.1.0","@fluidframework/protocol-definitions":"^3.0.0","@fluidframework/container-definitions":">=2.0.0-internal.7.0.1 <2.0.0-internal.7.1.0","@fluidframework/datastore-definitions":">=2.0.0-internal.7.0.1 <2.0.0-internal.7.1.0"},"_hasShrinkwrap":false,"readmeFilename":"README.md","typeValidation":{"broken":{"InterfaceDeclaration_FluidDevtoolsProps":{"forwardCompat":false},"InterfaceDeclaration_ContainerDevtoolsProps":{"forwardCompat":false}}},"devDependencies":{"c8":"^7.7.1","chai":"^4.2.0","mocha":"^10.2.0","eslint":"~8.6.0","events":"^3.1.0","moment":"^2.21.0","rimraf":"^4.4.0","prettier":"~2.6.2","copyfiles":"^2.4.1","cross-env":"^7.0.3","typescript":"~5.1.6","@types/chai":"^4.0.0","@types/mocha":"^9.1.1","@types/events":"^3.0.0","mocha-multi-reporters":"^1.5.1","@fluid-tools/build-cli":"^0.24.0","eslint-config-prettier":"~8.5.0","@microsoft/api-extractor":"^7.37.0","eslint-plugin-chai-expect":"~3.0.0","mocha-json-output-reporter":"^2.0.1","@fluidframework/build-tools":"^0.24.0","@fluidframework/build-common":"^2.0.0","@fluidframework/mocha-test-setup":">=2.0.0-internal.7.0.1 <2.0.0-internal.7.1.0","@fluidframework/driver-definitions":">=2.0.0-internal.7.0.1 <2.0.0-internal.7.1.0","@fluidframework/test-runtime-utils":">=2.0.0-internal.7.0.1 <2.0.0-internal.7.1.0","@fluidframework/eslint-config-fluid":"^2.1.0","@fluid-experimental/devtools-core-previous":"npm:@fluid-experimental/devtools-core@2.0.0-internal.6.3.0"},"_npmOperationalInternal":{"tmp":"tmp/devtools-core_2.0.0-internal.7.0.1_1698453179990_0.6587975916239048","host":"s3://npm-registry-packages"}},"2.0.0-internal.7.1.1":{"name":"@fluid-experimental/devtools-core","version":"2.0.0-internal.7.1.1","author":{"name":"Microsoft and contributors"},"license":"MIT","_id":"@fluid-experimental/devtools-core@2.0.0-internal.7.1.1","maintainers":[{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},{"name":"curtisman","email":"curtism@microsoft.com"}],"homepage":"https://fluidframework.com","bugs":{"url":"https://github.com/microsoft/FluidFramework/issues"},"c8":{"all":true,"exclude":["src/test/**/*.ts","dist/test/**/*.js"],"include":["src/**/*.ts","dist/**/*.js"],"reporter":["cobertura","html","text"],"cache-dir":"nyc/.cache","report-dir":"nyc/report","temp-directory":"nyc/.nyc_output","exclude-after-remap":false},"dist":{"shasum":"234a523b92484d962fb4dd6cddf61e8ecbc4827b","tarball":"https://registry.npmjs.org/@fluid-experimental/devtools-core/-/devtools-core-2.0.0-internal.7.1.1.tgz","fileCount":505,"integrity":"sha512-TfCuqU06XPn5834e7xnPXVr+CHIMm8vn8I8HoKpucnSt7XlJ2OSNPMkOkqQvsuZbIcDVrji/b1YXv9cTYfyPaw==","signatures":[{"sig":"MEQCIHcASmMA3s+4saQvhQE1KBXg3PzyeCWWTQrHBAWj/qsZAiAsu8ZL3CkRjm7lqY2GBdCpjnWXcj2HRKtTmbg/QNPi5w==","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}],"unpackedSize":1468034},"main":"dist/index.js","_from":"file:fluid-experimental-devtools-core-2.0.0-internal.7.1.1.tgz","types":"dist/index.d.ts","module":"lib/index.js","readme":"# @fluid-experimental/devtools-core\n\nThis library contains developer tools for use alongside the Fluid Framework.\nIt is used to power our associated [browser extension][browser-extension].\n\n- Chrome: \n- Edge: \n\n\n\n\n\n\n## Installation\n\nTo get started, install the package by running the following command:\n\n```bash\nnpm i @fluid-experimental/devtools-core -D\n```\n\n\n\n\n\n## Usage\n\nThe Devtools' API surface is designed to fit nicely into most application flows.\n\n### Initialization\n\nTo initialize a devtools session for your container, call [`initializeDevtools`][initialize-devtools-docs].\nThis function accepts a `DevtoolsLogger` for receiving Fluid telemetry from your application, a list of initial Fluid\n`Containers` to associate with the session, and (optionally) customized data visualization configurations for visualizing\n`Container` data.\n\n#### About the [`DevtoolsLogger`][devtools-logger-docs]\n\nThe `DevtoolsLogger` is an optional piece when calling `initializeDevtools` but it is strongly recommended that you use\nit because several features in Fluid Devtools are powered by the telemetry that Fluid Framework generates, and this\nlogger is the way in which that telemetry gets into Fluid Devtools.\n\nYou can obtain a `DevtoolsLogger` by calling its constructor, and then should pass it to `initializeDevtools` _and_\nto the `Loader` instance you'll use to create/load Containers as shown below.\nThis way the logger will receive all the telemetry generated by Fluid Framework in your application, and forward it to\nFluid Devtools as necessary.\n\n```typescript\nimport { DevtoolsLogger, initializeDevtools } from \"@fluid-experimental/devtools-core\";\n\n// Instantiate the logger\nconst devtoolsLogger = new DevtoolsLogger();\n\n// Pass the logger when instantiating the Loader\nconst loader = new Loader({\n\tlogger: devtoolsLogger,\n\t// Other necessary properties ...\n});\n\n// Use the Loader to create (and optionally, attach) a Container\nconst container = await loader.createDetachedContainer(/* params */);\nawait container.attach(/* params */);\n\n// Initialize the Devtools passing the logger and your Container.\n// The Container could be added later as well with devtools.registerContainerDevtools().\nconst devtools = initializeDevtools({\n\tlogger: devtoolsLogger,\n\tinitialContainers: [\n\t\t{\n\t\t\tcontainer,\n\t\t\tcontainerKey: \"My Container\",\n\t\t},\n\t],\n});\n```\n\nIf you're working with `AzureClient` instead of lower-level APIs like the one described above, you probably want to\nrefer to the [@fluid-experimental/devtools package][devtools-package] instead of this one.\n\nDuring local development the recommendation is that your application should receive the `DevtoolsLogger` instance _instead_\nof any logger it would normally receive when deployed to a real environment, to avoid local development activity from\nmixing with real telemetry.\nIf you still want to provide a real application logger and use the Fluid Devtools features that are powered by telemetry\nat the same time, you can pass an existing logger to the `DevtoolsLogger` constructor and it will forward all telemetry\nit receives to that logger as well:\n\n```typescript\nimport { DevtoolsLogger } from \"@fluid-experimental/devtools-core\";\n\n// Your application's logger\nconst yourApplicationLogger = getInstanceOfYourApplicationLogger();\n\nconst devtoolsLogger = new DevtoolsLogger(yourApplicationLogger);\n\n// Pass devtoolsLogger to initializeDevtools() and to your application as described above\n```\n\n### Clean-up\n\nThe Devtools object is managed as a global singleton.\nThat singleton is automatically cleaned up prior to the Window's \"unload\" event.\nSo typical application flows likely won't need to worry about cleanup.\nThat said, if you wish to have tighter control over when the Devtools are torn down, you can simply call the `dispose` method on the handle returned by [initialization](#initialization).\n\n## Contributing to the package\n\n### Build\n\nTo build the package locally, first ensure you have run `pnpm install` from the root of the mono-repo.\nNext, to build the code, run `npm run build` from the root of the mono-repo, or use [fluid-build](https://github.com/microsoft/FluidFramework/tree/main/build-tools/packages/build-tools#running-fluid-build-command-line) via `fluid-build -t build`.\n\n- Note: Once you have run a build from the root, assuming no other changes outside of this package, you may run `npm run build` directly within this directory for a faster build.\n If you make changes to any of this package's local dependencies, you will need to run a build again from the root before building again from directly within this package.\n\n### Test\n\nTo run the tests, first ensure you have followed the [build](#build) steps above.\nNext, run `npm run test` from a terminal within this directory.\n\n\n\n\n\n\n\n## API Documentation\n\nAPI documentation for **@fluid-experimental/devtools-core** is available at .\n\n\n\n\n\n\n\n\n\n\n## Contribution Guidelines\n\nThere are many ways to [contribute](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md) to Fluid.\n\n- Participate in Q&A in our [GitHub Discussions](https://github.com/microsoft/FluidFramework/discussions).\n- [Submit bugs](https://github.com/microsoft/FluidFramework/issues) and help us verify fixes as they are checked in.\n- Review the [source code changes](https://github.com/microsoft/FluidFramework/pulls).\n- [Contribute bug fixes](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md).\n\nDetailed instructions for working in the repo can be found in the [Wiki](https://github.com/microsoft/FluidFramework/wiki).\n\nThis project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).\nFor more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\nUse of these trademarks or logos must follow Microsoft’s [Trademark & Brand Guidelines](https://www.microsoft.com/trademarks).\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n\n\n\n## Help\n\nNot finding what you're looking for in this README? Check out our [GitHub\nWiki](https://github.com/microsoft/FluidFramework/wiki) or [fluidframework.com](https://fluidframework.com/docs/).\n\nStill not finding what you're looking for? Please [file an\nissue](https://github.com/microsoft/FluidFramework/wiki/Submitting-Bugs-and-Feature-Requests).\n\nThank you!\n\n\n\n\n\n\n\n\n\n\n## Trademark\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\n\nUse of these trademarks or logos must follow Microsoft's [Trademark & Brand\nGuidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general).\n\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n[initialize-devtools-docs]: https://fluidframework.com/docs/apis/devtools-core#initializedevtools-function\n[devtools-logger-docs]: https://fluidframework.com/docs/apis/devtools-core/devtoolslogger-class\n[devtools-package]: https://www.npmjs.com/package/@fluid-experimental/devtools\n[browser-extension]: https://github.com/microsoft/FluidFramework/tree/main/packages/tools/devtools/devtools-browser-extension\n","scripts":{"tsc":"tsc","lint":"npm run prettier && npm run eslint","test":"npm run test:mocha","build":"fluid-build . --task build","clean":"rimraf --glob '_api-extractor-temp' 'nyc' 'dist' 'lib' '*.tsbuildinfo' '*.build.log'","eslint":"eslint src","format":"npm run prettier:fix","rebuild":"npm run clean && npm run build","lint:fix":"npm run prettier:fix && npm run eslint:fix","prettier":"prettier --check . --ignore-path ../../../../.prettierignore","tsc:watch":"tsc --watch","build:docs":"api-extractor run --local","eslint:fix":"eslint src --fix","test:mocha":"mocha dist/**/*.test.js --exit","build:esnext":"tsc --project ./tsconfig.esnext.json","build:genver":"gen-version","prettier:fix":"prettier --write . --ignore-path ../../../../.prettierignore","build:compile":"fluid-build . --task compile","ci:build:docs":"api-extractor run","test:coverage":"c8 npm test","typetests:gen":"fluid-type-test-generator","build:commonjs":"fluid-build . --task commonjs","format-and-build":"npm run format && npm run build","typetests:prepare":"flub typetests --dir . --reset --previous --normalize","format-and-compile":"npm run format && npm run build:compile"},"_npmUser":{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},"_resolved":"/mnt/vss/_work/1/pack/scoped/fluid-experimental-devtools-core-2.0.0-internal.7.1.1.tgz","_integrity":"sha512-TfCuqU06XPn5834e7xnPXVr+CHIMm8vn8I8HoKpucnSt7XlJ2OSNPMkOkqQvsuZbIcDVrji/b1YXv9cTYfyPaw==","fluidBuild":{"tasks":{"tsc":["...","typetests:gen"]}},"repository":{"url":"git+https://github.com/microsoft/FluidFramework.git","type":"git","directory":"packages/tools/devtools/devtools-core"},"_npmVersion":"9.6.7","description":"Fluid Framework developer tools core functionality","directories":{},"sideEffects":false,"_nodeVersion":"18.17.1","dependencies":{"@fluidframework/map":">=2.0.0-internal.7.1.1 <2.0.0-internal.7.2.0","@fluidframework/cell":">=2.0.0-internal.7.1.1 <2.0.0-internal.7.2.0","@fluidframework/matrix":">=2.0.0-internal.7.1.1 <2.0.0-internal.7.2.0","@fluidframework/counter":">=2.0.0-internal.7.1.1 <2.0.0-internal.7.2.0","@fluidframework/sequence":">=2.0.0-internal.7.1.1 <2.0.0-internal.7.2.0","@fluid-experimental/tree2":">=2.0.0-internal.7.1.1 <2.0.0-internal.7.2.0","@fluid-internal/client-utils":">=2.0.0-internal.7.1.1 <2.0.0-internal.7.2.0","@fluidframework/core-interfaces":">=2.0.0-internal.7.1.1 <2.0.0-internal.7.2.0","@fluidframework/telemetry-utils":">=2.0.0-internal.7.1.1 <2.0.0-internal.7.2.0","@fluidframework/container-loader":">=2.0.0-internal.7.1.1 <2.0.0-internal.7.2.0","@fluidframework/shared-object-base":">=2.0.0-internal.7.1.1 <2.0.0-internal.7.2.0","@fluidframework/protocol-definitions":"^3.0.0","@fluidframework/container-definitions":">=2.0.0-internal.7.1.1 <2.0.0-internal.7.2.0","@fluidframework/datastore-definitions":">=2.0.0-internal.7.1.1 <2.0.0-internal.7.2.0"},"_hasShrinkwrap":false,"readmeFilename":"README.md","typeValidation":{"broken":{}},"devDependencies":{"c8":"^7.7.1","chai":"^4.2.0","mocha":"^10.2.0","eslint":"~8.50.0","events":"^3.1.0","moment":"^2.21.0","rimraf":"^4.4.0","prettier":"~3.0.3","copyfiles":"^2.4.1","cross-env":"^7.0.3","typescript":"~5.1.6","@types/chai":"^4.0.0","@types/mocha":"^9.1.1","@types/events":"^3.0.0","mocha-multi-reporters":"^1.5.1","@fluid-tools/build-cli":"^0.25.0","eslint-config-prettier":"~9.0.0","@microsoft/api-extractor":"^7.37.0","eslint-plugin-chai-expect":"~3.0.0","mocha-json-output-reporter":"^2.0.1","@fluidframework/build-tools":"^0.25.0","@fluidframework/build-common":"^2.0.1","@fluidframework/mocha-test-setup":">=2.0.0-internal.7.1.1 <2.0.0-internal.7.2.0","@fluidframework/driver-definitions":">=2.0.0-internal.7.1.1 <2.0.0-internal.7.2.0","@fluidframework/test-runtime-utils":">=2.0.0-internal.7.1.1 <2.0.0-internal.7.2.0","@fluidframework/eslint-config-fluid":"^3.0.0","@fluid-experimental/devtools-core-previous":"npm:@fluid-experimental/devtools-core@2.0.0-internal.7.1.0"},"_npmOperationalInternal":{"tmp":"tmp/devtools-core_2.0.0-internal.7.1.1_1698453200783_0.13718172026776232","host":"s3://npm-registry-packages"}},"2.0.0-dev.7.3.0.206769":{"name":"@fluid-experimental/devtools-core","version":"2.0.0-dev.7.3.0.206769","author":{"name":"Microsoft and contributors"},"license":"MIT","_id":"@fluid-experimental/devtools-core@2.0.0-dev.7.3.0.206769","maintainers":[{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},{"name":"curtisman","email":"curtism@microsoft.com"}],"homepage":"https://fluidframework.com","bugs":{"url":"https://github.com/microsoft/FluidFramework/issues"},"c8":{"all":true,"exclude":["src/test/**/*.ts","dist/test/**/*.js"],"include":["src/**/*.ts","dist/**/*.js"],"reporter":["cobertura","html","text"],"cache-dir":"nyc/.cache","report-dir":"nyc/report","temp-directory":"nyc/.nyc_output","exclude-after-remap":false},"dist":{"shasum":"52b3c17ba44ef821942d849d4012befec0b66c43","tarball":"https://registry.npmjs.org/@fluid-experimental/devtools-core/-/devtools-core-2.0.0-dev.7.3.0.206769.tgz","fileCount":505,"integrity":"sha512-CHRHYXaPZuhws4QbtBXEkrW/CxpCN9Ht/BVgfJhsNv3ivUxPzLvdR9MK9aSJfbetTnir5lFOxJGRYTp8GCgwFQ==","signatures":[{"sig":"MEYCIQCMc+9bouGb/8fo/+AndG6rh3uQerklwzfbXx77K71zFAIhAMbt/yGtSlsNdcr9chDj3LvMGXmccvqNWjy9dqtW1dJh","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}],"unpackedSize":1467750},"main":"dist/index.js","_from":"file:fluid-experimental-devtools-core-2.0.0-dev.7.3.0.206769.tgz","types":"dist/index.d.ts","module":"lib/index.js","readme":"# @fluid-experimental/devtools-core\n\nThis library contains developer tools for use alongside the Fluid Framework.\nIt is used to power our associated [browser extension][browser-extension].\n\n- Chrome: \n- Edge: \n\n\n\n\n\n\n## Installation\n\nTo get started, install the package by running the following command:\n\n```bash\nnpm i @fluid-experimental/devtools-core -D\n```\n\n\n\n\n\n## Usage\n\nThe Devtools' API surface is designed to fit nicely into most application flows.\n\n### Initialization\n\nTo initialize a devtools session for your container, call [`initializeDevtools`][initialize-devtools-docs].\nThis function accepts a `DevtoolsLogger` for receiving Fluid telemetry from your application, a list of initial Fluid\n`Containers` to associate with the session, and (optionally) customized data visualization configurations for visualizing\n`Container` data.\n\n#### About the [`DevtoolsLogger`][devtools-logger-docs]\n\nThe `DevtoolsLogger` is an optional piece when calling `initializeDevtools` but it is strongly recommended that you use\nit because several features in Fluid Devtools are powered by the telemetry that Fluid Framework generates, and this\nlogger is the way in which that telemetry gets into Fluid Devtools.\n\nYou can obtain a `DevtoolsLogger` by calling its constructor, and then should pass it to `initializeDevtools` _and_\nto the `Loader` instance you'll use to create/load Containers as shown below.\nThis way the logger will receive all the telemetry generated by Fluid Framework in your application, and forward it to\nFluid Devtools as necessary.\n\n```typescript\nimport { DevtoolsLogger, initializeDevtools } from \"@fluid-experimental/devtools-core\";\n\n// Instantiate the logger\nconst devtoolsLogger = new DevtoolsLogger();\n\n// Pass the logger when instantiating the Loader\nconst loader = new Loader({\n\tlogger: devtoolsLogger,\n\t// Other necessary properties ...\n});\n\n// Use the Loader to create (and optionally, attach) a Container\nconst container = await loader.createDetachedContainer(/* params */);\nawait container.attach(/* params */);\n\n// Initialize the Devtools passing the logger and your Container.\n// The Container could be added later as well with devtools.registerContainerDevtools().\nconst devtools = initializeDevtools({\n\tlogger: devtoolsLogger,\n\tinitialContainers: [\n\t\t{\n\t\t\tcontainer,\n\t\t\tcontainerKey: \"My Container\",\n\t\t},\n\t],\n});\n```\n\nIf you're working with `AzureClient` instead of lower-level APIs like the one described above, you probably want to\nrefer to the [@fluid-experimental/devtools package][devtools-package] instead of this one.\n\nDuring local development the recommendation is that your application should receive the `DevtoolsLogger` instance _instead_\nof any logger it would normally receive when deployed to a real environment, to avoid local development activity from\nmixing with real telemetry.\nIf you still want to provide a real application logger and use the Fluid Devtools features that are powered by telemetry\nat the same time, you can pass an existing logger to the `DevtoolsLogger` constructor and it will forward all telemetry\nit receives to that logger as well:\n\n```typescript\nimport { DevtoolsLogger } from \"@fluid-experimental/devtools-core\";\n\n// Your application's logger\nconst yourApplicationLogger = getInstanceOfYourApplicationLogger();\n\nconst devtoolsLogger = new DevtoolsLogger(yourApplicationLogger);\n\n// Pass devtoolsLogger to initializeDevtools() and to your application as described above\n```\n\n### Clean-up\n\nThe Devtools object is managed as a global singleton.\nThat singleton is automatically cleaned up prior to the Window's \"unload\" event.\nSo typical application flows likely won't need to worry about cleanup.\nThat said, if you wish to have tighter control over when the Devtools are torn down, you can simply call the `dispose` method on the handle returned by [initialization](#initialization).\n\n## Contributing to the package\n\n### Build\n\nTo build the package locally, first ensure you have run `pnpm install` from the root of the mono-repo.\nNext, to build the code, run `npm run build` from the root of the mono-repo, or use [fluid-build](https://github.com/microsoft/FluidFramework/tree/main/build-tools/packages/build-tools#running-fluid-build-command-line) via `fluid-build -t build`.\n\n- Note: Once you have run a build from the root, assuming no other changes outside of this package, you may run `npm run build` directly within this directory for a faster build.\n If you make changes to any of this package's local dependencies, you will need to run a build again from the root before building again from directly within this package.\n\n### Test\n\nTo run the tests, first ensure you have followed the [build](#build) steps above.\nNext, run `npm run test` from a terminal within this directory.\n\n\n\n\n\n\n\n## API Documentation\n\nAPI documentation for **@fluid-experimental/devtools-core** is available at .\n\n\n\n\n\n\n\n\n\n\n## Contribution Guidelines\n\nThere are many ways to [contribute](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md) to Fluid.\n\n- Participate in Q&A in our [GitHub Discussions](https://github.com/microsoft/FluidFramework/discussions).\n- [Submit bugs](https://github.com/microsoft/FluidFramework/issues) and help us verify fixes as they are checked in.\n- Review the [source code changes](https://github.com/microsoft/FluidFramework/pulls).\n- [Contribute bug fixes](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md).\n\nDetailed instructions for working in the repo can be found in the [Wiki](https://github.com/microsoft/FluidFramework/wiki).\n\nThis project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).\nFor more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\nUse of these trademarks or logos must follow Microsoft’s [Trademark & Brand Guidelines](https://www.microsoft.com/trademarks).\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n\n\n\n## Help\n\nNot finding what you're looking for in this README? Check out our [GitHub\nWiki](https://github.com/microsoft/FluidFramework/wiki) or [fluidframework.com](https://fluidframework.com/docs/).\n\nStill not finding what you're looking for? Please [file an\nissue](https://github.com/microsoft/FluidFramework/wiki/Submitting-Bugs-and-Feature-Requests).\n\nThank you!\n\n\n\n\n\n\n\n\n\n\n## Trademark\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\n\nUse of these trademarks or logos must follow Microsoft's [Trademark & Brand\nGuidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general).\n\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n[initialize-devtools-docs]: https://fluidframework.com/docs/apis/devtools-core#initializedevtools-function\n[devtools-logger-docs]: https://fluidframework.com/docs/apis/devtools-core/devtoolslogger-class\n[devtools-package]: https://www.npmjs.com/package/@fluid-experimental/devtools\n[browser-extension]: https://github.com/microsoft/FluidFramework/tree/main/packages/tools/devtools/devtools-browser-extension\n","scripts":{"tsc":"tsc","lint":"npm run prettier && npm run eslint","test":"npm run test:mocha","build":"fluid-build . --task build","clean":"rimraf --glob _api-extractor-temp nyc dist lib \"*.tsbuildinfo\" \"*.build.log\"","eslint":"eslint src","format":"npm run prettier:fix","rebuild":"npm run clean && npm run build","lint:fix":"npm run prettier:fix && npm run eslint:fix","prettier":"prettier --check . --ignore-path ../../../../.prettierignore","tsc:watch":"tsc --watch","build:docs":"api-extractor run --local","eslint:fix":"eslint src --fix","test:mocha":"mocha dist/**/*.test.js --exit","build:esnext":"tsc --project ./tsconfig.esnext.json","build:genver":"gen-version","prettier:fix":"prettier --write . --ignore-path ../../../../.prettierignore","build:compile":"fluid-build . --task compile","ci:build:docs":"api-extractor run","test:coverage":"c8 npm test","typetests:gen":"fluid-type-test-generator","build:commonjs":"fluid-build . --task commonjs","format-and-build":"npm run format && npm run build","typetests:prepare":"flub typetests --dir . --reset --previous --normalize","format-and-compile":"npm run format && npm run build:compile"},"_npmUser":{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},"_resolved":"/mnt/vss/_work/1/pack/scoped/fluid-experimental-devtools-core-2.0.0-dev.7.3.0.206769.tgz","_integrity":"sha512-CHRHYXaPZuhws4QbtBXEkrW/CxpCN9Ht/BVgfJhsNv3ivUxPzLvdR9MK9aSJfbetTnir5lFOxJGRYTp8GCgwFQ==","fluidBuild":{"tasks":{"tsc":["...","typetests:gen"]}},"repository":{"url":"git+https://github.com/microsoft/FluidFramework.git","type":"git","directory":"packages/tools/devtools/devtools-core"},"_npmVersion":"9.6.7","description":"Fluid Framework developer tools core functionality","directories":{},"sideEffects":false,"_nodeVersion":"18.17.1","dependencies":{"@fluidframework/map":"2.0.0-dev.7.3.0.206769","@fluidframework/cell":"2.0.0-dev.7.3.0.206769","@fluidframework/matrix":"2.0.0-dev.7.3.0.206769","@fluidframework/counter":"2.0.0-dev.7.3.0.206769","@fluidframework/sequence":"2.0.0-dev.7.3.0.206769","@fluid-experimental/tree2":"2.0.0-dev.7.3.0.206769","@fluid-internal/client-utils":"2.0.0-dev.7.3.0.206769","@fluidframework/core-interfaces":"2.0.0-dev.7.3.0.206769","@fluidframework/telemetry-utils":"2.0.0-dev.7.3.0.206769","@fluidframework/container-loader":"2.0.0-dev.7.3.0.206769","@fluidframework/shared-object-base":"2.0.0-dev.7.3.0.206769","@fluidframework/protocol-definitions":"^3.0.0","@fluidframework/container-definitions":"2.0.0-dev.7.3.0.206769","@fluidframework/datastore-definitions":"2.0.0-dev.7.3.0.206769"},"_hasShrinkwrap":false,"readmeFilename":"README.md","typeValidation":{"broken":{}},"devDependencies":{"c8":"^7.7.1","chai":"^4.2.0","mocha":"^10.2.0","eslint":"~8.50.0","events":"^3.1.0","moment":"^2.21.0","rimraf":"^4.4.0","prettier":"~3.0.3","cross-env":"^7.0.3","typescript":"~5.1.6","@types/chai":"^4.0.0","@types/mocha":"^9.1.1","@types/events":"^3.0.0","mocha-multi-reporters":"^1.5.1","@fluid-tools/build-cli":"^0.26.1","eslint-config-prettier":"~9.0.0","@microsoft/api-extractor":"^7.37.0","eslint-plugin-chai-expect":"~3.0.0","mocha-json-output-reporter":"^2.0.1","@fluidframework/build-tools":"^0.26.1","@fluidframework/build-common":"^2.0.3","@fluidframework/mocha-test-setup":"2.0.0-dev.7.3.0.206769","@fluidframework/driver-definitions":"2.0.0-dev.7.3.0.206769","@fluidframework/test-runtime-utils":"2.0.0-dev.7.3.0.206769","@fluidframework/eslint-config-fluid":"^3.0.0","@fluid-experimental/devtools-core-previous":"npm:@fluid-experimental/devtools-core@2.0.0-internal.7.1.0"},"_npmOperationalInternal":{"tmp":"tmp/devtools-core_2.0.0-dev.7.3.0.206769_1698714093968_0.2220228511434188","host":"s3://npm-registry-packages"}},"2.0.0-dev.7.3.0.207781":{"name":"@fluid-experimental/devtools-core","version":"2.0.0-dev.7.3.0.207781","author":{"name":"Microsoft and contributors"},"license":"MIT","_id":"@fluid-experimental/devtools-core@2.0.0-dev.7.3.0.207781","maintainers":[{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},{"name":"curtisman","email":"curtism@microsoft.com"}],"homepage":"https://fluidframework.com","bugs":{"url":"https://github.com/microsoft/FluidFramework/issues"},"c8":{"all":true,"exclude":["src/test/**/*.ts","dist/test/**/*.js"],"include":["src/**/*.ts","dist/**/*.js"],"reporter":["cobertura","html","text"],"cache-dir":"nyc/.cache","report-dir":"nyc/report","temp-directory":"nyc/.nyc_output","exclude-after-remap":false},"dist":{"shasum":"13f0bb7c4f8f4a4906c7d3baed44f3351a848ca3","tarball":"https://registry.npmjs.org/@fluid-experimental/devtools-core/-/devtools-core-2.0.0-dev.7.3.0.207781.tgz","fileCount":505,"integrity":"sha512-/sEi4yXz1VmL2CShbmxVTzNCuaj4DqrCMyahGa5X58h61Cv/qmj4aISRlNA9QweogtJRoLf16M5d9cDaC1m5Ag==","signatures":[{"sig":"MEUCIHTt7TKqNFcnUyUtz7hVFjgV1gSiwAPKtPpBi6ZDoYmcAiEAvyJPaNhlXRjjh060hEE2je4lRvT7md8TH+1OhOblZ0k=","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}],"unpackedSize":1547204},"main":"dist/index.js","_from":"file:fluid-experimental-devtools-core-2.0.0-dev.7.3.0.207781.tgz","types":"dist/index.d.ts","module":"lib/index.js","readme":"# @fluid-experimental/devtools-core\n\nThis library contains developer tools for use alongside the Fluid Framework.\nIt is used to power our associated [browser extension][browser-extension].\n\n- Chrome: \n- Edge: \n\n\n\n\n\n\n## Installation\n\nTo get started, install the package by running the following command:\n\n```bash\nnpm i @fluid-experimental/devtools-core -D\n```\n\n\n\n\n\n## Usage\n\nThe Devtools' API surface is designed to fit nicely into most application flows.\n\n### Initialization\n\nTo initialize a devtools session for your container, call [`initializeDevtools`][initialize-devtools-docs].\nThis function accepts a `DevtoolsLogger` for receiving Fluid telemetry from your application, a list of initial Fluid\n`Containers` to associate with the session, and (optionally) customized data visualization configurations for visualizing\n`Container` data.\n\n#### About the [`DevtoolsLogger`][devtools-logger-docs]\n\nThe `DevtoolsLogger` is an optional piece when calling `initializeDevtools` but it is strongly recommended that you use\nit because several features in Fluid Devtools are powered by the telemetry that Fluid Framework generates, and this\nlogger is the way in which that telemetry gets into Fluid Devtools.\n\nYou can obtain a `DevtoolsLogger` by calling its constructor, and then should pass it to `initializeDevtools` _and_\nto the `Loader` instance you'll use to create/load Containers as shown below.\nThis way the logger will receive all the telemetry generated by Fluid Framework in your application, and forward it to\nFluid Devtools as necessary.\n\n```typescript\nimport { DevtoolsLogger, initializeDevtools } from \"@fluid-experimental/devtools-core\";\n\n// Instantiate the logger\nconst devtoolsLogger = new DevtoolsLogger();\n\n// Pass the logger when instantiating the Loader\nconst loader = new Loader({\n\tlogger: devtoolsLogger,\n\t// Other necessary properties ...\n});\n\n// Use the Loader to create (and optionally, attach) a Container\nconst container = await loader.createDetachedContainer(/* params */);\nawait container.attach(/* params */);\n\n// Initialize the Devtools passing the logger and your Container.\n// The Container could be added later as well with devtools.registerContainerDevtools().\nconst devtools = initializeDevtools({\n\tlogger: devtoolsLogger,\n\tinitialContainers: [\n\t\t{\n\t\t\tcontainer,\n\t\t\tcontainerKey: \"My Container\",\n\t\t},\n\t],\n});\n```\n\nIf you're working with `AzureClient` instead of lower-level APIs like the one described above, you probably want to\nrefer to the [@fluid-experimental/devtools package][devtools-package] instead of this one.\n\nDuring local development the recommendation is that your application should receive the `DevtoolsLogger` instance _instead_\nof any logger it would normally receive when deployed to a real environment, to avoid local development activity from\nmixing with real telemetry.\nIf you still want to provide a real application logger and use the Fluid Devtools features that are powered by telemetry\nat the same time, you can pass an existing logger to the `DevtoolsLogger` constructor and it will forward all telemetry\nit receives to that logger as well:\n\n```typescript\nimport { DevtoolsLogger } from \"@fluid-experimental/devtools-core\";\n\n// Your application's logger\nconst yourApplicationLogger = getInstanceOfYourApplicationLogger();\n\nconst devtoolsLogger = new DevtoolsLogger(yourApplicationLogger);\n\n// Pass devtoolsLogger to initializeDevtools() and to your application as described above\n```\n\n### Clean-up\n\nThe Devtools object is managed as a global singleton.\nThat singleton is automatically cleaned up prior to the Window's \"unload\" event.\nSo typical application flows likely won't need to worry about cleanup.\nThat said, if you wish to have tighter control over when the Devtools are torn down, you can simply call the `dispose` method on the handle returned by [initialization](#initialization).\n\n## Contributing to the package\n\n### Build\n\nTo build the package locally, first ensure you have run `pnpm install` from the root of the mono-repo.\nNext, to build the code, run `npm run build` from the root of the mono-repo, or use [fluid-build](https://github.com/microsoft/FluidFramework/tree/main/build-tools/packages/build-tools#running-fluid-build-command-line) via `fluid-build -t build`.\n\n- Note: Once you have run a build from the root, assuming no other changes outside of this package, you may run `npm run build` directly within this directory for a faster build.\n If you make changes to any of this package's local dependencies, you will need to run a build again from the root before building again from directly within this package.\n\n### Test\n\nTo run the tests, first ensure you have followed the [build](#build) steps above.\nNext, run `npm run test` from a terminal within this directory.\n\n\n\n\n\n\n\n## API Documentation\n\nAPI documentation for **@fluid-experimental/devtools-core** is available at .\n\n\n\n\n\n\n\n\n\n\n## Contribution Guidelines\n\nThere are many ways to [contribute](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md) to Fluid.\n\n- Participate in Q&A in our [GitHub Discussions](https://github.com/microsoft/FluidFramework/discussions).\n- [Submit bugs](https://github.com/microsoft/FluidFramework/issues) and help us verify fixes as they are checked in.\n- Review the [source code changes](https://github.com/microsoft/FluidFramework/pulls).\n- [Contribute bug fixes](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md).\n\nDetailed instructions for working in the repo can be found in the [Wiki](https://github.com/microsoft/FluidFramework/wiki).\n\nThis project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).\nFor more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\nUse of these trademarks or logos must follow Microsoft’s [Trademark & Brand Guidelines](https://www.microsoft.com/trademarks).\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n\n\n\n## Help\n\nNot finding what you're looking for in this README? Check out our [GitHub\nWiki](https://github.com/microsoft/FluidFramework/wiki) or [fluidframework.com](https://fluidframework.com/docs/).\n\nStill not finding what you're looking for? Please [file an\nissue](https://github.com/microsoft/FluidFramework/wiki/Submitting-Bugs-and-Feature-Requests).\n\nThank you!\n\n\n\n\n\n\n\n\n\n\n## Trademark\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\n\nUse of these trademarks or logos must follow Microsoft's [Trademark & Brand\nGuidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general).\n\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n[initialize-devtools-docs]: https://fluidframework.com/docs/apis/devtools-core#initializedevtools-function\n[devtools-logger-docs]: https://fluidframework.com/docs/apis/devtools-core/devtoolslogger-class\n[devtools-package]: https://www.npmjs.com/package/@fluid-experimental/devtools\n[browser-extension]: https://github.com/microsoft/FluidFramework/tree/main/packages/tools/devtools/devtools-browser-extension\n","scripts":{"tsc":"tsc","lint":"npm run prettier && npm run eslint","test":"npm run test:mocha","build":"fluid-build . --task build","clean":"rimraf --glob _api-extractor-temp nyc dist lib \"*.tsbuildinfo\" \"*.build.log\"","eslint":"eslint src","format":"npm run prettier:fix","rebuild":"npm run clean && npm run build","lint:fix":"npm run prettier:fix && npm run eslint:fix","prettier":"prettier --check . --ignore-path ../../../../.prettierignore","tsc:watch":"tsc --watch","build:docs":"api-extractor run --local","eslint:fix":"eslint src --fix","test:mocha":"mocha dist/**/*.test.js --exit","build:esnext":"tsc --project ./tsconfig.esnext.json","build:genver":"gen-version","prettier:fix":"prettier --write . --ignore-path ../../../../.prettierignore","build:compile":"fluid-build . --task compile","ci:build:docs":"api-extractor run","test:coverage":"c8 npm test","typetests:gen":"fluid-type-test-generator","build:commonjs":"fluid-build . --task commonjs","format-and-build":"npm run format && npm run build","typetests:prepare":"flub typetests --dir . --reset --previous --normalize","format-and-compile":"npm run format && npm run build:compile"},"_npmUser":{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},"_resolved":"/mnt/vss/_work/1/pack/scoped/fluid-experimental-devtools-core-2.0.0-dev.7.3.0.207781.tgz","_integrity":"sha512-/sEi4yXz1VmL2CShbmxVTzNCuaj4DqrCMyahGa5X58h61Cv/qmj4aISRlNA9QweogtJRoLf16M5d9cDaC1m5Ag==","fluidBuild":{"tasks":{"tsc":["...","typetests:gen"]}},"repository":{"url":"git+https://github.com/microsoft/FluidFramework.git","type":"git","directory":"packages/tools/devtools/devtools-core"},"_npmVersion":"9.6.7","description":"Fluid Framework developer tools core functionality","directories":{},"sideEffects":false,"_nodeVersion":"18.17.1","dependencies":{"@fluidframework/map":"2.0.0-dev.7.3.0.207781","@fluidframework/cell":"2.0.0-dev.7.3.0.207781","@fluidframework/matrix":"2.0.0-dev.7.3.0.207781","@fluidframework/counter":"2.0.0-dev.7.3.0.207781","@fluidframework/sequence":"2.0.0-dev.7.3.0.207781","@fluid-experimental/tree2":"2.0.0-dev.7.3.0.207781","@fluid-internal/client-utils":"2.0.0-dev.7.3.0.207781","@fluidframework/core-interfaces":"2.0.0-dev.7.3.0.207781","@fluidframework/telemetry-utils":"2.0.0-dev.7.3.0.207781","@fluidframework/container-loader":"2.0.0-dev.7.3.0.207781","@fluidframework/shared-object-base":"2.0.0-dev.7.3.0.207781","@fluidframework/protocol-definitions":"^3.0.0","@fluidframework/container-definitions":"2.0.0-dev.7.3.0.207781","@fluidframework/datastore-definitions":"2.0.0-dev.7.3.0.207781"},"_hasShrinkwrap":false,"readmeFilename":"README.md","typeValidation":{"broken":{}},"devDependencies":{"c8":"^7.7.1","chai":"^4.2.0","mocha":"^10.2.0","eslint":"~8.50.0","events":"^3.1.0","moment":"^2.21.0","rimraf":"^4.4.0","prettier":"~3.0.3","cross-env":"^7.0.3","typescript":"~5.1.6","@types/chai":"^4.0.0","@types/mocha":"^9.1.1","@types/events":"^3.0.0","mocha-multi-reporters":"^1.5.1","@fluid-tools/build-cli":"^0.26.1","eslint-config-prettier":"~9.0.0","@microsoft/api-extractor":"^7.37.0","eslint-plugin-chai-expect":"~3.0.0","mocha-json-output-reporter":"^2.0.1","@fluidframework/build-tools":"^0.26.1","@fluidframework/build-common":"^2.0.3","@fluidframework/mocha-test-setup":"2.0.0-dev.7.3.0.207781","@fluidframework/driver-definitions":"2.0.0-dev.7.3.0.207781","@fluidframework/test-runtime-utils":"2.0.0-dev.7.3.0.207781","@fluidframework/eslint-config-fluid":"^3.0.0","@fluid-experimental/devtools-core-previous":"npm:@fluid-experimental/devtools-core@2.0.0-internal.7.1.0"},"_npmOperationalInternal":{"tmp":"tmp/devtools-core_2.0.0-dev.7.3.0.207781_1698884047762_0.17462186979935046","host":"s3://npm-registry-packages"}},"2.0.0-dev.7.3.0.207992":{"name":"@fluid-experimental/devtools-core","version":"2.0.0-dev.7.3.0.207992","author":{"name":"Microsoft and contributors"},"license":"MIT","_id":"@fluid-experimental/devtools-core@2.0.0-dev.7.3.0.207992","maintainers":[{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},{"name":"curtisman","email":"curtism@microsoft.com"}],"homepage":"https://fluidframework.com","bugs":{"url":"https://github.com/microsoft/FluidFramework/issues"},"c8":{"all":true,"exclude":["src/test/**/*.ts","dist/test/**/*.js"],"include":["src/**/*.ts","dist/**/*.js"],"reporter":["cobertura","html","text"],"cache-dir":"nyc/.cache","report-dir":"nyc/report","temp-directory":"nyc/.nyc_output","exclude-after-remap":false},"dist":{"shasum":"e624bd172638addac5f2f9cb822eae08824f2b4f","tarball":"https://registry.npmjs.org/@fluid-experimental/devtools-core/-/devtools-core-2.0.0-dev.7.3.0.207992.tgz","fileCount":505,"integrity":"sha512-LhnIBO0MbxIsF2b2lL/RQrpw0ZvheIDcfWvnaihJDcPGsHp+zZWAme9rEhOc5Ceu2SCmFojQ39d2Dn8O9qdmSA==","signatures":[{"sig":"MEYCIQClL0EOHXFPuG4+/ku+7SsrtGBzdmLW2XanY37nhiysqwIhAK16TPSegYgTvXGH8L4gNR+ng1pmPNqUr4/+qa/E6L9j","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}],"unpackedSize":1547204},"main":"dist/index.js","_from":"file:fluid-experimental-devtools-core-2.0.0-dev.7.3.0.207992.tgz","types":"dist/index.d.ts","module":"lib/index.js","readme":"# @fluid-experimental/devtools-core\n\nThis library contains developer tools for use alongside the Fluid Framework.\nIt is used to power our associated [browser extension][browser-extension].\n\n- Chrome: \n- Edge: \n\n\n\n\n\n\n## Installation\n\nTo get started, install the package by running the following command:\n\n```bash\nnpm i @fluid-experimental/devtools-core -D\n```\n\n\n\n\n\n## Usage\n\nThe Devtools' API surface is designed to fit nicely into most application flows.\n\n### Initialization\n\nTo initialize a devtools session for your container, call [`initializeDevtools`][initialize-devtools-docs].\nThis function accepts a `DevtoolsLogger` for receiving Fluid telemetry from your application, a list of initial Fluid\n`Containers` to associate with the session, and (optionally) customized data visualization configurations for visualizing\n`Container` data.\n\n#### About the [`DevtoolsLogger`][devtools-logger-docs]\n\nThe `DevtoolsLogger` is an optional piece when calling `initializeDevtools` but it is strongly recommended that you use\nit because several features in Fluid Devtools are powered by the telemetry that Fluid Framework generates, and this\nlogger is the way in which that telemetry gets into Fluid Devtools.\n\nYou can obtain a `DevtoolsLogger` by calling its constructor, and then should pass it to `initializeDevtools` _and_\nto the `Loader` instance you'll use to create/load Containers as shown below.\nThis way the logger will receive all the telemetry generated by Fluid Framework in your application, and forward it to\nFluid Devtools as necessary.\n\n```typescript\nimport { DevtoolsLogger, initializeDevtools } from \"@fluid-experimental/devtools-core\";\n\n// Instantiate the logger\nconst devtoolsLogger = new DevtoolsLogger();\n\n// Pass the logger when instantiating the Loader\nconst loader = new Loader({\n\tlogger: devtoolsLogger,\n\t// Other necessary properties ...\n});\n\n// Use the Loader to create (and optionally, attach) a Container\nconst container = await loader.createDetachedContainer(/* params */);\nawait container.attach(/* params */);\n\n// Initialize the Devtools passing the logger and your Container.\n// The Container could be added later as well with devtools.registerContainerDevtools().\nconst devtools = initializeDevtools({\n\tlogger: devtoolsLogger,\n\tinitialContainers: [\n\t\t{\n\t\t\tcontainer,\n\t\t\tcontainerKey: \"My Container\",\n\t\t},\n\t],\n});\n```\n\nIf you're working with `AzureClient` instead of lower-level APIs like the one described above, you probably want to\nrefer to the [@fluid-experimental/devtools package][devtools-package] instead of this one.\n\nDuring local development the recommendation is that your application should receive the `DevtoolsLogger` instance _instead_\nof any logger it would normally receive when deployed to a real environment, to avoid local development activity from\nmixing with real telemetry.\nIf you still want to provide a real application logger and use the Fluid Devtools features that are powered by telemetry\nat the same time, you can pass an existing logger to the `DevtoolsLogger` constructor and it will forward all telemetry\nit receives to that logger as well:\n\n```typescript\nimport { DevtoolsLogger } from \"@fluid-experimental/devtools-core\";\n\n// Your application's logger\nconst yourApplicationLogger = getInstanceOfYourApplicationLogger();\n\nconst devtoolsLogger = new DevtoolsLogger(yourApplicationLogger);\n\n// Pass devtoolsLogger to initializeDevtools() and to your application as described above\n```\n\n### Clean-up\n\nThe Devtools object is managed as a global singleton.\nThat singleton is automatically cleaned up prior to the Window's \"unload\" event.\nSo typical application flows likely won't need to worry about cleanup.\nThat said, if you wish to have tighter control over when the Devtools are torn down, you can simply call the `dispose` method on the handle returned by [initialization](#initialization).\n\n## Contributing to the package\n\n### Build\n\nTo build the package locally, first ensure you have run `pnpm install` from the root of the mono-repo.\nNext, to build the code, run `npm run build` from the root of the mono-repo, or use [fluid-build](https://github.com/microsoft/FluidFramework/tree/main/build-tools/packages/build-tools#running-fluid-build-command-line) via `fluid-build -t build`.\n\n- Note: Once you have run a build from the root, assuming no other changes outside of this package, you may run `npm run build` directly within this directory for a faster build.\n If you make changes to any of this package's local dependencies, you will need to run a build again from the root before building again from directly within this package.\n\n### Test\n\nTo run the tests, first ensure you have followed the [build](#build) steps above.\nNext, run `npm run test` from a terminal within this directory.\n\n\n\n\n\n\n\n## API Documentation\n\nAPI documentation for **@fluid-experimental/devtools-core** is available at .\n\n\n\n\n\n\n\n\n\n\n## Contribution Guidelines\n\nThere are many ways to [contribute](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md) to Fluid.\n\n- Participate in Q&A in our [GitHub Discussions](https://github.com/microsoft/FluidFramework/discussions).\n- [Submit bugs](https://github.com/microsoft/FluidFramework/issues) and help us verify fixes as they are checked in.\n- Review the [source code changes](https://github.com/microsoft/FluidFramework/pulls).\n- [Contribute bug fixes](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md).\n\nDetailed instructions for working in the repo can be found in the [Wiki](https://github.com/microsoft/FluidFramework/wiki).\n\nThis project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).\nFor more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\nUse of these trademarks or logos must follow Microsoft’s [Trademark & Brand Guidelines](https://www.microsoft.com/trademarks).\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n\n\n\n## Help\n\nNot finding what you're looking for in this README? Check out our [GitHub\nWiki](https://github.com/microsoft/FluidFramework/wiki) or [fluidframework.com](https://fluidframework.com/docs/).\n\nStill not finding what you're looking for? Please [file an\nissue](https://github.com/microsoft/FluidFramework/wiki/Submitting-Bugs-and-Feature-Requests).\n\nThank you!\n\n\n\n\n\n\n\n\n\n\n## Trademark\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\n\nUse of these trademarks or logos must follow Microsoft's [Trademark & Brand\nGuidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general).\n\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n[initialize-devtools-docs]: https://fluidframework.com/docs/apis/devtools-core#initializedevtools-function\n[devtools-logger-docs]: https://fluidframework.com/docs/apis/devtools-core/devtoolslogger-class\n[devtools-package]: https://www.npmjs.com/package/@fluid-experimental/devtools\n[browser-extension]: https://github.com/microsoft/FluidFramework/tree/main/packages/tools/devtools/devtools-browser-extension\n","scripts":{"tsc":"tsc","lint":"npm run prettier && npm run eslint","test":"npm run test:mocha","build":"fluid-build . --task build","clean":"rimraf --glob _api-extractor-temp nyc dist lib \"*.tsbuildinfo\" \"*.build.log\"","eslint":"eslint src","format":"npm run prettier:fix","rebuild":"npm run clean && npm run build","lint:fix":"npm run prettier:fix && npm run eslint:fix","prettier":"prettier --check . --ignore-path ../../../../.prettierignore","tsc:watch":"tsc --watch","build:docs":"api-extractor run --local","eslint:fix":"eslint src --fix","test:mocha":"mocha dist/**/*.test.js --exit","build:esnext":"tsc --project ./tsconfig.esnext.json","build:genver":"gen-version","prettier:fix":"prettier --write . --ignore-path ../../../../.prettierignore","build:compile":"fluid-build . --task compile","ci:build:docs":"api-extractor run","test:coverage":"c8 npm test","typetests:gen":"fluid-type-test-generator","build:commonjs":"fluid-build . --task commonjs","format-and-build":"npm run format && npm run build","typetests:prepare":"flub typetests --dir . --reset --previous --normalize","format-and-compile":"npm run format && npm run build:compile"},"_npmUser":{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},"_resolved":"/mnt/vss/_work/1/pack/scoped/fluid-experimental-devtools-core-2.0.0-dev.7.3.0.207992.tgz","_integrity":"sha512-LhnIBO0MbxIsF2b2lL/RQrpw0ZvheIDcfWvnaihJDcPGsHp+zZWAme9rEhOc5Ceu2SCmFojQ39d2Dn8O9qdmSA==","fluidBuild":{"tasks":{"tsc":["...","typetests:gen"]}},"repository":{"url":"git+https://github.com/microsoft/FluidFramework.git","type":"git","directory":"packages/tools/devtools/devtools-core"},"_npmVersion":"9.6.7","description":"Fluid Framework developer tools core functionality","directories":{},"sideEffects":false,"_nodeVersion":"18.17.1","dependencies":{"@fluidframework/map":"2.0.0-dev.7.3.0.207992","@fluidframework/cell":"2.0.0-dev.7.3.0.207992","@fluidframework/matrix":"2.0.0-dev.7.3.0.207992","@fluidframework/counter":"2.0.0-dev.7.3.0.207992","@fluidframework/sequence":"2.0.0-dev.7.3.0.207992","@fluid-experimental/tree2":"2.0.0-dev.7.3.0.207992","@fluid-internal/client-utils":"2.0.0-dev.7.3.0.207992","@fluidframework/core-interfaces":"2.0.0-dev.7.3.0.207992","@fluidframework/telemetry-utils":"2.0.0-dev.7.3.0.207992","@fluidframework/container-loader":"2.0.0-dev.7.3.0.207992","@fluidframework/shared-object-base":"2.0.0-dev.7.3.0.207992","@fluidframework/protocol-definitions":"^3.0.0","@fluidframework/container-definitions":"2.0.0-dev.7.3.0.207992","@fluidframework/datastore-definitions":"2.0.0-dev.7.3.0.207992"},"_hasShrinkwrap":false,"readmeFilename":"README.md","typeValidation":{"broken":{}},"devDependencies":{"c8":"^7.7.1","chai":"^4.2.0","mocha":"^10.2.0","eslint":"~8.50.0","events":"^3.1.0","moment":"^2.21.0","rimraf":"^4.4.0","prettier":"~3.0.3","cross-env":"^7.0.3","typescript":"~5.1.6","@types/chai":"^4.0.0","@types/mocha":"^9.1.1","@types/events":"^3.0.0","mocha-multi-reporters":"^1.5.1","@fluid-tools/build-cli":"^0.26.1","eslint-config-prettier":"~9.0.0","@microsoft/api-extractor":"^7.37.0","eslint-plugin-chai-expect":"~3.0.0","mocha-json-output-reporter":"^2.0.1","@fluidframework/build-tools":"^0.26.1","@fluidframework/build-common":"^2.0.3","@fluidframework/mocha-test-setup":"2.0.0-dev.7.3.0.207992","@fluidframework/driver-definitions":"2.0.0-dev.7.3.0.207992","@fluidframework/test-runtime-utils":"2.0.0-dev.7.3.0.207992","@fluidframework/eslint-config-fluid":"^3.0.0","@fluid-experimental/devtools-core-previous":"npm:@fluid-experimental/devtools-core@2.0.0-internal.7.2.0"},"_npmOperationalInternal":{"tmp":"tmp/devtools-core_2.0.0-dev.7.3.0.207992_1698953931956_0.2613574168542949","host":"s3://npm-registry-packages"}},"2.0.0-dev.7.3.0.209023":{"name":"@fluid-experimental/devtools-core","version":"2.0.0-dev.7.3.0.209023","author":{"name":"Microsoft and contributors"},"license":"MIT","_id":"@fluid-experimental/devtools-core@2.0.0-dev.7.3.0.209023","maintainers":[{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},{"name":"curtisman","email":"curtism@microsoft.com"}],"homepage":"https://fluidframework.com","bugs":{"url":"https://github.com/microsoft/FluidFramework/issues"},"c8":{"all":true,"exclude":["src/test/**/*.ts","dist/test/**/*.js"],"include":["src/**/*.ts","dist/**/*.js"],"reporter":["cobertura","html","text"],"cache-dir":"nyc/.cache","report-dir":"nyc/report","temp-directory":"nyc/.nyc_output","exclude-after-remap":false},"dist":{"shasum":"1c3261b9b6faebde6f108a45aece3ae3a5ddd364","tarball":"https://registry.npmjs.org/@fluid-experimental/devtools-core/-/devtools-core-2.0.0-dev.7.3.0.209023.tgz","fileCount":505,"integrity":"sha512-xidlNrXRe1K9ywRwUxfAtNEgs3eZvD6Yz5gH7u+d9LfmUWh6i18higzzYM5NA+HB3xS9+ULyqBD/13p8fYbqkg==","signatures":[{"sig":"MEYCIQDbCuZXkrVLp/kAUvJe39XaizYn0+5ZUjwZE9TYC9E+9gIhAPq2Uo1NjF/uFsvfBffyRIADPc6PfGXpAA78g41zue5I","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}],"unpackedSize":1547200},"main":"dist/index.js","_from":"file:fluid-experimental-devtools-core-2.0.0-dev.7.3.0.209023.tgz","types":"dist/index.d.ts","module":"lib/index.js","readme":"# @fluid-experimental/devtools-core\n\nThis library contains developer tools for use alongside the Fluid Framework.\nIt is used to power our associated [browser extension][browser-extension].\n\n- Chrome: \n- Edge: \n\n\n\n\n\n\n## Installation\n\nTo get started, install the package by running the following command:\n\n```bash\nnpm i @fluid-experimental/devtools-core -D\n```\n\n\n\n\n\n## Usage\n\nThe Devtools' API surface is designed to fit nicely into most application flows.\n\n### Initialization\n\nTo initialize a devtools session for your container, call [`initializeDevtools`][initialize-devtools-docs].\nThis function accepts a `DevtoolsLogger` for receiving Fluid telemetry from your application, a list of initial Fluid\n`Containers` to associate with the session, and (optionally) customized data visualization configurations for visualizing\n`Container` data.\n\n#### About the [`DevtoolsLogger`][devtools-logger-docs]\n\nThe `DevtoolsLogger` is an optional piece when calling `initializeDevtools` but it is strongly recommended that you use\nit because several features in Fluid Devtools are powered by the telemetry that Fluid Framework generates, and this\nlogger is the way in which that telemetry gets into Fluid Devtools.\n\nYou can obtain a `DevtoolsLogger` by calling its constructor, and then should pass it to `initializeDevtools` _and_\nto the `Loader` instance you'll use to create/load Containers as shown below.\nThis way the logger will receive all the telemetry generated by Fluid Framework in your application, and forward it to\nFluid Devtools as necessary.\n\n```typescript\nimport { DevtoolsLogger, initializeDevtools } from \"@fluid-experimental/devtools-core\";\n\n// Instantiate the logger\nconst devtoolsLogger = new DevtoolsLogger();\n\n// Pass the logger when instantiating the Loader\nconst loader = new Loader({\n\tlogger: devtoolsLogger,\n\t// Other necessary properties ...\n});\n\n// Use the Loader to create (and optionally, attach) a Container\nconst container = await loader.createDetachedContainer(/* params */);\nawait container.attach(/* params */);\n\n// Initialize the Devtools passing the logger and your Container.\n// The Container could be added later as well with devtools.registerContainerDevtools().\nconst devtools = initializeDevtools({\n\tlogger: devtoolsLogger,\n\tinitialContainers: [\n\t\t{\n\t\t\tcontainer,\n\t\t\tcontainerKey: \"My Container\",\n\t\t},\n\t],\n});\n```\n\nIf you're working with `AzureClient` instead of lower-level APIs like the one described above, you probably want to\nrefer to the [@fluid-experimental/devtools package][devtools-package] instead of this one.\n\nDuring local development the recommendation is that your application should receive the `DevtoolsLogger` instance _instead_\nof any logger it would normally receive when deployed to a real environment, to avoid local development activity from\nmixing with real telemetry.\nIf you still want to provide a real application logger and use the Fluid Devtools features that are powered by telemetry\nat the same time, you can pass an existing logger to the `DevtoolsLogger` constructor and it will forward all telemetry\nit receives to that logger as well:\n\n```typescript\nimport { DevtoolsLogger } from \"@fluid-experimental/devtools-core\";\n\n// Your application's logger\nconst yourApplicationLogger = getInstanceOfYourApplicationLogger();\n\nconst devtoolsLogger = new DevtoolsLogger(yourApplicationLogger);\n\n// Pass devtoolsLogger to initializeDevtools() and to your application as described above\n```\n\n### Clean-up\n\nThe Devtools object is managed as a global singleton.\nThat singleton is automatically cleaned up prior to the Window's \"unload\" event.\nSo typical application flows likely won't need to worry about cleanup.\nThat said, if you wish to have tighter control over when the Devtools are torn down, you can simply call the `dispose` method on the handle returned by [initialization](#initialization).\n\n## Contributing to the package\n\n### Build\n\nTo build the package locally, first ensure you have run `pnpm install` from the root of the mono-repo.\nNext, to build the code, run `npm run build` from the root of the mono-repo, or use [fluid-build](https://github.com/microsoft/FluidFramework/tree/main/build-tools/packages/build-tools#running-fluid-build-command-line) via `fluid-build -t build`.\n\n- Note: Once you have run a build from the root, assuming no other changes outside of this package, you may run `npm run build` directly within this directory for a faster build.\n If you make changes to any of this package's local dependencies, you will need to run a build again from the root before building again from directly within this package.\n\n### Test\n\nTo run the tests, first ensure you have followed the [build](#build) steps above.\nNext, run `npm run test` from a terminal within this directory.\n\n\n\n\n\n\n\n## API Documentation\n\nAPI documentation for **@fluid-experimental/devtools-core** is available at .\n\n\n\n\n\n\n\n\n\n\n## Contribution Guidelines\n\nThere are many ways to [contribute](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md) to Fluid.\n\n- Participate in Q&A in our [GitHub Discussions](https://github.com/microsoft/FluidFramework/discussions).\n- [Submit bugs](https://github.com/microsoft/FluidFramework/issues) and help us verify fixes as they are checked in.\n- Review the [source code changes](https://github.com/microsoft/FluidFramework/pulls).\n- [Contribute bug fixes](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md).\n\nDetailed instructions for working in the repo can be found in the [Wiki](https://github.com/microsoft/FluidFramework/wiki).\n\nThis project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).\nFor more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\nUse of these trademarks or logos must follow Microsoft’s [Trademark & Brand Guidelines](https://www.microsoft.com/trademarks).\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n\n\n\n## Help\n\nNot finding what you're looking for in this README? Check out our [GitHub\nWiki](https://github.com/microsoft/FluidFramework/wiki) or [fluidframework.com](https://fluidframework.com/docs/).\n\nStill not finding what you're looking for? Please [file an\nissue](https://github.com/microsoft/FluidFramework/wiki/Submitting-Bugs-and-Feature-Requests).\n\nThank you!\n\n\n\n\n\n\n\n\n\n\n## Trademark\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\n\nUse of these trademarks or logos must follow Microsoft's [Trademark & Brand\nGuidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general).\n\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n[initialize-devtools-docs]: https://fluidframework.com/docs/apis/devtools-core#initializedevtools-function\n[devtools-logger-docs]: https://fluidframework.com/docs/apis/devtools-core/devtoolslogger-class\n[devtools-package]: https://www.npmjs.com/package/@fluid-experimental/devtools\n[browser-extension]: https://github.com/microsoft/FluidFramework/tree/main/packages/tools/devtools/devtools-browser-extension\n","scripts":{"tsc":"tsc","lint":"npm run prettier && npm run eslint","test":"npm run test:mocha","build":"fluid-build . --task build","clean":"rimraf --glob _api-extractor-temp nyc dist lib \"*.tsbuildinfo\" \"*.build.log\"","eslint":"eslint src","format":"npm run prettier:fix","rebuild":"npm run clean && npm run build","lint:fix":"npm run prettier:fix && npm run eslint:fix","prettier":"prettier --check . --ignore-path ../../../../.prettierignore","tsc:watch":"tsc --watch","build:docs":"api-extractor run --local","eslint:fix":"eslint src --fix","test:mocha":"mocha \"dist/**/*.test.js\" --exit","build:esnext":"tsc --project ./tsconfig.esnext.json","build:genver":"gen-version","prettier:fix":"prettier --write . --ignore-path ../../../../.prettierignore","build:compile":"fluid-build . --task compile","ci:build:docs":"api-extractor run","test:coverage":"c8 npm test","typetests:gen":"fluid-type-test-generator","build:commonjs":"fluid-build . --task commonjs","format-and-build":"npm run format && npm run build","typetests:prepare":"flub typetests --dir . --reset --previous --normalize","format-and-compile":"npm run format && npm run build:compile"},"_npmUser":{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},"_resolved":"/mnt/vss/_work/1/pack/scoped/fluid-experimental-devtools-core-2.0.0-dev.7.3.0.209023.tgz","_integrity":"sha512-xidlNrXRe1K9ywRwUxfAtNEgs3eZvD6Yz5gH7u+d9LfmUWh6i18higzzYM5NA+HB3xS9+ULyqBD/13p8fYbqkg==","fluidBuild":{"tasks":{"tsc":["...","typetests:gen"]}},"repository":{"url":"git+https://github.com/microsoft/FluidFramework.git","type":"git","directory":"packages/tools/devtools/devtools-core"},"_npmVersion":"9.6.7","description":"Fluid Framework developer tools core functionality","directories":{},"sideEffects":false,"_nodeVersion":"18.17.1","dependencies":{"@fluidframework/map":"2.0.0-dev.7.3.0.209023","@fluidframework/cell":"2.0.0-dev.7.3.0.209023","@fluidframework/matrix":"2.0.0-dev.7.3.0.209023","@fluidframework/counter":"2.0.0-dev.7.3.0.209023","@fluidframework/sequence":"2.0.0-dev.7.3.0.209023","@fluid-experimental/tree2":"2.0.0-dev.7.3.0.209023","@fluid-internal/client-utils":"2.0.0-dev.7.3.0.209023","@fluidframework/core-interfaces":"2.0.0-dev.7.3.0.209023","@fluidframework/telemetry-utils":"2.0.0-dev.7.3.0.209023","@fluidframework/container-loader":"2.0.0-dev.7.3.0.209023","@fluidframework/shared-object-base":"2.0.0-dev.7.3.0.209023","@fluidframework/protocol-definitions":"^3.0.0","@fluidframework/container-definitions":"2.0.0-dev.7.3.0.209023","@fluidframework/datastore-definitions":"2.0.0-dev.7.3.0.209023"},"_hasShrinkwrap":false,"readmeFilename":"README.md","typeValidation":{"broken":{}},"devDependencies":{"c8":"^7.7.1","chai":"^4.2.0","mocha":"^10.2.0","eslint":"~8.50.0","events":"^3.1.0","moment":"^2.21.0","rimraf":"^4.4.0","prettier":"~3.0.3","cross-env":"^7.0.3","typescript":"~5.1.6","@types/chai":"^4.0.0","@types/mocha":"^9.1.1","@types/events":"^3.0.0","mocha-multi-reporters":"^1.5.1","@fluid-tools/build-cli":"^0.26.1","eslint-config-prettier":"~9.0.0","@microsoft/api-extractor":"^7.37.0","eslint-plugin-chai-expect":"~3.0.0","mocha-json-output-reporter":"^2.0.1","@fluidframework/build-tools":"^0.26.1","@fluidframework/build-common":"^2.0.3","@fluidframework/mocha-test-setup":"2.0.0-dev.7.3.0.209023","@fluidframework/driver-definitions":"2.0.0-dev.7.3.0.209023","@fluidframework/test-runtime-utils":"2.0.0-dev.7.3.0.209023","@fluidframework/eslint-config-fluid":"^3.1.0","@fluid-experimental/devtools-core-previous":"npm:@fluid-experimental/devtools-core@2.0.0-internal.7.2.0"},"_npmOperationalInternal":{"tmp":"tmp/devtools-core_2.0.0-dev.7.3.0.209023_1699394193915_0.9765580945745249","host":"s3://npm-registry-packages"}},"2.0.0-internal.7.2.2":{"name":"@fluid-experimental/devtools-core","version":"2.0.0-internal.7.2.2","author":{"name":"Microsoft and contributors"},"license":"MIT","_id":"@fluid-experimental/devtools-core@2.0.0-internal.7.2.2","maintainers":[{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},{"name":"curtisman","email":"curtism@microsoft.com"}],"homepage":"https://fluidframework.com","bugs":{"url":"https://github.com/microsoft/FluidFramework/issues"},"c8":{"all":true,"exclude":["src/test/**/*.ts","dist/test/**/*.js"],"include":["src/**/*.ts","dist/**/*.js"],"reporter":["cobertura","html","text"],"cache-dir":"nyc/.cache","report-dir":"nyc/report","temp-directory":"nyc/.nyc_output","exclude-after-remap":false},"dist":{"shasum":"14b04f1804aa08614990f42487c6fc85b26e32b9","tarball":"https://registry.npmjs.org/@fluid-experimental/devtools-core/-/devtools-core-2.0.0-internal.7.2.2.tgz","fileCount":505,"integrity":"sha512-Hdn3z7Qi9pdoFI/j9QVUiU6fXiuGvkCjFynihnwtPYYzwHqk5KqDulZNztmHWEbSuUXMYGLTVE7wClBTmvGU/w==","signatures":[{"sig":"MEQCIFeYAytYumfcvsChw0NESJ8XtWf1kBUKjfIRAjc9HQSwAiBj0DBRlj950eeJ6OAoc7EU/xOjeb0cAx41FtrEJN2oLA==","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}],"unpackedSize":1468086},"main":"dist/index.js","_from":"file:fluid-experimental-devtools-core-2.0.0-internal.7.2.2.tgz","types":"dist/index.d.ts","module":"lib/index.js","readme":"# @fluid-experimental/devtools-core\n\nThis library contains developer tools for use alongside the Fluid Framework.\nIt is used to power our associated [browser extension][browser-extension].\n\n- Chrome: \n- Edge: \n\n\n\n\n\n\n## Installation\n\nTo get started, install the package by running the following command:\n\n```bash\nnpm i @fluid-experimental/devtools-core -D\n```\n\n\n\n\n\n## Usage\n\nThe Devtools' API surface is designed to fit nicely into most application flows.\n\n### Initialization\n\nTo initialize a devtools session for your container, call [`initializeDevtools`][initialize-devtools-docs].\nThis function accepts a `DevtoolsLogger` for receiving Fluid telemetry from your application, a list of initial Fluid\n`Containers` to associate with the session, and (optionally) customized data visualization configurations for visualizing\n`Container` data.\n\n#### About the [`DevtoolsLogger`][devtools-logger-docs]\n\nThe `DevtoolsLogger` is an optional piece when calling `initializeDevtools` but it is strongly recommended that you use\nit because several features in Fluid Devtools are powered by the telemetry that Fluid Framework generates, and this\nlogger is the way in which that telemetry gets into Fluid Devtools.\n\nYou can obtain a `DevtoolsLogger` by calling its constructor, and then should pass it to `initializeDevtools` _and_\nto the `Loader` instance you'll use to create/load Containers as shown below.\nThis way the logger will receive all the telemetry generated by Fluid Framework in your application, and forward it to\nFluid Devtools as necessary.\n\n```typescript\nimport { DevtoolsLogger, initializeDevtools } from \"@fluid-experimental/devtools-core\";\n\n// Instantiate the logger\nconst devtoolsLogger = new DevtoolsLogger();\n\n// Pass the logger when instantiating the Loader\nconst loader = new Loader({\n\tlogger: devtoolsLogger,\n\t// Other necessary properties ...\n});\n\n// Use the Loader to create (and optionally, attach) a Container\nconst container = await loader.createDetachedContainer(/* params */);\nawait container.attach(/* params */);\n\n// Initialize the Devtools passing the logger and your Container.\n// The Container could be added later as well with devtools.registerContainerDevtools().\nconst devtools = initializeDevtools({\n\tlogger: devtoolsLogger,\n\tinitialContainers: [\n\t\t{\n\t\t\tcontainer,\n\t\t\tcontainerKey: \"My Container\",\n\t\t},\n\t],\n});\n```\n\nIf you're working with `AzureClient` instead of lower-level APIs like the one described above, you probably want to\nrefer to the [@fluid-experimental/devtools package][devtools-package] instead of this one.\n\nDuring local development the recommendation is that your application should receive the `DevtoolsLogger` instance _instead_\nof any logger it would normally receive when deployed to a real environment, to avoid local development activity from\nmixing with real telemetry.\nIf you still want to provide a real application logger and use the Fluid Devtools features that are powered by telemetry\nat the same time, you can pass an existing logger to the `DevtoolsLogger` constructor and it will forward all telemetry\nit receives to that logger as well:\n\n```typescript\nimport { DevtoolsLogger } from \"@fluid-experimental/devtools-core\";\n\n// Your application's logger\nconst yourApplicationLogger = getInstanceOfYourApplicationLogger();\n\nconst devtoolsLogger = new DevtoolsLogger(yourApplicationLogger);\n\n// Pass devtoolsLogger to initializeDevtools() and to your application as described above\n```\n\n### Clean-up\n\nThe Devtools object is managed as a global singleton.\nThat singleton is automatically cleaned up prior to the Window's \"unload\" event.\nSo typical application flows likely won't need to worry about cleanup.\nThat said, if you wish to have tighter control over when the Devtools are torn down, you can simply call the `dispose` method on the handle returned by [initialization](#initialization).\n\n## Contributing to the package\n\n### Build\n\nTo build the package locally, first ensure you have run `pnpm install` from the root of the mono-repo.\nNext, to build the code, run `npm run build` from the root of the mono-repo, or use [fluid-build](https://github.com/microsoft/FluidFramework/tree/main/build-tools/packages/build-tools#running-fluid-build-command-line) via `fluid-build -t build`.\n\n- Note: Once you have run a build from the root, assuming no other changes outside of this package, you may run `npm run build` directly within this directory for a faster build.\n If you make changes to any of this package's local dependencies, you will need to run a build again from the root before building again from directly within this package.\n\n### Test\n\nTo run the tests, first ensure you have followed the [build](#build) steps above.\nNext, run `npm run test` from a terminal within this directory.\n\n\n\n\n\n\n\n## API Documentation\n\nAPI documentation for **@fluid-experimental/devtools-core** is available at .\n\n\n\n\n\n\n\n\n\n\n## Contribution Guidelines\n\nThere are many ways to [contribute](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md) to Fluid.\n\n- Participate in Q&A in our [GitHub Discussions](https://github.com/microsoft/FluidFramework/discussions).\n- [Submit bugs](https://github.com/microsoft/FluidFramework/issues) and help us verify fixes as they are checked in.\n- Review the [source code changes](https://github.com/microsoft/FluidFramework/pulls).\n- [Contribute bug fixes](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md).\n\nDetailed instructions for working in the repo can be found in the [Wiki](https://github.com/microsoft/FluidFramework/wiki).\n\nThis project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).\nFor more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\nUse of these trademarks or logos must follow Microsoft’s [Trademark & Brand Guidelines](https://www.microsoft.com/trademarks).\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n\n\n\n## Help\n\nNot finding what you're looking for in this README? Check out our [GitHub\nWiki](https://github.com/microsoft/FluidFramework/wiki) or [fluidframework.com](https://fluidframework.com/docs/).\n\nStill not finding what you're looking for? Please [file an\nissue](https://github.com/microsoft/FluidFramework/wiki/Submitting-Bugs-and-Feature-Requests).\n\nThank you!\n\n\n\n\n\n\n\n\n\n\n## Trademark\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\n\nUse of these trademarks or logos must follow Microsoft's [Trademark & Brand\nGuidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general).\n\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n[initialize-devtools-docs]: https://fluidframework.com/docs/apis/devtools-core#initializedevtools-function\n[devtools-logger-docs]: https://fluidframework.com/docs/apis/devtools-core/devtoolslogger-class\n[devtools-package]: https://www.npmjs.com/package/@fluid-experimental/devtools\n[browser-extension]: https://github.com/microsoft/FluidFramework/tree/main/packages/tools/devtools/devtools-browser-extension\n","scripts":{"tsc":"tsc","lint":"npm run prettier && npm run eslint","test":"npm run test:mocha","build":"fluid-build . --task build","clean":"rimraf --glob _api-extractor-temp nyc dist lib \"*.tsbuildinfo\" \"*.build.log\"","eslint":"eslint src","format":"npm run prettier:fix","rebuild":"npm run clean && npm run build","lint:fix":"npm run prettier:fix && npm run eslint:fix","prettier":"prettier --check . --ignore-path ../../../../.prettierignore","tsc:watch":"tsc --watch","build:docs":"api-extractor run --local","eslint:fix":"eslint src --fix","test:mocha":"mocha dist/**/*.test.js --exit","build:esnext":"tsc --project ./tsconfig.esnext.json","build:genver":"gen-version","prettier:fix":"prettier --write . --ignore-path ../../../../.prettierignore","build:compile":"fluid-build . --task compile","ci:build:docs":"api-extractor run","test:coverage":"c8 npm test","typetests:gen":"fluid-type-test-generator","build:commonjs":"fluid-build . --task commonjs","format-and-build":"npm run format && npm run build","typetests:prepare":"flub typetests --dir . --reset --previous --normalize","format-and-compile":"npm run format && npm run build:compile"},"_npmUser":{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},"_resolved":"/mnt/vss/_work/1/pack/scoped/fluid-experimental-devtools-core-2.0.0-internal.7.2.2.tgz","_integrity":"sha512-Hdn3z7Qi9pdoFI/j9QVUiU6fXiuGvkCjFynihnwtPYYzwHqk5KqDulZNztmHWEbSuUXMYGLTVE7wClBTmvGU/w==","fluidBuild":{"tasks":{"tsc":["...","typetests:gen"]}},"repository":{"url":"git+https://github.com/microsoft/FluidFramework.git","type":"git","directory":"packages/tools/devtools/devtools-core"},"_npmVersion":"9.6.7","description":"Fluid Framework developer tools core functionality","directories":{},"sideEffects":false,"_nodeVersion":"18.17.1","dependencies":{"@fluidframework/map":">=2.0.0-internal.7.2.2 <2.0.0-internal.7.3.0","@fluidframework/cell":">=2.0.0-internal.7.2.2 <2.0.0-internal.7.3.0","@fluidframework/matrix":">=2.0.0-internal.7.2.2 <2.0.0-internal.7.3.0","@fluidframework/counter":">=2.0.0-internal.7.2.2 <2.0.0-internal.7.3.0","@fluidframework/sequence":">=2.0.0-internal.7.2.2 <2.0.0-internal.7.3.0","@fluid-experimental/tree2":">=2.0.0-internal.7.2.2 <2.0.0-internal.7.3.0","@fluid-internal/client-utils":">=2.0.0-internal.7.2.2 <2.0.0-internal.7.3.0","@fluidframework/core-interfaces":">=2.0.0-internal.7.2.2 <2.0.0-internal.7.3.0","@fluidframework/telemetry-utils":">=2.0.0-internal.7.2.2 <2.0.0-internal.7.3.0","@fluidframework/container-loader":">=2.0.0-internal.7.2.2 <2.0.0-internal.7.3.0","@fluidframework/shared-object-base":">=2.0.0-internal.7.2.2 <2.0.0-internal.7.3.0","@fluidframework/protocol-definitions":"^3.0.0","@fluidframework/container-definitions":">=2.0.0-internal.7.2.2 <2.0.0-internal.7.3.0","@fluidframework/datastore-definitions":">=2.0.0-internal.7.2.2 <2.0.0-internal.7.3.0"},"_hasShrinkwrap":false,"readmeFilename":"README.md","typeValidation":{"broken":{}},"devDependencies":{"c8":"^7.7.1","chai":"^4.2.0","mocha":"^10.2.0","eslint":"~8.50.0","events":"^3.1.0","moment":"^2.21.0","rimraf":"^4.4.0","prettier":"~3.0.3","cross-env":"^7.0.3","typescript":"~5.1.6","@types/chai":"^4.0.0","@types/mocha":"^9.1.1","@types/events":"^3.0.0","mocha-multi-reporters":"^1.5.1","@fluid-tools/build-cli":"^0.26.1","eslint-config-prettier":"~9.0.0","@microsoft/api-extractor":"^7.37.0","eslint-plugin-chai-expect":"~3.0.0","mocha-json-output-reporter":"^2.0.1","@fluidframework/build-tools":"^0.26.1","@fluidframework/build-common":"^2.0.3","@fluidframework/mocha-test-setup":">=2.0.0-internal.7.2.2 <2.0.0-internal.7.3.0","@fluidframework/driver-definitions":">=2.0.0-internal.7.2.2 <2.0.0-internal.7.3.0","@fluidframework/test-runtime-utils":">=2.0.0-internal.7.2.2 <2.0.0-internal.7.3.0","@fluidframework/eslint-config-fluid":"^3.0.0","@fluid-experimental/devtools-core-previous":"npm:@fluid-experimental/devtools-core@2.0.0-internal.7.2.1"},"_npmOperationalInternal":{"tmp":"tmp/devtools-core_2.0.0-internal.7.2.2_1699394794565_0.15364784185590108","host":"s3://npm-registry-packages"}},"2.0.0-internal.7.1.2":{"name":"@fluid-experimental/devtools-core","version":"2.0.0-internal.7.1.2","author":{"name":"Microsoft and contributors"},"license":"MIT","_id":"@fluid-experimental/devtools-core@2.0.0-internal.7.1.2","maintainers":[{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},{"name":"curtisman","email":"curtism@microsoft.com"}],"homepage":"https://fluidframework.com","bugs":{"url":"https://github.com/microsoft/FluidFramework/issues"},"c8":{"all":true,"exclude":["src/test/**/*.ts","dist/test/**/*.js"],"include":["src/**/*.ts","dist/**/*.js"],"reporter":["cobertura","html","text"],"cache-dir":"nyc/.cache","report-dir":"nyc/report","temp-directory":"nyc/.nyc_output","exclude-after-remap":false},"dist":{"shasum":"51c8c8121ea574329fb685cc90cbfa167c7542c1","tarball":"https://registry.npmjs.org/@fluid-experimental/devtools-core/-/devtools-core-2.0.0-internal.7.1.2.tgz","fileCount":505,"integrity":"sha512-Dqnn3exTUjgiaX8Yxz3a3nfdapp03IVoj1JWPP9L9cRaZcrklkXxYr3u439r7js3FXTYKjRAWYVOqxkHPWPDkw==","signatures":[{"sig":"MEQCICGX8loyp+h3ytCSA9PZ2P32wiUCBHwes2CCnjm78jWrAiBP9W4RcXrnow93GJm1PCiy/E2lbBF6s6ukjDJL/suwzw==","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}],"unpackedSize":1468034},"main":"dist/index.js","_from":"file:fluid-experimental-devtools-core-2.0.0-internal.7.1.2.tgz","types":"dist/index.d.ts","module":"lib/index.js","readme":"# @fluid-experimental/devtools-core\n\nThis library contains developer tools for use alongside the Fluid Framework.\nIt is used to power our associated [browser extension][browser-extension].\n\n- Chrome: \n- Edge: \n\n\n\n\n\n\n## Installation\n\nTo get started, install the package by running the following command:\n\n```bash\nnpm i @fluid-experimental/devtools-core -D\n```\n\n\n\n\n\n## Usage\n\nThe Devtools' API surface is designed to fit nicely into most application flows.\n\n### Initialization\n\nTo initialize a devtools session for your container, call [`initializeDevtools`][initialize-devtools-docs].\nThis function accepts a `DevtoolsLogger` for receiving Fluid telemetry from your application, a list of initial Fluid\n`Containers` to associate with the session, and (optionally) customized data visualization configurations for visualizing\n`Container` data.\n\n#### About the [`DevtoolsLogger`][devtools-logger-docs]\n\nThe `DevtoolsLogger` is an optional piece when calling `initializeDevtools` but it is strongly recommended that you use\nit because several features in Fluid Devtools are powered by the telemetry that Fluid Framework generates, and this\nlogger is the way in which that telemetry gets into Fluid Devtools.\n\nYou can obtain a `DevtoolsLogger` by calling its constructor, and then should pass it to `initializeDevtools` _and_\nto the `Loader` instance you'll use to create/load Containers as shown below.\nThis way the logger will receive all the telemetry generated by Fluid Framework in your application, and forward it to\nFluid Devtools as necessary.\n\n```typescript\nimport { DevtoolsLogger, initializeDevtools } from \"@fluid-experimental/devtools-core\";\n\n// Instantiate the logger\nconst devtoolsLogger = new DevtoolsLogger();\n\n// Pass the logger when instantiating the Loader\nconst loader = new Loader({\n\tlogger: devtoolsLogger,\n\t// Other necessary properties ...\n});\n\n// Use the Loader to create (and optionally, attach) a Container\nconst container = await loader.createDetachedContainer(/* params */);\nawait container.attach(/* params */);\n\n// Initialize the Devtools passing the logger and your Container.\n// The Container could be added later as well with devtools.registerContainerDevtools().\nconst devtools = initializeDevtools({\n\tlogger: devtoolsLogger,\n\tinitialContainers: [\n\t\t{\n\t\t\tcontainer,\n\t\t\tcontainerKey: \"My Container\",\n\t\t},\n\t],\n});\n```\n\nIf you're working with `AzureClient` instead of lower-level APIs like the one described above, you probably want to\nrefer to the [@fluid-experimental/devtools package][devtools-package] instead of this one.\n\nDuring local development the recommendation is that your application should receive the `DevtoolsLogger` instance _instead_\nof any logger it would normally receive when deployed to a real environment, to avoid local development activity from\nmixing with real telemetry.\nIf you still want to provide a real application logger and use the Fluid Devtools features that are powered by telemetry\nat the same time, you can pass an existing logger to the `DevtoolsLogger` constructor and it will forward all telemetry\nit receives to that logger as well:\n\n```typescript\nimport { DevtoolsLogger } from \"@fluid-experimental/devtools-core\";\n\n// Your application's logger\nconst yourApplicationLogger = getInstanceOfYourApplicationLogger();\n\nconst devtoolsLogger = new DevtoolsLogger(yourApplicationLogger);\n\n// Pass devtoolsLogger to initializeDevtools() and to your application as described above\n```\n\n### Clean-up\n\nThe Devtools object is managed as a global singleton.\nThat singleton is automatically cleaned up prior to the Window's \"unload\" event.\nSo typical application flows likely won't need to worry about cleanup.\nThat said, if you wish to have tighter control over when the Devtools are torn down, you can simply call the `dispose` method on the handle returned by [initialization](#initialization).\n\n## Contributing to the package\n\n### Build\n\nTo build the package locally, first ensure you have run `pnpm install` from the root of the mono-repo.\nNext, to build the code, run `npm run build` from the root of the mono-repo, or use [fluid-build](https://github.com/microsoft/FluidFramework/tree/main/build-tools/packages/build-tools#running-fluid-build-command-line) via `fluid-build -t build`.\n\n- Note: Once you have run a build from the root, assuming no other changes outside of this package, you may run `npm run build` directly within this directory for a faster build.\n If you make changes to any of this package's local dependencies, you will need to run a build again from the root before building again from directly within this package.\n\n### Test\n\nTo run the tests, first ensure you have followed the [build](#build) steps above.\nNext, run `npm run test` from a terminal within this directory.\n\n\n\n\n\n\n\n## API Documentation\n\nAPI documentation for **@fluid-experimental/devtools-core** is available at .\n\n\n\n\n\n\n\n\n\n\n## Contribution Guidelines\n\nThere are many ways to [contribute](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md) to Fluid.\n\n- Participate in Q&A in our [GitHub Discussions](https://github.com/microsoft/FluidFramework/discussions).\n- [Submit bugs](https://github.com/microsoft/FluidFramework/issues) and help us verify fixes as they are checked in.\n- Review the [source code changes](https://github.com/microsoft/FluidFramework/pulls).\n- [Contribute bug fixes](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md).\n\nDetailed instructions for working in the repo can be found in the [Wiki](https://github.com/microsoft/FluidFramework/wiki).\n\nThis project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).\nFor more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\nUse of these trademarks or logos must follow Microsoft’s [Trademark & Brand Guidelines](https://www.microsoft.com/trademarks).\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n\n\n\n## Help\n\nNot finding what you're looking for in this README? Check out our [GitHub\nWiki](https://github.com/microsoft/FluidFramework/wiki) or [fluidframework.com](https://fluidframework.com/docs/).\n\nStill not finding what you're looking for? Please [file an\nissue](https://github.com/microsoft/FluidFramework/wiki/Submitting-Bugs-and-Feature-Requests).\n\nThank you!\n\n\n\n\n\n\n\n\n\n\n## Trademark\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\n\nUse of these trademarks or logos must follow Microsoft's [Trademark & Brand\nGuidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general).\n\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n[initialize-devtools-docs]: https://fluidframework.com/docs/apis/devtools-core#initializedevtools-function\n[devtools-logger-docs]: https://fluidframework.com/docs/apis/devtools-core/devtoolslogger-class\n[devtools-package]: https://www.npmjs.com/package/@fluid-experimental/devtools\n[browser-extension]: https://github.com/microsoft/FluidFramework/tree/main/packages/tools/devtools/devtools-browser-extension\n","scripts":{"tsc":"tsc","lint":"npm run prettier && npm run eslint","test":"npm run test:mocha","build":"fluid-build . --task build","clean":"rimraf --glob '_api-extractor-temp' 'nyc' 'dist' 'lib' '*.tsbuildinfo' '*.build.log'","eslint":"eslint src","format":"npm run prettier:fix","rebuild":"npm run clean && npm run build","lint:fix":"npm run prettier:fix && npm run eslint:fix","prettier":"prettier --check . --ignore-path ../../../../.prettierignore","tsc:watch":"tsc --watch","build:docs":"api-extractor run --local","eslint:fix":"eslint src --fix","test:mocha":"mocha dist/**/*.test.js --exit","build:esnext":"tsc --project ./tsconfig.esnext.json","build:genver":"gen-version","prettier:fix":"prettier --write . --ignore-path ../../../../.prettierignore","build:compile":"fluid-build . --task compile","ci:build:docs":"api-extractor run","test:coverage":"c8 npm test","typetests:gen":"fluid-type-test-generator","build:commonjs":"fluid-build . --task commonjs","format-and-build":"npm run format && npm run build","typetests:prepare":"flub typetests --dir . --reset --previous --normalize","format-and-compile":"npm run format && npm run build:compile"},"_npmUser":{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},"_resolved":"/mnt/vss/_work/1/pack/scoped/fluid-experimental-devtools-core-2.0.0-internal.7.1.2.tgz","_integrity":"sha512-Dqnn3exTUjgiaX8Yxz3a3nfdapp03IVoj1JWPP9L9cRaZcrklkXxYr3u439r7js3FXTYKjRAWYVOqxkHPWPDkw==","fluidBuild":{"tasks":{"tsc":["...","typetests:gen"]}},"repository":{"url":"git+https://github.com/microsoft/FluidFramework.git","type":"git","directory":"packages/tools/devtools/devtools-core"},"_npmVersion":"9.6.7","description":"Fluid Framework developer tools core functionality","directories":{},"sideEffects":false,"_nodeVersion":"18.17.1","dependencies":{"@fluidframework/map":">=2.0.0-internal.7.1.2 <2.0.0-internal.7.2.0","@fluidframework/cell":">=2.0.0-internal.7.1.2 <2.0.0-internal.7.2.0","@fluidframework/matrix":">=2.0.0-internal.7.1.2 <2.0.0-internal.7.2.0","@fluidframework/counter":">=2.0.0-internal.7.1.2 <2.0.0-internal.7.2.0","@fluidframework/sequence":">=2.0.0-internal.7.1.2 <2.0.0-internal.7.2.0","@fluid-experimental/tree2":">=2.0.0-internal.7.1.2 <2.0.0-internal.7.2.0","@fluid-internal/client-utils":">=2.0.0-internal.7.1.2 <2.0.0-internal.7.2.0","@fluidframework/core-interfaces":">=2.0.0-internal.7.1.2 <2.0.0-internal.7.2.0","@fluidframework/telemetry-utils":">=2.0.0-internal.7.1.2 <2.0.0-internal.7.2.0","@fluidframework/container-loader":">=2.0.0-internal.7.1.2 <2.0.0-internal.7.2.0","@fluidframework/shared-object-base":">=2.0.0-internal.7.1.2 <2.0.0-internal.7.2.0","@fluidframework/protocol-definitions":"^3.0.0","@fluidframework/container-definitions":">=2.0.0-internal.7.1.2 <2.0.0-internal.7.2.0","@fluidframework/datastore-definitions":">=2.0.0-internal.7.1.2 <2.0.0-internal.7.2.0"},"_hasShrinkwrap":false,"readmeFilename":"README.md","typeValidation":{"broken":{}},"devDependencies":{"c8":"^7.7.1","chai":"^4.2.0","mocha":"^10.2.0","eslint":"~8.50.0","events":"^3.1.0","moment":"^2.21.0","rimraf":"^4.4.0","prettier":"~3.0.3","copyfiles":"^2.4.1","cross-env":"^7.0.3","typescript":"~5.1.6","@types/chai":"^4.0.0","@types/mocha":"^9.1.1","@types/events":"^3.0.0","mocha-multi-reporters":"^1.5.1","@fluid-tools/build-cli":"^0.25.0","eslint-config-prettier":"~9.0.0","@microsoft/api-extractor":"^7.37.0","eslint-plugin-chai-expect":"~3.0.0","mocha-json-output-reporter":"^2.0.1","@fluidframework/build-tools":"^0.25.0","@fluidframework/build-common":"^2.0.1","@fluidframework/mocha-test-setup":">=2.0.0-internal.7.1.2 <2.0.0-internal.7.2.0","@fluidframework/driver-definitions":">=2.0.0-internal.7.1.2 <2.0.0-internal.7.2.0","@fluidframework/test-runtime-utils":">=2.0.0-internal.7.1.2 <2.0.0-internal.7.2.0","@fluidframework/eslint-config-fluid":"^3.0.0","@fluid-experimental/devtools-core-previous":"npm:@fluid-experimental/devtools-core@2.0.0-internal.7.1.0"},"_npmOperationalInternal":{"tmp":"tmp/devtools-core_2.0.0-internal.7.1.2_1699395051070_0.05704295091461087","host":"s3://npm-registry-packages"}},"2.0.0-internal.7.0.2":{"name":"@fluid-experimental/devtools-core","version":"2.0.0-internal.7.0.2","author":{"name":"Microsoft and contributors"},"license":"MIT","_id":"@fluid-experimental/devtools-core@2.0.0-internal.7.0.2","maintainers":[{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},{"name":"curtisman","email":"curtism@microsoft.com"}],"homepage":"https://fluidframework.com","bugs":{"url":"https://github.com/microsoft/FluidFramework/issues"},"c8":{"all":true,"exclude":["src/test/**/*.ts","dist/test/**/*.js"],"include":["src/**/*.ts","dist/**/*.js"],"reporter":["cobertura","html","text"],"cache-dir":"nyc/.cache","report-dir":"nyc/report","temp-directory":"nyc/.nyc_output","exclude-after-remap":false},"dist":{"shasum":"955479b0abd7243e3f64a4f14bb80e79a6f2a6bb","tarball":"https://registry.npmjs.org/@fluid-experimental/devtools-core/-/devtools-core-2.0.0-internal.7.0.2.tgz","fileCount":501,"integrity":"sha512-3lK2w6V6qdiG/xJRxuKM94xDN/RxviakUCgybBueanll0E9kzhl13MQW+W/WmiA6y04UyaGA8Nyk5yvlU7tB1w==","signatures":[{"sig":"MEYCIQDrTuixG/xbcGBenJofGfEF9aIcOqvbOtR2PPs1Zt1F1QIhAORFRiNYja1qPqP6ROOmhZzfdfITUJmCM9VoCX5kfPue","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}],"unpackedSize":1378772},"main":"dist/index.js","_from":"file:fluid-experimental-devtools-core-2.0.0-internal.7.0.2.tgz","types":"dist/index.d.ts","module":"lib/index.js","readme":"# @fluid-experimental/devtools-core\n\nThis library contains developer tools for use alongside the Fluid Framework.\nIt is used to power our associated [browser extension][browser-extension].\n\n- Chrome: \n- Edge: \n\n\n\n\n\n\n## Installation\n\nTo get started, install the package by running the following command:\n\n```bash\nnpm i @fluid-experimental/devtools-core -D\n```\n\n\n\n\n\n## Usage\n\nThe Devtools' API surface is designed to fit nicely into most application flows.\n\n### Initialization\n\nTo initialize a devtools session for your container, call [`initializeDevtools`][initialize-devtools-docs].\nThis function accepts a `DevtoolsLogger` for receiving Fluid telemetry from your application, a list of initial Fluid\n`Containers` to associate with the session, and (optionally) customized data visualization configurations for visualizing\n`Container` data.\n\n#### About the [`DevtoolsLogger`][devtools-logger-docs]\n\nThe `DevtoolsLogger` is an optional piece when calling `initializeDevtools` but it is strongly recommended that you use\nit because several features in Fluid Devtools are powered by the telemetry that Fluid Framework generates, and this\nlogger is the way in which that telemetry gets into Fluid Devtools.\n\nYou can obtain a `DevtoolsLogger` by calling its constructor, and then should pass it to `initializeDevtools` _and_\nto the `Loader` instance you'll use to create/load Containers as shown below.\nThis way the logger will receive all the telemetry generated by Fluid Framework in your application, and forward it to\nFluid Devtools as necessary.\n\n```typescript\nimport { DevtoolsLogger, initializeDevtools } from \"@fluid-experimental/devtools-core\";\n\n// Instantiate the logger\nconst devtoolsLogger = new DevtoolsLogger();\n\n// Pass the logger when instantiating the Loader\nconst loader = new Loader({\n\tlogger: devtoolsLogger,\n\t// Other necessary properties ...\n});\n\n// Use the Loader to create (and optionally, attach) a Container\nconst container = await loader.createDetachedContainer(/* params */);\nawait container.attach(/* params */);\n\n// Initialize the Devtools passing the logger and your Container.\n// The Container could be added later as well with devtools.registerContainerDevtools().\nconst devtools = initializeDevtools({\n\tlogger: devtoolsLogger,\n\tinitialContainers: [\n\t\t{\n\t\t\tcontainer,\n\t\t\tcontainerKey: \"My Container\",\n\t\t},\n\t],\n});\n```\n\nIf you're working with `AzureClient` instead of lower-level APIs like the one described above, you probably want to\nrefer to the [@fluid-experimental/devtools package][devtools-package] instead of this one.\n\nDuring local development the recommendation is that your application should receive the `DevtoolsLogger` instance _instead_\nof any logger it would normally receive when deployed to a real environment, to avoid local development activity from\nmixing with real telemetry.\nIf you still want to provide a real application logger and use the Fluid Devtools features that are powered by telemetry\nat the same time, you can pass an existing logger to the `DevtoolsLogger` constructor and it will forward all telemetry\nit receives to that logger as well:\n\n```typescript\nimport { DevtoolsLogger } from \"@fluid-experimental/devtools-core\";\n\n// Your application's logger\nconst yourApplicationLogger = getInstanceOfYourApplicationLogger();\n\nconst devtoolsLogger = new DevtoolsLogger(yourApplicationLogger);\n\n// Pass devtoolsLogger to initializeDevtools() and to your application as described above\n```\n\n### Clean-up\n\nThe Devtools object is managed as a global singleton.\nThat singleton is automatically cleaned up prior to the Window's \"unload\" event.\nSo typical application flows likely won't need to worry about cleanup.\nThat said, if you wish to have tighter control over when the Devtools are torn down, you can simply call the `dispose` method on the handle returned by [initialization](#initialization).\n\n## Contributing to the package\n\n### Build\n\nTo build the package locally, first ensure you have run `pnpm install` from the root of the mono-repo.\nNext, to build the code, run `npm run build` from the root of the mono-repo, or use [fluid-build](https://github.com/microsoft/FluidFramework/tree/main/build-tools/packages/build-tools#running-fluid-build-command-line) via `fluid-build -t build`.\n\n- Note: Once you have run a build from the root, assuming no other changes outside of this package, you may run `npm run build` directly within this directory for a faster build.\n If you make changes to any of this package's local dependencies, you will need to run a build again from the root before building again from directly within this package.\n\n### Test\n\nTo run the tests, first ensure you have followed the [build](#build) steps above.\nNext, run `npm run test` from a terminal within this directory.\n\n\n\n\n\n\n\n## API Documentation\n\nAPI documentation for **@fluid-experimental/devtools-core** is available at .\n\n\n\n\n\n\n\n\n\n\n## Contribution Guidelines\n\nThere are many ways to [contribute](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md) to Fluid.\n\n- Participate in Q&A in our [GitHub Discussions](https://github.com/microsoft/FluidFramework/discussions).\n- [Submit bugs](https://github.com/microsoft/FluidFramework/issues) and help us verify fixes as they are checked in.\n- Review the [source code changes](https://github.com/microsoft/FluidFramework/pulls).\n- [Contribute bug fixes](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md).\n\nDetailed instructions for working in the repo can be found in the [Wiki](https://github.com/microsoft/FluidFramework/wiki).\n\nThis project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).\nFor more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\nUse of these trademarks or logos must follow Microsoft’s [Trademark & Brand Guidelines](https://www.microsoft.com/trademarks).\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n\n\n\n## Help\n\nNot finding what you're looking for in this README? Check out our [GitHub\nWiki](https://github.com/microsoft/FluidFramework/wiki) or [fluidframework.com](https://fluidframework.com/docs/).\n\nStill not finding what you're looking for? Please [file an\nissue](https://github.com/microsoft/FluidFramework/wiki/Submitting-Bugs-and-Feature-Requests).\n\nThank you!\n\n\n\n\n\n\n\n\n\n\n## Trademark\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\n\nUse of these trademarks or logos must follow Microsoft's [Trademark & Brand\nGuidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general).\n\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n[initialize-devtools-docs]: https://fluidframework.com/docs/apis/devtools-core#initializedevtools-function\n[devtools-logger-docs]: https://fluidframework.com/docs/apis/devtools-core/devtoolslogger-class\n[devtools-package]: https://www.npmjs.com/package/@fluid-experimental/devtools\n[browser-extension]: https://github.com/microsoft/FluidFramework/tree/main/packages/tools/devtools/devtools-browser-extension\n","scripts":{"tsc":"tsc","lint":"npm run prettier && npm run eslint","test":"npm run test:mocha","build":"fluid-build . --task build","clean":"rimraf --glob '_api-extractor-temp' 'nyc' 'dist' 'lib' '*.tsbuildinfo' '*.build.log'","eslint":"eslint src","format":"npm run prettier:fix","rebuild":"npm run clean && npm run build","lint:fix":"npm run prettier:fix && npm run eslint:fix","prettier":"prettier --check . --ignore-path ../../../../.prettierignore","tsc:watch":"tsc --watch","build:docs":"api-extractor run --local && copyfiles -u 1 ./_api-extractor-temp/doc-models/* ../../../../_api-extractor-temp/","eslint:fix":"eslint src --fix","test:mocha":"mocha dist/**/*.test.js --exit","build:esnext":"tsc --project ./tsconfig.esnext.json","build:genver":"gen-version","prettier:fix":"prettier --write . --ignore-path ../../../../.prettierignore","build:compile":"fluid-build . --task compile","ci:build:docs":"api-extractor run && copyfiles -u 1 ./_api-extractor-temp/doc-models/* ../../../../_api-extractor-temp/","test:coverage":"c8 npm test","typetests:gen":"fluid-type-test-generator","build:commonjs":"fluid-build . --task commonjs","format-and-build":"npm run format && npm run build","typetests:prepare":"flub typetests --dir . --reset --previous --normalize","format-and-compile":"npm run format && npm run build:compile"},"_npmUser":{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},"_resolved":"/mnt/vss/_work/1/pack/scoped/fluid-experimental-devtools-core-2.0.0-internal.7.0.2.tgz","_integrity":"sha512-3lK2w6V6qdiG/xJRxuKM94xDN/RxviakUCgybBueanll0E9kzhl13MQW+W/WmiA6y04UyaGA8Nyk5yvlU7tB1w==","fluidBuild":{"tasks":{"tsc":["...","typetests:gen"]}},"repository":{"url":"git+https://github.com/microsoft/FluidFramework.git","type":"git","directory":"packages/tools/devtools/devtools-core"},"_npmVersion":"9.6.7","description":"Fluid Framework developer tools core functionality","directories":{},"sideEffects":false,"_nodeVersion":"18.17.1","dependencies":{"@fluidframework/map":">=2.0.0-internal.7.0.2 <2.0.0-internal.7.1.0","@fluidframework/cell":">=2.0.0-internal.7.0.2 <2.0.0-internal.7.1.0","@fluidframework/matrix":">=2.0.0-internal.7.0.2 <2.0.0-internal.7.1.0","@fluidframework/counter":">=2.0.0-internal.7.0.2 <2.0.0-internal.7.1.0","@fluidframework/sequence":">=2.0.0-internal.7.0.2 <2.0.0-internal.7.1.0","@fluid-experimental/tree2":">=2.0.0-internal.7.0.2 <2.0.0-internal.7.1.0","@fluid-internal/client-utils":">=2.0.0-internal.7.0.2 <2.0.0-internal.7.1.0","@fluidframework/core-interfaces":">=2.0.0-internal.7.0.2 <2.0.0-internal.7.1.0","@fluidframework/telemetry-utils":">=2.0.0-internal.7.0.2 <2.0.0-internal.7.1.0","@fluidframework/container-loader":">=2.0.0-internal.7.0.2 <2.0.0-internal.7.1.0","@fluidframework/shared-object-base":">=2.0.0-internal.7.0.2 <2.0.0-internal.7.1.0","@fluidframework/protocol-definitions":"^3.0.0","@fluidframework/container-definitions":">=2.0.0-internal.7.0.2 <2.0.0-internal.7.1.0","@fluidframework/datastore-definitions":">=2.0.0-internal.7.0.2 <2.0.0-internal.7.1.0"},"_hasShrinkwrap":false,"readmeFilename":"README.md","typeValidation":{"broken":{"InterfaceDeclaration_FluidDevtoolsProps":{"forwardCompat":false},"InterfaceDeclaration_ContainerDevtoolsProps":{"forwardCompat":false}}},"devDependencies":{"c8":"^7.7.1","chai":"^4.2.0","mocha":"^10.2.0","eslint":"~8.6.0","events":"^3.1.0","moment":"^2.21.0","rimraf":"^4.4.0","prettier":"~2.6.2","copyfiles":"^2.4.1","cross-env":"^7.0.3","typescript":"~5.1.6","@types/chai":"^4.0.0","@types/mocha":"^9.1.1","@types/events":"^3.0.0","mocha-multi-reporters":"^1.5.1","@fluid-tools/build-cli":"^0.24.0","eslint-config-prettier":"~8.5.0","@microsoft/api-extractor":"^7.37.0","eslint-plugin-chai-expect":"~3.0.0","mocha-json-output-reporter":"^2.0.1","@fluidframework/build-tools":"^0.24.0","@fluidframework/build-common":"^2.0.0","@fluidframework/mocha-test-setup":">=2.0.0-internal.7.0.2 <2.0.0-internal.7.1.0","@fluidframework/driver-definitions":">=2.0.0-internal.7.0.2 <2.0.0-internal.7.1.0","@fluidframework/test-runtime-utils":">=2.0.0-internal.7.0.2 <2.0.0-internal.7.1.0","@fluidframework/eslint-config-fluid":"^2.1.0","@fluid-experimental/devtools-core-previous":"npm:@fluid-experimental/devtools-core@2.0.0-internal.6.3.0"},"_npmOperationalInternal":{"tmp":"tmp/devtools-core_2.0.0-internal.7.0.2_1699395130357_0.1171721564456889","host":"s3://npm-registry-packages"}},"2.0.0-dev.7.3.0.209174":{"name":"@fluid-experimental/devtools-core","version":"2.0.0-dev.7.3.0.209174","author":{"name":"Microsoft and contributors"},"license":"MIT","_id":"@fluid-experimental/devtools-core@2.0.0-dev.7.3.0.209174","maintainers":[{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},{"name":"curtisman","email":"curtism@microsoft.com"}],"homepage":"https://fluidframework.com","bugs":{"url":"https://github.com/microsoft/FluidFramework/issues"},"c8":{"all":true,"exclude":["src/test/**/*.ts","dist/test/**/*.js"],"include":["src/**/*.ts","dist/**/*.js"],"reporter":["cobertura","html","text"],"cache-dir":"nyc/.cache","report-dir":"nyc/report","temp-directory":"nyc/.nyc_output","exclude-after-remap":false},"dist":{"shasum":"3f3528c42672e202ee9d25483f12ec81d8b623dd","tarball":"https://registry.npmjs.org/@fluid-experimental/devtools-core/-/devtools-core-2.0.0-dev.7.3.0.209174.tgz","fileCount":505,"integrity":"sha512-GUIIHHqbiml8LWPqVNi59zhLLXXNIT2rdZYO1o9j0658nBbfqQoD1EzBS31ZqHb7OewgiVF4aHbXxcBM4+hEMg==","signatures":[{"sig":"MEQCIAixdzlqiHbatpWfjaPGz9Q8CgXqgTZrHlyEZ8lvBgkJAiAHrjhkELxoXhB6eTWbyB3VcRigtJb3J1gwt5EYjae13A==","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}],"unpackedSize":1547200},"main":"dist/index.js","_from":"file:fluid-experimental-devtools-core-2.0.0-dev.7.3.0.209174.tgz","types":"dist/index.d.ts","module":"lib/index.js","readme":"# @fluid-experimental/devtools-core\n\nThis library contains developer tools for use alongside the Fluid Framework.\nIt is used to power our associated [browser extension][browser-extension].\n\n- Chrome: \n- Edge: \n\n\n\n\n\n\n## Installation\n\nTo get started, install the package by running the following command:\n\n```bash\nnpm i @fluid-experimental/devtools-core -D\n```\n\n\n\n\n\n## Usage\n\nThe Devtools' API surface is designed to fit nicely into most application flows.\n\n### Initialization\n\nTo initialize a devtools session for your container, call [`initializeDevtools`][initialize-devtools-docs].\nThis function accepts a `DevtoolsLogger` for receiving Fluid telemetry from your application, a list of initial Fluid\n`Containers` to associate with the session, and (optionally) customized data visualization configurations for visualizing\n`Container` data.\n\n#### About the [`DevtoolsLogger`][devtools-logger-docs]\n\nThe `DevtoolsLogger` is an optional piece when calling `initializeDevtools` but it is strongly recommended that you use\nit because several features in Fluid Devtools are powered by the telemetry that Fluid Framework generates, and this\nlogger is the way in which that telemetry gets into Fluid Devtools.\n\nYou can obtain a `DevtoolsLogger` by calling its constructor, and then should pass it to `initializeDevtools` _and_\nto the `Loader` instance you'll use to create/load Containers as shown below.\nThis way the logger will receive all the telemetry generated by Fluid Framework in your application, and forward it to\nFluid Devtools as necessary.\n\n```typescript\nimport { DevtoolsLogger, initializeDevtools } from \"@fluid-experimental/devtools-core\";\n\n// Instantiate the logger\nconst devtoolsLogger = new DevtoolsLogger();\n\n// Pass the logger when instantiating the Loader\nconst loader = new Loader({\n\tlogger: devtoolsLogger,\n\t// Other necessary properties ...\n});\n\n// Use the Loader to create (and optionally, attach) a Container\nconst container = await loader.createDetachedContainer(/* params */);\nawait container.attach(/* params */);\n\n// Initialize the Devtools passing the logger and your Container.\n// The Container could be added later as well with devtools.registerContainerDevtools().\nconst devtools = initializeDevtools({\n\tlogger: devtoolsLogger,\n\tinitialContainers: [\n\t\t{\n\t\t\tcontainer,\n\t\t\tcontainerKey: \"My Container\",\n\t\t},\n\t],\n});\n```\n\nIf you're working with `AzureClient` instead of lower-level APIs like the one described above, you probably want to\nrefer to the [@fluid-experimental/devtools package][devtools-package] instead of this one.\n\nDuring local development the recommendation is that your application should receive the `DevtoolsLogger` instance _instead_\nof any logger it would normally receive when deployed to a real environment, to avoid local development activity from\nmixing with real telemetry.\nIf you still want to provide a real application logger and use the Fluid Devtools features that are powered by telemetry\nat the same time, you can pass an existing logger to the `DevtoolsLogger` constructor and it will forward all telemetry\nit receives to that logger as well:\n\n```typescript\nimport { DevtoolsLogger } from \"@fluid-experimental/devtools-core\";\n\n// Your application's logger\nconst yourApplicationLogger = getInstanceOfYourApplicationLogger();\n\nconst devtoolsLogger = new DevtoolsLogger(yourApplicationLogger);\n\n// Pass devtoolsLogger to initializeDevtools() and to your application as described above\n```\n\n### Clean-up\n\nThe Devtools object is managed as a global singleton.\nThat singleton is automatically cleaned up prior to the Window's \"unload\" event.\nSo typical application flows likely won't need to worry about cleanup.\nThat said, if you wish to have tighter control over when the Devtools are torn down, you can simply call the `dispose` method on the handle returned by [initialization](#initialization).\n\n## Contributing to the package\n\n### Build\n\nTo build the package locally, first ensure you have run `pnpm install` from the root of the mono-repo.\nNext, to build the code, run `npm run build` from the root of the mono-repo, or use [fluid-build](https://github.com/microsoft/FluidFramework/tree/main/build-tools/packages/build-tools#running-fluid-build-command-line) via `fluid-build -t build`.\n\n- Note: Once you have run a build from the root, assuming no other changes outside of this package, you may run `npm run build` directly within this directory for a faster build.\n If you make changes to any of this package's local dependencies, you will need to run a build again from the root before building again from directly within this package.\n\n### Test\n\nTo run the tests, first ensure you have followed the [build](#build) steps above.\nNext, run `npm run test` from a terminal within this directory.\n\n\n\n\n\n\n\n## API Documentation\n\nAPI documentation for **@fluid-experimental/devtools-core** is available at .\n\n\n\n\n\n\n\n\n\n\n## Contribution Guidelines\n\nThere are many ways to [contribute](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md) to Fluid.\n\n- Participate in Q&A in our [GitHub Discussions](https://github.com/microsoft/FluidFramework/discussions).\n- [Submit bugs](https://github.com/microsoft/FluidFramework/issues) and help us verify fixes as they are checked in.\n- Review the [source code changes](https://github.com/microsoft/FluidFramework/pulls).\n- [Contribute bug fixes](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md).\n\nDetailed instructions for working in the repo can be found in the [Wiki](https://github.com/microsoft/FluidFramework/wiki).\n\nThis project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).\nFor more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\nUse of these trademarks or logos must follow Microsoft’s [Trademark & Brand Guidelines](https://www.microsoft.com/trademarks).\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n\n\n\n## Help\n\nNot finding what you're looking for in this README? Check out our [GitHub\nWiki](https://github.com/microsoft/FluidFramework/wiki) or [fluidframework.com](https://fluidframework.com/docs/).\n\nStill not finding what you're looking for? Please [file an\nissue](https://github.com/microsoft/FluidFramework/wiki/Submitting-Bugs-and-Feature-Requests).\n\nThank you!\n\n\n\n\n\n\n\n\n\n\n## Trademark\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\n\nUse of these trademarks or logos must follow Microsoft's [Trademark & Brand\nGuidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general).\n\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n[initialize-devtools-docs]: https://fluidframework.com/docs/apis/devtools-core#initializedevtools-function\n[devtools-logger-docs]: https://fluidframework.com/docs/apis/devtools-core/devtoolslogger-class\n[devtools-package]: https://www.npmjs.com/package/@fluid-experimental/devtools\n[browser-extension]: https://github.com/microsoft/FluidFramework/tree/main/packages/tools/devtools/devtools-browser-extension\n","scripts":{"tsc":"tsc","lint":"npm run prettier && npm run eslint","test":"npm run test:mocha","build":"fluid-build . --task build","clean":"rimraf --glob _api-extractor-temp nyc dist lib \"*.tsbuildinfo\" \"*.build.log\"","eslint":"eslint src","format":"npm run prettier:fix","rebuild":"npm run clean && npm run build","lint:fix":"npm run prettier:fix && npm run eslint:fix","prettier":"prettier --check . --ignore-path ../../../../.prettierignore","tsc:watch":"tsc --watch","build:docs":"api-extractor run --local","eslint:fix":"eslint src --fix","test:mocha":"mocha \"dist/**/*.test.js\" --exit","build:esnext":"tsc --project ./tsconfig.esnext.json","build:genver":"gen-version","prettier:fix":"prettier --write . --ignore-path ../../../../.prettierignore","build:compile":"fluid-build . --task compile","ci:build:docs":"api-extractor run","test:coverage":"c8 npm test","typetests:gen":"fluid-type-test-generator","build:commonjs":"fluid-build . --task commonjs","format-and-build":"npm run format && npm run build","typetests:prepare":"flub typetests --dir . --reset --previous --normalize","format-and-compile":"npm run format && npm run build:compile"},"_npmUser":{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},"_resolved":"/mnt/vss/_work/1/pack/scoped/fluid-experimental-devtools-core-2.0.0-dev.7.3.0.209174.tgz","_integrity":"sha512-GUIIHHqbiml8LWPqVNi59zhLLXXNIT2rdZYO1o9j0658nBbfqQoD1EzBS31ZqHb7OewgiVF4aHbXxcBM4+hEMg==","fluidBuild":{"tasks":{"tsc":["...","typetests:gen"]}},"repository":{"url":"git+https://github.com/microsoft/FluidFramework.git","type":"git","directory":"packages/tools/devtools/devtools-core"},"_npmVersion":"9.6.7","description":"Fluid Framework developer tools core functionality","directories":{},"sideEffects":false,"_nodeVersion":"18.17.1","dependencies":{"@fluidframework/map":"2.0.0-dev.7.3.0.209174","@fluidframework/cell":"2.0.0-dev.7.3.0.209174","@fluidframework/matrix":"2.0.0-dev.7.3.0.209174","@fluidframework/counter":"2.0.0-dev.7.3.0.209174","@fluidframework/sequence":"2.0.0-dev.7.3.0.209174","@fluid-experimental/tree2":"2.0.0-dev.7.3.0.209174","@fluid-internal/client-utils":"2.0.0-dev.7.3.0.209174","@fluidframework/core-interfaces":"2.0.0-dev.7.3.0.209174","@fluidframework/telemetry-utils":"2.0.0-dev.7.3.0.209174","@fluidframework/container-loader":"2.0.0-dev.7.3.0.209174","@fluidframework/shared-object-base":"2.0.0-dev.7.3.0.209174","@fluidframework/protocol-definitions":"^3.0.0","@fluidframework/container-definitions":"2.0.0-dev.7.3.0.209174","@fluidframework/datastore-definitions":"2.0.0-dev.7.3.0.209174"},"_hasShrinkwrap":false,"readmeFilename":"README.md","typeValidation":{"broken":{}},"devDependencies":{"c8":"^7.7.1","chai":"^4.2.0","mocha":"^10.2.0","eslint":"~8.50.0","events":"^3.1.0","moment":"^2.21.0","rimraf":"^4.4.0","prettier":"~3.0.3","cross-env":"^7.0.3","typescript":"~5.1.6","@types/chai":"^4.0.0","@types/mocha":"^9.1.1","@types/events":"^3.0.0","mocha-multi-reporters":"^1.5.1","@fluid-tools/build-cli":"^0.26.1","eslint-config-prettier":"~9.0.0","@microsoft/api-extractor":"^7.37.0","eslint-plugin-chai-expect":"~3.0.0","mocha-json-output-reporter":"^2.0.1","@fluidframework/build-tools":"^0.26.1","@fluidframework/build-common":"^2.0.3","@fluidframework/mocha-test-setup":"2.0.0-dev.7.3.0.209174","@fluidframework/driver-definitions":"2.0.0-dev.7.3.0.209174","@fluidframework/test-runtime-utils":"2.0.0-dev.7.3.0.209174","@fluidframework/eslint-config-fluid":"^3.1.0","@fluid-experimental/devtools-core-previous":"npm:@fluid-experimental/devtools-core@2.0.0-internal.7.2.0"},"_npmOperationalInternal":{"tmp":"tmp/devtools-core_2.0.0-dev.7.3.0.209174_1699401563799_0.848090648592724","host":"s3://npm-registry-packages"}},"2.0.0-dev.7.3.0.209831":{"name":"@fluid-experimental/devtools-core","version":"2.0.0-dev.7.3.0.209831","author":{"name":"Microsoft and contributors"},"license":"MIT","_id":"@fluid-experimental/devtools-core@2.0.0-dev.7.3.0.209831","maintainers":[{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},{"name":"curtisman","email":"curtism@microsoft.com"}],"homepage":"https://fluidframework.com","bugs":{"url":"https://github.com/microsoft/FluidFramework/issues"},"c8":{"all":true,"exclude":["src/test/**/*.ts","dist/test/**/*.js"],"include":["src/**/*.ts","dist/**/*.js"],"reporter":["cobertura","html","text"],"cache-dir":"nyc/.cache","report-dir":"nyc/report","temp-directory":"nyc/.nyc_output","exclude-after-remap":false},"dist":{"shasum":"5826778bb27732d2c3bafe5454bf7876bc436748","tarball":"https://registry.npmjs.org/@fluid-experimental/devtools-core/-/devtools-core-2.0.0-dev.7.3.0.209831.tgz","fileCount":505,"integrity":"sha512-Qrwbdo5psTac+C4KLjrRE9B9bO1yelcNOfKpyAnD0VuCH4iklYCTrsdsbOS7Qt2m+FOh/DkL+im3A6cZHZ2BPw==","signatures":[{"sig":"MEQCIGLqpgw/6IA7JBLSQSWSk3gdiSrxzh2dNn/MFbmhS5CTAiBsg6utaR/j3ESHNfjTVBfYgIQUxOB1wf49BcYFJqvRAA==","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}],"unpackedSize":1547223},"main":"dist/index.js","_from":"file:fluid-experimental-devtools-core-2.0.0-dev.7.3.0.209831.tgz","types":"dist/index.d.ts","module":"lib/index.js","readme":"# @fluid-experimental/devtools-core\n\nThis library contains developer tools for use alongside the Fluid Framework.\nIt is used to power our associated [browser extension][browser-extension].\n\n- Chrome: \n- Edge: \n\n\n\n**IMPORTANT: This package is experimental.**\n**Its APIs may change without notice.**\n\n**Do not use in production scenarios.**\n\n\n\n\n\n\n\n\n## Installation\n\nTo get started, install the package by running the following command:\n\n```bash\nnpm i @fluid-experimental/devtools-core -D\n```\n\n\n\n\n\n## Usage\n\nThe Devtools' API surface is designed to fit nicely into most application flows.\n\n### Initialization\n\nTo initialize a devtools session for your container, call [`initializeDevtools`][initialize-devtools-docs].\nThis function accepts a `DevtoolsLogger` for receiving Fluid telemetry from your application, a list of initial Fluid\n`Containers` to associate with the session, and (optionally) customized data visualization configurations for visualizing\n`Container` data.\n\n#### About the [`DevtoolsLogger`][devtools-logger-docs]\n\nThe `DevtoolsLogger` is an optional piece when calling `initializeDevtools` but it is strongly recommended that you use\nit because several features in Fluid Devtools are powered by the telemetry that Fluid Framework generates, and this\nlogger is the way in which that telemetry gets into Fluid Devtools.\n\nYou can obtain a `DevtoolsLogger` by calling its constructor, and then should pass it to `initializeDevtools` _and_\nto the `Loader` instance you'll use to create/load Containers as shown below.\nThis way the logger will receive all the telemetry generated by Fluid Framework in your application, and forward it to\nFluid Devtools as necessary.\n\n```typescript\nimport { DevtoolsLogger, initializeDevtools } from \"@fluid-experimental/devtools-core\";\n\n// Instantiate the logger\nconst devtoolsLogger = new DevtoolsLogger();\n\n// Pass the logger when instantiating the Loader\nconst loader = new Loader({\n\tlogger: devtoolsLogger,\n\t// Other necessary properties ...\n});\n\n// Use the Loader to create (and optionally, attach) a Container\nconst container = await loader.createDetachedContainer(/* params */);\nawait container.attach(/* params */);\n\n// Initialize the Devtools passing the logger and your Container.\n// The Container could be added later as well with devtools.registerContainerDevtools().\nconst devtools = initializeDevtools({\n\tlogger: devtoolsLogger,\n\tinitialContainers: [\n\t\t{\n\t\t\tcontainer,\n\t\t\tcontainerKey: \"My Container\",\n\t\t},\n\t],\n});\n```\n\nIf you're working with `AzureClient` instead of lower-level APIs like the one described above, you probably want to\nrefer to the [@fluid-experimental/devtools package][devtools-package] instead of this one.\n\nDuring local development the recommendation is that your application should receive the `DevtoolsLogger` instance _instead_\nof any logger it would normally receive when deployed to a real environment, to avoid local development activity from\nmixing with real telemetry.\nIf you still want to provide a real application logger and use the Fluid Devtools features that are powered by telemetry\nat the same time, you can pass an existing logger to the `DevtoolsLogger` constructor and it will forward all telemetry\nit receives to that logger as well:\n\n```typescript\nimport { DevtoolsLogger } from \"@fluid-experimental/devtools-core\";\n\n// Your application's logger\nconst yourApplicationLogger = getInstanceOfYourApplicationLogger();\n\nconst devtoolsLogger = new DevtoolsLogger(yourApplicationLogger);\n\n// Pass devtoolsLogger to initializeDevtools() and to your application as described above\n```\n\n### Clean-up\n\nThe Devtools object is managed as a global singleton.\nThat singleton is automatically cleaned up prior to the Window's \"unload\" event.\nSo typical application flows likely won't need to worry about cleanup.\nThat said, if you wish to have tighter control over when the Devtools are torn down, you can simply call the `dispose` method on the handle returned by [initialization](#initialization).\n\n## Contributing to the package\n\n### Build\n\nTo build the package locally, first ensure you have run `pnpm install` from the root of the mono-repo.\nNext, to build the code, run `npm run build` from the root of the mono-repo, or use [fluid-build](https://github.com/microsoft/FluidFramework/tree/main/build-tools/packages/build-tools#running-fluid-build-command-line) via `fluid-build -t build`.\n\n- Note: Once you have run a build from the root, assuming no other changes outside of this package, you may run `npm run build` directly within this directory for a faster build.\n If you make changes to any of this package's local dependencies, you will need to run a build again from the root before building again from directly within this package.\n\n### Test\n\nTo run the tests, first ensure you have followed the [build](#build) steps above.\nNext, run `npm run test` from a terminal within this directory.\n\n\n\n\n\n\n\n## API Documentation\n\nAPI documentation for **@fluid-experimental/devtools-core** is available at .\n\n\n\n\n\n\n\n\n\n\n## Contribution Guidelines\n\nThere are many ways to [contribute](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md) to Fluid.\n\n- Participate in Q&A in our [GitHub Discussions](https://github.com/microsoft/FluidFramework/discussions).\n- [Submit bugs](https://github.com/microsoft/FluidFramework/issues) and help us verify fixes as they are checked in.\n- Review the [source code changes](https://github.com/microsoft/FluidFramework/pulls).\n- [Contribute bug fixes](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md).\n\nDetailed instructions for working in the repo can be found in the [Wiki](https://github.com/microsoft/FluidFramework/wiki).\n\nThis project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).\nFor more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\nUse of these trademarks or logos must follow Microsoft’s [Trademark & Brand Guidelines](https://www.microsoft.com/trademarks).\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n\n\n\n## Help\n\nNot finding what you're looking for in this README? Check out our [GitHub\nWiki](https://github.com/microsoft/FluidFramework/wiki) or [fluidframework.com](https://fluidframework.com/docs/).\n\nStill not finding what you're looking for? Please [file an\nissue](https://github.com/microsoft/FluidFramework/wiki/Submitting-Bugs-and-Feature-Requests).\n\nThank you!\n\n\n\n\n\n\n\n\n\n\n## Trademark\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\n\nUse of these trademarks or logos must follow Microsoft's [Trademark & Brand Guidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general).\n\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n[initialize-devtools-docs]: https://fluidframework.com/docs/apis/devtools-core#initializedevtools-function\n[devtools-logger-docs]: https://fluidframework.com/docs/apis/devtools-core/devtoolslogger-class\n[devtools-package]: https://www.npmjs.com/package/@fluid-experimental/devtools\n[browser-extension]: https://github.com/microsoft/FluidFramework/tree/main/packages/tools/devtools/devtools-browser-extension\n","scripts":{"tsc":"tsc","lint":"npm run prettier && npm run eslint","test":"npm run test:mocha","build":"fluid-build . --task build","clean":"rimraf --glob _api-extractor-temp nyc dist lib \"*.tsbuildinfo\" \"*.build.log\"","eslint":"eslint src","format":"npm run prettier:fix","rebuild":"npm run clean && npm run build","lint:fix":"npm run prettier:fix && npm run eslint:fix","prettier":"prettier --check . --ignore-path ../../../../.prettierignore","tsc:watch":"tsc --watch","build:docs":"api-extractor run --local","eslint:fix":"eslint src --fix","test:mocha":"mocha \"dist/**/*.test.js\" --exit","build:esnext":"tsc --project ./tsconfig.esnext.json","build:genver":"gen-version","prettier:fix":"prettier --write . --ignore-path ../../../../.prettierignore","build:compile":"fluid-build . --task compile","ci:build:docs":"api-extractor run","test:coverage":"c8 npm test","typetests:gen":"fluid-type-test-generator","build:commonjs":"fluid-build . --task commonjs","format-and-build":"npm run format && npm run build","typetests:prepare":"flub typetests --dir . --reset --previous --normalize","format-and-compile":"npm run format && npm run build:compile"},"_npmUser":{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},"_resolved":"/mnt/vss/_work/1/pack/scoped/fluid-experimental-devtools-core-2.0.0-dev.7.3.0.209831.tgz","_integrity":"sha512-Qrwbdo5psTac+C4KLjrRE9B9bO1yelcNOfKpyAnD0VuCH4iklYCTrsdsbOS7Qt2m+FOh/DkL+im3A6cZHZ2BPw==","fluidBuild":{"tasks":{"tsc":["...","typetests:gen"]}},"repository":{"url":"git+https://github.com/microsoft/FluidFramework.git","type":"git","directory":"packages/tools/devtools/devtools-core"},"_npmVersion":"9.6.7","description":"Fluid Framework developer tools core functionality","directories":{},"sideEffects":false,"_nodeVersion":"18.17.1","dependencies":{"@fluidframework/map":"2.0.0-dev.7.3.0.209831","@fluidframework/cell":"2.0.0-dev.7.3.0.209831","@fluidframework/matrix":"2.0.0-dev.7.3.0.209831","@fluidframework/counter":"2.0.0-dev.7.3.0.209831","@fluidframework/sequence":"2.0.0-dev.7.3.0.209831","@fluid-experimental/tree2":"2.0.0-dev.7.3.0.209831","@fluid-internal/client-utils":"2.0.0-dev.7.3.0.209831","@fluidframework/core-interfaces":"2.0.0-dev.7.3.0.209831","@fluidframework/telemetry-utils":"2.0.0-dev.7.3.0.209831","@fluidframework/container-loader":"2.0.0-dev.7.3.0.209831","@fluidframework/shared-object-base":"2.0.0-dev.7.3.0.209831","@fluidframework/protocol-definitions":"^3.0.0","@fluidframework/container-definitions":"2.0.0-dev.7.3.0.209831","@fluidframework/datastore-definitions":"2.0.0-dev.7.3.0.209831"},"_hasShrinkwrap":false,"readmeFilename":"README.md","typeValidation":{"broken":{}},"devDependencies":{"c8":"^7.7.1","chai":"^4.2.0","mocha":"^10.2.0","eslint":"~8.50.0","events":"^3.1.0","moment":"^2.21.0","rimraf":"^4.4.0","prettier":"~3.0.3","cross-env":"^7.0.3","typescript":"~5.1.6","@types/chai":"^4.0.0","@types/mocha":"^9.1.1","@types/events":"^3.0.0","mocha-multi-reporters":"^1.5.1","@fluid-tools/build-cli":"^0.26.1","eslint-config-prettier":"~9.0.0","@microsoft/api-extractor":"^7.37.0","eslint-plugin-chai-expect":"~3.0.0","mocha-json-output-reporter":"^2.0.1","@fluidframework/build-tools":"^0.26.1","@fluidframework/build-common":"^2.0.3","@fluidframework/mocha-test-setup":"2.0.0-dev.7.3.0.209831","@fluidframework/driver-definitions":"2.0.0-dev.7.3.0.209831","@fluidframework/test-runtime-utils":"2.0.0-dev.7.3.0.209831","@fluidframework/eslint-config-fluid":"^3.1.0","@fluid-experimental/devtools-core-previous":"npm:@fluid-experimental/devtools-core@2.0.0-internal.7.2.0"},"_npmOperationalInternal":{"tmp":"tmp/devtools-core_2.0.0-dev.7.3.0.209831_1699580473239_0.6973458014265914","host":"s3://npm-registry-packages"}},"2.0.0-dev.7.3.0.210328":{"name":"@fluid-experimental/devtools-core","version":"2.0.0-dev.7.3.0.210328","author":{"name":"Microsoft and contributors"},"license":"MIT","_id":"@fluid-experimental/devtools-core@2.0.0-dev.7.3.0.210328","maintainers":[{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},{"name":"curtisman","email":"curtism@microsoft.com"}],"homepage":"https://fluidframework.com","bugs":{"url":"https://github.com/microsoft/FluidFramework/issues"},"c8":{"all":true,"exclude":["src/test/**/*.ts","dist/test/**/*.js"],"include":["src/**/*.ts","dist/**/*.js"],"reporter":["cobertura","html","text"],"cache-dir":"nyc/.cache","report-dir":"nyc/report","temp-directory":"nyc/.nyc_output","exclude-after-remap":false},"dist":{"shasum":"bcd11023bfbad4f064da3f38dbf7e16354f17347","tarball":"https://registry.npmjs.org/@fluid-experimental/devtools-core/-/devtools-core-2.0.0-dev.7.3.0.210328.tgz","fileCount":505,"integrity":"sha512-510ncWac3Q6YnIca4W1CTZW/dDlL/16BZvjhdJnGU2HB0gur/hPxElgWvVjVzPio5pUw1rujvGu9GfuMG5Qylw==","signatures":[{"sig":"MEUCICMROhHqgWNwzEhmB4H+yHhMLfYYJs+IJEnkhVTJtszWAiEA93thkgTkW0cYVkWGBbRaX2xGjkGh4MsPDKUKMfZUCfg=","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}],"unpackedSize":1547223},"main":"dist/index.js","_from":"file:fluid-experimental-devtools-core-2.0.0-dev.7.3.0.210328.tgz","types":"dist/index.d.ts","module":"lib/index.js","readme":"# @fluid-experimental/devtools-core\n\nThis library contains developer tools for use alongside the Fluid Framework.\nIt is used to power our associated [browser extension][browser-extension].\n\n- Chrome: \n- Edge: \n\n\n\n**IMPORTANT: This package is experimental.**\n**Its APIs may change without notice.**\n\n**Do not use in production scenarios.**\n\n\n\n\n\n\n\n\n## Installation\n\nTo get started, install the package by running the following command:\n\n```bash\nnpm i @fluid-experimental/devtools-core -D\n```\n\n\n\n\n\n## Usage\n\nThe Devtools' API surface is designed to fit nicely into most application flows.\n\n### Initialization\n\nTo initialize a devtools session for your container, call [`initializeDevtools`][initialize-devtools-docs].\nThis function accepts a `DevtoolsLogger` for receiving Fluid telemetry from your application, a list of initial Fluid\n`Containers` to associate with the session, and (optionally) customized data visualization configurations for visualizing\n`Container` data.\n\n#### About the [`DevtoolsLogger`][devtools-logger-docs]\n\nThe `DevtoolsLogger` is an optional piece when calling `initializeDevtools` but it is strongly recommended that you use\nit because several features in Fluid Devtools are powered by the telemetry that Fluid Framework generates, and this\nlogger is the way in which that telemetry gets into Fluid Devtools.\n\nYou can obtain a `DevtoolsLogger` by calling its constructor, and then should pass it to `initializeDevtools` _and_\nto the `Loader` instance you'll use to create/load Containers as shown below.\nThis way the logger will receive all the telemetry generated by Fluid Framework in your application, and forward it to\nFluid Devtools as necessary.\n\n```typescript\nimport { DevtoolsLogger, initializeDevtools } from \"@fluid-experimental/devtools-core\";\n\n// Instantiate the logger\nconst devtoolsLogger = new DevtoolsLogger();\n\n// Pass the logger when instantiating the Loader\nconst loader = new Loader({\n\tlogger: devtoolsLogger,\n\t// Other necessary properties ...\n});\n\n// Use the Loader to create (and optionally, attach) a Container\nconst container = await loader.createDetachedContainer(/* params */);\nawait container.attach(/* params */);\n\n// Initialize the Devtools passing the logger and your Container.\n// The Container could be added later as well with devtools.registerContainerDevtools().\nconst devtools = initializeDevtools({\n\tlogger: devtoolsLogger,\n\tinitialContainers: [\n\t\t{\n\t\t\tcontainer,\n\t\t\tcontainerKey: \"My Container\",\n\t\t},\n\t],\n});\n```\n\nIf you're working with `AzureClient` instead of lower-level APIs like the one described above, you probably want to\nrefer to the [@fluid-experimental/devtools package][devtools-package] instead of this one.\n\nDuring local development the recommendation is that your application should receive the `DevtoolsLogger` instance _instead_\nof any logger it would normally receive when deployed to a real environment, to avoid local development activity from\nmixing with real telemetry.\nIf you still want to provide a real application logger and use the Fluid Devtools features that are powered by telemetry\nat the same time, you can pass an existing logger to the `DevtoolsLogger` constructor and it will forward all telemetry\nit receives to that logger as well:\n\n```typescript\nimport { DevtoolsLogger } from \"@fluid-experimental/devtools-core\";\n\n// Your application's logger\nconst yourApplicationLogger = getInstanceOfYourApplicationLogger();\n\nconst devtoolsLogger = new DevtoolsLogger(yourApplicationLogger);\n\n// Pass devtoolsLogger to initializeDevtools() and to your application as described above\n```\n\n### Clean-up\n\nThe Devtools object is managed as a global singleton.\nThat singleton is automatically cleaned up prior to the Window's \"unload\" event.\nSo typical application flows likely won't need to worry about cleanup.\nThat said, if you wish to have tighter control over when the Devtools are torn down, you can simply call the `dispose` method on the handle returned by [initialization](#initialization).\n\n## Contributing to the package\n\n### Build\n\nTo build the package locally, first ensure you have run `pnpm install` from the root of the mono-repo.\nNext, to build the code, run `npm run build` from the root of the mono-repo, or use [fluid-build](https://github.com/microsoft/FluidFramework/tree/main/build-tools/packages/build-tools#running-fluid-build-command-line) via `fluid-build -t build`.\n\n- Note: Once you have run a build from the root, assuming no other changes outside of this package, you may run `npm run build` directly within this directory for a faster build.\n If you make changes to any of this package's local dependencies, you will need to run a build again from the root before building again from directly within this package.\n\n### Test\n\nTo run the tests, first ensure you have followed the [build](#build) steps above.\nNext, run `npm run test` from a terminal within this directory.\n\n\n\n\n\n\n\n## API Documentation\n\nAPI documentation for **@fluid-experimental/devtools-core** is available at .\n\n\n\n\n\n\n\n\n\n\n## Contribution Guidelines\n\nThere are many ways to [contribute](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md) to Fluid.\n\n- Participate in Q&A in our [GitHub Discussions](https://github.com/microsoft/FluidFramework/discussions).\n- [Submit bugs](https://github.com/microsoft/FluidFramework/issues) and help us verify fixes as they are checked in.\n- Review the [source code changes](https://github.com/microsoft/FluidFramework/pulls).\n- [Contribute bug fixes](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md).\n\nDetailed instructions for working in the repo can be found in the [Wiki](https://github.com/microsoft/FluidFramework/wiki).\n\nThis project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).\nFor more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\nUse of these trademarks or logos must follow Microsoft’s [Trademark & Brand Guidelines](https://www.microsoft.com/trademarks).\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n\n\n\n## Help\n\nNot finding what you're looking for in this README? Check out our [GitHub\nWiki](https://github.com/microsoft/FluidFramework/wiki) or [fluidframework.com](https://fluidframework.com/docs/).\n\nStill not finding what you're looking for? Please [file an\nissue](https://github.com/microsoft/FluidFramework/wiki/Submitting-Bugs-and-Feature-Requests).\n\nThank you!\n\n\n\n\n\n\n\n\n\n\n## Trademark\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\n\nUse of these trademarks or logos must follow Microsoft's [Trademark & Brand Guidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general).\n\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n[initialize-devtools-docs]: https://fluidframework.com/docs/apis/devtools-core#initializedevtools-function\n[devtools-logger-docs]: https://fluidframework.com/docs/apis/devtools-core/devtoolslogger-class\n[devtools-package]: https://www.npmjs.com/package/@fluid-experimental/devtools\n[browser-extension]: https://github.com/microsoft/FluidFramework/tree/main/packages/tools/devtools/devtools-browser-extension\n","scripts":{"tsc":"tsc","lint":"npm run prettier && npm run eslint","test":"npm run test:mocha","build":"fluid-build . --task build","clean":"rimraf --glob _api-extractor-temp nyc dist lib \"*.tsbuildinfo\" \"*.build.log\"","eslint":"eslint src","format":"npm run prettier:fix","rebuild":"npm run clean && npm run build","lint:fix":"npm run prettier:fix && npm run eslint:fix","prettier":"prettier --check . --ignore-path ../../../../.prettierignore","tsc:watch":"tsc --watch","build:docs":"api-extractor run --local","eslint:fix":"eslint src --fix","test:mocha":"mocha \"dist/**/*.test.js\" --exit","build:esnext":"tsc --project ./tsconfig.esnext.json","build:genver":"gen-version","prettier:fix":"prettier --write . --ignore-path ../../../../.prettierignore","build:compile":"fluid-build . --task compile","ci:build:docs":"api-extractor run","test:coverage":"c8 npm test","typetests:gen":"fluid-type-test-generator","build:commonjs":"fluid-build . --task commonjs","format-and-build":"npm run format && npm run build","typetests:prepare":"flub typetests --dir . --reset --previous --normalize","format-and-compile":"npm run format && npm run build:compile"},"_npmUser":{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},"_resolved":"/mnt/vss/_work/1/pack/scoped/fluid-experimental-devtools-core-2.0.0-dev.7.3.0.210328.tgz","_integrity":"sha512-510ncWac3Q6YnIca4W1CTZW/dDlL/16BZvjhdJnGU2HB0gur/hPxElgWvVjVzPio5pUw1rujvGu9GfuMG5Qylw==","fluidBuild":{"tasks":{"tsc":["...","typetests:gen"]}},"repository":{"url":"git+https://github.com/microsoft/FluidFramework.git","type":"git","directory":"packages/tools/devtools/devtools-core"},"_npmVersion":"9.6.7","description":"Fluid Framework developer tools core functionality","directories":{},"sideEffects":false,"_nodeVersion":"18.17.1","dependencies":{"@fluidframework/map":"2.0.0-dev.7.3.0.210328","@fluidframework/cell":"2.0.0-dev.7.3.0.210328","@fluidframework/matrix":"2.0.0-dev.7.3.0.210328","@fluidframework/counter":"2.0.0-dev.7.3.0.210328","@fluidframework/sequence":"2.0.0-dev.7.3.0.210328","@fluid-experimental/tree2":"2.0.0-dev.7.3.0.210328","@fluid-internal/client-utils":"2.0.0-dev.7.3.0.210328","@fluidframework/core-interfaces":"2.0.0-dev.7.3.0.210328","@fluidframework/telemetry-utils":"2.0.0-dev.7.3.0.210328","@fluidframework/container-loader":"2.0.0-dev.7.3.0.210328","@fluidframework/shared-object-base":"2.0.0-dev.7.3.0.210328","@fluidframework/protocol-definitions":"^3.0.0","@fluidframework/container-definitions":"2.0.0-dev.7.3.0.210328","@fluidframework/datastore-definitions":"2.0.0-dev.7.3.0.210328"},"_hasShrinkwrap":false,"readmeFilename":"README.md","typeValidation":{"broken":{}},"devDependencies":{"c8":"^7.7.1","chai":"^4.2.0","mocha":"^10.2.0","eslint":"~8.50.0","events":"^3.1.0","moment":"^2.21.0","rimraf":"^4.4.0","prettier":"~3.0.3","cross-env":"^7.0.3","typescript":"~5.1.6","@types/chai":"^4.0.0","@types/mocha":"^9.1.1","@types/events":"^3.0.0","mocha-multi-reporters":"^1.5.1","@fluid-tools/build-cli":"^0.27.0","eslint-config-prettier":"~9.0.0","@microsoft/api-extractor":"^7.37.0","eslint-plugin-chai-expect":"~3.0.0","mocha-json-output-reporter":"^2.0.1","@fluidframework/build-tools":"^0.27.0","@fluidframework/build-common":"^2.0.3","@fluidframework/mocha-test-setup":"2.0.0-dev.7.3.0.210328","@fluidframework/driver-definitions":"2.0.0-dev.7.3.0.210328","@fluidframework/test-runtime-utils":"2.0.0-dev.7.3.0.210328","@fluidframework/eslint-config-fluid":"^3.1.0","@fluid-experimental/devtools-core-previous":"npm:@fluid-experimental/devtools-core@2.0.0-internal.7.2.0"},"_npmOperationalInternal":{"tmp":"tmp/devtools-core_2.0.0-dev.7.3.0.210328_1699669579841_0.07727236407479765","host":"s3://npm-registry-packages"}},"2.0.0-internal.7.0.3":{"name":"@fluid-experimental/devtools-core","version":"2.0.0-internal.7.0.3","author":{"name":"Microsoft and contributors"},"license":"MIT","_id":"@fluid-experimental/devtools-core@2.0.0-internal.7.0.3","maintainers":[{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},{"name":"curtisman","email":"curtism@microsoft.com"}],"homepage":"https://fluidframework.com","bugs":{"url":"https://github.com/microsoft/FluidFramework/issues"},"c8":{"all":true,"exclude":["src/test/**/*.ts","dist/test/**/*.js"],"include":["src/**/*.ts","dist/**/*.js"],"reporter":["cobertura","html","text"],"cache-dir":"nyc/.cache","report-dir":"nyc/report","temp-directory":"nyc/.nyc_output","exclude-after-remap":false},"dist":{"shasum":"1e5024ddd70e71532978cd1720b25464c5ad5276","tarball":"https://registry.npmjs.org/@fluid-experimental/devtools-core/-/devtools-core-2.0.0-internal.7.0.3.tgz","fileCount":501,"integrity":"sha512-abIRAEAPh/9af/SYHg0skOHvBuREBPfbZC28aLtski6z5Ce58GOJPwuD69GbJ0otz6biSPSzSG4WcyO/FcuMoQ==","signatures":[{"sig":"MEQCIEytx8jno95AVOLCz11S3Af4Ng/e4QcEuoe5WehWQ/gTAiAqaOUdILHY6Ga5JGzf/COAAgh+h2CJZzAHG7sM9dP/2g==","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}],"unpackedSize":1378772},"main":"dist/index.js","_from":"file:fluid-experimental-devtools-core-2.0.0-internal.7.0.3.tgz","types":"dist/index.d.ts","module":"lib/index.js","readme":"# @fluid-experimental/devtools-core\n\nThis library contains developer tools for use alongside the Fluid Framework.\nIt is used to power our associated [browser extension][browser-extension].\n\n- Chrome: \n- Edge: \n\n\n\n\n\n\n## Installation\n\nTo get started, install the package by running the following command:\n\n```bash\nnpm i @fluid-experimental/devtools-core -D\n```\n\n\n\n\n\n## Usage\n\nThe Devtools' API surface is designed to fit nicely into most application flows.\n\n### Initialization\n\nTo initialize a devtools session for your container, call [`initializeDevtools`][initialize-devtools-docs].\nThis function accepts a `DevtoolsLogger` for receiving Fluid telemetry from your application, a list of initial Fluid\n`Containers` to associate with the session, and (optionally) customized data visualization configurations for visualizing\n`Container` data.\n\n#### About the [`DevtoolsLogger`][devtools-logger-docs]\n\nThe `DevtoolsLogger` is an optional piece when calling `initializeDevtools` but it is strongly recommended that you use\nit because several features in Fluid Devtools are powered by the telemetry that Fluid Framework generates, and this\nlogger is the way in which that telemetry gets into Fluid Devtools.\n\nYou can obtain a `DevtoolsLogger` by calling its constructor, and then should pass it to `initializeDevtools` _and_\nto the `Loader` instance you'll use to create/load Containers as shown below.\nThis way the logger will receive all the telemetry generated by Fluid Framework in your application, and forward it to\nFluid Devtools as necessary.\n\n```typescript\nimport { DevtoolsLogger, initializeDevtools } from \"@fluid-experimental/devtools-core\";\n\n// Instantiate the logger\nconst devtoolsLogger = new DevtoolsLogger();\n\n// Pass the logger when instantiating the Loader\nconst loader = new Loader({\n\tlogger: devtoolsLogger,\n\t// Other necessary properties ...\n});\n\n// Use the Loader to create (and optionally, attach) a Container\nconst container = await loader.createDetachedContainer(/* params */);\nawait container.attach(/* params */);\n\n// Initialize the Devtools passing the logger and your Container.\n// The Container could be added later as well with devtools.registerContainerDevtools().\nconst devtools = initializeDevtools({\n\tlogger: devtoolsLogger,\n\tinitialContainers: [\n\t\t{\n\t\t\tcontainer,\n\t\t\tcontainerKey: \"My Container\",\n\t\t},\n\t],\n});\n```\n\nIf you're working with `AzureClient` instead of lower-level APIs like the one described above, you probably want to\nrefer to the [@fluid-experimental/devtools package][devtools-package] instead of this one.\n\nDuring local development the recommendation is that your application should receive the `DevtoolsLogger` instance _instead_\nof any logger it would normally receive when deployed to a real environment, to avoid local development activity from\nmixing with real telemetry.\nIf you still want to provide a real application logger and use the Fluid Devtools features that are powered by telemetry\nat the same time, you can pass an existing logger to the `DevtoolsLogger` constructor and it will forward all telemetry\nit receives to that logger as well:\n\n```typescript\nimport { DevtoolsLogger } from \"@fluid-experimental/devtools-core\";\n\n// Your application's logger\nconst yourApplicationLogger = getInstanceOfYourApplicationLogger();\n\nconst devtoolsLogger = new DevtoolsLogger(yourApplicationLogger);\n\n// Pass devtoolsLogger to initializeDevtools() and to your application as described above\n```\n\n### Clean-up\n\nThe Devtools object is managed as a global singleton.\nThat singleton is automatically cleaned up prior to the Window's \"unload\" event.\nSo typical application flows likely won't need to worry about cleanup.\nThat said, if you wish to have tighter control over when the Devtools are torn down, you can simply call the `dispose` method on the handle returned by [initialization](#initialization).\n\n## Contributing to the package\n\n### Build\n\nTo build the package locally, first ensure you have run `pnpm install` from the root of the mono-repo.\nNext, to build the code, run `npm run build` from the root of the mono-repo, or use [fluid-build](https://github.com/microsoft/FluidFramework/tree/main/build-tools/packages/build-tools#running-fluid-build-command-line) via `fluid-build -t build`.\n\n- Note: Once you have run a build from the root, assuming no other changes outside of this package, you may run `npm run build` directly within this directory for a faster build.\n If you make changes to any of this package's local dependencies, you will need to run a build again from the root before building again from directly within this package.\n\n### Test\n\nTo run the tests, first ensure you have followed the [build](#build) steps above.\nNext, run `npm run test` from a terminal within this directory.\n\n\n\n\n\n\n\n## API Documentation\n\nAPI documentation for **@fluid-experimental/devtools-core** is available at .\n\n\n\n\n\n\n\n\n\n\n## Contribution Guidelines\n\nThere are many ways to [contribute](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md) to Fluid.\n\n- Participate in Q&A in our [GitHub Discussions](https://github.com/microsoft/FluidFramework/discussions).\n- [Submit bugs](https://github.com/microsoft/FluidFramework/issues) and help us verify fixes as they are checked in.\n- Review the [source code changes](https://github.com/microsoft/FluidFramework/pulls).\n- [Contribute bug fixes](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md).\n\nDetailed instructions for working in the repo can be found in the [Wiki](https://github.com/microsoft/FluidFramework/wiki).\n\nThis project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).\nFor more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\nUse of these trademarks or logos must follow Microsoft’s [Trademark & Brand Guidelines](https://www.microsoft.com/trademarks).\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n\n\n\n## Help\n\nNot finding what you're looking for in this README? Check out our [GitHub\nWiki](https://github.com/microsoft/FluidFramework/wiki) or [fluidframework.com](https://fluidframework.com/docs/).\n\nStill not finding what you're looking for? Please [file an\nissue](https://github.com/microsoft/FluidFramework/wiki/Submitting-Bugs-and-Feature-Requests).\n\nThank you!\n\n\n\n\n\n\n\n\n\n\n## Trademark\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\n\nUse of these trademarks or logos must follow Microsoft's [Trademark & Brand\nGuidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general).\n\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n[initialize-devtools-docs]: https://fluidframework.com/docs/apis/devtools-core#initializedevtools-function\n[devtools-logger-docs]: https://fluidframework.com/docs/apis/devtools-core/devtoolslogger-class\n[devtools-package]: https://www.npmjs.com/package/@fluid-experimental/devtools\n[browser-extension]: https://github.com/microsoft/FluidFramework/tree/main/packages/tools/devtools/devtools-browser-extension\n","scripts":{"tsc":"tsc","lint":"npm run prettier && npm run eslint","test":"npm run test:mocha","build":"fluid-build . --task build","clean":"rimraf --glob '_api-extractor-temp' 'nyc' 'dist' 'lib' '*.tsbuildinfo' '*.build.log'","eslint":"eslint src","format":"npm run prettier:fix","rebuild":"npm run clean && npm run build","lint:fix":"npm run prettier:fix && npm run eslint:fix","prettier":"prettier --check . --ignore-path ../../../../.prettierignore","tsc:watch":"tsc --watch","build:docs":"api-extractor run --local && copyfiles -u 1 ./_api-extractor-temp/doc-models/* ../../../../_api-extractor-temp/","eslint:fix":"eslint src --fix","test:mocha":"mocha dist/**/*.test.js --exit","build:esnext":"tsc --project ./tsconfig.esnext.json","build:genver":"gen-version","prettier:fix":"prettier --write . --ignore-path ../../../../.prettierignore","build:compile":"fluid-build . --task compile","ci:build:docs":"api-extractor run && copyfiles -u 1 ./_api-extractor-temp/doc-models/* ../../../../_api-extractor-temp/","test:coverage":"c8 npm test","typetests:gen":"fluid-type-test-generator","build:commonjs":"fluid-build . --task commonjs","format-and-build":"npm run format && npm run build","typetests:prepare":"flub typetests --dir . --reset --previous --normalize","format-and-compile":"npm run format && npm run build:compile"},"_npmUser":{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},"_resolved":"/mnt/vss/_work/1/pack/scoped/fluid-experimental-devtools-core-2.0.0-internal.7.0.3.tgz","_integrity":"sha512-abIRAEAPh/9af/SYHg0skOHvBuREBPfbZC28aLtski6z5Ce58GOJPwuD69GbJ0otz6biSPSzSG4WcyO/FcuMoQ==","fluidBuild":{"tasks":{"tsc":["...","typetests:gen"]}},"repository":{"url":"git+https://github.com/microsoft/FluidFramework.git","type":"git","directory":"packages/tools/devtools/devtools-core"},"_npmVersion":"9.6.7","description":"Fluid Framework developer tools core functionality","directories":{},"sideEffects":false,"_nodeVersion":"18.17.1","dependencies":{"@fluidframework/map":">=2.0.0-internal.7.0.3 <2.0.0-internal.7.1.0","@fluidframework/cell":">=2.0.0-internal.7.0.3 <2.0.0-internal.7.1.0","@fluidframework/matrix":">=2.0.0-internal.7.0.3 <2.0.0-internal.7.1.0","@fluidframework/counter":">=2.0.0-internal.7.0.3 <2.0.0-internal.7.1.0","@fluidframework/sequence":">=2.0.0-internal.7.0.3 <2.0.0-internal.7.1.0","@fluid-experimental/tree2":">=2.0.0-internal.7.0.3 <2.0.0-internal.7.1.0","@fluid-internal/client-utils":">=2.0.0-internal.7.0.3 <2.0.0-internal.7.1.0","@fluidframework/core-interfaces":">=2.0.0-internal.7.0.3 <2.0.0-internal.7.1.0","@fluidframework/telemetry-utils":">=2.0.0-internal.7.0.3 <2.0.0-internal.7.1.0","@fluidframework/container-loader":">=2.0.0-internal.7.0.3 <2.0.0-internal.7.1.0","@fluidframework/shared-object-base":">=2.0.0-internal.7.0.3 <2.0.0-internal.7.1.0","@fluidframework/protocol-definitions":"^3.0.0","@fluidframework/container-definitions":">=2.0.0-internal.7.0.3 <2.0.0-internal.7.1.0","@fluidframework/datastore-definitions":">=2.0.0-internal.7.0.3 <2.0.0-internal.7.1.0"},"_hasShrinkwrap":false,"readmeFilename":"README.md","typeValidation":{"broken":{"InterfaceDeclaration_FluidDevtoolsProps":{"forwardCompat":false},"InterfaceDeclaration_ContainerDevtoolsProps":{"forwardCompat":false}}},"devDependencies":{"c8":"^7.7.1","chai":"^4.2.0","mocha":"^10.2.0","eslint":"~8.6.0","events":"^3.1.0","moment":"^2.21.0","rimraf":"^4.4.0","prettier":"~2.6.2","copyfiles":"^2.4.1","cross-env":"^7.0.3","typescript":"~5.1.6","@types/chai":"^4.0.0","@types/mocha":"^9.1.1","@types/events":"^3.0.0","mocha-multi-reporters":"^1.5.1","@fluid-tools/build-cli":"^0.24.0","eslint-config-prettier":"~8.5.0","@microsoft/api-extractor":"^7.37.0","eslint-plugin-chai-expect":"~3.0.0","mocha-json-output-reporter":"^2.0.1","@fluidframework/build-tools":"^0.24.0","@fluidframework/build-common":"^2.0.0","@fluidframework/mocha-test-setup":">=2.0.0-internal.7.0.3 <2.0.0-internal.7.1.0","@fluidframework/driver-definitions":">=2.0.0-internal.7.0.3 <2.0.0-internal.7.1.0","@fluidframework/test-runtime-utils":">=2.0.0-internal.7.0.3 <2.0.0-internal.7.1.0","@fluidframework/eslint-config-fluid":"^2.1.0","@fluid-experimental/devtools-core-previous":"npm:@fluid-experimental/devtools-core@2.0.0-internal.6.3.0"},"_npmOperationalInternal":{"tmp":"tmp/devtools-core_2.0.0-internal.7.0.3_1700084482599_0.9594880151541212","host":"s3://npm-registry-packages"}},"2.0.0-dev.7.3.0.211848":{"name":"@fluid-experimental/devtools-core","version":"2.0.0-dev.7.3.0.211848","author":{"name":"Microsoft and contributors"},"license":"MIT","_id":"@fluid-experimental/devtools-core@2.0.0-dev.7.3.0.211848","maintainers":[{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},{"name":"curtisman","email":"curtism@microsoft.com"}],"homepage":"https://fluidframework.com","bugs":{"url":"https://github.com/microsoft/FluidFramework/issues"},"c8":{"all":true,"exclude":["src/test/**/*.ts","dist/test/**/*.js"],"include":["src/**/*.ts","dist/**/*.js"],"reporter":["cobertura","html","text"],"cache-dir":"nyc/.cache","report-dir":"nyc/report","temp-directory":"nyc/.nyc_output","exclude-after-remap":false},"dist":{"shasum":"643a96d82cb0ab5c8cb57b3b1c52ccfeb598d666","tarball":"https://registry.npmjs.org/@fluid-experimental/devtools-core/-/devtools-core-2.0.0-dev.7.3.0.211848.tgz","fileCount":505,"integrity":"sha512-q4AQICxPomIq6rqOdcdqb5zxChIig6xATibknqaPsDHKRc+F2i5gDkaptU6JRDQtoaFJy7r4Q6TAGIeuOyd11A==","signatures":[{"sig":"MEUCIQDgoAnz7M3oLB23+HAGp7hFZOF2SaPPyfAI3BVUkihF2AIgLFeddKlbyPo4g0fKaM7P/qQfzh0mN9kpmD7h1yfxqUo=","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}],"unpackedSize":1548933},"main":"dist/index.js","_from":"file:fluid-experimental-devtools-core-2.0.0-dev.7.3.0.211848.tgz","types":"dist/index.d.ts","module":"lib/index.js","readme":"# @fluid-experimental/devtools-core\n\nThis library contains developer tools for use alongside the Fluid Framework.\nIt is used to power our associated [browser extension][browser-extension].\n\n- Chrome: \n- Edge: \n\n\n\n**IMPORTANT: This package is experimental.**\n**Its APIs may change without notice.**\n\n**Do not use in production scenarios.**\n\n\n\n\n\n\n\n\n## Installation\n\nTo get started, install the package by running the following command:\n\n```bash\nnpm i @fluid-experimental/devtools-core -D\n```\n\n\n\n\n\n## Usage\n\nThe Devtools' API surface is designed to fit nicely into most application flows.\n\n### Initialization\n\nTo initialize a devtools session for your container, call [`initializeDevtools`][initialize-devtools-docs].\nThis function accepts a `DevtoolsLogger` for receiving Fluid telemetry from your application, a list of initial Fluid\n`Containers` to associate with the session, and (optionally) customized data visualization configurations for visualizing\n`Container` data.\n\n#### About the [`DevtoolsLogger`][devtools-logger-docs]\n\nThe `DevtoolsLogger` is an optional piece when calling `initializeDevtools` but it is strongly recommended that you use\nit because several features in Fluid Devtools are powered by the telemetry that Fluid Framework generates, and this\nlogger is the way in which that telemetry gets into Fluid Devtools.\n\nYou can obtain a `DevtoolsLogger` by calling its constructor, and then should pass it to `initializeDevtools` _and_\nto the `Loader` instance you'll use to create/load Containers as shown below.\nThis way the logger will receive all the telemetry generated by Fluid Framework in your application, and forward it to\nFluid Devtools as necessary.\n\n```typescript\nimport { DevtoolsLogger, initializeDevtools } from \"@fluid-experimental/devtools-core\";\n\n// Instantiate the logger\nconst devtoolsLogger = new DevtoolsLogger();\n\n// Pass the logger when instantiating the Loader\nconst loader = new Loader({\n\tlogger: devtoolsLogger,\n\t// Other necessary properties ...\n});\n\n// Use the Loader to create (and optionally, attach) a Container\nconst container = await loader.createDetachedContainer(/* params */);\nawait container.attach(/* params */);\n\n// Initialize the Devtools passing the logger and your Container.\n// The Container could be added later as well with devtools.registerContainerDevtools().\nconst devtools = initializeDevtools({\n\tlogger: devtoolsLogger,\n\tinitialContainers: [\n\t\t{\n\t\t\tcontainer,\n\t\t\tcontainerKey: \"My Container\",\n\t\t},\n\t],\n});\n```\n\nIf you're working with `AzureClient` instead of lower-level APIs like the one described above, you probably want to\nrefer to the [@fluid-experimental/devtools package][devtools-package] instead of this one.\n\nDuring local development the recommendation is that your application should receive the `DevtoolsLogger` instance _instead_\nof any logger it would normally receive when deployed to a real environment, to avoid local development activity from\nmixing with real telemetry.\nIf you still want to provide a real application logger and use the Fluid Devtools features that are powered by telemetry\nat the same time, you can pass an existing logger to the `DevtoolsLogger` constructor and it will forward all telemetry\nit receives to that logger as well:\n\n```typescript\nimport { DevtoolsLogger } from \"@fluid-experimental/devtools-core\";\n\n// Your application's logger\nconst yourApplicationLogger = getInstanceOfYourApplicationLogger();\n\nconst devtoolsLogger = new DevtoolsLogger(yourApplicationLogger);\n\n// Pass devtoolsLogger to initializeDevtools() and to your application as described above\n```\n\n### Clean-up\n\nThe Devtools object is managed as a global singleton.\nThat singleton is automatically cleaned up prior to the Window's \"unload\" event.\nSo typical application flows likely won't need to worry about cleanup.\nThat said, if you wish to have tighter control over when the Devtools are torn down, you can simply call the `dispose` method on the handle returned by [initialization](#initialization).\n\n## Contributing to the package\n\n### Build\n\nTo build the package locally, first ensure you have run `pnpm install` from the root of the mono-repo.\nNext, to build the code, run `npm run build` from the root of the mono-repo, or use [fluid-build](https://github.com/microsoft/FluidFramework/tree/main/build-tools/packages/build-tools#running-fluid-build-command-line) via `fluid-build -t build`.\n\n- Note: Once you have run a build from the root, assuming no other changes outside of this package, you may run `npm run build` directly within this directory for a faster build.\n If you make changes to any of this package's local dependencies, you will need to run a build again from the root before building again from directly within this package.\n\n### Test\n\nTo run the tests, first ensure you have followed the [build](#build) steps above.\nNext, run `npm run test` from a terminal within this directory.\n\n\n\n\n\n\n\n## API Documentation\n\nAPI documentation for **@fluid-experimental/devtools-core** is available at .\n\n\n\n\n\n\n\n\n\n\n## Contribution Guidelines\n\nThere are many ways to [contribute](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md) to Fluid.\n\n- Participate in Q&A in our [GitHub Discussions](https://github.com/microsoft/FluidFramework/discussions).\n- [Submit bugs](https://github.com/microsoft/FluidFramework/issues) and help us verify fixes as they are checked in.\n- Review the [source code changes](https://github.com/microsoft/FluidFramework/pulls).\n- [Contribute bug fixes](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md).\n\nDetailed instructions for working in the repo can be found in the [Wiki](https://github.com/microsoft/FluidFramework/wiki).\n\nThis project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).\nFor more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\nUse of these trademarks or logos must follow Microsoft’s [Trademark & Brand Guidelines](https://www.microsoft.com/trademarks).\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n\n\n\n## Help\n\nNot finding what you're looking for in this README? Check out our [GitHub\nWiki](https://github.com/microsoft/FluidFramework/wiki) or [fluidframework.com](https://fluidframework.com/docs/).\n\nStill not finding what you're looking for? Please [file an\nissue](https://github.com/microsoft/FluidFramework/wiki/Submitting-Bugs-and-Feature-Requests).\n\nThank you!\n\n\n\n\n\n\n\n\n\n\n## Trademark\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\n\nUse of these trademarks or logos must follow Microsoft's [Trademark & Brand Guidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general).\n\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n[initialize-devtools-docs]: https://fluidframework.com/docs/apis/devtools-core#initializedevtools-function\n[devtools-logger-docs]: https://fluidframework.com/docs/apis/devtools-core/devtoolslogger-class\n[devtools-package]: https://www.npmjs.com/package/@fluid-experimental/devtools\n[browser-extension]: https://github.com/microsoft/FluidFramework/tree/main/packages/tools/devtools/devtools-browser-extension\n","scripts":{"tsc":"tsc","lint":"npm run prettier && npm run eslint","test":"npm run test:mocha","build":"fluid-build . --task build","clean":"rimraf --glob _api-extractor-temp nyc dist lib \"**/*.tsbuildinfo\" \"**/*.build.log\"","eslint":"eslint src","format":"npm run prettier:fix","rebuild":"npm run clean && npm run build","lint:fix":"npm run prettier:fix && npm run eslint:fix","prettier":"prettier --check . --ignore-path ../../../../.prettierignore","tsc:watch":"tsc --watch","build:docs":"api-extractor run --local","eslint:fix":"eslint src --fix","test:mocha":"mocha \"dist/**/*.test.js\" --exit","build:esnext":"tsc --project ./tsconfig.esnext.json","build:genver":"gen-version","prettier:fix":"prettier --write . --ignore-path ../../../../.prettierignore","build:compile":"fluid-build . --task compile","ci:build:docs":"api-extractor run","test:coverage":"c8 npm test","typetests:gen":"fluid-type-test-generator","build:commonjs":"fluid-build . --task commonjs","format-and-build":"npm run format && npm run build","typetests:prepare":"flub typetests --dir . --reset --previous --normalize","format-and-compile":"npm run format && npm run build:compile"},"_npmUser":{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},"_resolved":"/mnt/vss/_work/1/pack/scoped/fluid-experimental-devtools-core-2.0.0-dev.7.3.0.211848.tgz","_integrity":"sha512-q4AQICxPomIq6rqOdcdqb5zxChIig6xATibknqaPsDHKRc+F2i5gDkaptU6JRDQtoaFJy7r4Q6TAGIeuOyd11A==","fluidBuild":{"tasks":{"tsc":["...","typetests:gen"]}},"repository":{"url":"git+https://github.com/microsoft/FluidFramework.git","type":"git","directory":"packages/tools/devtools/devtools-core"},"_npmVersion":"9.6.7","description":"Fluid Framework developer tools core functionality","directories":{},"sideEffects":false,"_nodeVersion":"18.17.1","dependencies":{"@fluidframework/map":"2.0.0-dev.7.3.0.211848","@fluidframework/cell":"2.0.0-dev.7.3.0.211848","@fluidframework/matrix":"2.0.0-dev.7.3.0.211848","@fluidframework/counter":"2.0.0-dev.7.3.0.211848","@fluidframework/sequence":"2.0.0-dev.7.3.0.211848","@fluid-experimental/tree2":"2.0.0-dev.7.3.0.211848","@fluid-internal/client-utils":"2.0.0-dev.7.3.0.211848","@fluidframework/core-interfaces":"2.0.0-dev.7.3.0.211848","@fluidframework/telemetry-utils":"2.0.0-dev.7.3.0.211848","@fluidframework/container-loader":"2.0.0-dev.7.3.0.211848","@fluidframework/shared-object-base":"2.0.0-dev.7.3.0.211848","@fluidframework/protocol-definitions":"^3.0.0","@fluidframework/container-definitions":"2.0.0-dev.7.3.0.211848","@fluidframework/datastore-definitions":"2.0.0-dev.7.3.0.211848"},"_hasShrinkwrap":false,"readmeFilename":"README.md","typeValidation":{"broken":{}},"devDependencies":{"c8":"^7.7.1","chai":"^4.2.0","mocha":"^10.2.0","eslint":"~8.50.0","events":"^3.1.0","moment":"^2.21.0","rimraf":"^4.4.0","prettier":"~3.0.3","cross-env":"^7.0.3","typescript":"~5.1.6","@types/chai":"^4.0.0","@types/mocha":"^9.1.1","@types/events":"^3.0.0","mocha-multi-reporters":"^1.5.1","@fluid-tools/build-cli":"0.28.0-210888","eslint-config-prettier":"~9.0.0","@microsoft/api-extractor":"^7.38.3","eslint-plugin-chai-expect":"~3.0.0","mocha-json-output-reporter":"^2.0.1","@fluidframework/build-tools":"0.28.0-210888","@fluidframework/build-common":"^2.0.3","@fluidframework/mocha-test-setup":"2.0.0-dev.7.3.0.211848","@fluidframework/driver-definitions":"2.0.0-dev.7.3.0.211848","@fluidframework/test-runtime-utils":"2.0.0-dev.7.3.0.211848","@fluidframework/eslint-config-fluid":"^3.1.0","@fluid-experimental/devtools-core-previous":"npm:@fluid-experimental/devtools-core@2.0.0-internal.7.2.0"},"_npmOperationalInternal":{"tmp":"tmp/devtools-core_2.0.0-dev.7.3.0.211848_1700173594417_0.4775667249239921","host":"s3://npm-registry-packages"}},"2.0.0-dev.7.3.0.212138":{"name":"@fluid-experimental/devtools-core","version":"2.0.0-dev.7.3.0.212138","author":{"name":"Microsoft and contributors"},"license":"MIT","_id":"@fluid-experimental/devtools-core@2.0.0-dev.7.3.0.212138","maintainers":[{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},{"name":"curtisman","email":"curtism@microsoft.com"}],"homepage":"https://fluidframework.com","bugs":{"url":"https://github.com/microsoft/FluidFramework/issues"},"c8":{"all":true,"exclude":["src/test/**/*.ts","dist/test/**/*.js"],"include":["src/**/*.ts","dist/**/*.js"],"reporter":["cobertura","html","text"],"cache-dir":"nyc/.cache","report-dir":"nyc/report","temp-directory":"nyc/.nyc_output","exclude-after-remap":false},"dist":{"shasum":"c7925732ab6980e28bd9492eed76fa88cc2d9da2","tarball":"https://registry.npmjs.org/@fluid-experimental/devtools-core/-/devtools-core-2.0.0-dev.7.3.0.212138.tgz","fileCount":505,"integrity":"sha512-BZnyo9PyfW/Pzh2ysYtS6p0nbbZiOy7qtKt6RUrYSeC2HinLG71JjgqcsS9eGFi8NtmYaQg8NLmJK5aQl5YgNg==","signatures":[{"sig":"MEYCIQDZY009uCWhFXUh7hSl7LzBa85jQ/NVesdHd0TXLR95WAIhAIvTGd2SoX8XgwDU3i4M1m+LAWnGka1csj0xxi8cwxy+","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}],"unpackedSize":1548972},"main":"dist/index.js","_from":"file:fluid-experimental-devtools-core-2.0.0-dev.7.3.0.212138.tgz","types":"dist/index.d.ts","module":"lib/index.js","readme":"# @fluid-experimental/devtools-core\n\nThis library contains developer tools for use alongside the Fluid Framework.\nIt is used to power our associated [browser extension][browser-extension].\n\n- Chrome: \n- Edge: \n\n\n\n**IMPORTANT: This package is experimental.**\n**Its APIs may change without notice.**\n\n**Do not use in production scenarios.**\n\n\n\n\n\n\n\n\n## Installation\n\nTo get started, install the package by running the following command:\n\n```bash\nnpm i @fluid-experimental/devtools-core -D\n```\n\n\n\n\n\n## Usage\n\nThe Devtools' API surface is designed to fit nicely into most application flows.\n\n### Initialization\n\nTo initialize a devtools session for your container, call [`initializeDevtools`][initialize-devtools-docs].\nThis function accepts a `DevtoolsLogger` for receiving Fluid telemetry from your application, a list of initial Fluid\n`Containers` to associate with the session, and (optionally) customized data visualization configurations for visualizing\n`Container` data.\n\n#### About the [`DevtoolsLogger`][devtools-logger-docs]\n\nThe `DevtoolsLogger` is an optional piece when calling `initializeDevtools` but it is strongly recommended that you use\nit because several features in Fluid Devtools are powered by the telemetry that Fluid Framework generates, and this\nlogger is the way in which that telemetry gets into Fluid Devtools.\n\nYou can obtain a `DevtoolsLogger` by calling its constructor, and then should pass it to `initializeDevtools` _and_\nto the `Loader` instance you'll use to create/load Containers as shown below.\nThis way the logger will receive all the telemetry generated by Fluid Framework in your application, and forward it to\nFluid Devtools as necessary.\n\n```typescript\nimport { DevtoolsLogger, initializeDevtools } from \"@fluid-experimental/devtools-core\";\n\n// Instantiate the logger\nconst devtoolsLogger = new DevtoolsLogger();\n\n// Pass the logger when instantiating the Loader\nconst loader = new Loader({\n\tlogger: devtoolsLogger,\n\t// Other necessary properties ...\n});\n\n// Use the Loader to create (and optionally, attach) a Container\nconst container = await loader.createDetachedContainer(/* params */);\nawait container.attach(/* params */);\n\n// Initialize the Devtools passing the logger and your Container.\n// The Container could be added later as well with devtools.registerContainerDevtools().\nconst devtools = initializeDevtools({\n\tlogger: devtoolsLogger,\n\tinitialContainers: [\n\t\t{\n\t\t\tcontainer,\n\t\t\tcontainerKey: \"My Container\",\n\t\t},\n\t],\n});\n```\n\nIf you're working with `AzureClient` instead of lower-level APIs like the one described above, you probably want to\nrefer to the [@fluid-experimental/devtools package][devtools-package] instead of this one.\n\nDuring local development the recommendation is that your application should receive the `DevtoolsLogger` instance _instead_\nof any logger it would normally receive when deployed to a real environment, to avoid local development activity from\nmixing with real telemetry.\nIf you still want to provide a real application logger and use the Fluid Devtools features that are powered by telemetry\nat the same time, you can pass an existing logger to the `DevtoolsLogger` constructor and it will forward all telemetry\nit receives to that logger as well:\n\n```typescript\nimport { DevtoolsLogger } from \"@fluid-experimental/devtools-core\";\n\n// Your application's logger\nconst yourApplicationLogger = getInstanceOfYourApplicationLogger();\n\nconst devtoolsLogger = new DevtoolsLogger(yourApplicationLogger);\n\n// Pass devtoolsLogger to initializeDevtools() and to your application as described above\n```\n\n### Clean-up\n\nThe Devtools object is managed as a global singleton.\nThat singleton is automatically cleaned up prior to the Window's \"unload\" event.\nSo typical application flows likely won't need to worry about cleanup.\nThat said, if you wish to have tighter control over when the Devtools are torn down, you can simply call the `dispose` method on the handle returned by [initialization](#initialization).\n\n## Contributing to the package\n\n### Build\n\nTo build the package locally, first ensure you have run `pnpm install` from the root of the mono-repo.\nNext, to build the code, run `npm run build` from the root of the mono-repo, or use [fluid-build](https://github.com/microsoft/FluidFramework/tree/main/build-tools/packages/build-tools#running-fluid-build-command-line) via `fluid-build -t build`.\n\n- Note: Once you have run a build from the root, assuming no other changes outside of this package, you may run `npm run build` directly within this directory for a faster build.\n If you make changes to any of this package's local dependencies, you will need to run a build again from the root before building again from directly within this package.\n\n### Test\n\nTo run the tests, first ensure you have followed the [build](#build) steps above.\nNext, run `npm run test` from a terminal within this directory.\n\n\n\n\n\n\n\n## API Documentation\n\nAPI documentation for **@fluid-experimental/devtools-core** is available at .\n\n\n\n\n\n\n\n\n\n\n## Contribution Guidelines\n\nThere are many ways to [contribute](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md) to Fluid.\n\n- Participate in Q&A in our [GitHub Discussions](https://github.com/microsoft/FluidFramework/discussions).\n- [Submit bugs](https://github.com/microsoft/FluidFramework/issues) and help us verify fixes as they are checked in.\n- Review the [source code changes](https://github.com/microsoft/FluidFramework/pulls).\n- [Contribute bug fixes](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md).\n\nDetailed instructions for working in the repo can be found in the [Wiki](https://github.com/microsoft/FluidFramework/wiki).\n\nThis project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).\nFor more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\nUse of these trademarks or logos must follow Microsoft’s [Trademark & Brand Guidelines](https://www.microsoft.com/trademarks).\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n\n\n\n## Help\n\nNot finding what you're looking for in this README? Check out our [GitHub\nWiki](https://github.com/microsoft/FluidFramework/wiki) or [fluidframework.com](https://fluidframework.com/docs/).\n\nStill not finding what you're looking for? Please [file an\nissue](https://github.com/microsoft/FluidFramework/wiki/Submitting-Bugs-and-Feature-Requests).\n\nThank you!\n\n\n\n\n\n\n\n\n\n\n## Trademark\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\n\nUse of these trademarks or logos must follow Microsoft's [Trademark & Brand Guidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general).\n\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n[initialize-devtools-docs]: https://fluidframework.com/docs/apis/devtools-core#initializedevtools-function\n[devtools-logger-docs]: https://fluidframework.com/docs/apis/devtools-core/devtoolslogger-class\n[devtools-package]: https://www.npmjs.com/package/@fluid-experimental/devtools\n[browser-extension]: https://github.com/microsoft/FluidFramework/tree/main/packages/tools/devtools/devtools-browser-extension\n","scripts":{"tsc":"tsc","lint":"npm run prettier && npm run eslint","test":"npm run test:mocha","build":"fluid-build . --task build","clean":"rimraf --glob _api-extractor-temp nyc dist lib \"**/*.tsbuildinfo\" \"**/*.build.log\"","eslint":"eslint src","format":"npm run prettier:fix","rebuild":"npm run clean && npm run build","lint:fix":"npm run prettier:fix && npm run eslint:fix","prettier":"prettier --check . --ignore-path ../../../../.prettierignore","tsc:watch":"tsc --watch","build:docs":"api-extractor run --local","eslint:fix":"eslint src --fix","test:mocha":"mocha \"dist/**/*.test.js\" --exit","build:esnext":"tsc --project ./tsconfig.esnext.json","build:genver":"gen-version","prettier:fix":"prettier --write . --ignore-path ../../../../.prettierignore","build:compile":"fluid-build . --task compile","ci:build:docs":"api-extractor run","test:coverage":"c8 npm test","typetests:gen":"fluid-type-test-generator","build:commonjs":"fluid-build . --task commonjs","format-and-build":"npm run format && npm run build","typetests:prepare":"flub typetests --dir . --reset --previous --normalize","format-and-compile":"npm run format && npm run build:compile"},"_npmUser":{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},"_resolved":"/mnt/vss/_work/1/pack/scoped/fluid-experimental-devtools-core-2.0.0-dev.7.3.0.212138.tgz","_integrity":"sha512-BZnyo9PyfW/Pzh2ysYtS6p0nbbZiOy7qtKt6RUrYSeC2HinLG71JjgqcsS9eGFi8NtmYaQg8NLmJK5aQl5YgNg==","fluidBuild":{"tasks":{"tsc":["...","typetests:gen"]}},"repository":{"url":"git+https://github.com/microsoft/FluidFramework.git","type":"git","directory":"packages/tools/devtools/devtools-core"},"_npmVersion":"9.6.7","description":"Fluid Framework developer tools core functionality","directories":{},"sideEffects":false,"_nodeVersion":"18.17.1","dependencies":{"@fluidframework/map":"2.0.0-dev.7.3.0.212138","@fluidframework/cell":"2.0.0-dev.7.3.0.212138","@fluidframework/matrix":"2.0.0-dev.7.3.0.212138","@fluidframework/counter":"2.0.0-dev.7.3.0.212138","@fluidframework/sequence":"2.0.0-dev.7.3.0.212138","@fluid-experimental/tree2":"2.0.0-dev.7.3.0.212138","@fluid-internal/client-utils":"2.0.0-dev.7.3.0.212138","@fluidframework/core-interfaces":"2.0.0-dev.7.3.0.212138","@fluidframework/telemetry-utils":"2.0.0-dev.7.3.0.212138","@fluidframework/container-loader":"2.0.0-dev.7.3.0.212138","@fluidframework/shared-object-base":"2.0.0-dev.7.3.0.212138","@fluidframework/protocol-definitions":"^3.0.0","@fluidframework/container-definitions":"2.0.0-dev.7.3.0.212138","@fluidframework/datastore-definitions":"2.0.0-dev.7.3.0.212138"},"_hasShrinkwrap":false,"readmeFilename":"README.md","typeValidation":{"broken":{}},"devDependencies":{"c8":"^7.7.1","chai":"^4.2.0","mocha":"^10.2.0","eslint":"~8.50.0","events":"^3.1.0","moment":"^2.21.0","rimraf":"^4.4.0","prettier":"~3.0.3","cross-env":"^7.0.3","typescript":"~5.1.6","@types/chai":"^4.0.0","@types/mocha":"^9.1.1","@types/events":"^3.0.0","mocha-multi-reporters":"^1.5.1","@fluid-tools/build-cli":"^0.28.0","eslint-config-prettier":"~9.0.0","@microsoft/api-extractor":"^7.38.3","eslint-plugin-chai-expect":"~3.0.0","mocha-json-output-reporter":"^2.0.1","@fluidframework/build-tools":"^0.28.0","@fluidframework/build-common":"^2.0.3","@fluidframework/mocha-test-setup":"2.0.0-dev.7.3.0.212138","@fluidframework/driver-definitions":"2.0.0-dev.7.3.0.212138","@fluidframework/test-runtime-utils":"2.0.0-dev.7.3.0.212138","@fluidframework/eslint-config-fluid":"^3.1.0","@fluid-experimental/devtools-core-previous":"npm:@fluid-experimental/devtools-core@2.0.0-internal.7.2.0"},"_npmOperationalInternal":{"tmp":"tmp/devtools-core_2.0.0-dev.7.3.0.212138_1700253590426_0.16232903291260503","host":"s3://npm-registry-packages"}},"2.0.0-internal.7.3.0":{"name":"@fluid-experimental/devtools-core","version":"2.0.0-internal.7.3.0","author":{"name":"Microsoft and contributors"},"license":"MIT","_id":"@fluid-experimental/devtools-core@2.0.0-internal.7.3.0","maintainers":[{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},{"name":"curtisman","email":"curtism@microsoft.com"}],"homepage":"https://fluidframework.com","bugs":{"url":"https://github.com/microsoft/FluidFramework/issues"},"c8":{"all":true,"exclude":["src/test/**/*.ts","dist/test/**/*.js"],"include":["src/**/*.ts","dist/**/*.js"],"reporter":["cobertura","html","text"],"cache-dir":"nyc/.cache","report-dir":"nyc/report","temp-directory":"nyc/.nyc_output","exclude-after-remap":false},"dist":{"shasum":"acdc05dc89d21e979514fd81bf8d93c6866dc9b6","tarball":"https://registry.npmjs.org/@fluid-experimental/devtools-core/-/devtools-core-2.0.0-internal.7.3.0.tgz","fileCount":505,"integrity":"sha512-OR25y68u7/+BQqcm6+Bi2Psoc+R3LhWDDxFCy6iYSTDvJkFQU+lKT5BQHewREszwK4la9O7PtWIdIHMan8/quQ==","signatures":[{"sig":"MEUCIEIgvJApvzJRpS92VtJuMZvNUjE8QOMu6TUYegDTH57qAiEAvibhTlo7QE9dQFE3p87P5DG5DP8asJLbt9+s7ZSKr7s=","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}],"unpackedSize":1549308},"main":"dist/index.js","_from":"file:fluid-experimental-devtools-core-2.0.0-internal.7.3.0.tgz","types":"dist/index.d.ts","module":"lib/index.js","readme":"# @fluid-experimental/devtools-core\n\nThis library contains developer tools for use alongside the Fluid Framework.\nIt is used to power our associated [browser extension][browser-extension].\n\n- Chrome: \n- Edge: \n\n\n\n**IMPORTANT: This package is experimental.**\n**Its APIs may change without notice.**\n\n**Do not use in production scenarios.**\n\n\n\n\n\n\n\n\n## Installation\n\nTo get started, install the package by running the following command:\n\n```bash\nnpm i @fluid-experimental/devtools-core -D\n```\n\n\n\n\n\n## Usage\n\nThe Devtools' API surface is designed to fit nicely into most application flows.\n\n### Initialization\n\nTo initialize a devtools session for your container, call [`initializeDevtools`][initialize-devtools-docs].\nThis function accepts a `DevtoolsLogger` for receiving Fluid telemetry from your application, a list of initial Fluid\n`Containers` to associate with the session, and (optionally) customized data visualization configurations for visualizing\n`Container` data.\n\n#### About the [`DevtoolsLogger`][devtools-logger-docs]\n\nThe `DevtoolsLogger` is an optional piece when calling `initializeDevtools` but it is strongly recommended that you use\nit because several features in Fluid Devtools are powered by the telemetry that Fluid Framework generates, and this\nlogger is the way in which that telemetry gets into Fluid Devtools.\n\nYou can obtain a `DevtoolsLogger` by calling its constructor, and then should pass it to `initializeDevtools` _and_\nto the `Loader` instance you'll use to create/load Containers as shown below.\nThis way the logger will receive all the telemetry generated by Fluid Framework in your application, and forward it to\nFluid Devtools as necessary.\n\n```typescript\nimport { DevtoolsLogger, initializeDevtools } from \"@fluid-experimental/devtools-core\";\n\n// Instantiate the logger\nconst devtoolsLogger = new DevtoolsLogger();\n\n// Pass the logger when instantiating the Loader\nconst loader = new Loader({\n\tlogger: devtoolsLogger,\n\t// Other necessary properties ...\n});\n\n// Use the Loader to create (and optionally, attach) a Container\nconst container = await loader.createDetachedContainer(/* params */);\nawait container.attach(/* params */);\n\n// Initialize the Devtools passing the logger and your Container.\n// The Container could be added later as well with devtools.registerContainerDevtools().\nconst devtools = initializeDevtools({\n\tlogger: devtoolsLogger,\n\tinitialContainers: [\n\t\t{\n\t\t\tcontainer,\n\t\t\tcontainerKey: \"My Container\",\n\t\t},\n\t],\n});\n```\n\nIf you're working with `AzureClient` instead of lower-level APIs like the one described above, you probably want to\nrefer to the [@fluid-experimental/devtools package][devtools-package] instead of this one.\n\nDuring local development the recommendation is that your application should receive the `DevtoolsLogger` instance _instead_\nof any logger it would normally receive when deployed to a real environment, to avoid local development activity from\nmixing with real telemetry.\nIf you still want to provide a real application logger and use the Fluid Devtools features that are powered by telemetry\nat the same time, you can pass an existing logger to the `DevtoolsLogger` constructor and it will forward all telemetry\nit receives to that logger as well:\n\n```typescript\nimport { DevtoolsLogger } from \"@fluid-experimental/devtools-core\";\n\n// Your application's logger\nconst yourApplicationLogger = getInstanceOfYourApplicationLogger();\n\nconst devtoolsLogger = new DevtoolsLogger(yourApplicationLogger);\n\n// Pass devtoolsLogger to initializeDevtools() and to your application as described above\n```\n\n### Clean-up\n\nThe Devtools object is managed as a global singleton.\nThat singleton is automatically cleaned up prior to the Window's \"unload\" event.\nSo typical application flows likely won't need to worry about cleanup.\nThat said, if you wish to have tighter control over when the Devtools are torn down, you can simply call the `dispose` method on the handle returned by [initialization](#initialization).\n\n## Contributing to the package\n\n### Build\n\nTo build the package locally, first ensure you have run `pnpm install` from the root of the mono-repo.\nNext, to build the code, run `npm run build` from the root of the mono-repo, or use [fluid-build](https://github.com/microsoft/FluidFramework/tree/main/build-tools/packages/build-tools#running-fluid-build-command-line) via `fluid-build -t build`.\n\n- Note: Once you have run a build from the root, assuming no other changes outside of this package, you may run `npm run build` directly within this directory for a faster build.\n If you make changes to any of this package's local dependencies, you will need to run a build again from the root before building again from directly within this package.\n\n### Test\n\nTo run the tests, first ensure you have followed the [build](#build) steps above.\nNext, run `npm run test` from a terminal within this directory.\n\n\n\n\n\n\n\n## API Documentation\n\nAPI documentation for **@fluid-experimental/devtools-core** is available at .\n\n\n\n\n\n\n\n\n\n\n## Contribution Guidelines\n\nThere are many ways to [contribute](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md) to Fluid.\n\n- Participate in Q&A in our [GitHub Discussions](https://github.com/microsoft/FluidFramework/discussions).\n- [Submit bugs](https://github.com/microsoft/FluidFramework/issues) and help us verify fixes as they are checked in.\n- Review the [source code changes](https://github.com/microsoft/FluidFramework/pulls).\n- [Contribute bug fixes](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md).\n\nDetailed instructions for working in the repo can be found in the [Wiki](https://github.com/microsoft/FluidFramework/wiki).\n\nThis project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).\nFor more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\nUse of these trademarks or logos must follow Microsoft’s [Trademark & Brand Guidelines](https://www.microsoft.com/trademarks).\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n\n\n\n## Help\n\nNot finding what you're looking for in this README? Check out our [GitHub\nWiki](https://github.com/microsoft/FluidFramework/wiki) or [fluidframework.com](https://fluidframework.com/docs/).\n\nStill not finding what you're looking for? Please [file an\nissue](https://github.com/microsoft/FluidFramework/wiki/Submitting-Bugs-and-Feature-Requests).\n\nThank you!\n\n\n\n\n\n\n\n\n\n\n## Trademark\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\n\nUse of these trademarks or logos must follow Microsoft's [Trademark & Brand Guidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general).\n\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n[initialize-devtools-docs]: https://fluidframework.com/docs/apis/devtools-core#initializedevtools-function\n[devtools-logger-docs]: https://fluidframework.com/docs/apis/devtools-core/devtoolslogger-class\n[devtools-package]: https://www.npmjs.com/package/@fluid-experimental/devtools\n[browser-extension]: https://github.com/microsoft/FluidFramework/tree/main/packages/tools/devtools/devtools-browser-extension\n","scripts":{"tsc":"tsc","lint":"npm run prettier && npm run eslint","test":"npm run test:mocha","build":"fluid-build . --task build","clean":"rimraf --glob _api-extractor-temp nyc dist lib \"**/*.tsbuildinfo\" \"**/*.build.log\"","eslint":"eslint src","format":"npm run prettier:fix","rebuild":"npm run clean && npm run build","lint:fix":"npm run prettier:fix && npm run eslint:fix","prettier":"prettier --check . --ignore-path ../../../../.prettierignore","tsc:watch":"tsc --watch","build:docs":"api-extractor run --local","eslint:fix":"eslint src --fix","test:mocha":"mocha \"dist/**/*.test.js\" --exit","build:esnext":"tsc --project ./tsconfig.esnext.json","build:genver":"gen-version","prettier:fix":"prettier --write . --ignore-path ../../../../.prettierignore","build:compile":"fluid-build . --task compile","ci:build:docs":"api-extractor run","test:coverage":"c8 npm test","typetests:gen":"fluid-type-test-generator","build:commonjs":"fluid-build . --task commonjs","format-and-build":"npm run format && npm run build","typetests:prepare":"flub typetests --dir . --reset --previous --normalize","format-and-compile":"npm run format && npm run build:compile"},"_npmUser":{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},"_resolved":"/mnt/vss/_work/1/pack/scoped/fluid-experimental-devtools-core-2.0.0-internal.7.3.0.tgz","_integrity":"sha512-OR25y68u7/+BQqcm6+Bi2Psoc+R3LhWDDxFCy6iYSTDvJkFQU+lKT5BQHewREszwK4la9O7PtWIdIHMan8/quQ==","fluidBuild":{"tasks":{"tsc":["...","typetests:gen"]}},"repository":{"url":"git+https://github.com/microsoft/FluidFramework.git","type":"git","directory":"packages/tools/devtools/devtools-core"},"_npmVersion":"9.6.7","description":"Fluid Framework developer tools core functionality","directories":{},"sideEffects":false,"_nodeVersion":"18.17.1","dependencies":{"@fluidframework/map":">=2.0.0-internal.7.3.0 <2.0.0-internal.7.4.0","@fluidframework/cell":">=2.0.0-internal.7.3.0 <2.0.0-internal.7.4.0","@fluidframework/matrix":">=2.0.0-internal.7.3.0 <2.0.0-internal.7.4.0","@fluidframework/counter":">=2.0.0-internal.7.3.0 <2.0.0-internal.7.4.0","@fluidframework/sequence":">=2.0.0-internal.7.3.0 <2.0.0-internal.7.4.0","@fluid-experimental/tree2":">=2.0.0-internal.7.3.0 <2.0.0-internal.7.4.0","@fluid-internal/client-utils":">=2.0.0-internal.7.3.0 <2.0.0-internal.7.4.0","@fluidframework/core-interfaces":">=2.0.0-internal.7.3.0 <2.0.0-internal.7.4.0","@fluidframework/telemetry-utils":">=2.0.0-internal.7.3.0 <2.0.0-internal.7.4.0","@fluidframework/container-loader":">=2.0.0-internal.7.3.0 <2.0.0-internal.7.4.0","@fluidframework/shared-object-base":">=2.0.0-internal.7.3.0 <2.0.0-internal.7.4.0","@fluidframework/protocol-definitions":"^3.0.0","@fluidframework/container-definitions":">=2.0.0-internal.7.3.0 <2.0.0-internal.7.4.0","@fluidframework/datastore-definitions":">=2.0.0-internal.7.3.0 <2.0.0-internal.7.4.0"},"_hasShrinkwrap":false,"readmeFilename":"README.md","typeValidation":{"broken":{}},"devDependencies":{"c8":"^7.7.1","chai":"^4.2.0","mocha":"^10.2.0","eslint":"~8.50.0","events":"^3.1.0","moment":"^2.21.0","rimraf":"^4.4.0","prettier":"~3.0.3","cross-env":"^7.0.3","typescript":"~5.1.6","@types/chai":"^4.0.0","@types/mocha":"^9.1.1","@types/events":"^3.0.0","mocha-multi-reporters":"^1.5.1","@fluid-tools/build-cli":"^0.28.0","eslint-config-prettier":"~9.0.0","@microsoft/api-extractor":"^7.38.3","eslint-plugin-chai-expect":"~3.0.0","mocha-json-output-reporter":"^2.0.1","@fluidframework/build-tools":"^0.28.0","@fluidframework/build-common":"^2.0.3","@fluidframework/mocha-test-setup":">=2.0.0-internal.7.3.0 <2.0.0-internal.7.4.0","@fluidframework/driver-definitions":">=2.0.0-internal.7.3.0 <2.0.0-internal.7.4.0","@fluidframework/test-runtime-utils":">=2.0.0-internal.7.3.0 <2.0.0-internal.7.4.0","@fluidframework/eslint-config-fluid":"^3.1.0","@fluid-experimental/devtools-core-previous":"npm:@fluid-experimental/devtools-core@2.0.0-internal.7.2.0"},"_npmOperationalInternal":{"tmp":"tmp/devtools-core_2.0.0-internal.7.3.0_1700256071342_0.3299050735862705","host":"s3://npm-registry-packages"}},"2.0.0-dev.7.4.0.214930":{"name":"@fluid-experimental/devtools-core","version":"2.0.0-dev.7.4.0.214930","author":{"name":"Microsoft and contributors"},"license":"MIT","_id":"@fluid-experimental/devtools-core@2.0.0-dev.7.4.0.214930","maintainers":[{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},{"name":"curtisman","email":"curtism@microsoft.com"}],"homepage":"https://fluidframework.com","bugs":{"url":"https://github.com/microsoft/FluidFramework/issues"},"c8":{"all":true,"exclude":["src/test/**/*.ts","dist/test/**/*.js"],"include":["src/**/*.ts","dist/**/*.js"],"reporter":["cobertura","html","text"],"cache-dir":"nyc/.cache","report-dir":"nyc/report","temp-directory":"nyc/.nyc_output","exclude-after-remap":false},"dist":{"shasum":"b52a6299e4bc11109d32002ab7c39e720d4079f4","tarball":"https://registry.npmjs.org/@fluid-experimental/devtools-core/-/devtools-core-2.0.0-dev.7.4.0.214930.tgz","fileCount":509,"integrity":"sha512-5fB8wI5kc/XzRy9MXEHqzu5qbTm7qLwaLX6NLXN4gOea8lm6tqalrGsWgDyKzI3mKcxWfl9m1xBXXG8un9/QYg==","signatures":[{"sig":"MEYCIQDReNxfNDhqT0XMwqh7iMfP6R0BnPCSk6PCC40tTMI1bwIhAIz9uKgm3SJXhWJhYSCmkRPKg3d7FXbka/MUBHKs2pma","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}],"unpackedSize":1640414},"main":"dist/index.js","_from":"file:fluid-experimental-devtools-core-2.0.0-dev.7.4.0.214930.tgz","types":"dist/index.d.ts","module":"lib/index.js","readme":"# @fluid-experimental/devtools-core\n\nThis library contains developer tools for use alongside the Fluid Framework.\nIt is used to power our associated [browser extension][browser-extension].\n\n- Chrome: \n- Edge: \n\n\n\n**IMPORTANT: This package is experimental.**\n**Its APIs may change without notice.**\n\n**Do not use in production scenarios.**\n\n\n\n\n\n\n\n\n## Installation\n\nTo get started, install the package by running the following command:\n\n```bash\nnpm i @fluid-experimental/devtools-core -D\n```\n\n\n\n\n\n## Usage\n\nThe Devtools' API surface is designed to fit nicely into most application flows.\n\n### Initialization\n\nTo initialize a devtools session for your container, call [`initializeDevtools`][initialize-devtools-docs].\nThis function accepts a `DevtoolsLogger` for receiving Fluid telemetry from your application, a list of initial Fluid\n`Containers` to associate with the session, and (optionally) customized data visualization configurations for visualizing\n`Container` data.\n\n#### About the [`DevtoolsLogger`][devtools-logger-docs]\n\nThe `DevtoolsLogger` is an optional piece when calling `initializeDevtools` but it is strongly recommended that you use\nit because several features in Fluid Devtools are powered by the telemetry that Fluid Framework generates, and this\nlogger is the way in which that telemetry gets into Fluid Devtools.\n\nYou can obtain a `DevtoolsLogger` by calling its constructor, and then should pass it to `initializeDevtools` _and_\nto the `Loader` instance you'll use to create/load Containers as shown below.\nThis way the logger will receive all the telemetry generated by Fluid Framework in your application, and forward it to\nFluid Devtools as necessary.\n\n```typescript\nimport { DevtoolsLogger, initializeDevtools } from \"@fluid-experimental/devtools-core\";\n\n// Instantiate the logger\nconst devtoolsLogger = new DevtoolsLogger();\n\n// Pass the logger when instantiating the Loader\nconst loader = new Loader({\n\tlogger: devtoolsLogger,\n\t// Other necessary properties ...\n});\n\n// Use the Loader to create (and optionally, attach) a Container\nconst container = await loader.createDetachedContainer(/* params */);\nawait container.attach(/* params */);\n\n// Initialize the Devtools passing the logger and your Container.\n// The Container could be added later as well with devtools.registerContainerDevtools().\nconst devtools = initializeDevtools({\n\tlogger: devtoolsLogger,\n\tinitialContainers: [\n\t\t{\n\t\t\tcontainer,\n\t\t\tcontainerKey: \"My Container\",\n\t\t},\n\t],\n});\n```\n\nIf you're working with `AzureClient` instead of lower-level APIs like the one described above, you probably want to\nrefer to the [@fluid-experimental/devtools package][devtools-package] instead of this one.\n\nDuring local development the recommendation is that your application should receive the `DevtoolsLogger` instance _instead_\nof any logger it would normally receive when deployed to a real environment, to avoid local development activity from\nmixing with real telemetry.\nIf you still want to provide a real application logger and use the Fluid Devtools features that are powered by telemetry\nat the same time, you can pass an existing logger to the `DevtoolsLogger` constructor and it will forward all telemetry\nit receives to that logger as well:\n\n```typescript\nimport { DevtoolsLogger } from \"@fluid-experimental/devtools-core\";\n\n// Your application's logger\nconst yourApplicationLogger = getInstanceOfYourApplicationLogger();\n\nconst devtoolsLogger = new DevtoolsLogger(yourApplicationLogger);\n\n// Pass devtoolsLogger to initializeDevtools() and to your application as described above\n```\n\n### Clean-up\n\nThe Devtools object is managed as a global singleton.\nThat singleton is automatically cleaned up prior to the Window's \"unload\" event.\nSo typical application flows likely won't need to worry about cleanup.\nThat said, if you wish to have tighter control over when the Devtools are torn down, you can simply call the `dispose` method on the handle returned by [initialization](#initialization).\n\n## Contributing to the package\n\n### Build\n\nTo build the package locally, first ensure you have run `pnpm install` from the root of the mono-repo.\nNext, to build the code, run `npm run build` from the root of the mono-repo, or use [fluid-build](https://github.com/microsoft/FluidFramework/tree/main/build-tools/packages/build-tools#running-fluid-build-command-line) via `fluid-build -t build`.\n\n- Note: Once you have run a build from the root, assuming no other changes outside of this package, you may run `npm run build` directly within this directory for a faster build.\n If you make changes to any of this package's local dependencies, you will need to run a build again from the root before building again from directly within this package.\n\n### Test\n\nTo run the tests, first ensure you have followed the [build](#build) steps above.\nNext, run `npm run test` from a terminal within this directory.\n\n\n\n\n\n\n\n## API Documentation\n\nAPI documentation for **@fluid-experimental/devtools-core** is available at .\n\n\n\n\n\n\n\n\n\n\n## Contribution Guidelines\n\nThere are many ways to [contribute](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md) to Fluid.\n\n- Participate in Q&A in our [GitHub Discussions](https://github.com/microsoft/FluidFramework/discussions).\n- [Submit bugs](https://github.com/microsoft/FluidFramework/issues) and help us verify fixes as they are checked in.\n- Review the [source code changes](https://github.com/microsoft/FluidFramework/pulls).\n- [Contribute bug fixes](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md).\n\nDetailed instructions for working in the repo can be found in the [Wiki](https://github.com/microsoft/FluidFramework/wiki).\n\nThis project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).\nFor more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\nUse of these trademarks or logos must follow Microsoft’s [Trademark & Brand Guidelines](https://www.microsoft.com/trademarks).\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n\n\n\n## Help\n\nNot finding what you're looking for in this README? Check out our [GitHub\nWiki](https://github.com/microsoft/FluidFramework/wiki) or [fluidframework.com](https://fluidframework.com/docs/).\n\nStill not finding what you're looking for? Please [file an\nissue](https://github.com/microsoft/FluidFramework/wiki/Submitting-Bugs-and-Feature-Requests).\n\nThank you!\n\n\n\n\n\n\n\n\n\n\n## Trademark\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\n\nUse of these trademarks or logos must follow Microsoft's [Trademark & Brand Guidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general).\n\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n[initialize-devtools-docs]: https://fluidframework.com/docs/apis/devtools-core#initializedevtools-function\n[devtools-logger-docs]: https://fluidframework.com/docs/apis/devtools-core/devtoolslogger-class\n[devtools-package]: https://www.npmjs.com/package/@fluid-experimental/devtools\n[browser-extension]: https://github.com/microsoft/FluidFramework/tree/main/packages/tools/devtools/devtools-browser-extension\n","scripts":{"api":"fluid-build . --task api","tsc":"tsc","lint":"npm run prettier && npm run eslint","test":"npm run test:mocha","build":"fluid-build . --task build","clean":"rimraf --glob _api-extractor-temp nyc dist lib \"**/*.tsbuildinfo\" \"**/*.build.log\"","eslint":"eslint src","format":"npm run prettier:fix","rebuild":"npm run clean && npm run build","lint:fix":"npm run prettier:fix && npm run eslint:fix","prettier":"prettier --check . --cache --ignore-path ../../../../.prettierignore","tsc:watch":"tsc --watch","build:docs":"fluid-build . --task api","eslint:fix":"eslint src --fix","test:mocha":"mocha \"dist/**/*.test.js\" --exit","build:esnext":"tsc --project ./tsconfig.esnext.json","build:genver":"gen-version","prettier:fix":"prettier --write . --cache --ignore-path ../../../../.prettierignore","build:compile":"fluid-build . --task compile","ci:build:docs":"api-extractor run","test:coverage":"c8 npm test","typetests:gen":"fluid-type-test-generator","build:commonjs":"fluid-build . --task commonjs","format-and-build":"npm run format && npm run build","typetests:prepare":"flub typetests --dir . --reset --previous --normalize","format-and-compile":"npm run format && npm run build:compile","api-extractor:esnext":"copyfiles -u 1 \"dist/**/*-@(alpha|beta|public|untrimmed).d.ts\" lib","api-extractor:commonjs":"api-extractor run --local"},"_npmUser":{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},"_resolved":"/mnt/vss/_work/1/pack/scoped/fluid-experimental-devtools-core-2.0.0-dev.7.4.0.214930.tgz","_integrity":"sha512-5fB8wI5kc/XzRy9MXEHqzu5qbTm7qLwaLX6NLXN4gOea8lm6tqalrGsWgDyKzI3mKcxWfl9m1xBXXG8un9/QYg==","fluidBuild":{"tasks":{"tsc":["...","typetests:gen"],"build:docs":{"script":false,"dependsOn":["...","api-extractor:commonjs","api-extractor:esnext"]}}},"repository":{"url":"git+https://github.com/microsoft/FluidFramework.git","type":"git","directory":"packages/tools/devtools/devtools-core"},"_npmVersion":"9.6.7","description":"Fluid Framework developer tools core functionality","directories":{},"sideEffects":false,"_nodeVersion":"18.17.1","dependencies":{"@fluidframework/map":"2.0.0-dev.7.4.0.214930","@fluidframework/cell":"2.0.0-dev.7.4.0.214930","@fluidframework/matrix":"2.0.0-dev.7.4.0.214930","@fluidframework/counter":"2.0.0-dev.7.4.0.214930","@fluidframework/sequence":"2.0.0-dev.7.4.0.214930","@fluid-experimental/tree2":"2.0.0-dev.7.4.0.214930","@fluid-internal/client-utils":"2.0.0-dev.7.4.0.214930","@fluidframework/core-interfaces":"2.0.0-dev.7.4.0.214930","@fluidframework/telemetry-utils":"2.0.0-dev.7.4.0.214930","@fluidframework/container-loader":"2.0.0-dev.7.4.0.214930","@fluidframework/shared-object-base":"2.0.0-dev.7.4.0.214930","@fluidframework/protocol-definitions":"^3.0.0","@fluidframework/container-definitions":"2.0.0-dev.7.4.0.214930","@fluidframework/datastore-definitions":"2.0.0-dev.7.4.0.214930"},"_hasShrinkwrap":false,"readmeFilename":"README.md","typeValidation":{"broken":{}},"devDependencies":{"c8":"^7.7.1","chai":"^4.2.0","mocha":"^10.2.0","eslint":"~8.50.0","events":"^3.1.0","moment":"^2.21.0","rimraf":"^4.4.0","prettier":"~3.0.3","copyfiles":"^2.4.1","cross-env":"^7.0.3","typescript":"~5.1.6","@types/chai":"^4.0.0","@types/mocha":"^9.1.1","@types/events":"^3.0.0","mocha-multi-reporters":"^1.5.1","@fluid-tools/build-cli":"^0.28.0","eslint-config-prettier":"~9.0.0","@microsoft/api-extractor":"^7.38.3","eslint-plugin-chai-expect":"~3.0.0","mocha-json-output-reporter":"^2.0.1","@fluidframework/build-tools":"^0.28.0","@fluidframework/build-common":"^2.0.3","@fluidframework/mocha-test-setup":"2.0.0-dev.7.4.0.214930","@fluidframework/driver-definitions":"2.0.0-dev.7.4.0.214930","@fluidframework/test-runtime-utils":"2.0.0-dev.7.4.0.214930","@fluidframework/eslint-config-fluid":"^3.1.0","@fluid-experimental/devtools-core-previous":"npm:@fluid-experimental/devtools-core@2.0.0-internal.7.2.0"},"_npmOperationalInternal":{"tmp":"tmp/devtools-core_2.0.0-dev.7.4.0.214930_1701214809154_0.2202705557647795","host":"s3://npm-registry-packages"}},"2.0.0-dev.7.4.0.215366":{"name":"@fluid-experimental/devtools-core","version":"2.0.0-dev.7.4.0.215366","author":{"name":"Microsoft and contributors"},"license":"MIT","_id":"@fluid-experimental/devtools-core@2.0.0-dev.7.4.0.215366","maintainers":[{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},{"name":"curtisman","email":"curtism@microsoft.com"}],"homepage":"https://fluidframework.com","bugs":{"url":"https://github.com/microsoft/FluidFramework/issues"},"c8":{"all":true,"exclude":["src/test/**/*.ts","dist/test/**/*.js"],"include":["src/**/*.ts","dist/**/*.js"],"reporter":["cobertura","html","text"],"cache-dir":"nyc/.cache","report-dir":"nyc/report","temp-directory":"nyc/.nyc_output","exclude-after-remap":false},"dist":{"shasum":"d8ad9e607f19bc9fb1501d189ded6b1df4d0d0ea","tarball":"https://registry.npmjs.org/@fluid-experimental/devtools-core/-/devtools-core-2.0.0-dev.7.4.0.215366.tgz","fileCount":509,"integrity":"sha512-+ql0mb0hTZ5EGV+1L9mQBGfeMeZwjOFlJdl+EnEKgkE9vwLvkfnaRMj+kzfoj1QyNPcfdY9VLBT09ntMtEeMPA==","signatures":[{"sig":"MEQCIBtxqjlBh7nUJsFfLj62mfIwfEsGYv4+uKv//78AEPp5AiBKf4yrNSXcZ90VB41P2hvENGoPy4ukLZ+czlOJV/XL7g==","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}],"unpackedSize":1640414},"main":"dist/index.js","_from":"file:fluid-experimental-devtools-core-2.0.0-dev.7.4.0.215366.tgz","types":"dist/index.d.ts","module":"lib/index.js","readme":"# @fluid-experimental/devtools-core\n\nThis library contains developer tools for use alongside the Fluid Framework.\nIt is used to power our associated [browser extension][browser-extension].\n\n- Chrome: \n- Edge: \n\n\n\n**IMPORTANT: This package is experimental.**\n**Its APIs may change without notice.**\n\n**Do not use in production scenarios.**\n\n\n\n\n\n\n\n\n## Installation\n\nTo get started, install the package by running the following command:\n\n```bash\nnpm i @fluid-experimental/devtools-core -D\n```\n\n\n\n\n\n## Usage\n\nThe Devtools' API surface is designed to fit nicely into most application flows.\n\n### Initialization\n\nTo initialize a devtools session for your container, call [`initializeDevtools`][initialize-devtools-docs].\nThis function accepts a `DevtoolsLogger` for receiving Fluid telemetry from your application, a list of initial Fluid\n`Containers` to associate with the session, and (optionally) customized data visualization configurations for visualizing\n`Container` data.\n\n#### About the [`DevtoolsLogger`][devtools-logger-docs]\n\nThe `DevtoolsLogger` is an optional piece when calling `initializeDevtools` but it is strongly recommended that you use\nit because several features in Fluid Devtools are powered by the telemetry that Fluid Framework generates, and this\nlogger is the way in which that telemetry gets into Fluid Devtools.\n\nYou can obtain a `DevtoolsLogger` by calling its constructor, and then should pass it to `initializeDevtools` _and_\nto the `Loader` instance you'll use to create/load Containers as shown below.\nThis way the logger will receive all the telemetry generated by Fluid Framework in your application, and forward it to\nFluid Devtools as necessary.\n\n```typescript\nimport { DevtoolsLogger, initializeDevtools } from \"@fluid-experimental/devtools-core\";\n\n// Instantiate the logger\nconst devtoolsLogger = new DevtoolsLogger();\n\n// Pass the logger when instantiating the Loader\nconst loader = new Loader({\n\tlogger: devtoolsLogger,\n\t// Other necessary properties ...\n});\n\n// Use the Loader to create (and optionally, attach) a Container\nconst container = await loader.createDetachedContainer(/* params */);\nawait container.attach(/* params */);\n\n// Initialize the Devtools passing the logger and your Container.\n// The Container could be added later as well with devtools.registerContainerDevtools().\nconst devtools = initializeDevtools({\n\tlogger: devtoolsLogger,\n\tinitialContainers: [\n\t\t{\n\t\t\tcontainer,\n\t\t\tcontainerKey: \"My Container\",\n\t\t},\n\t],\n});\n```\n\nIf you're working with `AzureClient` instead of lower-level APIs like the one described above, you probably want to\nrefer to the [@fluid-experimental/devtools package][devtools-package] instead of this one.\n\nDuring local development the recommendation is that your application should receive the `DevtoolsLogger` instance _instead_\nof any logger it would normally receive when deployed to a real environment, to avoid local development activity from\nmixing with real telemetry.\nIf you still want to provide a real application logger and use the Fluid Devtools features that are powered by telemetry\nat the same time, you can pass an existing logger to the `DevtoolsLogger` constructor and it will forward all telemetry\nit receives to that logger as well:\n\n```typescript\nimport { DevtoolsLogger } from \"@fluid-experimental/devtools-core\";\n\n// Your application's logger\nconst yourApplicationLogger = getInstanceOfYourApplicationLogger();\n\nconst devtoolsLogger = new DevtoolsLogger(yourApplicationLogger);\n\n// Pass devtoolsLogger to initializeDevtools() and to your application as described above\n```\n\n### Clean-up\n\nThe Devtools object is managed as a global singleton.\nThat singleton is automatically cleaned up prior to the Window's \"unload\" event.\nSo typical application flows likely won't need to worry about cleanup.\nThat said, if you wish to have tighter control over when the Devtools are torn down, you can simply call the `dispose` method on the handle returned by [initialization](#initialization).\n\n## Contributing to the package\n\n### Build\n\nTo build the package locally, first ensure you have run `pnpm install` from the root of the mono-repo.\nNext, to build the code, run `npm run build` from the root of the mono-repo, or use [fluid-build](https://github.com/microsoft/FluidFramework/tree/main/build-tools/packages/build-tools#running-fluid-build-command-line) via `fluid-build -t build`.\n\n- Note: Once you have run a build from the root, assuming no other changes outside of this package, you may run `npm run build` directly within this directory for a faster build.\n If you make changes to any of this package's local dependencies, you will need to run a build again from the root before building again from directly within this package.\n\n### Test\n\nTo run the tests, first ensure you have followed the [build](#build) steps above.\nNext, run `npm run test` from a terminal within this directory.\n\n\n\n\n\n\n\n## API Documentation\n\nAPI documentation for **@fluid-experimental/devtools-core** is available at .\n\n\n\n\n\n\n\n\n\n\n## Contribution Guidelines\n\nThere are many ways to [contribute](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md) to Fluid.\n\n- Participate in Q&A in our [GitHub Discussions](https://github.com/microsoft/FluidFramework/discussions).\n- [Submit bugs](https://github.com/microsoft/FluidFramework/issues) and help us verify fixes as they are checked in.\n- Review the [source code changes](https://github.com/microsoft/FluidFramework/pulls).\n- [Contribute bug fixes](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md).\n\nDetailed instructions for working in the repo can be found in the [Wiki](https://github.com/microsoft/FluidFramework/wiki).\n\nThis project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).\nFor more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\nUse of these trademarks or logos must follow Microsoft’s [Trademark & Brand Guidelines](https://www.microsoft.com/trademarks).\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n\n\n\n## Help\n\nNot finding what you're looking for in this README? Check out our [GitHub\nWiki](https://github.com/microsoft/FluidFramework/wiki) or [fluidframework.com](https://fluidframework.com/docs/).\n\nStill not finding what you're looking for? Please [file an\nissue](https://github.com/microsoft/FluidFramework/wiki/Submitting-Bugs-and-Feature-Requests).\n\nThank you!\n\n\n\n\n\n\n\n\n\n\n## Trademark\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\n\nUse of these trademarks or logos must follow Microsoft's [Trademark & Brand Guidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general).\n\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n[initialize-devtools-docs]: https://fluidframework.com/docs/apis/devtools-core#initializedevtools-function\n[devtools-logger-docs]: https://fluidframework.com/docs/apis/devtools-core/devtoolslogger-class\n[devtools-package]: https://www.npmjs.com/package/@fluid-experimental/devtools\n[browser-extension]: https://github.com/microsoft/FluidFramework/tree/main/packages/tools/devtools/devtools-browser-extension\n","scripts":{"api":"fluid-build . --task api","tsc":"tsc","lint":"npm run prettier && npm run eslint","test":"npm run test:mocha","build":"fluid-build . --task build","clean":"rimraf --glob _api-extractor-temp nyc dist lib \"**/*.tsbuildinfo\" \"**/*.build.log\"","eslint":"eslint src","format":"npm run prettier:fix","rebuild":"npm run clean && npm run build","lint:fix":"npm run prettier:fix && npm run eslint:fix","prettier":"prettier --check . --cache --ignore-path ../../../../.prettierignore","tsc:watch":"tsc --watch","build:docs":"fluid-build . --task api","eslint:fix":"eslint src --fix","test:mocha":"mocha \"dist/**/*.test.js\" --exit","build:esnext":"tsc --project ./tsconfig.esnext.json","build:genver":"gen-version","prettier:fix":"prettier --write . --cache --ignore-path ../../../../.prettierignore","build:compile":"fluid-build . --task compile","ci:build:docs":"api-extractor run","test:coverage":"c8 npm test","typetests:gen":"fluid-type-test-generator","build:commonjs":"fluid-build . --task commonjs","format-and-build":"npm run format && npm run build","typetests:prepare":"flub typetests --dir . --reset --previous --normalize","format-and-compile":"npm run format && npm run build:compile","api-extractor:esnext":"copyfiles -u 1 \"dist/**/*-@(alpha|beta|public|untrimmed).d.ts\" lib","api-extractor:commonjs":"api-extractor run --local"},"_npmUser":{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},"_resolved":"/mnt/vss/_work/1/pack/scoped/fluid-experimental-devtools-core-2.0.0-dev.7.4.0.215366.tgz","_integrity":"sha512-+ql0mb0hTZ5EGV+1L9mQBGfeMeZwjOFlJdl+EnEKgkE9vwLvkfnaRMj+kzfoj1QyNPcfdY9VLBT09ntMtEeMPA==","fluidBuild":{"tasks":{"tsc":["...","typetests:gen"],"build:docs":{"script":false,"dependsOn":["...","api-extractor:commonjs","api-extractor:esnext"]}}},"repository":{"url":"git+https://github.com/microsoft/FluidFramework.git","type":"git","directory":"packages/tools/devtools/devtools-core"},"_npmVersion":"9.6.7","description":"Fluid Framework developer tools core functionality","directories":{},"sideEffects":false,"_nodeVersion":"18.17.1","dependencies":{"@fluidframework/map":"2.0.0-dev.7.4.0.215366","@fluidframework/cell":"2.0.0-dev.7.4.0.215366","@fluidframework/matrix":"2.0.0-dev.7.4.0.215366","@fluidframework/counter":"2.0.0-dev.7.4.0.215366","@fluidframework/sequence":"2.0.0-dev.7.4.0.215366","@fluid-experimental/tree2":"2.0.0-dev.7.4.0.215366","@fluid-internal/client-utils":"2.0.0-dev.7.4.0.215366","@fluidframework/core-interfaces":"2.0.0-dev.7.4.0.215366","@fluidframework/telemetry-utils":"2.0.0-dev.7.4.0.215366","@fluidframework/container-loader":"2.0.0-dev.7.4.0.215366","@fluidframework/shared-object-base":"2.0.0-dev.7.4.0.215366","@fluidframework/protocol-definitions":"^3.0.0","@fluidframework/container-definitions":"2.0.0-dev.7.4.0.215366","@fluidframework/datastore-definitions":"2.0.0-dev.7.4.0.215366"},"_hasShrinkwrap":false,"readmeFilename":"README.md","typeValidation":{"broken":{}},"devDependencies":{"c8":"^7.7.1","chai":"^4.2.0","mocha":"^10.2.0","eslint":"~8.50.0","events":"^3.1.0","moment":"^2.21.0","rimraf":"^4.4.0","prettier":"~3.0.3","copyfiles":"^2.4.1","cross-env":"^7.0.3","typescript":"~5.1.6","@types/chai":"^4.0.0","@types/mocha":"^9.1.1","@types/events":"^3.0.0","mocha-multi-reporters":"^1.5.1","@fluid-tools/build-cli":"^0.28.0","eslint-config-prettier":"~9.0.0","@microsoft/api-extractor":"^7.38.3","eslint-plugin-chai-expect":"~3.0.0","mocha-json-output-reporter":"^2.0.1","@fluidframework/build-tools":"^0.28.0","@fluidframework/build-common":"^2.0.3","@fluidframework/mocha-test-setup":"2.0.0-dev.7.4.0.215366","@fluidframework/driver-definitions":"2.0.0-dev.7.4.0.215366","@fluidframework/test-runtime-utils":"2.0.0-dev.7.4.0.215366","@fluidframework/eslint-config-fluid":"^3.1.0","@fluid-experimental/devtools-core-previous":"npm:@fluid-experimental/devtools-core@2.0.0-internal.7.2.0"},"_npmOperationalInternal":{"tmp":"tmp/devtools-core_2.0.0-dev.7.4.0.215366_1701299239231_0.8669775646448972","host":"s3://npm-registry-packages"}},"2.0.0-dev.7.4.0.215747":{"name":"@fluid-experimental/devtools-core","version":"2.0.0-dev.7.4.0.215747","author":{"name":"Microsoft and contributors"},"license":"MIT","_id":"@fluid-experimental/devtools-core@2.0.0-dev.7.4.0.215747","maintainers":[{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},{"name":"curtisman","email":"curtism@microsoft.com"}],"homepage":"https://fluidframework.com","bugs":{"url":"https://github.com/microsoft/FluidFramework/issues"},"c8":{"all":true,"exclude":["src/test/**/*.ts","dist/test/**/*.js"],"include":["src/**/*.ts","dist/**/*.js"],"reporter":["cobertura","html","text"],"cache-dir":"nyc/.cache","report-dir":"nyc/report","temp-directory":"nyc/.nyc_output","exclude-after-remap":false},"dist":{"shasum":"5f50c0e1477a6357f72db3b382e10e0302f4342b","tarball":"https://registry.npmjs.org/@fluid-experimental/devtools-core/-/devtools-core-2.0.0-dev.7.4.0.215747.tgz","fileCount":509,"integrity":"sha512-jcT9aZc9tzaVRgPZ7HYlH8VSBaywwpCAqLXrQHqRlmV4xV7uIcMtfhHCW7YTX01m61GEQiI3dqLCEOVY2y8BGQ==","signatures":[{"sig":"MEUCIQDaXoE81J1OHwUPvBd8gtlTkBhPKYOAQjAn0KLPQSBAfAIgGY6oQAoB1FZJn5oLZzsb3qZe6miK3Y64tdlLUvw5j/M=","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}],"unpackedSize":1640414},"main":"dist/index.js","_from":"file:fluid-experimental-devtools-core-2.0.0-dev.7.4.0.215747.tgz","types":"dist/index.d.ts","module":"lib/index.js","readme":"# @fluid-experimental/devtools-core\n\nThis library contains developer tools for use alongside the Fluid Framework.\nIt is used to power our associated [browser extension][browser-extension].\n\n- Chrome: \n- Edge: \n\n\n\n**IMPORTANT: This package is experimental.**\n**Its APIs may change without notice.**\n\n**Do not use in production scenarios.**\n\n\n\n\n\n\n\n\n## Installation\n\nTo get started, install the package by running the following command:\n\n```bash\nnpm i @fluid-experimental/devtools-core -D\n```\n\n\n\n\n\n## Usage\n\nThe Devtools' API surface is designed to fit nicely into most application flows.\n\n### Initialization\n\nTo initialize a devtools session for your container, call [`initializeDevtools`][initialize-devtools-docs].\nThis function accepts a `DevtoolsLogger` for receiving Fluid telemetry from your application, a list of initial Fluid\n`Containers` to associate with the session, and (optionally) customized data visualization configurations for visualizing\n`Container` data.\n\n#### About the [`DevtoolsLogger`][devtools-logger-docs]\n\nThe `DevtoolsLogger` is an optional piece when calling `initializeDevtools` but it is strongly recommended that you use\nit because several features in Fluid Devtools are powered by the telemetry that Fluid Framework generates, and this\nlogger is the way in which that telemetry gets into Fluid Devtools.\n\nYou can obtain a `DevtoolsLogger` by calling its constructor, and then should pass it to `initializeDevtools` _and_\nto the `Loader` instance you'll use to create/load Containers as shown below.\nThis way the logger will receive all the telemetry generated by Fluid Framework in your application, and forward it to\nFluid Devtools as necessary.\n\n```typescript\nimport { DevtoolsLogger, initializeDevtools } from \"@fluid-experimental/devtools-core\";\n\n// Instantiate the logger\nconst devtoolsLogger = new DevtoolsLogger();\n\n// Pass the logger when instantiating the Loader\nconst loader = new Loader({\n\tlogger: devtoolsLogger,\n\t// Other necessary properties ...\n});\n\n// Use the Loader to create (and optionally, attach) a Container\nconst container = await loader.createDetachedContainer(/* params */);\nawait container.attach(/* params */);\n\n// Initialize the Devtools passing the logger and your Container.\n// The Container could be added later as well with devtools.registerContainerDevtools().\nconst devtools = initializeDevtools({\n\tlogger: devtoolsLogger,\n\tinitialContainers: [\n\t\t{\n\t\t\tcontainer,\n\t\t\tcontainerKey: \"My Container\",\n\t\t},\n\t],\n});\n```\n\nIf you're working with `AzureClient` instead of lower-level APIs like the one described above, you probably want to\nrefer to the [@fluid-experimental/devtools package][devtools-package] instead of this one.\n\nDuring local development the recommendation is that your application should receive the `DevtoolsLogger` instance _instead_\nof any logger it would normally receive when deployed to a real environment, to avoid local development activity from\nmixing with real telemetry.\nIf you still want to provide a real application logger and use the Fluid Devtools features that are powered by telemetry\nat the same time, you can pass an existing logger to the `DevtoolsLogger` constructor and it will forward all telemetry\nit receives to that logger as well:\n\n```typescript\nimport { DevtoolsLogger } from \"@fluid-experimental/devtools-core\";\n\n// Your application's logger\nconst yourApplicationLogger = getInstanceOfYourApplicationLogger();\n\nconst devtoolsLogger = new DevtoolsLogger(yourApplicationLogger);\n\n// Pass devtoolsLogger to initializeDevtools() and to your application as described above\n```\n\n### Clean-up\n\nThe Devtools object is managed as a global singleton.\nThat singleton is automatically cleaned up prior to the Window's \"unload\" event.\nSo typical application flows likely won't need to worry about cleanup.\nThat said, if you wish to have tighter control over when the Devtools are torn down, you can simply call the `dispose` method on the handle returned by [initialization](#initialization).\n\n## Contributing to the package\n\n### Build\n\nTo build the package locally, first ensure you have run `pnpm install` from the root of the mono-repo.\nNext, to build the code, run `npm run build` from the root of the mono-repo, or use [fluid-build](https://github.com/microsoft/FluidFramework/tree/main/build-tools/packages/build-tools#running-fluid-build-command-line) via `fluid-build -t build`.\n\n- Note: Once you have run a build from the root, assuming no other changes outside of this package, you may run `npm run build` directly within this directory for a faster build.\n If you make changes to any of this package's local dependencies, you will need to run a build again from the root before building again from directly within this package.\n\n### Test\n\nTo run the tests, first ensure you have followed the [build](#build) steps above.\nNext, run `npm run test` from a terminal within this directory.\n\n\n\n\n\n\n\n## API Documentation\n\nAPI documentation for **@fluid-experimental/devtools-core** is available at .\n\n\n\n\n\n\n\n\n\n\n## Contribution Guidelines\n\nThere are many ways to [contribute](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md) to Fluid.\n\n- Participate in Q&A in our [GitHub Discussions](https://github.com/microsoft/FluidFramework/discussions).\n- [Submit bugs](https://github.com/microsoft/FluidFramework/issues) and help us verify fixes as they are checked in.\n- Review the [source code changes](https://github.com/microsoft/FluidFramework/pulls).\n- [Contribute bug fixes](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md).\n\nDetailed instructions for working in the repo can be found in the [Wiki](https://github.com/microsoft/FluidFramework/wiki).\n\nThis project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).\nFor more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\nUse of these trademarks or logos must follow Microsoft’s [Trademark & Brand Guidelines](https://www.microsoft.com/trademarks).\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n\n\n\n## Help\n\nNot finding what you're looking for in this README? Check out our [GitHub\nWiki](https://github.com/microsoft/FluidFramework/wiki) or [fluidframework.com](https://fluidframework.com/docs/).\n\nStill not finding what you're looking for? Please [file an\nissue](https://github.com/microsoft/FluidFramework/wiki/Submitting-Bugs-and-Feature-Requests).\n\nThank you!\n\n\n\n\n\n\n\n\n\n\n## Trademark\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\n\nUse of these trademarks or logos must follow Microsoft's [Trademark & Brand Guidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general).\n\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n[initialize-devtools-docs]: https://fluidframework.com/docs/apis/devtools-core#initializedevtools-function\n[devtools-logger-docs]: https://fluidframework.com/docs/apis/devtools-core/devtoolslogger-class\n[devtools-package]: https://www.npmjs.com/package/@fluid-experimental/devtools\n[browser-extension]: https://github.com/microsoft/FluidFramework/tree/main/packages/tools/devtools/devtools-browser-extension\n","scripts":{"api":"fluid-build . --task api","tsc":"tsc","lint":"npm run prettier && npm run eslint","test":"npm run test:mocha","build":"fluid-build . --task build","clean":"rimraf --glob _api-extractor-temp nyc dist lib \"**/*.tsbuildinfo\" \"**/*.build.log\"","eslint":"eslint src","format":"npm run prettier:fix","rebuild":"npm run clean && npm run build","lint:fix":"npm run prettier:fix && npm run eslint:fix","prettier":"prettier --check . --cache --ignore-path ../../../../.prettierignore","tsc:watch":"tsc --watch","build:docs":"fluid-build . --task api","eslint:fix":"eslint src --fix","test:mocha":"mocha \"dist/**/*.test.js\" --exit","build:esnext":"tsc --project ./tsconfig.esnext.json","build:genver":"gen-version","prettier:fix":"prettier --write . --cache --ignore-path ../../../../.prettierignore","build:compile":"fluid-build . --task compile","ci:build:docs":"api-extractor run","test:coverage":"c8 npm test","typetests:gen":"fluid-type-test-generator","build:commonjs":"fluid-build . --task commonjs","format-and-build":"npm run format && npm run build","typetests:prepare":"flub typetests --dir . --reset --previous --normalize","format-and-compile":"npm run format && npm run build:compile","api-extractor:esnext":"copyfiles -u 1 \"dist/**/*-@(alpha|beta|public|untrimmed).d.ts\" lib","api-extractor:commonjs":"api-extractor run --local"},"_npmUser":{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},"_resolved":"/mnt/vss/_work/1/pack/scoped/fluid-experimental-devtools-core-2.0.0-dev.7.4.0.215747.tgz","_integrity":"sha512-jcT9aZc9tzaVRgPZ7HYlH8VSBaywwpCAqLXrQHqRlmV4xV7uIcMtfhHCW7YTX01m61GEQiI3dqLCEOVY2y8BGQ==","fluidBuild":{"tasks":{"tsc":["...","typetests:gen"],"build:docs":{"script":false,"dependsOn":["...","api-extractor:commonjs","api-extractor:esnext"]}}},"repository":{"url":"git+https://github.com/microsoft/FluidFramework.git","type":"git","directory":"packages/tools/devtools/devtools-core"},"_npmVersion":"9.6.7","description":"Fluid Framework developer tools core functionality","directories":{},"sideEffects":false,"_nodeVersion":"18.17.1","dependencies":{"@fluidframework/map":"2.0.0-dev.7.4.0.215747","@fluidframework/cell":"2.0.0-dev.7.4.0.215747","@fluidframework/matrix":"2.0.0-dev.7.4.0.215747","@fluidframework/counter":"2.0.0-dev.7.4.0.215747","@fluidframework/sequence":"2.0.0-dev.7.4.0.215747","@fluid-experimental/tree2":"2.0.0-dev.7.4.0.215747","@fluid-internal/client-utils":"2.0.0-dev.7.4.0.215747","@fluidframework/core-interfaces":"2.0.0-dev.7.4.0.215747","@fluidframework/telemetry-utils":"2.0.0-dev.7.4.0.215747","@fluidframework/container-loader":"2.0.0-dev.7.4.0.215747","@fluidframework/shared-object-base":"2.0.0-dev.7.4.0.215747","@fluidframework/protocol-definitions":"^3.0.0","@fluidframework/container-definitions":"2.0.0-dev.7.4.0.215747","@fluidframework/datastore-definitions":"2.0.0-dev.7.4.0.215747"},"_hasShrinkwrap":false,"readmeFilename":"README.md","typeValidation":{"broken":{}},"devDependencies":{"c8":"^7.7.1","chai":"^4.2.0","mocha":"^10.2.0","eslint":"~8.50.0","events":"^3.1.0","moment":"^2.21.0","rimraf":"^4.4.0","prettier":"~3.0.3","copyfiles":"^2.4.1","cross-env":"^7.0.3","typescript":"~5.1.6","@types/chai":"^4.0.0","@types/mocha":"^9.1.1","@types/events":"^3.0.0","mocha-multi-reporters":"^1.5.1","@fluid-tools/build-cli":"^0.28.0","eslint-config-prettier":"~9.0.0","@microsoft/api-extractor":"^7.38.3","eslint-plugin-chai-expect":"~3.0.0","mocha-json-output-reporter":"^2.0.1","@fluidframework/build-tools":"^0.28.0","@fluidframework/build-common":"^2.0.3","@fluidframework/mocha-test-setup":"2.0.0-dev.7.4.0.215747","@fluidframework/driver-definitions":"2.0.0-dev.7.4.0.215747","@fluidframework/test-runtime-utils":"2.0.0-dev.7.4.0.215747","@fluidframework/eslint-config-fluid":"^3.1.0","@fluid-experimental/devtools-core-previous":"npm:@fluid-experimental/devtools-core@2.0.0-internal.7.2.0"},"_npmOperationalInternal":{"tmp":"tmp/devtools-core_2.0.0-dev.7.4.0.215747_1701365531694_0.6411765845158401","host":"s3://npm-registry-packages"}},"2.0.0-dev.7.4.0.215930":{"name":"@fluid-experimental/devtools-core","version":"2.0.0-dev.7.4.0.215930","author":{"name":"Microsoft and contributors"},"license":"MIT","_id":"@fluid-experimental/devtools-core@2.0.0-dev.7.4.0.215930","maintainers":[{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},{"name":"curtisman","email":"curtism@microsoft.com"}],"homepage":"https://fluidframework.com","bugs":{"url":"https://github.com/microsoft/FluidFramework/issues"},"c8":{"all":true,"exclude":["src/test/**/*.ts","dist/test/**/*.js"],"include":["src/**/*.ts","dist/**/*.js"],"reporter":["cobertura","html","text"],"cache-dir":"nyc/.cache","report-dir":"nyc/report","temp-directory":"nyc/.nyc_output","exclude-after-remap":false},"dist":{"shasum":"cdcf4804beb9efc87b8933edf30e6a519baf4c50","tarball":"https://registry.npmjs.org/@fluid-experimental/devtools-core/-/devtools-core-2.0.0-dev.7.4.0.215930.tgz","fileCount":509,"integrity":"sha512-GLSoqCyALkfx9cOFI0c5RAltZfRhO/BqHfE9L7DOxeUjUXv8pmV2EV7clsemMeSmZAu1xGMP99MBrnPy77WlMA==","signatures":[{"sig":"MEUCIQDZBXB//LerUYdiALOawPapGqciKeHd7E0KSP7WjAKzvAIgZr6BjmLiyXULaL+0fe9QGgAkzICONQV/31NxS5wk4d4=","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}],"unpackedSize":1640414},"main":"dist/index.js","_from":"file:fluid-experimental-devtools-core-2.0.0-dev.7.4.0.215930.tgz","types":"dist/index.d.ts","module":"lib/index.js","readme":"# @fluid-experimental/devtools-core\n\nThis library contains developer tools for use alongside the Fluid Framework.\nIt is used to power our associated [browser extension][browser-extension].\n\n- Chrome: \n- Edge: \n\n\n\n**IMPORTANT: This package is experimental.**\n**Its APIs may change without notice.**\n\n**Do not use in production scenarios.**\n\n\n\n\n\n\n\n\n## Installation\n\nTo get started, install the package by running the following command:\n\n```bash\nnpm i @fluid-experimental/devtools-core -D\n```\n\n\n\n\n\n## Usage\n\nThe Devtools' API surface is designed to fit nicely into most application flows.\n\n### Initialization\n\nTo initialize a devtools session for your container, call [`initializeDevtools`][initialize-devtools-docs].\nThis function accepts a `DevtoolsLogger` for receiving Fluid telemetry from your application, a list of initial Fluid\n`Containers` to associate with the session, and (optionally) customized data visualization configurations for visualizing\n`Container` data.\n\n#### About the [`DevtoolsLogger`][devtools-logger-docs]\n\nThe `DevtoolsLogger` is an optional piece when calling `initializeDevtools` but it is strongly recommended that you use\nit because several features in Fluid Devtools are powered by the telemetry that Fluid Framework generates, and this\nlogger is the way in which that telemetry gets into Fluid Devtools.\n\nYou can obtain a `DevtoolsLogger` by calling its constructor, and then should pass it to `initializeDevtools` _and_\nto the `Loader` instance you'll use to create/load Containers as shown below.\nThis way the logger will receive all the telemetry generated by Fluid Framework in your application, and forward it to\nFluid Devtools as necessary.\n\n```typescript\nimport { DevtoolsLogger, initializeDevtools } from \"@fluid-experimental/devtools-core\";\n\n// Instantiate the logger\nconst devtoolsLogger = new DevtoolsLogger();\n\n// Pass the logger when instantiating the Loader\nconst loader = new Loader({\n\tlogger: devtoolsLogger,\n\t// Other necessary properties ...\n});\n\n// Use the Loader to create (and optionally, attach) a Container\nconst container = await loader.createDetachedContainer(/* params */);\nawait container.attach(/* params */);\n\n// Initialize the Devtools passing the logger and your Container.\n// The Container could be added later as well with devtools.registerContainerDevtools().\nconst devtools = initializeDevtools({\n\tlogger: devtoolsLogger,\n\tinitialContainers: [\n\t\t{\n\t\t\tcontainer,\n\t\t\tcontainerKey: \"My Container\",\n\t\t},\n\t],\n});\n```\n\nIf you're working with `AzureClient` instead of lower-level APIs like the one described above, you probably want to\nrefer to the [@fluid-experimental/devtools package][devtools-package] instead of this one.\n\nDuring local development the recommendation is that your application should receive the `DevtoolsLogger` instance _instead_\nof any logger it would normally receive when deployed to a real environment, to avoid local development activity from\nmixing with real telemetry.\nIf you still want to provide a real application logger and use the Fluid Devtools features that are powered by telemetry\nat the same time, you can pass an existing logger to the `DevtoolsLogger` constructor and it will forward all telemetry\nit receives to that logger as well:\n\n```typescript\nimport { DevtoolsLogger } from \"@fluid-experimental/devtools-core\";\n\n// Your application's logger\nconst yourApplicationLogger = getInstanceOfYourApplicationLogger();\n\nconst devtoolsLogger = new DevtoolsLogger(yourApplicationLogger);\n\n// Pass devtoolsLogger to initializeDevtools() and to your application as described above\n```\n\n### Clean-up\n\nThe Devtools object is managed as a global singleton.\nThat singleton is automatically cleaned up prior to the Window's \"unload\" event.\nSo typical application flows likely won't need to worry about cleanup.\nThat said, if you wish to have tighter control over when the Devtools are torn down, you can simply call the `dispose` method on the handle returned by [initialization](#initialization).\n\n## Contributing to the package\n\n### Build\n\nTo build the package locally, first ensure you have run `pnpm install` from the root of the mono-repo.\nNext, to build the code, run `npm run build` from the root of the mono-repo, or use [fluid-build](https://github.com/microsoft/FluidFramework/tree/main/build-tools/packages/build-tools#running-fluid-build-command-line) via `fluid-build -t build`.\n\n- Note: Once you have run a build from the root, assuming no other changes outside of this package, you may run `npm run build` directly within this directory for a faster build.\n If you make changes to any of this package's local dependencies, you will need to run a build again from the root before building again from directly within this package.\n\n### Test\n\nTo run the tests, first ensure you have followed the [build](#build) steps above.\nNext, run `npm run test` from a terminal within this directory.\n\n\n\n\n\n\n\n## API Documentation\n\nAPI documentation for **@fluid-experimental/devtools-core** is available at .\n\n\n\n\n\n\n\n\n\n\n## Contribution Guidelines\n\nThere are many ways to [contribute](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md) to Fluid.\n\n- Participate in Q&A in our [GitHub Discussions](https://github.com/microsoft/FluidFramework/discussions).\n- [Submit bugs](https://github.com/microsoft/FluidFramework/issues) and help us verify fixes as they are checked in.\n- Review the [source code changes](https://github.com/microsoft/FluidFramework/pulls).\n- [Contribute bug fixes](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md).\n\nDetailed instructions for working in the repo can be found in the [Wiki](https://github.com/microsoft/FluidFramework/wiki).\n\nThis project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).\nFor more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\nUse of these trademarks or logos must follow Microsoft’s [Trademark & Brand Guidelines](https://www.microsoft.com/trademarks).\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n\n\n\n## Help\n\nNot finding what you're looking for in this README? Check out our [GitHub\nWiki](https://github.com/microsoft/FluidFramework/wiki) or [fluidframework.com](https://fluidframework.com/docs/).\n\nStill not finding what you're looking for? Please [file an\nissue](https://github.com/microsoft/FluidFramework/wiki/Submitting-Bugs-and-Feature-Requests).\n\nThank you!\n\n\n\n\n\n\n\n\n\n\n## Trademark\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\n\nUse of these trademarks or logos must follow Microsoft's [Trademark & Brand Guidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general).\n\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n[initialize-devtools-docs]: https://fluidframework.com/docs/apis/devtools-core#initializedevtools-function\n[devtools-logger-docs]: https://fluidframework.com/docs/apis/devtools-core/devtoolslogger-class\n[devtools-package]: https://www.npmjs.com/package/@fluid-experimental/devtools\n[browser-extension]: https://github.com/microsoft/FluidFramework/tree/main/packages/tools/devtools/devtools-browser-extension\n","scripts":{"api":"fluid-build . --task api","tsc":"tsc","lint":"npm run prettier && npm run eslint","test":"npm run test:mocha","build":"fluid-build . --task build","clean":"rimraf --glob _api-extractor-temp nyc dist lib \"**/*.tsbuildinfo\" \"**/*.build.log\"","eslint":"eslint src","format":"npm run prettier:fix","rebuild":"npm run clean && npm run build","lint:fix":"npm run prettier:fix && npm run eslint:fix","prettier":"prettier --check . --cache --ignore-path ../../../../.prettierignore","tsc:watch":"tsc --watch","build:docs":"fluid-build . --task api","eslint:fix":"eslint src --fix","test:mocha":"mocha \"dist/**/*.test.js\" --exit","build:esnext":"tsc --project ./tsconfig.esnext.json","build:genver":"gen-version","prettier:fix":"prettier --write . --cache --ignore-path ../../../../.prettierignore","build:compile":"fluid-build . --task compile","ci:build:docs":"api-extractor run","test:coverage":"c8 npm test","typetests:gen":"fluid-type-test-generator","build:commonjs":"fluid-build . --task commonjs","format-and-build":"npm run format && npm run build","typetests:prepare":"flub typetests --dir . --reset --previous --normalize","format-and-compile":"npm run format && npm run build:compile","api-extractor:esnext":"copyfiles -u 1 \"dist/**/*-@(alpha|beta|public|untrimmed).d.ts\" lib","api-extractor:commonjs":"api-extractor run --local"},"_npmUser":{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},"_resolved":"/mnt/vss/_work/1/pack/scoped/fluid-experimental-devtools-core-2.0.0-dev.7.4.0.215930.tgz","_integrity":"sha512-GLSoqCyALkfx9cOFI0c5RAltZfRhO/BqHfE9L7DOxeUjUXv8pmV2EV7clsemMeSmZAu1xGMP99MBrnPy77WlMA==","fluidBuild":{"tasks":{"tsc":["...","typetests:gen"],"build:docs":{"script":false,"dependsOn":["...","api-extractor:commonjs","api-extractor:esnext"]}}},"repository":{"url":"git+https://github.com/microsoft/FluidFramework.git","type":"git","directory":"packages/tools/devtools/devtools-core"},"_npmVersion":"9.6.7","description":"Fluid Framework developer tools core functionality","directories":{},"sideEffects":false,"_nodeVersion":"18.17.1","dependencies":{"@fluidframework/map":"2.0.0-dev.7.4.0.215930","@fluidframework/cell":"2.0.0-dev.7.4.0.215930","@fluidframework/matrix":"2.0.0-dev.7.4.0.215930","@fluidframework/counter":"2.0.0-dev.7.4.0.215930","@fluidframework/sequence":"2.0.0-dev.7.4.0.215930","@fluid-experimental/tree2":"2.0.0-dev.7.4.0.215930","@fluid-internal/client-utils":"2.0.0-dev.7.4.0.215930","@fluidframework/core-interfaces":"2.0.0-dev.7.4.0.215930","@fluidframework/telemetry-utils":"2.0.0-dev.7.4.0.215930","@fluidframework/container-loader":"2.0.0-dev.7.4.0.215930","@fluidframework/shared-object-base":"2.0.0-dev.7.4.0.215930","@fluidframework/protocol-definitions":"^3.0.0","@fluidframework/container-definitions":"2.0.0-dev.7.4.0.215930","@fluidframework/datastore-definitions":"2.0.0-dev.7.4.0.215930"},"_hasShrinkwrap":false,"readmeFilename":"README.md","typeValidation":{"broken":{}},"devDependencies":{"c8":"^7.7.1","chai":"^4.2.0","mocha":"^10.2.0","eslint":"~8.50.0","events":"^3.1.0","moment":"^2.21.0","rimraf":"^4.4.0","prettier":"~3.0.3","copyfiles":"^2.4.1","cross-env":"^7.0.3","typescript":"~5.1.6","@types/chai":"^4.0.0","@types/mocha":"^9.1.1","@types/events":"^3.0.0","mocha-multi-reporters":"^1.5.1","@fluid-tools/build-cli":"^0.28.0","eslint-config-prettier":"~9.0.0","@microsoft/api-extractor":"^7.38.3","eslint-plugin-chai-expect":"~3.0.0","mocha-json-output-reporter":"^2.0.1","@fluidframework/build-tools":"^0.28.0","@fluidframework/build-common":"^2.0.3","@fluidframework/mocha-test-setup":"2.0.0-dev.7.4.0.215930","@fluidframework/driver-definitions":"2.0.0-dev.7.4.0.215930","@fluidframework/test-runtime-utils":"2.0.0-dev.7.4.0.215930","@fluidframework/eslint-config-fluid":"^3.1.0","@fluid-experimental/devtools-core-previous":"npm:@fluid-experimental/devtools-core@2.0.0-internal.7.2.0"},"_npmOperationalInternal":{"tmp":"tmp/devtools-core_2.0.0-dev.7.4.0.215930_1701376965280_0.5969231127915458","host":"s3://npm-registry-packages"}},"2.0.0-dev.7.4.0.216897":{"name":"@fluid-experimental/devtools-core","version":"2.0.0-dev.7.4.0.216897","author":{"name":"Microsoft and contributors"},"license":"MIT","_id":"@fluid-experimental/devtools-core@2.0.0-dev.7.4.0.216897","maintainers":[{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},{"name":"curtisman","email":"curtism@microsoft.com"}],"homepage":"https://fluidframework.com","bugs":{"url":"https://github.com/microsoft/FluidFramework/issues"},"c8":{"all":true,"exclude":["src/test/**/*.ts","dist/test/**/*.js"],"include":["src/**/*.ts","dist/**/*.js"],"reporter":["cobertura","html","text"],"cache-dir":"nyc/.cache","report-dir":"nyc/report","temp-directory":"nyc/.nyc_output","exclude-after-remap":false},"dist":{"shasum":"63a600a73a09e96e142fea9001a1ec512c82a7e2","tarball":"https://registry.npmjs.org/@fluid-experimental/devtools-core/-/devtools-core-2.0.0-dev.7.4.0.216897.tgz","fileCount":510,"integrity":"sha512-XqpXFnpVENbLrnnLCKUZYnhdzm5Evhr5Hq/rrTgoEXPl0p/pOOLDoB/bwlEkJln/V/f754M+FffwfGD5LzWQRQ==","signatures":[{"sig":"MEUCIBvn+i6GkLMqUvP09Zr+WgJRneGAVP4HqK+XXSvJZK46AiEA1CkarreU3UABhiWEyGaTSR8VMZv/XIVZ/xxrfnUPBPI=","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}],"unpackedSize":1621449},"main":"dist/index.js","_from":"file:fluid-experimental-devtools-core-2.0.0-dev.7.4.0.216897.tgz","types":"dist/index.d.ts","module":"lib/index.js","readme":"# @fluid-experimental/devtools-core\n\nThis library contains developer tools for use alongside the Fluid Framework.\nIt is used to power our associated [browser extension][browser-extension].\n\n- Chrome: \n- Edge: \n\n\n\n**IMPORTANT: This package is experimental.**\n**Its APIs may change without notice.**\n\n**Do not use in production scenarios.**\n\n\n\n\n\n\n\n\n## Installation\n\nTo get started, install the package by running the following command:\n\n```bash\nnpm i @fluid-experimental/devtools-core -D\n```\n\n\n\n\n\n## Usage\n\nThe Devtools' API surface is designed to fit nicely into most application flows.\n\n### Initialization\n\nTo initialize a devtools session for your container, call [`initializeDevtools`][initialize-devtools-docs].\nThis function accepts a `DevtoolsLogger` for receiving Fluid telemetry from your application, a list of initial Fluid\n`Containers` to associate with the session, and (optionally) customized data visualization configurations for visualizing\n`Container` data.\n\n#### About the [`DevtoolsLogger`][devtools-logger-docs]\n\nThe `DevtoolsLogger` is an optional piece when calling `initializeDevtools` but it is strongly recommended that you use\nit because several features in Fluid Devtools are powered by the telemetry that Fluid Framework generates, and this\nlogger is the way in which that telemetry gets into Fluid Devtools.\n\nYou can obtain a `DevtoolsLogger` by calling its constructor, and then should pass it to `initializeDevtools` _and_\nto the `Loader` instance you'll use to create/load Containers as shown below.\nThis way the logger will receive all the telemetry generated by Fluid Framework in your application, and forward it to\nFluid Devtools as necessary.\n\n```typescript\nimport { DevtoolsLogger, initializeDevtools } from \"@fluid-experimental/devtools-core\";\n\n// Instantiate the logger\nconst devtoolsLogger = new DevtoolsLogger();\n\n// Pass the logger when instantiating the Loader\nconst loader = new Loader({\n\tlogger: devtoolsLogger,\n\t// Other necessary properties ...\n});\n\n// Use the Loader to create (and optionally, attach) a Container\nconst container = await loader.createDetachedContainer(/* params */);\nawait container.attach(/* params */);\n\n// Initialize the Devtools passing the logger and your Container.\n// The Container could be added later as well with devtools.registerContainerDevtools().\nconst devtools = initializeDevtools({\n\tlogger: devtoolsLogger,\n\tinitialContainers: [\n\t\t{\n\t\t\tcontainer,\n\t\t\tcontainerKey: \"My Container\",\n\t\t},\n\t],\n});\n```\n\nIf you're working with `AzureClient` instead of lower-level APIs like the one described above, you probably want to\nrefer to the [@fluid-experimental/devtools package][devtools-package] instead of this one.\n\nDuring local development the recommendation is that your application should receive the `DevtoolsLogger` instance _instead_\nof any logger it would normally receive when deployed to a real environment, to avoid local development activity from\nmixing with real telemetry.\nIf you still want to provide a real application logger and use the Fluid Devtools features that are powered by telemetry\nat the same time, you can pass an existing logger to the `DevtoolsLogger` constructor and it will forward all telemetry\nit receives to that logger as well:\n\n```typescript\nimport { DevtoolsLogger } from \"@fluid-experimental/devtools-core\";\n\n// Your application's logger\nconst yourApplicationLogger = getInstanceOfYourApplicationLogger();\n\nconst devtoolsLogger = new DevtoolsLogger(yourApplicationLogger);\n\n// Pass devtoolsLogger to initializeDevtools() and to your application as described above\n```\n\n### Clean-up\n\nThe Devtools object is managed as a global singleton.\nThat singleton is automatically cleaned up prior to the Window's \"unload\" event.\nSo typical application flows likely won't need to worry about cleanup.\nThat said, if you wish to have tighter control over when the Devtools are torn down, you can simply call the `dispose` method on the handle returned by [initialization](#initialization).\n\n## Contributing to the package\n\n### Build\n\nTo build the package locally, first ensure you have run `pnpm install` from the root of the mono-repo.\nNext, to build the code, run `npm run build` from the root of the mono-repo, or use [fluid-build](https://github.com/microsoft/FluidFramework/tree/main/build-tools/packages/build-tools#running-fluid-build-command-line) via `fluid-build -t build`.\n\n- Note: Once you have run a build from the root, assuming no other changes outside of this package, you may run `npm run build` directly within this directory for a faster build.\n If you make changes to any of this package's local dependencies, you will need to run a build again from the root before building again from directly within this package.\n\n### Test\n\nTo run the tests, first ensure you have followed the [build](#build) steps above.\nNext, run `npm run test` from a terminal within this directory.\n\n\n\n\n\n\n\n## API Documentation\n\nAPI documentation for **@fluid-experimental/devtools-core** is available at .\n\n\n\n\n\n\n\n\n\n\n## Contribution Guidelines\n\nThere are many ways to [contribute](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md) to Fluid.\n\n- Participate in Q&A in our [GitHub Discussions](https://github.com/microsoft/FluidFramework/discussions).\n- [Submit bugs](https://github.com/microsoft/FluidFramework/issues) and help us verify fixes as they are checked in.\n- Review the [source code changes](https://github.com/microsoft/FluidFramework/pulls).\n- [Contribute bug fixes](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md).\n\nDetailed instructions for working in the repo can be found in the [Wiki](https://github.com/microsoft/FluidFramework/wiki).\n\nThis project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).\nFor more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\nUse of these trademarks or logos must follow Microsoft’s [Trademark & Brand Guidelines](https://www.microsoft.com/trademarks).\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n\n\n\n## Help\n\nNot finding what you're looking for in this README? Check out our [GitHub\nWiki](https://github.com/microsoft/FluidFramework/wiki) or [fluidframework.com](https://fluidframework.com/docs/).\n\nStill not finding what you're looking for? Please [file an\nissue](https://github.com/microsoft/FluidFramework/wiki/Submitting-Bugs-and-Feature-Requests).\n\nThank you!\n\n\n\n\n\n\n\n\n\n\n## Trademark\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\n\nUse of these trademarks or logos must follow Microsoft's [Trademark & Brand Guidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general).\n\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n[initialize-devtools-docs]: https://fluidframework.com/docs/apis/devtools-core#initializedevtools-function\n[devtools-logger-docs]: https://fluidframework.com/docs/apis/devtools-core/devtoolslogger-class\n[devtools-package]: https://www.npmjs.com/package/@fluid-experimental/devtools\n[browser-extension]: https://github.com/microsoft/FluidFramework/tree/main/packages/tools/devtools/devtools-browser-extension\n","scripts":{"api":"fluid-build . --task api","tsc":"tsc","lint":"npm run prettier && npm run check:release-tags && npm run eslint","test":"npm run test:mocha","build":"fluid-build . --task build","clean":"rimraf --glob _api-extractor-temp nyc dist lib \"**/*.tsbuildinfo\" \"**/*.build.log\"","eslint":"eslint src","format":"npm run prettier:fix","rebuild":"npm run clean && npm run build","lint:fix":"npm run prettier:fix && npm run eslint:fix","prettier":"prettier --check . --cache --ignore-path ../../../../.prettierignore","tsc:watch":"tsc --watch","build:docs":"fluid-build . --task api","eslint:fix":"eslint src --fix","test:mocha":"mocha \"dist/**/*.test.js\" --exit","build:esnext":"tsc --project ./tsconfig.esnext.json","build:genver":"gen-version","prettier:fix":"prettier --write . --cache --ignore-path ../../../../.prettierignore","build:compile":"fluid-build . --task compile","ci:build:docs":"api-extractor run","test:coverage":"c8 npm test","typetests:gen":"fluid-type-test-generator","build:commonjs":"fluid-build . --task commonjs","format-and-build":"npm run format && npm run build","typetests:prepare":"flub typetests --dir . --reset --previous --normalize","check:release-tags":"api-extractor run --local --config ./api-extractor-lint.json","format-and-compile":"npm run format && npm run build:compile","api-extractor:esnext":"copyfiles -u 1 \"dist/**/*-@(alpha|beta|public|untrimmed).d.ts\" lib","api-extractor:commonjs":"api-extractor run --local"},"_npmUser":{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},"_resolved":"/mnt/vss/_work/1/pack/scoped/fluid-experimental-devtools-core-2.0.0-dev.7.4.0.216897.tgz","_integrity":"sha512-XqpXFnpVENbLrnnLCKUZYnhdzm5Evhr5Hq/rrTgoEXPl0p/pOOLDoB/bwlEkJln/V/f754M+FffwfGD5LzWQRQ==","fluidBuild":{"tasks":{"tsc":["...","typetests:gen"],"build:docs":{"script":false,"dependsOn":["...","api-extractor:commonjs","api-extractor:esnext"]}}},"repository":{"url":"git+https://github.com/microsoft/FluidFramework.git","type":"git","directory":"packages/tools/devtools/devtools-core"},"_npmVersion":"9.6.7","description":"Fluid Framework developer tools core functionality","directories":{},"sideEffects":false,"_nodeVersion":"18.17.1","dependencies":{"@fluidframework/map":"2.0.0-dev.7.4.0.216897","@fluidframework/cell":"2.0.0-dev.7.4.0.216897","@fluidframework/matrix":"2.0.0-dev.7.4.0.216897","@fluidframework/counter":"2.0.0-dev.7.4.0.216897","@fluidframework/sequence":"2.0.0-dev.7.4.0.216897","@fluid-experimental/tree2":"2.0.0-dev.7.4.0.216897","@fluid-internal/client-utils":"2.0.0-dev.7.4.0.216897","@fluidframework/core-interfaces":"2.0.0-dev.7.4.0.216897","@fluidframework/telemetry-utils":"2.0.0-dev.7.4.0.216897","@fluidframework/container-loader":"2.0.0-dev.7.4.0.216897","@fluidframework/shared-object-base":"2.0.0-dev.7.4.0.216897","@fluidframework/protocol-definitions":"^3.0.0","@fluidframework/container-definitions":"2.0.0-dev.7.4.0.216897","@fluidframework/datastore-definitions":"2.0.0-dev.7.4.0.216897"},"_hasShrinkwrap":false,"readmeFilename":"README.md","typeValidation":{"broken":{}},"devDependencies":{"c8":"^7.7.1","chai":"^4.2.0","mocha":"^10.2.0","eslint":"~8.50.0","events":"^3.1.0","moment":"^2.21.0","rimraf":"^4.4.0","prettier":"~3.0.3","copyfiles":"^2.4.1","cross-env":"^7.0.3","typescript":"~5.1.6","@types/chai":"^4.0.0","@types/mocha":"^9.1.1","@types/events":"^3.0.0","mocha-multi-reporters":"^1.5.1","@fluid-tools/build-cli":"^0.28.0","eslint-config-prettier":"~9.0.0","@microsoft/api-extractor":"^7.38.3","eslint-plugin-chai-expect":"~3.0.0","mocha-json-output-reporter":"^2.0.1","@fluidframework/build-tools":"^0.28.0","@fluidframework/build-common":"^2.0.3","@fluidframework/mocha-test-setup":"2.0.0-dev.7.4.0.216897","@fluidframework/driver-definitions":"2.0.0-dev.7.4.0.216897","@fluidframework/test-runtime-utils":"2.0.0-dev.7.4.0.216897","@fluidframework/eslint-config-fluid":"^3.1.0","@fluid-experimental/devtools-core-previous":"npm:@fluid-experimental/devtools-core@2.0.0-internal.7.2.0"},"_npmOperationalInternal":{"tmp":"tmp/devtools-core_2.0.0-dev.7.4.0.216897_1701467149819_0.07875513234556242","host":"s3://npm-registry-packages"}},"2.0.0-dev.7.4.0.217212":{"name":"@fluid-experimental/devtools-core","version":"2.0.0-dev.7.4.0.217212","author":{"name":"Microsoft and contributors"},"license":"MIT","_id":"@fluid-experimental/devtools-core@2.0.0-dev.7.4.0.217212","maintainers":[{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},{"name":"curtisman","email":"curtism@microsoft.com"}],"homepage":"https://fluidframework.com","bugs":{"url":"https://github.com/microsoft/FluidFramework/issues"},"c8":{"all":true,"exclude":["src/test/**/*.ts","dist/test/**/*.js"],"include":["src/**/*.ts","dist/**/*.js"],"reporter":["cobertura","html","text"],"cache-dir":"nyc/.cache","report-dir":"nyc/report","temp-directory":"nyc/.nyc_output","exclude-after-remap":false},"dist":{"shasum":"58fabde08cc6b520a7ab6c722c1be45e331c5dc5","tarball":"https://registry.npmjs.org/@fluid-experimental/devtools-core/-/devtools-core-2.0.0-dev.7.4.0.217212.tgz","fileCount":510,"integrity":"sha512-VOzxqESqpQ08wbfWA2E39kKswHB3QVspAGJ3fiLlWMmaOn2v6RJkq9lJJgD/MuL15eieIrSlsfCf5rPlC+A6lQ==","signatures":[{"sig":"MEUCIGS9PGlpuyNg5JaLzvDSxkjEexlFe8MvOL1KmcGihGQ6AiEAhd9fCeI0A237/1Db6pQUFt11zFVqr2Qli9wrjwaJg/w=","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}],"unpackedSize":1621613},"main":"dist/index.js","_from":"file:fluid-experimental-devtools-core-2.0.0-dev.7.4.0.217212.tgz","types":"dist/index.d.ts","module":"lib/index.js","readme":"# @fluid-experimental/devtools-core\n\nThis library contains developer tools for use alongside the Fluid Framework.\nIt is used to power our associated [browser extension][browser-extension].\n\n- Chrome: \n- Edge: \n\n\n\n**IMPORTANT: This package is experimental.**\n**Its APIs may change without notice.**\n\n**Do not use in production scenarios.**\n\n\n\n\n\n\n\n\n## Installation\n\nTo get started, install the package by running the following command:\n\n```bash\nnpm i @fluid-experimental/devtools-core -D\n```\n\n\n\n\n\n## Usage\n\nThe Devtools' API surface is designed to fit nicely into most application flows.\n\n### Initialization\n\nTo initialize a devtools session for your container, call [`initializeDevtools`][initialize-devtools-docs].\nThis function accepts a `DevtoolsLogger` for receiving Fluid telemetry from your application, a list of initial Fluid\n`Containers` to associate with the session, and (optionally) customized data visualization configurations for visualizing\n`Container` data.\n\n#### About the [`DevtoolsLogger`][devtools-logger-docs]\n\nThe `DevtoolsLogger` is an optional piece when calling `initializeDevtools` but it is strongly recommended that you use\nit because several features in Fluid Devtools are powered by the telemetry that Fluid Framework generates, and this\nlogger is the way in which that telemetry gets into Fluid Devtools.\n\nYou can obtain a `DevtoolsLogger` by calling its constructor, and then should pass it to `initializeDevtools` _and_\nto the `Loader` instance you'll use to create/load Containers as shown below.\nThis way the logger will receive all the telemetry generated by Fluid Framework in your application, and forward it to\nFluid Devtools as necessary.\n\n```typescript\nimport { DevtoolsLogger, initializeDevtools } from \"@fluid-experimental/devtools-core\";\n\n// Instantiate the logger\nconst devtoolsLogger = new DevtoolsLogger();\n\n// Pass the logger when instantiating the Loader\nconst loader = new Loader({\n\tlogger: devtoolsLogger,\n\t// Other necessary properties ...\n});\n\n// Use the Loader to create (and optionally, attach) a Container\nconst container = await loader.createDetachedContainer(/* params */);\nawait container.attach(/* params */);\n\n// Initialize the Devtools passing the logger and your Container.\n// The Container could be added later as well with devtools.registerContainerDevtools().\nconst devtools = initializeDevtools({\n\tlogger: devtoolsLogger,\n\tinitialContainers: [\n\t\t{\n\t\t\tcontainer,\n\t\t\tcontainerKey: \"My Container\",\n\t\t},\n\t],\n});\n```\n\nIf you're working with `AzureClient` instead of lower-level APIs like the one described above, you probably want to\nrefer to the [@fluid-experimental/devtools package][devtools-package] instead of this one.\n\nDuring local development the recommendation is that your application should receive the `DevtoolsLogger` instance _instead_\nof any logger it would normally receive when deployed to a real environment, to avoid local development activity from\nmixing with real telemetry.\nIf you still want to provide a real application logger and use the Fluid Devtools features that are powered by telemetry\nat the same time, you can pass an existing logger to the `DevtoolsLogger` constructor and it will forward all telemetry\nit receives to that logger as well:\n\n```typescript\nimport { DevtoolsLogger } from \"@fluid-experimental/devtools-core\";\n\n// Your application's logger\nconst yourApplicationLogger = getInstanceOfYourApplicationLogger();\n\nconst devtoolsLogger = new DevtoolsLogger(yourApplicationLogger);\n\n// Pass devtoolsLogger to initializeDevtools() and to your application as described above\n```\n\n### Clean-up\n\nThe Devtools object is managed as a global singleton.\nThat singleton is automatically cleaned up prior to the Window's \"unload\" event.\nSo typical application flows likely won't need to worry about cleanup.\nThat said, if you wish to have tighter control over when the Devtools are torn down, you can simply call the `dispose` method on the handle returned by [initialization](#initialization).\n\n## Contributing to the package\n\n### Build\n\nTo build the package locally, first ensure you have run `pnpm install` from the root of the mono-repo.\nNext, to build the code, run `npm run build` from the root of the mono-repo, or use [fluid-build](https://github.com/microsoft/FluidFramework/tree/main/build-tools/packages/build-tools#running-fluid-build-command-line) via `fluid-build -t build`.\n\n- Note: Once you have run a build from the root, assuming no other changes outside of this package, you may run `npm run build` directly within this directory for a faster build.\n If you make changes to any of this package's local dependencies, you will need to run a build again from the root before building again from directly within this package.\n\n### Test\n\nTo run the tests, first ensure you have followed the [build](#build) steps above.\nNext, run `npm run test` from a terminal within this directory.\n\n\n\n\n\n\n\n## API Documentation\n\nAPI documentation for **@fluid-experimental/devtools-core** is available at .\n\n\n\n\n\n\n\n\n\n\n## Contribution Guidelines\n\nThere are many ways to [contribute](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md) to Fluid.\n\n- Participate in Q&A in our [GitHub Discussions](https://github.com/microsoft/FluidFramework/discussions).\n- [Submit bugs](https://github.com/microsoft/FluidFramework/issues) and help us verify fixes as they are checked in.\n- Review the [source code changes](https://github.com/microsoft/FluidFramework/pulls).\n- [Contribute bug fixes](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md).\n\nDetailed instructions for working in the repo can be found in the [Wiki](https://github.com/microsoft/FluidFramework/wiki).\n\nThis project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).\nFor more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\nUse of these trademarks or logos must follow Microsoft’s [Trademark & Brand Guidelines](https://www.microsoft.com/trademarks).\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n\n\n\n## Help\n\nNot finding what you're looking for in this README? Check out our [GitHub\nWiki](https://github.com/microsoft/FluidFramework/wiki) or [fluidframework.com](https://fluidframework.com/docs/).\n\nStill not finding what you're looking for? Please [file an\nissue](https://github.com/microsoft/FluidFramework/wiki/Submitting-Bugs-and-Feature-Requests).\n\nThank you!\n\n\n\n\n\n\n\n\n\n\n## Trademark\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\n\nUse of these trademarks or logos must follow Microsoft's [Trademark & Brand Guidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general).\n\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n[initialize-devtools-docs]: https://fluidframework.com/docs/apis/devtools-core#initializedevtools-function\n[devtools-logger-docs]: https://fluidframework.com/docs/apis/devtools-core/devtoolslogger-class\n[devtools-package]: https://www.npmjs.com/package/@fluid-experimental/devtools\n[browser-extension]: https://github.com/microsoft/FluidFramework/tree/main/packages/tools/devtools/devtools-browser-extension\n","scripts":{"api":"fluid-build . --task api","tsc":"tsc","lint":"npm run prettier && npm run check:release-tags && npm run eslint","test":"npm run test:mocha","build":"fluid-build . --task build","clean":"rimraf --glob _api-extractor-temp nyc dist lib \"**/*.tsbuildinfo\" \"**/*.build.log\"","eslint":"eslint src","format":"npm run prettier:fix","rebuild":"npm run clean && npm run build","lint:fix":"npm run prettier:fix && npm run eslint:fix","prettier":"prettier --check . --cache --ignore-path ../../../../.prettierignore","tsc:watch":"tsc --watch","build:docs":"fluid-build . --task api","eslint:fix":"eslint src --fix","test:mocha":"mocha \"dist/**/*.test.js\" --exit","build:esnext":"tsc --project ./tsconfig.esnext.json","build:genver":"gen-version","prettier:fix":"prettier --write . --cache --ignore-path ../../../../.prettierignore","build:compile":"fluid-build . --task compile","ci:build:docs":"api-extractor run","test:coverage":"c8 npm test","typetests:gen":"fluid-type-test-generator","build:commonjs":"fluid-build . --task commonjs","format-and-build":"npm run format && npm run build","typetests:prepare":"flub typetests --dir . --reset --previous --normalize","check:release-tags":"api-extractor run --local --config ./api-extractor-lint.json","format-and-compile":"npm run format && npm run build:compile","api-extractor:esnext":"copyfiles -u 1 \"dist/**/*-@(alpha|beta|public|untrimmed).d.ts\" lib","api-extractor:commonjs":"api-extractor run --local"},"_npmUser":{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},"_resolved":"/mnt/vss/_work/1/pack/scoped/fluid-experimental-devtools-core-2.0.0-dev.7.4.0.217212.tgz","_integrity":"sha512-VOzxqESqpQ08wbfWA2E39kKswHB3QVspAGJ3fiLlWMmaOn2v6RJkq9lJJgD/MuL15eieIrSlsfCf5rPlC+A6lQ==","fluidBuild":{"tasks":{"tsc":["...","typetests:gen"],"build:docs":{"script":false,"dependsOn":["...","api-extractor:commonjs","api-extractor:esnext"]}}},"repository":{"url":"git+https://github.com/microsoft/FluidFramework.git","type":"git","directory":"packages/tools/devtools/devtools-core"},"_npmVersion":"9.6.7","description":"Fluid Framework developer tools core functionality","directories":{},"sideEffects":false,"_nodeVersion":"18.17.1","dependencies":{"@fluidframework/map":"2.0.0-dev.7.4.0.217212","@fluidframework/cell":"2.0.0-dev.7.4.0.217212","@fluidframework/matrix":"2.0.0-dev.7.4.0.217212","@fluidframework/counter":"2.0.0-dev.7.4.0.217212","@fluidframework/sequence":"2.0.0-dev.7.4.0.217212","@fluid-experimental/tree2":"2.0.0-dev.7.4.0.217212","@fluid-internal/client-utils":"2.0.0-dev.7.4.0.217212","@fluidframework/core-interfaces":"2.0.0-dev.7.4.0.217212","@fluidframework/telemetry-utils":"2.0.0-dev.7.4.0.217212","@fluidframework/container-loader":"2.0.0-dev.7.4.0.217212","@fluidframework/shared-object-base":"2.0.0-dev.7.4.0.217212","@fluidframework/protocol-definitions":"^3.0.0","@fluidframework/container-definitions":"2.0.0-dev.7.4.0.217212","@fluidframework/datastore-definitions":"2.0.0-dev.7.4.0.217212"},"_hasShrinkwrap":false,"readmeFilename":"README.md","typeValidation":{"broken":{}},"devDependencies":{"c8":"^7.7.1","chai":"^4.2.0","mocha":"^10.2.0","eslint":"~8.50.0","events":"^3.1.0","moment":"^2.21.0","rimraf":"^4.4.0","prettier":"~3.0.3","copyfiles":"^2.4.1","cross-env":"^7.0.3","typescript":"~5.1.6","@types/chai":"^4.0.0","@types/mocha":"^9.1.1","@types/events":"^3.0.0","mocha-multi-reporters":"^1.5.1","@fluid-tools/build-cli":"^0.28.0","eslint-config-prettier":"~9.0.0","@microsoft/api-extractor":"^7.38.3","eslint-plugin-chai-expect":"~3.0.0","mocha-json-output-reporter":"^2.0.1","@fluidframework/build-tools":"^0.28.0","@fluidframework/build-common":"^2.0.3","@fluidframework/mocha-test-setup":"2.0.0-dev.7.4.0.217212","@fluidframework/driver-definitions":"2.0.0-dev.7.4.0.217212","@fluidframework/test-runtime-utils":"2.0.0-dev.7.4.0.217212","@fluidframework/eslint-config-fluid":"^3.1.0","@fluid-experimental/devtools-core-previous":"npm:@fluid-experimental/devtools-core@2.0.0-internal.7.2.0"},"_npmOperationalInternal":{"tmp":"tmp/devtools-core_2.0.0-dev.7.4.0.217212_1701540635156_0.65375219024817","host":"s3://npm-registry-packages"}},"2.0.0-dev.7.4.0.217884":{"name":"@fluid-experimental/devtools-core","version":"2.0.0-dev.7.4.0.217884","author":{"name":"Microsoft and contributors"},"license":"MIT","_id":"@fluid-experimental/devtools-core@2.0.0-dev.7.4.0.217884","maintainers":[{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},{"name":"curtisman","email":"curtism@microsoft.com"}],"homepage":"https://fluidframework.com","bugs":{"url":"https://github.com/microsoft/FluidFramework/issues"},"c8":{"all":true,"exclude":["src/test/**/*.ts","dist/test/**/*.js"],"include":["src/**/*.ts","dist/**/*.js"],"reporter":["cobertura","html","text"],"cache-dir":"nyc/.cache","report-dir":"nyc/report","temp-directory":"nyc/.nyc_output","exclude-after-remap":false},"dist":{"shasum":"7ff9f00f7cbdaaf17109d11ea5db13cd0cac7afe","tarball":"https://registry.npmjs.org/@fluid-experimental/devtools-core/-/devtools-core-2.0.0-dev.7.4.0.217884.tgz","fileCount":510,"integrity":"sha512-G9AngyP8E0KXGVPZTWkJLYn++d0GYAhNO6vKgZXwcRzVtTvDFDOTJgu15LFXFr+iMQ2aG79Zhir1Xdt9Cld8ng==","signatures":[{"sig":"MEYCIQDhLhZA7ma2L0Va+bA7dPh8rTnGq0h2KWOHCAt8enVgDAIhAOVpSR22jvhhB+djqycl+wFaWxBcqmgiZDggyOm0TyID","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}],"unpackedSize":1621659},"main":"dist/index.js","_from":"file:fluid-experimental-devtools-core-2.0.0-dev.7.4.0.217884.tgz","types":"dist/index.d.ts","module":"lib/index.js","readme":"# @fluid-experimental/devtools-core\n\nThis library contains developer tools for use alongside the Fluid Framework.\nIt is used to power our associated [browser extension][browser-extension].\n\n- Chrome: \n- Edge: \n\n\n\n**IMPORTANT: This package is experimental.**\n**Its APIs may change without notice.**\n\n**Do not use in production scenarios.**\n\n\n\n\n\n\n\n\n## Installation\n\nTo get started, install the package by running the following command:\n\n```bash\nnpm i @fluid-experimental/devtools-core -D\n```\n\n\n\n\n\n## Usage\n\nThe Devtools' API surface is designed to fit nicely into most application flows.\n\n### Initialization\n\nTo initialize a devtools session for your container, call [`initializeDevtools`][initialize-devtools-docs].\nThis function accepts a `DevtoolsLogger` for receiving Fluid telemetry from your application, a list of initial Fluid\n`Containers` to associate with the session, and (optionally) customized data visualization configurations for visualizing\n`Container` data.\n\n#### About the [`DevtoolsLogger`][devtools-logger-docs]\n\nThe `DevtoolsLogger` is an optional piece when calling `initializeDevtools` but it is strongly recommended that you use\nit because several features in Fluid Devtools are powered by the telemetry that Fluid Framework generates, and this\nlogger is the way in which that telemetry gets into Fluid Devtools.\n\nYou can obtain a `DevtoolsLogger` by calling its constructor, and then should pass it to `initializeDevtools` _and_\nto the `Loader` instance you'll use to create/load Containers as shown below.\nThis way the logger will receive all the telemetry generated by Fluid Framework in your application, and forward it to\nFluid Devtools as necessary.\n\n```typescript\nimport { DevtoolsLogger, initializeDevtools } from \"@fluid-experimental/devtools-core\";\n\n// Instantiate the logger\nconst devtoolsLogger = new DevtoolsLogger();\n\n// Pass the logger when instantiating the Loader\nconst loader = new Loader({\n\tlogger: devtoolsLogger,\n\t// Other necessary properties ...\n});\n\n// Use the Loader to create (and optionally, attach) a Container\nconst container = await loader.createDetachedContainer(/* params */);\nawait container.attach(/* params */);\n\n// Initialize the Devtools passing the logger and your Container.\n// The Container could be added later as well with devtools.registerContainerDevtools().\nconst devtools = initializeDevtools({\n\tlogger: devtoolsLogger,\n\tinitialContainers: [\n\t\t{\n\t\t\tcontainer,\n\t\t\tcontainerKey: \"My Container\",\n\t\t},\n\t],\n});\n```\n\nIf you're working with `AzureClient` instead of lower-level APIs like the one described above, you probably want to\nrefer to the [@fluid-experimental/devtools package][devtools-package] instead of this one.\n\nDuring local development the recommendation is that your application should receive the `DevtoolsLogger` instance _instead_\nof any logger it would normally receive when deployed to a real environment, to avoid local development activity from\nmixing with real telemetry.\nIf you still want to provide a real application logger and use the Fluid Devtools features that are powered by telemetry\nat the same time, you can pass an existing logger to the `DevtoolsLogger` constructor and it will forward all telemetry\nit receives to that logger as well:\n\n```typescript\nimport { DevtoolsLogger } from \"@fluid-experimental/devtools-core\";\n\n// Your application's logger\nconst yourApplicationLogger = getInstanceOfYourApplicationLogger();\n\nconst devtoolsLogger = new DevtoolsLogger(yourApplicationLogger);\n\n// Pass devtoolsLogger to initializeDevtools() and to your application as described above\n```\n\n### Clean-up\n\nThe Devtools object is managed as a global singleton.\nThat singleton is automatically cleaned up prior to the Window's \"unload\" event.\nSo typical application flows likely won't need to worry about cleanup.\nThat said, if you wish to have tighter control over when the Devtools are torn down, you can simply call the `dispose` method on the handle returned by [initialization](#initialization).\n\n## Contributing to the package\n\n### Build\n\nTo build the package locally, first ensure you have run `pnpm install` from the root of the mono-repo.\nNext, to build the code, run `npm run build` from the root of the mono-repo, or use [fluid-build](https://github.com/microsoft/FluidFramework/tree/main/build-tools/packages/build-tools#running-fluid-build-command-line) via `fluid-build -t build`.\n\n- Note: Once you have run a build from the root, assuming no other changes outside of this package, you may run `npm run build` directly within this directory for a faster build.\n If you make changes to any of this package's local dependencies, you will need to run a build again from the root before building again from directly within this package.\n\n### Test\n\nTo run the tests, first ensure you have followed the [build](#build) steps above.\nNext, run `npm run test` from a terminal within this directory.\n\n\n\n\n\n\n\n## API Documentation\n\nAPI documentation for **@fluid-experimental/devtools-core** is available at .\n\n\n\n\n\n\n\n\n\n\n## Contribution Guidelines\n\nThere are many ways to [contribute](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md) to Fluid.\n\n- Participate in Q&A in our [GitHub Discussions](https://github.com/microsoft/FluidFramework/discussions).\n- [Submit bugs](https://github.com/microsoft/FluidFramework/issues) and help us verify fixes as they are checked in.\n- Review the [source code changes](https://github.com/microsoft/FluidFramework/pulls).\n- [Contribute bug fixes](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md).\n\nDetailed instructions for working in the repo can be found in the [Wiki](https://github.com/microsoft/FluidFramework/wiki).\n\nThis project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).\nFor more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\nUse of these trademarks or logos must follow Microsoft’s [Trademark & Brand Guidelines](https://www.microsoft.com/trademarks).\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n\n\n\n## Help\n\nNot finding what you're looking for in this README? Check out our [GitHub\nWiki](https://github.com/microsoft/FluidFramework/wiki) or [fluidframework.com](https://fluidframework.com/docs/).\n\nStill not finding what you're looking for? Please [file an\nissue](https://github.com/microsoft/FluidFramework/wiki/Submitting-Bugs-and-Feature-Requests).\n\nThank you!\n\n\n\n\n\n\n\n\n\n\n## Trademark\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\n\nUse of these trademarks or logos must follow Microsoft's [Trademark & Brand Guidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general).\n\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n[initialize-devtools-docs]: https://fluidframework.com/docs/apis/devtools-core#initializedevtools-function\n[devtools-logger-docs]: https://fluidframework.com/docs/apis/devtools-core/devtoolslogger-class\n[devtools-package]: https://www.npmjs.com/package/@fluid-experimental/devtools\n[browser-extension]: https://github.com/microsoft/FluidFramework/tree/main/packages/tools/devtools/devtools-browser-extension\n","scripts":{"api":"fluid-build . --task api","tsc":"tsc","lint":"npm run prettier && npm run check:release-tags && npm run eslint","test":"npm run test:mocha","build":"fluid-build . --task build","clean":"rimraf --glob _api-extractor-temp nyc dist lib \"**/*.tsbuildinfo\" \"**/*.build.log\"","eslint":"eslint src","format":"npm run prettier:fix","rebuild":"npm run clean && npm run build","lint:fix":"npm run prettier:fix && npm run eslint:fix","prettier":"prettier --check . --cache --ignore-path ../../../../.prettierignore","tsc:watch":"tsc --watch","build:docs":"fluid-build . --task api","eslint:fix":"eslint src --fix","test:mocha":"mocha \"dist/**/*.test.js\" --exit","build:esnext":"tsc --project ./tsconfig.esnext.json","build:genver":"gen-version","prettier:fix":"prettier --write . --cache --ignore-path ../../../../.prettierignore","build:compile":"fluid-build . --task compile","ci:build:docs":"api-extractor run","test:coverage":"c8 npm test","typetests:gen":"fluid-type-test-generator","build:commonjs":"fluid-build . --task commonjs","format-and-build":"npm run format && npm run build","typetests:prepare":"flub typetests --dir . --reset --previous --normalize","check:release-tags":"api-extractor run --local --config ./api-extractor-lint.json","format-and-compile":"npm run format && npm run build:compile","api-extractor:esnext":"copyfiles -u 1 \"dist/**/*-@(alpha|beta|public|untrimmed).d.ts\" lib","api-extractor:commonjs":"api-extractor run --local"},"_npmUser":{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},"_resolved":"/mnt/vss/_work/1/pack/scoped/fluid-experimental-devtools-core-2.0.0-dev.7.4.0.217884.tgz","_integrity":"sha512-G9AngyP8E0KXGVPZTWkJLYn++d0GYAhNO6vKgZXwcRzVtTvDFDOTJgu15LFXFr+iMQ2aG79Zhir1Xdt9Cld8ng==","fluidBuild":{"tasks":{"tsc":["...","typetests:gen"],"build:docs":{"script":false,"dependsOn":["...","api-extractor:commonjs","api-extractor:esnext"]}}},"repository":{"url":"git+https://github.com/microsoft/FluidFramework.git","type":"git","directory":"packages/tools/devtools/devtools-core"},"_npmVersion":"9.6.7","description":"Fluid Framework developer tools core functionality","directories":{},"sideEffects":false,"_nodeVersion":"18.17.1","dependencies":{"@fluidframework/map":"2.0.0-dev.7.4.0.217884","@fluidframework/cell":"2.0.0-dev.7.4.0.217884","@fluidframework/matrix":"2.0.0-dev.7.4.0.217884","@fluidframework/counter":"2.0.0-dev.7.4.0.217884","@fluidframework/sequence":"2.0.0-dev.7.4.0.217884","@fluid-experimental/tree2":"2.0.0-dev.7.4.0.217884","@fluid-internal/client-utils":"2.0.0-dev.7.4.0.217884","@fluidframework/core-interfaces":"2.0.0-dev.7.4.0.217884","@fluidframework/telemetry-utils":"2.0.0-dev.7.4.0.217884","@fluidframework/container-loader":"2.0.0-dev.7.4.0.217884","@fluidframework/shared-object-base":"2.0.0-dev.7.4.0.217884","@fluidframework/protocol-definitions":"^3.0.0","@fluidframework/container-definitions":"2.0.0-dev.7.4.0.217884","@fluidframework/datastore-definitions":"2.0.0-dev.7.4.0.217884"},"_hasShrinkwrap":false,"readmeFilename":"README.md","typeValidation":{"broken":{}},"devDependencies":{"c8":"^7.7.1","chai":"^4.2.0","mocha":"^10.2.0","eslint":"~8.50.0","events":"^3.1.0","moment":"^2.21.0","rimraf":"^4.4.0","prettier":"~3.0.3","copyfiles":"^2.4.1","cross-env":"^7.0.3","typescript":"~5.1.6","@types/chai":"^4.0.0","@types/mocha":"^9.1.1","@types/events":"^3.0.0","mocha-multi-reporters":"^1.5.1","@fluid-tools/build-cli":"^0.28.0","eslint-config-prettier":"~9.0.0","@microsoft/api-extractor":"^7.38.3","eslint-plugin-chai-expect":"~3.0.0","mocha-json-output-reporter":"^2.0.1","@fluidframework/build-tools":"^0.28.0","@fluidframework/build-common":"^2.0.3","@fluidframework/mocha-test-setup":"2.0.0-dev.7.4.0.217884","@fluidframework/driver-definitions":"2.0.0-dev.7.4.0.217884","@fluidframework/test-runtime-utils":"2.0.0-dev.7.4.0.217884","@fluidframework/eslint-config-fluid":"^3.1.0","@fluid-experimental/devtools-core-previous":"npm:@fluid-experimental/devtools-core@2.0.0-internal.7.2.0"},"_npmOperationalInternal":{"tmp":"tmp/devtools-core_2.0.0-dev.7.4.0.217884_1701806103509_0.021497974486431426","host":"s3://npm-registry-packages"}},"2.0.0-dev.7.4.0.221926":{"name":"@fluid-experimental/devtools-core","version":"2.0.0-dev.7.4.0.221926","author":{"name":"Microsoft and contributors"},"license":"MIT","_id":"@fluid-experimental/devtools-core@2.0.0-dev.7.4.0.221926","maintainers":[{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},{"name":"curtisman","email":"curtism@microsoft.com"}],"homepage":"https://fluidframework.com","bugs":{"url":"https://github.com/microsoft/FluidFramework/issues"},"c8":{"all":true,"exclude":["src/test/**/*.ts","dist/test/**/*.js"],"include":["src/**/*.ts","dist/**/*.js"],"reporter":["cobertura","html","text"],"cache-dir":"nyc/.cache","report-dir":"nyc/report","temp-directory":"nyc/.nyc_output","exclude-after-remap":false},"dist":{"shasum":"f21aa84f92cb740e3925358bf238d0fecc8c4443","tarball":"https://registry.npmjs.org/@fluid-experimental/devtools-core/-/devtools-core-2.0.0-dev.7.4.0.221926.tgz","fileCount":510,"integrity":"sha512-1XCU4J+Si6BzToZsHud+RNozPg1vSF5ZJBGGa0TUd3/cMpzTfdbHEwH0I1asjpAP8k4cxgGG8Elme44GCj0/9A==","signatures":[{"sig":"MEYCIQDGa9T+O8H087glrbcJG5Lo1BoirS/KzKsOvX8SxUAL/wIhAP2Y3qLVxNL3fG1VnzhBJ90P3U7qRYyCE+wl25d/F0Y3","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}],"unpackedSize":1624842},"main":"dist/index.js","_from":"file:fluid-experimental-devtools-core-2.0.0-dev.7.4.0.221926.tgz","types":"dist/index.d.ts","module":"lib/index.js","readme":"# @fluid-experimental/devtools-core\n\nThis library contains developer tools for use alongside the Fluid Framework.\nIt is used to power our associated [browser extension][browser-extension].\n\n- Chrome: \n- Edge: \n\n\n\n**IMPORTANT: This package is experimental.**\n**Its APIs may change without notice.**\n\n**Do not use in production scenarios.**\n\n\n\n\n\n\n\n\n## Installation\n\nTo get started, install the package by running the following command:\n\n```bash\nnpm i @fluid-experimental/devtools-core -D\n```\n\n\n\n\n\n## Usage\n\nThe Devtools' API surface is designed to fit nicely into most application flows.\n\n### Initialization\n\nTo initialize a devtools session for your container, call [`initializeDevtools`][initialize-devtools-docs].\nThis function accepts a `DevtoolsLogger` for receiving Fluid telemetry from your application, a list of initial Fluid\n`Containers` to associate with the session, and (optionally) customized data visualization configurations for visualizing\n`Container` data.\n\n#### About the [`DevtoolsLogger`][devtools-logger-docs]\n\nThe `DevtoolsLogger` is an optional piece when calling `initializeDevtools` but it is strongly recommended that you use\nit because several features in Fluid Devtools are powered by the telemetry that Fluid Framework generates, and this\nlogger is the way in which that telemetry gets into Fluid Devtools.\n\nYou can obtain a `DevtoolsLogger` by calling its constructor, and then should pass it to `initializeDevtools` _and_\nto the `Loader` instance you'll use to create/load Containers as shown below.\nThis way the logger will receive all the telemetry generated by Fluid Framework in your application, and forward it to\nFluid Devtools as necessary.\n\n```typescript\nimport { DevtoolsLogger, initializeDevtools } from \"@fluid-experimental/devtools-core\";\n\n// Instantiate the logger\nconst devtoolsLogger = new DevtoolsLogger();\n\n// Pass the logger when instantiating the Loader\nconst loader = new Loader({\n\tlogger: devtoolsLogger,\n\t// Other necessary properties ...\n});\n\n// Use the Loader to create (and optionally, attach) a Container\nconst container = await loader.createDetachedContainer(/* params */);\nawait container.attach(/* params */);\n\n// Initialize the Devtools passing the logger and your Container.\n// The Container could be added later as well with devtools.registerContainerDevtools().\nconst devtools = initializeDevtools({\n\tlogger: devtoolsLogger,\n\tinitialContainers: [\n\t\t{\n\t\t\tcontainer,\n\t\t\tcontainerKey: \"My Container\",\n\t\t},\n\t],\n});\n```\n\nIf you're working with `AzureClient` instead of lower-level APIs like the one described above, you probably want to\nrefer to the [@fluid-experimental/devtools package][devtools-package] instead of this one.\n\nDuring local development the recommendation is that your application should receive the `DevtoolsLogger` instance _instead_\nof any logger it would normally receive when deployed to a real environment, to avoid local development activity from\nmixing with real telemetry.\nIf you still want to provide a real application logger and use the Fluid Devtools features that are powered by telemetry\nat the same time, you can pass an existing logger to the `DevtoolsLogger` constructor and it will forward all telemetry\nit receives to that logger as well:\n\n```typescript\nimport { DevtoolsLogger } from \"@fluid-experimental/devtools-core\";\n\n// Your application's logger\nconst yourApplicationLogger = getInstanceOfYourApplicationLogger();\n\nconst devtoolsLogger = new DevtoolsLogger(yourApplicationLogger);\n\n// Pass devtoolsLogger to initializeDevtools() and to your application as described above\n```\n\n### Clean-up\n\nThe Devtools object is managed as a global singleton.\nThat singleton is automatically cleaned up prior to the Window's \"unload\" event.\nSo typical application flows likely won't need to worry about cleanup.\nThat said, if you wish to have tighter control over when the Devtools are torn down, you can simply call the `dispose` method on the handle returned by [initialization](#initialization).\n\n## Contributing to the package\n\n### Build\n\nTo build the package locally, first ensure you have run `pnpm install` from the root of the mono-repo.\nNext, to build the code, run `npm run build` from the root of the mono-repo, or use [fluid-build](https://github.com/microsoft/FluidFramework/tree/main/build-tools/packages/build-tools#running-fluid-build-command-line) via `fluid-build -t build`.\n\n- Note: Once you have run a build from the root, assuming no other changes outside of this package, you may run `npm run build` directly within this directory for a faster build.\n If you make changes to any of this package's local dependencies, you will need to run a build again from the root before building again from directly within this package.\n\n### Test\n\nTo run the tests, first ensure you have followed the [build](#build) steps above.\nNext, run `npm run test` from a terminal within this directory.\n\n\n\n\n\n\n\n## API Documentation\n\nAPI documentation for **@fluid-experimental/devtools-core** is available at .\n\n\n\n\n\n\n\n\n\n\n## Contribution Guidelines\n\nThere are many ways to [contribute](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md) to Fluid.\n\n- Participate in Q&A in our [GitHub Discussions](https://github.com/microsoft/FluidFramework/discussions).\n- [Submit bugs](https://github.com/microsoft/FluidFramework/issues) and help us verify fixes as they are checked in.\n- Review the [source code changes](https://github.com/microsoft/FluidFramework/pulls).\n- [Contribute bug fixes](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md).\n\nDetailed instructions for working in the repo can be found in the [Wiki](https://github.com/microsoft/FluidFramework/wiki).\n\nThis project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).\nFor more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\nUse of these trademarks or logos must follow Microsoft’s [Trademark & Brand Guidelines](https://www.microsoft.com/trademarks).\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n\n\n\n## Help\n\nNot finding what you're looking for in this README? Check out our [GitHub\nWiki](https://github.com/microsoft/FluidFramework/wiki) or [fluidframework.com](https://fluidframework.com/docs/).\n\nStill not finding what you're looking for? Please [file an\nissue](https://github.com/microsoft/FluidFramework/wiki/Submitting-Bugs-and-Feature-Requests).\n\nThank you!\n\n\n\n\n\n\n\n\n\n\n## Trademark\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\n\nUse of these trademarks or logos must follow Microsoft's [Trademark & Brand Guidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general).\n\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n[initialize-devtools-docs]: https://fluidframework.com/docs/apis/devtools-core#initializedevtools-function\n[devtools-logger-docs]: https://fluidframework.com/docs/apis/devtools-core/devtoolslogger-class\n[devtools-package]: https://www.npmjs.com/package/@fluid-experimental/devtools\n[browser-extension]: https://github.com/microsoft/FluidFramework/tree/main/packages/tools/devtools/devtools-browser-extension\n","scripts":{"api":"fluid-build . --task api","tsc":"tsc","lint":"npm run prettier && npm run check:release-tags && npm run eslint","test":"npm run test:mocha","build":"fluid-build . --task build","clean":"rimraf --glob _api-extractor-temp nyc dist lib \"**/*.tsbuildinfo\" \"**/*.build.log\"","eslint":"eslint src","format":"npm run prettier:fix","rebuild":"npm run clean && npm run build","lint:fix":"npm run prettier:fix && npm run eslint:fix","prettier":"prettier --check . --cache --ignore-path ../../../../.prettierignore","tsc:watch":"tsc --watch","build:docs":"fluid-build . --task api","eslint:fix":"eslint src --fix","test:mocha":"mocha \"dist/**/*.test.js\" --exit","build:esnext":"tsc --project ./tsconfig.esnext.json","build:genver":"gen-version","prettier:fix":"prettier --write . --cache --ignore-path ../../../../.prettierignore","build:compile":"fluid-build . --task compile","ci:build:docs":"api-extractor run","test:coverage":"c8 npm test","typetests:gen":"fluid-type-test-generator","build:commonjs":"fluid-build . --task commonjs","format-and-build":"npm run format && npm run build","typetests:prepare":"flub typetests --dir . --reset --previous --normalize","check:release-tags":"api-extractor run --local --config ./api-extractor-lint.json","format-and-compile":"npm run format && npm run build:compile","api-extractor:esnext":"copyfiles -u 1 \"dist/**/*-@(alpha|beta|public|untrimmed).d.ts\" lib","api-extractor:commonjs":"api-extractor run --local"},"_npmUser":{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},"_resolved":"/mnt/vss/_work/1/pack/scoped/fluid-experimental-devtools-core-2.0.0-dev.7.4.0.221926.tgz","_integrity":"sha512-1XCU4J+Si6BzToZsHud+RNozPg1vSF5ZJBGGa0TUd3/cMpzTfdbHEwH0I1asjpAP8k4cxgGG8Elme44GCj0/9A==","fluidBuild":{"tasks":{"tsc":["...","typetests:gen"],"build:docs":{"script":false,"dependsOn":["...","api-extractor:commonjs","api-extractor:esnext"]}}},"repository":{"url":"git+https://github.com/microsoft/FluidFramework.git","type":"git","directory":"packages/tools/devtools/devtools-core"},"_npmVersion":"9.6.7","description":"Fluid Framework developer tools core functionality","directories":{},"sideEffects":false,"_nodeVersion":"18.17.1","dependencies":{"@fluidframework/map":"2.0.0-dev.7.4.0.221926","@fluidframework/cell":"2.0.0-dev.7.4.0.221926","@fluidframework/matrix":"2.0.0-dev.7.4.0.221926","@fluidframework/counter":"2.0.0-dev.7.4.0.221926","@fluidframework/sequence":"2.0.0-dev.7.4.0.221926","@fluid-experimental/tree2":"2.0.0-dev.7.4.0.221926","@fluid-internal/client-utils":"2.0.0-dev.7.4.0.221926","@fluidframework/core-interfaces":"2.0.0-dev.7.4.0.221926","@fluidframework/telemetry-utils":"2.0.0-dev.7.4.0.221926","@fluidframework/container-loader":"2.0.0-dev.7.4.0.221926","@fluidframework/shared-object-base":"2.0.0-dev.7.4.0.221926","@fluidframework/protocol-definitions":"^3.0.0","@fluidframework/container-definitions":"2.0.0-dev.7.4.0.221926","@fluidframework/datastore-definitions":"2.0.0-dev.7.4.0.221926"},"_hasShrinkwrap":false,"readmeFilename":"README.md","typeValidation":{"broken":{}},"devDependencies":{"c8":"^7.7.1","chai":"^4.2.0","mocha":"^10.2.0","eslint":"~8.50.0","events":"^3.1.0","moment":"^2.21.0","rimraf":"^4.4.0","prettier":"~3.0.3","copyfiles":"^2.4.1","cross-env":"^7.0.3","typescript":"~5.1.6","@types/chai":"^4.0.0","@types/mocha":"^9.1.1","@types/events":"^3.0.0","mocha-multi-reporters":"^1.5.1","@fluid-tools/build-cli":"^0.28.0","eslint-config-prettier":"~9.0.0","@microsoft/api-extractor":"^7.38.3","eslint-plugin-chai-expect":"~3.0.0","mocha-json-output-reporter":"^2.0.1","@fluidframework/build-tools":"^0.28.0","@fluidframework/build-common":"^2.0.3","@fluidframework/mocha-test-setup":"2.0.0-dev.7.4.0.221926","@fluidframework/driver-definitions":"2.0.0-dev.7.4.0.221926","@fluidframework/test-runtime-utils":"2.0.0-dev.7.4.0.221926","@fluidframework/eslint-config-fluid":"^3.1.0","@fluid-experimental/devtools-core-previous":"npm:@fluid-experimental/devtools-core@2.0.0-internal.7.2.0"},"_npmOperationalInternal":{"tmp":"tmp/devtools-core_2.0.0-dev.7.4.0.221926_1702428479860_0.27687834918739185","host":"s3://npm-registry-packages"}},"2.0.0-internal.7.4.0":{"name":"@fluid-experimental/devtools-core","version":"2.0.0-internal.7.4.0","author":{"name":"Microsoft and contributors"},"license":"MIT","_id":"@fluid-experimental/devtools-core@2.0.0-internal.7.4.0","maintainers":[{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},{"name":"curtisman","email":"curtism@microsoft.com"}],"homepage":"https://fluidframework.com","bugs":{"url":"https://github.com/microsoft/FluidFramework/issues"},"c8":{"all":true,"exclude":["src/test/**/*.ts","dist/test/**/*.js"],"include":["src/**/*.ts","dist/**/*.js"],"reporter":["cobertura","html","text"],"cache-dir":"nyc/.cache","report-dir":"nyc/report","temp-directory":"nyc/.nyc_output","exclude-after-remap":false},"dist":{"shasum":"d3a83a420b6b27c4145c8fa3aa023c4c49a69a5c","tarball":"https://registry.npmjs.org/@fluid-experimental/devtools-core/-/devtools-core-2.0.0-internal.7.4.0.tgz","fileCount":510,"integrity":"sha512-eHbimPlgQe9HlSUx7fYt4nXlq2Z5hMOtA+XVM0ZAIv2VaSitu6HbcG3t+E3BOCRIfeUGXmWDJEFERhyWfEkO5g==","signatures":[{"sig":"MEYCIQDRcSpvZuQAG0ywjeTiq5qlC3UYLQ9btIER8NRa4623eQIhALobRu+YsMkrIkOLtTuHFDx2ZGC5dwMOYZaJvP3sQDeD","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}],"unpackedSize":1625178},"main":"dist/index.js","_from":"file:fluid-experimental-devtools-core-2.0.0-internal.7.4.0.tgz","types":"dist/index.d.ts","module":"lib/index.js","readme":"# @fluid-experimental/devtools-core\n\nThis library contains developer tools for use alongside the Fluid Framework.\nIt is used to power our associated [browser extension][browser-extension].\n\n- Chrome: \n- Edge: \n\n\n\n**IMPORTANT: This package is experimental.**\n**Its APIs may change without notice.**\n\n**Do not use in production scenarios.**\n\n\n\n\n\n\n\n\n## Installation\n\nTo get started, install the package by running the following command:\n\n```bash\nnpm i @fluid-experimental/devtools-core -D\n```\n\n\n\n\n\n## Usage\n\nThe Devtools' API surface is designed to fit nicely into most application flows.\n\n### Initialization\n\nTo initialize a devtools session for your container, call [`initializeDevtools`][initialize-devtools-docs].\nThis function accepts a `DevtoolsLogger` for receiving Fluid telemetry from your application, a list of initial Fluid\n`Containers` to associate with the session, and (optionally) customized data visualization configurations for visualizing\n`Container` data.\n\n#### About the [`DevtoolsLogger`][devtools-logger-docs]\n\nThe `DevtoolsLogger` is an optional piece when calling `initializeDevtools` but it is strongly recommended that you use\nit because several features in Fluid Devtools are powered by the telemetry that Fluid Framework generates, and this\nlogger is the way in which that telemetry gets into Fluid Devtools.\n\nYou can obtain a `DevtoolsLogger` by calling its constructor, and then should pass it to `initializeDevtools` _and_\nto the `Loader` instance you'll use to create/load Containers as shown below.\nThis way the logger will receive all the telemetry generated by Fluid Framework in your application, and forward it to\nFluid Devtools as necessary.\n\n```typescript\nimport { DevtoolsLogger, initializeDevtools } from \"@fluid-experimental/devtools-core\";\n\n// Instantiate the logger\nconst devtoolsLogger = new DevtoolsLogger();\n\n// Pass the logger when instantiating the Loader\nconst loader = new Loader({\n\tlogger: devtoolsLogger,\n\t// Other necessary properties ...\n});\n\n// Use the Loader to create (and optionally, attach) a Container\nconst container = await loader.createDetachedContainer(/* params */);\nawait container.attach(/* params */);\n\n// Initialize the Devtools passing the logger and your Container.\n// The Container could be added later as well with devtools.registerContainerDevtools().\nconst devtools = initializeDevtools({\n\tlogger: devtoolsLogger,\n\tinitialContainers: [\n\t\t{\n\t\t\tcontainer,\n\t\t\tcontainerKey: \"My Container\",\n\t\t},\n\t],\n});\n```\n\nIf you're working with `AzureClient` instead of lower-level APIs like the one described above, you probably want to\nrefer to the [@fluid-experimental/devtools package][devtools-package] instead of this one.\n\nDuring local development the recommendation is that your application should receive the `DevtoolsLogger` instance _instead_\nof any logger it would normally receive when deployed to a real environment, to avoid local development activity from\nmixing with real telemetry.\nIf you still want to provide a real application logger and use the Fluid Devtools features that are powered by telemetry\nat the same time, you can pass an existing logger to the `DevtoolsLogger` constructor and it will forward all telemetry\nit receives to that logger as well:\n\n```typescript\nimport { DevtoolsLogger } from \"@fluid-experimental/devtools-core\";\n\n// Your application's logger\nconst yourApplicationLogger = getInstanceOfYourApplicationLogger();\n\nconst devtoolsLogger = new DevtoolsLogger(yourApplicationLogger);\n\n// Pass devtoolsLogger to initializeDevtools() and to your application as described above\n```\n\n### Clean-up\n\nThe Devtools object is managed as a global singleton.\nThat singleton is automatically cleaned up prior to the Window's \"unload\" event.\nSo typical application flows likely won't need to worry about cleanup.\nThat said, if you wish to have tighter control over when the Devtools are torn down, you can simply call the `dispose` method on the handle returned by [initialization](#initialization).\n\n## Contributing to the package\n\n### Build\n\nTo build the package locally, first ensure you have run `pnpm install` from the root of the mono-repo.\nNext, to build the code, run `npm run build` from the root of the mono-repo, or use [fluid-build](https://github.com/microsoft/FluidFramework/tree/main/build-tools/packages/build-tools#running-fluid-build-command-line) via `fluid-build -t build`.\n\n- Note: Once you have run a build from the root, assuming no other changes outside of this package, you may run `npm run build` directly within this directory for a faster build.\n If you make changes to any of this package's local dependencies, you will need to run a build again from the root before building again from directly within this package.\n\n### Test\n\nTo run the tests, first ensure you have followed the [build](#build) steps above.\nNext, run `npm run test` from a terminal within this directory.\n\n\n\n\n\n\n\n## API Documentation\n\nAPI documentation for **@fluid-experimental/devtools-core** is available at .\n\n\n\n\n\n\n\n\n\n\n## Contribution Guidelines\n\nThere are many ways to [contribute](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md) to Fluid.\n\n- Participate in Q&A in our [GitHub Discussions](https://github.com/microsoft/FluidFramework/discussions).\n- [Submit bugs](https://github.com/microsoft/FluidFramework/issues) and help us verify fixes as they are checked in.\n- Review the [source code changes](https://github.com/microsoft/FluidFramework/pulls).\n- [Contribute bug fixes](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md).\n\nDetailed instructions for working in the repo can be found in the [Wiki](https://github.com/microsoft/FluidFramework/wiki).\n\nThis project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).\nFor more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\nUse of these trademarks or logos must follow Microsoft’s [Trademark & Brand Guidelines](https://www.microsoft.com/trademarks).\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n\n\n\n## Help\n\nNot finding what you're looking for in this README? Check out our [GitHub\nWiki](https://github.com/microsoft/FluidFramework/wiki) or [fluidframework.com](https://fluidframework.com/docs/).\n\nStill not finding what you're looking for? Please [file an\nissue](https://github.com/microsoft/FluidFramework/wiki/Submitting-Bugs-and-Feature-Requests).\n\nThank you!\n\n\n\n\n\n\n\n\n\n\n## Trademark\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\n\nUse of these trademarks or logos must follow Microsoft's [Trademark & Brand Guidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general).\n\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n[initialize-devtools-docs]: https://fluidframework.com/docs/apis/devtools-core#initializedevtools-function\n[devtools-logger-docs]: https://fluidframework.com/docs/apis/devtools-core/devtoolslogger-class\n[devtools-package]: https://www.npmjs.com/package/@fluid-experimental/devtools\n[browser-extension]: https://github.com/microsoft/FluidFramework/tree/main/packages/tools/devtools/devtools-browser-extension\n","scripts":{"api":"fluid-build . --task api","tsc":"tsc","lint":"npm run prettier && npm run check:release-tags && npm run eslint","test":"npm run test:mocha","build":"fluid-build . --task build","clean":"rimraf --glob _api-extractor-temp nyc dist lib \"**/*.tsbuildinfo\" \"**/*.build.log\"","eslint":"eslint src","format":"npm run prettier:fix","rebuild":"npm run clean && npm run build","lint:fix":"npm run prettier:fix && npm run eslint:fix","prettier":"prettier --check . --cache --ignore-path ../../../../.prettierignore","tsc:watch":"tsc --watch","build:docs":"fluid-build . --task api","eslint:fix":"eslint src --fix","test:mocha":"mocha \"dist/**/*.test.js\" --exit","build:esnext":"tsc --project ./tsconfig.esnext.json","build:genver":"gen-version","prettier:fix":"prettier --write . --cache --ignore-path ../../../../.prettierignore","build:compile":"fluid-build . --task compile","ci:build:docs":"api-extractor run","test:coverage":"c8 npm test","typetests:gen":"fluid-type-test-generator","build:commonjs":"fluid-build . --task commonjs","format-and-build":"npm run format && npm run build","typetests:prepare":"flub typetests --dir . --reset --previous --normalize","check:release-tags":"api-extractor run --local --config ./api-extractor-lint.json","format-and-compile":"npm run format && npm run build:compile","api-extractor:esnext":"copyfiles -u 1 \"dist/**/*-@(alpha|beta|public|untrimmed).d.ts\" lib","api-extractor:commonjs":"api-extractor run --local"},"_npmUser":{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},"_resolved":"/mnt/vss/_work/1/pack/scoped/fluid-experimental-devtools-core-2.0.0-internal.7.4.0.tgz","_integrity":"sha512-eHbimPlgQe9HlSUx7fYt4nXlq2Z5hMOtA+XVM0ZAIv2VaSitu6HbcG3t+E3BOCRIfeUGXmWDJEFERhyWfEkO5g==","fluidBuild":{"tasks":{"tsc":["...","typetests:gen"],"build:docs":{"script":false,"dependsOn":["...","api-extractor:commonjs","api-extractor:esnext"]}}},"repository":{"url":"git+https://github.com/microsoft/FluidFramework.git","type":"git","directory":"packages/tools/devtools/devtools-core"},"_npmVersion":"9.6.7","description":"Fluid Framework developer tools core functionality","directories":{},"sideEffects":false,"_nodeVersion":"18.17.1","dependencies":{"@fluidframework/map":">=2.0.0-internal.7.4.0 <2.0.0-internal.7.5.0","@fluidframework/cell":">=2.0.0-internal.7.4.0 <2.0.0-internal.7.5.0","@fluidframework/matrix":">=2.0.0-internal.7.4.0 <2.0.0-internal.7.5.0","@fluidframework/counter":">=2.0.0-internal.7.4.0 <2.0.0-internal.7.5.0","@fluidframework/sequence":">=2.0.0-internal.7.4.0 <2.0.0-internal.7.5.0","@fluid-experimental/tree2":">=2.0.0-internal.7.4.0 <2.0.0-internal.7.5.0","@fluid-internal/client-utils":">=2.0.0-internal.7.4.0 <2.0.0-internal.7.5.0","@fluidframework/core-interfaces":">=2.0.0-internal.7.4.0 <2.0.0-internal.7.5.0","@fluidframework/telemetry-utils":">=2.0.0-internal.7.4.0 <2.0.0-internal.7.5.0","@fluidframework/container-loader":">=2.0.0-internal.7.4.0 <2.0.0-internal.7.5.0","@fluidframework/shared-object-base":">=2.0.0-internal.7.4.0 <2.0.0-internal.7.5.0","@fluidframework/protocol-definitions":"^3.0.0","@fluidframework/container-definitions":">=2.0.0-internal.7.4.0 <2.0.0-internal.7.5.0","@fluidframework/datastore-definitions":">=2.0.0-internal.7.4.0 <2.0.0-internal.7.5.0"},"_hasShrinkwrap":false,"readmeFilename":"README.md","typeValidation":{"broken":{}},"devDependencies":{"c8":"^7.7.1","chai":"^4.2.0","mocha":"^10.2.0","eslint":"~8.50.0","events":"^3.1.0","moment":"^2.21.0","rimraf":"^4.4.0","prettier":"~3.0.3","copyfiles":"^2.4.1","cross-env":"^7.0.3","typescript":"~5.1.6","@types/chai":"^4.0.0","@types/mocha":"^9.1.1","@types/events":"^3.0.0","mocha-multi-reporters":"^1.5.1","@fluid-tools/build-cli":"^0.28.0","eslint-config-prettier":"~9.0.0","@microsoft/api-extractor":"^7.38.3","eslint-plugin-chai-expect":"~3.0.0","mocha-json-output-reporter":"^2.0.1","@fluidframework/build-tools":"^0.28.0","@fluidframework/build-common":"^2.0.3","@fluidframework/mocha-test-setup":">=2.0.0-internal.7.4.0 <2.0.0-internal.7.5.0","@fluidframework/driver-definitions":">=2.0.0-internal.7.4.0 <2.0.0-internal.7.5.0","@fluidframework/test-runtime-utils":">=2.0.0-internal.7.4.0 <2.0.0-internal.7.5.0","@fluidframework/eslint-config-fluid":"^3.1.0","@fluid-experimental/devtools-core-previous":"npm:@fluid-experimental/devtools-core@2.0.0-internal.7.2.0"},"_npmOperationalInternal":{"tmp":"tmp/devtools-core_2.0.0-internal.7.4.0_1702490562094_0.3932814722581952","host":"s3://npm-registry-packages"}},"2.0.0-internal.8.0.0":{"name":"@fluid-experimental/devtools-core","version":"2.0.0-internal.8.0.0","author":{"name":"Microsoft and contributors"},"license":"MIT","_id":"@fluid-experimental/devtools-core@2.0.0-internal.8.0.0","maintainers":[{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},{"name":"curtisman","email":"curtism@microsoft.com"}],"homepage":"https://fluidframework.com","bugs":{"url":"https://github.com/microsoft/FluidFramework/issues"},"c8":{"all":true,"exclude":["src/test/**/*.ts","dist/test/**/*.js"],"include":["src/**/*.ts","dist/**/*.js"],"reporter":["cobertura","html","text"],"cache-dir":"nyc/.cache","report-dir":"nyc/report","temp-directory":"nyc/.nyc_output","exclude-after-remap":false},"dist":{"shasum":"31ee08872df7bc7b9e30f7a2ba7f20b0a098e04d","tarball":"https://registry.npmjs.org/@fluid-experimental/devtools-core/-/devtools-core-2.0.0-internal.8.0.0.tgz","fileCount":510,"integrity":"sha512-+CkHfmz0zzYoQ/CknxSMl4NUEsPm1EmLWgwrugt6mqEOYnxI8LfJ6+NpVkgvJFQIgz5znwgie3h7u2PGHpEEnw==","signatures":[{"sig":"MEQCIEfNMqFQgDnIr7gI0lnT826z54beL2Dd0kLwf4zvXbnPAiBgVd5waUWKxWAE/KpdsoL4vzlHRUHQ8VL8+4gsCUfMlQ==","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}],"unpackedSize":1629472},"main":"dist/index.js","_from":"file:fluid-experimental-devtools-core-2.0.0-internal.8.0.0.tgz","types":"dist/index.d.ts","module":"lib/index.js","readme":"# @fluid-experimental/devtools-core\n\nThis library contains developer tools for use alongside the Fluid Framework.\nIt is used to power our associated [browser extension][browser-extension].\n\n- Chrome: \n- Edge: \n\n\n\n**IMPORTANT: This package is experimental.**\n**Its APIs may change without notice.**\n\n**Do not use in production scenarios.**\n\n\n\n\n\n\n\n\n## Installation\n\nTo get started, install the package by running the following command:\n\n```bash\nnpm i @fluid-experimental/devtools-core -D\n```\n\n\n\n\n\n## Usage\n\nThe Devtools' API surface is designed to fit nicely into most application flows.\n\n### Initialization\n\nTo initialize a devtools session for your container, call [`initializeDevtools`][initialize-devtools-docs].\nThis function accepts a `DevtoolsLogger` for receiving Fluid telemetry from your application, a list of initial Fluid\n`Containers` to associate with the session, and (optionally) customized data visualization configurations for visualizing\n`Container` data.\n\n#### About the [`DevtoolsLogger`][devtools-logger-docs]\n\nThe `DevtoolsLogger` is an optional piece when calling `initializeDevtools` but it is strongly recommended that you use\nit because several features in Fluid Devtools are powered by the telemetry that Fluid Framework generates, and this\nlogger is the way in which that telemetry gets into Fluid Devtools.\n\nYou can obtain a `DevtoolsLogger` by calling its constructor, and then should pass it to `initializeDevtools` _and_\nto the `Loader` instance you'll use to create/load Containers as shown below.\nThis way the logger will receive all the telemetry generated by Fluid Framework in your application, and forward it to\nFluid Devtools as necessary.\n\n```typescript\nimport { DevtoolsLogger, initializeDevtools } from \"@fluid-experimental/devtools-core\";\n\n// Instantiate the logger\nconst devtoolsLogger = new DevtoolsLogger();\n\n// Pass the logger when instantiating the Loader\nconst loader = new Loader({\n\tlogger: devtoolsLogger,\n\t// Other necessary properties ...\n});\n\n// Use the Loader to create (and optionally, attach) a Container\nconst container = await loader.createDetachedContainer(/* params */);\nawait container.attach(/* params */);\n\n// Initialize the Devtools passing the logger and your Container.\n// The Container could be added later as well with devtools.registerContainerDevtools().\nconst devtools = initializeDevtools({\n\tlogger: devtoolsLogger,\n\tinitialContainers: [\n\t\t{\n\t\t\tcontainer,\n\t\t\tcontainerKey: \"My Container\",\n\t\t},\n\t],\n});\n```\n\nIf you're working with `AzureClient` instead of lower-level APIs like the one described above, you probably want to\nrefer to the [@fluid-experimental/devtools package][devtools-package] instead of this one.\n\nDuring local development the recommendation is that your application should receive the `DevtoolsLogger` instance _instead_\nof any logger it would normally receive when deployed to a real environment, to avoid local development activity from\nmixing with real telemetry.\nIf you still want to provide a real application logger and use the Fluid Devtools features that are powered by telemetry\nat the same time, you can pass an existing logger to the `DevtoolsLogger` constructor and it will forward all telemetry\nit receives to that logger as well:\n\n```typescript\nimport { DevtoolsLogger } from \"@fluid-experimental/devtools-core\";\n\n// Your application's logger\nconst yourApplicationLogger = getInstanceOfYourApplicationLogger();\n\nconst devtoolsLogger = new DevtoolsLogger(yourApplicationLogger);\n\n// Pass devtoolsLogger to initializeDevtools() and to your application as described above\n```\n\n### Clean-up\n\nThe Devtools object is managed as a global singleton.\nThat singleton is automatically cleaned up prior to the Window's \"unload\" event.\nSo typical application flows likely won't need to worry about cleanup.\nThat said, if you wish to have tighter control over when the Devtools are torn down, you can simply call the `dispose` method on the handle returned by [initialization](#initialization).\n\n## Contributing to the package\n\n### Build\n\nTo build the package locally, first ensure you have run `pnpm install` from the root of the mono-repo.\nNext, to build the code, run `npm run build` from the root of the mono-repo, or use [fluid-build](https://github.com/microsoft/FluidFramework/tree/main/build-tools/packages/build-tools#running-fluid-build-command-line) via `fluid-build -t build`.\n\n- Note: Once you have run a build from the root, assuming no other changes outside of this package, you may run `npm run build` directly within this directory for a faster build.\n If you make changes to any of this package's local dependencies, you will need to run a build again from the root before building again from directly within this package.\n\n### Test\n\nTo run the tests, first ensure you have followed the [build](#build) steps above.\nNext, run `npm run test` from a terminal within this directory.\n\n\n\n\n\n\n\n## API Documentation\n\nAPI documentation for **@fluid-experimental/devtools-core** is available at .\n\n\n\n\n\n\n\n\n\n\n## Contribution Guidelines\n\nThere are many ways to [contribute](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md) to Fluid.\n\n- Participate in Q&A in our [GitHub Discussions](https://github.com/microsoft/FluidFramework/discussions).\n- [Submit bugs](https://github.com/microsoft/FluidFramework/issues) and help us verify fixes as they are checked in.\n- Review the [source code changes](https://github.com/microsoft/FluidFramework/pulls).\n- [Contribute bug fixes](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md).\n\nDetailed instructions for working in the repo can be found in the [Wiki](https://github.com/microsoft/FluidFramework/wiki).\n\nThis project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).\nFor more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\nUse of these trademarks or logos must follow Microsoft’s [Trademark & Brand Guidelines](https://www.microsoft.com/trademarks).\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n\n\n\n## Help\n\nNot finding what you're looking for in this README? Check out our [GitHub\nWiki](https://github.com/microsoft/FluidFramework/wiki) or [fluidframework.com](https://fluidframework.com/docs/).\n\nStill not finding what you're looking for? Please [file an\nissue](https://github.com/microsoft/FluidFramework/wiki/Submitting-Bugs-and-Feature-Requests).\n\nThank you!\n\n\n\n\n\n\n\n\n\n\n## Trademark\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\n\nUse of these trademarks or logos must follow Microsoft's [Trademark & Brand Guidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general).\n\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n[initialize-devtools-docs]: https://fluidframework.com/docs/apis/devtools-core#initializedevtools-function\n[devtools-logger-docs]: https://fluidframework.com/docs/apis/devtools-core/devtoolslogger-class\n[devtools-package]: https://www.npmjs.com/package/@fluid-experimental/devtools\n[browser-extension]: https://github.com/microsoft/FluidFramework/tree/main/packages/tools/devtools/devtools-browser-extension\n","scripts":{"api":"fluid-build . --task api","tsc":"tsc","lint":"npm run prettier && npm run check:release-tags && npm run eslint","test":"npm run test:mocha","build":"fluid-build . --task build","clean":"rimraf --glob _api-extractor-temp nyc dist lib \"**/*.tsbuildinfo\" \"**/*.build.log\"","eslint":"eslint src","format":"npm run prettier:fix","rebuild":"npm run clean && npm run build","lint:fix":"npm run prettier:fix && npm run eslint:fix","prettier":"prettier --check . --cache --ignore-path ../../../../.prettierignore","tsc:watch":"tsc --watch","build:docs":"fluid-build . --task api","eslint:fix":"eslint src --fix","test:mocha":"mocha \"dist/**/*.test.js\" --exit","build:esnext":"tsc --project ./tsconfig.esnext.json","build:genver":"gen-version","prettier:fix":"prettier --write . --cache --ignore-path ../../../../.prettierignore","build:compile":"fluid-build . --task compile","ci:build:docs":"api-extractor run","test:coverage":"c8 npm test","typetests:gen":"fluid-type-test-generator","build:commonjs":"fluid-build . --task commonjs","format-and-build":"npm run format && npm run build","typetests:prepare":"flub typetests --dir . --reset --previous --normalize","check:release-tags":"api-extractor run --local --config ./api-extractor-lint.json","format-and-compile":"npm run format && npm run build:compile","api-extractor:esnext":"copyfiles -u 1 \"dist/**/*-@(alpha|beta|public|untrimmed).d.ts\" lib","api-extractor:commonjs":"api-extractor run --local"},"_npmUser":{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},"_resolved":"/mnt/vss/_work/1/pack/scoped/fluid-experimental-devtools-core-2.0.0-internal.8.0.0.tgz","_integrity":"sha512-+CkHfmz0zzYoQ/CknxSMl4NUEsPm1EmLWgwrugt6mqEOYnxI8LfJ6+NpVkgvJFQIgz5znwgie3h7u2PGHpEEnw==","fluidBuild":{"tasks":{"tsc":["...","typetests:gen"],"build:docs":{"script":false,"dependsOn":["...","api-extractor:commonjs","api-extractor:esnext"]}}},"repository":{"url":"git+https://github.com/microsoft/FluidFramework.git","type":"git","directory":"packages/tools/devtools/devtools-core"},"_npmVersion":"9.6.7","description":"Fluid Framework developer tools core functionality","directories":{},"sideEffects":false,"_nodeVersion":"18.17.1","dependencies":{"@fluidframework/map":">=2.0.0-internal.8.0.0 <2.0.0-internal.8.1.0","@fluidframework/cell":">=2.0.0-internal.8.0.0 <2.0.0-internal.8.1.0","@fluidframework/matrix":">=2.0.0-internal.8.0.0 <2.0.0-internal.8.1.0","@fluidframework/counter":">=2.0.0-internal.8.0.0 <2.0.0-internal.8.1.0","@fluidframework/sequence":">=2.0.0-internal.8.0.0 <2.0.0-internal.8.1.0","@fluid-experimental/tree2":">=2.0.0-internal.8.0.0 <2.0.0-internal.8.1.0","@fluid-internal/client-utils":">=2.0.0-internal.8.0.0 <2.0.0-internal.8.1.0","@fluidframework/core-interfaces":">=2.0.0-internal.8.0.0 <2.0.0-internal.8.1.0","@fluidframework/telemetry-utils":">=2.0.0-internal.8.0.0 <2.0.0-internal.8.1.0","@fluidframework/container-loader":">=2.0.0-internal.8.0.0 <2.0.0-internal.8.1.0","@fluidframework/shared-object-base":">=2.0.0-internal.8.0.0 <2.0.0-internal.8.1.0","@fluidframework/protocol-definitions":"^3.0.0","@fluidframework/container-definitions":">=2.0.0-internal.8.0.0 <2.0.0-internal.8.1.0","@fluidframework/datastore-definitions":">=2.0.0-internal.8.0.0 <2.0.0-internal.8.1.0"},"_hasShrinkwrap":false,"readmeFilename":"README.md","typeValidation":{"broken":{"TypeAliasDeclaration_Primitive":{"forwardCompat":false},"TypeAliasDeclaration_VisualNode":{"forwardCompat":false},"InterfaceDeclaration_TreeNodeBase":{"forwardCompat":false},"InterfaceDeclaration_ValueNodeBase":{"forwardCompat":false},"InterfaceDeclaration_VisualNodeBase":{"forwardCompat":false},"InterfaceDeclaration_VisualTreeNode":{"forwardCompat":false},"TypeAliasDeclaration_RootHandleNode":{"forwardCompat":false},"InterfaceDeclaration_FluidHandleNode":{"forwardCompat":false},"InterfaceDeclaration_VisualValueNode":{"forwardCompat":false},"TypeAliasDeclaration_VisualChildNode":{"forwardCompat":false},"InterfaceDeclaration_UnknownObjectNode":{"forwardCompat":false},"InterfaceDeclaration_FluidDevtoolsProps":{"backCompat":false},"InterfaceDeclaration_FluidObjectNodeBase":{"forwardCompat":false},"InterfaceDeclaration_ContainerDevtoolsProps":{"backCompat":false}}},"devDependencies":{"c8":"^7.7.1","chai":"^4.2.0","mocha":"^10.2.0","eslint":"~8.50.0","events":"^3.1.0","moment":"^2.21.0","rimraf":"^4.4.0","prettier":"~3.0.3","copyfiles":"^2.4.1","cross-env":"^7.0.3","typescript":"~5.1.6","@types/chai":"^4.0.0","@types/mocha":"^9.1.1","@types/events":"^3.0.0","mocha-multi-reporters":"^1.5.1","@fluid-tools/build-cli":"^0.28.0","eslint-config-prettier":"~9.0.0","@microsoft/api-extractor":"^7.38.3","eslint-plugin-chai-expect":"~3.0.0","mocha-json-output-reporter":"^2.0.1","@fluidframework/build-tools":"^0.28.0","@fluidframework/build-common":"^2.0.3","@fluidframework/mocha-test-setup":">=2.0.0-internal.8.0.0 <2.0.0-internal.8.1.0","@fluidframework/driver-definitions":">=2.0.0-internal.8.0.0 <2.0.0-internal.8.1.0","@fluidframework/test-runtime-utils":">=2.0.0-internal.8.0.0 <2.0.0-internal.8.1.0","@fluidframework/eslint-config-fluid":"^3.1.0","@fluid-experimental/devtools-core-previous":"npm:@fluid-experimental/devtools-core@2.0.0-internal.7.2.0"},"_npmOperationalInternal":{"tmp":"tmp/devtools-core_2.0.0-internal.8.0.0_1702524376741_0.16091361410831162","host":"s3://npm-registry-packages"}},"2.0.0-internal.8.0.1":{"name":"@fluid-experimental/devtools-core","version":"2.0.0-internal.8.0.1","author":{"name":"Microsoft and contributors"},"license":"MIT","_id":"@fluid-experimental/devtools-core@2.0.0-internal.8.0.1","maintainers":[{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},{"name":"curtisman","email":"curtism@microsoft.com"}],"homepage":"https://fluidframework.com","bugs":{"url":"https://github.com/microsoft/FluidFramework/issues"},"c8":{"all":true,"exclude":["src/test/**/*.ts","dist/test/**/*.js"],"include":["src/**/*.ts","dist/**/*.js"],"reporter":["cobertura","html","text"],"cache-dir":"nyc/.cache","report-dir":"nyc/report","temp-directory":"nyc/.nyc_output","exclude-after-remap":false},"dist":{"shasum":"c13f9c3b70622639e54989208d2ea7eb86c763fc","tarball":"https://registry.npmjs.org/@fluid-experimental/devtools-core/-/devtools-core-2.0.0-internal.8.0.1.tgz","fileCount":510,"integrity":"sha512-6MR9b4+1O7lvZ+4LXK1c6dco4aHGjD6ZQdZUucXznT4NeAA2Pc6wt23Cv72qLCHxK5jW81HGUeVMnIZd2nK0Dw==","signatures":[{"sig":"MEYCIQDqKrGF9DpNIMv4d3qKJ25owJS6/5v90FZ1oAvaVNCzigIhAPikF+fjAL2N/tmDu8e/BBLYG3+UB9N7+KVbJMlTzXjL","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}],"unpackedSize":1629472},"main":"dist/index.js","_from":"file:fluid-experimental-devtools-core-2.0.0-internal.8.0.1.tgz","types":"dist/index.d.ts","module":"lib/index.js","readme":"# @fluid-experimental/devtools-core\n\nThis library contains developer tools for use alongside the Fluid Framework.\nIt is used to power our associated [browser extension][browser-extension].\n\n- Chrome: \n- Edge: \n\n\n\n**IMPORTANT: This package is experimental.**\n**Its APIs may change without notice.**\n\n**Do not use in production scenarios.**\n\n\n\n\n\n\n\n\n## Installation\n\nTo get started, install the package by running the following command:\n\n```bash\nnpm i @fluid-experimental/devtools-core -D\n```\n\n\n\n\n\n## Usage\n\nThe Devtools' API surface is designed to fit nicely into most application flows.\n\n### Initialization\n\nTo initialize a devtools session for your container, call [`initializeDevtools`][initialize-devtools-docs].\nThis function accepts a `DevtoolsLogger` for receiving Fluid telemetry from your application, a list of initial Fluid\n`Containers` to associate with the session, and (optionally) customized data visualization configurations for visualizing\n`Container` data.\n\n#### About the [`DevtoolsLogger`][devtools-logger-docs]\n\nThe `DevtoolsLogger` is an optional piece when calling `initializeDevtools` but it is strongly recommended that you use\nit because several features in Fluid Devtools are powered by the telemetry that Fluid Framework generates, and this\nlogger is the way in which that telemetry gets into Fluid Devtools.\n\nYou can obtain a `DevtoolsLogger` by calling its constructor, and then should pass it to `initializeDevtools` _and_\nto the `Loader` instance you'll use to create/load Containers as shown below.\nThis way the logger will receive all the telemetry generated by Fluid Framework in your application, and forward it to\nFluid Devtools as necessary.\n\n```typescript\nimport { DevtoolsLogger, initializeDevtools } from \"@fluid-experimental/devtools-core\";\n\n// Instantiate the logger\nconst devtoolsLogger = new DevtoolsLogger();\n\n// Pass the logger when instantiating the Loader\nconst loader = new Loader({\n\tlogger: devtoolsLogger,\n\t// Other necessary properties ...\n});\n\n// Use the Loader to create (and optionally, attach) a Container\nconst container = await loader.createDetachedContainer(/* params */);\nawait container.attach(/* params */);\n\n// Initialize the Devtools passing the logger and your Container.\n// The Container could be added later as well with devtools.registerContainerDevtools().\nconst devtools = initializeDevtools({\n\tlogger: devtoolsLogger,\n\tinitialContainers: [\n\t\t{\n\t\t\tcontainer,\n\t\t\tcontainerKey: \"My Container\",\n\t\t},\n\t],\n});\n```\n\nIf you're working with `AzureClient` instead of lower-level APIs like the one described above, you probably want to\nrefer to the [@fluid-experimental/devtools package][devtools-package] instead of this one.\n\nDuring local development the recommendation is that your application should receive the `DevtoolsLogger` instance _instead_\nof any logger it would normally receive when deployed to a real environment, to avoid local development activity from\nmixing with real telemetry.\nIf you still want to provide a real application logger and use the Fluid Devtools features that are powered by telemetry\nat the same time, you can pass an existing logger to the `DevtoolsLogger` constructor and it will forward all telemetry\nit receives to that logger as well:\n\n```typescript\nimport { DevtoolsLogger } from \"@fluid-experimental/devtools-core\";\n\n// Your application's logger\nconst yourApplicationLogger = getInstanceOfYourApplicationLogger();\n\nconst devtoolsLogger = new DevtoolsLogger(yourApplicationLogger);\n\n// Pass devtoolsLogger to initializeDevtools() and to your application as described above\n```\n\n### Clean-up\n\nThe Devtools object is managed as a global singleton.\nThat singleton is automatically cleaned up prior to the Window's \"unload\" event.\nSo typical application flows likely won't need to worry about cleanup.\nThat said, if you wish to have tighter control over when the Devtools are torn down, you can simply call the `dispose` method on the handle returned by [initialization](#initialization).\n\n## Contributing to the package\n\n### Build\n\nTo build the package locally, first ensure you have run `pnpm install` from the root of the mono-repo.\nNext, to build the code, run `npm run build` from the root of the mono-repo, or use [fluid-build](https://github.com/microsoft/FluidFramework/tree/main/build-tools/packages/build-tools#running-fluid-build-command-line) via `fluid-build -t build`.\n\n- Note: Once you have run a build from the root, assuming no other changes outside of this package, you may run `npm run build` directly within this directory for a faster build.\n If you make changes to any of this package's local dependencies, you will need to run a build again from the root before building again from directly within this package.\n\n### Test\n\nTo run the tests, first ensure you have followed the [build](#build) steps above.\nNext, run `npm run test` from a terminal within this directory.\n\n\n\n\n\n\n\n## API Documentation\n\nAPI documentation for **@fluid-experimental/devtools-core** is available at .\n\n\n\n\n\n\n\n\n\n\n## Contribution Guidelines\n\nThere are many ways to [contribute](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md) to Fluid.\n\n- Participate in Q&A in our [GitHub Discussions](https://github.com/microsoft/FluidFramework/discussions).\n- [Submit bugs](https://github.com/microsoft/FluidFramework/issues) and help us verify fixes as they are checked in.\n- Review the [source code changes](https://github.com/microsoft/FluidFramework/pulls).\n- [Contribute bug fixes](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md).\n\nDetailed instructions for working in the repo can be found in the [Wiki](https://github.com/microsoft/FluidFramework/wiki).\n\nThis project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).\nFor more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\nUse of these trademarks or logos must follow Microsoft’s [Trademark & Brand Guidelines](https://www.microsoft.com/trademarks).\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n\n\n\n## Help\n\nNot finding what you're looking for in this README? Check out our [GitHub\nWiki](https://github.com/microsoft/FluidFramework/wiki) or [fluidframework.com](https://fluidframework.com/docs/).\n\nStill not finding what you're looking for? Please [file an\nissue](https://github.com/microsoft/FluidFramework/wiki/Submitting-Bugs-and-Feature-Requests).\n\nThank you!\n\n\n\n\n\n\n\n\n\n\n## Trademark\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\n\nUse of these trademarks or logos must follow Microsoft's [Trademark & Brand Guidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general).\n\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n[initialize-devtools-docs]: https://fluidframework.com/docs/apis/devtools-core#initializedevtools-function\n[devtools-logger-docs]: https://fluidframework.com/docs/apis/devtools-core/devtoolslogger-class\n[devtools-package]: https://www.npmjs.com/package/@fluid-experimental/devtools\n[browser-extension]: https://github.com/microsoft/FluidFramework/tree/main/packages/tools/devtools/devtools-browser-extension\n","scripts":{"api":"fluid-build . --task api","tsc":"tsc","lint":"npm run prettier && npm run check:release-tags && npm run eslint","test":"npm run test:mocha","build":"fluid-build . --task build","clean":"rimraf --glob _api-extractor-temp nyc dist lib \"**/*.tsbuildinfo\" \"**/*.build.log\"","eslint":"eslint src","format":"npm run prettier:fix","rebuild":"npm run clean && npm run build","lint:fix":"npm run prettier:fix && npm run eslint:fix","prettier":"prettier --check . --cache --ignore-path ../../../../.prettierignore","tsc:watch":"tsc --watch","build:docs":"fluid-build . --task api","eslint:fix":"eslint src --fix","test:mocha":"mocha \"dist/**/*.test.js\" --exit","build:esnext":"tsc --project ./tsconfig.esnext.json","build:genver":"gen-version","prettier:fix":"prettier --write . --cache --ignore-path ../../../../.prettierignore","build:compile":"fluid-build . --task compile","ci:build:docs":"api-extractor run","test:coverage":"c8 npm test","typetests:gen":"fluid-type-test-generator","build:commonjs":"fluid-build . --task commonjs","format-and-build":"npm run format && npm run build","typetests:prepare":"flub typetests --dir . --reset --previous --normalize","check:release-tags":"api-extractor run --local --config ./api-extractor-lint.json","format-and-compile":"npm run format && npm run build:compile","api-extractor:esnext":"copyfiles -u 1 \"dist/**/*-@(alpha|beta|public|untrimmed).d.ts\" lib","api-extractor:commonjs":"api-extractor run --local"},"_npmUser":{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},"_resolved":"/mnt/vss/_work/1/pack/scoped/fluid-experimental-devtools-core-2.0.0-internal.8.0.1.tgz","_integrity":"sha512-6MR9b4+1O7lvZ+4LXK1c6dco4aHGjD6ZQdZUucXznT4NeAA2Pc6wt23Cv72qLCHxK5jW81HGUeVMnIZd2nK0Dw==","fluidBuild":{"tasks":{"tsc":["...","typetests:gen"],"build:docs":{"script":false,"dependsOn":["...","api-extractor:commonjs","api-extractor:esnext"]}}},"repository":{"url":"git+https://github.com/microsoft/FluidFramework.git","type":"git","directory":"packages/tools/devtools/devtools-core"},"_npmVersion":"9.6.7","description":"Fluid Framework developer tools core functionality","directories":{},"sideEffects":false,"_nodeVersion":"18.17.1","dependencies":{"@fluidframework/map":">=2.0.0-internal.8.0.1 <2.0.0-internal.8.1.0","@fluidframework/cell":">=2.0.0-internal.8.0.1 <2.0.0-internal.8.1.0","@fluidframework/matrix":">=2.0.0-internal.8.0.1 <2.0.0-internal.8.1.0","@fluidframework/counter":">=2.0.0-internal.8.0.1 <2.0.0-internal.8.1.0","@fluidframework/sequence":">=2.0.0-internal.8.0.1 <2.0.0-internal.8.1.0","@fluid-experimental/tree2":">=2.0.0-internal.8.0.1 <2.0.0-internal.8.1.0","@fluid-internal/client-utils":">=2.0.0-internal.8.0.1 <2.0.0-internal.8.1.0","@fluidframework/core-interfaces":">=2.0.0-internal.8.0.1 <2.0.0-internal.8.1.0","@fluidframework/telemetry-utils":">=2.0.0-internal.8.0.1 <2.0.0-internal.8.1.0","@fluidframework/container-loader":">=2.0.0-internal.8.0.1 <2.0.0-internal.8.1.0","@fluidframework/shared-object-base":">=2.0.0-internal.8.0.1 <2.0.0-internal.8.1.0","@fluidframework/protocol-definitions":"^3.0.0","@fluidframework/container-definitions":">=2.0.0-internal.8.0.1 <2.0.0-internal.8.1.0","@fluidframework/datastore-definitions":">=2.0.0-internal.8.0.1 <2.0.0-internal.8.1.0"},"_hasShrinkwrap":false,"readmeFilename":"README.md","typeValidation":{"broken":{"TypeAliasDeclaration_Primitive":{"forwardCompat":false},"TypeAliasDeclaration_VisualNode":{"forwardCompat":false},"InterfaceDeclaration_TreeNodeBase":{"forwardCompat":false},"InterfaceDeclaration_ValueNodeBase":{"forwardCompat":false},"InterfaceDeclaration_VisualNodeBase":{"forwardCompat":false},"InterfaceDeclaration_VisualTreeNode":{"forwardCompat":false},"TypeAliasDeclaration_RootHandleNode":{"forwardCompat":false},"InterfaceDeclaration_FluidHandleNode":{"forwardCompat":false},"InterfaceDeclaration_VisualValueNode":{"forwardCompat":false},"TypeAliasDeclaration_VisualChildNode":{"forwardCompat":false},"InterfaceDeclaration_UnknownObjectNode":{"forwardCompat":false},"InterfaceDeclaration_FluidDevtoolsProps":{"backCompat":false},"InterfaceDeclaration_FluidObjectNodeBase":{"forwardCompat":false},"InterfaceDeclaration_ContainerDevtoolsProps":{"backCompat":false}}},"devDependencies":{"c8":"^7.7.1","chai":"^4.2.0","mocha":"^10.2.0","eslint":"~8.50.0","events":"^3.1.0","moment":"^2.21.0","rimraf":"^4.4.0","prettier":"~3.0.3","copyfiles":"^2.4.1","cross-env":"^7.0.3","typescript":"~5.1.6","@types/chai":"^4.0.0","@types/mocha":"^9.1.1","@types/events":"^3.0.0","mocha-multi-reporters":"^1.5.1","@fluid-tools/build-cli":"^0.28.0","eslint-config-prettier":"~9.0.0","@microsoft/api-extractor":"^7.38.3","eslint-plugin-chai-expect":"~3.0.0","mocha-json-output-reporter":"^2.0.1","@fluidframework/build-tools":"^0.28.0","@fluidframework/build-common":"^2.0.3","@fluidframework/mocha-test-setup":">=2.0.0-internal.8.0.1 <2.0.0-internal.8.1.0","@fluidframework/driver-definitions":">=2.0.0-internal.8.0.1 <2.0.0-internal.8.1.0","@fluidframework/test-runtime-utils":">=2.0.0-internal.8.0.1 <2.0.0-internal.8.1.0","@fluidframework/eslint-config-fluid":"^3.1.0","@fluid-experimental/devtools-core-previous":"npm:@fluid-experimental/devtools-core@2.0.0-internal.7.2.0"},"_npmOperationalInternal":{"tmp":"tmp/devtools-core_2.0.0-internal.8.0.1_1704477431395_0.7363188200935549","host":"s3://npm-registry-packages"}},"2.0.0-internal.8.0.2":{"name":"@fluid-experimental/devtools-core","version":"2.0.0-internal.8.0.2","author":{"name":"Microsoft and contributors"},"license":"MIT","_id":"@fluid-experimental/devtools-core@2.0.0-internal.8.0.2","maintainers":[{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},{"name":"curtisman","email":"curtism@microsoft.com"}],"homepage":"https://fluidframework.com","bugs":{"url":"https://github.com/microsoft/FluidFramework/issues"},"c8":{"all":true,"exclude":["src/test/**/*.ts","dist/test/**/*.js"],"include":["src/**/*.ts","dist/**/*.js"],"reporter":["cobertura","html","text"],"cache-dir":"nyc/.cache","report-dir":"nyc/report","temp-directory":"nyc/.nyc_output","exclude-after-remap":false},"dist":{"shasum":"58a900780524cf51eb9eefcebc354d5ed53afb5f","tarball":"https://registry.npmjs.org/@fluid-experimental/devtools-core/-/devtools-core-2.0.0-internal.8.0.2.tgz","fileCount":510,"integrity":"sha512-2mnnVed0nJqdeah16STuWHPgepLNWdk5fjEvccPDnJBSYr0Fqh501R5VU8F5RsgmdraVz6JmALQ2V8negYPtyw==","signatures":[{"sig":"MEUCIEds0NzBc94Kr6XhPApXvO6Uf0ngZgthOAnZkVU8IFjwAiEAxh2HAPLfHC49FMX3Zp4YanDkmKqTg7J8CS863F6sAec=","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}],"unpackedSize":1629472},"main":"dist/index.js","_from":"file:fluid-experimental-devtools-core-2.0.0-internal.8.0.2.tgz","types":"dist/index.d.ts","module":"lib/index.js","readme":"# @fluid-experimental/devtools-core\n\nThis library contains developer tools for use alongside the Fluid Framework.\nIt is used to power our associated [browser extension][browser-extension].\n\n- Chrome: \n- Edge: \n\n\n\n**IMPORTANT: This package is experimental.**\n**Its APIs may change without notice.**\n\n**Do not use in production scenarios.**\n\n\n\n\n\n\n\n\n## Installation\n\nTo get started, install the package by running the following command:\n\n```bash\nnpm i @fluid-experimental/devtools-core -D\n```\n\n\n\n\n\n## Usage\n\nThe Devtools' API surface is designed to fit nicely into most application flows.\n\n### Initialization\n\nTo initialize a devtools session for your container, call [`initializeDevtools`][initialize-devtools-docs].\nThis function accepts a `DevtoolsLogger` for receiving Fluid telemetry from your application, a list of initial Fluid\n`Containers` to associate with the session, and (optionally) customized data visualization configurations for visualizing\n`Container` data.\n\n#### About the [`DevtoolsLogger`][devtools-logger-docs]\n\nThe `DevtoolsLogger` is an optional piece when calling `initializeDevtools` but it is strongly recommended that you use\nit because several features in Fluid Devtools are powered by the telemetry that Fluid Framework generates, and this\nlogger is the way in which that telemetry gets into Fluid Devtools.\n\nYou can obtain a `DevtoolsLogger` by calling its constructor, and then should pass it to `initializeDevtools` _and_\nto the `Loader` instance you'll use to create/load Containers as shown below.\nThis way the logger will receive all the telemetry generated by Fluid Framework in your application, and forward it to\nFluid Devtools as necessary.\n\n```typescript\nimport { DevtoolsLogger, initializeDevtools } from \"@fluid-experimental/devtools-core\";\n\n// Instantiate the logger\nconst devtoolsLogger = new DevtoolsLogger();\n\n// Pass the logger when instantiating the Loader\nconst loader = new Loader({\n\tlogger: devtoolsLogger,\n\t// Other necessary properties ...\n});\n\n// Use the Loader to create (and optionally, attach) a Container\nconst container = await loader.createDetachedContainer(/* params */);\nawait container.attach(/* params */);\n\n// Initialize the Devtools passing the logger and your Container.\n// The Container could be added later as well with devtools.registerContainerDevtools().\nconst devtools = initializeDevtools({\n\tlogger: devtoolsLogger,\n\tinitialContainers: [\n\t\t{\n\t\t\tcontainer,\n\t\t\tcontainerKey: \"My Container\",\n\t\t},\n\t],\n});\n```\n\nIf you're working with `AzureClient` instead of lower-level APIs like the one described above, you probably want to\nrefer to the [@fluid-experimental/devtools package][devtools-package] instead of this one.\n\nDuring local development the recommendation is that your application should receive the `DevtoolsLogger` instance _instead_\nof any logger it would normally receive when deployed to a real environment, to avoid local development activity from\nmixing with real telemetry.\nIf you still want to provide a real application logger and use the Fluid Devtools features that are powered by telemetry\nat the same time, you can pass an existing logger to the `DevtoolsLogger` constructor and it will forward all telemetry\nit receives to that logger as well:\n\n```typescript\nimport { DevtoolsLogger } from \"@fluid-experimental/devtools-core\";\n\n// Your application's logger\nconst yourApplicationLogger = getInstanceOfYourApplicationLogger();\n\nconst devtoolsLogger = new DevtoolsLogger(yourApplicationLogger);\n\n// Pass devtoolsLogger to initializeDevtools() and to your application as described above\n```\n\n### Clean-up\n\nThe Devtools object is managed as a global singleton.\nThat singleton is automatically cleaned up prior to the Window's \"unload\" event.\nSo typical application flows likely won't need to worry about cleanup.\nThat said, if you wish to have tighter control over when the Devtools are torn down, you can simply call the `dispose` method on the handle returned by [initialization](#initialization).\n\n## Contributing to the package\n\n### Build\n\nTo build the package locally, first ensure you have run `pnpm install` from the root of the mono-repo.\nNext, to build the code, run `npm run build` from the root of the mono-repo, or use [fluid-build](https://github.com/microsoft/FluidFramework/tree/main/build-tools/packages/build-tools#running-fluid-build-command-line) via `fluid-build -t build`.\n\n- Note: Once you have run a build from the root, assuming no other changes outside of this package, you may run `npm run build` directly within this directory for a faster build.\n If you make changes to any of this package's local dependencies, you will need to run a build again from the root before building again from directly within this package.\n\n### Test\n\nTo run the tests, first ensure you have followed the [build](#build) steps above.\nNext, run `npm run test` from a terminal within this directory.\n\n\n\n\n\n\n\n## API Documentation\n\nAPI documentation for **@fluid-experimental/devtools-core** is available at .\n\n\n\n\n\n\n\n\n\n\n## Contribution Guidelines\n\nThere are many ways to [contribute](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md) to Fluid.\n\n- Participate in Q&A in our [GitHub Discussions](https://github.com/microsoft/FluidFramework/discussions).\n- [Submit bugs](https://github.com/microsoft/FluidFramework/issues) and help us verify fixes as they are checked in.\n- Review the [source code changes](https://github.com/microsoft/FluidFramework/pulls).\n- [Contribute bug fixes](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md).\n\nDetailed instructions for working in the repo can be found in the [Wiki](https://github.com/microsoft/FluidFramework/wiki).\n\nThis project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).\nFor more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\nUse of these trademarks or logos must follow Microsoft’s [Trademark & Brand Guidelines](https://www.microsoft.com/trademarks).\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n\n\n\n## Help\n\nNot finding what you're looking for in this README? Check out our [GitHub\nWiki](https://github.com/microsoft/FluidFramework/wiki) or [fluidframework.com](https://fluidframework.com/docs/).\n\nStill not finding what you're looking for? Please [file an\nissue](https://github.com/microsoft/FluidFramework/wiki/Submitting-Bugs-and-Feature-Requests).\n\nThank you!\n\n\n\n\n\n\n\n\n\n\n## Trademark\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\n\nUse of these trademarks or logos must follow Microsoft's [Trademark & Brand Guidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general).\n\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n[initialize-devtools-docs]: https://fluidframework.com/docs/apis/devtools-core#initializedevtools-function\n[devtools-logger-docs]: https://fluidframework.com/docs/apis/devtools-core/devtoolslogger-class\n[devtools-package]: https://www.npmjs.com/package/@fluid-experimental/devtools\n[browser-extension]: https://github.com/microsoft/FluidFramework/tree/main/packages/tools/devtools/devtools-browser-extension\n","scripts":{"api":"fluid-build . --task api","tsc":"tsc","lint":"npm run prettier && npm run check:release-tags && npm run eslint","test":"npm run test:mocha","build":"fluid-build . --task build","clean":"rimraf --glob _api-extractor-temp nyc dist lib \"**/*.tsbuildinfo\" \"**/*.build.log\"","eslint":"eslint src","format":"npm run prettier:fix","rebuild":"npm run clean && npm run build","lint:fix":"npm run prettier:fix && npm run eslint:fix","prettier":"prettier --check . --cache --ignore-path ../../../../.prettierignore","tsc:watch":"tsc --watch","build:docs":"fluid-build . --task api","eslint:fix":"eslint src --fix","test:mocha":"mocha \"dist/**/*.test.js\" --exit","build:esnext":"tsc --project ./tsconfig.esnext.json","build:genver":"gen-version","prettier:fix":"prettier --write . --cache --ignore-path ../../../../.prettierignore","build:compile":"fluid-build . --task compile","ci:build:docs":"api-extractor run","test:coverage":"c8 npm test","typetests:gen":"fluid-type-test-generator","build:commonjs":"fluid-build . --task commonjs","format-and-build":"npm run format && npm run build","typetests:prepare":"flub typetests --dir . --reset --previous --normalize","check:release-tags":"api-extractor run --local --config ./api-extractor-lint.json","format-and-compile":"npm run format && npm run build:compile","api-extractor:esnext":"copyfiles -u 1 \"dist/**/*-@(alpha|beta|public|untrimmed).d.ts\" lib","api-extractor:commonjs":"api-extractor run --local"},"_npmUser":{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},"_resolved":"/mnt/vss/_work/1/pack/scoped/fluid-experimental-devtools-core-2.0.0-internal.8.0.2.tgz","_integrity":"sha512-2mnnVed0nJqdeah16STuWHPgepLNWdk5fjEvccPDnJBSYr0Fqh501R5VU8F5RsgmdraVz6JmALQ2V8negYPtyw==","fluidBuild":{"tasks":{"tsc":["...","typetests:gen"],"build:docs":{"script":false,"dependsOn":["...","api-extractor:commonjs","api-extractor:esnext"]}}},"repository":{"url":"git+https://github.com/microsoft/FluidFramework.git","type":"git","directory":"packages/tools/devtools/devtools-core"},"_npmVersion":"9.6.7","description":"Fluid Framework developer tools core functionality","directories":{},"sideEffects":false,"_nodeVersion":"18.17.1","dependencies":{"@fluidframework/map":">=2.0.0-internal.8.0.2 <2.0.0-internal.8.1.0","@fluidframework/cell":">=2.0.0-internal.8.0.2 <2.0.0-internal.8.1.0","@fluidframework/matrix":">=2.0.0-internal.8.0.2 <2.0.0-internal.8.1.0","@fluidframework/counter":">=2.0.0-internal.8.0.2 <2.0.0-internal.8.1.0","@fluidframework/sequence":">=2.0.0-internal.8.0.2 <2.0.0-internal.8.1.0","@fluid-experimental/tree2":">=2.0.0-internal.8.0.2 <2.0.0-internal.8.1.0","@fluid-internal/client-utils":">=2.0.0-internal.8.0.2 <2.0.0-internal.8.1.0","@fluidframework/core-interfaces":">=2.0.0-internal.8.0.2 <2.0.0-internal.8.1.0","@fluidframework/telemetry-utils":">=2.0.0-internal.8.0.2 <2.0.0-internal.8.1.0","@fluidframework/container-loader":">=2.0.0-internal.8.0.2 <2.0.0-internal.8.1.0","@fluidframework/shared-object-base":">=2.0.0-internal.8.0.2 <2.0.0-internal.8.1.0","@fluidframework/protocol-definitions":"^3.0.0","@fluidframework/container-definitions":">=2.0.0-internal.8.0.2 <2.0.0-internal.8.1.0","@fluidframework/datastore-definitions":">=2.0.0-internal.8.0.2 <2.0.0-internal.8.1.0"},"_hasShrinkwrap":false,"readmeFilename":"README.md","typeValidation":{"broken":{"TypeAliasDeclaration_Primitive":{"forwardCompat":false},"TypeAliasDeclaration_VisualNode":{"forwardCompat":false},"InterfaceDeclaration_TreeNodeBase":{"forwardCompat":false},"InterfaceDeclaration_ValueNodeBase":{"forwardCompat":false},"InterfaceDeclaration_VisualNodeBase":{"forwardCompat":false},"InterfaceDeclaration_VisualTreeNode":{"forwardCompat":false},"TypeAliasDeclaration_RootHandleNode":{"forwardCompat":false},"InterfaceDeclaration_FluidHandleNode":{"forwardCompat":false},"InterfaceDeclaration_VisualValueNode":{"forwardCompat":false},"TypeAliasDeclaration_VisualChildNode":{"forwardCompat":false},"InterfaceDeclaration_UnknownObjectNode":{"forwardCompat":false},"InterfaceDeclaration_FluidDevtoolsProps":{"backCompat":false},"InterfaceDeclaration_FluidObjectNodeBase":{"forwardCompat":false},"InterfaceDeclaration_ContainerDevtoolsProps":{"backCompat":false}}},"devDependencies":{"c8":"^7.7.1","chai":"^4.2.0","mocha":"^10.2.0","eslint":"~8.50.0","events":"^3.1.0","moment":"^2.21.0","rimraf":"^4.4.0","prettier":"~3.0.3","copyfiles":"^2.4.1","cross-env":"^7.0.3","typescript":"~5.1.6","@types/chai":"^4.0.0","@types/mocha":"^9.1.1","@types/events":"^3.0.0","mocha-multi-reporters":"^1.5.1","@fluid-tools/build-cli":"^0.28.0","eslint-config-prettier":"~9.0.0","@microsoft/api-extractor":"^7.38.3","eslint-plugin-chai-expect":"~3.0.0","mocha-json-output-reporter":"^2.0.1","@fluidframework/build-tools":"^0.28.0","@fluidframework/build-common":"^2.0.3","@fluidframework/mocha-test-setup":">=2.0.0-internal.8.0.2 <2.0.0-internal.8.1.0","@fluidframework/driver-definitions":">=2.0.0-internal.8.0.2 <2.0.0-internal.8.1.0","@fluidframework/test-runtime-utils":">=2.0.0-internal.8.0.2 <2.0.0-internal.8.1.0","@fluidframework/eslint-config-fluid":"^3.1.0","@fluid-experimental/devtools-core-previous":"npm:@fluid-experimental/devtools-core@2.0.0-internal.7.2.0"},"_npmOperationalInternal":{"tmp":"tmp/devtools-core_2.0.0-internal.8.0.2_1704925868737_0.39082360585151665","host":"s3://npm-registry-packages"}},"2.0.0-internal.7.4.1":{"name":"@fluid-experimental/devtools-core","version":"2.0.0-internal.7.4.1","author":{"name":"Microsoft and contributors"},"license":"MIT","_id":"@fluid-experimental/devtools-core@2.0.0-internal.7.4.1","maintainers":[{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},{"name":"curtisman","email":"curtism@microsoft.com"}],"homepage":"https://fluidframework.com","bugs":{"url":"https://github.com/microsoft/FluidFramework/issues"},"c8":{"all":true,"exclude":["src/test/**/*.ts","dist/test/**/*.js"],"include":["src/**/*.ts","dist/**/*.js"],"reporter":["cobertura","html","text"],"cache-dir":"nyc/.cache","report-dir":"nyc/report","temp-directory":"nyc/.nyc_output","exclude-after-remap":false},"dist":{"shasum":"eb204f5210c89da7968dadbe28f3baa55e0ae62a","tarball":"https://registry.npmjs.org/@fluid-experimental/devtools-core/-/devtools-core-2.0.0-internal.7.4.1.tgz","fileCount":510,"integrity":"sha512-UQzjAzJlajiZLVoQ+LQh3wXQCVcjJp6luZJJNJHNT2GySLvCONzrd/+jrGCypm+aWfonmuOQXbPsflMK/rC/JQ==","signatures":[{"sig":"MEUCIEvE/uSHFQ1R2tMjzFQngV0906xSQGF6wXeAlchuSNM2AiEAzM9uAdf3kLCcd8FoPjdv9iw4MRNRF+cI1pSkkObCQfU=","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}],"unpackedSize":1625178},"main":"dist/index.js","_from":"file:fluid-experimental-devtools-core-2.0.0-internal.7.4.1.tgz","types":"dist/index.d.ts","module":"lib/index.js","readme":"# @fluid-experimental/devtools-core\n\nThis library contains developer tools for use alongside the Fluid Framework.\nIt is used to power our associated [browser extension][browser-extension].\n\n- Chrome: \n- Edge: \n\n\n\n**IMPORTANT: This package is experimental.**\n**Its APIs may change without notice.**\n\n**Do not use in production scenarios.**\n\n\n\n\n\n\n\n\n## Installation\n\nTo get started, install the package by running the following command:\n\n```bash\nnpm i @fluid-experimental/devtools-core -D\n```\n\n\n\n\n\n## Usage\n\nThe Devtools' API surface is designed to fit nicely into most application flows.\n\n### Initialization\n\nTo initialize a devtools session for your container, call [`initializeDevtools`][initialize-devtools-docs].\nThis function accepts a `DevtoolsLogger` for receiving Fluid telemetry from your application, a list of initial Fluid\n`Containers` to associate with the session, and (optionally) customized data visualization configurations for visualizing\n`Container` data.\n\n#### About the [`DevtoolsLogger`][devtools-logger-docs]\n\nThe `DevtoolsLogger` is an optional piece when calling `initializeDevtools` but it is strongly recommended that you use\nit because several features in Fluid Devtools are powered by the telemetry that Fluid Framework generates, and this\nlogger is the way in which that telemetry gets into Fluid Devtools.\n\nYou can obtain a `DevtoolsLogger` by calling its constructor, and then should pass it to `initializeDevtools` _and_\nto the `Loader` instance you'll use to create/load Containers as shown below.\nThis way the logger will receive all the telemetry generated by Fluid Framework in your application, and forward it to\nFluid Devtools as necessary.\n\n```typescript\nimport { DevtoolsLogger, initializeDevtools } from \"@fluid-experimental/devtools-core\";\n\n// Instantiate the logger\nconst devtoolsLogger = new DevtoolsLogger();\n\n// Pass the logger when instantiating the Loader\nconst loader = new Loader({\n\tlogger: devtoolsLogger,\n\t// Other necessary properties ...\n});\n\n// Use the Loader to create (and optionally, attach) a Container\nconst container = await loader.createDetachedContainer(/* params */);\nawait container.attach(/* params */);\n\n// Initialize the Devtools passing the logger and your Container.\n// The Container could be added later as well with devtools.registerContainerDevtools().\nconst devtools = initializeDevtools({\n\tlogger: devtoolsLogger,\n\tinitialContainers: [\n\t\t{\n\t\t\tcontainer,\n\t\t\tcontainerKey: \"My Container\",\n\t\t},\n\t],\n});\n```\n\nIf you're working with `AzureClient` instead of lower-level APIs like the one described above, you probably want to\nrefer to the [@fluid-experimental/devtools package][devtools-package] instead of this one.\n\nDuring local development the recommendation is that your application should receive the `DevtoolsLogger` instance _instead_\nof any logger it would normally receive when deployed to a real environment, to avoid local development activity from\nmixing with real telemetry.\nIf you still want to provide a real application logger and use the Fluid Devtools features that are powered by telemetry\nat the same time, you can pass an existing logger to the `DevtoolsLogger` constructor and it will forward all telemetry\nit receives to that logger as well:\n\n```typescript\nimport { DevtoolsLogger } from \"@fluid-experimental/devtools-core\";\n\n// Your application's logger\nconst yourApplicationLogger = getInstanceOfYourApplicationLogger();\n\nconst devtoolsLogger = new DevtoolsLogger(yourApplicationLogger);\n\n// Pass devtoolsLogger to initializeDevtools() and to your application as described above\n```\n\n### Clean-up\n\nThe Devtools object is managed as a global singleton.\nThat singleton is automatically cleaned up prior to the Window's \"unload\" event.\nSo typical application flows likely won't need to worry about cleanup.\nThat said, if you wish to have tighter control over when the Devtools are torn down, you can simply call the `dispose` method on the handle returned by [initialization](#initialization).\n\n## Contributing to the package\n\n### Build\n\nTo build the package locally, first ensure you have run `pnpm install` from the root of the mono-repo.\nNext, to build the code, run `npm run build` from the root of the mono-repo, or use [fluid-build](https://github.com/microsoft/FluidFramework/tree/main/build-tools/packages/build-tools#running-fluid-build-command-line) via `fluid-build -t build`.\n\n- Note: Once you have run a build from the root, assuming no other changes outside of this package, you may run `npm run build` directly within this directory for a faster build.\n If you make changes to any of this package's local dependencies, you will need to run a build again from the root before building again from directly within this package.\n\n### Test\n\nTo run the tests, first ensure you have followed the [build](#build) steps above.\nNext, run `npm run test` from a terminal within this directory.\n\n\n\n\n\n\n\n## API Documentation\n\nAPI documentation for **@fluid-experimental/devtools-core** is available at .\n\n\n\n\n\n\n\n\n\n\n## Contribution Guidelines\n\nThere are many ways to [contribute](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md) to Fluid.\n\n- Participate in Q&A in our [GitHub Discussions](https://github.com/microsoft/FluidFramework/discussions).\n- [Submit bugs](https://github.com/microsoft/FluidFramework/issues) and help us verify fixes as they are checked in.\n- Review the [source code changes](https://github.com/microsoft/FluidFramework/pulls).\n- [Contribute bug fixes](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md).\n\nDetailed instructions for working in the repo can be found in the [Wiki](https://github.com/microsoft/FluidFramework/wiki).\n\nThis project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).\nFor more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\nUse of these trademarks or logos must follow Microsoft’s [Trademark & Brand Guidelines](https://www.microsoft.com/trademarks).\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n\n\n\n## Help\n\nNot finding what you're looking for in this README? Check out our [GitHub\nWiki](https://github.com/microsoft/FluidFramework/wiki) or [fluidframework.com](https://fluidframework.com/docs/).\n\nStill not finding what you're looking for? Please [file an\nissue](https://github.com/microsoft/FluidFramework/wiki/Submitting-Bugs-and-Feature-Requests).\n\nThank you!\n\n\n\n\n\n\n\n\n\n\n## Trademark\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\n\nUse of these trademarks or logos must follow Microsoft's [Trademark & Brand Guidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general).\n\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n[initialize-devtools-docs]: https://fluidframework.com/docs/apis/devtools-core#initializedevtools-function\n[devtools-logger-docs]: https://fluidframework.com/docs/apis/devtools-core/devtoolslogger-class\n[devtools-package]: https://www.npmjs.com/package/@fluid-experimental/devtools\n[browser-extension]: https://github.com/microsoft/FluidFramework/tree/main/packages/tools/devtools/devtools-browser-extension\n","scripts":{"api":"fluid-build . --task api","tsc":"tsc","lint":"npm run prettier && npm run check:release-tags && npm run eslint","test":"npm run test:mocha","build":"fluid-build . --task build","clean":"rimraf --glob _api-extractor-temp nyc dist lib \"**/*.tsbuildinfo\" \"**/*.build.log\"","eslint":"eslint src","format":"npm run prettier:fix","rebuild":"npm run clean && npm run build","lint:fix":"npm run prettier:fix && npm run eslint:fix","prettier":"prettier --check . --cache --ignore-path ../../../../.prettierignore","tsc:watch":"tsc --watch","build:docs":"fluid-build . --task api","eslint:fix":"eslint src --fix","test:mocha":"mocha \"dist/**/*.test.js\" --exit","build:esnext":"tsc --project ./tsconfig.esnext.json","build:genver":"gen-version","prettier:fix":"prettier --write . --cache --ignore-path ../../../../.prettierignore","build:compile":"fluid-build . --task compile","ci:build:docs":"api-extractor run","test:coverage":"c8 npm test","typetests:gen":"fluid-type-test-generator","build:commonjs":"fluid-build . --task commonjs","format-and-build":"npm run format && npm run build","typetests:prepare":"flub typetests --dir . --reset --previous --normalize","check:release-tags":"api-extractor run --local --config ./api-extractor-lint.json","format-and-compile":"npm run format && npm run build:compile","api-extractor:esnext":"copyfiles -u 1 \"dist/**/*-@(alpha|beta|public|untrimmed).d.ts\" lib","api-extractor:commonjs":"api-extractor run --local"},"_npmUser":{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},"_resolved":"/mnt/vss/_work/1/pack/scoped/fluid-experimental-devtools-core-2.0.0-internal.7.4.1.tgz","_integrity":"sha512-UQzjAzJlajiZLVoQ+LQh3wXQCVcjJp6luZJJNJHNT2GySLvCONzrd/+jrGCypm+aWfonmuOQXbPsflMK/rC/JQ==","fluidBuild":{"tasks":{"tsc":["...","typetests:gen"],"build:docs":{"script":false,"dependsOn":["...","api-extractor:commonjs","api-extractor:esnext"]}}},"repository":{"url":"git+https://github.com/microsoft/FluidFramework.git","type":"git","directory":"packages/tools/devtools/devtools-core"},"_npmVersion":"9.6.7","description":"Fluid Framework developer tools core functionality","directories":{},"sideEffects":false,"_nodeVersion":"18.17.1","dependencies":{"@fluidframework/map":">=2.0.0-internal.7.4.1 <2.0.0-internal.7.5.0","@fluidframework/cell":">=2.0.0-internal.7.4.1 <2.0.0-internal.7.5.0","@fluidframework/matrix":">=2.0.0-internal.7.4.1 <2.0.0-internal.7.5.0","@fluidframework/counter":">=2.0.0-internal.7.4.1 <2.0.0-internal.7.5.0","@fluidframework/sequence":">=2.0.0-internal.7.4.1 <2.0.0-internal.7.5.0","@fluid-experimental/tree2":">=2.0.0-internal.7.4.1 <2.0.0-internal.7.5.0","@fluid-internal/client-utils":">=2.0.0-internal.7.4.1 <2.0.0-internal.7.5.0","@fluidframework/core-interfaces":">=2.0.0-internal.7.4.1 <2.0.0-internal.7.5.0","@fluidframework/telemetry-utils":">=2.0.0-internal.7.4.1 <2.0.0-internal.7.5.0","@fluidframework/container-loader":">=2.0.0-internal.7.4.1 <2.0.0-internal.7.5.0","@fluidframework/shared-object-base":">=2.0.0-internal.7.4.1 <2.0.0-internal.7.5.0","@fluidframework/protocol-definitions":"^3.0.0","@fluidframework/container-definitions":">=2.0.0-internal.7.4.1 <2.0.0-internal.7.5.0","@fluidframework/datastore-definitions":">=2.0.0-internal.7.4.1 <2.0.0-internal.7.5.0"},"_hasShrinkwrap":false,"readmeFilename":"README.md","typeValidation":{"broken":{}},"devDependencies":{"c8":"^7.7.1","chai":"^4.2.0","mocha":"^10.2.0","eslint":"~8.50.0","events":"^3.1.0","moment":"^2.21.0","rimraf":"^4.4.0","prettier":"~3.0.3","copyfiles":"^2.4.1","cross-env":"^7.0.3","typescript":"~5.1.6","@types/chai":"^4.0.0","@types/mocha":"^9.1.1","@types/events":"^3.0.0","mocha-multi-reporters":"^1.5.1","@fluid-tools/build-cli":"^0.28.0","eslint-config-prettier":"~9.0.0","@microsoft/api-extractor":"^7.38.3","eslint-plugin-chai-expect":"~3.0.0","mocha-json-output-reporter":"^2.0.1","@fluidframework/build-tools":"^0.28.0","@fluidframework/build-common":"^2.0.3","@fluidframework/mocha-test-setup":">=2.0.0-internal.7.4.1 <2.0.0-internal.7.5.0","@fluidframework/driver-definitions":">=2.0.0-internal.7.4.1 <2.0.0-internal.7.5.0","@fluidframework/test-runtime-utils":">=2.0.0-internal.7.4.1 <2.0.0-internal.7.5.0","@fluidframework/eslint-config-fluid":"^3.1.0","@fluid-experimental/devtools-core-previous":"npm:@fluid-experimental/devtools-core@2.0.0-internal.7.2.0"},"_npmOperationalInternal":{"tmp":"tmp/devtools-core_2.0.0-internal.7.4.1_1704930604028_0.41745502028889514","host":"s3://npm-registry-packages"}},"2.0.0-internal.7.4.2":{"name":"@fluid-experimental/devtools-core","version":"2.0.0-internal.7.4.2","author":{"name":"Microsoft and contributors"},"license":"MIT","_id":"@fluid-experimental/devtools-core@2.0.0-internal.7.4.2","maintainers":[{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},{"name":"curtisman","email":"curtism@microsoft.com"}],"homepage":"https://fluidframework.com","bugs":{"url":"https://github.com/microsoft/FluidFramework/issues"},"c8":{"all":true,"exclude":["src/test/**/*.ts","dist/test/**/*.js"],"include":["src/**/*.ts","dist/**/*.js"],"reporter":["cobertura","html","text"],"cache-dir":"nyc/.cache","report-dir":"nyc/report","temp-directory":"nyc/.nyc_output","exclude-after-remap":false},"dist":{"shasum":"250c31216ec3a7388025c4d491364263eb14c587","tarball":"https://registry.npmjs.org/@fluid-experimental/devtools-core/-/devtools-core-2.0.0-internal.7.4.2.tgz","fileCount":510,"integrity":"sha512-oxqkpW4/23wIVe4f4gh8NFeZohZFT8T3pjzk3J6cJzZpiCelqXIeaHOwJD4hfaILhowN3GEJUVIfz+VT3rYHSg==","signatures":[{"sig":"MEUCIQCmhl7MVczf6UzjZtsQjeU8oNx+DZz63bM2CThDbBYEXQIgMV0vdGWXl3ttad6FfNT4z2pJoS0Tcr8hoQUEKq4aAC0=","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}],"unpackedSize":1625178},"main":"dist/index.js","_from":"file:fluid-experimental-devtools-core-2.0.0-internal.7.4.2.tgz","types":"dist/index.d.ts","module":"lib/index.js","readme":"# @fluid-experimental/devtools-core\n\nThis library contains developer tools for use alongside the Fluid Framework.\nIt is used to power our associated [browser extension][browser-extension].\n\n- Chrome: \n- Edge: \n\n\n\n**IMPORTANT: This package is experimental.**\n**Its APIs may change without notice.**\n\n**Do not use in production scenarios.**\n\n\n\n\n\n\n\n\n## Installation\n\nTo get started, install the package by running the following command:\n\n```bash\nnpm i @fluid-experimental/devtools-core -D\n```\n\n\n\n\n\n## Usage\n\nThe Devtools' API surface is designed to fit nicely into most application flows.\n\n### Initialization\n\nTo initialize a devtools session for your container, call [`initializeDevtools`][initialize-devtools-docs].\nThis function accepts a `DevtoolsLogger` for receiving Fluid telemetry from your application, a list of initial Fluid\n`Containers` to associate with the session, and (optionally) customized data visualization configurations for visualizing\n`Container` data.\n\n#### About the [`DevtoolsLogger`][devtools-logger-docs]\n\nThe `DevtoolsLogger` is an optional piece when calling `initializeDevtools` but it is strongly recommended that you use\nit because several features in Fluid Devtools are powered by the telemetry that Fluid Framework generates, and this\nlogger is the way in which that telemetry gets into Fluid Devtools.\n\nYou can obtain a `DevtoolsLogger` by calling its constructor, and then should pass it to `initializeDevtools` _and_\nto the `Loader` instance you'll use to create/load Containers as shown below.\nThis way the logger will receive all the telemetry generated by Fluid Framework in your application, and forward it to\nFluid Devtools as necessary.\n\n```typescript\nimport { DevtoolsLogger, initializeDevtools } from \"@fluid-experimental/devtools-core\";\n\n// Instantiate the logger\nconst devtoolsLogger = new DevtoolsLogger();\n\n// Pass the logger when instantiating the Loader\nconst loader = new Loader({\n\tlogger: devtoolsLogger,\n\t// Other necessary properties ...\n});\n\n// Use the Loader to create (and optionally, attach) a Container\nconst container = await loader.createDetachedContainer(/* params */);\nawait container.attach(/* params */);\n\n// Initialize the Devtools passing the logger and your Container.\n// The Container could be added later as well with devtools.registerContainerDevtools().\nconst devtools = initializeDevtools({\n\tlogger: devtoolsLogger,\n\tinitialContainers: [\n\t\t{\n\t\t\tcontainer,\n\t\t\tcontainerKey: \"My Container\",\n\t\t},\n\t],\n});\n```\n\nIf you're working with `AzureClient` instead of lower-level APIs like the one described above, you probably want to\nrefer to the [@fluid-experimental/devtools package][devtools-package] instead of this one.\n\nDuring local development the recommendation is that your application should receive the `DevtoolsLogger` instance _instead_\nof any logger it would normally receive when deployed to a real environment, to avoid local development activity from\nmixing with real telemetry.\nIf you still want to provide a real application logger and use the Fluid Devtools features that are powered by telemetry\nat the same time, you can pass an existing logger to the `DevtoolsLogger` constructor and it will forward all telemetry\nit receives to that logger as well:\n\n```typescript\nimport { DevtoolsLogger } from \"@fluid-experimental/devtools-core\";\n\n// Your application's logger\nconst yourApplicationLogger = getInstanceOfYourApplicationLogger();\n\nconst devtoolsLogger = new DevtoolsLogger(yourApplicationLogger);\n\n// Pass devtoolsLogger to initializeDevtools() and to your application as described above\n```\n\n### Clean-up\n\nThe Devtools object is managed as a global singleton.\nThat singleton is automatically cleaned up prior to the Window's \"unload\" event.\nSo typical application flows likely won't need to worry about cleanup.\nThat said, if you wish to have tighter control over when the Devtools are torn down, you can simply call the `dispose` method on the handle returned by [initialization](#initialization).\n\n## Contributing to the package\n\n### Build\n\nTo build the package locally, first ensure you have run `pnpm install` from the root of the mono-repo.\nNext, to build the code, run `npm run build` from the root of the mono-repo, or use [fluid-build](https://github.com/microsoft/FluidFramework/tree/main/build-tools/packages/build-tools#running-fluid-build-command-line) via `fluid-build -t build`.\n\n- Note: Once you have run a build from the root, assuming no other changes outside of this package, you may run `npm run build` directly within this directory for a faster build.\n If you make changes to any of this package's local dependencies, you will need to run a build again from the root before building again from directly within this package.\n\n### Test\n\nTo run the tests, first ensure you have followed the [build](#build) steps above.\nNext, run `npm run test` from a terminal within this directory.\n\n\n\n\n\n\n\n## API Documentation\n\nAPI documentation for **@fluid-experimental/devtools-core** is available at .\n\n\n\n\n\n\n\n\n\n\n## Contribution Guidelines\n\nThere are many ways to [contribute](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md) to Fluid.\n\n- Participate in Q&A in our [GitHub Discussions](https://github.com/microsoft/FluidFramework/discussions).\n- [Submit bugs](https://github.com/microsoft/FluidFramework/issues) and help us verify fixes as they are checked in.\n- Review the [source code changes](https://github.com/microsoft/FluidFramework/pulls).\n- [Contribute bug fixes](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md).\n\nDetailed instructions for working in the repo can be found in the [Wiki](https://github.com/microsoft/FluidFramework/wiki).\n\nThis project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).\nFor more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\nUse of these trademarks or logos must follow Microsoft’s [Trademark & Brand Guidelines](https://www.microsoft.com/trademarks).\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n\n\n\n## Help\n\nNot finding what you're looking for in this README? Check out our [GitHub\nWiki](https://github.com/microsoft/FluidFramework/wiki) or [fluidframework.com](https://fluidframework.com/docs/).\n\nStill not finding what you're looking for? Please [file an\nissue](https://github.com/microsoft/FluidFramework/wiki/Submitting-Bugs-and-Feature-Requests).\n\nThank you!\n\n\n\n\n\n\n\n\n\n\n## Trademark\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\n\nUse of these trademarks or logos must follow Microsoft's [Trademark & Brand Guidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general).\n\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n[initialize-devtools-docs]: https://fluidframework.com/docs/apis/devtools-core#initializedevtools-function\n[devtools-logger-docs]: https://fluidframework.com/docs/apis/devtools-core/devtoolslogger-class\n[devtools-package]: https://www.npmjs.com/package/@fluid-experimental/devtools\n[browser-extension]: https://github.com/microsoft/FluidFramework/tree/main/packages/tools/devtools/devtools-browser-extension\n","scripts":{"api":"fluid-build . --task api","tsc":"tsc","lint":"npm run prettier && npm run check:release-tags && npm run eslint","test":"npm run test:mocha","build":"fluid-build . --task build","clean":"rimraf --glob _api-extractor-temp nyc dist lib \"**/*.tsbuildinfo\" \"**/*.build.log\"","eslint":"eslint src","format":"npm run prettier:fix","rebuild":"npm run clean && npm run build","lint:fix":"npm run prettier:fix && npm run eslint:fix","prettier":"prettier --check . --cache --ignore-path ../../../../.prettierignore","tsc:watch":"tsc --watch","build:docs":"fluid-build . --task api","eslint:fix":"eslint src --fix","test:mocha":"mocha \"dist/**/*.test.js\" --exit","build:esnext":"tsc --project ./tsconfig.esnext.json","build:genver":"gen-version","prettier:fix":"prettier --write . --cache --ignore-path ../../../../.prettierignore","build:compile":"fluid-build . --task compile","ci:build:docs":"api-extractor run","test:coverage":"c8 npm test","typetests:gen":"fluid-type-test-generator","build:commonjs":"fluid-build . --task commonjs","format-and-build":"npm run format && npm run build","typetests:prepare":"flub typetests --dir . --reset --previous --normalize","check:release-tags":"api-extractor run --local --config ./api-extractor-lint.json","format-and-compile":"npm run format && npm run build:compile","api-extractor:esnext":"copyfiles -u 1 \"dist/**/*-@(alpha|beta|public|untrimmed).d.ts\" lib","api-extractor:commonjs":"api-extractor run --local"},"_npmUser":{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},"_resolved":"/mnt/vss/_work/1/pack/scoped/fluid-experimental-devtools-core-2.0.0-internal.7.4.2.tgz","_integrity":"sha512-oxqkpW4/23wIVe4f4gh8NFeZohZFT8T3pjzk3J6cJzZpiCelqXIeaHOwJD4hfaILhowN3GEJUVIfz+VT3rYHSg==","fluidBuild":{"tasks":{"tsc":["...","typetests:gen"],"build:docs":{"script":false,"dependsOn":["...","api-extractor:commonjs","api-extractor:esnext"]}}},"repository":{"url":"git+https://github.com/microsoft/FluidFramework.git","type":"git","directory":"packages/tools/devtools/devtools-core"},"_npmVersion":"9.6.7","description":"Fluid Framework developer tools core functionality","directories":{},"sideEffects":false,"_nodeVersion":"18.17.1","dependencies":{"@fluidframework/map":">=2.0.0-internal.7.4.2 <2.0.0-internal.7.5.0","@fluidframework/cell":">=2.0.0-internal.7.4.2 <2.0.0-internal.7.5.0","@fluidframework/matrix":">=2.0.0-internal.7.4.2 <2.0.0-internal.7.5.0","@fluidframework/counter":">=2.0.0-internal.7.4.2 <2.0.0-internal.7.5.0","@fluidframework/sequence":">=2.0.0-internal.7.4.2 <2.0.0-internal.7.5.0","@fluid-experimental/tree2":">=2.0.0-internal.7.4.2 <2.0.0-internal.7.5.0","@fluid-internal/client-utils":">=2.0.0-internal.7.4.2 <2.0.0-internal.7.5.0","@fluidframework/core-interfaces":">=2.0.0-internal.7.4.2 <2.0.0-internal.7.5.0","@fluidframework/telemetry-utils":">=2.0.0-internal.7.4.2 <2.0.0-internal.7.5.0","@fluidframework/container-loader":">=2.0.0-internal.7.4.2 <2.0.0-internal.7.5.0","@fluidframework/shared-object-base":">=2.0.0-internal.7.4.2 <2.0.0-internal.7.5.0","@fluidframework/protocol-definitions":"^3.0.0","@fluidframework/container-definitions":">=2.0.0-internal.7.4.2 <2.0.0-internal.7.5.0","@fluidframework/datastore-definitions":">=2.0.0-internal.7.4.2 <2.0.0-internal.7.5.0"},"_hasShrinkwrap":false,"readmeFilename":"README.md","typeValidation":{"broken":{}},"devDependencies":{"c8":"^7.7.1","chai":"^4.2.0","mocha":"^10.2.0","eslint":"~8.50.0","events":"^3.1.0","moment":"^2.21.0","rimraf":"^4.4.0","prettier":"~3.0.3","copyfiles":"^2.4.1","cross-env":"^7.0.3","typescript":"~5.1.6","@types/chai":"^4.0.0","@types/mocha":"^9.1.1","@types/events":"^3.0.0","mocha-multi-reporters":"^1.5.1","@fluid-tools/build-cli":"^0.28.0","eslint-config-prettier":"~9.0.0","@microsoft/api-extractor":"^7.38.3","eslint-plugin-chai-expect":"~3.0.0","mocha-json-output-reporter":"^2.0.1","@fluidframework/build-tools":"^0.28.0","@fluidframework/build-common":"^2.0.3","@fluidframework/mocha-test-setup":">=2.0.0-internal.7.4.2 <2.0.0-internal.7.5.0","@fluidframework/driver-definitions":">=2.0.0-internal.7.4.2 <2.0.0-internal.7.5.0","@fluidframework/test-runtime-utils":">=2.0.0-internal.7.4.2 <2.0.0-internal.7.5.0","@fluidframework/eslint-config-fluid":"^3.1.0","@fluid-experimental/devtools-core-previous":"npm:@fluid-experimental/devtools-core@2.0.0-internal.7.2.0"},"_npmOperationalInternal":{"tmp":"tmp/devtools-core_2.0.0-internal.7.4.2_1705435116885_0.865912094793247","host":"s3://npm-registry-packages"}},"2.0.0-internal.8.0.3":{"name":"@fluid-experimental/devtools-core","version":"2.0.0-internal.8.0.3","author":{"name":"Microsoft and contributors"},"license":"MIT","_id":"@fluid-experimental/devtools-core@2.0.0-internal.8.0.3","maintainers":[{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},{"name":"curtisman","email":"curtism@microsoft.com"}],"homepage":"https://fluidframework.com","bugs":{"url":"https://github.com/microsoft/FluidFramework/issues"},"c8":{"all":true,"exclude":["src/test/**/*.ts","dist/test/**/*.js"],"include":["src/**/*.ts","dist/**/*.js"],"reporter":["cobertura","html","text"],"cache-dir":"nyc/.cache","report-dir":"nyc/report","temp-directory":"nyc/.nyc_output","exclude-after-remap":false},"dist":{"shasum":"7413d5fe0b55cee94e9a31e081a23086e0d7aac7","tarball":"https://registry.npmjs.org/@fluid-experimental/devtools-core/-/devtools-core-2.0.0-internal.8.0.3.tgz","fileCount":510,"integrity":"sha512-JdmmlxuuSjI7GePbDe50dDcXWIJhqanm4K4dhmphynoBXOsyAxYPUxEs1RF008CDC6oiLQQJkhvKos//w0XFlw==","signatures":[{"sig":"MEUCIQCVB1c8BrypOSVJgIPMJSJHy4k7dp3iZbQgLxOY9MAeWQIgSEDKseTehRmRj58QKqct2tzn4kvND5GTwpqzGyPX49w=","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}],"unpackedSize":1629472},"main":"dist/index.js","_from":"file:fluid-experimental-devtools-core-2.0.0-internal.8.0.3.tgz","types":"dist/index.d.ts","module":"lib/index.js","readme":"# @fluid-experimental/devtools-core\n\nThis library contains developer tools for use alongside the Fluid Framework.\nIt is used to power our associated [browser extension][browser-extension].\n\n- Chrome: \n- Edge: \n\n\n\n**IMPORTANT: This package is experimental.**\n**Its APIs may change without notice.**\n\n**Do not use in production scenarios.**\n\n\n\n\n\n\n\n\n## Installation\n\nTo get started, install the package by running the following command:\n\n```bash\nnpm i @fluid-experimental/devtools-core -D\n```\n\n\n\n\n\n## Usage\n\nThe Devtools' API surface is designed to fit nicely into most application flows.\n\n### Initialization\n\nTo initialize a devtools session for your container, call [`initializeDevtools`][initialize-devtools-docs].\nThis function accepts a `DevtoolsLogger` for receiving Fluid telemetry from your application, a list of initial Fluid\n`Containers` to associate with the session, and (optionally) customized data visualization configurations for visualizing\n`Container` data.\n\n#### About the [`DevtoolsLogger`][devtools-logger-docs]\n\nThe `DevtoolsLogger` is an optional piece when calling `initializeDevtools` but it is strongly recommended that you use\nit because several features in Fluid Devtools are powered by the telemetry that Fluid Framework generates, and this\nlogger is the way in which that telemetry gets into Fluid Devtools.\n\nYou can obtain a `DevtoolsLogger` by calling its constructor, and then should pass it to `initializeDevtools` _and_\nto the `Loader` instance you'll use to create/load Containers as shown below.\nThis way the logger will receive all the telemetry generated by Fluid Framework in your application, and forward it to\nFluid Devtools as necessary.\n\n```typescript\nimport { DevtoolsLogger, initializeDevtools } from \"@fluid-experimental/devtools-core\";\n\n// Instantiate the logger\nconst devtoolsLogger = new DevtoolsLogger();\n\n// Pass the logger when instantiating the Loader\nconst loader = new Loader({\n\tlogger: devtoolsLogger,\n\t// Other necessary properties ...\n});\n\n// Use the Loader to create (and optionally, attach) a Container\nconst container = await loader.createDetachedContainer(/* params */);\nawait container.attach(/* params */);\n\n// Initialize the Devtools passing the logger and your Container.\n// The Container could be added later as well with devtools.registerContainerDevtools().\nconst devtools = initializeDevtools({\n\tlogger: devtoolsLogger,\n\tinitialContainers: [\n\t\t{\n\t\t\tcontainer,\n\t\t\tcontainerKey: \"My Container\",\n\t\t},\n\t],\n});\n```\n\nIf you're working with `AzureClient` instead of lower-level APIs like the one described above, you probably want to\nrefer to the [@fluid-experimental/devtools package][devtools-package] instead of this one.\n\nDuring local development the recommendation is that your application should receive the `DevtoolsLogger` instance _instead_\nof any logger it would normally receive when deployed to a real environment, to avoid local development activity from\nmixing with real telemetry.\nIf you still want to provide a real application logger and use the Fluid Devtools features that are powered by telemetry\nat the same time, you can pass an existing logger to the `DevtoolsLogger` constructor and it will forward all telemetry\nit receives to that logger as well:\n\n```typescript\nimport { DevtoolsLogger } from \"@fluid-experimental/devtools-core\";\n\n// Your application's logger\nconst yourApplicationLogger = getInstanceOfYourApplicationLogger();\n\nconst devtoolsLogger = new DevtoolsLogger(yourApplicationLogger);\n\n// Pass devtoolsLogger to initializeDevtools() and to your application as described above\n```\n\n### Clean-up\n\nThe Devtools object is managed as a global singleton.\nThat singleton is automatically cleaned up prior to the Window's \"unload\" event.\nSo typical application flows likely won't need to worry about cleanup.\nThat said, if you wish to have tighter control over when the Devtools are torn down, you can simply call the `dispose` method on the handle returned by [initialization](#initialization).\n\n## Contributing to the package\n\n### Build\n\nTo build the package locally, first ensure you have run `pnpm install` from the root of the mono-repo.\nNext, to build the code, run `npm run build` from the root of the mono-repo, or use [fluid-build](https://github.com/microsoft/FluidFramework/tree/main/build-tools/packages/build-tools#running-fluid-build-command-line) via `fluid-build -t build`.\n\n- Note: Once you have run a build from the root, assuming no other changes outside of this package, you may run `npm run build` directly within this directory for a faster build.\n If you make changes to any of this package's local dependencies, you will need to run a build again from the root before building again from directly within this package.\n\n### Test\n\nTo run the tests, first ensure you have followed the [build](#build) steps above.\nNext, run `npm run test` from a terminal within this directory.\n\n\n\n\n\n\n\n## API Documentation\n\nAPI documentation for **@fluid-experimental/devtools-core** is available at .\n\n\n\n\n\n\n\n\n\n\n## Contribution Guidelines\n\nThere are many ways to [contribute](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md) to Fluid.\n\n- Participate in Q&A in our [GitHub Discussions](https://github.com/microsoft/FluidFramework/discussions).\n- [Submit bugs](https://github.com/microsoft/FluidFramework/issues) and help us verify fixes as they are checked in.\n- Review the [source code changes](https://github.com/microsoft/FluidFramework/pulls).\n- [Contribute bug fixes](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md).\n\nDetailed instructions for working in the repo can be found in the [Wiki](https://github.com/microsoft/FluidFramework/wiki).\n\nThis project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).\nFor more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\nUse of these trademarks or logos must follow Microsoft’s [Trademark & Brand Guidelines](https://www.microsoft.com/trademarks).\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n\n\n\n## Help\n\nNot finding what you're looking for in this README? Check out our [GitHub\nWiki](https://github.com/microsoft/FluidFramework/wiki) or [fluidframework.com](https://fluidframework.com/docs/).\n\nStill not finding what you're looking for? Please [file an\nissue](https://github.com/microsoft/FluidFramework/wiki/Submitting-Bugs-and-Feature-Requests).\n\nThank you!\n\n\n\n\n\n\n\n\n\n\n## Trademark\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\n\nUse of these trademarks or logos must follow Microsoft's [Trademark & Brand Guidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general).\n\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n[initialize-devtools-docs]: https://fluidframework.com/docs/apis/devtools-core#initializedevtools-function\n[devtools-logger-docs]: https://fluidframework.com/docs/apis/devtools-core/devtoolslogger-class\n[devtools-package]: https://www.npmjs.com/package/@fluid-experimental/devtools\n[browser-extension]: https://github.com/microsoft/FluidFramework/tree/main/packages/tools/devtools/devtools-browser-extension\n","scripts":{"api":"fluid-build . --task api","tsc":"tsc","lint":"npm run prettier && npm run check:release-tags && npm run eslint","test":"npm run test:mocha","build":"fluid-build . --task build","clean":"rimraf --glob _api-extractor-temp nyc dist lib \"**/*.tsbuildinfo\" \"**/*.build.log\"","eslint":"eslint src","format":"npm run prettier:fix","rebuild":"npm run clean && npm run build","lint:fix":"npm run prettier:fix && npm run eslint:fix","prettier":"prettier --check . --cache --ignore-path ../../../../.prettierignore","tsc:watch":"tsc --watch","build:docs":"fluid-build . --task api","eslint:fix":"eslint src --fix","test:mocha":"mocha \"dist/**/*.test.js\" --exit","build:esnext":"tsc --project ./tsconfig.esnext.json","build:genver":"gen-version","prettier:fix":"prettier --write . --cache --ignore-path ../../../../.prettierignore","build:compile":"fluid-build . --task compile","ci:build:docs":"api-extractor run","test:coverage":"c8 npm test","typetests:gen":"fluid-type-test-generator","build:commonjs":"fluid-build . --task commonjs","format-and-build":"npm run format && npm run build","typetests:prepare":"flub typetests --dir . --reset --previous --normalize","check:release-tags":"api-extractor run --local --config ./api-extractor-lint.json","format-and-compile":"npm run format && npm run build:compile","api-extractor:esnext":"copyfiles -u 1 \"dist/**/*-@(alpha|beta|public|untrimmed).d.ts\" lib","api-extractor:commonjs":"api-extractor run --local"},"_npmUser":{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},"_resolved":"/mnt/vss/_work/1/pack/scoped/fluid-experimental-devtools-core-2.0.0-internal.8.0.3.tgz","_integrity":"sha512-JdmmlxuuSjI7GePbDe50dDcXWIJhqanm4K4dhmphynoBXOsyAxYPUxEs1RF008CDC6oiLQQJkhvKos//w0XFlw==","fluidBuild":{"tasks":{"tsc":["...","typetests:gen"],"build:docs":{"script":false,"dependsOn":["...","api-extractor:commonjs","api-extractor:esnext"]}}},"repository":{"url":"git+https://github.com/microsoft/FluidFramework.git","type":"git","directory":"packages/tools/devtools/devtools-core"},"_npmVersion":"9.6.7","description":"Fluid Framework developer tools core functionality","directories":{},"sideEffects":false,"_nodeVersion":"18.17.1","dependencies":{"@fluidframework/map":">=2.0.0-internal.8.0.3 <2.0.0-internal.8.1.0","@fluidframework/cell":">=2.0.0-internal.8.0.3 <2.0.0-internal.8.1.0","@fluidframework/matrix":">=2.0.0-internal.8.0.3 <2.0.0-internal.8.1.0","@fluidframework/counter":">=2.0.0-internal.8.0.3 <2.0.0-internal.8.1.0","@fluidframework/sequence":">=2.0.0-internal.8.0.3 <2.0.0-internal.8.1.0","@fluid-experimental/tree2":">=2.0.0-internal.8.0.3 <2.0.0-internal.8.1.0","@fluid-internal/client-utils":">=2.0.0-internal.8.0.3 <2.0.0-internal.8.1.0","@fluidframework/core-interfaces":">=2.0.0-internal.8.0.3 <2.0.0-internal.8.1.0","@fluidframework/telemetry-utils":">=2.0.0-internal.8.0.3 <2.0.0-internal.8.1.0","@fluidframework/container-loader":">=2.0.0-internal.8.0.3 <2.0.0-internal.8.1.0","@fluidframework/shared-object-base":">=2.0.0-internal.8.0.3 <2.0.0-internal.8.1.0","@fluidframework/protocol-definitions":"^3.0.0","@fluidframework/container-definitions":">=2.0.0-internal.8.0.3 <2.0.0-internal.8.1.0","@fluidframework/datastore-definitions":">=2.0.0-internal.8.0.3 <2.0.0-internal.8.1.0"},"_hasShrinkwrap":false,"readmeFilename":"README.md","typeValidation":{"broken":{"TypeAliasDeclaration_Primitive":{"forwardCompat":false},"TypeAliasDeclaration_VisualNode":{"forwardCompat":false},"InterfaceDeclaration_TreeNodeBase":{"forwardCompat":false},"InterfaceDeclaration_ValueNodeBase":{"forwardCompat":false},"InterfaceDeclaration_VisualNodeBase":{"forwardCompat":false},"InterfaceDeclaration_VisualTreeNode":{"forwardCompat":false},"TypeAliasDeclaration_RootHandleNode":{"forwardCompat":false},"InterfaceDeclaration_FluidHandleNode":{"forwardCompat":false},"InterfaceDeclaration_VisualValueNode":{"forwardCompat":false},"TypeAliasDeclaration_VisualChildNode":{"forwardCompat":false},"InterfaceDeclaration_UnknownObjectNode":{"forwardCompat":false},"InterfaceDeclaration_FluidDevtoolsProps":{"backCompat":false},"InterfaceDeclaration_FluidObjectNodeBase":{"forwardCompat":false},"InterfaceDeclaration_ContainerDevtoolsProps":{"backCompat":false}}},"devDependencies":{"c8":"^7.7.1","chai":"^4.2.0","mocha":"^10.2.0","eslint":"~8.50.0","events":"^3.1.0","moment":"^2.21.0","rimraf":"^4.4.0","prettier":"~3.0.3","copyfiles":"^2.4.1","cross-env":"^7.0.3","typescript":"~5.1.6","@types/chai":"^4.0.0","@types/mocha":"^9.1.1","@types/events":"^3.0.0","mocha-multi-reporters":"^1.5.1","@fluid-tools/build-cli":"^0.28.0","eslint-config-prettier":"~9.0.0","@microsoft/api-extractor":"^7.38.3","eslint-plugin-chai-expect":"~3.0.0","mocha-json-output-reporter":"^2.0.1","@fluidframework/build-tools":"^0.28.0","@fluidframework/build-common":"^2.0.3","@fluidframework/mocha-test-setup":">=2.0.0-internal.8.0.3 <2.0.0-internal.8.1.0","@fluidframework/driver-definitions":">=2.0.0-internal.8.0.3 <2.0.0-internal.8.1.0","@fluidframework/test-runtime-utils":">=2.0.0-internal.8.0.3 <2.0.0-internal.8.1.0","@fluidframework/eslint-config-fluid":"^3.1.0","@fluid-experimental/devtools-core-previous":"npm:@fluid-experimental/devtools-core@2.0.0-internal.7.2.0"},"_npmOperationalInternal":{"tmp":"tmp/devtools-core_2.0.0-internal.8.0.3_1705435492521_0.24536113707677543","host":"s3://npm-registry-packages"}},"2.0.0-internal.7.4.3":{"name":"@fluid-experimental/devtools-core","version":"2.0.0-internal.7.4.3","author":{"name":"Microsoft and contributors"},"license":"MIT","_id":"@fluid-experimental/devtools-core@2.0.0-internal.7.4.3","maintainers":[{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},{"name":"curtisman","email":"curtism@microsoft.com"}],"homepage":"https://fluidframework.com","bugs":{"url":"https://github.com/microsoft/FluidFramework/issues"},"c8":{"all":true,"exclude":["src/test/**/*.ts","dist/test/**/*.js"],"include":["src/**/*.ts","dist/**/*.js"],"reporter":["cobertura","html","text"],"cache-dir":"nyc/.cache","report-dir":"nyc/report","temp-directory":"nyc/.nyc_output","exclude-after-remap":false},"dist":{"shasum":"f300cd1e29023be2fa63ad53ddad967c2a471347","tarball":"https://registry.npmjs.org/@fluid-experimental/devtools-core/-/devtools-core-2.0.0-internal.7.4.3.tgz","fileCount":510,"integrity":"sha512-gILMsO4eVl0liL/J0SjDEiiawZ+T8DPv3rxHf0lJ2tMWrHekW8O1k9XWOGFDPdq8X67YBr0DBiRE1Kic5au2ag==","signatures":[{"sig":"MEUCIQD3ek4OTne3tkWQtADClbMqYzPRJP6msQRLGJhQFs3OUAIgSexOrU5hYOoaN1sN+ihKiwaEcUewG/04zgaJrY7VTCs=","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}],"unpackedSize":1625178},"main":"dist/index.js","_from":"file:fluid-experimental-devtools-core-2.0.0-internal.7.4.3.tgz","types":"dist/index.d.ts","module":"lib/index.js","readme":"# @fluid-experimental/devtools-core\n\nThis library contains developer tools for use alongside the Fluid Framework.\nIt is used to power our associated [browser extension][browser-extension].\n\n- Chrome: \n- Edge: \n\n\n\n**IMPORTANT: This package is experimental.**\n**Its APIs may change without notice.**\n\n**Do not use in production scenarios.**\n\n\n\n\n\n\n\n\n## Installation\n\nTo get started, install the package by running the following command:\n\n```bash\nnpm i @fluid-experimental/devtools-core -D\n```\n\n\n\n\n\n## Usage\n\nThe Devtools' API surface is designed to fit nicely into most application flows.\n\n### Initialization\n\nTo initialize a devtools session for your container, call [`initializeDevtools`][initialize-devtools-docs].\nThis function accepts a `DevtoolsLogger` for receiving Fluid telemetry from your application, a list of initial Fluid\n`Containers` to associate with the session, and (optionally) customized data visualization configurations for visualizing\n`Container` data.\n\n#### About the [`DevtoolsLogger`][devtools-logger-docs]\n\nThe `DevtoolsLogger` is an optional piece when calling `initializeDevtools` but it is strongly recommended that you use\nit because several features in Fluid Devtools are powered by the telemetry that Fluid Framework generates, and this\nlogger is the way in which that telemetry gets into Fluid Devtools.\n\nYou can obtain a `DevtoolsLogger` by calling its constructor, and then should pass it to `initializeDevtools` _and_\nto the `Loader` instance you'll use to create/load Containers as shown below.\nThis way the logger will receive all the telemetry generated by Fluid Framework in your application, and forward it to\nFluid Devtools as necessary.\n\n```typescript\nimport { DevtoolsLogger, initializeDevtools } from \"@fluid-experimental/devtools-core\";\n\n// Instantiate the logger\nconst devtoolsLogger = new DevtoolsLogger();\n\n// Pass the logger when instantiating the Loader\nconst loader = new Loader({\n\tlogger: devtoolsLogger,\n\t// Other necessary properties ...\n});\n\n// Use the Loader to create (and optionally, attach) a Container\nconst container = await loader.createDetachedContainer(/* params */);\nawait container.attach(/* params */);\n\n// Initialize the Devtools passing the logger and your Container.\n// The Container could be added later as well with devtools.registerContainerDevtools().\nconst devtools = initializeDevtools({\n\tlogger: devtoolsLogger,\n\tinitialContainers: [\n\t\t{\n\t\t\tcontainer,\n\t\t\tcontainerKey: \"My Container\",\n\t\t},\n\t],\n});\n```\n\nIf you're working with `AzureClient` instead of lower-level APIs like the one described above, you probably want to\nrefer to the [@fluid-experimental/devtools package][devtools-package] instead of this one.\n\nDuring local development the recommendation is that your application should receive the `DevtoolsLogger` instance _instead_\nof any logger it would normally receive when deployed to a real environment, to avoid local development activity from\nmixing with real telemetry.\nIf you still want to provide a real application logger and use the Fluid Devtools features that are powered by telemetry\nat the same time, you can pass an existing logger to the `DevtoolsLogger` constructor and it will forward all telemetry\nit receives to that logger as well:\n\n```typescript\nimport { DevtoolsLogger } from \"@fluid-experimental/devtools-core\";\n\n// Your application's logger\nconst yourApplicationLogger = getInstanceOfYourApplicationLogger();\n\nconst devtoolsLogger = new DevtoolsLogger(yourApplicationLogger);\n\n// Pass devtoolsLogger to initializeDevtools() and to your application as described above\n```\n\n### Clean-up\n\nThe Devtools object is managed as a global singleton.\nThat singleton is automatically cleaned up prior to the Window's \"unload\" event.\nSo typical application flows likely won't need to worry about cleanup.\nThat said, if you wish to have tighter control over when the Devtools are torn down, you can simply call the `dispose` method on the handle returned by [initialization](#initialization).\n\n## Contributing to the package\n\n### Build\n\nTo build the package locally, first ensure you have run `pnpm install` from the root of the mono-repo.\nNext, to build the code, run `npm run build` from the root of the mono-repo, or use [fluid-build](https://github.com/microsoft/FluidFramework/tree/main/build-tools/packages/build-tools#running-fluid-build-command-line) via `fluid-build -t build`.\n\n- Note: Once you have run a build from the root, assuming no other changes outside of this package, you may run `npm run build` directly within this directory for a faster build.\n If you make changes to any of this package's local dependencies, you will need to run a build again from the root before building again from directly within this package.\n\n### Test\n\nTo run the tests, first ensure you have followed the [build](#build) steps above.\nNext, run `npm run test` from a terminal within this directory.\n\n\n\n\n\n\n\n## API Documentation\n\nAPI documentation for **@fluid-experimental/devtools-core** is available at .\n\n\n\n\n\n\n\n\n\n\n## Contribution Guidelines\n\nThere are many ways to [contribute](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md) to Fluid.\n\n- Participate in Q&A in our [GitHub Discussions](https://github.com/microsoft/FluidFramework/discussions).\n- [Submit bugs](https://github.com/microsoft/FluidFramework/issues) and help us verify fixes as they are checked in.\n- Review the [source code changes](https://github.com/microsoft/FluidFramework/pulls).\n- [Contribute bug fixes](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md).\n\nDetailed instructions for working in the repo can be found in the [Wiki](https://github.com/microsoft/FluidFramework/wiki).\n\nThis project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).\nFor more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\nUse of these trademarks or logos must follow Microsoft’s [Trademark & Brand Guidelines](https://www.microsoft.com/trademarks).\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n\n\n\n## Help\n\nNot finding what you're looking for in this README? Check out our [GitHub\nWiki](https://github.com/microsoft/FluidFramework/wiki) or [fluidframework.com](https://fluidframework.com/docs/).\n\nStill not finding what you're looking for? Please [file an\nissue](https://github.com/microsoft/FluidFramework/wiki/Submitting-Bugs-and-Feature-Requests).\n\nThank you!\n\n\n\n\n\n\n\n\n\n\n## Trademark\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\n\nUse of these trademarks or logos must follow Microsoft's [Trademark & Brand Guidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general).\n\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n[initialize-devtools-docs]: https://fluidframework.com/docs/apis/devtools-core#initializedevtools-function\n[devtools-logger-docs]: https://fluidframework.com/docs/apis/devtools-core/devtoolslogger-class\n[devtools-package]: https://www.npmjs.com/package/@fluid-experimental/devtools\n[browser-extension]: https://github.com/microsoft/FluidFramework/tree/main/packages/tools/devtools/devtools-browser-extension\n","scripts":{"api":"fluid-build . --task api","tsc":"tsc","lint":"npm run prettier && npm run check:release-tags && npm run eslint","test":"npm run test:mocha","build":"fluid-build . --task build","clean":"rimraf --glob _api-extractor-temp nyc dist lib \"**/*.tsbuildinfo\" \"**/*.build.log\"","eslint":"eslint src","format":"npm run prettier:fix","rebuild":"npm run clean && npm run build","lint:fix":"npm run prettier:fix && npm run eslint:fix","prettier":"prettier --check . --cache --ignore-path ../../../../.prettierignore","tsc:watch":"tsc --watch","build:docs":"fluid-build . --task api","eslint:fix":"eslint src --fix","test:mocha":"mocha \"dist/**/*.test.js\" --exit","build:esnext":"tsc --project ./tsconfig.esnext.json","build:genver":"gen-version","prettier:fix":"prettier --write . --cache --ignore-path ../../../../.prettierignore","build:compile":"fluid-build . --task compile","ci:build:docs":"api-extractor run","test:coverage":"c8 npm test","typetests:gen":"fluid-type-test-generator","build:commonjs":"fluid-build . --task commonjs","format-and-build":"npm run format && npm run build","typetests:prepare":"flub typetests --dir . --reset --previous --normalize","check:release-tags":"api-extractor run --local --config ./api-extractor-lint.json","format-and-compile":"npm run format && npm run build:compile","api-extractor:esnext":"copyfiles -u 1 \"dist/**/*-@(alpha|beta|public|untrimmed).d.ts\" lib","api-extractor:commonjs":"api-extractor run --local"},"_npmUser":{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},"_resolved":"/mnt/vss/_work/1/pack/scoped/fluid-experimental-devtools-core-2.0.0-internal.7.4.3.tgz","_integrity":"sha512-gILMsO4eVl0liL/J0SjDEiiawZ+T8DPv3rxHf0lJ2tMWrHekW8O1k9XWOGFDPdq8X67YBr0DBiRE1Kic5au2ag==","fluidBuild":{"tasks":{"tsc":["...","typetests:gen"],"build:docs":{"script":false,"dependsOn":["...","api-extractor:commonjs","api-extractor:esnext"]}}},"repository":{"url":"git+https://github.com/microsoft/FluidFramework.git","type":"git","directory":"packages/tools/devtools/devtools-core"},"_npmVersion":"9.6.7","description":"Fluid Framework developer tools core functionality","directories":{},"sideEffects":false,"_nodeVersion":"18.17.1","dependencies":{"@fluidframework/map":">=2.0.0-internal.7.4.3 <2.0.0-internal.7.5.0","@fluidframework/cell":">=2.0.0-internal.7.4.3 <2.0.0-internal.7.5.0","@fluidframework/matrix":">=2.0.0-internal.7.4.3 <2.0.0-internal.7.5.0","@fluidframework/counter":">=2.0.0-internal.7.4.3 <2.0.0-internal.7.5.0","@fluidframework/sequence":">=2.0.0-internal.7.4.3 <2.0.0-internal.7.5.0","@fluid-experimental/tree2":">=2.0.0-internal.7.4.3 <2.0.0-internal.7.5.0","@fluid-internal/client-utils":">=2.0.0-internal.7.4.3 <2.0.0-internal.7.5.0","@fluidframework/core-interfaces":">=2.0.0-internal.7.4.3 <2.0.0-internal.7.5.0","@fluidframework/telemetry-utils":">=2.0.0-internal.7.4.3 <2.0.0-internal.7.5.0","@fluidframework/container-loader":">=2.0.0-internal.7.4.3 <2.0.0-internal.7.5.0","@fluidframework/shared-object-base":">=2.0.0-internal.7.4.3 <2.0.0-internal.7.5.0","@fluidframework/protocol-definitions":"^3.0.0","@fluidframework/container-definitions":">=2.0.0-internal.7.4.3 <2.0.0-internal.7.5.0","@fluidframework/datastore-definitions":">=2.0.0-internal.7.4.3 <2.0.0-internal.7.5.0"},"_hasShrinkwrap":false,"readmeFilename":"README.md","typeValidation":{"broken":{}},"devDependencies":{"c8":"^7.7.1","chai":"^4.2.0","mocha":"^10.2.0","eslint":"~8.50.0","events":"^3.1.0","moment":"^2.21.0","rimraf":"^4.4.0","prettier":"~3.0.3","copyfiles":"^2.4.1","cross-env":"^7.0.3","typescript":"~5.1.6","@types/chai":"^4.0.0","@types/mocha":"^9.1.1","@types/events":"^3.0.0","mocha-multi-reporters":"^1.5.1","@fluid-tools/build-cli":"^0.28.0","eslint-config-prettier":"~9.0.0","@microsoft/api-extractor":"^7.38.3","eslint-plugin-chai-expect":"~3.0.0","mocha-json-output-reporter":"^2.0.1","@fluidframework/build-tools":"^0.28.0","@fluidframework/build-common":"^2.0.3","@fluidframework/mocha-test-setup":">=2.0.0-internal.7.4.3 <2.0.0-internal.7.5.0","@fluidframework/driver-definitions":">=2.0.0-internal.7.4.3 <2.0.0-internal.7.5.0","@fluidframework/test-runtime-utils":">=2.0.0-internal.7.4.3 <2.0.0-internal.7.5.0","@fluidframework/eslint-config-fluid":"^3.1.0","@fluid-experimental/devtools-core-previous":"npm:@fluid-experimental/devtools-core@2.0.0-internal.7.2.0"},"_npmOperationalInternal":{"tmp":"tmp/devtools-core_2.0.0-internal.7.4.3_1705619040976_0.20080812896587985","host":"s3://npm-registry-packages"}},"2.0.0-internal.8.0.4":{"name":"@fluid-experimental/devtools-core","version":"2.0.0-internal.8.0.4","author":{"name":"Microsoft and contributors"},"license":"MIT","_id":"@fluid-experimental/devtools-core@2.0.0-internal.8.0.4","maintainers":[{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},{"name":"curtisman","email":"curtism@microsoft.com"}],"homepage":"https://fluidframework.com","bugs":{"url":"https://github.com/microsoft/FluidFramework/issues"},"c8":{"all":true,"exclude":["src/test/**/*.ts","dist/test/**/*.js"],"include":["src/**/*.ts","dist/**/*.js"],"reporter":["cobertura","html","text"],"cache-dir":"nyc/.cache","report-dir":"nyc/report","temp-directory":"nyc/.nyc_output","exclude-after-remap":false},"dist":{"shasum":"23b2d47461c395097a4bd31544e07b9201271fc9","tarball":"https://registry.npmjs.org/@fluid-experimental/devtools-core/-/devtools-core-2.0.0-internal.8.0.4.tgz","fileCount":510,"integrity":"sha512-H338gfFEBIBcKPsHJ2zUcoF85UtUe3uZaKjBv7RZnL0E2sh82zf7O0WUnRL3JCabsysda5jX+2WxCMe5W5r0XQ==","signatures":[{"sig":"MEUCIAKHKdt3ahtXMjOjXM7P8Jd7zz7AzSOhNWo5CTxwT+wsAiEAg5MOubbxd9tVu5B3ZHf6PHhRtOB+XSFt6J0wV8w/XFg=","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}],"unpackedSize":1629472},"main":"dist/index.js","_from":"file:fluid-experimental-devtools-core-2.0.0-internal.8.0.4.tgz","types":"dist/index.d.ts","module":"lib/index.js","readme":"# @fluid-experimental/devtools-core\n\nThis library contains developer tools for use alongside the Fluid Framework.\nIt is used to power our associated [browser extension][browser-extension].\n\n- Chrome: \n- Edge: \n\n\n\n**IMPORTANT: This package is experimental.**\n**Its APIs may change without notice.**\n\n**Do not use in production scenarios.**\n\n\n\n\n\n\n\n\n## Installation\n\nTo get started, install the package by running the following command:\n\n```bash\nnpm i @fluid-experimental/devtools-core -D\n```\n\n\n\n\n\n## Usage\n\nThe Devtools' API surface is designed to fit nicely into most application flows.\n\n### Initialization\n\nTo initialize a devtools session for your container, call [`initializeDevtools`][initialize-devtools-docs].\nThis function accepts a `DevtoolsLogger` for receiving Fluid telemetry from your application, a list of initial Fluid\n`Containers` to associate with the session, and (optionally) customized data visualization configurations for visualizing\n`Container` data.\n\n#### About the [`DevtoolsLogger`][devtools-logger-docs]\n\nThe `DevtoolsLogger` is an optional piece when calling `initializeDevtools` but it is strongly recommended that you use\nit because several features in Fluid Devtools are powered by the telemetry that Fluid Framework generates, and this\nlogger is the way in which that telemetry gets into Fluid Devtools.\n\nYou can obtain a `DevtoolsLogger` by calling its constructor, and then should pass it to `initializeDevtools` _and_\nto the `Loader` instance you'll use to create/load Containers as shown below.\nThis way the logger will receive all the telemetry generated by Fluid Framework in your application, and forward it to\nFluid Devtools as necessary.\n\n```typescript\nimport { DevtoolsLogger, initializeDevtools } from \"@fluid-experimental/devtools-core\";\n\n// Instantiate the logger\nconst devtoolsLogger = new DevtoolsLogger();\n\n// Pass the logger when instantiating the Loader\nconst loader = new Loader({\n\tlogger: devtoolsLogger,\n\t// Other necessary properties ...\n});\n\n// Use the Loader to create (and optionally, attach) a Container\nconst container = await loader.createDetachedContainer(/* params */);\nawait container.attach(/* params */);\n\n// Initialize the Devtools passing the logger and your Container.\n// The Container could be added later as well with devtools.registerContainerDevtools().\nconst devtools = initializeDevtools({\n\tlogger: devtoolsLogger,\n\tinitialContainers: [\n\t\t{\n\t\t\tcontainer,\n\t\t\tcontainerKey: \"My Container\",\n\t\t},\n\t],\n});\n```\n\nIf you're working with `AzureClient` instead of lower-level APIs like the one described above, you probably want to\nrefer to the [@fluid-experimental/devtools package][devtools-package] instead of this one.\n\nDuring local development the recommendation is that your application should receive the `DevtoolsLogger` instance _instead_\nof any logger it would normally receive when deployed to a real environment, to avoid local development activity from\nmixing with real telemetry.\nIf you still want to provide a real application logger and use the Fluid Devtools features that are powered by telemetry\nat the same time, you can pass an existing logger to the `DevtoolsLogger` constructor and it will forward all telemetry\nit receives to that logger as well:\n\n```typescript\nimport { DevtoolsLogger } from \"@fluid-experimental/devtools-core\";\n\n// Your application's logger\nconst yourApplicationLogger = getInstanceOfYourApplicationLogger();\n\nconst devtoolsLogger = new DevtoolsLogger(yourApplicationLogger);\n\n// Pass devtoolsLogger to initializeDevtools() and to your application as described above\n```\n\n### Clean-up\n\nThe Devtools object is managed as a global singleton.\nThat singleton is automatically cleaned up prior to the Window's \"unload\" event.\nSo typical application flows likely won't need to worry about cleanup.\nThat said, if you wish to have tighter control over when the Devtools are torn down, you can simply call the `dispose` method on the handle returned by [initialization](#initialization).\n\n## Contributing to the package\n\n### Build\n\nTo build the package locally, first ensure you have run `pnpm install` from the root of the mono-repo.\nNext, to build the code, run `npm run build` from the root of the mono-repo, or use [fluid-build](https://github.com/microsoft/FluidFramework/tree/main/build-tools/packages/build-tools#running-fluid-build-command-line) via `fluid-build -t build`.\n\n- Note: Once you have run a build from the root, assuming no other changes outside of this package, you may run `npm run build` directly within this directory for a faster build.\n If you make changes to any of this package's local dependencies, you will need to run a build again from the root before building again from directly within this package.\n\n### Test\n\nTo run the tests, first ensure you have followed the [build](#build) steps above.\nNext, run `npm run test` from a terminal within this directory.\n\n\n\n\n\n\n\n## API Documentation\n\nAPI documentation for **@fluid-experimental/devtools-core** is available at .\n\n\n\n\n\n\n\n\n\n\n## Contribution Guidelines\n\nThere are many ways to [contribute](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md) to Fluid.\n\n- Participate in Q&A in our [GitHub Discussions](https://github.com/microsoft/FluidFramework/discussions).\n- [Submit bugs](https://github.com/microsoft/FluidFramework/issues) and help us verify fixes as they are checked in.\n- Review the [source code changes](https://github.com/microsoft/FluidFramework/pulls).\n- [Contribute bug fixes](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md).\n\nDetailed instructions for working in the repo can be found in the [Wiki](https://github.com/microsoft/FluidFramework/wiki).\n\nThis project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).\nFor more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\nUse of these trademarks or logos must follow Microsoft’s [Trademark & Brand Guidelines](https://www.microsoft.com/trademarks).\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n\n\n\n## Help\n\nNot finding what you're looking for in this README? Check out our [GitHub\nWiki](https://github.com/microsoft/FluidFramework/wiki) or [fluidframework.com](https://fluidframework.com/docs/).\n\nStill not finding what you're looking for? Please [file an\nissue](https://github.com/microsoft/FluidFramework/wiki/Submitting-Bugs-and-Feature-Requests).\n\nThank you!\n\n\n\n\n\n\n\n\n\n\n## Trademark\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\n\nUse of these trademarks or logos must follow Microsoft's [Trademark & Brand Guidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general).\n\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n[initialize-devtools-docs]: https://fluidframework.com/docs/apis/devtools-core#initializedevtools-function\n[devtools-logger-docs]: https://fluidframework.com/docs/apis/devtools-core/devtoolslogger-class\n[devtools-package]: https://www.npmjs.com/package/@fluid-experimental/devtools\n[browser-extension]: https://github.com/microsoft/FluidFramework/tree/main/packages/tools/devtools/devtools-browser-extension\n","scripts":{"api":"fluid-build . --task api","tsc":"tsc","lint":"npm run prettier && npm run check:release-tags && npm run eslint","test":"npm run test:mocha","build":"fluid-build . --task build","clean":"rimraf --glob _api-extractor-temp nyc dist lib \"**/*.tsbuildinfo\" \"**/*.build.log\"","eslint":"eslint src","format":"npm run prettier:fix","rebuild":"npm run clean && npm run build","lint:fix":"npm run prettier:fix && npm run eslint:fix","prettier":"prettier --check . --cache --ignore-path ../../../../.prettierignore","tsc:watch":"tsc --watch","build:docs":"fluid-build . --task api","eslint:fix":"eslint src --fix","test:mocha":"mocha \"dist/**/*.test.js\" --exit","build:esnext":"tsc --project ./tsconfig.esnext.json","build:genver":"gen-version","prettier:fix":"prettier --write . --cache --ignore-path ../../../../.prettierignore","build:compile":"fluid-build . --task compile","ci:build:docs":"api-extractor run","test:coverage":"c8 npm test","typetests:gen":"fluid-type-test-generator","build:commonjs":"fluid-build . --task commonjs","format-and-build":"npm run format && npm run build","typetests:prepare":"flub typetests --dir . --reset --previous --normalize","check:release-tags":"api-extractor run --local --config ./api-extractor-lint.json","format-and-compile":"npm run format && npm run build:compile","api-extractor:esnext":"copyfiles -u 1 \"dist/**/*-@(alpha|beta|public|untrimmed).d.ts\" lib","api-extractor:commonjs":"api-extractor run --local"},"_npmUser":{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},"_resolved":"/mnt/vss/_work/1/pack/scoped/fluid-experimental-devtools-core-2.0.0-internal.8.0.4.tgz","_integrity":"sha512-H338gfFEBIBcKPsHJ2zUcoF85UtUe3uZaKjBv7RZnL0E2sh82zf7O0WUnRL3JCabsysda5jX+2WxCMe5W5r0XQ==","fluidBuild":{"tasks":{"tsc":["...","typetests:gen"],"build:docs":{"script":false,"dependsOn":["...","api-extractor:commonjs","api-extractor:esnext"]}}},"repository":{"url":"git+https://github.com/microsoft/FluidFramework.git","type":"git","directory":"packages/tools/devtools/devtools-core"},"_npmVersion":"9.6.7","description":"Fluid Framework developer tools core functionality","directories":{},"sideEffects":false,"_nodeVersion":"18.17.1","dependencies":{"@fluidframework/map":">=2.0.0-internal.8.0.4 <2.0.0-internal.8.1.0","@fluidframework/cell":">=2.0.0-internal.8.0.4 <2.0.0-internal.8.1.0","@fluidframework/matrix":">=2.0.0-internal.8.0.4 <2.0.0-internal.8.1.0","@fluidframework/counter":">=2.0.0-internal.8.0.4 <2.0.0-internal.8.1.0","@fluidframework/sequence":">=2.0.0-internal.8.0.4 <2.0.0-internal.8.1.0","@fluid-experimental/tree2":">=2.0.0-internal.8.0.4 <2.0.0-internal.8.1.0","@fluid-internal/client-utils":">=2.0.0-internal.8.0.4 <2.0.0-internal.8.1.0","@fluidframework/core-interfaces":">=2.0.0-internal.8.0.4 <2.0.0-internal.8.1.0","@fluidframework/telemetry-utils":">=2.0.0-internal.8.0.4 <2.0.0-internal.8.1.0","@fluidframework/container-loader":">=2.0.0-internal.8.0.4 <2.0.0-internal.8.1.0","@fluidframework/shared-object-base":">=2.0.0-internal.8.0.4 <2.0.0-internal.8.1.0","@fluidframework/protocol-definitions":"^3.0.0","@fluidframework/container-definitions":">=2.0.0-internal.8.0.4 <2.0.0-internal.8.1.0","@fluidframework/datastore-definitions":">=2.0.0-internal.8.0.4 <2.0.0-internal.8.1.0"},"_hasShrinkwrap":false,"readmeFilename":"README.md","typeValidation":{"broken":{"TypeAliasDeclaration_Primitive":{"forwardCompat":false},"TypeAliasDeclaration_VisualNode":{"forwardCompat":false},"InterfaceDeclaration_TreeNodeBase":{"forwardCompat":false},"InterfaceDeclaration_ValueNodeBase":{"forwardCompat":false},"InterfaceDeclaration_VisualNodeBase":{"forwardCompat":false},"InterfaceDeclaration_VisualTreeNode":{"forwardCompat":false},"TypeAliasDeclaration_RootHandleNode":{"forwardCompat":false},"InterfaceDeclaration_FluidHandleNode":{"forwardCompat":false},"InterfaceDeclaration_VisualValueNode":{"forwardCompat":false},"TypeAliasDeclaration_VisualChildNode":{"forwardCompat":false},"InterfaceDeclaration_UnknownObjectNode":{"forwardCompat":false},"InterfaceDeclaration_FluidDevtoolsProps":{"backCompat":false},"InterfaceDeclaration_FluidObjectNodeBase":{"forwardCompat":false},"InterfaceDeclaration_ContainerDevtoolsProps":{"backCompat":false}}},"devDependencies":{"c8":"^7.7.1","chai":"^4.2.0","mocha":"^10.2.0","eslint":"~8.50.0","events":"^3.1.0","moment":"^2.21.0","rimraf":"^4.4.0","prettier":"~3.0.3","copyfiles":"^2.4.1","cross-env":"^7.0.3","typescript":"~5.1.6","@types/chai":"^4.0.0","@types/mocha":"^9.1.1","@types/events":"^3.0.0","mocha-multi-reporters":"^1.5.1","@fluid-tools/build-cli":"^0.28.0","eslint-config-prettier":"~9.0.0","@microsoft/api-extractor":"^7.38.3","eslint-plugin-chai-expect":"~3.0.0","mocha-json-output-reporter":"^2.0.1","@fluidframework/build-tools":"^0.28.0","@fluidframework/build-common":"^2.0.3","@fluidframework/mocha-test-setup":">=2.0.0-internal.8.0.4 <2.0.0-internal.8.1.0","@fluidframework/driver-definitions":">=2.0.0-internal.8.0.4 <2.0.0-internal.8.1.0","@fluidframework/test-runtime-utils":">=2.0.0-internal.8.0.4 <2.0.0-internal.8.1.0","@fluidframework/eslint-config-fluid":"^3.1.0","@fluid-experimental/devtools-core-previous":"npm:@fluid-experimental/devtools-core@2.0.0-internal.7.2.0"},"_npmOperationalInternal":{"tmp":"tmp/devtools-core_2.0.0-internal.8.0.4_1705619781701_0.40663029932775197","host":"s3://npm-registry-packages"}},"2.0.0-internal.7.4.4":{"name":"@fluid-experimental/devtools-core","version":"2.0.0-internal.7.4.4","author":{"name":"Microsoft and contributors"},"license":"MIT","_id":"@fluid-experimental/devtools-core@2.0.0-internal.7.4.4","maintainers":[{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},{"name":"curtisman","email":"curtism@microsoft.com"}],"homepage":"https://fluidframework.com","bugs":{"url":"https://github.com/microsoft/FluidFramework/issues"},"c8":{"all":true,"exclude":["src/test/**/*.ts","dist/test/**/*.js"],"include":["src/**/*.ts","dist/**/*.js"],"reporter":["cobertura","html","text"],"cache-dir":"nyc/.cache","report-dir":"nyc/report","temp-directory":"nyc/.nyc_output","exclude-after-remap":false},"dist":{"shasum":"ddb40a4b55b00dd76a97835dc1ff27264d0e98cf","tarball":"https://registry.npmjs.org/@fluid-experimental/devtools-core/-/devtools-core-2.0.0-internal.7.4.4.tgz","fileCount":510,"integrity":"sha512-x0YQuNAAqNiwlg/vk9EFlQ7WO7J+ib7YTOnEVIdKksXx+ieIGHDWlViyQhceu27378yjZZA4DCksvh2TGWtjZw==","signatures":[{"sig":"MEMCHy6CbBvvUkOQnG/QiHnTUTJju0QWgXkGxpgMZnC3aRECIFiddg1LPITB4guRXvVRDm4UliOya38udiH4Q6zwt6dw","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}],"unpackedSize":1625178},"main":"dist/index.js","_from":"file:fluid-experimental-devtools-core-2.0.0-internal.7.4.4.tgz","types":"dist/index.d.ts","module":"lib/index.js","readme":"# @fluid-experimental/devtools-core\n\nThis library contains developer tools for use alongside the Fluid Framework.\nIt is used to power our associated [browser extension][browser-extension].\n\n- Chrome: \n- Edge: \n\n\n\n**IMPORTANT: This package is experimental.**\n**Its APIs may change without notice.**\n\n**Do not use in production scenarios.**\n\n\n\n\n\n\n\n\n## Installation\n\nTo get started, install the package by running the following command:\n\n```bash\nnpm i @fluid-experimental/devtools-core -D\n```\n\n\n\n\n\n## Usage\n\nThe Devtools' API surface is designed to fit nicely into most application flows.\n\n### Initialization\n\nTo initialize a devtools session for your container, call [`initializeDevtools`][initialize-devtools-docs].\nThis function accepts a `DevtoolsLogger` for receiving Fluid telemetry from your application, a list of initial Fluid\n`Containers` to associate with the session, and (optionally) customized data visualization configurations for visualizing\n`Container` data.\n\n#### About the [`DevtoolsLogger`][devtools-logger-docs]\n\nThe `DevtoolsLogger` is an optional piece when calling `initializeDevtools` but it is strongly recommended that you use\nit because several features in Fluid Devtools are powered by the telemetry that Fluid Framework generates, and this\nlogger is the way in which that telemetry gets into Fluid Devtools.\n\nYou can obtain a `DevtoolsLogger` by calling its constructor, and then should pass it to `initializeDevtools` _and_\nto the `Loader` instance you'll use to create/load Containers as shown below.\nThis way the logger will receive all the telemetry generated by Fluid Framework in your application, and forward it to\nFluid Devtools as necessary.\n\n```typescript\nimport { DevtoolsLogger, initializeDevtools } from \"@fluid-experimental/devtools-core\";\n\n// Instantiate the logger\nconst devtoolsLogger = new DevtoolsLogger();\n\n// Pass the logger when instantiating the Loader\nconst loader = new Loader({\n\tlogger: devtoolsLogger,\n\t// Other necessary properties ...\n});\n\n// Use the Loader to create (and optionally, attach) a Container\nconst container = await loader.createDetachedContainer(/* params */);\nawait container.attach(/* params */);\n\n// Initialize the Devtools passing the logger and your Container.\n// The Container could be added later as well with devtools.registerContainerDevtools().\nconst devtools = initializeDevtools({\n\tlogger: devtoolsLogger,\n\tinitialContainers: [\n\t\t{\n\t\t\tcontainer,\n\t\t\tcontainerKey: \"My Container\",\n\t\t},\n\t],\n});\n```\n\nIf you're working with `AzureClient` instead of lower-level APIs like the one described above, you probably want to\nrefer to the [@fluid-experimental/devtools package][devtools-package] instead of this one.\n\nDuring local development the recommendation is that your application should receive the `DevtoolsLogger` instance _instead_\nof any logger it would normally receive when deployed to a real environment, to avoid local development activity from\nmixing with real telemetry.\nIf you still want to provide a real application logger and use the Fluid Devtools features that are powered by telemetry\nat the same time, you can pass an existing logger to the `DevtoolsLogger` constructor and it will forward all telemetry\nit receives to that logger as well:\n\n```typescript\nimport { DevtoolsLogger } from \"@fluid-experimental/devtools-core\";\n\n// Your application's logger\nconst yourApplicationLogger = getInstanceOfYourApplicationLogger();\n\nconst devtoolsLogger = new DevtoolsLogger(yourApplicationLogger);\n\n// Pass devtoolsLogger to initializeDevtools() and to your application as described above\n```\n\n### Clean-up\n\nThe Devtools object is managed as a global singleton.\nThat singleton is automatically cleaned up prior to the Window's \"unload\" event.\nSo typical application flows likely won't need to worry about cleanup.\nThat said, if you wish to have tighter control over when the Devtools are torn down, you can simply call the `dispose` method on the handle returned by [initialization](#initialization).\n\n## Contributing to the package\n\n### Build\n\nTo build the package locally, first ensure you have run `pnpm install` from the root of the mono-repo.\nNext, to build the code, run `npm run build` from the root of the mono-repo, or use [fluid-build](https://github.com/microsoft/FluidFramework/tree/main/build-tools/packages/build-tools#running-fluid-build-command-line) via `fluid-build -t build`.\n\n- Note: Once you have run a build from the root, assuming no other changes outside of this package, you may run `npm run build` directly within this directory for a faster build.\n If you make changes to any of this package's local dependencies, you will need to run a build again from the root before building again from directly within this package.\n\n### Test\n\nTo run the tests, first ensure you have followed the [build](#build) steps above.\nNext, run `npm run test` from a terminal within this directory.\n\n\n\n\n\n\n\n## API Documentation\n\nAPI documentation for **@fluid-experimental/devtools-core** is available at .\n\n\n\n\n\n\n\n\n\n\n## Contribution Guidelines\n\nThere are many ways to [contribute](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md) to Fluid.\n\n- Participate in Q&A in our [GitHub Discussions](https://github.com/microsoft/FluidFramework/discussions).\n- [Submit bugs](https://github.com/microsoft/FluidFramework/issues) and help us verify fixes as they are checked in.\n- Review the [source code changes](https://github.com/microsoft/FluidFramework/pulls).\n- [Contribute bug fixes](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md).\n\nDetailed instructions for working in the repo can be found in the [Wiki](https://github.com/microsoft/FluidFramework/wiki).\n\nThis project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).\nFor more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\nUse of these trademarks or logos must follow Microsoft’s [Trademark & Brand Guidelines](https://www.microsoft.com/trademarks).\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n\n\n\n## Help\n\nNot finding what you're looking for in this README? Check out our [GitHub\nWiki](https://github.com/microsoft/FluidFramework/wiki) or [fluidframework.com](https://fluidframework.com/docs/).\n\nStill not finding what you're looking for? Please [file an\nissue](https://github.com/microsoft/FluidFramework/wiki/Submitting-Bugs-and-Feature-Requests).\n\nThank you!\n\n\n\n\n\n\n\n\n\n\n## Trademark\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\n\nUse of these trademarks or logos must follow Microsoft's [Trademark & Brand Guidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general).\n\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n[initialize-devtools-docs]: https://fluidframework.com/docs/apis/devtools-core#initializedevtools-function\n[devtools-logger-docs]: https://fluidframework.com/docs/apis/devtools-core/devtoolslogger-class\n[devtools-package]: https://www.npmjs.com/package/@fluid-experimental/devtools\n[browser-extension]: https://github.com/microsoft/FluidFramework/tree/main/packages/tools/devtools/devtools-browser-extension\n","scripts":{"api":"fluid-build . --task api","tsc":"tsc","lint":"npm run prettier && npm run check:release-tags && npm run eslint","test":"npm run test:mocha","build":"fluid-build . --task build","clean":"rimraf --glob _api-extractor-temp nyc dist lib \"**/*.tsbuildinfo\" \"**/*.build.log\"","eslint":"eslint src","format":"npm run prettier:fix","rebuild":"npm run clean && npm run build","lint:fix":"npm run prettier:fix && npm run eslint:fix","prettier":"prettier --check . --cache --ignore-path ../../../../.prettierignore","tsc:watch":"tsc --watch","build:docs":"fluid-build . --task api","eslint:fix":"eslint src --fix","test:mocha":"mocha \"dist/**/*.test.js\" --exit","build:esnext":"tsc --project ./tsconfig.esnext.json","build:genver":"gen-version","prettier:fix":"prettier --write . --cache --ignore-path ../../../../.prettierignore","build:compile":"fluid-build . --task compile","ci:build:docs":"api-extractor run","test:coverage":"c8 npm test","typetests:gen":"fluid-type-test-generator","build:commonjs":"fluid-build . --task commonjs","format-and-build":"npm run format && npm run build","typetests:prepare":"flub typetests --dir . --reset --previous --normalize","check:release-tags":"api-extractor run --local --config ./api-extractor-lint.json","format-and-compile":"npm run format && npm run build:compile","api-extractor:esnext":"copyfiles -u 1 \"dist/**/*-@(alpha|beta|public|untrimmed).d.ts\" lib","api-extractor:commonjs":"api-extractor run --local"},"_npmUser":{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},"_resolved":"/mnt/vss/_work/1/pack/scoped/fluid-experimental-devtools-core-2.0.0-internal.7.4.4.tgz","_integrity":"sha512-x0YQuNAAqNiwlg/vk9EFlQ7WO7J+ib7YTOnEVIdKksXx+ieIGHDWlViyQhceu27378yjZZA4DCksvh2TGWtjZw==","fluidBuild":{"tasks":{"tsc":["...","typetests:gen"],"build:docs":{"script":false,"dependsOn":["...","api-extractor:commonjs","api-extractor:esnext"]}}},"repository":{"url":"git+https://github.com/microsoft/FluidFramework.git","type":"git","directory":"packages/tools/devtools/devtools-core"},"_npmVersion":"9.6.7","description":"Fluid Framework developer tools core functionality","directories":{},"sideEffects":false,"_nodeVersion":"18.17.1","dependencies":{"@fluidframework/map":">=2.0.0-internal.7.4.4 <2.0.0-internal.7.5.0","@fluidframework/cell":">=2.0.0-internal.7.4.4 <2.0.0-internal.7.5.0","@fluidframework/matrix":">=2.0.0-internal.7.4.4 <2.0.0-internal.7.5.0","@fluidframework/counter":">=2.0.0-internal.7.4.4 <2.0.0-internal.7.5.0","@fluidframework/sequence":">=2.0.0-internal.7.4.4 <2.0.0-internal.7.5.0","@fluid-experimental/tree2":">=2.0.0-internal.7.4.4 <2.0.0-internal.7.5.0","@fluid-internal/client-utils":">=2.0.0-internal.7.4.4 <2.0.0-internal.7.5.0","@fluidframework/core-interfaces":">=2.0.0-internal.7.4.4 <2.0.0-internal.7.5.0","@fluidframework/telemetry-utils":">=2.0.0-internal.7.4.4 <2.0.0-internal.7.5.0","@fluidframework/container-loader":">=2.0.0-internal.7.4.4 <2.0.0-internal.7.5.0","@fluidframework/shared-object-base":">=2.0.0-internal.7.4.4 <2.0.0-internal.7.5.0","@fluidframework/protocol-definitions":"^3.0.0","@fluidframework/container-definitions":">=2.0.0-internal.7.4.4 <2.0.0-internal.7.5.0","@fluidframework/datastore-definitions":">=2.0.0-internal.7.4.4 <2.0.0-internal.7.5.0"},"_hasShrinkwrap":false,"readmeFilename":"README.md","typeValidation":{"broken":{}},"devDependencies":{"c8":"^7.7.1","chai":"^4.2.0","mocha":"^10.2.0","eslint":"~8.50.0","events":"^3.1.0","moment":"^2.21.0","rimraf":"^4.4.0","prettier":"~3.0.3","copyfiles":"^2.4.1","cross-env":"^7.0.3","typescript":"~5.1.6","@types/chai":"^4.0.0","@types/mocha":"^9.1.1","@types/events":"^3.0.0","mocha-multi-reporters":"^1.5.1","@fluid-tools/build-cli":"^0.28.0","eslint-config-prettier":"~9.0.0","@microsoft/api-extractor":"^7.38.3","eslint-plugin-chai-expect":"~3.0.0","mocha-json-output-reporter":"^2.0.1","@fluidframework/build-tools":"^0.28.0","@fluidframework/build-common":"^2.0.3","@fluidframework/mocha-test-setup":">=2.0.0-internal.7.4.4 <2.0.0-internal.7.5.0","@fluidframework/driver-definitions":">=2.0.0-internal.7.4.4 <2.0.0-internal.7.5.0","@fluidframework/test-runtime-utils":">=2.0.0-internal.7.4.4 <2.0.0-internal.7.5.0","@fluidframework/eslint-config-fluid":"^3.1.0","@fluid-experimental/devtools-core-previous":"npm:@fluid-experimental/devtools-core@2.0.0-internal.7.2.0"},"_npmOperationalInternal":{"tmp":"tmp/devtools-core_2.0.0-internal.7.4.4_1707246128886_0.650402077131127","host":"s3://npm-registry-packages"}},"2.0.0-internal.7.4.5":{"name":"@fluid-experimental/devtools-core","version":"2.0.0-internal.7.4.5","author":{"name":"Microsoft and contributors"},"license":"MIT","_id":"@fluid-experimental/devtools-core@2.0.0-internal.7.4.5","maintainers":[{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},{"name":"curtisman","email":"curtism@microsoft.com"}],"homepage":"https://fluidframework.com","bugs":{"url":"https://github.com/microsoft/FluidFramework/issues"},"c8":{"all":true,"exclude":["src/test/**/*.ts","dist/test/**/*.js"],"include":["src/**/*.ts","dist/**/*.js"],"reporter":["cobertura","html","text"],"cache-dir":"nyc/.cache","report-dir":"nyc/report","temp-directory":"nyc/.nyc_output","exclude-after-remap":false},"dist":{"shasum":"77d72dec1d1dbbcf0880ddf53ab99bbad8cded9d","tarball":"https://registry.npmjs.org/@fluid-experimental/devtools-core/-/devtools-core-2.0.0-internal.7.4.5.tgz","fileCount":510,"integrity":"sha512-20/WWQyb5+H/Gi/outj7Q9wRAXl6zvvr+Ru8Et+5g4/SE3bKioNpQ8g9y6dJG57fIELV2xvb5kmV1IGfCm7L6Q==","signatures":[{"sig":"MEUCIQDoHTnghuE9LliSy5MDANHSzLldg4lVTEpPZjw3o1rqIAIgAN+AwFeBiXdY8b1b+vp7ktzQArwbIixJqK78ZR/kJAY=","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}],"unpackedSize":1625178},"main":"dist/index.js","_from":"file:fluid-experimental-devtools-core-2.0.0-internal.7.4.5.tgz","types":"dist/index.d.ts","module":"lib/index.js","readme":"# @fluid-experimental/devtools-core\n\nThis library contains developer tools for use alongside the Fluid Framework.\nIt is used to power our associated [browser extension][browser-extension].\n\n- Chrome: \n- Edge: \n\n\n\n**IMPORTANT: This package is experimental.**\n**Its APIs may change without notice.**\n\n**Do not use in production scenarios.**\n\n\n\n\n\n\n\n\n## Installation\n\nTo get started, install the package by running the following command:\n\n```bash\nnpm i @fluid-experimental/devtools-core -D\n```\n\n\n\n\n\n## Usage\n\nThe Devtools' API surface is designed to fit nicely into most application flows.\n\n### Initialization\n\nTo initialize a devtools session for your container, call [`initializeDevtools`][initialize-devtools-docs].\nThis function accepts a `DevtoolsLogger` for receiving Fluid telemetry from your application, a list of initial Fluid\n`Containers` to associate with the session, and (optionally) customized data visualization configurations for visualizing\n`Container` data.\n\n#### About the [`DevtoolsLogger`][devtools-logger-docs]\n\nThe `DevtoolsLogger` is an optional piece when calling `initializeDevtools` but it is strongly recommended that you use\nit because several features in Fluid Devtools are powered by the telemetry that Fluid Framework generates, and this\nlogger is the way in which that telemetry gets into Fluid Devtools.\n\nYou can obtain a `DevtoolsLogger` by calling its constructor, and then should pass it to `initializeDevtools` _and_\nto the `Loader` instance you'll use to create/load Containers as shown below.\nThis way the logger will receive all the telemetry generated by Fluid Framework in your application, and forward it to\nFluid Devtools as necessary.\n\n```typescript\nimport { DevtoolsLogger, initializeDevtools } from \"@fluid-experimental/devtools-core\";\n\n// Instantiate the logger\nconst devtoolsLogger = new DevtoolsLogger();\n\n// Pass the logger when instantiating the Loader\nconst loader = new Loader({\n\tlogger: devtoolsLogger,\n\t// Other necessary properties ...\n});\n\n// Use the Loader to create (and optionally, attach) a Container\nconst container = await loader.createDetachedContainer(/* params */);\nawait container.attach(/* params */);\n\n// Initialize the Devtools passing the logger and your Container.\n// The Container could be added later as well with devtools.registerContainerDevtools().\nconst devtools = initializeDevtools({\n\tlogger: devtoolsLogger,\n\tinitialContainers: [\n\t\t{\n\t\t\tcontainer,\n\t\t\tcontainerKey: \"My Container\",\n\t\t},\n\t],\n});\n```\n\nIf you're working with `AzureClient` instead of lower-level APIs like the one described above, you probably want to\nrefer to the [@fluid-experimental/devtools package][devtools-package] instead of this one.\n\nDuring local development the recommendation is that your application should receive the `DevtoolsLogger` instance _instead_\nof any logger it would normally receive when deployed to a real environment, to avoid local development activity from\nmixing with real telemetry.\nIf you still want to provide a real application logger and use the Fluid Devtools features that are powered by telemetry\nat the same time, you can pass an existing logger to the `DevtoolsLogger` constructor and it will forward all telemetry\nit receives to that logger as well:\n\n```typescript\nimport { DevtoolsLogger } from \"@fluid-experimental/devtools-core\";\n\n// Your application's logger\nconst yourApplicationLogger = getInstanceOfYourApplicationLogger();\n\nconst devtoolsLogger = new DevtoolsLogger(yourApplicationLogger);\n\n// Pass devtoolsLogger to initializeDevtools() and to your application as described above\n```\n\n### Clean-up\n\nThe Devtools object is managed as a global singleton.\nThat singleton is automatically cleaned up prior to the Window's \"unload\" event.\nSo typical application flows likely won't need to worry about cleanup.\nThat said, if you wish to have tighter control over when the Devtools are torn down, you can simply call the `dispose` method on the handle returned by [initialization](#initialization).\n\n## Contributing to the package\n\n### Build\n\nTo build the package locally, first ensure you have run `pnpm install` from the root of the mono-repo.\nNext, to build the code, run `npm run build` from the root of the mono-repo, or use [fluid-build](https://github.com/microsoft/FluidFramework/tree/main/build-tools/packages/build-tools#running-fluid-build-command-line) via `fluid-build -t build`.\n\n- Note: Once you have run a build from the root, assuming no other changes outside of this package, you may run `npm run build` directly within this directory for a faster build.\n If you make changes to any of this package's local dependencies, you will need to run a build again from the root before building again from directly within this package.\n\n### Test\n\nTo run the tests, first ensure you have followed the [build](#build) steps above.\nNext, run `npm run test` from a terminal within this directory.\n\n\n\n\n\n\n\n## API Documentation\n\nAPI documentation for **@fluid-experimental/devtools-core** is available at .\n\n\n\n\n\n\n\n\n\n\n## Contribution Guidelines\n\nThere are many ways to [contribute](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md) to Fluid.\n\n- Participate in Q&A in our [GitHub Discussions](https://github.com/microsoft/FluidFramework/discussions).\n- [Submit bugs](https://github.com/microsoft/FluidFramework/issues) and help us verify fixes as they are checked in.\n- Review the [source code changes](https://github.com/microsoft/FluidFramework/pulls).\n- [Contribute bug fixes](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md).\n\nDetailed instructions for working in the repo can be found in the [Wiki](https://github.com/microsoft/FluidFramework/wiki).\n\nThis project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).\nFor more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\nUse of these trademarks or logos must follow Microsoft’s [Trademark & Brand Guidelines](https://www.microsoft.com/trademarks).\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n\n\n\n## Help\n\nNot finding what you're looking for in this README? Check out our [GitHub\nWiki](https://github.com/microsoft/FluidFramework/wiki) or [fluidframework.com](https://fluidframework.com/docs/).\n\nStill not finding what you're looking for? Please [file an\nissue](https://github.com/microsoft/FluidFramework/wiki/Submitting-Bugs-and-Feature-Requests).\n\nThank you!\n\n\n\n\n\n\n\n\n\n\n## Trademark\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\n\nUse of these trademarks or logos must follow Microsoft's [Trademark & Brand Guidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general).\n\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n[initialize-devtools-docs]: https://fluidframework.com/docs/apis/devtools-core#initializedevtools-function\n[devtools-logger-docs]: https://fluidframework.com/docs/apis/devtools-core/devtoolslogger-class\n[devtools-package]: https://www.npmjs.com/package/@fluid-experimental/devtools\n[browser-extension]: https://github.com/microsoft/FluidFramework/tree/main/packages/tools/devtools/devtools-browser-extension\n","scripts":{"api":"fluid-build . --task api","tsc":"tsc","lint":"npm run prettier && npm run check:release-tags && npm run eslint","test":"npm run test:mocha","build":"fluid-build . --task build","clean":"rimraf --glob _api-extractor-temp nyc dist lib \"**/*.tsbuildinfo\" \"**/*.build.log\"","eslint":"eslint src","format":"npm run prettier:fix","rebuild":"npm run clean && npm run build","lint:fix":"npm run prettier:fix && npm run eslint:fix","prettier":"prettier --check . --cache --ignore-path ../../../../.prettierignore","tsc:watch":"tsc --watch","build:docs":"fluid-build . --task api","eslint:fix":"eslint src --fix","test:mocha":"mocha \"dist/**/*.test.js\" --exit","build:esnext":"tsc --project ./tsconfig.esnext.json","build:genver":"gen-version","prettier:fix":"prettier --write . --cache --ignore-path ../../../../.prettierignore","build:compile":"fluid-build . --task compile","ci:build:docs":"api-extractor run","test:coverage":"c8 npm test","typetests:gen":"fluid-type-test-generator","build:commonjs":"fluid-build . --task commonjs","format-and-build":"npm run format && npm run build","typetests:prepare":"flub typetests --dir . --reset --previous --normalize","check:release-tags":"api-extractor run --local --config ./api-extractor-lint.json","format-and-compile":"npm run format && npm run build:compile","api-extractor:esnext":"copyfiles -u 1 \"dist/**/*-@(alpha|beta|public|untrimmed).d.ts\" lib","api-extractor:commonjs":"api-extractor run --local"},"_npmUser":{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},"_resolved":"/mnt/vss/_work/1/pack/scoped/fluid-experimental-devtools-core-2.0.0-internal.7.4.5.tgz","_integrity":"sha512-20/WWQyb5+H/Gi/outj7Q9wRAXl6zvvr+Ru8Et+5g4/SE3bKioNpQ8g9y6dJG57fIELV2xvb5kmV1IGfCm7L6Q==","fluidBuild":{"tasks":{"tsc":["...","typetests:gen"],"build:docs":{"script":false,"dependsOn":["...","api-extractor:commonjs","api-extractor:esnext"]}}},"repository":{"url":"git+https://github.com/microsoft/FluidFramework.git","type":"git","directory":"packages/tools/devtools/devtools-core"},"_npmVersion":"9.6.7","description":"Fluid Framework developer tools core functionality","directories":{},"sideEffects":false,"_nodeVersion":"18.17.1","dependencies":{"@fluidframework/map":">=2.0.0-internal.7.4.5 <2.0.0-internal.7.5.0","@fluidframework/cell":">=2.0.0-internal.7.4.5 <2.0.0-internal.7.5.0","@fluidframework/matrix":">=2.0.0-internal.7.4.5 <2.0.0-internal.7.5.0","@fluidframework/counter":">=2.0.0-internal.7.4.5 <2.0.0-internal.7.5.0","@fluidframework/sequence":">=2.0.0-internal.7.4.5 <2.0.0-internal.7.5.0","@fluid-experimental/tree2":">=2.0.0-internal.7.4.5 <2.0.0-internal.7.5.0","@fluid-internal/client-utils":">=2.0.0-internal.7.4.5 <2.0.0-internal.7.5.0","@fluidframework/core-interfaces":">=2.0.0-internal.7.4.5 <2.0.0-internal.7.5.0","@fluidframework/telemetry-utils":">=2.0.0-internal.7.4.5 <2.0.0-internal.7.5.0","@fluidframework/container-loader":">=2.0.0-internal.7.4.5 <2.0.0-internal.7.5.0","@fluidframework/shared-object-base":">=2.0.0-internal.7.4.5 <2.0.0-internal.7.5.0","@fluidframework/protocol-definitions":"^3.0.0","@fluidframework/container-definitions":">=2.0.0-internal.7.4.5 <2.0.0-internal.7.5.0","@fluidframework/datastore-definitions":">=2.0.0-internal.7.4.5 <2.0.0-internal.7.5.0"},"_hasShrinkwrap":false,"readmeFilename":"README.md","typeValidation":{"broken":{}},"devDependencies":{"c8":"^7.7.1","chai":"^4.2.0","mocha":"^10.2.0","eslint":"~8.50.0","events":"^3.1.0","moment":"^2.21.0","rimraf":"^4.4.0","prettier":"~3.0.3","copyfiles":"^2.4.1","cross-env":"^7.0.3","typescript":"~5.1.6","@types/chai":"^4.0.0","@types/mocha":"^9.1.1","@types/events":"^3.0.0","mocha-multi-reporters":"^1.5.1","@fluid-tools/build-cli":"^0.28.0","eslint-config-prettier":"~9.0.0","@microsoft/api-extractor":"^7.38.3","eslint-plugin-chai-expect":"~3.0.0","mocha-json-output-reporter":"^2.0.1","@fluidframework/build-tools":"^0.28.0","@fluidframework/build-common":"^2.0.3","@fluidframework/mocha-test-setup":">=2.0.0-internal.7.4.5 <2.0.0-internal.7.5.0","@fluidframework/driver-definitions":">=2.0.0-internal.7.4.5 <2.0.0-internal.7.5.0","@fluidframework/test-runtime-utils":">=2.0.0-internal.7.4.5 <2.0.0-internal.7.5.0","@fluidframework/eslint-config-fluid":"^3.1.0","@fluid-experimental/devtools-core-previous":"npm:@fluid-experimental/devtools-core@2.0.0-internal.7.2.0"},"_npmOperationalInternal":{"tmp":"tmp/devtools-core_2.0.0-internal.7.4.5_1707343897508_0.6365886498664839","host":"s3://npm-registry-packages"}},"2.0.0-internal.7.4.6":{"name":"@fluid-experimental/devtools-core","version":"2.0.0-internal.7.4.6","author":{"name":"Microsoft and contributors"},"license":"MIT","_id":"@fluid-experimental/devtools-core@2.0.0-internal.7.4.6","maintainers":[{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},{"name":"curtisman","email":"curtism@microsoft.com"}],"homepage":"https://fluidframework.com","bugs":{"url":"https://github.com/microsoft/FluidFramework/issues"},"c8":{"all":true,"exclude":["src/test/**/*.ts","dist/test/**/*.js"],"include":["src/**/*.ts","dist/**/*.js"],"reporter":["cobertura","html","text"],"cache-dir":"nyc/.cache","report-dir":"nyc/report","temp-directory":"nyc/.nyc_output","exclude-after-remap":false},"dist":{"shasum":"8e22d689e5520929ed286b9bec90ff44b4a9a97f","tarball":"https://registry.npmjs.org/@fluid-experimental/devtools-core/-/devtools-core-2.0.0-internal.7.4.6.tgz","fileCount":510,"integrity":"sha512-Pq2yYVH+N3qRdEgG3AjxbNMlDeJ2xkKUCLrANZFqBUcEVBigm+xMz0U1QNeGApD6Ml9/sDHcT9lFnEzfADwStg==","signatures":[{"sig":"MEUCIQDdNn6jiH55kDhaSigxyR72CVqjt00Swz4SnbVnMtsQwgIgE4KvisvcC/OMuspBvA+IXR3ZYTllNU1m3RzOslmmXnA=","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}],"unpackedSize":1625178},"main":"dist/index.js","_from":"file:fluid-experimental-devtools-core-2.0.0-internal.7.4.6.tgz","types":"dist/index.d.ts","module":"lib/index.js","readme":"# @fluid-experimental/devtools-core\n\nThis library contains developer tools for use alongside the Fluid Framework.\nIt is used to power our associated [browser extension][browser-extension].\n\n- Chrome: \n- Edge: \n\n\n\n**IMPORTANT: This package is experimental.**\n**Its APIs may change without notice.**\n\n**Do not use in production scenarios.**\n\n\n\n\n\n\n\n\n## Installation\n\nTo get started, install the package by running the following command:\n\n```bash\nnpm i @fluid-experimental/devtools-core -D\n```\n\n\n\n\n\n## Usage\n\nThe Devtools' API surface is designed to fit nicely into most application flows.\n\n### Initialization\n\nTo initialize a devtools session for your container, call [`initializeDevtools`][initialize-devtools-docs].\nThis function accepts a `DevtoolsLogger` for receiving Fluid telemetry from your application, a list of initial Fluid\n`Containers` to associate with the session, and (optionally) customized data visualization configurations for visualizing\n`Container` data.\n\n#### About the [`DevtoolsLogger`][devtools-logger-docs]\n\nThe `DevtoolsLogger` is an optional piece when calling `initializeDevtools` but it is strongly recommended that you use\nit because several features in Fluid Devtools are powered by the telemetry that Fluid Framework generates, and this\nlogger is the way in which that telemetry gets into Fluid Devtools.\n\nYou can obtain a `DevtoolsLogger` by calling its constructor, and then should pass it to `initializeDevtools` _and_\nto the `Loader` instance you'll use to create/load Containers as shown below.\nThis way the logger will receive all the telemetry generated by Fluid Framework in your application, and forward it to\nFluid Devtools as necessary.\n\n```typescript\nimport { DevtoolsLogger, initializeDevtools } from \"@fluid-experimental/devtools-core\";\n\n// Instantiate the logger\nconst devtoolsLogger = new DevtoolsLogger();\n\n// Pass the logger when instantiating the Loader\nconst loader = new Loader({\n\tlogger: devtoolsLogger,\n\t// Other necessary properties ...\n});\n\n// Use the Loader to create (and optionally, attach) a Container\nconst container = await loader.createDetachedContainer(/* params */);\nawait container.attach(/* params */);\n\n// Initialize the Devtools passing the logger and your Container.\n// The Container could be added later as well with devtools.registerContainerDevtools().\nconst devtools = initializeDevtools({\n\tlogger: devtoolsLogger,\n\tinitialContainers: [\n\t\t{\n\t\t\tcontainer,\n\t\t\tcontainerKey: \"My Container\",\n\t\t},\n\t],\n});\n```\n\nIf you're working with `AzureClient` instead of lower-level APIs like the one described above, you probably want to\nrefer to the [@fluid-experimental/devtools package][devtools-package] instead of this one.\n\nDuring local development the recommendation is that your application should receive the `DevtoolsLogger` instance _instead_\nof any logger it would normally receive when deployed to a real environment, to avoid local development activity from\nmixing with real telemetry.\nIf you still want to provide a real application logger and use the Fluid Devtools features that are powered by telemetry\nat the same time, you can pass an existing logger to the `DevtoolsLogger` constructor and it will forward all telemetry\nit receives to that logger as well:\n\n```typescript\nimport { DevtoolsLogger } from \"@fluid-experimental/devtools-core\";\n\n// Your application's logger\nconst yourApplicationLogger = getInstanceOfYourApplicationLogger();\n\nconst devtoolsLogger = new DevtoolsLogger(yourApplicationLogger);\n\n// Pass devtoolsLogger to initializeDevtools() and to your application as described above\n```\n\n### Clean-up\n\nThe Devtools object is managed as a global singleton.\nThat singleton is automatically cleaned up prior to the Window's \"unload\" event.\nSo typical application flows likely won't need to worry about cleanup.\nThat said, if you wish to have tighter control over when the Devtools are torn down, you can simply call the `dispose` method on the handle returned by [initialization](#initialization).\n\n## Contributing to the package\n\n### Build\n\nTo build the package locally, first ensure you have run `pnpm install` from the root of the mono-repo.\nNext, to build the code, run `npm run build` from the root of the mono-repo, or use [fluid-build](https://github.com/microsoft/FluidFramework/tree/main/build-tools/packages/build-tools#running-fluid-build-command-line) via `fluid-build -t build`.\n\n- Note: Once you have run a build from the root, assuming no other changes outside of this package, you may run `npm run build` directly within this directory for a faster build.\n If you make changes to any of this package's local dependencies, you will need to run a build again from the root before building again from directly within this package.\n\n### Test\n\nTo run the tests, first ensure you have followed the [build](#build) steps above.\nNext, run `npm run test` from a terminal within this directory.\n\n\n\n\n\n\n\n## API Documentation\n\nAPI documentation for **@fluid-experimental/devtools-core** is available at .\n\n\n\n\n\n\n\n\n\n\n## Contribution Guidelines\n\nThere are many ways to [contribute](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md) to Fluid.\n\n- Participate in Q&A in our [GitHub Discussions](https://github.com/microsoft/FluidFramework/discussions).\n- [Submit bugs](https://github.com/microsoft/FluidFramework/issues) and help us verify fixes as they are checked in.\n- Review the [source code changes](https://github.com/microsoft/FluidFramework/pulls).\n- [Contribute bug fixes](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md).\n\nDetailed instructions for working in the repo can be found in the [Wiki](https://github.com/microsoft/FluidFramework/wiki).\n\nThis project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).\nFor more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\nUse of these trademarks or logos must follow Microsoft’s [Trademark & Brand Guidelines](https://www.microsoft.com/trademarks).\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n\n\n\n## Help\n\nNot finding what you're looking for in this README? Check out our [GitHub\nWiki](https://github.com/microsoft/FluidFramework/wiki) or [fluidframework.com](https://fluidframework.com/docs/).\n\nStill not finding what you're looking for? Please [file an\nissue](https://github.com/microsoft/FluidFramework/wiki/Submitting-Bugs-and-Feature-Requests).\n\nThank you!\n\n\n\n\n\n\n\n\n\n\n## Trademark\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\n\nUse of these trademarks or logos must follow Microsoft's [Trademark & Brand Guidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general).\n\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n[initialize-devtools-docs]: https://fluidframework.com/docs/apis/devtools-core#initializedevtools-function\n[devtools-logger-docs]: https://fluidframework.com/docs/apis/devtools-core/devtoolslogger-class\n[devtools-package]: https://www.npmjs.com/package/@fluid-experimental/devtools\n[browser-extension]: https://github.com/microsoft/FluidFramework/tree/main/packages/tools/devtools/devtools-browser-extension\n","scripts":{"api":"fluid-build . --task api","tsc":"tsc","lint":"npm run prettier && npm run check:release-tags && npm run eslint","test":"npm run test:mocha","build":"fluid-build . --task build","clean":"rimraf --glob _api-extractor-temp nyc dist lib \"**/*.tsbuildinfo\" \"**/*.build.log\"","eslint":"eslint src","format":"npm run prettier:fix","rebuild":"npm run clean && npm run build","lint:fix":"npm run prettier:fix && npm run eslint:fix","prettier":"prettier --check . --cache --ignore-path ../../../../.prettierignore","tsc:watch":"tsc --watch","build:docs":"fluid-build . --task api","eslint:fix":"eslint src --fix","test:mocha":"mocha \"dist/**/*.test.js\" --exit","build:esnext":"tsc --project ./tsconfig.esnext.json","build:genver":"gen-version","prettier:fix":"prettier --write . --cache --ignore-path ../../../../.prettierignore","build:compile":"fluid-build . --task compile","ci:build:docs":"api-extractor run","test:coverage":"c8 npm test","typetests:gen":"fluid-type-test-generator","build:commonjs":"fluid-build . --task commonjs","format-and-build":"npm run format && npm run build","typetests:prepare":"flub typetests --dir . --reset --previous --normalize","check:release-tags":"api-extractor run --local --config ./api-extractor-lint.json","format-and-compile":"npm run format && npm run build:compile","api-extractor:esnext":"copyfiles -u 1 \"dist/**/*-@(alpha|beta|public|untrimmed).d.ts\" lib","api-extractor:commonjs":"api-extractor run --local"},"_npmUser":{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},"_resolved":"/mnt/vss/_work/1/pack/scoped/fluid-experimental-devtools-core-2.0.0-internal.7.4.6.tgz","_integrity":"sha512-Pq2yYVH+N3qRdEgG3AjxbNMlDeJ2xkKUCLrANZFqBUcEVBigm+xMz0U1QNeGApD6Ml9/sDHcT9lFnEzfADwStg==","fluidBuild":{"tasks":{"tsc":["...","typetests:gen"],"build:docs":{"script":false,"dependsOn":["...","api-extractor:commonjs","api-extractor:esnext"]}}},"repository":{"url":"git+https://github.com/microsoft/FluidFramework.git","type":"git","directory":"packages/tools/devtools/devtools-core"},"_npmVersion":"9.6.7","description":"Fluid Framework developer tools core functionality","directories":{},"sideEffects":false,"_nodeVersion":"18.17.1","dependencies":{"@fluidframework/map":">=2.0.0-internal.7.4.6 <2.0.0-internal.7.5.0","@fluidframework/cell":">=2.0.0-internal.7.4.6 <2.0.0-internal.7.5.0","@fluidframework/matrix":">=2.0.0-internal.7.4.6 <2.0.0-internal.7.5.0","@fluidframework/counter":">=2.0.0-internal.7.4.6 <2.0.0-internal.7.5.0","@fluidframework/sequence":">=2.0.0-internal.7.4.6 <2.0.0-internal.7.5.0","@fluid-experimental/tree2":">=2.0.0-internal.7.4.6 <2.0.0-internal.7.5.0","@fluid-internal/client-utils":">=2.0.0-internal.7.4.6 <2.0.0-internal.7.5.0","@fluidframework/core-interfaces":">=2.0.0-internal.7.4.6 <2.0.0-internal.7.5.0","@fluidframework/telemetry-utils":">=2.0.0-internal.7.4.6 <2.0.0-internal.7.5.0","@fluidframework/container-loader":">=2.0.0-internal.7.4.6 <2.0.0-internal.7.5.0","@fluidframework/shared-object-base":">=2.0.0-internal.7.4.6 <2.0.0-internal.7.5.0","@fluidframework/protocol-definitions":"^3.0.0","@fluidframework/container-definitions":">=2.0.0-internal.7.4.6 <2.0.0-internal.7.5.0","@fluidframework/datastore-definitions":">=2.0.0-internal.7.4.6 <2.0.0-internal.7.5.0"},"_hasShrinkwrap":false,"readmeFilename":"README.md","typeValidation":{"broken":{}},"devDependencies":{"c8":"^7.7.1","chai":"^4.2.0","mocha":"^10.2.0","eslint":"~8.50.0","events":"^3.1.0","moment":"^2.21.0","rimraf":"^4.4.0","prettier":"~3.0.3","copyfiles":"^2.4.1","cross-env":"^7.0.3","typescript":"~5.1.6","@types/chai":"^4.0.0","@types/mocha":"^9.1.1","@types/events":"^3.0.0","mocha-multi-reporters":"^1.5.1","@fluid-tools/build-cli":"^0.28.0","eslint-config-prettier":"~9.0.0","@microsoft/api-extractor":"^7.38.3","eslint-plugin-chai-expect":"~3.0.0","mocha-json-output-reporter":"^2.0.1","@fluidframework/build-tools":"^0.28.0","@fluidframework/build-common":"^2.0.3","@fluidframework/mocha-test-setup":">=2.0.0-internal.7.4.6 <2.0.0-internal.7.5.0","@fluidframework/driver-definitions":">=2.0.0-internal.7.4.6 <2.0.0-internal.7.5.0","@fluidframework/test-runtime-utils":">=2.0.0-internal.7.4.6 <2.0.0-internal.7.5.0","@fluidframework/eslint-config-fluid":"^3.1.0","@fluid-experimental/devtools-core-previous":"npm:@fluid-experimental/devtools-core@2.0.0-internal.7.2.0"},"_npmOperationalInternal":{"tmp":"tmp/devtools-core_2.0.0-internal.7.4.6_1707353839650_0.3062234901898322","host":"s3://npm-registry-packages"}},"2.0.0-internal.8.0.5":{"name":"@fluid-experimental/devtools-core","version":"2.0.0-internal.8.0.5","author":{"name":"Microsoft and contributors"},"license":"MIT","_id":"@fluid-experimental/devtools-core@2.0.0-internal.8.0.5","maintainers":[{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},{"name":"curtisman","email":"curtism@microsoft.com"}],"homepage":"https://fluidframework.com","bugs":{"url":"https://github.com/microsoft/FluidFramework/issues"},"c8":{"all":true,"exclude":["src/test/**/*.ts","dist/test/**/*.js"],"include":["src/**/*.ts","dist/**/*.js"],"reporter":["cobertura","html","text"],"cache-dir":"nyc/.cache","report-dir":"nyc/report","temp-directory":"nyc/.nyc_output","exclude-after-remap":false},"dist":{"shasum":"3800cfac8c4e6fea042a87d7c8b71bb2555a00d6","tarball":"https://registry.npmjs.org/@fluid-experimental/devtools-core/-/devtools-core-2.0.0-internal.8.0.5.tgz","fileCount":510,"integrity":"sha512-XL+F2IbqOEMOGTMdWz06bP5dN14vMup67zIf7nVs7cPMo3edVwPgjlVK9UFt0CV91QqNbXsHkuer998bid1GeQ==","signatures":[{"sig":"MEUCIQD//9vjCS1S3bW437gQbqpXOAXhsoHQU5bv+2fstwNrKgIgZfS3J6hwBrLjDOgxAXjD+HqsBLOSkjqpCNu3dyf2G4s=","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}],"unpackedSize":1629472},"main":"dist/index.js","_from":"file:fluid-experimental-devtools-core-2.0.0-internal.8.0.5.tgz","types":"dist/index.d.ts","module":"lib/index.js","readme":"# @fluid-experimental/devtools-core\n\nThis library contains developer tools for use alongside the Fluid Framework.\nIt is used to power our associated [browser extension][browser-extension].\n\n- Chrome: \n- Edge: \n\n\n\n**IMPORTANT: This package is experimental.**\n**Its APIs may change without notice.**\n\n**Do not use in production scenarios.**\n\n\n\n\n\n\n\n\n## Installation\n\nTo get started, install the package by running the following command:\n\n```bash\nnpm i @fluid-experimental/devtools-core -D\n```\n\n\n\n\n\n## Usage\n\nThe Devtools' API surface is designed to fit nicely into most application flows.\n\n### Initialization\n\nTo initialize a devtools session for your container, call [`initializeDevtools`][initialize-devtools-docs].\nThis function accepts a `DevtoolsLogger` for receiving Fluid telemetry from your application, a list of initial Fluid\n`Containers` to associate with the session, and (optionally) customized data visualization configurations for visualizing\n`Container` data.\n\n#### About the [`DevtoolsLogger`][devtools-logger-docs]\n\nThe `DevtoolsLogger` is an optional piece when calling `initializeDevtools` but it is strongly recommended that you use\nit because several features in Fluid Devtools are powered by the telemetry that Fluid Framework generates, and this\nlogger is the way in which that telemetry gets into Fluid Devtools.\n\nYou can obtain a `DevtoolsLogger` by calling its constructor, and then should pass it to `initializeDevtools` _and_\nto the `Loader` instance you'll use to create/load Containers as shown below.\nThis way the logger will receive all the telemetry generated by Fluid Framework in your application, and forward it to\nFluid Devtools as necessary.\n\n```typescript\nimport { DevtoolsLogger, initializeDevtools } from \"@fluid-experimental/devtools-core\";\n\n// Instantiate the logger\nconst devtoolsLogger = new DevtoolsLogger();\n\n// Pass the logger when instantiating the Loader\nconst loader = new Loader({\n\tlogger: devtoolsLogger,\n\t// Other necessary properties ...\n});\n\n// Use the Loader to create (and optionally, attach) a Container\nconst container = await loader.createDetachedContainer(/* params */);\nawait container.attach(/* params */);\n\n// Initialize the Devtools passing the logger and your Container.\n// The Container could be added later as well with devtools.registerContainerDevtools().\nconst devtools = initializeDevtools({\n\tlogger: devtoolsLogger,\n\tinitialContainers: [\n\t\t{\n\t\t\tcontainer,\n\t\t\tcontainerKey: \"My Container\",\n\t\t},\n\t],\n});\n```\n\nIf you're working with `AzureClient` instead of lower-level APIs like the one described above, you probably want to\nrefer to the [@fluid-experimental/devtools package][devtools-package] instead of this one.\n\nDuring local development the recommendation is that your application should receive the `DevtoolsLogger` instance _instead_\nof any logger it would normally receive when deployed to a real environment, to avoid local development activity from\nmixing with real telemetry.\nIf you still want to provide a real application logger and use the Fluid Devtools features that are powered by telemetry\nat the same time, you can pass an existing logger to the `DevtoolsLogger` constructor and it will forward all telemetry\nit receives to that logger as well:\n\n```typescript\nimport { DevtoolsLogger } from \"@fluid-experimental/devtools-core\";\n\n// Your application's logger\nconst yourApplicationLogger = getInstanceOfYourApplicationLogger();\n\nconst devtoolsLogger = new DevtoolsLogger(yourApplicationLogger);\n\n// Pass devtoolsLogger to initializeDevtools() and to your application as described above\n```\n\n### Clean-up\n\nThe Devtools object is managed as a global singleton.\nThat singleton is automatically cleaned up prior to the Window's \"unload\" event.\nSo typical application flows likely won't need to worry about cleanup.\nThat said, if you wish to have tighter control over when the Devtools are torn down, you can simply call the `dispose` method on the handle returned by [initialization](#initialization).\n\n## Contributing to the package\n\n### Build\n\nTo build the package locally, first ensure you have run `pnpm install` from the root of the mono-repo.\nNext, to build the code, run `npm run build` from the root of the mono-repo, or use [fluid-build](https://github.com/microsoft/FluidFramework/tree/main/build-tools/packages/build-tools#running-fluid-build-command-line) via `fluid-build -t build`.\n\n- Note: Once you have run a build from the root, assuming no other changes outside of this package, you may run `npm run build` directly within this directory for a faster build.\n If you make changes to any of this package's local dependencies, you will need to run a build again from the root before building again from directly within this package.\n\n### Test\n\nTo run the tests, first ensure you have followed the [build](#build) steps above.\nNext, run `npm run test` from a terminal within this directory.\n\n\n\n\n\n\n\n## API Documentation\n\nAPI documentation for **@fluid-experimental/devtools-core** is available at .\n\n\n\n\n\n\n\n\n\n\n## Contribution Guidelines\n\nThere are many ways to [contribute](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md) to Fluid.\n\n- Participate in Q&A in our [GitHub Discussions](https://github.com/microsoft/FluidFramework/discussions).\n- [Submit bugs](https://github.com/microsoft/FluidFramework/issues) and help us verify fixes as they are checked in.\n- Review the [source code changes](https://github.com/microsoft/FluidFramework/pulls).\n- [Contribute bug fixes](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md).\n\nDetailed instructions for working in the repo can be found in the [Wiki](https://github.com/microsoft/FluidFramework/wiki).\n\nThis project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).\nFor more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\nUse of these trademarks or logos must follow Microsoft’s [Trademark & Brand Guidelines](https://www.microsoft.com/trademarks).\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n\n\n\n## Help\n\nNot finding what you're looking for in this README? Check out our [GitHub\nWiki](https://github.com/microsoft/FluidFramework/wiki) or [fluidframework.com](https://fluidframework.com/docs/).\n\nStill not finding what you're looking for? Please [file an\nissue](https://github.com/microsoft/FluidFramework/wiki/Submitting-Bugs-and-Feature-Requests).\n\nThank you!\n\n\n\n\n\n\n\n\n\n\n## Trademark\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\n\nUse of these trademarks or logos must follow Microsoft's [Trademark & Brand Guidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general).\n\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n[initialize-devtools-docs]: https://fluidframework.com/docs/apis/devtools-core#initializedevtools-function\n[devtools-logger-docs]: https://fluidframework.com/docs/apis/devtools-core/devtoolslogger-class\n[devtools-package]: https://www.npmjs.com/package/@fluid-experimental/devtools\n[browser-extension]: https://github.com/microsoft/FluidFramework/tree/main/packages/tools/devtools/devtools-browser-extension\n","scripts":{"api":"fluid-build . --task api","tsc":"tsc","lint":"npm run prettier && npm run check:release-tags && npm run eslint","test":"npm run test:mocha","build":"fluid-build . --task build","clean":"rimraf --glob _api-extractor-temp nyc dist lib \"**/*.tsbuildinfo\" \"**/*.build.log\"","eslint":"eslint src","format":"npm run prettier:fix","rebuild":"npm run clean && npm run build","lint:fix":"npm run prettier:fix && npm run eslint:fix","prettier":"prettier --check . --cache --ignore-path ../../../../.prettierignore","tsc:watch":"tsc --watch","build:docs":"fluid-build . --task api","eslint:fix":"eslint src --fix","test:mocha":"mocha \"dist/**/*.test.js\" --exit","build:esnext":"tsc --project ./tsconfig.esnext.json","build:genver":"gen-version","prettier:fix":"prettier --write . --cache --ignore-path ../../../../.prettierignore","build:compile":"fluid-build . --task compile","ci:build:docs":"api-extractor run","test:coverage":"c8 npm test","typetests:gen":"fluid-type-test-generator","build:commonjs":"fluid-build . --task commonjs","format-and-build":"npm run format && npm run build","typetests:prepare":"flub typetests --dir . --reset --previous --normalize","check:release-tags":"api-extractor run --local --config ./api-extractor-lint.json","format-and-compile":"npm run format && npm run build:compile","api-extractor:esnext":"copyfiles -u 1 \"dist/**/*-@(alpha|beta|public|untrimmed).d.ts\" lib","api-extractor:commonjs":"api-extractor run --local"},"_npmUser":{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},"_resolved":"/mnt/vss/_work/1/pack/scoped/fluid-experimental-devtools-core-2.0.0-internal.8.0.5.tgz","_integrity":"sha512-XL+F2IbqOEMOGTMdWz06bP5dN14vMup67zIf7nVs7cPMo3edVwPgjlVK9UFt0CV91QqNbXsHkuer998bid1GeQ==","fluidBuild":{"tasks":{"tsc":["...","typetests:gen"],"build:docs":{"script":false,"dependsOn":["...","api-extractor:commonjs","api-extractor:esnext"]}}},"repository":{"url":"git+https://github.com/microsoft/FluidFramework.git","type":"git","directory":"packages/tools/devtools/devtools-core"},"_npmVersion":"9.6.7","description":"Fluid Framework developer tools core functionality","directories":{},"sideEffects":false,"_nodeVersion":"18.17.1","dependencies":{"@fluidframework/map":">=2.0.0-internal.8.0.5 <2.0.0-internal.8.1.0","@fluidframework/cell":">=2.0.0-internal.8.0.5 <2.0.0-internal.8.1.0","@fluidframework/matrix":">=2.0.0-internal.8.0.5 <2.0.0-internal.8.1.0","@fluidframework/counter":">=2.0.0-internal.8.0.5 <2.0.0-internal.8.1.0","@fluidframework/sequence":">=2.0.0-internal.8.0.5 <2.0.0-internal.8.1.0","@fluid-experimental/tree2":">=2.0.0-internal.8.0.5 <2.0.0-internal.8.1.0","@fluid-internal/client-utils":">=2.0.0-internal.8.0.5 <2.0.0-internal.8.1.0","@fluidframework/core-interfaces":">=2.0.0-internal.8.0.5 <2.0.0-internal.8.1.0","@fluidframework/telemetry-utils":">=2.0.0-internal.8.0.5 <2.0.0-internal.8.1.0","@fluidframework/container-loader":">=2.0.0-internal.8.0.5 <2.0.0-internal.8.1.0","@fluidframework/shared-object-base":">=2.0.0-internal.8.0.5 <2.0.0-internal.8.1.0","@fluidframework/protocol-definitions":"^3.0.0","@fluidframework/container-definitions":">=2.0.0-internal.8.0.5 <2.0.0-internal.8.1.0","@fluidframework/datastore-definitions":">=2.0.0-internal.8.0.5 <2.0.0-internal.8.1.0"},"_hasShrinkwrap":false,"readmeFilename":"README.md","typeValidation":{"broken":{"TypeAliasDeclaration_Primitive":{"forwardCompat":false},"TypeAliasDeclaration_VisualNode":{"forwardCompat":false},"InterfaceDeclaration_TreeNodeBase":{"forwardCompat":false},"InterfaceDeclaration_ValueNodeBase":{"forwardCompat":false},"InterfaceDeclaration_VisualNodeBase":{"forwardCompat":false},"InterfaceDeclaration_VisualTreeNode":{"forwardCompat":false},"TypeAliasDeclaration_RootHandleNode":{"forwardCompat":false},"InterfaceDeclaration_FluidHandleNode":{"forwardCompat":false},"InterfaceDeclaration_VisualValueNode":{"forwardCompat":false},"TypeAliasDeclaration_VisualChildNode":{"forwardCompat":false},"InterfaceDeclaration_UnknownObjectNode":{"forwardCompat":false},"InterfaceDeclaration_FluidDevtoolsProps":{"backCompat":false},"InterfaceDeclaration_FluidObjectNodeBase":{"forwardCompat":false},"InterfaceDeclaration_ContainerDevtoolsProps":{"backCompat":false}}},"devDependencies":{"c8":"^7.7.1","chai":"^4.2.0","mocha":"^10.2.0","eslint":"~8.50.0","events":"^3.1.0","moment":"^2.21.0","rimraf":"^4.4.0","prettier":"~3.0.3","copyfiles":"^2.4.1","cross-env":"^7.0.3","typescript":"~5.1.6","@types/chai":"^4.0.0","@types/mocha":"^9.1.1","@types/events":"^3.0.0","mocha-multi-reporters":"^1.5.1","@fluid-tools/build-cli":"^0.28.0","eslint-config-prettier":"~9.0.0","@microsoft/api-extractor":"^7.38.3","eslint-plugin-chai-expect":"~3.0.0","mocha-json-output-reporter":"^2.0.1","@fluidframework/build-tools":"^0.28.0","@fluidframework/build-common":"^2.0.3","@fluidframework/mocha-test-setup":">=2.0.0-internal.8.0.5 <2.0.0-internal.8.1.0","@fluidframework/driver-definitions":">=2.0.0-internal.8.0.5 <2.0.0-internal.8.1.0","@fluidframework/test-runtime-utils":">=2.0.0-internal.8.0.5 <2.0.0-internal.8.1.0","@fluidframework/eslint-config-fluid":"^3.1.0","@fluid-experimental/devtools-core-previous":"npm:@fluid-experimental/devtools-core@2.0.0-internal.7.2.0"},"_npmOperationalInternal":{"tmp":"tmp/devtools-core_2.0.0-internal.8.0.5_1707420696838_0.9760752150429877","host":"s3://npm-registry-packages"}},"2.0.0-internal.8.0.6":{"name":"@fluid-experimental/devtools-core","version":"2.0.0-internal.8.0.6","author":{"name":"Microsoft and contributors"},"license":"MIT","_id":"@fluid-experimental/devtools-core@2.0.0-internal.8.0.6","maintainers":[{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},{"name":"curtisman","email":"curtism@microsoft.com"}],"homepage":"https://fluidframework.com","bugs":{"url":"https://github.com/microsoft/FluidFramework/issues"},"c8":{"all":true,"exclude":["src/test/**/*.ts","dist/test/**/*.js"],"include":["src/**/*.ts","dist/**/*.js"],"reporter":["cobertura","html","text"],"cache-dir":"nyc/.cache","report-dir":"nyc/report","temp-directory":"nyc/.nyc_output","exclude-after-remap":false},"dist":{"shasum":"7ce0c8c9555eae5ce796833fdac42e8a2ce2c9ca","tarball":"https://registry.npmjs.org/@fluid-experimental/devtools-core/-/devtools-core-2.0.0-internal.8.0.6.tgz","fileCount":510,"integrity":"sha512-zsfmUI4vB6zTqr8RZniuc/8wttc2m8PoXlv5kU9N0FG6mNP8qcPz2uevtbUvU7pimSqj2WFLz+LHfdaIYnfrQg==","signatures":[{"sig":"MEUCIQCzZq3Cyh7pGQpQ1R0nT1PvaOIz0PgZny67wT5Cxsee7QIgXWyDQwCf+qJGkgckEktNflIbPYKcFfqL0mWQLAt53Fk=","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}],"unpackedSize":1629472},"main":"dist/index.js","_from":"file:fluid-experimental-devtools-core-2.0.0-internal.8.0.6.tgz","types":"dist/index.d.ts","module":"lib/index.js","readme":"# @fluid-experimental/devtools-core\n\nThis library contains developer tools for use alongside the Fluid Framework.\nIt is used to power our associated [browser extension][browser-extension].\n\n- Chrome: \n- Edge: \n\n\n\n**IMPORTANT: This package is experimental.**\n**Its APIs may change without notice.**\n\n**Do not use in production scenarios.**\n\n\n\n\n\n\n\n\n## Installation\n\nTo get started, install the package by running the following command:\n\n```bash\nnpm i @fluid-experimental/devtools-core -D\n```\n\n\n\n\n\n## Usage\n\nThe Devtools' API surface is designed to fit nicely into most application flows.\n\n### Initialization\n\nTo initialize a devtools session for your container, call [`initializeDevtools`][initialize-devtools-docs].\nThis function accepts a `DevtoolsLogger` for receiving Fluid telemetry from your application, a list of initial Fluid\n`Containers` to associate with the session, and (optionally) customized data visualization configurations for visualizing\n`Container` data.\n\n#### About the [`DevtoolsLogger`][devtools-logger-docs]\n\nThe `DevtoolsLogger` is an optional piece when calling `initializeDevtools` but it is strongly recommended that you use\nit because several features in Fluid Devtools are powered by the telemetry that Fluid Framework generates, and this\nlogger is the way in which that telemetry gets into Fluid Devtools.\n\nYou can obtain a `DevtoolsLogger` by calling its constructor, and then should pass it to `initializeDevtools` _and_\nto the `Loader` instance you'll use to create/load Containers as shown below.\nThis way the logger will receive all the telemetry generated by Fluid Framework in your application, and forward it to\nFluid Devtools as necessary.\n\n```typescript\nimport { DevtoolsLogger, initializeDevtools } from \"@fluid-experimental/devtools-core\";\n\n// Instantiate the logger\nconst devtoolsLogger = new DevtoolsLogger();\n\n// Pass the logger when instantiating the Loader\nconst loader = new Loader({\n\tlogger: devtoolsLogger,\n\t// Other necessary properties ...\n});\n\n// Use the Loader to create (and optionally, attach) a Container\nconst container = await loader.createDetachedContainer(/* params */);\nawait container.attach(/* params */);\n\n// Initialize the Devtools passing the logger and your Container.\n// The Container could be added later as well with devtools.registerContainerDevtools().\nconst devtools = initializeDevtools({\n\tlogger: devtoolsLogger,\n\tinitialContainers: [\n\t\t{\n\t\t\tcontainer,\n\t\t\tcontainerKey: \"My Container\",\n\t\t},\n\t],\n});\n```\n\nIf you're working with `AzureClient` instead of lower-level APIs like the one described above, you probably want to\nrefer to the [@fluid-experimental/devtools package][devtools-package] instead of this one.\n\nDuring local development the recommendation is that your application should receive the `DevtoolsLogger` instance _instead_\nof any logger it would normally receive when deployed to a real environment, to avoid local development activity from\nmixing with real telemetry.\nIf you still want to provide a real application logger and use the Fluid Devtools features that are powered by telemetry\nat the same time, you can pass an existing logger to the `DevtoolsLogger` constructor and it will forward all telemetry\nit receives to that logger as well:\n\n```typescript\nimport { DevtoolsLogger } from \"@fluid-experimental/devtools-core\";\n\n// Your application's logger\nconst yourApplicationLogger = getInstanceOfYourApplicationLogger();\n\nconst devtoolsLogger = new DevtoolsLogger(yourApplicationLogger);\n\n// Pass devtoolsLogger to initializeDevtools() and to your application as described above\n```\n\n### Clean-up\n\nThe Devtools object is managed as a global singleton.\nThat singleton is automatically cleaned up prior to the Window's \"unload\" event.\nSo typical application flows likely won't need to worry about cleanup.\nThat said, if you wish to have tighter control over when the Devtools are torn down, you can simply call the `dispose` method on the handle returned by [initialization](#initialization).\n\n## Contributing to the package\n\n### Build\n\nTo build the package locally, first ensure you have run `pnpm install` from the root of the mono-repo.\nNext, to build the code, run `npm run build` from the root of the mono-repo, or use [fluid-build](https://github.com/microsoft/FluidFramework/tree/main/build-tools/packages/build-tools#running-fluid-build-command-line) via `fluid-build -t build`.\n\n- Note: Once you have run a build from the root, assuming no other changes outside of this package, you may run `npm run build` directly within this directory for a faster build.\n If you make changes to any of this package's local dependencies, you will need to run a build again from the root before building again from directly within this package.\n\n### Test\n\nTo run the tests, first ensure you have followed the [build](#build) steps above.\nNext, run `npm run test` from a terminal within this directory.\n\n\n\n\n\n\n\n## API Documentation\n\nAPI documentation for **@fluid-experimental/devtools-core** is available at .\n\n\n\n\n\n\n\n\n\n\n## Contribution Guidelines\n\nThere are many ways to [contribute](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md) to Fluid.\n\n- Participate in Q&A in our [GitHub Discussions](https://github.com/microsoft/FluidFramework/discussions).\n- [Submit bugs](https://github.com/microsoft/FluidFramework/issues) and help us verify fixes as they are checked in.\n- Review the [source code changes](https://github.com/microsoft/FluidFramework/pulls).\n- [Contribute bug fixes](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md).\n\nDetailed instructions for working in the repo can be found in the [Wiki](https://github.com/microsoft/FluidFramework/wiki).\n\nThis project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).\nFor more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\nUse of these trademarks or logos must follow Microsoft’s [Trademark & Brand Guidelines](https://www.microsoft.com/trademarks).\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n\n\n\n## Help\n\nNot finding what you're looking for in this README? Check out our [GitHub\nWiki](https://github.com/microsoft/FluidFramework/wiki) or [fluidframework.com](https://fluidframework.com/docs/).\n\nStill not finding what you're looking for? Please [file an\nissue](https://github.com/microsoft/FluidFramework/wiki/Submitting-Bugs-and-Feature-Requests).\n\nThank you!\n\n\n\n\n\n\n\n\n\n\n## Trademark\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\n\nUse of these trademarks or logos must follow Microsoft's [Trademark & Brand Guidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general).\n\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n[initialize-devtools-docs]: https://fluidframework.com/docs/apis/devtools-core#initializedevtools-function\n[devtools-logger-docs]: https://fluidframework.com/docs/apis/devtools-core/devtoolslogger-class\n[devtools-package]: https://www.npmjs.com/package/@fluid-experimental/devtools\n[browser-extension]: https://github.com/microsoft/FluidFramework/tree/main/packages/tools/devtools/devtools-browser-extension\n","scripts":{"api":"fluid-build . --task api","tsc":"tsc","lint":"npm run prettier && npm run check:release-tags && npm run eslint","test":"npm run test:mocha","build":"fluid-build . --task build","clean":"rimraf --glob _api-extractor-temp nyc dist lib \"**/*.tsbuildinfo\" \"**/*.build.log\"","eslint":"eslint src","format":"npm run prettier:fix","rebuild":"npm run clean && npm run build","lint:fix":"npm run prettier:fix && npm run eslint:fix","prettier":"prettier --check . --cache --ignore-path ../../../../.prettierignore","tsc:watch":"tsc --watch","build:docs":"fluid-build . --task api","eslint:fix":"eslint src --fix","test:mocha":"mocha \"dist/**/*.test.js\" --exit","build:esnext":"tsc --project ./tsconfig.esnext.json","build:genver":"gen-version","prettier:fix":"prettier --write . --cache --ignore-path ../../../../.prettierignore","build:compile":"fluid-build . --task compile","ci:build:docs":"api-extractor run","test:coverage":"c8 npm test","typetests:gen":"fluid-type-test-generator","build:commonjs":"fluid-build . --task commonjs","format-and-build":"npm run format && npm run build","typetests:prepare":"flub typetests --dir . --reset --previous --normalize","check:release-tags":"api-extractor run --local --config ./api-extractor-lint.json","format-and-compile":"npm run format && npm run build:compile","api-extractor:esnext":"copyfiles -u 1 \"dist/**/*-@(alpha|beta|public|untrimmed).d.ts\" lib","api-extractor:commonjs":"api-extractor run --local"},"_npmUser":{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},"_resolved":"/mnt/vss/_work/1/pack/scoped/fluid-experimental-devtools-core-2.0.0-internal.8.0.6.tgz","_integrity":"sha512-zsfmUI4vB6zTqr8RZniuc/8wttc2m8PoXlv5kU9N0FG6mNP8qcPz2uevtbUvU7pimSqj2WFLz+LHfdaIYnfrQg==","fluidBuild":{"tasks":{"tsc":["...","typetests:gen"],"build:docs":{"script":false,"dependsOn":["...","api-extractor:commonjs","api-extractor:esnext"]}}},"repository":{"url":"git+https://github.com/microsoft/FluidFramework.git","type":"git","directory":"packages/tools/devtools/devtools-core"},"_npmVersion":"9.6.7","description":"Fluid Framework developer tools core functionality","directories":{},"sideEffects":false,"_nodeVersion":"18.17.1","dependencies":{"@fluidframework/map":">=2.0.0-internal.8.0.6 <2.0.0-internal.8.1.0","@fluidframework/cell":">=2.0.0-internal.8.0.6 <2.0.0-internal.8.1.0","@fluidframework/matrix":">=2.0.0-internal.8.0.6 <2.0.0-internal.8.1.0","@fluidframework/counter":">=2.0.0-internal.8.0.6 <2.0.0-internal.8.1.0","@fluidframework/sequence":">=2.0.0-internal.8.0.6 <2.0.0-internal.8.1.0","@fluid-experimental/tree2":">=2.0.0-internal.8.0.6 <2.0.0-internal.8.1.0","@fluid-internal/client-utils":">=2.0.0-internal.8.0.6 <2.0.0-internal.8.1.0","@fluidframework/core-interfaces":">=2.0.0-internal.8.0.6 <2.0.0-internal.8.1.0","@fluidframework/telemetry-utils":">=2.0.0-internal.8.0.6 <2.0.0-internal.8.1.0","@fluidframework/container-loader":">=2.0.0-internal.8.0.6 <2.0.0-internal.8.1.0","@fluidframework/shared-object-base":">=2.0.0-internal.8.0.6 <2.0.0-internal.8.1.0","@fluidframework/protocol-definitions":"^3.0.0","@fluidframework/container-definitions":">=2.0.0-internal.8.0.6 <2.0.0-internal.8.1.0","@fluidframework/datastore-definitions":">=2.0.0-internal.8.0.6 <2.0.0-internal.8.1.0"},"_hasShrinkwrap":false,"readmeFilename":"README.md","typeValidation":{"broken":{"TypeAliasDeclaration_Primitive":{"forwardCompat":false},"TypeAliasDeclaration_VisualNode":{"forwardCompat":false},"InterfaceDeclaration_TreeNodeBase":{"forwardCompat":false},"InterfaceDeclaration_ValueNodeBase":{"forwardCompat":false},"InterfaceDeclaration_VisualNodeBase":{"forwardCompat":false},"InterfaceDeclaration_VisualTreeNode":{"forwardCompat":false},"TypeAliasDeclaration_RootHandleNode":{"forwardCompat":false},"InterfaceDeclaration_FluidHandleNode":{"forwardCompat":false},"InterfaceDeclaration_VisualValueNode":{"forwardCompat":false},"TypeAliasDeclaration_VisualChildNode":{"forwardCompat":false},"InterfaceDeclaration_UnknownObjectNode":{"forwardCompat":false},"InterfaceDeclaration_FluidDevtoolsProps":{"backCompat":false},"InterfaceDeclaration_FluidObjectNodeBase":{"forwardCompat":false},"InterfaceDeclaration_ContainerDevtoolsProps":{"backCompat":false}}},"devDependencies":{"c8":"^7.7.1","chai":"^4.2.0","mocha":"^10.2.0","eslint":"~8.50.0","events":"^3.1.0","moment":"^2.21.0","rimraf":"^4.4.0","prettier":"~3.0.3","copyfiles":"^2.4.1","cross-env":"^7.0.3","typescript":"~5.1.6","@types/chai":"^4.0.0","@types/mocha":"^9.1.1","@types/events":"^3.0.0","mocha-multi-reporters":"^1.5.1","@fluid-tools/build-cli":"^0.28.0","eslint-config-prettier":"~9.0.0","@microsoft/api-extractor":"^7.38.3","eslint-plugin-chai-expect":"~3.0.0","mocha-json-output-reporter":"^2.0.1","@fluidframework/build-tools":"^0.28.0","@fluidframework/build-common":"^2.0.3","@fluidframework/mocha-test-setup":">=2.0.0-internal.8.0.6 <2.0.0-internal.8.1.0","@fluidframework/driver-definitions":">=2.0.0-internal.8.0.6 <2.0.0-internal.8.1.0","@fluidframework/test-runtime-utils":">=2.0.0-internal.8.0.6 <2.0.0-internal.8.1.0","@fluidframework/eslint-config-fluid":"^3.1.0","@fluid-experimental/devtools-core-previous":"npm:@fluid-experimental/devtools-core@2.0.0-internal.7.2.0"},"_npmOperationalInternal":{"tmp":"tmp/devtools-core_2.0.0-internal.8.0.6_1707783236265_0.3914755270579313","host":"s3://npm-registry-packages"}},"2.0.0-internal.7.4.7":{"name":"@fluid-experimental/devtools-core","version":"2.0.0-internal.7.4.7","author":{"name":"Microsoft and contributors"},"license":"MIT","_id":"@fluid-experimental/devtools-core@2.0.0-internal.7.4.7","maintainers":[{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},{"name":"curtisman","email":"curtism@microsoft.com"}],"homepage":"https://fluidframework.com","bugs":{"url":"https://github.com/microsoft/FluidFramework/issues"},"c8":{"all":true,"exclude":["src/test/**/*.ts","dist/test/**/*.js"],"include":["src/**/*.ts","dist/**/*.js"],"reporter":["cobertura","html","text"],"cache-dir":"nyc/.cache","report-dir":"nyc/report","temp-directory":"nyc/.nyc_output","exclude-after-remap":false},"dist":{"shasum":"fe94794a2eb54e075f621d9472ba0cc787cce1da","tarball":"https://registry.npmjs.org/@fluid-experimental/devtools-core/-/devtools-core-2.0.0-internal.7.4.7.tgz","fileCount":510,"integrity":"sha512-6kIcTgiVGWEwXmh7Y5bKISh02JlAdP3wyvdpbqyzYXAF6U6hv9CL7/hv6LHZwxwaJGVlX3FEmIDqpcZo193zBg==","signatures":[{"sig":"MEUCIQDFh+mc7ljhHSxAJRmiaaaglHs7cuNmYkzu6l3gA4wJugIgL78MCdk0oYvRypIsmbaJQuLGbDrBxEK4q5R1Mo+axG8=","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}],"unpackedSize":1625178},"main":"dist/index.js","_from":"file:fluid-experimental-devtools-core-2.0.0-internal.7.4.7.tgz","types":"dist/index.d.ts","module":"lib/index.js","readme":"# @fluid-experimental/devtools-core\n\nThis library contains developer tools for use alongside the Fluid Framework.\nIt is used to power our associated [browser extension][browser-extension].\n\n- Chrome: \n- Edge: \n\n\n\n**IMPORTANT: This package is experimental.**\n**Its APIs may change without notice.**\n\n**Do not use in production scenarios.**\n\n\n\n\n\n\n\n\n## Installation\n\nTo get started, install the package by running the following command:\n\n```bash\nnpm i @fluid-experimental/devtools-core -D\n```\n\n\n\n\n\n## Usage\n\nThe Devtools' API surface is designed to fit nicely into most application flows.\n\n### Initialization\n\nTo initialize a devtools session for your container, call [`initializeDevtools`][initialize-devtools-docs].\nThis function accepts a `DevtoolsLogger` for receiving Fluid telemetry from your application, a list of initial Fluid\n`Containers` to associate with the session, and (optionally) customized data visualization configurations for visualizing\n`Container` data.\n\n#### About the [`DevtoolsLogger`][devtools-logger-docs]\n\nThe `DevtoolsLogger` is an optional piece when calling `initializeDevtools` but it is strongly recommended that you use\nit because several features in Fluid Devtools are powered by the telemetry that Fluid Framework generates, and this\nlogger is the way in which that telemetry gets into Fluid Devtools.\n\nYou can obtain a `DevtoolsLogger` by calling its constructor, and then should pass it to `initializeDevtools` _and_\nto the `Loader` instance you'll use to create/load Containers as shown below.\nThis way the logger will receive all the telemetry generated by Fluid Framework in your application, and forward it to\nFluid Devtools as necessary.\n\n```typescript\nimport { DevtoolsLogger, initializeDevtools } from \"@fluid-experimental/devtools-core\";\n\n// Instantiate the logger\nconst devtoolsLogger = new DevtoolsLogger();\n\n// Pass the logger when instantiating the Loader\nconst loader = new Loader({\n\tlogger: devtoolsLogger,\n\t// Other necessary properties ...\n});\n\n// Use the Loader to create (and optionally, attach) a Container\nconst container = await loader.createDetachedContainer(/* params */);\nawait container.attach(/* params */);\n\n// Initialize the Devtools passing the logger and your Container.\n// The Container could be added later as well with devtools.registerContainerDevtools().\nconst devtools = initializeDevtools({\n\tlogger: devtoolsLogger,\n\tinitialContainers: [\n\t\t{\n\t\t\tcontainer,\n\t\t\tcontainerKey: \"My Container\",\n\t\t},\n\t],\n});\n```\n\nIf you're working with `AzureClient` instead of lower-level APIs like the one described above, you probably want to\nrefer to the [@fluid-experimental/devtools package][devtools-package] instead of this one.\n\nDuring local development the recommendation is that your application should receive the `DevtoolsLogger` instance _instead_\nof any logger it would normally receive when deployed to a real environment, to avoid local development activity from\nmixing with real telemetry.\nIf you still want to provide a real application logger and use the Fluid Devtools features that are powered by telemetry\nat the same time, you can pass an existing logger to the `DevtoolsLogger` constructor and it will forward all telemetry\nit receives to that logger as well:\n\n```typescript\nimport { DevtoolsLogger } from \"@fluid-experimental/devtools-core\";\n\n// Your application's logger\nconst yourApplicationLogger = getInstanceOfYourApplicationLogger();\n\nconst devtoolsLogger = new DevtoolsLogger(yourApplicationLogger);\n\n// Pass devtoolsLogger to initializeDevtools() and to your application as described above\n```\n\n### Clean-up\n\nThe Devtools object is managed as a global singleton.\nThat singleton is automatically cleaned up prior to the Window's \"unload\" event.\nSo typical application flows likely won't need to worry about cleanup.\nThat said, if you wish to have tighter control over when the Devtools are torn down, you can simply call the `dispose` method on the handle returned by [initialization](#initialization).\n\n## Contributing to the package\n\n### Build\n\nTo build the package locally, first ensure you have run `pnpm install` from the root of the mono-repo.\nNext, to build the code, run `npm run build` from the root of the mono-repo, or use [fluid-build](https://github.com/microsoft/FluidFramework/tree/main/build-tools/packages/build-tools#running-fluid-build-command-line) via `fluid-build -t build`.\n\n- Note: Once you have run a build from the root, assuming no other changes outside of this package, you may run `npm run build` directly within this directory for a faster build.\n If you make changes to any of this package's local dependencies, you will need to run a build again from the root before building again from directly within this package.\n\n### Test\n\nTo run the tests, first ensure you have followed the [build](#build) steps above.\nNext, run `npm run test` from a terminal within this directory.\n\n\n\n\n\n\n\n## API Documentation\n\nAPI documentation for **@fluid-experimental/devtools-core** is available at .\n\n\n\n\n\n\n\n\n\n\n## Contribution Guidelines\n\nThere are many ways to [contribute](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md) to Fluid.\n\n- Participate in Q&A in our [GitHub Discussions](https://github.com/microsoft/FluidFramework/discussions).\n- [Submit bugs](https://github.com/microsoft/FluidFramework/issues) and help us verify fixes as they are checked in.\n- Review the [source code changes](https://github.com/microsoft/FluidFramework/pulls).\n- [Contribute bug fixes](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md).\n\nDetailed instructions for working in the repo can be found in the [Wiki](https://github.com/microsoft/FluidFramework/wiki).\n\nThis project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).\nFor more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\nUse of these trademarks or logos must follow Microsoft’s [Trademark & Brand Guidelines](https://www.microsoft.com/trademarks).\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n\n\n\n## Help\n\nNot finding what you're looking for in this README? Check out our [GitHub\nWiki](https://github.com/microsoft/FluidFramework/wiki) or [fluidframework.com](https://fluidframework.com/docs/).\n\nStill not finding what you're looking for? Please [file an\nissue](https://github.com/microsoft/FluidFramework/wiki/Submitting-Bugs-and-Feature-Requests).\n\nThank you!\n\n\n\n\n\n\n\n\n\n\n## Trademark\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\n\nUse of these trademarks or logos must follow Microsoft's [Trademark & Brand Guidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general).\n\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n[initialize-devtools-docs]: https://fluidframework.com/docs/apis/devtools-core#initializedevtools-function\n[devtools-logger-docs]: https://fluidframework.com/docs/apis/devtools-core/devtoolslogger-class\n[devtools-package]: https://www.npmjs.com/package/@fluid-experimental/devtools\n[browser-extension]: https://github.com/microsoft/FluidFramework/tree/main/packages/tools/devtools/devtools-browser-extension\n","scripts":{"api":"fluid-build . --task api","tsc":"tsc","lint":"npm run prettier && npm run check:release-tags && npm run eslint","test":"npm run test:mocha","build":"fluid-build . --task build","clean":"rimraf --glob _api-extractor-temp nyc dist lib \"**/*.tsbuildinfo\" \"**/*.build.log\"","eslint":"eslint src","format":"npm run prettier:fix","rebuild":"npm run clean && npm run build","lint:fix":"npm run prettier:fix && npm run eslint:fix","prettier":"prettier --check . --cache --ignore-path ../../../../.prettierignore","tsc:watch":"tsc --watch","build:docs":"fluid-build . --task api","eslint:fix":"eslint src --fix","test:mocha":"mocha \"dist/**/*.test.js\" --exit","build:esnext":"tsc --project ./tsconfig.esnext.json","build:genver":"gen-version","prettier:fix":"prettier --write . --cache --ignore-path ../../../../.prettierignore","build:compile":"fluid-build . --task compile","ci:build:docs":"api-extractor run","test:coverage":"c8 npm test","typetests:gen":"fluid-type-test-generator","build:commonjs":"fluid-build . --task commonjs","format-and-build":"npm run format && npm run build","typetests:prepare":"flub typetests --dir . --reset --previous --normalize","check:release-tags":"api-extractor run --local --config ./api-extractor-lint.json","format-and-compile":"npm run format && npm run build:compile","api-extractor:esnext":"copyfiles -u 1 \"dist/**/*-@(alpha|beta|public|untrimmed).d.ts\" lib","api-extractor:commonjs":"api-extractor run --local"},"_npmUser":{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},"_resolved":"/mnt/vss/_work/1/pack/scoped/fluid-experimental-devtools-core-2.0.0-internal.7.4.7.tgz","_integrity":"sha512-6kIcTgiVGWEwXmh7Y5bKISh02JlAdP3wyvdpbqyzYXAF6U6hv9CL7/hv6LHZwxwaJGVlX3FEmIDqpcZo193zBg==","fluidBuild":{"tasks":{"tsc":["...","typetests:gen"],"build:docs":{"script":false,"dependsOn":["...","api-extractor:commonjs","api-extractor:esnext"]}}},"repository":{"url":"git+https://github.com/microsoft/FluidFramework.git","type":"git","directory":"packages/tools/devtools/devtools-core"},"_npmVersion":"9.6.7","description":"Fluid Framework developer tools core functionality","directories":{},"sideEffects":false,"_nodeVersion":"18.17.1","dependencies":{"@fluidframework/map":">=2.0.0-internal.7.4.7 <2.0.0-internal.7.5.0","@fluidframework/cell":">=2.0.0-internal.7.4.7 <2.0.0-internal.7.5.0","@fluidframework/matrix":">=2.0.0-internal.7.4.7 <2.0.0-internal.7.5.0","@fluidframework/counter":">=2.0.0-internal.7.4.7 <2.0.0-internal.7.5.0","@fluidframework/sequence":">=2.0.0-internal.7.4.7 <2.0.0-internal.7.5.0","@fluid-experimental/tree2":">=2.0.0-internal.7.4.7 <2.0.0-internal.7.5.0","@fluid-internal/client-utils":">=2.0.0-internal.7.4.7 <2.0.0-internal.7.5.0","@fluidframework/core-interfaces":">=2.0.0-internal.7.4.7 <2.0.0-internal.7.5.0","@fluidframework/telemetry-utils":">=2.0.0-internal.7.4.7 <2.0.0-internal.7.5.0","@fluidframework/container-loader":">=2.0.0-internal.7.4.7 <2.0.0-internal.7.5.0","@fluidframework/shared-object-base":">=2.0.0-internal.7.4.7 <2.0.0-internal.7.5.0","@fluidframework/protocol-definitions":"^3.0.0","@fluidframework/container-definitions":">=2.0.0-internal.7.4.7 <2.0.0-internal.7.5.0","@fluidframework/datastore-definitions":">=2.0.0-internal.7.4.7 <2.0.0-internal.7.5.0"},"_hasShrinkwrap":false,"readmeFilename":"README.md","typeValidation":{"broken":{}},"devDependencies":{"c8":"^7.7.1","chai":"^4.2.0","mocha":"^10.2.0","eslint":"~8.50.0","events":"^3.1.0","moment":"^2.21.0","rimraf":"^4.4.0","prettier":"~3.0.3","copyfiles":"^2.4.1","cross-env":"^7.0.3","typescript":"~5.1.6","@types/chai":"^4.0.0","@types/mocha":"^9.1.1","@types/events":"^3.0.0","mocha-multi-reporters":"^1.5.1","@fluid-tools/build-cli":"^0.28.0","eslint-config-prettier":"~9.0.0","@microsoft/api-extractor":"^7.38.3","eslint-plugin-chai-expect":"~3.0.0","mocha-json-output-reporter":"^2.0.1","@fluidframework/build-tools":"^0.28.0","@fluidframework/build-common":"^2.0.3","@fluidframework/mocha-test-setup":">=2.0.0-internal.7.4.7 <2.0.0-internal.7.5.0","@fluidframework/driver-definitions":">=2.0.0-internal.7.4.7 <2.0.0-internal.7.5.0","@fluidframework/test-runtime-utils":">=2.0.0-internal.7.4.7 <2.0.0-internal.7.5.0","@fluidframework/eslint-config-fluid":"^3.1.0","@fluid-experimental/devtools-core-previous":"npm:@fluid-experimental/devtools-core@2.0.0-internal.7.2.0"},"_npmOperationalInternal":{"tmp":"tmp/devtools-core_2.0.0-internal.7.4.7_1707783685866_0.4186574475444391","host":"s3://npm-registry-packages"}},"2.0.0-internal.8.0.7":{"name":"@fluid-experimental/devtools-core","version":"2.0.0-internal.8.0.7","author":{"name":"Microsoft and contributors"},"license":"MIT","_id":"@fluid-experimental/devtools-core@2.0.0-internal.8.0.7","maintainers":[{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},{"name":"curtisman","email":"curtism@microsoft.com"}],"homepage":"https://fluidframework.com","bugs":{"url":"https://github.com/microsoft/FluidFramework/issues"},"c8":{"all":true,"exclude":["src/test/**/*.ts","dist/test/**/*.js"],"include":["src/**/*.ts","dist/**/*.js"],"reporter":["cobertura","html","text"],"cache-dir":"nyc/.cache","report-dir":"nyc/report","temp-directory":"nyc/.nyc_output","exclude-after-remap":false},"dist":{"shasum":"eb07069fe23abe593591eb8e5af3cd672cc95043","tarball":"https://registry.npmjs.org/@fluid-experimental/devtools-core/-/devtools-core-2.0.0-internal.8.0.7.tgz","fileCount":510,"integrity":"sha512-VSYdvESFmbt1thq/EWYVsFyn1gyapjQu9mNKpJYRLwV4FvJku7AAKWAElmw7RSqhqD7re7Cb+sgg8DlAuBRMzw==","signatures":[{"sig":"MEUCIHBOb1geTCq6dMSjEtn6ohz4Rda6mf6pHehbuv+FhTCgAiEA9D5uNvxQeXzRbbMgNe3LefvtkNesyUzA3tYOJ1MwY4k=","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}],"unpackedSize":1629472},"main":"dist/index.js","_from":"file:fluid-experimental-devtools-core-2.0.0-internal.8.0.7.tgz","types":"dist/index.d.ts","module":"lib/index.js","readme":"# @fluid-experimental/devtools-core\n\nThis library contains developer tools for use alongside the Fluid Framework.\nIt is used to power our associated [browser extension][browser-extension].\n\n- Chrome: \n- Edge: \n\n\n\n**IMPORTANT: This package is experimental.**\n**Its APIs may change without notice.**\n\n**Do not use in production scenarios.**\n\n\n\n\n\n\n\n\n## Installation\n\nTo get started, install the package by running the following command:\n\n```bash\nnpm i @fluid-experimental/devtools-core -D\n```\n\n\n\n\n\n## Usage\n\nThe Devtools' API surface is designed to fit nicely into most application flows.\n\n### Initialization\n\nTo initialize a devtools session for your container, call [`initializeDevtools`][initialize-devtools-docs].\nThis function accepts a `DevtoolsLogger` for receiving Fluid telemetry from your application, a list of initial Fluid\n`Containers` to associate with the session, and (optionally) customized data visualization configurations for visualizing\n`Container` data.\n\n#### About the [`DevtoolsLogger`][devtools-logger-docs]\n\nThe `DevtoolsLogger` is an optional piece when calling `initializeDevtools` but it is strongly recommended that you use\nit because several features in Fluid Devtools are powered by the telemetry that Fluid Framework generates, and this\nlogger is the way in which that telemetry gets into Fluid Devtools.\n\nYou can obtain a `DevtoolsLogger` by calling its constructor, and then should pass it to `initializeDevtools` _and_\nto the `Loader` instance you'll use to create/load Containers as shown below.\nThis way the logger will receive all the telemetry generated by Fluid Framework in your application, and forward it to\nFluid Devtools as necessary.\n\n```typescript\nimport { DevtoolsLogger, initializeDevtools } from \"@fluid-experimental/devtools-core\";\n\n// Instantiate the logger\nconst devtoolsLogger = new DevtoolsLogger();\n\n// Pass the logger when instantiating the Loader\nconst loader = new Loader({\n\tlogger: devtoolsLogger,\n\t// Other necessary properties ...\n});\n\n// Use the Loader to create (and optionally, attach) a Container\nconst container = await loader.createDetachedContainer(/* params */);\nawait container.attach(/* params */);\n\n// Initialize the Devtools passing the logger and your Container.\n// The Container could be added later as well with devtools.registerContainerDevtools().\nconst devtools = initializeDevtools({\n\tlogger: devtoolsLogger,\n\tinitialContainers: [\n\t\t{\n\t\t\tcontainer,\n\t\t\tcontainerKey: \"My Container\",\n\t\t},\n\t],\n});\n```\n\nIf you're working with `AzureClient` instead of lower-level APIs like the one described above, you probably want to\nrefer to the [@fluid-experimental/devtools package][devtools-package] instead of this one.\n\nDuring local development the recommendation is that your application should receive the `DevtoolsLogger` instance _instead_\nof any logger it would normally receive when deployed to a real environment, to avoid local development activity from\nmixing with real telemetry.\nIf you still want to provide a real application logger and use the Fluid Devtools features that are powered by telemetry\nat the same time, you can pass an existing logger to the `DevtoolsLogger` constructor and it will forward all telemetry\nit receives to that logger as well:\n\n```typescript\nimport { DevtoolsLogger } from \"@fluid-experimental/devtools-core\";\n\n// Your application's logger\nconst yourApplicationLogger = getInstanceOfYourApplicationLogger();\n\nconst devtoolsLogger = new DevtoolsLogger(yourApplicationLogger);\n\n// Pass devtoolsLogger to initializeDevtools() and to your application as described above\n```\n\n### Clean-up\n\nThe Devtools object is managed as a global singleton.\nThat singleton is automatically cleaned up prior to the Window's \"unload\" event.\nSo typical application flows likely won't need to worry about cleanup.\nThat said, if you wish to have tighter control over when the Devtools are torn down, you can simply call the `dispose` method on the handle returned by [initialization](#initialization).\n\n## Contributing to the package\n\n### Build\n\nTo build the package locally, first ensure you have run `pnpm install` from the root of the mono-repo.\nNext, to build the code, run `npm run build` from the root of the mono-repo, or use [fluid-build](https://github.com/microsoft/FluidFramework/tree/main/build-tools/packages/build-tools#running-fluid-build-command-line) via `fluid-build -t build`.\n\n- Note: Once you have run a build from the root, assuming no other changes outside of this package, you may run `npm run build` directly within this directory for a faster build.\n If you make changes to any of this package's local dependencies, you will need to run a build again from the root before building again from directly within this package.\n\n### Test\n\nTo run the tests, first ensure you have followed the [build](#build) steps above.\nNext, run `npm run test` from a terminal within this directory.\n\n\n\n\n\n\n\n## API Documentation\n\nAPI documentation for **@fluid-experimental/devtools-core** is available at .\n\n\n\n\n\n\n\n\n\n\n## Contribution Guidelines\n\nThere are many ways to [contribute](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md) to Fluid.\n\n- Participate in Q&A in our [GitHub Discussions](https://github.com/microsoft/FluidFramework/discussions).\n- [Submit bugs](https://github.com/microsoft/FluidFramework/issues) and help us verify fixes as they are checked in.\n- Review the [source code changes](https://github.com/microsoft/FluidFramework/pulls).\n- [Contribute bug fixes](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md).\n\nDetailed instructions for working in the repo can be found in the [Wiki](https://github.com/microsoft/FluidFramework/wiki).\n\nThis project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).\nFor more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\nUse of these trademarks or logos must follow Microsoft’s [Trademark & Brand Guidelines](https://www.microsoft.com/trademarks).\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n\n\n\n## Help\n\nNot finding what you're looking for in this README? Check out our [GitHub\nWiki](https://github.com/microsoft/FluidFramework/wiki) or [fluidframework.com](https://fluidframework.com/docs/).\n\nStill not finding what you're looking for? Please [file an\nissue](https://github.com/microsoft/FluidFramework/wiki/Submitting-Bugs-and-Feature-Requests).\n\nThank you!\n\n\n\n\n\n\n\n\n\n\n## Trademark\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\n\nUse of these trademarks or logos must follow Microsoft's [Trademark & Brand Guidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general).\n\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n[initialize-devtools-docs]: https://fluidframework.com/docs/apis/devtools-core#initializedevtools-function\n[devtools-logger-docs]: https://fluidframework.com/docs/apis/devtools-core/devtoolslogger-class\n[devtools-package]: https://www.npmjs.com/package/@fluid-experimental/devtools\n[browser-extension]: https://github.com/microsoft/FluidFramework/tree/main/packages/tools/devtools/devtools-browser-extension\n","scripts":{"api":"fluid-build . --task api","tsc":"tsc","lint":"npm run prettier && npm run check:release-tags && npm run eslint","test":"npm run test:mocha","build":"fluid-build . --task build","clean":"rimraf --glob _api-extractor-temp nyc dist lib \"**/*.tsbuildinfo\" \"**/*.build.log\"","eslint":"eslint src","format":"npm run prettier:fix","rebuild":"npm run clean && npm run build","lint:fix":"npm run prettier:fix && npm run eslint:fix","prettier":"prettier --check . --cache --ignore-path ../../../../.prettierignore","tsc:watch":"tsc --watch","build:docs":"fluid-build . --task api","eslint:fix":"eslint src --fix","test:mocha":"mocha \"dist/**/*.test.js\" --exit","build:esnext":"tsc --project ./tsconfig.esnext.json","build:genver":"gen-version","prettier:fix":"prettier --write . --cache --ignore-path ../../../../.prettierignore","build:compile":"fluid-build . --task compile","ci:build:docs":"api-extractor run","test:coverage":"c8 npm test","typetests:gen":"fluid-type-test-generator","build:commonjs":"fluid-build . --task commonjs","format-and-build":"npm run format && npm run build","typetests:prepare":"flub typetests --dir . --reset --previous --normalize","check:release-tags":"api-extractor run --local --config ./api-extractor-lint.json","format-and-compile":"npm run format && npm run build:compile","api-extractor:esnext":"copyfiles -u 1 \"dist/**/*-@(alpha|beta|public|untrimmed).d.ts\" lib","api-extractor:commonjs":"api-extractor run --local"},"_npmUser":{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},"_resolved":"/mnt/vss/_work/1/pack/scoped/fluid-experimental-devtools-core-2.0.0-internal.8.0.7.tgz","_integrity":"sha512-VSYdvESFmbt1thq/EWYVsFyn1gyapjQu9mNKpJYRLwV4FvJku7AAKWAElmw7RSqhqD7re7Cb+sgg8DlAuBRMzw==","fluidBuild":{"tasks":{"tsc":["...","typetests:gen"],"build:docs":{"script":false,"dependsOn":["...","api-extractor:commonjs","api-extractor:esnext"]}}},"repository":{"url":"git+https://github.com/microsoft/FluidFramework.git","type":"git","directory":"packages/tools/devtools/devtools-core"},"_npmVersion":"9.6.7","description":"Fluid Framework developer tools core functionality","directories":{},"sideEffects":false,"_nodeVersion":"18.17.1","dependencies":{"@fluidframework/map":">=2.0.0-internal.8.0.7 <2.0.0-internal.8.1.0","@fluidframework/cell":">=2.0.0-internal.8.0.7 <2.0.0-internal.8.1.0","@fluidframework/matrix":">=2.0.0-internal.8.0.7 <2.0.0-internal.8.1.0","@fluidframework/counter":">=2.0.0-internal.8.0.7 <2.0.0-internal.8.1.0","@fluidframework/sequence":">=2.0.0-internal.8.0.7 <2.0.0-internal.8.1.0","@fluid-experimental/tree2":">=2.0.0-internal.8.0.7 <2.0.0-internal.8.1.0","@fluid-internal/client-utils":">=2.0.0-internal.8.0.7 <2.0.0-internal.8.1.0","@fluidframework/core-interfaces":">=2.0.0-internal.8.0.7 <2.0.0-internal.8.1.0","@fluidframework/telemetry-utils":">=2.0.0-internal.8.0.7 <2.0.0-internal.8.1.0","@fluidframework/container-loader":">=2.0.0-internal.8.0.7 <2.0.0-internal.8.1.0","@fluidframework/shared-object-base":">=2.0.0-internal.8.0.7 <2.0.0-internal.8.1.0","@fluidframework/protocol-definitions":"^3.0.0","@fluidframework/container-definitions":">=2.0.0-internal.8.0.7 <2.0.0-internal.8.1.0","@fluidframework/datastore-definitions":">=2.0.0-internal.8.0.7 <2.0.0-internal.8.1.0"},"_hasShrinkwrap":false,"readmeFilename":"README.md","typeValidation":{"broken":{"TypeAliasDeclaration_Primitive":{"forwardCompat":false},"TypeAliasDeclaration_VisualNode":{"forwardCompat":false},"InterfaceDeclaration_TreeNodeBase":{"forwardCompat":false},"InterfaceDeclaration_ValueNodeBase":{"forwardCompat":false},"InterfaceDeclaration_VisualNodeBase":{"forwardCompat":false},"InterfaceDeclaration_VisualTreeNode":{"forwardCompat":false},"TypeAliasDeclaration_RootHandleNode":{"forwardCompat":false},"InterfaceDeclaration_FluidHandleNode":{"forwardCompat":false},"InterfaceDeclaration_VisualValueNode":{"forwardCompat":false},"TypeAliasDeclaration_VisualChildNode":{"forwardCompat":false},"InterfaceDeclaration_UnknownObjectNode":{"forwardCompat":false},"InterfaceDeclaration_FluidDevtoolsProps":{"backCompat":false},"InterfaceDeclaration_FluidObjectNodeBase":{"forwardCompat":false},"InterfaceDeclaration_ContainerDevtoolsProps":{"backCompat":false}}},"devDependencies":{"c8":"^7.7.1","chai":"^4.2.0","mocha":"^10.2.0","eslint":"~8.50.0","events":"^3.1.0","moment":"^2.21.0","rimraf":"^4.4.0","prettier":"~3.0.3","copyfiles":"^2.4.1","cross-env":"^7.0.3","typescript":"~5.1.6","@types/chai":"^4.0.0","@types/mocha":"^9.1.1","@types/events":"^3.0.0","mocha-multi-reporters":"^1.5.1","@fluid-tools/build-cli":"^0.28.0","eslint-config-prettier":"~9.0.0","@microsoft/api-extractor":"^7.38.3","eslint-plugin-chai-expect":"~3.0.0","mocha-json-output-reporter":"^2.0.1","@fluidframework/build-tools":"^0.28.0","@fluidframework/build-common":"^2.0.3","@fluidframework/mocha-test-setup":">=2.0.0-internal.8.0.7 <2.0.0-internal.8.1.0","@fluidframework/driver-definitions":">=2.0.0-internal.8.0.7 <2.0.0-internal.8.1.0","@fluidframework/test-runtime-utils":">=2.0.0-internal.8.0.7 <2.0.0-internal.8.1.0","@fluidframework/eslint-config-fluid":"^3.1.0","@fluid-experimental/devtools-core-previous":"npm:@fluid-experimental/devtools-core@2.0.0-internal.7.2.0"},"_npmOperationalInternal":{"tmp":"tmp/devtools-core_2.0.0-internal.8.0.7_1709146835162_0.928820010198188","host":"s3://npm-registry-packages"}},"2.0.0-internal.8.0.8":{"name":"@fluid-experimental/devtools-core","version":"2.0.0-internal.8.0.8","author":{"name":"Microsoft and contributors"},"license":"MIT","_id":"@fluid-experimental/devtools-core@2.0.0-internal.8.0.8","maintainers":[{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},{"name":"curtisman","email":"curtism@microsoft.com"}],"homepage":"https://fluidframework.com","bugs":{"url":"https://github.com/microsoft/FluidFramework/issues"},"c8":{"all":true,"exclude":["src/test/**/*.ts","dist/test/**/*.js"],"include":["src/**/*.ts","dist/**/*.js"],"reporter":["cobertura","html","text"],"cache-dir":"nyc/.cache","report-dir":"nyc/report","temp-directory":"nyc/.nyc_output","exclude-after-remap":false},"dist":{"shasum":"c9c47c4ac4bac3cb59382fbd66a5ed085e7592db","tarball":"https://registry.npmjs.org/@fluid-experimental/devtools-core/-/devtools-core-2.0.0-internal.8.0.8.tgz","fileCount":510,"integrity":"sha512-NNh8W4jG8TcUkhqOjG91ZdTR8hiPUQmaBHAni/N+AjaEP4lgrN3AmqvB9OoaMv/NkfITD7pEhcRJ7MZjIl6ANQ==","signatures":[{"sig":"MEQCIBxD5eVfQHVBStp1x5YX3WNabf1kv4dD3DnzadiWQde3AiAEEr8cn/hpg8BAGJLWsx5Yk2kyNWNbBLhx/WvALKGTXg==","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}],"unpackedSize":1629472},"main":"dist/index.js","_from":"file:fluid-experimental-devtools-core-2.0.0-internal.8.0.8.tgz","types":"dist/index.d.ts","module":"lib/index.js","readme":"# @fluid-experimental/devtools-core\n\nThis library contains developer tools for use alongside the Fluid Framework.\nIt is used to power our associated [browser extension][browser-extension].\n\n- Chrome: \n- Edge: \n\n\n\n**IMPORTANT: This package is experimental.**\n**Its APIs may change without notice.**\n\n**Do not use in production scenarios.**\n\n\n\n\n\n\n\n\n## Installation\n\nTo get started, install the package by running the following command:\n\n```bash\nnpm i @fluid-experimental/devtools-core -D\n```\n\n\n\n\n\n## Usage\n\nThe Devtools' API surface is designed to fit nicely into most application flows.\n\n### Initialization\n\nTo initialize a devtools session for your container, call [`initializeDevtools`][initialize-devtools-docs].\nThis function accepts a `DevtoolsLogger` for receiving Fluid telemetry from your application, a list of initial Fluid\n`Containers` to associate with the session, and (optionally) customized data visualization configurations for visualizing\n`Container` data.\n\n#### About the [`DevtoolsLogger`][devtools-logger-docs]\n\nThe `DevtoolsLogger` is an optional piece when calling `initializeDevtools` but it is strongly recommended that you use\nit because several features in Fluid Devtools are powered by the telemetry that Fluid Framework generates, and this\nlogger is the way in which that telemetry gets into Fluid Devtools.\n\nYou can obtain a `DevtoolsLogger` by calling its constructor, and then should pass it to `initializeDevtools` _and_\nto the `Loader` instance you'll use to create/load Containers as shown below.\nThis way the logger will receive all the telemetry generated by Fluid Framework in your application, and forward it to\nFluid Devtools as necessary.\n\n```typescript\nimport { DevtoolsLogger, initializeDevtools } from \"@fluid-experimental/devtools-core\";\n\n// Instantiate the logger\nconst devtoolsLogger = new DevtoolsLogger();\n\n// Pass the logger when instantiating the Loader\nconst loader = new Loader({\n\tlogger: devtoolsLogger,\n\t// Other necessary properties ...\n});\n\n// Use the Loader to create (and optionally, attach) a Container\nconst container = await loader.createDetachedContainer(/* params */);\nawait container.attach(/* params */);\n\n// Initialize the Devtools passing the logger and your Container.\n// The Container could be added later as well with devtools.registerContainerDevtools().\nconst devtools = initializeDevtools({\n\tlogger: devtoolsLogger,\n\tinitialContainers: [\n\t\t{\n\t\t\tcontainer,\n\t\t\tcontainerKey: \"My Container\",\n\t\t},\n\t],\n});\n```\n\nIf you're working with `AzureClient` instead of lower-level APIs like the one described above, you probably want to\nrefer to the [@fluid-experimental/devtools package][devtools-package] instead of this one.\n\nDuring local development the recommendation is that your application should receive the `DevtoolsLogger` instance _instead_\nof any logger it would normally receive when deployed to a real environment, to avoid local development activity from\nmixing with real telemetry.\nIf you still want to provide a real application logger and use the Fluid Devtools features that are powered by telemetry\nat the same time, you can pass an existing logger to the `DevtoolsLogger` constructor and it will forward all telemetry\nit receives to that logger as well:\n\n```typescript\nimport { DevtoolsLogger } from \"@fluid-experimental/devtools-core\";\n\n// Your application's logger\nconst yourApplicationLogger = getInstanceOfYourApplicationLogger();\n\nconst devtoolsLogger = new DevtoolsLogger(yourApplicationLogger);\n\n// Pass devtoolsLogger to initializeDevtools() and to your application as described above\n```\n\n### Clean-up\n\nThe Devtools object is managed as a global singleton.\nThat singleton is automatically cleaned up prior to the Window's \"unload\" event.\nSo typical application flows likely won't need to worry about cleanup.\nThat said, if you wish to have tighter control over when the Devtools are torn down, you can simply call the `dispose` method on the handle returned by [initialization](#initialization).\n\n## Contributing to the package\n\n### Build\n\nTo build the package locally, first ensure you have run `pnpm install` from the root of the mono-repo.\nNext, to build the code, run `npm run build` from the root of the mono-repo, or use [fluid-build](https://github.com/microsoft/FluidFramework/tree/main/build-tools/packages/build-tools#running-fluid-build-command-line) via `fluid-build -t build`.\n\n- Note: Once you have run a build from the root, assuming no other changes outside of this package, you may run `npm run build` directly within this directory for a faster build.\n If you make changes to any of this package's local dependencies, you will need to run a build again from the root before building again from directly within this package.\n\n### Test\n\nTo run the tests, first ensure you have followed the [build](#build) steps above.\nNext, run `npm run test` from a terminal within this directory.\n\n\n\n\n\n\n\n## API Documentation\n\nAPI documentation for **@fluid-experimental/devtools-core** is available at .\n\n\n\n\n\n\n\n\n\n\n## Contribution Guidelines\n\nThere are many ways to [contribute](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md) to Fluid.\n\n- Participate in Q&A in our [GitHub Discussions](https://github.com/microsoft/FluidFramework/discussions).\n- [Submit bugs](https://github.com/microsoft/FluidFramework/issues) and help us verify fixes as they are checked in.\n- Review the [source code changes](https://github.com/microsoft/FluidFramework/pulls).\n- [Contribute bug fixes](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md).\n\nDetailed instructions for working in the repo can be found in the [Wiki](https://github.com/microsoft/FluidFramework/wiki).\n\nThis project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).\nFor more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\nUse of these trademarks or logos must follow Microsoft’s [Trademark & Brand Guidelines](https://www.microsoft.com/trademarks).\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n\n\n\n## Help\n\nNot finding what you're looking for in this README? Check out our [GitHub\nWiki](https://github.com/microsoft/FluidFramework/wiki) or [fluidframework.com](https://fluidframework.com/docs/).\n\nStill not finding what you're looking for? Please [file an\nissue](https://github.com/microsoft/FluidFramework/wiki/Submitting-Bugs-and-Feature-Requests).\n\nThank you!\n\n\n\n\n\n\n\n\n\n\n## Trademark\n\nThis project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.\n\nUse of these trademarks or logos must follow Microsoft's [Trademark & Brand Guidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general).\n\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\n\n\n\n\n\n\n\n[initialize-devtools-docs]: https://fluidframework.com/docs/apis/devtools-core#initializedevtools-function\n[devtools-logger-docs]: https://fluidframework.com/docs/apis/devtools-core/devtoolslogger-class\n[devtools-package]: https://www.npmjs.com/package/@fluid-experimental/devtools\n[browser-extension]: https://github.com/microsoft/FluidFramework/tree/main/packages/tools/devtools/devtools-browser-extension\n","scripts":{"api":"fluid-build . --task api","tsc":"tsc","lint":"npm run prettier && npm run check:release-tags && npm run eslint","test":"npm run test:mocha","build":"fluid-build . --task build","clean":"rimraf --glob _api-extractor-temp nyc dist lib \"**/*.tsbuildinfo\" \"**/*.build.log\"","eslint":"eslint src","format":"npm run prettier:fix","rebuild":"npm run clean && npm run build","lint:fix":"npm run prettier:fix && npm run eslint:fix","prettier":"prettier --check . --cache --ignore-path ../../../../.prettierignore","tsc:watch":"tsc --watch","build:docs":"fluid-build . --task api","eslint:fix":"eslint src --fix","test:mocha":"mocha \"dist/**/*.test.js\" --exit","build:esnext":"tsc --project ./tsconfig.esnext.json","build:genver":"gen-version","prettier:fix":"prettier --write . --cache --ignore-path ../../../../.prettierignore","build:compile":"fluid-build . --task compile","ci:build:docs":"api-extractor run","test:coverage":"c8 npm test","typetests:gen":"fluid-type-test-generator","build:commonjs":"fluid-build . --task commonjs","format-and-build":"npm run format && npm run build","typetests:prepare":"flub typetests --dir . --reset --previous --normalize","check:release-tags":"api-extractor run --local --config ./api-extractor-lint.json","format-and-compile":"npm run format && npm run build:compile","api-extractor:esnext":"copyfiles -u 1 \"dist/**/*-@(alpha|beta|public|untrimmed).d.ts\" lib","api-extractor:commonjs":"api-extractor run --local"},"_npmUser":{"name":"ms-fluid-bot","email":"ffsa@microsoft.com"},"_resolved":"/mnt/vss/_work/1/pack/scoped/fluid-experimental-devtools-core-2.0.0-internal.8.0.8.tgz","_integrity":"sha512-NNh8W4jG8TcUkhqOjG91ZdTR8hiPUQmaBHAni/N+AjaEP4lgrN3AmqvB9OoaMv/NkfITD7pEhcRJ7MZjIl6ANQ==","fluidBuild":{"tasks":{"tsc":["...","typetests:gen"],"build:docs":{"script":false,"dependsOn":["...","api-extractor:commonjs","api-extractor:esnext"]}}},"repository":{"url":"git+https://github.com/microsoft/FluidFramework.git","type":"git","directory":"packages/tools/devtools/devtools-core"},"_npmVersion":"9.6.7","description":"Fluid Framework developer tools core functionality","directories":{},"sideEffects":false,"_nodeVersion":"18.17.1","dependencies":{"@fluidframework/map":">=2.0.0-internal.8.0.8 <2.0.0-internal.8.1.0","@fluidframework/cell":">=2.0.0-internal.8.0.8 <2.0.0-internal.8.1.0","@fluidframework/matrix":">=2.0.0-internal.8.0.8 <2.0.0-internal.8.1.0","@fluidframework/counter":">=2.0.0-internal.8.0.8 <2.0.0-internal.8.1.0","@fluidframework/sequence":">=2.0.0-internal.8.0.8 <2.0.0-internal.8.1.0","@fluid-experimental/tree2":">=2.0.0-internal.8.0.8 <2.0.0-internal.8.1.0","@fluid-internal/client-utils":">=2.0.0-internal.8.0.8 <2.0.0-internal.8.1.0","@fluidframework/core-interfaces":">=2.0.0-internal.8.0.8 <2.0.0-internal.8.1.0","@fluidframework/telemetry-utils":">=2.0.0-internal.8.0.8 <2.0.0-internal.8.1.0","@fluidframework/container-loader":">=2.0.0-internal.8.0.8 <2.0.0-internal.8.1.0","@fluidframework/shared-object-base":">=2.0.0-internal.8.0.8 <2.0.0-internal.8.1.0","@fluidframework/protocol-definitions":"^3.0.0","@fluidframework/container-definitions":">=2.0.0-internal.8.0.8 <2.0.0-internal.8.1.0","@fluidframework/datastore-definitions":">=2.0.0-internal.8.0.8 <2.0.0-internal.8.1.0"},"_hasShrinkwrap":false,"readmeFilename":"README.md","typeValidation":{"broken":{"TypeAliasDeclaration_Primitive":{"forwardCompat":false},"TypeAliasDeclaration_VisualNode":{"forwardCompat":false},"InterfaceDeclaration_TreeNodeBase":{"forwardCompat":false},"InterfaceDeclaration_ValueNodeBase":{"forwardCompat":false},"InterfaceDeclaration_VisualNodeBase":{"forwardCompat":false},"InterfaceDeclaration_VisualTreeNode":{"forwardCompat":false},"TypeAliasDeclaration_RootHandleNode":{"forwardCompat":false},"InterfaceDeclaration_FluidHandleNode":{"forwardCompat":false},"InterfaceDeclaration_VisualValueNode":{"forwardCompat":false},"TypeAliasDeclaration_VisualChildNode":{"forwardCompat":false},"InterfaceDeclaration_UnknownObjectNode":{"forwardCompat":false},"InterfaceDeclaration_FluidDevtoolsProps":{"backCompat":false},"InterfaceDeclaration_FluidObjectNodeBase":{"forwardCompat":false},"InterfaceDeclaration_ContainerDevtoolsProps":{"backCompat":false}}},"devDependencies":{"c8":"^7.7.1","chai":"^4.2.0","mocha":"^10.2.0","eslint":"~8.50.0","events":"^3.1.0","moment":"^2.21.0","rimraf":"^4.4.0","prettier":"~3.0.3","copyfiles":"^2.4.1","cross-env":"^7.0.3","typescript":"~5.1.6","@types/chai":"^4.0.0","@types/mocha":"^9.1.1","@types/events":"^3.0.0","mocha-multi-reporters":"^1.5.1","@fluid-tools/build-cli":"^0.28.0","eslint-config-prettier":"~9.0.0","@microsoft/api-extractor":"^7.38.3","eslint-plugin-chai-expect":"~3.0.0","mocha-json-output-reporter":"^2.0.1","@fluidframework/build-tools":"^0.28.0","@fluidframework/build-common":"^2.0.3","@fluidframework/mocha-test-setup":">=2.0.0-internal.8.0.8 <2.0.0-internal.8.1.0","@fluidframework/driver-definitions":">=2.0.0-internal.8.0.8 <2.0.0-internal.8.1.0","@fluidframework/test-runtime-utils":">=2.0.0-internal.8.0.8 <2.0.0-internal.8.1.0","@fluidframework/eslint-config-fluid":"^3.1.0","@fluid-experimental/devtools-core-previous":"npm:@fluid-experimental/devtools-core@2.0.0-internal.7.2.0"},"_npmOperationalInternal":{"tmp":"tmp/devtools-core_2.0.0-internal.8.0.8_1710894195090_0.31444876357191687","host":"s3://npm-registry-packages"}}},"time":{"created":"2023-05-25T18:21:41.986Z","modified":"2026-07-29T21:13:27.612Z","2.0.0-dev.4.4.0.162574":"2023-05-25T18:21:42.217Z","2.0.0-internal.4.4.0":"2023-06-05T17:45:43.376Z","2.0.0-internal.5.0.0":"2023-06-06T00:41:53.569Z","2.0.0-internal.4.4.1":"2023-06-14T20:12:07.895Z","2.0.0-internal.5.0.1":"2023-06-14T21:19:06.383Z","2.0.0-dev.5.2.0.169897":"2023-06-21T15:49:27.565Z","2.0.0-internal.5.1.0":"2023-06-21T18:24:08.036Z","2.0.0-internal.5.1.1":"2023-06-29T23:22:21.406Z","2.0.0-internal.5.2.0":"2023-07-05T19:15:13.036Z","2.0.0-internal.5.3.0":"2023-07-15T00:57:48.831Z","2.0.0-internal.4.4.2":"2023-07-21T21:12:31.015Z","2.0.0-internal.5.3.1":"2023-07-24T18:42:22.790Z","2.0.0-dev.5.3.2.178189":"2023-07-25T18:37:22.229Z","2.0.0-internal.4.4.3":"2023-07-27T19:37:24.459Z","2.0.0-internal.5.3.2":"2023-07-27T21:09:49.668Z","2.0.0-internal.4.4.4":"2023-08-03T21:30:29.204Z","2.0.0-internal.5.4.0":"2023-08-03T21:33:51.652Z","2.0.0-internal.6.0.0":"2023-08-03T22:31:46.119Z","2.0.0-internal.5.3.4":"2023-08-07T20:26:56.891Z","2.0.0-internal.6.1.0":"2023-08-15T23:06:13.866Z","2.0.0-internal.6.1.1":"2023-08-17T23:53:08.633Z","2.0.0-internal.5.4.2":"2023-08-20T15:51:23.586Z","2.0.0-internal.6.0.1":"2023-08-20T21:23:10.742Z","2.0.0-internal.6.2.0":"2023-08-29T18:25:11.606Z","2.0.0-internal.6.3.0":"2023-09-06T22:37:15.386Z","2.0.0-internal.6.3.1":"2023-09-07T19:57:56.371Z","2.0.0-internal.6.0.2":"2023-09-08T00:59:02.819Z","2.0.0-internal.6.3.2":"2023-09-08T22:47:06.645Z","2.0.0-internal.6.1.2":"2023-09-11T17:20:29.847Z","2.0.0-internal.6.0.3":"2023-09-11T17:23:08.982Z","2.0.0-internal.6.2.1":"2023-09-11T17:25:51.098Z","2.0.0-dev.6.4.0.191258":"2023-09-19T03:50:52.153Z","2.0.0-dev.6.4.0.191457":"2023-09-19T23:19:26.416Z","2.0.0-dev.6.4.0.191515":"2023-09-20T00:32:34.276Z","2.0.0-dev.6.4.0.192049":"2023-09-20T23:33:56.077Z","2.0.0-internal.6.3.3":"2023-09-21T21:53:21.188Z","2.0.0-internal.6.4.0":"2023-09-28T01:05:11.041Z","2.0.0-internal.7.0.0":"2023-09-28T17:42:32.106Z","2.0.0-internal.6.0.4":"2023-10-03T00:27:34.010Z","2.0.0-internal.6.1.3":"2023-10-03T01:39:01.673Z","2.0.0-internal.6.3.4":"2023-10-03T02:40:10.971Z","2.0.0-internal.6.2.2":"2023-10-03T05:13:29.459Z","2.0.0-internal.7.1.0":"2023-10-13T22:32:44.090Z","2.0.0-dev.7.2.0.203917":"2023-10-23T22:28:47.958Z","2.0.0-dev.7.2.0.204906":"2023-10-25T17:23:16.975Z","2.0.0-dev.7.2.0.205722":"2023-10-26T23:15:33.138Z","2.0.0-internal.7.2.0":"2023-10-27T01:19:45.246Z","2.0.0-internal.7.2.1":"2023-10-28T00:28:06.082Z","2.0.0-internal.7.0.1":"2023-10-28T00:33:00.269Z","2.0.0-internal.7.1.1":"2023-10-28T00:33:21.199Z","2.0.0-dev.7.3.0.206769":"2023-10-31T01:01:34.354Z","2.0.0-dev.7.3.0.207781":"2023-11-02T00:14:08.010Z","2.0.0-dev.7.3.0.207992":"2023-11-02T19:38:52.204Z","2.0.0-dev.7.3.0.209023":"2023-11-07T21:56:34.258Z","2.0.0-internal.7.2.2":"2023-11-07T22:06:34.936Z","2.0.0-internal.7.1.2":"2023-11-07T22:10:51.402Z","2.0.0-internal.7.0.2":"2023-11-07T22:12:10.657Z","2.0.0-dev.7.3.0.209174":"2023-11-07T23:59:24.093Z","2.0.0-dev.7.3.0.209831":"2023-11-10T01:41:13.476Z","2.0.0-dev.7.3.0.210328":"2023-11-11T02:26:20.106Z","2.0.0-internal.7.0.3":"2023-11-15T21:41:22.933Z","2.0.0-dev.7.3.0.211848":"2023-11-16T22:26:34.705Z","2.0.0-dev.7.3.0.212138":"2023-11-17T20:39:50.729Z","2.0.0-internal.7.3.0":"2023-11-17T21:21:11.585Z","2.0.0-dev.7.4.0.214930":"2023-11-28T23:40:09.437Z","2.0.0-dev.7.4.0.215366":"2023-11-29T23:07:19.473Z","2.0.0-dev.7.4.0.215747":"2023-11-30T17:32:12.123Z","2.0.0-dev.7.4.0.215930":"2023-11-30T20:42:45.589Z","2.0.0-dev.7.4.0.216897":"2023-12-01T21:45:50.084Z","2.0.0-dev.7.4.0.217212":"2023-12-02T18:10:35.416Z","2.0.0-dev.7.4.0.217884":"2023-12-05T19:55:03.831Z","2.0.0-dev.7.4.0.221926":"2023-12-13T00:48:00.118Z","2.0.0-internal.7.4.0":"2023-12-13T18:02:42.267Z","2.0.0-internal.8.0.0":"2023-12-14T03:26:17.036Z","2.0.0-internal.8.0.1":"2024-01-05T17:57:11.669Z","2.0.0-internal.8.0.2":"2024-01-10T22:31:09.039Z","2.0.0-internal.7.4.1":"2024-01-10T23:50:04.224Z","2.0.0-internal.7.4.2":"2024-01-16T19:58:37.107Z","2.0.0-internal.8.0.3":"2024-01-16T20:04:52.775Z","2.0.0-internal.7.4.3":"2024-01-18T23:04:01.272Z","2.0.0-internal.8.0.4":"2024-01-18T23:16:21.922Z","2.0.0-internal.7.4.4":"2024-02-06T19:02:09.116Z","2.0.0-internal.7.4.5":"2024-02-07T22:11:37.775Z","2.0.0-internal.7.4.6":"2024-02-08T00:57:19.920Z","2.0.0-internal.8.0.5":"2024-02-08T19:31:37.116Z","2.0.0-internal.8.0.6":"2024-02-13T00:13:56.535Z","2.0.0-internal.7.4.7":"2024-02-13T00:21:26.243Z","2.0.0-internal.8.0.7":"2024-02-28T19:00:35.405Z","2.0.0-internal.8.0.8":"2024-03-20T00:23:15.331Z"},"bugs":{"url":"https://github.com/microsoft/FluidFramework/issues"},"author":{"name":"Microsoft and contributors"},"license":"MIT","homepage":"https://fluidframework.com","repository":{"url":"git+https://github.com/microsoft/FluidFramework.git","type":"git","directory":"packages/tools/devtools/devtools-core"},"description":"Fluid Framework developer tools core functionality","maintainers":[{"email":"ffsa@microsoft.com","name":"ms-fluid-bot"},{"email":"microsoft-oss-publishing@microsoft.com","name":"microsoft-oss-releases"},{"email":"npmjs@microsoft.com","name":"microsoft1es"}],"readme":"","readmeFilename":""}