1477bceb95
Move MissingKeyHandler, MissingKey, MissingKeyAction, and PluralRule function types to interface.go for better discoverability. Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
72 lines
1.7 KiB
Go
72 lines
1.7 KiB
Go
// Package i18n provides internationalization for the CLI.
|
|
package i18n
|
|
|
|
import (
|
|
"runtime"
|
|
)
|
|
|
|
// Mode determines how the i18n service handles missing translation keys.
|
|
type Mode int
|
|
|
|
const (
|
|
// ModeNormal returns the key as-is when a translation is missing (production).
|
|
ModeNormal Mode = iota
|
|
// ModeStrict panics immediately when a translation is missing (dev/CI).
|
|
ModeStrict
|
|
// ModeCollect dispatches MissingKey actions and returns [key] (QA testing).
|
|
ModeCollect
|
|
)
|
|
|
|
// String returns the string representation of the mode.
|
|
func (m Mode) String() string {
|
|
switch m {
|
|
case ModeNormal:
|
|
return "normal"
|
|
case ModeStrict:
|
|
return "strict"
|
|
case ModeCollect:
|
|
return "collect"
|
|
default:
|
|
return "unknown"
|
|
}
|
|
}
|
|
|
|
var missingKeyHandler MissingKeyHandler
|
|
|
|
// OnMissingKey registers a handler for missing translation keys.
|
|
// Called when T() or C() can't find a key in ModeCollect.
|
|
//
|
|
// i18n.SetMode(i18n.ModeCollect)
|
|
// i18n.OnMissingKey(func(m i18n.MissingKey) {
|
|
// log.Printf("MISSING: %s at %s:%d", m.Key, m.CallerFile, m.CallerLine)
|
|
// })
|
|
func OnMissingKey(h MissingKeyHandler) {
|
|
missingKeyHandler = h
|
|
}
|
|
|
|
// SetActionHandler registers a handler for missing key dispatches.
|
|
// Deprecated: Use OnMissingKey instead.
|
|
func SetActionHandler(h func(action MissingKeyAction)) {
|
|
OnMissingKey(h)
|
|
}
|
|
|
|
// dispatchMissingKey creates and dispatches a MissingKey event.
|
|
// Called internally when a key is missing in ModeCollect.
|
|
func dispatchMissingKey(key string, args map[string]any) {
|
|
if missingKeyHandler == nil {
|
|
return
|
|
}
|
|
|
|
_, file, line, ok := runtime.Caller(2) // Skip dispatchMissingKey and handleMissingKey
|
|
if !ok {
|
|
file = "unknown"
|
|
line = 0
|
|
}
|
|
|
|
missingKeyHandler(MissingKey{
|
|
Key: key,
|
|
Args: args,
|
|
CallerFile: file,
|
|
CallerLine: line,
|
|
})
|
|
}
|