Localize

Localize turns a typed product record into a translated, glossary-consistent record in a target locale.

Contract

type LocalizeInput = {
  productId: string;
  to: 'ru' | 'en' | 'ja' | 'ko' | 'zh' | string;
  glossary?: 'commerce-default' | { id: string };
};

type LocalizeOutput = {
  productId: string;
  locale: string;
  title: string;
  description: string;
  variants: Array<{ id: string; translatedAttributes: Record<string, string> }>;
  provider: 'turaxia-nmt' | 'openai' | 'custom';
  glossaryVersion: string;
};

Why commerce glossaries matter

Raw NMT confuses sizes (JP "XS-S" vs US numeric), materials ("cotton lawn" is not "cotton lace"), and brand-specific terms. Localize ships a default commerce glossary covering sizing standards, material vocabularies, and brand terminology we have curated across the supported merchant cohort.

Providers

• Default: turaxia-nmt — our tuned translation stack.
• Optional: openai — bring your own TURAXIA_LOCALIZE_OPENAI_API_KEY, or let us do it for you on Business and above.
• Optional: custom — provider adapter interface for internal NMT endpoints.

Benchmarks

• Fixture baseline: 4.06 ms on approved GU HTML → KZ ru (card in /proof).
• Output summary: "Балетные кроссовки на шнуровке" — glossary-consistent against the commerce-default glossary.

Release maturity

Localize is GA.