aliasmate 1.0.0 → 1.2.0

package/dist/utils/llm-generator.js

@@ -0,0 +1,337 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateLLMContent = generateLLMContent;
+exports.createLLMFile = createLLMFile;
+exports.getDefaultLLMCommand = getDefaultLLMCommand;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const constants_1 = require("./constants");
+/**
+ * Generate LLM.txt content with all AliasMate features and documentation
+ */
+function generateLLMContent() {
+    return `# AliasMate - Terminal Command Management CLI
+
+Version: ${constants_1.APP_VERSION}
+Official Tool: ${constants_1.APP_NAME}
+
+## Overview
+
+AliasMate is a powerful CLI utility that saves, manages, and re-runs shell commands with their working directories. It helps developers save time, reduce errors, and boost productivity by eliminating the need to retype complex commands or remember their exact locations.
+
+## Core Capabilities
+
+### 1. Command Storage
+- Save any shell command with a memorable name
+- Store the working directory where the command should execute
+- Preserve metadata (creation date, last modified)
+- Support for complex multi-line commands and scripts
+
+### 2. Command Execution
+- Run saved commands from anywhere in the filesystem
+- Automatic directory switching to the saved location
+- Option to override execution directory (use current or saved path)
+- Support for both absolute and relative path overrides
+
+### 3. Command Management
+- List all saved commands with full details
+- Search commands by name, command text, or directory
+- Edit existing commands interactively
+- Delete unwanted commands
+- Export/import commands for backup and team sharing
+
+## Available Commands
+
+### aliasmate prev <name>
+Save the previous command from shell history.
+- Automatically captures the last executed command
+- Saves current working directory
+- Example: \`aliasmate prev build\`
+
+### aliasmate run <name> [path]
+Execute a saved command.
+- Runs in saved directory by default
+- Optional path parameter to override directory
+- Supports path mode (saved vs current directory)
+- Example: \`aliasmate run build\` or \`aliasmate run build .\`
+
+### aliasmate save
+Interactively create a new saved command.
+- Prompts for command name
+- Prompts for command to execute
+- Prompts for working directory
+- Prompts for path mode preference
+- Example: \`aliasmate save\`
+
+### aliasmate list (alias: ls)
+Display all saved commands.
+- Shows command name, actual command, and directory
+- Displays path mode for each command
+- Color-coded output for readability
+- Example: \`aliasmate list\`
+
+### aliasmate search <query> (alias: find)
+Search for commands by keyword.
+- Searches in command name, command text, and directory path
+- Case-insensitive matching
+- Example: \`aliasmate search deploy\`
+
+### aliasmate edit <name>
+Modify an existing command.
+- Interactive prompts with current values
+- Update command text, directory, or path mode
+- Example: \`aliasmate edit build\`
+
+### aliasmate delete <name> (alias: rm)
+Remove a saved command.
+- Permanently deletes the command
+- Example: \`aliasmate delete old-build\`
+
+### aliasmate export <file>
+Export all commands to a JSON file.
+- Backup your commands
+- Share with team members
+- Example: \`aliasmate export my-commands.json\`
+
+### aliasmate import <file>
+Import commands from a JSON file.
+- Restore from backup
+- Load teammate's commands
+- Prompts before overwriting existing commands
+- Example: \`aliasmate import my-commands.json\`
+
+### aliasmate llm
+Generate this llm.txt file (default command).
+- Creates comprehensive documentation
+- Can be shared with AI assistants
+- Example: \`aliasmate run llm\`
+
+## Path Mode Feature
+
+Each saved command can have a path mode that determines where it executes:
+
+### Saved Directory Mode (default)
+- Command always runs in the directory where it was saved
+- Useful for project-specific commands
+- Example: Build scripts that must run in the project root
+
+### Current Directory Mode
+- Command runs in your current working directory
+- Useful for general-purpose utilities
+- Example: Git commands that work in any repository
+
+You can choose the path mode when saving or editing a command.
+
+## Configuration
+
+### Storage Location
+- Config file: \`~/.config/aliasmate/config.json\`
+- Contains all saved commands and their metadata
+- JSON format for easy editing if needed
+
+### Command Alias Structure
+Each command contains:
+- \`command\`: The shell command to execute
+- \`directory\`: The saved working directory path
+- \`pathMode\`: Either "saved" or "current"
+- \`createdAt\`: ISO 8601 timestamp
+- \`updatedAt\`: ISO 8601 timestamp
+
+## Use Cases
+
+### Development Workflows
+- Save complex build commands: \`aliasmate prev build-prod\`
+- Run test suites: \`aliasmate prev test-integration\`
+- Deploy applications: \`aliasmate prev deploy-staging\`
+
+### Multi-Project Management
+- Switch between projects easily
+- Run project-specific commands without navigating
+- Maintain consistent workflows across projects
+
+### Team Collaboration
+- Export team workflows: \`aliasmate export team-commands.json\`
+- Share best practices and scripts
+- Onboard new team members quickly
+
+### DevOps and Automation
+- Save deployment scripts with correct paths
+- Manage multiple environment configurations
+- Quick access to frequently used operations
+
+## Best Practices
+
+1. **Descriptive Names**: Use clear, memorable names for commands
+   - Good: \`deploy-prod\`, \`test-unit\`, \`start-server\`
+   - Avoid: \`cmd1\`, \`x\`, \`temp\`
+
+2. **Path Mode Selection**: Choose the right mode for each command
+   - Use "saved" for project-specific commands
+   - Use "current" for general utilities
+
+3. **Regular Backups**: Export commands periodically
+   - \`aliasmate export ~/backups/aliases-\$(date +%Y%m%d).json\`
+
+4. **Team Sharing**: Maintain a shared command repository
+   - Version control your command exports
+   - Document complex commands
+
+5. **Command Organization**: Use prefixes for grouping
+   - \`test-unit\`, \`test-integration\`, \`test-e2e\`
+   - \`deploy-dev\`, \`deploy-staging\`, \`deploy-prod\`
+
+## Integration with AI Assistants
+
+This llm.txt file is designed to help AI assistants understand AliasMate's full capabilities. When asking an AI for help with AliasMate:
+
+1. Share this file for complete context
+2. Mention specific commands you're working with
+3. Describe your workflow or use case
+4. Ask for command suggestions or optimizations
+
+## Troubleshooting
+
+### Command Not Found
+- Run \`aliasmate list\` to see available commands
+- Check spelling of command name
+- Verify command was saved successfully
+
+### Directory Not Found
+- Ensure the saved directory still exists
+- Use path override to run in different location
+- Edit command to update directory: \`aliasmate edit <name>\`
+
+### Command Execution Fails
+- Verify command syntax is correct
+- Check if required tools/dependencies are installed
+- Ensure directory permissions are correct
+
+## Technical Details
+
+- Written in TypeScript
+- Cross-platform (Linux, macOS, Windows)
+- Node.js 14.0.0 or higher required
+- Dependencies: chalk, commander, execa, inquirer
+
+## Getting Help
+
+- View all commands: \`aliasmate --help\`
+- View command help: \`aliasmate <command> --help\`
+- GitHub Issues: Report bugs or request features
+- Version info: \`aliasmate --version\`
+
+## Example Workflows
+
+### Frontend Development
+\`\`\`bash
+# Save development server
+npm run dev
+aliasmate prev dev
+
+# Save production build
+npm run build
+aliasmate prev build
+
+# Save test suite
+npm test
+aliasmate prev test
+
+# Run from anywhere
+aliasmate run dev
+aliasmate run build
+aliasmate run test
+\`\`\`
+
+### Backend API
+\`\`\`bash
+# Save API server
+npm start
+aliasmate prev api
+
+# Save database migrations
+npm run migrate
+aliasmate prev migrate
+
+# Save seed data
+npm run seed
+aliasmate prev seed
+\`\`\`
+
+### DevOps
+\`\`\`bash
+# Save deployment scripts
+./scripts/deploy.sh production
+aliasmate prev deploy-prod
+
+# Save log viewing
+tail -f /var/log/app.log
+aliasmate prev logs
+
+# Save health checks
+curl http://localhost:3000/health
+aliasmate prev health-check
+\`\`\`
+
+---
+
+Generated by AliasMate v${constants_1.APP_VERSION}
+For more information, visit: https://github.com/aliasmate/aliasmate
+`;
+}
+/**
+ * Create llm.txt file in the specified directory
+ * @param targetDir - The directory where llm.txt should be created
+ * @returns The full path to the created file
+ */
+function createLLMFile(targetDir) {
+    const content = generateLLMContent();
+    const filePath = path.join(targetDir, 'llm.txt');
+    fs.writeFileSync(filePath, content, 'utf8');
+    return filePath;
+}
+/**
+ * Get the default LLM command configuration
+ * This command will be auto-created during onboarding
+ */
+function getDefaultLLMCommand() {
+    return {
+        name: 'llm',
+        command: `cat > llm.txt << 'ALIASMATE_LLM_EOF'\n${generateLLMContent()}\nALIASMATE_LLM_EOF\necho "✓ Created llm.txt in $(pwd)"`,
+        directory: process.cwd(),
+        pathMode: 'current', // Run in current directory so users can create llm.txt anywhere
+    };
+}
+//# sourceMappingURL=llm-generator.js.map

package/dist/utils/llm-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-generator.js","sourceRoot":"","sources":["../../src/utils/llm-generator.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAOA,gDA4QC;AAOD,sCAOC;AAMD,oDAOC;AA9SD,uCAAyB;AACzB,2CAA6B;AAC7B,2CAAoD;AAEpD;;GAEG;AACH,SAAgB,kBAAkB;IAChC,OAAO;;WAEE,uBAAW;iBACL,oBAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;0BAqQC,uBAAW;;CAEpC,CAAC;AACF,CAAC;AAED;;;;GAIG;AACH,SAAgB,aAAa,CAAC,SAAiB;IAC7C,MAAM,OAAO,GAAG,kBAAkB,EAAE,CAAC;IACrC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;IAEjD,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;IAE5C,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;GAGG;AACH,SAAgB,oBAAoB;IAClC,OAAO;QACL,IAAI,EAAE,KAAK;QACX,OAAO,EAAE,yCAAyC,kBAAkB,EAAE,yDAAyD;QAC/H,SAAS,EAAE,OAAO,CAAC,GAAG,EAAE;QACxB,QAAQ,EAAE,SAAS,EAAE,gEAAgE;KACtF,CAAC;AACJ,CAAC"}

package/dist/utils/onboarding.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Check if this is a first install or upgrade, and show appropriate onboarding
+ * @returns true if onboarding was shown, false otherwise
+ */
+export declare function checkAndShowOnboarding(): boolean;
+/**
+ * Check if user has completed onboarding
+ */
+export declare function hasCompletedOnboarding(): boolean;
+//# sourceMappingURL=onboarding.d.ts.map

package/dist/utils/onboarding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"onboarding.d.ts","sourceRoot":"","sources":["../../src/utils/onboarding.ts"],"names":[],"mappings":"AA6IA;;;GAGG;AACH,wBAAgB,sBAAsB,IAAI,OAAO,CAoChD;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,OAAO,CAGhD"}

package/dist/utils/onboarding.js

@@ -0,0 +1,201 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.checkAndShowOnboarding = checkAndShowOnboarding;
+exports.hasCompletedOnboarding = hasCompletedOnboarding;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const chalk_1 = __importDefault(require("chalk"));
+const storage_1 = require("../storage");
+const constants_1 = require("./constants");
+const ONBOARDING_FILE = 'onboarding.json';
+/**
+ * Get the path to the onboarding state file
+ */
+function getOnboardingPath() {
+    return path.join((0, storage_1.getConfigDir)(), ONBOARDING_FILE);
+}
+/**
+ * Load onboarding state from disk
+ */
+function loadOnboardingState() {
+    const onboardingPath = getOnboardingPath();
+    if (!fs.existsSync(onboardingPath)) {
+        return null;
+    }
+    try {
+        const data = fs.readFileSync(onboardingPath, 'utf8');
+        return JSON.parse(data);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Save onboarding state to disk
+ */
+function saveOnboardingState(state) {
+    const onboardingPath = getOnboardingPath();
+    try {
+        fs.writeFileSync(onboardingPath, JSON.stringify(state, null, 2), 'utf8');
+    }
+    catch (error) {
+        // Silently fail - onboarding is not critical
+    }
+}
+/**
+ * Display the welcome message for first-time users
+ */
+function showWelcomeMessage() {
+    console.log();
+    console.log(chalk_1.default.bold.cyan('🎉 Welcome to AliasMate! 🎉'));
+    console.log();
+    console.log(chalk_1.default.white('Thanks for installing AliasMate - your terminal productivity companion!'));
+    console.log();
+    console.log(chalk_1.default.bold.green('Why AliasMate?'));
+    console.log(chalk_1.default.gray('  • Save complex commands with one simple command'));
+    console.log(chalk_1.default.gray('  • Never lose track of useful commands again'));
+    console.log(chalk_1.default.gray('  • Execute commands in their correct directories automatically'));
+    console.log(chalk_1.default.gray('  • Share your workflows with your team'));
+    console.log();
+}
+/**
+ * Display a quick tour of the main features
+ */
+function showQuickTour() {
+    console.log(chalk_1.default.bold.yellow('⚡ Quick Tour - How It Works:'));
+    console.log();
+    console.log(chalk_1.default.bold('1️⃣  Save Commands'));
+    console.log(chalk_1.default.gray('   After running any command, save it:'));
+    console.log(chalk_1.default.cyan('   $ npm run build'));
+    console.log(chalk_1.default.cyan('   $ aliasmate prev build'));
+    console.log(chalk_1.default.gray('   ✓ Saves the command with its working directory'));
+    console.log();
+    console.log(chalk_1.default.bold('2️⃣  Run Anywhere'));
+    console.log(chalk_1.default.gray('   Execute saved commands from any location:'));
+    console.log(chalk_1.default.cyan('   $ aliasmate run build'));
+    console.log(chalk_1.default.gray('   ✓ Runs in the correct directory automatically'));
+    console.log();
+    console.log(chalk_1.default.bold('3️⃣  Manage Easily'));
+    console.log(chalk_1.default.cyan('   $ aliasmate list         ') + chalk_1.default.gray('# View all saved commands'));
+    console.log(chalk_1.default.cyan('   $ aliasmate search test  ') + chalk_1.default.gray('# Find specific commands'));
+    console.log(chalk_1.default.cyan('   $ aliasmate edit build   ') + chalk_1.default.gray('# Modify saved commands'));
+    console.log();
+    console.log(chalk_1.default.bold('4️⃣  Share & Backup'));
+    console.log(chalk_1.default.cyan('   $ aliasmate export my-commands.json'));
+    console.log(chalk_1.default.cyan('   $ aliasmate import my-commands.json'));
+    console.log(chalk_1.default.gray('   ✓ Share workflows with your team'));
+    console.log();
+    console.log(chalk_1.default.bold('5️⃣  LLM Integration'));
+    console.log(chalk_1.default.gray('   A default "llm" command has been created for you:'));
+    console.log(chalk_1.default.cyan('   $ aliasmate run llm'));
+    console.log(chalk_1.default.gray('   ✓ Generates llm.txt with all AliasMate features'));
+    console.log(chalk_1.default.gray('   ✓ Share this file with AI assistants for better help'));
+    console.log();
+}
+/**
+ * Display upgrade message when version changes
+ */
+function showUpgradeMessage(oldVersion, newVersion) {
+    console.log();
+    console.log(chalk_1.default.bold.green(`🎊 AliasMate upgraded from v${oldVersion} to v${newVersion}!`));
+    console.log();
+    console.log(chalk_1.default.white("What's new:"));
+    console.log(chalk_1.default.gray('  • Path mode option: Choose between saved directory or current directory'));
+    console.log(chalk_1.default.gray('  • Default "llm" command for LLM integration'));
+    console.log(chalk_1.default.gray('  • Enhanced onboarding experience'));
+    console.log();
+    console.log(chalk_1.default.yellow('Run') + chalk_1.default.cyan(' aliasmate list ') + chalk_1.default.yellow('to see your commands'));
+    console.log();
+}
+/**
+ * Display helpful tips after onboarding
+ */
+function showHelpfulTips() {
+    console.log(chalk_1.default.bold.magenta('💡 Pro Tips:'));
+    console.log(chalk_1.default.gray('  • Use') + chalk_1.default.cyan(' aliasmate save ') + chalk_1.default.gray('for interactive command creation'));
+    console.log(chalk_1.default.gray('  • Combine with') + chalk_1.default.cyan(' aliasmate run <name> . ') + chalk_1.default.gray('to run in current directory'));
+    console.log(chalk_1.default.gray('  • Export commands to backup or share with teammates'));
+    console.log();
+    console.log(chalk_1.default.gray('Need help? Run') + chalk_1.default.cyan(' aliasmate --help'));
+    console.log();
+    console.log(chalk_1.default.bold.green('Happy commanding! 🚀'));
+    console.log();
+}
+/**
+ * Check if this is a first install or upgrade, and show appropriate onboarding
+ * @returns true if onboarding was shown, false otherwise
+ */
+function checkAndShowOnboarding() {
+    const state = loadOnboardingState();
+    const currentVersion = constants_1.APP_VERSION;
+    // First install
+    if (!state) {
+        showWelcomeMessage();
+        showQuickTour();
+        showHelpfulTips();
+        const newState = {
+            version: currentVersion,
+            lastShownVersion: currentVersion,
+            hasSeenWelcome: true,
+            installDate: new Date().toISOString(),
+        };
+        saveOnboardingState(newState);
+        return true;
+    }
+    // Version upgrade
+    if (state.version !== currentVersion) {
+        showUpgradeMessage(state.version, currentVersion);
+        const updatedState = {
+            ...state,
+            version: currentVersion,
+            lastShownVersion: currentVersion,
+        };
+        saveOnboardingState(updatedState);
+        return true;
+    }
+    return false;
+}
+/**
+ * Check if user has completed onboarding
+ */
+function hasCompletedOnboarding() {
+    const state = loadOnboardingState();
+    return state !== null && state.hasSeenWelcome;
+}
+//# sourceMappingURL=onboarding.js.map

package/dist/utils/onboarding.js.map

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

package/dist/utils/paths.d.ts

@@ -1,6 +1,44 @@
 /**
  * Resolve a path, handling relative paths, absolute paths, and special cases
- * Cross-platform path resolution
+ * Works cross-platform (Windows, macOS, Linux)
+ *
+ * @param inputPath - The path to resolve
+ * @param basePath - The base path to resolve relative paths against (defaults to cwd)
+ * @returns The resolved absolute path
+ *
+ * @example
+ * ```ts
+ * resolvePath('.', '/home/user') // => '/home/user'
+ * resolvePath('..', '/home/user') // => '/home'
+ * resolvePath('/absolute/path') // => '/absolute/path'
+ * resolvePath('relative/path', '/base') // => '/base/relative/path'
+ * ```
  */
 export declare function resolvePath(inputPath: string, basePath?: string): string;
+/**
+ * Validate that a directory exists and is accessible
+ *
+ * @param dirPath - The directory path to validate
+ * @returns true if directory exists and is accessible, false otherwise
+ *
+ * @example
+ * ```ts
+ * if (isValidDirectory('/home/user/project')) {
+ *   console.log('Directory is valid');
+ * }
+ * ```
+ */
+export declare function isValidDirectory(dirPath: string): boolean;
+/**
+ * Sanitize a command name by removing invalid characters
+ *
+ * @param name - The command name to sanitize
+ * @returns Sanitized command name
+ *
+ * @example
+ * ```ts
+ * sanitizeCommandName('my command!') // => 'my-command'
+ * ```
+ */
+export declare function sanitizeCommandName(name: string): string;
 //# sourceMappingURL=paths.d.ts.map

package/dist/utils/paths.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/utils/paths.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAsB,GAAG,MAAM,CAqBvF"}
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/utils/paths.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAsB,GAAG,MAAM,CAqBvF;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAOzD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAMxD"}