@gct-paas/render

@gct-paas/render

PaaS 平台渲染引擎底包。负责将设计 schema 渲染为运行时页面：设计渲染 controller/state、Event 引擎、表达式、搜索 hooks、RenderNode 注册。挂载 _gct.register.render 与 window._kit。

本文档面向后续开发与 AI 模型阅读：说明渲染注册机制及与 render-web 的分工。

包信息

import { renderSetupApp, RenderRegister, RenderNodeRegister } from '@gct-paas/render';
// 引入即 onInit() → register.render + window._kit

在 monorepo 中的位置

core → core-web → render（渲染引擎）
                      └── render-web（Web 渲染产品层）

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

依赖说明

关键 workspace 依赖

主要工具依赖

源码结构

packages/render/src/
├── index.ts              # onInit → register.render + _kit
├── setup-app.ts          # renderSetupApp（locale）
├── register/             # RenderRegister、RenderNodeRegister
├── components/           # design-render、design-render-item
├── controller/           # 渲染 controller 层级
├── state/                # Pinia/状态：design-render*
├── Event/                # 页面事件引擎、依赖规则、bizService
├── providers/            # 节点 provider 扩展
├── hooks/                # useDesignRenderController 等
├── utils/                # 表达式、搜索、插件包、field-attrs
├── modules/vue3-dnd/     # 运行时 DND
└── constant/             # 数据格式、日期等

与 _gct 的关系

引入时自动挂载（防重复）：

_gct.register.render = new RenderRegister();

// 插件/套件扩展容器（只读空对象，由各 kit 写入）
Object.defineProperty(window, '_kit', {
  value: {},
  writable: false,
  configurable: false,
});

运行时还依赖 core-web 的 _gct.message、mqtt、store、router 等。

启动与用法

import { setupApp, createAppVue } from '@gct-paas/core';
import { coreWebSetupApp, coreWebCreateAppVue } from '@gct-paas/core-web';
import { renderSetupApp } from '@gct-paas/render';

const app = createApp(Root);

await setupApp(app);
await coreWebSetupApp(app);
await renderSetupApp(app);     // 注册 render locale

createAppVue(app);
coreWebCreateAppVue(app);

app.mount('#app');

扩展渲染节点：

import {
  RenderNodeRegister,
  RenderNodeType,
  DesignRenderViewPrefix,
} from '@gct-paas/render';

RenderNodeRegister.register(
  RenderNodeType.FIELD,
  () => new MyFieldProvider(),
  DesignRenderViewPrefix.CARD_VIEW,
);

（Web 端 card-view 注册见 @gct-paas/render-web 的 renderWebSetupApp。）

主要导出速查

与 @gct-paas/render-web 的分工

给后续模型的约束

1. 新增渲染 provider → RenderNodeRegister + provider 类，类型对齐 schema。
2. 套件扩展写入 window._kit，不要替换整个 _kit 对象。
3. 页面事件/表达式逻辑放 Event/，避免在 render-web 重复实现引擎逻辑。
4. 重复引入 render 包会警告 register.render 已存在。

本地命令

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