@guoyg578/k-ui 0.1.5 → 0.1.6

package/dist/components/KUpload.vue.d.ts

@@ -9,6 +9,8 @@ export interface UploadFile {
     raw?: File;
     /** naive-ui compatible raw File alias */
     file?: File;
+    /** 内部: 取消进行中的上传 (仅默认 XHR 通道可中止) */
+    abort?: () => void;
 }
 export interface UploadFileInfo {
     id: string;
@@ -31,6 +33,16 @@ type __VLS_Props = {
     accept?: string;
     /** bytes */
     maxSize?: number;
+    /** 上传地址 —— 设置后启用内置 XHR 通道 (FormData POST); 不设则不会有默认传输 */
+    action?: string;
+    /** XHR 请求头 */
+    headers?: Record<string, string>;
+    /** 携带 cookie */
+    withCredentials?: boolean;
+    /** FormData 中文件字段名 (默认 'file') */
+    name?: string;
+    /** FormData 附带的额外字段 */
+    data?: Record<string, string | Blob>;
     uploader?: (file: File, onProgress: (p: number) => void) => Promise<{
         url?: string;
     }>;
@@ -111,6 +123,7 @@ declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {
             stream: () => ReadableStream<Uint8Array<ArrayBuffer>>;
             text: () => Promise<string>;
         } | undefined;
+        abort?: (() => void) | undefined;
     }[], UploadFile[] | {
         id: string;
         name: string;
@@ -143,6 +156,7 @@ declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {
             stream: () => ReadableStream<Uint8Array<ArrayBuffer>>;
             text: () => Promise<string>;
         } | undefined;
+        abort?: (() => void) | undefined;
     }[]>;
     remove: typeof remove;
     addFiles: typeof addFiles;

package/dist/components/KUpload.vue.js

@@ -2,6 +2,6 @@ import e from "../_virtual/_plugin-vue_export-helper.js";
 import t from "./KUpload.vue_vue_type_script_setup_true_lang.js";
 /* empty css                                                            */
 //#region components/KUpload.vue
-var n = /* @__PURE__ */ e(t, [["__scopeId", "data-v-cc65d4de"]]);
+var n = /* @__PURE__ */ e(t, [["__scopeId", "data-v-254dab35"]]);
 //#endregion
 export { n as default };

package/dist/components/KUpload.vue_vue_type_script_setup_true_lang.js

@@ -5,16 +5,16 @@ import { AlertCircle as y, CheckCircle2 as b, FileText as x, Loader2 as S, Uploa
 var T = { class: "k-upload__hint" }, E = {
 	key: 0,
 	class: "k-upload__meta"
-}, D = { key: 0 }, O = { key: 1 }, k = { key: 2 }, A = ["disabled"], j = ["multiple", "accept"], M = {
+}, D = { key: 0 }, O = { key: 1 }, k = { key: 2 }, ee = ["disabled"], te = ["multiple", "accept"], A = {
 	key: 2,
 	class: "k-upload__list"
-}, N = { class: "k-upload__file-info" }, P = { class: "k-upload__file-name" }, F = { class: "k-upload__file-meta" }, I = {
+}, j = { class: "k-upload__file-info" }, M = { class: "k-upload__file-name" }, N = { class: "k-upload__file-meta" }, P = {
 	key: 0,
 	class: "k-upload__error-text"
-}, L = {
+}, F = {
 	key: 0,
 	class: "k-upload__progress"
-}, R = { class: "k-upload__file-status" }, z = ["onClick"], B = /* @__PURE__ */ c({
+}, I = { class: "k-upload__file-status" }, L = ["onClick"], R = /* @__PURE__ */ c({
 	__name: "KUpload",
 	props: {
 		multiple: {
@@ -23,6 +23,11 @@ var T = { class: "k-upload__hint" }, E = {
 		},
 		accept: {},
 		maxSize: {},
+		action: {},
+		headers: {},
+		withCredentials: { type: Boolean },
+		name: {},
+		data: {},
 		uploader: {},
 		customRequest: {},
 		beforeUpload: {},
@@ -59,17 +64,17 @@ var T = { class: "k-upload__hint" }, E = {
 		"success",
 		"error"
 	],
-	setup(c, { expose: B, emit: V }) {
-		let H = c, U = V, W = p([]), G = p(!1), K = p(null);
+	setup(c, { expose: R, emit: z }) {
+		let B = c, V = z, H = p([]), U = p(!1), W = p(null);
 		f(e, {
-			open: Z,
-			isDragOver: G
+			open: Q,
+			isDragOver: U
 		});
-		function q(e) {
+		function G(e) {
 			return e < 1024 ? e + " B" : e < 1024 * 1024 ? (e / 1024).toFixed(1) + " KB" : (e / 1024 / 1024).toFixed(2) + " MB";
 		}
-		let J = 0;
-		function Y(e, t) {
+		let K = 0;
+		function q(e, t) {
 			return {
 				id: e.id,
 				name: e.name,
@@ -79,40 +84,49 @@ var T = { class: "k-upload__hint" }, E = {
 				url: e.url
 			};
 		}
-		async function X(e) {
-			if (H.disabled) return;
+		function J(e) {
+			let t = B.accept?.trim();
+			if (!t) return !0;
+			let n = e.name.toLowerCase(), r = e.type.toLowerCase();
+			return t.split(",").map((e) => e.trim().toLowerCase()).filter(Boolean).some((e) => e.startsWith(".") ? n.endsWith(e) : e.endsWith("/*") ? r.startsWith(e.slice(0, -1)) : r === e);
+		}
+		function Y(e) {
+			return {
+				id: "",
+				name: e.name,
+				status: "pending",
+				percentage: 0,
+				file: e
+			};
+		}
+		function X(e, t) {
+			H.value.push({
+				id: String(++K),
+				name: e.name,
+				size: e.size,
+				status: "error",
+				progress: 0,
+				error: t
+			});
+		}
+		async function Z(e) {
+			if (B.disabled) return;
 			let t = Array.from(e);
-			!H.multiple && t.length > 1 && (t = t.slice(0, 1));
-			let n = [];
-			for (let e of t) {
-				let t = {
-					id: String(++J),
-					name: e.name,
-					size: e.size,
-					status: "pending",
-					progress: 0,
-					raw: e,
-					file: e
-				}, r = !0;
-				H.beforeUpload && (r = await H.beforeUpload({ file: Y(t, e) })), r !== !1 && H.onBeforeUpload && (r = await H.onBeforeUpload({ file: Y(t, e) })), r !== !1 && n.push(e);
-			}
-			if (t = n, t.length === 0) return;
-			U("select", t);
-			let r = [];
+			!B.multiple && t.length > 1 && (t = t.slice(0, 1));
+			let n = [], r = [];
 			for (let e of t) {
-				if (H.maxSize && e.size > H.maxSize) {
-					W.value.push({
-						id: String(++J),
-						name: e.name,
-						size: e.size,
-						status: "error",
-						progress: 0,
-						error: `超过最大 ${q(H.maxSize)}`
-					});
+				let t = !0;
+				if (B.beforeUpload && (t = await B.beforeUpload({ file: Y(e) })), t !== !1 && B.onBeforeUpload && (t = await B.onBeforeUpload({ file: Y(e) })), t === !1) continue;
+				if (!J(e)) {
+					X(e, "文件类型不允许");
+					continue;
+				}
+				if (B.maxSize && e.size > B.maxSize) {
+					X(e, `超过最大 ${G(B.maxSize)}`);
 					continue;
 				}
-				let t = {
-					id: String(++J),
+				let i = {
+					id: String(++K),
 					name: e.name,
 					size: e.size,
 					status: "pending",
@@ -120,84 +134,112 @@ var T = { class: "k-upload__hint" }, E = {
 					raw: e,
 					file: e
 				};
-				W.value.push(t), r.push({
-					uf: t,
+				H.value.push(i), n.push(e), r.push({
+					uf: i,
 					raw: e
 				});
 			}
-			if (U("change", W.value), !(!H.autoUpload || !H.defaultUpload)) {
-				if (H.customRequest) {
-					await Promise.all(r.map(async ({ uf: e, raw: t }) => {
-						e.status = "uploading", await new Promise((n) => {
-							H.customRequest?.({
-								file: Y(e, t),
-								onProgress: ({ percent: t }) => {
-									e.progress = Math.max(0, Math.min(100, t));
-								},
-								onFinish: () => {
-									if (!W.value.includes(e)) return n();
-									e.status = "success", e.progress = 100, U("success", e), U("change", W.value), n();
-								},
-								onError: (t) => {
-									if (!W.value.includes(e)) return n();
-									e.status = "error", e.error = t?.message || "上传失败", U("error", e, t), U("change", W.value), n();
-								}
-							});
-						});
-					}));
-					return;
-				}
-				if (H.uploader) {
-					let e = H.uploader;
-					await Promise.all(r.map(async ({ uf: t, raw: n }) => {
-						t.status = "uploading";
-						try {
-							let r = await e(n, (e) => t.progress = e);
-							if (!W.value.includes(t)) return;
-							t.status = "success", t.progress = 100, t.url = r?.url, U("success", t);
-						} catch (e) {
-							if (!W.value.includes(t)) return;
-							t.status = "error", t.error = e?.message || "上传失败", U("error", t, e);
+			V("change", H.value), n.length !== 0 && (V("select", n), !(!B.autoUpload || !B.defaultUpload) && await ne(r));
+		}
+		async function ne(e) {
+			if (B.customRequest) {
+				await Promise.all(e.map(({ uf: e, raw: t }) => (e.status = "uploading", new Promise((n) => {
+					B.customRequest?.({
+						file: q(e, t),
+						onProgress: ({ percent: t }) => {
+							e.progress = Math.max(0, Math.min(100, t));
+						},
+						onFinish: () => {
+							H.value.includes(e) && (e.status = "success", e.progress = 100, V("success", e), V("change", H.value)), n();
+						},
+						onError: (t) => {
+							H.value.includes(e) && (e.status = "error", e.error = t?.message || "上传失败", V("error", e, t), V("change", H.value)), n();
 						}
-					}));
-				} else r.forEach(({ uf: e }) => {
-					e.status = "success", e.progress = 100;
-				});
-				U("change", W.value);
+					});
+				}))));
+				return;
+			}
+			if (B.uploader) {
+				let t = B.uploader;
+				await Promise.all(e.map(async ({ uf: e, raw: n }) => {
+					e.status = "uploading";
+					try {
+						let r = await t(n, (t) => {
+							e.progress = Math.max(0, Math.min(100, t));
+						});
+						if (!H.value.includes(e)) return;
+						e.status = "success", e.progress = 100, e.url = r?.url, V("success", e);
+					} catch (t) {
+						if (!H.value.includes(e)) return;
+						e.status = "error", e.error = t?.message || "上传失败", V("error", e, t);
+					}
+				})), V("change", H.value);
+				return;
 			}
+			if (B.action) {
+				await Promise.all(e.map(({ uf: e, raw: t }) => re(e, t)));
+				return;
+			}
+		}
+		function re(e, t) {
+			return new Promise((n) => {
+				e.status = "uploading";
+				let r = new XMLHttpRequest();
+				e.abort = () => r.abort();
+				let i = new FormData();
+				if (i.append(B.name ?? "file", t, t.name), B.data) for (let [e, t] of Object.entries(B.data)) i.append(e, t);
+				if (r.open("POST", B.action), B.withCredentials && (r.withCredentials = !0), B.headers) for (let [e, t] of Object.entries(B.headers)) r.setRequestHeader(e, t);
+				r.upload.onprogress = (t) => {
+					t.lengthComputable && H.value.includes(e) && (e.progress = Math.round(t.loaded / t.total * 100));
+				}, r.onload = () => {
+					if (!H.value.includes(e)) return n();
+					if (r.status >= 200 && r.status < 300) {
+						e.status = "success", e.progress = 100;
+						try {
+							e.url = JSON.parse(r.responseText)?.url;
+						} catch {}
+						V("success", e);
+					} else e.status = "error", e.error = `上传失败 (${r.status})`, V("error", e, Error(e.error));
+					V("change", H.value), n();
+				}, r.onerror = () => {
+					if (!H.value.includes(e)) return n();
+					e.status = "error", e.error = "网络错误", V("error", e, /* @__PURE__ */ Error("network error")), V("change", H.value), n();
+				}, r.onabort = () => n(), r.send(i);
+			});
 		}
-		function Z() {
-			H.disabled || K.value?.click();
+		function Q() {
+			B.disabled || W.value?.click();
 		}
-		function Q(e) {
+		function ie(e) {
 			let t = e.target;
-			t.files && X(t.files), t.value = "";
+			t.files && Z(t.files), t.value = "";
 		}
-		function ee(e) {
-			G.value = !1, !H.disabled && e.dataTransfer?.files && X(e.dataTransfer.files);
+		function ae(e) {
+			U.value = !1, !B.disabled && e.dataTransfer?.files && Z(e.dataTransfer.files);
 		}
 		function $(e) {
-			W.value = W.value.filter((t) => t.id !== e), U("change", W.value);
+			let t = H.value.find((t) => t.id === e);
+			t?.status === "uploading" && t.abort?.(), H.value = H.value.filter((t) => t.id !== e), V("change", H.value);
 		}
-		return B({
-			files: W,
+		return R({
+			files: H,
 			remove: $,
-			addFiles: X,
-			open: Z
+			addFiles: Z,
+			open: Q
 		}), (e, f) => (d(), i("div", { class: l(["k-upload", { "k-upload--disabled": c.disabled }]) }, [
 			c.drag ? (d(), i("div", {
 				key: 0,
-				class: l(["k-upload__zone", { "k-upload__zone--over": G.value }]),
-				onClick: Z,
-				onDragover: f[0] ||= v((e) => G.value = !0, ["prevent"]),
-				onDragleave: f[1] ||= v((e) => G.value = !1, ["prevent"]),
-				onDrop: v(ee, ["prevent"])
+				class: l(["k-upload__zone", { "k-upload__zone--over": U.value }]),
+				onClick: Q,
+				onDragover: f[0] ||= v((e) => U.value = !0, ["prevent"]),
+				onDragleave: f[1] ||= v((e) => U.value = !1, ["prevent"]),
+				onDrop: v(ae, ["prevent"])
 			}, [h(e.$slots, "trigger", {
-				isDragOver: G.value,
-				open: Z
+				isDragOver: U.value,
+				open: Q
 			}, () => [h(e.$slots, "default", {
-				isDragOver: G.value,
-				open: Z
+				isDragOver: U.value,
+				open: Q
 			}, () => [s(_(C), {
 				size: 28,
 				class: "k-upload__icon"
@@ -209,31 +251,31 @@ var T = { class: "k-upload__hint" }, E = {
 				c.accept || c.maxSize ? (d(), i("div", E, [
 					c.accept ? (d(), i("span", D, "支持: " + g(c.accept), 1)) : r("", !0),
 					c.accept && c.maxSize ? (d(), i("span", O, " · ")) : r("", !0),
-					c.maxSize ? (d(), i("span", k, "最大: " + g(q(c.maxSize)), 1)) : r("", !0)
+					c.maxSize ? (d(), i("span", k, "最大: " + g(G(c.maxSize)), 1)) : r("", !0)
 				])) : r("", !0)
 			])], !0)], !0)], 34)) : (d(), i("button", {
 				key: 1,
 				type: "button",
 				class: "k-upload__btn",
 				disabled: c.disabled,
-				onClick: Z
+				onClick: Q
 			}, [h(e.$slots, "trigger", {
 				isDragOver: !1,
-				open: Z
+				open: Q
 			}, () => [h(e.$slots, "default", {
 				isDragOver: !1,
-				open: Z
-			}, () => [s(_(C), { size: 14 }), o(" " + g(c.buttonText), 1)], !0)], !0)], 8, A)),
+				open: Q
+			}, () => [s(_(C), { size: 14 }), o(" " + g(c.buttonText), 1)], !0)], !0)], 8, ee)),
 			a("input", {
 				ref_key: "fileInputRef",
-				ref: K,
+				ref: W,
 				type: "file",
 				multiple: c.multiple,
 				accept: c.accept,
 				class: "k-upload__input",
-				onChange: Q
-			}, null, 40, j),
-			c.showList && c.showFileList && W.value.length > 0 ? (d(), i("ul", M, [(d(!0), i(t, null, m(W.value, (e) => (d(), i("li", {
+				onChange: ie
+			}, null, 40, te),
+			c.showList && c.showFileList && H.value.length > 0 ? (d(), i("ul", A, [(d(!0), i(t, null, m(H.value, (e) => (d(), i("li", {
 				key: e.id,
 				class: l(["k-upload__item", `k-upload__item--${e.status}`])
 			}, [
@@ -241,15 +283,15 @@ var T = { class: "k-upload__hint" }, E = {
 					size: 14,
 					class: "k-upload__file-icon"
 				}),
-				a("div", N, [
-					a("div", P, g(e.name), 1),
-					a("div", F, [o(g(q(e.size)) + " ", 1), e.error ? (d(), i("span", I, "· " + g(e.error), 1)) : r("", !0)]),
-					e.status === "uploading" ? (d(), i("div", L, [a("div", {
+				a("div", j, [
+					a("div", M, g(e.name), 1),
+					a("div", N, [o(g(G(e.size)) + " ", 1), e.error ? (d(), i("span", P, "· " + g(e.error), 1)) : r("", !0)]),
+					e.status === "uploading" ? (d(), i("div", F, [a("div", {
 						class: "k-upload__progress-bar",
 						style: u({ width: e.progress + "%" })
 					}, null, 4)])) : r("", !0)
 				]),
-				a("div", R, [e.status === "uploading" ? (d(), n(_(S), {
+				a("div", I, [e.status === "uploading" ? (d(), n(_(S), {
 					key: 0,
 					size: 14,
 					class: "k-upload__spin"
@@ -267,10 +309,10 @@ var T = { class: "k-upload__hint" }, E = {
 					class: "k-upload__remove",
 					"aria-label": "移除",
 					onClick: (t) => $(e.id)
-				}, [s(_(w), { size: 12 })], 8, z)
+				}, [s(_(w), { size: 12 })], 8, L)
 			], 2))), 128))])) : r("", !0)
 		], 2));
 	}
 });
 //#endregion
-export { B as default };
+export { R as default };

package/dist/components/checkbox-context.d.ts

@@ -0,0 +1,10 @@
+import type { InjectionKey, Ref } from 'vue';
+export type CheckboxSize = 'small' | 'sm' | 'medium' | 'md' | 'large' | 'lg';
+/** KCheckboxGroup 下发给 KCheckbox 的上下文：组级尺寸（子项未显式设置 size 时回退到此） */
+export interface CheckboxGroupContext {
+    size: Ref<CheckboxSize | undefined>;
+    /** 子项登记原始 value (reka 内部会字符串化, 这里记下 String(value)→原始值, emit 时还原类型) */
+    register: (raw: string | number) => void;
+    unregister: (raw: string | number) => void;
+}
+export declare const CHECKBOX_GROUP_KEY: InjectionKey<CheckboxGroupContext>;

package/dist/components/checkbox-context.js

@@ -0,0 +1,4 @@
+//#region components/checkbox-context.ts
+var e = Symbol("k-checkbox-group");
+//#endregion
+export { e as CHECKBOX_GROUP_KEY };

package/dist/components/form-context.d.ts

@@ -1,20 +1,29 @@
 import type { InjectionKey } from 'vue';
 export interface FormRule {
     required?: boolean;
-    type?: 'string' | 'number' | 'array' | string;
+    /** 'string'(默认) | 'number' | 'integer' | 'array' | 'email' | 'url' | 'boolean' */
+    type?: 'string' | 'number' | 'integer' | 'array' | 'email' | 'url' | 'boolean' | string;
+    /** type=number/integer 时为数值下限; string/array 时为长度下限 */
     min?: number;
+    /** type=number/integer 时为数值上限; string/array 时为长度上限 */
     max?: number;
     len?: number;
     pattern?: RegExp;
     validator?: ((rule: FormRule, value: any) => boolean | string | Error | void | Promise<boolean | string | Error | void>) | ((value: any) => boolean | string | Error | void | Promise<boolean | string | Error | void>);
     message?: string;
+    /** 触发校验的时机: 'blur' | 'change'(或数组); 不填则两者皆触发 */
     trigger?: string | string[];
 }
 export type FormRules = Record<string, FormRule | FormRule[]>;
 export interface FormFieldRef {
-    validate: () => Promise<boolean>;
+    name: string;
+    /** trigger 省略 = 全量校验(所有规则); 传 'blur'/'change' = 只跑匹配该时机的规则 */
+    validate: (trigger?: string) => Promise<boolean>;
+    /** 还原到初始值并清除校验态 */
     reset: () => void;
     clearValidate: () => void;
+    hasError: () => boolean;
+    scrollIntoView: () => void;
 }
 export interface FormContext {
     model: Record<string, any>;
@@ -23,7 +32,15 @@ export interface FormContext {
     labelPosition: 'top' | 'left';
     size: 'sm' | 'md' | 'lg';
     disabled: boolean;
+    /** rules 变化时自动重新校验已校验过的字段 */
+    validateOnRuleChange: boolean;
     registerField: (name: string, field: FormFieldRef) => void;
     unregisterField: (name: string) => void;
 }
 export declare const formContextKey: InjectionKey<FormContext>;
+/** 解析嵌套字段路径 a.b.c / a.b[0].c → 取值 (扁平 model[name] 解析不了带点的 key) */
+export declare function getByPath(obj: Record<string, any>, path: string): any;
+/** 解析嵌套路径写值 (resetFields 还原初始值用) */
+export declare function setByPath(obj: Record<string, any>, path: string, value: any): void;
+/** 深拷贝初始值快照 (普通表单数据) */
+export declare function cloneValue<T>(v: T): T;

package/dist/components/form-context.js

@@ -1,4 +1,34 @@
 //#region components/form-context.ts
 var e = Symbol("formContext");
+function t(e, t) {
+	if (!t) return;
+	let n = t.replace(/\[(\w+)\]/g, ".$1").split(".").filter(Boolean), r = e;
+	for (let e of n) {
+		if (r == null) return;
+		r = r[e];
+	}
+	return r;
+}
+function n(e, t, n) {
+	if (!t) return;
+	let r = t.replace(/\[(\w+)\]/g, ".$1").split(".").filter(Boolean), i = e;
+	for (let e = 0; e < r.length - 1; e++) {
+		let t = r[e];
+		(i[t] == null || typeof i[t] != "object") && (i[t] = {}), i = i[t];
+	}
+	i[r[r.length - 1]] = n;
+}
+function r(e) {
+	if (typeof e != "object" || !e) return e;
+	try {
+		return structuredClone(e);
+	} catch {
+		try {
+			return JSON.parse(JSON.stringify(e));
+		} catch {
+			return e;
+		}
+	}
+}
 //#endregion
-export { e as formContextKey };
+export { r as cloneValue, e as formContextKey, t as getByPath, n as setByPath };

package/dist/components/menu-context.d.ts

@@ -20,6 +20,10 @@ export interface MenuContext {
     isExpanded: (key: string) => boolean;
     toggle: (key: string) => void;
     select: (option: MenuOption) => void;
+    /** roving tabindex: 当前可聚焦项 */
+    isFocused: (key: string) => boolean;
+    /** 子项获得焦点时回写 roving 游标 */
+    setFocus: (key: string) => void;
     indent: number;
     rootIndent: number;
 }

package/dist/components/radio-context.d.ts

@@ -1,6 +1,11 @@
 import type { InjectionKey, Ref } from 'vue';
-/** KRadioGroup 下发给 KRadio 的上下文，目前仅传递“分段按钮态”视觉标记 */
+export type RadioSize = 'small' | 'sm' | 'medium' | 'md' | 'large' | 'lg';
+/** KRadioGroup 下发给 KRadio 的上下文：分段按钮态 + 组级尺寸（子项未显式设置 size 时回退到此） */
 export interface RadioGroupContext {
     button: Ref<boolean>;
+    size: Ref<RadioSize | undefined>;
+    /** 子项登记原始 value (reka 内部会字符串化, 这里记下 String(value)→原始值, emit 时还原类型) */
+    register: (raw: string | number) => void;
+    unregister: (raw: string | number) => void;
 }
 export declare const RADIO_GROUP_KEY: InjectionKey<RadioGroupContext>;