SwiftLog 🎒🎨

A context-aware, AST-powered log injection extension for VS Code.

SwiftLog eliminates the friction of manually typing out debugging statements in complex React and Next.js codebases. Using advanced Babel AST parsing, SwiftLog precisely analyzes your current execution scope, determines your environment (Client vs. Server), and instantly injects a beautifully formatted, context-aware console.log directly below your cursor — or at any line you specify.

⚡️ Key Features

• AST-Powered Precision: Extracts the exact enclosing function, class method, or arrow function to tell you exactly where a log fired.
• Next.js Context Awareness: Natively detects "use client" and "use server" directives (and intelligently maps App Router paths as a fallback) to adapt log output automatically.
• Zero-Highlight Targeting: Simply place your cursor on a variable (or let SwiftLog automatically infer the word under your cursor) to log it—no mouse highlighting required.
• Empty Line Replacements: Type a variable on an empty line and invoke the shortcut. SwiftLog will elegantly replace that entire line with a deeply formatted console log instead of dropping it on the next line!
• Premium Formatting:
  • Server Components: 🎒 [SERVER] [FunctionName] -> Variable: {value}
  • Client Components: %c🎨 [CLIENT] [FunctionName] -> Variable: with bright CSS styling in DevTools.
• Dedicated Stringify Shortcut: Instantly wrap a variable in JSON.stringify to bypass [object Object] without opening Settings.
• Unique Log Stamping: Every injected log is stamped with a unique // [SwiftLog:XXXX] signature for easy identification and safe pruning.
• Smart Log Removal: Remove all SwiftLog logs or a specific one from the active file in a single command, without touching your own console.logs.
• Fully Customizable: Override emojis, hex colors, and line number display directly from VS Code Settings UI.

🚀 Usage

Inject a Log

1. Open any .ts, .tsx, .js, or .jsx file.
2. Place your cursor on a variable name you want to inspect (e.g., userData). You DO NOT need to highlight the text!
   • Pro Tip: Type a variable on a blank line, leave your cursor on it, and watch the line transform into a log.
3. Fire the keyboard shortcut:

Alternatively, open the Command Palette (Cmd+Shift+P) and search for "SwiftLog" to see all available commands.

⚙️ Customization

Go to VS Code Settings (Cmd + ,) and search for SwiftLog to customize:

Example output with includeLineNumbers: true:

console.log("%c🎨 [CLIENT] [UserProfile:L24] -> username:", "color: #00adb5; font-weight: bold;", username); // [SwiftLog:X7J9]

🗑️ Removing Logs

SwiftLog stamps every injected log with // [SwiftLog:XXXX], making cleanup safe and surgical:

• Remove All Logs (Cmd+Shift+Alt+D): Wipes every SwiftLog-stamped log from the active file instantly.
• Remove Specific Log (Cmd+Shift+Alt+X): Prompts you for a variable name or Log ID (e.g. username or X7J9), and removes only the matching log(s).

🛠️ Tech Stack & Internal Mechanics

• Driven by the standard VS Code TextEditor API.
• employs @babel/parser and @babel/traverse to scan execution scopes without blocking the IDE thread.
• Implements fully graceful fallbacks — if your code has unresolved syntax errors mid-refactor, SwiftLog still injects logs as expected.
• Log deletion uses a two-pass reverse-order scan to prevent line-index shifting during bulk deletions.

📦 Roadmap

• [x] Smart JSON.stringify(foo, null, 2) override shortcut for robust object logging.
• [ ] Safe circular reference stringifier support out-of-the-box.
• [ ] Full-workspace log sweep across all open files.
• [ ] Log level support: console.error, console.warn, console.table.

Built for unparalleled developer experience.