@gct-paas/v-ben

PaaS 平台历史 v-ben UI 遗留包。提供 BasicTable、BasicButton、Dropdown 等早期表格/按钮组件，由 @gct-paas/core-web 间接消费。新功能优先在 core-web / core-components 实现，本包以维护为主。

本文档面向后续开发与 AI 模型阅读：标明 legacy 定位及与 core-web 的关系。

包信息

| 项 | 值 | | --- | --- | | 包名 | @gct-paas/v-ben | | 入口 | es/index.mjs（类型：es/index.d.ts） | | 全局类型 | @gct-paas/v-ben/types | | peer | @gct-paas/api、@gct-paas/core、@gct-paas/scss、vue>=3 |

import { BasicTable, BasicButton, vBenSetupApp } from '@gct-paas/v-ben';

在 monorepo 中的位置

core
 └── v-ben（legacy UI）
       └── core-web（主要消费者）

依赖说明

Peer Dependencies

| 依赖 | 用途 | | --- | --- | | @gct-paas/core | 工具、locale、全局类型 | | @gct-paas/scss | 组件样式 | | @gct-paas/api | 类型 |

Runtime Dependencies

| 依赖 | 用途 | | --- | --- | | ant-design-vue（@gct-paas/ant-design-vue） | 表格/按钮底层 UI | | sortablejs | 表格行拖拽 | | vue-types | props 类型辅助 |

源码结构

packages/v-ben/src/
├── components/
│   ├── v-ben-table/      # BasicTable 及 hooks
│   ├── v-ben-button/     # BasicButton、PopConfirmButton
│   └── v-ben-dropdown/   # Dropdown
├── hooks/                # useRefs、useDesign
├── utils/is.ts
├── locale/               # v-ben 文案，注册到 _gct.i18nUtil
├── setup-app.ts          # vBenSetupApp
└── index.ts

与 _gct 的关系

不挂载 _gct 成员，仅通过 locale 注册消费 i18n：

// setup-app.ts
export async function vBenSetupApp(_app: App): Promise<void> {
  registerVBenLocale(); // → _gct.i18nUtil.autoRegisterLocale(...)
}

启动与用法

由 core-web 宿主在应用启动链中调用（若项目仍依赖 v-ben 组件）：

import { vBenSetupApp } from '@gct-paas/v-ben';

await vBenSetupApp(app);

组件使用示例：

<script setup>
import { BasicTable, useTable } from '@gct-paas/v-ben';
</script>

主要导出速查

| 类别 | 示例 | | --- | --- | | 表格 | BasicTable、useTable、useColumns、usePagination | | 按钮 | BasicButton、PopConfirmButton | | 下拉 | Dropdown | | 工具 | is* 系列（utils/is） | | 启动 | vBenSetupApp |

给后续模型的约束

1. Legacy：新表格/按钮需求优先 core-web 的 gct-table / gct-form，勿在本包扩展大功能。
2. 修改文案走 locale/，通过 vBenSetupApp 注册，不要新建 i18n 实例。
3. 本包无 _gct.message 等 UI 能力，消息提示仍依赖 core-web 挂载。

本地命令

cd packages/v-ben
npm run dev
npm run build        # lint + vue-tsc + 双 Vite 构建