Semantic tokens and fail-closed copy vocabulary for local internal-alpha proof.
State vocabulary
Ready for local useLocal proof onlyFixture onlyExternal proof neededProof requiredBlockedNot claimedUnknown
Fail-closed presentation
Unknown
State is unknown or unsupported and is displayed fail-closed.
External proof needed
A route outside this package must provide external proof before reliance.
I18n and theme contract
Required locales and dark theme token override for local contract proof.
I18n standard
Default locale en; fallback locale en; raw enum labels are blocked before UI display.
简体中文Simplified Chinesezh-CN未声明
EnglishEnglishenNot claimed
日本語Japaneseja未主張
한국어Koreanko주장하지 않음
FrançaisFrenchfrNon revendiqué
Supported locales: zh-CN, en, ja, ko, fr.
Dark theme preview
Dark mode is a token override, not a separate component fork.
Proof required
Proof required
External, product, or release evidence is still required.
Docs shell control contract
The Storybook documentation shell keeps global controls compact so they do not crowd search, current-location readback, or navigation.
ControlRuleBlocked
Theme toggleUse one circular icon-only button that reflects the current light or dark mode and toggles only on explicit activation.Two-option segmented theme controls or large theme panels in the global bar.
Theme transitionTheme changes use one whole-page transition: root View Transition when available, or one full-page fallback wash.Per-section darkening where sidebar, header, and content animate independently.
Language selectorUse a globe trigger plus the current locale name in that locale; menu options use native names only.Long bilingual labels such as Simplified Chinese / English in the compact control.
SearchKeep search compact at rest, expand smoothly on focus, and collapse on blur while preserving the shortcut label only for shell search.Fixed long search fields that permanently crowd the theme and language controls.
AI contractExpose the AI contract through the Proof story and static JSON artifact, not as a top-bar human navigation item.Putting machine-contract JSON links in the primary human toolbar.
Copy guidelines
State copy rules for no-overclaim UI and localized product-facing text.
Allowed language
RuleExampleReason
Use human labelsExternal proof neededReadable and localizable
Name the proof scopeLocal proof onlyPrevents downstream overclaim
