@carbon/ai-chat-components 0.8.0 → 0.9.0

package/custom-elements.json

@@ -244,7 +244,7 @@
       "declarations": [
         {
           "kind": "variable",
-          "name": "CdsAiChatShell"
+          "name": "CDSAIChatShell"
         }
       ],
       "exports": [
@@ -252,7 +252,7 @@
           "kind": "js",
           "name": "default",
           "declaration": {
-            "name": "CdsAiChatShell",
+            "name": "CDSAIChatShell",
             "module": "src/react/chat-shell.ts"
           }
         }
@@ -380,7 +380,7 @@
       "declarations": [
         {
           "kind": "variable",
-          "name": "CdsAiChatPanel"
+          "name": "CDSAIChatPanel"
         }
       ],
       "exports": [
@@ -388,7 +388,7 @@
           "kind": "js",
           "name": "default",
           "declaration": {
-            "name": "CdsAiChatPanel",
+            "name": "CDSAIChatPanel",
             "module": "src/react/panel.ts"
           }
         }
@@ -2244,12 +2244,162 @@
     },
     {
       "kind": "javascript-module",
-      "path": "src/components/chat-shell/src/cds-aichat-panel.ts",
+      "path": "src/components/chat-shell/src/panel-manager.ts",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "",
+          "name": "PanelManager",
+          "members": [
+            {
+              "kind": "field",
+              "name": "panelObservers",
+              "privacy": "private",
+              "default": "new Map<HTMLElement, MutationObserver>()"
+            },
+            {
+              "kind": "field",
+              "name": "slotElements",
+              "type": {
+                "text": "HTMLElement[]"
+              },
+              "privacy": "private",
+              "default": "[]"
+            },
+            {
+              "kind": "method",
+              "name": "connect"
+            },
+            {
+              "kind": "method",
+              "name": "disconnect"
+            },
+            {
+              "kind": "method",
+              "name": "refresh"
+            },
+            {
+              "kind": "field",
+              "name": "onSlotChange",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "observeAssignedPanels",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "stopObservingPanels",
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "onPanelMutation",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "updateState",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "getAssignedPanelElements",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "HTMLElement[]"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "getPanelStates",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "PanelState[]"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "pickActivePanel",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "PanelState | undefined"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "panels",
+                  "type": {
+                    "text": "PanelState[]"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "setInert",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "target",
+                  "type": {
+                    "text": "HTMLElement | undefined"
+                  }
+                },
+                {
+                  "name": "value",
+                  "type": {
+                    "text": "boolean"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "isPanelAnimating",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "panelElement",
+                  "type": {
+                    "text": "HTMLElement"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "syncSlotElements",
+              "privacy": "private"
+            }
+          ]
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "PanelManager",
+          "declaration": {
+            "name": "PanelManager",
+            "module": "src/components/chat-shell/src/panel-manager.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/chat-shell/src/panel.ts",
       "declarations": [
         {
           "kind": "class",
           "description": "",
-          "name": "CdsAiChatPanel",
+          "name": "CDSAIChatPanel",
           "members": [
             {
               "kind": "field",
@@ -2306,6 +2456,28 @@
               "attribute": "show-frame",
               "reflects": true
             },
+            {
+              "kind": "field",
+              "name": "aiEnabled",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Shows the AI gradient background",
+              "attribute": "ai-enabled",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "bodyNoPadding",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Removes padding from the panel body",
+              "attribute": "body-no-padding",
+              "reflects": true
+            },
             {
               "kind": "field",
               "name": "animationOnOpen",
@@ -2473,6 +2645,11 @@
               "kind": "method",
               "name": "observeSlotContent",
               "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "handleBodyScroll",
+              "privacy": "private"
             }
           ],
           "events": [
@@ -2547,6 +2724,24 @@
               "description": "Shows a frame border around the panel",
               "fieldName": "showFrame"
             },
+            {
+              "name": "ai-enabled",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Shows the AI gradient background",
+              "fieldName": "aiEnabled"
+            },
+            {
+              "name": "body-no-padding",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Removes padding from the panel body",
+              "fieldName": "bodyNoPadding"
+            },
             {
               "name": "animation-on-open",
               "type": {
@@ -2586,20 +2781,20 @@
           "kind": "js",
           "name": "default",
           "declaration": {
-            "name": "CdsAiChatPanel",
-            "module": "src/components/chat-shell/src/cds-aichat-panel.ts"
+            "name": "CDSAIChatPanel",
+            "module": "src/components/chat-shell/src/panel.ts"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "src/components/chat-shell/src/cds-aichat-shell.ts",
+      "path": "src/components/chat-shell/src/shell.ts",
       "declarations": [
         {
           "kind": "class",
           "description": "",
-          "name": "CdsAiChatShell",
+          "name": "CDSAIChatShell",
           "members": [
             {
               "kind": "field",
@@ -2678,6 +2873,36 @@
               "attribute": "history-location",
               "reflects": true
             },
+            {
+              "kind": "field",
+              "name": "workspaceAriaLabel",
+              "type": {
+                "text": "string"
+              },
+              "default": "\"Workspace panel\"",
+              "description": "ARIA label for the workspace region",
+              "attribute": "workspace-aria-label"
+            },
+            {
+              "kind": "field",
+              "name": "historyAriaLabel",
+              "type": {
+                "text": "string"
+              },
+              "default": "\"Conversation history\"",
+              "description": "ARIA label for the history region",
+              "attribute": "history-aria-label"
+            },
+            {
+              "kind": "field",
+              "name": "messagesAriaLabel",
+              "type": {
+                "text": "string"
+              },
+              "default": "\"Chat messages\"",
+              "description": "ARIA label for the messages region",
+              "attribute": "messages-aria-label"
+            },
             {
               "kind": "method",
               "name": "getWidgetClasses",
@@ -2801,6 +3026,24 @@
                 }
               ]
             },
+            {
+              "kind": "method",
+              "name": "hasElementContent",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "boolean"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "element",
+                  "type": {
+                    "text": "Element"
+                  }
+                }
+              ]
+            },
             {
               "kind": "method",
               "name": "observeSlotContent",
@@ -2876,6 +3119,41 @@
                 }
               },
               "description": "Check if --cds-aichat-messages-max-width has changed and trigger recalculation."
+            },
+            {
+              "kind": "method",
+              "name": "syncWorkspacePanelState",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "scheduleWorkspacePanelOpen",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "cancelWorkspacePanelOpenSchedule",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "field",
+              "name": "handleWorkspacePanelCloseEnd",
+              "privacy": "private"
             }
           ],
           "attributes": [
@@ -2941,11 +3219,38 @@
               "default": "\"start\"",
               "description": "Determines the location of the history panel (\"start\" or \"end\")",
               "fieldName": "historyLocation"
-            }
-          ],
-          "superclass": {
-            "name": "LitElement",
-            "package": "lit"
+            },
+            {
+              "name": "workspace-aria-label",
+              "type": {
+                "text": "string"
+              },
+              "default": "\"Workspace panel\"",
+              "description": "ARIA label for the workspace region",
+              "fieldName": "workspaceAriaLabel"
+            },
+            {
+              "name": "history-aria-label",
+              "type": {
+                "text": "string"
+              },
+              "default": "\"Conversation history\"",
+              "description": "ARIA label for the history region",
+              "fieldName": "historyAriaLabel"
+            },
+            {
+              "name": "messages-aria-label",
+              "type": {
+                "text": "string"
+              },
+              "default": "\"Chat messages\"",
+              "description": "ARIA label for the messages region",
+              "fieldName": "messagesAriaLabel"
+            }
+          ],
+          "superclass": {
+            "name": "LitElement",
+            "package": "lit"
           },
           "tagName": "cds-aichat-shell",
           "customElement": true
@@ -2956,158 +3261,305 @@
           "kind": "js",
           "name": "default",
           "declaration": {
-            "name": "CdsAiChatShell",
-            "module": "src/components/chat-shell/src/cds-aichat-shell.ts"
+            "name": "CDSAIChatShell",
+            "module": "src/components/chat-shell/src/shell.ts"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "src/components/chat-shell/src/panel-manager.ts",
+      "path": "src/components/chat-shell/src/workspace-manager-utils.ts",
       "declarations": [
         {
-          "kind": "class",
-          "description": "",
-          "name": "PanelManager",
-          "members": [
-            {
-              "kind": "field",
-              "name": "panelObservers",
-              "privacy": "private",
-              "default": "new Map<HTMLElement, MutationObserver>()"
-            },
+          "kind": "function",
+          "name": "calculateRequiredWidth",
+          "return": {
+            "type": {
+              "text": ""
+            }
+          },
+          "parameters": [
             {
-              "kind": "field",
-              "name": "slotElements",
+              "name": "dimensions",
               "type": {
-                "text": "HTMLElement[]"
+                "text": "{\n  workspaceMinWidth: number;\n  messagesMinWidth: number;\n  historyWidth: number;\n}"
               },
-              "privacy": "private",
-              "default": "[]"
+              "description": "Layout dimensions"
             },
             {
-              "kind": "method",
-              "name": "connect"
+              "description": "Minimum width for workspace area",
+              "name": "dimensions.workspaceMinWidth"
             },
             {
-              "kind": "method",
-              "name": "disconnect"
+              "description": "Minimum width for messages area",
+              "name": "dimensions.messagesMinWidth"
             },
             {
-              "kind": "method",
-              "name": "refresh"
-            },
+              "description": "Width for history panel",
+              "name": "dimensions.historyWidth"
+            }
+          ],
+          "description": "Calculate the minimum width required for side-by-side layout."
+        },
+        {
+          "kind": "function",
+          "name": "hasSignificantWidthChange",
+          "return": {
+            "type": {
+              "text": ""
+            }
+          },
+          "parameters": [
             {
-              "kind": "field",
-              "name": "onSlotChange",
-              "privacy": "private"
+              "name": "current",
+              "type": {
+                "text": "number"
+              },
+              "description": "Current width value"
             },
             {
-              "kind": "method",
-              "name": "observeAssignedPanels",
-              "privacy": "private"
+              "name": "initial",
+              "type": {
+                "text": "number"
+              },
+              "description": "Initial width value"
             },
             {
-              "kind": "method",
-              "name": "stopObservingPanels",
-              "privacy": "private"
+              "name": "threshold",
+              "type": {
+                "text": "number"
+              },
+              "description": "Minimum change threshold in pixels"
+            }
+          ],
+          "description": "Check if width change exceeds the threshold for meaningful expansion."
+        },
+        {
+          "kind": "function",
+          "name": "isWideEnough",
+          "return": {
+            "type": {
+              "text": ""
+            }
+          },
+          "parameters": [
+            {
+              "name": "inlineSize",
+              "type": {
+                "text": "number"
+              },
+              "description": "Current width of the host element"
             },
             {
-              "kind": "field",
-              "name": "onPanelMutation",
-              "privacy": "private"
+              "name": "requiredWidth",
+              "type": {
+                "text": "number"
+              },
+              "description": "Minimum width required for side-by-side layout"
+            }
+          ],
+          "description": "Check if the host element is wide enough for side-by-side layout."
+        },
+        {
+          "kind": "function",
+          "name": "canHostGrow",
+          "return": {
+            "type": {
+              "text": ""
+            }
+          },
+          "parameters": [
+            {
+              "name": "requiredWidth",
+              "type": {
+                "text": "number"
+              },
+              "description": "Minimum width required for side-by-side layout"
+            }
+          ],
+          "description": "Check if the host element can potentially grow to the required width."
+        },
+        {
+          "kind": "function",
+          "name": "getInlineSizeFromEntry",
+          "return": {
+            "type": {
+              "text": ""
+            }
+          },
+          "parameters": [
+            {
+              "name": "entry",
+              "type": {
+                "text": "ResizeObserverEntry"
+              },
+              "description": "ResizeObserver entry containing size information"
+            }
+          ],
+          "description": "Extract inline size from a ResizeObserverEntry."
+        },
+        {
+          "kind": "function",
+          "name": "getCssLengthFromProperty",
+          "return": {
+            "type": {
+              "text": ""
+            }
+          },
+          "parameters": [
+            {
+              "name": "element",
+              "type": {
+                "text": "HTMLElement"
+              },
+              "description": "Element to get computed style from"
             },
             {
-              "kind": "method",
-              "name": "updateState",
-              "privacy": "private"
+              "name": "propertyName",
+              "type": {
+                "text": "string"
+              },
+              "description": "CSS custom property name"
             },
             {
-              "kind": "method",
-              "name": "getAssignedPanelElements",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "HTMLElement[]"
-                }
-              }
+              "name": "fallback",
+              "type": {
+                "text": "number"
+              },
+              "description": "Fallback value if property is not set or invalid"
+            }
+          ],
+          "description": "Parse a CSS length value from a computed style property."
+        },
+        {
+          "kind": "function",
+          "name": "areWorkspaceAttributesCorrect",
+          "return": {
+            "type": {
+              "text": ""
+            }
+          },
+          "parameters": [
+            {
+              "name": "element",
+              "type": {
+                "text": "HTMLElement"
+              },
+              "description": "Host element containing workspace attributes"
             },
             {
-              "kind": "method",
-              "name": "getPanelStates",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "PanelState[]"
-                }
-              }
+              "name": "inPanel",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "Expected panel state"
+            }
+          ],
+          "description": "Check if workspace DOM attributes match the expected panel state."
+        },
+        {
+          "kind": "function",
+          "name": "shouldSkipWorkspaceUpdate",
+          "return": {
+            "type": {
+              "text": ""
+            }
+          },
+          "parameters": [
+            {
+              "name": "config",
+              "type": {
+                "text": "{ showWorkspace: boolean }"
+              },
+              "description": "Workspace configuration"
             },
             {
-              "kind": "method",
-              "name": "pickActivePanel",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "PanelState | undefined"
-                }
+              "name": "state",
+              "type": {
+                "text": "{ containerVisible: boolean; isContracting: boolean }"
               },
-              "parameters": [
-                {
-                  "name": "panels",
-                  "type": {
-                    "text": "PanelState[]"
-                  }
-                }
-              ]
+              "description": "Current workspace state"
             },
             {
-              "kind": "method",
-              "name": "setInert",
-              "privacy": "private",
-              "parameters": [
-                {
-                  "name": "target",
-                  "type": {
-                    "text": "HTMLElement | undefined"
-                  }
-                },
-                {
-                  "name": "value",
-                  "type": {
-                    "text": "boolean"
-                  }
-                }
-              ]
+              "description": "Whether workspace is enabled",
+              "name": "config.showWorkspace"
             },
             {
-              "kind": "method",
-              "name": "isPanelAnimating",
-              "privacy": "private",
-              "parameters": [
-                {
-                  "name": "panelElement",
-                  "type": {
-                    "text": "HTMLElement"
-                  }
-                }
-              ]
+              "description": "Whether workspace container is visible",
+              "name": "state.containerVisible"
             },
             {
-              "kind": "method",
-              "name": "syncSlotElements",
-              "privacy": "private"
+              "description": "Whether workspace is currently contracting",
+              "name": "state.isContracting"
             }
-          ]
+          ],
+          "description": "Check if workspace update should be skipped based on current state."
         }
       ],
       "exports": [
         {
           "kind": "js",
-          "name": "PanelManager",
+          "name": "calculateRequiredWidth",
           "declaration": {
-            "name": "PanelManager",
-            "module": "src/components/chat-shell/src/panel-manager.ts"
+            "name": "calculateRequiredWidth",
+            "module": "src/components/chat-shell/src/workspace-manager-utils.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "hasSignificantWidthChange",
+          "declaration": {
+            "name": "hasSignificantWidthChange",
+            "module": "src/components/chat-shell/src/workspace-manager-utils.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "isWideEnough",
+          "declaration": {
+            "name": "isWideEnough",
+            "module": "src/components/chat-shell/src/workspace-manager-utils.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "canHostGrow",
+          "declaration": {
+            "name": "canHostGrow",
+            "module": "src/components/chat-shell/src/workspace-manager-utils.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "getInlineSizeFromEntry",
+          "declaration": {
+            "name": "getInlineSizeFromEntry",
+            "module": "src/components/chat-shell/src/workspace-manager-utils.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "getCssLengthFromProperty",
+          "declaration": {
+            "name": "getCssLengthFromProperty",
+            "module": "src/components/chat-shell/src/workspace-manager-utils.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "areWorkspaceAttributesCorrect",
+          "declaration": {
+            "name": "areWorkspaceAttributesCorrect",
+            "module": "src/components/chat-shell/src/workspace-manager-utils.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "shouldSkipWorkspaceUpdate",
+          "declaration": {
+            "name": "shouldSkipWorkspaceUpdate",
+            "module": "src/components/chat-shell/src/workspace-manager-utils.ts"
           }
         }
       ]
@@ -3128,7 +3580,7 @@
                 "text": "WorkspaceState"
               },
               "privacy": "private",
-              "default": "{ inPanel: false, contentVisible: true, containerVisible: false, isExpanding: false, isContracting: false, }"
+              "default": "{ inPanel: false, contentVisible: true, containerVisible: false, isCheckingExpansion: false, isExpanding: false, isCheckingContracting: false, isContracting: false, }"
             },
             {
               "kind": "field",
@@ -3164,7 +3616,15 @@
             },
             {
               "kind": "field",
-              "name": "closingCheckInterval",
+              "name": "contractionCheckInterval",
+              "type": {
+                "text": "number | undefined"
+              },
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "contractionLastInlineSize",
               "type": {
                 "text": "number | undefined"
               },
@@ -3172,7 +3632,7 @@
             },
             {
               "kind": "field",
-              "name": "closingLastInlineSize",
+              "name": "contractionInitialInlineSize",
               "type": {
                 "text": "number | undefined"
               },
@@ -3235,7 +3695,163 @@
             },
             {
               "kind": "method",
-              "name": "updateConfig",
+              "name": "updateConfig",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "newConfig",
+                  "type": {
+                    "text": "Partial<WorkspaceConfig>"
+                  }
+                }
+              ],
+              "description": "Update workspace configuration.\nHandles transitions when workspace visibility or related settings change."
+            },
+            {
+              "kind": "method",
+              "name": "getState",
+              "return": {
+                "type": {
+                  "text": "Readonly<WorkspaceState>"
+                }
+              },
+              "description": "Get current workspace state.\nReturns a readonly copy to prevent external mutations."
+            },
+            {
+              "kind": "method",
+              "name": "shouldRenderInline",
+              "return": {
+                "type": {
+                  "text": "boolean"
+                }
+              },
+              "description": "Check if workspace should be rendered inline (side-by-side with messages)."
+            },
+            {
+              "kind": "method",
+              "name": "shouldRenderPanel",
+              "return": {
+                "type": {
+                  "text": "boolean"
+                }
+              },
+              "description": "Check if workspace should be rendered as a panel (overlay)."
+            },
+            {
+              "kind": "method",
+              "name": "observeHostWidth",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "setupWindowResizeListener",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "createHostResizeObserver",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "reconnectHostResizeObserver",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "performInitialHostMeasurement",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "handleHostResize",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "inlineSize",
+                  "type": {
+                    "text": "number"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "updateWorkspaceInPanelState",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "inlineSize",
+                  "type": {
+                    "text": "number"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "getLayoutDimensions",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "{\n    workspaceMinWidth: number;\n    messagesMinWidth: number;\n    historyWidth: number;\n  }"
+                }
+              },
+              "description": "Get layout dimensions from cache or compute if not available.\nUses cached CSS values for performance, falling back to live computation."
+            },
+            {
+              "kind": "method",
+              "name": "handleShowWorkspaceEnabled",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "initializeImmediateDisplay",
+              "privacy": "private",
               "return": {
                 "type": {
                   "text": "void"
@@ -3243,67 +3859,119 @@
               },
               "parameters": [
                 {
-                  "name": "newConfig",
+                  "name": "mode",
                   "type": {
-                    "text": "Partial<WorkspaceConfig>"
+                    "text": "\"container\" | \"panel\""
+                  }
+                },
+                {
+                  "name": "inlineSize",
+                  "type": {
+                    "text": "number"
                   }
                 }
-              ],
-              "description": "Update workspace configuration.\nHandles transitions when workspace visibility or related settings change."
+              ]
             },
             {
               "kind": "method",
-              "name": "getState",
+              "name": "initializeExpansionTracking",
+              "privacy": "private",
               "return": {
                 "type": {
-                  "text": "Readonly<WorkspaceState>"
+                  "text": "void"
                 }
-              },
-              "description": "Get current workspace state.\nReturns a readonly copy to prevent external mutations."
+              }
             },
             {
               "kind": "method",
-              "name": "shouldRenderInline",
+              "name": "handleShowWorkspaceDisabled",
+              "privacy": "private",
               "return": {
                 "type": {
-                  "text": "boolean"
+                  "text": "void"
                 }
-              },
-              "description": "Check if workspace should be rendered inline (side-by-side with messages)."
+              }
             },
             {
               "kind": "method",
-              "name": "shouldRenderPanel",
+              "name": "startExpansionPolling",
+              "privacy": "private",
               "return": {
                 "type": {
-                  "text": "boolean"
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "checkExpansionProgress",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
                 }
               },
-              "description": "Check if workspace should be rendered as a panel (overlay)."
+              "parameters": [
+                {
+                  "name": "initialWidth",
+                  "type": {
+                    "text": "number"
+                  }
+                },
+                {
+                  "name": "hasSetContainerMode",
+                  "type": {
+                    "text": "{ value: boolean }"
+                  }
+                }
+              ],
+              "description": "Check expansion progress and determine if transition is complete."
             },
             {
               "kind": "method",
-              "name": "observeHostWidth",
+              "name": "handleOngoingExpansion",
               "privacy": "private",
               "return": {
                 "type": {
                   "text": "void"
                 }
-              }
+              },
+              "parameters": [
+                {
+                  "name": "currentWidth",
+                  "type": {
+                    "text": "number"
+                  }
+                },
+                {
+                  "name": "initialWidth",
+                  "type": {
+                    "text": "number"
+                  }
+                },
+                {
+                  "name": "hasSetContainerMode",
+                  "type": {
+                    "text": "{ value: boolean }"
+                  }
+                }
+              ],
+              "description": "Handle ongoing width changes during expansion."
             },
             {
               "kind": "method",
-              "name": "setupWindowResizeListener",
+              "name": "setWorkspaceInContainerMode",
               "privacy": "private",
               "return": {
                 "type": {
                   "text": "void"
                 }
-              }
+              },
+              "description": "Set workspace to container mode by updating DOM attributes."
             },
             {
               "kind": "method",
-              "name": "createHostResizeObserver",
+              "name": "setupContractionTracking",
               "privacy": "private",
               "return": {
                 "type": {
@@ -3313,7 +3981,7 @@
             },
             {
               "kind": "method",
-              "name": "reconnectHostResizeObserver",
+              "name": "initializeImmediateClosing",
               "privacy": "private",
               "return": {
                 "type": {
@@ -3323,7 +3991,7 @@
             },
             {
               "kind": "method",
-              "name": "performInitialHostMeasurement",
+              "name": "startContractionPolling",
               "privacy": "private",
               "return": {
                 "type": {
@@ -3333,7 +4001,7 @@
             },
             {
               "kind": "method",
-              "name": "handleHostResize",
+              "name": "checkContractionProgress",
               "privacy": "private",
               "return": {
                 "type": {
@@ -3342,16 +4010,22 @@
               },
               "parameters": [
                 {
-                  "name": "inlineSize",
+                  "name": "initialWidth",
                   "type": {
                     "text": "number"
                   }
+                },
+                {
+                  "name": "hasSetContractingMode",
+                  "type": {
+                    "text": "{ value: boolean }"
+                  }
                 }
               ]
             },
             {
               "kind": "method",
-              "name": "updateWorkspaceInPanelState",
+              "name": "handleOngoingContraction",
               "privacy": "private",
               "return": {
                 "type": {
@@ -3360,36 +4034,46 @@
               },
               "parameters": [
                 {
-                  "name": "inlineSize",
+                  "name": "currentWidth",
+                  "type": {
+                    "text": "number"
+                  }
+                },
+                {
+                  "name": "initialWidth",
                   "type": {
                     "text": "number"
                   }
+                },
+                {
+                  "name": "hasSetContractingMode",
+                  "type": {
+                    "text": "{ value: boolean }"
+                  }
                 }
               ]
             },
             {
               "kind": "method",
-              "name": "handleShowWorkspaceEnabled",
+              "name": "finishWorkspaceContraction",
               "privacy": "private",
               "return": {
                 "type": {
                   "text": "void"
                 }
-              }
-            },
-            {
-              "kind": "method",
-              "name": "handleShowWorkspaceDisabled",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "void"
+              },
+              "parameters": [
+                {
+                  "name": "sawMovement",
+                  "type": {
+                    "text": "boolean"
+                  }
                 }
-              }
+              ]
             },
             {
               "kind": "method",
-              "name": "startExpansionPolling",
+              "name": "startFinalContractionPolling",
               "privacy": "private",
               "return": {
                 "type": {
@@ -3399,13 +4083,21 @@
             },
             {
               "kind": "method",
-              "name": "startClosingPolling",
+              "name": "trackExpectedContraction",
               "privacy": "private",
               "return": {
                 "type": {
                   "text": "void"
                 }
-              }
+              },
+              "parameters": [
+                {
+                  "name": "inlineSize",
+                  "type": {
+                    "text": "number"
+                  }
+                }
+              ]
             },
             {
               "kind": "method",
@@ -3465,7 +4157,7 @@
             },
             {
               "kind": "method",
-              "name": "clearClosingTimer",
+              "name": "clearContractionTimers",
               "privacy": "private",
               "return": {
                 "type": {
@@ -3473,6 +4165,26 @@
                 }
               }
             },
+            {
+              "kind": "method",
+              "name": "updateWorkspaceAttributes",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "inPanel",
+                  "type": {
+                    "text": "boolean"
+                  },
+                  "description": "True for panel mode, false for container mode"
+                }
+              ],
+              "description": "Updates workspace DOM attributes to match the panel state.\nMaintains inverse relationship between panel and container attributes."
+            },
             {
               "kind": "method",
               "name": "setWorkspaceInPanel",
@@ -3487,9 +4199,11 @@
                   "name": "inPanel",
                   "type": {
                     "text": "boolean"
-                  }
+                  },
+                  "description": "True to display workspace as overlay panel, false for inline"
                 }
-              ]
+              ],
+              "description": "Updates the workspace panel state and corresponding DOM attributes.\n\nSynchronizes internal state with DOM attributes that control whether\nthe workspace is displayed as an overlay panel or inline container.\n\nIgnores calls during expansion/contraction transitions. Only updates if\nstate or attributes need changes. Maintains inverse relationship between\npanel and container attributes."
             },
             {
               "kind": "method",
@@ -3575,48 +4289,6 @@
                 }
               }
             },
-            {
-              "kind": "method",
-              "name": "isWideEnough",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "boolean"
-                }
-              },
-              "parameters": [
-                {
-                  "name": "inlineSize",
-                  "type": {
-                    "text": "number"
-                  }
-                },
-                {
-                  "name": "requiredWidth",
-                  "type": {
-                    "text": "number"
-                  }
-                }
-              ]
-            },
-            {
-              "kind": "method",
-              "name": "canHostGrow",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "boolean"
-                }
-              },
-              "parameters": [
-                {
-                  "name": "requiredWidth",
-                  "type": {
-                    "text": "number"
-                  }
-                }
-              ]
-            },
             {
               "kind": "method",
               "name": "finalizeImmediateDisplay",
@@ -3651,48 +4323,6 @@
                 }
               }
             },
-            {
-              "kind": "method",
-              "name": "getInlineSizeFromEntry",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "number"
-                }
-              },
-              "parameters": [
-                {
-                  "name": "entry",
-                  "type": {
-                    "text": "ResizeObserverEntry"
-                  }
-                }
-              ]
-            },
-            {
-              "kind": "method",
-              "name": "getCssLengthFromProperty",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "number"
-                }
-              },
-              "parameters": [
-                {
-                  "name": "propertyName",
-                  "type": {
-                    "text": "string"
-                  }
-                },
-                {
-                  "name": "fallback",
-                  "type": {
-                    "text": "number"
-                  }
-                }
-              ]
-            },
             {
               "kind": "method",
               "name": "observeCssProperties",
@@ -7463,10 +8093,44 @@
               },
               "privacy": "private"
             },
+            {
+              "kind": "field",
+              "name": "visibilityObserver",
+              "type": {
+                "text": "ResizeObserver | undefined"
+              },
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "OVERFLOW_MENU_LABEL",
+              "type": {
+                "text": "string"
+              },
+              "privacy": "private",
+              "static": true,
+              "readonly": true,
+              "default": "\"Options\""
+            },
             {
               "kind": "method",
               "name": "setupOverflowHandler",
               "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "renderIconButton",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "getOverflowMenuSize",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "OVERFLOW_MENU_SIZE"
+                }
+              }
             }
           ],
           "attributes": [
@@ -7829,12 +8493,7 @@
               "name": "footer"
             }
           ],
-          "members": [
-            {
-              "kind": "field",
-              "name": "closeWorkspaceShell"
-            }
-          ],
+          "members": [],
           "superclass": {
             "name": "LitElement",
             "package": "lit"