feat(terminal): integrated terminal improvements and workspace panel enhancements

CLAUDE.md

@@ -1,6 +1,7 @@
 # Claude Code Instructions
 
 ## Git Commits
+- **Never commit unless the user explicitly asks you to commit or grants autocommit permission.** Only exception: if a commit is technically required for the current task to work (e.g. testing a CI pipeline).
 - Use Conventional Commits format: `type(scope): description` (e.g. `fix: ...`, `feat: ...`, `chore: ...`).
 - Keep commit subject lines concise; use the body for detail.
 - Never include `Co-Authored-By` lines in commit messages.

docs/API-Reference/command/Commands.md

@@ -530,6 +530,12 @@ Toggles code inspection
 ## VIEW\_TOGGLE\_PROBLEMS
 Toggles problems panel visibility
 
+**Kind**: global variable  
+<a name="VIEW_TERMINAL"></a>
+
+## VIEW\_TERMINAL
+Opens the terminal panel
+
 **Kind**: global variable  
 <a name="TOGGLE_LINE_NUMBERS"></a>
 

docs/API-Reference/view/PanelView.md

@@ -14,8 +14,11 @@ const PanelView = brackets.getModule("view/PanelView")
     * [.isVisible()](#Panel+isVisible) ⇒ <code>boolean</code>
     * [.registerCanBeShownHandler(canShowHandlerFn)](#Panel+registerCanBeShownHandler) ⇒ <code>boolean</code>
     * [.canBeShown()](#Panel+canBeShown) ⇒ <code>boolean</code>
+    * [.registerOnCloseRequestedHandler(handler)](#Panel+registerOnCloseRequestedHandler)
+    * [.requestClose()](#Panel+requestClose) ⇒ <code>Promise.&lt;boolean&gt;</code>
     * [.show()](#Panel+show)
     * [.hide()](#Panel+hide)
+    * [.focus()](#Panel+focus) ⇒ <code>boolean</code>
     * [.setVisible(visible)](#Panel+setVisible)
     * [.setTitle(newTitle)](#Panel+setTitle)
     * [.destroy()](#Panel+destroy)
@@ -49,8 +52,7 @@ Determines if the panel is visible
 <a name="Panel+registerCanBeShownHandler"></a>
 
 ### panel.registerCanBeShownHandler(canShowHandlerFn) ⇒ <code>boolean</code>
-Registers a call back function that will be called just before panel is shown. The handler should return true
-if the panel can be shown, else return false and the panel will not be shown.
+Registers a call back function that will be called just before panel is shown. The handler should return trueif the panel can be shown, else return false and the panel will not be shown.
 
 **Kind**: instance method of [<code>Panel</code>](#Panel)  
 **Returns**: <code>boolean</code> - true if visible, false if not  
@@ -65,6 +67,24 @@ if the panel can be shown, else return false and the panel will not be shown.
 Returns true if th panel can be shown, else false.
 
 **Kind**: instance method of [<code>Panel</code>](#Panel)  
+<a name="Panel+registerOnCloseRequestedHandler"></a>
+
+### panel.registerOnCloseRequestedHandler(handler)
+Registers an async handler that is called before the panel is closed via user interaction (e.g. clicking thetab close button). The handler should return `true` to allow the close, or `false` to prevent it.
+
+**Kind**: instance method of [<code>Panel</code>](#Panel)  
+
+| Param | Type | Description |
+| --- | --- | --- |
+| handler | <code>function</code> \| <code>null</code> | An async function returning a boolean, or null to clear the handler. |
+
+<a name="Panel+requestClose"></a>
+
+### panel.requestClose() ⇒ <code>Promise.&lt;boolean&gt;</code>
+Requests the panel to hide, invoking the registered onCloseRequested handler first (if any).If the handler returns false, the panel stays open. If it returns true or no handler isregistered, `hide()` is called.
+
+**Kind**: instance method of [<code>Panel</code>](#Panel)  
+**Returns**: <code>Promise.&lt;boolean&gt;</code> - Resolves to true if the panel was hidden, false if prevented.  
 <a name="Panel+show"></a>
 
 ### panel.show()
@@ -77,6 +97,13 @@ Shows the panel
 Hides the panel
 
 **Kind**: instance method of [<code>Panel</code>](#Panel)  
+<a name="Panel+focus"></a>
+
+### panel.focus() ⇒ <code>boolean</code>
+Attempts to focus the panel. Override this in panels that support focus(e.g. terminal). The default implementation returns false.
+
+**Kind**: instance method of [<code>Panel</code>](#Panel)  
+**Returns**: <code>boolean</code> - true if the panel accepted focus, false otherwise  
 <a name="Panel+setVisible"></a>
 
 ### panel.setVisible(visible)
@@ -102,8 +129,7 @@ Updates the display title shown in the tab bar for this panel.
 <a name="Panel+destroy"></a>
 
 ### panel.destroy()
-Destroys the panel, removing it from the tab bar, internal maps, and the DOM.
-After calling this, the Panel instance should not be reused.
+Destroys the panel, removing it from the tab bar, internal maps, and the DOM.After calling this, the Panel instance should not be reused.
 
 **Kind**: instance method of [<code>Panel</code>](#Panel)  
 <a name="Panel+getPanelType"></a>
@@ -171,6 +197,18 @@ The editor holder element, passed from WorkspaceManager
 ## \_recomputeLayout : <code>function</code>
 recomputeLayout callback from WorkspaceManager
 
+**Kind**: global variable  
+<a name="_defaultPanelId"></a>
+
+## \_defaultPanelId : <code>string</code> \| <code>null</code>
+The default/quick-access panel ID
+
+**Kind**: global variable  
+<a name="_$addBtn"></a>
+
+## \_$addBtn : <code>jQueryObject</code>
+The "+" button inside the tab overflow area
+
 **Kind**: global variable  
 <a name="EVENT_PANEL_HIDDEN"></a>
 
@@ -193,24 +231,25 @@ type for bottom panel
 <a name="MAXIMIZE_THRESHOLD"></a>
 
 ## MAXIMIZE\_THRESHOLD : <code>number</code>
-Pixel threshold for detecting near-maximize state during resize.
-If the editor holder height is within this many pixels of zero, the
-panel is treated as maximized. Keeps the maximize icon responsive
-during drag without being overly sensitive.
+Pixel threshold for detecting near-maximize state during resize.If the editor holder height is within this many pixels of zero, thepanel is treated as maximized. Keeps the maximize icon responsiveduring drag without being overly sensitive.
 
 **Kind**: global constant  
 <a name="MIN_PANEL_HEIGHT"></a>
 
 ## MIN\_PANEL\_HEIGHT : <code>number</code>
-Minimum panel height (matches Resizer minSize) used as a floor
-when computing a sensible restore height.
+Minimum panel height (matches Resizer minSize) used as a floorwhen computing a sensible restore height.
+
+**Kind**: global constant  
+<a name="PREF_BOTTOM_PANEL_MAXIMIZED"></a>
+
+## PREF\_BOTTOM\_PANEL\_MAXIMIZED
+Preference key for persisting the maximize state across reloads.
 
 **Kind**: global constant  
 <a name="init"></a>
 
-## init($container, $tabBar, $tabsOverflow, $editorHolder, recomputeLayoutFn)
-Initializes the PanelView module with references to the bottom panel container DOM elements.
-Called by WorkspaceManager during htmlReady.
+## init($container, $tabBar, $tabsOverflow, $editorHolder, recomputeLayoutFn, defaultPanelId)
+Initializes the PanelView module with references to the bottom panel container DOM elements.Called by WorkspaceManager during htmlReady.
 
 **Kind**: global function  
 
@@ -221,30 +260,24 @@ Called by WorkspaceManager during htmlReady.
 | $tabsOverflow | <code>jQueryObject</code> | The scrollable area holding tab elements. |
 | $editorHolder | <code>jQueryObject</code> | The editor holder element (for maximize height calculation). |
 | recomputeLayoutFn | <code>function</code> | Callback to trigger workspace layout recomputation. |
+| defaultPanelId | <code>string</code> | The ID of the default/quick-access panel. |
 
 <a name="exitMaximizeOnResize"></a>
 
 ## exitMaximizeOnResize()
-Exit maximize state without resizing (for external callers like drag-resize).
-Clears internal maximize state and resets the button icon.
+Exit maximize state without resizing (for external callers like drag-resize).Clears internal maximize state and resets the button icon.
 
 **Kind**: global function  
 <a name="enterMaximizeOnResize"></a>
 
 ## enterMaximizeOnResize()
-Enter maximize state during a drag-resize that reaches the maximum
-height. No pre-maximize height is stored because the user arrived
-here via continuous dragging; a sensible default will be computed if
-they later click the Restore button.
+Enter maximize state during a drag-resize that reaches the maximumheight. No pre-maximize height is stored because the user arrivedhere via continuous dragging; a sensible default will be computed ifthey later click the Restore button.
 
 **Kind**: global function  
 <a name="restoreIfMaximized"></a>
 
 ## restoreIfMaximized()
-Restore the container's CSS height to the pre-maximize value and clear maximize state.
-Must be called BEFORE Resizer.hide() so the Resizer reads the correct height.
-If not maximized, this is a no-op.
-When the saved height is near-max or unknown, a sensible default is used.
+Restore the container's CSS height to the pre-maximize value and clear maximize state.Must be called BEFORE Resizer.hide() so the Resizer reads the correct height.If not maximized, this is a no-op.When the saved height is near-max or unknown, a sensible default is used.
 
 **Kind**: global function  
 <a name="isMaximized"></a>
@@ -266,3 +299,16 @@ Hides every open bottom panel tab in a single batch
 
 **Kind**: global function  
 **Returns**: <code>Array.&lt;string&gt;</code> - The IDs of panels that were open (useful for restoring later).  
+<a name="getActiveBottomPanel"></a>
+
+## getActiveBottomPanel() ⇒ [<code>Panel</code>](#Panel) \| <code>null</code>
+Returns the currently active (visible) bottom panel, or null if none.
+
+**Kind**: global function  
+<a name="showNextPanel"></a>
+
+## showNextPanel() ⇒ <code>boolean</code>
+Cycle to the next open bottom panel tab. If the container is hiddenor no panels are open, does nothing and returns false.
+
+**Kind**: global function  
+**Returns**: <code>boolean</code> - true if a panel switch occurred  

docs/API-Reference/view/PluginPanelView.md

@@ -14,6 +14,8 @@ const PluginPanelView = brackets.getModule("view/PluginPanelView")
     * [.isVisible()](#Panel+isVisible) ⇒ <code>boolean</code>
     * [.registerCanBeShownHandler(canShowHandlerFn)](#Panel+registerCanBeShownHandler) ⇒ <code>boolean</code>
     * [.canBeShown()](#Panel+canBeShown) ⇒ <code>boolean</code>
+    * [.registerOnCloseRequestedHandler(handler)](#Panel+registerOnCloseRequestedHandler)
+    * [.requestClose()](#Panel+requestClose) ⇒ <code>Promise.&lt;boolean&gt;</code>
     * [.show()](#Panel+show)
     * [.hide()](#Panel+hide)
     * [.setVisible(visible)](#Panel+setVisible)
@@ -49,8 +51,7 @@ Determines if the panel is visible
 <a name="Panel+registerCanBeShownHandler"></a>
 
 ### panel.registerCanBeShownHandler(canShowHandlerFn) ⇒ <code>boolean</code>
-Registers a call back function that will be called just before panel is shown. The handler should return true
-if the panel can be shown, else return false and the panel will not be shown.
+Registers a call back function that will be called just before panel is shown. The handler should return trueif the panel can be shown, else return false and the panel will not be shown.
 
 **Kind**: instance method of [<code>Panel</code>](#Panel)  
 **Returns**: <code>boolean</code> - true if visible, false if not  
@@ -65,6 +66,24 @@ if the panel can be shown, else return false and the panel will not be shown.
 Returns true if th panel can be shown, else false.
 
 **Kind**: instance method of [<code>Panel</code>](#Panel)  
+<a name="Panel+registerOnCloseRequestedHandler"></a>
+
+### panel.registerOnCloseRequestedHandler(handler)
+Registers an async handler that is called before the panel is closed via user interaction.The handler should return `true` to allow the close, or `false` to prevent it.
+
+**Kind**: instance method of [<code>Panel</code>](#Panel)  
+
+| Param | Type | Description |
+| --- | --- | --- |
+| handler | <code>function</code> \| <code>null</code> | An async function returning a boolean, or null to clear the handler. |
+
+<a name="Panel+requestClose"></a>
+
+### panel.requestClose() ⇒ <code>Promise.&lt;boolean&gt;</code>
+Requests the panel to hide, invoking the registered onCloseRequested handler first (if any).If the handler returns false, the panel stays open. If it returns true or no handler isregistered, `hide()` is called.
+
+**Kind**: instance method of [<code>Panel</code>](#Panel)  
+**Returns**: <code>Promise.&lt;boolean&gt;</code> - Resolves to true if the panel was hidden, false if prevented.  
 <a name="Panel+show"></a>
 
 ### panel.show()