@sun-asterisk/sungen 1.0.24 → 2.0.1

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 (378) hide show
  1. package/README.md +198 -74
  2. package/dist/cli/commands/add.d.ts.map +1 -1
  3. package/dist/cli/commands/add.js +5 -3
  4. package/dist/cli/commands/add.js.map +1 -1
  5. package/dist/cli/commands/generate.d.ts.map +1 -1
  6. package/dist/cli/commands/generate.js +110 -35
  7. package/dist/cli/commands/generate.js.map +1 -1
  8. package/dist/cli/index.d.ts +2 -2
  9. package/dist/cli/index.js +5 -16
  10. package/dist/cli/index.js.map +1 -1
  11. package/dist/generators/test-generator/adapters/playwright/templates/steps/actions/frame-enter-action.hbs +1 -0
  12. package/dist/generators/test-generator/adapters/playwright/templates/steps/actions/frame-exit-action.hbs +1 -0
  13. package/dist/generators/test-generator/adapters/playwright/templates/steps/actions/keyboard-global-action.hbs +1 -0
  14. package/dist/generators/test-generator/adapters/playwright/templates/steps/actions/scroll-action.hbs +1 -0
  15. package/dist/generators/test-generator/adapters/playwright/templates/steps/actions/table-action-in-row.hbs +2 -0
  16. package/dist/generators/test-generator/adapters/playwright/templates/steps/assertions/table-cell-by-filter.hbs +3 -0
  17. package/dist/generators/test-generator/adapters/playwright/templates/steps/assertions/table-cell-by-index.hbs +3 -0
  18. package/dist/generators/test-generator/adapters/playwright/templates/steps/assertions/table-column-exists.hbs +2 -0
  19. package/dist/generators/test-generator/adapters/playwright/templates/steps/assertions/table-empty.hbs +2 -0
  20. package/dist/generators/test-generator/adapters/playwright/templates/steps/assertions/table-row-count.hbs +2 -0
  21. package/dist/generators/test-generator/adapters/playwright/templates/steps/assertions/table-row-exists.hbs +2 -0
  22. package/dist/generators/test-generator/adapters/playwright/templates/steps/assertions/table-row-not-exists.hbs +2 -0
  23. package/dist/generators/test-generator/adapters/playwright/templates/steps/assertions/visible-with-value-assertion.hbs +1 -1
  24. package/dist/generators/test-generator/adapters/playwright/templates/steps/partials/locator-base.hbs +11 -2
  25. package/dist/generators/test-generator/adapters/playwright/templates/steps/partials/locator.hbs +11 -2
  26. package/dist/generators/test-generator/code-generator.d.ts +0 -1
  27. package/dist/generators/test-generator/code-generator.d.ts.map +1 -1
  28. package/dist/generators/test-generator/code-generator.js +10 -47
  29. package/dist/generators/test-generator/code-generator.js.map +1 -1
  30. package/dist/generators/test-generator/patterns/assertion-patterns.d.ts.map +1 -1
  31. package/dist/generators/test-generator/patterns/assertion-patterns.js +2 -0
  32. package/dist/generators/test-generator/patterns/assertion-patterns.js.map +1 -1
  33. package/dist/generators/test-generator/patterns/index.d.ts +4 -1
  34. package/dist/generators/test-generator/patterns/index.d.ts.map +1 -1
  35. package/dist/generators/test-generator/patterns/index.js +17 -5
  36. package/dist/generators/test-generator/patterns/index.js.map +1 -1
  37. package/dist/generators/test-generator/patterns/interaction-patterns.js +1 -1
  38. package/dist/generators/test-generator/patterns/interaction-patterns.js.map +1 -1
  39. package/dist/generators/test-generator/patterns/keyboard-patterns.d.ts +7 -0
  40. package/dist/generators/test-generator/patterns/keyboard-patterns.d.ts.map +1 -0
  41. package/dist/generators/test-generator/patterns/keyboard-patterns.js +47 -0
  42. package/dist/generators/test-generator/patterns/keyboard-patterns.js.map +1 -0
  43. package/dist/generators/test-generator/patterns/scope-patterns.d.ts +7 -0
  44. package/dist/generators/test-generator/patterns/scope-patterns.d.ts.map +1 -0
  45. package/dist/generators/test-generator/patterns/scope-patterns.js +36 -0
  46. package/dist/generators/test-generator/patterns/scope-patterns.js.map +1 -0
  47. package/dist/generators/test-generator/patterns/scroll-patterns.d.ts +7 -0
  48. package/dist/generators/test-generator/patterns/scroll-patterns.d.ts.map +1 -0
  49. package/dist/generators/test-generator/patterns/scroll-patterns.js +25 -0
  50. package/dist/generators/test-generator/patterns/scroll-patterns.js.map +1 -0
  51. package/dist/generators/test-generator/patterns/table-patterns.d.ts +7 -0
  52. package/dist/generators/test-generator/patterns/table-patterns.d.ts.map +1 -0
  53. package/dist/generators/test-generator/patterns/table-patterns.js +192 -0
  54. package/dist/generators/test-generator/patterns/table-patterns.js.map +1 -0
  55. package/dist/generators/test-generator/step-mapper.d.ts +5 -3
  56. package/dist/generators/test-generator/step-mapper.d.ts.map +1 -1
  57. package/dist/generators/test-generator/step-mapper.js +38 -27
  58. package/dist/generators/test-generator/step-mapper.js.map +1 -1
  59. package/dist/generators/test-generator/template-engine.d.ts.map +1 -1
  60. package/dist/generators/test-generator/template-engine.js +4 -1
  61. package/dist/generators/test-generator/template-engine.js.map +1 -1
  62. package/dist/generators/test-generator/types.d.ts +7 -24
  63. package/dist/generators/test-generator/types.d.ts.map +1 -1
  64. package/dist/generators/test-generator/types.js +2 -101
  65. package/dist/generators/test-generator/types.js.map +1 -1
  66. package/dist/generators/test-generator/utils/selector-resolver.d.ts +14 -0
  67. package/dist/generators/test-generator/utils/selector-resolver.d.ts.map +1 -1
  68. package/dist/generators/test-generator/utils/selector-resolver.js +37 -11
  69. package/dist/generators/test-generator/utils/selector-resolver.js.map +1 -1
  70. package/dist/orchestrator/project-initializer.d.ts +12 -0
  71. package/dist/orchestrator/project-initializer.d.ts.map +1 -1
  72. package/dist/orchestrator/project-initializer.js +72 -160
  73. package/dist/orchestrator/project-initializer.js.map +1 -1
  74. package/dist/orchestrator/screen-manager.d.ts +1 -32
  75. package/dist/orchestrator/screen-manager.d.ts.map +1 -1
  76. package/dist/orchestrator/screen-manager.js +55 -216
  77. package/dist/orchestrator/screen-manager.js.map +1 -1
  78. package/dist/orchestrator/templates/ai-rules.md +189 -0
  79. package/dist/orchestrator/templates/gitignore +16 -0
  80. package/dist/orchestrator/templates/playwright.config.d.ts +10 -0
  81. package/dist/orchestrator/templates/playwright.config.d.ts.map +1 -0
  82. package/dist/orchestrator/templates/playwright.config.js +77 -0
  83. package/dist/orchestrator/templates/playwright.config.js.map +1 -0
  84. package/dist/orchestrator/templates/playwright.config.ts +80 -0
  85. package/dist/orchestrator/templates/readme.md +197 -0
  86. package/dist/utils/selector-types.d.ts +1 -1
  87. package/dist/utils/selector-types.d.ts.map +1 -1
  88. package/dist/utils/selector-types.js +3 -0
  89. package/dist/utils/selector-types.js.map +1 -1
  90. package/docs/gherkin standards/gherkin-core-standard.md +377 -0
  91. package/docs/gherkin standards/gherkin-core-standard.vi.md +303 -0
  92. package/docs/gherkin-dictionary.md +1071 -0
  93. package/docs/makeauth.md +225 -0
  94. package/package.json +4 -3
  95. package/src/cli/commands/add.ts +5 -3
  96. package/src/cli/commands/generate.ts +90 -38
  97. package/src/cli/index.ts +5 -16
  98. package/src/generators/test-generator/adapters/playwright/templates/steps/actions/frame-enter-action.hbs +1 -0
  99. package/src/generators/test-generator/adapters/playwright/templates/steps/actions/frame-exit-action.hbs +1 -0
  100. package/src/generators/test-generator/adapters/playwright/templates/steps/actions/keyboard-global-action.hbs +1 -0
  101. package/src/generators/test-generator/adapters/playwright/templates/steps/actions/scroll-action.hbs +1 -0
  102. package/src/generators/test-generator/adapters/playwright/templates/steps/actions/table-action-in-row.hbs +2 -0
  103. package/src/generators/test-generator/adapters/playwright/templates/steps/assertions/table-cell-by-filter.hbs +3 -0
  104. package/src/generators/test-generator/adapters/playwright/templates/steps/assertions/table-cell-by-index.hbs +3 -0
  105. package/src/generators/test-generator/adapters/playwright/templates/steps/assertions/table-column-exists.hbs +2 -0
  106. package/src/generators/test-generator/adapters/playwright/templates/steps/assertions/table-empty.hbs +2 -0
  107. package/src/generators/test-generator/adapters/playwright/templates/steps/assertions/table-row-count.hbs +2 -0
  108. package/src/generators/test-generator/adapters/playwright/templates/steps/assertions/table-row-exists.hbs +2 -0
  109. package/src/generators/test-generator/adapters/playwright/templates/steps/assertions/table-row-not-exists.hbs +2 -0
  110. package/src/generators/test-generator/adapters/playwright/templates/steps/assertions/visible-with-value-assertion.hbs +1 -1
  111. package/src/generators/test-generator/adapters/playwright/templates/steps/partials/locator-base.hbs +11 -2
  112. package/src/generators/test-generator/adapters/playwright/templates/steps/partials/locator.hbs +11 -2
  113. package/src/generators/test-generator/code-generator.ts +11 -59
  114. package/src/generators/test-generator/patterns/assertion-patterns.ts +2 -0
  115. package/src/generators/test-generator/patterns/index.ts +12 -3
  116. package/src/generators/test-generator/patterns/interaction-patterns.ts +1 -1
  117. package/src/generators/test-generator/patterns/keyboard-patterns.ts +51 -0
  118. package/src/generators/test-generator/patterns/scope-patterns.ts +40 -0
  119. package/src/generators/test-generator/patterns/scroll-patterns.ts +27 -0
  120. package/src/generators/test-generator/patterns/table-patterns.ts +232 -0
  121. package/src/generators/test-generator/step-mapper.ts +42 -27
  122. package/src/generators/test-generator/template-engine.ts +3 -1
  123. package/src/generators/test-generator/types.ts +7 -112
  124. package/src/generators/test-generator/utils/selector-resolver.ts +70 -25
  125. package/src/orchestrator/project-initializer.ts +75 -160
  126. package/src/orchestrator/screen-manager.ts +61 -233
  127. package/src/orchestrator/templates/ai-rules.md +189 -0
  128. package/src/orchestrator/templates/gitignore +16 -0
  129. package/src/orchestrator/templates/playwright.config.ts +80 -0
  130. package/src/orchestrator/templates/readme.md +197 -0
  131. package/src/utils/selector-types.ts +3 -0
  132. package/dist/cli/commands/cache-clear.d.ts +0 -3
  133. package/dist/cli/commands/cache-clear.d.ts.map +0 -1
  134. package/dist/cli/commands/cache-clear.js +0 -24
  135. package/dist/cli/commands/cache-clear.js.map +0 -1
  136. package/dist/cli/commands/full.d.ts +0 -3
  137. package/dist/cli/commands/full.d.ts.map +0 -1
  138. package/dist/cli/commands/full.js +0 -37
  139. package/dist/cli/commands/full.js.map +0 -1
  140. package/dist/cli/commands/live-scan.d.ts +0 -3
  141. package/dist/cli/commands/live-scan.d.ts.map +0 -1
  142. package/dist/cli/commands/live-scan.js +0 -78
  143. package/dist/cli/commands/live-scan.js.map +0 -1
  144. package/dist/cli/commands/map.d.ts +0 -3
  145. package/dist/cli/commands/map.d.ts.map +0 -1
  146. package/dist/cli/commands/map.js +0 -93
  147. package/dist/cli/commands/map.js.map +0 -1
  148. package/dist/cli/commands/validate.d.ts +0 -3
  149. package/dist/cli/commands/validate.d.ts.map +0 -1
  150. package/dist/cli/commands/validate.js +0 -43
  151. package/dist/cli/commands/validate.js.map +0 -1
  152. package/dist/cli/utils.d.ts +0 -6
  153. package/dist/cli/utils.d.ts.map +0 -1
  154. package/dist/cli/utils.js +0 -101
  155. package/dist/cli/utils.js.map +0 -1
  156. package/dist/config/config-loader.d.ts +0 -51
  157. package/dist/config/config-loader.d.ts.map +0 -1
  158. package/dist/config/config-loader.js +0 -216
  159. package/dist/config/config-loader.js.map +0 -1
  160. package/dist/config/config-schema.d.ts +0 -121
  161. package/dist/config/config-schema.d.ts.map +0 -1
  162. package/dist/config/config-schema.js +0 -7
  163. package/dist/config/config-schema.js.map +0 -1
  164. package/dist/core/live-scanner/config-reader.d.ts +0 -10
  165. package/dist/core/live-scanner/config-reader.d.ts.map +0 -1
  166. package/dist/core/live-scanner/config-reader.js +0 -87
  167. package/dist/core/live-scanner/config-reader.js.map +0 -1
  168. package/dist/core/live-scanner/element-finder.d.ts +0 -20
  169. package/dist/core/live-scanner/element-finder.d.ts.map +0 -1
  170. package/dist/core/live-scanner/element-finder.js +0 -481
  171. package/dist/core/live-scanner/element-finder.js.map +0 -1
  172. package/dist/core/live-scanner/index.d.ts +0 -8
  173. package/dist/core/live-scanner/index.d.ts.map +0 -1
  174. package/dist/core/live-scanner/index.js +0 -33
  175. package/dist/core/live-scanner/index.js.map +0 -1
  176. package/dist/core/live-scanner/matrix-reader.d.ts +0 -17
  177. package/dist/core/live-scanner/matrix-reader.d.ts.map +0 -1
  178. package/dist/core/live-scanner/matrix-reader.js +0 -60
  179. package/dist/core/live-scanner/matrix-reader.js.map +0 -1
  180. package/dist/core/live-scanner/matrix-writer.d.ts +0 -7
  181. package/dist/core/live-scanner/matrix-writer.d.ts.map +0 -1
  182. package/dist/core/live-scanner/matrix-writer.js +0 -103
  183. package/dist/core/live-scanner/matrix-writer.js.map +0 -1
  184. package/dist/core/live-scanner/role-fallback.d.ts +0 -15
  185. package/dist/core/live-scanner/role-fallback.d.ts.map +0 -1
  186. package/dist/core/live-scanner/role-fallback.js +0 -46
  187. package/dist/core/live-scanner/role-fallback.js.map +0 -1
  188. package/dist/core/live-scanner/scanner.d.ts +0 -22
  189. package/dist/core/live-scanner/scanner.d.ts.map +0 -1
  190. package/dist/core/live-scanner/scanner.js +0 -303
  191. package/dist/core/live-scanner/scanner.js.map +0 -1
  192. package/dist/core/live-scanner/step-replayer.d.ts +0 -26
  193. package/dist/core/live-scanner/step-replayer.d.ts.map +0 -1
  194. package/dist/core/live-scanner/step-replayer.js +0 -473
  195. package/dist/core/live-scanner/step-replayer.js.map +0 -1
  196. package/dist/core/live-scanner/types.d.ts +0 -52
  197. package/dist/core/live-scanner/types.d.ts.map +0 -1
  198. package/dist/core/live-scanner/types.js +0 -14
  199. package/dist/core/live-scanner/types.js.map +0 -1
  200. package/dist/core/selector-base/annotation-handler.d.ts +0 -45
  201. package/dist/core/selector-base/annotation-handler.d.ts.map +0 -1
  202. package/dist/core/selector-base/annotation-handler.js +0 -102
  203. package/dist/core/selector-base/annotation-handler.js.map +0 -1
  204. package/dist/core/selector-base/base-generator.d.ts +0 -49
  205. package/dist/core/selector-base/base-generator.d.ts.map +0 -1
  206. package/dist/core/selector-base/base-generator.js +0 -214
  207. package/dist/core/selector-base/base-generator.js.map +0 -1
  208. package/dist/core/selector-base/gherkin-parser.d.ts +0 -24
  209. package/dist/core/selector-base/gherkin-parser.d.ts.map +0 -1
  210. package/dist/core/selector-base/gherkin-parser.js +0 -42
  211. package/dist/core/selector-base/gherkin-parser.js.map +0 -1
  212. package/dist/core/selector-mapper/priority-mapper.d.ts +0 -74
  213. package/dist/core/selector-mapper/priority-mapper.d.ts.map +0 -1
  214. package/dist/core/selector-mapper/priority-mapper.js +0 -477
  215. package/dist/core/selector-mapper/priority-mapper.js.map +0 -1
  216. package/dist/core/ui-scanner/heuristics/base-heuristic.d.ts +0 -91
  217. package/dist/core/ui-scanner/heuristics/base-heuristic.d.ts.map +0 -1
  218. package/dist/core/ui-scanner/heuristics/base-heuristic.js +0 -175
  219. package/dist/core/ui-scanner/heuristics/base-heuristic.js.map +0 -1
  220. package/dist/core/ui-scanner/react-scanner.d.ts +0 -32
  221. package/dist/core/ui-scanner/react-scanner.d.ts.map +0 -1
  222. package/dist/core/ui-scanner/react-scanner.js +0 -163
  223. package/dist/core/ui-scanner/react-scanner.js.map +0 -1
  224. package/dist/core/ui-scanner/scanner-interface.d.ts +0 -94
  225. package/dist/core/ui-scanner/scanner-interface.d.ts.map +0 -1
  226. package/dist/core/ui-scanner/scanner-interface.js +0 -33
  227. package/dist/core/ui-scanner/scanner-interface.js.map +0 -1
  228. package/dist/core/ui-scanner/strict-scanner.d.ts +0 -81
  229. package/dist/core/ui-scanner/strict-scanner.d.ts.map +0 -1
  230. package/dist/core/ui-scanner/strict-scanner.js +0 -511
  231. package/dist/core/ui-scanner/strict-scanner.js.map +0 -1
  232. package/dist/core/validator/data-validator.d.ts +0 -38
  233. package/dist/core/validator/data-validator.d.ts.map +0 -1
  234. package/dist/core/validator/data-validator.js +0 -212
  235. package/dist/core/validator/data-validator.js.map +0 -1
  236. package/dist/core/validator/feature-validator.d.ts +0 -27
  237. package/dist/core/validator/feature-validator.d.ts.map +0 -1
  238. package/dist/core/validator/feature-validator.js +0 -182
  239. package/dist/core/validator/feature-validator.js.map +0 -1
  240. package/dist/core/validator/index.d.ts +0 -46
  241. package/dist/core/validator/index.d.ts.map +0 -1
  242. package/dist/core/validator/index.js +0 -17
  243. package/dist/core/validator/index.js.map +0 -1
  244. package/dist/core/validator/screen-validator.d.ts +0 -35
  245. package/dist/core/validator/screen-validator.d.ts.map +0 -1
  246. package/dist/core/validator/screen-validator.js +0 -195
  247. package/dist/core/validator/screen-validator.js.map +0 -1
  248. package/dist/core/validator/selector-validator.d.ts +0 -36
  249. package/dist/core/validator/selector-validator.d.ts.map +0 -1
  250. package/dist/core/validator/selector-validator.js +0 -210
  251. package/dist/core/validator/selector-validator.js.map +0 -1
  252. package/dist/external/ai-provider.d.ts +0 -60
  253. package/dist/external/ai-provider.d.ts.map +0 -1
  254. package/dist/external/ai-provider.js +0 -30
  255. package/dist/external/ai-provider.js.map +0 -1
  256. package/dist/external/anthropic-provider.d.ts +0 -29
  257. package/dist/external/anthropic-provider.d.ts.map +0 -1
  258. package/dist/external/anthropic-provider.js +0 -85
  259. package/dist/external/anthropic-provider.js.map +0 -1
  260. package/dist/generators/cache/cache-manager.d.ts +0 -66
  261. package/dist/generators/cache/cache-manager.d.ts.map +0 -1
  262. package/dist/generators/cache/cache-manager.js +0 -286
  263. package/dist/generators/cache/cache-manager.js.map +0 -1
  264. package/dist/generators/dsl-writer/index.d.ts +0 -33
  265. package/dist/generators/dsl-writer/index.d.ts.map +0 -1
  266. package/dist/generators/dsl-writer/index.js +0 -226
  267. package/dist/generators/dsl-writer/index.js.map +0 -1
  268. package/dist/generators/scaffold-generator/index.d.ts +0 -162
  269. package/dist/generators/scaffold-generator/index.d.ts.map +0 -1
  270. package/dist/generators/scaffold-generator/index.js +0 -877
  271. package/dist/generators/scaffold-generator/index.js.map +0 -1
  272. package/dist/generators/selector-mapper/ai-mapper.d.ts +0 -56
  273. package/dist/generators/selector-mapper/ai-mapper.d.ts.map +0 -1
  274. package/dist/generators/selector-mapper/ai-mapper.js +0 -457
  275. package/dist/generators/selector-mapper/ai-mapper.js.map +0 -1
  276. package/dist/generators/selector-mapper/hybrid-mapper.d.ts +0 -67
  277. package/dist/generators/selector-mapper/hybrid-mapper.d.ts.map +0 -1
  278. package/dist/generators/selector-mapper/hybrid-mapper.js +0 -349
  279. package/dist/generators/selector-mapper/hybrid-mapper.js.map +0 -1
  280. package/dist/generators/selector-mapper/index.d.ts +0 -8
  281. package/dist/generators/selector-mapper/index.d.ts.map +0 -1
  282. package/dist/generators/selector-mapper/index.js +0 -12
  283. package/dist/generators/selector-mapper/index.js.map +0 -1
  284. package/dist/generators/selector-mapper/intelligent-mapper.d.ts +0 -125
  285. package/dist/generators/selector-mapper/intelligent-mapper.d.ts.map +0 -1
  286. package/dist/generators/selector-mapper/intelligent-mapper.js +0 -391
  287. package/dist/generators/selector-mapper/intelligent-mapper.js.map +0 -1
  288. package/dist/generators/test-generator/ai-step-mapper.d.ts +0 -27
  289. package/dist/generators/test-generator/ai-step-mapper.d.ts.map +0 -1
  290. package/dist/generators/test-generator/ai-step-mapper.js +0 -204
  291. package/dist/generators/test-generator/ai-step-mapper.js.map +0 -1
  292. package/dist/generators/test-generator/auth-setup-generator.d.ts +0 -18
  293. package/dist/generators/test-generator/auth-setup-generator.d.ts.map +0 -1
  294. package/dist/generators/test-generator/auth-setup-generator.js +0 -82
  295. package/dist/generators/test-generator/auth-setup-generator.js.map +0 -1
  296. package/dist/generators/test-generator/patterns/legacy-patterns.d.ts +0 -7
  297. package/dist/generators/test-generator/patterns/legacy-patterns.d.ts.map +0 -1
  298. package/dist/generators/test-generator/patterns/legacy-patterns.js +0 -98
  299. package/dist/generators/test-generator/patterns/legacy-patterns.js.map +0 -1
  300. package/dist/generators/test-generator/templates/auth-setup.ts.hbs +0 -36
  301. package/dist/generators/ui-model-builder/deep-scanner.d.ts +0 -121
  302. package/dist/generators/ui-model-builder/deep-scanner.d.ts.map +0 -1
  303. package/dist/generators/ui-model-builder/deep-scanner.js +0 -1113
  304. package/dist/generators/ui-model-builder/deep-scanner.js.map +0 -1
  305. package/dist/generators/ui-model-builder/enhanced-deep-scanner.d.ts +0 -110
  306. package/dist/generators/ui-model-builder/enhanced-deep-scanner.d.ts.map +0 -1
  307. package/dist/generators/ui-model-builder/enhanced-deep-scanner.js +0 -608
  308. package/dist/generators/ui-model-builder/enhanced-deep-scanner.js.map +0 -1
  309. package/dist/generators/ui-model-builder/react-scanner.d.ts +0 -107
  310. package/dist/generators/ui-model-builder/react-scanner.d.ts.map +0 -1
  311. package/dist/generators/ui-model-builder/react-scanner.js +0 -797
  312. package/dist/generators/ui-model-builder/react-scanner.js.map +0 -1
  313. package/dist/orchestrator/cache-manager.d.ts +0 -15
  314. package/dist/orchestrator/cache-manager.d.ts.map +0 -1
  315. package/dist/orchestrator/cache-manager.js +0 -62
  316. package/dist/orchestrator/cache-manager.js.map +0 -1
  317. package/dist/orchestrator/pipeline.d.ts +0 -56
  318. package/dist/orchestrator/pipeline.d.ts.map +0 -1
  319. package/dist/orchestrator/pipeline.js +0 -298
  320. package/dist/orchestrator/pipeline.js.map +0 -1
  321. package/dist/orchestrator/reporter.d.ts +0 -15
  322. package/dist/orchestrator/reporter.d.ts.map +0 -1
  323. package/dist/orchestrator/reporter.js +0 -30
  324. package/dist/orchestrator/reporter.js.map +0 -1
  325. package/src/cli/commands/cache-clear.ts +0 -22
  326. package/src/cli/commands/full.ts +0 -35
  327. package/src/cli/commands/live-scan.ts +0 -82
  328. package/src/cli/commands/map.ts +0 -97
  329. package/src/cli/commands/validate.ts +0 -43
  330. package/src/cli/utils.ts +0 -106
  331. package/src/config/ai-providers.yaml +0 -56
  332. package/src/config/config-loader.ts +0 -248
  333. package/src/config/config-schema.ts +0 -148
  334. package/src/config/default.config.yaml +0 -107
  335. package/src/config/framework.config.yaml +0 -52
  336. package/src/config/routes.yaml +0 -31
  337. package/src/core/live-scanner/config-reader.ts +0 -57
  338. package/src/core/live-scanner/element-finder.ts +0 -534
  339. package/src/core/live-scanner/index.ts +0 -7
  340. package/src/core/live-scanner/matrix-reader.ts +0 -65
  341. package/src/core/live-scanner/matrix-writer.ts +0 -77
  342. package/src/core/live-scanner/role-fallback.ts +0 -44
  343. package/src/core/live-scanner/scanner.ts +0 -321
  344. package/src/core/live-scanner/step-replayer.ts +0 -503
  345. package/src/core/live-scanner/types.ts +0 -58
  346. package/src/core/selector-base/annotation-handler.ts +0 -127
  347. package/src/core/selector-base/base-generator.ts +0 -234
  348. package/src/core/selector-base/gherkin-parser.ts +0 -57
  349. package/src/core/selector-mapper/priority-mapper.ts +0 -607
  350. package/src/core/ui-scanner/heuristics/base-heuristic.ts +0 -216
  351. package/src/core/ui-scanner/react-scanner.ts +0 -156
  352. package/src/core/ui-scanner/scanner-interface.ts +0 -133
  353. package/src/core/ui-scanner/strict-scanner.ts +0 -629
  354. package/src/core/validator/data-validator.ts +0 -202
  355. package/src/core/validator/feature-validator.ts +0 -176
  356. package/src/core/validator/index.ts +0 -57
  357. package/src/core/validator/screen-validator.ts +0 -209
  358. package/src/core/validator/selector-validator.ts +0 -209
  359. package/src/external/ai-provider.ts +0 -90
  360. package/src/external/anthropic-provider.ts +0 -114
  361. package/src/generators/README.md +0 -410
  362. package/src/generators/cache/cache-manager.ts +0 -322
  363. package/src/generators/dsl-writer/index.ts +0 -253
  364. package/src/generators/scaffold-generator/index.ts +0 -1029
  365. package/src/generators/selector-mapper/ai-mapper.ts +0 -528
  366. package/src/generators/selector-mapper/hybrid-mapper.ts +0 -427
  367. package/src/generators/selector-mapper/index.ts +0 -10
  368. package/src/generators/selector-mapper/intelligent-mapper.ts +0 -530
  369. package/src/generators/test-generator/ai-step-mapper.ts +0 -224
  370. package/src/generators/test-generator/auth-setup-generator.ts +0 -59
  371. package/src/generators/test-generator/patterns/legacy-patterns.ts +0 -104
  372. package/src/generators/test-generator/templates/auth-setup.ts.hbs +0 -36
  373. package/src/generators/ui-model-builder/deep-scanner.ts +0 -1244
  374. package/src/generators/ui-model-builder/enhanced-deep-scanner.ts +0 -731
  375. package/src/generators/ui-model-builder/react-scanner.ts +0 -959
  376. package/src/orchestrator/cache-manager.ts +0 -32
  377. package/src/orchestrator/pipeline.ts +0 -354
  378. package/src/orchestrator/reporter.ts +0 -36
@@ -1,797 +0,0 @@
1
- "use strict";
2
- /**
3
- * React/Next.js UI Model Builder
4
- * Scans React/Next.js source code to extract UI elements using heuristic analysis
5
- */
6
- var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
7
- if (k2 === undefined) k2 = k;
8
- var desc = Object.getOwnPropertyDescriptor(m, k);
9
- if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
10
- desc = { enumerable: true, get: function() { return m[k]; } };
11
- }
12
- Object.defineProperty(o, k2, desc);
13
- }) : (function(o, m, k, k2) {
14
- if (k2 === undefined) k2 = k;
15
- o[k2] = m[k];
16
- }));
17
- var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
18
- Object.defineProperty(o, "default", { enumerable: true, value: v });
19
- }) : function(o, v) {
20
- o["default"] = v;
21
- });
22
- var __importStar = (this && this.__importStar) || (function () {
23
- var ownKeys = function(o) {
24
- ownKeys = Object.getOwnPropertyNames || function (o) {
25
- var ar = [];
26
- for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
27
- return ar;
28
- };
29
- return ownKeys(o);
30
- };
31
- return function (mod) {
32
- if (mod && mod.__esModule) return mod;
33
- var result = {};
34
- if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
35
- __setModuleDefault(result, mod);
36
- return result;
37
- };
38
- })();
39
- var __importDefault = (this && this.__importDefault) || function (mod) {
40
- return (mod && mod.__esModule) ? mod : { "default": mod };
41
- };
42
- Object.defineProperty(exports, "__esModule", { value: true });
43
- exports.ReactScanner = void 0;
44
- exports.buildUIModel = buildUIModel;
45
- exports.discoverScreens = discoverScreens;
46
- const parser = __importStar(require("@babel/parser"));
47
- const traverse_1 = __importDefault(require("@babel/traverse"));
48
- const t = __importStar(require("@babel/types"));
49
- const fs = __importStar(require("fs"));
50
- const path = __importStar(require("path"));
51
- const glob_1 = require("glob");
52
- class ReactScanner {
53
- constructor(config) {
54
- this.elements = [];
55
- this.elementCounter = 0;
56
- this.detectedComponents = [];
57
- this.scannedComponentPaths = new Set(); // Avoid duplicate scans
58
- this.config = config;
59
- }
60
- /**
61
- * Discover all routes/screens in Next.js app directory
62
- */
63
- async discoverScreens() {
64
- const appDir = this.config.sourceRoot;
65
- // Find all page.tsx/page.jsx files (Next.js 13+ app directory)
66
- const pageFiles = await (0, glob_1.glob)('**/page.{tsx,jsx}', {
67
- cwd: appDir,
68
- absolute: false,
69
- ignore: ['**/node_modules/**', '**/api/**']
70
- });
71
- // Extract screen IDs from paths
72
- // Example: "login/page.tsx" -> "login"
73
- // Example: "auth/login/page.tsx" -> "auth-login"
74
- // Example: "page.tsx" -> "home"
75
- const screens = pageFiles.map(file => {
76
- const dir = path.dirname(file);
77
- return dir === '.' ? 'home' : dir.replace(/\//g, '-');
78
- });
79
- return screens;
80
- }
81
- /**
82
- * Build UI Model for a specific screen
83
- */
84
- async buildUIModel(screenId) {
85
- // Reset state for new screen
86
- this.elements = [];
87
- this.elementCounter = 0;
88
- this.detectedComponents = [];
89
- this.scannedComponentPaths.clear();
90
- // Determine route path from screen ID
91
- // "home" -> "" (root)
92
- // "auth-login" -> "auth/login"
93
- const routePath = screenId === 'home' ? '' : screenId.replace(/-/g, '/');
94
- const routeDir = path.join(this.config.sourceRoot, routePath);
95
- // Collect source files to scan
96
- const sourceFiles = [];
97
- // 1. App root layout
98
- const rootLayout = path.join(this.config.sourceRoot, 'layout.tsx');
99
- if (fs.existsSync(rootLayout)) {
100
- sourceFiles.push(rootLayout);
101
- }
102
- // 2. Route-specific layout (if exists)
103
- const routeLayout = path.join(routeDir, 'layout.tsx');
104
- if (fs.existsSync(routeLayout)) {
105
- sourceFiles.push(routeLayout);
106
- }
107
- // 3. Page component
108
- const pageTsx = path.join(routeDir, 'page.tsx');
109
- const pageJsx = path.join(routeDir, 'page.jsx');
110
- if (fs.existsSync(pageTsx)) {
111
- sourceFiles.push(pageTsx);
112
- }
113
- else if (fs.existsSync(pageJsx)) {
114
- sourceFiles.push(pageJsx);
115
- }
116
- else {
117
- throw new Error(`Page component not found for screen: ${screenId} at ${routeDir}`);
118
- }
119
- // Phase 1: Scan all source files (page components)
120
- for (const filePath of sourceFiles) {
121
- await this.scanFile(filePath);
122
- }
123
- // Phase 2: Scan detected components (unlimited depth by default)
124
- const maxDepth = this.config.maxDepth !== undefined ? this.config.maxDepth : 999; // Default unlimited
125
- const depthLabel = maxDepth === 999 ? 'unlimited' : maxDepth.toString();
126
- if (this.config.verbose && this.detectedComponents.length > 0) {
127
- console.log(` Detected ${this.detectedComponents.length} component(s), scanning with depth=${depthLabel}...`);
128
- }
129
- await this.scanComponentsRecursive(this.detectedComponents, 1, maxDepth);
130
- // Build and return UI Model
131
- const uiModel = {
132
- screenId,
133
- routeId: routePath || 'home',
134
- framework: this.config.framework,
135
- sourceFiles: sourceFiles.map(f => path.relative(this.config.sourceRoot, f)),
136
- elements: this.elements,
137
- metadata: {
138
- scannedAt: new Date().toISOString(),
139
- version: '1.0.0',
140
- hash: this.generateHash(this.elements)
141
- }
142
- };
143
- return uiModel;
144
- }
145
- /**
146
- * Scan a single file and extract UI elements
147
- */
148
- async scanFile(filePath) {
149
- const sourceFileName = path.basename(filePath);
150
- const importMap = new Map(); // componentName → importPath
151
- if (this.config.verbose) {
152
- console.log(` Scanning: ${filePath}`);
153
- }
154
- const code = fs.readFileSync(filePath, 'utf-8');
155
- // Parse with Babel
156
- const ast = parser.parse(code, {
157
- sourceType: 'module',
158
- plugins: ['typescript', 'jsx']
159
- });
160
- // Traverse AST to extract imports and JSX elements
161
- (0, traverse_1.default)(ast, {
162
- // Detect imports
163
- ImportDeclaration: (path) => {
164
- const importPath = path.node.source.value;
165
- // Extract default import: import ChatInput from '...'
166
- const defaultSpecifier = path.node.specifiers.find(s => t.isImportDefaultSpecifier(s));
167
- if (defaultSpecifier && t.isImportDefaultSpecifier(defaultSpecifier)) {
168
- const componentName = defaultSpecifier.local.name;
169
- importMap.set(componentName, importPath);
170
- }
171
- // Extract named imports: import { Button } from '...'
172
- path.node.specifiers
173
- .filter(s => t.isImportSpecifier(s))
174
- .forEach(specifier => {
175
- if (t.isImportSpecifier(specifier) && t.isIdentifier(specifier.imported)) {
176
- const componentName = specifier.imported.name;
177
- importMap.set(componentName, importPath);
178
- }
179
- });
180
- },
181
- // Extract JSX elements
182
- JSXElement: (path) => {
183
- this.extractElement(path, sourceFileName, filePath, importMap);
184
- },
185
- // PHASE 1: Detect conditional rendering patterns
186
- JSXExpressionContainer: (path) => {
187
- this.detectConditionalElements(path, sourceFileName, filePath, importMap);
188
- }
189
- });
190
- }
191
- /**
192
- * Smart element filter - determines if element should be scanned
193
- */
194
- shouldScanElement(tagName, attributes, textContent, path) {
195
- const lowercaseTag = tagName.toLowerCase();
196
- // 1. Always scan form elements
197
- const formElements = ['input', 'button', 'textarea', 'select', 'form'];
198
- if (formElements.includes(lowercaseTag))
199
- return true;
200
- // 2. Always scan links (a, Link)
201
- if (lowercaseTag === 'a' || tagName === 'Link')
202
- return true;
203
- // 3. Scan headings with text content
204
- if (/^h[1-6]$/.test(lowercaseTag) && textContent)
205
- return true;
206
- // 4. Scan images with alt text
207
- if (lowercaseTag === 'img' && attributes['alt'])
208
- return true;
209
- // 5. Scan elements with identifying attributes
210
- const hasIdentifier = attributes['id'] ||
211
- attributes['name'] ||
212
- attributes['data-testid'] ||
213
- attributes['data-test-id'] ||
214
- attributes['aria-label'] ||
215
- attributes['ariaLabel'];
216
- if (hasIdentifier)
217
- return true;
218
- // 6. Scan semantic components (ChatInput, SubmitButton, UserProfile, etc.)
219
- // Pattern: *Input, *Field, *TextArea, *Select, *Button, *Link, *Form
220
- const semanticPatterns = [
221
- /Input$/, // ChatInput, MessageInput
222
- /Field$/, // TextField, EmailField
223
- /TextArea$/, // MessageTextArea
224
- /Select$/, // CountrySelect
225
- /Button$/, // SubmitButton, CancelButton
226
- /Link$/, // NavLink
227
- /Form$/, // LoginForm
228
- /Avatar$/, // UserAvatar
229
- /Icon$/, // SearchIcon
230
- /Image$/, // ProfileImage
231
- /Card$/, // UserCard
232
- /List$/, // MessageList
233
- /Item$/ // ListItem
234
- ];
235
- if (semanticPatterns.some(pattern => pattern.test(tagName))) {
236
- return true;
237
- }
238
- // 7. Scan text containers with content
239
- const textContainers = ['p', 'span', 'div', 'section', 'article'];
240
- if (textContainers.includes(lowercaseTag) && textContent && textContent.length > 0) {
241
- return true;
242
- }
243
- // 7.5. PHASE 1.5: Scan error/success message elements by className pattern (even without text)
244
- const className = attributes['className'] || '';
245
- const isErrorOrSuccessMessage = className.includes('text-red') ||
246
- className.includes('text-green') ||
247
- className.includes('bg-red') ||
248
- className.includes('bg-green') ||
249
- className.includes('error') ||
250
- className.includes('success') ||
251
- className.includes('alert');
252
- if (textContainers.includes(lowercaseTag) && isErrorOrSuccessMessage) {
253
- return true;
254
- }
255
- // 7.6. PHASE 1.6: Scan timestamp/metadata elements by className pattern
256
- // Fix for elements with dynamic expressions like {timestamp.toLocaleTimeString()}
257
- const isTimestampOrMetadata = className.includes('timestamp') ||
258
- className.includes('time') ||
259
- (className.includes('text-xs') && className.includes('text-gray')) ||
260
- (className.includes('text-sm') && className.includes('text-gray') && className.includes('mt-'));
261
- if (textContainers.includes(lowercaseTag) && isTimestampOrMetadata) {
262
- return true;
263
- }
264
- // 8. NEW: Smart container detection for structural elements
265
- if (['div', 'section', 'article', 'main', 'aside', 'nav'].includes(lowercaseTag)) {
266
- if (path && this.shouldScanContainer(tagName, attributes, path)) {
267
- return true;
268
- }
269
- }
270
- return false; // Skip everything else
271
- }
272
- /**
273
- * Smart container detection - checks if container is structurally important
274
- * NEW: Phase 1 - Task 1
275
- */
276
- shouldScanContainer(tagName, attributes, path) {
277
- // 1. Has important children (form elements, buttons, custom components)?
278
- const children = path.node.children.filter(child => t.isJSXElement(child));
279
- for (const child of children) {
280
- const childTag = this.getTagName(child.openingElement.name);
281
- const childTagLower = childTag.toLowerCase();
282
- // Has form elements
283
- if (['input', 'button', 'textarea', 'select', 'form'].includes(childTagLower)) {
284
- return true;
285
- }
286
- // Has custom components (PascalCase)
287
- if (/^[A-Z]/.test(childTag)) {
288
- return true;
289
- }
290
- }
291
- // 2. Semantic className keywords
292
- const className = attributes['className'] || '';
293
- const semanticKeywords = [
294
- 'message', 'messages', 'chat',
295
- 'list', 'items',
296
- 'container', 'wrapper', 'content',
297
- 'scroll', 'overflow',
298
- 'grid', 'flex'
299
- ];
300
- const hasSemanticClass = semanticKeywords.some(keyword => className.toLowerCase().includes(keyword));
301
- if (hasSemanticClass) {
302
- return true;
303
- }
304
- // 3. Has scroll behavior (overflow-auto, overflow-y-auto, etc.)
305
- if (className.includes('overflow')) {
306
- return true;
307
- }
308
- // 4. Has ARIA role
309
- if (attributes['role']) {
310
- return true;
311
- }
312
- // 5. Has ref (often used for important containers)
313
- if (attributes['ref']) {
314
- return true;
315
- }
316
- return false;
317
- }
318
- /**
319
- * Extract UI element from JSX node
320
- */
321
- extractElement(path, sourceFile, fullFilePath, importMap) {
322
- const openingElement = path.node.openingElement;
323
- const tagName = this.getTagName(openingElement.name);
324
- // Extract attributes and text first (needed for filtering)
325
- const attributes = this.extractAttributes(openingElement.attributes);
326
- const textContent = this.extractTextContent(path.node);
327
- // Check if this is a custom component (starts with uppercase)
328
- const isCustomComponent = /^[A-Z]/.test(tagName);
329
- // If it's a custom component and we have an import for it, track it for scanning
330
- // UPDATED: Phase 1 - Task 2 - Track ALL PascalCase components, not just semantic patterns
331
- if (isCustomComponent && importMap.has(tagName)) {
332
- const importPath = importMap.get(tagName);
333
- // Check if not already tracked
334
- const alreadyTracked = this.detectedComponents.some(c => c.name === tagName && c.importPath === importPath);
335
- if (!alreadyTracked) {
336
- this.detectedComponents.push({
337
- name: tagName,
338
- importPath,
339
- sourceFile: fullFilePath
340
- });
341
- if (this.config.verbose) {
342
- console.log(` Found component: ${tagName} from ${importPath}`);
343
- }
344
- }
345
- }
346
- // Use smart filter instead of static whitelist (pass path for container detection)
347
- if (!this.shouldScanElement(tagName, attributes, textContent, path)) {
348
- return; // Skip non-scannable elements
349
- }
350
- // Build UI Element
351
- const element = {
352
- key: `e${++this.elementCounter}`,
353
- tag: tagName.toLowerCase(),
354
- role: attributes['role'] || this.inferRole(tagName),
355
- name: attributes['name'],
356
- id: attributes['id'],
357
- placeholder: attributes['placeholder'],
358
- ariaLabel: attributes['aria-label'] || attributes['ariaLabel'],
359
- testId: attributes['data-testid'] || attributes['data-test-id'],
360
- text: textContent || attributes['value'],
361
- source: sourceFile,
362
- props: attributes
363
- };
364
- // Add label if associated
365
- if (attributes['aria-labelledby']) {
366
- element.label = `[ref:${attributes['aria-labelledby']}]`;
367
- }
368
- this.elements.push(element);
369
- }
370
- /**
371
- * PHASE 1: Detect and extract conditionally rendered elements
372
- * Handles patterns: {condition && <Element />}, {condition ? <A /> : <B />}, {arr.map(...)}
373
- * PHASE 1.5: Now also traverses nested children
374
- */
375
- detectConditionalElements(path, sourceFile, fullFilePath, importMap) {
376
- const expr = path.node.expression;
377
- // Pattern 1: Logical AND (condition && <Element />)
378
- if (t.isLogicalExpression(expr, { operator: '&&' })) {
379
- const rightSide = expr.right;
380
- if (t.isJSXElement(rightSide)) {
381
- // Extract the direct element
382
- this.extractConditionalElement(rightSide, sourceFile, fullFilePath, importMap, 'conditional-and');
383
- // PHASE 1.5: Also traverse nested children
384
- this.traverseConditionalChildren(rightSide, sourceFile, fullFilePath, importMap, 'conditional-nested');
385
- }
386
- else if (t.isJSXFragment(rightSide)) {
387
- // Handle {condition && (<><Element1 /><Element2 /></>)}
388
- this.extractFragmentElements(rightSide, sourceFile, fullFilePath, importMap, 'conditional-and');
389
- }
390
- }
391
- // Pattern 2: Ternary operator (condition ? <A /> : <B />)
392
- if (t.isConditionalExpression(expr)) {
393
- const consequent = expr.consequent;
394
- const alternate = expr.alternate;
395
- if (t.isJSXElement(consequent)) {
396
- this.extractConditionalElement(consequent, sourceFile, fullFilePath, importMap, 'conditional-true');
397
- // PHASE 1.5: Traverse nested children
398
- this.traverseConditionalChildren(consequent, sourceFile, fullFilePath, importMap, 'conditional-nested');
399
- }
400
- if (t.isJSXElement(alternate)) {
401
- this.extractConditionalElement(alternate, sourceFile, fullFilePath, importMap, 'conditional-false');
402
- // PHASE 1.5: Traverse nested children
403
- this.traverseConditionalChildren(alternate, sourceFile, fullFilePath, importMap, 'conditional-nested');
404
- }
405
- }
406
- // Pattern 3: Array.map() rendering (arr.map(item => <Element />))
407
- if (t.isCallExpression(expr)) {
408
- const callee = expr.callee;
409
- // Check if it's a .map() call
410
- if (t.isMemberExpression(callee) && t.isIdentifier(callee.property, { name: 'map' })) {
411
- const mapCallback = expr.arguments[0];
412
- if (t.isArrowFunctionExpression(mapCallback) || t.isFunctionExpression(mapCallback)) {
413
- const body = mapCallback.body;
414
- // Case 1: Direct return - arr.map(item => <Element />)
415
- if (t.isJSXElement(body)) {
416
- this.extractConditionalElement(body, sourceFile, fullFilePath, importMap, 'loop-item');
417
- }
418
- // Case 2: Block with return - arr.map(item => { return <Element /> })
419
- if (t.isBlockStatement(body)) {
420
- for (const statement of body.body) {
421
- if (t.isReturnStatement(statement) && statement.argument && t.isJSXElement(statement.argument)) {
422
- this.extractConditionalElement(statement.argument, sourceFile, fullFilePath, importMap, 'loop-item');
423
- }
424
- }
425
- }
426
- }
427
- }
428
- }
429
- }
430
- /**
431
- * Extract elements from JSX Fragment
432
- */
433
- extractFragmentElements(fragment, sourceFile, fullFilePath, importMap, renderType) {
434
- for (const child of fragment.children) {
435
- if (t.isJSXElement(child)) {
436
- this.extractConditionalElement(child, sourceFile, fullFilePath, importMap, renderType);
437
- }
438
- }
439
- }
440
- /**
441
- * PHASE 1.5: Traverse nested children of conditional elements
442
- * Example: {error && <div><p>{error}</p></div>} - detect the nested <p> tag
443
- */
444
- traverseConditionalChildren(element, sourceFile, fullFilePath, importMap, renderType) {
445
- for (const child of element.children) {
446
- // Traverse nested JSX elements
447
- if (t.isJSXElement(child)) {
448
- const openingElement = child.openingElement;
449
- const tagName = this.getTagName(openingElement.name);
450
- const attributes = this.extractAttributes(openingElement.attributes);
451
- const textContent = this.extractTextContent(child);
452
- // Check if this nested element should be scanned
453
- if (this.shouldScanElement(tagName, attributes, textContent, undefined)) {
454
- this.extractConditionalElement(child, sourceFile, fullFilePath, importMap, renderType);
455
- }
456
- // Recursively traverse deeper children
457
- this.traverseConditionalChildren(child, sourceFile, fullFilePath, importMap, renderType);
458
- }
459
- // Traverse JSX expression containers (for nested dynamic content)
460
- if (t.isJSXExpressionContainer(child)) {
461
- const expr = child.expression;
462
- // Handle nested JSX elements in expressions
463
- if (t.isJSXElement(expr)) {
464
- this.extractConditionalElement(expr, sourceFile, fullFilePath, importMap, renderType);
465
- }
466
- }
467
- }
468
- }
469
- /**
470
- * Extract a conditionally rendered JSX element
471
- */
472
- extractConditionalElement(jsxElement, sourceFile, fullFilePath, importMap, renderType) {
473
- const openingElement = jsxElement.openingElement;
474
- const tagName = this.getTagName(openingElement.name);
475
- // Extract attributes and text
476
- const attributes = this.extractAttributes(openingElement.attributes);
477
- const textContent = this.extractTextContent(jsxElement);
478
- // Check if this is a custom component
479
- const isCustomComponent = /^[A-Z]/.test(tagName);
480
- if (isCustomComponent && importMap.has(tagName)) {
481
- const importPath = importMap.get(tagName);
482
- const alreadyTracked = this.detectedComponents.some(c => c.name === tagName && c.importPath === importPath);
483
- if (!alreadyTracked) {
484
- this.detectedComponents.push({
485
- name: tagName,
486
- importPath,
487
- sourceFile: fullFilePath
488
- });
489
- }
490
- }
491
- // Use smart filter to decide if we should scan this element
492
- if (!this.shouldScanElement(tagName, attributes, textContent, undefined)) {
493
- return;
494
- }
495
- // Build UI Element with conditional marker
496
- const element = {
497
- key: `e${++this.elementCounter}`,
498
- tag: tagName.toLowerCase(),
499
- role: attributes['role'] || this.inferRole(tagName),
500
- name: attributes['name'],
501
- id: attributes['id'],
502
- placeholder: attributes['placeholder'],
503
- ariaLabel: attributes['aria-label'] || attributes['ariaLabel'],
504
- testId: attributes['data-testid'] || attributes['data-test-id'],
505
- text: textContent || attributes['value'],
506
- source: sourceFile,
507
- props: {
508
- ...attributes,
509
- isConditional: renderType // Mark as conditional with type
510
- }
511
- };
512
- if (attributes['aria-labelledby']) {
513
- element.label = `[ref:${attributes['aria-labelledby']}]`;
514
- }
515
- this.elements.push(element);
516
- if (this.config.verbose) {
517
- console.log(` Found conditional element: ${tagName} (${renderType})`);
518
- }
519
- }
520
- /**
521
- * Get tag name from JSX element
522
- */
523
- getTagName(name) {
524
- if (t.isJSXIdentifier(name)) {
525
- return name.name;
526
- }
527
- if (t.isJSXMemberExpression(name)) {
528
- // Handle cases like <Form.Input />
529
- return this.getTagName(name.property);
530
- }
531
- return 'unknown';
532
- }
533
- /**
534
- * Extract attributes from JSX element
535
- */
536
- extractAttributes(attributes) {
537
- const result = {};
538
- for (const attr of attributes) {
539
- if (t.isJSXAttribute(attr) && t.isJSXIdentifier(attr.name)) {
540
- const name = attr.name.name;
541
- const value = this.getAttributeValue(attr.value);
542
- if (value !== null) {
543
- result[name] = value;
544
- }
545
- }
546
- }
547
- return result;
548
- }
549
- /**
550
- * Get attribute value
551
- */
552
- getAttributeValue(value) {
553
- if (!value)
554
- return null;
555
- if (t.isStringLiteral(value)) {
556
- return value.value;
557
- }
558
- if (t.isJSXExpressionContainer(value)) {
559
- const expr = value.expression;
560
- // Handle string literals in expressions
561
- if (t.isStringLiteral(expr)) {
562
- return expr.value;
563
- }
564
- // Handle template literals
565
- if (t.isTemplateLiteral(expr) && expr.quasis.length === 1) {
566
- return expr.quasis[0].value.cooked || '';
567
- }
568
- // For complex expressions, return placeholder
569
- return '[expression]';
570
- }
571
- return null;
572
- }
573
- /**
574
- * Extract text content from JSX element
575
- * PHASE 1 ENHANCED: Extract text from dynamic expressions
576
- */
577
- extractTextContent(node) {
578
- const children = node.children;
579
- const textParts = [];
580
- for (const child of children) {
581
- if (t.isJSXText(child)) {
582
- const text = child.value.trim();
583
- if (text)
584
- textParts.push(text);
585
- }
586
- if (t.isJSXExpressionContainer(child)) {
587
- const expr = child.expression;
588
- // Static string literal
589
- if (t.isStringLiteral(expr)) {
590
- textParts.push(expr.value);
591
- }
592
- // PHASE 1: Extract text from ternary (condition ? 'Text A' : 'Text B')
593
- if (t.isConditionalExpression(expr)) {
594
- const texts = [];
595
- if (t.isStringLiteral(expr.consequent)) {
596
- texts.push(expr.consequent.value);
597
- }
598
- if (t.isStringLiteral(expr.alternate)) {
599
- texts.push(expr.alternate.value);
600
- }
601
- if (texts.length > 0) {
602
- textParts.push(texts.join(' / ')); // e.g., "Copy / Copied!"
603
- }
604
- }
605
- // PHASE 1: Extract text from logical OR (defaultValue || 'Fallback')
606
- if (t.isLogicalExpression(expr, { operator: '||' })) {
607
- if (t.isStringLiteral(expr.right)) {
608
- textParts.push(expr.right.value);
609
- }
610
- }
611
- }
612
- }
613
- return textParts.length > 0 ? textParts.join(' ') : null;
614
- }
615
- /**
616
- * Infer ARIA role from tag name
617
- */
618
- inferRole(tagName) {
619
- const roleMap = {
620
- 'button': 'button',
621
- 'input': 'textbox',
622
- 'textarea': 'textbox',
623
- 'select': 'combobox',
624
- 'a': 'link',
625
- 'form': 'form'
626
- };
627
- return roleMap[tagName.toLowerCase()];
628
- }
629
- /**
630
- * Resolve component import path to actual file path
631
- */
632
- resolveComponentPath(importPath, sourceFile) {
633
- try {
634
- // Handle different import path formats
635
- let resolvedPath;
636
- if (importPath.startsWith('@/')) {
637
- // Alias import: @/components/ChatInput → PROJECT_ROOT/components/ChatInput.tsx
638
- // Note: @ alias points to project root, not sourceRoot (app/)
639
- const projectRoot = path.resolve(this.config.sourceRoot, '..');
640
- const relativePath = importPath.replace('@/', '');
641
- resolvedPath = path.join(projectRoot, relativePath);
642
- }
643
- else if (importPath.startsWith('./') || importPath.startsWith('../')) {
644
- // Relative import: ./components/ChatInput
645
- const sourceDir = path.dirname(sourceFile);
646
- resolvedPath = path.join(sourceDir, importPath);
647
- }
648
- else {
649
- // Absolute or node_modules import - skip
650
- return null;
651
- }
652
- // Try different file extensions
653
- const extensions = ['.tsx', '.ts', '.jsx', '.js'];
654
- for (const ext of extensions) {
655
- const fullPath = resolvedPath + ext;
656
- if (fs.existsSync(fullPath)) {
657
- return fullPath;
658
- }
659
- }
660
- // Try index files
661
- for (const ext of extensions) {
662
- const indexPath = path.join(resolvedPath, `index${ext}`);
663
- if (fs.existsSync(indexPath)) {
664
- return indexPath;
665
- }
666
- }
667
- return null;
668
- }
669
- catch (error) {
670
- if (this.config.verbose) {
671
- console.log(` Could not resolve: ${importPath}`);
672
- }
673
- return null;
674
- }
675
- }
676
- /**
677
- * NEW: Recursively scan components at multiple depths
678
- * @param components - List of components to scan
679
- * @param currentDepth - Current depth level
680
- * @param maxDepth - Maximum depth to scan
681
- */
682
- async scanComponentsRecursive(components, currentDepth, maxDepth) {
683
- if (currentDepth > maxDepth) {
684
- return; // Stop recursion at max depth
685
- }
686
- const startTime = Date.now();
687
- const componentsScanned = [];
688
- // Scan all components at current level
689
- for (const component of components) {
690
- const componentPath = this.resolveComponentPath(component.importPath, component.sourceFile);
691
- if (!componentPath) {
692
- continue; // Skip if path cannot be resolved
693
- }
694
- // Skip node_modules
695
- if (componentPath.includes('node_modules')) {
696
- if (this.config.verbose) {
697
- console.log(` Skipping node_modules: ${componentPath}`);
698
- }
699
- continue;
700
- }
701
- // Skip if already scanned (avoid duplicates)
702
- if (this.scannedComponentPaths.has(componentPath)) {
703
- continue;
704
- }
705
- // Mark as scanned
706
- this.scannedComponentPaths.add(componentPath);
707
- // Store the count of detected components before scanning
708
- const detectedCountBefore = this.detectedComponents.length;
709
- // Scan the component file
710
- await this.scanComponentFile(componentPath, component.name);
711
- // Track newly detected components from this scan
712
- const newlyDetected = this.detectedComponents.slice(detectedCountBefore);
713
- componentsScanned.push(...newlyDetected);
714
- }
715
- const elapsed = Date.now() - startTime;
716
- if (this.config.verbose && componentsScanned.length > 0) {
717
- console.log(` [Depth ${currentDepth}] Scanned ${components.length} component(s), found ${componentsScanned.length} sub-component(s) (${elapsed}ms)`);
718
- }
719
- // Recursively scan newly detected components at next depth
720
- if (componentsScanned.length > 0 && currentDepth < maxDepth) {
721
- await this.scanComponentsRecursive(componentsScanned, currentDepth + 1, maxDepth);
722
- }
723
- }
724
- /**
725
- * Scan component file and extract elements
726
- */
727
- async scanComponentFile(componentPath, componentName) {
728
- if (this.config.verbose) {
729
- console.log(` Scanning component: ${componentName} at ${componentPath}`);
730
- }
731
- const code = fs.readFileSync(componentPath, 'utf-8');
732
- // Parse with Babel
733
- const ast = parser.parse(code, {
734
- sourceType: 'module',
735
- plugins: ['typescript', 'jsx']
736
- });
737
- const importMap = new Map(); // Empty import map for component scanning
738
- // Traverse AST and extract JSX elements (no nested component scanning)
739
- (0, traverse_1.default)(ast, {
740
- JSXElement: (path) => {
741
- const openingElement = path.node.openingElement;
742
- const tagName = this.getTagName(openingElement.name);
743
- // Extract attributes and text
744
- const attributes = this.extractAttributes(openingElement.attributes);
745
- const textContent = this.extractTextContent(path.node);
746
- // Use smart filter (pass path for container detection)
747
- if (!this.shouldScanElement(tagName, attributes, textContent, path)) {
748
- return;
749
- }
750
- // Build UI Element with component context
751
- const element = {
752
- key: `e${++this.elementCounter}`,
753
- tag: tagName.toLowerCase(),
754
- role: attributes['role'] || this.inferRole(tagName),
755
- name: attributes['name'],
756
- id: attributes['id'],
757
- placeholder: attributes['placeholder'],
758
- ariaLabel: attributes['aria-label'] || attributes['ariaLabel'],
759
- testId: attributes['data-testid'] || attributes['data-test-id'],
760
- text: textContent || attributes['value'],
761
- source: `${componentName}.tsx`, // Mark as from component
762
- props: attributes
763
- };
764
- // Add label if associated
765
- if (attributes['aria-labelledby']) {
766
- element.label = `[ref:${attributes['aria-labelledby']}]`;
767
- }
768
- this.elements.push(element);
769
- },
770
- // PHASE 1: Detect conditional rendering in components too
771
- JSXExpressionContainer: (path) => {
772
- this.detectConditionalElements(path, `${componentName}.tsx`, componentPath, importMap);
773
- }
774
- });
775
- }
776
- /**
777
- * Generate hash for cache key
778
- */
779
- generateHash(elements) {
780
- const crypto = require('crypto');
781
- const content = JSON.stringify(elements);
782
- return crypto.createHash('sha256').update(content).digest('hex');
783
- }
784
- }
785
- exports.ReactScanner = ReactScanner;
786
- // ============================================================================
787
- // Factory Function
788
- // ============================================================================
789
- async function buildUIModel(screenId, config) {
790
- const scanner = new ReactScanner(config);
791
- return scanner.buildUIModel(screenId);
792
- }
793
- async function discoverScreens(config) {
794
- const scanner = new ReactScanner(config);
795
- return scanner.discoverScreens();
796
- }
797
- //# sourceMappingURL=react-scanner.js.map