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