ep-craft 0.1.37 → 0.1.39

package/dist/hooks/index.d.ts

@@ -24,3 +24,5 @@ export * from './use-calc-input-width';
 export * from './use-float-label';
 export * from './use-lockscreen';
 export * from './use-throttle-render';
+export * from './use-same-target';
+export * from './use-draggable';

package/dist/hooks/use-delayed-toggle/index.d.ts

@@ -17,9 +17,9 @@ export interface UseDelayedToggleProps {
  * @deprecated Removed after 3.0.0, Use `UseDelayedToggleProps` instead.
  */
 export declare const useDelayedToggleProps: {
-    readonly showAfter: import("@element-plus/utils").EpPropFinalized<NumberConstructor, unknown, unknown, 0, boolean>;
-    readonly hideAfter: import("@element-plus/utils").EpPropFinalized<NumberConstructor, unknown, unknown, 200, boolean>;
-    readonly autoClose: import("@element-plus/utils").EpPropFinalized<NumberConstructor, unknown, unknown, 0, boolean>;
+    readonly showAfter: import("../../utils/index").EpPropFinalized<NumberConstructor, unknown, unknown, 0, boolean>;
+    readonly hideAfter: import("../../utils/index").EpPropFinalized<NumberConstructor, unknown, unknown, 200, boolean>;
+    readonly autoClose: import("../../utils/index").EpPropFinalized<NumberConstructor, unknown, unknown, 0, boolean>;
 };
 export type DelayedToggle = {
     open: (event?: Event) => void;

package/dist/hooks/use-draggable/index.d.ts

@@ -0,0 +1,6 @@
+import type { ComputedRef, Ref } from 'vue';
+export declare const useDraggable: (targetRef: Ref<HTMLElement | undefined>, dragRef: Ref<HTMLElement | undefined>, draggable: ComputedRef<boolean>, overflow?: ComputedRef<boolean>) => {
+    isDragging: Ref<boolean, boolean>;
+    resetPosition: () => void;
+    updatePosition: () => void;
+};

package/dist/hooks/use-draggable/index.js

@@ -0,0 +1,51 @@
+import { ref as T, onMounted as W, watchEffect as y, onBeforeUnmount as z } from "vue";
+import "@vue/shared";
+import { clamp as w } from "lodash-unified";
+import "@vueuse/core";
+import { addUnit as X } from "../../utils/dom/style.js";
+import "@element-plus/icons-vue";
+const q = (n, u, Y, d) => {
+  const o = {
+    offsetX: 0,
+    offsetY: 0
+  }, a = T(!1), h = (t, e) => {
+    if (n.value) {
+      const { offsetX: m, offsetY: f } = o, s = n.value.getBoundingClientRect(), i = Math.max(s.left, 0), c = Math.max(s.top, 0), l = s.width, r = s.height, p = document.documentElement.clientWidth, L = document.documentElement.clientHeight, D = -i + m, b = -c + f, H = p - i - l + m, P = L - c - (r < L ? r : 0) + f;
+      d != null && d.value || (t = w(t, D, H), e = w(e, b, P)), o.offsetX = t, o.offsetY = e, n.value.style.transform = `translate(${X(t)}, ${X(
+        e
+      )})`;
+    }
+  }, g = (t) => {
+    const e = t.clientX, m = t.clientY, { offsetX: f, offsetY: s } = o, i = (l) => {
+      a.value || (a.value = !0);
+      const r = f + l.clientX - e, p = s + l.clientY - m;
+      h(r, p);
+    }, c = () => {
+      a.value = !1, document.removeEventListener("mousemove", i), document.removeEventListener("mouseup", c);
+    };
+    document.addEventListener("mousemove", i), document.addEventListener("mouseup", c);
+  }, M = () => {
+    u.value && n.value && (u.value.addEventListener("mousedown", g), window.addEventListener("resize", v));
+  }, E = () => {
+    u.value && n.value && (u.value.removeEventListener("mousedown", g), window.removeEventListener("resize", v));
+  }, x = () => {
+    o.offsetX = 0, o.offsetY = 0, n.value && (n.value.style.transform = "");
+  }, v = () => {
+    const { offsetX: t, offsetY: e } = o;
+    h(t, e);
+  };
+  return W(() => {
+    y(() => {
+      Y.value ? M() : E();
+    });
+  }), z(() => {
+    E();
+  }), {
+    isDragging: a,
+    resetPosition: x,
+    updatePosition: v
+  };
+};
+export {
+  q as useDraggable
+};

package/dist/hooks/use-empty-values/index.d.ts

@@ -19,7 +19,7 @@ export declare const DEFAULT_VALUE_ON_CLEAR: undefined;
  */
 export declare const useEmptyValuesProps: {
     readonly emptyValues: ArrayConstructor;
-    readonly valueOnClear: import("@element-plus/utils").EpPropFinalized<(new (...args: any[]) => string | number | boolean | Function) | (() => string | number | boolean | Function | null) | (((new (...args: any[]) => string | number | boolean | Function) | (() => string | number | boolean | Function | null)) | null)[], unknown, unknown, undefined, boolean>;
+    readonly valueOnClear: import("../../utils/index").EpPropFinalized<(new (...args: any[]) => string | number | boolean | Function) | (() => string | number | boolean | Function | null) | (((new (...args: any[]) => string | number | boolean | Function) | (() => string | number | boolean | Function | null)) | null)[], unknown, unknown, undefined, boolean>;
 };
 export declare const useEmptyValues: (props: UseEmptyValuesProps, defaultValue?: null | undefined) => {
     emptyValues: import("vue").ComputedRef<unknown[]>;

package/dist/hooks/use-locale/index.d.ts

@@ -1,7 +1,7 @@
-import English from '@element-plus/locale/lang/en';
+import English from '../../locale/lang/en';
 import type { InjectionKey, MaybeRef, Ref } from 'vue';
-import type { FieldPath } from '@element-plus/utils';
-import type { Language } from '@element-plus/locale';
+import type { FieldPath } from '../../utils/index';
+import type { Language } from '../../locale/index';
 export type LocaleKeys = Exclude<FieldPath<typeof English>, 'name' | 'el'> | (string & NonNullable<unknown>);
 export type TranslatorOption = Record<string, string | number>;
 export type Translator = (path: LocaleKeys, option?: TranslatorOption) => string;

package/dist/hooks/use-locale/index.js

@@ -1,24 +1,24 @@
-import { inject as s, ref as n, computed as c, unref as l, isRef as a } from "vue";
+import { inject as s, ref as o, computed as c, unref as l, isRef as a } from "vue";
 import { get as m } from "lodash-unified";
 import u from "../../locale/lang/en.js";
-const f = (e) => (t, r) => d(t, r, l(e)), d = (e, t, r) => m(r, e, e).replace(
+const f = (e) => (t, r) => x(t, r, l(e)), x = (e, t, r) => m(r, e, e).replace(
   /\{(\w+)\}/g,
-  (b, o) => `${(t == null ? void 0 : t[o]) ?? `{${o}}`}`
-), i = (e) => {
-  const t = c(() => l(e).name), r = a(e) ? e : n(e);
+  (g, n) => `${(t == null ? void 0 : t[n]) ?? `{${n}}`}`
+), b = (e) => {
+  const t = c(() => l(e).name), r = a(e) ? e : o(e);
   return {
     lang: t,
     locale: r,
     t: f(e)
   };
-}, x = Symbol("localeContextKey"), y = (e) => {
-  const t = s(x, n());
-  return i(c(() => t.value || u));
+}, d = Symbol("localeContextKey"), K = (e) => {
+  const t = e || s(d, o());
+  return b(c(() => t.value || u));
 };
 export {
-  i as buildLocaleContext,
+  b as buildLocaleContext,
   f as buildTranslator,
-  x as localeContextKey,
-  d as translate,
-  y as useLocale
+  d as localeContextKey,
+  x as translate,
+  K as useLocale
 };

package/dist/hooks/use-model-toggle/index.d.ts

@@ -1,6 +1,6 @@
-import type { ExtractPropType } from '@element-plus/utils';
+import type { ExtractPropType } from '../../utils/index';
 import type { ExtractPropTypes, ExtractPublicPropTypes, Ref } from 'vue';
-declare const _prop: import("@element-plus/utils").EpPropFinalized<(new (...args: any[]) => boolean) | (() => boolean | null) | (((new (...args: any[]) => boolean) | (() => boolean | null)) | null)[], never, never, null, false>;
+declare const _prop: import("../../utils/index").EpPropFinalized<(new (...args: any[]) => boolean) | (() => boolean | null) | (((new (...args: any[]) => boolean) | (() => boolean | null)) | null)[], never, never, null, false>;
 declare const _event: {
     readonly type: import("vue").PropType<(val: boolean) => void>;
     readonly required: false;

package/dist/hooks/use-namespace/index.js

@@ -1,21 +1,21 @@
 import { getCurrentInstance as p, inject as N, ref as v, computed as V, unref as y } from "vue";
-const $ = "el", l = "is-", c = (t, u, a, o, m) => {
-  let r = `${t}-${u}`;
-  return a && (r += `-${a}`), o && (r += `__${o}`), m && (r += `--${m}`), r;
-}, B = Symbol("namespaceContextKey"), i = (t) => {
-  const u = p() ? N(B, v($)) : v($);
-  return V(() => y(u) || $);
-}, P = (t, u) => {
-  const a = i();
+const m = "el", l = "is-", c = (a, r, t, o, $) => {
+  let u = `${a}-${r}`;
+  return t && (u += `-${t}`), o && (u += `__${o}`), $ && (u += `--${$}`), u;
+}, B = Symbol("namespaceContextKey"), C = (a) => {
+  const r = a || (p() ? N(B, v(m)) : v(m));
+  return V(() => y(r) || m);
+}, q = (a, r) => {
+  const t = C(r);
   return {
-    namespace: a,
-    b: (s = "") => c(a.value, t, s, "", ""),
-    e: (s) => s ? c(a.value, t, "", s, "") : "",
-    m: (s) => s ? c(a.value, t, "", "", s) : "",
-    be: (s, e) => s && e ? c(a.value, t, s, e, "") : "",
-    em: (s, e) => s && e ? c(a.value, t, "", s, e) : "",
-    bm: (s, e) => s && e ? c(a.value, t, s, "", e) : "",
-    bem: (s, e, n) => s && e && n ? c(a.value, t, s, e, n) : "",
+    namespace: t,
+    b: (s = "") => c(t.value, a, s, "", ""),
+    e: (s) => s ? c(t.value, a, "", s, "") : "",
+    m: (s) => s ? c(t.value, a, "", "", s) : "",
+    be: (s, e) => s && e ? c(t.value, a, s, e, "") : "",
+    em: (s, e) => s && e ? c(t.value, a, "", s, e) : "",
+    bm: (s, e) => s && e ? c(t.value, a, s, "", e) : "",
+    bem: (s, e, n) => s && e && n ? c(t.value, a, s, e, n) : "",
     is: (s, ...e) => {
       const n = e.length >= 1 ? e[0] : !0;
       return s && n ? `${l}${s}` : "";
@@ -24,22 +24,22 @@ const $ = "el", l = "is-", c = (t, u, a, o, m) => {
     cssVar: (s) => {
       const e = {};
       for (const n in s)
-        s[n] && (e[`--${a.value}-${n}`] = s[n]);
+        s[n] && (e[`--${t.value}-${n}`] = s[n]);
       return e;
     },
-    cssVarName: (s) => `--${a.value}-${s}`,
+    cssVarName: (s) => `--${t.value}-${s}`,
     cssVarBlock: (s) => {
       const e = {};
       for (const n in s)
-        s[n] && (e[`--${a.value}-${t}-${n}`] = s[n]);
+        s[n] && (e[`--${t.value}-${a}-${n}`] = s[n]);
       return e;
     },
-    cssVarBlockName: (s) => `--${a.value}-${t}-${s}`
+    cssVarBlockName: (s) => `--${t.value}-${a}-${s}`
   };
 };
 export {
-  $ as defaultNamespace,
+  m as defaultNamespace,
   B as namespaceContextKey,
-  i as useGetDerivedNamespace,
-  P as useNamespace
+  C as useGetDerivedNamespace,
+  q as useNamespace
 };

package/dist/hooks/use-popper/index.d.ts

@@ -11,7 +11,7 @@ export declare const usePopper: (referenceElementRef: Ref<ReferenceElement>, pop
             arrow?: HTMLElement;
         } | undefined;
         options?: import("@popperjs/core").OptionsGeneric<any> | undefined;
-        placement?: import("element-plus").Placement | undefined;
+        placement?: import("@popperjs/core").Placement | undefined;
         strategy?: import("@popperjs/core").PositioningStrategy | undefined;
         orderedModifiers?: Modifier<any, any>[] | undefined;
         rects?: import("@popperjs/core").StateRects | undefined;

package/dist/hooks/use-same-target/index.d.ts

@@ -0,0 +1,5 @@
+export declare const useSameTarget: (handleClick?: (e: MouseEvent) => void) => {
+    onClick: (e: MouseEvent) => void;
+    onMousedown: (e: MouseEvent) => void;
+    onMouseup: (e: MouseEvent) => void;
+};

package/dist/hooks/use-same-target/index.js

@@ -0,0 +1,20 @@
+import { NOOP as r } from "@vue/shared";
+import "lodash-unified";
+import "@vueuse/core";
+import "@element-plus/icons-vue";
+import "vue";
+const f = (n) => {
+  if (!n)
+    return { onClick: r, onMousedown: r, onMouseup: r };
+  let t = !1, e = !1;
+  return { onClick: (o) => {
+    t && e && n(o), t = e = !1;
+  }, onMousedown: (o) => {
+    t = o.target === o.currentTarget;
+  }, onMouseup: (o) => {
+    e = o.target === o.currentTarget;
+  } };
+};
+export {
+  f as useSameTarget
+};

package/dist/hooks/use-size/index.d.ts

@@ -1,14 +1,14 @@
 import type { InjectionKey, Ref } from 'vue';
-import type { ComponentSize } from '@element-plus/constants';
+import type { ComponentSize } from '../../constants/index';
 export declare const useSizeProp: {
-    readonly type: import("vue").PropType<import("@element-plus/utils").EpPropMergeType<StringConstructor, "" | "small" | "default" | "large", never>>;
+    readonly type: import("vue").PropType<import("../../utils/index").EpPropMergeType<StringConstructor, "" | "small" | "default" | "large", never>>;
     readonly required: false;
     readonly validator: ((val: unknown) => boolean) | undefined;
     __epPropKey: true;
 };
 export declare const useSizeProps: {
     size: {
-        readonly type: import("vue").PropType<import("@element-plus/utils").EpPropMergeType<StringConstructor, "" | "small" | "default" | "large", never>>;
+        readonly type: import("vue").PropType<import("../../utils/index").EpPropMergeType<StringConstructor, "" | "small" | "default" | "large", never>>;
         readonly required: false;
         readonly validator: ((val: unknown) => boolean) | undefined;
         __epPropKey: true;

package/dist/hooks/use-z-index/index.js

@@ -1,30 +1,30 @@
-import { ref as m, getCurrentInstance as i, inject as e, computed as c, unref as a } from "vue";
-import { isNumber as p } from "../../utils/types.js";
+import { ref as a, getCurrentInstance as i, inject as e, computed as c, unref as p } from "vue";
+import { isNumber as l } from "../../utils/types.js";
 import "lodash-unified";
-import { isClient as l } from "@vueuse/core";
-import { debugWarn as v } from "../../utils/error.js";
+import { isClient as v } from "@vueuse/core";
+import { debugWarn as Z } from "../../utils/error.js";
 import "@vue/shared";
 import "@element-plus/icons-vue";
 const s = {
   current: 0
-}, d = m(0), Z = 2e3, u = Symbol("elZIndexContextKey"), f = Symbol("zIndexContextKey"), K = (y) => {
-  const n = i() ? e(u, s) : s, I = i() ? e(f, void 0) : void 0, t = c(() => {
-    const o = a(I);
-    return p(o) ? o : Z;
-  }), r = c(() => t.value + d.value), x = () => (n.current++, d.value = n.current, r.value);
-  return !l && !e(u) && v(
+}, u = a(0), f = 2e3, d = Symbol("elZIndexContextKey"), y = Symbol("zIndexContextKey"), K = (I) => {
+  const n = i() ? e(d, s) : s, x = I || (i() ? e(y, void 0) : void 0), t = c(() => {
+    const r = p(x);
+    return l(r) ? r : f;
+  }), o = c(() => t.value + u.value), m = () => (n.current++, u.value = n.current, o.value);
+  return !v && !e(d) && Z(
     "ZIndexInjection",
     `Looks like you are using server rendering, you must provide a z-index provider to ensure the hydration process to be succeed
 usage: app.provide(ZINDEX_INJECTION_KEY, { current: 0 })`
   ), {
     initialZIndex: t,
-    currentZIndex: r,
-    nextZIndex: x
+    currentZIndex: o,
+    nextZIndex: m
   };
 };
 export {
-  u as ZINDEX_INJECTION_KEY,
-  Z as defaultInitialZIndex,
+  d as ZINDEX_INJECTION_KEY,
+  f as defaultInitialZIndex,
   K as useZIndex,
-  f as zIndexContextKey
+  y as zIndexContextKey
 };

package/dist/index.d.ts

@@ -2,34 +2,24 @@ import type { Plugin } from 'vue';
 export * from './components';
 export { withInstall } from './utils/with-install';
 export { EpCraftResolver } from './resolver';
-export * from 'element-plus';
 /**
- * 表单上下文相关的 hooks 与 InjectionKey，必须覆盖 element-plus 的同名导出。
- *
- * 背景：源码化（vendored）的表单类组件在构建时被 alias 到本地 src/，
- * 其 provide/inject 用的是本库 src/components/form/src/constants.ts 定义的
- * Symbol；而 `export * from 'element-plus'` 带出的同名成员来自 element-plus
- * 自己的包实例，两者是不同的 Symbol（Symbol 每次求值都会产生新值）。
- *
- * 后果：使用方从 `ep-craft` 根入口导入 useFormDisabled 等 hooks 时，
- * 实际拿到的是 element-plus 版本，其 inject(formContextKey) 找不到
- * <ep-form> provide 的上下文，`form?.disabled` 恒为 undefined，最终兜底为
- * false——表单级 disabled 无法传播到自定义包装组件（表现为只读态下下拉框
- * 已置灰、数字输入框仍可编辑）。
- *
- * 故此处显式再导出本库自身的实现。必须写在 `export * from 'element-plus'`
- * 之后：若写在其前面，同名导出会因 export * 的歧义消除规则被静默丢弃，
- * 使用方又会拿到 element-plus 版本，问题复现。
+ * 表单上下文相关的 hooks 与 InjectionKey。
+ *
+ * 这些符号来自本库 `components/form`，与本地 `<ep-form>` / `<ep-form-item>`
+ * provide 的是同一实例。使用方若从其他来源取得同名 Symbol，`inject` 将匹配不到
+ * 本地上下文，表单级 disabled / size 等联动会静默失效，故由包入口显式具名导出。
+ *
+ * 契约常量与公开类型同样以本地为准（vendor-form 需求 5.4 / 任务 5.3）：
+ * `formProps` / `formItemProps` 等运行时值由包入口直接提供，与深层路径指向
+ * 同一份本地实现。
  */
-export { formContextKey, formItemContextKey, useDisabled, useFormDisabled, useFormItem, useFormItemInputId, useFormSize, useSize, } from './components/form';
+export { formContextKey, formEmits, formItemContextKey, formItemProps, formItemValidateStates, formMetaProps, formProps, useDisabled, useFormDisabled, useFormItem, useFormItemInputId, useFormSize, useSize, } from './components/form';
+export type { FormContext, FormEmits, FormInstance, FormItemContext, FormItemInstance, FormItemProp, FormItemProps, FormItemPropsPublic, FormItemRule, FormItemValidateState, FormLabelWidthContext, FormMetaProps, FormMetaPropsPublic, FormProps, FormPropsPublic, FormRules, FormValidateCallback, FormValidateFailure, FormValidationResult, IUseFormItemInputCommonProps, } from './components/form';
 /**
  * checkbox 家族的契约常量、分组上下文键与公开类型（vendor-checkbox 产出）。
  *
- * 同上：必须写在 `export * from 'element-plus'` **之后**。这些名字在
- * `./components`（本库实现）与 `element-plus`（同名成员）两侧都存在，若写在其前面，
- * 同名导出会因 export * 的歧义消除规则被**静默丢弃**，使用方又会拿到 element-plus 版本。
- * 其中 `checkboxGroupContextKey` 尤须注意——它是**本地 Symbol**，拿错版本会让
- * `inject` 与 `<ep-checkbox-group>` 的 `provide` 对不上，分组上下文静默失效。
+ * `checkboxGroupContextKey` 是本地 Symbol，与 `<ep-checkbox-group>` provide 的是
+ * 同一实例；拿错版本会让分组上下文静默失效，故由包入口显式具名导出。
  *
  * 按 design.md 决策 5，此处**不导出** `checkboxPropsDefaults` / `checkboxDefaultProps`
  * 两个内部默认值常量；按决策 3，也**不导出** `ElCheckbox` / `ElCheckboxButton` /
@@ -43,13 +33,8 @@ export type { CheckboxGroupEmits, CheckboxGroupInstance, CheckboxGroupProps, Che
 /**
  * table 与 table-column 家族的契约常量与公开类型（vendor-table 产出）。
  *
- * 位置同表单 / checkbox 两块：置于 `export * from 'element-plus'` 之后，保持同一约定。
- * 要点在于本块是**显式具名**再导出——`export *` 带出的同名成员会因歧义消除规则被丢弃，
- * 只有显式导出能覆盖它，故这些名字必须在此逐一点名。
- *
- * 本块是既有能力的**契约化**（需求 5.5）：迁移前这些名字只能经 `element-plus` 取到且
- * 指向 element-plus 的声明；迁移后指向本地自持实现（两者同源逐字一致）。不新增任何
- * props / emits 行为（需求 1.6）。
+ * 本块是既有能力的**契约化**（需求 5.5）：这些名字由包入口显式具名再导出，内容来自
+ * 本地自持实现（与上游同源逐字一致）。不新增任何 props / emits 行为（需求 1.6）。
  *
  * 按需求 5.6，**不导出** `ElTable` / `ElTableColumn` 别名；按 design.md 决策 6，
  * **不导出** `tableEmits` —— 上游没有该运行时常量，emits 侧只有 `TableEmits<T>` 类型，
@@ -67,12 +52,8 @@ export type { FilterMethods, Filters, TableColumn, TableColumnProps, ValueOf, }
 /**
  * tree、tree-select 与 text 家族的契约常量、注入键与公开类型（vendor-tree 产出）。
  *
- * 位置同表单 / checkbox / table / upload 各块：置于 `export * from 'element-plus'` 之后。
- * `treeProps` / `treeEmits` / 三个注入键与 `textProps` 在两边同名，只有显式具名导出
- * 才能覆盖 `export *` 带出的 element-plus 版本；写在其前面会被歧义消除规则静默丢弃。
- *
  * 三个注入键是**本地 Symbol**，使用方要拿它们 `inject` 到本地 `<ep-tree>` /
- * `<ep-tree-node>` provide 的上下文，拿错版本会静默失效。
+ * `<ep-tree-node>` provide 的上下文，拿错版本会静默失效，故随契约常量一并显式导出。
  *
  * 按本切片口径，**不导出** `ElTree` / `ElTreeSelect` / `ElText` 别名。
  * 既有 table 的 `TreeNode` / `TreeProps` 类型块保持不动，与本块的 tree 类型互不替代。
@@ -85,17 +66,11 @@ export type { TextProps, TextPropsPublic } from './components/text';
 /**
  * upload 与 progress 家族的契约常量、上下文键与公开类型（vendor-upload 产出）。
  *
- * 位置同表单 / checkbox / table 三块：置于 `export * from 'element-plus'` 之后，保持同一约定。
- * 要点在于本块是**显式具名**再导出——`export *` 带出的同名成员会因歧义消除规则被**静默丢弃**，
- * 只有显式导出能覆盖它，故这些名字必须在此逐一点名。
- *
- * 本块是既有能力的**契约化**（需求 9.4）：迁移前这些名字只能经 `element-plus` 取到且
- * 指向 element-plus 的声明；迁移后指向本地自持实现（两者同源逐字一致）。不新增任何
- * props / emits 行为（需求 1.6）。
+ * 本块是既有能力的**契约化**（需求 9.4）：这些名字由包入口显式具名再导出，内容来自
+ * 本地自持实现（与上游同源逐字一致）。不新增任何 props / emits 行为（需求 1.6）。
  *
- * `uploadContextKey` 尤须注意——它是**本地 Symbol**，使用方要拿它 `inject` 到
- * `<ep-upload>` provide 的上下文（`{ accept }`），拿错版本（element-plus 的同名 Symbol）
- * 会静默失效。`genFileId` 按需求 9.5 单独点名导出。
+ * `uploadContextKey` 是**本地 Symbol**，使用方要拿它 `inject` 到 `<ep-upload>` provide
+ * 的上下文（`{ accept }`），拿错版本会静默失效。`genFileId` 按需求 9.5 单独点名导出。
  *
  * 按 design.md 决策 5，此处**不导出** `ElUpload` / `ElProgress` 别名（需求 9.6）。
  */
@@ -108,39 +83,32 @@ export type { BorderStyle, DividerInstance, DividerProps, DividerPropsPublic, }
 /**
  * popover / dropdown / button-group 的契约常量、注入键与公开类型（vendor-popover 产出）。
  *
- * 位置同前几块：必须写在 `export * from 'element-plus'` **之后**。这些名字在
- * `./components`（本库实现）与 `element-plus`（同名成员）两侧都存在，若写在其前面，
- * 同名导出会因 export * 的歧义消除规则被**静默丢弃**，使用方又会拿到 element-plus 版本。
- * 其中 `DROPDOWN_INJECTION_KEY` / `DROPDOWN_INSTANCE_INJECTION_KEY` /
- * `buttonGroupContextKey` 尤须注意——它们是本地上下文标识，拿错版本会让 inject 与
- * 本地 `<ep-dropdown>` / `<ep-button-group>` 的 provide 对不上，上下文静默失效。
+ * `DROPDOWN_INJECTION_KEY` / `DROPDOWN_INSTANCE_INJECTION_KEY` / `buttonGroupContextKey`
+ * 是本地上下文标识，与本地 `<ep-dropdown>` / `<ep-button-group>` provide 的是同一实例；
+ * 拿错版本会让 inject 静默失效。
  *
  * 按需求 8.6，此处**不导出** `ElPopover` / `ElDropdown` / `ElDropdownItem` /
  * `ElDropdownMenu` / `ElButtonGroup` 别名；五个 `Ep*` 本体已由 `./components` 的
- * star export 提供，无需重复点名。
+ * barrel 提供，无需重复点名。
  */
 export { EpPopoverDirective } from './components/popover';
 export { popoverProps, popoverEmits, popoverPropsDefaults, } from './components/popover';
 export type { PopoverProps, PopoverPropsPublic, PopoverEmits, PopoverInstance, } from './components/popover';
 export { dropdownProps, dropdownItemProps, dropdownMenuProps, DROPDOWN_INJECTION_KEY, DROPDOWN_INSTANCE_INJECTION_KEY, FIRST_KEYS, LAST_KEYS, FIRST_LAST_KEYS, } from './components/dropdown';
-export type { DropdownInstance, IElDropdownInstance, ElDropdownInjectionContext, } from './components/dropdown';
+export type { DropdownInstance, IElDropdownInstance as IDropdownInstance, ElDropdownInjectionContext as DropdownInjectionContext, } from './components/dropdown';
 export { buttonGroupContextKey } from './components/button';
 /**
  * switch / segmented / steps / step 家族的契约常量、注入键与公开类型
  * （vendor-batch-1 产出）。
  *
- * 位置同前几块：必须写在 `export * from 'element-plus'` **之后**。这些名字在
- * `./components`（本库实现）与 `element-plus`（同名成员）两侧都存在，若写在其前面，
- * 同名导出会因 export * 的歧义消除规则被**静默丢弃**，使用方又会拿到 element-plus 版本。
- *
  * 要点：
- * - `defaultProps` 是 segmented 的选项键默认值，名字泛化但属上游既有根导出，
+ * - `defaultProps` 是 segmented 的选项键默认值，名字泛化但属既有根导出，
  *   按需求 6.4 原样接管，不新增名字。
  * - `STEPS_INJECTION_KEY` 的值是字符串 `'ElSteps'`，保持与上游逐字一致；
  *   Step 与 Steps 本地两侧共用同一份 tokens，不做 `ElStep` 双名兼容。
- * - `Props` 是 segmented 的选项键类型，上游根入口同样导出该名字，故显式接管。
+ * - `Props` 是 segmented 的选项键类型，根入口同样导出该名字，故显式接管。
  * - 按需求 6.5，此处**不导出** `ElSwitch` / `ElSegmented` / `ElSteps` / `ElStep` 别名；
- *   四个 `Ep*` 本体已由 `./components` 的 star export 提供，无需重复点名。
+ *   四个 `Ep*` 本体已由 `./components` 的 barrel 提供，无需重复点名。
  */
 export { switchEmits, switchProps } from './components/switch';
 export type { SwitchEmits, SwitchInstance, SwitchProps, SwitchPropsPublic, } from './components/switch';
@@ -154,15 +122,11 @@ export type { StepInstance, StepProps, StepPropsPublic, } from './components/ste
  * vendor-batch-2 产出：Rate / TimeSelect / Descriptions / Carousel / Transfer /
  * Mention 的公开常量与类型。
  *
- * 位置同前几块：必须写在 `export * from 'element-plus'` **之后**。这些名字在
- * `./components`（本库实现）与 `element-plus`（同名成员）两侧都存在，若写在其前面，
- * 同名导出会因 export * 的歧义消除规则被**静默丢弃**，使用方又会拿到 element-plus 版本。
- *
  * 要点：
  * - `CAROUSEL_ITEM_NAME` 与本地子项组件名一致（`'EpCarouselItem'`）；使用方若按
  *   该常量做识别，必须使用本导出。
  * - `carouselContextKey` 是本地 Symbol，与 `EpCarousel` provide 的是同一实例。
- * - `renderContent` 是 transfer 的渲染函数类型别名，上游根入口同样导出该名字。
+ * - `renderContent` 是 transfer 的渲染函数类型别名，根入口同样导出该名字。
  * - 按需求 10.5，此处**不导出** `ElRate` / `ElTimeSelect` / `ElDescriptions` /
  *   `ElDescriptionsItem` / `ElCarousel` / `ElCarouselItem` / `ElTransfer` /
  *   `ElMention` 别名。
@@ -183,17 +147,13 @@ export type { MentionEmits, MentionInstance, MentionOption, MentionOptionProps,
  * vendor-batch-3 产出：Tour / TourStep / Slider / ColorPicker / Cascader /
  * CascaderPanel 的公开常量与类型。
  *
- * 位置同前几块：必须写在 `export * from 'element-plus'` **之后**。这些名字在
- * `./components`（本库实现）与 `element-plus`（同名成员）两侧都存在，若写在其前面，
- * 同名导出会因 export * 的歧义消除规则被**静默丢弃**，使用方又会拿到 element-plus 版本。
- *
  * 要点：
  * - `CASCADER_PANEL_INJECTION_KEY` 与 `sliderContextKey` 是本地 Symbol，
  *   与本地组件的 provide 共用同一实例，拿错版本会静默失效。
  * - `CascaderNode` 以值形式取自 `cascader-panel/node.ts` 的 `Node` 类，与上游同名导出同形。
  * - ColorPickerPanel 是内部实现，此处不导出其任何名字；`ElTour` / `ElTourStep` /
  *   `ElSlider` / `ElColorPicker` / `ElCascader` / `ElCascaderPanel` 别名亦不导出。
- *   六个 `Ep*` 本体已由 `./components` 的 star export 提供。
+ *   六个 `Ep*` 本体已由 `./components` 的 barrel 提供。
  */
 export { tourContentEmits, tourContentProps, tourEmits, tourPlacements, tourProps, tourStepEmits, tourStepProps, tourStrategies, } from './components/tour';
 export type { TourBtnProps, TourContentEmits, TourContentProps, TourContentPropsPublic, TourEmits, TourGap, TourInstance, TourMask, TourProps, TourPropsPublic, TourStepEmits, TourStepProps, TourStepPropsPublic, } from './components/tour';
@@ -204,7 +164,27 @@ export type { ColorPickerEmits, ColorPickerInstance, ColorPickerProps, ColorPick
 export { cascaderEmits, cascaderProps } from './components/cascader';
 export type { CascaderComponentProps, CascaderEmits, CascaderInstance, } from './components/cascader';
 export { CASCADER_PANEL_HEIGHT, CASCADER_PANEL_INJECTION_KEY, CASCADER_PANEL_ITEM_SIZE, CascaderNode, CommonProps, DefaultProps, cascaderPanelEmits, cascaderPanelProps, useCascaderConfig, } from './components/cascader-panel';
-export type { CascaderCommonProps, CascaderConfig, CascaderMenuInstance, CascaderNodePathValue, CascaderNodeValue, CascaderOption, CascaderPanelInstance, CascaderPanelProps, CascaderProps, CascaderValue, ElCascaderPanelContext, ExpandTrigger, LazyLoad, Nullable, RenderLabel, RenderLabelProps, Resolve, Tag, isDisabled, isLeaf, } from './components/cascader-panel';
-export { ElMessage as EpMessage, ElMessageBox as EpMessageBox, ElNotification as EpNotification, ElLoading as EpLoading, ElInfiniteScroll as EpInfiniteScroll, } from 'element-plus';
+export type { CascaderCommonProps, CascaderConfig, CascaderMenuInstance, CascaderNodePathValue, CascaderNodeValue, CascaderOption, CascaderPanelInstance, CascaderPanelProps, CascaderProps, CascaderValue, ElCascaderPanelContext as CascaderPanelContext, ExpandTrigger, LazyLoad, Nullable, RenderLabel, RenderLabelProps, Resolve, Tag, isDisabled, isLeaf, } from './components/cascader-panel';
+/**
+ * 服务类 API 与指令出口（vendor-service-apis 需求 6.1 / 8.1 / 8.2 / 9.3）。
+ *
+ * 要点：
+ * - `Ep*` 服务名与 `ClickOutside` / `Mousewheel` / `TrapFocus` / `vRepeatClick` /
+ *   `vLoading` 等指令均指向本地实现。
+ * - `vInfiniteScroll` 与 `EpInfiniteScroll` 是同一 InfiniteScroll 指令对象，
+ *   注册名均为 `InfiniteScroll`（需求 6.1 / 6.2）。
+ * - 契约常量、默认值与公开类型同样来自本地实现，公开名与迁移前一致（需求 9.3）。
+ */
+export { EpMessage, MESSAGE_DEFAULT_PLACEMENT, messageDefaults, messageEmits, messagePlacement, messageProps, messageTypes, } from './components/message';
+export type { Message, MessageConfigContext, MessageEmits, MessageFn, MessageHandler, MessageInstance, MessageOptions, MessageOptionsWithType, MessageParams, MessageParamsNormalized, MessageParamsWithType, MessagePlacement, MessageProps, MessagePropsPublic, MessageType, MessageTypedFn, messageType, } from './components/message';
+export { EpNotification, notificationEmits, notificationProps, notificationTypes, } from './components/notification';
+export type { NotificationEmits, NotificationHandle, NotificationInstance, NotificationOptions, NotificationOptionsTyped, NotificationParams, NotificationParamsTyped, NotificationPosition, NotificationProps, NotificationPropsPublic, NotificationQueue, NotificationQueueItem, NotificationType, Notify, NotifyFn, NotifyTypedFn, } from './components/notification';
+export { EpLoading, vLoading } from './components/loading';
+export type { LoadingInstance, LoadingOptions, LoadingOptionsResolved, LoadingParentElement, } from './components/loading';
+export { EpMessageBox } from './components/message-box';
+export type { Action, Callback, CloseFn, ElMessageBoxOptions as MessageBoxOptions, ElMessageBoxShortcutMethod as MessageBoxShortcutMethod, IElMessageBox as IMessageBox, MessageBoxActionHandlers, MessageBoxData, MessageBoxInputData, MessageBoxInputValidator, MessageBoxState, MessageBoxType, } from './components/message-box';
+export { EpInfiniteScroll, vInfiniteScroll } from './components/infinite-scroll';
+export { ClickOutside, Mousewheel, TrapFocus, vRepeatClick, } from './directives';
+export { messageConfig } from './components/config-provider';
 export declare const EpCraft: Plugin;
 export default EpCraft;

package/dist/public-components.d.ts

@@ -0,0 +1,10 @@
+/**
+ * 公开组件清单 —— 包入口、组件 barrel、按需导入解析器与发布门禁共用的单一事实来源。
+ *
+ * 顺序即 `src/components/index.ts` 的生成顺序。只登记已源码化并公开的 `Ep*` 组件；
+ * 未包装的 `AvatarGroup`、`InputOtp`、`InputTag`、`Splitter`、`SplitterPanel`
+ * 不在本清单中，也不得出现在任何公开入口。
+ */
+export declare const publicComponents: readonly ["EpAffix", "EpAlert", "EpAutocomplete", "EpAvatar", "EpBacktop", "EpBadge", "EpBreadcrumb", "EpBreadcrumbItem", "EpButton", "EpButtonGroup", "EpCalendar", "EpCard", "EpCarousel", "EpCarouselItem", "EpCascader", "EpCascaderPanel", "EpCheckTag", "EpCheckbox", "EpCheckboxButton", "EpCheckboxGroup", "EpCol", "EpCollapse", "EpCollapseItem", "EpCollapseTransition", "EpColorPicker", "EpConfigProvider", "EpContainer", "EpAside", "EpFooter", "EpHeader", "EpMain", "EpDatePicker", "EpDatePickerPanel", "EpDescriptions", "EpDescriptionsItem", "EpDialog", "EpDivider", "EpDrawer", "EpDropdown", "EpDropdownItem", "EpDropdownMenu", "EpEmpty", "EpForm", "EpFormItem", "EpIcon", "EpImage", "EpImageViewer", "EpInput", "EpInputNumber", "EpLink", "EpMenu", "EpMenuItem", "EpMenuItemGroup", "EpSubMenu", "EpOption", "EpOptionGroup", "EpPageHeader", "EpPagination", "EpPopconfirm", "EpPopover", "EpPopper", "EpProgress", "EpRadio", "EpRadioButton", "EpRadioGroup", "EpRate", "EpResult", "EpRow", "EpScrollbar", "EpSelect", "EpSelectV2", "EpSkeleton", "EpSkeletonItem", "EpSlider", "EpSpace", "EpStatistic", "EpCountdown", "EpSteps", "EpStep", "EpSwitch", "EpTable", "EpTableColumn", "EpTableV2", "EpTabs", "EpTabPane", "EpTag", "EpText", "EpTimePicker", "EpTimeSelect", "EpTimeline", "EpTimelineItem", "EpTooltip", "EpTransfer", "EpTree", "EpTreeSelect", "EpTreeV2", "EpUpload", "EpWatermark", "EpTour", "EpTourStep", "EpAnchor", "EpAnchorLink", "EpSegmented", "EpMention"];
+export type PublicComponentName = (typeof publicComponents)[number];
+export declare function isPublicComponent(name: string): name is PublicComponentName;