@kayak-sj/design 1.0.0

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

@@ -0,0 +1,121 @@
+import { FormInstance, FormItemRule } from 'element-plus';
+import { Component } from 'vue';
+/** schema 动态选项（Select / Radio / Checkbox），对齐 Element Plus `{ label, value }` */
+export type KFormSchemaOption = {
+    label: string;
+    value: string;
+};
+/**
+ * design 内置表单控件（与 formComponent/componentRegistry 注册表对齐）。
+ * 不含 `| string`，以便 `component` 字段有补全且拼写错误可编译报错。
+ */
+export type KFormBuiltInComponentType = 'Input' | 'Select' | 'SelectMultiple' | 'DatePicker' | 'Radio' | 'Checkbox' | 'InputNumber' | 'Cascader' | 'TreeSelect' | 'Text' | 'InputMixInput' | 'InputMixSelect' | 'RadioInput' | 'Complex' | 'ScrollSelect' | 'Upload' | 'Tag' | 'TimePicker' | 'Editor';
+/**
+ * 表单项 component 引用：内置控件名或业务 Vue 组件。
+ * 字符串走注册表；Component 对象对齐 legacy `formConfigs` 直接 import 写法。
+ */
+export type KFormComponentRef = KFormBuiltInComponentType | Component;
+/**
+ * 内置控件类型别名（与 KFormBuiltInComponentType 相同）。
+ * 全局可复用业务控件也可通过 registerFormComponents 注册为字符串名。
+ */
+export type KFormComponentType = KFormBuiltInComponentType;
+/**
+ * 表单项声明式配置，对齐旧版 k-form formConfigs。
+ * 查询面板（KPanelQuery）与业务表单（KForm）共用此结构。
+ */
+export interface KFormConfigItem {
+    /** 表单项唯一标识 */
+    id: string;
+    /** 表单项标签 */
+    label?: string;
+    /** 表单项组件（内置名字符串或 legacy 风格直接传入的 Vue 组件） */
+    component: KFormComponentRef;
+    /** 字典类型，选项通过 inject(DICT_KEY).getGroupDict 解析 */
+    dict?: string;
+    /** 表单项组件属性 */
+    componentProps?: Record<string, unknown>;
+    /** 表单项校验规则 */
+    rules?: FormItemRule[];
+    /** false 时不渲染该项 */
+    display?: boolean;
+    /** 布局：另起一行（flex-basis 90%） */
+    newLineStart?: boolean;
+    /** 布局：flex 自动换行 */
+    flex?: boolean | string;
+    /** 表头 label 旁提示（支持 HTML） */
+    toolTip?: string;
+    /** 只读态，渲染为纯文本展示（跳过校验） */
+    readonly?: boolean;
+    /** 禁用态，渲染为灰色控件（仍参与校验） */
+    disabled?: boolean;
+    /** 自定义 class */
+    class?: string;
+    /** true 时使用具名插槽渲染（插槽名为 item.id） */
+    slot?: boolean;
+    /** 字段变更回调（由 KForm 统一触发，不从 componentProps 透传） */
+    onChange?: (value: unknown, item: KFormConfigItem) => void;
+    /**
+     * 本字段变更后需连带重校的其它字段 id（交叉校验）。
+     * 由 KForm 在值更新后自动 `validateField`，无需业务侧手写 onChange。
+     */
+    validatePeers?: string[];
+}
+/**
+ * 带联动声明的 schema 字段（L2 编辑表单）。
+ *
+ * 与 KFormConfigItem 的区别：多了基于 model 的派生函数，由 useFormSchema 解析后再交给 KForm 渲染。
+ * 勿在运行时 mutate 此数组；联动请改 model 或更换 computed schema。
+ */
+export interface KFormSchemaField<T> extends KFormConfigItem {
+    /** 根据当前 model 决定是否显示（覆盖静态 display） */
+    visibleWhen?: (model: T) => boolean;
+    /** 根据当前 model 决定是否只读（纯文本展示，跳过校验） */
+    readonlyWhen?: (model: T) => boolean;
+    /** 根据当前 model 决定是否禁用（灰色控件，仍参与校验） */
+    disabledWhen?: (model: T) => boolean;
+    /** 根据当前 model 生成 Select/Radio/Checkbox 的 options */
+    optionsFromModel?: (model: T) => KFormSchemaOption[];
+    /**
+     * 根据当前 model 追加校验规则（交叉比较等）。
+     * 解析结果 merge 到 `rules` 末尾；配合 `validatePeers` 做对侧重校。
+     */
+    rulesFromModel?: (model: T) => FormItemRule[];
+}
+/**
+ * 表单布局配置
+ */
+export interface KFormLayoutOptions {
+    /** 非 autoLayout 时，每行等分列数 */
+    colLength?: number;
+    /** 是否内联 */
+    inline?: boolean;
+    /** 标签宽度 */
+    labelWidth?: string;
+    /** 标签位置；查询面板默认 right（label 在输入框左侧） */
+    labelPosition?: 'left' | 'right' | 'top';
+    /** true：flex 自动换行（查询面板默认）；false：按 colLength 百分比布局 */
+    autoLayout?: boolean;
+    /** 查询面板模式：隐藏 label，placeholder 使用 label 文案 */
+    hideLabel?: boolean;
+}
+/** KForm 通过 defineExpose 暴露的实例方法（SFC InstanceType 无法稳定推导） */
+export interface KFormInstance<T extends object = Record<string, unknown>> {
+    /** 校验表单，返回当前可见字段快照；失败返回 null */
+    validateFields: () => Promise<T | null>;
+    /** 获取表单已填字段对象（可选指定字段） */
+    getFieldsValue: (fieldIds?: (keyof T & string)[]) => Partial<T>;
+    /** 获取表单查询参数对象（可见字段） */
+    getParams: () => Partial<T>;
+    /** 设置表单已填字段对象 */
+    setFieldsValue: (values: Partial<T>) => void;
+    /** 重置表单为初始值（受控 v-model：恢复首屏 seed 并回写父级） */
+    resetForm: () => void;
+    /** 重置指定字段为初始值 */
+    resetFieldsValue: (fieldIds: (keyof T & string)[]) => void;
+    /** 获取 Element Plus 表单实例引用 */
+    getFormRef: () => FormInstance | undefined;
+    /** 清空表单校验 */
+    clearValidate: () => void;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/components/k-form/types.ts"],"names":[],"mappings":"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"}

package/dist/components/k-form/utils/fieldValue.d.ts

@@ -0,0 +1,113 @@
+/**
+ * 表单字段值收窄工具。
+ *
+ * formModel 存 unknown，绑定 Element Plus 控件前需收窄到各组件接受的类型。
+ * 各 `toXxx` 函数负责「未知值 → 控件可绑定值」；`formatReadonlyText` 负责只读态展示。
+ */
+/** Select / Radio / TreeSelect 等单值控件可绑定的值 */
+export type ScalarFieldValue = string | number | boolean | undefined;
+/** ElOption / ElRadio / ElCheckbox 等选项控件的 value */
+export type OptionFieldValue = string | number;
+/** SelectMultiple / CheckboxGroup 可绑定的多选值 */
+export type CheckboxGroupValue = Array<string | number>;
+/** TreeSelect 树形 options 数据结构 */
+export type TreeSelectData = Record<string, unknown>[];
+/**
+ * Cascader 可绑定的值。
+ * 支持叶子单值、路径数组，或旧版对象形态。
+ */
+export type CascaderFieldValue = string | number | Record<string, unknown> | Array<string | number> | null | undefined;
+/**
+ * DatePicker 可绑定的值。
+ * 单值可为 Date 或格式化字符串；范围可为 Date 元组或字符串元组（取决于 valueFormat）。
+ */
+export type DatePickerFieldValue = string | Date | [Date, Date] | [string, string] | undefined;
+/** ElDatePicker 支持的 type 白名单，用于校验 schema 透传的 type */
+declare const DATE_PICKER_TYPES: readonly ["year", "month", "date", "dates", "datetime", "week", "datetimerange", "daterange", "monthrange", "yearrange"];
+/** ElDatePicker type 联合类型 */
+export type DatePickerType = (typeof DATE_PICKER_TYPES)[number];
+/**
+ * TimePicker 可绑定的值。
+ * 单值可为 Date 或格式化字符串；范围可为 Date 元组或字符串元组（取决于 valueFormat）。
+ */
+export type TimePickerFieldValue = string | Date | [Date, Date] | [string, string] | undefined;
+/** ElTimePicker 支持的 type 白名单 */
+export type TimePickerType = 'time' | 'timerange';
+/**
+ * 收窄为选项控件可绑定的 value。
+ * ElOption 仅接受 string / number，其余类型转为 string。
+ */
+export declare function toOptionValue(value: unknown): OptionFieldValue;
+/**
+ * 收窄为标量字段值。
+ * null / undefined 返回 undefined；其余非标量类型转为 string。
+ */
+export declare function toScalarValue(value: unknown): ScalarFieldValue;
+/**
+ * 收窄为 Input / Textarea 等文本控件可绑定的 string。
+ * null / undefined 返回空字符串。
+ */
+export declare function toStringValue(value: unknown): string;
+/**
+ * 收窄为 CheckboxGroup / SelectMultiple 可绑定的数组。
+ * 非数组返回 []；仅保留 string / number 元素。
+ */
+export declare function toCheckboxGroupValue(value: unknown): CheckboxGroupValue;
+/**
+ * 收窄为 InputNumber 可绑定的 number。
+ * 空值、NaN、无法解析的字符串返回 undefined。
+ */
+export declare function toNumberValue(value: unknown): number | undefined;
+/**
+ * 收窄为 ElDatePicker model-value 可接受的值。
+ * 范围值要求长度为 2 且元素类型一致（全 Date 或全 string）；其余情况回退为 string。
+ */
+export declare function toDatePickerValue(value: unknown): DatePickerFieldValue;
+/**
+ * 校验并收窄 ElDatePicker type。
+ * 不在白名单内时回退为 'date'。
+ */
+export declare function toDatePickerType(type?: string): DatePickerType;
+/**
+ * 收窄为 ElTimePicker model-value 可接受的值。
+ * 范围值要求长度为 2 且元素类型一致（全 Date 或全 string）；其余情况回退为 string。
+ */
+export declare function toTimePickerValue(value: unknown): TimePickerFieldValue;
+/**
+ * 校验并收窄 ElTimePicker type。
+ * 不在白名单内时回退为 'time'。
+ */
+export declare function toTimePickerType(type?: string): TimePickerType;
+/**
+ * 收窄为 ElCascader model-value 可接受的值。
+ * 数组仅保留 string / number 路径段；对象原样透传；其余转为 string。
+ */
+export declare function toCascaderValue(value: unknown): CascaderFieldValue;
+/**
+ * 收窄为 TreeSelect options 树数据。
+ * 非数组返回空数组。
+ */
+export declare function toTreeSelectData(data: unknown): TreeSelectData;
+/**
+ * 在 TreeSelect 树数据中按节点 value 查找 label，供只读态展示。
+ * 默认字段名 value / label / children，与 ElTreeSelect 及机构树数据一致。
+ */
+export declare function findTreeSelectLabel(data: TreeSelectData, targetValue: unknown): string | undefined;
+/** Cascader 节点字段映射（对齐 ElCascader props） */
+export type CascaderFieldMap = {
+    value?: string;
+    label?: string;
+    children?: string;
+};
+/**
+ * 按 Cascader 路径从 options 解析只读文案（默认用 ` / ` 拼接，对齐 ElCascader separator）。
+ * 路径段找不到对应节点时回退为原始值文案。
+ */
+export declare function findCascaderReadonlyText(options: unknown[] | undefined, value: unknown, fieldMap?: CascaderFieldMap, separator?: string): string;
+/**
+ * 只读态展示文案。
+ * null / undefined / 空字符串返回 fallback（默认 '--'）。
+ */
+export declare function formatReadonlyText(value: unknown, fallback?: string): string;
+export {};
+//# sourceMappingURL=fieldValue.d.ts.map

package/dist/components/k-form/utils/fieldValue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fieldValue.d.ts","sourceRoot":"","sources":["../../../../src/components/k-form/utils/fieldValue.ts"],"names":[],"mappings":"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"}

package/dist/components/k-form/utils/fieldValue.js

@@ -0,0 +1,83 @@
+//#region src/components/k-form/utils/fieldValue.ts
+var e = [
+	"year",
+	"month",
+	"date",
+	"dates",
+	"datetime",
+	"week",
+	"datetimerange",
+	"daterange",
+	"monthrange",
+	"yearrange"
+];
+function t(e) {
+	return typeof e == "string" || typeof e == "number" ? e : String(e);
+}
+function n(e) {
+	if (e != null) return typeof e == "string" || typeof e == "number" || typeof e == "boolean" ? e : String(e);
+}
+function r(e) {
+	return e == null ? "" : String(e);
+}
+function i(e) {
+	return Array.isArray(e) ? e.filter((e) => typeof e == "string" || typeof e == "number") : [];
+}
+function a(e) {
+	if (typeof e == "number" && !Number.isNaN(e)) return e;
+	if (e == null || e === "") return;
+	let t = Number(e);
+	return Number.isNaN(t) ? void 0 : t;
+}
+function o(e) {
+	if (e != null) return e instanceof Date || typeof e == "string" || Array.isArray(e) && e.length === 2 && (e.every((e) => e instanceof Date) || e.every((e) => typeof e == "string")) ? e : String(e);
+}
+function s(t) {
+	return t && e.includes(t) ? t : "date";
+}
+function c(e) {
+	if (e != null && e !== "") return e instanceof Date || typeof e == "string" || Array.isArray(e) && e.length === 2 && (e.every((e) => e instanceof Date) || e.every((e) => typeof e == "string")) ? e : String(e);
+}
+function l(e) {
+	return e === "timerange" ? "timerange" : "time";
+}
+function u(e) {
+	return e == null || typeof e == "string" || typeof e == "number" ? e : Array.isArray(e) ? e.filter((e) => typeof e == "string" || typeof e == "number") : typeof e == "object" ? e : String(e);
+}
+function d(e) {
+	return Array.isArray(e) ? e : [];
+}
+function f(e, t) {
+	let r = n(t);
+	if (r !== void 0) for (let t of e) {
+		let e = t.value ?? t.id;
+		if (e != null && String(e) === String(r)) {
+			let e = t.label;
+			return e == null ? void 0 : String(e);
+		}
+		let n = t.children;
+		if (Array.isArray(n)) {
+			let e = f(n, r);
+			if (e) return e;
+		}
+	}
+}
+function p(e, t, n, r = " / ") {
+	let i = u(t);
+	if (i == null || i === "") return m(t);
+	let a = n?.value ?? "value", o = n?.label ?? "label", s = n?.children ?? "children", c = Array.isArray(i) ? i : [i], l = [], d = Array.isArray(e) ? e : [];
+	for (let e of c) {
+		let t = d.find((t) => t != null && String(t[a]) === String(e));
+		if (!t) return l.length ? [...l, ...c.slice(l.length).map(String)].join(r) : m(Array.isArray(i) ? c.join(r) : i);
+		let n = t[o];
+		l.push(String(n != null && n !== "" ? n : e));
+		let u = t[s];
+		d = Array.isArray(u) ? u : [];
+	}
+	return l.length ? l.join(r) : m(t);
+}
+function m(e, t = "--") {
+	return e == null || e === "" ? t : String(e);
+}
+//#endregion
+export { p as findCascaderReadonlyText, f as findTreeSelectLabel, m as formatReadonlyText, u as toCascaderValue, i as toCheckboxGroupValue, s as toDatePickerType, o as toDatePickerValue, a as toNumberValue, t as toOptionValue, n as toScalarValue, r as toStringValue, l as toTimePickerType, c as toTimePickerValue, d as toTreeSelectData };

package/dist/components/k-form/utils/formRules.d.ts

@@ -0,0 +1,11 @@
+import { FormItemRule } from 'element-plus';
+/**
+ * 按组件类型合并默认校验规则。
+ * 隐藏项 / 只读项 / 表单 readonly 时不附加规则（由 KForm 侧判断）。
+ */
+export declare function resolveFormItemRules(item: {
+    component: string | import('vue').Component;
+    componentProps?: Record<string, unknown>;
+    rules?: FormItemRule[];
+}): FormItemRule[];
+//# sourceMappingURL=formRules.d.ts.map

package/dist/components/k-form/utils/formRules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formRules.d.ts","sourceRoot":"","sources":["../../../../src/components/k-form/utils/formRules.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AA6ChD;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE;IACzC,SAAS,EAAE,MAAM,GAAG,OAAO,KAAK,EAAE,SAAS,CAAA;IAC3C,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACxC,KAAK,CAAC,EAAE,YAAY,EAAE,CAAA;CACvB,GAAG,YAAY,EAAE,CAkCjB"}

package/dist/components/k-form/utils/formRules.js

@@ -0,0 +1,44 @@
+//#region src/components/k-form/utils/formRules.ts
+var e = {
+	number: /^\d+$/,
+	phone: /^1\d{10}$/,
+	money: /^(0|[1-9]\d*)(\.\d{1,2})?$/,
+	percentage: /^(?!0(?:\.00?)?$)(?:100(?:\.00?)?|\d{0,2}(?:\.\d{1,2})?)$/
+};
+function t(e, t) {
+	return {
+		validator: (n, r, i) => {
+			if (r === "" || r == null) {
+				i();
+				return;
+			}
+			i(e.test(String(r)) ? void 0 : Error(t));
+		},
+		trigger: "blur"
+	};
+}
+function n(e) {
+	return {
+		validator: (t, n, r) => {
+			let i = Array.isArray(n) ? n : [], a = String(i[0] ?? "").trim(), o = String(i[1] ?? "").trim();
+			if (!a || !o) {
+				r(Error(e));
+				return;
+			}
+			r();
+		},
+		trigger: ["change", "blur"]
+	};
+}
+function r(r) {
+	let i = [...r.rules ?? []];
+	if (typeof r.component != "string") return i;
+	let a = r.componentProps?.type;
+	if (r.component === "Input" && a === "number" && i.push(t(e.number, "请输入合法的正整数")), r.component === "Input" && a === "phone" && i.push(t(e.phone, "请输入正常的手机号")), r.component === "Input" && a === "money" && i.push(t(e.money, "请输入正确金额数值")), r.component === "Input" && a === "percentage" && i.push(t(e.percentage, "请输入正确的数据范围：0.01 ~ 100")), r.component === "InputMixInput") {
+		let e = i.find((e) => e.required);
+		e && i.push(n(String(e.message || "请完整填写")));
+	}
+	return i;
+}
+//#endregion
+export { r as resolveFormItemRules };

package/dist/components/k-form/utils/resolveFormFieldComponent.d.ts

@@ -0,0 +1,13 @@
+import { Component } from 'vue';
+import { KFormBuiltInComponentType, KFormComponentRef } from '../types';
+/** component 是否为内置控件名字符串 */
+export declare function isBuiltinFormComponentType(component: KFormComponentRef): component is KFormBuiltInComponentType;
+/** component 是否为业务自定义 Vue 组件（对齐 legacy formConfigs 直接 import 写法） */
+export declare function isCustomFormComponent(component: KFormComponentRef): component is Component;
+/**
+ * 解析表单项实际渲染组件。
+ * - 字符串 → formComponent 注册表
+ * - Component 对象 → 直接使用（legacy 兼容）
+ */
+export declare function resolveFormFieldComponent(component: KFormComponentRef): Component;
+//# sourceMappingURL=resolveFormFieldComponent.d.ts.map

package/dist/components/k-form/utils/resolveFormFieldComponent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveFormFieldComponent.d.ts","sourceRoot":"","sources":["../../../../src/components/k-form/utils/resolveFormFieldComponent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,KAAK,CAAA;AAGpC,OAAO,KAAK,EAAE,yBAAyB,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAA;AAE5E,4BAA4B;AAC5B,wBAAgB,0BAA0B,CAAC,SAAS,EAAE,iBAAiB,GAAG,SAAS,IAAI,yBAAyB,CAE/G;AAED,oEAAoE;AACpE,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,iBAAiB,GAAG,SAAS,IAAI,SAAS,CAE1F;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,iBAAiB,GAAG,SAAS,CAKjF"}

package/dist/components/k-form/utils/resolveFormFieldComponent.js

@@ -0,0 +1,13 @@
+import { resolveFormComponent as e } from "../formComponent/componentRegistry.js";
+//#region src/components/k-form/utils/resolveFormFieldComponent.ts
+function t(e) {
+	return typeof e == "string";
+}
+function n(e) {
+	return typeof e == "object" || typeof e == "function";
+}
+function r(t) {
+	return n(t) ? t : e(t);
+}
+//#endregion
+export { t as isBuiltinFormComponentType, n as isCustomFormComponent, r as resolveFormFieldComponent };

package/dist/components/k-handle-page/KHandlePage.d.ts

@@ -0,0 +1,51 @@
+type __VLS_Props = {
+    /** 是否显示底部操作栏 */
+    showFooter?: boolean;
+    /** 是否显示提交按钮；false 时仅保留取消 */
+    showSubmit?: boolean;
+    /** 取消按钮文案；false 隐藏取消按钮 */
+    cancelText?: string | false;
+    /** 提交按钮文案；false 隐藏提交按钮（优先级低于 showSubmit） */
+    submitText?: string | false;
+    /** 外部控制的提交 loading（可选，一般不必传） */
+    submitLoading?: boolean;
+    /** 内容区 loading（详情 init 等）；为 true 时同步禁用提交按钮 */
+    loading?: boolean;
+    /** 提交回调；传入后 KHandlePage 自动管理按钮 loading */
+    onSubmit?: () => void | Promise<void>;
+    /** 内容区纵向间距（多块表单/卡片时使用） */
+    gap?: number | string;
+};
+declare var __VLS_1: {}, __VLS_20: {}, __VLS_22: {};
+type __VLS_Slots = {} & {
+    header?: (props: typeof __VLS_1) => any;
+} & {
+    default?: (props: typeof __VLS_20) => any;
+} & {
+    footer?: (props: typeof __VLS_22) => any;
+};
+declare const __VLS_base: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    cancel: () => any;
+    submit: () => any;
+}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onCancel?: (() => any) | undefined;
+    onSubmit?: (() => any) | undefined;
+}>, {
+    onSubmit: () => void | Promise<void>;
+    loading: boolean;
+    cancelText: string | false;
+    showFooter: boolean;
+    gap: number | string;
+    showSubmit: boolean;
+    submitText: string | false;
+    submitLoading: boolean;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};
+//# sourceMappingURL=KHandlePage.vue.d.ts.map

package/dist/components/k-handle-page/KHandlePage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"KHandlePage.vue.d.ts","sourceRoot":"","sources":["../../../src/components/k-handle-page/KHandlePage.vue"],"names":[],"mappings":"AAuIA,KAAK,WAAW,GAAG;IACf,gBAAgB;IAChB,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,4BAA4B;IAC5B,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,0BAA0B;IAC1B,UAAU,CAAC,EAAE,MAAM,GAAG,KAAK,CAAA;IAC3B,4CAA4C;IAC5C,UAAU,CAAC,EAAE,MAAM,GAAG,KAAK,CAAA;IAC3B,gCAAgC;IAChC,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,8CAA8C;IAC9C,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACrC,0BAA0B;IAC1B,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;CACtB,CAAC;AA6OJ,QAAA,IAAI,OAAO,IAAU,EAAE,QAAQ,IAAW,EAAE,QAAQ,IAAY,CAAE;AAClE,KAAK,WAAW,GAAG,EAAE,GACnB;IAAE,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,OAAO,KAAK,GAAG,CAAA;CAAE,GAC3C;IAAE,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,QAAQ,KAAK,GAAG,CAAA;CAAE,GAC7C;IAAE,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,QAAQ,KAAK,GAAG,CAAA;CAAE,CAAC;AAK/C,QAAA,MAAM,UAAU;;;;;;;cAzPD,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;aAF3B,OAAO;gBANJ,MAAM,GAAG,KAAK;gBAJd,OAAO;SAcd,MAAM,GAAG,MAAM;gBAZR,OAAO;gBAIP,MAAM,GAAG,KAAK;mBAEX,OAAO;6EAiQzB,CAAC;AACH,QAAA,MAAM,YAAY,EAAS,eAAe,CAAC,OAAO,UAAU,EAAE,WAAW,CAAC,CAAC;wBACtD,OAAO,YAAY;AAAxC,wBAAyC;AAWzC,KAAK,eAAe,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG;IAChC,QAAO;QACN,MAAM,EAAE,CAAC,CAAC;KACV,CAAA;CACD,CAAC"}

package/dist/components/k-handle-page/KHandlePage.js

@@ -0,0 +1,5 @@
+import e from "./KHandlePage.vue_vue_type_script_setup_true_lang.js";
+//#region src/components/k-handle-page/KHandlePage.vue
+var t = e;
+//#endregion
+export { t as default };

package/dist/components/k-handle-page/KHandlePage.vue_vue_type_script_setup_true_lang.js

@@ -0,0 +1,105 @@
+import e from "../k-button/KButton.js";
+import { Transition as t, computed as n, createBlock as r, createCommentVNode as i, createElementBlock as a, createElementVNode as o, createTextVNode as s, createVNode as c, defineComponent as l, normalizeClass as u, normalizeStyle as d, openBlock as f, ref as p, renderSlot as m, toDisplayString as h, unref as g, useSlots as _, withCtx as v } from "vue";
+import { ElIcon as y } from "element-plus";
+import { Loading as b } from "@element-plus/icons-vue";
+//#region src/components/k-handle-page/KHandlePage.vue?vue&type=script&setup=true&lang.ts
+var x = { class: "k-handle-page" }, S = {
+	key: 0,
+	class: "k-handle-page__header"
+}, C = { class: "k-handle-page__body" }, w = {
+	key: 0,
+	class: "k-handle-page__loading",
+	role: "status",
+	"aria-live": "polite",
+	"aria-busy": "true",
+	"aria-label": "加载中"
+}, T = { class: "k-handle-page__loading-inner" }, E = {
+	key: 1,
+	class: "k-handle-page__footer"
+}, D = /*@__PURE__*/ l({
+	name: "KHandlePage",
+	inheritAttrs: !1,
+	__name: "KHandlePage",
+	props: {
+		showFooter: {
+			type: Boolean,
+			default: !0
+		},
+		showSubmit: {
+			type: Boolean,
+			default: !0
+		},
+		cancelText: {
+			type: [String, Boolean],
+			default: "取消"
+		},
+		submitText: {
+			type: [String, Boolean],
+			default: "确定"
+		},
+		submitLoading: {
+			type: Boolean,
+			default: !1
+		},
+		loading: {
+			type: Boolean,
+			default: !1
+		},
+		onSubmit: {
+			type: Function,
+			default: void 0
+		},
+		gap: { default: 16 }
+	},
+	emits: ["cancel", "submit"],
+	setup(l, { emit: D }) {
+		let O = l, k = D, A = _(), j = p(!1), M = n(() => ({ gap: typeof O.gap == "number" ? `${O.gap}px` : O.gap })), N = n(() => O.cancelText === !1 ? "" : O.cancelText || "取消"), P = n(() => O.submitText === !1 ? "" : O.submitText || "确定"), F = n(() => O.cancelText !== !1), I = n(() => O.showSubmit && O.submitText !== !1), L = n(() => O.submitLoading || O.loading || j.value), R = n(() => !!A.header);
+		async function z() {
+			if (!L.value) {
+				if (O.onSubmit) {
+					j.value = !0;
+					try {
+						await O.onSubmit();
+					} catch {} finally {
+						j.value = !1;
+					}
+					return;
+				}
+				k("submit");
+			}
+		}
+		return (n, p) => (f(), a("div", x, [
+			R.value ? (f(), a("header", S, [m(n.$slots, "header")])) : i("", !0),
+			o("div", C, [c(t, { name: "k-handle-page-loading" }, {
+				default: v(() => [l.loading ? (f(), a("div", w, [o("div", T, [c(g(y), {
+					class: "k-handle-page__loading-icon is-loading",
+					size: 32
+				}, {
+					default: v(() => [c(g(b))]),
+					_: 1
+				}), p[1] ||= o("span", { class: "k-handle-page__loading-text" }, "加载中...", -1)])])) : i("", !0)]),
+				_: 1
+			}), o("div", {
+				class: u(["k-handle-page__content", { "k-handle-page__content--loading": l.loading }]),
+				style: d(M.value)
+			}, [m(n.$slots, "default")], 6)]),
+			l.showFooter ? (f(), a("footer", E, [m(n.$slots, "footer", {}, () => [F.value ? (f(), r(e, {
+				key: 0,
+				onClick: p[0] ||= (e) => k("cancel")
+			}, {
+				default: v(() => [s(h(N.value), 1)]),
+				_: 1
+			})) : i("", !0), I.value ? (f(), r(e, {
+				key: 1,
+				type: "primary",
+				loading: L.value,
+				onClick: z
+			}, {
+				default: v(() => [s(h(P.value), 1)]),
+				_: 1
+			}, 8, ["loading"])) : i("", !0)])])) : i("", !0)
+		]));
+	}
+});
+//#endregion
+export { D as default };

package/dist/components/k-handle-page/index.d.ts

@@ -0,0 +1,3 @@
+export { default as KHandlePage } from './KHandlePage';
+export { useHandlePageInit, type UseHandlePageInitOptions } from './useHandlePageInit';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/k-handle-page/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/k-handle-page/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAC1D,OAAO,EAAE,iBAAiB,EAAE,KAAK,wBAAwB,EAAE,MAAM,qBAAqB,CAAA"}

package/dist/components/k-handle-page/useHandlePageInit.d.ts

@@ -0,0 +1,15 @@
+import { MaybeRefOrGetter } from 'vue';
+export interface UseHandlePageInitOptions {
+    /** 为 true 时不展示 loading（如新增页仅拉机构树） */
+    skipLoading?: MaybeRefOrGetter<boolean>;
+    /** 是否在 onMounted 自动执行 init，默认 true；弹窗场景可设 false 后手动 runInit */
+    immediate?: boolean;
+}
+/**
+ * KHandlePage 维护页 init 加载态：包裹 initPage，编辑/详情态展示局部 loading。
+ */
+export declare function useHandlePageInit(init: () => Promise<void>, options?: UseHandlePageInitOptions): {
+    pageLoading: import('vue').Ref<boolean, boolean>;
+    runInit: () => Promise<void>;
+};
+//# sourceMappingURL=useHandlePageInit.d.ts.map

package/dist/components/k-handle-page/useHandlePageInit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useHandlePageInit.d.ts","sourceRoot":"","sources":["../../../src/components/k-handle-page/useHandlePageInit.ts"],"names":[],"mappings":"AAAA,OAAO,EAA2B,KAAK,gBAAgB,EAAE,MAAM,KAAK,CAAA;AAEpE,MAAM,WAAW,wBAAwB;IACvC,qCAAqC;IACrC,WAAW,CAAC,EAAE,gBAAgB,CAAC,OAAO,CAAC,CAAA;IACvC,+DAA+D;IAC/D,SAAS,CAAC,EAAE,OAAO,CAAA;CACpB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,EAAE,wBAAwB;;;EAwB9F"}

package/dist/components/k-handle-page/useHandlePageInit.js

@@ -0,0 +1,21 @@
+import { onMounted as e, ref as t, toValue as n } from "vue";
+//#region src/components/k-handle-page/useHandlePageInit.ts
+function r(r, i) {
+	let a = t(!1);
+	async function o() {
+		(n(i?.skipLoading) ?? !1) || (a.value = !0);
+		try {
+			await r();
+		} finally {
+			a.value = !1;
+		}
+	}
+	return i?.immediate !== !1 && e(() => {
+		o();
+	}), {
+		pageLoading: a,
+		runInit: o
+	};
+}
+//#endregion
+export { r as useHandlePageInit };