@builder.io/dev-tools 1.24.0-dev.202602061409.e623db468 → 1.24.0-dev.202602061553.6bec740a7

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

@@ -1,105 +1,74 @@
 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.
  *
@@ -121,52 +90,24 @@ export declare const runCodeGen: (
  * 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,43 +2,23 @@ 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,47 +1,28 @@
 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-indexing/types.d.ts

@@ -15,8 +15,6 @@ export interface TokenTask extends BaseTask {
     type: "token";
     relevantFiles: string[];
     tokens: string[];
-    /** Map of token name to its default value (e.g., "--spacing-1": "4px") */
-    tokenValues?: Record<string, string>;
     hash: string;
 }
 export interface IconTask extends BaseTask {

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

@@ -0,0 +1,17 @@
+import type { DevToolsSys } from "../types";
+import type { CLIArgs } from "./index";
+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;
+}
+export declare const runRepoIndexing: (sys: DevToolsSys, args: CLIArgs) => Promise<void>;

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

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

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

@@ -10,16 +10,14 @@ 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
  */
@@ -27,14 +25,8 @@ 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,7 +15,4 @@ 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>;

package/types/cli/report/figma-report.d.ts

@@ -1,81 +1,54 @@
 import type { FigmaComponentInfo } from "$/ai-utils";
 import type { CLIArgs } from "..";
 import type { DevToolsSys } from "../../core";
-import type {
-	PublishedComponent,
-	PublishedComponentSet,
-} from "@figma/rest-api-spec";
+import type { PublishedComponent, PublishedComponentSet } from "@figma/rest-api-spec";
 type Context = {
-	sys: DevToolsSys;
-	args: CLIArgs;
-	debug: (msg: unknown) => void;
-	figmaAuth: {
-		access_token: string;
-		oauth: boolean;
-	};
+    sys: DevToolsSys;
+    args: CLIArgs;
+    debug: (msg: unknown) => void;
+    figmaAuth: {
+        access_token: string;
+        oauth: boolean;
+    };
 };
 /**
  * A component or component set
  */
 type FigmaTeamComponent = {
-	/** The unique identifier for the component. */
-	key: string;
-	/** The unique identifier of the Figma file that contains the component. */
-	file_key: string;
-	/** The unique identifier of the component node within the Figma file. */
-	node_id: string;
-	/** A URL to a thumbnail image of the component. */
-	thumbnail_url?: string;
-	/** The name of the component. */
-	name: string;
-	/** The description of the component as entered by the publisher. */
-	description: string;
-	/** The component data. */
-	componentData?: FigmaComponentInfo;
-	/** Whether the component is published. */
-	isPublished?: boolean;
+    /** The unique identifier for the component. */
+    key: string;
+    /** The unique identifier of the Figma file that contains the component. */
+    file_key: string;
+    /** The unique identifier of the component node within the Figma file. */
+    node_id: string;
+    /** A URL to a thumbnail image of the component. */
+    thumbnail_url?: string;
+    /** The name of the component. */
+    name: string;
+    /** The description of the component as entered by the publisher. */
+    description: string;
+    /** The component data. */
+    componentData?: FigmaComponentInfo;
+    /** Whether the component is published. */
+    isPublished?: boolean;
 };
 export declare function extractFigmaIds(url: string): {
-	teamId?: string;
-	fileKey?: string;
-	nodeId?: string;
+    teamId?: string;
+    fileKey?: string;
+    nodeId?: string;
 };
-export declare function fetchTeamComponents(
-	context: Context,
-	teamId: string,
-	onProgress: () => void,
-): Promise<PublishedComponent[]>;
-export declare function fetchTeamComponentSets(
-	context: Context,
-	teamId: string,
-	onProgress: () => void,
-): Promise<PublishedComponentSet[]>;
+export declare function fetchTeamComponents(context: Context, teamId: string, onProgress: () => void): Promise<PublishedComponent[]>;
+export declare function fetchTeamComponentSets(context: Context, teamId: string, onProgress: () => void): Promise<PublishedComponentSet[]>;
 /**
  * Returns a list of components and component sets that are present in the file or selection as
  * well as a set of remote keys for components that are referenced but not present.
  */
-export declare function processFileOrSelection(
-	context: Context,
-	fileKey: string,
-	nodeId?: string,
-): Promise<{
-	fileComponents: FigmaTeamComponent[];
-	remoteKeys: Set<string>;
+export declare function processFileOrSelection(context: Context, fileKey: string, nodeId?: string): Promise<{
+    fileComponents: FigmaTeamComponent[];
+    remoteKeys: Set<string>;
 }>;
-export declare function fetchRemoteComponentData(
-	context: Context,
-	remoteKeys: Set<string>,
-): Promise<(FigmaTeamComponent | undefined)[]>;
-export declare function resolveComponentData(
-	context: Context,
-	components: FigmaTeamComponent[],
-): Promise<FigmaTeamComponent[]>;
-export declare function generateComponentReport(
-	component: FigmaTeamComponent,
-	baseDir: string,
-): Promise<void>;
-export declare const runFigmaReport: (
-	sys: DevToolsSys,
-	args: CLIArgs,
-) => Promise<void>;
+export declare function fetchRemoteComponentData(context: Context, remoteKeys: Set<string>): Promise<(FigmaTeamComponent | undefined)[]>;
+export declare function resolveComponentData(context: Context, components: FigmaTeamComponent[]): Promise<FigmaTeamComponent[]>;
+export declare function generateComponentReport(component: FigmaTeamComponent, baseDir: string): Promise<void>;
+export declare const runFigmaReport: (sys: DevToolsSys, args: CLIArgs) => Promise<void>;
 export {};