An open source design system that's fully customizable and agent ready
schema_version: 1 template_version: 3 kind: architecture id: architecture:internationalization authority: current archive_reason: null superseded_by: null approved_by: nynexman4464 approved_at: 2026-10-15 owners: [nynexman4464, cixzhang] applies_to: [ packages/core/src/i18n/, packages/core/locales/, packages/core/src/i18n/generated-locales/, packages/core/src/i18n/generated-english/, scripts/generate-i18n-runtime.mjs, scripts/i18n-english-fallback.mjs, packages/build/src/vite.ts, packages/core/src/utils/plainDate.ts, packages/core/src/utils/calendarSystem.ts, packages/core/src/utils/dateParser.ts, packages/core/src/PowerSearch/formatFilterValue.ts, packages/core/src/Timestamp/tooltipEntries.ts, packages/core/src/utils/characters.ts, packages/core/src/hooks/useStreamingText.ts, packages/core/src/utils/typeaheadMatch.ts, internal/eslint-plugin-astryx/, scripts/check-i18n-catalog.mjs, ] verified_by: [ packages/core/src/i18n/tests/resolve.test.ts, packages/core/src/i18n/tests/InternationalizationProvider.test.tsx, packages/core/src/i18n/tests/useLocale.test.tsx, packages/core/src/i18n/tests/useDirection.test.tsx, packages/core/src/i18n/tests/getLocaleDirection.test.ts, packages/core/src/i18n/tests/useCollator.test.tsx, packages/core/src/i18n/tests/calendarSystem.test.tsx, packages/core/src/utils/calendarSystem.test.ts, packages/core/src/i18n/useTranslator.test.tsx, packages/core/src/i18n/tests/englishFallback.test.ts, scripts/i18n-english-fallback.test.mjs, scripts/check-i18n-catalog.test.mjs, scripts/generate-i18n-runtime.test.mjs, packages/build/src/vite.test.ts, packages/build/src/vite.build.test.ts, internal/eslint-plugin-astryx/no-hardcoded-i18n-string.test.mjs, internal/eslint-plugin-astryx/no-raw-intl-locale.test.mjs, packages/core/src/PowerSearch/formatFilterValue.test.ts, packages/core/src/Timestamp/tooltipEntries.test.ts, packages/core/src/utils/typeaheadMatch.test.ts, packages/core/src/hooks/useTypeahead.test.tsx, packages/core/src/hooks/useTreeFocus.test.tsx, ]
deciding_specs: []
Internationalization architecture
{
"scope": "global",
"triggers": {
"accessibility": ["INV1", "INV1a", "INV3a", "INV7"],
"behavior": [
"INV1",
"INV1a",
"INV3",
"INV3a",
"INV4",
"INV5",
"INV7",
"INV8",
"INV9",
"INV10",
"INV17"
],
"compatibility": ["INV2", "INV9", "INV10"],
"layout": ["INV11", "INV12"],
"public-api": ["INV1", "INV1a", "INV2", "INV3a", "INV7", "INV9", "INV10"],
"react-runtime": ["INV3", "INV4", "INV11", "INV12", "INV13"]
}
}
Contract at a glance
| Area | Contract |
|---|---|
| Governing contract | component:InternationalizationProvider owns provider behavior. This record defines the intended internationalization contract and the implemented runtime-catalog delivery boundary; it does not certify every existing consumer's conformance. |
| System behavior | Astryx-owned strings resolve through per-locale overrides, supplied catalogs, then shipped English, walking exact → parent locale. Locale-sensitive operations (date, time, number, list, collation) receive the provider locale directly, with no catalog or override step; legacy pure helpers with an optional locale default deterministically to English, except the known currency() gap recorded under INV9. Without a provider the result is deterministic English. Authored catalogs are rich (defaultMessage + description); shipped runtime catalogs are generated string maps derived from them. Messages are ICU MessageFormat 1 strings. PlainDate stays Gregorian. Rendered direction comes from the DOM. |
| End-user impact | People using a non-English locale see Astryx interface text, formats, and sort order in that locale wherever a translation exists and English otherwise; layout and mirroring follow the document direction they are reading in. |
| Builder impact | Render one InternationalizationProvider and keep DOM dir aligned with it. Import a shipped locale from @astryxdesign/core/locales/<tag>.generated.js (string map) or <tag>.json (rich); both are accepted. Pass the provider locale to Astryx-owned Intl calls. Add Astryx strings to en.json with a description; never edit generated modules. No separate locale packages and no second Astryx runtime. |
| Compatibility/readiness | Released provider, hooks, subpath, rich JSON exports, and the rich context shape are preserved; RuntimeCatalog, ProviderMessagesByLocale, and the *.generated.js exports are additive. A server/RSC translation runtime and an external-runtime adapter remain separate decisions (INV13, INV14). useTypeahead and useTreeFocus match through INV17's shared fold, which replaced their released plain "starts with" matching. |
| Review checks | Reject Astryx-owned text or announcements built from literals, concatenation, or hand-rolled plurals instead of a catalog message (INV1a); locale-sensitive Intl or prototype calls outside the named shared helpers, or a public date helper called without its provider-locale argument (INV8); a parallel or replacement runtime without a migration decision (INV2); implicit host-locale reads (INV3); non-string message output (INV7); a translation catalog that adds stale keys or changes an ICU contract (INV6); a hand-edited, committed, or description-carrying generated module, or a changed rich export path (INV15); locale silently changing PlainDate calendar semantics (INV10); render-time provider direction driving geometry (INV11); the provider mutating DOM dir (INV12); type-to-select that misses a marked or stroked first letter, or a fold that reaches sorting or displayed text (INV17). |
| Governing rules | No deciding system spec. |
This table is a review projection; the body below is authoritative.
Purpose
Astryx localizes the system-owned text, formatting, comparison, and text direction of its components without becoming a general application internationalization framework. Applications continue to own product copy and may use any application i18n runtime alongside Astryx.
This record defines the library's catalog and locale boundaries. Consumer setup
and examples remain in astryx docs internationalization.
Cross-cutting component contract
The global routes project shared i18n claims into component and module reviews when their semantic triggers match. They do not require each component to repeat these rules or add a backlink merely to receive them. An accessibility review loads string ownership and string-output claims; a behavior review also loads locale, fallback, formatting, and calendar claims. Catalog generation and provider internals are not universal component requirements merely because they share this record.
Component and module contracts own which content is Astryx-authored versus
caller-authored, the semantic role of a content prop, local formatting inputs,
state-dependent behavior, and the evidence that proves those local outcomes.
Shared string ownership, helper boundaries, deterministic locale defaults, and
calendar requirements remain here. component:InternationalizationProvider
owns the provider's local API and precedence contract, not a second set of rules
for every component.
Review applies only the matched claims within their stated scope and resolves the direct component, module, or family owner for the exact delta. A local exception must name its semantic boundary and remain consistent with current shared claims; a missing local spec or existing implementation does not create an exemption. Draft routes do not supply governing authority.
System model
consumer content prop
→ wins when the component exposes semantic specialization
packages/core/locales/<tag>.json (authored, rich: defaultMessage + description)
→ scripts/generate-i18n-runtime.mjs
→ packages/core/src/i18n/generated-locales/<tag>.generated.ts (derived, ignored)
→ @astryxdesign/core/locales/<tag>.generated.js (published string map)
→ @astryxdesign/core/locales/<tag>.json (published rich, unchanged)
InternationalizationProvider
→ active locale
→ optional locale catalogs, rich or generated (ProviderMessagesByLocale)
→ normalized to the rich context shape (MessagesByLocale)
→ optional per-locale Astryx overrides
→ optional direction override
Astryx-owned string
→ provider-bound translator
→ exact locale
→ parent locale(s)
→ shipped English fallback
→ each Core module's derived English map for the keys it names
(packages/core/src/i18n/generated-english/, ignored; scripts/i18n-english-fallback.mjs)
→ the whole generated English catalog on public paths that resolve any Astryx key
Locale-sensitive formatting or comparison
→ active provider locale passed directly to the shared formatter
@astryxdesign/core/i18n is the canonical public entry point. The released
surface consists of InternationalizationProvider, InternationalizationContext,
their public value/prop types, useTranslator, TranslatorFn, useLocale,
useCollator, useDirection, getLocaleDirection, the types Locale,
Catalog, MessageEntry, RuntimeCatalog, MessagesByLocale,
ProviderMessagesByLocale, and Overrides, and the Translator interface.
Shipped catalogs are published under @astryxdesign/core/locales/: <tag>.json
is the rich authored catalog and <tag>.generated.js is its runtime string map,
for all 30 shipped locales plus pseudo.
Boundaries and invariants
- INV1 — Astryx owns Astryx strings, not application copy. Component-owned labels, announcements, instructions, and assistive text use Astryx catalogs. Product content remains caller-owned. A content prop wins when Astryx exposes it for semantic specialization.
- INV1a — Astryx-owned text is catalog-backed. Every Astryx-owned visible
or assistive string, including live-region announcements and
aria-*/titlevalues, MUST be anen.jsonkey resolved by the canonical translator. Text that varies at runtime, such as counts, ranges, or joined labels, MUST be one ICU message with placeholders, plurals, or selects; it MUST NOT be assembled at the call site from literals, concatenation, or hand-rolled plural branches. The translator is the enforcement boundary for this rule: because owned text funnels through one recognized API, lint can reject a literal or an assembled string in a text-bearing JSX child, string-typed prop, attribute, or announcement without guessing intent. Caller-owned product copy supplied through a content prop is outside this rule. - INV2 — The released provider and hooks are canonical.
InternationalizationProviderplus the hooks under@astryxdesign/core/i18nremain the supported runtime. A replacement provider, hook, subpath, or catalog ownership model needs an explicit compatibility and migration decision; a parallel public runtime is not added by convention. - INV3 — No provider is deterministic English. Components used outside a
provider resolve Astryx strings from the shipped English catalog, expose locale
en, directionltr, and do not read the browser or host locale implicitly. - INV3a — Factories take an option for each string they announce or show.
A public non-React factory (
architecture:public-component-apiINV22) that announces or shows Astryx text (a live-region announcement, anaria-*ortitlevalue, or a visible label) takes an option for each such string. A factory with one string takes a flat optional string option for it, such ascreateResizable'scollapsedLabel(a caller-supplied accessible name that already exists as its own option, such aslabel, stays flat and does not count toward the factory's strings); a factory with more than one groups them under one optionallabelsobject, each key optional. An absent option or key falls back to the catalog message, translated when the factory's React wrapper runs under a provider and English without one; a given string replaces that message, including over a provider's translation. No factory takes a translator: translation comes only from a provider. The rule covers INV22 factories. Per-message options are the factory mechanism; the external-runtime adapter (INV14) stays a separate, broader decision. - INV4 — Runtime locale changes are live. Re-rendering the provider with a new locale, messages, overrides, or direction updates consumers in that subtree. Astryx does not persist or select the application's locale.
- INV5 — Fallback is ordered and silent for expected gaps. For a valid BCP
47 locale, resolution checks per-locale overrides from exact to parent locale,
then supplied catalogs from exact to parent locale, then shipped English. A
missing non-English translation silently falls back. A key absent from every
source including English is a defect: development warns once and renders the
key visibly. Malformed locale tags are outside this fallback guarantee and may
throw when platform formatters or collators are constructed. Known bug: the
final step reads shipped English only, not a supplied
encatalog, so non-Astryx keys have no cross-locale fallback today; seecomponent:InternationalizationProviderOQ1. - INV6 — English is the source contract.
packages/core/locales/en.jsondefines Astryx's key set, default messages, descriptions, and ICU runtime contracts. Translation catalogs may omit keys and fall back to English; they may not add stale keys or change the argument, select, plural, ordinal, tag, or nesting contract of a translated entry. Translatordescriptiontext lives in the authored JSON only; runtime catalogs never carry it. - INV7 — Messages produce strings. Astryx catalogs use ICU MessageFormat 1
and
intl-messageformat. The supported translation result is a string suitable for visible text and attributes such asaria-labelandtitle. Rich React nodes, functions, and application-owned message objects are outside this runtime unless a later accepted contract adds them. - INV8 — Shared helpers own locale-sensitive behavior. Astryx-owned date,
time, number, relative-time, list, collation, speech-recognition, and similar
operations receive the active provider locale explicitly. Component code calls
shared formatter, parser, or collation helpers rather than constructing raw
Intlformatters or calling locale-sensitive prototype methods at arbitrary call sites. Supplying an argument namedlocalealone is not conformance: syntax-only lint cannot prove that it came from the provider. The named helper boundary makes that source traceable and reviewable. The formatter modules listed under Owning code own raw locale-sensitiveIntlaccess. Lint guards module access and locale-argument presence; review guards the narrower purposes of utilities and test oracles. Review and regression tests still verify that callers pass the provider locale. An allowlist entry is not proof that every consumer complies. Astryx-owned locale-sensitive call sites MUST NOT readnavigator.languageor silently substitute a host default or hardcoded locale. INV9 preserves deterministic compatibility defaults for external callers of older pure helpers. Date helpers also enforce INV10 independently of language and numbering. Locale-tag inspection, locale-independent grapheme segmentation, time-zone identifier validation, and machine-field conversion are separate utility responsibilities. They may inspect tags or use a deterministic fixed locale when the operation's result does not depend on the display locale. Those uses do not authorize a second path for locale-sensitive display formatting or an omitted provider locale in date, number, list, or collation helpers. Independent test oracles may use platformIntlto verify production helpers. Localized words surrounding a formatted value remain catalog-backed under INV1a; a formatter is not an alternative translation runtime. - INV9 — Pure helpers have deterministic compatibility defaults. A public pure
formatter that predates provider threading may keep an optional locale for
compatibility, but its omitted value resolves deterministically to English.
Astryx-owned call sites pass the provider locale explicitly. New pure helpers
require an explicit locale unless a current contract records another default.
The charts
currency()helper does not yet conform: an omitted locale follows the host default. That is a known conformance gap, not a recorded default; making it deterministic is a separate compatibility change. - INV10 — The application selects the calendar; values stay Gregorian. A
Calendarshows the calendar that it resolves from its owncalendarprop or the provider'scalendarprop, and otherwise the Gregorian calendar (spec:AST-111FR2).DateInput,DateRangeInput, andDateTimeInputdo the same. Locale changes language, numbering, and field order; a locale never selects the calendar, neither by its default calendar nor by a-u-ca-keyword.PlainDatevalues, constraints, and machine formats stay Gregorian ISO in every calendar. The runtime'sTemporalowns the arithmetic of every calendar whose months are not Gregorian; where it is missing, a date component that resolves such a calendar shows Gregorian dates (spec:AST-111FR5). Shared built-in date formatters pin the Gregorian calendar unless an Astryx call site passes the resolved calendar. The low-levelplainDateFormatdisplay-calendar override remains a supported explicit caller choice. - INV11 — Rendered direction comes from the DOM. The provider exposes a
semantic direction default, but Astryx layout, mirroring, and interaction SHOULD
resolve from the rendered region through CSS logical properties,
direction-conditioned CSS, or a lazy DOM read.
useDirection()is a render-time last resort and MUST NOT replace the DOM as the ordinary source for component geometry or behavior, because provider direction can disagree with<html dir>and create first-paint or hydration errors. - INV12 — Locale and direction are related but distinct. The provider derives
a default direction from locale and accepts an explicit override. It does not
mutate DOM
dir. Applications own the page or regiondir, and must keep it aligned with the provider when they want Astryx layout and browser text flow to share a direction. - INV13 — Client context is the current translation runtime. The shipped
translator and locale hooks are client-context APIs. Pure helpers such as
getLocaleDirectionremain server-safe. A server/RSC translation runtime is a separate API decision, not an implied capability of the current hooks. - INV14 — External-runtime integration is additive. Applications may run another i18n provider alongside Astryx. A future adapter may delegate Astryx formatting to an application runtime while preserving Astryx key lookup, fallback, string results, and released provider compatibility. Astryx does not absorb application catalogs merely to offer a general-purpose i18n framework.
- INV15 — Runtime catalogs are derived, never authored. Every shipped locale
has one rich authored catalog (
packages/core/locales/<tag>.json, exported unchanged as@astryxdesign/core/locales/<tag>.json) and one generated runtime string map (@astryxdesign/core/locales/<tag>.generated.js) whose public shape isRuntimeCatalog, a key-to-message record. The generated sources live underpackages/core/src/i18n/generated-locales/, are ignored by version control, and are regenerated before install, build, test, Storybook, docsite, and sandbox runs; a long-running development server regenerates them when an authored catalog changes, and an edit that lands during the initial generation queues another pass rather than being missed. A rich entry without a stringdefaultMessagefails generation; runtime maps carry nodescriptionor other metadata. The built-in English fallback reads English derived from the generated English module: each Core module that names catalog keys registers a derived map of exactly those keys, and public paths that resolve any Astryx key register the whole module. Neither path, shape, nor export of the rich catalogs changes because generated modules exist. - INV16 — Standard build integration resolves both catalog forms. The Astryx
Vite plugin resolves
@astryxdesign/core/locales/<tag>.jsonto the rich authored file and@astryxdesign/core/locales/<tag>.generated.jsto the generated source module in source mode, so applications and the repository's own apps import either form the same way in development and production. - INV17 — Type-to-select ignores marks. Everywhere Core moves to an item
when a person types its first letters, the typed letters and each item's label
are compared after folding, the same way in every locale. That covers the
public
useTypeaheadanduseTreeFocushooks and every collection with type-to-select, including Selector, MultiSelector, DropdownMenu, ContextMenu and TreeList. Folding ignores case; removes the combining marks left by canonical decomposition (U+0300–U+036F), in any script; maps exactly six Latin letters with a stroke or bar to their base letter (đ→d, ł→l, ø→o, ħ→h, ŧ→t, ƀ→b), in either case; and maps Turkish dotless ı and dotted İ to i. So "d" reaches "Đào", "a" reaches "Ánh" and "Ä", "l" reaches "Łódź", and "i" or "ı" reaches "Isparta" and "İzmir". When the typed letters include a diacritic, a stroked letter, ı or İ, items that match them exactly come first; for that preference case pairs the Turkish way, ı with I and İ with i, so "ı" over "İzmir, Isparta" lands on Isparta and "İ" over "Isparta, İzmir" lands on İzmir. INV17 does not change sorting, search filtering or displayed text. One shared folding helper serves every path, so they all match the same way.
Change coupling
Changes to the provider, context, public i18n barrel, resolver, catalog schema, source catalog, runtime-catalog generator or its watcher, locale package exports, build-plugin locale aliases, locale-aware helpers, catalog validation, or i18n lint rules must review this record. A change preserves the architecture only when its fallback, ownership, deterministic defaults, runtime-update behavior, and output type remain true.
A new public provider or hook, application-catalog ownership, rich-message output,
server translation runtime, implicit host-locale behavior, or calendar
semantics beyond spec:AST-111 is a new human API or ownership decision. It cannot be
inferred from an implementation pull request.
Owning code
packages/core/src/i18n/— provider, context, public hooks, locale-direction derivation, catalog types, and lookup/formatting runtime.packages/core/src/utils/plainDate.ts,packages/core/src/utils/dateParser.ts,packages/core/src/utils/calendarDateParser.ts,packages/core/src/Timestamp/formatInstant.ts,packages/core/src/Timestamp/formatRelativeTime.ts,packages/core/src/PowerSearch/formatFilterValue.ts,packages/core/src/NumberInput/numberParser.ts,packages/core/src/utils/timeFormat.ts,packages/core/src/i18n/useCollator.ts,packages/charts/src/formatters.ts— shared locale-sensitive formatters, parsers, and collation. Component consumers pass the provider locale; naming a module here does not approve a duplicate formatting path or incomplete propagation in its callers.packages/core/src/Timestamp/tooltipEntries.ts— time-zone identifier validation, isolated from localized date rendering.packages/core/src/utils/plainDate.tsgetTimeZoneParts— deterministic Gregorian machine-field conversion for instant/calendar-date operations.packages/core/src/i18n/resolve.ts,getLocaleDirection.ts— locale-tag inspection and direction derivation, not date/number display formatting.packages/core/src/utils/characters.ts,packages/core/src/hooks/useStreamingText.ts— locale-independent grapheme segmentation; this does not admit locale-sensitive word/sentence segmentation without the provider-locale helper contract.packages/core/src/utils/typeaheadMatch.ts— the shared fold that type-to-select matching uses (INV17): it ignores marks and folds stroked letters and dotless or dotted i, and changes no sorting, filtering, or displayed text.packages/core/locales/en.json— source key set, default English messages, and translator descriptions.packages/core/locales/*.json— partial translated catalogs, rich shape, the Crowdin round-trip surface.scripts/generate-i18n-runtime.mjs— derives the runtime string maps and the pseudo locale, verifies every authored catalog projects to a metadata-free map (check:i18n-runtimeincheck:repo), and watches authored catalogs during development.packages/core/src/i18n/generated-locales/*.generated.ts— derived runtime catalogs, ignored by version control, published as@astryxdesign/core/locales/*.generated.js.scripts/i18n-english-fallback.mjs,packages/core/src/i18n/englishFallback.ts,packages/core/src/i18n/fullEnglishFallback.ts— derive each Core module's English map intopackages/core/src/i18n/generated-english/(ignored, internal, not exported), check that every module naming catalog keys registers its own map, and name the public paths that register the whole catalog: the publicuseTranslator, the publicInternationalizationContextexport, and PowerSearch operator labels. No other Core module imports the publicuseTranslatoror the public context export.packages/core/package.jsonexports— publishes both./locales/*.jsonand./locales/*.generated.js.packages/build/src/vite.ts— resolves both catalog import forms in source mode.scripts/check-i18n-catalog.mjs— source/translation key, syntax, runtime contract, and plural validation.internal/eslint-plugin-astryx/no-hardcoded-i18n-string.js— rejects Astryx-owned user-facing literals and assembled text in JSX text, string-typed props, andannounce()arguments so every owned string is a catalog key.internal/eslint-plugin-astryx/i18n-key-format.js— enforces the@astryx.namespace and camelCase catalog-key segments. This rule currently lacks its own focused test file; adding one is a verification gap.internal/eslint-plugin-astryx/no-raw-intl-locale.js— enforces the shared locale-sensitive helper boundary with syntax checks and explicit locale-argument checks. The separate utility and test-oracle scopes above do not widen that display-formatting boundary. A new formatter module requires focused boundary tests; passing lint alone does not prove provider-locale provenance.- Component contracts — own which semantic content is Astryx-authored versus caller-authored and which content props specialize a component.
Deciding specs
No deciding system spec. The provider-local behavior contract belongs to
component:InternationalizationProvider; this record owns the shared catalog,
formatter, and DOM-direction boundaries.
Verification
The map names evidence for the intended contract, not proof that every existing consumer or every edge case conforms. Helper admission defines responsibility; review and regression tests verify caller behavior. Missing evidence or violating callers remain conformance work and do not relax INV1a, INV8, INV9, or INV10.
| Invariant | Evidence | Failure signal |
|---|---|---|
| INV1, INV1a, INV7 | hardcoded-string lint, catalog tests, component translation tests with a non-English provider | Astryx-owned text bypasses the catalog, an announcement or count is assembled from fragments or a hand-rolled plural, or non-string output reaches visible/AT attributes |
| INV2, INV13, INV14 | export drift checks, public i18n tests, compatibility review | A parallel/replacement runtime lands without migration, or client hooks claim server behavior |
| INV3–INV5 | resolver and provider rerender tests | no-provider output depends on the host, locale swaps stay stale, fallback order changes, or malformed-locale behavior is described as graceful |
| INV3a | factory unit tests: a flat option or labels key replaces its message, including under a provider, and outside a provider its absence announces or shows shipped English; wrapper tests: under a non-English provider its absence gives the translation. Evidence gap: no factory test covers a labels key, or a flat option under a provider, yet |
a factory announces or shows Astryx text that no option or labels key can replace, groups more than one string outside one labels object, takes a translator, ignores a given string, or gives something other than the catalog message when it is absent |
| INV6 | check:i18n-catalog, key-format lint, and focused mutation tests |
stale/malformed keys, malformed ICU, or source/translation runtime-contract drift passes CI |
| INV15 | generator tests, check:i18n-runtime, package-export drift check, provider/resolver runtime-catalog tests; per-module English resolution-parity test (every key each Core module names, in every shipped locale’s fallback path, its own map versus the whole catalog); import-cost check (component bundles carry only the English they name; public paths keep the whole catalog) |
a generated module carries descriptions or is committed, a malformed entry projects instead of failing, a rich export path changes, or a RuntimeCatalog input is rejected or leaks a non-rich context shape, a key a module names resolves differently from the whole catalog, a component bundle carries the whole catalog, or a public path stops resolving a shipped key |
| INV16 | build-plugin unit and real-build tests | a rich or generated locale import fails to resolve through the standard plugin |
| INV8, INV9 | raw-Intl-locale lint (module allowlist plus date-helper locale-argument check) and provider-locale regression tests, including a server/client render pair | Astryx output follows the host locale, raw Intl appears outside a named formatter module, an owned call omits the locale argument, or server and client output differ for the same provider locale |
| INV10 | PlainDate and built-in date formatter tests, including locales with non-Gregorian defaults; calendar resolution and calendar-system tests (calendarSystem.test.tsx, calendarSystem.test.ts) |
a locale, with or without -u-ca-, selects a non-Gregorian calendar, a value or constraint leaves Gregorian ISO, a calendar that needs Temporal breaks where it is missing, or the explicit low-level display override is lost |
| INV11, INV12 | direction helper/provider tests plus rendered RTL audit | component layout reads provider direction instead of the region, provider mutates DOM, or overrides stop composing |
| INV17 | typeaheadMatch.test.ts, useTypeahead and useTreeFocus tests and type-to-select tests in Selector, MultiSelector, DropdownMenu and TreeList, one case each: a combining mark ("a" reaches "Ánh"); each stroked letter (đ, ł, ø, ħ, ŧ, ƀ); ı and İ ("i" and "ı" reach "Isparta" and "İzmir"); and a typed diacritic, stroked letter, ı or İ preferring the exact match ("đ" reaches "Đào" before "Dung", "ı" reaches "Isparta" before "İzmir", "İ" reaches "İzmir" before "Isparta"); under en, vi, pl, sv and tr providers |
a plain letter misses a marked or stroked first letter in any locale, i or ı misses an İ or I label, a typed diacritic, stroked letter, ı or İ does not prefer the exact match, ı or İ pairs case the non-Turkish way, two paths disagree, or folding reaches sorting or displayed text |