@fluidframework/devtools-core 2.70.0-360753 → 2.70.0-361248

package/dist/DevtoolsLogger.js.map

@@ -1 +1 @@
-{"version":3,"file":"DevtoolsLogger.js","sourceRoot":"","sources":["../src/DevtoolsLogger.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAQH,mDAS8B;AAkB9B;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,cAAc;IAuDnB,aAAa;IAEb,YAAmB,UAAiC;QA7CpD;;WAEG;QACc,0BAAqB,GAA0B;YAC/D,OAAO,EAAE,qBAAqB;SAC9B,CAAC;QAEF;;WAEG;QACc,2BAAsB,GAAoB;YAC1D,CAAC,8BAAmB,CAAC,WAAW,CAAC,EAAE,KAAK,EAAE,cAAc,EAAE,EAAE;gBAC3D,IAAI,CAAC,cAAc,EAAE,CAAC;gBACtB,OAAO,IAAI,CAAC;YACb,CAAC;SACD,CAAC;QAEF;;WAEG;QACc,yBAAoB,GAAG,CACvC,KAA8C,EACvC,EAAE;YACT,IAAA,sCAA2B,EAC1B,KAAK,EACL,IAAI,CAAC,sBAAsB,EAC3B,IAAI,CAAC,qBAAqB,CAC1B,CAAC;QACH,CAAC,CAAC;QAEF;;;WAGG;QACc,mBAAc,GAAG,GAAS,EAAE;YAC5C,IAAA,+BAAoB,EACnB,IAAI,CAAC,qBAAqB,EAC1B,2BAAgB,CAAC,aAAa,CAAC;gBAC9B,QAAQ,EAAE,IAAI,CAAC,aAAa;aAC5B,CAAC,CACF,CAAC;QACH,CAAC,CAAC;QAKD,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAE7B,IAAI,CAAC,aAAa,GAAG,EAAE,CAAC;QAExB,sEAAsE;QACtE,UAAU,CAAC,gBAAgB,EAAE,CAAC,SAAS,EAAE,IAAI,CAAC,oBAAoB,CAAC,CAAC;IACrE,CAAC;IAED;;;;OAIG;IACI,IAAI,CAAC,KAA0B;QACrC,+BAA+B;QAC/B,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QAE7B,IAAI,CAAC;YACJ,MAAM,QAAQ,GAA+B;gBAC5C,UAAU,EAAE,KAAK;gBACjB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;aACrB,CAAC;YAEF,0EAA0E;YAC1E,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;YAErC,0GAA0G;YAC1G,IAAA,+BAAoB,EACnB,SAAS,EACT,yBAAc,CAAC,aAAa,CAAC;gBAC5B,KAAK,EAAE,QAAQ;aACf,CAAC,CACF,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,uFAAuF;YACvF,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACtB,CAAC;IACF,CAAC;CACD;AAED;;;;GAIG;AACH,SAAgB,oBAAoB,CAAC,UAAiC;IACrE,OAAO,IAAI,cAAc,CAAC,UAAU,CAAC,CAAC;AACvC,CAAC;AAFD,oDAEC","sourcesContent":["/*!\n * Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n */\n\nimport type {\n\tITelemetryBaseEvent,\n\tITelemetryBaseLogger,\n} from \"@fluidframework/core-interfaces\";\n\nimport type { ITimestampedTelemetryEvent } from \"./TelemetryMetadata.js\";\nimport {\n\tGetTelemetryHistory,\n\ttype IDevtoolsMessage,\n\ttype InboundHandlers,\n\ttype MessageLoggingOptions,\n\tTelemetryEvent,\n\tTelemetryHistory,\n\thandleIncomingWindowMessage,\n\tpostMessagesToWindow,\n} from \"./messaging/index.js\";\n\n/**\n * Logger implementation that posts all telemetry events to the window (globalThis object).\n * This logger is intended to integrate with the Fluid DevTools browser extension.\n *\n * @remarks Note: external implementations of this interface are not supported.\n * An `IDevtoolsLogger` can be created via {@link createDevtoolsLogger} - this logger may then be provided to the Fluid\n * runtime to ensure telemetry messages are flowing to it.\n * If you wish to enable telemetry functionality in the devtools, you **must** pass this same logger back when\n * initializing the Devtools.\n *\n * @sealed\n * @beta\n */\n// eslint-disable-next-line @typescript-eslint/no-empty-interface\nexport interface IDevtoolsLogger extends ITelemetryBaseLogger {}\n\n/**\n * Logger implementation that posts all telemetry events to the window (globalThis object).\n * This logger is intended to integrate with the Fluid DevTools browser extension.\n *\n * @remarks\n *\n * This logger optionally wraps a provided base logger, and forwards all events to that logger (in addition to posting\n * data to the window).\n *\n * **Messages it listens for:**\n *\n * - {@link GetTelemetryHistory.Message}: When received, the logger will broadcast {@link TelemetryHistory.Message}.\n *\n * TODO: Document others as they are added.\n *\n * **Messages it posts:**\n *\n * - {@link TelemetryHistory.Message}: This is posted when requested (via {@link GetTelemetryHistory.Message}).\n * - {@link TelemetryEvent.Message}: This is posted any time a telemetry event is logged.\n *\n * TODO: Document others as they are added.\n *\n * @sealed\n */\nclass DevtoolsLogger implements IDevtoolsLogger {\n\t/**\n\t * Base telemetry logger provided by the consumer.\n\t * All messages sent to the Devtools logger will be forwarded to this.\n\t */\n\tprivate readonly baseLogger: ITelemetryBaseLogger | undefined;\n\n\t/**\n\t * Accumulated data for Telemetry logs.\n\t */\n\tprivate readonly _telemetryLog: ITimestampedTelemetryEvent[];\n\n\t/**\n\t * Message logging options used by the logger.\n\t */\n\tprivate readonly messageLoggingOptions: MessageLoggingOptions = {\n\t\tcontext: `FluidDevtoolsLogger`,\n\t};\n\n\t/**\n\t * Handlers for inbound messages related to the logger.\n\t */\n\tprivate readonly inboundMessageHandlers: InboundHandlers = {\n\t\t[GetTelemetryHistory.MessageType]: async (untypedMessage) => {\n\t\t\tthis.postLogHistory();\n\t\t\treturn true;\n\t\t},\n\t};\n\n\t/**\n\t * Event handler for messages coming from the window (globalThis).\n\t */\n\tprivate readonly windowMessageHandler = (\n\t\tevent: MessageEvent<Partial<IDevtoolsMessage>>,\n\t): void => {\n\t\thandleIncomingWindowMessage(\n\t\t\tevent,\n\t\t\tthis.inboundMessageHandlers,\n\t\t\tthis.messageLoggingOptions,\n\t\t);\n\t};\n\n\t/**\n\t * Posts a {@link TelemetryHistory.Message} to the window (globalThis) containing the complete history of\n\t * telemetry events.\n\t */\n\tprivate readonly postLogHistory = (): void => {\n\t\tpostMessagesToWindow(\n\t\t\tthis.messageLoggingOptions,\n\t\t\tTelemetryHistory.createMessage({\n\t\t\t\tcontents: this._telemetryLog,\n\t\t\t}),\n\t\t);\n\t};\n\n\t// #endregion\n\n\tpublic constructor(baseLogger?: ITelemetryBaseLogger) {\n\t\tthis.baseLogger = baseLogger;\n\n\t\tthis._telemetryLog = [];\n\n\t\t// Register listener for inbound messages from the window (globalThis)\n\t\tglobalThis.addEventListener?.(\"message\", this.windowMessageHandler);\n\t}\n\n\t/**\n\t * Post a {@link TelemetryEvent.Message} to the window (globalThis) for the provided telemetry event.\n\t *\n\t * @param event - The telemetry event to send.\n\t */\n\tpublic send(event: ITelemetryBaseEvent): void {\n\t\t// Forward event to base logger\n\t\tthis.baseLogger?.send(event);\n\n\t\ttry {\n\t\t\tconst newEvent: ITimestampedTelemetryEvent = {\n\t\t\t\tlogContent: event,\n\t\t\t\ttimestamp: Date.now(),\n\t\t\t};\n\n\t\t\t// insert log into the beginning of the array to show the latest log first\n\t\t\tthis._telemetryLog.unshift(newEvent);\n\n\t\t\t// set log option to be undefined to avoid sending the log message to window console; these were too noisy\n\t\t\tpostMessagesToWindow(\n\t\t\t\tundefined,\n\t\t\t\tTelemetryEvent.createMessage({\n\t\t\t\t\tevent: newEvent,\n\t\t\t\t}),\n\t\t\t);\n\t\t} catch (error) {\n\t\t\t// Eat the error to ensure that Devtools logic doesn't crash the consuming application.\n\t\t\tconsole.error(error);\n\t\t}\n\t}\n}\n\n/**\n * Creates a new {@link IDevtoolsLogger} by wrapping the provided (optional) base logger.\n *\n * @beta\n */\nexport function createDevtoolsLogger(baseLogger?: ITelemetryBaseLogger): IDevtoolsLogger {\n\treturn new DevtoolsLogger(baseLogger);\n}\n"]}
+{"version":3,"file":"DevtoolsLogger.js","sourceRoot":"","sources":["../src/DevtoolsLogger.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAQH,mDAS8B;AAkB9B;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,cAAc;IAuDnB,aAAa;IAEb,YAAmB,UAAiC;QA7CpD;;WAEG;QACc,0BAAqB,GAA0B;YAC/D,OAAO,EAAE,qBAAqB;SAC9B,CAAC;QAEF;;WAEG;QACc,2BAAsB,GAAoB;YAC1D,CAAC,8BAAmB,CAAC,WAAW,CAAC,EAAE,KAAK,EAAE,cAAc,EAAE,EAAE;gBAC3D,IAAI,CAAC,cAAc,EAAE,CAAC;gBACtB,OAAO,IAAI,CAAC;YACb,CAAC;SACD,CAAC;QAEF;;WAEG;QACc,yBAAoB,GAAG,CACvC,KAA8C,EACvC,EAAE;YACT,IAAA,sCAA2B,EAC1B,KAAK,EACL,IAAI,CAAC,sBAAsB,EAC3B,IAAI,CAAC,qBAAqB,CAC1B,CAAC;QACH,CAAC,CAAC;QAEF;;;WAGG;QACc,mBAAc,GAAG,GAAS,EAAE;YAC5C,IAAA,+BAAoB,EACnB,IAAI,CAAC,qBAAqB,EAC1B,2BAAgB,CAAC,aAAa,CAAC;gBAC9B,QAAQ,EAAE,IAAI,CAAC,aAAa;aAC5B,CAAC,CACF,CAAC;QACH,CAAC,CAAC;QAKD,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAE7B,IAAI,CAAC,aAAa,GAAG,EAAE,CAAC;QAExB,sEAAsE;QACtE,UAAU,CAAC,gBAAgB,EAAE,CAAC,SAAS,EAAE,IAAI,CAAC,oBAAoB,CAAC,CAAC;IACrE,CAAC;IAED;;;;OAIG;IACI,IAAI,CAAC,KAA0B;QACrC,+BAA+B;QAC/B,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QAE7B,IAAI,CAAC;YACJ,MAAM,QAAQ,GAA+B;gBAC5C,UAAU,EAAE,KAAK;gBACjB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;aACrB,CAAC;YAEF,0EAA0E;YAC1E,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;YAErC,0GAA0G;YAC1G,IAAA,+BAAoB,EACnB,SAAS,EACT,yBAAc,CAAC,aAAa,CAAC;gBAC5B,KAAK,EAAE,QAAQ;aACf,CAAC,CACF,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,uFAAuF;YACvF,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACtB,CAAC;IACF,CAAC;CACD;AAED;;;;GAIG;AACH,SAAgB,oBAAoB,CAAC,UAAiC;IACrE,OAAO,IAAI,cAAc,CAAC,UAAU,CAAC,CAAC;AACvC,CAAC;AAFD,oDAEC","sourcesContent":["/*!\n * Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n */\n\nimport type {\n\tITelemetryBaseEvent,\n\tITelemetryBaseLogger,\n} from \"@fluidframework/core-interfaces\";\n\nimport type { ITimestampedTelemetryEvent } from \"./TelemetryMetadata.js\";\nimport {\n\tGetTelemetryHistory,\n\ttype IDevtoolsMessage,\n\ttype InboundHandlers,\n\ttype MessageLoggingOptions,\n\tTelemetryEvent,\n\tTelemetryHistory,\n\thandleIncomingWindowMessage,\n\tpostMessagesToWindow,\n} from \"./messaging/index.js\";\n\n/**\n * Logger implementation that posts all telemetry events to the window (globalThis object).\n * This logger is intended to integrate with the Fluid DevTools browser extension.\n *\n * @remarks Note: external implementations of this interface are not supported.\n * An `IDevtoolsLogger` can be created via {@link createDevtoolsLogger} - this logger may then be provided to the Fluid\n * runtime to ensure telemetry messages are flowing to it.\n * If you wish to enable telemetry functionality in the devtools, you **must** pass this same logger back when\n * initializing the Devtools.\n *\n * @sealed\n * @beta\n */\n// eslint-disable-next-line @typescript-eslint/no-empty-object-type, @typescript-eslint/no-empty-interface\nexport interface IDevtoolsLogger extends ITelemetryBaseLogger {}\n\n/**\n * Logger implementation that posts all telemetry events to the window (globalThis object).\n * This logger is intended to integrate with the Fluid DevTools browser extension.\n *\n * @remarks\n *\n * This logger optionally wraps a provided base logger, and forwards all events to that logger (in addition to posting\n * data to the window).\n *\n * **Messages it listens for:**\n *\n * - {@link GetTelemetryHistory.Message}: When received, the logger will broadcast {@link TelemetryHistory.Message}.\n *\n * TODO: Document others as they are added.\n *\n * **Messages it posts:**\n *\n * - {@link TelemetryHistory.Message}: This is posted when requested (via {@link GetTelemetryHistory.Message}).\n * - {@link TelemetryEvent.Message}: This is posted any time a telemetry event is logged.\n *\n * TODO: Document others as they are added.\n *\n * @sealed\n */\nclass DevtoolsLogger implements IDevtoolsLogger {\n\t/**\n\t * Base telemetry logger provided by the consumer.\n\t * All messages sent to the Devtools logger will be forwarded to this.\n\t */\n\tprivate readonly baseLogger: ITelemetryBaseLogger | undefined;\n\n\t/**\n\t * Accumulated data for Telemetry logs.\n\t */\n\tprivate readonly _telemetryLog: ITimestampedTelemetryEvent[];\n\n\t/**\n\t * Message logging options used by the logger.\n\t */\n\tprivate readonly messageLoggingOptions: MessageLoggingOptions = {\n\t\tcontext: `FluidDevtoolsLogger`,\n\t};\n\n\t/**\n\t * Handlers for inbound messages related to the logger.\n\t */\n\tprivate readonly inboundMessageHandlers: InboundHandlers = {\n\t\t[GetTelemetryHistory.MessageType]: async (untypedMessage) => {\n\t\t\tthis.postLogHistory();\n\t\t\treturn true;\n\t\t},\n\t};\n\n\t/**\n\t * Event handler for messages coming from the window (globalThis).\n\t */\n\tprivate readonly windowMessageHandler = (\n\t\tevent: MessageEvent<Partial<IDevtoolsMessage>>,\n\t): void => {\n\t\thandleIncomingWindowMessage(\n\t\t\tevent,\n\t\t\tthis.inboundMessageHandlers,\n\t\t\tthis.messageLoggingOptions,\n\t\t);\n\t};\n\n\t/**\n\t * Posts a {@link TelemetryHistory.Message} to the window (globalThis) containing the complete history of\n\t * telemetry events.\n\t */\n\tprivate readonly postLogHistory = (): void => {\n\t\tpostMessagesToWindow(\n\t\t\tthis.messageLoggingOptions,\n\t\t\tTelemetryHistory.createMessage({\n\t\t\t\tcontents: this._telemetryLog,\n\t\t\t}),\n\t\t);\n\t};\n\n\t// #endregion\n\n\tpublic constructor(baseLogger?: ITelemetryBaseLogger) {\n\t\tthis.baseLogger = baseLogger;\n\n\t\tthis._telemetryLog = [];\n\n\t\t// Register listener for inbound messages from the window (globalThis)\n\t\tglobalThis.addEventListener?.(\"message\", this.windowMessageHandler);\n\t}\n\n\t/**\n\t * Post a {@link TelemetryEvent.Message} to the window (globalThis) for the provided telemetry event.\n\t *\n\t * @param event - The telemetry event to send.\n\t */\n\tpublic send(event: ITelemetryBaseEvent): void {\n\t\t// Forward event to base logger\n\t\tthis.baseLogger?.send(event);\n\n\t\ttry {\n\t\t\tconst newEvent: ITimestampedTelemetryEvent = {\n\t\t\t\tlogContent: event,\n\t\t\t\ttimestamp: Date.now(),\n\t\t\t};\n\n\t\t\t// insert log into the beginning of the array to show the latest log first\n\t\t\tthis._telemetryLog.unshift(newEvent);\n\n\t\t\t// set log option to be undefined to avoid sending the log message to window console; these were too noisy\n\t\t\tpostMessagesToWindow(\n\t\t\t\tundefined,\n\t\t\t\tTelemetryEvent.createMessage({\n\t\t\t\t\tevent: newEvent,\n\t\t\t\t}),\n\t\t\t);\n\t\t} catch (error) {\n\t\t\t// Eat the error to ensure that Devtools logic doesn't crash the consuming application.\n\t\t\tconsole.error(error);\n\t\t}\n\t}\n}\n\n/**\n * Creates a new {@link IDevtoolsLogger} by wrapping the provided (optional) base logger.\n *\n * @beta\n */\nexport function createDevtoolsLogger(baseLogger?: ITelemetryBaseLogger): IDevtoolsLogger {\n\treturn new DevtoolsLogger(baseLogger);\n}\n"]}

package/dist/data-visualization/SharedTreeVisualizer.d.ts

@@ -13,7 +13,7 @@ export declare function determineNodeKind(nodeKind: VisualNodeKind): VisualNodeK
 /**
  * Converts the visual representation from {@link visualizeNodeBySchema} to a visual tree compatible with the devtools-view.
  * @param tree - the visual representation of the SharedTree.
- * @returns - the visual representation of type {@link VisualChildNode}
+ * @returns the visual representation of type {@link VisualChildNode}
  */
 export declare function toVisualTree(tree: VisualSharedTreeNode): VisualChildNode;
 /**

package/dist/data-visualization/SharedTreeVisualizer.js

@@ -30,7 +30,7 @@ exports.determineNodeKind = determineNodeKind;
 /**
  * Returns allowed types of the non-leaf nodes in the tree.
  * @param allowedTypes - a string if array node, `Record<string, string>` for non-array nodes.
- * @returns - a VisualChildNode with the allowed type.
+ * @returns a VisualChildNode with the allowed type.
  */
 function createAllowedTypesVisualTree(allowedTypes) {
     if (typeof allowedTypes === "string") {
@@ -78,7 +78,7 @@ function createToolTipContents(schema) {
 /**
  * Converts the visual representation from {@link visualizeNodeBySchema} to a visual tree compatible with the devtools-view.
  * @param tree - the visual representation of the SharedTree.
- * @returns - the visual representation of type {@link VisualChildNode}
+ * @returns the visual representation of type {@link VisualChildNode}
  */
 function toVisualTree(tree) {
     if (tree.kind === VisualSharedTreeTypes_js_1.VisualSharedTreeNodeKind.LeafNode) {

package/dist/data-visualization/SharedTreeVisualizer.js.map

@@ -1 +1 @@
-{"version":3,"file":"SharedTreeVisualizer.js","sourceRoot":"","sources":["../../src/data-visualization/SharedTreeVisualizer.ts"],"names":[],"mappings":"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","sourcesContent":["/*!\n * Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n */\n\nimport { FieldKind } from \"@fluidframework/tree\";\nimport type {\n\tSimpleArrayNodeSchema,\n\tSimpleMapNodeSchema,\n\tSimpleNodeSchema,\n\tSimpleObjectNodeSchema,\n\tVerboseTree,\n\tVerboseTreeNode,\n} from \"@fluidframework/tree/internal\";\nimport { NodeKind, SchemaFactory, Tree } from \"@fluidframework/tree/internal\";\n\nimport type { VisualizeChildData } from \"./DataVisualization.js\";\nimport type { VisualSharedTreeNode, SharedTreeSchemaNode } from \"./VisualSharedTreeTypes.js\";\nimport { VisualSharedTreeNodeKind } from \"./VisualSharedTreeTypes.js\";\nimport {\n\ttype VisualChildNode,\n\tVisualNodeKind,\n\ttype VisualValueNode,\n\ttype VisualTreeNode,\n\ttype FluidHandleNode,\n\ttype UnknownObjectNode,\n} from \"./VisualTree.js\";\n\n/**\n * Returns VisualNodeKind that is compatible to {@link FluidObjectNode} based on the `visualTree`'s node kind.\n */\nexport function determineNodeKind(nodeKind: VisualNodeKind): VisualNodeKind {\n\tswitch (nodeKind) {\n\t\tcase VisualNodeKind.TreeNode:\n\t\tcase VisualNodeKind.FluidHandleNode: {\n\t\t\treturn VisualNodeKind.FluidTreeNode;\n\t\t}\n\t\tcase VisualNodeKind.ValueNode: {\n\t\t\treturn VisualNodeKind.FluidValueNode;\n\t\t}\n\t\tdefault: {\n\t\t\treturn VisualNodeKind.FluidUnknownObjectNode;\n\t\t}\n\t}\n}\n\n/**\n * Returns allowed types of the non-leaf nodes in the tree.\n * @param allowedTypes - a string if array node, `Record<string, string>` for non-array nodes.\n * @returns - a VisualChildNode with the allowed type.\n */\nfunction createAllowedTypesVisualTree(\n\tallowedTypes: string | Record<string, string>,\n): VisualChildNode {\n\tif (typeof allowedTypes === \"string\") {\n\t\treturn {\n\t\t\tvalue: allowedTypes,\n\t\t\tnodeKind: VisualNodeKind.ValueNode,\n\t\t};\n\t}\n\n\tconst result: Record<string, VisualValueNode> = {};\n\tfor (const [allowedTypeKey, allowedType] of Object.entries(allowedTypes)) {\n\t\tresult[allowedTypeKey] = {\n\t\t\tnodeKind: VisualNodeKind.ValueNode,\n\t\t\tvalue: allowedType,\n\t\t};\n\t}\n\n\treturn {\n\t\tchildren: result,\n\t\tnodeKind: VisualNodeKind.TreeNode,\n\t};\n}\n\n/**\n * Creates a visual representation of the schema of the tree in {@link VisualTreeNode} format.\n */\nfunction createToolTipContents(schema: SharedTreeSchemaNode): VisualTreeNode {\n\tconst children: Record<string, VisualChildNode> = {\n\t\tname: {\n\t\t\tnodeKind: VisualNodeKind.ValueNode,\n\t\t\tvalue: schema.schemaName,\n\t\t},\n\t};\n\tif (schema.allowedTypes !== undefined) {\n\t\tchildren.allowedTypes = createAllowedTypesVisualTree(schema.allowedTypes);\n\t}\n\tif (schema.isRequired !== undefined) {\n\t\tchildren.isRequired = {\n\t\t\tnodeKind: VisualNodeKind.ValueNode,\n\t\t\tvalue: schema.isRequired,\n\t\t};\n\t}\n\treturn {\n\t\tnodeKind: VisualNodeKind.TreeNode,\n\t\tchildren,\n\t};\n}\n\n/**\n * Converts the visual representation from {@link visualizeNodeBySchema} to a visual tree compatible with the devtools-view.\n * @param tree - the visual representation of the SharedTree.\n * @returns - the visual representation of type {@link VisualChildNode}\n */\nexport function toVisualTree(tree: VisualSharedTreeNode): VisualChildNode {\n\tif (tree.kind === VisualSharedTreeNodeKind.LeafNode) {\n\t\tswitch (tree.value.nodeKind) {\n\t\t\tcase VisualNodeKind.ValueNode: {\n\t\t\t\tconst result: VisualValueNode = {\n\t\t\t\t\tvalue: tree.value.value,\n\t\t\t\t\tnodeKind: VisualNodeKind.ValueNode,\n\t\t\t\t\ttooltipContents: {\n\t\t\t\t\t\tschema: createToolTipContents(tree.schema),\n\t\t\t\t\t},\n\t\t\t\t};\n\t\t\t\treturn result;\n\t\t\t}\n\t\t\tcase VisualNodeKind.FluidHandleNode: {\n\t\t\t\tconst result: FluidHandleNode = {\n\t\t\t\t\tfluidObjectId: tree.value.fluidObjectId,\n\t\t\t\t\tnodeKind: VisualNodeKind.FluidHandleNode,\n\t\t\t\t\ttooltipContents: {\n\t\t\t\t\t\tschema: createToolTipContents(tree.schema),\n\t\t\t\t\t},\n\t\t\t\t};\n\t\t\t\treturn result;\n\t\t\t}\n\t\t\tdefault: {\n\t\t\t\tconsole.error(`Unknown node kind: ${tree.value.nodeKind}`);\n\t\t\t\tconst result: UnknownObjectNode = {\n\t\t\t\t\tnodeKind: VisualNodeKind.UnknownObjectNode,\n\t\t\t\t\ttooltipContents: {\n\t\t\t\t\t\tschema: createToolTipContents(tree.schema),\n\t\t\t\t\t},\n\t\t\t\t};\n\t\t\t\treturn result;\n\t\t\t}\n\t\t}\n\t} else {\n\t\tconst children: Record<string, VisualChildNode> = {};\n\n\t\tfor (const [key, value] of Object.entries(tree.fields)) {\n\t\t\tconst child = toVisualTree(value);\n\t\t\tchildren[key] = child;\n\t\t}\n\n\t\treturn {\n\t\t\tchildren,\n\t\t\tnodeKind: VisualNodeKind.TreeNode,\n\t\t\ttooltipContents: {\n\t\t\t\tschema: createToolTipContents(tree.schema),\n\t\t\t},\n\t\t};\n\t}\n}\n\n/**\n * Concatenate allowed types for `ObjectNodeStoredSchema` and `MapNodeStoredSchema`.\n */\nexport function concatenateTypes(fieldTypes: ReadonlySet<string>): string {\n\treturn [...fieldTypes].join(\" | \");\n}\n\n/**\n * Properties that describe schema constraints for a field in the tree\n */\ninterface FieldSchemaProperties {\n\tallowedTypes: ReadonlySet<string> | undefined;\n\n\t/**\n\t * Whether the field is required (true) or optional (false).\n\t *\n\t * `undefined` indicates that the field is implicitly required.\n\t * In this case, no requirement information will be displayed by the devtools.\n\t */\n\tisRequired: boolean | undefined;\n}\n\n/**\n * Processes and visualizes the fields of a verbose tree node.\n *\n * @param treeFields - The fields of the tree node to visualize. Can be either an array of VerboseTree (for array nodes) or a Record of field names to VerboseTree (for object/map nodes).\n * @param treeDefinitions - Map containing all schema definitions for the entire tree structure. Each definition describes the shape and constraints of a particular node type.\n * @param fieldSchemaProperties - Record mapping field names to their schema properties, including allowed types and whether they are required.\n * @param visualizeChildData - Callback function to visualize child node data.\n *\n * @returns A record mapping field names/indices to their visual tree representations.\n */\nasync function visualizeVerboseNodeFields(\n\ttreeFields: readonly VerboseTree[] | Record<string, VerboseTree>,\n\ttreeDefinitions: ReadonlyMap<string, SimpleNodeSchema>,\n\tfieldSchemaProperties: Record<string, FieldSchemaProperties>,\n\tvisualizeChildData: VisualizeChildData,\n): Promise<Record<string, VisualSharedTreeNode>> {\n\tconst fields: Record<string | number, VisualSharedTreeNode> = {};\n\n\tfor (const [fieldKey, childField] of Object.entries(treeFields)) {\n\t\tfields[fieldKey] = await visualizeSharedTreeBySchema(\n\t\t\tchildField,\n\t\t\ttreeDefinitions,\n\t\t\t{\n\t\t\t\tallowedTypes: fieldSchemaProperties[fieldKey]?.allowedTypes,\n\t\t\t\tisRequired: fieldSchemaProperties[fieldKey]?.isRequired,\n\t\t\t},\n\t\t\tvisualizeChildData,\n\t\t);\n\t}\n\n\treturn fields;\n}\n\n/**\n * Returns the schema & fields of the node with type {@link ObjectNodeStoredSchema}.\n */\nasync function visualizeObjectNode(\n\ttree: VerboseTreeNode,\n\tschema: SimpleObjectNodeSchema,\n\ttreeDefinitions: ReadonlyMap<string, SimpleNodeSchema>,\n\t{ allowedTypes, isRequired }: FieldSchemaProperties,\n\tvisualizeChildData: VisualizeChildData,\n): Promise<VisualSharedTreeNode> {\n\tconst objectNodeSchemaProperties: Record<string, FieldSchemaProperties> = {};\n\tfor (const [fieldKey, treeFieldSimpleSchema] of schema.fields) {\n\t\tobjectNodeSchemaProperties[fieldKey] = {\n\t\t\tallowedTypes: treeFieldSimpleSchema.allowedTypesIdentifiers,\n\t\t\tisRequired: treeFieldSimpleSchema.kind === FieldKind.Required ? true : false,\n\t\t};\n\t}\n\n\treturn {\n\t\tschema: {\n\t\t\tschemaName: tree.type,\n\t\t\tallowedTypes: concatenateTypes(allowedTypes ?? new Set()),\n\t\t\tisRequired: isRequired?.toString(),\n\t\t},\n\t\tfields: await visualizeVerboseNodeFields(\n\t\t\ttree.fields,\n\t\t\ttreeDefinitions,\n\t\t\tobjectNodeSchemaProperties,\n\t\t\tvisualizeChildData,\n\t\t),\n\t\tkind: VisualSharedTreeNodeKind.InternalNode,\n\t};\n}\n\n/**\n * Returns the schema & fields of the node with type {@link MapNodeStoredSchema}.\n */\nasync function visualizeMapNode(\n\ttree: VerboseTreeNode,\n\tschema: SimpleMapNodeSchema,\n\ttreeDefinitions: ReadonlyMap<string, SimpleNodeSchema>,\n\t{ allowedTypes, isRequired }: FieldSchemaProperties,\n\tvisualizeChildData: VisualizeChildData,\n): Promise<VisualSharedTreeNode> {\n\tconst mapNodeSchemaProperties: Record<string, FieldSchemaProperties> = {};\n\tfor (const key of Object.keys(tree.fields)) {\n\t\tmapNodeSchemaProperties[key] = {\n\t\t\tallowedTypes: schema.allowedTypesIdentifiers,\n\t\t\t// Map values are always required. Don't display field requirement information, since that information is redundant.\n\t\t\tisRequired: undefined,\n\t\t};\n\t}\n\n\treturn {\n\t\tschema: {\n\t\t\tschemaName: tree.type,\n\t\t\tallowedTypes: concatenateTypes(allowedTypes ?? new Set()),\n\t\t\tisRequired: isRequired?.toString(),\n\t\t},\n\t\tfields: await visualizeVerboseNodeFields(\n\t\t\ttree.fields,\n\t\t\ttreeDefinitions,\n\t\t\tmapNodeSchemaProperties,\n\t\t\tvisualizeChildData,\n\t\t),\n\t\tkind: VisualSharedTreeNodeKind.InternalNode,\n\t};\n}\n\n/**\n * Returns the schema & fields of the node with type {@link ArrayNodeStoredSchema}.\n */\nasync function visualizeArrayNode(\n\ttree: VerboseTreeNode,\n\tschema: SimpleArrayNodeSchema,\n\ttreeDefinitions: ReadonlyMap<string, SimpleNodeSchema>,\n\t{ allowedTypes, isRequired }: FieldSchemaProperties,\n\tvisualizeChildData: VisualizeChildData,\n): Promise<VisualSharedTreeNode> {\n\tconst children = tree.fields;\n\tif (!Array.isArray(children)) {\n\t\tthrow new TypeError(\"Invalid array\");\n\t}\n\n\tconst arrayNodeSchemaProperties: Record<string, FieldSchemaProperties> = {};\n\tfor (const [i] of children.entries()) {\n\t\tarrayNodeSchemaProperties[i] = {\n\t\t\tallowedTypes: schema.allowedTypesIdentifiers,\n\t\t\t// Array values are always required. Don't display field requirement information, since that information is redundant.\n\t\t\tisRequired: undefined,\n\t\t};\n\t}\n\n\treturn {\n\t\tschema: {\n\t\t\tschemaName: tree.type,\n\t\t\tallowedTypes: concatenateTypes(allowedTypes ?? new Set()),\n\t\t\tisRequired: isRequired?.toString(),\n\t\t},\n\t\tfields: await visualizeVerboseNodeFields(\n\t\t\ttree.fields,\n\t\t\ttreeDefinitions,\n\t\t\tarrayNodeSchemaProperties,\n\t\t\tvisualizeChildData,\n\t\t),\n\t\tkind: VisualSharedTreeNodeKind.InternalNode,\n\t};\n}\n\n/**\n * Creates the visual representation of non-leaf SharedTree nodes.\n *\n * @remarks\n * Processes internal tree nodes based on their schema type (e.g., ObjectNodeStoredSchema, MapNodeStoredSchema, ArrayNodeStoredSchema),\n * producing the visual representation for each type.\n *\n * @see {@link https://fluidframework.com/docs/data-structures/tree/} for more information on the SharedTree schema.\n *\n * @remarks\n */\nasync function visualizeNodeBySchema(\n\ttree: VerboseTreeNode,\n\ttreeDefinitions: ReadonlyMap<string, SimpleNodeSchema>,\n\t{ allowedTypes, isRequired }: FieldSchemaProperties,\n\tvisualizeChildData: VisualizeChildData,\n): Promise<VisualSharedTreeNode> {\n\tconst schema = treeDefinitions.get(tree.type);\n\n\tif (schema === undefined) {\n\t\tthrow new TypeError(\"Unrecognized schema type.\");\n\t}\n\n\tswitch (schema.kind) {\n\t\tcase NodeKind.Object: {\n\t\t\tconst objectVisualized = visualizeObjectNode(\n\t\t\t\ttree,\n\t\t\t\tschema,\n\t\t\t\ttreeDefinitions,\n\t\t\t\t{ allowedTypes, isRequired },\n\t\t\t\tvisualizeChildData,\n\t\t\t);\n\t\t\treturn objectVisualized;\n\t\t}\n\t\tcase NodeKind.Map: {\n\t\t\tconst mapVisualized = visualizeMapNode(\n\t\t\t\ttree,\n\t\t\t\tschema,\n\t\t\t\ttreeDefinitions,\n\t\t\t\t{ allowedTypes, isRequired },\n\t\t\t\tvisualizeChildData,\n\t\t\t);\n\t\t\treturn mapVisualized;\n\t\t}\n\t\tcase NodeKind.Array: {\n\t\t\treturn visualizeArrayNode(\n\t\t\t\ttree,\n\t\t\t\tschema,\n\t\t\t\ttreeDefinitions,\n\t\t\t\t{ allowedTypes, isRequired },\n\t\t\t\tvisualizeChildData,\n\t\t\t);\n\t\t}\n\t\tdefault: {\n\t\t\tthrow new TypeError(\"Unrecognized schema type.\");\n\t\t}\n\t}\n}\n\n/**\n * Creates a visual representation of a SharedTree based on its schema.\n * @param tree - The {@link VerboseTree} to visualize\n * @param treeDefinitions - Map containing all schema definitions for the entire tree structure. Each definition\n * describes the shape and constraints of a particular node type.\n * @param fieldSchemaProperties - Properties describing schema constraints for this field:\n * - `allowedTypes`: Set of type names that are valid for this specific node position in the tree.\n * This is a subset of the types defined in treeDefinitions.\n * - `isRequired`: Whether this field is required in its parent object schema.\n * Only meaningful for direct children of object nodes.\n * Undefined for array/map elements since they are always required within their parent.\n * @param visualizeChildData - Callback function to visualize child node data\n * @returns A visual representation of the tree that includes schema information and node values\n *\n * @remarks\n * This function handles both leaf nodes (primitive values, handles) and internal nodes (objects, maps, arrays).\n * For leaf nodes, it creates a visual representation with the node's schema and value.\n * For internal nodes, it recursively processes the node's fields using {@link visualizeNodeBySchema}.\n */\nexport async function visualizeSharedTreeBySchema(\n\ttree: VerboseTree,\n\ttreeDefinitions: ReadonlyMap<string, SimpleNodeSchema>,\n\t{ allowedTypes, isRequired }: FieldSchemaProperties,\n\tvisualizeChildData: VisualizeChildData,\n): Promise<VisualSharedTreeNode> {\n\treturn Tree.is(tree, SchemaFactory.leaves)\n\t\t? {\n\t\t\t\tschema: {\n\t\t\t\t\tschemaName: Tree.schema(tree).identifier,\n\t\t\t\t\tallowedTypes: concatenateTypes(allowedTypes ?? new Set()),\n\t\t\t\t\tisRequired: isRequired?.toString(),\n\t\t\t\t},\n\t\t\t\tvalue: await visualizeChildData(tree),\n\t\t\t\tkind: VisualSharedTreeNodeKind.LeafNode,\n\t\t\t}\n\t\t: visualizeNodeBySchema(\n\t\t\t\ttree,\n\t\t\t\ttreeDefinitions,\n\t\t\t\t{ allowedTypes, isRequired },\n\t\t\t\tvisualizeChildData,\n\t\t\t);\n}\n"]}
+{"version":3,"file":"SharedTreeVisualizer.js","sourceRoot":"","sources":["../../src/data-visualization/SharedTreeVisualizer.ts"],"names":[],"mappings":"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","sourcesContent":["/*!\n * Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n */\n\nimport { FieldKind } from \"@fluidframework/tree\";\nimport type {\n\tSimpleArrayNodeSchema,\n\tSimpleMapNodeSchema,\n\tSimpleNodeSchema,\n\tSimpleObjectNodeSchema,\n\tVerboseTree,\n\tVerboseTreeNode,\n} from \"@fluidframework/tree/internal\";\nimport { NodeKind, SchemaFactory, Tree } from \"@fluidframework/tree/internal\";\n\nimport type { VisualizeChildData } from \"./DataVisualization.js\";\nimport type { VisualSharedTreeNode, SharedTreeSchemaNode } from \"./VisualSharedTreeTypes.js\";\nimport { VisualSharedTreeNodeKind } from \"./VisualSharedTreeTypes.js\";\nimport {\n\ttype VisualChildNode,\n\tVisualNodeKind,\n\ttype VisualValueNode,\n\ttype VisualTreeNode,\n\ttype FluidHandleNode,\n\ttype UnknownObjectNode,\n} from \"./VisualTree.js\";\n\n/**\n * Returns VisualNodeKind that is compatible to {@link FluidObjectNode} based on the `visualTree`'s node kind.\n */\nexport function determineNodeKind(nodeKind: VisualNodeKind): VisualNodeKind {\n\tswitch (nodeKind) {\n\t\tcase VisualNodeKind.TreeNode:\n\t\tcase VisualNodeKind.FluidHandleNode: {\n\t\t\treturn VisualNodeKind.FluidTreeNode;\n\t\t}\n\t\tcase VisualNodeKind.ValueNode: {\n\t\t\treturn VisualNodeKind.FluidValueNode;\n\t\t}\n\t\tdefault: {\n\t\t\treturn VisualNodeKind.FluidUnknownObjectNode;\n\t\t}\n\t}\n}\n\n/**\n * Returns allowed types of the non-leaf nodes in the tree.\n * @param allowedTypes - a string if array node, `Record<string, string>` for non-array nodes.\n * @returns a VisualChildNode with the allowed type.\n */\nfunction createAllowedTypesVisualTree(\n\tallowedTypes: string | Record<string, string>,\n): VisualChildNode {\n\tif (typeof allowedTypes === \"string\") {\n\t\treturn {\n\t\t\tvalue: allowedTypes,\n\t\t\tnodeKind: VisualNodeKind.ValueNode,\n\t\t};\n\t}\n\n\tconst result: Record<string, VisualValueNode> = {};\n\tfor (const [allowedTypeKey, allowedType] of Object.entries(allowedTypes)) {\n\t\tresult[allowedTypeKey] = {\n\t\t\tnodeKind: VisualNodeKind.ValueNode,\n\t\t\tvalue: allowedType,\n\t\t};\n\t}\n\n\treturn {\n\t\tchildren: result,\n\t\tnodeKind: VisualNodeKind.TreeNode,\n\t};\n}\n\n/**\n * Creates a visual representation of the schema of the tree in {@link VisualTreeNode} format.\n */\nfunction createToolTipContents(schema: SharedTreeSchemaNode): VisualTreeNode {\n\tconst children: Record<string, VisualChildNode> = {\n\t\tname: {\n\t\t\tnodeKind: VisualNodeKind.ValueNode,\n\t\t\tvalue: schema.schemaName,\n\t\t},\n\t};\n\tif (schema.allowedTypes !== undefined) {\n\t\tchildren.allowedTypes = createAllowedTypesVisualTree(schema.allowedTypes);\n\t}\n\tif (schema.isRequired !== undefined) {\n\t\tchildren.isRequired = {\n\t\t\tnodeKind: VisualNodeKind.ValueNode,\n\t\t\tvalue: schema.isRequired,\n\t\t};\n\t}\n\treturn {\n\t\tnodeKind: VisualNodeKind.TreeNode,\n\t\tchildren,\n\t};\n}\n\n/**\n * Converts the visual representation from {@link visualizeNodeBySchema} to a visual tree compatible with the devtools-view.\n * @param tree - the visual representation of the SharedTree.\n * @returns the visual representation of type {@link VisualChildNode}\n */\nexport function toVisualTree(tree: VisualSharedTreeNode): VisualChildNode {\n\tif (tree.kind === VisualSharedTreeNodeKind.LeafNode) {\n\t\tswitch (tree.value.nodeKind) {\n\t\t\tcase VisualNodeKind.ValueNode: {\n\t\t\t\tconst result: VisualValueNode = {\n\t\t\t\t\tvalue: tree.value.value,\n\t\t\t\t\tnodeKind: VisualNodeKind.ValueNode,\n\t\t\t\t\ttooltipContents: {\n\t\t\t\t\t\tschema: createToolTipContents(tree.schema),\n\t\t\t\t\t},\n\t\t\t\t};\n\t\t\t\treturn result;\n\t\t\t}\n\t\t\tcase VisualNodeKind.FluidHandleNode: {\n\t\t\t\tconst result: FluidHandleNode = {\n\t\t\t\t\tfluidObjectId: tree.value.fluidObjectId,\n\t\t\t\t\tnodeKind: VisualNodeKind.FluidHandleNode,\n\t\t\t\t\ttooltipContents: {\n\t\t\t\t\t\tschema: createToolTipContents(tree.schema),\n\t\t\t\t\t},\n\t\t\t\t};\n\t\t\t\treturn result;\n\t\t\t}\n\t\t\tdefault: {\n\t\t\t\tconsole.error(`Unknown node kind: ${tree.value.nodeKind}`);\n\t\t\t\tconst result: UnknownObjectNode = {\n\t\t\t\t\tnodeKind: VisualNodeKind.UnknownObjectNode,\n\t\t\t\t\ttooltipContents: {\n\t\t\t\t\t\tschema: createToolTipContents(tree.schema),\n\t\t\t\t\t},\n\t\t\t\t};\n\t\t\t\treturn result;\n\t\t\t}\n\t\t}\n\t} else {\n\t\tconst children: Record<string, VisualChildNode> = {};\n\n\t\tfor (const [key, value] of Object.entries(tree.fields)) {\n\t\t\tconst child = toVisualTree(value);\n\t\t\tchildren[key] = child;\n\t\t}\n\n\t\treturn {\n\t\t\tchildren,\n\t\t\tnodeKind: VisualNodeKind.TreeNode,\n\t\t\ttooltipContents: {\n\t\t\t\tschema: createToolTipContents(tree.schema),\n\t\t\t},\n\t\t};\n\t}\n}\n\n/**\n * Concatenate allowed types for `ObjectNodeStoredSchema` and `MapNodeStoredSchema`.\n */\nexport function concatenateTypes(fieldTypes: ReadonlySet<string>): string {\n\treturn [...fieldTypes].join(\" | \");\n}\n\n/**\n * Properties that describe schema constraints for a field in the tree\n */\ninterface FieldSchemaProperties {\n\tallowedTypes: ReadonlySet<string> | undefined;\n\n\t/**\n\t * Whether the field is required (true) or optional (false).\n\t *\n\t * `undefined` indicates that the field is implicitly required.\n\t * In this case, no requirement information will be displayed by the devtools.\n\t */\n\tisRequired: boolean | undefined;\n}\n\n/**\n * Processes and visualizes the fields of a verbose tree node.\n *\n * @param treeFields - The fields of the tree node to visualize. Can be either an array of VerboseTree (for array nodes) or a Record of field names to VerboseTree (for object/map nodes).\n * @param treeDefinitions - Map containing all schema definitions for the entire tree structure. Each definition describes the shape and constraints of a particular node type.\n * @param fieldSchemaProperties - Record mapping field names to their schema properties, including allowed types and whether they are required.\n * @param visualizeChildData - Callback function to visualize child node data.\n *\n * @returns A record mapping field names/indices to their visual tree representations.\n */\nasync function visualizeVerboseNodeFields(\n\ttreeFields: readonly VerboseTree[] | Record<string, VerboseTree>,\n\ttreeDefinitions: ReadonlyMap<string, SimpleNodeSchema>,\n\tfieldSchemaProperties: Record<string, FieldSchemaProperties>,\n\tvisualizeChildData: VisualizeChildData,\n): Promise<Record<string, VisualSharedTreeNode>> {\n\tconst fields: Record<string | number, VisualSharedTreeNode> = {};\n\n\tfor (const [fieldKey, childField] of Object.entries(treeFields)) {\n\t\tfields[fieldKey] = await visualizeSharedTreeBySchema(\n\t\t\tchildField,\n\t\t\ttreeDefinitions,\n\t\t\t{\n\t\t\t\tallowedTypes: fieldSchemaProperties[fieldKey]?.allowedTypes,\n\t\t\t\tisRequired: fieldSchemaProperties[fieldKey]?.isRequired,\n\t\t\t},\n\t\t\tvisualizeChildData,\n\t\t);\n\t}\n\n\treturn fields;\n}\n\n/**\n * Returns the schema & fields of the node with type {@link ObjectNodeStoredSchema}.\n */\nasync function visualizeObjectNode(\n\ttree: VerboseTreeNode,\n\tschema: SimpleObjectNodeSchema,\n\ttreeDefinitions: ReadonlyMap<string, SimpleNodeSchema>,\n\t{ allowedTypes, isRequired }: FieldSchemaProperties,\n\tvisualizeChildData: VisualizeChildData,\n): Promise<VisualSharedTreeNode> {\n\tconst objectNodeSchemaProperties: Record<string, FieldSchemaProperties> = {};\n\tfor (const [fieldKey, treeFieldSimpleSchema] of schema.fields) {\n\t\tobjectNodeSchemaProperties[fieldKey] = {\n\t\t\tallowedTypes: treeFieldSimpleSchema.allowedTypesIdentifiers,\n\t\t\tisRequired: treeFieldSimpleSchema.kind === FieldKind.Required ? true : false,\n\t\t};\n\t}\n\n\treturn {\n\t\tschema: {\n\t\t\tschemaName: tree.type,\n\t\t\tallowedTypes: concatenateTypes(allowedTypes ?? new Set()),\n\t\t\tisRequired: isRequired?.toString(),\n\t\t},\n\t\tfields: await visualizeVerboseNodeFields(\n\t\t\ttree.fields,\n\t\t\ttreeDefinitions,\n\t\t\tobjectNodeSchemaProperties,\n\t\t\tvisualizeChildData,\n\t\t),\n\t\tkind: VisualSharedTreeNodeKind.InternalNode,\n\t};\n}\n\n/**\n * Returns the schema & fields of the node with type {@link MapNodeStoredSchema}.\n */\nasync function visualizeMapNode(\n\ttree: VerboseTreeNode,\n\tschema: SimpleMapNodeSchema,\n\ttreeDefinitions: ReadonlyMap<string, SimpleNodeSchema>,\n\t{ allowedTypes, isRequired }: FieldSchemaProperties,\n\tvisualizeChildData: VisualizeChildData,\n): Promise<VisualSharedTreeNode> {\n\tconst mapNodeSchemaProperties: Record<string, FieldSchemaProperties> = {};\n\tfor (const key of Object.keys(tree.fields)) {\n\t\tmapNodeSchemaProperties[key] = {\n\t\t\tallowedTypes: schema.allowedTypesIdentifiers,\n\t\t\t// Map values are always required. Don't display field requirement information, since that information is redundant.\n\t\t\tisRequired: undefined,\n\t\t};\n\t}\n\n\treturn {\n\t\tschema: {\n\t\t\tschemaName: tree.type,\n\t\t\tallowedTypes: concatenateTypes(allowedTypes ?? new Set()),\n\t\t\tisRequired: isRequired?.toString(),\n\t\t},\n\t\tfields: await visualizeVerboseNodeFields(\n\t\t\ttree.fields,\n\t\t\ttreeDefinitions,\n\t\t\tmapNodeSchemaProperties,\n\t\t\tvisualizeChildData,\n\t\t),\n\t\tkind: VisualSharedTreeNodeKind.InternalNode,\n\t};\n}\n\n/**\n * Returns the schema & fields of the node with type {@link ArrayNodeStoredSchema}.\n */\nasync function visualizeArrayNode(\n\ttree: VerboseTreeNode,\n\tschema: SimpleArrayNodeSchema,\n\ttreeDefinitions: ReadonlyMap<string, SimpleNodeSchema>,\n\t{ allowedTypes, isRequired }: FieldSchemaProperties,\n\tvisualizeChildData: VisualizeChildData,\n): Promise<VisualSharedTreeNode> {\n\tconst children = tree.fields;\n\tif (!Array.isArray(children)) {\n\t\tthrow new TypeError(\"Invalid array\");\n\t}\n\n\tconst arrayNodeSchemaProperties: Record<string, FieldSchemaProperties> = {};\n\tfor (const [i] of children.entries()) {\n\t\tarrayNodeSchemaProperties[i] = {\n\t\t\tallowedTypes: schema.allowedTypesIdentifiers,\n\t\t\t// Array values are always required. Don't display field requirement information, since that information is redundant.\n\t\t\tisRequired: undefined,\n\t\t};\n\t}\n\n\treturn {\n\t\tschema: {\n\t\t\tschemaName: tree.type,\n\t\t\tallowedTypes: concatenateTypes(allowedTypes ?? new Set()),\n\t\t\tisRequired: isRequired?.toString(),\n\t\t},\n\t\tfields: await visualizeVerboseNodeFields(\n\t\t\ttree.fields,\n\t\t\ttreeDefinitions,\n\t\t\tarrayNodeSchemaProperties,\n\t\t\tvisualizeChildData,\n\t\t),\n\t\tkind: VisualSharedTreeNodeKind.InternalNode,\n\t};\n}\n\n/**\n * Creates the visual representation of non-leaf SharedTree nodes.\n *\n * @remarks\n * Processes internal tree nodes based on their schema type (e.g., ObjectNodeStoredSchema, MapNodeStoredSchema, ArrayNodeStoredSchema),\n * producing the visual representation for each type.\n *\n * @see {@link https://fluidframework.com/docs/data-structures/tree/} for more information on the SharedTree schema.\n *\n * @remarks\n */\nasync function visualizeNodeBySchema(\n\ttree: VerboseTreeNode,\n\ttreeDefinitions: ReadonlyMap<string, SimpleNodeSchema>,\n\t{ allowedTypes, isRequired }: FieldSchemaProperties,\n\tvisualizeChildData: VisualizeChildData,\n): Promise<VisualSharedTreeNode> {\n\tconst schema = treeDefinitions.get(tree.type);\n\n\tif (schema === undefined) {\n\t\tthrow new TypeError(\"Unrecognized schema type.\");\n\t}\n\n\tswitch (schema.kind) {\n\t\tcase NodeKind.Object: {\n\t\t\tconst objectVisualized = visualizeObjectNode(\n\t\t\t\ttree,\n\t\t\t\tschema,\n\t\t\t\ttreeDefinitions,\n\t\t\t\t{ allowedTypes, isRequired },\n\t\t\t\tvisualizeChildData,\n\t\t\t);\n\t\t\treturn objectVisualized;\n\t\t}\n\t\tcase NodeKind.Map: {\n\t\t\tconst mapVisualized = visualizeMapNode(\n\t\t\t\ttree,\n\t\t\t\tschema,\n\t\t\t\ttreeDefinitions,\n\t\t\t\t{ allowedTypes, isRequired },\n\t\t\t\tvisualizeChildData,\n\t\t\t);\n\t\t\treturn mapVisualized;\n\t\t}\n\t\tcase NodeKind.Array: {\n\t\t\treturn visualizeArrayNode(\n\t\t\t\ttree,\n\t\t\t\tschema,\n\t\t\t\ttreeDefinitions,\n\t\t\t\t{ allowedTypes, isRequired },\n\t\t\t\tvisualizeChildData,\n\t\t\t);\n\t\t}\n\t\tdefault: {\n\t\t\tthrow new TypeError(\"Unrecognized schema type.\");\n\t\t}\n\t}\n}\n\n/**\n * Creates a visual representation of a SharedTree based on its schema.\n * @param tree - The {@link VerboseTree} to visualize\n * @param treeDefinitions - Map containing all schema definitions for the entire tree structure. Each definition\n * describes the shape and constraints of a particular node type.\n * @param fieldSchemaProperties - Properties describing schema constraints for this field:\n * - `allowedTypes`: Set of type names that are valid for this specific node position in the tree.\n * This is a subset of the types defined in treeDefinitions.\n * - `isRequired`: Whether this field is required in its parent object schema.\n * Only meaningful for direct children of object nodes.\n * Undefined for array/map elements since they are always required within their parent.\n * @param visualizeChildData - Callback function to visualize child node data\n * @returns A visual representation of the tree that includes schema information and node values\n *\n * @remarks\n * This function handles both leaf nodes (primitive values, handles) and internal nodes (objects, maps, arrays).\n * For leaf nodes, it creates a visual representation with the node's schema and value.\n * For internal nodes, it recursively processes the node's fields using {@link visualizeNodeBySchema}.\n */\nexport async function visualizeSharedTreeBySchema(\n\ttree: VerboseTree,\n\ttreeDefinitions: ReadonlyMap<string, SimpleNodeSchema>,\n\t{ allowedTypes, isRequired }: FieldSchemaProperties,\n\tvisualizeChildData: VisualizeChildData,\n): Promise<VisualSharedTreeNode> {\n\treturn Tree.is(tree, SchemaFactory.leaves)\n\t\t? {\n\t\t\t\tschema: {\n\t\t\t\t\tschemaName: Tree.schema(tree).identifier,\n\t\t\t\t\tallowedTypes: concatenateTypes(allowedTypes ?? new Set()),\n\t\t\t\t\tisRequired: isRequired?.toString(),\n\t\t\t\t},\n\t\t\t\tvalue: await visualizeChildData(tree),\n\t\t\t\tkind: VisualSharedTreeNodeKind.LeafNode,\n\t\t\t}\n\t\t: visualizeNodeBySchema(\n\t\t\t\ttree,\n\t\t\t\ttreeDefinitions,\n\t\t\t\t{ allowedTypes, isRequired },\n\t\t\t\tvisualizeChildData,\n\t\t\t);\n}\n"]}

package/dist/packageVersion.d.ts

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

package/dist/packageVersion.js

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

package/dist/packageVersion.js.map

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

package/lib/DevtoolsLogger.js.map

@@ -1 +1 @@
-{"version":3,"file":"DevtoolsLogger.js","sourceRoot":"","sources":["../src/DevtoolsLogger.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH,OAAO,EACN,mBAAmB,EAInB,cAAc,EACd,gBAAgB,EAChB,2BAA2B,EAC3B,oBAAoB,GACpB,MAAM,sBAAsB,CAAC;AAkB9B;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,cAAc;IAuDnB,aAAa;IAEb,YAAmB,UAAiC;QA7CpD;;WAEG;QACc,0BAAqB,GAA0B;YAC/D,OAAO,EAAE,qBAAqB;SAC9B,CAAC;QAEF;;WAEG;QACc,2BAAsB,GAAoB;YAC1D,CAAC,mBAAmB,CAAC,WAAW,CAAC,EAAE,KAAK,EAAE,cAAc,EAAE,EAAE;gBAC3D,IAAI,CAAC,cAAc,EAAE,CAAC;gBACtB,OAAO,IAAI,CAAC;YACb,CAAC;SACD,CAAC;QAEF;;WAEG;QACc,yBAAoB,GAAG,CACvC,KAA8C,EACvC,EAAE;YACT,2BAA2B,CAC1B,KAAK,EACL,IAAI,CAAC,sBAAsB,EAC3B,IAAI,CAAC,qBAAqB,CAC1B,CAAC;QACH,CAAC,CAAC;QAEF;;;WAGG;QACc,mBAAc,GAAG,GAAS,EAAE;YAC5C,oBAAoB,CACnB,IAAI,CAAC,qBAAqB,EAC1B,gBAAgB,CAAC,aAAa,CAAC;gBAC9B,QAAQ,EAAE,IAAI,CAAC,aAAa;aAC5B,CAAC,CACF,CAAC;QACH,CAAC,CAAC;QAKD,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAE7B,IAAI,CAAC,aAAa,GAAG,EAAE,CAAC;QAExB,sEAAsE;QACtE,UAAU,CAAC,gBAAgB,EAAE,CAAC,SAAS,EAAE,IAAI,CAAC,oBAAoB,CAAC,CAAC;IACrE,CAAC;IAED;;;;OAIG;IACI,IAAI,CAAC,KAA0B;QACrC,+BAA+B;QAC/B,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QAE7B,IAAI,CAAC;YACJ,MAAM,QAAQ,GAA+B;gBAC5C,UAAU,EAAE,KAAK;gBACjB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;aACrB,CAAC;YAEF,0EAA0E;YAC1E,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;YAErC,0GAA0G;YAC1G,oBAAoB,CACnB,SAAS,EACT,cAAc,CAAC,aAAa,CAAC;gBAC5B,KAAK,EAAE,QAAQ;aACf,CAAC,CACF,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,uFAAuF;YACvF,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACtB,CAAC;IACF,CAAC;CACD;AAED;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,UAAiC;IACrE,OAAO,IAAI,cAAc,CAAC,UAAU,CAAC,CAAC;AACvC,CAAC","sourcesContent":["/*!\n * Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n */\n\nimport type {\n\tITelemetryBaseEvent,\n\tITelemetryBaseLogger,\n} from \"@fluidframework/core-interfaces\";\n\nimport type { ITimestampedTelemetryEvent } from \"./TelemetryMetadata.js\";\nimport {\n\tGetTelemetryHistory,\n\ttype IDevtoolsMessage,\n\ttype InboundHandlers,\n\ttype MessageLoggingOptions,\n\tTelemetryEvent,\n\tTelemetryHistory,\n\thandleIncomingWindowMessage,\n\tpostMessagesToWindow,\n} from \"./messaging/index.js\";\n\n/**\n * Logger implementation that posts all telemetry events to the window (globalThis object).\n * This logger is intended to integrate with the Fluid DevTools browser extension.\n *\n * @remarks Note: external implementations of this interface are not supported.\n * An `IDevtoolsLogger` can be created via {@link createDevtoolsLogger} - this logger may then be provided to the Fluid\n * runtime to ensure telemetry messages are flowing to it.\n * If you wish to enable telemetry functionality in the devtools, you **must** pass this same logger back when\n * initializing the Devtools.\n *\n * @sealed\n * @beta\n */\n// eslint-disable-next-line @typescript-eslint/no-empty-interface\nexport interface IDevtoolsLogger extends ITelemetryBaseLogger {}\n\n/**\n * Logger implementation that posts all telemetry events to the window (globalThis object).\n * This logger is intended to integrate with the Fluid DevTools browser extension.\n *\n * @remarks\n *\n * This logger optionally wraps a provided base logger, and forwards all events to that logger (in addition to posting\n * data to the window).\n *\n * **Messages it listens for:**\n *\n * - {@link GetTelemetryHistory.Message}: When received, the logger will broadcast {@link TelemetryHistory.Message}.\n *\n * TODO: Document others as they are added.\n *\n * **Messages it posts:**\n *\n * - {@link TelemetryHistory.Message}: This is posted when requested (via {@link GetTelemetryHistory.Message}).\n * - {@link TelemetryEvent.Message}: This is posted any time a telemetry event is logged.\n *\n * TODO: Document others as they are added.\n *\n * @sealed\n */\nclass DevtoolsLogger implements IDevtoolsLogger {\n\t/**\n\t * Base telemetry logger provided by the consumer.\n\t * All messages sent to the Devtools logger will be forwarded to this.\n\t */\n\tprivate readonly baseLogger: ITelemetryBaseLogger | undefined;\n\n\t/**\n\t * Accumulated data for Telemetry logs.\n\t */\n\tprivate readonly _telemetryLog: ITimestampedTelemetryEvent[];\n\n\t/**\n\t * Message logging options used by the logger.\n\t */\n\tprivate readonly messageLoggingOptions: MessageLoggingOptions = {\n\t\tcontext: `FluidDevtoolsLogger`,\n\t};\n\n\t/**\n\t * Handlers for inbound messages related to the logger.\n\t */\n\tprivate readonly inboundMessageHandlers: InboundHandlers = {\n\t\t[GetTelemetryHistory.MessageType]: async (untypedMessage) => {\n\t\t\tthis.postLogHistory();\n\t\t\treturn true;\n\t\t},\n\t};\n\n\t/**\n\t * Event handler for messages coming from the window (globalThis).\n\t */\n\tprivate readonly windowMessageHandler = (\n\t\tevent: MessageEvent<Partial<IDevtoolsMessage>>,\n\t): void => {\n\t\thandleIncomingWindowMessage(\n\t\t\tevent,\n\t\t\tthis.inboundMessageHandlers,\n\t\t\tthis.messageLoggingOptions,\n\t\t);\n\t};\n\n\t/**\n\t * Posts a {@link TelemetryHistory.Message} to the window (globalThis) containing the complete history of\n\t * telemetry events.\n\t */\n\tprivate readonly postLogHistory = (): void => {\n\t\tpostMessagesToWindow(\n\t\t\tthis.messageLoggingOptions,\n\t\t\tTelemetryHistory.createMessage({\n\t\t\t\tcontents: this._telemetryLog,\n\t\t\t}),\n\t\t);\n\t};\n\n\t// #endregion\n\n\tpublic constructor(baseLogger?: ITelemetryBaseLogger) {\n\t\tthis.baseLogger = baseLogger;\n\n\t\tthis._telemetryLog = [];\n\n\t\t// Register listener for inbound messages from the window (globalThis)\n\t\tglobalThis.addEventListener?.(\"message\", this.windowMessageHandler);\n\t}\n\n\t/**\n\t * Post a {@link TelemetryEvent.Message} to the window (globalThis) for the provided telemetry event.\n\t *\n\t * @param event - The telemetry event to send.\n\t */\n\tpublic send(event: ITelemetryBaseEvent): void {\n\t\t// Forward event to base logger\n\t\tthis.baseLogger?.send(event);\n\n\t\ttry {\n\t\t\tconst newEvent: ITimestampedTelemetryEvent = {\n\t\t\t\tlogContent: event,\n\t\t\t\ttimestamp: Date.now(),\n\t\t\t};\n\n\t\t\t// insert log into the beginning of the array to show the latest log first\n\t\t\tthis._telemetryLog.unshift(newEvent);\n\n\t\t\t// set log option to be undefined to avoid sending the log message to window console; these were too noisy\n\t\t\tpostMessagesToWindow(\n\t\t\t\tundefined,\n\t\t\t\tTelemetryEvent.createMessage({\n\t\t\t\t\tevent: newEvent,\n\t\t\t\t}),\n\t\t\t);\n\t\t} catch (error) {\n\t\t\t// Eat the error to ensure that Devtools logic doesn't crash the consuming application.\n\t\t\tconsole.error(error);\n\t\t}\n\t}\n}\n\n/**\n * Creates a new {@link IDevtoolsLogger} by wrapping the provided (optional) base logger.\n *\n * @beta\n */\nexport function createDevtoolsLogger(baseLogger?: ITelemetryBaseLogger): IDevtoolsLogger {\n\treturn new DevtoolsLogger(baseLogger);\n}\n"]}
+{"version":3,"file":"DevtoolsLogger.js","sourceRoot":"","sources":["../src/DevtoolsLogger.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH,OAAO,EACN,mBAAmB,EAInB,cAAc,EACd,gBAAgB,EAChB,2BAA2B,EAC3B,oBAAoB,GACpB,MAAM,sBAAsB,CAAC;AAkB9B;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,cAAc;IAuDnB,aAAa;IAEb,YAAmB,UAAiC;QA7CpD;;WAEG;QACc,0BAAqB,GAA0B;YAC/D,OAAO,EAAE,qBAAqB;SAC9B,CAAC;QAEF;;WAEG;QACc,2BAAsB,GAAoB;YAC1D,CAAC,mBAAmB,CAAC,WAAW,CAAC,EAAE,KAAK,EAAE,cAAc,EAAE,EAAE;gBAC3D,IAAI,CAAC,cAAc,EAAE,CAAC;gBACtB,OAAO,IAAI,CAAC;YACb,CAAC;SACD,CAAC;QAEF;;WAEG;QACc,yBAAoB,GAAG,CACvC,KAA8C,EACvC,EAAE;YACT,2BAA2B,CAC1B,KAAK,EACL,IAAI,CAAC,sBAAsB,EAC3B,IAAI,CAAC,qBAAqB,CAC1B,CAAC;QACH,CAAC,CAAC;QAEF;;;WAGG;QACc,mBAAc,GAAG,GAAS,EAAE;YAC5C,oBAAoB,CACnB,IAAI,CAAC,qBAAqB,EAC1B,gBAAgB,CAAC,aAAa,CAAC;gBAC9B,QAAQ,EAAE,IAAI,CAAC,aAAa;aAC5B,CAAC,CACF,CAAC;QACH,CAAC,CAAC;QAKD,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAE7B,IAAI,CAAC,aAAa,GAAG,EAAE,CAAC;QAExB,sEAAsE;QACtE,UAAU,CAAC,gBAAgB,EAAE,CAAC,SAAS,EAAE,IAAI,CAAC,oBAAoB,CAAC,CAAC;IACrE,CAAC;IAED;;;;OAIG;IACI,IAAI,CAAC,KAA0B;QACrC,+BAA+B;QAC/B,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QAE7B,IAAI,CAAC;YACJ,MAAM,QAAQ,GAA+B;gBAC5C,UAAU,EAAE,KAAK;gBACjB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;aACrB,CAAC;YAEF,0EAA0E;YAC1E,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;YAErC,0GAA0G;YAC1G,oBAAoB,CACnB,SAAS,EACT,cAAc,CAAC,aAAa,CAAC;gBAC5B,KAAK,EAAE,QAAQ;aACf,CAAC,CACF,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,uFAAuF;YACvF,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACtB,CAAC;IACF,CAAC;CACD;AAED;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,UAAiC;IACrE,OAAO,IAAI,cAAc,CAAC,UAAU,CAAC,CAAC;AACvC,CAAC","sourcesContent":["/*!\n * Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n */\n\nimport type {\n\tITelemetryBaseEvent,\n\tITelemetryBaseLogger,\n} from \"@fluidframework/core-interfaces\";\n\nimport type { ITimestampedTelemetryEvent } from \"./TelemetryMetadata.js\";\nimport {\n\tGetTelemetryHistory,\n\ttype IDevtoolsMessage,\n\ttype InboundHandlers,\n\ttype MessageLoggingOptions,\n\tTelemetryEvent,\n\tTelemetryHistory,\n\thandleIncomingWindowMessage,\n\tpostMessagesToWindow,\n} from \"./messaging/index.js\";\n\n/**\n * Logger implementation that posts all telemetry events to the window (globalThis object).\n * This logger is intended to integrate with the Fluid DevTools browser extension.\n *\n * @remarks Note: external implementations of this interface are not supported.\n * An `IDevtoolsLogger` can be created via {@link createDevtoolsLogger} - this logger may then be provided to the Fluid\n * runtime to ensure telemetry messages are flowing to it.\n * If you wish to enable telemetry functionality in the devtools, you **must** pass this same logger back when\n * initializing the Devtools.\n *\n * @sealed\n * @beta\n */\n// eslint-disable-next-line @typescript-eslint/no-empty-object-type, @typescript-eslint/no-empty-interface\nexport interface IDevtoolsLogger extends ITelemetryBaseLogger {}\n\n/**\n * Logger implementation that posts all telemetry events to the window (globalThis object).\n * This logger is intended to integrate with the Fluid DevTools browser extension.\n *\n * @remarks\n *\n * This logger optionally wraps a provided base logger, and forwards all events to that logger (in addition to posting\n * data to the window).\n *\n * **Messages it listens for:**\n *\n * - {@link GetTelemetryHistory.Message}: When received, the logger will broadcast {@link TelemetryHistory.Message}.\n *\n * TODO: Document others as they are added.\n *\n * **Messages it posts:**\n *\n * - {@link TelemetryHistory.Message}: This is posted when requested (via {@link GetTelemetryHistory.Message}).\n * - {@link TelemetryEvent.Message}: This is posted any time a telemetry event is logged.\n *\n * TODO: Document others as they are added.\n *\n * @sealed\n */\nclass DevtoolsLogger implements IDevtoolsLogger {\n\t/**\n\t * Base telemetry logger provided by the consumer.\n\t * All messages sent to the Devtools logger will be forwarded to this.\n\t */\n\tprivate readonly baseLogger: ITelemetryBaseLogger | undefined;\n\n\t/**\n\t * Accumulated data for Telemetry logs.\n\t */\n\tprivate readonly _telemetryLog: ITimestampedTelemetryEvent[];\n\n\t/**\n\t * Message logging options used by the logger.\n\t */\n\tprivate readonly messageLoggingOptions: MessageLoggingOptions = {\n\t\tcontext: `FluidDevtoolsLogger`,\n\t};\n\n\t/**\n\t * Handlers for inbound messages related to the logger.\n\t */\n\tprivate readonly inboundMessageHandlers: InboundHandlers = {\n\t\t[GetTelemetryHistory.MessageType]: async (untypedMessage) => {\n\t\t\tthis.postLogHistory();\n\t\t\treturn true;\n\t\t},\n\t};\n\n\t/**\n\t * Event handler for messages coming from the window (globalThis).\n\t */\n\tprivate readonly windowMessageHandler = (\n\t\tevent: MessageEvent<Partial<IDevtoolsMessage>>,\n\t): void => {\n\t\thandleIncomingWindowMessage(\n\t\t\tevent,\n\t\t\tthis.inboundMessageHandlers,\n\t\t\tthis.messageLoggingOptions,\n\t\t);\n\t};\n\n\t/**\n\t * Posts a {@link TelemetryHistory.Message} to the window (globalThis) containing the complete history of\n\t * telemetry events.\n\t */\n\tprivate readonly postLogHistory = (): void => {\n\t\tpostMessagesToWindow(\n\t\t\tthis.messageLoggingOptions,\n\t\t\tTelemetryHistory.createMessage({\n\t\t\t\tcontents: this._telemetryLog,\n\t\t\t}),\n\t\t);\n\t};\n\n\t// #endregion\n\n\tpublic constructor(baseLogger?: ITelemetryBaseLogger) {\n\t\tthis.baseLogger = baseLogger;\n\n\t\tthis._telemetryLog = [];\n\n\t\t// Register listener for inbound messages from the window (globalThis)\n\t\tglobalThis.addEventListener?.(\"message\", this.windowMessageHandler);\n\t}\n\n\t/**\n\t * Post a {@link TelemetryEvent.Message} to the window (globalThis) for the provided telemetry event.\n\t *\n\t * @param event - The telemetry event to send.\n\t */\n\tpublic send(event: ITelemetryBaseEvent): void {\n\t\t// Forward event to base logger\n\t\tthis.baseLogger?.send(event);\n\n\t\ttry {\n\t\t\tconst newEvent: ITimestampedTelemetryEvent = {\n\t\t\t\tlogContent: event,\n\t\t\t\ttimestamp: Date.now(),\n\t\t\t};\n\n\t\t\t// insert log into the beginning of the array to show the latest log first\n\t\t\tthis._telemetryLog.unshift(newEvent);\n\n\t\t\t// set log option to be undefined to avoid sending the log message to window console; these were too noisy\n\t\t\tpostMessagesToWindow(\n\t\t\t\tundefined,\n\t\t\t\tTelemetryEvent.createMessage({\n\t\t\t\t\tevent: newEvent,\n\t\t\t\t}),\n\t\t\t);\n\t\t} catch (error) {\n\t\t\t// Eat the error to ensure that Devtools logic doesn't crash the consuming application.\n\t\t\tconsole.error(error);\n\t\t}\n\t}\n}\n\n/**\n * Creates a new {@link IDevtoolsLogger} by wrapping the provided (optional) base logger.\n *\n * @beta\n */\nexport function createDevtoolsLogger(baseLogger?: ITelemetryBaseLogger): IDevtoolsLogger {\n\treturn new DevtoolsLogger(baseLogger);\n}\n"]}

package/lib/data-visualization/SharedTreeVisualizer.d.ts

@@ -13,7 +13,7 @@ export declare function determineNodeKind(nodeKind: VisualNodeKind): VisualNodeK
 /**
  * Converts the visual representation from {@link visualizeNodeBySchema} to a visual tree compatible with the devtools-view.
  * @param tree - the visual representation of the SharedTree.
- * @returns - the visual representation of type {@link VisualChildNode}
+ * @returns the visual representation of type {@link VisualChildNode}
  */
 export declare function toVisualTree(tree: VisualSharedTreeNode): VisualChildNode;
 /**

package/lib/data-visualization/SharedTreeVisualizer.js

@@ -26,7 +26,7 @@ export function determineNodeKind(nodeKind) {
 /**
  * Returns allowed types of the non-leaf nodes in the tree.
  * @param allowedTypes - a string if array node, `Record<string, string>` for non-array nodes.
- * @returns - a VisualChildNode with the allowed type.
+ * @returns a VisualChildNode with the allowed type.
  */
 function createAllowedTypesVisualTree(allowedTypes) {
     if (typeof allowedTypes === "string") {
@@ -74,7 +74,7 @@ function createToolTipContents(schema) {
 /**
  * Converts the visual representation from {@link visualizeNodeBySchema} to a visual tree compatible with the devtools-view.
  * @param tree - the visual representation of the SharedTree.
- * @returns - the visual representation of type {@link VisualChildNode}
+ * @returns the visual representation of type {@link VisualChildNode}
  */
 export function toVisualTree(tree) {
     if (tree.kind === VisualSharedTreeNodeKind.LeafNode) {

package/lib/data-visualization/SharedTreeVisualizer.js.map

@@ -1 +1 @@
-{"version":3,"file":"SharedTreeVisualizer.js","sourceRoot":"","sources":["../../src/data-visualization/SharedTreeVisualizer.ts"],"names":[],"mappings":"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","sourcesContent":["/*!\n * Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n */\n\nimport { FieldKind } from \"@fluidframework/tree\";\nimport type {\n\tSimpleArrayNodeSchema,\n\tSimpleMapNodeSchema,\n\tSimpleNodeSchema,\n\tSimpleObjectNodeSchema,\n\tVerboseTree,\n\tVerboseTreeNode,\n} from \"@fluidframework/tree/internal\";\nimport { NodeKind, SchemaFactory, Tree } from \"@fluidframework/tree/internal\";\n\nimport type { VisualizeChildData } from \"./DataVisualization.js\";\nimport type { VisualSharedTreeNode, SharedTreeSchemaNode } from \"./VisualSharedTreeTypes.js\";\nimport { VisualSharedTreeNodeKind } from \"./VisualSharedTreeTypes.js\";\nimport {\n\ttype VisualChildNode,\n\tVisualNodeKind,\n\ttype VisualValueNode,\n\ttype VisualTreeNode,\n\ttype FluidHandleNode,\n\ttype UnknownObjectNode,\n} from \"./VisualTree.js\";\n\n/**\n * Returns VisualNodeKind that is compatible to {@link FluidObjectNode} based on the `visualTree`'s node kind.\n */\nexport function determineNodeKind(nodeKind: VisualNodeKind): VisualNodeKind {\n\tswitch (nodeKind) {\n\t\tcase VisualNodeKind.TreeNode:\n\t\tcase VisualNodeKind.FluidHandleNode: {\n\t\t\treturn VisualNodeKind.FluidTreeNode;\n\t\t}\n\t\tcase VisualNodeKind.ValueNode: {\n\t\t\treturn VisualNodeKind.FluidValueNode;\n\t\t}\n\t\tdefault: {\n\t\t\treturn VisualNodeKind.FluidUnknownObjectNode;\n\t\t}\n\t}\n}\n\n/**\n * Returns allowed types of the non-leaf nodes in the tree.\n * @param allowedTypes - a string if array node, `Record<string, string>` for non-array nodes.\n * @returns - a VisualChildNode with the allowed type.\n */\nfunction createAllowedTypesVisualTree(\n\tallowedTypes: string | Record<string, string>,\n): VisualChildNode {\n\tif (typeof allowedTypes === \"string\") {\n\t\treturn {\n\t\t\tvalue: allowedTypes,\n\t\t\tnodeKind: VisualNodeKind.ValueNode,\n\t\t};\n\t}\n\n\tconst result: Record<string, VisualValueNode> = {};\n\tfor (const [allowedTypeKey, allowedType] of Object.entries(allowedTypes)) {\n\t\tresult[allowedTypeKey] = {\n\t\t\tnodeKind: VisualNodeKind.ValueNode,\n\t\t\tvalue: allowedType,\n\t\t};\n\t}\n\n\treturn {\n\t\tchildren: result,\n\t\tnodeKind: VisualNodeKind.TreeNode,\n\t};\n}\n\n/**\n * Creates a visual representation of the schema of the tree in {@link VisualTreeNode} format.\n */\nfunction createToolTipContents(schema: SharedTreeSchemaNode): VisualTreeNode {\n\tconst children: Record<string, VisualChildNode> = {\n\t\tname: {\n\t\t\tnodeKind: VisualNodeKind.ValueNode,\n\t\t\tvalue: schema.schemaName,\n\t\t},\n\t};\n\tif (schema.allowedTypes !== undefined) {\n\t\tchildren.allowedTypes = createAllowedTypesVisualTree(schema.allowedTypes);\n\t}\n\tif (schema.isRequired !== undefined) {\n\t\tchildren.isRequired = {\n\t\t\tnodeKind: VisualNodeKind.ValueNode,\n\t\t\tvalue: schema.isRequired,\n\t\t};\n\t}\n\treturn {\n\t\tnodeKind: VisualNodeKind.TreeNode,\n\t\tchildren,\n\t};\n}\n\n/**\n * Converts the visual representation from {@link visualizeNodeBySchema} to a visual tree compatible with the devtools-view.\n * @param tree - the visual representation of the SharedTree.\n * @returns - the visual representation of type {@link VisualChildNode}\n */\nexport function toVisualTree(tree: VisualSharedTreeNode): VisualChildNode {\n\tif (tree.kind === VisualSharedTreeNodeKind.LeafNode) {\n\t\tswitch (tree.value.nodeKind) {\n\t\t\tcase VisualNodeKind.ValueNode: {\n\t\t\t\tconst result: VisualValueNode = {\n\t\t\t\t\tvalue: tree.value.value,\n\t\t\t\t\tnodeKind: VisualNodeKind.ValueNode,\n\t\t\t\t\ttooltipContents: {\n\t\t\t\t\t\tschema: createToolTipContents(tree.schema),\n\t\t\t\t\t},\n\t\t\t\t};\n\t\t\t\treturn result;\n\t\t\t}\n\t\t\tcase VisualNodeKind.FluidHandleNode: {\n\t\t\t\tconst result: FluidHandleNode = {\n\t\t\t\t\tfluidObjectId: tree.value.fluidObjectId,\n\t\t\t\t\tnodeKind: VisualNodeKind.FluidHandleNode,\n\t\t\t\t\ttooltipContents: {\n\t\t\t\t\t\tschema: createToolTipContents(tree.schema),\n\t\t\t\t\t},\n\t\t\t\t};\n\t\t\t\treturn result;\n\t\t\t}\n\t\t\tdefault: {\n\t\t\t\tconsole.error(`Unknown node kind: ${tree.value.nodeKind}`);\n\t\t\t\tconst result: UnknownObjectNode = {\n\t\t\t\t\tnodeKind: VisualNodeKind.UnknownObjectNode,\n\t\t\t\t\ttooltipContents: {\n\t\t\t\t\t\tschema: createToolTipContents(tree.schema),\n\t\t\t\t\t},\n\t\t\t\t};\n\t\t\t\treturn result;\n\t\t\t}\n\t\t}\n\t} else {\n\t\tconst children: Record<string, VisualChildNode> = {};\n\n\t\tfor (const [key, value] of Object.entries(tree.fields)) {\n\t\t\tconst child = toVisualTree(value);\n\t\t\tchildren[key] = child;\n\t\t}\n\n\t\treturn {\n\t\t\tchildren,\n\t\t\tnodeKind: VisualNodeKind.TreeNode,\n\t\t\ttooltipContents: {\n\t\t\t\tschema: createToolTipContents(tree.schema),\n\t\t\t},\n\t\t};\n\t}\n}\n\n/**\n * Concatenate allowed types for `ObjectNodeStoredSchema` and `MapNodeStoredSchema`.\n */\nexport function concatenateTypes(fieldTypes: ReadonlySet<string>): string {\n\treturn [...fieldTypes].join(\" | \");\n}\n\n/**\n * Properties that describe schema constraints for a field in the tree\n */\ninterface FieldSchemaProperties {\n\tallowedTypes: ReadonlySet<string> | undefined;\n\n\t/**\n\t * Whether the field is required (true) or optional (false).\n\t *\n\t * `undefined` indicates that the field is implicitly required.\n\t * In this case, no requirement information will be displayed by the devtools.\n\t */\n\tisRequired: boolean | undefined;\n}\n\n/**\n * Processes and visualizes the fields of a verbose tree node.\n *\n * @param treeFields - The fields of the tree node to visualize. Can be either an array of VerboseTree (for array nodes) or a Record of field names to VerboseTree (for object/map nodes).\n * @param treeDefinitions - Map containing all schema definitions for the entire tree structure. Each definition describes the shape and constraints of a particular node type.\n * @param fieldSchemaProperties - Record mapping field names to their schema properties, including allowed types and whether they are required.\n * @param visualizeChildData - Callback function to visualize child node data.\n *\n * @returns A record mapping field names/indices to their visual tree representations.\n */\nasync function visualizeVerboseNodeFields(\n\ttreeFields: readonly VerboseTree[] | Record<string, VerboseTree>,\n\ttreeDefinitions: ReadonlyMap<string, SimpleNodeSchema>,\n\tfieldSchemaProperties: Record<string, FieldSchemaProperties>,\n\tvisualizeChildData: VisualizeChildData,\n): Promise<Record<string, VisualSharedTreeNode>> {\n\tconst fields: Record<string | number, VisualSharedTreeNode> = {};\n\n\tfor (const [fieldKey, childField] of Object.entries(treeFields)) {\n\t\tfields[fieldKey] = await visualizeSharedTreeBySchema(\n\t\t\tchildField,\n\t\t\ttreeDefinitions,\n\t\t\t{\n\t\t\t\tallowedTypes: fieldSchemaProperties[fieldKey]?.allowedTypes,\n\t\t\t\tisRequired: fieldSchemaProperties[fieldKey]?.isRequired,\n\t\t\t},\n\t\t\tvisualizeChildData,\n\t\t);\n\t}\n\n\treturn fields;\n}\n\n/**\n * Returns the schema & fields of the node with type {@link ObjectNodeStoredSchema}.\n */\nasync function visualizeObjectNode(\n\ttree: VerboseTreeNode,\n\tschema: SimpleObjectNodeSchema,\n\ttreeDefinitions: ReadonlyMap<string, SimpleNodeSchema>,\n\t{ allowedTypes, isRequired }: FieldSchemaProperties,\n\tvisualizeChildData: VisualizeChildData,\n): Promise<VisualSharedTreeNode> {\n\tconst objectNodeSchemaProperties: Record<string, FieldSchemaProperties> = {};\n\tfor (const [fieldKey, treeFieldSimpleSchema] of schema.fields) {\n\t\tobjectNodeSchemaProperties[fieldKey] = {\n\t\t\tallowedTypes: treeFieldSimpleSchema.allowedTypesIdentifiers,\n\t\t\tisRequired: treeFieldSimpleSchema.kind === FieldKind.Required ? true : false,\n\t\t};\n\t}\n\n\treturn {\n\t\tschema: {\n\t\t\tschemaName: tree.type,\n\t\t\tallowedTypes: concatenateTypes(allowedTypes ?? new Set()),\n\t\t\tisRequired: isRequired?.toString(),\n\t\t},\n\t\tfields: await visualizeVerboseNodeFields(\n\t\t\ttree.fields,\n\t\t\ttreeDefinitions,\n\t\t\tobjectNodeSchemaProperties,\n\t\t\tvisualizeChildData,\n\t\t),\n\t\tkind: VisualSharedTreeNodeKind.InternalNode,\n\t};\n}\n\n/**\n * Returns the schema & fields of the node with type {@link MapNodeStoredSchema}.\n */\nasync function visualizeMapNode(\n\ttree: VerboseTreeNode,\n\tschema: SimpleMapNodeSchema,\n\ttreeDefinitions: ReadonlyMap<string, SimpleNodeSchema>,\n\t{ allowedTypes, isRequired }: FieldSchemaProperties,\n\tvisualizeChildData: VisualizeChildData,\n): Promise<VisualSharedTreeNode> {\n\tconst mapNodeSchemaProperties: Record<string, FieldSchemaProperties> = {};\n\tfor (const key of Object.keys(tree.fields)) {\n\t\tmapNodeSchemaProperties[key] = {\n\t\t\tallowedTypes: schema.allowedTypesIdentifiers,\n\t\t\t// Map values are always required. Don't display field requirement information, since that information is redundant.\n\t\t\tisRequired: undefined,\n\t\t};\n\t}\n\n\treturn {\n\t\tschema: {\n\t\t\tschemaName: tree.type,\n\t\t\tallowedTypes: concatenateTypes(allowedTypes ?? new Set()),\n\t\t\tisRequired: isRequired?.toString(),\n\t\t},\n\t\tfields: await visualizeVerboseNodeFields(\n\t\t\ttree.fields,\n\t\t\ttreeDefinitions,\n\t\t\tmapNodeSchemaProperties,\n\t\t\tvisualizeChildData,\n\t\t),\n\t\tkind: VisualSharedTreeNodeKind.InternalNode,\n\t};\n}\n\n/**\n * Returns the schema & fields of the node with type {@link ArrayNodeStoredSchema}.\n */\nasync function visualizeArrayNode(\n\ttree: VerboseTreeNode,\n\tschema: SimpleArrayNodeSchema,\n\ttreeDefinitions: ReadonlyMap<string, SimpleNodeSchema>,\n\t{ allowedTypes, isRequired }: FieldSchemaProperties,\n\tvisualizeChildData: VisualizeChildData,\n): Promise<VisualSharedTreeNode> {\n\tconst children = tree.fields;\n\tif (!Array.isArray(children)) {\n\t\tthrow new TypeError(\"Invalid array\");\n\t}\n\n\tconst arrayNodeSchemaProperties: Record<string, FieldSchemaProperties> = {};\n\tfor (const [i] of children.entries()) {\n\t\tarrayNodeSchemaProperties[i] = {\n\t\t\tallowedTypes: schema.allowedTypesIdentifiers,\n\t\t\t// Array values are always required. Don't display field requirement information, since that information is redundant.\n\t\t\tisRequired: undefined,\n\t\t};\n\t}\n\n\treturn {\n\t\tschema: {\n\t\t\tschemaName: tree.type,\n\t\t\tallowedTypes: concatenateTypes(allowedTypes ?? new Set()),\n\t\t\tisRequired: isRequired?.toString(),\n\t\t},\n\t\tfields: await visualizeVerboseNodeFields(\n\t\t\ttree.fields,\n\t\t\ttreeDefinitions,\n\t\t\tarrayNodeSchemaProperties,\n\t\t\tvisualizeChildData,\n\t\t),\n\t\tkind: VisualSharedTreeNodeKind.InternalNode,\n\t};\n}\n\n/**\n * Creates the visual representation of non-leaf SharedTree nodes.\n *\n * @remarks\n * Processes internal tree nodes based on their schema type (e.g., ObjectNodeStoredSchema, MapNodeStoredSchema, ArrayNodeStoredSchema),\n * producing the visual representation for each type.\n *\n * @see {@link https://fluidframework.com/docs/data-structures/tree/} for more information on the SharedTree schema.\n *\n * @remarks\n */\nasync function visualizeNodeBySchema(\n\ttree: VerboseTreeNode,\n\ttreeDefinitions: ReadonlyMap<string, SimpleNodeSchema>,\n\t{ allowedTypes, isRequired }: FieldSchemaProperties,\n\tvisualizeChildData: VisualizeChildData,\n): Promise<VisualSharedTreeNode> {\n\tconst schema = treeDefinitions.get(tree.type);\n\n\tif (schema === undefined) {\n\t\tthrow new TypeError(\"Unrecognized schema type.\");\n\t}\n\n\tswitch (schema.kind) {\n\t\tcase NodeKind.Object: {\n\t\t\tconst objectVisualized = visualizeObjectNode(\n\t\t\t\ttree,\n\t\t\t\tschema,\n\t\t\t\ttreeDefinitions,\n\t\t\t\t{ allowedTypes, isRequired },\n\t\t\t\tvisualizeChildData,\n\t\t\t);\n\t\t\treturn objectVisualized;\n\t\t}\n\t\tcase NodeKind.Map: {\n\t\t\tconst mapVisualized = visualizeMapNode(\n\t\t\t\ttree,\n\t\t\t\tschema,\n\t\t\t\ttreeDefinitions,\n\t\t\t\t{ allowedTypes, isRequired },\n\t\t\t\tvisualizeChildData,\n\t\t\t);\n\t\t\treturn mapVisualized;\n\t\t}\n\t\tcase NodeKind.Array: {\n\t\t\treturn visualizeArrayNode(\n\t\t\t\ttree,\n\t\t\t\tschema,\n\t\t\t\ttreeDefinitions,\n\t\t\t\t{ allowedTypes, isRequired },\n\t\t\t\tvisualizeChildData,\n\t\t\t);\n\t\t}\n\t\tdefault: {\n\t\t\tthrow new TypeError(\"Unrecognized schema type.\");\n\t\t}\n\t}\n}\n\n/**\n * Creates a visual representation of a SharedTree based on its schema.\n * @param tree - The {@link VerboseTree} to visualize\n * @param treeDefinitions - Map containing all schema definitions for the entire tree structure. Each definition\n * describes the shape and constraints of a particular node type.\n * @param fieldSchemaProperties - Properties describing schema constraints for this field:\n * - `allowedTypes`: Set of type names that are valid for this specific node position in the tree.\n * This is a subset of the types defined in treeDefinitions.\n * - `isRequired`: Whether this field is required in its parent object schema.\n * Only meaningful for direct children of object nodes.\n * Undefined for array/map elements since they are always required within their parent.\n * @param visualizeChildData - Callback function to visualize child node data\n * @returns A visual representation of the tree that includes schema information and node values\n *\n * @remarks\n * This function handles both leaf nodes (primitive values, handles) and internal nodes (objects, maps, arrays).\n * For leaf nodes, it creates a visual representation with the node's schema and value.\n * For internal nodes, it recursively processes the node's fields using {@link visualizeNodeBySchema}.\n */\nexport async function visualizeSharedTreeBySchema(\n\ttree: VerboseTree,\n\ttreeDefinitions: ReadonlyMap<string, SimpleNodeSchema>,\n\t{ allowedTypes, isRequired }: FieldSchemaProperties,\n\tvisualizeChildData: VisualizeChildData,\n): Promise<VisualSharedTreeNode> {\n\treturn Tree.is(tree, SchemaFactory.leaves)\n\t\t? {\n\t\t\t\tschema: {\n\t\t\t\t\tschemaName: Tree.schema(tree).identifier,\n\t\t\t\t\tallowedTypes: concatenateTypes(allowedTypes ?? new Set()),\n\t\t\t\t\tisRequired: isRequired?.toString(),\n\t\t\t\t},\n\t\t\t\tvalue: await visualizeChildData(tree),\n\t\t\t\tkind: VisualSharedTreeNodeKind.LeafNode,\n\t\t\t}\n\t\t: visualizeNodeBySchema(\n\t\t\t\ttree,\n\t\t\t\ttreeDefinitions,\n\t\t\t\t{ allowedTypes, isRequired },\n\t\t\t\tvisualizeChildData,\n\t\t\t);\n}\n"]}
+{"version":3,"file":"SharedTreeVisualizer.js","sourceRoot":"","sources":["../../src/data-visualization/SharedTreeVisualizer.ts"],"names":[],"mappings":"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","sourcesContent":["/*!\n * Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n */\n\nimport { FieldKind } from \"@fluidframework/tree\";\nimport type {\n\tSimpleArrayNodeSchema,\n\tSimpleMapNodeSchema,\n\tSimpleNodeSchema,\n\tSimpleObjectNodeSchema,\n\tVerboseTree,\n\tVerboseTreeNode,\n} from \"@fluidframework/tree/internal\";\nimport { NodeKind, SchemaFactory, Tree } from \"@fluidframework/tree/internal\";\n\nimport type { VisualizeChildData } from \"./DataVisualization.js\";\nimport type { VisualSharedTreeNode, SharedTreeSchemaNode } from \"./VisualSharedTreeTypes.js\";\nimport { VisualSharedTreeNodeKind } from \"./VisualSharedTreeTypes.js\";\nimport {\n\ttype VisualChildNode,\n\tVisualNodeKind,\n\ttype VisualValueNode,\n\ttype VisualTreeNode,\n\ttype FluidHandleNode,\n\ttype UnknownObjectNode,\n} from \"./VisualTree.js\";\n\n/**\n * Returns VisualNodeKind that is compatible to {@link FluidObjectNode} based on the `visualTree`'s node kind.\n */\nexport function determineNodeKind(nodeKind: VisualNodeKind): VisualNodeKind {\n\tswitch (nodeKind) {\n\t\tcase VisualNodeKind.TreeNode:\n\t\tcase VisualNodeKind.FluidHandleNode: {\n\t\t\treturn VisualNodeKind.FluidTreeNode;\n\t\t}\n\t\tcase VisualNodeKind.ValueNode: {\n\t\t\treturn VisualNodeKind.FluidValueNode;\n\t\t}\n\t\tdefault: {\n\t\t\treturn VisualNodeKind.FluidUnknownObjectNode;\n\t\t}\n\t}\n}\n\n/**\n * Returns allowed types of the non-leaf nodes in the tree.\n * @param allowedTypes - a string if array node, `Record<string, string>` for non-array nodes.\n * @returns a VisualChildNode with the allowed type.\n */\nfunction createAllowedTypesVisualTree(\n\tallowedTypes: string | Record<string, string>,\n): VisualChildNode {\n\tif (typeof allowedTypes === \"string\") {\n\t\treturn {\n\t\t\tvalue: allowedTypes,\n\t\t\tnodeKind: VisualNodeKind.ValueNode,\n\t\t};\n\t}\n\n\tconst result: Record<string, VisualValueNode> = {};\n\tfor (const [allowedTypeKey, allowedType] of Object.entries(allowedTypes)) {\n\t\tresult[allowedTypeKey] = {\n\t\t\tnodeKind: VisualNodeKind.ValueNode,\n\t\t\tvalue: allowedType,\n\t\t};\n\t}\n\n\treturn {\n\t\tchildren: result,\n\t\tnodeKind: VisualNodeKind.TreeNode,\n\t};\n}\n\n/**\n * Creates a visual representation of the schema of the tree in {@link VisualTreeNode} format.\n */\nfunction createToolTipContents(schema: SharedTreeSchemaNode): VisualTreeNode {\n\tconst children: Record<string, VisualChildNode> = {\n\t\tname: {\n\t\t\tnodeKind: VisualNodeKind.ValueNode,\n\t\t\tvalue: schema.schemaName,\n\t\t},\n\t};\n\tif (schema.allowedTypes !== undefined) {\n\t\tchildren.allowedTypes = createAllowedTypesVisualTree(schema.allowedTypes);\n\t}\n\tif (schema.isRequired !== undefined) {\n\t\tchildren.isRequired = {\n\t\t\tnodeKind: VisualNodeKind.ValueNode,\n\t\t\tvalue: schema.isRequired,\n\t\t};\n\t}\n\treturn {\n\t\tnodeKind: VisualNodeKind.TreeNode,\n\t\tchildren,\n\t};\n}\n\n/**\n * Converts the visual representation from {@link visualizeNodeBySchema} to a visual tree compatible with the devtools-view.\n * @param tree - the visual representation of the SharedTree.\n * @returns the visual representation of type {@link VisualChildNode}\n */\nexport function toVisualTree(tree: VisualSharedTreeNode): VisualChildNode {\n\tif (tree.kind === VisualSharedTreeNodeKind.LeafNode) {\n\t\tswitch (tree.value.nodeKind) {\n\t\t\tcase VisualNodeKind.ValueNode: {\n\t\t\t\tconst result: VisualValueNode = {\n\t\t\t\t\tvalue: tree.value.value,\n\t\t\t\t\tnodeKind: VisualNodeKind.ValueNode,\n\t\t\t\t\ttooltipContents: {\n\t\t\t\t\t\tschema: createToolTipContents(tree.schema),\n\t\t\t\t\t},\n\t\t\t\t};\n\t\t\t\treturn result;\n\t\t\t}\n\t\t\tcase VisualNodeKind.FluidHandleNode: {\n\t\t\t\tconst result: FluidHandleNode = {\n\t\t\t\t\tfluidObjectId: tree.value.fluidObjectId,\n\t\t\t\t\tnodeKind: VisualNodeKind.FluidHandleNode,\n\t\t\t\t\ttooltipContents: {\n\t\t\t\t\t\tschema: createToolTipContents(tree.schema),\n\t\t\t\t\t},\n\t\t\t\t};\n\t\t\t\treturn result;\n\t\t\t}\n\t\t\tdefault: {\n\t\t\t\tconsole.error(`Unknown node kind: ${tree.value.nodeKind}`);\n\t\t\t\tconst result: UnknownObjectNode = {\n\t\t\t\t\tnodeKind: VisualNodeKind.UnknownObjectNode,\n\t\t\t\t\ttooltipContents: {\n\t\t\t\t\t\tschema: createToolTipContents(tree.schema),\n\t\t\t\t\t},\n\t\t\t\t};\n\t\t\t\treturn result;\n\t\t\t}\n\t\t}\n\t} else {\n\t\tconst children: Record<string, VisualChildNode> = {};\n\n\t\tfor (const [key, value] of Object.entries(tree.fields)) {\n\t\t\tconst child = toVisualTree(value);\n\t\t\tchildren[key] = child;\n\t\t}\n\n\t\treturn {\n\t\t\tchildren,\n\t\t\tnodeKind: VisualNodeKind.TreeNode,\n\t\t\ttooltipContents: {\n\t\t\t\tschema: createToolTipContents(tree.schema),\n\t\t\t},\n\t\t};\n\t}\n}\n\n/**\n * Concatenate allowed types for `ObjectNodeStoredSchema` and `MapNodeStoredSchema`.\n */\nexport function concatenateTypes(fieldTypes: ReadonlySet<string>): string {\n\treturn [...fieldTypes].join(\" | \");\n}\n\n/**\n * Properties that describe schema constraints for a field in the tree\n */\ninterface FieldSchemaProperties {\n\tallowedTypes: ReadonlySet<string> | undefined;\n\n\t/**\n\t * Whether the field is required (true) or optional (false).\n\t *\n\t * `undefined` indicates that the field is implicitly required.\n\t * In this case, no requirement information will be displayed by the devtools.\n\t */\n\tisRequired: boolean | undefined;\n}\n\n/**\n * Processes and visualizes the fields of a verbose tree node.\n *\n * @param treeFields - The fields of the tree node to visualize. Can be either an array of VerboseTree (for array nodes) or a Record of field names to VerboseTree (for object/map nodes).\n * @param treeDefinitions - Map containing all schema definitions for the entire tree structure. Each definition describes the shape and constraints of a particular node type.\n * @param fieldSchemaProperties - Record mapping field names to their schema properties, including allowed types and whether they are required.\n * @param visualizeChildData - Callback function to visualize child node data.\n *\n * @returns A record mapping field names/indices to their visual tree representations.\n */\nasync function visualizeVerboseNodeFields(\n\ttreeFields: readonly VerboseTree[] | Record<string, VerboseTree>,\n\ttreeDefinitions: ReadonlyMap<string, SimpleNodeSchema>,\n\tfieldSchemaProperties: Record<string, FieldSchemaProperties>,\n\tvisualizeChildData: VisualizeChildData,\n): Promise<Record<string, VisualSharedTreeNode>> {\n\tconst fields: Record<string | number, VisualSharedTreeNode> = {};\n\n\tfor (const [fieldKey, childField] of Object.entries(treeFields)) {\n\t\tfields[fieldKey] = await visualizeSharedTreeBySchema(\n\t\t\tchildField,\n\t\t\ttreeDefinitions,\n\t\t\t{\n\t\t\t\tallowedTypes: fieldSchemaProperties[fieldKey]?.allowedTypes,\n\t\t\t\tisRequired: fieldSchemaProperties[fieldKey]?.isRequired,\n\t\t\t},\n\t\t\tvisualizeChildData,\n\t\t);\n\t}\n\n\treturn fields;\n}\n\n/**\n * Returns the schema & fields of the node with type {@link ObjectNodeStoredSchema}.\n */\nasync function visualizeObjectNode(\n\ttree: VerboseTreeNode,\n\tschema: SimpleObjectNodeSchema,\n\ttreeDefinitions: ReadonlyMap<string, SimpleNodeSchema>,\n\t{ allowedTypes, isRequired }: FieldSchemaProperties,\n\tvisualizeChildData: VisualizeChildData,\n): Promise<VisualSharedTreeNode> {\n\tconst objectNodeSchemaProperties: Record<string, FieldSchemaProperties> = {};\n\tfor (const [fieldKey, treeFieldSimpleSchema] of schema.fields) {\n\t\tobjectNodeSchemaProperties[fieldKey] = {\n\t\t\tallowedTypes: treeFieldSimpleSchema.allowedTypesIdentifiers,\n\t\t\tisRequired: treeFieldSimpleSchema.kind === FieldKind.Required ? true : false,\n\t\t};\n\t}\n\n\treturn {\n\t\tschema: {\n\t\t\tschemaName: tree.type,\n\t\t\tallowedTypes: concatenateTypes(allowedTypes ?? new Set()),\n\t\t\tisRequired: isRequired?.toString(),\n\t\t},\n\t\tfields: await visualizeVerboseNodeFields(\n\t\t\ttree.fields,\n\t\t\ttreeDefinitions,\n\t\t\tobjectNodeSchemaProperties,\n\t\t\tvisualizeChildData,\n\t\t),\n\t\tkind: VisualSharedTreeNodeKind.InternalNode,\n\t};\n}\n\n/**\n * Returns the schema & fields of the node with type {@link MapNodeStoredSchema}.\n */\nasync function visualizeMapNode(\n\ttree: VerboseTreeNode,\n\tschema: SimpleMapNodeSchema,\n\ttreeDefinitions: ReadonlyMap<string, SimpleNodeSchema>,\n\t{ allowedTypes, isRequired }: FieldSchemaProperties,\n\tvisualizeChildData: VisualizeChildData,\n): Promise<VisualSharedTreeNode> {\n\tconst mapNodeSchemaProperties: Record<string, FieldSchemaProperties> = {};\n\tfor (const key of Object.keys(tree.fields)) {\n\t\tmapNodeSchemaProperties[key] = {\n\t\t\tallowedTypes: schema.allowedTypesIdentifiers,\n\t\t\t// Map values are always required. Don't display field requirement information, since that information is redundant.\n\t\t\tisRequired: undefined,\n\t\t};\n\t}\n\n\treturn {\n\t\tschema: {\n\t\t\tschemaName: tree.type,\n\t\t\tallowedTypes: concatenateTypes(allowedTypes ?? new Set()),\n\t\t\tisRequired: isRequired?.toString(),\n\t\t},\n\t\tfields: await visualizeVerboseNodeFields(\n\t\t\ttree.fields,\n\t\t\ttreeDefinitions,\n\t\t\tmapNodeSchemaProperties,\n\t\t\tvisualizeChildData,\n\t\t),\n\t\tkind: VisualSharedTreeNodeKind.InternalNode,\n\t};\n}\n\n/**\n * Returns the schema & fields of the node with type {@link ArrayNodeStoredSchema}.\n */\nasync function visualizeArrayNode(\n\ttree: VerboseTreeNode,\n\tschema: SimpleArrayNodeSchema,\n\ttreeDefinitions: ReadonlyMap<string, SimpleNodeSchema>,\n\t{ allowedTypes, isRequired }: FieldSchemaProperties,\n\tvisualizeChildData: VisualizeChildData,\n): Promise<VisualSharedTreeNode> {\n\tconst children = tree.fields;\n\tif (!Array.isArray(children)) {\n\t\tthrow new TypeError(\"Invalid array\");\n\t}\n\n\tconst arrayNodeSchemaProperties: Record<string, FieldSchemaProperties> = {};\n\tfor (const [i] of children.entries()) {\n\t\tarrayNodeSchemaProperties[i] = {\n\t\t\tallowedTypes: schema.allowedTypesIdentifiers,\n\t\t\t// Array values are always required. Don't display field requirement information, since that information is redundant.\n\t\t\tisRequired: undefined,\n\t\t};\n\t}\n\n\treturn {\n\t\tschema: {\n\t\t\tschemaName: tree.type,\n\t\t\tallowedTypes: concatenateTypes(allowedTypes ?? new Set()),\n\t\t\tisRequired: isRequired?.toString(),\n\t\t},\n\t\tfields: await visualizeVerboseNodeFields(\n\t\t\ttree.fields,\n\t\t\ttreeDefinitions,\n\t\t\tarrayNodeSchemaProperties,\n\t\t\tvisualizeChildData,\n\t\t),\n\t\tkind: VisualSharedTreeNodeKind.InternalNode,\n\t};\n}\n\n/**\n * Creates the visual representation of non-leaf SharedTree nodes.\n *\n * @remarks\n * Processes internal tree nodes based on their schema type (e.g., ObjectNodeStoredSchema, MapNodeStoredSchema, ArrayNodeStoredSchema),\n * producing the visual representation for each type.\n *\n * @see {@link https://fluidframework.com/docs/data-structures/tree/} for more information on the SharedTree schema.\n *\n * @remarks\n */\nasync function visualizeNodeBySchema(\n\ttree: VerboseTreeNode,\n\ttreeDefinitions: ReadonlyMap<string, SimpleNodeSchema>,\n\t{ allowedTypes, isRequired }: FieldSchemaProperties,\n\tvisualizeChildData: VisualizeChildData,\n): Promise<VisualSharedTreeNode> {\n\tconst schema = treeDefinitions.get(tree.type);\n\n\tif (schema === undefined) {\n\t\tthrow new TypeError(\"Unrecognized schema type.\");\n\t}\n\n\tswitch (schema.kind) {\n\t\tcase NodeKind.Object: {\n\t\t\tconst objectVisualized = visualizeObjectNode(\n\t\t\t\ttree,\n\t\t\t\tschema,\n\t\t\t\ttreeDefinitions,\n\t\t\t\t{ allowedTypes, isRequired },\n\t\t\t\tvisualizeChildData,\n\t\t\t);\n\t\t\treturn objectVisualized;\n\t\t}\n\t\tcase NodeKind.Map: {\n\t\t\tconst mapVisualized = visualizeMapNode(\n\t\t\t\ttree,\n\t\t\t\tschema,\n\t\t\t\ttreeDefinitions,\n\t\t\t\t{ allowedTypes, isRequired },\n\t\t\t\tvisualizeChildData,\n\t\t\t);\n\t\t\treturn mapVisualized;\n\t\t}\n\t\tcase NodeKind.Array: {\n\t\t\treturn visualizeArrayNode(\n\t\t\t\ttree,\n\t\t\t\tschema,\n\t\t\t\ttreeDefinitions,\n\t\t\t\t{ allowedTypes, isRequired },\n\t\t\t\tvisualizeChildData,\n\t\t\t);\n\t\t}\n\t\tdefault: {\n\t\t\tthrow new TypeError(\"Unrecognized schema type.\");\n\t\t}\n\t}\n}\n\n/**\n * Creates a visual representation of a SharedTree based on its schema.\n * @param tree - The {@link VerboseTree} to visualize\n * @param treeDefinitions - Map containing all schema definitions for the entire tree structure. Each definition\n * describes the shape and constraints of a particular node type.\n * @param fieldSchemaProperties - Properties describing schema constraints for this field:\n * - `allowedTypes`: Set of type names that are valid for this specific node position in the tree.\n * This is a subset of the types defined in treeDefinitions.\n * - `isRequired`: Whether this field is required in its parent object schema.\n * Only meaningful for direct children of object nodes.\n * Undefined for array/map elements since they are always required within their parent.\n * @param visualizeChildData - Callback function to visualize child node data\n * @returns A visual representation of the tree that includes schema information and node values\n *\n * @remarks\n * This function handles both leaf nodes (primitive values, handles) and internal nodes (objects, maps, arrays).\n * For leaf nodes, it creates a visual representation with the node's schema and value.\n * For internal nodes, it recursively processes the node's fields using {@link visualizeNodeBySchema}.\n */\nexport async function visualizeSharedTreeBySchema(\n\ttree: VerboseTree,\n\ttreeDefinitions: ReadonlyMap<string, SimpleNodeSchema>,\n\t{ allowedTypes, isRequired }: FieldSchemaProperties,\n\tvisualizeChildData: VisualizeChildData,\n): Promise<VisualSharedTreeNode> {\n\treturn Tree.is(tree, SchemaFactory.leaves)\n\t\t? {\n\t\t\t\tschema: {\n\t\t\t\t\tschemaName: Tree.schema(tree).identifier,\n\t\t\t\t\tallowedTypes: concatenateTypes(allowedTypes ?? new Set()),\n\t\t\t\t\tisRequired: isRequired?.toString(),\n\t\t\t\t},\n\t\t\t\tvalue: await visualizeChildData(tree),\n\t\t\t\tkind: VisualSharedTreeNodeKind.LeafNode,\n\t\t\t}\n\t\t: visualizeNodeBySchema(\n\t\t\t\ttree,\n\t\t\t\ttreeDefinitions,\n\t\t\t\t{ allowedTypes, isRequired },\n\t\t\t\tvisualizeChildData,\n\t\t\t);\n}\n"]}

package/lib/packageVersion.d.ts

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

package/lib/packageVersion.js

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

package/lib/packageVersion.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fluidframework/devtools-core",
-  "version": "2.70.0-360753",
+  "version": "2.70.0-361248",
   "description": "Fluid Framework developer tools core functionality",
   "homepage": "https://fluidframework.com",
   "repository": {
@@ -67,37 +67,37 @@
     "temp-directory": "nyc/.nyc_output"
   },
   "dependencies": {
-    "@fluid-internal/client-utils": "2.70.0-360753",
-    "@fluidframework/aqueduct": "2.70.0-360753",
-    "@fluidframework/cell": "2.70.0-360753",
-    "@fluidframework/container-definitions": "2.70.0-360753",
-    "@fluidframework/container-loader": "2.70.0-360753",
-    "@fluidframework/container-runtime": "2.70.0-360753",
-    "@fluidframework/container-runtime-definitions": "2.70.0-360753",
-    "@fluidframework/core-interfaces": "2.70.0-360753",
-    "@fluidframework/core-utils": "2.70.0-360753",
-    "@fluidframework/counter": "2.70.0-360753",
-    "@fluidframework/datastore-definitions": "2.70.0-360753",
-    "@fluidframework/driver-definitions": "2.70.0-360753",
-    "@fluidframework/map": "2.70.0-360753",
-    "@fluidframework/matrix": "2.70.0-360753",
-    "@fluidframework/runtime-definitions": "2.70.0-360753",
-    "@fluidframework/sequence": "2.70.0-360753",
-    "@fluidframework/shared-object-base": "2.70.0-360753",
-    "@fluidframework/telemetry-utils": "2.70.0-360753",
-    "@fluidframework/tree": "2.70.0-360753"
+    "@fluid-internal/client-utils": "2.70.0-361248",
+    "@fluidframework/aqueduct": "2.70.0-361248",
+    "@fluidframework/cell": "2.70.0-361248",
+    "@fluidframework/container-definitions": "2.70.0-361248",
+    "@fluidframework/container-loader": "2.70.0-361248",
+    "@fluidframework/container-runtime": "2.70.0-361248",
+    "@fluidframework/container-runtime-definitions": "2.70.0-361248",
+    "@fluidframework/core-interfaces": "2.70.0-361248",
+    "@fluidframework/core-utils": "2.70.0-361248",
+    "@fluidframework/counter": "2.70.0-361248",
+    "@fluidframework/datastore-definitions": "2.70.0-361248",
+    "@fluidframework/driver-definitions": "2.70.0-361248",
+    "@fluidframework/map": "2.70.0-361248",
+    "@fluidframework/matrix": "2.70.0-361248",
+    "@fluidframework/runtime-definitions": "2.70.0-361248",
+    "@fluidframework/sequence": "2.70.0-361248",
+    "@fluidframework/shared-object-base": "2.70.0-361248",
+    "@fluidframework/telemetry-utils": "2.70.0-361248",
+    "@fluidframework/tree": "2.70.0-361248"
   },
   "devDependencies": {
     "@arethetypeswrong/cli": "^0.17.1",
     "@biomejs/biome": "~1.9.3",
-    "@fluid-internal/mocha-test-setup": "2.70.0-360753",
+    "@fluid-internal/mocha-test-setup": "2.70.0-361248",
     "@fluid-tools/build-cli": "^0.58.3",
     "@fluidframework/build-common": "^2.0.3",
     "@fluidframework/build-tools": "^0.58.3",
     "@fluidframework/devtools-core-previous": "npm:@fluidframework/devtools-core@2.63.0",
-    "@fluidframework/eslint-config-fluid": "^6.0.0",
-    "@fluidframework/id-compressor": "2.70.0-360753",
-    "@fluidframework/test-runtime-utils": "2.70.0-360753",
+    "@fluidframework/eslint-config-fluid": "^6.1.0",
+    "@fluidframework/id-compressor": "2.70.0-361248",
+    "@fluidframework/test-runtime-utils": "2.70.0-361248",
     "@microsoft/api-extractor": "7.52.11",
     "@types/chai": "^4.0.0",
     "@types/mocha": "^10.0.10",
@@ -106,8 +106,8 @@
     "concurrently": "^8.2.1",
     "copyfiles": "^2.4.1",
     "cross-env": "^7.0.3",
-    "eslint": "~8.55.0",
-    "eslint-config-prettier": "~9.0.0",
+    "eslint": "~8.57.1",
+    "eslint-config-prettier": "~10.1.8",
     "eslint-plugin-chai-expect": "~3.0.0",
     "mocha": "^10.8.2",
     "mocha-multi-reporters": "^1.5.1",

package/src/DevtoolsLogger.ts

@@ -33,7 +33,7 @@ import {
  * @sealed
  * @beta
  */
-// eslint-disable-next-line @typescript-eslint/no-empty-interface
+// eslint-disable-next-line @typescript-eslint/no-empty-object-type, @typescript-eslint/no-empty-interface
 export interface IDevtoolsLogger extends ITelemetryBaseLogger {}
 
 /**

package/src/data-visualization/SharedTreeVisualizer.ts

@@ -47,7 +47,7 @@ export function determineNodeKind(nodeKind: VisualNodeKind): VisualNodeKind {
 /**
  * Returns allowed types of the non-leaf nodes in the tree.
  * @param allowedTypes - a string if array node, `Record<string, string>` for non-array nodes.
- * @returns - a VisualChildNode with the allowed type.
+ * @returns a VisualChildNode with the allowed type.
  */
 function createAllowedTypesVisualTree(
 	allowedTypes: string | Record<string, string>,
@@ -101,7 +101,7 @@ function createToolTipContents(schema: SharedTreeSchemaNode): VisualTreeNode {
 /**
  * Converts the visual representation from {@link visualizeNodeBySchema} to a visual tree compatible with the devtools-view.
  * @param tree - the visual representation of the SharedTree.
- * @returns - the visual representation of type {@link VisualChildNode}
+ * @returns the visual representation of type {@link VisualChildNode}
  */
 export function toVisualTree(tree: VisualSharedTreeNode): VisualChildNode {
 	if (tree.kind === VisualSharedTreeNodeKind.LeafNode) {

package/src/packageVersion.ts

@@ -6,4 +6,4 @@
  */
 
 export const pkgName = "@fluidframework/devtools-core";
-export const pkgVersion = "2.70.0-360753";
+export const pkgVersion = "2.70.0-361248";