dart-decimate 0.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 (188) hide show
  1. package/Cargo.lock +572 -0
  2. package/Cargo.toml +41 -0
  3. package/LICENSE +21 -0
  4. package/README.md +617 -0
  5. package/assets/dart-decimate-banner.png +0 -0
  6. package/npm/bin/dart-decimate-mcp.js +48 -0
  7. package/npm/bin/dart-decimate.js +48 -0
  8. package/npm/scripts/postinstall.js +46 -0
  9. package/npm/scripts/test-npx-local.js +54 -0
  10. package/npm/scripts/test-npx-mcp-local.js +56 -0
  11. package/package.json +45 -0
  12. package/src/baseline.rs +643 -0
  13. package/src/bin/dart-decimate-mcp.rs +11 -0
  14. package/src/boundaries/tests.rs +60 -0
  15. package/src/boundaries.rs +317 -0
  16. package/src/changed_scope.rs +117 -0
  17. package/src/ci_template.rs +399 -0
  18. package/src/cli/analyze.rs +462 -0
  19. package/src/cli/analyzer_options.rs +82 -0
  20. package/src/cli/audit_run.rs +327 -0
  21. package/src/cli/boundary_args.rs +44 -0
  22. package/src/cli/ci_template_run.rs +196 -0
  23. package/src/cli/command_name.rs +20 -0
  24. package/src/cli/common_args.rs +167 -0
  25. package/src/cli/config_run.rs +78 -0
  26. package/src/cli/coverage_run.rs +393 -0
  27. package/src/cli/decision_surface_run.rs +99 -0
  28. package/src/cli/default_command.rs +69 -0
  29. package/src/cli/dupes_args.rs +150 -0
  30. package/src/cli/entry_points.rs +121 -0
  31. package/src/cli/error.rs +149 -0
  32. package/src/cli/error_output.rs +68 -0
  33. package/src/cli/explain_run.rs +72 -0
  34. package/src/cli/fix_run.rs +162 -0
  35. package/src/cli/flags_args.rs +23 -0
  36. package/src/cli/health_args.rs +200 -0
  37. package/src/cli/hooks_run.rs +191 -0
  38. package/src/cli/impact_run.rs +95 -0
  39. package/src/cli/init_run.rs +49 -0
  40. package/src/cli/inspect_args.rs +20 -0
  41. package/src/cli/inspect_run.rs +66 -0
  42. package/src/cli/issue_filter_args.rs +240 -0
  43. package/src/cli/list_run.rs +311 -0
  44. package/src/cli/mode_args.rs +72 -0
  45. package/src/cli/output_format.rs +62 -0
  46. package/src/cli/regression_args.rs +156 -0
  47. package/src/cli/request_args.rs +175 -0
  48. package/src/cli/schema_commands.rs +72 -0
  49. package/src/cli/scope_args.rs +174 -0
  50. package/src/cli/security_args.rs +175 -0
  51. package/src/cli/security_gate_run.rs +66 -0
  52. package/src/cli/security_summary_run.rs +43 -0
  53. package/src/cli/summary_args.rs +12 -0
  54. package/src/cli/tests.rs +516 -0
  55. package/src/cli/trace_args.rs +67 -0
  56. package/src/cli/trace_run.rs +131 -0
  57. package/src/cli/trace_tests.rs +235 -0
  58. package/src/cli/unsupported_run.rs +116 -0
  59. package/src/cli/watch_run.rs +153 -0
  60. package/src/cli.rs +603 -0
  61. package/src/config/boundary_config.rs +235 -0
  62. package/src/config/cache.rs +25 -0
  63. package/src/config/dependencies.rs +114 -0
  64. package/src/config/health.rs +237 -0
  65. package/src/config/jsonc.rs +66 -0
  66. package/src/config/policy.rs +91 -0
  67. package/src/config/rule_aliases.rs +487 -0
  68. package/src/config/rules.rs +339 -0
  69. package/src/config.rs +635 -0
  70. package/src/coverage.rs +469 -0
  71. package/src/dart_parser.rs +673 -0
  72. package/src/decision_surface.rs +405 -0
  73. package/src/dependencies/analyze.rs +218 -0
  74. package/src/dependencies/codegen.rs +118 -0
  75. package/src/dependencies/discovery.rs +60 -0
  76. package/src/dependencies/overrides.rs +76 -0
  77. package/src/dependencies/private_src_imports.rs +32 -0
  78. package/src/dependencies/pubspec_document.rs +86 -0
  79. package/src/dependencies/pubspec_entry.rs +96 -0
  80. package/src/dependencies/tests.rs +544 -0
  81. package/src/dependencies/usage.rs +33 -0
  82. package/src/dependencies.rs +553 -0
  83. package/src/dependency_scripts.rs +91 -0
  84. package/src/dupes/lex.rs +236 -0
  85. package/src/dupes/tests.rs +119 -0
  86. package/src/dupes.rs +625 -0
  87. package/src/explain.rs +692 -0
  88. package/src/extract/directives.rs +252 -0
  89. package/src/extract/error_tests.rs +25 -0
  90. package/src/extract/members.rs +210 -0
  91. package/src/extract/primary_constructors.rs +421 -0
  92. package/src/extract/references.rs +151 -0
  93. package/src/extract/routes.rs +691 -0
  94. package/src/extract/signatures.rs +266 -0
  95. package/src/extract/string_tests.rs +18 -0
  96. package/src/extract/strings.rs +107 -0
  97. package/src/extract/tests.rs +697 -0
  98. package/src/extract.rs +680 -0
  99. package/src/feature_flags/tests.rs +76 -0
  100. package/src/feature_flags.rs +453 -0
  101. package/src/finding_identity.rs +60 -0
  102. package/src/fix.rs +551 -0
  103. package/src/generated.rs +53 -0
  104. package/src/graph/augment_tests.rs +212 -0
  105. package/src/graph/conditionals.rs +74 -0
  106. package/src/graph/package_config_tests.rs +100 -0
  107. package/src/graph/parts.rs +248 -0
  108. package/src/graph/pubspec_tests.rs +119 -0
  109. package/src/graph/tests.rs +837 -0
  110. package/src/graph/uri_tests.rs +102 -0
  111. package/src/graph.rs +644 -0
  112. package/src/health/coverage.rs +309 -0
  113. package/src/health/ownership.rs +175 -0
  114. package/src/health/runtime_coverage.rs +616 -0
  115. package/src/health/runtime_intelligence.rs +511 -0
  116. package/src/health/scores.rs +296 -0
  117. package/src/health/tests.rs +240 -0
  118. package/src/health/threshold_types.rs +163 -0
  119. package/src/health/thresholds.rs +229 -0
  120. package/src/health/types.rs +636 -0
  121. package/src/health.rs +597 -0
  122. package/src/hooks/agent_settings.rs +175 -0
  123. package/src/hooks/templates.rs +51 -0
  124. package/src/hooks.rs +569 -0
  125. package/src/impact.rs +287 -0
  126. package/src/init.rs +237 -0
  127. package/src/inspect.rs +142 -0
  128. package/src/intelligence/tests.rs +232 -0
  129. package/src/intelligence.rs +305 -0
  130. package/src/lib.rs +198 -0
  131. package/src/main.rs +5 -0
  132. package/src/manifest/mcp.rs +565 -0
  133. package/src/manifest.rs +552 -0
  134. package/src/mcp/cli_args/value_args.rs +175 -0
  135. package/src/mcp/cli_args.rs +658 -0
  136. package/src/mcp/cli_args_tests.rs +522 -0
  137. package/src/mcp/code_execute.rs +671 -0
  138. package/src/mcp/tools.rs +660 -0
  139. package/src/mcp.rs +325 -0
  140. package/src/output/audit_risk.rs +135 -0
  141. package/src/output/dependency_findings.rs +327 -0
  142. package/src/output/duplication_findings.rs +114 -0
  143. package/src/output/feature_flag_findings.rs +122 -0
  144. package/src/output/format.rs +31 -0
  145. package/src/output/graph_findings.rs +461 -0
  146. package/src/output/health_findings.rs +612 -0
  147. package/src/output/human.rs +27 -0
  148. package/src/output/next_steps.rs +92 -0
  149. package/src/output/route_findings.rs +76 -0
  150. package/src/output/runtime_coverage.rs +515 -0
  151. package/src/output/scope.rs +183 -0
  152. package/src/output/security_findings.rs +390 -0
  153. package/src/output/security_sarif.rs +150 -0
  154. package/src/output/suppressions.rs +323 -0
  155. package/src/output/symbol_findings.rs +257 -0
  156. package/src/output/tests.rs +114 -0
  157. package/src/output/types.rs +604 -0
  158. package/src/output/widget_findings.rs +213 -0
  159. package/src/output.rs +682 -0
  160. package/src/package_map.rs +495 -0
  161. package/src/policy/packs.rs +232 -0
  162. package/src/policy/tests.rs +134 -0
  163. package/src/policy.rs +640 -0
  164. package/src/project_list.rs +376 -0
  165. package/src/report_schema/inventory.rs +418 -0
  166. package/src/report_schema.rs +488 -0
  167. package/src/routes.rs +354 -0
  168. package/src/scan/tests.rs +250 -0
  169. package/src/scan.rs +275 -0
  170. package/src/security/detect.rs +639 -0
  171. package/src/security/tests.rs +178 -0
  172. package/src/security.rs +373 -0
  173. package/src/security_gate.rs +555 -0
  174. package/src/symbols/path_filters.rs +27 -0
  175. package/src/symbols/private_type_leaks.rs +125 -0
  176. package/src/symbols/riverpod.rs +113 -0
  177. package/src/symbols/tests.rs +692 -0
  178. package/src/symbols.rs +693 -0
  179. package/src/trace/tests.rs +225 -0
  180. package/src/trace.rs +690 -0
  181. package/src/unsupported.rs +47 -0
  182. package/src/widgets/lifecycle.rs +484 -0
  183. package/src/widgets/params.rs +236 -0
  184. package/src/widgets/tests.rs +430 -0
  185. package/src/widgets/top_level.rs +110 -0
  186. package/src/widgets/unrendered.rs +374 -0
  187. package/src/widgets.rs +590 -0
  188. package/src/workspace_scope.rs +358 -0
@@ -0,0 +1,697 @@
1
+ use super::*;
2
+
3
+ #[test]
4
+ fn extracts_imports_exports_and_top_level_declarations() -> Result<(), ExtractError> {
5
+ let source = "\
6
+ import 'dart:async';
7
+ import \"package:app/src/service.dart\";
8
+ import '../shared.dart' as shared show Thing;
9
+ export 'src/public.dart';
10
+ part 'src/generated.g.dart';
11
+
12
+ class App {
13
+ void render() {}
14
+ }
15
+ enum Mode { light, dark }
16
+ void main() { void nested() {} }
17
+ int helper(String value) => value.length;
18
+ ";
19
+
20
+ let extracted = extract_dart_source("lib/main.dart", source)?;
21
+
22
+ assert_eq!(
23
+ extracted.imports,
24
+ vec![
25
+ DartImport {
26
+ uri: "dart:async".to_owned(),
27
+ condition: None,
28
+ prefix: None,
29
+ deferred: false,
30
+ combinators: Vec::new(),
31
+ location: loc(1, 0),
32
+ },
33
+ DartImport {
34
+ uri: "package:app/src/service.dart".to_owned(),
35
+ condition: None,
36
+ prefix: None,
37
+ deferred: false,
38
+ combinators: Vec::new(),
39
+ location: loc(2, 0),
40
+ },
41
+ DartImport {
42
+ uri: "../shared.dart".to_owned(),
43
+ condition: None,
44
+ prefix: Some("shared".to_owned()),
45
+ deferred: false,
46
+ combinators: vec![DartCombinator {
47
+ kind: DartCombinatorKind::Show,
48
+ names: vec!["Thing".to_owned()],
49
+ location: loc(3, 34),
50
+ }],
51
+ location: loc(3, 0),
52
+ },
53
+ ]
54
+ );
55
+ assert_eq!(
56
+ extracted.exports,
57
+ vec![DartExport {
58
+ uri: "src/public.dart".to_owned(),
59
+ condition: None,
60
+ combinators: Vec::new(),
61
+ location: loc(4, 0),
62
+ }]
63
+ );
64
+ assert_eq!(
65
+ extracted.parts,
66
+ vec![DartPart {
67
+ uri: "src/generated.g.dart".to_owned(),
68
+ location: loc(5, 0),
69
+ }]
70
+ );
71
+ assert_eq!(
72
+ extracted.declarations,
73
+ vec![
74
+ TopLevelDeclaration {
75
+ kind: DeclarationKind::Class,
76
+ name: "App".to_owned(),
77
+ location: loc(7, 0),
78
+ range: range(7, 9),
79
+ },
80
+ TopLevelDeclaration {
81
+ kind: DeclarationKind::Enum,
82
+ name: "Mode".to_owned(),
83
+ location: loc(10, 0),
84
+ range: range(10, 10),
85
+ },
86
+ TopLevelDeclaration {
87
+ kind: DeclarationKind::Function,
88
+ name: "main".to_owned(),
89
+ location: loc(11, 0),
90
+ range: range(11, 11),
91
+ },
92
+ TopLevelDeclaration {
93
+ kind: DeclarationKind::Function,
94
+ name: "helper".to_owned(),
95
+ location: loc(12, 0),
96
+ range: range(12, 12),
97
+ },
98
+ ]
99
+ );
100
+
101
+ Ok(())
102
+ }
103
+
104
+ #[test]
105
+ fn extracts_import_export_visibility_metadata() -> Result<(), ExtractError> {
106
+ let source = "\
107
+ import 'deferred.dart' deferred as deferred_lib show DeferredThing hide HiddenThing;
108
+ import 'side_effects.dart' as _;
109
+ export 'public.dart' show PublicThing hide InternalThing;
110
+ ";
111
+
112
+ let extracted = extract_dart_source("lib/visibility.dart", source)?;
113
+
114
+ assert_eq!(extracted.imports[0].uri, "deferred.dart");
115
+ assert_eq!(extracted.imports[0].prefix.as_deref(), Some("deferred_lib"));
116
+ assert!(extracted.imports[0].deferred);
117
+ assert_eq!(
118
+ extracted.imports[0]
119
+ .combinators
120
+ .iter()
121
+ .map(|combinator| (combinator.kind, combinator.names.as_slice()))
122
+ .collect::<Vec<_>>(),
123
+ vec![
124
+ (DartCombinatorKind::Show, &["DeferredThing".to_owned()][..]),
125
+ (DartCombinatorKind::Hide, &["HiddenThing".to_owned()][..]),
126
+ ]
127
+ );
128
+ assert_eq!(extracted.imports[1].uri, "side_effects.dart");
129
+ assert_eq!(extracted.imports[1].prefix, None);
130
+ assert_eq!(
131
+ extracted.exports[0]
132
+ .combinators
133
+ .iter()
134
+ .map(|combinator| (combinator.kind, combinator.names.as_slice()))
135
+ .collect::<Vec<_>>(),
136
+ vec![
137
+ (DartCombinatorKind::Show, &["PublicThing".to_owned()][..]),
138
+ (DartCombinatorKind::Hide, &["InternalThing".to_owned()][..]),
139
+ ]
140
+ );
141
+
142
+ Ok(())
143
+ }
144
+
145
+ #[test]
146
+ fn extracts_library_and_part_of_directive_metadata() -> Result<(), ExtractError> {
147
+ let library_source = "\
148
+ @visibleForTesting
149
+ library app.src.model;
150
+ part 'model_part.dart';
151
+ ";
152
+ let unnamed_source = "library;\n";
153
+ let augment_source = "library augment 'src/base.dart';\n";
154
+ let named_part_source = "part of app.src.model;\n";
155
+ let uri_part_source = "part of 'model.dart';\n";
156
+
157
+ let library = extract_dart_source("lib/src/model.dart", library_source)?;
158
+ let unnamed = extract_dart_source("lib/unnamed.dart", unnamed_source)?;
159
+ let augment = extract_dart_source("lib/augment.dart", augment_source)?;
160
+ let named_part = extract_dart_source("lib/src/model_part.dart", named_part_source)?;
161
+ let uri_part = extract_dart_source("lib/src/model_uri_part.dart", uri_part_source)?;
162
+
163
+ assert_eq!(
164
+ library.library,
165
+ Some(DartLibrary {
166
+ name: Some("app.src.model".to_owned()),
167
+ augment_uri: None,
168
+ location: Location { line: 1, column: 0 },
169
+ })
170
+ );
171
+ assert_eq!(
172
+ unnamed.library,
173
+ Some(DartLibrary {
174
+ name: None,
175
+ augment_uri: None,
176
+ location: Location { line: 1, column: 0 },
177
+ })
178
+ );
179
+ assert_eq!(
180
+ augment.library,
181
+ Some(DartLibrary {
182
+ name: None,
183
+ augment_uri: Some("src/base.dart".to_owned()),
184
+ location: Location { line: 1, column: 0 },
185
+ })
186
+ );
187
+ assert_eq!(
188
+ named_part.part_of,
189
+ Some(DartPartOf {
190
+ name: Some("app.src.model".to_owned()),
191
+ uri: None,
192
+ location: Location { line: 1, column: 0 },
193
+ })
194
+ );
195
+ assert_eq!(
196
+ uri_part.part_of,
197
+ Some(DartPartOf {
198
+ name: None,
199
+ uri: Some("model.dart".to_owned()),
200
+ location: Location { line: 1, column: 0 },
201
+ })
202
+ );
203
+
204
+ Ok(())
205
+ }
206
+
207
+ #[test]
208
+ fn import_deferred_flag_requires_deferred_as_clause() -> Result<(), ExtractError> {
209
+ let source = "\
210
+ import 'deferred.dart' as loader;
211
+ import 'api.dart' as deferred_loader;
212
+ import 'stub.dart' if (dart.library.io) 'deferred' as platform;
213
+ import 'comment.dart' /* deferred as */ as comment_alias;
214
+ import 'commented_real.dart' deferred /*comment*/ as commented_real;
215
+ import 'real.dart' deferred as real;
216
+ ";
217
+
218
+ let extracted = extract_dart_source("lib/deferred_flags.dart", source)?;
219
+
220
+ assert_eq!(
221
+ extracted
222
+ .imports
223
+ .iter()
224
+ .map(|import| {
225
+ (
226
+ import.uri.as_str(),
227
+ import.prefix.as_deref(),
228
+ import.deferred,
229
+ )
230
+ })
231
+ .collect::<Vec<_>>(),
232
+ vec![
233
+ ("deferred.dart", Some("loader"), false),
234
+ ("api.dart", Some("deferred_loader"), false),
235
+ ("stub.dart", Some("platform"), false),
236
+ ("deferred", Some("platform"), false),
237
+ ("comment.dart", Some("comment_alias"), false),
238
+ ("commented_real.dart", Some("commented_real"), true),
239
+ ("real.dart", Some("real"), true),
240
+ ]
241
+ );
242
+
243
+ Ok(())
244
+ }
245
+
246
+ #[test]
247
+ fn extracts_modifier_and_external_function_declarations() -> Result<(), ExtractError> {
248
+ let source = "\
249
+ @pragma('vm:entry-point')
250
+ external Future<void> boot();
251
+ String get currentName => 'dart_decimate';
252
+ external set currentName(String value);
253
+ sealed class State {}
254
+ enum Kind { primary }
255
+ ";
256
+
257
+ let extracted = extract_dart_source("lib/bootstrap.dart", source)?;
258
+
259
+ assert_eq!(
260
+ extracted.declarations,
261
+ vec![
262
+ TopLevelDeclaration {
263
+ kind: DeclarationKind::Function,
264
+ name: "boot".to_owned(),
265
+ location: Location { line: 1, column: 0 },
266
+ range: range(1, 2),
267
+ },
268
+ TopLevelDeclaration {
269
+ kind: DeclarationKind::Function,
270
+ name: "currentName".to_owned(),
271
+ location: Location { line: 3, column: 0 },
272
+ range: range(3, 3),
273
+ },
274
+ TopLevelDeclaration {
275
+ kind: DeclarationKind::Function,
276
+ name: "currentName".to_owned(),
277
+ location: Location { line: 4, column: 0 },
278
+ range: range(4, 4),
279
+ },
280
+ TopLevelDeclaration {
281
+ kind: DeclarationKind::Class,
282
+ name: "State".to_owned(),
283
+ location: Location { line: 5, column: 0 },
284
+ range: range(5, 5),
285
+ },
286
+ TopLevelDeclaration {
287
+ kind: DeclarationKind::Enum,
288
+ name: "Kind".to_owned(),
289
+ location: Location { line: 6, column: 0 },
290
+ range: range(6, 6),
291
+ },
292
+ ]
293
+ );
294
+
295
+ Ok(())
296
+ }
297
+
298
+ #[test]
299
+ fn extracts_dart_top_level_symbol_declarations() -> Result<(), ExtractError> {
300
+ let source = "\
301
+ mixin Trackable {}
302
+ extension FancyString on String {}
303
+ extension type UserId(String value) {}
304
+ typedef JsonMap = Map<String, Object?>;
305
+ typedef String Stringifier(int value);
306
+ const topLevelLimit = 1, topLevelOther = 2;
307
+ late final cached = 1;
308
+ external String hostName;
309
+ class Alias = Object with Trackable;
310
+ ";
311
+
312
+ let extracted = extract_dart_source("lib/symbols.dart", source)?;
313
+
314
+ assert_eq!(
315
+ extracted
316
+ .declarations
317
+ .iter()
318
+ .map(|declaration| (declaration.kind, declaration.name.as_str()))
319
+ .collect::<Vec<_>>(),
320
+ vec![
321
+ (DeclarationKind::Mixin, "Trackable"),
322
+ (DeclarationKind::Extension, "FancyString"),
323
+ (DeclarationKind::ExtensionType, "UserId"),
324
+ (DeclarationKind::TypeAlias, "JsonMap"),
325
+ (DeclarationKind::TypeAlias, "Stringifier"),
326
+ (DeclarationKind::Variable, "topLevelLimit"),
327
+ (DeclarationKind::Variable, "topLevelOther"),
328
+ (DeclarationKind::Variable, "cached"),
329
+ (DeclarationKind::Variable, "hostName"),
330
+ (DeclarationKind::Class, "Alias"),
331
+ ]
332
+ );
333
+
334
+ Ok(())
335
+ }
336
+
337
+ #[test]
338
+ fn parses_modern_dart_primary_constructor_syntax() -> Result<(), ExtractError> {
339
+ let source = "\
340
+ extension type UserId(int value) implements int {}
341
+
342
+ class Point(var int x, var int y);
343
+
344
+ enum Color(final String hex) {
345
+ red('#FF0000'),
346
+ blue('#0000FF');
347
+ }
348
+
349
+ void useModern() {
350
+ final Color color = .red;
351
+ final point = Point(1, 2);
352
+ final (:name, :age) = (name: 'Ada', age: 37);
353
+ switch ((name, age)) {
354
+ case ('Ada', final years):
355
+ print('$color $point $years');
356
+ }
357
+ }
358
+ ";
359
+
360
+ let extracted = extract_dart_source("lib/modern.dart", source)?;
361
+
362
+ assert_eq!(
363
+ extracted
364
+ .declarations
365
+ .iter()
366
+ .map(|declaration| (declaration.kind, declaration.name.as_str()))
367
+ .collect::<Vec<_>>(),
368
+ vec![
369
+ (DeclarationKind::ExtensionType, "UserId"),
370
+ (DeclarationKind::Class, "Point"),
371
+ (DeclarationKind::Enum, "Color"),
372
+ (DeclarationKind::Function, "useModern"),
373
+ ]
374
+ );
375
+ assert!(
376
+ extracted
377
+ .references
378
+ .iter()
379
+ .any(|reference| reference.name == "Color")
380
+ );
381
+ assert!(
382
+ extracted
383
+ .references
384
+ .iter()
385
+ .any(|reference| reference.name == "Point")
386
+ );
387
+
388
+ Ok(())
389
+ }
390
+
391
+ #[test]
392
+ fn excludes_typedef_names_from_identifier_references() -> Result<(), ExtractError> {
393
+ let source = "\
394
+ typedef UsedAlias = String;
395
+ typedef UnusedAlias = int;
396
+
397
+ void run(UsedAlias value) {}
398
+ ";
399
+
400
+ let extracted = extract_dart_source("lib/types.dart", source)?;
401
+ let names = extracted
402
+ .references
403
+ .iter()
404
+ .map(|reference| reference.name.as_str())
405
+ .collect::<Vec<_>>();
406
+
407
+ assert!(names.contains(&"UsedAlias"));
408
+ assert!(!names.contains(&"UnusedAlias"));
409
+
410
+ Ok(())
411
+ }
412
+
413
+ #[test]
414
+ fn extracts_public_signature_type_references_without_bodies() -> Result<(), ExtractError> {
415
+ let source = "\
416
+ class Api extends _Base with _Mixin implements _Contract {
417
+ _BodyOnly make() => throw _BodyOnly();
418
+ }
419
+
420
+ typedef Alias = _Hidden Function(_Input value);
421
+ _TopLevel expose(_Param value) => throw _BodyOnly();
422
+ final _Hidden exposed = _Hidden();
423
+ final _Hidden first = _Hidden(), second = _Hidden();
424
+ ";
425
+
426
+ let extracted = extract_dart_source("lib/api.dart", source)?;
427
+ let references = extracted
428
+ .signature_references
429
+ .iter()
430
+ .map(|reference| (reference.declaration.as_str(), reference.name.as_str()))
431
+ .collect::<Vec<_>>();
432
+
433
+ assert!(references.contains(&("Api", "_Base")));
434
+ assert!(references.contains(&("Api", "_Mixin")));
435
+ assert!(references.contains(&("Api", "_Contract")));
436
+ assert!(references.contains(&("Alias", "_Hidden")));
437
+ assert!(references.contains(&("Alias", "_Input")));
438
+ assert!(references.contains(&("expose", "_TopLevel")));
439
+ assert!(references.contains(&("expose", "_Param")));
440
+ assert!(references.contains(&("exposed", "_Hidden")));
441
+ assert!(references.contains(&("first", "_Hidden")));
442
+ assert!(references.contains(&("second", "_Hidden")));
443
+ assert!(!references.iter().any(|(_, name)| *name == "_BodyOnly"));
444
+ assert!(
445
+ !references
446
+ .iter()
447
+ .any(|(declaration, _)| *declaration == "<variable>")
448
+ );
449
+
450
+ Ok(())
451
+ }
452
+
453
+ #[test]
454
+ fn extracts_class_like_member_declarations() -> Result<(), ExtractError> {
455
+ let source = "\
456
+ class User {
457
+ final String name;
458
+ static const role = 'admin';
459
+ User(this.name);
460
+ User.named(this.name);
461
+ String get label => name;
462
+ set label(String value) {}
463
+ void save() {}
464
+ bool operator ==(Object other) => identical(this, other);
465
+ }
466
+
467
+ enum Mode {
468
+ light, dark;
469
+ const Mode();
470
+ bool get enabled => true;
471
+ }
472
+
473
+ extension Fancy on String {
474
+ int get chars => length;
475
+ void track() {}
476
+ }
477
+
478
+ extension type UserId(String value) {
479
+ bool get blank => value.isEmpty;
480
+ }
481
+ ";
482
+
483
+ let extracted = extract_dart_source("lib/members.dart", source)?;
484
+ let members = extracted
485
+ .members
486
+ .iter()
487
+ .map(|member| (member.owner.as_str(), member.kind, member.name.as_str()))
488
+ .collect::<Vec<_>>();
489
+
490
+ for expected in [
491
+ ("User", MemberKind::Field, "name"),
492
+ ("User", MemberKind::Field, "role"),
493
+ ("User", MemberKind::Constructor, "User"),
494
+ ("User", MemberKind::Constructor, "named"),
495
+ ("User", MemberKind::Getter, "label"),
496
+ ("User", MemberKind::Setter, "label"),
497
+ ("User", MemberKind::Method, "save"),
498
+ ("User", MemberKind::Operator, "=="),
499
+ ("Mode", MemberKind::EnumConstant, "light"),
500
+ ("Mode", MemberKind::EnumConstant, "dark"),
501
+ ("Mode", MemberKind::Constructor, "Mode"),
502
+ ("Mode", MemberKind::Getter, "enabled"),
503
+ ("Fancy", MemberKind::Getter, "chars"),
504
+ ("Fancy", MemberKind::Method, "track"),
505
+ ("UserId", MemberKind::Getter, "blank"),
506
+ ] {
507
+ assert!(members.contains(&expected), "missing member {expected:?}");
508
+ }
509
+
510
+ let references = extracted
511
+ .references
512
+ .iter()
513
+ .map(|reference| reference.name.as_str())
514
+ .collect::<Vec<_>>();
515
+ for declared_name in [
516
+ "named", "role", "label", "save", "enabled", "chars", "track", "blank",
517
+ ] {
518
+ assert!(
519
+ !references.contains(&declared_name),
520
+ "member declaration name {declared_name} was counted as a reference"
521
+ );
522
+ }
523
+
524
+ Ok(())
525
+ }
526
+
527
+ #[test]
528
+ fn extracts_identifier_references_without_directive_metadata_or_declaration_names()
529
+ -> Result<(), ExtractError> {
530
+ let source = "\
531
+ import 'src/internal.dart' as internal show InternalThing hide HiddenThing;
532
+ export 'src/public.dart' show PublicThing;
533
+
534
+ class Uses extends Base with Trackable implements Contract {
535
+ final InternalThing? value;
536
+ Uses(this.value);
537
+ }
538
+
539
+ void boot(Config config) {
540
+ final service = internal.Service();
541
+ service.start(config);
542
+ }
543
+ ";
544
+
545
+ let extracted = extract_dart_source("lib/references.dart", source)?;
546
+ let references = extracted
547
+ .references
548
+ .iter()
549
+ .map(|reference| (reference.name.as_str(), reference.location))
550
+ .collect::<Vec<_>>();
551
+
552
+ assert!(references.contains(&(
553
+ "Base",
554
+ Location {
555
+ line: 4,
556
+ column: 19
557
+ }
558
+ )));
559
+ assert!(references.contains(&(
560
+ "Trackable",
561
+ Location {
562
+ line: 4,
563
+ column: 29
564
+ }
565
+ )));
566
+ assert!(references.contains(&(
567
+ "Contract",
568
+ Location {
569
+ line: 4,
570
+ column: 50
571
+ }
572
+ )));
573
+ assert!(references.contains(&("InternalThing", Location { line: 5, column: 8 })));
574
+ assert!(references.contains(&(
575
+ "internal",
576
+ Location {
577
+ line: 10,
578
+ column: 18
579
+ }
580
+ )));
581
+ assert!(references.contains(&(
582
+ "Service",
583
+ Location {
584
+ line: 10,
585
+ column: 27
586
+ }
587
+ )));
588
+ assert!(references.contains(&(
589
+ "start",
590
+ Location {
591
+ line: 11,
592
+ column: 10
593
+ }
594
+ )));
595
+ assert!(!references.iter().any(|(name, _)| *name == "HiddenThing"));
596
+ assert!(!references.iter().any(|(name, _)| *name == "PublicThing"));
597
+ assert!(!references.iter().any(|(name, _)| *name == "Uses"));
598
+ assert!(!references.iter().any(|(name, _)| *name == "boot"));
599
+
600
+ Ok(())
601
+ }
602
+
603
+ #[test]
604
+ fn extracts_references_from_annotations_generics_and_patterns() -> Result<(), ExtractError> {
605
+ let source = "\
606
+ @Route(path: '/home')
607
+ class HomeController {
608
+ Future<Result<User?>> load(Map<String, List<User>> items) => throw UnimplementedError();
609
+ }
610
+
611
+ void read(Object value, Object record) {
612
+ if (value case User(role: Role.admin)) {}
613
+ if (value case AsyncData(value: final user)) { print(user); }
614
+ switch (record) { case (:final name, _): print(name); }
615
+ }
616
+ ";
617
+
618
+ let extracted = extract_dart_source("lib/typed.dart", source)?;
619
+ let names = extracted
620
+ .references
621
+ .iter()
622
+ .map(|reference| reference.name.as_str())
623
+ .collect::<Vec<_>>();
624
+
625
+ for expected in
626
+ "Route Future Result User Map String List Object Role AsyncData".split_whitespace()
627
+ {
628
+ assert!(names.contains(&expected), "missing reference {expected}");
629
+ }
630
+ assert!(!names.contains(&"HomeController"));
631
+ assert!(!names.contains(&"load"));
632
+ assert!(!names.contains(&"read"));
633
+ assert!(!names.contains(&"_"));
634
+ assert_eq!(names.iter().filter(|name| **name == "user").count(), 1);
635
+ assert_eq!(names.iter().filter(|name| **name == "name").count(), 1);
636
+
637
+ Ok(())
638
+ }
639
+
640
+ const fn range(start_line: usize, end_line: usize) -> SourceRange {
641
+ SourceRange {
642
+ start_line,
643
+ end_line,
644
+ }
645
+ }
646
+
647
+ const fn loc(line: usize, column: usize) -> Location {
648
+ Location { line, column }
649
+ }
650
+
651
+ #[test]
652
+ fn extracts_all_uris_from_configurable_directives() -> Result<(), ExtractError> {
653
+ let source = "\
654
+ import 'io.dart' if (dart.library.html) 'html.dart' if (dart.library.js_interop == 'true') 'wasm.dart';
655
+ export r'src\\raw.dart' if (dart.library.html) 'src\\web.dart';
656
+ ";
657
+
658
+ let extracted = extract_dart_source("lib/platform.dart", source)?;
659
+
660
+ assert_eq!(
661
+ extracted
662
+ .imports
663
+ .iter()
664
+ .map(|import| (
665
+ import.uri.as_str(),
666
+ import.condition.as_ref().map(|condition| (
667
+ condition.variable.as_str(),
668
+ condition.expected_value.as_str()
669
+ ))
670
+ ))
671
+ .collect::<Vec<_>>(),
672
+ vec![
673
+ ("io.dart", None),
674
+ ("html.dart", Some(("dart.library.html", "true"))),
675
+ ("wasm.dart", Some(("dart.library.js_interop", "true")))
676
+ ]
677
+ );
678
+ assert_eq!(
679
+ extracted
680
+ .exports
681
+ .iter()
682
+ .map(|export| (
683
+ export.uri.as_str(),
684
+ export.condition.as_ref().map(|condition| (
685
+ condition.variable.as_str(),
686
+ condition.expected_value.as_str()
687
+ ))
688
+ ))
689
+ .collect::<Vec<_>>(),
690
+ vec![
691
+ ("src\\raw.dart", None),
692
+ ("src\\web.dart", Some(("dart.library.html", "true")))
693
+ ]
694
+ );
695
+
696
+ Ok(())
697
+ }