feat: Source Map Visualizer v1.2.1

This release improves .desc file handling and adds automated release tooling.

## Fixed
- Fixed .desc file serialization for mappings without source information
  - No-source mappings now correctly output as [17] instead of [17,1,undefined,undefined,UNKNOWN]
- Fixed .desc file content handling to always load fresh from disk
  - Content is now refreshed when files change or OUTPUT field is updated
  - Ensures .desc files always reflect current state of actual files

## Added
- Automated release process with make release VERSION=x.x.x command
- Comprehensive release automation and verification scripts
- Claude project commands for common development workflows

## Changed
- Improved release workflow documentation
- Enhanced verification scripts to prevent development files from reaching master

Author: angerman

docs/USER_GUIDE.md

@@ -78,18 +78,18 @@ The `.desc` format is a human-readable source map description:
 
 ```
 INPUT: source-file.ext
-VERSION
-1.0.0
--- Optional comments
+<contents of source-file.ext>
 
 OUTPUT: generated-file.ext
-<generated code content>
+<contents of generated-file.ext>
 
 # Mappings use 1-based indices
 [gen-col,src-idx,src-line,src-col,TYPE] -- optional comment
 [-] -- line break marker
 ```
 
+Note: The file contents shown after INPUT and OUTPUT lines are included for readability. When saving, these contents are always read fresh from disk to ensure they reflect the current state of the actual files.
+
 Example:
 ```
 INPUT: example.uwu

src/commands/convertToDesc.ts

@@ -2,7 +2,7 @@ import * as vscode from 'vscode';
 import * as path from 'path';
 import * as fs from 'fs';
 import { MapToDescConverter } from '../converter/MapToDescConverter';
-import { DescSerializer } from '../converter/DescSerializer';
+import { DescParser } from '../editor/DescParser';
 import { SourceMapV3 } from '../common/DescEditorMessages';
 import { Logger } from '../common/logger';
 
@@ -43,7 +43,6 @@ export async function convertToDescCommand(uri?: vscode.Uri): Promise<void> {
 
         // Convert to .desc format
         const descFile = MapToDescConverter.convert(sourceMap, fileUri.fsPath);
-        const descContent = DescSerializer.serialize(descFile);
 
         // Ask user where to save
         const defaultPath = fileUri.fsPath.replace(/\.map$/, '.desc');
@@ -56,6 +55,7 @@ export async function convertToDescCommand(uri?: vscode.Uri): Promise<void> {
         });
 
         if (saveUri) {
+            const descContent = await DescParser.serializeToFile(descFile, saveUri.fsPath);
             await fs.promises.writeFile(saveUri.fsPath, descContent);
             vscode.window.showInformationMessage(`Description file created at ${path.basename(saveUri.fsPath)}`);
 

src/common/DescEditorMessages.ts

@@ -21,6 +21,7 @@ export interface UpdateDescMessage extends BaseDescMessage {
     type: 'update';
     desc: DescFile;
     sourceContent: string;
+    outputContent: string;
     documentUri: string;
 }
 

src/converter/DescSerializer.ts

@@ -1,5 +1,5 @@
 import { SourceMapV3 } from '../common/DescEditorMessages';
-import { DescFile, DescHeader, DescOutput, DescMapping } from '../editor/DescParser';
+import { DescFile, DescHeader, DescMapping } from '../editor/DescParser';
 import { decodeVLQ } from '../common/vlq';
 import { FileService } from '../common/FileService';
 import * as vscode from 'vscode';
@@ -21,30 +21,23 @@ export class MapToDescConverter {
         const mapFileUri = vscode.Uri.file(mapFilePath);
 
         // Create header with resolved source file paths
+        const resolvedOutputPath = sourceMap.file 
+            ? fileService.resolveGeneratedFile(sourceMap.file, mapFileUri) || sourceMap.file
+            : path.basename(mapFilePath, '.map');
+            
         const header: DescHeader = {
             inputs: sourceMap.sources.map(src => {
                 // Use FileService to resolve paths with suffix matching
                 return fileService.resolvePath(src, mapFileUri, sourceMap.sourceRoot);
             }),
-            comments: []
-        };
-        
-        // Create output section with resolved generated file path
-        const resolvedOutputPath = sourceMap.file 
-            ? fileService.resolveGeneratedFile(sourceMap.file, mapFileUri) || sourceMap.file
-            : path.basename(mapFilePath, '.map');
-            
-        const output: DescOutput = {
-            filename: resolvedOutputPath,
-            content: this.generateOutputContent(sourceMap, decodedMappings)
+            output: resolvedOutputPath
         };
 
         // Convert decoded mappings to DescMapping format
         const mappings: DescMapping[] = this.convertToDescMappings(decodedMappings, sourceMap.names);
 
         return {
             header,
-            output,
             mappings
         };
     }
@@ -142,23 +135,6 @@ export class MapToDescConverter {
     /**
      * Generate output content with line numbers
      */
-    private static generateOutputContent(_sourceMap: SourceMapV3, mappings: DecodedMapping[]): string {
-        // Find the maximum line number to determine content length
-        let maxLine = 0;
-        for (const mapping of mappings) {
-            if (mapping.genLine > maxLine) {
-                maxLine = mapping.genLine;
-            }
-        }
-        
-        // Generate placeholder content with line numbers
-        const lines: string[] = [];
-        for (let i = 1; i <= maxLine; i++) {
-            lines.push(`// Line ${i}`);
-        }
-        
-        return lines.join('\n');
-    }
 
     /**
      * Convert decoded mappings to DescMapping format