xtralab 0.15.0 → 0.15.2

package/lib/launcher/dashboard.d.ts

@@ -7,46 +7,40 @@ import type { IAgentSessions } from '../agentSessions';
 import type { IAgent } from './agents';
 import type { IEditor } from './editors';
 /**
- * Public construction options for the launcher dashboard widget. The
- * plugin supplies an `onAgentLaunch` callback that performs the same
- * shell placement the stock JupyterLab launcher does (swap the launcher
- * tab for the freshly created terminal). Keeping it as an opaque
- * callback means the widget itself does not import `app.shell`.
+ * Construction options for the launcher dashboard. `onAgentLaunch` is an
+ * opaque callback so the widget itself never imports `app.shell`.
  */
 interface ILauncherDashboardOptions {
+    /**
+     * The application command registry, used to launch terminals and run git
+     * commands.
+     */
     commands: CommandRegistry;
     /**
-     * The agent list to render. Already filtered by availability + sorted by
-     * rank; the widget renders them as-is.
+     * Agent list to render, already filtered by availability and sorted by rank.
      */
     agents: IAgent[];
     /**
-     * The terminal editor to offer in the "Open" section (Neovim preferred over
-     * Vim), or `null` when neither is installed. Resolved by the plugin from the
-     * same availability probe that filters the agents.
+     * Terminal editor for the "Open" section, or `null` when none is installed.
      */
     editor: IEditor | null;
     /**
-     * Shared launch-tag registry. When the editor tile launches, it records the
-     * session here so the terminals panel badges it with the editor's logo right
-     * away, the same as agent launches do. `null` when the provider plugin is
-     * unavailable.
+     * Launch-tag registry so the terminals panel badges editor launches right
+     * away; `null` when the provider plugin is unavailable.
      */
     agentSessions: IAgentSessions | null;
     /**
-     * Called after an agent command has returned its top-level widget. The
-     * plugin uses this to swap the new terminal into the launcher's tab.
+     * Called with the launched widget; the plugin swaps it into the launcher's tab.
      */
     onAgentLaunch: (item: Widget) => void;
     /**
-     * The git server-relative repo path used by the changes section. Empty
-     * string means "use the JupyterLab server's root and let git resolve the
-     * enclosing repo" — same convention as the git panel.
+     * Repo path for the changes section. Empty string lets git resolve the
+     * enclosing repo from the server root — same convention as the git panel.
      */
     repoPath: string;
     /**
-     * The cwd forwarded to `terminal:create-new` when an agent is launched.
-     * Empty string lets the terminal extension default to the server root.
+     * Cwd forwarded to `terminal:create-new`. Empty string defaults to the
+     * server root.
      */
     cwd: string;
     /**
@@ -56,12 +50,13 @@ interface ILauncherDashboardOptions {
     trans: TranslationBundle;
 }
 /**
- * Lumino host for the React-based launcher dashboard. Mirrors the
- * `ReactWidget` pattern used by the git panel so the rest of the plugin
- * (layout placement, signals, lifecycle) stays consistent.
+ * Lumino host for the React-based launcher dashboard.
  */
 export declare class LauncherDashboard extends ReactWidget {
     constructor(options: ILauncherDashboardOptions);
+    /**
+     * Render the launcher dashboard component.
+     */
     protected render(): React.ReactElement;
     private _options;
 }

package/lib/launcher/dashboard.js

@@ -6,9 +6,7 @@ import { CommandIDs as GitCommandIDs } from '../git/commands';
 import { launchInTerminal } from './commands';
 import { agentCommandId } from './tokens';
 /**
- * Lumino host for the React-based launcher dashboard. Mirrors the
- * `ReactWidget` pattern used by the git panel so the rest of the plugin
- * (layout placement, signals, lifecycle) stays consistent.
+ * Lumino host for the React-based launcher dashboard.
  */
 export class LauncherDashboard extends ReactWidget {
     constructor(options) {
@@ -16,21 +14,18 @@ export class LauncherDashboard extends ReactWidget {
         this.addClass('jp-xtralab-Launcher');
         this._options = options;
     }
+    /**
+     * Render the launcher dashboard component.
+     */
     render() {
         return React.createElement(LauncherDashboardComponent, { ...this._options });
     }
 }
 /**
- * Refresh interval for the changes list. A bit slower than the git panel
- * (which sits in the sidebar and is always visible) — the launcher tab is
- * only opened intentionally, and the grid does not need to be live.
+ * Changes-list refresh interval; slower than the git panel since the launcher
+ * tab is only opened intentionally.
  */
 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, editor, agentSessions, onAgentLaunch, repoPath, cwd, trans } = props;
@@ -53,9 +48,6 @@ 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(() => {
         const poll = new Poll({
             name: '@xtralab/launcher:gitChanges',
@@ -91,12 +83,8 @@ function LauncherDashboardComponent(props) {
         }
     }, [commands, cwd, onAgentLaunch]);
     const launchNotebook = React.useCallback(async () => {
-        // Open a fresh notebook with no kernel attached — equivalent to clicking
-        // "No Kernel" in the Select Kernel dialog. `notebook:create-new` always
-        // routes through that dialog when no kernelName is given, so drive the
-        // underlying docmanager steps directly and pass `shouldStart: false` to
-        // suppress kernel selection. The user picks a kernel from the notebook
-        // toolbar when they're ready.
+        // `notebook:create-new` always opens the Select Kernel dialog when no
+        // kernelName is given, so drive docmanager directly with `shouldStart: false`.
         const file = (await commands.execute('docmanager:new-untitled', {
             path: cwd,
             type: 'notebook'
@@ -110,8 +98,7 @@ function LauncherDashboardComponent(props) {
             kernelPreference: { shouldStart: false, canStart: true }
         }));
         if (result) {
-            // Match `notebook:create-new`'s post-open marker so the first manual
-            // save offers a rename instead of overwriting the auto-generated name.
+            // Match `notebook:create-new`'s marker so the first save offers a rename.
             result.isUntitled = true;
             onAgentLaunch(result);
         }
@@ -128,10 +115,6 @@ function LauncherDashboardComponent(props) {
         if (!editor) {
             return;
         }
-        // An editor is "open a terminal and type its command" — the agent launch
-        // minus the prompt — so it shares `launchInTerminal` rather than the native
-        // `terminal:create-new` call the tiles above use, and tags the session the
-        // same way so the terminals panel badges it with the editor's logo.
         const result = await launchInTerminal(commands, {
             cwd,
             invocation: editor.command,
@@ -153,17 +136,12 @@ function LauncherDashboardComponent(props) {
 function ChangesSection(props) {
     const { git, onOpen, onRefresh, trans } = props;
     const files = git.result ? expandStatusFiles(git.result.files) : [];
-    // Native `<details>` rather than a hand-rolled toggle: we get the
-    // disclosure triangle, keyboard handling, and aria-expanded semantics
-    // for free, and the user's open/closed choice is tab-local state that
-    // we don't need to persist.
     return (React.createElement("details", { className: "jp-xtralab-Launcher-section jp-xtralab-Launcher-changes-section", open: true },
         React.createElement("summary", { className: "jp-xtralab-Launcher-section-summary" },
             React.createElement("span", { className: "jp-xtralab-Launcher-section-title" }, trans.__('Changes')),
             files.length > 0 && (React.createElement("span", { className: "jp-xtralab-Launcher-section-count", "aria-label": trans._n('%1 changed file', '%1 changed files', files.length) }, files.length)),
             React.createElement("button", { type: "button", className: "jp-xtralab-Launcher-section-action", "aria-label": trans.__('Refresh changes'), 
-                // Stop the click from toggling the surrounding `<details>` —
-                // refreshing while the section is open shouldn't collapse it.
+                // Keep the click from toggling the surrounding `<details>`.
                 onClick: event => {
                     event.preventDefault();
                     event.stopPropagation();
@@ -205,9 +183,6 @@ function AgentSection(props) {
     const { agents, prompt, onPromptChange, onLaunch, trans } = props;
     const trimmed = prompt.trim();
     const promptActive = trimmed.length > 0;
-    // 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" },
@@ -236,22 +211,15 @@ function AgentSection(props) {
         }))));
 }
 /**
- * Launcher agents whose CLI has a clean, non-interactive `mcp add` that takes
- * `<name> -- <command>`. The other agents (Goose, OpenCode, Kiro, Mistral
- * Vibe, Antigravity) register MCP through their own config files or UI, so
- * there is no one-line command to surface for them.
+ * Agents whose CLI has a non-interactive `mcp add <name> -- <command>`; the
+ * other agents register MCP through their own config, so no one-liner exists.
  */
 const MCP_ADD_AGENT_IDS = new Set(['claude', 'codex', 'copilot']);
-/**
- * The stdio proxy console script that bridges an agent to the MCP server.
- */
 const MCP_PROXY_COMMAND = 'jupyter-server-mcp-proxy';
 /**
- * Copy `text` to the clipboard via a hidden, selected `<textarea>` and the
- * legacy `execCommand('copy')`. Deprecated, but still the most reliable path
- * under a user gesture when the async Clipboard API is unavailable or blocked
- * (the desktop app's Electron window can deny clipboard writes by policy).
- * Returns whether the copy succeeded.
+ * Copy via a hidden `<textarea>` and the legacy `execCommand('copy')`:
+ * deprecated, but the reliable fallback when the async Clipboard API is
+ * missing or blocked (Electron can deny it by policy). Returns success.
  */
 function legacyCopy(text) {
     try {
@@ -272,13 +240,10 @@ function legacyCopy(text) {
     }
 }
 /**
- * A collapsed-by-default hint listing the one-line command that registers
- * xtralab's running Jupyter MCP server with each installed agent that
- * supports `mcp add`. Copy-only: the user runs it in their own terminal,
- * where the server is reachable with no port to configure — the desktop
- * supervisor exports `JUPYTER_SERVER_MCP_URL`, and `pip` installs let the
- * proxy discover the server from its runtime file. Renders nothing when none
- * of those agents are on `$PATH`.
+ * Collapsed-by-default hint listing the `mcp add` one-liner per installed
+ * agent. Copy-only: run in the user's own terminal, where the proxy finds the
+ * server with no port (desktop exports `JUPYTER_SERVER_MCP_URL`; pip installs
+ * discover it from the runtime file). Renders nothing when no agent qualifies.
  */
 function McpSection(props) {
     const { trans } = props;
@@ -292,9 +257,6 @@ function McpSection(props) {
         window.setTimeout(() => setCopiedId(current => (current === id ? null : current)), 1500);
     };
     const copy = (command, id) => {
-        // Prefer the async Clipboard API; fall back to `legacyCopy` when it's
-        // missing or rejects (Electron can block it by policy). Flag "Copied" only
-        // once a copy actually succeeds.
         const clipboard = navigator.clipboard;
         if (clipboard) {
             void clipboard.writeText(command).then(() => flagCopied(id), () => {
@@ -330,16 +292,8 @@ function McpSection(props) {
                 trans.__('command.')))));
 }
 /**
- * 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).
- *
- * A terminal editor (Neovim, else Vim) joins the row when one is installed —
- * it opens in a terminal like the agents do, so it lives here rather than in
- * the agent grid. When neither is on `$PATH`, `editor` is `null` and no tile
- * renders.
+ * The non-agent launch tiles: terminal, notebook, and console, plus the
+ * terminal editor tile when one is installed (`editor` is `null` otherwise).
  */
 function OpenSection(props) {
     const { editor, onLaunchTerminal, onLaunchNotebook, onLaunchConsole, onLaunchEditor, trans } = props;

package/lib/launcher/editorRegistry.d.ts

@@ -3,41 +3,29 @@ import { Token } from '@lumino/coreutils';
 import { ISignal } from '@lumino/signaling';
 import { type IEditor } from './editors';
 /**
- * A read-only, observable view of the launcher's terminal editors: xtralab's
- * built-ins (Neovim, Vim) merged with the user's `editors` setting, sorted by
- * rank, with disabled entries removed.
+ * A read-only, observable view of the launcher's terminal editors: the
+ * built-ins merged with the user's `editors` setting.
  */
 export interface IEditorRegistry {
     /**
-     * The full merged editor list (disabled entries already removed). The
-     * terminals panel uses it to badge a row for any configured editor that is
-     * running, and to tell the server which editor commands to detect.
+     * The merged editor list (disabled entries removed); the terminals panel
+     * uses it to badge running editors.
      */
     readonly editors: IEditor[];
     /**
-     * The single editor tile the launcher shows: the first editor, by rank, whose
-     * command is on `$PATH` (Neovim before Vim by default), or `null` when none
-     * qualifies.
+     * The single launcher tile: the first editor, by rank, whose command is on
+     * `$PATH`, or `null` when none qualifies.
      */
     readonly current: IEditor | null;
     /**
-     * Emitted whenever {@link editors} or {@link current} changes (the user
-     * edited the `editors` setting). Consumers that read on demand can ignore it.
+     * Emitted whenever {@link editors} or {@link current} changes.
      */
     readonly changed: ISignal<IEditorRegistry, void>;
 }
-/**
- * DI token for {@link IEditorRegistry}. Provided by `xtralab:editor-registry`
- * and consumed — optionally — by `xtralab:launcher` (for its tile) and
- * `xtralab:terminals` (to badge running editors with their logo).
- */
 export declare const IEditorRegistry: Token<IEditorRegistry>;
 /**
- * Provides {@link IEditorRegistry}: merges xtralab's built-in editors with the
- * user's `editors` setting, probes the server's `$PATH` to resolve the launcher
- * tile, and re-runs both on a settings change.
- *
- * `activate` awaits the first probe before returning, so a consumer reading
- * {@link IEditorRegistry.current} on activation sees a resolved tile.
+ * Provides {@link IEditorRegistry}: merges the built-in editors with the
+ * `editors` setting and probes the server's `$PATH`. `activate` awaits the
+ * first probe, so consumers see a resolved tile on activation.
  */
 export declare const editorRegistryPlugin: JupyterFrontEndPlugin<IEditorRegistry>;

package/lib/launcher/editorRegistry.js

@@ -4,15 +4,10 @@ import { Signal } from '@lumino/signaling';
 import { fetchAvailableCommands } from './availability';
 import { mergeEditors, resolveEditor } from './editors';
 import { LAUNCHER_PLUGIN_ID, registerLauncherSchemaDefaults } from './schemaDefaults';
-/**
- * DI token for {@link IEditorRegistry}. Provided by `xtralab:editor-registry`
- * and consumed — optionally — by `xtralab:launcher` (for its tile) and
- * `xtralab:terminals` (to badge running editors with their logo).
- */
 export const IEditorRegistry = new Token('xtralab:IEditorRegistry', 'A read-only, observable view of the launcher terminal editors, shared so the launcher tile and the terminals panel agree on the list and icons.');
 /**
  * Concrete {@link IEditorRegistry}. The provider plugin is the only writer, so
- * the write side ({@link set}) is kept off the shared token.
+ * {@link set} is kept off the shared token.
  */
 class EditorRegistry {
     constructor() {
@@ -20,17 +15,26 @@ class EditorRegistry {
         this._current = null;
         this._changed = new Signal(this);
     }
+    /**
+     * The merged editor list (disabled entries removed).
+     */
     get editors() {
         return this._editors;
     }
+    /**
+     * The launcher-tile editor, or `null` when none qualifies.
+     */
     get current() {
         return this._current;
     }
+    /**
+     * Emitted whenever {@link editors} or {@link current} changes.
+     */
     get changed() {
         return this._changed;
     }
     /**
-     * Replace both lists (recomputed together) and notify observers.
+     * Replace both lists and notify observers.
      */
     set(editors, current) {
         this._editors = editors;
@@ -39,12 +43,9 @@ class EditorRegistry {
     }
 }
 /**
- * Provides {@link IEditorRegistry}: merges xtralab's built-in editors with the
- * user's `editors` setting, probes the server's `$PATH` to resolve the launcher
- * tile, and re-runs both on a settings change.
- *
- * `activate` awaits the first probe before returning, so a consumer reading
- * {@link IEditorRegistry.current} on activation sees a resolved tile.
+ * Provides {@link IEditorRegistry}: merges the built-in editors with the
+ * `editors` setting and probes the server's `$PATH`. `activate` awaits the
+ * first probe, so consumers see a resolved tile on activation.
  */
 export const editorRegistryPlugin = {
     id: 'xtralab:editor-registry',
@@ -56,9 +57,6 @@ export const editorRegistryPlugin = {
         const registry = new EditorRegistry();
         const apply = async (overrides) => {
             const editors = mergeEditors(overrides);
-            // Probe only the editors that opt into the availability check; entries
-            // with `requireAvailable: false` (e.g. a shell alias) are shown
-            // regardless and don't need a `which` lookup.
             const probe = Array.from(new Set(editors
                 .filter(editor => editor.requireAvailable)
                 .map(editor => editor.command)));
@@ -87,8 +85,6 @@ export const editorRegistryPlugin = {
             }
             catch (reason) {
                 console.error('xtralab: failed to load editor settings', reason);
-                // Settings load failed — fall back to the built-in editors so the
-                // launcher tile still resolves instead of going silent.
                 await apply([]);
             }
         }

package/lib/launcher/editors.d.ts

@@ -1,10 +1,9 @@
 import { LabIcon } from '@jupyterlab/ui-components';
 /**
- * A terminal text editor surfaced on the launcher's "Open" section. An editor
- * takes no initial prompt and is launched by typing its command into a fresh
- * terminal (e.g. `nvim`). The launcher shows a single editor tile (the first
- * available candidate; see {@link resolveEditor}); the full list is shared with
- * the terminals panel to badge running editors.
+ * A terminal text editor on the launcher's "Open" section, launched by typing
+ * its command into a fresh terminal. The launcher shows one tile
+ * ({@link resolveEditor}); the full list badges running editors in the
+ * terminals panel.
  */
 export interface IEditor {
     /**
@@ -28,76 +27,71 @@ export interface IEditor {
      */
     icon: LabIcon;
     /**
-     * Preference order for the single launcher tile: the first candidate, by
-     * ascending rank, that qualifies wins (Neovim before Vim by default).
+     * Preference order: the first qualifying candidate by rank wins the tile.
      */
     rank: number;
     /**
-     * When false, the launcher skips the `which`-based availability check for
-     * this entry — useful for a shell alias or function that isn't on PATH but
-     * still resolves when typed in a real terminal. Defaults to true.
+     * When false, skip the `which`-based availability check — for aliases or
+     * shell functions not on PATH. Defaults to true.
      */
     requireAvailable: boolean;
 }
 /**
- * The settings-side shape: every field except `id` is optional, so a user can
- * override a single field on a built-in editor (e.g. swap `vim`'s command for
- * a wrapper) without restating the whole entry. New ids define brand-new
- * editors. Mirrors `IAgentSettings` minus `promptArgs`.
+ * The settings-side shape: every field except `id` is optional so a user can
+ * override a single field on a built-in editor; new ids define new editors.
+ * Mirrors `IAgentSettings` minus `promptArgs`.
  */
 export interface IEditorSettings {
+    /**
+     * Id of the editor to override; a new id defines a new editor.
+     */
     id: string;
+    /**
+     * See {@link IEditor.label}.
+     */
     label?: string;
+    /**
+     * See {@link IEditor.caption}.
+     */
     caption?: string;
+    /**
+     * See {@link IEditor.command}.
+     */
     command?: string;
     /**
-     * Inline SVG for a custom editor's icon. Required for new ids whose icon
-     * isn't shipped with xtralab; ignored for built-in ids unless explicitly
-     * set (in which case it overrides the built-in).
+     * Inline SVG icon. Required for new ids; overrides the built-in when set on
+     * a built-in id.
      */
     iconSvg?: string;
+    /**
+     * See {@link IEditor.rank}.
+     */
     rank?: number;
     /**
-     * When false, the editor is hidden from the launcher's Open section (and no
-     * longer recognised by the terminals panel). Disable both built-ins to drop
-     * the editor tile entirely. Defaults to true.
+     * When false, hides the editor. Disable both built-ins to drop the editor
+     * tile entirely.
      */
     enabled?: boolean;
     /**
-     * See {@link IEditor.requireAvailable}. Defaults to true for a built-in
-     * editor that still uses its shipped command, and to false once you override
-     * the `command` (a user-chosen command — often a shell alias — is trusted and
-     * always shown). Set it explicitly to force the check on or off.
+     * See {@link IEditor.requireAvailable}. Defaults to true, but flips to false
+     * once `command` is overridden (a user-chosen alias is trusted).
      */
     requireAvailable?: boolean;
 }
 /**
- * The built-in editors projected into the JSON settings shape
- * ({@link IEditorSettings}), dropping the runtime-only {@link LabIcon}. Mirrors
- * {@link defaultAgentSettings}: {@link registerLauncherSchemaDefaults} injects
- * this as the `editors` setting's schema default so the Settings Editor shows
- * the shipped list.
+ * The built-in editors projected into the settings shape (no runtime LabIcon),
+ * injected as the `editors` schema default so the Settings Editor shows them.
  */
 export declare function defaultEditorSettings(): IEditorSettings[];
 /**
- * Merge xtralab's built-in editors with the user's `editors` settings. Built-in
- * entries keep their fields unless explicitly overridden; user-only entries are
- * appended. `enabled: false` filters an entry out of the result entirely (so
- * callers don't need to re-check the flag). The result is sorted by rank, which
- * is also the launcher's tile-preference order. Mirrors `mergeAgents`, including
- * turning `requireAvailable` off when the user overrides a built-in's `command`
- * so an aliased editor still shows.
+ * Merge the built-in editors with the user's `editors` settings; the result is
+ * sorted by rank, the tile-preference order. Mirrors `mergeAgents`, including
+ * turning `requireAvailable` off when a built-in's `command` is overridden.
  */
 export declare function mergeEditors(overrides: IEditorSettings[]): IEditor[];
 /**
- * Pick the single editor tile to show, given the merged editor list and the
- * set of commands known to be on `$PATH` (from the launcher's availability
- * probe). Returns the first candidate, by rank, that is either available or
- * opts out of the check (`requireAvailable: false`) — Neovim before Vim by
- * default — or `null` when none qualifies.
- *
- * When `available` is `null` (the endpoint couldn't be reached), a
- * `requireAvailable` editor is not shown; an entry with
- * `requireAvailable: false` is shown regardless.
+ * Pick the single tile: the first editor, by rank, that is available or opts
+ * out of the check, else `null`. When `available` is `null` (probe failed),
+ * only `requireAvailable: false` entries qualify.
  */
 export declare function resolveEditor(editors: IEditor[], available: Set<string> | null): IEditor | null;

package/lib/launcher/editors.js

@@ -1,11 +1,5 @@
 import { LabIcon, textEditorIcon } from '@jupyterlab/ui-components';
 import { BUILTIN_EDITOR_ICONS } from './icons';
-/**
- * Built-in editor candidates in preference order. The launcher shows the first
- * one whose command resolves on the server's `$PATH`, so Neovim wins over Vim
- * when both are installed. Users override, disable, or extend this list
- * through the `editors` setting; see {@link mergeEditors}.
- */
 const DEFAULTS = [
     {
         id: 'nvim',
@@ -27,11 +21,8 @@ const DEFAULTS = [
     }
 ];
 /**
- * The built-in editors projected into the JSON settings shape
- * ({@link IEditorSettings}), dropping the runtime-only {@link LabIcon}. Mirrors
- * {@link defaultAgentSettings}: {@link registerLauncherSchemaDefaults} injects
- * this as the `editors` setting's schema default so the Settings Editor shows
- * the shipped list.
+ * The built-in editors projected into the settings shape (no runtime LabIcon),
+ * injected as the `editors` schema default so the Settings Editor shows them.
  */
 export function defaultEditorSettings() {
     return DEFAULTS.map(editor => ({
@@ -54,13 +45,9 @@ function resolveEditorIcon(id, iconSvg) {
     return (_a = BUILTIN_EDITOR_ICONS[id]) !== null && _a !== void 0 ? _a : textEditorIcon;
 }
 /**
- * Merge xtralab's built-in editors with the user's `editors` settings. Built-in
- * entries keep their fields unless explicitly overridden; user-only entries are
- * appended. `enabled: false` filters an entry out of the result entirely (so
- * callers don't need to re-check the flag). The result is sorted by rank, which
- * is also the launcher's tile-preference order. Mirrors `mergeAgents`, including
- * turning `requireAvailable` off when the user overrides a built-in's `command`
- * so an aliased editor still shows.
+ * Merge the built-in editors with the user's `editors` settings; the result is
+ * sorted by rank, the tile-preference order. Mirrors `mergeAgents`, including
+ * turning `requireAvailable` off when a built-in's `command` is overridden.
  */
 export function mergeEditors(overrides) {
     var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
@@ -86,18 +73,11 @@ export function mergeEditors(overrides) {
                 ? resolveEditorIcon(base.id, override.iconSvg)
                 : base.icon,
             rank: (_d = override.rank) !== null && _d !== void 0 ? _d : base.rank,
-            // See `mergeAgents`: once the user points a built-in editor at their own
-            // command (e.g. a shell alias `which` can't resolve), stop requiring
-            // availability so the tile still shows. The check stays on only while the
-            // command is xtralab's default.
             requireAvailable: command === base.command
                 ? ((_e = override.requireAvailable) !== null && _e !== void 0 ? _e : base.requireAvailable)
                 : false
         });
     }
-    // What remains in `overrideById` are ids that don't match a built-in — treat
-    // them as new editors the user is adding. Skip disabled ones; the settings
-    // schema validates the shape, so missing fields just fall back here.
     let nextRank = merged.reduce((max, editor) => Math.max(max, editor.rank), -1) + 1;
     for (const entry of overrideById.values()) {
         if (entry.enabled === false) {
@@ -119,15 +99,9 @@ export function mergeEditors(overrides) {
     return merged;
 }
 /**
- * Pick the single editor tile to show, given the merged editor list and the
- * set of commands known to be on `$PATH` (from the launcher's availability
- * probe). Returns the first candidate, by rank, that is either available or
- * opts out of the check (`requireAvailable: false`) — Neovim before Vim by
- * default — or `null` when none qualifies.
- *
- * When `available` is `null` (the endpoint couldn't be reached), a
- * `requireAvailable` editor is not shown; an entry with
- * `requireAvailable: false` is shown regardless.
+ * Pick the single tile: the first editor, by rank, that is available or opts
+ * out of the check, else `null`. When `available` is `null` (probe failed),
+ * only `requireAvailable: false` entries qualify.
  */
 export function resolveEditor(editors, available) {
     var _a;

package/lib/launcher/icons.d.ts

@@ -1,15 +1,3 @@
 import { LabIcon } from '@jupyterlab/ui-components';
-/**
- * Built-in icons keyed by the agent's id, used to resolve the icon for an
- * agent declared without an inline `iconSvg` override (i.e. one of xtralab's
- * defaults). Custom agents added via settings can either supply their own
- * `iconSvg` or fall back to the generic terminal icon.
- */
 export declare const BUILTIN_AGENT_ICONS: Record<string, LabIcon>;
-/**
- * Built-in icons keyed by the editor's id, used to resolve the icon for a
- * built-in editor (Neovim, Vim) declared without an inline `iconSvg`. Custom
- * editors added via settings can supply their own `iconSvg` or fall back to
- * the generic text-editor icon.
- */
 export declare const BUILTIN_EDITOR_ICONS: Record<string, LabIcon>;