builder.io 1.17.28 → 1.17.30

package/types/cli/index.d.ts

@@ -37,9 +37,9 @@ export interface CLIArgs {
      * where the design system name is different than the npm package name.
      * Example: --designSystemPackage=@adobe/react-spectrum --designSystemName="Adobe React Spectrum"
      *
-     * This flag can also be used with includeDirectories to specify a name for design systems
+     * This flag can also be used with addDirectory to specify a name for design systems
      * that are not npm packages.
-     * Example: --includeDirectories="path/to/swift/ui/components" --designSystemName="Native UI"
+     * Example: --addDirectory "path/to/swift/ui/components" --designSystemName="Native UI"
      **/
     designSystemName?: string;
     /**
@@ -47,8 +47,19 @@ export interface CLIArgs {
      * Use this when component implementations live in a different place
      * than the workspace package you are indexing.
      * Example: --includeDirectories "packages/foo, packages/bar"
+     *
+     * @deprecated Use addDirectory instead
      **/
     includeDirectories?: string;
+    /**
+     * Additional directories to look in for repo indexing.
+     * Use this when component implementations live in a different place
+     * than the workspace package you are indexing.
+     *
+     * @alias add
+     * Example: --addDirectory "../docs" --addDirectory "../../bar"
+     */
+    addDirectory?: string | string[];
     /** The scope of the design system to index */
     scope?: DesignSystemScope;
     /** Token to use for figma */
@@ -102,4 +113,23 @@ export interface CLIArgs {
     app?: boolean;
     /** Skip browser auto-open (flag form) */
     open?: boolean;
+    /**
+     * Glob pattern(s) to include for repo indexing access control.
+     * When specified, only these patterns will be accessible by default.
+     * Can be a single string or array of strings (when flag is repeated).
+     * Example: --include "src/components/*.tsx" --include "src/lib/*.ts"
+     */
+    include?: string | string[];
+    /**
+     * Glob pattern(s) to exclude for repo indexing access control.
+     * These patterns will be denied access even if included.
+     * Can be a single string or array of strings (when flag is repeated).
+     * Example: --exclude "*.test.ts" --exclude "__tests__/**"
+     */
+    exclude?: string | string[];
+    /**
+     * Extra instructions to be taken into account during repo indexing.
+     * Example: --instructions "Do not index mapper files."
+     */
+    instructions?: string;
 }

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

@@ -14,7 +14,7 @@ export interface GitInfo {
 /**
  * Detect git repository information
  */
-export declare function detectGitInfo(sys: DevToolsSys): Promise<GitInfo>;
+export declare function detectGitInfo(sys: DevToolsSys): Promise<GitInfo | undefined>;
 /**
  * Display git info in a user-friendly format
  */

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

@@ -9,6 +9,9 @@ export declare const discoverComponents: (sys: DevToolsSys, credentials: Credent
     workspaceConfig?: WorkspaceConfiguration;
     debug?: boolean;
     specificComponents?: string[];
+    include?: string | string[];
+    exclude?: string | string[];
+    instructions?: string;
 }) => Promise<{
     numComponentsFound: number;
     componentsToIndex: ComponentTask[];

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

@@ -8,6 +8,9 @@ export declare const processComponent: (sys: DevToolsSys, credentials: Credentia
     designSystemVersion?: string;
     workspaceConfig?: WorkspaceConfiguration;
     debug?: boolean;
+    include?: string | string[];
+    exclude?: string | string[];
+    instructions?: string;
 }) => Promise<void>;
 export declare const processAgent: (sys: DevToolsSys, credentials: Credentials, discoveredComponents: ComponentTask[], opts: {
     hasIcons?: boolean;

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

@@ -5,6 +5,9 @@ export declare const discoverIcons: (sys: DevToolsSys, credentials: Credentials,
     designSystemPackage?: string;
     workspaceConfig?: WorkspaceConfiguration;
     debug?: boolean;
+    include?: string | string[];
+    exclude?: string | string[];
+    instructions?: string;
 }) => Promise<{
     icons: string[];
     usage: string;

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

@@ -7,6 +7,9 @@ export declare const discoverInstallation: (sys: DevToolsSys, credentials: Crede
     designSystemVersion?: string;
     workspaceConfig?: WorkspaceConfiguration;
     debug?: boolean;
+    include?: string | string[];
+    exclude?: string | string[];
+    instructions?: string;
 }) => Promise<{
     hash: string;
     relevantFiles: string[];

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

@@ -1,6 +1,6 @@
 import type { DevToolsSys } from "../../core";
 import { type Credentials } from "../credentials";
-import type { DesignSystem, GenerateUserMessage, WorkspaceConfiguration, UpdateDesignSystemInput, DesignSystemScope, DisplayDesignSystem, IndexDocumentV1 } from "$/ai-utils";
+import type { DesignSystem, GenerateUserMessage, WorkspaceConfiguration, UpdateDesignSystemInput, DesignSystemScope, DisplayDesignSystem, IndexDocumentV1, AclPolicy } from "$/ai-utils";
 export declare const AGENT_FILE = "AGENTS.md";
 export declare const ICONS_FILE = "icons.mdx";
 export declare const TOKENS_FILE = "tokens.mdx";
@@ -10,6 +10,25 @@ export interface UserSettings {
     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;
+}
 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;
@@ -29,26 +48,45 @@ export declare const runCodeGen: (sys: DevToolsSys, credentials: Credentials, se
      * for writing large files that would otherwise consume a lot of tokens.
      */
     expectFile?: "tool" | string;
-}, metadata?: any) => Promise<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.
+     * 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.
      */
-    onlyEditAccess?: boolean;
+    include?: string | string[];
     /**
-     * If true, design systems that are scoped to the global space will be included.
-     * Defaults to false.
+     * 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.
      */
-    includeGlobalScopeDesignSystems?: boolean;
+    exclude?: string | string[];
     /**
-     * If true, the # of component docs in each design system will also be returned.
-     * Defaults to false.
+     * Extra instructions to be taken into account during repo indexing.
      */
-    includeDocumentCount?: boolean;
-}
+    instructions?: string;
+}, metadata?: any) => Promise<string>;
+/**
+ * Generates an ACL policy for repo indexing based on include/exclude patterns.
+ *
+ * @param include - Glob pattern(s) to include. When specified, only these patterns
+ *                  will be accessible by default. Can be a single string or array.
+ * @param exclude - Glob pattern(s) to exclude. These patterns will be denied access
+ *                  even if included. Can be a single string or array.
+ * @returns AclPolicy object with entries and denyDescription
+ *
+ * @example
+ * ```typescript
+ * // Allow only src directory, exclude tests
+ * const policy = generateRepoIndexingAclPolicy(
+ *   ["src/**\/*", "lib/**\/*"],
+ *   ["**\/*.test.ts", "**\/__tests__/**"]
+ * );
+ *
+ * // Single pattern
+ * 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[]>;
@@ -62,6 +100,9 @@ export declare const addDesignSystem: (credentials: Credentials, body: {
     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>;

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

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

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

@@ -7,6 +7,9 @@ export declare const discoverTokens: (sys: DevToolsSys, credentials: Credentials
     designSystemPackage?: string;
     workspaceConfig?: WorkspaceConfiguration;
     debug?: boolean;
+    include?: string | string[];
+    exclude?: string | string[];
+    instructions?: string;
 }) => Promise<{
     tokenGroupsToIndex: TokenTask[];
     discoveredTokenGroups: TokenTask[];
@@ -17,4 +20,7 @@ export declare const processTokens: (sys: DevToolsSys, credentials: Credentials,
     designSystemVersion?: string;
     debug?: boolean;
     workspaceConfig?: WorkspaceConfiguration;
+    include?: string | string[];
+    exclude?: string | string[];
+    instructions?: string;
 }) => Promise<void>;