niuma-ui 2.0.0 → 2.0.2

package/dist/icons/brand.js

@@ -0,0 +1,26 @@
+//#region src/icons/brand.ts
+/** 内置品牌 mark（工作台数据源）。Lucide 线标不在此列。 */
+var rsBrandIconNames = [
+	"ftp",
+	"redis",
+	"mongodb",
+	"vastbase",
+	"mysql",
+	"sqlite",
+	"dameng",
+	"oracle",
+	"clickhouse",
+	"kingbase",
+	"sqlserver",
+	"postgres"
+];
+var brandIconNameSet = new Set(rsBrandIconNames);
+function isRsBrandIconName(name) {
+	return brandIconNameSet.has(name);
+}
+/** 品牌 mark 填充色变量，如 `--rs-icon-mysql-accent`。 */
+function rsBrandIconAccentVar(name) {
+	return `--rs-icon-${name}-accent`;
+}
+//#endregion
+export { isRsBrandIconName, rsBrandIconAccentVar, rsBrandIconNames };

package/dist/icons/registry.d.ts

@@ -1,3 +1,5 @@
 export { LUCIDE_ATTRIBUTION, LUCIDE_LICENSE, isRsIconName, lucideIconCount, resolveLucideIcon, } from './lucide';
+export { isRsBrandIconName, rsBrandIconAccentVar, rsBrandIconNames, } from './brand';
+export type { RsBrandIconName } from './brand';
 /** Playground / 文档常用图标（Lucide 全库约 1600+；kebab-case，如 `house`、`trash-2`） */
 export declare const rsCommonIconNames: readonly ["house", "settings", "user", "search", "plus", "x", "check", "message-square", "folder", "chevron-right", "chevron-down", "loader", "trash-2", "pencil", "bell", "cloud", "download", "upload", "link", "copy", "external-link", "layout-dashboard", "credit-card", "shield-check"];

package/dist/icons/registry.js

@@ -1,4 +1,5 @@
 import { LUCIDE_ATTRIBUTION, LUCIDE_LICENSE, isRsIconName, lucideIconCount, resolveLucideIcon } from "./lucide.js";
+import { isRsBrandIconName, rsBrandIconAccentVar, rsBrandIconNames } from "./brand.js";
 //#region src/icons/registry.ts
 /** Playground / 文档常用图标（Lucide 全库约 1600+；kebab-case，如 `house`、`trash-2`） */
 var rsCommonIconNames = [
@@ -28,4 +29,4 @@ var rsCommonIconNames = [
 	"shield-check"
 ];
 //#endregion
-export { LUCIDE_ATTRIBUTION, LUCIDE_LICENSE, isRsIconName, lucideIconCount, resolveLucideIcon, rsCommonIconNames };
+export { LUCIDE_ATTRIBUTION, LUCIDE_LICENSE, isRsBrandIconName, isRsIconName, lucideIconCount, resolveLucideIcon, rsBrandIconAccentVar, rsBrandIconNames, rsCommonIconNames };

package/dist/index.d.ts

@@ -214,13 +214,17 @@ export { useRsI18n, createTranslator } from './composables/useRsI18n';
 export type { RsTranslateFn } from './composables/useRsI18n';
 export { useRsToast } from './composables/useRsToast';
 export type { RsToastInput } from './composables/useRsToast';
-export { rsCommonIconNames, LUCIDE_ATTRIBUTION, LUCIDE_LICENSE, lucideIconCount, isRsIconName, } from './icons/registry';
-export type { RsThemeMode, RsThemeTokens, RsComponentSize, RsRadius, RsFontSize, RsFontWeight, } from './theme/types';
+export { rsCommonIconNames, rsBrandIconNames, rsBrandIconAccentVar, LUCIDE_ATTRIBUTION, LUCIDE_LICENSE, lucideIconCount, isRsIconName, isRsBrandIconName, } from './icons/registry';
+export type { RsBrandIconName } from './icons/registry';
+export type { RsThemeMode, RsResolvedTheme, RsThemeTokens, RsComponentSize, RsRadius, RsFontSize, RsFontWeight, } from './theme/types';
 export { RS_COMPONENT_SIZES, RS_COMPONENT_SIZE_ICON_PX, RS_RADII, RS_RADIUS_CSS, RS_FONT_SIZES, RS_FONT_SIZE_CSS, RS_FONT_WEIGHTS, RS_FONT_WEIGHT_CSS, } from './theme/types';
-export type { RsLocale } from './locale/types';
+export type { RsBuiltinLocale, RsDirMode, RsLocale, RsLocaleMessages, RsTextDirection, } from './locale/types';
+export { defaultLocale, fallbackLocale } from './locale/types';
+export { rsLocaleMessageKeys } from './locale/messages';
+export { applyLocale, inferRsLocaleDir, isRsLocaleRegistered, listRsLocales, registerRsLocale, resolveDirMode, resolveHostLocale, resolveRsLocaleDir, resolveRsMessage, } from './locale/registry-public';
 export { useRsConfig, useRsConfigOptional, createRsConfigState } from './composables/useRsConfig';
 export { useResolvedRsComponentSize, resolveRsComponentSize } from './components/_shared';
 export { useResolvedRsRadius, rsRadiusCss } from './components/_shared';
 export { themePresets } from './theme/presets';
-export { applyTheme } from './theme/apply';
+export { applyTheme, prefersColorSchemeDark, readResolvedTheme, resolveThemeMode, subscribePreferredColorScheme, } from './theme/apply';
 export { parseCssLengthToPx, readCodeFontFamily, readCodeFontSizePx, readCssLengthPx, readCssVar, readRootFontSizePx, readTerminalFontFamily, readTerminalFontSizePx, readTerminalFontWeight, readTerminalFontWeightBold, } from './theme/css-token';

package/dist/index.js

@@ -129,6 +129,7 @@ export { default as RsVirtualList } from './components/virtual-list/src/RsVirtua
 export { TIME_HOUR_OPTIONS } from './components/time-picker/src/time-picker-utils.js'
 export { TIME_SECOND_OPTIONS } from './components/time-picker/src/time-picker-utils.js'
 export { aggregateColumnSummary } from './components/table/src/utils/table-summary-utils.js'
+export { applyLocale } from './locale/apply.js'
 export { applyMonacoDebugDecorations } from './monaco/debug-decorations2.js'
 export { applySplitResize } from './components/split-pane/src/split-pane-utils.js'
 export { applyTheme } from './theme/apply.js'
@@ -182,11 +183,13 @@ export { createRsTableViewContext } from './components/table/src/context/rs-tabl
 export { createToolbarTableFeature } from './components/table/src/features/table-features.js'
 export { createTranslator } from './composables/useRsI18n.js'
 export { createUploadFileFromContent } from './components/upload/src/upload-utils.js'
+export { defaultLocale } from './locale/types.js'
 export { defaultTreeFilterNode } from './components/tree/src/tree-utils.js'
 export { downloadUploadFile } from './components/upload/src/upload-utils.js'
 export { ensureMongodbShellLanguage } from './monaco/languages/mongodb-shell.js'
 export { escapeHtml } from './components/markdown/src/markdown-utils.js'
 export { expandSplitPane } from './components/split-pane/src/split-pane-utils.js'
+export { fallbackLocale } from './locale/types.js'
 export { filterLogLines } from './components/log/src/log-utils.js'
 export { filterTableRows } from './components/table/src/utils/table-utils.js'
 export { filterTableTreeRows } from './components/table/src/utils/table-utils.js'
@@ -239,6 +242,7 @@ export { hasTableTreeChildren } from './components/table/src/utils/table-utils.j
 export { hasTreeChildren } from './components/tree/src/tree-utils.js'
 export { hrefToAnchorId } from './components/anchor/src/anchor-utils.js'
 export { inferLogLevel } from './components/log/src/log-utils.js'
+export { inferRsLocaleDir } from './locale/registry.js'
 export { injectExpandRows } from './components/table/src/utils/table-utils.js'
 export { inputRuleMessageKeys } from './components/input/src/input-rules.js'
 export { isCodeMirrorLightTheme } from './components/code-editor/src/code-mirror-lang.js'
@@ -250,10 +254,12 @@ export { isIndexSegment } from './components/form/src/form-path.js'
 export { isNearScrollBottom } from './components/table/src/utils/table-utils.js'
 export { isNullDraft } from './components/table/src/utils/table-edit-utils.js'
 export { isNumberInputInterim } from './components/input-number/src/input-number-utils.js'
+export { isRsBrandIconName } from './icons/brand.js'
 export { isRsButtonFilledVariant } from './components/button/src/button-utils.js'
 export { isRsDialogWidthPreset } from './components/dialog/src/dialog-utils.js'
 export { isRsFormItemBoundControl } from './components/form/src/form-utils.js'
 export { isRsIconName } from './icons/lucide.js'
+export { isRsLocaleRegistered } from './locale/registry.js'
 export { isRsLogLevel } from './components/log/src/log-utils.js'
 export { isRsSplitPaneAutoSize } from './components/split-pane/src/split-pane-utils.js'
 export { isRsTableApi } from './components/table/src/rs-table-api.js'
@@ -273,6 +279,7 @@ export { isTreeAncestorKey } from './components/tree/src/tree-utils.js'
 export { joinLogLines } from './components/log/src/log-utils.js'
 export { listBatchColumnTargets } from './components/table/src/utils/table-edit-utils.js'
 export { listEditableCells } from './components/table/src/utils/table-edit-utils.js'
+export { listRsLocales } from './locale/registry.js'
 export { looksLikeIsoDateTimeWithTz } from './utils/iso-local-datetime.js'
 export { lucideIconCount } from './icons/lucide.js'
 export { mapRsTableSeriesToEChartsOption } from './components/table/src/utils/rs-table-echarts-adapter.js'
@@ -305,6 +312,7 @@ export { parseRsLogLevel } from './components/log/src/log-utils.js'
 export { parseTimeValue } from './components/time-picker/src/time-picker-utils.js'
 export { pickActiveAnchorHref } from './components/anchor/src/anchor-utils.js'
 export { placeAnchoredPopup } from './components/_shared/src/overlay-utils.js'
+export { prefersColorSchemeDark } from './theme/apply.js'
 export { prefetchClipboardText } from './utils/rs-clipboard.js'
 export { prewarmCodeMirrorEditor } from './components/code-editor/src/code-mirror-lang.js'
 export { provideRsFormItemContext } from './components/form/src/form-utils.js'
@@ -316,12 +324,14 @@ export { readCodeFontSizePx } from './theme/css-token.js'
 export { readCssLengthPx } from './theme/css-token.js'
 export { readCssVar } from './theme/css-token.js'
 export { readDocumentTheme } from './components/code-editor/src/code-editor-utils.js'
+export { readResolvedTheme } from './theme/apply.js'
 export { readRootFontSizePx } from './theme/css-token.js'
 export { readTerminalFontFamily } from './theme/css-token.js'
 export { readTerminalFontSizePx } from './theme/css-token.js'
 export { readTerminalFontWeight } from './theme/css-token.js'
 export { readTerminalFontWeightBold } from './theme/css-token.js'
 export { readTerminalThemeFromCss } from './components/terminal/src/terminal-utils.js'
+export { registerRsLocale } from './locale/registry.js'
 export { removeUploadFileAt } from './components/upload/src/upload-utils.js'
 export { renderMarkdown } from './components/markdown/src/markdown-utils.js'
 export { renderMarkdownInline } from './components/markdown/src/markdown-utils.js'
@@ -336,11 +346,13 @@ export { resolveCodeEditorTheme } from './components/code-editor/src/code-editor
 export { resolveCodeMirrorLanguage } from './components/code-editor/src/code-mirror-lang.js'
 export { resolveColumnOrder } from './components/table/src/utils/table-utils.js'
 export { resolveDialogOverlayStyle } from './components/dialog/src/dialog-utils.js'
+export { resolveDirMode } from './locale/apply.js'
 export { resolveDrawerOverlayStyle } from './components/drawer/src/drawer-utils.js'
 export { resolveEntryKey } from './components/table/src/utils/table-utils.js'
 export { resolveFieldRules } from './components/form/src/form-utils.js'
 export { resolveFixedColumnStyles } from './components/table/src/utils/table-utils.js'
 export { resolveGridNavDirection } from './components/table/src/utils/rs-table-grid-nav.js'
+export { resolveHostLocale } from './locale/resolve-host.js'
 export { resolveInstanceFeatures } from './components/table/src/context/rs-table-module-registry.js'
 export { resolveItemSize } from './components/virtual-list/src/virtual-list-utils.js'
 export { resolveLogCopyText } from './components/log/src/log-utils.js'
@@ -358,6 +370,8 @@ export { resolveRsDialogWidthPx } from './components/dialog/src/dialog-utils.js'
 export { resolveRsDrawerDimensionCss } from './components/drawer/src/drawer-utils.js'
 export { resolveRsDrawerSizeCss } from './components/drawer/src/drawer-utils.js'
 export { resolveRsDrawerSizePx } from './components/drawer/src/drawer-utils.js'
+export { resolveRsLocaleDir } from './locale/registry.js'
+export { resolveRsMessage } from './locale/registry.js'
 export { resolveRuleMessage } from './components/form/src/form-rules.js'
 export { resolveSelectAllState } from './components/table/src/utils/table-utils.js'
 export { resolveSelectableRowKeys } from './components/table/src/utils/table-utils.js'
@@ -371,6 +385,7 @@ export { resolveTableTreeRowKey } from './components/table/src/utils/table-utils
 export { resolveTableVirtualEnabled } from './components/table/src/utils/table-utils.js'
 export { resolveTabsToClose } from './components/tabs/src/tabs-utils.js'
 export { resolveTerminalTheme } from './components/terminal/src/terminal-utils.js'
+export { resolveThemeMode } from './theme/apply.js'
 export { resolveTreeCheckState } from './components/tree/src/tree-utils.js'
 export { resolveTreeFieldNames } from './components/tree/src/tree-utils.js'
 export { resolveTreeFocusKey } from './components/tree/src/tree-utils.js'
@@ -382,9 +397,12 @@ export { resolveVirtualListHeight } from './components/virtual-list/src/virtual-
 export { resolveVisibleTabValues } from './components/tabs/src/tabs-utils.js'
 export { restoreSelectValue } from './components/select/src/select-utils.js'
 export { roundToPrecision } from './components/input-number/src/input-number-utils.js'
+export { rsBrandIconAccentVar } from './icons/brand.js'
+export { rsBrandIconNames } from './icons/brand.js'
 export { rsCommonIconNames } from './icons/registry.js'
 export { rsConfirm } from './composables/createRsDialog.js'
 export { rsFeedbackIconClass } from './components/_shared/src/overlay-utils.js'
+export { rsLocaleMessageKeys } from './locale/messages.js'
 export { rsRadiusCss } from './components/_shared/src/resolve-radius.js'
 export { rsToastPositions } from './components/_shared/src/overlay-utils.js'
 export { runFormFieldRules } from './components/form/src/form-rules.js'
@@ -411,6 +429,7 @@ export { splitSizesEqual } from './components/split-pane/src/split-pane-utils.js
 export { splitTreeLabelHighlight } from './components/tree/src/tree-utils.js'
 export { stepEnabledIndex } from './components/_shared/src/overlay-utils.js'
 export { stepNumberValue } from './components/input-number/src/input-number-utils.js'
+export { subscribePreferredColorScheme } from './theme/apply.js'
 export { supportsRsButtonTone } from './components/button/src/button-utils.js'
 export { syslogSeverityOf } from './components/log/src/log-utils.js'
 export { terminalShortcutLabel } from './components/terminal/src/terminal-utils.js'

package/dist/locale/apply.d.ts

@@ -0,0 +1,8 @@
+import { type RsDirMode, type RsLocale, type RsTextDirection } from './types';
+export declare function resolveDirMode(mode: RsDirMode, locale: RsLocale): RsTextDirection;
+/**
+ * 写入语言与书写方向。色值不在这里。
+ * `dir` 同时写元素的 HTML `dir` 与 `data-rs-dir`，Portal 跟 document 时才能翻。
+ */
+export declare function applyLocale(locale: RsLocale, dir?: RsDirMode, el?: HTMLElement): void;
+export declare function readDocumentLocale(el?: HTMLElement | null): RsLocale;

package/dist/locale/apply.js

@@ -0,0 +1,20 @@
+import { dirAttribute, localeAttribute } from "./types.js";
+import { resolveRsLocaleDir } from "./registry.js";
+//#region src/locale/apply.ts
+function resolveDirMode(mode, locale) {
+	if (mode === "ltr" || mode === "rtl") return mode;
+	return resolveRsLocaleDir(locale);
+}
+/**
+* 写入语言与书写方向。色值不在这里。
+* `dir` 同时写元素的 HTML `dir` 与 `data-rs-dir`，Portal 跟 document 时才能翻。
+*/
+function applyLocale(locale, dir = "auto", el = document.documentElement) {
+	const resolvedDir = resolveDirMode(dir, locale);
+	el.setAttribute(localeAttribute, locale);
+	el.setAttribute("lang", locale);
+	el.setAttribute("dir", resolvedDir);
+	el.setAttribute(dirAttribute, resolvedDir);
+}
+//#endregion
+export { applyLocale, resolveDirMode };

package/dist/locale/interpolate.d.ts

@@ -1,10 +1,11 @@
 export type RsI18nVars = Record<string, string | number>;
 export type RsTranslateFn = (key: string, fallbackOrVars?: string | RsI18nVars, vars?: RsI18nVars) => string;
 /**
- * 将文案中的 `{name}` 替换为 vars。
- * 对标 Ant Design / vue-i18n 的命名插值。
+ * 插值：`{name}` 换成 vars。
+ * 复数（ICU 子集）：`{count, plural, one {# item} other {# items}}`，
+ * 可用 `=0` / `=1`。`#` 换成数字。类别由 `Intl.PluralRules(locale)` 决定。
  */
-export declare function interpolateRsMessage(template: string, vars?: RsI18nVars): string;
+export declare function interpolateRsMessage(template: string, vars?: RsI18nVars, locale?: string): string;
 /**
  * 解析 t() 的第 2、3 参：既兼容 `t(key, fallback)`，也支持 `t(key, vars)`。
  */

package/dist/locale/interpolate.js

@@ -1,15 +1,118 @@
 //#region src/locale/interpolate.ts
+var PLURAL_HEAD = /^\{(\w+),\s*plural\s*,/;
 /**
-* 将文案中的 `{name}` 替换为 vars。
-* 对标 Ant Design / vue-i18n 的命名插值。
+* 插值：`{name}` 换成 vars。
+* 复数（ICU 子集）：`{count, plural, one {# item} other {# items}}`，
+* 可用 `=0` / `=1`。`#` 换成数字。类别由 `Intl.PluralRules(locale)` 决定。
 */
-function interpolateRsMessage(template, vars) {
-	if (!vars) return template;
-	return template.replace(/\{(\w+)\}/g, (matched, key) => {
+function interpolateRsMessage(template, vars, locale = "en-US") {
+	const withPlural = expandPluralBlocks(template, vars, locale);
+	if (!vars) return withPlural;
+	return withPlural.replace(/\{(\w+)\}/g, (matched, key) => {
 		const value = vars[key];
 		return value == null ? matched : String(value);
 	});
 }
+function expandPluralBlocks(template, vars, locale) {
+	let i = 0;
+	let out = "";
+	while (i < template.length) {
+		if (template[i] !== "{") {
+			out += template[i];
+			i += 1;
+			continue;
+		}
+		const parsed = parsePluralBlock(template, i);
+		if (!parsed) {
+			const end = template.indexOf("}", i);
+			if (end === -1) {
+				out += template.slice(i);
+				break;
+			}
+			out += template.slice(i, end + 1);
+			i = end + 1;
+			continue;
+		}
+		const raw = vars?.[parsed.name];
+		const n = typeof raw === "number" ? raw : Number(raw);
+		const clause = pickPluralClause(locale, n, parsed.clauses);
+		const numeral = Number.isFinite(n) ? String(n) : raw == null ? "" : String(raw);
+		out += clause.replace(/#/g, numeral);
+		i = parsed.end;
+	}
+	return out;
+}
+function parsePluralBlock(source, start) {
+	const head = PLURAL_HEAD.exec(source.slice(start));
+	if (!head) return null;
+	let i = start + head[0].length;
+	const clauses = /* @__PURE__ */ new Map();
+	while (i < source.length) {
+		while (source[i] === " " || source[i] === "\n" || source[i] === "	") i += 1;
+		if (source[i] === "}") return {
+			name: head[1],
+			clauses,
+			end: i + 1
+		};
+		let selector = "";
+		if (source[i] === "=") {
+			let j = i + 1;
+			while (j < source.length && source[j] >= "0" && source[j] <= "9") j += 1;
+			selector = source.slice(i, j);
+			i = j;
+		} else {
+			let j = i;
+			while (j < source.length && source[j] >= "a" && source[j] <= "z") j += 1;
+			selector = source.slice(i, j);
+			i = j;
+		}
+		if (!selector) return null;
+		while (source[i] === " " || source[i] === "	") i += 1;
+		if (source[i] !== "{") return null;
+		const inner = readBalanced(source, i);
+		if (!inner) return null;
+		clauses.set(selector, inner.text);
+		i = inner.end;
+	}
+	return null;
+}
+function readBalanced(source, open) {
+	if (source[open] !== "{") return null;
+	let depth = 0;
+	for (let i = open; i < source.length; i += 1) if (source[i] === "{") depth += 1;
+	else if (source[i] === "}") {
+		depth -= 1;
+		if (depth === 0) return {
+			text: source.slice(open + 1, i),
+			end: i + 1
+		};
+	}
+	return null;
+}
+var pluralRulesByLocale = /* @__PURE__ */ new Map();
+function pluralRulesFor(locale) {
+	const cached = pluralRulesByLocale.get(locale);
+	if (cached) return cached;
+	try {
+		const rules = new Intl.PluralRules(locale);
+		pluralRulesByLocale.set(locale, rules);
+		return rules;
+	} catch {
+		return;
+	}
+}
+function pickPluralClause(locale, n, clauses) {
+	if (Number.isFinite(n)) {
+		const exact = clauses.get(`=${n}`);
+		if (exact != null) return exact;
+		const category = pluralRulesFor(locale)?.select(n);
+		if (category) {
+			const matched = clauses.get(category);
+			if (matched != null) return matched;
+		}
+	}
+	return clauses.get("other") ?? "";
+}
 /**
 * 解析 t() 的第 2、3 参：既兼容 `t(key, fallback)`，也支持 `t(key, vars)`。
 */

package/dist/locale/messages.d.ts

@@ -1,7 +1,5 @@
 import type { RsLocaleMessages } from './types';
 export declare const zhCN: RsLocaleMessages;
 export declare const enUS: RsLocaleMessages;
-export declare const localeMap: {
-    readonly 'zh-CN': RsLocaleMessages;
-    readonly 'en-US': RsLocaleMessages;
-};
+/** 社区语言包应对齐的 key 清单（与 en-US 表相同）。 */
+export declare const rsLocaleMessageKeys: string[];

package/dist/locale/messages.js

@@ -70,7 +70,7 @@ var zhCN = {
 	"pagination.prev": "上一页",
 	"pagination.next": "下一页",
 	"pagination.page": "页",
-	"pagination.summary": "共 {total} 条",
+	"pagination.summary": "{total, plural, other {共 # 条}}",
 	"pagination.jumpTo": "跳至",
 	"pagination.jumpPageSuffix": "页",
 	"pagination.jumpConfirm": "确定",
@@ -167,7 +167,7 @@ var zhCN = {
 	"log.copied": "已复制",
 	"log.copyFailed": "复制失败，请用 HTTPS 或手动选择正文",
 	"log.filter": "按级别过滤",
-	"log.newLines": "新增 {count} 行",
+	"log.newLines": "{count, plural, other {新增 # 行}}",
 	"log.lineNo": "第 {n} 行",
 	"log.level.trace": "跟踪",
 	"log.level.debug": "调试",
@@ -303,7 +303,7 @@ var enUS = {
 	"pagination.prev": "Previous",
 	"pagination.next": "Next",
 	"pagination.page": "page",
-	"pagination.summary": "Total {total} items",
+	"pagination.summary": "{total, plural, one {# item} other {# items}}",
 	"pagination.jumpTo": "Go to",
 	"pagination.jumpPageSuffix": "page",
 	"pagination.jumpConfirm": "Go",
@@ -400,7 +400,7 @@ var enUS = {
 	"log.copied": "Copied",
 	"log.copyFailed": "Copy failed. Use HTTPS or select the log text.",
 	"log.filter": "Filter levels",
-	"log.newLines": "{count} new lines",
+	"log.newLines": "{count, plural, one {# new line} other {# new lines}}",
 	"log.lineNo": "Line {n}",
 	"log.level.trace": "Trace",
 	"log.level.debug": "Debug",
@@ -465,9 +465,7 @@ var enUS = {
 	"markdown.placeholder": "Markdown supported (headings, lists, links, code…)",
 	"markdown.empty": "Nothing to preview"
 };
-var localeMap = {
-	"zh-CN": zhCN,
-	"en-US": enUS
-};
+/** 社区语言包应对齐的 key 清单（与 en-US 表相同）。 */
+var rsLocaleMessageKeys = Object.keys(enUS);
 //#endregion
-export { enUS, localeMap, zhCN };
+export { enUS, rsLocaleMessageKeys, zhCN };

package/dist/locale/registry-public.d.ts

@@ -0,0 +1,3 @@
+export { applyLocale, readDocumentLocale, resolveDirMode } from './apply';
+export { resolveHostLocale } from './resolve-host';
+export { inferRsLocaleDir, isRsLocaleRegistered, listRsLocales, registerRsLocale, resolveRsLocaleDir, resolveRsLocalePack, resolveRsMessage, } from './registry';

package/dist/locale/registry.d.ts

@@ -0,0 +1,19 @@
+import { type RsLocale, type RsLocaleMessages, type RsTextDirection } from './types';
+export interface RsLocalePack {
+    messages: RsLocaleMessages;
+    dir: RsTextDirection;
+}
+export declare function inferRsLocaleDir(code: string): RsTextDirection;
+/**
+ * 登记或合并一种语言。第二次调用同码会覆盖已给的 key，并保留未改的 dir（除非这次传了 dir）。
+ * 内置 `zh-CN` / `en-US` 启动时已登记；第三方只调这一次即可被 `RsConfigProvider.locale` 使用。
+ */
+export declare function registerRsLocale(code: RsLocale, messages: RsLocaleMessages, options?: {
+    dir?: RsTextDirection;
+}): void;
+export declare function isRsLocaleRegistered(code: string): boolean;
+export declare function listRsLocales(): string[];
+export declare function resolveRsLocalePack(code: string): RsLocalePack;
+export declare function resolveRsLocaleDir(code: string): RsTextDirection;
+/** 缺 key：当前语言 → en-US → zh-CN。 */
+export declare function resolveRsMessage(code: string, key: string): string | undefined;

package/dist/locale/registry.js

@@ -0,0 +1,50 @@
+import { enUS, zhCN } from "./messages.js";
+import "./types.js";
+//#region src/locale/registry.ts
+var packs = /* @__PURE__ */ new Map();
+var RTL_LANG = /* @__PURE__ */ new Set([
+	"ar",
+	"he",
+	"fa",
+	"ur",
+	"ps",
+	"sd",
+	"yi"
+]);
+function inferRsLocaleDir(code) {
+	const base = code.trim().split(/[-_]/)[0]?.toLowerCase() ?? "";
+	return RTL_LANG.has(base) ? "rtl" : "ltr";
+}
+/**
+* 登记或合并一种语言。第二次调用同码会覆盖已给的 key，并保留未改的 dir（除非这次传了 dir）。
+* 内置 `zh-CN` / `en-US` 启动时已登记；第三方只调这一次即可被 `RsConfigProvider.locale` 使用。
+*/
+function registerRsLocale(code, messages, options) {
+	const id = code.trim();
+	if (!id) throw new Error("registerRsLocale: code is required");
+	const prev = packs.get(id);
+	packs.set(id, {
+		messages: prev ? {
+			...prev.messages,
+			...messages
+		} : { ...messages },
+		dir: options?.dir ?? prev?.dir ?? inferRsLocaleDir(id)
+	});
+}
+function isRsLocaleRegistered(code) {
+	return packs.has(code);
+}
+function listRsLocales() {
+	return [...packs.keys()];
+}
+function resolveRsLocaleDir(code) {
+	return packs.get(code)?.dir ?? inferRsLocaleDir(code);
+}
+/** 缺 key：当前语言 → en-US → zh-CN。 */
+function resolveRsMessage(code, key) {
+	return packs.get(code)?.messages[key] ?? packs.get("en-US")?.messages[key] ?? packs.get("zh-CN")?.messages[key];
+}
+registerRsLocale("zh-CN", zhCN, { dir: "ltr" });
+registerRsLocale("en-US", enUS, { dir: "ltr" });
+//#endregion
+export { inferRsLocaleDir, isRsLocaleRegistered, listRsLocales, registerRsLocale, resolveRsLocaleDir, resolveRsMessage };

package/dist/locale/resolve-host.d.ts

@@ -0,0 +1,7 @@
+import { type RsLocale } from './types';
+/**
+ * 未设 locale 时按本机语言选已登记的包。
+ * `zh*` → zh-CN，`en*` → en-US，其它按已登记码的语言前缀匹配。
+ * 没有 navigator（SSR）或无法识别时回退 `defaultLocale`（zh-CN）。
+ */
+export declare function resolveHostLocale(): RsLocale;

package/dist/locale/resolve-host.js

@@ -0,0 +1,46 @@
+import { defaultLocale } from "./types.js";
+import { isRsLocaleRegistered, listRsLocales } from "./registry.js";
+//#region src/locale/resolve-host.ts
+/**
+* 未设 locale 时按本机语言选已登记的包。
+* `zh*` → zh-CN，`en*` → en-US，其它按已登记码的语言前缀匹配。
+* 没有 navigator（SSR）或无法识别时回退 `defaultLocale`（zh-CN）。
+*/
+function resolveHostLocale() {
+	for (const tag of readHostLanguageTags()) {
+		const matched = matchRegisteredLocale(tag);
+		if (matched) return matched;
+	}
+	return defaultLocale;
+}
+function readHostLanguageTags() {
+	const tags = [];
+	if (typeof navigator !== "undefined") {
+		if (Array.isArray(navigator.languages)) tags.push(...navigator.languages);
+		if (navigator.language) tags.push(navigator.language);
+	}
+	const seen = /* @__PURE__ */ new Set();
+	const unique = [];
+	for (const tag of tags) {
+		const normalized = tag.trim();
+		if (!normalized) continue;
+		const key = normalized.toLowerCase();
+		if (seen.has(key)) continue;
+		seen.add(key);
+		unique.push(normalized);
+	}
+	return unique;
+}
+function matchRegisteredLocale(tag) {
+	const normalized = tag.trim().replace(/_/g, "-");
+	if (!normalized) return void 0;
+	if (isRsLocaleRegistered(normalized)) return normalized;
+	const lower = normalized.toLowerCase();
+	for (const code of listRsLocales()) if (code.toLowerCase() === lower) return code;
+	const base = lower.split("-")[0] ?? "";
+	if (base === "zh" && isRsLocaleRegistered("zh-CN")) return "zh-CN";
+	if (base === "en" && isRsLocaleRegistered("en-US")) return "en-US";
+	for (const code of listRsLocales()) if (code.toLowerCase().split(/[-_]/)[0] === base) return code;
+}
+//#endregion
+export { resolveHostLocale };

package/dist/locale/types.d.ts

@@ -1,3 +1,14 @@
-export type RsLocale = 'zh-CN' | 'en-US';
+/** 内置语言。第三方用 `registerRsLocale` 加 BCP-47 码。 */
+export type RsBuiltinLocale = 'zh-CN' | 'en-US';
+/** BCP-47。内置码可自动补全；注册后的任意码也合法。 */
+export type RsLocale = RsBuiltinLocale | (string & {});
 export type RsLocaleMessages = Record<string, string>;
-export declare const defaultLocale: RsLocale;
+export type RsTextDirection = 'ltr' | 'rtl';
+/** 书写方向：auto 跟当前 locale 的 dir。 */
+export type RsDirMode = RsTextDirection | 'auto';
+/** 无法从本机语言识别时的回退。当前用户以中文为主，回退 zh-CN。 */
+export declare const defaultLocale: RsBuiltinLocale;
+/** 缺 key 时先回退到该语言，再回退 zh-CN。 */
+export declare const fallbackLocale: RsBuiltinLocale;
+export declare const localeAttribute = "data-rs-locale";
+export declare const dirAttribute = "data-rs-dir";

package/dist/locale/types.js

@@ -1,4 +1,9 @@
 //#region src/locale/types.ts
+/** 无法从本机语言识别时的回退。当前用户以中文为主，回退 zh-CN。 */
 var defaultLocale = "zh-CN";
+/** 缺 key 时先回退到该语言，再回退 zh-CN。 */
+var fallbackLocale = "en-US";
+var localeAttribute = "data-rs-locale";
+var dirAttribute = "data-rs-dir";
 //#endregion
-export { defaultLocale };
+export { defaultLocale, dirAttribute, fallbackLocale, localeAttribute };