ensis-ui 0.0.0-stage → 3.0.0

package/dist/theme/apply.d.ts

@@ -0,0 +1,18 @@
+import { type RsResolvedTheme, type RsThemeMode } from './types';
+/** 系统是否偏好暗色。无 window 时视为浅色（与 :root 默认一致）。 */
+export declare function prefersColorSchemeDark(): boolean;
+/** 把偏好解析成 light / dark。色值仍只认 CSS，不读 themePresets。 */
+export declare function resolveThemeMode(mode: RsThemeMode): RsResolvedTheme;
+/**
+ * 读已落到元素上的明暗。无属性或无法识别时按 light，
+ * 与 styles.css 的 `:root` 默认一致，避免编辑器 / 弹层先闪暗色。
+ */
+export declare function readResolvedTheme(el?: HTMLElement | null): RsResolvedTheme;
+/**
+ * 切换主题：只写属性。
+ * `system` 解析后写 `data-rs-theme="light|dark"`，另标 `data-rs-theme-pref="system"`。
+ * 组件选择器继续认 light / dark，不必为 system 再复制一套。
+ */
+export declare function applyTheme(mode: RsThemeMode, el?: HTMLElement): void;
+/** 系统明暗变化时回调；返回取消订阅。 */
+export declare function subscribePreferredColorScheme(onChange: () => void): () => void;

package/dist/theme/apply.js

@@ -0,0 +1,47 @@
+import { themeAttribute, themePrefAttribute } from "./types.js";
+//#region src/theme/apply.ts
+function matchPrefersColorSchemeDark() {
+	if (typeof window === "undefined" || typeof window.matchMedia !== "function") return null;
+	return window.matchMedia("(prefers-color-scheme: dark)");
+}
+/** 系统是否偏好暗色。无 window 时视为浅色（与 :root 默认一致）。 */
+function prefersColorSchemeDark() {
+	return matchPrefersColorSchemeDark()?.matches === true;
+}
+/** 把偏好解析成 light / dark。色值仍只认 CSS，不读 themePresets。 */
+function resolveThemeMode(mode) {
+	if (mode === "light" || mode === "dark") return mode;
+	return prefersColorSchemeDark() ? "dark" : "light";
+}
+/**
+* 读已落到元素上的明暗。无属性或无法识别时按 light，
+* 与 styles.css 的 `:root` 默认一致，避免编辑器 / 弹层先闪暗色。
+*/
+function readResolvedTheme(el) {
+	if (typeof document === "undefined") return "light";
+	const raw = (el ?? document.documentElement).getAttribute(themeAttribute);
+	if (raw === "light" || raw === "dark") return raw;
+	if (raw === "system") return resolveThemeMode("system");
+	return "light";
+}
+/**
+* 切换主题：只写属性。
+* `system` 解析后写 `data-rs-theme="light|dark"`，另标 `data-rs-theme-pref="system"`。
+* 组件选择器继续认 light / dark，不必为 system 再复制一套。
+*/
+function applyTheme(mode, el = document.documentElement) {
+	const resolved = resolveThemeMode(mode);
+	el.setAttribute(themeAttribute, resolved);
+	if (mode === "system") el.setAttribute(themePrefAttribute, "system");
+	else el.removeAttribute(themePrefAttribute);
+}
+/** 系统明暗变化时回调；返回取消订阅。 */
+function subscribePreferredColorScheme(onChange) {
+	const mq = matchPrefersColorSchemeDark();
+	if (!mq) return () => {};
+	const handler = () => onChange();
+	mq.addEventListener("change", handler);
+	return () => mq.removeEventListener("change", handler);
+}
+//#endregion
+export { applyTheme, prefersColorSchemeDark, readResolvedTheme, resolveThemeMode, subscribePreferredColorScheme };

package/dist/theme/brand.example.css

@@ -0,0 +1,64 @@
+/**
+ * 业务品牌色覆盖示例
+ *
+ * 用法：
+ * 1. 复制到 apps/web/src/theme/brand.css
+ * 2. 在 main.ts 中于 ensis-ui/styles.css 之后 import
+ *
+ * 原理：CSS 变量级联，后加载的同名 --rs-* 覆盖公共 preset
+ *
+ * 可覆盖的常见 token：
+ * - 品牌色：--rs-primary / --rs-primary-hover / --rs-*-container
+ * - 文字语义：--rs-text-primary / --rs-text-secondary / --rs-text-tertiary /
+ *   --rs-text-disabled / --rs-text-link（--rs-text / --rs-muted 只是别名）
+ * - 按钮次要态：--rs-btn-outline-border / --rs-btn-secondary-bg /
+ *   --rs-btn-secondary-bg-hover / --rs-btn-secondary-bg-active
+ * - 排版：--rs-font-sans / --rs-font-mono / --rs-font-serif / --rs-font-size-* / --rs-font-weight-*
+ * - 代码编辑器：--rs-code-font-family / --rs-code-font-size / --rs-code-line-height
+ * - 富文本：--rs-prose-font-family / --rs-prose-font-size / --rs-prose-line-height
+ * - 终端排版：--rs-terminal-font-family / --rs-terminal-font-size / --rs-terminal-font-weight
+ * - 菜单：--rs-menu-item-active-fg|bg|weight、--rs-menu-item-fg、--rs-menu-item-bg-hover、
+ *   --rs-menu-group-label-fg、--rs-menu-arrow-fg、--rs-menu-indent、--rs-menu-flyout-*
+ * - 表单标签：--rs-label-font-size|font-weight|line-height|color|gap|mark-gap|disabled-opacity（RsLabel / .rs-field__label）
+ * - 表格专用：--rs-table-*（色值参考 VS Code Dark/Light Modern）
+ * - 树专用：--rs-tree-*（导航线 / 选中 / 焦点）
+ * - 终端专用：--rs-terminal-*（默认 macOS Terminal.app 风格）
+ * - 线标：--rs-icon-color（Lucide，默认 currentColor）
+ * - 品牌 mark：--rs-icon-mysql-accent 等（名单 rsBrandIconNames）
+ *
+ * 不要改 themePresets.ts 当换肤：那只是参考色板，画面只认本文件与 styles.css。
+ */
+
+[data-rs-theme='light'] {
+  --rs-primary: #6366f1;
+  --rs-primary-hover: #4f46e5;
+  --rs-primary-container: #eef2ff;
+  --rs-on-primary-container: #312e81;
+  /* secondary 轮廓：默认跟输入框；需要更重的线时再覆盖 */
+  --rs-btn-outline-border: #6b7280;
+  --rs-btn-secondary-bg: #f3f4f6;
+  --rs-btn-secondary-bg-hover: #ede9fe;
+  --rs-btn-secondary-bg-active: color-mix(in srgb, #6366f1 16%, #f3f4f6);
+}
+
+[data-rs-theme='dark'] {
+  --rs-primary: #818cf8;
+  --rs-primary-hover: #a5b4fc;
+  --rs-primary-container: #1e1b4b;
+  --rs-on-primary-container: #c7d2fe;
+  --rs-btn-outline-border: #a3a3a3;
+  --rs-btn-secondary-bg: #2e2e2e;
+  --rs-btn-secondary-bg-hover: #3730a3;
+  --rs-btn-secondary-bg-active: color-mix(in srgb, #818cf8 22%, #2e2e2e);
+}
+
+/* 子树隔离：把 data-rs-theme 挂在业务根节点时同样生效 */
+.rs-app-web[data-rs-theme='light'] {
+  --rs-primary: #6366f1;
+  --rs-primary-hover: #4f46e5;
+}
+
+.rs-app-web[data-rs-theme='dark'] {
+  --rs-primary: #818cf8;
+  --rs-primary-hover: #a5b4fc;
+}

package/dist/theme/color-theme.d.ts

@@ -0,0 +1,64 @@
+import { type RsResolvedTheme } from './types';
+/**
+ * 颜色主题身份。只标记当前皮肤，组件样式不要用它做选择器。
+ * 明暗仍只写 `data-rs-theme="light|dark"`。
+ */
+export declare const colorThemeAttribute = "data-rs-color-theme";
+/** 文档级编辑器要同时观察明暗和颜色主题，否则同为暗色时换皮肤不会重读 token。 */
+export declare const documentThemeAttributes: readonly ["data-rs-theme", "data-rs-color-theme"];
+/**
+ * 主题包可以覆盖的语义令牌。表格、树、按钮等已用 var() 指向这些名字。
+ * 键是主题文件里的字段，值是要写到元素上的 CSS 变量。
+ */
+export declare const RS_COLOR_THEME_VARS: {
+    readonly primary: "--rs-primary";
+    readonly primaryHover: "--rs-primary-hover";
+    readonly primaryForeground: "--rs-primary-foreground";
+    readonly primaryContainer: "--rs-primary-container";
+    readonly onPrimaryContainer: "--rs-on-primary-container";
+    readonly bg: "--rs-bg";
+    readonly surface: "--rs-surface";
+    readonly surfaceElevated: "--rs-surface-elevated";
+    readonly surfaceHover: "--rs-surface-hover";
+    readonly itemHover: "--rs-item-hover";
+    readonly inputBg: "--rs-input-bg";
+    readonly inputBorder: "--rs-input-border";
+    readonly inputBorderHover: "--rs-input-border-hover";
+    readonly border: "--rs-border";
+    readonly borderSubtle: "--rs-border-subtle";
+    readonly text: "--rs-text-primary";
+    readonly muted: "--rs-text-secondary";
+    readonly placeholder: "--rs-text-tertiary";
+    readonly textDisabled: "--rs-text-disabled";
+    readonly textInverse: "--rs-text-inverse";
+    readonly danger: "--rs-danger";
+    readonly dangerContainer: "--rs-danger-container";
+    readonly onDangerContainer: "--rs-on-danger-container";
+    readonly success: "--rs-success";
+    readonly successContainer: "--rs-success-container";
+    readonly onSuccessContainer: "--rs-on-success-container";
+    readonly warning: "--rs-warning";
+    readonly warningContainer: "--rs-warning-container";
+    readonly onWarningContainer: "--rs-on-warning-container";
+    readonly info: "--rs-info";
+    readonly infoContainer: "--rs-info-container";
+    readonly onInfoContainer: "--rs-on-info-container";
+};
+export type RsColorThemeToken = keyof typeof RS_COLOR_THEME_VARS;
+/** 一份可安装的颜色主题。`id` 不翻译；`label` 用英文，宿主自己做语言包。 */
+export interface RsColorTheme {
+    id: string;
+    label: string;
+    uiTheme: RsResolvedTheme;
+    colors: Partial<Record<RsColorThemeToken, string>>;
+}
+/** 拒绝能逃出自定义属性、注入样式或外链的值。允许 hex、函数色和 var()。 */
+export declare function isSafeColorThemeValue(value: string): boolean;
+export declare function isSafeColorThemeId(id: string): boolean;
+/**
+ * 把主题包写到元素的内联 `--rs-*` 上，盖过 styles.css 与 brand.css。
+ * 未列出的字段保持样式表原值。非法 id 或没有目标元素时不改 DOM。
+ */
+export declare function applyColorTheme(theme: RsColorTheme, el?: HTMLElement | null): boolean;
+/** 去掉该元素上由颜色主题写上的变量，回到样式表。 */
+export declare function clearColorTheme(el?: HTMLElement | null): void;

package/dist/theme/color-theme.js

@@ -0,0 +1,100 @@
+import { themeAttribute } from "./types.js";
+//#region src/theme/color-theme.ts
+/**
+* 颜色主题身份。只标记当前皮肤，组件样式不要用它做选择器。
+* 明暗仍只写 `data-rs-theme="light|dark"`。
+*/
+var colorThemeAttribute = "data-rs-color-theme";
+/** 文档级编辑器要同时观察明暗和颜色主题，否则同为暗色时换皮肤不会重读 token。 */
+var documentThemeAttributes = [themeAttribute, colorThemeAttribute];
+/**
+* 主题包可以覆盖的语义令牌。表格、树、按钮等已用 var() 指向这些名字。
+* 键是主题文件里的字段，值是要写到元素上的 CSS 变量。
+*/
+var RS_COLOR_THEME_VARS = {
+	primary: "--rs-primary",
+	primaryHover: "--rs-primary-hover",
+	primaryForeground: "--rs-primary-foreground",
+	primaryContainer: "--rs-primary-container",
+	onPrimaryContainer: "--rs-on-primary-container",
+	bg: "--rs-bg",
+	surface: "--rs-surface",
+	surfaceElevated: "--rs-surface-elevated",
+	surfaceHover: "--rs-surface-hover",
+	itemHover: "--rs-item-hover",
+	inputBg: "--rs-input-bg",
+	inputBorder: "--rs-input-border",
+	inputBorderHover: "--rs-input-border-hover",
+	border: "--rs-border",
+	borderSubtle: "--rs-border-subtle",
+	text: "--rs-text-primary",
+	muted: "--rs-text-secondary",
+	placeholder: "--rs-text-tertiary",
+	textDisabled: "--rs-text-disabled",
+	textInverse: "--rs-text-inverse",
+	danger: "--rs-danger",
+	dangerContainer: "--rs-danger-container",
+	onDangerContainer: "--rs-on-danger-container",
+	success: "--rs-success",
+	successContainer: "--rs-success-container",
+	onSuccessContainer: "--rs-on-success-container",
+	warning: "--rs-warning",
+	warningContainer: "--rs-warning-container",
+	onWarningContainer: "--rs-on-warning-container",
+	info: "--rs-info",
+	infoContainer: "--rs-info-container",
+	onInfoContainer: "--rs-on-info-container"
+};
+var THEME_ID = /^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/;
+var appliedVars = /* @__PURE__ */ new WeakMap();
+function themeTarget(el) {
+	if (el) return el;
+	if (typeof document === "undefined") return null;
+	return document.documentElement;
+}
+/** 拒绝能逃出自定义属性、注入样式或外链的值。允许 hex、函数色和 var()。 */
+function isSafeColorThemeValue(value) {
+	const raw = value.trim();
+	if (!raw || raw.length > 240) return false;
+	if (/[;{}<>]|url\s*\(|expression\s*\(|@import|\/\*|\*\//i.test(raw)) return false;
+	return true;
+}
+function isSafeColorThemeId(id) {
+	return THEME_ID.test(id);
+}
+/**
+* 把主题包写到元素的内联 `--rs-*` 上，盖过 styles.css 与 brand.css。
+* 未列出的字段保持样式表原值。非法 id 或没有目标元素时不改 DOM。
+*/
+function applyColorTheme(theme, el) {
+	const target = themeTarget(el);
+	if (!target || !isSafeColorThemeId(theme.id)) return false;
+	const previous = appliedVars.get(target) ?? /* @__PURE__ */ new Set();
+	const next = /* @__PURE__ */ new Set();
+	for (const key of Object.keys(RS_COLOR_THEME_VARS)) {
+		const value = theme.colors[key];
+		if (value == null) continue;
+		const raw = String(value).trim();
+		if (!isSafeColorThemeValue(raw)) continue;
+		const prop = RS_COLOR_THEME_VARS[key];
+		target.style.setProperty(prop, raw);
+		next.add(prop);
+	}
+	for (const prop of previous) if (!next.has(prop)) target.style.removeProperty(prop);
+	appliedVars.set(target, next);
+	target.setAttribute(colorThemeAttribute, theme.id);
+	return true;
+}
+/** 去掉该元素上由颜色主题写上的变量，回到样式表。 */
+function clearColorTheme(el) {
+	const target = themeTarget(el);
+	if (!target) return;
+	const previous = appliedVars.get(target);
+	if (previous) {
+		for (const prop of previous) target.style.removeProperty(prop);
+		appliedVars.delete(target);
+	}
+	target.removeAttribute(colorThemeAttribute);
+}
+//#endregion
+export { RS_COLOR_THEME_VARS, applyColorTheme, clearColorTheme, colorThemeAttribute, documentThemeAttributes, isSafeColorThemeId, isSafeColorThemeValue };

package/dist/theme/css-token.d.ts

@@ -0,0 +1,27 @@
+/**
+ * 读取已计算的 CSS 自定义属性（不含首尾空白）。
+ * 会展开嵌套 `var(--token)`，便于 jsdom 与宿主覆盖。
+ * SSR / 无 DOM 时返回空字符串。
+ */
+export declare function readCssVar(name: string, el?: HTMLElement | null): string;
+/** 根元素字号（px），供 rem 换算；失败时按 16。 */
+export declare function readRootFontSizePx(): number;
+/**
+ * 将 `12px` / `0.875rem` / 无单位数字解析为 px。
+ * 嵌套 `var()` 须先经 getComputedStyle 展开。
+ */
+export declare function parseCssLengthToPx(raw: string, rootPx?: number): number | null;
+/** 读取长度类 token 并转为 px，供 Monaco / xterm 等只接受数字的 API。 */
+export declare function readCssLengthPx(name: string, fallback: number, el?: HTMLElement | null): number;
+/** 代码编辑器字体族：`--rs-code-font-family` → `--rs-font-mono`。 */
+export declare function readCodeFontFamily(el?: HTMLElement | null): string;
+/** 代码编辑器字号（px）：`--rs-code-font-size`，缺省按 sm=14。 */
+export declare function readCodeFontSizePx(el?: HTMLElement | null): number;
+/** 终端字体族：`--rs-terminal-font-family` → `--rs-font-mono`。 */
+export declare function readTerminalFontFamily(el?: HTMLElement | null): string;
+/** 终端字号（px）：`--rs-terminal-font-size`，缺省按 sm=14。 */
+export declare function readTerminalFontSizePx(el?: HTMLElement | null): number;
+/** 终端字重：`--rs-terminal-font-weight`，缺省 regular。 */
+export declare function readTerminalFontWeight(el?: HTMLElement | null): string;
+/** 终端粗体字重：`--rs-terminal-font-weight-bold`，缺省 medium。 */
+export declare function readTerminalFontWeightBold(el?: HTMLElement | null): string;

package/dist/theme/css-token.js

@@ -0,0 +1,72 @@
+//#region src/theme/css-token.ts
+var FALLBACK_ROOT_PX = 16;
+function unwrapCssVar(raw, el, depth = 0) {
+	if (!raw || depth > 8) return raw;
+	const match = /^var\(\s*(--[\w-]+)\s*(?:,\s*((?:.|\s)+))?\)$/.exec(raw);
+	if (!match) return raw;
+	const inner = getComputedStyle(el).getPropertyValue(match[1]).trim();
+	if (inner) return unwrapCssVar(inner, el, depth + 1);
+	const fallback = (match[2] || "").trim();
+	return fallback ? unwrapCssVar(fallback, el, depth + 1) : "";
+}
+/**
+* 读取已计算的 CSS 自定义属性（不含首尾空白）。
+* 会展开嵌套 `var(--token)`，便于 jsdom 与宿主覆盖。
+* SSR / 无 DOM 时返回空字符串。
+*/
+function readCssVar(name, el) {
+	if (typeof document === "undefined" || typeof getComputedStyle === "undefined") return "";
+	const target = el ?? document.documentElement;
+	return unwrapCssVar(getComputedStyle(target).getPropertyValue(name).trim(), target);
+}
+/** 根元素字号（px），供 rem 换算；失败时按 16。 */
+function readRootFontSizePx() {
+	if (typeof document === "undefined" || typeof getComputedStyle === "undefined") return FALLBACK_ROOT_PX;
+	const n = Number.parseFloat(getComputedStyle(document.documentElement).fontSize);
+	return Number.isFinite(n) && n > 0 ? n : FALLBACK_ROOT_PX;
+}
+/**
+* 将 `12px` / `0.875rem` / 无单位数字解析为 px。
+* 嵌套 `var()` 须先经 getComputedStyle 展开。
+*/
+function parseCssLengthToPx(raw, rootPx = readRootFontSizePx()) {
+	const value = raw.trim();
+	if (!value) return null;
+	const n = Number.parseFloat(value);
+	if (!Number.isFinite(n)) return null;
+	if (value.endsWith("px") || /^-?[\d.]+$/.test(value)) return n;
+	if (value.endsWith("rem") || value.endsWith("em")) return n * rootPx;
+	return null;
+}
+/** 读取长度类 token 并转为 px，供 Monaco / xterm 等只接受数字的 API。 */
+function readCssLengthPx(name, fallback, el) {
+	const parsed = parseCssLengthToPx(readCssVar(name, el));
+	return parsed == null ? fallback : parsed;
+}
+var CODE_FONT_FALLBACK = "ui-monospace, SF Mono, Consolas, Liberation Mono, Menlo, monospace";
+/** 代码编辑器字体族：`--rs-code-font-family` → `--rs-font-mono`。 */
+function readCodeFontFamily(el) {
+	return readCssVar("--rs-code-font-family", el) || readCssVar("--rs-font-mono", el) || CODE_FONT_FALLBACK;
+}
+/** 代码编辑器字号（px）：`--rs-code-font-size`，缺省按 sm=14。 */
+function readCodeFontSizePx(el) {
+	return readCssLengthPx("--rs-code-font-size", 14, el);
+}
+/** 终端字体族：`--rs-terminal-font-family` → `--rs-font-mono`。 */
+function readTerminalFontFamily(el) {
+	return readCssVar("--rs-terminal-font-family", el) || readCssVar("--rs-font-mono", el) || CODE_FONT_FALLBACK;
+}
+/** 终端字号（px）：`--rs-terminal-font-size`，缺省按 sm=14。 */
+function readTerminalFontSizePx(el) {
+	return readCssLengthPx("--rs-terminal-font-size", 14, el);
+}
+/** 终端字重：`--rs-terminal-font-weight`，缺省 regular。 */
+function readTerminalFontWeight(el) {
+	return readCssVar("--rs-terminal-font-weight", el) || readCssVar("--rs-font-weight-regular", el) || "400";
+}
+/** 终端粗体字重：`--rs-terminal-font-weight-bold`，缺省 medium。 */
+function readTerminalFontWeightBold(el) {
+	return readCssVar("--rs-terminal-font-weight-bold", el) || readCssVar("--rs-font-weight-medium", el) || "500";
+}
+//#endregion
+export { parseCssLengthToPx, readCodeFontFamily, readCodeFontSizePx, readCssLengthPx, readCssVar, readRootFontSizePx, readTerminalFontFamily, readTerminalFontSizePx, readTerminalFontWeight, readTerminalFontWeightBold };

package/dist/theme/presets.d.ts

@@ -0,0 +1,8 @@
+import type { RsResolvedTheme, RsThemeTokens } from './types';
+/**
+ * 色板参考值，**不驱动画面**。`applyTheme` 只写 `data-rs-theme`，
+ * 实际颜色只认 `styles.css` / 宿主 brand.css。改皮肤不要只改这里。
+ * 暗色：VS Code Dark Modern 灰阶 + macOS 系统色。
+ * 亮色：macOS systemBackground / label + VS Code Light Modern 表格语义。
+ */
+export declare const themePresets: Record<RsResolvedTheme, RsThemeTokens>;

package/dist/theme/presets.js

@@ -0,0 +1,75 @@
+//#region src/theme/presets.ts
+/**
+* 色板参考值，**不驱动画面**。`applyTheme` 只写 `data-rs-theme`，
+* 实际颜色只认 `styles.css` / 宿主 brand.css。改皮肤不要只改这里。
+* 暗色：VS Code Dark Modern 灰阶 + macOS 系统色。
+* 亮色：macOS systemBackground / label + VS Code Light Modern 表格语义。
+*/
+var themePresets = {
+	light: {
+		primary: "#007aff",
+		primaryHover: "#0071eb",
+		primaryForeground: "#ffffff",
+		primaryContainer: "#e5f1ff",
+		onPrimaryContainer: "#003d99",
+		bg: "#f5f5f7",
+		surface: "#ffffff",
+		surfaceElevated: "#ffffff",
+		surfaceHover: "#e8e8ed",
+		inputBg: "#ffffff",
+		border: "#8c8c8c",
+		borderSubtle: "rgb(60 60 67 / 0.20)",
+		text: "#1d1d1f",
+		muted: "#6e6e73",
+		placeholder: "#909090",
+		textDisabled: "#aeaeb2",
+		textInverse: "#ffffff",
+		danger: "#ff3b30",
+		dangerContainer: "#ffe5e3",
+		onDangerContainer: "#c41e16",
+		success: "#34c759",
+		successContainer: "#e4f8e9",
+		onSuccessContainer: "#1a7f37",
+		warning: "#ff9500",
+		warningContainer: "#fff3e0",
+		onWarningContainer: "#b26500",
+		info: "#007aff",
+		infoContainer: "#e5f1ff",
+		onInfoContainer: "#003d99",
+		focusRing: "color-mix(in srgb, #007aff 22%, transparent)"
+	},
+	dark: {
+		primary: "#0a84ff",
+		primaryHover: "#409cff",
+		primaryForeground: "#ffffff",
+		primaryContainer: "#0a2540",
+		onPrimaryContainer: "#6cb4ff",
+		bg: "#181818",
+		surface: "#1f1f1f",
+		surfaceElevated: "#262626",
+		surfaceHover: "#2e2e2e",
+		inputBg: "#2b2b2b",
+		border: "#6e6e6e",
+		borderSubtle: "#3a3a3a",
+		text: "#cccccc",
+		muted: "#9d9d9d",
+		placeholder: "#919191",
+		textDisabled: "#6e6e6e",
+		textInverse: "#ffffff",
+		danger: "#ff453a",
+		dangerContainer: "#3b1210",
+		onDangerContainer: "#ff8a84",
+		success: "#30d158",
+		successContainer: "#0d2818",
+		onSuccessContainer: "#6ee79a",
+		warning: "#ff9f0a",
+		warningContainer: "#2e1f08",
+		onWarningContainer: "#ffc46b",
+		info: "#0a84ff",
+		infoContainer: "#0a2540",
+		onInfoContainer: "#6cb4ff",
+		focusRing: "color-mix(in srgb, #0a84ff 28%, transparent)"
+	}
+};
+//#endregion
+export { themePresets };

package/dist/theme/types.d.ts

@@ -0,0 +1,105 @@
+/** 已落到 DOM 的明暗（`data-rs-theme` 只写这两个值）。 */
+export type RsResolvedTheme = 'light' | 'dark';
+/**
+ * 主题偏好。`system` 跟随 `prefers-color-scheme`，
+ * `applyTheme` 仍把解析结果写到 `data-rs-theme="light|dark"`。
+ */
+export type RsThemeMode = RsResolvedTheme | 'system';
+/**
+ * 控件尺寸（由小到大）：
+ * - ssm：极小
+ * - sm：小号
+ * - md：中号（默认）
+ * - lg：大号
+ *
+ * 高度由 `--rs-control-height-*` 统一控制，业务侧勿用 :deep 覆盖。
+ */
+export type RsComponentSize = 'ssm' | 'sm' | 'md' | 'lg';
+export declare const RS_COMPONENT_SIZES: readonly RsComponentSize[];
+/** 各档控件图标默认像素边长。 */
+export declare const RS_COMPONENT_SIZE_ICON_PX: Record<RsComponentSize, number>;
+/**
+ * 圆角档位（由小到大）：
+ * - none：直角（无圆角）
+ * - xs / sm / md / lg：对应 `--rs-radius-*`
+ * - full：胶囊 / 圆形
+ *
+ * 业务侧用组件 `radius` / `iconRadius` 等 prop，勿 :deep 改 border-radius。
+ */
+export type RsRadius = 'none' | 'xs' | 'sm' | 'md' | 'lg' | 'full';
+export declare const RS_RADII: readonly RsRadius[];
+/** 各档圆角对应的 CSS 值（可直接赋给 border-radius / CSS 变量）。 */
+export declare const RS_RADIUS_CSS: Record<RsRadius, string>;
+/**
+ * 字号档位（由小到大）：
+ * - xs：Caption / 辅助
+ * - sm：次要正文
+ * - base：正文（默认）
+ * - lg：强调正文
+ * - xl：小标题
+ * - 2xl：标题
+ * - 3xl：展示级标题
+ *
+ * 对应 `--rs-font-size-*`；业务侧优先用 token，勿硬编码 px。
+ * 字族走 `--rs-font-sans` / `--rs-font-mono` / `--rs-font-serif`，组件勿硬编码 system 栈。
+ */
+export type RsFontSize = 'xs' | 'sm' | 'base' | 'lg' | 'xl' | '2xl' | '3xl';
+export declare const RS_FONT_SIZES: readonly RsFontSize[];
+/** 各档字号对应的 CSS 值。 */
+export declare const RS_FONT_SIZE_CSS: Record<RsFontSize, string>;
+/**
+ * 字重档位：
+ * - regular：正文
+ * - medium：标签 / 弱强调
+ * - semibold：标题 / 表头
+ * - bold：强强调
+ */
+export type RsFontWeight = 'regular' | 'medium' | 'semibold' | 'bold';
+export declare const RS_FONT_WEIGHTS: readonly RsFontWeight[];
+/** 各档字重对应的 CSS 值。 */
+export declare const RS_FONT_WEIGHT_CSS: Record<RsFontWeight, string>;
+/**
+ * 设计 token（JS 参考面，与 styles.css 同名语义对应）。
+ * 色相：primary 与功能色（danger / success / warning / info）及 container / on-container。
+ * 文字：primary / secondary / tertiary / disabled / inverse / link。
+ */
+export interface RsThemeTokens {
+    primary: string;
+    primaryHover: string;
+    primaryForeground: string;
+    primaryContainer: string;
+    onPrimaryContainer: string;
+    bg: string;
+    surface: string;
+    surfaceElevated: string;
+    surfaceHover: string;
+    inputBg: string;
+    border: string;
+    borderSubtle: string;
+    /** 主文案（--rs-text-primary） */
+    text: string;
+    /** 次要文案（--rs-text-secondary） */
+    muted: string;
+    /** 占位 / 三级文案（--rs-text-tertiary） */
+    placeholder: string;
+    /** 禁用文案（与 --rs-text-disabled 同步） */
+    textDisabled: string;
+    /** 反色文案，用于主色 / 深色底（与 --rs-text-inverse 同步） */
+    textInverse: string;
+    danger: string;
+    dangerContainer: string;
+    onDangerContainer: string;
+    success: string;
+    successContainer: string;
+    onSuccessContainer: string;
+    warning: string;
+    warningContainer: string;
+    onWarningContainer: string;
+    info: string;
+    infoContainer: string;
+    onInfoContainer: string;
+    focusRing: string;
+}
+export declare const themeAttribute = "data-rs-theme";
+/** 偏好为 system 时写入，便于宿主区分「用户选了暗色」和「跟着系统」。 */
+export declare const themePrefAttribute = "data-rs-theme-pref";

package/dist/theme/types.js

@@ -0,0 +1,68 @@
+//#region src/theme/types.ts
+var RS_COMPONENT_SIZES = [
+	"ssm",
+	"sm",
+	"md",
+	"lg"
+];
+/** 各档控件图标默认像素边长。 */
+var RS_COMPONENT_SIZE_ICON_PX = {
+	ssm: 12,
+	sm: 14,
+	md: 16,
+	lg: 18
+};
+var RS_RADII = [
+	"none",
+	"xs",
+	"sm",
+	"md",
+	"lg",
+	"full"
+];
+/** 各档圆角对应的 CSS 值（可直接赋给 border-radius / CSS 变量）。 */
+var RS_RADIUS_CSS = {
+	none: "0",
+	xs: "var(--rs-radius-xs)",
+	sm: "var(--rs-radius-sm)",
+	md: "var(--rs-radius)",
+	lg: "var(--rs-radius-lg)",
+	full: "var(--rs-radius-full)"
+};
+var RS_FONT_SIZES = [
+	"xs",
+	"sm",
+	"base",
+	"lg",
+	"xl",
+	"2xl",
+	"3xl"
+];
+/** 各档字号对应的 CSS 值。 */
+var RS_FONT_SIZE_CSS = {
+	xs: "var(--rs-font-size-xs)",
+	sm: "var(--rs-font-size-sm)",
+	base: "var(--rs-font-size-base)",
+	lg: "var(--rs-font-size-lg)",
+	xl: "var(--rs-font-size-xl)",
+	"2xl": "var(--rs-font-size-2xl)",
+	"3xl": "var(--rs-font-size-3xl)"
+};
+var RS_FONT_WEIGHTS = [
+	"regular",
+	"medium",
+	"semibold",
+	"bold"
+];
+/** 各档字重对应的 CSS 值。 */
+var RS_FONT_WEIGHT_CSS = {
+	regular: "var(--rs-font-weight-regular)",
+	medium: "var(--rs-font-weight-medium)",
+	semibold: "var(--rs-font-weight-semibold)",
+	bold: "var(--rs-font-weight-bold)"
+};
+var themeAttribute = "data-rs-theme";
+/** 偏好为 system 时写入，便于宿主区分「用户选了暗色」和「跟着系统」。 */
+var themePrefAttribute = "data-rs-theme-pref";
+//#endregion
+export { RS_COMPONENT_SIZES, RS_COMPONENT_SIZE_ICON_PX, RS_FONT_SIZES, RS_FONT_SIZE_CSS, RS_FONT_WEIGHTS, RS_FONT_WEIGHT_CSS, RS_RADII, RS_RADIUS_CSS, themeAttribute, themePrefAttribute };

package/dist/utils/iso-local-datetime.d.ts

@@ -0,0 +1,17 @@
+/**
+ * 带显式时区的 ISO-8601 ↔ 本机本地墙钟。
+ * 用于表格展示 / 编辑草稿 / 写回，避免剥 Z 丢时区，并尽量保留毫秒。
+ */
+/**
+ * 廉价判定：是否像「带时区的 ISO 日期时间」。
+ * 失败路径只做长度/字符检查，避免对普通文本跑正则。
+ */
+export declare function looksLikeIsoDateTimeWithTz(value: string): boolean;
+/** 将带时区的 ISO 串转为本地时间；无法识别则返回 null。 */
+export declare function formatIsoUtcToLocal(value: string): string | null;
+/**
+ * 将本地墙钟（或已带时区的 ISO）写回 UTC ISO。
+ * - 与 previousIso 在「秒」级一致且输入无新小数秒 → 原样返回 previous（保留毫秒/更长小数）
+ * - 否则按输入精度生成 `...Z`（有小数秒则到毫秒）
+ */
+export declare function parseLocalDateTimeToUtcIso(local: string, previousIso?: string): string | null;