niuma-ui 2.0.0 → 2.0.1

package/dist/theme/brand.example.css

@@ -10,7 +10,7 @@
  * 可覆盖的常见 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-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-*
@@ -22,6 +22,10 @@
  * - 表格专用：--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'] {

package/dist/theme/presets.d.ts

@@ -1,7 +1,8 @@
-import type { RsThemeMode, RsThemeTokens } from './types';
+import type { RsResolvedTheme, RsThemeTokens } from './types';
 /**
- * 色板参考值（与 styles.css 中的 --rs-* 保持同步，勿单独改此处）
- * 暗色：VS Code Dark Modern 灰阶 + macOS 系统色（primary / danger / success 等）
- * 亮色：macOS systemBackground / label + VS Code Light Modern 表格语义
+ * 色板参考值，**不驱动画面**。`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<RsThemeMode, RsThemeTokens>;
+export declare const themePresets: Record<RsResolvedTheme, RsThemeTokens>;

package/dist/theme/presets.js

@@ -1,8 +1,9 @@
 //#region src/theme/presets.ts
 /**
-* 色板参考值（与 styles.css 中的 --rs-* 保持同步，勿单独改此处）
-* 暗色：VS Code Dark Modern 灰阶 + macOS 系统色（primary / danger / success 等）
-* 亮色：macOS systemBackground / label + VS Code Light Modern 表格语义
+* 色板参考值，**不驱动画面**。`applyTheme` 只写 `data-rs-theme`，
+* 实际颜色只认 `styles.css` / 宿主 brand.css。改皮肤不要只改这里。
+* 暗色：VS Code Dark Modern 灰阶 + macOS 系统色。
+* 亮色：macOS systemBackground / label + VS Code Light Modern 表格语义。
 */
 var themePresets = {
 	light: {

package/dist/theme/types.d.ts

@@ -1,4 +1,10 @@
-export type RsThemeMode = 'dark' | 'light';
+/** 已落到 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：极小
@@ -53,9 +59,9 @@ export declare const RS_FONT_WEIGHTS: readonly RsFontWeight[];
 /** 各档字重对应的 CSS 值。 */
 export declare const RS_FONT_WEIGHT_CSS: Record<RsFontWeight, string>;
 /**
- * 设计 token
- * 色彩语义：Google MD3 容器色 + 字节 Arco 中性色 + 国际 SaaS 功能色
- * 文字语义：Ant / Arco 四级（primary / secondary / tertiary / disabled）+ link / inverse
+ * 设计 token（JS 参考面，与 styles.css 同名语义对应）。
+ * 色相：primary 与功能色（danger / success / warning / info）及 container / on-container。
+ * 文字：primary / secondary / tertiary / disabled / inverse / link。
  */
 export interface RsThemeTokens {
     primary: string;
@@ -70,11 +76,11 @@ export interface RsThemeTokens {
     inputBg: string;
     border: string;
     borderSubtle: string;
-    /** 主文案（与 --rs-text / --rs-text-primary 同步） */
+    /** 主文案（--rs-text-primary） */
     text: string;
-    /** 次要文案（与 --rs-muted / --rs-text-secondary 同步） */
+    /** 次要文案（--rs-text-secondary） */
     muted: string;
-    /** 占位 / 三级文案（与 --rs-placeholder / --rs-text-tertiary 同步） */
+    /** 占位 / 三级文案（--rs-text-tertiary） */
     placeholder: string;
     /** 禁用文案（与 --rs-text-disabled 同步） */
     textDisabled: string;
@@ -95,3 +101,5 @@ export interface RsThemeTokens {
     focusRing: string;
 }
 export declare const themeAttribute = "data-rs-theme";
+/** 偏好为 system 时写入，便于宿主区分「用户选了暗色」和「跟着系统」。 */
+export declare const themePrefAttribute = "data-rs-theme-pref";

package/dist/theme/types.js

@@ -61,5 +61,8 @@ var RS_FONT_WEIGHT_CSS = {
 	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 };
+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/vite-plugins/niuma-ui-host.js

@@ -78,6 +78,7 @@ function niumaUiHostAlias(ctx) {
             const styles = existsSync(join(ctx.root, 'src/styles/index.css'))
                 ? join(ctx.root, 'src/styles/index.css')
                 : join(ctx.root, 'src/styles.css');
+            const brandIcons = join(ctx.root, 'src/icons/style/brand-icon-tokens.css');
             const alias = [
                 ...(existsSync(styles)
                     ? [
@@ -85,6 +86,12 @@ function niumaUiHostAlias(ctx) {
                         { find: 'niuma-ui/styles.css', replacement: styles },
                     ]
                     : []),
+                ...(existsSync(brandIcons)
+                    ? [
+                        { find: '@niuma/ui/brand-icons.css', replacement: brandIcons },
+                        { find: 'niuma-ui/brand-icons.css', replacement: brandIcons },
+                    ]
+                    : []),
                 ...dayjsAlias,
             ];
             return {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "niuma-ui",
-  "version": "2.0.0",
+  "version": "2.0.1",
   "license": "Apache-2.0",
   "type": "module",
   "description": "Vue 3 workbench design system — Rs* components, --rs-* tokens, optional Monaco / CodeMirror / xterm",
@@ -38,6 +38,7 @@
       "default": "./dist/index.js"
     },
     "./styles.css": "./dist/styles.css",
+    "./brand-icons.css": "./dist/brand-icons.css",
     "./vite-plugins/monaco-zh-nls": {
       "types": "./dist/vite-plugins/monaco-zh-nls.d.ts",
       "import": "./dist/vite-plugins/monaco-zh-nls.js",