windows-development-sandbox 1.10.0 → 1.11.4

package/dist/cli/menu/apps.js

@@ -1,214 +0,0 @@
-// The apps catalogue as data for the Apps tab: every app by category, ticked = installed in every sandbox. VS Code and
-// Windows Terminal are listed too (they have settings of their own, which ticking changes). Ticks are staged in the
-// Draft and written with Ctrl+S, to your config file or (catalogue apps only) the project's .sandbox-config.json.
-import fs from 'node:fs';
-import path from 'node:path';
-import _ from 'lodash';
-import { APPS } from '../../shared/apps/index.js';
-import { Text, Theme } from '../tui/index.js';
-export const CUSTOM = '@custom:';
-/** The catalogue has many small categories; the menu shows these few groups so the navigation stays short. */
-export const APP_GROUPS = [
-    {
-        id: 'editors',
-        label: 'Editors & docs',
-        description: 'Code and text editors (VS Code is on by default), plus diagrams and document conversion.',
-        members: ['editors', 'diagrams'],
-    },
-    {
-        id: 'clients',
-        label: 'DB & API clients',
-        description: 'GUIs for the sandbox databases, tools to send HTTP, REST and GraphQL requests, and to inspect traffic.',
-        members: ['databases', 'api', 'network'],
-    },
-    {
-        id: 'tools',
-        label: 'Git & utilities',
-        description: 'Git GUIs and terminal UIs, archives, file search and comparing, process tools, and decompilers.',
-        members: ['git', 'utilities', 'reversing'],
-    },
-    {
-        id: 'cli',
-        label: 'Command-line & cloud',
-        description: 'Small developer tools (JSON, search, builds, media ...) and tools for clouds and Kubernetes.',
-        members: ['cli', 'cloud'],
-    },
-    {
-        id: 'play',
-        label: 'Browsers & games',
-        description: 'Browsers for testing web apps, and game engines and editors (they draw with OpenGL on the CPU).',
-        members: ['browsers', 'gamedev'],
-    },
-];
-/** The group an app category is shown under. */
-export function groupOf(category) {
-    return APP_GROUPS.find((g) => g.members.includes(category))?.id ?? 'tools';
-}
-const INSTALL = ['apps', 'install'];
-/** The row in Apps that opens the "request an app" issue form (its id is not an app). */
-export const REQUEST_APP = '@request-app';
-/** This project's new-issue page on GitHub. */
-export const ISSUES_URL = 'https://github.com/JoshDiDuca/windows-development-sandbox/issues/new';
-/** The new-issue address with a title and a body to fill in (the page needs no login to show it). */
-export function requestAppUrl() {
-    const body = [
-        '**App name:**',
-        '',
-        '**Where to get it** (GitHub releases page or a direct download link):',
-        '',
-        '**What it is for:**',
-        '',
-        '**Command-line tool or desktop app?**',
-        '',
-        '**Does it need a GPU, a license or an account?**',
-    ].join('\n');
-    const query = [
-        ['title', 'App request: '],
-        ['body', body],
-        ['labels', 'app-request'],
-    ];
-    return ISSUES_URL + '?' + query.map(([k, v]) => k + '=' + encodeURIComponent(v)).join('&');
-}
-export class AppsModel {
-    file;
-    dataPath;
-    constructor(file, dataPath) {
-        this.file = file;
-        this.dataPath = dataPath;
-    }
-    /** The catalogue entries this file can change (a project cannot change an app that has a setting of its own). */
-    entries() {
-        return APPS.filter((a) => !(this.file.isProject && a.setting));
-    }
-    categories() {
-        return [
-            ...APP_GROUPS.map(({ id, label, description }) => ({ id, label, description })),
-            ...(this.file.isProject
-                ? []
-                : [
-                    {
-                        id: 'custom',
-                        label: 'Your own programs',
-                        description: 'Programs you added yourself (c to add or change them).',
-                    },
-                ]),
-        ];
-    }
-    /** Downloaded already (into this data folder), so the next sandbox starts it without a download. */
-    installed(entry) {
-        if (entry.id === 'vscode')
-            return fs.existsSync(path.join(this.dataPath, 'tools', 'vscode', 'Code.exe'));
-        if (entry.id === 'windows-terminal')
-            return fs.existsSync(path.join(this.dataPath, 'tools', 'terminal', 'WindowsTerminal.exe'));
-        return fs.existsSync(path.join(this.dataPath, 'tools', 'apps', entry.id, '.agent-sandbox-app'));
-    }
-    savedInstall() {
-        return ((this.file.isProject ? this.file.valueInFile(INSTALL) : this.file.userConfig().apps.install) ?? []);
-    }
-    /** Is the entry on in the saved file? */
-    savedOn(entry) {
-        return entry.setting
-            ? _.get(this.file.userConfig(), entry.setting) === true
-            : this.savedInstall().includes(entry.id);
-    }
-    /** Is the entry on once the staged changes are saved? */
-    isOn(entry, draft) {
-        if (entry.setting) {
-            const key = entry.setting.split('.');
-            return draft.has(this.file, key) ? draft.value(this.file, key) === true : this.savedOn(entry);
-        }
-        const staged = draft.has(this.file, INSTALL)
-            ? draft.value(this.file, INSTALL)
-            : undefined;
-        return draft.has(this.file, INSTALL) ? (staged ?? []).includes(entry.id) : this.savedOn(entry);
-    }
-    /** Your own programs (apps.custom), staged or saved. */
-    custom(draft) {
-        if (this.file.isProject)
-            return {};
-        const key = ['apps', 'custom'];
-        return (draft.has(this.file, key) ? draft.value(this.file, key) : this.file.userConfig().apps.custom);
-    }
-    item(entry, draft) {
-        const notes = [
-            Theme.muted('Download  ') +
-                '~' +
-                entry.size +
-                ' once, kept in C:\\AgentData\\tools\\' +
-                (entry.setting ? '' : 'apps\\') +
-                entry.id,
-            Theme.muted('Starts    ') +
-                (entry.cli ? 'from a terminal (on PATH)' : 'from the desktop or Start > Sandbox apps'),
-            ...(entry.needs?.includes('mesa')
-                ? [Theme.muted('Graphics  ') + 'OpenGL on the CPU (Mesa) is added for it']
-                : []),
-            ...(entry.fullGitOnly
-                ? [Theme.warn('Needs full git access (Settings > Projects & setup > Git): it pushes with its own git.')]
-                : []),
-            ...(entry.setting ? [Theme.muted('Setting   ') + entry.setting] : []),
-        ];
-        return {
-            value: entry.id,
-            label: entry.name,
-            category: groupOf(entry.category),
-            description: entry.about,
-            details: notes,
-            keywords: entry.id,
-            hint: (this.installed(entry) ? Theme.ok('installed ') : '') + Theme.muted(entry.size),
-            checked: this.isOn(entry, draft),
-        };
-    }
-    items(draft) {
-        return [
-            ...this.entries().map((a) => this.item(a, draft)),
-            ...(this.file.isProject
-                ? []
-                : [
-                    {
-                        value: REQUEST_APP,
-                        label: 'Request an app…',
-                        category: 'custom',
-                        description: 'Not in the list? Press r: your browser opens a prefilled request on GitHub (' + ISSUES_URL + ').',
-                        hint: Theme.muted('press r'),
-                        disabled: 'Press r to open the request form on GitHub.',
-                    },
-                ]),
-            ...Object.entries(this.custom(draft)).map(([id, a]) => ({
-                value: CUSTOM + id,
-                label: a.name,
-                category: 'custom',
-                description: a.github ? 'From the latest ' + a.github + ' release.' : 'From ' + a.url,
-                hint: Theme.muted(a.cli ? 'command line' : 'desktop'),
-                checked: true,
-                disabled: 'Your own programs are always installed; c to change or remove them.',
-            })),
-        ];
-    }
-    /** Stages the ticks of the list: only what differs from the saved file is kept in the draft. */
-    stageTicks(draft, ticked) {
-        for (const entry of this.entries().filter((a) => a.setting)) {
-            const key = entry.setting.split('.');
-            const on = ticked.includes(entry.id);
-            if (on === this.savedOn(entry))
-                draft.unstage(this.file, key);
-            else
-                draft.stage(this.file, key, on);
-        }
-        const wanted = this.entries()
-            .filter((a) => !a.setting && ticked.includes(a.id))
-            .map((a) => a.id);
-        if (_.isEqual([...wanted].sort(), [...this.savedInstall()].sort()))
-            draft.unstage(this.file, INSTALL);
-        else
-            draft.stage(this.file, INSTALL, wanted.length || this.file.isProject ? wanted : undefined);
-    }
-}
-/** For notices: "12 apps chosen". */
-export function appsSummary(file) {
-    const config = file.userConfig();
-    const n = config.apps.install.length + Object.keys(config.apps.custom).length;
-    return n ? n + ' chosen' : 'none chosen';
-}
-export function appLabel(id) {
-    return APPS.find((a) => a.id === id)?.name ?? Text.humanize(id);
-}

package/dist/cli/menu/data-folder.d.ts

@@ -1,18 +0,0 @@
-import type { Context } from '../commands/context.js';
-import type { App } from '../tui/index.js';
-import type { ShellExit } from './shell.js';
-/** The row in Settings and Maintenance. */
-export declare function dataFolderRow(ctx: Context): {
-    label: string;
-    hint: string;
-    description: string;
-};
-export declare class DataFolderFlow {
-    private readonly app;
-    private readonly ctx;
-    constructor(app: App, ctx: Context);
-    /** The command to run (move or use), or undefined when nothing was chosen. */
-    run(): Promise<ShellExit | undefined>;
-    private measure;
-    private decide;
-}

package/dist/cli/menu/data-folder.js

@@ -1,99 +0,0 @@
-// The "Data folder" row and its flow: shows where the saved data is, lets you pick another folder in the path picker,
-// asks whether to move the data or only switch, and hands the command to run on the normal screen (the move prints its
-// progress there).
-import fs from 'node:fs';
-import { humanBytes } from '../../core/disk.js';
-import { describeDuration, describeSize, estimate, holdsData, measureFolder, moveProblem, moveWarning, } from '../../host/storage/index.js';
-/** Measuring for the dialog stops after this long (the size then reads "at least"). */
-const MEASURE_MS = 8000;
-/** The row in Settings and Maintenance. */
-export function dataFolderRow(ctx) {
-    return {
-        label: 'Data folder',
-        hint: ctx.storageRoot,
-        description: 'Where your tools, logins, history and logs are kept between sandboxes. Press Enter to move them to another folder or drive, or to use a different folder.',
-    };
-}
-export class DataFolderFlow {
-    app;
-    ctx;
-    constructor(app, ctx) {
-        this.app = app;
-        this.ctx = ctx;
-    }
-    /** The command to run (move or use), or undefined when nothing was chosen. */
-    async run() {
-        const from = this.ctx.storageRoot;
-        const exists = fs.existsSync(from);
-        const measured = exists ? this.measure(from) : { bytes: 0, files: 0, partial: false };
-        const size = exists && holdsData(from) ? describeSize(measured) : 'nothing in it yet';
-        const to = await this.app.pickPath({
-            path: ['Data folder'],
-            title: 'Choose the folder for your saved data',
-            about: [
-                'Now: ' + from + ' (' + size + ').',
-                'Pick a new or empty folder to move your data there, or a folder that already holds data to use it.',
-            ],
-            initial: from.replace(/[\\/][^\\/]*$/, '\\'),
-            use: 'use this folder',
-            validate: (picked) => {
-                const problem = moveProblem(from, picked, true);
-                return problem ? problem.message : true;
-            },
-        });
-        if (!to)
-            return undefined;
-        return this.decide(from, to, measured, exists);
-    }
-    measure(from) {
-        const before = this.app.status;
-        this.app.status = () => 'Measuring your saved data…';
-        this.app.redraw();
-        try {
-            return measureFolder(from, MEASURE_MS);
-        }
-        finally {
-            this.app.status = before;
-        }
-    }
-    async decide(from, to, measured, exists) {
-        if (to.toLowerCase() === from.toLowerCase())
-            return undefined;
-        const target = holdsData(to);
-        const lines = [];
-        let canMove = exists && holdsData(from) && !target;
-        if (canMove) {
-            const est = estimate(from, to, measured);
-            lines.push('From: ' + from, 'To:   ' + to, 'Size: ' + describeSize(measured));
-            lines.push(est.sameVolume
-                ? 'Time: a few seconds (same drive, nothing is copied)'
-                : 'Time: ' + describeDuration(est.seconds) + ' (copied to another drive)');
-            if (est.freeBytes !== null)
-                lines.push('Free space on the target drive: ' + humanBytes(est.freeBytes));
-            const warning = moveWarning(measured, est);
-            if (warning)
-                lines.push('', warning);
-            if (!est.fits)
-                canMove = false;
-        }
-        else {
-            lines.push(target ? to + ' already holds data, so it is used as it is.' : 'There is nothing in ' + from + ' to move.', 'Your data stays where it is.');
-        }
-        const choice = await this.app.dialog({
-            title: canMove ? 'Move your data to ' + to + '?' : 'Use ' + to + '?',
-            lines: [...lines, '', 'Use without moving: the new folder is used from now on and your old data is left behind.'],
-            choices: [
-                ...(canMove ? [{ value: 'move', label: 'Move data', key: 'm' }] : []),
-                { value: 'use', label: 'Switch without moving', key: 's' },
-                { value: 'cancel', label: 'Cancel', key: 'c' },
-            ],
-            initial: 0,
-            escape: 'cancel',
-        });
-        if (choice === 'move')
-            return { kind: 'run', argv: ['storage', 'move', to, '--yes'] };
-        if (choice === 'use')
-            return { kind: 'run', argv: ['storage', 'use', to, '--yes'] };
-        return undefined;
-    }
-}

package/dist/cli/menu/share-settings.d.ts

@@ -1,21 +0,0 @@
-import type { Context } from '../commands/context.js';
-import { type App } from '../tui/index.js';
-/** The rows' ids in the settings list. */
-export declare const EXPORT_SETTINGS = "@export-settings";
-export declare const IMPORT_SETTINGS = "@import-settings";
-export declare function shareSettingsRows(): {
-    value: string;
-    label: string;
-    hint: string;
-    description: string;
-}[];
-export declare class ShareSettingsFlow {
-    private readonly app;
-    private readonly ctx;
-    constructor(app: App, ctx: Context);
-    /** Your settings as they are on disk now (the menu may have saved changes since it started). */
-    private fresh;
-    /** Returns the notice to show (undefined when cancelled). */
-    export(): Promise<string | undefined>;
-    import(): Promise<string | undefined>;
-}

package/dist/cli/menu/share-settings.js

@@ -1,112 +0,0 @@
-// The "Export settings…" and "Import settings…" rows in Settings > General: pick a file, then (for an import) read the
-// diff of what would change and say yes once. Same rules as sandbox config export / import.
-import fs from 'node:fs';
-import path from 'node:path';
-import { loadConfig } from '../../core/config/index.js';
-import { errMsg } from '../../core/util/index.js';
-import { applyImport, DEFAULT_EXPORT, readImport, writeExport } from '../commands/maintenance/config-share.js';
-import { Theme } from '../tui/index.js';
-import { askPath } from './settings/ask-path.js';
-import { diffText, skippedLine } from './settings/index.js';
-/** The rows' ids in the settings list. */
-export const EXPORT_SETTINGS = '@export-settings';
-export const IMPORT_SETTINGS = '@import-settings';
-export function shareSettingsRows() {
-    return [
-        {
-            value: EXPORT_SETTINGS,
-            label: 'Export settings…',
-            hint: '.json',
-            description: 'Write the settings you changed to a .json file you can share with a team. Secrets, the data folder and folders or files of this PC are left out.',
-        },
-        {
-            value: IMPORT_SETTINGS,
-            label: 'Import settings…',
-            hint: '.json',
-            description: 'Read a settings file someone shared, see what it would change, and apply it once you say yes. Secrets, the data folder and paths in it are never taken.',
-        },
-    ];
-}
-export class ShareSettingsFlow {
-    app;
-    ctx;
-    constructor(app, ctx) {
-        this.app = app;
-        this.ctx = ctx;
-    }
-    /** Your settings as they are on disk now (the menu may have saved changes since it started). */
-    fresh() {
-        return { ...this.ctx, loaded: loadConfig(this.ctx.loaded.configPath ?? undefined) };
-    }
-    /** Returns the notice to show (undefined when cancelled). */
-    async export() {
-        const where = ['Settings', 'Export settings'];
-        try {
-            const file = await askPath(this.app, {
-                path: where,
-                title: 'Where to write the settings file',
-                about: ['Only what differs from the defaults is written; secrets and paths of this PC are left out.'],
-                initial: path.resolve(DEFAULT_EXPORT),
-                kind: 'file',
-                validate: (p) => (p.toLowerCase().endsWith('.json') ? true : 'The file name should end in .json.'),
-            });
-            if (!file)
-                return undefined;
-            const exists = path.resolve(file);
-            const replace = fs.existsSync(exists);
-            if (replace &&
-                !(await this.app.confirm({ path: where, question: exists + ' exists. Replace it?', initial: false })))
-                return undefined;
-            const skipped = writeExport(this.fresh(), file, false, replace);
-            return (Theme.ok(Theme.glyph.ok + ' Wrote ' + exists + '.') +
-                (skipped.length ? Theme.muted(' Left out: ' + skipped.join(', ') + '.') : ''));
-        }
-        catch (e) {
-            return Theme.error(Theme.glyph.cross + ' ' + errMsg(e));
-        }
-    }
-    async import() {
-        const where = ['Settings', 'Import settings'];
-        try {
-            const file = await askPath(this.app, {
-                path: where,
-                title: 'Which settings file',
-                about: ['A file made by Export settings (or sandbox config export).'],
-                kind: 'file',
-            });
-            if (!file)
-                return undefined;
-            const ctx = this.fresh();
-            const plan = readImport(ctx, file);
-            const lines = [
-                ...(plan.changes.length
-                    ? [
-                        plan.changes.length + ' setting' + (plan.changes.length === 1 ? '' : 's') + ' would change:',
-                        '',
-                        ...diffText(plan.lines),
-                    ]
-                    : ['Nothing to change: your settings already match the file.']),
-                ...(plan.skipped.length
-                    ? ['', 'Not imported (never taken from a file):', ...plan.skipped.map((s) => skippedLine(s))]
-                    : []),
-            ];
-            if (!plan.changes.length) {
-                await this.app.message({ path: where, lines });
-                return Theme.muted('Nothing changed.');
-            }
-            const yes = await this.app.confirm({
-                path: where,
-                question: 'Change your settings like this?',
-                about: lines,
-                initial: false,
-            });
-            if (!yes)
-                return Theme.muted('Nothing changed.');
-            const n = applyImport(ctx, plan);
-            return Theme.ok(Theme.glyph.ok + ' Imported ' + n + ' setting' + (n === 1 ? '' : 's') + '.');
-        }
-        catch (e) {
-            return Theme.error(Theme.glyph.cross + ' ' + errMsg(e));
-        }
-    }
-}

package/dist/cli/menu/vpn-login.d.ts

@@ -1,16 +0,0 @@
-import type { Context } from '../commands/context.js';
-import { type App } from '../tui/index.js';
-/** The row's id in the settings list. */
-export declare const VPN_LOGIN = "@vpn-login";
-export declare function vpnLoginRow(ctx: Context): {
-    label: string;
-    hint: string;
-    description: string;
-};
-export declare class VpnLoginFlow {
-    private readonly app;
-    private readonly ctx;
-    constructor(app: App, ctx: Context);
-    /** Returns the notice to show (undefined when cancelled). */
-    run(): Promise<string | undefined>;
-}

package/dist/cli/menu/vpn-login.js

@@ -1,74 +0,0 @@
-import { VPN_WARNINGS } from '../commands/vpn.js';
-import { NORD_STEPS, VpnService } from '../services/index.js';
-import { Theme } from '../tui/index.js';
-/** The row's id in the settings list. */
-export const VPN_LOGIN = '@vpn-login';
-export function vpnLoginRow(ctx) {
-    const service = new VpnService(ctx);
-    const nord = service.provider === 'nordvpn';
-    if (service.provider === 'wireguard-file')
-        return {
-            label: 'VPN login',
-            hint: 'not needed',
-            description: 'A WireGuard file carries its own keys (vpn.configFile): there is no login to set.',
-        };
-    const state = service.loginState();
-    return {
-        label: nord ? 'Set NordVPN login…' : 'Set VPN login…',
-        hint: state === 'saved' ? 'saved' : state === 'unreadable' ? 'cannot be read' : 'not saved',
-        description: 'The login the VPN uses (for NordVPN the service credentials from Nord Account > NordVPN > Set up NordVPN manually, not your account password). Typed hidden, kept encrypted for your Windows user, never shown. ' +
-            VPN_WARNINGS.join(' '),
-    };
-}
-export class VpnLoginFlow {
-    app;
-    ctx;
-    constructor(app, ctx) {
-        this.app = app;
-        this.ctx = ctx;
-    }
-    /** Returns the notice to show (undefined when cancelled). */
-    async run() {
-        const service = new VpnService(this.ctx);
-        const nord = service.provider === 'nordvpn';
-        if (service.provider === 'wireguard-file')
-            return 'A WireGuard file carries its own keys: no login is needed.';
-        const path = ['Settings', 'Network', 'VPN login'];
-        await this.app.message({
-            path,
-            title: nord ? 'NordVPN service credentials' : 'VPN login',
-            lines: [
-                ...(nord
-                    ? ['To find them:', ...NORD_STEPS.map((s, i) => i + 1 + '. ' + s)]
-                    : ['The user name and password your VPN profile asks for.']),
-                '',
-                'What you type next is hidden, kept encrypted for your Windows user and never shown again.',
-                '',
-                ...VPN_WARNINGS,
-            ],
-        });
-        const username = await this.app.text({
-            path,
-            label: nord ? 'Service user name' : 'User name',
-            masked: true,
-            validate: (v) => (v.trim() ? true : 'Type the user name.'),
-        });
-        if (username === undefined)
-            return undefined;
-        const password = await this.app.text({
-            path,
-            label: nord ? 'Service password' : 'Password',
-            masked: true,
-            validate: (v) => (v ? true : 'Type the password.'),
-        });
-        if (password === undefined)
-            return undefined;
-        try {
-            service.save({ username, password });
-        }
-        catch (e) {
-            return Theme.error(Theme.glyph.cross + ' ' + (e instanceof Error ? e.message : String(e)));
-        }
-        return Theme.ok(Theme.glyph.ok + ' The VPN login is saved (encrypted). Turn the VPN on under Settings > Network.');
-    }
-}