@wuchale/svelte/README.md

Protobuf-like i18n from normal code

# `@wuchale/svelte`

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

An adapter to integrate `wuchale` in Svelte projects.

**`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/adapter/svelte](https://wuchale.dev/adapters/svelte).