@qingmingmu/components 0.1.0-beta.0

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

@@ -0,0 +1,298 @@
+import { PropType, Ref, ComputedRef, defineComponent, useAttrs, ref, computed, onMounted, nextTick, openBlock, createElementBlock, normalizeClass, createCommentVNode, renderSlot, createElementVNode, mergeProps, toDisplayString, withModifiers, createVNode } from 'vue';
+import { a as Icon } from './components.b5GjJzDh.cjs';
+import { _ as _export_sfc } from './components.OJRSZE6i.cjs';
+
+/**
+ * QmInput 组件类型定义（组件体系设计 §6.4：类型先行）
+ * 03-T5：多类型 / 三档尺寸 / 禁用只读 / 可清除 / 字数统计 / 前后缀插槽
+ */
+
+/** 原生 input type（限定为文本类，日期/文件等由专用组件承担） */
+type InputType = 'text' | 'password' | 'number' | 'email' | 'tel' | 'url' | 'search';
+/** 组件尺寸（§6.3：尺寸枚举统一 small | medium | large） */
+type InputSize = 'small' | 'medium' | 'large';
+/** props 声明（纯类型 + 默认值，供 SFC 与命令式 API 复用） */
+declare const inputProps: {
+    /** 受控值（v-model）；未监听即非受控，组件内自维护本地值 */
+    readonly modelValue: {
+        readonly type: StringConstructor;
+        readonly default: "";
+    };
+    /** 原生 input type */
+    readonly type: {
+        readonly type: PropType<InputType>;
+        readonly default: "text";
+    };
+    /** 尺寸：small / medium / large */
+    readonly size: {
+        readonly type: PropType<InputSize>;
+        readonly default: "medium";
+    };
+    /** 禁用态：视觉 + 行为（不可输入、不响应清除） */
+    readonly disabled: {
+        readonly type: BooleanConstructor;
+        readonly default: false;
+    };
+    /** 只读：可聚焦不可编辑，仍触发 focus/blur */
+    readonly readonly: {
+        readonly type: BooleanConstructor;
+        readonly default: false;
+    };
+    /** 可清除：有值且非禁用/只读时显示清除按钮 */
+    readonly clearable: {
+        readonly type: BooleanConstructor;
+        readonly default: false;
+    };
+    /** 占位文案 */
+    readonly placeholder: {
+        readonly type: StringConstructor;
+        readonly default: "";
+    };
+    /** 最大输入长度（原生 maxlength + 行为层截断双保险） */
+    readonly maxlength: {
+        readonly type: NumberConstructor;
+        readonly default: undefined;
+    };
+    /** 字数统计（配合 maxlength 显示 当前/最大） */
+    readonly showCount: {
+        readonly type: BooleanConstructor;
+        readonly default: false;
+    };
+    /** 原生 autocomplete 透传 */
+    readonly autocomplete: {
+        readonly type: StringConstructor;
+        readonly default: "off";
+    };
+    /** 原生 autofocus 透传 */
+    readonly autofocus: {
+        readonly type: BooleanConstructor;
+        readonly default: false;
+    };
+};
+/** emits 声明（change 契约：失焦或 Enter 时触发，区别于每次按键的 input） */
+interface InputEmits {
+    /** 受控值同步 */
+    'update:modelValue': [value: string];
+    /** 输入时触发（每次按键，携带最新值与原生事件） */
+    'input': [value: string, event: Event];
+    /** 失焦或按下 Enter 时触发（值定型） */
+    'change': [value: string, event: Event];
+    'focus': [event: FocusEvent];
+    'blur': [event: FocusEvent];
+    /** 点击清除按钮时触发 */
+    'clear': [];
+}
+
+/**
+ * useInput 行为层（03-T5）
+ *
+ * 职责（与视图解耦，可独立单测）：
+ * - 受控/非受控值同步：外部 modelValue 变化回灌本地原生值；输入时回写父级；
+ * - maxlength 截断纯函数（行为层双保险，即便原生 maxlength 在某些输入法下不生效）；
+ * - 字数统计纯函数（当前长度 / maxlength 文案派生）；
+ * - focus/blur 状态、clear 行为、change 契约（失焦或 Enter 时值定型触发）。
+ */
+
+interface UseInputOptions {
+    /** 受控值（props.modelValue） */
+    modelValue: Ref<string>;
+    /** 禁用 */
+    disabled: Ref<boolean>;
+    /** 只读 */
+    readonly: Ref<boolean>;
+    /** 最大长度 */
+    maxlength: Ref<number | undefined>;
+    emitUpdate: (value: string) => void;
+    emitInput: (value: string, event: Event) => void;
+    emitChange: (value: string, event: Event) => void;
+    emitFocus: (event: FocusEvent) => void;
+    emitBlur: (event: FocusEvent) => void;
+    emitClear: () => void;
+}
+interface UseInputReturn {
+    /** 原生 input 展示值（受控同步 + 非受控本地维护） */
+    nativeValue: Ref<string>;
+    /** 聚焦态（驱动 wrapper 高亮类） */
+    focused: Ref<boolean>;
+    /** 是否有值（清除按钮 / 占位判定） */
+    hasValue: ComputedRef<boolean>;
+    /** 字数统计文案（showCount 时展示，无 maxlength 时仅当前长度） */
+    countText: ComputedRef<string>;
+    /** 是否可显示清除按钮 */
+    showClear: ComputedRef<boolean>;
+    /** 输入事件入口（截断 → 本地值 → 回写 → input 事件） */
+    handleInput: (event: Event) => void;
+    handleFocus: (event: FocusEvent) => void;
+    handleBlur: (event: FocusEvent) => void;
+    /** 键盘：Enter 触发 change 值定型 */
+    handleKeydown: (event: KeyboardEvent) => void;
+    /** 清除（置空 + emit clear + update） */
+    clear: () => void;
+}
+/**
+ * maxlength 截断纯函数（用例：输入法组合态/粘贴超长按最大长度截断）。
+ * 无 maxlength 或非正数时原样返回。
+ */
+declare function clampByMaxlength(value: string, maxlength: number | undefined): string;
+/** 字数统计纯函数：无 maxlength → 仅当前长度；有 → `当前/最大` */
+declare function formatCount(value: string, maxlength: number | undefined): string;
+declare function useInput(options: UseInputOptions): UseInputReturn;
+
+var _sfc_main = /* @__PURE__ */ defineComponent({
+  ...{ name: "QmInput", inheritAttrs: false },
+  __name: "input",
+  props: inputProps,
+  emits: ["update:modelValue", "input", "change", "focus", "blur", "clear"],
+  setup(__props, { expose: __expose, emit: __emit }) {
+    const props = __props;
+    const emit = __emit;
+    const attrs = useAttrs();
+    const rootRef = ref(null);
+    const inputRef = ref(null);
+    const modelValue = computed(() => props.modelValue);
+    const disabled = computed(() => props.disabled);
+    const readonly = computed(() => props.readonly);
+    const maxlength = computed(() => props.maxlength);
+    const {
+      nativeValue,
+      focused,
+      countText,
+      showClear,
+      handleInput,
+      handleFocus,
+      handleBlur,
+      handleKeydown,
+      clear
+    } = useInput({
+      modelValue,
+      disabled,
+      readonly,
+      maxlength,
+      emitUpdate: (value) => emit("update:modelValue", value),
+      emitInput: (value, event) => emit("input", value, event),
+      emitChange: (value, event) => emit("change", value, event),
+      emitFocus: (event) => emit("focus", event),
+      emitBlur: (event) => emit("blur", event),
+      emitClear: () => emit("clear")
+    });
+    const rootClass = computed(() => [
+      "qm-input",
+      `qm-input--${props.size}`,
+      {
+        "qm-input--disabled": disabled.value,
+        "qm-input--focused": focused.value
+      }
+    ]);
+    function onClearClick() {
+      clear();
+      nextTick(() => inputRef.value?.focus());
+    }
+    function focus() {
+      inputRef.value?.focus();
+    }
+    function blur() {
+      inputRef.value?.blur();
+    }
+    onMounted(() => {
+      if (props.autofocus)
+        focus();
+    });
+    const ariaLabel = computed(() => attrs["aria-label"] || props.placeholder || void 0);
+    __expose({ focus, blur, rootRef, inputRef });
+    const __returned__ = { props, emit, attrs, rootRef, inputRef, modelValue, disabled, readonly, maxlength, nativeValue, focused, countText, showClear, handleInput, handleFocus, handleBlur, handleKeydown, clear, rootClass, onClearClick, focus, blur, ariaLabel, get QmIcon() {
+      return Icon;
+    } };
+    Object.defineProperty(__returned__, "__isScriptSetup", { enumerable: false, value: true });
+    return __returned__;
+  }
+});
+
+const _hoisted_1 = ["aria-disabled"];
+const _hoisted_2 = {
+	key: 0,
+	class: "qm-input__prefix",
+	"aria-hidden": "true"
+};
+const _hoisted_3 = [
+	"type",
+	"value",
+	"placeholder",
+	"disabled",
+	"readonly",
+	"maxlength",
+	"autocomplete",
+	"autofocus",
+	"aria-label"
+];
+const _hoisted_4 = {
+	key: 1,
+	class: "qm-input__count",
+	"aria-live": "polite"
+};
+const _hoisted_5 = {
+	key: 3,
+	class: "qm-input__suffix"
+};
+function _sfc_render(_ctx, _cache, $props, $setup, $data, $options) {
+	return openBlock(), createElementBlock("div", {
+		ref: "rootRef",
+		class: normalizeClass($setup.rootClass),
+		"aria-disabled": $setup.disabled || undefined
+	}, [
+		createCommentVNode(" 前缀插槽（图标/文字） "),
+		_ctx.$slots.prefix ? (openBlock(), createElementBlock("span", _hoisted_2, [renderSlot(_ctx.$slots, "prefix")])) : createCommentVNode("v-if", true),
+		createCommentVNode(" 原生输入框（inheritAttrs:false，其余原生/aria/data 属性绑定到 input） "),
+		createElementVNode("input", mergeProps({
+			ref: "inputRef",
+			class: "qm-input__inner"
+		}, _ctx.$attrs, {
+			type: _ctx.type,
+			value: $setup.nativeValue,
+			placeholder: _ctx.placeholder,
+			disabled: $setup.disabled,
+			readonly: $setup.readonly,
+			maxlength: $setup.maxlength,
+			autocomplete: _ctx.autocomplete,
+			autofocus: _ctx.autofocus || undefined,
+			"aria-label": $setup.ariaLabel,
+			onInput: _cache[0] || (_cache[0] = (...args) => $setup.handleInput && $setup.handleInput(...args)),
+			onFocus: _cache[1] || (_cache[1] = (...args) => $setup.handleFocus && $setup.handleFocus(...args)),
+			onBlur: _cache[2] || (_cache[2] = (...args) => $setup.handleBlur && $setup.handleBlur(...args)),
+			onKeydown: _cache[3] || (_cache[3] = (...args) => $setup.handleKeydown && $setup.handleKeydown(...args))
+		}), null, 16, _hoisted_3),
+		createCommentVNode(" 字数统计 "),
+		_ctx.showCount ? (openBlock(), createElementBlock(
+			"span",
+			_hoisted_4,
+			toDisplayString($setup.countText),
+			1
+			/* TEXT */
+		)) : createCommentVNode("v-if", true),
+		createCommentVNode(" 清除按钮 "),
+		$setup.showClear ? (openBlock(), createElementBlock(
+			"button",
+			{
+				key: 2,
+				type: "button",
+				class: "qm-input__clear",
+				"aria-label": "清除",
+				tabindex: "-1",
+				onMousedown: _cache[4] || (_cache[4] = withModifiers(() => {}, ["prevent"])),
+				onClick: $setup.onClearClick
+			},
+			[createVNode($setup["QmIcon"], {
+				name: "close",
+				class: "qm-input__clear-icon",
+				style: { "font-size": "12px" }
+			})],
+			32
+			/* NEED_HYDRATION */
+		)) : createCommentVNode("v-if", true),
+		createCommentVNode(" 后缀插槽（图标/密码可见切换） "),
+		_ctx.$slots.suffix ? (openBlock(), createElementBlock("span", _hoisted_5, [renderSlot(_ctx.$slots, "suffix")])) : createCommentVNode("v-if", true)
+	], 10, _hoisted_1);
+}
+var Input = /*#__PURE__*/ _export_sfc(_sfc_main, [["render", _sfc_render], ["__file", "F:\\软件开发\\青冥组件系统\\packages\\components\\src\\components\\input\\input.vue"]]);
+
+export { Input as c, clampByMaxlength as e, formatCount as f, inputProps as i, useInput as u };
+export type { InputEmits as I, UseInputOptions as U, InputSize as a, InputType as b, UseInputReturn as d };