@litlab/audx 0.0.2 → 0.6.0

package/dist/bin.js

@@ -0,0 +1,1212 @@
+#!/usr/bin/env node
+import * as p from '@clack/prompts';
+import { existsSync, mkdirSync } from 'node:fs';
+import { readdir, readFile, writeFile, unlink } from 'node:fs/promises';
+import __node_cjsPath, { resolve, join, basename, isAbsolute } from 'node:path';
+import pc from 'picocolors';
+import { _ as _object_without_properties_loose } from './cc-DgCkkqq8.js';
+import __node_cjsModule from 'node:module';
+import __node_cjsUrl from 'node:url';
+
+const require$1 = __node_cjsModule.createRequire(import.meta.url);
+
+const REGISTRY_BASE = "https://audx.site/api";
+const CONFIG_DIR = ".themes";
+const CONFIG_FILE = "config.json";
+function configPath() {
+    return resolve(process.cwd(), CONFIG_DIR, CONFIG_FILE);
+}
+function getConfig() {
+    const p = configPath();
+    if (!existsSync(p)) return null;
+    try {
+        const raw = JSON.parse(require$1("node:fs").readFileSync(p, "utf-8"));
+        if (typeof raw.output === "string") return {
+            output: raw.output
+        };
+    } catch (unused) {}
+    return null;
+}
+async function ensureConfig(context = "setup") {
+    const existing = getConfig();
+    if (existing) return existing;
+    const isThemeContext = context === "themes";
+    const output = await p.select({
+        message: isThemeContext ? "Where should themes be installed?" : "Where should AudX be set up?",
+        options: isThemeContext ? [
+            {
+                value: "src/audio",
+                label: "src/audio/themes",
+                hint: "default"
+            },
+            {
+                value: "lib/audio",
+                label: "lib/audio/themes"
+            },
+            {
+                value: "__custom__",
+                label: "Custom path..."
+            }
+        ] : [
+            {
+                value: "src/audio",
+                label: "src/audio",
+                hint: "default"
+            },
+            {
+                value: "lib/audio",
+                label: "lib/audio"
+            },
+            {
+                value: "__custom__",
+                label: "Custom path..."
+            }
+        ]
+    });
+    if (p.isCancel(output)) {
+        p.cancel("Cancelled.");
+        process.exit(0);
+    }
+    let outputDir = output;
+    if (outputDir === "__custom__") {
+        const custom = await p.text({
+            message: "Enter output path",
+            placeholder: isThemeContext ? "src/audio/themes" : "src/audio",
+            validate: (v)=>v.length === 0 ? "Path is required" : undefined
+        });
+        if (p.isCancel(custom)) {
+            p.cancel("Cancelled.");
+            process.exit(0);
+        }
+        outputDir = normalizeConfigOutput(custom, context);
+    }
+    const config = {
+        output: outputDir
+    };
+    const dir = resolve(process.cwd(), CONFIG_DIR);
+    if (!existsSync(dir)) mkdirSync(dir, {
+        recursive: true
+    });
+    require$1("node:fs").writeFileSync(configPath(), `${JSON.stringify(config, null, 2)}\n`, "utf-8");
+    return config;
+}
+function normalizeConfigOutput(output, context) {
+    const normalized = output.replace(/\/+$/, "");
+    if (context === "themes" && normalized.endsWith("/themes")) {
+        return normalized.slice(0, -"/themes".length);
+    }
+    return normalized;
+}
+function getThemesDir() {
+    var _ref;
+    const config = getConfig();
+    const output = (_ref = config == null ? void 0 : config.output) != null ? _ref : "src/audio";
+    return resolve(process.cwd(), output, "themes");
+}
+function getSoundsDir() {
+    var _ref;
+    const config = getConfig();
+    const output = (_ref = config == null ? void 0 : config.output) != null ? _ref : "src/audio";
+    return resolve(process.cwd(), output, "a");
+}
+function parseGitHubSource(source) {
+    const normalizedSource = source.replace(/\/+$/, "").replace(/\.git$/, "");
+    const ghUrlMatch = normalizedSource.match(/^https?:\/\/github\.com\/([^/]+)\/([^/]+?)(?:\/tree\/([^/]+)(?:\/(.+))?)?$/);
+    if (ghUrlMatch) {
+        var _ghUrlMatch_, _ghUrlMatch_1;
+        return {
+            owner: ghUrlMatch[1],
+            repo: ghUrlMatch[2],
+            branch: (_ghUrlMatch_ = ghUrlMatch[3]) != null ? _ghUrlMatch_ : "main",
+            path: (_ghUrlMatch_1 = ghUrlMatch[4]) != null ? _ghUrlMatch_1 : ""
+        };
+    }
+    const shorthand = normalizedSource.match(/^([^/]+)\/([^/]+)$/);
+    if (shorthand) {
+        return {
+            owner: shorthand[1],
+            repo: shorthand[2],
+            branch: "main",
+            path: ""
+        };
+    }
+    return null;
+}
+async function discoverThemesFromGitHub(source) {
+    const parsed = parseGitHubSource(source);
+    if (!parsed) {
+        throw new Error(`Invalid source: ${source}. Use owner/repo or a GitHub URL.`);
+    }
+    const { owner, repo, branch, path: subPath } = parsed;
+    const treeUrl = `https://api.github.com/repos/${owner}/${repo}/git/trees/${branch}?recursive=1`;
+    const res = await fetch(treeUrl, {
+        headers: {
+            Accept: "application/vnd.github.v3+json"
+        }
+    });
+    if (!res.ok) {
+        throw new Error(`Failed to fetch repo tree: ${res.status}`);
+    }
+    const tree = await res.json();
+    const jsonFiles = tree.tree.filter((item)=>{
+        if (item.type !== "blob" || !item.path.endsWith(".json")) return false;
+        if (subPath && !item.path.startsWith(subPath)) return false;
+        if (item.path.includes("node_modules/")) return false;
+        if (item.path.includes("package.json")) return false;
+        if (item.path.includes("tsconfig")) return false;
+        if (item.path.includes(".changeset/")) return false;
+        return true;
+    });
+    const themes = [];
+    for (const file of jsonFiles){
+        const rawUrl = `https://raw.githubusercontent.com/${owner}/${repo}/${branch}/${file.path}`;
+        try {
+            const r = await fetch(rawUrl);
+            if (!r.ok) continue;
+            const data = await r.json();
+            if (!validateTheme(data)) continue;
+            themes.push({
+                name: data.name,
+                path: file.path,
+                downloadUrl: rawUrl,
+                description: data.description,
+                soundCount: Object.keys(data.sounds).length
+            });
+        } catch (unused) {}
+    }
+    return themes;
+}
+function isGitHubSource(source) {
+    return parseGitHubSource(source) !== null;
+}
+function isLocalSource(source) {
+    if (source.startsWith("http://") || source.startsWith("https://")) {
+        return false;
+    }
+    const abs = isAbsolute(source) ? source : resolve(process.cwd(), source);
+    return existsSync(abs);
+}
+async function discoverThemesFromLocal(source) {
+    const abs = isAbsolute(source) ? source : resolve(process.cwd(), source);
+    if (abs.endsWith(".json")) {
+        const raw = await readFile(abs, "utf-8");
+        const data = JSON.parse(raw);
+        if (!validateTheme(data)) {
+            throw new Error(`${source} is not a valid sound theme.`);
+        }
+        return [
+            {
+                name: data.name,
+                path: abs,
+                downloadUrl: abs,
+                description: data.description,
+                soundCount: Object.keys(data.sounds).length
+            }
+        ];
+    }
+    const files = await readdir(abs);
+    const themes = [];
+    for (const file of files){
+        if (!file.endsWith(".json") || file === "index.json") continue;
+        try {
+            const filePath = join(abs, file);
+            const raw = await readFile(filePath, "utf-8");
+            const data = JSON.parse(raw);
+            if (!validateTheme(data)) continue;
+            themes.push({
+                name: data.name,
+                path: filePath,
+                downloadUrl: filePath,
+                description: data.description,
+                soundCount: Object.keys(data.sounds).length
+            });
+        } catch (unused) {}
+    }
+    return themes;
+}
+async function fetchThemeIndex() {
+    const res = await fetch(`${REGISTRY_BASE}/audio/themes`);
+    if (!res.ok) {
+        throw new Error(`Failed to fetch theme index: ${res.status}`);
+    }
+    return res.json();
+}
+async function fetchThemeJson(nameOrUrl) {
+    const url = nameOrUrl.startsWith("http") ? nameOrUrl : `${REGISTRY_BASE}/audio/theme/${nameOrUrl}`;
+    const res = await fetch(url);
+    if (!res.ok) {
+        throw new Error(`Failed to fetch theme: ${res.status}`);
+    }
+    return res.json();
+}
+async function registerTheme(url) {
+    try {
+        await fetch(`${REGISTRY_BASE}/audio/themes`, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json"
+            },
+            body: JSON.stringify({
+                url
+            })
+        });
+    } catch (unused) {}
+}
+function validateTheme(data) {
+    return typeof data.name === "string" && typeof data.sounds === "object" && data.sounds !== null;
+}
+async function getInstalledThemes() {
+    const dir = getThemesDir();
+    if (!existsSync(dir)) return [];
+    const files = await readdir(dir);
+    const themes = [];
+    for (const file of files){
+        if (!file.endsWith(".ts") || file === "index.ts") continue;
+        try {
+            var _raw_match, _ref;
+            const raw = await readFile(join(dir, file), "utf-8");
+            const nameMatch = raw.match(/^\/\/ theme: (.+)$/m);
+            const exportCount = ((_raw_match = raw.match(/^export const /gm)) != null ? _raw_match : []).length;
+            const name = (_ref = nameMatch == null ? void 0 : nameMatch[1]) != null ? _ref : basename(file, ".ts");
+            themes.push({
+                file,
+                name,
+                soundCount: Math.max(0, exportCount - 1)
+            });
+        } catch (unused) {}
+    }
+    return themes;
+}
+const RESERVED = new Set([
+    "break",
+    "case",
+    "catch",
+    "continue",
+    "debugger",
+    "default",
+    "delete",
+    "do",
+    "else",
+    "finally",
+    "for",
+    "function",
+    "if",
+    "in",
+    "instanceof",
+    "new",
+    "return",
+    "switch",
+    "this",
+    "throw",
+    "try",
+    "typeof",
+    "var",
+    "void",
+    "while",
+    "with",
+    "class",
+    "const",
+    "enum",
+    "export",
+    "extends",
+    "import",
+    "super",
+    "implements",
+    "interface",
+    "let",
+    "package",
+    "private",
+    "protected",
+    "public",
+    "static",
+    "yield",
+    "await"
+]);
+function toCamelCase(s) {
+    let id = s.replace(/[^a-zA-Z0-9]+(.)/g, (_, c)=>c.toUpperCase()).replace(/^[^a-zA-Z_$]/, "_$&");
+    if (RESERVED.has(id)) id = `_${id}`;
+    return id;
+}
+function toIdentifier(s) {
+    return toCamelCase(s);
+}
+function generateModule(data) {
+    const entries = Object.entries(data.sounds);
+    const ids = entries.map(([key])=>toCamelCase(key));
+    const lines = [
+        `// ${data.name} — generated by @litlab/audx (do not edit)`,
+        `// theme: ${data.name}`,
+        `import type { SoundDefinition, SoundPatch } from "@litlab/audx";`,
+        ""
+    ];
+    for(let i = 0; i < entries.length; i++){
+        const [, def] = entries[i];
+        lines.push(`export const ${ids[i]}: SoundDefinition = ${JSON.stringify(def)};`);
+    }
+    const { sounds: _, $schema: _s } = data, meta = _object_without_properties_loose(data, [
+        "sounds",
+        "$schema"
+    ]);
+    const soundsObj = ids.map((id, i)=>{
+        const key = entries[i][0];
+        return id === key ? id : `${JSON.stringify(key)}: ${id}`;
+    });
+    lines.push("", `export const _patch: SoundPatch = {`, `  ...${JSON.stringify(meta)},`, `  sounds: { ${soundsObj.join(", ")} },`, `};`, "");
+    return lines.join("\n");
+}
+function generateSoundModule(name, definition) {
+    const id = toCamelCase(name);
+    return [
+        `import { defineSound } from "@litlab/audx";`,
+        "",
+        `export const ${id} = defineSound(${JSON.stringify(definition, null, 2)});`,
+        ""
+    ].join("\n");
+}
+async function regenerateIndex(dir) {
+    if (!existsSync(dir)) return;
+    const files = await readdir(dir);
+    const modules = files.filter((f)=>f.endsWith(".ts") && f !== "index.ts").map((f)=>basename(f, ".ts")).sort();
+    const lines = [
+        "// generated by @litlab/audx (do not edit)",
+        ...modules.map((m)=>`export * as ${toCamelCase(m)} from "./${m}";`),
+        ""
+    ];
+    await writeFile(join(dir, "index.ts"), lines.join("\n"), "utf-8");
+}
+
+function parseAddOptions(args) {
+    const options = {};
+    let source;
+    for(let i = 0; i < args.length; i++){
+        const arg = args[i];
+        if (arg === "-y" || arg === "--yes") {
+            options.yes = true;
+        } else if (arg === "-l" || arg === "--list") {
+            options.list = true;
+        } else if (arg === "--theme") {
+            options.theme = args[++i];
+        } else if (arg && !arg.startsWith("-")) {
+            source = arg;
+        }
+    }
+    return {
+        source,
+        options
+    };
+}
+async function add(args) {
+    const { source, options } = parseAddOptions(args);
+    p.intro("@litlab/audx add");
+    if (!source) {
+        await addFromRegistry(options);
+        return;
+    }
+    if (isLocalSource(source)) {
+        await addFromLocal(source, options);
+        return;
+    }
+    if (source.startsWith("http") && source.endsWith(".json")) {
+        await addFromUrl(source, options);
+        return;
+    }
+    if (isGitHubSource(source)) {
+        await addFromGitHub(source, options);
+        return;
+    }
+    await addSoundFromRegistry(source, options);
+}
+async function addFromLocal(source, options) {
+    const s = p.spinner();
+    s.start("Scanning local path for themes...");
+    let discovered;
+    try {
+        discovered = await discoverThemesFromLocal(source);
+        s.stop(`Found ${discovered.length} theme(es)`);
+    } catch (err) {
+        s.stop("Failed to scan local path.");
+        p.log.error(String(err));
+        process.exit(1);
+    }
+    if (discovered.length === 0) {
+        p.log.warn("No valid sound themes found at this path.");
+        p.outro("Themes must be JSON files with a name and sounds object.");
+        return;
+    }
+    if (options.list) {
+        printThemeList(discovered);
+        return;
+    }
+    const toInstall = selectThemes(discovered, options);
+    if (!toInstall || toInstall.length === 0) return;
+    const installed = await getInstalledThemes();
+    const installedNames = new Set(installed.map((p)=>p.name));
+    const final = options.yes ? toInstall : await confirmThemeOverwrites(toInstall, installedNames);
+    if (!final || final.length === 0) return;
+    const dl = p.spinner();
+    dl.start(`Installing ${final.length} theme(es)...`);
+    const results = [];
+    for (const theme of final){
+        try {
+            const raw = await readFile(theme.downloadUrl, "utf-8");
+            const data = JSON.parse(raw);
+            if (!validateTheme(data)) {
+                p.log.warn(`Skipping ${theme.name}: invalid theme format`);
+                continue;
+            }
+            await writeTheme(theme.name, data);
+            results.push(data.name);
+        } catch (err) {
+            p.log.warn(`Failed to install ${theme.name}: ${err}`);
+        }
+    }
+    dl.stop(`Installed ${results.length} theme(es)`);
+    p.note(results.map((n)=>`  - ${n}`).join("\n"), "Installed themes");
+    p.outro("Done!");
+}
+async function addFromGitHub(source, options) {
+    const s = p.spinner();
+    s.start("Scanning repository for themes...");
+    let discovered;
+    try {
+        discovered = await discoverThemesFromGitHub(source);
+        s.stop(`Found ${discovered.length} theme(es)`);
+    } catch (err) {
+        s.stop("Failed to scan repository.");
+        p.log.error(String(err));
+        process.exit(1);
+    }
+    if (discovered.length === 0) {
+        p.log.warn("No valid sound themes found in this repository.");
+        p.outro("Themes must be JSON files with a name and sounds object.");
+        return;
+    }
+    if (options.list) {
+        printThemeList(discovered);
+        return;
+    }
+    const installed = await getInstalledThemes();
+    const installedNames = new Set(installed.map((p)=>p.name));
+    const toInstall = await resolveThemeSelection(discovered, installedNames, options);
+    if (!toInstall || toInstall.length === 0) return;
+    const dl = p.spinner();
+    dl.start(`Installing ${toInstall.length} theme(es)...`);
+    const results = [];
+    for (const theme of toInstall){
+        try {
+            const data = await fetchThemeJson(theme.downloadUrl);
+            if (!validateTheme(data)) {
+                p.log.warn(`Skipping ${theme.name}: invalid theme format`);
+                continue;
+            }
+            await writeTheme(theme.name, data);
+            registerTheme(theme.downloadUrl);
+            results.push(data.name);
+        } catch (err) {
+            p.log.warn(`Failed to install ${theme.name}: ${err}`);
+        }
+    }
+    dl.stop(`Installed ${results.length} theme(es)`);
+    p.note(results.map((n)=>`  - ${n}`).join("\n"), "Installed themes");
+    p.outro("Done!");
+}
+async function addFromUrl(url, options) {
+    const s = p.spinner();
+    s.start("Fetching theme...");
+    try {
+        const data = await fetchThemeJson(url);
+        if (!validateTheme(data)) {
+            s.stop("Invalid theme format.");
+            p.log.error("The fetched JSON is not a valid sound theme (missing name or sounds).");
+            process.exit(1);
+        }
+        s.stop(`Fetched "${data.name}"`);
+        if (options.list) {
+            console.log(`  ${pc.bold(data.name)}  ${pc.dim(`${Object.keys(data.sounds).length} sounds`)}`);
+            console.log();
+            return;
+        }
+        await writeTheme(data.name, data);
+        registerTheme(url);
+    } catch (err) {
+        s.stop("Failed to fetch theme.");
+        p.log.error(String(err));
+        process.exit(1);
+    }
+}
+async function addFromRegistry(options) {
+    const s = p.spinner();
+    s.start("Fetching available themes...");
+    let index;
+    try {
+        index = await fetchThemeIndex();
+        s.stop(`Found ${index.length} themes`);
+    } catch (err) {
+        s.stop("Failed to fetch theme index.");
+        p.log.error(String(err));
+        process.exit(1);
+    }
+    if (options.list) {
+        console.log();
+        for (const entry of index){
+            console.log(`  ${pc.bold(entry.name)}  ${pc.dim(entry.description)}`);
+        }
+        console.log();
+        return;
+    }
+    const installed = await getInstalledThemes();
+    const installedNames = new Set(installed.map((p)=>p.name));
+    let names;
+    if (options.theme) {
+        const themeName = options.theme;
+        names = [
+            themeName
+        ];
+        const match = index.find((e)=>e.name.toLowerCase() === themeName.toLowerCase());
+        if (!match) {
+            p.log.error(`Theme "${themeName}" not found in registry.`);
+            process.exit(1);
+        }
+    } else if (options.yes) {
+        names = index.map((e)=>e.name);
+    } else {
+        const selected = await p.multiselect({
+            message: "Select themes to install",
+            options: index.map((entry)=>({
+                    value: entry.name,
+                    label: `${entry.name}${installedNames.has(entry.name) ? " (installed)" : ""}`,
+                    hint: entry.description
+                }))
+        });
+        if (p.isCancel(selected)) {
+            p.cancel("Cancelled.");
+            process.exit(0);
+        }
+        names = selected;
+        if (names.length === 0) {
+            p.outro("No themes selected.");
+            return;
+        }
+    }
+    if (!options.yes) {
+        const existing = names.filter((n)=>installedNames.has(n));
+        if (existing.length > 0) {
+            const overwrite = await p.confirm({
+                message: `${existing.length} theme(es) already installed. Overwrite?`
+            });
+            if (p.isCancel(overwrite) || !overwrite) {
+                p.cancel("Cancelled.");
+                process.exit(0);
+            }
+        }
+    }
+    const dl = p.spinner();
+    dl.start(`Downloading ${names.length} theme(es)...`);
+    const results = [];
+    for (const name of names){
+        try {
+            const data = await fetchThemeJson(name);
+            if (!validateTheme(data)) {
+                p.log.warn(`Skipping ${name}: invalid theme format`);
+                continue;
+            }
+            await writeTheme(name, data);
+            results.push(data.name);
+        } catch (err) {
+            p.log.warn(`Failed to download ${name}: ${err}`);
+        }
+    }
+    dl.stop(`Downloaded ${results.length} theme(es)`);
+    p.note(results.map((n)=>`  - ${n}`).join("\n"), "Installed themes");
+    p.outro("Done!");
+}
+async function addSoundFromRegistry(soundName, options) {
+    if (options.list) {
+        p.log.error("--list is only available when browsing themes.");
+        process.exit(1);
+    }
+    const s = p.spinner();
+    s.start(`Finding "${soundName}"...`);
+    let index;
+    try {
+        index = await fetchThemeIndex();
+    } catch (err) {
+        s.stop("Failed to fetch theme index.");
+        p.log.error(String(err));
+        process.exit(1);
+    }
+    let found;
+    for (const entry of index){
+        try {
+            const data = await fetchThemeJson(entry.name);
+            if (!validateTheme(data)) continue;
+            const match = Object.entries(data.sounds).find(([name])=>name.toLowerCase() === soundName.toLowerCase());
+            if (match) {
+                found = {
+                    theme: data.name,
+                    definition: match[1]
+                };
+                break;
+            }
+        } catch (unused) {}
+    }
+    if (!found) {
+        s.stop(`Sound "${soundName}" not found.`);
+        p.log.error("Run `@litlab/audx add` to browse available themes.");
+        process.exit(1);
+    }
+    s.stop(`Found "${soundName}" in ${found.theme}`);
+    await writeSound(soundName, found.definition, options);
+    p.note(`  - ${soundName}`, "Installed sound");
+    p.outro("Done!");
+}
+function printThemeList(themes) {
+    console.log();
+    for (const theme of themes){
+        const desc = theme.description ? `  ${pc.dim(theme.description)}` : "";
+        console.log(`  ${pc.bold(theme.name)}  ${pc.dim(`${theme.soundCount} sounds`)}${desc}`);
+    }
+    console.log();
+}
+function selectThemes(discovered, options) {
+    if (options.theme) {
+        const themeName = options.theme;
+        const match = discovered.filter((d)=>d.name.toLowerCase() === themeName.toLowerCase());
+        if (match.length === 0) {
+            p.log.error(`Theme "${themeName}" not found.`);
+            process.exit(1);
+        }
+        return match;
+    }
+    if (options.yes) return discovered;
+    return discovered;
+}
+async function resolveThemeSelection(discovered, installedNames, options) {
+    if (options.theme) {
+        const themeName = options.theme;
+        const match = discovered.filter((d)=>d.name.toLowerCase() === themeName.toLowerCase());
+        if (match.length === 0) {
+            p.log.error(`Theme "${themeName}" not found.`);
+            process.exit(1);
+        }
+        return match;
+    }
+    if (options.yes) return discovered;
+    if (discovered.length === 1) return discovered;
+    return await promptThemeSelection(discovered, installedNames);
+}
+async function promptThemeSelection(discovered, installedNames) {
+    const selected = await p.multiselect({
+        message: "Select themes to install",
+        options: discovered.map((theme)=>({
+                value: theme.name,
+                label: `${theme.name}${installedNames.has(theme.name) ? " (installed)" : ""}`,
+                hint: theme.description ? `${theme.soundCount} sounds — ${theme.description}` : `${theme.soundCount} sounds`
+            }))
+    });
+    if (p.isCancel(selected)) {
+        p.cancel("Cancelled.");
+        process.exit(0);
+    }
+    const names = new Set(selected);
+    return discovered.filter((d)=>names.has(d.name));
+}
+async function confirmThemeOverwrites(themes, installedNames) {
+    const existing = themes.filter((theme)=>installedNames.has(theme.name));
+    if (existing.length === 0) return themes;
+    const overwrite = await p.confirm({
+        message: `${existing.length} theme(es) already installed. Overwrite?`
+    });
+    if (p.isCancel(overwrite) || !overwrite) {
+        p.cancel("Cancelled.");
+        process.exit(0);
+    }
+    return themes;
+}
+async function writeTheme(filename, data) {
+    await ensureConfig("themes");
+    const dir = getThemesDir();
+    if (!existsSync(dir)) {
+        mkdirSync(dir, {
+            recursive: true
+        });
+    }
+    const slug = filename.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "");
+    const moduleSource = generateModule(data);
+    const target = join(dir, `${slug}.ts`);
+    await writeFile(target, moduleSource, "utf-8");
+    await regenerateIndex(dir);
+}
+async function writeSound(name, definition, options) {
+    await ensureConfig("setup");
+    const dir = getSoundsDir();
+    if (!existsSync(dir)) {
+        mkdirSync(dir, {
+            recursive: true
+        });
+    }
+    const slug = name.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "");
+    const target = join(dir, `${slug}.ts`);
+    if (existsSync(target) && !options.yes) {
+        const overwrite = await p.confirm({
+            message: `${slug}.ts already exists. Overwrite?`
+        });
+        if (p.isCancel(overwrite) || !overwrite) {
+            p.cancel("Cancelled.");
+            process.exit(0);
+        }
+    }
+    await writeFile(target, generateSoundModule(toIdentifier(name), definition), "utf-8");
+}
+
+async function check(_args) {
+    p.intro("@litlab/audx check");
+    const installed = await getInstalledThemes();
+    if (installed.length === 0) {
+        p.log.warn("No themes installed.");
+        p.outro("Install themes with npx @litlab/audx add");
+        return;
+    }
+    const s = p.spinner();
+    s.start("Checking for updates...");
+    let registry;
+    try {
+        registry = await fetchThemeIndex();
+        s.stop(`Checked ${registry.length} registry theme(es)`);
+    } catch (err) {
+        s.stop("Failed to fetch registry.");
+        p.log.error(String(err));
+        process.exit(1);
+    }
+    const registryMap = new Map(registry.map((e)=>[
+            e.name.toLowerCase(),
+            e
+        ]));
+    const available = [];
+    const notInRegistry = [];
+    for (const entry of installed){
+        const regEntry = registryMap.get(entry.name.toLowerCase());
+        if (regEntry) {
+            available.push(entry.name);
+        } else {
+            notInRegistry.push(entry.name);
+        }
+    }
+    if (available.length === 0) {
+        p.log.warn("No installed themes found in the registry.");
+        p.outro("");
+        return;
+    }
+    p.note(available.map((name)=>`  ↑ ${name}`).join("\n"), `${available.length} theme(es) available`);
+    if (notInRegistry.length > 0) {
+        p.log.warn([
+            `${notInRegistry.length} theme(es) not found in registry:`,
+            ...notInRegistry.map((name)=>`  • ${name}`)
+        ].join("\n"));
+    }
+    p.outro("Run npx @litlab/audx update to re-download latest versions");
+}
+
+async function find(args) {
+    const query = args.join(" ").toLowerCase();
+    p.intro("@litlab/audx find");
+    const s = p.spinner();
+    s.start("Fetching registry...");
+    let index;
+    try {
+        index = await fetchThemeIndex();
+        s.stop(`Found ${index.length} theme(es) in registry`);
+    } catch (err) {
+        s.stop("Failed to fetch registry.");
+        p.log.error(String(err));
+        process.exit(1);
+    }
+    if (index.length === 0) {
+        p.log.warn("No themes available in the registry.");
+        p.outro("");
+        return;
+    }
+    const matches = query ? index.filter((entry)=>{
+        var _entry_tags;
+        const haystack = `${entry.name} ${entry.description} ${((_entry_tags = entry.tags) != null ? _entry_tags : []).join(" ")}`.toLowerCase();
+        return haystack.includes(query);
+    }) : index;
+    if (matches.length === 0) {
+        p.log.warn(`No themes found for "${query}"`);
+        p.outro("");
+        return;
+    }
+    p.log.info("Install with npx @litlab/audx add --theme <name>");
+    for (const entry of matches){
+        const tags = entry.tags && entry.tags.length > 0 ? `  ${entry.tags.join(", ")}` : "";
+        const desc = entry.description ? `\n  ${entry.description}` : "";
+        p.log.step(`${entry.name}${tags}${desc}`);
+    }
+    p.outro(`${matches.length} result(s)`);
+}
+
+async function init(args) {
+    if (args[0] === "theme") {
+        await themeInit(args.slice(1));
+        return;
+    }
+    p.intro("@litlab/audx init");
+    await ensureConfig();
+    await add([]);
+}
+async function themeInit(_args) {
+    p.intro("@litlab/audx theme init");
+    const name = await p.text({
+        message: "Theme name",
+        placeholder: "my-theme",
+        validate: (v)=>v.length === 0 ? "Name is required" : undefined
+    });
+    if (p.isCancel(name)) {
+        p.cancel("Cancelled.");
+        process.exit(0);
+    }
+    const author = await p.text({
+        message: "Author",
+        placeholder: "Your name"
+    });
+    if (p.isCancel(author)) {
+        p.cancel("Cancelled.");
+        process.exit(0);
+    }
+    const description = await p.text({
+        message: "Description",
+        placeholder: "What does this theme sound like?"
+    });
+    if (p.isCancel(description)) {
+        p.cancel("Cancelled.");
+        process.exit(0);
+    }
+    const slug = name.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "");
+    const filename = `${slug}.json`;
+    const dir = resolve(process.cwd(), ".audx", "themes");
+    if (!existsSync(dir)) {
+        mkdirSync(dir, {
+            recursive: true
+        });
+    }
+    const target = resolve(dir, filename);
+    if (existsSync(target)) {
+        const overwrite = await p.confirm({
+            message: `${filename} already exists. Overwrite?`
+        });
+        if (p.isCancel(overwrite) || !overwrite) {
+            p.cancel("Cancelled.");
+            process.exit(0);
+        }
+    }
+    const theme = {
+        $schema: "../../node_modules/@litlab/audx/schemas/theme.schema.json",
+        name: name,
+        author: author || undefined,
+        version: "1.0.0",
+        description: description || undefined,
+        tags: [],
+        sounds: {}
+    };
+    await writeFile(target, `${JSON.stringify(theme, null, 2)}\n`, "utf-8");
+    p.log.success(`Created .audx/themes/${filename}`);
+    p.outro("Add sounds to the `sounds` object to get started.");
+}
+
+async function list(_args) {
+    p.intro("@litlab/audx list");
+    const themes = await getInstalledThemes();
+    if (themes.length === 0) {
+        p.log.warn(`No themes found in ${getThemesDir()}`);
+        p.outro("Run `@litlab/audx add` to install themes.");
+        return;
+    }
+    const rows = themes.map((theme)=>{
+        var _theme_description;
+        return `  ${theme.name.padEnd(16)} ${String(theme.soundCount).padStart(3)} sounds   ${(_theme_description = theme.description) != null ? _theme_description : ""}`;
+    });
+    p.note(rows.join("\n"), `${themes.length} theme(es) installed`);
+    p.outro(getThemesDir());
+}
+
+function parseRemoveOptions(args) {
+    const options = {};
+    const themes = [];
+    for(let i = 0; i < args.length; i++){
+        const arg = args[i];
+        if (arg === "-y" || arg === "--yes") {
+            options.yes = true;
+        } else if (arg && !arg.startsWith("-")) {
+            themes.push(arg);
+        }
+    }
+    return {
+        themes,
+        options
+    };
+}
+async function remove(args) {
+    const { themes: themeNames, options } = parseRemoveOptions(args);
+    p.intro("@litlab/audx remove");
+    const themes = await getInstalledThemes();
+    if (themes.length === 0) {
+        p.log.warn("No themes installed.");
+        p.outro("Nothing to remove.");
+        return;
+    }
+    let files;
+    if (themeNames.length > 0) {
+        const matched = themes.filter((pk)=>themeNames.some((n)=>n.toLowerCase() === pk.name.toLowerCase()));
+        if (matched.length === 0) {
+            p.log.error(`No matching themes found for: ${themeNames.join(", ")}`);
+            return;
+        }
+        files = matched.map((pk)=>pk.file);
+    } else {
+        const selected = await p.multiselect({
+            message: "Select themes to remove",
+            options: themes.map((pk)=>({
+                    value: pk.file,
+                    label: pk.name,
+                    hint: `${pk.soundCount} sounds`
+                }))
+        });
+        if (p.isCancel(selected)) {
+            p.cancel("Cancelled.");
+            process.exit(0);
+        }
+        files = selected;
+        if (files.length === 0) {
+            p.outro("No themes selected.");
+            return;
+        }
+    }
+    if (!options.yes) {
+        const confirmed = await p.confirm({
+            message: `Remove ${files.length} theme(es)?`
+        });
+        if (p.isCancel(confirmed) || !confirmed) {
+            p.cancel("Cancelled.");
+            process.exit(0);
+        }
+    }
+    const dir = getThemesDir();
+    const removed = [];
+    for (const file of files){
+        try {
+            var _ref;
+            await unlink(join(dir, file));
+            const pk = themes.find((item)=>item.file === file);
+            removed.push((_ref = pk == null ? void 0 : pk.name) != null ? _ref : file);
+        } catch (err) {
+            p.log.warn(`Failed to remove ${file}: ${err}`);
+        }
+    }
+    await regenerateIndex(dir);
+    p.note(removed.map((n)=>`  - ${n}`).join("\n"), "Removed themes");
+    p.outro("Done!");
+}
+
+async function update(_args) {
+    p.intro("@litlab/audx update");
+    const installed = await getInstalledThemes();
+    if (installed.length === 0) {
+        p.log.warn("No themes installed.");
+        p.outro("Install themes with npx @litlab/audx add");
+        return;
+    }
+    const s = p.spinner();
+    s.start("Fetching registry...");
+    let registry;
+    try {
+        registry = await fetchThemeIndex();
+        s.stop(`Found ${registry.length} registry theme(es)`);
+    } catch (err) {
+        s.stop("Failed to fetch registry.");
+        p.log.error(String(err));
+        process.exit(1);
+    }
+    const registryMap = new Map(registry.map((e)=>[
+            e.name.toLowerCase(),
+            e
+        ]));
+    const toUpdate = installed.filter((pk)=>registryMap.has(pk.name.toLowerCase()));
+    if (toUpdate.length === 0) {
+        p.log.warn("No installed themes found in the registry.");
+        p.outro("");
+        return;
+    }
+    const dl = p.spinner();
+    dl.start(`Updating ${toUpdate.length} theme(es)...`);
+    let successCount = 0;
+    let failCount = 0;
+    const dir = getThemesDir();
+    if (!existsSync(dir)) {
+        mkdirSync(dir, {
+            recursive: true
+        });
+    }
+    for (const entry of toUpdate){
+        try {
+            const data = await fetchThemeJson(entry.name);
+            if (!validateTheme(data)) {
+                failCount++;
+                continue;
+            }
+            const slug = entry.name.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "");
+            const moduleSource = generateModule(data);
+            const target = join(dir, `${slug}.ts`);
+            await writeFile(target, moduleSource, "utf-8");
+            successCount++;
+        } catch (unused) {
+            failCount++;
+        }
+    }
+    await regenerateIndex(dir);
+    dl.stop(`Updated ${successCount} theme(es)`);
+    if (failCount > 0) {
+        p.log.warn(`Failed to update ${failCount} theme(es)`);
+    }
+    p.outro("Done!");
+}
+
+const __filename$1 = __node_cjsUrl.fileURLToPath(import.meta.url);
+__node_cjsPath.dirname(__filename$1);
+
+const COMMANDS = {
+    add,
+    a: add,
+    find,
+    search: find,
+    f: find,
+    s: find,
+    list,
+    ls: list,
+    remove,
+    rm: remove,
+    check,
+    update,
+    upgrade: update,
+    init,
+    theme: async (args)=>{
+        if (args[0] !== "init") {
+            var _args_;
+            p.log.error(`Unknown theme command: ${(_args_ = args[0]) != null ? _args_ : ""}`);
+            p.log.message("Run @litlab/audx theme init to create a new theme.");
+            process.exit(1);
+        }
+        await themeInit(args.slice(1));
+    }
+};
+function showBanner() {
+    p.intro("@litlab/audx");
+    p.log.message("Manage sound themes for your project.");
+    p.log.message([
+        "Themes",
+        "  add [sound]     Install an individual sound",
+        "  add             Browse and install themes",
+        "  find [query]    Search for themes",
+        "  list            List installed themes",
+        "  remove          Remove installed themes"
+    ].join("\n"));
+    p.log.message([
+        "Updates",
+        "  check           Check for updates",
+        "  update          Update installed themes"
+    ].join("\n"));
+    p.log.message([
+        "Project",
+        "  init            Set up AudX and install themes",
+        "  theme init      Create a new local theme JSON"
+    ].join("\n"));
+    p.outro("try: npx @litlab/audx add ommgh/audio");
+}
+function showHelp() {
+    p.intro("@litlab/audx");
+    p.log.message([
+        "Usage: @litlab/audx <command> [options]",
+        "",
+        "Manage Themes:",
+        "  add [sound]     Install an individual sound",
+        "  add             Browse and install themes",
+        "  add <source>    Install themes from a source",
+        "  find [query]    Search for themes in the registry",
+        "  list, ls        List installed themes",
+        "  remove, rm      Remove installed themes",
+        "",
+        "Updates:",
+        "  check           Check for available updates",
+        "  update          Update all installed themes",
+        "",
+        "Project:",
+        "  init            Set up AudX and install themes",
+        "  theme init      Create a new local theme JSON"
+    ].join("\n"));
+    p.log.message([
+        "Add Options:",
+        "  -l, --list      Preview available themes without installing",
+        "  -y, --yes       Skip confirmation prompts",
+        "  --theme <name>  Install a specific theme by name",
+        "",
+        "Remove Options:",
+        "  -y, --yes       Skip confirmation prompts"
+    ].join("\n"));
+    p.log.message([
+        "Source Formats:",
+        "  ./local/path                    Local file or directory",
+        "  owner/repo                      GitHub shorthand",
+        "  https://github.com/user/repo    Full GitHub URL",
+        "  https://...theme.json           Direct URL to a theme file",
+        "  (no argument)                   Browse the registry"
+    ].join("\n"));
+    p.log.message([
+        "Options:",
+        "  --help, -h      Show this help message",
+        "  --version, -v   Show version number"
+    ].join("\n"));
+    p.note([
+        "  @litlab/audx add ommgh/audio",
+        "  @litlab/audx add ./.themes/",
+        "  @litlab/audx add ommgh/audio --list",
+        "  @litlab/audx add --theme core -y",
+        "  @litlab/audx remove core -y",
+        "  @litlab/audx find ambient",
+        "  @litlab/audx check",
+        "  @litlab/audx update"
+    ].join("\n"), "Examples");
+    p.outro("");
+}
+async function run() {
+    const args = process.argv.slice(2);
+    const command = args[0];
+    if (!command) {
+        showBanner();
+        return;
+    }
+    if (command === "--help" || command === "-h") {
+        showHelp();
+        return;
+    }
+    if (command === "--version" || command === "-v") {
+        try {
+            const { readFileSync } = await import('node:fs');
+            const { join, dirname } = await import('node:path');
+            const { fileURLToPath } = await import('node:url');
+            const __dirname = dirname(fileURLToPath(import.meta.url));
+            const pkg = JSON.parse(readFileSync(join(__dirname, "..", "package.json"), "utf-8"));
+            console.log(pkg.version);
+        } catch (unused) {
+            console.log("0.0.0");
+        }
+        return;
+    }
+    const handler = COMMANDS[command];
+    if (!handler) {
+        p.log.error(`Unknown command: ${command}`);
+        p.log.message("Run @litlab/audx --help for usage information.");
+        process.exit(1);
+    }
+    await handler(args.slice(1));
+}
+
+run();