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.
- package/LICENSE +1 -2
- package/README.md +13 -10
- package/colors.d.ts +3 -0
- package/defaultConfig.d.ts +3 -0
- package/defaultTheme.d.ts +4 -0
- package/lib/cli/build/deps.js +62 -0
- package/lib/cli/build/index.js +54 -0
- package/lib/cli/build/plugin.js +371 -0
- package/lib/cli/build/utils.js +88 -0
- package/lib/cli/build/watching.js +182 -0
- package/lib/cli/help/index.js +73 -0
- package/lib/cli/index.js +230 -0
- package/lib/cli/init/index.js +63 -0
- package/lib/cli-peer-dependencies.js +28 -7
- package/lib/cli.js +1 -741
- package/lib/corePluginList.js +17 -4
- package/lib/corePlugins.js +2503 -1839
- package/lib/css/preflight.css +32 -13
- package/lib/featureFlags.js +45 -28
- package/lib/index.js +1 -29
- package/lib/lib/cacheInvalidation.js +92 -0
- package/lib/lib/collapseAdjacentRules.js +30 -10
- package/lib/lib/collapseDuplicateDeclarations.js +13 -8
- package/lib/lib/content.js +214 -0
- package/lib/lib/defaultExtractor.js +240 -31
- package/lib/lib/evaluateTailwindFunctions.js +117 -50
- package/lib/lib/expandApplyAtRules.js +466 -230
- package/lib/lib/expandTailwindAtRules.js +156 -135
- package/lib/lib/findAtConfigPath.js +46 -0
- package/lib/lib/generateRules.js +554 -200
- package/lib/lib/getModuleDependencies.js +88 -37
- package/lib/lib/load-config.js +57 -0
- package/lib/lib/normalizeTailwindDirectives.js +39 -33
- package/lib/lib/offsets.js +355 -0
- package/lib/lib/partitionApplyAtRules.js +58 -0
- package/lib/lib/regex.js +74 -0
- package/lib/lib/remap-bitfield.js +89 -0
- package/lib/lib/resolveDefaultsAtRules.js +97 -69
- package/lib/lib/setupContextUtils.js +796 -341
- package/lib/lib/setupTrackingContext.js +66 -71
- package/lib/lib/sharedState.js +45 -14
- package/lib/lib/substituteScreenAtRules.js +14 -10
- package/lib/plugin.js +48 -0
- package/{nesting → lib/postcss-plugins/nesting}/README.md +2 -2
- package/lib/postcss-plugins/nesting/index.js +21 -0
- package/lib/postcss-plugins/nesting/plugin.js +89 -0
- package/lib/processTailwindFeatures.js +37 -27
- package/lib/public/colors.js +272 -246
- package/lib/public/create-plugin.js +9 -5
- package/lib/public/default-config.js +10 -6
- package/lib/public/default-theme.js +10 -6
- package/lib/public/load-config.js +12 -0
- package/lib/public/resolve-config.js +11 -6
- package/lib/util/applyImportantSelector.js +36 -0
- package/lib/util/bigSign.js +6 -1
- package/lib/util/buildMediaQuery.js +13 -6
- package/lib/util/cloneDeep.js +9 -6
- package/lib/util/cloneNodes.js +44 -4
- package/lib/util/color.js +70 -53
- package/lib/util/colorNames.js +752 -0
- package/lib/util/configurePlugins.js +7 -2
- package/lib/util/createPlugin.js +8 -6
- package/lib/util/createUtilityPlugin.js +16 -16
- package/lib/util/dataTypes.js +295 -113
- package/lib/util/defaults.js +12 -7
- package/lib/util/escapeClassName.js +13 -8
- package/lib/util/escapeCommas.js +7 -2
- package/lib/util/flattenColorPalette.js +11 -12
- package/lib/util/formatVariantSelector.js +235 -151
- package/lib/util/getAllConfigs.js +33 -12
- package/lib/util/hashConfig.js +9 -4
- package/lib/util/isKeyframeRule.js +7 -2
- package/lib/util/isPlainObject.js +8 -3
- package/lib/util/{isValidArbitraryValue.js → isSyntacticallyValidPropertyValue.js} +25 -15
- package/lib/util/log.js +25 -15
- package/lib/util/nameClass.js +27 -10
- package/lib/util/negateValue.js +25 -8
- package/lib/util/normalizeConfig.js +127 -82
- package/lib/util/normalizeScreens.js +128 -11
- package/lib/util/parseAnimationValue.js +44 -40
- package/lib/util/parseBoxShadowValue.js +34 -23
- package/lib/util/parseDependency.js +39 -55
- package/lib/util/parseGlob.js +36 -0
- package/lib/util/parseObjectStyles.js +15 -10
- package/lib/util/pluginUtils.js +172 -69
- package/lib/util/prefixSelector.js +30 -12
- package/lib/util/pseudoElements.js +212 -0
- package/lib/util/removeAlphaVariables.js +31 -0
- package/lib/util/resolveConfig.js +101 -87
- package/lib/util/resolveConfigPath.js +30 -12
- package/lib/util/responsive.js +11 -6
- package/lib/util/splitAtTopLevelOnly.js +51 -0
- package/lib/util/tap.js +6 -1
- package/lib/util/toColorValue.js +7 -3
- package/lib/util/toPath.js +22 -4
- package/lib/util/transformThemeValue.js +40 -30
- package/lib/util/validateConfig.js +37 -0
- package/lib/util/validateFormalSyntax.js +26 -0
- package/lib/util/withAlphaVariable.js +27 -15
- package/lib/value-parser/LICENSE +22 -0
- package/lib/value-parser/README.md +3 -0
- package/lib/value-parser/index.d.js +2 -0
- package/lib/value-parser/index.js +22 -0
- package/lib/value-parser/parse.js +259 -0
- package/lib/value-parser/stringify.js +38 -0
- package/lib/value-parser/unit.js +86 -0
- package/lib/value-parser/walk.js +16 -0
- package/loadConfig.d.ts +4 -0
- package/loadConfig.js +2 -0
- package/nesting/index.d.ts +4 -0
- package/nesting/index.js +2 -12
- package/package.json +60 -55
- package/peers/index.js +75503 -55095
- package/plugin.d.ts +11 -0
- package/resolveConfig.d.ts +31 -0
- package/scripts/generate-types.js +104 -0
- package/scripts/release-channel.js +18 -0
- package/scripts/release-notes.js +21 -0
- package/scripts/type-utils.js +27 -0
- package/src/cli/build/deps.js +56 -0
- package/src/cli/build/index.js +49 -0
- package/src/cli/build/plugin.js +437 -0
- package/src/cli/build/utils.js +76 -0
- package/src/cli/build/watching.js +229 -0
- package/src/cli/help/index.js +70 -0
- package/src/cli/index.js +216 -0
- package/src/cli/init/index.js +79 -0
- package/src/cli-peer-dependencies.js +7 -1
- package/src/cli.js +1 -811
- package/src/corePluginList.js +1 -1
- package/src/corePlugins.js +849 -243
- package/src/css/preflight.css +32 -13
- package/src/featureFlags.js +13 -9
- package/src/index.js +1 -28
- package/src/lib/cacheInvalidation.js +52 -0
- package/src/lib/collapseAdjacentRules.js +21 -2
- package/src/lib/content.js +249 -0
- package/src/lib/defaultExtractor.js +215 -33
- package/src/lib/evaluateTailwindFunctions.js +82 -8
- package/src/lib/expandApplyAtRules.js +512 -224
- package/src/lib/expandTailwindAtRules.js +102 -87
- package/src/lib/findAtConfigPath.js +48 -0
- package/src/lib/generateRules.js +541 -146
- package/src/lib/getModuleDependencies.js +70 -30
- package/src/lib/load-config.ts +44 -0
- package/src/lib/normalizeTailwindDirectives.js +1 -0
- package/src/lib/offsets.js +432 -0
- package/src/lib/partitionApplyAtRules.js +52 -0
- package/src/lib/regex.js +74 -0
- package/src/lib/remap-bitfield.js +82 -0
- package/src/lib/resolveDefaultsAtRules.js +55 -30
- package/src/lib/setupContextUtils.js +720 -190
- package/src/lib/setupTrackingContext.js +47 -61
- package/src/lib/sharedState.js +15 -4
- package/src/plugin.js +47 -0
- package/src/postcss-plugins/nesting/README.md +42 -0
- package/src/postcss-plugins/nesting/index.js +13 -0
- package/src/postcss-plugins/nesting/plugin.js +80 -0
- package/src/processTailwindFeatures.js +11 -4
- package/src/public/colors.js +22 -0
- package/src/public/default-config.js +1 -1
- package/src/public/default-theme.js +2 -2
- package/src/public/load-config.js +2 -0
- package/src/util/applyImportantSelector.js +27 -0
- package/src/util/buildMediaQuery.js +5 -3
- package/src/util/cloneNodes.js +40 -2
- package/src/util/color.js +39 -20
- package/src/util/colorNames.js +150 -0
- package/src/util/dataTypes.js +184 -26
- package/src/util/formatVariantSelector.js +272 -144
- package/src/util/getAllConfigs.js +21 -2
- package/src/util/isPlainObject.js +1 -1
- package/src/util/{isValidArbitraryValue.js → isSyntacticallyValidPropertyValue.js} +1 -1
- package/src/util/log.js +8 -8
- package/src/util/nameClass.js +4 -0
- package/src/util/negateValue.js +11 -3
- package/src/util/normalizeConfig.js +45 -6
- package/src/util/normalizeScreens.js +99 -4
- package/src/util/parseBoxShadowValue.js +4 -3
- package/src/util/parseDependency.js +37 -42
- package/src/util/parseGlob.js +24 -0
- package/src/util/pluginUtils.js +139 -24
- package/src/util/prefixSelector.js +31 -10
- package/src/util/pseudoElements.js +171 -0
- package/src/util/removeAlphaVariables.js +24 -0
- package/src/util/resolveConfig.js +70 -32
- package/src/util/resolveConfigPath.js +12 -1
- package/src/util/splitAtTopLevelOnly.js +52 -0
- package/src/util/toPath.js +1 -1
- package/src/util/transformThemeValue.js +13 -3
- package/src/util/validateConfig.js +26 -0
- package/src/util/validateFormalSyntax.js +34 -0
- package/src/util/withAlphaVariable.js +1 -1
- package/src/value-parser/LICENSE +22 -0
- package/src/value-parser/README.md +3 -0
- package/src/value-parser/index.d.ts +177 -0
- package/src/value-parser/index.js +28 -0
- package/src/value-parser/parse.js +303 -0
- package/src/value-parser/stringify.js +41 -0
- package/src/value-parser/unit.js +118 -0
- package/src/value-parser/walk.js +18 -0
- package/stubs/.gitignore +1 -0
- package/stubs/.prettierrc.json +6 -0
- package/stubs/{defaultConfig.stub.js → config.full.js} +290 -178
- package/stubs/postcss.config.js +6 -0
- package/stubs/tailwind.config.cjs +2 -0
- package/stubs/tailwind.config.js +2 -0
- package/stubs/tailwind.config.ts +3 -0
- package/types/config.d.ts +376 -0
- package/types/generated/.gitkeep +0 -0
- package/types/generated/colors.d.ts +298 -0
- package/types/generated/corePluginList.d.ts +1 -0
- package/types/generated/default-theme.d.ts +397 -0
- package/types/index.d.ts +11 -0
- package/CHANGELOG.md +0 -1959
- package/lib/constants.js +0 -37
- package/lib/lib/detectNesting.js +0 -34
- package/nesting/plugin.js +0 -41
- package/scripts/install-integrations.js +0 -27
- package/scripts/rebuildFixtures.js +0 -68
- package/src/constants.js +0 -17
- package/src/lib/detectNesting.js +0 -39
- /package/stubs/{simpleConfig.stub.js → config.simple.js} +0 -0
- /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
|
-
|
|
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
|
-
|
|
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
|
|
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
|
|
133
|
-
|
|
134
|
-
|
|
135
|
-
|
|
136
|
-
|
|
137
|
-
|
|
138
|
-
|
|
139
|
-
|
|
140
|
-
|
|
141
|
-
|
|
142
|
-
|
|
143
|
-
|
|
144
|
-
|
|
145
|
-
|
|
146
|
-
|
|
147
|
-
|
|
148
|
-
|
|
149
|
-
|
|
150
|
-
|
|
151
|
-
|
|
152
|
-
|
|
153
|
-
|
|
154
|
-
|
|
155
|
-
|
|
156
|
-
|
|
157
|
-
|
|
158
|
-
|
|
159
|
-
|
|
160
|
-
|
|
161
|
-
|
|
162
|
-
|
|
163
|
-
|
|
164
|
-
|
|
165
|
-
|
|
166
|
-
|
|
167
|
-
|
|
168
|
-
|
|
169
|
-
|
|
170
|
-
|
|
171
|
-
|
|
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
|
-
|
|
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
|
-
|
|
181
|
-
|
|
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
|
-
|
|
347
|
+
hasReplaced = true
|
|
348
|
+
})
|
|
349
|
+
})
|
|
185
350
|
|
|
186
|
-
|
|
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
|
-
|
|
189
|
-
|
|
190
|
-
|
|
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
|
-
|
|
193
|
-
|
|
194
|
-
|
|
195
|
-
|
|
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
|
|
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
|
-
|
|
205
|
-
|
|
206
|
-
|
|
207
|
-
|
|
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
|
-
|
|
212
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
223
|
-
|
|
224
|
-
|
|
225
|
-
|
|
226
|
-
|
|
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
|
-
|
|
257
|
-
|
|
258
|
-
|
|
259
|
-
|
|
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
|
-
|
|
264
|
-
|
|
265
|
-
|
|
266
|
-
|
|
267
|
-
|
|
268
|
-
|
|
269
|
-
|
|
270
|
-
|
|
271
|
-
|
|
272
|
-
|
|
273
|
-
|
|
274
|
-
|
|
275
|
-
|
|
276
|
-
|
|
277
|
-
|
|
278
|
-
|
|
279
|
-
|
|
280
|
-
|
|
281
|
-
|
|
282
|
-
|
|
283
|
-
|
|
284
|
-
|
|
285
|
-
|
|
286
|
-
|
|
287
|
-
|
|
288
|
-
|
|
289
|
-
|
|
290
|
-
|
|
291
|
-
|
|
292
|
-
|
|
293
|
-
|
|
294
|
-
|
|
295
|
-
|
|
296
|
-
|
|
297
|
-
|
|
298
|
-
|
|
299
|
-
|
|
300
|
-
|
|
301
|
-
|
|
302
|
-
|
|
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
|
-
|
|
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
|
-
|
|
308
|
-
|
|
309
|
-
})
|
|
587
|
+
rule.walkDecls((d) => {
|
|
588
|
+
d.important = meta.important || important
|
|
310
589
|
})
|
|
311
|
-
}
|
|
312
590
|
|
|
313
|
-
|
|
314
|
-
|
|
315
|
-
|
|
316
|
-
|
|
317
|
-
|
|
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
|
-
|
|
326
|
-
|
|
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
|
-
|
|
330
|
-
|
|
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
|
-
//
|
|
340
|
-
|
|
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
|
-
|
|
347
|
-
|
|
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
|
}
|