ep-craft 0.1.30 → 0.1.32

package/dist/components/checkbox/index.d.ts

@@ -1,4 +1,36 @@
 import type { Plugin } from 'vue';
-import { ElCheckbox } from 'element-plus';
-export declare const EpCheckbox: typeof ElCheckbox & Plugin;
+import _EpCheckbox from './EpCheckbox.vue';
+/**
+ * checkbox 自持 barrel：用**本地**安装辅助把 SFC 本体注册为 `ep-checkbox`
+ * ——对外注册名与迁移前的包装态**逐字相同**（需求 6.2）。
+ *
+ * 形态对齐 `src/components/backtop/index.ts`（纯本地本体的自持 barrel）。与迁移前的
+ * `Object.assign({}, ElCheckbox, { name: 'EpCheckbox' })` 包装态的关键差异：本体不再来自
+ * `element-plus`，故本入口模块**零 element-plus 引用**（需求 1.3）。
+ *
+ * 本切片顺带修复一处既有缺陷：包装态 checkbox 注入的是 element-plus 的 form 上下文
+ * Symbol，与本地 `EpForm` / `EpFormItem` provide 的本地 Symbol 不匹配，导致禁用 / 尺寸
+ * 继承、`label for` 关联、`change` 校验与分组 `aria-labelledby` 静默失效（design.md 决策 1）。
+ *
+ * **必须用 `../../utils/with-install`（本地版），不得误用 `../../utils/vue/install`（上游版）**：
+ * 二者同名而签名不同——本地版 `withInstall(component, name: string)` 按**显式注册名**注册；
+ * 上游版 `withInstall(main, extra?)` 按 `comp.name` 注册，并把 `extra` 交给 `Object.values()`
+ * 展开。若误用上游版，第二参字符串会被**逐字符展开**，`ep-checkbox` **静默注册失败**。
+ *
+ * **不导出 `ElCheckbox` 别名**（需求 6.5，design.md 决策 3）：本仓的 `El*` 别名只服务于
+ * 「过渡期仍需用上游组件」的场景；本体已自持后，别名只会与 `EpCheckbox` 争抢同一个 `.install`。
+ *
+ * **不导出 `checkboxPropsDefaults`**（design.md 决策 5）：它在上游只是 barrel 顺带带出的
+ * 默认值常量，本组件的运行时逻辑并不消费它（上游 checkbox 目录内无 `setPropsDefaults` 调用），
+ * 导出会把上游内部实现细节固化为本库契约。需求 6.3 只要求「迁移前已提供的导出不缺失」，
+ * 而迁移前的包装态 barrel 不导出任何常量，故此处按契约显式不导出。
+ *
+ * **不使用 `export *`**：公开面按契约显式列出，避免 `checkbox.ts` / `instance.ts` 的
+ * 内部声明外泄到主入口（与 `backtop` / `input` 一致）。
+ */
+export declare const EpCheckbox: typeof _EpCheckbox & Plugin;
 export default EpCheckbox;
+export { checkboxEmits, checkboxProps } from './src/checkbox';
+export { checkboxGroupContextKey } from './src/constants';
+export type { CheckboxEmits, CheckboxProps, CheckboxPropsPublic, CheckboxValueType, } from './src/checkbox';
+export type { CheckboxInstance } from './instance';

package/dist/components/checkbox/index.js

@@ -1,6 +1,12 @@
-import { ElCheckbox as o } from "element-plus";
-import { withInstall as c } from "../../utils/with-install.js";
-const e = Object.assign({}, o, { name: "EpCheckbox" }), b = c(e, "ep-checkbox");
+import { withInstall as o } from "../../utils/with-install.js";
+import c from "./EpCheckbox.vue.js";
+import { checkboxEmits as x, checkboxProps as h } from "./src/checkbox.js";
+const e = o(
+  c,
+  "ep-checkbox"
+);
 export {
-  b as EpCheckbox
+  e as EpCheckbox,
+  x as checkboxEmits,
+  h as checkboxProps
 };

package/dist/components/checkbox/instance.d.ts

@@ -0,0 +1,10 @@
+import type _EpCheckbox from './EpCheckbox.vue';
+/**
+ * EpCheckbox 的公开实例类型。
+ *
+ * 对应上游 `es/components/checkbox/src/checkbox.d.ts` 的 `CheckboxInstance`
+ * （上游写作 `InstanceType<typeof _default> & unknown`）。本地对 SFC 取实例类型，
+ * 与 `src/components/backtop/instance.ts` 的 `BacktopInstance` 同款写法：
+ * `X & unknown` 与 `X` 类型等价，故省略该恒等交集。
+ */
+export type CheckboxInstance = InstanceType<typeof _EpCheckbox>;

package/dist/components/checkbox/src/checkbox.d.ts

@@ -0,0 +1,208 @@
+import type { ExtractPublicPropTypes } from 'vue';
+import type { ComponentSize } from '@element-plus/constants';
+import type { AriaProps } from '@element-plus/hooks/use-aria';
+export type CheckboxValueType = string | number | boolean;
+export interface CheckboxProps extends Pick<AriaProps, 'ariaLabel' | 'ariaControls'> {
+    /**
+     * @description binding value
+     */
+    modelValue?: number | string | boolean;
+    /**
+     * @description label of the Checkbox when used inside a `checkbox-group`
+     */
+    label?: string | boolean | number | object;
+    /**
+     * @description value of the Checkbox when used inside a `checkbox-group`
+     */
+    value?: string | boolean | number | object;
+    /**
+     * @description Set indeterminate state, only responsible for style control
+     */
+    indeterminate?: boolean;
+    /**
+     * @description whether the Checkbox is disabled
+     */
+    disabled?: boolean;
+    /**
+     * @description if the Checkbox is checked
+     */
+    checked?: boolean;
+    /**
+     * @description native 'name' attribute
+     */
+    name?: string;
+    /**
+     * @description value of the Checkbox if it's checked
+     */
+    trueValue?: string | number;
+    /**
+     * @description value of the Checkbox if it's not checked
+     */
+    falseValue?: string | number;
+    /**
+     * @deprecated use `trueValue` instead
+     * @description value of the Checkbox if it's checked
+     */
+    trueLabel?: string | number;
+    /**
+     * @deprecated use `falseValue` instead
+     * @description value of the Checkbox if it's not checked
+     */
+    falseLabel?: string | number;
+    /**
+     * @description input id
+     */
+    id?: string;
+    /**
+     * @description whether to add a border around Checkbox
+     */
+    border?: boolean;
+    /**
+     * @description size of the Checkbox
+     */
+    size?: ComponentSize;
+    /**
+     * @description input tabindex
+     */
+    tabindex?: string | number;
+    /**
+     * @description whether to trigger form validation
+     */
+    validateEvent?: boolean;
+}
+/**
+ * @deprecated Removed after 3.0.0, Use `CheckboxProps` instead.
+ */
+export declare const checkboxProps: {
+    ariaControls: StringConstructor;
+    /**
+     * @description binding value
+     */
+    modelValue: {
+        type: (BooleanConstructor | NumberConstructor | StringConstructor)[];
+        default: undefined;
+    };
+    /**
+     * @description label of the Checkbox when used inside a `checkbox-group`
+     */
+    label: {
+        type: (BooleanConstructor | ObjectConstructor | NumberConstructor | StringConstructor)[];
+        default: undefined;
+    };
+    /**
+     * @description value of the Checkbox when used inside a `checkbox-group`
+     */
+    value: {
+        type: (BooleanConstructor | ObjectConstructor | NumberConstructor | StringConstructor)[];
+        default: undefined;
+    };
+    /**
+     * @description Set indeterminate state, only responsible for style control
+     */
+    indeterminate: BooleanConstructor;
+    /**
+     * @description whether the Checkbox is disabled
+     */
+    disabled: {
+        type: BooleanConstructor;
+        default: undefined;
+    };
+    /**
+     * @description if the Checkbox is checked
+     */
+    checked: BooleanConstructor;
+    /**
+     * @description native 'name' attribute
+     */
+    name: {
+        type: StringConstructor;
+        default: undefined;
+    };
+    /**
+     * @description value of the Checkbox if it's checked
+     */
+    trueValue: {
+        type: (NumberConstructor | StringConstructor)[];
+        default: undefined;
+    };
+    /**
+     * @description value of the Checkbox if it's not checked
+     */
+    falseValue: {
+        type: (NumberConstructor | StringConstructor)[];
+        default: undefined;
+    };
+    /**
+     * @deprecated use `trueValue` instead
+     * @description value of the Checkbox if it's checked
+     */
+    trueLabel: {
+        type: (NumberConstructor | StringConstructor)[];
+        default: undefined;
+    };
+    /**
+     * @deprecated use `falseValue` instead
+     * @description value of the Checkbox if it's not checked
+     */
+    falseLabel: {
+        type: (NumberConstructor | StringConstructor)[];
+        default: undefined;
+    };
+    /**
+     * @description input id
+     */
+    id: {
+        type: StringConstructor;
+        default: undefined;
+    };
+    /**
+     * @description whether to add a border around Checkbox
+     */
+    border: BooleanConstructor;
+    /**
+     * @description size of the Checkbox
+     */
+    size: {
+        readonly type: import("vue").PropType<import("@element-plus/utils").EpPropMergeType<StringConstructor, "" | "small" | "default" | "large", never>>;
+        readonly required: false;
+        readonly validator: ((val: unknown) => boolean) | undefined;
+        __epPropKey: true;
+    };
+    /**
+     * @description input tabindex
+     */
+    tabindex: (NumberConstructor | StringConstructor)[];
+    /**
+     * @description whether to trigger form validation
+     */
+    validateEvent: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    ariaLabel: StringConstructor;
+};
+export declare const checkboxEmits: {
+    "update:modelValue": (val: CheckboxValueType) => val is string | number | boolean;
+    change: (val: CheckboxValueType) => val is string | number | boolean;
+};
+export type CheckboxEmits = typeof checkboxEmits;
+/**
+ * @deprecated Removed after 3.0.0, Use `CheckboxProps` instead.
+ */
+export type CheckboxPropsPublic = ExtractPublicPropTypes<typeof checkboxProps>;
+/**
+ * @description default values for CheckboxProps
+ */
+export declare const checkboxPropsDefaults: {
+    readonly modelValue: undefined;
+    readonly label: undefined;
+    readonly value: undefined;
+    readonly disabled: undefined;
+    readonly name: undefined;
+    readonly trueValue: undefined;
+    readonly falseValue: undefined;
+    readonly trueLabel: undefined;
+    readonly falseLabel: undefined;
+    readonly id: undefined;
+    readonly validateEvent: true;
+};

package/dist/components/checkbox/src/checkbox.js

@@ -0,0 +1,119 @@
+import { UPDATE_MODEL_EVENT as i } from "../../../constants/event.js";
+import { useAriaProps as a } from "../../../hooks/use-aria/index.js";
+import { useSizeProp as l } from "../../../hooks/use-size/index.js";
+import { isNumber as t, isBoolean as o } from "../../../utils/types.js";
+import "lodash-unified";
+import "@vueuse/core";
+import { isString as r } from "@vue/shared";
+import "@element-plus/icons-vue";
+import "vue";
+const S = {
+  /**
+   * @description binding value
+   */
+  modelValue: {
+    type: [Number, String, Boolean],
+    default: void 0
+  },
+  /**
+   * @description label of the Checkbox when used inside a `checkbox-group`
+   */
+  label: {
+    type: [String, Boolean, Number, Object],
+    default: void 0
+  },
+  /**
+   * @description value of the Checkbox when used inside a `checkbox-group`
+   */
+  value: {
+    type: [String, Boolean, Number, Object],
+    default: void 0
+  },
+  /**
+   * @description Set indeterminate state, only responsible for style control
+   */
+  indeterminate: Boolean,
+  /**
+   * @description whether the Checkbox is disabled
+   */
+  disabled: {
+    type: Boolean,
+    default: void 0
+  },
+  /**
+   * @description if the Checkbox is checked
+   */
+  checked: Boolean,
+  /**
+   * @description native 'name' attribute
+   */
+  name: {
+    type: String,
+    default: void 0
+  },
+  /**
+   * @description value of the Checkbox if it's checked
+   */
+  trueValue: {
+    type: [String, Number],
+    default: void 0
+  },
+  /**
+   * @description value of the Checkbox if it's not checked
+   */
+  falseValue: {
+    type: [String, Number],
+    default: void 0
+  },
+  /**
+   * @deprecated use `trueValue` instead
+   * @description value of the Checkbox if it's checked
+   */
+  trueLabel: {
+    type: [String, Number],
+    default: void 0
+  },
+  /**
+   * @deprecated use `falseValue` instead
+   * @description value of the Checkbox if it's not checked
+   */
+  falseLabel: {
+    type: [String, Number],
+    default: void 0
+  },
+  /**
+   * @description input id
+   */
+  id: {
+    type: String,
+    default: void 0
+  },
+  /**
+   * @description whether to add a border around Checkbox
+   */
+  border: Boolean,
+  /**
+   * @description size of the Checkbox
+   */
+  size: l,
+  /**
+   * @description input tabindex
+   */
+  tabindex: [String, Number],
+  /**
+   * @description whether to trigger form validation
+   */
+  validateEvent: {
+    type: Boolean,
+    default: !0
+  },
+  ariaLabel: String,
+  ...a(["ariaControls"])
+}, c = {
+  [i]: (e) => r(e) || t(e) || o(e),
+  change: (e) => r(e) || t(e) || o(e)
+};
+export {
+  c as checkboxEmits,
+  S as checkboxProps
+};

package/dist/components/checkbox/src/composables/use-checkbox-disabled.d.ts

@@ -0,0 +1,7 @@
+import type { CheckboxModel } from './use-checkbox-model';
+import type { CheckboxStatus } from './use-checkbox-status';
+export declare const useCheckboxDisabled: ({ model, isChecked, }: Pick<CheckboxModel, "model"> & Pick<CheckboxStatus, "isChecked">) => {
+    isDisabled: import("vue").ComputedRef<boolean>;
+    isLimitDisabled: import("vue").ComputedRef<boolean>;
+};
+export type CheckboxDisabled = ReturnType<typeof useCheckboxDisabled>;

package/dist/components/checkbox/src/composables/use-checkbox-disabled.js

@@ -0,0 +1,31 @@
+import { inject as s, computed as u } from "vue";
+import { formContextKey as v } from "../../../form/src/constants.js";
+import { useFormDisabled as p } from "../../../form/src/hooks/use-form-common-props.js";
+import { isUndefined as d } from "../../../../utils/types.js";
+import "lodash-unified";
+import "@vueuse/core";
+import "@vue/shared";
+import "@element-plus/icons-vue";
+import { checkboxGroupContextKey as f } from "../constants.js";
+const F = ({
+  model: r,
+  isChecked: m
+}) => {
+  const e = s(f, void 0), t = s(v, void 0), o = u(() => {
+    var a, l;
+    const i = (a = e == null ? void 0 : e.max) == null ? void 0 : a.value, n = (l = e == null ? void 0 : e.min) == null ? void 0 : l.value;
+    return !d(i) && r.value.length >= i && !m.value || !d(n) && r.value.length <= n && m.value;
+  });
+  return {
+    isDisabled: p(
+      u(() => {
+        var i;
+        return e === void 0 ? (t == null ? void 0 : t.disabled) ?? o.value : ((i = e.disabled) == null ? void 0 : i.value) || o.value;
+      })
+    ),
+    isLimitDisabled: o
+  };
+};
+export {
+  F as useCheckboxDisabled
+};

package/dist/components/checkbox/src/composables/use-checkbox-event.d.ts

@@ -0,0 +1,9 @@
+import { useFormItemInputId } from '@element-plus/components/form/src/hooks/use-form-item';
+import type { CheckboxProps } from '../checkbox';
+import type { CheckboxDisabled } from './use-checkbox-disabled';
+import type { CheckboxModel } from './use-checkbox-model';
+import type { CheckboxStatus } from './use-checkbox-status';
+export declare const useCheckboxEvent: (props: CheckboxProps, { model, isLimitExceeded, hasOwnLabel, isDisabled, isLabeledByFormItem, }: Pick<CheckboxModel, "model" | "isLimitExceeded"> & Pick<CheckboxStatus, "hasOwnLabel"> & Pick<CheckboxDisabled, "isDisabled"> & Pick<ReturnType<typeof useFormItemInputId>, "isLabeledByFormItem">) => {
+    handleChange: (e: Event) => void;
+    onClickRoot: (e: MouseEvent) => Promise<void>;
+};

package/dist/components/checkbox/src/composables/use-checkbox-event.js

@@ -0,0 +1,48 @@
+import { inject as E, getCurrentInstance as C, computed as V, watch as b, nextTick as L } from "vue";
+import { useFormItem as k } from "../../../form/src/hooks/use-form-item.js";
+import { CHANGE_EVENT as r } from "../../../../constants/event.js";
+import { NOOP as N } from "@vue/shared";
+import "lodash-unified";
+import "@vueuse/core";
+import "@element-plus/icons-vue";
+import { checkboxGroupContextKey as x } from "../constants.js";
+const F = (e, {
+  model: n,
+  isLimitExceeded: c,
+  hasOwnLabel: f,
+  isDisabled: v,
+  isLabeledByFormItem: m
+}) => {
+  const u = E(x, void 0), { formItem: l } = k(), { emit: o } = C();
+  function i(t) {
+    return [!0, e.trueValue, e.trueLabel].includes(t) ? e.trueValue ?? e.trueLabel ?? !0 : e.falseValue ?? e.falseLabel ?? !1;
+  }
+  function s(t, a) {
+    o(r, i(t), a);
+  }
+  function d(t) {
+    if (c.value) return;
+    const a = t.target;
+    o(r, i(a.checked), t);
+  }
+  async function h(t) {
+    c.value || !f.value && !v.value && m.value && (t.composedPath().some((a) => a.tagName === "LABEL") || (n.value = i(
+      [!1, e.falseValue, e.falseLabel].includes(n.value)
+    ), await L(), s(n.value, t)));
+  }
+  const g = V(
+    () => (u == null ? void 0 : u.validateEvent) || e.validateEvent
+  );
+  return b(
+    () => e.modelValue,
+    () => {
+      g.value && (l == null || l.validate("change").catch(N));
+    }
+  ), {
+    handleChange: d,
+    onClickRoot: h
+  };
+};
+export {
+  F as useCheckboxEvent
+};

package/dist/components/checkbox/src/composables/use-checkbox-model.d.ts

@@ -0,0 +1,7 @@
+import type { CheckboxProps } from '../checkbox';
+export declare const useCheckboxModel: (props: CheckboxProps) => {
+    model: import("vue").WritableComputedRef<any, any>;
+    isGroup: import("vue").ComputedRef<boolean>;
+    isLimitExceeded: import("vue").Ref<boolean, boolean>;
+};
+export type CheckboxModel = ReturnType<typeof useCheckboxModel>;

package/dist/components/checkbox/src/composables/use-checkbox-model.js

@@ -0,0 +1,31 @@
+import { ref as a, getCurrentInstance as g, inject as p, computed as o } from "vue";
+import { UPDATE_MODEL_EVENT as E } from "../../../../constants/event.js";
+import { isUndefined as C } from "../../../../utils/types.js";
+import "lodash-unified";
+import "@vueuse/core";
+import { isArray as V } from "@vue/shared";
+import "@element-plus/icons-vue";
+import { checkboxGroupContextKey as M } from "../constants.js";
+const j = (d) => {
+  const s = a(!1), { emit: u, vnode: f } = g(), e = p(M, void 0), l = o(() => C(e) === !1), n = a(!1), v = o(() => {
+    const t = f.props ?? {};
+    return "modelValue" in t || "model-value" in t;
+  }), i = o({
+    get() {
+      var t;
+      return l.value ? (t = e == null ? void 0 : e.modelValue) == null ? void 0 : t.value : v.value ? d.modelValue : s.value;
+    },
+    set(t) {
+      var m, r;
+      l.value && V(t) ? (n.value = ((m = e == null ? void 0 : e.max) == null ? void 0 : m.value) !== void 0 && t.length > (e == null ? void 0 : e.max.value) && t.length > i.value.length, n.value === !1 && ((r = e == null ? void 0 : e.changeEvent) == null || r.call(e, t))) : (u(E, t), s.value = t);
+    }
+  });
+  return {
+    model: i,
+    isGroup: l,
+    isLimitExceeded: n
+  };
+};
+export {
+  j as useCheckboxModel
+};

package/dist/components/checkbox/src/composables/use-checkbox-status.d.ts

@@ -0,0 +1,12 @@
+import type { ComponentInternalInstance } from 'vue';
+import type { CheckboxProps } from '../checkbox';
+import type { CheckboxModel } from './use-checkbox-model';
+export declare const useCheckboxStatus: (props: CheckboxProps, slots: ComponentInternalInstance["slots"], { model }: Pick<CheckboxModel, "model">) => {
+    checkboxButtonSize: import("vue").ComputedRef<"" | "small" | "default" | "large">;
+    isChecked: import("vue").ComputedRef<boolean>;
+    isFocused: import("vue").Ref<boolean, boolean>;
+    checkboxSize: import("vue").ComputedRef<"" | "small" | "default" | "large">;
+    hasOwnLabel: import("vue").ComputedRef<boolean>;
+    actualValue: import("vue").ComputedRef<string | number | boolean | object | undefined>;
+};
+export type CheckboxStatus = ReturnType<typeof useCheckboxStatus>;

package/dist/components/checkbox/src/composables/use-checkbox-status.js

@@ -0,0 +1,33 @@
+import { inject as v, ref as d, computed as i, toRaw as o } from "vue";
+import { isEqual as b } from "lodash-unified";
+import { useFormSize as l } from "../../../form/src/hooks/use-form-common-props.js";
+import { isPropAbsent as a, isBoolean as p } from "../../../../utils/types.js";
+import "@vueuse/core";
+import { isArray as z, isObject as S } from "@vue/shared";
+import "@element-plus/icons-vue";
+import { checkboxGroupContextKey as h } from "../constants.js";
+const F = (r, s, { model: n }) => {
+  const t = v(h, void 0), m = d(!1), u = i(() => a(r.value) ? r.label : r.value), c = i(() => {
+    const e = n.value;
+    return p(e) ? e : z(e) ? S(u.value) ? e.map(o).some((f) => b(f, u.value)) : e.map(o).includes(u.value) : e != null ? e === r.trueValue || e === r.trueLabel : !!e;
+  });
+  return {
+    checkboxButtonSize: l(i(() => {
+      var e;
+      return (e = t == null ? void 0 : t.size) == null ? void 0 : e.value;
+    }), {
+      prop: !0
+    }),
+    isChecked: c,
+    isFocused: m,
+    checkboxSize: l(i(() => {
+      var e;
+      return (e = t == null ? void 0 : t.size) == null ? void 0 : e.value;
+    })),
+    hasOwnLabel: i(() => !!s.default || !a(u.value)),
+    actualValue: u
+  };
+};
+export {
+  F as useCheckboxStatus
+};

package/dist/components/checkbox/src/composables/use-checkbox.d.ts

@@ -0,0 +1,16 @@
+import type { ComponentInternalInstance } from 'vue';
+import type { CheckboxProps } from '../checkbox';
+export declare const useCheckbox: (props: CheckboxProps, slots: ComponentInternalInstance["slots"]) => {
+    inputId: import("vue").Ref<string | undefined, string | undefined>;
+    isLabeledByFormItem: import("vue").ComputedRef<boolean>;
+    isChecked: import("vue").ComputedRef<boolean>;
+    isDisabled: import("vue").ComputedRef<boolean>;
+    isFocused: import("vue").Ref<boolean, boolean>;
+    checkboxButtonSize: import("vue").ComputedRef<"" | "small" | "default" | "large">;
+    checkboxSize: import("vue").ComputedRef<"" | "small" | "default" | "large">;
+    hasOwnLabel: import("vue").ComputedRef<boolean>;
+    model: import("vue").WritableComputedRef<any, any>;
+    actualValue: import("vue").ComputedRef<string | number | boolean | object | undefined>;
+    handleChange: (e: Event) => void;
+    onClickRoot: (e: MouseEvent) => Promise<void>;
+};