xtralab 0.13.0 → 0.14.0

package/lib/omnibox/model.js

@@ -51,11 +51,11 @@ export function computeSections(options) {
  * Run a command and record the use on success, so failed commands never enter
  * the recents list.
  */
-function executeCommand(commands, recents, id) {
+function executeCommand(commands, recents, id, args) {
     void commands
-        .execute(id)
+        .execute(id, args)
         .then(() => {
-        recents === null || recents === void 0 ? void 0 : recents.touch('command', id);
+        recents === null || recents === void 0 ? void 0 : recents.touch('command', id, args);
     })
         .catch(reason => {
         console.error(`xtralab omnibox: command "${id}" failed`, reason);
@@ -80,16 +80,16 @@ function openFile(commands, recents, path) {
  * accessors can assume a context — e.g. an active notebook — the omnibox
  * doesn't provide).
  */
-function commandDisplay(commands, id) {
+function commandDisplay(commands, id, args) {
     if (!commands.hasCommand(id)) {
         return null;
     }
     try {
-        const label = commands.label(id);
-        if (!label || !commands.isVisible(id)) {
+        const label = commands.label(id, args);
+        if (!label || !commands.isVisible(id, args)) {
             return null;
         }
-        return { label, caption: commands.caption(id) };
+        return { label, caption: commands.caption(id, args) };
     }
     catch (_a) {
         return null;
@@ -103,6 +103,7 @@ function commandDisplay(commands, id) {
  * unavailable — file entries are shown as recorded).
  */
 function buildRecentItems(options, mode) {
+    var _a;
     const { commands, docRegistry, files, recents } = options;
     if (!recents) {
         return [];
@@ -112,18 +113,18 @@ function buildRecentItems(options, mode) {
     const items = [];
     for (const entry of recents.entries(kind)) {
         if (entry.kind === 'command') {
-            const display = commandDisplay(commands, entry.id);
+            const display = commandDisplay(commands, entry.id, entry.args);
             if (!display) {
                 continue;
             }
             items.push({
                 kind: 'command',
-                key: `recent:command:${entry.id}`,
+                key: `recent:command:${entry.id}:${JSON.stringify((_a = entry.args) !== null && _a !== void 0 ? _a : null)}`,
                 label: display.label,
                 matchIndices: [],
                 caption: display.caption || undefined,
                 execute: () => {
-                    executeCommand(commands, recents, entry.id);
+                    executeCommand(commands, recents, entry.id, entry.args);
                 }
             });
         }
@@ -145,11 +146,65 @@ function buildRecentItems(options, mode) {
     }
     return items;
 }
+/**
+ * Match the query against the palette's items first — their labels carry each
+ * item's args (one "Use Theme: …" per theme, one row per font-size key), which
+ * a raw registry scan can never produce — then against registry commands the
+ * palette doesn't present. Palette-covered ids are skipped in the registry
+ * pass so a command never also surfaces under its argless label.
+ */
 function matchCommands(options, term) {
-    const { commands, recents } = options;
+    const { commands, paletteItems, recents } = options;
     const query = term.toLowerCase();
     const scored = [];
+    const inPalette = new Set();
+    const seenKeys = new Set();
+    for (const item of paletteItems) {
+        inPalette.add(item.command);
+        const { command: id, args } = item;
+        let label = '';
+        let visible = true;
+        let caption = '';
+        try {
+            // An item's accessors can throw if the command assumes a context (e.g.
+            // an active notebook) the omnibox doesn't provide; skip those.
+            label = item.label;
+            visible = item.isVisible;
+            caption = item.caption;
+        }
+        catch (_a) {
+            continue;
+        }
+        if (!label || !visible) {
+            continue;
+        }
+        const key = `command:${id}:${JSON.stringify(args)}`;
+        if (seenKeys.has(key)) {
+            continue;
+        }
+        seenKeys.add(key);
+        const match = StringExt.matchSumOfSquares(label.toLowerCase(), query);
+        if (!match) {
+            continue;
+        }
+        scored.push({
+            score: match.score,
+            item: {
+                kind: 'command',
+                key,
+                label,
+                matchIndices: match.indices,
+                caption: caption || undefined,
+                execute: () => {
+                    executeCommand(commands, recents, id, args);
+                }
+            }
+        });
+    }
     for (const id of commands.listCommands()) {
+        if (inPalette.has(id)) {
+            continue;
+        }
         let label = '';
         let visible = true;
         let caption = '';
@@ -160,7 +215,7 @@ function matchCommands(options, term) {
             visible = commands.isVisible(id);
             caption = commands.caption(id);
         }
-        catch (_a) {
+        catch (_b) {
             continue;
         }
         if (!label || !visible) {

package/lib/omnibox/recents.d.ts

@@ -1,4 +1,5 @@
 import type { IStateDB } from '@jupyterlab/statedb';
+import type { ReadonlyPartialJSONObject } from '@lumino/coreutils';
 /**
  * Kinds of omnibox results whose uses are recorded.
  */
@@ -12,6 +13,11 @@ interface IRecentEntry {
      * The command id, or the workspace-relative file path.
      */
     id: string;
+    /**
+     * Arguments the command ran with, for palette-style entries whose label
+     * and behavior depend on them (e.g. one "Use Theme: …" per theme).
+     */
+    args?: ReadonlyPartialJSONObject;
 }
 /**
  * A most-recently-used list of omnibox results, generic over the result kind
@@ -34,9 +40,10 @@ export declare class OmniboxRecents {
      */
     entries(kind?: RecentKind): IRecentEntry[];
     /**
-     * Record a use of `id`, moving it to the front of its kind's list.
+     * Record a use of `id` (with the args it ran with, if any), moving it to
+     * the front of its kind's list.
      */
-    touch(kind: RecentKind, id: string): void;
+    touch(kind: RecentKind, id: string, args?: ReadonlyPartialJSONObject): void;
     /**
      * Load the persisted list. Entries recorded before the load completes stay
      * at the front, ahead of the restored history.

package/lib/omnibox/recents.js

@@ -1,3 +1,11 @@
+/**
+ * Identity of an entry: two uses only match when kind, id and args all do,
+ * so runs of one command with different args stay distinct entries.
+ */
+function entryKey(entry) {
+    var _a;
+    return `${entry.kind}\0${entry.id}\0${JSON.stringify((_a = entry.args) !== null && _a !== void 0 ? _a : null)}`;
+}
 /**
  * State database key the recents list is persisted under.
  */
@@ -45,11 +53,14 @@ export class OmniboxRecents {
             : [...this._entries];
     }
     /**
-     * Record a use of `id`, moving it to the front of its kind's list.
+     * Record a use of `id` (with the args it ran with, if any), moving it to
+     * the front of its kind's list.
      */
-    touch(kind, id) {
-        const rest = this._entries.filter(entry => !(entry.kind === kind && entry.id === id));
-        this._entries = this._trim([{ kind, id }, ...rest]);
+    touch(kind, id, args) {
+        const entry = args === undefined ? { kind, id } : { kind, id, args };
+        const key = entryKey(entry);
+        const rest = this._entries.filter(existing => entryKey(existing) !== key);
+        this._entries = this._trim([entry, ...rest]);
         this._save();
     }
     /**
@@ -68,16 +79,31 @@ export class OmniboxRecents {
             return;
         }
         const persisted = Array.isArray(fetched)
-            ? fetched.filter((entry) => !!entry &&
-                typeof entry === 'object' &&
-                (entry.kind === 'command' ||
-                    entry.kind === 'file') &&
-                typeof entry.id === 'string')
+            ? fetched.filter((entry) => {
+                if (!entry || typeof entry !== 'object') {
+                    return false;
+                }
+                const candidate = entry;
+                if (candidate.kind !== 'command' && candidate.kind !== 'file') {
+                    return false;
+                }
+                if (typeof candidate.id !== 'string') {
+                    return false;
+                }
+                const args = candidate.args;
+                return (args === undefined ||
+                    (typeof args === 'object' && args !== null && !Array.isArray(args)));
+            })
             : [];
+        const known = new Set(this._entries.map(entryKey));
         const merged = [...this._entries];
         for (const entry of persisted) {
-            if (!merged.some(existing => existing.kind === entry.kind && existing.id === entry.id)) {
-                merged.push({ kind: entry.kind, id: entry.id });
+            const key = entryKey(entry);
+            if (!known.has(key)) {
+                known.add(key);
+                merged.push(entry.args === undefined
+                    ? { kind: entry.kind, id: entry.id }
+                    : { kind: entry.kind, id: entry.id, args: entry.args });
             }
         }
         this._entries = this._trim(merged);
@@ -98,10 +124,9 @@ export class OmniboxRecents {
         if (!this._state) {
             return;
         }
-        const value = this._entries.map(entry => ({
-            kind: entry.kind,
-            id: entry.id
-        }));
+        const value = this._entries.map(entry => entry.args === undefined
+            ? { kind: entry.kind, id: entry.id }
+            : { kind: entry.kind, id: entry.id, args: entry.args });
         this._state.save(STATE_KEY, value).catch(reason => {
             console.error('xtralab omnibox: failed to save recents', reason);
         });

package/lib/omnibox/widget.d.ts

@@ -2,6 +2,7 @@ import type { DocumentRegistry } from '@jupyterlab/docregistry';
 import type { TranslationBundle } from '@jupyterlab/translation';
 import { ReactWidget } from '@jupyterlab/ui-components';
 import type { CommandRegistry } from '@lumino/commands';
+import type { CommandPalette } from '@lumino/widgets';
 import type { IAgent } from '../launcher/agents';
 import type { OmniboxRecents } from './recents';
 /**
@@ -24,6 +25,11 @@ export declare namespace OmniboxWidget {
      */
     interface IOptions {
         commands: CommandRegistry;
+        /**
+         * Snapshot of the command palette's items, read once when the overlay
+         * opens; empty when the palette isn't available.
+         */
+        paletteItems: ReadonlyArray<CommandPalette.IItem>;
         docRegistry: DocumentRegistry;
         /**
          * Snapshot of the available agents, read once when the overlay opens.

package/lib/omnibox/widget.js

@@ -39,7 +39,7 @@ function renderIcon(icon) {
     return icon ? (React.createElement(icon.react, { tag: "span", className: "jp-xtralab-Omnibox-itemIcon" })) : (React.createElement("span", { className: "jp-xtralab-Omnibox-itemIcon" }));
 }
 function OmniboxComponent(props) {
-    const { commands, docRegistry, agents, placeholder, initialQuery, recents, trans, onClose } = props;
+    const { commands, paletteItems, docRegistry, agents, placeholder, initialQuery, recents, trans, onClose } = props;
     const [query, setQuery] = React.useState(initialQuery);
     const [files, setFiles] = React.useState([]);
     const [active, setActive] = React.useState(0);
@@ -63,12 +63,13 @@ function OmniboxComponent(props) {
     const sections = React.useMemo(() => computeSections({
         query,
         commands,
+        paletteItems,
         docRegistry,
         agents,
         files,
         recents,
         trans
-    }), [query, commands, docRegistry, agents, files, recents, trans]);
+    }), [query, commands, paletteItems, docRegistry, agents, files, recents, trans]);
     const flat = React.useMemo(() => [
         ...sections.recent,
         ...sections.commands,

package/logo.svg

@@ -0,0 +1,63 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="-5 -3 194 272" role="img" aria-labelledby="jp-xtralab-logo-title jp-xtralab-logo-desc">
+  <title id="jp-xtralab-logo-title">XtraLab flask icon</title>
+  <desc id="jp-xtralab-logo-desc">A clean, slightly tilted laboratory flask with a symmetrical constant-width dark frame, blue-to-pink liquid, bubbles, and rising pixel blocks.</desc>
+
+  <defs>
+    <linearGradient id="jp-xtralab-logo-liquid" x1="20" y1="154" x2="151" y2="231" gradientUnits="userSpaceOnUse">
+      <stop offset="0" stop-color="#00a6ed"/>
+      <stop offset=".29" stop-color="#0879ed"/>
+      <stop offset=".58" stop-color="#6548d2"/>
+      <stop offset=".8" stop-color="#b43baa"/>
+      <stop offset="1" stop-color="#f1357e"/>
+    </linearGradient>
+    <radialGradient id="jp-xtralab-logo-liquid-glow" cx="0" cy="0" r="1"
+                    gradientTransform="translate(49 169) rotate(34) scale(75 49)"
+                    gradientUnits="userSpaceOnUse">
+      <stop stop-color="#18b9ef" stop-opacity=".78"/>
+      <stop offset=".58" stop-color="#1688ef" stop-opacity=".2"/>
+      <stop offset="1" stop-color="#1688ef" stop-opacity="0"/>
+    </radialGradient>
+    <linearGradient id="jp-xtralab-logo-pixel-blue" x1="137" y1="13" x2="156" y2="32" gradientUnits="userSpaceOnUse">
+      <stop stop-color="#05aae9"/>
+      <stop offset="1" stop-color="#008be0"/>
+    </linearGradient>
+    <linearGradient id="jp-xtralab-logo-pixel-purple" x1="154" y1="39" x2="178" y2="61" gradientUnits="userSpaceOnUse">
+      <stop stop-color="#6242c0"/>
+      <stop offset="1" stop-color="#923ba8"/>
+    </linearGradient>
+    <linearGradient id="jp-xtralab-logo-pixel-pink" x1="166" y1="0" x2="183" y2="17" gradientUnits="userSpaceOnUse">
+      <stop stop-color="#8040bd"/>
+      <stop offset="1" stop-color="#ad3c9b"/>
+    </linearGradient>
+    <clipPath id="jp-xtralab-logo-chamber" clipPathUnits="userSpaceOnUse">
+      <path d="M64 61h36v43c0 10 2 18 8 27l42 73c5 8 5 18 0 26-5 8-13 12-23 13H37c-10-1-18-5-23-13-5-8-5-18 0-26l42-73c6-9 8-17 8-27Z"/>
+    </clipPath>
+  </defs>
+
+  <!-- The flask is constructed symmetrically around x=82, then given a slight logo-matching tilt. -->
+  <g transform="rotate(9 82 232)">
+    <g clip-path="url(#jp-xtralab-logo-chamber)">
+      <path fill="url(#jp-xtralab-logo-liquid)"
+            d="M8 207c17-25 34-52 55-60 16-6 29-2 42 5 14 8 27 8 43-4l13 65c4 18-8 35-27 37H30c-20-2-30-23-22-43Z"/>
+      <path fill="url(#jp-xtralab-logo-liquid-glow)"
+            d="M8 207c17-25 34-52 55-60 16-6 29-2 42 5 14 8 27 8 43-4l13 65c4 18-8 35-27 37H30c-20-2-30-23-22-43Z"/>
+    </g>
+
+    <!-- A straight integrated mouth joins the widened chimney without a separate rim element. -->
+    <path d="M56 55v49c0 12-2 21-8 31L9 201c-7 10-7 23-1 33s16 15 28 16h92c12-1 22-6 28-16s6-23-1-33l-39-66c-6-10-8-19-8-31V55H56Z"
+          fill="none" stroke="#07111d" stroke-width="16" stroke-linejoin="round" stroke-linecap="round"/>
+    <path d="M56 55v49c0 12-2 21-8 31L9 201c-7 10-7 23-1 33s16 15 28 16h92c12-1 22-6 28-16s6-23-1-33l-39-66c-6-10-8-19-8-31V55H56Z"
+          fill="none" stroke="#263b57" stroke-width="12" stroke-linejoin="round" stroke-linecap="round"/>
+
+    <circle cx="82" cy="80" r="4.7" fill="#009fe9" stroke="#0b1d35" stroke-width=".7"/>
+    <circle cx="82" cy="104" r="6.2" fill="#078ae9" stroke="#0b1d35" stroke-width=".7"/>
+    <circle cx="82" cy="128" r="7.2" fill="#3256d9" stroke="#0b1d35" stroke-width=".7"/>
+  </g>
+
+  <g stroke="#17233c" stroke-width=".75">
+    <rect x="116" y="22" width="13" height="13" rx="2" fill="#7342bd"/>
+    <rect x="137" y="13" width="19" height="19" rx="1.5" fill="url(#jp-xtralab-logo-pixel-blue)"/>
+    <rect x="154" y="39" width="24" height="22" rx="1.5" fill="url(#jp-xtralab-logo-pixel-purple)"/>
+    <rect x="166" y=".5" width="17" height="17" rx="1.5" fill="url(#jp-xtralab-logo-pixel-pink)"/>
+  </g>
+</svg>

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "xtralab",
-    "version": "0.13.0",
+    "version": "0.14.0",
     "description": "An opinionated JupyterLab meta-package that bundles a curated set of extensions, ships a path-first file browser, renders jupyterlab-git's text, notebook and image diffs with its own viewers, and applies a quieter default workspace configuration.",
     "keywords": [
         "jupyter",
@@ -21,7 +21,8 @@
         "lib/**/*.{d.ts,eot,gif,html,jpg,js,js.map,json,png,svg,woff2,ttf}",
         "style/**/*.{css,js,eot,gif,html,jpg,json,png,svg,woff2,ttf}",
         "src/**/*.{ts,tsx}",
-        "schema/*.json"
+        "schema/*.json",
+        "logo.svg"
     ],
     "main": "lib/index.js",
     "types": "lib/index.d.ts",
@@ -141,6 +142,7 @@
             "@jupyterlab/git:notebook-diff",
             "@jupyterlab/git:plain-text-diff",
             "@jupyterlab/git:image-diff",
+            "@jupyterlab/help-extension:about",
             "@jupyterlab/launcher-extension"
         ]
     },

package/schema/about.json

@@ -0,0 +1,24 @@
+{
+  "jupyter.lab.menus": {
+    "main": [
+      {
+        "id": "jp-mainmenu-help",
+        "items": [
+          {
+            "command": "help:about",
+            "rank": 0
+          },
+          {
+            "type": "separator",
+            "rank": 0
+          }
+        ]
+      }
+    ]
+  },
+  "title": "xtralab About",
+  "description": "The About dialog showing the running xtralab and JupyterLab versions.",
+  "type": "object",
+  "properties": {},
+  "additionalProperties": false
+}

package/src/about/icons.ts

@@ -0,0 +1,13 @@
+import { LabIcon } from '@jupyterlab/ui-components';
+
+import logoSvgstr from '../../logo.svg';
+
+/**
+ * The project logo mark — `logo.svg` at the repository root, the same file
+ * the README and the docs site use. The labextension build inlines it as a
+ * raw string, so the dialog always shows the current artwork.
+ */
+export const aboutLogoIcon = new LabIcon({
+  name: 'xtralab:about-logo',
+  svgstr: logoSvgstr
+});

package/src/about/index.tsx

@@ -0,0 +1,125 @@
+import {
+  JupyterFrontEnd,
+  JupyterFrontEndPlugin
+} from '@jupyterlab/application';
+import { Dialog, ICommandPalette, showDialog } from '@jupyterlab/apputils';
+import { ISettingRegistry } from '@jupyterlab/settingregistry';
+import { ITranslator, nullTranslator } from '@jupyterlab/translation';
+import * as React from 'react';
+
+import { aboutLogoIcon } from './icons';
+
+const PLUGIN_ID = 'xtralab:about';
+
+/**
+ * Upstream command id. Reusing it keeps the Help menu entry (contributed by
+ * `schema/about.json` at the same rank as upstream), the command palette
+ * muscle memory, and any external caller of `help:about` working.
+ */
+const CommandIDs = {
+  about: 'help:about'
+};
+
+const REPO_URL = 'https://github.com/jtpio/xtralab';
+
+/**
+ * An "About xtralab" dialog replacing the stock "About JupyterLab" one.
+ *
+ * The upstream `@jupyterlab/help-extension:about` plugin is disabled via
+ * `jupyterlab.disabledExtensions` (package.json), which removes both its
+ * `help:about` command and its Help menu contribution; this plugin registers
+ * the same command id and restores the menu entry through its own schema.
+ * The dialog leads with the xtralab version and keeps the underlying
+ * JupyterLab version visible underneath.
+ */
+const plugin: JupyterFrontEndPlugin<void> = {
+  id: PLUGIN_ID,
+  description: 'Show an About dialog with the xtralab and JupyterLab versions.',
+  autoStart: true,
+  requires: [ISettingRegistry],
+  optional: [ICommandPalette, ITranslator],
+  activate: (
+    app: JupyterFrontEnd,
+    settingRegistry: ISettingRegistry,
+    palette: ICommandPalette | null,
+    translator: ITranslator | null
+  ): void => {
+    const { commands } = app;
+    const trans = (translator ?? nullTranslator).load('jupyterlab');
+
+    commands.addCommand(CommandIDs.about, {
+      label: trans.__('About %1', 'xtralab'),
+      describedBy: {
+        args: {
+          type: 'object',
+          properties: {}
+        }
+      },
+      execute: async () => {
+        // The settings payload carries the version of the installed
+        // labextension (read server-side from its package.json), which is
+        // the release actually running — the page config only knows the
+        // JupyterLab version. 'N/A' is jupyterlab_server's not-found value.
+        const version = await settingRegistry
+          .load(PLUGIN_ID)
+          .then(settings =>
+            settings.version === 'N/A' ? '' : settings.version
+          )
+          .catch(() => '');
+
+        const title = (
+          <span className="jp-xtralab-About-header">
+            <aboutLogoIcon.react
+              className="jp-xtralab-About-logo"
+              height="56px"
+              width="56px"
+            />
+            <div className="jp-xtralab-About-header-info">
+              <span className="jp-xtralab-About-wordmark">xtralab</span>
+              {version ? (
+                <span className="jp-xtralab-About-version">
+                  {trans.__('Version %1', version)}
+                </span>
+              ) : null}
+            </div>
+          </span>
+        );
+
+        const body = (
+          <div className="jp-xtralab-About-body">
+            <span className="jp-xtralab-About-basedOn">
+              {trans.__('Based on JupyterLab %1', app.version)}
+            </span>
+            <span className="jp-xtralab-About-externalLinks">
+              <a href={REPO_URL} target="_blank" rel="noopener noreferrer">
+                {trans.__('xtralab on GitHub')}
+              </a>
+            </span>
+            <span className="jp-xtralab-About-copyright">
+              {trans.__('© %1 Jeremy Tuloup', 2026)}
+            </span>
+          </div>
+        );
+
+        return showDialog({
+          title,
+          body,
+          buttons: [
+            Dialog.cancelButton({
+              label: trans.__('Close')
+            })
+          ]
+        });
+      }
+    });
+
+    if (palette) {
+      palette.addItem({
+        command: CommandIDs.about,
+        category: trans.__('Help')
+      });
+    }
+  }
+};
+
+export default plugin;

package/src/editorBreadcrumbs/widget.ts

@@ -6,6 +6,7 @@ import type { CommandRegistry } from '@lumino/commands';
 import { Widget } from '@lumino/widgets';
 
 const EDITOR_BREADCRUMBS_CLASS = 'jp-xtralab-EditorBreadcrumbs';
+const TOOLBAR_SPACER_CLASS = 'jp-Toolbar-spacer';
 const BREADCRUMBS_CONTAINER_CLASS = 'jp-BreadCrumbs-container';
 const BREADCRUMBS_CONTENT_CLASS = 'jp-BreadCrumbs-content';
 const ROOT_CLASS = 'jp-BreadCrumbs-home';
@@ -37,6 +38,10 @@ export class EditorBreadcrumbs extends Widget {
     this._commands = options.commands;
     this._trans = options.trans;
     this.addClass(EDITOR_BREADCRUMBS_CLASS);
+    // The breadcrumbs stretch to fill the toolbar, so ReactiveToolbar's
+    // overflow math must count them as a spacer (2px) — measured at their
+    // stretched clientWidth they would evict every item into the popup.
+    this.addClass(TOOLBAR_SPACER_CLASS);
     this.node.setAttribute('aria-label', this._trans.__('Editor file path'));
 
     this._container = document.createElement('span');

package/src/fileBrowser/commands.ts

@@ -19,6 +19,7 @@ import {
   downloadIcon,
   editIcon,
   fileIcon,
+  filterIcon,
   IDisposableMenuItem,
   newFolderIcon,
   RankedMenu,
@@ -47,6 +48,7 @@ export namespace CommandIDs {
   export const download = 'xtralab:download';
   export const refresh = 'xtralab:refresh';
   export const collapseAll = 'xtralab:collapse-all';
+  export const toggleFileFilter = 'xtralab:toggle-file-filter';
   export const createNewDirectory = 'xtralab:create-new-directory';
   export const newLauncher = 'xtralab:new-launcher';
   export const revealPath = 'xtralab:reveal-path';
@@ -484,6 +486,24 @@ export function registerCommands(opts: IRegisterCommandsOptions): () => void {
     }
   });
 
+  commands.addCommand(CommandIDs.toggleFileFilter, {
+    label: trans.__('Toggle File Filter'),
+    caption: trans.__('Show or hide the file filter'),
+    icon: filterIcon.bindprops({ stylesheet: 'menuItem' }),
+    isToggled: () => browser.fileFilterVisible,
+    execute: () => {
+      browser.toggleFileFilter();
+    }
+  });
+
+  // Refresh the toggle's state however the filter is shown or hidden —
+  // the toolbar button, or the auto-show that kicks in when typing with
+  // the tree focused opens a search session.
+  const onFilterVisibleChanged = (): void => {
+    commands.notifyCommandChanged(CommandIDs.toggleFileFilter);
+  };
+  browser.fileFilterVisibleChanged.connect(onFilterVisibleChanged);
+
   // Public reveal seam. Other plugins (editor breadcrumbs, future
   // "reveal in tree" actions) call this command rather than depending
   // on the file browser widget directly. Activating the sidebar is part
@@ -591,6 +611,7 @@ export function registerCommands(opts: IRegisterCommandsOptions): () => void {
   return () => {
     app.contextMenu.opened.disconnect(updateOpenWithMenu);
     app.shell.currentChanged?.disconnect(onCurrentChanged);
+    browser.fileFilterVisibleChanged.disconnect(onFilterVisibleChanged);
     paletteItem?.dispose();
   };
 }
@@ -605,13 +626,14 @@ export namespace ToolbarNames {
   export const newDirectory = 'new-directory';
   export const refresh = 'refresh';
   export const collapseAll = 'collapse-all';
+  export const toggleFileFilter = 'toggle-file-filter';
 }
 
 /**
  * Populate the file browser's toolbar with the buttons that mirror the
  * default JupyterLab file browser: a "+" launcher button, a new-folder
- * button, and a refresh button. Returns a list of button names so callers
- * can extend it or remove items if they need to.
+ * button, a refresh button, a collapse-all button, and the file filter
+ * toggle.
  */
 export function populateToolbar(opts: {
   app: JupyterFrontEnd;
@@ -652,4 +674,12 @@ export function populateToolbar(opts: {
       label: ''
     })
   );
+  browser.toolbar.addItem(
+    ToolbarNames.toggleFileFilter,
+    new CommandToolbarButton({
+      commands,
+      id: CommandIDs.toggleFileFilter,
+      label: ''
+    })
+  );
 }