@qingmingmu/components 0.1.0-beta.0

package/es/shared/components.3dqa2hsp.d.mts

@@ -0,0 +1,132 @@
+import { PropType, defineComponent, computed, openBlock, createElementBlock, normalizeClass, renderSlot, createCommentVNode, Fragment, renderList, createTextVNode, toDisplayString } from 'vue';
+import { _ as _export_sfc } from './components.OJRSZE6i.mjs';
+
+/**
+ * QmList 组件类型定义（03-数据展示）
+ * 列表：数据渲染 / 分割线 / 空态 / 自定义项
+ */
+
+declare const listProps: {
+    /** 列表数据 */
+    readonly data: {
+        readonly type: PropType<any[]>;
+        readonly default: () => never[];
+    };
+    /** 是否显示边框 */
+    readonly bordered: {
+        readonly type: BooleanConstructor;
+        readonly default: false;
+    };
+    /** 是否显示分割线 */
+    readonly divider: {
+        readonly type: BooleanConstructor;
+        readonly default: true;
+    };
+    /** hover 高亮 */
+    readonly hover: {
+        readonly type: BooleanConstructor;
+        readonly default: true;
+    };
+    /** 空态文案（empty 插槽可覆盖） */
+    readonly emptyText: {
+        readonly type: StringConstructor;
+        readonly default: "暂无数据";
+    };
+};
+/** emits 声明 */
+interface ListEmits {
+    /** 列表项点击（携带当前项与索引；Enter/Space 键盘等价触发） */
+    itemClick: [item: any, index: number];
+}
+
+var _sfc_main = /* @__PURE__ */ defineComponent({
+  ...{ name: "QmList" },
+  __name: "list",
+  props: listProps,
+  emits: ["itemClick"],
+  setup(__props, { expose: __expose, emit: __emit }) {
+    __expose();
+    const props = __props;
+    const emit = __emit;
+    const modifierClass = computed(() => ({
+      "qm-list--bordered": props.bordered,
+      "qm-list--divider": props.divider,
+      "qm-list--hover": props.hover
+    }));
+    function defaultText(item) {
+      return typeof item === "string" || typeof item === "number" ? String(item) : "";
+    }
+    function handleItemClick(item, index) {
+      emit("itemClick", item, index);
+    }
+    function handleItemKeydown(event, item, index) {
+      if (event.key === "Enter" || event.key === " ") {
+        event.preventDefault();
+        handleItemClick(item, index);
+      }
+    }
+    const __returned__ = { props, emit, modifierClass, defaultText, handleItemClick, handleItemKeydown };
+    Object.defineProperty(__returned__, "__isScriptSetup", { enumerable: false, value: true });
+    return __returned__;
+  }
+});
+
+const _hoisted_1 = {
+	key: 0,
+	class: "qm-list__header"
+};
+const _hoisted_2 = ["onClick", "onKeydown"];
+const _hoisted_3 = {
+	key: 2,
+	class: "qm-list__empty"
+};
+const _hoisted_4 = {
+	key: 3,
+	class: "qm-list__footer"
+};
+function _sfc_render(_ctx, _cache, $props, $setup, $data, $options) {
+	return openBlock(), createElementBlock(
+		"div",
+		{
+			class: normalizeClass(["qm-list", $setup.modifierClass]),
+			"data-qm": "list"
+		},
+		[
+			_ctx.$slots.header ? (openBlock(), createElementBlock("div", _hoisted_1, [renderSlot(_ctx.$slots, "header")])) : createCommentVNode("v-if", true),
+			_ctx.data.length ? (openBlock(true), createElementBlock(
+				Fragment,
+				{ key: 1 },
+				renderList(_ctx.data, (item, index) => {
+					return openBlock(), createElementBlock("div", {
+						key: index,
+						class: "qm-list__item",
+						role: "button",
+						tabindex: "0",
+						onClick: ($event) => $setup.handleItemClick(item, index),
+						onKeydown: ($event) => $setup.handleItemKeydown($event, item, index)
+					}, [renderSlot(_ctx.$slots, "default", {
+						item,
+						index
+					}, () => [createTextVNode(
+						toDisplayString($setup.defaultText(item)),
+						1
+						/* TEXT */
+					)])], 40, _hoisted_2);
+				}),
+				128
+				/* KEYED_FRAGMENT */
+			)) : (openBlock(), createElementBlock("div", _hoisted_3, [renderSlot(_ctx.$slots, "empty", {}, () => [createTextVNode(
+				toDisplayString(_ctx.emptyText),
+				1
+				/* TEXT */
+			)])])),
+			_ctx.$slots.footer ? (openBlock(), createElementBlock("div", _hoisted_4, [renderSlot(_ctx.$slots, "footer")])) : createCommentVNode("v-if", true)
+		],
+		2
+		/* CLASS */
+	);
+}
+var List = /*#__PURE__*/ _export_sfc(_sfc_main, [["render", _sfc_render], ["__file", "F:\\软件开发\\青冥组件系统\\packages\\components\\src\\components\\list\\list.vue"]]);
+
+export { List as a, listProps as l };
+export type { ListEmits as L };

package/es/shared/components.4UjasbrA.d.cts

@@ -0,0 +1,51 @@
+import { Ref } from 'vue';
+
+/**
+ * usePositioning —— 共享 fixed 定位 + 视口翻转组合式函数
+ *
+ * 职责（从 Select 内联逻辑抽取，供 Tooltip / Popover / Dropdown / DatePicker 复用）：
+ * - 纯函数 computePosition：top/bottom/left/right 四向（含 top/bottom 的 -start/-end 水平对齐变体）
+ *   + 视口空间不足自动翻转（start/end 变体翻转后保持对齐方式）；
+ * - composable：Teleport 挂载时序 rAF 重试、window scroll/resize 重定位、dispose 无泄漏；
+ * - 初始样式含 position:fixed（面板挂载即脱离文档流收缩尺寸，避免静态块级元素被量成全宽）；
+ * - 零第三方运行时依赖（性能规范 §11.2）；模块顶层不访问 window/document，SSR 安全。
+ *
+ * 行为契约（与原 Select 内联实现等价）：
+ * - offset 默认 4（GAP）；
+ * - 面板/触发器未挂载时 rAF 重试，上限 10 次；
+ * - scroll 监听使用捕获阶段（捕获内层滚动事件）。
+ */
+
+/** 四向放置方向（top/bottom 含 -start/-end 水平对齐变体） */
+type Placement = 'top' | 'bottom' | 'left' | 'right' | 'top-start' | 'top-end' | 'bottom-start' | 'bottom-end';
+interface UsePositioningOptions {
+    /** 触发元素 ref（点击/聚焦触发器的那个元素） */
+    triggerRef: Ref<HTMLElement | null>;
+    /** 弹出面板 ref（Teleport 挂载后的根元素） */
+    panelRef: Ref<HTMLElement | null>;
+    /** 期望放置方向（响应式，变化时重新定位） */
+    placement: Ref<Placement>;
+    /** 面板与触发器间距（px），默认 4 */
+    offset?: number;
+    /** 空间不足时是否翻转到对侧，默认 true */
+    flip?: boolean;
+    /** 是否让面板宽度跟随触发器宽度（Select 场景），默认 false */
+    matchTriggerWidth?: boolean;
+}
+interface UsePositioningReturn {
+    /** fixed 定位样式（初始 position:fixed + visibility:hidden，挂载后由 updatePosition 更新） */
+    positionStyle: Ref<Record<string, string>>;
+    /** 实际放置方向（空间不足翻转后为对侧；供浮层箭头朝向使用） */
+    actualPlacement: Ref<Placement>;
+    /** 计算并更新位置（含 rAF 重试处理 Teleport 挂载时序） */
+    updatePosition: () => Promise<void>;
+    /** 绑定 window scroll(capture)/resize 监听，触发重定位 */
+    startAutoReposition: () => void;
+    /** 解绑上述监听 */
+    stopAutoReposition: () => void;
+    /** 清理：解绑监听 + 取消 pending rAF（无泄漏契约） */
+    dispose: () => void;
+}
+declare function usePositioning(options: UsePositioningOptions): UsePositioningReturn;
+
+export { usePositioning as u };

package/es/shared/components.4UjasbrA.d.mts

@@ -0,0 +1,51 @@
+import { Ref } from 'vue';
+
+/**
+ * usePositioning —— 共享 fixed 定位 + 视口翻转组合式函数
+ *
+ * 职责（从 Select 内联逻辑抽取，供 Tooltip / Popover / Dropdown / DatePicker 复用）：
+ * - 纯函数 computePosition：top/bottom/left/right 四向（含 top/bottom 的 -start/-end 水平对齐变体）
+ *   + 视口空间不足自动翻转（start/end 变体翻转后保持对齐方式）；
+ * - composable：Teleport 挂载时序 rAF 重试、window scroll/resize 重定位、dispose 无泄漏；
+ * - 初始样式含 position:fixed（面板挂载即脱离文档流收缩尺寸，避免静态块级元素被量成全宽）；
+ * - 零第三方运行时依赖（性能规范 §11.2）；模块顶层不访问 window/document，SSR 安全。
+ *
+ * 行为契约（与原 Select 内联实现等价）：
+ * - offset 默认 4（GAP）；
+ * - 面板/触发器未挂载时 rAF 重试，上限 10 次；
+ * - scroll 监听使用捕获阶段（捕获内层滚动事件）。
+ */
+
+/** 四向放置方向（top/bottom 含 -start/-end 水平对齐变体） */
+type Placement = 'top' | 'bottom' | 'left' | 'right' | 'top-start' | 'top-end' | 'bottom-start' | 'bottom-end';
+interface UsePositioningOptions {
+    /** 触发元素 ref（点击/聚焦触发器的那个元素） */
+    triggerRef: Ref<HTMLElement | null>;
+    /** 弹出面板 ref（Teleport 挂载后的根元素） */
+    panelRef: Ref<HTMLElement | null>;
+    /** 期望放置方向（响应式，变化时重新定位） */
+    placement: Ref<Placement>;
+    /** 面板与触发器间距（px），默认 4 */
+    offset?: number;
+    /** 空间不足时是否翻转到对侧，默认 true */
+    flip?: boolean;
+    /** 是否让面板宽度跟随触发器宽度（Select 场景），默认 false */
+    matchTriggerWidth?: boolean;
+}
+interface UsePositioningReturn {
+    /** fixed 定位样式（初始 position:fixed + visibility:hidden，挂载后由 updatePosition 更新） */
+    positionStyle: Ref<Record<string, string>>;
+    /** 实际放置方向（空间不足翻转后为对侧；供浮层箭头朝向使用） */
+    actualPlacement: Ref<Placement>;
+    /** 计算并更新位置（含 rAF 重试处理 Teleport 挂载时序） */
+    updatePosition: () => Promise<void>;
+    /** 绑定 window scroll(capture)/resize 监听，触发重定位 */
+    startAutoReposition: () => void;
+    /** 解绑上述监听 */
+    stopAutoReposition: () => void;
+    /** 清理：解绑监听 + 取消 pending rAF（无泄漏契约） */
+    dispose: () => void;
+}
+declare function usePositioning(options: UsePositioningOptions): UsePositioningReturn;
+
+export { usePositioning as u };

package/es/shared/components.4UjasbrA.d.ts

@@ -0,0 +1,51 @@
+import { Ref } from 'vue';
+
+/**
+ * usePositioning —— 共享 fixed 定位 + 视口翻转组合式函数
+ *
+ * 职责（从 Select 内联逻辑抽取，供 Tooltip / Popover / Dropdown / DatePicker 复用）：
+ * - 纯函数 computePosition：top/bottom/left/right 四向（含 top/bottom 的 -start/-end 水平对齐变体）
+ *   + 视口空间不足自动翻转（start/end 变体翻转后保持对齐方式）；
+ * - composable：Teleport 挂载时序 rAF 重试、window scroll/resize 重定位、dispose 无泄漏；
+ * - 初始样式含 position:fixed（面板挂载即脱离文档流收缩尺寸，避免静态块级元素被量成全宽）；
+ * - 零第三方运行时依赖（性能规范 §11.2）；模块顶层不访问 window/document，SSR 安全。
+ *
+ * 行为契约（与原 Select 内联实现等价）：
+ * - offset 默认 4（GAP）；
+ * - 面板/触发器未挂载时 rAF 重试，上限 10 次；
+ * - scroll 监听使用捕获阶段（捕获内层滚动事件）。
+ */
+
+/** 四向放置方向（top/bottom 含 -start/-end 水平对齐变体） */
+type Placement = 'top' | 'bottom' | 'left' | 'right' | 'top-start' | 'top-end' | 'bottom-start' | 'bottom-end';
+interface UsePositioningOptions {
+    /** 触发元素 ref（点击/聚焦触发器的那个元素） */
+    triggerRef: Ref<HTMLElement | null>;
+    /** 弹出面板 ref（Teleport 挂载后的根元素） */
+    panelRef: Ref<HTMLElement | null>;
+    /** 期望放置方向（响应式，变化时重新定位） */
+    placement: Ref<Placement>;
+    /** 面板与触发器间距（px），默认 4 */
+    offset?: number;
+    /** 空间不足时是否翻转到对侧，默认 true */
+    flip?: boolean;
+    /** 是否让面板宽度跟随触发器宽度（Select 场景），默认 false */
+    matchTriggerWidth?: boolean;
+}
+interface UsePositioningReturn {
+    /** fixed 定位样式（初始 position:fixed + visibility:hidden，挂载后由 updatePosition 更新） */
+    positionStyle: Ref<Record<string, string>>;
+    /** 实际放置方向（空间不足翻转后为对侧；供浮层箭头朝向使用） */
+    actualPlacement: Ref<Placement>;
+    /** 计算并更新位置（含 rAF 重试处理 Teleport 挂载时序） */
+    updatePosition: () => Promise<void>;
+    /** 绑定 window scroll(capture)/resize 监听，触发重定位 */
+    startAutoReposition: () => void;
+    /** 解绑上述监听 */
+    stopAutoReposition: () => void;
+    /** 清理：解绑监听 + 取消 pending rAF（无泄漏契约） */
+    dispose: () => void;
+}
+declare function usePositioning(options: UsePositioningOptions): UsePositioningReturn;
+
+export { usePositioning as u };

package/es/shared/components.4lt7h-GW.d.ts

@@ -0,0 +1,86 @@
+import { PropType, defineComponent, computed, openBlock, createElementBlock, normalizeStyle, normalizeClass, renderSlot } from 'vue';
+import { _ as _export_sfc } from './components.OJRSZE6i.js';
+
+/**
+ * QmSpace 组件类型定义（组件体系设计 §6.4：类型先行）
+ * 布局-03：flex 间距容器，子元素间自动 gap；方向 / 间距 / 换行 / 对齐 / 填满。
+ */
+
+/** 排列方向 */
+type SpaceDirection = 'horizontal' | 'vertical';
+/** 间距档位（§6.3：尺寸枚举统一 small | medium | large）+ 自定义 number */
+type SpaceSize = 'small' | 'medium' | 'large';
+/** 垂直对齐（align-items 语义） */
+type SpaceAlign = 'start' | 'end' | 'center' | 'baseline';
+/** props 声明（纯类型 + 默认值，供 SFC 与文档复用） */
+declare const spaceProps: {
+    /** 排列方向：horizontal / vertical */
+    readonly direction: {
+        readonly type: PropType<SpaceDirection>;
+        readonly default: "horizontal";
+    };
+    /** 间距：small / medium / large（消费分档 Token）；number 自定义（px） */
+    readonly size: {
+        readonly type: PropType<SpaceSize | number>;
+        readonly default: "medium";
+    };
+    /** 自动换行（换行后行距走 --qm-space-wrap-gap） */
+    readonly wrap: {
+        readonly type: BooleanConstructor;
+        readonly default: false;
+    };
+    /** 垂直对齐：start / end / center / baseline */
+    readonly align: {
+        readonly type: PropType<SpaceAlign>;
+        readonly default: "center";
+    };
+    /** 填满：子元素 flex: 1 均分 */
+    readonly fill: {
+        readonly type: BooleanConstructor;
+        readonly default: false;
+    };
+};
+
+var _sfc_main = /* @__PURE__ */ defineComponent({
+  ...{ name: "QmSpace" },
+  __name: "space",
+  props: spaceProps,
+  setup(__props, { expose: __expose }) {
+    __expose();
+    const props = __props;
+    const enumSize = computed(
+      () => props.size === "small" || props.size === "medium" || props.size === "large" ? props.size : null
+    );
+    const modifierClass = computed(() => {
+      const classes = [`qm-space--${props.direction}`, `qm-space--align-${props.align}`];
+      if (enumSize.value) classes.push(`qm-space--${enumSize.value}`);
+      if (props.wrap) classes.push("qm-space--wrap");
+      if (props.fill) classes.push("qm-space--fill");
+      return classes;
+    });
+    const rootStyle = computed(() => ({
+      gap: typeof props.size === "number" ? `${props.size}px` : void 0
+    }));
+    const __returned__ = { props, enumSize, modifierClass, rootStyle };
+    Object.defineProperty(__returned__, "__isScriptSetup", { enumerable: false, value: true });
+    return __returned__;
+  }
+});
+
+function _sfc_render(_ctx, _cache, $props, $setup, $data, $options) {
+	return openBlock(), createElementBlock(
+		"div",
+		{
+			class: normalizeClass(["qm-space", $setup.modifierClass]),
+			style: normalizeStyle($setup.rootStyle),
+			"data-qm": "space"
+		},
+		[renderSlot(_ctx.$slots, "default")],
+		6
+		/* CLASS, STYLE */
+	);
+}
+var Space = /*#__PURE__*/ _export_sfc(_sfc_main, [["render", _sfc_render], ["__file", "F:\\软件开发\\青冥组件系统\\packages\\components\\src\\components\\space\\space.vue"]]);
+
+export { Space as S, spaceProps as s };
+export type { SpaceAlign as a, SpaceDirection as b, SpaceSize as c };

package/es/shared/components.54wxKDZE.mjs

@@ -0,0 +1,156 @@
+import { ref, watch, computed, defineComponent, toRef, openBlock, createElementBlock, normalizeClass, toDisplayString, createCommentVNode, createElementVNode, createVNode } from 'vue';
+import { I as Icon } from './components.D3on6_fI.mjs';
+import { _ as _export_sfc } from './components.pcqpp-6-.mjs';
+
+const switchProps = {
+  /** 受控值（v-model）；未传即非受控（组件内自维护） */
+  modelValue: {
+    type: [Boolean, String, Number],
+    default: false
+  },
+  /** 禁用态：视觉 + 行为（不可点击/键盘），aria-disabled */
+  disabled: { type: Boolean, default: false },
+  /** 加载态：禁用点击 + 滑块内旋转图标（SVG currentColor）+ aria-busy="true" */
+  loading: { type: Boolean, default: false },
+  /** 尺寸：small / medium / large */
+  size: { type: String, default: "medium" },
+  /** 开启态文字（轨道内，随状态切换显示） */
+  activeText: { type: String, default: "" },
+  /** 关闭态文字（轨道内，随状态切换显示） */
+  inactiveText: { type: String, default: "" },
+  /** 开启时的值（默认 true；支持 string/number/boolean 自定义值） */
+  activeValue: {
+    type: [Boolean, String, Number],
+    default: true
+  },
+  /** 关闭时的值（默认 false；支持 string/number/boolean 自定义值） */
+  inactiveValue: {
+    type: [Boolean, String, Number],
+    default: false
+  }
+};
+
+function useSwitch(options) {
+  const { modelValue, disabled, loading, activeValue, inactiveValue, emitUpdate, emitChange } = options;
+  const inner = ref(modelValue.value);
+  watch(modelValue, (v) => {
+    inner.value = v;
+  });
+  const checked = computed(() => inner.value === activeValue.value);
+  const interactive = computed(() => !disabled.value && !loading.value);
+  function emitTo(next) {
+    inner.value = next;
+    emitUpdate(next);
+    emitChange(next);
+  }
+  function toggle() {
+    if (!interactive.value)
+      return;
+    emitTo(checked.value ? inactiveValue.value : activeValue.value);
+  }
+  function handleKeydown(event) {
+    if (event.key !== " " && event.key !== "Spacebar" && event.key !== "Enter")
+      return;
+    if (!interactive.value)
+      return;
+    event.preventDefault();
+    toggle();
+  }
+  return {
+    checked,
+    interactive,
+    toggle,
+    handleKeydown
+  };
+}
+
+const _sfc_main = /* @__PURE__ */ defineComponent({
+  ...{ name: "QmSwitch" },
+  __name: "switch",
+  props: switchProps,
+  emits: ["update:modelValue", "change"],
+  setup(__props, { expose: __expose, emit: __emit }) {
+    __expose();
+    const props = __props;
+    const emit = __emit;
+    const modelValue = toRef(props, "modelValue");
+    const disabled = toRef(props, "disabled");
+    const loading = toRef(props, "loading");
+    const activeValue = toRef(props, "activeValue");
+    const inactiveValue = toRef(props, "inactiveValue");
+    const sw = useSwitch({
+      modelValue,
+      disabled,
+      loading,
+      activeValue,
+      inactiveValue,
+      emitUpdate: (value) => emit("update:modelValue", value),
+      emitChange: (value) => emit("change", value)
+    });
+    const { checked, interactive } = sw;
+    const text = computed(() => checked.value ? props.activeText : props.inactiveText);
+    const hasText = computed(() => Boolean(props.activeText || props.inactiveText));
+    const modifierClass = computed(() => {
+      const classes = [`qm-switch--${props.size}`];
+      if (checked.value)
+        classes.push("qm-switch--checked");
+      if (props.disabled)
+        classes.push("qm-switch--disabled");
+      if (props.loading)
+        classes.push("qm-switch--loading");
+      if (hasText.value)
+        classes.push("qm-switch--text");
+      return classes;
+    });
+    const __returned__ = { props, emit, modelValue, disabled, loading, activeValue, inactiveValue, sw, checked, interactive, text, hasText, modifierClass, get QmIcon() {
+      return Icon;
+    } };
+    Object.defineProperty(__returned__, "__isScriptSetup", { enumerable: false, value: true });
+    return __returned__;
+  }
+});
+
+const _hoisted_1 = [
+	"aria-checked",
+	"aria-disabled",
+	"aria-busy",
+	"aria-label",
+	"tabindex"
+];
+const _hoisted_2 = {
+	key: 0,
+	class: "qm-switch__text"
+};
+const _hoisted_3 = {
+	class: "qm-switch__knob",
+	"aria-hidden": "true"
+};
+const _hoisted_4 = {
+	key: 0,
+	class: "qm-switch__loading-icon"
+};
+function _sfc_render(_ctx, _cache, $props, $setup, $data, $options) {
+	return openBlock(), createElementBlock("div", {
+		class: normalizeClass(["qm-switch", $setup.modifierClass]),
+		role: "switch",
+		"aria-checked": $setup.checked,
+		"aria-disabled": $setup.disabled || undefined,
+		"aria-busy": $setup.loading || undefined,
+		"aria-label": $setup.text || undefined,
+		tabindex: $setup.interactive ? 0 : -1,
+		onClick: _cache[0] || (_cache[0] = (...args) => $setup.sw.toggle && $setup.sw.toggle(...args)),
+		onKeydown: _cache[1] || (_cache[1] = (...args) => $setup.sw.handleKeydown && $setup.sw.handleKeydown(...args))
+	}, [$setup.text ? (openBlock(), createElementBlock(
+		"span",
+		_hoisted_2,
+		toDisplayString($setup.text),
+		1
+		/* TEXT */
+	)) : createCommentVNode("v-if", true), createElementVNode("span", _hoisted_3, [$setup.loading ? (openBlock(), createElementBlock("span", _hoisted_4, [createVNode($setup["QmIcon"], {
+		name: "loading",
+		style: { "font-size": "12px" }
+	})])) : createCommentVNode("v-if", true)])], 42, _hoisted_1);
+}
+const Switch = /*#__PURE__*/ _export_sfc(_sfc_main, [["render", _sfc_render], ["__file", "F:\\软件开发\\青冥组件系统\\packages\\components\\src\\components\\switch\\switch.vue"]]);
+
+export { Switch as S, switchProps as s, useSwitch as u };