feat(php): find-bar-style install prompt with benefits tooltip

Replace the install prompt toast with a ModalBar banner across the top of
the editor - the same surface as the find bar, impossible to miss on the
very file that triggered it, yet passive (autoClose off: clicking back
into the code doesn't dismiss it).

- Terse copy: "Install advanced PHP code intelligence?" followed by an
  (i) icon whose hover shows a compact benefits card (the reusable rich
  tooltip): Completions / Docs on hover / Error checking / Navigation,
  one plain line each. Right side: "Powered by Intelephense" link,
  Not Now, and a primary Install button.
- Reappears on every PHP file switch in the project until explicitly
  dismissed via Not Now (session-scoped per project); switching away just
  closes it for that moment. The Problems-panel row stays as the quiet
  persistent affordance, and php.codeIntelligence remains the durable
  off-switch. Install click closes the bar and hands off to the existing
  TaskManager install task + auto-start.

Verified live: fresh consent -> bar -> Install -> server up; re-show on
file switch; benefits tooltip; bar closes on non-php files.

Author: abose

src/extensions/default/PHPSupport/ServerInstaller.js

@@ -47,6 +47,7 @@ define(function (require, exports, module) {
     const NodeUtils = brackets.getModule("utils/NodeUtils"),
         ProjectManager = brackets.getModule("project/ProjectManager"),
         NativeApp = brackets.getModule("utils/NativeApp"),
+        ModalBar = brackets.getModule("widgets/ModalBar").ModalBar,
         NotificationUI = brackets.getModule("widgets/NotificationUI"),
         TaskManager = brackets.getModule("features/TaskManager"),
         PreferencesManager = brackets.getModule("preferences/PreferencesManager"),
@@ -60,8 +61,12 @@ define(function (require, exports, module) {
 
     let _onInstalled = null;        // main.js callback: ({entryPath, upgraded}) => void
     let _inFlight = null;           // single-flight install promise
-    const _promptShownForProject = new Set();   // prompt toast: once per project per session
-    let _promptToast = null;
+    // projects where the user clicked "Not Now" - the bar stops reappearing there for the
+    // session. Until then it returns on every php file switch (closing on switch-away is not a
+    // dismissal - only the explicit button is).
+    const _promptDismissedForProject = new Set();
+    let _promptBar = null;          // the ModalBar install prompt, when showing
+    let _promptBarTip = null;       // the benefits tooltip binding on the bar's info icon
     let _panelRowDismissed = false; // Problems-panel row dismissed this session
 
     function _installDirVfs() {
@@ -202,49 +207,71 @@ define(function (require, exports, module) {
 
     // ----- consent UI: prompt toast + Problems-panel row (mirrors the TS enable affordances) ------
 
-    function _dismissPromptToast() {
-        if (_promptToast) {
-            _promptToast.close();
-            _promptToast = null;
+    function _closePromptBar() {
+        if (_promptBarTip) {
+            _promptBarTip.detach();
+            _promptBarTip = null;
+        }
+        if (_promptBar) {
+            _promptBar.close();
+            _promptBar = null;
         }
     }
 
-    function _showPromptToast() {
+    // Compact benefits card for the bar's (i) icon - term -> what it means, one line each.
+    function _benefitsTipHtml() {
+        const $tip = $("<div>");
+        $("<div class='ph-tip-title'>").text(Strings.PHP_INSTALL_TITLE).appendTo($tip);
+        const $rows = $("<div class='ph-tip-rows'>").appendTo($tip);
+        [
+            [Strings.PHP_BENEFIT_COMPLETIONS, Strings.PHP_BENEFIT_COMPLETIONS_SUB],
+            [Strings.PHP_BENEFIT_DOCS, Strings.PHP_BENEFIT_DOCS_SUB],
+            [Strings.PHP_BENEFIT_ERRORS, Strings.PHP_BENEFIT_ERRORS_SUB],
+            [Strings.PHP_BENEFIT_NAV, Strings.PHP_BENEFIT_NAV_SUB]
+        ].forEach(function (row) {
+            $("<span class='ph-tip-term'>").text(row[0]).appendTo($rows);
+            $("<span class='ph-tip-def'>").text(row[1]).appendTo($rows);
+        });
+        return $tip.html();
+    }
+
+    // A find-bar-style banner across the top of the editor - impossible to miss on the file that
+    // triggered it, but passive (autoClose false: clicking back into the code doesn't dismiss it).
+    function _showPromptBar() {
         const root = ProjectManager.getProjectRoot();
         const rootPath = (root && root.fullPath) || "";
-        if (_promptShownForProject.has(rootPath)) {
+        if (_promptDismissedForProject.has(rootPath) || _promptBar) {
             return;
         }
-        _promptShownForProject.add(rootPath);
-        const $tpl = $("<div class='ts-code-intel-toast'>");
-        $("<div class='ts-code-intel-msg'>").text(Strings.PHP_INSTALL_MESSAGE).appendTo($tpl);
+        // built as detached DOM then serialized (ModalBar takes an HTML string); all click
+        // handling is delegated on the live bar root below
+        const $tpl = $("<div class='php-install-bar'>");
+        $("<span class='php-install-bar-text'>").text(Strings.PHP_INSTALL_MESSAGE).appendTo($tpl);
+        $("<i class='fa-solid fa-circle-info php-install-bar-info'>").appendTo($tpl);
         // credit where due (and where premium lives) - not license-required, just right
-        $("<a class='php-intel-powered-by'>").text(Strings.PHP_POWERED_BY_INTELEPHENSE)
-            .attr("href", "#")
-            .on("click", function (e) {
-                e.preventDefault();
-                e.stopPropagation();
-                NativeApp.openURLInDefaultBrowser(INTELEPHENSE_HOME_URL);
-            })
+        $("<a class='php-intel-powered-by' href='#'>").text(Strings.PHP_POWERED_BY_INTELEPHENSE)
             .appendTo($tpl);
-        const $btns = $("<div class='ts-code-intel-buttons'>").appendTo($tpl);
-        const $install = $("<button class='ts-code-intel-action'>")
-            .text(Strings.PHP_INSTALL_ENABLE).appendTo($btns);
-        const $later = $("<button class='ts-code-intel-action'>")
-            .text(Strings.PHP_INSTALL_NOT_NOW).appendTo($btns);
-        // SUBTLE like the TS enable toast - quiet, theme-matching surface where the link-style
-        // action buttons read clearly. The Problems-panel row provides the persistent affordance
-        // if the toast is missed.
-        _promptToast = NotificationUI.createToastFromTemplate(Strings.PHP_INSTALL_TITLE, $tpl, {
-            dismissOnClick: false, autoCloseTimeS: 45, instantOpen: true,
-            toastStyle: NotificationUI.NOTIFICATION_STYLES_CSS_CLASS.SUBTLE
-        });
-        $install.on("click", function () {
-            _dismissPromptToast();
+        $("<button class='btn btn-mini php-install-bar-later'>")
+            .text(Strings.PHP_INSTALL_NOT_NOW).appendTo($tpl);
+        $("<button class='btn btn-mini primary php-install-bar-install'>")
+            .text(Strings.PHP_INSTALL_ENABLE).appendTo($tpl);
+
+        _promptBar = new ModalBar($tpl[0].outerHTML, false);
+        const $bar = _promptBar.getRoot();
+        _promptBarTip = NotificationUI.attachRichTooltip(
+            $bar.find(".php-install-bar-info"), _benefitsTipHtml(), { showDelayMs: 150 });
+        $bar.on("click", ".php-install-bar-install", function () {
+            _closePromptBar();
             installNow();
         });
-        $later.on("click", function () {
-            _dismissPromptToast();
+        $bar.on("click", ".php-install-bar-later", function () {
+            const projRoot = ProjectManager.getProjectRoot();
+            _promptDismissedForProject.add((projRoot && projRoot.fullPath) || "");
+            _closePromptBar();
+        });
+        $bar.on("click", ".php-intel-powered-by", function (e) {
+            e.preventDefault();
+            NativeApp.openURLInDefaultBrowser(INTELEPHENSE_HOME_URL);
         });
     }
 
@@ -300,6 +327,9 @@ define(function (require, exports, module) {
         if (!$row) {
             return;
         }
+        if (!phpDocumentActive) {
+            _closePromptBar();  // the bar belongs to the php file that triggered it
+        }
         if (!phpDocumentActive || _panelRowDismissed || _inFlight ||
                 PreferencesManager.get(PREF_PHP_CODE_INTELLIGENCE) === false) {
             $row.hide();
@@ -323,7 +353,9 @@ define(function (require, exports, module) {
         if (typeof Phoenix !== "undefined" && Phoenix.isTestWindow) {
             return;
         }
-        _showPromptToast();
+        if (phpDocumentActive) {
+            _showPromptBar();
+        }
         updatePanelRow(phpDocumentActive);
     }
 

src/nls/root/strings.js

@@ -1802,10 +1802,18 @@ define({
     "CODE_INTEL_PANEL_DISMISS": "Dismiss",
     // PHP language support (PHPSupport)
     "PHP_INSTALL_TITLE": "PHP Code Intelligence",
-    "PHP_INSTALL_MESSAGE": "Smart completions, docs on hover, error checking and go to definition for PHP. {APP_NAME} downloads the Intelephense language server (free third-party tool, ~9 MB) to your computer.",
+    "PHP_INSTALL_MESSAGE": "Install advanced PHP code intelligence?",
     "PHP_INSTALL_ENABLE": "Install",
     "PHP_INSTALL_NOT_NOW": "Not Now",
     "PHP_POWERED_BY_INTELEPHENSE": "Powered by Intelephense",
+    "PHP_BENEFIT_COMPLETIONS": "Completions",
+    "PHP_BENEFIT_COMPLETIONS_SUB": "smart suggestions as you type",
+    "PHP_BENEFIT_DOCS": "Docs on hover",
+    "PHP_BENEFIT_DOCS_SUB": "function help right in the editor",
+    "PHP_BENEFIT_ERRORS": "Error checking",
+    "PHP_BENEFIT_ERRORS_SUB": "mistakes flagged as you code",
+    "PHP_BENEFIT_NAV": "Navigation",
+    "PHP_BENEFIT_NAV_SUB": "go to definition and find usages",
     "PHP_PANEL_TEXT": "PHP code intelligence is off. Install the Intelephense language server (free, ~9 MB download) for completions, error checking, docs and go to definition.",
     "PHP_INSTALLING": "Setting up PHP support — downloading the language server…",
     "PHP_INSTALL_DONE": "PHP code intelligence is ready.",

src/styles/brackets.less

@@ -2220,6 +2220,38 @@ a, img {
     }
 }
 
+// PHP install prompt bar (PHPSupport) - find-bar-style banner across the editor top.
+.modal-bar .php-install-bar {
+    display: flex;
+    align-items: center;
+    gap: 12px;
+    .php-install-bar-text {
+        flex: none;      // hug the question so the (i) sits right after it
+        min-width: 0;
+        overflow: hidden;
+        text-overflow: ellipsis;
+        white-space: nowrap;
+    }
+    // sits right after the question; margin-right:auto pushes everything else to the right edge
+    .php-install-bar-info {
+        flex: none;
+        margin-left: -4px;
+        margin-right: auto;
+        opacity: 0.5;
+        cursor: default;
+        &:hover { opacity: 0.9; }
+    }
+    .php-intel-powered-by {
+        flex: none;
+        cursor: pointer;
+        white-space: nowrap;
+    }
+    button {
+        flex: none;
+        margin: 0;
+    }
+}
+
 // On bright colored toast surfaces (e.g. the PHP install prompt on INFO blue) the link-blue
 // action text is invisible - use high-contrast white bold links there, both themes.
 .notification-popup-container.style-info .ts-code-intel-action,