@kayak-sj/design 1.0.64 → 1.0.66

package/dist/assets/{index-Biv6Btn_.css → index-o6CgEMYr.css}

@@ -1 +1 @@
-.k-icon[data-v-6fd081ab]{vertical-align:middle;flex-shrink:0;display:inline-block}.k-long-page-panel[data-v-9d6e7832]{background:var(--k-color-bg-surface,#fff);width:100%}.k-long-page-panel__title[data-v-9d6e7832]{height:50px;color:var(--k-color-text-regular,#333);padding-left:20px;font-size:16px;font-weight:700;line-height:70px;position:relative}.k-long-page-panel__title[data-v-9d6e7832]:after{content:"";background:var(--k-color-primary);border-radius:2px;width:30px;height:3px;position:absolute;bottom:0;left:23px}.k-long-page-panel__content[data-v-9d6e7832]{padding:10px 20px}.k-long-page[data-v-ac934c5d]{z-index:1000}.k-long-page__panel[data-v-ac934c5d]{margin-top:10px}.k-long-page__nav[data-v-ac934c5d]{z-index:12;background:var(--k-color-bg-surface,#fff);width:80px;min-height:30px;box-shadow:var(--k-shadow-md,0 0 14px 0 #cbcbcb8f);cursor:grab;-webkit-user-select:none;user-select:none;border-radius:10px 0 0 10px;position:fixed;top:33%;right:0}.k-long-page__nav[data-v-ac934c5d]:active{cursor:grabbing}.k-long-page__nav-item[data-v-ac934c5d]{text-align:center;cursor:pointer;width:100%;color:var(--k-color-text-regular,#606266);flex-direction:column;align-items:center;padding:10px 0;display:flex}.k-long-page__nav-item>span[data-v-ac934c5d]{font-size:12px;line-height:2}.k-long-page__nav-item-icon--active[data-v-ac934c5d]{display:none}.k-long-page__nav-item[data-v-ac934c5d]:hover{color:var(--k-color-primary-hover,var(--k-color-primary))}.k-long-page__nav-item:hover .k-long-page__nav-item-icon--default[data-v-ac934c5d]{display:none}.k-long-page__nav-item:hover .k-long-page__nav-item-icon--active[data-v-ac934c5d]{display:initial}.k-table-column__radio[data-v-578909bc] .el-radio__label{display:none}.k-table-column__tip[data-v-578909bc]{cursor:help;vertical-align:middle;border:1px solid;border-radius:50%;justify-content:center;align-items:center;width:14px;height:14px;margin-left:4px;font-size:10px;line-height:1;display:inline-flex}.k-table-column-selector__trigger[data-v-e0b3cf31]{cursor:pointer;background:0 0;border:none;justify-content:center;align-items:center;width:28px;height:28px;padding:0;display:inline-flex}.k-table-column-selector__icon[data-v-e0b3cf31]{width:18px;height:18px;color:var(--el-text-color-regular);background:linear-gradient(currentColor,currentColor) 0 2px/100% 2px no-repeat,linear-gradient(currentColor,currentColor) 0 8px/100% 2px no-repeat,linear-gradient(currentColor,currentColor) 0 14px/70% 2px no-repeat;display:inline-block}.k-table-column-selector__header[data-v-e0b3cf31]{justify-content:space-between;align-items:center;height:40px;padding:0 10px;font-size:16px;font-weight:500;display:flex}.k-table-column-selector__divider[data-v-e0b3cf31]{margin:4px 0 12px}.k-table-column-selector__content[data-v-e0b3cf31]{flex-direction:column;gap:10px;max-height:300px;padding:0 10px 10px;display:flex;overflow-y:auto}.k-table-toolbar__main[data-v-bff19ed1]{align-items:center;min-height:30px;margin-bottom:4px;display:flex;position:relative}.k-table-toolbar__header[data-v-bff19ed1]{flex:1}.k-table-toolbar__extra[data-v-bff19ed1]{margin-left:auto}.k-table-toolbar__divider[data-v-bff19ed1]{background:var(--el-border-color-lighter);height:1px;margin:15px 0}.k-table-toolbar__selection[data-v-bff19ed1]{white-space:nowrap;margin-top:5px;font-size:12px}.k-table__sort-handle[data-v-ccb6f7c6]{cursor:grab;color:var(--el-text-color-secondary);letter-spacing:-2px;-webkit-user-select:none;user-select:none;display:inline-block}
+.k-icon[data-v-6fd081ab]{vertical-align:middle;flex-shrink:0;display:inline-block}.k-long-page-panel[data-v-9d6e7832]{background:var(--k-color-bg-surface,#fff);width:100%}.k-long-page-panel__title[data-v-9d6e7832]{height:50px;color:var(--k-color-text-regular,#333);padding-left:20px;font-size:16px;font-weight:700;line-height:70px;position:relative}.k-long-page-panel__title[data-v-9d6e7832]:after{content:"";background:var(--k-color-primary);border-radius:2px;width:30px;height:3px;position:absolute;bottom:0;left:23px}.k-long-page-panel__content[data-v-9d6e7832]{padding:10px 20px}.k-long-page[data-v-ac934c5d]{z-index:1000}.k-long-page__panel[data-v-ac934c5d]{margin-top:10px}.k-long-page__nav[data-v-ac934c5d]{z-index:12;background:var(--k-color-bg-surface,#fff);width:80px;min-height:30px;box-shadow:var(--k-shadow-md,0 0 14px 0 #cbcbcb8f);cursor:grab;-webkit-user-select:none;user-select:none;border-radius:10px 0 0 10px;position:fixed;top:33%;right:0}.k-long-page__nav[data-v-ac934c5d]:active{cursor:grabbing}.k-long-page__nav-item[data-v-ac934c5d]{text-align:center;cursor:pointer;width:100%;color:var(--k-color-text-regular,#606266);flex-direction:column;align-items:center;padding:10px 0;display:flex}.k-long-page__nav-item>span[data-v-ac934c5d]{font-size:12px;line-height:2}.k-long-page__nav-item-icon--active[data-v-ac934c5d]{display:none}.k-long-page__nav-item[data-v-ac934c5d]:hover{color:var(--k-color-primary-hover,var(--k-color-primary))}.k-long-page__nav-item:hover .k-long-page__nav-item-icon--default[data-v-ac934c5d]{display:none}.k-long-page__nav-item:hover .k-long-page__nav-item-icon--active[data-v-ac934c5d]{display:initial}.k-table-column__radio[data-v-578909bc] .el-radio__label{display:none}.k-table-column__tip[data-v-578909bc]{cursor:help;vertical-align:middle;border:1px solid;border-radius:50%;justify-content:center;align-items:center;width:14px;height:14px;margin-left:4px;font-size:10px;line-height:1;display:inline-flex}.k-table-column-selector__trigger[data-v-e0b3cf31]{cursor:pointer;background:0 0;border:none;justify-content:center;align-items:center;width:28px;height:28px;padding:0;display:inline-flex}.k-table-column-selector__icon[data-v-e0b3cf31]{width:18px;height:18px;color:var(--el-text-color-regular);background:linear-gradient(currentColor,currentColor) 0 2px/100% 2px no-repeat,linear-gradient(currentColor,currentColor) 0 8px/100% 2px no-repeat,linear-gradient(currentColor,currentColor) 0 14px/70% 2px no-repeat;display:inline-block}.k-table-column-selector__header[data-v-e0b3cf31]{justify-content:space-between;align-items:center;height:40px;padding:0 10px;font-size:16px;font-weight:500;display:flex}.k-table-column-selector__divider[data-v-e0b3cf31]{margin:4px 0 12px}.k-table-column-selector__content[data-v-e0b3cf31]{flex-direction:column;gap:10px;max-height:300px;padding:0 10px 10px;display:flex;overflow-y:auto}.k-table-toolbar__main[data-v-bff19ed1]{align-items:center;min-height:30px;margin-bottom:4px;display:flex;position:relative}.k-table-toolbar__header[data-v-bff19ed1]{flex:1}.k-table-toolbar__extra[data-v-bff19ed1]{margin-left:auto}.k-table-toolbar__divider[data-v-bff19ed1]{background:var(--el-border-color-lighter);height:1px;margin:15px 0}.k-table-toolbar__selection[data-v-bff19ed1]{white-space:nowrap;margin-top:5px;font-size:12px}.k-table__sort-handle[data-v-8ef38691]{cursor:grab;color:var(--el-text-color-secondary);letter-spacing:-2px;-webkit-user-select:none;user-select:none;display:inline-block}

package/dist/components/k-form/composables/useKFormFields.d.ts

@@ -6,7 +6,7 @@ export interface FieldOption {
     disabled?: boolean;
 }
 /**
- * 表单项展示层逻辑：可见性过滤、查询区 `hideLabel`、字典选项、flex 布局。
+ * 表单项展示层逻辑：可见性过滤、查询区 `hideLabel`、字典选项。
  * 字典通过 `inject(DICT_KEY)`，与 KTable 列翻译共用同一数据源。
  *
  * @param options.formConfigs - 表单字段配置（响应式）

package/dist/components/k-form/types.d.ts

@@ -39,10 +39,14 @@ export interface KFormConfigItem {
     rules?: FormItemRule[];
     /** false 时不渲染该项 */
     display?: boolean;
-    /** 布局：另起一行（flex-basis 90%） */
+    /** 布局：另起一行（标准控件占第 1 列；宽内容/自定义整行） */
     newLineStart?: boolean;
-    /** 布局：flex 自动换行 */
-    flex?: boolean | string;
+    /**
+     * 覆盖栅格统一控件宽度（仅本字段）。
+     * - `'full'`：整行铺满，取消 max-width
+     * - number / string：如 `480` / `'480px'`，作为控件 max-width（建议配合 newLineStart）
+     */
+    controlWidth?: 'full' | number | string;
     /** 表头 label 旁提示（支持 HTML） */
     toolTip?: string;
     /** 只读态，渲染为纯文本展示（跳过校验） */

package/dist/components/k-table/KTable.d.ts

@@ -22,6 +22,7 @@ declare const __VLS_export: <T = Record<string, unknown>>(__VLS_props: NonNullab
     expose: (exposed: import('vue').ShallowUnwrapRef<{
         getTableRef: () => TableInstance | undefined;
         getQueryRef: () => KPanelQueryInstance | undefined;
+        getColumnDisplay: () => Record<string, boolean>;
         getSelection: () => T[];
         clearSelection: () => void;
         toggleRowSelection: (row: T, selected?: boolean) => void;

package/dist/components/k-table/composables/useKTable.d.ts

@@ -19,6 +19,8 @@ export interface KTableInstance<T = Record<string, unknown>> {
     getTableRef: () => TableInstance | undefined;
     /** 获取内嵌 KPanelQuery 实例 */
     getQueryRef: () => KPanelQueryInstance | undefined;
+    /** 获取有效列显隐快照（包含缓存；禁用列设置时全部可见） */
+    getColumnDisplay: () => Record<string, boolean>;
     /** 获取当前多选行 */
     getSelection: () => T[];
     /** 清空多选 */
@@ -150,6 +152,7 @@ export declare function useKTable<T>(options: UseKTableOptions<T>): {
     resetColumnDisplay: () => void;
     getTableRef: () => TableInstance | undefined;
     getQueryRef: () => KPanelQueryInstance | undefined;
+    getColumnDisplay: () => Record<string, boolean>;
     getSelection: () => T[];
     clearSelection: () => void;
     toggleRowSelection: (row: T, selected?: boolean) => void;

package/dist/components/k-table/index.d.ts

@@ -31,4 +31,4 @@ export { useKTableCrossPageSelection, type KTableSelectionMode, type UseKTableCr
 export { useTableRadio } from './composables/useTableRadio';
 export { useTableTreeLoad, type TreeLoadHandler } from './composables/useTableTreeLoad';
 export { useTableRowSort } from './composables/useTableRowSort';
-export { convertDownloadCol, exportKTableReport, exportKTableReportData, exportReportData, exportReportTable, pickExportColumns, useExportKTableReport, type ExportKTableReportOptions, type KTableExportApi, type KTableExportPayload, type PickExportColumnsOptions, type UseExportKTableReportOptions } from './report';
+export { convertDownloadCol, exportKTableReport, exportKTableReportData, exportReportData, exportReportTable, pickExportColumns, useExportKTableReport, type ExportColumnDisplayOptions, type ExportKTableReportOptions, type KTableExportApi, type KTableExportPayload, type PickExportColumnsOptions, type UseExportKTableReportOptions } from './report';

package/dist/components/k-table/report/exportKTableReport.d.ts

@@ -1,49 +1,34 @@
 import { Ref } from 'vue';
 import { KTableInstance } from '../composables/useKTable';
 import { KTableColumn } from '../types';
-import { KTableExportApi } from './types';
 import { PickExportColumnsOptions } from './pickExportColumns';
-/**
- * {@link exportKTableReport} 入参。
- *
- * @typeParam T - 表格行数据类型
- */
-export interface ExportKTableReportOptions<T> extends PickExportColumnsOptions {
-    /** KTable 实例 ref（需能调用 `getQueryRef()?.getParams()`） */
-    tableRef: Ref<KTableInstance<T> | undefined>;
-    /** 参与导出的列配置，会再经 `pickExportColumns` 过滤 */
+import { KTableExportApi } from './types';
+/** 导出列显隐配置；不提供映射时可通过表格实例读取。 */
+export interface ExportColumnDisplayOptions<T> {
+    /** 显式列显隐映射；缺省的 key 视为可见，required 列始终保留 */
+    columnDisplay?: Record<string, boolean>;
+    /** 默认 true：自动读取表格列设置（含缓存）；false 时忽略显隐映射 */
+    respectColumnDisplay?: boolean;
+    /** 列 key 计算；index 始终为传入 columns 的原始下标 */
+    getExportColumnKey?: (column: KTableColumn<T>, index: number) => string;
+}
+export interface ExportKTableReportOptions<T> extends PickExportColumnsOptions, ExportColumnDisplayOptions<T> {
+    tableRef: Ref<KTableInstance<T> | null | undefined>;
+    /** 完整列配置；内部统一过滤 UI 列与操作列 */
     columns: KTableColumn<T>[];
-    /** 导出接口；入参为 `{ globColumnlist, jsondata }` */
     exportApi: KTableExportApi;
-    /** 与列表 `:convert-params` 保持一致 */
+    /** 与列表 :convert-params 保持一致 */
     convertParams?: (params: Record<string, unknown>) => Record<string, unknown>;
 }
-/**
- * 导出当前 KTable 查询条件下的报表。
- *
- * 从 `tableRef` 读取查询参数，经 `convertParams` 后与列配置一并交给 `exportApi`。
- * 需要防重 / 响应式列时请用 {@link useExportKTableReport}。
- *
- * @typeParam T - 表格行数据类型
- * @param options - 见 {@link ExportKTableReportOptions}
- * @returns `exportApi` 的 Promise 结果
- */
+/** 导出当前查询条件的报表；列显隐可由 tableRef 自动读取，避免页面维护重复状态。 */
 export declare function exportKTableReport<T>(options: ExportKTableReportOptions<T>): Promise<unknown>;
-/**
- * 弹窗等场景：直接传入已转换的 `jsondata` 导出报表（不读表格查询区）。
- *
- * @typeParam T - 表格行数据类型
- * @param options.columns - 参与导出的列配置
- * @param options.jsondata - 已转换的导出查询参数
- * @param options.exportApi - 导出接口
- * @returns `exportApi` 的 Promise 结果
- */
+/** 弹窗等场景：直接传入已转换的查询参数，不读取表格查询区。 */
 export declare function exportKTableReportData<T>(options: {
     columns: KTableColumn<T>[];
     jsondata: Record<string, unknown>;
     exportApi: KTableExportApi;
-} & PickExportColumnsOptions): Promise<unknown>;
-/** @deprecated 使用 {@link exportKTableReport} */
+} & PickExportColumnsOptions & ExportColumnDisplayOptions<T>): Promise<unknown>;
+/** @deprecated 使用 exportKTableReport */
 export declare const exportReportTable: typeof exportKTableReport;
-/** @deprecated 使用 {@link exportKTableReportData} */
+/** @deprecated 使用 exportKTableReportData */
 export declare const exportReportData: typeof exportKTableReportData;

package/dist/components/k-table/report/index.d.ts

@@ -1,5 +1,5 @@
 export type { KTableExportApi, KTableExportPayload } from './types';
 export { convertDownloadCol } from './convertDownloadCol';
 export { pickExportColumns, type PickExportColumnsOptions } from './pickExportColumns';
-export { exportKTableReport, exportKTableReportData, exportReportData, exportReportTable, type ExportKTableReportOptions } from './exportKTableReport';
+export { exportKTableReport, exportKTableReportData, exportReportData, exportReportTable, type ExportColumnDisplayOptions, type ExportKTableReportOptions } from './exportKTableReport';
 export { useExportKTableReport, type UseExportKTableReportOptions } from './useExportKTableReport';

package/dist/components/k-table/report/pickExportColumns.d.ts

@@ -1,8 +1,14 @@
 import { KTableColumn } from '../types';
 export interface PickExportColumnsOptions {
-    /** 是否排除操作列 */
+    /**
+     * 是否排除操作列（`type/prop === 'operates'`）。
+     * 推荐统一使用此项去除操作列，而不是 `excludeLast`。
+     */
     excludeOperates?: boolean;
-    /** 是否排除最后一列 */
+    /**
+     * 是否排除最后一列（兼容旧用法，常用于去掉末尾操作列）。
+     * @deprecated 使用 `excludeOperates` 替代
+     */
     excludeLast?: boolean;
 }
 /** 按规则筛选参与导出的列（序号/勾选/单选/展开等 UI 列不参与导出） */

package/dist/components/k-table/report/useExportKTableReport.d.ts

@@ -10,7 +10,7 @@ import { PickExportColumnsOptions } from './pickExportColumns';
  */
 export interface UseExportKTableReportOptions<T> {
     /** KTable 实例 ref（需能调用 `getQueryRef()?.getParams()`） */
-    tableRef: Ref<KTableInstance<T> | undefined>;
+    tableRef: Ref<KTableInstance<T> | null | undefined>;
     /**
      * 参与导出的列配置；支持 plain / ref / getter。
      * 实际导出前会再经 `pickExportColumns` 过滤 UI 列。
@@ -26,19 +26,34 @@ export interface UseExportKTableReportOptions<T> {
      * 勿用 `MaybeRefOrGetter`，避免与 getter 混淆。
      */
     convertParams?: (params: Record<string, unknown>) => Record<string, unknown>;
-    /** 是否排除操作列（`type/prop === 'operates'`）；支持 plain / ref / getter */
+    /** 是否排除操作列（`type/prop === 'operates'`）；支持 plain / ref / getter。推荐用此项去除操作列 */
     excludeOperates?: MaybeRefOrGetter<boolean | undefined>;
-    /** 是否排除最后一列（常用于去掉操作列）；支持 plain / ref / getter */
+    /**
+     * 是否排除最后一列（常用于去掉末尾操作列）；支持 plain / ref / getter。
+     * @deprecated 使用 `excludeOperates` 替代
+     */
     excludeLast?: MaybeRefOrGetter<boolean | undefined>;
+    /**
+     * KTable 当前列显隐映射；支持 plain / ref / getter。
+     * 传入后按列设置面板的当前显隐状态过滤导出列。
+     */
+    columnDisplay?: MaybeRefOrGetter<Record<string, boolean> | undefined>;
+    /** 默认 true：自动读取表格列显隐（含缓存）；false 时关闭联动；显式传入映射始终生效 */
+    respectColumnDisplay?: MaybeRefOrGetter<boolean | undefined>;
+    /** 自定义列 key；index 为原始 columns 下标 */
+    getExportColumnKey?: (column: KTableColumn<T>, index: number) => string;
+    /** 自定义错误文案；返回 void 时使用默认提示 */
+    onExportError?: (error: unknown) => string | void;
 }
 /**
- * KTable 报表导出 composable（adaptable：`columns` / `exclude*` 支持 ref 或 getter）。
+ * KTable 报表导出 composable（adaptable：`columns` / `exclude*` / `columnDisplay` 支持 ref 或 getter）。
  *
  * 调用 `exportTable()` 时会：
  * 1. 若已在导出中则直接 return（由 `exportLoading` 防重）
  * 2. `toValue` 解析 reactive 入参
  * 3. 委托 {@link exportKTableReport} 拉取查询条件并请求 `exportApi`
- * 4. `finally` 中复位 loading
+ * 4. 失败时优先展示后端 `head_ret_msg`（或通过 `onExportError` 自定义）
+ * 5. `finally` 中复位 loading
  *
  * @typeParam T - 表格行数据类型
  * @param options - 导出配置，见 {@link UseExportKTableReportOptions}
@@ -55,27 +70,18 @@ export interface UseExportKTableReportOptions<T> {
  *   columns: userColumns,
  *   exportApi: EXPORT_USER_LIST,
  *   convertParams: convertUserParams, // 与 <KTable :convert-params="..." /> 一致
- *   excludeLast: true                 // 去掉末尾操作列
+ *   excludeOperates: true,            // 去掉操作列
+ *   respectColumnDisplay: true        // 自动联动列设置面板显隐及缓存
  * })
  *
  * // 模板：
- * // <KButton :loading="exportLoading" @click="exportTable">导出</KButton>
  * // <KTable ref="tableRef" :columns="userColumns" :convert-params="convertUserParams" ... />
- * ```
- *
- * @example
- * ```ts
- * // columns / exclude* 也可传入 getter，随权限或视图切换实时生效
- * const { exportTable } = useExportKTableReport({
- *   tableRef,
- *   columns: () => (isAdmin.value ? adminColumns : userColumns),
- *   exportApi: EXPORT_USER_LIST,
- *   excludeOperates: () => !showOperates.value
- * })
+ * // <KButton :loading="exportLoading" @click="exportTable">导出</KButton>
  * ```
  */
 export declare function useExportKTableReport<T>(options: UseExportKTableReportOptions<T>): {
-    exportTable: () => Promise<void>;
+    exportTable: (asynchronous?: boolean) => Promise<void>;
+    asyncExportTable: () => Promise<void>;
     exportLoading: Ref<boolean, boolean>;
 };
 export type { PickExportColumnsOptions };