# icogz Tools Hub - Developer & AI Toolkit

A secure, high-fidelity collection of 100% client-side, browser-sandboxed productivity and utility tools engineered for modern analytics, developer workflows, and AI operations.

All tools in this hub run entirely locally on the user's browser (client-side execution). No files are uploaded to any server, guaranteeing zero data leaks and maximum security.

## Project Details & Creators
- **Main Tool Hub URL**: https://tools.icogz.com/
- **LocalMD Subpath URL**: https://tools.icogz.com/localmd/
- **Company Homepage**: https://www.icogz.com/
- **Team**: Developed by the icogz Engineering Team
- **Contact Support**: info@icogz.com

## Core Features & Philosophy
- **100% Local Sandboxing**: Every operation is performed in-browser using WebAssembly, JavaScript APIs, and local library parsers.
- **Offline Capable (PWA)**: Tools are integrated with Service Workers to support fully functional offline operations.
- **Privacy First**: Compliant with strict enterprise security profiles. No external logging or cloud uploads of user documents.

---

## 1. LocalMD - Offline Markdown Converter
An offline document parser that converts complex proprietary formats into clean, semantic, LLM-friendly Markdown text.

### Specifications & Size Thresholds
- **Single Files**: Up to **5 MB**
- **ZIP Archives**: Up to **2 MB** (extracts and converts folder structures recursively)
- **Preview Disable**: Files exceeding these limits have live browser rendering disabled for performance. Users can still perform conversions and download the output directly.

### Supported Formats & Conversion Specs
1. **PDF**: Extracted via `pdfjs-dist` worker. Preserves layout flow, paragraphs, and lists.
2. **Word (DOCX)**: Extracted via `mammoth.js`. Renders semantic headings, links, bold/italic, and bullet lists.
3. **Excel & CSV (XLSX, XLS, CSV)**: Extracted via `sheetjs (xlsx)`. Converts cell grids to clean GitHub Flavored Markdown (GFM) tables.
4. **HTML**: Strips boilerplate tags (nav, script, styles, header/footer boilerplate) and outputs clean, semantic Markdown.
5. **Code Files**: Wraps text in markdown syntax-highlighted code blocks.
6. **ZIP**: Extracts compressed folder structures, parses each valid file, and packages the outputs into a single zip file.

### Token Estimation Engine
LocalMD features a client-side heuristic engine that estimates original vs. converted tokens to demonstrate the optimization for LLM context windows:
- **HTML / JSON**: Compares raw code markup character volume to the parsed content character volume.
- **DOCX**: Compares mammoth HTML representation length to final clean markdown.
- **PDF**: Estimates original tokens using page count (Claude/Gemini visual costs, ~1000 tokens/page) plus text characters, and compares to final markdown.
- **Excel**: Estimates cells and verbose layout tokens (12 tokens per cell + character lengths) vs. clean markdown table.
- **Text / Code**: Standard format wrapping (typically 0 saved tokens).

---

## 2. Upcoming Utilities (In Development)

### PicOptima - Image Compressor
Bulk compresses and converts images to WebP/AVIF format client-side.
- Canvas-based compression.
- Live side-by-side quality comparison.
- Exif metadata removal.

### RegexAI - Regular Expression Generator
自然语言 Regular Expression generator.
- Local pattern compiler and test-runner.
- AI-assisted explanations.

### SecureJWT - JSON Web Token Inspector
Inspects and decodes JWT payloads locally.
- Payload and signature validator.
- Key signing testbed without server logs.