ep-craft 0.1.30 → 0.1.32

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

@@ -0,0 +1,102 @@
+import type { ExtractPublicPropTypes } from 'vue';
+import type { ComponentSize } from '@element-plus/constants';
+import type { AriaProps } from '@element-plus/hooks/use-aria';
+import type { CheckboxProps, CheckboxValueType } from '../../checkbox/src/checkbox';
+export type CheckboxGroupValueType = Exclude<CheckboxValueType, boolean>[];
+export type CheckboxOptionProps = {
+    value?: string;
+    label?: string;
+    disabled?: string;
+};
+export type CheckboxOption = CheckboxProps & Record<string, any>;
+export interface CheckboxGroupProps extends Pick<AriaProps, 'ariaLabel'> {
+    /**
+     * @description binding value
+     */
+    modelValue?: CheckboxGroupValueType;
+    /**
+     * @description whether the nesting checkboxes are disabled
+     */
+    disabled?: boolean;
+    /**
+     * @description minimum number of checkbox checked
+     */
+    min?: number;
+    /**
+     * @description maximum number of checkbox checked
+     */
+    max?: number;
+    /**
+     * @description size of checkbox
+     */
+    size?: ComponentSize;
+    /**
+     * @description border and background color when button is active
+     */
+    fill?: string;
+    /**
+     * @description font color when button is active
+     */
+    textColor?: string;
+    /**
+     * @description element tag of the checkbox group
+     */
+    tag?: string;
+    /**
+     * @description whether to trigger form validation
+     */
+    validateEvent?: boolean;
+    /**
+     * @description data of the options, the key of `value` and `label` and `disabled` can be customize by `props`
+     */
+    options?: CheckboxOption[];
+    /**
+     * @description configuration options
+     */
+    props?: CheckboxOptionProps;
+    /**
+     * @description component type to render options (e.g. `'button'`)
+     */
+    type?: 'checkbox' | 'button';
+}
+/**
+ * @description default values for CheckboxOptionProps
+ */
+export declare const checkboxDefaultProps: Required<CheckboxOptionProps>;
+/**
+ * @deprecated Removed after 3.0.0, Use `CheckboxGroupProps` instead.
+ */
+export declare const checkboxGroupProps: {
+    ariaLabel: StringConstructor;
+    modelValue: import("@element-plus/utils").EpPropFinalized<(new (...args: any[]) => CheckboxGroupValueType) | (() => CheckboxGroupValueType) | (((new (...args: any[]) => CheckboxGroupValueType) | (() => CheckboxGroupValueType)) | null)[], unknown, unknown, () => never[], boolean>;
+    disabled: import("@element-plus/utils").EpPropFinalized<BooleanConstructor, unknown, unknown, undefined, boolean>;
+    min: NumberConstructor;
+    max: NumberConstructor;
+    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;
+    };
+    fill: StringConstructor;
+    textColor: StringConstructor;
+    tag: import("@element-plus/utils").EpPropFinalized<StringConstructor, unknown, unknown, string, boolean>;
+    validateEvent: import("@element-plus/utils").EpPropFinalized<BooleanConstructor, unknown, unknown, boolean, boolean>;
+    options: {
+        readonly type: import("vue").PropType<CheckboxOption[]>;
+        readonly required: false;
+        readonly validator: ((val: unknown) => boolean) | undefined;
+        __epPropKey: true;
+    };
+    props: import("@element-plus/utils").EpPropFinalized<(new (...args: any[]) => CheckboxOptionProps) | (() => CheckboxOptionProps) | (((new (...args: any[]) => CheckboxOptionProps) | (() => CheckboxOptionProps)) | null)[], unknown, unknown, () => Required<CheckboxOptionProps>, boolean>;
+    type: import("@element-plus/utils").EpPropFinalized<StringConstructor, string, unknown, string, boolean>;
+};
+export declare const checkboxGroupEmits: {
+    "update:modelValue": (val: CheckboxGroupValueType) => boolean;
+    change: (val: CheckboxValueType[]) => boolean;
+};
+export type CheckboxGroupEmits = typeof checkboxGroupEmits;
+/**
+ * @deprecated Removed after 3.0.0, Use `CheckboxGroupProps` instead.
+ */
+export type CheckboxGroupPropsPublic = ExtractPublicPropTypes<typeof checkboxGroupProps>;

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

@@ -0,0 +1,84 @@
+import { UPDATE_MODEL_EVENT as r } from "../../../constants/event.js";
+import { useAriaProps as a } from "../../../hooks/use-aria/index.js";
+import { useSizeProp as i } from "../../../hooks/use-size/index.js";
+import { isArray as t } from "@vue/shared";
+import "lodash-unified";
+import "@vueuse/core";
+import "@element-plus/icons-vue";
+import { buildProps as p, definePropType as o } from "../../../utils/vue/props/runtime.js";
+import "vue";
+const l = {
+  label: "label",
+  value: "value",
+  disabled: "disabled"
+}, x = p({
+  /**
+   * @description binding value
+   */
+  modelValue: {
+    type: o(Array),
+    default: () => []
+  },
+  /**
+   * @description whether the nesting checkboxes are disabled
+   */
+  disabled: {
+    type: Boolean,
+    default: void 0
+  },
+  /**
+   * @description minimum number of checkbox checked
+   */
+  min: Number,
+  /**
+   * @description maximum number of checkbox checked
+   */
+  max: Number,
+  /**
+   * @description size of checkbox
+   */
+  size: i,
+  /**
+   * @description border and background color when button is active
+   */
+  fill: String,
+  /**
+   * @description font color when button is active
+   */
+  textColor: String,
+  /**
+   * @description element tag of the checkbox group
+   */
+  tag: {
+    type: String,
+    default: "div"
+  },
+  /**
+   * @description whether to trigger form validation
+   */
+  validateEvent: {
+    type: Boolean,
+    default: !0
+  },
+  options: {
+    type: o(Array)
+  },
+  props: {
+    type: o(Object),
+    default: () => l
+  },
+  type: {
+    type: String,
+    values: ["checkbox", "button"],
+    default: "checkbox"
+  },
+  ...a(["ariaLabel"])
+}), v = {
+  [r]: (e) => t(e),
+  change: (e) => t(e)
+};
+export {
+  l as checkboxDefaultProps,
+  v as checkboxGroupEmits,
+  x as checkboxGroupProps
+};

package/dist/components/container/container.d.ts

@@ -0,0 +1,35 @@
+/**
+ * EpContainer —— 从 element-plus 的 container 源码 vendored 而来（el -> ep 命名），
+ * 样式复用仓库内置的 theme-chalk/src/container.scss（命名空间为 el）。
+ *
+ * 本文件逐行镜像上游 `container.vue_vue_type_script_setup_true_lang.mjs` 的方向判定：
+ * 显式 `direction` 优先，否则扫描默认插槽子节点的组件名，命中 Header/Footer 即判垂直。
+ * 渲染语义标签 `<section>`，垂直时附 `is-vertical` 类名。
+ *
+ * 与上游判定逻辑的差异**恰为三处**（均属预期）：
+ * 1. 命名集合：本仓为 `['ElHeader', 'EpHeader', 'ElFooter', 'EpFooter']`，
+ *    相较上游 `['ElHeader', 'ElFooter']` **仅**多出 `Ep*` 两项——包装态把子组件名改写为
+ *    `EpHeader` / `EpFooter`，上游判定因此恒不成立；保留 `El*` 两项以兼容使用方嵌入
+ *    原生 element-plus 组件。这是本 spec 对上游逻辑的唯一有意偏离。
+ * 2. 取 `vNode.type.name` 前的类型窄化：上游 `.mjs` 是 SFC 编译产物，类型已擦除，
+ *    直接 `vNode.type.name`；本仓 strict 下须先判定 `type` 为非空对象再取 `name`
+ *    （非组件节点如原生元素/文本/注释的 `type` 非对象，天然不匹配）。此差异仅类型安全所需，
+ *    **不计为逻辑偏离**。
+ * 3. `direction` 的公开类型补回联合 `'horizontal' | 'vertical'`：上游 `.vue` 源码用
+ *    `defineProps<ContainerProps>()` 声明该联合，但 SFC 编译产物把它擦成
+ *    `props: { direction: { type: String, required: false } }`，公开类型退化为 `string`。
+ *    本仓显式声明 `ContainerProps` 并传给 `defineComponent<ContainerProps>` 以还原联合——
+ *    迁移前包装态（`typeof ElContainer`）对使用方暴露的正是该联合，故此举是维持对使用方的
+ *    透明性（需求 1.4）。**这不是 props 差异**：运行时 props 仍与上游编译产物逐字节一致
+ *    （无 `values`、无 `default`、无 dev 期校验），仅相对 `.mjs` 多一处类型声明、运行时零差异。
+ *
+ * 组件 `name` 固定为 `EpContainer`。
+ */
+interface ContainerProps {
+    /**
+     * @description layout direction for child elements
+     */
+    direction?: 'horizontal' | 'vertical';
+}
+declare const _default: import("vue").DefineComponent<ContainerProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<ContainerProps> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/components/container/container.js

@@ -0,0 +1,26 @@
+import { useNamespace as l } from "../../hooks/use-namespace/index.js";
+import { defineComponent as c, computed as s, openBlock as u, createElementBlock as p, normalizeClass as d, renderSlot as f } from "vue";
+const v = c({
+  name: "EpContainer",
+  props: {
+    direction: {
+      type: String,
+      required: !1
+    }
+  },
+  setup(n, { slots: e }) {
+    const o = l("container"), a = s(() => n.direction === "vertical" ? !0 : n.direction === "horizontal" ? !1 : e && e.default ? e.default().some((i) => {
+      const r = i.type, t = typeof r == "object" && r !== null ? r.name : void 0;
+      return t === "ElHeader" || t === "EpHeader" || t === "ElFooter" || t === "EpFooter";
+    }) : !1);
+    return () => (u(), p(
+      "section",
+      { class: d([o.b(), o.is("vertical", a.value)]) },
+      [f(e, "default")],
+      2
+    ));
+  }
+});
+export {
+  v as default
+};

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

@@ -1,4 +1,25 @@
 import type { Plugin } from 'vue';
-import { ElContainer } from 'element-plus';
-export declare const EpContainer: typeof ElContainer & Plugin;
+import _EpContainer from './container';
+import { EpAside } from '../aside';
+import { EpHeader } from '../header';
+import { EpMain } from '../main';
+import { EpFooter } from '../footer';
+/**
+ * EpContainer 自持 barrel：用本地安装辅助把容器本体注册为 `ep-container`
+ * （对外注册名与迁移前一致），并挂载 4 个子组件访问入口指向**本地**叶组件。
+ *
+ * 与上游 element-plus 的**有意偏离**：上游 `ElContainer.install` 会一并全局注册
+ * 4 个子组件（`app.use(ElContainer)` 等价于注册 5 个组件）；此处只注册 `ep-container`，
+ * 访问入口仅作静态引用挂载。需求 4.3 只要求访问入口可用，未要求该注册语义，
+ * 故不改动被约 90 个组件共用的 `src/utils/with-install.ts`（见 research.md 的
+ * Decision「不扩展共享的 withInstall」）。
+ *
+ * 不使用 `export *`：`container.ts` 内的 `ContainerProps` 等声明不外泄到主入口。
+ */
+export declare const EpContainer: typeof _EpContainer & Plugin & {
+    Aside: typeof EpAside;
+    Header: typeof EpHeader;
+    Main: typeof EpMain;
+    Footer: typeof EpFooter;
+};
 export default EpContainer;

package/dist/components/container/index.js

@@ -1,6 +1,15 @@
-import { ElContainer as n } from "element-plus";
-import { withInstall as t } from "../../utils/with-install.js";
-const o = Object.assign({}, n, { name: "EpContainer" }), i = t(o, "ep-container");
+import { withInstall as o } from "../../utils/with-install.js";
+import r from "./container.js";
+import { EpAside as t } from "../aside/index.js";
+import { EpHeader as i } from "../header/index.js";
+import { EpMain as e } from "../main/index.js";
+import { EpFooter as p } from "../footer/index.js";
+const d = Object.assign(o(r, "ep-container"), {
+  Aside: t,
+  Header: i,
+  Main: e,
+  Footer: p
+});
 export {
-  i as EpContainer
+  d as EpContainer
 };

package/dist/components/date-picker/src/date-picker.d.ts

@@ -410,14 +410,14 @@ declare const _default: import("vue").DefineComponent<import("vue").ExtractPropT
     readonly modelValue: import("../../../utils").EpPropMergeType<(new (...args: any[]) => string | number | string[] | Date | number[] | Date[]) | (() => import("@element-plus/components/time-picker").ModelValueType | null) | (((new (...args: any[]) => string | number | string[] | Date | number[] | Date[]) | (() => import("@element-plus/components/time-picker").ModelValueType | null)) | null)[], unknown, unknown>;
     readonly valueOnClear: import("../../../utils").EpPropMergeType<(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>;
     readonly floatLabel: import("../../../utils").EpPropMergeType<BooleanConstructor, unknown, unknown>;
-    readonly readonly: boolean;
-    readonly clearable: import("../../../utils").EpPropMergeType<BooleanConstructor, unknown, unknown>;
+    readonly fallbackPlacements: import("element-plus").Placement[];
+    readonly popperOptions: Partial<import("element-plus").Options>;
+    readonly popperStyle: import("vue").StyleValue;
     readonly clearIcon: import("../../../utils").EpPropMergeType<(new (...args: any[]) => (string | import("vue").Component) & {}) | (() => string | import("vue").Component) | (((new (...args: any[]) => (string | import("vue").Component) & {}) | (() => string | import("vue").Component)) | null)[], unknown, unknown>;
     readonly prefixIcon: import("../../../utils").EpPropMergeType<(new (...args: any[]) => (string | import("vue").Component) & {}) | (() => string | import("vue").Component) | (((new (...args: any[]) => (string | import("vue").Component) & {}) | (() => string | import("vue").Component)) | null)[], unknown, unknown>;
     readonly validateEvent: import("../../../utils").EpPropMergeType<BooleanConstructor, unknown, unknown>;
-    readonly popperStyle: import("vue").StyleValue;
-    readonly fallbackPlacements: import("element-plus").Placement[];
-    readonly popperOptions: Partial<import("element-plus").Options>;
+    readonly readonly: boolean;
+    readonly clearable: import("../../../utils").EpPropMergeType<BooleanConstructor, unknown, unknown>;
     readonly automaticDropdown: import("../../../utils").EpPropMergeType<BooleanConstructor, unknown, unknown>;
     readonly editable: import("../../../utils").EpPropMergeType<BooleanConstructor, unknown, unknown>;
     readonly saveOnBlur: import("../../../utils").EpPropMergeType<BooleanConstructor, unknown, unknown>;

package/dist/components/footer/footer.d.ts

@@ -0,0 +1,28 @@
+/**
+ * EpFooter —— 从 element-plus 的 container/footer 源码 vendored 而来（el -> ep 命名），
+ * 样式复用仓库内置的 theme-chalk/src/footer.scss（命名空间为 el）。
+ *
+ * 本文件逐行镜像上游 `footer.vue_vue_type_script_setup_true_lang.mjs`：
+ * 可选 `height` prop → `cssVarBlock` 内联样式 → 渲染语义标签 `<footer>` → 透传默认插槽。
+ * `height` 缺省时不生成内联样式，由 theme-chalk 的 CSS 变量默认值兜底。
+ *
+ * 组件 `name` 固定为 `EpFooter`：Container 的方向判定集合依赖该名。
+ */
+declare const _default: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+    height: {
+        type: (StringConstructor | null)[];
+        required: false;
+        default: null;
+    };
+}>, () => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
+    [key: string]: any;
+}>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+    height: {
+        type: (StringConstructor | null)[];
+        required: false;
+        default: null;
+    };
+}>> & Readonly<{}>, {
+    height: string | null;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+export default _default;

package/dist/components/footer/footer.js

@@ -0,0 +1,29 @@
+import { useNamespace as r } from "../../hooks/use-namespace/index.js";
+import { defineComponent as n, computed as s, openBlock as a, createElementBlock as c, normalizeStyle as i, normalizeClass as m, renderSlot as p } from "vue";
+const h = n({
+  name: "EpFooter",
+  props: {
+    height: {
+      type: [String, null],
+      required: !1,
+      default: null
+    }
+  },
+  setup(e, { slots: o }) {
+    const t = r("footer"), l = s(
+      () => e.height ? t.cssVarBlock({ height: e.height }) : {}
+    );
+    return () => (a(), c(
+      "footer",
+      {
+        class: m(t.b()),
+        style: i(l.value)
+      },
+      [p(o, "default")],
+      6
+    ));
+  }
+});
+export {
+  h as default
+};

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

@@ -1,4 +1,4 @@
 import type { Plugin } from 'vue';
-import { ElFooter } from 'element-plus';
-export declare const EpFooter: typeof ElFooter & Plugin;
+import _EpFooter from './footer';
+export declare const EpFooter: typeof _EpFooter & Plugin;
 export default EpFooter;

package/dist/components/footer/index.js

@@ -1,6 +1,6 @@
-import { ElFooter as o } from "element-plus";
-import { withInstall as t } from "../../utils/with-install.js";
-const r = Object.assign({}, o, { name: "EpFooter" }), m = t(r, "ep-footer");
+import { withInstall as o } from "../../utils/with-install.js";
+import t from "./footer.js";
+const e = o(t, "ep-footer");
 export {
-  m as EpFooter
+  e as EpFooter
 };

package/dist/components/header/header.d.ts

@@ -0,0 +1,28 @@
+/**
+ * EpHeader —— 从 element-plus 的 container/header 源码 vendored 而来（el -> ep 命名），
+ * 样式复用仓库内置的 theme-chalk/src/header.scss（命名空间为 el）。
+ *
+ * 本文件逐行镜像上游 `header.vue_vue_type_script_setup_true_lang.mjs`：
+ * 可选 `height` prop → `cssVarBlock` 内联样式 → 渲染语义标签 `<header>` → 透传默认插槽。
+ * `height` 缺省时不生成内联样式，由 theme-chalk 的 CSS 变量默认值兜底。
+ *
+ * 组件 `name` 固定为 `EpHeader`：Container 的方向判定集合依赖该名。
+ */
+declare const _default: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+    height: {
+        type: (StringConstructor | null)[];
+        required: false;
+        default: null;
+    };
+}>, () => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
+    [key: string]: any;
+}>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+    height: {
+        type: (StringConstructor | null)[];
+        required: false;
+        default: null;
+    };
+}>> & Readonly<{}>, {
+    height: string | null;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+export default _default;

package/dist/components/header/header.js

@@ -0,0 +1,29 @@
+import { useNamespace as a } from "../../hooks/use-namespace/index.js";
+import { defineComponent as o, computed as n, openBlock as s, createElementBlock as c, normalizeStyle as d, normalizeClass as i, renderSlot as m } from "vue";
+const h = o({
+  name: "EpHeader",
+  props: {
+    height: {
+      type: [String, null],
+      required: !1,
+      default: null
+    }
+  },
+  setup(e, { slots: l }) {
+    const t = a("header"), r = n(
+      () => e.height ? t.cssVarBlock({ height: e.height }) : {}
+    );
+    return () => (s(), c(
+      "header",
+      {
+        class: i(t.b()),
+        style: d(r.value)
+      },
+      [m(l, "default")],
+      6
+    ));
+  }
+});
+export {
+  h as default
+};

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

@@ -1,4 +1,4 @@
 import type { Plugin } from 'vue';
-import { ElHeader } from 'element-plus';
-export declare const EpHeader: typeof ElHeader & Plugin;
+import _EpHeader from './header';
+export declare const EpHeader: typeof _EpHeader & Plugin;
 export default EpHeader;

package/dist/components/header/index.js

@@ -1,6 +1,6 @@
-import { ElHeader as e } from "element-plus";
-import { withInstall as r } from "../../utils/with-install.js";
-const a = Object.assign({}, e, { name: "EpHeader" }), p = r(a, "ep-header");
+import { withInstall as e } from "../../utils/with-install.js";
+import r from "./header.js";
+const t = e(r, "ep-header");
 export {
-  p as EpHeader
+  t as EpHeader
 };