@aithe/aithe-ui 26.2.3 → 26.3.1

package/dist/styles/i18n/locales/zh-HK.js

@@ -0,0 +1,148 @@
+/**
+ * Aithe UI 核心繁體中文（香港）翻譯資源
+ * Core Traditional Chinese (zh-HK) translation resource for Aithe UI components.
+ */
+export const zhHk = {
+    'basic.input.ariaLabel': '輸入框',
+    'basic.avatar.ariaLabel': '頭像',
+    'basic.empty.defaultText': '暫無資料',
+    'navigation.breadcrumb.ariaLabel': '麵包屑',
+    'navigation.backTop.ariaLabel': '回到頂部',
+    'form.select.placeholder': '請選擇',
+    'form.select.searchAriaLabel': '搜尋選項',
+    'form.select.searchPlaceholder': '搜尋選項',
+    'form.select.clearAriaLabel': '清除',
+    'form.select.emptyText': '暫無匹配項',
+    'form.combobox.placeholder': '搜尋或選擇',
+    'form.combobox.emptyText': '暫無匹配項',
+    'form.dialog.confirmText': '確認',
+    'form.dialog.cancelText': '取消',
+    'form.dialog.closeAriaLabel': '關閉',
+    'form.rate.ariaLabel': '評分 {index}',
+    'form.upload.chooseFiles': '選擇檔案',
+    'form.upload.kb': 'KB',
+    'form.transfer.sourceTitle': '來源列表',
+    'form.transfer.targetTitle': '目標列表',
+    'form.formItem.required': '{label}為必填項',
+    'form.formItem.requiredField': '欄位',
+    'form.autoform.submit': '提交',
+    'form.autoform.patternMismatch': '格式不符',
+    'feedback.modal.closeAriaLabel': '關閉彈窗',
+    'feedback.drawer.closeAriaLabel': '關閉抽屜',
+    'data.tabs.removeTabAriaLabel': '移除標籤頁',
+    'data.tabs.addTabAriaLabel': '新增標籤頁',
+    'data.tabs.moreTabsAriaLabel': '更多標籤頁',
+    'data.table.selectAllAriaLabel': '全選',
+    'data.table.selectRowAriaLabel': '選擇列',
+    'data.table.emptyText': '暫無資料',
+    'display.carousel.prevSlideAriaLabel': '上一張',
+    'display.carousel.nextSlideAriaLabel': '下一張',
+    'display.comparison.beforeAlt': '之前',
+    'display.comparison.afterAlt': '之後',
+    'container.details.defaultSummary': '詳情',
+    'theme.light': '淺色',
+    'theme.dark': '深色',
+    'theme.gray': '灰色',
+    'theme.blue': '藍色',
+    'theme.festive': '喜慶',
+    'theme.orange': '橙色',
+    'theme.purple': '紫色',
+    'theme.pink': '粉色',
+    'theme.teal': '青色',
+    'theme.indigo': '靛藍',
+    'theme.cyan': '天藍',
+    'theme.amber': '琥珀',
+    'theme.slate': '石板',
+    'theme.charcoal': '木炭',
+    'theme.midnight': '午夜',
+    'theme.obsidian': '黑曜石',
+    'theme.graphite': '石墨',
+    'theme.ink': '墨水',
+    'theme.onyx': '縞瑪瑙',
+    'theme.ebony': '烏木',
+    'theme.navy': '海軍藍',
+    'theme.raisin': '葡萄乾',
+    'theme.huawei': '華為雲',
+    'theme.aliyun': '阿里雲',
+    'theme.tianyi': '天翼雲',
+    'theme.preview.title': '主題預覽',
+    'theme.preview.applyTheme': '套用主題',
+    'theme.preview.dashboard': '儀表板',
+    'theme.preview.components': '元件',
+    'theme.preview.themes': '主題',
+    'theme.preview.settings': '設定',
+    'theme.preview.buttons': '按鈕',
+    'theme.preview.input': '輸入框',
+    'theme.preview.tags': '標籤',
+    'theme.preview.table': '表格',
+    'theme.preview.primary': '主要',
+    'theme.preview.default': '預設',
+    'theme.preview.dashed': '虛線',
+    'theme.preview.text': '文字',
+    'theme.preview.link': '連結',
+    'theme.preview.danger': '危險',
+    'theme.preview.enterText': '請輸入文字...',
+    'theme.preview.search': '搜尋...',
+    'theme.preview.brand': 'Aithe UI',
+    'theme.preview.success': '成功',
+    'theme.preview.warning': '警告',
+    'theme.preview.name': '姓名',
+    'theme.preview.role': '角色',
+    'theme.preview.status': '狀態',
+    'theme.preview.admin': '管理員',
+    'theme.preview.editor': '編輯者',
+    'theme.preview.viewer': '檢視者',
+    'theme.preview.active': '活躍',
+    'theme.preview.inactive': '未啟用',
+    'localeSwitch.label': '語言',
+    'localeSwitch.english': 'English',
+    'localeSwitch.chinese': '中文',
+    'localeSwitch.traditionalChinese': '繁體中文',
+    'localeSwitch.japanese': '日本語',
+    'localeSwitch.korean': '한국어',
+    'localeSwitch.spanish': 'Español',
+    'localeSwitch.portuguese': 'Português',
+    'localeSwitch.french': 'Français',
+    'localeSwitch.german': 'Deutsch',
+    'body.backTop': '回到頂部',
+    'body.switchLayout': '切換佈局',
+    'body.layout.compact': '緊湊',
+    'body.layout.medium': '適中',
+    'body.layout.wide': '寬鬆',
+    'sidebar.collapse': '收起側邊欄',
+    'sidebar.expand': '展開側邊欄',
+    'shapePicker.sharp': '直角',
+    'shapePicker.smooth': '微圓角',
+    'shapePicker.rounded': '標準圓角',
+    'shapePicker.rounder': '大圓角',
+    'shapePicker.pill': '膠囊',
+    'shapePicker.circle': '圓形',
+    'shapePicker.chamfer': '斜切角',
+    'shapePicker.organic': '有機曲線',
+    'shadowPicker.flat': '扁平極簡',
+    'shadowPicker.neumorphism': '新擬態',
+    'shadowPicker.skeuomorphic': '輕擬物',
+    'shadowPicker.glassmorphism': '玻璃擬態',
+    'shadowPicker.cyber': '賽博發光',
+    'shadowPicker.deep': '深邃暗黑',
+    'shadowPicker.diffuse': '柔和彌散',
+    'shadowPicker.sharpBusiness': '硬朗商務',
+    'shadowPicker.retro': '復古膠片',
+    'typoPicker.minimal': '極簡',
+    'typoPicker.business': '商務',
+    'typoPicker.luxury': '輕奢',
+    'typoPicker.compact': '緊湊資訊流',
+    'appearance.label': '外觀',
+    'appearance.group.theme': '主題',
+    'appearance.group.shadow': '陰影',
+    'appearance.group.shape': '形狀',
+    'appearance.group.typo': '排版',
+    'display.codeEditor.hideLineNumbers': '隱藏行號',
+    'display.codeEditor.showLineNumbers': '顯示行號',
+    'display.codeEditor.hidePreview': '隱藏預覽',
+    'display.codeEditor.showPreview': '顯示預覽',
+    'display.codeEditor.copied': '已複製!',
+    'display.codeEditor.copyCode': '複製代碼',
+    'display.codeEditor.exitFullscreen': '退出全屏',
+    'display.codeEditor.fullscreen': '全屏',
+};

package/dist/styles/i18n/locales/zh-TW.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"zh-TW.d.ts","sourceRoot":"","sources":["../../../../src/styles/i18n/locales/zh-TW.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CA8IvC,CAAC"}
+{"version":3,"file":"zh-TW.d.ts","sourceRoot":"","sources":["../../../../src/styles/i18n/locales/zh-TW.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CA+IvC,CAAC"}

package/dist/styles/i18n/locales/zh-TW.js

@@ -0,0 +1,148 @@
+/**
+ * Aithe UI 核心繁體中文（台灣）翻譯資源
+ * Core Traditional Chinese (zh-TW) translation resource for Aithe UI components.
+ */
+export const zhTw = {
+    'basic.input.ariaLabel': '輸入框',
+    'basic.avatar.ariaLabel': '頭像',
+    'basic.empty.defaultText': '暫無資料',
+    'navigation.breadcrumb.ariaLabel': '麵包屑',
+    'navigation.backTop.ariaLabel': '回到頂部',
+    'form.select.placeholder': '請選擇',
+    'form.select.searchAriaLabel': '搜尋選項',
+    'form.select.searchPlaceholder': '搜尋選項',
+    'form.select.clearAriaLabel': '清除',
+    'form.select.emptyText': '暫無匹配項',
+    'form.combobox.placeholder': '搜尋或選擇',
+    'form.combobox.emptyText': '暫無匹配項',
+    'form.dialog.confirmText': '確認',
+    'form.dialog.cancelText': '取消',
+    'form.dialog.closeAriaLabel': '關閉',
+    'form.rate.ariaLabel': '評分 {index}',
+    'form.upload.chooseFiles': '選擇檔案',
+    'form.upload.kb': 'KB',
+    'form.transfer.sourceTitle': '來源列表',
+    'form.transfer.targetTitle': '目標列表',
+    'form.formItem.required': '{label}為必填項',
+    'form.formItem.requiredField': '欄位',
+    'form.autoform.submit': '提交',
+    'form.autoform.patternMismatch': '格式不符',
+    'feedback.modal.closeAriaLabel': '關閉彈窗',
+    'feedback.drawer.closeAriaLabel': '關閉抽屜',
+    'data.tabs.removeTabAriaLabel': '移除標籤頁',
+    'data.tabs.addTabAriaLabel': '新增標籤頁',
+    'data.tabs.moreTabsAriaLabel': '更多標籤頁',
+    'data.table.selectAllAriaLabel': '全選',
+    'data.table.selectRowAriaLabel': '選擇列',
+    'data.table.emptyText': '暫無資料',
+    'display.carousel.prevSlideAriaLabel': '上一張',
+    'display.carousel.nextSlideAriaLabel': '下一張',
+    'display.comparison.beforeAlt': '之前',
+    'display.comparison.afterAlt': '之後',
+    'container.details.defaultSummary': '詳情',
+    'theme.light': '淺色',
+    'theme.dark': '深色',
+    'theme.gray': '灰色',
+    'theme.blue': '藍色',
+    'theme.festive': '喜慶',
+    'theme.orange': '橙色',
+    'theme.purple': '紫色',
+    'theme.pink': '粉色',
+    'theme.teal': '青色',
+    'theme.indigo': '靛藍',
+    'theme.cyan': '天藍',
+    'theme.amber': '琥珀',
+    'theme.slate': '石板',
+    'theme.charcoal': '木炭',
+    'theme.midnight': '午夜',
+    'theme.obsidian': '黑曜石',
+    'theme.graphite': '石墨',
+    'theme.ink': '墨水',
+    'theme.onyx': '縞瑪瑙',
+    'theme.ebony': '烏木',
+    'theme.navy': '海軍藍',
+    'theme.raisin': '葡萄乾',
+    'theme.huawei': '華為雲',
+    'theme.aliyun': '阿里雲',
+    'theme.tianyi': '天翼雲',
+    'theme.preview.title': '主題預覽',
+    'theme.preview.applyTheme': '套用主題',
+    'theme.preview.dashboard': '儀表板',
+    'theme.preview.components': '元件',
+    'theme.preview.themes': '主題',
+    'theme.preview.settings': '設定',
+    'theme.preview.buttons': '按鈕',
+    'theme.preview.input': '輸入框',
+    'theme.preview.tags': '標籤',
+    'theme.preview.table': '表格',
+    'theme.preview.primary': '主要',
+    'theme.preview.default': '預設',
+    'theme.preview.dashed': '虛線',
+    'theme.preview.text': '文字',
+    'theme.preview.link': '連結',
+    'theme.preview.danger': '危險',
+    'theme.preview.enterText': '請輸入文字...',
+    'theme.preview.search': '搜尋...',
+    'theme.preview.brand': 'Aithe UI',
+    'theme.preview.success': '成功',
+    'theme.preview.warning': '警告',
+    'theme.preview.name': '姓名',
+    'theme.preview.role': '角色',
+    'theme.preview.status': '狀態',
+    'theme.preview.admin': '管理員',
+    'theme.preview.editor': '編輯者',
+    'theme.preview.viewer': '檢視者',
+    'theme.preview.active': '活躍',
+    'theme.preview.inactive': '未啟用',
+    'localeSwitch.label': '語言',
+    'localeSwitch.english': 'English',
+    'localeSwitch.chinese': '中文',
+    'localeSwitch.traditionalChinese': '繁體中文',
+    'localeSwitch.japanese': '日本語',
+    'localeSwitch.korean': '한국어',
+    'localeSwitch.spanish': 'Español',
+    'localeSwitch.portuguese': 'Português',
+    'localeSwitch.french': 'Français',
+    'localeSwitch.german': 'Deutsch',
+    'body.backTop': '回到頂部',
+    'body.switchLayout': '切換佈局',
+    'body.layout.compact': '緊湊',
+    'body.layout.medium': '適中',
+    'body.layout.wide': '寬鬆',
+    'sidebar.collapse': '收起側邊欄',
+    'sidebar.expand': '展開側邊欄',
+    'shapePicker.sharp': '直角',
+    'shapePicker.smooth': '微圓角',
+    'shapePicker.rounded': '標準圓角',
+    'shapePicker.rounder': '大圓角',
+    'shapePicker.pill': '膠囊',
+    'shapePicker.circle': '圓形',
+    'shapePicker.chamfer': '斜切角',
+    'shapePicker.organic': '有機曲線',
+    'shadowPicker.flat': '扁平極簡',
+    'shadowPicker.neumorphism': '新擬態',
+    'shadowPicker.skeuomorphic': '輕擬物',
+    'shadowPicker.glassmorphism': '玻璃擬態',
+    'shadowPicker.cyber': '賽博發光',
+    'shadowPicker.deep': '深邃暗黑',
+    'shadowPicker.diffuse': '柔和彌散',
+    'shadowPicker.sharpBusiness': '硬朗商務',
+    'shadowPicker.retro': '復古膠片',
+    'typoPicker.minimal': '極簡',
+    'typoPicker.business': '商務',
+    'typoPicker.luxury': '輕奢',
+    'typoPicker.compact': '緊湊資訊流',
+    'appearance.label': '外觀',
+    'appearance.group.theme': '主題',
+    'appearance.group.shadow': '陰影',
+    'appearance.group.shape': '形狀',
+    'appearance.group.typo': '排版',
+    'display.codeEditor.hideLineNumbers': '隱藏行號',
+    'display.codeEditor.showLineNumbers': '顯示行號',
+    'display.codeEditor.hidePreview': '隱藏預覽',
+    'display.codeEditor.showPreview': '顯示預覽',
+    'display.codeEditor.copied': '已複製!',
+    'display.codeEditor.copyCode': '複製代碼',
+    'display.codeEditor.exitFullscreen': '退出全屏',
+    'display.codeEditor.fullscreen': '全屏',
+};

package/dist/styles/layout/index.js

@@ -0,0 +1,88 @@
+/** localStorage key for persisting the selected layout density. 用于持久化所选布局密度的 localStorage 键名。 */
+const STORAGE_KEY = 'aithe-layout';
+/** Default layout density name. 默认布局密度名称。 */
+export const AITHE_DEFAULT_LAYOUT = 'medium';
+/** Current active layout density. 当前激活的布局密度。 */
+let currentLayout = AITHE_DEFAULT_LAYOUT;
+/** Set of listener functions for layout density changes. 布局密度变更监听函数集合。 */
+const listeners = new Set();
+/**
+ * Load the previously persisted layout density from localStorage.
+ * 从 localStorage 加载之前持久化的布局密度。
+ *
+ * @returns Stored layout name, or `undefined` if none. 存储的布局名称，若无则返回 `undefined`。
+ */
+function loadStoredLayout() {
+    try {
+        const raw = localStorage.getItem(STORAGE_KEY);
+        if (!raw)
+            return undefined;
+        return raw;
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Persist the layout density name to localStorage.
+ * 将布局密度名称持久化到 localStorage。
+ *
+ * @param layout - Layout density name to persist. 要持久化的布局密度名称。
+ */
+function storeLayout(layout) {
+    try {
+        localStorage.setItem(STORAGE_KEY, layout);
+    }
+    catch {
+        // ignore
+    }
+}
+/**
+ * Set the global layout density and optionally persist to localStorage.
+ * 设置全局布局密度，可选持久化到 localStorage。
+ *
+ * @param layout  - Layout density name to apply. 要应用的布局密度名称。
+ * @param persist - Whether to save to localStorage. Defaults to `true`. 是否保存到 localStorage，默认为 `true`。
+ */
+export function setAitheLayout(layout, persist = true) {
+    if (layout === currentLayout)
+        return;
+    currentLayout = layout;
+    if (persist)
+        storeLayout(layout);
+    document.documentElement.dataset.aitheLayout = layout;
+    for (const fn of listeners) {
+        fn();
+    }
+}
+/**
+ * Get the current global layout density.
+ * 获取当前全局布局密度。
+ *
+ * @returns Current layout density name. 当前布局密度名称。
+ */
+export function getAitheLayout() {
+    return currentLayout;
+}
+/**
+ * Initialize the layout subsystem: load stored preference and apply layout.
+ * 初始化布局子系统：加载存储的偏好并应用布局。
+ *
+ * @param defaultLayout - Fallback layout when no stored preference exists. Defaults to `AITHE_DEFAULT_LAYOUT`. 无存储偏好时的回退布局，默认为 `AITHE_DEFAULT_LAYOUT`。
+ */
+export function initAitheLayout(defaultLayout = AITHE_DEFAULT_LAYOUT) {
+    const stored = loadStoredLayout();
+    currentLayout = stored || defaultLayout;
+    document.documentElement.dataset.aitheLayout = currentLayout;
+}
+/**
+ * Subscribe to layout density changes. Returns an unsubscribe function.
+ * 订阅布局密度变更，返回取消订阅函数。
+ *
+ * @param fn - Callback function invoked when layout changes. 布局变更时调用的回调函数。
+ * @returns Unsubscribe function. 取消订阅函数。
+ */
+export function onAitheLayoutChange(fn) {
+    listeners.add(fn);
+    return () => listeners.delete(fn);
+}

package/dist/styles/mixins.js

@@ -0,0 +1,43 @@
+import { css } from 'lit';
+/** Primitive design tokens (spacing, radius, shadow, typography, z-index, duration, control heights) scoped to `:host`. 作用域为 `:host` 的基础设计令牌（间距、圆角、阴影、排版、z-index、时长、控件高度）。 */
+export const aithePrimitiveTokens = css `
+  :host {
+    --aithe-font-family: 'Sora', 'IBM Plex Sans', 'PingFang SC', 'Microsoft YaHei', sans-serif;
+    --aithe-font-family-mono: 'JetBrains Mono', 'SFMono-Regular', 'Consolas', monospace;
+    --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);
+  }
+`;
+/** Panel surface styles (background, border, radius, shadow, backdrop-filter). 面板表面样式（背景、边框、圆角、阴影、背景滤镜）。 */
+export const aitheSurfaceStyles = css `
+  background: var(--aithe-color-surface-elevated);
+  border: 1px solid var(--aithe-color-border);
+  border-radius: var(--aithe-container-radius-lg);
+  box-shadow: var(--aithe-shadow-2);
+  backdrop-filter: blur(16px);
+`;
+/** Base styles for interactive controls (border, radius, background, color, transitions). 交互控件的基础样式（边框、圆角、背景、颜色、过渡）。 */
+export const aitheControlStyles = css `
+  border: 1px solid var(--aithe-color-border);
+  border-radius: var(--aithe-radius-md);
+  background: var(--aithe-color-surface-elevated);
+  color: var(--aithe-color-text);
+  transition:
+    border-color var(--aithe-duration-fast) var(--aithe-ease-standard),
+    box-shadow var(--aithe-duration-fast) var(--aithe-ease-standard),
+    background var(--aithe-duration-fast) var(--aithe-ease-standard),
+    color var(--aithe-duration-fast) var(--aithe-ease-standard);
+`;
+/** Focus ring styles for interactive controls (border-color + box-shadow). 交互控件的聚焦环样式（边框颜色 + box-shadow）。 */
+export const aitheControlFocusStyles = css `
+  border-color: var(--aithe-primary-5);
+  box-shadow: 0 0 0 4px var(--aithe-color-focus-ring);
+`;

package/dist/styles/shadow/cyber.js

@@ -0,0 +1,19 @@
+/**
+ * Cyber shadow style tokens.
+ * 赛博朋克阴影风格令牌。
+ *
+ * Provides glowing neon shadows with a futuristic, tech-inspired aesthetic.
+ * 提供霓虹光晕阴影，营造未来科技感。
+ */
+export const cyberShadowTokens = {
+    '--aithe-shadow-1': '0 2px 8px rgba(0, 0, 0, 0.25), 0 0 8px var(--aithe-primary-6, rgba(77, 141, 255, 0.15))',
+    '--aithe-shadow-2': '0 4px 12px rgba(0, 0, 0, 0.3), 0 0 12px var(--aithe-primary-6, rgba(77, 141, 255, 0.2))',
+    '--aithe-shadow-3': '0 6px 16px rgba(0, 0, 0, 0.35), 0 0 18px var(--aithe-primary-6, rgba(77, 141, 255, 0.24))',
+    '--aithe-shadow-4': '0 8px 20px rgba(0, 0, 0, 0.4), 0 0 24px var(--aithe-primary-6, rgba(77, 141, 255, 0.28))',
+    '--aithe-shadow-5': '0 10px 24px rgba(0, 0, 0, 0.45), 0 0 30px var(--aithe-primary-6, rgba(77, 141, 255, 0.3))',
+    '--aithe-shadow-glow': '0 0 8px var(--aithe-primary-6, rgba(77, 141, 255, 0.2))',
+    '--aithe-shadow-inner': 'none',
+    '--aithe-shadow-blur': '0px',
+    '--aithe-shadow-opacity': '1',
+    '--aithe-shadow-border-glow': '1px',
+};

package/dist/styles/shadow/deep.js

@@ -0,0 +1,19 @@
+/**
+ * Deep shadow style tokens.
+ * 深度阴影风格令牌。
+ *
+ * Provides dramatic, high-contrast shadows with a sense of depth.
+ * 提供戏剧性、高对比度的阴影，营造深邃感。
+ */
+export const deepShadowTokens = {
+    '--aithe-shadow-1': '0 6px 16px rgba(0, 0, 0, 0.28)',
+    '--aithe-shadow-2': '0 10px 28px rgba(0, 0, 0, 0.35)',
+    '--aithe-shadow-3': '0 16px 40px rgba(0, 0, 0, 0.42)',
+    '--aithe-shadow-4': '0 22px 52px rgba(0, 0, 0, 0.5)',
+    '--aithe-shadow-5': '0 28px 64px rgba(0, 0, 0, 0.58)',
+    '--aithe-shadow-glow': 'none',
+    '--aithe-shadow-inner': 'inset 0 2px 6px rgba(0, 0, 0, 0.2)',
+    '--aithe-shadow-blur': '0px',
+    '--aithe-shadow-opacity': '1',
+    '--aithe-shadow-border-glow': '0px',
+};

package/dist/styles/shadow/diffuse.js

@@ -0,0 +1,19 @@
+/**
+ * Diffuse shadow style tokens.
+ * 漫射阴影风格令牌。
+ *
+ * Provides wide, soft shadows with a gentle, ambient appearance.
+ * 提供宽阔、柔和的阴影，营造轻盈的氛围感。
+ */
+export const diffuseShadowTokens = {
+    '--aithe-shadow-1': '0 4px 24px rgba(18, 24, 38, 0.1)',
+    '--aithe-shadow-2': '0 8px 36px rgba(18, 24, 38, 0.12)',
+    '--aithe-shadow-3': '0 14px 48px rgba(18, 24, 38, 0.15)',
+    '--aithe-shadow-4': '0 20px 60px rgba(18, 24, 38, 0.18)',
+    '--aithe-shadow-5': '0 28px 72px rgba(18, 24, 38, 0.22)',
+    '--aithe-shadow-glow': 'none',
+    '--aithe-shadow-inner': 'none',
+    '--aithe-shadow-blur': '0px',
+    '--aithe-shadow-opacity': '1',
+    '--aithe-shadow-border-glow': '0px',
+};

package/dist/styles/shadow/flat.js

@@ -0,0 +1,19 @@
+/**
+ * Flat shadow style tokens.
+ * 平坦阴影风格令牌。
+ *
+ * Provides minimal, subtle shadows with no elevation effect.
+ * 提供最小化、细腻的阴影，无立体感。
+ */
+export const flatShadowTokens = {
+    '--aithe-shadow-1': '0 1px 2px rgba(18, 24, 38, 0.02)',
+    '--aithe-shadow-2': '0 1px 2px rgba(18, 24, 38, 0.03)',
+    '--aithe-shadow-3': '0 1px 2px rgba(18, 24, 38, 0.03)',
+    '--aithe-shadow-4': '0 1px 2px rgba(18, 24, 38, 0.03)',
+    '--aithe-shadow-5': '0 1px 2px rgba(18, 24, 38, 0.03)',
+    '--aithe-shadow-glow': 'none',
+    '--aithe-shadow-inner': 'none',
+    '--aithe-shadow-blur': '0px',
+    '--aithe-shadow-opacity': '1',
+    '--aithe-shadow-border-glow': '0px',
+};

package/dist/styles/shadow/glassmorphism.js

@@ -0,0 +1,19 @@
+/**
+ * Glassmorphism shadow style tokens.
+ * 玻璃拟态阴影风格令牌。
+ *
+ * Provides soft, diffused shadows with subtle blur for a frosted glass effect.
+ * 提供柔和、模糊的阴影，营造磨砂玻璃质感。
+ */
+export const glassmorphismShadowTokens = {
+    '--aithe-shadow-1': '0 4px 16px rgba(18, 24, 38, 0.12), 0 0 1px rgba(255, 255, 255, 0.3)',
+    '--aithe-shadow-2': '0 8px 24px rgba(18, 24, 38, 0.14), 0 0 1px rgba(255, 255, 255, 0.3)',
+    '--aithe-shadow-3': '0 12px 32px rgba(18, 24, 38, 0.18), 0 0 1px rgba(255, 255, 255, 0.3)',
+    '--aithe-shadow-4': '0 16px 40px rgba(18, 24, 38, 0.22), 0 0 1px rgba(255, 255, 255, 0.3)',
+    '--aithe-shadow-5': '0 20px 48px rgba(18, 24, 38, 0.26), 0 0 1px rgba(255, 255, 255, 0.3)',
+    '--aithe-shadow-glow': 'none',
+    '--aithe-shadow-inner': 'none',
+    '--aithe-shadow-blur': '20px',
+    '--aithe-shadow-opacity': '0.7',
+    '--aithe-shadow-border-glow': '0px',
+};

package/dist/styles/shadow/index.js

@@ -0,0 +1,129 @@
+export { flatShadowTokens } from './flat';
+export { neumorphismShadowTokens } from './neumorphism';
+export { skeuomorphicShadowTokens } from './skeuomorphic';
+export { glassmorphismShadowTokens } from './glassmorphism';
+export { cyberShadowTokens } from './cyber';
+export { deepShadowTokens } from './deep';
+export { diffuseShadowTokens } from './diffuse';
+export { sharpBusinessShadowTokens } from './sharp-business';
+export { retroShadowTokens } from './retro';
+import { flatShadowTokens } from './flat';
+import { neumorphismShadowTokens } from './neumorphism';
+import { skeuomorphicShadowTokens } from './skeuomorphic';
+import { glassmorphismShadowTokens } from './glassmorphism';
+import { cyberShadowTokens } from './cyber';
+import { deepShadowTokens } from './deep';
+import { diffuseShadowTokens } from './diffuse';
+import { sharpBusinessShadowTokens } from './sharp-business';
+import { retroShadowTokens } from './retro';
+/** Map of all built-in shadow style names to their CSS variable token maps. 所有内置阴影风格名称到其 CSS 变量 token 映射的映射表。 */
+const SHADOW_TOKENS = {
+    flat: flatShadowTokens,
+    neumorphism: neumorphismShadowTokens,
+    skeuomorphic: skeuomorphicShadowTokens,
+    glassmorphism: glassmorphismShadowTokens,
+    cyber: cyberShadowTokens,
+    deep: deepShadowTokens,
+    diffuse: diffuseShadowTokens,
+    'sharp-business': sharpBusinessShadowTokens,
+    retro: retroShadowTokens,
+};
+/** Preview icon characters for each built-in shadow style. 每个内置阴影风格的预览图标字符。 */
+const SHADOW_ICONS = {
+    flat: '▭',
+    neumorphism: '◧',
+    skeuomorphic: '▣',
+    glassmorphism: '◈',
+    cyber: '⬡',
+    deep: '⬢',
+    diffuse: '○',
+    'sharp-business': '▬',
+    retro: '▢',
+};
+/**
+ * Static tree menu data for shadow selection, compatible with `<aithe-tree-menu>`.
+ * 用于阴影选择的静态树形菜单数据，兼容 `<aithe-tree-menu>`。
+ * Each item carries an `icon` extension field with the preview character.
+ * 每个项携带 `icon` 扩展字段，包含预览字符。
+ */
+export const shadowMenu = Object.keys(SHADOW_TOKENS).map((shadow) => ({
+    id: shadow,
+    label: shadow === 'sharp-business' ? 'Sharp Business' : shadow.charAt(0).toUpperCase() + shadow.slice(1),
+    icon: SHADOW_ICONS[shadow],
+    i18n: `shadowPicker.${shadow === 'sharp-business' ? 'sharpBusiness' : shadow}`,
+}));
+/** localStorage key for persisting the selected shadow style. 用于持久化所选阴影风格的 localStorage 键名。 */
+const STORAGE_KEY = 'aithe-shadow';
+/** Default shadow style name. 默认阴影风格名称。 */
+export const AITHE_DEFAULT_SHADOW = 'skeuomorphic';
+/** Current active shadow style. 当前激活的阴影风格。 */
+let currentShadow = AITHE_DEFAULT_SHADOW;
+/** Set of listener functions for shadow style changes. 阴影风格变更监听函数集合。 */
+const listeners = new Set();
+/** Get the CSS variable token map for a given shadow style. 获取指定阴影风格的 CSS 变量 token 映射。 */
+export function getShadowTokens(shadow) {
+    return SHADOW_TOKENS[shadow];
+}
+/** Get the list of all built-in shadow style names. 获取所有内置阴影风格名称列表。 */
+export function getAitheShadows() {
+    return Object.keys(SHADOW_TOKENS);
+}
+/** Load the previously persisted shadow style from localStorage. 从 localStorage 加载之前持久化的阴影风格。 */
+function loadStoredShadow() {
+    try {
+        const raw = localStorage.getItem(STORAGE_KEY);
+        if (!raw)
+            return undefined;
+        return raw;
+    }
+    catch {
+        return undefined;
+    }
+}
+/** Persist the shadow style name to localStorage. 将阴影风格名称持久化到 localStorage。 */
+function storeShadow(shadow) {
+    try {
+        localStorage.setItem(STORAGE_KEY, shadow);
+    }
+    catch {
+        // ignore
+    }
+}
+/** Apply shadow CSS variable tokens to the document root and body. 将阴影 CSS 变量 token 应用到文档根元素和 body。 */
+function applyShadowTokens(shadow) {
+    const tokens = SHADOW_TOKENS[shadow];
+    if (!tokens)
+        return;
+    const html = document.documentElement;
+    const body = document.body;
+    for (const [key, value] of Object.entries(tokens)) {
+        html.style.setProperty(key, value);
+        body.style.setProperty(key, value);
+    }
+    html.dataset.aitheShadow = shadow;
+}
+export function setAitheShadow(shadow, persist = true) {
+    if (shadow === currentShadow)
+        return;
+    currentShadow = shadow;
+    if (persist)
+        storeShadow(shadow);
+    document.documentElement.dataset.aitheShadow = shadow;
+    applyShadowTokens(shadow);
+    for (const fn of listeners) {
+        fn();
+    }
+}
+export function getAitheShadow() {
+    return currentShadow;
+}
+export function initAitheShadow(defaultShadow = AITHE_DEFAULT_SHADOW) {
+    const stored = loadStoredShadow();
+    currentShadow = stored || defaultShadow;
+    document.documentElement.dataset.aitheShadow = currentShadow;
+    applyShadowTokens(currentShadow);
+}
+export function onAitheShadowChange(fn) {
+    listeners.add(fn);
+    return () => listeners.delete(fn);
+}