@skastr0/pulsar-rs-pack 0.1.0

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 (189) hide show
  1. package/dist/cargo-metadata.d.ts +59 -0
  2. package/dist/cargo-metadata.d.ts.map +1 -0
  3. package/dist/cargo-metadata.js +162 -0
  4. package/dist/cargo-metadata.js.map +1 -0
  5. package/dist/index.d.ts +7 -0
  6. package/dist/index.d.ts.map +1 -0
  7. package/dist/index.js +7 -0
  8. package/dist/index.js.map +1 -0
  9. package/dist/lock-file.d.ts +20 -0
  10. package/dist/lock-file.d.ts.map +1 -0
  11. package/dist/lock-file.js +144 -0
  12. package/dist/lock-file.js.map +1 -0
  13. package/dist/pack.d.ts +6 -0
  14. package/dist/pack.d.ts.map +1 -0
  15. package/dist/pack.js +55 -0
  16. package/dist/pack.js.map +1 -0
  17. package/dist/project.d.ts +26 -0
  18. package/dist/project.d.ts.map +1 -0
  19. package/dist/project.js +172 -0
  20. package/dist/project.js.map +1 -0
  21. package/dist/rust-analysis-collect.d.ts +4 -0
  22. package/dist/rust-analysis-collect.d.ts.map +1 -0
  23. package/dist/rust-analysis-collect.js +84 -0
  24. package/dist/rust-analysis-collect.js.map +1 -0
  25. package/dist/rust-analysis-functions.d.ts +4 -0
  26. package/dist/rust-analysis-functions.d.ts.map +1 -0
  27. package/dist/rust-analysis-functions.js +140 -0
  28. package/dist/rust-analysis-functions.js.map +1 -0
  29. package/dist/rust-analysis-identifiers.d.ts +3 -0
  30. package/dist/rust-analysis-identifiers.d.ts.map +1 -0
  31. package/dist/rust-analysis-identifiers.js +5 -0
  32. package/dist/rust-analysis-identifiers.js.map +1 -0
  33. package/dist/rust-analysis-items.d.ts +4 -0
  34. package/dist/rust-analysis-items.d.ts.map +1 -0
  35. package/dist/rust-analysis-items.js +58 -0
  36. package/dist/rust-analysis-items.js.map +1 -0
  37. package/dist/rust-analysis-modules.d.ts +7 -0
  38. package/dist/rust-analysis-modules.d.ts.map +1 -0
  39. package/dist/rust-analysis-modules.js +52 -0
  40. package/dist/rust-analysis-modules.js.map +1 -0
  41. package/dist/rust-analysis-syntax.d.ts +12 -0
  42. package/dist/rust-analysis-syntax.d.ts.map +1 -0
  43. package/dist/rust-analysis-syntax.js +102 -0
  44. package/dist/rust-analysis-syntax.js.map +1 -0
  45. package/dist/rust-analysis-types.d.ts +109 -0
  46. package/dist/rust-analysis-types.d.ts.map +1 -0
  47. package/dist/rust-analysis-types.js +2 -0
  48. package/dist/rust-analysis-types.js.map +1 -0
  49. package/dist/rust-analysis-uses.d.ts +4 -0
  50. package/dist/rust-analysis-uses.d.ts.map +1 -0
  51. package/dist/rust-analysis-uses.js +63 -0
  52. package/dist/rust-analysis-uses.js.map +1 -0
  53. package/dist/rust-analysis.d.ts +5 -0
  54. package/dist/rust-analysis.d.ts.map +1 -0
  55. package/dist/rust-analysis.js +4 -0
  56. package/dist/rust-analysis.js.map +1 -0
  57. package/dist/signals/rs-ab-01-unused-pub.d.ts +29 -0
  58. package/dist/signals/rs-ab-01-unused-pub.d.ts.map +1 -0
  59. package/dist/signals/rs-ab-01-unused-pub.js +184 -0
  60. package/dist/signals/rs-ab-01-unused-pub.js.map +1 -0
  61. package/dist/signals/rs-ab-02-trait-object-depth.d.ts +26 -0
  62. package/dist/signals/rs-ab-02-trait-object-depth.d.ts.map +1 -0
  63. package/dist/signals/rs-ab-02-trait-object-depth.js +157 -0
  64. package/dist/signals/rs-ab-02-trait-object-depth.js.map +1 -0
  65. package/dist/signals/rs-ab-03-generic-proliferation.d.ts +28 -0
  66. package/dist/signals/rs-ab-03-generic-proliferation.d.ts.map +1 -0
  67. package/dist/signals/rs-ab-03-generic-proliferation.js +108 -0
  68. package/dist/signals/rs-ab-03-generic-proliferation.js.map +1 -0
  69. package/dist/signals/rs-ab-04-derive-density.d.ts +25 -0
  70. package/dist/signals/rs-ab-04-derive-density.d.ts.map +1 -0
  71. package/dist/signals/rs-ab-04-derive-density.js +101 -0
  72. package/dist/signals/rs-ab-04-derive-density.js.map +1 -0
  73. package/dist/signals/rs-ad-01-visibility-surface.d.ts +29 -0
  74. package/dist/signals/rs-ad-01-visibility-surface.d.ts.map +1 -0
  75. package/dist/signals/rs-ad-01-visibility-surface.js +129 -0
  76. package/dist/signals/rs-ad-01-visibility-surface.js.map +1 -0
  77. package/dist/signals/rs-ad-02-boundary-rules.d.ts +3 -0
  78. package/dist/signals/rs-ad-02-boundary-rules.d.ts.map +1 -0
  79. package/dist/signals/rs-ad-02-boundary-rules.js +26 -0
  80. package/dist/signals/rs-ad-02-boundary-rules.js.map +1 -0
  81. package/dist/signals/rs-ad-02-crate-analysis.d.ts +9 -0
  82. package/dist/signals/rs-ad-02-crate-analysis.d.ts.map +1 -0
  83. package/dist/signals/rs-ad-02-crate-analysis.js +117 -0
  84. package/dist/signals/rs-ad-02-crate-analysis.js.map +1 -0
  85. package/dist/signals/rs-ad-02-crate-boundaries.d.ts +6 -0
  86. package/dist/signals/rs-ad-02-crate-boundaries.d.ts.map +1 -0
  87. package/dist/signals/rs-ad-02-crate-boundaries.js +84 -0
  88. package/dist/signals/rs-ad-02-crate-boundaries.js.map +1 -0
  89. package/dist/signals/rs-ad-02-types.d.ts +26 -0
  90. package/dist/signals/rs-ad-02-types.d.ts.map +1 -0
  91. package/dist/signals/rs-ad-02-types.js +6 -0
  92. package/dist/signals/rs-ad-02-types.js.map +1 -0
  93. package/dist/signals/rs-ad-03-circular-crate-deps.d.ts +30 -0
  94. package/dist/signals/rs-ad-03-circular-crate-deps.d.ts.map +1 -0
  95. package/dist/signals/rs-ad-03-circular-crate-deps.js +185 -0
  96. package/dist/signals/rs-ad-03-circular-crate-deps.js.map +1 -0
  97. package/dist/signals/rs-de-01-trait-coupling.d.ts +43 -0
  98. package/dist/signals/rs-de-01-trait-coupling.d.ts.map +1 -0
  99. package/dist/signals/rs-de-01-trait-coupling.js +222 -0
  100. package/dist/signals/rs-de-01-trait-coupling.js.map +1 -0
  101. package/dist/signals/rs-de-02-dep-tree.d.ts +28 -0
  102. package/dist/signals/rs-de-02-dep-tree.d.ts.map +1 -0
  103. package/dist/signals/rs-de-02-dep-tree.js +173 -0
  104. package/dist/signals/rs-de-02-dep-tree.js.map +1 -0
  105. package/dist/signals/rs-de-03-feature-flags.d.ts +32 -0
  106. package/dist/signals/rs-de-03-feature-flags.d.ts.map +1 -0
  107. package/dist/signals/rs-de-03-feature-flags.js +139 -0
  108. package/dist/signals/rs-de-03-feature-flags.js.map +1 -0
  109. package/dist/signals/rs-de-04-fan-in-fan-out.d.ts +28 -0
  110. package/dist/signals/rs-de-04-fan-in-fan-out.d.ts.map +1 -0
  111. package/dist/signals/rs-de-04-fan-in-fan-out.js +109 -0
  112. package/dist/signals/rs-de-04-fan-in-fan-out.js.map +1 -0
  113. package/dist/signals/rs-ld-01-unsafe.d.ts +28 -0
  114. package/dist/signals/rs-ld-01-unsafe.d.ts.map +1 -0
  115. package/dist/signals/rs-ld-01-unsafe.js +116 -0
  116. package/dist/signals/rs-ld-01-unsafe.js.map +1 -0
  117. package/dist/signals/rs-ld-02-lifetimes.d.ts +30 -0
  118. package/dist/signals/rs-ld-02-lifetimes.d.ts.map +1 -0
  119. package/dist/signals/rs-ld-02-lifetimes.js +79 -0
  120. package/dist/signals/rs-ld-02-lifetimes.js.map +1 -0
  121. package/dist/signals/rs-ld-03-match-catch-all.d.ts +26 -0
  122. package/dist/signals/rs-ld-03-match-catch-all.d.ts.map +1 -0
  123. package/dist/signals/rs-ld-03-match-catch-all.js +68 -0
  124. package/dist/signals/rs-ld-03-match-catch-all.js.map +1 -0
  125. package/dist/signals/rs-ld-04-error-granularity.d.ts +25 -0
  126. package/dist/signals/rs-ld-04-error-granularity.d.ts.map +1 -0
  127. package/dist/signals/rs-ld-04-error-granularity.js +77 -0
  128. package/dist/signals/rs-ld-04-error-granularity.js.map +1 -0
  129. package/dist/signals/rs-ld-05-complexity.d.ts +26 -0
  130. package/dist/signals/rs-ld-05-complexity.d.ts.map +1 -0
  131. package/dist/signals/rs-ld-05-complexity.js +70 -0
  132. package/dist/signals/rs-ld-05-complexity.js.map +1 -0
  133. package/dist/signals/rs-ld-06-domain-terms.d.ts +29 -0
  134. package/dist/signals/rs-ld-06-domain-terms.d.ts.map +1 -0
  135. package/dist/signals/rs-ld-06-domain-terms.js +158 -0
  136. package/dist/signals/rs-ld-06-domain-terms.js.map +1 -0
  137. package/dist/signals/rs-rp-01-hotspots.d.ts +27 -0
  138. package/dist/signals/rs-rp-01-hotspots.d.ts.map +1 -0
  139. package/dist/signals/rs-rp-01-hotspots.js +110 -0
  140. package/dist/signals/rs-rp-01-hotspots.js.map +1 -0
  141. package/dist/signals/rs-rp-02-compile-time.d.ts +25 -0
  142. package/dist/signals/rs-rp-02-compile-time.d.ts.map +1 -0
  143. package/dist/signals/rs-rp-02-compile-time.js +177 -0
  144. package/dist/signals/rs-rp-02-compile-time.js.map +1 -0
  145. package/dist/signals/rs-rp-03-pr-size.d.ts +23 -0
  146. package/dist/signals/rs-rp-03-pr-size.d.ts.map +1 -0
  147. package/dist/signals/rs-rp-03-pr-size.js +160 -0
  148. package/dist/signals/rs-rp-03-pr-size.js.map +1 -0
  149. package/dist/signals/rs-sl-01-duplication.d.ts +28 -0
  150. package/dist/signals/rs-sl-01-duplication.d.ts.map +1 -0
  151. package/dist/signals/rs-sl-01-duplication.js +172 -0
  152. package/dist/signals/rs-sl-01-duplication.js.map +1 -0
  153. package/dist/signals/rs-sl-02-suppressions.d.ts +30 -0
  154. package/dist/signals/rs-sl-02-suppressions.d.ts.map +1 -0
  155. package/dist/signals/rs-sl-02-suppressions.js +176 -0
  156. package/dist/signals/rs-sl-02-suppressions.js.map +1 -0
  157. package/dist/signals/rs-sl-03-unwrap-expect.d.ts +22 -0
  158. package/dist/signals/rs-sl-03-unwrap-expect.d.ts.map +1 -0
  159. package/dist/signals/rs-sl-03-unwrap-expect.js +94 -0
  160. package/dist/signals/rs-sl-03-unwrap-expect.js.map +1 -0
  161. package/dist/signals/rs-sl-04-clone-abuse.d.ts +22 -0
  162. package/dist/signals/rs-sl-04-clone-abuse.d.ts.map +1 -0
  163. package/dist/signals/rs-sl-04-clone-abuse.js +115 -0
  164. package/dist/signals/rs-sl-04-clone-abuse.js.map +1 -0
  165. package/dist/signals/shared-globs.d.ts +4 -0
  166. package/dist/signals/shared-globs.d.ts.map +1 -0
  167. package/dist/signals/shared-globs.js +12 -0
  168. package/dist/signals/shared-globs.js.map +1 -0
  169. package/dist/signals/shared-record-guards.d.ts +4 -0
  170. package/dist/signals/shared-record-guards.d.ts.map +1 -0
  171. package/dist/signals/shared-record-guards.js +4 -0
  172. package/dist/signals/shared-record-guards.js.map +1 -0
  173. package/dist/signals/shared-rust-ast.d.ts +30 -0
  174. package/dist/signals/shared-rust-ast.d.ts.map +1 -0
  175. package/dist/signals/shared-rust-ast.js +78 -0
  176. package/dist/signals/shared-rust-ast.js.map +1 -0
  177. package/dist/signals/shared-rust-resolution.d.ts +10 -0
  178. package/dist/signals/shared-rust-resolution.d.ts.map +1 -0
  179. package/dist/signals/shared-rust-resolution.js +53 -0
  180. package/dist/signals/shared-rust-resolution.js.map +1 -0
  181. package/dist/signals/shared-threshold-score.d.ts +2 -0
  182. package/dist/signals/shared-threshold-score.d.ts.map +1 -0
  183. package/dist/signals/shared-threshold-score.js +6 -0
  184. package/dist/signals/shared-threshold-score.js.map +1 -0
  185. package/dist/syn-walker.d.ts +7 -0
  186. package/dist/syn-walker.d.ts.map +1 -0
  187. package/dist/syn-walker.js +61 -0
  188. package/dist/syn-walker.js.map +1 -0
  189. package/package.json +56 -0
@@ -0,0 +1,157 @@
1
+ import { scoreThresholdViolationShare, SignalComputeError, } from "@skastr0/pulsar-core/signal";
2
+ import { Effect, Schema } from "effect";
3
+ import { RustProjectTag } from "../project.js";
4
+ import { parseRustFile } from "../syn-walker.js";
5
+ import { DEFAULT_RUST_EXCLUDE_GLOBS, firstNamedChild, modulePathForAncestors, namedChildrenOf, resolveRustFileScope, walkAttributedNodes, } from "./shared-rust-ast.js";
6
+ import { isExcluded } from "./shared-globs.js";
7
+ const RsAb02Config = Schema.Struct({
8
+ exclude_globs: Schema.Array(Schema.String),
9
+ max_chain_depth: Schema.Number,
10
+ top_n_diagnostics: Schema.Number,
11
+ });
12
+ export const RsAb02 = {
13
+ id: "RS-AB-02-trait-object-depth",
14
+ title: "Trait object depth",
15
+ aliases: ["RS-AB-02"],
16
+ tier: 1,
17
+ category: "abstraction-bloat",
18
+ kind: "legibility",
19
+ configSchema: RsAb02Config,
20
+ defaultConfig: {
21
+ exclude_globs: [...DEFAULT_RUST_EXCLUDE_GLOBS],
22
+ max_chain_depth: 1,
23
+ top_n_diagnostics: 10,
24
+ },
25
+ inputs: [],
26
+ compute: (config) => Effect.gen(function* () {
27
+ const project = yield* RustProjectTag;
28
+ return yield* Effect.tryPromise({
29
+ try: async () => {
30
+ const dynFns = new Map();
31
+ const fnKeysByName = new Map();
32
+ for (const file of project.sourceFiles) {
33
+ if (isExcluded(file, config.exclude_globs))
34
+ continue;
35
+ const scope = resolveRustFileScope(project, file);
36
+ const tree = await parseRustFile(file);
37
+ walkAttributedNodes(tree.rootNode, ({ node, ancestors, testGated }) => {
38
+ if (testGated || node.type !== "function_item")
39
+ return;
40
+ const name = firstNamedChild(node, "identifier")?.text;
41
+ const returnType = detectReturnType(node);
42
+ if (name === undefined || returnType === undefined || !returnType.includes("dyn "))
43
+ return;
44
+ const { modulePath } = modulePathForAncestors(scope, ancestors);
45
+ const key = `${modulePath}::${name}`;
46
+ dynFns.set(key, {
47
+ file,
48
+ module: modulePath,
49
+ name,
50
+ line: node.startPosition.row + 1,
51
+ returnType,
52
+ calleeNames: collectCalledFunctionNames(node),
53
+ });
54
+ const bucket = fnKeysByName.get(name) ?? [];
55
+ bucket.push(key);
56
+ fnKeysByName.set(name, bucket);
57
+ });
58
+ }
59
+ const memo = new Map();
60
+ const entries = [...dynFns.entries()]
61
+ .map(([key, fn]) => ({
62
+ file: fn.file,
63
+ module: fn.module,
64
+ name: fn.name,
65
+ line: fn.line,
66
+ returnType: fn.returnType,
67
+ chainDepth: measureChainDepth(key, dynFns, fnKeysByName, memo, new Set()),
68
+ calleeNames: fn.calleeNames,
69
+ }))
70
+ .sort((left, right) => right.chainDepth - left.chainDepth || left.file.localeCompare(right.file));
71
+ return {
72
+ functions: entries,
73
+ overThreshold: entries.filter((entry) => entry.chainDepth > config.max_chain_depth),
74
+ analysisMode: "local-dyn-return-call-graph",
75
+ };
76
+ },
77
+ catch: (cause) => new SignalComputeError({ signalId: "RS-AB-02-trait-object-depth", message: String(cause), cause }),
78
+ });
79
+ }),
80
+ score: (out) => {
81
+ return scoreThresholdViolationShare(out.functions.length, out.overThreshold.length);
82
+ },
83
+ diagnose: (out) => out.overThreshold.slice(0, 10).map((entry) => ({
84
+ severity: "warn",
85
+ message: `Trait-object chain depth ${entry.chainDepth} in ${entry.name}`,
86
+ location: { file: entry.file, line: entry.line },
87
+ data: {
88
+ module: entry.module,
89
+ name: entry.name,
90
+ returnType: entry.returnType,
91
+ calleeNames: entry.calleeNames,
92
+ analysisMode: out.analysisMode,
93
+ },
94
+ })),
95
+ };
96
+ const detectReturnType = (node) => {
97
+ const children = namedChildrenOf(node);
98
+ const parametersIndex = children.findIndex((child) => child.type === "parameters");
99
+ if (parametersIndex === -1)
100
+ return undefined;
101
+ return children
102
+ .slice(parametersIndex + 1)
103
+ .find((child) => child.type !== "where_clause" && child.type !== "block")?.text;
104
+ };
105
+ const collectCalledFunctionNames = (node) => {
106
+ const names = new Set();
107
+ const walk = (current) => {
108
+ if (current.type === "call_expression") {
109
+ const callee = namedChildrenOf(current)[0];
110
+ const name = callee === undefined ? undefined : callName(callee);
111
+ if (name !== undefined)
112
+ names.add(name);
113
+ }
114
+ for (const child of namedChildrenOf(current)) {
115
+ walk(child);
116
+ }
117
+ };
118
+ walk(node);
119
+ return [...names];
120
+ };
121
+ const callName = (node) => {
122
+ switch (node.type) {
123
+ case "identifier":
124
+ return node.text;
125
+ case "scoped_identifier":
126
+ return node.text.split("::").at(-1);
127
+ default:
128
+ return undefined;
129
+ }
130
+ };
131
+ const measureChainDepth = (key, dynFns, fnKeysByName, memo, active) => {
132
+ const cached = memo.get(key);
133
+ if (cached !== undefined)
134
+ return cached;
135
+ if (active.has(key))
136
+ return 1;
137
+ active.add(key);
138
+ const current = dynFns.get(key);
139
+ if (current === undefined)
140
+ return 1;
141
+ let maxDepth = 1;
142
+ for (const calleeName of current.calleeNames) {
143
+ const sameModuleKey = `${current.module}::${calleeName}`;
144
+ const candidateKeys = dynFns.has(sameModuleKey)
145
+ ? [sameModuleKey]
146
+ : (fnKeysByName.get(calleeName) ?? []).length === 1
147
+ ? [fnKeysByName.get(calleeName)[0]]
148
+ : [];
149
+ for (const candidateKey of candidateKeys) {
150
+ maxDepth = Math.max(maxDepth, 1 + measureChainDepth(candidateKey, dynFns, fnKeysByName, memo, active));
151
+ }
152
+ }
153
+ active.delete(key);
154
+ memo.set(key, maxDepth);
155
+ return maxDepth;
156
+ };
157
+ //# sourceMappingURL=rs-ab-02-trait-object-depth.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"rs-ab-02-trait-object-depth.js","sourceRoot":"","sources":["../../src/signals/rs-ab-02-trait-object-depth.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,28 @@
1
+ import { type DistributionalSummary, type Signal } from "@skastr0/pulsar-core/signal";
2
+ import { Schema } from "effect";
3
+ import { RustProjectTag } from "../project.js";
4
+ declare const RsAb03Config: Schema.Struct<{
5
+ exclude_globs: Schema.Array$<typeof Schema.String>;
6
+ max_generic_parameters: typeof Schema.Number;
7
+ top_n_diagnostics: typeof Schema.Number;
8
+ }>;
9
+ type RsAb03Config = typeof RsAb03Config.Type;
10
+ interface RustGenericAnalysis {
11
+ readonly file: string;
12
+ readonly module: string;
13
+ readonly declarationName: string;
14
+ readonly line: number;
15
+ readonly paramCount: number;
16
+ readonly whereClausePredicates: number;
17
+ readonly boundCount: number;
18
+ readonly complexity: number;
19
+ }
20
+ interface RsAb03Output {
21
+ readonly declarations: ReadonlyArray<RustGenericAnalysis>;
22
+ readonly parameterDistribution: DistributionalSummary;
23
+ readonly overThreshold: ReadonlyArray<RustGenericAnalysis>;
24
+ readonly analysisMode: "ast-parameter-and-where-clause-counts";
25
+ }
26
+ export declare const RsAb03: Signal<RsAb03Config, RsAb03Output, RustProjectTag>;
27
+ export {};
28
+ //# sourceMappingURL=rs-ab-03-generic-proliferation.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"rs-ab-03-generic-proliferation.d.ts","sourceRoot":"","sources":["../../src/signals/rs-ab-03-generic-proliferation.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,qBAAqB,EAE1B,KAAK,MAAM,EAGZ,MAAM,6BAA6B,CAAA;AACpC,OAAO,EAAU,MAAM,EAAE,MAAM,QAAQ,CAAA;AACvC,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAa9C,QAAA,MAAM,YAAY;;;;EAIhB,CAAA;AACF,KAAK,YAAY,GAAG,OAAO,YAAY,CAAC,IAAI,CAAA;AAE5C,UAAU,mBAAmB;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAA;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,qBAAqB,EAAE,MAAM,CAAA;IACtC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAC5B;AAED,UAAU,YAAY;IACpB,QAAQ,CAAC,YAAY,EAAE,aAAa,CAAC,mBAAmB,CAAC,CAAA;IACzD,QAAQ,CAAC,qBAAqB,EAAE,qBAAqB,CAAA;IACrD,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC,mBAAmB,CAAC,CAAA;IAC1D,QAAQ,CAAC,YAAY,EAAE,uCAAuC,CAAA;CAC/D;AAED,eAAO,MAAM,MAAM,EAAE,MAAM,CAAC,YAAY,EAAE,YAAY,EAAE,cAAc,CA6ErE,CAAA"}
@@ -0,0 +1,108 @@
1
+ import { scoreThresholdViolationShare, SignalComputeError, summarize, } from "@skastr0/pulsar-core/signal";
2
+ import { Effect, Schema } from "effect";
3
+ import { RustProjectTag } from "../project.js";
4
+ import { parseRustFile } from "../syn-walker.js";
5
+ import { DEFAULT_RUST_EXCLUDE_GLOBS, firstNamedChild, modulePathForAncestors, namedChildrenOf, resolveRustFileScope, walkAttributedNodes, } from "./shared-rust-ast.js";
6
+ import { isExcluded } from "./shared-globs.js";
7
+ const RsAb03Config = Schema.Struct({
8
+ exclude_globs: Schema.Array(Schema.String),
9
+ max_generic_parameters: Schema.Number,
10
+ top_n_diagnostics: Schema.Number,
11
+ });
12
+ export const RsAb03 = {
13
+ id: "RS-AB-03-generic-proliferation",
14
+ title: "Generic proliferation",
15
+ aliases: ["RS-AB-03"],
16
+ tier: 1,
17
+ category: "abstraction-bloat",
18
+ kind: "legibility",
19
+ configSchema: RsAb03Config,
20
+ defaultConfig: {
21
+ exclude_globs: [...DEFAULT_RUST_EXCLUDE_GLOBS],
22
+ max_generic_parameters: 3,
23
+ top_n_diagnostics: 10,
24
+ },
25
+ inputs: [],
26
+ compute: (config) => Effect.gen(function* () {
27
+ const project = yield* RustProjectTag;
28
+ return yield* Effect.tryPromise({
29
+ try: async () => {
30
+ const declarations = [];
31
+ for (const file of project.sourceFiles) {
32
+ if (isExcluded(file, config.exclude_globs))
33
+ continue;
34
+ const scope = resolveRustFileScope(project, file);
35
+ const tree = await parseRustFile(file);
36
+ walkAttributedNodes(tree.rootNode, ({ node, ancestors, testGated }) => {
37
+ if (testGated || !isGenericTrackedNode(node.type))
38
+ return;
39
+ const typeParameters = firstNamedChild(node, "type_parameters");
40
+ const whereClause = firstNamedChild(node, "where_clause");
41
+ const paramCount = namedChildrenOf(typeParameters ?? node).filter((child) => ["type_parameter", "lifetime_parameter", "const_parameter"].includes(child.type)).length;
42
+ if (paramCount === 0)
43
+ return;
44
+ const whereClausePredicates = namedChildrenOf(whereClause ?? node).length;
45
+ const boundCount = countNamedDescendants(typeParameters, "trait_bounds") + countNamedDescendants(whereClause, "trait_bounds");
46
+ const { modulePath } = modulePathForAncestors(scope, ancestors);
47
+ declarations.push({
48
+ file,
49
+ module: modulePath,
50
+ declarationName: declarationName(node),
51
+ line: node.startPosition.row + 1,
52
+ paramCount,
53
+ whereClausePredicates,
54
+ boundCount,
55
+ complexity: paramCount + whereClausePredicates + boundCount,
56
+ });
57
+ });
58
+ }
59
+ declarations.sort((left, right) => right.paramCount - left.paramCount || left.file.localeCompare(right.file));
60
+ return {
61
+ declarations,
62
+ parameterDistribution: summarize(declarations.map((entry) => entry.paramCount)),
63
+ overThreshold: declarations.filter((entry) => entry.paramCount > config.max_generic_parameters),
64
+ analysisMode: "ast-parameter-and-where-clause-counts",
65
+ };
66
+ },
67
+ catch: (cause) => new SignalComputeError({ signalId: "RS-AB-03-generic-proliferation", message: String(cause), cause }),
68
+ });
69
+ }),
70
+ score: (out) => {
71
+ return scoreThresholdViolationShare(out.declarations.length, out.overThreshold.length);
72
+ },
73
+ diagnose: (out) => out.overThreshold.slice(0, 10).map((entry) => ({
74
+ severity: "warn",
75
+ message: `${entry.declarationName} uses ${entry.paramCount} generic parameters`,
76
+ location: { file: entry.file, line: entry.line },
77
+ data: {
78
+ module: entry.module,
79
+ paramCount: entry.paramCount,
80
+ whereClausePredicates: entry.whereClausePredicates,
81
+ boundCount: entry.boundCount,
82
+ complexity: entry.complexity,
83
+ analysisMode: out.analysisMode,
84
+ },
85
+ })),
86
+ };
87
+ const isGenericTrackedNode = (type) => ["function_item", "struct_item", "enum_item", "trait_item", "type_item", "impl_item"].includes(type);
88
+ const declarationName = (node) => {
89
+ if (node.type === "impl_item") {
90
+ const target = namedChildrenOf(node).find((child) => child.type !== "type_parameters" && child.type !== "where_clause" && child.type !== "declaration_list");
91
+ return `impl ${target?.text ?? "<unknown>"}`;
92
+ }
93
+ return firstNamedChild(node, "identifier")?.text ?? firstNamedChild(node, "type_identifier")?.text ?? "<anonymous>";
94
+ };
95
+ const countNamedDescendants = (node, type) => {
96
+ if (node === undefined)
97
+ return 0;
98
+ let count = 0;
99
+ const walk = (current) => {
100
+ if (current.type === type)
101
+ count += 1;
102
+ for (const child of namedChildrenOf(current))
103
+ walk(child);
104
+ };
105
+ walk(node);
106
+ return count;
107
+ };
108
+ //# sourceMappingURL=rs-ab-03-generic-proliferation.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"rs-ab-03-generic-proliferation.js","sourceRoot":"","sources":["../../src/signals/rs-ab-03-generic-proliferation.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,25 @@
1
+ import { type DistributionalSummary, type Signal } from "@skastr0/pulsar-core/signal";
2
+ import { Schema } from "effect";
3
+ import { RustProjectTag } from "../project.js";
4
+ declare const RsAb04Config: Schema.Struct<{
5
+ exclude_globs: Schema.Array$<typeof Schema.String>;
6
+ top_n_diagnostics: typeof Schema.Number;
7
+ }>;
8
+ type RsAb04Config = typeof RsAb04Config.Type;
9
+ interface DeriveDensityEntry {
10
+ readonly file: string;
11
+ readonly module: string;
12
+ readonly name: string;
13
+ readonly line: number;
14
+ readonly deriveCount: number;
15
+ readonly standardDerives: ReadonlyArray<string>;
16
+ readonly customDerives: ReadonlyArray<string>;
17
+ }
18
+ interface RsAb04Output {
19
+ readonly types: ReadonlyArray<DeriveDensityEntry>;
20
+ readonly distribution: DistributionalSummary;
21
+ readonly analysisMode: "attribute-attached-derive-count";
22
+ }
23
+ export declare const RsAb04: Signal<RsAb04Config, RsAb04Output, RustProjectTag>;
24
+ export {};
25
+ //# sourceMappingURL=rs-ab-04-derive-density.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"rs-ab-04-derive-density.d.ts","sourceRoot":"","sources":["../../src/signals/rs-ab-04-derive-density.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,qBAAqB,EAC1B,KAAK,MAAM,EAGZ,MAAM,6BAA6B,CAAA;AACpC,OAAO,EAAU,MAAM,EAAE,MAAM,QAAQ,CAAA;AACvC,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAW9C,QAAA,MAAM,YAAY;;;EAGhB,CAAA;AACF,KAAK,YAAY,GAAG,OAAO,YAAY,CAAC,IAAI,CAAA;AAE5C,UAAU,kBAAkB;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,eAAe,EAAE,aAAa,CAAC,MAAM,CAAC,CAAA;IAC/C,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC,MAAM,CAAC,CAAA;CAC9C;AAED,UAAU,YAAY;IACpB,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,kBAAkB,CAAC,CAAA;IACjD,QAAQ,CAAC,YAAY,EAAE,qBAAqB,CAAA;IAC5C,QAAQ,CAAC,YAAY,EAAE,iCAAiC,CAAA;CACzD;AAcD,eAAO,MAAM,MAAM,EAAE,MAAM,CAAC,YAAY,EAAE,YAAY,EAAE,cAAc,CAqErE,CAAA"}
@@ -0,0 +1,101 @@
1
+ import { SignalComputeError, summarize, } from "@skastr0/pulsar-core/signal";
2
+ import { Effect, Schema } from "effect";
3
+ import { RustProjectTag } from "../project.js";
4
+ import { parseRustFile } from "../syn-walker.js";
5
+ import { DEFAULT_RUST_EXCLUDE_GLOBS, firstNamedChild, modulePathForAncestors, resolveRustFileScope, walkAttributedNodes, } from "./shared-rust-ast.js";
6
+ import { isExcluded } from "./shared-globs.js";
7
+ const RsAb04Config = Schema.Struct({
8
+ exclude_globs: Schema.Array(Schema.String),
9
+ top_n_diagnostics: Schema.Number,
10
+ });
11
+ const STANDARD_DERIVES = new Set([
12
+ "Clone",
13
+ "Copy",
14
+ "Debug",
15
+ "Default",
16
+ "Eq",
17
+ "PartialEq",
18
+ "Ord",
19
+ "PartialOrd",
20
+ "Hash",
21
+ ]);
22
+ export const RsAb04 = {
23
+ id: "RS-AB-04-derive-density",
24
+ title: "Derive density",
25
+ aliases: ["RS-AB-04"],
26
+ tier: 1,
27
+ category: "abstraction-bloat",
28
+ kind: "legibility",
29
+ configSchema: RsAb04Config,
30
+ defaultConfig: {
31
+ exclude_globs: [...DEFAULT_RUST_EXCLUDE_GLOBS],
32
+ top_n_diagnostics: 10,
33
+ },
34
+ inputs: [],
35
+ compute: (config) => Effect.gen(function* () {
36
+ const project = yield* RustProjectTag;
37
+ return yield* Effect.tryPromise({
38
+ try: async () => {
39
+ const entries = [];
40
+ for (const file of project.sourceFiles) {
41
+ if (isExcluded(file, config.exclude_globs))
42
+ continue;
43
+ const scope = resolveRustFileScope(project, file);
44
+ const tree = await parseRustFile(file);
45
+ walkAttributedNodes(tree.rootNode, ({ node, ancestors, attachedAttributes, testGated }) => {
46
+ if (testGated || !["struct_item", "enum_item", "union_item"].includes(node.type))
47
+ return;
48
+ const derives = attachedAttributes.flatMap(extractDerives);
49
+ if (derives.length === 0)
50
+ return;
51
+ const { modulePath } = modulePathForAncestors(scope, ancestors);
52
+ entries.push({
53
+ file,
54
+ module: modulePath,
55
+ name: firstNamedChild(node, "type_identifier")?.text ?? "<anonymous>",
56
+ line: node.startPosition.row + 1,
57
+ deriveCount: derives.length,
58
+ standardDerives: derives.filter((derive) => STANDARD_DERIVES.has(derive)),
59
+ customDerives: derives.filter((derive) => !STANDARD_DERIVES.has(derive)),
60
+ });
61
+ });
62
+ }
63
+ entries.sort((left, right) => right.deriveCount - left.deriveCount || left.file.localeCompare(right.file));
64
+ return {
65
+ types: entries,
66
+ distribution: summarize(entries.map((entry) => entry.deriveCount)),
67
+ analysisMode: "attribute-attached-derive-count",
68
+ };
69
+ },
70
+ catch: (cause) => new SignalComputeError({ signalId: "RS-AB-04-derive-density", message: String(cause), cause }),
71
+ });
72
+ }),
73
+ score: (out) => {
74
+ if (out.types.length === 0)
75
+ return 1;
76
+ const customHeavy = out.types.filter((entry) => entry.customDerives.length >= 2).length;
77
+ return Math.max(0, 1 - customHeavy / out.types.length);
78
+ },
79
+ diagnose: (out) => out.types.slice(0, 10).map((entry) => ({
80
+ severity: entry.customDerives.length > 0 ? "info" : "warn",
81
+ message: `${entry.name} derives ${entry.deriveCount} macros (${entry.customDerives.length} custom)`,
82
+ location: { file: entry.file, line: entry.line },
83
+ data: {
84
+ module: entry.module,
85
+ deriveCount: entry.deriveCount,
86
+ standardDerives: entry.standardDerives,
87
+ customDerives: entry.customDerives,
88
+ analysisMode: out.analysisMode,
89
+ },
90
+ })),
91
+ };
92
+ const extractDerives = (attribute) => {
93
+ const match = /#\s*\[\s*derive\s*\(([^\)]*)\)\s*\]/.exec(attribute.text);
94
+ if (match === null)
95
+ return [];
96
+ return match[1]
97
+ .split(",")
98
+ .map((value) => value.trim())
99
+ .filter((value) => value.length > 0);
100
+ };
101
+ //# sourceMappingURL=rs-ab-04-derive-density.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"rs-ab-04-derive-density.js","sourceRoot":"","sources":["../../src/signals/rs-ab-04-derive-density.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,29 @@
1
+ import { type DistributionalSummary, type Signal } from "@skastr0/pulsar-core/signal";
2
+ import { Schema } from "effect";
3
+ import { RustProjectTag } from "../project.js";
4
+ declare const RsAd01Config: Schema.Struct<{
5
+ exclude_globs: Schema.Array$<typeof Schema.String>;
6
+ warn_pub_ratio: typeof Schema.Number;
7
+ top_n_diagnostics: typeof Schema.Number;
8
+ }>;
9
+ type RsAd01Config = typeof RsAd01Config.Type;
10
+ interface ModuleVisibilitySurface {
11
+ readonly module: string;
12
+ readonly file: string;
13
+ readonly pub: number;
14
+ readonly pubCrate: number;
15
+ readonly pubSuper: number;
16
+ readonly pubInPath: number;
17
+ readonly private: number;
18
+ readonly total: number;
19
+ readonly pubRatio: number;
20
+ }
21
+ interface RsAd01Output {
22
+ readonly modules: ReadonlyArray<ModuleVisibilitySurface>;
23
+ readonly byModule: ReadonlyMap<string, DistributionalSummary>;
24
+ readonly totalItems: number;
25
+ readonly overallPubRatio: number;
26
+ }
27
+ export declare const RsAd01: Signal<RsAd01Config, RsAd01Output, RustProjectTag>;
28
+ export {};
29
+ //# sourceMappingURL=rs-ad-01-visibility-surface.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"rs-ad-01-visibility-surface.d.ts","sourceRoot":"","sources":["../../src/signals/rs-ad-01-visibility-surface.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,qBAAqB,EAC1B,KAAK,MAAM,EAGZ,MAAM,6BAA6B,CAAA;AACpC,OAAO,EAAU,MAAM,EAAE,MAAM,QAAQ,CAAA;AAEvC,OAAO,EAAE,cAAc,EAAoB,MAAM,eAAe,CAAA;AAGhE,QAAA,MAAM,YAAY;;;;EAIhB,CAAA;AACF,KAAK,YAAY,GAAG,OAAO,YAAY,CAAC,IAAI,CAAA;AAE5C,UAAU,uBAAuB;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAC1B;AAED,UAAU,YAAY;IACpB,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC,uBAAuB,CAAC,CAAA;IACxD,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAA;IAC7D,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAA;CACjC;AAwBD,eAAO,MAAM,MAAM,EAAE,MAAM,CAAC,YAAY,EAAE,YAAY,EAAE,cAAc,CAkDrE,CAAA"}
@@ -0,0 +1,129 @@
1
+ import { SignalComputeError, summarize, } from "@skastr0/pulsar-core/signal";
2
+ import { Effect, Schema } from "effect";
3
+ import { collectRustProjectFacts } from "../rust-analysis.js";
4
+ import { RustProjectTag } from "../project.js";
5
+ import { isExcluded } from "./shared-globs.js";
6
+ const RsAd01Config = Schema.Struct({
7
+ exclude_globs: Schema.Array(Schema.String),
8
+ warn_pub_ratio: Schema.Number,
9
+ top_n_diagnostics: Schema.Number,
10
+ });
11
+ const emptyVisibilitySurfaceOutput = () => ({
12
+ modules: [],
13
+ byModule: new Map(),
14
+ totalItems: 0,
15
+ overallPubRatio: 0,
16
+ });
17
+ const emptyModuleVisibilitySurface = (module, file) => ({
18
+ module,
19
+ file,
20
+ pub: 0,
21
+ pubCrate: 0,
22
+ pubSuper: 0,
23
+ pubInPath: 0,
24
+ private: 0,
25
+ total: 0,
26
+ pubRatio: 0,
27
+ });
28
+ export const RsAd01 = {
29
+ id: "RS-AD-01-visibility-surface",
30
+ title: "Visibility surface",
31
+ aliases: ["RS-AD-01"],
32
+ tier: 1,
33
+ category: "architectural-drift",
34
+ kind: "structural",
35
+ configSchema: RsAd01Config,
36
+ defaultConfig: {
37
+ exclude_globs: ["**/target/**", "**/tests/**", "**/examples/**", "**/benches/**"],
38
+ warn_pub_ratio: 0.35,
39
+ top_n_diagnostics: 5,
40
+ },
41
+ inputs: [],
42
+ compute: (config) => Effect.gen(function* () {
43
+ const project = yield* RustProjectTag;
44
+ return yield* Effect.tryPromise({
45
+ try: () => computeVisibilitySurface(project, config),
46
+ catch: (cause) => new SignalComputeError({
47
+ signalId: "RS-AD-01-visibility-surface",
48
+ message: String(cause),
49
+ cause,
50
+ }),
51
+ });
52
+ }),
53
+ score: (out) => {
54
+ if (out.modules.length === 0)
55
+ return 1;
56
+ const averageRatio = out.modules.reduce((sum, module) => sum + module.pubRatio, 0) / out.modules.length;
57
+ if (averageRatio <= 0.35)
58
+ return 1;
59
+ return Math.max(0, 1 - (averageRatio - 0.35) / 0.65);
60
+ },
61
+ diagnose: (out) => out.modules.slice(0, 5).map((module) => ({
62
+ severity: module.pubRatio >= 0.5 ? "warn" : "info",
63
+ message: `Module ${module.module} exposes ${(module.pubRatio * 100).toFixed(0)}% of its items as pub`,
64
+ location: { file: module.file },
65
+ data: {
66
+ module: module.module,
67
+ pubRatio: module.pubRatio,
68
+ counts: {
69
+ pub: module.pub,
70
+ pubCrate: module.pubCrate,
71
+ pubSuper: module.pubSuper,
72
+ pubInPath: module.pubInPath,
73
+ private: module.private,
74
+ },
75
+ },
76
+ })),
77
+ };
78
+ const computeVisibilitySurface = async (project, config) => {
79
+ if (project.sourceFiles.length === 0)
80
+ return emptyVisibilitySurfaceOutput();
81
+ const facts = await collectRustProjectFacts(project);
82
+ const grouped = new Map();
83
+ for (const item of facts.items) {
84
+ if (item.kind === "impl")
85
+ continue;
86
+ if (isExcluded(item.file, config.exclude_globs))
87
+ continue;
88
+ recordVisibilityItem(grouped, item.modulePath, item.file, item.visibility.kind);
89
+ }
90
+ const modules = finalizeVisibilityModules(grouped);
91
+ const totalItems = modules.reduce((sum, module) => sum + module.total, 0);
92
+ const publicItems = modules.reduce((sum, module) => sum + module.pub, 0);
93
+ return {
94
+ modules,
95
+ byModule: summarizeVisibilityByModule(modules),
96
+ totalItems,
97
+ overallPubRatio: totalItems === 0 ? 0 : publicItems / totalItems,
98
+ };
99
+ };
100
+ const recordVisibilityItem = (grouped, modulePath, file, visibilityKind) => {
101
+ const existing = { ...(grouped.get(modulePath) ?? emptyModuleVisibilitySurface(modulePath, file)) };
102
+ switch (visibilityKind) {
103
+ case "pub":
104
+ existing.pub += 1;
105
+ break;
106
+ case "pub-crate":
107
+ existing.pubCrate += 1;
108
+ break;
109
+ case "pub-super":
110
+ existing.pubSuper += 1;
111
+ break;
112
+ case "pub-in-path":
113
+ existing.pubInPath += 1;
114
+ break;
115
+ case "private":
116
+ existing.private += 1;
117
+ break;
118
+ }
119
+ existing.total += 1;
120
+ grouped.set(modulePath, existing);
121
+ };
122
+ const finalizeVisibilityModules = (grouped) => [...grouped.values()]
123
+ .map((entry) => ({
124
+ ...entry,
125
+ pubRatio: entry.total === 0 ? 0 : entry.pub / entry.total,
126
+ }))
127
+ .sort((a, b) => b.pubRatio - a.pubRatio || a.module.localeCompare(b.module));
128
+ const summarizeVisibilityByModule = (modules) => new Map(modules.map((module) => [module.module, summarize([module.pubRatio])]));
129
+ //# sourceMappingURL=rs-ad-01-visibility-surface.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"rs-ad-01-visibility-surface.js","sourceRoot":"","sources":["../../src/signals/rs-ad-01-visibility-surface.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,3 @@
1
+ import type { RustBoundaryRule } from "./rs-ad-02-types.js";
2
+ export declare const normalizeBoundaryRules: (raw: unknown) => ReadonlyMap<string, RustBoundaryRule>;
3
+ //# sourceMappingURL=rs-ad-02-boundary-rules.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"rs-ad-02-boundary-rules.d.ts","sourceRoot":"","sources":["../../src/signals/rs-ad-02-boundary-rules.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AAM3D,eAAO,MAAM,sBAAsB,GAAI,KAAK,OAAO,KAAG,WAAW,CAAC,MAAM,EAAE,gBAAgB,CAwBzF,CAAA"}