@litlab/audx 0.0.1

package/README.md

@@ -0,0 +1,86 @@
+# audx
+
+CLI tool for distributing and managing UI sounds from the [audx](https://audx.dev) registry.
+
+## Install
+
+```bash
+npm install -g audx
+```
+
+Or use directly with `npx`:
+
+```bash
+npx audx <command>
+```
+
+## Quick Start
+
+```bash
+# Initialize audx in your project
+audx init
+
+# Browse available sounds
+audx list
+
+# Add a sound
+audx add click-001
+
+# Set up themes
+audx theme init
+audx theme map click click-001
+audx theme generate
+```
+
+## Commands
+
+| Command | Description |
+|---|---|
+| `audx init` | Initialize audx config in your project |
+| `audx add <sounds...>` | Add sounds from the registry |
+| `audx remove <sounds...>` | Remove installed sounds |
+| `audx list` | List available sounds (`--tag`, `--search`) |
+| `audx diff` | Check for updates to installed sounds |
+| `audx update [sound]` | Update installed sounds from registry |
+| `audx generate "<prompt>"` | Generate a sound from a text prompt (`--name`, `--duration`) |
+| `audx theme init` | Create theme configuration |
+| `audx theme set <name>` | Switch active theme |
+| `audx theme map <semantic> <sound>` | Map a semantic name to a sound |
+| `audx theme create <name>` | Create a new theme |
+| `audx theme list` | List all themes |
+| `audx theme generate` | Generate `sound-theme.ts` |
+
+## How It Works
+
+audx manages UI sounds as TypeScript modules with base64-encoded audio data — no external files to serve. Sounds are fetched from the audx registry and written directly into your project.
+
+The theme system lets you reference sounds by semantic purpose (`play("success")`) instead of file names, and swap entire sound palettes by switching themes.
+
+## Configuration
+
+Running `audx init` creates `audx.config.json`:
+
+```json
+{
+  "soundDir": "src/sounds",
+  "libDir": "src/lib",
+  "registryUrl": "https://audx.dev",
+  "packageManager": "pnpm",
+  "aliases": {
+    "lib": "@/lib",
+    "hooks": "@/hooks",
+    "sounds": "@/sounds"
+  },
+  "installedSounds": {}
+}
+```
+
+Path aliases are auto-detected from your `tsconfig.json`.
+
+## Requirements
+
+- Node.js 18+
+
+## License
+
+MIT

package/dist/codegen/theme-codegen.d.ts

@@ -0,0 +1,12 @@
+import type { AliasMap, AudxConfig, ThemeConfig } from "../types.js";
+/**
+ * Generate the `sound-theme.ts` TypeScript source from a theme configuration.
+ *
+ * The generated file exports:
+ * - `SemanticSoundName` — union type of all semantic names present in the themes
+ * - `soundThemes` — object mapping theme names to their sound mappings
+ * - `play(name)` — plays the mapped sound in the active theme (no-ops for null)
+ * - `setSoundTheme(themeName)` — switches the active theme at runtime
+ */
+export declare function generate(themeConfig: ThemeConfig, aliasMap: AliasMap, config: AudxConfig): string;
+//# sourceMappingURL=theme-codegen.d.ts.map

package/dist/codegen/theme-codegen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme-codegen.d.ts","sourceRoot":"","sources":["../../src/codegen/theme-codegen.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAErE;;;;;;;;GAQG;AACH,wBAAgB,QAAQ,CACvB,WAAW,EAAE,WAAW,EACxB,QAAQ,EAAE,QAAQ,EAClB,MAAM,EAAE,UAAU,GAChB,MAAM,CAuER"}

package/dist/codegen/theme-codegen.js

@@ -0,0 +1,153 @@
+import { resolveImport } from "../core/alias-resolver.js";
+/**
+ * Generate the `sound-theme.ts` TypeScript source from a theme configuration.
+ *
+ * The generated file exports:
+ * - `SemanticSoundName` — union type of all semantic names present in the themes
+ * - `soundThemes` — object mapping theme names to their sound mappings
+ * - `play(name)` — plays the mapped sound in the active theme (no-ops for null)
+ * - `setSoundTheme(themeName)` — switches the active theme at runtime
+ */
+export function generate(themeConfig, aliasMap, config) {
+    // The generated file lives in libDir (e.g. "src/lib/sound-theme.ts")
+    const generatedFilePath = `${config.libDir}/sound-theme.ts`;
+    // Collect all unique semantic names across all themes
+    const semanticNames = collectSemanticNames(themeConfig);
+    // Collect all unique non-null sound file paths across all themes
+    const soundPaths = collectSoundPaths(themeConfig);
+    // Build import statements for each sound module
+    const imports = buildImports(soundPaths, generatedFilePath, aliasMap);
+    // Resolve the audio-engine import path
+    const audioEngineImport = resolveImport(aliasMap, generatedFilePath, `${config.libDir}/audio-engine.ts`);
+    const lines = [];
+    // File header
+    lines.push("// This file is auto-generated by audx. Do not edit manually.");
+    lines.push("");
+    // Audio engine import
+    lines.push(`import { playAudio } from "${audioEngineImport}";`);
+    // Sound module imports
+    for (const { importName, importPath } of imports) {
+        lines.push(`import { default as ${importName} } from "${importPath}";`);
+    }
+    lines.push("");
+    // SemanticSoundName type union
+    lines.push(buildSemanticSoundNameType(semanticNames));
+    lines.push("");
+    // soundThemes object
+    lines.push(buildSoundThemesObject(themeConfig, soundPaths, generatedFilePath, aliasMap));
+    lines.push("");
+    // Runtime state
+    lines.push(`let activeTheme = "${themeConfig.activeTheme}";`);
+    lines.push("");
+    // setSoundTheme function
+    lines.push("export function setSoundTheme(themeName: string): void {");
+    lines.push("  activeTheme = themeName;");
+    lines.push("}");
+    lines.push("");
+    // play function
+    lines.push("export function play(name: SemanticSoundName): void {");
+    lines.push("  const theme = soundThemes[activeTheme];");
+    lines.push("  if (!theme) return;");
+    lines.push("  const asset = theme[name];");
+    lines.push("  if (!asset) return;");
+    lines.push("  playAudio(asset.dataUri);");
+    lines.push("}");
+    lines.push("");
+    return lines.join("\n");
+}
+/**
+ * Collect all unique semantic names across all themes.
+ */
+function collectSemanticNames(themeConfig) {
+    const names = new Set();
+    for (const mappings of Object.values(themeConfig.themes)) {
+        for (const key of Object.keys(mappings)) {
+            names.add(key);
+        }
+    }
+    return Array.from(names).sort();
+}
+/**
+ * Collect all unique non-null sound file paths across all themes.
+ */
+function collectSoundPaths(themeConfig) {
+    const paths = new Set();
+    for (const mappings of Object.values(themeConfig.themes)) {
+        for (const value of Object.values(mappings)) {
+            if (value !== null) {
+                paths.add(value);
+            }
+        }
+    }
+    return Array.from(paths).sort();
+}
+/**
+ * Derive a safe import variable name from a sound file path.
+ * e.g. "src/sounds/click-001.ts" → "click001Sound"
+ */
+function deriveImportName(soundPath) {
+    const fileName = soundPath.split("/").pop() ?? soundPath;
+    const baseName = fileName.replace(/\.(tsx?|jsx?|mjs|cjs)$/, "");
+    // Convert kebab-case to camelCase and append "Sound"
+    const camel = baseName
+        .split("-")
+        .map((part, i) => i === 0
+        ? part.toLowerCase()
+        : part.charAt(0).toUpperCase() + part.slice(1).toLowerCase())
+        .join("");
+    return `${camel}Sound`;
+}
+/**
+ * Build import statements for all sound modules.
+ */
+function buildImports(soundPaths, generatedFilePath, aliasMap) {
+    return soundPaths.map((soundPath) => {
+        const importPath = resolveImport(aliasMap, generatedFilePath, soundPath);
+        const importName = deriveImportName(soundPath);
+        return { importName, importPath, originalPath: soundPath };
+    });
+}
+/**
+ * Build the `SemanticSoundName` type union string.
+ */
+function buildSemanticSoundNameType(semanticNames) {
+    if (semanticNames.length === 0) {
+        return "export type SemanticSoundName = never;";
+    }
+    const members = semanticNames.map((n) => `"${n}"`).join(" | ");
+    return `export type SemanticSoundName = ${members};`;
+}
+/**
+ * Build the `soundThemes` object source code.
+ */
+function buildSoundThemesObject(themeConfig, soundPaths, generatedFilePath, aliasMap) {
+    // Build a lookup from original path → import variable name
+    const pathToImportName = new Map();
+    for (const soundPath of soundPaths) {
+        pathToImportName.set(soundPath, deriveImportName(soundPath));
+    }
+    const lines = [];
+    lines.push("export const soundThemes: Record<string, Record<SemanticSoundName, { dataUri: string } | null>> = {");
+    for (const [themeName, mappings] of Object.entries(themeConfig.themes)) {
+        lines.push(`  "${themeName}": {`);
+        const sortedEntries = Object.entries(mappings).sort(([a], [b]) => a.localeCompare(b));
+        for (const [semanticName, soundPath] of sortedEntries) {
+            if (soundPath === null) {
+                lines.push(`    "${semanticName}": null,`);
+            }
+            else {
+                const importName = pathToImportName.get(soundPath);
+                if (importName) {
+                    lines.push(`    "${semanticName}": ${importName},`);
+                }
+                else {
+                    lines.push(`    "${semanticName}": null,`);
+                }
+            }
+        }
+        lines.push("  },");
+    }
+    lines.push("};");
+    return lines.join("\n");
+}
+//# sourceMappingURL=theme-codegen.js.map

package/dist/codegen/theme-codegen.js.map

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

package/dist/commands/add.d.ts

@@ -0,0 +1,2 @@
+export declare function addCommand(sounds: string[], projectRoot: string): Promise<void>;
+//# sourceMappingURL=add.d.ts.map

package/dist/commands/add.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"add.d.ts","sourceRoot":"","sources":["../../src/commands/add.ts"],"names":[],"mappings":"AAiEA,wBAAsB,UAAU,CAC/B,MAAM,EAAE,MAAM,EAAE,EAChB,WAAW,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC,CAwEf"}

package/dist/commands/add.js

@@ -0,0 +1,120 @@
+import { existsSync } from "node:fs";
+import { basename, dirname, join } from "node:path";
+import { createInterface } from "node:readline";
+import { loadFromTsConfig } from "../core/alias-resolver.js";
+import * as ConfigManager from "../core/config.js";
+import { writeRegistryFile } from "../core/file-writer.js";
+import { fetchItem } from "../core/registry.js";
+/**
+ * Prompt the user with a yes/no question via stdin/stdout.
+ * Returns `true` when the user answers y/yes (case-insensitive).
+ */
+function confirm(question) {
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    return new Promise((resolve) => {
+        rl.question(question, (answer) => {
+            rl.close();
+            resolve(/^y(es)?$/i.test(answer.trim()));
+        });
+    });
+}
+/**
+ * Check whether a registry file would conflict with an existing file on disk.
+ * Returns the resolved target path if a conflict exists, otherwise null.
+ */
+function getConflictPath(file, targetDir, config) {
+    const fileName = basename(file.path);
+    let targetPath;
+    if (file.type === "registry:hook") {
+        const hooksDir = join(dirname(config.libDir), "hooks");
+        targetPath = join(hooksDir, fileName);
+    }
+    else if (file.type === "registry:lib") {
+        const normalised = file.path.replace(/\\/g, "/");
+        if (normalised.includes("/sounds/")) {
+            targetPath = join(targetDir, fileName);
+        }
+        else {
+            targetPath = join(config.libDir, fileName);
+        }
+    }
+    else {
+        targetPath = join(targetDir, fileName);
+    }
+    return existsSync(targetPath) ? targetPath : null;
+}
+/**
+ * Determine whether a registry file is a shared dependency (lib or hook)
+ * rather than the primary sound module.
+ */
+function isDependencyFile(file) {
+    if (file.type === "registry:hook")
+        return true;
+    if (file.type === "registry:lib") {
+        const normalised = file.path.replace(/\\/g, "/");
+        return !normalised.includes("/sounds/");
+    }
+    return false;
+}
+export async function addCommand(sounds, projectRoot) {
+    // Requirement 3.8 — config must exist
+    if (!ConfigManager.exists(projectRoot)) {
+        console.error("Configuration not found. Run 'audx init' first.");
+        process.exit(1);
+    }
+    const config = ConfigManager.read(projectRoot);
+    const aliasMap = loadFromTsConfig(projectRoot);
+    const updatedConfig = {
+        ...config,
+        installedSounds: { ...config.installedSounds },
+    };
+    for (const soundName of sounds) {
+        try {
+            // Requirement 3.1 — fetch registry item
+            const item = await fetchItem(config.registryUrl, soundName);
+            const targetDir = join(projectRoot, config.soundDir);
+            const writtenFiles = [];
+            for (const file of item.files) {
+                // Requirement 3.5 — skip dependency files that already exist
+                if (isDependencyFile(file)) {
+                    const conflictPath = getConflictPath(file, targetDir, config);
+                    if (conflictPath) {
+                        writtenFiles.push(conflictPath);
+                        continue;
+                    }
+                }
+                else {
+                    // Requirement 3.9 — prompt on file conflicts for non-dependency files
+                    const conflictPath = getConflictPath(file, targetDir, config);
+                    if (conflictPath) {
+                        const overwrite = await confirm(`File '${conflictPath}' already exists. Overwrite? (y/N) `);
+                        if (!overwrite) {
+                            console.log(`  Skipped ${conflictPath}`);
+                            continue;
+                        }
+                    }
+                }
+                // Requirement 3.2, 3.3 — write file with import rewriting
+                const writtenPath = writeRegistryFile(file, targetDir, aliasMap, config);
+                if (writtenPath) {
+                    writtenFiles.push(writtenPath);
+                }
+            }
+            // Requirement 3.6 — update installedSounds in config
+            updatedConfig.installedSounds[soundName] = {
+                files: writtenFiles,
+                installedAt: new Date().toISOString(),
+            };
+            console.log(`✔ Added ${soundName}`);
+        }
+        catch (error) {
+            // Requirement 3.7 — handle HTTP errors with sound name and status code
+            const message = error instanceof Error ? error.message : String(error);
+            console.error(`✘ ${message}`);
+            process.exit(2);
+        }
+    }
+    // Write updated config once after all sounds are processed
+    ConfigManager.write(projectRoot, updatedConfig);
+}
+//# sourceMappingURL=add.js.map

package/dist/commands/add.js.map

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

package/dist/commands/diff.d.ts

@@ -0,0 +1,2 @@
+export declare function diffCommand(projectRoot: string): Promise<void>;
+//# sourceMappingURL=diff.d.ts.map

package/dist/commands/diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.d.ts","sourceRoot":"","sources":["../../src/commands/diff.ts"],"names":[],"mappings":"AA+EA,wBAAsB,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA2CpE"}

package/dist/commands/diff.js

@@ -0,0 +1,103 @@
+import { readFileSync } from "node:fs";
+import { basename, dirname, join } from "node:path";
+import * as ConfigManager from "../core/config.js";
+import { fetchItem } from "../core/registry.js";
+/**
+ * Resolve the expected local file path for a registry file based on its type
+ * and the project config.
+ */
+function resolveLocalPath(file, config, projectRoot) {
+    const fileName = basename(file.path);
+    if (file.type === "registry:hook") {
+        const hooksDir = join(dirname(config.libDir), "hooks");
+        return join(projectRoot, hooksDir, fileName);
+    }
+    if (file.type === "registry:lib") {
+        const normalised = file.path.replace(/\\/g, "/");
+        if (normalised.includes("/sounds/")) {
+            return join(projectRoot, config.soundDir, fileName);
+        }
+        return join(projectRoot, config.libDir, fileName);
+    }
+    return join(projectRoot, config.soundDir, fileName);
+}
+/**
+ * Read local file content, returning null if the file cannot be read.
+ */
+function readLocalFile(filePath) {
+    try {
+        return readFileSync(filePath, "utf-8");
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Compare registry file content against local file content.
+ * Returns true if the files differ (ignoring import path differences
+ * is not feasible here — we compare raw registry content against local).
+ *
+ * Since local files have rewritten imports, we only compare the sound
+ * module files (the primary files in /sounds/) by checking if the local
+ * file exists and has different content length or key data sections.
+ * For a pragmatic approach, we compare the full content of each registry
+ * file against the local file. Note: import-rewritten files will always
+ * show as different if aliases differ from registry defaults, but this
+ * is the expected behavior for detecting upstream changes.
+ */
+function hasChanges(registryFiles, config, projectRoot) {
+    for (const file of registryFiles) {
+        const localPath = resolveLocalPath(file, config, projectRoot);
+        const localContent = readLocalFile(localPath);
+        if (localContent === null) {
+            // File missing locally — counts as a difference
+            return true;
+        }
+        // Compare registry content against local content
+        if (file.content !== localContent) {
+            return true;
+        }
+    }
+    return false;
+}
+export async function diffCommand(projectRoot) {
+    // Config must exist
+    if (!ConfigManager.exists(projectRoot)) {
+        console.error("Configuration not found. Run 'audx init' first.");
+        process.exit(1);
+    }
+    const config = ConfigManager.read(projectRoot);
+    const installedNames = Object.keys(config.installedSounds);
+    if (installedNames.length === 0) {
+        console.log("No sounds installed.");
+        return;
+    }
+    const changedSounds = [];
+    for (const soundName of installedNames) {
+        try {
+            // Requirement 10.1 — fetch current registry item for each installed sound
+            const item = await fetchItem(config.registryUrl, soundName);
+            // Compare fetched file content against local files
+            if (hasChanges(item.files, config, projectRoot)) {
+                changedSounds.push(soundName);
+            }
+        }
+        catch (error) {
+            // Requirement 10.7 — continue on individual fetch failures with warning
+            const message = error instanceof Error ? error.message : String(error);
+            console.warn(`⚠ Could not check '${soundName}': ${message}`);
+        }
+    }
+    // Requirement 10.2 — display changed sound names
+    if (changedSounds.length > 0) {
+        console.log("Sounds with available updates:");
+        for (const name of changedSounds) {
+            console.log(`  • ${name}`);
+        }
+    }
+    else {
+        // Requirement 10.3 — all up to date message
+        console.log("All sounds are up to date.");
+    }
+}
+//# sourceMappingURL=diff.js.map

package/dist/commands/diff.js.map

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

package/dist/commands/generate.d.ts

@@ -0,0 +1,12 @@
+/**
+ * `audx generate "<prompt>"` command handler.
+ *
+ * Accepts a prompt string, optional --name and --duration flags.
+ * Generates a sound via the API, writes a Sound_Module file, and
+ * updates the config manifest.
+ */
+export declare function generateCommand(prompt: string, options: {
+    name?: string;
+    duration?: string;
+}, projectRoot: string): Promise<void>;
+//# sourceMappingURL=generate.d.ts.map

package/dist/commands/generate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../../src/commands/generate.ts"],"names":[],"mappings":"AA+CA;;;;;;GAMG;AACH,wBAAsB,eAAe,CACpC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,EAC7C,WAAW,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC,CAgEf"}

package/dist/commands/generate.js

@@ -0,0 +1,96 @@
+import { mkdirSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import * as ConfigManager from "../core/config.js";
+import { generateSound } from "../core/registry.js";
+import { deriveKebabName, encodeAudioToDataUri } from "../core/utils.js";
+/**
+ * Convert a kebab-case name to a camelCase variable name suffixed with "Audio".
+ * e.g. "laser-blast" → "laserBlastAudio"
+ */
+function toCamelCaseAudioVar(kebab) {
+    const camel = kebab.replace(/-([a-z0-9])/g, (_, c) => c.toUpperCase());
+    return `${camel}Audio`;
+}
+/**
+ * Build the Sound_Module TypeScript source for a generated sound.
+ */
+function buildSoundModule(name, dataUri, duration) {
+    const varName = toCamelCaseAudioVar(name);
+    const dur = duration ?? 2;
+    const lines = [
+        `import type { AudioAsset } from "@/lib/audio-types";`,
+        ``,
+        `export const ${varName}: AudioAsset = {`,
+        `  name: "${name}",`,
+        `  dataUri:`,
+        `    "${dataUri}",`,
+        `  duration: ${dur},`,
+        `  format: "mp3",`,
+        `  license: "MIT",`,
+        `  author: "Generated",`,
+        `};`,
+        ``,
+    ];
+    return lines.join("\n");
+}
+/**
+ * `audx generate "<prompt>"` command handler.
+ *
+ * Accepts a prompt string, optional --name and --duration flags.
+ * Generates a sound via the API, writes a Sound_Module file, and
+ * updates the config manifest.
+ */
+export async function generateCommand(prompt, options, projectRoot) {
+    // Requirement 8.8 — config must exist
+    if (!ConfigManager.exists(projectRoot)) {
+        console.error("Configuration not found. Run 'audx init' first.");
+        process.exit(1);
+    }
+    const config = ConfigManager.read(projectRoot);
+    // Requirement 8.2 / 8.3 — derive or use provided name
+    const soundName = options.name ?? deriveKebabName(prompt);
+    // Build API params
+    const params = { text: prompt };
+    // Requirement 8.4 — optional duration
+    if (options.duration !== undefined) {
+        const dur = Number(options.duration);
+        if (Number.isNaN(dur) || dur < 0.5 || dur > 22) {
+            console.error("Duration must be a number between 0.5 and 22.");
+            process.exit(1);
+        }
+        params.duration_seconds = dur;
+    }
+    try {
+        // Requirement 8.1 — POST to generation API
+        console.log(`Generating sound "${soundName}" from prompt: "${prompt}"...`);
+        const audioBuffer = await generateSound(config.registryUrl, params);
+        // Requirement 8.5 — encode as base64 data URI and create Sound_Module
+        const dataUri = encodeAudioToDataUri(audioBuffer);
+        const moduleContent = buildSoundModule(soundName, dataUri, params.duration_seconds);
+        // Write to soundDir
+        const targetDir = join(projectRoot, config.soundDir);
+        mkdirSync(targetDir, { recursive: true });
+        const filePath = join(targetDir, `${soundName}.ts`);
+        writeFileSync(filePath, moduleContent, "utf-8");
+        // Requirement 8.6 — update installedSounds in config
+        const updatedConfig = {
+            ...config,
+            installedSounds: {
+                ...config.installedSounds,
+                [soundName]: {
+                    files: [filePath],
+                    installedAt: new Date().toISOString(),
+                },
+            },
+        };
+        ConfigManager.write(projectRoot, updatedConfig);
+        console.log(`✔ Generated and installed ${soundName}`);
+    }
+    catch (error) {
+        // Requirement 8.7 — handle API errors
+        const message = error instanceof Error ? error.message : String(error);
+        console.error(`✘ ${message}`);
+        process.exit(2);
+    }
+}
+//# sourceMappingURL=generate.js.map

package/dist/commands/generate.js.map

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

package/dist/commands/init.d.ts

@@ -0,0 +1,2 @@
+export declare function initCommand(projectRoot: string): Promise<void>;
+//# sourceMappingURL=init.d.ts.map

package/dist/commands/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAoDA,wBAAsB,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA8CpE"}