@qingmingmu/components 0.1.0-beta.0

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

@@ -0,0 +1,159 @@
+import { InjectionKey, ComputedRef, defineComponent, reactive, computed, provide, openBlock, createElementBlock, createElementVNode, renderSlot, inject, onMounted, onBeforeUnmount, normalizeClass, toDisplayString, createCommentVNode, withModifiers } from 'vue';
+import { _ as _export_sfc } from './components.OJRSZE6i.js';
+
+/**
+ * QmBreadcrumb 组件类型定义（导航 + 桌面端 task）
+ * 类型先行：面包屑为纯展示导航，主组件仅暴露分隔符配置。
+ */
+/** props 声明 */
+declare const breadcrumbProps: {
+    /** 分隔符（渲染在项之间） */
+    readonly separator: {
+        readonly type: StringConstructor;
+        readonly default: "/";
+    };
+};
+/** 面包屑上下文（provide/inject 供 QmBreadcrumbItem 消费：分隔符 + 子项收集） */
+interface BreadcrumbContext {
+    /** 分隔符内容 */
+    separator: ComputedRef<string>;
+    /** 已注册的子项 token 列表（用于推导是否为最后一项） */
+    items: object[];
+    /** 注册子项，返回注销函数 */
+    register: (token: object) => () => void;
+}
+/** 注入键 */
+declare const BREADCRUMB_CONTEXT_KEY: InjectionKey<BreadcrumbContext>;
+/** QmBreadcrumbItem props（子组件独立声明，供类型推导） */
+declare const breadcrumbItemProps: {
+    /** 路由地址（点击 emit select 并阻止默认跳转，由应用接管路由） */
+    readonly to: {
+        readonly type: StringConstructor;
+        readonly default: undefined;
+    };
+    /** 普通链接地址（原生锚点跳转） */
+    readonly href: {
+        readonly type: StringConstructor;
+        readonly default: undefined;
+    };
+};
+/** QmBreadcrumbItem emits */
+interface BreadcrumbItemEmits {
+    /** 点击带 to 的非最后一项时触发，携带 to 值 */
+    select: [to: string];
+}
+
+var _sfc_main$1 = /* @__PURE__ */ defineComponent({
+  ...{ name: "QmBreadcrumb" },
+  __name: "breadcrumb",
+  props: breadcrumbProps,
+  setup(__props, { expose: __expose }) {
+    __expose();
+    const props = __props;
+    const items = reactive([]);
+    const context = {
+      separator: computed(() => props.separator),
+      items,
+      register: (token) => {
+        items.push(token);
+        return () => {
+          const index = items.indexOf(token);
+          if (index >= 0) items.splice(index, 1);
+        };
+      }
+    };
+    provide(BREADCRUMB_CONTEXT_KEY, context);
+    const __returned__ = { props, items, context };
+    Object.defineProperty(__returned__, "__isScriptSetup", { enumerable: false, value: true });
+    return __returned__;
+  }
+});
+
+const _hoisted_1$1 = {
+	class: "qm-breadcrumb",
+	"data-qm": "breadcrumb",
+	"aria-label": "面包屑"
+};
+const _hoisted_2$1 = { class: "qm-breadcrumb__list" };
+function _sfc_render$1(_ctx, _cache, $props, $setup, $data, $options) {
+	return openBlock(), createElementBlock("nav", _hoisted_1$1, [createElementVNode("ol", _hoisted_2$1, [renderSlot(_ctx.$slots, "default")])]);
+}
+var Breadcrumb = /*#__PURE__*/ _export_sfc(_sfc_main$1, [["render", _sfc_render$1], ["__file", "F:\\软件开发\\青冥组件系统\\packages\\components\\src\\components\\breadcrumb\\breadcrumb.vue"]]);
+
+var _sfc_main = /* @__PURE__ */ defineComponent({
+  ...{ name: "QmBreadcrumbItem" },
+  __name: "breadcrumb-item",
+  props: breadcrumbItemProps,
+  emits: ["select"],
+  setup(__props, { expose: __expose, emit: __emit }) {
+    __expose();
+    const props = __props;
+    const emit = __emit;
+    const context = inject(BREADCRUMB_CONTEXT_KEY, void 0);
+    const token = {};
+    const index = computed(() => context?.items.indexOf(token) ?? -1);
+    const isFirst = computed(() => index.value === 0);
+    const isLast = computed(() => context ? index.value === context.items.length - 1 : false);
+    let unregister;
+    onMounted(() => {
+      unregister = context?.register(token);
+    });
+    onBeforeUnmount(() => {
+      unregister?.();
+    });
+    function onClickTo() {
+      if (props.to) emit("select", props.to);
+    }
+    const __returned__ = { props, emit, context, token, index, isFirst, isLast, get unregister() {
+      return unregister;
+    }, set unregister(v) {
+      unregister = v;
+    }, onClickTo };
+    Object.defineProperty(__returned__, "__isScriptSetup", { enumerable: false, value: true });
+    return __returned__;
+  }
+});
+
+const _hoisted_1 = {
+	key: 0,
+	class: "qm-breadcrumb__separator",
+	"aria-hidden": "true"
+};
+const _hoisted_2 = ["href"];
+const _hoisted_3 = ["href"];
+const _hoisted_4 = ["aria-current"];
+function _sfc_render(_ctx, _cache, $props, $setup, $data, $options) {
+	return openBlock(), createElementBlock(
+		"li",
+		{
+			class: normalizeClass(["qm-breadcrumb-item", { "qm-breadcrumb-item--last": $setup.isLast }]),
+			"data-qm": "breadcrumb-item"
+		},
+		[!$setup.isFirst ? (openBlock(), createElementBlock(
+			"span",
+			_hoisted_1,
+			toDisplayString($setup.context?.separator.value),
+			1
+			/* TEXT */
+		)) : createCommentVNode("v-if", true), !$setup.isLast && _ctx.href ? (openBlock(), createElementBlock("a", {
+			key: 1,
+			class: "qm-breadcrumb__link",
+			href: _ctx.href
+		}, [renderSlot(_ctx.$slots, "default")], 8, _hoisted_2)) : !$setup.isLast && _ctx.to ? (openBlock(), createElementBlock("a", {
+			key: 2,
+			class: "qm-breadcrumb__link",
+			href: _ctx.to,
+			onClick: withModifiers($setup.onClickTo, ["prevent"])
+		}, [renderSlot(_ctx.$slots, "default")], 8, _hoisted_3)) : (openBlock(), createElementBlock("span", {
+			key: 3,
+			class: "qm-breadcrumb__current",
+			"aria-current": $setup.isLast ? "page" : undefined
+		}, [renderSlot(_ctx.$slots, "default")], 8, _hoisted_4))],
+		2
+		/* CLASS */
+	);
+}
+var breadcrumbItem = /*#__PURE__*/ _export_sfc(_sfc_main, [["render", _sfc_render], ["__file", "F:\\软件开发\\青冥组件系统\\packages\\components\\src\\components\\breadcrumb\\breadcrumb-item.vue"]]);
+
+export { BREADCRUMB_CONTEXT_KEY as B, Breadcrumb as c, breadcrumbItem as d, breadcrumbItemProps as e, breadcrumbProps as f };
+export type { BreadcrumbContext as a, BreadcrumbItemEmits as b };

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

@@ -0,0 +1,192 @@
+import { PropType, Ref, ComputedRef, defineComponent, toRef, computed, openBlock, createElementBlock, normalizeClass, toDisplayString, createCommentVNode, createElementVNode, createVNode } from 'vue';
+import { a as Icon } from './components.b5GjJzDh.cjs';
+import { _ as _export_sfc } from './components.OJRSZE6i.cjs';
+
+/**
+ * QmSwitch 组件类型定义（组件体系设计 §6.4：类型先行）
+ * 03-T8：开关切换、三档尺寸、禁用、加载态、自定义文字、自定义值、键盘导航
+ */
+
+/** 开关尺寸（§6.3：尺寸枚举统一 small | medium | large） */
+type SwitchSize = 'small' | 'medium' | 'large';
+/** 开关值：boolean / string / number（自定义值通过 activeValue/inactiveValue 映射） */
+type SwitchValue = string | number | boolean;
+/** props 声明（纯类型 + 默认值，供 SFC 与命令式 API 复用） */
+declare const switchProps: {
+    /** 受控值（v-model）；未传即非受控（组件内自维护） */
+    readonly modelValue: {
+        readonly type: PropType<SwitchValue>;
+        readonly default: false;
+    };
+    /** 禁用态：视觉 + 行为（不可点击/键盘），aria-disabled */
+    readonly disabled: {
+        readonly type: BooleanConstructor;
+        readonly default: false;
+    };
+    /** 加载态：禁用点击 + 滑块内旋转图标（SVG currentColor）+ aria-busy="true" */
+    readonly loading: {
+        readonly type: BooleanConstructor;
+        readonly default: false;
+    };
+    /** 尺寸：small / medium / large */
+    readonly size: {
+        readonly type: PropType<SwitchSize>;
+        readonly default: "medium";
+    };
+    /** 开启态文字（轨道内，随状态切换显示） */
+    readonly activeText: {
+        readonly type: StringConstructor;
+        readonly default: "";
+    };
+    /** 关闭态文字（轨道内，随状态切换显示） */
+    readonly inactiveText: {
+        readonly type: StringConstructor;
+        readonly default: "";
+    };
+    /** 开启时的值（默认 true；支持 string/number/boolean 自定义值） */
+    readonly activeValue: {
+        readonly type: PropType<SwitchValue>;
+        readonly default: true;
+    };
+    /** 关闭时的值（默认 false；支持 string/number/boolean 自定义值） */
+    readonly inactiveValue: {
+        readonly type: PropType<SwitchValue>;
+        readonly default: false;
+    };
+};
+/** emits 声明 */
+interface SwitchEmits {
+    /** 值同步（v-model） */
+    'update:modelValue': [value: SwitchValue];
+    /** 切换时触发（携带当前值，为 activeValue 或 inactiveValue） */
+    'change': [value: SwitchValue];
+}
+
+/**
+ * useSwitch 行为层（03-T8 §3.2 / §4）
+ *
+ * 职责（与视图解耦，可独立单测）：
+ * - 开启/关闭状态派生（当前值 === activeValue）；
+ * - 双模式：内部状态即时反馈 + 外部 modelValue 变更同步（受控/非受控统一）；
+ * - 切换逻辑 + 禁用/加载守卫（disabled 或 loading 时不切换）；
+ * - 值映射：emit 的是 activeValue / inactiveValue 而非固定 boolean；
+ * - 键盘契约（WAI-ARIA switch 模式）：Space / Enter 切换。
+ */
+
+interface UseSwitchOptions {
+    /** 受控值（props.modelValue） */
+    modelValue: Ref<SwitchValue>;
+    /** 禁用 */
+    disabled: Ref<boolean>;
+    /** 加载态（与 disabled 同等守卫：不可切换） */
+    loading: Ref<boolean>;
+    /** 开启时的值 */
+    activeValue: Ref<SwitchValue>;
+    /** 关闭时的值 */
+    inactiveValue: Ref<SwitchValue>;
+    emitUpdate: (value: SwitchValue) => void;
+    emitChange: (value: SwitchValue) => void;
+}
+interface UseSwitchReturn {
+    /** 是否开启（当前值 === activeValue） */
+    checked: ComputedRef<boolean>;
+    /** 是否可交互（!disabled && !loading） */
+    interactive: ComputedRef<boolean>;
+    /** 切换：开启↔关闭，emit 对应 activeValue / inactiveValue */
+    toggle: () => void;
+    /** 键盘：Space / Enter 切换（preventDefault 避免 Space 滚动页面） */
+    handleKeydown: (event: KeyboardEvent) => void;
+}
+declare function useSwitch(options: UseSwitchOptions): UseSwitchReturn;
+
+var _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);
+}
+var 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 };
+export type { UseSwitchOptions as U, SwitchEmits as a, SwitchSize as b, SwitchValue as c, UseSwitchReturn as d };

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

@@ -0,0 +1,67 @@
+import { PropType, defineComponent, computed, openBlock, createElementBlock, normalizeClass, renderSlot, createCommentVNode, createElementVNode } from 'vue';
+import { _ as _export_sfc } from './components.OJRSZE6i.cjs';
+
+/**
+ * QmLayout 组件类型定义（组件体系设计 §6.4：类型先行）
+ * 布局-01：页面容器骨架；具名插槽 header / sider / footer / default(content)。
+ */
+
+/** 布局方向：horizontal 侧栏在左；vertical 整体纵向堆叠（侧栏变为顶部横条） */
+type LayoutDirection = 'horizontal' | 'vertical';
+/** props 声明（纯类型 + 默认值，供 SFC 与文档复用） */
+declare const layoutProps: {
+    /** 排列方向：horizontal（侧栏+主体）/ vertical（纵向堆叠） */
+    readonly direction: {
+        readonly type: PropType<LayoutDirection>;
+        readonly default: "horizontal";
+    };
+};
+
+var _sfc_main = /* @__PURE__ */ defineComponent({
+  ...{ name: "QmLayout" },
+  __name: "layout",
+  props: layoutProps,
+  setup(__props, { expose: __expose }) {
+    __expose();
+    const props = __props;
+    const directionClass = computed(() => `qm-layout--${props.direction}`);
+    const __returned__ = { props, directionClass };
+    Object.defineProperty(__returned__, "__isScriptSetup", { enumerable: false, value: true });
+    return __returned__;
+  }
+});
+
+const _hoisted_1 = {
+	key: 0,
+	class: "qm-layout__sider"
+};
+const _hoisted_2 = { class: "qm-layout__body" };
+const _hoisted_3 = {
+	key: 0,
+	class: "qm-layout__header"
+};
+const _hoisted_4 = { class: "qm-layout__content" };
+const _hoisted_5 = {
+	key: 1,
+	class: "qm-layout__footer"
+};
+function _sfc_render(_ctx, _cache, $props, $setup, $data, $options) {
+	return openBlock(), createElementBlock(
+		"div",
+		{
+			class: normalizeClass(["qm-layout", $setup.directionClass]),
+			"data-qm": "layout"
+		},
+		[_ctx.$slots.sider ? (openBlock(), createElementBlock("aside", _hoisted_1, [renderSlot(_ctx.$slots, "sider")])) : createCommentVNode("v-if", true), createElementVNode("div", _hoisted_2, [
+			_ctx.$slots.header ? (openBlock(), createElementBlock("header", _hoisted_3, [renderSlot(_ctx.$slots, "header")])) : createCommentVNode("v-if", true),
+			createElementVNode("main", _hoisted_4, [renderSlot(_ctx.$slots, "default")]),
+			_ctx.$slots.footer ? (openBlock(), createElementBlock("footer", _hoisted_5, [renderSlot(_ctx.$slots, "footer")])) : createCommentVNode("v-if", true)
+		])],
+		2
+		/* CLASS */
+	);
+}
+var Layout = /*#__PURE__*/ _export_sfc(_sfc_main, [["render", _sfc_render], ["__file", "F:\\软件开发\\青冥组件系统\\packages\\components\\src\\components\\layout\\layout.vue"]]);
+
+export { Layout as a, layoutProps as l };
+export type { LayoutDirection as L };