@cyberpunk-vue/components 1.13.19 → 1.14.0

package/dist/card/src/card.d.ts

@@ -5,6 +5,7 @@ import { DurationValue } from '@cyberpunk-vue/hooks';
  * - `always` - 始终显示阴影（默认）
  * - `hover` - 仅悬停时显示
  * - `never` - 不显示阴影
+ * @note `variant="outline"` 以描边轮廓为主，外部 hover shadow 不生效。
  */
 export type CardShadow = 'always' | 'hover' | 'never';
 /**
@@ -114,6 +115,7 @@ export declare const cardProps: {
      * - `always` - 始终显示
      * - `hover` - 悬停时显示
      * - `never` - 不显示
+     * @description `variant="outline"` 时外部 hover shadow 无效，仅保留描边状态。
      * @default 'always'
      */
     readonly shadow: {

package/dist/config-provider/index.d.ts

@@ -24,12 +24,27 @@ export declare const CpConfigProvider: import('../utils').SFCWithInstall<{
             readonly default: () => {};
         };
         readonly theme: {
-            readonly type: import('vue').PropType<import('@cyberpunk-vue/constants').ThemeType>;
+            readonly type: import('vue').PropType<import('@cyberpunk-vue/constants').ThemeMode>;
             readonly default: "dark";
         };
+        readonly themeOverrides: {
+            readonly type: import('vue').PropType<import('.').ThemeOverrides>;
+            readonly default: () => {};
+        };
+        readonly syncDocument: {
+            readonly type: BooleanConstructor;
+            readonly default: true;
+        };
+        readonly tag: {
+            readonly type: StringConstructor;
+            readonly default: "div";
+        };
     }>> & Readonly<{}>, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, import('vue').PublicProps, {
+        readonly tag: string;
         readonly defaults: import('.').ComponentDefaults;
-        readonly theme: import('@cyberpunk-vue/constants').ThemeType;
+        readonly theme: import('@cyberpunk-vue/constants').ThemeMode;
+        readonly themeOverrides: import('.').ThemeOverrides;
+        readonly syncDocument: boolean;
     }, true, {}, {}, import('vue').GlobalComponents, import('vue').GlobalDirectives, string, {}, any, import('vue').ComponentProvideOptions, {
         P: {};
         B: {};
@@ -43,12 +58,27 @@ export declare const CpConfigProvider: import('../utils').SFCWithInstall<{
             readonly default: () => {};
         };
         readonly theme: {
-            readonly type: import('vue').PropType<import('@cyberpunk-vue/constants').ThemeType>;
+            readonly type: import('vue').PropType<import('@cyberpunk-vue/constants').ThemeMode>;
             readonly default: "dark";
         };
+        readonly themeOverrides: {
+            readonly type: import('vue').PropType<import('.').ThemeOverrides>;
+            readonly default: () => {};
+        };
+        readonly syncDocument: {
+            readonly type: BooleanConstructor;
+            readonly default: true;
+        };
+        readonly tag: {
+            readonly type: StringConstructor;
+            readonly default: "div";
+        };
     }>> & Readonly<{}>, {}, {}, {}, {}, {
+        readonly tag: string;
         readonly defaults: import('.').ComponentDefaults;
-        readonly theme: import('@cyberpunk-vue/constants').ThemeType;
+        readonly theme: import('@cyberpunk-vue/constants').ThemeMode;
+        readonly themeOverrides: import('.').ThemeOverrides;
+        readonly syncDocument: boolean;
     }>;
     __isFragment?: never;
     __isTeleport?: never;
@@ -59,12 +89,27 @@ export declare const CpConfigProvider: import('../utils').SFCWithInstall<{
         readonly default: () => {};
     };
     readonly theme: {
-        readonly type: import('vue').PropType<import('@cyberpunk-vue/constants').ThemeType>;
+        readonly type: import('vue').PropType<import('@cyberpunk-vue/constants').ThemeMode>;
         readonly default: "dark";
     };
+    readonly themeOverrides: {
+        readonly type: import('vue').PropType<import('.').ThemeOverrides>;
+        readonly default: () => {};
+    };
+    readonly syncDocument: {
+        readonly type: BooleanConstructor;
+        readonly default: true;
+    };
+    readonly tag: {
+        readonly type: StringConstructor;
+        readonly default: "div";
+    };
 }>> & Readonly<{}>, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, {
+    readonly tag: string;
     readonly defaults: import('.').ComponentDefaults;
-    readonly theme: import('@cyberpunk-vue/constants').ThemeType;
+    readonly theme: import('@cyberpunk-vue/constants').ThemeMode;
+    readonly themeOverrides: import('.').ThemeOverrides;
+    readonly syncDocument: boolean;
 }, {}, string, {}, import('vue').GlobalComponents, import('vue').GlobalDirectives, string, import('vue').ComponentProvideOptions> & import('vue').VNodeProps & import('vue').AllowedComponentProps & import('vue').ComponentCustomProps & (new () => {
     $slots: {
         default?(_: {}): any;

package/dist/config-provider/src/config-provider.d.ts

@@ -1,6 +1,6 @@
 import { ExtractPropTypes, PropType } from 'vue';
-import { ThemeType } from '@cyberpunk-vue/constants';
-export type { ThemeType };
+import { ThemeMode, ThemeType } from '@cyberpunk-vue/constants';
+export type { ThemeMode, ThemeType };
 /**
  * 组件默认值配置类型
  *
@@ -16,6 +16,15 @@ export type { ThemeType };
  * ```
  */
 export type ComponentDefaults = Record<string, Record<string, any>>;
+/**
+ * 主题变量覆盖配置
+ *
+ * 键名支持 CSS 变量名或简写 token 名：
+ * - `--cp-color-primary`
+ * - `color-primary`
+ * - `colorPrimary`
+ */
+export type ThemeOverrides = Record<string, string | number>;
 /**
  * CpConfigProvider 组件 Props 定义
  *
@@ -77,8 +86,49 @@ export declare const configProviderProps: {
      * @example `<CpConfigProvider theme="light" />`
      */
     readonly theme: {
-        readonly type: PropType<ThemeType>;
+        readonly type: PropType<ThemeMode>;
         readonly default: "dark";
     };
+    /**
+     * 主题 CSS 变量覆盖
+     *
+     * 用于按作用域覆盖组件库设计 token。传入简写 token 名时会自动转换为
+     * `--cp-*` CSS 变量。
+     *
+     * @default {}
+     * @example
+     * ```vue
+     * <CpConfigProvider :theme-overrides="{ colorPrimary: '#ff6bcb', radiusMd: '10px' }">
+     *   <App />
+     * </CpConfigProvider>
+     * ```
+     */
+    readonly themeOverrides: {
+        readonly type: PropType<ThemeOverrides>;
+        readonly default: () => {};
+    };
+    /**
+     * 是否同步主题和变量到 document.documentElement
+     *
+     * 根级 Provider 建议开启，以影响 body 背景等全局样式；局部嵌套 Provider
+     * 可以关闭，仅让配置作用于当前插槽子树。
+     *
+     * @default true
+     */
+    readonly syncDocument: {
+        readonly type: BooleanConstructor;
+        readonly default: true;
+    };
+    /**
+     * Provider 渲染标签
+     *
+     * 默认使用 `div` 并设置 `display: contents`，不会产生额外布局盒。
+     *
+     * @default 'div'
+     */
+    readonly tag: {
+        readonly type: StringConstructor;
+        readonly default: "div";
+    };
 };
 export type ConfigProviderProps = ExtractPropTypes<typeof configProviderProps>;

package/dist/config-provider/src/config-provider.vue.d.ts

@@ -13,21 +13,48 @@ declare const __VLS_component: import('vue').DefineComponent<import('vue').Extra
         readonly default: () => {};
     };
     readonly theme: {
-        readonly type: import('vue').PropType<import('@cyberpunk-vue/constants').ThemeType>;
+        readonly type: import('vue').PropType<import('@cyberpunk-vue/constants').ThemeMode>;
         readonly default: "dark";
     };
+    readonly themeOverrides: {
+        readonly type: import('vue').PropType<import('./config-provider').ThemeOverrides>;
+        readonly default: () => {};
+    };
+    readonly syncDocument: {
+        readonly type: BooleanConstructor;
+        readonly default: true;
+    };
+    readonly tag: {
+        readonly type: StringConstructor;
+        readonly default: "div";
+    };
 }>, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<import('vue').ExtractPropTypes<{
     readonly defaults: {
         readonly type: import('vue').PropType<import('./config-provider').ComponentDefaults>;
         readonly default: () => {};
     };
     readonly theme: {
-        readonly type: import('vue').PropType<import('@cyberpunk-vue/constants').ThemeType>;
+        readonly type: import('vue').PropType<import('@cyberpunk-vue/constants').ThemeMode>;
         readonly default: "dark";
     };
+    readonly themeOverrides: {
+        readonly type: import('vue').PropType<import('./config-provider').ThemeOverrides>;
+        readonly default: () => {};
+    };
+    readonly syncDocument: {
+        readonly type: BooleanConstructor;
+        readonly default: true;
+    };
+    readonly tag: {
+        readonly type: StringConstructor;
+        readonly default: "div";
+    };
 }>> & Readonly<{}>, {
+    readonly tag: string;
     readonly defaults: import('./config-provider').ComponentDefaults;
-    readonly theme: import('@cyberpunk-vue/constants').ThemeType;
+    readonly theme: import('@cyberpunk-vue/constants').ThemeMode;
+    readonly themeOverrides: import('./config-provider').ThemeOverrides;
+    readonly syncDocument: boolean;
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
 declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, __VLS_TemplateResult["slots"]>;
 export default _default;