Repository navigation
Releases
Releases · fqueis/vscode-cuidv2-tools
v0.0.4
Changelog
All notable changes to this project will be documented in this file.
The format is based on Keep a Changelog,
and this project adheres to Semantic Versioning.
[0.0.4] - 2026-07-13
Added
- Create a GitHub Release on each
v*publish tag and attach the packaged.vsix
[0.0.3] - 2026-07-13
Changed
- Compressed README demo GIF to shrink the published VSIX
- Publish workflow actions upgraded to Node.js 24 (
checkout@v6,setup-node@v6,pnpm/action-setup@v6)
[0.0.2] - 2026-07-13
Added
- Automated publish workflow on
v*tags (VS Marketplace + Open VSX) - Vitest unit tests for
CuidV2Service(generate, validate, find, regenerate, UUID replace) scripts/package-vsix.mjsto emit.vsixfiles underbuilds/
Changed
- Build scripts aligned for packaging:
build(webpack),package(vsix),vscode:prepublishrunsbuild - Declared MIT
licenseinpackage.json - Updated
.gitignore/.vscodeignoreforbuilds/, CI scripts, and test files
[0.0.1] - 2025-08-24
Added
- CUIDv2 generation at cursor position
- Multiple CUIDv2 generation with batch processing
- CUIDv2 validation with detailed feedback
- CUIDv2 regeneration for selected text or entire files
- UUID to CUIDv2 replacement functionality
- Configurable confirmation dialogs for destructive operations
- Context menu integration for right-click access
- Command Palette integration
- Progress indicators for batch operations
- Comprehensive error handling and user feedback
Technical
- TypeScript implementation with strict typing
- Modular service architecture (CuidV2Service, ConfigurationService)
- Webpack build configuration
- VS Code extension API integration
- Regular expression patterns for UUID detection
- User configuration management
[Unreleased]
Planned
- Additional ID format support
- Bulk file processing
- Custom ID format configuration
v.0.0.1
What's New in v0.0.1
Core Features
CUIDv2 Generation
- Generate CUIDv2 at Cursor: Insert a new CUIDv2 identifier at your current cursor position
- Generate Multiple CUIDv2s: Create multiple CUIDv2 identifiers in JSON format (1-1000 at once)
- Multiple Cursor Support: Generate identifiers at multiple positions simultaneously
CUIDv2 Validation
- Validate CUIDv2: Verify if a string is a valid CUIDv2 identifier
- Real-time Feedback: Instant validation results with clear success/error messages
CUIDv2 Management
- Regenerate CUIDv2s: Replace existing CUIDv2 identifiers with new ones
- Smart Text Selection: Works with both selected text and full file processing
- Batch Processing: Efficient handling of large quantities with progress indicators
UUID Migration
- Replace UUIDs with CUIDv2s: Convert UUID identifiers to CUIDv2 format
- Intelligent Detection: Automatically identifies and converts UUID patterns
- Preservation of Structure: Maintains original formatting and context
Advanced Features
User Configuration
- Configurable Confirmation Dialogs: Optional safety prompts for destructive operations
- Customizable Settings: Control extension behavior through VS Code settings
- User Preferences: Personalize the extension experience
User Interface
- Command Palette Integration: Access all features through VS Code's Command Palette
- Context Menu Integration: Right-click commands for quick access
- Intuitive Workflows: Streamlined user experience for common tasks
Technical Implementation
Architecture
- Modular Design: Clean separation of concerns with dedicated services
- TypeScript: Fully typed codebase for reliability and maintainability
- VS Code Extension API: Native integration with Visual Studio Code
Services
- CuidV2Service: Core CUIDv2 generation, validation and manipulation logic
- ConfigurationService: User settings and preference management
- Command System: Organized command structure for all extension features
Dependencies
- @paralleldrive/cuid2: Official CUIDv2 library for identifier generation
- VS Code Engine: Compatible with VS Code ^1.93.0
Installation
From VSIX Package
- Download the
cuidv2-tools-0.0.1.vsixfile from this release - Open VS Code
- Go to Extensions view (Ctrl+Shift+X)
- Click the "..." menu and select "Install from VSIX..."
- Select the downloaded VSIX file
From VS Code Marketplace
- Search for "CUIDv2 Tools" in the VS Code Extensions marketplace
- Click "Install" to add it to your VS Code installation
Usage Examples
Basic CUIDv2 Generation
- Place cursor where you want the CUIDv2
- Open Command Palette (Ctrl+Shift+P)
- Type "Generate CUIDv2 at cursor"
- Press Enter
Batch UUID Replacement
- Select text containing UUIDs or open a file
- Right-click and select "Replace UUIDs with CUIDv2s"
- Confirm the operation when prompted
- All UUIDs will be replaced with CUIDv2s
Multiple CUIDv2 Generation
- Open Command Palette (Ctrl+Shift+P)
- Type "Generate Multiple CUIDv2s"
- Enter the desired quantity (1-1000)
- CUIDv2s will be generated in JSON format
Configuration
Customize the extension behavior through VS Code settings:
{
"cuidv2-tools.confirmBeforeExecution": true
}confirmBeforeExecution: Show confirmation dialogs before destructive operations (default: true)
Future Roadmap
- Custom CUIDv2 format templates
- Integration with popular frameworks and ORMs
- Bulk file processing capabilities
- Advanced configuration options
Happy coding with CUIDv2! 🚀