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