builder.io 1.12.7 → 1.13.0

package/types/cli/index.d.ts

@@ -74,12 +74,6 @@ export interface CLIArgs {
     workspace?: string;
     /** Output structured JSON data instead of human-readable logs */
     jsonOutput?: boolean;
-    /** Local mode */
-    local?: boolean;
-    /** Inlined to builder.config.json file */
-    configJson?: string;
-    /** Server URL */
-    serverUrl?: string;
     /** Remove all mappings from the space, publishing zero mappings even if mapper files exist */
     clearMappings?: boolean;
     /** Enabled tools, list of strings separated by commas */
@@ -90,8 +84,6 @@ export interface CLIArgs {
     listIndexedRepos?: boolean;
     /** Disable MCP support */
     disableMcp?: boolean;
-    /** Enable privacy mode for codegen */
-    privacyMode?: boolean;
     /** Clear all stored credentials (logout) */
     reset?: boolean;
 }

package/types/cli/launch.d.ts

@@ -83,6 +83,20 @@ export interface LaunchArgs extends CLIArgs {
      * @default false
      */
     autoDetectDevServer?: boolean;
+    /** Inlined to builder.config.json file */
+    configJson?: string;
+    /**
+     * Enable HTTPS server.
+     * When enabled, creates both HTTP and HTTPS servers.
+     *
+     * @default false
+     */
+    https?: boolean;
+    /**
+     * Custom domain to use instead of localhost in proxy URLs.
+     * Useful for development with custom SSL certificates.
+     */
+    localHttpsDomain?: string;
 }
 export declare function runFusionCommand({ sys, args, }: {
     sys: DevToolsSys;

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

@@ -1,7 +1,7 @@
 import type { DevToolsSys } from "../../types";
 import type { Credentials } from "../credentials";
 import type { WorkspaceConfiguration } from "$/ai-utils";
-import type { Component } from "./types";
+import type { Component, ComponentTask } from "./types";
 export declare const discoverComponents: (sys: DevToolsSys, credentials: Credentials, sessionId: string, remoteComponents: Component[], opts?: {
     force?: boolean;
     designSystemPackage?: string;
@@ -10,6 +10,7 @@ export declare const discoverComponents: (sys: DevToolsSys, credentials: Credent
     debug?: boolean;
 }) => Promise<{
     numComponentsFound: number;
-    componentsToIndex: Component[];
-    discoveredComponents: Component[];
+    componentsToIndex: ComponentTask[];
+    discoveredComponents: ComponentTask[];
 }>;
+export declare const computeHash: (sys: DevToolsSys, files: string[]) => Promise<string>;

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

@@ -1,8 +1,8 @@
 import type { DevToolsSys } from "../../types";
 import type { Credentials } from "../credentials";
-import type { Component } from "./types";
+import type { Component, ComponentTask, Task } from "./types";
 import type { WorkspaceConfiguration } from "$/ai-utils";
-export declare const processComponent: (sys: DevToolsSys, credentials: Credentials, sessionId: string, component: Component, opts?: {
+export declare const processComponent: (sys: DevToolsSys, credentials: Credentials, sessionId: string, component: ComponentTask, opts?: {
     designSystemId?: string | null;
     designSystemPackage?: string;
     designSystemVersion?: string;
@@ -12,8 +12,9 @@ export declare const processComponent: (sys: DevToolsSys, credentials: Credentia
 }) => Promise<void>;
 export declare const processAgent: (sys: DevToolsSys, credentials: Credentials, discoveredComponents: Component[], opts?: {
     hasIcons?: boolean;
+    hasDesignTokens?: boolean;
     designSystemId?: string | null;
     retriesAllowed?: number;
     debug?: boolean;
 }) => Promise<void>;
-export declare const deprecateObsoleteComponents: (credentials: Credentials, localComponents: Component[], remoteComponents: Component[]) => Promise<void>;
+export declare const deprecateObsoleteComponents: (credentials: Credentials, localComponents: Task[], remoteComponents: Component[]) => Promise<void>;

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

@@ -3,6 +3,7 @@ import { type Credentials } from "../credentials";
 import type { DesignSystem, GenerateUserMessage, WorkspaceConfiguration, StoreComponentDocsInput, UpdateDesignSystemInput, DesignSystemScope, DisplayDesignSystem } from "$/ai-utils";
 export declare const AGENT_FILE = "AGENTS.md";
 export declare const ICONS_FILE = "icons.md";
+export declare const TOKENS_FILE = "DESIGN_TOKENS";
 export declare const REPO_INDEXING_FOLDER = "repo-indexing";
 export interface UserSettings {
     isAdminInOrganization: boolean;

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

@@ -1,8 +1,8 @@
 import type { DevToolsSys } from "../../types";
 import type { CLIArgs } from "../index";
 import { type Credentials } from "../credentials";
-import type { Component } from "./types";
-export declare const displayComponentLibrarySummary: (components: Component[], indexedComponents: Component[], startTime: number, failedComponents: string[] | undefined, isForce: boolean | undefined, designSystemName: string, designSystemId?: string, numIconsIndexed?: number) => void;
+import type { Component, TokenTask } from "./types";
+export declare const displayComponentLibrarySummary: (components: Component[], indexedComponents: Component[], 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 | {

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

@@ -0,0 +1,21 @@
+import type { DevToolsSys } from "../../types";
+import type { Component, TokenTask } from "./types";
+import type { Credentials } from "../credentials";
+import type { WorkspaceConfiguration } from "$/ai-utils";
+export declare const discoverTokens: (sys: DevToolsSys, credentials: Credentials, sessionId: string, remoteTokens: Component[], opts?: {
+    force?: boolean;
+    designSystemPackage?: string;
+    workspaceConfig?: WorkspaceConfiguration;
+    debug?: boolean;
+}) => Promise<{
+    tokenGroupsToIndex: TokenTask[];
+    discoveredTokenGroups: TokenTask[];
+}>;
+export declare const processTokens: (sys: DevToolsSys, credentials: Credentials, sessionId: string, group: TokenTask, opts: {
+    designSystemId: string;
+    designSystemPackage?: string;
+    designSystemVersion?: string;
+    debug?: boolean;
+    workspaceConfig?: WorkspaceConfiguration;
+    retriesAllowed?: number;
+}) => Promise<void>;

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

@@ -10,3 +10,26 @@ export interface Component {
     designSystemId?: string | null;
     tokens?: number;
 }
+interface BaseTask {
+    name: string;
+}
+export interface ComponentTask extends BaseTask {
+    type: "component";
+    description: string;
+    relevantFiles: string[];
+    relatedComponents: string[];
+    designSystemPackage?: string;
+    designSystemVersion?: string;
+    hash: string;
+}
+export interface TokenTask extends BaseTask {
+    type: "token";
+    relevantFiles: string[];
+    tokens: string[];
+    hash: string;
+}
+export interface IconTask extends BaseTask {
+    type: "icon";
+}
+export type Task = ComponentTask | TokenTask | IconTask;
+export {};

package/types/cli/utils/process-tracker.d.ts

@@ -0,0 +1,59 @@
+import { ChildProcess, type ChildProcessWithoutNullStreams, type ChildProcessByStdio, type SpawnOptions, type StdioPipe, type StdioNull } from "child_process";
+import type { Readable } from "stream";
+/**
+ * Global process tracker that keeps track of all spawned processes
+ * and ensures they are killed when the main process exits
+ */
+declare class ProcessTracker {
+    private processes;
+    private cleanupHandlersRegistered;
+    constructor();
+    /**
+     * Register a spawned process for tracking and cleanup
+     */
+    track(childProcess: ChildProcess): void;
+    /**
+     * Untrack a process (useful if you're managing it manually)
+     */
+    untrack(childProcess: ChildProcess): void;
+    /**
+     * Kill all tracked processes
+     */
+    killAll(): Promise<void>;
+    /**
+     * Register cleanup handlers for various exit signals
+     */
+    private registerCleanupHandlers;
+    /**
+     * Get the number of tracked processes
+     */
+    get count(): number;
+}
+export declare const processTracker: ProcessTracker;
+/**
+ * Options for trackedSpawn function
+ */
+export interface TrackedSpawnOptions {
+    /** The command to run */
+    command: string;
+    /** Arguments for the command */
+    args?: readonly string[];
+    /** Spawn options */
+    options?: SpawnOptions;
+}
+/**
+ * Wrapper around child_process.spawn that automatically tracks the spawned process
+ * and ensures it gets killed when the main process exits
+ */
+export declare function trackedSpawn(config: TrackedSpawnOptions & {
+    options: SpawnOptions & {
+        stdio: "pipe" | [StdioPipe, StdioPipe, StdioPipe];
+    };
+}): ChildProcessWithoutNullStreams;
+export declare function trackedSpawn(config: TrackedSpawnOptions & {
+    options: SpawnOptions & {
+        stdio: [StdioNull | "ignore", StdioPipe, StdioPipe];
+    };
+}): ChildProcessByStdio<null, Readable, Readable>;
+export declare function trackedSpawn(config: TrackedSpawnOptions): ChildProcess;
+export {};

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

@@ -1 +1 @@
-export declare const REPO_INDEXING_AGENT_PROMPT = "# Design System Component Reference\n\nThis document provides a comprehensive overview of the design system's component architecture and available components for code generation and development reference.\n\n## System Architecture\n\nThe design system follows a modular component-based architecture where each component provides specific functionality. Components are organized into logical groups that can work independently or in combination with other components.\n\n### Component Organization Principles\n\n- **Single Responsibility**: Each component serves a specific purpose\n- **Composability**: Components can be combined to create complex interfaces\n- **Consistency**: All components follow the same design patterns and API conventions\n- **Accessibility**: Components are built with accessibility standards in mind\n\n## Documentation Structure\n\nFor detailed documentation on any component, refer to the corresponding MDX file in the `design-system-docs` folder. The documentation files follow the naming convention:\n\n```\ndesign-system-docs/[componentname].mdx\n```\n\nFor example:\n- `design-system-docs/button.mdx` - Detailed documentation for Button component\n- `design-system-docs/table.mdx` - Detailed documentation for Table component\n- `design-system-docs/annotationcontext.mdx` - Detailed documentation for AnnotationContext\n- `design-system-docs/applayout.mdx` - Detailed documentation for AppLayout component\n\nThese MDX files contain comprehensive information including:\n- Component API documentation\n- Usage examples\n- Props and configuration options\n- Best practices and implementation guidelines\n- Accessibility requirements\n- Integration patterns with other components\n\n## Components\n\n{{COMPONENTS}}\n{{ICONS}}\n\n## Usage Guidelines\n\n### Component Dependencies\n- Most components are self-contained and can be used independently\n- Identify any components that require multiple components to work together\n- Some components work better in combination (e.g., Form + FormField, Table + Pagination)\n\n### Integration Patterns\n- Layout components typically serve as containers for other components\n- Form controls should be wrapped in FormField components for proper labeling\n- Navigation components can be used independently or as part of larger layout structures\n- Data display components can be enhanced with interactive elements like buttons and popovers\n\n### Accessibility Considerations\n- All components are built with accessibility in mind\n- Use semantic HTML structures provided by the components\n- Leverage built-in ARIA attributes and keyboard navigation\n- The LiveRegion component provides additional accessibility announcements when needed\n\n### Responsive Design\n- Layout components provide responsive behavior out of the box\n- Grid and ColumnLayout components adapt to different screen sizes\n- Mobile-friendly navigation patterns are built into navigation components\n\n## Usage Reference\n\nThis reference should be used to understand the available components and their intended purposes when generating code or building applications with this design system. For specific implementation details, always consult the corresponding MDX documentation file in the `design-system-docs` folder.";
+export declare const REPO_INDEXING_AGENT_PROMPT = "# Design System Component Reference\n\nThis document provides a comprehensive overview of the design system's component architecture and available components for code generation and development reference.\n\n## System Architecture\n\nThe design system follows a modular component-based architecture where each component provides specific functionality. Components are organized into logical groups that can work independently or in combination with other components.\n\n### Component Organization Principles\n\n- **Single Responsibility**: Each component serves a specific purpose\n- **Composability**: Components can be combined to create complex interfaces\n- **Consistency**: All components follow the same design patterns and API conventions\n- **Accessibility**: Components are built with accessibility standards in mind\n\n## Documentation Structure\n\nFor detailed documentation on any component, refer to the corresponding MDX file in the `design-system-docs` folder. The documentation files follow the naming convention:\n\n```\ndesign-system-docs/[componentname].mdx\n```\n\nFor example:\n- `design-system-docs/button.mdx` - Detailed documentation for Button component\n- `design-system-docs/table.mdx` - Detailed documentation for Table component\n- `design-system-docs/annotationcontext.mdx` - Detailed documentation for AnnotationContext\n- `design-system-docs/applayout.mdx` - Detailed documentation for AppLayout component\n\nThese MDX files contain comprehensive information including:\n- Component API documentation\n- Usage examples\n- Props and configuration options\n- Best practices and implementation guidelines\n- Accessibility requirements\n- Integration patterns with other components\n\n## Components\n\n{{COMPONENTS}}\n{{ICONS}}\n{{TOKENS}}\n\n## Usage Guidelines\n\n### Component Dependencies\n- Most components are self-contained and can be used independently\n- Identify any components that require multiple components to work together\n- Some components work better in combination (e.g., Form + FormField, Table + Pagination)\n\n### Integration Patterns\n- Layout components typically serve as containers for other components\n- Form controls should be wrapped in FormField components for proper labeling\n- Navigation components can be used independently or as part of larger layout structures\n- Data display components can be enhanced with interactive elements like buttons and popovers\n\n### Accessibility Considerations\n- All components are built with accessibility in mind\n- Use semantic HTML structures provided by the components\n- Leverage built-in ARIA attributes and keyboard navigation\n- The LiveRegion component provides additional accessibility announcements when needed\n\n### Responsive Design\n- Layout components provide responsive behavior out of the box\n- Grid and ColumnLayout components adapt to different screen sizes\n- Mobile-friendly navigation patterns are built into navigation components\n\n## Usage Reference\n\nThis reference should be used to understand the available components and their intended purposes when generating code or building applications with this design system. For specific implementation details, always consult the corresponding MDX documentation file in the `design-system-docs` folder.";