@compelem/compiler 0.30.0-beta.4 → 0.30.0-beta.5

package/dist/index.d.ts

@@ -273,6 +273,73 @@ interface VarMapEntry {
 declare function defaultInclude(id: string, code: string): boolean;
 /** 编译单个文件。解析失败时原样返回；静态分析/模板 codegen 失败会抛 StaticAnalysisError。 */
 declare function compileFile(code: string, id: string, options?: CompilerOptions): CompileResult;
+/**
+ * 编译**已确定要编译**的源码，跳过 `include` 判定。
+ *
+ * 与 {@link compileFile} 的分工：
+ * - `compileFile` 面向「磁盘上可能是组件、也可能不是」的输入，先按扩展名 +
+ *   特征做 include 判定；
+ * - `compileSource` 面向「调用方已经决定要编译」的输入 —— 典型是 SFC 插件把
+ *   `.ce` 分段拼成的虚拟 TypeScript 模块。虚拟模块的 id 仍是 `.ce`（为了
+ *   sourcemap 指向真实文件），天然过不了 `defaultInclude` 的扩展名检查，
+ *   以前只能传 `include: () => true` 绕过整个判定（连 node_modules 排除也一起绕过）。
+ *
+ * `options.include` 在这里被忽略。
+ */
+declare function compileSource(code: string, id: string, options?: CompilerOptions): CompileResult;
+//#endregion
+//#region src/diagnostics.d.ts
+/** 约定违规的处理力度：error 阻断构建 / warn 控制台提示 / silent 忽略。 */
+type ConventionMode = 'error' | 'warn' | 'silent';
+/** 已格式化为 `文件:行:列 [类名] 消息` 的两组诊断文本。 */
+interface CollectedDiagnostics {
+  errs: string[];
+  warns: string[];
+}
+/** 惰性构建换行偏移索引（升序；仅在有诊断时付费一次）。 */
+declare function newlineIndex(code: string): Int32Array;
+/** 把源码偏移换算成 `行:列`（1 起算）；带换行索引时走二分（O(log n)）。 */
+declare function offsetToLineCol(code: string, offset: number, nl?: Int32Array): string;
+/** 相对 root 的展示路径（统一正斜杠，便于点击跳转）。 */
+declare function relativeToRoot(id: string, root: string): string;
+/**
+ * 从 diagnostics 收集**约定诊断**为可上报文本，按 severity 分为 errs（E-*）与 warns（W-*）。
+ *
+ * `root` 只用于把绝对路径压成相对路径，不影响判定。
+ */
+declare function collectDiagnostics(res: CompileResult, code: string, id: string, root: string): CollectedDiagnostics;
+/**
+ * 按 mode 上报违规：error 走插件上下文的 `this.error`（阻断构建），warn 走控制台。
+ *
+ * `thisArg` 是 Rollup/Vite 的插件上下文；纯 API 调用时传 undefined 也能工作
+ * （退化为 `throw`）。
+ */
+declare function reportDiagnostics(msgs: string[], mode: ConventionMode, head: string, thisArg: any): void;
+/**
+ * 一站式上报：W 码恒为控制台提示（不随档位阻断），E 码按 mode 处理。
+ *
+ * 返回是否发生了阻断（仅用于调用方决定是否继续）。
+ */
+declare function reportConventionDiagnostics(collected: CollectedDiagnostics, mode: ConventionMode, thisArg: any, tag?: string): void;
+//#endregion
+//#region src/tag-registry.d.ts
+/** `@tag('x-foo')` / `@tag(\`x-foo\`)`；一次扫描内复用，调用方负责重置 lastIndex。 */
+declare const TAG_RE: RegExp;
+/** 默认只把 `.ts` / `.tsx` 当作组件来源。 */
+declare const DEFAULT_TAG_EXT: RegExp;
+interface ScanKnownTagsOptions {
+  /** 参与扫描的文件扩展名正则，默认 {@link DEFAULT_TAG_EXT}。 */
+  extensions?: RegExp;
+  /** 目录递归深度上限，默认 20。 */
+  maxDepth?: number;
+}
+/**
+ * 递归收集 root 下匹配 `extensions` 的文件里的 `@tag` 名，写入 `out`。
+ *
+ * 读失败的文件直接跳过：注册表是 best-effort 的，它只会**放宽**校验，
+ * 不该让一次权限错误打断构建。`node_modules` 等目录不参与扫描。
+ */
+declare function scanKnownTags(root: string, out: Set<string>, options?: ScanKnownTagsOptions): void;
 //#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, assertStaticAnalysis, buildStaticLiteral, collectCompelemImports, compelemCompiler, compileFile, defaultInclude, injectInto, inlineTemplateMethods, isCompelemSource, parse };
+export { type CollectedDiagnostics, type CompileResult, type CompiledStatic, type CompilerOptions, type ComponentAnalysis, type ConventionMode, DEBUG_DIV, DEFAULT_TAG_EXT, type DepSummary, type ReactiveField, type ReactiveKind, type RenderAnalysis, type ScanKnownTagsOptions, StaticAnalysisError, TAG_RE, type VitePluginOptions, analyzeFile, analyzeRender, assertStaticAnalysis, buildStaticLiteral, collectCompelemImports, collectDiagnostics, compelemCompiler, compileFile, compileSource, defaultInclude, injectInto, inlineTemplateMethods, isCompelemSource, newlineIndex, offsetToLineCol, parse, relativeToRoot, reportConventionDiagnostics, reportDiagnostics, scanKnownTags };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -1,3 +1,3 @@
-import { a as buildStaticLiteral, c as StaticAnalysisError, d as analyzeRender, f as analyzeFile, h as parse, i as defaultInclude, l as assertStaticAnalysis, m as isCompelemSource, o as injectInto, p as collectCompelemImports, r as compileFile, s as DEBUG_DIV, t as compelemCompiler, u as inlineTemplateMethods } from "./vite-CY_6E-Ut.js";
+import { C as collectCompelemImports, S as analyzeFile, T as parse, _ as DEBUG_DIV, a as scanKnownTags, b as inlineTemplateMethods, c as offsetToLineCol, d as reportDiagnostics, f as compileFile, g as injectInto, h as buildStaticLiteral, i as TAG_RE, l as relativeToRoot, m as defaultInclude, o as collectDiagnostics, p as compileSource, r as DEFAULT_TAG_EXT, s as newlineIndex, t as compelemCompiler, u as reportConventionDiagnostics, v as StaticAnalysisError, w as isCompelemSource, x as analyzeRender, y as assertStaticAnalysis } from "./vite-CLK9td6W.js";
 
-export { DEBUG_DIV, StaticAnalysisError, analyzeFile, analyzeRender, assertStaticAnalysis, buildStaticLiteral, collectCompelemImports, compelemCompiler, compileFile, defaultInclude, injectInto, inlineTemplateMethods, isCompelemSource, parse };
+export { DEBUG_DIV, DEFAULT_TAG_EXT, StaticAnalysisError, TAG_RE, analyzeFile, analyzeRender, assertStaticAnalysis, buildStaticLiteral, collectCompelemImports, collectDiagnostics, compelemCompiler, compileFile, compileSource, defaultInclude, injectInto, inlineTemplateMethods, isCompelemSource, newlineIndex, offsetToLineCol, parse, relativeToRoot, reportConventionDiagnostics, reportDiagnostics, scanKnownTags };

package/dist/{vite-CY_6E-Ut.js → vite-CLK9td6W.js}

@@ -5287,78 +5287,93 @@ function checkTemplateRules(tree, tmpl, comp, ctx, knownTags) {
 			});
 		}
 	}
-	for (const el of elements) for (const a of el.attrs) {
-		if (a.name.includes("⟬")) continue;
-		const varPart = a.parts.find((p) => p.type === "var");
-		const varCount = a.parts.filter((p) => p.type === "var").length;
-		if (a.name.startsWith("@") && !a.name.startsWith("@mutate")) {
-			const segs = a.name.slice(1).split(".");
-			const evName = (segs[0] ?? "").toLowerCase();
-			const mods = segs.slice(1);
-			const compEmits = localEmits.get(el.tag.toLowerCase());
-			if (!!compEmits && matchEmitName(compEmits, evName)) {
-				const bad = mods.filter((mo) => !COMP_EVENT_MODS.has(mo) && !EVENT_FLOW_MOD_RE.test(mo));
-				if (bad.length) errs.push({
+	for (const el of elements) {
+		const seenDirectives = /* @__PURE__ */ new Set();
+		for (const a of el.attrs) {
+			if (!a.name.includes("⟬")) continue;
+			const dm = /⟬Ċ⟭(\d+)/.exec(a.name);
+			if (!dm) continue;
+			const dv = tmpl.vars[+dm[1]];
+			if (!dv?.isDirectiveCall || !dv.directiveName) continue;
+			if (seenDirectives.has(dv.directiveName)) errs.push({
+				...pos,
+				message: `E-DIRECTIVE-DUP: 元素 <${el.tag}> 上的指令 '${dv.directiveName}' 出现了两次以上；同一元素每种指令只能写一次（重复的那份运行期会被静默丢弃）`
+			});
+			else seenDirectives.add(dv.directiveName);
+		}
+		for (const a of el.attrs) {
+			if (a.name.includes("⟬")) continue;
+			const varPart = a.parts.find((p) => p.type === "var");
+			const varCount = a.parts.filter((p) => p.type === "var").length;
+			if (a.name.startsWith("@") && !a.name.startsWith("@mutate")) {
+				const segs = a.name.slice(1).split(".");
+				const evName = (segs[0] ?? "").toLowerCase();
+				const mods = segs.slice(1);
+				const compEmits = localEmits.get(el.tag.toLowerCase());
+				if (!!compEmits && matchEmitName(compEmits, evName)) {
+					const bad = mods.filter((mo) => !COMP_EVENT_MODS.has(mo) && !EVENT_FLOW_MOD_RE.test(mo));
+					if (bad.length) errs.push({
+						...pos,
+						severity: "warn",
+						message: `W-EVENT-COMP-MODIFIER: '${a.name}' 是组件事件（${el.tag} 的 @emits 已声明 '${evName}'），运行期只应用 debounce/throttle/once，[${bad.join(", ")}] 会被静默丢弃`
+					});
+				} else if (!KEY_EVENTS.has(evName) && NATIVE_EVENTS.has(evName)) {
+					const bad = mods.filter((mo) => !EVENT_PLAIN_MODS.has(mo) && !EVENT_FLOW_MOD_RE.test(mo));
+					if (bad.length) errs.push({
+						...pos,
+						message: `E-EVENT-MODIFIER: '${a.name}' 中的 [${bad.join(", ")}] 不是内置修饰符；运行期会把它当作 KeyboardEvent.key 过滤，而 '${evName}' 不是键盘事件 ⇒ 处理器恒不触发`
+					});
+				}
+				if (varCount === 0 && mods.length === 0) errs.push({
 					...pos,
 					severity: "warn",
-					message: `W-EVENT-COMP-MODIFIER: '${a.name}' 是组件事件（${el.tag} 的 @emits 已声明 '${evName}'），运行期只应用 debounce/throttle/once，[${bad.join(", ")}] 会被静默丢弃`
-				});
-			} else if (!KEY_EVENTS.has(evName) && NATIVE_EVENTS.has(evName)) {
-				const bad = mods.filter((mo) => !EVENT_PLAIN_MODS.has(mo) && !EVENT_FLOW_MOD_RE.test(mo));
-				if (bad.length) errs.push({
-					...pos,
-					message: `E-EVENT-MODIFIER: '${a.name}' 中的 [${bad.join(", ")}] 不是内置修饰符；运行期会把它当作 KeyboardEvent.key 过滤，而 '${evName}' 不是键盘事件 ⇒ 处理器恒不触发`
+					message: `W-EVENT-NO-HANDLER: '${a.name}' 没有插值处理器，运行期只注册空监听器（noop）——是否遗漏了 \${…}？`
 				});
 			}
-			if (varCount === 0 && mods.length === 0) errs.push({
-				...pos,
-				severity: "warn",
-				message: `W-EVENT-NO-HANDLER: '${a.name}' 没有插值处理器，运行期只注册空监听器（noop）——是否遗漏了 \${…}？`
-			});
-		}
-		if (a.name.startsWith(".") && varCount === 0) {
-			errs.push({
-				...pos,
-				message: `E-PROP-INTERP: Prop '${a.name}' 必须是插值（.foo="\${expr}"）；静态值请直接写属性或改用 bind 指令`
-			});
-			continue;
-		}
-		if (a.name.startsWith("@mutate")) {
-			if (!a.name.slice(1).split(".").slice(1).some((mo) => MUTATE_TYPE_MODS.has(mo))) errs.push({
-				...pos,
-				message: `E-MUTATE-MODIFIER: 事件 '${a.name}' 缺少变异类型修饰符，必须使用 @mutate.attr/child/char/tree 之一（裸 @mutate 运行期无法 observe）`
-			});
-		}
-		if (a.name.startsWith("@") && varCount === 1 && varPart) {
-			const exprSource = tmpl.vars[varPart.index]?.exprSource ?? "";
-			if (INLINE_FN_RE.test(exprSource)) continue;
-			const m = THIS_MEMBER_RE.exec(exprSource);
-			if (m) {
-				const name = m[1];
-				if (members === null || members.has(name) || KNOWN_BASE_MEMBERS.has(name)) continue;
+			if (a.name.startsWith(".") && varCount === 0) {
 				errs.push({
 					...pos,
-					message: `E-EVENT-FN: 事件 '${a.name}' 的处理器 '${exprSource}' 不是组件 ${comp.className} 的成员`
+					message: `E-PROP-INTERP: Prop '${a.name}' 必须是插值（.foo="\${expr}"）；静态值请直接写属性或改用 bind 指令`
 				});
+				continue;
 			}
-			continue;
-		}
-		if (a.name === "ref" && varCount === 1 && varPart) {
-			const exprSource = tmpl.vars[varPart.index]?.exprSource ?? "";
-			const m = THIS_MEMBER_RE.exec(exprSource);
-			if (m && members !== null) {
-				const name = m[1];
-				if (!members.has(name)) errs.push({
+			if (a.name.startsWith("@mutate")) {
+				if (!a.name.slice(1).split(".").slice(1).some((mo) => MUTATE_TYPE_MODS.has(mo))) errs.push({
 					...pos,
-					message: `E-REF-TYPE: ref 绑定的 '${exprSource}' 不是组件 ${comp.className} 的成员`
+					message: `E-MUTATE-MODIFIER: 事件 '${a.name}' 缺少变异类型修饰符，必须使用 @mutate.attr/child/char/tree 之一（裸 @mutate 运行期无法 observe）`
 				});
-				else {
-					const member = findMemberNode(comp, ctx, name);
-					if (member?.type === "PropertyDefinition" && member.value != null) {
-						if (!isCreateRefCall(member.value, comp)) errs.push({
-							...pos,
-							message: `E-REF-TYPE: ref 绑定的 '${exprSource}' 初始化器不是 createRef() 调用，运行时将报「Ref must be a RefObject」`
-						});
+			}
+			if (a.name.startsWith("@") && varCount === 1 && varPart) {
+				const exprSource = tmpl.vars[varPart.index]?.exprSource ?? "";
+				if (INLINE_FN_RE.test(exprSource)) continue;
+				const m = THIS_MEMBER_RE.exec(exprSource);
+				if (m) {
+					const name = m[1];
+					if (members === null || members.has(name) || KNOWN_BASE_MEMBERS.has(name)) continue;
+					errs.push({
+						...pos,
+						message: `E-EVENT-FN: 事件 '${a.name}' 的处理器 '${exprSource}' 不是组件 ${comp.className} 的成员`
+					});
+				}
+				continue;
+			}
+			if (a.name === "ref" && varCount === 1 && varPart) {
+				const exprSource = tmpl.vars[varPart.index]?.exprSource ?? "";
+				const m = THIS_MEMBER_RE.exec(exprSource);
+				if (m && members !== null) {
+					const name = m[1];
+					if (!members.has(name)) errs.push({
+						...pos,
+						message: `E-REF-TYPE: ref 绑定的 '${exprSource}' 不是组件 ${comp.className} 的成员`
+					});
+					else {
+						const member = findMemberNode(comp, ctx, name);
+						if (member?.type === "PropertyDefinition" && member.value != null) {
+							if (!isCreateRefCall(member.value, comp)) errs.push({
+								...pos,
+								message: `E-REF-TYPE: ref 绑定的 '${exprSource}' 初始化器不是 createRef() 调用，运行时将报「Ref must be a RefObject」`
+							});
+						}
 					}
 				}
 			}
@@ -8444,55 +8459,28 @@ function compileFile(code, id, options = {}) {
 		additions
 	};
 }
-
-//#endregion
-//#region src/vite.ts
-const TAG_RE = /@tag\(\s*['"]([^'"]+)['"]/g;
 /**
-* 用于 transform 缓存键的按文件指纹（见 tagFingerprint）。
-*/
-const FILE_HYPHEN_TAG_RE = /<([a-z][a-z0-9]*(?:-[a-z0-9]+)+)/g;
-/**
-* 按文件标签指纹（替代全局 `knownTags.size`）。
+* 编译**已确定要编译**的源码，跳过 `include` 判定。
+*
+* 与 {@link compileFile} 的分工：
+* - `compileFile` 面向「磁盘上可能是组件、也可能不是」的输入，先按扩展名 +
+*   特征做 include 判定；
+* - `compileSource` 面向「调用方已经决定要编译」的输入 —— 典型是 SFC 插件把
+*   `.ce` 分段拼成的虚拟 TypeScript 模块。虚拟模块的 id 仍是 `.ce`（为了
+*   sourcemap 指向真实文件），天然过不了 `defaultInclude` 的扩展名检查，
+*   以前只能传 `include: () => true` 绕过整个判定（连 node_modules 排除也一起绕过）。
+*
+* `options.include` 在这里被忽略。
 */
-function tagFingerprint(usedTags, knownTags) {
-	if (usedTags.size === 0) return "";
-	const inter = [];
-	for (const t of usedTags) if (knownTags.has(t)) inter.push(t);
-	if (inter.length === 0) return "";
-	inter.sort();
-	return hash32(inter.join("\n"));
-}
-const SKIP_DIRS = new Set([
-	"node_modules",
-	"dist",
-	"build",
-	"out",
-	"coverage"
-]);
-/** 递归收集 root 下 .ts/.tsx 的 @tag 名（跨文件标签注册表，TEMPLATE-CODEGEN.md §4）。 */
-function scanKnownTags(root, out, depth = 0) {
-	if (depth > 20) return;
-	let entries;
-	try {
-		entries = readdirSync(root, { withFileTypes: true });
-	} catch {
-		return;
-	}
-	for (const e of entries) {
-		if (e.name.startsWith(".")) continue;
-		if (e.isDirectory()) {
-			if (SKIP_DIRS.has(e.name)) continue;
-			scanKnownTags(join(root, e.name), out, depth + 1);
-		} else if (/\.tsx?$/.test(e.name) && !e.name.endsWith(".d.ts")) try {
-			const code = readFileSync(join(root, e.name), "utf-8");
-			if (code.indexOf("@tag") < 0 && code.indexOf("CompElem") < 0) continue;
-			TAG_RE.lastIndex = 0;
-			let m;
-			while (m = TAG_RE.exec(code)) out.add(m[1].toLowerCase());
-		} catch {}
-	}
+function compileSource(code, id, options = {}) {
+	return compileFile(code, id, {
+		...options,
+		include: () => true
+	});
 }
+
+//#endregion
+//#region src/diagnostics.ts
 /** 惰性构建换行偏移索引（升序；仅在有诊断时付费一次）。 */
 function newlineIndex(code) {
 	const arr = [];
@@ -8519,13 +8507,22 @@ function offsetToLineCol(code, offset, nl) {
 	const lastNl = lo > 0 ? nl[lo - 1] : -1;
 	return `${lo + 1}:${offset - lastNl}`;
 }
+/** 相对 root 的展示路径（统一正斜杠，便于点击跳转）。 */
+function relativeToRoot(id, root) {
+	const norm = (s) => s.replace(/\\/g, "/");
+	const rel = norm(id);
+	const base = norm(root);
+	return rel.startsWith(base) ? rel.slice(base.length + 1) : id;
+}
 /**
-* 从 diagnostics 收集**约定诊断**为可上报文本，按 severity 分为 errs（E-*）与 warns（W-*）
+* 从 diagnostics 收集**约定诊断**为可上报文本，按 severity 分为 errs（E-*）与 warns（W-*）。
+*
+* `root` 只用于把绝对路径压成相对路径，不影响判定。
 */
-function collectErrors(res, code, id, root) {
+function collectDiagnostics(res, code, id, root) {
 	const errs = [];
 	const warns = [];
-	const rel = id.startsWith(root) ? id.replace(/\\/g, "/").slice(root.replace(/\\/g, "/").length + 1) : id;
+	const rel = relativeToRoot(id, root);
 	let nl;
 	for (const d of res.diagnostics) {
 		const list = d.conventionErrors?.map((e) => ({
@@ -8544,8 +8541,13 @@ function collectErrors(res, code, id, root) {
 		warns
 	};
 }
-/** 按 mode 上报违规（error 阻断构建 / warn 控制台 / silent 忽略）。 */
-function reportErrors(msgs, mode, head, thisArg) {
+/**
+* 按 mode 上报违规：error 走插件上下文的 `this.error`（阻断构建），warn 走控制台。
+*
+* `thisArg` 是 Rollup/Vite 的插件上下文；纯 API 调用时传 undefined 也能工作
+* （退化为 `throw`）。
+*/
+function reportDiagnostics(msgs, mode, head, thisArg) {
 	if (mode === "silent" || !msgs.length) return;
 	const text = head + "\n  " + msgs.join("\n  ");
 	if (mode === "error") {
@@ -8554,6 +8556,86 @@ function reportErrors(msgs, mode, head, thisArg) {
 		else throw new Error(text);
 	} else console.warn(text);
 }
+/**
+* 一站式上报：W 码恒为控制台提示（不随档位阻断），E 码按 mode 处理。
+*
+* 返回是否发生了阻断（仅用于调用方决定是否继续）。
+*/
+function reportConventionDiagnostics(collected, mode, thisArg, tag = "[compelem/compiler]") {
+	if (mode === "silent") return;
+	const { errs, warns } = collected;
+	if (warns.length) console.warn(`${tag} ${warns.length} 条提示：\n  ` + warns.join("\n  "));
+	reportDiagnostics(errs, mode, `${tag} 检测到 ${errs.length} 处约定错误：`, thisArg);
+}
+
+//#endregion
+//#region src/tag-registry.ts
+/** `@tag('x-foo')` / `@tag(\`x-foo\`)`；一次扫描内复用，调用方负责重置 lastIndex。 */
+const TAG_RE = /@tag\s*\(\s*['"`]([^'"`]+)['"`]/g;
+/** 默认只把 `.ts` / `.tsx` 当作组件来源。 */
+const DEFAULT_TAG_EXT = /\.tsx?$/;
+const SKIP_DIRS = new Set([
+	"node_modules",
+	"dist",
+	"build",
+	"out",
+	"coverage"
+]);
+/**
+* 递归收集 root 下匹配 `extensions` 的文件里的 `@tag` 名，写入 `out`。
+*
+* 读失败的文件直接跳过：注册表是 best-effort 的，它只会**放宽**校验，
+* 不该让一次权限错误打断构建。`node_modules` 等目录不参与扫描。
+*/
+function scanKnownTags(root, out, options = {}) {
+	const { extensions = DEFAULT_TAG_EXT, maxDepth = 20 } = options;
+	scanDir(root, out, extensions, 0, maxDepth);
+}
+function scanDir(root, out, ext, depth, maxDepth) {
+	if (depth > maxDepth) return;
+	let entries;
+	try {
+		entries = readdirSync(root, { withFileTypes: true });
+	} catch {
+		return;
+	}
+	for (const e of entries) {
+		if (e.name.startsWith(".")) continue;
+		if (e.isDirectory()) {
+			if (SKIP_DIRS.has(e.name)) continue;
+			scanDir(join(root, e.name), out, ext, depth + 1, maxDepth);
+		} else if (ext.test(e.name) && !e.name.endsWith(".d.ts")) {
+			let code;
+			try {
+				code = readFileSync(join(root, e.name), "utf-8");
+			} catch {
+				continue;
+			}
+			if (code.indexOf("@tag") < 0 && code.indexOf("CompElem") < 0) continue;
+			TAG_RE.lastIndex = 0;
+			let m;
+			while (m = TAG_RE.exec(code)) out.add(m[1].toLowerCase());
+		}
+	}
+}
+
+//#endregion
+//#region src/vite.ts
+/**
+* 用于 transform 缓存键的按文件指纹（见 tagFingerprint）。
+*/
+const FILE_HYPHEN_TAG_RE = /<([a-z][a-z0-9]*(?:-[a-z0-9]+)+)/g;
+/**
+* 按文件标签指纹（替代全局 `knownTags.size`）。
+*/
+function tagFingerprint(usedTags, knownTags) {
+	if (usedTags.size === 0) return "";
+	const inter = [];
+	for (const t of usedTags) if (knownTags.has(t)) inter.push(t);
+	if (inter.length === 0) return "";
+	inter.sort();
+	return hash32(inter.join("\n"));
+}
 /** compelem 编译期优化插件。 */
 function compelemCompiler(options = {}) {
 	let root = process.cwd();
@@ -8607,11 +8689,7 @@ function compelemCompiler(options = {}) {
 				}
 				transformCache.set(cacheKey, res);
 			}
-			if (convMode !== "silent") {
-				const { errs, warns } = collectErrors(res, code, id, root);
-				if (warns.length) console.warn(`[compelem/compiler] ${warns.length} 条提示：\n  ` + warns.join("\n  "));
-				reportErrors(errs, convMode, `[compelem/compiler] 检测到 ${errs.length} 处约定错误：`, this);
-			}
+			if (convMode !== "silent") reportConventionDiagnostics(collectDiagnostics(res, code, id, root), convMode, this);
 			if (!res.changed) return null;
 			if (options.emitJs) emitCompiledJs(id, res.code, root);
 			if (options.verbose) {
@@ -8646,5 +8724,5 @@ function emitCompiledJs(id, code, root) {
 var vite_default = compelemCompiler;
 
 //#endregion
-export { buildStaticLiteral as a, StaticAnalysisError as c, analyzeRender as d, analyzeFile as f, parse$1 as h, defaultInclude as i, assertStaticAnalysis as l, isCompelemSource as m, vite_default as n, injectInto as o, collectCompelemImports as p, compileFile as r, DEBUG_DIV as s, compelemCompiler as t, inlineTemplateMethods as u };
-//# sourceMappingURL=vite-CY_6E-Ut.js.map
+export { collectCompelemImports as C, analyzeFile as S, parse$1 as T, DEBUG_DIV as _, scanKnownTags as a, inlineTemplateMethods as b, offsetToLineCol as c, reportDiagnostics as d, compileFile as f, injectInto as g, buildStaticLiteral as h, TAG_RE as i, relativeToRoot as l, defaultInclude as m, vite_default as n, collectDiagnostics as o, compileSource as p, DEFAULT_TAG_EXT as r, newlineIndex as s, compelemCompiler as t, reportConventionDiagnostics as u, StaticAnalysisError as v, isCompelemSource as w, analyzeRender as x, assertStaticAnalysis as y };
+//# sourceMappingURL=vite-CLK9td6W.js.map