@wevu/compiler 0.0.0 → 0.0.1

package/dist/index.d.mts

@@ -1,5 +1,460 @@
-//#region src/index.d.ts
-declare function greet(name: string): string;
-declare const VERSION = "0.0.0";
+import { LRUCache } from "lru-cache";
+import { SFCBlock, SFCDescriptor, SFCParseResult, SFCStyleBlock } from "vue/compiler-sfc";
+import * as t from "@babel/types";
+import { Expression } from "@babel/types";
+
+//#region src/auto-import-components/builtin.d.ts
+declare const builtinComponentsSet: Set<string>;
+declare function isBuiltinComponent(tag: string): boolean;
 //#endregion
-export { VERSION, greet };
+//#region src/constants.d.ts
+declare const WE_VU_PAGE_HOOK_TO_FEATURE: {
+  readonly onPageScroll: "enableOnPageScroll";
+  readonly onPullDownRefresh: "enableOnPullDownRefresh";
+  readonly onReachBottom: "enableOnReachBottom";
+  readonly onRouteDone: "enableOnRouteDone";
+  readonly onTabItemTap: "enableOnTabItemTap";
+  readonly onResize: "enableOnResize";
+  readonly onShareAppMessage: "enableOnShareAppMessage";
+  readonly onShareTimeline: "enableOnShareTimeline";
+  readonly onAddToFavorites: "enableOnAddToFavorites";
+  readonly onSaveExitState: "enableOnSaveExitState";
+};
+declare const WE_VU_MODULE_ID: "wevu";
+declare const WE_VU_RUNTIME_APIS: {
+  readonly createApp: "createApp";
+  readonly createWevuComponent: "createWevuComponent";
+  readonly createWevuScopedSlotComponent: "createWevuScopedSlotComponent";
+  readonly defineComponent: "defineComponent";
+  readonly setWevuDefaults: "setWevuDefaults";
+};
+type WevuRuntimeApiName = (typeof WE_VU_RUNTIME_APIS)[keyof typeof WE_VU_RUNTIME_APIS];
+//#endregion
+//#region src/plugins/utils/cache.d.ts
+declare const mtimeCache: Map<string, {
+  mtimeMs: number;
+  size: number;
+}>;
+declare const loadCache: LRUCache<string, string, unknown>;
+/**
+ * 返回 true 的时候需要重新 fs 读取
+ * @param id 文件路径
+ * @returns {Promise<boolean>} 当文件需要重新读取时返回 true
+ */
+declare function isInvalidate(id: string): Promise<boolean>;
+declare function readFile(id: string, options?: {
+  checkMtime?: boolean;
+  encoding?: BufferEncoding;
+}): Promise<string>;
+declare function pathExists(id: string, options?: {
+  ttlMs?: number;
+}): Promise<boolean>;
+declare function invalidateFileCache(id: string): void;
+declare function clearFileCaches(): void;
+//#endregion
+//#region src/plugins/utils/vueSfc.d.ts
+interface ReadAndParseSfcOptions {
+  /**
+   * 直接传入源码以跳过文件读取。
+   */
+  source?: string;
+  /**
+   * 是否按 mtime+size 检查文件变更（dev 推荐开启）。
+   */
+  checkMtime?: boolean;
+  /**
+   * 解析 <template>/<script>/<style> 的 src 引用。
+   */
+  resolveSrc?: ResolveSfcBlockSrcOptions;
+}
+interface ResolveSfcBlockSrcOptions {
+  resolveId?: (source: string, importer?: string) => Promise<string | undefined>;
+  readFile?: (id: string, options?: {
+    checkMtime?: boolean;
+  }) => Promise<string>;
+  checkMtime?: boolean;
+}
+declare function preprocessScriptSetupSrc(source: string): string;
+declare function preprocessScriptSrc(source: string): string;
+declare function restoreScriptSetupSrc(descriptor: SFCDescriptor): void;
+declare function restoreScriptSrc(descriptor: SFCDescriptor): void;
+declare function resolveSfcBlockSrc(descriptor: SFCDescriptor, filename: string, options?: ResolveSfcBlockSrcOptions): Promise<{
+  descriptor: SFCDescriptor;
+  deps: string[];
+}>;
+declare function readAndParseSfc(filename: string, options?: ReadAndParseSfcOptions): Promise<{
+  source: string;
+  descriptor: SFCDescriptor;
+  errors: SFCParseResult['errors'];
+}>;
+declare function getSfcCheckMtime(config?: {
+  isDev?: boolean;
+}): boolean;
+//#endregion
+//#region src/plugins/vue/compiler/style.d.ts
+interface StyleCompileResult {
+  code: string;
+  map?: string;
+  scopedId?: string;
+  modules?: Record<string, Record<string, string>>;
+}
+interface StyleCompileOptions {
+  id: string;
+  scoped?: boolean;
+  modules?: boolean | string;
+  preprocessOptions?: Record<string, any>;
+}
+/**
+ * 将 Vue SFC 的 style 块转换为 WXSS
+ */
+declare function compileVueStyleToWxss(styleBlock: SFCStyleBlock, options: StyleCompileOptions): StyleCompileResult;
+//#endregion
+//#region src/plugins/vue/compiler/template/platform.d.ts
+interface MiniProgramPlatform {
+  name: string;
+  wrapIf: (exp: string, content: string) => string;
+  wrapElseIf: (exp: string, content: string) => string;
+  wrapElse: (content: string) => string;
+  forAttrs: (listExp: string, item?: string, index?: string) => string[];
+  keyThisValue: string;
+  keyAttr: (value: string) => string;
+  mapEventName: (eventName: string) => string;
+  eventBindingAttr: (eventName: string) => string;
+}
+//#endregion
+//#region src/plugins/vue/compiler/template/types.d.ts
+interface ScopedSlotComponentAsset {
+  id: string;
+  componentName: string;
+  slotKey: string;
+  template: string;
+  classStyleBindings?: ClassStyleBinding[];
+  classStyleWxs?: boolean;
+  inlineExpressions?: InlineExpressionAsset[];
+}
+interface InlineExpressionAsset {
+  id: string;
+  expression: string;
+  scopeKeys: string[];
+}
+interface TemplateCompileResult {
+  code: string;
+  warnings: string[];
+  scopedSlotComponents?: ScopedSlotComponentAsset[];
+  componentGenerics?: Record<string, true>;
+  classStyleRuntime?: ClassStyleRuntime;
+  classStyleBindings?: ClassStyleBinding[];
+  classStyleWxs?: boolean;
+  templateRefs?: TemplateRefBinding[];
+  inlineExpressions?: InlineExpressionAsset[];
+}
+interface ForParseResult {
+  listExp?: string;
+  listExpAst?: Expression;
+  item?: string;
+  index?: string;
+  key?: string;
+}
+interface TemplateCompileOptions {
+  platform?: MiniProgramPlatform;
+  scopedSlotsCompiler?: ScopedSlotsCompilerMode;
+  scopedSlotsRequireProps?: boolean;
+  slotMultipleInstance?: boolean;
+  classStyleRuntime?: ClassStyleRuntime | 'auto';
+  wxsExtension?: string;
+  classStyleWxsSrc?: string;
+}
+type ScopedSlotsCompilerMode = 'auto' | 'augmented' | 'off';
+type ClassStyleRuntime = 'wxs' | 'js';
+interface ClassStyleBinding {
+  name: string;
+  type: 'class' | 'style';
+  exp: string;
+  expAst?: Expression;
+  forStack: ForParseResult[];
+}
+interface TemplateRefBinding {
+  selector: string;
+  inFor: boolean;
+  name?: string;
+  expAst?: Expression;
+  kind?: 'component' | 'element';
+}
+//#endregion
+//#region src/types/platform.d.ts
+type MpPlatform = 'weapp' | 'alipay' | 'tt' | 'swan' | 'jd' | 'xhs';
+//#endregion
+//#region src/plugins/vue/compiler/template/platforms/alipay.d.ts
+declare const alipayPlatform: MiniProgramPlatform;
+//#endregion
+//#region src/plugins/vue/compiler/template/platforms/swan.d.ts
+declare const swanPlatform: MiniProgramPlatform;
+//#endregion
+//#region src/plugins/vue/compiler/template/platforms/tt.d.ts
+declare const ttPlatform: MiniProgramPlatform;
+//#endregion
+//#region src/plugins/vue/compiler/template/platforms/wechat.d.ts
+declare const wechatPlatform: MiniProgramPlatform;
+//#endregion
+//#region src/plugins/vue/compiler/template/platforms/index.d.ts
+declare function getMiniProgramTemplatePlatform(platform?: MpPlatform): MiniProgramPlatform;
+//#endregion
+//#region src/plugins/vue/compiler/template.d.ts
+declare function compileVueTemplateToWxml(template: string, filename: string, options?: TemplateCompileOptions): TemplateCompileResult;
+//#endregion
+//#region src/plugins/vue/compiler/template/classStyleRuntime.d.ts
+declare const CLASS_STYLE_WXS_MODULE = "__weapp_vite";
+declare const CLASS_STYLE_WXS_FILE = "__weapp_vite_class_style";
+declare function buildClassStyleWxsTag(extension: string, src?: string): string;
+declare function resolveClassStyleWxsLocation(options: {
+  relativeBase: string;
+  extension: string;
+  packageRoot?: string;
+}): {
+  fileName: string;
+  src: string;
+};
+declare function getClassStyleWxsSource(): string;
+//#endregion
+//#region src/plugins/vue/transform/classStyleComputed.d.ts
+interface ClassStyleHelperNames {
+  normalizeClassName: string;
+  normalizeStyleName: string;
+}
+declare function buildClassStyleComputedCode(bindings: ClassStyleBinding[], helpers: ClassStyleHelperNames): string | null;
+//#endregion
+//#region src/types/json.d.ts
+type JsonMergeStage = 'defaults' | 'json-block' | 'auto-using-components' | 'component-generics' | 'macro' | 'emit' | 'merge-existing';
+interface JsonMergeContext {
+  filename?: string;
+  kind?: 'app' | 'page' | 'component' | 'unknown';
+  stage: JsonMergeStage;
+}
+type JsonMergeFunction = (target: Record<string, any>, source: Record<string, any>, context: JsonMergeContext) => Record<string, any> | void;
+type JsonMergeStrategy = 'deep' | 'assign' | 'replace' | JsonMergeFunction;
+interface JsonConfig {
+  /**
+   * 产物 JSON 默认值（用于 app/page/component）
+   */
+  defaults?: {
+    app?: Record<string, any>;
+    page?: Record<string, any>;
+    component?: Record<string, any>;
+  };
+  /**
+   * JSON 合并策略
+   * - `deep`: 深合并（默认）
+   * - `assign`: 浅合并（Object.assign）
+   * - `replace`: 直接替换
+   * - `function`: 自定义合并函数
+   */
+  mergeStrategy?: JsonMergeStrategy;
+}
+//#endregion
+//#region src/types/wevu.d.ts
+interface WevuDefaults {
+  app?: Record<string, any>;
+  component?: Record<string, any>;
+}
+//#endregion
+//#region src/plugins/vue/transform/compileVueFile/types.d.ts
+interface VueTransformResult {
+  script?: string;
+  template?: string;
+  style?: string;
+  config?: string;
+  cssModules?: Record<string, Record<string, string>>;
+  scopedSlotComponents?: TemplateCompileResult['scopedSlotComponents'];
+  componentGenerics?: TemplateCompileResult['componentGenerics'];
+  classStyleWxs?: boolean;
+  meta?: {
+    hasScriptSetup?: boolean;
+    hasSetupOption?: boolean;
+    jsonMacroHash?: string;
+    defineOptionsHash?: string;
+    sfcSrcDeps?: string[];
+  };
+}
+interface AutoUsingComponentsOptions {
+  enabled?: boolean;
+  resolveUsingComponentPath?: (importSource: string, importerFilename: string, info?: {
+    localName: string;
+    importedName?: string;
+    kind: 'default' | 'named';
+  }) => Promise<string | undefined>;
+  warn?: (message: string) => void;
+}
+interface AutoImportTagsOptions {
+  enabled?: boolean;
+  resolveUsingComponent?: (tag: string, importerFilename: string) => Promise<{
+    name: string;
+    from: string;
+  } | undefined>;
+  warn?: (message: string) => void;
+}
+interface CompileVueFileOptions {
+  isPage?: boolean;
+  isApp?: boolean;
+  warn?: (message: string) => void;
+  autoUsingComponents?: AutoUsingComponentsOptions;
+  autoImportTags?: AutoImportTagsOptions;
+  template?: TemplateCompileOptions;
+  json?: {
+    kind?: 'app' | 'page' | 'component';
+    defaults?: JsonConfig['defaults'];
+    mergeStrategy?: JsonMergeStrategy;
+  };
+  sfcSrc?: ResolveSfcBlockSrcOptions;
+  wevuDefaults?: WevuDefaults;
+}
+//#endregion
+//#region src/plugins/vue/transform/compileVueFile/index.d.ts
+declare function compileVueFile(source: string, filename: string, options?: CompileVueFileOptions): Promise<VueTransformResult>;
+//#endregion
+//#region src/plugins/vue/transform/config.d.ts
+type JsLikeLang = 'js' | 'ts';
+declare function normalizeConfigLang(lang?: string): string;
+declare function isJsonLikeLang(lang: string): lang is "json" | "jsonc" | "json5";
+declare function resolveJsLikeLang(lang: string): JsLikeLang;
+declare function evaluateJsLikeConfig(source: string, filename: string, lang: string): Promise<any>;
+declare function compileConfigBlocks(blocks: SFCBlock[], filename: string, options?: {
+  merge?: (target: Record<string, any>, source: Record<string, any>) => Record<string, any> | void;
+}): Promise<string | undefined>;
+//#endregion
+//#region src/plugins/vue/transform/jsonMacros/rewrite.d.ts
+declare function stripJsonMacroCallsFromCode(code: string, filename: string): string;
+//#endregion
+//#region src/plugins/vue/transform/jsonMacros/index.d.ts
+declare function extractJsonMacroFromScriptSetup(content: string, filename: string, lang?: string, options?: {
+  merge?: (target: Record<string, any>, source: Record<string, any>) => Record<string, any> | void;
+}): Promise<{
+  stripped: string;
+  config?: Record<string, any>;
+  macroHash?: string;
+  dependencies?: string[];
+}>;
+//#endregion
+//#region src/plugins/vue/transform/jsonMerge.d.ts
+declare function mergeJsonWithStrategy(target: Record<string, any>, source: Record<string, any>, strategy: JsonMergeStrategy | undefined, context: JsonMergeContext): Record<string, any>;
+declare function createJsonMerger(strategy: JsonMergeStrategy | undefined, baseContext: Omit<JsonMergeContext, 'stage'>): (target: Record<string, any>, source: Record<string, any>, stage: JsonMergeContext["stage"]) => Record<string, any>;
+//#endregion
+//#region src/plugins/vue/transform/scopedId.d.ts
+/**
+ * 生成 scoped ID
+ */
+declare function generateScopedId(filename: string): string;
+//#endregion
+//#region src/plugins/vue/transform/transformScript/utils.d.ts
+/**
+ * 使用 Babel AST 转换脚本
+ * 比正则替换更健壮，能处理复杂的代码结构
+ */
+interface TransformResult {
+  code: string;
+  transformed: boolean;
+}
+interface TransformScriptOptions {
+  /**
+   * 是否跳过组件转换（不添加 createWevuComponent 调用）
+   * 用于 app.vue 等入口文件
+   */
+  skipComponentTransform?: boolean;
+  /**
+   * 是否是 App 入口（app.vue）
+   * App 需要调用 wevu 的 createApp() 来注册小程序 App 并挂载 app hooks。
+   */
+  isApp?: boolean;
+  /**
+   * 是否是 Page 入口（仅 Page 才需要注入 features 以启用按需派发的页面事件）
+   */
+  isPage?: boolean;
+  /**
+   * <script setup> 中引入的组件：编译时移除 import，并提供同名元信息对象占位，避免运行时访问时报错。
+   * key: 组件别名（需与模板标签一致），value: usingComponents 的 from（如 `/components/foo/index`）
+   */
+  templateComponentMeta?: Record<string, string>;
+  /**
+   * wevu 默认值（仅用于 app.vue 注入）
+   */
+  wevuDefaults?: WevuDefaults;
+  /**
+   * 编译期警告回调
+   */
+  warn?: (message: string) => void;
+  /**
+   * class/style 运行时模式
+   */
+  classStyleRuntime?: ClassStyleRuntime;
+  /**
+   * class/style 绑定元数据（JS 运行时）
+   */
+  classStyleBindings?: ClassStyleBinding[];
+  /**
+   * template ref 元数据（用于运行时绑定）
+   */
+  templateRefs?: TemplateRefBinding[];
+  /**
+   * 内联表达式元数据（用于事件处理）
+   */
+  inlineExpressions?: InlineExpressionAsset[];
+}
+//#endregion
+//#region src/plugins/vue/transform/transformScript/index.d.ts
+declare function transformScript(source: string, options?: TransformScriptOptions): TransformResult;
+//#endregion
+//#region src/plugins/wevu/pageFeatures/types.d.ts
+type WevuPageFeatureFlag = (typeof WE_VU_PAGE_HOOK_TO_FEATURE)[keyof typeof WE_VU_PAGE_HOOK_TO_FEATURE];
+type WevuPageHookName = keyof typeof WE_VU_PAGE_HOOK_TO_FEATURE;
+interface ModuleResolver {
+  resolveId: (source: string, importer: string) => Promise<string | undefined>;
+  loadCode: (id: string) => Promise<string | undefined>;
+}
+//#endregion
+//#region src/plugins/wevu/pageFeatures/flags.d.ts
+declare function collectWevuPageFeatureFlags(ast: t.File): Set<WevuPageFeatureFlag>;
+declare function injectWevuPageFeatureFlagsIntoOptionsObject(optionsObject: t.ObjectExpression, enabled: Set<WevuPageFeatureFlag>): boolean;
+//#endregion
+//#region src/plugins/wevu/pageFeatures/inject.d.ts
+declare function injectWevuPageFeaturesInJs(source: string): {
+  code: string;
+  transformed: boolean;
+};
+declare function injectWevuPageFeaturesInJsWithResolver(source: string, options: {
+  id: string;
+  resolver: ModuleResolver;
+}): Promise<{
+  code: string;
+  transformed: boolean;
+}>;
+//#endregion
+//#region src/plugins/wevu/pageFeatures/matcher.d.ts
+interface PageEntryMatcherSource {
+  srcRoot: string;
+  loadEntries: () => Promise<{
+    pages?: string[];
+    subPackages?: Array<{
+      root?: string;
+      pages?: string[];
+    }>;
+    pluginPages?: string[];
+  }>;
+  warn?: (message: string) => void;
+}
+declare function createPageEntryMatcher(source: PageEntryMatcherSource): {
+  markDirty(): void;
+  isPageFile(filePath: string): Promise<boolean>;
+};
+//#endregion
+//#region src/utils/vueTemplateTags.d.ts
+declare const RESERVED_VUE_COMPONENT_TAGS: Set<string>;
+declare const VUE_COMPONENT_TAG_RE: RegExp;
+declare function isAutoImportCandidateTag(tag: string): boolean;
+interface CollectVueTemplateTagsOptions {
+  filename?: string;
+  warnLabel?: string;
+  warn?: (message: string) => void;
+  shouldCollect: (tag: string) => boolean;
+}
+declare function collectVueTemplateTags(template: string, options: CollectVueTemplateTagsOptions): Set<string>;
+//#endregion
+export { type AutoImportTagsOptions, type AutoUsingComponentsOptions, CLASS_STYLE_WXS_FILE, CLASS_STYLE_WXS_MODULE, type ClassStyleBinding, type ClassStyleRuntime, type CollectVueTemplateTagsOptions, type CompileVueFileOptions, type ForParseResult, type InlineExpressionAsset, type JsLikeLang, type JsonConfig, type JsonMergeContext, type JsonMergeStage, type JsonMergeStrategy, type MiniProgramPlatform, type ModuleResolver, type MpPlatform, RESERVED_VUE_COMPONENT_TAGS, type ReadAndParseSfcOptions, type ResolveSfcBlockSrcOptions, type ScopedSlotComponentAsset, type StyleCompileOptions, type StyleCompileResult, type TemplateCompileOptions, type TemplateCompileResult, type TemplateRefBinding, type TransformResult, type TransformScriptOptions, VUE_COMPONENT_TAG_RE, type VueTransformResult, WE_VU_MODULE_ID, WE_VU_PAGE_HOOK_TO_FEATURE, WE_VU_RUNTIME_APIS, type WevuDefaults, type WevuPageFeatureFlag, type WevuPageHookName, WevuRuntimeApiName, alipayPlatform, buildClassStyleComputedCode, buildClassStyleWxsTag, builtinComponentsSet, clearFileCaches, collectVueTemplateTags, collectWevuPageFeatureFlags, compileConfigBlocks, compileVueFile as compileSfc, compileVueFile, compileVueStyleToWxss as compileStyle, compileVueStyleToWxss, compileVueTemplateToWxml as compileTemplate, compileVueTemplateToWxml, createJsonMerger, createPageEntryMatcher, evaluateJsLikeConfig, extractJsonMacroFromScriptSetup, generateScopedId, getClassStyleWxsSource, getMiniProgramTemplatePlatform, getSfcCheckMtime, injectWevuPageFeatureFlagsIntoOptionsObject, injectWevuPageFeaturesInJs, injectWevuPageFeaturesInJsWithResolver, invalidateFileCache, isAutoImportCandidateTag, isBuiltinComponent, isInvalidate, isJsonLikeLang, loadCache, mergeJsonWithStrategy, mtimeCache, normalizeConfigLang, pathExists, preprocessScriptSetupSrc, preprocessScriptSrc, readAndParseSfc, readFile, resolveClassStyleWxsLocation, resolveJsLikeLang, resolveSfcBlockSrc, restoreScriptSetupSrc, restoreScriptSrc, stripJsonMacroCallsFromCode, swanPlatform, transformScript, transformScript as transformSfcScript, ttPlatform, wechatPlatform };