@gct-paas/core-web

@gct-paas/core-web

PaaS 平台 Web 端公共层底包。在 @gct-paas/core 之上挂载 Web UI 运行时（消息、确认、弹层、表单/表格编辑器注册），并提供 ant-design-vue、Monaco、公式编辑器、DND 等 Web 专属模块。

本文档面向后续开发与 AI 模型阅读。未引入本包时，_gct.message / confirm / openUtil 不可用。

包信息

import { coreWebSetupApp, coreWebCreateAppVue } from '@gct-paas/core-web';
// 引入即 onInit()，挂载 _gct UI 能力与 register.*

在 monorepo 中的位置

core
 ├── core-components / v-ben / scss
 └── core-web（Web 公共层，挂载 _gct UI）
       ├── design → design-web
       └── render → render-web

规划中：core-mobile / core-pad 为端侧对等层（仓库暂未包含）。

依赖说明

关键 workspace 依赖

主要 UI / 工具依赖

源码结构

packages/core-web/src/
├── index.ts              # onInit → 挂载 _gct
├── setup-app.ts          # coreWebSetupApp（locale）
├── create-app-vue.ts     # coreWebCreateAppVue（Antdv、表单、表格、Modal…）
├── modules/
│   ├── gct-form/         # 表单编辑器 + FormItemRegister
│   ├── gct-table/        # 表格编辑器 + TableEditorRegister
│   ├── formula-editor/   # 公式
│   ├── gct-dnd/          # 拖拽
│   ├── global-modal/     # 全局 Modal/Drawer
│   ├── code-editor/      # Monaco 封装
│   └── …                 # color-picker、print-tmpl、relationship-diagram 等
├── components/           # 通用 Web 组件
├── utils/                # MessageUtil、ConfirmUtil、overlay（openUtil）
└── styles/

与 _gct 的关系

引入本包时自动 onInit()，挂载 Web 端 UI 与注册中心：

_gct.confirm = new ConfirmUtil();
_gct.message = new MessageUtil();
_gct.openUtil = overlay;
_gct.register.editor = new EditorRegister();
_gct.register.formItem = new FormItemRegister();
_gct.register.tableEditor = new TableEditorRegister();

启动与用法

推荐启动顺序（Web 应用）：

import { setupApp, createAppVue } from '@gct-paas/core';
import { coreWebSetupApp, coreWebCreateAppVue } from '@gct-paas/core-web';
import '@gct-paas/core-web'; // 确保 onInit 执行（若未 transitively 引入）

const app = createApp(Root);

await setupApp(app);           // core：_gct.init、拦截器、平台配置
await coreWebSetupApp(app);    // 注册 core-web locale

createAppVue(app);             // core：i18n + router
coreWebCreateAppVue(app);      // Antdv、GctForm、GctTable、Modal…

app.mount('#app');

典型 import：

import { useNamespace, t, OverlayContainer } from '@gct-paas/core';
import { GctForm, BasicModal, useModal } from '@gct-paas/core-web';

主要导出速查

给后续模型的约束

1. Web 端需要 _gct.message.error() 等时，必须依赖并引入 @gct-paas/core-web。
2. 设计器/渲染器依赖本包的表单、表格、overlay，不要绕过 register.* 直接硬编码编辑器。
3. coreWebCreateAppVue 会调用 coreComponentsCreateAppVue，无需重复注册跨端组件。
4. 新 Web 组件放 components/ 或 modules/，遵循 BEM + TSX 规范。

本地命令

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