@codefast/cli 1.0.0-canary.6 → 1.0.0-canary.7

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 (274) hide show
  1. package/README.md +106 -480
  2. package/dist/arrange/analyze.js +25 -0
  3. package/dist/arrange/analyze.js.map +1 -0
  4. package/dist/arrange/cli-schema.js +29 -0
  5. package/dist/arrange/cli-schema.js.map +1 -0
  6. package/dist/arrange/command.js +170 -0
  7. package/dist/arrange/command.js.map +1 -0
  8. package/dist/arrange/domain/analyze-service.js +122 -0
  9. package/dist/arrange/domain/analyze-service.js.map +1 -0
  10. package/dist/arrange/domain/ast/ast-node.js +240 -0
  11. package/dist/arrange/domain/ast/ast-node.js.map +1 -0
  12. package/dist/arrange/domain/ast/collectors-cn.js +81 -0
  13. package/dist/arrange/domain/ast/collectors-cn.js.map +1 -0
  14. package/dist/arrange/domain/ast/collectors-jsx.js +24 -0
  15. package/dist/arrange/domain/ast/collectors-jsx.js.map +1 -0
  16. package/dist/arrange/domain/ast/collectors-tv.js +319 -0
  17. package/dist/arrange/domain/ast/collectors-tv.js.map +1 -0
  18. package/dist/arrange/domain/ast/helpers.js +151 -0
  19. package/dist/arrange/domain/ast/helpers.js.map +1 -0
  20. package/dist/arrange/domain/ast/simplify-targets.js +161 -0
  21. package/dist/arrange/domain/ast/simplify-targets.js.map +1 -0
  22. package/dist/arrange/domain/ast/targets.js +182 -0
  23. package/dist/arrange/domain/ast/targets.js.map +1 -0
  24. package/dist/arrange/domain/constants.js +225 -0
  25. package/dist/arrange/domain/constants.js.map +1 -0
  26. package/dist/arrange/domain/grouping-service.js +128 -0
  27. package/dist/arrange/domain/grouping-service.js.map +1 -0
  28. package/dist/arrange/domain/grouping.js +435 -0
  29. package/dist/arrange/domain/grouping.js.map +1 -0
  30. package/dist/arrange/domain/imports.js +160 -0
  31. package/dist/arrange/domain/imports.js.map +1 -0
  32. package/dist/arrange/domain/source-text-formatters.js +100 -0
  33. package/dist/arrange/domain/source-text-formatters.js.map +1 -0
  34. package/dist/arrange/domain/tailwind-token.js +50 -0
  35. package/dist/arrange/domain/tailwind-token.js.map +1 -0
  36. package/dist/arrange/domain/token-classifier.js +448 -0
  37. package/dist/arrange/domain/token-classifier.js.map +1 -0
  38. package/dist/arrange/domain/types.js +11 -0
  39. package/dist/arrange/domain/types.js.map +1 -0
  40. package/dist/arrange/output.js +120 -0
  41. package/dist/arrange/output.js.map +1 -0
  42. package/dist/arrange/process-file.js +44 -0
  43. package/dist/arrange/process-file.js.map +1 -0
  44. package/dist/arrange/resolve-target.js +33 -0
  45. package/dist/arrange/resolve-target.js.map +1 -0
  46. package/dist/arrange/scan-target.js +30 -0
  47. package/dist/arrange/scan-target.js.map +1 -0
  48. package/dist/arrange/simplify-process-file.js +29 -0
  49. package/dist/arrange/simplify-process-file.js.map +1 -0
  50. package/dist/arrange/simplify-sync.js +29 -0
  51. package/dist/arrange/simplify-sync.js.map +1 -0
  52. package/dist/arrange/source-parse.js +17 -0
  53. package/dist/arrange/source-parse.js.map +1 -0
  54. package/dist/arrange/suggest.js +14 -0
  55. package/dist/arrange/suggest.js.map +1 -0
  56. package/dist/arrange/sync.js +48 -0
  57. package/dist/arrange/sync.js.map +1 -0
  58. package/dist/arrange/typescript-ast-translator.js +455 -0
  59. package/dist/arrange/typescript-ast-translator.js.map +1 -0
  60. package/dist/arrange/workspace.js +31 -0
  61. package/dist/arrange/workspace.js.map +1 -0
  62. package/dist/audit/cli-schema.js +22 -0
  63. package/dist/audit/cli-schema.js.map +1 -0
  64. package/dist/audit/command.js +60 -0
  65. package/dist/audit/command.js.map +1 -0
  66. package/dist/audit/domain/audit-file.js +101 -0
  67. package/dist/audit/domain/audit-file.js.map +1 -0
  68. package/dist/audit/domain/mappings.js +103 -0
  69. package/dist/audit/domain/mappings.js.map +1 -0
  70. package/dist/audit/domain/tokenize.js +83 -0
  71. package/dist/audit/domain/tokenize.js.map +1 -0
  72. package/dist/audit/domain/types.js +2 -0
  73. package/dist/audit/domain/types.js.map +1 -0
  74. package/dist/audit/output.js +44 -0
  75. package/dist/audit/output.js.map +1 -0
  76. package/dist/audit/prepare.js +42 -0
  77. package/dist/audit/prepare.js.map +1 -0
  78. package/dist/audit/run.js +57 -0
  79. package/dist/audit/run.js.map +1 -0
  80. package/dist/{bin.mjs → bin.js} +2 -4
  81. package/dist/bin.js.map +1 -0
  82. package/dist/cli.js +45 -0
  83. package/dist/cli.js.map +1 -0
  84. package/dist/core/cli/format-error.js +19 -0
  85. package/dist/core/cli/format-error.js.map +1 -0
  86. package/dist/core/cli/global-options.js +10 -0
  87. package/dist/core/cli/global-options.js.map +1 -0
  88. package/dist/core/cli/positional.js +9 -0
  89. package/dist/core/cli/positional.js.map +1 -0
  90. package/dist/core/cli/result-handle.js +69 -0
  91. package/dist/core/cli/result-handle.js.map +1 -0
  92. package/dist/core/config/loader.js +88 -0
  93. package/dist/core/config/loader.js.map +1 -0
  94. package/dist/core/config/schema.js +97 -0
  95. package/dist/core/config/schema.js.map +1 -0
  96. package/dist/core/config/warnings.js +12 -0
  97. package/dist/core/config/warnings.js.map +1 -0
  98. package/dist/core/config.js +18 -0
  99. package/dist/core/config.js.map +1 -0
  100. package/dist/core/errors.js +58 -0
  101. package/dist/core/errors.js.map +1 -0
  102. package/dist/core/exit-codes.js +15 -0
  103. package/dist/core/exit-codes.js.map +1 -0
  104. package/dist/core/filesystem/node.js +33 -0
  105. package/dist/core/filesystem/node.js.map +1 -0
  106. package/dist/core/filesystem/port.js +2 -0
  107. package/dist/core/filesystem/port.js.map +1 -0
  108. package/dist/core/glob.js +20 -0
  109. package/dist/core/glob.js.map +1 -0
  110. package/dist/core/logger.js +13 -0
  111. package/dist/core/logger.js.map +1 -0
  112. package/dist/core/result.js +16 -0
  113. package/dist/core/result.js.map +1 -0
  114. package/dist/core/schema-parse.js +21 -0
  115. package/dist/core/schema-parse.js.map +1 -0
  116. package/dist/core/source-text-edit.js +62 -0
  117. package/dist/core/source-text-edit.js.map +1 -0
  118. package/dist/core/verbose-diagnostics.js +9 -0
  119. package/dist/core/verbose-diagnostics.js.map +1 -0
  120. package/dist/core/workspace/resolver.js +208 -0
  121. package/dist/core/workspace/resolver.js.map +1 -0
  122. package/dist/core/workspace/typescript-walk.js +41 -0
  123. package/dist/core/workspace/typescript-walk.js.map +1 -0
  124. package/dist/mirror/cli-result.js +20 -0
  125. package/dist/mirror/cli-result.js.map +1 -0
  126. package/dist/mirror/cli-schema.js +11 -0
  127. package/dist/mirror/cli-schema.js.map +1 -0
  128. package/dist/mirror/command.js +73 -0
  129. package/dist/mirror/command.js.map +1 -0
  130. package/dist/mirror/dist-filesystem-impl.js +53 -0
  131. package/dist/mirror/dist-filesystem-impl.js.map +1 -0
  132. package/dist/mirror/domain/constants.js +21 -0
  133. package/dist/mirror/domain/constants.js.map +1 -0
  134. package/dist/mirror/domain/dirent-guard.js +16 -0
  135. package/dist/mirror/domain/dirent-guard.js.map +1 -0
  136. package/dist/mirror/domain/dist-filesystem.js +2 -0
  137. package/dist/mirror/domain/dist-filesystem.js.map +1 -0
  138. package/dist/mirror/domain/errors.js +19 -0
  139. package/dist/mirror/domain/errors.js.map +1 -0
  140. package/dist/mirror/domain/exports.js +284 -0
  141. package/dist/mirror/domain/exports.js.map +1 -0
  142. package/dist/mirror/domain/package-display-name.js +10 -0
  143. package/dist/mirror/domain/package-display-name.js.map +1 -0
  144. package/dist/mirror/domain/path-normalizer.js +8 -0
  145. package/dist/mirror/domain/path-normalizer.js.map +1 -0
  146. package/dist/mirror/domain/types.js +2 -0
  147. package/dist/mirror/domain/types.js.map +1 -0
  148. package/dist/mirror/output.js +47 -0
  149. package/dist/mirror/output.js.map +1 -0
  150. package/dist/mirror/package-path.js +40 -0
  151. package/dist/mirror/package-path.js.map +1 -0
  152. package/dist/mirror/prepare.js +37 -0
  153. package/dist/mirror/prepare.js.map +1 -0
  154. package/dist/mirror/supplement-exports.js +157 -0
  155. package/dist/mirror/supplement-exports.js.map +1 -0
  156. package/dist/mirror/sync-reporter.js +125 -0
  157. package/dist/mirror/sync-reporter.js.map +1 -0
  158. package/dist/mirror/sync-types.js +2 -0
  159. package/dist/mirror/sync-types.js.map +1 -0
  160. package/dist/mirror/sync-workspace-package.js +117 -0
  161. package/dist/mirror/sync-workspace-package.js.map +1 -0
  162. package/dist/mirror/sync.js +90 -0
  163. package/dist/mirror/sync.js.map +1 -0
  164. package/dist/mirror/write-exports.js +145 -0
  165. package/dist/mirror/write-exports.js.map +1 -0
  166. package/dist/tag/cli-result.js +12 -0
  167. package/dist/tag/cli-result.js.map +1 -0
  168. package/dist/tag/cli-schema.js +13 -0
  169. package/dist/tag/cli-schema.js.map +1 -0
  170. package/dist/tag/command.js +69 -0
  171. package/dist/tag/command.js.map +1 -0
  172. package/dist/tag/domain/types.js +2 -0
  173. package/dist/tag/domain/types.js.map +1 -0
  174. package/dist/tag/output.js +101 -0
  175. package/dist/tag/output.js.map +1 -0
  176. package/dist/tag/prepare.js +30 -0
  177. package/dist/tag/prepare.js.map +1 -0
  178. package/dist/tag/resolve-target-path.js +14 -0
  179. package/dist/tag/resolve-target-path.js.map +1 -0
  180. package/dist/tag/since-writer.js +231 -0
  181. package/dist/tag/since-writer.js.map +1 -0
  182. package/dist/tag/sync.js +166 -0
  183. package/dist/tag/sync.js.map +1 -0
  184. package/dist/tag/target-candidates.js +79 -0
  185. package/dist/tag/target-candidates.js.map +1 -0
  186. package/dist/tag/target-runner.js +25 -0
  187. package/dist/tag/target-runner.js.map +1 -0
  188. package/dist/tag/version-resolver.js +28 -0
  189. package/dist/tag/version-resolver.js.map +1 -0
  190. package/package.json +27 -21
  191. package/dist/arrange/analyze.mjs +0 -24
  192. package/dist/arrange/cli-schema.mjs +0 -27
  193. package/dist/arrange/command.mjs +0 -130
  194. package/dist/arrange/domain/analyze-service.mjs +0 -102
  195. package/dist/arrange/domain/ast/ast-node.mjs +0 -215
  196. package/dist/arrange/domain/ast/collectors-cn.mjs +0 -64
  197. package/dist/arrange/domain/ast/collectors-jsx.mjs +0 -23
  198. package/dist/arrange/domain/ast/collectors-tv.mjs +0 -189
  199. package/dist/arrange/domain/ast/helpers.mjs +0 -108
  200. package/dist/arrange/domain/ast/simplify-targets.mjs +0 -109
  201. package/dist/arrange/domain/ast/targets.mjs +0 -134
  202. package/dist/arrange/domain/constants.mjs +0 -213
  203. package/dist/arrange/domain/grouping-service.mjs +0 -121
  204. package/dist/arrange/domain/grouping.mjs +0 -338
  205. package/dist/arrange/domain/imports.mjs +0 -107
  206. package/dist/arrange/domain/source-text-formatters.mjs +0 -88
  207. package/dist/arrange/domain/tailwind-token.mjs +0 -40
  208. package/dist/arrange/domain/token-classifier.mjs +0 -218
  209. package/dist/arrange/domain/types.mjs +0 -1
  210. package/dist/arrange/output.mjs +0 -87
  211. package/dist/arrange/process-file.mjs +0 -42
  212. package/dist/arrange/resolve-target.mjs +0 -24
  213. package/dist/arrange/scan-target.mjs +0 -29
  214. package/dist/arrange/simplify-process-file.mjs +0 -35
  215. package/dist/arrange/simplify-sync.mjs +0 -32
  216. package/dist/arrange/source-parse.mjs +0 -18
  217. package/dist/arrange/suggest.mjs +0 -15
  218. package/dist/arrange/sync.mjs +0 -51
  219. package/dist/arrange/typescript-ast-translator.mjs +0 -354
  220. package/dist/arrange/workspace.mjs +0 -31
  221. package/dist/cli.mjs +0 -34
  222. package/dist/core/cli/format-error.mjs +0 -15
  223. package/dist/core/cli/global-options.mjs +0 -10
  224. package/dist/core/cli/positional.mjs +0 -11
  225. package/dist/core/cli/result-handle.mjs +0 -51
  226. package/dist/core/config/loader.mjs +0 -79
  227. package/dist/core/config/schema.mjs +0 -60
  228. package/dist/core/config/warnings.mjs +0 -12
  229. package/dist/core/config.mjs +0 -19
  230. package/dist/core/errors.mjs +0 -35
  231. package/dist/core/exit-codes.mjs +0 -17
  232. package/dist/core/filesystem/node.mjs +0 -32
  233. package/dist/core/filesystem/port.mjs +0 -1
  234. package/dist/core/glob.mjs +0 -20
  235. package/dist/core/logger.mjs +0 -15
  236. package/dist/core/result.mjs +0 -21
  237. package/dist/core/schema-parse.mjs +0 -18
  238. package/dist/core/source-text-edit.mjs +0 -56
  239. package/dist/core/verbose-diagnostics.mjs +0 -11
  240. package/dist/core/workspace/resolver.mjs +0 -177
  241. package/dist/core/workspace/typescript-walk.mjs +0 -36
  242. package/dist/mirror/cli-result.mjs +0 -22
  243. package/dist/mirror/cli-schema.mjs +0 -13
  244. package/dist/mirror/command.mjs +0 -58
  245. package/dist/mirror/dist-filesystem-impl.mjs +0 -42
  246. package/dist/mirror/domain/constants.mjs +0 -31
  247. package/dist/mirror/domain/dirent-guard.mjs +0 -16
  248. package/dist/mirror/domain/dist-filesystem.mjs +0 -1
  249. package/dist/mirror/domain/errors.mjs +0 -21
  250. package/dist/mirror/domain/exports.mjs +0 -226
  251. package/dist/mirror/domain/package-display-name.mjs +0 -12
  252. package/dist/mirror/domain/path-normalizer.mjs +0 -10
  253. package/dist/mirror/domain/types.mjs +0 -1
  254. package/dist/mirror/output.mjs +0 -48
  255. package/dist/mirror/package-path.mjs +0 -32
  256. package/dist/mirror/prepare.mjs +0 -33
  257. package/dist/mirror/supplement-exports.mjs +0 -114
  258. package/dist/mirror/sync-reporter.mjs +0 -107
  259. package/dist/mirror/sync-types.mjs +0 -1
  260. package/dist/mirror/sync-workspace-package.mjs +0 -109
  261. package/dist/mirror/sync.mjs +0 -88
  262. package/dist/mirror/write-exports.mjs +0 -94
  263. package/dist/tag/cli-result.mjs +0 -11
  264. package/dist/tag/cli-schema.mjs +0 -15
  265. package/dist/tag/command.mjs +0 -56
  266. package/dist/tag/domain/types.mjs +0 -1
  267. package/dist/tag/output.mjs +0 -87
  268. package/dist/tag/prepare.mjs +0 -29
  269. package/dist/tag/resolve-target-path.mjs +0 -12
  270. package/dist/tag/since-writer.mjs +0 -131
  271. package/dist/tag/sync.mjs +0 -149
  272. package/dist/tag/target-candidates.mjs +0 -68
  273. package/dist/tag/target-runner.mjs +0 -26
  274. package/dist/tag/version-resolver.mjs +0 -25
@@ -1,338 +0,0 @@
1
- import { BUCKET_ORDER } from "./constants.mjs";
2
- import { stripVariants, tokenizeClassString } from "./tailwind-token.mjs";
3
- import { bucketsCompatible, bucketsMergeCompatible, classifyToken, compositeSecondaryOrder, selectorKey, stateKey } from "./token-classifier.mjs";
4
- //#region src/arrange/domain/grouping.ts
5
- /**
6
- * `cn()` grouping: bucket sequence is {@link BUCKET_ORDER} only; tokens are classified with
7
- * {@link classifyToken}. Comparators here (`compareClassifiedTailwindTokensForCnGrouping`, …)
8
- * are the single place for variant-aware sort — do not reintroduce parallel bucket ordering.
9
- */
10
- /**
11
- * Separates bucket id from variant key in {@link buildFirstVariantKeySourceIndex} map keys.
12
- */
13
- const VARIANT_BUCKET_KEY_SEP = "\0";
14
- function isVariantKeyedBucket(bucket) {
15
- return bucket === "selector" || bucket === "state" || bucket === "starting";
16
- }
17
- function variantGroupKey(bucket, classToken) {
18
- return bucket === "selector" ? selectorKey(classToken) : stateKey(classToken);
19
- }
20
- function variantKeyedBlockMapKey(bucket, classToken) {
21
- return `${bucket}${VARIANT_BUCKET_KEY_SEP}${variantGroupKey(bucket, classToken)}`;
22
- }
23
- /**
24
- * Deterministic lexicographic order for Tailwind class tokens (and token-space signatures).
25
- * Used wherever we need stable, locale-agnostic ASCII ordering of utility strings.
26
- */
27
- function compareClassTokensCanonically(left, right) {
28
- return left.localeCompare(right);
29
- }
30
- /**
31
- * First source index where each `(bucket, variantGroupKey)` appears — drives stable clustering
32
- * in {@link suggestCnGroups} without reordering unrelated variant blocks by alphabet alone.
33
- */
34
- function buildFirstVariantKeySourceIndex(classified) {
35
- const firstVariantKeySourceIndex = /* @__PURE__ */ new Map();
36
- for (const item of classified) {
37
- if (!isVariantKeyedBucket(item.bucket)) continue;
38
- const mapKey = variantKeyedBlockMapKey(item.bucket, item.classToken);
39
- const prior = firstVariantKeySourceIndex.get(mapKey);
40
- if (prior === void 0 || item.index < prior) firstVariantKeySourceIndex.set(mapKey, item.index);
41
- }
42
- return firstVariantKeySourceIndex;
43
- }
44
- function compareClassifiedTailwindTokensForCnGrouping(left, right, firstVariantKeySourceIndex) {
45
- const bucketOrderDiff = BUCKET_ORDER[left.bucket] - BUCKET_ORDER[right.bucket];
46
- if (bucketOrderDiff !== 0) return bucketOrderDiff;
47
- if (left.bucket === "composite" && right.bucket === "composite") {
48
- const compositeOrderDiff = compositeSecondaryOrder(stripVariants(left.classToken)) - compositeSecondaryOrder(stripVariants(right.classToken));
49
- if (compositeOrderDiff !== 0) return compositeOrderDiff;
50
- return left.index - right.index;
51
- }
52
- if (isVariantKeyedBucket(left.bucket) && isVariantKeyedBucket(right.bucket)) {
53
- const leftMapKey = variantKeyedBlockMapKey(left.bucket, left.classToken);
54
- const rightMapKey = variantKeyedBlockMapKey(right.bucket, right.classToken);
55
- const leftBlockStart = firstVariantKeySourceIndex.get(leftMapKey);
56
- const rightBlockStart = firstVariantKeySourceIndex.get(rightMapKey);
57
- if (leftBlockStart === void 0 || rightBlockStart === void 0) throw new Error("invariant: variant-keyed token missing block start index");
58
- if (leftBlockStart !== rightBlockStart) return leftBlockStart - rightBlockStart;
59
- const variantKeyCompare = compareClassTokensCanonically(variantGroupKey(left.bucket, left.classToken), variantGroupKey(right.bucket, right.classToken));
60
- if (variantKeyCompare !== 0) return variantKeyCompare;
61
- return compareClassTokensCanonically(left.classToken, right.classToken);
62
- }
63
- return left.index - right.index;
64
- }
65
- /**
66
- * True when `staticLiteralTexts` carries the **same partition** of Tailwind tokens as
67
- * `suggestedGroups` from {@link suggestCnGroups}, ignoring order of arguments and
68
- * order of tokens within each chunk.
69
- *
70
- * @since 0.3.16-canary.0
71
- */
72
- function areCnTailwindPartitionsEquivalent(staticLiteralTexts, suggestedGroups) {
73
- const partitionSignatures = (chunks) => chunks.map((chunk) => {
74
- const classTokens = tokenizeClassString(chunk);
75
- return classTokens.length === 0 ? "" : [...classTokens].toSorted(compareClassTokensCanonically).join(" ");
76
- }).filter((s) => s.length > 0).sort(compareClassTokensCanonically);
77
- const staticPartitionSigs = partitionSignatures(staticLiteralTexts);
78
- const suggestedPartitionSigs = partitionSignatures(suggestedGroups);
79
- if (staticPartitionSigs.length !== suggestedPartitionSigs.length) return false;
80
- for (let i = 0; i < staticPartitionSigs.length; i++) if (staticPartitionSigs[i] !== suggestedPartitionSigs[i]) return false;
81
- return true;
82
- }
83
- /**
84
- * Dominant bucket of a whitespace-delimited class group (for merge heuristics).
85
- */
86
- function dominantBucketOfGroup(groupStr) {
87
- const counts = /* @__PURE__ */ new Map();
88
- for (const classToken of tokenizeClassString(groupStr)) {
89
- const tokenBucket = classifyToken(classToken);
90
- counts.set(tokenBucket, (counts.get(tokenBucket) ?? 0) + 1);
91
- }
92
- let best = "other";
93
- let bestN = 0;
94
- for (const [bucket, count] of counts) {
95
- if (count > bestN) {
96
- best = bucket;
97
- bestN = count;
98
- continue;
99
- }
100
- if (count === bestN && BUCKET_ORDER[bucket] < BUCKET_ORDER[best]) best = bucket;
101
- }
102
- return best;
103
- }
104
- /**
105
- * Dynamic cap: more tokens → allow more groups, within [BASE, CAP].
106
- */
107
- function dynamicMaxGroups(tokenCount) {
108
- const byTokens = Math.ceil(tokenCount / 2) + 2;
109
- return Math.max(4, Math.min(24, byTokens));
110
- }
111
- /**
112
- * Merge singleton groups (< MIN_GROUP_TOKENS tokens) into their nearest
113
- * neighbour. Prefers merging toward a bucket-compatible neighbor.
114
- *
115
- * Loop termination: each iteration either splices one element (shrinking the
116
- * array, guaranteeing progress) or finds no singleton that can merge and exits
117
- * via `changed = false`. Two mutually-incompatible singletons both hit
118
- * `continue` and `changed` stays false, so the loop exits without spinning.
119
- */
120
- function mergeSingletons(groups) {
121
- if (groups.length <= 1) return groups;
122
- const result = [...groups];
123
- let changed = true;
124
- while (changed) {
125
- changed = false;
126
- for (let i = 0; i < result.length; i++) {
127
- const groupAtI = result[i];
128
- if (groupAtI === void 0) throw new Error("invariant: mergeSingletons group missing");
129
- if (tokenizeClassString(groupAtI).length < 2) {
130
- if (result.length === 1) break;
131
- const myBucket = dominantBucketOfGroup(groupAtI);
132
- const prevGroup = i > 0 ? result[i - 1] : void 0;
133
- const nextGroup = i < result.length - 1 ? result[i + 1] : void 0;
134
- const prevCompat = prevGroup !== void 0 && bucketsMergeCompatible(myBucket, dominantBucketOfGroup(prevGroup));
135
- const nextCompat = nextGroup !== void 0 && bucketsMergeCompatible(myBucket, dominantBucketOfGroup(nextGroup));
136
- let mergeDir;
137
- if (nextCompat && !prevCompat) mergeDir = "forward";
138
- else if (prevCompat && !nextCompat) mergeDir = "backward";
139
- else if (prevCompat && nextCompat) mergeDir = i < result.length - 1 ? "forward" : "backward";
140
- else continue;
141
- if (mergeDir === "forward") {
142
- if (nextGroup === void 0) throw new Error("invariant: forward merge missing right group");
143
- result[i + 1] = `${groupAtI} ${nextGroup}`;
144
- } else {
145
- if (prevGroup === void 0) throw new Error("invariant: backward merge missing left group");
146
- result[i - 1] = `${prevGroup} ${groupAtI}`;
147
- }
148
- result.splice(i, 1);
149
- changed = true;
150
- break;
151
- }
152
- }
153
- }
154
- return result;
155
- }
156
- /**
157
- * Tie-break when two merge candidates are both {@link bucketsMergeCompatible} (same bucket or COMPATIBLE_BUCKET_SETS).
158
- */
159
- function capMergePenalty(leftBucket, rightBucket) {
160
- if (leftBucket === rightBucket) return 0;
161
- if (bucketsCompatible(leftBucket, rightBucket)) return 0;
162
- return 500;
163
- }
164
- /**
165
- * Merge adjacent groups until total count ≤ maxGroups.
166
- * Only merges pairs allowed by {@link bucketsMergeCompatible} — never glues incompatible
167
- * buckets (which previously defaulted to penalty 0 and merged layout+state when over cap).
168
- *
169
- * Complexity: O(n²) in the number of groups — each merge pass scans all remaining adjacent
170
- * pairs. In practice `n` is bounded by {@link MAX_GROUPS_CAP} (24) and typical class strings
171
- * are well below that, so this is not a concern for the current usage pattern. If this ever
172
- * runs in a high-throughput batch mode, consider a priority-queue approach.
173
- */
174
- function capGroups(groups, maxGroups) {
175
- const result = [...groups];
176
- const lengths = result.map((groupStr) => tokenizeClassString(groupStr).length);
177
- while (result.length > maxGroups) {
178
- const mergePairCandidates = [];
179
- for (let i = 0; i < result.length - 1; i++) {
180
- const leftGroup = result[i];
181
- const rightGroup = result[i + 1];
182
- const leftLen = lengths[i];
183
- const rightLen = lengths[i + 1];
184
- if (leftGroup === void 0 || rightGroup === void 0 || leftLen === void 0 || rightLen === void 0) throw new Error("invariant: capGroups adjacent pair missing");
185
- const dominantLeft = dominantBucketOfGroup(leftGroup);
186
- const dominantRight = dominantBucketOfGroup(rightGroup);
187
- if (!bucketsMergeCompatible(dominantLeft, dominantRight)) continue;
188
- mergePairCandidates.push({
189
- i,
190
- size: leftLen + rightLen,
191
- penalty: capMergePenalty(dominantLeft, dominantRight)
192
- });
193
- }
194
- if (mergePairCandidates.length === 0) break;
195
- const firstCandidate = mergePairCandidates[0];
196
- if (firstCandidate === void 0) throw new Error("invariant: merge candidates empty");
197
- let best = firstCandidate;
198
- for (const candidate of mergePairCandidates) if (candidate.penalty < best.penalty || candidate.penalty === best.penalty && candidate.size < best.size) best = candidate;
199
- const bestIdx = best.i;
200
- const leftMerge = result[bestIdx];
201
- const rightMerge = result[bestIdx + 1];
202
- const leftMergeLen = lengths[bestIdx];
203
- const rightMergeLen = lengths[bestIdx + 1];
204
- if (leftMerge === void 0 || rightMerge === void 0 || leftMergeLen === void 0 || rightMergeLen === void 0) throw new Error("invariant: capGroups best merge pair missing");
205
- result[bestIdx] = `${leftMerge} ${rightMerge}`;
206
- lengths[bestIdx] = leftMergeLen + rightMergeLen;
207
- result.splice(bestIdx + 1, 1);
208
- lengths.splice(bestIdx + 1, 1);
209
- }
210
- return result;
211
- }
212
- /**
213
- * If a chunk is **only** bare `ease-*` timing (Motion), buffer it and prepend to the **first**
214
- * **later** chunk that is predominantly `state` **and** contains some `animate-*` utility —
215
- * skipping intermediate `state` chunks (`sm:…`, `group-data-[…]:…`, etc.) that sit between
216
- * `ease-ui` and `data-open:animate-*`. If no such chunk exists, the ease chunk is left as-is.
217
- */
218
- function mergeEaseTimingIntoFollowingAnimatedState(groups) {
219
- const result = [...groups];
220
- let changed = true;
221
- while (changed) {
222
- changed = false;
223
- for (let i = 0; i < result.length; i++) {
224
- const chunkI = result[i];
225
- if (chunkI === void 0) throw new Error("invariant: mergeEase chunk missing");
226
- if (!chunkIsOnlyEaseTimingMotion(chunkI)) continue;
227
- const easeStr = chunkI;
228
- let target = -1;
229
- for (let j = i + 1; j < result.length; j++) {
230
- const chunkJ = result[j];
231
- if (chunkJ === void 0) throw new Error("invariant: mergeEase following chunk missing");
232
- if (dominantBucketOfGroup(chunkJ) !== "state") continue;
233
- if (!tokenizeClassString(chunkJ).some((classToken) => stripVariants(classToken).startsWith("animate"))) continue;
234
- target = j;
235
- break;
236
- }
237
- if (target === -1) continue;
238
- const targetChunk = result[target];
239
- if (targetChunk === void 0) throw new Error("invariant: mergeEase target chunk missing");
240
- result[target] = `${easeStr} ${targetChunk}`.trim();
241
- result.splice(i, 1);
242
- changed = true;
243
- break;
244
- }
245
- }
246
- return result;
247
- }
248
- function chunkIsOnlyEaseTimingMotion(groupStr) {
249
- const classTokens = tokenizeClassString(groupStr);
250
- if (classTokens.length === 0) return false;
251
- return classTokens.every((classToken) => classifyToken(classToken) === "motion" && stripVariants(classToken).startsWith("ease-"));
252
- }
253
- /**
254
- * @since 0.3.16-canary.0
255
- */
256
- function suggestCnGroups(classString) {
257
- const tokens = tokenizeClassString(classString);
258
- if (tokens.length === 0) return [];
259
- /**
260
- * Variant-keyed buckets (`state`, `starting`, `selector`): after global bucket ordering,
261
- * cluster tokens that share the same {@link variantGroupKey} so the same modifier stack
262
- * (e.g. `focus-visible:`) merges one `cn()` arg regardless of interleaved unrelated
263
- * variants. Block order follows the **first source index** of each key so unrelated
264
- * states keep document order; within a key, `classToken` order is lexicographic for
265
- * idempotency.
266
- */
267
- const classified = tokens.map((classToken, index) => ({
268
- classToken,
269
- bucket: classifyToken(classToken),
270
- index
271
- }));
272
- const firstVariantKeySourceIndex = buildFirstVariantKeySourceIndex(classified);
273
- classified.sort((left, right) => compareClassifiedTailwindTokensForCnGrouping(left, right, firstVariantKeySourceIndex));
274
- const rawGroups = [];
275
- /**
276
- * Bucket of the last token already placed in the current run (pairwise compat with `COMPATIBLE_BUCKET_SETS`).
277
- */
278
- let lastBucketInRun = null;
279
- let currentStateKey = null;
280
- let currentTokens = [];
281
- const flush = () => {
282
- if (currentTokens.length > 0) {
283
- rawGroups.push(currentTokens.join(" "));
284
- currentTokens = [];
285
- }
286
- lastBucketInRun = null;
287
- currentStateKey = null;
288
- };
289
- for (const { classToken, bucket: tokenBucket } of classified) {
290
- if (lastBucketInRun === null) {
291
- lastBucketInRun = tokenBucket;
292
- currentStateKey = isVariantKeyedBucket(tokenBucket) ? variantGroupKey(tokenBucket, classToken) : null;
293
- currentTokens.push(classToken);
294
- continue;
295
- }
296
- if (isVariantKeyedBucket(tokenBucket)) {
297
- const key = variantGroupKey(tokenBucket, classToken);
298
- if (currentStateKey !== null && key !== currentStateKey) {
299
- flush();
300
- lastBucketInRun = tokenBucket;
301
- currentStateKey = key;
302
- currentTokens.push(classToken);
303
- continue;
304
- }
305
- }
306
- if (!bucketsCompatible(tokenBucket, lastBucketInRun)) {
307
- flush();
308
- lastBucketInRun = tokenBucket;
309
- currentStateKey = isVariantKeyedBucket(tokenBucket) ? variantGroupKey(tokenBucket, classToken) : null;
310
- currentTokens.push(classToken);
311
- continue;
312
- }
313
- if (isVariantKeyedBucket(tokenBucket)) currentStateKey = variantGroupKey(tokenBucket, classToken);
314
- else if (currentStateKey !== null) currentStateKey = null;
315
- lastBucketInRun = tokenBucket;
316
- currentTokens.push(classToken);
317
- }
318
- flush();
319
- const withEaseMerged = mergeEaseTimingIntoFollowingAnimatedState(mergeSingletons(rawGroups));
320
- return capGroups(withEaseMerged, Math.max(dynamicMaxGroups(tokens.length), withEaseMerged.length));
321
- }
322
- /**
323
- * One label per suggested group: a single bucket name, or `mixed:a+b` when that chunk
324
- * spans multiple Tailwind buckets (matches `codefast arrange group` stdout).
325
- *
326
- * @since 0.3.16-canary.0
327
- */
328
- function summarizeGroupBucketLabels(groups) {
329
- return groups.map((g) => {
330
- const uniq = new Set(tokenizeClassString(g).map(classifyToken));
331
- if (uniq.size !== 1) return `mixed:${[...uniq].toSorted(compareClassTokensCanonically).join("+")}`;
332
- const onlyBucket = [...uniq][0];
333
- if (onlyBucket === void 0) return `mixed:${[...uniq].toSorted(compareClassTokensCanonically).join("+")}`;
334
- return onlyBucket;
335
- });
336
- }
337
- //#endregion
338
- export { areCnTailwindPartitionsEquivalent, suggestCnGroups, summarizeGroupBucketLabels };
@@ -1,107 +0,0 @@
1
- import { forEachDomainChild, isDomainIdentifier, isDomainImportDeclaration, isDomainNamedImports, isDomainStringLiteral } from "./ast/ast-node.mjs";
2
- import { endAfterOptionalCommaFollowingInSource } from "../../core/source-text-edit.mjs";
3
- //#region src/arrange/domain/imports.ts
4
- function sourceFileImportsCn(sourceFile) {
5
- for (const statement of sourceFile.statements) {
6
- if (!isDomainImportDeclaration(statement) || !statement.importClause) continue;
7
- const clause = statement.importClause;
8
- if (clause.name?.text === "cn") return true;
9
- if (clause.namedBindings && isDomainNamedImports(clause.namedBindings)) {
10
- for (const importedBinding of clause.namedBindings.elements) if (importedBinding.name.text === "cn") return true;
11
- }
12
- }
13
- return false;
14
- }
15
- /**
16
- * Resolve the module specifier used when injecting a `cn` import into a file.
17
- */
18
- function cnModuleSpecifierForFile(filePath, override) {
19
- if (override) return override;
20
- return "@codefast/tailwind-variants";
21
- }
22
- function findImportDeclarationFromModule(sourceFile, moduleSpecifier) {
23
- for (const statement of sourceFile.statements) {
24
- if (!isDomainImportDeclaration(statement)) continue;
25
- const spec = statement.moduleSpecifier;
26
- if (isDomainStringLiteral(spec) && spec.text === moduleSpecifier) return statement;
27
- }
28
- }
29
- function cnIsUsedInBody(node) {
30
- if (isDomainIdentifier(node) && node.text === "cn") return true;
31
- let found = false;
32
- forEachDomainChild(node, (child) => {
33
- if (!found) found = cnIsUsedInBody(child);
34
- });
35
- return found;
36
- }
37
- function removeCnSpecifier(sourceText, specifier, allSpecifiers) {
38
- const idx = allSpecifiers.indexOf(specifier);
39
- if (idx === 0) {
40
- const next = allSpecifiers[1];
41
- if (!next) return sourceText;
42
- return sourceText.slice(0, specifier.pos) + sourceText.slice(next.pos);
43
- }
44
- const prev = allSpecifiers[idx - 1];
45
- if (!prev) return sourceText;
46
- const endWithTrailingComma = endAfterOptionalCommaFollowingInSource(sourceText, specifier.end);
47
- return sourceText.slice(0, prev.end) + sourceText.slice(endWithTrailingComma);
48
- }
49
- /**
50
- * After simplify rewrites, drop the `cn` import specifier when `cn` is no
51
- * longer referenced anywhere outside the import declarations.
52
- *
53
- * @since 0.3.16-canary.0
54
- */
55
- function dropCnImportIfUnused(sourceFile) {
56
- const sourceText = sourceFile.text;
57
- for (const stmt of sourceFile.statements) {
58
- if (isDomainImportDeclaration(stmt)) continue;
59
- if (cnIsUsedInBody(stmt)) return sourceText;
60
- }
61
- for (const stmt of sourceFile.statements) {
62
- if (!isDomainImportDeclaration(stmt) || !stmt.importClause) continue;
63
- const clause = stmt.importClause;
64
- if (!clause.namedBindings || !isDomainNamedImports(clause.namedBindings)) continue;
65
- const elements = clause.namedBindings.elements;
66
- const cnSpecifier = elements.find((el) => el.name.text === "cn");
67
- if (!cnSpecifier) continue;
68
- if (elements.length === 1) {
69
- const lineEnd = sourceText.indexOf("\n", stmt.end);
70
- return sourceText.slice(0, stmt.pos) + (lineEnd !== -1 ? sourceText.slice(lineEnd + 1) : sourceText.slice(stmt.end));
71
- }
72
- return removeCnSpecifier(sourceText, cnSpecifier, elements);
73
- }
74
- return sourceText;
75
- }
76
- /**
77
- * @since 0.3.16-canary.0
78
- */
79
- function ensureCnImport(sourceFile, cnImportOverride) {
80
- const sourceText = sourceFile.text;
81
- if (sourceFileImportsCn(sourceFile)) return sourceText;
82
- const moduleSpecifier = cnModuleSpecifierForFile(sourceFile.fileName, cnImportOverride);
83
- const decl = findImportDeclarationFromModule(sourceFile, moduleSpecifier);
84
- if (decl?.importClause && !decl.importClause.isTypeOnly && decl.importClause.namedBindings && isDomainNamedImports(decl.importClause.namedBindings)) {
85
- const elements = decl.importClause.namedBindings.elements;
86
- if (elements.length > 0) {
87
- const firstElement = elements[0];
88
- if (firstElement === void 0) return sourceText;
89
- const pos = firstElement.pos;
90
- return `${sourceText.slice(0, pos)}cn, ${sourceText.slice(pos)}`;
91
- }
92
- }
93
- const importLine = `import { cn } from "${moduleSpecifier}";`;
94
- let firstImport = -1;
95
- for (const statement of sourceFile.statements) if (isDomainImportDeclaration(statement)) {
96
- firstImport = statement.pos;
97
- break;
98
- }
99
- const useClient = /^["']use client["'];?\s*\r?\n/.exec(sourceText);
100
- let insertAt;
101
- if (useClient) insertAt = useClient[0].length;
102
- else if (firstImport !== -1) insertAt = firstImport;
103
- else insertAt = 0;
104
- return `${sourceText.slice(0, insertAt)}${importLine}\n${sourceText.slice(insertAt)}`;
105
- }
106
- //#endregion
107
- export { dropCnImportIfUnused, ensureCnImport };
@@ -1,88 +0,0 @@
1
- import { indentOfLineContaining } from "../../core/source-text-edit.mjs";
2
- //#region src/arrange/domain/source-text-formatters.ts
3
- /**
4
- * @since 0.3.16-canary.0
5
- */
6
- function escapeTsStringLiteralContent(group) {
7
- return group.replaceAll("\\", "\\\\").replaceAll("\"", "\\\"");
8
- }
9
- /** Trailing comma on multiline Tailwind group lists (matches prior `cn` / `tv` array style). */
10
- function commaAfterTailwindGroupLine(groupIndex, groupCount) {
11
- return groupIndex < groupCount - 1 || groupCount > 1 ? "," : "";
12
- }
13
- /**
14
- * Multiline fragment for use *inside* an existing `cn(...)` — replaces one
15
- * string argument with several, without producing `cn(cn(...))`.
16
- */
17
- function formatCnArguments(groups, options) {
18
- const indent = options?.indent ?? " ";
19
- const commaAfterLast = options?.commaAfterLastGroup ?? options?.trailingClassName ?? false;
20
- const lines = [];
21
- for (let i = 0; i < groups.length; i++) {
22
- const group = groups[i];
23
- if (group === void 0) throw new Error("invariant: formatCnArguments group missing");
24
- const comma = i < groups.length - 1 || commaAfterLast ? "," : "";
25
- lines.push(`${indent}"${escapeTsStringLiteralContent(group)}"${comma}`);
26
- }
27
- if (options?.trailingClassName) lines.push(`${indent}className,`);
28
- return lines.join("\n");
29
- }
30
- /**
31
- * @since 0.3.16-canary.0
32
- */
33
- function formatCnCall(groups, options) {
34
- const lines = ["cn("];
35
- const commaOnEachStringLine = groups.length > 1 || Boolean(options?.trailingClassName);
36
- for (let i = 0; i < groups.length; i++) {
37
- const group = groups[i];
38
- if (group === void 0) throw new Error("invariant: formatCnCall group missing");
39
- const comma = commaOnEachStringLine ? "," : "";
40
- lines.push(` "${escapeTsStringLiteralContent(group)}"${comma}`);
41
- }
42
- if (options?.trailingClassName) lines.push(" className,");
43
- lines.push(")");
44
- return lines.join("\n");
45
- }
46
- /**
47
- * @since 0.3.16-canary.0
48
- */
49
- function formatArray(groups) {
50
- const lines = ["["];
51
- for (let i = 0; i < groups.length; i++) {
52
- const group = groups[i];
53
- if (group === void 0) throw new Error("invariant: formatArray group missing");
54
- const comma = commaAfterTailwindGroupLine(i, groups.length);
55
- lines.push(` "${escapeTsStringLiteralContent(group)}"${comma}`);
56
- }
57
- lines.push("]");
58
- return lines.join("\n");
59
- }
60
- /**
61
- * Multiple string literals as sequential lines for insertion **inside** an existing array
62
- * (e.g. `tv({ base: [ … ] })` — avoids `[[ "a", "b" ]]` when replacing one long string).
63
- *
64
- * @since 0.3.16-canary.0
65
- */
66
- function formatArrayElementsAsSiblingLines(groups, continuationPrefix) {
67
- const segments = [];
68
- for (let i = 0; i < groups.length; i++) {
69
- const group = groups[i];
70
- if (group === void 0) throw new Error("invariant: formatArrayElementsAsSiblingLines group missing");
71
- const comma = commaAfterTailwindGroupLine(i, groups.length);
72
- const segment = `"${escapeTsStringLiteralContent(group)}"${comma}`;
73
- segments.push(i === 0 ? segment : `\n${continuationPrefix}${segment}`);
74
- }
75
- return segments.join("");
76
- }
77
- /**
78
- * @since 0.3.16-canary.0
79
- */
80
- function formatJsxCnAttributeValue(groups, source, valueNodeStart) {
81
- const baseIndent = indentOfLineContaining(source, valueNodeStart);
82
- return `{cn(\n${formatCnArguments(groups, {
83
- indent: `${baseIndent} `,
84
- commaAfterLastGroup: groups.length > 1
85
- })}\n${baseIndent})}`;
86
- }
87
- //#endregion
88
- export { escapeTsStringLiteralContent, formatArray, formatArrayElementsAsSiblingLines, formatCnCall, formatJsxCnAttributeValue };
@@ -1,40 +0,0 @@
1
- import "./constants.mjs";
2
- //#region src/arrange/domain/tailwind-token.ts
3
- /**
4
- * @since 0.3.16-canary.0
5
- */
6
- function tokenizeClassString(classString) {
7
- return classString.trim().split(/\s+/).filter(Boolean);
8
- }
9
- /**
10
- * Index of the first `:` that separates a Tailwind variant segment from the rest.
11
- * Colons inside `[...]` (at positive bracket depth) are ignored so selectors like
12
- * `[&_a:hover]:text-red-500` split as `[&_a:hover]:` + `text-red-500`.
13
- *
14
- * @since 0.3.16-canary.0
15
- */
16
- function indexOfFirstVariantColon(text) {
17
- let depth = 0;
18
- for (let i = 0; i < text.length; i++) {
19
- const ch = text[i];
20
- if (ch === "[") depth++;
21
- else if (ch === "]") depth = Math.max(0, depth - 1);
22
- else if (ch === ":" && depth === 0) return i;
23
- }
24
- return -1;
25
- }
26
- /**
27
- * @since 0.3.16-canary.0
28
- */
29
- function stripVariants(token) {
30
- let withoutVariants = token;
31
- const maxStripVariantPasses = 12;
32
- for (let i = 0; i < maxStripVariantPasses; i++) {
33
- const colonIdx = indexOfFirstVariantColon(withoutVariants);
34
- if (colonIdx === -1) break;
35
- withoutVariants = withoutVariants.slice(colonIdx + 1);
36
- }
37
- return withoutVariants;
38
- }
39
- //#endregion
40
- export { indexOfFirstVariantColon, stripVariants, tokenizeClassString };