@aithe/aithe-ui 26.2.3 → 26.3.2

package/dist/styles/aithe-ui.d.ts

@@ -16,6 +16,7 @@ import { type AitheLocale } from './i18n';
  * ```
  */
 export declare class AitheUI {
+    private readonly _ua;
     /**
      * Create an AitheUI instance and initialize all subsystems with optional defaults.
      * 创建 AitheUI 实例，并使用可选默认值初始化所有子系统。
@@ -84,6 +85,28 @@ export declare class AitheUI {
     registerLocale(locale: AitheLocale, translations: Record<string, string>): void;
     /** Translate a key using the current locale. 使用当前语言翻译指定键。 */
     t(key: string, dft?: string, params?: Record<string, string | number>): string;
+    /** Whether the UA indicates a mobile device (Android/iOS/WebOS/Blackberry). UA 是否指示移动设备。 */
+    get isMobile(): boolean;
+    /** Whether the UA indicates Android. UA 是否指示 Android。 */
+    get isAndroid(): boolean;
+    /** Whether the UA indicates iOS. UA 是否指示 iOS。 */
+    get isIOS(): boolean;
+    /** Whether the UA indicates Chrome (not Edge). UA 是否指示 Chrome（非 Edge）。 */
+    get isChrome(): boolean;
+    /** Whether the UA indicates Edge. UA 是否指示 Edge。 */
+    get isEdge(): boolean;
+    /** Whether the UA indicates WeChat built-in browser. UA 是否指示微信内置浏览器。 */
+    get isWechat(): boolean;
+    /** Whether the UA indicates Windows. UA 是否指示 Windows。 */
+    get isWindows(): boolean;
+    /** Whether the UA indicates macOS. UA 是否指示 macOS。 */
+    get isMacOS(): boolean;
+    /** Whether the device is truly mobile (UA + touch + small screen + not desktop OS). 是否为真实移动设备。 */
+    get isRealMobile(): boolean;
+    /** Whether Chrome DevTools device emulation is active. Chrome 开发者工具设备模拟是否激活。 */
+    get isChromeEmulator(): boolean;
+    /** Whether the device supports touch events. 设备是否支持触摸事件。 */
+    get supportsTouch(): boolean;
 }
 /** Default singleton instance of AitheUI. AitheUI 的默认单例实例。 */
 export declare const aitheUI: AitheUI;

package/dist/styles/aithe-ui.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"aithe-ui.d.ts","sourceRoot":"","sources":["../../src/styles/aithe-ui.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EACf,eAAe,EACf,cAAc,EACd,cAAc,EACd,aAAa,EACd,MAAM,eAAe,CAAC;AA0CvB,OAAO,EAEL,KAAK,WAAW,EAQjB,MAAM,cAAc,CAAC;AAEtB;;;;;;;;;;;;;;GAcG;AACH,qBAAa,OAAO;IAClB;;;;;OAKG;gBACS,OAAO,CAAC,EAAE;QACpB,YAAY,CAAC,EAAE,cAAc,CAAC;QAC9B,aAAa,CAAC,EAAE,eAAe,CAAC;QAChC,YAAY,CAAC,EAAE,cAAc,CAAC;QAC9B,aAAa,CAAC,EAAE,eAAe,CAAC;QAChC,WAAW,CAAC,EAAE,aAAa,CAAC;QAC5B,aAAa,CAAC,EAAE,WAAW,CAAC;KAC7B;IASD,uGAAuG;IACvG,QAAQ,CAAC,KAAK,EAAE,cAAc,EAAE,OAAO,UAAO,GAAG,IAAI;IAKrD,sDAAsD;IACtD,QAAQ,IAAI,cAAc;IAK1B,oFAAoF;IACpF,aAAa,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI;IAIzC,0GAA0G;IAC1G,SAAS,CAAC,MAAM,EAAE,eAAe,EAAE,OAAO,UAAO,GAAG,IAAI;IAIxD,yDAAyD;IACzD,SAAS,IAAI,eAAe;IAI5B,+FAA+F;IAC/F,cAAc,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI;IAI1C,uGAAuG;IACvG,QAAQ,CAAC,KAAK,EAAE,cAAc,EAAE,OAAO,UAAO,GAAG,IAAI;IAIrD,sDAAsD;IACtD,QAAQ,IAAI,cAAc;IAI1B,sEAAsE;IACtE,SAAS;IAIT,yFAAyF;IACzF,cAAc,CAAC,KAAK,EAAE,cAAc;IAIpC,4FAA4F;IAC5F,aAAa,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI;IAIzC,wGAAwG;IACxG,SAAS,CAAC,MAAM,EAAE,eAAe,EAAE,OAAO,UAAO,GAAG,IAAI;IAIxD,uDAAuD;IACvD,SAAS,IAAI,eAAe;IAI5B,uEAAuE;IACvE,UAAU;IAIV,0FAA0F;IAC1F,eAAe,CAAC,MAAM,EAAE,eAAe;IAIvC,6FAA6F;IAC7F,cAAc,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI;IAI1C,sGAAsG;IACtG,OAAO,CAAC,IAAI,EAAE,aAAa,EAAE,OAAO,UAAO,GAAG,IAAI;IAIlD,qDAAqD;IACrD,OAAO,IAAI,aAAa;IAIxB,qEAAqE;IACrE,QAAQ;IAIR,wFAAwF;IACxF,aAAa,CAAC,IAAI,EAAE,aAAa;IAIjC,2FAA2F;IAC3F,YAAY,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI;IAIxC,gGAAgG;IAChG,SAAS,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,UAAO,GAAG,IAAI;IAIpD,+CAA+C;IAC/C,SAAS,IAAI,WAAW;IAIxB,yEAAyE;IACzE,UAAU,IAAI,WAAW,EAAE;IAI3B,qFAAqF;IACrF,cAAc,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI;IAI1C,4EAA4E;IAC5E,cAAc,CAAC,MAAM,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAI/E,6DAA6D;IAC7D,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,GAAG,MAAM;CAG/E;AAED,8DAA8D;AAC9D,eAAO,MAAM,OAAO,SAAgB,CAAC"}
+{"version":3,"file":"aithe-ui.d.ts","sourceRoot":"","sources":["../../src/styles/aithe-ui.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EACf,eAAe,EACf,cAAc,EACd,cAAc,EACd,aAAa,EACd,MAAM,eAAe,CAAC;AA0CvB,OAAO,EAEL,KAAK,WAAW,EAQjB,MAAM,cAAc,CAAC;AAEtB;;;;;;;;;;;;;;GAcG;AACH,qBAAa,OAAO;IAClB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAE7B;;;;;OAKG;gBACS,OAAO,CAAC,EAAE;QACpB,YAAY,CAAC,EAAE,cAAc,CAAC;QAC9B,aAAa,CAAC,EAAE,eAAe,CAAC;QAChC,YAAY,CAAC,EAAE,cAAc,CAAC;QAC9B,aAAa,CAAC,EAAE,eAAe,CAAC;QAChC,WAAW,CAAC,EAAE,aAAa,CAAC;QAC5B,aAAa,CAAC,EAAE,WAAW,CAAC;KAC7B;IAUD,uGAAuG;IACvG,QAAQ,CAAC,KAAK,EAAE,cAAc,EAAE,OAAO,UAAO,GAAG,IAAI;IAKrD,sDAAsD;IACtD,QAAQ,IAAI,cAAc;IAK1B,oFAAoF;IACpF,aAAa,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI;IAIzC,0GAA0G;IAC1G,SAAS,CAAC,MAAM,EAAE,eAAe,EAAE,OAAO,UAAO,GAAG,IAAI;IAIxD,yDAAyD;IACzD,SAAS,IAAI,eAAe;IAI5B,+FAA+F;IAC/F,cAAc,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI;IAI1C,uGAAuG;IACvG,QAAQ,CAAC,KAAK,EAAE,cAAc,EAAE,OAAO,UAAO,GAAG,IAAI;IAIrD,sDAAsD;IACtD,QAAQ,IAAI,cAAc;IAI1B,sEAAsE;IACtE,SAAS;IAIT,yFAAyF;IACzF,cAAc,CAAC,KAAK,EAAE,cAAc;IAIpC,4FAA4F;IAC5F,aAAa,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI;IAIzC,wGAAwG;IACxG,SAAS,CAAC,MAAM,EAAE,eAAe,EAAE,OAAO,UAAO,GAAG,IAAI;IAIxD,uDAAuD;IACvD,SAAS,IAAI,eAAe;IAI5B,uEAAuE;IACvE,UAAU;IAIV,0FAA0F;IAC1F,eAAe,CAAC,MAAM,EAAE,eAAe;IAIvC,6FAA6F;IAC7F,cAAc,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI;IAI1C,sGAAsG;IACtG,OAAO,CAAC,IAAI,EAAE,aAAa,EAAE,OAAO,UAAO,GAAG,IAAI;IAIlD,qDAAqD;IACrD,OAAO,IAAI,aAAa;IAIxB,qEAAqE;IACrE,QAAQ;IAIR,wFAAwF;IACxF,aAAa,CAAC,IAAI,EAAE,aAAa;IAIjC,2FAA2F;IAC3F,YAAY,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI;IAIxC,gGAAgG;IAChG,SAAS,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,UAAO,GAAG,IAAI;IAIpD,+CAA+C;IAC/C,SAAS,IAAI,WAAW;IAIxB,yEAAyE;IACzE,UAAU,IAAI,WAAW,EAAE;IAI3B,qFAAqF;IACrF,cAAc,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI;IAI1C,4EAA4E;IAC5E,cAAc,CAAC,MAAM,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAI/E,6DAA6D;IAC7D,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,GAAG,MAAM;IAI9E,4FAA4F;IAC5F,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED,yDAAyD;IACzD,IAAI,SAAS,IAAI,OAAO,CAAsC;IAE9D,iDAAiD;IACjD,IAAI,KAAK,IAAI,OAAO,CAA+C;IAEnE,0EAA0E;IAC1E,IAAI,QAAQ,IAAI,OAAO,CAAqD;IAE5E,mDAAmD;IACnD,IAAI,MAAM,IAAI,OAAO,CAAuC;IAE5D,wEAAwE;IACxE,IAAI,QAAQ,IAAI,OAAO,CAA6C;IAEpE,yDAAyD;IACzD,IAAI,SAAS,IAAI,OAAO,CAAsC;IAE9D,qDAAqD;IACrD,IAAI,OAAO,IAAI,OAAO,CAAuC;IAE7D,kGAAkG;IAClG,IAAI,YAAY,IAAI,OAAO,CAM1B;IAED,gFAAgF;IAChF,IAAI,gBAAgB,IAAI,OAAO,CAK9B;IAED,4DAA4D;IAC5D,IAAI,aAAa,IAAI,OAAO,CAE3B;CACF;AAED,8DAA8D;AAC9D,eAAO,MAAM,OAAO,SAAgB,CAAC"}

package/dist/styles/aithe-ui.js

@@ -0,0 +1,185 @@
+import { AITHE_DEFAULT_THEME, initAitheTheme, onAitheThemeChange, registerAitheTheme, setGlobalTheme, } from './theme';
+import { AITHE_DEFAULT_LAYOUT, initAitheLayout, setAitheLayout, getAitheLayout, onAitheLayoutChange, } from './layout';
+import { AITHE_DEFAULT_SHAPE, initAitheShape, setAitheShape, getAitheShape, getAitheShapes, getShapeTokens, onAitheShapeChange, } from './shape';
+import { AITHE_DEFAULT_SHADOW, initAitheShadow, setAitheShadow, getAitheShadow, getAitheShadows, getShadowTokens, onAitheShadowChange, } from './shadow';
+import { AITHE_DEFAULT_TYPO, initAitheTypo, setAitheTypo, getAitheTypo, getAitheTypos, getTypoTokens, onAitheTypoChange, } from './typo';
+import { AITHE_DEFAULT_LOCALE, initAitheLocale, setAitheLocale, getAitheLocale, getAitheLocales, onAitheLocaleChange, registerAitheTranslations, t as translate, } from './i18n';
+/**
+ * Unified API class for managing Aithe UI global state: theme, shape, shadow, layout, and i18n.
+ * Aithe UI 全局状态统一管理类：主题、形状、阴影、布局和国际化。
+ *
+ * Provides a single entry point for all runtime configuration and persistence.
+ * 提供所有运行时配置和持久化的单一入口。
+ *
+ * @example
+ * ```ts
+ * import { aitheUI } from '@aithe/aithe-ui';
+ * aitheUI.setTheme('dark');
+ * aitheUI.setShape('pill');
+ * aitheUI.setShadow('neumorphism');
+ * ```
+ */
+export class AitheUI {
+    /**
+     * Create an AitheUI instance and initialize all subsystems with optional defaults.
+     * 创建 AitheUI 实例，并使用可选默认值初始化所有子系统。
+     *
+     * @param options - Default values for each subsystem. 各子系统的默认值。
+     */
+    constructor(options) {
+        initAitheTheme(options?.defaultTheme ?? AITHE_DEFAULT_THEME);
+        initAitheLayout(options?.defaultLayout ?? AITHE_DEFAULT_LAYOUT);
+        initAitheShape(options?.defaultShape ?? AITHE_DEFAULT_SHAPE);
+        initAitheShadow(options?.defaultShadow ?? AITHE_DEFAULT_SHADOW);
+        initAitheTypo(options?.defaultTypo ?? AITHE_DEFAULT_TYPO);
+        initAitheLocale(options?.defaultLocale ?? AITHE_DEFAULT_LOCALE);
+        this._ua = navigator.userAgent.toLowerCase();
+    }
+    /** Set the global color theme and optionally persist to localStorage. 设置全局颜色主题，可选持久化到 localStorage。 */
+    setTheme(theme, persist = true) {
+        registerAitheTheme();
+        setGlobalTheme(theme, persist);
+    }
+    /** Get the current global color theme. 获取当前全局颜色主题。 */
+    getTheme() {
+        registerAitheTheme();
+        return document.documentElement.dataset.aitheTheme || AITHE_DEFAULT_THEME;
+    }
+    /** Subscribe to theme changes. Returns an unsubscribe function. 订阅主题变更，返回取消订阅函数。 */
+    onThemeChange(fn) {
+        return onAitheThemeChange(fn);
+    }
+    /** Set the global layout density and optionally persist to localStorage. 设置全局布局密度，可选持久化到 localStorage。 */
+    setLayout(layout, persist = true) {
+        setAitheLayout(layout, persist);
+    }
+    /** Get the current global layout density. 获取当前全局布局密度。 */
+    getLayout() {
+        return getAitheLayout();
+    }
+    /** Subscribe to layout density changes. Returns an unsubscribe function. 订阅布局密度变更，返回取消订阅函数。 */
+    onLayoutChange(fn) {
+        return onAitheLayoutChange(fn);
+    }
+    /** Set the global shape style and optionally persist to localStorage. 设置全局形状风格，可选持久化到 localStorage。 */
+    setShape(shape, persist = true) {
+        setAitheShape(shape, persist);
+    }
+    /** Get the current global shape style. 获取当前全局形状风格。 */
+    getShape() {
+        return getAitheShape();
+    }
+    /** Get the list of all built-in shape style names. 获取所有内置形状风格名称列表。 */
+    getShapes() {
+        return getAitheShapes();
+    }
+    /** Get the CSS variable token map for a given shape style. 获取指定形状风格的 CSS 变量 token 映射。 */
+    getShapeTokens(shape) {
+        return getShapeTokens(shape);
+    }
+    /** Subscribe to shape style changes. Returns an unsubscribe function. 订阅形状风格变更，返回取消订阅函数。 */
+    onShapeChange(fn) {
+        return onAitheShapeChange(fn);
+    }
+    /** Set the global shadow style and optionally persist to localStorage. 设置全局阴影风格，可选持久化到 localStorage。 */
+    setShadow(shadow, persist = true) {
+        setAitheShadow(shadow, persist);
+    }
+    /** Get the current global shadow style. 获取当前全局阴影风格。 */
+    getShadow() {
+        return getAitheShadow();
+    }
+    /** Get the list of all built-in shadow style names. 获取所有内置阴影风格名称列表。 */
+    getShadows() {
+        return getAitheShadows();
+    }
+    /** Get the CSS variable token map for a given shadow style. 获取指定阴影风格的 CSS 变量 token 映射。 */
+    getShadowTokens(shadow) {
+        return getShadowTokens(shadow);
+    }
+    /** Subscribe to shadow style changes. Returns an unsubscribe function. 订阅阴影风格变更，返回取消订阅函数。 */
+    onShadowChange(fn) {
+        return onAitheShadowChange(fn);
+    }
+    /** Set the global typo style and optionally persist to localStorage. 设置全局排版风格，可选持久化到 localStorage。 */
+    setTypo(typo, persist = true) {
+        setAitheTypo(typo, persist);
+    }
+    /** Get the current global typo style. 获取当前全局排版风格。 */
+    getTypo() {
+        return getAitheTypo();
+    }
+    /** Get the list of all built-in typo style names. 获取所有内置排版风格名称列表。 */
+    getTypos() {
+        return getAitheTypos();
+    }
+    /** Get the CSS variable token map for a given typo style. 获取指定排版风格的 CSS 变量 token 映射。 */
+    getTypoTokens(typo) {
+        return getTypoTokens(typo);
+    }
+    /** Subscribe to typo style changes. Returns an unsubscribe function. 订阅排版风格变更，返回取消订阅函数。 */
+    onTypoChange(fn) {
+        return onAitheTypoChange(fn);
+    }
+    /** Set the global locale and optionally persist to localStorage. 设置全局语言，可选持久化到 localStorage。 */
+    setLocale(locale, persist = true) {
+        setAitheLocale(locale, persist);
+    }
+    /** Get the current global locale. 获取当前全局语言。 */
+    getLocale() {
+        return getAitheLocale();
+    }
+    /** Get the list of all registered locale identifiers. 获取所有已注册的语言标识列表。 */
+    getLocales() {
+        return getAitheLocales();
+    }
+    /** Subscribe to locale changes. Returns an unsubscribe function. 订阅语言变更，返回取消订阅函数。 */
+    onLocaleChange(fn) {
+        return onAitheLocaleChange(fn);
+    }
+    /** Merge additional translations into an existing locale. 合并追加翻译条目到已有语言。 */
+    registerLocale(locale, translations) {
+        registerAitheTranslations(locale, translations);
+    }
+    /** Translate a key using the current locale. 使用当前语言翻译指定键。 */
+    t(key, dft, params) {
+        return translate(key, dft, params);
+    }
+    /** Whether the UA indicates a mobile device (Android/iOS/WebOS/Blackberry). UA 是否指示移动设备。 */
+    get isMobile() {
+        return /android|iphone|ipod|ipad|webos|blackberry/i.test(this._ua);
+    }
+    /** Whether the UA indicates Android. UA 是否指示 Android。 */
+    get isAndroid() { return /android/i.test(this._ua); }
+    /** Whether the UA indicates iOS. UA 是否指示 iOS。 */
+    get isIOS() { return /iphone|ipad|ipod/i.test(this._ua); }
+    /** Whether the UA indicates Chrome (not Edge). UA 是否指示 Chrome（非 Edge）。 */
+    get isChrome() { return /chrome/i.test(this._ua) && !this.isEdge; }
+    /** Whether the UA indicates Edge. UA 是否指示 Edge。 */
+    get isEdge() { return /edg|edge/i.test(this._ua); }
+    /** Whether the UA indicates WeChat built-in browser. UA 是否指示微信内置浏览器。 */
+    get isWechat() { return /micromessenger/i.test(this._ua); }
+    /** Whether the UA indicates Windows. UA 是否指示 Windows。 */
+    get isWindows() { return /windows/i.test(this._ua); }
+    /** Whether the UA indicates macOS. UA 是否指示 macOS。 */
+    get isMacOS() { return /mac os x/i.test(this._ua); }
+    /** Whether the device is truly mobile (UA + touch + small screen + not desktop OS). 是否为真实移动设备。 */
+    get isRealMobile() {
+        const isUAMobile = this.isMobile;
+        const hasTouch = 'ontouchstart' in globalThis.window || navigator.maxTouchPoints > 0;
+        const isSmallScreen = window.innerWidth < 768;
+        const isNotDesktop = !this.isWindows && !this.isMacOS;
+        return isUAMobile && hasTouch && isSmallScreen && isNotDesktop;
+    }
+    /** Whether Chrome DevTools device emulation is active. Chrome 开发者工具设备模拟是否激活。 */
+    get isChromeEmulator() {
+        return ((this.isChrome && this.isMobile && globalThis.window.__CHROME_DEVICE_EMULATION__) ||
+            (globalThis.navigator.maxTouchPoints === 1 && globalThis.window.innerWidth > 500));
+    }
+    /** Whether the device supports touch events. 设备是否支持触摸事件。 */
+    get supportsTouch() {
+        return 'ontouchstart' in globalThis.window || navigator.maxTouchPoints > 0;
+    }
+}
+/** Default singleton instance of AitheUI. AitheUI 的默认单例实例。 */
+export const aitheUI = new AitheUI();

package/dist/styles/global.css.d.ts

@@ -1,5 +1,5 @@
 /** Global CSS text for `:root` primitive tokens plus base html/body/selection resets. 用于 `:root` 基础令牌及 html/body/选区重置的全局 CSS 文本。 */
-export declare const aitheGlobalCssText = "\n:root {\n  --aithe-space-0: 0;\n  --aithe-space-1: 4px;\n  --aithe-space-2: 8px;\n  --aithe-space-3: 12px;\n  --aithe-space-4: 16px;\n  --aithe-space-5: 20px;\n  --aithe-space-6: 24px;\n  --aithe-space-7: 32px;\n  --aithe-space-8: 40px;\n  --aithe-space-9: 48px;\n  --aithe-space-10: 64px;\n  --aithe-space-xs: var(--aithe-space-2);\n  --aithe-space-sm: var(--aithe-space-3);\n  --aithe-space-md: var(--aithe-space-4);\n  --aithe-space-lg: var(--aithe-space-6);\n  --aithe-space-xl: var(--aithe-space-8);\n  --aithe-radius-sm: 6px;\n  --aithe-radius-md: 10px;\n  --aithe-radius-lg: 14px;\n  --aithe-radius-xl: 20px;\n  --aithe-radius-full: 999px;\n  --aithe-container-radius-sm: 6px;\n  --aithe-container-radius-md: 10px;\n  --aithe-container-radius-lg: 14px;\n  --aithe-container-radius-xl: 20px;\n  --aithe-container-radius-full: 999px;\n  --aithe-shadow-1: 0 2px 4px rgba(18, 24, 38, 0.1), 0 4px 8px rgba(18, 24, 38, 0.06);\n  --aithe-shadow-2: 0 4px 8px rgba(18, 24, 38, 0.12), 0 8px 16px rgba(18, 24, 38, 0.08);\n  --aithe-shadow-3: 0 6px 12px rgba(18, 24, 38, 0.14), 0 12px 24px rgba(18, 24, 38, 0.1);\n  --aithe-shadow-4: 0 8px 16px rgba(18, 24, 38, 0.16), 0 16px 32px rgba(18, 24, 38, 0.12);\n  --aithe-shadow-5: 0 12px 20px rgba(18, 24, 38, 0.18), 0 20px 40px rgba(18, 24, 38, 0.14);\n  --aithe-shadow-glow: none;\n  --aithe-shadow-inner: inset 0 1px 0 rgba(255, 255, 255, 0.15);\n  --aithe-shadow-blur: 0px;\n  --aithe-shadow-opacity: 1;\n  --aithe-shadow-border-glow: 0px;\n  --aithe-font-family: 'Sora', 'IBM Plex Sans', 'PingFang SC', 'Microsoft YaHei', sans-serif;\n  --aithe-font-family-mono: 'JetBrains Mono', 'SFMono-Regular', 'Consolas', monospace;\n  --aithe-font-size-xs: 12px;\n  --aithe-font-size-sm: 13px;\n  --aithe-font-size-md: 14px;\n  --aithe-font-size-lg: 16px;\n  --aithe-font-size-xl: 20px;\n  --aithe-font-size-2xl: 28px;\n  --aithe-font-weight-regular: 400;\n  --aithe-font-weight-medium: 500;\n  --aithe-font-weight-semibold: 600;\n  --aithe-font-weight-bold: 700;\n  --aithe-line-height-tight: 1.2;\n  --aithe-line-height-base: 1.5;\n  --aithe-line-height-loose: 1.7;\n  --aithe-z-base: 1;\n  --aithe-z-dropdown: 1000;\n  --aithe-z-popover: 1010;\n  --aithe-z-modal: 1080;\n  --aithe-z-drawer: 1090;\n  --aithe-z-tooltip: 1120;\n  --aithe-duration-fast: 140ms;\n  --aithe-duration-base: 220ms;\n  --aithe-duration-slow: 320ms;\n  --aithe-ease-standard: cubic-bezier(0.2, 0.8, 0.2, 1);\n  --aithe-control-height-sm: 32px;\n  --aithe-control-height-md: 40px;\n  --aithe-control-height-lg: 48px;\n}\n\nhtml,\nbody {\n  margin: 0;\n  width: 100%;\n  min-height: 100%;\n  background: var(--aithe-color-bg-subtle);\n  color: var(--aithe-color-text);\n  font-family: var(--aithe-font-family);\n}\n\n*,\n*::before,\n*::after {\n  box-sizing: border-box;\n}\n\n::selection {\n  background: var(--aithe-color-selection);\n}\n";
+export declare const aitheGlobalCssText = "\n:root {\n  --aithe-space-0: 0;\n  --aithe-space-1: 4px;\n  --aithe-space-2: 8px;\n  --aithe-space-3: 12px;\n  --aithe-space-4: 16px;\n  --aithe-space-5: 20px;\n  --aithe-space-6: 24px;\n  --aithe-space-7: 32px;\n  --aithe-space-8: 40px;\n  --aithe-space-9: 48px;\n  --aithe-space-10: 64px;\n  --aithe-space-xs: var(--aithe-space-2);\n  --aithe-space-sm: var(--aithe-space-3);\n  --aithe-space-md: var(--aithe-space-4);\n  --aithe-space-lg: var(--aithe-space-6);\n  --aithe-space-xl: var(--aithe-space-8);\n  --aithe-radius-sm: 6px;\n  --aithe-radius-md: 10px;\n  --aithe-radius-lg: 14px;\n  --aithe-radius-xl: 20px;\n  --aithe-radius-full: 999px;\n  --aithe-container-radius-sm: 6px;\n  --aithe-container-radius-md: 10px;\n  --aithe-container-radius-lg: 14px;\n  --aithe-container-radius-xl: 20px;\n  --aithe-container-radius-full: 999px;\n  --aithe-shadow-1: 0 2px 4px rgba(18, 24, 38, 0.1), 0 4px 8px rgba(18, 24, 38, 0.06);\n  --aithe-shadow-2: 0 4px 8px rgba(18, 24, 38, 0.12), 0 8px 16px rgba(18, 24, 38, 0.08);\n  --aithe-shadow-3: 0 6px 12px rgba(18, 24, 38, 0.14), 0 12px 24px rgba(18, 24, 38, 0.1);\n  --aithe-shadow-4: 0 8px 16px rgba(18, 24, 38, 0.16), 0 16px 32px rgba(18, 24, 38, 0.12);\n  --aithe-shadow-5: 0 12px 20px rgba(18, 24, 38, 0.18), 0 20px 40px rgba(18, 24, 38, 0.14);\n  --aithe-shadow-glow: none;\n  --aithe-shadow-inner: inset 0 1px 0 rgba(255, 255, 255, 0.15);\n  --aithe-shadow-blur: 0px;\n  --aithe-shadow-opacity: 1;\n  --aithe-shadow-border-glow: 0px;\n  --aithe-font-family: 'Sora', 'IBM Plex Sans', 'PingFang SC', 'Microsoft YaHei', sans-serif;\n  --aithe-font-family-mono: 'JetBrains Mono', 'SFMono-Regular', 'Consolas', monospace;\n  --aithe-font-size-xs: 12px;\n  --aithe-font-size-sm: 13px;\n  --aithe-font-size-md: 14px;\n  --aithe-font-size-lg: 16px;\n  --aithe-font-size-xl: 20px;\n  --aithe-font-size-2xl: 28px;\n  --aithe-font-size-base: 14px;\n  --aithe-font-size-3xl: 32px;\n  --aithe-font-size-4xl: 48px;\n  --aithe-font-size-5xl: 64px;\n  --aithe-font-weight-regular: 400;\n  --aithe-font-weight-medium: 500;\n  --aithe-font-weight-semibold: 600;\n  --aithe-font-weight-bold: 700;\n  --aithe-line-height-tight: 1.2;\n  --aithe-line-height-base: 1.5;\n  --aithe-line-height-loose: 1.7;\n  --aithe-z-base: 1;\n  --aithe-z-dropdown: 1000;\n  --aithe-z-popover: 1010;\n  --aithe-z-modal: 1080;\n  --aithe-z-drawer: 1090;\n  --aithe-z-tooltip: 1120;\n  --aithe-duration-fast: 140ms;\n  --aithe-duration-base: 220ms;\n  --aithe-duration-slow: 320ms;\n  --aithe-ease-standard: cubic-bezier(0.2, 0.8, 0.2, 1);\n  --aithe-control-height-sm: 32px;\n  --aithe-control-height-md: 40px;\n  --aithe-control-height-lg: 48px;\n}\n\nhtml,\nbody {\n  margin: 0;\n  width: 100%;\n  min-height: 100%;\n  background: var(--aithe-color-bg-subtle);\n  color: var(--aithe-color-text);\n  font-family: var(--aithe-font-family);\n}\n\n*,\n*::before,\n*::after {\n  box-sizing: border-box;\n}\n\n::selection {\n  background: var(--aithe-color-selection);\n}\n";
 /** Shadow-DOM reset styles applied to every Aithe component host. 应用到每个 Aithe 组件宿主的 Shadow-DOM 重置样式。 */
 export declare const aitheGlobalResetStyles: import("lit").CSSResult;
 //# sourceMappingURL=global.css.d.ts.map

package/dist/styles/global.css.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"global.css.d.ts","sourceRoot":"","sources":["../../src/styles/global.css.ts"],"names":[],"mappings":"AAEA,oIAAoI;AACpI,eAAO,MAAM,kBAAkB,yyFAuF9B,CAAC;AAEF,wGAAwG;AACxG,eAAO,MAAM,sBAAsB,yBAuBlC,CAAC"}
+{"version":3,"file":"global.css.d.ts","sourceRoot":"","sources":["../../src/styles/global.css.ts"],"names":[],"mappings":"AAEA,oIAAoI;AACpI,eAAO,MAAM,kBAAkB,06FA2F9B,CAAC;AAEF,wGAAwG;AACxG,eAAO,MAAM,sBAAsB,yBAuBlC,CAAC"}

package/dist/styles/global.css.js

@@ -0,0 +1,119 @@
+import { css } from 'lit';
+/** Global CSS text for `:root` primitive tokens plus base html/body/selection resets. 用于 `:root` 基础令牌及 html/body/选区重置的全局 CSS 文本。 */
+export const aitheGlobalCssText = `
+:root {
+  --aithe-space-0: 0;
+  --aithe-space-1: 4px;
+  --aithe-space-2: 8px;
+  --aithe-space-3: 12px;
+  --aithe-space-4: 16px;
+  --aithe-space-5: 20px;
+  --aithe-space-6: 24px;
+  --aithe-space-7: 32px;
+  --aithe-space-8: 40px;
+  --aithe-space-9: 48px;
+  --aithe-space-10: 64px;
+  --aithe-space-xs: var(--aithe-space-2);
+  --aithe-space-sm: var(--aithe-space-3);
+  --aithe-space-md: var(--aithe-space-4);
+  --aithe-space-lg: var(--aithe-space-6);
+  --aithe-space-xl: var(--aithe-space-8);
+  --aithe-radius-sm: 6px;
+  --aithe-radius-md: 10px;
+  --aithe-radius-lg: 14px;
+  --aithe-radius-xl: 20px;
+  --aithe-radius-full: 999px;
+  --aithe-container-radius-sm: 6px;
+  --aithe-container-radius-md: 10px;
+  --aithe-container-radius-lg: 14px;
+  --aithe-container-radius-xl: 20px;
+  --aithe-container-radius-full: 999px;
+  --aithe-shadow-1: 0 2px 4px rgba(18, 24, 38, 0.1), 0 4px 8px rgba(18, 24, 38, 0.06);
+  --aithe-shadow-2: 0 4px 8px rgba(18, 24, 38, 0.12), 0 8px 16px rgba(18, 24, 38, 0.08);
+  --aithe-shadow-3: 0 6px 12px rgba(18, 24, 38, 0.14), 0 12px 24px rgba(18, 24, 38, 0.1);
+  --aithe-shadow-4: 0 8px 16px rgba(18, 24, 38, 0.16), 0 16px 32px rgba(18, 24, 38, 0.12);
+  --aithe-shadow-5: 0 12px 20px rgba(18, 24, 38, 0.18), 0 20px 40px rgba(18, 24, 38, 0.14);
+  --aithe-shadow-glow: none;
+  --aithe-shadow-inner: inset 0 1px 0 rgba(255, 255, 255, 0.15);
+  --aithe-shadow-blur: 0px;
+  --aithe-shadow-opacity: 1;
+  --aithe-shadow-border-glow: 0px;
+  --aithe-font-family: 'Sora', 'IBM Plex Sans', 'PingFang SC', 'Microsoft YaHei', sans-serif;
+  --aithe-font-family-mono: 'JetBrains Mono', 'SFMono-Regular', 'Consolas', monospace;
+  --aithe-font-size-xs: 12px;
+  --aithe-font-size-sm: 13px;
+  --aithe-font-size-md: 14px;
+  --aithe-font-size-lg: 16px;
+  --aithe-font-size-xl: 20px;
+  --aithe-font-size-2xl: 28px;
+  --aithe-font-size-base: 14px;
+  --aithe-font-size-3xl: 32px;
+  --aithe-font-size-4xl: 48px;
+  --aithe-font-size-5xl: 64px;
+  --aithe-font-weight-regular: 400;
+  --aithe-font-weight-medium: 500;
+  --aithe-font-weight-semibold: 600;
+  --aithe-font-weight-bold: 700;
+  --aithe-line-height-tight: 1.2;
+  --aithe-line-height-base: 1.5;
+  --aithe-line-height-loose: 1.7;
+  --aithe-z-base: 1;
+  --aithe-z-dropdown: 1000;
+  --aithe-z-popover: 1010;
+  --aithe-z-modal: 1080;
+  --aithe-z-drawer: 1090;
+  --aithe-z-tooltip: 1120;
+  --aithe-duration-fast: 140ms;
+  --aithe-duration-base: 220ms;
+  --aithe-duration-slow: 320ms;
+  --aithe-ease-standard: cubic-bezier(0.2, 0.8, 0.2, 1);
+  --aithe-control-height-sm: 32px;
+  --aithe-control-height-md: 40px;
+  --aithe-control-height-lg: 48px;
+}
+
+html,
+body {
+  margin: 0;
+  width: 100%;
+  min-height: 100%;
+  background: var(--aithe-color-bg-subtle);
+  color: var(--aithe-color-text);
+  font-family: var(--aithe-font-family);
+}
+
+*,
+*::before,
+*::after {
+  box-sizing: border-box;
+}
+
+::selection {
+  background: var(--aithe-color-selection);
+}
+`;
+/** Shadow-DOM reset styles applied to every Aithe component host. 应用到每个 Aithe 组件宿主的 Shadow-DOM 重置样式。 */
+export const aitheGlobalResetStyles = css `
+  :host {
+    box-sizing: border-box;
+    color: var(--aithe-color-text);
+    font-family: var(--aithe-font-family);
+    font-size: var(--aithe-font-size-md);
+    line-height: var(--aithe-line-height-base);
+  }
+
+  *,
+  *::before,
+  *::after {
+    box-sizing: border-box;
+  }
+
+  [hidden] {
+    display: none !important;
+  }
+
+  :focus-visible {
+    outline: 2px solid var(--aithe-color-focus-ring);
+    outline-offset: 2px;
+  }
+`;

package/dist/styles/i18n/index.js

@@ -0,0 +1,206 @@
+/**
+ * Aithe UI 国际化（i18n）核心模块
+ * Core internationalization module for the Aithe UI component library.
+ *
+ * 提供 locale 管理、翻译注册、翻译函数和 locale 变更订阅。
+ * Provides locale management, translation registration, translate function,
+ * and locale change subscription.
+ *
+ * 支持的 locale / Supported locales: en-US, zh-CN, zh-TW, zh-HK, ja-JP, ko-KR, es-ES, pt-BR, fr-FR, de-DE (BCP 47)，可通过 registerAitheLocale 扩展
+ * Supported locales: en-US, zh-CN, zh-TW, zh-HK, ja-JP, ko-KR, es-ES, pt-BR, fr-FR, de-DE (BCP 47), extensible via registerAitheLocale.
+ *
+ * 用法 / Usage:
+ *   - registerAitheLocale()     — 注册完整 locale 翻译映射（替换）/ Register full locale map (replace)
+ *   - registerAitheTranslations() — 合并追加翻译条目（用于应用层）/ Merge additional entries (for app-level)
+ *   - setAitheLocale()          — 切换当前 locale / Switch current locale
+ *   - t()                       — 翻译键值 / Translate key
+ *   - onAitheLocaleChange()     — 订阅 locale 变更 / Subscribe to locale changes
+ */
+import { en } from '../i18n/locales/en-US';
+import { zh } from '../i18n/locales/zh-CN';
+import { zhTw } from '../i18n/locales/zh-TW';
+import { zhHk } from '../i18n/locales/zh-HK';
+import { ja } from '../i18n/locales/ja-JP';
+import { ko } from '../i18n/locales/ko-KR';
+import { es } from '../i18n/locales/es-ES';
+import { ptBr } from '../i18n/locales/pt-BR';
+import { fr } from '../i18n/locales/fr-FR';
+import { de } from '../i18n/locales/de-DE';
+export { en } from './locales/en-US';
+export { zh } from './locales/zh-CN';
+export { zhTw } from './locales/zh-TW';
+export { zhHk } from './locales/zh-HK';
+export { ja } from './locales/ja-JP';
+export { ko } from './locales/ko-KR';
+export { es } from './locales/es-ES';
+export { ptBr } from './locales/pt-BR';
+export { fr } from './locales/fr-FR';
+export { de } from './locales/de-DE';
+export const AITHE_DEFAULT_LOCALE = 'en-US';
+/** Built-in locale display name i18n key mapping. 内置 locale 显示名称 i18n 键映射。 */
+const BUILTIN_LOCALE_LABELS = {
+    'en-US': 'localeSwitch.english',
+    'zh-CN': 'localeSwitch.chinese',
+    'zh-TW': 'localeSwitch.traditionalChinese',
+    'zh-HK': 'localeSwitch.traditionalChinese',
+    'ja-JP': 'localeSwitch.japanese',
+    'ko-KR': 'localeSwitch.korean',
+    'es-ES': 'localeSwitch.spanish',
+    'pt-BR': 'localeSwitch.portuguese',
+    'fr-FR': 'localeSwitch.french',
+    'de-DE': 'localeSwitch.german',
+};
+/**
+ * Static tree menu data for locale selection, compatible with `<aithe-tree-menu>`.
+ * 用于语言选择的静态树形菜单数据，兼容 `<aithe-tree-menu>`。
+ * Each item carries a `label` extension field with the i18n key for display name.
+ * 每个项携带 `label` 扩展字段，包含显示名称的 i18n 键。
+ */
+export const localeMenu = Object.keys(BUILTIN_LOCALE_LABELS).map((locale) => ({
+    id: locale,
+    label: locale,
+    i18n: BUILTIN_LOCALE_LABELS[locale],
+}));
+/** localStorage 存储键 / localStorage key for persisting locale preference */
+const STORAGE_KEY = 'aithe-locale';
+/** 当前 locale / Current active locale */
+let currentLocale = 'en-US';
+/** locale → 翻译映射注册表 / locale → translations registry */
+const localeRegistry = new Map();
+/** locale 变更监听器集合 / Set of locale change listeners */
+const listeners = new Set();
+/**
+ * 从 localStorage 读取已存储的 locale
+ * Load stored locale from localStorage
+ */
+function loadStoredLocale() {
+    try {
+        const raw = localStorage.getItem(STORAGE_KEY);
+        if (!raw)
+            return undefined;
+        return raw;
+    }
+    catch {
+        return undefined;
+    }
+}
+/** 将 locale 持久化到 localStorage / Persist locale to localStorage */
+function storeLocale(locale) {
+    try {
+        localStorage.setItem(STORAGE_KEY, locale);
+    }
+    catch {
+        // ignore
+    }
+}
+/**
+ * 注册完整 locale 翻译映射（替换已有）/ Register full locale translations (replaces existing).
+ * 适用于核心库初始化 / Used for core library initialization.
+ */
+export function registerAitheLocale(locale, translations) {
+    localeRegistry.set(locale, translations);
+}
+/**
+ * 合并追加翻译条目到已有 locale / Merge additional translations into existing locale.
+ * 适用于应用层注册自定义翻译 / Used by apps to register custom translations.
+ */
+export function registerAitheTranslations(locale, translations) {
+    const existing = localeRegistry.get(locale) ?? {};
+    localeRegistry.set(locale, { ...existing, ...translations });
+}
+/** 设置当前 locale 并通知监听器 / Set current locale and notify listeners */
+export function setAitheLocale(locale, persist = true) {
+    if (locale === currentLocale)
+        return;
+    currentLocale = locale;
+    if (persist)
+        storeLocale(locale);
+    document.documentElement.setAttribute('lang', locale);
+    for (const fn of listeners) {
+        fn();
+    }
+}
+/** 获取当前 locale / Get current locale */
+export function getAitheLocale() {
+    return currentLocale;
+}
+/** 获取所有已注册的 locale 列表 / Get all registered locale identifiers */
+export function getAitheLocales() {
+    return [...localeRegistry.keys()];
+}
+/**
+ * 初始化 locale（从 localStorage 恢复或使用默认值）
+ * Initialize locale from localStorage or fall back to defaultLocale.
+ */
+export function initAitheLocale(defaultLocale = AITHE_DEFAULT_LOCALE) {
+    registerAitheLocale('en-US', en);
+    registerAitheLocale('zh-CN', zh);
+    registerAitheLocale('zh-TW', zhTw);
+    registerAitheLocale('zh-HK', zhHk);
+    registerAitheLocale('ja-JP', ja);
+    registerAitheLocale('ko-KR', ko);
+    registerAitheLocale('es-ES', es);
+    registerAitheLocale('pt-BR', ptBr);
+    registerAitheLocale('fr-FR', fr);
+    registerAitheLocale('de-DE', de);
+    const stored = loadStoredLocale();
+    currentLocale = stored || defaultLocale;
+    document.documentElement.setAttribute('lang', currentLocale);
+}
+/**
+ * 翻译函数：根据 key 获取当前 locale 的翻译文本
+ * Translate function: resolve key to translated text in current locale.
+ * 若当前 locale 未注册资源包，则回退到 en-US / Falls back to en-US if current locale has no registered resource pack.
+ * 支持 {key} 占位符插值 / Supports {key} placeholder interpolation.
+ * 当 key 为空时，直接返回缺省值（如有）或空字符串 / When key is empty, returns defaultValue (if provided) or empty string.
+ * 当无法找到翻译值时，如果缺省值有效，则返回缺省值；否则返回 key / Returns defaultValue if provided and no translation found; otherwise returns key.
+ */
+function resolveTranslation(dict, key, params) {
+    if (!dict)
+        return undefined;
+    const value = dict[key];
+    if (value === undefined)
+        return undefined;
+    if (params) {
+        // eslint-disable-next-line prefer-replace-all
+        return value.replace(/\{(\w+)\}/g, (_, name) => {
+            const v = params[name];
+            return v === undefined ? `{${name}}` : String(v);
+        });
+    }
+    return value;
+}
+function isValidDefault(v) {
+    return v !== undefined && v !== '';
+}
+export function t(key, dft, params) {
+    if (!key)
+        return isValidDefault(dft) ? dft : '';
+    const result = resolveTranslation(localeRegistry.get(currentLocale), key, params);
+    if (result !== undefined)
+        return result;
+    const enResult = resolveTranslation(localeRegistry.get(AITHE_DEFAULT_LOCALE), key, params);
+    if (enResult !== undefined)
+        return enResult;
+    return isValidDefault(dft) ? dft : key;
+}
+/**
+ * 翻译 AitheTreeNodeMeta 的 label 字段。
+ * Translate the label of an AitheTreeNodeMeta node.
+ * 如果节点的 i18n 字段有效（非空字符串），则使用 t(i18n, label) 翻译，label 作为缺省值；
+ * 否则 t('', label) 直接返回 label。
+ * If the node's i18n field is valid (non-empty string), translates via t(i18n, label) with label as default;
+ * otherwise t('', label) returns label directly.
+ */
+export function translateNodeLabel(node) {
+    const i18nKey = typeof node.i18n === 'string' ? node.i18n : '';
+    return t(i18nKey, node.label);
+}
+/**
+ * 订阅 locale 变更事件 / Subscribe to locale changes.
+ * 返回取消订阅函数 / Returns unsubscribe function.
+ */
+export function onAitheLocaleChange(fn) {
+    listeners.add(fn);
+    return () => listeners.delete(fn);
+}

package/dist/styles/i18n/locales/de-DE.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"de-DE.d.ts","sourceRoot":"","sources":["../../../../src/styles/i18n/locales/de-DE.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,EAAE,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CA8IrC,CAAC"}
+{"version":3,"file":"de-DE.d.ts","sourceRoot":"","sources":["../../../../src/styles/i18n/locales/de-DE.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,EAAE,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAkJrC,CAAC"}