Brwne VS Code Extension

This is the main entry point of the Brwne VS Code extension. It orchestrates extension initialization, environment setup, lifecycle management, and integration of subsystems like tracking, highlighting, and syncing.

📁 File: extension.ts

Purpose

The extension.ts module defines the activation and deactivation hooks for the Brwne extension. It serves as the central bootstrapping logic that:

• Loads BRWNE MODE to decide if br or brd should be used
• Enables auto-save.
• Initializes file tracking and highlighting.
• Signals connection to the CLI

⚡ Activation Flow

activate(context: vscode.ExtensionContext): Promise<void>

Called automatically by VS Code when the extension is activated.

Responsibilities:

1. Identify Brwne Mode Determines whether the CLI is running in development (brd) or production (br) based on the BRWNE_MODE environment variable. This is for the cli interface.

2. Enable Auto-Save Ensures VS Code is set to auto-save after a 1-second delay using enableAutoSaveWithDelay().

3. Initialize File and Editor Tracking Calls EditorTracker.getInstance() to start watching file and editor changes.

4. Trigger Initial Highlighting Initializes highlighting system and calls startPollingForChanges() on the active file.

5. Check CLI Availability Executes brd/br --version to confirm Brwne CLI is available. Warns the user if not.

📴 Deactivation

deactivate(): void

Cleans up persistent listeners related to highlighting using cleanupHighlightListeners().

🔗 Integrated Modules

This file coordinates functionality from several key subsystems:

• utils/enableAutoSave — sets up 1-second auto-save delay.
• triggers/editorTracker — listens for file switches and content edits.
• highlights/highlightChanges — renders inline and gutter-based highlights.
• cli-interface/getChangesToHighlight — starts polling for external changes.

📚 Example Use Case

When the Brwne extension activates:

1. It decides the brwne commands to use [br or brd].
2. Sets VS Code to auto-save every 1 second.
3. Tracks user file activity to sync state.
4. Highlights edits and collaborative changes in real-time.
5. Notifies the user upon successful initialization or shows an error if CLI is missing.