windows-development-sandbox 1.4.0 → 1.4.3

package/dist/cli/tui/{list-screen.js → list/list-screen.js}

@@ -1,5 +1,5 @@
-import { Text } from './text.js';
-import { Theme } from './theme.js';
+import { Text } from '../text.js';
+import { Theme } from '../theme.js';
 export class ListScreen {
     o;
     category = 0;
@@ -29,7 +29,9 @@ export class ListScreen {
             const label = (id) => this.o.categories?.find((c) => c.id === id)?.label ?? '';
             return all.filter((i) => {
                 const it = this.o.items[i];
-                const hay = [it.label, Text.strip(it.hint ?? ''), it.description, it.keywords, it.section, label(it.category)].join(' ').toLowerCase();
+                const hay = [it.label, Text.strip(it.hint ?? ''), it.description, it.keywords, it.section, label(it.category)]
+                    .join(' ')
+                    .toLowerCase();
                 return words.every((w) => hay.includes(w));
             });
         }
@@ -42,7 +44,9 @@ export class ListScreen {
         const searchAll = Boolean(this.query.trim() && this.o.categories);
         for (const index of visible) {
             const it = this.o.items[index];
-            const heading = searchAll ? [this.o.categories?.find((c) => c.id === it.category)?.label, it.section].filter(Boolean).join(' › ') : it.section;
+            const heading = searchAll
+                ? [this.o.categories?.find((c) => c.id === it.category)?.label, it.section].filter(Boolean).join(' › ')
+                : it.section;
             if (heading && heading !== section)
                 rows.push({ kind: 'section', text: heading });
             section = heading;
@@ -53,19 +57,32 @@ export class ListScreen {
     render(size) {
         const visible = this.visible();
         this.cursor = Math.min(this.cursor, Math.max(0, visible.length - 1));
-        const sideWidth = this.o.categories ? Math.min(32, Math.max(...this.o.categories.map((c) => Text.width(c.label))) + 7) : 0;
+        const sideWidth = this.o.categories
+            ? Math.min(32, Math.max(...this.o.categories.map((c) => Text.width(c.label))) + 7)
+            : 0;
         const rest = size.width - 1 - (sideWidth ? sideWidth + 3 : 0);
         const detailsRight = rest >= 100;
         const detailsWidth = detailsRight ? Math.min(52, Math.floor(rest * 0.38)) : rest;
         const listWidth = detailsRight ? rest - detailsWidth - 3 : rest;
         const top = [];
         if (this.o.tabs)
-            top.push(' ' + this.o.tabs.items.map((tab, i) => (i === this.o.tabs.active ? tab.paint(' ' + tab.badge + ' ' + tab.label + ' ') : Theme.muted('  ' + tab.label + '  '))).join(' ') + Theme.muted('   tab switches'), '');
-        const intro = typeof this.o.intro === 'string' ? [this.o.intro] : this.o.intro ?? [];
+            top.push(' ' +
+                this.o.tabs.items
+                    .map((tab, i) => i === this.o.tabs.active
+                    ? tab.paint(' ' + tab.badge + ' ' + tab.label + ' ')
+                    : Theme.muted('  ' + tab.label + '  '))
+                    .join(' ') +
+                Theme.muted('   tab switches'), '');
+        const intro = typeof this.o.intro === 'string' ? [this.o.intro] : (this.o.intro ?? []);
         for (const line of intro)
             top.push(...Text.wrap(line, size.width - 3).map((l) => ' ' + Theme.muted(l)));
         if (this.searching || this.query)
-            top.push(' ' + Theme.accent(Theme.glyph.search) + ' ' + this.query + (this.searching ? Theme.accent('▏') : '') + Theme.muted('   ' + visible.length + ' match' + (visible.length === 1 ? '' : 'es')));
+            top.push(' ' +
+                Theme.accent(Theme.glyph.search) +
+                ' ' +
+                this.query +
+                (this.searching ? Theme.accent('▏') : '') +
+                Theme.muted('   ' + visible.length + ' match' + (visible.length === 1 ? '' : 'es')));
         if (top.length)
             top.push('');
         const details = this.detailsLines(visible[this.cursor], detailsWidth);
@@ -84,13 +101,19 @@ export class ListScreen {
                 this.offset = cursorRow - listHeight + 1;
         }
         this.offset = Math.max(0, Math.min(this.offset, Math.max(0, rows.length - listHeight)));
-        const listLines = rows.slice(this.offset, this.offset + listHeight).map((row) => this.rowLine(row, visible, listWidth));
+        const listLines = rows
+            .slice(this.offset, this.offset + listHeight)
+            .map((row) => this.rowLine(row, visible, listWidth));
         if (!visible.length)
-            listLines.push('', '  ' + Theme.muted(this.query ? 'Nothing matches "' + this.query + '".' : this.o.empty ?? 'Nothing here yet.'));
+            listLines.push('', '  ' +
+                Theme.muted(this.query ? 'Nothing matches "' + this.query + '".' : (this.o.empty ?? 'Nothing here yet.')));
         if (rows.length > listHeight) {
             const above = this.offset;
             const below = rows.length - this.offset - listHeight;
-            listLines.push(Theme.muted('   ' + (above > 0 ? '▲ ' + above + ' above' : '') + (above > 0 && below > 0 ? '   ' : '') + (below > 0 ? '▼ ' + below + ' more' : '')));
+            listLines.push(Theme.muted('   ' +
+                (above > 0 ? '▲ ' + above + ' above' : '') +
+                (above > 0 && below > 0 ? '   ' : '') +
+                (below > 0 ? '▼ ' + below + ' more' : '')));
         }
         const sideLines = this.sideLines(sideWidth);
         const body = [...top];
@@ -104,7 +127,9 @@ export class ListScreen {
         if (bottomDetails.length) {
             // The details sit at the bottom, whatever the length of the list.
             while (body.length < size.height - bottomDetails.length - 1)
-                body.push(sideWidth ? Text.fit(sideLines[body.length - top.length] ?? '', sideWidth) + ' ' + Theme.dim(Theme.glyph.vline) : '');
+                body.push(sideWidth
+                    ? Text.fit(sideLines[body.length - top.length] ?? '', sideWidth) + ' ' + Theme.dim(Theme.glyph.vline)
+                    : '');
             body.push(Theme.dim(' ' + Theme.glyph.line.repeat(size.width - 3)), ...bottomDetails.map((l) => ' ' + l));
         }
         return { path: this.o.path, status: this.o.status, body, keys: this.keys(), notice: this.notice };
@@ -114,13 +139,21 @@ export class ListScreen {
             return ' ' + Theme.accentBold(row.text);
         const it = this.o.items[row.index];
         const selected = visible[this.cursor] === row.index;
-        const box = this.o.multi ? (this.checked.has(row.index) ? Theme.ok(Theme.glyph.checked) : Theme.muted(Theme.glyph.unchecked)) + ' ' : '';
+        const box = this.o.multi
+            ? (this.checked.has(row.index) ? Theme.ok(Theme.glyph.checked) : Theme.muted(Theme.glyph.unchecked)) + ' '
+            : '';
         const icon = it.icon ? it.icon + ' ' : '';
         const hint = it.hint ?? '';
         const hintWidth = Math.min(Text.width(hint), Math.floor(width * 0.5));
         const labelWidth = width - 4 - Text.width(box) - Text.width(icon) - (hintWidth ? hintWidth + 2 : 0);
         const label = it.disabled ? Theme.muted(it.label) : it.label;
-        const line = (selected ? Theme.glyph.pointer : ' ') + ' ' + box + icon + Text.fit(label, labelWidth) + (hintWidth ? '  ' + Text.fit(hint, hintWidth, 'right') : '') + ' ';
+        const line = (selected ? Theme.glyph.pointer : ' ') +
+            ' ' +
+            box +
+            icon +
+            Text.fit(label, labelWidth) +
+            (hintWidth ? '  ' + Text.fit(hint, hintWidth, 'right') : '') +
+            ' ';
         if (!selected)
             return ' ' + line;
         return this.focus === 'list' ? ' ' + Theme.selected(Text.strip(line)) : ' ' + Theme.accent(Text.strip(line));
@@ -140,7 +173,10 @@ export class ListScreen {
         const w = Math.max(10, width - 1);
         if (this.focus === 'side' && this.o.categories) {
             const cat = this.o.categories[this.category];
-            return [Theme.bold(cat.label), ...(cat.description ? Text.wrap(cat.description, w).map((l) => Theme.muted(l)) : [])];
+            return [
+                Theme.bold(cat.label),
+                ...(cat.description ? Text.wrap(cat.description, w).map((l) => Theme.muted(l)) : []),
+            ];
         }
         if (index === undefined)
             return [];
@@ -154,24 +190,41 @@ export class ListScreen {
     }
     keys() {
         if (this.searching)
-            return [['type', 'to search'], ['↑↓', 'move'], ['↵', this.o.multi ? 'done' : 'open'], ['esc', 'clear search']];
+            return [
+                ['type', 'to search'],
+                ['↑↓', 'move'],
+                ['↵', this.o.multi ? 'done' : 'open'],
+                ['esc', 'clear search'],
+            ];
         return [
             ['↑↓', 'move'],
-            ...(this.o.tabs ? [['tab', 'switch ' + this.o.tabs.items.map((t) => t.label.toLowerCase()).join(' / ')]] : []),
+            ...(this.o.tabs
+                ? [['tab', 'switch ' + this.o.tabs.items.map((t) => t.label.toLowerCase()).join(' / ')]]
+                : []),
             ...(this.o.categories ? [['←→', 'categories']] : []),
-            ...(this.o.multi ? [['space', 'tick'], ['a', 'tick all shown'], ['↵', 'done']] : [['↵', 'open']]),
+            ...(this.o.multi
+                ? [
+                    ['space', 'tick'],
+                    ['a', 'tick all shown'],
+                    ['↵', 'done'],
+                ]
+                : [['↵', 'open']]),
             ['/', 'search'],
             ...(this.o.actions ?? []).map((a) => [a.key, a.label]),
             ['esc', this.o.escapeLabel ?? 'back'],
         ];
     }
     /** Programmatic notice (e.g. "Saved") shown until the next key. */
-    setNotice(text) { this.notice = text; }
+    setNotice(text) {
+        this.notice = text;
+    }
     handle(key) {
         const visible = this.visible();
         const current = visible[this.cursor];
         this.notice = undefined;
-        const move = (by) => { this.cursor = Math.max(0, Math.min(visible.length - 1, this.cursor + by)); };
+        const move = (by) => {
+            this.cursor = Math.max(0, Math.min(visible.length - 1, this.cursor + by));
+        };
         if (key.name === 'up') {
             if (this.focus === 'side')
                 this.switchCategory(-1);
@@ -263,9 +316,13 @@ export class ListScreen {
                 return;
             }
             if (key.name === 'return')
-                return { done: { kind: 'multi', values: this.o.items.filter((_, i) => this.checked.has(i)).map((it) => it.value) } };
+                return {
+                    done: { kind: 'multi', values: this.o.items.filter((_, i) => this.checked.has(i)).map((it) => it.value) },
+                };
         }
-        if ((key.name === 'return' || key.name === 'right' || (key.name === 'space' && !this.searching)) && current !== undefined && !this.o.multi) {
+        if ((key.name === 'return' || key.name === 'right' || (key.name === 'space' && !this.searching)) &&
+            current !== undefined &&
+            !this.o.multi) {
             const it = this.o.items[current];
             if (it.disabled) {
                 this.notice = Theme.warn(it.disabled);
@@ -275,7 +332,13 @@ export class ListScreen {
         }
         const action = !this.searching && key.text ? this.o.actions?.find((a) => a.key === key.text) : undefined;
         if (action)
-            return { done: { kind: 'action', key: action.key, value: current === undefined ? undefined : this.o.items[current].value } };
+            return {
+                done: {
+                    kind: 'action',
+                    key: action.key,
+                    value: current === undefined ? undefined : this.o.items[current].value,
+                },
+            };
         return;
     }
     toggle(index) {

package/dist/cli/tui/{list-screen.d.ts → list/list-types.d.ts}

@@ -1,6 +1,3 @@
-import type { FrameParts } from './frame.js';
-import type { Screen, Size, Step } from './app.js';
-import type { Key } from './terminal.js';
 export interface ListItem<T> {
     value: T;
     label: string;
@@ -74,28 +71,3 @@ export interface ListOptions<T> {
     /** What Esc does, for the footer ("back", "quit"). */
     escapeLabel?: string;
 }
-export declare class ListScreen<T> implements Screen<ListResult<T>> {
-    private readonly o;
-    private category;
-    private focus;
-    private cursor;
-    private offset;
-    private query;
-    private searching;
-    private notice;
-    private readonly checked;
-    constructor(o: ListOptions<T>);
-    /** Indexes of the entries shown now: all matches of the search, else the current category's, else all. */
-    private visible;
-    private rows;
-    render(size: Size): FrameParts;
-    private rowLine;
-    private sideLines;
-    private detailsLines;
-    private keys;
-    /** Programmatic notice (e.g. "Saved") shown until the next key. */
-    setNotice(text: string | undefined): void;
-    handle(key: Key): Step<ListResult<T>>;
-    private toggle;
-    private switchCategory;
-}

package/dist/cli/tui/screen.d.ts

@@ -0,0 +1,14 @@
+import { type FrameParts } from './frame.js';
+import { type Key } from './terminal.js';
+export interface Size {
+    width: number;
+    height: number;
+}
+/** What a screen's key handler returns: `{ done: value }` ends the screen, nothing keeps it open (and redraws it). */
+export type Step<T> = {
+    done: T;
+} | undefined | void;
+export interface Screen<T> {
+    render(size: Size): FrameParts;
+    handle(key: Key): Step<T> | Promise<Step<T>>;
+}

package/dist/cli/tui/terminal.js

@@ -5,7 +5,10 @@ import readline from 'node:readline';
 import { Text } from './text.js';
 /** Ctrl+C: leave the menu at once (callers let it propagate to the top). */
 export class ExitRequested extends Error {
-    constructor() { super('Ctrl+C'); this.name = 'ExitPromptError'; }
+    constructor() {
+        super('Ctrl+C');
+        this.name = 'ExitPromptError';
+    }
 }
 export class Terminal {
     stdin;
@@ -16,15 +19,24 @@ export class Terminal {
     waiting = null;
     resizeHandler = null;
     onKeypress = (str, key) => this.push(str, key);
-    onResize = () => { this.frame = []; this.resizeHandler?.(); };
+    onResize = () => {
+        this.frame = [];
+        this.resizeHandler?.();
+    };
     constructor(stdin = process.stdin, stdout = process.stdout) {
         this.stdin = stdin;
         this.stdout = stdout;
     }
-    get width() { return Math.max(40, this.stdout.columns ?? 80); }
-    get height() { return Math.max(12, this.stdout.rows ?? 30); }
+    get width() {
+        return Math.max(40, this.stdout.columns ?? 80);
+    }
+    get height() {
+        return Math.max(12, this.stdout.rows ?? 30);
+    }
     /** Called after the window was resized (the screen draws itself again). */
-    onResized(handler) { this.resizeHandler = handler; }
+    onResized(handler) {
+        this.resizeHandler = handler;
+    }
     start() {
         if (this.active)
             return;
@@ -51,15 +63,19 @@ export class Terminal {
         this.queue = [];
         this.stdout.write('\x1b[0m\x1b[?25h\x1b[?1049l');
     }
-    get running() { return this.active; }
+    get running() {
+        return this.active;
+    }
     /** Draws a whole screen: `lines` are cut to the width and padded to the height; unchanged rows are not rewritten. */
     render(lines) {
         const { width, height } = this;
         // One column is left free: writing the last column can scroll older consoles.
         const rows = Array.from({ length: height }, (_, i) => Text.fit(lines[i] ?? '', width - 1));
         let out = '';
-        rows.forEach((row, i) => { if (this.frame[i] !== row)
-            out += '\x1b[' + (i + 1) + ';1H' + row + '\x1b[0m'; });
+        rows.forEach((row, i) => {
+            if (this.frame[i] !== row)
+                out += '\x1b[' + (i + 1) + ';1H' + row + '\x1b[0m';
+        });
         if (this.frame.length !== rows.length)
             out = '\x1b[H\x1b[2J' + rows.map((r, i) => '\x1b[' + (i + 1) + ';1H' + r + '\x1b[0m').join('');
         this.frame = rows;
@@ -71,10 +87,18 @@ export class Terminal {
         const next = this.queue.shift();
         if (next)
             return next.ctrl && next.name === 'c' ? Promise.reject(new ExitRequested()) : Promise.resolve(next);
-        return new Promise((resolve, reject) => { this.waiting = { resolve, reject }; });
+        return new Promise((resolve, reject) => {
+            this.waiting = { resolve, reject };
+        });
     }
     push(str, key) {
-        const event = { name: key?.name ?? '', text: str && !key?.ctrl && !key?.meta && str.length >= 1 && str >= ' ' && str !== '\x7f' ? str : '', ctrl: Boolean(key?.ctrl), meta: Boolean(key?.meta), shift: Boolean(key?.shift) };
+        const event = {
+            name: key?.name ?? '',
+            text: str && !key?.ctrl && !key?.meta && str.length >= 1 && str >= ' ' && str !== '\x7f' ? str : '',
+            ctrl: Boolean(key?.ctrl),
+            meta: Boolean(key?.meta),
+            shift: Boolean(key?.shift),
+        };
         const waiting = this.waiting;
         if (!waiting) {
             this.queue.push(event);

package/dist/cli/tui/text.d.ts

@@ -6,7 +6,8 @@ export declare class Text {
     /** Columns `text` takes on screen. */
     static width(text: string): number;
     /**
-     * The first `max` columns of `text`, keeping colour codes (and closing them), with an ellipsis when something was cut.
+     * The first `max` columns of `text`, keeping colour codes (and closing them), with an ellipsis when something was
+     * cut.
      */
     static truncate(text: string, max: number, ellipsis?: string): string;
     /** `text` cut or padded with spaces to exactly `width` columns. */

package/dist/cli/tui/text.js

@@ -12,9 +12,15 @@ export class Text {
             return 0;
         if ((code >= 0x300 && code <= 0x36f) || (code >= 0x200b && code <= 0x200f) || code === 0xfe0f)
             return 0;
-        const wide = (code >= 0x1100 && code <= 0x115f) || (code >= 0x2e80 && code <= 0xa4cf) || (code >= 0xac00 && code <= 0xd7a3)
-            || (code >= 0xf900 && code <= 0xfaff) || (code >= 0xfe30 && code <= 0xfe4f) || (code >= 0xff00 && code <= 0xff60)
-            || (code >= 0xffe0 && code <= 0xffe6) || (code >= 0x1f300 && code <= 0x1faff) || (code >= 0x20000 && code <= 0x3fffd);
+        const wide = (code >= 0x1100 && code <= 0x115f) ||
+            (code >= 0x2e80 && code <= 0xa4cf) ||
+            (code >= 0xac00 && code <= 0xd7a3) ||
+            (code >= 0xf900 && code <= 0xfaff) ||
+            (code >= 0xfe30 && code <= 0xfe4f) ||
+            (code >= 0xff00 && code <= 0xff60) ||
+            (code >= 0xffe0 && code <= 0xffe6) ||
+            (code >= 0x1f300 && code <= 0x1faff) ||
+            (code >= 0x20000 && code <= 0x3fffd);
         return wide ? 2 : 1;
     }
     /** Columns `text` takes on screen. */
@@ -25,7 +31,8 @@ export class Text {
         return width;
     }
     /**
-     * The first `max` columns of `text`, keeping colour codes (and closing them), with an ellipsis when something was cut.
+     * The first `max` columns of `text`, keeping colour codes (and closing them), with an ellipsis when something was
+     * cut.
      */
     static truncate(text, max, ellipsis = '…') {
         if (max <= 0)
@@ -98,8 +105,31 @@ export class Text {
     }
     /** "memoryMb" -> "Memory MB", "vGpu" -> "V GPU": a readable label from a setting's key. */
     static humanize(key) {
-        const words = key.replace(/([a-z0-9])([A-Z])/g, '$1 $2').replace(/[_-]+/g, ' ').split(' ').filter(Boolean);
-        const upper = new Set(['mb', 'gb', 'cpu', 'gpu', 'jdk', 'sdk', 'id', 'url', 'ui', 'npm', 'msvc', 'uv', 'api', 'ssh', 'vm', 'io']);
-        return words.map((w, i) => (upper.has(w.toLowerCase()) ? w.toUpperCase() : i === 0 ? w[0].toUpperCase() + w.slice(1) : w.toLowerCase())).join(' ');
+        const words = key
+            .replace(/([a-z0-9])([A-Z])/g, '$1 $2')
+            .replace(/[_-]+/g, ' ')
+            .split(' ')
+            .filter(Boolean);
+        const upper = new Set([
+            'mb',
+            'gb',
+            'cpu',
+            'gpu',
+            'jdk',
+            'sdk',
+            'id',
+            'url',
+            'ui',
+            'npm',
+            'msvc',
+            'uv',
+            'api',
+            'ssh',
+            'vm',
+            'io',
+        ]);
+        return words
+            .map((w, i) => upper.has(w.toLowerCase()) ? w.toUpperCase() : i === 0 ? w[0].toUpperCase() + w.slice(1) : w.toLowerCase())
+            .join(' ');
     }
 }

package/dist/cli/tui/theme.js

@@ -1,6 +1,6 @@
 // The look of every screen: colours (off with NO_COLOR, like the rest of the CLI) and the line-drawing characters.
-import { colorEnabled } from '../colors.js';
-const sgr = (open, close = '0') => (text) => (Theme.colour ? '\x1b[' + open + 'm' + text + '\x1b[' + close + 'm' : text);
+import { colorEnabled } from '../output/index.js';
+const sgr = (open, close = '0') => (text) => Theme.colour ? '\x1b[' + open + 'm' + text + '\x1b[' + close + 'm' : text;
 export class Theme {
     /** Colour is decided once per run: the menu only runs in a terminal. */
     static colour = colorEnabled(process.env, Boolean(process.stdout.isTTY));
@@ -15,16 +15,34 @@ export class Theme {
     static muted = sgr('38;5;245', '39');
     static changed = sgr('38;5;221', '39');
     /** The highlighted row: a soft background bar across the whole width. */
-    static selected = (t) => (Theme.colour ? '\x1b[48;5;24m\x1b[97m' + t.replace(/\x1b\[0m/g, '\x1b[0m\x1b[48;5;24m\x1b[97m') + '\x1b[0m' : t);
+    static selected = (t) => Theme.colour ? '\x1b[48;5;24m\x1b[97m' + t.replace(/\x1b\[0m/g, '\x1b[0m\x1b[48;5;24m\x1b[97m') + '\x1b[0m' : t;
     /** The header bar. */
-    static bar = (t) => (Theme.colour ? '\x1b[48;5;236m\x1b[97m' + t.replace(/\x1b\[0m/g, '\x1b[0m\x1b[48;5;236m\x1b[97m') + '\x1b[0m' : t);
+    static bar = (t) => Theme.colour ? '\x1b[48;5;236m\x1b[97m' + t.replace(/\x1b\[0m/g, '\x1b[0m\x1b[48;5;236m\x1b[97m') + '\x1b[0m' : t;
     /** The two settings scopes: your own (blue) and the project's (purple). */
-    static scopeGlobal = (t) => (Theme.colour ? '\x1b[48;5;25m\x1b[97m\x1b[1m' + t + '\x1b[0m' : '[' + t + ']');
-    static scopeProject = (t) => (Theme.colour ? '\x1b[48;5;91m\x1b[97m\x1b[1m' + t + '\x1b[0m' : '[' + t + ']');
+    static scopeGlobal = (t) => Theme.colour ? '\x1b[48;5;25m\x1b[97m\x1b[1m' + t + '\x1b[0m' : '[' + t + ']';
+    static scopeProject = (t) => Theme.colour ? '\x1b[48;5;91m\x1b[97m\x1b[1m' + t + '\x1b[0m' : '[' + t + ']';
     static project = sgr('38;5;177', '39');
-    static key = (t) => (Theme.colour ? '\x1b[48;5;238m\x1b[97m ' + t + ' \x1b[0m' : '[' + t + ']');
+    static key = (t) => Theme.colour ? '\x1b[48;5;238m\x1b[97m ' + t + ' \x1b[0m' : '[' + t + ']';
     static glyph = {
-        pointer: '›', bullet: '•', on: '●', off: '○', checked: '◉', unchecked: '◯', dot: '·', arrow: '→', back: '←', more: '…',
-        folder: '▸', open: '▾', line: '─', vline: '│', search: '⌕', changed: '✎', lock: '⚿', ok: '✔', cross: '✘', star: '★',
+        pointer: '›',
+        bullet: '•',
+        on: '●',
+        off: '○',
+        checked: '◉',
+        unchecked: '◯',
+        dot: '·',
+        arrow: '→',
+        back: '←',
+        more: '…',
+        folder: '▸',
+        open: '▾',
+        line: '─',
+        vline: '│',
+        search: '⌕',
+        changed: '✎',
+        lock: '⚿',
+        ok: '✔',
+        cross: '✘',
+        star: '★',
     };
 }

package/dist/cli/validate.d.ts

@@ -1,17 +1,17 @@
 import type { Context } from './commands/context.js';
 /** Edit distance, for "did you mean". */
-export declare const distance: (a: string, b: string) => number;
+export declare function distance(a: string, b: string): number;
 /** The closest of `choices` to `input`, when it is close enough to be a typo. */
-export declare const closest: (input: string, choices: readonly string[]) => string | undefined;
+export declare function closest(input: string, choices: readonly string[]): string | undefined;
 /** "Unknown agent "cluade". Did you mean claude?" with the valid values as the fix. */
-export declare const unknownValue: (what: string, input: string, choices: readonly string[], howToList: string) => never;
+export declare function unknownValue(what: string, input: string, choices: readonly string[], howToList: string): never;
 /** Node: 22, 22.1, v22.1.0, lts, lts/*, lts/iron, latest, current, node. */
-export declare const validNodeSpec: (spec: string) => boolean;
+export declare function validNodeSpec(spec: string): boolean;
 /** Python 3: 3, 3.12, 3.12.4. */
-export declare const validPythonSpec: (spec: string) => boolean;
-export declare const checkHarness: (name: string | undefined, harnesses: string[]) => void;
+export declare function validPythonSpec(spec: string): boolean;
+export declare function checkHarness(name: string | undefined, harnesses: string[]): void;
 export declare const PROJECT_ACTIONS: readonly ["list", "choose", "add", "remove", "include", "exclude", "all", "roots"];
 /** `sandbox projects <action> [value] [folder]`: the action, then what it needs. Pure (no file checks). */
-export declare const validateProjectsArgs: (args: string[]) => void;
+export declare function validateProjectsArgs(args: string[]): void;
 /** Fails with what is wrong and what is valid, before anything is started. */
-export declare const validateOptions: (ctx: Context) => void;
+export declare function validateOptions(ctx: Context): void;

package/dist/cli/validate.js

@@ -2,11 +2,11 @@
 // instead of halfway into a sandbox boot. Pure helpers first, then validateOptions (the one call from the dispatcher).
 import fs from 'node:fs';
 import path from 'node:path';
-import { DATABASES } from '../core/detect-databases.js';
-import { fail } from '../core/util.js';
-import { listAccounts } from '../host/accounts.js';
+import { DATABASES } from '../core/detect/index.js';
+import { fail } from '../core/util/index.js';
+import { AccountStore } from '../host/profile/index.js';
 /** Edit distance, for "did you mean". */
-export const distance = (a, b) => {
+export function distance(a, b) {
     let row = Array.from({ length: b.length + 1 }, (_, i) => i);
     for (let i = 1; i <= a.length; i++) {
         const next = [i];
@@ -15,30 +15,36 @@ export const distance = (a, b) => {
         row = next;
     }
     return row[b.length];
-};
+}
 /** The closest of `choices` to `input`, when it is close enough to be a typo. */
-export const closest = (input, choices) => {
-    const best = choices.map((c) => ({ c, d: distance(input.toLowerCase(), c.toLowerCase()) })).sort((x, y) => x.d - y.d)[0];
+export function closest(input, choices) {
+    const best = choices
+        .map((c) => ({ c, d: distance(input.toLowerCase(), c.toLowerCase()) }))
+        .sort((x, y) => x.d - y.d)[0];
     return best && best.d <= Math.max(2, Math.floor(input.length / 3)) ? best.c : undefined;
-};
+}
 /** "Unknown agent "cluade". Did you mean claude?" with the valid values as the fix. */
-export const unknownValue = (what, input, choices, howToList) => {
+export function unknownValue(what, input, choices, howToList) {
     const hint = closest(input, choices);
     return fail('Unknown ' + what + ' "' + input + '".' + (hint ? ' Did you mean ' + hint + '?' : ''), (choices.length ? 'Choose one of: ' + choices.join(', ') + '. ' : '') + howToList);
-};
+}
 /** Node: 22, 22.1, v22.1.0, lts, lts/*, lts/iron, latest, current, node. */
-export const validNodeSpec = (spec) => /^(v?\d+(\.\d+){0,2}|node|latest|current|stable|lts(\/(\*|[a-z]+))?)$/i.test(spec.trim());
+export function validNodeSpec(spec) {
+    return /^(v?\d+(\.\d+){0,2}|node|latest|current|stable|lts(\/(\*|[a-z]+))?)$/i.test(spec.trim());
+}
 /** Python 3: 3, 3.12, 3.12.4. */
-export const validPythonSpec = (spec) => /^v?3(\.\d+){0,2}$/.test(spec.trim());
-export const checkHarness = (name, harnesses) => {
+export function validPythonSpec(spec) {
+    return /^v?3(\.\d+){0,2}$/.test(spec.trim());
+}
+export function checkHarness(name, harnesses) {
     if (name !== undefined && !harnesses.includes(name))
         unknownValue('agent', name, harnesses, 'Add your own under "harnesses" in your settings (sandbox config).');
-};
+}
 /** Commands that read these options; checked only for them (restart/doctor take --harness too). */
 const LAUNCHING = new Set(['launch', 'generate', 'host-claude']);
 export const PROJECT_ACTIONS = ['list', 'choose', 'add', 'remove', 'include', 'exclude', 'all', 'roots'];
 /** `sandbox projects <action> [value] [folder]`: the action, then what it needs. Pure (no file checks). */
-export const validateProjectsArgs = (args) => {
+export function validateProjectsArgs(args) {
     const [action = 'list', value, folder] = args;
     if (!PROJECT_ACTIONS.includes(action))
         unknownValue('projects action', action, PROJECT_ACTIONS, 'sandbox projects with no action lists your projects.');
@@ -50,9 +56,9 @@ export const validateProjectsArgs = (args) => {
         unknownValue('projects roots action', value, ['list', 'add', 'remove'], 'sandbox projects roots add|remove <folder>');
     if (action === 'roots' && (value === 'add' || value === 'remove') && !folder)
         fail('Which folder?', 'Usage: sandbox projects roots ' + value + ' <folder>');
-};
+}
 /** Fails with what is wrong and what is valid, before anything is started. */
-export const validateOptions = (ctx) => {
+export function validateOptions(ctx) {
     const o = ctx.options;
     const harnesses = Object.keys(ctx.loaded.config.harnesses);
     if (['launch', 'generate', 'restart', 'doctor'].includes(o.command))
@@ -65,14 +71,19 @@ export const validateOptions = (ctx) => {
         fail('"' + o.node + '" is not a Node version.', 'Use a number like 22 or 22.11.0, or lts, latest.');
     if (o.python !== undefined && !validPythonSpec(o.python))
         fail('"' + o.python + '" is not a Python 3 version.', 'Use 3, 3.12 or 3.12.4.');
-    for (const db of o.databases.flatMap((d) => d.split(',')).map((d) => d.trim()).filter(Boolean)) {
+    for (const db of o.databases
+        .flatMap((d) => d.split(','))
+        .map((d) => d.trim())
+        .filter(Boolean)) {
         if (!DATABASES.includes(db))
             unknownValue('database', db, DATABASES, 'Repeat --database for several.');
     }
     if (o.account !== undefined) {
-        const names = listAccounts(ctx.storageRoot, ctx.dataPath).map((a) => a.name);
+        const names = new AccountStore(ctx.storageRoot).list(ctx.dataPath).map((a) => a.name);
         if (!names.includes(o.account))
-            unknownValue('account', o.account, names, names.length ? 'See them with: sandbox account list' : 'None saved yet: sign in inside the sandbox, then run sandbox account save <name>.');
+            unknownValue('account', o.account, names, names.length
+                ? 'See them with: sandbox account list'
+                : 'None saved yet: sign in inside the sandbox, then run sandbox account save <name>.');
     }
     for (const s of o.sessions) {
         checkHarness(s.harness, harnesses);
@@ -86,4 +97,4 @@ export const validateOptions = (ctx) => {
     for (const script of o.scripts)
         if (!fs.existsSync(path.resolve(script)))
             fail('The script ' + path.resolve(script) + ' does not exist.', 'Check the --script path.');
-};
+}

package/dist/core/config/defaults.d.ts

@@ -0,0 +1,2 @@
+import type { Config } from '../types.js';
+export declare const DEFAULTS: Config;