@qingmingmu/components 0.1.0-beta.0

package/es/shared/components.BNXBaiBD.d.mts

@@ -0,0 +1,269 @@
+import { PropType, InjectionKey, defineComponent, reactive, provide, computed, openBlock, createElementBlock, normalizeClass, createElementVNode, Fragment, renderList, normalizeStyle, toDisplayString, renderSlot, createTextVNode, createCommentVNode, inject, onMounted, onBeforeUnmount, watch } from 'vue';
+import { _ as _export_sfc } from './components.OJRSZE6i.mjs';
+
+/**
+ * QmTable 组件类型定义（03-数据展示）
+ * 表格：列配置 / 斑马纹 / 边框 / 空态 / 自定义渲染
+ */
+
+/** 列配置（columns prop 或 QmTableColumn 子项） */
+interface TableColumnConfig {
+    /** 数据字段名（行对象取值键） */
+    prop: string;
+    /** 列标题 */
+    label: string;
+    /** 列宽（number → px，string 原样，如 '20%'） */
+    width?: string | number;
+    /** 自定义单元格渲染：对应具名插槽 `#<slotName>="{ row, column, index }"` */
+    slotName?: string;
+}
+declare const tableProps: {
+    /** 表格数据 */
+    readonly data: {
+        readonly type: PropType<any[]>;
+        readonly default: () => never[];
+    };
+    /** 列配置（prop/label/width/slotName），与默认插槽 QmTableColumn 二选一 */
+    readonly columns: {
+        readonly type: PropType<TableColumnConfig[]>;
+        readonly default: () => never[];
+    };
+    /** 是否显示边框 */
+    readonly border: {
+        readonly type: BooleanConstructor;
+        readonly default: false;
+    };
+    /** 斑马纹 */
+    readonly stripe: {
+        readonly type: BooleanConstructor;
+        readonly default: false;
+    };
+    /** 行 hover 高亮 */
+    readonly hover: {
+        readonly type: BooleanConstructor;
+        readonly default: true;
+    };
+    /** 空态文案（empty 插槽可覆盖） */
+    readonly emptyText: {
+        readonly type: StringConstructor;
+        readonly default: "暂无数据";
+    };
+    /** 行唯一标识字段（用于 :key；缺省用索引） */
+    readonly rowKey: {
+        readonly type: StringConstructor;
+        readonly default: "";
+    };
+};
+/** emits 声明 */
+interface TableEmits {
+    /** 行点击（携带当前行与索引） */
+    rowClick: [row: any, index: number];
+}
+/** QmTable 向 QmTableColumn 提供的上下文（provide/inject 收集列配置） */
+interface TableColumnContext {
+    register: (col: TableColumnConfig) => void;
+    unregister: (col: TableColumnConfig) => void;
+}
+declare const tableColumnContextKey: InjectionKey<TableColumnContext>;
+
+var _sfc_main$1 = /* @__PURE__ */ defineComponent({
+  ...{ name: "QmTable" },
+  __name: "table",
+  props: tableProps,
+  emits: ["rowClick"],
+  setup(__props, { expose: __expose, emit: __emit }) {
+    __expose();
+    const props = __props;
+    const emit = __emit;
+    const registeredColumns = reactive([]);
+    provide(tableColumnContextKey, {
+      register: (col) => {
+        registeredColumns.push(col);
+      },
+      unregister: (col) => {
+        const i = registeredColumns.indexOf(col);
+        if (i >= 0)
+          registeredColumns.splice(i, 1);
+      }
+    });
+    const columns = computed(
+      () => props.columns.length > 0 ? props.columns : registeredColumns
+    );
+    const modifierClass = computed(() => ({
+      "qm-table--border": props.border,
+      "qm-table--stripe": props.stripe,
+      "qm-table--hover": props.hover
+    }));
+    function columnWidthStyle(col) {
+      if (!col.width)
+        return void 0;
+      return { width: typeof col.width === "number" ? `${col.width}px` : col.width };
+    }
+    function rowKeyOf(row, index) {
+      if (props.rowKey && row[props.rowKey] != null)
+        return String(row[props.rowKey]);
+      return index;
+    }
+    function onRowClick(row, index) {
+      emit("rowClick", row, index);
+    }
+    const __returned__ = { props, emit, registeredColumns, columns, modifierClass, columnWidthStyle, rowKeyOf, onRowClick };
+    Object.defineProperty(__returned__, "__isScriptSetup", { enumerable: false, value: true });
+    return __returned__;
+  }
+});
+
+const _hoisted_1 = {
+	key: 0,
+	class: "qm-table__inner"
+};
+const _hoisted_2 = { class: "qm-table__head" };
+const _hoisted_3 = { class: "qm-table__head-row" };
+const _hoisted_4 = { class: "qm-table__body" };
+const _hoisted_5 = ["onClick"];
+const _hoisted_6 = {
+	key: 1,
+	class: "qm-table__empty"
+};
+function _sfc_render$1(_ctx, _cache, $props, $setup, $data, $options) {
+	return openBlock(), createElementBlock(
+		"div",
+		{
+			class: normalizeClass(["qm-table", $setup.modifierClass]),
+			"data-qm": "table"
+		},
+		[
+			_ctx.data.length ? (openBlock(), createElementBlock("table", _hoisted_1, [createElementVNode("thead", _hoisted_2, [createElementVNode("tr", _hoisted_3, [(openBlock(true), createElementBlock(
+				Fragment,
+				null,
+				renderList($setup.columns, (col) => {
+					return openBlock(), createElementBlock(
+						"th",
+						{
+							key: col.prop,
+							class: "qm-table__cell qm-table__cell--head",
+							style: normalizeStyle($setup.columnWidthStyle(col)),
+							scope: "col"
+						},
+						toDisplayString(col.label),
+						5
+						/* TEXT, STYLE */
+					);
+				}),
+				128
+				/* KEYED_FRAGMENT */
+			))])]), createElementVNode("tbody", _hoisted_4, [(openBlock(true), createElementBlock(
+				Fragment,
+				null,
+				renderList(_ctx.data, (row, index) => {
+					return openBlock(), createElementBlock("tr", {
+						key: $setup.rowKeyOf(row, index),
+						class: "qm-table__row",
+						onClick: ($event) => $setup.onRowClick(row, index)
+					}, [(openBlock(true), createElementBlock(
+						Fragment,
+						null,
+						renderList($setup.columns, (col) => {
+							return openBlock(), createElementBlock(
+								"td",
+								{
+									key: col.prop,
+									class: "qm-table__cell",
+									style: normalizeStyle($setup.columnWidthStyle(col))
+								},
+								[col.slotName && _ctx.$slots[col.slotName] ? renderSlot(_ctx.$slots, col.slotName, {
+									row,
+									column: col,
+									index
+								}, undefined, undefined, 0) : (openBlock(), createElementBlock(
+									Fragment,
+									{ key: 1 },
+									[createTextVNode(
+										toDisplayString(row[col.prop]),
+										1
+										/* TEXT */
+									)],
+									64
+									/* STABLE_FRAGMENT */
+								))],
+								4
+								/* STYLE */
+							);
+						}),
+						128
+						/* KEYED_FRAGMENT */
+					))], 8, _hoisted_5);
+				}),
+				128
+				/* KEYED_FRAGMENT */
+			))])])) : (openBlock(), createElementBlock("div", _hoisted_6, [renderSlot(_ctx.$slots, "empty", {}, () => [createTextVNode(
+				toDisplayString(_ctx.emptyText),
+				1
+				/* TEXT */
+			)])])),
+			createCommentVNode(" QmTableColumn 子项挂载点（renderless，仅向父级注册列配置） "),
+			renderSlot(_ctx.$slots, "default")
+		],
+		2
+		/* CLASS */
+	);
+}
+var Table = /*#__PURE__*/ _export_sfc(_sfc_main$1, [["render", _sfc_render$1], ["__file", "F:\\软件开发\\青冥组件系统\\packages\\components\\src\\components\\table\\table.vue"]]);
+
+var _sfc_main = /* @__PURE__ */ defineComponent({
+  ...{ name: "QmTableColumn" },
+  __name: "table-column",
+  props: {
+    /** 数据字段名（行对象取值键） */
+    prop: { type: String, required: true },
+    /** 列标题 */
+    label: { type: String, default: "" },
+    /** 列宽（number → px，string 原样） */
+    width: { type: [String, Number], default: void 0 },
+    /** 自定义单元格渲染：对应具名插槽 */
+    slotName: { type: String, default: "" }
+  },
+  setup(__props, { expose: __expose }) {
+    __expose();
+    const props = __props;
+    const context = inject(tableColumnContextKey, null);
+    const state = reactive({
+      prop: props.prop,
+      label: props.label,
+      width: props.width,
+      slotName: props.slotName
+    });
+    onMounted(() => {
+      context?.register(state);
+    });
+    onBeforeUnmount(() => {
+      context?.unregister(state);
+    });
+    watch(
+      () => [props.prop, props.label, props.width, props.slotName],
+      () => {
+        state.prop = props.prop;
+        state.label = props.label;
+        state.width = props.width;
+        state.slotName = props.slotName;
+      }
+    );
+    const __returned__ = { props, context, state };
+    Object.defineProperty(__returned__, "__isScriptSetup", { enumerable: false, value: true });
+    return __returned__;
+  }
+});
+
+function _sfc_render(_ctx, _cache, $props, $setup, $data, $options) {
+	return openBlock(), createElementBlock(
+		Fragment,
+		null,
+		[createCommentVNode(" renderless：仅注册列配置；v-if=false 保证模板根节点合法且不渲染 DOM "), createCommentVNode("v-if", true)],
+		2112
+		/* STABLE_FRAGMENT, DEV_ROOT_FRAGMENT */
+	);
+}
+var tableColumn = /*#__PURE__*/ _export_sfc(_sfc_main, [["render", _sfc_render], ["__file", "F:\\软件开发\\青冥组件系统\\packages\\components\\src\\components\\table\\table-column.vue"]]);
+
+export { Table as T, tableColumnContextKey as d, tableProps as e, tableColumn as t };
+export type { TableColumnConfig as a, TableColumnContext as b, TableEmits as c };

package/es/shared/components.BPdCwk8C.d.ts

@@ -0,0 +1,272 @@
+import { PropType, Ref, ComputedRef, defineComponent, useId, ref, computed, watch, onBeforeUnmount, openBlock, createElementBlock, Fragment, createCommentVNode, createElementVNode, renderSlot, createBlock, Teleport, createVNode, Transition, withCtx, normalizeStyle, normalizeClass, createTextVNode, toDisplayString } from 'vue';
+import { u as usePositioning } from './components.4UjasbrA.js';
+import { _ as _export_sfc } from './components.OJRSZE6i.js';
+
+/**
+ * QmTooltip 组件类型定义（组件体系设计 §6.4：类型先行）
+ * 03-T9：文字提示，基于 use-positioning 共享定位模块
+ * - 触发：hover（延迟防闪烁）/ focus / click（外部点击关闭）
+ * - 位置：top/bottom/left/right 四向 + 视口自动翻转（use-positioning）
+ * - ARIA：触发器 aria-describedby 关联浮层 role=tooltip
+ * - 受控：v-model:visible；未传即非受控
+ */
+
+/** 弹出位置（四向；空间不足时由 use-positioning 自动翻转到对侧） */
+type TooltipPlacement = 'top' | 'bottom' | 'left' | 'right';
+/** 触发方式 */
+type TooltipTrigger = 'hover' | 'focus' | 'click';
+/** props 声明 */
+declare const tooltipProps: {
+    /** 提示文案（也可用 content 插槽 / 触发器默认插槽旁的 #content） */
+    readonly content: {
+        readonly type: StringConstructor;
+        readonly default: "";
+    };
+    /** 弹出位置（空间不足自动翻转） */
+    readonly placement: {
+        readonly type: PropType<TooltipPlacement>;
+        readonly default: "top";
+    };
+    /** 触发方式 */
+    readonly trigger: {
+        readonly type: PropType<TooltipTrigger>;
+        readonly default: "hover";
+    };
+    /** 受控显隐（v-model:visible）；未传即非受控（组件内自维护） */
+    readonly visible: {
+        readonly type: BooleanConstructor;
+        readonly default: undefined;
+    };
+    /** 禁用（不显示浮层，触发器不可聚焦） */
+    readonly disabled: {
+        readonly type: BooleanConstructor;
+        readonly default: false;
+    };
+    /** 是否显示箭头 */
+    readonly showArrow: {
+        readonly type: BooleanConstructor;
+        readonly default: true;
+    };
+    /** hover 进入延迟（ms，防闪烁） */
+    readonly enterDelay: {
+        readonly type: NumberConstructor;
+        readonly default: 100;
+    };
+    /** hover 离开延迟（ms，防闪烁） */
+    readonly leaveDelay: {
+        readonly type: NumberConstructor;
+        readonly default: 100;
+    };
+    /** Teleport 挂载目标（CSS 选择器，默认 body） */
+    readonly appendTo: {
+        readonly type: StringConstructor;
+        readonly default: "body";
+    };
+};
+/** emits 声明 */
+interface TooltipEmits {
+    /** 显隐同步（v-model:visible） */
+    'update:visible': [value: boolean];
+    /** 显示时触发 */
+    'show': [];
+    /** 隐藏时触发 */
+    'hide': [];
+}
+
+/**
+ * useTooltip 行为层（03-T9 §4）
+ *
+ * 职责（与视图解耦，可独立单测）：
+ * - 受控/非受控显隐状态统一管理（props.visible 传入即受控，否则内部自维护）；
+ * - 触发契约：
+ *     hover  —— mouseenter 经 enterDelay 显示，mouseleave 经 leaveDelay 隐藏（互清定时器防闪烁）；
+ *     focus  —— focus 显示，blur 隐藏（Tab 离开关闭）；
+ *     click  —— 点击切换，外部点击关闭；
+ * - 键盘：Esc 关闭（document keydown，仅显示期监听）；
+ * - show/hide 事件契约 + update:visible 同步；
+ * - 延迟定时器清理（无泄漏契约）。
+ *
+ * 定位（fixed/翻转/滚动重定位）复用 composables/use-positioning，不在此内联。
+ */
+
+interface UseTooltipOptions {
+    /** 受控显隐（props.visible，undefined 即非受控） */
+    visible: Ref<boolean | undefined>;
+    /** 触发方式 */
+    trigger: Ref<TooltipTrigger>;
+    /** 禁用 */
+    disabled: Ref<boolean>;
+    /** hover 进入延迟（ms） */
+    enterDelay: Ref<number>;
+    /** hover 离开延迟（ms） */
+    leaveDelay: Ref<number>;
+    emitUpdate: (value: boolean) => void;
+    emitShow: () => void;
+    emitHide: () => void;
+}
+interface UseTooltipReturn {
+    /** 当前解析后的显隐（受控时跟随 props，非受控时为内部状态） */
+    isVisible: ComputedRef<boolean>;
+    /** 编程式显示（禁用时忽略） */
+    show: () => void;
+    /** 编程式隐藏 */
+    hide: () => void;
+    /** 切换（click 触发用） */
+    toggle: () => void;
+    onMouseenter: () => void;
+    onMouseleave: () => void;
+    onFocus: () => void;
+    onBlur: () => void;
+    onClick: () => void;
+    /** 文档 keydown：Esc 关闭（组件层在显示期绑定/解绑） */
+    onDocumentKeydown: (event: KeyboardEvent) => void;
+    /** 卸载清理：清除延迟定时器（无泄漏契约） */
+    dispose: () => void;
+}
+declare function useTooltip(options: UseTooltipOptions): UseTooltipReturn;
+
+var _sfc_main = /* @__PURE__ */ defineComponent({
+  ...{ name: "QmTooltip" },
+  __name: "tooltip",
+  props: tooltipProps,
+  emits: ["update:visible", "show", "hide"],
+  setup(__props, { expose: __expose, emit: __emit }) {
+    __expose();
+    const props = __props;
+    const emit = __emit;
+    const uid = useId();
+    const tooltipId = `qm-tooltip-${uid}`;
+    const triggerRef = ref(null);
+    const panelRef = ref(null);
+    const visibleProp = computed(() => props.visible);
+    const triggerProp = computed(() => props.trigger);
+    const disabledProp = computed(() => props.disabled);
+    const enterDelayProp = computed(() => props.enterDelay);
+    const leaveDelayProp = computed(() => props.leaveDelay);
+    const {
+      isVisible,
+      hide,
+      onMouseenter,
+      onMouseleave,
+      onFocus,
+      onBlur,
+      onClick,
+      onDocumentKeydown,
+      dispose: disposeBehavior
+    } = useTooltip({
+      visible: visibleProp,
+      trigger: triggerProp,
+      disabled: disabledProp,
+      enterDelay: enterDelayProp,
+      leaveDelay: leaveDelayProp,
+      emitUpdate: (value) => emit("update:visible", value),
+      emitShow: () => emit("show"),
+      emitHide: () => emit("hide")
+    });
+    const placementProp = computed(() => props.placement);
+    const {
+      positionStyle,
+      actualPlacement,
+      updatePosition,
+      startAutoReposition,
+      stopAutoReposition,
+      dispose: disposePositioning
+    } = usePositioning({
+      triggerRef,
+      panelRef,
+      placement: placementProp,
+      offset: 8,
+      flip: true
+    });
+    function onDocumentMousedown(event) {
+      if (props.trigger !== "click")
+        return;
+      const target = event.target;
+      if (triggerRef.value?.contains(target) || panelRef.value?.contains(target))
+        return;
+      hide();
+    }
+    watch(
+      isVisible,
+      (val) => {
+        if (val) {
+          void updatePosition();
+          startAutoReposition();
+          document.addEventListener("mousedown", onDocumentMousedown, true);
+          document.addEventListener("keydown", onDocumentKeydown, true);
+        } else {
+          stopAutoReposition();
+          document.removeEventListener("mousedown", onDocumentMousedown, true);
+          document.removeEventListener("keydown", onDocumentKeydown, true);
+        }
+      },
+      { flush: "post" }
+    );
+    onBeforeUnmount(() => {
+      document.removeEventListener("mousedown", onDocumentMousedown, true);
+      document.removeEventListener("keydown", onDocumentKeydown, true);
+      stopAutoReposition();
+      disposePositioning();
+      disposeBehavior();
+    });
+    const ariaDescribedby = computed(() => isVisible.value ? tooltipId : void 0);
+    const __returned__ = { props, emit, uid, tooltipId, triggerRef, panelRef, visibleProp, triggerProp, disabledProp, enterDelayProp, leaveDelayProp, isVisible, hide, onMouseenter, onMouseleave, onFocus, onBlur, onClick, onDocumentKeydown, disposeBehavior, placementProp, positionStyle, actualPlacement, updatePosition, startAutoReposition, stopAutoReposition, disposePositioning, onDocumentMousedown, ariaDescribedby };
+    Object.defineProperty(__returned__, "__isScriptSetup", { enumerable: false, value: true });
+    return __returned__;
+  }
+});
+
+const _hoisted_1 = ["tabindex", "aria-describedby"];
+const _hoisted_2 = {
+	key: 0,
+	class: "qm-tooltip__arrow",
+	"aria-hidden": "true"
+};
+function _sfc_render(_ctx, _cache, $props, $setup, $data, $options) {
+	return openBlock(), createElementBlock(
+		Fragment,
+		null,
+		[
+			createCommentVNode(" 触发器（default 插槽；可聚焦以支持 focus 触发与键盘操作） "),
+			createElementVNode("span", {
+				ref: "triggerRef",
+				class: "qm-tooltip__trigger",
+				tabindex: _ctx.disabled ? -1 : 0,
+				"aria-describedby": $setup.ariaDescribedby,
+				onMouseenter: _cache[0] || (_cache[0] = (...args) => $setup.onMouseenter && $setup.onMouseenter(...args)),
+				onMouseleave: _cache[1] || (_cache[1] = (...args) => $setup.onMouseleave && $setup.onMouseleave(...args)),
+				onFocusin: _cache[2] || (_cache[2] = (...args) => $setup.onFocus && $setup.onFocus(...args)),
+				onFocusout: _cache[3] || (_cache[3] = (...args) => $setup.onBlur && $setup.onBlur(...args)),
+				onClick: _cache[4] || (_cache[4] = (...args) => $setup.onClick && $setup.onClick(...args))
+			}, [renderSlot(_ctx.$slots, "default")], 40, _hoisted_1),
+			createCommentVNode(" 浮层（Teleport + Transition；fixed 定位由 use-positioning 计算） "),
+			(openBlock(), createBlock(Teleport, { to: _ctx.appendTo }, [createVNode(Transition, { name: "qm-tooltip" }, {
+				default: withCtx(() => [$setup.isVisible ? (openBlock(), createElementBlock(
+					"div",
+					{
+						key: 0,
+						id: $setup.tooltipId,
+						ref: "panelRef",
+						class: normalizeClass(["qm-tooltip", `qm-tooltip--${$setup.actualPlacement}`]),
+						style: normalizeStyle($setup.positionStyle),
+						role: "tooltip"
+					},
+					[renderSlot(_ctx.$slots, "content", {}, () => [createTextVNode(
+						toDisplayString(_ctx.content),
+						1
+						/* TEXT */
+					)]), _ctx.showArrow ? (openBlock(), createElementBlock("span", _hoisted_2)) : createCommentVNode("v-if", true)],
+					6
+					/* CLASS, STYLE */
+				)) : createCommentVNode("v-if", true)]),
+				_: 3
+			})], 8, ["to"]))
+		],
+		64
+		/* STABLE_FRAGMENT */
+	);
+}
+var Tooltip = /*#__PURE__*/ _export_sfc(_sfc_main, [["render", _sfc_render], ["__file", "F:\\软件开发\\青冥组件系统\\packages\\components\\src\\components\\tooltip\\tooltip.vue"]]);
+
+export { Tooltip as T, tooltipProps as t, useTooltip as u };
+export type { UseTooltipOptions as U, TooltipEmits as a, TooltipPlacement as b, TooltipTrigger as c, UseTooltipReturn as d };