@qingmingmu/components 0.1.0-beta.0

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

@@ -0,0 +1,329 @@
+import { PropType, Ref, InjectionKey, ComputedRef, defineComponent, ref, toRef, computed, onMounted, openBlock, createElementBlock, normalizeClass, createCommentVNode, createElementVNode, renderSlot, createTextVNode, toDisplayString } from 'vue';
+import { _ as _export_sfc } from './components.OJRSZE6i.mjs';
+
+/**
+ * QmRadio / QmRadioGroup 组件类型定义（组件体系设计 §6.4：类型先行）
+ * 03-T6：单选框 + 单选组、三档尺寸、水平/垂直排列、禁用、键盘方向键导航、可访问性
+ */
+
+/** 选项值（字符串 / 数字 / 布尔） */
+type RadioValue = string | number | boolean;
+/** 尺寸（§6.3：尺寸枚举统一 small | medium | large） */
+type RadioSize = 'small' | 'medium' | 'large';
+/** 组排列方向 */
+type RadioDirection = 'horizontal' | 'vertical';
+/**
+ * ============================================================
+ *  QmRadio（单选项）props
+ * ============================================================
+ */
+declare const radioProps: {
+    /** 受控值：单独使用即自身选中态；组模式下由 QmRadioGroup 注入，勿直传 */
+    readonly modelValue: {
+        readonly type: PropType<RadioValue | undefined>;
+        readonly default: undefined;
+    };
+    /** 选项值（组模式下用于选中比对；必填） */
+    readonly value: {
+        readonly type: PropType<RadioValue>;
+        readonly required: true;
+    };
+    /** 禁用单项（整组禁用由 group.disabled 统一接管） */
+    readonly disabled: {
+        readonly type: BooleanConstructor;
+        readonly default: false;
+    };
+    /** 标签文案（缺省时回退默认插槽内容） */
+    readonly label: {
+        readonly type: StringConstructor;
+        readonly default: "";
+    };
+    /** 尺寸：缺省回退组 size，再回退 medium */
+    readonly size: {
+        readonly type: PropType<RadioSize | undefined>;
+        readonly default: undefined;
+    };
+    /** 原生 name：组模式下由 group 注入以共享浏览器原生单选行为 */
+    readonly name: {
+        readonly type: StringConstructor;
+        readonly default: "";
+    };
+};
+/** emits 声明 */
+interface RadioEmits {
+    'update:modelValue': [value: RadioValue];
+    /** 选中变化时触发（携带当前值） */
+    'change': [value: RadioValue];
+}
+/**
+ * ============================================================
+ *  QmRadioGroup（单选组）props
+ * ============================================================
+ */
+declare const radioGroupProps: {
+    /** 受控值（v-model）：选中项的 value */
+    readonly modelValue: {
+        readonly type: PropType<RadioValue | undefined>;
+        readonly default: undefined;
+    };
+    /** 整组禁用 */
+    readonly disabled: {
+        readonly type: BooleanConstructor;
+        readonly default: false;
+    };
+    /** 统一尺寸（子项未单独指定时回退到此） */
+    readonly size: {
+        readonly type: PropType<RadioSize>;
+        readonly default: "medium";
+    };
+    /** 排列方向 */
+    readonly direction: {
+        readonly type: PropType<RadioDirection>;
+        readonly default: "horizontal";
+    };
+    /** 原生 name：组内所有 QmRadio 共享，确保浏览器原生单选行为 */
+    readonly name: {
+        readonly type: StringConstructor;
+        readonly default: "";
+    };
+};
+/** emits 声明 */
+interface RadioGroupEmits {
+    'update:modelValue': [value: RadioValue];
+    /** 选中变化时触发（携带当前值） */
+    'change': [value: RadioValue];
+}
+
+/**
+ * useRadio / useRadioGroup 行为层（03-T6 §3 / §4）
+ *
+ * 职责（与视图解耦，可独立单测）：
+ * - 组上下文 provide/inject：modelValue / disabled / size / name 由组统一注入；
+ * - 选中态管理：组内 select 触发 update:modelValue + change；单独使用支持受控/非受控；
+ * - 键盘契约（无障碍规范 §12.2 / ARIA radio pattern）：
+ *   · roving tabindex——组内选中项 tabindex=0，其余 -1；
+ *   · ↑↓←→ 在组内循环移动选中并触发 change；Tab 进入组聚焦当前选中项；Space/Enter 选中；
+ * - 禁用守卫：整组禁用 / 单项禁用均拦截 select 与键盘移动；
+ * - 纯函数（findNextEnabledIndex / 方向键判定）独立导出，便于 jsdom 单测。
+ */
+
+interface RadioItem {
+    /** 选项值 */
+    value: RadioValue;
+    /** 单项禁用态（响应式） */
+    disabled: Ref<boolean>;
+    /** 根 label 元素（键盘导航时 focus() 落点） */
+    el: Ref<HTMLElement | null>;
+}
+/** 组上下文（group provide → item inject） */
+interface RadioGroupContext {
+    /** 当前选中值（响应式） */
+    modelValue: Ref<RadioValue | undefined>;
+    /** 整组禁用 */
+    disabled: Ref<boolean>;
+    /** 统一尺寸 */
+    size: Ref<RadioSize>;
+    /** 原生 name（组内共享，浏览器原生单选行为） */
+    name: Ref<string>;
+    /** 子项列表（按注册顺序） */
+    items: Ref<RadioItem[]>;
+    /** 选中某值（emit update:modelValue + change；禁用守卫） */
+    select: (value: RadioValue) => void;
+    /** 子项注册 / 注销 */
+    register: (item: RadioItem) => void;
+    unregister: (item: RadioItem) => void;
+    /** 组内键盘导航入口（item keydown 透传到组） */
+    onItemKeydown: (item: RadioItem, event: KeyboardEvent) => void;
+}
+/** provide/inject key */
+declare const RADIO_GROUP_KEY: InjectionKey<RadioGroupContext>;
+/**
+ * 在 items 中从 fromIndex 起按 delta 循环移动到下一个「非禁用」项，返回新索引。
+ * 全禁用 / 空列表返回 -1。
+ */
+declare function findNextEnabledIndex(items: RadioItem[], fromIndex: number, delta: number): number;
+/** 是否为「向后」方向键（Down / Right：索引 +1） */
+declare function isNextKey(key: string): boolean;
+/** 是否为「向前」方向键（Up / Left：索引 -1） */
+declare function isPrevKey(key: string): boolean;
+interface UseRadioGroupOptions {
+    modelValue: Ref<RadioValue | undefined>;
+    disabled: Ref<boolean>;
+    size: Ref<RadioSize>;
+    /** 原生 name */
+    name: Ref<string>;
+    emitUpdate: (value: RadioValue) => void;
+    emitChange: (value: RadioValue) => void;
+}
+declare function useRadioGroup(options: UseRadioGroupOptions): RadioGroupContext;
+interface UseRadioItemOptions {
+    value: Ref<RadioValue>;
+    disabled: Ref<boolean>;
+    size: Ref<RadioSize | undefined>;
+    name: Ref<string>;
+    /** 自身 modelValue（非组模式受控值；组模式下由组覆盖） */
+    modelValue: Ref<RadioValue | undefined>;
+    /** 根 label 元素 */
+    el: Ref<HTMLElement | null>;
+    emitUpdate: (value: RadioValue) => void;
+    emitChange: (value: RadioValue) => void;
+}
+interface UseRadioItemReturn {
+    /** 是否处于 QmRadioGroup 内 */
+    inGroup: ComputedRef<boolean>;
+    /** 是否选中（组内取组 modelValue，否则自身受控/非受控值） */
+    checked: ComputedRef<boolean>;
+    /** 实际生效禁用态（组禁用 OR 单项禁用） */
+    isDisabled: ComputedRef<boolean>;
+    /** 实际生效尺寸（单项 > 组 > medium） */
+    effectiveSize: ComputedRef<RadioSize>;
+    /** 实际生效原生 name（组内由组注入） */
+    effectiveName: ComputedRef<string>;
+    /** roving tabindex：组内选中项 0 其余 -1；非组内 0；禁用 -1 */
+    tabindex: ComputedRef<number>;
+    /** 选中（点击 / Space / Enter） */
+    check: () => void;
+    /** input keydown 透传（组内走组导航；Space/Enter 选中） */
+    onKeydown: (event: KeyboardEvent) => void;
+    /** 注册到组（onMounted 调用） */
+    registerSelf: () => void;
+}
+declare function useRadioItem(options: UseRadioItemOptions): UseRadioItemReturn;
+
+var _sfc_main$1 = /* @__PURE__ */ defineComponent({
+  ...{ name: "QmRadio" },
+  __name: "radio",
+  props: radioProps,
+  emits: ["update:modelValue", "change"],
+  setup(__props, { expose: __expose, emit: __emit }) {
+    __expose();
+    const props = __props;
+    const emit = __emit;
+    const rootRef = ref(null);
+    const inputRef = ref(null);
+    const item = useRadioItem({
+      value: toRef(props, "value"),
+      disabled: toRef(props, "disabled"),
+      size: toRef(props, "size"),
+      name: toRef(props, "name"),
+      modelValue: toRef(props, "modelValue"),
+      el: rootRef,
+      emitUpdate: (value) => emit("update:modelValue", value),
+      emitChange: (value) => emit("change", value)
+    });
+    const { checked, isDisabled, effectiveSize, effectiveName, tabindex, check, onKeydown } = item;
+    const rootClass = computed(() => [
+      "qm-radio",
+      `qm-radio--${effectiveSize.value}`,
+      {
+        "qm-radio--checked": checked.value,
+        "qm-radio--disabled": isDisabled.value
+      }
+    ]);
+    function onChange() {
+      check();
+    }
+    onMounted(() => {
+      item.registerSelf();
+    });
+    const __returned__ = { props, emit, rootRef, inputRef, item, checked, isDisabled, effectiveSize, effectiveName, tabindex, check, onKeydown, rootClass, onChange };
+    Object.defineProperty(__returned__, "__isScriptSetup", { enumerable: false, value: true });
+    return __returned__;
+  }
+});
+
+const _hoisted_1$1 = [
+	"name",
+	"value",
+	"checked",
+	"disabled",
+	"tabindex",
+	"aria-checked"
+];
+const _hoisted_2 = { class: "qm-radio__label" };
+function _sfc_render$1(_ctx, _cache, $props, $setup, $data, $options) {
+	return openBlock(), createElementBlock(
+		"label",
+		{
+			ref: "rootRef",
+			class: normalizeClass($setup.rootClass)
+		},
+		[
+			createCommentVNode(" 原生 radio：视觉隐藏但覆盖整个 label，保留聚焦/点击/键盘可访问性 "),
+			createElementVNode("input", {
+				ref: "inputRef",
+				class: "qm-radio__original",
+				type: "radio",
+				name: $setup.effectiveName,
+				value: _ctx.value,
+				checked: $setup.checked,
+				disabled: $setup.isDisabled,
+				tabindex: $setup.tabindex,
+				"aria-checked": $setup.checked,
+				onChange: $setup.onChange,
+				onKeydown: _cache[0] || (_cache[0] = (...args) => $setup.onKeydown && $setup.onKeydown(...args))
+			}, null, 40, _hoisted_1$1),
+			createCommentVNode(" 自定义圆点（视觉层，aria-hidden 避免与原生 input 语义重复；选中态纯色填满） "),
+			_cache[1] || (_cache[1] = createElementVNode(
+				"span",
+				{
+					class: "qm-radio__dot",
+					"aria-hidden": "true"
+				},
+				null,
+				-1
+				/* CACHED */
+			)),
+			createCommentVNode(" 文案 "),
+			createElementVNode("span", _hoisted_2, [renderSlot(_ctx.$slots, "default", {}, () => [createTextVNode(
+				toDisplayString(_ctx.label),
+				1
+				/* TEXT */
+			)])])
+		],
+		2
+		/* CLASS */
+	);
+}
+var Radio = /*#__PURE__*/ _export_sfc(_sfc_main$1, [["render", _sfc_render$1], ["__file", "F:\\软件开发\\青冥组件系统\\packages\\components\\src\\components\\radio\\radio.vue"]]);
+
+var _sfc_main = /* @__PURE__ */ defineComponent({
+  ...{ name: "QmRadioGroup" },
+  __name: "radio-group",
+  props: radioGroupProps,
+  emits: ["update:modelValue", "change"],
+  setup(__props, { expose: __expose, emit: __emit }) {
+    __expose();
+    const props = __props;
+    const emit = __emit;
+    useRadioGroup({
+      modelValue: toRef(props, "modelValue"),
+      disabled: toRef(props, "disabled"),
+      size: toRef(props, "size"),
+      name: toRef(props, "name"),
+      emitUpdate: (value) => emit("update:modelValue", value),
+      emitChange: (value) => emit("change", value)
+    });
+    const rootClass = computed(() => [
+      "qm-radio-group",
+      `qm-radio-group--${props.direction}`,
+      { "qm-radio-group--disabled": props.disabled }
+    ]);
+    const __returned__ = { props, emit, rootClass };
+    Object.defineProperty(__returned__, "__isScriptSetup", { enumerable: false, value: true });
+    return __returned__;
+  }
+});
+
+const _hoisted_1 = ["aria-disabled"];
+function _sfc_render(_ctx, _cache, $props, $setup, $data, $options) {
+	return openBlock(), createElementBlock("div", {
+		class: normalizeClass($setup.rootClass),
+		role: "radiogroup",
+		"aria-disabled": _ctx.disabled || undefined
+	}, [renderSlot(_ctx.$slots, "default")], 10, _hoisted_1);
+}
+var radioGroup = /*#__PURE__*/ _export_sfc(_sfc_main, [["render", _sfc_render], ["__file", "F:\\软件开发\\青冥组件系统\\packages\\components\\src\\components\\radio\\radio-group.vue"]]);
+
+export { Radio as R, RADIO_GROUP_KEY as a, findNextEnabledIndex as k, isNextKey as l, isPrevKey as m, radioGroupProps as n, radioProps as o, useRadioItem as p, radioGroup as r, useRadioGroup as u };
+export type { UseRadioGroupOptions as U, RadioDirection as b, RadioEmits as c, RadioGroupContext as d, RadioGroupEmits as e, RadioItem as f, RadioSize as g, RadioValue as h, UseRadioItemOptions as i, UseRadioItemReturn as j };

package/es/shared/components.dk3Zmpq5.cjs

@@ -0,0 +1,61 @@
+'use strict';
+
+const vue = require('vue');
+const exportHelper = require('./components.DUidQ77e.cjs');
+
+const spaceProps = {
+  /** 排列方向：horizontal / vertical */
+  direction: { type: String, default: "horizontal" },
+  /** 间距：small / medium / large（消费分档 Token）；number 自定义（px） */
+  size: { type: [String, Number], default: "medium" },
+  /** 自动换行（换行后行距走 --qm-space-wrap-gap） */
+  wrap: { type: Boolean, default: false },
+  /** 垂直对齐：start / end / center / baseline */
+  align: { type: String, default: "center" },
+  /** 填满：子元素 flex: 1 均分 */
+  fill: { type: Boolean, default: false }
+};
+
+const _sfc_main = /* @__PURE__ */ vue.defineComponent({
+  ...{ name: "QmSpace" },
+  __name: "space",
+  props: spaceProps,
+  setup(__props, { expose: __expose }) {
+    __expose();
+    const props = __props;
+    const enumSize = vue.computed(
+      () => props.size === "small" || props.size === "medium" || props.size === "large" ? props.size : null
+    );
+    const modifierClass = vue.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 = vue.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 vue.openBlock(), vue.createElementBlock(
+		"div",
+		{
+			class: vue.normalizeClass(["qm-space", $setup.modifierClass]),
+			style: vue.normalizeStyle($setup.rootStyle),
+			"data-qm": "space"
+		},
+		[vue.renderSlot(_ctx.$slots, "default")],
+		6
+		/* CLASS, STYLE */
+	);
+}
+const Space = /*#__PURE__*/ exportHelper._export_sfc(_sfc_main, [["render", _sfc_render], ["__file", "F:\\软件开发\\青冥组件系统\\packages\\components\\src\\components\\space\\space.vue"]]);
+
+exports.Space = Space;
+exports.spaceProps = spaceProps;