tailwindcss 0.0.0-insiders.ea139f2 → 0.0.0-insiders.ea4e1cd

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 (236) hide show
  1. package/LICENSE +1 -2
  2. package/README.md +15 -7
  3. package/colors.d.ts +3 -0
  4. package/colors.js +2 -1
  5. package/defaultConfig.d.ts +3 -0
  6. package/defaultConfig.js +2 -1
  7. package/defaultTheme.d.ts +4 -0
  8. package/defaultTheme.js +2 -1
  9. package/lib/cli/build/deps.js +62 -0
  10. package/lib/cli/build/index.js +54 -0
  11. package/lib/cli/build/plugin.js +378 -0
  12. package/lib/cli/build/utils.js +88 -0
  13. package/lib/cli/build/watching.js +182 -0
  14. package/lib/cli/help/index.js +73 -0
  15. package/lib/cli/index.js +230 -0
  16. package/lib/cli/init/index.js +63 -0
  17. package/lib/cli-peer-dependencies.js +28 -7
  18. package/lib/cli.js +4 -703
  19. package/lib/corePluginList.js +12 -3
  20. package/lib/corePlugins.js +2373 -1863
  21. package/lib/css/preflight.css +10 -8
  22. package/lib/featureFlags.js +49 -26
  23. package/lib/index.js +1 -31
  24. package/lib/lib/cacheInvalidation.js +92 -0
  25. package/lib/lib/collapseAdjacentRules.js +30 -10
  26. package/lib/lib/collapseDuplicateDeclarations.js +60 -4
  27. package/lib/lib/content.js +181 -0
  28. package/lib/lib/defaultExtractor.js +243 -0
  29. package/lib/lib/detectNesting.js +21 -10
  30. package/lib/lib/evaluateTailwindFunctions.js +115 -50
  31. package/lib/lib/expandApplyAtRules.js +467 -161
  32. package/lib/lib/expandTailwindAtRules.js +160 -133
  33. package/lib/lib/findAtConfigPath.js +46 -0
  34. package/lib/lib/generateRules.js +553 -200
  35. package/lib/lib/getModuleDependencies.js +88 -37
  36. package/lib/lib/load-config.js +42 -0
  37. package/lib/lib/normalizeTailwindDirectives.js +46 -33
  38. package/lib/lib/offsets.js +306 -0
  39. package/lib/lib/partitionApplyAtRules.js +58 -0
  40. package/lib/lib/regex.js +74 -0
  41. package/lib/lib/remap-bitfield.js +89 -0
  42. package/lib/lib/resolveDefaultsAtRules.js +98 -58
  43. package/lib/lib/setupContextUtils.js +773 -321
  44. package/lib/lib/setupTrackingContext.js +70 -75
  45. package/lib/lib/sharedState.js +78 -10
  46. package/lib/lib/substituteScreenAtRules.js +14 -10
  47. package/lib/oxide/cli/build/deps.js +89 -0
  48. package/lib/oxide/cli/build/index.js +53 -0
  49. package/lib/oxide/cli/build/plugin.js +375 -0
  50. package/lib/oxide/cli/build/utils.js +87 -0
  51. package/lib/oxide/cli/build/watching.js +179 -0
  52. package/lib/oxide/cli/help/index.js +72 -0
  53. package/lib/oxide/cli/index.js +214 -0
  54. package/lib/oxide/cli/init/index.js +52 -0
  55. package/lib/oxide/cli.js +5 -0
  56. package/lib/oxide/postcss-plugin.js +2 -0
  57. package/lib/plugin.js +98 -0
  58. package/{nesting → lib/postcss-plugins/nesting}/README.md +2 -2
  59. package/lib/postcss-plugins/nesting/index.js +21 -0
  60. package/lib/postcss-plugins/nesting/plugin.js +89 -0
  61. package/lib/processTailwindFeatures.js +39 -26
  62. package/lib/public/colors.js +272 -246
  63. package/lib/public/create-plugin.js +9 -5
  64. package/lib/public/default-config.js +10 -6
  65. package/lib/public/default-theme.js +10 -6
  66. package/lib/public/load-config.js +12 -0
  67. package/lib/public/resolve-config.js +11 -6
  68. package/lib/util/applyImportantSelector.js +36 -0
  69. package/lib/util/bigSign.js +6 -1
  70. package/lib/util/buildMediaQuery.js +13 -6
  71. package/lib/util/cloneDeep.js +9 -6
  72. package/lib/util/cloneNodes.js +23 -3
  73. package/lib/util/color.js +70 -38
  74. package/lib/util/colorNames.js +752 -0
  75. package/lib/util/configurePlugins.js +7 -2
  76. package/lib/util/createPlugin.js +8 -6
  77. package/lib/util/createUtilityPlugin.js +16 -16
  78. package/lib/util/dataTypes.js +173 -108
  79. package/lib/util/defaults.js +14 -3
  80. package/lib/util/escapeClassName.js +13 -8
  81. package/lib/util/escapeCommas.js +7 -2
  82. package/lib/util/flattenColorPalette.js +11 -12
  83. package/lib/util/formatVariantSelector.js +228 -151
  84. package/lib/util/getAllConfigs.js +33 -12
  85. package/lib/util/hashConfig.js +9 -4
  86. package/lib/util/isKeyframeRule.js +7 -2
  87. package/lib/util/isPlainObject.js +7 -2
  88. package/lib/util/{isValidArbitraryValue.js → isSyntacticallyValidPropertyValue.js} +25 -15
  89. package/lib/util/log.js +27 -13
  90. package/lib/util/nameClass.js +27 -10
  91. package/lib/util/negateValue.js +25 -8
  92. package/lib/util/normalizeConfig.js +139 -65
  93. package/lib/util/normalizeScreens.js +131 -11
  94. package/lib/util/parseAnimationValue.js +44 -40
  95. package/lib/util/parseBoxShadowValue.js +34 -23
  96. package/lib/util/parseDependency.js +39 -55
  97. package/lib/util/parseGlob.js +36 -0
  98. package/lib/util/parseObjectStyles.js +15 -10
  99. package/lib/util/pluginUtils.js +159 -69
  100. package/lib/util/prefixSelector.js +30 -12
  101. package/lib/util/pseudoElements.js +229 -0
  102. package/lib/util/removeAlphaVariables.js +31 -0
  103. package/lib/util/resolveConfig.js +97 -75
  104. package/lib/util/resolveConfigPath.js +30 -12
  105. package/lib/util/responsive.js +11 -6
  106. package/lib/util/splitAtTopLevelOnly.js +51 -0
  107. package/lib/util/tap.js +6 -1
  108. package/lib/util/toColorValue.js +7 -3
  109. package/lib/util/toPath.js +26 -3
  110. package/lib/util/transformThemeValue.js +40 -30
  111. package/lib/util/validateConfig.js +37 -0
  112. package/lib/util/validateFormalSyntax.js +26 -0
  113. package/lib/util/withAlphaVariable.js +27 -15
  114. package/loadConfig.d.ts +4 -0
  115. package/loadConfig.js +2 -0
  116. package/nesting/index.js +2 -12
  117. package/package.json +66 -57
  118. package/peers/index.js +75964 -55560
  119. package/plugin.d.ts +11 -0
  120. package/plugin.js +2 -1
  121. package/resolveConfig.d.ts +12 -0
  122. package/resolveConfig.js +2 -1
  123. package/scripts/generate-types.js +105 -0
  124. package/scripts/release-channel.js +18 -0
  125. package/scripts/release-notes.js +21 -0
  126. package/scripts/swap-engines.js +40 -0
  127. package/scripts/type-utils.js +27 -0
  128. package/src/cli/build/deps.js +56 -0
  129. package/src/cli/build/index.js +49 -0
  130. package/src/cli/build/plugin.js +444 -0
  131. package/src/cli/build/utils.js +76 -0
  132. package/src/cli/build/watching.js +229 -0
  133. package/src/cli/help/index.js +70 -0
  134. package/src/cli/index.js +216 -0
  135. package/src/cli/init/index.js +79 -0
  136. package/src/cli-peer-dependencies.js +7 -1
  137. package/src/cli.js +4 -765
  138. package/src/corePluginList.js +1 -1
  139. package/src/corePlugins.js +786 -306
  140. package/src/css/preflight.css +10 -8
  141. package/src/featureFlags.js +21 -5
  142. package/src/index.js +1 -34
  143. package/src/lib/cacheInvalidation.js +52 -0
  144. package/src/lib/collapseAdjacentRules.js +21 -2
  145. package/src/lib/collapseDuplicateDeclarations.js +66 -1
  146. package/src/lib/content.js +208 -0
  147. package/src/lib/defaultExtractor.js +217 -0
  148. package/src/lib/detectNesting.js +9 -1
  149. package/src/lib/evaluateTailwindFunctions.js +79 -8
  150. package/src/lib/expandApplyAtRules.js +515 -153
  151. package/src/lib/expandTailwindAtRules.js +115 -86
  152. package/src/lib/findAtConfigPath.js +48 -0
  153. package/src/lib/generateRules.js +545 -147
  154. package/src/lib/getModuleDependencies.js +70 -30
  155. package/src/lib/load-config.ts +31 -0
  156. package/src/lib/normalizeTailwindDirectives.js +7 -1
  157. package/src/lib/offsets.js +373 -0
  158. package/src/lib/partitionApplyAtRules.js +52 -0
  159. package/src/lib/regex.js +74 -0
  160. package/src/lib/remap-bitfield.js +82 -0
  161. package/src/lib/resolveDefaultsAtRules.js +59 -17
  162. package/src/lib/setupContextUtils.js +701 -175
  163. package/src/lib/setupTrackingContext.js +51 -62
  164. package/src/lib/sharedState.js +58 -7
  165. package/src/oxide/cli/build/deps.ts +91 -0
  166. package/src/oxide/cli/build/index.ts +47 -0
  167. package/src/oxide/cli/build/plugin.ts +442 -0
  168. package/src/oxide/cli/build/utils.ts +74 -0
  169. package/src/oxide/cli/build/watching.ts +225 -0
  170. package/src/oxide/cli/help/index.ts +69 -0
  171. package/src/oxide/cli/index.ts +204 -0
  172. package/src/oxide/cli/init/index.ts +59 -0
  173. package/src/oxide/cli.ts +1 -0
  174. package/src/oxide/postcss-plugin.ts +1 -0
  175. package/src/plugin.js +107 -0
  176. package/src/postcss-plugins/nesting/README.md +42 -0
  177. package/src/postcss-plugins/nesting/index.js +13 -0
  178. package/src/postcss-plugins/nesting/plugin.js +80 -0
  179. package/src/processTailwindFeatures.js +12 -2
  180. package/src/public/colors.js +22 -0
  181. package/src/public/default-config.js +1 -1
  182. package/src/public/default-theme.js +2 -2
  183. package/src/public/load-config.js +2 -0
  184. package/src/util/applyImportantSelector.js +27 -0
  185. package/src/util/buildMediaQuery.js +5 -3
  186. package/src/util/cloneNodes.js +19 -2
  187. package/src/util/color.js +44 -12
  188. package/src/util/colorNames.js +150 -0
  189. package/src/util/dataTypes.js +51 -16
  190. package/src/util/defaults.js +6 -0
  191. package/src/util/formatVariantSelector.js +264 -144
  192. package/src/util/getAllConfigs.js +21 -2
  193. package/src/util/{isValidArbitraryValue.js → isSyntacticallyValidPropertyValue.js} +1 -1
  194. package/src/util/log.js +11 -7
  195. package/src/util/nameClass.js +4 -0
  196. package/src/util/negateValue.js +11 -3
  197. package/src/util/normalizeConfig.js +57 -5
  198. package/src/util/normalizeScreens.js +105 -7
  199. package/src/util/parseBoxShadowValue.js +4 -3
  200. package/src/util/parseDependency.js +37 -42
  201. package/src/util/parseGlob.js +24 -0
  202. package/src/util/pluginUtils.js +123 -24
  203. package/src/util/prefixSelector.js +30 -10
  204. package/src/util/pseudoElements.js +170 -0
  205. package/src/util/removeAlphaVariables.js +24 -0
  206. package/src/util/resolveConfig.js +74 -26
  207. package/src/util/resolveConfigPath.js +12 -1
  208. package/src/util/splitAtTopLevelOnly.js +52 -0
  209. package/src/util/toPath.js +23 -1
  210. package/src/util/transformThemeValue.js +13 -3
  211. package/src/util/validateConfig.js +26 -0
  212. package/src/util/validateFormalSyntax.js +34 -0
  213. package/src/util/withAlphaVariable.js +1 -1
  214. package/stubs/.gitignore +1 -0
  215. package/stubs/.prettierrc.json +6 -0
  216. package/stubs/{defaultConfig.stub.js → config.full.js} +206 -166
  217. package/stubs/postcss.config.js +6 -0
  218. package/stubs/tailwind.config.cjs +2 -0
  219. package/stubs/tailwind.config.js +2 -0
  220. package/stubs/tailwind.config.ts +3 -0
  221. package/types/config.d.ts +368 -0
  222. package/types/generated/.gitkeep +0 -0
  223. package/types/generated/colors.d.ts +298 -0
  224. package/types/generated/corePluginList.d.ts +1 -0
  225. package/types/generated/default-theme.d.ts +371 -0
  226. package/types/index.d.ts +7 -0
  227. package/CHANGELOG.md +0 -1843
  228. package/lib/constants.js +0 -37
  229. package/lib/lib/setupWatchingContext.js +0 -288
  230. package/nesting/plugin.js +0 -41
  231. package/scripts/install-integrations.js +0 -27
  232. package/scripts/rebuildFixtures.js +0 -68
  233. package/src/constants.js +0 -17
  234. package/src/lib/setupWatchingContext.js +0 -311
  235. /package/stubs/{simpleConfig.stub.js → config.simple.js} +0 -0
  236. /package/stubs/{defaultPostCssConfig.stub.js → postcss.config.cjs} +0 -0
@@ -2,21 +2,173 @@
2
2
  Object.defineProperty(exports, "__esModule", {
3
3
  value: true
4
4
  });
5
- exports.default = expandApplyAtRules;
6
- var _postcss = _interopRequireDefault(require("postcss"));
7
- var _generateRules = require("./generateRules");
8
- var _bigSign = _interopRequireDefault(require("../util/bigSign"));
9
- var _escapeClassName = _interopRequireDefault(require("../util/escapeClassName"));
10
- 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) {
11
18
  return obj && obj.__esModule ? obj : {
12
19
  default: obj
13
20
  };
14
21
  }
15
- function prefix1(context, selector) {
22
+ /** @typedef {Map<string, [any, import('postcss').Rule[]]>} ApplyCache */ function extractClasses(node) {
23
+ /** @type {Map<string, Set<string>>} */ let groups = new Map();
24
+ let container = _postcss.default.root({
25
+ nodes: [
26
+ node.clone()
27
+ ]
28
+ });
29
+ container.walkRules((rule)=>{
30
+ (0, _postcssselectorparser.default)((selectors)=>{
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
+ }
37
+ classes.add(classSelector.value);
38
+ });
39
+ }).processSync(rule.selector);
40
+ });
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);
52
+ }
53
+ function extractBaseCandidates(candidates, separator) {
54
+ let baseClasses = new Set();
55
+ for (let candidate of candidates){
56
+ baseClasses.add(candidate.split(separator).pop());
57
+ }
58
+ return Array.from(baseClasses);
59
+ }
60
+ function prefix(context, selector) {
16
61
  let prefix = context.tailwindConfig.prefix;
17
- return typeof prefix === 'function' ? prefix(selector) : prefix + selector;
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
+ }
18
70
  }
19
- function buildApplyCache(applyCandidates, context) {
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;
83
+ }
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) {
20
172
  for (let candidate of applyCandidates){
21
173
  if (context.notClassCache.has(candidate) || context.applyClassCache.has(candidate)) {
22
174
  continue;
@@ -25,11 +177,10 @@ function buildApplyCache(applyCandidates, context) {
25
177
  context.applyClassCache.set(candidate, context.classCache.get(candidate).map(([meta, rule])=>[
26
178
  meta,
27
179
  rule.clone()
28
- ]
29
- ));
180
+ ]));
30
181
  continue;
31
182
  }
32
- let matches = Array.from((0, _generateRules).resolveMatches(candidate, context));
183
+ let matches = Array.from((0, _generateRules.resolveMatches)(candidate, context));
33
184
  if (matches.length === 0) {
34
185
  context.notClassCache.add(candidate);
35
186
  continue;
@@ -38,9 +189,39 @@ function buildApplyCache(applyCandidates, context) {
38
189
  }
39
190
  return context.applyClassCache;
40
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
+ }
41
222
  function extractApplyCandidates(params) {
42
223
  let candidates = params.split(/[\s\t\n]+/g);
43
- if (candidates[candidates.length - 1] === '!important') {
224
+ if (candidates[candidates.length - 1] === "!important") {
44
225
  return [
45
226
  candidates.slice(0, -1),
46
227
  true
@@ -51,50 +232,11 @@ function extractApplyCandidates(params) {
51
232
  false
52
233
  ];
53
234
  }
54
- function partitionApplyParents(root) {
55
- let applyParents = new Set();
56
- root.walkAtRules('apply', (rule)=>{
57
- applyParents.add(rule.parent);
58
- });
59
- for (let rule1 of applyParents){
60
- let nodeGroups = [];
61
- let lastGroup = [];
62
- for (let node of rule1.nodes){
63
- if (node.type === 'atrule' && node.name === 'apply') {
64
- if (lastGroup.length > 0) {
65
- nodeGroups.push(lastGroup);
66
- lastGroup = [];
67
- }
68
- nodeGroups.push([
69
- node
70
- ]);
71
- } else {
72
- lastGroup.push(node);
73
- }
74
- }
75
- if (lastGroup.length > 0) {
76
- nodeGroups.push(lastGroup);
77
- }
78
- if (nodeGroups.length === 1) {
79
- continue;
80
- }
81
- for (let group of [
82
- ...nodeGroups
83
- ].reverse()){
84
- let newParent = rule1.clone({
85
- nodes: []
86
- });
87
- newParent.append(group);
88
- rule1.after(newParent);
89
- }
90
- rule1.remove();
91
- }
92
- }
93
- function processApply(root, context) {
235
+ function processApply(root, context, localCache) {
94
236
  let applyCandidates = new Set();
95
237
  // Collect all @apply rules and candidates
96
238
  let applies = [];
97
- root.walkAtRules('apply', (rule)=>{
239
+ root.walkAtRules("apply", (rule)=>{
98
240
  let [candidates] = extractApplyCandidates(rule.params);
99
241
  for (let util of candidates){
100
242
  applyCandidates.add(util);
@@ -102,127 +244,291 @@ function processApply(root, context) {
102
244
  applies.push(rule);
103
245
  });
104
246
  // Start the @apply process if we have rules with @apply in them
105
- if (applies.length > 0) {
106
- // Fill up some caches!
107
- let applyClassCache = buildApplyCache(applyCandidates, context);
108
- /**
109
- * When we have an apply like this:
110
- *
111
- * .abc {
112
- * @apply hover:font-bold;
113
- * }
114
- *
115
- * What we essentially will do is resolve to this:
116
- *
117
- * .abc {
118
- * @apply .hover\:font-bold:hover {
119
- * font-weight: 500;
120
- * }
121
- * }
122
- *
123
- * Notice that the to-be-applied class is `.hover\:font-bold:hover` and that the utility candidate was `hover:font-bold`.
124
- * What happens in this function is that we prepend a `.` and escape the candidate.
125
- * This will result in `.hover\:font-bold`
126
- * Which means that we can replace `.hover\:font-bold` with `.abc` in `.hover\:font-bold:hover` resulting in `.abc:hover`
127
- */ // TODO: Should we use postcss-selector-parser for this instead?
128
- function replaceSelector(selector, utilitySelectors, candidate) {
129
- let needle = `.${(0, _escapeClassName).default(candidate)}`;
130
- let utilitySelectorsList = utilitySelectors.split(/\s*,\s*/g);
131
- return selector.split(/\s*,\s*/g).map((s)=>{
132
- let replaced = [];
133
- for (let utilitySelector of utilitySelectorsList){
134
- let replacedSelector = utilitySelector.replace(needle, s);
135
- if (replacedSelector === utilitySelector) {
136
- 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);
137
327
  }
138
- replaced.push(replacedSelector);
139
- }
140
- return replaced.join(', ');
141
- }).join(', ');
142
- }
143
- let perParentApplies = new Map();
144
- // Collect all apply candidates and their rules
145
- for (let apply of applies){
146
- let candidates = perParentApplies.get(apply.parent) || [];
147
- perParentApplies.set(apply.parent, candidates);
148
- let [applyCandidates, important] = extractApplyCandidates(apply.params);
149
- if (apply.parent.type === 'atrule') {
150
- if (apply.parent.name === 'screen') {
151
- const screenType = apply.parent.params;
152
- 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}`
153
- ).join(' ')} instead.`);
154
328
  }
155
- 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}.`);
156
- }
157
- for (let applyCandidate of applyCandidates){
158
- if (!applyClassCache.has(applyCandidate)) {
159
- if (applyCandidate === prefix1(context, 'group')) {
160
- // TODO: Link to specific documentation page with error code.
161
- throw apply.error(`@apply should not be used with the '${applyCandidate}' utility`);
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
+ });
162
344
  }
163
- throw apply.error(`The \`${applyCandidate}\` class does not exist. If \`${applyCandidate}\` is a custom class, make sure it is defined within a \`@layer\` directive.`);
345
+ sel.nodes = sel.nodes.concat(group);
164
346
  }
165
- let rules = applyClassCache.get(applyCandidate);
166
- candidates.push([
167
- applyCandidate,
168
- important,
169
- rules
170
- ]);
171
347
  }
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}.`);
172
370
  }
173
- for (const [parent, candidates] of perParentApplies){
174
- let siblings = [];
175
- for (let [applyCandidate, important, rules] of candidates){
176
- for (let [meta, node] of rules){
177
- let root = _postcss.default.root({
178
- nodes: [
179
- node.clone()
180
- ]
181
- });
182
- let canRewriteSelector = node.type !== 'atrule' || node.type === 'atrule' && node.name !== 'keyframes';
183
- if (canRewriteSelector) {
184
- root.walkRules((rule)=>{
185
- rule.selector = replaceSelector(parent.selector, rule.selector, applyCandidate);
186
- rule.walkDecls((d)=>{
187
- d.important = meta.important || important;
188
- });
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
+ candidates.push([
384
+ applyCandidate,
385
+ important,
386
+ rules
387
+ ]);
388
+ }
389
+ }
390
+ for (let [parent, [candidates, atApplySource]] of perParentApplies){
391
+ let siblings = [];
392
+ for (let [applyCandidate, important, rules] of candidates){
393
+ let potentialApplyCandidates = [
394
+ applyCandidate,
395
+ ...extractBaseCandidates([
396
+ applyCandidate
397
+ ], context.tailwindConfig.separator)
398
+ ];
399
+ for (let [meta, node] of rules){
400
+ let parentClasses = extractClasses(parent);
401
+ let nodeClasses = extractClasses(node);
402
+ // 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`
403
+ // So we've split them into groups
404
+ nodeClasses = nodeClasses.groups.filter((classList)=>classList.some((className)=>potentialApplyCandidates.includes(className))).flat();
405
+ // Add base utility classes from the @apply node to the list of
406
+ // classes to check whether it intersects and therefore results in a
407
+ // circular dependency or not.
408
+ //
409
+ // E.g.:
410
+ // .foo {
411
+ // @apply hover:a; // This applies "a" but with a modifier
412
+ // }
413
+ //
414
+ // We only have to do that with base classes of the `node`, not of the `parent`
415
+ // E.g.:
416
+ // .hover\:foo {
417
+ // @apply bar;
418
+ // }
419
+ // .bar {
420
+ // @apply foo;
421
+ // }
422
+ //
423
+ // This should not result in a circular dependency because we are
424
+ // just applying `.foo` and the rule above is `.hover\:foo` which is
425
+ // unrelated. However, if we were to apply `hover:foo` then we _did_
426
+ // have to include this one.
427
+ nodeClasses = nodeClasses.concat(extractBaseCandidates(nodeClasses, context.tailwindConfig.separator));
428
+ let intersects = parentClasses.some((selector)=>nodeClasses.includes(selector));
429
+ if (intersects) {
430
+ throw node.error(`You cannot \`@apply\` the \`${applyCandidate}\` utility here because it creates a circular dependency.`);
431
+ }
432
+ let root = _postcss.default.root({
433
+ nodes: [
434
+ node.clone()
435
+ ]
436
+ });
437
+ // Make sure every node in the entire tree points back at the @apply rule that generated it
438
+ root.walk((node)=>{
439
+ node.source = atApplySource;
440
+ });
441
+ let canRewriteSelector = node.type !== "atrule" || node.type === "atrule" && node.name !== "keyframes";
442
+ if (canRewriteSelector) {
443
+ root.walkRules((rule)=>{
444
+ // Let's imagine you have the following structure:
445
+ //
446
+ // .foo {
447
+ // @apply bar;
448
+ // }
449
+ //
450
+ // @supports (a: b) {
451
+ // .bar {
452
+ // color: blue
453
+ // }
454
+ //
455
+ // .something-unrelated {}
456
+ // }
457
+ //
458
+ // In this case we want to apply `.bar` but it happens to be in
459
+ // an atrule node. We clone that node instead of the nested one
460
+ // because we still want that @supports rule to be there once we
461
+ // applied everything.
462
+ //
463
+ // However it happens to be that the `.something-unrelated` is
464
+ // also in that same shared @supports atrule. This is not good,
465
+ // and this should not be there. The good part is that this is
466
+ // a clone already and it can be safely removed. The question is
467
+ // how do we know we can remove it. Basically what we can do is
468
+ // match it against the applyCandidate that you want to apply. If
469
+ // it doesn't match the we can safely delete it.
470
+ //
471
+ // If we didn't do this, then the `replaceSelector` function
472
+ // would have replaced this with something that didn't exist and
473
+ // therefore it removed the selector altogether. In this specific
474
+ // case it would result in `{}` instead of `.something-unrelated {}`
475
+ if (!extractClasses(rule).some((candidate)=>candidate === applyCandidate)) {
476
+ rule.remove();
477
+ return;
478
+ }
479
+ // Strip the important selector from the parent selector if at the beginning
480
+ let importantSelector = typeof context.tailwindConfig.important === "string" ? context.tailwindConfig.important : null;
481
+ // We only want to move the "important" selector if this is a Tailwind-generated utility
482
+ // We do *not* want to do this for user CSS that happens to be structured the same
483
+ let isGenerated = parent.raws.tailwind !== undefined;
484
+ let parentSelector = isGenerated && importantSelector && parent.selector.indexOf(importantSelector) === 0 ? parent.selector.slice(importantSelector.length) : parent.selector;
485
+ rule.selector = replaceSelector(parentSelector, rule.selector, applyCandidate);
486
+ // And then re-add it if it was removed
487
+ if (importantSelector && parentSelector !== parent.selector) {
488
+ rule.selector = (0, _applyImportantSelector.applyImportantSelector)(rule.selector, importantSelector);
489
+ }
490
+ rule.walkDecls((d)=>{
491
+ d.important = meta.important || important;
189
492
  });
190
- }
191
- // Insert it
192
- siblings.push([
193
- // Ensure that when we are sorting, that we take the layer order into account
194
- {
195
- ...meta,
196
- sort: meta.sort | context.layerOrder[meta.layer]
197
- },
198
- root.nodes[0],
199
- ]);
493
+ // Move pseudo elements to the end of the selector (if necessary)
494
+ let selector = (0, _postcssselectorparser.default)().astSync(rule.selector);
495
+ selector.each((sel)=>(0, _pseudoElements.movePseudos)(sel));
496
+ rule.selector = selector.toString();
497
+ });
200
498
  }
499
+ // It could be that the node we were inserted was removed because the class didn't match
500
+ // If that was the *only* rule in the parent, then we have nothing add so we skip it
501
+ if (!root.nodes[0]) {
502
+ continue;
503
+ }
504
+ // Insert it
505
+ siblings.push([
506
+ meta.sort,
507
+ root.nodes[0]
508
+ ]);
201
509
  }
202
- // Inject the rules, sorted, correctly
203
- let nodes = siblings.sort(([a], [z])=>(0, _bigSign).default(a.sort - z.sort)
204
- ).map((s)=>s[1]
205
- );
206
- // console.log(parent)
207
- // `parent` refers to the node at `.abc` in: .abc { @apply mt-2 }
208
- parent.after(nodes);
209
510
  }
210
- for (let apply1 of applies){
211
- // If there are left-over declarations, just remove the @apply
212
- if (apply1.parent.nodes.length > 1) {
213
- apply1.remove();
214
- } else {
215
- // The node is empty, drop the full node
216
- apply1.parent.remove();
217
- }
511
+ // Inject the rules, sorted, correctly
512
+ let nodes = context.offsets.sort(siblings).map((s)=>s[1]);
513
+ // `parent` refers to the node at `.abc` in: .abc { @apply mt-2 }
514
+ parent.after(nodes);
515
+ }
516
+ for (let apply of applies){
517
+ // If there are left-over declarations, just remove the @apply
518
+ if (apply.parent.nodes.length > 1) {
519
+ apply.remove();
520
+ } else {
521
+ // The node is empty, drop the full node
522
+ apply.parent.remove();
218
523
  }
219
- // Do it again, in case we have other `@apply` rules
220
- processApply(root, context);
221
524
  }
525
+ // Do it again, in case we have other `@apply` rules
526
+ processApply(root, context, localCache);
222
527
  }
223
528
  function expandApplyAtRules(context) {
224
529
  return (root)=>{
225
- partitionApplyParents(root);
226
- processApply(root, context);
530
+ // Build a cache of the user's CSS so we can use it to resolve classes used by @apply
531
+ let localCache = lazyCache(()=>buildLocalApplyCache(root, context));
532
+ processApply(root, context, localCache);
227
533
  };
228
534
  }