@nudojs/service 1.0.0 → 1.1.0

package/dist/config-DDB588oA.d.ts

@@ -0,0 +1,114 @@
+type NudoConfig = {
+    env?: string[];
+    mocks?: Record<string, string>;
+    contract?: {
+        /** 侧车 ambient 绑定总开关（check/LSP 执法与 contract 打印共用） */
+        autoBind?: boolean;
+        /**
+         * emit 白名单（Phase 3，§7.3）：glob 数组，相对 projectDir。
+         * 省略/空 = 不按路径过滤（仍受 --fn/--all 与「默认只刷已有生成段」约束）。
+         */
+        emit?: string[] | string;
+    };
+    /** 分析范围与噪声档（design-cli-semantics.md §7） */
+    analysis?: {
+        include?: string[] | string;
+        exclude?: string[] | string;
+        /** directives | exports（默认）| all */
+        mode?: string;
+        /** off | errors | default | verbose */
+        diagnostics?: string;
+        /** polyvariant：保留的精确调用点 case 上限（默认 3）；超出进 symbolic #widened */
+        callSiteBudget?: number;
+        /** C0.5：求值命中闭对象缺字段 → nudo:missing-slot；默认 off */
+        evalMissingSlot?: "off" | "warning";
+        /**
+         * B $fork 总次数上限（默认 5000）。env `NUDO_MAX_FORKS` 优先。
+         * n≥1 有限整数；非法值回默认。启动时 set 进 core（setBForkBudgetLimit）。
+         */
+        maxForks?: number;
+    };
+    /** 磁盘缓存（B3）：true → `.nudo/cache`；字符串 → 自定义根；false/省略 → 关 */
+    cache?: boolean | string;
+    /**
+     * 进程内会话 LRU 上限（内存/速度权衡）。多项目开 IDE 时调低封顶；
+     * 单大仓 warm 命中可调高。0 = 关闭该层。env `NUDO_CACHE_MAX_*` 优先。
+     */
+    sessionCache?: {
+        maxFiles?: number;
+        maxFns?: number;
+        maxBRuns?: number;
+    };
+    /** check 门禁（design-cli-semantics §3） */
+    check?: {
+        /** L2 入口 may-throw：error | warning | off（默认 error） */
+        entryThrows?: "error" | "warning" | "off";
+        /** L2 --ignore-throws 类型名列表 */
+        ignoreThrows?: string[];
+    };
+};
+type InterfaceConfig = {
+    autoBind: boolean;
+    /** emit 路径白名单（已归一化；空数组 = 不限制） */
+    emit: string[];
+};
+type AnalysisMode = "directives" | "exports" | "all";
+type DiagnosticsLevel = "off" | "errors" | "default" | "verbose";
+type AnalysisConfig = {
+    include: string[];
+    exclude: string[];
+    mode: AnalysisMode;
+    diagnostics: DiagnosticsLevel;
+    /** polyvariant 精确调用点上限（B4） */
+    callSiteBudget: number;
+    /** C0.5 evaluation-driven missing-slot；默认 off */
+    evalMissingSlot: "off" | "warning";
+    /** B $fork 总次数上限（已归一化；非法值回 core 默认） */
+    maxForks: number;
+};
+type CheckConfig = {
+    /** L2 入口 may-throw 执法档；默认 error */
+    entryThrows: "error" | "warning" | "off";
+    /** L2 ignoreThrows 类型名；默认空 */
+    ignoreThrows: string[];
+};
+/** package.json#nudo.check → 执法选项 */
+declare function checkConfig(config: NudoConfig | null | undefined): CheckConfig;
+/** A1 产品默认：exports — 普通带导出的 .js 进 IDE；directives/all 需显式 */
+declare const DEFAULT_ANALYSIS_MODE: AnalysisMode;
+/**
+ * 归一化 `nudo.analysis`。默认 mode=exports（A1：无指令但有 export/侧车的文件
+ * 进 IDE 分析；`all` / `directives` 需显式配置）。
+ * diagnostics：directives→errors，exports/all→default。
+ * include 空 = 不按路径过滤（isNudoTargetPath 已管扩展名）。
+ */
+declare function analysisConfig(config: NudoConfig | null | undefined): AnalysisConfig;
+/**
+ * 把 fork 预算写进 core（core 保持无 IO）。
+ * 优先级：env `NUDO_MAX_FORKS` > `package.json#nudo.analysis.maxForks` > 默认 5000。
+ * 约定：n≥1 有限整数；非法值回默认。返回实际生效值。
+ * 由 findProjectConfig / 宿主启动时调用（与 setSessionCacheFromProject 同时机）。
+ */
+declare function applyBForkBudgetFromConfig(config: NudoConfig | null | undefined, env?: NodeJS.ProcessEnv): number;
+/** 当前生效 fork 上限（调试/测试；与 core getBForkBudgetLimit 同源） */
+declare function currentBForkBudgetLimit(): number;
+/** 磁盘缓存根（B3）：config.cache / NUDO_CACHE_DIR / 默认关 */
+declare function diskCacheRoot(config: NudoConfig | null | undefined, projectDir: string | undefined): string | undefined;
+/**
+ * 归一化 `nudo.contract` 配置段。
+ * - autoBind 默认 true
+ * - emit：string | string[] → string[]（空 = 不限制路径）
+ */
+declare function interfaceConfig(config: NudoConfig | null | undefined): InterfaceConfig;
+/**
+ * 极简 glob（`**` / `*` / `?`）：相对 projectDir 匹配**源文件**绝对路径
+ * （不是侧车路径；侧车随源文件同目录写出）。无白名单 → true。
+ * 路径分隔符归一为 `/`。
+ */
+declare function matchesEmitAllowlist(absPath: string, projectDir: string | undefined, patterns: string[]): boolean;
+declare function findProjectConfig(startDir: string): {
+    config: NudoConfig;
+    projectDir: string;
+} | null;
+
+export { type AnalysisConfig as A, type CheckConfig as C, type DiagnosticsLevel as D, type InterfaceConfig as I, type NudoConfig as N, type AnalysisMode as a, analysisConfig as b, checkConfig as c, diskCacheRoot as d, DEFAULT_ANALYSIS_MODE as e, findProjectConfig as f, applyBForkBudgetFromConfig as g, currentBForkBudgetLimit as h, interfaceConfig as i, matchesEmitAllowlist as m };