@pantoken/scaffold 1.2.0 → 1.3.0

package/dist/cli.d.mts

@@ -1,4 +1,4 @@
-import { a as scaffoldProject, i as resolveScaffoldPlatform, o as ThemeMode, r as isScaffoldPlatform, s as ThemeVariant, t as SCAFFOLD_PLATFORMS } from "./index-D2-Dhvt8.mjs";
+import { a as resolveScaffoldPlatform, d as ThemeMode, f as ThemeVariant, i as isScaffoldPlatform, l as installAgentAssets, n as ScaffoldPackageManager, o as scaffoldProject, t as SCAFFOLD_PLATFORMS } from "./index-rJolJRZa.mjs";
 import { Command } from "commander";
 //#region src/locale.d.ts
 /** Every locale tag pantoken supports, as `--lang` accepts them. */
@@ -87,6 +87,19 @@ export interface ResolveScaffoldTargetOptions {
   isTTY?: boolean;
   t: LocaleLookup["t"];
 }
+/**
+ * Resolves whether to install AI agent assets alongside the scaffold: `--no-ai` always wins
+ * (returns false); otherwise defaults to `true`, prompting via clack `confirm()` on a TTY (not
+ * --yes) to let the user opt out interactively.
+ *
+ * @throws ScaffoldCliError when the prompt is cancelled
+ */
+export declare function resolveAiAssets(opts: {
+  yes?: boolean;
+  isTTY: boolean;
+  noAi?: boolean;
+  t: LocaleLookup["t"];
+}): Promise<boolean>;
 /**
  * Resolves platform + directory: prompts via clack select()/text() when omitted on a TTY
  * (not --yes); throws ScaffoldCliError with a clear, localized message when a required
@@ -116,6 +129,7 @@ export declare function scaffoldWithSpinner(platform: string, dir: string, t: Lo
   mode?: ThemeMode;
   cdn?: string;
   locale?: string;
+  packageManager?: ScaffoldPackageManager;
 }): Promise<string[]>;
 /** Package managers `detectPackageManager` can identify. */
 export type PackageManager = "npm" | "pnpm" | "yarn" | "bun" | "deno" | "vp";
@@ -139,6 +153,10 @@ export declare function detectPackageManager(env?: NodeJS.ProcessEnv, execPath?:
 export declare function buildCreateUsageCommand(pm?: PackageManager): string;
 /**
  * Runs the detected package manager's install command in `dir`, wrapped in a clack spinner.
+ * Runs via async `spawn` (not `execFileSync`) so the spinner can actually animate while installing
+ * — a synchronous child process blocks the event loop and freezes the spinner's frames, making the
+ * CLI look hung even though it's working. Output is still suppressed (`stdio: "ignore"`); only the
+ * spinner's own text animates, updated periodically with the elapsed time.
  * Failures are reported but non-fatal — the project is still usable, just not installed — so the
  * caller decides how `printNextSteps` should reflect the outcome via the returned boolean.
  *
@@ -147,7 +165,7 @@ export declare function buildCreateUsageCommand(pm?: PackageManager): string;
  * @param t - Localized string lookup
  * @returns Whether the install command exited successfully
  */
-export declare function installWithSpinner(dir: string, pm: PackageManager | undefined, t: LocaleLookup["t"]): boolean;
+export declare function installWithSpinner(dir: string, pm: PackageManager | undefined, t: LocaleLookup["t"]): Promise<boolean>;
 /**
  * Prints the post-scaffold "Next steps" block (plus any template-authored notes/caveats).
  *
@@ -156,7 +174,8 @@ export declare function installWithSpinner(dir: string, pm: PackageManager | und
  * needed — regardless of platform. Otherwise, when `platform` has a `scaffold.json`-derived entry in
  * `SCAFFOLD_METADATA`, next steps/notes/caveats are rendered from its (localized, `{{var}}`-
  * substituted) authored strings; failing that, a generic cd/install/run-script fallback is used,
- * with the run script itself detected from the scaffolded `package.json` (`dev`, else `preview`).
+ * with the run script itself detected from the scaffolded `package.json` (`dev`, else `preview`)
+ * or defaulted to `dev` for scaffolded app templates.
  *
  * @param dir - The scaffold directory
  * @param written - The paths written by scaffoldProject
@@ -207,4 +226,4 @@ export declare function runScaffoldCli(argv: string[], options: {
   version?: string;
 }): Promise<void>;
 //#endregion
-export { type LocaleLookup, SCAFFOLD_PLATFORMS, isScaffoldPlatform, resolveScaffoldPlatform, scaffoldProject };
+export { type LocaleLookup, SCAFFOLD_PLATFORMS, installAgentAssets, isScaffoldPlatform, resolveScaffoldPlatform, scaffoldProject };