@ttsc/lint 0.13.1 → 0.14.0-dev.20260528

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 (464) hide show
  1. package/README.md +948 -69
  2. package/lib/defaultFormat.d.ts +9 -6
  3. package/lib/defaultFormat.js +9 -6
  4. package/lib/defaultFormat.js.map +1 -1
  5. package/lib/index.d.ts +46 -0
  6. package/lib/index.js +35 -10
  7. package/lib/index.js.map +1 -1
  8. package/lib/structures/ITtscLintConfig.d.ts +12 -6
  9. package/lib/structures/{ITtscLintFormatConfig.d.ts → ITtscLintFormat.d.ts} +2 -2
  10. package/lib/structures/{TtscLintRuleMap.js → ITtscLintFormat.js} +1 -1
  11. package/lib/structures/ITtscLintFormat.js.map +1 -0
  12. package/lib/structures/TtscLintRuleSetting.d.ts +49 -0
  13. package/lib/structures/{TtscLintRuleOptions.js → TtscLintRuleSetting.js} +1 -1
  14. package/lib/structures/TtscLintRuleSetting.js.map +1 -0
  15. package/lib/structures/index.d.ts +3 -4
  16. package/lib/structures/index.js +3 -4
  17. package/lib/structures/index.js.map +1 -1
  18. package/lib/structures/rules/ITtscLintBoundariesRuleOptions.d.ts +104 -0
  19. package/lib/structures/rules/ITtscLintBoundariesRuleOptions.js +14 -0
  20. package/lib/structures/rules/ITtscLintBoundariesRuleOptions.js.map +1 -0
  21. package/lib/structures/rules/ITtscLintBoundariesRules.d.ts +79 -0
  22. package/lib/structures/rules/ITtscLintBoundariesRules.js +3 -0
  23. package/lib/structures/rules/ITtscLintBoundariesRules.js.map +1 -0
  24. package/lib/structures/rules/ITtscLintContributorRules.d.ts +17 -0
  25. package/lib/structures/rules/ITtscLintContributorRules.js +3 -0
  26. package/lib/structures/rules/ITtscLintContributorRules.js.map +1 -0
  27. package/lib/structures/rules/ITtscLintCoreRules.d.ts +1257 -0
  28. package/lib/structures/{ITtscLintFormatConfig.js → rules/ITtscLintCoreRules.js} +1 -1
  29. package/lib/structures/rules/ITtscLintCoreRules.js.map +1 -0
  30. package/lib/structures/rules/ITtscLintCypressRuleOptions.d.ts +17 -0
  31. package/lib/structures/rules/ITtscLintCypressRuleOptions.js +10 -0
  32. package/lib/structures/rules/ITtscLintCypressRuleOptions.js.map +1 -0
  33. package/lib/structures/rules/ITtscLintCypressRules.d.ts +129 -0
  34. package/lib/structures/rules/ITtscLintCypressRules.js +3 -0
  35. package/lib/structures/rules/ITtscLintCypressRules.js.map +1 -0
  36. package/lib/structures/rules/ITtscLintFunctionalRuleOptions.d.ts +157 -0
  37. package/lib/structures/rules/ITtscLintFunctionalRuleOptions.js +13 -0
  38. package/lib/structures/rules/ITtscLintFunctionalRuleOptions.js.map +1 -0
  39. package/lib/structures/rules/ITtscLintFunctionalRules.d.ts +167 -0
  40. package/lib/structures/rules/ITtscLintFunctionalRules.js +3 -0
  41. package/lib/structures/rules/ITtscLintFunctionalRules.js.map +1 -0
  42. package/lib/structures/rules/ITtscLintJestRules.d.ts +201 -0
  43. package/lib/structures/rules/ITtscLintJestRules.js +3 -0
  44. package/lib/structures/rules/ITtscLintJestRules.js.map +1 -0
  45. package/lib/structures/rules/ITtscLintJsdocRules.d.ts +140 -0
  46. package/lib/structures/rules/ITtscLintJsdocRules.js +3 -0
  47. package/lib/structures/rules/ITtscLintJsdocRules.js.map +1 -0
  48. package/lib/structures/rules/ITtscLintJsxA11yRules.d.ts +302 -0
  49. package/lib/structures/rules/ITtscLintJsxA11yRules.js +3 -0
  50. package/lib/structures/rules/ITtscLintJsxA11yRules.js.map +1 -0
  51. package/lib/structures/rules/ITtscLintNextjsRules.d.ts +185 -0
  52. package/lib/structures/rules/ITtscLintNextjsRules.js +3 -0
  53. package/lib/structures/rules/ITtscLintNextjsRules.js.map +1 -0
  54. package/lib/structures/rules/ITtscLintPlaywrightRules.d.ts +330 -0
  55. package/lib/structures/rules/ITtscLintPlaywrightRules.js +3 -0
  56. package/lib/structures/rules/ITtscLintPlaywrightRules.js.map +1 -0
  57. package/lib/structures/rules/ITtscLintPromiseRules.d.ts +188 -0
  58. package/lib/structures/rules/ITtscLintPromiseRules.js +3 -0
  59. package/lib/structures/rules/ITtscLintPromiseRules.js.map +1 -0
  60. package/lib/structures/rules/ITtscLintReactPerfRuleOptions.d.ts +18 -0
  61. package/lib/structures/rules/ITtscLintReactPerfRuleOptions.js +8 -0
  62. package/lib/structures/rules/ITtscLintReactPerfRuleOptions.js.map +1 -0
  63. package/lib/structures/rules/ITtscLintReactPerfRules.d.ts +51 -0
  64. package/lib/structures/rules/ITtscLintReactPerfRules.js +3 -0
  65. package/lib/structures/rules/ITtscLintReactPerfRules.js.map +1 -0
  66. package/lib/structures/rules/ITtscLintReactRuleOptions.d.ts +39 -0
  67. package/lib/structures/rules/ITtscLintReactRuleOptions.js +12 -0
  68. package/lib/structures/rules/ITtscLintReactRuleOptions.js.map +1 -0
  69. package/lib/structures/rules/ITtscLintReactRules.d.ts +289 -0
  70. package/lib/structures/rules/ITtscLintReactRules.js +3 -0
  71. package/lib/structures/rules/ITtscLintReactRules.js.map +1 -0
  72. package/lib/structures/rules/ITtscLintRegexpRules.d.ts +190 -0
  73. package/lib/structures/rules/ITtscLintRegexpRules.js +3 -0
  74. package/lib/structures/rules/ITtscLintRegexpRules.js.map +1 -0
  75. package/lib/structures/rules/ITtscLintRuleOptionsMap.d.ts +66 -0
  76. package/lib/structures/rules/ITtscLintRuleOptionsMap.js +3 -0
  77. package/lib/structures/rules/ITtscLintRuleOptionsMap.js.map +1 -0
  78. package/lib/structures/rules/ITtscLintRules.d.ts +55 -0
  79. package/lib/structures/{TtscLintRule.js → rules/ITtscLintRules.js} +1 -1
  80. package/lib/structures/rules/ITtscLintRules.js.map +1 -0
  81. package/lib/structures/rules/ITtscLintSecurityRules.d.ts +148 -0
  82. package/lib/structures/rules/ITtscLintSecurityRules.js +3 -0
  83. package/lib/structures/rules/ITtscLintSecurityRules.js.map +1 -0
  84. package/lib/structures/rules/ITtscLintSolidRules.d.ts +181 -0
  85. package/lib/structures/rules/ITtscLintSolidRules.js +3 -0
  86. package/lib/structures/rules/ITtscLintSolidRules.js.map +1 -0
  87. package/lib/structures/rules/ITtscLintStorybookRuleOptions.d.ts +21 -0
  88. package/lib/structures/rules/ITtscLintStorybookRuleOptions.js +9 -0
  89. package/lib/structures/rules/ITtscLintStorybookRuleOptions.js.map +1 -0
  90. package/lib/structures/rules/ITtscLintStorybookRules.d.ts +174 -0
  91. package/lib/structures/rules/ITtscLintStorybookRules.js +3 -0
  92. package/lib/structures/rules/ITtscLintStorybookRules.js.map +1 -0
  93. package/lib/structures/rules/ITtscLintTanstackQueryRules.d.ts +94 -0
  94. package/lib/structures/rules/ITtscLintTanstackQueryRules.js +3 -0
  95. package/lib/structures/rules/ITtscLintTanstackQueryRules.js.map +1 -0
  96. package/lib/structures/rules/ITtscLintTestingLibraryRuleOptions.d.ts +22 -0
  97. package/lib/structures/rules/ITtscLintTestingLibraryRuleOptions.js +10 -0
  98. package/lib/structures/rules/ITtscLintTestingLibraryRuleOptions.js.map +1 -0
  99. package/lib/structures/rules/ITtscLintTestingLibraryRules.d.ts +310 -0
  100. package/lib/structures/rules/ITtscLintTestingLibraryRules.js +3 -0
  101. package/lib/structures/rules/ITtscLintTestingLibraryRules.js.map +1 -0
  102. package/lib/structures/rules/ITtscLintTypeScriptRules.d.ts +1132 -0
  103. package/lib/structures/rules/ITtscLintTypeScriptRules.js +3 -0
  104. package/lib/structures/rules/ITtscLintTypeScriptRules.js.map +1 -0
  105. package/lib/structures/rules/ITtscLintUnicornRules.d.ts +997 -0
  106. package/lib/structures/rules/ITtscLintUnicornRules.js +3 -0
  107. package/lib/structures/rules/ITtscLintUnicornRules.js.map +1 -0
  108. package/lib/structures/rules/ITtscLintVitestRules.d.ts +141 -0
  109. package/lib/structures/rules/ITtscLintVitestRules.js +3 -0
  110. package/lib/structures/rules/ITtscLintVitestRules.js.map +1 -0
  111. package/lib/structures/rules/index.d.ts +31 -0
  112. package/lib/structures/rules/index.js +48 -0
  113. package/lib/structures/rules/index.js.map +1 -0
  114. package/linthost/ast_helpers.go +30 -5
  115. package/linthost/config.go +48 -17
  116. package/linthost/config_format.go +9 -9
  117. package/linthost/directives.go +67 -25
  118. package/linthost/dispatch.go +14 -3
  119. package/linthost/engine.go +152 -31
  120. package/linthost/fix.go +2 -2
  121. package/linthost/lsp.go +747 -0
  122. package/linthost/print_dispatch.go +2 -2
  123. package/linthost/print_nodes_function.go +2 -2
  124. package/linthost/print_nodes_object.go +1 -1
  125. package/linthost/rule_names.go +14 -0
  126. package/linthost/rules_arrays.go +2 -2
  127. package/linthost/rules_boundaries.go +532 -0
  128. package/linthost/rules_camelcase.go +133 -0
  129. package/linthost/rules_complexity.go +94 -0
  130. package/linthost/rules_consistent_return.go +130 -0
  131. package/linthost/rules_console.go +1 -1
  132. package/linthost/rules_core_extra.go +739 -0
  133. package/linthost/rules_curly.go +70 -0
  134. package/linthost/rules_cypress.go +608 -0
  135. package/linthost/rules_debugger.go +2 -2
  136. package/linthost/rules_default_case.go +39 -0
  137. package/linthost/rules_default_case_last.go +46 -0
  138. package/linthost/rules_dupes.go +3 -3
  139. package/linthost/rules_empty.go +3 -3
  140. package/linthost/rules_escape.go +44 -24
  141. package/linthost/rules_eval.go +2 -2
  142. package/linthost/rules_finally.go +2 -2
  143. package/linthost/rules_format_jsdoc.go +1 -1
  144. package/linthost/rules_format_print_width.go +9 -9
  145. package/linthost/rules_format_quotes.go +1 -1
  146. package/linthost/rules_format_semi.go +1 -1
  147. package/linthost/rules_format_sort_imports.go +1 -1
  148. package/linthost/rules_format_trailing_comma.go +1 -1
  149. package/linthost/rules_functional.go +967 -0
  150. package/linthost/rules_gap.go +24 -45
  151. package/linthost/rules_grouped_accessor_pairs.go +87 -0
  152. package/linthost/rules_guard_for_in.go +198 -0
  153. package/linthost/rules_id_length.go +77 -0
  154. package/linthost/rules_imports.go +70 -2
  155. package/linthost/rules_init_declarations.go +53 -0
  156. package/linthost/rules_jest.go +618 -0
  157. package/linthost/rules_jsdoc.go +502 -0
  158. package/linthost/rules_jsx_a11y.go +1264 -0
  159. package/linthost/rules_logic.go +12 -12
  160. package/linthost/rules_loops.go +1 -1
  161. package/linthost/rules_max_classes_per_file.go +58 -0
  162. package/linthost/rules_max_depth.go +83 -0
  163. package/linthost/rules_max_lines.go +101 -0
  164. package/linthost/rules_max_lines_per_function.go +57 -0
  165. package/linthost/rules_max_nested_callbacks.go +61 -0
  166. package/linthost/rules_max_params.go +49 -0
  167. package/linthost/rules_max_statements.go +59 -0
  168. package/linthost/rules_misc.go +1 -1
  169. package/linthost/rules_nextjs.go +697 -0
  170. package/linthost/rules_no_else_return.go +75 -0
  171. package/linthost/rules_no_empty_named_blocks.go +91 -0
  172. package/linthost/rules_no_extend_native.go +51 -0
  173. package/linthost/rules_no_import_assign.go +140 -0
  174. package/linthost/rules_no_invalid_this.go +52 -0
  175. package/linthost/rules_no_loop_func.go +85 -0
  176. package/linthost/rules_no_magic_numbers.go +123 -0
  177. package/linthost/rules_no_mixed_operators.go +80 -0
  178. package/linthost/rules_no_param_reassign.go +98 -0
  179. package/linthost/rules_no_redeclare.go +270 -0
  180. package/linthost/rules_no_restricted_imports.go +105 -0
  181. package/linthost/rules_no_restricted_syntax.go +49 -0
  182. package/linthost/rules_no_shadow.go +147 -0
  183. package/linthost/rules_no_unreachable.go +77 -0
  184. package/linthost/rules_no_useless_assignment.go +120 -0
  185. package/linthost/rules_no_useless_constructor.go +245 -0
  186. package/linthost/rules_no_useless_return.go +51 -0
  187. package/linthost/rules_params.go +1 -1
  188. package/linthost/rules_playwright.go +788 -0
  189. package/linthost/rules_prefer_arrow_callback.go +124 -0
  190. package/linthost/rules_prefer_destructuring.go +98 -0
  191. package/linthost/rules_prefer_named_capture_group.go +129 -0
  192. package/linthost/rules_prefer_rest_params.go +94 -0
  193. package/linthost/rules_problems.go +41 -30
  194. package/linthost/rules_promise.go +1128 -73
  195. package/linthost/rules_protos.go +2 -2
  196. package/linthost/rules_react.go +773 -0
  197. package/linthost/rules_react_extras.go +227 -0
  198. package/linthost/rules_react_hooks.go +848 -0
  199. package/linthost/rules_react_perf.go +293 -0
  200. package/linthost/rules_react_refresh.go +583 -0
  201. package/linthost/rules_regexp.go +410 -0
  202. package/linthost/rules_security.go +830 -0
  203. package/linthost/rules_self.go +2 -2
  204. package/linthost/rules_solid.go +1073 -0
  205. package/linthost/rules_sort_imports.go +69 -0
  206. package/linthost/rules_sort_keys.go +134 -0
  207. package/linthost/rules_storybook.go +1176 -0
  208. package/linthost/rules_strings.go +4 -4
  209. package/linthost/rules_suggestions.go +38 -38
  210. package/linthost/rules_tanstack_query.go +844 -0
  211. package/linthost/rules_testing_library.go +1204 -0
  212. package/linthost/rules_throw.go +1 -1
  213. package/linthost/rules_ts.go +19 -19
  214. package/linthost/rules_ts_async.go +399 -0
  215. package/linthost/rules_ts_class_literal_property_style.go +115 -0
  216. package/linthost/rules_ts_consistent_type_exports.go +256 -0
  217. package/linthost/rules_ts_explicit_function_return_type.go +67 -0
  218. package/linthost/rules_ts_extra.go +155 -36
  219. package/linthost/rules_ts_no_base_to_string.go +218 -0
  220. package/linthost/rules_ts_no_confusing_void.go +72 -0
  221. package/linthost/rules_ts_no_deprecated.go +195 -0
  222. package/linthost/rules_ts_no_for_in_array.go +84 -0
  223. package/linthost/rules_ts_no_magic_numbers.go +124 -0
  224. package/linthost/rules_ts_no_meaningless_void_operator.go +84 -0
  225. package/linthost/rules_ts_no_misused_spread.go +104 -0
  226. package/linthost/rules_ts_no_redundant_type_constituents.go +113 -0
  227. package/linthost/rules_ts_no_restricted_types.go +62 -0
  228. package/linthost/rules_ts_no_unnecessary_boolean_literal_compare.go +129 -0
  229. package/linthost/rules_ts_no_unnecessary_condition.go +250 -0
  230. package/linthost/rules_ts_no_unnecessary_qualifier.go +118 -0
  231. package/linthost/rules_ts_no_unnecessary_template_expression.go +178 -0
  232. package/linthost/rules_ts_no_unnecessary_type_arguments.go +234 -0
  233. package/linthost/rules_ts_no_unnecessary_type_assertion.go +157 -0
  234. package/linthost/rules_ts_no_unsafe_argument.go +82 -0
  235. package/linthost/rules_ts_no_unsafe_assignment.go +102 -0
  236. package/linthost/rules_ts_no_unsafe_call.go +82 -0
  237. package/linthost/rules_ts_no_unsafe_enum_comparison.go +235 -0
  238. package/linthost/rules_ts_no_unsafe_member_access.go +58 -0
  239. package/linthost/rules_ts_no_unsafe_return.go +126 -0
  240. package/linthost/rules_ts_no_unsafe_unary_minus.go +81 -0
  241. package/linthost/rules_ts_no_useless_constructor.go +52 -0
  242. package/linthost/rules_ts_non_nullable_type_assertion_style.go +108 -0
  243. package/linthost/rules_ts_parameter_properties.go +38 -0
  244. package/linthost/rules_ts_prefer_find.go +178 -0
  245. package/linthost/rules_ts_prefer_includes.go +255 -0
  246. package/linthost/rules_ts_prefer_nullish_coalescing.go +104 -0
  247. package/linthost/rules_ts_prefer_optional_chain.go +228 -0
  248. package/linthost/rules_ts_prefer_promise_reject_errors.go +176 -0
  249. package/linthost/rules_ts_prefer_readonly.go +73 -0
  250. package/linthost/rules_ts_prefer_reduce_type_parameter.go +116 -0
  251. package/linthost/rules_ts_prefer_regexp_exec.go +122 -0
  252. package/linthost/rules_ts_prefer_return_this_type.go +135 -0
  253. package/linthost/rules_ts_prefer_string_starts_ends_with.go +360 -0
  254. package/linthost/rules_ts_promise_function_async.go +77 -0
  255. package/linthost/rules_ts_related_getter_setter_pairs.go +113 -0
  256. package/linthost/rules_ts_require_array_sort_compare.go +96 -0
  257. package/linthost/rules_ts_restrict_plus_operands.go +127 -0
  258. package/linthost/rules_ts_restrict_template_expressions.go +95 -0
  259. package/linthost/rules_ts_simple.go +387 -0
  260. package/linthost/rules_ts_sort_type_constituents.go +144 -0
  261. package/linthost/rules_ts_strict_boolean_expressions.go +157 -0
  262. package/linthost/rules_ts_switch_exhaustiveness_check.go +147 -0
  263. package/linthost/rules_ts_unbound_method.go +126 -0
  264. package/linthost/rules_tsdoc.go +136 -0
  265. package/linthost/rules_unicorn_better_regex.go +27 -0
  266. package/linthost/rules_unicorn_catch_error_name.go +46 -0
  267. package/linthost/rules_unicorn_consistent_assert.go +47 -0
  268. package/linthost/rules_unicorn_consistent_date_clone.go +54 -0
  269. package/linthost/rules_unicorn_consistent_destructuring.go +25 -0
  270. package/linthost/rules_unicorn_consistent_empty_array_spread.go +62 -0
  271. package/linthost/rules_unicorn_consistent_existence_index_check.go +80 -0
  272. package/linthost/rules_unicorn_consistent_function_scoping.go +25 -0
  273. package/linthost/rules_unicorn_consistent_template_literal_escape.go +25 -0
  274. package/linthost/rules_unicorn_custom_error_definition.go +138 -0
  275. package/linthost/rules_unicorn_empty_brace_spaces.go +73 -0
  276. package/linthost/rules_unicorn_error_message.go +64 -0
  277. package/linthost/rules_unicorn_escape_case.go +51 -0
  278. package/linthost/rules_unicorn_expiring_todo_comments.go +78 -0
  279. package/linthost/rules_unicorn_explicit_length_check.go +88 -0
  280. package/linthost/rules_unicorn_filename_case.go +29 -0
  281. package/linthost/rules_unicorn_import_style.go +28 -0
  282. package/linthost/rules_unicorn_isolated_functions.go +29 -0
  283. package/linthost/rules_unicorn_new_for_builtins.go +87 -0
  284. package/linthost/rules_unicorn_no_abusive_eslint_disable.go +63 -0
  285. package/linthost/rules_unicorn_no_accessor_recursion.go +115 -0
  286. package/linthost/rules_unicorn_no_anonymous_default_export.go +74 -0
  287. package/linthost/rules_unicorn_no_array_callback_reference.go +65 -0
  288. package/linthost/rules_unicorn_no_array_for_each.go +40 -0
  289. package/linthost/rules_unicorn_no_array_method_this_argument.go +61 -0
  290. package/linthost/rules_unicorn_no_array_reduce.go +41 -0
  291. package/linthost/rules_unicorn_no_array_reverse.go +44 -0
  292. package/linthost/rules_unicorn_no_array_sort.go +43 -0
  293. package/linthost/rules_unicorn_no_await_expression_member.go +40 -0
  294. package/linthost/rules_unicorn_no_await_in_promise_methods.go +69 -0
  295. package/linthost/rules_unicorn_no_console_spaces.go +61 -0
  296. package/linthost/rules_unicorn_no_document_cookie.go +41 -0
  297. package/linthost/rules_unicorn_no_empty_file.go +44 -0
  298. package/linthost/rules_unicorn_no_for_loop.go +102 -0
  299. package/linthost/rules_unicorn_no_hex_escape.go +42 -0
  300. package/linthost/rules_unicorn_no_immediate_mutation.go +90 -0
  301. package/linthost/rules_unicorn_no_instanceof_builtins.go +66 -0
  302. package/linthost/rules_unicorn_no_invalid_fetch_options.go +79 -0
  303. package/linthost/rules_unicorn_no_invalid_remove_event_listener.go +51 -0
  304. package/linthost/rules_unicorn_no_keyword_prefix.go +101 -0
  305. package/linthost/rules_unicorn_no_lonely_if.go +44 -0
  306. package/linthost/rules_unicorn_no_magic_array_flat_depth.go +51 -0
  307. package/linthost/rules_unicorn_no_named_default.go +54 -0
  308. package/linthost/rules_unicorn_no_negated_condition.go +85 -0
  309. package/linthost/rules_unicorn_no_negation_in_equality_check.go +50 -0
  310. package/linthost/rules_unicorn_no_nested_ternary.go +43 -0
  311. package/linthost/rules_unicorn_no_new_array.go +30 -0
  312. package/linthost/rules_unicorn_no_new_buffer.go +31 -0
  313. package/linthost/rules_unicorn_no_null.go +24 -0
  314. package/linthost/rules_unicorn_no_object_as_default_parameter.go +48 -0
  315. package/linthost/rules_unicorn_no_process_exit.go +43 -0
  316. package/linthost/rules_unicorn_no_single_promise_in_promise_methods.go +59 -0
  317. package/linthost/rules_unicorn_no_static_only_class.go +56 -0
  318. package/linthost/rules_unicorn_no_thenable.go +74 -0
  319. package/linthost/rules_unicorn_no_this_assignment.go +35 -0
  320. package/linthost/rules_unicorn_no_typeof_undefined.go +58 -0
  321. package/linthost/rules_unicorn_no_unnecessary_array_flat_depth.go +49 -0
  322. package/linthost/rules_unicorn_no_unnecessary_array_splice_count.go +70 -0
  323. package/linthost/rules_unicorn_no_unnecessary_await.go +51 -0
  324. package/linthost/rules_unicorn_no_unnecessary_polyfills.go +32 -0
  325. package/linthost/rules_unicorn_no_unnecessary_slice_end.go +48 -0
  326. package/linthost/rules_unicorn_no_unreadable_array_destructuring.go +115 -0
  327. package/linthost/rules_unicorn_no_unreadable_iife.go +50 -0
  328. package/linthost/rules_unicorn_no_unused_properties.go +30 -0
  329. package/linthost/rules_unicorn_no_useless_collection_argument.go +63 -0
  330. package/linthost/rules_unicorn_no_useless_error_capture_stack_trace.go +46 -0
  331. package/linthost/rules_unicorn_no_useless_fallback_in_spread.go +81 -0
  332. package/linthost/rules_unicorn_no_useless_iterator_to_array.go +72 -0
  333. package/linthost/rules_unicorn_no_useless_length_check.go +144 -0
  334. package/linthost/rules_unicorn_no_useless_promise_resolve_reject.go +81 -0
  335. package/linthost/rules_unicorn_no_useless_spread.go +67 -0
  336. package/linthost/rules_unicorn_no_useless_switch_case.go +55 -0
  337. package/linthost/rules_unicorn_no_useless_undefined.go +55 -0
  338. package/linthost/rules_unicorn_no_zero_fractions.go +52 -0
  339. package/linthost/rules_unicorn_number_literal_case.go +69 -0
  340. package/linthost/rules_unicorn_numeric_separators_style.go +75 -0
  341. package/linthost/rules_unicorn_prefer_add_event_listener.go +66 -0
  342. package/linthost/rules_unicorn_prefer_array_find.go +51 -0
  343. package/linthost/rules_unicorn_prefer_array_flat.go +52 -0
  344. package/linthost/rules_unicorn_prefer_array_flat_map.go +63 -0
  345. package/linthost/rules_unicorn_prefer_array_index_of.go +147 -0
  346. package/linthost/rules_unicorn_prefer_array_some.go +67 -0
  347. package/linthost/rules_unicorn_prefer_at.go +77 -0
  348. package/linthost/rules_unicorn_prefer_bigint_literals.go +77 -0
  349. package/linthost/rules_unicorn_prefer_blob_reading_methods.go +44 -0
  350. package/linthost/rules_unicorn_prefer_class_fields.go +93 -0
  351. package/linthost/rules_unicorn_prefer_classlist_toggle.go +120 -0
  352. package/linthost/rules_unicorn_prefer_code_point.go +49 -0
  353. package/linthost/rules_unicorn_prefer_date_now.go +78 -0
  354. package/linthost/rules_unicorn_prefer_default_parameters.go +144 -0
  355. package/linthost/rules_unicorn_prefer_dom_node_append.go +40 -0
  356. package/linthost/rules_unicorn_prefer_dom_node_dataset.go +55 -0
  357. package/linthost/rules_unicorn_prefer_dom_node_remove.go +41 -0
  358. package/linthost/rules_unicorn_prefer_dom_node_text_content.go +37 -0
  359. package/linthost/rules_unicorn_prefer_event_target.go +36 -0
  360. package/linthost/rules_unicorn_prefer_export_from.go +129 -0
  361. package/linthost/rules_unicorn_prefer_global_this.go +127 -0
  362. package/linthost/rules_unicorn_prefer_import_meta_properties.go +66 -0
  363. package/linthost/rules_unicorn_prefer_includes.go +149 -0
  364. package/linthost/rules_unicorn_prefer_json_parse_buffer.go +65 -0
  365. package/linthost/rules_unicorn_prefer_keyboard_event_key.go +38 -0
  366. package/linthost/rules_unicorn_prefer_logical_operator_over_ternary.go +48 -0
  367. package/linthost/rules_unicorn_prefer_math_min_max.go +60 -0
  368. package/linthost/rules_unicorn_prefer_math_trunc.go +62 -0
  369. package/linthost/rules_unicorn_prefer_modern_dom_apis.go +47 -0
  370. package/linthost/rules_unicorn_prefer_modern_math_apis.go +70 -0
  371. package/linthost/rules_unicorn_prefer_module.go +50 -0
  372. package/linthost/rules_unicorn_prefer_native_coercion_functions.go +114 -0
  373. package/linthost/rules_unicorn_prefer_negative_index.go +74 -0
  374. package/linthost/rules_unicorn_prefer_node_protocol.go +122 -0
  375. package/linthost/rules_unicorn_prefer_number_properties.go +88 -0
  376. package/linthost/rules_unicorn_prefer_object_from_entries.go +55 -0
  377. package/linthost/rules_unicorn_prefer_optional_catch_binding.go +62 -0
  378. package/linthost/rules_unicorn_prefer_prototype_methods.go +54 -0
  379. package/linthost/rules_unicorn_prefer_query_selector.go +56 -0
  380. package/linthost/rules_unicorn_prefer_reflect_apply.go +36 -0
  381. package/linthost/rules_unicorn_prefer_regexp_test_rule.go +80 -0
  382. package/linthost/rules_unicorn_prefer_response_static_json.go +53 -0
  383. package/linthost/rules_unicorn_prefer_set_has.go +42 -0
  384. package/linthost/rules_unicorn_prefer_set_size.go +48 -0
  385. package/linthost/rules_unicorn_prefer_simple_condition_first.go +34 -0
  386. package/linthost/rules_unicorn_prefer_single_call.go +96 -0
  387. package/linthost/rules_unicorn_prefer_spread.go +51 -0
  388. package/linthost/rules_unicorn_prefer_string_raw.go +43 -0
  389. package/linthost/rules_unicorn_prefer_string_replace_all.go +95 -0
  390. package/linthost/rules_unicorn_prefer_string_slice.go +43 -0
  391. package/linthost/rules_unicorn_prefer_string_starts_ends_with.go +148 -0
  392. package/linthost/rules_unicorn_prefer_string_trim_start_end.go +48 -0
  393. package/linthost/rules_unicorn_prefer_structured_clone.go +71 -0
  394. package/linthost/rules_unicorn_prefer_switch.go +103 -0
  395. package/linthost/rules_unicorn_prefer_ternary.go +71 -0
  396. package/linthost/rules_unicorn_prefer_top_level_await.go +72 -0
  397. package/linthost/rules_unicorn_prefer_type_error.go +127 -0
  398. package/linthost/rules_unicorn_prevent_abbreviations.go +127 -0
  399. package/linthost/rules_unicorn_relative_url_style.go +49 -0
  400. package/linthost/rules_unicorn_require_array_join_separator.go +45 -0
  401. package/linthost/rules_unicorn_require_module_attributes.go +54 -0
  402. package/linthost/rules_unicorn_require_module_specifiers.go +55 -0
  403. package/linthost/rules_unicorn_require_number_to_fixed_digits_argument.go +43 -0
  404. package/linthost/rules_unicorn_require_post_message_target_origin.go +44 -0
  405. package/linthost/rules_unicorn_string_content.go +27 -0
  406. package/linthost/rules_unicorn_switch_case_braces.go +42 -0
  407. package/linthost/rules_unicorn_switch_case_break_position.go +31 -0
  408. package/linthost/rules_unicorn_template_indent.go +28 -0
  409. package/linthost/rules_unicorn_text_encoding_identifier_case.go +72 -0
  410. package/linthost/rules_unicorn_throw_new_error.go +61 -0
  411. package/linthost/rules_var.go +4 -4
  412. package/linthost/rules_vitest.go +568 -0
  413. package/package.json +3 -3
  414. package/plugin/main.go +49 -3
  415. package/rule/astutil/astutil.go +10 -3
  416. package/rule/rule.go +12 -10
  417. package/src/defaultFormat.ts +11 -8
  418. package/src/index.ts +40 -16
  419. package/src/structures/ITtscLintConfig.ts +12 -6
  420. package/src/structures/{ITtscLintFormatConfig.ts → ITtscLintFormat.ts} +2 -2
  421. package/src/structures/TtscLintRuleSetting.ts +55 -0
  422. package/src/structures/index.ts +3 -4
  423. package/src/structures/rules/ITtscLintBoundariesRuleOptions.ts +128 -0
  424. package/src/structures/rules/ITtscLintBoundariesRules.ts +95 -0
  425. package/src/structures/rules/ITtscLintContributorRules.ts +21 -0
  426. package/src/structures/rules/ITtscLintCoreRules.ts +1406 -0
  427. package/src/structures/rules/ITtscLintCypressRuleOptions.ts +18 -0
  428. package/src/structures/rules/ITtscLintCypressRules.ts +145 -0
  429. package/src/structures/rules/ITtscLintFunctionalRuleOptions.ts +213 -0
  430. package/src/structures/rules/ITtscLintFunctionalRules.ts +202 -0
  431. package/src/structures/rules/ITtscLintJestRules.ts +220 -0
  432. package/src/structures/rules/ITtscLintJsdocRules.ts +153 -0
  433. package/src/structures/rules/ITtscLintJsxA11yRules.ts +339 -0
  434. package/src/structures/rules/ITtscLintNextjsRules.ts +206 -0
  435. package/src/structures/rules/ITtscLintPlaywrightRules.ts +361 -0
  436. package/src/structures/rules/ITtscLintPromiseRules.ts +205 -0
  437. package/src/structures/rules/ITtscLintReactPerfRuleOptions.ts +19 -0
  438. package/src/structures/rules/ITtscLintReactPerfRules.ts +55 -0
  439. package/src/structures/rules/ITtscLintReactRuleOptions.ts +43 -0
  440. package/src/structures/rules/ITtscLintReactRules.ts +321 -0
  441. package/src/structures/rules/ITtscLintRegexpRules.ts +212 -0
  442. package/src/structures/rules/ITtscLintRuleOptionsMap.ts +89 -0
  443. package/src/structures/rules/ITtscLintRules.ts +77 -0
  444. package/src/structures/rules/ITtscLintSecurityRules.ts +162 -0
  445. package/src/structures/rules/ITtscLintSolidRules.ts +202 -0
  446. package/src/structures/rules/ITtscLintStorybookRuleOptions.ts +23 -0
  447. package/src/structures/rules/ITtscLintStorybookRules.ts +193 -0
  448. package/src/structures/rules/ITtscLintTanstackQueryRules.ts +102 -0
  449. package/src/structures/rules/ITtscLintTestingLibraryRuleOptions.ts +24 -0
  450. package/src/structures/rules/ITtscLintTestingLibraryRules.ts +342 -0
  451. package/src/structures/rules/ITtscLintTypeScriptRules.ts +1230 -0
  452. package/src/structures/rules/ITtscLintUnicornRules.ts +1143 -0
  453. package/src/structures/rules/ITtscLintVitestRules.ts +154 -0
  454. package/src/structures/rules/index.ts +31 -0
  455. package/lib/structures/ITtscLintFormatConfig.js.map +0 -1
  456. package/lib/structures/TtscLintRule.d.ts +0 -17
  457. package/lib/structures/TtscLintRule.js.map +0 -1
  458. package/lib/structures/TtscLintRuleMap.d.ts +0 -46
  459. package/lib/structures/TtscLintRuleMap.js.map +0 -1
  460. package/lib/structures/TtscLintRuleOptions.d.ts +0 -137
  461. package/lib/structures/TtscLintRuleOptions.js.map +0 -1
  462. package/src/structures/TtscLintRule.ts +0 -160
  463. package/src/structures/TtscLintRuleMap.ts +0 -55
  464. package/src/structures/TtscLintRuleOptions.ts +0 -151
@@ -0,0 +1,697 @@
1
+ package linthost
2
+
3
+ import (
4
+ "net/url"
5
+ "path/filepath"
6
+ "strings"
7
+
8
+ shimast "github.com/microsoft/typescript-go/shim/ast"
9
+ )
10
+
11
+ type nextjsRule struct {
12
+ name string
13
+ check func(*Context, *shimast.Node)
14
+ }
15
+
16
+ func (r nextjsRule) Name() string { return "nextjs/" + r.name }
17
+ func (r nextjsRule) Visits() []shimast.Kind {
18
+ return []shimast.Kind{shimast.KindSourceFile}
19
+ }
20
+ func (r nextjsRule) Check(ctx *Context, node *shimast.Node) { r.check(ctx, node) }
21
+
22
+ type nextjsImports struct {
23
+ headFromNextHead map[string]bool
24
+ headFromNextDocument map[string]bool
25
+ scriptFromNextScript map[string]bool
26
+ importsNextDocument []*shimast.Node
27
+ importsNextHead []*shimast.Node
28
+ }
29
+
30
+ func nextjsGoogleFontDisplay(ctx *Context, file *shimast.Node) {
31
+ nextjsWalkOpeningLike(file, func(opening *shimast.Node) {
32
+ if nextjsJSXName(opening) != "link" {
33
+ return
34
+ }
35
+ href := nextjsJSXAttrString(opening, "href")
36
+ if !strings.HasPrefix(href, "https://fonts.googleapis.com/css") {
37
+ return
38
+ }
39
+ u, err := url.Parse(href)
40
+ if err != nil {
41
+ return
42
+ }
43
+ display := u.Query().Get("display")
44
+ switch display {
45
+ case "", "auto", "block", "fallback":
46
+ ctx.Report(opening, "Add a supported `display` query value to Google Fonts stylesheet links.")
47
+ }
48
+ })
49
+ }
50
+
51
+ func nextjsGoogleFontPreconnect(ctx *Context, file *shimast.Node) {
52
+ nextjsWalkOpeningLike(file, func(opening *shimast.Node) {
53
+ if nextjsJSXName(opening) != "link" || !strings.HasPrefix(nextjsJSXAttrString(opening, "href"), "https://fonts.gstatic.com") {
54
+ return
55
+ }
56
+ if strings.ToLower(nextjsJSXAttrString(opening, "rel")) != "preconnect" {
57
+ ctx.Report(opening, "Use `rel=\"preconnect\"` when linking to fonts.gstatic.com.")
58
+ }
59
+ })
60
+ }
61
+
62
+ func nextjsInlineScriptID(ctx *Context, file *shimast.Node) {
63
+ imports := nextjsCollectImports(file)
64
+ if len(imports.scriptFromNextScript) == 0 {
65
+ return
66
+ }
67
+ walkDescendants(file, func(node *shimast.Node) {
68
+ if node.Kind != shimast.KindJsxElement {
69
+ return
70
+ }
71
+ opening := node.AsJsxElement().OpeningElement
72
+ if !imports.scriptFromNextScript[nextjsJSXName(opening)] || nextjsJSXHasAttr(opening, "id") {
73
+ return
74
+ }
75
+ if nextjsJSXHasAttr(opening, "dangerouslySetInnerHTML") || nextjsJSXElementHasContent(ctx.File, node) {
76
+ ctx.Report(opening, "Inline `next/script` content must include a stable `id` attribute.")
77
+ }
78
+ })
79
+ }
80
+
81
+ func nextjsNextScriptForGA(ctx *Context, file *shimast.Node) {
82
+ imports := nextjsCollectImports(file)
83
+ if len(imports.scriptFromNextScript) == 0 {
84
+ return
85
+ }
86
+ walkDescendants(file, func(node *shimast.Node) {
87
+ if node.Kind != shimast.KindJsxElement && node.Kind != shimast.KindJsxSelfClosingElement {
88
+ return
89
+ }
90
+ opening := nextjsOpeningLike(node)
91
+ if !imports.scriptFromNextScript[nextjsJSXName(opening)] {
92
+ return
93
+ }
94
+ src := nextjsJSXAttrString(opening, "src")
95
+ if strings.Contains(src, "googletagmanager.com/gtag/js") || strings.Contains(src, "googletagmanager.com/gtm.js") {
96
+ ctx.Report(opening, "Use Next.js Google Analytics helpers instead of hand-written gtag scripts.")
97
+ return
98
+ }
99
+ if node.Kind == shimast.KindJsxElement {
100
+ text := nodeText(ctx.File, node)
101
+ if strings.Contains(text, "gtag(") || strings.Contains(text, "GTM-") {
102
+ ctx.Report(opening, "Use Next.js Google Analytics helpers instead of hand-written gtag scripts.")
103
+ }
104
+ }
105
+ })
106
+ }
107
+
108
+ func nextjsNoAssignModuleVariable(ctx *Context, file *shimast.Node) {
109
+ walkDescendants(file, func(node *shimast.Node) {
110
+ if node.Kind != shimast.KindVariableDeclaration {
111
+ return
112
+ }
113
+ if identifierText(node.AsVariableDeclaration().Name()) == "module" {
114
+ ctx.Report(node.AsVariableDeclaration().Name(), "Do not assign the reserved `module` variable name.")
115
+ }
116
+ })
117
+ }
118
+
119
+ func nextjsNoAsyncClientComponent(ctx *Context, file *shimast.Node) {
120
+ if !nextjsHasUseClientDirective(file) {
121
+ return
122
+ }
123
+ asyncBindings := map[string]*shimast.Node{}
124
+ for _, stmt := range file.Statements() {
125
+ if stmt == nil {
126
+ continue
127
+ }
128
+ if stmt.Kind == shimast.KindFunctionDeclaration {
129
+ name := identifierText(stmt.AsFunctionDeclaration().Name())
130
+ if name != "" && nextjsHasModifier(stmt, shimast.KindAsyncKeyword) {
131
+ asyncBindings[name] = stmt
132
+ }
133
+ if nextjsHasModifier(stmt, shimast.KindDefaultKeyword) && nextjsHasModifier(stmt, shimast.KindAsyncKeyword) && (name == "" || nextjsIsCapitalized(name)) {
134
+ ctx.Report(stmt, "Client components must not be async functions.")
135
+ }
136
+ continue
137
+ }
138
+ if stmt.Kind == shimast.KindVariableStatement {
139
+ decls := stmt.AsVariableStatement().DeclarationList.AsVariableDeclarationList().Declarations
140
+ if decls == nil {
141
+ continue
142
+ }
143
+ for _, decl := range decls.Nodes {
144
+ name := identifierText(decl.AsVariableDeclaration().Name())
145
+ if name == "" || !nextjsIsAsyncFunctionLike(decl.AsVariableDeclaration().Initializer) {
146
+ continue
147
+ }
148
+ asyncBindings[name] = decl
149
+ }
150
+ }
151
+ }
152
+ for _, stmt := range file.Statements() {
153
+ if stmt == nil || stmt.Kind != shimast.KindExportAssignment {
154
+ continue
155
+ }
156
+ export := stmt.AsExportAssignment()
157
+ if export == nil || export.IsExportEquals || export.Expression == nil {
158
+ continue
159
+ }
160
+ expr := stripParens(export.Expression)
161
+ if nextjsIsAsyncFunctionLike(expr) {
162
+ ctx.Report(expr, "Client components must not be async functions.")
163
+ continue
164
+ }
165
+ name := identifierText(expr)
166
+ if nextjsIsCapitalized(name) && asyncBindings[name] != nil {
167
+ ctx.Report(expr, "Client components must not be async functions.")
168
+ }
169
+ }
170
+ }
171
+
172
+ func nextjsNoBeforeInteractiveScriptOutsideDocument(ctx *Context, file *shimast.Node) {
173
+ if nextjsIsDocumentFile(ctx.File) {
174
+ return
175
+ }
176
+ imports := nextjsCollectImports(file)
177
+ if len(imports.scriptFromNextScript) == 0 {
178
+ return
179
+ }
180
+ nextjsWalkOpeningLike(file, func(opening *shimast.Node) {
181
+ if imports.scriptFromNextScript[nextjsJSXName(opening)] && nextjsJSXAttrString(opening, "strategy") == "beforeInteractive" {
182
+ ctx.Report(opening, "`beforeInteractive` scripts belong in pages/_document.")
183
+ }
184
+ })
185
+ }
186
+
187
+ func nextjsNoCSSTags(ctx *Context, file *shimast.Node) {
188
+ nextjsWalkOpeningLike(file, func(opening *shimast.Node) {
189
+ if nextjsJSXName(opening) == "link" && strings.ToLower(nextjsJSXAttrString(opening, "rel")) == "stylesheet" && nextjsJSXAttrString(opening, "href") != "" {
190
+ ctx.Report(opening, "Import stylesheets through Next.js-supported CSS imports instead of raw `<link>` tags.")
191
+ }
192
+ })
193
+ }
194
+
195
+ func nextjsNoDocumentImportInPage(ctx *Context, file *shimast.Node) {
196
+ if !nextjsIsPagesFile(ctx.File) || nextjsIsDocumentFile(ctx.File) {
197
+ return
198
+ }
199
+ for _, node := range nextjsCollectImports(file).importsNextDocument {
200
+ ctx.Report(node, "`next/document` may only be imported from pages/_document.")
201
+ }
202
+ }
203
+
204
+ func nextjsNoDuplicateHead(ctx *Context, file *shimast.Node) {
205
+ if !nextjsIsDocumentFile(ctx.File) {
206
+ return
207
+ }
208
+ imports := nextjsCollectImports(file)
209
+ var seen bool
210
+ nextjsWalkOpeningLike(file, func(opening *shimast.Node) {
211
+ if !imports.headFromNextDocument[nextjsJSXName(opening)] {
212
+ return
213
+ }
214
+ if seen {
215
+ ctx.Report(opening, "pages/_document must not render more than one `Head` from next/document.")
216
+ return
217
+ }
218
+ seen = true
219
+ })
220
+ }
221
+
222
+ func nextjsNoHeadElement(ctx *Context, file *shimast.Node) {
223
+ if nextjsIsAppDirFile(ctx.File) {
224
+ return
225
+ }
226
+ nextjsWalkOpeningLike(file, func(opening *shimast.Node) {
227
+ if nextjsJSXName(opening) == "head" {
228
+ ctx.Report(opening, "Use Next.js head management instead of a raw `<head>` element.")
229
+ }
230
+ })
231
+ }
232
+
233
+ func nextjsNoHeadImportInDocument(ctx *Context, file *shimast.Node) {
234
+ if !nextjsIsDocumentFile(ctx.File) {
235
+ return
236
+ }
237
+ for _, node := range nextjsCollectImports(file).importsNextHead {
238
+ ctx.Report(node, "Import `Head` from next/document inside pages/_document, not next/head.")
239
+ }
240
+ }
241
+
242
+ func nextjsNoHTMLLinkForPages(ctx *Context, file *shimast.Node) {
243
+ nextjsWalkOpeningLike(file, func(opening *shimast.Node) {
244
+ href := nextjsJSXAttrString(opening, "href")
245
+ if nextjsJSXName(opening) == "a" && nextjsIsInternalPageHref(href) {
246
+ ctx.Report(opening, "Use `next/link` for internal page navigation.")
247
+ }
248
+ })
249
+ }
250
+
251
+ func nextjsNoImgElement(ctx *Context, file *shimast.Node) {
252
+ nextjsWalkOpeningLike(file, func(opening *shimast.Node) {
253
+ if nextjsJSXName(opening) == "img" && !nextjsIsInsideJSXElement(opening, "picture") {
254
+ ctx.Report(opening, "Use `next/image` instead of a raw `<img>` element.")
255
+ }
256
+ })
257
+ }
258
+
259
+ func nextjsNoPageCustomFont(ctx *Context, file *shimast.Node) {
260
+ if !nextjsIsPagesFile(ctx.File) || nextjsIsDocumentFile(ctx.File) {
261
+ return
262
+ }
263
+ nextjsWalkOpeningLike(file, func(opening *shimast.Node) {
264
+ if nextjsJSXName(opening) == "link" && strings.HasPrefix(nextjsJSXAttrString(opening, "href"), "https://fonts.googleapis.com/css") {
265
+ ctx.Report(opening, "Place custom Google font links in pages/_document so they load on every page.")
266
+ }
267
+ })
268
+ }
269
+
270
+ func nextjsNoScriptComponentInHead(ctx *Context, file *shimast.Node) {
271
+ imports := nextjsCollectImports(file)
272
+ if len(imports.headFromNextHead) == 0 || len(imports.scriptFromNextScript) == 0 {
273
+ return
274
+ }
275
+ walkDescendants(file, func(node *shimast.Node) {
276
+ if node.Kind != shimast.KindJsxElement {
277
+ return
278
+ }
279
+ opening := node.AsJsxElement().OpeningElement
280
+ if !imports.headFromNextHead[nextjsJSXName(opening)] {
281
+ return
282
+ }
283
+ walkDescendants(node, func(child *shimast.Node) {
284
+ if child == node || (child.Kind != shimast.KindJsxElement && child.Kind != shimast.KindJsxSelfClosingElement) {
285
+ return
286
+ }
287
+ childOpening := nextjsOpeningLike(child)
288
+ if imports.scriptFromNextScript[nextjsJSXName(childOpening)] {
289
+ ctx.Report(childOpening, "Do not place `next/script` inside `next/head`.")
290
+ }
291
+ })
292
+ })
293
+ }
294
+
295
+ func nextjsNoStyledJSXInDocument(ctx *Context, file *shimast.Node) {
296
+ if !nextjsIsDocumentFile(ctx.File) {
297
+ return
298
+ }
299
+ nextjsWalkOpeningLike(file, func(opening *shimast.Node) {
300
+ if nextjsJSXName(opening) == "style" && nextjsJSXHasAttr(opening, "jsx") {
301
+ ctx.Report(opening, "Do not use styled-jsx inside pages/_document.")
302
+ }
303
+ })
304
+ }
305
+
306
+ func nextjsNoSyncScripts(ctx *Context, file *shimast.Node) {
307
+ nextjsWalkOpeningLike(file, func(opening *shimast.Node) {
308
+ if nextjsJSXName(opening) == "script" && nextjsJSXAttrString(opening, "src") != "" && !nextjsJSXHasAttr(opening, "async") && !nextjsJSXHasAttr(opening, "defer") {
309
+ ctx.Report(opening, "Add `async` or `defer` to external `<script>` tags.")
310
+ }
311
+ })
312
+ }
313
+
314
+ func nextjsNoTitleInDocumentHead(ctx *Context, file *shimast.Node) {
315
+ if !nextjsIsDocumentFile(ctx.File) {
316
+ return
317
+ }
318
+ imports := nextjsCollectImports(file)
319
+ walkDescendants(file, func(node *shimast.Node) {
320
+ if node.Kind != shimast.KindJsxElement {
321
+ return
322
+ }
323
+ opening := node.AsJsxElement().OpeningElement
324
+ if !imports.headFromNextDocument[nextjsJSXName(opening)] {
325
+ return
326
+ }
327
+ walkDescendants(node, func(child *shimast.Node) {
328
+ if child != node && (child.Kind == shimast.KindJsxElement || child.Kind == shimast.KindJsxSelfClosingElement) && nextjsJSXName(nextjsOpeningLike(child)) == "title" {
329
+ ctx.Report(nextjsOpeningLike(child), "Do not render `<title>` inside pages/_document Head.")
330
+ }
331
+ })
332
+ })
333
+ }
334
+
335
+ func nextjsNoTypos(ctx *Context, file *shimast.Node) {
336
+ if !nextjsIsPagesFile(ctx.File) || nextjsIsAPIPagesFile(ctx.File) {
337
+ return
338
+ }
339
+ wanted := []string{"getStaticProps", "getStaticPaths", "getServerSideProps"}
340
+ for _, stmt := range file.Statements() {
341
+ if stmt == nil {
342
+ continue
343
+ }
344
+ nameNode := nextjsExportedNameNode(stmt)
345
+ name := identifierText(nameNode)
346
+ if name == "" {
347
+ continue
348
+ }
349
+ for _, target := range wanted {
350
+ if name != target && nextjsEditDistance(name, target) == 1 {
351
+ ctx.Report(nameNode, "Possible typo in Next.js data-fetching export name.")
352
+ }
353
+ }
354
+ }
355
+ }
356
+
357
+ func nextjsNoUnwantedPolyfillIO(ctx *Context, file *shimast.Node) {
358
+ imports := nextjsCollectImports(file)
359
+ nextjsWalkOpeningLike(file, func(opening *shimast.Node) {
360
+ name := nextjsJSXName(opening)
361
+ if name != "script" && !imports.scriptFromNextScript[name] {
362
+ return
363
+ }
364
+ src := nextjsJSXAttrString(opening, "src")
365
+ if strings.Contains(src, "polyfill.io") || strings.Contains(src, "polyfill-fastly.io") {
366
+ ctx.Report(opening, "Avoid Polyfill.io scripts in Next.js pages.")
367
+ }
368
+ })
369
+ }
370
+
371
+ func nextjsCollectImports(file *shimast.Node) nextjsImports {
372
+ imports := nextjsImports{
373
+ headFromNextHead: map[string]bool{},
374
+ headFromNextDocument: map[string]bool{},
375
+ scriptFromNextScript: map[string]bool{},
376
+ }
377
+ for _, stmt := range file.Statements() {
378
+ if stmt == nil || stmt.Kind != shimast.KindImportDeclaration {
379
+ continue
380
+ }
381
+ decl := stmt.AsImportDeclaration()
382
+ mod := stringLiteralText(decl.ModuleSpecifier)
383
+ switch mod {
384
+ case "next/head":
385
+ imports.importsNextHead = append(imports.importsNextHead, stmt)
386
+ nextjsCollectDefaultImportName(decl, imports.headFromNextHead)
387
+ case "next/document":
388
+ imports.importsNextDocument = append(imports.importsNextDocument, stmt)
389
+ nextjsCollectNamedImportName(decl, "Head", imports.headFromNextDocument)
390
+ case "next/script":
391
+ nextjsCollectDefaultImportName(decl, imports.scriptFromNextScript)
392
+ }
393
+ }
394
+ return imports
395
+ }
396
+
397
+ func nextjsCollectDefaultImportName(decl *shimast.ImportDeclaration, names map[string]bool) {
398
+ if decl == nil || decl.ImportClause == nil {
399
+ return
400
+ }
401
+ clause := decl.ImportClause.AsImportClause()
402
+ if clause != nil && clause.Name() != nil {
403
+ names[identifierText(clause.Name())] = true
404
+ }
405
+ }
406
+
407
+ func nextjsCollectNamedImportName(decl *shimast.ImportDeclaration, imported string, names map[string]bool) {
408
+ if decl == nil || decl.ImportClause == nil {
409
+ return
410
+ }
411
+ clause := decl.ImportClause.AsImportClause()
412
+ if clause == nil || clause.NamedBindings == nil || clause.NamedBindings.Kind != shimast.KindNamedImports {
413
+ return
414
+ }
415
+ named := clause.NamedBindings.AsNamedImports()
416
+ if named == nil || named.Elements == nil {
417
+ return
418
+ }
419
+ for _, spec := range named.Elements.Nodes {
420
+ s := spec.AsImportSpecifier()
421
+ if s == nil {
422
+ continue
423
+ }
424
+ importedName := identifierText(s.Name())
425
+ if s.PropertyName != nil {
426
+ importedName = identifierText(s.PropertyName)
427
+ }
428
+ if importedName == imported {
429
+ names[identifierText(s.Name())] = true
430
+ }
431
+ }
432
+ }
433
+
434
+ func nextjsWalkOpeningLike(file *shimast.Node, visit func(*shimast.Node)) {
435
+ walkDescendants(file, func(node *shimast.Node) {
436
+ switch node.Kind {
437
+ case shimast.KindJsxOpeningElement, shimast.KindJsxSelfClosingElement:
438
+ visit(node)
439
+ }
440
+ })
441
+ }
442
+
443
+ func nextjsOpeningLike(node *shimast.Node) *shimast.Node {
444
+ if node == nil {
445
+ return nil
446
+ }
447
+ switch node.Kind {
448
+ case shimast.KindJsxElement:
449
+ return node.AsJsxElement().OpeningElement
450
+ case shimast.KindJsxOpeningElement, shimast.KindJsxSelfClosingElement:
451
+ return node
452
+ }
453
+ return nil
454
+ }
455
+
456
+ func nextjsJSXName(opening *shimast.Node) string {
457
+ if opening == nil {
458
+ return ""
459
+ }
460
+ switch opening.Kind {
461
+ case shimast.KindJsxOpeningElement:
462
+ return shimast.NodeText(opening.AsJsxOpeningElement().TagName)
463
+ case shimast.KindJsxSelfClosingElement:
464
+ return shimast.NodeText(opening.AsJsxSelfClosingElement().TagName)
465
+ }
466
+ return ""
467
+ }
468
+
469
+ func nextjsJSXAttrs(opening *shimast.Node) []*shimast.Node {
470
+ var attrs *shimast.Node
471
+ switch {
472
+ case opening == nil:
473
+ return nil
474
+ case opening.Kind == shimast.KindJsxOpeningElement:
475
+ attrs = opening.AsJsxOpeningElement().Attributes
476
+ case opening.Kind == shimast.KindJsxSelfClosingElement:
477
+ attrs = opening.AsJsxSelfClosingElement().Attributes
478
+ }
479
+ if attrs == nil {
480
+ return nil
481
+ }
482
+ jsxs := attrs.AsJsxAttributes()
483
+ if jsxs == nil || jsxs.Properties == nil {
484
+ return nil
485
+ }
486
+ return jsxs.Properties.Nodes
487
+ }
488
+
489
+ func nextjsJSXAttr(opening *shimast.Node, name string) *shimast.Node {
490
+ for _, attrNode := range nextjsJSXAttrs(opening) {
491
+ if attrNode.Kind != shimast.KindJsxAttribute {
492
+ continue
493
+ }
494
+ attr := attrNode.AsJsxAttribute()
495
+ if shimast.NodeText(attr.Name()) == name {
496
+ return attrNode
497
+ }
498
+ }
499
+ return nil
500
+ }
501
+
502
+ func nextjsJSXHasAttr(opening *shimast.Node, name string) bool {
503
+ return nextjsJSXAttr(opening, name) != nil
504
+ }
505
+
506
+ func nextjsJSXAttrString(opening *shimast.Node, name string) string {
507
+ attrNode := nextjsJSXAttr(opening, name)
508
+ if attrNode == nil {
509
+ return ""
510
+ }
511
+ init := attrNode.AsJsxAttribute().Initializer
512
+ if init == nil {
513
+ return "true"
514
+ }
515
+ if text := stringLiteralText(init); text != "" {
516
+ return text
517
+ }
518
+ if init.Kind == shimast.KindJsxExpression {
519
+ expr := init.AsJsxExpression().Expression
520
+ if text := stringLiteralText(expr); text != "" {
521
+ return text
522
+ }
523
+ }
524
+ return ""
525
+ }
526
+
527
+ func nextjsJSXElementHasContent(file *shimast.SourceFile, node *shimast.Node) bool {
528
+ if node == nil || node.Kind != shimast.KindJsxElement {
529
+ return false
530
+ }
531
+ children := node.AsJsxElement().Children
532
+ if children == nil {
533
+ return false
534
+ }
535
+ for _, child := range children.Nodes {
536
+ if child == nil {
537
+ continue
538
+ }
539
+ switch child.Kind {
540
+ case shimast.KindJsxText, shimast.KindJsxTextAllWhiteSpaces:
541
+ if strings.TrimSpace(nodeText(file, child)) != "" {
542
+ return true
543
+ }
544
+ case shimast.KindJsxExpression:
545
+ if child.AsJsxExpression().Expression != nil {
546
+ return true
547
+ }
548
+ default:
549
+ return true
550
+ }
551
+ }
552
+ return false
553
+ }
554
+
555
+ func nextjsIsInsideJSXElement(node *shimast.Node, name string) bool {
556
+ for cur := node; cur != nil; cur = cur.Parent {
557
+ if cur.Kind == shimast.KindJsxElement && nextjsJSXName(cur.AsJsxElement().OpeningElement) == name {
558
+ return true
559
+ }
560
+ }
561
+ return false
562
+ }
563
+
564
+ func nextjsHasUseClientDirective(file *shimast.Node) bool {
565
+ for _, stmt := range file.Statements() {
566
+ if stmt == nil || stmt.Kind != shimast.KindExpressionStatement {
567
+ return false
568
+ }
569
+ expr := stripParens(stmt.AsExpressionStatement().Expression)
570
+ if stringLiteralText(expr) == "use client" {
571
+ return true
572
+ }
573
+ if stringLiteralText(expr) == "" {
574
+ return false
575
+ }
576
+ }
577
+ return false
578
+ }
579
+
580
+ func nextjsIsAsyncFunctionLike(node *shimast.Node) bool {
581
+ node = stripParens(node)
582
+ if node == nil {
583
+ return false
584
+ }
585
+ switch node.Kind {
586
+ case shimast.KindFunctionExpression, shimast.KindArrowFunction, shimast.KindFunctionDeclaration:
587
+ return nextjsHasModifier(node, shimast.KindAsyncKeyword)
588
+ }
589
+ return false
590
+ }
591
+
592
+ func nextjsHasModifier(node *shimast.Node, kind shimast.Kind) bool {
593
+ if node == nil || node.Modifiers() == nil {
594
+ return false
595
+ }
596
+ for _, mod := range node.Modifiers().Nodes {
597
+ if mod != nil && mod.Kind == kind {
598
+ return true
599
+ }
600
+ }
601
+ return false
602
+ }
603
+
604
+ func nextjsIsCapitalized(name string) bool {
605
+ return name != "" && name[0] >= 'A' && name[0] <= 'Z'
606
+ }
607
+
608
+ func nextjsFilePath(file *shimast.SourceFile) string {
609
+ if file == nil {
610
+ return ""
611
+ }
612
+ return filepath.ToSlash(file.FileName())
613
+ }
614
+
615
+ func nextjsIsPagesFile(file *shimast.SourceFile) bool {
616
+ path := nextjsFilePath(file)
617
+ return strings.Contains(path, "/pages/") || strings.HasSuffix(path, "/pages.tsx") || strings.HasSuffix(path, "/pages.ts")
618
+ }
619
+
620
+ func nextjsIsAPIPagesFile(file *shimast.SourceFile) bool {
621
+ return strings.Contains(nextjsFilePath(file), "/pages/api/")
622
+ }
623
+
624
+ func nextjsIsDocumentFile(file *shimast.SourceFile) bool {
625
+ path := nextjsFilePath(file)
626
+ return strings.Contains(path, "/pages/_document.") || strings.HasSuffix(path, "/pages/_document")
627
+ }
628
+
629
+ func nextjsIsAppDirFile(file *shimast.SourceFile) bool {
630
+ return strings.Contains(nextjsFilePath(file), "/app/")
631
+ }
632
+
633
+ func nextjsIsInternalPageHref(href string) bool {
634
+ return strings.HasPrefix(href, "/") && !strings.HasPrefix(href, "//") && !strings.Contains(href, ".")
635
+ }
636
+
637
+ func nextjsExportedNameNode(stmt *shimast.Node) *shimast.Node {
638
+ switch stmt.Kind {
639
+ case shimast.KindFunctionDeclaration:
640
+ if nextjsHasModifier(stmt, shimast.KindExportKeyword) {
641
+ return stmt.AsFunctionDeclaration().Name()
642
+ }
643
+ case shimast.KindVariableStatement:
644
+ if !nextjsHasModifier(stmt, shimast.KindExportKeyword) {
645
+ return nil
646
+ }
647
+ decls := stmt.AsVariableStatement().DeclarationList.AsVariableDeclarationList().Declarations
648
+ if decls != nil && len(decls.Nodes) == 1 {
649
+ return decls.Nodes[0].AsVariableDeclaration().Name()
650
+ }
651
+ }
652
+ return nil
653
+ }
654
+
655
+ func nextjsEditDistance(a, b string) int {
656
+ prev := make([]int, len(b)+1)
657
+ for j := range prev {
658
+ prev[j] = j
659
+ }
660
+ for i := 1; i <= len(a); i++ {
661
+ cur := make([]int, len(b)+1)
662
+ cur[0] = i
663
+ for j := 1; j <= len(b); j++ {
664
+ cost := 0
665
+ if a[i-1] != b[j-1] {
666
+ cost = 1
667
+ }
668
+ cur[j] = min(prev[j]+1, cur[j-1]+1, prev[j-1]+cost)
669
+ }
670
+ prev = cur
671
+ }
672
+ return prev[len(b)]
673
+ }
674
+
675
+ func init() {
676
+ Register(nextjsRule{name: "google-font-display", check: nextjsGoogleFontDisplay})
677
+ Register(nextjsRule{name: "google-font-preconnect", check: nextjsGoogleFontPreconnect})
678
+ Register(nextjsRule{name: "inline-script-id", check: nextjsInlineScriptID})
679
+ Register(nextjsRule{name: "next-script-for-ga", check: nextjsNextScriptForGA})
680
+ Register(nextjsRule{name: "no-assign-module-variable", check: nextjsNoAssignModuleVariable})
681
+ Register(nextjsRule{name: "no-async-client-component", check: nextjsNoAsyncClientComponent})
682
+ Register(nextjsRule{name: "no-before-interactive-script-outside-document", check: nextjsNoBeforeInteractiveScriptOutsideDocument})
683
+ Register(nextjsRule{name: "no-css-tags", check: nextjsNoCSSTags})
684
+ Register(nextjsRule{name: "no-document-import-in-page", check: nextjsNoDocumentImportInPage})
685
+ Register(nextjsRule{name: "no-duplicate-head", check: nextjsNoDuplicateHead})
686
+ Register(nextjsRule{name: "no-head-element", check: nextjsNoHeadElement})
687
+ Register(nextjsRule{name: "no-head-import-in-document", check: nextjsNoHeadImportInDocument})
688
+ Register(nextjsRule{name: "no-html-link-for-pages", check: nextjsNoHTMLLinkForPages})
689
+ Register(nextjsRule{name: "no-img-element", check: nextjsNoImgElement})
690
+ Register(nextjsRule{name: "no-page-custom-font", check: nextjsNoPageCustomFont})
691
+ Register(nextjsRule{name: "no-script-component-in-head", check: nextjsNoScriptComponentInHead})
692
+ Register(nextjsRule{name: "no-styled-jsx-in-document", check: nextjsNoStyledJSXInDocument})
693
+ Register(nextjsRule{name: "no-sync-scripts", check: nextjsNoSyncScripts})
694
+ Register(nextjsRule{name: "no-title-in-document-head", check: nextjsNoTitleInDocumentHead})
695
+ Register(nextjsRule{name: "no-typos", check: nextjsNoTypos})
696
+ Register(nextjsRule{name: "no-unwanted-polyfillio", check: nextjsNoUnwantedPolyfillIO})
697
+ }