wuchale/README.md

Protobuf-like i18n from normal code

# 📜`wuchale`🪶

[![npm version](https://img.shields.io/npm/v/wuchale)](https://www.npmjs.com/package/wuchale) ![License](https://img.shields.io/github/license/wuchalejs/wuchale)

**`wuchale`** is a non-invasive, normal code based compile-time internationalization (i18n) toolkit.

- **🔤 No extra syntax!** - your normal code is enough
- **📦 Tiny catalogs to bundle** - Text catalogs are just arrays, no keys necessary, like Protobuf
- **🔧 Zero-effort integration** - Add i18n to existing projects without rewriting code
- **🤖 Optional AI translation** - Gemini integration for automatic on-the-fly translations
- **🔄 Full, granular HMR support** - Live updates during development, including AI auto-translation
- **📦 Tiny footprint** - Only 2 or 3 additional dependencies (`wuchale` + `pofile`), no bloated `node_modules`
- **🎯 Smart extraction** - Uses AST analysis: handles nested markup, conditionals, loops, and complex interpolations
- **🌍 Standard .po files** - Compatible with existing translation tools and workflows

## 📚 Documentation

See the full guide at: [wuchale.dev](https://wuchale.dev/).