@gyyxds/zy-ui 0.0.3 → 0.1.0

package/dist/zy-ui/select/ZySelect.vue.d.ts

@@ -1,22 +1,41 @@
+import type { ZyTreeNode, ZyTreeProps } from './types';
 type __VLS_Props = {
-    /** 承载的聚焦动效：focus 聚焦光环 / underline 下划线扫过 / gradient 渐变光晕 */
-    effect?: 'focus' | 'underline' | 'gradient';
+    /** 承载的聚焦动效：focus 聚焦光环 / underline 下划线扫过 */
+    effect?: 'focus' | 'underline';
     /** 实色主题下的键帽凸起形态；基础主题不改变外观 */
     raised?: boolean;
     size?: 'large' | 'default' | 'small';
     placeholder?: string;
     clearable?: boolean;
     disabled?: boolean;
+    /** 树形选择：用 data / treeProps / nodeKey 渲染树，multiple 时默认显示复选框 */
+    tree?: boolean;
+    /** 树数据 */
+    data?: ZyTreeNode[];
+    /** 树节点字段映射，默认 { label: 'label', children: 'children' } */
+    treeProps?: ZyTreeProps;
+    /** 节点唯一键字段，缺省 value */
+    nodeKey?: string;
+    /** 多选时是否显示复选框；缺省 multiple 时为 true */
+    showCheckbox?: boolean;
+    /** 父子节点不联动 */
+    checkStrictly?: boolean;
+    /** 默认展开全部节点 */
+    defaultExpandAll?: boolean;
+    /** 展开后再渲染子节点 */
+    renderAfterExpand?: boolean;
 };
 type __VLS_ModelProps = {
     modelValue?: string | number | undefined | Array<string | number>;
 };
 type __VLS_PublicProps = __VLS_Props & __VLS_ModelProps;
-declare var __VLS_12: string, __VLS_13: any, __VLS_15: {};
+declare var __VLS_12: string, __VLS_13: any, __VLS_26: string, __VLS_27: any, __VLS_29: {};
 type __VLS_Slots = {} & {
     [K in NonNullable<typeof __VLS_12>]?: (props: typeof __VLS_13) => any;
 } & {
-    default?: (props: typeof __VLS_15) => any;
+    [K in NonNullable<typeof __VLS_26>]?: (props: typeof __VLS_27) => any;
+} & {
+    default?: (props: typeof __VLS_29) => any;
 };
 declare const __VLS_base: import("vue").DefineComponent<__VLS_PublicProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     "update:modelValue": (value: string | number | (string | number)[] | undefined) => any;
@@ -24,11 +43,19 @@ declare const __VLS_base: import("vue").DefineComponent<__VLS_PublicProps, {}, {
     "onUpdate:modelValue"?: ((value: string | number | (string | number)[] | undefined) => any) | undefined;
 }>, {
     size: "large" | "default" | "small";
-    effect: "focus" | "underline" | "gradient";
+    effect: "focus" | "underline";
+    data: ZyTreeNode[];
     disabled: boolean;
     placeholder: string;
     clearable: boolean;
     raised: boolean;
+    tree: boolean;
+    treeProps: ZyTreeProps;
+    nodeKey: string;
+    showCheckbox: boolean;
+    checkStrictly: boolean;
+    defaultExpandAll: boolean;
+    renderAfterExpand: boolean;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
 declare const _default: typeof __VLS_export;

package/dist/zy-ui/select/index.d.ts

@@ -1,11 +1,19 @@
 export declare const ZySelect: import("../utils/withInstall").SFCWithInstall<{
     new (...args: any[]): import("vue").CreateComponentPublicInstanceWithMixins<Readonly<{
-        effect?: "focus" | "underline" | "gradient";
+        effect?: "focus" | "underline";
         raised?: boolean;
         size?: "large" | "default" | "small";
         placeholder?: string;
         clearable?: boolean;
         disabled?: boolean;
+        tree?: boolean;
+        data?: import("./types").ZyTreeNode[];
+        treeProps?: import("./types").ZyTreeProps;
+        nodeKey?: string;
+        showCheckbox?: boolean;
+        checkStrictly?: boolean;
+        defaultExpandAll?: boolean;
+        renderAfterExpand?: boolean;
     } & {
         modelValue?: string | number | undefined | Array<string | number>;
     }> & Readonly<{
@@ -14,11 +22,19 @@ export declare const ZySelect: import("../utils/withInstall").SFCWithInstall<{
         "update:modelValue": (value: string | number | (string | number)[] | undefined) => any;
     }, import("vue").PublicProps, {
         size: "large" | "default" | "small";
-        effect: "focus" | "underline" | "gradient";
+        effect: "focus" | "underline";
+        data: import("./types").ZyTreeNode[];
         disabled: boolean;
         placeholder: string;
         clearable: boolean;
         raised: boolean;
+        tree: boolean;
+        treeProps: import("./types").ZyTreeProps;
+        nodeKey: string;
+        showCheckbox: boolean;
+        checkStrictly: boolean;
+        defaultExpandAll: boolean;
+        renderAfterExpand: boolean;
     }, false, {}, {}, import("vue").GlobalComponents, import("vue").GlobalDirectives, string, {}, any, import("vue").ComponentProvideOptions, {
         P: {};
         B: {};
@@ -27,34 +43,58 @@ export declare const ZySelect: import("../utils/withInstall").SFCWithInstall<{
         M: {};
         Defaults: {};
     }, Readonly<{
-        effect?: "focus" | "underline" | "gradient";
+        effect?: "focus" | "underline";
         raised?: boolean;
         size?: "large" | "default" | "small";
         placeholder?: string;
         clearable?: boolean;
         disabled?: boolean;
+        tree?: boolean;
+        data?: import("./types").ZyTreeNode[];
+        treeProps?: import("./types").ZyTreeProps;
+        nodeKey?: string;
+        showCheckbox?: boolean;
+        checkStrictly?: boolean;
+        defaultExpandAll?: boolean;
+        renderAfterExpand?: boolean;
     } & {
         modelValue?: string | number | undefined | Array<string | number>;
     }> & Readonly<{
         "onUpdate:modelValue"?: ((value: string | number | (string | number)[] | undefined) => any) | undefined;
     }>, {}, {}, {}, {}, {
         size: "large" | "default" | "small";
-        effect: "focus" | "underline" | "gradient";
+        effect: "focus" | "underline";
+        data: import("./types").ZyTreeNode[];
         disabled: boolean;
         placeholder: string;
         clearable: boolean;
         raised: boolean;
+        tree: boolean;
+        treeProps: import("./types").ZyTreeProps;
+        nodeKey: string;
+        showCheckbox: boolean;
+        checkStrictly: boolean;
+        defaultExpandAll: boolean;
+        renderAfterExpand: boolean;
     }>;
     __isFragment?: never;
     __isTeleport?: never;
     __isSuspense?: never;
 } & import("vue").ComponentOptionsBase<Readonly<{
-    effect?: "focus" | "underline" | "gradient";
+    effect?: "focus" | "underline";
     raised?: boolean;
     size?: "large" | "default" | "small";
     placeholder?: string;
     clearable?: boolean;
     disabled?: boolean;
+    tree?: boolean;
+    data?: import("./types").ZyTreeNode[];
+    treeProps?: import("./types").ZyTreeProps;
+    nodeKey?: string;
+    showCheckbox?: boolean;
+    checkStrictly?: boolean;
+    defaultExpandAll?: boolean;
+    renderAfterExpand?: boolean;
 } & {
     modelValue?: string | number | undefined | Array<string | number>;
 }> & Readonly<{
@@ -63,16 +103,27 @@ export declare const ZySelect: import("../utils/withInstall").SFCWithInstall<{
     "update:modelValue": (value: string | number | (string | number)[] | undefined) => any;
 }, string, {
     size: "large" | "default" | "small";
-    effect: "focus" | "underline" | "gradient";
+    effect: "focus" | "underline";
+    data: import("./types").ZyTreeNode[];
     disabled: boolean;
     placeholder: string;
     clearable: boolean;
     raised: boolean;
+    tree: boolean;
+    treeProps: import("./types").ZyTreeProps;
+    nodeKey: string;
+    showCheckbox: boolean;
+    checkStrictly: boolean;
+    defaultExpandAll: boolean;
+    renderAfterExpand: boolean;
 }, {}, string, {}, import("vue").GlobalComponents, import("vue").GlobalDirectives, string, import("vue").ComponentProvideOptions> & import("vue").VNodeProps & import("vue").AllowedComponentProps & import("vue").ComponentCustomProps & (new () => {
     $slots: {
         [x: string]: ((props: any) => any) | undefined;
+    } & {
+        [x: string]: ((props: any) => any) | undefined;
     } & {
         default?: (props: {}) => any;
     };
 })>;
+export type { ZyTreeNode, ZyTreeProps } from './types';
 export default ZySelect;

package/dist/zy-ui/select/types.d.ts

@@ -0,0 +1,9 @@
+/** 树形选择节点：字段名由 `treeProps` 映射，默认 label / children */
+export type ZyTreeNode = Record<string, any>;
+/** 树节点的字段映射，对应 Element Tree 的 `props` */
+export interface ZyTreeProps {
+    label?: string;
+    children?: string;
+    disabled?: string;
+    isLeaf?: string;
+}

package/dist/zy-ui/side-menu/ZySideMenu.vue.d.ts

@@ -0,0 +1,48 @@
+import type { SideMenuItem, SideMenuNavigatePayload } from './types';
+type __VLS_Props = {
+    /** 菜单项；children 为二级菜单，当前支持一层 */
+    items?: SideMenuItem[];
+    /** 受控选中项（v-model:active）；不传则点了自己记 */
+    active?: string | null;
+    /** 受控展开项（v-model:open）；不传则自己管 */
+    open?: string[];
+    /** 背景：auto 跟随主题（basic 纸白 / solid 品牌蓝）/ brand 品牌浅纸或蓝渐变 / plain 强制白色纸面 */
+    surface?: 'auto' | 'brand' | 'plain';
+    /** 自定义容器背景色 */
+    background?: string;
+    /** 自定义一级 / 二级文字色 */
+    textColor?: string;
+    /** 自定义选中行背景色 */
+    activeBackground?: string;
+    /** 自定义选中行文字色 */
+    activeTextColor?: string;
+    /** 导航区的无障碍名称 */
+    label?: string;
+};
+declare var __VLS_1: {}, __VLS_29: {};
+type __VLS_Slots = {} & {
+    brand?: (props: typeof __VLS_1) => any;
+} & {
+    footer?: (props: typeof __VLS_29) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    "update:open": (value: string[]) => any;
+    "update:active": (value: string) => any;
+    navigate: (payload: SideMenuNavigatePayload) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    "onUpdate:open"?: ((value: string[]) => any) | undefined;
+    "onUpdate:active"?: ((value: string) => any) | undefined;
+    onNavigate?: ((payload: SideMenuNavigatePayload) => any) | undefined;
+}>, {
+    label: string;
+    items: SideMenuItem[];
+    surface: "auto" | "brand" | "plain";
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/zy-ui/side-menu/index.d.ts

@@ -0,0 +1,2 @@
+export { default as ZySideMenu } from './ZySideMenu.vue';
+export type { SideMenuIcon, SideMenuItem, SideMenuNavigatePayload } from './types';

package/dist/zy-ui/side-menu/types.d.ts

@@ -0,0 +1,21 @@
+import type { Component } from 'vue';
+/** 图标：本库图标名（`src/assets/icons` 的文件名）或任意组件 */
+export type SideMenuIcon = string | Component;
+export interface SideMenuItem {
+    key: string;
+    label: string;
+    icon?: SideMenuIcon;
+    href?: string;
+    /** 标题右侧的小徽标，如「新」或数字 */
+    badge?: string;
+    disabled?: boolean;
+    /** 二级菜单；当前支持一层 */
+    children?: SideMenuItem[];
+}
+/** `navigate` 事件载荷：拦下默认跳转，自己交给路由 */
+export interface SideMenuNavigatePayload {
+    item: SideMenuItem;
+    title: string;
+    href?: string;
+    event: MouseEvent;
+}

package/dist/zy-ui/switch/ZySwitch.vue.d.ts

@@ -1,7 +1,11 @@
 type __VLS_Props = {
-    /** 选中态的轨道文案 */
+    /** default 常用基础款 / holographic 全息变体 */
+    variant?: 'default' | 'holographic';
+    /** 基础款等比尺寸：small 48×20 / default 72×30 / large 为参考原稿 120×50 */
+    size?: 'small' | 'default' | 'large';
+    /** 选中态文案：全息变体显示在轨道内；基础款不显示文案 */
     activeText?: string;
-    /** 未选态的轨道文案 */
+    /** 未选态文案：基础款显示在轨道右侧，全息变体显示在轨道内 */
     inactiveText?: string;
     disabled?: boolean;
     /** 无障碍名称：不传则读屏只说「开关」，不带名字 */
@@ -16,8 +20,10 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_PublicProps, {},
 }, string, import("vue").PublicProps, Readonly<__VLS_PublicProps> & Readonly<{
     "onUpdate:modelValue"?: ((value: boolean) => any) | undefined;
 }>, {
+    size: "small" | "default" | "large";
     label: string;
     disabled: boolean;
+    variant: "default" | "holographic";
     activeText: string;
     inactiveText: string;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;

package/dist/zy-ui/switch/index.d.ts

@@ -1,4 +1,6 @@
 export declare const ZySwitch: import("../utils/withInstall").SFCWithInstall<import("vue").DefineComponent<{
+    variant?: "default" | "holographic";
+    size?: "small" | "default" | "large";
     activeText?: string;
     inactiveText?: string;
     disabled?: boolean;
@@ -8,6 +10,8 @@ export declare const ZySwitch: import("../utils/withInstall").SFCWithInstall<imp
 }, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     "update:modelValue": (value: boolean) => any;
 }, string, import("vue").PublicProps, Readonly<{
+    variant?: "default" | "holographic";
+    size?: "small" | "default" | "large";
     activeText?: string;
     inactiveText?: string;
     disabled?: boolean;
@@ -17,8 +21,10 @@ export declare const ZySwitch: import("../utils/withInstall").SFCWithInstall<imp
 }> & Readonly<{
     "onUpdate:modelValue"?: ((value: boolean) => any) | undefined;
 }>, {
+    size: "small" | "default" | "large";
     label: string;
     disabled: boolean;
+    variant: "default" | "holographic";
     activeText: string;
     inactiveText: string;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>>;

package/dist/zy-ui/tabs/ZyTabs.vue.d.ts

@@ -0,0 +1,49 @@
+import type { ZyTabItem } from './types';
+type __VLS_Props = {
+    /** 标签数据 */
+    items: ZyTabItem[];
+    /** 无障碍名称 */
+    ariaLabel?: string;
+    /** 是否渲染下方内容面板 */
+    panels?: boolean;
+    /** 标签等分铺满 */
+    stretch?: boolean;
+};
+type __VLS_ModelProps = {
+    modelValue?: string | number;
+};
+type __VLS_PublicProps = __VLS_Props & __VLS_ModelProps;
+declare var __VLS_1: {
+    item: ZyTabItem;
+    active: boolean;
+}, __VLS_10: `panel-${string}` | `panel-${number}`, __VLS_11: {
+    item: ZyTabItem | undefined;
+}, __VLS_13: {
+    item: ZyTabItem | undefined;
+};
+type __VLS_Slots = {} & {
+    [K in NonNullable<typeof __VLS_10>]?: (props: typeof __VLS_11) => any;
+} & {
+    tab?: (props: typeof __VLS_1) => any;
+} & {
+    panel?: (props: typeof __VLS_13) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<__VLS_PublicProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    change: (key: string | number) => any;
+    "update:modelValue": (value: string | number) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_PublicProps> & Readonly<{
+    onChange?: ((key: string | number) => any) | undefined;
+    "onUpdate:modelValue"?: ((value: string | number) => any) | undefined;
+}>, {
+    ariaLabel: string;
+    stretch: boolean;
+    panels: boolean;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/zy-ui/tabs/index.d.ts

@@ -0,0 +1,81 @@
+export declare const ZyTabs: import("../utils/withInstall").SFCWithInstall<{
+    new (...args: any[]): import("vue").CreateComponentPublicInstanceWithMixins<Readonly<{
+        items: import("./types").ZyTabItem[];
+        ariaLabel?: string;
+        panels?: boolean;
+        stretch?: boolean;
+    } & {
+        modelValue?: string | number;
+    }> & Readonly<{
+        onChange?: ((key: string | number) => any) | undefined;
+        "onUpdate:modelValue"?: ((value: string | number) => any) | undefined;
+    }>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+        change: (key: string | number) => any;
+        "update:modelValue": (value: string | number) => any;
+    }, import("vue").PublicProps, {
+        ariaLabel: string;
+        stretch: boolean;
+        panels: boolean;
+    }, false, {}, {}, import("vue").GlobalComponents, import("vue").GlobalDirectives, string, {}, any, import("vue").ComponentProvideOptions, {
+        P: {};
+        B: {};
+        D: {};
+        C: {};
+        M: {};
+        Defaults: {};
+    }, Readonly<{
+        items: import("./types").ZyTabItem[];
+        ariaLabel?: string;
+        panels?: boolean;
+        stretch?: boolean;
+    } & {
+        modelValue?: string | number;
+    }> & Readonly<{
+        onChange?: ((key: string | number) => any) | undefined;
+        "onUpdate:modelValue"?: ((value: string | number) => any) | undefined;
+    }>, {}, {}, {}, {}, {
+        ariaLabel: string;
+        stretch: boolean;
+        panels: boolean;
+    }>;
+    __isFragment?: never;
+    __isTeleport?: never;
+    __isSuspense?: never;
+} & import("vue").ComponentOptionsBase<Readonly<{
+    items: import("./types").ZyTabItem[];
+    ariaLabel?: string;
+    panels?: boolean;
+    stretch?: boolean;
+} & {
+    modelValue?: string | number;
+}> & Readonly<{
+    onChange?: ((key: string | number) => any) | undefined;
+    "onUpdate:modelValue"?: ((value: string | number) => any) | undefined;
+}>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    change: (key: string | number) => any;
+    "update:modelValue": (value: string | number) => any;
+}, string, {
+    ariaLabel: string;
+    stretch: boolean;
+    panels: boolean;
+}, {}, string, {}, import("vue").GlobalComponents, import("vue").GlobalDirectives, string, import("vue").ComponentProvideOptions> & import("vue").VNodeProps & import("vue").AllowedComponentProps & import("vue").ComponentCustomProps & (new () => {
+    $slots: {
+        [x: `panel-${string}`]: ((props: {
+            item: import("./types").ZyTabItem | undefined;
+        }) => any) | undefined;
+        [x: `panel-${number}`]: ((props: {
+            item: import("./types").ZyTabItem | undefined;
+        }) => any) | undefined;
+    } & {
+        tab?: (props: {
+            item: import("./types").ZyTabItem;
+            active: boolean;
+        }) => any;
+    } & {
+        panel?: (props: {
+            item: import("./types").ZyTabItem | undefined;
+        }) => any;
+    };
+})>;
+export type { ZyTabItem } from './types';
+export default ZyTabs;

package/dist/zy-ui/tabs/types.d.ts

@@ -0,0 +1,10 @@
+export interface ZyTabItem {
+    /** 唯一键，v-model 绑定这个值 */
+    key: string | number;
+    /** 标签文字 */
+    label: string;
+    /** 标签右侧的计数 / 状态 */
+    badge?: string | number;
+    /** 禁用后不参与点击与键盘切换 */
+    disabled?: boolean;
+}

package/dist/zy-ui/themes/basic.css

@@ -78,6 +78,67 @@ html[data-zy-theme='basic'] .zy-pagination .el-pagination__jump {
   color: var(--zy-muted);
 }
 
+/* 每页条数：与选择器同一条纸片控件 */
+html[data-zy-theme='basic'] .zy-pagination .el-pagination__sizes .el-select__wrapper {
+  min-height: 28px;
+  height: 28px;
+  padding: 0 8px;
+  border: 1px solid var(--zy-hairline);
+  border-radius: var(--zy-radius-sm);
+  background-color: var(--zy-surface);
+  box-shadow: var(--zy-shadow-card);
+  font-family: var(--zy-font-sans);
+  transition:
+    border-color var(--zy-duration-press) var(--zy-ease-soft),
+    box-shadow var(--zy-duration-press) var(--zy-ease-soft);
+}
+
+html[data-zy-theme='basic'] .zy-pagination .el-pagination__sizes .el-select__wrapper:hover {
+  border-color: var(--zy-hairline-strong);
+}
+
+html[data-zy-theme='basic'] .zy-pagination .el-pagination__sizes .el-select__wrapper.is-focused,
+html[data-zy-theme='basic'] .zy-pagination .el-pagination__sizes .el-select__wrapper:focus-within {
+  border-color: var(--zy-brand);
+  box-shadow: 0 0 0 3px color-mix(in srgb, var(--zy-brand) 14%, transparent);
+}
+
+html[data-zy-theme='basic'] .zy-pagination .el-pagination__sizes .el-select__selected-item,
+html[data-zy-theme='basic'] .zy-pagination .el-pagination__sizes .el-select__placeholder {
+  color: var(--zy-ink);
+  font-size: 12px;
+}
+
+html[data-zy-theme='basic'] .zy-pagination .el-pagination__sizes .el-select__caret {
+  color: var(--zy-muted);
+}
+
+html[data-zy-theme='basic'] .zy-pagination-popper {
+  border: 1px solid var(--zy-hairline) !important;
+  border-radius: var(--zy-radius) !important;
+  background: var(--zy-surface);
+  box-shadow: var(--zy-shadow-card) !important;
+}
+
+html[data-zy-theme='basic'] .zy-pagination-popper .el-select-dropdown__item {
+  min-height: 28px;
+  height: 28px;
+  line-height: 28px;
+  border-radius: var(--zy-radius-sm);
+  color: var(--zy-ink);
+  font-family: var(--zy-font-sans);
+  font-size: 12px;
+}
+
+html[data-zy-theme='basic'] .zy-pagination-popper .el-select-dropdown__item.is-hovering {
+  background: var(--zy-brand-soft);
+}
+
+html[data-zy-theme='basic'] .zy-pagination-popper .el-select-dropdown__item.is-selected {
+  color: var(--zy-brand);
+  font-weight: 600;
+}
+
 /* 卡 = 白纸片（发丝边 + 极轻双层影），键帽只留给键帽主题 */
 html[data-zy-theme='basic'] .zy-card {
   --zy-card-fill-clr: var(--zy-surface);
@@ -835,3 +896,66 @@ html.dark[data-zy-theme='basic'] .zy-tag.is-fill.el-tag--danger {
 html.dark[data-zy-theme='basic'] .zy-tag.is-fill.el-tag--info {
   --zy-tag-fill-clr: var(--zy-info-key);
 }
+
+/* ---------- 级联选择器：el-cascader 的主题化类 .zy-cascader / .zy-cascader-popper ---------- */
+html[data-zy-theme='basic'] .zy-cascader .el-input__wrapper {
+  border: 1px solid var(--zy-hairline);
+  border-radius: var(--zy-radius);
+  background-color: var(--zy-surface);
+  box-shadow: none;
+  transition:
+    border-color var(--zy-duration-press) var(--zy-ease-soft),
+    box-shadow var(--zy-duration-fast) var(--zy-ease-soft);
+}
+
+html[data-zy-theme='basic'] .zy-cascader .el-input__wrapper:hover {
+  border-color: var(--zy-hairline-strong);
+}
+
+html[data-zy-theme='basic'] .zy-cascader .el-input__wrapper.is-focus {
+  border-color: var(--zy-brand);
+  box-shadow: 0 0 0 3px color-mix(in srgb, var(--zy-brand) 14%, transparent);
+}
+
+html[data-zy-theme='basic'] .zy-cascader .el-input__inner {
+  color: var(--zy-ink);
+  font-family: var(--zy-font-sans);
+}
+
+html[data-zy-theme='basic'] .zy-cascader-popper {
+  border: 1px solid var(--zy-hairline);
+  border-radius: var(--zy-radius);
+  background: var(--zy-surface);
+  box-shadow: var(--zy-shadow-card);
+}
+
+html[data-zy-theme='basic'] .zy-cascader-popper .el-cascader-menu {
+  border-right-color: var(--zy-hairline);
+}
+
+html[data-zy-theme='basic'] .zy-cascader-popper .el-cascader-node {
+  color: var(--zy-ink);
+}
+
+html[data-zy-theme='basic'] .zy-cascader-popper .el-cascader-node.in-active-path,
+html[data-zy-theme='basic'] .zy-cascader-popper .el-cascader-node.is-active {
+  background: var(--zy-brand-soft);
+  color: var(--zy-brand);
+  font-weight: 600;
+}
+
+html[data-zy-theme='basic'] .zy-cascader-popper .el-cascader-node.is-disabled {
+  opacity: 0.45;
+}
+
+html[data-zy-theme='basic'] .zy-cascader-popper .el-cascader-node__prefix {
+  color: var(--zy-muted);
+}
+
+/* ---------- 侧边菜单：显式品牌面比白纸多一层品牌薄雾 ---------- */
+html[data-zy-theme='basic'] .zy-side-menu[data-surface='brand'] {
+  --zy-side-menu-bg: color-mix(in srgb, var(--zy-brand) 7%, var(--zy-surface));
+  --zy-side-menu-bg-image: none;
+
+  border-color: color-mix(in srgb, var(--zy-brand) 22%, var(--zy-hairline));
+}

package/dist/zy-ui/themes/material.css

@@ -22,7 +22,8 @@ html[data-zy-theme='solid']
     .zy-mega-menu__plain.is-current,
     .zy-mega-menu__trigger.is-open,
     .zy-verify__piece,
-    .zy-verify__handle
+    .zy-verify__handle,
+    .zy-switch--default .zy-switch-default-track
   ) {
   --zy-key-gloss: linear-gradient(
     to bottom,