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

package/dist/index.d.ts

@@ -113,6 +113,13 @@ interface StaticLiteralCodes {
   states?: string;
   /** `__ce_static__.computedGetters` 字面量值（@computed 前移，原 getter 体外提） */
   computedGetters?: string;
+  /**
+   * `__ce_static__.resources` 字面量值（@resource 前移）。
+   *
+   * 只放纯数据选项（timeout/immediate/track + source 的布尔标记）；
+   * loader 与 source 函数搬成类上的 `__rl_<name>` / `__rs_<name>` 私有方法。
+   */
+  resources?: string;
   /** 类体访问器源码（prop/state/computed 的 get/set + `@tag` 类的 observedAttributes），
    *  接在 static 字面量之后注入。无 `@tag` 的类不带 observedAttributes —— 它们永不被
    *  `customElements.define`，浏览器不会读它们的表。 */
@@ -273,6 +280,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-C95uwtJI.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 };