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

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

@@ -494,12 +494,21 @@ function extractClassInfo(node, resolve) {
 				const imported = resolve(d);
 				return imported === "query" || imported === "queryAll";
 			})) queryFields.add(name);
-			if (member.type === "MethodDefinition") {
-				if (member.kind === "get") getters.add(name);
-				else methods.add(name);
+			const resDeco = (member.decorators ?? []).find((d) => {
+				const n = decoratorName(d);
+				return n ? resolve(n) === "resource" : false;
+			});
+			if (member.type === "MethodDefinition") if (member.kind === "get") {
+				getters.add(name);
+				const fn = member.value;
+				if (fn?.body) bodies.set(name, fn.body);
+			} else {
+				methods.add(name);
 				const fn = member.value;
 				if (fn?.body) bodies.set(name, fn.body);
-			} else if (member.type === "PropertyDefinition") {
+			}
+			else if (member.type === "PropertyDefinition") if (resDeco) getters.add(name);
+			else {
 				const init = member.value;
 				if (init && (init.type === "ArrowFunctionExpression" || init.type === "FunctionExpression")) {
 					methods.add(name);
@@ -1804,6 +1813,7 @@ function buildStaticLiteral(opts, codes = {}) {
 	parts.push(mark("props", `props: ${emitFamily("props", codes.props)}`));
 	parts.push(mark("states", `states: ${emitFamily("states", codes.states)}`));
 	parts.push(mark("computedGetters", `computedGetters: ${emitFamily("computedGetters", codes.computedGetters)}`));
+	parts.push(mark("resources", `resources: ${emitFamily("resources", codes.resources)}`));
 	const watchCode = emitWatchEffects(codes.watchEffects, codes.inlinedWatchAncestors);
 	if (watchCode !== void 0) parts.push(mark("watchEffects", `watchEffects: ${watchCode}`));
 	if (codes.cssEffect) parts.push(mark("cssEffect", `cssEffect: ${codes.cssEffect}`));
@@ -2595,8 +2605,8 @@ function checkConventions(comp, ctx) {
 function record(ctx, path) {
 	addDepPath(ctx.deps, path);
 }
-/** TS 包装节点解包（`this as any` / `that!` 等）—— 统一实现在 utils/ast#unwrapExpr。
-*  本副本原先比别处多认 `TSInstantiationExpression`、少认 `TSTypeAssertion`，已归一。 */
+/** TS 包装节点解包（`this as any` / `that!` / `<T>x` 等）—— 统一实现在 utils/ast#unwrapExpr，
+*  认 TSInstantiationExpression 与 TSTypeAssertion。 */
 /** 置失败标记；DEPS_TRACE=1 时输出原因标签（见文件头）。 */
 function failAt(ctx, where) {
 	if (typeof process !== "undefined" && process.env?.DEPS_TRACE) console.error("[deps-fail]", where);
@@ -4399,6 +4409,234 @@ function extractFieldAccessors(comp, code, ctx, bindings = {}, inheritedAccessor
 	};
 }
 
+//#endregion
+//#region src/analyze/resource-extract.ts
+const CODE = "E-RESOURCE";
+/** 选项闭集，逐字对齐运行期 `ResourceDecoratorOptions` */
+const OPT_KEYS = new Set([
+	"timeout",
+	"immediate",
+	"track",
+	"source"
+]);
+/** 合法标识符：资源名要拼进 `get <name>()`，非法名会生成坏代码 */
+const IDENT = /^[A-Za-z_$][\w$]*$/;
+/**
+* 不能用作资源名的成员：`CompElem` 原型上的访问器、方法与生命周期回调，
+* 外加 `Object.prototype` 的成员。
+*
+* 运行期按 `__ce_static__.resources` 在原型上装 `get <name>()`，安装前会检查
+* 原型链上是否已有同名键，有则跳过 —— 撞名的结果是资源**静默不可用**。
+* 编译器无法读到运行期原型（`CompElem` 继承 `HTMLElement`，Node 侧无法加载），
+* 这份名单与 `src/CompElem.ts` 的成员表同步维护。
+*/
+const RESERVED_NAMES = new Set([
+	"cid",
+	"attrs",
+	"props",
+	"renderRoot",
+	"renderRoots",
+	"parentComponent",
+	"wrapperComponent",
+	"rootComponent",
+	"slots",
+	"slotHooks",
+	"cssSheets",
+	"cssVars",
+	"isMounted",
+	"isDestroyed",
+	"insertStyleSheet",
+	"setup",
+	"propsReady",
+	"render",
+	"beforeMount",
+	"mounted",
+	"beforeDestroyed",
+	"destroyed",
+	"destroy",
+	"slotChange",
+	"afterUpdate",
+	"updateProps",
+	"getSubViewNodes",
+	"emit",
+	"nextTick",
+	"defineSignalField",
+	"forceUpdate",
+	"connectedCallback",
+	"disconnectedCallback",
+	"attributeChangedCallback",
+	"constructor",
+	"toString",
+	"toLocaleString",
+	"valueOf",
+	"hasOwnProperty",
+	"isPrototypeOf",
+	"propertyIsEnumerable",
+	"__proto__"
+]);
+/** 编译期注入的私有方法前缀 */
+const LOADER_PREFIX = "__rl_";
+const SOURCE_PREFIX = "__rs_";
+/** 迁移提示：给出可直接照抄的写法 */
+const MIGRATE = "\n  正确形态（loader 是第一个参数，选项可选）：\n    @resource((self, signal) => …, { timeout: 3000 })\n    rows!: ResourceView<Row[]>\n  之后模板里写 this.rows.data / this.rows.busy / this.rows.load()。";
+function extractResources(comp, code, ctx) {
+	const result = {
+		accessors: "",
+		removals: [],
+		runtimeHelpers: [],
+		errors: []
+	};
+	const cls = comp.cls ?? ctx.localClasses.get(comp.className);
+	if (!cls) return result;
+	const isResourceDeco = (d) => comp.compelemImports.get(d) === "resource";
+	const members = cls.body?.body ?? [];
+	const targets = [];
+	for (const member of members) {
+		const dec = (member.decorators ?? []).find((d) => {
+			const n = decoratorName(d);
+			return n ? isResourceDeco(n) : false;
+		});
+		if (!dec) continue;
+		targets.push({
+			member,
+			dec,
+			rawName: keyName(member.key) ?? ""
+		});
+	}
+	if (!targets.length) return result;
+	const fail = (member, dec, message) => {
+		const dStart = dec?.start ?? member.start;
+		result.errors.push({
+			start: Math.min(member.start, dStart),
+			end: member.end,
+			message
+		});
+	};
+	/** 本族已提交的资源名，用于同类内重复检查（TS 也会报，但这里给更直白的 E 码） */
+	const emitted = /* @__PURE__ */ new Set();
+	const entries = [];
+	let accessors = "";
+	const removals = [];
+	for (const { member, dec, rawName } of targets) {
+		if (member.type !== "PropertyDefinition") {
+			fail(member, dec, `${CODE}: @resource 只能装饰字段声明。${MIGRATE}`);
+			continue;
+		}
+		if (!rawName) {
+			fail(member, dec, `${CODE}: 无法识别被装饰的字段名（计算属性键不支持）`);
+			continue;
+		}
+		if (rawName.startsWith("#")) {
+			fail(member, dec, `${CODE}: 不支持私有字段（'${rawName}'）——视图访问器要挂在原型上才能被模板读取`);
+			continue;
+		}
+		if (!IDENT.test(rawName)) {
+			fail(member, dec, `${CODE}: 资源名 '${rawName}' 不是合法标识符（要用作 get ${rawName}()）`);
+			continue;
+		}
+		if (RESERVED_NAMES.has(rawName)) {
+			fail(member, dec, `${CODE}: 资源名 '${rawName}' 与 CompElem 原型链上的成员同名——访问器不会安装，this.${rawName} 取不到资源视图。请改用其它字段名`);
+			continue;
+		}
+		if (member.static === true) {
+			fail(member, dec, `${CODE}: 不支持静态资源（'${rawName}'）——注入的是实例 getter，static 成员会被整段删掉`);
+			continue;
+		}
+		if (member.value != null) {
+			fail(member, dec, `${CODE}: 字段不能带初始值（'${rawName} = …'）——值只由 loader 提供，写在字段上的初始值会被删掉，且不会报错`);
+			continue;
+		}
+		if (emitted.has(rawName)) {
+			fail(member, dec, `${CODE}: '${rawName}' 已经有另一个 @resource，资源名必须唯一`);
+			continue;
+		}
+		const otherDecos = (member.decorators ?? []).map(decoratorName).filter((d) => d && !isResourceDeco(d));
+		if (otherDecos.length) {
+			fail(member, dec, `${CODE}: @resource 不能与其它装饰器同用（'${rawName}' 上还有 @${otherDecos.join(" / @")}）`);
+			continue;
+		}
+		const callArgs = dec.expression?.type === "CallExpression" ? dec.expression.arguments ?? [] : [];
+		if (callArgs.length < 1 || callArgs.length > 2) {
+			fail(member, dec, `${CODE}: @resource 需要 (loader, options?) 两个参数以内${MIGRATE}`);
+			continue;
+		}
+		const loaderNode = unwrapExpr(callArgs[0]);
+		if (loaderNode?.type !== "ArrowFunctionExpression") {
+			fail(member, dec, loaderNode?.type === "ObjectExpression" ? `${CODE}: 形态已改为 @resource(loader, options?)——loader 从选项对象移到第一个参数${MIGRATE}` : `${CODE}: 第一个参数须是内联箭头函数 (self, signal) => …——编译期要把这段表达式搬进实例方法，引用式写法拿不到组件实例`);
+			continue;
+		}
+		if ((loaderNode.params ?? []).length !== 2) {
+			fail(member, dec, `${CODE}: loader 必须声明两个形参 (self, signal) —— 装饰器实参里没有 this，组件实例要显式传进来`);
+			continue;
+		}
+		/** loader 表达式切片（搬进方法体后 `this` 才是实例） */
+		const loaderExpr = `(${code.slice(loaderNode.start, loaderNode.end)})`;
+		let sourceExpr;
+		const keep = [];
+		let optsBad = false;
+		let optsNode;
+		if (callArgs.length === 2) {
+			optsNode = unwrapExpr(callArgs[1]);
+			if (optsNode?.type !== "ObjectExpression") {
+				fail(member, dec, `${CODE}: 第二个参数须是内联对象字面量（变量/import 无法静态前移）`);
+				continue;
+			}
+		}
+		for (const p of optsNode?.properties ?? []) {
+			if (p.type === "SpreadElement" || p.type === "ExperimentalSpreadProperty") {
+				fail(member, dec, `${CODE}: 选项不支持展开（spread 无法静态前移），请逐项写出`);
+				optsBad = true;
+				break;
+			}
+			if (p.computed) {
+				fail(member, dec, `${CODE}: 选项键无法静态解析（计算属性键不支持）`);
+				optsBad = true;
+				break;
+			}
+			const k = keyName(p.key);
+			if (!k) {
+				fail(member, dec, `${CODE}: 选项键无法静态解析（计算属性键不支持）`);
+				optsBad = true;
+				break;
+			}
+			if (!OPT_KEYS.has(k)) {
+				fail(member, dec, `${CODE}: ${k === "loader" || k === "fetch" || k === "fetcher" ? `'${k}' 不是选项——loader 是第一个参数，写成 @resource((self, signal) => …)${MIGRATE}` : ""}未知选项 '${k}'——ResourceDecoratorOptions 仅支持 ${[...OPT_KEYS].join(" / ")}`);
+				optsBad = true;
+				break;
+			}
+			if (k === "source") {
+				const v = unwrapExpr(p.value);
+				if (v?.type !== "ArrowFunctionExpression") {
+					fail(member, dec, `${CODE}: source 须是内联箭头函数 (self) => …——编译期要把这段表达式搬进实例方法，引用式写法拿不到组件实例`);
+					optsBad = true;
+					break;
+				}
+				if ((v.params ?? []).length > 1) {
+					fail(member, dec, `${CODE}: source 最多接收一个形参 (self)`);
+					optsBad = true;
+					break;
+				}
+				sourceExpr = `(${code.slice(v.start, v.end)})`;
+				continue;
+			}
+			keep.push(code.slice(p.start, p.end));
+		}
+		if (optsBad) continue;
+		emitted.add(rawName);
+		const keyLit = JSON.stringify(rawName);
+		accessors += `${DEBUG_DIV} resource ${rawName}\n${LOADER_PREFIX}${rawName}(__signal) { return ${loaderExpr}(this, __signal) }\n` + (sourceExpr ? `${SOURCE_PREFIX}${rawName}() { return ${sourceExpr}(this) }\n` : "");
+		const parts = keep.slice();
+		if (sourceExpr) parts.push("source: true");
+		entries.push(`${keyLit}: { ${parts.join(", ")} }`);
+		removals.push(lineSpan(code, Math.min(member.start, dec.start ?? member.start), member.end));
+	}
+	if (!removals.length) return result;
+	result.accessors = accessors;
+	result.removals = removals;
+	result.resourcesCode = `{ ${entries.join(", ")} }`;
+	return result;
+}
+
 //#endregion
 //#region src/analyze/method-deco-extract.ts
 /** 本地变量前缀（避开用户标识符；`__` 前缀与框架其余注入一致）。 */
@@ -4712,8 +4950,7 @@ function staticHtmlFragmentOf(e, comp) {
 * 非 this 起始 / 含 computed 访问时返回 null。
 *
 * 统一实现在 utils/ast#thisChain（属性名走 keyName，`#private` 带 `#` 前缀，
-* 与 render-body 侧对齐 —— 本副本原先手写分支漏了前缀，会把 `this.#x` 与
-* `this.x` 混成同一个依赖键）。
+* 否则 `this.#x` 与 `this.x` 会混成同一个依赖键）。
 */
 /**
 * 提取 TAG 指令实参中的 this 链全前缀路径。
@@ -5287,78 +5524,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」`
+							});
+						}
 					}
 				}
 			}
@@ -7929,16 +8181,21 @@ function compileFile(code, id, options = {}) {
 		const mdRes = extractMethodDecos(comp, code, convCtx);
 		conventionErrors.push(...mdRes.errors);
 		const mdHelpers = mdRes.runtimeHelpers.map((n) => helperBindings[n] ?? n);
+		const resRes = extractResources(comp, code, convCtx);
+		conventionErrors.push(...resRes.errors);
+		const resHelpers = resRes.runtimeHelpers.map((n) => helperBindings[n] ?? n);
 		const allRemovals = [
 			...watchRemovals,
 			...fieldRes.removals,
-			...mdRes.removals
+			...mdRes.removals,
+			...resRes.removals
 		];
 		const fieldCodes = {
 			props: fieldRes.propsCode,
 			states: fieldRes.statesCode,
 			computedGetters: fieldRes.computedCode,
-			accessors: fieldRes.accessors || void 0
+			resources: resRes.resourcesCode,
+			accessors: fieldRes.accessors + resRes.accessors || void 0
 		};
 		const ctorPlan = fieldRes.fieldInits.length > 0 || !!mdRes.ctorStmts ? planCtorInsert(comp, comp.cls ?? convCtx.localClasses.get(comp.className), code) : void 0;
 		if (ctorPlan?.warn) conventionErrors.push({
@@ -7954,7 +8211,11 @@ function compileFile(code, id, options = {}) {
 			methodDecoCtor: mdRes.ctorStmts || void 0,
 			methodDecoDestroy: mdRes.destroyStmts || void 0,
 			get helpers() {
-				const all = [...fieldHelpers, ...writers];
+				const all = [
+					...fieldHelpers,
+					...resHelpers,
+					...writers
+				];
 				return all.length ? [...new Set(all)] : void 0;
 			},
 			myfxHelpers: mdHelpers.length ? [...mdHelpers] : void 0
@@ -7999,19 +8260,20 @@ function compileFile(code, id, options = {}) {
 			continue;
 		}
 		if (comp.skipInjection) {
-			if (!!fieldRes.accessors || fieldRes.propsCode !== void 0 || fieldRes.statesCode !== void 0 || fieldRes.computedCode !== void 0 || !!cssEffectCode || watchEffectsCode) {
+			if (!!fieldRes.accessors || !!resRes.accessors || fieldRes.propsCode !== void 0 || fieldRes.statesCode !== void 0 || fieldRes.computedCode !== void 0 || resRes.resourcesCode !== void 0 || !!cssEffectCode || watchEffectsCode) {
 				const mk = (label, body) => `${DEBUG_DIV} ${label}\n${body}`;
 				const parts = [
 					mk("inherits", `...Reflect.getPrototypeOf(this).__ce_static__`),
 					mk("props", `props: ${emitFamily("props", fieldRes.propsCode)}`),
 					mk("states", `states: ${emitFamily("states", fieldRes.statesCode)}`),
-					mk("computedGetters", `computedGetters: ${emitFamily("computedGetters", fieldRes.computedCode)}`)
+					mk("computedGetters", `computedGetters: ${emitFamily("computedGetters", fieldRes.computedCode)}`),
+					mk("resources", `resources: ${emitFamily("resources", resRes.resourcesCode)}`)
 				];
 				if (watchEffectsCode) parts.push(mk("watchEffects", `watchEffects: ${emitWatchEffects(watchEffectsCode, watchRes.inlinedAncestors)}`));
 				if (cssEffectCode) parts.push(mk("cssEffect", `cssEffect: ${cssEffectCode}`));
 				edits.push({
 					comp,
-					literal: `static __ce_static__ = {\n${parts.join(",\n")}\n};\n` + (fieldRes.accessors || ""),
+					literal: `static __ce_static__ = {\n${parts.join(",\n")}\n};\n` + (fieldRes.accessors + resRes.accessors || ""),
 					removals: allRemovals,
 					...fieldExtras
 				});
@@ -8444,55 +8706,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 +8754,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 +8788,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 +8803,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 +8936,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 +8971,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-C95uwtJI.js.map