@qingmingmu/components 0.1.0-beta.0

package/es/shared/components.D5-DJd7f.d.cts

@@ -0,0 +1,328 @@
+import { Ref, ComputedRef, PropType, InjectionKey, defineComponent, computed, ref, watch, onMounted, resolveComponent, openBlock, createElementBlock, normalizeClass, createCommentVNode, createElementVNode, createBlock, Fragment, createVNode, renderSlot, createTextVNode, toDisplayString, provide } from 'vue';
+import { _ as _export_sfc } from './components.OJRSZE6i.cjs';
+
+/**
+ * QmCheckbox 组件类型定义（03-T7 §3.1：类型先行）
+ * 多选框 + 多选组：独立 boolean 受控 / 组内数组增删、半选态、最大可选数、键盘 Space 切换。
+ */
+
+/** 选项值（字符串 / 数字 / 布尔）；独立使用为 boolean，组内为具体值 */
+type CheckboxValue = string | number | boolean;
+/** 尺寸档位（与 Button 尺寸体系对齐，03-T1） */
+type CheckboxSize = 'small' | 'medium' | 'large';
+/** 组内布局方向 */
+type CheckboxGroupDirection = 'horizontal' | 'vertical';
+/** QmCheckbox props 声明 */
+declare const checkboxProps: {
+    /** 受控值：独立使用为 boolean；组内由 QmCheckboxGroup 接管（子项读组上下文） */
+    readonly modelValue: {
+        readonly type: PropType<boolean | CheckboxValue>;
+        readonly default: false;
+    };
+    /** 选项值（组模式下用于数组增删；独立使用时忽略） */
+    readonly value: {
+        readonly type: PropType<CheckboxValue | undefined>;
+        readonly default: undefined;
+    };
+    /** 禁用单项 */
+    readonly disabled: {
+        readonly type: BooleanConstructor;
+        readonly default: false;
+    };
+    /** 半选态（仅视觉横线图标，不影响 checked 值；aria-checked=mixed） */
+    readonly indeterminate: {
+        readonly type: BooleanConstructor;
+        readonly default: false;
+    };
+    /** 标签文案（缺省时用默认插槽） */
+    readonly label: {
+        readonly type: StringConstructor;
+        readonly default: "";
+    };
+    /** 尺寸（组内由 QmCheckboxGroup 覆盖） */
+    readonly size: {
+        readonly type: PropType<CheckboxSize>;
+        readonly default: "medium";
+    };
+};
+/** QmCheckbox emits 声明 */
+interface CheckboxEmits {
+    'update:modelValue': [value: boolean | CheckboxValue];
+    /** 选中态变化时触发（携带当前值） */
+    'change': [value: boolean | CheckboxValue];
+}
+/** QmCheckboxGroup props 声明 */
+declare const checkboxGroupProps: {
+    /** 受控值（v-model，数组） */
+    readonly modelValue: {
+        readonly type: PropType<CheckboxValue[]>;
+        readonly default: () => never[];
+    };
+    /** 整组禁用（子项仍可单项 disabled） */
+    readonly disabled: {
+        readonly type: BooleanConstructor;
+        readonly default: false;
+    };
+    /** 统一尺寸（覆盖子项 size） */
+    readonly size: {
+        readonly type: PropType<CheckboxSize>;
+        readonly default: "medium";
+    };
+    /** 布局方向 */
+    readonly direction: {
+        readonly type: PropType<CheckboxGroupDirection>;
+        readonly default: "horizontal";
+    };
+    /** 最大可选数（达到后未选项禁用，aria-disabled） */
+    readonly max: {
+        readonly type: NumberConstructor;
+        readonly default: undefined;
+    };
+};
+/** QmCheckboxGroup emits 声明 */
+interface CheckboxGroupEmits {
+    'update:modelValue': [value: CheckboxValue[]];
+    /** 组内选中变化时触发（携带最新数组） */
+    'change': [value: CheckboxValue[]];
+}
+/**
+ * 组上下文（provide/inject，03-T7 §4）
+ * 由 QmCheckboxGroup 注入，子 QmCheckbox 消费：组内数组增删、统一 disabled/size/max 守卫。
+ */
+interface CheckboxGroupContext {
+    /** 上下文标记（判别是否在组内） */
+    name: 'QmCheckboxGroup';
+    /** 组受控值（数组） */
+    modelValue: Ref<CheckboxValue[]>;
+    /** 整组禁用 */
+    disabled: ComputedRef<boolean>;
+    /** 统一尺寸 */
+    size: ComputedRef<CheckboxSize>;
+    /** 最大可选数 */
+    max: Ref<number | undefined>;
+    /** 当前选中数量（max 守卫派生） */
+    selectedCount: ComputedRef<number>;
+    /** 组内切换某 value（内部处理数组增删 + max 守卫 + emit；返回是否真正切换） */
+    toggleValue: (value: CheckboxValue) => boolean;
+}
+/** 组上下文 inject key */
+declare const checkboxGroupKey: InjectionKey<CheckboxGroupContext>;
+
+interface UseCheckboxOptions {
+    /** 受控值（props.modelValue） */
+    modelValue: Ref<boolean | CheckboxValue>;
+    /** 选项值（组模式下用于数组增删） */
+    value: Ref<CheckboxValue | undefined>;
+    /** 禁用单项 */
+    disabled: Ref<boolean>;
+    /** 半选态（仅视觉） */
+    indeterminate: Ref<boolean>;
+    /** 尺寸 */
+    size: Ref<CheckboxSize>;
+    emitUpdate: (value: boolean | CheckboxValue) => void;
+    emitChange: (value: boolean | CheckboxValue) => void;
+}
+interface UseCheckboxReturn {
+    /** 是否选中 */
+    isChecked: ComputedRef<boolean>;
+    /** 半选态（透传 prop，aria-checked=mixed） */
+    isIndeterminate: ComputedRef<boolean>;
+    /** aria-checked：true / false / mixed */
+    ariaChecked: ComputedRef<'true' | 'false' | 'mixed'>;
+    /** 单项或整组禁用（含 disabled prop / group.disabled） */
+    isDisabled: ComputedRef<boolean>;
+    /** max 守卫：组内达到 max 且当前未选 → true（aria-disabled） */
+    maxBlocked: ComputedRef<boolean>;
+    /** 实际禁用（isDisabled || maxBlocked），阻止切换 */
+    isEffectivelyDisabled: ComputedRef<boolean>;
+    /** 有效尺寸（组覆盖 > 自身 prop） */
+    effectiveSize: ComputedRef<CheckboxSize>;
+    /** 切换选中态；返回是否真正发生了切换（max/禁用守卫返回 false） */
+    toggle: () => boolean;
+    /** 原生 input change 入口（Space / 鼠标共用），守卫失败时复位原生 checked */
+    handleInputChange: (event: Event) => void;
+}
+/** 纯函数：组内数组是否包含某 value（严格相等） */
+declare function isValueInArray(arr: CheckboxValue[], value: CheckboxValue | undefined): boolean;
+/** 纯函数：max 守卫 —— 已选数 >= max 且当前未选 → 阻塞 */
+declare function isMaxBlocked(selectedCount: number, max: number | undefined, currentlyChecked: boolean): boolean;
+declare function useCheckbox(options: UseCheckboxOptions): UseCheckboxReturn;
+
+var _sfc_main$1 = /* @__PURE__ */ defineComponent({
+  ...{ name: "QmCheckbox" },
+  __name: "checkbox",
+  props: checkboxProps,
+  emits: ["update:modelValue", "change"],
+  setup(__props, { expose: __expose, emit: __emit }) {
+    __expose();
+    const props = __props;
+    const emit = __emit;
+    const modelValue = computed(() => props.modelValue);
+    const value = computed(() => props.value);
+    const disabled = computed(() => props.disabled);
+    const indeterminate = computed(() => props.indeterminate);
+    const size = computed(() => props.size);
+    const cb = useCheckbox({
+      modelValue,
+      value,
+      disabled,
+      indeterminate,
+      size,
+      emitUpdate: (v) => emit("update:modelValue", v),
+      emitChange: (v) => emit("change", v)
+    });
+    const {
+      isChecked,
+      isIndeterminate,
+      ariaChecked,
+      isDisabled,
+      maxBlocked,
+      effectiveSize,
+      handleInputChange
+    } = cb;
+    const rootClass = computed(() => ({
+      "qm-checkbox--checked": isChecked.value && !isIndeterminate.value,
+      "qm-checkbox--indeterminate": isIndeterminate.value,
+      "qm-checkbox--disabled": isDisabled.value,
+      "qm-checkbox--max-blocked": maxBlocked.value,
+      [`qm-checkbox--${effectiveSize.value}`]: true
+    }));
+    const inputRef = ref(null);
+    watch(
+      isIndeterminate,
+      (val) => {
+        if (inputRef.value)
+          inputRef.value.indeterminate = val;
+      },
+      { immediate: true }
+    );
+    onMounted(() => {
+      if (inputRef.value)
+        inputRef.value.indeterminate = isIndeterminate.value;
+    });
+    const __returned__ = { props, emit, modelValue, value, disabled, indeterminate, size, cb, isChecked, isIndeterminate, ariaChecked, isDisabled, maxBlocked, effectiveSize, handleInputChange, rootClass, inputRef };
+    Object.defineProperty(__returned__, "__isScriptSetup", { enumerable: false, value: true });
+    return __returned__;
+  }
+});
+
+const _hoisted_1$1 = [
+	"checked",
+	"disabled",
+	"aria-checked",
+	"aria-disabled"
+];
+const _hoisted_2 = {
+	class: "qm-checkbox__box",
+	"aria-hidden": "true"
+};
+const _hoisted_3 = { class: "qm-checkbox__label" };
+function _sfc_render$1(_ctx, _cache, $props, $setup, $data, $options) {
+	const _component_QmIcon = resolveComponent("QmIcon");
+	return openBlock(), createElementBlock(
+		"label",
+		{ class: normalizeClass(["qm-checkbox", $setup.rootClass]) },
+		[
+			createCommentVNode(" 原生 input（视觉隐藏，保留表单语义 + Space/点击） "),
+			createElementVNode("input", {
+				ref: "inputRef",
+				type: "checkbox",
+				class: "qm-checkbox__input",
+				checked: $setup.isChecked,
+				disabled: $setup.isDisabled,
+				"aria-checked": $setup.ariaChecked,
+				"aria-disabled": $setup.maxBlocked || undefined,
+				onChange: _cache[0] || (_cache[0] = (...args) => $setup.handleInputChange && $setup.handleInputChange(...args))
+			}, null, 40, _hoisted_1$1),
+			createCommentVNode(" 自定义方框（视觉） "),
+			createElementVNode("span", _hoisted_2, [createCommentVNode(" 选中对勾 "), $setup.isChecked && !$setup.isIndeterminate ? (openBlock(), createBlock(_component_QmIcon, {
+				key: 0,
+				name: "check",
+				class: "qm-checkbox__check"
+			})) : $setup.isIndeterminate ? (openBlock(), createElementBlock(
+				Fragment,
+				{ key: 1 },
+				[createCommentVNode(" 半选横线 "), createVNode(_component_QmIcon, {
+					name: "minus",
+					class: "qm-checkbox__check"
+				})],
+				2112
+				/* STABLE_FRAGMENT, DEV_ROOT_FRAGMENT */
+			)) : createCommentVNode("v-if", true)]),
+			createCommentVNode(" 标签 "),
+			createElementVNode("span", _hoisted_3, [renderSlot(_ctx.$slots, "default", {}, () => [createTextVNode(
+				toDisplayString(_ctx.label),
+				1
+				/* TEXT */
+			)])])
+		],
+		2
+		/* CLASS */
+	);
+}
+var Checkbox = /*#__PURE__*/ _export_sfc(_sfc_main$1, [["render", _sfc_render$1], ["__file", "F:\\软件开发\\青冥组件系统\\packages\\components\\src\\components\\checkbox\\checkbox.vue"]]);
+
+var _sfc_main = /* @__PURE__ */ defineComponent({
+  ...{ name: "QmCheckboxGroup" },
+  __name: "checkbox-group",
+  props: checkboxGroupProps,
+  emits: ["update:modelValue", "change"],
+  setup(__props, { expose: __expose, emit: __emit }) {
+    __expose();
+    const props = __props;
+    const emit = __emit;
+    const modelValue = computed(() => props.modelValue);
+    const disabled = computed(() => props.disabled);
+    const size = computed(() => props.size);
+    const max = computed(() => props.max);
+    const selectedCount = computed(() => props.modelValue.length);
+    function toggleValue(value) {
+      const cur = [...props.modelValue];
+      const idx = cur.indexOf(value);
+      if (idx >= 0) {
+        cur.splice(idx, 1);
+        emit("update:modelValue", cur);
+        emit("change", cur);
+        return true;
+      }
+      if (props.max !== void 0 && cur.length >= props.max) {
+        return false;
+      }
+      cur.push(value);
+      emit("update:modelValue", cur);
+      emit("change", cur);
+      return true;
+    }
+    const context = {
+      name: "QmCheckboxGroup",
+      modelValue,
+      disabled,
+      size,
+      max,
+      selectedCount,
+      toggleValue
+    };
+    provide(checkboxGroupKey, context);
+    const rootClass = computed(() => ({
+      "qm-checkbox-group--vertical": props.direction === "vertical",
+      "qm-checkbox-group--disabled": props.disabled
+    }));
+    const __returned__ = { props, emit, modelValue, disabled, size, max, selectedCount, toggleValue, context, 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(["qm-checkbox-group", $setup.rootClass]),
+		role: "group",
+		"aria-label": "多选组",
+		"aria-disabled": $setup.disabled || undefined
+	}, [renderSlot(_ctx.$slots, "default")], 10, _hoisted_1);
+}
+var checkboxGroup = /*#__PURE__*/ _export_sfc(_sfc_main, [["render", _sfc_render], ["__file", "F:\\软件开发\\青冥组件系统\\packages\\components\\src\\components\\checkbox\\checkbox-group.vue"]]);
+
+export { Checkbox as f, checkboxGroup as g, checkboxGroupKey as i, checkboxGroupProps as j, checkboxProps as k, isMaxBlocked as l, isValueInArray as m, useCheckbox as u };
+export type { CheckboxEmits as C, UseCheckboxOptions as U, CheckboxGroupContext as a, CheckboxGroupDirection as b, CheckboxGroupEmits as c, CheckboxSize as d, CheckboxValue as e, UseCheckboxReturn as h };

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

@@ -0,0 +1,67 @@
+import { PropType, defineComponent, computed, openBlock, createElementBlock, normalizeClass, renderSlot, createCommentVNode, createElementVNode } from 'vue';
+import { _ as _export_sfc } from './components.OJRSZE6i.mjs';
+
+/**
+ * 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 };

package/es/shared/components.D8Ht88FR.mjs

@@ -0,0 +1,100 @@
+import { defineComponent, openBlock, createElementBlock, createElementVNode, createVNode, createBlock } from 'vue';
+import { I as Icon } from './components.D3on6_fI.mjs';
+import { _ as _export_sfc } from './components.pcqpp-6-.mjs';
+
+const windowControlsProps = {
+  /** 最小化回调（undefined 时降级 Electron bridge，均无则静默空操作） */
+  onMinimize: { type: Function, default: void 0 },
+  /** 最大化/还原回调 */
+  onMaximize: { type: Function, default: void 0 },
+  /** 关闭回调 */
+  onClose: { type: Function, default: void 0 },
+  /** 是否已最大化（切换最大化/还原图标） */
+  maximized: { type: Boolean, default: false }
+};
+
+const _sfc_main = /* @__PURE__ */ defineComponent({
+  ...{ name: "QmWindowControls" },
+  __name: "window-controls",
+  props: windowControlsProps,
+  emits: ["minimize", "maximize", "close"],
+  setup(__props, { expose: __expose, emit: __emit }) {
+    __expose();
+    const props = __props;
+    const emit = __emit;
+    function getQingmingApi() {
+      if (typeof window === "undefined")
+        return void 0;
+      return window.qingmingAPI;
+    }
+    function invoke(action) {
+      const handlers = {
+        minimize: props.onMinimize,
+        maximize: props.onMaximize,
+        close: props.onClose
+      };
+      if (!handlers[action])
+        getQingmingApi()?.window?.[action]?.();
+      if (action === "minimize")
+        emit("minimize");
+      else if (action === "maximize")
+        emit("maximize");
+      else emit("close");
+    }
+    const __returned__ = { props, emit, getQingmingApi, invoke, get QmIcon() {
+      return Icon;
+    } };
+    Object.defineProperty(__returned__, "__isScriptSetup", { enumerable: false, value: true });
+    return __returned__;
+  }
+});
+
+const _hoisted_1 = {
+	class: "qm-window-controls",
+	"data-qm": "window-controls",
+	role: "group",
+	"aria-label": "窗口控制"
+};
+const _hoisted_2 = ["aria-label", "title"];
+function _sfc_render(_ctx, _cache, $props, $setup, $data, $options) {
+	return openBlock(), createElementBlock("div", _hoisted_1, [
+		createElementVNode("button", {
+			type: "button",
+			class: "qm-window-controls__button",
+			"aria-label": "最小化",
+			title: "最小化",
+			onClick: _cache[0] || (_cache[0] = ($event) => $setup.invoke("minimize"))
+		}, [createVNode($setup["QmIcon"], {
+			name: "minimize",
+			class: "qm-window-controls__icon"
+		})]),
+		createElementVNode("button", {
+			type: "button",
+			class: "qm-window-controls__button",
+			"aria-label": _ctx.maximized ? "还原" : "最大化",
+			title: _ctx.maximized ? "还原" : "最大化",
+			onClick: _cache[1] || (_cache[1] = ($event) => $setup.invoke("maximize"))
+		}, [!_ctx.maximized ? (openBlock(), createBlock($setup["QmIcon"], {
+			key: 0,
+			name: "maximize",
+			class: "qm-window-controls__icon"
+		})) : (openBlock(), createBlock($setup["QmIcon"], {
+			key: 1,
+			name: "minimize",
+			class: "qm-window-controls__icon"
+		}))], 8, _hoisted_2),
+		createElementVNode("button", {
+			type: "button",
+			class: "qm-window-controls__button qm-window-controls__button--close",
+			"aria-label": "关闭",
+			title: "关闭",
+			onClick: _cache[2] || (_cache[2] = ($event) => $setup.invoke("close"))
+		}, [createVNode($setup["QmIcon"], {
+			name: "close",
+			class: "qm-window-controls__icon"
+		})])
+	]);
+}
+const WindowControls = /*#__PURE__*/ _export_sfc(_sfc_main, [["render", _sfc_render], ["__file", "F:\\软件开发\\青冥组件系统\\packages\\components\\src\\components\\window-controls\\window-controls.vue"]]);
+
+export { WindowControls as W, windowControlsProps as w };