localization

package

v0.67.0 Latest Latest Go to latest Published: Sep 1, 2026 License: Apache-2.0 Imports: 7 Imported by: 0

Details

Valid go.mod file
Redistributable license
Tagged version
Stable version
Learn more about best practices

Repository

github.com/kombifyio/SpeechKit

Links

Open Source Insights

Documentation ¶

Overview ¶

Package localization resolves stable SpeechKit message IDs against the repository-owned locale catalogs.

Index ¶

func ResolveLocale(locale string) string
func SupportedLocales() []string
func Text(locale string, id MessageID) string
type Message
- func Resolve(locale string, id MessageID) Message
type MessageID

Constants ¶

This section is empty.

Variables ¶

This section is empty.

Functions ¶

func ResolveLocale ¶

func ResolveLocale(locale string) string

ResolveLocale performs deterministic BCP-47 negotiation for the registered catalogs. Supported regional variants fall back to their registered base language. Simplified Chinese variants resolve to zh-Hans; traditional Chinese and unsupported languages fall back to English.

func SupportedLocales ¶

func SupportedLocales() []string

SupportedLocales returns the initial SpeechKit locale set. English is the source locale and final fallback.

func Text ¶

func Text(locale string, id MessageID) string

Text returns the localized text for id. Missing locale entries fall back to English. An unknown message ID returns an empty string so callers cannot accidentally surface the identifier itself as customer prose.

Types ¶

type Message ¶

type Message struct {
	ID     MessageID
	Locale string
	Text   string
}

Message is one catalog result with the negotiated locale that must also be used for result metadata and TTS.

func Resolve ¶

func Resolve(locale string, id MessageID) Message

Resolve negotiates the locale once and resolves id from that exact catalog.

type MessageID ¶

type MessageID string

MessageID is a stable semantic identifier for customer-facing prose.

const (
	CompanionHomeAssistantNotConfigured MessageID = "companion.home_assistant.not_configured"
	CompanionHomeAssistantCommandEmpty  MessageID = "companion.home_assistant.command.empty"
	CompanionHomeAssistantNotMatched    MessageID = "companion.home_assistant.command.not_matched"
	CompanionHomeAssistantRejected      MessageID = "companion.home_assistant.command.rejected"
	CompanionHomeAssistantUnavailable   MessageID = "companion.home_assistant.unavailable"

	// Network-scope display names shown wherever a scope is named to the user.
	PrivacyScopeOpenName         MessageID = "sk.privacy.scope.open"
	PrivacyScopeLocalNetworkName MessageID = "sk.privacy.scope.local_network"
	PrivacyScopeDeviceOnlyName   MessageID = "sk.privacy.scope.device_only"

	// Disabled-reason prose for the stable reason IDs attached by the
	// network-scope policy (see NetworkScopeReason* in pkg/speechkit).
	PrivacyDisabledCloudProvider   MessageID = "sk.privacy.disabled.cloud_provider"
	PrivacyDisabledLocalService    MessageID = "sk.privacy.disabled.local_service_in_device_only"
	PrivacyDisabledServerScope     MessageID = "sk.privacy.disabled.server_in_device_only"
	PrivacyDisabledServerNotLocal  MessageID = "sk.privacy.disabled.server_url_not_local"
	PrivacyDisabledAgentBridge     MessageID = "sk.privacy.disabled.agent_bridge"
	PrivacyDisabledHomeAssistant   MessageID = "sk.privacy.disabled.home_assistant"
	PrivacyDisabledEdgeBeta        MessageID = "sk.privacy.disabled.edge_beta"
	PrivacyDisabledSetupTraffic    MessageID = "sk.privacy.disabled.setup_traffic"
	PrivacyDisabledTelemetry       MessageID = "sk.privacy.disabled.telemetry"
	PrivacyDisabledCloudAccount    MessageID = "sk.privacy.disabled.cloud_account"
	PrivacyDisabledVoiceAgentCloud MessageID = "sk.privacy.disabled.voice_agent_cloud"
)

Source Files ¶

View all Source files

catalog.go

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL