@compelem/compiler 0.0.0-stage → 0.30.0-beta.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 holyhigh2
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,3 @@
-# Temporary Holding Version
+# @compelem/compiler
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+[compelem](https://github.com/holyhigh2/compelem) 的**编译器**

package/dist/index.d.ts

@@ -0,0 +1,279 @@
+import { a as ComponentAnalysis, c as ReactiveKind, i as CompilerOptions, n as compelemCompiler, o as DEBUG_DIV, r as CompiledStatic, s as ReactiveField, t as VitePluginOptions } from "./vite-BtG-4Z6L.js";
+
+//#region src/utils/oxc.d.ts
+interface ParsedFile {
+  program: any;
+  /** 源码中所有 import 声明：本地名 → { source, imported } */
+  imports: Map<string, {
+    source: string;
+    imported: string;
+  }>;
+}
+//#endregion
+//#region src/analyze/component.d.ts
+
+/** 判断某个 import source 是否指向 compelem 本体。 */
+declare function isCompelemSource(source: string): boolean;
+/** 从 import 表里挑出 compelem 相关绑定：本地名 → 原始导入名。 */
+declare function collectCompelemImports(imports: ParsedFile['imports']): Map<string, string>;
+/**
+ * 分析单个源文件，返回所有 compelem 组件类的信息。
+ *
+ * `extraFields` 用于合并基类字段（编译器单文件分析，跨文件继承由调用方
+ * 通过 `componentIndex` 提供；本版本仅处理同文件继承 + 无继承两种）。
+ */
+declare function analyzeFile(code: string, id: string, parsed: ParsedFile): ComponentAnalysis[];
+//#endregion
+//#region src/analyze/template.d.ts
+
+interface TemplateIssue {
+  /** 违规模板在源码中的起始/结束偏移 */
+  start: number;
+  end: number;
+  /** 违规插值表达式的偏移 */
+  exprStart: number;
+  exprEnd: number;
+  message: string;
+}
+//#endregion
+//#region src/analyze/render-body.d.ts
+
+/** 主视图依赖提取结果。 */
+interface RenderAnalysis {
+  /** 主视图依赖路径（对应 ViewDepMap） */
+  viewDeps: string[];
+  /** 子视图依赖：回调节点 start 偏移 → 路径列表 */
+  subViewDeps: Map<number, string[]>;
+  /** 降级原因列表（空表示未降级） */
+  degrades: string[];
+  /**
+   * 硬性违规（当前只有 D7：模板内直接嵌套模板）。
+   *
+   * 与 degrades 的区别：degrades 是「静态推不出，放弃注入（降级）」，
+   * errors 是「写法违反约束，必须改代码」——二者都导致降级，但 errors 需要在
+   * 构建期报给用户，因为它是可修的、且修掉后才能启用编译期产物。
+   */
+  errors: TemplateIssue[];
+}
+/** 对单个组件的 render() 做依赖分析。 */
+declare function analyzeRender(comp: ComponentAnalysis, sinks?: {
+  mainHits: any[];
+}): RenderAnalysis;
+//#endregion
+//#region src/analyze/degrade.d.ts
+
+/**
+ * 汇总单个组件的静态分析结论。
+ * 命中任何一条 ⇒ 抛错（调用方拿不到「凑合能跑」的产物）。
+ */
+declare function decideDegrade(comp: ComponentAnalysis, ra: RenderAnalysis): {
+  degraded: false;
+  reason: null;
+  errors: RenderAnalysis['errors'];
+};
+/**
+ * 静态分析未通过。`name` 让它在堆栈里一眼可辨。 */
+declare class StaticAnalysisError extends Error {
+  readonly className: string;
+  readonly reasons: string[];
+  readonly errors: RenderAnalysis['errors'];
+  constructor(className: string, reasons: string[], errors?: RenderAnalysis['errors']);
+}
+//#endregion
+//#region src/codegen/inject.d.ts
+interface InjectOptions {
+  /** 是否生成取值函数 */
+  buildVars?: boolean;
+  /** 无视图组件标记：注入 noView: true（不创建 Shadow DOM） */
+  noView?: boolean;
+}
+/** `buildStaticLiteral` 可选生成物（任一缺失则对应字段不注入）。 */
+interface StaticLiteralCodes {
+  /** per-point effect 工厂数组（值/指令点的订阅与写 DOM） */
+  pointEffects?: string;
+  /**
+   * `fx`：与 ups 逐项 1:1 的工厂数组。值点返回 effect，指令点返回 DirectiveInstance，
+   * 事件/ref 点返回 handler / ref 对象。renderTemplate 借它取首屏值，运行时按
+   * up 上的 `ux` 下标索引（Q2 的前提：ups 与工厂 1:1 后才能互查）。
+   */
+  fx?: string;
+  /** watch effect 工厂数组 */
+  watchEffects?: string;
+  /** cssVars effect 工厂（读 CSS 依赖信号 → 更新自定义属性） */
+  cssEffect?: string;
+  /** 结构指令元数据占位字段，运行时从不读取（分派参数在 pointEffects 内） */
+  dirMeta?: string;
+  buildTemplate?: string;
+  /** 子视图表（结构指令的子模板元数据）：`subViews: { <subId>: { buildTemplate, fx } }` */
+  subViews?: string;
+  /**
+   * 抽出的表达式中用到的 `super.METHOD` 名。注入到 class 体：
+   * `__ce_s_METHOD(...a){return super.METHOD(...a)}`，
+   * 保留 home-object 的 super 绑定，供静态取值函数经 `__comp` 调用。
+   */
+  superHelpers?: string[];
+  /** `__ce_static__.props` 字面量值（@prop 前移，analyze/field-extract.ts） */
+  props?: string;
+  /** `__ce_static__.states` 字面量值（@state 前移） */
+  states?: string;
+  /** `__ce_static__.computedGetters` 字面量值（@computed 前移，原 getter 体外提） */
+  computedGetters?: string;
+  /** 类体访问器源码（prop/state/computed 的 get/set + `@tag` 类的 observedAttributes），
+   *  接在 static 字面量之后注入。无 `@tag` 的类不带 observedAttributes —— 它们永不被
+   *  `customElements.define`，浏览器不会读它们的表。 */
+  accessors?: string;
+}
+/** prop/state 初始值写入语句的构造体插入点计划。 */
+interface CtorInsertPlan {
+  /** 插入点（原始源码偏移） */
+  pos: number;
+  /** true = 类无构造体 → 合成 `constructor(...__a){ super(...__a); ... }` */
+  synthesize: boolean;
+}
+/** 文件级运行时函数 import 注入参数。 */
+interface ImportInjectOptions {
+  /** 需要导入的运行时函数名（已定名，含可能的 __ce_ 别名） */
+  helpers?: string[];
+  /** 定位到的 compelem import 声明：有命名 specifier 则原位扩展，否则新增独立行 */
+  helperImport?: {
+    decl: any;
+    source: string;
+  };
+  /** 新增独立 import 行时的锚点（首个 import 起点或首语句起点） */
+  helpersAnchor?: number;
+  /** 需要从 **myfx** 注入的运行时函数名（方法装饰器前移的 debounce/throttle/once） */
+  myfxHelpers?: string[];
+  /** 定位到的 myfx import 声明：有命名 specifier 则原位扩展，否则新增独立行 */
+  myfxImport?: {
+    decl: any;
+    source: string;
+  };
+  /**
+   * 顶层语句（模块级常量，如子模板 carrier `const __ce_t0 = Object.assign(...)`），
+   * 插在 `topLevelAnchor` 之后（通常取最后一个 import 声明的末尾偏移）。
+   */
+  topLevel?: string;
+  /** topLevel 的插入锚点（紧跟其后的偏移） */
+  topLevelAnchor?: number;
+}
+/** 生成 `static __ce_static__ = {...}` 的源码文本。 */
+declare function buildStaticLiteral(opts: InjectOptions, codes?: StaticLiteralCodes): string;
+/**
+ * 把生成物注入到源文件。
+ *
+ * 多个组件在同文件时按 **end 倒序** 插入，避免前一次插入改变后一次偏移。
+ */
+declare function injectInto(code: string, edits: Array<{
+  comp: ComponentAnalysis;
+  literal: string;
+  removals?: Array<{
+    start: number;
+    end: number;
+  }>;
+  fieldInits?: Array<{
+    name: string;
+    initText: string;
+    computed?: boolean;
+  }>;
+  ctor?: CtorInsertPlan;
+  /** 方法装饰器（@debounced/@throttled/@onced）构造体注入语句 */
+  methodDecoCtor?: string;
+  /** 方法装饰器 destroy 注入语句（插到 destroy() 内） */
+  methodDecoDestroy?: string;
+}>, id: string, extras?: ImportInjectOptions): {
+  code: string;
+  map: any;
+  injected: string[];
+  additions: string[];
+};
+//#endregion
+//#region src/compile.d.ts
+/** 静态编译完成后的组件依赖清单（`options.verbose` 时打印；结构化字段供工具/survey 消费）。 */
+interface DepSummary {
+  kind: 'normal' | 'noView' | 'skipInjection';
+  /** 主视图响应式依赖（仅 verbose 依赖清单展示，不注入产物） */
+  viewDeps: string[];
+  /** cssVars getter 依赖；undefined = 未提取到 */
+  cssDeps?: string[];
+  /** @computed getter 依赖；undefined = 未提取到（该类全部 key 由运行时全根兜底） */
+  computedDeps?: Record<string, string[]>;
+  /** 结构指令子视图依赖（subId → 路径）；undefined = 未提取到 */
+  subViewDeps?: Record<number, string[]>;
+  /** @watch 编译期解析产物（sources 即监视依赖） */
+  watchers?: Array<{
+    name: string;
+    sources: string[];
+  }>;
+  /** 主视图更新映射：每根变量 → 取值槽位 → 更新点下标 → DOM 点位（normal 组件且 verbose 展示时） */
+  varMap?: VarMapEntry[];
+  /** 子视图更新映射：subId → 每根路径的槽位/updater/DOM */
+  subVarMap?: Record<number, VarMapEntry[]>;
+}
+interface CompileResult {
+  code: string;
+  map: any;
+  /** 本次编译的诊断信息（组件级） */
+  diagnostics: Array<{
+    className: string;
+    degraded: boolean;
+    reason: string | null;
+    viewDeps: number;
+    /** 硬性违规（D7 嵌套模板），需在构建期暴露给用户 */
+    errors: Array<{
+      start: number;
+      end: number;
+      exprStart: number;
+      exprEnd: number;
+      message: string;
+    }>;
+    /** 约定错误（emit/@prop/@computed/@csscope 静态校验），与降级无关 */
+    conventionErrors: Array<{
+      start: number;
+      end: number;
+      message: string;
+    }>;
+    /** 静态依赖清单（每组件无条件填充；options.verbose 时输出人类可读格式） */
+    deps?: DepSummary;
+  }>;
+  /** 是否发生了源码改动 */
+  changed: boolean;
+  /** 本次编译从源码删除的 span（装饰器/字段成员/静态准入组件的 render 体，原始偏移；供最小侵入校验还原比对） */
+  removals?: Array<{
+    start: number;
+    end: number;
+  }>;
+  /** 本次编译新增的源码片段（注入的 import 片段 / 构造体写入语句；供最小侵入校验剥离） */
+  additions?: string[];
+}
+/** 单个根变量的更新映射（依赖清单展示）：根 → 取值槽位 → 更新点下标 → DOM 点位。 */
+interface VarMapEntry {
+  /** 根名（`''` = 常脏：动态 this / 不纯 / 未分类表达式） */
+  root: string;
+  /** 根类别：已知字段 kind / 自有 getter / 自有方法 / 跨文件未声明（基类 prop、state、@computed 等） */
+  kind?: 'prop' | 'state' | 'computed' | 'getter' | 'method' | 'unknown';
+  /** 该根驱动的取值槽位下标（脏集，仅对脏槽求值） */
+  vars: number[];
+  /** 消费这些槽位的更新点：updater = ups 数组下标（与 ups 同序），dom = 节点名 + 点位 */
+  updates: Array<{
+    updater: number;
+    dom: string;
+  }>;
+}
+/**
+ * 默认的参与编译判定：`.ts` 且源码里出现 `extends CompElem` 或 `@tag`。
+ *
+ * 额外放行**家族装饰器**形态：mixin 文件（`export function mix(B) { class M extends B { @prop … } }`）
+ * 既不含 `extends CompElem` 也不含 `@tag`（`@tag` 挂在具体组件上），但必须参与编译，
+ * 否则其中的 `@prop/@state/@computed` 不会被剥离、注入的 `__ce_static__` 缺失，
+ * 而运行时这几个装饰器是 no-op ⇒ 属性静默退化成普通实例字段。
+ * 精确性由 `collectMixinClasses` 的「顶层函数体内 + 带 compelem 家族装饰器」把关，
+ * 这里放宽只是让文件进入管线。
+ *
+ * ⚠️ 保持只收 `.ts`：IIFE 打包产物（`.js`）里指令名不在 scope，放宽会触发 D3 误报。
+ */
+declare function defaultInclude(id: string, code: string): boolean;
+/** 编译单个文件。不会抛出：解析失败时原样返回。 */
+declare function compileFile(code: string, id: string, options?: CompilerOptions): CompileResult;
+//#endregion
+export { type CompileResult, type CompiledStatic, type CompilerOptions, type ComponentAnalysis, DEBUG_DIV, type DepSummary, type ReactiveField, type ReactiveKind, type RenderAnalysis, StaticAnalysisError, type VitePluginOptions, analyzeFile, analyzeRender, buildStaticLiteral, collectCompelemImports, compelemCompiler, compileFile, decideDegrade, defaultInclude, injectInto, isCompelemSource };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -0,0 +1,3 @@
+import { a as buildStaticLiteral, c as analyzeRender, d as analyzeFile, f as collectCompelemImports, i as defaultInclude, l as StaticAnalysisError, o as injectInto, p as isCompelemSource, r as compileFile, s as DEBUG_DIV, t as compelemCompiler, u as decideDegrade } from "./vite-DU4Nznh4.js";
+
+export { DEBUG_DIV, StaticAnalysisError, analyzeFile, analyzeRender, buildStaticLiteral, collectCompelemImports, compelemCompiler, compileFile, decideDegrade, defaultInclude, injectInto, isCompelemSource };

package/dist/vite-BtG-4Z6L.d.ts

@@ -0,0 +1,220 @@
+//#region src/types.d.ts
+/**
+ * @compelem/compiler — 类型定义
+ *
+ * 与 compelem 侧 `CompiledStatic`（src/types.ts）保持结构一致。
+ * 双份定义的取舍：compiler 不应强依赖 compelem 的类型包（peer 可选），
+ * 因此本地镜像一份，并在 `test/` 里做一致性断言防止漂移。
+ */
+/**
+ * 每个类的 `props`/`states`/`computedGetters` 都是**沿构造器原型链浅替换合并后的
+ * 完整表**（子类字面量叠加 `Reflect.getPrototypeOf(this).__ce_static__`）。
+ */
+/** debug 分块产物的整行注释前缀：`//////// …… <标签>`（纯注释、不改行为）。产物默认按块生成，无开关。 */
+declare const DEBUG_DIV = "////////////////////////////////////";
+/**
+ * 编译器注入到组件类上的静态成员。
+ * 强制编译插件模式：`buildTemplate` 准入静态视图路径（缺失 = 无视图，无运行时回退）；
+ * 其余字段可选。取值表达式一律内联进 fx/pointEffects 工厂，产物不携带取值函数或
+ * 静态依赖元数据；依赖在 effect 运行期动态建立（DepSummary 仅在 compile.ts 内部
+ * 计算，供 verbose 展示）。
+ */
+interface CompiledStatic {
+  version: number;
+  /**
+   * `buildTemplate` 静态实现：纯 `document` API 建 DOM 函数
+   * （以首个组件实例为 `this` 调用；与 compelem 侧 `CompiledStatic.buildTemplate` 同形）。
+   */
+  buildTemplate?: (this: any) => {
+    fragment: any;
+    ups: any[];
+    emptyEvents?: Record<number, string[]>;
+    /** 文档序元素+文本节点（与 nodeSn 对齐；运行时免 collectNodes 回扫） */
+    nodes?: any[];
+    updateSns?: number[];
+    updatePaths?: number[][];
+  };
+  /** `@watch` 编译期解析产物（`analyze/watch-extract.ts` 序列化，装饰器被删时必须注入） */
+  watchers?: CompiledWatcher[];
+  /**
+   * 结构指令模板回调的子视图 codegen：`__subId` → 独立 buildTemplate + fx/pointEffects。
+   * 运行时结构指令经 `fn.__subId` 查表消费；缺失按构建期报错处理。
+   */
+  subViews?: Record<number, {
+    buildTemplate?: (this: any) => {
+      fragment: any;
+      ups: any[];
+      emptyEvents?: Record<number, string[]>;
+      nodes?: any[];
+      updateSns?: number[];
+      updatePaths?: number[][];
+    };
+  }>;
+  /**
+   * 无视图组件标记：render() 不存在 / 返回 null / 继承链终点为 CompElem（其
+   * `render()` 返回 null）。注入后运行时不创建 Shadow DOM，仅支持 HOST/GLOBAL 样式。
+   */
+  noView?: boolean;
+}
+/** `@watch` 编译期解析条目（与 compelem `CompiledWatcher` 同形） */
+interface CompiledWatcher {
+  name: string;
+  sources: string[];
+  deep?: boolean;
+  immediate?: boolean;
+  once?: boolean;
+  static?: boolean;
+}
+/** 响应式字段类别，用于判定「该成员是否会被推入依赖收集列表」。 */
+type ReactiveKind = 'prop' | 'state' | 'computed';
+/** 组件内一个响应式成员的信息。 */
+interface ReactiveField {
+  name: string;
+  kind: ReactiveKind;
+  /** 静态初始化器里的默认值表达式源码（用于静态取值内联），无则 undefined */
+  init?: string;
+  /** 是否为深层对象（init 是对象/数组字面量），影响依赖路径展开 */
+  shallow: boolean;
+}
+/** 一个组件的完整静态分析结果。 */
+interface ComponentAnalysis {
+  className: string;
+  /**
+   * 该组件的 class AST 节点本体。
+   *
+   * 直接随分析结果下发节点本身：按名反查 `localClasses` 只覆盖**模块顶层**的
+   * `ClassDeclaration`，mixin 工厂内的类在函数作用域里按名查不到，会让
+   * `field-extract` / `watch-extract` / `conventions` 拿到 `undefined` 而静默
+   * 什么都不做。
+   */
+  cls?: any;
+  /** 源文件中该 class 声明的起始/结束偏移（用于 MagicString 注入） */
+  start: number;
+  end: number;
+  /**
+   * 类体左花括号 `{` 的源码偏移（`cls.body.start`）。
+   *
+   * 注入锚点必须是它，不能用 `code.indexOf('{', start)` —— `extends mixin({ a: 1 })`
+   * 里第一个 `{` 落在 extends 子句中，扫到那里会把 `static __ce_static__` 插进
+   * 对象字面量里，产出整模块语法错误。-1 表示无 AST 可用（调用方应回退扫描）。
+   */
+  bodyStart: number;
+  /** `@tag` 名称，无则 undefined */
+  tagName?: string;
+  /** 响应式字段（含继承链上收集到的，按声明顺序） */
+  fields: Map<string, ReactiveField>;
+  /** 本类自身定义的实例方法名（用于 D2 降级判定） */
+  ownMethods: Set<string>;
+  /** 本类自身定义的 getter 名（`@computed` 之外的普通 getter，D2 视为方法） */
+  ownGetters: Set<string>;
+  /** 是否有 render() */
+  hasRender: boolean;
+  /** render() 函数体 AST（Program 级 node），无则 null */
+  renderBody: any | null;
+  /** render() 函数体在源码中的偏移区间（不含大括号） */
+  renderBodyStart: number;
+  renderBodyEnd: number;
+  /** `get cssVars()` 函数体语句数组（无则 null），供 cssDeps 静态提取 */
+  cssVarsBody: any[] | null;
+  /** `@computed` getter 名 → 函数体语句数组，供 computedDeps 静态提取 */
+  computedBodies: Map<string, any[]>;
+  /** `@query` / `@queryAll` 字段名（非响应式 DOM 查询属性，依赖提取按死条目记录） */
+  queryFields?: Set<string>;
+  /** 本类方法 / getter / 箭头字段的函数体（name → BlockStatement 节点或表达式体），供依赖提取内联扫描 */
+  bodies?: Map<string, any>;
+  /** 降级原因；null 表示未降级 */
+  degradeReason: string | null;
+  /** 无视图组件（render() 不存在 / 返回 null / 继承链终点为 CompElem）→ 注入 noView: true */
+  noView: boolean;
+  /** 跳过注入（同文件继承链上有 render 的祖先，继承其 __ce_static__）→ 不生成注入语句 */
+  skipInjection: boolean;
+  /**
+   * **mixin 工厂内的 class 声明**（`export function mix(B) { class M extends B {} ; return M }`）。
+   *
+   * super 是调用方传入的形参 ⇒ 静态不可知链：不做 D6 报错、无 own render 时一律
+   * `skipInjection`（绝不判 `noView`，否则基类有视图时会静默白屏）。
+   * 家族表（props/states/computedGetters）的合并走 `Reflect.getPrototypeOf(this)`，
+   * 与本标记无关，mixin 声明的 @prop 会沿链传递到具体组件。
+   *
+   * 写法约束：必须是 class **声明**，不能是 class **表达式** —— TS 禁止在 class
+   * 表达式上写装饰器（TS1206），能带 `@prop` 的形态只有 class 声明。
+   */
+  isMixin?: boolean;
+  /** 静态导入绑定：本地名 → 从 compelem 导入的原始名 */
+  compelemImports: Map<string, string>;
+  /**
+   * 模块级绑定名（顶层 const/let/var/function/class，以及全部 import 的本地名）。
+   * 用于 D3 判定：这些名字不是「自由标识符」。
+   */
+  moduleBindings: Set<string>;
+}
+/** 插件选项。 */
+interface CompilerOptions {
+  /**
+   * 参与编译的文件过滤。默认只处理 `.ts` 且源码里出现 `extends CompElem` 的文件。
+   * ⚠️ 不要放宽到 `.js`：IIFE 打包产物里指令名不在 scope，会触发 D3 误报。
+   */
+  include?: (id: string, code: string) => boolean;
+  /**
+   * verbose 日志：依赖清单人类可读打印（vite 插件侧同时打印每文件编译状态行）。
+   * 也可用环境变量 `CE_DEPS_DEBUG`（非空且非 '0'）单独开启清单打印，无需改配置。
+   * 注：产物的块分隔注释（`//////// …… <标签>`）默认始终生成，与本选项无关。
+   */
+  verbose?: boolean;
+  /**
+   * 跨文件标签注册表：已知组件的 kebab 标签名（大小写不敏感）。
+   * 用于 SLOT 判定与 `.prop` 目标校验；vite 插件可跨文件累积后注入
+   * （TEMPLATE-CODEGEN.md §4）。
+   */
+  knownTags?: Iterable<string>;
+  /** 关闭指定生成步骤（用于 A/B 实测对照） */
+  disable?: {
+    buildVars?: boolean;
+  };
+}
+//#endregion
+//#region src/vite.d.ts
+/** 极简的结构化插件类型，避免硬依赖 vite 的 types（peer 里 vite 是可选的）。 */
+interface MinimalPlugin {
+  name: string;
+  enforce?: 'pre' | 'post';
+  transform?: (code: string, id: string) => {
+    code: string;
+    map: any;
+  } | null | undefined;
+  configResolved?: (config: any) => void;
+  buildStart?: (this: any) => void | Promise<void>;
+}
+interface VitePluginOptions extends CompilerOptions {
+  /** 是否输出每个文件的编译诊断 */
+  verbose?: boolean;
+  /**
+   * D7（模板内直接嵌套模板）命中的处理力度。
+   * - `'warn'`（默认）：仅控制台提示 D7 消息
+   * - `'error'`：直接阻断构建，用于 CI 强制把关
+   * - `'silent'`：不提示
+   */
+  d7?: 'warn' | 'error' | 'silent';
+  /**
+   * 约定错误（E-*：emit 未声明/非字面量、@prop 缺 type/命名/赋值、@computed 非 getter、
+   * @csscope 非 static getter）的处理力度。默认 `'error'` —— 约定违规直接阻断构建。
+   */
+  conventions?: 'error' | 'warn' | 'silent';
+  /**
+   * 调试用：把编译产物写到源文件同级（`foo.ts` → `foo.js`），便于直接查看
+   * 注入后的 `__ce_static__` / buildTemplate / pointEffects / fx。
+   * 仅对真实文件生效（跳过 `?v=` 之类的虚拟 id），且只在编译确有改动时写。
+   */
+  emitJs?: boolean;
+  /**
+   * 调试编译产物用：令 sourcemap 以上游注入后的 TS 为 0 级原�?   * 这样 DevTools 直接显示编译后代码（含 `__ce_static__` / buildTemplate / fx），
+   * 在这些区域打的断点能命中。代价：跳过「编译后代码 → 原始模板」的映射，
+   * 栈帧行号指向注入后的 TS 而非用户源码里的模板位置。默认 `false`。
+   */
+  debugSourceMap?: boolean;
+}
+/** compelem 编译期优化插件。 */
+declare function compelemCompiler(options?: VitePluginOptions): MinimalPlugin;
+//#endregion
+export { ComponentAnalysis as a, ReactiveKind as c, CompilerOptions as i, compelemCompiler as n, DEBUG_DIV as o, CompiledStatic as r, ReactiveField as s, VitePluginOptions as t };
+//# sourceMappingURL=vite-BtG-4Z6L.d.ts.map