create-done-coding 0.12.3-alpha.0 → 0.13.0

package/es/index.mjs

@@ -1,18 +1,23 @@
 #!/usr/bin/env node
-import { F as s, G as t, S as d, e as c, a as p, b as u, h as l, d as b, i as f } from "./index-b3017a49.js";
+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 "@done-coding/cli-utils";
+import "node:crypto";
 import "node:fs";
+import "node:os";
 import "node:path";
 import "@done-coding/cli-template";
 import "@done-coding/cli-git";
 export {
-  s as FormNameEnum,
-  t as GitRemoteRepoAliasNameEnum,
-  d as SubcommandEnum,
-  c as commandCliInfo,
-  p as createAsSubcommand,
-  u as createCommandCliInfo,
-  l as createHandler,
-  b as handler,
-  f as injectInfo
+  i as CreateTemplateSourceTypeEnum,
+  c as FormNameEnum,
+  d as GitRemoteRepoAliasNameEnum,
+  u as SubcommandEnum,
+  l as commandCliInfo,
+  C as completeCreateProject,
+  f as createAsSubcommand,
+  b as createCommandCliInfo,
+  E as createHandler,
+  S as handler,
+  j as injectInfo,
+  I as prepareCreateProject
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-done-coding",
-  "version": "0.12.3-alpha.0",
+  "version": "0.13.0",
   "description": "项目创建命令行工具",
   "module": "es/index.mjs",
   "type": "module",
@@ -37,7 +37,7 @@
   "license": "MIT",
   "sideEffects": false,
   "devDependencies": {
-    "@done-coding/cli-inject": "0.6.3-alpha.0",
+    "@done-coding/cli-inject": "0.6.3",
     "@types/node": "^18.0.0",
     "@types/yargs": "^17.0.28",
     "typescript": "^5.8.3",
@@ -45,12 +45,12 @@
     "vite-plugin-dts": "^3.6.0"
   },
   "dependencies": {
-    "@done-coding/cli-git": "0.7.3-alpha.0",
-    "@done-coding/cli-template": "0.9.3-alpha.0",
-    "@done-coding/cli-utils": "0.9.3-alpha.0"
+    "@done-coding/cli-git": "0.7.3",
+    "@done-coding/cli-template": "0.10.0",
+    "@done-coding/cli-utils": "0.10.0"
   },
   "engines": {
     "node": ">=18.0.0"
   },
-  "gitHead": "1d0c93a5b93d65a8c01652b576c9c6991abf4c8c"
+  "gitHead": "ce637a19aaa611dec1ec33a1bb4164d622d05198"
 }

package/types/index.d.ts

@@ -1,30 +1,70 @@
 import { CliHandlerArgv } from '@done-coding/cli-utils';
 import { CliInfo } from '@done-coding/cli-utils';
 import { CommandModule } from 'yargs';
+import type { HandlerContextInit } from '@done-coding/cli-utils';
 import type { SubCliInfo } from '@done-coding/cli-utils';
 
+/** create 包根命令配置 */
 export declare const commandCliInfo: Omit<CliInfo, "usage">;
 
+/** 完成创建项目：使用 prepare 阶段草稿和模板参数完成编译、git 初始化与目录落位 */
+export declare const completeCreateProject: (argv: CliHandlerArgv<CreateCompleteOptions>, ctxInit?: HandlerContextInit) => Promise<{
+    success: boolean;
+    projectPath: string;
+    draftId: string;
+    message: string;
+}>;
+
 /** 作为子命令创建 */
 export declare const createAsSubcommand: () => CommandModule<{}, {}>;
 
+/** create 子命令配置 */
 export declare const createCommandCliInfo: SubCliInfo;
 
+/** create complete 入参 */
+export declare interface CreateCompleteOptions extends CreateOptions {
+    /** prepare 阶段返回的草稿 ID */
+    draftId: string;
+    /** 模板预置问题答案 */
+    envData?: Record<string, any>;
+}
+
+/** create 包配置文件结构 */
 export declare interface CreateConfigJson {
+    /** 可选模板列表 */
     templateList: CreateTemplateChoiceItem[];
 }
 
-export declare const createHandler: (argv: CliHandlerArgv<CreateOptions>) => Promise<undefined>;
+/** 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[];
+} | {
+    success: boolean;
+    projectPath: string;
+    draftId: string;
+    message: string;
+} | undefined>;
 
+/** 创建项目命令参数 */
 export declare interface CreateOptions {
+    /** 创建项目的根目录 */
+    rootDir?: string;
     /** 项目名称 */
     [FormNameEnum.PROJECT_NAME]?: string;
     /** 是否仅仅(从done-coding系列项目列表中)克隆远程仓库 */
     justCloneFromDoneCoding?: boolean;
-    /** 模板仓库地址 */
+    /** 模板地址，远程 git 地址或本地绝对路径 */
+    [FormNameEnum.TEMPLATE_URL]?: string;
+    /** 模板仓库地址 @deprecated 使用 templateUrl */
     [FormNameEnum.TEMPLATE_GIT_PATH]?: string;
     /** 模板仓库分支 -- 不传则是默认分支 */
     [FormNameEnum.TEMPLATE_GIT_BRANCH]?: string;
+    /** 仓库内模板目录 */
+    templateDirectory?: string;
     /** 是否跳过模板编译(不跳过则会在克隆完成后进行模板编译)
      * --
      * 为MCP模式预留 设置为true则不会进行模板编译
@@ -54,6 +94,27 @@ export declare interface CreateOptions {
     [FormNameEnum.GIT_COMMIT_MESSAGE]?: string;
 }
 
+/** create prepare 返回的模板预置问题 */
+export declare interface CreatePrepareQuestion {
+    key: string;
+    label: string;
+    initial?: string;
+}
+
+/** create prepare 结果 */
+export declare type CreatePrepareResult = {
+    status: "ready";
+    draftId: string;
+    projectPath: string;
+    draftProjectPath: string;
+} | {
+    status: "need_input";
+    draftId: string;
+    projectPath: string;
+    draftProjectPath: string;
+    questions: CreatePrepareQuestion[];
+};
+
 /** 创建模板-分支信息 */
 export declare interface CreateTemplateBranchInfo {
     /** 分支名 */
@@ -66,8 +127,10 @@ export declare interface CreateTemplateBranchInfo {
 export declare interface CreateTemplateChoiceItem {
     /** 模板名 */
     name: string;
-    /** 仓库地址 */
+    /** 模板 git 仓库地址，远程 git 地址或本地 git 仓库根路径 */
     url?: string;
+    /** 仓库内模板目录 */
+    directory?: string;
     /** 描述 */
     description?: string;
     /** 目标分支 */
@@ -76,6 +139,14 @@ export declare interface CreateTemplateChoiceItem {
     instances?: string[];
 }
 
+/** 创建模板来源类型 */
+export declare enum CreateTemplateSourceTypeEnum {
+    /** git 仓库模板 */
+    GIT = "git",
+    /** 本地目录模板 */
+    LOCAL = "local"
+}
+
 /** 表单name枚举 */
 export declare enum FormNameEnum {
     /** 项目名称选择 */
@@ -98,11 +169,9 @@ export declare enum FormNameEnum {
     CUSTOM_GIT_URL_INPUT = "customUrl",
     /** git的提交信息 */
     GIT_COMMIT_MESSAGE = "gitCommitMessage",
-    /**
-     *  模板仓库地址
-     * ----
-     * 为mcp拓展所加
-     */
+    /** 模板地址 */
+    TEMPLATE_URL = "templateUrl",
+    /** 模板仓库地址 @deprecated 使用 TEMPLATE_URL */
     TEMPLATE_GIT_PATH = "templateGitPath",
     /** 模板仓库分支 */
     TEMPLATE_GIT_BRANCH = "templateGitBranch"
@@ -116,11 +185,23 @@ export declare enum GitRemoteRepoAliasNameEnum {
     UPSTREAM = "upstream"
 }
 
-export declare const handler: (command: SubcommandEnum, argv: CliHandlerArgv<any>) => Promise<undefined>;
+/** create 包根 handler */
+export declare const handler: (command: SubcommandEnum, argv: CliHandlerArgv<any>) => Promise<{
+    status: "need_input";
+    draftId: string;
+    projectPath: string;
+    draftProjectPath: string;
+    questions: CreatePrepareQuestion[];
+} | {
+    success: boolean;
+    projectPath: string;
+    draftId: string;
+    message: string;
+} | undefined>;
 
 export declare const injectInfo: {
     "name": "create-done-coding",
-    "version": "0.12.3-alpha.0",
+    "version": "0.13.0",
     "description": "项目创建命令行工具",
     "bin": {
         "create-done-coding": "es/cli.mjs"
@@ -131,7 +212,12 @@ export declare const injectInfo: {
     }
 };
 
+/** 准备创建项目：非交互模式下克隆模板、读取模板预置问题并返回草稿信息 */
+export declare const prepareCreateProject: (argv: CliHandlerArgv<CreateOptions>, ctxInit?: HandlerContextInit) => Promise<CreatePrepareResult>;
+
+/** create 包子命令枚举 */
 export declare enum SubcommandEnum {
+    /** 创建项目命令 */
     CREATE = "create"
 }