@kayak-sj/design 1.0.49 → 1.0.51

package/dist/theme/index.d.ts

@@ -6,15 +6,19 @@
  */
 export type DesignTheme = 'kayak' | 'blue-pro' | 'dark';
 /**
- * 获取当前设计主题
+ * 获取当前设计主题（读 `html[data-theme]`）。
+ *
+ * @returns 当前主题标识；未设置或未知时回退 `'kayak'`
  */
 export declare function getDesignTheme(): DesignTheme;
 /**
- * 切换设计主题（写入 html[data-theme] 并持久化到 localStorage）
+ * 切换设计主题（写入 `html[data-theme]` 并持久化到 localStorage）。
+ *
+ * @param theme - 目标主题，见 {@link DesignTheme}
  */
 export declare function setDesignTheme(theme: DesignTheme): void;
 /**
  * 从 localStorage 恢复上次选择的主题；无记录时使用 kayak 默认主题。
- * 应用启动时尽早调用（建议在 main.ts 顶部）。
+ * 应用启动时尽早调用（建议在 `main.ts` 顶部）。
  */
 export declare function initDesignTheme(): void;

package/dist/utils/createStubComponent.d.ts

@@ -1,7 +1,18 @@
-/** 迁移占位组件，业务页接入后可逐个替换为真实实现 */
+/**
+ * 创建迁移占位组件，业务页接入后可逐个替换为真实实现。
+ *
+ * @param name - 组件名（同时作为 `defineComponent.name` 与 `data-component`）
+ * @returns 仅渲染占位文案的 Vue 组件
+ */
 export declare function createStubComponent(name: string): import('vue').DefineComponent<{}, () => import('vue').VNode<import('vue').RendererNode, import('vue').RendererElement, {
     [key: string]: any;
 }>, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
+/**
+ * Lucide 图标未命中时的占位组件（显示首字母虚线框）。
+ *
+ * @param name - 原始图标 slug，用于 `title` / `data-icon`
+ * @returns 占位 span 组件
+ */
 export declare function createLucideStubComponent(name?: string): import('vue').DefineComponent<{}, () => import('vue').VNode<import('vue').RendererNode, import('vue').RendererElement, {
     [key: string]: any;
 }>, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;

package/dist/utils/validators.d.ts

@@ -23,9 +23,10 @@ export declare const DECIMAL_MONEY_PATTERN: RegExp;
 /**
  * 正则校验器工厂（对齐 legacy createValidator / cms-base 同名函数）。
  *
- * @param pattern  待测正则
- * @param message  校验失败提示
- * @param required 为 false 时，空值直接通过；为 true 时空值也报错
+ * @param pattern - 待测正则
+ * @param message - 校验失败提示
+ * @param required - 为 false 时，空值直接通过；为 true 时空值也报错
+ * @returns Element Plus `FormItemRule['validator']`
  */
 export declare function createPatternValidator(pattern: RegExp, message: string, required?: boolean): NonNullable<FormItemRule['validator']>;
 /**
@@ -42,21 +43,39 @@ export declare function cnAlphaNumRule(max: number, label: string, required?: bo
  * 比 `cnAlphaNumRule` 宽松，适用于权益名、合同名、商品名等允许标点的情况。
  *
  * 通常与 `{ required: true, message: '...' }` 组合使用。
+ *
+ * @param max - 最大长度
+ * @param label - 字段名，用于失败提示
+ * @param required - 是否必填（空值是否报错）
  */
 export declare function mixedNameRule(max: number, label: string, required?: boolean): FormItemRule;
 /**
  * 字母 / 数字 / 下划线编码，长度 1–max。
  * 适用于商品编号、微信批次号、支付宝活动 ID 等。
+ *
+ * @param max - 最大长度
+ * @param label - 字段名，用于失败提示
+ * @param required - 是否必填（空值是否报错）
  */
 export declare function alphaNumCodeRule(max: number, label: string, required?: boolean): FormItemRule;
 /**
  * 手机号校验（`PHONE_PATTERN`）。
  * 仅含 validator，required 提示需由调用方另配 `{ required: true, message: '...' }`。
+ *
+ * @param message - 校验失败提示
  */
 export declare function phoneRule(message?: string): FormItemRule;
-/** 统一社会信用代码校验（`USC_CODE_PATTERN`） */
+/**
+ * 统一社会信用代码校验（`USC_CODE_PATTERN`）。
+ *
+ * @param message - 校验失败提示
+ */
 export declare function uscCodeRule(message?: string): FormItemRule;
-/** 银行打款账号校验（`BANK_ACCOUNT_PATTERN`），1–20 位数字 */
+/**
+ * 银行打款账号校验（`BANK_ACCOUNT_PATTERN`），1–20 位数字。
+ *
+ * @param message - 校验失败提示
+ */
 export declare function bankAccountRule(message?: string): FormItemRule;
 /**
  * HTTP/HTTPS 链接校验（`HTTP_URL_PATTERN`）。
@@ -71,14 +90,22 @@ export declare function positiveIntRule(message?: string, required?: boolean): F
 /**
  * 非负整数（含 0）；空值不校验。
  * 适用于必填的数量类字段，如「同业合作案例数量」。
+ *
+ * @param message - 校验失败提示
  */
 export declare function nonNegativeIntRule(message: string): FormItemRule;
 /**
  * 非负整数或空串；空值通过。
  * 适用于选填的数量类字段，如「人员数量」「分公司数量」。
+ *
+ * @param message - 校验失败提示
  */
 export declare function optionalNonNegativeIntRule(message: string): FormItemRule;
-/** 18 位二代居民身份证（`ID_CODE_PATTERN`） */
+/**
+ * 18 位二代居民身份证（`ID_CODE_PATTERN`）。
+ *
+ * @param required - 是否必填
+ */
 export declare function idCodeRule(required?: boolean): FormItemRule;
 /**
  * 金额校验规则组（返回 `[required, validator]` 两条，直接赋给 `rules`）。
@@ -87,6 +114,11 @@ export declare function idCodeRule(required?: boolean): FormItemRule;
  * - 整数位最多 `maxInt`（默认 11），小数最多 2 位
  * - `required: false` 时空值跳过格式校验（对客优惠价等选填场景）
  *
+ * @param label - 字段名，用于「请输入{label}」等提示
+ * @param opts.required - 是否必填，默认 `true`
+ * @param opts.maxInt - 整数最大位数，默认 `11`
+ * @returns Element Plus `FormItemRule[]`
+ *
  * @example
  * rules: moneyRule('成本价')
  * rules: moneyRule('对客优惠价', { required: false })

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kayak-sj/design",
-  "version": "1.0.49",
+  "version": "1.0.51",
   "type": "module",
   "description": "PC 组件库（Vue3 + Element Plus，对应旧 @kayak/kayak-design-vue2）",
   "license": "ISC",
@@ -24,11 +24,6 @@
       "types": "./src/types/design-subpaths.d.ts",
       "default": "./src/styles/tokens/_index.scss"
     },
-    "./components": {
-      "types": "./dist/components/index.d.ts",
-      "import": "./dist/components/index.js",
-      "default": "./dist/components/index.js"
-    },
     "./echarts": {
       "types": "./dist/components/k-echarts/index.d.ts",
       "import": "./dist/components/k-echarts/index.js",
@@ -73,7 +68,7 @@
     "element-plus": "2.14.4",
     "lucide-vue-next": "^1.0.0",
     "sass": "^1.89.2",
-    "typescript": "^5.8.2",
+    "typescript": "^6.0.3",
     "vite": "^8.1.5",
     "vitest": "^4.1.10",
     "vue": "^3.5.13",

package/src/styles/components/_k-handle-page.scss

@@ -5,13 +5,16 @@
   min-height: 100%;
 
   /**
-   * 与 footer 对称：相对 AdminLayout el-scrollbar 吸顶。
-   * top 留出页边距；::before 遮住「页边距空隙」里往上钻的内容。
+   * 叠层约定（与 AdminTags 对齐）：
+   * 2  — sticky 壳（本页 header/footer、页签），只压文档流
+   * 10 — 活动等业务面板（如右侧抽屉）
+   * 12 — 本页 loading
+   * 勿把 header/footer 提到 ≥10，否则会盖住面板内 ElImageViewer 预览
    */
   &__header {
     position: sticky;
     top: var(--k-handle-page-inset-y, var(--k-page-padding-y));
-    z-index: 11;
+    z-index: 2;
     flex-shrink: 0;
     background: var(--k-color-bg-surface);
 
@@ -93,7 +96,7 @@
   &__footer {
     position: sticky;
     bottom: 0;
-    z-index: 10;
+    z-index: 2;
     flex-shrink: 0;
     display: flex;
     justify-content: center;

package/dist/assets/Complex-DIKmdv9F.css

@@ -1 +0,0 @@
-.k-form-complex[data-v-f767d9ba]{flex-wrap:nowrap;align-items:center;gap:8px;width:100%;display:flex}.k-form-complex[data-v-f767d9ba] .k-form-input,.k-form-complex[data-v-f767d9ba] .k-form-select{flex:none;min-width:0}.k-form-complex[data-v-f767d9ba] .k-form-select .el-select{width:var(--k-form-complex-select-width,120px)}.k-form-complex[data-v-f767d9ba] .k-form-input .el-input{width:var(--k-form-complex-input-width,120px)}.k-form-complex--stretch[data-v-f767d9ba] .k-form-input,.k-form-complex--stretch[data-v-f767d9ba] .k-form-select{flex:1 1 0}.k-form-complex--stretch[data-v-f767d9ba] .k-form-select .el-select,.k-form-complex--stretch[data-v-f767d9ba] .k-form-input .el-input{width:100%}