create-done-coding 0.13.0 → 0.14.0

package/es/index.mjs

@@ -1,23 +1,28 @@
 #!/usr/bin/env node
-import { C as i, F as c, G as d, S as u, f as l, d as C, a as f, b, h as E, e as S, i as j, p as I } from "./index-49fe32cc.js";
+import { C as p, F as c, G as l, L as C, S as d, k as u, f as T, a as f, e as E, h as L, g as P, j as I, i as A, p as F, b as R, d as b, r as g } from "./index-8c566507.js";
 import "@done-coding/cli-utils";
-import "node:crypto";
-import "node:fs";
 import "node:os";
 import "node:path";
+import "node:crypto";
+import "node:fs";
 import "@done-coding/cli-template";
 import "@done-coding/cli-git";
 export {
-  i as CreateTemplateSourceTypeEnum,
+  p as CreateTemplateSourceTypeEnum,
   c as FormNameEnum,
-  d as GitRemoteRepoAliasNameEnum,
-  u as SubcommandEnum,
-  l as commandCliInfo,
-  C as completeCreateProject,
+  l as GitRemoteRepoAliasNameEnum,
+  C as LOCAL_POINTER_CONFIG_RELATIVE_PATH,
+  d as SubcommandEnum,
+  u as commandCliInfo,
+  T as completeCreateProject,
   f as createAsSubcommand,
-  b as createCommandCliInfo,
-  E as createHandler,
-  S as handler,
-  j as injectInfo,
-  I as prepareCreateProject
+  E as createCommandCliInfo,
+  L as createHandler,
+  P as getLocalPointerConfigPath,
+  I as handler,
+  A as injectInfo,
+  F as prepareCreateProject,
+  R as readTemplateListFromFile,
+  b as readTemplateListResource,
+  g as resolveTemplateConfigPath
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-done-coding",
-  "version": "0.13.0",
+  "version": "0.14.0",
   "description": "项目创建命令行工具",
   "module": "es/index.mjs",
   "type": "module",
@@ -22,6 +22,8 @@
   "scripts": {
     "dev": "vite build -w -m hotBuild",
     "build": "vite build",
+    "test": "vitest run",
+    "test:watch": "vitest",
     "prepack": "pnpm build"
   },
   "repository": {
@@ -37,20 +39,21 @@
   "license": "MIT",
   "sideEffects": false,
   "devDependencies": {
-    "@done-coding/cli-inject": "0.6.3",
+    "@done-coding/cli-inject": "0.6.4",
     "@types/node": "^18.0.0",
     "@types/yargs": "^17.0.28",
     "typescript": "^5.8.3",
     "vite": "^4.4.11",
-    "vite-plugin-dts": "^3.6.0"
+    "vite-plugin-dts": "^3.6.0",
+    "vitest": "^1.6.1"
   },
   "dependencies": {
-    "@done-coding/cli-git": "0.7.3",
-    "@done-coding/cli-template": "0.10.0",
-    "@done-coding/cli-utils": "0.10.0"
+    "@done-coding/cli-git": "0.7.4",
+    "@done-coding/cli-template": "0.11.0",
+    "@done-coding/cli-utils": "0.11.0"
   },
   "engines": {
     "node": ">=18.0.0"
   },
-  "gitHead": "ce637a19aaa611dec1ec33a1bb4164d622d05198"
+  "gitHead": "d5d89297f6cf953893f2d9ceb591c96ce0114656"
 }

package/types/index.d.ts

@@ -37,12 +37,10 @@ export declare interface CreateConfigJson {
 
 /** create 命令 handler：交互模式保持原 CLI 流程，非交互模式走 prepare/complete 协议 */
 export declare const createHandler: (argv: CliHandlerArgv<CreateOptions>, ctxInit?: HandlerContextInit) => Promise<{
-    status: "need_input";
-    draftId: string;
-    projectPath: string;
-    draftProjectPath: string;
-    questions: CreatePrepareQuestion[];
-} | {
+    default?: string | undefined;
+    key: string;
+    required: boolean;
+}[] | {
     success: boolean;
     projectPath: string;
     draftId: string;
@@ -65,6 +63,26 @@ export declare interface CreateOptions {
     [FormNameEnum.TEMPLATE_GIT_BRANCH]?: string;
     /** 仓库内模板目录 */
     templateDirectory?: string;
+    /**
+     * 模板列表配置文件路径（本地）
+     * ---
+     * 指向一个 `{ templateList: [...] }` 配置文件。优先级：本选项 > home 指针文件
+     * (`~/.done-coding/create/index.json`) > 内置远端配置。
+     * MCP 列表工具下为必填；CLI 选填（不传则回落 home 指针 / 内置远端）。
+     */
+    templateConfig?: string;
+    /**
+     * 模板预设答案(JSON 字符串)，非交互供答。
+     * ---
+     * 如 `--env '{"organization":"acme","name":"app"}'`。key 对齐模板
+     * `.done-coding/template.json` 的 `collectEnvDataForm[].key`（不是 label）。
+     * 与 `envFile` 同时给出时，本字段浅覆盖 `envFile`。
+     */
+    env?: string;
+    /** 模板预设答案 JSON 文件路径(非交互供答)，内容为 `{ key: value }` 对象 */
+    envFile?: string;
+    /** 仅打印该模板预设问题清单(JSON)到 stdout，不创建项目、不留草稿 */
+    listQuestions?: boolean;
     /** 是否跳过模板编译(不跳过则会在克隆完成后进行模板编译)
      * --
      * 为MCP模式预留 设置为true则不会进行模板编译
@@ -139,6 +157,16 @@ export declare interface CreateTemplateChoiceItem {
     instances?: string[];
 }
 
+/** create-mcp「模板列表资源」读取结果的载荷结构 */
+export declare interface CreateTemplateListResource {
+    /** 固定为 "local"：本资源只读本地、不联网、不读全局/远程 */
+    source: "local";
+    /** 解析所用的本地配置文件绝对路径 */
+    configPath: string;
+    /** 模板列表（缺失/非数组/解析失败 → 空数组） */
+    templateList: CreateTemplateChoiceItem[];
+}
+
 /** 创建模板来源类型 */
 export declare enum CreateTemplateSourceTypeEnum {
     /** git 仓库模板 */
@@ -177,6 +205,9 @@ export declare enum FormNameEnum {
     TEMPLATE_GIT_BRANCH = "templateGitBranch"
 }
 
+/** 本机指针配置文件绝对路径 */
+export declare const getLocalPointerConfigPath: () => string;
+
 /** 远程仓库别名枚举 */
 export declare enum GitRemoteRepoAliasNameEnum {
     /** 默认 */
@@ -187,12 +218,10 @@ export declare enum GitRemoteRepoAliasNameEnum {
 
 /** create 包根 handler */
 export declare const handler: (command: SubcommandEnum, argv: CliHandlerArgv<any>) => Promise<{
-    status: "need_input";
-    draftId: string;
-    projectPath: string;
-    draftProjectPath: string;
-    questions: CreatePrepareQuestion[];
-} | {
+    default?: string | undefined;
+    key: string;
+    required: boolean;
+}[] | {
     success: boolean;
     projectPath: string;
     draftId: string;
@@ -201,7 +230,7 @@ export declare const handler: (command: SubcommandEnum, argv: CliHandlerArgv<any
 
 export declare const injectInfo: {
     "name": "create-done-coding",
-    "version": "0.13.0",
+    "version": "0.14.0",
     "description": "项目创建命令行工具",
     "bin": {
         "create-done-coding": "es/cli.mjs"
@@ -212,9 +241,42 @@ export declare const injectInfo: {
     }
 };
 
+/**
+ * 本机【指针】配置文件相对 home 的路径。
+ * ---
+ * 该文件内容是一个【指针】：`{ "configPath": "/abs/真正的配置文件.json" }`，
+ * 指向真正的模板配置文件（`{ templateList: [...] }` = CreateConfigJson）。
+ * 不做多文件合并——用户若需合并，自行维护一份合并好的配置文件并在此指向它。
+ */
+export declare const LOCAL_POINTER_CONFIG_RELATIVE_PATH = ".done-coding/create/index.json";
+
 /** 准备创建项目：非交互模式下克隆模板、读取模板预置问题并返回草稿信息 */
 export declare const prepareCreateProject: (argv: CliHandlerArgv<CreateOptions>, ctxInit?: HandlerContextInit) => Promise<CreatePrepareResult>;
 
+/**
+ * 从指定【本地】配置文件读取模板列表。
+ * ---
+ * 不依赖网络。文件不存在 / 非数组 / 解析失败 → 返回 `[]` 并告警，绝不抛错阻塞。
+ */
+export declare const readTemplateListFromFile: (configPath: string) => Promise<CreateTemplateChoiceItem[]>;
+
+/**
+ * create-mcp「模板列表资源」的纯读取逻辑。
+ * ---
+ * 只调 `readTemplateListFromFile`（本地、不联网、不读家目录全局指针、不读远程默认）。
+ * `configPath` 缺失/为空 → 抛错（不静默联网、不回落）。供 MCP 资源回调与单测复用。
+ */
+export declare const readTemplateListResource: (configPath: string) => Promise<CreateTemplateListResource>;
+
+/**
+ * 解析"模板配置文件路径"。
+ * ---
+ * 优先级：显式传入(CLI `--template-config` / MCP `configPath`) > home 指针文件。
+ * 都没有 → 返回 undefined（由调用方回落到内置远端配置）。
+ * 不依赖网络；读取失败一律忽略，不抛错阻塞。
+ */
+export declare const resolveTemplateConfigPath: (explicitConfigPath?: string) => Promise<string | undefined>;
+
 /** create 包子命令枚举 */
 export declare enum SubcommandEnum {
     /** 创建项目命令 */