tailwindcss 0.0.0-insiders.bd4dddd → 0.0.0-insiders.bda8421

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 (224) hide show
  1. package/LICENSE +1 -2
  2. package/README.md +13 -10
  3. package/colors.d.ts +3 -0
  4. package/defaultConfig.d.ts +3 -0
  5. package/defaultTheme.d.ts +4 -0
  6. package/lib/cli/build/deps.js +62 -0
  7. package/lib/cli/build/index.js +54 -0
  8. package/lib/cli/build/plugin.js +371 -0
  9. package/lib/cli/build/utils.js +88 -0
  10. package/lib/cli/build/watching.js +182 -0
  11. package/lib/cli/help/index.js +73 -0
  12. package/lib/cli/index.js +230 -0
  13. package/lib/cli/init/index.js +63 -0
  14. package/lib/cli-peer-dependencies.js +28 -7
  15. package/lib/cli.js +1 -741
  16. package/lib/corePluginList.js +17 -4
  17. package/lib/corePlugins.js +2503 -1839
  18. package/lib/css/preflight.css +32 -13
  19. package/lib/featureFlags.js +45 -28
  20. package/lib/index.js +1 -29
  21. package/lib/lib/cacheInvalidation.js +92 -0
  22. package/lib/lib/collapseAdjacentRules.js +30 -10
  23. package/lib/lib/collapseDuplicateDeclarations.js +13 -8
  24. package/lib/lib/content.js +214 -0
  25. package/lib/lib/defaultExtractor.js +240 -31
  26. package/lib/lib/evaluateTailwindFunctions.js +117 -50
  27. package/lib/lib/expandApplyAtRules.js +466 -230
  28. package/lib/lib/expandTailwindAtRules.js +156 -135
  29. package/lib/lib/findAtConfigPath.js +46 -0
  30. package/lib/lib/generateRules.js +554 -200
  31. package/lib/lib/getModuleDependencies.js +88 -37
  32. package/lib/lib/load-config.js +57 -0
  33. package/lib/lib/normalizeTailwindDirectives.js +39 -33
  34. package/lib/lib/offsets.js +355 -0
  35. package/lib/lib/partitionApplyAtRules.js +58 -0
  36. package/lib/lib/regex.js +74 -0
  37. package/lib/lib/remap-bitfield.js +89 -0
  38. package/lib/lib/resolveDefaultsAtRules.js +97 -69
  39. package/lib/lib/setupContextUtils.js +796 -341
  40. package/lib/lib/setupTrackingContext.js +66 -71
  41. package/lib/lib/sharedState.js +45 -14
  42. package/lib/lib/substituteScreenAtRules.js +14 -10
  43. package/lib/plugin.js +48 -0
  44. package/{nesting → lib/postcss-plugins/nesting}/README.md +2 -2
  45. package/lib/postcss-plugins/nesting/index.js +21 -0
  46. package/lib/postcss-plugins/nesting/plugin.js +89 -0
  47. package/lib/processTailwindFeatures.js +37 -27
  48. package/lib/public/colors.js +272 -246
  49. package/lib/public/create-plugin.js +9 -5
  50. package/lib/public/default-config.js +10 -6
  51. package/lib/public/default-theme.js +10 -6
  52. package/lib/public/load-config.js +12 -0
  53. package/lib/public/resolve-config.js +11 -6
  54. package/lib/util/applyImportantSelector.js +36 -0
  55. package/lib/util/bigSign.js +6 -1
  56. package/lib/util/buildMediaQuery.js +13 -6
  57. package/lib/util/cloneDeep.js +9 -6
  58. package/lib/util/cloneNodes.js +44 -4
  59. package/lib/util/color.js +70 -53
  60. package/lib/util/colorNames.js +752 -0
  61. package/lib/util/configurePlugins.js +7 -2
  62. package/lib/util/createPlugin.js +8 -6
  63. package/lib/util/createUtilityPlugin.js +16 -16
  64. package/lib/util/dataTypes.js +295 -113
  65. package/lib/util/defaults.js +12 -7
  66. package/lib/util/escapeClassName.js +13 -8
  67. package/lib/util/escapeCommas.js +7 -2
  68. package/lib/util/flattenColorPalette.js +11 -12
  69. package/lib/util/formatVariantSelector.js +235 -151
  70. package/lib/util/getAllConfigs.js +33 -12
  71. package/lib/util/hashConfig.js +9 -4
  72. package/lib/util/isKeyframeRule.js +7 -2
  73. package/lib/util/isPlainObject.js +8 -3
  74. package/lib/util/{isValidArbitraryValue.js → isSyntacticallyValidPropertyValue.js} +25 -15
  75. package/lib/util/log.js +25 -15
  76. package/lib/util/nameClass.js +27 -10
  77. package/lib/util/negateValue.js +25 -8
  78. package/lib/util/normalizeConfig.js +127 -82
  79. package/lib/util/normalizeScreens.js +128 -11
  80. package/lib/util/parseAnimationValue.js +44 -40
  81. package/lib/util/parseBoxShadowValue.js +34 -23
  82. package/lib/util/parseDependency.js +39 -55
  83. package/lib/util/parseGlob.js +36 -0
  84. package/lib/util/parseObjectStyles.js +15 -10
  85. package/lib/util/pluginUtils.js +172 -69
  86. package/lib/util/prefixSelector.js +30 -12
  87. package/lib/util/pseudoElements.js +212 -0
  88. package/lib/util/removeAlphaVariables.js +31 -0
  89. package/lib/util/resolveConfig.js +101 -87
  90. package/lib/util/resolveConfigPath.js +30 -12
  91. package/lib/util/responsive.js +11 -6
  92. package/lib/util/splitAtTopLevelOnly.js +51 -0
  93. package/lib/util/tap.js +6 -1
  94. package/lib/util/toColorValue.js +7 -3
  95. package/lib/util/toPath.js +22 -4
  96. package/lib/util/transformThemeValue.js +40 -30
  97. package/lib/util/validateConfig.js +37 -0
  98. package/lib/util/validateFormalSyntax.js +26 -0
  99. package/lib/util/withAlphaVariable.js +27 -15
  100. package/lib/value-parser/LICENSE +22 -0
  101. package/lib/value-parser/README.md +3 -0
  102. package/lib/value-parser/index.d.js +2 -0
  103. package/lib/value-parser/index.js +22 -0
  104. package/lib/value-parser/parse.js +259 -0
  105. package/lib/value-parser/stringify.js +38 -0
  106. package/lib/value-parser/unit.js +86 -0
  107. package/lib/value-parser/walk.js +16 -0
  108. package/loadConfig.d.ts +4 -0
  109. package/loadConfig.js +2 -0
  110. package/nesting/index.d.ts +4 -0
  111. package/nesting/index.js +2 -12
  112. package/package.json +60 -55
  113. package/peers/index.js +75503 -55095
  114. package/plugin.d.ts +11 -0
  115. package/resolveConfig.d.ts +31 -0
  116. package/scripts/generate-types.js +104 -0
  117. package/scripts/release-channel.js +18 -0
  118. package/scripts/release-notes.js +21 -0
  119. package/scripts/type-utils.js +27 -0
  120. package/src/cli/build/deps.js +56 -0
  121. package/src/cli/build/index.js +49 -0
  122. package/src/cli/build/plugin.js +437 -0
  123. package/src/cli/build/utils.js +76 -0
  124. package/src/cli/build/watching.js +229 -0
  125. package/src/cli/help/index.js +70 -0
  126. package/src/cli/index.js +216 -0
  127. package/src/cli/init/index.js +79 -0
  128. package/src/cli-peer-dependencies.js +7 -1
  129. package/src/cli.js +1 -811
  130. package/src/corePluginList.js +1 -1
  131. package/src/corePlugins.js +849 -243
  132. package/src/css/preflight.css +32 -13
  133. package/src/featureFlags.js +13 -9
  134. package/src/index.js +1 -28
  135. package/src/lib/cacheInvalidation.js +52 -0
  136. package/src/lib/collapseAdjacentRules.js +21 -2
  137. package/src/lib/content.js +249 -0
  138. package/src/lib/defaultExtractor.js +215 -33
  139. package/src/lib/evaluateTailwindFunctions.js +82 -8
  140. package/src/lib/expandApplyAtRules.js +512 -224
  141. package/src/lib/expandTailwindAtRules.js +102 -87
  142. package/src/lib/findAtConfigPath.js +48 -0
  143. package/src/lib/generateRules.js +541 -146
  144. package/src/lib/getModuleDependencies.js +70 -30
  145. package/src/lib/load-config.ts +44 -0
  146. package/src/lib/normalizeTailwindDirectives.js +1 -0
  147. package/src/lib/offsets.js +432 -0
  148. package/src/lib/partitionApplyAtRules.js +52 -0
  149. package/src/lib/regex.js +74 -0
  150. package/src/lib/remap-bitfield.js +82 -0
  151. package/src/lib/resolveDefaultsAtRules.js +55 -30
  152. package/src/lib/setupContextUtils.js +720 -190
  153. package/src/lib/setupTrackingContext.js +47 -61
  154. package/src/lib/sharedState.js +15 -4
  155. package/src/plugin.js +47 -0
  156. package/src/postcss-plugins/nesting/README.md +42 -0
  157. package/src/postcss-plugins/nesting/index.js +13 -0
  158. package/src/postcss-plugins/nesting/plugin.js +80 -0
  159. package/src/processTailwindFeatures.js +11 -4
  160. package/src/public/colors.js +22 -0
  161. package/src/public/default-config.js +1 -1
  162. package/src/public/default-theme.js +2 -2
  163. package/src/public/load-config.js +2 -0
  164. package/src/util/applyImportantSelector.js +27 -0
  165. package/src/util/buildMediaQuery.js +5 -3
  166. package/src/util/cloneNodes.js +40 -2
  167. package/src/util/color.js +39 -20
  168. package/src/util/colorNames.js +150 -0
  169. package/src/util/dataTypes.js +184 -26
  170. package/src/util/formatVariantSelector.js +272 -144
  171. package/src/util/getAllConfigs.js +21 -2
  172. package/src/util/isPlainObject.js +1 -1
  173. package/src/util/{isValidArbitraryValue.js → isSyntacticallyValidPropertyValue.js} +1 -1
  174. package/src/util/log.js +8 -8
  175. package/src/util/nameClass.js +4 -0
  176. package/src/util/negateValue.js +11 -3
  177. package/src/util/normalizeConfig.js +45 -6
  178. package/src/util/normalizeScreens.js +99 -4
  179. package/src/util/parseBoxShadowValue.js +4 -3
  180. package/src/util/parseDependency.js +37 -42
  181. package/src/util/parseGlob.js +24 -0
  182. package/src/util/pluginUtils.js +139 -24
  183. package/src/util/prefixSelector.js +31 -10
  184. package/src/util/pseudoElements.js +171 -0
  185. package/src/util/removeAlphaVariables.js +24 -0
  186. package/src/util/resolveConfig.js +70 -32
  187. package/src/util/resolveConfigPath.js +12 -1
  188. package/src/util/splitAtTopLevelOnly.js +52 -0
  189. package/src/util/toPath.js +1 -1
  190. package/src/util/transformThemeValue.js +13 -3
  191. package/src/util/validateConfig.js +26 -0
  192. package/src/util/validateFormalSyntax.js +34 -0
  193. package/src/util/withAlphaVariable.js +1 -1
  194. package/src/value-parser/LICENSE +22 -0
  195. package/src/value-parser/README.md +3 -0
  196. package/src/value-parser/index.d.ts +177 -0
  197. package/src/value-parser/index.js +28 -0
  198. package/src/value-parser/parse.js +303 -0
  199. package/src/value-parser/stringify.js +41 -0
  200. package/src/value-parser/unit.js +118 -0
  201. package/src/value-parser/walk.js +18 -0
  202. package/stubs/.gitignore +1 -0
  203. package/stubs/.prettierrc.json +6 -0
  204. package/stubs/{defaultConfig.stub.js → config.full.js} +290 -178
  205. package/stubs/postcss.config.js +6 -0
  206. package/stubs/tailwind.config.cjs +2 -0
  207. package/stubs/tailwind.config.js +2 -0
  208. package/stubs/tailwind.config.ts +3 -0
  209. package/types/config.d.ts +376 -0
  210. package/types/generated/.gitkeep +0 -0
  211. package/types/generated/colors.d.ts +298 -0
  212. package/types/generated/corePluginList.d.ts +1 -0
  213. package/types/generated/default-theme.d.ts +397 -0
  214. package/types/index.d.ts +11 -0
  215. package/CHANGELOG.md +0 -1959
  216. package/lib/constants.js +0 -37
  217. package/lib/lib/detectNesting.js +0 -34
  218. package/nesting/plugin.js +0 -41
  219. package/scripts/install-integrations.js +0 -27
  220. package/scripts/rebuildFixtures.js +0 -68
  221. package/src/constants.js +0 -17
  222. package/src/lib/detectNesting.js +0 -39
  223. /package/stubs/{simpleConfig.stub.js → config.simple.js} +0 -0
  224. /package/stubs/{defaultPostCssConfig.stub.js → postcss.config.cjs} +0 -0
@@ -2,22 +2,46 @@ import postcss from 'postcss'
2
2
  import parser from 'postcss-selector-parser'
3
3
 
4
4
  import { resolveMatches } from './generateRules'
5
- import bigSign from '../util/bigSign'
6
5
  import escapeClassName from '../util/escapeClassName'
6
+ import { applyImportantSelector } from '../util/applyImportantSelector'
7
+ import { movePseudos } from '../util/pseudoElements'
8
+
9
+ /** @typedef {Map<string, [any, import('postcss').Rule[]]>} ApplyCache */
7
10
 
8
11
  function extractClasses(node) {
9
- let classes = new Set()
12
+ /** @type {Map<string, Set<string>>} */
13
+ let groups = new Map()
14
+
10
15
  let container = postcss.root({ nodes: [node.clone()] })
11
16
 
12
17
  container.walkRules((rule) => {
13
18
  parser((selectors) => {
14
19
  selectors.walkClasses((classSelector) => {
20
+ let parentSelector = classSelector.parent.toString()
21
+
22
+ let classes = groups.get(parentSelector)
23
+ if (!classes) {
24
+ groups.set(parentSelector, (classes = new Set()))
25
+ }
26
+
15
27
  classes.add(classSelector.value)
16
28
  })
17
29
  }).processSync(rule.selector)
18
30
  })
19
31
 
20
- return Array.from(classes)
32
+ let normalizedGroups = Array.from(groups.values(), (classes) => Array.from(classes))
33
+ let classes = normalizedGroups.flat()
34
+
35
+ return Object.assign(classes, { groups: normalizedGroups })
36
+ }
37
+
38
+ let selectorExtractor = parser()
39
+
40
+ /**
41
+ * @param {string} ruleSelectors
42
+ */
43
+ function extractSelectors(ruleSelectors) {
44
+ return selectorExtractor.astSync(ruleSelectors)
21
45
  }
22
46
 
23
47
  function extractBaseCandidates(candidates, separator) {
@@ -35,6 +59,130 @@ function prefix(context, selector) {
35
59
  return typeof prefix === 'function' ? prefix(selector) : prefix + selector
36
60
  }
37
61
 
62
+ function* pathToRoot(node) {
63
+ yield node
64
+ while (node.parent) {
65
+ yield node.parent
66
+ node = node.parent
67
+ }
68
+ }
69
+
70
+ /**
71
+ * Only clone the node itself and not its children
72
+ *
73
+ * @param {*} node
74
+ * @param {*} overrides
75
+ * @returns
76
+ */
77
+ function shallowClone(node, overrides = {}) {
78
+ let children = node.nodes
79
+ node.nodes = []
80
+
81
+ let tmp = node.clone(overrides)
82
+
83
+ node.nodes = children
84
+
85
+ return tmp
86
+ }
87
+
88
+ /**
89
+ * Clone just the nodes all the way to the top that are required to represent
90
+ * this singular rule in the tree.
91
+ *
92
+ * For example, if we have CSS like this:
93
+ * ```css
94
+ * @media (min-width: 768px) {
95
+ * @supports (display: grid) {
96
+ * .foo {
97
+ * display: grid;
98
+ * grid-template-columns: repeat(auto-fit, minmax(200px, 1fr));
99
+ * }
100
+ * }
101
+ *
102
+ * @supports (backdrop-filter: blur(1px)) {
103
+ * .bar {
104
+ * backdrop-filter: blur(1px);
105
+ * }
106
+ * }
107
+ *
108
+ * .baz {
109
+ * color: orange;
110
+ * }
111
+ * }
112
+ * ```
113
+ *
114
+ * And we're cloning `.bar` it'll return a cloned version of what's required for just that single node:
115
+ *
116
+ * ```css
117
+ * @media (min-width: 768px) {
118
+ * @supports (backdrop-filter: blur(1px)) {
119
+ * .bar {
120
+ * backdrop-filter: blur(1px);
121
+ * }
122
+ * }
123
+ * }
124
+ * ```
125
+ *
126
+ * @param {import('postcss').Node} node
127
+ */
128
+ function nestedClone(node) {
129
+ for (let parent of pathToRoot(node)) {
130
+ if (node === parent) {
131
+ continue
132
+ }
133
+
134
+ if (parent.type === 'root') {
135
+ break
136
+ }
137
+
138
+ node = shallowClone(parent, {
139
+ nodes: [node],
140
+ })
141
+ }
142
+
143
+ return node
144
+ }
145
+
146
+ /**
147
+ * @param {import('postcss').Root} root
148
+ */
149
+ function buildLocalApplyCache(root, context) {
150
+ /** @type {ApplyCache} */
151
+ let cache = new Map()
152
+
153
+ root.walkRules((rule) => {
154
+ // Ignore rules generated by Tailwind
155
+ for (let node of pathToRoot(rule)) {
156
+ if (node.raws.tailwind?.layer !== undefined) {
157
+ return
158
+ }
159
+ }
160
+
161
+ // Clone what's required to represent this singular rule in the tree
162
+ let container = nestedClone(rule)
163
+ let sort = context.offsets.create('user')
164
+
165
+ for (let className of extractClasses(rule)) {
166
+ let list = cache.get(className) || []
167
+ cache.set(className, list)
168
+
169
+ list.push([
170
+ {
171
+ layer: 'user',
172
+ sort,
173
+ important: false,
174
+ },
175
+ container,
176
+ ])
177
+ }
178
+ })
179
+
180
+ return cache
181
+ }
182
+
183
+ /**
184
+ * @returns {ApplyCache}
185
+ */
38
186
  function buildApplyCache(applyCandidates, context) {
39
187
  for (let candidate of applyCandidates) {
40
188
  if (context.notClassCache.has(candidate) || context.applyClassCache.has(candidate)) {
@@ -62,6 +210,43 @@ function buildApplyCache(applyCandidates, context) {
62
210
  return context.applyClassCache
63
211
  }
64
212
 
213
+ /**
214
+ * Build a cache only when it's first used
215
+ *
216
+ * @param {() => ApplyCache} buildCacheFn
217
+ * @returns {ApplyCache}
218
+ */
219
+ function lazyCache(buildCacheFn) {
220
+ let cache = null
221
+
222
+ return {
223
+ get: (name) => {
224
+ cache = cache || buildCacheFn()
225
+
226
+ return cache.get(name)
227
+ },
228
+ has: (name) => {
229
+ cache = cache || buildCacheFn()
230
+
231
+ return cache.has(name)
232
+ },
233
+ }
234
+ }
235
+
236
+ /**
237
+ * Take a series of multiple caches and merge
238
+ * them so they act like one large cache
239
+ *
240
+ * @param {ApplyCache[]} caches
241
+ * @returns {ApplyCache}
242
+ */
243
+ function combineCaches(caches) {
244
+ return {
245
+ get: (name) => caches.flatMap((cache) => cache.get(name) || []),
246
+ has: (name) => caches.some((cache) => cache.has(name)),
247
+ }
248
+ }
249
+
65
250
  function extractApplyCandidates(params) {
66
251
  let candidates = params.split(/[\s\t\n]+/g)
67
252
 
@@ -72,48 +257,7 @@ function extractApplyCandidates(params) {
72
257
  return [candidates, false]
73
258
  }
74
259
 
75
- function partitionApplyParents(root) {
76
- let applyParents = new Set()
77
-
78
- root.walkAtRules('apply', (rule) => {
79
- applyParents.add(rule.parent)
80
- })
81
-
82
- for (let rule of applyParents) {
83
- let nodeGroups = []
84
- let lastGroup = []
85
-
86
- for (let node of rule.nodes) {
87
- if (node.type === 'atrule' && node.name === 'apply') {
88
- if (lastGroup.length > 0) {
89
- nodeGroups.push(lastGroup)
90
- lastGroup = []
91
- }
92
- nodeGroups.push([node])
93
- } else {
94
- lastGroup.push(node)
95
- }
96
- }
97
-
98
- if (lastGroup.length > 0) {
99
- nodeGroups.push(lastGroup)
100
- }
101
-
102
- if (nodeGroups.length === 1) {
103
- continue
104
- }
105
-
106
- for (let group of [...nodeGroups].reverse()) {
107
- let newParent = rule.clone({ nodes: [] })
108
- newParent.append(group)
109
- rule.after(newParent)
110
- }
111
-
112
- rule.remove()
113
- }
114
- }
115
-
116
- function processApply(root, context) {
260
+ function processApply(root, context, localCache) {
117
261
  let applyCandidates = new Set()
118
262
 
119
263
  // Collect all @apply rules and candidates
@@ -129,221 +273,365 @@ function processApply(root, context) {
129
273
  })
130
274
 
131
275
  // Start the @apply process if we have rules with @apply in them
132
- if (applies.length > 0) {
133
- // Fill up some caches!
134
- let applyClassCache = buildApplyCache(applyCandidates, context)
135
-
136
- /**
137
- * When we have an apply like this:
138
- *
139
- * .abc {
140
- * @apply hover:font-bold;
141
- * }
142
- *
143
- * What we essentially will do is resolve to this:
144
- *
145
- * .abc {
146
- * @apply .hover\:font-bold:hover {
147
- * font-weight: 500;
148
- * }
149
- * }
150
- *
151
- * Notice that the to-be-applied class is `.hover\:font-bold:hover` and that the utility candidate was `hover:font-bold`.
152
- * What happens in this function is that we prepend a `.` and escape the candidate.
153
- * This will result in `.hover\:font-bold`
154
- * Which means that we can replace `.hover\:font-bold` with `.abc` in `.hover\:font-bold:hover` resulting in `.abc:hover`
155
- */
156
- // TODO: Should we use postcss-selector-parser for this instead?
157
- function replaceSelector(selector, utilitySelectors, candidate) {
158
- let needle = `.${escapeClassName(candidate)}`
159
- let utilitySelectorsList = utilitySelectors.split(/\s*\,(?![^(]*\))\s*/g)
160
-
161
- return selector
162
- .split(/\s*\,(?![^(]*\))\s*/g)
163
- .map((s) => {
164
- let replaced = []
165
-
166
- for (let utilitySelector of utilitySelectorsList) {
167
- let replacedSelector = utilitySelector.replace(needle, s)
168
- if (replacedSelector === utilitySelector) {
169
- continue
170
- }
171
- replaced.push(replacedSelector)
276
+ if (applies.length === 0) {
277
+ return
278
+ }
279
+
280
+ // Fill up some caches!
281
+ let applyClassCache = combineCaches([localCache, buildApplyCache(applyCandidates, context)])
282
+
283
+ /**
284
+ * When we have an apply like this:
285
+ *
286
+ * .abc {
287
+ * @apply hover:font-bold;
288
+ * }
289
+ *
290
+ * What we essentially will do is resolve to this:
291
+ *
292
+ * .abc {
293
+ * @apply .hover\:font-bold:hover {
294
+ * font-weight: 500;
295
+ * }
296
+ * }
297
+ *
298
+ * Notice that the to-be-applied class is `.hover\:font-bold:hover` and that the utility candidate was `hover:font-bold`.
299
+ * What happens in this function is that we prepend a `.` and escape the candidate.
300
+ * This will result in `.hover\:font-bold`
301
+ * Which means that we can replace `.hover\:font-bold` with `.abc` in `.hover\:font-bold:hover` resulting in `.abc:hover`
302
+ *
303
+ * @param {string} selector
304
+ * @param {string} utilitySelectors
305
+ * @param {string} candidate
306
+ */
307
+ function replaceSelector(selector, utilitySelectors, candidate) {
308
+ let selectorList = extractSelectors(selector)
309
+ let utilitySelectorsList = extractSelectors(utilitySelectors)
310
+ let candidateList = extractSelectors(`.${escapeClassName(candidate)}`)
311
+ let candidateClass = candidateList.nodes[0].nodes[0]
312
+
313
+ selectorList.each((sel) => {
314
+ /** @type {Set<import('postcss-selector-parser').Selector>} */
315
+ let replaced = new Set()
316
+
317
+ utilitySelectorsList.each((utilitySelector) => {
318
+ let hasReplaced = false
319
+ utilitySelector = utilitySelector.clone()
320
+
321
+ utilitySelector.walkClasses((node) => {
322
+ if (node.value !== candidateClass.value) {
323
+ return
324
+ }
325
+
326
+ // Don't replace multiple instances of the same class
327
+ // This is theoretically correct but only partially
328
+ // We'd need to generate every possible permutation of the replacement
329
+ // For example with `.foo + .foo { … }` and `section { @apply foo; }`
330
+ // We'd need to generate all of these:
331
+ // - `.foo + .foo`
332
+ // - `.foo + section`
333
+ // - `section + .foo`
334
+ // - `section + section`
335
+ if (hasReplaced) {
336
+ return
172
337
  }
173
- return replaced.join(', ')
174
- })
175
- .join(', ')
176
- }
177
338
 
178
- let perParentApplies = new Map()
339
+ // Since you can only `@apply` class names this is sufficient
340
+ // We want to replace the matched class name with the selector the user is using
341
+ // Ex: Replace `.text-blue-500` with `.foo.bar:is(.something-cool)`
342
+ node.replaceWith(...sel.nodes.map((node) => node.clone()))
179
343
 
180
- // Collect all apply candidates and their rules
181
- for (let apply of applies) {
182
- let candidates = perParentApplies.get(apply.parent) || []
344
+ // Record that we did something and we want to use this new selector
345
+ replaced.add(utilitySelector)
183
346
 
184
- perParentApplies.set(apply.parent, candidates)
347
+ hasReplaced = true
348
+ })
349
+ })
185
350
 
186
- let [applyCandidates, important] = extractApplyCandidates(apply.params)
351
+ // Sort tag names before class names (but only sort each group (separated by a combinator)
352
+ // separately and not in total)
353
+ // This happens when replacing `.bar` in `.foo.bar` with a tag like `section`
354
+ for (let sel of replaced) {
355
+ let groups = [[]]
356
+ for (let node of sel.nodes) {
357
+ if (node.type === 'combinator') {
358
+ groups.push(node)
359
+ groups.push([])
360
+ } else {
361
+ let last = groups[groups.length - 1]
362
+ last.push(node)
363
+ }
364
+ }
187
365
 
188
- if (apply.parent.type === 'atrule') {
189
- if (apply.parent.name === 'screen') {
190
- const screenType = apply.parent.params
366
+ sel.nodes = []
367
+
368
+ for (let group of groups) {
369
+ if (Array.isArray(group)) {
370
+ group.sort((a, b) => {
371
+ if (a.type === 'tag' && b.type === 'class') {
372
+ return -1
373
+ } else if (a.type === 'class' && b.type === 'tag') {
374
+ return 1
375
+ } else if (a.type === 'class' && b.type === 'pseudo' && b.value.startsWith('::')) {
376
+ return -1
377
+ } else if (a.type === 'pseudo' && a.value.startsWith('::') && b.type === 'class') {
378
+ return 1
379
+ }
191
380
 
192
- throw apply.error(
193
- `@apply is not supported within nested at-rules like @screen. We suggest you write this as @apply ${applyCandidates
194
- .map((c) => `${screenType}:${c}`)
195
- .join(' ')} instead.`
196
- )
381
+ return 0
382
+ })
383
+ }
384
+
385
+ sel.nodes = sel.nodes.concat(group)
197
386
  }
387
+ }
388
+
389
+ sel.replaceWith(...replaced)
390
+ })
391
+
392
+ return selectorList.toString()
393
+ }
394
+
395
+ let perParentApplies = new Map()
396
+
397
+ // Collect all apply candidates and their rules
398
+ for (let apply of applies) {
399
+ let [candidates] = perParentApplies.get(apply.parent) || [[], apply.source]
400
+
401
+ perParentApplies.set(apply.parent, [candidates, apply.source])
402
+
403
+ let [applyCandidates, important] = extractApplyCandidates(apply.params)
404
+
405
+ if (apply.parent.type === 'atrule') {
406
+ if (apply.parent.name === 'screen') {
407
+ let screenType = apply.parent.params
198
408
 
199
409
  throw apply.error(
200
- `@apply is not supported within nested at-rules like @${apply.parent.name}. You can fix this by un-nesting @${apply.parent.name}.`
410
+ `@apply is not supported within nested at-rules like @screen. We suggest you write this as @apply ${applyCandidates
411
+ .map((c) => `${screenType}:${c}`)
412
+ .join(' ')} instead.`
201
413
  )
202
414
  }
203
415
 
204
- for (let applyCandidate of applyCandidates) {
205
- if (!applyClassCache.has(applyCandidate)) {
206
- if (applyCandidate === prefix(context, 'group')) {
207
- // TODO: Link to specific documentation page with error code.
208
- throw apply.error(`@apply should not be used with the '${applyCandidate}' utility`)
209
- }
416
+ throw apply.error(
417
+ `@apply is not supported within nested at-rules like @${apply.parent.name}. You can fix this by un-nesting @${apply.parent.name}.`
418
+ )
419
+ }
210
420
 
211
- throw apply.error(
212
- `The \`${applyCandidate}\` class does not exist. If \`${applyCandidate}\` is a custom class, make sure it is defined within a \`@layer\` directive.`
213
- )
214
- }
421
+ for (let applyCandidate of applyCandidates) {
422
+ if ([prefix(context, 'group'), prefix(context, 'peer')].includes(applyCandidate)) {
423
+ // TODO: Link to specific documentation page with error code.
424
+ throw apply.error(`@apply should not be used with the '${applyCandidate}' utility`)
425
+ }
426
+
427
+ if (!applyClassCache.has(applyCandidate)) {
428
+ throw apply.error(
429
+ `The \`${applyCandidate}\` class does not exist. If \`${applyCandidate}\` is a custom class, make sure it is defined within a \`@layer\` directive.`
430
+ )
431
+ }
215
432
 
216
- let rules = applyClassCache.get(applyCandidate)
433
+ let rules = applyClassCache.get(applyCandidate)
434
+
435
+ // Verify that we can apply the class
436
+ for (let [, rule] of rules) {
437
+ if (rule.type === 'atrule') {
438
+ continue
439
+ }
217
440
 
218
- candidates.push([applyCandidate, important, rules])
441
+ rule.walkRules(() => {
442
+ throw apply.error(
443
+ [
444
+ `The \`${applyCandidate}\` class cannot be used with \`@apply\` because \`@apply\` does not currently support nested CSS.`,
445
+ 'Rewrite the selector without nesting or configure the `tailwindcss/nesting` plugin:',
446
+ 'https://tailwindcss.com/docs/using-with-preprocessors#nesting',
447
+ ].join('\n')
448
+ )
449
+ })
219
450
  }
451
+
452
+ candidates.push([applyCandidate, important, rules])
220
453
  }
454
+ }
455
+
456
+ for (let [parent, [candidates, atApplySource]] of perParentApplies) {
457
+ let siblings = []
458
+
459
+ for (let [applyCandidate, important, rules] of candidates) {
460
+ let potentialApplyCandidates = [
461
+ applyCandidate,
462
+ ...extractBaseCandidates([applyCandidate], context.tailwindConfig.separator),
463
+ ]
464
+
465
+ for (let [meta, node] of rules) {
466
+ let parentClasses = extractClasses(parent)
467
+ let nodeClasses = extractClasses(node)
221
468
 
222
- for (const [parent, candidates] of perParentApplies) {
223
- let siblings = []
224
-
225
- for (let [applyCandidate, important, rules] of candidates) {
226
- for (let [meta, node] of rules) {
227
- let parentClasses = extractClasses(parent)
228
- let nodeClasses = extractClasses(node)
229
-
230
- // Add base utility classes from the @apply node to the list of
231
- // classes to check whether it intersects and therefore results in a
232
- // circular dependency or not.
233
- //
234
- // E.g.:
235
- // .foo {
236
- // @apply hover:a; // This applies "a" but with a modifier
237
- // }
238
- //
239
- // We only have to do that with base classes of the `node`, not of the `parent`
240
- // E.g.:
241
- // .hover\:foo {
242
- // @apply bar;
243
- // }
244
- // .bar {
245
- // @apply foo;
246
- // }
247
- //
248
- // This should not result in a circular dependency because we are
249
- // just applying `.foo` and the rule above is `.hover\:foo` which is
250
- // unrelated. However, if we were to apply `hover:foo` then we _did_
251
- // have to include this one.
252
- nodeClasses = nodeClasses.concat(
253
- extractBaseCandidates(nodeClasses, context.tailwindConfig.separator)
469
+ // When we encounter a rule like `.dark .a, .b { … }` we only want to be left with `[.dark, .a]` if the base applyCandidate is `.a` or with `[.b]` if the base applyCandidate is `.b`
470
+ // So we've split them into groups
471
+ nodeClasses = nodeClasses.groups
472
+ .filter((classList) =>
473
+ classList.some((className) => potentialApplyCandidates.includes(className))
254
474
  )
475
+ .flat()
476
+
477
+ // Add base utility classes from the @apply node to the list of
478
+ // classes to check whether it intersects and therefore results in a
479
+ // circular dependency or not.
480
+ //
481
+ // E.g.:
482
+ // .foo {
483
+ // @apply hover:a; // This applies "a" but with a modifier
484
+ // }
485
+ //
486
+ // We only have to do that with base classes of the `node`, not of the `parent`
487
+ // E.g.:
488
+ // .hover\:foo {
489
+ // @apply bar;
490
+ // }
491
+ // .bar {
492
+ // @apply foo;
493
+ // }
494
+ //
495
+ // This should not result in a circular dependency because we are
496
+ // just applying `.foo` and the rule above is `.hover\:foo` which is
497
+ // unrelated. However, if we were to apply `hover:foo` then we _did_
498
+ // have to include this one.
499
+ nodeClasses = nodeClasses.concat(
500
+ extractBaseCandidates(nodeClasses, context.tailwindConfig.separator)
501
+ )
255
502
 
256
- let intersects = parentClasses.some((selector) => nodeClasses.includes(selector))
257
- if (intersects) {
258
- throw node.error(
259
- `You cannot \`@apply\` the \`${applyCandidate}\` utility here because it creates a circular dependency.`
260
- )
261
- }
503
+ let intersects = parentClasses.some((selector) => nodeClasses.includes(selector))
504
+ if (intersects) {
505
+ throw node.error(
506
+ `You cannot \`@apply\` the \`${applyCandidate}\` utility here because it creates a circular dependency.`
507
+ )
508
+ }
262
509
 
263
- let root = postcss.root({ nodes: [node.clone()] })
264
- let canRewriteSelector =
265
- node.type !== 'atrule' || (node.type === 'atrule' && node.name !== 'keyframes')
266
-
267
- if (canRewriteSelector) {
268
- root.walkRules((rule) => {
269
- // Let's imagine you have the following structure:
270
- //
271
- // .foo {
272
- // @apply bar;
273
- // }
274
- //
275
- // @supports (a: b) {
276
- // .bar {
277
- // color: blue
278
- // }
279
- //
280
- // .something-unrelated {}
281
- // }
282
- //
283
- // In this case we want to apply `.bar` but it happens to be in
284
- // an atrule node. We clone that node instead of the nested one
285
- // because we still want that @supports rule to be there once we
286
- // applied everything.
287
- //
288
- // However it happens to be that the `.something-unrelated` is
289
- // also in that same shared @supports atrule. This is not good,
290
- // and this should not be there. The good part is that this is
291
- // a clone already and it can be safely removed. The question is
292
- // how do we know we can remove it. Basically what we can do is
293
- // match it against the applyCandidate that you want to apply. If
294
- // it doesn't match the we can safely delete it.
295
- //
296
- // If we didn't do this, then the `replaceSelector` function
297
- // would have replaced this with something that didn't exist and
298
- // therefore it removed the selector altogether. In this specific
299
- // case it would result in `{}` instead of `.something-unrelated {}`
300
- if (!extractClasses(rule).some((candidate) => candidate === applyCandidate)) {
301
- rule.remove()
302
- return
303
- }
510
+ let root = postcss.root({ nodes: [node.clone()] })
511
+
512
+ // Make sure every node in the entire tree points back at the @apply rule that generated it
513
+ root.walk((node) => {
514
+ node.source = atApplySource
515
+ })
516
+
517
+ let canRewriteSelector =
518
+ node.type !== 'atrule' || (node.type === 'atrule' && node.name !== 'keyframes')
519
+
520
+ if (canRewriteSelector) {
521
+ root.walkRules((rule) => {
522
+ // Let's imagine you have the following structure:
523
+ //
524
+ // .foo {
525
+ // @apply bar;
526
+ // }
527
+ //
528
+ // @supports (a: b) {
529
+ // .bar {
530
+ // color: blue
531
+ // }
532
+ //
533
+ // .something-unrelated {}
534
+ // }
535
+ //
536
+ // In this case we want to apply `.bar` but it happens to be in
537
+ // an atrule node. We clone that node instead of the nested one
538
+ // because we still want that @supports rule to be there once we
539
+ // applied everything.
540
+ //
541
+ // However it happens to be that the `.something-unrelated` is
542
+ // also in that same shared @supports atrule. This is not good,
543
+ // and this should not be there. The good part is that this is
544
+ // a clone already and it can be safely removed. The question is
545
+ // how do we know we can remove it. Basically what we can do is
546
+ // match it against the applyCandidate that you want to apply. If
547
+ // it doesn't match the we can safely delete it.
548
+ //
549
+ // If we didn't do this, then the `replaceSelector` function
550
+ // would have replaced this with something that didn't exist and
551
+ // therefore it removed the selector altogether. In this specific
552
+ // case it would result in `{}` instead of `.something-unrelated {}`
553
+ if (!extractClasses(rule).some((candidate) => candidate === applyCandidate)) {
554
+ rule.remove()
555
+ return
556
+ }
557
+
558
+ // Strip the important selector from the parent selector if at the beginning
559
+ let importantSelector =
560
+ typeof context.tailwindConfig.important === 'string'
561
+ ? context.tailwindConfig.important
562
+ : null
563
+
564
+ // We only want to move the "important" selector if this is a Tailwind-generated utility
565
+ // We do *not* want to do this for user CSS that happens to be structured the same
566
+ let isGenerated = parent.raws.tailwind !== undefined
567
+
568
+ let parentSelector =
569
+ isGenerated && importantSelector && parent.selector.indexOf(importantSelector) === 0
570
+ ? parent.selector.slice(importantSelector.length)
571
+ : parent.selector
572
+
573
+ // If the selector becomes empty after replacing the important selector
574
+ // This means that it's the same as the parent selector and we don't want to replace it
575
+ // Otherwise we'll crash
576
+ if (parentSelector === '') {
577
+ parentSelector = parent.selector
578
+ }
579
+
580
+ rule.selector = replaceSelector(parentSelector, rule.selector, applyCandidate)
304
581
 
305
- rule.selector = replaceSelector(parent.selector, rule.selector, applyCandidate)
582
+ // And then re-add it if it was removed
583
+ if (importantSelector && parentSelector !== parent.selector) {
584
+ rule.selector = applyImportantSelector(rule.selector, importantSelector)
585
+ }
306
586
 
307
- rule.walkDecls((d) => {
308
- d.important = meta.important || important
309
- })
587
+ rule.walkDecls((d) => {
588
+ d.important = meta.important || important
310
589
  })
311
- }
312
590
 
313
- // Insert it
314
- siblings.push([
315
- // Ensure that when we are sorting, that we take the layer order into account
316
- { ...meta, sort: meta.sort | context.layerOrder[meta.layer] },
317
- root.nodes[0],
318
- ])
591
+ // Move pseudo elements to the end of the selector (if necessary)
592
+ let selector = parser().astSync(rule.selector)
593
+ selector.each((sel) => movePseudos(sel))
594
+ rule.selector = selector.toString()
595
+ })
319
596
  }
320
- }
321
-
322
- // Inject the rules, sorted, correctly
323
- let nodes = siblings.sort(([a], [z]) => bigSign(a.sort - z.sort)).map((s) => s[1])
324
597
 
325
- // `parent` refers to the node at `.abc` in: .abc { @apply mt-2 }
326
- parent.after(nodes)
327
- }
598
+ // It could be that the node we were inserted was removed because the class didn't match
599
+ // If that was the *only* rule in the parent, then we have nothing add so we skip it
600
+ if (!root.nodes[0]) {
601
+ continue
602
+ }
328
603
 
329
- for (let apply of applies) {
330
- // If there are left-over declarations, just remove the @apply
331
- if (apply.parent.nodes.length > 1) {
332
- apply.remove()
333
- } else {
334
- // The node is empty, drop the full node
335
- apply.parent.remove()
604
+ // Insert it
605
+ siblings.push([meta.sort, root.nodes[0]])
336
606
  }
337
607
  }
338
608
 
339
- // Do it again, in case we have other `@apply` rules
340
- processApply(root, context)
609
+ // Inject the rules, sorted, correctly
610
+ let nodes = context.offsets.sort(siblings).map((s) => s[1])
611
+
612
+ // `parent` refers to the node at `.abc` in: .abc { @apply mt-2 }
613
+ parent.after(nodes)
614
+ }
615
+
616
+ for (let apply of applies) {
617
+ // If there are left-over declarations, just remove the @apply
618
+ if (apply.parent.nodes.length > 1) {
619
+ apply.remove()
620
+ } else {
621
+ // The node is empty, drop the full node
622
+ apply.parent.remove()
623
+ }
341
624
  }
625
+
626
+ // Do it again, in case we have other `@apply` rules
627
+ processApply(root, context, localCache)
342
628
  }
343
629
 
344
630
  export default function expandApplyAtRules(context) {
345
631
  return (root) => {
346
- partitionApplyParents(root)
347
- processApply(root, context)
632
+ // Build a cache of the user's CSS so we can use it to resolve classes used by @apply
633
+ let localCache = lazyCache(() => buildLocalApplyCache(root, context))
634
+
635
+ processApply(root, context, localCache)
348
636
  }
349
637
  }