@builder.io/dev-tools 1.18.11-dev.202511202319.621aec6ae → 1.18.11-dev.202511210301.98709336d

package/types/vite/main.d.ts

@@ -3,5 +3,5 @@
  */
 export declare function builderDevTools(opts?: ViteBuilderDevToolsOptions): any;
 export interface ViteBuilderDevToolsOptions {
-	devToolsServerPort?: number;
+    devToolsServerPort?: number;
 }

package/types/webpack/main.d.ts

@@ -1,9 +1,9 @@
 export declare class BuilderDevToolsPlugin {
-	private readonly opts;
-	constructor(opts?: WebpackBuilderDevToolsOptions);
-	apply(c: any): void;
+    private readonly opts;
+    constructor(opts?: WebpackBuilderDevToolsOptions);
+    apply(c: any): void;
 }
 export interface WebpackBuilderDevToolsOptions {
-	enabled?: boolean;
-	devToolsServerPort?: number;
+    enabled?: boolean;
+    devToolsServerPort?: number;
 }

package/types/cli/env-substitution.d.ts

@@ -1,22 +0,0 @@
-/**
- * Substitutes environment variables in a string.
- * Replaces ${VAR_NAME} patterns with their corresponding values from the env object.
- * If a variable is not found in env, the pattern is left as-is.
- *
- * @param str - The string containing environment variable patterns
- * @param env - A record of environment variable names to their values
- * @returns The string with all ${VAR_NAME} patterns replaced
- *
- * @example
- * substituteEnvVars("Hello ${USER}!", { USER: "Alice" })
- * // Returns: "Hello Alice!"
- *
- * @example
- * substituteEnvVars("Path: ${HOME}/docs", { HOME: "/Users/alice" })
- * // Returns: "Path: /Users/alice/docs"
- *
- * @example
- * substituteEnvVars("Missing: ${UNKNOWN}", {})
- * // Returns: "Missing: ${UNKNOWN}"
- */
-export declare function substituteEnvVars(str: string, env: Record<string, string | undefined>): string;

package/types/cli/env-substitution.test.d.ts

@@ -1 +0,0 @@
-export {};

package/types/cli/utils/env-filter.d.ts

@@ -1,42 +0,0 @@
-import type { DevToolsSys } from "@builder.io/dev-tools/core";
-/**
- * Check if an environment variable key should be filtered out
- * @param key - The environment variable key to check
- * @returns true if the variable should be filtered out, false otherwise
- */
-export declare function shouldFilterEnvVar(key: string): boolean;
-/**
- * Filter out unwanted environment variables from process.env
- * @param env - The environment object to filter (defaults to process.env)
- * @returns Filtered environment variables
- */
-export declare function filterEnvVars(
-	env?: Record<string, string | undefined>,
-): Record<string, string>;
-/**
- * Load environment variables from .env files in the working directory.
- * Checks multiple .env file variants in order of priority.
- *
- * @param sys - DevToolsSys instance for file system access
- * @param workingDirectory - Directory to look for .env files (defaults to cwd)
- * @param envFiles - Array of .env file names to check (defaults to standard .env files)
- * @returns Object containing environment variables from .env files
- */
-export declare function loadDotEnvVars(
-	sys: DevToolsSys,
-	workingDirectory?: string,
-	envFiles?: string[],
-): Promise<Record<string, string>>;
-/**
- * Get a combined environment object with:
- * 1. Filtered process.env (excluding npm_*, IDE variables, etc.)
- * 2. .env file variables (highest priority)
- *
- * @param sys - DevToolsSys instance
- * @param workingDirectory - Directory to look for .env files
- * @returns Combined and filtered environment variables
- */
-export declare function getFilteredEnvWithDotEnv(
-	sys: DevToolsSys,
-	workingDirectory?: string,
-): Promise<Record<string, string>>;

package/types/cli/utils/lock-file-example.d.ts

@@ -1,30 +0,0 @@
-/**
- * Example demonstrating the lock file conflict behaviors
- *
- * This script demonstrates three different conflict behaviors:
- * - 'exit': Exits with code -10 if lock exists (default)
- * - 'replace': Overwrites existing lock file
- * - 'kill': Kills the existing process and overwrites lock file
- *
- * Usage:
- * ```bash
- * # Example 1: Exit behavior (default)
- * # First run - creates lock file and waits
- * ts-node lock-file-example.ts exit
- * # Second run (in another terminal) - exits with code -10
- * ts-node lock-file-example.ts exit
- *
- * # Example 2: Replace behavior
- * # First run - creates lock file and waits
- * ts-node lock-file-example.ts replace
- * # Second run - replaces the lock file (first process still runs)
- * ts-node lock-file-example.ts replace
- *
- * # Example 3: Kill behavior
- * # First run - creates lock file and waits
- * ts-node lock-file-example.ts kill
- * # Second run - kills the first process and takes over
- * ts-node lock-file-example.ts kill
- * ```
- */
-export {};

package/types/cli/utils/sudo-helper.d.ts

@@ -1,21 +0,0 @@
-import type { DevToolsSys } from "@builder.io/dev-tools/core";
-/**
- * Detects if a command contains "sudo"
- * @param command The command string to check
- * @returns true if the command contains "sudo", false otherwise
- */
-export declare function detectSudoInCommand(command: string): boolean;
-/**
- * Executes a command with sudo using sudo-prompt
- * @param command The command to execute
- * @param sys DevToolsSys instance for logging
- * @returns Promise with the execution result
- */
-export declare function executeSudoCommand(
-	command: string,
-	sys: DevToolsSys,
-): Promise<{
-	stdout: string;
-	stderr: string;
-	error?: Error;
-}>;

package/types/packages/dev-tools/_tests_/code.e2e.d.ts

@@ -1 +0,0 @@
-export {};

package/types/packages/dev-tools/_tests_/create-builder.e2e.d.ts

@@ -1 +0,0 @@
-export {};

package/types/packages/dev-tools/_tests_/dev-tools.e2e.d.ts

@@ -1 +0,0 @@
-export {};

package/types/packages/dev-tools/_tests_/figma-generate.e2e.d.ts

@@ -1 +0,0 @@
-export {};

package/types/packages/dev-tools/_tests_/figma-publish.e2e.d.ts

@@ -1 +0,0 @@
-export {};

package/types/packages/dev-tools/_tests_/fusionInit.e2e.d.ts

@@ -1 +0,0 @@
-export {};

package/types/packages/dev-tools/_tests_/help.e2e.d.ts

@@ -1 +0,0 @@
-export {};

package/types/packages/dev-tools/_tests_/launch.e2e.d.ts

@@ -1 +0,0 @@
-export {};

package/types/packages/dev-tools/_tests_/repo-indexing.test.d.ts

@@ -1 +0,0 @@
-export {};

package/types/packages/dev-tools/_tests_/sync-utils.test.d.ts

@@ -1 +0,0 @@
-export {};

package/types/packages/dev-tools/_tests_/utils.d.ts

@@ -1,57 +0,0 @@
-import { type ExpectStatic } from "vitest";
-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>;
-}
-export declare function testCLI(
-	name: string,
-	template: string | undefined,
-	handler: (cli: Handler, expect: ExpectStatic) => Promise<void>,
-	timeout?: number,
-	skip?: boolean,
-): void;
-type Handler = (
-	cmd: "builderio" | "create-builderio",
-	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;
-	};
-};
-export {};

package/types/packages/dev-tools/_tests_/vitest.config.d.ts

@@ -1,2 +0,0 @@
-declare const _default: import("vitest/config").UserConfigFnObject;
-export default _default;

package/types/packages/dev-tools/_tests_/workspace.e2e.d.ts

@@ -1 +0,0 @@
-export {};

package/types/packages/dev-tools/angular/index.d.ts

@@ -1 +0,0 @@
-export declare function builderDevTools(): Promise<void>;

package/types/packages/dev-tools/cli/__tests__/isLikelyFixedString.spec.d.ts

@@ -1 +0,0 @@
-export {};

package/types/packages/dev-tools/cli/__tests__/parseGitDiffToApplyActions.spec.d.ts

@@ -1 +0,0 @@
-export {};

package/types/packages/dev-tools/cli/abort-signal-any.d.ts

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

package/types/packages/dev-tools/cli/auth/auth-utils.d.ts

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

package/types/packages/dev-tools/cli/auth/auth.d.ts

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

package/types/packages/dev-tools/cli/auth/status.d.ts

@@ -1,3 +0,0 @@
-import type { DevToolsSys } from "../../types";
-import type { CLIArgs } from "../index";
-export declare const runAuthStatus: (sys: DevToolsSys, args: CLIArgs) => void;

package/types/packages/dev-tools/cli/backup.d.ts

@@ -1,172 +0,0 @@
-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";
-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;
-}
-/**
- * Creates a backup of git repository changes made by the AI system.
- *
- * This function handles both partial and full backups:
- * - Partial backups: Only include commits created locally (on aiBranch) that aren't in upstream.
- *   This keeps backups small and doesn't store the entire repo's code. Requires a clone from
- *   upstream plus applying the backup to restore.
- * - Full backups: Complete repo backup that can be directly cloned from.
- *
- * 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;
-	  }
-	| {
-			initialBranch: string;
-			initialCommitHash: string;
-			partial: boolean;
-			forcedFullBackup: false;
-	  };
-/**
- * Determines the initial commit hash and whether to create a partial or full backup.
- *
- * Partial backups are preferred to keep backup sizes small, but full backups are needed when:
- * - The repo is an example/starter template (users can't push to origin, need to fork)
- * - There's no origin remote configured
- *
- * 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;
-}): Promise<InitialCommitHashResult>;
-/**
- * Requests a signed upload URL for git backup
- */
-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 interface GitBackupDownloadResultValid {
-	success: true;
-	partial: boolean;
-	bundlePath: string | undefined;
-	bundleSize: number;
-	gitBranchName: string;
-	lastCommitHash: string;
-}
-export interface GitBackupDownloadResultInvalid {
-	success: false;
-	error: Error;
-}
-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>;
-/**
- * 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 computeMD5Hash(bundlePath: string): Promise<{
-	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>;
-/**
- * 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;
-}): string | undefined;
-export {};

package/types/packages/dev-tools/cli/builder-add/interface.d.ts

@@ -1,22 +0,0 @@
-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;

package/types/packages/dev-tools/cli/builder-add/options.d.ts

@@ -1,2 +0,0 @@
-import type { AddCliOptions } from "../../types";
-export declare function getOptions(cwd: string, args: string[]): AddCliOptions;

package/types/packages/dev-tools/cli/code-file-utils.d.ts

@@ -1,20 +0,0 @@
-import type { DevToolsSys } from "../types";
-import type { Credentials } from "./credentials";
-import type { CodebaseSearchOptions, CodebaseSearchResponse } from "$/ai-utils";
-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 searchCodeBase(
-	sys: DevToolsSys,
-	credentials: Credentials,
-	signal: AbortSignal | undefined,
-	body: CodebaseSearchOptions,
-): Promise<CodebaseSearchResponse | null>;

package/types/packages/dev-tools/cli/code-file-utils.unit.d.ts

@@ -1 +0,0 @@
-export {};

package/types/packages/dev-tools/cli/code-tools.d.ts

@@ -1,131 +0,0 @@
-import type {
-	AccessResult,
-	CodeGenPosition,
-	CodeGenTools,
-	CodegenTurn,
-	ContentMessageItemToolResult,
-	FusionConfig,
-	GenerateCompletionStep,
-	Permission,
-	ProjectFile,
-	UserSource,
-	WorkspaceFolder,
-} from "$/ai-utils";
-import type { DevToolsSys } from "../core";
-import { type DevServerOrchestrator } from "./launch/dev-server-orchestrator";
-import type { CodeGenEventEmitter } from "./codegen";
-import type { Credentials } from "./credentials";
-export interface LLMToolCalls {
-	name: CodeGenTools;
-	input: Record<string, any>;
-	id: string;
-	abortController: AbortController;
-}
-export interface ToolResolution {
-	toolResult: string;
-	isError: boolean;
-	title?: string;
-}
-export interface FusionContext {
-	devServerOrchestrator?: DevServerOrchestrator;
-	git: boolean;
-	gitRemote?: string;
-	gitAutoInit?: boolean;
-}
-export interface ToolContext extends Partial<FusionContext> {
-	sys: DevToolsSys;
-	credentials: Credentials;
-	files: ProjectFile[];
-	user: UserSource;
-	position: CodeGenPosition;
-	emitter: CodeGenEventEmitter;
-	fusionConfig: FusionConfig | undefined;
-	canCollapseWorkspace: boolean;
-	signal: AbortSignal;
-	workingDirectory: string;
-	allowedCommands: RegExp[];
-	getAllFiles: (options: {
-		getDotFiles?: boolean;
-		pattern?: string;
-	}) => Promise<string[]>;
-	restore: (options: {
-		location: "before" | "after";
-		predicate: (turn: CodegenTurn | null, index: number) => boolean;
-		dryRun?: boolean;
-		revert?: boolean;
-		forceReplay?: boolean;
-		debug?: string;
-	}) => Promise<{
-		undone: string[] | null;
-		message: string;
-	}>;
-	bashWorkingDirectory: string;
-	filterText: (text: string) => string;
-	resolveWorkspacePath: (
-		path: string,
-		forceWorkspace: boolean,
-	) => {
-		resolvedPath: string;
-		workspaceFolder?: WorkspaceFolder;
-	};
-	absolutePathToWorkspaceUrl: (absolutePath: string) => string | undefined;
-	workspaceFolders: Array<{
-		path: string;
-		name?: string;
-	}>;
-	patchFusionConfig: (patch: Partial<FusionConfig>) => void;
-	passThrough: (
-		toolCall: LLMToolCalls,
-		signal: AbortSignal,
-	) => Promise<ToolResolution>;
-	readFile: (filePath: string) => Promise<string | null>;
-	writeFile: (
-		filePath: string,
-		content: string | Uint8Array,
-	) => Promise<string | null>;
-	deleteFile: (filePath: string) => Promise<string | null>;
-	fileExists: (filePath: string) => Promise<{
-		absolutePath: string | undefined;
-		recommendedPath: string | undefined;
-		workspaceFolder: WorkspaceFolder | undefined;
-		virtual: boolean;
-	}>;
-	listDir: (dirPath: string) => Promise<string[]>;
-	evaluateAccess: (resource: string, permission: Permission) => AccessResult;
-	stat: (filePath: string) => Promise<{
-		isDirectory: () => boolean;
-		isFile: () => boolean;
-		size: number;
-	} | null>;
-}
-export declare function resolveToolCalls(
-	toolContext: ToolContext,
-	toolCalls: LLMToolCalls[],
-	existingToolResults: ContentMessageItemToolResult[] | undefined,
-	onStep: (step: GenerateCompletionStep) => void,
-): Promise<ContentMessageItemToolResult[]>;
-interface RipgrepMatch {
-	path: string;
-	lineNumber: number;
-	lineContent: string;
-}
-interface RipgrepResult {
-	matches: RipgrepMatch[];
-}
-export declare function runRipgrep(
-	sys: DevToolsSys,
-	bashWorkingDirectory: string,
-	pattern: string,
-	includeGlob?: string,
-	excludeGlob?: string,
-): Promise<RipgrepResult>;
-/**
- * Returns true if query is likely a string literal rather than a regex.
- * Returns false otherwise.
- * This is intended to ensure that queries such as "import {" do not get
- * interpreted as invalid regex values by ripgrep.
- * @param query - The query to check
- */
-export declare const isLikelyFixedString: (query: string) => boolean;
-export declare function newAbortError(): Error;
-export {};

package/types/packages/dev-tools/cli/code.d.ts

@@ -1,17 +0,0 @@
-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 function getUserContext(sys: DevToolsSys): Promise<UserContext>;