@qingmingmu/components 0.1.0-beta.0

package/es/shared/components.Bn206h5z.d.cts

@@ -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.cjs';
+
+/**
+ * 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.Bo3WVnTy.d.ts

@@ -0,0 +1,223 @@
+import { InjectionKey, Ref, PropType, defineComponent, reactive, computed, provide, openBlock, createElementBlock, normalizeClass, renderSlot, inject, onMounted, onBeforeUnmount, withKeys, withModifiers, createElementVNode, createBlock, toDisplayString, createCommentVNode } from 'vue';
+import { _ as _export_sfc } from './components.OJRSZE6i.js';
+import { a as Icon } from './components.C6sLxXPo.js';
+
+/**
+ * QmSteps 组件类型定义（导航 + 桌面端 task）
+ * 类型先行：步骤状态机（wait / process / finish / error）与方向。
+ */
+/** 步骤方向 */
+type StepsDirection = 'horizontal' | 'vertical';
+/** 当前步骤状态（steps.status 控制当前索引步骤的展示） */
+type StepStatus = 'wait' | 'process' | 'finish' | 'error';
+/** props 声明 */
+declare const stepsProps: {
+    /** 当前步骤索引（从 0 开始） */
+    readonly current: {
+        readonly type: NumberConstructor;
+        readonly default: 0;
+    };
+    /** 排列方向 */
+    readonly direction: {
+        readonly type: PropType<StepsDirection>;
+        readonly default: "horizontal";
+    };
+    /** 当前步骤状态（process 主色 / error 红色 / finish 对勾） */
+    readonly status: {
+        readonly type: PropType<StepStatus>;
+        readonly default: "process";
+    };
+};
+/** emits 声明 */
+interface StepsEmits {
+    /** 点击步骤时触发（携带步骤索引），由应用决定是否跳转 */
+    change: [current: number];
+}
+/** 步骤上下文（provide/inject 供 QmStep 消费） */
+interface StepsContext {
+    /** 当前步骤索引 */
+    current: Ref<number>;
+    /** 当前步骤状态 */
+    status: Ref<StepStatus>;
+    /** 排列方向 */
+    direction: Ref<StepsDirection>;
+    /** 已注册的子步骤 token 列表（推导 index / isLast） */
+    items: object[];
+    /** 注册子步骤，返回注销函数 */
+    register: (token: object) => () => void;
+    /** 点击步骤（父级统一 emit change） */
+    onStepClick: (index: number) => void;
+}
+/** 注入键 */
+declare const STEPS_CONTEXT_KEY: InjectionKey<StepsContext>;
+/** QmStep props（子组件独立声明，供类型推导） */
+declare const stepProps: {
+    /** 步骤标题 */
+    readonly title: {
+        readonly type: StringConstructor;
+        readonly default: "";
+    };
+    /** 步骤描述 */
+    readonly description: {
+        readonly type: StringConstructor;
+        readonly default: "";
+    };
+};
+
+var _sfc_main$1 = /* @__PURE__ */ defineComponent({
+  ...{ name: "QmSteps" },
+  __name: "steps",
+  props: stepsProps,
+  emits: ["change"],
+  setup(__props, { expose: __expose, emit: __emit }) {
+    __expose();
+    const props = __props;
+    const emit = __emit;
+    const items = reactive([]);
+    const context = {
+      current: computed(() => props.current),
+      status: computed(() => props.status),
+      direction: computed(() => props.direction),
+      items,
+      register: (token) => {
+        items.push(token);
+        return () => {
+          const index = items.indexOf(token);
+          if (index >= 0)
+            items.splice(index, 1);
+        };
+      },
+      onStepClick: (index) => {
+        if (index !== props.current)
+          emit("change", index);
+      }
+    };
+    provide(STEPS_CONTEXT_KEY, context);
+    const __returned__ = { props, emit, items, context };
+    Object.defineProperty(__returned__, "__isScriptSetup", { enumerable: false, value: true });
+    return __returned__;
+  }
+});
+
+function _sfc_render$1(_ctx, _cache, $props, $setup, $data, $options) {
+	return openBlock(), createElementBlock(
+		"div",
+		{
+			class: normalizeClass(["qm-steps", `qm-steps--${_ctx.direction}`]),
+			"data-qm": "steps"
+		},
+		[renderSlot(_ctx.$slots, "default")],
+		2
+		/* CLASS */
+	);
+}
+var Steps = /*#__PURE__*/ _export_sfc(_sfc_main$1, [["render", _sfc_render$1], ["__file", "F:\\软件开发\\青冥组件系统\\packages\\components\\src\\components\\steps\\steps.vue"]]);
+
+var _sfc_main = /* @__PURE__ */ defineComponent({
+  ...{ name: "QmStep" },
+  __name: "step",
+  props: stepProps,
+  setup(__props, { expose: __expose }) {
+    __expose();
+    const context = inject(STEPS_CONTEXT_KEY, void 0);
+    const token = {};
+    const index = computed(() => context?.items.indexOf(token) ?? -1);
+    const isLast = computed(() => context ? index.value === context.items.length - 1 : true);
+    const status = computed(() => {
+      if (!context)
+        return "wait";
+      if (index.value < context.current.value)
+        return "finish";
+      if (index.value === context.current.value)
+        return context.status.value;
+      return "wait";
+    });
+    let unregister;
+    onMounted(() => {
+      unregister = context?.register(token);
+    });
+    onBeforeUnmount(() => {
+      unregister?.();
+    });
+    function onClick() {
+      context?.onStepClick?.(index.value);
+    }
+    const __returned__ = { context, token, index, isLast, status, get unregister() {
+      return unregister;
+    }, set unregister(v) {
+      unregister = v;
+    }, onClick, get QmIcon() {
+      return Icon;
+    } };
+    Object.defineProperty(__returned__, "__isScriptSetup", { enumerable: false, value: true });
+    return __returned__;
+  }
+});
+
+const _hoisted_1 = [
+	"data-index",
+	"tabindex",
+	"role",
+	"onKeydown"
+];
+const _hoisted_2 = { class: "qm-step__header" };
+const _hoisted_3 = {
+	class: "qm-step__icon",
+	"aria-hidden": "true"
+};
+const _hoisted_4 = {
+	key: 2,
+	class: "qm-step__index"
+};
+const _hoisted_5 = { class: "qm-step__body" };
+const _hoisted_6 = { class: "qm-step__title" };
+const _hoisted_7 = {
+	key: 0,
+	class: "qm-step__description"
+};
+const _hoisted_8 = {
+	key: 0,
+	class: "qm-step__line",
+	"aria-hidden": "true"
+};
+function _sfc_render(_ctx, _cache, $props, $setup, $data, $options) {
+	return openBlock(), createElementBlock("div", {
+		class: normalizeClass(["qm-step", [`qm-step--${$setup.status}`, `qm-step--${$setup.context?.direction.value ?? "horizontal"}`]]),
+		"data-index": $setup.index >= 0 ? $setup.index : undefined,
+		"data-qm": "step",
+		tabindex: $setup.context ? 0 : -1,
+		role: $setup.context ? "button" : "listitem",
+		onClick: $setup.onClick,
+		onKeydown: [withKeys(withModifiers($setup.onClick, ["prevent"]), ["enter"]), withKeys(withModifiers($setup.onClick, ["prevent"]), ["space"])]
+	}, [createElementVNode("div", _hoisted_2, [createElementVNode("div", _hoisted_3, [renderSlot(_ctx.$slots, "icon", {}, () => [$setup.status === "finish" ? (openBlock(), createBlock($setup["QmIcon"], {
+		key: 0,
+		name: "check",
+		class: "qm-step__icon-icon"
+	})) : $setup.status === "error" ? (openBlock(), createBlock($setup["QmIcon"], {
+		key: 1,
+		name: "error",
+		class: "qm-step__icon-icon"
+	})) : (openBlock(), createElementBlock(
+		"span",
+		_hoisted_4,
+		toDisplayString($setup.index >= 0 ? $setup.index + 1 : ""),
+		1
+		/* TEXT */
+	))])]), createElementVNode("div", _hoisted_5, [createElementVNode(
+		"div",
+		_hoisted_6,
+		toDisplayString(_ctx.title),
+		1
+		/* TEXT */
+	), _ctx.description ? (openBlock(), createElementBlock(
+		"div",
+		_hoisted_7,
+		toDisplayString(_ctx.description),
+		1
+		/* TEXT */
+	)) : createCommentVNode("v-if", true)])]), !$setup.isLast ? (openBlock(), createElementBlock("div", _hoisted_8)) : createCommentVNode("v-if", true)], 42, _hoisted_1);
+}
+var step = /*#__PURE__*/ _export_sfc(_sfc_main, [["render", _sfc_render], ["__file", "F:\\软件开发\\青冥组件系统\\packages\\components\\src\\components\\steps\\step.vue"]]);
+
+export { Steps as S, STEPS_CONTEXT_KEY as a, stepProps as f, stepsProps as g, step as s };
+export type { StepStatus as b, StepsContext as c, StepsDirection as d, StepsEmits as e };