@builder.io/dev-tools 1.24.0-dev.202602060949.9613162d0 → 1.24.0-dev.202602061409.e623db468

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (238) hide show
  1. package/cli/index.cjs +339 -108
  2. package/cli/index.cjs.map +2 -2
  3. package/core/index.cjs +1 -1
  4. package/core/index.mjs +1 -1
  5. package/node/index.cjs +1 -1
  6. package/node/index.mjs +1 -1
  7. package/package.json +3 -3
  8. package/server/index.cjs +2 -2
  9. package/server/index.mjs +2 -2
  10. package/types/_tests_/utils.d.ts +48 -35
  11. package/types/cli/abort-signal-any.d.ts +3 -1
  12. package/types/cli/auth/auth-utils.d.ts +3 -1
  13. package/types/cli/auth/auth.d.ts +5 -1
  14. package/types/cli/backup.d.ts +114 -60
  15. package/types/cli/builder-add/interface.d.ts +21 -4
  16. package/types/cli/code-file-utils.d.ts +11 -8
  17. package/types/cli/code.d.ts +13 -3
  18. package/types/cli/codegen.d.ts +8 -0
  19. package/types/cli/credentials.d.ts +61 -45
  20. package/types/cli/detectors/nextjs.d.ts +4 -1
  21. package/types/cli/detectors/svelte.d.ts +4 -1
  22. package/types/cli/detectors/vue.d.ts +4 -1
  23. package/types/cli/download.d.ts +9 -4
  24. package/types/cli/dsi-mcp.d.ts +4 -1
  25. package/types/cli/fetch.d.ts +7 -2
  26. package/types/cli/figma-publish.d.ts +34 -17
  27. package/types/cli/figma-utils.d.ts +51 -21
  28. package/types/cli/figma.d.ts +9 -2
  29. package/types/cli/generate.d.ts +14 -11
  30. package/types/cli/incremental-tsc.d.ts +19 -7
  31. package/types/cli/index.d.ts +154 -154
  32. package/types/cli/launch/InitStateMachine.d.ts +156 -89
  33. package/types/cli/launch/config.d.ts +13 -3
  34. package/types/cli/launch/dry-run-backup.d.ts +14 -7
  35. package/types/cli/launch/errors.d.ts +7 -2
  36. package/types/cli/launch/grafana.d.ts +5 -1
  37. package/types/cli/launch/helpers.d.ts +19 -10
  38. package/types/cli/launch/machine-health.d.ts +8 -3
  39. package/types/cli/launch/proxy.d.ts +11 -4
  40. package/types/cli/launch/server.d.ts +19 -12
  41. package/types/cli/launch/vscode-tunnel-manager.d.ts +77 -68
  42. package/types/cli/launch.d.ts +109 -106
  43. package/types/cli/prettier.d.ts +9 -2
  44. package/types/cli/repo-connect/env-collector.d.ts +16 -11
  45. package/types/cli/repo-connect/file-collector.d.ts +22 -15
  46. package/types/cli/repo-connect/git-detector.d.ts +13 -11
  47. package/types/cli/repo-connect/install-runner.d.ts +8 -5
  48. package/types/cli/repo-connect/package-detector.d.ts +12 -8
  49. package/types/cli/repo-connect/repo-connect.d.ts +4 -1
  50. package/types/cli/repo-indexing/component-discovery.d.ts +30 -17
  51. package/types/cli/repo-indexing/icons.d.ts +36 -24
  52. package/types/cli/repo-indexing/installation.d.ts +22 -14
  53. package/types/cli/repo-indexing/repo-indexing-utils.d.ts +138 -79
  54. package/types/cli/repo-indexing/repo-indexing.d.ts +37 -17
  55. package/types/cli/repo-indexing/repo-indexing.mock.d.ts +3 -3
  56. package/types/cli/repo-indexing/tokens.d.ts +44 -25
  57. package/types/cli/repo-indexing/types.d.ts +2 -0
  58. package/types/cli/repo-metrics-utils.d.ts +13 -5
  59. package/types/cli/repo-metrics.d.ts +4 -1
  60. package/types/cli/report/figma-report.d.ts +63 -36
  61. package/types/cli/server-ws.d.ts +40 -32
  62. package/types/cli/spinner.d.ts +4 -4
  63. package/types/cli/track.d.ts +4 -1
  64. package/types/cli/utils/agent-discovery.d.ts +10 -5
  65. package/types/cli/utils/codegen-utils.d.ts +9 -0
  66. package/types/cli/utils/component-group-mdx-prompt.d.ts +2 -1
  67. package/types/cli/utils/discovery-test-utils.d.ts +3 -1
  68. package/types/cli/utils/env-capture.d.ts +21 -15
  69. package/types/cli/utils/env-substitution.d.ts +4 -1
  70. package/types/cli/utils/feature-flags.d.ts +3 -1
  71. package/types/cli/utils/file-overrides-manager.d.ts +39 -23
  72. package/types/cli/utils/git.d.ts +28 -16
  73. package/types/cli/utils/hosts-file-manager.d.ts +7 -4
  74. package/types/cli/utils/lock-file.d.ts +10 -7
  75. package/types/cli/utils/parseGitDiff.d.ts +4 -1
  76. package/types/cli/utils/process-tracker.d.ts +85 -51
  77. package/types/cli/utils/repo-indexing-agent-prompt.d.ts +1 -1
  78. package/types/cli/utils/rules-discovery.d.ts +10 -5
  79. package/types/cli/utils/rules-parser.d.ts +5 -1
  80. package/types/cli/utils/terminal-buffer.d.ts +23 -23
  81. package/types/cli/utils/workspace-path-resolver.d.ts +23 -16
  82. package/types/cli/utils/yaml-frontmatter.d.ts +10 -6
  83. package/types/client/client-api.d.ts +42 -10
  84. package/types/client/edit-button/document-listeners.d.ts +3 -1
  85. package/types/client/edit-button/index.d.ts +6 -6
  86. package/types/client/menu/index.d.ts +3 -3
  87. package/types/client/menu/pages/component-detail.d.ts +8 -2
  88. package/types/client/menu/pages/component-input.d.ts +5 -1
  89. package/types/client/menu/pages/component-list.d.ts +4 -1
  90. package/types/client/menu/toggle/menu-toggle.d.ts +4 -1
  91. package/types/client/setup-ui/overview.d.ts +2 -2
  92. package/types/client/tracking.d.ts +11 -11
  93. package/types/client/utils.d.ts +5 -3
  94. package/types/common/ast/app-dependencies.d.ts +8 -2
  95. package/types/common/ast/component-info.d.ts +26 -6
  96. package/types/common/ast/component-input-types.d.ts +28 -9
  97. package/types/common/ast/component-registry.d.ts +23 -8
  98. package/types/common/ast/convert-values.d.ts +40 -8
  99. package/types/common/ast/ensure-array-statement.d.ts +7 -3
  100. package/types/common/ast/ensure-comments.d.ts +5 -1
  101. package/types/common/ast/ensure-imports.d.ts +10 -5
  102. package/types/common/ast/exported-statements.d.ts +8 -4
  103. package/types/common/ast/imported-statements.d.ts +5 -1
  104. package/types/common/ast/normalize-statements.d.ts +12 -3
  105. package/types/common/ast/remove-unused-imports.d.ts +4 -1
  106. package/types/common/ast/transform.d.ts +13 -3
  107. package/types/common/ast/utils.d.ts +42 -19
  108. package/types/common/builder/builder-api.d.ts +32 -23
  109. package/types/common/builder/builder-sdks.d.ts +10 -8
  110. package/types/common/builder/content-generation.d.ts +10 -7
  111. package/types/common/builder/content-ids.d.ts +2 -1
  112. package/types/common/cache.d.ts +4 -1
  113. package/types/common/constants.d.ts +2 -1
  114. package/types/common/dotenv.d.ts +24 -5
  115. package/types/common/errors.d.ts +50 -22
  116. package/types/common/fs.d.ts +17 -4
  117. package/types/common/interactive-select-files.d.ts +16 -2
  118. package/types/common/mem-sys.d.ts +7 -5
  119. package/types/common/node-request.d.ts +4 -4
  120. package/types/common/path.d.ts +1 -3
  121. package/types/common/test-utils.d.ts +21 -7
  122. package/types/common/typescript.d.ts +26 -7
  123. package/types/common/utils.d.ts +36 -8
  124. package/types/core/adapters/angular/angular-api-key.d.ts +29 -6
  125. package/types/core/adapters/angular/angular-app-module-imports.d.ts +12 -2
  126. package/types/core/adapters/angular/angular-app-routes-update.d.ts +6 -1
  127. package/types/core/adapters/angular/angular-components.d.ts +40 -12
  128. package/types/core/adapters/angular/angular-ensure-builder-setup.d.ts +9 -3
  129. package/types/core/adapters/angular/angular-ensure-config-plugin.d.ts +16 -4
  130. package/types/core/adapters/angular/angular-fix-tsconfig.d.ts +3 -1
  131. package/types/core/adapters/angular/angular-registry-parse.d.ts +22 -10
  132. package/types/core/adapters/angular/angular-registry.d.ts +15 -2
  133. package/types/core/adapters/angular/angular-test-utils.d.ts +8 -4
  134. package/types/core/adapters/angular/index.d.ts +20 -12
  135. package/types/core/adapters/angular/types.d.ts +5 -5
  136. package/types/core/adapters/next/index.d.ts +26 -18
  137. package/types/core/adapters/next/next-api-key.d.ts +4 -1
  138. package/types/core/adapters/next/next-component-info.d.ts +9 -2
  139. package/types/core/adapters/next/next-components.d.ts +4 -1
  140. package/types/core/adapters/next/next-ensure-builder-setup.d.ts +6 -2
  141. package/types/core/adapters/next/next-ensure-config-plugin.d.ts +5 -1
  142. package/types/core/adapters/next/next-registry-parse.d.ts +21 -8
  143. package/types/core/adapters/next/next-registry.d.ts +15 -2
  144. package/types/core/adapters/next/next-test-utils.d.ts +21 -11
  145. package/types/core/adapters/qwik-city/index.d.ts +14 -6
  146. package/types/core/adapters/qwik-city/qwik-api-key.d.ts +4 -1
  147. package/types/core/adapters/qwik-city/qwik-component-source-inputs.d.ts +4 -1
  148. package/types/core/adapters/qwik-city/qwik-components.d.ts +23 -8
  149. package/types/core/adapters/qwik-city/qwik-ensure-builder-setup.d.ts +6 -2
  150. package/types/core/adapters/qwik-city/qwik-ensure-config-plugin.d.ts +5 -1
  151. package/types/core/adapters/qwik-city/qwik-registry-parse.d.ts +22 -10
  152. package/types/core/adapters/qwik-city/qwik-registry.d.ts +15 -2
  153. package/types/core/adapters/qwik-city/qwik-test-utils.d.ts +8 -4
  154. package/types/core/adapters/qwik-city/qwik-ts-program.d.ts +3 -1
  155. package/types/core/adapters/react/index.d.ts +19 -11
  156. package/types/core/adapters/react/react-api-key.d.ts +4 -1
  157. package/types/core/adapters/react/react-builder-sdk-setup.d.ts +3 -1
  158. package/types/core/adapters/react/react-component-info.d.ts +9 -2
  159. package/types/core/adapters/react/react-components.d.ts +37 -11
  160. package/types/core/adapters/react/react-ensure-builder-setup.d.ts +6 -2
  161. package/types/core/adapters/react/react-registry-parse.d.ts +21 -8
  162. package/types/core/adapters/react/react-registry.d.ts +15 -2
  163. package/types/core/adapters/react/react-test-utils.d.ts +11 -5
  164. package/types/core/adapters/react/react-ts-program.d.ts +3 -1
  165. package/types/core/adapters/remix/index.d.ts +19 -11
  166. package/types/core/adapters/remix/remix-api-key.d.ts +4 -1
  167. package/types/core/adapters/remix/remix-components.d.ts +4 -1
  168. package/types/core/adapters/remix/remix-ensure-builder-setup.d.ts +9 -3
  169. package/types/core/adapters/remix/remix-ensure-config-plugin.d.ts +5 -1
  170. package/types/core/adapters/remix/remix-registry-parse.d.ts +22 -10
  171. package/types/core/adapters/remix/remix-registry.d.ts +15 -2
  172. package/types/core/adapters/remix/remix-test-utils.d.ts +11 -5
  173. package/types/core/adapters/vite/vite-ensure-config-plugin.d.ts +12 -2
  174. package/types/core/adapters/vue/index.d.ts +20 -12
  175. package/types/core/adapters/vue/vue-api-key.d.ts +4 -1
  176. package/types/core/adapters/vue/vue-components.d.ts +10 -2
  177. package/types/core/adapters/vue/vue-ensure-builder-setup.d.ts +7 -3
  178. package/types/core/adapters/vue/vue-registry-parse.d.ts +19 -9
  179. package/types/core/adapters/vue/vue-registry.d.ts +6 -3
  180. package/types/core/adapters/webpack/webpack-config-helpers.d.ts +8 -3
  181. package/types/core/adapters/webpack/webpack-ensure-config-plugin.d.ts +5 -1
  182. package/types/core/create-dev-tools.d.ts +4 -1
  183. package/types/core/detect-frameworks.d.ts +7 -2
  184. package/types/core/ensure-config-plugin.d.ts +6 -2
  185. package/types/core/find-dependencies.d.ts +6 -3
  186. package/types/core/import-export-registry.d.ts +9 -2
  187. package/types/core/index.d.ts +18 -3
  188. package/types/figma/index.d.ts +95 -64
  189. package/types/node/node-sys.d.ts +13 -6
  190. package/types/remix/index.d.ts +5 -3
  191. package/types/server/auth.d.ts +4 -1
  192. package/types/server/builder-connect.d.ts +21 -6
  193. package/types/server/client-script.d.ts +6 -2
  194. package/types/server/create-dev-tools-server.d.ts +3 -1
  195. package/types/server/dev-tools-api.d.ts +4 -1
  196. package/types/server/dev-tools-http-server.d.ts +3 -1
  197. package/types/server/index.d.ts +28 -1
  198. package/types/server/request-handler.d.ts +6 -1
  199. package/types/tsconfig.tsbuildinfo +1 -1
  200. package/types/types/codegen-server.d.ts +1 -1
  201. package/types/types/connection-tracker.d.ts +34 -34
  202. package/types/types/proxy-middleware.d.ts +25 -15
  203. package/types/types/websocket-types.d.ts +9 -7
  204. package/types/types.d.ts +387 -358
  205. package/types/vite/main.d.ts +1 -1
  206. package/types/webpack/main.d.ts +5 -5
  207. package/types/cli/code-tools.test.d.ts +0 -1
  208. package/types/cli/github-cli.test.d.ts +0 -1
  209. package/vendors/darwin-arm64/complete/rg.bash +0 -783
  210. package/vendors/darwin-arm64/complete/rg.fish +0 -175
  211. package/vendors/darwin-arm64/doc/rg.1 +0 -2178
  212. package/vendors/darwin-arm64/rg +0 -0
  213. package/vendors/darwin-x64/complete/rg.bash +0 -783
  214. package/vendors/darwin-x64/complete/rg.fish +0 -175
  215. package/vendors/darwin-x64/doc/rg.1 +0 -2178
  216. package/vendors/darwin-x64/rg +0 -0
  217. package/vendors/linux-arm64/complete/rg.bash +0 -783
  218. package/vendors/linux-arm64/complete/rg.fish +0 -175
  219. package/vendors/linux-arm64/doc/rg.1 +0 -2178
  220. package/vendors/linux-arm64/rg +0 -0
  221. package/vendors/linux-x64/complete/rg.bash +0 -783
  222. package/vendors/linux-x64/complete/rg.fish +0 -175
  223. package/vendors/linux-x64/doc/rg.1 +0 -2178
  224. package/vendors/linux-x64/rg +0 -0
  225. package/vendors/win32-x64/rg.exe +0 -0
  226. package/vendors/win32-x64/ripgrep-14.1.0-x86_64-pc-windows-msvc/COPYING +0 -3
  227. package/vendors/win32-x64/ripgrep-14.1.0-x86_64-pc-windows-msvc/LICENSE-MIT +0 -21
  228. package/vendors/win32-x64/ripgrep-14.1.0-x86_64-pc-windows-msvc/README.md +0 -516
  229. package/vendors/win32-x64/ripgrep-14.1.0-x86_64-pc-windows-msvc/UNLICENSE +0 -24
  230. package/vendors/win32-x64/ripgrep-14.1.0-x86_64-pc-windows-msvc/complete/_rg +0 -665
  231. package/vendors/win32-x64/ripgrep-14.1.0-x86_64-pc-windows-msvc/complete/_rg.ps1 +0 -213
  232. package/vendors/win32-x64/ripgrep-14.1.0-x86_64-pc-windows-msvc/complete/rg.bash +0 -783
  233. package/vendors/win32-x64/ripgrep-14.1.0-x86_64-pc-windows-msvc/complete/rg.fish +0 -175
  234. package/vendors/win32-x64/ripgrep-14.1.0-x86_64-pc-windows-msvc/doc/CHANGELOG.md +0 -1689
  235. package/vendors/win32-x64/ripgrep-14.1.0-x86_64-pc-windows-msvc/doc/FAQ.md +0 -1046
  236. package/vendors/win32-x64/ripgrep-14.1.0-x86_64-pc-windows-msvc/doc/GUIDE.md +0 -1022
  237. package/vendors/win32-x64/ripgrep-14.1.0-x86_64-pc-windows-msvc/doc/rg.1 +0 -2178
  238. package/vendors/win32-x64/ripgrep-14.1.0-x86_64-pc-windows-msvc/rg.exe +0 -0
@@ -1,74 +1,105 @@
1
1
  import type { DevToolsSys } from "../../core";
2
2
  import { type Credentials } from "../credentials";
3
- import type { DesignSystem, GenerateUserMessage, WorkspaceConfiguration, UpdateDesignSystemInput, DesignSystemScope, DisplayDesignSystem, IndexDocumentV1, AclPolicy, PrivacyMode } from "$/ai-utils";
3
+ import type {
4
+ DesignSystem,
5
+ GenerateUserMessage,
6
+ WorkspaceConfiguration,
7
+ UpdateDesignSystemInput,
8
+ DesignSystemScope,
9
+ DisplayDesignSystem,
10
+ IndexDocumentV1,
11
+ AclPolicy,
12
+ PrivacyMode,
13
+ } from "$/ai-utils";
4
14
  export declare const AGENT_FILE = "AGENTS.md";
5
15
  export declare const ICONS_FILE = "icons.mdx";
6
16
  export declare const TOKENS_FILE = "tokens.mdx";
7
17
  export declare const INSTALLATION_FILE = "installation.md";
8
18
  export declare const REPO_INDEXING_FOLDER = "repo-indexing";
9
19
  export interface UserSettings {
10
- isAdminInOrganization: boolean;
11
- email: string;
20
+ isAdminInOrganization: boolean;
21
+ email: string;
12
22
  }
13
23
  interface GetAllDesignSystemsOpts {
14
- /**
15
- * If true, only design systems that the user has permission to edit will be
16
- * returned. If false, all design systems that the user has permission to edit
17
- * as well as design systems that the user has permission to read but not edit
18
- * will be returned. Defaults to false.
19
- */
20
- onlyEditAccess?: boolean;
21
- /**
22
- * If true, design systems that are scoped to the global space will be included.
23
- * Defaults to false.
24
- */
25
- includeGlobalScopeDesignSystems?: boolean;
26
- /**
27
- * If true, the # of component docs in each design system will also be returned.
28
- * Defaults to false.
29
- */
30
- includeDocumentCount?: boolean;
24
+ /**
25
+ * If true, only design systems that the user has permission to edit will be
26
+ * returned. If false, all design systems that the user has permission to edit
27
+ * as well as design systems that the user has permission to read but not edit
28
+ * will be returned. Defaults to false.
29
+ */
30
+ onlyEditAccess?: boolean;
31
+ /**
32
+ * If true, design systems that are scoped to the global space will be included.
33
+ * Defaults to false.
34
+ */
35
+ includeGlobalScopeDesignSystems?: boolean;
36
+ /**
37
+ * If true, the # of component docs in each design system will also be returned.
38
+ * Defaults to false.
39
+ */
40
+ includeDocumentCount?: boolean;
31
41
  }
32
- export declare const promptForDesignSystemScope: (credentials: Credentials, userSettings: UserSettings | null, selectedScope?: DesignSystemScope) => Promise<DesignSystemScope | undefined>;
33
- export declare const parseDesignSystem: (sys: DevToolsSys, designSystemPackage?: string) => Promise<{
34
- name: any;
35
- version: string | undefined;
42
+ export declare const promptForDesignSystemScope: (
43
+ credentials: Credentials,
44
+ userSettings: UserSettings | null,
45
+ selectedScope?: DesignSystemScope,
46
+ ) => Promise<DesignSystemScope | undefined>;
47
+ export declare const parseDesignSystem: (
48
+ sys: DevToolsSys,
49
+ designSystemPackage?: string,
50
+ ) => Promise<{
51
+ name: any;
52
+ version: string | undefined;
36
53
  }>;
37
- export declare const storeComponentDocs: (credentials: Credentials, body: IndexDocumentV1, debug?: boolean) => Promise<any>;
38
- export declare const runCodeGen: (sys: DevToolsSys, credentials: Credentials, sessionId: string, message: GenerateUserMessage, debug?: boolean, designSystemPackage?: string, workspaceConfig?: WorkspaceConfiguration, opts?: {
39
- tags?: object;
40
- maxTokens?: number;
41
- retriesAllowed?: number;
42
- /**
43
- * What kind of file to expect from the LLM.
44
- * `'tool'`: The LLM will use the Write tool to output the file. We will intercept that
45
- * and keep the file contents in-memory. File is not written to disk.
46
- * `string`: The LLM will write the file directly to the file system. We will read the
47
- * contents into memory and then delete the file from the file system. This is useful
48
- * for writing large files that would otherwise consume a lot of tokens.
49
- */
50
- expectFile?: "tool" | string;
51
- /**
52
- * Glob pattern(s) to include for access control.
53
- * When specified, only these patterns will be accessible by default.
54
- * Can be a single string or array of strings.
55
- */
56
- include?: string | string[];
57
- /**
58
- * Glob pattern(s) to exclude for access control.
59
- * These patterns will be denied access even if included.
60
- * Can be a single string or array of strings.
61
- */
62
- exclude?: string | string[];
63
- /**
64
- * Extra instructions to be taken into account during repo indexing.
65
- */
66
- instructions?: string;
67
- /**
68
- * Privacy mode settings for encryption key handling.
69
- */
70
- privacyMode?: PrivacyMode;
71
- }, metadata?: any) => Promise<string>;
54
+ export declare const storeComponentDocs: (
55
+ credentials: Credentials,
56
+ body: IndexDocumentV1,
57
+ debug?: boolean,
58
+ ) => Promise<any>;
59
+ export declare const runCodeGen: (
60
+ sys: DevToolsSys,
61
+ credentials: Credentials,
62
+ sessionId: string,
63
+ message: GenerateUserMessage,
64
+ debug?: boolean,
65
+ designSystemPackage?: string,
66
+ workspaceConfig?: WorkspaceConfiguration,
67
+ opts?: {
68
+ tags?: object;
69
+ maxTokens?: number;
70
+ retriesAllowed?: number;
71
+ /**
72
+ * What kind of file to expect from the LLM.
73
+ * `'tool'`: The LLM will use the Write tool to output the file. We will intercept that
74
+ * and keep the file contents in-memory. File is not written to disk.
75
+ * `string`: The LLM will write the file directly to the file system. We will read the
76
+ * contents into memory and then delete the file from the file system. This is useful
77
+ * for writing large files that would otherwise consume a lot of tokens.
78
+ */
79
+ expectFile?: "tool" | string;
80
+ /**
81
+ * Glob pattern(s) to include for access control.
82
+ * When specified, only these patterns will be accessible by default.
83
+ * Can be a single string or array of strings.
84
+ */
85
+ include?: string | string[];
86
+ /**
87
+ * Glob pattern(s) to exclude for access control.
88
+ * These patterns will be denied access even if included.
89
+ * Can be a single string or array of strings.
90
+ */
91
+ exclude?: string | string[];
92
+ /**
93
+ * Extra instructions to be taken into account during repo indexing.
94
+ */
95
+ instructions?: string;
96
+ /**
97
+ * Privacy mode settings for encryption key handling.
98
+ */
99
+ privacyMode?: PrivacyMode;
100
+ },
101
+ metadata?: any,
102
+ ) => Promise<string>;
72
103
  /**
73
104
  * Generates an ACL policy for repo indexing based on include/exclude patterns.
74
105
  *
@@ -90,24 +121,52 @@ export declare const runCodeGen: (sys: DevToolsSys, credentials: Credentials, se
90
121
  * const policy2 = generateRepoIndexingAclPolicy("src/**\/*", "dist/**");
91
122
  * ```
92
123
  */
93
- export declare const generateRepoIndexingAclPolicy: (include?: string | string[], exclude?: string | string[]) => AclPolicy;
94
- export declare function getAllDesignSystems(credentials: Credentials, opts: {
95
- includeDocumentCount: true;
96
- } & Omit<GetAllDesignSystemsOpts, "includeDocumentCount">): Promise<DisplayDesignSystem[]>;
97
- export declare function getAllDesignSystems(credentials: Credentials, opts?: GetAllDesignSystemsOpts): Promise<DesignSystem[]>;
98
- export declare const getDesignSystemsByScope: (scope: DesignSystemScope, designSystems: DesignSystem[]) => DesignSystem[];
99
- export declare const getDesignSystemByName: (designSystemName: string, designSystems: DesignSystem[]) => DesignSystem | null;
100
- export declare const getDesignSystemByNameAndScope: (credentials: Credentials, designSystemName: string, scope: DesignSystemScope, designSystems: DesignSystem[]) => DesignSystem | null;
101
- export declare const addDesignSystem: (credentials: Credentials, body: {
102
- designSystemName: string;
103
- designSystemVersion?: string;
104
- designSystemPackage?: string;
105
- status: string;
106
- scope: DesignSystemScope;
107
- gitOriginUrl: string | undefined;
108
- gitRelativePath: string | undefined;
109
- cliArgs: string[];
110
- }) => Promise<any>;
111
- export declare const updateDesignSystem: (credentials: Credentials, body: UpdateDesignSystemInput) => Promise<any>;
112
- export declare const checkRepoIndexingFolder: (sys: DevToolsSys) => Promise<boolean>;
124
+ export declare const generateRepoIndexingAclPolicy: (
125
+ include?: string | string[],
126
+ exclude?: string | string[],
127
+ ) => AclPolicy;
128
+ export declare function getAllDesignSystems(
129
+ credentials: Credentials,
130
+ opts: {
131
+ includeDocumentCount: true;
132
+ } & Omit<GetAllDesignSystemsOpts, "includeDocumentCount">,
133
+ ): Promise<DisplayDesignSystem[]>;
134
+ export declare function getAllDesignSystems(
135
+ credentials: Credentials,
136
+ opts?: GetAllDesignSystemsOpts,
137
+ ): Promise<DesignSystem[]>;
138
+ export declare const getDesignSystemsByScope: (
139
+ scope: DesignSystemScope,
140
+ designSystems: DesignSystem[],
141
+ ) => DesignSystem[];
142
+ export declare const getDesignSystemByName: (
143
+ designSystemName: string,
144
+ designSystems: DesignSystem[],
145
+ ) => DesignSystem | null;
146
+ export declare const getDesignSystemByNameAndScope: (
147
+ credentials: Credentials,
148
+ designSystemName: string,
149
+ scope: DesignSystemScope,
150
+ designSystems: DesignSystem[],
151
+ ) => DesignSystem | null;
152
+ export declare const addDesignSystem: (
153
+ credentials: Credentials,
154
+ body: {
155
+ designSystemName: string;
156
+ designSystemVersion?: string;
157
+ designSystemPackage?: string;
158
+ status: string;
159
+ scope: DesignSystemScope;
160
+ gitOriginUrl: string | undefined;
161
+ gitRelativePath: string | undefined;
162
+ cliArgs: string[];
163
+ },
164
+ ) => Promise<any>;
165
+ export declare const updateDesignSystem: (
166
+ credentials: Credentials,
167
+ body: UpdateDesignSystemInput,
168
+ ) => Promise<any>;
169
+ export declare const checkRepoIndexingFolder: (
170
+ sys: DevToolsSys,
171
+ ) => Promise<boolean>;
113
172
  export {};
@@ -2,23 +2,43 @@ import type { DevToolsSys } from "../../types";
2
2
  import type { CLIArgs } from "../index";
3
3
  import { type Credentials } from "../credentials";
4
4
  import type { ComponentTask, TokenTask } from "./types";
5
- 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;
5
+ export declare const displayComponentLibrarySummary: (
6
+ components: ComponentTask[],
7
+ indexedComponents: ComponentTask[],
8
+ startTime: number,
9
+ failedComponents: string[] | undefined,
10
+ isForce: boolean | undefined,
11
+ designSystemName: string,
12
+ designSystemId?: string,
13
+ numIconsIndexed?: number,
14
+ tokenGroupsFound?: TokenTask[],
15
+ tokenGroupsToIndex?: TokenTask[],
16
+ tokenGroupsFailed?: string[],
17
+ ) => void;
6
18
  export interface RepoIndexingDoc {
7
- name: string;
8
- content: string | {
9
- name: string;
10
- description: string;
11
- components: string[];
12
- relevantFiles: string[];
13
- }[];
14
- createdDate: string;
15
- description: string;
16
- id: string;
17
- ownerId: string;
18
- userId: string;
19
+ name: string;
20
+ content:
21
+ | string
22
+ | {
23
+ name: string;
24
+ description: string;
25
+ components: string[];
26
+ relevantFiles: string[];
27
+ }[];
28
+ createdDate: string;
29
+ description: string;
30
+ id: string;
31
+ ownerId: string;
32
+ userId: string;
19
33
  }
20
- export declare const runRepoIndexing: (sys: DevToolsSys, args: CLIArgs) => Promise<void>;
21
- export declare const isFeatureAllowed: (credentials: Credentials, debug?: boolean) => Promise<{
22
- isAllowed: boolean;
23
- reason?: string;
34
+ export declare const runRepoIndexing: (
35
+ sys: DevToolsSys,
36
+ args: CLIArgs,
37
+ ) => Promise<void>;
38
+ export declare const isFeatureAllowed: (
39
+ credentials: Credentials,
40
+ debug?: boolean,
41
+ ) => Promise<{
42
+ isAllowed: boolean;
43
+ reason?: string;
24
44
  }>;
@@ -1,5 +1,5 @@
1
1
  export declare const mockDeps: {
2
- getStoredComponentDocs: () => Promise<never[]>;
3
- storeComponentDocs: () => Promise<{}>;
4
- runCodeGen: () => Promise<string>;
2
+ getStoredComponentDocs: () => Promise<never[]>;
3
+ storeComponentDocs: () => Promise<{}>;
4
+ runCodeGen: () => Promise<string>;
5
5
  };
@@ -1,28 +1,47 @@
1
1
  import type { DevToolsSys } from "../../types";
2
2
  import type { TokenTask } from "./types";
3
3
  import type { Credentials } from "../credentials";
4
- import type { WorkspaceConfiguration, TokenDocument, PrivacyMode } from "$/ai-utils";
5
- export declare const discoverTokens: (sys: DevToolsSys, credentials: Credentials, sessionId: string, remoteTokens: TokenDocument[], opts?: {
6
- force?: boolean;
7
- designSystemPackage?: string;
8
- workspaceConfig?: WorkspaceConfiguration;
9
- debug?: boolean;
10
- include?: string | string[];
11
- exclude?: string | string[];
12
- instructions?: string;
13
- privacyMode?: PrivacyMode;
14
- }) => Promise<{
15
- tokenGroupsToIndex: TokenTask[];
16
- discoveredTokenGroups: TokenTask[];
17
- } | undefined>;
18
- export declare const processTokens: (sys: DevToolsSys, credentials: Credentials, sessionId: string, group: TokenTask, opts: {
19
- designSystemId: string;
20
- designSystemPackage?: string;
21
- designSystemVersion?: string;
22
- debug?: boolean;
23
- workspaceConfig?: WorkspaceConfiguration;
24
- include?: string | string[];
25
- exclude?: string | string[];
26
- instructions?: string;
27
- privacyMode?: PrivacyMode;
28
- }) => Promise<void>;
4
+ import type {
5
+ WorkspaceConfiguration,
6
+ TokenDocument,
7
+ PrivacyMode,
8
+ } from "$/ai-utils";
9
+ export declare const discoverTokens: (
10
+ sys: DevToolsSys,
11
+ credentials: Credentials,
12
+ sessionId: string,
13
+ remoteTokens: TokenDocument[],
14
+ opts?: {
15
+ force?: boolean;
16
+ designSystemPackage?: string;
17
+ workspaceConfig?: WorkspaceConfiguration;
18
+ debug?: boolean;
19
+ include?: string | string[];
20
+ exclude?: string | string[];
21
+ instructions?: string;
22
+ privacyMode?: PrivacyMode;
23
+ },
24
+ ) => Promise<
25
+ | {
26
+ tokenGroupsToIndex: TokenTask[];
27
+ discoveredTokenGroups: TokenTask[];
28
+ }
29
+ | undefined
30
+ >;
31
+ export declare const processTokens: (
32
+ sys: DevToolsSys,
33
+ credentials: Credentials,
34
+ sessionId: string,
35
+ group: TokenTask,
36
+ opts: {
37
+ designSystemId: string;
38
+ designSystemPackage?: string;
39
+ designSystemVersion?: string;
40
+ debug?: boolean;
41
+ workspaceConfig?: WorkspaceConfiguration;
42
+ include?: string | string[];
43
+ exclude?: string | string[];
44
+ instructions?: string;
45
+ privacyMode?: PrivacyMode;
46
+ },
47
+ ) => Promise<void>;
@@ -15,6 +15,8 @@ export interface TokenTask extends BaseTask {
15
15
  type: "token";
16
16
  relevantFiles: string[];
17
17
  tokens: string[];
18
+ /** Map of token name to its default value (e.g., "--spacing-1": "4px") */
19
+ tokenValues?: Record<string, string>;
18
20
  hash: string;
19
21
  }
20
22
  export interface IconTask extends BaseTask {
@@ -10,14 +10,16 @@ export declare function safeReadFile(filePath: string): string | null;
10
10
  * Package manager information
11
11
  */
12
12
  export interface PackageManagerInfo {
13
- manager: "npm" | "yarn" | "pnpm" | "bun";
14
- setupCommand: string;
13
+ manager: "npm" | "yarn" | "pnpm" | "bun";
14
+ setupCommand: string;
15
15
  }
16
16
  /**
17
17
  * Detect the package manager at the root level based on lock files
18
18
  * Returns the specific package manager command for setup
19
19
  */
20
- export declare function detectRootPackageManager(files: string[]): PackageManagerInfo | null;
20
+ export declare function detectRootPackageManager(
21
+ files: string[],
22
+ ): PackageManagerInfo | null;
21
23
  /**
22
24
  * Check if a file exists at the root level
23
25
  */
@@ -25,8 +27,14 @@ export declare function hasRootFile(files: string[], fileName: string): boolean;
25
27
  /**
26
28
  * Check if any file matches a pattern at the root level
27
29
  */
28
- export declare function hasRootFileMatching(files: string[], predicate: (fileName: string) => boolean): boolean;
30
+ export declare function hasRootFileMatching(
31
+ files: string[],
32
+ predicate: (fileName: string) => boolean,
33
+ ): boolean;
29
34
  /**
30
35
  * Check if a directory exists at the root level
31
36
  */
32
- export declare function hasRootDirectory(files: string[], directoryName: string): boolean;
37
+ export declare function hasRootDirectory(
38
+ files: string[],
39
+ directoryName: string,
40
+ ): boolean;
@@ -15,4 +15,7 @@ export declare function isExactVersion(version: string | undefined): boolean;
15
15
  * @param basePath - Absolute path to the repository root
16
16
  * @param rootPath - Relative path within the repository to analyze (default: "/" for entire repo)
17
17
  */
18
- export declare function collectRepoMetrics(sys: DevToolsSys, basePath: string): Promise<RepoMetrics>;
18
+ export declare function collectRepoMetrics(
19
+ sys: DevToolsSys,
20
+ basePath: string,
21
+ ): Promise<RepoMetrics>;
@@ -1,54 +1,81 @@
1
1
  import type { FigmaComponentInfo } from "$/ai-utils";
2
2
  import type { CLIArgs } from "..";
3
3
  import type { DevToolsSys } from "../../core";
4
- import type { PublishedComponent, PublishedComponentSet } from "@figma/rest-api-spec";
4
+ import type {
5
+ PublishedComponent,
6
+ PublishedComponentSet,
7
+ } from "@figma/rest-api-spec";
5
8
  type Context = {
6
- sys: DevToolsSys;
7
- args: CLIArgs;
8
- debug: (msg: unknown) => void;
9
- figmaAuth: {
10
- access_token: string;
11
- oauth: boolean;
12
- };
9
+ sys: DevToolsSys;
10
+ args: CLIArgs;
11
+ debug: (msg: unknown) => void;
12
+ figmaAuth: {
13
+ access_token: string;
14
+ oauth: boolean;
15
+ };
13
16
  };
14
17
  /**
15
18
  * A component or component set
16
19
  */
17
20
  type FigmaTeamComponent = {
18
- /** The unique identifier for the component. */
19
- key: string;
20
- /** The unique identifier of the Figma file that contains the component. */
21
- file_key: string;
22
- /** The unique identifier of the component node within the Figma file. */
23
- node_id: string;
24
- /** A URL to a thumbnail image of the component. */
25
- thumbnail_url?: string;
26
- /** The name of the component. */
27
- name: string;
28
- /** The description of the component as entered by the publisher. */
29
- description: string;
30
- /** The component data. */
31
- componentData?: FigmaComponentInfo;
32
- /** Whether the component is published. */
33
- isPublished?: boolean;
21
+ /** The unique identifier for the component. */
22
+ key: string;
23
+ /** The unique identifier of the Figma file that contains the component. */
24
+ file_key: string;
25
+ /** The unique identifier of the component node within the Figma file. */
26
+ node_id: string;
27
+ /** A URL to a thumbnail image of the component. */
28
+ thumbnail_url?: string;
29
+ /** The name of the component. */
30
+ name: string;
31
+ /** The description of the component as entered by the publisher. */
32
+ description: string;
33
+ /** The component data. */
34
+ componentData?: FigmaComponentInfo;
35
+ /** Whether the component is published. */
36
+ isPublished?: boolean;
34
37
  };
35
38
  export declare function extractFigmaIds(url: string): {
36
- teamId?: string;
37
- fileKey?: string;
38
- nodeId?: string;
39
+ teamId?: string;
40
+ fileKey?: string;
41
+ nodeId?: string;
39
42
  };
40
- export declare function fetchTeamComponents(context: Context, teamId: string, onProgress: () => void): Promise<PublishedComponent[]>;
41
- export declare function fetchTeamComponentSets(context: Context, teamId: string, onProgress: () => void): Promise<PublishedComponentSet[]>;
43
+ export declare function fetchTeamComponents(
44
+ context: Context,
45
+ teamId: string,
46
+ onProgress: () => void,
47
+ ): Promise<PublishedComponent[]>;
48
+ export declare function fetchTeamComponentSets(
49
+ context: Context,
50
+ teamId: string,
51
+ onProgress: () => void,
52
+ ): Promise<PublishedComponentSet[]>;
42
53
  /**
43
54
  * Returns a list of components and component sets that are present in the file or selection as
44
55
  * well as a set of remote keys for components that are referenced but not present.
45
56
  */
46
- export declare function processFileOrSelection(context: Context, fileKey: string, nodeId?: string): Promise<{
47
- fileComponents: FigmaTeamComponent[];
48
- remoteKeys: Set<string>;
57
+ export declare function processFileOrSelection(
58
+ context: Context,
59
+ fileKey: string,
60
+ nodeId?: string,
61
+ ): Promise<{
62
+ fileComponents: FigmaTeamComponent[];
63
+ remoteKeys: Set<string>;
49
64
  }>;
50
- export declare function fetchRemoteComponentData(context: Context, remoteKeys: Set<string>): Promise<(FigmaTeamComponent | undefined)[]>;
51
- export declare function resolveComponentData(context: Context, components: FigmaTeamComponent[]): Promise<FigmaTeamComponent[]>;
52
- export declare function generateComponentReport(component: FigmaTeamComponent, baseDir: string): Promise<void>;
53
- export declare const runFigmaReport: (sys: DevToolsSys, args: CLIArgs) => Promise<void>;
65
+ export declare function fetchRemoteComponentData(
66
+ context: Context,
67
+ remoteKeys: Set<string>,
68
+ ): Promise<(FigmaTeamComponent | undefined)[]>;
69
+ export declare function resolveComponentData(
70
+ context: Context,
71
+ components: FigmaTeamComponent[],
72
+ ): Promise<FigmaTeamComponent[]>;
73
+ export declare function generateComponentReport(
74
+ component: FigmaTeamComponent,
75
+ baseDir: string,
76
+ ): Promise<void>;
77
+ export declare const runFigmaReport: (
78
+ sys: DevToolsSys,
79
+ args: CLIArgs,
80
+ ) => Promise<void>;
54
81
  export {};
@@ -3,48 +3,56 @@ import type { IncomingMessage } from "node:http";
3
3
  import type { ServerOptions } from "ws";
4
4
  import type { WebSocket } from "ws";
5
5
  export interface SocketRequest {
6
- id: number;
7
- jsonrpc: string;
8
- method: string;
9
- params: any;
6
+ id: number;
7
+ jsonrpc: string;
8
+ method: string;
9
+ params: any;
10
10
  }
11
11
  export interface SocketResponse<T = any> {
12
- id?: number | null;
13
- jsonrpc: string;
14
- result?: T;
15
- notification?: string;
16
- params?: any;
17
- error?: {
18
- code: number;
19
- message: string;
20
- data?: any;
21
- };
12
+ id?: number | null;
13
+ jsonrpc: string;
14
+ result?: T;
15
+ notification?: string;
16
+ params?: any;
17
+ error?: {
18
+ code: number;
19
+ message: string;
20
+ data?: any;
21
+ };
22
22
  }
23
23
  export interface SocketSendOptions {
24
- timeout?: number;
24
+ timeout?: number;
25
25
  }
26
26
  export interface SocketQueue {
27
- type: "request" | "notification";
28
- result?: SocketResponse["result"];
29
- error?: SocketResponse["error"];
27
+ type: "request" | "notification";
28
+ result?: SocketResponse["result"];
29
+ error?: SocketResponse["error"];
30
30
  }
31
31
  type RegisterFn<T = any> = (params: T, socketId: string) => Promise<any> | any;
32
32
  interface SocketEvents {
33
- listening: () => Promise<void> | void;
34
- connection: (socket: WebSocket, socketId: string) => Promise<void> | void;
35
- disconnection: (socketId: string) => Promise<void> | void;
36
- error: (error: Error) => Promise<void> | void;
37
- "socket-error": (socketId: string, error: Error) => Promise<void> | void;
38
- close: () => Promise<void> | void;
33
+ listening: () => Promise<void> | void;
34
+ connection: (socket: WebSocket, socketId: string) => Promise<void> | void;
35
+ disconnection: (socketId: string) => Promise<void> | void;
36
+ error: (error: Error) => Promise<void> | void;
37
+ "socket-error": (socketId: string, error: Error) => Promise<void> | void;
38
+ close: () => Promise<void> | void;
39
39
  }
40
40
  export declare function RPCWebSocketServer(opts: ServerOptions): {
41
- on: <EventKey extends keyof SocketEvents>(event: EventKey, cb: SocketEvents[EventKey]) => void;
42
- event: (e: string) => void;
43
- handleUpgrade: (req: IncomingMessage, socket: Duplex, upgradeHead: Buffer, callback?: (client: WebSocket, request: IncomingMessage) => void) => Promise<void>;
44
- clients: () => Map<string, WebSocket>;
45
- register: <T = any>(method: string, fn: RegisterFn<T>) => void;
46
- emit: (name: string, ...params: any[]) => void;
47
- notify: (name: string, socketId: string, ...params: any[]) => void;
48
- close: () => Promise<unknown>;
41
+ on: <EventKey extends keyof SocketEvents>(
42
+ event: EventKey,
43
+ cb: SocketEvents[EventKey],
44
+ ) => void;
45
+ event: (e: string) => void;
46
+ handleUpgrade: (
47
+ req: IncomingMessage,
48
+ socket: Duplex,
49
+ upgradeHead: Buffer,
50
+ callback?: (client: WebSocket, request: IncomingMessage) => void,
51
+ ) => Promise<void>;
52
+ clients: () => Map<string, WebSocket>;
53
+ register: <T = any>(method: string, fn: RegisterFn<T>) => void;
54
+ emit: (name: string, ...params: any[]) => void;
55
+ notify: (name: string, socketId: string, ...params: any[]) => void;
56
+ close: () => Promise<unknown>;
49
57
  };
50
58
  export {};