跳转至

国际化架构

{
  "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"]
  }
}

契约概览

领域 契约
治理契约 component:InternationalizationProvider 负责 Provider 行为。本记录定义了预期的国际化契约以及已实现的运行时目录交付边界;它并不验证所有现有使用方的一致性。
系统行为 Astryx 拥有的字符串按「精确区域 → 父级区域」的顺序解析:先查逐区域覆盖,再查提供的目录,最后回退到随附的英文。区域敏感的操作(日期、时间、数字、列表、排序)直接接收 Provider 的区域设置,不经过目录或覆盖步骤;带可选区域参数的传统纯辅助函数则确定性地默认使用英文,唯一的例外是 INV9 中记录的已知 currency() 缺口。没有 Provider 时,结果确定性地为英文。编写的目录是富格式(defaultMessage + description);随附的运行时目录是从它们生成的字符串映射。消息为 ICU MessageFormat 1 字符串。PlainDate 保持公历。渲染方向来自 DOM。
最终用户影响 使用非英文区域设置的用户会在存在译文的地方看到对应区域的 Astryx 界面文本、格式和排序顺序,否则看到英文;布局和镜像跟随他们正在阅读的文档方向。
构建者影响 渲染一个 InternationalizationProvider,并保持 DOM 的 dir 与其一致。从 @astryxdesign/core/locales/<tag>.generated.js(字符串映射)或 <tag>.json(富格式)导入随附的区域设置;两者均被接受。将 Provider 的区域设置传递给 Astryx 拥有的 Intl 调用。向 en.json 添加带描述的 Astryx 字符串;永远不要编辑生成的模块。无需单独的区域包,也无需第二个 Astryx 运行时。
兼容性/就绪状态 已发布的 provider、hooks、subpath、富 JSON 导出以及富上下文形状均予保留;RuntimeCatalog、ProviderMessagesByLocale 和 *.generated.js 导出是新增的。服务器/RSC 翻译运行时和外部运行时适配器仍是单独的决策(INV13、INV14)。useTypeahead 和 useTreeFocus 通过 INV17 的共享折叠进行匹配,取代了已发布的纯“以…开头”匹配。
评审检查 拒绝使用由字面量、拼接或手写复数形式构建的 Astryx 自有文本或公告,而应使用目录消息(INV1a);在指定的共享辅助函数之外进行区域设置敏感的 Intl 或原型调用,或在没有 provider-locale 参数的情况下调用公共日期辅助函数(INV8);没有迁移决策的并行或替代运行时(INV2);隐式主机区域设置读取(INV3);非字符串消息输出(INV7);添加过期键或更改 ICU 合约的翻译目录(INV6);手工编辑、已提交或携带描述的生成模块,或更改的富导出路径(INV15);区域设置静默更改 PlainDate 日历语义(INV10);渲染时 provider 方向驱动几何布局(INV11);provider 修改 DOM dir(INV12);输入选择时遗漏带标记或带笔画的首字母,或触及排序或显示文本的折叠(INV17)。
治理规则 无决定性系统规范。

此表是评审投影;以下正文为权威依据。

目的

Astryx 对组件中系统所有的文本、格式、比较和文本方向进行本地化,但不会成为一个通用的应用国际化框架。应用仍然拥有产品文案,并可在 Astryx 之外或与 Astryx 同时使用任何应用 i18n 运行时。

本记录定义了库的目录和区域设置边界。使用者的设置和示例仍保留在 astryx docs internationalization 中。

横切组件契约

当语义触发条件匹配时,全局路由会将共享的 i18n 声明投射到组件和模块评审中。这些规则并不要求每个组件重复它们或添加反向链接来获得这些声明。可访问性评审会加载字符串所有权和字符串输出声明;行为评审还会加载区域设置、回退、格式和日历声明。目录生成和 provider 内部机制并不因为它们与本记录共享而成为所有组件的通用要求。

组件和模块契约自行界定哪些内容是 Astryx 编写的、哪些是调用方编写的,内容 prop 的语义角色、本地格式化输入、状态相关行为,以及证明这些本地结果的证据。共享字符串所有权、辅助函数边界、确定性的区域设置默认值和日历要求仍保留在本文档。component:InternationalizationProvider 拥有 provider 的本地 API 和优先级契约,而不是为每个组件再制定一套规则。

评审仅适用于其声明范围内的匹配主张,并为确切差异确定直接的组件、模块或家族负责人。本地例外必须指明其语义边界,并与当前共享主张保持一致;缺少本地规范或现有实现并不构成豁免。草稿路由不提供管辖权威。

系统模型

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 是规范的公开入口点。发布的内容包含 InternationalizationProvider、InternationalizationContext、它们的公开值/属性类型、useTranslator、TranslatorFn、useLocale、useCollator、useDirection、getLocaleDirection、类型 Locale、Catalog、MessageEntry、RuntimeCatalog、MessagesByLocale、ProviderMessagesByLocale、Overrides,以及 Translator 接口。随附的目录发布在 @astryxdesign/core/locales/ 下:<tag>.json 是内容丰富的创作目录,<tag>.generated.js 是其运行时字符串映射,适用于全部 30 个随附区域设置以及 pseudo。

边界与不变量

  • INV1 — Astryx 拥有 Astryx 字符串,而非应用程序文案。 组件拥有的标签、公告、说明和辅助文本使用 Astryx 目录。产品内容仍归调用方所有。当 Astryx 暴露内容属性用于语义特化时,该属性胜出。
  • INV1a — Astryx 拥有的文本以目录为支撑。 每个 Astryx 拥有的可见或辅助字符串,包括实时区域公告和 aria-*/title 值,MUST 是通过规范翻译器解析的 en.json 键。在运行时变化的文本(如计数、范围或拼接的标签)MUST 是带有占位符、复数或选择的单条 ICU 消息;它 MUST NOT 在调用点通过字面量、拼接或手写复数分支来组装。翻译器是此规则的执行边界:因为拥有的文本汇聚于一个被认可的 API,lint 可以拒绝承载文本的 JSX 子元素、字符串类型属性、属性或公告中的字面量或拼接字符串,而无需猜测意图。通过内容属性提供的调用方拥有的产品文案不受此规则约束。
  • INV2 — 已发布的 provider 和 hooks 是规范的。 InternationalizationProvider 以及 @astryxdesign/core/i18n 下的 hooks 仍为受支持的运行时。替代的 provider、hook、子路径或目录所有权模型需要明确的兼容性和迁移决策;不会按惯例添加并行的公共运行时。
  • INV3 — 没有 provider 时是确定性英语。 在 provider 之外使用的组件从随附的英语目录解析 Astryx 字符串,暴露区域设置 en、方向 ltr,并且不会隐式读取浏览器或宿主区域设置。
  • INV3a — 工厂为其公告或展示的每个字符串提供一个选项。 公告或展示 Astryx 文本(实时区域公告、aria-* 或 title 值,或可见标签)的公共非 React 工厂(architecture:public-component-api INV22)为每个此类字符串提供一个选项。只有一个字符串的工厂为其接受一个扁平的可选字符串选项,例如 createResizable 的 collapsedLabel(调用方提供的可访问名称,如果已经作为其自身的选项存在,如 label,则保持扁平,不计入工厂的字符串);有多个字符串的工厂将它们分组到一个可选的 labels 对象下,每个键均为可选。缺失的选项或键回退到目录消息,当工厂的 React 包装在 provider 下运行时翻译该消息,没有 provider 时则使用英语;给定的字符串替换该消息,包括覆盖 provider 的翻译。没有工厂接受翻译器:翻译只来自 provider。此规则涵盖 INV22 工厂。每条消息的选项是工厂机制;外部运行时适配器(INV14)仍是单独的、更广泛的决策。
  • INV4 — 运行时区域设置变更是实时生效的。 使用新的区域设置、消息、覆盖或方向重新渲染 provider,会更新该子树中的消费者。Astryx 不会持久化或选择应用程序的区域设置。
  • INV5 — 回退对于预期缺口是有序且静默的。 对于有效的 BCP 47 区域设置,解析按从精确到父区域设置的顺序检查每区域设置覆盖,然后检查从精确到父区域设置的所提供目录,最后检查随附的英语。缺失的非英语翻译会静默回退。在所有来源(包括英语)中都缺失的键是缺陷:开发环境会警告一次并可见地渲染该键。格式错误的区域设置标签不在该回退保证范围内,在构造平台格式化器或排序器时可能抛出异常。已知 bug:最后一步只读取随附的英语,而不读取提供的 en 目录,因此非 Astryx 键目前没有跨区域设置回退;参见 component:InternationalizationProvider OQ1。
  • INV6 — 英语是源契约。 packages/core/locales/en.json 定义了 Astryx 的键集、默认消息、描述和 ICU 运行时契约。翻译目录可以省略键并回退到英语;它们不得添加过时的键,也不得更改已翻译条目的参数、select、plural、ordinal、标签或嵌套契约。翻译器的 description 文本只存在于创作 JSON 中;运行时目录绝不携带它。
  • INV7 — 消息产生字符串。 Astryx 目录使用 ICU MessageFormat 1 和 intl-messageformat。受支持的翻译结果是适合可见文本和 aria-label、title 等属性的字符串。丰富的 React 节点、函数和应用程序拥有的消息对象不在该运行时范围内,除非后续接受的契约添加它们。
  • INV8 — 共享辅助函数拥有区域设置敏感的行为。 Astryx 拥有的日期、时间、数字、相对时间、列表、排序、语音识别及类似操作会显式接收活动的 provider 区域设置。组件代码调用共享的格式化、解析或排序辅助函数,而不是在任意调用点构造原始 Intl 格式化器或调用区域设置敏感的原型方法。仅提供一个名为 locale 的参数并不符合要求:仅语法层面的 lint 无法证明它来自 provider。命名的辅助函数边界使该来源可追踪、可评审。

Owning code 下列出的格式化模块拥有原始的区域设置敏感 Intl 访问权。lint 守卫模块访问和 locale 参数的存在;评审守卫实用工具和测试预言机的更窄用途。评审和回归测试仍会验证调用方是否传入 provider 区域设置。允许列表条目并不能证明每个消费者都合规。Astryx 拥有的区域设置敏感调用点 MUST NOT 读取 navigator.language,也不得静默替换为宿主默认值或硬编码区域设置。INV9 为旧纯辅助函数的外部调用方保留确定性兼容默认值。

日期辅助函数还独立于语言和编号系统执行 INV10。

区域设置标签检查、与区域设置无关的字素分段、时区标识符验证和机器字段转换是单独的实用工具职责。当操作结果不依赖于显示区域设置时,它们可以检查标签或使用确定性的固定区域设置。这些用途不授权第二条区域设置敏感显示格式化路径,也不授权在日期、数字、列表或排序辅助函数中省略 provider 区域设置。独立的测试预言机可以使用平台 Intl 来验证生产辅助函数。

围绕格式化值的本地化词语在 INV1a 下仍以目录为支撑;格式化器不是替代的翻译运行时。

  • INV9 — 纯辅助函数具有确定性兼容默认值。 先于 provider 线程化的公共纯格式化器可以为兼容性保留可选的 locale,但其省略值会确定性地解析为英语。Astryx 拥有的调用点显式传入 provider 区域设置。新的纯辅助函数需要显式的 locale,除非当前契约记录了其他默认值。charts 的 currency() 辅助函数尚不符合:省略的 locale 跟随宿主默认值。这是一个已知的符合性差距,而非已记录的默认值;使其具有确定性是单独的兼容性变更。
  • INV10 — 应用程序选择日历;值保持格里高利历。 Calendar 显示它从自己的 calendar 属性或 provider 的 calendar 属性解析出的日历,否则显示格里高利历(spec:AST-111 FR2)。DateInput、DateRangeInput 和 DateTimeInput 也是如此。区域设置改变语言、编号系统和字段顺序;区域设置从不选择日历,既不通过其默认日历,也不通过 -u-ca- 关键字。PlainDate 值、约束和机器格式在每种日历中都保持格里高利 ISO。运行时的 Temporal 拥有所有月份非格里高利历的日历运算;在缺少它的地方,解析此类日历的日期组件会显示格里高利日期(spec:AST-111 FR5)。共享的内置日期格式化器固定使用格里高利历,除非 Astryx 调用点传入解析出的日历。底层 plainDateFormat 的显示日历覆盖仍是受支持的显式调用方选择。
  • INV11 — 渲染方向来自 DOM。 provider 暴露语义方向默认值,但 Astryx 布局、镜像和交互 SHOULD 通过 CSS 逻辑属性、方向条件 CSS 或惰性 DOM 读取从渲染区域解析。useDirection() 是渲染时的最后手段,MUST NOT 将 DOM 替换为组件几何或行为的常规来源,因为 provider 方向可能与 <html dir> 不一致,并造成首次绘制或 hydration 错误。
  • INV12 — 区域设置和方向相关但不同。 provider 从区域设置派生默认方向,并接受显式覆盖。它不改变 DOM 的 dir。应用程序拥有页面或区域的 dir,当它们希望 Astryx 布局与浏览器文本流向共享方向时,必须使其与 provider 保持一致。
  • INV13 — 客户端上下文是当前的翻译运行时。 随附的翻译器和 locale hooks 是客户端上下文 API。getLocaleDirection 等纯辅助函数保持服务器安全。服务器/RSC 翻译运行时是单独的 API 决策,不是当前 hooks 的隐含能力。
  • INV14 — 外部运行时集成是附加性的。 应用程序可以在 Astryx 旁边运行另一个 i18n provider。未来的适配器可以将 Astryx 格式化委托给应用程序运行时,同时保留 Astryx 键查找、回退、字符串结果和已发布 provider 的兼容性。Astryx 不会仅仅为了提供通用 i18n 框架而吸收应用程序目录。

  • INV15 — 运行时目录是派生而来,绝不是手写的。 每个随附发布的 locale 都有一个内容丰富的撰写目录(packages/core/locales/<tag>.json,原样导出为 @astryxdesign/core/locales/<tag>.json)和一个生成的运行时字符串映射(@astryxdesign/core/locales/<tag>.generated.js),其公开形态为 RuntimeCatalog,即键到消息的记录。生成的源码位于 packages/core/src/i18n/generated-locales/ 下,被版本控制忽略,并在安装、构建、测试、Storybook、docsite 和 sandbox 运行之前重新生成;长时间运行的开发服务器会在撰写目录发生变化时重新生成它们;如果在初始生成期间有编辑落地,则会排队进行另一轮处理,而不会遗漏。若富条目没有字符串 defaultMessage,生成将失败;运行时映射不携带 description 或其他元数据。内置英文 fallback 读取从生成的英文模块派生的英文:每个命名目录键的 Core 模块都会注册一个恰好包含这些键的派生映射,而解析任何 Astryx 键的公开路径会注册整个模块。生成模块的存在不会改变富目录的路径、形态或导出。

  • INV16 — 标准构建集成解析两种目录形式。 Astryx Vite 插件在源码模式下将 @astryxdesign/core/locales/<tag>.json 解析为富撰写文件,将 @astryxdesign/core/locales/<tag>.generated.js 解析为生成的源码模块,因此应用和仓库自身的应用在开发和生产中以相同方式导入任何一种形式。
  • INV17 — 键入选择忽略附加符号。 凡是 Core 在用户键入条目首字母时移动到该条目的地方,输入的字母与每个条目的标签都会在折叠后进行比较,且在每个 locale 中采用相同方式。这涵盖公开的 useTypeahead 和 useTreeFocus hooks,以及所有支持键入选择的集合,包括 Selector、MultiSelector、DropdownMenu、ContextMenu 和 TreeList。折叠忽略大小写;移除任何文字系统中由规范分解留下的组合附加符号(U+0300–U+036F);将恰好六个带笔画或横杠的拉丁字母映射到其基础字母(đ→d、ł→l、ø→o、ħ→h、ŧ→t、ƀ→b),大小写皆然;并将土耳其语无点 ı 和有点 İ 映射为 i。因此 “d” 可到达 “Đào”,“a” 可到达 “Ánh” 和 “Ä”,“l” 可到达 “Łódź”,而 “i” 或 “ı” 可到达 “Isparta” 和 “İzmir”。当输入的字母包含变音符号、带笔画字母、ı 或 İ 时,与它们完全匹配的条目会排在前面;该优先级按土耳其语方式进行大小写配对,即 ı 与 I 配对、İ 与 i 配对,因此 “ı” 针对 “İzmir, Isparta” 会落在 Isparta,而 “İ” 针对 “Isparta, İzmir” 会落在 İzmir。INV17 不改变排序、搜索过滤或显示文本。一个共享的折叠 helper 服务于所有路径,因此它们都以相同方式匹配。

变更耦合

对 provider、context、公开 i18n barrel、resolver、目录 schema、源目录、运行时目录生成器或其 watcher、locale 包导出、构建插件 locale 别名、locale 感知 helper、目录验证或 i18n lint 规则的更改,都必须审查本记录。只有当更改的 fallback、所有权、确定性默认值、运行时更新行为和输出类型仍然成立时,它才保留该架构。

新的公开 provider 或 hook、应用目录所有权、富消息输出、服务端翻译运行时、隐式宿主 locale 行为,或超出 spec:AST-111 的日历语义,都属于面向人的 API 或所有权决策。它们无法从实现性的 pull request 中推断出来。

代码所有权

  • packages/core/src/i18n/ — provider、context、公开 hooks、locale 方向推导、目录类型以及查找/格式化运行时。
  • 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 — 共享的 locale 敏感格式化器、解析器和排序规则。组件使用方传入 provider locale;在此列出某个模块并不表示认可其调用方中的重复格式化路径或不完整传播。
  • packages/core/src/Timestamp/tooltipEntries.ts — 时区标识符验证,与本地化日期渲染相隔离。
  • packages/core/src/utils/plainDate.ts 的 getTimeZoneParts — 为 instant/calendar-date 操作提供确定性的公历机器字段转换。
  • packages/core/src/i18n/resolve.ts、getLocaleDirection.ts — locale 标签检查与方向推导,而非日期/数字显示格式化。
  • packages/core/src/utils/characters.ts、packages/core/src/hooks/useStreamingText.ts — 与 locale 无关的字素(grapheme)分割;这并不允许在没有 provider-locale helper 契约的情况下引入 locale 敏感的单词/句子分割。
  • packages/core/src/utils/typeaheadMatch.ts — type-to-select 匹配所使用的共享折叠(INV17):它忽略附加符号,折叠带笔画字母以及无点或有点的 i,并且不改变排序、过滤或显示文本。
  • packages/core/locales/en.json — 源键集合、默认英文消息以及译者说明。
  • packages/core/locales/*.json — 部分翻译目录、富形态(rich shape)、Crowdin 往返对接面。
  • scripts/generate-i18n-runtime.mjs — 派生运行时字符串映射和伪 locale,验证每个撰写目录都能投影为无元数据映射(check:repo 中的 check:i18n-runtime),并在开发期间监视撰写目录。
  • packages/core/src/i18n/generated-locales/*.generated.ts — 派生的运行时目录,被版本控制忽略,作为 @astryxdesign/core/locales/*.generated.js 发布。
  • scripts/i18n-english-fallback.mjs、packages/core/src/i18n/englishFallback.ts、packages/core/src/i18n/fullEnglishFallback.ts — 将每个 Core 模块的英文映射派生到 packages/core/src/i18n/generated-english/(被忽略、内部使用、不导出),检查每个命名目录键的模块都注册自己的映射,并列出注册整个目录的公开路径:公开的 useTranslator、公开的 InternationalizationContext 导出,以及 PowerSearch 运算符标签。没有其他 Core 模块导入公开的 useTranslator 或公开的 context 导出。
  • packages/core/package.json 的 exports — 发布 ./locales/*.json 和 ./locales/*.generated.js 两者。
  • packages/build/src/vite.ts — 在源码模式下解析两种目录导入形式。
  • scripts/check-i18n-catalog.mjs — 源键/翻译键、语法、运行时契约和复数验证。
  • internal/eslint-plugin-astryx/no-hardcoded-i18n-string.js — 拒绝 Astryx 拥有的面向用户字面量及组装文本出现在 JSX 文本、字符串类型 props 和 announce() 参数中,从而确保每个自有字符串都是目录键。
  • internal/eslint-plugin-astryx/i18n-key-format.js — 强制 @astryx. 命名空间和 camelCase 的目录键段。目前该规则没有独立的专项测试文件;补上一个正是验证缺口所在。
  • internal/eslint-plugin-astryx/no-raw-intl-locale.js — 通过语法检查和显式 locale 参数检查来强制共享的 locale 敏感 helper 边界。上述独立的 utility 和 test-oracle 作用域并不会扩大该显示格式化边界。新的 formatter 模块需要针对性的边界测试;仅通过 lint 并不能证明 provider-locale 来源。
  • 组件契约 — 负责界定哪些语义内容由 Astryx 撰写、哪些由调用方撰写,以及哪些内容 props 对组件进行特化。

决定性规范

不存在决定性的系统规范。提供程序本地的行为契约属于 component:InternationalizationProvider;本记录拥有共享目录、 格式化器和 DOM 方向边界。

验证

该映射列举的是预期契约的证据,而非证明每个现有 消费者或每个边缘情况都符合。辅助函数的准入界定了职责; 审查和回归测试验证调用方的行为。缺失证据或违规的 调用方仍属合规性工作,并不会放宽 INV1a、INV8、INV9 或 INV10。

不变量 证据 失败信号
INV1, INV1a, INV7 硬编码字符串 lint 检查、目录测试、使用非英语提供程序的组件翻译测试 Astryx 拥有的文本绕过目录,公告或计数由片段或手写复数逻辑拼接而成,或非字符串输出到达可见/AT 属性
INV2, INV13, INV14 导出漂移检查、公开 i18n 测试、兼容性审查 并行/替代运行时未经迁移即落地,或客户端钩子声称具备服务器行为
INV3–INV5 解析器和提供程序的重新渲染测试 无提供程序时的输出依赖于宿主,切换区域设置后仍停留在旧值,回退顺序改变,或将格式错误的区域设置行为描述为优雅降级
INV3a 工厂单元测试:一个扁平选项或 labels 键可替换其消息,包括在提供程序之下;在提供程序之外,其缺失时会宣布或显示内置英语;包装器测试:在非英语提供程序之下,其缺失时给出翻译。证据缺口:还没有工厂测试覆盖 labels 键,或提供程序下的扁平选项 工厂宣布或显示无法由任何选项或 labels 键替换的 Astryx 文本,在一个 labels 对象之外对多个字符串分组,接收一个翻译器,忽略给定的字符串,或在其缺失时给出目录消息以外的内容
INV6 check:i18n-catalog、键格式 lint 检查以及针对性的变异测试 过时/格式错误的键、格式错误的 ICU,或源码/翻译运行时契约漂移通过 CI 检查
INV15 生成器测试、check:i18n-runtime、package-export 漂移检查、provider/resolver 运行时目录测试;逐模块英文解析一致性测试(每个 Core 模块所命名的每一个键,在每种已发布区域设置的回退路径中,将其自身映射与整个目录进行对比);导入成本检查(组件包仅携带其命名的英文;公共路径保留整个目录) 生成模块携带描述或被提交,畸形条目被投射而非失败,富导出路径发生变化,或 RuntimeCatalog 输入被拒绝或泄漏非富上下文形状,某个模块所命名的键与整个目录的解析结果不同,组件包携带整个目录,或公共路径不再解析已发布的键
INV16 build-plugin 单元测试和真实构建测试 富区域设置或生成区域设置的导入无法通过标准插件解析
INV8, INV9 raw-Intl-locale lint(模块允许列表以及 date-helper 的 locale-argument 检查)以及 provider-locale 回归测试,包括一组服务端/客户端渲染对 Astryx 输出遵循宿主区域设置,原始 Intl 出现在命名格式化模块之外,自有调用省略了 locale 参数,或对于同一 provider locale,服务端和客户端输出不同
INV10 PlainDate 和内置日期格式化器测试,包括具有非公历默认值的区域设置;日历解析和日历系统测试(calendarSystem.test.tsx、calendarSystem.test.ts) 某个区域设置(无论是否带 -u-ca-)选择了非公历日历,某个值或约束偏离公历 ISO,需要 Temporal 的日历在缺少 Temporal 时出错,或显式的底层显示覆盖丢失
INV11, INV12 方向辅助函数/provider 测试以及渲染后的 RTL 审计 组件布局读取的是 provider 方向而不是区域方向,provider 修改 DOM,或覆盖项不再组合
INV17 typeaheadMatch.test.ts、useTypeahead 和 useTreeFocus 测试,以及 Selector、MultiSelector、DropdownMenu 和 TreeList 中的键入选择测试,每个各有一个用例:组合附加符号(“a”命中“Ánh”);每个带划线的字母(đ、ł、ø、ħ、ŧ、ƀ);ı 和 İ(“i”和“ı”命中“Isparta”和“İzmir”);以及键入的变音符号、带划线的字母、ı 或 İ 会优先精确匹配(“đ”先于“Dung”命中“Đào”,“ı”先于“İzmir”命中“Isparta”,“İ”先于“Isparta”命中“İzmir”);在 en、vi、pl、sv 和 tr 提供程序下 在任何区域设置中,普通字母无法命中带附加符号或划线的首字母;i 或 ı 无法命中 İ 或 I 标签;键入的变音符号、带划线的字母、ı 或 İ 没有优先精确匹配;ı 或 İ 以非土耳其语的方式进行大小写配对;两条路径结果不一致;或折叠影响排序或显示文本

本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 as/astryx