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

package/types/cli/repo-connect/package-detector.d.ts

@@ -1,11 +1,11 @@
 import type { SetupMiseDependency } from "$/ai-utils";
 export interface PackageVersions {
-    node?: string;
-    npm?: string;
-    pnpm?: string;
-    yarn?: string;
-    bun?: string;
-    deno?: string;
+	node?: string;
+	npm?: string;
+	pnpm?: string;
+	yarn?: string;
+	bun?: string;
+	deno?: string;
 }
 /**
  * Detect versions of installed package managers and runtimes
@@ -14,8 +14,12 @@ export declare function detectPackageVersions(): Promise<PackageVersions>;
 /**
  * Convert package versions to SetupMiseDependency array
  */
-export declare function packagesToSetupDependencies(versions: PackageVersions): SetupMiseDependency[];
+export declare function packagesToSetupDependencies(
+	versions: PackageVersions,
+): SetupMiseDependency[];
 /**
  * Format package versions for display
  */
-export declare function formatPackageVersions(versions: PackageVersions): string;
+export declare function formatPackageVersions(
+	versions: PackageVersions,
+): string;

package/types/cli/repo-connect/repo-connect.d.ts

@@ -3,4 +3,7 @@ import type { CLIArgs } from "../index";
 /**
  * Main connect-repo command handler
  */
-export declare function runRepoConnectCommand(sys: DevToolsSys, args: CLIArgs): Promise<void>;
+export declare function runRepoConnectCommand(
+	sys: DevToolsSys,
+	args: CLIArgs,
+): Promise<void>;

package/types/cli/repo-indexing/component-discovery.d.ts

@@ -1,21 +1,34 @@
 import type { DevToolsSys } from "../../types";
 import type { Credentials } from "../credentials";
-import type { WorkspaceConfiguration, ComponentDocument, PrivacyMode } from "$/ai-utils";
+import type {
+	WorkspaceConfiguration,
+	ComponentDocument,
+	PrivacyMode,
+} from "$/ai-utils";
 import type { ComponentTask } from "./types";
-export declare const discoverComponents: (sys: DevToolsSys, credentials: Credentials, sessionId: string, remoteComponents: ComponentDocument[], opts?: {
-    force?: boolean;
-    designSystemPackage?: string;
-    designSystemVersion?: string;
-    workspaceConfig?: WorkspaceConfiguration;
-    debug?: boolean;
-    specificComponents?: string[];
-    include?: string | string[];
-    exclude?: string | string[];
-    instructions?: string;
-    privacyMode?: PrivacyMode;
-}) => Promise<{
-    numComponentsFound: number;
-    componentsToIndex: ComponentTask[];
-    discoveredComponents: ComponentTask[];
+export declare const discoverComponents: (
+	sys: DevToolsSys,
+	credentials: Credentials,
+	sessionId: string,
+	remoteComponents: ComponentDocument[],
+	opts?: {
+		force?: boolean;
+		designSystemPackage?: string;
+		designSystemVersion?: string;
+		workspaceConfig?: WorkspaceConfiguration;
+		debug?: boolean;
+		specificComponents?: string[];
+		include?: string | string[];
+		exclude?: string | string[];
+		instructions?: string;
+		privacyMode?: PrivacyMode;
+	},
+) => Promise<{
+	numComponentsFound: number;
+	componentsToIndex: ComponentTask[];
+	discoveredComponents: ComponentTask[];
 }>;
-export declare const computeHash: (sys: DevToolsSys, files: string[]) => Promise<string>;
+export declare const computeHash: (
+	sys: DevToolsSys,
+	files: string[],
+) => Promise<string>;

package/types/cli/repo-indexing/icons.d.ts

@@ -1,27 +1,39 @@
 import type { DevToolsSys } from "../../types";
 import type { Credentials } from "../credentials";
 import type { WorkspaceConfiguration, PrivacyMode } from "$/ai-utils";
-export declare const discoverIcons: (sys: DevToolsSys, credentials: Credentials, sessionId: string, opts?: {
-    designSystemPackage?: string;
-    workspaceConfig?: WorkspaceConfiguration;
-    debug?: boolean;
-    include?: string | string[];
-    exclude?: string | string[];
-    instructions?: string;
-    privacyMode?: PrivacyMode;
-}) => Promise<{
-    icons: string[];
-    usage: string;
-    hash: string | undefined;
-} | undefined>;
-export declare const processIcons: (credentials: Credentials, iconDiscovery: {
-    icons: string[];
-    usage: string;
-    hash?: string;
-}, opts: {
-    designSystemId: string;
-    sessionId: string;
-    debug?: boolean;
-    previousHash?: string | null;
-    force?: boolean;
-}) => Promise<boolean>;
+export declare const discoverIcons: (
+	sys: DevToolsSys,
+	credentials: Credentials,
+	sessionId: string,
+	opts?: {
+		designSystemPackage?: string;
+		workspaceConfig?: WorkspaceConfiguration;
+		debug?: boolean;
+		include?: string | string[];
+		exclude?: string | string[];
+		instructions?: string;
+		privacyMode?: PrivacyMode;
+	},
+) => Promise<
+	| {
+			icons: string[];
+			usage: string;
+			hash: string | undefined;
+	  }
+	| undefined
+>;
+export declare const processIcons: (
+	credentials: Credentials,
+	iconDiscovery: {
+		icons: string[];
+		usage: string;
+		hash?: string;
+	},
+	opts: {
+		designSystemId: string;
+		sessionId: string;
+		debug?: boolean;
+		previousHash?: string | null;
+		force?: boolean;
+	},
+) => Promise<boolean>;

package/types/cli/repo-indexing/installation.d.ts

@@ -1,17 +1,25 @@
 import type { DevToolsSys } from "../../types";
 import type { Credentials } from "../credentials";
 import type { WorkspaceConfiguration, PrivacyMode } from "$/ai-utils";
-export declare const discoverInstallation: (sys: DevToolsSys, credentials: Credentials, sessionId: string, opts: {
-    designSystemId: string;
-    designSystemPackage?: string;
-    designSystemVersion?: string;
-    workspaceConfig?: WorkspaceConfiguration;
-    debug?: boolean;
-    include?: string | string[];
-    exclude?: string | string[];
-    instructions?: string;
-    privacyMode?: PrivacyMode;
-}) => Promise<{
-    hash: string;
-    relevantFiles: string[];
-} | undefined>;
+export declare const discoverInstallation: (
+	sys: DevToolsSys,
+	credentials: Credentials,
+	sessionId: string,
+	opts: {
+		designSystemId: string;
+		designSystemPackage?: string;
+		designSystemVersion?: string;
+		workspaceConfig?: WorkspaceConfiguration;
+		debug?: boolean;
+		include?: string | string[];
+		exclude?: string | string[];
+		instructions?: string;
+		privacyMode?: PrivacyMode;
+	},
+) => Promise<
+	| {
+			hash: string;
+			relevantFiles: string[];
+	  }
+	| undefined
+>;

package/types/cli/repo-indexing/repo-indexing-utils.d.ts

@@ -1,74 +1,105 @@
 import type { DevToolsSys } from "../../core";
 import { type Credentials } from "../credentials";
-import type { DesignSystem, GenerateUserMessage, WorkspaceConfiguration, UpdateDesignSystemInput, DesignSystemScope, DisplayDesignSystem, IndexDocumentV1, AclPolicy, PrivacyMode } from "$/ai-utils";
+import type {
+	DesignSystem,
+	GenerateUserMessage,
+	WorkspaceConfiguration,
+	UpdateDesignSystemInput,
+	DesignSystemScope,
+	DisplayDesignSystem,
+	IndexDocumentV1,
+	AclPolicy,
+	PrivacyMode,
+} from "$/ai-utils";
 export declare const AGENT_FILE = "AGENTS.md";
 export declare const ICONS_FILE = "icons.mdx";
 export declare const TOKENS_FILE = "tokens.mdx";
 export declare const INSTALLATION_FILE = "installation.md";
 export declare const REPO_INDEXING_FOLDER = "repo-indexing";
 export interface UserSettings {
-    isAdminInOrganization: boolean;
-    email: string;
+	isAdminInOrganization: boolean;
+	email: string;
 }
 interface GetAllDesignSystemsOpts {
-    /**
-     * If true, only design systems that the user has permission to edit will be
-     * returned. If false, all design systems that the user has permission to edit
-     * as well as design systems that the user has permission to read but not edit
-     * will be returned. Defaults to false.
-     */
-    onlyEditAccess?: boolean;
-    /**
-     * If true, design systems that are scoped to the global space will be included.
-     * Defaults to false.
-     */
-    includeGlobalScopeDesignSystems?: boolean;
-    /**
-     * If true, the # of component docs in each design system will also be returned.
-     * Defaults to false.
-     */
-    includeDocumentCount?: boolean;
+	/**
+	 * If true, only design systems that the user has permission to edit will be
+	 * returned. If false, all design systems that the user has permission to edit
+	 * as well as design systems that the user has permission to read but not edit
+	 * will be returned. Defaults to false.
+	 */
+	onlyEditAccess?: boolean;
+	/**
+	 * If true, design systems that are scoped to the global space will be included.
+	 * Defaults to false.
+	 */
+	includeGlobalScopeDesignSystems?: boolean;
+	/**
+	 * If true, the # of component docs in each design system will also be returned.
+	 * Defaults to false.
+	 */
+	includeDocumentCount?: boolean;
 }
-export declare const promptForDesignSystemScope: (credentials: Credentials, userSettings: UserSettings | null, selectedScope?: DesignSystemScope) => Promise<DesignSystemScope | undefined>;
-export declare const parseDesignSystem: (sys: DevToolsSys, designSystemPackage?: string) => Promise<{
-    name: any;
-    version: string | undefined;
+export declare const promptForDesignSystemScope: (
+	credentials: Credentials,
+	userSettings: UserSettings | null,
+	selectedScope?: DesignSystemScope,
+) => Promise<DesignSystemScope | undefined>;
+export declare const parseDesignSystem: (
+	sys: DevToolsSys,
+	designSystemPackage?: string,
+) => Promise<{
+	name: any;
+	version: string | undefined;
 }>;
-export declare const storeComponentDocs: (credentials: Credentials, body: IndexDocumentV1, debug?: boolean) => Promise<any>;
-export declare const runCodeGen: (sys: DevToolsSys, credentials: Credentials, sessionId: string, message: GenerateUserMessage, debug?: boolean, designSystemPackage?: string, workspaceConfig?: WorkspaceConfiguration, opts?: {
-    tags?: object;
-    maxTokens?: number;
-    retriesAllowed?: number;
-    /**
-     * What kind of file to expect from the LLM.
-     * `'tool'`: The LLM will use the Write tool to output the file. We will intercept that
-     * and keep the file contents in-memory. File is not written to disk.
-     * `string`: The LLM will write the file directly to the file system. We will read the
-     * contents into memory and then delete the file from the file system. This is useful
-     * for writing large files that would otherwise consume a lot of tokens.
-     */
-    expectFile?: "tool" | string;
-    /**
-     * Glob pattern(s) to include for access control.
-     * When specified, only these patterns will be accessible by default.
-     * Can be a single string or array of strings.
-     */
-    include?: string | string[];
-    /**
-     * Glob pattern(s) to exclude for access control.
-     * These patterns will be denied access even if included.
-     * Can be a single string or array of strings.
-     */
-    exclude?: string | string[];
-    /**
-     * Extra instructions to be taken into account during repo indexing.
-     */
-    instructions?: string;
-    /**
-     * Privacy mode settings for encryption key handling.
-     */
-    privacyMode?: PrivacyMode;
-}, metadata?: any) => Promise<string>;
+export declare const storeComponentDocs: (
+	credentials: Credentials,
+	body: IndexDocumentV1,
+	debug?: boolean,
+) => Promise<any>;
+export declare const runCodeGen: (
+	sys: DevToolsSys,
+	credentials: Credentials,
+	sessionId: string,
+	message: GenerateUserMessage,
+	debug?: boolean,
+	designSystemPackage?: string,
+	workspaceConfig?: WorkspaceConfiguration,
+	opts?: {
+		tags?: object;
+		maxTokens?: number;
+		retriesAllowed?: number;
+		/**
+		 * What kind of file to expect from the LLM.
+		 * `'tool'`: The LLM will use the Write tool to output the file. We will intercept that
+		 * and keep the file contents in-memory. File is not written to disk.
+		 * `string`: The LLM will write the file directly to the file system. We will read the
+		 * contents into memory and then delete the file from the file system. This is useful
+		 * for writing large files that would otherwise consume a lot of tokens.
+		 */
+		expectFile?: "tool" | string;
+		/**
+		 * Glob pattern(s) to include for access control.
+		 * When specified, only these patterns will be accessible by default.
+		 * Can be a single string or array of strings.
+		 */
+		include?: string | string[];
+		/**
+		 * Glob pattern(s) to exclude for access control.
+		 * These patterns will be denied access even if included.
+		 * Can be a single string or array of strings.
+		 */
+		exclude?: string | string[];
+		/**
+		 * Extra instructions to be taken into account during repo indexing.
+		 */
+		instructions?: string;
+		/**
+		 * Privacy mode settings for encryption key handling.
+		 */
+		privacyMode?: PrivacyMode;
+	},
+	metadata?: any,
+) => Promise<string>;
 /**
  * Generates an ACL policy for repo indexing based on include/exclude patterns.
  *
@@ -90,24 +121,52 @@ export declare const runCodeGen: (sys: DevToolsSys, credentials: Credentials, se
  * const policy2 = generateRepoIndexingAclPolicy("src/**\/*", "dist/**");
  * ```
  */
-export declare const generateRepoIndexingAclPolicy: (include?: string | string[], exclude?: string | string[]) => AclPolicy;
-export declare function getAllDesignSystems(credentials: Credentials, opts: {
-    includeDocumentCount: true;
-} & Omit<GetAllDesignSystemsOpts, "includeDocumentCount">): Promise<DisplayDesignSystem[]>;
-export declare function getAllDesignSystems(credentials: Credentials, opts?: GetAllDesignSystemsOpts): Promise<DesignSystem[]>;
-export declare const getDesignSystemsByScope: (scope: DesignSystemScope, designSystems: DesignSystem[]) => DesignSystem[];
-export declare const getDesignSystemByName: (designSystemName: string, designSystems: DesignSystem[]) => DesignSystem | null;
-export declare const getDesignSystemByNameAndScope: (credentials: Credentials, designSystemName: string, scope: DesignSystemScope, designSystems: DesignSystem[]) => DesignSystem | null;
-export declare const addDesignSystem: (credentials: Credentials, body: {
-    designSystemName: string;
-    designSystemVersion?: string;
-    designSystemPackage?: string;
-    status: string;
-    scope: DesignSystemScope;
-    gitOriginUrl: string | undefined;
-    gitRelativePath: string | undefined;
-    cliArgs: string[];
-}) => Promise<any>;
-export declare const updateDesignSystem: (credentials: Credentials, body: UpdateDesignSystemInput) => Promise<any>;
-export declare const checkRepoIndexingFolder: (sys: DevToolsSys) => Promise<boolean>;
+export declare const generateRepoIndexingAclPolicy: (
+	include?: string | string[],
+	exclude?: string | string[],
+) => AclPolicy;
+export declare function getAllDesignSystems(
+	credentials: Credentials,
+	opts: {
+		includeDocumentCount: true;
+	} & Omit<GetAllDesignSystemsOpts, "includeDocumentCount">,
+): Promise<DisplayDesignSystem[]>;
+export declare function getAllDesignSystems(
+	credentials: Credentials,
+	opts?: GetAllDesignSystemsOpts,
+): Promise<DesignSystem[]>;
+export declare const getDesignSystemsByScope: (
+	scope: DesignSystemScope,
+	designSystems: DesignSystem[],
+) => DesignSystem[];
+export declare const getDesignSystemByName: (
+	designSystemName: string,
+	designSystems: DesignSystem[],
+) => DesignSystem | null;
+export declare const getDesignSystemByNameAndScope: (
+	credentials: Credentials,
+	designSystemName: string,
+	scope: DesignSystemScope,
+	designSystems: DesignSystem[],
+) => DesignSystem | null;
+export declare const addDesignSystem: (
+	credentials: Credentials,
+	body: {
+		designSystemName: string;
+		designSystemVersion?: string;
+		designSystemPackage?: string;
+		status: string;
+		scope: DesignSystemScope;
+		gitOriginUrl: string | undefined;
+		gitRelativePath: string | undefined;
+		cliArgs: string[];
+	},
+) => Promise<any>;
+export declare const updateDesignSystem: (
+	credentials: Credentials,
+	body: UpdateDesignSystemInput,
+) => Promise<any>;
+export declare const checkRepoIndexingFolder: (
+	sys: DevToolsSys,
+) => Promise<boolean>;
 export {};

package/types/cli/repo-indexing/repo-indexing.d.ts

@@ -2,23 +2,43 @@ import type { DevToolsSys } from "../../types";
 import type { CLIArgs } from "../index";
 import { type Credentials } from "../credentials";
 import type { ComponentTask, TokenTask } from "./types";
-export declare const displayComponentLibrarySummary: (components: ComponentTask[], indexedComponents: ComponentTask[], startTime: number, failedComponents: string[] | undefined, isForce: boolean | undefined, designSystemName: string, designSystemId?: string, numIconsIndexed?: number, tokenGroupsFound?: TokenTask[], tokenGroupsToIndex?: TokenTask[], tokenGroupsFailed?: string[]) => void;
+export declare const displayComponentLibrarySummary: (
+	components: ComponentTask[],
+	indexedComponents: ComponentTask[],
+	startTime: number,
+	failedComponents: string[] | undefined,
+	isForce: boolean | undefined,
+	designSystemName: string,
+	designSystemId?: string,
+	numIconsIndexed?: number,
+	tokenGroupsFound?: TokenTask[],
+	tokenGroupsToIndex?: TokenTask[],
+	tokenGroupsFailed?: string[],
+) => void;
 export interface RepoIndexingDoc {
-    name: string;
-    content: string | {
-        name: string;
-        description: string;
-        components: string[];
-        relevantFiles: string[];
-    }[];
-    createdDate: string;
-    description: string;
-    id: string;
-    ownerId: string;
-    userId: string;
+	name: string;
+	content:
+		| string
+		| {
+				name: string;
+				description: string;
+				components: string[];
+				relevantFiles: string[];
+		  }[];
+	createdDate: string;
+	description: string;
+	id: string;
+	ownerId: string;
+	userId: string;
 }
-export declare const runRepoIndexing: (sys: DevToolsSys, args: CLIArgs) => Promise<void>;
-export declare const isFeatureAllowed: (credentials: Credentials, debug?: boolean) => Promise<{
-    isAllowed: boolean;
-    reason?: string;
+export declare const runRepoIndexing: (
+	sys: DevToolsSys,
+	args: CLIArgs,
+) => Promise<void>;
+export declare const isFeatureAllowed: (
+	credentials: Credentials,
+	debug?: boolean,
+) => Promise<{
+	isAllowed: boolean;
+	reason?: string;
 }>;

package/types/cli/repo-indexing/repo-indexing.mock.d.ts

@@ -1,5 +1,5 @@
 export declare const mockDeps: {
-    getStoredComponentDocs: () => Promise<never[]>;
-    storeComponentDocs: () => Promise<{}>;
-    runCodeGen: () => Promise<string>;
+	getStoredComponentDocs: () => Promise<never[]>;
+	storeComponentDocs: () => Promise<{}>;
+	runCodeGen: () => Promise<string>;
 };

package/types/cli/repo-indexing/tokens.d.ts

@@ -1,28 +1,47 @@
 import type { DevToolsSys } from "../../types";
 import type { TokenTask } from "./types";
 import type { Credentials } from "../credentials";
-import type { WorkspaceConfiguration, TokenDocument, PrivacyMode } from "$/ai-utils";
-export declare const discoverTokens: (sys: DevToolsSys, credentials: Credentials, sessionId: string, remoteTokens: TokenDocument[], opts?: {
-    force?: boolean;
-    designSystemPackage?: string;
-    workspaceConfig?: WorkspaceConfiguration;
-    debug?: boolean;
-    include?: string | string[];
-    exclude?: string | string[];
-    instructions?: string;
-    privacyMode?: PrivacyMode;
-}) => Promise<{
-    tokenGroupsToIndex: TokenTask[];
-    discoveredTokenGroups: TokenTask[];
-} | undefined>;
-export declare const processTokens: (sys: DevToolsSys, credentials: Credentials, sessionId: string, group: TokenTask, opts: {
-    designSystemId: string;
-    designSystemPackage?: string;
-    designSystemVersion?: string;
-    debug?: boolean;
-    workspaceConfig?: WorkspaceConfiguration;
-    include?: string | string[];
-    exclude?: string | string[];
-    instructions?: string;
-    privacyMode?: PrivacyMode;
-}) => Promise<void>;
+import type {
+	WorkspaceConfiguration,
+	TokenDocument,
+	PrivacyMode,
+} from "$/ai-utils";
+export declare const discoverTokens: (
+	sys: DevToolsSys,
+	credentials: Credentials,
+	sessionId: string,
+	remoteTokens: TokenDocument[],
+	opts?: {
+		force?: boolean;
+		designSystemPackage?: string;
+		workspaceConfig?: WorkspaceConfiguration;
+		debug?: boolean;
+		include?: string | string[];
+		exclude?: string | string[];
+		instructions?: string;
+		privacyMode?: PrivacyMode;
+	},
+) => Promise<
+	| {
+			tokenGroupsToIndex: TokenTask[];
+			discoveredTokenGroups: TokenTask[];
+	  }
+	| undefined
+>;
+export declare const processTokens: (
+	sys: DevToolsSys,
+	credentials: Credentials,
+	sessionId: string,
+	group: TokenTask,
+	opts: {
+		designSystemId: string;
+		designSystemPackage?: string;
+		designSystemVersion?: string;
+		debug?: boolean;
+		workspaceConfig?: WorkspaceConfiguration;
+		include?: string | string[];
+		exclude?: string | string[];
+		instructions?: string;
+		privacyMode?: PrivacyMode;
+	},
+) => Promise<void>;

package/types/cli/repo-metrics-utils.d.ts

@@ -10,14 +10,16 @@ export declare function safeReadFile(filePath: string): string | null;
  * Package manager information
  */
 export interface PackageManagerInfo {
-    manager: "npm" | "yarn" | "pnpm" | "bun";
-    setupCommand: string;
+	manager: "npm" | "yarn" | "pnpm" | "bun";
+	setupCommand: string;
 }
 /**
  * Detect the package manager at the root level based on lock files
  * Returns the specific package manager command for setup
  */
-export declare function detectRootPackageManager(files: string[]): PackageManagerInfo | null;
+export declare function detectRootPackageManager(
+	files: string[],
+): PackageManagerInfo | null;
 /**
  * Check if a file exists at the root level
  */
@@ -25,8 +27,14 @@ export declare function hasRootFile(files: string[], fileName: string): boolean;
 /**
  * Check if any file matches a pattern at the root level
  */
-export declare function hasRootFileMatching(files: string[], predicate: (fileName: string) => boolean): boolean;
+export declare function hasRootFileMatching(
+	files: string[],
+	predicate: (fileName: string) => boolean,
+): boolean;
 /**
  * Check if a directory exists at the root level
  */
-export declare function hasRootDirectory(files: string[], directoryName: string): boolean;
+export declare function hasRootDirectory(
+	files: string[],
+	directoryName: string,
+): boolean;

package/types/cli/repo-metrics.d.ts

@@ -15,4 +15,7 @@ export declare function isExactVersion(version: string | undefined): boolean;
  * @param basePath - Absolute path to the repository root
  * @param rootPath - Relative path within the repository to analyze (default: "/" for entire repo)
  */
-export declare function collectRepoMetrics(sys: DevToolsSys, basePath: string): Promise<RepoMetrics>;
+export declare function collectRepoMetrics(
+	sys: DevToolsSys,
+	basePath: string,
+): Promise<RepoMetrics>;