@actiondock/builder 2.0.12 → 2.2.0

package/dist/planner.d.ts

@@ -1,26 +1,68 @@
-import type { BuildPlan, BuildPlannerOptions } from "./types";
+import type { SelectionPlan, SelectionPlannerOptions } from "./types.js";
 /**
- * 构建规划器。
- * 纯声明式解析 actiondock.manifest.json 与配置，绝不执行 Action 业务代码。
+ * 声明式选择集与构建规划器 (SelectionPlanner)。
+ * 仅读取 actiondock.json、锁文件与显式构建参数，彻底移除 TypeScript AST 源码扫描。
  */
-export declare class BuildPlanner {
+export declare class SelectionPlanner {
     private projectRoot;
     constructor(options?: {
         projectRoot?: string;
     });
+    /**
+     * 解析项目配置：优先使用传入对象，缺失则读取 actiondock.json。
+     */
+    private resolveConfig;
+    /**
+     * 解析声明式清单：优先使用传入清单，缺失则读取 actiondock.json，仍未提供则采用安全备用清单。
+     */
+    private resolveManifest;
+    /**
+     * 收集 Playbook 规程定义（统一复用 core 的 loadPlaybooks，清单为唯一事实源）。
+     */
+    private collectPlaybooks;
+    /**
+     * 计算初始 Action 与 Playbook 集合（显式声明过滤、uses 顶层依赖与默认全集）。
+     */
+    private resolveInitialSelection;
+    /**
+     * 进行依赖闭包（uses）解析计算，自动处理环形依赖与传递依赖（支持当前清单与已链接外部包）。
+     */
+    private resolveClosure;
+    /**
+     * 构造 Action 依赖结构（闭包结果物化为 ActionDependency 列表）。
+     */
+    private buildActionDependencies;
+    /**
+     * 收集声明式文件与资产依赖结构（仅依据显式声明，杜绝 AST 依赖扫描与未声明模块猜测）。
+     */
+    private collectDeclaredFilesAndAssets;
     /**
      * 执行依赖闭包裁剪与构建规划。
+     * 主流程仅做编排，各阶段职责由私有方法承担。
      *
      * @param options 规划参数
-     * @returns 完整的 BuildPlan 结构
+     * @returns 完整的 SelectionPlan / BuildPlan 结构
      */
-    plan(options?: BuildPlannerOptions): BuildPlan;
+    plan(options?: SelectionPlannerOptions): SelectionPlan;
     /**
      * 静态辅助调用方法。
      */
-    static plan(options: BuildPlannerOptions): BuildPlan;
+    static plan(options: SelectionPlannerOptions): SelectionPlan;
 }
 /**
- * 快捷构建规划函数。
+ * 构建规划器标准导出。
+ * @deprecated SelectionPlanner 的历史别名，请直接使用 SelectionPlanner，将在两个版本后移除。
+ */
+export declare const BuildPlanner: typeof SelectionPlanner;
+/** @deprecated SelectionPlanner 类型的历史别名，请直接使用 SelectionPlanner 类型。 */
+export type BuildPlanner = SelectionPlanner;
+/**
+ * 快捷选择规划函数。
+ * @deprecated 便捷快捷函数，请直接使用 SelectionPlanner.plan，将在两个版本后移除。
+ */
+export declare function selectionPlan(options: SelectionPlannerOptions): SelectionPlan;
+/**
+ * 快捷构建规划函数标准导出。
+ * @deprecated selectionPlan 的历史别名，请改用 SelectionPlanner.plan，将在两个版本后移除。
  */
-export declare function buildPlan(options: BuildPlannerOptions): BuildPlan;
+export declare const buildPlan: typeof selectionPlan;