xtralab 0.13.0 → 0.14.0

package/README.md

@@ -1,4 +1,4 @@
-![xtralab-logo](./logo.png)
+<h1><img src="./logo.svg" width="34" align="absmiddle" alt="" /> xtralab</h1>
 
 An opinionated JupyterLab meta-package for coding agents.
 

package/lib/about/icons.d.ts

@@ -0,0 +1,7 @@
+import { LabIcon } from '@jupyterlab/ui-components';
+/**
+ * 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 declare const aboutLogoIcon: LabIcon;

package/lib/about/icons.js

@@ -0,0 +1,11 @@
+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/lib/about/index.d.ts

@@ -0,0 +1,13 @@
+import { JupyterFrontEndPlugin } from '@jupyterlab/application';
+/**
+ * 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.
+ */
+declare const plugin: JupyterFrontEndPlugin<void>;
+export default plugin;

package/lib/about/index.js

@@ -0,0 +1,81 @@
+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 = {
+    id: PLUGIN_ID,
+    description: 'Show an About dialog with the xtralab and JupyterLab versions.',
+    autoStart: true,
+    requires: [ISettingRegistry],
+    optional: [ICommandPalette, ITranslator],
+    activate: (app, settingRegistry, palette, translator) => {
+        const { commands } = app;
+        const trans = (translator !== null && translator !== void 0 ? 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 = (React.createElement("span", { className: "jp-xtralab-About-header" },
+                    React.createElement(aboutLogoIcon.react, { className: "jp-xtralab-About-logo", height: "56px", width: "56px" }),
+                    React.createElement("div", { className: "jp-xtralab-About-header-info" },
+                        React.createElement("span", { className: "jp-xtralab-About-wordmark" }, "xtralab"),
+                        version ? (React.createElement("span", { className: "jp-xtralab-About-version" }, trans.__('Version %1', version))) : null)));
+                const body = (React.createElement("div", { className: "jp-xtralab-About-body" },
+                    React.createElement("span", { className: "jp-xtralab-About-basedOn" }, trans.__('Based on JupyterLab %1', app.version)),
+                    React.createElement("span", { className: "jp-xtralab-About-externalLinks" },
+                        React.createElement("a", { href: REPO_URL, target: "_blank", rel: "noopener noreferrer" }, trans.__('xtralab on GitHub'))),
+                    React.createElement("span", { className: "jp-xtralab-About-copyright" }, trans.__('© %1 Jeremy Tuloup', 2026))));
+                return showDialog({
+                    title,
+                    body,
+                    buttons: [
+                        Dialog.cancelButton({
+                            label: trans.__('Close')
+                        })
+                    ]
+                });
+            }
+        });
+        if (palette) {
+            palette.addItem({
+                command: CommandIDs.about,
+                category: trans.__('Help')
+            });
+        }
+    }
+};
+export default plugin;

package/lib/editorBreadcrumbs/widget.js

@@ -2,6 +2,7 @@ import { PageConfig } from '@jupyterlab/coreutils';
 import { homeIcon as rootIcon } from '@jupyterlab/ui-components';
 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';
@@ -25,6 +26,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');
         this._container.className = BREADCRUMBS_CONTAINER_CLASS;

package/lib/fileBrowser/commands.d.ts

@@ -20,6 +20,7 @@ export declare namespace CommandIDs {
     const download = "xtralab:download";
     const refresh = "xtralab:refresh";
     const collapseAll = "xtralab:collapse-all";
+    const toggleFileFilter = "xtralab:toggle-file-filter";
     const createNewDirectory = "xtralab:create-new-directory";
     const newLauncher = "xtralab:new-launcher";
     const revealPath = "xtralab:reveal-path";
@@ -52,12 +53,13 @@ export declare namespace ToolbarNames {
     const newDirectory = "new-directory";
     const refresh = "refresh";
     const collapseAll = "collapse-all";
+    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 declare function populateToolbar(opts: {
     app: JupyterFrontEnd;

package/lib/fileBrowser/commands.js

@@ -1,7 +1,7 @@
 import { Clipboard, Dialog, InputDialog, showDialog, showErrorMessage } from '@jupyterlab/apputils';
 import { PageConfig, PathExt } from '@jupyterlab/coreutils';
 import { nullTranslator } from '@jupyterlab/translation';
-import { addIcon, closeIcon, collapseAllIcon, CommandToolbarButton, copyIcon, downloadIcon, editIcon, fileIcon, newFolderIcon, refreshIcon } from '@jupyterlab/ui-components';
+import { addIcon, closeIcon, collapseAllIcon, CommandToolbarButton, copyIcon, downloadIcon, editIcon, fileIcon, filterIcon, newFolderIcon, refreshIcon } from '@jupyterlab/ui-components';
 import { toCanonicalPath, toServerPath } from './contents';
 import { FILE_BROWSER_ID } from './widget';
 /**
@@ -22,6 +22,7 @@ export var CommandIDs;
     CommandIDs.download = 'xtralab:download';
     CommandIDs.refresh = 'xtralab:refresh';
     CommandIDs.collapseAll = 'xtralab:collapse-all';
+    CommandIDs.toggleFileFilter = 'xtralab:toggle-file-filter';
     CommandIDs.createNewDirectory = 'xtralab:create-new-directory';
     CommandIDs.newLauncher = 'xtralab:new-launcher';
     CommandIDs.revealPath = 'xtralab:reveal-path';
@@ -393,6 +394,22 @@ export function registerCommands(opts) {
             browser.collapseAll();
         }
     });
+    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 = () => {
+        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
@@ -492,6 +509,7 @@ export function registerCommands(opts) {
         var _a;
         app.contextMenu.opened.disconnect(updateOpenWithMenu);
         (_a = app.shell.currentChanged) === null || _a === void 0 ? void 0 : _a.disconnect(onCurrentChanged);
+        browser.fileFilterVisibleChanged.disconnect(onFilterVisibleChanged);
         paletteItem === null || paletteItem === void 0 ? void 0 : paletteItem.dispose();
     };
 }
@@ -506,12 +524,13 @@ export var ToolbarNames;
     ToolbarNames.newDirectory = 'new-directory';
     ToolbarNames.refresh = 'refresh';
     ToolbarNames.collapseAll = 'collapse-all';
+    ToolbarNames.toggleFileFilter = 'toggle-file-filter';
 })(ToolbarNames || (ToolbarNames = {}));
 /**
  * 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) {
     const { app, browser } = opts;
@@ -536,4 +555,9 @@ export function populateToolbar(opts) {
         id: CommandIDs.collapseAll,
         label: ''
     }));
+    browser.toolbar.addItem(ToolbarNames.toggleFileFilter, new CommandToolbarButton({
+        commands,
+        id: CommandIDs.toggleFileFilter,
+        label: ''
+    }));
 }

package/lib/fileBrowser/fileBrowser.js

@@ -64,9 +64,20 @@ const GIT_REPO_PATH = '';
  * resolution cost just for one string.
  */
 const FILE_TREE_TAG = 'file-tree-container';
+/**
+ * Injected into the tree's shadow root. The second rule hides the search
+ * box unless the host carries the visibility marker set by the filter
+ * bridge effect below — `@pierre/trees` always renders the box when
+ * `search` is enabled, and its stylesheet lives in the shadow root where
+ * outside CSS cannot reach.
+ */
 const FILE_TREE_UNSAFE_CSS = '[data-type="item"][data-item-selected="true"] ' +
     '[data-item-section="spacing-item"] {' +
     'border-left-color: transparent;' +
+    '}' +
+    ':host(:not([data-xtralab-filter-visible])) ' +
+    '[data-file-tree-search-container] {' +
+    'display: none;' +
     '}';
 /**
  * Renders a `@pierre/trees` file tree backed by the Jupyter contents API.
@@ -652,6 +663,17 @@ export function FileBrowserComponent(props) {
         };
         contentsManager.fileChanged.connect(onContentsFileChanged);
         const unsubscribe = model.subscribe(() => {
+            // Search-driven expansion must not trigger fetches: the tree
+            // auto-expands every directory whose path matches the query, and
+            // treating those as user expansions would recursively fetch every
+            // matching subtree — a single common letter can walk the whole
+            // workspace, node_modules included. Closing the search restores
+            // the pre-search expansion state, and a directory clicked in the
+            // results is toggled after the session closes, so real expansions
+            // are still fetched the moment the session ends.
+            if (model.isSearchOpen()) {
+                return;
+            }
             knownDirs.forEach((state, canonicalPath) => {
                 if (state !== 'unloaded') {
                     return;
@@ -744,6 +766,49 @@ export function FileBrowserComponent(props) {
             unsubscribe();
         };
     }, [model, widget]);
+    // Bridge the filter-box visibility between the widget and the tree. The
+    // widget owns the flag; applying it stamps the marker attribute the
+    // unsafeCSS rule keys on and opens or closes the model's search session
+    // (opening focuses the input, closing clears any active filter). The
+    // model subscription covers the reverse direction: typing a printable
+    // character while the tree has focus opens a session on the tree's own
+    // initiative, and the box must surface for that session to be usable.
+    React.useEffect(() => {
+        if (widget === undefined) {
+            return;
+        }
+        const apply = (visible) => {
+            const host = model.getFileTreeContainer();
+            if (host !== undefined) {
+                if (visible) {
+                    host.dataset.xtralabFilterVisible = 'true';
+                }
+                else {
+                    delete host.dataset.xtralabFilterVisible;
+                }
+            }
+            if (visible && !model.isSearchOpen()) {
+                model.openSearch();
+            }
+            else if (!visible && model.isSearchOpen()) {
+                model.closeSearch();
+            }
+        };
+        apply(widget.fileFilterVisible);
+        const visibleSlot = (sender, visible) => {
+            apply(visible);
+        };
+        widget.fileFilterVisibleChanged.connect(visibleSlot);
+        const unsubscribe = model.subscribe(() => {
+            if (model.isSearchOpen() && !widget.fileFilterVisible) {
+                widget.setFileFilterVisible(true);
+            }
+        });
+        return () => {
+            widget.fileFilterVisibleChanged.disconnect(visibleSlot);
+            unsubscribe();
+        };
+    }, [model, widget]);
     const wrapperRef = React.useRef(null);
     React.useEffect(() => {
         const wrapper = wrapperRef.current;

package/lib/fileBrowser/widget.d.ts

@@ -71,6 +71,19 @@ export interface IXtralabFileBrowser {
      * directories, calling `.collapse()` on each expanded one.
      */
     readonly collapseAllRequested: ISignal<IXtralabFileBrowser, void>;
+    /**
+     * Whether the filter box above the tree is shown. Mirrors the default
+     * file browser's `showFileFilter`: hidden on startup and flipped by the
+     * toolbar toggle. Also forced to `true` when the tree opens a search
+     * session on its own — typing a letter while the tree has focus.
+     */
+    readonly fileFilterVisible: boolean;
+    /**
+     * Emits when {@link fileFilterVisible} changes. The React component
+     * listens to show or hide the filter box; the toggle command listens
+     * to refresh its toggled state.
+     */
+    readonly fileFilterVisibleChanged: ISignal<IXtralabFileBrowser, boolean>;
     /**
      * Trigger a refresh of every loaded directory in the tree.
      */
@@ -98,6 +111,14 @@ export interface IXtralabFileBrowser {
      * Ask the tree to collapse every currently expanded folder.
      */
     collapseAll(): void;
+    /**
+     * Show or hide the filter box above the tree.
+     */
+    setFileFilterVisible(visible: boolean): void;
+    /**
+     * Toggle the filter box above the tree.
+     */
+    toggleFileFilter(): void;
 }
 /**
  * Lumino widget that hosts the React-based `@pierre/trees` file browser.
@@ -115,6 +136,8 @@ export declare class XtralabFileBrowser extends Widget implements IXtralabFileBr
     get revealRequested(): ISignal<this, string>;
     get rootRequested(): ISignal<this, void>;
     get collapseAllRequested(): ISignal<this, void>;
+    get fileFilterVisible(): boolean;
+    get fileFilterVisibleChanged(): ISignal<this, boolean>;
     /**
      * Update the cached selection. Called from the React tree when the
      * underlying `@pierre/trees` model emits a selection change.
@@ -125,6 +148,8 @@ export declare class XtralabFileBrowser extends Widget implements IXtralabFileBr
     reveal(canonicalPath: string): void;
     scrollToRoot(): void;
     collapseAll(): void;
+    setFileFilterVisible(visible: boolean): void;
+    toggleFileFilter(): void;
     private _contentsManager;
     private _docManager;
     private _onOpenFile;
@@ -135,6 +160,8 @@ export declare class XtralabFileBrowser extends Widget implements IXtralabFileBr
     private _revealRequested;
     private _rootRequested;
     private _collapseAllRequested;
+    private _fileFilterVisible;
+    private _fileFilterVisibleChanged;
     private _toolbar;
     private _content;
 }

package/lib/fileBrowser/widget.js

@@ -29,6 +29,8 @@ export class XtralabFileBrowser extends Widget {
         this._revealRequested = new Signal(this);
         this._rootRequested = new Signal(this);
         this._collapseAllRequested = new Signal(this);
+        this._fileFilterVisible = false;
+        this._fileFilterVisibleChanged = new Signal(this);
         const layout = (this.layout = new PanelLayout());
         this._contentsManager = options.contentsManager;
         this._docManager = options.docManager;
@@ -77,6 +79,12 @@ export class XtralabFileBrowser extends Widget {
     get collapseAllRequested() {
         return this._collapseAllRequested;
     }
+    get fileFilterVisible() {
+        return this._fileFilterVisible;
+    }
+    get fileFilterVisibleChanged() {
+        return this._fileFilterVisibleChanged;
+    }
     /**
      * Update the cached selection. Called from the React tree when the
      * underlying `@pierre/trees` model emits a selection change.
@@ -103,6 +111,16 @@ export class XtralabFileBrowser extends Widget {
     collapseAll() {
         this._collapseAllRequested.emit();
     }
+    setFileFilterVisible(visible) {
+        if (this._fileFilterVisible === visible) {
+            return;
+        }
+        this._fileFilterVisible = visible;
+        this._fileFilterVisibleChanged.emit(visible);
+    }
+    toggleFileFilter() {
+        this.setFileFilterVisible(!this._fileFilterVisible);
+    }
 }
 /**
  * The React-rendered region of the file browser. Lives inside the host

package/lib/index.js

@@ -1,3 +1,4 @@
+import aboutPlugin from './about';
 import agentSessionsPlugin from './agentSessions';
 import askAgentPlugin from './askAgent';
 import commandBarPlugin from './commandBar';
@@ -27,6 +28,7 @@ import walkthroughPlugin from './walkthrough';
  * they are spread in.
  */
 const plugins = [
+    aboutPlugin,
     agentSessionsPlugin,
     askAgentPlugin,
     commandBarPlugin,

package/lib/omnibox/index.d.ts

@@ -3,9 +3,11 @@ import { IOmnibox } from './tokens';
 /**
  * The omnibox: a single launcher overlay that fuzzy-searches workspace files
  * (via jupyterlab-quickopen's gitignore-aware endpoint) and JupyterLab
- * commands, and routes a typed prompt to one of the configured agents (running
- * it in a fresh terminal through the launcher's `xtralab:start-agent:<id>`
- * commands). It is opened by the top-bar command bar.
+ * commands (the command palette's entries plus registry commands the palette
+ * doesn't list), and routes a typed prompt to one of the configured agents
+ * (running it in a fresh terminal through the launcher's
+ * `xtralab:start-agent:<id>` commands). It is opened by the top-bar command
+ * bar.
  *
  * Commands run and files opened through the overlay are remembered (persisted
  * in the state database) and offered again at the top while the query is

package/lib/omnibox/index.js

@@ -2,7 +2,7 @@ import { ICommandPalette } from '@jupyterlab/apputils';
 import { ISettingRegistry } from '@jupyterlab/settingregistry';
 import { IStateDB } from '@jupyterlab/statedb';
 import { ITranslator, nullTranslator } from '@jupyterlab/translation';
-import { Widget } from '@lumino/widgets';
+import { CommandPalette, Widget } from '@lumino/widgets';
 import { IAgentRegistry } from '../launcher/tokens';
 import { OmniboxRecents } from './recents';
 import { IOmnibox, OMNIBOX_OPEN_COMMAND } from './tokens';
@@ -11,9 +11,11 @@ const PLUGIN_ID = 'xtralab:omnibox';
 /**
  * The omnibox: a single launcher overlay that fuzzy-searches workspace files
  * (via jupyterlab-quickopen's gitignore-aware endpoint) and JupyterLab
- * commands, and routes a typed prompt to one of the configured agents (running
- * it in a fresh terminal through the launcher's `xtralab:start-agent:<id>`
- * commands). It is opened by the top-bar command bar.
+ * commands (the command palette's entries plus registry commands the palette
+ * doesn't list), and routes a typed prompt to one of the configured agents
+ * (running it in a fresh terminal through the launcher's
+ * `xtralab:start-agent:<id>` commands). It is opened by the top-bar command
+ * bar.
  *
  * Commands run and files opened through the overlay are remembered (persisted
  * in the state database) and offered again at the top while the query is
@@ -38,6 +40,16 @@ const plugin = {
         const { commands, docRegistry } = app;
         const trans = (translator !== null && translator !== void 0 ? translator : nullTranslator).load('jupyterlab');
         const placeholder = trans.__('Search files and commands, or ask an agent…');
+        // The palette's items carry per-item args (e.g. one "Use Theme: …" per
+        // theme) that a raw command-registry scan can't see, but `ICommandPalette`
+        // exposes no item list and the widget itself is unreachable through the
+        // shell (`LabShell.add` defers it until layout restore, after which the
+        // modal setting re-parents it out of the left area). The wrapper's
+        // `_palette` field is private in TypeScript only, so read it guarded.
+        const paletteItems = () => {
+            const widget = palette === null || palette === void 0 ? void 0 : palette._palette;
+            return widget instanceof CommandPalette ? [...widget.items] : [];
+        };
         const recents = new OmniboxRecents({ state });
         // Restore the persisted recents only after the configured cap is known:
         // `restore` trims to `maxItems`, so restoring at the constructor default
@@ -77,6 +89,7 @@ const plugin = {
             close();
             const widget = new OmniboxWidget({
                 commands,
+                paletteItems: paletteItems(),
                 docRegistry,
                 agents: agentRegistry ? agentRegistry.agents : [],
                 placeholder,

package/lib/omnibox/model.d.ts

@@ -2,6 +2,7 @@ import type { DocumentRegistry } from '@jupyterlab/docregistry';
 import type { TranslationBundle } from '@jupyterlab/translation';
 import { LabIcon } 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';
 /**
@@ -53,6 +54,11 @@ interface IOmniboxSections {
 interface IComputeOptions {
     query: string;
     commands: CommandRegistry;
+    /**
+     * The command palette's items, whose labels are computed with each item's
+     * args — the only form in which entries like "Use Theme: …" exist.
+     */
+    paletteItems: ReadonlyArray<CommandPalette.IItem>;
     docRegistry: DocumentRegistry;
     agents: IAgent[];
     files: string[];