@builder.io/dev-tools 1.17.24-dev.202511131347.7305ffc47 → 1.17.24-dev.202511131623.844feace3

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

@@ -1,26 +1,23 @@
 import type { DevToolsSys } from "../../types";
 import type { FileOverride } from "$/ai-utils";
 export interface CollectedFiles {
-	projectNpmrc?: {
-		path: string;
-		content: string;
-	};
-	userNpmrc?: {
-		path: string;
-		content: string;
-	};
-	etcHosts?: {
-		path: string;
-		content: string;
-	};
+    projectNpmrc?: {
+        path: string;
+        content: string;
+    };
+    userNpmrc?: {
+        path: string;
+        content: string;
+    };
+    etcHosts?: {
+        path: string;
+        content: string;
+    };
 }
 /**
  * Collect configuration files from the project and system
  */
-export declare function collectConfigFiles(
-	sys: DevToolsSys,
-	gitRoot: string,
-): Promise<CollectedFiles>;
+export declare function collectConfigFiles(sys: DevToolsSys, gitRoot: string): Promise<CollectedFiles>;
 /**
  * Convert collected files to FileOverride array with proper path conventions
  *
@@ -29,9 +26,7 @@ export declare function collectConfigFiles(
  * - ~/ prefix = relative to home directory
  * - absolute paths = only for well-known system files
  */
-export declare function filesToFileOverrides(
-	collected: CollectedFiles,
-): FileOverride[];
+export declare function filesToFileOverrides(collected: CollectedFiles): FileOverride[];
 /**
  * Format collected files summary
  */
@@ -39,6 +34,4 @@ export declare function formatFilesSummary(collected: CollectedFiles): string[];
 /**
  * Present multiselect UI for file overrides
  */
-export declare function selectFileOverrides(
-	collected: CollectedFiles,
-): Promise<FileOverride[] | null>;
+export declare function selectFileOverrides(collected: CollectedFiles): Promise<FileOverride[] | null>;

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

@@ -1,15 +1,15 @@
 import type { DevToolsSys } from "../../types";
 export interface GitInfo {
-	gitRoot: string;
-	recommendedRoot?: string;
-	originUrl: string;
-	repoProvider: "github" | "gitlab" | "bitbucket" | "azure" | "custom";
-	repoProtocol: "https" | "ssh";
-	repoFullName: string;
-	repoOwner: string;
-	repoName: string;
-	isPrivate: boolean;
-	projectName: string;
+    gitRoot: string;
+    recommendedRoot?: string;
+    originUrl: string;
+    repoProvider: "github" | "gitlab" | "bitbucket" | "azure" | "custom";
+    repoProtocol: "https" | "ssh";
+    repoFullName: string;
+    repoOwner: string;
+    repoName: string;
+    isPrivate: boolean;
+    projectName: string;
 }
 /**
  * Detect git repository information

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

@@ -1,13 +1,10 @@
 export interface InstallResult {
-	success: boolean;
-	command: string;
-	exitCode?: number;
-	skipped: boolean;
+    success: boolean;
+    command: string;
+    exitCode?: number;
+    skipped: boolean;
 }
 /**
  * Run install command with live output and retry logic
  */
-export declare function runInstallCommand(
-	cwd: string,
-	initialCommand?: string,
-): Promise<InstallResult>;
+export declare function runInstallCommand(cwd: string, initialCommand?: string): Promise<InstallResult>;

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,12 +14,8 @@ 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,7 +3,4 @@ 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

@@ -2,25 +2,16 @@ import type { DevToolsSys } from "../../types";
 import type { Credentials } from "../credentials";
 import type { WorkspaceConfiguration } from "$/ai-utils";
 import type { ComponentDocument, 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[];
-	},
-) => 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[];
+}) => 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

@@ -9,7 +9,7 @@ export declare const discoverIcons: (sys: DevToolsSys, credentials: Credentials,
     icons: string[];
     usage: string;
     hash: string | undefined;
-} | undefined>;
+}>;
 export declare const processIcons: (credentials: Credentials, iconDiscovery: {
     icons: string[];
     usage: string;

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

@@ -5,13 +5,12 @@ import type { IndexDocument } from "./types";
 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.mdx";
 export declare const REPO_INDEXING_FOLDER = "repo-indexing";
 export interface UserSettings {
     isAdminInOrganization: boolean;
     email: string;
 }
-export declare const promptForDesignSystemScope: (credentials: Credentials, userSettings: UserSettings | null, selectedScope?: DesignSystemScope) => Promise<DesignSystemScope | undefined>;
+export declare const promptForDesignSystemScope: (credentials: Credentials, userSettings: UserSettings | null) => Promise<DesignSystemScope | undefined>;
 export declare const parseDesignSystem: (sys: DevToolsSys, designSystemPackage?: string) => Promise<{
     name: any;
     version: string | undefined;

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/types.d.ts

@@ -1,4 +1,4 @@
-export type IndexDocument = ComponentDocument | TokenDocument | IconDocument | AgentDocument | InstallationDocument;
+export type IndexDocument = ComponentDocument | TokenDocument | IconDocument | AgentDocument;
 export interface DocumentBase {
     id?: string;
     name: string;
@@ -14,7 +14,6 @@ export declare const isAgentDocument: (doc: IndexDocument) => doc is AgentDocume
 export declare const isIconDocument: (doc: IndexDocument) => doc is IconDocument;
 export declare const isTokenDocument: (doc: IndexDocument) => doc is TokenDocument;
 export declare const isComponentDocument: (doc: IndexDocument) => doc is ComponentDocument;
-export declare const isInstallationDocument: (doc: IndexDocument) => doc is InstallationDocument;
 export interface ComponentDocument extends DocumentBase {
     type: "component";
     relatedComponents: string[];
@@ -33,10 +32,6 @@ export interface IconDocument extends DocumentBase {
 export interface AgentDocument extends DocumentBase {
     type: "agent";
 }
-export interface InstallationDocument extends DocumentBase {
-    type: "installation";
-    hash: string;
-}
 interface BaseTask {
     name: string;
 }

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 {};

package/types/cli/server-ws.d.ts

@@ -3,56 +3,48 @@ import type { IncomingMessage } from "node:http";
 import type { ServerOptions } from "ws";
 import type { WebSocket } from "ws";
 export type SocketRequest = {
-	id: number;
-	jsonrpc: string;
-	method: string;
-	params: any;
+    id: number;
+    jsonrpc: string;
+    method: string;
+    params: any;
 };
 export type SocketResponse<T = any> = {
-	id?: number | null;
-	jsonrpc: string;
-	result?: T;
-	notification?: string;
-	params?: any;
-	error?: {
-		code: number;
-		message: string;
-		data?: any;
-	};
+    id?: number | null;
+    jsonrpc: string;
+    result?: T;
+    notification?: string;
+    params?: any;
+    error?: {
+        code: number;
+        message: string;
+        data?: any;
+    };
 };
 export type SocketSendOptions = {
-	timeout?: number;
+    timeout?: number;
 };
 export type SocketQueue = {
-	type: "request" | "notification";
-	result?: SocketResponse["result"];
-	error?: SocketResponse["error"];
+    type: "request" | "notification";
+    result?: SocketResponse["result"];
+    error?: SocketResponse["error"];
 };
 type RegisterFn<T = any> = (params: T, socketId: string) => Promise<any> | any;
 type SocketEvents = {
-	listening: () => Promise<void> | void;
-	connection: (socket: WebSocket, socketId: string) => Promise<void> | void;
-	disconnection: (socketId: string) => Promise<void> | void;
-	error: (error: Error) => Promise<void> | void;
-	"socket-error": (socketId: string, error: Error) => Promise<void> | void;
-	close: () => Promise<void> | void;
+    listening: () => Promise<void> | void;
+    connection: (socket: WebSocket, socketId: string) => Promise<void> | void;
+    disconnection: (socketId: string) => Promise<void> | void;
+    error: (error: Error) => Promise<void> | void;
+    "socket-error": (socketId: string, error: Error) => Promise<void> | void;
+    close: () => Promise<void> | void;
 };
 export declare function RPCWebSocketServer(opts: ServerOptions): {
-	on: <EventKey extends keyof SocketEvents>(
-		event: EventKey,
-		cb: SocketEvents[EventKey],
-	) => void;
-	event: (e: string) => void;
-	handleUpgrade: (
-		req: IncomingMessage,
-		socket: Duplex,
-		upgradeHead: Buffer,
-		callback?: (client: WebSocket, request: IncomingMessage) => void,
-	) => Promise<void>;
-	clients: () => Map<string, WebSocket>;
-	register: <T = any>(method: string, fn: RegisterFn<T>) => void;
-	emit: (name: string, ...params: any[]) => void;
-	notify: (name: string, socketId: string, ...params: any[]) => void;
-	close: () => Promise<unknown>;
+    on: <EventKey extends keyof SocketEvents>(event: EventKey, cb: SocketEvents[EventKey]) => void;
+    event: (e: string) => void;
+    handleUpgrade: (req: IncomingMessage, socket: Duplex, upgradeHead: Buffer, callback?: (client: WebSocket, request: IncomingMessage) => void) => Promise<void>;
+    clients: () => Map<string, WebSocket>;
+    register: <T = any>(method: string, fn: RegisterFn<T>) => void;
+    emit: (name: string, ...params: any[]) => void;
+    notify: (name: string, socketId: string, ...params: any[]) => void;
+    close: () => Promise<unknown>;
 };
 export {};

package/types/cli/spinner.d.ts

@@ -1,6 +1,6 @@
 export declare const spinner: () => {
-	start: (msg?: string) => void;
-	stop: (msg?: string, code?: number) => void;
-	message: (msg?: string) => void;
-	extra: (msg?: string) => void;
+    start: (msg?: string) => void;
+    stop: (msg?: string, code?: number) => void;
+    message: (msg?: string) => void;
+    extra: (msg?: string) => void;
 };

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

@@ -1,45 +1,22 @@
 import type { AddCliOptions, DevToolsSys, FileNode, SyncInfo } from "../types";
 export declare function extractSignatureInfo(content: string): {
-	contentId?: string;
-	sessionKey?: string;
-	snippetId?: string;
+    contentId?: string;
+    sessionKey?: string;
+    snippetId?: string;
 };
 export interface GetAllProjectFilesOptions {
-	sys?: DevToolsSys;
-	basePath: string;
-	globPattern?: string | string[];
-	extraIgnorePatterns?: string[];
-	dot?: boolean;
-	deep?: number;
-	gitignore?: boolean;
+    sys?: DevToolsSys;
+    basePath: string;
+    globPattern?: string | string[];
+    extraIgnorePatterns?: string[];
+    dot?: boolean;
+    deep?: number;
+    gitignore?: boolean;
 }
-export declare function getAllProjectFiles({
-	basePath,
-	globPattern,
-	extraIgnorePatterns,
-	dot,
-	deep,
-	gitignore,
-	sys,
-}: GetAllProjectFilesOptions): Promise<string[]>;
-export declare function findBuilderFiles(
-	basePath: string,
-	targetContentId: string,
-	targetSessionKey: string,
-): Promise<FileNode[]>;
+export declare function getAllProjectFiles({ basePath, globPattern, extraIgnorePatterns, dot, deep, gitignore, sys, }: GetAllProjectFilesOptions): Promise<string[]>;
+export declare function findBuilderFiles(basePath: string, targetContentId: string, targetSessionKey: string): Promise<FileNode[]>;
 export declare function filterNonImportantFiles(files: string[]): string[];
-export declare function getIgnorePatterns(
-	basePath: string,
-): (path: string) => boolean;
-export declare function watchDirectory(
-	basePath: string,
-	syncInfo: SyncInfo,
-	onChange: (updatedSyncInfo: SyncInfo) => void,
-): () => Promise<void>;
-export declare function setupSyncServer(
-	sys: DevToolsSys,
-	initialSyncInfo?: SyncInfo,
-): Promise<void>;
-export declare function syncCommand(
-	opts: AddCliOptions,
-): Promise<SyncInfo | undefined>;
+export declare function getIgnorePatterns(basePath: string): (path: string) => boolean;
+export declare function watchDirectory(basePath: string, syncInfo: SyncInfo, onChange: (updatedSyncInfo: SyncInfo) => void): () => Promise<void>;
+export declare function setupSyncServer(sys: DevToolsSys, initialSyncInfo?: SyncInfo): Promise<void>;
+export declare function syncCommand(opts: AddCliOptions): Promise<SyncInfo | undefined>;

package/types/cli/track.d.ts

@@ -1,8 +1,5 @@
 import * as Amplitude from "@amplitude/analytics-node";
 import * as Sentry from "@sentry/node";
 export declare function initTracking(verbose: boolean): Promise<typeof Sentry>;
-export declare function track(
-	eventName: string,
-	options: Record<string, any>,
-): Promise<Amplitude.Types.Result>;
+export declare function track(eventName: string, options: Record<string, any>): Promise<Amplitude.Types.Result>;
 export declare function setUserId(id: string): Promise<void>;

package/types/cli/utils/component-group-mdx-prompt.d.ts

@@ -1,2 +1 @@
-export declare const COMPONENT_GROUP_MDX_PROMPT =
-	"# Component Documentation Generation\n\n## Objective\nGenerate comprehensive MDX documentation for a specific component, analyzing their interfaces, relationships, and usage patterns using the relevant files provided in the input.\n\n## Instructions\n\n### 1. Component Analysis\nFor the given component, analyze each relevant file by:\n- **Interdependency mapping** - Document how components depend on each other\n- **Interface examination** - Extract and document all props, their types, and descriptions\n- **Context analysis** - Identify shared state, contexts, or communication patterns\n- **Compositional patterns** - Document required parent-child relationships\n- **Usage pattern analysis** - Identify how components work together\n- **Example extraction** - Find real usage examples from the codebase\n\n{{COMPONENT_NAME}} has the following related components: {{RELATED_COMPONENTS}}\nThe following files are associated with {{COMPONENT_NAME}}: {{FILE_LIST}}\n\n### 2. Documentation Structure\nCreate comprehensive documentation covering:\n- **Component rationale** - Why these components work together and when to use them\n- **Architectural overview** - How the components form a cohesive system\n- **Component interfaces** - Detailed prop documentation with interdependencies\n- **Composition patterns** - Required and optional usage combinations\n- **Integration examples** - Real-world scenarios showing the component in action\n- **Best practices** - Recommended usage patterns and guidelines\n\n## Required Output Format\n\nGenerate an MDX file with this structure:\n\n```mdx\n---\n# {{COMPONENT_NAME}}\n\n## Overview\n\n### Purpose\n{{COMPONENT_DESCRIPTION}}\n\n### When to Use\n[Expand on the use cases mentioned in the description - be specific about scenarios, user needs, and implementation contexts]\n\n### Architecture\n[Explain the architectural pattern based on coupling strength:]\n- **Critical/Strong Coupling**: Describe the required relationships, shared context, or compositional hierarchy\n- **Moderate Coupling**: Explain how components enhance each other\n- **No Coupling**: Note that this is a standalone component\n\n### Component Interdependencies\n[Map out component relationships - only for components with coupling:]\n- Required parent-child relationships\n- Shared context dependencies  \n- Communication patterns between components\n- Related components\n\n## API\n**Types**: Interfaces related to the component including all props, methods, or children along with descriptions.\n**Dependencies:** Other components that must be used\n**Provides:** Context/state this component provides to children. Only required for coupled components.\n\n## Usage Examples\nInclude examples that show how to fully use the component. At a minimum, you must include the following examples:\n\n- Basic usage including how to import the component if applicable\n- Usage with any dependency components\n- Variations with conditional rendering, different prop combinations, etc\n\n## Component Relationships {Only for coupled components}\n\n### Data Flow\n[Explain how data flows between the component and related components}\n\n### Context Sharing\n[Document shared contexts, providers, or state management]\n\n### Event Handling\n[Describe how events bubble up or propagate between components]\n\n## Best Practices\n\n### Usage Guidelines\n- [Specific recommendation based on component purpose and use cases]\n- [Another recommendation focusing on accessibility or performance]\n- [Usage pattern guidance based on the component's architecture]\n\n### Accessibility {When relevant}\n- [ARIA relationships between components]\n- [Keyboard navigation patterns]\n- [Screen reader considerations]\n\n### Performance {When relevant}\n- [Optimization recommendations]\n- [State management best practices]\n- [Rendering performance considerations]\n\n## Common Patterns {Expand based on component functionality}\n\n### Pattern 1: [Specific Pattern Name]\n```tsx\n// Example showing a specific usage pattern\n// Include comments explaining why this pattern is recommended\n```\n\n### Pattern 2: [Another Pattern Name]\n```tsx\n// Another common pattern with explanation\n```\n\n```\n\n## File Generation Requirements\n\n**File Naming:**\n- Use kebab-case derived from component name: `{{COMPONENT_NAME_KEBAB}}.mdx`\n- Place in `repo-indexing/` folder\n- Example: `repo-indexing/{{COMPONENT_NAME_KEBAB}}.mdx`\n\n**Content Requirements:**\n1. **Use coupling strength context** - Adapt documentation structure based on couplingStrength value\n2. **Extract real interfaces** - Don't create placeholder interfaces, extract actual type interfaces from the codebase\n3. **Leverage component description** - Expand on the provided description with specific use cases and implementation guidance\n4. **Document interdependencies** - For coupled components, clearly explain component relationships and requirements\n5. **Include practical examples** - Use realistic, working code examples that demonstrate proper usage\n6. **Show integration patterns** - For coupled components, demonstrate required composition patterns\n**Coupling-Specific Requirements:**\n- **Critical/Strong Coupling**: Focus on required relationships, composition patterns, and shared context\n- **Moderate Coupling**: Show how components enhance each other and optional usage patterns  \n- **No Coupling**: Document standalone usage, variants, and individual component capabilities\n\n## Output\nReturn only the complete MDX file content, ready to be saved as `repo-indexing/{{COMPONENT_NAME_KEBAB}}.mdx`. You must use the Write tool in your response.";
+export declare const COMPONENT_GROUP_MDX_PROMPT = "# Component Documentation Generation\n\n## Objective\nGenerate comprehensive MDX documentation for a specific component, analyzing their interfaces, relationships, and usage patterns using the relevant files provided in the input.\n\n## Instructions\n\n### 1. Component Analysis\nFor the given component, analyze each relevant file by:\n- **Interdependency mapping** - Document how components depend on each other\n- **Interface examination** - Extract and document all props, their types, and descriptions\n- **Context analysis** - Identify shared state, contexts, or communication patterns\n- **Compositional patterns** - Document required parent-child relationships\n- **Usage pattern analysis** - Identify how components work together\n- **Example extraction** - Find real usage examples from the codebase\n\n{{COMPONENT_NAME}} has the following related components: {{RELATED_COMPONENTS}}\nThe following files are associated with {{COMPONENT_NAME}}: {{FILE_LIST}}\n\n### 2. Documentation Structure\nCreate comprehensive documentation covering:\n- **Component rationale** - Why these components work together and when to use them\n- **Architectural overview** - How the components form a cohesive system\n- **Component interfaces** - Detailed prop documentation with interdependencies\n- **Composition patterns** - Required and optional usage combinations\n- **Integration examples** - Real-world scenarios showing the component in action\n- **Best practices** - Recommended usage patterns and guidelines\n\n## Required Output Format\n\nGenerate an MDX file with this structure:\n\n```mdx\n---\n# {{COMPONENT_NAME}}\n\n## Overview\n\n### Purpose\n{{COMPONENT_DESCRIPTION}}\n\n### When to Use\n[Expand on the use cases mentioned in the description - be specific about scenarios, user needs, and implementation contexts]\n\n### Architecture\n[Explain the architectural pattern based on coupling strength:]\n- **Critical/Strong Coupling**: Describe the required relationships, shared context, or compositional hierarchy\n- **Moderate Coupling**: Explain how components enhance each other\n- **No Coupling**: Note that this is a standalone component\n\n### Component Interdependencies\n[Map out component relationships - only for components with coupling:]\n- Required parent-child relationships\n- Shared context dependencies  \n- Communication patterns between components\n- Related components\n\n## API\n**Types**: Interfaces related to the component including all props, methods, or children along with descriptions.\n**Dependencies:** Other components that must be used\n**Provides:** Context/state this component provides to children. Only required for coupled components.\n\n## Usage Examples\nInclude examples that show how to fully use the component. At a minimum, you must include the following examples:\n\n- Basic usage including how to import the component if applicable\n- Usage with any dependency components\n- Variations with conditional rendering, different prop combinations, etc\n\n## Component Relationships {Only for coupled components}\n\n### Data Flow\n[Explain how data flows between the component and related components}\n\n### Context Sharing\n[Document shared contexts, providers, or state management]\n\n### Event Handling\n[Describe how events bubble up or propagate between components]\n\n## Best Practices\n\n### Usage Guidelines\n- [Specific recommendation based on component purpose and use cases]\n- [Another recommendation focusing on accessibility or performance]\n- [Usage pattern guidance based on the component's architecture]\n\n### Accessibility {When relevant}\n- [ARIA relationships between components]\n- [Keyboard navigation patterns]\n- [Screen reader considerations]\n\n### Performance {When relevant}\n- [Optimization recommendations]\n- [State management best practices]\n- [Rendering performance considerations]\n\n## Common Patterns {Expand based on component functionality}\n\n### Pattern 1: [Specific Pattern Name]\n```tsx\n// Example showing a specific usage pattern\n// Include comments explaining why this pattern is recommended\n```\n\n### Pattern 2: [Another Pattern Name]\n```tsx\n// Another common pattern with explanation\n```\n\n```\n\n## File Generation Requirements\n\n**File Naming:**\n- Use kebab-case derived from component name: `{{COMPONENT_NAME_KEBAB}}.mdx`\n- Place in `repo-indexing/` folder\n- Example: `repo-indexing/{{COMPONENT_NAME_KEBAB}}.mdx`\n\n**Content Requirements:**\n1. **Use coupling strength context** - Adapt documentation structure based on couplingStrength value\n2. **Extract real interfaces** - Don't create placeholder interfaces, extract actual type interfaces from the codebase\n3. **Leverage component description** - Expand on the provided description with specific use cases and implementation guidance\n4. **Document interdependencies** - For coupled components, clearly explain component relationships and requirements\n5. **Include practical examples** - Use realistic, working code examples that demonstrate proper usage\n6. **Show integration patterns** - For coupled components, demonstrate required composition patterns\n**Coupling-Specific Requirements:**\n- **Critical/Strong Coupling**: Focus on required relationships, composition patterns, and shared context\n- **Moderate Coupling**: Show how components enhance each other and optional usage patterns  \n- **No Coupling**: Document standalone usage, variants, and individual component capabilities\n\n## Output\nReturn only the complete MDX file content, ready to be saved as `repo-indexing/{{COMPONENT_NAME_KEBAB}}.mdx`. You must use the Write tool in your response.";