@builder.io/dev-tools 1.25.0-dev.202602091727.eacc0b043 → 1.26.0-dev.202602091901.45f4b8d8b

package/types/_tests_/utils.d.ts

@@ -9,34 +9,40 @@ export declare function binaryExists(): boolean;
  */
 export declare function getBinaryPath(): string | null;
 interface CLI {
-    output(): string;
-    consumeOutput(): string;
-    inputText(text: string): Promise<void>;
-    inputEnter(text?: string): Promise<void>;
-    inputArrowUp(): Promise<void>;
-    inputArrowDown(): Promise<void>;
-    inputArrowRight(): Promise<void>;
-    inputArrowLeft(): Promise<void>;
-    inputCtrlC(): Promise<void>;
-    inputSpace(): Promise<void>;
-    waitUntilText(text: string, timeout?: number): Promise<void>;
-    waitUntilExit(): Promise<number>;
-    wait(ms: number): Promise<void>;
-    getProjectPath(): string;
-    writeFile(path: string, content: string): Promise<void>;
-    readFile(path: string): string;
-    exists(path: string): boolean;
-    readdir(path: string): string[];
-    fsSnapshot(path: string): Promise<Snapshot>;
-    fsDiff(oldSnap: Snapshot): Promise<{
-        added: string[];
-        removed: string[];
-        modified: string[];
-    }>;
-    npm(...args: string[]): Promise<number>;
-    spawn(command: string, args: string[]): Promise<number>;
+	output(): string;
+	consumeOutput(): string;
+	inputText(text: string): Promise<void>;
+	inputEnter(text?: string): Promise<void>;
+	inputArrowUp(): Promise<void>;
+	inputArrowDown(): Promise<void>;
+	inputArrowRight(): Promise<void>;
+	inputArrowLeft(): Promise<void>;
+	inputCtrlC(): Promise<void>;
+	inputSpace(): Promise<void>;
+	waitUntilText(text: string, timeout?: number): Promise<void>;
+	waitUntilExit(): Promise<number>;
+	wait(ms: number): Promise<void>;
+	getProjectPath(): string;
+	writeFile(path: string, content: string): Promise<void>;
+	readFile(path: string): string;
+	exists(path: string): boolean;
+	readdir(path: string): string[];
+	fsSnapshot(path: string): Promise<Snapshot>;
+	fsDiff(oldSnap: Snapshot): Promise<{
+		added: string[];
+		removed: string[];
+		modified: string[];
+	}>;
+	npm(...args: string[]): Promise<number>;
+	spawn(command: string, args: string[]): Promise<number>;
 }
-export declare function testCLI(name: string, template: string | undefined, handler: (cli: Handler, expect: ExpectStatic) => Promise<void>, timeout?: number, skip?: boolean): void;
+export declare function testCLI(
+	name: string,
+	template: string | undefined,
+	handler: (cli: Handler, expect: ExpectStatic) => Promise<void>,
+	timeout?: number,
+	skip?: boolean,
+): void;
 /**
  * Command types for the CLI handler:
  * - "builderio": Run via Node.js (dist/dev-tools/cli/main.cjs)
@@ -44,17 +50,24 @@ export declare function testCLI(name: string, template: string | undefined, hand
  * - "binary": Run via compiled pkg binary (dist/fusion-binaries/.../builder-fusion)
  */
 export type CLICommand = "builderio" | "create-builderio" | "binary";
-type Handler = (cmd: CLICommand, args: string[], options?: {
-    debug?: boolean;
-}) => CLI;
-export declare function createCLI(template: string | undefined, handler: (cli: Handler) => Promise<void>): Promise<void>;
+type Handler = (
+	cmd: CLICommand,
+	args: string[],
+	options?: {
+		debug?: boolean;
+	},
+) => CLI;
+export declare function createCLI(
+	template: string | undefined,
+	handler: (cli: Handler) => Promise<void>,
+): Promise<void>;
 /**
  * A snapshot maps a file's relative path to its hash.
  */
 type Snapshot = {
-    cwd: string;
-    hashes: {
-        [file: string]: string;
-    };
+	cwd: string;
+	hashes: {
+		[file: string]: string;
+	};
 };
 export {};

package/types/cli/abort-signal-any.d.ts

@@ -1 +1,3 @@
-export declare function abortSignalAny(input: (AbortSignal | undefined)[]): AbortSignal;
+export declare function abortSignalAny(
+	input: (AbortSignal | undefined)[],
+): AbortSignal;

package/types/cli/auth/auth-utils.d.ts

@@ -1,2 +1,4 @@
 import type { Credentials } from "../credentials";
-export declare function getUserSettingsByUserId(credentials: Credentials): Promise<any>;
+export declare function getUserSettingsByUserId(
+	credentials: Credentials,
+): Promise<any>;

package/types/cli/auth/auth.d.ts

@@ -1,3 +1,7 @@
 import type { DevToolsSys } from "../../types";
 import type { CLIArgs } from "../index";
-export declare const runAuthCommand: (sys: DevToolsSys, subCommand: string, args: CLIArgs) => Promise<void>;
+export declare const runAuthCommand: (
+	sys: DevToolsSys,
+	subCommand: string,
+	args: CLIArgs,
+) => Promise<void>;

package/types/cli/backup.d.ts

@@ -1,23 +1,32 @@
 import type { DevToolsSys } from "../types";
 import type { Credentials } from "./credentials";
-import { type GitBackupUploadUrlResult, type GitBackupUploadUrlOptions, type GitBackupRecordOptions, type GitBackupRecordResult, type BackupMetadata, type WorkspaceConfiguration, type CodegenRuntimeStatus, type BackupGitRepoResult } from "$/ai-utils";
+import {
+	type GitBackupUploadUrlResult,
+	type GitBackupUploadUrlOptions,
+	type GitBackupRecordOptions,
+	type GitBackupRecordResult,
+	type BackupMetadata,
+	type WorkspaceConfiguration,
+	type CodegenRuntimeStatus,
+	type BackupGitRepoResult,
+} from "$/ai-utils";
 interface BackupGitRepoOptions {
-    sys: DevToolsSys;
-    credentials: Credentials;
-    projectId: string;
-    branchName: string;
-    repoPath: string;
-    aiBranch: string;
-    featureBranch: string;
-    workspace: WorkspaceConfiguration | undefined;
-    /**
-     * If true, the system is connected to the git provider.
-     * If false, the system is offline and will not fetch any branches from origin.
-     */
-    isConnectedToProvider: boolean;
-    debug: boolean;
-    forcedFullBackup: boolean;
-    canAbortMerge: boolean;
+	sys: DevToolsSys;
+	credentials: Credentials;
+	projectId: string;
+	branchName: string;
+	repoPath: string;
+	aiBranch: string;
+	featureBranch: string;
+	workspace: WorkspaceConfiguration | undefined;
+	/**
+	 * If true, the system is connected to the git provider.
+	 * If false, the system is offline and will not fetch any branches from origin.
+	 */
+	isConnectedToProvider: boolean;
+	debug: boolean;
+	forcedFullBackup: boolean;
+	canAbortMerge: boolean;
 }
 /**
  * Creates a backup of git repository changes made by the AI system.
@@ -31,20 +40,35 @@ interface BackupGitRepoOptions {
  * The aiBranch is where the AI creates commits as work progresses, while featureBranch
  * is the base branch where work started (usually "main").
  */
-export declare function backupGitRepo({ sys, credentials, projectId, branchName, repoPath, aiBranch, featureBranch, workspace, isConnectedToProvider, debug, forcedFullBackup, canAbortMerge, }: BackupGitRepoOptions): Promise<BackupGitRepoResult>;
-type InitialCommitHashResult = {
-    initialBranch: string;
-    initialCommitHash: string | undefined;
-    partial: false;
-    forcedFullBackup: true;
-    tokenRefreshFailed?: boolean;
-} | {
-    initialBranch: string;
-    initialCommitHash: string;
-    partial: boolean;
-    forcedFullBackup: false;
-    tokenRefreshFailed?: boolean;
-};
+export declare function backupGitRepo({
+	sys,
+	credentials,
+	projectId,
+	branchName,
+	repoPath,
+	aiBranch,
+	featureBranch,
+	workspace,
+	isConnectedToProvider,
+	debug,
+	forcedFullBackup,
+	canAbortMerge,
+}: BackupGitRepoOptions): Promise<BackupGitRepoResult>;
+type InitialCommitHashResult =
+	| {
+			initialBranch: string;
+			initialCommitHash: string | undefined;
+			partial: false;
+			forcedFullBackup: true;
+			tokenRefreshFailed?: boolean;
+	  }
+	| {
+			initialBranch: string;
+			initialCommitHash: string;
+			partial: boolean;
+			forcedFullBackup: false;
+			tokenRefreshFailed?: boolean;
+	  };
 /**
  * Determines the initial commit hash and whether to create a partial or full backup.
  *
@@ -55,66 +79,96 @@ type InitialCommitHashResult = {
  * For partial backups, we fetch the latest state of the chosen upstream branch from origin
  * to ensure the backup has the correct commit range reference.
  */
-export declare function getInitialCommitHash({ sys, repoPath, featureBranch, debug, workspace, isConnectedToProvider, forcedFullBackup, credentials, projectId, }: {
-    sys: DevToolsSys;
-    repoPath: string;
-    featureBranch: string;
-    debug: boolean;
-    workspace: WorkspaceConfiguration | undefined;
-    isConnectedToProvider: boolean;
-    forcedFullBackup: boolean;
-    credentials: Credentials;
-    projectId: string;
+export declare function getInitialCommitHash({
+	sys,
+	repoPath,
+	featureBranch,
+	debug,
+	workspace,
+	isConnectedToProvider,
+	forcedFullBackup,
+	credentials,
+	projectId,
+}: {
+	sys: DevToolsSys;
+	repoPath: string;
+	featureBranch: string;
+	debug: boolean;
+	workspace: WorkspaceConfiguration | undefined;
+	isConnectedToProvider: boolean;
+	forcedFullBackup: boolean;
+	credentials: Credentials;
+	projectId: string;
 }): Promise<InitialCommitHashResult>;
 /**
  * Requests a signed upload URL for git backup
  */
-export declare function requestSignedUploadUrl(credentials: Credentials, body: GitBackupUploadUrlOptions): Promise<GitBackupUploadUrlResult | null>;
+export declare function requestSignedUploadUrl(
+	credentials: Credentials,
+	body: GitBackupUploadUrlOptions,
+): Promise<GitBackupUploadUrlResult | null>;
 /**
  * Records a successful git backup in Firebase
  */
-export declare function recordBackup(credentials: Credentials, body: GitBackupRecordOptions): Promise<GitBackupRecordResult>;
+export declare function recordBackup(
+	credentials: Credentials,
+	body: GitBackupRecordOptions,
+): Promise<GitBackupRecordResult>;
 export interface GitBackupDownloadResultValid {
-    success: true;
-    partial: boolean;
-    bundlePath: string | undefined;
-    bundleSize: number;
-    gitBranchName: string;
-    lastCommitHash: string;
+	success: true;
+	partial: boolean;
+	bundlePath: string | undefined;
+	bundleSize: number;
+	gitBranchName: string;
+	lastCommitHash: string;
 }
 export interface GitBackupDownloadResultInvalid {
-    success: false;
-    error: Error;
+	success: false;
+	error: Error;
 }
-export type GitBackupDownloadResult = GitBackupDownloadResultValid | GitBackupDownloadResultInvalid;
+export type GitBackupDownloadResult =
+	| GitBackupDownloadResultValid
+	| GitBackupDownloadResultInvalid;
 /**
  * Downloads a git backup bundle from remote storage.
  * Handles both empty backups (no bundle file) and regular backups with bundle files.
  * @returns The path to the downloaded bundle file, or undefined if it's an empty backup
  */
-export declare function downloadGitBackup(sys: DevToolsSys, response: BackupMetadata): Promise<GitBackupDownloadResult>;
+export declare function downloadGitBackup(
+	sys: DevToolsSys,
+	response: BackupMetadata,
+): Promise<GitBackupDownloadResult>;
 /**
  * Uploads a file stream to a signed URL (Google Cloud Storage).
  * Uses MD5 hash for content verification as required by GCS.
  */
-export declare function uploadFileStream(filePath: string, signedUrl: string, size: number, contentMd5: string): Promise<Response>;
+export declare function uploadFileStream(
+	filePath: string,
+	signedUrl: string,
+	size: number,
+	contentMd5: string,
+): Promise<Response>;
 export declare function computeMD5Hash(bundlePath: string): Promise<{
-    contentMd5: string;
-    size: number;
+	contentMd5: string;
+	size: number;
 }>;
 /**
  * Updates the last commit hash in the database for tracking purposes.
  * This is called frequently throughout the codebase (after every commit creation)
  * to track the current state and determine if backups are up-to-date.
  */
-export declare function setRuntimeStatus(sys: DevToolsSys, credentials: Credentials, data: CodegenRuntimeStatus): Promise<any>;
+export declare function setRuntimeStatus(
+	sys: DevToolsSys,
+	credentials: Credentials,
+	data: CodegenRuntimeStatus,
+): Promise<any>;
 /**
  * Computes a unique backup reference string that combines version, repo URL, and commit hash.
  * This reference can be used to identify and retrieve specific backups.
  */
 export declare function computeBackupRef(input: {
-    version: string | undefined;
-    originalRepoUrl: string | undefined;
-    commitHash: string | undefined;
+	version: string | undefined;
+	originalRepoUrl: string | undefined;
+	commitHash: string | undefined;
 }): string | undefined;
 export {};

package/types/cli/builder-add/interface.d.ts

@@ -1,5 +1,22 @@
-import type { AddCliOptions, FileNode, FolderNode, Snippet, SyncInfo } from "../../types";
-export declare function addCommand(opts: AddCliOptions): Promise<SyncInfo | undefined>;
+import type {
+	AddCliOptions,
+	FileNode,
+	FolderNode,
+	Snippet,
+	SyncInfo,
+} from "../../types";
+export declare function addCommand(
+	opts: AddCliOptions,
+): Promise<SyncInfo | undefined>;
 export declare function fetchSnippet(id: string): Promise<Snippet | null>;
-export declare function writeFiles(appRootDir: string, snippet: Snippet, files: Array<FileNode | FolderNode>, rootPath: string, addSessionLink: boolean): Promise<FileNode[]>;
-export declare function suggestRootPath(appRootDir: string, framework: string): string;
+export declare function writeFiles(
+	appRootDir: string,
+	snippet: Snippet,
+	files: Array<FileNode | FolderNode>,
+	rootPath: string,
+	addSessionLink: boolean,
+): Promise<FileNode[]>;
+export declare function suggestRootPath(
+	appRootDir: string,
+	framework: string,
+): string;

package/types/cli/code-file-utils.d.ts

@@ -1,8 +1,11 @@
-export declare function shouldIncludeFile(inputFile: string, ctx: {
-    foundFiles: string[];
-    allFiles: string[];
-    selectedFilePaths: Map<string, number>;
-    cwd: string;
-    appRootDir: string;
-    fallbackImportance: number | 0;
-}): number | 0;
+export declare function shouldIncludeFile(
+	inputFile: string,
+	ctx: {
+		foundFiles: string[];
+		allFiles: string[];
+		selectedFilePaths: Map<string, number>;
+		cwd: string;
+		appRootDir: string;
+		fallbackImportance: number | 0;
+	},
+): number | 0;

package/types/cli/code.d.ts

@@ -1,7 +1,17 @@
 import type { DevToolsSys } from "../types";
 import type { CLIArgs } from "./index";
 import { type UserContext } from "$/ai-utils";
-export declare const runCodeCommand: (sys: DevToolsSys, subCommand: string, args: CLIArgs) => Promise<void>;
-export declare const runCodeGen: (sys: DevToolsSys, args: CLIArgs) => Promise<undefined>;
-export declare function checkProjectRoot(sys: DevToolsSys, interactive: boolean): Promise<void>;
+export declare const runCodeCommand: (
+	sys: DevToolsSys,
+	subCommand: string,
+	args: CLIArgs,
+) => Promise<void>;
+export declare const runCodeGen: (
+	sys: DevToolsSys,
+	args: CLIArgs,
+) => Promise<undefined>;
+export declare function checkProjectRoot(
+	sys: DevToolsSys,
+	interactive: boolean,
+): Promise<void>;
 export declare function getUserContext(sys: DevToolsSys): Promise<UserContext>;

package/types/cli/codegen.d.ts

@@ -343,7 +343,15 @@ export declare class CodeGenSession {
     waitUntilBlockingPendingPromises(signal?: AbortSignal): Promise<void>;
     waitUntilIdle(signal?: AbortSignal): Promise<void>;
     waitForEventLoop(): Promise<void>;
-    commitWorkInProgress(lastTurn: CodegenTurn, changedFiles: string[]): Promise<string | false>;
+    /**
+     * Stages and optionally commits work in progress.
+     *
+     * When `#batchCommitsEnabled` is false (default): stages AND commits immediately.
+     * When `#batchCommitsEnabled` is true: only stages files, sets #pendingCommit flag.
+     *
+     * @returns commit hash if committed, false if no changes or staged only
+     */
+    commitWorkInProgress(defaultCommitMessage: string, changedFiles: string[]): Promise<string | false>;
     getChangesReport(): Promise<{
         diff: string;
         files: string[];

package/types/cli/credentials.d.ts

@@ -2,61 +2,77 @@ import type { DevToolsSys } from "../types";
 import type { CLIArgs } from "./index";
 import type { Feature } from "$/ai-utils";
 export interface CredentialsOptions {
-    forceSpaceId?: string;
-    builderPublicKey?: boolean;
-    builderPrivateKey?: boolean;
-    /**
-     * `always`: Figma auth will be required even if Figma credentials have already been set.
-     * `if-unset`: Figma auth will be required only if Figma credentials have not been set.
-     * `undefined` (default): Figma auth will never be required.
-     * */
-    requireFigmaAuth?: "always" | "if-unset";
-    /**
-     * If `true`, Builder.io auth will be required even if Builder.io credentials have
-     * already been set.
-     */
-    force?: boolean;
+	forceSpaceId?: string;
+	builderPublicKey?: boolean;
+	builderPrivateKey?: boolean;
+	/**
+	 * `always`: Figma auth will be required even if Figma credentials have already been set.
+	 * `if-unset`: Figma auth will be required only if Figma credentials have not been set.
+	 * `undefined` (default): Figma auth will never be required.
+	 * */
+	requireFigmaAuth?: "always" | "if-unset";
+	/**
+	 * If `true`, Builder.io auth will be required even if Builder.io credentials have
+	 * already been set.
+	 */
+	force?: boolean;
 }
 export interface FigmaAuth {
-    access_token: string;
-    oauth: boolean;
+	access_token: string;
+	oauth: boolean;
 }
 export interface BuilderCodegenUsage {
-    total: number | undefined;
-    fast: number | undefined;
-    quality: number | undefined;
-    features?: Feature[];
-    limits?: {
-        aiGeneration: number;
-        aiGenerationContextWindow: number;
-    };
+	total: number | undefined;
+	fast: number | undefined;
+	quality: number | undefined;
+	features?: Feature[];
+	limits?: {
+		aiGeneration: number;
+		aiGenerationContextWindow: number;
+	};
 }
 export interface BuilderAuth {
-    privateKey: string;
-    spaceId: string;
-    spaceName: string;
-    userId: string;
+	privateKey: string;
+	spaceId: string;
+	spaceName: string;
+	userId: string;
 }
 export declare const isCI: (args: CLIArgs) => boolean;
 export interface Credentials {
-    figmaAuth?: FigmaAuth;
-    builderPublicKey?: string;
-    builderPrivateKey?: string;
-    spaceName?: string;
-    userId?: string;
-    timestamp?: string;
+	figmaAuth?: FigmaAuth;
+	builderPublicKey?: string;
+	builderPrivateKey?: string;
+	spaceName?: string;
+	userId?: string;
+	timestamp?: string;
 }
-export declare const readCredentials: (sys: DevToolsSys, args: CLIArgs) => {
-    spaceName: string | undefined;
-    userId: string | undefined;
-    builderPublicKey: string | undefined;
-    builderPrivateKey: string | undefined;
-    figmaAuth: FigmaAuth | undefined;
-    timestamp: string | undefined;
+export declare const readCredentials: (
+	sys: DevToolsSys,
+	args: CLIArgs,
+) => {
+	spaceName: string | undefined;
+	userId: string | undefined;
+	builderPublicKey: string | undefined;
+	builderPrivateKey: string | undefined;
+	figmaAuth: FigmaAuth | undefined;
+	timestamp: string | undefined;
 };
-export declare const getCredentials: (sys: DevToolsSys, args: CLIArgs, opts: CredentialsOptions) => Promise<Credentials>;
+export declare const getCredentials: (
+	sys: DevToolsSys,
+	args: CLIArgs,
+	opts: CredentialsOptions,
+) => Promise<Credentials>;
 export declare function getFigmaAuth(sys: DevToolsSys): Promise<FigmaAuth>;
-export declare function getBuilderCodegenUsage(builderPublicKey: string, builderPrivateKey: string): Promise<BuilderCodegenUsage>;
-export declare function getBuilderAuth(sys: DevToolsSys, preferSpaceId?: string): Promise<BuilderAuth>;
-export declare function storeCredentials(sys: DevToolsSys, credentials: Credentials): void;
+export declare function getBuilderCodegenUsage(
+	builderPublicKey: string,
+	builderPrivateKey: string,
+): Promise<BuilderCodegenUsage>;
+export declare function getBuilderAuth(
+	sys: DevToolsSys,
+	preferSpaceId?: string,
+): Promise<BuilderAuth>;
+export declare function storeCredentials(
+	sys: DevToolsSys,
+	credentials: Credentials,
+): void;
 export declare function clearCredentials(sys: DevToolsSys): boolean;

package/types/cli/detectors/nextjs.d.ts

@@ -10,4 +10,7 @@ import type { GuessedSettings } from "$/ai-utils";
  * 4. package.json has a "dev" script
  * 5. The dev script includes "next dev"
  */
-export declare function detectNextJsSettings(basePath: string, files: string[]): Promise<GuessedSettings | null>;
+export declare function detectNextJsSettings(
+	basePath: string,
+	files: string[],
+): Promise<GuessedSettings | null>;

package/types/cli/detectors/svelte.d.ts

@@ -12,4 +12,7 @@ import type { GuessedSettings } from "$/ai-utils";
  * 6. Svelte is listed as a dependency
  * 7. Either @sveltejs/kit or @sveltejs/vite-plugin-svelte is a dependency
  */
-export declare function detectSvelteSettings(basePath: string, files: string[]): Promise<GuessedSettings | null>;
+export declare function detectSvelteSettings(
+	basePath: string,
+	files: string[],
+): Promise<GuessedSettings | null>;

package/types/cli/detectors/vue.d.ts

@@ -14,4 +14,7 @@ import type { GuessedSettings } from "$/ai-utils";
  * Note: This detector focuses on standard Vue projects (Vue 3 + Vite or Vue 2 + CLI).
  * Nuxt projects are handled separately as a different framework.
  */
-export declare function detectVueSettings(basePath: string, files: string[]): Promise<GuessedSettings | null>;
+export declare function detectVueSettings(
+	basePath: string,
+	files: string[],
+): Promise<GuessedSettings | null>;

package/types/cli/doctor/doctor.d.ts

@@ -0,0 +1,3 @@
+import type { DevToolsSys } from "../../types.js";
+import type { CLIArgs } from "../index.js";
+export declare function runDoctorCommand(sys: DevToolsSys, _subCommand: string | undefined, args: CLIArgs): Promise<void>;

package/types/cli/download.d.ts

@@ -2,9 +2,14 @@ import type { CLIArgs } from "./index";
 import type { DevToolsSys } from "../types";
 import type { FigmaBuilderLink } from "$/ai-utils";
 interface KVGetRequest {
-    privateKey: string;
-    spaceId: string;
+	privateKey: string;
+	spaceId: string;
 }
-export declare const runFigmaMigrate: (sys: DevToolsSys, args: CLIArgs) => Promise<undefined>;
-export declare function getBuilderSpaceFigmaLinks(kvReq: KVGetRequest): Promise<FigmaBuilderLink[]>;
+export declare const runFigmaMigrate: (
+	sys: DevToolsSys,
+	args: CLIArgs,
+) => Promise<undefined>;
+export declare function getBuilderSpaceFigmaLinks(
+	kvReq: KVGetRequest,
+): Promise<FigmaBuilderLink[]>;
 export {};

package/types/cli/dsi-mcp.d.ts

@@ -1,3 +1,6 @@
 import type { DevToolsSys } from "../types";
 import type { CLIArgs } from "./index";
-export declare function runDsiMcpServer(sys: DevToolsSys, args: CLIArgs): Promise<void>;
+export declare function runDsiMcpServer(
+	sys: DevToolsSys,
+	args: CLIArgs,
+): Promise<void>;