ep-craft 0.1.32 → 0.1.34

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

@@ -1,4 +1,57 @@
-import type { Plugin } from 'vue';
-import { ElTable } from 'element-plus';
-export declare const EpTable: typeof ElTable & Plugin;
+import type { ComponentInstance, Plugin } from 'vue';
+import type { ComponentExposed } from 'vue-component-type-helpers';
+import { EpTableColumn } from '../table-column';
+import _EpTable from './src/table.vue';
+/**
+ * table 自持 barrel：用**本地**安装辅助把搬运来的表格本体注册为 `ep-table`
+ * ——对外注册名与迁移前的包装态**逐字相同**（需求 6.2）。
+ *
+ * 形态对齐 `src/components/container/index.ts`（自持本体 + 挂载子组件访问入口）。
+ * 与迁移前的 `Object.assign({}, ElTable, { name: 'EpTable' })` 包装态的关键差异：
+ * 本体不再来自 `element-plus`，故本入口模块**零 element-plus 引用**（需求 1.3）。
+ *
+ * **必须用 `../../utils/with-install`（本地版），不得误用 `../../utils/vue/install`（上游版）**：
+ * 二者同名而签名不同——本地版 `withInstall(component, name: string)` 按**显式注册名**注册；
+ * 上游版 `withInstall(main, extra?)` 按 `comp.name` 注册，并把 `extra` 交给 `Object.values()`
+ * 展开。若误用上游版，第二参字符串会被**逐字符展开**，`ep-table` **静默注册失败**。
+ *
+ * **子组件访问入口**（需求 5.3）：`Object.assign` 挂载 `TableColumn` 指向**本地**列组件。
+ * 与上游 element-plus 的**有意偏离**：上游 `ElTable.install` 会一并全局注册子组件；
+ * 此处只注册 `ep-table`，访问入口仅作静态引用挂载。需求 5.3 只要求访问入口可用，
+ * 未要求该注册语义，故不改动被约 90 个组件共用的 `src/utils/with-install.ts`
+ * （同 `container/index.ts` 的处置，见 `research.md` 的 Decision「不扩展共享的 withInstall」）。
+ *
+ * **不导出 `ElTable` 别名**（需求 5.6）：本仓的 `El*` 别名只服务于「过渡期仍需用上游
+ * 组件」的场景；本体已自持后，别名只会与 `EpTable` 争抢同一个 `.install`。
+ *
+ * **不导出 `tableEmits`**（design.md 决策 6）：上游**没有**该运行时常量，emits 侧只有
+ * `TableEmits<T>` 类型声明。需求 5.5 的「emits 常量」在此落为**类型交付**——凭空造一个
+ * 运行时常量会新增上游没有的契约面，与需求 1.6「不因本切片而增删」冲突。
+ *
+ * **不使用 `export *`**：公开面按契约显式列出，避免 `table/defaults.ts` 的内部声明
+ * 外泄到主入口（与 `checkbox` / `container` / `backtop` 一致）。
+ */
+export declare const EpTable: typeof _EpTable & Plugin & {
+    TableColumn: typeof EpTableColumn;
+};
 export default EpTable;
+/** 上游运行时常量（需求 5.5）：使用方可直接引用该 props 契约。 */
+export { tableProps } from './src/table/defaults';
+/**
+ * 表格的公开实例类型。
+ *
+ * 对应上游 `es/components/table/src/table.vue.d.ts` 的 `TableInstance`
+ * （上游写作 `ComponentInstance<typeof _default> & ComponentExposed<typeof _default>`）。
+ * 本地本体是 SFC，与上游同源，故两项照抄即可，无需像 `autocomplete` 那样手写转录
+ * expose 载荷（详见 `src/components/autocomplete/instance.ts` 的长注释）。
+ */
+export type TableInstance = ComponentInstance<typeof _EpTable> & ComponentExposed<typeof _EpTable>;
+/**
+ * 上游 `components/table/index.ts` barrel 的类型清单（需求 5.4 / 5.5）。
+ *
+ * 与 `table/defaults.ts` 的 `export type { ... }` 面一一对应，无新增、无删减；
+ * `DefaultRow` / `TreeProps` / `TableSortOrder` / `RenderExpanded` 四项是上游
+ * `defaults.ts` 导出但上游 barrel 未转出的，此处一并转出以免本地公开面比
+ * 使用方经由 `element-plus` 根入口拿到的更窄。
+ */
+export type { CellCls, CellStyle, ColumnCls, ColumnStyle, DefaultRow, Filter, RenderExpanded, RenderRowData, Sort, SummaryMethod, Table, TableColumnCtx, TableConfigContext, TableEmits, TableProps, TableRefs, TableSortOrder, TableTooltipData, TreeNode, TreeProps, } from './src/table/defaults';

package/dist/components/table/index.js

@@ -1,6 +1,22 @@
-import { ElTable as e } from "element-plus";
-import { withInstall as t } from "../../utils/with-install.js";
-const a = Object.assign({}, e, { name: "EpTable" }), p = t(a, "ep-table");
+import { withInstall as o } from "../../utils/with-install.js";
+import { EpTableColumn as m } from "../table-column/index.js";
+import t from "./src/table.vue.js";
+import "vue";
+import "@vue/shared";
+import "lodash-unified";
+import "@vueuse/core";
+import "@element-plus/icons-vue";
+import "../../hooks/use-size/index.js";
+import "@popperjs/core";
+import "../../hooks/use-z-index/index.js";
+import "../../hooks/use-delayed-toggle/index.js";
+import "../../hooks/use-aria/index.js";
+import "../../hooks/use-model-toggle/index.js";
+import "../../hooks/use-empty-values/index.js";
+const _ = Object.assign(
+  o(t, "ep-table"),
+  { TableColumn: m }
+);
 export {
-  p as EpTable
+  _ as EpTable
 };

package/dist/components/table/src/composables/use-scrollbar.d.ts

@@ -0,0 +1,6 @@
+export declare const useScrollbar: () => {
+    scrollBarRef: import("vue").Ref<any, any>;
+    scrollTo: (options: ScrollToOptions | number, yCoord?: number) => void;
+    setScrollTop: (top?: number) => void;
+    setScrollLeft: (left?: number) => void;
+};

package/dist/components/table/src/composables/use-scrollbar.js

@@ -0,0 +1,24 @@
+import { ref as e } from "vue";
+import { isNumber as i } from "../../../../utils/types.js";
+import "lodash-unified";
+import "@vueuse/core";
+import "@vue/shared";
+import "@element-plus/icons-vue";
+const b = () => {
+  const t = e(), s = (o, l) => {
+    const r = t.value;
+    r && r.scrollTo(o, l);
+  }, c = (o, l) => {
+    const r = t.value;
+    r && i(l) && ["Top", "Left"].includes(o) && r[`setScroll${o}`](l);
+  };
+  return {
+    scrollBarRef: t,
+    scrollTo: s,
+    setScrollTop: (o) => c("Top", o),
+    setScrollLeft: (o) => c("Left", o)
+  };
+};
+export {
+  b as useScrollbar
+};

package/dist/components/table/src/config.d.ts

@@ -0,0 +1,87 @@
+import type { VNode } from 'vue';
+import type { TableColumnCtx } from './table-column/defaults';
+import type { Store } from './store';
+import type { DefaultRow, TreeNode } from './table/defaults';
+export declare const cellStarts: {
+    default: {
+        order: string;
+    };
+    selection: {
+        width: number;
+        minWidth: number;
+        realWidth: number;
+        order: string;
+    };
+    expand: {
+        width: number;
+        minWidth: number;
+        realWidth: number;
+        order: string;
+    };
+    index: {
+        width: number;
+        minWidth: number;
+        realWidth: number;
+        order: string;
+    };
+};
+export declare const getDefaultClassName: (type: string) => "table-column--selection" | "table__expand-column";
+export declare const cellForced: {
+    selection: {
+        renderHeader<T extends DefaultRow>({ store }: {
+            store: Store<T>;
+        }): VNode<import("vue").RendererNode, import("vue").RendererElement, {
+            [key: string]: any;
+        }>;
+        renderCell<T extends DefaultRow>({ row, column, store, $index, }: {
+            row: T;
+            column: TableColumnCtx<T>;
+            store: Store<T>;
+            $index: number;
+        }): VNode<import("vue").RendererNode, import("vue").RendererElement, {
+            [key: string]: any;
+        }>;
+        sortable: boolean;
+        resizable: boolean;
+    };
+    index: {
+        renderHeader<T extends DefaultRow>({ column, }: {
+            column: TableColumnCtx<T>;
+        }): string;
+        renderCell<T extends DefaultRow>({ column, $index, }: {
+            column: TableColumnCtx<T>;
+            $index: number;
+        }): VNode<import("vue").RendererNode, import("vue").RendererElement, {
+            [key: string]: any;
+        }>;
+        sortable: boolean;
+    };
+    expand: {
+        renderHeader<T extends DefaultRow>({ column, }: {
+            column: TableColumnCtx<T>;
+        }): string;
+        renderCell<T extends DefaultRow>({ column, row, store, expanded, $index, }: {
+            column: TableColumnCtx<T>;
+            row: T;
+            store: Store<T>;
+            expanded: boolean;
+            $index: number;
+        }): VNode<import("vue").RendererNode, import("vue").RendererElement, {
+            [key: string]: any;
+        }>;
+        sortable: boolean;
+        resizable: boolean;
+    };
+};
+export declare function defaultRenderCell<T extends DefaultRow>({ row, column, $index, }: {
+    row: T;
+    column: TableColumnCtx<T>;
+    $index: number;
+}): any;
+export declare function treeCellPrefix<T extends DefaultRow>({ row, treeNode, store, }: {
+    row: T;
+    treeNode: TreeNode;
+    store: Store<T>;
+}, createPlaceholder?: boolean): VNode<import("vue").RendererNode, import("vue").RendererElement, {
+    [key: string]: any;
+}>[] | null;

package/dist/components/table/src/config.js

@@ -0,0 +1,210 @@
+import { h as i } from "vue";
+import { EpCheckbox as u } from "../../checkbox/index.js";
+import { ElIcon as b } from "../../icon/index.js";
+import { ArrowRight as f, Loading as x } from "@element-plus/icons-vue";
+import { isBoolean as g, isNumber as h } from "../../../utils/types.js";
+import "lodash-unified";
+import "@vueuse/core";
+import { isFunction as C } from "@vue/shared";
+import { getProp as L } from "../../../utils/objects.js";
+const R = {
+  selection: "table-column--selection",
+  expand: "table__expand-column"
+}, P = {
+  default: {
+    order: ""
+  },
+  selection: {
+    width: 48,
+    minWidth: 48,
+    realWidth: 48,
+    order: ""
+  },
+  expand: {
+    width: 48,
+    minWidth: 48,
+    realWidth: 48,
+    order: ""
+  },
+  index: {
+    width: 48,
+    minWidth: 48,
+    realWidth: 48,
+    order: ""
+  }
+}, H = (e) => R[e] || "", V = {
+  selection: {
+    renderHeader({ store: e }) {
+      function a() {
+        return e.states.data.value && e.states.data.value.length === 0;
+      }
+      return i(u, {
+        disabled: a(),
+        size: e.states.tableSize.value,
+        indeterminate: e.states.selection.value.length > 0 && !e.states.isAllSelected.value,
+        "onUpdate:modelValue": e.toggleAllSelection ?? void 0,
+        modelValue: e.states.isAllSelected.value,
+        ariaLabel: e.t("el.table.selectAllLabel")
+      });
+    },
+    renderCell({
+      row: e,
+      column: a,
+      store: l,
+      $index: n
+    }) {
+      return i(u, {
+        disabled: a.selectable ? !a.selectable.call(null, e, n) : !1,
+        size: l.states.tableSize.value,
+        onChange: () => {
+          l.commit("rowSelectedChanged", e);
+        },
+        onClick: (t) => t.stopPropagation(),
+        modelValue: l.isSelected(e),
+        indeterminate: l.getRowIndeterminate(e),
+        ariaLabel: l.t("el.table.selectRowLabel")
+      });
+    },
+    sortable: !1,
+    resizable: !1
+  },
+  index: {
+    renderHeader({
+      column: e
+    }) {
+      return e.label || "#";
+    },
+    renderCell({
+      column: e,
+      $index: a
+    }) {
+      let l = a + 1;
+      const n = e.index;
+      return h(n) ? l = a + n : C(n) && (l = n(a)), i("div", {}, [l]);
+    },
+    sortable: !1
+  },
+  expand: {
+    renderHeader({
+      column: e
+    }) {
+      return e.label || "";
+    },
+    renderCell({
+      column: e,
+      row: a,
+      store: l,
+      expanded: n,
+      $index: t
+    }) {
+      var p, c;
+      const { ns: r } = l, d = [r.e("expand-icon")];
+      !e.renderExpand && n && d.push(r.em("expand-icon", "expanded"));
+      const o = function(m) {
+        m.stopPropagation(), l.toggleRowExpansion(a);
+      }, s = ((c = (p = l.states.rowExpandable).value) == null ? void 0 : c.call(p, a, t)) ?? !0;
+      return s || d.push(r.is("disabled")), i(
+        "button",
+        {
+          type: "button",
+          disabled: !s,
+          "aria-label": l.t(
+            n ? "el.table.collapseRowLabel" : "el.table.expandRowLabel"
+          ),
+          "aria-expanded": n,
+          class: d,
+          onClick: o
+        },
+        {
+          default: () => e.renderExpand ? [
+            e.renderExpand({
+              expanded: n,
+              expandable: s
+            })
+          ] : [
+            i(b, null, {
+              default: () => [i(f)]
+            })
+          ]
+        }
+      );
+    },
+    sortable: !1,
+    resizable: !1
+  }
+};
+function D({
+  row: e,
+  column: a,
+  $index: l
+}) {
+  var r;
+  const n = a.property, t = n && L(e, n).value;
+  return a && a.formatter ? a.formatter(e, a, t, l) : ((r = t == null ? void 0 : t.toString) == null ? void 0 : r.call(t)) || "";
+}
+function F({
+  row: e,
+  treeNode: a,
+  store: l
+}, n = !1) {
+  const { ns: t } = l;
+  if (!a)
+    return n ? [
+      i("span", {
+        class: t.e("placeholder")
+      })
+    ] : null;
+  const r = [], d = function(o) {
+    o.stopPropagation(), !a.loading && l.loadOrToggle(e);
+  };
+  if (a.indent && r.push(
+    i("span", {
+      class: t.e("indent"),
+      style: { "padding-left": `${a.indent}px` }
+    })
+  ), g(a.expanded) && !a.noLazyChildren) {
+    const o = [
+      t.e("expand-icon"),
+      a.expanded ? t.em("expand-icon", "expanded") : ""
+    ];
+    let s = f;
+    a.loading && (s = x), r.push(
+      i(
+        "button",
+        {
+          type: "button",
+          "aria-label": l.t(
+            a.expanded ? "el.table.collapseRowLabel" : "el.table.expandRowLabel"
+          ),
+          "aria-expanded": a.expanded,
+          class: o,
+          onClick: d
+        },
+        {
+          default: () => [
+            i(
+              b,
+              { class: t.is("loading", a.loading) },
+              {
+                default: () => [i(s)]
+              }
+            )
+          ]
+        }
+      )
+    );
+  } else
+    r.push(
+      i("span", {
+        class: t.e("placeholder")
+      })
+    );
+  return r;
+}
+export {
+  V as cellForced,
+  P as cellStarts,
+  D as defaultRenderCell,
+  H as getDefaultClassName,
+  F as treeCellPrefix
+};