@visorcraft/idlehands 0.9.1

package/dist/spinner.js

@@ -0,0 +1,224 @@
+/**
+ * CLI spinner and tool call visualization (Phase 7).
+ *
+ * Shows an animated spinner while waiting for the first token,
+ * then transitions to streaming text. Tool calls get one-line
+ * summaries before and after execution.
+ */
+const FRAMES = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'];
+const INTERVAL = 80; // ms per frame
+export class CliSpinner {
+    frame = 0;
+    timer = null;
+    startTime = Date.now();
+    currentTool = null;
+    firstDelta = false;
+    enabled;
+    verbose;
+    S;
+    constructor(opts) {
+        this.S = opts.styler;
+        this.enabled = opts.enabled !== false && process.stdout.isTTY === true;
+        this.verbose = opts.verbose ?? false;
+    }
+    /** Start the spinner. Call before ask(). */
+    start() {
+        if (!this.enabled)
+            return;
+        this.startTime = Date.now();
+        this.frame = 0;
+        this.firstDelta = false;
+        this.currentTool = null;
+        this.timer = setInterval(() => this.render(), INTERVAL);
+    }
+    /** Called on first token — stop spinner, let streaming begin. */
+    onFirstDelta() {
+        if (this.firstDelta)
+            return;
+        this.firstDelta = true;
+        this.clearLine();
+        this.stopTimer();
+    }
+    /** Called before a tool executes. */
+    onToolCall(event) {
+        if (!this.enabled) {
+            // Fallback for non-TTY
+            process.stderr.write(`◆ ${event.name} ${this.argSummary(event)}\n`);
+            return;
+        }
+        this.clearLine();
+        this.stopTimer();
+        const summary = this.argSummary(event);
+        const dim = this.S.dim;
+        process.stderr.write(dim(`  ◆ ${event.name} ${summary}`));
+        process.stderr.write('\n');
+        // Restart spinner for tool execution
+        this.currentTool = event.name;
+        this.startTime = Date.now();
+        this.timer = setInterval(() => this.render(), INTERVAL);
+    }
+    /** Called after a tool completes. */
+    onToolResult(event) {
+        this.clearLine();
+        this.stopTimer();
+        this.currentTool = null;
+        if (!this.enabled) {
+            const icon = event.success ? '✓' : '✗';
+            process.stderr.write(`  ${icon} ${event.name}: ${event.summary}\n`);
+            return;
+        }
+        const icon = event.success
+            ? this.S.green('✓')
+            : this.S.red('✗');
+        const summary = event.summary.length > 120
+            ? event.summary.slice(0, 117) + '...'
+            : event.summary;
+        process.stderr.write(`  ${icon} ${this.S.dim(`${event.name}: ${summary}`)}\n`);
+        // Phase 7: rich display (only in verbose mode or for key outputs)
+        if (this.verbose) {
+            this.renderRichOutput(event);
+        }
+        else {
+            // In normal mode, show compact exec output and diffs
+            if (event.diff) {
+                this.renderDiff(event.diff);
+            }
+            if (event.execOutput) {
+                this.renderExecOutput(event.execOutput, 5);
+            }
+            if (event.searchMatches?.length) {
+                this.renderSearchMatches(event.searchMatches, 5);
+            }
+        }
+    }
+    /** Render rich output in verbose mode. */
+    renderRichOutput(event) {
+        if (event.diff) {
+            this.renderDiff(event.diff);
+        }
+        if (event.execOutput) {
+            this.renderExecOutput(event.execOutput, 20);
+        }
+        if (event.searchMatches?.length) {
+            this.renderSearchMatches(event.searchMatches, 20);
+        }
+    }
+    /** Render an inline colored diff (unified format). */
+    renderDiff(diff) {
+        const lines = diff.split('\n');
+        for (const line of lines) {
+            if (line.startsWith('+++') || line.startsWith('---') || line.startsWith('@@')) {
+                process.stderr.write(`    ${this.S.dim(line)}\n`);
+            }
+            else if (line.startsWith('+') && !line.startsWith('+++')) {
+                process.stderr.write(`    ${this.S.green(line)}\n`);
+            }
+            else if (line.startsWith('-') && !line.startsWith('---')) {
+                process.stderr.write(`    ${this.S.red(line)}\n`);
+            }
+            else if (line.startsWith('[+')) {
+                process.stderr.write(`    ${this.S.dim(line)}\n`);
+            }
+            else {
+                process.stderr.write(`    ${this.S.dim(line)}\n`);
+            }
+        }
+    }
+    /** Render exec stdout (dimmed, limited lines). */
+    renderExecOutput(output, maxLines) {
+        const lines = output.split('\n');
+        const show = lines.slice(0, maxLines);
+        for (const line of show) {
+            process.stderr.write(`    ${this.S.dim(line)}\n`);
+        }
+        if (lines.length > maxLines) {
+            process.stderr.write(`    ${this.S.dim(`[+${lines.length - maxLines} more lines]`)}\n`);
+        }
+    }
+    /** Render search matches with highlights. */
+    renderSearchMatches(matches, maxLines) {
+        const show = matches.slice(0, maxLines);
+        for (const match of show) {
+            // Format: "file:line:content" — highlight the file:line prefix
+            const idx = match.indexOf(':');
+            if (idx > 0) {
+                const nextIdx = match.indexOf(':', idx + 1);
+                if (nextIdx > 0) {
+                    const prefix = match.slice(0, nextIdx + 1);
+                    const content = match.slice(nextIdx + 1);
+                    process.stderr.write(`    ${this.S.cyan(prefix)}${this.S.dim(content)}\n`);
+                    continue;
+                }
+            }
+            process.stderr.write(`    ${this.S.dim(match)}\n`);
+        }
+        if (matches.length > maxLines) {
+            process.stderr.write(`    ${this.S.dim(`[+${matches.length - maxLines} more matches]`)}\n`);
+        }
+    }
+    /** Stop spinner completely. Call after ask() returns. */
+    stop() {
+        this.clearLine();
+        this.stopTimer();
+    }
+    render() {
+        if (this.firstDelta && !this.currentTool)
+            return;
+        const elapsed = ((Date.now() - this.startTime) / 1000).toFixed(1);
+        const f = FRAMES[this.frame % FRAMES.length];
+        this.frame++;
+        let text;
+        if (this.currentTool) {
+            text = `${f} Running ${this.currentTool}... (${elapsed}s)`;
+        }
+        else {
+            text = `${f} Thinking... (${elapsed}s)`;
+        }
+        process.stderr.write(`\r${this.S.dim(text)}`);
+    }
+    clearLine() {
+        if (!this.enabled)
+            return;
+        process.stderr.write('\r\x1b[K');
+    }
+    stopTimer() {
+        if (this.timer) {
+            clearInterval(this.timer);
+            this.timer = null;
+        }
+    }
+    argSummary(event) {
+        const a = event.args;
+        switch (event.name) {
+            case 'read_file': {
+                const p = a.path ?? a.file_path ?? '';
+                const range = a.offset && a.limit ? ` (lines ${a.offset}-${Number(a.offset) + Number(a.limit)})` : '';
+                const search = a.search ? ` search="${a.search}"` : '';
+                return `${p}${range}${search}`;
+            }
+            case 'write_file':
+                return `${a.path ?? a.file_path ?? ''}`;
+            case 'edit_file': {
+                const p = a.path ?? a.file_path ?? '';
+                const old = typeof a.old_string === 'string' ? a.old_string : '';
+                const lines = old.split('\n').length;
+                return `${p} (replacing ${lines} line${lines !== 1 ? 's' : ''})`;
+            }
+            case 'insert_file':
+                return `${a.path ?? a.file_path ?? ''} at line ${a.line ?? '?'}`;
+            case 'exec': {
+                const cmd = typeof a.command === 'string' ? a.command : '';
+                return cmd.length > 80 ? cmd.slice(0, 77) + '...' : cmd;
+            }
+            case 'list_dir':
+                return `${a.path ?? '.'}`;
+            case 'search_files':
+                return `"${a.pattern ?? ''}" in ${a.path ?? '.'}`;
+            case 'undo_path':
+                return `${a.path ?? '(last edit)'}`;
+            default:
+                return Object.keys(a).slice(0, 3).map(k => `${k}=${JSON.stringify(a[k]).slice(0, 30)}`).join(' ');
+        }
+    }
+}
+//# sourceMappingURL=spinner.js.map

package/dist/spinner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spinner.js","sourceRoot":"","sources":["../src/spinner.ts"],"names":[],"mappings":"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"}

package/dist/sys/context.js

@@ -0,0 +1,124 @@
+/**
+ * sys_context tool — Scoped system snapshot (Phase 9a).
+ *
+ * Collects system info on demand via snapshot.sh.
+ * Cached for 60s to avoid re-running `df`, `systemctl`, etc. every tool cycle.
+ */
+import { spawn, spawnSync } from 'node:child_process';
+import path from 'node:path';
+import { existsSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+// In dist/, __dirname is dist/sys/ — script is at src/sys/snapshot.sh relative to repo root.
+// In source, __dirname is src/sys/ — script is co-located.
+const SNAPSHOT_SCRIPT = path.join(__dirname, 'snapshot.sh');
+const VALID_SCOPES = ['all', 'services', 'network', 'disk', 'packages'];
+// Cache: scope → { text, timestamp }
+const cache = new Map();
+const CACHE_TTL_MS = 60_000; // 60 seconds
+/**
+ * Detect the package manager on this system.
+ * Returns: 'apt' | 'dnf' | 'pacman' | 'unknown'
+ */
+export function detectPackageManager() {
+    const has = (cmd) => spawnSync('bash', ['-lc', `command -v ${cmd}`], { stdio: 'ignore' }).status === 0;
+    if (has('apt'))
+        return 'apt';
+    if (has('dnf'))
+        return 'dnf';
+    if (has('pacman'))
+        return 'pacman';
+    return 'unknown';
+}
+/**
+ * Run snapshot.sh with the given scope and return the output.
+ * Caches results for 60s per scope.
+ */
+export async function collectSnapshot(scope = 'all') {
+    // Check cache
+    const cached = cache.get(scope);
+    if (cached && (Date.now() - cached.ts) < CACHE_TTL_MS) {
+        return cached.text;
+    }
+    const text = await runSnapshotScript(scope);
+    cache.set(scope, { text, ts: Date.now() });
+    return text;
+}
+/** Clear snapshot cache (for testing). */
+export function clearSnapshotCache() {
+    cache.clear();
+}
+/**
+ * Resolve the snapshot script path. In the built dist, the script lives in
+ * src/sys/snapshot.sh relative to the repo root. We try the source path first,
+ * then fall back to a co-located path.
+ */
+function resolveSnapshotScript() {
+    // Try likely locations in source checkout and installed package.
+    const candidates = [
+        SNAPSHOT_SCRIPT, // co-located (src/sys/ or dist/sys/)
+        path.join(process.cwd(), 'src', 'sys', 'snapshot.sh'), // repo root → source
+        path.join(process.cwd(), 'dist', 'sys', 'snapshot.sh'), // repo root → dist
+    ];
+    for (const c of candidates) {
+        if (existsSync(c))
+            return c;
+    }
+    // Fall back to the canonical source path for a clear error.
+    return SNAPSHOT_SCRIPT;
+}
+async function runSnapshotScript(scope) {
+    const scriptPath = resolveSnapshotScript();
+    return new Promise((resolve, reject) => {
+        const child = spawn('bash', [scriptPath, scope], {
+            stdio: ['ignore', 'pipe', 'pipe'],
+            timeout: 5000, // 5s hard limit
+        });
+        const chunks = [];
+        const errChunks = [];
+        child.stdout.on('data', (d) => chunks.push(d));
+        child.stderr.on('data', (d) => errChunks.push(d));
+        child.on('close', (code) => {
+            const out = Buffer.concat(chunks).toString('utf8').trim();
+            if (code !== 0) {
+                const err = Buffer.concat(errChunks).toString('utf8').trim();
+                reject(new Error(`snapshot.sh exited ${code}: ${err || out}`));
+                return;
+            }
+            resolve(out);
+        });
+        child.on('error', (e) => reject(e));
+    });
+}
+/**
+ * Tool handler for sys_context.
+ * Matches the ToolContext pattern used by other tools.
+ */
+export async function sys_context(_ctx, args) {
+    const scope = typeof args?.scope === 'string' ? args.scope.toLowerCase() : 'all';
+    if (!VALID_SCOPES.includes(scope)) {
+        throw new Error(`sys_context: invalid scope "${scope}". Valid: ${VALID_SCOPES.join(', ')}`);
+    }
+    return collectSnapshot(scope);
+}
+/**
+ * Tool schema for sys_context (registered only when sys mode is active).
+ */
+export const SYS_CONTEXT_SCHEMA = {
+    type: 'function',
+    function: {
+        name: 'sys_context',
+        description: 'Get system information snapshot. Use this when you need to know about the OS, services, network, disk, or packages.',
+        parameters: {
+            type: 'object',
+            properties: {
+                scope: {
+                    type: 'string',
+                    enum: ['all', 'services', 'network', 'disk', 'packages'],
+                    description: 'What info to collect. "all" returns everything (~500 tokens). Individual scopes return ~100 tokens each.',
+                },
+            },
+        },
+    },
+};
+//# sourceMappingURL=context.js.map

package/dist/sys/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/sys/context.ts"],"names":[],"mappings":"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"}

package/dist/sys/snapshot.sh

@@ -0,0 +1,97 @@
+#!/bin/bash
+# System context snapshot for Idle Hands (Phase 9)
+# Usage: snapshot.sh [scope]
+# Scope: all | services | network | disk | packages
+# Target: <500 tokens for full scope, <100 tokens per individual scope, <2s to collect
+
+set -euo pipefail
+SCOPE="${1:-all}"
+
+collect_os() {
+  echo "OS: $(cat /etc/os-release 2>/dev/null | grep '^PRETTY_NAME' | cut -d'"' -f2 || uname -s) ($(uname -m))"
+  echo "Kernel: $(uname -r)"
+  echo "Hostname: $(hostname)"
+  echo "Uptime: $(uptime -p 2>/dev/null | sed 's/^up //' || echo 'unknown')"
+  # CPU
+  local cpus
+  cpus=$(nproc 2>/dev/null || echo '?')
+  local model
+  model=$(grep -m1 'model name' /proc/cpuinfo 2>/dev/null | cut -d: -f2 | xargs || echo 'unknown')
+  echo "CPU: ${model} (${cpus} cores)"
+  # RAM
+  if command -v free &>/dev/null; then
+    local total avail
+    total=$(free -h | awk '/^Mem:/{print $2}')
+    avail=$(free -h | awk '/^Mem:/{print $7}')
+    echo "RAM: ${total} (${avail} available)"
+  fi
+}
+
+collect_disk() {
+  if command -v df &>/dev/null; then
+    echo "Disk:"
+    df -h --output=target,size,used,avail,pcent / /home 2>/dev/null | tail -n +2 | while read -r mount size used avail pct; do
+      echo "  ${mount} ${pct} of ${size} (${avail} free)"
+    done
+  fi
+}
+
+collect_network() {
+  if command -v ip &>/dev/null; then
+    echo "Network:"
+    ip -br addr 2>/dev/null | grep -v '^lo ' | while read -r iface state addrs; do
+      echo "  ${iface} ${state} ${addrs}"
+    done
+  fi
+}
+
+collect_services() {
+  if command -v systemctl &>/dev/null; then
+    echo "Services (active): $(systemctl list-units --state=active --type=service --no-legend --no-pager 2>/dev/null | awk '{print $1}' | sed 's/\.service$//' | head -20 | tr '\n' ', ' | sed 's/,$//')"
+    local failed
+    failed=$(systemctl list-units --state=failed --type=service --no-legend --no-pager 2>/dev/null | awk '{print $1}' | sed 's/\.service$//' | tr '\n' ', ' | sed 's/,$//')
+    echo "Services (failed): ${failed:-none}"
+  fi
+}
+
+collect_packages() {
+  if command -v apt &>/dev/null; then
+    local installed upgradable
+    installed=$(dpkg -l 2>/dev/null | grep -c '^ii' || echo '?')
+    upgradable=$(apt list --upgradable 2>/dev/null | grep -c 'upgradable' || echo '0')
+    echo "Packages (apt): ${installed} installed, ${upgradable} upgradable"
+  elif command -v dnf &>/dev/null; then
+    local installed
+    installed=$(dnf list installed 2>/dev/null | tail -n +2 | wc -l || echo '?')
+    echo "Packages (dnf): ${installed} installed"
+  elif command -v pacman &>/dev/null; then
+    local installed
+    installed=$(pacman -Q 2>/dev/null | wc -l || echo '?')
+    echo "Packages (pacman): ${installed} installed"
+  fi
+  # Last boot
+  if command -v who &>/dev/null; then
+    echo "Last boot: $(who -b 2>/dev/null | awk '{print $3, $4}' || echo 'unknown')"
+  fi
+}
+
+echo "[System context]"
+case "$SCOPE" in
+  all)
+    collect_os
+    collect_disk
+    collect_network
+    collect_services
+    collect_packages
+    ;;
+  services) collect_services ;;
+  network) collect_network ;;
+  disk) collect_disk ;;
+  packages) collect_packages ;;
+  *)
+    echo "Unknown scope: $SCOPE"
+    echo "Valid scopes: all, services, network, disk, packages"
+    exit 1
+    ;;
+esac
+echo "[End system context]"

package/dist/term.js

@@ -0,0 +1,61 @@
+import pc from 'picocolors';
+export function resolveColorMode(mode) {
+    const env = process.env;
+    // Standard opt-out
+    if ('NO_COLOR' in env)
+        return { enabled: false };
+    // Explicit force/disable
+    if (env.FORCE_COLOR === '0')
+        return { enabled: false };
+    if (env.FORCE_COLOR && env.FORCE_COLOR !== '0')
+        return { enabled: true };
+    if (mode === 'always')
+        return { enabled: true };
+    if (mode === 'never')
+        return { enabled: false };
+    // auto
+    return { enabled: !!process.stdout.isTTY };
+}
+export function makeStyler(enabled, theme) {
+    const wrap = (fn) => (s) => (enabled ? fn(s) : s);
+    const t = theme;
+    return {
+        enabled,
+        dim: wrap(t?.dim ?? pc.dim),
+        bold: wrap(t?.bold ?? pc.bold),
+        red: wrap(t?.red ?? pc.red),
+        yellow: wrap(t?.yellow ?? pc.yellow),
+        green: wrap(t?.green ?? pc.green),
+        cyan: wrap(t?.cyan ?? pc.cyan),
+        magenta: wrap(t?.magenta ?? pc.magenta),
+        blue: wrap(t?.blue ?? pc.blue)
+    };
+}
+export function colorizeUnifiedDiff(diff, s) {
+    const out = [];
+    for (const line of diff.split(/\r?\n/)) {
+        if (line.startsWith('+++') || line.startsWith('---') || line.startsWith('@@')) {
+            out.push(s.dim(line));
+        }
+        else if (line.startsWith('+') && !line.startsWith('+++')) {
+            out.push(s.green(line));
+        }
+        else if (line.startsWith('-') && !line.startsWith('---')) {
+            out.push(s.red(line));
+        }
+        else {
+            out.push(line);
+        }
+    }
+    return out.join('\n');
+}
+export function banner(title, s) {
+    return s.blue(s.bold(title));
+}
+export function warn(msg, s) {
+    return s.yellow('WARN') + s.dim(': ') + msg;
+}
+export function err(msg, s) {
+    return s.red('ERROR') + s.dim(': ') + msg;
+}
+//# sourceMappingURL=term.js.map

package/dist/term.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"term.js","sourceRoot":"","sources":["../src/term.ts"],"names":[],"mappings":"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"}

package/dist/themes.js

@@ -0,0 +1,135 @@
+/**
+ * Built-in and custom theme system (Phase 14a).
+ *
+ * Themes are ANSI color palette mappings applied to the Styler.
+ * Each theme remaps the Styler's color slots (red, yellow, green,
+ * cyan, magenta, blue, dim, bold) to different picocolors functions.
+ *
+ * Built-in: default, dark, light, minimal, hacker
+ * Custom:   ~/.config/idlehands/themes/<name>.json
+ */
+import pc from 'picocolors';
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { configDir } from './utils.js';
+// All supported picocolors primitives.
+const PC = {
+    dim: pc.dim,
+    bold: pc.bold,
+    italic: pc.italic,
+    underline: pc.underline,
+    inverse: pc.inverse,
+    red: pc.red,
+    yellow: pc.yellow,
+    green: pc.green,
+    cyan: pc.cyan,
+    magenta: pc.magenta,
+    blue: pc.blue,
+    white: pc.white,
+    gray: pc.gray,
+    black: pc.black,
+};
+/** Resolve a palette string like "bold+cyan" to a composed function. */
+function resolveColor(spec) {
+    const parts = spec.split('+').map(p => p.trim().toLowerCase());
+    const fns = parts.map(p => PC[p]).filter(Boolean);
+    if (fns.length === 0)
+        return undefined;
+    if (fns.length === 1)
+        return fns[0];
+    return (s) => fns.reduce((acc, fn) => fn(acc), s);
+}
+/** The default (identity) palette — no remapping. */
+const DEFAULT_PALETTE = {
+    dim: 'dim', bold: 'bold', red: 'red', yellow: 'yellow',
+    green: 'green', cyan: 'cyan', magenta: 'magenta', blue: 'blue',
+};
+const BUILTIN_PALETTES = {
+    default: {},
+    dark: {
+        cyan: 'bold+cyan',
+        magenta: 'bold+magenta',
+        blue: 'bold+blue',
+    },
+    light: {
+        dim: 'gray',
+        cyan: 'blue',
+        blue: 'cyan',
+    },
+    minimal: {
+        yellow: 'dim',
+        green: 'dim',
+        cyan: 'dim',
+        magenta: 'dim',
+        blue: 'dim',
+    },
+    hacker: {
+        bold: 'bold+green',
+        yellow: 'green',
+        cyan: 'green',
+        magenta: 'green',
+        blue: 'green',
+    },
+};
+export const BUILTIN_THEME_NAMES = Object.keys(BUILTIN_PALETTES);
+/** Resolve a raw palette to concrete functions, falling back to defaults. */
+export function resolvePalette(palette) {
+    const out = {};
+    for (const slot of Object.keys(DEFAULT_PALETTE)) {
+        const spec = palette[slot] ?? DEFAULT_PALETTE[slot];
+        const fn = resolveColor(spec);
+        out[slot] = fn ?? PC[DEFAULT_PALETTE[slot]];
+    }
+    return out;
+}
+/** Get a built-in theme's resolved functions. */
+export function builtinTheme(name) {
+    const p = BUILTIN_PALETTES[name];
+    if (!p)
+        return undefined;
+    return resolvePalette(p);
+}
+/** Custom themes directory. */
+export function customThemesDir() {
+    return path.join(configDir(), 'themes');
+}
+/** Load a custom theme from ~/.config/idlehands/themes/<name>.json */
+export async function loadCustomTheme(name) {
+    const filePath = path.join(customThemesDir(), `${name}.json`);
+    try {
+        const raw = await fs.readFile(filePath, 'utf8');
+        const parsed = JSON.parse(raw);
+        if (!parsed || typeof parsed !== 'object')
+            return undefined;
+        return resolvePalette(parsed);
+    }
+    catch {
+        return undefined;
+    }
+}
+/** Resolve a theme by name: built-in first, then custom file. */
+export async function resolveTheme(name) {
+    const builtin = builtinTheme(name);
+    if (builtin)
+        return builtin;
+    return loadCustomTheme(name);
+}
+/** List available theme names (built-in + custom). */
+export async function listThemes() {
+    const builtin = [...BUILTIN_THEME_NAMES];
+    const custom = [];
+    try {
+        const dir = customThemesDir();
+        const entries = await fs.readdir(dir, { withFileTypes: true });
+        for (const e of entries) {
+            if (e.isFile() && e.name.endsWith('.json')) {
+                custom.push(e.name.replace(/\.json$/, ''));
+            }
+        }
+    }
+    catch {
+        // no custom themes dir
+    }
+    return { builtin, custom };
+}
+//# sourceMappingURL=themes.js.map