@cyberpunk-vue/components 1.13.20 → 1.14.1

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026 Cyberpunk Vue Contributors
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2026 Cyberpunk Vue Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

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';
 /**
@@ -14,9 +15,8 @@ export type CardShadow = 'always' | 'hover' | 'never';
  * - `semi` - 半透明背景，支持毛玻璃效果
  * - `ghost` - 透明背景
  * - `neon` - 霓虹发光
- * - `cyber` - 赛博风格
  */
-export type CardVariant = 'solid' | 'outline' | 'semi' | 'ghost' | 'neon' | 'cyber';
+export type CardVariant = 'solid' | 'outline' | 'semi' | 'ghost' | 'neon';
 /**
  * 卡片形状模式
  * - `clip` - 切角样式（默认，赛博朋克特色）
@@ -114,6 +114,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;

package/dist/container/index.d.ts

@@ -51,9 +51,9 @@ export declare const CpContainer: import('../utils').SFCWithInstall<{
     readonly direction: import('.').ContainerDirection;
 }, {}, string, {}, import('vue').GlobalComponents, import('vue').GlobalDirectives, string, import('vue').ComponentProvideOptions> & import('vue').VNodeProps & import('vue').AllowedComponentProps & import('vue').ComponentCustomProps & (new () => {
     $slots: Readonly<{
-        default?: (props?: any) => any;
+        default?: () => import('vue').VNode[];
     }> & {
-        default?: (props?: any) => any;
+        default?: () => import('vue').VNode[];
     };
 })>;
 export declare const CpHeader: import('../utils').SFCWithInstall<{

package/dist/container/src/container.vue.d.ts

@@ -1,9 +1,10 @@
+import { VNode } from 'vue';
 declare function __VLS_template(): {
     attrs: Partial<{}>;
     slots: Readonly<{
-        default?: (props?: any) => any;
+        default?: () => VNode[];
     }> & {
-        default?: (props?: any) => any;
+        default?: () => VNode[];
     };
     refs: {};
     rootEl: HTMLElement;