@vtj/coder 0.17.8 → 0.18.0

package/package.json

@@ -1,9 +1,11 @@
 {
   "name": "@vtj/coder",
   "private": false,
-  "version": "0.17.8",
+  "version": "0.18.0",
   "type": "module",
   "keywords": [
+    "AI低代码",
+    "AI编程",
     "低代码引擎",
     "LowCode Engine",
     "Vue3低代码",
@@ -12,7 +14,7 @@
     "代码生成器",
     "代码可视化"
   ],
-  "description": "VTJ 是一款基于 Vue3 + Typescript 的低代码页面可视化设计器。内置低代码引擎、渲染器和代码生成器，面向前端开发者，开箱即用。 无缝嵌入本地开发工程，不改变前端开发流程和编码习惯。",
+  "description": "VVTJ.PRO 是一个开源的、AI 驱动的 Vue3 企业级应用开发平台，通过 AI 智能体与可视化编排实现高效开发，并支持导出标准 Vue 代码以避免平台锁定。",
   "repository": {
     "type": "git",
     "url": "https://gitee.com/newgateway/vtj.git"
@@ -22,11 +24,11 @@
   "license": "MIT",
   "dependencies": {
     "prettier": "~3.7.0",
-    "@vtj/core": "~0.17.8",
-    "@vtj/base": "~0.12.4"
+    "@vtj/base": "~0.13.0",
+    "@vtj/core": "~0.18.0"
   },
   "devDependencies": {
-    "@vtj/cli": "~0.12.20"
+    "@vtj/cli": "~0.13.0"
   },
   "exports": {
     ".": {

package/types/collecter.d.ts

@@ -11,8 +11,11 @@ export declare class Collecter {
     members: string[];
     urlSchemas: Record<string, NodeFromUrlSchema>;
     blockPlugins: Record<string, NodeFromPlugin>;
+    /** 配置了 easycom 的依赖包名集合，出码时不需要 import */
+    easycomPackages: Set<string>;
     private libraryRegex;
     constructor(dsl: BlockSchema, dependencies: Dependencie[]);
+    private collectEasycom;
     private collectLibrary;
     /**
      * 收集 import 信息

package/types/index.d.ts

@@ -1,3 +1,4 @@
 export { version as VTJ_CODER_VERSION } from './version';
 export * from './generator';
 export { tsFormatter, cssFormatter, vueFormatter } from './formatters';
+export { GLOBAL_API_MAP, UI_GLOBAL_API_MAPS, UI_PACKAGES, detectUIPackage, buildEffectiveApiMap, type GlobalApiConfig } from './parser/composition/globalApi';

package/types/parser/composition/composables.d.ts

@@ -0,0 +1,18 @@
+import { BlockComposable } from '@vtj/core';
+import { SymbolTable } from './symbolTable';
+export interface ComposableResult {
+    /** 顶层声明语句 */
+    statements: string[];
+    /** 需要 import 的标识符：{ from: [composable, ...] } */
+    imports: Record<string, string[]>;
+}
+/**
+ * 解析 composables：
+ * - { name: 'router', composable: { type: 'JSExpression', value: 'this.$libs.VueRouter.useRouter' } }
+ *   → const router = this.$libs.VueRouter.useRouter();
+ * - { composable: { type: 'JSExpression', value: 'useUserStore' }, destructure: ['user', 'login'] }
+ *   → const { user, login } = useUserStore();
+ * - { name: 'data', composable: { type: 'JSExpression', value: 'useFetch' }, args: ['/api'] }
+ *   → const data = useFetch('/api');
+ */
+export declare function parseComposables(composables: BlockComposable[] | undefined, symbols: SymbolTable): ComposableResult;

package/types/parser/composition/computed.d.ts

@@ -0,0 +1,8 @@
+import { JSExpression, JSFunction } from '@vtj/core';
+import { SymbolTable } from './symbolTable';
+/**
+ * 解析 computed 为 Composition 顶层声明：
+ * { total: { value: '() => this.count * 2' } }
+ *  → const total = computed(() => count.value * 2);
+ */
+export declare function parseComputed(computed: Record<string, JSFunction | JSExpression> | undefined, symbols: SymbolTable): string[];

package/types/parser/composition/globalApi.d.ts

@@ -0,0 +1,49 @@
+import { BlockSchema, MaterialDescription } from '@vtj/core';
+/**
+ * 全局 API 配置：DSL 中 this.$xxx 形式 → Composition API 等价物
+ */
+export interface GlobalApiConfig {
+    /** 需要 import 的标识符（如 useAttrs），无则为 null */
+    composable: string | null;
+    /** composable 的来源包（如 'vue'、'vue-router'） */
+    from: string;
+    /** 顶层声明语句（无则不生成） */
+    declare: string | null;
+    /** 替换后的名称（this.$attrs → attrs） */
+    replace: string;
+}
+/**
+ * 框架无关的基础全局 API 映射表
+ * 包含 Vue 原生、vue-router、vue-i18n、@vtj/renderer
+ * 不含任何 UI 库（element-plus / ant-design-vue 等）
+ */
+export declare const GLOBAL_API_MAP: Record<string, GlobalApiConfig>;
+/**
+ * UI 库专属全局 API 映射（按包名分组）
+ * 同名 key 会在运行时覆盖 GLOBAL_API_MAP 中的同名条目
+ */
+export declare const UI_GLOBAL_API_MAPS: Record<string, Record<string, GlobalApiConfig>>;
+/** 已知 UI 库包名列表 */
+export declare const UI_PACKAGES: string[];
+/**
+ * 从 componentMap 探测当前激活的 UI 库包名
+ */
+export declare function detectUIPackage(componentMap: Map<string, MaterialDescription>): string | null;
+/**
+ * 构建有效 API 映射：基础 Map + 当前 UI 库 Map（UI 库覆盖同名 key）
+ */
+export declare function buildEffectiveApiMap(uiPackage: string | null): Record<string, GlobalApiConfig>;
+/**
+ * 全局 API 检测器
+ * 走读 DSL 中所有 JSExpression / JSFunction 的 value 字符串
+ * 识别使用到的 this.$xxx，返回出现的 API 名集合
+ */
+export declare function detectGlobalApis(dsl: BlockSchema, effectiveMap?: Record<string, GlobalApiConfig>): Set<string>;
+/**
+ * 根据检测到的全局 API 生成顶层声明语句
+ */
+export declare function generateGlobalApiDeclares(apis: Set<string>, effectiveMap?: Record<string, GlobalApiConfig>): string[];
+/**
+ * 收集全局 API 需要导入的标识符，按来源包分组
+ */
+export declare function collectGlobalApiImports(apis: Set<string>, effectiveMap?: Record<string, GlobalApiConfig>): Record<string, string[]>;

package/types/parser/composition/imports.d.ts

@@ -0,0 +1,31 @@
+import { MaterialDescription, PlatformType } from '@vtj/core';
+export interface CompositionImportsInput {
+    /** 物料组件映射 */
+    componentMap: Map<string, MaterialDescription>;
+    /** template 中使用到的组件名 */
+    components: string[];
+    /** 区块导入语句（已为完整字符串） */
+    importBlocks: string[];
+    /** collecter 收集到的 imports（this.$libs.X.Y）*/
+    collectImports: Record<string, Set<string>>;
+    /** 平台 */
+    platform: PlatformType;
+    /** Vue 需要导入的 Composition API */
+    vueImports: string[];
+    /** composables 引入：{ from: [composable, ...] } */
+    composableImports: Record<string, string[]>;
+    /** 全局 API 引入（按来源包分组）：{ 'vue': ['useAttrs'], 'vue-router': ['useRouter'] } */
+    globalApiImports: Record<string, string[]>;
+    /** Uniapp 专用生命周期钩子（如 onLoad），需从 @dcloudio/uni-app 导入 */
+    uniHookImports: string[];
+    /** 配置了 easycom 的依赖包名集合，出码时不需要 import */
+    easycomPackages: Set<string>;
+}
+/**
+ * 解析 Composition 模式的所有 import
+ */
+export declare function parseImports(input: CompositionImportsInput): {
+    imports: string[];
+    uniComponents: string[];
+    componentDeclarations: string[];
+};

package/types/parser/composition/index.d.ts

@@ -0,0 +1,63 @@
+import { MaterialDescription, PlatformType } from '@vtj/core';
+import { Collecter } from '../../collecter';
+export interface TokenComposition {
+    id: string;
+    version: string;
+    name: string;
+    /** 顶层 imports（全部完整 import 语句） */
+    imports: string;
+    /** defineProps 内容 */
+    props: string;
+    /** defineEmits 列表（已带引号的字符串） */
+    emits: string;
+    /** 是否需要生成 defineProps（DSL 中使用了 this.$props） */
+    needsProps: boolean;
+    /** 是否需要生成 defineEmits（DSL 中使用了 this.$emit） */
+    needsEmit: boolean;
+    /** defineExpose 参数 */
+    expose: string;
+    /** 全局 API 顶层声明（const router = useRouter() 等） */
+    globalApiDeclares: string;
+    /** inject 顶层声明 */
+    injects: string;
+    /** composables 顶层声明 */
+    composables: string;
+    /** state（作为 reactive） */
+    state: string;
+    /** refs 顶层声明 */
+    refs: string;
+    /** reactives 顶层声明 */
+    reactives: string;
+    /** computed 顶层声明 */
+    computed: string;
+    /** methods 顶层声明 */
+    methods: string;
+    /** dataSources 顶层声明 */
+    dataSources: string;
+    /** watch 顶层调用 */
+    watch: string;
+    /** provide 顶层调用 */
+    provide: string;
+    /** created/beforeCreate 顶层立即执行 */
+    createdStatements: string;
+    /** setup 字段顶层立即执行 */
+    setupStatements: string;
+    /** onXxx 生命周期顶层调用 */
+    lifeCycles: string;
+    /** 模板部分 */
+    template: string;
+    css: string;
+    style: string;
+    urlSchemas: string;
+    blockPlugins: string;
+    uniComponents: string[];
+    renderer: string;
+    /** renderer 包导入的标识符（useProvider + 可能的 useStore 等） */
+    rendererImports: string;
+    /** parent 类型组件的 const 声明（如 const AButtonGroup = AButton.Group;） */
+    componentDeclarations: string;
+}
+/**
+ * Composition 模式 parser
+ */
+export declare function parserComposition(collecter: Collecter, componentMap: Map<string, MaterialDescription>, platform?: PlatformType): TokenComposition;

package/types/parser/composition/inject.d.ts

@@ -0,0 +1,8 @@
+import { BlockInject } from '@vtj/core';
+import { SymbolTable } from './symbolTable';
+/**
+ * 解析 inject 为 Composition 顶层声明：
+ * { name: 'theme', from: 'theme', default: 'light' }
+ *  → const theme = inject('theme', 'light');
+ */
+export declare function parseInject(injects: BlockInject[] | undefined, symbols: SymbolTable): string[];

package/types/parser/composition/lifeCycles.d.ts

@@ -0,0 +1,23 @@
+import { JSFunction } from '@vtj/core';
+import { SymbolTable } from './symbolTable';
+/**
+ * Uniapp 专用生命周期钩子
+ */
+export declare const UNI_HOOKS: Set<string>;
+export interface LifeCyclesResult {
+    /** 顶层 onXxx() 调用语句 */
+    statements: string[];
+    /** 实际使用到的 Vue Composition 钩子（用于 vue import 收集） */
+    usedHooks: Set<string>;
+    /** 实际使用到的 Uniapp 专用钩子（用于 @dcloudio/uni-app import 收集） */
+    usedUniHooks: Set<string>;
+}
+/**
+ * 解析 lifeCycles 为 Composition 顶层 onXxx() 调用
+ *
+ * 注意：
+ * - created / beforeCreate 不在此处理（由 setupStatements 处理）
+ * - mounted 等 Options 命名自动映射为 onMounted
+ * - 已是 onXxx 的直接使用
+ */
+export declare function parseLifeCycles(lifeCycles: Record<string, JSFunction> | undefined, symbols: SymbolTable): LifeCyclesResult;

package/types/parser/composition/methods.d.ts

@@ -0,0 +1,18 @@
+import { JSFunction } from '@vtj/core';
+import { SymbolTable } from './symbolTable';
+/**
+ * 解析 methods 为 Composition 顶层 const 函数声明：
+ *
+ * { handleClick: { value: 'function() { this.count++ }' } }
+ *  → const handleClick = function() { count.value++ };
+ *
+ * { fetch: { value: 'async function() { ... }' } }
+ *  → const fetch = async function() { ... };
+ *
+ * 兼容箭头函数：{ fn: { value: '() => {}' } } → const fn = () => {};
+ */
+export declare function parseMethods(methods: Record<string, JSFunction> | undefined, symbols: SymbolTable): string[];
+/**
+ * 解析 dataSources 为 Composition 顶层 async 函数声明
+ */
+export declare function parseDataSources(dataSources?: Record<string, any>, symbols?: SymbolTable): string[];

package/types/parser/composition/provide.d.ts

@@ -0,0 +1,9 @@
+import { JSExpression, JSFunction, JSONValue } from '@vtj/core';
+import { SymbolTable } from './symbolTable';
+/**
+ * 解析 provide 为 Composition provide() 调用：
+ * { theme: 'light', count: { type: 'JSExpression', value: 'this.count' } }
+ *  → provide('theme', 'light');
+ *    provide('count', count);
+ */
+export declare function parseProvide(provide: Record<string, JSONValue | JSExpression | JSFunction> | undefined, symbols: SymbolTable): string[];

package/types/parser/composition/reactives.d.ts

@@ -0,0 +1,11 @@
+import { JSExpression, JSFunction, JSONValue } from '@vtj/core';
+import { SymbolTable } from './symbolTable';
+/**
+ * 解析 reactives 声明：
+ * { form: { name: '' } } → ['const form = reactive({ "name": "" });']
+ */
+export declare function parseReactives(reactives: Record<string, JSONValue | JSExpression> | undefined, symbols: SymbolTable): string[];
+/**
+ * state 作为一个 reactive 输出（如果非空）
+ */
+export declare function parseStateAsReactive(state: Record<string, JSONValue | JSExpression | JSFunction> | undefined, symbols: SymbolTable): string;

package/types/parser/composition/refs.d.ts

@@ -0,0 +1,8 @@
+import { JSExpression, JSONValue } from '@vtj/core';
+import { SymbolTable } from './symbolTable';
+/**
+ * 解析 refs 声明：
+ * { count: 0, list: { type: 'JSExpression', value: 'this.props.items' } }
+ *  → ['const count = ref(0);', 'const list = ref(props.items);']
+ */
+export declare function parseRefs(refs: Record<string, JSONValue | JSExpression> | undefined, symbols: SymbolTable): string[];

package/types/parser/composition/setupStatements.d.ts

@@ -0,0 +1,24 @@
+import { JSFunction } from '@vtj/core';
+import { SymbolTable } from './symbolTable';
+/**
+ * 提取函数体内容（用于 setup 顶层执行场景）
+ *
+ * 输入: 'async function() { console.log("init"); await foo(); }'
+ * 输出: 'console.log("init"); await foo();'
+ *
+ * 输入: '() => doSomething()'
+ * 输出: 'doSomething();'
+ *
+ * 输入: '() => { return foo(); }'
+ * 输出: 'return foo();' （由调用方决定是否需要包装）
+ */
+export declare function extractFunctionBody(code: string): string;
+/**
+ * 解析 setup 字段为顶层语句
+ */
+export declare function parseSetupStatements(setup: JSFunction | undefined, symbols: SymbolTable): string;
+/**
+ * 解析 created/beforeCreate 为顶层立即执行语句
+ * 二者均映射为 setup 阶段同步执行
+ */
+export declare function parseCreatedStatements(lifeCycles: Record<string, JSFunction> | undefined, symbols: SymbolTable): string;

package/types/parser/composition/symbolTable.d.ts

@@ -0,0 +1,32 @@
+import { BlockSchema } from '@vtj/core';
+import { GlobalApiConfig } from './globalApi';
+/**
+ * 符号表：标识 DSL 中可识别的 this.xxx 引用属于哪一类
+ * Composition 模式出码时根据符号类别决定如何转换
+ */
+export interface SymbolTable {
+    /** ref 声明集（需要 .value 解包）*/
+    refs: Set<string>;
+    /** reactive 声明集 + state（直接使用） */
+    reactives: Set<string>;
+    /** computed 声明集（需要 .value 解包） */
+    computed: Set<string>;
+    /** methods 声明集（顶层函数） */
+    methods: Set<string>;
+    /** props 名集（通过 props.xxx 访问） */
+    props: Set<string>;
+    /** composables 暴露的名集（包含 destructure） */
+    composables: Set<string>;
+    /** inject 名集（顶层变量） */
+    injects: Set<string>;
+    /** dataSources 名集（顶层函数） */
+    dataSources: Set<string>;
+    /** 是否生成 state reactive 声明 */
+    hasState: boolean;
+    /** 有效的全局 API 映射表（基础 Map + 当前 UI 库 Map） */
+    effectiveApiMap: Record<string, GlobalApiConfig>;
+}
+/**
+ * 构建符号表
+ */
+export declare function buildSymbolTable(dsl: BlockSchema, effectiveApiMap?: Record<string, GlobalApiConfig>): SymbolTable;

package/types/parser/composition/template.d.ts

@@ -0,0 +1,17 @@
+import { NodeSchema, MaterialDescription, JSFunction } from '@vtj/core';
+import { GlobalApiConfig } from './globalApi';
+/**
+ * Composition 模式模板解析：
+ * - 预处理 nodes：替换全局 API、ref/computed 的 .value 解包
+ * - 委托给原 parseTemplate（this. 前缀剥离已能正确处理）
+ */
+export declare function parseTemplateComposition(children: NodeSchema[], componentMap: Map<string, MaterialDescription>, computedKeys?: string[], context?: Record<string, Set<string>>, parent?: NodeSchema, effectiveMap?: Record<string, GlobalApiConfig>, refs?: Set<string>, computed?: Set<string>): {
+    nodes: string[];
+    methods: Record<string, JSFunction>;
+    directives: string[];
+    components: string[];
+    importBlocks: {
+        id: string;
+        name: string;
+    }[];
+};

package/types/parser/composition/transformer.d.ts

@@ -0,0 +1,38 @@
+import { JSExpression, JSFunction } from '@vtj/core';
+import { SymbolTable } from './symbolTable';
+/**
+ * 转换上下文：影响 ref/computed 的 .value 解包行为
+ * - script: 解包，输出 xxx.value
+ * - template: 不解包，Vue 模板自动解包
+ */
+export type TransformContext = 'script' | 'template';
+/**
+ * 转换 DSL 中的 this.xxx 引用为 Composition API 顶层标识符
+ *
+ * 转换规则：
+ * - this.$router 等 globalApi → 替换为 router 等
+ * - this.refsName → script: refsName.value, template: refsName
+ * - this.reactiveName → reactiveName（包含 state）
+ * - this.computedName → script: computedName.value, template: computedName
+ * - this.methodName → methodName
+ * - this.propName (props) → script: props.propName, template: propName
+ * - this.composableName → composableName
+ * - this.injectName → injectName
+ * - this.dataSourceName → dataSourceName
+ * - 未识别的 this.xxx → 保持原样（可能是动态属性 / 测试用例）
+ */
+export declare function transformExpression(code: string, symbols: SymbolTable, context?: TransformContext): string;
+/**
+ * 转换 JSExpression / JSFunction，返回纯字符串
+ */
+export declare function transformCode(code: JSExpression | JSFunction | undefined, symbols: SymbolTable, context?: TransformContext): string;
+/**
+ * 仅替换 this 前缀，不依赖符号表（兜底转换）
+ * 用于无法识别的场景：直接去掉 this. 前缀
+ */
+export declare function stripThisPrefix(code: string): string;
+/**
+ * 移除外层括号包装：( fn ) → fn
+ * 与 utils.ts 的 replaceFunctionTag 类似但更宽松
+ */
+export declare function unwrapFunction(code: string): string;

package/types/parser/composition/watch.d.ts

@@ -0,0 +1,9 @@
+import { BlockWatch } from '@vtj/core';
+import { SymbolTable } from './symbolTable';
+/**
+ * 解析 watch 为 Composition watch() 调用：
+ *
+ * { source: '() => this.count', handler: 'function(val) {...}', deep: true }
+ *  → watch(() => count.value, function(val) {...}, { deep: true });
+ */
+export declare function parseWatch(watches: BlockWatch[] | undefined, symbols: SymbolTable): string[];

package/types/parser/functions.d.ts

@@ -1,2 +1,2 @@
-import { JSFunction } from '@vtj/core';
-export declare function parseFunctionMap(map?: Record<string, JSFunction>, computedKeys?: string[]): (string | null)[];
+import { JSExpression, JSFunction } from '@vtj/core';
+export declare function parseFunctionMap(map?: Record<string, JSFunction | JSExpression>, computedKeys?: string[]): (string | null)[];

package/types/parser/imports.d.ts

@@ -1,5 +1,5 @@
 import { MaterialDescription, PlatformType } from '@vtj/core';
-export declare function parseImports(componentMap: Map<string, MaterialDescription>, components?: string[], importBlocks?: string[], collectImports?: Record<string, Set<string>>, platform?: PlatformType): {
+export declare function parseImports(componentMap: Map<string, MaterialDescription>, components?: string[], importBlocks?: string[], collectImports?: Record<string, Set<string>>, platform?: PlatformType, easycomPackages?: Set<string>): {
     imports: string[];
     uniComponents: string[];
 };

package/types/templates.d.ts

@@ -1,3 +1,4 @@
 import { TemplateExecutor } from 'lodash';
 export declare const scriptCompiled: TemplateExecutor;
+export declare const scriptSetupCompiled: TemplateExecutor;
 export declare const vueCompiled: TemplateExecutor;

package/types/version.d.ts

@@ -2,7 +2,7 @@
  * Copyright (c) 2026, VTJ.PRO All rights reserved.
  * @name @vtj/coder
  * @author CHC chenhuachun1549@dingtalk.com
- * @version 0.17.7
+ * @version 0.17.8
  * @license <a href="https://vtj.pro/license.html">MIT License</a>
  */
-export declare const version = "0.17.7";
+export declare const version = "0.17.8";