@guoyg578/k-ui 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 guoyg
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,59 @@
+# k-ui
+
+一套可复用的 Vue 3 组件库（K 前缀），基于 reka-ui（headless）+ Tailwind v4 token。**两种接入：① `pnpm add @guoyg578/k-ui`（推荐）；② 整个 `k-ui/` 目录源码拷贝**。两种方式的完整步骤、样式引入（含 Tailwind `@source` 关键步骤）、发布流程见 [INSTALL.md](./INSTALL.md)。
+
+> 📦 **接入到新项目** —— 完整步骤、最小集成示例、排错速查见 [INSTALL.md](./INSTALL.md)。
+
+## 组件清单（45+）
+
+- **通用 / 输入**：`KButton` · `KInput` · `KTextarea` · `KInputNumber` · `KSearchBar` · `KTag`
+- **选择**：`KSelect` · `KCombobox`（可搜索+多选）· `KDatePicker`
+- **表单**：`KSwitch` · `KCheckbox`(+`KCheckboxGroup`) · `KRadio`(+`KRadioGroup`) · `KForm` · `KFormField`
+- **反馈 / 弹层**：`KConfirmDialog` · `KDialog` · `KDrawer` · `KTooltip` · `KAlert` · `KMessage`（函数式 toast）
+- **数据展示**：`KDataTable` · `KPagination` · `KEmpty` · `KLoadingOverlay` · `KRefetchOverlay` · `KProgress` · `KAvatar`(+`KAvatarGroup`)
+- **骨架屏**：`KSkeleton` · `KListSkeleton` · `KGridSkeleton`
+- **导航**：`KTabs` · `KBreadcrumb`
+- **容器**：`KCard` · `KResult` · `KSteps`
+- **媒体**：`KImage` · `KImageViewer` · `KUpload`
+- **高级**：`KCommandPalette`（Cmd+K）· `KVirtualList` · `KResizablePanel` · `KTreeView` · `KDiff`（LCS 文本对比）
+- **主题**：`KThemeToggleButton`（**无状态**，`v-model:mode`，状态由宿主管理）
+- **指令**：`v-reveal`（滚动入场）/ `v-spotlight`（鼠标跟随光晕），需 `installDirectives(app)`
+
+辅助导出：`useConfirm()`、`KMessage`、`installDirectives`、类型 `ConfirmOptions` / `ThemeMode` / `FormRule` / `FormFieldRef` / `TreeNode` / `CmdItem` / `UploadFile` / `MessageOptions`。
+
+> 本库由两套同源组件合并而来：重叠组件（KTooltip / KPagination / KEmpty / KGridSkeleton / KListSkeleton / KRefetchOverlay）以 k-ui 原实现为基准。
+
+## 依赖（peer dependencies）
+
+| 依赖 | 用途 |
+|---|---|
+| `vue` ^3.5 | 运行时 |
+| `reka-ui` ^2 | 大量 headless 组件（Dialog / Select / Tooltip / Tabs …） |
+| `lucide-vue-next` ^1 | 图标 |
+| **Tailwind v4** | 工具类 + 设计令牌（`tokens.css` / `components.css`） |
+| `vue-router` ^4+ | **可选** —— 仅 `KBreadcrumb` 用到 |
+| `@vuepic/vue-datepicker` + `date-fns` | **可选** —— 仅 `KDatePicker` 用到（v13 依赖 date-fns 的 zhCN locale） |
+
+## 快速上手
+
+```vue
+<script setup lang="ts">
+import { KButton, KDialog, KMessage } from './k-ui'
+import { ref } from 'vue'
+const open = ref(false)
+</script>
+
+<template>
+  <KButton type="primary" @click="open = true">打开</KButton>
+  <KDialog v-model:open="open" title="示例" footer @confirm="KMessage.success('done')">
+    Hello from k-ui.
+  </KDialog>
+</template>
+```
+
+> ⚠️ 组件依赖 `k-ui/styles/tokens.css` + `components.css`，**必须在全局 CSS 引入**，否则样式错乱。详见 [INSTALL.md](./INSTALL.md)。
+
+## 备注
+
+- 文案中文硬编码（「搜索」「确定」「暂无数据」等），需 i18n 自行替换。
+- 源码拷贝交付，无版本号管理；更新时重新拷贝覆盖。

package/dist/_virtual/_plugin-vue_export-helper.js

@@ -0,0 +1,8 @@
+//#region \0plugin-vue:export-helper
+var e = (e, t) => {
+	let n = e.__vccOpts || e;
+	for (let [e, r] of t) n[e] = r;
+	return n;
+};
+//#endregion
+export { e as default };

package/dist/components/KAlert.js

@@ -0,0 +1,7 @@
+import e from "../_virtual/_plugin-vue_export-helper.js";
+import t from "./KAlert.vue_vue_type_script_setup_true_lang.js";
+/* empty css                                                       */
+//#region components/KAlert.vue
+var n = /* @__PURE__ */ e(t, [["__scopeId", "data-v-5a970db1"]]);
+//#endregion
+export { n as default };

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

@@ -0,0 +1,40 @@
+type AlertType = 'info' | 'success' | 'warning' | 'error';
+type __VLS_Props = {
+    type?: AlertType;
+    variant?: 'tint' | 'outline';
+    title?: string;
+    description?: string;
+    closable?: boolean;
+    icon?: boolean;
+    /** 受控可见性. 不传时走内部 ref(true), 点 X 即隐藏 (uncontrolled 模式).
+     *  传了就受父组件 v-model 控制 — 父组件需自行处理 update:modelValue */
+    modelValue?: boolean;
+};
+declare var __VLS_6: {}, __VLS_8: {}, __VLS_10: {};
+type __VLS_Slots = {} & {
+    title?: (props: typeof __VLS_6) => any;
+} & {
+    default?: (props: typeof __VLS_8) => any;
+} & {
+    actions?: (props: typeof __VLS_10) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {} & {
+    "update:modelValue": (v: boolean) => any;
+    close: () => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    "onUpdate:modelValue"?: ((v: boolean) => any) | undefined;
+    onClose?: (() => any) | undefined;
+}>, {
+    type: AlertType;
+    closable: boolean;
+    variant: "tint" | "outline";
+    icon: 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;
+    };
+};

package/dist/components/KAlert.vue_vue_type_script_setup_true_lang.js

@@ -0,0 +1,76 @@
+import { computed as e, createBlock as t, createCommentVNode as n, createElementBlock as r, createElementVNode as i, createTextVNode as a, createVNode as o, defineComponent as s, normalizeClass as c, openBlock as l, ref as u, renderSlot as d, resolveDynamicComponent as f, toDisplayString as p, unref as m, watch as h } from "vue";
+import { AlertCircle as g, AlertTriangle as _, CheckCircle2 as v, Info as y, X as b } from "lucide-vue-next";
+//#region components/KAlert.vue?vue&type=script&setup=true&lang.ts
+var x = { class: "k-alert__body" }, S = {
+	key: 0,
+	class: "k-alert__title"
+}, C = {
+	key: 1,
+	class: "k-alert__desc"
+}, w = {
+	key: 2,
+	class: "k-alert__actions"
+}, T = /* @__PURE__ */ s({
+	__name: "KAlert",
+	props: {
+		type: { default: "info" },
+		variant: { default: "tint" },
+		title: {},
+		description: {},
+		closable: {
+			type: Boolean,
+			default: !1
+		},
+		icon: {
+			type: Boolean,
+			default: !0
+		},
+		modelValue: { type: Boolean }
+	},
+	emits: ["update:modelValue", "close"],
+	setup(s, { emit: T }) {
+		let E = s, D = T, O = u(!0);
+		h(() => [
+			E.type,
+			E.title,
+			E.description
+		], () => {
+			E.modelValue === void 0 && (O.value = !0);
+		});
+		let k = e(() => E.modelValue === void 0 ? O.value : E.modelValue);
+		function A() {
+			E.modelValue === void 0 ? O.value = !1 : D("update:modelValue", !1), D("close");
+		}
+		let j = {
+			info: y,
+			success: v,
+			warning: _,
+			error: g
+		};
+		return (e, u) => k.value ? (l(), r("div", {
+			key: 0,
+			class: c(["k-alert", [`k-alert--${s.type}`, `k-alert--${s.variant}`]]),
+			role: "alert"
+		}, [
+			s.icon ? (l(), t(f(j[s.type]), {
+				key: 0,
+				size: 16,
+				class: "k-alert__icon"
+			})) : n("", !0),
+			i("div", x, [
+				s.title || e.$slots.title ? (l(), r("div", S, [d(e.$slots, "title", {}, () => [a(p(s.title), 1)], !0)])) : n("", !0),
+				s.description || e.$slots.default ? (l(), r("div", C, [d(e.$slots, "default", {}, () => [a(p(s.description), 1)], !0)])) : n("", !0),
+				e.$slots.actions ? (l(), r("div", w, [d(e.$slots, "actions", {}, void 0, !0)])) : n("", !0)
+			]),
+			s.closable ? (l(), r("button", {
+				key: 1,
+				type: "button",
+				class: "k-alert__close",
+				"aria-label": "关闭",
+				onClick: A
+			}, [o(m(b), { size: 14 })])) : n("", !0)
+		], 2)) : n("", !0);
+	}
+});
+//#endregion
+export { T as default };

package/dist/components/KAvatar.js

@@ -0,0 +1,7 @@
+import e from "../_virtual/_plugin-vue_export-helper.js";
+import t from "./KAvatar.vue_vue_type_script_setup_true_lang.js";
+/* empty css                                                        */
+//#region components/KAvatar.vue
+var n = /* @__PURE__ */ e(t, [["__scopeId", "data-v-14ccf4af"]]);
+//#endregion
+export { n as default };

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

@@ -0,0 +1,15 @@
+type __VLS_Props = {
+    src?: string;
+    alt?: string;
+    name?: string;
+    size?: 'sm' | 'md' | 'lg' | 'xl';
+    shape?: 'circle' | 'square';
+    /** 自定义背景, 否则按 name hash 自动生成 */
+    bg?: string;
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+    size: "sm" | "md" | "lg" | "xl";
+    shape: "circle" | "square";
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/components/KAvatar.vue_vue_type_script_setup_true_lang.js

@@ -0,0 +1,53 @@
+import { computed as e, createBlock as t, createCommentVNode as n, createTextVNode as r, createVNode as i, defineComponent as a, normalizeClass as o, normalizeStyle as s, openBlock as c, toDisplayString as l, unref as u, withCtx as d } from "vue";
+import { AvatarFallback as f, AvatarImage as p, AvatarRoot as m } from "reka-ui";
+//#region components/KAvatar.vue?vue&type=script&setup=true&lang.ts
+var h = /* @__PURE__ */ a({
+	__name: "KAvatar",
+	props: {
+		src: {},
+		alt: {},
+		name: {},
+		size: { default: "md" },
+		shape: { default: "circle" },
+		bg: {}
+	},
+	setup(a) {
+		let h = a, g = e(() => {
+			if (!h.name) return "?";
+			let e = h.name.trim().split(/\s+/);
+			return e.length >= 2 ? (e[0][0] + e[1][0]).toUpperCase() : h.name.slice(0, 2).toUpperCase();
+		}), _ = [
+			"#6366f1",
+			"#0ea5e9",
+			"#10b981",
+			"#f59e0b",
+			"#ef4444",
+			"#ec4899",
+			"#8b5cf6",
+			"#14b8a6"
+		], v = e(() => {
+			if (h.bg) return h.bg;
+			if (!h.name) return "var(--color-ink-300)";
+			let e = 0;
+			for (let t = 0; t < h.name.length; t++) e = e * 31 + h.name.charCodeAt(t) >>> 0;
+			return _[e % _.length];
+		});
+		return (e, h) => (c(), t(u(m), {
+			class: o(["k-avatar", [`k-avatar--${a.size}`, `k-avatar--${a.shape}`]]),
+			style: s({ backgroundColor: v.value })
+		}, {
+			default: d(() => [a.src ? (c(), t(u(p), {
+				key: 0,
+				src: a.src,
+				alt: a.alt || a.name || "",
+				class: "k-avatar__img"
+			}, null, 8, ["src", "alt"])) : n("", !0), i(u(f), { class: "k-avatar__fallback" }, {
+				default: d(() => [r(l(g.value), 1)]),
+				_: 1
+			})]),
+			_: 1
+		}, 8, ["class", "style"]));
+	}
+});
+//#endregion
+export { h as default };

package/dist/components/KAvatarGroup.js

@@ -0,0 +1,7 @@
+import e from "../_virtual/_plugin-vue_export-helper.js";
+import t from "./KAvatarGroup.vue_vue_type_script_setup_true_lang.js";
+/* empty css                                                             */
+//#region components/KAvatarGroup.vue
+var n = /* @__PURE__ */ e(t, [["__scopeId", "data-v-00da4b72"]]);
+//#endregion
+export { n as default };

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

@@ -0,0 +1,18 @@
+type __VLS_Props = {
+    size?: 'sm' | 'md' | 'lg' | 'xl';
+};
+declare var __VLS_1: {};
+type __VLS_Slots = {} & {
+    default?: (props: typeof __VLS_1) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+    size: "sm" | "md" | "lg" | "xl";
+}, {}, {}, {}, 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;
+    };
+};

package/dist/components/KAvatarGroup.vue_vue_type_script_setup_true_lang.js

@@ -0,0 +1,11 @@
+import { createElementBlock as e, defineComponent as t, normalizeClass as n, openBlock as r, renderSlot as i } from "vue";
+//#region components/KAvatarGroup.vue?vue&type=script&setup=true&lang.ts
+var a = /* @__PURE__ */ t({
+	__name: "KAvatarGroup",
+	props: { size: { default: "md" } },
+	setup(t) {
+		return (a, o) => (r(), e("div", { class: n(["k-avatar-group", `k-avatar-group--${t.size}`]) }, [i(a.$slots, "default", {}, void 0, !0)], 2));
+	}
+});
+//#endregion
+export { a as default };

package/dist/components/KBreadcrumb.js

@@ -0,0 +1,7 @@
+import e from "../_virtual/_plugin-vue_export-helper.js";
+import t from "./KBreadcrumb.vue_vue_type_script_setup_true_lang.js";
+/* empty css                                                            */
+//#region components/KBreadcrumb.vue
+var n = /* @__PURE__ */ e(t, [["__scopeId", "data-v-84a26ab7"]]);
+//#endregion
+export { n as default };

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

@@ -0,0 +1,12 @@
+import type { Component } from 'vue';
+interface BreadcrumbItem {
+    label: string;
+    to?: string;
+    icon?: Component;
+}
+type __VLS_Props = {
+    items: BreadcrumbItem[];
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/components/KBreadcrumb.vue_vue_type_script_setup_true_lang.js

@@ -0,0 +1,38 @@
+import { Fragment as e, createBlock as t, createCommentVNode as n, createElementBlock as r, createTextVNode as i, defineComponent as a, normalizeClass as o, openBlock as s, renderList as c, resolveDynamicComponent as l, toDisplayString as u, unref as d, withCtx as f } from "vue";
+import { ChevronRight as p } from "lucide-vue-next";
+import { RouterLink as m } from "vue-router";
+//#region components/KBreadcrumb.vue?vue&type=script&setup=true&lang.ts
+var h = {
+	class: "k-bread",
+	"aria-label": "面包屑"
+}, g = /* @__PURE__ */ a({
+	__name: "KBreadcrumb",
+	props: { items: {} },
+	setup(a) {
+		return (g, _) => (s(), r("nav", h, [(s(!0), r(e, null, c(a.items, (c, h) => (s(), r(e, { key: h }, [c.to && h < a.items.length - 1 ? (s(), t(d(m), {
+			key: 0,
+			to: c.to,
+			class: "k-bread__item k-bread__item--link"
+		}, {
+			default: f(() => [c.icon ? (s(), t(l(c.icon), {
+				key: 0,
+				size: 13,
+				class: "k-bread__icon"
+			})) : n("", !0), i(" " + u(c.label), 1)]),
+			_: 2
+		}, 1032, ["to"])) : (s(), r("span", {
+			key: 1,
+			class: o(["k-bread__item", { "k-bread__item--last": h === a.items.length - 1 }])
+		}, [c.icon ? (s(), t(l(c.icon), {
+			key: 0,
+			size: 13,
+			class: "k-bread__icon"
+		})) : n("", !0), i(" " + u(c.label), 1)], 2)), h < a.items.length - 1 ? (s(), t(d(p), {
+			key: 2,
+			size: 14,
+			class: "k-bread__sep"
+		})) : n("", !0)], 64))), 128))]));
+	}
+});
+//#endregion
+export { g as default };

package/dist/components/KButton.js

@@ -0,0 +1,7 @@
+import e from "./KButton.vue_vue_type_script_setup_true_lang.js";
+/* empty css                                                        */
+import t from "../_virtual/_plugin-vue_export-helper.js";
+//#region components/KButton.vue
+var n = /* @__PURE__ */ t(e, [["__scopeId", "data-v-d6c04ee4"]]);
+//#endregion
+export { n as default };

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

@@ -0,0 +1,36 @@
+type KButtonType = 'primary' | 'secondary' | 'ghost' | 'danger';
+type KButtonSize = 'sm' | 'md' | 'lg';
+type __VLS_Props = {
+    type?: KButtonType;
+    size?: KButtonSize;
+    loading?: boolean;
+    disabled?: boolean;
+    block?: boolean;
+    nativeType?: 'button' | 'submit' | 'reset';
+};
+declare var __VLS_6: {}, __VLS_8: {};
+type __VLS_Slots = {} & {
+    icon?: (props: typeof __VLS_6) => any;
+} & {
+    default?: (props: typeof __VLS_8) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {} & {
+    click: (ev: MouseEvent) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onClick?: ((ev: MouseEvent) => any) | undefined;
+}>, {
+    type: KButtonType;
+    size: KButtonSize;
+    loading: boolean;
+    disabled: boolean;
+    block: boolean;
+    nativeType: "button" | "submit" | "reset";
+}, {}, {}, {}, 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;
+    };
+};

package/dist/components/KButton.vue_vue_type_script_setup_true_lang.js

@@ -0,0 +1,50 @@
+import { computed as e, createBlock as t, createCommentVNode as n, createElementBlock as r, defineComponent as i, normalizeClass as a, openBlock as o, renderSlot as s, unref as c } from "vue";
+import { Loader2 as l } from "lucide-vue-next";
+//#region components/KButton.vue?vue&type=script&setup=true&lang.ts
+var u = ["type", "disabled"], d = /* @__PURE__ */ i({
+	__name: "KButton",
+	props: {
+		type: { default: "secondary" },
+		size: { default: "md" },
+		loading: {
+			type: Boolean,
+			default: !1
+		},
+		disabled: {
+			type: Boolean,
+			default: !1
+		},
+		block: {
+			type: Boolean,
+			default: !1
+		},
+		nativeType: { default: "button" }
+	},
+	emits: ["click"],
+	setup(i) {
+		let d = i, f = e(() => d.size === "sm" ? 12 : d.size === "lg" ? 16 : 14);
+		return (e, d) => (o(), r("button", {
+			type: i.nativeType,
+			disabled: i.disabled || i.loading,
+			class: a(["k-btn", [
+				`k-btn--${i.type}`,
+				`k-btn--${i.size}`,
+				{
+					"k-btn--block": i.block,
+					"k-btn--loading": i.loading
+				}
+			]]),
+			onClick: d[0] ||= (t) => e.$emit("click", t)
+		}, [
+			i.loading ? (o(), t(c(l), {
+				key: 0,
+				size: f.value,
+				class: "k-btn__spinner"
+			}, null, 8, ["size"])) : n("", !0),
+			s(e.$slots, "icon", {}, void 0, !0),
+			s(e.$slots, "default", {}, void 0, !0)
+		], 10, u));
+	}
+});
+//#endregion
+export { d as default };

package/dist/components/KCard.js

@@ -0,0 +1,7 @@
+import e from "../_virtual/_plugin-vue_export-helper.js";
+import t from "./KCard.vue_vue_type_script_setup_true_lang.js";
+/* empty css                                                      */
+//#region components/KCard.vue
+var n = /* @__PURE__ */ e(t, [["__scopeId", "data-v-4ce7c362"]]);
+//#endregion
+export { n as default };

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

@@ -0,0 +1,33 @@
+type __VLS_Props = {
+    title?: string;
+    subtitle?: string;
+    shadow?: 'none' | 'sm' | 'md';
+    bordered?: boolean;
+    hoverable?: boolean;
+    bodyClass?: string;
+};
+declare var __VLS_1: {}, __VLS_3: {}, __VLS_5: {}, __VLS_7: {}, __VLS_9: {};
+type __VLS_Slots = {} & {
+    title?: (props: typeof __VLS_1) => any;
+} & {
+    header?: (props: typeof __VLS_3) => any;
+} & {
+    actions?: (props: typeof __VLS_5) => any;
+} & {
+    default?: (props: typeof __VLS_7) => any;
+} & {
+    footer?: (props: typeof __VLS_9) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+    bordered: boolean;
+    hoverable: boolean;
+    shadow: "none" | "sm" | "md";
+}, {}, {}, {}, 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;
+    };
+};

package/dist/components/KCard.vue_vue_type_script_setup_true_lang.js

@@ -0,0 +1,50 @@
+import { createCommentVNode as e, createElementBlock as t, createElementVNode as n, createTextVNode as r, defineComponent as i, normalizeClass as a, openBlock as o, renderSlot as s, toDisplayString as c } from "vue";
+//#region components/KCard.vue?vue&type=script&setup=true&lang.ts
+var l = {
+	key: 0,
+	class: "k-card__header"
+}, u = { class: "k-card__title-wrap" }, d = {
+	key: 0,
+	class: "k-card__title"
+}, f = {
+	key: 1,
+	class: "k-card__subtitle"
+}, p = {
+	key: 0,
+	class: "k-card__actions"
+}, m = {
+	key: 1,
+	class: "k-card__footer"
+}, h = /* @__PURE__ */ i({
+	__name: "KCard",
+	props: {
+		title: {},
+		subtitle: {},
+		shadow: { default: "sm" },
+		bordered: {
+			type: Boolean,
+			default: !0
+		},
+		hoverable: {
+			type: Boolean,
+			default: !1
+		},
+		bodyClass: {}
+	},
+	setup(i) {
+		return (h, g) => (o(), t("div", { class: a(["k-card", [`k-card--shadow-${i.shadow}`, {
+			"k-card--bordered": i.bordered,
+			"k-card--hoverable": i.hoverable
+		}]]) }, [
+			i.title || h.$slots.title || h.$slots.header || h.$slots.actions ? (o(), t("header", l, [n("div", u, [
+				i.title || h.$slots.title ? (o(), t("h3", d, [s(h.$slots, "title", {}, () => [r(c(i.title), 1)], !0)])) : e("", !0),
+				i.subtitle ? (o(), t("p", f, c(i.subtitle), 1)) : e("", !0),
+				s(h.$slots, "header", {}, void 0, !0)
+			]), h.$slots.actions ? (o(), t("div", p, [s(h.$slots, "actions", {}, void 0, !0)])) : e("", !0)])) : e("", !0),
+			n("div", { class: a(["k-card__body", i.bodyClass]) }, [s(h.$slots, "default", {}, void 0, !0)], 2),
+			h.$slots.footer ? (o(), t("footer", m, [s(h.$slots, "footer", {}, void 0, !0)])) : e("", !0)
+		], 2));
+	}
+});
+//#endregion
+export { h as default };

package/dist/components/KCarousel.js

@@ -0,0 +1,7 @@
+import e from "../_virtual/_plugin-vue_export-helper.js";
+import t from "./KCarousel.vue_vue_type_script_setup_true_lang.js";
+/* empty css                                                          */
+//#region components/KCarousel.vue
+var n = /* @__PURE__ */ e(t, [["__scopeId", "data-v-173fae98"]]);
+//#endregion
+export { n as default };

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

@@ -0,0 +1,59 @@
+/** 每一项可以是图片地址字符串，或带 alt 的对象；也可用默认插槽渲染任意内容 */
+export type CarouselItem = string | {
+    src: string;
+    alt?: string;
+};
+declare const __VLS_export: <T = CarouselItem>(__VLS_props: NonNullable<Awaited<typeof __VLS_setup>>["props"], __VLS_ctx?: __VLS_PrettifyLocal<Pick<NonNullable<Awaited<typeof __VLS_setup>>, "attrs" | "emit" | "slots">>, __VLS_exposed?: NonNullable<Awaited<typeof __VLS_setup>>["expose"], __VLS_setup?: Promise<{
+    props: import("vue").PublicProps & __VLS_PrettifyLocal<({
+        items: T[];
+        /** 自动轮播 */
+        autoplay?: boolean;
+        /** 自动轮播间隔（ms） */
+        interval?: number;
+        /** 首尾循环 */
+        loop?: boolean;
+        /** 左右箭头 */
+        arrows?: boolean;
+        /** 底部指示器 */
+        indicators?: boolean;
+        /** 指示器样式：圆点 / 线条 */
+        indicatorType?: "dot" | "line";
+        /** 切换动画：滑动 / 淡入淡出 */
+        transition?: "slide" | "fade";
+        /** 宽高比（height 未设置时生效），如 "16 / 9" */
+        aspectRatio?: string;
+        /** 显式高度，优先于 aspectRatio */
+        height?: string;
+        /** 悬停时暂停自动轮播 */
+        pauseOnHover?: boolean;
+    } & {
+        modelValue?: number;
+    }) & {
+        "onUpdate:modelValue"?: ((value: number) => any) | undefined;
+    }> & (typeof globalThis extends {
+        __VLS_PROPS_FALLBACK: infer P;
+    } ? P : {});
+    expose: (exposed: import("vue").ShallowUnwrapRef<{
+        next: () => void;
+        prev: () => void;
+        go: (target: number, dir?: "next" | "prev") => void;
+    }>) => void;
+    attrs: any;
+    slots: {
+        default?: (props: {
+            item: T;
+            index: number;
+            active: boolean;
+        }) => any;
+    };
+    emit: (event: "update:modelValue", value: number) => void;
+}>) => import("vue").VNode & {
+    __ctx?: Awaited<typeof __VLS_setup>;
+};
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_PrettifyLocal<T> = (T extends any ? {
+    [K in keyof T]: T[K];
+} : {
+    [K in keyof T as K]: T[K];
+}) & {};