@weapp-tailwindcss/lynx 0.4.4 → 0.5.1

package/dist/index.cjs

@@ -1,28 +1,591 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_rolldown_runtime = require("./rolldown-runtime-CmQyd0Gu.cjs");
 let weapp_tailwindcss_rspack = require("weapp-tailwindcss/rspack");
-//#region src/css-variables.ts
+let node_crypto = require("node:crypto");
+let weapp_tailwindcss_core = require("weapp-tailwindcss/core");
+let _jridgewell_trace_mapping = require("@jridgewell/trace-mapping");
+let node_fs_promises = require("node:fs/promises");
+let node_module = require("node:module");
+let node_path = require("node:path");
+node_path = require_rolldown_runtime.__toESM(node_path, 1);
+let node_url = require("node:url");
+// src/diagnostics/evidence.ts
+const guardKey = (conditions) => JSON.stringify(conditions.map((condition) => condition.trim()));
+const branchKey = (branch, conditions = branch.conditions) => JSON.stringify([branch.identity, guardKey(conditions)]);
+function mayRepresent(property, actual) {
+	if (property === "all") return true;
+	const plain = (name) => name.replace(/^-(?:webkit|moz|ms|o)-/, "");
+	if (plain(property) === plain(actual)) return true;
+	if (actual.startsWith(`${property}-`) || property.startsWith(`${actual}-`)) return true;
+	return [
+		["border-", "border-"],
+		[
+			"gap",
+			"grid-gap",
+			"row-gap",
+			"column-gap",
+			"grid-row-gap",
+			"grid-column-gap"
+		],
+		[
+			"columns",
+			"column-width",
+			"column-count"
+		],
+		["word-wrap", "overflow-wrap"],
+		[
+			"inset",
+			"top",
+			"right",
+			"bottom",
+			"left"
+		],
+		[
+			"padding-inline",
+			"padding-left",
+			"padding-right"
+		],
+		[
+			"padding-block",
+			"padding-top",
+			"padding-bottom"
+		],
+		[
+			"margin-inline",
+			"margin-left",
+			"margin-right"
+		],
+		[
+			"margin-block",
+			"margin-top",
+			"margin-bottom"
+		],
+		[
+			"place-items",
+			"align-items",
+			"justify-items"
+		],
+		[
+			"place-content",
+			"align-content",
+			"justify-content"
+		],
+		[
+			"place-self",
+			"align-self",
+			"justify-self"
+		]
+	].some((group) => group.some((name) => name.endsWith("-") ? property.startsWith(name) : property === name) && group.some((name) => name.endsWith("-") ? actual.startsWith(name) : actual === name));
+}
+/** 每个模板只解析一次完整产物和输入分支，避免 warning 数量放大解析开销。 */
+function createEncodingInspector(rules, evidence) {
+	const sources = /* @__PURE__ */ new Map();
+	const owners = /* @__PURE__ */ new Map();
+	for (const ref of rules) try {
+		const branches = (0, weapp_tailwindcss_core.collectCssRuleEvidence)(`${ref.rule.selectorText?.value} { placeholder: 0; }`);
+		sources.set(ref, branches);
+		for (const branch of branches) {
+			const key = branchKey(branch, ref.conditions);
+			const refs = owners.get(key) ?? /* @__PURE__ */ new Set();
+			refs.add(ref);
+			owners.set(key, refs);
+		}
+	} catch {}
+	const output = /* @__PURE__ */ new Map();
+	const outputClasses = /* @__PURE__ */ new Set();
+	let verified = false;
+	let error = evidence?.error ?? "缺少本轮 bundle 身份或完整 decoder 文本。";
+	if (evidence?.cssText !== void 0 && evidence.bundleSha256 && evidence.decoderIdentity) try {
+		const bundled = (0, weapp_tailwindcss_core.collectCssRuleEvidence)(evidence.cssText.replace(/\{\{(--[a-z0-9-]+)\}\}/gi, "var($1)"));
+		for (const branch of bundled) {
+			const key = branchKey(branch);
+			output.set(key, [...output.get(key) ?? [], branch]);
+			branch.classes.forEach((name) => outputClasses.add(name));
+		}
+		verified = true;
+		error = void 0;
+	} catch {}
+	return {
+		error,
+		classes: (ref) => sources.get(ref)?.flatMap((branch) => branch.classes) ?? [],
+		status(ref, declaration) {
+			const branches = sources.get(ref);
+			if (!verified || ref.uncertain || !branches?.length) return "unknown";
+			if (branches.some((branch) => owners.get(branchKey(branch, ref.conditions))?.size !== 1)) return "unknown";
+			let expected;
+			if (declaration) {
+				if ((ref.rule.style ?? []).filter((item) => item.name === declaration.name).length !== 1) return "unknown";
+				try {
+					const parsed = (0, weapp_tailwindcss_core.collectCssRuleEvidence)(`.input { value: ${declaration.value}; }`)[0]?.declarations;
+					if (parsed?.length !== 1 || parsed[0]?.property !== "value") return "unknown";
+					expected = {
+						value: parsed[0].value,
+						important: !!declaration.important || parsed[0].important
+					};
+				} catch {
+					return "unknown";
+				}
+			}
+			const states = branches.map((branch) => {
+				const matches = output.get(branchKey(branch, ref.conditions)) ?? [];
+				if (!matches.length) return branch.classes.some((name) => outputClasses.has(name)) ? "unknown" : "encoder-rejected";
+				if (!declaration) return "bundled";
+				const declarations = matches.flatMap((item) => item.declarations).filter((item) => item.property === declaration.name);
+				if (!declarations.length) return matches.some((item) => item.declarations.some((other) => mayRepresent(declaration.name ?? "", other.property))) ? "unknown" : "encoder-rejected";
+				if (declarations.length !== 1) return "unknown";
+				return declarations[0]?.value === expected?.value && declarations[0]?.important === expected?.important ? "bundled" : "unknown";
+			});
+			if (states.includes("encoder-rejected")) return "encoder-rejected";
+			return states.every((state) => state === "bundled") ? "bundled" : "unknown";
+		}
+	};
+}
+// src/diagnostics/guidance.ts
+/** 只说明可观察的删除证据；替代建议不承诺未经目标端验证的等价性。 */
+function diagnosticGuidance(diagnostic) {
+	if (diagnostic.status === "unknown") return {
+		reason: diagnostic.reason ?? "编码证据不足，无法确认该输入声明的最终效果。",
+		suggestion: "先补齐唯一来源、实际 bundle 和目标端证据；当前没有已验证的等价替代建议。"
+	};
+	if (diagnostic.status === "bundled") return {
+		reason: "该输入规则仍存在于本轮实际 bundle；warning 不能证明删除。",
+		suggestion: "保留声明，继续验证目标宿主实际效果。"
+	};
+	let suggestion = "缩小为单条业务样式，在目标宿主确认可用实现；当前没有已验证的等价替代建议。";
+	if (diagnostic.property === "padding-inline" || diagnostic.property === "margin-inline") {
+		const prefix = diagnostic.property.startsWith("padding") ? "padding" : "margin";
+		suggestion = `可按业务方向选择 ${prefix}-left / ${prefix}-right；这不是完整逻辑属性等价替换，RTL 与动态方向须分别验证。`;
+	}
+	return {
+		reason: "唯一输入与本轮实际 bundle 比较确认该规则或声明缺失；这不推断 encoder 内部拒绝根因。",
+		suggestion
+	};
+}
+// src/diagnostics/input.ts
+function isRecord(value) {
+	return value !== null && typeof value === "object";
+}
+function parseRawDiagnostics(value) {
+	if (value === void 0 || value === null || value === "") return [];
+	let parsed;
+	try {
+		parsed = typeof value === "string" ? JSON.parse(value) : value;
+	} catch {
+		return [{ raw: value }];
+	}
+	return (Array.isArray(parsed) ? parsed : [parsed]).map((raw) => {
+		if (!isRecord(raw)) return { raw };
+		const source = isRecord(raw.source) ? raw.source : {};
+		return {
+			raw,
+			...typeof raw.type === "string" ? { type: raw.type.toLowerCase() } : {},
+			...typeof raw.name === "string" ? { name: raw.name } : {},
+			...typeof raw.module === "string" ? { module: raw.module } : {},
+			...typeof raw.file === "string" ? { file: raw.file } : typeof source.file === "string" ? { file: source.file } : {},
+			...Number.isSafeInteger(raw.line) && Number(raw.line) > 0 ? { line: Number(raw.line) } : {},
+			...Number.isSafeInteger(raw.column) && Number(raw.column) > 0 ? { column: Number(raw.column) } : {}
+		};
+	});
+}
+function flattenRules(rules, module, conditions = [], uncertain = false) {
+	return (rules ?? []).flatMap((rule) => {
+		const guard = rule.type === "MediaRule" ? `@media ${rule.prelude?.value}` : void 0;
+		const next = guard ? [...conditions, guard] : conditions;
+		const unsupportedParent = uncertain || rule.type !== "StyleRule" && rule.type !== "MediaRule";
+		return [...rule.type === "StyleRule" ? [{
+			module,
+			rule,
+			conditions,
+			uncertain
+		}] : [], ...flattenRules(rule.rules, module, next, unsupportedParent)];
+	});
+}
+function exactLocation(location, raw) {
+	return !!raw.line && !!raw.column && location?.line === raw.line && location?.column === raw.column;
+}
+/** 只接受唯一、名称和位置同时匹配的输入；模块缺失不回退到其他入口。 */
+function matchInput(rules, raw, input) {
+	if (!raw.name || !["property", "selector"].includes(raw.type ?? "")) return;
+	const matches = rules.flatMap((ref) => {
+		if (raw.module && raw.module !== ref.module && raw.module !== input.cssSource?.[ref.module]) return [];
+		if (raw.file && raw.file !== ref.module && raw.file !== input.cssSource?.[ref.module]) return [];
+		if (raw.type === "property") return (ref.rule.style ?? []).flatMap((declaration) => declaration.name === raw.name && (exactLocation(declaration.keyLoc, raw) || exactLocation(declaration.valLoc, raw)) ? [{
+			ref,
+			declaration
+		}] : []);
+		try {
+			return ref.rule.selectorText?.value && (0, weapp_tailwindcss_core.cssSelectorDiagnosticMatches)(ref.rule.selectorText.value, raw.name) && exactLocation(ref.rule.selectorText.loc, raw) ? [{
+				ref,
+				declaration: void 0
+			}] : [];
+		} catch {
+			return [];
+		}
+	});
+	return matches.length === 1 ? matches[0] : void 0;
+}
+// src/diagnostics/origins.ts
+function cssInputIdentity(css) {
+	if (!isRecord(css)) return;
+	return (0, node_crypto.createHash)("sha256").update(JSON.stringify([css.cssMap, css.cssSource])).digest("hex");
+}
+function readAssets(chunks, getAsset) {
+	if (!Array.isArray(chunks)) return [];
+	return chunks.map((asset) => {
+		const source = asset.source.source();
+		let map = asset.source.map?.() ?? null;
+		let mapAsset;
+		const related = asset.info?.related?.sourceMap;
+		if (!map && typeof related === "string") {
+			const external = getAsset?.(related)?.source.source();
+			if (external !== void 0) {
+				const text = typeof external === "string" ? external : new TextDecoder().decode(external);
+				map = JSON.parse(text);
+				mapAsset = {
+					name: related,
+					text
+				};
+			}
+		}
+		return {
+			name: asset.name,
+			text: typeof source === "string" ? source : new TextDecoder().decode(source),
+			map: structuredClone(map),
+			mapAsset
+		};
+	});
+}
+/** 保存当前构建图的数据，禁止为诊断重新扫描源码或重复执行 CSS 插件。 */
+function captureCssSnapshot(css, getAsset) {
+	if (!isRecord(css) || !(css.contentMap instanceof Map)) return;
+	const identity = cssInputIdentity(css);
+	if (!identity) return;
+	try {
+		return {
+			identity,
+			contents: new Map([...css.contentMap].map(([id, segments]) => [String(id), [...segments]])),
+			assets: readAssets(css.chunks, getAsset)
+		};
+	} catch {
+		return;
+	}
+}
+function snapshotMatches(snapshot, css, chunks, getAsset) {
+	try {
+		return snapshot.identity === cssInputIdentity(css) && JSON.stringify(snapshot.assets) === JSON.stringify(readAssets(chunks, getAsset));
+	} catch {
+		return false;
+	}
+}
+function offsetOf(text, line, column) {
+	const lines = text.split("\n");
+	const row = lines[line - 1];
+	if (row === void 0 || column < 1 || column > row.length + 1) return;
+	return lines.slice(0, line - 1).reduce((size, value) => size + value.length + 1, 0) + column - 1;
+}
+/** 先撤销 cssId 分段拼接的偏移，唯一绑定 asset 后才消费其 source map。 */
+function mapCssOrigin(snapshot, module, line, column) {
+	if (!snapshot || !line || !column) return;
+	const segments = snapshot.contents.get(module);
+	if (!segments) return;
+	const offset = offsetOf(segments.join("\n"), line, column);
+	if (offset === void 0) return;
+	let start = 0;
+	for (const segment of segments) {
+		if (offset >= start && offset < start + segment.length) {
+			const matches = snapshot.assets.flatMap((asset) => {
+				const index = asset.text.indexOf(segment);
+				return index >= 0 && !asset.text.includes(segment, index + 1) ? [{
+					asset,
+					index
+				}] : [];
+			});
+			if (matches.length !== 1 || !matches[0]?.asset.map) return;
+			const { asset, index } = matches[0];
+			const prefix = asset.text.slice(0, index + offset - start).split("\n");
+			try {
+				const original = (0, _jridgewell_trace_mapping.originalPositionFor)(new _jridgewell_trace_mapping.TraceMap(asset.map), {
+					line: prefix.length,
+					column: prefix.at(-1).length
+				});
+				return original.source && original.line !== null && original.column !== null ? {
+					file: original.source,
+					line: original.line,
+					column: original.column + 1,
+					asset: asset.name
+				} : void 0;
+			} catch {
+				return;
+			}
+		}
+		start += segment.length + 1;
+	}
+}
+// src/diagnostics/versions.ts
+/** 只关联与宿主暴露类身份一致的构建器依赖；不把目标 SDK 当作宿主运行版本。 */
+async function installedEncoderVersion(root, template) {
+	try {
+		if (!root) throw new Error("构建器未提供项目根目录");
+		const project = (0, node_module.createRequire)(node_path.default.join(root, "package.json"));
+		const file = (0, node_module.createRequire)(project.resolve("@lynx-js/react-rsbuild-plugin/package.json")).resolve("@lynx-js/template-webpack-plugin/package.json");
+		const entry = JSON.parse(await (0, node_fs_promises.readFile)(file, "utf8")).exports?.["."]?.import;
+		if (typeof entry !== "string" || !entry.startsWith("./")) throw new Error("模板包缺少明确的 ESM 导出");
+		if ((await import((0, node_url.pathToFileURL)(node_path.default.resolve(node_path.default.dirname(file), entry)).href)).LynxTemplatePlugin !== template) throw new Error("已解析模板类与宿主暴露类身份不一致");
+		const encoderFile = (0, node_module.createRequire)(file).resolve("@lynx-js/tasm/package.json");
+		const encoder = JSON.parse(await (0, node_fs_promises.readFile)(encoderFile, "utf8"));
+		if (encoder.name !== "@lynx-js/tasm" || typeof encoder.version !== "string" || !encoder.version.trim()) throw new Error("编码包版本元数据无效");
+		return {
+			version: encoder.version,
+			source: "@lynx-js/tasm：从已绑定模板构建器的依赖解析；未独立确认实际 encode hook 或执行二进制，不是宿主引擎版本。"
+		};
+	} catch (error) {
+		return { source: `编码器版本未确认：${error instanceof Error ? error.message : String(error)}` };
+	}
+}
+function diagnosticVersions(options, encoder) {
+	const declared = (key) => typeof options?.[key] === "string" ? options[key] : void 0;
+	return {
+		versions: {
+			encoder: encoder?.version ?? declared("encoderVersion") ?? "unknown",
+			engine: declared("engineVersion") ?? "unknown",
+			targetSdk: declared("targetSdkVersion")
+		},
+		versionEvidence: {
+			encoder: encoder?.version ? encoder.source : [encoder?.source, declared("encoderVersion") ? "版本来自 compilerOptions 显式声明；未独立验证执行二进制。" : "编码器未提供可关联的版本证据。"].filter(Boolean).join(" "),
+			engine: declared("engineVersion") ? "compilerOptions 显式声明；宿主运行版本仍须设备验收。" : "构建不能推断宿主运行引擎版本；本轮未提供。"
+		}
+	};
+}
+// src/diagnostics.ts
+function classifyRule(ref, classes, property) {
+	const selector = ref.rule.selectorText?.value ?? "";
+	if (classes.length > 0) return "business";
+	if (property?.startsWith("--tw-") && Object.keys(ref.rule.variables ?? {}).every((name) => name.startsWith("--tw-")) && (ref.rule.style ?? []).every((declaration) => declaration.name?.startsWith("--tw-"))) return "tailwind-default";
+	const defaults = ":root, :host, *, ::before, ::after, ::backdrop, ::file-selector-button";
+	try {
+		const branches = (0, weapp_tailwindcss_core.collectCssRuleEvidence)(`${selector} { placeholder: 0; }`);
+		if (branches.length && branches.every((branch) => (0, weapp_tailwindcss_core.cssSelectorDiagnosticMatches)(defaults, branch.selector))) return "preflight";
+	} catch {}
+	return "unknown";
+}
+function ignoredBy(diagnostic, ignores = []) {
+	const rule = ignores.find((ignore) => (ignore.selector || ignore.property) && (!ignore.selector || ignore.selector === diagnostic.selector) && (!ignore.property || ignore.property === diagnostic.property));
+	return rule ? {
+		reason: rule.reason ?? "按显式 selector/property 配置忽略失败；原诊断仍保留。",
+		rule
+	} : void 0;
+}
+function createLynxDiagnosticsReport(rawDiagnostics, css, options = {}, compilerOptions, evidence, origins, encoder) {
+	const input = isRecord(css) ? css : {};
+	const rules = Object.entries(input.cssMap ?? {}).flatMap(([module, moduleRules]) => flattenRules(moduleRules, module));
+	const inspector = createEncodingInspector(rules, evidence);
+	const diagnostics = [];
+	const handled = /* @__PURE__ */ new Map();
+	const seen = /* @__PURE__ */ new Set();
+	for (const raw of parseRawDiagnostics(rawDiagnostics)) {
+		const key = JSON.stringify(raw.raw);
+		if (seen.has(key)) continue;
+		seen.add(key);
+		const match = matchInput(rules, raw, input);
+		let status = "unknown";
+		let category = "unknown";
+		let classes = [];
+		if (match) {
+			if (raw.type === "property" && handled.get(match.ref) !== "selector") {
+				const declarations = handled.get(match.ref) ?? /* @__PURE__ */ new Set();
+				declarations.add(match.declaration);
+				handled.set(match.ref, declarations);
+			}
+			classes = inspector.classes(match.ref);
+			status = inspector.status(match.ref, match.declaration);
+			if (raw.type === "selector" && status === "encoder-rejected") handled.set(match.ref, "selector");
+			if (status !== "unknown") category = classifyRule(match.ref, classes, raw.type === "property" ? raw.name : void 0);
+		}
+		const origin = match ? mapCssOrigin(origins, match.ref.module, raw.line, raw.column) : void 0;
+		const diagnostic = {
+			origin: "encoder-log",
+			raw: raw.raw,
+			status,
+			category,
+			message: status === "encoder-rejected" ? `encoder 产物确证删除 ${raw.type}：${raw.name}` : status === "bundled" ? `encoder warning 对应规则仍保留：${raw.name}` : "encoder 诊断缺少唯一输入关联或可信编码后证明。",
+			...match ? {
+				selector: match.ref.rule.selectorText?.value,
+				utility: classes[0],
+				property: raw.type === "property" ? raw.name : void 0,
+				value: match.declaration?.value
+			} : {},
+			source: {
+				module: match?.ref.module ?? raw.module,
+				file: origin?.file,
+				line: origin?.line,
+				column: origin?.column,
+				generated: {
+					line: raw.line,
+					column: raw.column
+				}
+			},
+			reason: status === "unknown" ? evidence?.error ?? "来源歧义、未知日志或编码证据不足；不推断删除。" : void 0
+		};
+		Object.assign(diagnostic, diagnosticGuidance(diagnostic));
+		const ignored = ignoredBy(diagnostic, options.ignore);
+		if (ignored) diagnostic.ignored = ignored;
+		diagnostics.push(diagnostic);
+	}
+	if (inspector.error && !diagnostics.some((item) => item.status === "unknown")) diagnostics.push({
+		origin: "bundle-comparison",
+		status: "unknown",
+		category: "unknown",
+		message: "本轮模板缺少可验证的完整编码后证据。",
+		reason: inspector.error,
+		suggestion: "先补齐本轮实际 bundle 的解码证据，再判断兼容性；当前不提供未经验证的样式替代。"
+	});
+	for (const ref of rules) {
+		const classes = inspector.classes(ref);
+		const covered = handled.get(ref);
+		if (!classes.length || covered === "selector") continue;
+		for (const declaration of ref.rule.style ?? []) {
+			const status = inspector.status(ref, declaration);
+			if (covered?.has(declaration) || status === "bundled" || inspector.error) continue;
+			const location = declaration.keyLoc;
+			const origin = mapCssOrigin(origins, ref.module, location?.line, location?.column);
+			const diagnostic = {
+				origin: "bundle-comparison",
+				status,
+				category: "business",
+				message: status === "encoder-rejected" ? `编码输入声明在实际 bundle 中缺失：${declaration.name}` : `编码声明缺少独立等价证明：${declaration.name}`,
+				reason: status === "unknown" ? "来源歧义、重复声明或编码表示变化，尚无独立等价 oracle。" : void 0,
+				selector: ref.rule.selectorText?.value,
+				utility: classes[0],
+				property: declaration.name,
+				value: declaration.value,
+				source: {
+					module: ref.module,
+					file: origin?.file,
+					line: origin?.line,
+					column: origin?.column,
+					generated: location
+				}
+			};
+			Object.assign(diagnostic, diagnosticGuidance(diagnostic));
+			const ignored = ignoredBy(diagnostic, options.ignore);
+			if (ignored) diagnostic.ignored = ignored;
+			diagnostics.push(diagnostic);
+		}
+	}
+	const { cssText: _cssText, ...identity } = evidence ?? {};
+	return {
+		schemaVersion: 1,
+		counts: {
+			generated: rules.length,
+			encoderRejected: diagnostics.filter((item) => item.status === "encoder-rejected").length,
+			unknown: diagnostics.filter((item) => item.status === "unknown").length
+		},
+		diagnostics,
+		...evidence ? { evidence: identity } : {},
+		...diagnosticVersions(compilerOptions, encoder)
+	};
+}
+function hasStrictLynxDiagnosticFailure(report, options = {}) {
+	return options.strict === true && report.diagnostics.some((item) => item.status === "encoder-rejected" && item.category === "business" && !item.ignored);
+}
+function formatLynxDiagnosticsSummary(report) {
+	return `Lynx CSS 诊断：生成 ${report.counts.generated} 条，encoder 删除 ${report.counts.encoderRejected} 条，未知 ${report.counts.unknown} 条。`;
+}
+// src/css-variables.ts
 /** 通过模板编码生命周期启用原生递归变量解析，保留显式配置及动态依赖。 */
 var LynxCssVariablesPlugin = class {
 	templatePlugin;
-	constructor(templatePlugin) {
+	diagnostics;
+	root;
+	constructor(templatePlugin, diagnostics = {}, root) {
 		this.templatePlugin = templatePlugin;
+		this.diagnostics = diagnostics;
+		this.root = root;
 	}
 	apply(compiler) {
 		const name = "weapp-tailwindcss:lynx-css-variables";
+		const pending = /* @__PURE__ */ new WeakMap();
+		if (!compiler.hooks.afterEmit?.tapPromise && (this.diagnostics.strict || this.diagnostics.onReport)) throw new Error("Lynx compiler afterEmit hook 不可用，不能验证实际发出的模板。");
+		compiler.hooks.afterEmit?.tapPromise(name, async (compilation) => {
+			for (const { args, origins } of pending.get(compilation) ?? []) await this.reportEmittedTemplate(compilation, args, origins);
+			pending.delete(compilation);
+		});
 		compiler.hooks.thisCompilation.tap(name, (compilation) => {
-			this.templatePlugin.getLynxTemplatePluginHooks(compilation).beforeEncode.tap(name, (args) => {
+			const hooks = this.templatePlugin.getLynxTemplatePluginHooks(compilation);
+			const getAsset = compilation.getAsset?.bind(compilation);
+			const snapshots = /* @__PURE__ */ new Map();
+			hooks.beforeEncode.tap(name, (args) => {
 				const config = args.encodeData.sourceContent.config;
 				if (config.enableCSSInlineVariables === void 0) config.enableCSSInlineVariables = true;
+				const snapshot = captureCssSnapshot(args.encodeData.css, getAsset);
+				if (snapshot) {
+					const previous = snapshots.get(snapshot.identity);
+					snapshots.set(snapshot.identity, snapshots.has(snapshot.identity) && (previous === null || JSON.stringify([previous?.assets, [...previous?.contents ?? []]]) !== JSON.stringify([snapshot.assets, [...snapshot.contents]])) ? null : snapshot);
+				}
+				return args;
+			});
+			if (!hooks.beforeEmit?.tapPromise && (this.diagnostics.strict || this.diagnostics.onReport)) throw new Error("Lynx beforeEmit 异步模板 hook 不可用，不能生成可信 CSS 诊断。");
+			hooks.beforeEmit?.tapPromise(name, async (args) => {
+				const identity = cssInputIdentity(args.finalEncodeOptions.css);
+				const snapshot = identity ? snapshots.get(identity) : void 0;
+				const origins = snapshot && snapshotMatches(snapshot, args.finalEncodeOptions.css, args.cssChunks, getAsset) ? snapshot : void 0;
+				const entries = pending.get(compilation) ?? [];
+				entries.push({
+					args: structuredClone({
+						outputName: args.outputName,
+						cssDiagnostics: args.cssDiagnostics,
+						template: /* @__PURE__ */ new Uint8Array(),
+						finalEncodeOptions: {
+							css: args.finalEncodeOptions.css,
+							compilerOptions: args.finalEncodeOptions.compilerOptions,
+							customSections: args.finalEncodeOptions.customSections
+						}
+					}),
+					origins
+				});
+				pending.set(compilation, entries);
 				return args;
 			});
 		});
 	}
+	async reportEmittedTemplate(compilation, args, origins) {
+		let evidence;
+		evidence = {
+			outputName: args.outputName,
+			inputCssSha256: cssInputIdentity(args.finalEncodeOptions.css)
+		};
+		try {
+			const emitted = compilation.getAsset?.(args.outputName)?.source.source();
+			if (!(emitted instanceof Uint8Array) || emitted.byteLength === 0) throw new Error("构建图缺少本轮已发出的 template 字节");
+			evidence.bundleSha256 = (0, node_crypto.createHash)("sha256").update(emitted).digest("hex");
+			const sections = args.finalEncodeOptions.customSections;
+			if (isRecord(sections) && Object.values(sections).some((section) => isRecord(section) && section.encoding === "CSS")) throw new Error("固定 decoder 尚不能证明独立 CSS custom section 的完整性");
+			const { decodeLynxBundle, lynxDecoderIdentity } = await import("@weapp-tailwindcss/lynx/decoder");
+			const decoded = await decodeLynxBundle(emitted);
+			evidence = {
+				outputName: args.outputName,
+				bundleSha256: (0, node_crypto.createHash)("sha256").update(emitted).digest("hex"),
+				decoderIdentity: lynxDecoderIdentity(),
+				decodedCssSha256: (0, node_crypto.createHash)("sha256").update(decoded.css.text).digest("hex"),
+				cssText: decoded.css.text,
+				inputCssSha256: cssInputIdentity(args.finalEncodeOptions.css)
+			};
+		} catch (error) {
+			evidence.error = error instanceof Error ? error.message : String(error);
+		}
+		const report = createLynxDiagnosticsReport(args.cssDiagnostics, args.finalEncodeOptions.css, this.diagnostics, args.finalEncodeOptions.compilerOptions, evidence, origins, await installedEncoderVersion(this.root, this.templatePlugin));
+		this.diagnostics.onReport?.(report);
+		if (report.diagnostics.length > 0) {
+			const summary = new Error(formatLynxDiagnosticsSummary(report));
+			if (hasStrictLynxDiagnosticFailure(report, this.diagnostics)) compilation.errors?.push(summary);
+			else compilation.warnings?.push(summary);
+		}
+	}
 };
-//#endregion
-//#region src/index.ts
+// src/index.ts
 const PLUGIN_NAME = "weapp-tailwindcss:lynx";
 function normalizeOptions(options) {
-	const { rspack: _rspack, generator, ...rest } = options;
+	const { rspack: _rspack, diagnostics: _diagnostics, generator, ...rest } = options;
 	const generatorOptions = generator === false ? {} : generator;
 	return {
 		...rest,
@@ -76,13 +639,16 @@ function pluginLynxTailwindcss(options = {}) {
 				const templatePlugin = rsbuildApi.useExposed?.(Symbol.for("LynxTemplatePlugin"))?.LynxTemplatePlugin;
 				if (!templatePlugin?.getLynxTemplatePluginHooks) throw new Error("Lynx 模板编码 hook 不可用；请注册或升级 ReactLynx 构建插件（至少 0.12.4），确认其提供 LynxTemplatePlugin API。");
 				chain.plugin(PLUGIN_NAME).use(weapp_tailwindcss_rspack.WeappTailwindcss, [normalizedOptions]);
-				chain.plugin(`${PLUGIN_NAME}:css-variables`).use(LynxCssVariablesPlugin, [templatePlugin]);
+				chain.plugin(`${PLUGIN_NAME}:css-variables`).use(LynxCssVariablesPlugin, [
+					templatePlugin,
+					options.diagnostics ?? {},
+					rsbuildApi.context?.rootPath
+				]);
 				return chain;
 			});
 			rsbuildApi.modifyRspackConfig((config) => (0, weapp_tailwindcss_rspack.patchRspackConfig)(config, normalizeRspackOptions(options.rspack)));
 		}
 	};
 }
-//#endregion
 exports.PLUGIN_NAME = PLUGIN_NAME;
 exports.pluginLynxTailwindcss = pluginLynxTailwindcss;