transone-cli 0.1.0 → 0.2.0

package/dist/mp/analyze.d.ts

@@ -0,0 +1,15 @@
+import type * as tsTypes from 'typescript';
+import { ClassSource, CompileContext } from './types';
+/** 读取并缓存源文件。 */
+export declare function readSource(context: CompileContext, filePath: string): tsTypes.SourceFile;
+/** 从页面入口定位根组件类：优先 createApp({ root })，其次导出的 Component 子类。 */
+export declare function findRootClass(context: CompileContext, filePath: string): ClassSource;
+/** 类解析所需的来源上下文（文件 + 已解析的源）。 */
+export type ClassResolverContext = Pick<ClassSource, 'filePath' | 'source'>;
+/**
+ * 解析一个类引用（标识符 / 类表达式）为 ClassSource。
+ * 支持同文件类、相对路径导入的类；非相对导入会报错。
+ */
+export declare function resolveClassReference(context: CompileContext, from: ClassResolverContext, expr: tsTypes.Expression): ClassSource;
+/** 判断类是否为 Component 子类（extends 一个从 transone 导入或名为 Component 的类）。 */
+export declare function isComponentSubclass(context: CompileContext, classSource: ClassSource): boolean;

package/dist/mp/binding.d.ts

@@ -0,0 +1,21 @@
+import type * as tsTypes from 'typescript';
+/** 绑定表达式求值作用域：each 参数名 + render 内局部 const。 */
+export interface BindingScope {
+    params: Set<string>;
+    locals: Map<string, tsTypes.Expression>;
+    /** 模块级 const（name -> 初始化表达式）。 */
+    consts: Map<string, tsTypes.Expression>;
+}
+export interface BindingContext {
+    ts: typeof tsTypes;
+    scope: BindingScope;
+    filePath: string;
+    /** 组件模板中访问 this.props.X 时回调，用于收集 properties 声明。 */
+    onProp?: (name: string) => void;
+}
+/**
+ * 把 TypeScript 表达式转换为 WXML 数据绑定表达式（{{...}} 内的部分）。
+ * 支持：this.state / this.props 路径、字面量、三元、二元、each 参数、
+ * render 局部 const、可折叠的模块级 const。
+ */
+export declare function toBinding(context: BindingContext, node: tsTypes.Node): string;

package/dist/mp/build-mp.d.ts

@@ -0,0 +1,7 @@
+import type { ResolvedConfig, BuildResult } from '../types';
+import type { MpDialect } from './dialect';
+/**
+ * 把 TSone 应用编译为小程序原生工程（微信 / 阿里 / 字节，差异见 MpDialect）：
+ * app.json / app.js / <appStyleFile> / 工程配置 + pages/<route>/<name>.* + components/<tag>/<tag>.*
+ */
+export declare function buildMiniProgram(config: ResolvedConfig, dialect: MpDialect): Promise<BuildResult>;

package/dist/mp/compile.d.ts

@@ -0,0 +1,13 @@
+import { ClassSource, CompiledUnit, CompileContext, UnitKind } from './types';
+export interface UnitOptions {
+    kind: UnitKind;
+    name: string;
+}
+/**
+ * 编译一个页面或自定义组件单元。组件会被缓存（按 kebab 标签名），
+ * 并通过 usedComponents 递归编译依赖的组件。
+ */
+export declare function compileUnit(context: CompileContext, classSource: ClassSource, options: UnitOptions): CompiledUnit;
+/** 编译全部页面后，聚合调用点属性与模板 props 引用，生成组件 properties。 */
+export declare function finalizeComponentProperties(context: CompileContext): void;
+export declare function componentTag(className: string): string;

package/dist/mp/dialect.d.ts

@@ -0,0 +1,49 @@
+import type { ResolvedMiniProgramConfig } from '../types';
+/**
+ * 跨端差异层：同一套 mp 编译器（AST 静态分析 → WXML 系模板 / WXSS 系样式 /
+ * Page/Component JS）通过 MpDialect 描述各小程序平台的产物差异。
+ *
+ * 平台差异点（positioning 9.M3「沉淀跨端差异层」）：
+ * - 模板文件后缀：.wxml / .axml / .ttml
+ * - 样式文件后缀与 app 样式文件名：.wxss / .acss / .ttss
+ * - 模板指令前缀：wx: / a: / tt:
+ * - 事件绑定写法：bindtap / onTap / bindtap
+ * - 工程配置文件与字段：project.config.json / mini.project.json / project.config.json
+ * - app.json 的 window 字段名（navigationBarTitleText vs defaultTitle）与顶层差异
+ * - 组件 json（微信 multipleSlots；阿里 / 字节无需）
+ * - 是否生成 sitemap.json（微信特有）
+ */
+export interface MpDialect {
+    /** 目标端标识，与 TargetType 一致。 */
+    id: string;
+    /** 人类可读描述。 */
+    label: string;
+    /** 模板文件后缀（不含点）。 */
+    templateExt: string;
+    /** 样式文件后缀（不含点）。 */
+    styleExt: string;
+    /** 全局样式文件名（app.wxss / app.acss / app.ttss）。 */
+    appStyleFile: string;
+    /** 模板指令前缀（wx: / a: / tt:）。 */
+    directivePrefix: string;
+    /** 普通事件绑定：bindtap / onTap / bindtap。 */
+    bindEvent: (eventName: string) => string;
+    /** 阻止冒泡事件绑定：catchtap / catchTap / catchtap。 */
+    catchEvent: (eventName: string) => string;
+    /** 工程配置文件文件名（project.config.json / mini.project.json）。 */
+    projectConfigFile: string;
+    /** 工程配置文件内容。 */
+    buildProjectConfig: (mp: ResolvedMiniProgramConfig, projectName: string) => Record<string, unknown>;
+    /** app.json.window 的默认字段（平台字段名映射）。 */
+    windowDefaults: (title: string) => Record<string, unknown>;
+    /** app.json 顶层额外字段（微信的 style / sitemapLocation）。 */
+    appJsonExtras: () => Record<string, unknown>;
+    /** 是否生成 sitemap.json（微信特有）。 */
+    sitemap: boolean;
+    /** 自定义组件 json 的固定字段。 */
+    componentJson: (usingComponents: Record<string, string>) => Record<string, unknown>;
+}
+export declare const MP_WEIXIN_DIALECT: MpDialect;
+export declare const MP_ALIPAY_DIALECT: MpDialect;
+export declare const MP_BYTEDANCE_DIALECT: MpDialect;
+export declare const MP_DIALECTS: Record<string, MpDialect>;

package/dist/mp/errors.d.ts

@@ -0,0 +1,6 @@
+/** 小程序编译错误：携带出错文件，便于定位不可静态编译的源码。 */
+export declare class MpCompileError extends Error {
+    readonly file: string;
+    constructor(file: string, message: string);
+}
+export declare function mpError(file: string, message: string): MpCompileError;

package/dist/mp/fold.d.ts

@@ -0,0 +1,15 @@
+import type * as tsTypes from 'typescript';
+export type FoldedValue = string | number | boolean | null | FoldedValue[] | {
+    [key: string]: FoldedValue;
+};
+/** 收集源文件顶层 const 声明（name -> 初始化表达式）。 */
+export declare function collectModuleConsts(ts: typeof tsTypes, source: tsTypes.SourceFile): Map<string, tsTypes.Expression>;
+/**
+ * 常量折叠：把可静态求值的表达式折叠为 JSON 值。
+ * 无法求值时返回 undefined（调用方决定如何报错）。
+ */
+export declare function foldExpression(ts: typeof tsTypes, node: tsTypes.Node, consts: Map<string, tsTypes.Expression>, seen?: Set<string>): FoldedValue | undefined;
+export declare function propertyNameText(ts: typeof tsTypes, name: tsTypes.PropertyName): string | undefined;
+export declare function unwrapParentheses<T extends tsTypes.Node>(ts: typeof tsTypes, node: T): T;
+/** this 表达式判断（TypeScript API 未导出 isThisExpression）。 */
+export declare function isThisExpression(ts: typeof tsTypes, node: tsTypes.Node): node is tsTypes.ThisExpression;

package/dist/mp/inline.d.ts

@@ -0,0 +1,3 @@
+import type { ClassSource, CompileContext } from './types';
+/** 收集 entry 源码需要内联的相对模块 JS 文本（依赖先于使用方）。 */
+export declare function collectInlineModules(context: CompileContext, classSource: ClassSource): string[];

package/dist/mp/jsgen.d.ts

@@ -0,0 +1,7 @@
+import { CompiledUnit, PropertyTypes } from './types';
+import type { MpDialect } from './dialect';
+export declare function generatePageJs(unit: CompiledUnit, dialect: MpDialect): string;
+/** 生成自定义组件 JS：Component({ properties, data, methods, lifetimes })。 */
+export declare function generateComponentJs(unit: CompiledUnit, dialect: MpDialect): string;
+/** 生成 properties 对象源码：{ title: { type: String, value: '' } }。 */
+export declare function generatePropertiesSource(properties: PropertyTypes): string;

package/dist/mp/methods.d.ts

@@ -0,0 +1,14 @@
+import { ClassSource, CompileContext, FunctionEntry, UnitKind } from './types';
+export interface CompiledMethods {
+    methods: FunctionEntry[];
+    lifecycle: FunctionEntry[];
+}
+/**
+ * 编译事件方法与小程序的 data 语义桥：
+ * - this.state.x -> this.data.x
+ * - this.setState(obj) -> this.setData(obj)
+ * - this.state.a.b = expr / += -> this.setData({ 'a.b': expr })
+ * - 组件内 this.emit('name', args) -> this.triggerEvent('name', { args })
+ * - 方法体中的模块常量原地折叠为字面量
+ */
+export declare function compileMethods(context: CompileContext, classSource: ClassSource, usedNames: Set<string>, kind: UnitKind, customEvents: Set<string>): CompiledMethods;

package/dist/mp/state.d.ts

@@ -0,0 +1,6 @@
+import { ClassSource, CompileContext } from './types';
+/**
+ * 编译 initState() 为小程序 data 初始值（JS 对象字面量源码）。
+ * 只支持静态可求值的字面量/模块常量/局部常量；其余表达式快速报错。
+ */
+export declare function compileState(context: CompileContext, classSource: ClassSource): string;

package/dist/mp/styles.d.ts

@@ -0,0 +1,15 @@
+import { ClassSource, CompileContext } from './types';
+export interface CompiledStyles {
+    /** 本单元作用域内的 WXSS（class 等选择器）。 */
+    style: string;
+    /** 全局样式（body 选择器，页面单元会合并进 app.wxss）。 */
+    global: string;
+    /** 存在 hover 样式的选择器（如 '.card'），模板据此生成 hover-class。 */
+    hoverSelectors: Set<string>;
+}
+/**
+ * 编译 initStyles()：只支持
+ * `this.styleManager.addStyle('name', { selector, properties, media, hover })`
+ * 字面量调用；body 选择器归入全局样式（小程序用 page 选择器）。
+ */
+export declare function compileStyles(context: CompileContext, classSource: ClassSource): CompiledStyles;

package/dist/mp/ts-loader.d.ts

@@ -0,0 +1,6 @@
+import type * as tsTypes from 'typescript';
+/**
+ * 惰性加载 TypeScript 编译器 API：只有 `transone build --target mp-weixin` 路径
+ * 才加载，常规 build/dev 不受影响。模块级缓存避免重复加载。
+ */
+export declare function loadTypescript(): Promise<typeof tsTypes>;

package/dist/mp/types.d.ts

@@ -0,0 +1,64 @@
+import type * as tsTypes from 'typescript';
+import type { MpDialect } from './dialect';
+export type UnitKind = 'page' | 'component';
+/** 一个 Component 子类的定位信息：文件 + 类声明。 */
+export interface ClassSource {
+    filePath: string;
+    source: tsTypes.SourceFile;
+    declaration: tsTypes.ClassLikeDeclaration;
+    className: string;
+}
+/** 编译生成的函数条目（页面/组件方法或生命周期钩子）。 */
+export interface FunctionEntry {
+    key: string;
+    fn: string;
+}
+/** 组件属性定义：propName -> WeChat 属性类型（String/Number/...）。 */
+export type PropertyTypes = Record<string, string>;
+/** 编译产物单元：一个页面或一个自定义组件。 */
+export interface CompiledUnit {
+    kind: UnitKind;
+    /** 页面为路由叶名（如 index），组件为 kebab-case 标签名。 */
+    name: string;
+    /** WXML 模板源码。 */
+    template: string;
+    /** 本单元作用域内的 WXSS（class 选择器）。 */
+    style: string;
+    /** 全局样式（body 选择器，页面单元会合并进 app.wxss）。 */
+    globalStyle: string;
+    /** data 初始值 JS 源码（对象字面量）。 */
+    data: string;
+    /** 自定义组件 properties（页面为空对象）。 */
+    properties: PropertyTypes;
+    /** 页面/组件 methods 条目（不含生命周期钩子）。 */
+    methods: FunctionEntry[];
+    /** 页面级生命周期（onLoad/onReady/onUnload）或组件 lifetimes。 */
+    lifecycle: FunctionEntry[];
+    /** 组件通过 triggerEvent 暴露的自定义事件名。 */
+    customEvents: string[];
+    /** 模板中引用到的 props 名（finalize 时并入 properties）。 */
+    propsReferenced: Set<string>;
+    /** usingComponents：tag -> 小程序绝对路径。 */
+    usingComponents: Record<string, string>;
+    /** 内联的相对模块 JS（按依赖顺序，产物顶部拼接）。 */
+    inlineModules: string[];
+}
+/** 编译过程中的上下文：跨模块共享的文件缓存与产物缓存。 */
+export interface CompileContext {
+    ts: typeof tsTypes;
+    root: string;
+    /** 已解析的源文件缓存（绝对路径 -> SourceFile）。 */
+    files: Map<string, tsTypes.SourceFile>;
+    /** 已编译完成的组件（tag -> unit）。 */
+    components: Map<string, CompiledUnit>;
+    /** 正在编译的组件 tag，用于检测循环引用。 */
+    compiling: Set<string>;
+    /** 组件调用点收集：tag -> 各调用点传的属性（name -> 类型）。 */
+    callSites: Map<string, Array<Record<string, string>>>;
+    /** 样式数字长度单位：'px'（默认）或 'rpx'（数值按 1px=2rpx 换算）。 */
+    lengthUnit: 'px' | 'rpx';
+    /** 跨端差异层：决定模板指令前缀、事件绑定、文件后缀、工程配置等平台差异。 */
+    dialect: MpDialect;
+    warnings: string[];
+}
+export declare function warn(context: CompileContext, message: string): void;

package/dist/mp/wxml.d.ts

@@ -0,0 +1,31 @@
+import type * as tsTypes from 'typescript';
+import { ClassSource, CompileContext } from './types';
+/** 一个组件调用点通过 emitters 绑定的自定义事件。 */
+export interface EmitterUsage {
+    event: string;
+    method: string;
+    passArgs: boolean;
+    /** 页面/组件 JS 中的包装方法名（按出现顺序唯一，避免同名事件冲突）。 */
+    key: string;
+}
+/** 模板编译期间收集的产物信息。 */
+export interface TemplateBuilder {
+    /** 模板绑定的事件处理方法名。 */
+    handlers: Set<string>;
+    /** 用到的自定义组件（tag -> 类来源）。 */
+    usedComponents: Map<string, ClassSource>;
+    /** 本模板中引用到的 props 名（组件需要声明 properties）。 */
+    propsReferenced: Set<string>;
+    /** 本模板的组件通过 triggerEvent 触发的事件名。 */
+    customEvents: Set<string>;
+    /** 父级需要生成的 emitters 包装方法。 */
+    emitters: EmitterUsage[];
+}
+export interface CompiledTemplate {
+    template: string;
+    builder: TemplateBuilder;
+}
+export declare function compileTemplate(context: CompileContext, classSource: ClassSource, _kind: 'page' | 'component', hoverSelectors?: Set<string>): CompiledTemplate;
+declare function kebabCase(name: string): string;
+export declare function findMethod(context: CompileContext, classSource: ClassSource, name: string): tsTypes.MethodDeclaration | undefined;
+export { kebabCase };