Merge pull request #37 from ran-codes/release-v0.0.6-housekeeping

[Feature] Update README with new Gifs for dedicated View Container #36

Author: ran-codes

.claude/settings.local.json

@@ -5,7 +5,9 @@
       "Bash(npm run compile:*)",
       "Bash(cat:*)",
       "Bash(code --list-extensions)",
-      "Bash(code --install-extension:*)"
+      "Bash(code --install-extension:*)",
+      "Bash(npm install:*)",
+      "Bash(vsce package:*)"
     ],
     "deny": [
       "Bash(git:*)"

.vscodeignore

@@ -13,3 +13,5 @@ vsc-extension-quickstart.md
 **/*.ts
 **/.vscode-test.*
 test-files/**
+.claude/**
+.context/**

CHANGELOG.md

@@ -4,7 +4,51 @@ All notable changes to the "Code Organizer" extension will be documented in this
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
- 
+
+
+## [0.0.6] - 2025-10-28
+
+### Added
+
+- **Custom Activity Bar View**: Dedicated Code Organizer tab in the activity bar with custom icon
+  - Independent view container for Code Organizer sections
+  - Enhanced navigation experience separate from built-in Outline
+  - Monochrome SVG icon that adapts to VS Code themes
+- **Editor → Outline Synchronization**: Bidirectional navigation between editor and outline (#29)
+  - Auto-scroll outline view as cursor moves through sections
+  - Highlight current section in both editor and outline
+  - Visual indicators with themed colors (border highlight + hover messages)
+  - Debounced cursor tracking (150ms) for performance
+- **"Show Code Organizer" Command**: Quick access command to open and focus the view (#31)
+  - Accessible via Command Palette: `Code Organizer: Show Code Organizer`
+  - Programmatically opens view when closed
+  - Uses VS Code's auto-generated `.focus` command for reliability
+- **High Resolution Icon**: Professional hexagon design for marketplace (#26)
+  - Hex sticker style inspired by R packages
+  - Code section visual metaphor (hash symbols with lines)
+  - Gradient fill for visual appeal
+  - Separate monochrome activity bar icon for theme compatibility
+
+### Changed
+
+- Consolidated view architecture: Removed redundant Explorer section, kept custom Activity Bar tab + legacy Outline integration
+- Enhanced TreeView with caching mechanism for reliable `reveal()` functionality
+- Improved section highlight with visual decorations (left border + background highlight)
+- Updated extension icon to `icon_v2.png` with modern hexagon design
+
+### Technical
+
+- Implemented `CodeOrganizerTreeDataProvider` with TreeItem caching using `Map<uniqueId, TreeItem>`
+- Created `decorations.ts` for editor highlighting with theme-aware colors
+- Added cursor position tracking with `getCurrentSection()` helper function
+- Registered `codeOrganizer.showView` command for view focus functionality
+- Document caching to avoid unnecessary re-parsing of sections
+- Event listeners for editor selection changes, active editor switches, and document changes
+
+### Fixed
+
+- TreeView `reveal()` now works correctly by using cached TreeItem instances
+- Removed confusing `goToSection` command from Command Palette (kept for programmatic use only)
 
 ## [0.0.5] - 2025-09-27
 

README.md

@@ -22,7 +22,7 @@ Transform your code files into organized, navigable documents with a table of co
 - **VS Code integration**: Seamless outline view, breadcrumbs, and Go to Symbol
 - **Zero configuration**: Works immediately
 
-<img src="./assets/images/snip_demo_python.png" alt="Code Organizer Snip Demo Python" >
+<img src="./assets/images/snip_demo_python_v2.png" alt="Code Organizer Snip Demo Python" >
 
 
 
@@ -33,11 +33,14 @@ Transform your code files into organized, navigable documents with a table of co
 
 **To use:**
 1. Install the extension
-2. Add comment sections ending with `----` (4 or more dashes) to trigger code organization
-3. Check the **Outline** panel in VS Code's Explorer sidebar
-4. Click any section to jump to it instantly
+2. Open any code file (or create a new one)
+3. Add comment sections ending with `----` (4 or more dashes) to trigger code organization
+4. Check the **Outline** panel in VS Code's Explorer sidebar
+5. Click any section to jump to it instantly
 
-![Code Organizer Demo](./assets/images/demo.gif)
+**Tip**: Use Command Palette (Ctrl+Shift+P / Cmd+Shift+P) → `Code Organizer: Show Code Organizer` to quickly open the view
+
+![Code Organizer Demo](./assets/images/demo_v2.gif)
 
 
 
@@ -214,7 +217,15 @@ code --install-extension ran-codes.code-organizer-vscode
 
 See [CHANGELOG.md](CHANGELOG.md) for detailed release information.
 
-### 0.0.5 - Latest
+### 0.0.6 - Latest
+- **🆕 Custom Activity Bar View**: Dedicated Code Organizer tab with custom icon
+- **🆕 Editor-Outline Sync**: Auto-scroll outline view as you navigate through code
+- **🆕 "Show Code Organizer" Command**: Quick access via Command Palette
+- **🆕 High Resolution Icon**: Professional hexagon design for marketplace
+- Enhanced TreeView with caching for reliable navigation
+- Improved section highlighting with visual decorations
+
+### 0.0.5
 - **🆕 Markdown & Quarto Support**: Native header detection for `.md` and `.qmd` files
 - Smart code chunk handling - ignores headers inside fenced code blocks
 - Language-specific parsing for markdown documents
@@ -223,7 +234,7 @@ See [CHANGELOG.md](CHANGELOG.md) for detailed release information.
 ### 0.0.4
 - **Cursor Compatibility**: Downgraded VSCode engine to ^1.99.0 for broader editor support
 
-### 0.0.3 - Latest
+### 0.0.3
 - **🆕 JSX/TSX Support**: Added React JSX comment syntax `{/* // Section ---- */}`
 - Enhanced regex pattern to handle whitespace variations in JSX comments
 - Improved language support for React and TypeScript React developers

assets/images/demo_v2.gif

@@ -2,7 +2,7 @@
   "name": "code-organizer",
   "displayName": "🗂️ Code Organizer",
   "description": "Transform your code into organized, navigable sections using simple comment patterns. Create table-of-contents-like structure with # Section Name ---- syntax. Works with Python, JavaScript, TypeScript, React/JSX, C/C++, Java, Go, Rust, PHP, SQL and more. Perfect for large files and data science notebooks.",
-  "version": "0.0.5",
+  "version": "0.0.6",
   "publisher": "ran-codes",
   "author": {
     "name": "ran-codes",

assets/images/snip_demo_python_v2.png

@@ -3,6 +3,7 @@
 import sys
 import logging
 from pathlib import Path
+from typing import Dict, Any
 
 APP_NAME = "DataPipeline"
 VERSION = "1.0.0"
@@ -13,7 +14,9 @@
 import numpy as np
 import requests
 from sqlalchemy import create_engine
+from sqlalchemy.engine import Engine
 import boto3
+from botocore.client import BaseClient
 from dotenv import load_dotenv
 
 load_dotenv()
@@ -40,15 +43,16 @@
 class DataPipeline:
     def __init__(self, name: str):
         self.name = name
-        self.engine = create_engine(DATABASE_URL)
-        self.s3_client = boto3.client('s3') if AWS_ACCESS_KEY else None
+        self.engine: Engine = create_engine(DATABASE_URL)
+        self.s3_client: BaseClient | None = boto3.client('s3') if AWS_ACCESS_KEY else None
         logger.info(f"Initialized pipeline: {name}")
 
     def extract_data(self, source: str) -> pd.DataFrame:
         """Extract data from various sources"""
         if source.startswith('http'):
             headers = {'Authorization': f'Bearer {API_KEY}'}
             response = requests.get(source, headers=headers)
+            response.raise_for_status()  # Check for HTTP errors
             data = response.json()
             return pd.DataFrame(data)
         elif source.endswith('.csv'):
@@ -68,13 +72,16 @@ def transform_data(self, df: pd.DataFrame) -> pd.DataFrame:
         logger.info(f"Transformed {len(df)} rows")
         return df
 
-    def load_data(self, df: pd.DataFrame, destination: str):
+    def load_data(self, df: pd.DataFrame, destination: str) -> None:
         """Load data to destination"""
         if destination.startswith('s3://'):
+            if self.s3_client is None:
+                raise ValueError("S3 client not initialized. Check AWS credentials.")
             bucket = destination.replace('s3://', '').split('/')[0]
             key = '/'.join(destination.replace('s3://', '').split('/')[1:])
-            df.to_parquet(f'/tmp/{key}')
-            self.s3_client.upload_file(f'/tmp/{key}', bucket, key)
+            temp_file = f'/tmp/{key}'
+            df.to_parquet(temp_file)
+            self.s3_client.upload_file(temp_file, bucket, key)
         elif destination.endswith('.csv'):
             df.to_csv(destination, index=False)
         else:
@@ -83,7 +90,7 @@ def load_data(self, df: pd.DataFrame, destination: str):
 
         logger.info(f"Loaded data to: {destination}")
 
-def run_pipeline(config: dict):
+def run_pipeline(config: Dict[str, Any]) -> None:
     """Execute a complete ETL pipeline"""
     pipeline = DataPipeline(config['name'])
 
@@ -97,7 +104,7 @@ def run_pipeline(config: dict):
     logger.info(f"Pipeline {config['name']} completed successfully")
 
 # 3. Deploy ----
-def main():
+def main() -> None:
     """Main deployment function"""
     print(f"🚀 Starting {APP_NAME} v{VERSION}")
 
@@ -122,6 +129,8 @@ def main():
     for config in pipelines:
         try:
             run_pipeline(config)
+        except Exception as e:
+            logger.error(f"Pipeline {config['name']} failed: {e}")
 
 if __name__ == "__main__":
     main()