xtralab 0.2.0 → 0.4.0

package/lib/fileBrowser/gitStatus.js

@@ -0,0 +1,60 @@
+import { expandStatusFiles, status } from '../git/api';
+/**
+ * Translate a `jupyterlab_git` porcelain status into the closest
+ * `@pierre/trees` `GitStatus` enum value. The tree library only supports the
+ * six common statuses (added, deleted, ignored, modified, renamed, untracked)
+ * so the rare ones (unmerged, typechange, unknown) collapse onto `modified`
+ * — they all denote a pending change the user should see decorated.
+ */
+function toTreeStatus(value) {
+    switch (value) {
+        case 'added':
+        case 'deleted':
+        case 'modified':
+        case 'renamed':
+        case 'untracked':
+            return value;
+        case 'unmerged':
+        case 'typechange':
+        case 'unknown':
+        default:
+            return 'modified';
+    }
+}
+/**
+ * Fetch the porcelain status for `repoPath` and convert it into a flat list
+ * of `GitStatusEntry` values consumable by `FileTree.setGitStatus`. Returns
+ * an empty array when the path is not in a git repo, the request fails, or
+ * the server reports a non-zero exit — the file browser must still work
+ * without git, so any error here is a no-op rather than a thrown exception.
+ *
+ * Files that have both a staged and an unstaged change are collapsed into a
+ * single entry: the unstaged status wins because that mirrors what is
+ * actually different on disk and matches VS Code's tree decoration behavior.
+ */
+export async function loadGitStatusEntries(repoPath) {
+    try {
+        const result = await status(repoPath);
+        if (result.code !== 0) {
+            return [];
+        }
+        const changes = expandStatusFiles(result.files);
+        // Collapse staged + unstaged into one decoration per file. Prefer the
+        // unstaged group when both exist; otherwise keep whichever group is
+        // present.
+        const byPath = new Map();
+        for (const change of changes) {
+            if (change.group === 'unstaged' || !byPath.has(change.path)) {
+                byPath.set(change.path, change.status);
+            }
+        }
+        const entries = [];
+        byPath.forEach((value, path) => {
+            entries.push({ path, status: toTreeStatus(value) });
+        });
+        return entries;
+    }
+    catch (_a) {
+        return [];
+    }
+}

package/lib/fileBrowser/icons.d.ts

@@ -1,9 +1,9 @@
 import { LabIcon } from '@jupyterlab/ui-components';
 import type { FileTreeIconConfig } from '@pierre/trees';
 /**
- * The glyph used as the Xtralab file browser's sidebar tab icon. Defined as a
+ * The glyph used as the xtralab file browser's sidebar tab icon. Defined as a
  * `LabIcon` (rather than the default `folderIcon` from
- * `@jupyterlab/ui-components`) so the Xtralab browser is visually distinguishable
+ * `@jupyterlab/ui-components`) so the xtralab browser is visually distinguishable
  * from JupyterLab's built-in file browser, which also lives in the left
  * sidebar.
  *
@@ -14,7 +14,7 @@ import type { FileTreeIconConfig } from '@pierre/trees';
  */
 export declare const xtralabFileBrowserIcon: LabIcon;
 /**
- * Icon configuration for the Xtralab file browser. Keeps the default `complete`
+ * Icon configuration for the xtralab file browser. Keeps the default `complete`
  * built-in icon set (the colored language icons) and layers a Jupyter notebook
  * symbol on top so `.ipynb` files render with the JupyterLab notebook glyph.
  *
@@ -24,7 +24,7 @@ export declare const xtralabFileBrowserIcon: LabIcon;
  */
 export declare const FILE_BROWSER_ICONS: FileTreeIconConfig;
 /**
- * Return a JupyterLab `LabIcon` matching the icon the Xtralab file tree would
+ * Return a JupyterLab `LabIcon` matching the icon the xtralab file tree would
  * render for the given file path. Used by other plugins (e.g. the git diff
  * viewer) that want their main-area widget tabs to display the same per-file
  * glyph the tree shows in the sidebar.

package/lib/fileBrowser/icons.js

@@ -2,9 +2,9 @@ var _a;
 import { LabIcon, fileIcon } from '@jupyterlab/ui-components';
 import { createFileTreeIconResolver, getBuiltInFileIconColor, getBuiltInSpriteSheet } from '@pierre/trees';
 /**
- * The glyph used as the Xtralab file browser's sidebar tab icon. Defined as a
+ * The glyph used as the xtralab file browser's sidebar tab icon. Defined as a
  * `LabIcon` (rather than the default `folderIcon` from
- * `@jupyterlab/ui-components`) so the Xtralab browser is visually distinguishable
+ * `@jupyterlab/ui-components`) so the xtralab browser is visually distinguishable
  * from JupyterLab's built-in file browser, which also lives in the left
  * sidebar.
  *
@@ -42,7 +42,7 @@ const JUPYTER_NOTEBOOK_SPRITE_SHEET = `<svg data-icon-sprite aria-hidden="true"
   </symbol>
 </svg>`;
 /**
- * Icon configuration for the Xtralab file browser. Keeps the default `complete`
+ * Icon configuration for the xtralab file browser. Keeps the default `complete`
  * built-in icon set (the colored language icons) and layers a Jupyter notebook
  * symbol on top so `.ipynb` files render with the JupyterLab notebook glyph.
  *
@@ -105,7 +105,7 @@ function extractSymbol(symbolId) {
     };
 }
 /**
- * Return a JupyterLab `LabIcon` matching the icon the Xtralab file tree would
+ * Return a JupyterLab `LabIcon` matching the icon the xtralab file tree would
  * render for the given file path. Used by other plugins (e.g. the git diff
  * viewer) that want their main-area widget tabs to display the same per-file
  * glyph the tree shows in the sidebar.

package/lib/fileBrowser/widget.d.ts

@@ -5,7 +5,7 @@ import { ISignal } from '@lumino/signaling';
 import { Widget } from '@lumino/widgets';
 export declare const FILE_BROWSER_ID = "xtralab:file-browser";
 /**
- * The CSS class added to the Xtralab file browser widget. The selectors that
+ * The CSS class added to the xtralab file browser widget. The selectors that
  * bind application context menu items hang off this class, so it must remain
  * specific enough not to clash with other browsers (such as the default
  * `jp-FileBrowser`).
@@ -17,7 +17,7 @@ export interface IXtralabFileBrowserOptions {
     onOpenFile?: (serverPath: string) => void;
 }
 /**
- * Public API of the Xtralab file browser used by command handlers and other
+ * Public API of the xtralab file browser used by command handlers and other
  * collaborators. Kept narrow on purpose so the React component stays free to
  * evolve the underlying tree integration.
  */
@@ -56,6 +56,28 @@ export interface IXtralabFileBrowser {
      * sees the new item without a full refresh.
      */
     readonly pathAdded: ISignal<IXtralabFileBrowser, string>;
+    /**
+     * Emits when an external caller asks the tree to scroll to and select
+     * the given canonical path. The React component listens, lazily loads
+     * any unloaded ancestor directories, expands them, and selects the
+     * target. Used by the editor breadcrumbs to jump back to a file or
+     * folder shown in the breadcrumb trail.
+     */
+    readonly revealRequested: ISignal<IXtralabFileBrowser, string>;
+    /**
+     * Emits when an external caller asks the tree to return to the
+     * workspace root: clear any current selection and scroll back to the
+     * first row. Distinct from {@link revealRequested} because the
+     * workspace root has no tree row of its own — it cannot be reached
+     * by passing a path.
+     */
+    readonly rootRequested: ISignal<IXtralabFileBrowser, void>;
+    /**
+     * Emits when an external caller asks the tree to collapse every
+     * expanded folder. The React component listens and walks the loaded
+     * directories, calling `.collapse()` on each expanded one.
+     */
+    readonly collapseAllRequested: ISignal<IXtralabFileBrowser, void>;
     /** Trigger a refresh of every loaded directory in the tree. */
     refresh(): void;
     /**
@@ -64,6 +86,23 @@ export interface IXtralabFileBrowser {
      * convention: directories carry a trailing slash, files do not.
      */
     notifyPathAdded(canonicalPath: string): void;
+    /**
+     * Ask the tree to reveal {@link canonicalPath}: load and expand any
+     * unloaded ancestor directories, then select and scroll the target
+     * into view. `canonicalPath` follows the `@pierre/trees` convention
+     * (directories carry a trailing slash, files do not). Must be a
+     * non-empty path — use {@link scrollToRoot} for the root gesture.
+     */
+    reveal(canonicalPath: string): void;
+    /**
+     * Ask the tree to return to the workspace root: clear any current
+     * selection and scroll back to the top of the tree.
+     */
+    scrollToRoot(): void;
+    /**
+     * Ask the tree to collapse every currently expanded folder.
+     */
+    collapseAll(): void;
 }
 /**
  * Lumino widget that hosts the React-based `@pierre/trees` file browser.
@@ -78,6 +117,9 @@ export declare class XtralabFileBrowser extends Widget implements IXtralabFileBr
     get selectionChanged(): ISignal<this, readonly string[]>;
     get refreshRequested(): ISignal<this, void>;
     get pathAdded(): ISignal<this, string>;
+    get revealRequested(): ISignal<this, string>;
+    get rootRequested(): ISignal<this, void>;
+    get collapseAllRequested(): ISignal<this, void>;
     /**
      * Update the cached selection. Called from the React tree when the
      * underlying `@pierre/trees` model emits a selection change.
@@ -85,6 +127,9 @@ export declare class XtralabFileBrowser extends Widget implements IXtralabFileBr
     updateSelection(paths: readonly string[]): void;
     refresh(): void;
     notifyPathAdded(canonicalPath: string): void;
+    reveal(canonicalPath: string): void;
+    scrollToRoot(): void;
+    collapseAll(): void;
     private _contentsManager;
     private _docManager;
     private _onOpenFile;
@@ -92,6 +137,9 @@ export declare class XtralabFileBrowser extends Widget implements IXtralabFileBr
     private _selectionChanged;
     private _refreshRequested;
     private _pathAdded;
+    private _revealRequested;
+    private _rootRequested;
+    private _collapseAllRequested;
     private _toolbar;
     private _content;
 }

package/lib/fileBrowser/widget.js

@@ -6,7 +6,7 @@ import { FileBrowserComponent } from './fileBrowser';
 import { xtralabFileBrowserIcon } from './icons';
 export const FILE_BROWSER_ID = 'xtralab:file-browser';
 /**
- * The CSS class added to the Xtralab file browser widget. The selectors that
+ * The CSS class added to the xtralab file browser widget. The selectors that
  * bind application context menu items hang off this class, so it must remain
  * specific enough not to clash with other browsers (such as the default
  * `jp-FileBrowser`).
@@ -26,13 +26,16 @@ export class XtralabFileBrowser extends Widget {
         this._selectionChanged = new Signal(this);
         this._refreshRequested = new Signal(this);
         this._pathAdded = new Signal(this);
+        this._revealRequested = new Signal(this);
+        this._rootRequested = new Signal(this);
+        this._collapseAllRequested = new Signal(this);
         const layout = (this.layout = new PanelLayout());
         this._contentsManager = options.contentsManager;
         this._docManager = options.docManager;
         this._onOpenFile = options.onOpenFile;
         this.id = FILE_BROWSER_ID;
         this.title.icon = xtralabFileBrowserIcon;
-        this.title.caption = 'Xtralab File Browser';
+        this.title.caption = 'xtralab File Browser';
         this.addClass(FILE_BROWSER_CSS_CLASS);
         this._toolbar = new Toolbar();
         this._toolbar.addClass(TOOLBAR_CSS_CLASS);
@@ -65,6 +68,15 @@ export class XtralabFileBrowser extends Widget {
     get pathAdded() {
         return this._pathAdded;
     }
+    get revealRequested() {
+        return this._revealRequested;
+    }
+    get rootRequested() {
+        return this._rootRequested;
+    }
+    get collapseAllRequested() {
+        return this._collapseAllRequested;
+    }
     /**
      * Update the cached selection. Called from the React tree when the
      * underlying `@pierre/trees` model emits a selection change.
@@ -79,6 +91,18 @@ export class XtralabFileBrowser extends Widget {
     notifyPathAdded(canonicalPath) {
         this._pathAdded.emit(canonicalPath);
     }
+    reveal(canonicalPath) {
+        if (canonicalPath.length === 0) {
+            throw new Error('XtralabFileBrowser.reveal requires a non-empty canonical path; use scrollToRoot for the workspace root.');
+        }
+        this._revealRequested.emit(canonicalPath);
+    }
+    scrollToRoot() {
+        this._rootRequested.emit();
+    }
+    collapseAll() {
+        this._collapseAllRequested.emit();
+    }
 }
 /**
  * The React-rendered region of the file browser. Lives inside the host

package/lib/git/icons.d.ts

@@ -5,7 +5,7 @@ import { LabIcon } from '@jupyterlab/ui-components';
  * recoloring and inverse-color sidebar painting automatically.
  *
  * Source: `git-branch` from SVG Repo (https://www.svgrepo.com/svg/377352/git-branch),
- * part of the same Pixelarticons family as the Xtralab file browser's `file-tree`
+ * part of the same Pixelarticons family as the xtralab file browser's `file-tree`
  * icon, so the two sidebar tab glyphs read as a matched set. The original
  * `fill="#000000"` is replaced with `fill="currentColor"` and the root element
  * is given the `jp-icon3` class so the icon picks up JupyterLab's theme color

package/lib/git/icons.js

@@ -5,7 +5,7 @@ import { LabIcon } from '@jupyterlab/ui-components';
  * recoloring and inverse-color sidebar painting automatically.
  *
  * Source: `git-branch` from SVG Repo (https://www.svgrepo.com/svg/377352/git-branch),
- * part of the same Pixelarticons family as the Xtralab file browser's `file-tree`
+ * part of the same Pixelarticons family as the xtralab file browser's `file-tree`
  * icon, so the two sidebar tab glyphs read as a matched set. The original
  * `fill="#000000"` is replaced with `fill="currentColor"` and the root element
  * is given the `jp-icon3` class so the icon picks up JupyterLab's theme color

package/lib/git/panelComponent.js

@@ -1,4 +1,5 @@
 import * as React from 'react';
+import { Poll } from '@lumino/polling';
 import { add, addAll, checkout, porcelainToFileChanges, reset, resetAll, showTopLevel, status } from './api';
 /**
  * The polling interval for the panel. We refresh the status periodically so
@@ -6,6 +7,13 @@ import { add, addAll, checkout, porcelainToFileChanges, reset, resetAll, showTop
  * visible without requiring a manual refresh.
  */
 const STATUS_POLL_INTERVAL_MS = 5000;
+/**
+ * Upper bound on the poll's exponential backoff when status requests fail
+ * repeatedly. Matches the default JupyterLab file browser's `max`: long
+ * enough that a server outage stops hammering the API, short enough that
+ * a transient failure heals on its own.
+ */
+const STATUS_POLL_MAX_MS = 300000;
 /**
  * Top-level React component rendered inside the {@link GitPanel} widget.
  * Owns the polling + refresh wiring around the `/git/status` endpoint and
@@ -59,23 +67,32 @@ export function GitPanelComponent(props) {
             });
         }
     }, [repoPath]);
-    // Initial load + polling. `refresh` is stable for a given `repoPath`, so
-    // the polling interval is only re-created when the repo path changes.
-    React.useEffect(() => {
-        void refresh();
-        const interval = window.setInterval(() => void refresh(), STATUS_POLL_INTERVAL_MS);
-        return () => {
-            window.clearInterval(interval);
-        };
-    }, [refresh]);
-    // External refresh triggers (toolbar button, plugin-level events).
+    // Initial load + polling. Driven by a Lumino `Poll` so the panel stops
+    // hitting the git endpoint while the JupyterLab tab is hidden, and so
+    // repeated failures back off exponentially instead of spinning at 5s.
+    // External refresh triggers (toolbar button, plugin-level events) call
+    // `poll.refresh()` to schedule an immediate tick instead of running
+    // `refresh()` directly — that keeps the panel from issuing two parallel
+    // status requests when an automatic tick happens to land at the same
+    // time as an external trigger.
     React.useEffect(() => {
+        const poll = new Poll({
+            name: '@xtralab/git:panelStatus',
+            factory: () => refresh(),
+            frequency: {
+                interval: STATUS_POLL_INTERVAL_MS,
+                backoff: true,
+                max: STATUS_POLL_MAX_MS
+            },
+            standby: 'when-hidden'
+        });
         const handler = () => {
-            void refresh();
+            void poll.refresh();
         };
         refreshSignal.connect(handler);
         return () => {
             refreshSignal.disconnect(handler);
+            poll.dispose();
         };
     }, [refresh, refreshSignal]);
     const runAction = React.useCallback(async (change, action, run) => {

package/lib/index.js

@@ -1,4 +1,6 @@
 import fileBrowserPlugin from './fileBrowser';
+import editorBreadcrumbsPlugin from './editorBreadcrumbs';
+import editorIndentPlugin from './editorIndent';
 import gitPlugin from './git';
 import launcherPlugin from './launcher';
 import menusPlugin from './menus';
@@ -12,6 +14,8 @@ import statusBarPlugin from './statusBar';
  * available end up running.
  */
 const plugins = [
+    editorBreadcrumbsPlugin,
+    editorIndentPlugin,
     fileBrowserPlugin,
     gitPlugin,
     launcherPlugin,

package/lib/launcher/dashboard.js

@@ -1,5 +1,6 @@
 import * as React from 'react';
-import { LabIcon, ReactWidget, refreshIcon } from '@jupyterlab/ui-components';
+import { Poll } from '@lumino/polling';
+import { LabIcon, ReactWidget, consoleIcon, notebookIcon, refreshIcon, terminalIcon } from '@jupyterlab/ui-components';
 import { expandStatusFiles, status } from '../git/api';
 import { CommandIDs as GitCommandIDs } from '../git/commands';
 import { agentCommandId } from './commands';
@@ -24,6 +25,12 @@ export class LauncherDashboard extends ReactWidget {
  * only opened intentionally, and the grid does not need to be live.
  */
 const CHANGES_POLL_INTERVAL_MS = 8000;
+/**
+ * Upper bound on the exponential backoff when the status request fails
+ * repeatedly. Matches the rest of the plugin's polls so behavior is
+ * consistent across the dashboard, the git panel, and the file tree.
+ */
+const CHANGES_POLL_MAX_MS = 300000;
 function LauncherDashboardComponent(props) {
     const { commands, agents, onAgentLaunch, repoPath, cwd } = props;
     const [prompt, setPrompt] = React.useState('');
@@ -45,12 +52,23 @@ function LauncherDashboardComponent(props) {
             });
         }
     }, [repoPath]);
+    // Driven by a Lumino `Poll` so the dashboard stops hitting the git
+    // endpoint while the JupyterLab tab is hidden, and so repeated
+    // failures back off exponentially instead of pegging the 8s cadence.
     React.useEffect(() => {
-        void refresh();
-        const handle = window.setInterval(() => {
-            void refresh();
-        }, CHANGES_POLL_INTERVAL_MS);
-        return () => window.clearInterval(handle);
+        const poll = new Poll({
+            name: '@xtralab/launcher:gitChanges',
+            factory: () => refresh(),
+            frequency: {
+                interval: CHANGES_POLL_INTERVAL_MS,
+                backoff: true,
+                max: CHANGES_POLL_MAX_MS
+            },
+            standby: 'when-hidden'
+        });
+        return () => {
+            poll.dispose();
+        };
     }, [refresh]);
     const launch = React.useCallback(async (agent) => {
         const args = { cwd };
@@ -63,12 +81,40 @@ function LauncherDashboardComponent(props) {
             onAgentLaunch(result);
         }
     }, [commands, cwd, prompt, onAgentLaunch]);
+    const launchTerminal = React.useCallback(async () => {
+        const result = (await commands.execute('terminal:create-new', {
+            cwd
+        }));
+        if (result) {
+            onAgentLaunch(result);
+        }
+    }, [commands, cwd, onAgentLaunch]);
+    const launchNotebook = React.useCallback(async () => {
+        // No `kernelName` — let the notebook extension fall back to the default
+        // kernel or prompt the user, matching the stock launcher's notebook
+        // tile behavior.
+        const result = (await commands.execute('notebook:create-new', {
+            cwd
+        }));
+        if (result) {
+            onAgentLaunch(result);
+        }
+    }, [commands, cwd, onAgentLaunch]);
+    const launchConsole = React.useCallback(async () => {
+        const result = (await commands.execute('console:create', {
+            cwd
+        }));
+        if (result) {
+            onAgentLaunch(result);
+        }
+    }, [commands, cwd, onAgentLaunch]);
     const openDiff = React.useCallback((change) => {
         const args = { repoPath, change };
         void commands.execute(GitCommandIDs.openDiff, args);
     }, [commands, repoPath]);
     return (React.createElement("div", { className: "jp-xtralab-Launcher-body" },
         React.createElement(AgentSection, { agents: agents, prompt: prompt, onPromptChange: setPrompt, onLaunch: launch }),
+        React.createElement(OpenSection, { onLaunchTerminal: launchTerminal, onLaunchNotebook: launchNotebook, onLaunchConsole: launchConsole }),
         React.createElement(ChangesSection, { git: git, onOpen: openDiff, onRefresh: () => void refresh() })));
 }
 function ChangesSection(props) {
@@ -126,10 +172,9 @@ function AgentSection(props) {
     const { agents, prompt, onPromptChange, onLaunch } = props;
     const trimmed = prompt.trim();
     const promptActive = trimmed.length > 0;
-    // The "primary" agent is the first prompt-capable one in the rendered
-    // order. We mark it visually so the keyboard shortcut target isn't a
-    // mystery, and reuse the same agent when Cmd/Ctrl+Enter fires from the
-    // textarea — picking by the same rule keeps the two behaviors in sync.
+    // The first prompt-capable agent is what Cmd/Ctrl+Enter fires; the hint
+    // text below the textarea names it so the keyboard shortcut target
+    // isn't a mystery.
     const primaryAgent = agents.find(agent => agent.promptArgs !== undefined);
     const hintId = 'jp-xtralab-Launcher-agent-hint';
     return (React.createElement("section", { className: "jp-xtralab-Launcher-section" },
@@ -149,16 +194,33 @@ function AgentSection(props) {
         React.createElement("div", { className: "jp-xtralab-Launcher-agents" }, agents.map(agent => {
             const supportsPrompt = agent.promptArgs !== undefined;
             const disabled = promptActive && !supportsPrompt;
-            const isPrimary = agent === primaryAgent;
             const tooltip = disabled
                 ? `${agent.label} doesn't accept an initial prompt — clear the prompt to launch.`
                 : agent.caption;
-            const classes = ['jp-xtralab-Launcher-agent'];
-            if (isPrimary) {
-                classes.push('jp-xtralab-Launcher-agent-primary');
-            }
-            return (React.createElement("button", { key: agent.id, type: "button", className: classes.join(' '), title: tooltip, "aria-label": agent.label, "aria-describedby": hintId, disabled: disabled, onClick: () => onLaunch(agent) },
+            return (React.createElement("button", { key: agent.id, type: "button", className: "jp-xtralab-Launcher-agent", title: tooltip, "aria-label": agent.label, "aria-describedby": hintId, disabled: disabled, onClick: () => onLaunch(agent) },
                 React.createElement(LabIcon.resolveReact, { icon: agent.icon, tag: "span", className: "jp-xtralab-Launcher-agent-icon" }),
                 React.createElement("span", { className: "jp-xtralab-Launcher-agent-label" }, agent.label)));
         }))));
 }
+/**
+ * The non-agent launch tiles — a plain terminal, a new notebook, and a
+ * new console. They sit in a separate section below the agent grid so
+ * they don't compete with the AI agents visually, and they're always
+ * available regardless of the agent prompt textarea (which doesn't
+ * apply to them).
+ */
+function OpenSection(props) {
+    const { onLaunchTerminal, onLaunchNotebook, onLaunchConsole } = props;
+    return (React.createElement("section", { className: "jp-xtralab-Launcher-section" },
+        React.createElement("h2", { className: "jp-xtralab-Launcher-section-title" }, "Open"),
+        React.createElement("div", { className: "jp-xtralab-Launcher-agents" },
+            React.createElement("button", { type: "button", className: "jp-xtralab-Launcher-agent", title: "Open a new terminal.", "aria-label": "Open a new terminal", onClick: onLaunchTerminal },
+                React.createElement(LabIcon.resolveReact, { icon: terminalIcon, tag: "span", className: "jp-xtralab-Launcher-agent-icon" }),
+                React.createElement("span", { className: "jp-xtralab-Launcher-agent-label" }, "Terminal")),
+            React.createElement("button", { type: "button", className: "jp-xtralab-Launcher-agent", title: "Create a new notebook.", "aria-label": "Create a new notebook", onClick: onLaunchNotebook },
+                React.createElement(LabIcon.resolveReact, { icon: notebookIcon, tag: "span", className: "jp-xtralab-Launcher-agent-icon" }),
+                React.createElement("span", { className: "jp-xtralab-Launcher-agent-label" }, "Notebook")),
+            React.createElement("button", { type: "button", className: "jp-xtralab-Launcher-agent", title: "Create a new console.", "aria-label": "Create a new console", onClick: onLaunchConsole },
+                React.createElement(LabIcon.resolveReact, { icon: consoleIcon, tag: "span", className: "jp-xtralab-Launcher-agent-icon" }),
+                React.createElement("span", { className: "jp-xtralab-Launcher-agent-label" }, "Console")))));
+}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "xtralab",
-    "version": "0.2.0",
+    "version": "0.4.0",
     "description": "An opinionated JupyterLab meta-package that bundles a curated set of extensions, ships a path-first file browser and a VS Code-style git changes panel, and applies a quieter default workspace configuration.",
     "keywords": [
         "jupyter",
@@ -57,8 +57,12 @@
         "watch:labextension": "jupyter-builder watch ."
     },
     "dependencies": {
+        "@codemirror/language": "^6.12.1",
+        "@codemirror/state": "^6.5.4",
+        "@codemirror/view": "^6.39.14",
         "@jupyterlab/application": "^4.6.0-alpha.5",
         "@jupyterlab/apputils": "^4.7.0-alpha.5",
+        "@jupyterlab/codemirror": "^4.6.0-alpha.5",
         "@jupyterlab/coreutils": "^6.6.0-alpha.5",
         "@jupyterlab/docmanager": "^4.6.0-alpha.5",
         "@jupyterlab/docregistry": "^4.6.0-alpha.5",
@@ -78,10 +82,12 @@
         "@lumino/disposable": "^2.0.0",
         "@lumino/dragdrop": "^2.0.0",
         "@lumino/messaging": "^2.0.0",
+        "@lumino/polling": "^2.1.5",
         "@lumino/signaling": "^2.0.0",
         "@lumino/widgets": "^2.0.0",
         "@pierre/diffs": "^1.1.20",
         "@pierre/trees": "1.0.0-beta.3",
+        "detect-indent": "^7.0.2",
         "ignore": "^5.3.2",
         "react": "^18.2.0",
         "react-dom": "^18.2.0"
@@ -145,12 +151,26 @@
         ],
         "parser": "@typescript-eslint/parser",
         "parserOptions": {
-            "project": "tsconfig.json",
+            "project": [
+                "tsconfig.json",
+                "desktop/tsconfig.json",
+                "desktop/tsconfig.forge.json"
+            ],
             "sourceType": "module"
         },
         "plugins": [
             "@typescript-eslint"
         ],
+        "overrides": [
+            {
+                "files": [
+                    "desktop/src/**/*.ts"
+                ],
+                "rules": {
+                    "@typescript-eslint/naming-convention": "off"
+                }
+            }
+        ],
         "rules": {
             "@typescript-eslint/naming-convention": [
                 "error",

package/src/editorBreadcrumbs/index.ts

@@ -0,0 +1,70 @@
+import {
+  JupyterFrontEnd,
+  JupyterFrontEndPlugin
+} from '@jupyterlab/application';
+import type {
+  DocumentRegistry,
+  IDocumentWidget
+} from '@jupyterlab/docregistry';
+import type { CommandRegistry } from '@lumino/commands';
+import { DisposableDelegate, type IDisposable } from '@lumino/disposable';
+import type { Widget } from '@lumino/widgets';
+
+import { EditorBreadcrumbs } from './widget';
+
+const PLUGIN_ID = 'xtralab:editor-breadcrumbs';
+const EDITOR_FACTORY = 'Editor';
+const TOOLBAR_ITEM_NAME = 'xtralab-editor-breadcrumbs';
+
+class EditorBreadcrumbsExtension implements DocumentRegistry.IWidgetExtension<
+  IDocumentWidget<Widget, DocumentRegistry.IModel>,
+  DocumentRegistry.IModel
+> {
+  constructor(commands: CommandRegistry) {
+    this._commands = commands;
+  }
+
+  createNew(
+    widget: IDocumentWidget<Widget, DocumentRegistry.IModel>,
+    context: DocumentRegistry.IContext<DocumentRegistry.IModel>
+  ): IDisposable | void {
+    const breadcrumbs = new EditorBreadcrumbs({
+      context,
+      commands: this._commands
+    });
+    const added = widget.toolbar.insertItem(0, TOOLBAR_ITEM_NAME, breadcrumbs);
+
+    if (!added) {
+      breadcrumbs.dispose();
+      return;
+    }
+
+    return new DisposableDelegate(() => {
+      breadcrumbs.dispose();
+    });
+  }
+
+  private _commands: CommandRegistry;
+}
+
+/**
+ * Adds a VS Code-style path breadcrumb to text editor toolbars. Each
+ * segment is clickable: clicking dispatches `xtralab:reveal-path` so
+ * any plugin that listens (today, the file browser) can surface the
+ * underlying folder or file. The breadcrumbs plugin therefore does not
+ * import the file browser at all — the JupyterLab command registry is
+ * the only seam between them.
+ */
+const plugin: JupyterFrontEndPlugin<void> = {
+  id: PLUGIN_ID,
+  description: 'Display the active file path in text editor toolbars.',
+  autoStart: true,
+  activate: (app: JupyterFrontEnd): void => {
+    app.docRegistry.addWidgetExtension(
+      EDITOR_FACTORY,
+      new EditorBreadcrumbsExtension(app.commands)
+    );
+  }
+};
+
+export default plugin;