Commit graph

3 commits

Author SHA1 Message Date
Snider
2a2dfcfe78 docs(i18n): add grammar fundamentals and DX improvements
- Parts of speech: verb, noun, article, adjective, preposition
- Verb conjugation structure (base/past/gerund)
- Noun with plurality and gender
- Article selection (a/an, gender agreement)
- DX: compile-time validation, IDE support, debug mode
- DX: short subject syntax, fluent chaining, fallback chain
- Notes for future: pluralize lib, CLDR, sync.Map caching

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-30 12:03:54 +00:00
Snider
a987980e82 docs(i18n): finalize API naming for semantic i18n
Stable API (permanent, cannot change):
- _() - simple gettext-style lookup
- T() / C() - compose (semantic intent resolution)
- S() / Subject() - typed subject with metadata

Renamed Transmute() to Compose() for clarity.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-30 12:00:53 +00:00
Snider
1f75cd8b40 docs(i18n): add semantic i18n system design
Design document for extending i18n with:
- Reserved namespaces (common.*, core.*)
- Semantic intents with metadata (_meta)
- Transmute() for composite translations
- CLI integration (Confirm, Question, Choose)
- Template functions (title, past, plural, etc.)
- Subject helper with count/gender support

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-30 11:56:29 +00:00