@vtj/parser 0.17.7 → 0.18.0

package/package.json

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

package/types/shared/utils.d.ts

@@ -8,6 +8,7 @@ export declare function parseSFC(source: string): {
     script: string;
     styles: string[];
     errors: ( CompilerError | SyntaxError)[];
+    isScriptSetup: boolean;
 };
 export declare function parseScript(script: string): ParseResult<File>;
 export declare function traverseAST(ast: ReturnType<typeof parseScript>, options: TraverseOptions): any;
@@ -17,4 +18,9 @@ export declare function isJSFunction(x: any): x is JSFunction;
 export declare function isJSCode(data: unknown): data is JSExpression | JSFunction;
 export declare function isNodeSchema(node: NodeSchema | JSExpression | string | null): node is NodeSchema;
 export declare function transformScript(script: string, visitor: Visitor): any;
+/**
+ * 将 TypeScript 代码转为 JavaScript（剥离类型标注）
+ * 使用 @babel/traverse 执行 AST 变换，后续解析以纯 JS 为基础
+ */
+export declare function stripTypeScript(script: string): string;
 export declare function compileValidator(source: string, filename: string): string[] | null;

package/types/version.d.ts

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

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

@@ -0,0 +1,3 @@
+export { buildReverseGlobalApiMap, detectUIPackage } from './reverseGlobalApi';
+export { buildReverseSymbolTable, type ReverseSymbolTable } from './reverseSymbolTable';
+export { reverseTransformExpression } from './reverseTransformer';

package/types/vue/composition/reverseGlobalApi.d.ts

@@ -0,0 +1,30 @@
+export interface ReverseGlobalApiMaps {
+    /** 裸标识符映射：{ 变量名: '$xxx' } */
+    simple: Record<string, string>;
+    /** 成员访问映射：{ 对象名: { 属性名: '$xxx' } } */
+    member: Record<string, Record<string, string>>;
+}
+/**
+ * 从 coder 的全局 API 映射构建反向映射
+ *
+ * 分为两类：
+ * - simple: replace 为裸标识符的，如 router → $router
+ * - member: replace 为成员访问的，如 __i18n.t → $t, ElMessageBox.confirm → $confirm
+ */
+export declare function buildReverseGlobalApiMap(uiPackage?: string): ReverseGlobalApiMaps;
+/**
+ * 从 import 语句列表探测当前使用的 UI 库包名
+ */
+export declare function detectUIPackage(imports: Array<{
+    from: string;
+}>): string | undefined;
+/**
+ * 构建 composable 函数名 → { 解构属性名: DSL API名 } 映射
+ *
+ * 用于解构形式的全局 API 精确反向映射。
+ * 例如：const { t, n } = useI18n() 中，t → '$t'，n → '$n'
+ *
+ * 产出示例：
+ * { useI18n: { t: '$t', n: '$n', d: '$d', rt: '$rt', te: '$te', tm: '$tm' } }
+ */
+export declare function buildComposableMemberMap(uiPackage?: string): Record<string, Record<string, string>>;

package/types/vue/composition/reverseSymbolTable.d.ts

@@ -0,0 +1,35 @@
+import { ParseScriptSetupResult } from '../scriptSetup';
+/**
+ * 反向符号表：描述 <script setup> 中各类标识符的分类
+ * 用于将 Composition API 代码反向转换为 DSL 中的 this.xxx 形态
+ *
+ * 与 @vtj/coder 的 SymbolTable 形成镜像关系。
+ */
+export interface ReverseSymbolTable {
+    /** ref 声明集 */
+    refs: Set<string>;
+    /** reactive 声明集（含 state） */
+    reactives: Set<string>;
+    /** computed 声明集 */
+    computed: Set<string>;
+    /** methods 声明集 */
+    methods: Set<string>;
+    /** props 名集 */
+    props: Set<string>;
+    /** composables 暴露的名集（包含 destructure） */
+    composables: Set<string>;
+    /** inject 名集 */
+    injects: Set<string>;
+    /** dataSources 名集 */
+    dataSources: Set<string>;
+    /** 是否存在 state reactive */
+    hasState: boolean;
+    /** 裸标识符全局 API 反向映射：{ 变量名: '$xxx' } */
+    reverseApiMap: Record<string, string>;
+    /** 成员访问全局 API 反向映射：{ 对象名: { 属性名: '$xxx' } } */
+    reverseMemberApiMap: Record<string, Record<string, string>>;
+}
+/**
+ * 从 ParseScriptSetupResult 构建反向符号表
+ */
+export declare function buildReverseSymbolTable(result: ParseScriptSetupResult): ReverseSymbolTable;

package/types/vue/composition/reverseTransformer.d.ts

@@ -0,0 +1,2 @@
+import { ReverseSymbolTable } from './reverseSymbolTable';
+export declare function reverseTransformExpression(code: string, symbols: ReverseSymbolTable): string;

package/types/vue/compositionPatch.d.ts

@@ -0,0 +1,46 @@
+/**
+ * compositionPatch 选项（向后兼容）
+ * 描述当前 <script setup> 中各类标识符的分类
+ */
+export interface CompositionPatchOptions {
+    /** ref 变量名列表 */
+    refs: string[];
+    /** reactive 变量名列表（不含 'state'） */
+    reactives: string[];
+    /** 是否存在 state reactive */
+    hasState: boolean;
+    /** computed 变量名列表 */
+    computed: string[];
+    /** method 函数名列表 */
+    methods: string[];
+    /** props 字段名列表 */
+    props: string[];
+    /** 用户自定义 composable 赋值变量名（含解构字段） */
+    composables: string[];
+    /** inject 变量名 */
+    injects: string[];
+    /** dataSource 函数名 */
+    dataSources: string[];
+    /**
+     * 全局 API 变量名 → this.$xxx 的映射
+     * 例如 { router: '$router', route: '$route', t: '$t', store: '$store' }
+     */
+    globalApiVars: Record<string, string>;
+    /**
+     * 第三方库标识符映射，例如 { ElButton: 'ElementPlus', useDark: 'VueUse' }
+     * 替换为 this.$libs.ElementPlus.ElButton 等
+     */
+    libs: Record<string, string>;
+    /**
+     * 成员访问形式的全局 API 反向映射
+     * 例如 { __i18n: { t: '$t', n: '$n' }, ElMessageBox: { confirm: '$confirm' } }
+     * 若未提供，将自动从 coder 的 GLOBAL_API_MAP 推导
+     */
+    reverseMemberApiMap?: Record<string, Record<string, string>>;
+}
+/**
+ * Composition 模式反向 this 注入
+ *
+ * 现在委托给 reverseTransformExpression，保留此函数以维持向后兼容。
+ */
+export declare function compositionPatch(content: string, options: CompositionPatchOptions): string;

package/types/vue/scriptSetup.d.ts

@@ -0,0 +1,31 @@
+import { BlockState, JSFunction, JSExpression, JSONValue, BlockWatch, BlockProp, BlockEmit, BlockInject, BlockComposable, DataSourceSchema, ProjectSchema } from '@vtj/core';
+import { ImportStatement } from './scripts';
+export interface GlobalApiDestructured {
+    /** composable 函数名（如 useI18n） */
+    callee: string;
+    /** 解构字段列表（如 ['t', 'n']） */
+    destructure: string[];
+}
+export interface ParseScriptSetupResult {
+    imports: ImportStatement[];
+    refs: Record<string, JSONValue | JSExpression>;
+    reactives: Record<string, JSONValue | JSExpression>;
+    state: BlockState;
+    computed: Record<string, JSFunction>;
+    methods: Record<string, JSFunction>;
+    watch: BlockWatch[];
+    lifeCycles: Record<string, JSFunction>;
+    props: Array<string | BlockProp>;
+    emits: BlockEmit[];
+    expose: string[];
+    inject: BlockInject[];
+    provide: Record<string, JSONValue | JSExpression | JSFunction>;
+    composables: BlockComposable[];
+    /** 全局 composable 的解构字段（如 const { t } = useI18n()） */
+    globalApiDestructured?: GlobalApiDestructured[];
+    setup: JSFunction | undefined;
+    handlers: Record<string, JSFunction>;
+    dataSources: Record<string, DataSourceSchema>;
+    directives: Record<string, JSExpression>;
+}
+export declare function parseScriptSetup(content: string, project: ProjectSchema): ParseScriptSetupResult;

package/types/vue/utils.d.ts

@@ -9,26 +9,6 @@ export interface ExpressionOptions {
     members: string[];
     props: string[];
 }
-/**
- * 检查标识符是否在函数参数位置
- * 包括：function(key)、 (key) =>、 key =>、 (a, key, b) => 等
- * 不包括：函数调用参数如 obj.method(key) 中的 key
- */
-/**
- * 判断当前位置是否处于 ES6 对象字面量简写属性位置
- * 例如 { key } 或 { a, key } 中的 key
- * 特点：key 前面是 { 或 ,，后面紧跟 , 或 }
- *      如果后面紧跟 : 则为普通属性名，不算简写
- */
-/**
- * 简化的字符串替换函数，遵循以下规则：
- * 1. 字符串中的 key 不替换（包括模板字符串普通文本，但 ${key} 中的 key 要替换）
- * 2. 对象属性访问 obj.key 不替换（. 前）
- * 3. 变量声明（const/let/var/function 后）不替换
- * 4. 对象属性名 {key: value} 或 {key} 不替换
- * 5. 前后有单词字符（a-zA-Z0-9_$@-）不替换
- * 6. 其他情况替换：赋值、函数调用、数组元素、模板表达式等
- */
 export declare function patchCode(content: string, id: string, options: ExpressionOptions): string;
 export declare function getJSExpression(content: string): JSExpression;
 export declare function getJSFunction(content: string): JSFunction;