@cyberpunk-vue/components 1.14.0 → 1.14.1

package/dist/text/index.d.ts

@@ -17,13 +17,21 @@ export declare const CpText: import('../utils').SFCWithInstall<{
             readonly type: import('vue').PropType<import('.').TextType>;
             readonly default: "default";
         };
+        readonly level: {
+            readonly type: import('vue').PropType<import('.').TextLevel>;
+            readonly default: "body";
+        };
+        readonly tag: {
+            readonly type: import('vue').PropType<import('.').TextTag>;
+            readonly default: "span";
+        };
         readonly color: {
             readonly type: StringConstructor;
             readonly default: "";
         };
         readonly size: {
             readonly type: import('vue').PropType<import('.').TextSize>;
-            readonly default: "md";
+            readonly default: undefined;
         };
         readonly align: {
             readonly type: import('vue').PropType<import('.').TextAlign>;
@@ -110,10 +118,12 @@ export declare const CpText: import('../utils').SFCWithInstall<{
         readonly bold: boolean;
         readonly type: import('.').TextType;
         readonly color: string;
+        readonly tag: import('.').TextTag;
         readonly dashed: boolean;
         readonly marker: boolean;
         readonly italic: boolean;
         readonly underline: boolean;
+        readonly level: import('.').TextLevel;
         readonly align: import('.').TextAlign;
         readonly boxed: boolean;
         readonly strikethrough: boolean;
@@ -129,7 +139,7 @@ export declare const CpText: import('../utils').SFCWithInstall<{
         readonly overlapOffsetY: number;
         readonly overlapColor: string;
         readonly unselectable: boolean;
-    }, true, {}, {}, import('vue').GlobalComponents, import('vue').GlobalDirectives, string, {}, HTMLSpanElement, import('vue').ComponentProvideOptions, {
+    }, true, {}, {}, import('vue').GlobalComponents, import('vue').GlobalDirectives, string, {}, any, import('vue').ComponentProvideOptions, {
         P: {};
         B: {};
         D: {};
@@ -141,13 +151,21 @@ export declare const CpText: import('../utils').SFCWithInstall<{
             readonly type: import('vue').PropType<import('.').TextType>;
             readonly default: "default";
         };
+        readonly level: {
+            readonly type: import('vue').PropType<import('.').TextLevel>;
+            readonly default: "body";
+        };
+        readonly tag: {
+            readonly type: import('vue').PropType<import('.').TextTag>;
+            readonly default: "span";
+        };
         readonly color: {
             readonly type: StringConstructor;
             readonly default: "";
         };
         readonly size: {
             readonly type: import('vue').PropType<import('.').TextSize>;
-            readonly default: "md";
+            readonly default: undefined;
         };
         readonly align: {
             readonly type: import('vue').PropType<import('.').TextAlign>;
@@ -234,10 +252,12 @@ export declare const CpText: import('../utils').SFCWithInstall<{
         readonly bold: boolean;
         readonly type: import('.').TextType;
         readonly color: string;
+        readonly tag: import('.').TextTag;
         readonly dashed: boolean;
         readonly marker: boolean;
         readonly italic: boolean;
         readonly underline: boolean;
+        readonly level: import('.').TextLevel;
         readonly align: import('.').TextAlign;
         readonly boxed: boolean;
         readonly strikethrough: boolean;
@@ -262,13 +282,21 @@ export declare const CpText: import('../utils').SFCWithInstall<{
         readonly type: import('vue').PropType<import('.').TextType>;
         readonly default: "default";
     };
+    readonly level: {
+        readonly type: import('vue').PropType<import('.').TextLevel>;
+        readonly default: "body";
+    };
+    readonly tag: {
+        readonly type: import('vue').PropType<import('.').TextTag>;
+        readonly default: "span";
+    };
     readonly color: {
         readonly type: StringConstructor;
         readonly default: "";
     };
     readonly size: {
         readonly type: import('vue').PropType<import('.').TextSize>;
-        readonly default: "md";
+        readonly default: undefined;
     };
     readonly align: {
         readonly type: import('vue').PropType<import('.').TextAlign>;
@@ -355,10 +383,12 @@ export declare const CpText: import('../utils').SFCWithInstall<{
     readonly bold: boolean;
     readonly type: import('.').TextType;
     readonly color: string;
+    readonly tag: import('.').TextTag;
     readonly dashed: boolean;
     readonly marker: boolean;
     readonly italic: boolean;
     readonly underline: boolean;
+    readonly level: import('.').TextLevel;
     readonly align: import('.').TextAlign;
     readonly boxed: boolean;
     readonly strikethrough: boolean;

package/dist/text/src/text.d.ts

@@ -10,7 +10,7 @@ import { DurationValue } from '@cyberpunk-vue/hooks';
 export type TextSize = 'sm' | 'md' | 'lg' | number;
 /**
  * 文字类型（颜色预设）
- * - `default` - 默认 (继承父级颜色)
+ * - `default` - 默认主题文字色
  * - `primary` - 主色调 (赛博青)
  * - `success` - 成功 (霓虹绿)
  * - `warning` - 警告 (橙黄)
@@ -18,6 +18,16 @@ export type TextSize = 'sm' | 'md' | 'lg' | number;
  * - `info` - 信息 (紫罗兰)
  */
 export type TextType = 'default' | 'primary' | 'success' | 'warning' | 'error' | 'info';
+/**
+ * 文字层级
+ * - `heading` - 标题文字，适合模块标题或卡片标题
+ * - `subheading` - 副标题文字，适合标题下方说明
+ * - `body` - 正文文字，默认
+ * - `secondary` - 次级正文，适合描述、辅助信息
+ * - `caption` - 标签/注释文字，适合元信息
+ * - `muted` - 弱化文字，适合低优先级说明
+ */
+export type TextLevel = 'heading' | 'subheading' | 'body' | 'secondary' | 'caption' | 'muted';
 /**
  * 垂直对齐方式
  * - `top` - 顶部对齐
@@ -25,15 +35,20 @@ export type TextType = 'default' | 'primary' | 'success' | 'warning' | 'error' |
  * - `bottom` - 底部对齐
  */
 export type TextAlign = 'top' | 'middle' | 'bottom';
+/**
+ * 渲染标签
+ */
+export type TextTag = 'span' | 'p' | 'div' | 'label' | 'strong' | 'em' | 'small' | 'h1' | 'h2' | 'h3' | 'h4' | 'h5' | 'h6';
 /**
  * CpText 组件 Props 定义
  *
- * @description 赛博朋克风格特殊文字组件，可快速为文字添加多种视觉效果。
+ * @description 赛博朋克风格文字组件，可快速切换文字层级并添加多种视觉效果。
  *
  * @example
  * ```vue
  * <!-- 基础用法 -->
  * <CpText>普通文字</CpText>
+ * <CpText level="heading" tag="h2">标题文字</CpText>
  *
  * <!-- 带效果 -->
  * <CpText underline type="primary">下划线</CpText>
@@ -57,6 +72,26 @@ export declare const textProps: {
         readonly type: PropType<TextType>;
         readonly default: "default";
     };
+    /**
+     * 文字层级
+     * 控制默认字号、字重、行高和文本色，可被 size / type / color 显式覆盖
+     * @default 'body'
+     * @example `<CpText level="heading" tag="h2">标题</CpText>`
+     */
+    readonly level: {
+        readonly type: PropType<TextLevel>;
+        readonly default: "body";
+    };
+    /**
+     * 渲染标签
+     * 仅改变实际 HTML 标签，不改变视觉层级；需要视觉层级请使用 level
+     * @default 'span'
+     * @example `<CpText tag="p" level="body">段落</CpText>`
+     */
+    readonly tag: {
+        readonly type: PropType<TextTag>;
+        readonly default: "span";
+    };
     /**
      * 自定义颜色
      * 传入有效 CSS 颜色值，覆盖 type 的颜色
@@ -69,14 +104,14 @@ export declare const textProps: {
     };
     /**
      * 文字尺寸
-     * 可以是预设值 (sm/md/lg) 或数字 (像素)
-     * @default 'md'
+     * 可以是预设值 (sm/md/lg) 或数字 (像素)，不传时使用 level 的默认字号
+     * @default undefined
      * @example `<CpText size="lg">大号</CpText>`
      * @example `<CpText :size="20">20像素</CpText>`
      */
     readonly size: {
         readonly type: PropType<TextSize>;
-        readonly default: "md";
+        readonly default: undefined;
     };
     /**
      * 垂直对齐方式

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

@@ -6,7 +6,7 @@ declare function __VLS_template(): {
         suffix?(_: {}): any;
     };
     refs: {};
-    rootEl: HTMLSpanElement;
+    rootEl: any;
 };
 type __VLS_TemplateResult = ReturnType<typeof __VLS_template>;
 declare const __VLS_component: import('vue').DefineComponent<import('vue').ExtractPropTypes<{
@@ -14,13 +14,21 @@ declare const __VLS_component: import('vue').DefineComponent<import('vue').Extra
         readonly type: import('vue').PropType<import('./text').TextType>;
         readonly default: "default";
     };
+    readonly level: {
+        readonly type: import('vue').PropType<import('./text').TextLevel>;
+        readonly default: "body";
+    };
+    readonly tag: {
+        readonly type: import('vue').PropType<import('./text').TextTag>;
+        readonly default: "span";
+    };
     readonly color: {
         readonly type: StringConstructor;
         readonly default: "";
     };
     readonly size: {
         readonly type: import('vue').PropType<import('./text').TextSize>;
-        readonly default: "md";
+        readonly default: undefined;
     };
     readonly align: {
         readonly type: import('vue').PropType<import('./text').TextAlign>;
@@ -107,13 +115,21 @@ declare const __VLS_component: import('vue').DefineComponent<import('vue').Extra
         readonly type: import('vue').PropType<import('./text').TextType>;
         readonly default: "default";
     };
+    readonly level: {
+        readonly type: import('vue').PropType<import('./text').TextLevel>;
+        readonly default: "body";
+    };
+    readonly tag: {
+        readonly type: import('vue').PropType<import('./text').TextTag>;
+        readonly default: "span";
+    };
     readonly color: {
         readonly type: StringConstructor;
         readonly default: "";
     };
     readonly size: {
         readonly type: import('vue').PropType<import('./text').TextSize>;
-        readonly default: "md";
+        readonly default: undefined;
     };
     readonly align: {
         readonly type: import('vue').PropType<import('./text').TextAlign>;
@@ -200,10 +216,12 @@ declare const __VLS_component: import('vue').DefineComponent<import('vue').Extra
     readonly bold: boolean;
     readonly type: import('./text').TextType;
     readonly color: string;
+    readonly tag: import('./text').TextTag;
     readonly dashed: boolean;
     readonly marker: boolean;
     readonly italic: boolean;
     readonly underline: boolean;
+    readonly level: import('./text').TextLevel;
     readonly align: import('./text').TextAlign;
     readonly boxed: boolean;
     readonly strikethrough: boolean;
@@ -219,7 +237,7 @@ declare const __VLS_component: import('vue').DefineComponent<import('vue').Extra
     readonly overlapOffsetY: number;
     readonly overlapColor: string;
     readonly unselectable: boolean;
-}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, HTMLSpanElement>;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
 declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, __VLS_TemplateResult["slots"]>;
 export default _default;
 type __VLS_WithTemplateSlots<T, S> = T & {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cyberpunk-vue/components",
-  "version": "1.14.0",
+  "version": "1.14.1",
   "description": "Cyberpunk Vue components - A futuristic Vue 3 component library",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -25,9 +25,9 @@
   "dependencies": {
     "@floating-ui/dom": "^1.7.6",
     "dayjs": "^1.11.20",
-    "@cyberpunk-vue/hooks": "1.14.0",
-    "@cyberpunk-vue/constants": "1.14.0",
-    "@cyberpunk-vue/theme-chalk": "1.14.0"
+    "@cyberpunk-vue/constants": "1.14.1",
+    "@cyberpunk-vue/hooks": "1.14.1",
+    "@cyberpunk-vue/theme-chalk": "1.14.1"
   },
   "author": "Juxest",
   "license": "MIT",